Struct solana_program::pubkey::Pubkey[][src]

#[repr(transparent)]pub struct Pubkey(_);

Implementations

impl Pubkey[src]

pub fn new(pubkey_vec: &[u8]) -> Self[src]

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

pub fn new_rand() -> Self[src]

👎 Deprecated since 1.3.9:

Please use ‘Pubkey::new_unique’ instead

pub fn new_unique() -> Self[src]

unique Pubkey for tests and benchmarks.

pub fn create_with_seed(
    base: &Pubkey,
    seed: &str,
    owner: &Pubkey
) -> Result<Pubkey, PubkeyError>
[src]

pub fn create_program_address(
    seeds: &[&[u8]],
    program_id: &Pubkey
) -> Result<Pubkey, PubkeyError>
[src]

Create a program address

Program addresses are account keys that only the program has the authority to sign. The address is of the same form as a Solana Pubkey, except they are ensured to not be on the ed25519 curve and thus have no associated private key. When performing cross-program invocations the program can “sign” for the key by calling invoke_signed and passing the same seeds used to generate the address. The runtime will check that indeed the program associated with this address is the caller and thus authorized to be the signer.

Because the program address cannot lie on the ed25519 curve there may be seed and program id combinations that are invalid. In these cases an extra seed (bump seed) can be calculated that results in a point off the curve. Use find_program_address to calculate that bump seed.

Warning: Because of the way the seeds are hashed there is a potential for program address collisions for the same program id. The seeds are hashed sequentially which means that seeds {“abcdef”}, {“abc”, “def”}, and {“ab”, “cd”, “ef”} will all result in the same program address given the same program id. Since the change of collision is local to a given program id the developer of that program must take care to choose seeds that do not collide with themselves.

pub fn find_program_address(
    seeds: &[&[u8]],
    program_id: &Pubkey
) -> (Pubkey, u8)
[src]

Find a valid program address and its corresponding bump seed which must be passed as an additional seed when calling invoke_signed.

Panics in the very unlikely event that the additional seed could not be found.

The processes of finding a valid program address is by trial and error, and even though it is deterministic given a set of inputs it can take a variable amount of time to succeed across different inputs. This means that when called from an on-chain program it may incur a variable amount of the program’s compute budget. Programs that are meant to be very performant may not want to use this function because it could take a considerable amount of time. Also, programs that area already at risk of exceeding their compute budget should also call this with care since there is a chance that the program’s budget may be occasionally exceeded.

pub fn try_find_program_address(
    seeds: &[&[u8]],
    program_id: &Pubkey
) -> Option<(Pubkey, u8)>
[src]

Find a valid program address and its corresponding bump seed which must be passed as an additional seed when calling invoke_signed.

The processes of finding a valid program address is by trial and error, and even though it is deterministic given a set of inputs it can take a variable amount of time to succeed across different inputs. This means that when called from an on-chain program it may incur a variable amount of the program’s compute budget. Programs that are meant to be very performant may not want to use this function because it could take a considerable amount of time. Also, programs that area already at risk of exceeding their compute budget should also call this with care since there is a chance that the program’s budget may be occasionally exceeded.

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

pub fn log(&self)[src]

Log a Pubkey from a program

Trait Implementations

impl AsRef<[u8]> for Pubkey[src]

impl BorshDeserialize for Pubkey[src]

impl BorshSchema for Pubkey where
    [u8; 32]: BorshSchema
[src]

impl BorshSerialize for Pubkey[src]

impl Clone for Pubkey[src]

impl Copy for Pubkey[src]

impl Debug for Pubkey[src]

impl Default for Pubkey[src]

impl<'de> Deserialize<'de> for Pubkey[src]

impl Display for Pubkey[src]

impl Eq for Pubkey[src]

impl FromStr for Pubkey[src]

type Err = ParsePubkeyError

The associated error which can be returned from parsing.

impl Hash for Pubkey[src]

impl Ord for Pubkey[src]

impl PartialEq<Pubkey> for Pubkey[src]

impl PartialOrd<Pubkey> for Pubkey[src]

impl Sanitize for Pubkey[src]

impl Serialize for Pubkey[src]

impl StructuralEq for Pubkey[src]

impl StructuralPartialEq for Pubkey[src]

Auto Trait Implementations

impl RefUnwindSafe for Pubkey

impl Send for Pubkey

impl Sync for Pubkey

impl Unpin for Pubkey

impl UnwindSafe for Pubkey

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> DeserializeOwned for T where
    T: for<'de> Deserialize<'de>, 
[src]

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T> Same<T> for T[src]

type Output = T

Should always be Self

impl<T> ToHex for T where
    T: AsRef<[u8]>, 
[src]

impl<T> ToOwned for T where
    T: Clone
[src]

type Owned = T

The resulting type after obtaining ownership.

impl<T> ToString for T where
    T: Display + ?Sized
[src]

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

impl<V, T> VZip<V> for T where
    V: MultiLane<T>, 
[src]