Solana(实验性)
Solana(实验性) 是一个 RustRover 插件,用于开发和浏览基于 Anchor 的 Solana 项目。 它从 Anchor.toml 读取项目配置,提供程序和钱包操作,集成本地 Surfpool 网络,并包含用于交易和账户的 Explorer。
安装 Solana(实验性)插件
此功能需要 Solana(实验性) 插件,需安装并启用该插件。
打开 IDE 设置并选择 插件。
搜索 Solana(实验性) ,然后点击 安装。
如果出现提示,请重启 RustRover。
安装后,打开一个包含 Anchor.toml 文件的 Anchor 项目。 插件会自动检测项目及其已配置的程序。
配置插件
配置 Solana 工具链
打开 以查看插件使用的命令行工具。

设置页面将工具分为两个类别:
Solana 工具链 — Solana CLI、Anchor Version Manager(AVM)、Anchor CLI 和 Surfpool。
附加工具 — Node.js 和 Yarn。
对于每个工具,插件都会显示已配置的可执行文件路径及检测到的版本。 使用字段旁边的文件夹按钮选择其他可执行文件。 安装工具或更改路径后,点击 刷新 以重新检测工具和版本。
如果未安装必需工具,插件会显示 安装缺失的工具 链接。 点击此链接安装缺失的依赖项,然后返回设置页面并点击 刷新 ,以验证它们可用。
当缺少必需工具时,也可以从 索拉纳 工具窗口打开插件配置。 在此设置状态下,工具窗口会提供一个操作,用于打开相关设置,而不是显示常规项目和 Explorer 内容。
配置 Explorer 网络
打开 以管理 Explorer 中可用的网络。

插件默认提供以下网络:
Mainnet Beta。
Testnet。
Devnet。
Localnet。
使用网络列表上方的工具栏添加、移除或编辑网络配置。
添加自定义网络
点击 添加。
在 添加自定义网络 对话框中,配置:
姓名 — Explorer 的网络选择器中显示的标签。
HTTP 网址 — 网络的 JSON-RPC 端点。
WS 网址 — 用于订阅和实时更新的 WebSocket 端点。
端口 — 网络使用的 RPC 端口。
点击 确定 以保存网络。
要更改现有配置,请选择它并点击 编辑。 要删除自定义配置,请选择它并点击 移除。 已配置的网络会在 资源管理器 选项卡的网络选择器中可用。
Anchor 项目集成
插件通过读取 Anchor 项目的 Anchor.toml 文件来识别这些项目。 它会发现:
Anchor 项目位置。
已配置的钱包。
已配置的集群,例如 Localnet。
为每个集群声明的程序,例如
[programs.localnet]下的程序。
Project 选项卡会以按项目、集群和程序组织的树形式呈现此信息。 这样,无需从 Anchor.toml 手动复制配置值即可处理项目。
编辑 Anchor.toml
插件为 Anchor.toml 提供支持 Anchor 感知的编辑辅助,包括:
针对节、属性和值的语法高亮显示。
针对 Anchor 配置的验证和编辑器检查。
针对节属性的上下文感知补全。
针对受支持属性值的补全,并在可用时提供描述。
例如,在 [hooks] 节内,补全会建议受支持的钩子名称,例如 pre-build、 post-build、 pre-deploy、 post-deploy、 pre-test 和 post-test。

对于集群属性,补全会提供标准 Solana 集群值并说明其用途:
devnet— 公共 Solana 开发集群。localnet— 本地 Solana 测试验证器。mainnet— Solana mainnet-beta 生产集群。testnet— 面向验证器的 Solana 测试集群。

同步 Anchor 程序 ID
当编辑器检测到 Anchor 程序的 ID 声明与程序生成的密钥对不同步时,会显示 同步 Anchor 密钥 通知操作。

