Struct Amount 

pub struct Amount { /* private fields */ }

Re-export common types A token amount with associated decimal precision.

Stores the raw (smallest-unit) value plus the number of decimals, avoiding floating-point imprecision.

Implementations

impl Amount

pub fn from_raw(raw: u128, decimals: u8) -> Amount

Create from the raw (smallest-unit) integer value.

pub fn from_human(s: &str, decimals: u8) -> Result<Amount, KmsError>

Parse a human-readable decimal string (e.g. "1.5") into an Amount.

pub fn raw(&self) -> u128

The raw (smallest-unit) value.

pub fn decimals(&self) -> u8

Number of decimals.

pub fn to_human(&self) -> String

Convert to a human-readable decimal string.

pub fn to_u256(&self) -> (Felt, Felt)

Encode as a Starknet u256 (low, high) Felt pair.

Since the raw value is u128, it fits entirely in the low limb.

pub fn checked_add(&self, other: &Amount) -> Result<Amount, KmsError>

Checked addition (decimals must match).

pub fn checked_sub(&self, other: &Amount) -> Result<Amount, KmsError>

Checked subtraction (decimals must match).

pub fn is_zero(&self) -> bool

Returns true if the amount is zero.

Trait Implementations

impl Clone for Amount

fn clone(&self) -> Amount

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Amount

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

Formats the value using the given formatter.

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

fn deserialize<__D>( __deserializer: __D, ) -> Result<Amount, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Amount

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

Formats the value using the given formatter.

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

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for Amount

impl Eq for Amount

impl StructuralPartialEq for Amount