يعد رمز الخطأ المخصص 0x1 (Custom Program Error 0x1) أحد أكثر رموز الأخطاء شيوعا عند التعامل مع توكنات SPL أو التطبيقات اللامركزية على سولانا. ويظهر في النوافذ المنبثقة للمحافظ (مثل Phantom أو Solflare أو Backpack) وسجلات Solscan أثناء سك التوكنات، أو إنشاء المجمعات، أو إلغاء السلطات، أو تحويلات التوكنات.
وعلى الرغم من أن الرسالة Program log: Error: custom program error: 0x1 تبدو معقدة، فإن السبب الرئيسي لها بسيط للغاية: أموال غير كافية (يترجم 0x1 إلى 0x1: InsufficientFunds في مواصفات برنامج توكنات SPL على سولانا).
وسيساعدك فهم سبب افتقار محفظتك لأموال كافية رغم عرض رصيد SOL إيجابي في إصلاح الخطأ وإتمام المعاملة.
المعنى الفني للخطأ 0x1
في برنامج سولانا الرئيسي وبرنامج توكنات SPL، يظهر رمز الخطأ 0x1 كلما حاولت تعليمة اقتطاع أموال من حساب لا يحمل ما يكفي من عملة SOL الأساسية لإتمام العملية المطلوبة.
وعلى سولانا، تتطلب المعاملة عملة SOL الأساسية لغرضين منفصلين:
- رسوم معالجة المعاملات: رسوم شبكة بسيطة (عادة 0.000005 SOL) تدفع للمصدقين مقابل معالجة التعليمات.
- ودائع إعفاء الحسابات من الإيجار: وديعة تدفع لمرة واحدة (عادة من ~0.002 إلى 0.005 SOL لكل حساب) لتهيئة حسابات جديدة (مثل حسابات التوكن المرتبطة، أو البيانات الوصفية، أو حسابات الخزينة) في ذاكرة المصدقين.
وإذا كانت محفظتك تحتوي على 0.001 SOL، فلديك ما يكفي لرسوم المعاملة، لكن المعاملة تفشل بالخطأ 0x1 لأن رصيدك لا يغطي وديعة الإيجار المطلوبة لفتح الحساب الجديد.
وتوجد مواصفات رموز الأخطاء الرسمية في وثائق أخطاء سولانا.
السيناريوهات الشائعة لظهور الخطأ 0x1
السيناريو 1: إنشاء توكن SPL أو مجمع سيولة
عند إنشاء توكن أو إطلاق مجمع سيولة، تهيئ المعاملة حسابات جديدة متعددة في الوقت نفسه (حساب السك، وحساب البيانات الوصفية، وسوق OpenBook، وحسابات الخزينة). وإذا كانت محفظتك تفتقر إلى SOL كاف لتمويل إيجار جميع الحسابات، تتراجع المعاملة بأكملها بالخطأ 0x1.
السيناريو 2: تحويل التوكنات إلى محفظة جديدة
إذا كانت محفظة المستلم لا تمتلك حساب توكن مرتبطا (ATA) مهيأ للتوكن المرسل، فيجب أن تنشئ المعاملة حساب ATA أولا. وإذا كانت محفظتك تفتقر إلى رسم الإيجار البالغ ~0.002 SOL، تفشل المعاملة بالخطأ 0x1.
السيناريو 3: إلغاء السلطات أو قفل السيولة
حتى لو كان إلغاء السلطة أو قفل توكنات LP تحديثا للحالة فقط، فإن رسوم أولوية الشبكة والمخصصات المؤقتة تتطلب حدًا أدنى من احتياطي SOL.
خطوات إصلاح Custom Program Error 0x1
اتبع هذه الخطوات البسيطة لحل الخطأ 0x1:
الخطوة 1: فحص رصيد SOL الأساسي
افتح ملحق محفظتك. وتحقق من رصيد SOL الأساسي (وليس wrapped SOL أو توكنات SPL). وتأكد من فحص رصيد SOL الرئيسي.
الخطوة 2: إضافة احتياطي من رصيد SOL
قم بشحن محفظتك بـ SOL أساسي. ونوصي بالحفاظ على الأرصدة الأدنى التالية بناء على العملية:
- إنشاء التوكن: احتفظ بـ 0.02 SOL إلى 0.05 SOL على الأقل في محفظتك.
- إنشاء مجمع السيولة: احتفظ بـ 0.5 SOL على الأقل بالإضافة إلى كمية SOL المخصصة للإيداع.
- إلغاء السلطات: احتفظ بـ 0.01 SOL على الأقل في محفظتك.
- تحويلات التوكنات البسيطة: احتفظ بـ 0.005 SOL على الأقل في محفظتك.
الخطوة 3: إعادة محاولة المعاملة
بمجرد شحن رصيد SOL، قم بتحديث الصفحة للحصول على طابع كتل جديد، وأعد توصيل محفظتك، ونفذ المعاملة مرة أخرى.
جدول ملخص استكشاف أخطاء Error 0x1
| العملية المطلوبة |
السبب الرئيسي للخطأ 0x1 |
الحل المطلوب |
| سك التوكن |
نقص SOL لإيجار البيانات والسك |
إضافة 0.02 SOL لرصيد المحفظة |
| إنشاء مجمع السيولة |
نقص SOL للخزائن ورسوم السوق |
شحن SOL لتغطية الرسوم والإيداع |
| تحويل التوكنات |
نقص SOL لإنشاء حساب ATA للمستلم |
إضافة 0.005 SOL لمحفظة المرسل |
| إلغاء السلطة |
نقص SOL لرسوم الشبكة والأولوية |
إضافة 0.01 SOL لرصيد المحفظة |
يمنع الحفاظ على احتياطي بسيط من SOL الأساسي في محفظتك أخطاء 0x1 ويضمن عمليات توكنات سلسة على سولانا.