Repository navigation
Open
Labels
dificuldade:grandeUma semana ou mais; vale dividir em sub-issuesUma semana ou mais; vale dividir em sub-issuesportão:1Critério de passagem do Portão 1 (piloto)Critério de passagem do Portão 1 (piloto)tipo:funcionalidadeFuncionalidade novaFuncionalidade novaárea:protocoloProtocolo e núcleo do nó (packages/core)Protocolo e núcleo do nó (packages/core)área:semeadoresSemeadores e sua operaçãoSemeadores e sua operação
Milestone
Description
Contexto
O design diz que, se o CGNAT impedir a conexão direta, o app passa por um semeador; não existe configuração para isso e todo teste foi em loopback. Qual camada falta (furo de NAT do HyperDHT, relay pelo semeador ou só a cópia no semeador) só o ensaio diz; nenhuma opção de relay está referenciada no repositório.
Já feito
Atualizado em 26/10/2026 a partir dos PRs mergeados até #120.
- feat: spike a browser-held member replicating through the seeder #103, feat: run the web app against a node in the browser #105 e feat: run the web app against a node in the browser #110: o membro web sincroniza só pelo semeador, por WebSocket (a Noise vai do navegador ao semeador), sem furo de NAT (
docs/protocol.md:851-862,docs/app.md:23); teste de ponta a ponta entre a sessão web e um membro da CLI pelo semeador empackages/web-member/test/session-e2e.test.js:66-78. - feat: spike a browser-held member replicating through the seeder #103 avaliou o
@hyperswarm/dht-relaye concluiu que ele não está pronto para produção (três defeitos a montante), preferindo o caminho pelo semeador (docs/verification.md:309-330; o terceiro defeito, umnoiseReplyduplicado, está emdocs/verification.md:463).
Atualizado em 05/11/2026 a partir dos PRs mergeados até #346.
- feat: run the browser node session in the native worklet #252: o app nativo com a instalação roda a sessão
web-memberno worklet, ligada ao semeador porwss://<instalação>/seeder, então o sync dele passa pelo semeador como o da web.
Falta
- Reproduzir o bloqueio do direto entre dois celulares nativos em operadoras distintas e medir o furo de NAT; a verificação atual foi toda numa máquina (
docs/verification.md:138-140edocs/verification.md:217). - Nó nativo manual (tipo
core): estratégia no sync (direto, depois semeador) com evento visível e prazo; a web e o app com a instalação (feat: run the browser node session in the native worklet #252) já usam o semeador sozinhos. Hoje não há opção de relay no nó manual (docs/design.md:129). - Documentar a estratégia final no protocol.md §4.
Escopo
- Reproduzir o bloqueio do direto entre dois celulares em operadoras distintas e medir o furo de NAT
- Implementar só a intermediação demonstrada necessária, autenticada e com limites de recursos
- Estratégia no sync (direto, depois semeador) com evento visível e prazo de falha
- Documentar no protocol.md §4
Critérios de aceite
- Dois membros sem conexão direta trocam publicações por semeadores certificados (parcial: a web troca publicações só por semeador desde feat: spike a browser-held member replicating through the seeder #103, mas nunca foi medido com dois membros nativos sem conexão direta)
- O evento de sync mostra o caminho usado e uma falha termina dentro do prazo definido (parcial: falta o caminho usado visível no sync nativo)
Depende de
- Verificar o nó na DHT pública com a CLI e com o app #9 — Verificar o nó na DHT pública com a CLI e com o app
- Subir os semeadores da associação em São Paulo e o bootstrap de produção #35 — Subir os semeadores da associação em São Paulo e o bootstrap de produção
Fontes
docs/design.md:72docs/verification.md:141-143docs/protocol.md:189packages/core/package.json:43- Diagrama "fases" do documento de design original (não exportado para
docs/design.md) docs/protocol.md:851-862packages/web-member/test/session-e2e.test.js:66-78docs/verification.md:309-330- PR Varanda-org/varanda#252
Fase: Fase 1 — Piloto 18+ · Dificuldade: grande
Metadata
Metadata
Assignees
Labels
dificuldade:grandeUma semana ou mais; vale dividir em sub-issuesUma semana ou mais; vale dividir em sub-issuesportão:1Critério de passagem do Portão 1 (piloto)Critério de passagem do Portão 1 (piloto)tipo:funcionalidadeFuncionalidade novaFuncionalidade novaárea:protocoloProtocolo e núcleo do nó (packages/core)Protocolo e núcleo do nó (packages/core)área:semeadoresSemeadores e sua operaçãoSemeadores e sua operação
Type
Projects
- StatusShow more project fieldsTodo
Activity
rodrigopavezi commentedon Oct 26, 2026
Atualizei a descrição: a web já passa sempre pelo semeador (#103, #105); a medição de NAT e a estratégia do app nativo estão em Falta.