Abstraction des frais

Chaque transaction Solana nécessite du SOL pour payer les frais de réseau. Mais les utilisateurs qui viennent sur votre application de paiement s'attendent à effectuer des transactions en stablecoins, et non à gérer un solde de second jeton. L'abstraction des frais élimine cette friction en permettant à quelqu'un d'autre de payer les frais.

Ce guide couvre deux niveaux :

Comment fonctionne le parrainage des frais — la primitive Solana sous-jacente
Abstraction des frais à grande échelle avec Kora — un service d'abstraction des frais prêt pour la production

Comment fonctionne le parrainage des frais

Les transactions Solana ont un payeur de frais désigné, c'est-à-dire le compte qui paie les frais de réseau. Par défaut, il s'agit du premier signataire. Mais vous pouvez spécifier un compte différent comme payeur de frais, permettant à un tiers (le « parrain ») de couvrir les frais au nom de l'expéditeur.

L'expéditeur et le parrain doivent tous deux signer la transaction :

L'expéditeur signe pour autoriser le transfert de ses jetons
Le parrain signe pour autoriser le paiement des frais de réseau

Consultez Comment fonctionnent les paiements sur Solana pour les concepts de paiement de base.

Les étapes ci-dessous montrent le flux principal. Consultez la Démo pour le code complet exécutable.

Créer un compte parrain

Générez une paire de clés distincte pour le parrain qui paiera les frais de transaction. Le parrain a besoin de SOL pour les frais mais n'a pas besoin de détenir les jetons transférés.

Créer l'instruction de transfert

Créez l'instruction de transfert de jetons avec l'expéditeur comme autorité. L'expéditeur possède les jetons et doit signer le transfert.

Envoyer avec un sponsor comme payeur de frais

Utilisez prepareAndSend avec à la fois authority (l'expéditeur qui signe le transfert) et feePayer (le sponsor qui paie les frais). Les deux doivent signer la transaction.

Créer un compte parrain

Générez une paire de clés distincte pour le parrain qui paiera les frais de transaction. Le parrain a besoin de SOL pour les frais mais n'a pas besoin de détenir les jetons transférés.

Créer l'instruction de transfert

Créez l'instruction de transfert de jetons avec l'expéditeur comme autorité. L'expéditeur possède les jetons et doit signer le transfert.

Envoyer avec un sponsor comme payeur de frais

Utilisez prepareAndSend avec à la fois authority (l'expéditeur qui signe le transfert) et feePayer (le sponsor qui paie les frais). Les deux doivent signer la transaction.

Sponsor Transaction Fee

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

Démo

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.

Lorsque vous créez un token account pour un utilisateur final, il peut le fermer et récupérer les SOL utilisés pour le rent. Envisagez de facturer les utilisateurs pour la création de compte en stablecoins, ou intégrez ce coût dans l'économie de votre produit.