#[repr(C)]
pub struct AccountInfo<'a> { pub key: &'a Pubkey, pub lamports: Rc<RefCell<&'a mut u64>>, pub data: Rc<RefCell<&'a mut [u8]>>, pub owner: &'a Pubkey, pub rent_epoch: u64, pub is_signer: bool, pub is_writable: bool, pub executable: bool, }
Expand description

Account information

Fields§

§key: &'a Pubkey

Public key of the account

§lamports: Rc<RefCell<&'a mut u64>>

The lamports in the account. Modifiable by programs.

§data: Rc<RefCell<&'a mut [u8]>>

The data held in this account. Modifiable by programs.

§owner: &'a Pubkey

Program that owns this account

§rent_epoch: u64

The epoch at which this account will next owe rent

§is_signer: bool

Was the transaction signed by this account’s public key?

§is_writable: bool

Is the account writable?

§executable: bool

This account’s data contains a loaded program (and is now read-only)

Implementations§

§

impl<'a> AccountInfo<'a>

pub fn signer_key(&self) -> Option<&Pubkey>

pub fn unsigned_key(&self) -> &Pubkey

pub fn lamports(&self) -> u64

pub fn try_lamports(&self) -> Result<u64, ProgramError>

pub unsafe fn original_data_len(&self) -> usize

Return the account’s original data length when it was serialized for the current program invocation.

§Safety

This method assumes that the original data length was serialized as a u32 integer in the 4 bytes immediately preceding the serialized account key.

pub fn data_len(&self) -> usize

pub fn try_data_len(&self) -> Result<usize, ProgramError>

pub fn data_is_empty(&self) -> bool

pub fn try_data_is_empty(&self) -> Result<bool, ProgramError>

pub fn try_borrow_lamports(&self) -> Result<Ref<'_, &mut u64>, ProgramError>

pub fn try_borrow_mut_lamports( &self ) -> Result<RefMut<'_, &'a mut u64>, ProgramError>

pub fn try_borrow_data(&self) -> Result<Ref<'_, &mut [u8]>, ProgramError>

pub fn try_borrow_mut_data( &self ) -> Result<RefMut<'_, &'a mut [u8]>, ProgramError>

pub fn realloc( &self, new_len: usize, zero_init: bool ) -> Result<(), ProgramError>

Realloc the account’s data and optionally zero-initialize the new memory.

Note: Account data can be increased within a single call by up to solana_program::entrypoint::MAX_PERMITTED_DATA_INCREASE bytes.

Note: Memory used to grow is already zero-initialized upon program entrypoint and re-zeroing it wastes compute units. If within the same call a program reallocs from larger to smaller and back to larger again the new space could contain stale data. Pass true for zero_init in this case, otherwise compute units will be wasted re-zero-initializing.

§Safety

This method makes assumptions about the layout and location of memory referenced by AccountInfo fields. It should only be called for instances of AccountInfo that were created by the runtime and received in the process_instruction entrypoint of a program.

pub fn assign(&self, new_owner: &Pubkey)

pub fn new( key: &'a Pubkey, is_signer: bool, is_writable: bool, lamports: &'a mut u64, data: &'a mut [u8], owner: &'a Pubkey, executable: bool, rent_epoch: u64 ) -> AccountInfo<'a>

pub fn deserialize_data<T>(&self) -> Result<T, Box<ErrorKind>>

pub fn serialize_data<T>(&self, state: &T) -> Result<(), Box<ErrorKind>>
where T: Serialize,

Trait Implementations§

§

impl<'info, B> Accounts<'info, B> for AccountInfo<'info>

§

