Module Hieroglyphs

The opaque/abstract type for our private keys.

The opaque/abstract type for our public keys.

Generates an unique private key.

Derives an unique public key from private key.

Helper function which generates a signature key pair.

export ~priv ~pass dumps an encrypted version of the private key.

import ~cipher ~pass tries to load a previously exported private key, only if the cipher text and the password yield a valid, internally parseable private key.

load text parses a valid public key, otherwise, returns None.

show pubkey dumps/serialize a public key under string format.

address pubkey generates an unique, deterministic ID for given public key. It's useful, for instance, to externally track the used/consumed private keys with a maintained state under a blacklist, cause there's an unique mapping from priv to pub, and therefore, from priv to id : string (the composition of derive with address.

sign ~priv ~msg creates a deterministic string signature given the same private key and same message. Fails if the private key was already used previously to sign a message, even if the message was the same (TODO: it's safe to sign many times the same message, 'cause it still makes inversion/prediction attacks impossible).

verify ~pub ~msg ~signature succeeds if the signature is valid for given message and was generated by the private key which generated the given public key.