تعليمات 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 (= الرسوم الديناميكية معطلة نهائيًا لهذا البول).

​

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 = ملاءمة للمبلغ 0؛ false = ملاءمة للمبلغ 1

• tick_lower < tick_upper، وكلاهما من مضاعفات pool.tick_spacing، وضمن النطاق [MIN_TICK, MAX_TICK].
• tick arrays المطلوبة ممرَّرة ومُهيَّأة (أو مُنشأة هنا عبر CPI لـ InitTickArray في المعاملة).
• لدى المستخدم ما لا يقل عن amount_0_max وamount_1_max في ATAs المصدر.

• يوجد personal_position، ومضبوط liquidity، وملتقطة fee_growth_inside_last.
• تُحدَّث مدخلات tick array عند tick_lower وtick_upper (liquidity_gross += L، liquidity_net ± L، ولقطات نمو الرسوم مُصانة).
• pool_state.liquidity += L إذا كان المركز في النطاق (tick_lower ≤ tick_current < tick_upper).

​

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 لنقاط الطرف.
• جمع الرسوم والمكافآت المستحقة منذ آخر لمسة وإضافتها إلى tokens_fees_owed_{0,1} / reward_amount_owed. تُصرف هذه فقط عند DecreaseLiquidity أو CollectReward، لا عند الزيادة.

​

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

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

• حرق NFT.
• إغلاق حساب NFT mint وحساب personal_position، مع استرداد الإيجار إلى payer.

​

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. مطابقة أوامر الحد — عندما يتجاوز مسار السعر نقطة tick تحتوي على أوامر حد مفتوحة، يملأ البرنامج أولاً سيولة أوامر الحد المتاحة عند تلك النقطة (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      // مبلغ رمز الإدخال

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

• يوجد 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 (مشرف)

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 (مشرف)

​

CollectProtocolFee / CollectFundFee

​

InitializeReward

open_time:     u64
end_time:      u64
emissions_per_second_x64: u128   // Q64.64

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

​

SetRewardParams

​

UpdateRewardInfos

​

CollectReward

• تسوية نمو المكافأة (بنفس نمط الرسوم).
• تحويل المبلغ المستحق إلى ATA المستلم، وتصفير reward_amount_owed[i].

​

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

​

الخطوات التالية

• products/clmm/code-demos — نماذج TypeScript قابلة للتشغيل.
• products/clmm/fees — تفاصيل استحقاق الرسوم والمكافآت.
• reference/error-codes — جدول أخطاء Anchor الكامل لـ CLMM.

• raydium-io/raydium-clmm — programs/amm/src/instructions
• Raydium SDK v2 — @raydium-io/raydium-sdk-v2