تعليمات CLMM

مرجع تعليمات CLMM الكامل: دورة حياة المجمع، إدارة المراكز، المبادلة، وتدفقات المكافآت.

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

عرض النسخة الإنجليزية →

تقترن هذه الصفحة بـ products/clmm/accounts (ما هي الحسابات) و products/clmm/math (ما هي الرياضيات). وهي مرجع معتمد للمعاملات وترتيب الحسابات؛ تأتي تخطيطات البايتات المحددة من IDL.

أعاد ترقية البرنامج 2026-09 بناء CLMM على Anchor 1.0.2 / Solana 3.1.10، وأضاف تعليمة المسؤول CollectExcessLamports، وغيّر ما تكتبه CreateAmmConfig في owner / fund_owner. لم تغيّر أي تعليمة موجهة للمستخدم حساباتها أو معاملات أو رياضيات. انظر إدخال السجل 2026-09-30.

أعاد ترقية البرنامج 2026-10-22 تسمية CreatePermissionedPool إلى CreateCustomizablePoolV2، وتجعلها قابلة للاستدعاء من قبل أي شخص، وتزيل حساب Permission مع تعليماته الإداريتين. انظر إدخال السجل 2026-10-22.

​

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

المجموعة	التعليمة	ملاحظات
المسؤول	CreateAmmConfig	تحديد فئة رسوم جديدة.
المسؤول	UpdateAmmConfig	تغيير الأسعار على فئة موجودة.
المسؤول	UpdatePoolStatus	إيقاف/استئناف العمليات على مجمع.
المسؤول	CreateSupportMintAssociated	السماح بقائمة تكوين امتداد Token-2022 mint للاستخدام في مجمعات CLMM.
المسؤول	CreateOperationAccount	تهيئة حساب العملية على مستوى البرنامج (مرة واحدة).
المسؤول	UpdateOperationAccount	تعديل قائمة بيضاء حساب العملية.
المسؤول	CreateDynamicFeeConfig	إنشاء مجموعة معاملات رسوم ديناميكية قابلة لإعادة الاستخدام تحت فهرس u16.
المسؤول	UpdateDynamicFeeConfig	تعديل DynamicFeeConfig موجود. المجمعات التي التقطت لقطة منه بالفعل لا تتأثر.
المجمع	CreatePool	تهيئة مجمع CLMM مرتبط بـ AmmConfig. المسار القياسي، FromInput-fee. يتعايش مع CreateCustomizablePool.
المجمع	CreateCustomizablePool	موصى به للمجمعات الجديدة. نفس الشكل مثل CreatePool بالإضافة إلى collect_fee_on وعلم enable_dynamic_fee اختياري.
المجمع	CreateCustomizablePoolV2	إنشاء مجمع إضافي لزوج وفئة رسوم لديها واحد بالفعل، باستخدام seed_index غير صفري يوفره العميل مطويًا في PDA المجمع. بدون إذن. كان يُسمى CreatePermissionedPool قبل 2026-10-22.
المركز	OpenPosition / OpenPositionV2 / OpenPositionWithToken22Nft	صك NFT للمركز. OpenPositionV2 يحل محل V1؛ OpenPositionWithToken22Nft يصدر NFT كـ Token-2022. تجمد مسارات V2 حساب NFT فقط عندما تطابق سلطة التجميد لـ mint الخزان الأساسي قائمة المُصدرين المقيدين. وإلا يبقى الحساب مذاب.
المركز	IncreaseLiquidity / IncreaseLiquidityV2	إضافة السيولة إلى مركز موجود.
المركز	DecreaseLiquidity / DecreaseLiquidityV2	إزالة السيولة؛ تجميع الرسوم المستحقة.
المركز	ClosePosition	حرق NFT وإغلاق PersonalPositionState. إذا كان حساب NFT مجمدًا، فقم أولاً بإذابته مع توفير PDA المجمع كحساب متبقي.
المركز	CloseProtocolPosition	كنس إداري فقط لـ PDAs ProtocolPositionState القديمة. البرنامج الحالي لم يعد ينشئ أو يقرأ ProtocolPositionState — هذه التعليمة موجودة فقط لاسترجاع الإيجار على الحسابات التي أنشأتها إصدارات البرنامج الأقدم.
المبادلة	Swap / SwapV2	مبادلة السيولة الثابتة. يطبق كلا المتغيرين رسوم ديناميكية وتوجيه رسوم أحادي الجانب ومطابقة أوامر الحد؛ الفرق الوحيد هو أن SwapV2 يقبل Token-2022 mints (يتطلب متغير V1 أن تكون كلا الخزانات SPL Token كلاسيكي).
المبادلة	SwapRouterBaseIn	متعدد القفزات، يستخدمه الموجه.
أمر الحد	OpenLimitOrder	ضع أمر بيع عند علامة. الرموز غير المملوءة تجلس على العلامة؛ محرك المطابقة يملأها عندما يعبر السعر.
أمر الحد	IncreaseLimitOrder	إضافة إلى أمر مفتوح موجود.
أمر الحد	DecreaseLimitOrder	تقليل أو إلغاء أمر مفتوح؛ يدفع الباقي غير المملوء بالإضافة إلى أي مخرجات تم تسويتها بالفعل.
أمر الحد	SettleLimitOrder	دفع رموز الإخراج المملوءة إلى مالك الأمر. قابل للاستدعاء من قبل المالك أو حارس التشغيل.
أمر الحد	CloseLimitOrder	إغلاق حساب أمر مستهلك بالكامل. الإيجار يعود دائمًا إلى owner الأمر. قابل للاستدعاء من قبل المالك أو الحارس.
الرسوم	CollectProtocolFee	كنس إداري لرسوم البروتوكول.
الرسوم	CollectFundFee	كنس إداري لرسوم الصندوق.
المكافآت	InitializeReward	إرفاق تدفق مكافآت جديد بمجمع.
المكافآت	SetRewardParams	تغيير معدل الانبعاث/النهاية للمكافأة الموجودة.
المكافآت	UpdateRewardInfos	تسوية نمو المكافآت إلى الآن (يُستدعى بواسطة أي مبادلة / تغيير موضع).
المكافآت	TransferRewardOwner	نقل السلطة التي يمكنها تعيين أو تعبئة تدفق مكافآت.
المكافآت	CollectRemainingRewards	بعد end_time لتدفق المكافآت، كنس أي رموز غير مخصصة مرة أخرى إلى الممول.
المسؤول	CloseSupportMintAssociated	إزالة تسجيل SupportMintAssociated للـ mint واسترجاع إيجاره.
المسؤول	CollectExcessLamports	كنس lamports فوق الحد الأدنى المعفي من الإيجار من PoolState وخزانات مجمع واحد، بالإضافة إلى أي PDAs مملوكة لـ CLMM تم تمريرها. admin أو محفظة كنس lamports المخصصة. تمت الإضافة 2026-09.

