CLI spl-token

Crea acuñaciones (mints) de SPL Token, cuentas de token asociadas (ATAs), acuña tokens y transfiere saldos desde la terminal.

Receta

Tarjeta de receta de referencia rápida - lista para copiar y pegar.

spl-token create-token
spl-token create-account <MINT>
spl-token mint <MINT> 1000
spl-token transfer <MINT> 50 <RECIPIENT_TOKEN_ACCOUNT>

Cuándo recurrir a esto:

• Poner en marcha una acuñación de prueba en devnet antes de la integración del cliente.
• Financiar billeteras de prueba con tokens simulados.
• Verificar la derivación de ATA y los decimales sin TypeScript.
• Transferencias manuales del tesoro de tokens SPL.

Ejemplo de trabajo

solana config set --url devnet
solana airdrop 2
 
# Crear acuñación con 6 decimales (común para tokens fungibles)
MINT=$(spl-token create-token --decimals 6 | grep "Creating token" | awk '{print $3}')
echo "Mint: $MINT"
 
# Crear ATA para tu billetera
spl-token create-account "$MINT"
ATA=$(spl-token accounts --token "$MINT" | grep -v "Token accounts" | awk '{print $1}')
echo "ATA: $ATA"
 
# Acuñar 1.0 token. La CLI toma cantidades de UI y escala por los decimales de la acuñación,
# por lo que esto es `1`, NO 1000000. Pasar 1000000 aquí acuñaría un millón de tokens.
spl-token mint "$MINT" 1
 
spl-token balance "$MINT"
spl-token supply "$MINT"

Lo que esto demuestra:

• create-token inicializa una nueva acuñación con los decimales elegidos.
• create-account crea la ATA propiedad de tu billetera para esa acuñación.
• mint aumenta el suministro cuando tu par de claves tiene la autoridad de acuñación.

Análisis Profundo

Cómo funciona

• El programa SPL Token posee las cuentas de acuñación y de token con estado codificado en Borsh.
• Las ATAs son PDAs derivadas de la billetera + acuñación para direcciones deterministas.
• Las cantidades en la CLI spl-token son cantidades de UI; aplica los decimales de la acuñación por ti. Las unidades base brutas solo aparecen en los datos de la instrucción.
• Las autoridades de acuñación y congelación pueden ser revocadas después de la configuración.

Comandos Comunes

Notas de bash

# Transferir a la clave pública de la billetera (la CLI resuelve la ATA)
spl-token transfer "$MINT" 100 <RECIPIENT_WALLET_PUBKEY> --fund-recipient
 
# Revocar la autoridad de acuñación (suministro fijo)
spl-token authorize "$MINT" mint --disable

Errores comunes

• Confusión de decimales - spl-token mint <MINT> 1000 acuña 1000 tokens, no 0.001. La CLI toma cantidades de UI. Solución: pasa la cantidad humana directamente; nunca multipliques previamente por 10^decimales para la CLI. Multiplica solo cuando construyas los datos de la instrucción tú mismo.
• ATA faltante - la transferencia falla si el destinatario no tiene una cuenta de token. Solución: usa --fund-recipient o create-account primero.
• Autoridad de acuñación incorrecta - solo el par de claves de autoridad puede acuñar. Solución: usa spl-token display para ver las autoridades.
• Usar solana transfer para tokens - mueve SOL, no saldos de SPL. Solución: siempre usa spl-token transfer.
• Cuentas congeladas - la autoridad de congelación puede bloquear transferencias. Solución: verifica el estado de congelación con display.

Alternativas

Preguntas frecuentes

Relacionado

• Airdrops y Saldos - SOL para tarifas y alquiler
• Inspeccionar Cuentas y Programas - bytes de cuenta brutos
• Conceptos básicos de SPL Token - modelo de token on-chain
• Enviar SOL y Transacciones - transferencias de SOL nativas

Versiones de la pila: 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.