Dingo
⚠️ WARNING: Dingo is under heavy active development and is not yet ready for mainnet block production use. It should only be used on testnets (preview, preprod, musashi, dijkstra) and devnets. Do not use Dingo on mainnet for block production with real funds.
Dingo is Blink Labs' Cardano node implementation in Go. It implements the Ouroboros networking and consensus protocols, validates ledger state, and provides pluggable storage and client interfaces.
Documentation by audience
- Node operators: Dingo guides, including the quick start, configuration and storage modes, bootstrap and data maintenance, and stake pool operation.
- Application developers: APIs and archive services and using Dingo with Cardano CLI.
- The Kupo-compatible API is disabled by default. To enable it, configure
DINGO_PLUGINS_API_KUPO_CONFIG_PORTand use API storage mode. - Dingo contributors: development guide, local DevNet, benchmarks and profiling, architecture, database design, and plugin development.
Network sync and runtime usage
Dingo Core v0.90.5; API v0.91.0. Runtime CPU/RAM are sampled highs after bootstrap; disk is database size. — = not captured.
| Network | Mode | CPU | RAM | Disk | Sync time |
|---|---|---|---|---|---|
| Preview | Core, Mithril | ~1.2 cores | ~2.0 GiB | ~17.8 GiB | ~13 min |
| Preprod | Core, Mithril | ~1.1 cores | ~2.7 GiB | ~22.8 GiB | ~16 min |
| Preview | API, Mithril | ~3.4 cores | ~3.5 GiB | ~55 GiB | ~4h 45m |
| Preprod | API, Mithril | ~1.7 cores | ~3.8 GiB | ~61 GiB | ~3h 20m |
| Mainnet | Core, Mithril | — | — | — | ~6h 2m |
Codebase
| Area | Location |
|---|---|
| Application composition and CLI | node.go, internal/node/, cmd/dingo/ |
| Ledger validation and state | ledger/, ledgerstate/ |
| Ouroboros protocols and peer management | ouroboros/, connmanager/, peergov/, topology/ |
| Persistence and transaction pool | database/, mempool/ |
| Client APIs and Dingo archive service | api/, bark/ |
Build and test
The @blinklabs/dingo NPM package installs the matching release binary for
Linux, FreeBSD or macOS on amd64/arm64. It requires Node.js 22 or
later and tar. Run it with npx @blinklabs/dingo --help, or install it with
npm install --global @blinklabs/dingo and run dingo --help. Arguments, exit
codes and termination signals are passed to the release binary. Installation
fails if the platform has no released binary or the archive cannot be fetched
and extracted. If install scripts were disabled for a global installation,
npm rebuild --global @blinklabs/dingo runs the installer.
npm test checks the packed package and local, global and npx invocation using
an isolated release archive fixture.
Use Go 1.26 or later and make:
make build
./dingo --help
./dingo devnet
# Keep the chain between runs, then reset it when needed:
./dingo devnet --data-dir ./.dingo-devnet
./dingo devnet --data-dir ./.dingo-devnet --reset
The npm package supports the same commands, including
npx @blinklabs/dingo devnet --data-dir ./.dingo-devnet.
dingo devnet writes test funding credentials to cardano/keys/ under its
state directory: faucet.skey, faucet.vkey, and faucet.addr. The faucet
address starts with 900,000 test ADA; use its signing key to make transactions
on network magic 42. With the persistent command above, read the address with
cat ./.dingo-devnet/cardano/keys/faucet.addr. Without --data-dir, the files
are in the temporary directory printed at startup and are removed on exit.
These public test keys must never hold real funds. See the
local DevNet guide for details.
Run the test suite with race detection using make test. See the development
guide for repository checks, integration environments, and
profiling. For basic node setup and usage, follow the operator quick
start.