Skip to content

fix: bump hypercore to 11.40.4 to stop replicator read stalls - #577

Merged
rodrigopavezi merged 1 commit into
mainfrom
fix/bump-hypercore-11-40
Nov 14, 2026
Merged

rodrigopavezi merged 1 commit into
mainfrom
fix/bump-hypercore-11-40

Conversation

@rodrigopavezi

Copy link
Copy Markdown
Contributor

O que muda e por quê

Sobe o hypercore de 11.39.0 para 11.40.4 (versão exata) em packages/core e apps/cli. Só o package-lock.json da raiz muda. O corestore 7.15.0 pede ^11.39.0 e passa a usar a mesma cópia, sem precisar de bump.

A 11.39.0 tem dois defeitos no replicador, corrigidos em holepunchto/hypercore#896 (issue holepunchto/hypercore#891) e lançados na 11.40.0:

  1. _updatePeer: uma entrada velha em _queued (um get() que estourou o tempo, por exemplo num bloco que o par limpou) sai da fila como se o pedido tivesse sido enviado e gasta a única atualização do par. O get() seguinte não é pedido (cerca de metade das vezes com um par só) e espera o tempo todo.
  2. onrange: um bloco descartado abaixo de _remoteContiguousLength faz o par esquecer que o outro lado ainda tem os blocos seguintes, e as leituras depois que um semeador limpa um bloco apagado podem travar.

É a causa do teste instável apps/cli/test/pages-lifecycle.test.js, contornado no #568.

Reprodução isolada (dois hypercores no mesmo processo, sem rede: o escritor limpa o bloco 1, o leitor estoura o tempo nele e depois lê um bloco guardado, 76 vezes): 38/76 leituras estouraram o tempo na 11.39.0 e 0/76 na 11.40.4.

O que mais entra entre 11.39.0 e 11.40.4

Diff dos pacotes do npm: 9 arquivos, +416/-215, mesmas dependências. Os números abaixo são PRs de holepunchto/hypercore. O que pode pesar:

Reconferido, como pede o item "Manutenção (nona rodada)" de docs/verification.md: o reanexo da réplica do diário de vínculo (reattachMain em packages/core/lib/sync.js) continua valendo. Hypercore#replicate(mux) ainda aceita um Protomux; a única mudança é que attachTo agora ignora um fluxo em destruição (holepunchto/hypercore#911), e reattachMain já pula sockets destruídos.

packages/web-member/test/member.test.js confere a versão do hypercore embaixo de @varanda/core: a expectativa passa de 11.39.0 para 11.40.4. O hypercore do próprio packages/web-member continua no 10.38.2, que tem os mesmos defeitos e não tem correção na 10.x. Fica para outra decisão.

Não mexi nas menções a 11.39.0 em docs/verification.md (tabela de versões do spike do navegador e o item da nona rodada), docs/protocol.md e no comentário de packages/core/lib/frame-guard.js: registram o que foi medido ou observado naquela versão.

Não pus entrada no CHANGELOG.md, porque é só troca de dependência. Se quiserem uma linha em "Não lançado", eu ponho.

Issue

Sem issue. Segue o #568.

Como verificar

  • npm ci --ignore-scripts, npm run lint, npm test e npm run demo.
  • npm run prepare:native -w apps/app: o worklet empacotado (apps/app/assets/worklet/main.bundle.js) traz o código da 11.40.4.

O que rodei (macOS, Node 24.22.1), sobre a main em 70a3af2. Antes do commit a branch passou para a main em 7da6597, que só trouxe mudanças no app, em docs e num comentário de pages-lifecycle.test.js, e o lint passou de novo:

  • npm ci --ignore-scripts, npm run lint, npm run demo (DEMO OK) e npm run prepare:native -w apps/app passaram.
  • npm test completo: 670 de 673 arquivos passaram. As 3 falhas:
    • packages/web-member/test/member.test.js: a expectativa de versão acima. Corrigida; sozinho passa (26/26).
    • packages/core/test/seeder-delete.test.js: o teste "mediaRead stops serving a range deleted while its reads are in flight" estourou 120 s.
    • packages/core/test/seeder-feira.test.js: falhou a asserção "the edit photo is served while the listing lives".
  • As duas do semeador são o mesmo sintoma: mediaRead devolve null logo depois que a mídia baixou. Parece instabilidade que já existe, não regressão:
    • comparei as duas versões rodando o mesmo arquivo sozinho, com um preload no scratchpad que troca o hypercore carregado, sem mexer no repositório;
    • seeder-delete: 1 falha em 19 execuções na 11.40.4 e 1 em 19 na 11.39.0 (o teste 19, "the new item in the re-declared core is served");
    • seeder-feira: 7/7 na 11.40.4 e 8/8 na 11.39.0;
    • a CI da main (run 43496203724, 2026-11-13) e a de perf/shared-moment-preview (run 43507039202), ainda na 11.39.0, falharam esse mesmo teste 19 do seeder-delete.

Checklist

  • npm run lint, npm test (ou npm test -- --affected=origin/main) e npm run demo passam
  • docs/protocol.md ou docs/rpc.md atualizados, se um formato mudou (nenhum mudou)
  • Textos para o usuário estão em pt-BR (nenhum texto novo)
  • Conferido no Android (emulador ou aparelho) e no simulador iOS antes da web/PWA, ou explicado por que não se aplica
  • Nenhum segredo, chave ou dado pessoal no diff

O primeiro item fica desmarcado porque o npm test completo teve as 3 falhas acima. Conferências em aparelho pendentes: o worklet Bare empacota o hypercore, mas não rodei o build de debug do Android nem o simulador iOS.

hypercore 11.39.0 drops the next block request after a get() that timed
out, and forgets blocks a peer still holds after it drops one below its
contiguous length. Both stall reads after a seeder clears a block.
Fixed upstream in holepunchto/hypercore#896, released in 11.40.0.

The web-member test that pins the hypercore version under @varanda/core
moves to 11.40.4; web-member itself stays on hypercore 10.38.2.
@rodrigopavezi
rodrigopavezi requested a review from a team as a code owner November 14, 2026 13:14
@rodrigopavezi
rodrigopavezi merged commit 791d4de into main Nov 14, 2026
20 of 21 checks passed
@rodrigopavezi
rodrigopavezi deleted the fix/bump-hypercore-11-40 branch November 14, 2026 13:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant