Crypto.Ethereum.Keyfile

Ethereum Secret Storage implementation. Spec https://github.com/ethereum/wiki/wiki/Web3-Secret-Storage-Definition.

Encrypted Ethereum private key

data EncryptedKey

Secret Storage representation on memory.

Constructors

EncryptedKey

Fields

• encryptedKeyId :: !UUID

  Random key ID

• encryptedKeyVersion :: !Int

  Version (suppoted version 3 only)

• encryptedKeyCipher :: !Cipher

  Cipher (supported AES-128-CTR only)

• encryptedKeyKdf :: !Kdf

  Key derivation function

• encryptedKeyMac :: !HexString

  MAC

Instances

Eq EncryptedKey

Defined in Crypto.Ethereum.Keyfile

Methods

(==) :: EncryptedKey -> EncryptedKey -> Bool

(/=) :: EncryptedKey -> EncryptedKey -> Bool

Show EncryptedKey

Defined in Crypto.Ethereum.Keyfile

Methods

showsPrec :: Int -> EncryptedKey -> ShowS

show :: EncryptedKey -> String

showList :: [EncryptedKey] -> ShowS

ToJSON EncryptedKey

Defined in Crypto.Ethereum.Keyfile

Methods

toJSON :: EncryptedKey -> Value

toEncoding :: EncryptedKey -> Encoding

toJSONList :: [EncryptedKey] -> Value

toEncodingList :: [EncryptedKey] -> Encoding

FromJSON EncryptedKey

Defined in Crypto.Ethereum.Keyfile

Methods

parseJSON :: Value -> Parser EncryptedKey

parseJSONList :: Value -> Parser [EncryptedKey]

data Cipher

Cipher parameters.

Constructors

Aes128Ctr

Fields

• cipherIv :: !(IV AES128)
• cipherText :: !HexString

data Kdf

Key derivation function parameters and salt.

Constructors

Pbkdf2 !Parameters !HexString

Scrypt !Parameters !HexString

Secret storage packers

decrypt :: (ByteArrayAccess password, ByteArray privateKey) => EncryptedKey -> password -> Maybe privateKey

Decrypt Ethereum private key.

Typically Web3 Secret Storage is JSON-encoded. EncryptedKey data type has FromJSON instance to helps decode it from JSON-encoded string or file.

  let decryptJSON pass = flip decrypt pass <=< decode

encrypt :: (ByteArray privateKey, ByteArrayAccess password, MonadRandom m) => privateKey -> password -> m EncryptedKey

Encrypt Ethereum private key.

  let encryptJSON pass key = encode $ encrypt key pass