📋 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 blockouHash mismatch.
🔍 Diagnóstico
- Verifique a integridade do banco local:
paebiru capiba check --full - Verifique se há espaço em disco:
df -h $PAEBIRU_STORAGE_PATH - 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
paebiru capiba checkretorna “Integrity OK”.- 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.