لا توجد تعليمة init-tick-array، ولا حاجة لها. يتم إنشاء مصفوفة علامة داخل OpenPosition* / IncreaseLiquidity* بواسطة TickArrayState::get_or_create_tick_array، مدفوعة من قبل payer. مرر PDA مصفوفة العلامة (ربما لا تزال غير مهيأة، مملوكة للنظام) كـ tick_array_lower / tick_array_upper والبرنامج يخصصها إذا كانت مفقودة. OpenLimitOrder يفعل الشيء نفسه لـ tick_array الواحد الخاص به.

معظم التعليمات الإدارية فقط (CreateAmmConfig، UpdateAmmConfig، UpdatePoolStatus، CreateOperationAccount، UpdateOperationAccount، CloseProtocolPosition) محمية بمفتاح admin المشفر في البرنامج. CreateSupportMintAssociated / CloseSupportMintAssociated تقبل إما مفتاح admin أو مفتاح مالك دعم mint مخصص؛ CollectExcessLamports تقبل إما مفتاح admin أو محفظة كنس lamports مخصصة. تعليمات إدارة تدفق المكافآت (TransferRewardOwner، CollectRemainingRewards) محمية بممول المكافآت، وليس مسؤول البرنامج.

لاحقة V2 تعني “يدعم Token-2022 على الخزانات / NFT، يتطلب فتحة امتداد bitmap”. يختار SDK V2 بشكل افتراضي للمجمعات الجديدة.

​

CreatePool

المعاملات

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

الحسابات (مختصرة)

#	الاسم	W	S	ملاحظات
1	pool_creator	W	S
2	amm_config			فئة الرسوم المختارة.
3	pool_state	W		init هنا.
4	token_mint_0			مرتبة.
5	token_mint_1
6	token_vault_0	W		init هنا، مملوكة بواسطة PDA سلطة المجمع.
7	token_vault_1	W
8	observation_state	W		init هنا.
9	tick_array_bitmap	W		PDA TickArrayBitmapExtension؛ init هنا.
10	token_program_0			البرنامج الذي يمتلك token_mint_0 — SPL Token أو Token-2022.
11	token_program_1			البرنامج الذي يمتلك token_mint_1.
12	system_program
13	rent

الفتحات 10 و 11 هي لكل mint، وليس “SPL Token ثم Token-2022”. كل واحدة مقيدة بـ mint::token_program على mint المطابق، لذا بالنسبة لمجمع token_mint_0 هو Token-2022 و token_mint_1 هو SPL كلاسيكي يجب عليك تمرير Token-2022 في الفتحة 10 و SPL Token في الفتحة 11. CreateCustomizablePool و CreateCustomizablePoolV2 تستخدم نفس الفتحتين.

الشروط المسبقة

• 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

موصى به للمجمعات الجديدة. نفس التأثير مثل CreatePool بالإضافة إلى وضع جمع الرسوم لكل مجمع واختيار رسوم ديناميكية اختياري.

المعاملات

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

الحسابات — بالضبط الـ 13 حساب المعلن عنها لـ CreatePool. dynamic_fee_config ليس حساب معلن عنه.

عندما enable_dynamic_fee = true، يجب توفير DynamicFeeConfig للالتقاط كـ آخر remaining_account — يقرأ المعالج ctx.remaining_accounts.last(). أي PDAs تجاوز SupportMintAssociated يجب أن تأتي قبله، وإلا يلتقط البرنامج الحساب الخاطئ ويفشل في فك التسلسل. حذفه بينما العلم مضبوط يفشل مع AccountLack.

الشروط المسبقة — نفس CreatePool. إذا كان enable_dynamic_fee = false، لا يلزم remaining_account وأي يتم تمريره يتم فحصه فقط لسجلات دعم mint.

الشروط اللاحقة

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

يتم تعيين fee_on وبت تفعيل الرسوم الديناميكية فقط عند إنشاء المجمع. لا يوجد ترقية في المكان — المجمعات التي تم إنشاؤها عبر CreatePool القديم لا يمكنها الحصول بأثر رجعي على رسوم ديناميكية أو رسوم أحادية الجانب. يجب أن تستخدم النشرات الجديدة هذه التعليمة بشكل افتراضي.

