메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

이 페이지는 AI 자동 번역입니다. 모든 내용은 영문판을 기준으로 합니다.영문판 보기 →
이것이 하는 일. 선택한 수수료 티어에서 새로운 CLMM 풀을 생성한 다음, 초기 집중된 포지션을 엽니다. 두 개의 트랜잭션, 하나의 스크립트입니다. 코드는 raydium-sdk-V2-demo/src/clmm의 공식 데모에서 가져온 것이며, 단일 Node 실행 파일로 조정되었습니다.

설정

빠른 시작 필수 사항을 읽었는지 확인하고 RPC_URL, KEYPAIR, 및 종속성이 설치되어 있어야 합니다. CLMM 풀 생성에는 일회성 수수료와 초기 포지션에 대한 틱 배열 렌트가 필요합니다. 또한 두 시드 민트가 지갑에 있어야 합니다. 가격이 선택한 범위 내에 있을 때 포지션을 열려면 양쪽 모두에 유동성이 필요합니다.

단계 1 — config.ts

config.ts로 저장하세요. 이것은 데모 저장소의 src/config.ts.template과 같은 형태입니다 — disableFeatureChecktrue로 강제됩니다 (모든 사소하지 않은 통합의 경우 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_vaulttoken_1_vault (민트 바이트 순서로 정렬),
  • observation 링 버퍼,
  • 인라인 틱 배열 비트맵,
그리고 initialPrice에서 초기 sqrt_price_x64를 설정했습니다. 트랜잭션 2 — raydium.clmm.openPositionFromBase 집중된 포지션 개설:
  • 지갑에 포지션 NFT를 발행했습니다 (NFT 포지션이고, NFT를 전송하면 포지션이 전송됨),
  • 하한과 상한에서 틱 배열을 할당했습니다 (이 범위의 첫 포지션인 경우 일회성 렌트; 틱 배열은 프로그램에서 닫히지 않으므로 같은 배열의 후속 포지션은 추가 렌트를 지불하지 않음),
  • mint1inputAmount와 일치하는 mint2의 쌍 금액을 예치했습니다 (PoolUtils.getLiquidityAmountOutFromAmountIn에서 계산).
  • 포지션에 범위 너비에 비례하는 유동성을 크레딧했습니다.
범위가 좁을수록 TVL 달러당 자본 효율성이 높아지고, 가격이 범위를 벗어날 때 무상손실이 더 심해집니다. 위에서 사용한 범위 ([0.000001, 100000])는 실제로 풀 범위이고, 현재 스팟 근처 수수료를 집중하려면 범위를 좁혀야 합니다.

수수료 티어 선택

clmmConfigs[0]은 최저 수수료 티어입니다. 전체 세트는 GET https://api-v3.raydium.io/main/clmm-config에서 발행됩니다:
지수tradeFeeRate틱 간격사용할 때
0100 (1bp)1안정적/안정적, 무상손실 매우 낮음 예상
1500 (5bp)10높은 상관관계 자산 (예: 액체 스테이킹 vs 기초)
22_500 (25bp)60표준 토큰 쌍, 블루칩 + 안정
310_000 (1.00%)120무상손실 위험이 높은 변동성 또는 얇은 쌍
전체 의사 결정 매트릭스는 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 rangelowerPrice 또는 upperPrice가 표현 가능한 가격 범위를 벗어났습니다. 현재 가격에 비해 더 합리적인 범위를 사용하세요.
  • 오래된 가격 — API의 인용은 5~60초 오래될 수 있습니다. executePosition이 슬리피지에서 실패하면, createPosition.tsgetRpcClmmPoolInfo 블록의 주석을 해제하여 서명하기 직전에 실시간 가격을 다시 가져오세요.

주의사항

  • 포지션 NFT는 유일한 핸들입니다. NFT를 잃거나 전송하면 포지션에 대한 접근을 잃게 됩니다. 이를 열쇠처럼 취급하세요.
  • 범위를 벗어난 포지션은 수수료를 얻지 못합니다. 가격이 [lowerPrice, upperPrice] 범위를 벗어나면, 포지션은 전적으로 하나의 자산으로 주차되고 재조정할 때까지 아무것도 얻지 못합니다.
  • 틱 배열 렌트는 일방적입니다. 처음 초기화되지 않은 틱 배열에 접근하는 첫 번째 포지션이 렌트를 지불합니다. 프로그램은 틱 배열을 닫을 경로를 노출하지 않으므로 해당 렌트는 영구적입니다. 같은 배열의 후속 포지션은 무료입니다.

다음

출처: