Cuando una transacción de token en Solana falla durante la emisión, la revocación de autoridades o la creación de un fondo de liquidez, el fallo se debe a un error de ejecución específico evaluado por la red. Las transacciones en Solana se ejecutan de forma atómica: si una sola instrucción dentro de la transacción encuentra un error, la transacción completa se revierte, no se aplican cambios de estado y solo se consume la tarifa de red.
Diagnosticar transacciones fallidas requiere revisar los saldos de SOL en la billetera, el estado de los nodos RPC de la red, los requisitos de inicialización de cuentas y los registros del programa en un explorador de Solana.
Cómo funciona el ciclo de vida de una transacción en Solana
Para entender por qué se cancela o revierte una transacción, considera cómo viajan las instrucciones por la red:
- Construcción: Una herramienta crea una transacción que contiene instrucciones (como
InitializeMint o CreateAccount) y adjunta un bloquehash reciente de la red.
- Firma: Tu billetera firma la transacción con la clave privada de la dirección de autoridad requerida.
- Emisión: La transacción firmada se envía a un nodo RPC (Remote Procedure Call) de Solana.
- Validación: El validador líder evalúa las instrucciones respecto al estado actual del libro mayor.
- Ejecución o Reversión: Si es válida, los cambios de estado se confirman en un bloque. Si no es válida, la transacción se revierte y registra un código de error.
La documentación oficial sobre transacciones en Solana detalla los límites de transacciones, la expiración de bloquehash y el procesamiento de instrucciones.
Error 1: SOL insuficiente para la exención de alquiler de la cuenta
La causa más frecuente de fallo en la creación de un token es que el saldo de la billetera es demasiado bajo para cubrir la exención de alquiler de la cuenta.
En Solana, cada cuenta nueva (como una cuenta de emisión, cuenta de metadatos o cuenta de token asociada) debe mantener un saldo mínimo de SOL nativo para permanecer almacenada de forma permanente en la memoria de los validadores. Este requisito se denomina exención de alquiler (rent exemption).
Distingue entre dos costes independientes:
- Tarifa de transacción de la red: Una pequeña tarifa (habitualmente 0,000005 SOL) pagada a los validadores por procesar la transacción.
- Depósito de exención de alquiler: Un depósito único requerido para abrir una cuenta nueva (habitualmente entre 0,002 y 0,005 SOL por cuenta creada).
Si tu billetera contiene exactamente 0,001 SOL, tienes suficiente para la tarifa de transacción, pero la transacción fallará porque no dispone de suficiente SOL para pagar el alquiler de la nueva cuenta. Mantén siempre al menos entre 0,02 y 0,05 SOL nativo en tu billetera antes de crear tokens o fondos de liquidez.
Error 2: Congestión en nodos RPC y expiración de bloquehash
Cada transacción en Solana incluye un bloquehash reciente para evitar ataques de repetición. Un bloquehash permanece válido durante unos 150 bloques de red (aproximadamente entre 60 y 90 segundos).
Si la red Solana experimenta un tráfico elevado o el nodo RPC tarda en emitir la transacción:
- La transacción puede quedar en la cola del RPC hasta que su bloquehash expira.
- Transcurridos los 150 bloques, los validadores rechazan la transacción con un error
BlockhashNotFound o TransactionExpired.
- La interfaz de tu billetera puede mostrar un mensaje genérico de “Tiempo de espera agotado”.
Para resolver los tiempos de espera RPC:
- Recarga la página web para obtener un bloquehash actualizado.
- Comprueba el estado de la red para verificar si hay congestión.
- Utiliza una plataforma de lanzamiento fiable con nodos RPC de alta disponibilidad.
- Incrementa ligeramente las tarifas de prioridad si el tráfico de la red es elevado.
Error 3: Cuenta de token asociada (ATA) no inicializada
Al emitir tokens o transferir suministro a un destinatario, la dirección de destino debe poseer una cuenta de token asociada (ATA) inicializada para esa emisión específica.
Si una transacción intenta transferir tokens a una dirección de billetera directa sin ejecutar primero una instrucción CreateAssociatedTokenAccount, la instrucción de transferencia falla con el error AccountDoesNotExist.
Las herramientas guiadas incluyen automáticamente la instrucción de creación de la cuenta ATA junto con la instrucción de emisión para evitar este fallo.
Error 4: Discrepancia de autoridad y rechazos de firma
Una transacción se revertirá si la firma proviene de una billetera que no posee actualmente la autoridad requerida para la operación:
- Error de emisión: Intentar emitir suministro adicional usando una billetera que no es la autoridad de emisión actual (o tras haberla revocado).
- Error de congelación: Intentar congelar una cuenta usando una billetera que no posee la autoridad de congelación.
- Error de metadatos: Intentar actualizar los metadatos usando una billetera que no es la autoridad de actualización.
Si conectaste una billetera secundaria o transferiste anteriormente una clave de autoridad a otra dirección, la red rechazará la transacción por falta de la firma requerida.
Cómo diagnosticar transacciones fallidas en Solscan
Cuando ocurra un error, utiliza Solscan para consultar el registro del programa:
- Abre el historial de transacciones de tu billetera y copia el código de firma (hash) de la transacción fallida.
- Pega la firma en Solscan.
- Revisa el indicador de estado en la parte superior (marcado como Failed o Instruction Error).
- Desplázate hacia abajo hasta la sección Program Logs.
- Examina los registros en busca de códigos de error explícitos:
custom program error: 0x1 (Fondos insuficientes en SOL para el alquiler o transferencia).BlockhashNotFound (La transacción tardó demasiado en emitirse).ConstraintRaw o InvalidAccountData (Discrepancia de clave de autoridad o cuenta no inicializada).
Cuadro rápido de resolución de problemas
Utiliza esta lista de comprobación cuando falle una transacción de token:
| Síntoma / Mensaje de error |
Causa principal |
Solución |
| Transaction Failed: Custom Error 0x1 |
La billetera no tiene suficiente SOL nativo para el alquiler. |
Añade al menos 0,02 SOL nativo a tu billetera y reintenta. |
| Blockhash Not Found / Timed Out |
Congestión RPC o emisión retrasada. |
Recarga la página para obtener un bloquehash nuevo y reenvía. |
| Account Does Not Exist |
La cuenta ATA de destino no se ha creado aún. |
Asegúrate de que la transacción incluye la instrucción de creación de ATA. |
| Signature Verification Failed |
La billetera conectada no es la autoridad actual. |
Cambia a la dirección de billetera exacta que posee la clave requerida. |
| El cuadro de la billetera se cierra solo |
Conflicto de extensiones o bloqueo del navegador. |
Desbloquea la billetera manualmente, desactiva extensiones y reintenta. |
Comprender la mecánica de las transacciones, mantener suficiente SOL para la exención de alquiler y revisar los registros en Solscan garantiza operaciones de tokens fluidas y sin errores en Solana.