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

Use prepareAndSend com ambos authority (o remetente que assina a transferência) e feePayer (o patrocinador que paga as taxas). Ambos devem assinar a transação.

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

Use prepareAndSend com ambos authority (o remetente que assina a transferência) e feePayer (o patrocinador que paga as taxas). Ambos devem assinar a transação.

Sponsor Transaction Fee

const sponsor = (await generateKeypair()).signer;

Demonstração

Demo



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

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 = getTransferInstruction({
  source: senderAta,
  destination: recipientAta,
  authority: sender, // Pass signer, not just address
  amount: 250_000n // 0.25 tokens
});

// Prepare and send transaction with sponsor as fee payer using @solana/client
// The sponsor pays transaction fees, sender signs for the transfer
const signature = await client.transaction.prepareAndSend({
  authority: sender, // Sender signs the transfer instruction
  feePayer: sponsor, // Sponsor pays the transaction fees (different account)
  instructions: [transferInstruction],
  version: 0
});

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

// Fetch final token account balances using @solana/client SPL token helper
const splToken = client.splToken({
  mint: mint.address,
  tokenProgram: "auto"
});

const senderBalance = await splToken.fetchBalance(sender.address);
const recipientBalance = await splToken.fetchBalance(recipient.address);

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

// Fetch transaction details
const transaction = await client.runtime.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 generateKeypair()).signer;
const recipient = (await generateKeypair()).signer;
const sponsor = (await generateKeypair()).signer;

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 = getTransferInstruction({
  source: senderAta,
  destination: recipientAta,
  authority: sender, // Pass signer, not just address
  amount: 250_000n // 0.25 tokens
});

// Prepare and send transaction with sponsor as fee payer using @solana/client
// The sponsor pays transaction fees, sender signs for the transfer
const signature = await client.transaction.prepareAndSend({
  authority: sender, // Sender signs the transfer instruction
  feePayer: sponsor, // Sponsor pays the transaction fees (different account)
  instructions: [transferInstruction],
  version: 0
});

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

// Fetch final token account balances using @solana/client SPL token helper
const splToken = client.splToken({
  mint: mint.address,
  tokenProgram: "auto"
});

const senderBalance = await splToken.fetchBalance(sender.address);
const recipientBalance = await splToken.fetchBalance(recipient.address);

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

// Fetch transaction details
const transaction = await client.runtime.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.