Struct utxo::ExtOutput

pub struct ExtOutput<D, K> {
    pub value: u64,
    pub assets: BTreeMap<K, u64>,
    pub data: Option<D>,
}

Output with native assets (e.g. Cardano, Ergo)

The algorithm of selection picks the closest.

1. Computes wanted - unwanted assets in the outputs, the larger the better. Returns 0 if there are more unwanted assets.
2. If the values of #1 are equal, the more wanted assets the better.
3. If the values of #2 are equal, the fewer unwanted assets the better.
4. If the values of #3 are equal, the larger value the better.

The value of asset should not be 0.

Fields

value: u64

Coin value.

assets: BTreeMap<K, u64>

Native assets.

data: Option<D>

Optional data such as transaction hash, index and any other data needed later. The output should be able to make a transaction input after selection.

Implementations

impl<D, K: Ord> ExtOutput<D, K>

pub fn insert_asset(&mut self, key: K, value: u64)

Insert asset value, skip if the value is zero.

Trait Implementations

impl<D: Clone, K: Clone> Clone for ExtOutput<D, K>

fn clone(&self) -> ExtOutput<D, K>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<D: Debug, K: Debug> Debug for ExtOutput<D, K>

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

Formats the value using the given formatter.

impl<D: PartialEq, K: PartialEq> PartialEq<ExtOutput<D, K>> for ExtOutput<D, K>

fn eq(&self, other: &ExtOutput<D, K>) -> bool

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

fn ne(&self, other: &ExtOutput<D, K>) -> bool

This method tests for !=.

impl<D, K: Clone + Ord> Select for ExtOutput<D, K>

fn zero() -> Self

Creates zero value of the UTxO type.

fn checked_add(&self, rhs: &Self) -> Option<Self>

Computes self + rhs, returning None if overflow occurred.

fn checked_sub(&self, rhs: &Self) -> Option<Self>

Computes self - rhs, returning None if overflow occurred.

fn saturating_sub(&self, rhs: &Self) -> Self

Computes self - rhs, saturating at the lowest bound if overflow occurred.

fn compare(&self, other: &Self, output: &Self) -> Ordering

Compares two UTxOs to see which is better for the output, the less the better. A good strategy of UTxO selection should:

impl<D, K> StructuralPartialEq for ExtOutput<D, K>