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
external_addr string Externally reachable address
bootstrap_peers list Seed peers for initial discovery

[rpc]

Field Type Description
listen_addr string HTTP API listen address, commonly port 26657

[consensus]

Field Type Description
namespace string Commonware consensus namespace identifier

[metrics]

Field Type Description
listen_addr string Prometheus metrics endpoint, commonly port 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

gateway.toml

The public API gateway is configured via gateway.toml. See config/examples/gateway.toml in the chain repo.

Sections

[gateway]

Field Type Description
listen_addr string Public HTTP listen address, commonly port 8080
chain_rpc string Backend URL for chaind
admission_rpc string Backend URL for admissiond
backend_timeout_ms integer Request timeout for proxied backend calls

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, commonly port 8081
chain_rpc string Chain node RPC endpoint for submitting PreparedCodeVote transactions
validator_key_seed string Hex-encoded Ed25519 seed for signing votes

[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
max_queue_depth integer Maximum queued compilation jobs
compile_workers integer Number of parallel compilation worker threads
compile_timeout_secs integer Timeout budget for compiling a single blob

[vm]

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