Skip to content

docs: align stealth scheme + examples to canonical EIP-5564 (SDK 0.10.0) - #112

Merged
rz1989s merged 1 commit into
mainfrom
fix/stealth-eip5564-canonical-docs
Jun 7, 2026
Merged

docs: align stealth scheme + examples to canonical EIP-5564 (SDK 0.10.0)#112
rz1989s merged 1 commit into
mainfrom
fix/stealth-eip5564-canonical-docs

Conversation

@rz1989s

@rz1989s rz1989s commented Jun 7, 2026

Copy link
Copy Markdown
Member

Aligns the docs with the now-live @sip-protocol/sdk@0.10.0, which flipped the stealth scheme to canonical EIP-5564 (ECDH on the viewing key, one-time address on the spending key, view-only scanning).

Changes

  • Reverts the stealth-scheme descriptions PR docs(security): correct stealth scheme, NUMS, UltraHonk, constraint counts (audit 3/4) #109 had flipped to the old swapped scheme (security/crypto-assumptions, security/audit-checklist) back to canonical; fixes the muddled security/security-properties proof sketch and the concepts/stealth-address + guides/cross-chain-stealth pseudocode. docs(security): correct stealth scheme, NUMS, UltraHonk, constraint counts (audit 3/4) #109's unrelated fixes (Pedersen H try-and-increment, ACIR opcode counts, UltraPlonk→UltraHonk) are preserved.
  • Fixes specs/eip-5564 cryptographic math to canonical.
  • Migrates check*StealthAddress examples to the view-only 0.10.0 signature (addr, viewingPrivateKey, spendingPublicKey) across glossary, specs/eip-5564, guides/ethereum-privacy, cookbook/05-stealth-scanning; reworks the cookbook scanner so it never holds the spending private key. derive* examples unchanged.

Verification

  • Repo-wide sweep: no swapped formulas, no old check* signatures remain (outside auto-generated reference/).
  • npm run build succeeds (1277 pages).

Completes Plan 3 of the sip-protocol/sip-protocol#1099 rollout (SDK fix: sip-protocol/sip-protocol#1100).

@sip-protocol/sdk@0.10.0 flipped the stealth scheme to canonical EIP-5564
(ECDH shared secret on the viewing key; one-time address on the spending key;
view-only scanning with viewing-private + spending-public). Align the docs with
the published SDK:

- Revert the stealth-scheme descriptions that PR #109 had flipped to the old
  swapped scheme (security/crypto-assumptions, security/audit-checklist) back to
  canonical, fix the muddled security/security-properties proof sketch, and the
  concepts/stealth-address + guides/cross-chain-stealth pseudocode. #109's
  unrelated fixes (Pedersen H try-and-increment, ACIR opcode counts, UltraHonk)
  are kept intact.
- Fix the specs/eip-5564 cryptographic math to canonical.
- Migrate check*StealthAddress code examples to the view-only 0.10.0 signature
  (addr, viewingPrivateKey, spendingPublicKey) across glossary, specs/eip-5564,
  guides/ethereum-privacy, and cookbook/05-stealth-scanning — and rework the
  cookbook scanner so it never holds the spending private key. derive* examples
  are unchanged (their signature did not change).

Relates to sip-protocol/sip-protocol#1099, #1100.
@vercel

vercel Bot commented Jun 7, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
sip-docs Ready Ready Preview, Comment Jun 7, 2026 9:28am

@rz1989s
rz1989s merged commit 82da02a into main Jun 7, 2026
3 checks passed
@rz1989s
rz1989s deleted the fix/stealth-eip5564-canonical-docs branch June 7, 2026 09:33
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