رموز الأخطاء

هذه الصفحة مُترجَمة آليًا بواسطة الذكاء الاصطناعي. النسخة الإنجليزية هي المرجع المعتمد.عرض النسخة الإنجليزية →

مصدر الحقيقة. الجداول أدناه يتم إعادة توليدها من error.rs في كل برنامج من مستودعات Raydium العامة. عند ترقية برنامج وإضافة متغير جديد، أعد تشغيل الاستخراج (الرابط في أسفل كل جدول) وأضف إلى الجدول بدلاً من إعادة ترتيبه — رموز أخطاء Anchor يتم تعيينها حسب ترتيب المصدر، وليس الاسم، لذا فإن إعادة الترتيب تكسر معالجة الأخطاء للمدمجين.

كيفية عمل رموز أخطاء Anchor

يعين Anchor لكل متغير في تعداد ErrorCode الخاص ببرنامج ما رمزًا رقميًا يبدأ من 6000. تعرض المعاملة الفاشلة:

رمز الخطأ الرقمي (مثل 0x1771 = 6001) في سجلات المعاملة.
اسم الخطأ (مثل InvalidOwner) من IDL.
سلسلة #[msg(...)] التي أصدرها Anchor في log_messages.

يجب على المدمجين المطابقة على الرمز الرقمي، وليس سلسلة الرسالة (يمكن إعادة صياغة السلسلة دون زيادة الإصدار).

// مثال: كشف خطأ الانزلاق في CPMM وعرض رسالة واجهة نظيفة.
const CPMM_EXCEEDED_SLIPPAGE = 6005;

try {
  await sdk.cpmm.swap({ ... });
} catch (err: any) {
  const code = err?.error?.errorCode?.number ?? err?.code;
  if (code === CPMM_EXCEEDED_SLIPPAGE) {
    showToast("Price moved past your slippage tolerance. Increase slippage or retry.");
    return;
  }
  throw err;
}

أخطاء CPMM (AMM القياسي)

معرّف البرنامج: انظر reference/program-addresses. المصدر: raydium-cp-swap/programs/cp-swap/src/error.rs.

الرمز	المتغير	سلسلة `#[msg]`	السبب الشائع	الواجهة الموصى بها
6000	`NotApproved`	Not approved	المستدعي ليس السلطة المكونة للتعليمات الإدارية.	”فقط مسؤول المجموعة يمكنه تنفيذ هذا الإجراء.”
6001	`InvalidOwner`	Input account owner is not the program address	الحساب المُمرر مملوك لبرنامج خاطئ (غالبًا برنامج رمز خاطئ أو PDA برنامج خاطئ).	”خطأ داخلي: عدم تطابق مالك الحساب — أعد التحديث وحاول مجددًا.”
6002	`EmptySupply`	Input token account empty	رصيد حساب LP أو الرمز صفر في خطوة تتطلب مبلغًا موجبًا.	”لا شيء للسحب.”
6003	`InvalidInput`	InvalidInput	حجة سيئة عامة (المبلغ خارج النطاق، علم خاطئ).	”إدخال غير صحيح — تحقق من المبالغ وحاول مجددًا.”
6004	`IncorrectLpMint`	Address of the provided lp token mint is incorrect	حساب LP mint المُمرر لا يطابق `pool_state.lp_mint`.	”خطأ داخلي: LP mint خاطئ — أعد تحديث بيانات المجموعة.”
6005	`ExceededSlippage`	Exceeds desired slippage limit	السعر المنفذ أسوأ من `minAmountOut` / `maxAmountIn` للمستخدم.	”تحرك السعر بعد حد الانزلاق الخاص بك. زد الانزلاق أو حاول مجددًا.”
6006	`ZeroTradingTokens`	Given pool token amount results in zero trading tokens	رياضيات الإيداع / السحب أدت إلى تقريب أحد الجانبين إلى صفر (الموضع صغير جدًا).	”المبلغ أقل من الحد الأدنى لهذه المجموعة.”
6007	`NotSupportMint`	Not support token_2022 mint extension	واجهت المجموعة امتداد Token-2022 لا يمكنها التعامل معه بأمان (مثل `TransferHook`، `DefaultAccountState=Frozen`).	”هذا الرمز له امتداد لا يدعمه Raydium في CPMM.”
6008	`InvalidVault`	invaild vault	حساب الخزينة المُمرر لا يطابق الحساب المسجل في `pool_state`.	”خطأ داخلي: خزينة خاطئة — أعد التحديث وحاول مجددًا.”
6009	`InitLpAmountTooLess`	Init lp amount is too less(Because 100 amount lp will be locked)	عند تهيئة المجموعة، إمداد LP المحسوب أقل من مبلغ القفل الدائم.	”السيولة الأولية صغيرة جدًا. زد الإيداع.”
6010	`TransferFeeCalculateNotMatch`	TransferFee calculate not match	المبلغ المرصود بعد النقل لـ Token-2022 fee mint لم يطابق التوقع المحسوب مسبقًا.	”رسم نقل الرمز تغير أثناء المعاملة. حاول مجددًا.”
6011	`MathOverflow`	Math overflow	حساب وسيط للمبادلة / الإيداع / الرسم تجاوز الحد.	”المبلغ كبير جدًا لهذه المجموعة.”
6012	`InsufficientVault`	Insufficient vault	رصيد خزينة المجموعة منخفض جدًا لتغطية الإخراج المطلوب.	”لا توجد سيولة كافية في المجموعة لهذا الحجم.”
6013	`InvalidFeeModel`	Invalid fee model	عيّن المسؤول مجموعة معاملات `AmmConfig` مرفوضة على السلسلة.	غير قابل للتطبيق — مسار إداري فقط.
6014	`NoFeeCollect`	Fee is zero	وجدت تعليمات جمع الرسوم (البروتوكول أو الصندوق أو منشئ) لا توجد رسوم قابلة للجمع. بالنسبة لـ `CollectCreatorFeePermissionless`، كان كلا عدادي المنشئ صفرًا.	”لا شيء للجمع.” تعامل معها كسباق حميد وتوقف.

