Archive configuration
Archive settings live in two files in the node home:app.toml and config.toml.
Set the pruning strategy in app.toml:
"nothing" keeps all historic state and is the archive strategy. Do not add pruning-keep-recent or pruning-interval beside it: they apply only when the strategy is custom, so here they are inert and imply a retention limit the node never applies.
Block retention is a separate control, also in app.toml:
0 prunes no blocks. It governs CometBFT block pruning only, not application state pruning.
Retain historical ABCI responses and transaction indexes in config.toml:
app.toml:
config.toml:
[statesync] in config.toml controls whether this node bootstraps from a snapshot; an archive node must never do that. [state-sync] in app.toml controls the snapshots this node serves to other nodes, and is safe to enable here.
RPC and debug policy
The default public EVM namespace allowlist inapp.toml is:
txpool. The full archive example includes debug, txpool, and personal, with EVM tracing configured in app.toml:
debug must also appear in the [json-rpc] api list for debug_traceTransaction to be reachable.
Do not claim uniform txpool or debug tracing support unless the deployed node’s app.toml includes those namespaces.
Archive sizing and backups
Size archive hosts with at least1 TB initial archive disk, expected archive growth of about 10 GB/month, and 2 TB recommended headroom. Run archive backups monthly and keep enough spare capacity for compaction, upgrades, logs, and backup staging.
Application alternatives
Most applications do not need an archive node. Use:- RPC Providers for recent chain data.
- Indexers for token, contract, and application-level history.
- Historical Data for choosing the right data source.