Модель аккаунтов

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 — устаревшее поле для сбора rent (игнорируется с тех пор, как rent-exemption стал обязательным).

​

Владение

• Ваш кошелёк пользователя: принадлежит System Program. Lamports хранятся здесь; вы подписываете для перевода.
• Ваш аккаунт токена USDC: принадлежит SPL Token Program. Инструкция transfer программы токенов обновляет баланс.
• Аккаунт состояния пула Raydium: принадлежит программе CPMM. Только инструкции CPMM могут изменять резервы, комиссии и т. д.
• PersonalPositionState NFT позиции Raydium: принадлежит программе CLMM.

​

Rent и rent-exemption

• Аккаунт, освобождённый от rent, существует вечно.
• Закрытие аккаунта возвращает lamports подписавшему инструкцию.

​

Стоимость rent в Raydium

​

Data-аккаунты и executable-аккаунты

​

Data-аккаунты

​

Executable-аккаунты

​

Program-derived accounts (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 байт (дискриминатор), затем распарсить согласно структуре 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. Вычислить адрес ATA (выведение стиля PDA).
const ata = getAssociatedTokenAddressSync(usdcMint, user);

// 2. Прочитать аккаунт.
const accountInfo = await connection.getAccountInfo(ata);
if (!accountInfo) {
  console.log("ATA ещё не существует (пользователь никогда не держал USDC).");
  return;
}

// 3. Проверить, что владелец — SPL Token program.
console.assert(accountInfo.owner.toBase58() === "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA");

// 4. Декодировать данные.
const parsed = AccountLayout.decode(accountInfo.data);
console.log("Баланс (наименьшие единицы):", parsed.amount.toString());
console.log("Mint:",                        new PublicKey(parsed.mint).toBase58());
console.log("Владелец:",                    new PublicKey(parsed.owner).toBase58());

​

Почему это важно для Raydium

• Состояние пула — это один аккаунт — всё о пуле (mints, резервы, комиссии, admin) живёт в одном аккаунте, принадлежащем программе пула.
• LP-токены — это стандартные аккаунты SPL токенов — Raydium делегирует токенизацию программе SPL Token.
• Tick arrays разбиты на части — CLMM не может иметь один растущий массив ticks, потому что аккаунты имеют фиксированный выделенный размер; вместо этого она использует разбитые на части PDA TickArray.
• NFT позиций — это Metaplex NFT — позиции CLMM — это стандартные NFT по Metaplex; состояние позиции — это отдельный PDA.

• “Где резервы пула?” → два аккаунта хранилищ (token accounts), принадлежащие SPL Token program, с полномочиями делегированы PDA программы пула.
• “Где данные ticks для CLMM?” → серия TickArray PDA, каждая охватывающая 60 последовательных ticks.
• “Где моя ставка фермы?” → PDA UserLedger, выведённая из [user, farmId], принадлежащая программе фермы.

​

Ссылки

• solana-fundamentals/programs-and-anchor — как программы обрабатывают аккаунты.
• solana-fundamentals/pdas-and-cpis — выведение PDA и CPI.
• solana-fundamentals/transactions-and-fees — как аккаунты ссылаются в транзакциях.
• sdk-api/anchor-idl — layouts аккаунтов для программ Raydium.

• Solana Account docs.
• SPL Token program — где живут token accounts.