Struct EthAddress 

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

Represents a plain Ethereum address (20 bytes).

This is the base type for any 20-byte Ethereum address. It is used for:

• Origin token addresses (EVM token contract addresses)
• Destination addresses in the bridge-out flow (real Ethereum addresses)
• Any other context where a plain 20-byte Ethereum address is needed

Representations used in this module

• Raw bytes: [u8; 20] in the conventional Ethereum big-endian byte order (bytes[0] is the most-significant byte).
• MASM “address[5]” limbs: 5 x u32 limbs in big-endian limb order (each limb encodes its 4 bytes in little-endian order so felts map to keccak bytes directly):
  • address[0] = bytes[0..4] (most-significant 4 bytes)
  • address[1] = bytes[4..8]
  • address[2] = bytes[8..12]
  • address[3] = bytes[12..16]
  • address[4] = bytes[16..20] (least-significant 4 bytes)

Implementations

impl EthAddress

pub const fn new(bytes: [u8; 20]) -> EthAddress

Creates a new EthAddress from a 20-byte array.

pub fn from_hex(hex_str: &str) -> Result<EthAddress, AddressConversionError>

Creates an EthAddress from a hex string (with or without “0x” prefix).

Errors

Returns an error if the hex string is invalid or the hex part is not exactly 40 characters.

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

Returns a reference to the underlying 20-byte array.

pub const fn into_bytes(self) -> [u8; 20]

Converts the address into a 20-byte array.

pub fn to_hex(&self) -> String

Converts the Ethereum address to a hex string (lowercase, 0x-prefixed).

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

Converts the Ethereum address into an array of 5 Felt values for Miden VM.

The returned order matches the Solidity ABI encoding convention (big-endian limb order):

• address[0] = bytes[0..4] (most-significant 4 bytes)
• address[1] = bytes[4..8]
• address[2] = bytes[8..12]
• address[3] = bytes[12..16]
• address[4] = bytes[16..20] (least-significant 4 bytes)

Each limb is interpreted as a little-endian u32 and stored in a Felt.

Trait Implementations

impl Clone for EthAddress

fn clone(&self) -> EthAddress

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for EthAddress

impl Debug for EthAddress

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

Formats the value using the given formatter.

impl Display for EthAddress

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

Formats the value using the given formatter.

impl Eq for EthAddress

impl From<EthAddress> for [u8; 20]

fn from(addr: EthAddress) -> [u8; 20]

Converts to this type from the input type.

impl From<EthEmbeddedAccountId> for EthAddress

fn from(embedded: EthEmbeddedAccountId) -> EthAddress

Converts to this type from the input type.

impl From<[u8; 20]> for EthAddress

fn from(bytes: [u8; 20]) -> EthAddress

Converts to this type from the input type.

impl Hash for EthAddress

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 EthAddress

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

impl TryFrom<EthAddress> for EthEmbeddedAccountId

type Error = AddressConversionError

The type returned in the event of a conversion error.

fn try_from( addr: EthAddress, ) -> Result<EthEmbeddedAccountId, <EthEmbeddedAccountId as TryFrom<EthAddress>>::Error>

Performs the conversion.