Le code d’erreur personnalisé 0x1 (Custom Program Error 0x1) est l’un des problèmes les plus fréquents lors de l’interaction avec des tokens SPL ou des applications décentralisées sur Solana. Il apparaît dans les fenêtres contextuelles des portefeuilles (comme Phantom, Solflare ou Backpack) et dans les journaux Solscan lors de la création de tokens, de pools de liquidité, de révocations d’autorités ou de transferts.
Bien que le message Program log: Error: custom program error: 0x1 paraisse complexe, sa cause est très simple : Fonds Insuffisants (0x1 correspond à 0x1: InsufficientFunds dans la spécification officielle du programme SPL Token de Solana).
Comprendre pourquoi votre portefeuille manque de SOL malgré un solde positif vous permettra de résoudre cette erreur et de finaliser votre transaction.
La signification technique de l’Erreur 0x1
Dans le programme système Solana et le programme SPL Token, le code d’erreur 0x1 est renvoyé chaque fois qu’une instruction tente de débiter un compte qui ne dispose pas de suffisamment de SOL natif pour exécuter l’opération demandée.
Sur Solana, une transaction requiert du SOL natif pour deux raisons distinctes :
- Frais de traitement des transactions : De faibles frais de réseau (généralement 0.000005 SOL) versés aux validateurs pour le traitement des instructions.
- Dépôts d’exonération de loyer des comptes : Un dépôt unique obligatoire (généralement de ~0.002 à 0.005 SOL par compte) nécessaire pour initialiser de nouveaux comptes (comme les comptes Associated Token, les métadonnées ou les coffres-forts de pools) dans la mémoire des validateurs.
Si votre portefeuille contient 0.001 SOL, vous disposez de suffisamment de SOL pour les frais de transaction, mais l’opération échoue avec l’erreur 0x1 car votre solde ne peut pas couvrir le dépôt d’exonération de loyer nécessaire pour ouvrir le nouveau compte.
La correspondance officielle des codes d’erreur est documentée dans les Spécifications des Erreurs Solana.
Scénarios fréquents d’apparition de l’Erreur 0x1
Scénario 1 : Création d’un token SPL ou d’un pool de liquidité
Lors de la création d’un token ou d’un pool de liquidité, la transaction initialise plusieurs nouveaux comptes simultanément (compte de Mint, compte de métadonnées, marché OpenBook, comptes de réserve). Si votre portefeuille manque de SOL pour payer le loyer de l’ensemble de ces comptes, la transaction atomique échoue et renvoie 0x1.
Scénario 2 : Transfert de tokens vers un nouveau portefeuille
Si le portefeuille du destinataire ne possède pas encore de compte de token associé (ATA) pour le token envoyé, la transaction doit créer l’ATA en premier lieu. Si votre portefeuille ne détient pas les ~0.002 SOL requis pour ce loyer, la transaction échoue avec l’erreur 0x1.
Scénario 3 : Révocation d’autorités ou verrouillage de liquidité
Même si la révocation d’une autorité ou le verrouillage de tokens LP correspond à une mise à jour d’état, les frais prioritaires, le budget d’exécution et les allocations temporaires exigent une marge minimale en SOL.
Guide étape par étape pour corriger l’Erreur 0x1
Suivez ces étapes simples pour résoudre l’erreur 0x1 :
Étape 1 : Vérifier votre solde de SOL natif
Ouvrez votre extension de portefeuille. Vérifiez votre solde en SOL natif (et non en wrapped SOL ou tokens SPL). Assurez-vous de contrôler votre solde de SOL principal.
Étape 2 : Ajouter une marge de sécurité en SOL
Rechargez votre portefeuille en SOL natif. Nous vous recommandons de conserver les soldes minimaux suivants selon l’opération prévue :
- Création de token : Conservez au moins 0.02 SOL à 0.05 SOL dans votre portefeuille.
- Création de pool de liquidité : Conservez au moins 0.5 SOL en plus du montant de SOL à injecter.
- Révocation d’autorités : Conservez au moins 0.01 SOL dans votre portefeuille.
- Simple transfert de tokens : Conservez au moins 0.005 SOL dans votre portefeuille.
Étape 3 : Réessayer la transaction
Une fois le solde en SOL réapprovisionné, actualisez la page web pour obtenir un nouveau bloc (blockhash), reconnectez votre portefeuille et exécutez à nouveau la transaction.
Tableau récapitulatif de dépannage de l’Erreur 0x1
| Opération Tentée |
Cause Principale de l’Erreur 0x1 |
Solution Requise |
| Création de Token |
Manque de SOL pour le loyer des métadonnées et du mint |
Ajouter 0.02 SOL au portefeuille |
| Création de Pool |
Manque de SOL pour les coffres et le marché DEX |
Recharger en SOL pour couvrir les frais et l’apport |
| Transfert de Tokens |
Manque de SOL pour la création de l’ATA destinataire |
Ajouter 0.005 SOL au portefeuille |
| Révocation d’Autorité |
Manque de SOL pour les frais réseau et prioritaires |
Ajouter 0.01 SOL au portefeuille |
Conserver une marge suffisante de SOL natif dans votre portefeuille évite les erreurs 0x1 et garantit des opérations fluides et sans interruption sur Solana.