مرجع رموز الأخطاء

حين يفشل شيء ما، تعرض J Tools عنوانًا قصيرًا وسطرًا يشرح ما حدث وما تفعله بعده. وخلف كل رسالة رمز، مثل AFF_WITHDRAW_MIN أو VALIDATION_ERROR، وهو ما تحمله استجابات API وما يستطيع الدعم تتبعه. تشرح هذه الصفحة الرموز التي يُرجَّح أن تصادفها وما تفعله حيال كل منها.

رموز الشراكة تبدأ بالبادئة AFF_ وتجدها تحت الشراكة. وكل ما عداها رسائل أدوات أو معاملات، مرتبة حسب مصدرها: المبادلة والتداول، والمحافظ والتحويلات، والمعاملات والتوقيع، وعام وغير ذلك. وإن رأيت رسالة عادية بلا رمز، فقسم «مشكلات شائعة» في صفحة الأداة نفسها يغطيها غالبًا.

J Tools غير احتجازية، فكل ما يبدأ في محفظتك ينتهي في محفظتك، ولا يتحرك شيء قبل أن توقّع.

الشراكة

#الشراكة

تظهر هذه الرموز حول لوحة الشراكة: عند التسجيل، أو طلب السحب، أو احتساب إحالة لك.

الحساب والدخول

الرمز	معناه	طريقة الحل
`AFF_NOT_FOUND`	لا يوجد حساب شراكة مرتبط بهذه المحفظة.	سجّل كشريك أولًا، أو اربط المحفظة التي تملك حساب الشريك. راجع كيف يعمل برنامج الشراكة.
`AFF_BANNED`	حساب الشريك موقوف، فاللوحة مغلقة أمامه. نافذة تسجيل الدخول تقول إن الحساب موقوف، وباقي الطلبات تردّ بـ «Access denied» (رفض الوصول).	تواصل مع الدعم. الشريك الموقوف لا يستطيع استخدام اللوحة ولا طلب السحب ولا كسب عمولات جديدة.
`AFF_ALREADY_REGISTERED`	هذه المحفظة مسجلة كشريك بالفعل.	سجّل الدخول بالمحفظة الموجودة بدل التسجيل من جديد.
`AFF_WALLET_REQUIRED`	عنوان المحفظة مفقود أو ليس عنوان سولانا صالحًا.	اربط محفظة، أو أدخل عنوان سولانا صالحًا (بين 32 و44 حرفًا بترميز base58 تقريبًا).
`AFF_TERMS_REQUIRED`	أُرسل التسجيل دون الموافقة على شروط الشراكة الحالية.	علّم مربع الشروط في نافذة التسجيل، ثم سجّل مجددًا.

السحوبات

الرمز	معناه	طريقة الحل
`AFF_WITHDRAW_MIN`	المبلغ أقل من الحد الأدنى للسحب.	اطلب الحد الأدنى المعروض في اللوحة على الأقل. راجع السحوبات.
`AFF_WITHDRAW_MAX`	المبلغ أكبر من رصيدك المتاح.	خفّضه إلى رصيدك القابل للسحب حاليًا، أو انتظر وصول عمولات مؤكدة أخرى.
`AFF_SOCIAL_REQUIRED`	لا يوجد رابط تواصل موثّق في حسابك، والسحب يتطلب رابطًا واحدًا على الأقل.	أضف رابطًا في الإعدادات، وانتظر أن يوثّقه فريقنا، ثم أعد المحاولة.
`AFF_WITHDRAW_PENDING`	لديك طلب سحب ينتظر بالفعل.	انتظر حتى يُدفع أو يُرفض، فلا يمكن فتح أكثر من طلب واحد في الوقت نفسه.
`AFF_WITHDRAW_REJECTED`	رفض المسؤول الطلب دون تسجيل سبب. تعرضه اللوحة مرفوضًا بلا سبب، والمبلغ عاد إلى رصيدك.	تواصل مع الدعم لمعرفة التفاصيل، ثم أرسل طلب سحب جديدًا.

احتساب الإحالة

