Computational cryptography › Live on mainnet today › Hashes and symmetric crypto
SYMMETRIC ENCRYPTIONPrimitive

Validator keystores (EIP-2335)

In plain words

The encrypted file that holds a validator's key, unlocked with a password.

The idea: Your password is stretched by a deliberately slow function into an encryption key, which unlocks the validator's signing key stored with AES. The slowness makes each password guess expensive, so an attacker who steals the file can only try a limited number per second. A checksum tells the client whether the password was right.

Why it matters: A weak password is the real risk here, not the cipher.

The details

On the map: scrypt / PBKDF2 + AES-128-CTR

Validator signing keys are stored encrypted on disk in the EIP-2335 format[1]: the password is stretched with scrypt or PBKDF2, the key is encrypted with AES-128-CTR, and a SHA-256 checksum detects a wrong password.

Security mostly depends on the password: a weak password falls to offline guessing whatever the cipher.

Rests on

If any of these breaks, this breaks too.

If it falls

If this breaks, these break with it.

References

  1. Carl Beekhuizen. ERC-2335: BLS12-381 Keystore. Ethereum Request for Comments (Review), 2019. eips.ethereum.org/EIPS/eip-2335