مصدر إعادة التوليد: github.com/raydium-io/raydium-cp-swap — error.rs.

أخطاء CLMM

معرّف البرنامج: انظر reference/program-addresses. المصدر: raydium-clmm/programs/amm/src/error.rs.

الرمز	المتغير	سلسلة `#[msg]`	السبب الشائع	الواجهة الموصى بها
6000	`NotApproved`	Not approved	المستدعي ليس المسؤول المكون لهذه التعليمات؛ أو (تعليمات الأذونات) الموقّع ليس `admin` ولا `permission_pda_admin`؛ أو (`OpenLimitOrder`) حساب الرمز الإدخال/الإخراج مجمد أو المجموعة لديها مبادلة / أمر محدود معطل؛ أو (`ClosePosition`، مسار مجمد) الحساب المتبقي المُمرر ليس `personal_position.pool_id`.	”فقط مسؤول المجموعة يمكنه تنفيذ هذا الإجراء.” / “حساب الرمز هذا مجمد — أذبه قبل وضع الأمر.” / “خطأ داخلي: حساب موضع مجموعة خاطئ.”
6001	`InvalidUpdateConfigFlag`	invalid update amm config flag	مرر المسؤول قيمة `param` غير معروفة إلى `update_amm_config`.	غير قابل للتطبيق — مسار إداري فقط.
6002	`AccountLack`	Account lack	حساب متبقي مطلوب مفقود من المعاملة (عادةً مصفوفة علامات أو امتداد أوراكل)؛ أو `ClosePosition` يغلق NFT مجمد دون المجموعة كحسابه الأول المتبقي.	”خطأ داخلي: حساب مفقود — أعد تحديث بيانات المجموعة أو حدّث منشئ إغلاق الموضع.”
6003	`ClosePositionErr`	Remove liquidity, collect fees owed and reward then you can close position account	حاول إغلاق موضع لا يزال لديه سيولة أو رسوم غير مجمعة أو مكافآت غير مجمعة.	”اسحب كل السيولة واطلب الرسوم/المكافآت قبل إغلاق الموضع.”
6004	`InvalidTickIndex`	Tick out of range	`tick_lower` أو `tick_upper` خارج `[-443636, 443636]`.	”نطاق السعر خارج الحدود لهذه المجموعة.”
6005	`TickInvalidOrder`	The lower tick must be below the upper tick	`tick_lower >= tick_upper`.	”السعر الأقل يجب أن يكون أقل من السعر الأعلى.”
6006	`TickLowerOverflow`	The tick must be greater, or equal to the minimum tick(-443636)	تجاوز سفلي للعلامة.	”السعر الأقل منخفض جدًا.”
6007	`TickUpperOverflow`	The tick must be lesser than, or equal to the maximum tick(443636)	تجاوز علوي للعلامة.	”السعر الأعلى مرتفع جدًا.”
6008	`TickAndSpacingNotMatch`	tick % tick_spacing must be zero	العلامة المُرسلة ليست مضاعفًا لـ `tick_spacing` الخاص بالمجموعة.	”اقتطع السعر إلى أقرب زيادة صحيحة.”
6009	`InvalidTickArray`	Invalid tick array account	PDA خاطئ مُمرر لفتحة مصفوفة علامات.	”خطأ داخلي: مصفوفة علامات خاطئة — أعد تحديث بيانات المجموعة.”
6010	`InvalidTickArrayBoundary`	Invalid tick array boundary	خطأ بمقدار واحد في فهرسة مصفوفة العلامات.	”خطأ داخلي: خطأ حد مصفوفة العلامات.”
6011	`SqrtPriceLimitOverflow`	Square root price limit overflow	`sqrt_price_limit` المُمرر من المستدعي خارج النطاق الصحيح.	”حد السعر خارج النطاق.”
6012	`SqrtPriceX64`	sqrt_price_x64 out of range	سعر sqrt الحالي للمجموعة انجرف خارج النطاق أثناء المبادلة.	”أعد محاولة المبادلة.”
6013	`LiquiditySubValueErr`	Liquidity sub delta L must be smaller than before	انتهاك ثابت داخلي عند تقليل السيولة.	”خطأ داخلي: خطأ محاسبة السيولة.”
6014	`LiquidityAddValueErr`	Liquidity add delta L must be greater, or equal to before	انتهاك ثابت داخلي عند زيادة السيولة.	”خطأ داخلي: خطأ محاسبة السيولة.”
6015	`ForbidBothZeroForSupplyLiquidity`	Both token amount must not be zero while supply liquidity	استدعاء زيادة السيولة مع كل من `amount_0_max` و `amount_1_max` صفر.	”وفّر رمزًا واحدًا على الأقل.”
6016	`LiquidityInsufficient`	Liquidity insufficient	الموضع لا يحتوي على سيولة كافية لتلبية الانسحاب.	”مبلغ الانسحاب يتجاوز سيولة الموضع.”
6017	`PriceSlippageCheck`	Price slippage check	فشل سعر التنفيذ في حماية الانزلاق للمستدعي.	”تحرك السعر بعد حد الانزلاق الخاص بك. زد الانزلاق أو حاول مجددًا.”
6018	`TooLittleOutputReceived`	Too little output received	`SwapBaseInput`: مبلغ الإخراج أقل من `other_amount_threshold`.	”تجاوز الانزلاق — لم يتم تحقيق الحد الأدنى للإخراج.”
6019	`TooMuchInputPaid`	Too much input paid	`SwapBaseOutput`: مبلغ الإدخال أعلى من `other_amount_threshold`.	”تجاوز الانزلاق — تجاوز الحد الأقصى للإدخال.”
6020	`ZeroAmountSpecified`	Swap special amount can not be zero	صفر `amount` على تعليمة مبادلة.	”أدخل مبلغًا أكبر من صفر.”
6021	`InvalidInputPoolVault`	Input pool vault is invalid	حساب خزينة الإدخال للمبادلة لا يطابق خزينة المجموعة المسجلة.	”خطأ داخلي: خزينة إدخال خاطئة — أعد تحديث بيانات المجموعة.”
6022	`TooSmallInputOrOutputAmount`	Swap input or output amount is too small	رياضيات المبادلة أدت إلى تقريب إلى صفر، عادةً غبار صغير جدًا.	”المبلغ صغير جدًا للمبادلة في هذه المجموعة.”
6023	`NotEnoughTickArrayAccount`	Not enough tick array account	لم يتم توفير حسابات مصفوفة علامات متبقية كافية لنطاق المبادلة.	”خطأ داخلي: مصفوفات علامات غير كافية — أعد تحديث بيانات المجموعة.”
6024	`InvalidFirstTickArrayAccount`	Invalid first tick array account	حساب مصفوفة العلامات الأول المُمرر لا يغطي العلامة الحالية.	”خطأ داخلي: مصفوفة علامات أولى خاطئة — أعد تحديث بيانات المجموعة.”
6025	`InvalidRewardIndex`	Invalid reward index	`reward_index` خارج `[0, 2]`.	غير قابل للتطبيق — مسار إداري.
6026	`FullRewardInfo`	The init reward token reach to the max	المجموعة لديها بالفعل الحد الأقصى (3) من رموز المكافآت المكونة.	غير قابل للتطبيق — مسار إداري.
6027	`RewardTokenAlreadyInUse`	The init reward token already in use	رمز المكافأة يكرر واحدًا موجودًا.	غير قابل للتطبيق — مسار إداري.
6028	`ExceptRewardMint`	The reward tokens must contain one of pool vault mint except the last reward	قبل الفتحة 2، رمز المكافأة يجب أن يساوي أحد رموز خزينة المجموعة.	غير قابل للتطبيق — مسار إداري.
6029	`InvalidRewardInitParam`	Invalid reward init param	وقت بدء/نهاية الانبعاث السيء أو معدل لكل ثانية.	غير قابل للتطبيق — مسار إداري.
6030	`InvalidRewardInputAccountNumber`	Invalid collect reward input account number	عدد خاطئ من الحسابات المتبقية المُمررة إلى `CollectReward`.	”خطأ داخلي: عدد حساب خاطئ — أعد التحديث وحاول مجددًا.”
6031	`InvalidRewardPeriod`	Invalid reward period	فترة انبعاث المكافأة غير صحيحة (`end <= start`، مدة صفر).	غير قابل للتطبيق — مسار إداري.
6032	`NotApproveUpdateRewardEmissions`	Modification of emissions is allowed within 72 hours from the end of the previous cycle	حاول المسؤول تعديل الانبعاثات خارج نافذة 72 ساعة حول حدود الدورة.	غير قابل للتطبيق — مسار إداري.
6033	`UnInitializedRewardInfo`	uninitialized reward info	فتحة المكافأة لم تُهيأ لكن تم الإشارة إليها.	غير قابل للتطبيق — مسار إداري.
6034	`NotSupportMint`	Not support token_2022 mint extension	واجهت CLMM امتداد Token-2022 لا يمكنها التعامل معه.	”هذا الرمز له امتداد لا يدعمه Raydium CLMM.”
6035	`MissingTickArrayBitmapExtensionAccount`	Missing tickarray bitmap extension account	عبرت المبادلة نطاق علامات لا تغطيه الخريطة النقطية الأساسية؛ حساب خريطة نقطية امتداد مطلوب.	”خطأ داخلي: امتداد مصفوفة علامات مفقود — أعد تحديث بيانات المجموعة.”
6036	`InsufficientLiquidityForDirection`	Insufficient liquidity for this direction	لا توجد سيولة كافية في اتجاه المبادلة.	”سيولة غير كافية لهذا حجم المبادلة.”
6037	`MaxTokenOverflow`	Max token overflow	مبلغ الإدخال/الإخراج تجاوز u64.	”المبلغ كبير جدًا لهذه المجموعة.”
6038	`CalculateOverflow`	Calculate overflow	تجاوز حسابي الرسم / السيولة.	”المبلغ كبير جدًا لهذه المجموعة.”
6039	`TransferFeeCalculateNotMatch`	TransferFee calculate not match	مبلغ Token-2022 transfer fee المرصود لم يطابق المتوقع.	”رسم نقل الرمز تغير أثناء المعاملة. حاول مجددًا.”
6040	`OrderAlreadyFilled`	Order already fully filled, cannot modify	تم استدعاء `IncreaseLimitOrder` / `DecreaseLimitOrder` على أمر جزء غير مملوء صفر.	”هذا الأمر المحدود مملوء بالفعل — استقر لتلقي الإخراج.”
6041	`InvalidOrderPhase`	Invalid order phase	تحوير أمر مرحلة FIFO cohort لم تعد تطابق مرحلة cohort الحالية للعلامة.	”لا يمكن تنفيذ هذا الإجراء في الحالة الحالية للأمر.”
6042	`InvalidLimitOrderAmount`	Invalid limit order amount	إدخال الأمر أقل من الحد الأدنى للمجموعة (أو صفر) عند فتح / زيادة / تقليل الوقت.	”حجم الأمر أقل من الحد الأدنى للمجموعة.”
6043	`OrderPhaseSaturated`	Tick order phase saturated	عداد `order_phase` الخاص بـ cohort على العلامة مشبع؛ لا يمكن فتح أوامر إضافية في تلك العلامة حتى تستقر cohorts الموجودة وتتدحرج.	”عدد كبير جدًا من الأوامر النشطة بهذا السعر؛ جرّب علامة قريبة أو انتظر استقرار الأوامر.”
6044	`InvalidDynamicFeeConfigParams`	Invalid dynamic fee config params	تم رفض `CreateDynamicFeeConfig` / `UpdateDynamicFeeConfig`؛ أو `CreateCustomizablePool` فعّل الرسم الديناميكي بدون تكوين صحيح.	غير قابل للتطبيق على مسار إداري؛ “تكوين الرسم الديناميكي غير صحيح” على مسار المستخدم.
6045	`InvalidFeeOn`	Invalid fee on which token (must be 0, 1, or 2)	مرر `CreateCustomizablePool` قيمة `collect_fee_on` خارج `{0, 1, 2}`.	”خطأ داخلي: وضع رسم غير صحيح.”
6046	`ZeroSqrtPrice`	sqrt_price_x64 must be greater than 0	تم استدعاء `CreateCustomizablePool` (أو مسار آخر يقبل سعر sqrt أولي قابل للتخصيص) مع `sqrt_price_x64 == 0`.	”السعر الأولي يجب أن يكون أكبر من صفر.”
6047	`ZeroLiquidity`	liquidity must be greater than 0	تم استدعاء مسار توفير السيولة مع `liquidity == 0` وبدون مبلغ تعويضي.	”مبلغ السيولة يجب أن يكون أكبر من صفر.”
6048	`MissingBaseFlag`	base_flag is required when liquidity is zero	حسب مسار فتح موضع حسب المبلغ `liquidity == 0` ولم يوفر المستدعي `base_flag` لتوضيح أي جانب هو الأساس.	”وفّر إما سيولة غير صفرية أو حدد أي رمز هو الأساس.”
6049	`MissingMintAccount`	Mint account is required but not provided	تم استدعاء مسار يدرك Token-2022 بدون حساب mint الإدخال/الإخراج المطلوب للتحقق من الامتدادات ورسوم النقل.	”خطأ داخلي: حساب mint مفقود — أعد تحديث بيانات المجموعة.”
6050	`MissingTokenProgram2022`	Token-2022 program is required but not provided	نفس الأعلى لحساب برنامج SPL-Token-2022.	”خطأ داخلي: برنامج Token-2022 مفقود — أعد التحديث وحاول مجددًا.”

