使用C语言开发

Solana支持使用C和C++编写链上程序。

项目结构

C项目布局如下：

/src/<程序名>
/makefile

makefile应包含以下内容：

OUT_DIR := <放置生成的共享对象的路径>
include ~/.local/share/solana/install/active_release/bin/sdk/sbf/c/sbf.mk

sbf-sdk可能不在上述的位置，但如果你按照构建方法设置环境，那么它应该会在正确的位置。

构建方法

首先设置环境：

• 从 https://rustup.rs 安装最新的Rust稳定版
• 安装最新的Solana命令行工具

然后使用make进行构建：

make -C <程序目录>

测试方法

Solana使用Criterion测试框架，每次构建程序时都会执行测试 构建方法。

要添加测试，在源文件旁边创建一个名为 test_<程序名>.c 的新文件，并填充 Criterion 测试用例。有关如何编写测试用例的信息，请参阅Criterion文档。

程序入口点

程序导出一个已知的入口点方法，Solana 运行时在调用程序时查找并调用该方法。Solana 支持多个版本的 SBF 加载器，入口点可能因加载器而异。程序必须针对相同的加载器编写并部署。有关更多详细信息，请参阅 FAQ中关于加载器的部分。

目前有两个支持的加载器：SBF Loader和SBF Loader deprecated。

它们都具有相同的原始入口点定义，以下是运行时查找和调用的原始方法：

extern uint64_t entrypoint(const uint8_t *input)

此入口点接受一个包含序列化程序参数（程序 ID、账户、指令数据等）的通用字节数组。要反序列化参数，每个加载器都包含自己的辅助函数。

序列化

每个加载器提供一个辅助函数，将程序的输入参数反序列化为C类型：

• SBF Loader反序列化
• SBF Loader deprecated反序列化

一些程序可能希望自己进行反序列化，它们可以通过提供自己的原始入口点实现。这些提供的反序列化函数会保留对序列化字节数组的引用，以便程序允许修改的变量（例如 lamports、账户数据）。如果程序实现自己的反序列化函数，它们需要确保程序希望提交的任何修改都必须写回输入字节数组。

有关加载器如何序列化程序输入的详细信息，请参见输入参数序列化文档。

数据类型

加载器的反序列化辅助函数会填充SolParameters结构：

/**
 * 结构体：程序的入口点输入数据被反序列化到该结构体中。
 */
typedef struct {
  SolAccountInfo* ka; /** 指向 SolAccountInfo 数组的指针，必须已经指向一个 SolAccountInfo 数组 */
  uint64_t ka_num; /** `ka` 中 SolAccountInfo 条目的数量 */
  const uint8_t *data; /** 指向指令数据的指针 */
  uint64_t data_len; /** 指令数据的字节长度 */
  const SolPubkey *program_id; /** 当前执行程序的 program_id */
} SolParameters;

'ka'是指令引用的账户的有序数组，表示为SolAccountInfo结构。数组中账户的位置表示其含义，例如，当转移 lamports 时，指令可以将第一个账户定义为源账户，将第二个账户定义为目标账户。

SolAccountInfo 结构的成员是只读的，除了 lamports 和 data。根据“运行时强制策略”，程序可以修改这两者。当指令多次引用相同账户时，数组中可能会有重复的 SolAccountInfo 条目，但它们都指向原始输入字节数组。程序应谨慎处理这些情况，以避免对同一缓冲区进行重叠的读/写操作。如果程序实现自己的反序列化函数，则应适当处理重复账户。

data是来自正在处理指令的指令数据的通用字节数组。

program_id是当前执行程序的公钥。

堆

C程序可以通过系统调用calloc分配内存，或在从虚拟地址x300000000开始的32KB堆区域上实现自己的堆。堆区域也被calloc使用，因此如果程序实现了自己的堆，则不调用calloc。

日志

运行时提供了两个系统调用，它们可以接受数据并将其记录到程序日志中。

• sol_log(const char*)
• sol_log_64(uint64_t, uint64_t, uint64_t, uint64_t, uint64_t)

调试debug部分有更多关于使用程序日志的信息。

计算预算

使用系统调用sol_remaining_compute_units()返回一个u64，表示此交易剩余的计算单元数。

使用系统调用sol_log_compute_units()记录包含程序在执行停止之前可以消耗的剩余计算单位数的消息。

有关更多信息，请参见计算预算文档。

ELF转储

可以将 SBF 共享对象的内部内容转储到文本文件中，以便更深入地了解程序的组成及其在运行时可能执行的操作。转储将包含 ELF 信息以及所有符号的列表和实现它们的指令。一些 SBF 加载器的错误日志消息将引用发生错误的特定指令号。这些引用可以在 ELF 转储中查找，以识别出错的指令及其上下文。

要创建转储文件：

cd <程序目录>
make dump_<程序名>

示例

Solana程序库的github仓库包含一系列C语言示例。