ECPublicKey

Struct ECPublicKey 

Source
pub struct ECPublicKey(/* private fields */);
Expand description

A compressed elliptic curve digital signature algorithm (ECDSA) public key.

An ECPublicKey is a 33-byte compressed representation of a public key on the secp256k1 curve. The first byte is a prefix (0x02 or 0x03) that indicates the parity of the y-coordinate, followed by the 32-byte x-coordinate.

These public keys are used to:

  • Verify ECDSA signatures
  • Identify the owner of a private key without revealing the private key
  • Derive shared secrets (when combined with another party’s private key)

Unlike the larger 65-byte uncompressed format (ECUncompressedPublicKey), compressed public keys save space while providing the same cryptographic security.

§Examples

Verifying an ECDSA signature:

use bc_components::{ECKey, ECPrivateKey, ECPublicKey};

// Generate a keypair
let private_key = ECPrivateKey::new();
let public_key = private_key.public_key();

// Sign a message
let message = b"Hello, world!";
let signature = private_key.ecdsa_sign(message);

// Verify the signature
assert!(public_key.verify(&signature, message));

Implementations§

Source§

impl ECPublicKey

Source

pub const fn from_data(data: [u8; 33]) -> Self

Restores an ECDSA public key from an array of bytes.

This method performs no validation on the input data.

Source

pub fn data(&self) -> &[u8; 33]

Returns the ECDSA public key as an array of bytes.

Source

pub fn as_bytes(&self) -> &[u8]

Get the ECDSA public key as a byte slice.

Source§

impl ECPublicKey

Source

pub fn verify(&self, signature: &[u8; 64], message: impl AsRef<[u8]>) -> bool

Verifies an ECDSA signature for a message using this public key.

Returns true if the signature is valid for the given message and this public key, and false otherwise.

§Parameters
  • signature: A 70-72 byte DER-encoded ECDSA signature
  • message: The message that was signed

Trait Implementations§

Source§

impl AsRef<[u8]> for ECPublicKey

Source§

fn as_ref(&self) -> &[u8]

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

impl CBORTagged for ECPublicKey

Defines CBOR tags for EC keys.

Source§

fn cbor_tags() -> Vec<Tag>

Returns the CBOR tags for EC keys.

Source§

impl CBORTaggedEncodable for ECPublicKey

Implements CBOR encoding for EC public keys.

Source§

fn untagged_cbor(&self) -> CBOR

Creates the untagged CBOR representation.

The format is a map with:

  • Key 3: byte string of the key data (Note the absence of key 2, which would indicate a private key)
Source§

fn tagged_cbor(&self) -> CBOR

Returns the tagged CBOR encoding of this instance. Read more
Source§

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

Returns the tagged value in CBOR binary representation. Read more
Source§

impl Clone for ECPublicKey

Source§

fn clone(&self) -> ECPublicKey

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for ECPublicKey

Formats the key for debugging, showing type name and hexadecimal value.

Source§

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

Displays the key with type information and hexadecimal value.

Source§

impl Display for ECPublicKey

Formats the key as a hexadecimal string.

Source§

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

Displays the key as a hexadecimal string.

Source§

impl ECKey for ECPublicKey

Implements the ECKey trait for ECPublicKey.

Source§

fn public_key(&self) -> ECPublicKey

Returns the public key (self).

Source§

impl ECKeyBase for ECPublicKey

Implements the ECKeyBase trait methods for ECPublicKey.

Source§

const KEY_SIZE: usize = 33usize

The size of an EC compressed public key (33 bytes).

Source§

fn from_data_ref(data: impl AsRef<[u8]>) -> Result<Self>
where Self: Sized,

Creates a key from a byte slice, with validation.

Source§

fn data(&self) -> &[u8]

Returns the key as a byte slice.

Source§

fn hex(&self) -> String

Returns the key as a hexadecimal string.
Source§

fn from_hex(hex: impl AsRef<str>) -> Result<Self>

Creates a key from a hexadecimal string. Read more
Source§

impl ECPublicKeyBase for ECPublicKey

Implements the ECPublicKeyBase trait for converting to uncompressed format.

Source§

fn uncompressed_public_key(&self) -> ECUncompressedPublicKey

Converts this compressed public key to its uncompressed form.

Source§

impl<'a> From<&'a ECPublicKey> for &'a [u8]

Converts a reference to an ECPublicKey to a reference to a byte slice.

Source§

fn from(value: &'a ECPublicKey) -> Self

Returns a reference to the key as a byte slice.

Source§

impl<'a> From<&'a ECPublicKey> for &'a [u8; 33]

Converts a reference to an ECPublicKey to a reference to a fixed-size byte array.

Source§

fn from(value: &'a ECPublicKey) -> Self

Returns a reference to the underlying byte array.

Source§

impl From<[u8; 33]> for ECPublicKey

Converts a fixed-size byte array to an ECPublicKey.

Source§

fn from(value: [u8; 33]) -> Self

Converts a 33-byte array into an EC public key.

Source§

impl From<ECPublicKey> for CBOR

Converts an ECPublicKey to CBOR.

Source§

fn from(value: ECPublicKey) -> Self

Converts to tagged CBOR.

Source§

impl Hash for ECPublicKey

Source§

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

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

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

Feeds a slice of this type into the given Hasher. Read more
Source§

impl PartialEq for ECPublicKey

Source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

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

impl Verifier for ECPublicKey

Implements the Verifier trait for verifying signatures.

Source§

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

Verifies a signature for a message using this public key.

Only supports ECDSA signatures; returns false for other signature types.

Source§

impl Eq for ECPublicKey

Source§

impl StructuralPartialEq for ECPublicKey

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> 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> CBOREncodable for T
where T: Into<CBOR> + Clone,

Source§

fn to_cbor(&self) -> CBOR

Converts this value to a CBOR object. Read more
Source§

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

Converts this value directly to binary CBOR data. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

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> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToHex for T
where T: AsRef<[u8]>,

Source§

fn encode_hex<U>(&self) -> U
where U: FromIterator<char>,

Encode the hex strict representing self into the result. Lower case letters are used (e.g. f9b4ca)
Source§

fn encode_hex_upper<U>(&self) -> U
where U: FromIterator<char>,

Encode the hex strict representing self into the result. Upper case letters are used (e.g. F9B4CA)
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

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

Source§

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>,

Source§

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.
Source§

impl<T> UREncodable for T

Source§

fn ur(&self) -> UR

Returns the UR representation of the object.
Source§

fn ur_string(&self) -> String

Returns the UR string representation of the object.
Source§

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

Source§

fn vzip(self) -> V

Source§

impl<T> ErasedDestructor for T
where T: 'static,