Struct Keypair 

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

A vanilla Ed25519 key pair

Implementations

impl Keypair

pub const SECRET_KEY_LENGTH: usize = 32

Can be used for generating a Keypair without a dependency on rand types

pub fn new() -> Keypair

Constructs a new, random Keypair using OsRng

pub fn new_from_array(secret_key: [u8; 32]) -> Keypair

Constructs a new Keypair using secret key bytes

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

Returns this Keypair as a byte array

pub fn try_from_base58_string(s: &str) -> Result<Keypair, Error>

Recovers a Keypair from a base58-encoded string

pub fn from_base58_string(s: &str) -> Keypair

Recovers a Keypair from a base58-encoded string

Panics

Panics if given a malformed base58 string, or if the contents of the encoded string is invalid Keypair data.

pub fn to_base58_string(&self) -> String

Returns this Keypair as a base58-encoded string

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

Gets this Keypair’s secret key bytes

pub fn insecure_clone(&self) -> Keypair

Allows Keypair cloning

Note that the Clone trait is intentionally unimplemented because making a second copy of sensitive secret keys in memory is usually a bad idea.

Only use this in tests or when strictly required. Consider using std::sync::Arc<Keypair> instead.

Trait Implementations

impl Debug for Keypair

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

Formats the value using the given formatter.

impl EncodableKey for Keypair

fn read<R>(reader: &mut R) -> Result<Keypair, Box<dyn Error>>

where R: Read,

fn write<W>(&self, writer: &mut W) -> Result<String, Box<dyn Error>>

where W: Write,

fn read_from_file<F>(path: F) -> Result<Self, Box<dyn Error>>

where F: AsRef<Path>,

fn write_to_file<F>(&self, outfile: F) -> Result<String, Box<dyn Error>>

where F: AsRef<Path>,

impl EncodableKeypair for Keypair

fn encodable_pubkey(&self) -> <Keypair as EncodableKeypair>::Pubkey

Returns the associated pubkey. Use this function specifically for settings that involve reading or writing pubkeys. For other settings, use Signer::pubkey() instead.

type Pubkey = Address

impl<T> PartialEq<T> for Keypair

where T: Signer,

fn eq(&self, other: &T) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl SeedDerivable for Keypair

fn from_seed(seed: &[u8]) -> Result<Keypair, Box<dyn Error>>

fn from_seed_and_derivation_path( seed: &[u8], derivation_path: Option<DerivationPath>, ) -> Result<Keypair, Box<dyn Error>>

fn from_seed_phrase_and_passphrase( seed_phrase: &str, passphrase: &str, ) -> Result<Keypair, Box<dyn Error>>

impl Signer for Keypair

fn pubkey(&self) -> Address

Infallibly gets the implementor’s public key. Returns the all-zeros Pubkey if the implementor has none.

fn try_pubkey(&self) -> Result<Address, SignerError>

Fallibly gets the implementor’s public key

fn sign_message(&self, message: &[u8]) -> Signature

Infallibly produces an Ed25519 signature over the provided message bytes. Returns the all-zeros Signature if signing is not possible.

fn try_sign_message(&self, message: &[u8]) -> Result<Signature, SignerError>

Fallibly produces an Ed25519 signature over the provided message bytes.

fn is_interactive(&self) -> bool

Whether the implementation requires user interaction to sign

impl TryFrom<&[u8]> for Keypair

type Error = Error

The type returned in the event of a conversion error.

fn try_from(bytes: &[u8]) -> Result<Keypair, <Keypair as TryFrom<&[u8]>>::Error>

Performs the conversion.