Struct fedimint_core::transaction::Transaction

pub struct Transaction {
    pub inputs: Vec<DynInput>,
    pub outputs: Vec<DynOutput>,
    pub nonce: [u8; 8],
    pub signatures: TransactionSignature,
}

An atomic value transfer operation within the Fedimint system and consensus

The mint enforces that the total value of the outputs equals the total value of the inputs, to prevent creating funds out of thin air. In some cases, the value of the inputs and outputs can both be 0 e.g. when creating an offer to a Lightning Gateway.

Fields

inputs: Vec<DynInput>

DynInputs consumed by the transaction

outputs: Vec<DynOutput>

DynOutputs created as a result of the transaction

nonce: [u8; 8]

No defined meaning, can be used to send the otherwise exactly same transaction multiple times if the module inputs and outputs don’t introduce enough entropy.

In the future the nonce can be used for grinding a tx hash that fulfills certain PoW requirements.

signatures: TransactionSignature

signatures for all the public keys of the inputs

Implementations

impl Transaction

pub fn tx_hash(&self) -> TransactionId

Hash of the transaction (excluding the signature).

Transaction signature commits to this hash. To generate it without already having a signature use Self::tx_hash_from_parts.

pub fn tx_hash_from_parts( inputs: &[DynInput], outputs: &[DynOutput], nonce: [u8; 8] ) -> TransactionId

Generate the transaction hash.

pub fn validate_signatures( &self, pub_keys: Vec<PublicKey> ) -> Result<(), TransactionError>

Validate the schnorr signatures signed over the tx_hash

Trait Implementations

impl Clone for Transaction

fn clone(&self) -> Transaction

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Transaction

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

Formats the value using the given formatter.

impl Decodable for Transaction

fn consensus_decode<D: Read>( d: &mut D, modules: &ModuleDecoderRegistry ) -> Result<Self, DecodeError>

Decode an object with a well-defined format

fn consensus_decode_hex( hex: &str, modules: &ModuleDecoderRegistry ) -> Result<Self, DecodeError>

Decode an object from hex

impl Encodable for Transaction

fn consensus_encode<W: Write>(&self, writer: &mut W) -> Result<usize, Error>

Encode an object with a well-defined format. Returns the number of bytes written on success.

fn consensus_encode_to_vec(&self) -> Result<Vec<u8>, Error>

Self::consensus_encode to newly allocated Vec<u8>

fn consensus_encode_to_hex(&self) -> Result<String, Error>

fn consensus_hash<H>(&self) -> Hwhere H: Hash, H::Engine: Write,

Generate a SHA256 hash of the consensus encoding using the default hash engine for H.

impl Hash for Transaction

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 PartialEq for Transaction

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Transaction

impl StructuralEq for Transaction

impl StructuralPartialEq for Transaction