Introdução ao LNbits

Um guia para novos usuários/administradores do LNbits sobre como iniciar e gerenciar o nó LN por trás de cada instância do LNbits

Postado originalmente em Substack em 12 de dezembro de 2022. Atualizado aqui em 28 de dezembro de 2024.

Este guia é dedicado àqueles que desejam implementar LNbits em seus negócios, mas não têm experiência em executar um nó Lightning por trás de LNbits.

No final do guia, você encontrará mais documentação para estudar. Este artigo tem como objetivo apenas fornecer algumas "primeiras orientações". Este NÃO é o guia definitivo para a liquidez do seu nó, é apenas o suficiente para colocar você, o novo usuário do LN, no caminho certo. Depois de ler este guia, você terá que fazer muita lição de casa.

Tentarei explicar em termos fáceis para que possa ser assimilado por qualquer tipo de usuário, que não esteja tão familiarizado com detalhes técnicos e muito menos com a execução de um nó LN, mas queira começar a usar o LNbits para vários cenários comerciais e pessoais.

ASPECTO IMPORTANTE

O LNbits é um sistema de contabilidade sobre o seu nó LN.

Começando com a v12.0 também é um software de gerenciamento de nós!

Pense no LNbits como uma "estrutura modular do wordpress" para o seu nó. Uma plataforma fácil de gerenciar, baseada em extensões que você pode combinar para vários casos de uso.

Pense no LNbits como seu próprio software de gerenciamento financeiro bancário. Seu nó oferece canais para pagar e a LNbits estende seu nó para poder executar mais de uma carteira lightning que seu nó vem com. Essas carteiras não precisam necessariamente pertencer a você. Digamos que você, como o executor do nó LN, já tenha liquidez e fundos de canal suficientes e agora queira oferecer alguns serviços bancários de bitcoin para seus amigos, familiares, sua própria loja ou outros comerciantes regulares.

Você oferecerá uma maneira simples para eles abrirem uma "conta bancária" em seu nó sem ter acesso a outras carteiras em seu nó e a toda a liquidez do seu nó, mas apenas a parte deles. Seu nó (o banco) atua apenas como um provedor de transporte para seus pagamentos (entrada/saída).

NOTA: todos os fundos que seus "clientes" depositam em suas contas bancárias LNbits em seu nó, irão direto para os canais LN do seu nó. Isso significa que VOCÊ é realmente o verdadeiro dono desses fundos. Você terá uma grande responsabilidade pelos fundos deles. Não seja mau e fuja com os fundos, não seja mau e cobre altas taxas. Queremos foder os banqueiros fiduciários, não foder uns aos outros (usuários de bitcoin).

A - Gerenciamento de liquidez do Node (banco)

Esta é uma parte muito importante, onde muitos novos usuários estão ficando um pouco perdidos, sem saber o básico sobre como a Lightning Network funciona e o que é necessário para fornecer boa liquidez para pagamentos de entrada e saída.

A curva de aprendizado não é fácil, mas também não é tão difícil. Com um pouco de paciência e leitura, qualquer um pode fazer isso. Mas, por favor, não comece a oferecer serviços com seu banco LNbits para outros antes de preparar seu nó LN adequadamente.

Os casos de uso mais regulares para um nó como este (banco comercial LNBits, usuários regulares, backend específico para um aplicativo da web) precisariam de alguns pré-requisitos para uma navegação tranquila:

liquidez de entrada e saída suficiente nos canais LN do seu nó
taxas baixas a zero entre suas contas LNbits
hardware e configuração confiáveis, sempre online, conexão rápida, clearnet (preferencial) e/ou Tor (para aqueles que querem um acesso tunelado diferente, mas tenha em mente que o Tor é muito lento).

O que é liquidez de entrada? A capacidade que um nó LN tem de receber pagamentos. Não apenas no total, mas também para cada pagamento.

