索拉纳程序库

索拉纳程序库 (SPL) 是一系列针对 Sealevel 并行运行时 的链上程序集合。这些程序针对 Solana 的 Sealevel 实现、solana-runtime 进行了测试，其中一些已部署到主网 Beta。随着其他人对 Sealevel 的实现，我们将欢迎修复以确保这些程序可在所有实现中移植。

更多信息请参阅 SPL 文档 和 Token 类型文档。

部署

仅将 Solana 程序库仓库中的部分程序部署到索拉纳主网 Beta。目前，包括以下程序

此外，还计划部署一个程序到索拉纳主网 Beta

审计

仅在 Solana 程序库仓库中的部分程序经过审计。目前包括

所有其他程序可能会不时更新。这些程序未经过审计，因此请在自己的风险下分叉和部署它们。以下是未审计程序的全列表

• binary-option
• binary-oracle-pair
• 功能提案
• instruction-padding
• managed-token
• 备忘录
• 名称服务
• record
• stateless-asks
• token-lending
• token-swap
• token-upgrade

有关仓库安全策略的更多信息请参阅 SECURITY.md。

安全审计仓库 security-audits repo 包含所有过去和现在的程序审计。

程序包

包	描述	版本	文档
spl-token	在 Solana 上类似 ERC20 的令牌程序
spl-token-2022	与 spl-token 兼容的令牌程序，具有扩展功能
spl-associated-token-account	定义钱包中规范“关联”令牌账户的无状态协议
spl-governance	使用代币进行投票的 DAO 程序
spl-account-compression	管理存储在链外 Merkle 树中的压缩账户的程序
spl-feature-proposal	使用代币投票启用 Solana 网络功能的程序
spl-noop	什么也不做的程序，用于记录指令数据
spl-memo	记录链上已签署备忘录的程序
spl-name-service	管理链上数据所有权的程序
spl-shared-memory	在程序之间共享数据的程序
spl-stake-pool	由其他实体管理的质押账户池程序
spl-instruction-padding	填充到其他指令的程序
spl-concurrent-merkle-tree	用于链上表示 Merkle 树的库
spl-math	链上数学库
spl-token-lending	代币的过度抵押借贷程序
spl-token-swap	用于交易代币的 AMM
spl-token-upgrade	一种用一种代币类型兑换另一种代币的协议

CLI 包

包	描述	版本
spl-token-cli	token、token-2022 和 associated-token-account 程序的 CLI
spl-stake-pool-cli	stake-pool 程序的 CLI
spl-feature-proposal-cli	feature-proposal 程序的 CLI
spl-token-lending-cli	token-lending 程序的 CLI
spl-token-upgrade-cli	token-upgrade 程序的 CLI

JavaScript 包

包	描述	版本	文档
@solana/spl-token	token、token-2022 和 associated-token-account 程序的绑定
@solana/spl-治理	治理程序的绑定		N/A
@solana/spl-account-compression	account-compression 程序的绑定
@solana/spl-备忘录	memo 程序的绑定		N/A
@solana/spl-name-service	name-service 程序的绑定		N/A
@solana/spl-stake-pool	stake-pool 程序的绑定		N/A
@solana/spl-token-lending	token-lending 程序的绑定		N/A
@solana/spl-token-swap	token-swap 程序的绑定		N/A

开发

环境设置

1. 安装最新的 Solana 工具。
2. 安装最新的 Rust 稳定版。如果您已经安装了 Rust，请运行 rustup update 以获取最新版本。
3. 为您的发行版安装 libudev 开发包（Debian 衍生发行版上的 libudev-dev，Redhat 衍生发行版上的 libudev-devel）。

构建

构建链上程序

# To build all on-chain programs
$ cargo build-sbf

# To build a specific on-chain program
$ cd <program_name>/program
$ cargo build-sbf

构建客户端

# To build all clients
$ cargo build

# To build a specific client
$ cd <program_name>/cli
$ cargo build

测试

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

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

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

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

集成测试可以通过每个项目的.js 绑定来执行。请参考令牌程序的 js 项目以获取示例。

常见问题

以下列出了您可能遇到的一些问题的解决方案。

1. 打开失败: ../../部署/spl_<程序-name>.so

   请将您的 Rust 和 Cargo 升级到最新版本，并在相关的<program-name>目录中重新运行 cargo build-sbf，或者在仓库根目录运行以重建所有链上程序。

2. 加载共享库时出错。（libssl.so.1.1）

   一个可行的解决方案在这里提到了。安装 libssl。

   wget http://nz2.archive.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.1l-1ubuntu1.2_amd64.deb
   sudo dpkg -i libssl1.1_1.1.1l-1ubuntu1.2_amd64.deb
   

3. CPU 或内存使用率100%

   在构建本库中的一些程序时可能会遇到这种情况。最简单的解决方案是在构建命令中添加 --jobs 1 标志，将并行作业的数量限制为 1，并检查是否解决了问题。虽然这会导致构建时间大大延长。

Clippy

$ cargo clippy

覆盖率

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

MacOS

您可能需要锁定您的 grcov 版本，然后使用 apple-darwin nightly 工具链的 rustup

$ cargo install grcov --version 0.6.1
$ rustup toolchain install nightly-x86_64-apple-darwin

发布流程

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

增加版本

• 在程序的 Cargo.toml 中增加版本号
• 运行 cargo build-sbf <program> 以构建二进制文件。请注意生成的 spl_<program>.so 的位置，以便将其附加到 GitHub 发布。
• 提交包含这些版本更改的 PR 并通过 CI 后合并

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