Receber bitcoin na Lightning depende de haver capacidade na direção de entrada, além de um caminho de pagamento utilizável. O saldo que um nó controla do seu lado dos canais não é a mesma informação que o espaço disponível para receber. É possível ter bastante saldo local e pouca liquidez de entrada.
Essa distinção ajuda a investigar um recebimento que falha sem concluir que o bitcoin desapareceu. Primeiro identifique qual saldo a carteira está mostrando, quem administra os canais e qual operação está sendo tentada.
Neste artigo
Um canal tem dois lados
Na explicação de liquidez da Lightning Labs, a utilidade dos fundos depende do contexto: enviar, receber ou encaminhar pagamentos impõe necessidades diferentes.
Num modelo simplificado de canal entre dois participantes, parte do saldo está do lado local e parte do lado remoto. Para receber por esse canal, precisa haver valor que possa se deslocar do lado remoto para o local. Ter mais do lado local não cria automaticamente esse espaço.
| Informação | Pergunta que ajuda a responder |
|---|---|
| Capacidade do canal | Qual o tamanho total do canal considerado? |
| Saldo local | Quanto está atribuído ao meu lado? |
| Saldo remoto | Quanto está atribuído ao outro lado? |
| Liquidez de entrada utilizável | Quanto pode chegar, consideradas as condições do canal e da rota? |
Os números exibidos por ferramentas podem incluir reservas ou adotar definições próprias de saldo disponível. Leia o significado do campo antes de comparar valores de duas interfaces.
Um milhão de satoshis não significa um milhão para receber
Considere um canal hipotético com capacidade de 1.000.000 sat, sendo 900.000 sat locais e 100.000 sat remotos. Um bitcoin corresponde a 100 milhões de satoshis.
Mesmo antes de considerar outras restrições, esse canal não tem 250.000 sat do lado remoto para entregar numa entrada de 250.000 sat. O saldo local de 900.000 sat não resolve essa falta de direção.
Agora imagine um pagamento de saída de 200.000 sat pelo canal. Ignorando taxas, reservas e operações pendentes, a distribuição passa a ser:
| Momento da simulação | Lado local | Lado remoto |
|---|---|---|
| Antes da saída | 900.000 sat | 100.000 sat |
| Depois da saída de 200.000 sat | 700.000 sat | 300.000 sat |
A capacidade total permaneceu igual. O que mudou foi a distribuição. A documentação de gestão de canais no Lightning Terminal descreve esse deslocamento entre liquidez de saída e de entrada.
Esta é uma conta fictícia, sem carteira, nó ou transação utilizados pelo Ponto Nulo. Ela explica a direção dos saldos; não recomenda fazer um gasto nem garante que um recebimento posterior será roteado.
O saldo remoto ainda não é uma promessa de recebimento
Um pagamento também precisa encontrar um caminho compatível com o valor e as condições da operação. O par conectado ao seu nó, os demais canais da rota, as taxas e a disponibilidade dos participantes podem limitar o resultado.
A especificação BOLT 2 define condições de canal e de HTLC, os contratos condicionais usados nos pagamentos. Reservas, limites e valores comprometidos em operações pendentes impedem tratar a soma bruta dos saldos como disponibilidade irrestrita.
Também não basta somar a entrada nominal de todos os canais e concluir que um pagamento desse tamanho entrará. Fragmentação, caminhos disponíveis e suporte da implementação importam. A demonstração de um canal não modela uma rede inteira.
Abrir um canal e obter entrada são decisões diferentes
Colocar fundos próprios num canal pode ampliar principalmente o lado de saída. Para receber de modo recorrente, o nó precisa acompanhar a distribuição dos saldos e sua conectividade.
A documentação de gerenciamento de liquidez distingue saldo local, remoto e relações entre pares. Serviços e carteiras podem automatizar partes dessa gestão, mas as condições dependem do produto, dos custos e de quem mantém a custódia.
Não transforme uma mensagem de erro em motivo para contratar imediatamente um serviço ou depositar mais fundos. Primeiro identifique se falta entrada, se o canal está disponível e se o problema corresponde ao diagnóstico mostrado pela ferramenta.
Bitcoin on-chain e saldo Lightning não são o mesmo campo
Um endereço de recebimento on-chain pertence a outro fluxo. Ele não exige que um pagamento atravesse os mesmos canais usados por uma fatura Lightning. Da mesma forma, um saldo on-chain numa carteira não demonstra capacidade imediata de recebimento Lightning.
Algumas interfaces reúnem essas informações numa experiência única. Isso pode simplificar o uso, mas dificulta o diagnóstico se o leitor não souber onde o valor está e qual caminho a ferramenta pretende usar. Confira o tipo de recebimento, a rede e a unidade antes de interpretar o saldo.
O que conferir quando uma entrada falha
Registre o valor solicitado, o tipo de operação, a validade da solicitação de pagamento e a mensagem apresentada. Numa carteira que expõe canais, confira o estado deles e a entrada disponível segundo a definição da própria ferramenta.
Se houver um provedor que administra a liquidez, consulte suas condições e o canal oficial de suporte. Não entregue frase-semente, chave privada ou dados de acesso para demonstrar que uma fatura falhou.
Para um nó próprio, preserve o diagnóstico que diferencia saldo, reservas, pendências e conectividade. Reavalie a disponibilidade depois de mudanças no canal.