アカウントモデル

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.

​

基本的な分離：プログラムとアカウント

​

プログラム

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

​

アカウント

• pubkey — そのアドレス。
• owner — それを所有するプログラム（書き込みを制御）。
• data — 生のバイト。
• lamports — SOL残高（1 SOL = 1,000,000,000 lamports）。
• rent_epoch — レガシーレント回収フィールド（レント免除が必須になってから無視）。

​

所有権

• ユーザーウォレット：System Programによって所有。Lampportsはここに存在。署名して転送します。
• USDCトークンアカウント：SPL Token Programによって所有。トークンプログラムのtransfer命令がバランスを更新します。
• Raydiumプール状態アカウント：CPMMプログラムによって所有。CPMMの命令のみが準備金、手数料などを変更できます。
• Raydiumポジション NFTのPersonalPositionState：CLMMプログラムによって所有。

​

レントとレント免除

• レント免除アカウントは永遠に存在します。
• アカウントをクローズするとlamplortsをクローズ署名者に返します。

​

Raydiumレントコスト

​

データと実行可能アカウント

​

データアカウント

​

実行可能アカウント

​

プログラム派生アカウント（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;
// Skip first 8 bytes (discriminator), then parse according to struct layout.
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. Compute the ATA address (PDA-style derivation).
const ata = getAssociatedTokenAddressSync(usdcMint, user);

// 2. Read the account.
const accountInfo = await connection.getAccountInfo(ata);
if (!accountInfo) {
  console.log("ATA doesn't exist yet (user has never held USDC).");
  return;
}

// 3. Verify owner is SPL Token program.
console.assert(accountInfo.owner.toBase58() === "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA");

// 4. Decode the data.
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にとってこれが重要な理由

• プール状態は単一のアカウント — プールに関するすべて（ミント、準備金、手数料、管理者）は、プールプログラムによって所有される1つのアカウントに存在します。
• LPトークンは標準SPLトークンアカウント — Raydiumはトークン化をSPL Tokenプログラムに委任します。
• ティックアレイはチャンク化 — CLMMは成長可能なティックの単一配列を持つことができません。なぜなら、アカウントは固定割り当てサイズを持つため、代わりにチャンク化されたTickArray PDAを使用します。
• ポジション NFTはMetaplex NFT — CLMMのポジションはMetaplexごとの標準NFTであり、ポジション状態は別のPDAです。

• 「プール準備金はどこにありますか？」→ 2つのボールトアカウント（トークンアカウント）、SPL Tokenプログラムによって所有、権限がプールプログラムの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 — トークンアカウントが存在する場所。