تعليمات CLMM

​

جرد التعليمات

​

CreatePool

sqrt_price_x64: u128           // السعر الأولي
open_time:      u64            // يتم رفض المبادلات قبل هذا الوقت

• token_mint_0 < token_mint_1 حسب ترتيب البايت.
• amm_config.disable_create_pool == false.
• لم يتم رفض الـ mints بواسطة قائمة السماح بامتداد Token-2022.

• pool_state.sqrt_price_x64 = sqrt_price_x64، tick_current = floor(log_{1.0001}(price)).
• pool_state.liquidity = 0 (لا توجد مراكز حتى الآن).
• pool_state.fee_on = FromInput (الافتراضي القديم).
• pool_state.dynamic_fee_info مصفر (الرسوم الديناميكية معطلة).

​

CreateCustomizablePool

pub struct CreateCustomizableParams {
    pub sqrt_price_x64:    u128,
    pub collect_fee_on:    CollectFeeOn,   // FromInput | Token0Only | Token1Only
    pub enable_dynamic_fee: bool,
}

• pool_state.fee_on مضبوط على متغير CollectFeeOn المختار.
• إذا تم تفعيل الرسوم الديناميكية: يتم تهيئة pool_state.dynamic_fee_info من DynamicFeeConfig المزود (خمسة معاملات معايرة مسخوخة؛ حقول الحالة مصفرة).
• وإلا: pool_state.dynamic_fee_info مصفر (= الرسوم الديناميكية غير نشطة إلى الأبد لهذا المجمع).

​

CreatePermissionedPool

customizable_params: CreateCustomizableParams   // نفس الهيكل مثل CreateCustomizablePool
seed_index:          u16                          // يجب أن يكون غير صفري؛ مطوي في بذور PDA المجمع

• seed_index != 0. seed_index من 0 محجوز للمجمعات القديمة ويتم رفضه هنا؛ مكون البذرة [0, 0] هو ما يجعل عنوان المجمع القديم ينهار إلى الشكل الكلاسيكي ذي البذور الأربع.
• PDA permission لـ payer موجود (تم إنشاؤه بواسطة مسؤول عبر CreatePermissionPda).
• نفس قواعد mint / allow-list مثل CreatePool.

• pool_state جديد موجود في عنوان مشتق من seed_index، مع pool_state.seed_index = seed_index.
• جميع حالات ما بعد الحالة الأخرى تطابق CreateCustomizablePool (وضع الرسوم، الرسوم الديناميكية الاختيارية).

​

OpenPositionV2 / OpenPositionWithToken22Nft

tick_lower_index: i32
tick_upper_index: i32
tick_array_lower_start_index: i32
tick_array_upper_start_index: i32
liquidity:  u128              // L المطلوب (أو 0 لاستخدام المبالغ أدناه)
amount_0_max: u64
amount_1_max: u64
with_metadata: bool           // كتابة بيانات وصفية NFT (Metaplex)
base_flag: Option<bool>       // true = ملاءمة لـ amount0؛ false = ملاءمة لـ amount1

• tick_lower < tick_upper، كلاهما مضاعفات pool.tick_spacing، ضمن [MIN_TICK, MAX_TICK].
• يتم تمرير PDA مصفوفتي العلامة. لا يجب أن تكون موجودة بالفعل — get_or_create_tick_array يخصص واحدة مفقودة على حساب payer داخل هذه التعليمة. لا توجد تعليمة init-tick-array منفصلة.
• يحتوي المستخدم على ما لا يقل عن amount_0_max و amount_1_max في ATAs المصدر.

• personal_position موجود، liquidity مضبوط، fee_growth_inside_last مأخوذ لقطة.
• تم تحديث إدخالات مصفوفة العلامة في tick_lower و tick_upper (liquidity_gross += L، liquidity_net ± L، لقطات نمو الرسوم المحفوظة).
• pool_state.liquidity += L إذا كان المركز في النطاق (tick_lower ≤ tick_current < tick_upper).
• يسجل NFT mint pool_state كسلطة تجميد. يتم إزالة سلطة الـ mint بعد صك NFT الواحد. تسجيل سلطة التجميد لا يغير حالة حساب رمز NFT.
• يبقى حساب رمز NFT غير مجمد ما لم تكن التعليمة OpenPositionV2 أو OpenPositionWithToken22Nft و تطابق سلطة تجميد أي vault mint قائمة المُصدر المقيد لـ CLMM. فقط مسار V2 المطابق هذا يجمد الحساب. OpenPosition V1 لا يجمد.

​

IncreaseLiquidityV2

liquidity: u128
amount_0_max: u64
amount_1_max: u64
base_flag: Option<bool>

• ينقل amount_0_actual / amount_1_actual من المستخدم → الأقبية.
• يزيد personal_position.liquidity و pool_state.liquidity (إذا كان في النطاق)، وإدخالات العلامة النهائية liquidity_gross / liquidity_net وفقًا لذلك.
• يجمع الرسوم والمكافآت المستحقة منذ آخر لمسة ويعتمدها على token_fees_owed_{0,1} / reward_amount_owed. يتم دفعها فقط على DecreaseLiquidity / DecreaseLiquidityV2، وليس على الزيادة — لا توجد تعليمة جمع مستقلة.

​

DecreaseLiquidityV2

liquidity: u128
amount_0_min: u64
amount_1_min: u64

