The Block Reorganization: How `net_processing` reacts to chain splits

16. The Block Reorganization: How net_processing reacts to chain splits

In the "Global Pulse" of Bitcoin, truth is not always a single line. Sometimes, two miners find a block at the same time on opposite sides of the planet. This is a Chain Split. For a few minutes, the network is "Confused" about which history is the real one. Eventually, one chain becomes longer, and the node must perform a Reorganization (Reorg).

For the Sovereign Architect, a Reorg is the "Crisis Management" of the node. It is the proof that your machine can change its mind when it sees a "Better Truth."

Analyzing the Pivot: ProcessNewBlock

In the source code, we see how the node's networking layer handles the moment when a peer offers a "Better" history.

/**
 * PEDAGOGICAL ANALYSIS: THE CRISIS MANAGER
 * This logic handles the moment when a peer presents a chain 
 * that is longer and heavier than our own.
 */
bool PeerManagerImpl::ProcessNewBlock(const std::shared_ptr<const CBlock>& pblock, ...)
{
    // 1. Hand the block to the Guardian (validation.cpp).
    bool fNewBlock = m_chainman.ProcessNewBlock(pblock, ...);

    if (fNewBlock) {
        // 2. If this block caused a "Reorg"...
        // 3. We must tell our other friends about the "New Winner"!
        RelayTransaction(pblock->GetHash(), ...);
    }
}

Explaining the Pivot: The Agility of the Truth

• "The Switching of the Tip": If you were on "Block 100A" and a peer shows you "Block 100B" and "Block 101B," your node realizes that Chain B has more Proof of Work. It "Disconnects" 100A and "Connects" 100B and 101B. This is the Flexibility of the Sovereign.

• "The Transaction Rescue": When a block is disconnected, its transactions don't just "Vanish." The node puts them back into the Mempool. This ensures that if those transactions aren't in the "New Chain," they can still be mined later. It is the Persistence of the Economy.

• "The Network-Wide Ripple": The moment your node accepts the new chain, it immediately starts sending inv messages to all its other peers. This is how the "New Winner" travels across the entire planet in seconds. It is the Unity of the Mesh.

• "The Depth Limit": While small reorgs (1-2 blocks) are common, a very deep reorg (10+ blocks) is rare and suspicious. net_processing.cpp will log a Warning if it sees a massive jump in the history. It is the Skepticism of the Core.

The Sovereignty of the Pivot

Reorganizations are the mechanism by which Bitcoin achieves "Global Consensus." As a Sovereign Architect, you know that "Truth is a Process," not a final destination. By allowing your node to pivot to the "Heaviest Chain," you are ensuring that your machine is always aligned with the global mathematical reality, no matter how chaotic the internet becomes. You are the "Master of the Pivot."