ملاحظة حول إعادة الترقيم. تم إعادة ترقيم تعداد ErrorCode الخاص بـ CLMM في هذا الإصدار: تم حذف خمسة متغيرات قديمة (LOK، ZeroMintAmount، InvalidLiquidity، TransactionTooOld، InvalidRewardDesiredAmount) وعدة أخطاء إملائية (Liquitity، enought، emissiones)، وتم إضافة أحد عشر متغيرًا جديدًا. لأن Anchor يرقم الأخطاء حسب ترتيب المصدر، فإن كل رمز عند أو بعد 6000 قد تحول بالنسبة لإصدارات ما قبل الإصدار. يحتاج العملاء الذين قاموا بترميز الرموز الرقمية مقابل إصدار سابق إلى إعادة تعيين.

مصدر إعادة التوليد: github.com/raydium-io/raydium-clmm — error.rs.

أخطاء AMM v4، Farm v3 / v5 / v6، LaunchLab

يتم توثيق هذه البرامج في فصولها الخاصة (انظر products/amm-v4/instructions، products/farm-staking/instructions، products/launchlab/instructions). لأن هذه البرامج تستخدم مزيجًا من سطح أخطاء Anchor والـ Solana العادي، تعيش جداول الأخطاء الخاصة بها بجانب مرجع التعليمات بدلاً من هنا. الرموز أدناه محجوزة من قبل هذه الفصول:

