Getting started
Run the Coins example on your machine. Narae starts one coins-chain-node process per local validator and displays their logs in a terminal dashboard.
Prerequisites
You need Git, Rust with Cargo, a native build toolchain, and an interactive terminal.
On Linux, the repository's Cargo configuration selects the mold linker. Install it through your operating system's package manager before building.
Check out the release
Use the release tag so the source matches these guides:
git clone --branch v2026.7.0-alpha.1 --depth 1 https://github.com/nunchi-labs/sdk.git
cd sdk
Run the commands below from the workspace root.
Build and start the local network
Build the node binary first, then start the default four-validator Coins network:
cargo build -p nunchi-coins-chain --bin coins-chain-node
cargo run -p narae -- up coins-chain
To generate configuration before starting the processes, use this alternative sequence:
cargo run -p narae -- generate coins-chain --validators 4 --out testnet
cargo run -p narae -- run testnet
Generation writes validator-N.toml files and a narae.toml manifest in the output directory. Each validator gets its own peer, RPC, and metrics ports.
| Interface | Default base port | Purpose |
|---|---|---|
| Peer networking | 30000 | Connections between local validators |
| JSON-RPC | 8545 | The example's aggregated RPC interface |
| Prometheus metrics | 9090 | Process metrics |
Validator N uses the corresponding base port plus N. Narae's generation flags include --base-port, --base-rpc-port, and --base-metrics-port.
Query the first validator
With the network running, open a second terminal and query its status:
curl -s -X POST -H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"chain.status","params":[]}' \
http://127.0.0.1:8545
Read its metrics at the separate endpoint:
curl -s http://127.0.0.1:9090/metrics
Use and stop the dashboard
| Key | Action |
|---|---|
Up / Down, or j / k | Select a validator |
| Page Up / Page Down | Scroll its logs |
/ | Filter log lines |
r | Restart the selected validator |
s | Stop the selected validator |
S | Stop all validators |
q | Quit and stop all validators |
If Narae reports a missing node binary, complete the build step above. For startup failures, inspect the selected validator's logs and generated configuration. The Narae README covers running a single node directly.
Next
Follow the Coins example to see how the runtime and CLOB extension connect, or read Architecture before adding your own modules.