CLMMプールをデプロイする

このページは AI による自動翻訳です。すべての内容は英語版を正とします。英語版を表示 →

このコードの役割。 選択したフィー階層で新しいCLMMプールを作成し、初期集中ポジションを開きます。4つのファイル（config.ts、createPool.ts、createPosition.ts、utils.ts）にまたがる2つのトランザクションを npx tsx で実行します。コードは raydium-sdk-V2-demo/src/clmm の公式デモから引用し、スタンドアロンで実行するように適応させています。

セットアップ

クイックスタートの前提条件を読み、RPC_URL、KEYPAIR、および依存関係がインストールされていることを確認してください。クイックスタートの依存関係に加えて、以下が必要です：

npm install decimal.js bs58 tsx

decimal.js — createPool.ts と createPosition.ts での価格とティック計算。
bs58 — JSON キーファイルの代わりに KEYPAIR_BS58 を使用する場合、config.ts で base58 エンコードされたキーペアをデコードします。
tsx — npx tsx 経由で以下の .ts ファイルを直接実行します。スワップおよび CPMM スクリプトとは異なり、これは node で実行される通常の .mjs ファイルではありません。

CLMMプール作成には1回限りのフィーと初期ポジション用のティック配列レントが必要です。また、ウォレットに両方のシードミントが必要です。選択した範囲内に価格がある場合、ポジションを開くには両側にリクイディティが必要です。 devnetでの実行。 config.ts で cluster を "devnet" に変更するだけでは不十分です。createPool.ts は明示的な programId: CLMM_PROGRAM_ID（メインネットの固定定数で cluster に従いません）を渡します。その直上のコメント化された DEVNET_PROGRAM_ID.CLMM_PROGRAM_ID 行に置き換えてください。createPosition.ts もメインネットの poolId（RAY-USDCプール）をハードコードしています。ステップ2で作成したdevnetプールのIDに置き換えてください。

ステップ1 — `config.ts`

config.ts として保存します。これはデモリポジトリの src/config.ts.template と同じ形式です。disableFeatureCheck は true に強制されます（SDKがスタートアップ機能検出呼び出しでブロックされないようにするため、非自明な統合では推奨）：

config.ts

import { Raydium, TxVersion, parseTokenAccountResp } from "@raydium-io/raydium-sdk-v2";
import { Connection, Keypair, clusterApiUrl } from "@solana/web3.js";
import { TOKEN_PROGRAM_ID, TOKEN_2022_PROGRAM_ID } from "@solana/spl-token";
import bs58 from "bs58";
import fs from "node:fs";

export const owner: Keypair = Keypair.fromSecretKey(
  // accept either a JSON-array keypair file (same shape Solana CLI writes) or a bs58 secret in env
  process.env.KEYPAIR_BS58
    ? bs58.decode(process.env.KEYPAIR_BS58)
    : new Uint8Array(JSON.parse(fs.readFileSync(process.env.KEYPAIR!, "utf8"))),
);

export const connection = new Connection(
  process.env.RPC_URL ?? clusterApiUrl("mainnet-beta"),
  "confirmed",
);
export const txVersion = TxVersion.V0;
const cluster = "mainnet" as "mainnet" | "devnet";

let raydium: Raydium | undefined;
export const initSdk = async (params?: { loadToken?: boolean }) => {
  if (raydium) return raydium;
  raydium = await Raydium.load({
    owner,
    connection,
    cluster,
    disableFeatureCheck: true,
    disableLoadToken: !params?.loadToken,
    blockhashCommitment: "finalized",
  });
  return raydium;
};

export const fetchTokenAccountData = async () => {
  const solAccountResp = await connection.getAccountInfo(owner.publicKey);
  const tokenAccountResp = await connection.getTokenAccountsByOwner(owner.publicKey, {
    programId: TOKEN_PROGRAM_ID,
  });
  const token2022Req = await connection.getTokenAccountsByOwner(owner.publicKey, {
    programId: TOKEN_2022_PROGRAM_ID,
  });
  return parseTokenAccountResp({
    owner: owner.publicKey,
    solAccountResp,
    tokenAccountResp: {
      context: tokenAccountResp.context,
      value: [...tokenAccountResp.value, ...token2022Req.value],
    },
  });
};

ステップ2 — `createPool.ts`

config.ts と同じ場所に保存します。ソース：src/clmm/createPool.ts。

createPool.ts

import { CLMM_PROGRAM_ID, DEVNET_PROGRAM_ID } from "@raydium-io/raydium-sdk-v2";
import { PublicKey } from "@solana/web3.js";
import Decimal from "decimal.js";
import { initSdk, txVersion } from "./config";

