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) -> Self

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() -> Self

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.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for Address

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

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_from_bytes_mut_exact(bytes: &mut [u8]) -> Option<&mut Self>

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

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

where Self: AnyBitPattern,

Create a reference to a value at the beginning of aligned bytes, returns the value and the remaining bytes.

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

where Self: AnyBitPattern,

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

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

Similar to Self::from_bytes(), but for any type and without any checks

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

where Self: AnyBitPattern,

Like Self::from_bytes(), but returns an exclusive reference

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

where Self: AnyBitPattern,

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

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

Similar to Self::from_bytes_mut(), but for any type and without any checks

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

where Self: AnyBitPattern,

Create a slice of count values at the beginning of aligned bytes, returns the values and the remaining bytes.

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

where Self: AnyBitPattern,

Like Self::slice_from_bytes(), but returns an exclusive reference

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

Access the underlying byte representation of a data structure

final fn slice_as_bytes(values: &[Self]) -> &[u8]

Access the underlying byte representation of a slice of values

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

where Self: AnyBitPattern,

Access the underlying mutable byte representation of a data structure

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

Similar to Self::as_bytes_mut(), but for any type.