fn try_accounts( _program_id: &Pubkey, accounts: &mut &[AccountInfo<'info>], _ix_data: &[u8], _bumps: &mut B, _reallocs: &mut BTreeSet<Pubkey> ) -> Result<AccountInfo<'info>, Error>

Returns the validated accounts struct. What constitutes “valid” is program dependent. However, users of these types should never have to worry about account substitution attacks. For example, if a program expects a Mint account from the SPL token program in a particular field, then it should be impossible for this method to return Ok if any other account type is given–from the SPL token program or elsewhere. Read more
§

impl<'info> AccountsExit<'info> for AccountInfo<'info>

§

fn exit(&self, _program_id: &Pubkey) -> Result<(), Error>

program_id is the currently executing program.
§

impl<'a> AsRef<AccountInfo<'a>> for AccountInfo<'a>

§

fn as_ref(&self) -> &AccountInfo<'a>

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

impl<'info, T> AsRef<AccountInfo<'info>> for Account<'info, T>

§

fn as_ref(&self) -> &AccountInfo<'info>

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

impl<'info, T> AsRef<AccountInfo<'info>> for AccountLoader<'info, T>
where T: ZeroCopy + Owner,

§

fn as_ref(&self) -> &AccountInfo<'info>

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

impl<'info, T> AsRef<AccountInfo<'info>> for Interface<'info, T>

§

fn as_ref(&self) -> &AccountInfo<'info>

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

impl<'info, T> AsRef<AccountInfo<'info>> for InterfaceAccount<'info, T>

§

fn as_ref(&self) -> &AccountInfo<'info>

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

impl<'info, T> AsRef<AccountInfo<'info>> for Program<'info, T>

§

fn as_ref(&self) -> &AccountInfo<'info>

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

impl<'info> AsRef<AccountInfo<'info>> for Signer<'info>

§

fn as_ref(&self) -> &AccountInfo<'info>

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

impl<'info> AsRef<AccountInfo<'info>> for SystemAccount<'info>

§

fn as_ref(&self) -> &AccountInfo<'info>

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

impl<'info, T> AsRef<AccountInfo<'info>> for Sysvar<'info, T>
where T: Sysvar,

§

fn as_ref(&self) -> &AccountInfo<'info>

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

impl<'info> AsRef<AccountInfo<'info>> for UncheckedAccount<'info>

§

fn as_ref(&self) -> &AccountInfo<'info>

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

impl<'a> Clone for AccountInfo<'a>

§

fn clone(&self) -> AccountInfo<'a>

Returns a copy of the value. Read more
1.0.0 · source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
§

impl<'a> Debug for AccountInfo<'a>

§

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

Formats the value using the given formatter. Read more
§

impl<'a, T> From<T> for AccountInfo<'a>
where T: IntoAccountInfo<'a>,

§

fn from(src: T) -> AccountInfo<'a>

Converts to this type from the input type.
§

impl<'info> Key for AccountInfo<'info>

§

fn key(&self) -> Pubkey

§

impl<'info> ToAccountInfos<'info> for AccountInfo<'info>

§

fn to_account_infos(&self) -> Vec<AccountInfo<'info>>

§

impl<'info> ToAccountMetas for AccountInfo<'info>

§

fn to_account_metas(&self, is_signer: Option<bool>) -> Vec<AccountMeta>

is_signer is given as an optional override for the signer meta field. This covers the edge case when a program-derived-address needs to relay a transaction from a client to another program but sign the transaction before the relay. The client cannot mark the field as a signer, and so we have to override the is_signer meta field given by the client.
§

impl<'a, T> TryFrom<&'a AccountInfo<'a>> for Interface<'a, T>
where T: CheckId,

§

fn try_from(info: &'a AccountInfo<'a>) -> Result<Interface<'a, T>, Error>

Deserializes the given info into a Program.

§

type Error = Error

The type returned in the event of a conversion error.
§

impl<'a, T> TryFrom<&'a AccountInfo<'a>> for Program<'a, T>
where T: Id,

§

fn try_from(info: &'a AccountInfo<'a>) -> Result<Program<'a, T>, Error>

Deserializes the given info into a Program.

§

type Error = Error

The type returned in the event of a conversion error.

Auto Trait Implementations§

§

impl<'a> Freeze for AccountInfo<'a>

§

impl<'a> !RefUnwindSafe for AccountInfo<'a>

§

impl<'a> !Send for AccountInfo<'a>

§

impl<'a> !Sync for AccountInfo<'a>

§

impl<'a> Unpin for AccountInfo<'a>

§

impl<'a> !UnwindSafe for AccountInfo<'a>

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> IntoEither for T

source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<'info, T> Lamports<'info> for T
where T: AsRef<AccountInfo<'info>>,

§

fn get_lamports(&self) -> u64

Get the lamports of the account.
§

fn add_lamports(&self, amount: u64) -> Result<&Self, Error>

Add lamports to the account. Read more
§

fn sub_lamports(&self, amount: u64) -> Result<&Self, Error>

Subtract lamports from the account. Read more
source§

impl<T> Same for T

§

type Output = T

Should always be Self
§

impl<'info, T> ToAccountInfo<'info> for T
where T: AsRef<AccountInfo<'info>>,

§

fn to_account_info(&self) -> AccountInfo<'info>

source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

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

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V