Todos os guias
#bots#nostr#nip-29#zaps

Obelisk Bots: agentes Nostr para grupos, zaps e operação

O obelisk-bots é o runtime de bots para grupos Obelisk que vivem só em relays: scripts Node pequenos, com chaves Nostr próprias, que escutam eventos de grupo NIP-29, anunciam zaps, rodam cotações e automatizam a operação da comunidade sem backend.

4 min de leitura
Obelisk Bots e o zap botUm zap bot estiloso de óculos escuros que ouve recibos de zap no Nostr e publica anúncios assinados em grupos NIP-29 do Obelisk.recibo de zap kind 9735reação kind 7 zapgruposvarredura NIP-29anúnciopost kind 9 ZAP BOT9735kind 7NIP-29kind 9nsec própriaNIP-42PM2

O que é o Obelisk-bots

O Obelisk-bots é o lado dos bots no ecossistema Obelisk. Não é uma extensão de servidor e não ganha uma API privada. Um bot é apenas uma identidade Nostr rodando como um processo Node pequeno: ele guarda a própria nsec, assina relays, reage a eventos e publica novos eventos assinados de volta.

Isso importa porque mantém a mesma regra do resto do Obelisk: o relay é o estado compartilhado. Se um bot posta num grupo, ele posta uma mensagem NIP-29 kind 9. Se precisa entrar num grupo, um admin humano admite a pubkey dele pelo mesmo fluxo de membros usado com pessoas. Se algum dia precisar de poderes de moderação, ele tem que estar listado como admin no relay.

Por que bots se encaixam no modelo só-relay

A maioria dos bots de chat é um plugin privilegiado parafusado num servidor central. O Obelisk-bots inverte isso. O bot não tem linha escondida em banco de dados nem sessão privilegiada. Ele tem um par de chaves.

Isso dá aos operadores um modelo limpo:

  • A identidade é visível: o bot tem um npub, metadados de perfil e mensagens assinadas.
  • As permissões são nativas do relay: pertencer ao grupo e ter poder de admin são eventos NIP-29.
  • A implantação é simples: cada bot é um arquivo .mjs supervisionado pelo PM2.
  • Os clientes continuam intercambiáveis: o bot publica eventos Nostr normais, que qualquer cliente compatível lê.

O repositório já inclui bots de preço do BTC, um bot de sat/ARS, utilitários de gestão e o bot de zaps em andamento.

O bot de zaps

O bot de zaps é o exemplo mais social: ele observa um grupo em busca de atividade de zaps Lightning e transforma isso num momento visível do chat.

Ele escuta dois formatos de evento:

  • Recibos de zap NIP-57: kind 9735, normalmente emitidos por provedores LNURL.
  • Reações de zap locais do grupo: reações kind 7 que carregam valor ou metadados de fatura dentro de um grupo NIP-29.

Quando o evento tem um valor que dá para interpretar, o bot resolve os perfis de quem enviou e de quem recebeu, remove duplicatas em memória e publica um anúncio kind 9 de volta no grupo:

Zap Bot: @alice enviou 420 satoshis para @bob

A imagem deste guia faz o bot parecer o emoji descolado de óculos escuros. O código de verdade é deliberadamente menos teatral: assinar, interpretar, resolver nomes, publicar um evento assinado.

Grupos fixos, descoberta dinâmica

Bots podem ser apontados para grupos exatos com pares relayUrl|groupId. Essa é a configuração mais determinística para produção, porque IDs de grupo sobrevivem a renomeações.

O bot de zaps também sabe descobrir grupos abertos observando metadados de grupo kind 39000 nos relays configurados. Ou seja, um processo pode acompanhar um relay conforme novos grupos públicos aparecem, assinar cada grupo e parar de observar os que somem na próxima atualização.

Grupos fechados ainda precisam de admissão explícita. A descoberta acha a sala, mas não concede permissão para postar.

O modelo de segurança

Todo bot deve ter a própria chave. Não reutilize a chave de um admin humano para automação.

A escada prática é:

  1. Bot de perfil: pode publicar os próprios metadados kind 0.
  2. Bot membro do grupo: admitido com kind 9000, pode postar mensagens.
  3. Bot admin: listado no kind 39001, pode executar ações de moderação.
  4. Bot de operador do relay: além disso, confiado pela lista de permissão do relay.

A maioria dos bots só precisa ser membro. Um anunciador de zaps, um bot de cotação, um bot de boas-vindas ou um bot de jogo em geral conseguem postar sem direitos de admin. Reserve o poder de admin para bots que realmente precisem expulsar membros, apagar mensagens ou atualizar metadados do grupo.

Rodando um

O repositório é propositalmente simples: Node 20+, nostr-tools, ws e PM2.

npm run new-bot -- zap-bot
npm run set-profile -- --nsec-env=ZAP_BOT_NSEC
npm run add-member
npm run pm2:start
pm2 logs obelisk-zap-bot

Para depurar localmente, rode o bot em primeiro plano:

npm run zap-bot

O hábito importante em produção é a separação: um bot, uma nsec, um processo, um conjunto estreito de permissões.

Para onde isso vai

Bots fazem os grupos do Obelisk parecerem vivos sem transformar o app num produto com backend. O caminho de curto prazo é simples: terminar o anunciador de zaps, manter os bots de preço e de sat/ARS chatos e confiáveis, e então acrescentar mais auxiliares orientados a eventos para moderação, boas-vindas, jogos e operação da comunidade.

A restrição útil continua a mesma: se outro cliente Nostr consegue ler o evento, o bot está fazendo certo.

Zaps de Bitcoin no chatUma mensagem de chat recebendo um raio brilhante, com partículas de sats em órbita, representando um zap Lightning pago da sua carteira, via Nostr Wallet Connect ou uma extensão WebLN.Sua carteira+21+42+63+84+105+126+147+168Lightning (NIP-57) mensagem de chat

Zaps de bitcoin no chat

como os pagamentos Lightning aparecem no chat

Como o Obelisk funcionaNuma plataforma de chat comum, sua conta, seus dados e as regras ficam no servidor da empresa, entre você e sua comunidade. No Obelisk você assina cada mensagem com sua própria chave e ela vai direto para o relay da sua comunidade, um relay NIP-29: o Obelisk tem um público, e qualquer um pode rodar o seu. O app do Obelisk só assina e mostra.UMA PLATAFORMA DE CHAT COMUMVocêmensagemO servidor da empresasua conta · seus dados · as regras delaSua comunidadeOBELISKVocê, com sua chavemensagem assinadaO relay da sua comunidadeo do Obeliskou o seu próprioSua comunidadeUse o relay do Obelisk ou rode o seu: sua comunidade não depende de ninguém.

Como o Obelisk funciona

a arquitetura só-relay

Troque tudo, confie em nadaO ecossistema Obelisk: um relay auto-hospedável no topo, ligado a um cliente de chat, um SFU de voz e um motor de bots, cada peça substituível de forma independente.obelisk-relayRelay Nostr auto-hospedável · lista de permissão · painel de adminobelisk-dexCliente de chat webnavegador · NIP-07obelisk-sfuServidor de mixagem de vozWebRTC · chamadas grandesobelisk-botsMotor de botsmoderação · jogos · opsquatro projetos · um protocolo · sem servidor central

Troque tudo, confie em nada: a stack de quatro peças do Obelisk

onde os bots entram na stack do Obelisk