Setting Priority Fees

Defina priority fees dinâmicas usando percentis recentes da rede e SetComputeUnitPrice para que transações compitam durante congestionamento.

Receita

Cartão de receita para referência rápida - pronto para copiar e colar.

const fees = await rpc.getRecentPrioritizationFees([]).send();
fees.sort((a, b) => a.prioritizationFee - b.prioritizationFee);
const p75 = fees[Math.floor(fees.length * 0.75)]?.prioritizationFee ?? 1000;
 
// microLamports per CU in compute budget instruction
const microLamports = Math.min(p75 * 1.2, MAX_CAP);

Quando usar:

• Lançamentos e mints na mainnet com contenção.
• Serviços relayer em lote de transações de usuário.
• Carteiras auto-ajustando taxa de sucesso de envio.
• Substituindo padrões estáticos de priority fee zero.

Exemplo Prático

import { createSolanaRpc } from "@solana/kit";
 
const rpc = createSolanaRpc(process.env.RPC_URL!);
const MAX_MICRO_LAMPORTS = 500_000;
 
async function suggestPriorityFee(lockedAccounts: string[] = []) {
  const fees = await rpc
    .getRecentPrioritizationFees(
      lockedAccounts.map((a) => ({ account: a }))
    )
    .send();
 
  const samples = fees
    .map((f) => f.prioritizationFee)
    .filter((n) => n > 0)
    .sort((a, b) => a - b);
 
  if (samples.length === 0) return 1_000;
 
  const p75 = samples[Math.floor(samples.length * 0.75)];
  return Math.min(Math.ceil(p75 * 1.2), MAX_MICRO_LAMPORTS);
}
 
const microLamports = await suggestPriorityFee();
console.log("compute unit price:", microLamports);

O que isso demonstra:

• getRecentPrioritizationFees amostra fees de transações que aterrissaram.
• Alvo no percentil 75-90 equilibra custo vs sucesso.
• Teto rígido evita fees descontroladas durante picos.

Aprofundamento

Como funciona

• Priority fee = microLamports * compute_units_requested (limitado pela instrução de limite).
• Validadores ordenam transações em parte pelo lance total de priority fee.
• Base signature fee (5000 lamports) permanece separada do componente de priority.
• APIs de provedor podem retornar priorityFeeEstimate com estatísticas de percentil.

Níveis de estratégia

Notas TypeScript

// Total priority lamports ≈ (microLamports * computeUnitLimit) / 1_000_000
// Add base fee separately in UX estimates

Erros comuns

• Fee zero durante mint hype - taxa de aterrissagem quase zero. Correção: percentil dinâmico com piso.
• p99 sem teto - usuários pagam fees extremas. Correção: MAX_MICRO_LAMPORTS por política do produto.
• Amostra de fee obsoleta - mercado mudou desde o fetch. Correção: atualize por lote de envio.
• Limite alto + preço alto - multiplica priority lamports total. Correção: dimensione limite de CU primeiro.
• Ajuste de fee em devnet sem sentido - congestionamento diferente da mainnet. Correção: teste política com txs pequenas na mainnet.

Alternativas

FAQs

Relacionados

• Priority Fee & Simulation APIs - dados RPC
• Priority Fees - modelo conceitual
• Jito Bundles - tips de bundle
• Why Transactions Fail to Land - descartes subprecificados

Versões da stack: Esta página foi escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0 e LiteSVM 0.6.x.