Enum Address 

pub enum Address {
    Substrate(String),
    Evm(String),
}

Generic address type for different chains

Variants

Substrate(String)

Substrate SS58 address

Evm(String)

EVM hex address (0x…) - validated with EIP-55 checksum

Implementations

impl Address

pub fn substrate_checked( addr: impl Into<String>, ) -> Result<Address, ValidationError>

Create a Substrate address with validation

This function validates:

• SS58 base58 encoding
• Blake2b checksum

Errors

Returns Err if the address format is invalid or checksum validation fails.

Example

use apex_sdk_types::Address;

// Valid SS58 address (Polkadot)
let addr = Address::substrate_checked("15oF4uVJwmo4TdGW7VfQxNLavjCXviqxT9S1MgbjMNHr6Sp5").unwrap();

// Invalid address
let result = Address::substrate_checked("invalid");
assert!(result.is_err());

pub fn substrate(addr: impl Into<String>) -> Address

Create a Substrate address without validation (legacy method)

Warning: This method does not perform SS58 checksum validation. Use substrate_checked() instead for new code.

This method is provided for backward compatibility and cases where validation is not required (e.g., trusted input sources).

pub fn evm_checked(addr: impl Into<String>) -> Result<Address, ValidationError>

Create an EVM address with validation

This function validates:

• Address format (0x followed by 40 hex characters)
• EIP-55 checksum (if the address has mixed case)

Errors

Returns Err if the address format is invalid or checksum validation fails.

Example

use apex_sdk_types::Address;

// Valid checksummed address
let addr = Address::evm_checked("0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed").unwrap();

// Valid lowercase address (no checksum)
let addr = Address::evm_checked("0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed").unwrap();

// Invalid checksum
let result = Address::evm_checked("0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAeD");
assert!(result.is_err());

pub fn evm(addr: impl Into<String>) -> Address

Create an EVM address without validation (legacy method)

Warning: This method does not perform EIP-55 checksum validation. Use evm_checked() instead for new code.

This method is provided for backward compatibility and cases where validation is not required (e.g., trusted input sources).

pub fn to_checksum(&self) -> String

Convert EVM address to checksummed format

For EVM addresses, returns the EIP-55 checksummed version. For Substrate addresses, returns the address unchanged.

pub fn as_str(&self) -> &str

Get the address as a string

pub fn validate(&self) -> Result<(), ValidationError>

Validate the address format and checksum

For EVM addresses, validates EIP-55 checksum. For Substrate addresses, always returns Ok (validation not implemented).

Trait Implementations

impl Clone for Address

fn clone(&self) -> Address

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Address

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Address

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Address

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

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 Eq for Address

impl StructuralPartialEq for Address