O que é liquidez de saída? Significa a capacidade total que seu nó é capaz de enviar.

Pense nos pagamentos através do seu nó como copos de água que, cheios de água, através de um canudo pequeno ou grande ou canudo. O copo (o recipiente), é o canal LN, pode transportar por vez apenas uma certa quantidade de água e seu copo não pode enviar mais do que você tem em seu copo.

Não entrarei em detalhes agora, explicando como o LN funciona. Escrevi guias extensos na minha página de guias e aqui juntei uma lista de recursos LN a serem estudados, com documentações, tutoriais, ferramentas, links, serviços etc.

Preparar a liquidez de um nó LN exige paciência, tempo, estudo e seleção de bons pares, especialmente se você for executá-lo para fins comerciais. Aqui, darei alguns conselhos sobre como começar, para que seus novos LNbits possam começar a receber e enviar sats, para todas as suas contas e usuários adicionais. Você encontrará sua própria maneira de ajustar seu nó, depois de aprender mais sobre gerenciamento de liquidez.

Vamos considerar que você tem um nó totalmente novo pronto, mas nenhum canal LN ainda. Neste momento, seus LNbits não puderam receber ou enviar nenhum pagamento para fora do seu "banco", para o LN selvagem (Lightning Network).

Como ferramenta principal para verificar e estudar nós pares do LN, recomendo usar a página do explorador Amboss ou Mempool LN, onde você pode aprender sobre muitos detalhes de um nó, incluindo o seu.

Aspectos importantes ao procurar um bom nó par/parceiro de canal:

número de canais, mais é melhor (nó com apenas 5-10 canais não fornecer muitas rotas)
longevidade, quanto maior, melhor (declara o compromisso de fornecer um bom serviço)
capacidade total, quanto maior, melhor (indica a quantidade total de sats que podem ser roteados para/do seu nó)
tamanho dos canais, quanto maior, melhor (presumivelmente um tempo maior até que os canais sequem e também mostra o tamanho máximo de um pagamento que pode ser roteado)
não considere seu peer como um "amigo do Facebook". O LN não é sobre amigos, mas sobre bons peers de roteamento. Portanto, conectar-se a um nó apenas porque o proprietário é seu amigo não ajudará você ou a rede em nada se esse nó não tiver boas rotas. Sim, se seu nó já estiver bem posicionado e você quiser ajudar seu amigo novato a começar com um novo nó, pode e deve ser uma exceção.

Detalhes dos canais do nó na página Amboss

Observe os detalhes na página Amboss, que lhe dão uma compreensão profunda sobre como esse nó está gerenciando seus canais: tamanho do canal, taxa base, taxa de taxa, TimeLock etc.

Esses aspectos são muito importantes quando é hora de escolher seus primeiros pares.

a. Tamanho do canal

Não abra canais pequenos com menos de 3 milhões de sats. Fique, no entanto, abaixo do máximo de 10-21 milhões de sats.

Tudo depende do seu uso por pagamento. Se você estiver confiante em usar canais muito grandes, você pode ter também um canal de 21M sats, por exemplo, mas limitar a quantidade de sats por pagamento único para 1M, usando a opção min/max HTLC, por canal. Eu escrevi aqui um guia extenso sobre o resultado do uso deste método.

b. Capacidade total do nó

Seu nó deve ter capacidade suficiente para todos os clientes do seu "banco".

O relatório mais importante: Liquidez Total do Nó

Nesta captura de tela do Thunderhub (aplicativo de gerenciamento de nós), você pode ver a capacidade total de entrada e saída e também o tamanho máximo dos valores de entrada e saída por transação.

É recomendável manter isso equilibrado, quero dizer, ter quase a mesma capacidade para receber e também para enviar. Qualquer drenagem expansiva em uma direção pode acabar em pagamentos com falha.

Realmente não importa se um canal não está perfeitamente equilibrado 50-50.

