# Multi Node
# Pre-requisite Readings
- Install Ignite CLI (opens new window)
- Install Docker (opens new window)
- Install docker-compose (opens new window)
# Automated Localnet with Ignite CLI
Once you have installed ignite
, just run the localnet by using
Detailed instructions can be found in the Ignite CLI documentation (opens new window)
# Automated Localnet with Docker
# Build & Start
To build start a 4 node testnet run:
This command creates a 4-node network using the evmosdnode
Docker image.
The ports for each node are found in this table:
Node ID | P2P Port | Tendermint RPC Port | REST/ Ethereum JSON-RPC Port | WebSocket Port |
---|---|---|---|---|
evmosnode0 | 26656 | 26657 | 8545 | 8546 |
evmosnode1 | 26659 | 26660 | 8547 | 8548 |
evmosnode2 | 26661 | 26662 | 8549 | 8550 |
evmosnode3 | 26663 | 26664 | 8551 | 8552 |
To update the binary, just rebuild it and restart the nodes
The command above command will run containers in the background using Docker compose. You will see the network being created:
# Stop Localnet
Once you are done, execute:
# Configuration
The make localnet-start
creates files for a 4-node testnet in ./build
by
calling the evmosd testnet
command. This outputs a handful of files in the
./build
directory:
Each ./build/nodeN
directory is mounted to the /evmosd
directory in each container.
# Logging
In order to see the logs of a particular node you can use the following command:
The logs for the daemon will look like:
You can disregard the Can't add peer's address to addrbook
warning. As long as the blocks are
being produced and the app hashes are the same for each node, there should not be any issues.
Whereas the logs for the REST & RPC server would look like:
# Follow Logs
You can also watch logs as they are produced via Docker with the --follow
(-f
) flag, for
example:
# 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:
EVM JSON-RPC | Eth Websocket |
---|---|
8545 | 8546 |
You can send a curl command such as:
The IP address will be the public IP of the docker container.
Additional instructions on how to interact with the WebSocket can be found on the events documentation.
# Keys & Accounts
To interact with evmosd
and start querying state or creating txs, you use the
evmosd
directory of any given node as your home
, for example:
Now that accounts exists, you may create new accounts and send those accounts funds!
Note: Each node's seed is located at ./build/nodeN/evmosd/key_seed.json
and can be restored to the CLI using the evmosd keys add --restore
command
# 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: