Launch Multi CVM Node
Following this page provides guidance on setting up a local network using Docker, comprising a 4-node chain. This configuration serves as a valuable tool for developers seeking to test their applications and protocol functionalities within a multi-node environment.
Build & Start
To build start a 4 node testnet using docker, run:
make localnet-start
This command creates a 4-node network using the cvmdnode Docker image. The ports for each node are found in this table:
CosVMnode
P2P Port
RPC PortREST
Ethereum JSON-RPC Port
WebSocket Port
CosVMnode0
26656
26657
85458
8546
CosVMnode1
26659
26660
85478
8548
CosVMnode2
26661
26662
85498
8550
CosVMnode3
26663
26664
85518
8552
To update the binary, just rebuild it and restart the nodes
make localnet-start
The command above command will run containers in the background using Docker compose. You will see the network being created:
...
Creating network "cvm_localnet" with driver "bridge"
Creating cvmdnode0 ... done
Creating cvmdnode2 ... done
Creating cvmdnode1 ... done
Creating cvmdnode3 ... done
Stop Localnet
Once you are done, execute:
make localnet-stop
Configuration
The make localnet-start creates files for a 4-node testnet in ./build
by calling the cvmd mainnet
command. This outputs a handful of files in the ./build
directory:
tree -L 3 build/
build/
├── cvmd
├── cvmd
├── gentxs
│ ├── node0.json
│ ├── node1.json
│ ├── node2.json
│ └── node3.json
├── node0
│ ├── cvmd
│ │ ├── key_seed.json
│ │ └── keyring-test-cosmos
│ └── cvmd
│ ├── config
│ ├── data
│ └── cvmd.log
├── node1
│ ├── cvmd
│ │ ├── key_seed.json
│ │ └── keyring-test-cosmos
│ └── cvmd
│ ├── config
│ ├── data
│ └── cvmd.log
├── node2
│ ├── cvmd
│ │ ├── key_seed.json
│ │ └── keyring-test-cosmos
│ └── cvmd
│ ├── config
│ ├── data
│ └── cvmd.log
└── node3
├── cvmd
│ ├── key_seed.json
│ └── keyring-test-cosmos
└── cvmd
├── config
├── data
└── cvmd.log
Each ./build/nodeN
directory is mounted to the /cvmd
directory in each container.
Logging
In order to see the logs of a particular node you can use the following command:
# node 0: daemon logs
docker exec cvmdnode0 tail cvmd.log
# node 0: REST & RPC logs
docker exec cvmdnode0 tail cvmd.log
The logs for the daemon will look like:
I[2020-07-29|17:33:52.452] starting ABCI with Tendermint module=main
E[2020-07-29|17:33:53.394] Can't add peer's address to addrbook module=p2p err="Cannot add non-routable address [email protected]:26656"
E[2020-07-29|17:33:53.394] Can't add peer's address to addrbook module=p2p err="Cannot add non-routable address [email protected]:26656"
E[2020-07-29|17:33:53.394] Can't add peer's address to addrbook module=p2p err="Cannot add non-routable address [email protected]:26656"
I[2020-07-29|17:33:58.828] Executed block module=state height=88 validTxs=0 invalidTxs=0
I[2020-07-29|17:33:58.830] Committed state module=state height=88 txs=0 appHash=90CC5FA53CF8B5EC49653A14DA20888AD81C92FCF646F04D501453FD89FCC791
I[2020-07-29|17:34:04.032] Executed block module=state height=89 validTxs=0 invalidTxs=0
I[2020-07-29|17:34:04.034] Committed state module=state height=89 txs=0 appHash=0B54C4DB1A0DACB1EEDCD662B221C048C826D309FD2A2F31FF26BAE8D2D7D8D7
I[2020-07-29|17:34:09.381] Executed block module=state height=90 validTxs=0 invalidTxs=0
I[2020-07-29|17:34:09.383] Committed state module=state height=90 txs=0 appHash=75FD1EE834F0669D5E717C812F36B21D5F20B3CCBB45E8B8D415CB9C4513DE51
I[2020-07-29|17:34:14.700] Executed block module=state height=91 validTxs=0 invalidTxs=0
Whereas the logs for the REST & RPC server would look like:
I[2020-07-30|09:39:17.488] Starting application REST service (chain-id: "7305661614933169792")... module=rest-server
I[2020-07-30|09:39:17.488] Starting RPC HTTP server on 127.0.0.1:8545 module=rest-server
...
Follow Logs
You can also watch logs as they are produced via Docker with the --follow (-f) flag, for example:
docker logs -f cvmdnode0
Interact with the Localnet
Ethereum JSON-RPC & Websocket Ports
To interact with the testnet via WebSockets or RPC/API, you will send your request to the corresponding ports:
8545
8546
You can send a curl command such as:
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[],"id":1}' -H "Content-Type: application/json" 192.162.10.1:8545
Additional instructions on how to interact with the WebSocket can be found on the events documentation.
Keys & Accounts
To interact with cvmd and start querying state or creating txs, you use the cvmd directory of any given node as your home, for example:
cvmd keys list --home ./build/node0/cvmd
Now that accounts exists, you may create new accounts and send those accounts funds!
Special Binaries
If you have multiple binaries with different names, you can specify which one to run with the BINARY environment variable. The path of the binary is relative to the attached volume. For example:
# Run with custom binary
BINARY=cvm make localnet-start
Last updated