Solana 程序库

Solana 程序库（SPL）是一系列针对 Sealevel 并行运行时 的链上程序。这些程序针对 Solana 的 Sealevel 实现、solana-runtime 进行了测试，并部署到了其主网上。随着其他人对 Sealevel 进行实现，我们将慷慨接受补丁，以确保这里的程序可以在所有实现中通用。

完整文档可在 https://spl.solana.com 找到

开发

环境设置

1. 从 https://rustup.rs/ 安装最新的 Rust 稳定版
2. 从 https://docs.solana.com/cli/install-solana-cli-tools 安装 Solana v1.6.1 或更高版本
3. 为您的发行版安装 libudev 开发包（Debian 衍生发行版为 libudev-dev，Redhat 衍生为 libudev-devel）

构建

对于针对主机机器构建程序，可以使用常规的 cargo build

$ cargo build

要为 Solana BPF 目标构建特定程序，例如 SPL Token

$ cd token/program
$ cargo build-bpf

测试

所有项目中包含的单元测试可以使用以下命令运行

$ cargo test      # <-- runs host-based tests
$ cargo test-bpf  # <-- runs BPF program tests

要运行特定程序的测试，例如 SPL Token

$ cd token/program
$ cargo test      # <-- runs host-based tests
$ cargo test-bpf  # <-- runs BPF program tests

可以通过每个项目的 .js 绑定进行集成测试。请参阅 token 程序的 js 项目 以获取示例。

Clippy

$ cargo clippy

覆盖率

$ ./coverage.sh  # Please help! Coverage build currently fails on MacOS due to an XCode `grcov` mismatch...

发布流程

当前 SPL 程序是通过手动标记和发布的。每个程序都是独立于其他程序的版本，所有新开发都在 master 上进行。一旦程序经过测试并被认为是准备发布的

增加版本号

• 在程序 Cargo.toml 中增加版本号
• 生成新的程序 ID 并在 <program>/program-id.md 和 <program>/src/lib.rs 中替换
• 运行 cargo build-bpf <program> 来更新相关的 C 绑定。（注意生成的 spl_<program>.so 的位置，以便将其附加到 Github 发布版本。）
• 打开一个带有这些版本变更的 PR，并在通过 CI 后合并。

创建 Github 标签

程序标签的形式为 <program>-vX.Y.Z。在版本提升提交处创建新标签并将其推送到 solana-program-library 仓库，例如

$ git tag token-v1.0.0 b24bfe7
$ git push upstream --tags

发布 Github 发布版本

• 转到 GitHub 发布版本 UI
• 点击 "创建新发布"，并在 "标签版本" 框中输入新标签。
• 将发布标题命名为 "SPL vX.Y.Z"，完成描述，并附加 spl_<program>.so 二进制文件
• 点击 "发布发布版本"

发布到 Crates.io

导航到程序目录，并运行 cargo package 来测试构建。然后运行 cargo publish。

免责声明

本项目所述的所有声明、内容、设计、算法、估计、路线图、规范和性能测量都是 Solana 基金会 ("SF") 尽最大努力完成的。读者需要自行检查和验证其准确性和真实性。此外，本项目中的任何内容都不构成投资邀请。

由 SF 或 SF 提供的开发者资源产生的任何内容，仅用于教育和启发目的。SF 不鼓励、诱导或批准任何此类应用（包括构成 Solana 区块链协议的代码）的部署、集成或使用，如果违反了适用的法律或法规，则禁止此类部署、集成或使用。这包括读者（a）违反美国或任何其他适用司法管辖区的出口控制或制裁法律，（b）读者位于或通常居住在美国财政部外国资产控制办公室（OFAC）管理的全面制裁的国家或地区，或（c）读者是或代表特别指定国家（SDN）或受类似阻止或拒绝方禁止的人员。

读者应了解，美国的出口控制法和制裁法禁止美国公民（以及受此类法律约束的其他人员）与某些国家和地区的个人进行交易，或列入 SDN 名单。作为一个主要基于开源软件的项目，这样的受制裁人员可能仍然绕过禁令，获取构成 Solana 区块链协议（或其他项目代码或应用）的代码，并部署、集成或以其他方式使用它。因此，存在风险，即使用 Solana 区块链协议的个人可能是受制裁人员，与这些人员的交易可能违反美国的出口控制和制裁法。这种风险适用于部署、集成或使用 Solana 区块链协议代码的个人、组织和其他生态系统参与者，以及通过轻客户端、第三方接口和/或钱包软件在 Solana 区块链上进行交易的个人。

lib.rs:

记录程序