Pular para o conteúdo
jsonW Paper GitHub

Protocolos de comércio com agentes

L402: a fatura Lightning e o recibo de acesso, e por que nada disso está no jsonW

O L402 cobra um pedido com uma fatura da rede Lightning e entrega um recibo de acesso. O recibo é um token, e não uma senha. Veja os elementos do protocolo, o que um registro precisaria guardar e por que a Wortic ainda não aceita esse meio.

· jsonW 1.3.11

O protocolo

O L402 é um protocolo para cobrar pedidos de API pela rede Lightning. O nome junta o código HTTP 402 com a rede. Antes, o projeto era conhecido como LSAT. O servidor responde 402 com uma fatura Lightning. Depois de pagar a fatura, o cliente recebe um recibo de acesso.

Os elementos

O protocolo tem três elementos: a fatura, o pagamento e o recibo. A fatura tem um valor e um identificador de pagamento. O recibo é um token criptográfico, que o cliente envia nas chamadas seguintes para provar o acesso.

[identificador da fatura, valor em satoshis, prazo de validade, recurso liberado]

O valor da fatura é pequeno, e geralmente vem em satoshis, a menor unidade do bitcoin. Por isso, o protocolo funciona bem para pedidos de centavos.

O que um registro precisaria guardar

Para cada pedido pago, o registro precisaria de três coisas: o identificador da fatura, o valor e o estado do pagamento. Com isso, a empresa consegue reconciliar o que entrou com o que foi entregue. Esse registro é de dinheiro, e não de descrição.

Por que nada disso está no jsonW

O jsonW da Wortic não tem registro de fatura Lightning, porque a casa não aceita esse meio. O jsonW guarda tarefas do A2A e estados de negociação. Pagamento por fatura seria um caso novo, com outra regra de guarda.

Por que a Wortic ainda não aceita

A Wortic não tem hoje um destino de recebimento para L402. Sem a conta que recebe e sem a rotina que converte e contabiliza, o protocolo ficaria sem onde pousar.

O que muda para a empresa que aceita

A empresa precisa de uma rotina para expirar faturas não pagas. Ela também precisa decidir o que o cliente recebe depois do prazo. Essas regras aparecem no suporte, e não só no código.

Como conferir

Antes de qualquer teste, use a rede de testes do Lightning, e não a rede principal. Confira também a versão da documentação do projeto, porque o formato do token pode mudar entre versões.

A documentação está em l402.org, e o código de referência, no GitHub do projeto.

Campos e tamanhos

A fatura é pequena, então o registro pode ser simples: identificador, valor, estado e prazo. O valor em satoshis é um número inteiro. Um número com casas decimais, como um valor em reais, não deve ir para o mesmo campo.

O que o estado deve dizer

O registro pode distinguir três estados: aberta, paga e expirada. Uma fatura expirada não volta a ser paga. Se o cliente pagar depois do prazo, o caso vai para o suporte, e não para uma entrega automática.

Quem confere o registro

A conferência deve somar as faturas pagas e comparar com as entregas feitas. Uma diferença entre as duas listas aponta um pagamento sem entrega ou uma entrega sem pagamento. Essa conferência deve rodar antes do fechamento do mês, e não depois.

Site oficial do L402 (l402.org) →