Simulador de Fechamento de Canal

Veja como cada tipo de fechamento afeta os saldos do canal

Um canal Lightning pode ser fechado de quatro formas principais: cooperativo (mutual close), unilateral local (você publica a commitment), unilateral remoto (seu par publica) e revogado (estado antigo, com penalty). Cada tipo tem consequências diferentes sobre prazos, custos e quem recebe o quê.

A ferramenta simula cenários didáticos. Ela não publica transações, não consulta a blockchain, não substitui um nó Lightning nem uma carteira real. Use valores fictícios. Não cole seed, mnemonic, chave privada, macaroon, senha nem dados reais de carteira.

Conteúdo

Ferramenta

Ajuste os saldos e o to_self_delay do canal, escolha o cenário e veja o resultado.

Simulador de Fechamento

Simulador de Fechamento de Canal

Simula o resultado de cada tipo de fechamento: cooperativo, unilateral (local/remoto) e revogado (penalty).

Resultado do simulador de fechamento

Fonte primária

Os tipos de fechamento são definidos na BOLT 2 — Peer Protocol for Channel Management (mensagens shutdown e closing_signed para mutual close; commitment_signed para unilateral). As regras on-chain, delays e penalty estão na BOLT 5 — Recommendations for On-chain Transaction Handling. A estrutura das saídas to_local e to_remote com CSV vem da BOLT 3 — Bitcoin Transaction and Script Formats.

Fechamento cooperativo (mutual close)

Ambos os peers trocam mensagens shutdown e closing_signed até concordarem com uma closing transaction que devolve os saldos atuais para cada lado. Não há to_self_delay (CSV) — cada um recebe seu saldo imediatamente. É o fechamento mais barato em taxas e mais rápido, mas exige cooperação dos dois lados.

Fechamento unilateral

Quando um dos peers não responde ou não coopera, o outro pode publicar a commitment transaction mais recente. A saída to_local (de quem publicou) fica bloqueada por um CSV (to_self_delay, tipicamente 144 blocos ~24h) antes de poder ser gasta. A saída to_remote (do outro lado) pode ser gasta imediatamente pelo destinatário.

Uma commitment pode conter também saídas de HTLCs pendentes — cada uma com seu próprio caminho de sucesso (preimage) ou timeout (CLTV + CSV em série). O BOLT 5 detalha essas transações de segunda etapa.

Fechamento revogado (penalty)

Se um peer publica uma commitment transaction que já foi revogada (um estado anterior que ambos concordaram em substituir), a contraparte tem acesso à justice key (per_commitment_secret) e pode reclamar todos os outputs da transação como penalty. É o mecanismo que desincentiva qualquer tentativa de fraude — quem tenta passar estado antigo perde tudo no canal.

Na prática, a BOLT 5 recomenda criar transações de penalty separadas para cada output, para evitar pinning (uma saída de HTLC de baixo valor travar a penalty inteira na mempool).

Limites da ferramenta

A ferramenta simula os cenários principais de forma didática. Ela não considera: HTLCs pendentes (com saídas offered/received e scripts BOLT 3), dust trimming real (que pode eliminar saídas abaixo de um limiar dinâmico), option_anchors (que adiciona saídas de âncora para CPFP), taxas de transação on-chain, fee_spike ou confirmação real na blockchain. O resultado é conceitual e não deve ser usado para decisões reais de fechamento de canal.

Mapa conceitual

Antes de usar esta ferramenta

Depois de usar esta ferramenta

Referências