Anchor ⚓
Anchor is a framework for Solana's Sealevel runtime providing several convenient developer tools.
- Rust DSL for writing Solana programs
- IDL specification
- TypeScript package for generating clients from IDL
- CLI and workspace management for developing complete applications
If you're familiar with developing in Ethereum's Solidity, Truffle, web3.js or Parity's Ink!, then the experience will be familiar. Although the DSL syntax and semantics are targeted at Solana, the high level flow of writing RPC request handlers, emitting an IDL, and generating clients from IDL is the same.
Getting Started
For a quickstart guide and in depth tutorials, see the guided documentation. To jump straight to examples, go here.
Note
- Anchor is in active development, so all APIs are subject to change.
- This code is unaudited. Use at your own risk.
Example
use *;
// Define the program's RPC handlers.
// Define the validated accounts for each handler.
// Define program owned accounts.
// Define auxiliary access control checks.
Accounts attribute syntax.
There are several inert attributes (attributes that are consumed only for the
purposes of the Accounts macro) that can be specified on a struct deriving Accounts
.
Attribute | Where Applicable | Description |
---|---|---|
#[account(signer)] |
On raw AccountInfo structs. |
Checks the given account signed the transaction. |
#[account(mut)] |
On ProgramAccount structs. |
Marks the account as mutable and persists the state transition. |
#[account(init)] |
On ProgramAccount structs. |
Marks the account as being initialized, skipping the account discriminator check. |
#[account(belongs_to = <target>)] |
On ProgramAccount structs |
Checks the target field on the account matches the target field in the struct deriving Accounts . |
#[account(owner = program | skip)] |
On AccountInfo structs |
Checks the owner of the account is the current program or skips the check. |
#[account("<literal>")] |
On ProgramAccount structs |
Executes the given code literal as a constraint. The literal should evaluate to a boolean. |
#[account(rent_exempt = <skip>)] |
On AccountInfo or ProgramAccount structs |
Optional attribute to skip the rent exemption check. By default, all accounts marked with #[account(init)] will be rent exempt. Similarly, omitting = skip will mark the account rent exempt. |
License
Anchor is licensed under Apache 2.0.