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

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

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<FungibleAsset, 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: &FungibleAsset) -> bool

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

pub fn vault_key(&self) -> AssetVaultKey

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

pub fn add(self, other: FungibleAsset) -> Result<FungibleAsset, 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: FungibleAsset) -> Result<FungibleAsset, 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<(), Error>

Formats the value using the given formatter.

impl Deserializable for FungibleAsset

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

where R: ByteReader,

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<(), Error>

Formats the value using the given formatter.

impl From<FungibleAsset> for Asset

fn from(asset: FungibleAsset) -> Asset

Converts to this type from the input type.

impl From<FungibleAsset> for Word

fn from(asset: FungibleAsset) -> Word

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>(&self, target: &mut W)

where W: ByteWriter,

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<FungibleAsset, <FungibleAsset as TryFrom<Word>>::Error>

Performs the conversion.

impl Copy for FungibleAsset

impl Eq for FungibleAsset

impl StructuralPartialEq for FungibleAsset