# Nim Ethereum Keys (nim-eth-keys) # Copyright (c) 2020 Status Research & Development GmbH # Licensed under either of # - Apache License, version 2.0, (LICENSE-APACHEv2) # - MIT license (LICENSE-MIT) # # This module contains adaptations of the general secp interface to help make # working with keys and signatures as they appear in Ethereum in particular: # # * Public keys as serialized in uncompressed format without the initial byte # * Shared secrets are serialized in raw format without the intial byte # * distinct types are used to avoid confusion with the "standard" secp types {.push raises: [Defect].} import secp256k1, bearssl, nimcrypto/hash, nimcrypto/keccak, stew/[byteutils, objects, results], strformat from nimcrypto/utils import burnMem export secp256k1, results, bearssl const KeyLength* = SkEcdhRawSecretSize - 1 ## Shared secret key length without format marker RawPublicKeySize* = SkRawPublicKeySize - 1 ## Size of uncompressed public key without format marker (0x04) RawSignatureSize* = SkRawRecoverableSignatureSize RawSignatureNRSize* = SkRawSignatureSize type PrivateKey* = distinct SkSecretKey PublicKey* = distinct SkPublicKey ## Public key that's serialized to raw format without 0x04 marker Signature* = distinct SkRecoverableSignature ## Ethereum uses recoverable signatures allowing some space savings SignatureNR* = distinct SkSignature ## ...but ENR uses non-recoverable signatures! SharedSecretFull* = SkEcdhRawSecret SharedSecret* = object data*: array[KeyLength, byte] KeyPair* = distinct SkKeyPair template pubkey*(v: KeyPair): PublicKey = PublicKey(SkKeyPair(v).pubkey) template seckey*(v: KeyPair): PrivateKey = PrivateKey(SkKeyPair(v).seckey) proc newRng*(): ref BrHmacDrbgContext = # You should only create one instance of the RNG per application / library # Ref is used so that it can be shared between components # TODO consider moving to bearssl var seeder = brPrngSeederSystem(nil) if seeder == nil: return nil var rng = (ref BrHmacDrbgContext)() brHmacDrbgInit(addr rng[], addr sha256Vtable, nil, 0) if seeder(addr rng.vtable) == 0: return nil rng proc random*(T: type PrivateKey, rng: var BrHmacDrbgContext): T = let rngPtr = unsafeAddr rng # doesn't escape proc callRng(data: var openArray[byte]) = brHmacDrbgGenerate(rngPtr[], data) T(SkSecretKey.random(callRng)) func fromRaw*(T: type PrivateKey, data: openArray[byte]): SkResult[T] = SkSecretKey.fromRaw(data).mapConvert(T) func fromHex*(T: type PrivateKey, data: string): SkResult[T] = SkSecretKey.fromHex(data).mapConvert(T) func toRaw*(seckey: PrivateKey): array[SkRawSecretKeySize, byte] = SkSecretKey(seckey).toRaw() func toPublicKey*(seckey: PrivateKey): PublicKey {.borrow.} func fromRaw*(T: type PublicKey, data: openArray[byte]): SkResult[T] = if data.len() == SkRawCompressedPublicKeySize: return SkPublicKey.fromRaw(data).mapConvert(T) if len(data) < SkRawPublicKeySize - 1: return err(static( &"keys: raw eth public key should be {SkRawPublicKeySize - 1} bytes")) var d: array[SkRawPublicKeySize, byte] d[0] = 0x04'u8 copyMem(addr d[1], unsafeAddr data[0], 64) SkPublicKey.fromRaw(d).mapConvert(T) func fromHex*(T: type PublicKey, data: string): SkResult[T] = T.fromRaw(? seq[byte].fromHex(data)) func toRaw*(pubkey: PublicKey): array[RawPublicKeySize, byte] = let tmp = SkPublicKey(pubkey).toRaw() copyMem(addr result[0], unsafeAddr tmp[1], 64) func toRawCompressed*(pubkey: PublicKey): array[33, byte] {.borrow.} proc random*(T: type KeyPair, rng: var BrHmacDrbgContext): T = let seckey = SkSecretKey(PrivateKey.random(rng)) KeyPair(SkKeyPair( seckey: seckey, pubkey: seckey.toPublicKey() )) func toKeyPair*(seckey: PrivateKey): KeyPair = KeyPair(SkKeyPair( seckey: SkSecretKey(seckey), pubkey: SkSecretKey(seckey).toPublicKey())) func fromRaw*(T: type Signature, data: openArray[byte]): SkResult[T] = SkRecoverableSignature.fromRaw(data).mapConvert(T) func fromHex*(T: type Signature, data: string): SkResult[T] = T.fromRaw(? seq[byte].fromHex(data)) func toRaw*(sig: Signature): array[RawSignatureSize, byte] {.borrow.} func fromRaw*(T: type SignatureNR, data: openArray[byte]): SkResult[T] = SkSignature.fromRaw(data).mapConvert(T) func toRaw*(sig: SignatureNR): array[RawSignatureNRSize, byte] {.borrow.} func toAddress*(pubkey: PublicKey, with0x = true): string = ## Convert public key to hexadecimal string address. var hash = keccak256.digest(pubkey.toRaw()) result = if with0x: "0x" else: "" result.add(toHex(toOpenArray(hash.data, 12, len(hash.data) - 1))) func toChecksumAddress*(pubkey: PublicKey, with0x = true): string = ## Convert public key to checksumable mixed-case address (EIP-55). result = if with0x: "0x" else: "" var hash1 = keccak256.digest(pubkey.toRaw()) var hhash1 = toHex(toOpenArray(hash1.data, 12, len(hash1.data) - 1)) var hash2 = keccak256.digest(hhash1) var hhash2 = toHex(hash2.data) for i in 0..= '0' and hhash2[i] <= '7': result.add(hhash1[i]) else: if hhash1[i] >= '0' and hhash1[i] <= '9': result.add(hhash1[i]) else: let ch = chr(ord(hhash1[i]) - ord('a') + ord('A')) result.add(ch) func validateChecksumAddress*(a: string): bool = ## Validate checksumable mixed-case address (EIP-55). var address = "" var check = "0x" if len(a) != 42: return false if a[0] != '0' and a[1] != 'x': return false for i in 2..41: let ch = a[i] if ch in {'0'..'9'} or ch in {'a'..'f'}: address &= ch elif ch in {'A'..'F'}: address &= chr(ord(ch) - ord('A') + ord('a')) else: return false var hash = keccak256.digest(address) var hexhash = toHex(hash.data) for i in 0..= '0' and hexhash[i] <= '7': check.add(address[i]) else: if address[i] >= '0' and address[i] <= '9': check.add(address[i]) else: let ch = chr(ord(address[i]) - ord('a') + ord('A')) check.add(ch) result = (check == a) func toCanonicalAddress*(pubkey: PublicKey): array[20, byte] = ## Convert public key to canonical address. var hash = keccak256.digest(pubkey.toRaw()) copyMem(addr result[0], addr hash.data[12], 20) func `$`*(pubkey: PublicKey): string = ## Convert public key to hexadecimal string representation. toHex(pubkey.toRaw()) func `$`*(sig: Signature): string = ## Convert signature to hexadecimal string representation. toHex(sig.toRaw()) func `$`*(seckey: PrivateKey): string = ## Convert private key to hexadecimal string representation toHex(seckey.toRaw()) func `==`*(lhs, rhs: PublicKey): bool {.borrow.} func `==`*(lhs, rhs: Signature): bool {.borrow.} func `==`*(lhs, rhs: SignatureNR): bool {.borrow.} func clear*(v: var PrivateKey) {.borrow.} func clear*(v: var KeyPair) = v.seckey.clear() func clear*(v: var SharedSecret) = burnMem(v.data) func clear*(v: var SharedSecretFull) = burnMem(v.data) func sign*(seckey: PrivateKey, msg: SkMessage): Signature = Signature(signRecoverable(SkSecretKey(seckey), msg)) func sign*(seckey: PrivateKey, msg: openArray[byte]): Signature = let hash = keccak256.digest(msg) sign(seckey, SkMessage(hash.data)) func signNR*(seckey: PrivateKey, msg: SkMessage): SignatureNR = SignatureNR(sign(SkSecretKey(seckey), msg)) func signNR*(seckey: PrivateKey, msg: openArray[byte]): SignatureNR = let hash = keccak256.digest(msg) signNR(seckey, SkMessage(hash.data)) func recover*(sig: Signature, msg: SkMessage): SkResult[PublicKey] = recover(SkRecoverableSignature(sig), msg).mapConvert(PublicKey) func recover*(sig: Signature, msg: openArray[byte]): SkResult[PublicKey] = let hash = keccak256.digest(msg) recover(sig, SkMessage(hash.data)) func verify*(sig: SignatureNR, msg: SkMessage, key: PublicKey): bool = verify(SkSignature(sig), msg, SkPublicKey(key)) func verify*(sig: SignatureNR, msg: openArray[byte], key: PublicKey): bool = let hash = keccak256.digest(msg) verify(sig, SkMessage(hash.data), key) func ecdhRaw*(seckey: PrivateKey, pubkey: PublicKey): SharedSecret = let tmp = ecdhRaw(SkSecretKey(seckey), SkPublicKey(pubkey)) # Remove first byte! copyMem(addr result.data[0], unsafeAddr(tmp.data[1]), sizeof(result)) func ecdhRawFull*(seckey: PrivateKey, pubkey: PublicKey): SharedSecretFull = SharedSecretFull(ecdhRaw(SkSecretKey(seckey), SkPublicKey(pubkey)))