#idl #语法 #mainstay #解析器 #生成 #程序 #权限

mainstay-syn

Mainstay 语法解析和代码生成工具

1 个不稳定版本

0.30.0 2024 年 6 月 12 日

#2833神奇豆子


3 crates 中使用

Apache-2.0

365KB
8K SLoC

Mainstay

Solana Sealevel 框架

Build Status Tutorials Discord Chat License

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

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

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

入门

有关快速入门指南和深入教程,请参阅 mainstay 书籍 和正在逐步淘汰的较老 文档。要直接查看示例,请访问 此处。有关最新的 Rust 和 TypeScript API 文档,请参阅 docs.rstypedoc

描述 版本 文档
mainstay-lang Solana 上编写程序的 Rust 基础库 Crates.io Docs.rs
mainstay-spl Solana 上 SPL 程序的 CPI 客户端 crates Docs.rs
mainstay-client Mainstay 程序的 Rust 客户端 crates Docs.rs
@nx-pkg/mainstay Mainstay 程序的类型脚本客户端 npm Docs
@nx-pkg/mainstay-cli CLI 用于构建和管理 Mainstay 工作空间 npm Docs

注意

  • Mainstay 正处于积极开发中,因此所有 API 都可能发生变化。
  • 此代码未经审核。使用风险自负。

示例

以下是一个计数器程序,只有指定的 权限 可以增加计数。

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

更多示例和测试,请参阅 示例测试 目录。

许可证

Mainstay 根据 Apache 2.0 许可证授权。

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

贡献

感谢您对 Mainstay 贡献的兴趣!请参阅 CONTRIBUTING.md 了解如何操作。

谢谢 ❤️

依赖项

~2.7–3.5MB
~76K SLoC