Skip to content

fix: close the phone verification leftovers - #734

Merged
rodrigopavezi merged 1 commit into
mainfrom
fix/phone-verification-leftovers
Nov 17, 2026
Merged

rodrigopavezi merged 1 commit into
mainfrom
fix/phone-verification-leftovers

Conversation

@rodrigopavezi

Copy link
Copy Markdown
Contributor

O que muda e por quê

Fecha as sobras da verificação de celular listadas na #534.

  • /account/phone/start e /account/age/start emitem códigos de início sem estado (start-nonces.js): o código traz a própria validade e um HMAC do processo. Só os códigos já usados ficam guardados, numa tabela dimensionada pelo balde global (VARANDA_ACCOUNT_RATE e rajada, nunca abaixo de 16384) que recusa quando enche em vez de apagar o mais antigo.
  • As tabelas de limite do celular (membro, número, pendentes, intervalo entre envios) têm tamanho 4 x VARANDA_PHONE_DAILY_LIMIT e nunca apagam uma entrada valendo. Cheias, o envio recusa com limite-telefone antes do Didit e o registro mostra tabela-cheia. O número de um envio pendente sai da memória quando o código vence.
  • phone.json versão 2, com o mapa cleared: um membro desbloqueado que depois exclui a conta não tem o número preso de novo pelas denúncias do bloqueio desfeito (decisão do dono). Uma denúncia decidida depois da exclusão, ou enquanto uma exclusão que falhou espera, continua prendendo o número. Se a varredura falhar durante Excluir conta, a exclusão de um membro bloqueado ou com denúncias de bloqueio espera (indisponivel). Um arquivo da versão 1 ainda abre; depois da primeira gravação na 2, um serviço anterior não abre mais o arquivo.
  • App, Ajustes > "Trocar o celular": compara a data da confirmação antes e depois e diz "Celular atualizado." ou "Esse já é o seu celular." (sem SMS). A linha só aparece numa conta com passkey, destravada e com o passo do celular liberado.
  • Documentos: docs/protocol.md, docs/design.md (limites aceitos pelo dono por escrito: o número em memória por até 10 minutos e o passo desligado sem política nem atestado), README, changelog e verificação.

Issue

Closes #534

Como verificar

Passos e resultados em docs/verification/fix-phone-verification-leftovers.md. Cada correção tem teste que falha sem ela (conferido revertendo).

node apps/cli/test/start-nonces.test.js
node apps/cli/test/account-phone-burn.test.js
node apps/cli/test/account-phone.test.js
node apps/cli/test/moderation-store.test.js
node apps/app/test/phone.test.js

Web conferida no laboratório hospedado (cadastro com celular, "Trocar o celular" com o mesmo número e com outro). Android e iOS abrem sem erro com o JS da branch; o fluxo com conta no app nativo não é alcançável no build de debug e foi para a #224, junto com o backup do phone.json antes do deploy e os formulários de privacidade das lojas.

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
  • Entrada do changelog em docs/changelog/<branch>.md e verificação em docs/verification/<branch>.md, se houver, sem editar o CHANGELOG.md nem acrescentar seção ao docs/verification.md
  • Textos para o usuário estão em pt-BR
  • Conferido no Android (emulador ou aparelho) e no simulador iOS antes da web/PWA, ou explicado por que não se aplica: os dois abrem sem erro; o fluxo com conta fica para a Executar os roteiros de verificação que exigem produção (verification.md, seções de produção até §203) #224 (build de debug não entra com passkey de produção)
  • Nenhum segredo, chave ou dado pessoal no diff

- account service: phone/start and age/start mint stateless nonces
  (start-nonces.js) that carry their own expiry under a per-process
  HMAC; only spent nonces are kept, in a table sized from the global
  token bucket that refuses when full instead of evicting
- phone limits: the member, number, pending and resend tables are sized
  from the daily ceiling and never evict a live entry; when full, a send
  answers limite-telefone before the provider call; a pending entry
  leaves memory when its code expires, on its own timer and on start
- phone.json v2: a cleared map records when the sweep saw a member under
  no block after its bloquear reports, so a member unblocked before
  Excluir conta keeps no burn from the lifted block; held() counts every
  change still waiting for the operator, the deletion's own block
  included, so a report decided after the deletion, or while a failed
  one waits, still burns; a deletion with block reports waits when the
  phone sweep fails
- app: Trocar o celular compares the proof dates before and after and
  says whether the number changed; the row shows only for an unlocked
  passkey account behind an open phone gate
- docs: protocol, design (accepted limits), README, changelog and
  verification fragments

Closes #534
@rodrigopavezi
rodrigopavezi requested a review from a team as a code owner November 17, 2026 10:52
@rodrigopavezi
rodrigopavezi merged commit 3c22820 into main Nov 17, 2026
41 of 43 checks passed
@rodrigopavezi
rodrigopavezi deleted the fix/phone-verification-leftovers branch November 17, 2026 11:23
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.

Fechar as sobras da verificação de celular

1 participant