Struct Amount

pub struct Amount(/* private fields */);

A non-negative amount of tokens.

This is a fixed-point fraction, with Amount::DECIMAL_PLACES digits after the point. Amount::ONE is one whole token, divisible into 10.pow(Amount::DECIMAL_PLACES) parts.

Implementations

impl Amount

pub const ZERO: Self

The zero value.

pub const MAX: Self

The maximum value.

pub fn try_add(self, other: Self) -> Result<Self, ArithmeticError>

Checked addition.

pub fn try_add_one(self) -> Result<Self, ArithmeticError>

Checked increment.

pub fn saturating_add(self, other: Self) -> Self

Saturating addition.

pub fn try_sub(self, other: Self) -> Result<Self, ArithmeticError>

Checked subtraction.

pub fn try_sub_one(self) -> Result<Self, ArithmeticError>

Checked decrement.

pub fn saturating_sub(self, other: Self) -> Self

Saturating subtraction.

pub fn try_add_assign(&mut self, other: Self) -> Result<(), ArithmeticError>

Checked in-place addition.

pub fn try_add_assign_one(&mut self) -> Result<(), ArithmeticError>

Checked in-place increment.

pub fn saturating_add_assign(&mut self, other: Self)

Saturating in-place addition.

pub fn try_sub_assign(&mut self, other: Self) -> Result<(), ArithmeticError>

Checked in-place subtraction.

pub fn saturating_mul(&self, other: u128) -> Self

Saturating multiplication.

pub fn try_mul(self, other: u128) -> Result<Self, ArithmeticError>

Checked multiplication.

pub fn try_mul_assign(&mut self, other: u128) -> Result<(), ArithmeticError>

Checked in-place multiplication.

impl Amount

pub const DECIMAL_PLACES: u8 = 18u8

The base-10 exponent representing how much a token can be divided.

pub const ONE: Amount

One token.

pub fn from_tokens(tokens: u128) -> Amount

Returns an Amount corresponding to that many tokens, or Amount::MAX if saturated.

pub fn from_millis(millitokens: u128) -> Amount

Returns an Amount corresponding to that many millitokens, or Amount::MAX if saturated.

pub fn from_micros(microtokens: u128) -> Amount

Returns an Amount corresponding to that many microtokens, or Amount::MAX if saturated.

pub fn from_nanos(nanotokens: u128) -> Amount

Returns an Amount corresponding to that many nanotokens, or Amount::MAX if saturated.

pub fn from_attos(attotokens: u128) -> Amount

Returns an Amount corresponding to that many attotokens.

pub fn upper_half(self) -> u64

Helper function to obtain the 64 most significant bits of the balance.

pub fn lower_half(self) -> u64

Helper function to obtain the 64 least significant bits of the balance.

pub fn saturating_div(self, other: Amount) -> u128

Divides this by the other amount. If the other is 0, it returns u128::MAX.

Trait Implementations

impl Clone for Amount

fn clone(&self) -> Amount

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Amount

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

Formats the value using the given formatter.

impl Default for Amount

fn default() -> Amount

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Amount

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for Amount

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

Formats the value using the given formatter.

impl From<Amount> for u128

fn from(value: Amount) -> Self

Converts to this type from the input type.

impl FromStr for Amount

type Err = ParseAmountError

The associated error which can be returned from parsing.

fn from_str(src: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for Amount

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 InputType for Amount

type RawValueType = Amount

The raw type used for validator.

fn type_name() -> Cow<'static, str>

Type the name.

fn create_type_info(registry: &mut Registry) -> String

Create type information in the registry and return qualified typename.

fn parse(value: Option<Value>) -> InputValueResult<Self>

Parse from Value. None represents undefined.

fn to_value(&self) -> Value

Convert to a Value for introspection.

fn as_raw_value(&self) -> Option<&Self::RawValueType>

Returns a reference to the raw value.

fn qualified_type_name() -> String

Qualified typename.

impl Ord for Amount

fn cmp(&self, other: &Amount) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl OutputType for Amount

fn type_name() -> Cow<'static, str>

Type the name.

fn create_type_info(registry: &mut Registry) -> String

Create type information in the registry and return qualified typename.

async fn resolve( &self, _: &ContextSelectionSet<'_>, _field: &Positioned<Field>, ) -> ServerResult<Value>

Resolve an output value to async_graphql::Value.

fn qualified_type_name() -> String

Qualified typename.

fn introspection_type_name(&self) -> Cow<'static, str>

Introspection type name

impl PartialEq for Amount

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

fn partial_cmp(&self, other: &Amount) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl ScalarType for Amount

fn parse(value: Value) -> InputValueResult<Self>

Parse a scalar value.

fn to_value(&self) -> Value

Convert the scalar to Value.

fn is_valid(_value: &ConstValue) -> bool

Checks for a valid scalar value.

impl Serialize for Amount

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl<'a> Sum<&'a Amount> for Amount

fn sum<I: Iterator<Item = &'a Self>>(iter: I) -> Self

Takes an iterator and generates Self from the elements by “summing up” the items.

impl WitLoad for Amount

fn load<Instance>( memory: &Memory<'_, Instance>, location: GuestPointer, ) -> Result<Self, RuntimeError>

where Instance: InstanceWithMemory, <Instance::Runtime as Runtime>::Memory: RuntimeMemory<Instance>,

Loads an instance of the type from the location in the guest’s memory.

fn lift_from<Instance>( flat_layout: <Self::Layout as Layout>::Flat, memory: &Memory<'_, Instance>, ) -> Result<Self, RuntimeError>

where Instance: InstanceWithMemory, <Instance::Runtime as Runtime>::Memory: RuntimeMemory<Instance>,

Lifts an instance of the type from the flat_layout representation.

impl WitStore for Amount

fn store<Instance>( &self, memory: &mut Memory<'_, Instance>, location: GuestPointer, ) -> Result<(), RuntimeError>

where Instance: InstanceWithMemory, <Instance::Runtime as Runtime>::Memory: RuntimeMemory<Instance>,

Stores the type at the location in the guest’s memory.

fn lower<Instance>( &self, memory: &mut Memory<'_, Instance>, ) -> Result<<Self::Layout as Layout>::Flat, RuntimeError>

where Instance: InstanceWithMemory, <Instance::Runtime as Runtime>::Memory: RuntimeMemory<Instance>,

Lowers the type into its flat layout representation.

impl WitType for Amount

const SIZE: u32 = 16u32

The size of the type when laid out in memory.

type Layout = <HCons<u128, HNil> as WitType>::Layout

The layout of the type as fundamental types.

type Dependencies = HCons<u128, HNil>

Other WitTypes that this type depends on.

fn wit_type_name() -> Cow<'static, str>

Generates the WIT type name for this type.

fn wit_type_declaration() -> Cow<'static, str>

Generates the WIT type declaration for this type.

impl Copy for Amount

impl Eq for Amount

impl StructuralPartialEq for Amount