• يحسب (amount_0, amount_1) للـ L المزال بالنظر إلى sqrt_price_x64 الحالي.
• يسوي الرسوم/المكافآت المتراكمة منذ آخر لمسة، نفس IncreaseLiquidity.
• ينقل amount_0 + fees_owed_0 و amount_1 + fees_owed_1 خارج الأقبية إلى المستخدم.
• ينقص عدادات السيولة؛ إذا كان personal_position.liquidity == 0 الجديد، يكون المركز مؤهلاً لـ ClosePosition.

​

ClosePosition

• NFT غير مجمد: لا يلزم أي شيء؛ حساب مجمع إضافي غير ضار لأن المعالج لا يقرأه.
• NFT مجمد: أضف personal_position.pool_id كأول حساب متبقي. يحمل البرنامج كـ PoolState ويستخدم بذور PDA الخاصة به للتوقيع على الإذابة.

• personal_position.liquidity == 0.
• tokens_fees_owed_{0,1} == 0.
• جميع عدادات المكافآت reward_amount_owed == 0.

• إذا كان حساب رمز NFT مجمدًا، تحقق من أن أول حساب متبقي يساوي personal_position.pool_id، ثم أذبه مع PDA المجمع.
• حرق NFT.
• أغلق حساب رمز NFT و personal_position، مسترجعًا الإيجار إلى nft_owner. إذا كان NFT المركز يستخدم Token-2022، فإنه يغلق أيضًا NFT mint؛ لا يمكن إغلاق mints SPL Token الكلاسيكية وتبقى بإمداد صفر.

​

SwapV2

amount: u64                  // إدخال إذا is_base_input=true، إخراج وإلا
other_amount_threshold: u64  // الحد الأدنى للإخراج أو الحد الأقصى للإدخال
sqrt_price_limit_x64: u128   // حد صارم؛ 0 ⇒ بدون حد
is_base_input: bool

• pool_state.status يسمح بالمبادلة.
• now >= open_time.
• sqrt_price_limit_x64 على الجانب الصحيح من sqrt_price_x64 للاتجاه.

1. رسوم ديناميكية إضافية — إذا كان pool.dynamic_fee_info غير صفري، يحدّث البرنامج مراكم التقلب باستخدام مسافة العلامة المقطوعة منذ آخر مبادلة (مع قواعد التصفية/الاضمحلال من products/clmm/fees) ويضيف dynamic_fee_component على رأس AmmConfig.trade_fee_rate. إجمالي الرسوم مغطى بـ 10% (MAX_FEE_RATE_NUMERATOR / 1_000_000).
2. مطابقة أوامر الحد — عندما يعبر مشي السعر علامة تحتفظ بأوامر حد مفتوحة، يملأ البرنامج أولاً سيولة أوامر الحد المتاحة في تلك العلامة (FIFO حسب order_phase)، ثم يمضي على منحنى سيولة LP. تحدّث المبالغ المملوءة tick.unfilled_ratio_x64 و tick.part_filled_orders_remaining للتسوية لاحقًا؛ تبقى الأوامر نفسها غير منفقة حتى يستدعي مالكها SettleLimitOrder.
3. توجيه الرسوم أحادي الجانب — عندما pool.fee_on = Token0Only أو Token1Only، تحسب خطوة المبادلة نفس إدخال-إخراج التجارة؛ يتم بعد ذلك توجيه الرسوم إلى الجانب المكون. بالنسبة للاتجاهات حيث جانب الرسوم المكون هو الإخراج، يتم خصم الرسوم من إخراج المبادلة (يتلقى المستخدم out − fee)؛ بالنسبة للاتجاهات حيث يكون الإدخال، السلوك يطابق FromInput. انظر is_fee_on_input(zero_for_one) و is_fee_on_token0(zero_for_one) على PoolState.

​

OpenLimitOrder

nonce_index:    u8       // فهرس حساب nonce المختار من قبل المستخدم (0..255 لكل محفظة)
zero_for_one:   bool     // true: بيع token0 مقابل token1؛ false: بيع token1 مقابل token0
tick_index:     i32      // يجب أن يكون مضاعفة pool.tick_spacing
amount:         u64      // مبلغ رمز الإدخال

• لا input_token_account ولا output_token_account مجمد (وإلا NotApproved).
• pool_state.status يسمح بعمليات المبادلة (بت 4) وأوامر الحد (بت 5) (وإلا NotApproved).
• tick_index % pool.tick_spacing == 0 وضمن [MIN_TICK, MAX_TICK].
• tick_index على الجانب الأيمن من pool.tick_current للاتجاه المختار (بيع token0 → يجب أن تكون العلامة فوق الحالية، والعكس صحيح). البيع عند علامة تم عبورها بالفعل سيتم مطابقته فورًا ويتم رفضه.

• limit_order موجود، لقطة tick.order_phase و tick.unfilled_ratio_x64 عند وقت الفتح.
• tick.orders_amount += amount (في المجموعة الحالية).
• limit_order_nonce.order_nonce += 1.
• OpenLimitOrderEvent مُصدر.

​

IncreaseLimitOrder

amount: u64    // مبلغ رمز إدخال إضافي

• limit_order.owner == signer.
• الأمر لا يزال في نفس المجموعة (tick.order_phase == limit_order.order_phase). إذا بدأت المجموعة بالفعل بالملء، يتم تسوية الأمر جزئيًا — يجب على المتصل استدعاء DecreaseLimitOrder أو SettleLimitOrder أولاً للمضي قدمًا.

• ينقل amount من ATA المالك إلى input_vault.
• limit_order.total_amount += amount؛ tick.orders_amount += amount.

​

DecreaseLimitOrder