البرنامج	نطاق الرمز (Anchor فقط)	المرجع
AMM v4	رموز u32 مخصصة، وليس نمط Anchor	`products/amm-v4/instructions`
Farm v3 / v5	رموز u32 مخصصة	`products/farm-staking/instructions`
Farm v6	6000+ (Anchor)	`products/farm-staking/instructions`
LaunchLab	6000+ (Anchor)	`products/launchlab/instructions`

يحافظ إصدار LaunchLab على الرموز 6000–6021 دون تغيير. يزيل أخطاء الوصول العام للمنصة السابقة ويعين 6022 لخطأ التحقق من حساب السماح الجديد:

الرمز	الاسم	المعنى
6018	`NotEnoughRemainingAccounts`	حساب متبقي مطلوب مفقود. يتضمن ذلك `PlatformAllowConfig` مطلوب ومجموعة حسابات هجرة CPMM الموسعة.
6022	`InvalidPlatformAllowConfig`	حساب السماح المُمرر لا يشفر زوج المنصة والتكوين العام المتوقع.

تم حذف المتغيرات القديمة PlatformGlobalAccessDenied (6022) و InvalidPlatformGlobalAccess (6023). لا تفك تشفير 6022 باستخدام IDL السابق.

ربط أخطاء SDK بأخطاء البرنامج

