Struct EthAmount 

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

Represents an Ethereum uint256 amount as 8 u32 values.

This type provides a more typed representation of Ethereum amounts compared to raw [u32; 8] arrays, while maintaining compatibility with the existing MASM processing pipeline.

Implementations

impl EthAmount

pub fn new(bytes: [u8; 32]) -> EthAmount

Creates an EthAmount from a 32-byte array.

pub fn from_uint_str(s: &str) -> Result<EthAmount, EthAmountError>

Creates an EthAmount from a decimal (uint) string.

The string should contain only ASCII decimal digits (e.g. "2000000000000000000"). The value is stored as a 32-byte big-endian array, matching the Solidity uint256 layout.

Errors

Returns EthAmountError if the string is empty, contains non-digit characters, or represents a value that overflows uint256.

pub fn to_u256(&self) -> U256

Converts the EthAmount to a U256 for easier arithmetic operations.

pub fn to_elements(&self) -> Vec<Felt>

Converts the amount to a vector of field elements for note storage.

Each u32 value in the amount array is converted to a Felt.

pub const fn as_bytes(&self) -> &[u8; 32]

Returns the raw 32-byte array.

impl EthAmount

pub fn scale_to_token_amount( &self, scale_exp: u32, ) -> Result<Felt, EthAmountError>

Converts a U256 amount to a Miden Felt by scaling down by 10^scale_exp.

This is the deterministic reference implementation that computes:

• y = floor(x / 10^scale_exp) (the Miden amount as a Felt)

Arguments

• scale_exp - The scaling exponent (0-18)

Returns

The scaled-down Miden amount as a Felt

Errors

• EthAmountError::ScaleTooLarge if scale_exp > 18
• EthAmountError::ScaledValueDoesNotFitU64 if the result doesn’t fit in a u64
• EthAmountError::ScaledValueExceedsMaxFungibleAmount if the scaled value exceeds the maximum fungible token amount

Example

let eth_amount = EthAmount::from_u64(1_000_000_000_000_000_000); // 1 ETH in wei
let miden_amount = eth_amount.scale_to_token_amount(12)?;
// Result: 1_000_000 (1e6, Miden representation)

Trait Implementations

impl Clone for EthAmount

fn clone(&self) -> EthAmount

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for EthAmount

impl Debug for EthAmount

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

Formats the value using the given formatter.

impl Eq for EthAmount

impl Hash for EthAmount

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

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 PartialEq for EthAmount

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