Enum libp2p_identity::Keypair

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

Available on crate features ecdsa or secp256k1 or ed25519 or rsa only.

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)

👎Deprecated since 0.1.0: This enum will be made opaque in the future, use Keypair::try_into_ed25519 instead.

Available on crate feature ed25519 only.

An Ed25519 keypair.

Rsa(Keypair)

👎Deprecated since 0.1.0: This enum will be made opaque in the future, use Keypair::try_into_rsa instead.

Available on crate feature rsa and non-WebAssembly only.

An RSA keypair.

Secp256k1(Keypair)

👎Deprecated since 0.1.0: This enum will be made opaque in the future, use Keypair::try_into_secp256k1 instead.

Available on crate feature secp256k1 only.

A Secp256k1 keypair.

Ecdsa(Keypair)

👎Deprecated since 0.1.0: This enum will be made opaque in the future, use Keypair::try_into_ecdsa instead.

Available on crate feature ecdsa only.

An ECDSA keypair.

Implementations

impl Keypair

pub fn generate_ed25519() -> Keypair

Available on crate feature ed25519 only.

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 into_ed25519(self) -> Option<Keypair>

👎Deprecated: This method name does not follow Rust naming conventions, use Keypair::try_into_ed25519 instead.

Available on crate feature ed25519 only.

pub fn try_into_ed25519(self) -> Result<Keypair, OtherVariantError>

Available on crate feature ed25519 only.

pub fn into_secp256k1(self) -> Option<Keypair>

👎Deprecated: This method name does not follow Rust naming conventions, use Keypair::try_into_secp256k1 instead.

Available on crate feature secp256k1 only.

pub fn try_into_secp256k1(self) -> Result<Keypair, OtherVariantError>

Available on crate feature secp256k1 only.

pub fn into_rsa(self) -> Option<Keypair>

👎Deprecated: This method name does not follow Rust naming conventions, use Keypair::try_into_rsa instead.

Available on crate feature rsa and non-WebAssembly only.

pub fn try_into_rsa(self) -> Result<Keypair, OtherVariantError>

Available on crate feature rsa and non-WebAssembly only.

pub fn into_ecdsa(self) -> Option<Keypair>

👎Deprecated: This method name does not follow Rust naming conventions, use Keypair::try_into_ecdsa instead.

Available on crate feature ecdsa only.

pub fn try_into_ecdsa(self) -> Result<Keypair, OtherVariantError>

Available on crate feature ecdsa only.

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 ed25519_from_bytes( bytes: impl AsMut<[u8]> ) -> Result<Keypair, DecodingError>

Available on crate feature ed25519 only.

pub fn sign(&self, msg: &[u8]) -> Result<Vec<u8>, 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>, 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

Formats the value using the given formatter.

impl From<Keypair> for Keypair

Available on crate feature secp256k1 only.

fn from(kp: Keypair) -> Self

Converts to this type from the input type.

impl From<Keypair> for Keypair

Available on crate feature rsa and non-WebAssembly only.

fn from(kp: Keypair) -> Self

Converts to this type from the input type.

impl From<Keypair> for Keypair

Available on crate feature ecdsa only.

fn from(kp: Keypair) -> Self

Converts to this type from the input type.

impl From<Keypair> for Keypair

Available on crate feature ed25519 only.

fn from(kp: Keypair) -> Self

Converts to this type from the input type.

impl TryInto<Keypair> for Keypair

Available on crate feature rsa and non-WebAssembly only.

type Error = OtherVariantError

The type returned in the event of a conversion error.

fn try_into(self) -> Result<Keypair, Self::Error>

Performs the conversion.

impl TryInto<Keypair> for Keypair

Available on crate feature ecdsa only.

type Error = OtherVariantError

The type returned in the event of a conversion error.

fn try_into(self) -> Result<Keypair, Self::Error>

Performs the conversion.

impl TryInto<Keypair> for Keypair

Available on crate feature ed25519 only.

type Error = OtherVariantError

The type returned in the event of a conversion error.

fn try_into(self) -> Result<Keypair, Self::Error>

Performs the conversion.

impl TryInto<Keypair> for Keypair

Available on crate feature secp256k1 only.

type Error = OtherVariantError

The type returned in the event of a conversion error.

fn try_into(self) -> Result<Keypair, Self::Error>

Performs the conversion.