Chain overview

Nolus is a Cosmos SDK chain built with CometBFT. The chain binary is nolusd, produced from the nolus-core repository.

Prerequisites

• Go (matches the version pinned in go.mod)
• tomlq and jq for the helper scripts

Build

make install

Compiles and installs nolusd locally.

Initialize and run a local single-node chain

scripts/init-local-network.sh generates a local network setup, deploys the platform contracts, and configures Hermes.

First, generate the mnemonic Hermes will use:

nolusd keys mnemonic

Then initialize and start (run with --help for all options):

./scripts/init-local-network.sh \
  --reserve-tokens <reserve_account_init_tokens> \
  --hermes-mnemonic <hermes_mnemonic> \
  --dex-admin-mnemonic <dex_admin_mnemonic> \
  --store-code-privileged-account-mnemonic <privileged_mnemonic>

Notes:

• Make sure nolus-money-market is checked out as a sibling to nolus-core.
• Kill any running nolusd and hermes processes before re-running the init script.
• nolusd logs land in ~/.nolus.

Run an already-configured node

nolusd start --home "networks/nolus/local-validator-1"

Run a full node with Docker

The nolus-networks repository carries genesis files, seed/peer lists, and a docker-based runner for each public network.

Reproducible binary

The CI builder image is publicly available:

docker run --rm -it -v "$(pwd)":/code \
  public.ecr.aws/nolus/builder:<tag> \
  make build -C /code

Use the tag matching the release you're reproducing.