Enum libp2p::identity::Keypair

pub enum Keypair {
    Ed25519(Keypair),
    Rsa(Keypair),
    Secp256k1(Keypair),
    Ecdsa(Keypair),
}

Identity keypair of a node.

Example: Generating RSA keys with OpenSSL

openssl genrsa -out private.pem 2048
openssl pkcs8 -in private.pem -inform PEM -topk8 -out private.pk8 -outform DER -nocrypt
rm private.pem      # optional

Loading the keys:

let mut bytes = std::fs::read("private.pk8").unwrap();
let keypair = Keypair::rsa_from_pkcs8(&mut bytes);

Variants

Ed25519(Keypair)

An Ed25519 keypair.

Rsa(Keypair)

Available on crate feature rsa and non-WebAssembly only.

An RSA keypair.

Secp256k1(Keypair)

Available on crate feature secp256k1 only.

A Secp256k1 keypair.

Ecdsa(Keypair)

Available on crate feature ecdsa only.

An ECDSA keypair.

Implementations

impl Keypair

pub fn generate_ed25519() -> Keypair

Generate a new Ed25519 keypair.

pub fn generate_secp256k1() -> Keypair

Available on crate feature secp256k1 only.

Generate a new Secp256k1 keypair.

pub fn generate_ecdsa() -> Keypair

Available on crate feature ecdsa only.

Generate a new ECDSA keypair.

pub fn rsa_from_pkcs8(pkcs8_der: &mut [u8]) -> Result<Keypair, DecodingError>

Available on crate feature rsa and non-WebAssembly only.

Decode an keypair from a DER-encoded secret key in PKCS#8 PrivateKeyInfo format (i.e. unencrypted) as defined in RFC5208.

pub fn secp256k1_from_der(der: &mut [u8]) -> Result<Keypair, DecodingError>

Available on crate feature secp256k1 only.

Decode a keypair from a DER-encoded Secp256k1 secret key in an ECPrivateKey structure as defined in RFC5915.

pub fn sign(&self, msg: &[u8]) -> Result<Vec<u8, Global>, SigningError>

Sign a message using the private key of this keypair, producing a signature that can be verified using the corresponding public key.

pub fn public(&self) -> PublicKey

Get the public key of this keypair.

pub fn to_protobuf_encoding(&self) -> Result<Vec<u8, Global>, DecodingError>

Encode a private key as protobuf structure.

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

Decode a private key from a protobuf structure and parse it as a Keypair.

Trait Implementations

impl Clone for Keypair

fn clone(&self) -> Keypair

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Keypair

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

Formats the value using the given formatter.