​

CreateCustomizablePoolV2

يشتق كل من CreatePool و CreateCustomizablePool عنوان PDA للمجموعة من ["pool", amm_config, token_mint_0, token_mint_1]، لذا يوجد عنوان مجموعة قانوني واحد بالضبط لكل ثلاثية (config, mint0, mint1) — محاولة init ثانية بنفس البذور تفشل. يرفع CreateCustomizablePoolV2 هذا القيد بدمج seed_index: u16 يوفره العميل في بذور PDA للمجموعة، مما يسمح بـ مجموعات متعددة لنفس الزوج ومستوى الرسوم — كل واحدة بعنوانها الخاص. يمكن لأي شخص استدعاؤها.

كل شيء آخر عن المجموعة متطابق مع CreateCustomizablePool: تأخذ نفس CreateCustomizableParams وتدعم الرسوم أحادية الجانب والاختيار الديناميكي للرسوم.

حتى ترقية 2026-10-22، كانت هذه التعليمة تُسمى CreatePermissionedPool وتتطلب من الدافع الاحتفاظ بـ PDA Permission صادرة من المسؤول. أعادت الترقية تسميتها وأزالت حساب permission وحذفت آلية الأذونات. تغيّر المميز مع الاسم، لذا يجب إعادة بناء العملاء المبنيين مقابل CreatePermissionedPool.

الحجج

customizable_params: CreateCustomizableParams   // same struct as CreateCustomizablePool
seed_index:          u16                          // must be non-zero; folded into the pool PDA seeds

الحسابات

#	الاسم	W	S	ملاحظات
1	payer	W	S	يدفع الإيجار لكل حساب جديد. أي محفظة.
2	pool_creator			مسجل كـ pool_state.owner. قد يختلف عن payer. ليس موقّعاً ولا يتم التحقق منه.
3	amm_config			مستوى الرسوم الذي تربط به المجموعة.
4	pool_state	W		init في ["pool", amm_config, token_mint_0, token_mint_1, seed_index.to_le_bytes()].
5	token_mint_0			يجب أن يأتي قبل token_mint_1.
6	token_mint_1
7	token_vault_0	W		PDA ["pool_vault", pool_state, token_mint_0].
8	token_vault_1	W		PDA ["pool_vault", pool_state, token_mint_1].
9	observation_state	W		PDA ["observation", pool_state].
10	tick_array_bitmap	W		PDA ["pool_tick_array_bitmap_extension", pool_state].
11	token_program_0			البرنامج الذي يمتلك token_mint_0.
12	token_program_1			البرنامج الذي يمتلك token_mint_1.
13	system_program
14	rent

remaining_accounts: PDAs سجل العملات المساعدة عندما تحتاج عملة Token-2022 إليها، و DynamicFeeConfig أخيراً عندما enable_dynamic_fee = true — كما في CreateCustomizablePool.

الشروط المسبقة

• seed_index != 0. يتم رفض seed_index بقيمة 0 لأنها محجوزة للمجموعات القديمة؛ مكون البذرة [0, 0] هو ما يجعل عنوان المجموعة القديمة ينهار إلى الشكل الكلاسيكي ذي البذور الأربع.
• لا توجد مجموعة بالفعل في العنوان المشتق.
• نفس قواعد العملات / قائمة السماح مثل CreatePool.

الشروط اللاحقة

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

لأن pool_creator غير مفحوص، يمكن لأي دافع كتابة أي عنوان في pool_state.owner. يمكن لهذا العنوان استدعاء InitializeReward على المجموعة، لكن هذا ليس إثباتاً لمن أنشأ المجموعة. يجب على المدمجين عدم تصنيف أو ترتيب مجموعات V2 حسب owner.

​

OpenPositionV2 / OpenPositionWithToken22Nft

إنشاء موضع جديد داخل مجموعة موجودة.

الحجج

tick_lower_index: i32
tick_upper_index: i32
tick_array_lower_start_index: i32
tick_array_upper_start_index: i32
liquidity:  u128              // desired L (or 0 to use amounts below)
amount_0_max: u64
amount_1_max: u64
with_metadata: bool           // write NFT metadata (Metaplex)
base_flag: Option<bool>       // true = fit to amount0; false = fit to amount1

الحسابات — للمتغيرين قوائم حسابات مختلفة. يعلن OpenPositionV2 عن 22؛ OpenPositionWithToken22Nft يعلن عن 20.

OpenPositionV2، بالترتيب:

#	الاسم	W	S	ملاحظات
1	payer	W	S
2	position_nft_owner
3	position_nft_mint	W	S	زوج مفاتيح جديد.
4	position_nft_account	W		ATA المالك للـ NFT.
5	metadata_account	W		PDA بيانات Metaplex. معلن بدون شروط، حتى عندما with_metadata = false.
6	pool_state	W
7	protocol_position			بقايا؛ UncheckedAccount للقراءة فقط.
8	tick_array_lower	W		تم إنشاؤها هنا إذا لم تُهيأ.
9	tick_array_upper	W		نفس الشيء.
10	personal_position	W		تم إنشاؤها هنا.
11	token_account_0	W		ATA مصدر المستخدم.
12	token_account_1	W
13	token_vault_0	W
14	token_vault_1	W
15	rent
16	system_program
17	token_program
18	associated_token_program
19	metadata_program			Metaplex Token Metadata.
20	token_program_2022
21	vault_0_mint
22	vault_1_mint