الرمز	معناه	طريقة الحل
`AFF_REF_INVALID`	رمز الإحالة بصيغة خاطئة، أو لا يملكه أي شريك نشط.	استخدم رابطًا حاليًا بالشكل `https://j.tools/ar?ref=CODE`. قد يكون الرمز لشريك لم يعد نشطًا. راجع كيف تحتسب الإحالة.
`AFF_RATE_LIMITED`	وصلت طلبات كثيرة جدًا إلى نقاط الشراكة في وقت قصير (HTTP 429).	انتظر نحو دقيقة وحاول مجددًا. هذا الحد يحمي النقاط العامة من إساءة الاستخدام.

المبادلة والتداول

#المبادلة-والتداول

تظهر هذه الرسائل حين تبادل عملة تملكها أو تنقلها.

الرسالة	معناها	طريقة الحل
رصيد العملة غير كافٍ	تحاول إرسال أو مبادلة أو حرق كمية من عملة أكبر مما تحمله المحفظة.	خفّض الكمية إلى ما تملكه فعلًا، أو تأكد أنك اخترت العملة الصحيحة.

المحافظ والتحويلات

#المحافظ-والتحويلات

معظم هذه الرسائل تأتي من المحفظة نفسها: غير متصلة، أو موجهة إلى الشبكة الخطأ، أو العنوان الذي أدخلته غير صحيح.

الرسالة	معناها	طريقة الحل
ألغيت العملية من محفظتك	رُفضت المعاملة في شاشة الموافقة بالمحفظة. لم يُرسل شيء ولم يُخصم شيء.	شغّلها مجددًا حين تكون مستعدًا للموافقة.
المحفظة غير متصلة	تحتاج الأداة إلى محفظة متصلة قبل أن تستطيع التوقيع.	اربط محفظة أولًا. راجع اربط محفظتك.
استغرقت الموافقة وقتًا طويلًا	انتهت صلاحية المعاملة بينما نافذة المحفظة لا تزال مفتوحة.	شغّلها مجددًا ووافق دون تأخير طويل.
المحفظة على الشبكة الخطأ	المحفظة مضبوطة على شبكة غير التي تتوقعها الأداة.	حوّل المحفظة إلى الشبكة الرئيسية لسولانا، ثم أعد المحاولة.
تراجعت عند تحذير المحفظة	عرضت محفظتك تحذيرًا على المعاملة فرفضتها. لم يُرسل شيء.	اقرأ الملاحظة أدناه. وإن بدا التحذير غير منطقي لما أعددته، فأبلغ الدعم لنتحقق مما بنته الأداة.
عنوان محفظة غير صالح	حقل المستلم أو المحفظة لا يحمل عنوان سولانا صالحًا (بين 32 و44 حرفًا بترميز base58 تقريبًا).	الصق العنوان كاملًا من جديد، وانتبه للأخطاء المطبعية والأحرف الزائدة والنسخ المقطوع.

المعاملات والتوقيع

#المعاملات-والتوقيع

تظهر هذه الرسائل أثناء بناء المعاملة أو بثها: عند تمويلها، أو الوصول إلى الشبكة، أو اجتياز فحوصات الأداة.

الرصيد والأموال

الرسالة	معناها	طريقة الحل
رصيد SOL غير كافٍ	لا تستطيع المحفظة تغطية رسوم المنصة مع تكاليف الشبكة لهذا الإجراء.	اشحن المحفظة، ثم أعد المحاولة. راجع تنبيه الرسوم أدناه.
أحد الحسابات سينزل تحت حد الإيجار	كل حساب على سولانا يجب أن يحتفظ بحد الإعفاء من الإيجار. إما أن الرصيد أقل منه، أو أن المبلغ سيترك محفظة الإرسال بفتات لا يكفي.	أضف SOL، أو خفّض المبلغ، أو أفرغ محفظة الإرسال بالكامل.

الشبكة وRPC

الرسالة	معناها	طريقة الحل
انتهت صلاحية المعاملة	انتهت صلاحية blockhash قبل نزول المعاملة، غالبًا بسبب ازدحام الشبكة.	شغّلها مجددًا. المعاملة المنتهية لم تنزل أصلًا، فلم يُخصم شيء.
تعذّر الوصول إلى شبكة سولانا	نقطة RPC لم تستجب.	انتظر نحو 30 ثانية ثم أعد المحاولة. وإن تكرر ذلك، جرّب اتصال إنترنت آخر (مثلًا دون VPN صارم).
طلبات كثيرة جدًا	مزود RPC أو نقطة مشتركة تلقت طلبات كثيرة جدًا في وقت قصير (HTTP 429).	انتظر بضع ثوانٍ، ثم حاول مجددًا.
لم يصل التأكيد في الوقت المحدد	أُرسلت المعاملة، لكن الأداة توقفت عن انتظار النتيجة، وقد تكون نزلت رغم ذلك.	افحص المحفظة أو مستكشفًا قبل إعادة الإرسال، حتى لا تنفذها مرتين.

