Skip to content

Node Quickstart

Install the CLI

See Installation for the complete setup flow. The commands below use the same release archives.

curl -L -o wasichain.tar.gz \
  "https://github.com/wasichain/chain/releases/download/v<VERSION>/wasichain-v<VERSION>-x86_64-unknown-linux-gnu.tar.gz"
tar -xzf wasichain.tar.gz
sudo mv wasichain-v<VERSION>-x86_64-unknown-linux-gnu/wasichain /usr/local/bin/wasichain

Use the archive that matches your platform:

  • macOS (Intel): wasichain-v<VERSION>-x86_64-apple-darwin.tar.gz
  • macOS (Apple Silicon): wasichain-v<VERSION>-aarch64-apple-darwin.tar.gz
  • Linux x86_64: wasichain-v<VERSION>-x86_64-unknown-linux-gnu.tar.gz
  • Windows: use WSL and the Linux x86_64 archive

Node software

Wasichain node services are distributed as Docker images:

  • ghcr.io/wasichain/wasichain-chaind:<tag>
  • ghcr.io/wasichain/wasichain-admissiond:<tag>
  • ghcr.io/wasichain/wasichain-gatewayd:<tag>

Clone the chain repo when you need the example configs, Compose files, or local deployment scripts:

git clone https://github.com/wasichain/chain.git
cd chain

Dev mode (single node)

The fastest way to run a local chain:

# Initialize genesis with a single validator
wasichain genesis init --chain-id my-devnet

# Start the node in dev mode
chaind --mode dev --genesis genesis.toml

# In another terminal, start the admission service
admissiond

# In another terminal, start the gateway
gatewayd

Dev mode runs a single validator with no P2P networking. Blocks are produced immediately when transactions are submitted.

Consensus mode

For multi-validator setups:

# Initialize genesis
wasichain genesis init --chain-id my-testnet

# Add additional validators
wasichain genesis add-validator --pubkey <PUBKEY_2>
wasichain genesis add-validator --pubkey <PUBKEY_3>
wasichain genesis add-validator --pubkey <PUBKEY_4>

# Finalize genesis
wasichain genesis finalize

# Start each node with consensus mode
chaind --mode consensus --genesis genesis.toml --config node.toml

Each validator needs its own node.toml with unique P2P listen addresses and identity key paths.

Docker deployment

For Docker-based setups, see Docker Deployment.

# Single-node dev chain
docker compose -f compose/docker-compose.yml up -d --build

# View logs
docker compose -f compose/docker-compose.yml logs -f

# Stop
docker compose -f compose/docker-compose.yml down

Health checks

# Check public gateway status
curl http://<host>:8080/v1/status

# Check chain RPC directly
curl http://<host>:26657/v1/status

# Check admission service directly
curl http://<host>:8081/v1/healthz

# Run diagnostics
wasichain doctor

The doctor command checks connectivity to the chain RPC and admission endpoints directly.

Prometheus metrics

Metrics are exposed on port 9100 by default, configurable through [metrics] listen_addr in node.toml.