OpenPositionWithToken22Nft هي نفس القائمة مع metadata_account (5) و metadata_program (19) محذوفة — تكتب بيانات الموضع من خلال امتداد البيانات الوصفية Token-2022 على عملة NFT بدلاً من ذلك — مما يعطي 20 حساباً. position_nft_mint الخاص به هو Signer عادي و position_nft_account هو UncheckedAccount.

tick_array_bitmap_extension ليس حساباً معلناً على أي من المتغيرين. عندما يقع نطاق الموضع خارج tick_array_bitmap المضمن للمجموعة (±512 مصفوفة tick)، أضف PDA TickArrayBitmapExtension في البذور ["pool_tick_array_bitmap_extension", pool_state] كـ remaining_accounts[0].

الرياضيات — انظر products/clmm/math. بناءً على base_flag، يحل البرنامج إما liquidity أو (amount_0_max, amount_1_max) إلى L الفعلي ومبالغ الرموز الفعلية المستهلكة.

الشروط المسبقة

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

الشروط اللاحقة

• يوجد personal_position، مع تعيين liquidity، و fee_growth_inside_last مأخوذة لحظة.
• تم تحديث إدخالات مصفوفة tick في 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 و تطابق سلطة تجميد أي من عملات الخزان قائمة المُصدرين المقيدين بـ CLMM. فقط هذا المسار V2 المطابق يجمد الحساب. لا يجمد OpenPosition V1.

الأخطاء الشائعة — TickInvalidOrder (tick_lower >= tick_upper)، TickAndSpacingNotMatch (نقطة نهاية ليست مضاعفة tick_spacing)، InvalidTickIndex (خارج [MIN_TICK, MAX_TICK])، MissingTickArrayBitmapExtensionAccount (النطاق خارج الخريطة النقطية المضمنة ولم يتم إلحاق الامتداد)، NotApproved (pool_state.status يمنع الفتح)، ZeroAmountSpecified.

تجميد الموضع لا يضيف حسابات تعليمات معلنة أو حجج. يمكن للعملاء فتح هذه المواضع باستخدام تخطيطات V2 الموجودة. يتم اختيار السلوك على السلسلة من vault_0_mint و vault_1_mint.

​

IncreaseLiquidityV2

إضافة سيولة إلى موضع مفتوح بالفعل.

الحجج

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

الحسابات — 15، و غير قابلة للاشتقاق من OpenPosition: لا توجد rent، لا system_program، لا associated_token_program ولا حساب بيانات وصفية.

#	الاسم	W	S
1	nft_owner		S
2	nft_account
3	pool_state	W
4	protocol_position
5	personal_position	W
6	tick_array_lower	W
7	tick_array_upper	W
8	token_account_0	W
9	token_account_1	W
10	token_vault_0	W
11	token_vault_1	W
12	token_program
13	token_program_2022
14	vault_0_mint
15	vault_1_mint

أضف PDA TickArrayBitmapExtension في البداية كـ remaining_accounts[0] عندما يكون نطاق الموضع خارج الخريطة النقطية المضمنة.

التأثير

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

​

DecreaseLiquidityV2

إزالة السيولة من موضع.

الحجج

liquidity: u128
amount_0_min: u64
amount_1_min: u64

الحسابات — 16، و ليست بنفس الشكل أو الترتيب مثل IncreaseLiquidityV2: يتم تبديل personal_position و pool_state، تأتي الخزانات قبل مصفوفات tick، يتم تسمية الحسابات من جانب المستخدم recipient_token_account_*، وهناك memo_program إضافي.

#	الاسم	W	S
1	nft_owner		S
2	nft_account
3	personal_position	W
4	pool_state	W
5	protocol_position
6	token_vault_0	W
7	token_vault_1	W
8	tick_array_lower	W
9	tick_array_upper	W
10	recipient_token_account_0	W
11	recipient_token_account_1	W
12	token_program
13	token_program_2022
14	memo_program
15	vault_0_mint
16	vault_1_mint

الحسابات المتبقية — ثلاثة لكل مكافأة نشطة يتم جمعها، بالترتيب reward_token_vault(W)، recipient_token_account(W)، reward_vault_mint. أضف PDA TickArrayBitmapExtension عندما يكون نطاق الموضع خارج الخريطة النقطية المضمنة.

هذه هي أيضاً الطريقة الوحيدة لجمع الرسوم والمكافآت. لجمع دون تغيير الموضع، استدعها مع liquidity = 0، amount_0_min = 0، amount_1_min = 0.

التأثير

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

الانزلاق — amount_0_min و amount_1_min هما الحد الأدنى الذي يقبله المستخدم بعد خصم رسوم تحويل Token-2022 على جانب الإخراج.

​

ClosePosition

حرق NFT الموضع وإغلاق PersonalPositionState.

الحسابات المُعلَّنة

#	الاسم	W	S	ملاحظات
1	nft_owner	W	S	يجب أن يمتلك حساب رمز NFT الذي يحتوي على المبلغ 1.
2	position_nft_mint	W		يجب أن يطابق personal_position.nft_mint.
3	position_nft_account	W		حساب مالك NFT؛ قد يكون رمز SPL كلاسيكي أو Token-2022.
4	personal_position	W		مُغلق إلى nft_owner.
5	system_program			يُغلق حالة الموضع.
6	token_program			يجب أن يمتلك نعت NFT وحساب الرمز.

الحسابات المتبقية

• 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 الكلاسيكية وتبقى بإمداد صفر.

