Struct XOnlyPublicKey
pub struct XOnlyPublicKey(/* private fields */);
Expand description
An x-only public key, used for verification of Taproot signatures and serialized according to BIP-340.
§Serde support
Implements de/serialization with the serde
feature enabled. We treat the byte value as a tuple
of 32 u8
s for non-human-readable formats. This representation is optimal for for some formats
(e.g. bincode
) however other formats may be less optimal (e.g. cbor
).
§Examples
Basic usage:
use secp256k1::{rand, Secp256k1, Keypair, XOnlyPublicKey};
let secp = Secp256k1::new();
let keypair = Keypair::new(&secp, &mut rand::thread_rng());
let xonly = XOnlyPublicKey::from_keypair(&keypair);
Implementations§
§impl XOnlyPublicKey
impl XOnlyPublicKey
pub fn cmp_fast_unstable(&self, other: &XOnlyPublicKey) -> Ordering
pub fn cmp_fast_unstable(&self, other: &XOnlyPublicKey) -> Ordering
Like cmp::Cmp
but faster and with no guarantees across library versions.
The Cmp
implementation for FFI types is stable but slow because it first
serializes self
and other
before comparing them. This function provides a faster
comparison if you know that your types come from the same library version.
pub fn eq_fast_unstable(&self, other: &XOnlyPublicKey) -> bool
pub fn eq_fast_unstable(&self, other: &XOnlyPublicKey) -> bool
Like cmp::Eq
but faster and with no guarantees across library versions.
The Eq
implementation for FFI types is stable but slow because it first serializes
self
and other
before comparing them. This function provides a faster equality
check if you know that your types come from the same library version.
§impl XOnlyPublicKey
impl XOnlyPublicKey
pub fn as_ptr(&self) -> *const XOnlyPublicKey
👎Deprecated since 0.25.0: Use Self::as_c_ptr if you need to access the FFI layer
pub fn as_ptr(&self) -> *const XOnlyPublicKey
Obtains a raw const pointer suitable for use with FFI functions.
pub fn as_mut_ptr(&mut self) -> *mut XOnlyPublicKey
👎Deprecated since 0.25.0: Use Self::as_mut_c_ptr if you need to access the FFI layer
pub fn as_mut_ptr(&mut self) -> *mut XOnlyPublicKey
Obtains a raw mutable pointer suitable for use with FFI functions.
pub fn from_keypair(keypair: &Keypair) -> (XOnlyPublicKey, Parity)
pub fn from_keypair(keypair: &Keypair) -> (XOnlyPublicKey, Parity)
Returns the XOnlyPublicKey
(and it’s [Parity
]) for keypair
.
pub fn from_slice(data: &[u8]) -> Result<XOnlyPublicKey, Error>
pub fn from_slice(data: &[u8]) -> Result<XOnlyPublicKey, Error>
Creates a schnorr public key directly from a slice.
§Errors
Returns [Error::InvalidPublicKey
] if the length of the data slice is not 32 bytes or the
slice does not represent a valid Secp256k1 point x coordinate.
pub fn serialize(&self) -> [u8; 32]
pub fn serialize(&self) -> [u8; 32]
Serializes the key as a byte-encoded x coordinate value (32 bytes).
pub fn add_tweak<V>(
self,
secp: &Secp256k1<V>,
tweak: &Scalar,
) -> Result<(XOnlyPublicKey, Parity), Error>where
V: Verification,
pub fn add_tweak<V>(
self,
secp: &Secp256k1<V>,
tweak: &Scalar,
) -> Result<(XOnlyPublicKey, Parity), Error>where
V: Verification,
Tweaks an XOnlyPublicKey
by adding the generator multiplied with the given tweak to it.
§Returns
The newly tweaked key plus an opaque type representing the parity of the tweaked key, this
should be provided to tweak_add_check
which can be used to verify a tweak more efficiently
than regenerating it and checking equality.
§Errors
If the resulting key would be invalid.
§Examples
use secp256k1::{Secp256k1, Keypair, Scalar, XOnlyPublicKey};
let secp = Secp256k1::new();
let tweak = Scalar::random();
let mut keypair = Keypair::new(&secp, &mut rand::thread_rng());
let (xonly, _parity) = keypair.x_only_public_key();
let tweaked = xonly.add_tweak(&secp, &tweak).expect("Improbable to fail with a randomly generated tweak");
pub fn tweak_add_check<V>(
&self,
secp: &Secp256k1<V>,
tweaked_key: &XOnlyPublicKey,
tweaked_parity: Parity,
tweak: Scalar,
) -> boolwhere
V: Verification,
pub fn tweak_add_check<V>(
&self,
secp: &Secp256k1<V>,
tweaked_key: &XOnlyPublicKey,
tweaked_parity: Parity,
tweak: Scalar,
) -> boolwhere
V: Verification,
Verifies that a tweak produced by XOnlyPublicKey::add_tweak
was computed correctly.
Should be called on the original untweaked key. Takes the tweaked key and output parity from
XOnlyPublicKey::add_tweak
as input.
Currently this is not much more efficient than just recomputing the tweak and checking equality. However, in future this API will support batch verification, which is significantly faster, so it is wise to design protocols with this in mind.
§Returns
True if tweak and check is successful, false otherwise.
§Examples
use secp256k1::{Secp256k1, Keypair, Scalar};
let secp = Secp256k1::new();
let tweak = Scalar::random();
let mut keypair = Keypair::new(&secp, &mut rand::thread_rng());
let (mut public_key, _) = keypair.x_only_public_key();
let original = public_key;
let (tweaked, parity) = public_key.add_tweak(&secp, &tweak).expect("Improbable to fail with a randomly generated tweak");
assert!(original.tweak_add_check(&secp, &tweaked, parity, tweak));
pub fn public_key(&self, parity: Parity) -> PublicKey
pub fn public_key(&self, parity: Parity) -> PublicKey
Returns the [PublicKey
] for this XOnlyPublicKey
.
This is equivalent to using [PublicKey::from_xonly_and_parity(self, parity)
].
Trait Implementations§
§impl CPtr for XOnlyPublicKey
impl CPtr for XOnlyPublicKey
type Target = XOnlyPublicKey
fn as_c_ptr(&self) -> *const <XOnlyPublicKey as CPtr>::Target
fn as_mut_c_ptr(&mut self) -> *mut <XOnlyPublicKey as CPtr>::Target
§impl Clone for XOnlyPublicKey
impl Clone for XOnlyPublicKey
§fn clone(&self) -> XOnlyPublicKey
fn clone(&self) -> XOnlyPublicKey
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read more§impl Debug for XOnlyPublicKey
impl Debug for XOnlyPublicKey
§impl<'de> Deserialize<'de> for XOnlyPublicKey
impl<'de> Deserialize<'de> for XOnlyPublicKey
§fn deserialize<D>(
d: D,
) -> Result<XOnlyPublicKey, <D as Deserializer<'de>>::Error>where
D: Deserializer<'de>,
fn deserialize<D>(
d: D,
) -> Result<XOnlyPublicKey, <D as Deserializer<'de>>::Error>where
D: Deserializer<'de>,
§impl Display for XOnlyPublicKey
impl Display for XOnlyPublicKey
§impl From<PublicKey> for XOnlyPublicKey
impl From<PublicKey> for XOnlyPublicKey
§fn from(src: PublicKey) -> XOnlyPublicKey
fn from(src: PublicKey) -> XOnlyPublicKey
§impl From<XOnlyPublicKey> for XOnlyPublicKey
impl From<XOnlyPublicKey> for XOnlyPublicKey
Creates a new schnorr public key from a FFI x-only public key.
§fn from(pk: XOnlyPublicKey) -> XOnlyPublicKey
fn from(pk: XOnlyPublicKey) -> XOnlyPublicKey
§impl FromStr for XOnlyPublicKey
impl FromStr for XOnlyPublicKey
§impl Hash for XOnlyPublicKey
impl Hash for XOnlyPublicKey
§impl LowerHex for XOnlyPublicKey
impl LowerHex for XOnlyPublicKey
§impl Ord for XOnlyPublicKey
impl Ord for XOnlyPublicKey
§impl PartialEq for XOnlyPublicKey
impl PartialEq for XOnlyPublicKey
§impl PartialOrd for XOnlyPublicKey
impl PartialOrd for XOnlyPublicKey
§impl Serialize for XOnlyPublicKey
impl Serialize for XOnlyPublicKey
§fn serialize<S>(
&self,
s: S,
) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>where
S: Serializer,
fn serialize<S>(
&self,
s: S,
) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>where
S: Serializer,
impl Copy for XOnlyPublicKey
impl Eq for XOnlyPublicKey
impl StructuralPartialEq for XOnlyPublicKey
Auto Trait Implementations§
impl Freeze for XOnlyPublicKey
impl RefUnwindSafe for XOnlyPublicKey
impl Send for XOnlyPublicKey
impl Sync for XOnlyPublicKey
impl Unpin for XOnlyPublicKey
impl UnwindSafe for XOnlyPublicKey
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§unsafe fn clone_to_uninit(&self, dst: *mut T)
unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)