Abstracción de tarifas

Cada transacción de Solana requiere SOL para pagar las tarifas de red. Pero los usuarios que llegan a tu aplicación de pagos esperan realizar transacciones en stablecoins, no gestionar un segundo saldo de tokens. La abstracción de tarifas elimina esta fricción al hacer que otra persona pague las tarifas.

Esta guía cubre dos niveles:

Cómo funciona el patrocinio de tarifas — el primitivo subyacente de Solana
Abstracción de tarifas a escala con Kora — un servicio de abstracción de tarifas listo para producción

Cómo funciona el patrocinio de tarifas

Las transacciones de Solana tienen un pagador de tarifas designado: la cuenta que paga la tarifa de red. Por defecto, este es el primer firmante. Pero puedes especificar una cuenta diferente como pagador de tarifas, permitiendo que un tercero (el "patrocinador") cubra las tarifas en nombre del remitente.

Tanto el remitente como el patrocinador deben firmar la transacción:

El remitente firma para autorizar la transferencia de sus tokens
El patrocinador firma para autorizar el pago de la tarifa de red

Consulta Cómo funcionan los pagos en Solana para conocer los conceptos básicos de pagos.

Los pasos a continuación muestran el flujo principal. Consulta la Demo para ver el código completo ejecutable.

Crear una cuenta de patrocinador

Genera un keypair separado para el patrocinador que pagará las tarifas de transacción. El patrocinador necesita SOL para las tarifas pero no necesita mantener los tokens que se están transfiriendo.

Crear instrucción de transferencia

Crea la instrucción de transferencia de tokens con el remitente como autoridad. El remitente posee los tokens y debe firmar la transferencia.

Enviar con patrocinador como pagador de tarifas

Crea el cliente con el patrocinador configurado como pagador de comisiones mediante payer(sponsor), luego llama a client.sendTransaction. El patrocinador firma para pagar la comisión de red mientras que el remitente firma para autorizar la transferencia—sendTransaction recopila automáticamente cada firmante referenciado.

Crear una cuenta de patrocinador

Crear instrucción de transferencia

Crea la instrucción de transferencia de tokens con el remitente como autoridad. El remitente posee los tokens y debe firmar la transferencia.

Enviar con patrocinador como pagador de tarifas

Sponsor Transaction Fee

const sponsor = await generateKeyPairSigner();

Demo



// Generate keypairs for sender, recipient, and sponsor (fee payer)
const sender = await generateKeyPairSigner();
const recipient = await generateKeyPairSigner();
const sponsor = await generateKeyPairSigner();

console.log("Sender Address:", sender.address);
console.log("Recipient Address:", recipient.address);
console.log("Sponsor Address (Fee Payer):", sponsor.address);

// Demo Setup: Create client, mint account, token accounts, and fund with initial tokens
const { client, mint } = await demoSetup(sender, recipient, sponsor);

console.log("\nMint Address:", mint.address);

// Derive the Associated Token Accounts addresses (ATAs) for sender and recipient
const [senderAta] = await findAssociatedTokenPda({
  mint: mint.address,
  owner: sender.address,
  tokenProgram: TOKEN_2022_PROGRAM_ADDRESS
});

const [recipientAta] = await findAssociatedTokenPda({
  mint: mint.address,
  owner: recipient.address,
  tokenProgram: TOKEN_2022_PROGRAM_ADDRESS
});

console.log("Sender Token Account:", senderAta.toString());
console.log("Recipient Token Account:", recipientAta.toString());

// =============================================================================
// Sponsored Token Payment Demo
// =============================================================================

// Create instruction to transfer tokens from sender to recipient
// Transferring 250,000 base units = 0.25 tokens (with 6 decimals)
const transferInstruction = getTransferCheckedInstruction({
  source: senderAta,
  mint: mint.address,
  destination: recipientAta,
  authority: sender, // Sender signs to authorize the transfer
  amount: 250_000n, // 0.25 tokens
  decimals: 6
});

// Send transaction with sponsor as fee payer using @solana/kit
// The sponsor (client.payer) pays fees; the sender signs for the transfer
const { context } = await client.sendTransaction([transferInstruction]);
const signature = context.signature;

