Busca en todas las páginas de la documentación
La extensión de Tasa de Transferencia permite a las acuñaciones de Token-2022 cobrar una comisión en cada transferencia, retenida en cuentas de token hasta que se coseche a un colector de comisiones. Permite ingresos en la cadena sin programas de transferencia personalizados.
spl-token create-token \
--program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb \
--decimals 6 \
--transfer-fee-basis-points 100 \
--transfer-fee-maximum-fee 1--transfer-fee-maximum-fee es un monto de UI, no unidades base brutas; 1 limita la comisión a un token, 1000000 la limitaría a un millón.
use anchor_spl::token_interface::{Mint, TokenAccount, TokenInterface};
// Usa ayudantes de CPI de spl-token-2022 para harvest_withheld_tokens_to_mint.
// Las transferencias en una acuñación con comisiones deben usar transfer_checked; Token-2022 rechaza
// la instrucción Transferencia no verificada en acuñaciones que llevan una tasa de transferencia.Cuándo recurrir a esto:
# Crear acuñación con 1% de comisión (100 bps) y un límite de comisión de 1 token.
# Todas las cantidades de spl-token aquí son montos de UI, no unidades base brutas.
MINT=$(spl-token create-token \
--program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb \
--decimals 6 \
--transfer-fee-basis-points 100 \
--transfer-fee-maximum-fee 1 | awk '/Creating token/{print $3}')
spl-token create-account "$MINT" --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
spl-token mint "$MINT" 10 --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
# Transferir 1 token (bruto 1_000_000) - el destinatario recibe menos; comisión retenida.
# La CLI emite TransferChecked, que es requerido en una acuñación con comisiones.
spl-token transfer "$MINT" 1 <RECIPIENT> --fund-recipient \
--program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
spl-token display <RECIPIENT_ATA> --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEbLo que esto demuestra:
maximum_feeTransferChecked, el programa mueve la porción de la comisión a un bucket retenido en las cuentas. Token-2022 rechaza la instrucción Transfer obsoleta y no verificada en una acuñación con comisiones, porque no puede verificar los decimales para las matemáticas de la comisión.HarvestWithheldTokensToMint agrega las comisiones retenidas a la acuñaciónWithdrawWithheldTokensFromMint envía las comisiones recolectadas al ATA del colector| Configuración | Ejemplo | Sobre una transferencia de 1_000_000 en bruto |
|---|---|---|
| 100 bps | 1% | 10_000 de comisión si está por debajo del máximo |
| comisión máxima | CLI --transfer-fee-maximum-fee 1 (UI) = 1_000_000 bruto | Limita la comisión a 1 token de UI (6 decimales) |
// Al construir transferencias, obtén la acuñación con las extensiones analizadas
// Muestra: cantidad, comisión estimada, neto para el destinatario
// Incluye instrucciones de cosecha en los bots de ejecución de tesoreríaharvest_withheld en un bot de mantenimiento.spl_token::instruction::* llaman a check_program_account y devuelven IncorrectProgramId para el ID de Token-2022, y Token-2022 rechaza la Transfer no verificada en acuñaciones con comisiones independientemente. Solución: bifurcar según el propietario de la acuñación, luego usar spl_token_2022::instruction::transfer_checked (o anchor_spl::token_interface, que distribuye entre ambos programas).--transfer-fee-maximum-fee y cada monto de mint/transfer son montos de UI. Solución: pasar 1, no 1000000, para un límite de un token.| Alternativa | Usar Cuándo | No Usar Cuándo |
|---|---|---|
| Hook de transferencia con comisión personalizada | Lógica de comisión compleja | La comisión simple de bps es suficiente |
| Impuesto de tesorería en tu programa | Control total en un solo programa | Transferencias de billetera estándar fuera de tu UI |
| Token Clásico + comisión fuera de la cadena | Máxima compatibilidad | Necesidad de una comisión ejecutable en la cadena |
Comisión automática deducida en transferencias de Token-2022 según la configuración de la extensión de la acuñación.
La autoridad de la tasa de transferencia retira las comisiones cosechadas a las cuentas colectoras configuradas.
1 bps = 0.01%. 100 bps = 1% de la cantidad de transferencia antes del límite máximo.
La autoridad de la tasa de transferencia puede actualizar los bps/máximo dentro de las reglas de la autoridad; documenta la gobernanza.
Normalmente solo a las transferencias; verifica la especificación de la extensión para la configuración de tu acuñación.
Ejecuta las instrucciones harvest_withheld_tokens_to_mint y luego withdraw_withheld_tokens_from_mint.
Varía; las billeteras principales están mejorando el soporte de Token-2022; prueba las billeteras de tu objetivo.
La extensión puede existir con 0 bps; es poco común; omite la extensión si no se necesita comisión.
Los swaps son transferencias; se aplican comisiones a menos que el programa del pool maneje exenciones a través de un hook.
Usa el mismo ID de programa en devnet con Surfpool 0.12.0 para iteración local.
Algunos campos son inmutables al inicio; planifica antes de la acuñación en mainnet.
Los hooks añaden lógica personalizada; la tasa de transferencia es una extensión nativa con matemáticas más simples.
Versiones de Stack: Esta página fue escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0, y LiteSVM 0.6.x.
Revisado por Chris St. John·Última actualización: 16 jul 2026