Trait TapTweak

pub trait TapTweak {
    type TweakedAux;
    type TweakedKey;

    // Required methods
    fn tap_tweak<C>(
        self,
        secp: &Secp256k1<C>,
        merkle_root: Option<TapNodeHash>,
    ) -> Self::TweakedAux
       where C: Verification;
    fn dangerous_assume_tweaked(self) -> Self::TweakedKey;
}

A trait for tweaking BIP340 key types (x-only public keys and key pairs).

Required Associated Types

type TweakedAux

Tweaked key type with optional auxiliary information

type TweakedKey

Tweaked key type

Required Methods

fn tap_tweak<C>( self, secp: &Secp256k1<C>, merkle_root: Option<TapNodeHash>, ) -> Self::TweakedAux

where C: Verification,

Tweaks an untweaked key with corresponding public key value and optional script tree merkle root. For the Keypair type this also tweaks the private key in the pair.

This is done by using the equation Q = P + H(P|c)G, where

• Q is the tweaked public key
• P is the internal public key
• H is the hash function
• c is the commitment data
• G is the generator point

Returns

The tweaked key and its parity.

fn dangerous_assume_tweaked(self) -> Self::TweakedKey

Directly converts an UntweakedPublicKey to a TweakedPublicKey

This method is dangerous and can lead to loss of funds if used incorrectly. Specifically, in multi-party protocols a peer can provide a value that allows them to steal.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors

impl TapTweak for XOnlyPublicKey

type TweakedAux = (TweakedPublicKey, Parity)

type TweakedKey = TweakedPublicKey

impl TapTweak for Keypair

type TweakedAux = TweakedKeypair

type TweakedKey = TweakedKeypair