Транзакции и комиссии

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.

​

Анатомия транзакции

• Message: упорядоченный список инструкций, аккаунты, на которые они ссылаются, и свежий блокхеш.
• Signatures: по одной для каждого подписанта, подтверждающие авторизацию транзакции.
• Recent blockhash: доказывает, что транзакция свежая; транзакции с устаревшими блокхешами (старше 150 слотов) отклоняются.

​

Инструкции

• program_id — программу для вызова.
• accounts — аккаунты (и их флаги записываемости/подписанта), которые может задействовать программа.
• data — непрозрачные байты, которые программа интерпретирует.

1. ComputeBudget::SetComputeUnitLimit — увеличение лимита CU по умолчанию.
2. ComputeBudget::SetComputeUnitPrice — установка приоритетной комиссии.
3. Опционально CreateAssociatedTokenAccount — создание выходного ATA, если у пользователя его нет.
4. Raydium::SwapBaseInput — выполнение своппа.
5. Опционально CloseAccount — закрытие обёрнутого SOL ATA.

​

Аккаунты в транзакциях

• Подписант / не подписант: должен ли владелец аккаунта подписать транзакцию?
• Записываемый / только для чтения: может ли транзакция изменять аккаунт?

​

Лимит размера транзакции

​

Таблицы поиска адресов (ALTs)

• Транзакция со ссылками на 20 аккаунтов напрямую: ~640 Б публичных ключей.
• Та же транзакция с использованием ALT: ~20 Б индексов + ссылки на ALT.

import { VersionedTransaction } from "@solana/web3.js";

// SDK строит v0 (versioned) tx со ссылками на ALT
const { transaction } = await raydium.trade.swap({ /* ... */ });
// transaction это VersionedTransaction, не legacy Transaction.

​

Бюджет вычислений

• По умолчанию: 200 000 CU за транзакцию.
• Максимум: 1 400 000 CU за транзакцию (повышено через ComputeBudget::SetComputeUnitLimit).
• Лимит на блок: 48M CU на блок (уровень протокола).

import { ComputeBudgetProgram } from "@solana/web3.js";

tx.add(
  ComputeBudgetProgram.setComputeUnitLimit({ units: 300_000 }),
);

​

Приоритетные комиссии

priority_fee = compute_unit_price (micro-lamports) × compute_unit_limit

tx.add(
  ComputeBudgetProgram.setComputeUnitPrice({ microLamports: 10_000 }),
);

​

Лимиты количества инструкций и аккаунтов

• Макс аккаунтов за транзакцию: 128.
• Макс аккаунтов за инструкцию (CPI): 64.
• Макс инструкций за транзакцию: жёсткого лимита нет, ограничен только лимитом размера.
• Макс глубина CPI: 4 (программа может вызвать другую, которая может вызвать другую, 4 уровня глубины).

​

Категории комиссий в своппе Raydium

​

Сетевые комиссии Solana

• Базовая комиссия подписи: 5000 lamports за подпись. Почти всегда 1 подпись = 0.000005 SOL.
• Приоритетная комиссия: CU-price × CU-limit в микролампортах. Варьируется с перегрузкой; см. integration-guides/priority-fee-tuning.

​

Комиссии протокола Raydium

• Комиссия своппа: процент от входа (CPMM 0.25% типично, CLMM 0.01%–1% на уровень). Делится между LP и протоколом. См. ray/protocol-fees.

​

Пример: $1000 USDC → SOL через CPMM 0.25% уровень

​

Versioned транзакции

• Legacy: оригинальный формат, нет поддержки ALT.
• v0 (Versioned): поддерживает ALT, расширяемый для будущих версий.

// Построение v0 tx напрямую
import { VersionedTransaction, TransactionMessage } from "@solana/web3.js";

const msg = new TransactionMessage({
  payerKey:        owner.publicKey,
  recentBlockhash: blockhash,
  instructions:    [ /* ... */ ],
}).compileToV0Message([lookupTableAccount]);

const tx = new VersionedTransaction(msg);
tx.sign([owner]);

​

Свежесть блокхеша

async function sendWithRetry(tx, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash();
    tx.message.recentBlockhash = blockhash;
    tx.sign([owner]);
    try {
      return await connection.sendRawTransaction(tx.serialize());
    } catch (e) {
      if (i === maxRetries - 1) throw e;
    }
  }
}

​

Параллельное исполнение

• Два своппа на одном пуле не могут исполняться параллельно — оба записывают состояние пула.
• Своп на Пуле A и своп на Пуле B исполняются параллельно, если списки аккаунтов не перекрываются.
• Только-для-чтения транзакция никогда не блокирует писателя на том же аккаунте (только-для-чтения конкурирует с собой, но не с записями).

​

Уровни подтверждения транзакции

await connection.sendAndConfirmTransaction(tx, [owner], {
  commitment: "confirmed",
});

​

Симуляция

const sim = await connection.simulateTransaction(tx);
console.log(sim.value.logs);
console.log(sim.value.unitsConsumed);

​

Указатели

• solana-fundamentals/account-model — аккаунты в транзакциях.
• solana-fundamentals/pdas-and-cpis — как программы вызывают друг друга.
• integration-guides/priority-fee-tuning — размер лимитов CU и приоритетных комиссий.
• ray/protocol-fees — структура комиссий протокола Raydium.

• Документация Solana Transaction.
• Предложение Address Lookup Tables.
• Документация Compute budget.