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

amilz 45c84c524f cli: Add `deactivate_feature` flag to `solana-test-validator` config in Anchor.toml (#2872) 1 年之前
.github 800d6557b9 ci: Add `declare-program` tests (#2873) 1 年之前
avm b83d5fd64b Upgrade `cargo_toml` to 0.19.2 (#2859) 1 年之前
bench c66b323293 Upgrade Solana to 1.18.8 (#2867) 1 年之前
cli 45c84c524f cli: Add `deactivate_feature` flag to `solana-test-validator` config in Anchor.toml (#2872) 1 年之前
client c66b323293 Upgrade Solana to 1.18.8 (#2867) 1 年之前
docker c66b323293 Upgrade Solana to 1.18.8 (#2867) 1 年之前
docs 62dccce2ed Fix typos (#2860) 1 年之前
examples 62dccce2ed Fix typos (#2860) 1 年之前
idl d9a9f19394 Fix IDL (#2824) 1 年之前
lang c66b323293 Upgrade Solana to 1.18.8 (#2867) 1 年之前
spl c66b323293 Upgrade Solana to 1.18.8 (#2867) 1 年之前
tests c66b323293 Upgrade Solana to 1.18.8 (#2867) 1 年之前
ts c2cd5a99aa Fix typos in comments (#2868) 1 年之前
.gitignore b4459f2a0c Relax the mpl metadata package constraint (#2366) 2 年之前
.gitmodules 267c4ceab7 tests: Remove `auction-house` submodule and host it natively (#2654) 2 年之前
CHANGELOG.md 45c84c524f cli: Add `deactivate_feature` flag to `solana-test-validator` config in Anchor.toml (#2872) 1 年之前
CODE_OF_CONDUCT.md 08110e63fa Fix broken link to Rust's code of conduct (#2810) 1 年之前
CONTRIBUTING.md 5623c7c8ed update discord links (#2424) 2 年之前
Cargo.lock c66b323293 Upgrade Solana to 1.18.8 (#2867) 1 年之前
Cargo.toml d9a9f19394 Fix IDL (#2824) 1 年之前
LICENSE e1afcbf71e v0.28.0 (#2527) 2 年之前
Makefile 3b45144787 v0.27.0 (#2428) 2 年之前
README.md b6e94dacf0 Make `anchor-spl` and `anchor-client` badges links to creates.io (#2684) 2 年之前
VERSION fc9fd6d24b v0.29.0 (#2672) 2 年之前
setup-tests.sh c66b323293 Upgrade Solana to 1.18.8 (#2867) 1 年之前
version-bump.sh b5519a6532 bench: Add lock files and store Solana version (#2537) 2 年之前

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 ❤️