Mô hình tài khoản

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.

​

Sự phân chia cơ bản: chương trình so với tài khoản

​

Chương trình

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

​

Tài khoản

• pubkey — địa chỉ của nó.
• owner — chương trình sở hữu nó (kiểm soát ghi).
• data — các byte thô.
• lamports — số dư SOL (1 SOL = 1.000.000.000 lamports).
• rent_epoch — trường thu thập rent cũ (bị bỏ qua kể từ khi rent-exemption trở thành bắt buộc).

​

Quyền sở hữu

• Ví người dùng của bạn: được sở hữu bởi System Program. Lamports sống ở đây; bạn ký để chuyển.
• Tài khoản token USDC của bạn: được sở hữu bởi SPL Token Program. Lệnh transfer của token program cập nhật số dư.
• Tài khoản trạng thái pool của Raydium: được sở hữu bởi chương trình CPMM. Chỉ các lệnh của CPMM mới có thể sửa đổi dự trữ, phí, v.v.
• PersonalPositionState của NFT vị trí của Raydium: được sở hữu bởi chương trình CLMM.

​

Rent và rent-exemption

• Tài khoản rent-exempt sống mãi mãi.
• Đóng tài khoản sẽ hoàn lại lamports cho người ký đóng.

​

Chi phí rent của Raydium

​

Tài khoản dữ liệu so với tài khoản có thể thực thi

​

Tài khoản dữ liệu

​

Tài khoản có thể thực thi

​

Tài khoản dẫn xuất từ chương trình (PDA)

• PDA trạng thái pool: được dẫn xuất từ [poolTypeDiscriminator, mintA, mintB, ammConfig].
• PDA vault: được dẫn xuất từ [pool, mint].
• PDA trạng thái quan sát: được dẫn xuất từ [observationSeed, pool].

​

Giao dịch và tham chiếu tài khoản

• Các tài khoản được liệt kê có thể được đọc hoặc ghi (theo cờ is_writable của chúng).
• Các tài khoản chưa được liệt kê không thể bị chạm vào.

[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

​

Kích thước tài khoản và bố cục dữ liệu

​

Đọc trạng thái pool của Raydium

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

const accountInfo = await connection.getAccountInfo(poolId);
const data = accountInfo.data;
// Bỏ qua 8 byte đầu tiên (discriminator), sau đó phân tích cú pháp theo bố cục struct.
const poolState = CpmmPoolStateLayout.decode(data.slice(8));

​

Ví dụ thực hành: đọc tài khoản token

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. Tính toán địa chỉ ATA (dẫn xuất kiểu PDA).
const ata = getAssociatedTokenAddressSync(usdcMint, user);

// 2. Đọc tài khoản.
const accountInfo = await connection.getAccountInfo(ata);
if (!accountInfo) {
  console.log("ATA chưa tồn tại (người dùng chưa bao giờ giữ USDC).");
  return;
}

// 3. Xác minh chủ sở hữu là SPL Token program.
console.assert(accountInfo.owner.toBase58() === "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA");

// 4. Giải mã dữ liệu.
const parsed = AccountLayout.decode(accountInfo.data);
console.log("Số dư (đơn vị nhỏ nhất):", parsed.amount.toString());
console.log("Mint:",                     new PublicKey(parsed.mint).toBase58());
console.log("Chủ sở hữu:",                    new PublicKey(parsed.owner).toBase58());

​

Tại sao điều này quan trọng đối với Raydium

• Trạng thái pool là một tài khoản duy nhất — mọi thứ về một pool (mint, dự trữ, phí, admin) sống trong một tài khoản được sở hữu bởi chương trình pool.
• Token LP là tài khoản token SPL tiêu chuẩn — Raydium ủy quyền tokenization cho SPL Token program.
• Các mảng tick được chia thành các khúc — CLMM không thể có một mảng tick duy nhất có thể phát triển vì các tài khoản có kích thước được cấp phát cố định; thay vào đó, nó sử dụng các PDA TickArray được chia thành các khúc.
• Position NFT là Metaplex NFT — các vị trí CLMM là NFT tiêu chuẩn theo Metaplex; trạng thái vị trí là một PDA riêng biệt.

• “Dự trữ pool ở đâu?” → hai tài khoản vault (tài khoản token) được sở hữu bởi SPL Token program, với quyền hạn được ủy quyền cho một PDA của chương trình pool.
• “Dữ liệu tick cho CLMM ở đâu?” → một loạt các PDA TickArray, mỗi cái bao gồm 60 tick liên tiếp.
• “Cổ phần nông trại của tôi ở đâu?” → một PDA UserLedger được dẫn xuất từ [user, farmId], được sở hữu bởi chương trình nông trại.

​

Con trỏ

• solana-fundamentals/programs-and-anchor — cách các chương trình xử lý tài khoản.
• solana-fundamentals/pdas-and-cpis — dẫn xuất PDA và CPI.
• solana-fundamentals/transactions-and-fees — cách tài khoản được tham chiếu trong giao dịch.
• sdk-api/anchor-idl — bố cục tài khoản cho các chương trình của Raydium.

• Tài liệu Solana Account.
• SPL Token program — nơi các tài khoản token sống.