Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

📋 R004 · Recuperação de ledger

Sintoma: Erros de I/O no C.A.P.I.B.A., falha na verificação de checksum de blocos, ou divergência causal (fork local). Logs mostram Corrupted block ou Hash mismatch.


🔍 Diagnóstico

  1. Verifique a integridade do banco local:
    paebiru capiba check --full
    
  2. Verifique se há espaço em disco:
    df -h $PAEBIRU_STORAGE_PATH
    
  3. Identifique o último bloco válido:
    paebiru capiba last-valid
    

🛠️ Ação

Causa 1: Corrupção de Índice (Prolly Tree)

Se os dados estão lá, mas a árvore de busca está quebrada:

  • Ação: Reconstrua os índices a partir dos blocos brutos (WAL).
    paebiru capiba rebuild-index
    

Causa 2: Blocos Faltantes ou Divergentes

Se o nó perdeu mensagens durante uma partição longa:

  • Ação: Force uma ressincronização (Pororoca Causal) com um peer de confiança:
    paebiru capiba sync --peer <TrustedPeerID>
    

Causa 3: Falha de Hardware (Bad sectors)

  • Ação: Mova o storage para um novo disco e restaure a partir do peer mais próximo ou do backup em Oceano.

✅ Verificação

  1. paebiru capiba check retorna “Integrity OK”.
  2. O nó volta a processar novos recibos normalmente.

🚨 Escalar

Em caso de divergência massiva de estado entre muitos nós, acione a governança econômica para um snapshot de consenso.