Você pode conectar o LNbits à extensão Nostr WoT por Nostr Wallet Connect (NWC) ou pela API HTTP da carteira. Este guia pressupõe que você já tenha uma carteira LNbits. Quem controla os fundos depende do operador da instância e da fonte de financiamento; escolher NWC ou acesso à API não muda essa relação.

Escolha a conexão

Use NWC para criar uma conexão exclusiva para o aplicativo, com permissões, limites de gastos e validade próprios. O administrador do LNbits precisa habilitar primeiro a extensão provedora de NWC. Use a aba LNbits para acesso direto pela API quando já tiver a chave de gastos e a URL da instância. São menos etapas, mas você usa a credencial da carteira em vez de uma autorização NWC separada.

Conectar por NWC

Preparar a instância LNbits

O administrador instala o NWC Service Provider e configura o relay em /nwcprovider/admin. O relay transporta as mensagens da conexão. Se você usa uma instância de terceiros e não encontra essa extensão, pergunte ao operador se ela está disponível. Entrar no LNbits não cria automaticamente uma conexão NWC.^[1]

Criar a conexão do aplicativo

Abra o NWC Service Provider no LNbits e selecione a carteira desejada.
Clique em + para adicionar uma conexão. Dê um nome fácil de reconhecer, como Nostr WoT.
Habilite as informações da carteira (get_info), necessárias para validar a conexão. Adicione permissões para consultar saldo, enviar pagamentos, criar e consultar faturas e visualizar o histórico conforme os recursos que pretende usar.
Defina um limite de gastos e uma data de expiração quando disponíveis. Esses limites valem para esta conexão.
Crie a conexão, escolha Connect e copie a URL completa de pareamento, que começa com nostr+walletconnect://.
Na extensão Nostr WoT, abra Carteira → NWC, cole a URL e escolha Conectar.

Mantenha essa URL em segredo: quem a possui pode usar as permissões concedidas. Gerencie ou revogue a conexão no LNbits quando não precisar mais dela.

Conectar pela API do LNbits

Abra a carteira específica no LNbits. Procure API info ou o painel de documentação da API da carteira.
Copie a Admin API key. O LNbits também apresenta uma chave de faturas/leitura, que não permite enviar pagamentos.^[2]
Na extensão Nostr WoT, abra Carteira → LNbits.
Digite a URL HTTPS da instância e a Admin API key dessa carteira, depois escolha Conectar. Use o endereço da instância, não a URL de uma página da carteira que contenha credenciais.

A Admin API key autoriza gastos desta carteira. Ela não é sua senha de acesso ao LNbits nem a senha do administrador da instância. Cole-a somente no campo de chave API; uma URL de pareamento NWC deve ser usada na aba NWC.

Confira o resultado

Após conectar, confira o saldo e o histórico. Para receber sats, crie uma fatura em Depositar. A falta de uma permissão NWC pode impedir um recurso mesmo com a conexão funcionando.

Se a configuração falhar, confira a URL da instância ou a URL completa de pareamento, o relay, a validade e a permissão de informações da carteira. Se o resultado de um pagamento for desconhecido, consulte o histórico antes de pagar novamente. Para trocar de carteira, desconecte nos ajustes e volte à configuração.

Volte à visão geral da configuração de carteiras para comparar opções ou leia o guia do Alby Hub.