El error de programa personalizado (Custom Program Error) 0x1 es uno of los códigos de error más comunes al interactuar con tokens SPL o aplicaciones descentralizadas en Solana. Aparece en ventanas emergentes de billeteras (como Phantom, Solflare o Backpack) y en registros de Solscan durante la emisión de tokens, creación de fondos, revocación de autoridades o transferencias.
Aunque el mensaje Program log: Error: custom program error: 0x1 suena criptico, su causa principal es muy sencilla: Fondos Insuficientes (0x1 se traduce como 0x1: InsufficientFunds en la especificación oficial del programa SPL Token de Solana).
Comprender por qué tu billetera carece de fondos suficientes a pesar de mostrar un saldo positivo de SOL te ayudará a solucionar el error y completar tu transacción.
El significado técnico del Error 0x1
En el Programa del Sistema de Solana y el Programa SPL Token, el código de error 0x1 se emite cada vez que una instrucción intenta debitar una cuenta que no posee suficiente SOL nativo para completar la operación solicitada.
De manera fundamental, en Solana una transacción requiere SOL nativo para dos fines independientes:
- Tarifas de procesamiento de transacciones: Pequeñas tarifas de red (normalmente 0.000005 SOL) pagadas a los validadores para procesar instrucciones.
- Depósitos de exención de alquiler de cuentas: Un depósito único requerido (generalmente de ~0.002 a 0.005 SOL por cuenta) necesario para inicializar nuevas cuentas (como cuentas de tokens asociadas, metadatos o bóvedas del fondo) en la memoria de los validadores.
Si tu billetera contiene 0.001 SOL, tienes suficiente SOL para la tarifa de la transacción, pero la transacción falla con 0x1 porque tu saldo no puede cubrir el depósito de exención de alquiler necesario para abrir la nueva cuenta.
La correspondencia oficial de códigos de error está documentada en la Especificación de Errores de Solana.
Escenarios comunes donde ocurre el Error 0x1
Escenario 1: Creación de un token SPL o fondo de liquidez
Al crear un token o lanzar un fondo de liquidez, la transacción inicializa múltiples cuentas nuevas simultáneamente (cuenta de emisión, cuenta de metadatos, mercado OpenBook, cuentas de bóveda). Si tu billetera carece de SOL suficiente para financiar el alquiler de todas las cuentas, la transacción atómica completa se revierte con 0x1.
Escenario 2: Transferencia de tokens a una nueva billetera
Si la billetera del destinatario no tiene una cuenta de token asociada (ATA) inicializada para el token enviado, la transacción debe crear primero la ATA. Si tu billetera carece de los ~0.002 SOL requeridos para el alquiler, la transacción falla con 0x1.
Escenario 3: Revocación de autoridades o bloqueo de liquidez
Aunque revocar una autoridad o bloquear tokens LP es una actualización de estado, las tarifas de prioridad de red, tarifas de cómputo y asignaciones temporales requieren una reserva mínima de SOL.
Paso a paso para solucionar el Custom Program Error 0x1
Sigue estos sencillos pasos para resolver el Error 0x1:
Paso 1: Comprobar el saldo de SOL nativo
Abre la extensión de tu billetera. Verifica tu saldo de SOL nativo (no SOL envuelto ni tokens SPL). Asegúrate de revisar tu saldo de SOL principal.
Paso 2: Añadir una reserva de saldo SOL
Recarga tu billetera con SOL nativo. Recomendamos mantener las siguientes reservas mínimas de SOL según la operación proyectada:
- Creación de tokens: Mantén al menos 0.02 SOL a 0.05 SOL en tu billetera.
- Creación de fondos de liquidez: Mantén al menos 0.5 SOL más la cantidad de SOL que planeas aportar.
- Revocación de autoridades: Mantén al menos 0.01 SOL en tu billetera.
- Transferencias simples de tokens: Mantén al menos 0.005 SOL en tu billetera.
Paso 3: Reintentar la transacción
Una vez recargado el saldo de SOL, actualiza la página web para obtener un bloque reciente (blockhash), vuelve a conectar tu billetera y ejecuta la transacción nuevamente.
Tabla de solución de problemas para el Error 0x1
| Operación Intentada |
Causa Raíz del Error 0x1 |
Solución Requerida |
| Emisión de Token |
Falta SOL para alquiler de metadatos y emisión |
Añadir 0.02 SOL al saldo |
| Crear Fondo Liquidez |
Falta SOL para bóvedas y tarifas del mercado DEX |
Recargar SOL para tarifas y aporte |
| Transferir Tokens |
Falta SOL para creación de ATA del destinatario |
Añadir 0.005 SOL a la billetera |
| Revocar Autoridad |
Falta SOL para tarifa de red y prioridad |
Añadir 0.01 SOL al saldo |
Mantener una reserva adecuada de SOL nativo en tu billetera evita errores 0x1 y garantiza operaciones fluidas y sin interrupciones en Solana.