Struct SecretKey 

pub struct SecretKey(/* private fields */);

An EdDSA secret key.

Implementations

impl SecretKey

pub fn to_bytes(&self) -> [u8; 32]

Convert this secret key to a byte array.

pub fn as_bytes(&self) -> &[u8; 32]

View this secret key as a byte array.

pub fn from_bytes(bytes: Vec<u8>) -> Result<SecretKey, SignatureError>

Construct a SecretKey from a slice of bytes.

Example

use xpx_chain_crypto::SecretKey;
use xpx_chain_crypto::SECRET_KEY_LENGTH;
use xpx_chain_crypto::SignatureError;

let secret_key_bytes: [u8; SECRET_KEY_LENGTH] = [
   157, 097, 177, 157, 239, 253, 090, 096,
   186, 132, 074, 244, 146, 236, 044, 196,
   068, 073, 197, 105, 123, 050, 105, 025,
   112, 059, 172, 003, 028, 174, 127, 096, ];

let secret_key: SecretKey = SecretKey::from_bytes(secret_key_bytes.to_vec())?;

Returns

A Result whose okay value is an EdDSA SecretKey or whose error value is an SignatureError wrapping the internal error that occurred.

pub fn generate<T>(csprng: &mut T) -> SecretKey

where T: CryptoRng + Rng,

Generate a SecretKey from a csprng.

Example

extern crate rand;
extern crate sha3;
extern crate xpx_chain_crypto;

use rand::Rng;
use rand::rngs::OsRng;
use sha3::Sha3_512;
use xpx_chain_crypto::PublicKey;
use xpx_chain_crypto::SecretKey;
use xpx_chain_crypto::Signature;

let mut csprng = OsRng{};
let secret_key: SecretKey = SecretKey::generate(&mut csprng);

Afterwards, you can generate the corresponding public:

let public_key: PublicKey = (&secret_key).into();

Input

A CSPRNG with a fill_bytes() method, e.g. rand::OsRng

Trait Implementations

impl AsRef<[u8]> for SecretKey

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for SecretKey

fn clone(&self) -> SecretKey

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SecretKey

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SecretKey

fn default() -> SecretKey

Returns the “default value” for a type.

impl Drop for SecretKey

Overwrite secret key material with null bytes when it goes out of scope.

fn drop(&mut self)

Executes the destructor for this type.

impl<'a> From<&'a SecretKey> for ExpandedSecretKey

fn from(secret_key: &'a SecretKey) -> ExpandedSecretKey

Construct an ExpandedSecretKey from a SecretKey.

Examples

use rand::Rng;
use rand::thread_rng;
use sha3::Sha3_512;
use xpx_chain_crypto::{SecretKey, ExpandedSecretKey};

let mut csprng = thread_rng();
let secret_key: SecretKey = SecretKey::generate(&mut csprng);
let expanded_secret_key: ExpandedSecretKey = ExpandedSecretKey::from(&secret_key);

impl<'a> From<&'a SecretKey> for PublicKey

fn from(secret_key: &SecretKey) -> PublicKey

Derive this public key from its corresponding SecretKey.