Struct MoneyAmount 

pub struct MoneyAmount(pub Decimal);

A parsed monetary amount with decimal precision.

This type represents a non-negative decimal value parsed from a human-readable string. It preserves the original precision, which is important when converting to token amounts with specific decimal places.

Precision

The scale method returns the number of decimal places, and mantissa returns the value as an integer. For example, "10.50" has scale 2 and mantissa 1050.

Tuple Fields

0: Decimal

Implementations

impl MoneyAmount

pub const fn scale(&self) -> u32

Returns the number of decimal places in the original input.

This is used to verify that the input precision doesn’t exceed the token’s decimal places.

pub const fn mantissa(&self) -> u128

Returns the value as an unsigned integer (without decimal point).

For example, "12.34" returns 1234.

impl MoneyAmount

pub fn parse(input: &str) -> Result<Self, MoneyAmountParseError>

Parses a human-readable currency string into a MoneyAmount.

Currency symbols, thousand separators, and whitespace are stripped before parsing. The result must be a non-negative number within the allowed range.

Errors

Returns an error if:

• The string cannot be parsed as a number
• The value is negative
• The value is outside the allowed range

impl MoneyAmount

pub fn to_token_amount<T: ScaleFromMantissa>( self, decimals: u8, ) -> Result<T, MoneyAmountParseError>

Converts this amount to a token-specific integer scaled to the given decimal places.

This is the shared logic used by chain-specific token deployments (EVM, Solana) to convert human-readable amounts into on-chain token units.

Errors

Returns an error if:

• The input precision exceeds the token’s decimal places
• The scaled value overflows the target type T

Trait Implementations

impl Clone for MoneyAmount

fn clone(&self) -> MoneyAmount

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for MoneyAmount

impl Debug for MoneyAmount

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

Formats the value using the given formatter.

impl Display for MoneyAmount

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

Formats the value using the given formatter.

impl Eq for MoneyAmount

impl From<u128> for MoneyAmount

fn from(value: u128) -> Self

Converts to this type from the input type.

impl FromStr for MoneyAmount

type Err = MoneyAmountParseError

The associated error which can be returned from parsing.

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

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

impl PartialEq for MoneyAmount

fn eq(&self, other: &MoneyAmount) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for MoneyAmount

impl TryFrom<&str> for MoneyAmount

type Error = MoneyAmountParseError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<f64> for MoneyAmount

type Error = MoneyAmountParseError

The type returned in the event of a conversion error.

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

Performs the conversion.