Abstração de taxas

Cada transação na Solana requer SOL para pagar as taxas de rede. Mas os utilizadores que chegam à sua aplicação de pagamento esperam transacionar em stablecoins—não gerir um segundo saldo de token. A abstração de taxas remove este atrito ao ter outra pessoa a pagar as taxas.

Este guia abrange dois níveis:

Como funciona o patrocínio de taxas — a primitiva subjacente da Solana
Abstração de taxas em escala com Kora — um serviço de abstração de taxas pronto para produção

Como funciona o patrocínio de taxas

As transações na Solana têm um pagador de taxas designado—a conta que paga a taxa de rede. Por predefinição, este é o primeiro signatário. Mas pode especificar uma conta diferente como pagador de taxas, permitindo que um terceiro (o "patrocinador") cubra as taxas em nome do remetente.

Tanto o remetente como o patrocinador devem assinar a transação:

O remetente assina para autorizar a transferência dos seus tokens
O patrocinador assina para autorizar o pagamento da taxa de rede

Consulte Como funcionam os pagamentos na Solana para conceitos fundamentais de pagamento.

Os passos abaixo mostram o fluxo principal. Consulte a Demonstração para código completo executável.

Criar uma conta de patrocinador

Gere um keypair separado para o patrocinador que pagará as taxas de transação. O patrocinador precisa de SOL para as taxas, mas não precisa de deter os tokens que estão a ser transferidos.

Criar instrução de transferência

Crie a instrução de transferência de token com o remetente como autoridade. O remetente detém os tokens e deve assinar a transferência.

Enviar com patrocinador como pagador de taxa

Crie o cliente com o patrocinador definido como pagador de taxas via payer(sponsor), em seguida, chame client.sendTransaction. O patrocinador assina para pagar a taxa de rede enquanto o remetente assina para autorizar a transferência—sendTransaction recolhe automaticamente todos os signatários referenciados.

Criar uma conta de patrocinador

Gere um keypair separado para o patrocinador que pagará as taxas de transação. O patrocinador precisa de SOL para as taxas, mas não precisa de deter os tokens que estão a ser transferidos.

Criar instrução de transferência

Crie a instrução de transferência de token com o remetente como autoridade. O remetente detém os tokens e deve assinar a transferência.

Enviar com patrocinador como pagador de taxa

Sponsor Transaction Fee

const sponsor = await generateKeyPairSigner();

Demonstração

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.

Quando você cria uma token account para um utilizador final, ele pode fechá-la e recuperar o SOL usado para rent. Considere cobrar os utilizadores pela criação de conta em stablecoins, ou incorpore este custo na economia do seu produto.