Struct TapretProof

pub struct TapretProof {
    pub path_proof: TapretPathProof,
    pub internal_pk: InternalPk,
}

Information proving tapret determinism for a given tapret commitment. Used both in the commitment procedure for PSBTs and in client-side-validation of the commitment.

Fields

path_proof: TapretPathProof

A merkle path to the commitment inside the taproot script tree. For each node it also must hold information about the sibling in form of TapretNodePartner.

internal_pk: InternalPk

The internal key used by the taproot output.

We need to keep this information client-side since it can’t be retrieved from the mined transaction.

Implementations

impl TapretProof

pub fn original_pubkey_script(&self) -> ScriptPubkey

Restores original scripPubkey before deterministic bitcoin commitment applied.

pub fn verify( &self, msg: &Commitment, tx: &Tx, ) -> Result<(), ConvolveVerifyError>

Verifies tapret commitment agains the proof.

Trait Implementations

impl Clone for TapretProof

fn clone(&self) -> TapretProof

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ConvolveCommit<Commitment, TapretProof, TapretFirst> for InternalPk

type Commitment = OutputPk

Commitment type produced as a result of Self::convolve_commit procedure.

type CommitError = TapretKeyError

Error type that may be reported during Self::convolve_commit procedure. It may also be returned from ConvolveCommitProof::verify in case the proof data are invalid and the commitment can’t be re-created.

fn convolve_commit( &self, supplement: &TapretPathProof, msg: &Commitment, ) -> Result<(OutputPk, TapretProof), Self::CommitError>

Takes the supplement to unparse the content of this container (self) (“convolves” these two data together) and uses them to produce a final Self::Commitment to the message msg.

impl ConvolveCommit<Commitment, TapretProof, TapretFirst> for ScriptPubkey

type Commitment = ScriptPubkey

Commitment type produced as a result of Self::convolve_commit procedure.

type CommitError = TapretKeyError

Error type that may be reported during Self::convolve_commit procedure. It may also be returned from ConvolveCommitProof::verify in case the proof data are invalid and the commitment can’t be re-created.

fn convolve_commit( &self, supplement: &TapretProof, msg: &Commitment, ) -> Result<(ScriptPubkey, TapretProof), Self::CommitError>

Takes the supplement to unparse the content of this container (self) (“convolves” these two data together) and uses them to produce a final Self::Commitment to the message msg.

impl ConvolveCommit<Commitment, TapretProof, TapretFirst> for Tx

type Commitment = Tx

Commitment type produced as a result of Self::convolve_commit procedure.

type CommitError = TapretError

Error type that may be reported during Self::convolve_commit procedure. It may also be returned from ConvolveCommitProof::verify in case the proof data are invalid and the commitment can’t be re-created.

fn convolve_commit( &self, supplement: &TapretProof, msg: &Commitment, ) -> Result<(Tx, TapretProof), Self::CommitError>

Takes the supplement to unparse the content of this container (self) (“convolves” these two data together) and uses them to produce a final Self::Commitment to the message msg.

impl ConvolveCommit<Commitment, TapretProof, TapretFirst> for TxOut

type Commitment = TxOut

Commitment type produced as a result of Self::convolve_commit procedure.

type CommitError = TapretKeyError

Error type that may be reported during Self::convolve_commit procedure. It may also be returned from ConvolveCommitProof::verify in case the proof data are invalid and the commitment can’t be re-created.

fn convolve_commit( &self, supplement: &TapretProof, msg: &Commitment, ) -> Result<(TxOut, TapretProof), Self::CommitError>

Takes the supplement to unparse the content of this container (self) (“convolves” these two data together) and uses them to produce a final Self::Commitment to the message msg.

impl ConvolveCommitProof<Commitment, InternalPk, TapretFirst> for TapretProof

type Suppl = TapretPathProof

Supplement is a part of the proof data provided during commitment procedure.

fn restore_original(&self, _: &OutputPk) -> InternalPk

Restores the original source before the commitment from the supplement (the self) and commitment.

fn extract_supplement(&self) -> &Self::Suppl

Extract supplement from the proof.

fn verify( &self, msg: &Msg, commitment: &<Source as ConvolveCommit<Msg, Self, Protocol>>::Commitment, ) -> Result<(), ConvolveVerifyError>