التحقق من المدخلات

الرسالة	معناها	طريقة الحل
عنوان mint غير صالح	عنوان العملة بصيغة خاطئة، أو لا يشير إلى mint عملة.	اختر العملة من المحدد بدل لصق العنوان.
حقل مطلوب فارغ	النموذج ينقصه شيء يحتاجه هذا التشغيل.	املأ الحقول المميزة وأرسل مجددًا.
مبلغ غير صالح	المبلغ صفر أو سالب أو ليس رقمًا.	أدخل مبلغًا أكبر من صفر. وإن عرضت الأداة حدًا بجانب الحقل، فالتزم به.
Please check your input and try again	رفض فحص على الخادم المدخلات، والرد يبقي التفاصيل عامة لأسباب أمنية. تظهر الرسالة بالإنجليزية ومعناها: تحقق من مدخلاتك وحاول مجددًا.	راجع الحقول. وإن لم يبدُ فيها خطأ، فحدّث الصفحة وأعد إدخال القيم.

عام وغير ذلك

#عام-وغير-ذلك

بعض استجابات API تحمل رمزًا نصيًا قصيرًا بدل رسالة مصنّفة. هذه الرموز عامة عمدًا حتى لا تكشف تفاصيل الخادم.

الرمز	معناه	طريقة الحل
`VALIDATION_ERROR`	فشل مُدخل واحد أو أكثر في فحص على الخادم. تعرضه الأداة على أنه «حقل مطلوب فارغ».	أصلح الحقول المميزة وأرسل مجددًا، بالفكرة نفسها لرسائل التحقق أعلاه.
`RATE_LIMITED`	بلغت حد الطلبات على نقطة مشتركة (HTTP 429). تعرضه الأداة على أنه «طلبات كثيرة جدًا».	انتظر قليلًا، ثم أعد المحاولة.
`UNAUTHORIZED`	جلستك مفقودة أو منتهية.	سجّل الدخول أو أعد الربط، ثم كرر الإجراء.
`NOT_FOUND`	ما طلبته غير متاح، أو لم يوجد أصلًا.	تحقق مجددًا من الرابط أو المعرّف الذي استخدمته.
`GENERIC_ERROR`	خطأ غير متوقع لم يستطع الخادم تصنيفه. تعرض الأداة «حدث خطأ ما».	أعد المحاولة مرة واحدة. وإن تكرر، فأرسل إلى الدعم نص الرسالة كما هو وما كنت تفعله.

ما زلت عالقًا؟

#ما-زلت-عالقًا

الرسالة داخل التطبيق هي المرجع دائمًا. إن لم تجد الرمز هنا، أو اختلفت الصياغة، أو لم يحل الحل أعلاه المشكلة، فاتبع ما يقوله التطبيق وتواصل معنا. أرسل لنا نص الرسالة كما رأيته، والأداة التي كنت فيها، وما فعلته قبلها مباشرة. هذا يكفي عادة لنحدد المشكلة بسرعة.

J Tools غير احتجازية. لا نخزّن المفاتيح الخاصة لمحفظتك ولا نطلب عبارة الاسترداد أبدًا. كل معاملة توافق عليها في محفظة متصلة تُوقَّع داخل تلك المحفظة، ومفتاحها لا يصل إلى خوادمنا. تتيح بعض أدوات المحافظ المتعددة لصق مفاتيح خاصة لمحافظ ساخنة مؤقتة، وتبقى هذه المفاتيح في تبويب متصفحك وتوقّع هناك. أداة زيادة الحاملين هي الوحيدة التي تسلّم مفتاحًا إلى خادمنا: مفتاح محفظة التوزيع الجديدة التي تنشئها لكل تشغيلة، وتُرسله مشفّرًا. لا تلصق أبدًا مفتاحًا مرتبطًا بأصول تحتفظ بها طويلًا، وإذا طلبت منك صفحة عبارة الاسترداد فتوقف وأغلقها.