Seus canais LN do nó ficarão assim, depois de um tempo, um lado que são seus sats e o outro lado que representam os sats do seu par, sempre fazendo malabarismos para frente e para trás enquanto as carteiras em seu nó o usam e os pagamentos de outros são roteados.

Além disso, o que entrará por um canal pode possivelmente sair por outro, o que com o tempo os equilibrará no geral.

Sim, no começo, é bom começar com canais equilibrados, para que você possa ter e fornecer pagamentos de entrada e saída diretamente. Isso pode ser alcançado com rebalanceamento circular, usando um serviço de swap para mover sats de seus canais LN de volta para seu endereço onchain e usá-los novamente para abrir mais canais. Explicarei no próximo capítulo como isso funciona.

c. Liquidez

Uma boa estratégia seria abrir canais 2-3-4-5 com alguns bons LSP (Liquidity Service Providers), para ter boas rotas desde o início. De preferência aqueles com nós de provedores de carteira onde muitos outros usuários estão conectados e que têm boas conexões.

Veja exemplos mopre neste guia "Gerenciando a Liquidez do Lightning Node".

Então expanda suas conexões com mais nós de empresas Bitcoin (serviços, exchanges, LSP, Rings of Fire etc). A página Amboss é muito boa para encontrar alguns.

Eu poderia mostrar a você minha lista pessoal de bons pares que acumulei ao longo do tempo, mas eles podem não ser 100% adequados para suas próprias necessidades e também com o tempo esses pares estão mudando suas políticas ou até mesmo desligando seus nós. Então, por favor, tome isso apenas como um exemplo. Alguns dos nós lá talvez nem estejam mais online.

Cada operador de nó deve manter sua própria lista de pares, atualizá-los se possível e ajustá-los para suas próprias necessidades.

Você abre um primeiro canal, digamos de 10 milhões de sats com um desses pares. Então você usa um serviço de swap para mover metade dos sats (5 milhões mais ou menos) para fora do canal. Dessa forma, você pode reutilizar esses sats para abrir o próximo canal e também obter liquidez de entrada. Veja o guia dedicado sobre swaps de submarinos que escrevi aqui.

Repita o processo para os próximos 3-4 novos canais e você terá uma boa liquidez para começar. Com o tempo, você pode expandir seu número de pares usando o LightningNetworkPlus ou Satoshi Radio Rings of Fire ou adicionando manualmente outros nós selecionados usando ferramentas específicas para analisar seus pares antes de se conectar a eles: LN Router, LN Node Insight, NodeMatch, LN channels TG Bot e outros mais.

d. Longevidade

Tente manter seus canais LN abertos o máximo possível. Especialmente aqueles que estão mostrando mais tráfego. Você precisará observar o comportamento do seu nó quase todos os dias se quiser fornecer boas rotas para seus clientes. Observe onde e de onde seu nó recebe fundos, para onde vai a maioria dos satélites, tente encontrar as melhores rotas para esses destinos.

Se alguns outros "nós jovens" se conectarem a você, mas eles não fizerem muito tráfego e também estiverem principalmente offline, você deve fechar esses canais inúteis. Eles só geram solicitações de lixo e carregam seu nó com tempos limite inúteis. Uma boa ferramenta para observar isso é o LNTop. Expliquei neste outro guia alguns avisos.

Em geral, um canal LN deve ser fechado apenas em alguns casos, caso contrário, mantenha-o online:

o peer está quase sempre offline
o peer está com um ping muito ruim (tempo de acesso de resposta), a maioria dos nós Tor tem isso
é um canal muito pequeno; qualquer coisa abaixo de 3M é considerado pequeno
o peer não fornece tráfego durante um certo período (2 a 3 meses)
o peer teve seu nó travado e todos os canais precisam ser fechados (eles informaram você)

OK, agora você tem um bom nó com boa liquidez, você está mais do que pronto para oferecer serviços de pagamento a outros. Vamos mergulhar um pouco no gerenciamento do seu servidor LNbits.