where Self: VerifyEq,

Verifies commitment using proof (the self) against the message.

impl ConvolveCommitProof<Commitment, ScriptPubkey, TapretFirst> for TapretProof

type Suppl = TapretProof

Supplement is a part of the proof data provided during commitment procedure.

fn restore_original(&self, _: &ScriptPubkey) -> ScriptPubkey

Restores the original source before the commitment from the supplement (the self) and commitment.

fn extract_supplement(&self) -> &Self::Suppl

Extract supplement from the proof.

fn verify( &self, msg: &Msg, commitment: &<Source as ConvolveCommit<Msg, Self, Protocol>>::Commitment, ) -> Result<(), ConvolveVerifyError>

where Self: VerifyEq,

Verifies commitment using proof (the self) against the message.

impl ConvolveCommitProof<Commitment, Tx, TapretFirst> for TapretProof

type Suppl = TapretProof

Supplement is a part of the proof data provided during commitment procedure.

fn restore_original(&self, commitment: &Tx) -> Tx

Restores the original source before the commitment from the supplement (the self) and commitment.

fn extract_supplement(&self) -> &Self::Suppl

Extract supplement from the proof.

fn verify( &self, msg: &Msg, commitment: &<Source as ConvolveCommit<Msg, Self, Protocol>>::Commitment, ) -> Result<(), ConvolveVerifyError>

where Self: VerifyEq,

Verifies commitment using proof (the self) against the message.

impl ConvolveCommitProof<Commitment, TxOut, TapretFirst> for TapretProof

type Suppl = TapretProof

Supplement is a part of the proof data provided during commitment procedure.

fn restore_original(&self, commitment: &TxOut) -> TxOut

Restores the original source before the commitment from the supplement (the self) and commitment.

fn extract_supplement(&self) -> &Self::Suppl

Extract supplement from the proof.

fn verify( &self, msg: &Msg, commitment: &<Source as ConvolveCommit<Msg, Self, Protocol>>::Commitment, ) -> Result<(), ConvolveVerifyError>

where Self: VerifyEq,

Verifies commitment using proof (the self) against the message.

impl Debug for TapretProof

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TapretProof

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for TapretProof

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 Ord for TapretProof

fn cmp(&self, other: &TapretProof) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for TapretProof

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

fn partial_cmp(&self, other: &TapretProof) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for TapretProof

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StrictDecode for TapretProof

fn strict_decode(reader: &mut impl TypedRead) -> Result<Self, DecodeError>

fn strict_read(reader: impl ReadRaw) -> Result<Self, DecodeError>

impl StrictDeserialize for TapretProof

fn from_strict_serialized<const MAX: usize>( ast_data: Confined<Vec<u8>, 0, MAX>, ) -> Result<Self, DeserializeError>

fn strict_deserialize<const MAX: usize>( read: impl Read, ) -> Result<Self, DeserializeError>

fn strict_deserialize_from_file<const MAX: usize>( path: impl AsRef<Path>, ) -> Result<Self, DeserializeError>

impl StrictDumb for TapretProof

fn strict_dumb() -> Self

impl StrictEncode for TapretProof

fn strict_encode<W: TypedWrite>(&self, writer: W) -> Result<W>

fn strict_write(&self, writer: impl WriteRaw) -> Result<(), Error>

impl StrictSerialize for TapretProof

fn strict_serialized_len<const MAX: usize>(&self) -> Result<usize, Error>

fn to_strict_serialized<const MAX: usize>( &self, ) -> Result<Confined<Vec<u8>, 0, MAX>, SerializeError>

fn strict_serialize<const MAX: usize>( &self, write: impl Write, ) -> Result<(), Error>

fn strict_serialize_to_file<const MAX: usize>( &self, path: impl AsRef<Path>, ) -> Result<(), SerializeError>

impl StrictStruct for TapretProof

const ALL_FIELDS: &'static [&'static str]

fn strict_check_fields()

fn strict_type_info() -> TypeInfo<Self>

impl StrictType for TapretProof

const STRICT_LIB_NAME: &'static str = LIB_NAME_BPCORE

fn strict_name() -> Option<TypeName>

impl Eq for TapretProof

impl StrictProduct for TapretProof

impl StructuralPartialEq for TapretProof