يلف SDK TypeScript الرسمي أخطاء على السلسلة إلى SendTransactionError وللبرامج Anchor، AnchorError:

import { AnchorError } from "@coral-xyz/anchor";

try {
  await sdk.cpmm.swap({ ... });
} catch (err) {
  if (err instanceof AnchorError) {
    console.log(err.error.errorCode.number, err.error.errorCode.code, err.error.errorMessage);
    // 6005 ExceededSlippage "Exceeds desired slippage limit"
  } else {
    // Raw SendTransactionError — inspect err.logs for the "custom program error: 0x..." line.
  }
}

إذا لم تكن تستخدم عميل Anchor، حلل سجلات المعاملة:

Program <ProgramID> invoke [1]
Program log: AnchorError caused by account: pool_state. Error Code: ExceededSlippage. Error Number: 6005. Error Message: Exceeds desired slippage limit.

النمط Error Number: (\d+) مستقر عبر إصدارات Anchor وآمن للمطابقة.

إعادة توليد هذه الجداول

عند ترقية برنامج وإضافة خطأ جديد، أعد الاستخراج من المصدر:

# استنساخ و grep تعداد الخطأ بالترتيب.
git clone --depth=1 https://github.com/raydium-io/raydium-cp-swap
awk '/#\[msg\(/{ gsub(/^[ \t]*#\[msg\("|"\)\][ \t]*/,""); m=$0; getline; gsub(/,/,""); gsub(/^[ \t]+/,""); print "6000+++\t" $0 "\t" m }' \
  raydium-cp-swap/programs/cp-swap/src/error.rs