إذابة التجميد والحرق والإغلاق ذرية. لا يمكن لـ NFT أن يصبح قابلاً للتحويل بين تلك الخطوات.

فاصل عميل مشروط — تخطيط IDL المُعلَّن لم يتغير، لذا يستمر العملاء القدامى في إغلاق المواضع الموجودة وغير المجمدة. منشئ قديم يحذف حساب المجموعة المتبقي يفشل مع AccountLack عند إغلاق موضع مجمد. تمرير المجموعة لكل إغلاق هو أبسط استراتيجية متوافقة.

​

SwapV2

سر منحنى السيولة؛ إدخال دقيق أو إخراج دقيق حسب is_base_input.

الحجج

amount: u64                  // input if is_base_input=true, output otherwise
other_amount_threshold: u64  // min out or max in
sqrt_price_limit_x64: u128   // hard bound; 0 ⇒ unbounded
is_base_input: bool

الحسابات (مختصرة)

#	الاسم	W	S	ملاحظات
1	payer		S
2	amm_config
3	pool_state	W
4	input_token_account	W
5	output_token_account	W
6	input_vault	W
7	output_vault	W
8	observation_state	W
9	token_program
10	token_program_2022			V2.
11	memo_program			V2 (مطلوب لبعض مسارات Token-2022).
12	input_vault_mint, output_vault_mint			V2.
13	tick_array_bitmap_extension (اختياري)	W		إذا سار المبادلة إلى الامتداد.
14+	tick_array (متبقي)	W		عدد كافٍ من المصفوفات لتغطية النطاق المتوقع للسير.

يمرر المستدعون قائمة مرتبة من مصفوفات التكات التي تغطي سير المبادلة المتوقع؛ يستخدم البرنامج ما يحتاجه. يحسب SDK هذه القائمة عبر PoolUtils.computeAmountOutFormat أو نقطة نهاية الاقتباس في API.

الشروط المسبقة

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

الأخطاء الشائعة — TooLittleOutputReceived (انزلاق الإدخال الدقيق)، TooMuchInputPaid (انزلاق الإخراج الدقيق)، SqrtPriceLimitOverflow، NotEnoughTickArrayAccount، InvalidFirstTickArrayAccount، MissingTickArrayBitmapExtensionAccount، LiquidityInsufficient، NotApproved (بت المبادلة مضبوط على pool_state.status). لا يحتوي CLMM على متغير ExceededSlippage — هذا الاسم خاص بـ CPMM — ولا على TickArrayNotFound.

ما يفعله SwapV2 داخلياً مما يجب أن يعرفه المستدعون (بعد إصدار 2025):

