Como Configurar um Nó Lightning Auto-Custodial com OrangePi Zero 2W

Este tutorial explica como configurar um nó Lightning auto-custodial usando Phoenixd, LNBits e Zeus Wallet como aplicativo de ponto de venda (PoS) em um OrangePi Zero 2W. Alternativamente, você pode usar Albyhub e/ou LDK no lugar de LNBits/Phoenixd.

Baseado em: Tiny Lightning Node Tutorial

Índice

• Custos
• Pré-requisitos
• Passos de Configuração
  • 1. Preparar o Hardware
  • 2. Instalar o Software
  • 3. Configurar o PoS (Zeus Wallet)
  • 4. Testar e Monitorar
• Possíveis Problemas
• Recursos Adicionais

Custos

• EUA:
  • Sem liquidez inicial: US$44
  • Com 2Msat de liquidez: US$69
• Brasil:
  • Sem liquidez inicial: US$41
  • Com 2Msat de liquidez: US$66
• Laptop/VPS existente: ~Grátis

Detalhamento:

• Hardware (OrangePi + acessórios): ~US$41 (Brasil) ou US$44 (EUA)
• Taxa de autoLiquidity do Phoenixd: US$25 (pode ser evitada importando seed do Phoenix Wallet)
• VPS (opcional): ~US$2/mês ou grátis (ex.: Oracle)

Pré-requisitos

• Hardware:

  • OrangePi Zero 2W, fonte de alimentação, cartão microSD de 32GB
  • Laptop para SSH ou monitor/teclado/mouse para acesso direto
  • Adaptador USB para microSD
  • Conexão à internet (Wi-Fi/Ethernet)
  • Smartphone Android/iOS para PoS
  • Carteira Lightning para taxa de autoLiquidity

• Software:

  • Sistema operacional: Ubuntu/Debian (para OrangePi)
  • Phoenixd ou Albyhub com LDK
  • LNBits ou Albyhub
  • Zeus Wallet, Alby Go ou Buzzpay (PoS)

• Conhecimentos:

  • Básico de linha de comando (SSH, terminal)
  • Configuração de redes

Passos de Configuração

1. Preparar o Hardware

1. Adquirir o OrangePi Zero 2W:

   • Compre o OrangePi, fonte e microSD de 32GB (~US$41 no Brasil).
   • Ex.: Mercado Livre, AliExpress.

2. Gravar o Cartão MicroSD:

   • Baixe a imagem Ubuntu/Debian para OrangePi Zero 2W.
   • Use Balena Etcher para gravar a imagem no microSD.
   • Insira o cartão no OrangePi.

3. Conectar e Configurar:

   • Conecte o OrangePi à fonte e à internet (Wi-Fi/Ethernet).
   • Acesse via:
     • Monitor/teclado/mouse, ou
     • SSH: ssh orangepi@<IP_DO_ORANGEPI> (descubra o IP com arp -a ou no roteador).
   • Atualize o sistema:

     sudo apt update && sudo apt upgrade -y

2. Instalar o Software

1. Instalar Dependências:

   sudo apt install curl git docker.io -y
   sudo systemctl enable docker
   sudo systemctl start docker
    		
    		
    		1.  Instalar Phoenixd:
    •  Baixe o binário do Phoenixd:
    

curl -L https://github.com/ACINQ/phoenixd/releases/latest/download/phoenixd--linux-arm64.tar.gz | tar -xz sudo mv phoenixd /usr/local/bin/

•  Configure:

mkdir ~/.phoenix phoenixd --datadir ~/.phoenix

• Pague a taxa de autoLiquidity (~US$25) ou importe uma seed do Phoenix Wallet. 2. Instalar LNBits:

git clone https://github.com/lnbits/lnbits.git cd lnbits

•  Instale dependências:

sudo apt install python3-pip -y pip3 install -r requirements.txt

• Configure o LNBits para conectar ao Phoenixd (edite .env com URL/chave do Phoenixd). • Inicie:

python3 main.py

