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

skrrb 58af625736 Handle arrays with const as size in endpoint function args (#1631) 3 жил өмнө
.github 94b0fec714 fix anchor-lang import in safety-check, add custom-coder to ci, and fix spl-token coder (#1604) 3 жил өмнө
avm e567e14154 remove avm use prompt, and insist on user installing a version if it's not yet installed (#1565) 3 жил өмнө
cli d42d147e6a cli: Fix npm install command in fallback (#1643) 3 жил өмнө
client 3b0006b3ce use sol_log_data for logging events (#1608) 3 жил өмнө
docker f0a664c837 update versions (#1607) 3 жил өмнө
docs b733610d87 v0.22.1 (#1528) 3 жил өмнө
examples 97a8dfe71d Bump up rust to 2021 edition (#1430) 3 жил өмнө
lang 58af625736 Handle arrays with const as size in endpoint function args (#1631) 3 жил өмнө
spl f0a664c837 update versions (#1607) 3 жил өмнө
tests 58af625736 Handle arrays with const as size in endpoint function args (#1631) 3 жил өмнө
ts 1c7139a9e3 ts: Use return value of `wallet.signTransaction` in `provider.ts` (#1527) 3 жил өмнө
.gitignore 0f8de4f6af ts: Create a minified browser build (#1108) 3 жил өмнө
.gitmodules d8d720067d lang, ts: automatic client side pda derivation (#1331) 3 жил өмнө
CHANGELOG.md 58af625736 Handle arrays with const as size in endpoint function args (#1631) 3 жил өмнө
CODE_OF_CONDUCT.md 08a7cff244 Add CONTRIBUTING.md and CODE_OF_CONDUCT.md (#800) 4 жил өмнө
CONTRIBUTING.md b2b1a16b77 contributing: add reminder to sign commits (#1587) 3 жил өмнө
Cargo.lock e567e14154 remove avm use prompt, and insist on user installing a version if it's not yet installed (#1565) 3 жил өмнө
Cargo.toml 75469f423c cli: anchor version manager (avm) (#1385) 3 жил өмнө
LICENSE e91a9e148b Tutorial 2 init 4 жил өмнө
Makefile a604f8595c makefile and changelog misc updates (#1491) 3 жил өмнө
README.md 04b8247736 docs: update readme and changelog (#1510) 3 жил өмнө
VERSION b733610d87 v0.22.1 (#1528) 3 жил өмнө
version-bump.sh 4ba09fb1e5 Version bump script (#1010) 3 жил өмнө

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
@project-serum/anchor TypeScript client for Anchor programs npm Docs
@project-serum/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 ❤️