Raydium SDK 简明教程：构建 Solana 去中心化交易应用

Raydium 作为 Solana 区块链上首个去中心化自动做市商（AMM），凭借其高速、低成本的特性，为开发者提供了强大的去中心化交易功能支持。本教程将引导你使用 Raydium SDK 构建一个基础的代币交换应用。

环境准备与钱包连接

安装 Solana 钱包适配器

Solana 生态拥有多种钱包选择，推荐使用官方提供的 Solana 钱包适配器来处理钱包连接功能。安装时请确保 Node.js 版本符合依赖要求。

若在安装 @solana/web3.js 时遇到问题，请检查 Node 版本兼容性。成功安装后，若运行中出现资源缺失错误，可在 webpack.config.js 中添加如下回退配置：

resolve: {
  fallback: {
    "crypto": require.resolve("crypto-browserify"),
    "stream": require.resolve("stream-browserify"),
    "os": require.resolve("os-browserify/browser")
  }
}

钱包连接配置

在 App.tsx 中初始化钱包适配器，支持 Phantom、Glow、Slope 等主流钱包：

const wallets = useMemo(
  () => [
    new PhantomWalletAdapter(),
    new GlowWalletAdapter(),
    new SlopeWalletAdapter(),
    new SolflareWalletAdapter({ network }),
    new TorusWalletAdapter()
  ],
  [network]
);

注意：Raydium 智能合约仅在主网部署，开发需使用真实资产进行测试。Solana 网络交易费用低廉，主网测试成本可控。

前端界面设计与实现

UI 框架选择

可使用任意前端库构建用户界面。示例项目基于 React 和 Bootstrap v5 开发，主要交互逻辑集中于 Main.tsx 组件。开发者可根据需求自定义界面风格与布局。

👉 获取前端UI设计参考方案

核心功能实现

代币余额查询

SOL 和代币的余额获取方式不同：

查询 SOL 余额：

const balance = await connection.getBalance(publicKey);
setSolBalance(balance / LAMPORTS_PER_SOL);

查询代币余额（以 RAY 为例）：

通过 Solscan 查询代币合约地址（RAY 地址：4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R）
使用 getTokenAccountsByOwner 获取用户所有代币账户
筛选指定代币账户并查询余额

const tokenAccs = await getTokenAccountsByOwner(connection, publicKey);
const rayAcc = tokenAccs.filter(acc => 
  acc.accountInfo.mint.toBase58() === RAY_TOKEN_MINT
);
const accBalance = await connection.getTokenAccountBalance(rayAcc.pubkey);

流动性池信息获取

从 Solscan 获取流动性代币地址

请求 Raydium 官方接口获取流动性池数据：

const liquidityJson = await fetch('https://api.raydium.io/v2/sdk/liquidity/mainnet.json');
const allPoolKeysJson = [...liquidityJson.official, ...liquidityJson.unOfficial];

筛选目标流动性池并转换为池密钥：

const raySolPk = jsonInfo2PoolKeys(poolKeysRaySolJson);

兑换计算与执行

使用 Raydium SDK 的 Liquidity.fetchInfo 和 Liquidity.computeAmountOut 方法计算兑换金额和价格影响：

const { amountIn, minAmountOut } = await calcAmountOut(
  connection, 
  raySolPoolKey, 
  inputNumber, 
  swapDirection
);

生成并发送交易：

const { transaction, signers } = await Liquidity.makeSwapTransaction({
  connection,
  poolKeys: raySolPoolKey,
  userKeys: { tokenAccounts, owner: publicKey },
  amountIn,
  amountOut: minAmountOut,
  fixedSide: "in"
});

const txid = await sendTransaction(transaction, connection, { 
  signers, 
  skipPreflight: true 
});

交易完成后可通过 Solscan 查看交易详情：https://solscan.io/tx/${txid}

功能扩展建议

为提升用户体验，可增加以下功能：

代币切换功能
实时汇率显示
交易历史记录
滑点容忍度设置
价格影响提示

👉 查看实时交易工具与进阶功能

常见问题

Raydium 是什么？

Raydium 是 Solana 区块链上首个自动化做市商协议，提供高速、低成本的去中心化交易服务，并与其他生态项目深度集成。

为什么需要在主网测试？

Raydium 智能合约仅部署在主网，测试网和开发网中没有可用的流动性池。得益于 Solana 的低交易费用，主网测试成本相对较低。

如何解决依赖安装问题？

确保使用兼容的 Node.js 版本（推荐 LTS 版本），并检查错误信息中的具体提示。常见的解决方案包括添加 polyfill 和更新依赖版本。

交易失败的可能原因？

可能原因包括：余额不足、滑点设置过低、网络拥堵、价格波动过大。建议增加滑点容忍度并确认余额充足后重试。

如何获取代币合约地址？

可通过 Solscan、Raydium 官网或项目官方渠道查询代币合约地址。确保使用正规来源以避免诈骗风险。

价格影响是什么意思？

价格影响是指大额交易对流动性池价格产生的影响程度。交易量越大，价格影响越显著，可能导致实际成交价格与预期有差异。

通过本教程，你已掌握使用 Raydium SDK 构建去中心化交易应用的核心技能。建议深入阅读官方文档了解更多高级功能，并在开发过程中始终遵循安全最佳实践。