Você abre uma carteira Lightning para receber um pagamento e encontra um código enorme começando com lnbc. Em outro aplicativo, o endereço tem a aparência de um e-mail. Em um terceiro, aparece um QR code com um LNURL.
Todos fazem parte do universo Lightning, mas cada um tem um papel. Entender essa diferença ajuda a reconhecer o que você recebeu e o que a carteira precisa fazer com aquela informação.
Vamos conhecer os três formatos e depois abrir um exemplo no decodificador gratuito do BR⚡LN.
Invoice: a solicitação de pagamento
Uma invoice é uma solicitação de pagamento. No formato BOLT 11, ela reúne informações como rede, valor quando especificado, descrição ou hash da descrição e prazo de validade. Também contém uma assinatura criptográfica. O prefixo lnbc identifica invoices para a rede principal do Bitcoin. Especificação BOLT 11
Imagine uma cobrança de 1.000 sats por um café. A invoice pode trazer esse valor e uma descrição. Há também invoices sem valor definido, nas quais quem paga informa a quantia.
Outro campo importante é a expiração: a data de criação e o prazo definido determinam até quando aquela solicitação deve ser utilizada. Campos da invoice
LNURL: uma conexão com um serviço
Um LNURL no formato lnurl1… representa uma URL codificada. A carteira interpreta essa informação para iniciar uma interação com um serviço. Por isso, ler um LNURL envolve mais do que abrir os campos de uma invoice. LUD-01
No fluxo chamado LNURL-pay, o serviço informa uma descrição e os valores mínimo e máximo aceitos. Depois da escolha do valor, a carteira solicita uma invoice para aquele pagamento.
Isso permite oferecer um ponto de entrada reutilizável, como um QR code, enquanto as invoices são obtidas durante o processo. LUD-06
Lightning Address: um endereço fácil de compartilhar
Uma Lightning Address usa o formato nome@dominio. Pense em ana@example.com, um endereço fictício usado aqui apenas para ilustrar a aparência.
Para utilizá-lo, o domínio precisa oferecer o serviço correspondente. A carteira consulta esse domínio e continua pelo fluxo LNURL-pay.
A semelhança visual com e-mail facilita lembrar e compartilhar o endereço; ela não transforma qualquer conta de e-mail em um destino Lightning. LUD-16
Como os três se relacionam
Invoice: a solicitação de pagamento, com informações como valor e expiração.
LNURL-pay: o caminho para consultar um serviço e obter uma invoice.
Lightning Address: um identificador fácil de compartilhar que leva ao fluxo LNURL-pay.
Na experiência com Lightning Address, a sequência é:
Endereço → consulta ao serviço → obtenção de invoice → pagamento pela carteira.
Uma carteira compatível cuida dessa interação. Conhecer os formatos ajuda você a entender o que está acontecendo em cada etapa. Fluxo LNURL-pay
Veja uma invoice por dentro
Você pode observar esses campos sem conectar uma carteira. O decodificador Lightning do BR⚡LN já oferece um exemplo:
Abra o decodificador Lightning gratuito.
Na linha Exemplos, clique em invoice. O botão preenche o campo e mostra o resultado.
Observe Valor, Descrição, Rede e Expira em.
Nesse exemplo, você verá 250.000 sats, a descrição “1 cup coffee” e a rede Bitcoin mainnet. A invoice tem data de 2017 e aparece como EXPIRADA.
É um exemplo para estudar os campos. O exercício termina na leitura do resultado.
O que o decodificador consegue mostrar
A ferramenta ajuda a ler informações, mas não faz a verificação criptográfica da assinatura da invoice. O rótulo de validade acompanha o prazo de expiração; não é uma certificação de autenticidade. Ela também não informa se houve pagamento. Funcionamento atual do decodificador
Há uma diferença importante entre os formatos: a invoice é decodificada no navegador. Já a consulta de Lightning Address e LNURL acessa o servidor correspondente e pode recorrer ao Services do BR⚡LN como intermediário.
Para experimentar, basta usar a invoice de exemplo disponível na própria página.
Abra o decodificador Lightning gratuito e explore os campos do exemplo.
Para continuar aprendendo sobre Bitcoin, Lightning e operação de nodes com a comunidade, conheça o BR⚡LN Club.