Struct ed25519_dalek::Keypair

#[repr(C)]
pub struct Keypair {
    pub public: PublicKey,
    pub secret: SecretKey,
}

An ed25519 keypair.

Fields

public: PublicKey

The public half of this keypair.

secret: SecretKey

The secret half of this keypair.

Methods

impl Keypair

fn from_bytes<'a>(public: &'a [u8; 32], secret: &'a [u8; 32]) -> Keypair

Construct a Keypair from the bytes of a PublicKey and SecretKey.

Inputs

• public: a [u8; 32] representing the compressed Edwards-Y coordinate of a point on curve25519.
• secret: a [u8; 32] representing the corresponding secret key.

Warning

Absolutely no validation is done on the key. If you give this function bytes which do not represent a valid point, or which do not represent corresponding parts of the key, then your Keypair will be broken and it will be your fault.

Returns

A Keypair.

fn generate<D>(csprng: &mut Rng) -> Keypair where
    D: Digest<OutputSize = U64> + Default, 

Generate an ed25519 keypair.

Example

extern crate rand;
extern crate sha2;
extern crate ed25519_dalek;


use rand::Rng;
use rand::OsRng;
use sha2::Sha512;
use ed25519_dalek::Keypair;
use ed25519_dalek::Signature;

let mut cspring: OsRng = OsRng::new().unwrap();
let keypair: Keypair = Keypair::generate::<Sha512>(&mut cspring);

Input

A CSPRNG with a fill_bytes() method, e.g. the one returned from rand::OsRng::new() (in the rand crate).

The caller must also supply a hash function which implements the Digest and Default traits, and which returns 512 bits of output. The standard hash function used for most ed25519 libraries is SHA-512, which is available with use sha2::Sha512 as in the example above. Other suitable hash functions include Keccak-512 and Blake2b-512.

fn sign<D>(&self, message: &[u8]) -> Signature where
    D: Digest<OutputSize = U64> + Default, 

Sign a message with this keypair's secret key.

fn verify<D>(&self, message: &[u8], signature: &Signature) -> bool where
    D: FixedOutput<OutputSize = U64> + BlockInput + Default + Input, 

Verify a signature on a message with this keypair's public key.

Trait Implementations

impl Debug for Keypair

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.