Node Pruning

Overview

Meaning and scope

Node pruning is the controlled deletion of blockchain data that a node no longer needs for its configured role, while retaining enough information to validate current state and continue operation. A pruned full node may discard old state or block data but still verify new blocks.

Mechanism and operation

Node pruning removes selected historical data from a local Node Database. Clients can prune old states, receipts, transaction indexes, block bodies, or other records according to their architecture. The objective is to keep disk usage manageable without sacrificing the node’s ability to validate the current chain and process new blocks. It can verify blocks and maintain current state while deleting data that can be reconstructed or obtained elsewhere. An archive node, by contrast, preserves historical states for past-block queries and analysis. The exact retained window and reconstruction capability vary by client and configuration.

Practical payment example

A Bitcoin node removes older block data according to its pruning configuration. A reporting service keeps its own archival source for historical investigations rather than expecting a pruned node to answer every old query.

Operational checks

Historical balance queries, traces, explorer indexes, and old receipt lookups may fail after data is removed. It can also complicate incident investigation and restoration if operators assume the node contains a complete history. Applications should query node capabilities explicitly and route historical workloads to suitable archive infrastructure.

Distinctions and limits

A pruned full node is not necessarily a light or nonvalidating node. Pruning should use supported client mechanisms rather than manual file deletion. Operators should monitor disk savings, pruning progress, database compaction, and synchronization impact. Before enabling it, teams should define backup and Node Recovery requirements, because a pruned database may need a snapshot or resynchronization after corruption.

Related reading

Related definitions: Node Database, Node Recovery.