1个不稳定版本

0.29.1 2024年4月2日

#9 in #sealevel

Apache-2.0

330KB
8K SLoC

Anchor

Solana Sealevel框架

Build Status Tutorials Discord Chat License

Anchor是一个框架,用于Solana的Sealevel运行时,为编写智能合约提供了一些方便的开发工具。

  • Rust eDSL用于编写Solana程序
  • IDL规范
  • IDL生成客户端的类型Script包
  • CLI和工作空间管理,用于开发完整的应用程序

如果您熟悉在以太坊的SolidityTruffleweb3.js中开发,那么体验将非常熟悉。尽管DSL语法和语义针对Solana,但编写RPC请求处理器、发出IDL和从IDL生成客户端的高级流程是相同的。

入门

有关快速入门指南和深入教程,请参阅Anchor书籍以及正在逐步淘汰的较旧文档。要直接跳到示例,请点击此处。有关最新的Rust和TypeScript API文档,请参阅docs.rstypedoc

描述 版本 文档
anchor-lang Solana上编写程序的Rust原语 Crates.io Docs.rs
anchor-spl Solana上SPL程序的CPI客户端 crates Docs.rs
anchor-client Anchor程序的Rust客户端 crates Docs.rs
@coral-xyz/anchor Anchor程序的TypeScript客户端 npm Docs
@coral-xyz/anchor-cli CLI支持构建和管理Anchor工作空间 npm Docs

注意

  • Anchor正在积极开发中,因此所有API都可能发生变化。
  • 此代码未经审计。使用风险自担。

示例

这是一个计数程序,只有指定的 权限 才能增加计数。

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,
}

有关更多信息,请参阅 示例测试 目录。

许可证

Anchor 采用 Apache 2.0 许可。

除非您明确表示,否则您提交给 Anchor 的任何有意贡献,根据 Apache-2.0 许可定义,应按上述方式许可,不附加任何额外条款或条件。

贡献

感谢您对为 Anchor 贡献的兴趣!请参阅 CONTRIBUTING.md 了解详情。

谢谢 ❤️

依赖项

~1.8–2.9MB
~57K SLoC