B. Gerenciamento do Banco LNbits

Procedimento de instalação

Primeiro passo: Onde instalar? Máquina própria ou solução hospedada?

Como expliquei neste guia dedicado, você pode instalá-lo em seu nó de pacote, mas também pode instalá-lo de forma autônoma em QUALQUER outra máquina de PC comum.

Minha opinião pessoal sobre esse aspecto é executar uma máquina de nó LN dedicada (seja um pacote doméstico, um VPS, um nó Voltage na nuvem) e a instância LNbits em uma máquina separada. Isso torna ambos mais gerenciáveis, mais acessíveis e posso alternar a fonte de financiamento a qualquer momento.

Sim, é bom ter "tudo em um", mas e se o seu negócio depender muito dessa instância LNbits e seu nó LN travar? Tê-lo na mesma máquina que seu nó LN pode acabar em perdas. Mas se você tiver ambos em máquinas separadas, você pode facilmente mudar a fonte de financiamento com outro nó LN e estar pronto para continuar recebendo ou fazendo pagamentos imediatamente.

O manual de instalação é muito simples e em 5-10 minutos você tem um LNbits em execução. Eu sugeriria usar o proxy Caddy, é muito fácil e rápido de instalar e configurar. Com o Caddy você conecta sua instância LNbits a um domínio que pode, por exemplo, hospedar sua loja online. Observe que isso é essencial se você deseja oferecer serviços bancários a outros.

Configurar as fontes de financiamento é basicamente modificar algumas linhas no arquivo de configuração .env e pronto. Inicie o serviço lnbits e... raios felizes.

Faça backup regularmente do seu banco de dados LNbits

Se você respeita os clientes do seu "banco", você deve fazer backups regulares do seu banco de dados LNbits. Não é difícil fazer isso. Apenas uma cópia da pasta lnbits/data.

Em breve, quando a nova extensão de administrador estiver pronta e lançada, haverá mais opções automáticas e webUI para fazer esse backup/restauração.

Este banco de dados contém SOMENTE: IDs de carteira e acesso de usuários, histórico de transações, saldo, configurações pessoais, etc.

Tenha em mente que este banco de dados (um sqfile) é como um arquivo excel. NÃO É uma carteira, canal ou xpub. Então, se você quiser mover o banco LNbits para outra fonte de financiamento (outro nó em caso de desastre), você pode facilmente apontar sua instância LNbits para outro nó LN e pronto, os saldos do cliente estão lá, mas você acabou de mudar para outro "cofre", outro provedor de transporte de liquidez.

Se você quiser mover sua instância LNbits para outro servidor, você também pode simplesmente copiar e colar esse banco de dados e iniciar o LNbits novamente.

O LNbits pode ser executado em cima de várias fontes de financiamento conforme descrito no guia de instalação aqui. Então, mesmo se você o tinha executado anteriormente com um nó LND e deseja mudar para um nó CLN, por exemplo, uma simples mudança no arquivo .env é suficiente e reinicie o serviço LNbits.

Abra seu banco LNbits para acesso clearnet

Ter um LNbits somente atrás do Tor NÃO é confiável. Sim, hoje todos podem iniciar um nó de pacote como Umbrel, Citadel, myNode, Raspiblitz, Embassy etc. que por padrão está sendo executado atrás do Tor. Sim, você pode usar um desses para seu LNbits, que já está integrado, fácil de iniciar com um clique.

Mas a parte divertida vem quando os clientes do seu banco não sabem o que é Tor e para que ele serve principalmente. E também nem todos os serviços e funcionalidades funcionam bem atrás do Tor. Muito menos compatibilidade e conexão do navegador.

Então aqui, neste guia dedicado eu escrevi sobre vários cenários de como você pode construir um servidor de aplicativo LNbits e ser acessível no clearnet (https, IP/domínio). Preste atenção a todos os detalhes e cenários.