Struct FungibleAsset 

pub struct FungibleAsset { /* private fields */ }

A fungible asset.

A fungible asset consists of a faucet ID of the faucet which issued the asset as well as the asset amount. Asset amount is guaranteed to be 2^63 - 1 or smaller.

Implementations

impl FungibleAsset

pub const MAX_AMOUNT: u64 = 9_223_372_034_707_292_160u64

Specifies the maximum amount a fungible asset can represent.

This number was chosen so that it can be represented as a positive and negative number in a field element. See account_delta.masm for more details on how this number was chosen.

pub const SERIALIZED_SIZE: usize = 23usize

The serialized size of a FungibleAsset in bytes.

Currently an account ID (15 bytes) plus an amount (u64).

pub const fn new(faucet_id: AccountId, amount: u64) -> Result<Self, AssetError>

Returns a fungible asset instantiated with the provided faucet ID and amount.

Errors

Returns an error if:

• The faucet_id is not a valid fungible faucet ID.
• The provided amount is greater than 2^63 - 1.

pub fn faucet_id(&self) -> AccountId

Return ID of the faucet which issued this asset.

pub fn faucet_id_prefix(&self) -> AccountIdPrefix

Return ID prefix of the faucet which issued this asset.

pub fn amount(&self) -> u64

Returns the amount of this asset.

pub fn is_from_same_faucet(&self, other: &Self) -> bool

Returns true if this and the other assets were issued from the same faucet.

pub fn vault_key(&self) -> Word

Returns the key which is used to store this asset in the account vault.

pub fn add(self, other: Self) -> Result<Self, AssetError>

Adds two fungible assets together and returns the result.

Errors

Returns an error if:

• The assets were not issued by the same faucet.
• The total value of assets is greater than or equal to 2^63.

pub fn sub(self, other: Self) -> Result<Self, AssetError>

Subtracts a fungible asset from another and returns the result.

Errors

Returns an error if:

• The assets were not issued by the same faucet.
• The final amount would be negative.

Trait Implementations

impl Clone for FungibleAsset

fn clone(&self) -> FungibleAsset

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FungibleAsset

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

Formats the value using the given formatter.

impl Deserializable for FungibleAsset

fn read_from<R: ByteReader>( source: &mut R, ) -> Result<Self, DeserializationError>

Reads a sequence of bytes from the provided source, attempts to deserialize these bytes into Self, and returns the result.

fn read_from_bytes(bytes: &[u8]) -> Result<Self, DeserializationError>

Attempts to deserialize the provided bytes into Self and returns the result.

impl Display for FungibleAsset

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

Formats the value using the given formatter.

impl From<FungibleAsset> for Asset

fn from(asset: FungibleAsset) -> Self

Converts to this type from the input type.

impl From<FungibleAsset> for Word

fn from(asset: FungibleAsset) -> Self

Converts to this type from the input type.

impl PartialEq for FungibleAsset

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

fn write_into<W: ByteWriter>(&self, target: &mut W)

Serializes self into bytes and writes these bytes into the target.

fn get_size_hint(&self) -> usize

Returns an estimate of how many bytes are needed to represent self.

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

Serializes self into a vector of bytes.

impl TryFrom<Word> for FungibleAsset

type Error = AssetError

The type returned in the event of a conversion error.

fn try_from(value: Word) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for FungibleAsset

impl Eq for FungibleAsset

impl StructuralPartialEq for FungibleAsset