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. Backends convert to and from this type at system boundaries.

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 (e.g. &pinocchio::Address or &Pubkey).

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

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

Converts this type into a shared 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 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

Formats the value using the given formatter.

impl Default for Address

fn default() -> Address

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 From<[u8; 32]> for Address

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

fn from(address: BackendAddress) -> 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

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

Available on crate feature hopper-native-backend only.

fn zeroed() -> Self

Calls zeroed.

impl Copy for Address

impl Eq for Address

impl Pod for Address

Available on crate feature hopper-native-backend only.

impl Pod for Address

impl StructuralPartialEq for Address

impl TransparentAddress for Address