console.log("\n=== Sponsored Token Payment Complete ===");
console.log("Transaction Signature:", signature.toString());

// Fetch final token account balances from the RPC
const senderBalance = await client.rpc.getTokenAccountBalance(senderAta).send();
const recipientBalance = await client.rpc
  .getTokenAccountBalance(recipientAta)
  .send();

console.log("\nSender Token Account Balance:", senderBalance.value.uiAmount);
console.log(
  "Recipient Token Account Balance:",
  recipientBalance.value.uiAmount
);

// Fetch transaction details
const transaction = await client.rpc
  .getTransaction(signature, {
    encoding: "jsonParsed",
    maxSupportedTransactionVersion: 0
  })
  .send();

const feePayer = transaction?.transaction.message.accountKeys?.[0];
console.log("\nNote: The first account in accountKeys is always the fee payer");
console.log("Fee Payer Address:", feePayer);

// =============================================================================
// Demo Setup Helper Function
// =============================================================================

Console

Click to execute the code.

Demo



// Generate keypairs for sender, recipient, and sponsor (fee payer)
const sender = await generateKeyPairSigner();
const recipient = await generateKeyPairSigner();
const sponsor = await generateKeyPairSigner();

console.log("Sender Address:", sender.address);
console.log("Recipient Address:", recipient.address);
console.log("Sponsor Address (Fee Payer):", sponsor.address);

// Demo Setup: Create client, mint account, token accounts, and fund with initial tokens
const { client, mint } = await demoSetup(sender, recipient, sponsor);

console.log("\nMint Address:", mint.address);

// Derive the Associated Token Accounts addresses (ATAs) for sender and recipient
const [senderAta] = await findAssociatedTokenPda({
  mint: mint.address,
  owner: sender.address,
  tokenProgram: TOKEN_2022_PROGRAM_ADDRESS
});

const [recipientAta] = await findAssociatedTokenPda({
  mint: mint.address,
  owner: recipient.address,
  tokenProgram: TOKEN_2022_PROGRAM_ADDRESS
});

console.log("Sender Token Account:", senderAta.toString());
console.log("Recipient Token Account:", recipientAta.toString());

// =============================================================================
// Sponsored Token Payment Demo
// =============================================================================

// Create instruction to transfer tokens from sender to recipient
// Transferring 250,000 base units = 0.25 tokens (with 6 decimals)
const transferInstruction = getTransferCheckedInstruction({
  source: senderAta,
  mint: mint.address,
  destination: recipientAta,
  authority: sender, // Sender signs to authorize the transfer
  amount: 250_000n, // 0.25 tokens
  decimals: 6
});

// Send transaction with sponsor as fee payer using @solana/kit
// The sponsor (client.payer) pays fees; the sender signs for the transfer
const { context } = await client.sendTransaction([transferInstruction]);
const signature = context.signature;

console.log("\n=== Sponsored Token Payment Complete ===");
console.log("Transaction Signature:", signature.toString());

// Fetch final token account balances from the RPC
const senderBalance = await client.rpc.getTokenAccountBalance(senderAta).send();
const recipientBalance = await client.rpc
  .getTokenAccountBalance(recipientAta)
  .send();

console.log("\nSender Token Account Balance:", senderBalance.value.uiAmount);
console.log(
  "Recipient Token Account Balance:",
  recipientBalance.value.uiAmount
);

// Fetch transaction details
const transaction = await client.rpc
  .getTransaction(signature, {
    encoding: "jsonParsed",
    maxSupportedTransactionVersion: 0
  })
  .send();

const feePayer = transaction?.transaction.message.accountKeys?.[0];
console.log("\nNote: The first account in accountKeys is always the fee payer");
console.log("Fee Payer Address:", feePayer);

// =============================================================================
// Demo Setup Helper Function
// =============================================================================

Console

Click to execute the code.

Cuando creas una token account para un usuario final, este puede cerrarla y recuperar el SOL utilizado para rent. Considera cobrar a los usuarios por la creación de cuentas en stablecoins, o incluye este costo en la economía de tu producto.