这通常发生在以下情况之后:
克隆项目时未包含其生成的部署密钥对。
运行会生成新密钥对的初始构建。
替换或重新生成程序密钥对。
在源代码或 Anchor.toml 中手动更改程序 ID。
点击 同步 Anchor 密钥 以运行等效于 anchor keys sync 的命令。 target/deploy/<program>-keypair.json 中生成的密钥对会被视为真实来源。 此操作会更新:
程序的
declare_id!宏中的公钥。Anchor.toml 中对应的程序 ID 声明。
同步后,程序源和 Anchor 配置会使用实际部署密钥对的公钥。 由于此操作会编辑项目文件,请在提交前检查产生的更改。
自定义运行配置

构建和测试 Anchor 项目
插件为常见的 Anchor 开发任务提供预配置的运行配置:
Anchor 构建 — 构建 Anchor 项目中的程序。
Anchor 测试 — 运行 Anchor 项目的测试套件。
从 RustRover 的运行配置选择器中选择任一配置,并使用标准 IDE 控件运行它。 命令输出和错误会显示在“运行”工具窗口中,从而无需在终端中手动调用相应的 Anchor 命令即可构建和测试项目。
使用 Surfpool 运行本地网络
插件提供 Surfpool: 启动 运行配置。 从 RustRover 的运行配置选择器中运行它以执行:
Surfpool 输出会显示在“运行”工具窗口中,可能包括:
当前槽位和周期信息。
网络和部署日志。
交易计数器。
指向 Surfpool Studio 界面的链接。
Surfpool 启动后,可以从 Project 选项卡将程序部署到本地网络。
Solana 工具窗口
在 RustRover 中打开 Anchor 项目,然后打开 索拉纳 工具窗口。
工具链发现成功后,窗口包含两个主要选项卡:
Project — 项目、钱包、集群和程序管理。
资源管理器 — 交易监控和账户检查。

管理钱包
钱包 选择器显示连接到 Anchor 项目的钱包。 相邻的工具栏从左到右提供以下操作:
操作 | 描述 |
|---|---|
打开钱包文件 | 在编辑器中打开所选钱包的密钥对文件。 |
复制公钥 | 将所选钱包的公钥复制到剪贴板。 |
创建新钱包 | 创建新钱包并将其添加到可用的钱包配置中。 |
导入钱包 | 导入现有钱包供项目使用。 |
需要签名者的操作会使用所选钱包,例如部署程序。
导入钱包
选择 导入钱包 以打开 导入 Solana 密钥对 对话框。
在 Solana 密钥对 中,粘贴以下任一受支持格式的现有密钥:
Base58 编码的字符串。
JSON 字节数组,例如 Solana 密钥对 JSON 文件的内容。
在 保存到 中,输入应创建钱包文件的路径,或使用文件夹按钮选择位置。
点击 确定 以保存并导入钱包。
导入的钱包会在 钱包 选择器中可用。
管理程序
为所选集群声明的程序会显示在项目树中。

程序工件图标
每个程序名称旁边的图标显示该程序可用的已生成 Anchor 工件:
图标 | 含义 |
|---|---|
键 | 程序密钥对可用。 密钥对决定用于部署的程序 ID,并让插件提供 复制程序 ID 等操作。 |
接口描述语言 文档 | 程序的 Anchor IDL 可用。 插件可以使用它来解释程序指令,并将账户数据解码为命名字段。 |
| 已编译的程序二进制文件可用于部署。 |
这些图标是可用性指示器。 如果缺少某个图标,请生成相应的工件 — 例如,通过运行 Anchor 构建 — 并根据需要刷新或重新打开项目。
打开程序的上下文菜单以访问以下操作:
部署程序
将所选 Anchor 程序部署到活动集群。 对于 Localnet 部署,请先启动本地网络,并验证其 RPC 端点可用。
复制程序 ID
将所选程序的公钥复制到剪贴板。 这在配置需要引用已部署程序的客户端、测试、脚本或其他程序时很有用。
浏览交易
选择集群,例如 本地网络。
打开程序选择器并选择要监控的程序。
点击 启动浏览器。
运行提交交易的应用程序或测试。

