계정 모델

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.

​

기본 분리: 프로그램 vs 계정

​

프로그램

• CPMM: CPMMoo8L3F4NbTegBCKVNunggL7H1Zpdmwpwh8KMoZ0F
• CLMM: CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK
• AMM v4: 675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8

​

계정

• pubkey — 주소입니다.
• owner — 계정을 소유한 프로그램입니다 (쓰기를 제어합니다).
• data — 원본 바이트입니다.
• lamports — SOL 잔액입니다 (1 SOL = 1,000,000,000 lamports).
• rent_epoch — 레거시 렌트 수금 필드입니다 (렌트 면제가 필수가 된 이후로는 무시됩니다).

​

소유권

• 사용자 지갑: 시스템 프로그램에 의해 소유됩니다. Lamports가 여기에 있습니다. 서명하여 전송합니다.
• USDC 토큰 계정: SPL 토큰 프로그램에 의해 소유됩니다. 토큰 프로그램의 transfer 명령이 잔액을 업데이트합니다.
• Raydium 풀 상태 계정: CPMM 프로그램에 의해 소유됩니다. CPMM의 명령만 준비금, 수수료 등을 수정할 수 있습니다.
• Raydium 포지션 NFT의 PersonalPositionState: CLMM 프로그램에 의해 소유됩니다.

​

렌트 및 렌트 면제

• 렌트 면제 계정은 영구적으로 지속됩니다.
• 계정을 닫으면 lamports가 종료 서명자에게 반환됩니다.

​

Raydium 렌트 비용

​

데이터 vs 실행 가능 계정

​

데이터 계정

​

실행 가능 계정

​

프로그램 파생 계정 (PDA)

• 풀 상태 PDA: [poolTypeDiscriminator, mintA, mintB, ammConfig]에서 파생됩니다.
• 보관소 PDA: [pool, mint]에서 파생됩니다.
• 관찰 상태 PDA: [observationSeed, pool]에서 파생됩니다.

​

트랜잭션 및 계정 참조

• 나열된 계정은 읽거나 쓸 수 있습니다 (is_writable 플래그에 따라).
• 나열되지 않은 계정은 건드릴 수 없습니다.

[readonly] CPMM program
[writable] pool state
[readonly] amm config
[readonly] pool authority (PDA)
[writable] input vault
[writable] output vault
[writable] user input ATA
[writable] user output ATA
[readonly] input mint
[readonly] output mint
[readonly] input token program
[readonly] output token program
[writable] observation state
[signer,writable] user

​

계정 크기 및 데이터 레이아웃

​

Raydium 풀 상태 읽기

const pool = await raydium.cpmm.getPoolInfoFromRpc({ poolId });
console.log(pool.poolInfo);

const accountInfo = await connection.getAccountInfo(poolId);
const data = accountInfo.data;
// 처음 8바이트(판별자)를 건너뛴 후, 구조체 레이아웃에 따라 파싱합니다.
const poolState = CpmmPoolStateLayout.decode(data.slice(8));

​

작동 예시: 토큰 계정 읽기

import { Connection, PublicKey } from "@solana/web3.js";
import { getAssociatedTokenAddressSync, AccountLayout } from "@solana/spl-token";

const connection = new Connection("https://api.mainnet-beta.solana.com");
const user       = new PublicKey("YourUserWallet...");
const usdcMint   = new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");

// 1. ATA 주소를 계산합니다 (PDA 스타일 파생).
const ata = getAssociatedTokenAddressSync(usdcMint, user);

// 2. 계정을 읽습니다.
const accountInfo = await connection.getAccountInfo(ata);
if (!accountInfo) {
  console.log("ATA는 아직 존재하지 않습니다 (사용자가 USDC를 보유한 적이 없습니다).");
  return;
}

// 3. 소유자가 SPL 토큰 프로그램인지 확인합니다.
console.assert(accountInfo.owner.toBase58() === "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA");

// 4. 데이터를 디코딩합니다.
const parsed = AccountLayout.decode(accountInfo.data);
console.log("Balance (smallest units):", parsed.amount.toString());
console.log("Mint:",                     new PublicKey(parsed.mint).toBase58());
console.log("Owner:",                    new PublicKey(parsed.owner).toBase58());

​

Raydium에 이것이 중요한 이유

• 풀 상태는 단일 계정입니다 — 풀에 대한 모든 것 (민트, 준비금, 수수료, 관리자)이 풀 프로그램이 소유한 하나의 계정에 살고 있습니다.
• LP 토큰은 표준 SPL 토큰 계정입니다 — Raydium은 토큰화를 SPL 토큰 프로그램에 위임합니다.
• 틱 배열은 청크로 나뉩니다 — CLMM은 계정이 고정 할당 크기를 가지기 때문에 확장 가능한 단일 틱 배열을 가질 수 없습니다. 대신, 청크된 TickArray PDA를 사용합니다.
• 포지션 NFT는 Metaplex NFT입니다 — CLMM 포지션은 Metaplex에 따른 표준 NFT입니다. 포지션 상태는 별도 PDA입니다.

• “풀 준비금은 어디에 있는가?” → 두 개의 보관소 계정 (토큰 계정)은 SPL 토큰 프로그램이 소유하며, 권한은 풀 프로그램의 PDA에 위임됩니다.
• “CLMM의 틱 데이터는 어디에 있는가?” → 일련의 TickArray PDA, 각각 60개의 연속 틱을 다룹니다.
• “내 팜 스테이크는 어디에 있는가?” → [user, farmId]에서 파생된 UserLedger PDA, 팜 프로그램이 소유합니다.

​

포인터

• solana-fundamentals/programs-and-anchor — 프로그램이 계정을 처리하는 방법입니다.
• solana-fundamentals/pdas-and-cpis — PDA 파생 및 CPI입니다.
• solana-fundamentals/transactions-and-fees — 계정이 트랜잭션에서 참조되는 방법입니다.
• sdk-api/anchor-idl — Raydium 프로그램의 계정 레이아웃입니다.

• Solana Account docs.
• SPL Token program — 토큰 계정이 사는 곳입니다.