Struct EthEmbeddedAccountId 

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

Represents a Miden AccountId that can be encoded in the 20-byte Ethereum address format.

This type wraps an AccountId and provides conversions to/from the Ethereum address encoding used in the bridge-in flow. In this encoding, the 20-byte Ethereum address format stores a Miden AccountId as: 0x00000000 || prefix(8) || suffix(8), where:

• prefix = bytes[4..12] as a big-endian u64
• suffix = bytes[12..20] as a big-endian u64

Note: prefix/suffix are conceptual 64-bit words; when converting to Felt, we must ensure Felt::new_unchecked(u64) does not reduce mod p (checked explicitly in Self::try_from_eth_address).

This type is used by integrators (Gateway, claim managers) to convert between Miden AccountIds and the Ethereum address format when constructing CLAIM notes or calling the AggLayer Bridge bridgeAsset() function.

Implementations

impl EthEmbeddedAccountId

pub fn new( bytes: [u8; 20], ) -> Result<EthEmbeddedAccountId, AddressConversionError>

Creates an EthEmbeddedAccountId from a 20-byte array.

The bytes are interpreted as an Ethereum-encoded Miden AccountId (big-endian): 0x00000000 || prefix(8) || suffix(8).

Errors

Returns an error if:

• the first 4 bytes (i.e., the most significant bytes) are not zero,
• packing the 8-byte prefix/suffix into Felt would reduce mod p,
• or the resulting felts do not form a valid AccountId.

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

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

Errors

Returns an error if the hex string is invalid, the hex part is not exactly 40 characters, or the decoded bytes do not represent a valid embedded AccountId.

pub const fn from_account_id(account_id: AccountId) -> EthEmbeddedAccountId

Creates an EthEmbeddedAccountId from an AccountId.

This conversion is infallible: an AccountId is always valid.

Example

let embedded = EthEmbeddedAccountId::from_account_id(destination_account_id);
let address_bytes = embedded.to_eth_address().into_bytes();
// then construct the CLAIM note with address_bytes...

pub fn try_from_eth_address( addr: EthAddress, ) -> Result<EthEmbeddedAccountId, AddressConversionError>

Creates an EthEmbeddedAccountId from an EthAddress.

Validates that the address contains a properly encoded Miden AccountId.

Errors

Returns an error if:

• the first 4 bytes are not zero (not in the embedded AccountId format),
• packing the 8-byte prefix/suffix into Felt would reduce mod p,
• or the resulting felts do not form a valid AccountId.

pub const fn to_account_id(&self) -> &AccountId

Returns a reference to the inner AccountId.

pub const fn into_account_id(self) -> AccountId

Consumes self and returns the inner AccountId.

pub fn to_eth_address(&self) -> EthAddress

Converts the embedded account ID to an EthAddress.

The resulting 20-byte address has the format: 0x00000000 || prefix(8) || suffix(8) (big-endian byte ordering).

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

Returns the raw 20-byte Ethereum address encoding.

pub fn to_hex(&self) -> String

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

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

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

See EthAddress::to_elements for details on the encoding.

Trait Implementations

impl Clone for EthEmbeddedAccountId

fn clone(&self) -> EthEmbeddedAccountId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for EthEmbeddedAccountId

impl Debug for EthEmbeddedAccountId

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

Formats the value using the given formatter.

impl Display for EthEmbeddedAccountId

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

Formats the value using the given formatter.

impl Eq for EthEmbeddedAccountId

impl From<AccountId> for EthEmbeddedAccountId

fn from(account_id: AccountId) -> EthEmbeddedAccountId

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<EthEmbeddedAccountId> for [u8; 20]

fn from(embedded: EthEmbeddedAccountId) -> [u8; 20]

Converts to this type from the input type.

impl From<EthEmbeddedAccountId> for AccountId

fn from(embedded: EthEmbeddedAccountId) -> AccountId

Converts to this type from the input type.

impl Hash for EthEmbeddedAccountId

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 EthEmbeddedAccountId

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

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.

impl TryFrom<[u8; 20]> for EthEmbeddedAccountId

type Error = AddressConversionError

The type returned in the event of a conversion error.

fn try_from( bytes: [u8; 20], ) -> Result<EthEmbeddedAccountId, <EthEmbeddedAccountId as TryFrom<[u8; 20]>>::Error>

Performs the conversion.