Struct Address 

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

Logically the same as u128, but aligned to 8 bytes.

Byte layout is the same as u128, just the alignment can be different.

The first 20 bits correspond to the shard index (the least significant bits first), and the remaining 108 bits (the most significant bits first) are an address allocated within that shard. This way, an address will have a bunch of zeroes in the middle that is shrinking as more shards are added and more addresses are allocated.

Implementations

impl Address

pub const NULL: Self

Sentinel contract address, inaccessible and not owned by anyone

pub const SYSTEM_CODE: Self

System contract for managing code of other contracts

pub const SYSTEM_BLOCK: Self

System contract for managing block state

pub const SYSTEM_STATE: Self

System contract for managing state of other contracts

pub const SYSTEM_NATIVE_TOKEN: Self

System contract for native token

pub const SYSTEM_SIMPLE_WALLET_BASE: Self

System simple wallet base contract that can be used by end user wallets

pub fn parse(s: &str) -> Option<(ShortHrp, Self)>

Parse address from a string formatted using Self::format().

Returns None if the address is formatted incorrectly.

pub fn format(&self, hrp: &ShortHrp) -> FormattedAddress

Format address for presentation purposes

pub const fn system_address_allocator(shard_index: ShardIndex) -> Self

System contract for address allocation on a particular shard index

Trait Implementations

impl AnyBitPatternMarker for Address

where for<'__ab_io_type, '__ab_io_type> u64: AnyBitPatternMarker,

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

impl Debug for Address

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

Formats the value using the given formatter.

impl Default for Address

fn default() -> Address

Returns the “default value” for a type.

impl Eq for Address

impl From<&Address> for u128

fn from(value: &Address) -> Self

Converts to this type from the input type.

impl From<Address> for u128

fn from(value: Address) -> Self

Converts to this type from the input type.

impl From<u128> for Address

fn from(value: u128) -> Self

Converts to this type from the input type.

impl Hash for Address

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

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

fn cmp(&self, other: &Address) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Address

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<&Address> for Address

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<Address> for &Address

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Address

fn partial_cmp(&self, other: &Address) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for Address

impl TrivialType for Address

where u64: TrivialType,

const ALIGNMENT: Alignment

Alignment of the type in metadata.

const METADATA: &[u8]

Data structure metadata in binary form, describing shape and types of the contents, see IoTypeMetadataKind for encoding details.

fn try_from_bytes_unaligned(bytes: &[u8]) -> Option<(&Unaligned<Self>, &[u8])>

Parse the beginning of bytes, which don’t need to be aligned.

const SIZE: u32 = _

final fn try_from_bytes(bytes: &[u8]) -> Option<(&Self, &[u8])>

Parse the beginning of aligned bytes, returns the value and the remaining bytes.

final fn try_from_bytes_exact(bytes: &[u8]) -> Option<&Self>

Like Self::try_from_bytes(), but returns None if there are more bytes than the value

final fn try_from_bytes_mut(bytes: &mut [u8]) -> Option<(&mut Self, &mut [u8])>

Like Self::try_from_bytes(), but returns an exclusive reference.

final fn try_read_unaligned(bytes: &[u8]) -> Option<(Self, &[u8])>

Read a copy from the beginning of bytes, which don’t need to be aligned, returns the value and the remaining bytes

final fn try_read_unaligned_exact(bytes: &[u8]) -> Option<Self>

Like Self::try_read_unaligned(), but returns None if there are more bytes than the value

final unsafe fn read_unaligned(bytes: &[u8]) -> Option<Self>

Read unaligned value from memory.

final unsafe fn read_unaligned_unchecked(bytes: &[u8]) -> Self

Similar to Self::read_unaligned(), but doesn’t do any checks at all.

final unsafe fn from_bytes(bytes: &[u8]) -> Option<&Self>

Create a reference to a type, which is represented by provided memory.

final unsafe fn from_bytes_unchecked(bytes: &[u8]) -> &Self

Similar to Self::from_bytes(), but doesn’t do any checks at all.

final unsafe fn from_bytes_mut(bytes: &mut [u8]) -> Option<&mut Self>

Create a mutable reference to a type, which is represented by provided memory.

final unsafe fn from_bytes_mut_unchecked(bytes: &mut [u8]) -> &mut Self

Similar to Self::from_bytes_mut(), but doesn’t do any checks at all.

final fn as_bytes(&self) -> &[u8; ab_io_type::trivial_type::SIZE_OF::<Self>]

Access the underlying byte representation of a data structure

final unsafe fn as_bytes_mut( &mut self, ) -> &mut [u8; ab_io_type::trivial_type::SIZE_OF::<Self>]

Access the underlying mutable byte representation of a data structure.