Add EIP: Post-Quantum Keystore for Stateful Keys#11820
Open
ch4r10t33r wants to merge 8 commits into
Open
Conversation
Align the scheme.params example with leanSig's recommended production instantiation for a 2^32 key lifetime (SIGAbortingTargetSumLifetime32Dim46Base8): tree_height 32, winternitz_w 8 (BASE), dimension 46, target_sum 200, target_sum encoding, Poseidon1 over KoalaBear, lifetime_leaves 2^32. Add the dimension/target_sum/encoding fields (required to regenerate the public key and verify under the target-sum hypercube encoding) and document each param. Update the capacity snapshot total to match. Replace em-dashes with colons/commas.
github-actions
Bot
added
c-new
Collaborator
File
|
eth-bot
added
e-consensus
eth-bot
changed the title
github-actions
Bot
added
w-ci
…uires - Rename eip-pq-keystore.md -> eip-11820.md (eipw filename format) - Set eip: 11820 (numeric; fixes Jekyll/HTMLProofer table sort) - Shorten title to 44-char limit - Remove 2334 from requires (never referenced in body)
eth-bot
changed the title
github-actions
Bot
added
w-ci
- Move Security Considerations after Reference Implementation (eipw section order) - Reference ERC-2335 with ERC prefix (category ERC) - Point CC0 link to ../LICENSE.md
- Drop Tom Wambsgans from author list - Generalize scheme.params hash field; spec is hash-agnostic - Note Poseidon1 is still being evaluated for consideration
abcoathup
reviewed
Jun 23, 2026
abcoathup
reviewed
Jun 23, 2026
Per editor assignment (@abcoathup): set eip: 8310 and rename eip-11820.md -> eip-8310.md.
|
The commit 99ff210 (as a parent of c04aaa3) contains errors. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Add EIP: Post-Quantum Keystore for Stateful Hash-Based Keys
This PR introduces a new Standards Track (Core) EIP defining a keystore format for stateful hash-based signing keys — XMSS as used by the lean Ethereum consensus layer (
leanxmss).Abstract
The EIP extends EIP-2335 so the encrypted secret may be an XMSS seed, and adds the machinery a consumable key requires:
scheme-parameter block;The encryption upgrades (AES-256, AEAD; optional
argon2idKDF) are minor. The substance is state management: an XMSS key is destroyed by leaf reuse, while the existing keystore model assumes keys are immutable, freely copyable, and restore-safe — assumptions that are unsafe for consumable keys.Motivation
Each XMSS signature consumes a one-time WOTS+ leaf whose index MUST NOT ever be reused; reuse enables forgery. For the synchronized variant, "never reuse a leaf" and the EIP-3076 "never double-sign a slot" invariant are identical, so the EIP makes that coupling normative and specifies the off-protocol cases (e.g. builder-bid signing) that fall outside slashing protection.
Scheme parameters
The
leanxmssscheme.paramsexample uses leanSig's recommended production parameter set for a 2^32 key lifetime (SIGAbortingTargetSumLifetime32Dim46Base8):tree_height32,winternitz_w8 (BASE),dimension46,target_sum200,target_sumencoding, Poseidon1 over KoalaBear,lifetime_leaves2^32.Preamble notes
eip:number is<to be assigned>pending editor assignment.requires:2334, 2335, 3076discussions-to:an Ethereum Magicians thread still needs to be created and linked.Opened as a draft while the preamble (
discussions-to, filename/number) and test cases are finalized.