🚨 GitBross is launching the **Open Source Backup Campaign** for #Solana and beyond 🚨

acheron 7b6c2b355e cli: Remove `solana-program` dependency (#3466) 9 ay önce
.github c237d17c44 ci: Run the release workflow when the release workflow file changes (#3456) 9 ay önce
avm 8eec2e3b0d avm: Use `#[cfg(unix)]` when running UNIX-only functionality (#3464) 9 ay önce
bench 6147beb473 spl: Upgrade SPL deps to latest (#3346) 11 ay önce
cli 7b6c2b355e cli: Remove `solana-program` dependency (#3466) 9 ay önce
client 28285149b0 client: Make `solana_account_decoder` dep public (#3455) 9 ay önce
docker 6d6b24a8f2 docker: Upgrade Solana toolchain to 2.1.0 (#3378) 10 ay önce
docs 5767365d11 docs: Fix broken link to `AccountInfo` in Intro to Solana (#3430) 10 ay önce
examples aa48efb437 ts: Update `engines.node` to `>= 17` (#3301) 1 yıl önce
idl 8bc883ad85 Fix some typos in doc comments (#3413) 10 ay önce
lang ceefae7f0a lang: Remove a potential panic while getting the IDL in `declare_program!` (#3458) 9 ay önce
spl e4f5d43a06 spl: Update `mpl-token-metadata` version requirement to `5` (#3356) 11 ay önce
tests 2ae3774639 lang: Deduplicate `zero` accounts against `init` accounts (#3422) 10 ay önce
ts 72c7e09538 ts: Fix loading programs with numbers in their names using `workspace` (#3450) 9 ay önce
.gitignore f677742a97 client: Add `tokio` support to `RequestBuilder` with `async` feature (#3057) 1 yıl önce
.gitmodules 020a304658 Upgrade Solana to v2 and SPL to the latest (#3219) 1 yıl önce
CHANGELOG.md ceefae7f0a lang: Remove a potential panic while getting the IDL in `declare_program!` (#3458) 9 ay önce
CODE_OF_CONDUCT.md 08110e63fa Fix broken link to Rust's code of conduct (#2810) 1 yıl önce
CONTRIBUTING.md 5623c7c8ed update discord links (#2424) 2 yıl önce
Cargo.lock 7b6c2b355e cli: Remove `solana-program` dependency (#3466) 9 ay önce
Cargo.toml 0109f4a3cf spl: Remove `spl-token-confidential-transfer-proof-generation` patch (#3348) 11 ay önce
LICENSE e1afcbf71e v0.28.0 (#2527) 2 yıl önce
Makefile 10c997552e Add `anchor-derive-serde` crate to the publish script (#2924) 1 yıl önce
README.md b72abe0c61 Add a link to the project site in README (#3319) 11 ay önce
VERSION e6d7dafe12 v0.30.1 (#3040) 1 yıl önce
setup-tests.sh ebbad72fc4 Upgrade Solana to 2.1.0 (#3339) 11 ay önce
version-bump.sh aa26a516b3 Fix false positives when using `version-bump.sh` script (#3068) 1 yıl önce

README.md

Anchor

Solana Sealevel Framework

Build Status Tutorials Discord Chat License

Anchor is a framework for Solana's Sealevel runtime providing several convenient developer tools for writing smart contracts.

  • Rust eDSL 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, 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 anchor book and the older documentation that is being phased out. To jump straight to examples, go here. For the latest Rust and TypeScript API documentation, see docs.rs and the typedoc.

Packages

Package Description Version Docs
anchor-lang Rust primitives for writing programs on Solana Crates.io Docs.rs
anchor-spl CPI clients for SPL programs on Solana crates Docs.rs
anchor-client Rust client for Anchor programs crates Docs.rs
@coral-xyz/anchor TypeScript client for Anchor programs npm Docs
@coral-xyz/anchor-cli CLI to support building and managing an Anchor workspace npm Docs

Note

  • Anchor is in active development, so all APIs are subject to change.
  • This code is unaudited. Use at your own risk.

Examples

Here's a counter program, where only the designated authority can increment the count.

use anchor_lang::prelude::*;

declare_id!("Fg6PaFpoGXkYsidMpWTK6W2BeZ7FEfcYkg476zPFsLnS");

#[program]
mod counter {
    use super::*;

    pub fn initialize(ctx: Context<Initialize>, start: u64) -> Result<()> {
        let counter = &mut ctx.accounts.counter;
        counter.authority = *ctx.accounts.authority.key;
        counter.count = start;
        Ok(())
    }

    pub fn increment(ctx: Context<Increment>) -> Result<()> {
        let counter = &mut ctx.accounts.counter;
        counter.count += 1;
        Ok(())
    }
}

#[derive(Accounts)]
pub struct Initialize<'info> {
    #[account(init, payer = authority, space = 48)]
    pub counter: Account<'info, Counter>,
    pub authority: Signer<'info>,
    pub system_program: Program<'info, System>,
}

#[derive(Accounts)]
pub struct Increment<'info> {
    #[account(mut, has_one = authority)]
    pub counter: Account<'info, Counter>,
    pub authority: Signer<'info>,
}

#[account]
pub struct Counter {
    pub authority: Pubkey,
    pub count: u64,
}

For more, see the examples and tests directories.

License

Anchor is licensed under Apache 2.0.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in Anchor by you, as defined in the Apache-2.0 license, shall be licensed as above, without any additional terms or conditions.

Contribution

Thank you for your interest in contributing to Anchor! Please see the CONTRIBUTING.md to learn how.

Thanks ❤️