穩定 AMM 程式碼示例

npm install @raydium-io/raydium-sdk-v2 @solana/web3.js @solana/spl-token

import { Raydium, TxVersion } from "@raydium-io/raydium-sdk-v2";
import { Connection, Keypair, clusterApiUrl } from "@solana/web3.js";
import BN from "bn.js";
import bs58 from "bs58";

const connection = new Connection(clusterApiUrl("mainnet-beta"));
const owner = Keypair.fromSecretKey(bs58.decode(process.env.PRIVATE_KEY!));

const raydium = await Raydium.load({
  connection,
  owner,
  cluster: "mainnet",
  // 選用：如果你打算直接呼叫 `liquidity/stable.ts` 中的報價協助程式，
  // 請載入穩定曲線模型版面配置。資金池層級的交換 / 新增 / 移除
  // 會為你延遲執行此操作，因此大多數呼叫者可以跳過此步驟。
});

// 一次性：預取鏈上模型資料版面配置，供鏈下穩定曲線協助程式使用。
// 僅在直接呼叫 getStablePrice / getDxByDyBaseIn / getDyByDxBaseIn 時需要。
// addLiquidity / removeLiquidity / swap 不需要此步驟。
await raydium.liquidity.initLayout();

const isStable =
  pool.version === 5 ||
  pool.pooltype.includes("StablePool"); // SDK 內部使用此字串檢查

// 或者，透過程式 ID：
const STABLE_AMM_PROGRAM_ID = "5quBtoiQqxF9Jv6KYKctB59NT3gtJD2Y65kdnB1Uev3h";
const isStableByProgram = pool.programId === STABLE_AMM_PROGRAM_ID;

import { PublicKey } from "@solana/web3.js";

// 兩個常見的代幣示例
const mintA = new PublicKey("Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB"); // USDT
const mintB = new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"); // USDC

const pools = await raydium.api.fetchPoolByMintPair({
  mint1: mintA.toBase58(),
  mint2: mintB.toBase58(),
});

const stablePool = pools.find(
  (p) => p.version === 5 || p.pooltype.includes("StablePool"),
);

if (!stablePool) {
  throw new Error("此代幣對不存在穩定資金池");
}

console.log("穩定資金池 id：", stablePool.id);
console.log("穩定資金池 programId：", stablePool.programId);
console.log("TVL：", stablePool.tvl);

import { Percent, TokenAmount, toToken } from "@raydium-io/raydium-sdk-v2";

const inputAmount = new TokenAmount(toToken(stablePool.mintA), 1_000_000); // 1 USDT
const slippage = new Percent(50, 10_000); // 0.5%

// 使用 SDK 的穩定曲線協助程式內部計算預期輸出。
const { amountOut, minAmountOut } = raydium.liquidity.computeAmountOut({
  poolInfo: stablePool,
  amountIn: inputAmount,
  mintIn:  stablePool.mintA.address,
  mintOut: stablePool.mintB.address,
  slippage,
});

console.log("預期輸出：", amountOut.toSignificant());
console.log("最小輸出：", minAmountOut.toSignificant());

// 建立並簽署交換交易。
const { transaction, execute } = await raydium.liquidity.swap({
  poolInfo: stablePool,
  amountIn:    inputAmount.raw,
  amountOut:   minAmountOut.raw,
  fixedSide:   "in",
  txVersion:   TxVersion.V0,
});

const { txId } = await execute({ sendAndConfirm: true });
console.log("穩定交換交易：", txId);

import { Percent, TokenAmount, toToken } from "@raydium-io/raydium-sdk-v2";

const amountInA = new TokenAmount(toToken(stablePool.mintA), 100_000_000); // 100 USDT
const slippage  = new Percent(50, 10_000); // 0.5%

// 計算曲線對此 A 規模所需的匹配 B 金額。
const { anotherAmount, minAnotherAmount } = raydium.liquidity.computePairAmount({
  poolInfo: stablePool,
  amount:   amountInA.toSignificant(),
  baseIn:   true,
  slippage,
});

const { execute } = await raydium.liquidity.addLiquidity({
  poolInfo: stablePool,
  amountInA,
  amountInB:      anotherAmount,
  otherAmountMin: minAnotherAmount,
  fixedSide:      "a",
  txVersion:      TxVersion.V0,
});

const { txId } = await execute({ sendAndConfirm: true });
console.log("新增流動性交易：", txId);

import {
  getStablePrice,
  getDxByDyBaseIn,
  getDyByDxBaseIn,
} from "@raydium-io/raydium-sdk-v2";

// 在使用這些函式之前，你必須呼叫一次 initLayout()（將鏈上
// `ModelDataInfo` PDA 載入到 SDK 的 StableLayout 快取中）。
await raydium.liquidity.initLayout();

const modelData = raydium.liquidity.stableLayout;

// 資金池目前儲備量時的現貨價格。
const price = getStablePrice(modelData, /* x */, /* y */, /* withFee */);
console.log("現貨價格：", price);

// 報價：給定 dx 輸入，多少 dy 輸出（此處不適用手續費）？
const dyOut = getDyByDxBaseIn(modelData, /* x */, /* y */, /* dx */);

// 報價：給定 dy 輸出目標，需要多少 dx 輸入？
const dxIn  = getDxByDyBaseIn(modelData, /* x */, /* y */, /* dy */);

const route = await raydium.tradeV2.fetchRoutes({
  inputMint:  mintA,
  outputMint: mintB,
  amount:     new BN(1_000_000),
  slippage,
});

// route.routes[0].poolType 告知你最佳路由使用的程式；
// 每當穩定資金池是最優路徑的一部分時，「Stable」就會在此出現。
console.log(route.routes[0]);

const { execute } = await raydium.tradeV2.swap({
  inputMint:    mintA,
  outputMint:   mintB,
  inputAmount:  new BN(1_000_000),
  swapResult:   route.routes[0],
  slippage,
  txVersion:    TxVersion.V0,
});

const { txId } = await execute({ sendAndConfirm: true });