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

A vanilla Ed25519 key pair

Implementations§

§

impl Keypair

pub const SECRET_KEY_LENGTH: usize = 32usize

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

pub fn generate<R>(csprng: &mut R) -> Keypair
where R: CryptoRng + RngCore,

Constructs a new, random Keypair using a caller-provided RNG

pub fn new() -> Keypair

Constructs a new, random Keypair using OsRng

pub fn from_bytes(bytes: &[u8]) -> Result<Keypair, Error>

Recovers a Keypair from a byte array

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

Returns this Keypair as a byte array

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

Recovers a Keypair from a base58-encoded string

pub fn to_base58_string(&self) -> String

Returns this Keypair as a base58-encoded string

pub fn secret(&self) -> &SecretKey

Gets this Keypair’s SecretKey

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. Read more
§

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 = Pubkey

§

impl FromWasmAbi for Keypair

§

type Abi = u32

The wasm ABI type that this converts from when coming back out from the ABI boundary.
§

unsafe fn from_abi(js: u32) -> Keypair

Recover a Self from Self::Abi. Read more
§

impl IntoWasmAbi for Keypair

§

type Abi = u32

The wasm ABI type that this converts into when crossing the ABI boundary.
§

fn into_abi(self) -> u32

Convert self into Self::Abi so that it can be sent across the wasm ABI boundary.
§

impl LongRefFromWasmAbi for Keypair

§

type Abi = u32

Same as RefFromWasmAbi::Abi
§

type Anchor = Ref<'static, Keypair>

Same as RefFromWasmAbi::Anchor
§

unsafe fn long_ref_from_abi( js: <Keypair as LongRefFromWasmAbi>::Abi ) -> <Keypair as LongRefFromWasmAbi>::Anchor

Same as RefFromWasmAbi::ref_from_abi
§

impl OptionFromWasmAbi for Keypair

§

fn is_none(abi: &<Keypair as FromWasmAbi>::Abi) -> bool

Tests whether the argument is a “none” instance. If so it will be deserialized as None, and otherwise it will be passed to FromWasmAbi.
§

impl OptionIntoWasmAbi for Keypair

§

fn none() -> <Keypair as IntoWasmAbi>::Abi

Returns an ABI instance indicating “none”, which JS will interpret as the None branch of this option. Read more
§

impl<T> PartialEq<T> for Keypair
where T: Signer,

§

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

This method tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
§

impl RefFromWasmAbi for Keypair

§

type Abi = u32

The wasm ABI type references to Self are recovered from.
§

type Anchor = Ref<'static, Keypair>

The type that holds the reference to Self for the duration of the invocation of the function that has an &Self parameter. This is required to ensure that the lifetimes don’t persist beyond one function call, and so that they remain anonymous.
§

unsafe fn ref_from_abi( js: <Keypair as RefFromWasmAbi>::Abi ) -> <Keypair as RefFromWasmAbi>::Anchor

Recover a Self::Anchor from Self::Abi. Read more
§

impl RefMutFromWasmAbi for Keypair

§

type Abi = u32

Same as RefFromWasmAbi::Abi
§

type Anchor = RefMut<'static, Keypair>

Same as RefFromWasmAbi::Anchor
§

unsafe fn ref_mut_from_abi( js: <Keypair as RefMutFromWasmAbi>::Abi ) -> <Keypair as RefMutFromWasmAbi>::Anchor

Same as RefFromWasmAbi::ref_from_abi
§

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) -> Pubkey

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

fn try_pubkey(&self) -> Result<Pubkey, 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
source§

impl<'a> ToKeypair for &'a Keypair

source§

fn keypair(&self) -> &'a Keypair

source§

impl ToKeypair for Keypair

source§

fn keypair(&self) -> &Keypair

§

impl TryFromJsValue for Keypair

§

type Error = JsValue

The type returned in the event of a conversion error.
§

fn try_from_js_value( value: JsValue ) -> Result<Keypair, <Keypair as TryFromJsValue>::Error>

Performs the conversion.
§

impl VectorFromWasmAbi for Keypair

§

impl VectorIntoWasmAbi for Keypair

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> AsSigner for T
where T: ToKeypair,

source§

fn as_signer(&self) -> &dyn Signer

Returns a reference to the signer.
source§

fn signer_pubkey(&self) -> Pubkey

§

impl<'a, T, E> AsTaggedExplicit<'a, E> for T
where T: 'a,

§

fn explicit(self, class: Class, tag: u32) -> TaggedParser<'a, Explicit, Self, E>

§

impl<'a, T, E> AsTaggedImplicit<'a, E> for T
where T: 'a,

§

fn implicit( self, class: Class, constructed: bool, tag: u32 ) -> TaggedParser<'a, Implicit, Self, E>

source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> IntoEither for T

source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<T> Pointable for T

§

const ALIGN: usize = _

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
source§

impl<T> ReturnWasmAbi for T
where T: IntoWasmAbi,

§

type Abi = <T as IntoWasmAbi>::Abi

Same as IntoWasmAbi::Abi
source§

fn return_abi(self) -> <T as ReturnWasmAbi>::Abi

Same as IntoWasmAbi::into_abi, except that it may throw and never return in the case of Err.
source§

impl<T> Same for T

§

type Output = T

Should always be Self
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more