export const createPool = async () => {
  const raydium = await initSdk({ loadToken: true });

  // RAY
  const mint1 = await raydium.token.getTokenInfo("4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R");
  // USDT
  const mint2 = await raydium.token.getTokenInfo("Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB");

  // Fee tiers come from the live API. On devnet the published `id` field is wrong;
  // re-derive the PDA before passing it to the SDK.
  const clmmConfigs = await raydium.api.getClmmConfigs();

  const { execute } = await raydium.clmm.createPool({
    programId: CLMM_PROGRAM_ID,
    // programId: DEVNET_PROGRAM_ID.CLMM_PROGRAM_ID,
    mint1,
    mint2,
    ammConfig: {
      ...clmmConfigs[0],
      id: new PublicKey(clmmConfigs[0].id),
      fundOwner: "",
      description: "",
    },
    initialPrice: new Decimal(1),
    txVersion,
    // optional: set up priority fee here
    // computeBudgetConfig: { units: 600000, microLamports: 46591500 },
  });

  const { txId } = await execute({ sendAndConfirm: true });
  console.log("clmm pool created:", { txId: `https://explorer.solana.com/tx/${txId}` });
  process.exit();
};

createPool();

ステップ3 — `createPosition.ts`

ソース：src/clmm/createPosition.ts。

createPosition.ts

import {
  ApiV3PoolInfoConcentratedItem,
  TickUtils,
  PoolUtils,
  ClmmKeys,
} from "@raydium-io/raydium-sdk-v2";
import BN from "bn.js";
import Decimal from "decimal.js";
import { initSdk, txVersion } from "./config";
import { isValidClmm } from "./utils";

export const createPosition = async () => {
  const raydium = await initSdk();

  let poolInfo: ApiV3PoolInfoConcentratedItem;
  // RAY-USDC pool
  const poolId = "61R1ndXxvsWXXkWSyNkCxnzwd3zUNB8Q2ibmkiLPC8ht";
  let poolKeys: ClmmKeys | undefined;

  if (raydium.cluster === "mainnet") {
    const data = await raydium.api.fetchPoolById({ ids: poolId });
    poolInfo = data[0] as ApiV3PoolInfoConcentratedItem;
    if (!isValidClmm(poolInfo.programId)) throw new Error("target pool is not CLMM pool");
  } else {
    const data = await raydium.clmm.getPoolInfoFromRpc(poolId);
    poolInfo = data.poolInfo;
    poolKeys = data.poolKeys;
  }

  // Optional: pull on-chain real-time price to avoid slippage errors from a stale API quote.
  // const rpcData = await raydium.clmm.getRpcClmmPoolInfo({ poolId: poolInfo.id });
  // poolInfo.price = rpcData.currentPrice;

  const inputAmount = 0.000001; // RAY amount
  const [startPrice, endPrice] = [0.000001, 100000];

  const { tick: lowerTick } = TickUtils.getPriceAndTick({
    poolInfo,
    price: new Decimal(startPrice),
    baseIn: true,
  });
  const { tick: upperTick } = TickUtils.getPriceAndTick({
    poolInfo,
    price: new Decimal(endPrice),
    baseIn: true,
  });

  const epochInfo = await raydium.fetchEpochInfo();
  const res = await PoolUtils.getLiquidityAmountOutFromAmountIn({
    poolInfo,
    slippage: 0,
    inputA: true,
    tickUpper: Math.max(lowerTick, upperTick),
    tickLower: Math.min(lowerTick, upperTick),
    amount: new BN(new Decimal(inputAmount || "0").mul(10 ** poolInfo.mintA.decimals).toFixed(0)),
    add: true,
    amountHasFee: true,
    epochInfo,
  });

  const { execute, extInfo } = await raydium.clmm.openPositionFromBase({
    poolInfo,
    poolKeys,
    tickUpper: Math.max(lowerTick, upperTick),
    tickLower: Math.min(lowerTick, upperTick),
    base: "MintA",
    ownerInfo: { useSOLBalance: true },
    baseAmount: new BN(new Decimal(inputAmount || "0").mul(10 ** poolInfo.mintA.decimals).toFixed(0)),
    otherAmountMax: res.amountSlippageB.amount,
    txVersion,
    computeBudgetConfig: { units: 600000, microLamports: 100000 },
  });

  const { txId } = await execute({ sendAndConfirm: true });
  console.log("clmm position opened:", { txId, nft: extInfo.nftMint.toBase58() });
  process.exit();
};

createPosition();

ステップ4 — `utils.ts`

ソース：src/clmm/utils.ts。

utils.ts

import { CLMM_PROGRAM_ID, DEVNET_PROGRAM_ID } from "@raydium-io/raydium-sdk-v2";

const VALID_PROGRAM_IDS = new Set<string>([
  CLMM_PROGRAM_ID.toBase58(),
  DEVNET_PROGRAM_ID.CLMM_PROGRAM_ID.toBase58(),
]);

export const isValidClmm = (programId: string) => VALID_PROGRAM_IDS.has(programId);

実行

# create the pool first
RPC_URL="https://api.mainnet-beta.solana.com" \
KEYPAIR="$HOME/.config/solana/id.json" \
npx tsx createPool.ts

