本页内容由 AI 自动翻译,所有内容以英文版本为准。查看英文版 →
核心工具
Solana CLI
与 Solana 集群交互的规范命令行界面——钱包管理、RPC 调用、程序部署。 安装:安装源已迁移。 该安装程序跟踪自己的当前版本概念,可能会给你一个与 Raydium 程序固定的 Anchor 不同的版本——之后检查
release.solana.com 属于 Solana Labs;客户端现在由 Anza 维护,名为 Agave,发布版本来自 release.anza.xyz。自更新二进制文件是 agave-install(solana-install 保留为旧别名),所以 agave-install update 和 agave-install init <version> 是当前的拼写方式。Solana 自己的文档也提供了一个一键安装程序,可以同时拉取 CLI、Rust 和 Anchor:anchor --version。SPL Token CLI
SPL Token / Token-2022 操作的官方 CLI——创建 mint、铸造代币、转账。 安装(包含在 Solana CLI 中):Anchor CLI
获取 Raydium IDL、构建客户端和验证程序所需。 安装:Anchor 迁移了仓库和主版本。 规范仓库现在是
github.com/solana-foundation/anchor(之前是 coral-xyz/anchor),Anchor 1.0 是 Raydium 程序使用的第一个发布线——CPMM 和 LaunchLab 都在 2026-09-09 升级时固定 anchor-lang/anchor-spl =1.0.2,CLMM 在 2026-09-30 升级时跟进,都从 0.32.1 升级上来。avm 可以保存多个版本;avm use 1.0.2 是让 anchor build 重现 Raydium 工件的方式。Anchor 1.1 和 1.2 存在并可以为你自己的程序构建,但针对与目标程序固定的 anchor-lang 不同的次版本编译的 CPI crate 将无法链接——见 sdk-api/rust-cpi。TypeScript 设置
Raydium 的主要集成路径。包
@coral-xyz/anchor 已冻结;包现在是 @anchor-lang/core。 @coral-xyz/anchor 在 Anchor 离开 Coral 时停留在 0.32.1。Anchor 1.x 发布为 @anchor-lang/core,Raydium 自己的程序仓库在 2026-09-09 升级时将其测试套件切换到了它(CLMM 在 2026-09-30)。你实际使用的导入没有变化——import { Program, BN, AnchorProvider } from "@anchor-lang/core"——所以迁移就是包重命名加锁文件更新。如果你从 0.3x 迁移,有两个行为说明:.accounts({...}) 现在只接受 Anchor 无法自己解析的账户,所以传递完整集合的构建器应该调用 .accountsPartial({...}) 代替;@anchor-lang/core/dist/cjs/utils/token 是 ASSOCIATED_PROGRAM_ID 等辅助函数迁移到的地方。最小脚本
sdk-api/typescript-sdk 了解完整的 SDK 参考。
Rust 设置
用于 CPI 集成和链上程序。工具链
cargo build-sbf 构建程序(旧的 cargo build-bpf 拼写已消失)。
Raydium CPI 集成的程序 Cargo.toml
= 将 anchor-lang 和 anchor-spl 固定到目标程序固定的版本。在它们的 chore/upgrade-anchor 分支上,CPMM 和 CLMM 都固定 =1.0.2,所以一个 crate 可以 CPI 到两者。两个仓库的 master 仍然固定 0.32.1,混合 master 依赖和升级分支依赖的 crate 将无法构建。见 sdk-api/rust-cpi。
"cpi" 特性导入带有 CPI 辅助函数的 cpi 模块(所以你可以 raydium_cp_swap::cpi::swap_base_input(...))。见 sdk-api/rust-cpi。
Python 设置
次要集成路径——对机器人开发者很常见。包
两个命名陷阱。RPC 客户端导入为
solana,但项目叫 solana-py——pip install solana-py 安装不了有用的东西。而且 PyPI 上没有 raydium-py 包:社区 Raydium 辅助工具是一个你克隆的仓库,AL-THE-BOT-FATHER/raydium_py,不是发布的发行版。本页的早期版本列出了一个 pip install raydium-py 行,但那从来没有工作过。最小脚本
sdk-api/python-integration。
RPC 端点
公共主网 RPC(api.mainnet-beta.solana.com)速率限制严格,在任何负载下都会节流。对于非平凡的使用,获取一个私有端点:
配置:
getProgramAccounts— 无限制扫描很昂贵;某些提供商限制或按扫描收费。getPriorityFeeEstimate— Helius 特定端点;其他提供商有等效功能。geyser/ WebSocket 流——低延迟机器人需要;不是所有提供商都暴露它。
Devnet 和 localnet
Devnet
Solana 的公共测试集群。Raydium 有部分 devnet 部署:- 存在一些 CPMM 池用于测试。
- AMM v4 有历史 devnet 池。
- CLMM 有几个演示池。
- Farm v6 已部署。
cluster: "devnet" 支持 devnet:
使用 fork 主网状态的 Localnet
为了进行现实的测试,将主网状态 fork 到本地验证器:- 针对真实 Raydium 程序对你的 CPI 集成进行单元测试。
- 用修改的参数重放交易以调试。
- 用大型合成交易量进行压力测试。
项目模板
TypeScript 集成启动器
package.json:
Anchor CPI 程序启动器
有用的 CLI 工具
solana-keygen
读取任何账户
程序日志
交易检查
环境卫生
为不同目的分离钱包
- 开发钱包:持有 testnet SOL,用于构建。
- 生产钱包:持有真实 SOL,仅用于部署/multisig 提交。
- 机器人热钱包:小余额,权限有限。
.env 模式
版本固定
锁定所有 Solana 生态系统依赖。生态系统发展很快;@solana/web3.js 的次版本升级以前引入过破坏性变化。虔诚地使用 package-lock.json / Cargo.lock。
指针
sdk-api/typescript-sdk— TypeScript SDK 参考。sdk-api/rust-cpi— Rust CPI 使用。sdk-api/python-integration— Python 设置。solana-fundamentals/programs-and-anchor— Anchor 背景。

