Skip to content

Configuration

node.toml

The chain node is configured via node.toml. See config/examples/node.toml in the chain repo for a complete example.

Sections

[node]

Field Type Description
home string Data directory for the node
chain_id string Must match the genesis chain ID

[p2p]

Field Type Description
listen_addr string P2P listen address (e.g. 0.0.0.0:26656)
external_addr string Externally reachable address (for NAT traversal)
bootstrap_peers list Seed peers for initial discovery

[rpc]

Field Type Description
listen_addr string HTTP API listen address (e.g. 0.0.0.0:26657)

[consensus]

Field Type Description
namespace string Commonware consensus namespace identifier

[metrics]

Field Type Description
listen_addr string Prometheus metrics endpoint (e.g. 0.0.0.0:9100)

[admission]

Field Type Description
endpoint string URL of the local admission service

[storage]

Field Type Description
data_dir string Root data directory
blob_dir string Directory for uploaded Wasm blobs
vmcache_dir string Directory for compiled Wasm modules
state_dir string Directory for chain state

[identity]

Field Type Description
private_key_file string Path to Ed25519 validator private key
bls_share_file string Path to BLS key share
bls_polynomial_file string Path to BLS polynomial key

admission.toml

The admission service is configured via admission.toml. See config/examples/admission.toml in the chain repo.

Sections

[admission]

Field Type Description
listen_addr string HTTP listen address (e.g. 127.0.0.1:8081)
chain_rpc string Chain node RPC endpoint for submitting PreparedCodeVote transactions
validator_key_seed string Hex-encoded Ed25519 seed for signing votes (empty for unsigned dev mode)

[storage]

Field Type Description
blob_dir string Directory for storing uploaded blobs
vmcache_dir string Directory for compiled module cache

[limits]

Field Type Description
max_blob_size_bytes integer Maximum Wasm blob size (default: 524288 / 512 KiB)
max_queue_depth integer Maximum number of concurrent compilation jobs queued
compile_workers integer Number of parallel compilation worker threads
compile_timeout_secs integer Timeout for compiling a single blob

[vm]

Field Type Description
version string VM version string that compiled modules are tagged with