# then open an initial position against the new pool id
# (edit poolId at the top of createPosition.ts to point at your new pool)
RPC_URL="https://api.mainnet-beta.solana.com" \
KEYPAIR="$HOME/.config/solana/id.json" \
npx tsx createPosition.ts

何が起きたか

トランザクション1 — raydium.clmm.createPool は以下を初期化しました：

(mint1, mint2, ammConfig) の正規PDAでのプール状態、
token_0_vault と token_1_vault（ミントのバイト順でソート）、
observation リングバッファ、
インラインティック配列ビットマップ、

そして initialPrice から初期 sqrt_price_x64 を設定しました。 トランザクション2 — raydium.clmm.openPositionFromBase は集中ポジションを開きました：

ウォレットにポジションNFTをミント（NFT がポジション。転送するとポジションが転送される）、
下限と上限でティック配列を割り当て（これらの範囲の最初のポジションの場合は1回限りのレント。ティック配列はプログラムで閉じられないため、同じ配列内の後続ポジションは追加レントなし）、
mint1 の inputAmount と対応する mint2 の金額をデポジット（PoolUtils.getLiquidityAmountOutFromAmountIn で計算）、
範囲幅に比例するリクイディティでポジションをクレジット。

範囲が狭いほど、TVLあたりの資本効率が高くなります。ただし、価格が範囲外に移動した場合の無常損失がより大きくなります。上記で使用した範囲（[0.000001, 100000]）は実質的にフルレンジです。現在のスポット付近でフィーを集中させるために範囲を狭めてください。

フィー階層の選択

clmmConfigs[0] は最低フィー階層です。完全なセットは GET https://api-v3.raydium.io/main/clmm-config で公開されています：

インデックス	`tradeFeeRate`	ティック間隔	使用場面
0	`100`（1bp）	1	ステーブル・ステーブル、無常損失がほぼ予想されない
1	`500`（5bp）	10	高度に相関したアセット（例：流動性ステーク vs 基礎資産）
2	`2_500`（25bp）	60	標準的なトークンペア、ブルーチップ + ステーブル
3	`10_000`（1.00%）	120	IL リスクが高い変動性またはシンペアリング

完全な決定マトリックスについては user-flows/choosing-a-pool-type を参照してください。

よくあるエラー

Pool already exists for this config — この (mint1, mint2, ammConfig) トリプルに対してCLMMプールが既に存在します。既存のプールIDを検索し、ステップ2をスキップしてください。
Insufficient funds for amount B — ウォレットに要求された mintA の金額がありますが、対応する mintB がありません。価格が範囲内にある場合、ポジションを開くには両側にリクイディティが必要です。
Tick out of range — lowerPrice または upperPrice が表現可能な価格範囲外です。現在の価格に対してより合理的な範囲を使用してください。
古い価格 — APIからの見積もりは5～60秒古い可能性があります。executePosition がスリッページで失敗する場合、createPosition.ts の getRpcClmmPoolInfo ブロックをコメント解除して、署名直前にライブ価格を再取得してください。

注意事項

ポジションNFTが唯一のハンドル。 NFTを失うか転送すると、ポジションへのアクセスが失われます。キーのように扱ってください。
範囲外のポジションはフィーを獲得しません。 価格が [lowerPrice, upperPrice] の外に移動した場合、ポジションは完全に1つのアセットに駐車され、リバランスするまで何も獲得しません。
ティック配列レントは一方向。 初期化されたことのないティック配列に最初にタッチするポジションがそのレントを支払います。プログラムはティック配列を閉じるパスを公開していないため、そのレントは永続的です。同じ配列内の後続ポジションは無料です。

次のステップ

products/clmm/overview — 完全なCLMM メカニクス。
products/clmm/ticks-and-positions — ティックの背後にある数学。
algorithms/impermanent-loss — CLMMの無常損失増幅の定量化。
user-flows/create-clmm-pool — Raydium UIを使用した同じフロー。

ソース：

Solana の基礎

クイックスタート

SDK と API

統合ガイド

CLMMプールをデプロイする

セットアップ

ステップ1 — `config.ts`

ステップ2 — `createPool.ts`

ステップ3 — `createPosition.ts`

ステップ4 — `utils.ts`

実行

何が起きたか

フィー階層の選択

よくあるエラー

注意事項

次のステップ

​セットアップ

​ステップ1 — config.ts

​ステップ2 — createPool.ts

​ステップ3 — createPosition.ts

​ステップ4 — utils.ts

​実行

​何が起きたか

​フィー階層の選択

​よくあるエラー

​注意事項

​次のステップ

セットアップ

ステップ1 — `config.ts`

ステップ2 — `createPool.ts`

ステップ3 — `createPosition.ts`

ステップ4 — `utils.ts`

実行

何が起きたか

フィー階層の選択

よくあるエラー

注意事項

次のステップ