Struct Address 

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

A Solana address (public key): 32 bytes, transparent layout.

This is part of the Hopper runtime type surface.

PartialEq/Eq are implemented manually (see below) so every Address == Address in the runtime and in user programs compiles to the 4 x u64 word compare in address_eq rather than a bytewise loop. PartialOrd/Ord stay derived: word-equality and byte-equality decide the same pairs equal, so the derived ordering remains consistent with the manual equality.

Implementations

impl Address

pub const fn new(bytes: [u8; 32]) -> Self

Construct from a raw byte array.

pub const fn new_from_array(bytes: [u8; 32]) -> Self

Construct from a raw byte array (alias for compatibility).

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

Return the underlying bytes by value.

pub const fn as_array(&self) -> &[u8; 32]

Borrow the underlying byte array.

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

Borrow the underlying bytes.

impl Address

pub fn as_upstream<T>(&self) -> &T

where T: TransparentAddress,

Zero-cost borrow as a reference to any #[repr(transparent)] 32-byte type that shares layout with [u8; 32].

This is the preferred way to pass a Hopper Address where an upstream reference is expected.

Safety

Safe because Address is #[repr(transparent)] over [u8; 32] and any upstream 32-byte address type shares this layout.

pub fn from_upstream<T>(upstream: &T) -> &Address

where T: TransparentAddress,

Construct a Hopper Address reference from any #[repr(transparent)] 32-byte address type.

Trait Implementations

impl AsMut<[u8]> for Address

fn as_mut(&mut self) -> &mut [u8]

Converts this type into a mutable reference of the (usually inferred) input type.

impl AsRef<[u8; 32]> for Address

fn as_ref(&self) -> &[u8; 32]

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<[u8]> for Address

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

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

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

Formats the value using the given formatter.

impl Eq for Address

impl ExternalLensValue for Address

const SIZE: usize = 32

Number of bytes consumed by this lens value.

fn read(bytes: &[u8]) -> Self

Read a value from exactly Self::SIZE bytes.

impl From<Address> for Address

fn from(address: BackendAddress) -> Self

Converts to this type from the input type.

impl From<Address> for [u8; 32]

fn from(addr: Address) -> [u8; 32]

Converts to this type from the input type.

impl From<[u8; 32]> for Address

fn from(bytes: [u8; 32]) -> 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: &Self) -> 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

Word-compare equality: delegates to address_eq so the == operator is exactly as fast as the free function.

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

Inequality operator !=.

impl PartialOrd for Address

fn partial_cmp(&self, other: &Self) -> 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 Pod for Address

impl SeqElement for Address

const STRIDE: usize = 32

Fixed on-wire stride in bytes. MUST equal the exact number of bytes every value of this type encodes to (and decodes from).

impl TailCodec for Address

const MAX_ENCODED_LEN: usize = 32

Upper bound on the encoded size. Used by generated helpers to verify the account has enough room before invoking encode. Implementors should pick the smallest valid bound. Hopper uses this to pre-size reallocs.

fn encode(&self, out: &mut [u8]) -> Result<usize, ProgramError>

Serialize self into out. Returns the number of bytes written (always <= MAX_ENCODED_LEN). Fails with AccountDataTooSmall when out.len() < encoded_len.

fn decode(input: &[u8]) -> Result<(Self, usize), ProgramError>

Deserialize from input. Returns (value, bytes_consumed). Fails with InvalidAccountData on malformed encoding.

impl TransparentAddress for Address

impl TryFrom<&[u8]> for Address

type Error = TryFromSliceError

The type returned in the event of a conversion error.

fn try_from(slice: &[u8]) -> Result<Self, Self::Error>

Performs the conversion.

impl Zeroable for Address