تعليمات 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] هو ما يجعل عنوان المجمع القديم ينهار إلى شكل البذور الأربع الكلاسيكي.
• permission PDA لـ 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].
• يتم تمرير PDAs مصفوفتَي التكات. ولا يلزم أن تكون موجودة بالفعل — إذ يخصّص get_or_create_tick_array المصفوفة المفقودة على حساب payer داخل هذه التعليمة. لا توجد تعليمة منفصلة لتهيئة مصفوفة التكات.
• المستخدم لديه على الأقل 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 للموضع يسجل pool_state كسلطة تجميد. يتم إزالة سلطة الصك بعد صك 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؛ لا يمكن إغلاق صك 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

amount:     u64    // مبلغ رمز الإدخال للسحب (الحد الأقصى = الباقي غير المملوء)
amount_min: u64    // حد الانزلاق على سحب جانب الإدخال

• يعيد حساب مبلغ الملء للأمر من unfilled_ratio_x64 للمجموعة منذ الفتح.
• يرسل الإخراج المملوء إلى output_token_account.
• يرسل amount من الإدخال غير المملوء مرة أخرى إلى input_token_account.
• يحدث limit_order وفقًا لذلك. إذا كان الباقي غير المملوء الجديد صفرًا، يغلق البرنامج الحساب ويسترجع الإيجار إلى owner.

​

SettleLimitOrder

• يحسب الإخراج التراكمي المستحق باستخدام (limit_order.unfilled_ratio_x64, tick.unfilled_ratio_x64).
• ينقل الفرق إلى output_token_account.
• يحدث limit_order.settled_output.
• لا يغلق الأمر؛ لا يزال مفتوحًا مقابل أي إدخال متبقي.

​

CloseLimitOrder

• الأمر لديه باقي غير مملوء صفري (إما amount == total_amount تم ملؤه وتسويته، أو قلل المالك الأمر إلى صفر ونسي الإغلاق).

• يغلق limit_order؛ يتم إرسال الإيجار إلى limit_order.owner.

​

CreateDynamicFeeConfig (admin)

index:                       u16
filter_period:               u16   // ثواني؛ على سبيل المثال 30
decay_period:                u16   // ثواني؛ على سبيل المثال 600. يجب أن يكون > filter_period
reduction_factor:            u16   // 1..10_000؛ على سبيل المثال 5_000 = 50% الاحتفاظ لكل نافذة اضمحلال
dynamic_fee_control:         u32   // 1..100_000؛ الكسب على منحنى التقلب إلى الرسوم
max_volatility_accumulator:  u32   // السقف

​

UpdateDynamicFeeConfig (admin)

​

CollectProtocolFee / CollectFundFee

​

InitializeReward

pub struct InitializeRewardParam {
    pub open_time:                u64,
    pub end_time:                 u64,
    pub emissions_per_second_x64: u128,   // Q64.64
}

• أقل من 3 تدفقات نشطة حاليًا على المجمع.
• يودع الممول total_emission = emissions_per_second × (end_time − open_time) من رمز المكافآت في القبو كجزء من هذه التعليمة.
• mint مكافآت مدرج في القائمة البيضاء لكل operation_state.

​

SetRewardParams

​

UpdateRewardInfos

​

جمع المكافآت

​

مصفوفة تغيير الحالة