SchnorrPublicKey

Struct SchnorrPublicKey 

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

A Schnorr (x-only) elliptic curve public key.

A SchnorrPublicKey is a 32-byte “x-only” public key used with the BIP-340 Schnorr signature scheme. Unlike compressed ECDSA public keys (33 bytes) that include a prefix byte indicating the parity of the y-coordinate, Schnorr public keys only contain the x-coordinate of the elliptic curve point.

Schnorr signatures offer several advantages over traditional ECDSA signatures:

  • Linearity: Enables key and signature aggregation (eg., for multisignature schemes)
  • Non-malleability: Prevents third parties from modifying signatures
  • Smaller size: Signatures are 64 bytes vs 70-72 bytes for ECDSA
  • Better privacy: Makes different multisig policies indistinguishable
  • Provable security: Requires fewer cryptographic assumptions than ECDSA

Schnorr signatures were introduced to Bitcoin via the Taproot upgrade (BIP-340) and are becoming more widely used in cryptocurrency applications.

§Examples

Verifying a Schnorr signature:

use bc_components::ECPrivateKey;

// Generate a private key
let private_key = ECPrivateKey::new();

// Get the Schnorr public key
let schnorr_public_key = private_key.schnorr_public_key();

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

// Verify the signature
assert!(schnorr_public_key.schnorr_verify(&signature, message));

Implementations§

Source§

impl SchnorrPublicKey

Source

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

Restores a Schnorr public key from an array of bytes.

This method performs no validation on the input data.

Source

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

Returns the Schnorr public key as an array of bytes.

Source

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

Get the Schnorr public key as a byte slice.

Source§

impl SchnorrPublicKey

Source

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

Verifies a Schnorr 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.

This implementation follows the BIP-340 Schnorr signature verification algorithm.

§Parameters
  • signature: A 64-byte Schnorr signature
  • message: The message that was signed

Trait Implementations§

Source§

impl AsRef<[u8]> for SchnorrPublicKey

Provides a reference to the key data as a byte slice.

Source§

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

Returns a reference to the key as a byte slice.

Source§

impl Clone for SchnorrPublicKey

Source§

fn clone(&self) -> SchnorrPublicKey

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 SchnorrPublicKey

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 SchnorrPublicKey

Formats the key as a hexadecimal string.

Source§

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

Displays the key as a hexadecimal string.

Source§

impl ECKeyBase for SchnorrPublicKey

Implements the ECKeyBase trait methods for SchnorrPublicKey.

Source§

const KEY_SIZE: usize = 32usize

The size of a Schnorr public key (32 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<'a> From<&'a SchnorrPublicKey> for &'a [u8; 32]

Converts a reference to a SchnorrPublicKey to a reference to a fixed-size byte array.

Source§

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

Returns a reference to the underlying byte array.

Source§

impl From<[u8; 32]> for SchnorrPublicKey

Converts a fixed-size byte array to a SchnorrPublicKey.

Source§

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

Converts a 32-byte array into a Schnorr public key.

Source§

impl Hash for SchnorrPublicKey

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 SchnorrPublicKey

Source§

fn eq(&self, other: &SchnorrPublicKey) -> 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 Eq for SchnorrPublicKey

Source§

impl StructuralPartialEq for SchnorrPublicKey

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> 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<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

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