Skip to content

Run locally

Start the Lab on your machine. Env tables, full CLI list, and maintainer notes stay on GitHub - this page is only the cold start.

Quick start

bash
git clone https://github.com/Nocturne-Standards/knot.git
cd knot
cargo run -p knot-tool -- init
DEMO_MODE=mock cargo run -p knot-tool -- serve --bind 127.0.0.1:8877
# open the printed http://127.0.0.1:8877/?code=... URL

Lab port: 8877, loopback only. DEMO_MODE must be mock (demo ledger) or testnet (live chain).

A fresh clone builds without live contract pins. For testnet IDs, clone nocturne-deployments next to this repo, or point NOCTURNE_DEPLOYMENTS at a testnet.json file.

Full setup

Passwords, keystore, gas wallet, CLI, and Lab walkthrough: knot-tool README · repo overview.

Self-host the mailbox: knot-collector README.

Contract IDs: Deployments.