Skip to main content

Node Configuration

Specter nodes use two primary configuration files: config.toml (CometBFT) and app.toml (application).

config.toml (CometBFT)

Located at ~/.specter/config/config.toml. Key settings:

[p2p]
# P2P listen address
laddr = "tcp://0.0.0.0:26656"

# Persistent peers (comma-separated)
persistent_peers = "node-id@ip:26656"

[consensus]
# Block time target
timeout_commit = "1s"

[rpc]
# CometBFT RPC
laddr = "tcp://0.0.0.0:26657"

app.toml (Application)

Located at ~/.specter/config/app.toml. Key settings:

# Minimum gas price
minimum-gas-prices = "0.000001aghost"

# Pruning strategy
pruning = "default"

# EVM JSON-RPC
[json-rpc]
enable = true
address = "0.0.0.0:8545"
ws-address = "0.0.0.0:8546"

# API
[api]
enable = true
address = "tcp://0.0.0.0:1317"

# gRPC
[grpc]
enable = true
address = "0.0.0.0:9090"

# EVM configuration
[evm]
max-tx-gas-wanted = 10000000

Environment variables

VariableDescription
GHOSTMINT_AUTHORIZED_CALLERSComma-separated list of addresses authorized to call the Ghostmint precompile. Takes precedence over KVStore.

Pruning strategies

StrategyDescription
defaultKeep last 362,880 states (about 10 days at 1 block/s)
nothingKeep all states (archive node)
everythingKeep only the latest state (minimal disk usage)
customSet pruning-keep-recent and pruning-interval