Struct elements::TxOut

pub struct TxOut {
    pub asset: Asset,
    pub value: Value,
    pub nonce: Nonce,
    pub script_pubkey: Script,
    pub witness: TxOutWitness,
}

Transaction output

Fields

asset: Asset

Committed asset

value: Value

Committed amount

nonce: Nonce

Nonce (ECDH key passed to recipient)

script_pubkey: Script

Scriptpubkey

witness: TxOutWitness

Witness data - not deserialized/serialized as part of a TxIn object (rather as part of its containing transaction, if any) but is logically part of the txin.

Implementations

impl TxOut

pub fn new_fee(amount: u64, asset: AssetId) -> TxOut

Create a new fee output.

pub fn is_null_data(&self) -> bool

Whether this data represents nulldata (OP_RETURN followed by pushes, not necessarily minimal)

pub fn is_pegout(&self) -> bool

Whether this output is a pegout, which is a subset of nulldata with the following extra rules: (a) there must be at least 2 pushes, the first of which must be 32 bytes and the second of which must be nonempty; (b) all pushes must use a push opcode rather than a numeric or reserved opcode

pub fn pegout_data(&self) -> Option<PegoutData<'_>>

If this output is a pegout, returns the destination genesis block, the destination script pubkey, and any additional data

pub fn is_fee(&self) -> bool

Whether or not this output is a fee output

pub fn minimum_value(&self) -> u64

Extracts the minimum value from the rangeproof, if there is one, or returns 0.

impl TxOut

pub fn new_not_last_confidential<R, C>(
    rng: &mut R,
    secp: &Secp256k1<C>,
    value: u64,
    address: Address,
    asset: AssetId,
    spent_utxo_secrets: &[(Asset, Option<&TxOutSecrets>)]
) -> Result<(Self, AssetBlindingFactor, ValueBlindingFactor), ConfidentialTxOutError> where
    R: RngCore + CryptoRng,
    C: Signing, 

Creates a new confidential output that is not the last one in the transaction. Provide input secret information by creating TxOutSecrets type. The inputs secrets must be consistent with the target_asset confidential Asset It is not necessary to supply [TxOutSecrets] for explicit assets

pub fn to_non_last_confidential<R, C>(
    &mut self,
    rng: &mut R,
    secp: &Secp256k1<C>,
    blinder: PublicKey,
    spent_utxo_secrets: &[(Asset, Option<&TxOutSecrets>)]
) -> Result<(AssetBlindingFactor, ValueBlindingFactor), ConfidentialTxOutError> where
    R: RngCore + CryptoRng,
    C: Signing, 

Convert a explicit TxOut into a Confidential TxOut. The blinding key is provided by the blinder paramter. The initial value of nonce is ignored and is set to the ECDH pubkey sampled by the sender.

pub fn new_last_confidential<R, C>(
    rng: &mut R,
    secp: &Secp256k1<C>,
    value: u64,
    address: Address,
    asset: AssetId,
    spent_utxo_secrets: &[(Asset, &TxOutSecrets)],
    output_secrets: &[&TxOutSecrets]
) -> Result<(Self, AssetBlindingFactor, ValueBlindingFactor), ConfidentialTxOutError> where
    R: RngCore + CryptoRng,
    C: Signing, 

Creates a new confidential output that IS the last one in the transaction. Provide input Asset information by creating [TxInputAsset] type.

pub fn unblind<C: Verification>(
    &self,
    secp: &Secp256k1<C>,
    blinding_key: SecretKey
) -> Result<TxOutSecrets, UnblindError>

Unblinds a transaction output, if it is confidential.

It returns the secret elements of the value and asset Pedersen commitments.

Trait Implementations

impl Clone for TxOut

fn clone(&self) -> TxOut

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TxOut

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

Formats the value using the given formatter.

impl Decodable for TxOut

fn consensus_decode<D: BufRead>(d: D) -> Result<TxOut, Error>

Decode an object with a well-defined format

impl Default for TxOut

fn default() -> TxOut

Returns the “default value” for a type.

impl Deserialize for TxOut

fn deserialize(bytes: &[u8]) -> Result<Self, Error>

Deserialize a value from raw data.

impl Encodable for TxOut

fn consensus_encode<S: Write>(&self, s: S) -> Result<usize, Error>

Encode an object with a well-defined format, should only ever error if the underlying Write errors. Returns the number of bytes written on success

impl Hash for TxOut

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, 

Feeds a slice of this type into the given Hasher.

impl PartialEq<TxOut> for TxOut

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

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

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

This method tests for !=.

impl Serialize for TxOut

fn serialize(&self) -> Vec<u8>

Serialize a value as raw data.

impl Eq for TxOut

impl StructuralEq for TxOut

impl StructuralPartialEq for TxOut