17 个版本 (11 个重大更新)

0.30.1 2024 年 6 月 20 日
0.29.0 2023 年 10 月 16 日
0.28.0 2023 年 6 月 9 日
0.27.0 2023 年 3 月 8 日
0.19.0 2021 年 12 月 8 日

#idl 中排名 85

Download history 12342/week @ 2024-05-05 13400/week @ 2024-05-12 15692/week @ 2024-05-19 14938/week @ 2024-05-26 14986/week @ 2024-06-02 12648/week @ 2024-06-09 14240/week @ 2024-06-16 13108/week @ 2024-06-23 8753/week @ 2024-06-30 8745/week @ 2024-07-07 11476/week @ 2024-07-14 11460/week @ 2024-07-21 11450/week @ 2024-07-28 11489/week @ 2024-08-04 13751/week @ 2024-08-11 10905/week @ 2024-08-18

每月下载量 48,792
521 仓库中使用(直接使用 6 个)

Apache-2.0

365KB
8K SLoC

Anchor

Solana Sealevel 框架

Build Status Tutorials Discord Chat License

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

  • Rust eDSL 用于编写 Solana 程序
  • IDL 规范
  • IDL 生成客户端的 TypeScript 包
  • CLI 和工作区管理以开发完整应用程序

如果你熟悉 Ethereum 的 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/锚点 用于锚点程序的 TypeScript 客户端 npm Docs
@coral-xyz/锚点-命令行界面 命令行界面支持构建和管理 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 许可协议。

除非您明确指出,否则您根据 Apache-2.0 许可协议有意提交给 Anchor 的任何贡献,都应按照上述方式授权,而不附加任何额外条款或条件。

贡献

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

谢谢 ❤️

依赖项

~2.7–3.5MB
~76K SLoC