Expand description

The prelude contains all commonly used components of the crate. All programs should include it via anchor_lang::prelude::*;.

Re-exports

pub use super::require;
pub use super::state;
pub use super::AccountDeserialize;
pub use super::AccountSerialize;
pub use super::Accounts;
pub use super::AccountsExit;
pub use super::AccountsInit;
pub use super::ProgramState;
pub use super::ToAccountInfo;
pub use super::ToAccountInfos;
pub use super::ToAccountMetas;
pub use borsh;
pub use thiserror;

Macros

Creates an event that can be subscribed to by clients. Calling this method will internally borsh serialize the event, base64 encode the bytes, and then add a msg! log to the transaction.

Print a message to the log

Structs

Account information

Account metadata used to define Instructions

Clock represents network time. Members of Clock start from 0 upon network boot. The best way to map Clock to wallclock time is to use current Slot, as Epochs vary in duration (they start short and grow as the network progresses).

Provides non-argument inputs to the program.

Container for any account not owned by the current program.

Context specifying non-argument inputs for cross-program-invocations.

Boxed container for the program state singleton, used when the state is for a program not currently executing.

Context specifying non-argument inputs for cross-program-invocations targeted at program state instructions.

Account loader facilitating on demand zero copy deserialization. Note that using accounts in this way is distinctly different from using, for example, the ProgramAccount. Namely, one must call load, load_mut, or load_init, before reading or writing to the account. For more details on zero-copy-deserialization, see the account attribute.

Boxed container for a deserialized account. Use this to reference any account owned by the currently executing program.

Contains recent block hashes and fee calculators.

Container for sysvars.

Enums

Reasons the program may fail

Traits

A data-structure that can be de-serialized from binary format by NBOR.

A data-structure that can be serialized into binary format by NBOR.

Functions

Return the next AccountInfo or a NotEnoughAccountKeys error.

Type Definitions

Attribute Macros

Executes the given access control method before running the decorated instruction handler. Any method in scope of the attribute can be invoked with any arguments from the associated instruction handler.

A data structure representing a Solana account, implementing various traits:

Extends the #[account] attribute to allow one to create associated accounts. This includes a Default implementation, which means all fields in an #[associated] struct must implement Default and an anchor_lang::Bump trait implementation, which allows the account to be used as a program derived address.

Generates Error and type Result<T> = Result<T, Error> types to be used as return types from Anchor instruction handlers. Importantly, the attribute implements From on the ErrorCode to support converting from the user defined error enum into the generated Error.

The event attribute allows a struct to be used with emit! so that programs can log significant events in their programs that clients can subscribe to. Currently, this macro is for structs only.

The #[interface] attribute allows one to define an external program dependency, without having any knowledge about the program, other than the fact that it implements the given trait.

The #[program] attribute defines the module containing all instruction handlers defining all entries into a Solana program.

The #[state] attribute defines the program’s state struct, i.e., the program’s global account singleton giving the program the illusion of state.

A data structure that can be used as an internal field for a zero copy deserialized account, i.e., a struct marked with #[account(zero_copy)].

Derive Macros

Implements an Accounts deserializer on the given struct, applying any constraints specified via inert #[account(..)] attributes upon deserialization.