1. رسم ديناميكي إضافي — إذا كان pool.dynamic_fee_info غير صفري، يحدّث البرنامج مراكم التقلب باستخدام مسافة التكات المقطوعة منذ آخر مبادلة (مع قواعد التصفية/الاضمحلال من products/ar/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.

Swap (V1) ينفذ نفس الرسم الديناميكي وتوجيه الرسم أحادي الجانب ومطابقة أوامر الحد مثل SwapV2؛ الميزة الوحيدة التي ينقصها هي دعم Token-2022 — يجب أن تكون كلا الخزائن رمز SPL كلاسيكي. يجب مبادلة المجموعات التي تحتوي على أي نعت Token-2022 عبر SwapV2. يفضل المجمّع و SDK بالفعل V2 لكل ساق CLMM حتى لا يضطر المستدعون إلى التفرع حسب نوع النعت.

​

OpenLimitOrder

ضع أمر بيع في تكة محددة. يجلس الأمر في مجموعة FIFO لكل تكة ويملأ عندما يسير السعر بجانبه.

الحجج

nonce_index:    u8       // user's chosen nonce-account index (0..255 per wallet)
zero_for_one:   bool     // true: sell token0 for token1; false: sell token1 for token0
tick_index:     i32      // must be a multiple of pool.tick_spacing
amount:         u64      // input-token amount

الحسابات (مختصرة)

#	الاسم	W	S	ملاحظات
1	payer	W	S	مالك الأمر؛ يدفع الإيجار.
2	pool_state	W
3	tick_array	W		مصفوفة التكات التي تحتوي على tick_index.
4	limit_order_nonce	W		PDA. init_if_needed — تُنشأ عند أول أمر للمستخدم تحت هذا nonce_index.
5	limit_order	W		PDA. init هنا.
6	input_token_account	W		ATA الإدخال للمستخدم. تُفحص من أجل frozen.
7	output_token_account	W		ATA الإخراج للمستخدم. لا يُخصم عند الفتح — مطلوب فقط حتى يتمكن البرنامج من تأكيد أنه ليس frozen (أي يمكن تسليم الملء لاحقاً).
8	input_vault	W		خزانة إدخال المجموعة.
9	output_vault	W		خزانة إخراج المجموعة. يحدد نعت الإخراج لفحوصات output_token_account / output_vault_mint.
10	input_vault_mint			معالجة رسم Token-2022.
11	output_vault_mint			نعت جانب الإخراج (فحص التجميد المقترن).
12	input_token_program			SPL أو Token-2022.
13	system_program			يمول limit_order وlimit_order_nonce و — إذا لزم الأمر — تخصيص tick_array.

الحسابات المتبقية — [0] tick_array_bitmap_extension، مطلوب فقط عند تهيئة مصفوفة تكات يقع فهرس البداية الخاص بها خارج الخريطة النقطية المضمنة للمجموعة. لا تمرر شيئاً وإلا.

لا يوجد حساب rent: تنتهي البنية عند system_program، 13 حساب معلن. rent ضائع في الموضع 14 يهبط بالضبط حيث يُقرأ امتداد الخريطة النقطية الاختياري، لذا يبدو الأمر أنه يعمل حتى المرة الأولى التي يجب فيها إنشاء مصفوفة تكات خارج الخريطة النقطية المضمنة — ثم يفشل.

تغيير قائمة الحسابات (إصدار 2026-07). يأخذ OpenLimitOrder الآن أيضاً حسابات جانب الإخراج — output_token_account وoutput_vault وoutput_vault_mint — بالإضافة إلى جانب الإدخال. تُستخدم فقط للتحقق: يرفض البرنامج الأمر إذا كان حساب رمز الإدخال أو الإخراج للمالك مجمداً. هذا يضمن أن الملء يمكن فعلاً تسويته إلى ATA الإخراج للمالك، وهذا مهم لنعوت Token-2022 المجمدة افتراضياً / قائمة السماح (مثل الرموز المرخصة) حيث قد لا يكون الحساب مذاباً بعد. يجب على العملاء المبنيين مقابل قائمة الحسابات أحادية الجانب الأقدم إضافة الحسابات الثلاثة للإخراج.

الشروط المسبقة

• لا 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 مُطلق.

الأخطاء الشائعة — NotApproved (حساب رمز الإدخال أو الإخراج مجمد، أو المجموعة لديها مبادلة / أوامر حد معطلة)، ZeroAmountSpecified (amount == 0 بعد رسم التحويل من جانب الإدخال)، InvalidLimitOrderAmount (المبلغ سينتج إخراج أقل من 1 وحدة أساسية في تلك التكة، أو تجاوز u64)، InvalidTickIndex (خارج [MIN_TICK, MAX_TICK]، أو على الجانب الخاطئ من tick_current للاتجاه المختار)، TickAndSpacingNotMatch (tick_index % pool.tick_spacing != 0)، OrderPhaseSaturated.

​

IncreaseLimitOrder

أضف إلى أمر مفتوح موجود. قابل للاستدعاء فقط من قبل owner الأمر.

الحجج

amount: u64    // additional input-token amount

الحسابات — 8، جانب الإدخال فقط. يحذف حساب nonce وجميع حسابات جانب الإخراج الثلاثة و system_program.

#	الاسم	W	S
1	owner		S
2	pool_state	W
3	tick_array	W
4	limit_order	W
5	input_token_account	W
6	input_vault	W
7	input_vault_mint
8	input_token_program

الشروط المسبقة

• 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    // input-token amount to withdraw (max = unfilled remainder)
amount_min: u64    // slippage floor on the input-side withdrawal

الحسابات — جانبا رمز الإدخال والإخراج:

#	الاسم	W	S
1	owner		S
2	pool_state	W
3	tick_array	W
4	limit_order	W
5	input_token_account	W
6	output_token_account	W
7	input_vault	W
8	output_vault	W
9	input_vault_mint, output_vault_mint
10	token_program, token_program_2022

التأثير

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

​

SettleLimitOrder

ادفع الرموز المُخرجة المملوءة إلى المالك دون تغيير الجزء غير المملوء من الأمر. مفيد عندما تريد محافظ auto_withdraw الآلية أن تدفع تدريجياً الملء الجزئي طويل الأمد.

المُستدعي — إما مالك الأمر owner، أو limit_order_admin للبرنامج (محفظة تشغيلية ساخنة خارج السلسلة تشغّل حلقة keeper آلية). لا توجد سلطة أخرى للـ keeper — لا يمكنه نقل أموال المستخدم خارج دفع المخرجات المملوءة إلى ATA مالك الأمر.

الحسابات

#	الاسم	W	S	ملاحظات
1	signer		S	المالك أو limit_order_admin
2	pool_state
3	tick_array
4	limit_order	W
5	output_token_account	W		ATA المخرجات للمالك.
6	output_vault	W		خزينة مخرجات المجموعة.
7	output_vault_mint
8	output_token_program

التأثير

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

​

CloseLimitOrder

أغلق حساب أمر مستهلك بالكامل. يتم دائماً إرجاع الإيجار إلى limit_order.owner بغض النظر عمن يوقّع.

المُستدعي — إما owner أو limit_order_admin.

الشروط المسبقة

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

التأثير

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

​

CreateDynamicFeeConfig (admin)

أنشئ مجموعة معاملات قابلة لإعادة الاستخدام تحت فهرس u16.

الحجج

index:                       u16
filter_period:               u16   // seconds; e.g. 30
decay_period:                u16   // seconds; e.g. 600. Must be > filter_period
reduction_factor:            u16   // 1..10_000; e.g. 5_000 = 50% retention per decay window
dynamic_fee_control:         u32   // 1..100_000; gain on the volatility-to-fee curve
max_volatility_accumulator:  u32   // ceiling

الحسابات

#	الاسم	W	S	ملاحظات
1	owner	W	S	مفتاح عام للمسؤول مُشفّر.
2	dynamic_fee_config	W		PDA، init هنا.
3	system_program

الأخطاء الشائعة — InvalidDynamicFeeConfigParams إذا كان decay_period <= filter_period أو أي حقل بقيمة 0 خارج الحدود.

​

UpdateDynamicFeeConfig (admin)

عدّل DynamicFeeConfig موجود. المجموعات التي التقطت بالفعل الإعدادات عند وقت الإنشاء لا يتم تحديثها بأثر رجعي؛ فقط المجموعات المُنشأة حديثاً التي تشير إلى هذا الإعداد ستلتقط القيم الجديدة.

الحجج — نفس خمسة حقول المعايرة من CreateDynamicFeeConfig (filter_period، decay_period، reduction_factor، dynamic_fee_control، max_volatility_accumulator)؛ index ثابت عند الإنشاء ولا يتم تمريره هنا.

​

CollectProtocolFee / CollectFundFee

امسح الرسوم المتراكمة للبروتوكول/الصندوق من خزائن المجموعة إلى المستقبِل، مما يصفّر حقول PoolState.protocol_fees_* / fund_fees_* المقابلة. هذا ليس تخطيط CPMM — CLMM لا يحتوي على حساب authority، وحقول المستقبِل مسماة recipient_token_account_{0,1} بدلاً من recipient_token_{0,1}_account.

الحجج — amount_0_requested: u64، amount_1_requested: u64.

#	الاسم	W	S	ملاحظات
1	owner		S	amm_config.owner (أو amm_config.fund_owner لمتغير الصندوق)، أو مسؤول البرنامج؛ وإلا NotApproved.
2	pool_state	W
3	amm_config			address = pool_state.amm_config.
4	token_vault_0	W
5	token_vault_1	W
6	vault_0_mint
7	vault_1_mint
8	recipient_token_account_0	W
9	recipient_token_account_1	W
10	token_program
11	token_program_2022

تم التغيير في 2026-09: الإعدادات الجديدة لم تعد تأخذ مالكي الرسوم من الموقّع. يكتب create_amm_config الآن protocol_fee_owner::ID المُشفّر للبرنامج في owner و fund_fee_owner::ID في fund_owner. سابقاً، كان ينسخ مفتاح موقّع المسؤول إلى كليهما. على mainnet هذه هي نفس المفاتيح المخزنة بالفعل على جميع الإعدادات الـ 21 الموجودة. العناوين موجودة في reference/program-addresses.

الموقّعون المقبولون أعلاه لم يتغيروا. يمكن للمسؤول جمع من أي إعداد، وحسابات AmmConfig الموجودة لا يتم إعادة كتابتها. اقرأ owner / fund_owner من الحساب بدلاً من افتراض أي قيمة. معاملات UpdateAmmConfig 3 و 4 لا تزال تدويرهما.

​

CollectExcessLamports

مسح المسؤول للـ lamports فوق الحد الأدنى المعفي من الإيجار على الحسابات التي يتحكم بها CLMM. تمت إضافته في ترقية 2026-09 لاسترجاع الإفراط في التمويل الذي يتركه SIMD-0437 rent reduction على الحسابات المُنشأة قبل كل خطوة.

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

الحجج: لا توجد.

الحسابات

#	الاسم	W	S	ملاحظات
1	collect_lamports_wallet	W	S	يستقبل كل lamport مُمسوح. يجب أن يكون مسؤول برنامج CLMM أو محفظة جمع lamports المخصصة (انظر reference/program-addresses). أي موقّع آخر يفشل مع NotApproved.
2	pool_state	W		المجموعة التي يتم مسحها. بذور PDA الخاصة بها توقّع CPIs برنامج الرموز، والحساب يتم مسحه دائماً بنفسه.
3	token_program			SPL Token.
4	token_program_2022			Token-2022. كلا البرنامجين مطلوبان؛ تختار التعليمات واحداً لكل حساب مصدر.
5..	remaining_accounts	W		M حساب مصدر، أي عدد، أي ترتيب.

النطاق: مجموعة واحدة لكل استدعاء. CLMM لا يحتوي على سلطة خزينة على مستوى البرنامج. خزائن كل مجموعة مملوكة من قبل PoolState الخاص بها. لذلك يجب أن يكون لكل مصدر برنامج رموز pool_state في الفتحة 2 كسلطة له: token_vault_0، token_vault_1، أو أحد خزائن المكافآت لتلك المجموعة. إذا مررت خزينة مجموعة أخرى أو حساب رموز المستخدم، فإن فحص مالك برنامج الرموز يفشل والتعليمة بأكملها تنعكس. لا يتم تخطيها. لا يمكن مسح نقوش NFT للمواضع، لأن سلطة الضرب الخاصة بهم تم إلغاؤها عند فتح الموضع.

كيفية التعامل مع كل حساب مصدر

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

المسح	مالك حساب المصدر	المعالجة
1	SPL Token أو Token-2022، حساب رموز غير أصلي	CPI WithdrawExcessLamports (مميز برنامج الرموز 38)، موقّع من قبل pool_state.
1	SPL Token أو Token-2022، أصلي (wSOL) حساب رموز	WithdrawExcessLamports يرفض الحسابات الأصلية. يقوم البرنامج بـ CPI SyncNative، يقيس كم نما amount المُغلّف، ويستدعي UnwrapLamports (مميز 45) لهذا الفرق بالضبط. ثم يتطلب أن يساوي الرصيد المُغلّف قيمته قبل المزامنة، أو يفشل مع LamportsCalculateError (6052). خزينة مجموعة جانب SOL تحتفظ بسيولتها الكاملة.
2	pool_state (الفتحة 2)	مخصوم مباشرة إلى rent.minimum_balance(data_len).
2	برنامج CLMM: AmmConfig، ObservationState، TickArrayBitmapExtension، TickArrayState، PersonalPositionState، LimitOrderState، وما إلى ذلك	مخصوم مباشرة إلى rent.minimum_balance(data_len). الحساب لا يجب أن ينتمي إلى المجموعة في الفتحة 2.
—	أي شيء آخر	تم تخطيه بصمت. لا خطأ، لا lamports مُنقولة.

المسح 2 يغطي الحسابات التي دفع المستخدم إيجارها. PersonalPositionState أو LimitOrderState مُمرر هنا يتخلى عن فائضه مثل أي حساب مملوك من قبل CLMM آخر. يبقى معفياً من الإيجار ويحتفظ ببيانات الحساب. عند إغلاقه لاحقاً، يحصل المالك على ما يحتفظ به الحساب في تلك النقطة، وهو بعد المسح الحد الأدنى الحالي للإيجار.

حجم المعاملة هو الحد الحقيقي على عدد المصادر التي تناسب استدعاء واحد. إنه نفس القيد الموجود في المسح من جانب المحفظة الموصوف في solana-fundamentals/rent-and-reclaimable-rent.

الأخطاء الشائعة:

• NotApproved (6000): موقّع خاطئ.
• LamportsCalculateError (6052): رحلة wSOL ذهاباً وإياباً لم تصل إلى صفر.
• خطأ عدم تطابق مالك برنامج الرموز: مصدر رموز لا يملكه pool_state.
• InsufficientFunds: حساب مملوك من قبل البرنامج يحتفظ بأقل من حده الأدنى للإيجار.

لا يوجد منشئ SDK. @raydium-io/raydium-sdk-v2 لا يشحن منشئاً لهذا المسار الإداري. قم بترميزه يدوياً من IDL.

​

InitializeReward

أضف تدفق مكافآت جديد إلى مجموعة. قد يكون هناك ما يصل إلى 3 تدفقات نشطة في نفس الوقت.

الحجج — هيكل واحد، param: InitializeRewardParam:

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

ترميز السلك هو الحقول الثلاثة متتالية، لذا فإن التعليمة المبنية يدوياً لا تتأثر — لكن عميل يعتمد على IDL يجب أن يمرر كائن param واحد بدلاً من ثلاث حجج موضعية.

الحسابات

#	الاسم	W	S	ملاحظات
1	reward_funder	W	S
2	funder_token_account	W
3	amm_config
4	pool_state	W
5	operation_state			PDA حالة عملية CLMM يحد من إنشاء المكافآت.
6	reward_token_mint
7	reward_token_vault	W		init هنا.
8	reward_token_program
9	system_program، rent

الشروط المسبقة

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

​

SetRewardParams

مدّد أو أضف إلى أو غيّر معدل الانبعاث على تدفق مكافآت موجود. عادة ما يتم استدعاؤها من قبل منشئ مجموعة أو multisig Raydium. القيود تعيش على السلسلة: يمكنك عادة تمديد end_time أو زيادة الانبعاثات، وليس تقليلها بأثر رجعي. تحقق من قائمة المالكين في operation_state.

​

UpdateRewardInfos

محاسبة بحتة — تسوي reward_growth_global_x64 للوقت الحالي بضرب emissions_per_second × Δt / liquidity. يتم استدعاؤها داخلياً من قبل كل تعليمة تلمس السيولة. تُعرّض كتعليمة مستقلة لأن الجهات الفاعلة الخارجية (واجهات المستخدم، الـ cranks) تريد أحياناً تشغيلها.

​

جمع المكافآت

لا توجد تعليمة جمع مكافآت مستقلة. البرنامج لا يعرّض نقطة دخول CollectReward، و IDL المنشور لا يحتوي على واحدة أيضاً.

يتم دفع المكافآت المستحقة لموضع من قبل DecreaseLiquidity / DecreaseLiquidityV2. لجمع دون تغيير الموضع، استدعها مع liquidity = 0، amount_0_min = 0، amount_1_min = 0. تذهب خزائن المكافآت وحسابات المستقبِل في remaining_accounts في مجموعات من ثلاثة لكل مكافأة نشطة، بالترتيب reward_token_vault(W)، recipient_token_account(W)، reward_vault_mint.

CollectRemainingRewards شيء مختلف: يسمح لـ ممول المكافآت، بعد end_time للتدفق، بمسح الرموز التي لم يتم تخصيصها أبداً لأي موضع.

​

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

التعليمة	pool.liquidity	pool.fee_growth_global	pool.reward_growth_global	personal_position.liquidity	مصفوفة Tick
CreatePool	0	0	—	—	—
OpenPosition	+ إذا كانت ضمن النطاق	—	—	جديد	إضافة liquidity_gross/net
IncreaseLiquidity	+ إذا كانت ضمن النطاق	تسوية المستحقات	تسوية المستحقات	+	تعديل
DecreaseLiquidity	− إذا كانت ضمن النطاق	تسوية المستحقات	تسوية المستحقات	−	تعديل
ClosePosition	—	—	—	محذوف	—
SwapV2	± عند التقاطعات	+	—	—	عبور وقلب خارج النطاق؛ مطابقة مجموعات أوامر الحد
OpenLimitOrder	—	—	—	—	orders_amount += amount على tick الهدف
IncreaseLimitOrder	—	—	—	—	orders_amount += amount
DecreaseLimitOrder	—	—	—	—	orders_amount -=، قد يغلق المجموعة
SettleLimitOrder	—	—	—	—	— (قراءة فقط على tick)
CloseLimitOrder	—	—	—	—	—
CreateCustomizablePool	0	0	—	—	—
UpdateRewardInfos	—	—	+	—	—
CollectExcessLamports	—	—	—	—	— (lamports فقط؛ أرصدة الرموز دون تغيير)

​

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

• 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