Networks

Dango mainnet, testnets, and devnets.

How to spin up a devnet

Prerequisites

• Linux (we use Ubuntu 24.04)
• Docker
• Rust 1.80+
• Go

Steps

1. Compile dango:

   git clone https://github.com/left-curve/left-curve.git
   cd left-curve
   cargo install --path dango/cli
   dango --version
   

2. Compile cometbft:

   git clone https://github.com/cometbft/cometbft.git
   cd cometbft
   make install
   cometbft version
   

3. Initialize the ~/.dango directory:

   dango init
   

4. Initialize the ~/.cometbft directory:

   cometbft init
   

5. Create genesis state. Provide chain ID and genesis time as positional arguments:

   cd left-curve
   cargo run -p dango-genesis --example build_genesis -- dev-5 2025-02-25T21:00:00Z
   

   Genesis should be written into ~/.cometbft/config/genesis.json

6. Create systemd service for postgresql:

   [Unit]
   Description=PostgreSQL
   After=network.target
   
   [Service]
   Type=simple
   User=larry
   Group=docker
   WorkingDirectory=/home/larry/workspace/left-curve/indexer
   ExecStart=/usr/bin/docker compose up db
   ExecStop=/usr/bin/docker compose down db
   
   [Install]
   WantedBy=multi-user.target
   

   Save this as /etc/systemd/system/postgresql.service.

   Notes:

   • WorkingDirectory should be the directory where the docker-compose.yml is located.

   • The User should be added to the docker group:

     sudo usermod -aG docker larry
     

7. Create systemd service for dango:

   [Unit]
   Description=Dango
   After=network.target
   
   [Service]
   Type=simple
   User=larry
   ExecStart=/home/larry/.cargo/bin/dango start
   
   [Install]
   WantedBy=multi-user.target
   

   Save this as /etc/systemd/system/dango.service.

8. Create systemd service for cometbft:

   [Unit]
   Description=CometBFT
   After=network.target
   
   [Service]
   Type=simple
   User=larry
   ExecStart=/home/larry/.go/bin/cometbft start
   
   [Install]
   WantedBy=multi-user.target
   

   Save this as /etc/systemd/system/cometbft.service.

9. Refresh systemd:

   sudo systemctl daemon-reload
   

10. Start postgresql:

    sudo systemctl start postgresql
    

11. Create database for the indexer:

    cd left-curve/indexer
    createdb -h localhost -U postgres grug_dev
    

12. Start dango:

    sudo systemctl start dango
    

13. Start cometbft:

    sudo systemctl start cometbft
    

    Note: when starting, start in this order: postgresql, dango, cometbft. When terminating, do it in the reverse order.

Killing existing devnet and start a new one

1. Stop dango and cometbft services (no need to stop postgresql):

   sudo systemctl stop cometbft
   sudo systemctl stop dango
   

2. Reset cometbft:

   cometbft unsafe-reset-all
   

3. Reset dango:

   dango db reset
   

4. Reset indexer DB:

   dropdb -h localhost -U postgres grug_dev
   createdb -h localhost -U postgres grug_dev
   

5. Delete indexer saved blocks:

   rm -rfv ~/.dango/indexer
   

6. Restart the services:

   sudo systemctl start dango
   sudo systemctl start cometbft
   

Test accounts

Each devnet comes with 10 genesis users: owner and user{1-9}. They use Secp256k1 public keys derived from seed phrases with derivation path m/44'/60'/0'/0/0.

Do NOT use these keys in production!!!