Reindex

Reindex 的用途

# 完整重建索引
bitcoind -reindex

# 配合其他選項
bitcoind -reindex -dbcache=4096 -txindex

-reindex 過程

• 1
  清除資料庫

  刪除 chainstate（UTXO 集）和 blocks/index

• 2
  掃描區塊文件

  讀取 blocks/blk*.dat 文件找出所有區塊

• 3
  重建區塊索引

  按順序排列區塊，建立 blocks/index

• 4
  處理每個區塊

  驗證交易並更新 UTXO 集

# 僅重建 chainstate
bitcoind -reindex-chainstate

# 適用於 chainstate 損壞但區塊索引完好的情況

兩種模式比較

// 區塊文件結構
interface BlockFile {
  path: string;  // blocks/blk00000.dat
  size: number;
  blocks: BlockLocation[];
}

interface BlockLocation {
  hash: string;
  fileNumber: number;
  dataPos: number;  // 在文件中的位置
  undoPos: number;  // undo 數據位置
}

// 區塊文件格式
// 每個區塊前有 8 字節頭
// [4 bytes: magic] [4 bytes: size] [block data]
const MAINNET_MAGIC = 0xD9B4BEF9;
const TESTNET_MAGIC = 0x0709110B;

async function scanBlockFile(
  filePath: string,
  network: 'mainnet' | 'testnet'
): Promise {
  const magic = network === 'mainnet' ? MAINNET_MAGIC : TESTNET_MAGIC;
  const blocks: BlockLocation[] = [];
  const file = await openFile(filePath);
  let pos = 0;

  while (pos < file.size) {
    // 讀取魔數
    const fileMagic = await file.readUint32LE(pos);
    if (fileMagic !== magic) {
      // 可能是填充或損壞，跳過
      pos++;
      continue;
    }

    // 讀取區塊大小
    const blockSize = await file.readUint32LE(pos + 4);

    // 讀取區塊數據並計算哈希
    const blockData = await file.read(pos + 8, blockSize);
    const blockHash = calculateBlockHash(blockData);

    blocks.push({
      hash: blockHash,
      fileNumber: extractFileNumber(filePath),
      dataPos: pos + 8,
      undoPos: 0,  // 稍後填充
    });

    pos += 8 + blockSize;
  }

  return blocks;
}

interface UTXO {
  txid: string;
  vout: number;
  value: number;
  scriptPubKey: Buffer;
  height: number;
  coinbase: boolean;
}

class ChainstateRebuilder {
  private utxoSet: Map = new Map();
  private currentHeight: number = 0;

  async processBlock(block: Block): Promise {
    // 1. 處理 coinbase 交易（新創建的幣）
    const coinbaseTx = block.transactions[0];
    for (let i = 0; i < coinbaseTx.outputs.length; i++) {
      const output = coinbaseTx.outputs[i];
      if (!isUnspendable(output.scriptPubKey)) {
        this.addUtxo({
          txid: coinbaseTx.txid,
          vout: i,
          value: output.value,
          scriptPubKey: output.scriptPubKey,
          height: this.currentHeight,
          coinbase: true,
        });
      }
    }

    // 2. 處理一般交易
    for (let i = 1; i < block.transactions.length; i++) {
      const tx = block.transactions[i];

      // 移除被花費的 UTXO
      for (const input of tx.inputs) {
        this.removeUtxo(input.txid, input.vout);
      }

      // 添加新的 UTXO
      for (let j = 0; j < tx.outputs.length; j++) {
        const output = tx.outputs[j];
        if (!isUnspendable(output.scriptPubKey)) {
          this.addUtxo({
            txid: tx.txid,
            vout: j,
            value: output.value,
            scriptPubKey: output.scriptPubKey,
            height: this.currentHeight,
            coinbase: false,
          });
        }
      }
    }

    this.currentHeight++;
  }

  private addUtxo(utxo: UTXO): void {
    const key = `${utxo.txid}:${utxo.vout}`;
    this.utxoSet.set(key, utxo);
  }

  private removeUtxo(txid: string, vout: number): void {
    const key = `${txid}:${vout}`;
    this.utxoSet.delete(key);
  }
}

# 使用 4GB dbcache（推薦用於 reindex）
bitcoind -reindex -dbcache=4096

# 使用 8GB dbcache（如果有足夠記憶體）
bitcoind -reindex -dbcache=8192

# 建議：留出至少 2-4GB 給系統和其他進程

Reindex 時間估算

# 組合優化選項
bitcoind -reindex \
  -dbcache=4096 \
  -par=0 \          # 使用所有 CPU 核心進行腳本驗證
  -checkblocks=0 \  # 跳過啟動時的區塊檢查
  -checklevel=0     # 最小檢查級別

# 注意：這些選項會減少驗證，僅在信任本地數據時使用

修復步驟

# 1. 停止 Bitcoin Core
bitcoin-cli stop

# 2. 備份錢包（重要！）
cp -r ~/.bitcoin/wallets ~/bitcoin-wallets-backup

# 3. 嘗試 reindex-chainstate（較快）
bitcoind -reindex-chainstate

# 4. 如果仍然失敗，使用完整 reindex
bitcoind -reindex

# 5. 如果還是失敗，可能需要重新下載
rm -rf ~/.bitcoin/blocks ~/.bitcoin/chainstate
bitcoind

# 首次啟用 txindex 需要 reindex
bitcoind -txindex -reindex

# 或者添加到配置文件
echo "txindex=1" >> ~/.bitcoin/bitcoin.conf
bitcoind -reindex

# 查看 reindex 進度
tail -f ~/.bitcoin/debug.log | grep -E "(Reindexing|progress=)"

# 使用 RPC 查看區塊鏈資訊
bitcoin-cli getblockchaininfo

# 查看驗證進度
bitcoin-cli getblockchaininfo | jq '.verificationprogress'

# 持續監控
watch -n 5 'bitcoin-cli getblockchaininfo | jq "{blocks, headers, verificationprogress}"'

日誌輸出示例

Reindexing block file blk00000.dat...
Reindexing block file blk00001.dat...
...
UpdateTip: new best=0000000000000000000... height=800000 progress=0.999854
Pre-allocating up to position 0x8000000 in blk02345.dat