# استبدل 6000+++ برموز متزايدة بشكل رتيب 6000,6001,... أضف صفوفًا جديدة إلى الجدول أعلاه.

قم دائمًا بتحديث reference/changelog عند إضافة متغير جديد، حتى يعرف المدمجون الذين يرقون SDK أن ينعشوا معالجات الأخطاء الخاصة بهم. المصادر:

Reference

Resources

رموز الأخطاء

كيفية عمل رموز أخطاء Anchor

أخطاء CPMM (AMM القياسي)

أخطاء CLMM

أخطاء AMM v4، Farm v3 / v5 / v6، LaunchLab

ربط أخطاء SDK بأخطاء البرنامج

إعادة توليد هذه الجداول

​كيفية عمل رموز أخطاء Anchor

​أخطاء CPMM (AMM القياسي)

​أخطاء CLMM

​أخطاء AMM v4، Farm v3 / v5 / v6، LaunchLab

​ربط أخطاء SDK بأخطاء البرنامج

​إعادة توليد هذه الجداول

كيفية عمل رموز أخطاء Anchor

أخطاء CPMM (AMM القياسي)

أخطاء CLMM

أخطاء AMM v4، Farm v3 / v5 / v6، LaunchLab

ربط أخطاء SDK بأخطاء البرنامج

إعادة توليد هذه الجداول