Struct PublicKeys 

pub struct PublicKeys { /* private fields */ }

A container for an entity’s public cryptographic keys.

PublicKeys combines a verification key for checking digital signatures with an encapsulation key for encrypting messages, providing a complete public key package for secure communication with an entity.

This type is designed to be freely shared across networks and systems, allowing others to securely communicate with the key owner, who holds the corresponding PrivateKeys instance.

Components

• signing_public_key - A public key used for verifying digital signatures. Can verify signatures created by the corresponding private key, which may be Schnorr, ECDSA, Ed25519, or SSH-based.

• encapsulation_public_key - A public key used for encrypting messages that can only be decrypted by the holder of the corresponding private key. Can be X25519 or ML-KEM based.

Use Cases

• Verifying the authenticity of signed messages or content
• Encrypting data for secure transmission to the key owner
• Identity verification in distributed systems
• Establishing secure communication channels

Examples

use bc_components::{EncapsulationPublicKey, keypair};

// Generate a key pair
let (private_keys, public_keys) = keypair();

// Get the encapsulation public key
let enc_pub_key = public_keys.enapsulation_public_key();

// The public key can be used for key encapsulation
// The resulting shared secret is only accessible to the
// holder of the corresponding private key

Implementations

impl PublicKeys

pub fn new( signing_public_key: SigningPublicKey, encapsulation_public_key: EncapsulationPublicKey, ) -> Self

Restores a PublicKeys from a SigningPublicKey and an EncapsulationPublicKey.

pub fn signing_public_key(&self) -> &SigningPublicKey

Returns the SigningPublicKey of this PublicKeys.

pub fn enapsulation_public_key(&self) -> &EncapsulationPublicKey

Returns the EncapsulationPublicKey of this PublicKeys.

Trait Implementations

impl AsRef<EncapsulationPublicKey> for PublicKeys

fn as_ref(&self) -> &EncapsulationPublicKey

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

impl AsRef<PublicKeys> for PublicKeys

fn as_ref(&self) -> &PublicKeys

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

impl AsRef<SigningPublicKey> for PublicKeys

fn as_ref(&self) -> &SigningPublicKey

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

impl CBORTagged for PublicKeys

fn cbor_tags() -> Vec<Tag>

Returns the CBOR tags associated with this type.

impl CBORTaggedDecodable for PublicKeys

fn from_untagged_cbor(untagged_cbor: CBOR) -> Result<Self>

Creates an instance of this type by decoding it from untagged CBOR.

fn from_tagged_cbor(cbor: CBOR) -> Result<Self, Error>

where Self: Sized,

Creates an instance of this type by decoding it from tagged CBOR.

fn from_tagged_cbor_data(data: impl AsRef<[u8]>) -> Result<Self, Error>

where Self: Sized,

Creates an instance of this type by decoding it from binary encoded tagged CBOR.

fn from_untagged_cbor_data(data: impl AsRef<[u8]>) -> Result<Self, Error>

where Self: Sized,

Creates an instance of this type by decoding it from binary encoded untagged CBOR.

impl CBORTaggedEncodable for PublicKeys

fn untagged_cbor(&self) -> CBOR

Returns the untagged CBOR encoding of this instance.

fn tagged_cbor(&self) -> CBOR

Returns the tagged CBOR encoding of this instance.

fn tagged_cbor_data(&self) -> Vec<u8>

Returns the tagged value in CBOR binary representation.

impl Clone for PublicKeys

fn clone(&self) -> PublicKeys

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PublicKeys

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

Formats the value using the given formatter.

impl Display for PublicKeys

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

Formats the value using the given formatter.

impl Encrypter for PublicKeys

fn encapsulation_public_key(&self) -> EncapsulationPublicKey

Returns the encapsulation public key for this encrypter.

fn encapsulate_new_shared_secret( &self, ) -> (SymmetricKey, EncapsulationCiphertext)

Encapsulates a new shared secret for the recipient.

impl From<&PublicKeys> for XID

Implements conversion from PublicKeys reference to XID via the signing public key.

fn from(key: &PublicKeys) -> Self

Converts to this type from the input type.

impl From<PublicKeys> for CBOR

fn from(value: PublicKeys) -> Self

Converts to this type from the input type.

impl Hash for PublicKeys

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for PublicKeys

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl PublicKeysProvider for PublicKeys

fn public_keys(&self) -> PublicKeys

Returns a complete set of public keys for cryptographic operations.

impl ReferenceProvider for PublicKeys

fn reference(&self) -> Reference

Returns a cryptographic reference that uniquely identifies this object.

fn ref_hex(&self) -> String

Returns the reference data as a hexadecimal string.

fn ref_data_short(&self) -> [u8; 4]

Returns the first four bytes of the reference.

fn ref_hex_short(&self) -> String

Returns the first four bytes of the reference as a hexadecimal string.

fn ref_bytewords(&self, prefix: Option<&str>) -> String

Returns the first four bytes of the reference as upper-case ByteWords.

fn ref_bytemoji(&self, prefix: Option<&str>) -> String

Returns the first four bytes of the reference as Bytemoji.

impl TryFrom<CBOR> for PublicKeys

type Error = Error

The type returned in the event of a conversion error.

fn try_from(cbor: CBOR) -> Result<Self>

Performs the conversion.

impl Verifier for PublicKeys

fn verify(&self, signature: &Signature, message: &dyn AsRef<[u8]>) -> bool

Verifies a signature against a message.

impl Eq for PublicKeys

impl StructuralPartialEq for PublicKeys