Transações e taxas

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.

​

Anatomia da transação

• Message: a lista ordenada de instruções, as contas que referenciam, e o blockhash recente.
• Signatures: uma por signatário, atestando que a transação foi autorizada.
• Recent blockhash: prova que a transação é recente; transações com blockhashes desatualizados (>150 slots antigos) são rejeitadas.

​

Instruções

• program_id — o programa a invocar.
• accounts — as contas (e suas flags de escrita/signatário) que o programa pode acessar.
• data — bytes opacos que o programa interpreta.

1. ComputeBudget::SetComputeUnitLimit — aumenta o limite padrão de CU.
2. ComputeBudget::SetComputeUnitPrice — define uma taxa de prioridade.
3. CreateAssociatedTokenAccount opcional — cria o ATA de saída se o usuário não tiver um.
4. Raydium::SwapBaseInput — executa o swap.
5. CloseAccount opcional — fecha um ATA de wrapped-SOL.

​

Contas em transações

• Signatário / não-signatário: o proprietário da conta deve assinar a transação?
• Escrita / leitura apenas: a transação pode modificar a conta?

​

Limite de tamanho de transação

​

Address Lookup Tables (ALTs)

• Uma transação referenciando 20 contas diretamente: ~640 B de pubkeys.
• A mesma transação usando ALTs: ~20 B de índices + referências ALT.

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

// SDK constrói uma tx v0 (versionada) com referências ALT
const { transaction } = await raydium.trade.swap({ /* ... */ });
// transaction é uma VersionedTransaction, não uma Legacy Transaction.

​

Orçamento de computação

• Padrão: 200.000 CU por transação.
• Máximo: 1.400.000 CU por transação (aumentado via ComputeBudget::SetComputeUnitLimit).
• Teto por bloco: 48M CU por bloco (nível de protocolo).

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

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

​

Taxas de prioridade

priority_fee = compute_unit_price (micro-lamports) × compute_unit_limit

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

​

Limites de contagem de instruções e contagem de contas

• Máx contas por transação: 128.
• Máx contas por instrução (CPI): 64.
• Máx instruções por transação: sem limite rígido, limitado apenas pelo limite de tamanho.
• Máx profundidade CPI: 4 (um programa pode chamar outro, que pode chamar outro, 4 níveis de profundidade).

​

Categorias de taxas em um swap Raydium

​

Taxas de rede Solana

• Taxa de assinatura base: 5000 lamports por assinatura. Quase sempre 1 assinatura = 0.000005 SOL.
• Taxa de prioridade: CU-price × CU-limit em microlamports. Varia com congestionamento; veja integration-guides/priority-fee-tuning.

​

Taxas de protocolo Raydium

• Taxa de swap: percentual da entrada (CPMM 0.25% típico, CLMM 0.01%–1% por tier). Dividida entre LPs e destinos de protocolo. Veja ray/protocol-fees.

​

Exemplo: $1000 USDC → SOL via CPMM tier 0.25%

​

Transações versionadas

• Legacy: o formato original, sem suporte ALT.
• v0 (Versioned): suporta ALTs, extensível para versões futuras.

// Construindo uma tx v0 diretamente
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]);

​

Atualidade do blockhash

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;
    }
  }
}

​

Execução paralela

• Dois swaps na mesma pool não podem executar em paralelo — ambos escrevem o estado da pool.
• Um swap na Pool A e um swap na Pool B executam em paralelo se listas de contas não se sobrepõem.
• Uma transação somente-leitura nunca bloqueia um escritor na mesma conta (somente-leitura é concorrente consigo mesmo mas não com escritas).

​

Níveis de confirmação de transação

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

​

Simulação

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

​

Referências

• solana-fundamentals/account-model — contas em transações.
• solana-fundamentals/pdas-and-cpis — como programas invocam um ao outro.
• integration-guides/priority-fee-tuning — dimensionando limites de CU e taxas de prioridade.
• ray/protocol-fees — estrutura de taxas de protocolo Raydium.

• Solana Transaction docs.
• Address Lookup Tables proposal.
• Compute budget documentation.