Todos os guias
#architecture#how-it-works#nostr#nip-29

Como o Obelisk funciona

O Obelisk é um app web sem backend próprio. Ele assina eventos Nostr com sua chave e os envia direto para o seu servidor, que é um relay NIP-29, e para os outros relays de que precisa. Aqui está o que acontece quando você entra, envia uma mensagem ou entra num grupo.

5 min de leitura
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.

O formato do app

O Obelisk tem duas partes em movimento: o app web no seu navegador e os relays com que ele fala.

┌───────────────────────┐ eventos assinados ┌──────────────────────┐
│  App web do Obelisk   │ ────────────────► │  Seu servidor        │
│  (seu navegador;      │ ◄──────────────── │  (um relay NIP-29)   │
│   sua chave assina)   │                   └──────────────────────┘
│                       │    perfis, DMs    ┌──────────────────────┐
│                       │ ◄───────────────► │  Outros relays Nostr │
└───────────────────────┘                   └──────────────────────┘

O servidor de uma comunidade, o que você configura em Configurações do servidor, é um relay NIP-29. Ele guarda os canais, as mensagens e os cargos, e aplica quem pode fazer o quê. Não há nada entre você e ele: não existe banco de dados do Obelisk, nem serviço de contas, nem servidor de sessões. Sua chave fica com você (numa extensão do navegador, num app assinador ou selada no seu dispositivo) e assina cada evento. Um único gerenciador de conexões no app mantém um WebSocket aberto com cada relay e envia os eventos assinados direto para lá; para ler, o mesmo app assina o fluxo do relay.

O site em si é servido por um pequeno servidor Next.js: as páginas, os cabeçalhos de segurança, as prévias de links (assim um link que você só olha nunca chega a um serviço de prévias de terceiros) e as páginas públicas de notas e perfis. Ele não guarda contas, nem chaves, nem mensagens.

O que acontece quando você entra

  1. A tela de login oferece estas formas de entrar:

    • Extensão do navegador (NIP-07): Alby, nos2x e similares assinam via window.nostr. A chave nunca sai da extensão.
    • App assinador (NIP-46): escaneie um QR code ou cole um link de bunker do Amber, do nsec.app ou de outro assinador remoto. A chave fica nesse app, e o Obelisk pede que ele assine.
    • nsec: cole uma chave privada. Antes de ser salva neste dispositivo, ela é selada com uma chave que o navegador não consegue exportar, então nunca fica guardada em texto puro.
    • Gerar: crie um par de chaves novinho ali mesmo, e faça o backup.
  2. O app deriva sua pubkey, busca seu perfil kind 0 em relays de perfis, se conecta ao seu servidor, e pronto. Não há conta, nem senha, nem token nosso: a chave é a sua identidade, e o registro de sessão no seu dispositivo é cifrado. Se o navegador não conseguir guardar esse registro com segurança, o login dura só enquanto a aba estiver aberta.

O que acontece quando você envia uma mensagem

  1. Você digita uma mensagem num canal do seu servidor.
  2. O app monta um evento kind 9 (mensagem de grupo NIP-29), etiquetado com o ID do grupo e, numa resposta, com o evento respondido.
  3. O evento é assinado com sua chave: pela extensão, pelo app assinador ou, para uma chave colada ou gerada, pelo navegador.
  4. O gerenciador de conexões o publica nesse relay pelo WebSocket.
  5. O relay confere se você pode postar ali, guarda a mensagem, e todo mundo que assina aquele canal vê a mensagem chegar.

Não existe uma etapa de "enviar para o servidor do Obelisk". Seu servidor é o relay.

O que acontece quando você entra num grupo ou cria um

Grupos são grupos NIP-29. Quem os guarda é o relay, não nós.

  • Criar: o app envia um evento 9007 (criação de grupo). O relay registra você como primeiro admin do grupo na lista de admins 39001.
  • Entrar / sair: você envia um pedido de entrada 9021 ou de saída 9022. O relay deixa você entrar (ou guarda o pedido para um admin) e atualiza a lista de membros 39002.
  • Moderação: admins adicionam e removem pessoas com 9000 (adicionar usuário) e 9001 (remover usuário); o relay os aplica.
  • Canais, metadados, admins, membros: todos eventos NIP-29 padrão que o próprio relay publica: 39000 (metadados), 39001 (admins), 39002 (membros).

Os grupos pertencem ao relay que você está vendo, então trocar de relay é trocar de servidor. O app não se importa com qual relay é, desde que ele fale NIP-29.

Criar um canal: você vira admin, e o canal vive no relay, não num servidor do Obelisk.25 s, sem som

E os perfis e os DMs?

Perfis e mensagens diretas não ficam no seu servidor. O app busca sozinho outros relays Nostr para eles:

  • Perfis (kind 0) e feeds sociais vêm de relays de perfis e de feed que você pode trocar nas configurações, nunca do seu servidor.
  • DMs ficam desligados até você ativá-los nas configurações. O Obelisk os envia como NIP-17: com "gift wrap" e cifrados com NIP-44, entregues nos relays de caixa de entrada do destinatário, então um relay não vê nem quem envia nem o conteúdo. Ele ainda lê as mensagens NIP-04 mais antigas (kind 4), para que as conversas que você já tinha apareçam.

Os dois são cifrados ponta a ponta: só quem envia e quem recebe têm as chaves para decifrar.

Seu nome, foto e capa são um evento de perfil do Nostr que você assina; qualquer app de Nostr consegue ler.30 s, sem som

E a voz?

Canais de voz usam WebRTC, negociado com eventos Nostr. Num canal de voz comum, até quatro pessoas se conectam direto entre si (uma malha). Para salas maiores, um admin do canal pode transformá-lo num canal SFU, que passa por um SFU mediasoup que o admin escolhe ou hospeda. Áudio e vídeo nunca passam por um servidor do Obelisk.

E os zaps Lightning?

Zaps são NIP-57:

  • O app assina um pedido de zap (kind 9734) e o envia ao servidor LNURL do destinatário, que responde com uma fatura Lightning.
  • Sua carteira paga: uma carteira do navegador via WebLN, ou uma carteira que você conecta com Nostr Wallet Connect (NIP-47).
  • O servidor LNURL do destinatário publica o recibo do zap (kind 9735) nos relays citados no pedido, para todo mundo ver que os sats se moveram.

Nenhuma plataforma cobra taxa. Sua carteira, a carteira de quem recebe, sem intermediário.

O que nós não fazemos

  • Não hospedamos suas mensagens: quem as guarda é o relay do seu servidor.
  • Não temos banco de dados de usuários nem contas.
  • Não emitimos tokens de login nem cookies de sessão. O único cookie lembra o seu idioma.
  • Nunca vemos sua chave, então o app não pode te trancar do lado de fora: sua identidade funciona em qualquer relay que fale NIP-29.