• Acesse: http://<IP_DO_ORANGEPI>:5000 3. Configurar Rede: • Configure encaminhamento de portas no roteador (9735 para Lightning, 5000 para LNBits). • Habilite firewall:

sudo ufw allow 9735 sudo ufw allow 5000 sudo ufw enable

3. Configurar o PoS (Zeus Wallet)
4. Instalar Zeus Wallet: • Baixe na App Store ou Google Play.
5. Conectar ao LNBits: • No LNBits, crie uma carteira e gere um QR code/URL de conexão. • No Zeus, escaneie o QR code ou insira a URL. • Teste criando uma fatura Lightning e pagando-a.
6. Uso em Loja: • Gere faturas no Zeus para clientes. • Pagamentos são roteados pelo Phoenixd e gerenciados pelo LNBits.
7. Testar e Monitorar
8. Testar Pagamentos: • Gere uma fatura no Zeus e pague com outra carteira Lightning. • Verifique o saldo no LNBits.
9. Visualizar Pagamentos: • Exemplo de dados de teste (gráfico não renderizável no GitHub, mas mantido como referência):

{ "type": "bar", "data": { "labels": ["Teste 1", "Teste 2", "Teste 3"], "datasets": [{ "label": "Pagamentos Recebidos (mBTC)", "data": [0.01, 0.02, 0.015], "backgroundColor": ["#36A2EB", "#FFCE56", "#FF6384"], "borderColor": ["#fff", "#fff", "#fff"], "borderWidth": 1 }] }, "options": { "scales": { "y": { "beginAtZero": true, "title": { "display": true, "text": "Valor (mBTC)" } } }, "plugins": { "legend": { "display": true }, "title": { "display": true, "text": "Pagamentos de Teste" } } } }

3. Monitorar: • Verifique logs do Phoenixd: ~/.phoenix/logs. • Monitore recursos: htop ou docker ps. Possíveis Problemas • Phoenixd não inicia: • Verifique logs: ~/.phoenix/logs. • Confirme pagamento da taxa de autoLiquidity. • Abra a porta 9735: sudo ufw allow 9735. • LNBits não conecta ao Zeus: • Valide QR code/URL. • Certifique-se de que o OrangePi está acessível. • Sem internet no OrangePi: • Reconfigure Wi-Fi ou use Ethernet. • Teste: ping google.com. • Reduzir custos: • Importe seed do Phoenix Wallet para evitar taxa. • Use laptop existente. Recursos Adicionais • Tutorial Completo • Phoenixd • LNBits • Zeus Wallet • Comunidades: r/lightningnetwork, grupos no Telegram. Notas • Faça backup da seed do Phoenixd e configurações do LNBits. • Use VPN (ex.: Tailscale) para acesso remoto seguro. • Mantenha o OrangePi ligado 24/7 para uso em loja. • Para detalhes específicos, consulte o tutorial original.

Instruções para Uso

1. Copiar o Conteúdo: Clique no botão de cópia (se disponível) ou selecione e copie o texto acima.
2. Criar Arquivo no GitHub:
   • Acesse seu repositório no GitHub.
   • Crie um novo arquivo (ex.: README.md ou TUTORIAL.md).
   • Cole o conteúdo no editor do GitHub.
   • Salve o arquivo com a extensão .md.
3. Verificar Formatação: O GitHub renderizará automaticamente o Markdown, exibindo cabeçalhos, listas, links e blocos de código formatados.
4. Ajustes Opcionais:
   • Substitua <versao> no comando do Phoenixd pela versão atual (verifique em Phoenixd Releases).
   • Adicione imagens (ex.: capturas de tela) usando a sintaxe ![Descrição](URL_DA_IMAGEM).
5. Gráfico: O JSON do gráfico está incluído como referência, mas não será renderizado no GitHub. Para visualização, use uma ferramenta como Chart.js em um site separado.

Se precisar de ajuda para configurar o repositório, adicionar imagens ou ajustar o conteúdo (ex.: traduzir termos, incluir mais detalhes), é só avisar! Você já tem um repositório onde quer usar este arquivo?