Mainstay

Solana Sealevel 框架

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

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

如果您熟悉在 Ethereum 的 Solidity、Truffle、web3.js 中开发，那么您会有熟悉的感觉。尽管 DSL 语法和语义针对 Solana，但编写 RPC 请求处理器、发出 IDL 和从 IDL 生成客户端的高级流程是相同的。

入门

有关快速入门指南和深入教程，请参阅 mainstay 书籍 和正在逐步淘汰的旧版 文档。要直接跳到示例，请访问 此处。有关最新的 Rust 和 TypeScript API 文档，请参阅 docs.rs 和 typedoc。

包

包	描述	版本	文档
mainstay-lang	Solana 上编写程序的 Rust 原语
mainstay-spl	Solana 上 SPL 程序的 CPI 客户端
mainstay-client	Mainstay 程序的 Rust 客户端
@nx-pkg/mainstay	Mainstay 程序的 TypeScript 客户端
@nx-pkg/mainstay-cli	用于构建和管理 Mainstay 工作区的 CLI

注意

• Mainstay 正在积极开发，因此所有 API 都可能更改。
• 此代码未经审计。自行承担风险。

示例

这是一个计数器程序，其中只有指定的 authority 可以增加计数。

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许可证。

除非您明确表示，否则您有意提交以包含在Mainstay中的任何贡献，如Apache-2.0许可证中定义的，将按上述方式许可，不附加任何额外条款或条件。

贡献

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

谢谢 ❤️