Pruning

存儲需求比較

初始區塊下載（IBD）
        ↓
接收區塊 → 完整驗證 → 更新 UTXO → 寫入磁碟
                                      ↓
                              區塊數據超過限制？
                                   ↙    ↘
                                 否       是
                                 ↓        ↓
                               繼續    刪除最舊區塊
                                          ↓
                                    保留區塊頭
                                          ↓
                                    釋放磁碟空間

# 最小修剪（550 MiB 區塊數據）
bitcoind -prune=550

# 建議設定（2 GB 區塊數據）
bitcoind -prune=2000

# 保留約一週的區塊（~10 GB）
bitcoind -prune=10000

# 配置文件設定
echo "prune=2000" >> ~/.bitcoin/bitcoin.conf

# 啟用手動修剪模式
bitcoind -prune=1

# 手動修剪到指定高度
bitcoin-cli pruneblockchain 800000

# 返回實際修剪到的高度
# {
#   "result": 800000
# }

# 查看修剪狀態
bitcoin-cli getblockchaininfo | grep prune

# 查看區塊鏈資訊
bitcoin-cli getblockchaininfo
# {
#   "pruned": true,
#   "pruneheight": 750000,
#   "prune_target_size": 576716800,
#   ...
# }

# 手動觸發修剪
bitcoin-cli pruneblockchain 800000

# 查看磁碟使用
bitcoin-cli gettxoutsetinfo
# {
#   "disk_size": 8234567890,  # UTXO 集合大小
#   ...
# }

~/.bitcoin/blocks/
├── blk00000.dat      # 區塊數據
├── blk00001.dat
├── ...
├── blkNNNNN.dat
├── rev00000.dat      # 撤銷數據（用於重組）
├── rev00001.dat
├── ...
└── index/            # LevelDB 索引
    ├── 000001.log
    ├── CURRENT
    └── ...

interface PruneState {
  pruneTarget: number;      // 目標保留大小（位元組）
  currentSize: number;      // 當前區塊數據大小
  pruneHeight: number;      // 已修剪到的高度
  minBlocksToKeep: number;  // 最少保留區塊數
}

class BlockPruner {
  private readonly MIN_BLOCKS = 288;  // 約 2 天的區塊

  async maybePrune(state: PruneState): Promise {
    // 檢查是否需要修剪
    if (state.currentSize <= state.pruneTarget) {
      return;
    }

    const chainHeight = await this.getChainHeight();
    const minKeepHeight = chainHeight - this.MIN_BLOCKS;

    // 從最舊的區塊開始刪除
    let heightToDelete = state.pruneHeight + 1;

    while (
      state.currentSize > state.pruneTarget &&
      heightToDelete < minKeepHeight
    ) {
      await this.pruneBlock(heightToDelete);
      heightToDelete++;
    }

    console.log(`Pruned to height ${heightToDelete - 1}`);
  }

  private async pruneBlock(height: number): Promise {
    // 1. 刪除區塊數據文件中的數據
    await this.deleteBlockData(height);

    // 2. 刪除對應的撤銷數據
    await this.deleteUndoData(height);

    // 3. 更新索引（保留區塊頭）
    await this.updateIndex(height, { pruned: true });
  }
}

// 文件級修剪
class FileBasedPruner {
  private readonly FILE_SIZE = 128 * 1024 * 1024;  // 128 MB

  async pruneOldFiles(
    currentSize: number,
    targetSize: number
  ): Promise {
    let prunedSize = 0;
    const files = await this.getBlockFiles();

    // 按順序刪除舊文件
    for (const file of files) {
      if (currentSize - prunedSize <= targetSize) {
        break;
      }

      // 檢查文件中的區塊是否都可以刪除
      if (await this.canPruneFile(file)) {
        const fileSize = await this.deleteFile(file);
        prunedSize += fileSize;
        console.log(`Deleted ${file}, freed ${fileSize} bytes`);
      }
    }

    return prunedSize;
  }

  private async canPruneFile(file: string): Promise {
    // 檢查文件中是否有需要保留的區塊
    const blocks = await this.getBlocksInFile(file);
    const minHeight = await this.getMinKeepHeight();

    return blocks.every(b => b.height < minHeight);
  }
}

修剪節點會在 P2P 網路中廣播其能提供的區塊範圍：

服務標誌位：
- NODE_NETWORK (1)        : 可以提供完整區塊歷史
- NODE_NETWORK_LIMITED (1024) : 只能提供最近的區塊

修剪節點使用 NODE_NETWORK_LIMITED，表示：
- 可以提供最近 288 個區塊（約 2 天）
- 不能提供更早的區塊
- 仍然可以中繼新交易和區塊

結論

修剪節點提供與完整節點相同的安全保證，因為它在刪除數據之前已經驗證了所有內容。 唯一的代價是無法為其他節點提供歷史區塊。

# 1. 創建配置文件
mkdir -p ~/.bitcoin
cat > ~/.bitcoin/bitcoin.conf << 'EOF'
# 啟用修剪，保留 2 GB 區塊數據
prune=2000

# 其他推薦設定
server=1
txindex=0  # 修剪模式下必須禁用
EOF

# 2. 啟動節點
bitcoind

# 3. 等待同步完成
bitcoin-cli getblockchaininfo

# 1. 停止節點
bitcoin-cli stop

# 2. 編輯配置文件
echo "prune=2000" >> ~/.bitcoin/bitcoin.conf

# 3. 如果之前啟用了 txindex，必須禁用
sed -i 's/txindex=1/txindex=0/' ~/.bitcoin/bitcoin.conf

# 4. 重新啟動
bitcoind

# 節點會在運行時自動開始修剪舊區塊