📋 R003 · Rotação de chaves FROST

Sintoma: Alerta de “Key Age Exceeded” ou perda de um ou mais shares de uma chave distribuída (threshold signature). O nó pode perder a capacidade de assinar transações se cair abaixo do threshold (ex: 3 de 5).

🔍 Diagnóstico

1. Verifique o estado das shares locais:

   paebiru identity check-shares
   

2. Verifique a conectividade com os outros guardiões:

   paebiru node peers | grep guardian
   

🛠️ Ação

Causa 1: Share Perdida ou Corrompida

Se uma share local foi deletada ou o hardware falhou:

• Ação: Inicie o protocolo de recuperação de share (DPSS) com o quorum restante. Você precisará de $t$ guardiões online.

  paebiru identity recover-share --threshold 3
  

Causa 2: Rotação Preventiva (Idade da Chave)

A política de segurança exige rotação a cada 90 dias.

• Ação: Inicie uma nova cerimônia FROST. O sistema gerará novos polinômios e distribuirá novas shares sem mudar a chave pública agregada (se usar resharing) ou gerando uma nova (se for migração total).

  paebiru identity rotate --ceremony-id <UUID>
  

✅ Verificação

1. paebiru identity status mostra “Shares: Healthy (3/5)”.
2. O próximo recibo gerado é assinado com sucesso.

🚨 Escalar

Se o quorum mínimo não for atingido, a chave está permanentemente perdida. Acione o Plano de Recuperação de Desastre (R011).