Explorer 运行时,匹配的交易会显示在实时表中,并包含以下信息:
槽位 — 处理该交易的槽位。
程序 — 与该交易关联的所选程序。
状态 — 交易结果,例如
确定表示交易成功。签名 — 交易签名。
选择交易以检查其 指令 和 日志。
对于每条指令, 指令 节可以显示:
指令索引和程序名称。
当程序的 Anchor IDL 可用时,显示已解码的指令名称和实参值。
指令的堆栈高度。
提供给指令的账户地址有序列表。
Base58 和十六进制格式的原始指令数据。
日志 节显示交易执行期间发出的运行时消息,包括:
程序调用和调用深度。
已执行的指令名称。
程序发出的消息。
消耗的计算单元和计算单元限制。
程序成功或失败。
不再需要交易流式传输时,点击 停止浏览器。
浏览账户
帐户 视图会加载所选程序拥有的账户。
启动 Explorer 并选择感兴趣的程序。
打开 帐户 选项卡。
点击 获取程序帐户。
从结果表中选择账户。

账户表包括:
程序 — 与账户关联的所选程序。
帐户 — 账户的公钥。
Lamport — 账户余额,单位为 lamport。
所有者 — 拥有该账户的程序的公钥。
数据大小 — 账户数据大小,单位为字节。
可执行文件 — 账户是否包含可执行程序。
使用 Accounts 工具栏加载程序账户、筛选结果或刷新当前数据。
选择账户以打开其详细信息。 详细信息 部分显示:
账户公钥。
关联的程序名称。
所有者程序的公钥。
lamport 余额。
可执行状态。
租金纪元。
原始数据 部分显示:
账户数据大小,以字节为单位。
编码为 Base64 的账户数据。
编码为十六进制的账户数据。
当程序的 Anchor IDL 可用时,插件会添加 已解码帐户 部分。 它会识别 Anchor 账户类型,并将其数据呈现为具名且带类型的字段。 例如,已解码的计数器账户可以公开:
这样就可以直接在 IDE 中检查并验证应用程序状态,而无需手动解码账户的二进制数据。
故障排查
Localnet RPC 不可用
程序部署需要所选集群具有可访问的 RPC 服务。 如果无法访问 Localnet 端点,插件会报告类似以下内容的错误:
如果发生这种情况:
确认 Surfpool: 启动 运行配置仍在运行。
等待本地网络完成启动。
验证所选集群为 本地网络。
确认已配置的 Localnet RPC URL 与正在运行的网络公开的端点匹配。
重试 部署程序。
未显示交易
检查以下内容:
浏览器正在运行;按钮应显示为 停止浏览器。
已选择正确的集群。
在程序筛选器中至少选择了一个程序。
应用程序正在向浏览器监控的同一网络提交交易。
未显示账户
选择相关程序并点击 获取程序帐户 以加载 Accounts 视图。 如果表格仍为空,请确认程序已在所选集群上创建账户。
功能摘要
面积图 | 功能 |
|---|---|
Anchor 集成 | 检测 Anchor 项目,并从 Anchor.toml 读取其配置。 |
Anchor.toml 编辑 | 为 Anchor 配置密钥和值提供语法高亮显示、验证和上下文感知补全。 |
程序 ID 同步 | 检测不匹配的 Anchor 密钥,并将 |
工具链配置 | 检测工具路径和版本,支持自定义可执行文件路径,并链接到缺失工具的安装说明。 |
项目视图 | 显示集群、程序、已配置的钱包,以及程序密钥对、IDL 和已编译二进制文件的可用性。 |
构建和测试 | 提供预配置的 Anchor 构建 和 Anchor 测试 运行配置。 |
程序操作 | 部署程序并复制其程序 ID。 |
本地开发 | 从 IDE 运行配置启动 Surfpool 并显示其输出。 |
网络配置 | 提供默认 Solana 网络,并支持带有 HTTP RPC 和 WebSocket URL 的自定义 Explorer 端点。 |
交易浏览器 | 流式传输所选程序的交易,并显示状态、签名、指令、原始数据和日志。 |
账户浏览器 | 加载程序拥有的账户,并显示元数据和原始数据。 |
Anchor 解码 | 当 IDL 可用时,将账户数据解码为具名且带类型的字段。 |