Delegación Fija

Una delegación fija permite que un usuario apruebe a otra billetera o servicio para retirar hasta una cantidad fija de tokens. Cada transferencia exitosa reduce la asignación restante. Use expiryTs = 0 para que no expire.

Esta guía mantiene el flujo visible. Cada fragmento utiliza las funciones del SDK directamente para que puedas ver qué cuenta se deriva, qué instrucción se envía y qué firmante paga o autoriza cada paso.

Instalación

pnpm add @solana/subscriptions @solana/kit @solana/kit-plugin-rpc @solana/kit-plugin-signer @solana-program/token

Crear La Delegación

La configuración tiene cuatro partes:

Crear un cliente con el firmante del usuario y el plugin de suscripciones.
Derivar el token account del usuario y el PDA de la Autoridad de Suscripción.
Inicializar la Autoridad de Suscripción si aún no existe.
Crear la delegación fija y derivar su PDA para transferencias posteriores.

import { address, createClient } from '@solana/kit';
import { solanaLocalRpc } from '@solana/kit-plugin-rpc';
import { signer } from '@solana/kit-plugin-signer';
import { findAssociatedTokenPda, TOKEN_PROGRAM_ADDRESS } from '@solana-program/token';
import {
  fetchMaybeSubscriptionAuthority,
  findFixedDelegationPda,
  findSubscriptionAuthorityPda,
  subscriptionsProgram,
} from '@solana/subscriptions';

const client = createClient()
  .use(signer(userSigner))
  .use(solanaLocalRpc({ rpcUrl: 'http://127.0.0.1:8899' }))
  .use(subscriptionsProgram());

const tokenMint = address('TOKEN_MINT_ADDRESS_HERE');
const delegatee = address('DELEGATEE_WALLET_ADDRESS_HERE');
const nonce = 0n;
const amount = 1_000_000n;
const expiryTs = BigInt(Math.floor(Date.now() / 1000) + 60 * 60 * 24 * 30);

const [userAta] = await findAssociatedTokenPda({
  mint: tokenMint,
  owner: userSigner.address,
  tokenProgram: TOKEN_PROGRAM_ADDRESS,
});

const [subscriptionAuthorityPda] = await findSubscriptionAuthorityPda({
  user: userSigner.address,
  tokenMint,
});

const subscriptionAuthority = await fetchMaybeSubscriptionAuthority(
  client.rpc,
  subscriptionAuthorityPda,
);

if (!subscriptionAuthority.exists) {
  await client.subscriptions.instructions
    .initSubscriptionAuthority({
      tokenMint,
      tokenProgram: TOKEN_PROGRAM_ADDRESS,
      userAta,
    })
    .sendTransaction();
}

await client.subscriptions.instructions
  .createFixedDelegation({
    tokenMint,
    delegatee,
    nonce,
    amount,
    expiryTs,
  })
  .sendTransaction();

const [delegationPda] = await findFixedDelegationPda({
  subscriptionAuthority: subscriptionAuthorityPda,
  delegator: userSigner.address,
  delegatee,
  nonce,
});

Transferir Desde La Delegación

El delegatario firma la transferencia. El SDK necesita el mismo PDA de delegación, el token account del usuario y el token account del receptor.

const receiverAta = address('RECEIVER_TOKEN_ACCOUNT_ADDRESS_HERE');

await client.subscriptions.instructions
  .transferFixed({
    delegatee: delegateeSigner,
    delegator: userSigner.address,
    delegatorAta: userAta,
    tokenMint,
    delegationPda,
    amount: 100_000n,
    receiverAta,
    tokenProgram: TOKEN_PROGRAM_ADDRESS,
  })
  .sendTransaction();

Revocar la delegación

El delegante puede revocar la delegación en cualquier momento. Al revocar, se cierra el PDA de delegación y se devuelve su rent al firmante.

await client.subscriptions.instructions
  .revokeDelegation({
    authority: userSigner,
    delegationAccount: delegationPda,
  })
  .sendTransaction();

Notas

La token account del usuario debe existir antes de la inicialización.
Las cantidades están en unidades base. Para un token de 6 decimales, 1_000_000 significa 1 token.
Ejecutar initSubscriptionAuthority solo cuando la cuenta de Subscription Authority aún no exista.
El usuario firma las transacciones de configuración y revocación. El delegatario firma las transferencias.