Struct Address 

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

The address of a Solana account.

Some account addresses are ed25519 public keys, with corresponding secret keys that are managed off-chain. Often, though, account addresses do not have corresponding secret keys — as with program derived addresses — or the secret key is not relevant to the operation of a program, and may have even been disposed of. As running Solana programs can not safely create or manage secret keys, the full Keypair is not defined in solana-program but in solana-sdk.

Implementations

impl Address

pub fn derive_address<const N: usize>( seeds: &[&[u8]; N], bump: Option<u8>, program_id: &Address, ) -> Address

Derive a program address from the given seeds, optional bump and program id.

In general, the derivation uses an optional bump (byte) value to ensure a valid PDA (off-curve) is generated. Even when a program stores a bump to derive a program address, it is necessary to use the [Address::create_program_address] to validate the derivation. In most cases, the program has the correct seeds for the derivation, so it would be sufficient to just perform the derivation and compare it against the expected resulting address.

This function avoids the cost of the create_program_address syscall (1500 compute units) by directly computing the derived address calculating the hash of the seeds, bump and program id using the sol_sha256 syscall.

Important

This function differs from [Address::create_program_address] in that it does not perform a validation to ensure that the derived address is a valid (off-curve) program derived address. It is intended for use in cases where the seeds, bump, and program id are known to be valid, and the caller wants to derive the address without incurring the cost of the create_program_address syscall.

pub const fn derive_address_const<const N: usize>( seeds: &[&[u8]; N], bump: Option<u8>, program_id: &Address, ) -> Address

Derive a program address from the given seeds, optional bump and program id.

In general, the derivation uses an optional bump (byte) value to ensure a valid PDA (off-curve) is generated.

This function is intended for use in const contexts - i.e., the seeds and bump are known at compile time and the program id is also a constant. It avoids the cost of the create_program_address syscall (1500 compute units) by directly computing the derived address using the SHA-256 hash of the seeds, bump and program id.

Important

This function differs from [Address::create_program_address] in that it does not perform a validation to ensure that the derived address is a valid (off-curve) program derived address. It is intended for use in cases where the seeds, bump, and program id are known to be valid, and the caller wants to derive the address without incurring the cost of the create_program_address syscall.

This function is a compile-time constant version of Address::derive_address. It has worse performance than derive_address, so only use this function in const contexts, where all parameters are known at compile-time.

impl Address

pub const fn new_from_array(address_array: [u8; 32]) -> Address

pub const fn from_str_const(s: &str) -> Address

Available on crate feature decode only.

Decode a string into an Address, usable in a const context

pub fn new_unique() -> Address

Available on crate feature atomic only.

Create a unique Address for tests and benchmarks.

pub fn create_with_seed( base: &Address, seed: &str, owner: &Address, ) -> Result<Address, AddressError>

Available on crate feature sha2 only.

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

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

Return a reference to the Address’s byte array.

pub fn is_on_curve(&self) -> bool

Available on crate features curve25519 or syscalls only.

Checks whether the given address lies on the Ed25519 curve.

On-curve addresses correspond to valid Ed25519 public keys (and therefore can have associated private keys). Off-curve addresses are typically used for program-derived addresses (PDAs).

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

Available on crate feature decode only.

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

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

Available on crate feature decode only.

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

Formats the value using the given formatter.

impl From<&Address> for Address

fn from(value: &Address) -> Address

Converts to this type from the input type.

impl From<[u8; 32]> for Address

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

Converts to this type from the input type.

impl FromStr for Address

Available on crate feature decode only.

type Err = ParseAddressError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Address, <Address as FromStr>::Err>

Parses a string s to return a value of this type.

impl Hash for Address

Custom impl of Hash for Address.

This allows us to skip hashing the length of the address which is always the same anyway.

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

where H: Hasher,

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

Available on crate feature sanitize only.

fn sanitize(&self) -> Result<(), SanitizeError>

impl TryFrom<&[u8]> for Address

type Error = TryFromSliceError

The type returned in the event of a conversion error.

fn try_from( address: &[u8], ) -> Result<Address, <Address as TryFrom<&[u8]>>::Error>

Performs the conversion.

impl TryFrom<&str> for Address

Available on crate feature decode only.

type Error = ParseAddressError

The type returned in the event of a conversion error.

fn try_from(s: &str) -> Result<Address, <Address as TryFrom<&str>>::Error>

Performs the conversion.

impl Copy for Address

impl Eq for Address

impl StructuralPartialEq for Address