تعليمات CPMM

كل تعليمة في برنامج CPMM، مع معاملات البرنامج وقائمة الحسابات والشروط السابقة واللاحقة والأخطاء التي قد تُرجعها.

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

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

هذه الصفحة هي المرجع الموثوق للتعليمات. للكود الذي يؤلف هذه التعليمات فعليًا، انظر products/cpmm/code-demos. لمعاني رموز الأخطاء انظر reference/error-codes.

ترقية البرنامج 2026-09 أعادت بناء CPMM على Anchor 1.0.2 / Solana 3.1.10، وأضافت تعليمة المسؤول CollectExcessLamports، وأزالت قائمة Token-2022 mint المرمزة بشكل ثابت، وغيّرت ما تكتبه CreateAmmConfig في protocol_owner / fund_owner. لم تغيّر أي تعليمة موجهة للمستخدم حساباتها أو معاملات البرنامج أو الرياضيات. انظر إدخال السجل من 2026-09-09.

تغيّرت قائمة الحسابات لكلا تعليمتي جمع رسوم المنشئ في 2026-09-19. تكتسب CollectCreatorFee حساب creator_fee_share؛ وتكتسب CollectCreatorFeePermissionless حساب amm_config و creator_fee_share. كلاهما مُلحق بعد system_program، لذا كل حساب يمرره العميل الموجود يحتفظ بفهرسه — لكن الحسابات الجديدة إلزامية، لذا المعاملة المبنية على التخطيط الأقدم تفتقد حسابات وترفض مع AccountNotEnoughKeys (3005) من Anchor. تُضاف تعليمتا مسؤول — CreateCreatorFeeShare و CloseCreatorFeeShare — و UpdateAmmConfig تأخذ param = 8 جديد. انظر إدخال السجل من 2026-09-19.

​

ملخص التعليمات

اسم المميز	من يوقّع	ما تفعله
Initialize	منشئ المجموعة	إنشاء مجموعة CPMM جديدة من mint اثنين و AmmConfig. بدون إذن؛ يمكن لأي شخص استدعاؤها. تُرمّز enable_creator_fee = false على المجموعة الجديدة. يمكن أن يكون حساب pool_state إما PDA القانوني أو مفتاح عشوائي جديد (انظر حسابات Initialize).
InitializeWithPermission	الدافع + حامل PDA Permission	متغير مع إذن من Initialize. يجب على المستدعي (الدافع) أن يمتلك PDA Permission مشتق من مفتاحه العام الخاص. يستخدمه المنصات التي تحتاج إلى إنشاء مجموعة محدود (مثل تخرجات LaunchLab). يسمح للمستدعي بتثبيت creator_fee_on (BothToken / OnlyToken0 / OnlyToken1) ويفرض enable_creator_fee = true على المجموعة الجديدة. يتم تعيين حقل creator على pool_state إلى حساب creator منفصل يتم تمريره، وليس الدافع. نفس مرونة PDA القانوني أو المفتاح العشوائي لـ pool_state كما في Initialize.
Deposit	مزود السيولة	إضافة السيولة في كلا الرمزين؛ استقبال رموز LP.
Withdraw	مزود السيولة	حرق رموز LP؛ استقبال كلا الرمزين الأساسيين بنسبة.
SwapBaseInput	المتبادل	مبادلة بمدخل دقيق (amount_in داخل، ≥ minimum_amount_out خارج).
SwapBaseOutput	المتبادل	مبادلة بمخرج دقيق (≤ maximum_amount_in داخل، amount_out خارج).
CollectProtocolFee	protocol_owner (من AmmConfig)	جمع رسوم البروتوكول المتراكمة من الخزائن.
CollectFundFee	fund_owner (من AmmConfig)	جمع رسوم الصندوق المتراكمة من الخزائن.
CollectCreatorFee	pool_creator	جمع رسوم المنشئ المتراكمة (إن كانت رسوم المنشئ مفعلة)، بعد خصم حصة البروتوكول، التي تُسجل في دلو البروتوكول للمجموعة.
CollectCreatorFeePermissionless	أي دافع	جمع رسوم المنشئ المتراكمة إلى حسابات الرموز القانونية لـ pool_creator، بعد خصم نفس حصة البروتوكول. يمكن للدافع إنشاء ATAs المستقبل المفقودة لكن لا يمكنه إعادة توجيه التحويل.
UpdatePoolStatus	admin	إيقاف / استئناف عمليات محددة على مجموعة عبر قناع بت.
UpdateAmmConfig	admin	تغيير معدلات الرسوم أو مالك البروتوكول/الصندوق على AmmConfig.
CreateAmmConfig	admin	إنشاء فئة رسوم جديدة (حساب AmmConfig جديد).
CreatePermissionPda	admin أو منشئ PDA إذن مفوض	صك PDA Permission يسمح لسلطة محددة باستدعاء InitializeWithPermission.
ClosePermissionPda	admin أو منشئ PDA الإذن المخصص	إلغاء PDA Permission صادر مسبقًا. منذ ترقية 2026-09 قد تغلق سلطة المنشئ المخصصة أيضًا منحة أصدرتها؛ كانت حصرية للمسؤول قبل ذلك.
CreateSupportMintAssociated	admin أو مالك mint الدعم المخصص	تسجيل mint Token-2022 الذي قد يفشل قائمة السماح بالامتداد، بإنشاء PDA SupportMintAssociated الخاص به.
CloseSupportMintAssociated	admin أو مالك mint الدعم المخصص	إزالة تسجيل mint.
CollectExcessLamports	admin أو محفظة جمع lamports المخصصة	جمع lamports فوق الحد الأدنى المعفي من الإيجار من الخزائن والـ LP mints و PDAs التي تتحكم فيها CPMM. أضيفت في 2026-09.
CreateCreatorFeeShare	admin أو مالك حصة رسوم المنشئ المخصص	تعيين حصة بروتوكول مخصصة من رسوم المنشئ لزوج واحد (creator, amm_config)، مع تجاوز AmmConfig.creator_fee_share_rate. أضيفت في 2026-09-19.
CloseCreatorFeeShare	admin أو مالك حصة رسوم المنشئ المخصص	إزالة هذا التجاوز؛ يعود الزوج إلى الافتراضي للإعدادات. أضيفت في 2026-09-19.

قناع الحالة: status كل مجموعة هو u8 حيث البت 0 = الإيداع معطل، البت 1 = السحب معطل، البت 2 = المبادلة معطلة (PoolStatusBitIndex { Deposit, Withdraw, Swap } في البرنامج). البت الواضح يعني أن العملية مسموحة؛ البت المعين يعني أنها موقوفة. تأخذ UpdatePoolStatus u8 خام وتستبدل القيمة الموجودة.

تمر الأقسام التالية عبر كل واحدة بالتفصيل. ترتيب الحسابات يتبع IDL الخاص بـ CPMM؛ SDK وعميل Rust في raydium-cp-swap/programs/cp-swap/src/instructions يطابقان هذا الترتيب.

​

Initialize

إنشاء مجموعة CPMM جديدة.

المعاملات

init_amount_0: u64
init_amount_1: u64
open_time:     u64   // Unix timestamp; swaps rejected before this

الحسابات (W = قابل للكتابة، S = موقّع)

#	الاسم	W	S	ملاحظات
1	creator	W	S	يدفع الإيجار؛ مسجل كـ pool_state.pool_creator.
2	amm_config			فئة الرسوم المختارة.
3	authority			PDA سلطة CPMM العامة.
4	pool_state	W	S*	يتم init هنا. إما PDA القانوني ["pool", amm_config, token_0_mint, token_1_mint] أو مفتاح عشوائي جديد — عندما لا يكون PDA القانوني، يتطلب البرنامج أن يوقّع pool_state (require_eq!(pool_account_info.is_signer, true)). يسمح مسار المفتاح العشوائي لمنشئ تجنب محاولات الجري الأمامي على PDA القانوني. يتم اشتقاق PDAs اللاحقة (lp_mint، vaults، observation_state) من pool_state.key() على أي حال.
5	token_0_mint			مرتب: token_0_mint < token_1_mint.
6	token_1_mint
7	lp_mint	W		يتم init هنا. السلطة معينة إلى authority.
8	creator_token_0	W		ATA المصدر لـ init_amount_0.
9	creator_token_1	W		ATA المصدر لـ init_amount_1.
10	creator_lp_token	W		ATA المنشئ على lp_mint. init (وليس init_if_needed) — يجب ألا يكون موجودًا بالفعل، وهو لا يمكن أن يكون، لأن lp_mint يتم إنشاؤه في نفس التعليمة.
11	token_0_vault	W		يتم init هنا. مملوك بواسطة authority.
12	token_1_vault	W
13	create_pool_fee	W		ATA الوجهة لـ create_pool_fee المدفوعة من قبل المنشئ.
14	observation_state	W		يتم init هنا.
15	token_program			SPL Token (لـ LP mint).
16	token_0_program			SPL Token أو Token-2022.
17	token_1_program			SPL Token أو Token-2022.
18	associated_token_program
19	system_program
20	rent

* يوقّع pool_state فقط على مسار المفتاح العشوائي؛ مسار PDA القانوني يعمل بدون توقيع pool_state.

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

• يتم ترتيب الـ mints (token_0_mint < token_1_mint حسب ترتيب البايت).
• لا يستخدم أي mint امتدادًا خارج قائمة السماح بـ CPMM (TransferFeeConfig، MetadataPointer، TokenMetadata، InterestBearingConfig، ScaledUiAmount) — انظر products/cpmm/accounts. يتخطى mint الذي يوجد PDA SupportMintAssociated الخاص به (البذرة [b"support_mint", mint]) فحص الامتداد — لكن يجب عليك إلحاق هذا PDA بـ remaining_accounts. البرنامج يفحص فقط الحسابات التي تمررها ولا يحمل PDA بنفسه أبدًا، لذا الاعتماد على السجل بدون توفير الحساب يفشل مع NotSupportMint (6007). الترتيب لا يهم (المطابقة حسب المفتاح)؛ مرر إدخالاً واحدًا لكل mint يحتاج إلى التجاوز. هذا السجل هو التجاوز الوحيد منذ أن أزالت ترقية 2026-09 قائمة الـ mint الأربعة المرمزة بشكل ثابت.
• لدى creator على الأقل init_amount_0 و init_amount_1 في ATAs الخاصة.
• amm_config.disable_create_pool == false.

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

• pool_state.lp_supply = sqrt(init_amount_0 * init_amount_1) — الجذر التربيعي الكامل. يتم صك المنشئ lp_supply − 100؛ وحدات 100 الأساسية المقفلة تُحسب في lp_supply لكن لا تُصك أبدًا.
• لذا lp_mint.supply == pool_state.lp_supply − 100 لحياة المجموعة. كل رياضيات حصة LP (الإيداع، السحب) تقسم على lp_supply، لذا استخدم هذا الحقل ولا تستبدل بـ supply الـ mint على السلسلة. يعود مع InitLpAmountTooLess إذا كان sqrt(...) < 100.
• يتم تهيئة observation_state؛ observation_index = 0 و pool_id = pool_state.key().
• يتم نقل lamports create_pool_fee من المنشئ إلى المستقبل ومزامنتها كـ SOL أصلي (إنها ATA wSOL).
• قناع حالة المجموعة هو 0 (الإيداع / السحب / المبادلة كلها مفعلة).
• enable_creator_fee = false و creator_fee_on = BothToken. لا تدعم Initialize تفعيل رسوم المنشئ — هذا المسار هو InitializeWithPermission.
• يتم رفع open_time إلى block_timestamp + 1 إذا مرر المستدعي قيمة <= block_timestamp. يتم رفض المبادلات قبل open_time؛ الإيداعات والسحوبات تعمل فورًا.

الأخطاء الشائعة (القائمة الكاملة في reference/error-codes)

• InvalidInput — mints غير مرتبة، أو mints متطابقة.
• NotSupportMint — امتداد Token-2022 محظور.
• ExceededSlippage — نادرًا؛ إذا أسفرت init_amount_0/1 عن صفر LP بسبب عدم تطابق الكسور العشرية.

​

Deposit

إضافة السيولة في كلا الرمزين بنسبة متناسبة مع المجموعة.

المعاملات

lp_token_amount:   u64   // how many LP tokens to mint to the LP
maximum_token_0:   u64
maximum_token_1:   u64

الحسابات

#	الاسم	W	S
1	owner		S
2	authority
3	pool_state	W
4	owner_lp_token	W
5	token_0_account	W
6	token_1_account	W
7	token_0_vault	W
8	token_1_vault	W
9	token_program
10	token_program_2022
11	vault_0_mint
12	vault_1_mint
13	lp_mint	W

الرياضيات

total_0 = vault_0 − protocol_fees_0 − fund_fees_0 − creator_fees_0    // same for side 1

needed_token_0 = ceil(lp_token_amount * total_0 / lp_supply)
transfer_0     = needed_token_0 + inverse_transfer_fee(needed_token_0) // Token-2022
require(transfer_0 <= maximum_token_0, "ExceededSlippage")             // same for side 1

هناك تفصيلان جديران بالملاحظة: أساس النسبة المئوية هو إجمالي الخزان المستثنى من الرسوم (vault_amount_without_fee، أي الرصيد الخام مطروحاً منه عدادات البروتوكول والصندوق والمنشئ المتراكمة)، وليس رصيد الخزان الخام؛ وتُفحص حد الانزلاق مقابل ما يحوله الدافع فعلياً، بعد إضافة رسم نقل Token-2022، وليس مقابل حركة الخزان الإجمالية.

لا يوجد تغيير في تناسب k — يتم قياس كل من الإجماليات وlp_supply بنفس العامل.

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

• lp_supply += lp_token_amount.
• vault_0 += needed_token_0 (صافي أي رسم نقل Token-2022 على الإدخال).
• vault_1 += needed_token_1 (صافي أي رسم نقل Token-2022 على الإدخال).

الأخطاء الشائعة — ExceededSlippage، ZeroTradingTokens، InvalidStatus إذا كان الإيداع موقوفاً.

​

Withdraw

حرق رموز LP واستقبال كلا الرمزين الأساسيين بنسبة متناسبة.

المعاملات

lp_token_amount:   u64
minimum_token_0:   u64
minimum_token_1:   u64

الحسابات

#	الاسم	W	S
1	owner		S
2	authority
3	pool_state	W
4	owner_lp_token	W
5	token_0_account	W
6	token_1_account	W
7	token_0_vault	W
8	token_1_vault	W
9	token_program
10	token_program_2022
11	vault_0_mint
12	vault_1_mint
13	lp_mint	W
14	memo_program

الحسابات الثلاثة عشر الأولى متطابقة مع Deposit، وlp_mint قابل للكتابة لأن رموز LP يتم حرقها. يأخذ Withdraw بالإضافة إلى ذلك حساباً رابع عشر، memo_program (مقيد address = memo::ID) — Deposit لا يأخذه. يفشل Withdraw بـ 13 حساباً في فك تسلسل Anchor، لذا لا يمكن لصاحب LP الخروج.

الرياضيات

total_0 = vault_0 − protocol_fees_0 − fund_fees_0 − creator_fees_0    // same for side 1

out_token_0     = min(total_0, floor(lp_token_amount * total_0 / lp_supply))
receive_token_0 = out_token_0 − transfer_fee(out_token_0)             // Token-2022
require(receive_token_0 >= minimum_token_0, "ExceededSlippage")       // same for side 1

// As with Deposit: the base is the fee-excluded vault total, and the floor is
// checked against what the LP actually receives, after the transfer fee.

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

• lp_supply -= lp_token_amount.
• تُرسل الخزانات out_token_0 / out_token_1 (إجمالي؛ يستقبل المستخدم صافي أي رسم نقل Token-2022).

​

SwapBaseInput

مبادلة بإدخال دقيق.

المعاملات

amount_in:            u64
minimum_amount_out:   u64

الحسابات

#	الاسم	W	S
1	payer		S
2	authority
3	amm_config
4	pool_state	W
5	input_token_account	W
6	output_token_account	W
7	input_vault	W
8	output_vault	W
9	input_token_program
10	output_token_program
11	input_token_mint
12	output_token_mint
13	observation_state	W

الترتيب input → output حسب اتجاه المستخدم، وليس حسب token_0 / token_1 الأساسي للمجموعة. يحدد البرنامج أي خزان هو أي بمطابقة الرموز.

الرياضيات — انظر products/cpmm/math.

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

• open_time <= now.
• pool_status يسمح بالمبادلة.
• لا يوجد رمز موقوف أو مجمد لهذه السلطة.
• amount_in > 0.

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

• ExceededSlippage — amount_out < minimum_amount_out.
• ZeroTradingTokens — تقريب التجارة إلى صفر.
• NotApproved — المجموعة موقوفة للمبادلات عبر UpdatePoolStatus.
• InvalidInput — الرموز لا تطابق أياً من رموز خزان المجموعة.

​

SwapBaseOutput

مبادلة بإخراج دقيق.

المعاملات

max_amount_in:  u64
amount_out:     u64

الحسابات — نفس SwapBaseInput.

الرياضيات — منحنى معكوس مع سقف، انظر products/cpmm/math.

الأخطاء الشائعة — ExceededSlippage (gross_in > max_amount_in)، ZeroTradingTokens، InvalidInput، NotApproved.

​

CollectProtocolFee

مسح رسوم البروتوكول المتراكمة من الخزانات إلى وجهة البروتوكول.

المعاملات — لا توجد.

الحسابات

#	الاسم	W	S	ملاحظات
1	owner		S	يجب أن يساوي amm_config.protocol_owner أو مفتاح المسؤول المشفر في البرنامج.
2	authority
3	pool_state	W
4	amm_config
5	token_0_vault	W
6	token_1_vault	W
7	vault_0_mint
8	vault_1_mint
9	recipient_token_0_account	W
10	recipient_token_1_account	W
11	token_program
12	token_program_2022

التأثير

transfer pool_state.protocol_fees_token0 from vault_0 to recipient_0
transfer pool_state.protocol_fees_token1 from vault_1 to recipient_1
pool_state.protocol_fees_token0 = 0
pool_state.protocol_fees_token1 = 0

لا يوجد تغيير في الأرصدة الفعالة للمنحنى (كانت الرسوم المتراكمة مستثناة بالفعل).

الخطأ الشائع — InvalidOwner (6001) إذا لم يكن الموقّع amm_config.protocol_owner ولا مسؤول البرنامج. (لا يوجد NotApproved على هذا المسار.)

​

CollectFundFee

نفس شكل CollectProtocolFee لكن موقّع بواسطة amm_config.fund_owner — أو، مرة أخرى، مسؤول البرنامج — وتصفير عدادات fund_fees_*. نفس InvalidOwner على موقّع خاطئ.

​

CollectCreatorFee

موقّع بواسطة pool_state.pool_creator. يسوي الرسم المتراكم للمنشئ وينقل حصة المنشئ إلى حسابات الرموز الخاصة به.

المعاملات — لا توجد.

الحسابات

#	الاسم	W	S	ملاحظات
1	creator	W	S	مقيد address = pool_state.pool_creator.
2	authority			PDA سلطة الخزان العام CPMM.
3	pool_state	W		يحتفظ بعدادات الرسم المتراكم للمنشئ.
4	amm_config			مقيد address = pool_state.amm_config. يحمل creator_fee_share_rate الافتراضي.
5	token_0_vault	W		يجب أن يطابق خزان الرمز 0 للمجموعة.
6	token_1_vault	W		يجب أن يطابق خزان الرمز 1 للمجموعة.
7	vault_0_mint			يجب أن يطابق token_0_vault.mint.
8	vault_1_mint			يجب أن يطابق token_1_vault.mint.
9	creator_token_0	W		الوجهة لحصة المنشئ من الرمز 0.
10	creator_token_1	W		الوجهة لحصة المنشئ من الرمز 1.
11	token_0_program			SPL Token أو Token-2022، يطابق الرمز 0.
12	token_1_program			SPL Token أو Token-2022، يطابق الرمز 1.
13	associated_token_program
14	system_program
15	creator_fee_share			تمت الإضافة 2026-09-19، مُلحقة بعد system_program. PDA في ["creator_fee_share", creator, amm_config]. يجب تمريره في كل استدعاء، لكنه غير مطلوب أن يكون موجوداً — عندما يكون فارغاً أو لا يملكه CPMM، يعود البرنامج إلى amm_config.creator_fee_share_rate. لا تزال قيود البذرة تنطبق، لذا يجب أن يكون العنوان هو PDA الأساسي.

التأثير

share_rate = creator_fee_share.share_rate   (if the account exists)
           | amm_config.creator_fee_share_rate   (otherwise)

shared_i  = floor(creator_fees_token_i * share_rate / 1_000_000)
creator_i = creator_fees_token_i - shared_i

transfer creator_i from vault_i to creator_token_i
pool_state.protocol_fees_token_i += shared_i     // stays in the vault
pool_state.creator_fees_token_i   = 0
pool_state.recent_epoch = current epoch

حصة البروتوكول لا تترك الخزان هنا — يتم إعادة تسميتها كرسم بروتوكول وتنتظر CollectProtocolFee. كلا العدادين مستثنيان بالفعل من رؤية المنحنى للخزان، لذا لا يتحرك سعر المجموعة. الاشتقاق الكامل في products/cpmm/fees.

الأخطاء الشائعة — NoFeeCollect عندما يكون كلا عدادي المنشئ صفراً (يتم الفحص قبل الانقسام)، InvalidInput (6003) إذا تجاوز share_rate المحلول 1_000_000، MathOverflow (6011) إذا كان حجز الحصة سيتجاوز protocol_fees_token_*، وخطأ ConstraintSeeds من Anchor إذا لم يكن creator_fee_share هو PDA الأساسي.

​

CollectCreatorFeePermissionless

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

يبقى CollectCreatorFee الأصلي قابلاً للاستدعاء، لذا يمكن للمنشئ الذي يريد التوقيع على جمع رسومه الخاص أن يفعل ذلك.

المعاملات — لا توجد.

الحسابات

#	الاسم	W	S	ملاحظات
1	payer	W	S	أي موقّع؛ يمول إنشاء حسابات الرموز المرتبطة المفقودة للمنشئ.
2	creator			يجب أن يساوي pool_state.pool_creator؛ لا يوقّع.
3	authority			PDA لسلطة خزينة CPMM العامة.
4	pool_state	W		يحتفظ بعدادات رسوم المنشئ المتراكمة.
5	token_0_vault	W		يجب أن يطابق خزينة الرمز 0 للمجموعة.
6	token_1_vault	W		يجب أن يطابق خزينة الرمز 1 للمجموعة.
7	vault_0_mint			يجب أن يطابق token_0_vault.mint.
8	vault_1_mint			يجب أن يطابق token_1_vault.mint.
9	creator_token_0	W		حساب الرموز المرتبط الأساسي للمنشئ لـ vault_0_mint؛ يُنشأ إذا كان مفقوداً.
10	creator_token_1	W		حساب الرموز المرتبط الأساسي للمنشئ لـ vault_1_mint؛ يُنشأ إذا كان مفقوداً.
11	token_0_program			SPL Token أو Token-2022، يطابق الرمز 0.
12	token_1_program			SPL Token أو Token-2022، يطابق الرمز 1.
13	associated_token_program			ينشئ حساب رموز مرتبط مفقود للمستقبل.
14	system_program			يمول إنشاء الحساب من payer.
15	amm_config			أضيف 2026-09-19، مُلحق بعد system_program. مقيّد بـ address = pool_state.amm_config.
16	creator_fee_share			أضيف 2026-09-19، مُلحق أخيراً. نفس PDA ونفس قاعدة الوجود الاختياري كما في CollectCreatorFee.

الحسابان الجديدان مُلحقان بعد system_program، وليسا مُدرجان. كل حساب من payer إلى system_program يحتفظ بالموضع الذي كان عليه قبل الترقية، لذا الفاصل نظيف: معاملة مبنية ضد تخطيط الأربعة عشر حساباً السابق للترقية لن تسيء قراءة خزينة كإعدادات — ستمرر ببساطة عدداً قليلاً جداً من الحسابات و Anchor سيرفضها برسالة AccountNotEnoughKeys (3005) قبل تشغيل أي قيد. الحسابات لا تزال إلزامية، لذا ألحق كليهما وحدّث IDL؛ لا توجد مسار توافق للتخطيط القديم.

التأثير — متطابق مع CollectCreatorFee أعلاه: يتم حل الحصة من creator_fee_share أو amm_config، يتم حجز حصة البروتوكول في protocol_fees_token_{0,1}، يتم تحويل حصة المنشئ إلى حسابات الرموز المرتبطة للمنشئ، يتم تصفير كلا عدادي المنشئ، ويتم تحديث recent_epoch. يُرجع NoFeeCollect عندما يكون كلا العدادين صفراً.

​

UpdatePoolStatus

إيقاف أو استئناف العمليات الفردية على مجموعة. حقل status هو قناع بت:

البت	العلم	التأثير عند التعيين
0	DEPOSIT_DISABLED	Deposit يرفض برسالة NotApproved.
1	WITHDRAW_DISABLED	Withdraw يرفض.
2	SWAP_DISABLED	SwapBaseInput / SwapBaseOutput يرفضان.

المعاملات

status: u8      // قناع البت الجديد

الحسابات

#	الاسم	W	S	ملاحظات
1	authority		S	يجب أن يطابق مفتاح المسؤول على برنامج CPMM.
2	pool_state	W

مفتاح المسؤول هو مفتاح عام مُترجم في البرنامج (crate::admin::ID)، وليس سلطة ترقية BPF — تغييره يتطلب ترقية برنامج. انظر reference/program-addresses للقيمة و security/admin-and-multisig لمن يحتفظ بها.

​

CreateAmmConfig

إنشاء فئة رسوم جديدة.

المعاملات

index:             u16
trade_fee_rate:    u64
protocol_fee_rate: u64
fund_fee_rate:     u64
create_pool_fee:   u64
creator_fee_rate:  u64

الحسابات

#	الاسم	W	S	ملاحظات
1	owner	W	S	المسؤول.
2	amm_config	W		يتم init هنا.
3	system_program

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

• لا يوجد AmmConfig موجود بنفس index.
• protocol_fee_rate + fund_fee_rate <= FEE_RATE_DENOMINATOR_VALUE.

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

النتائج: الرسوم على AmmConfig المُنشأ حديثاً تذهب إلى محافظ الرسوم المخصصة بدلاً من محفظة المسؤول. يبقى المسؤول موقّعاً مقبولاً للجمع — CollectProtocolFee / CollectFundFee يقبلان amm_config.protocol_owner / fund_owner أو crate::admin::ID — لذا لا يتعين تدوير أي شيء للمسح؛ ما تغيّر هو فقط حيث تذهب العائدات بشكل افتراضي. حسابات AmmConfig الموجودة لم تُعاد كتابتها — ما يتم تخزينه عليها لا يزال يحكم، لذا اقرأ دائماً protocol_owner / fund_owner من الحساب بدلاً من افتراض أي قيمة. معاملات UpdateAmmConfig 3 و 4 لا تزال تدورهما.

​

UpdateAmmConfig

تغيير معدلات الرسوم أو الملكية على AmmConfig موجود. يأخذ param: u8 (أي حقل لتحديثه) و value: u64. جدول الإرسال الكامل:

• param = 0 → trade_fee_rate (يؤكد trade_fee_rate + creator_fee_rate < 1_000_000)
• param = 1 → protocol_fee_rate (يؤكد ≤ 1_000_000 و + fund_fee_rate ≤ 1_000_000)
• param = 2 → fund_fee_rate (يؤكد ≤ 1_000_000 و + protocol_fee_rate ≤ 1_000_000)
• param = 3 → protocol_owner. المفتاح الجديد ليس في value: ألحقه كـ remaining_accounts[0] (القراءة فقط تمام). يجب ألا يكون المفتاح العام الافتراضي، وحذف الحساب يُحدث panic على unwrap().
• param = 4 → fund_owner. نفس الآلية كـ 3.
• param = 5 → create_pool_fee
• param = 6 → disable_create_pool (أي value غير صفري يعطّل)
• param = 7 → creator_fee_rate (يؤكد creator_fee_rate + trade_fee_rate < 1_000_000)
• param = 8 → creator_fee_share_rate (يؤكد ≤ 1_000_000). أضيف 2026-09-19. حصة البروتوكول الافتراضية من رسوم المنشئ على هذه الفئة؛ انظر products/cpmm/fees. لا علاقة لها بـ protocol_fee_rate، الذي يقسم رسوم التداول.

أي param آخر يُرجع InvalidInput.

التغييرات موقّعة من قبل المسؤول وتؤثر على كل مجموعة مرتبطة بهذا AmmConfig عند المبادلة التالية. لا هجرة؛ المجموعات ببساطة تقرأ القيم الجديدة.

​

CreateCreatorFeeShare

تعيين حصة بروتوكول مخصصة من رسوم المنشئ لزوج واحد (creator, amm_config)، مما يتجاوز AmmConfig.creator_fee_share_rate لكل مجموعة يملكها هذا المنشئ على فئة الرسوم تلك. أضيف في ترقية حصة رسوم المنشئ 2026-09-19.

المعاملات

share_rate: u64   // حصة البروتوكول من رسوم المنشئ، على FEE_RATE_DENOMINATOR = 1_000_000

الحسابات

#	الاسم	W	S	ملاحظات
1	owner	W	S	يجب أن يكون مسؤول برنامج CPMM أو مالك حصة رسوم المنشئ المخصص — انظر reference/program-addresses. أي موقّع آخر يفشل برسالة InvalidOwner (6001). يدفع الإيجار.
2	creator			منشئ المجموعة الذي ينطبق عليه المعدل. غير مفحوص — لا يتعين أن يكون منشئ مجموعة موجود، ولا يوقّع.
3	amm_config			فئة الرسوم التي ينطبق عليها المعدل.
4	creator_fee_share	W		يتم init هنا في ["creator_fee_share", creator, amm_config]، space = 145.
5	system_program

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

• share_rate <= 1_000_000، وإلا InvalidInput (6003).
• يجب ألا يكون PDA موجوداً بالفعل — init الخاص بـ Anchor يفشل عند استدعاء ثانٍ لنفس الزوج. لتغيير معدل، أغلق الحساب وأنشئه مرة أخرى.

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

• creator_fee_share يخزن bump، creator، amm_config و share_rate.
• كل CollectCreatorFee / CollectCreatorFeePermissionless لاحق على مجموعة أنشأها creator تحت amm_config يحل الحصة من هذا الحساب بدلاً من الإعدادات.

منشئ المجموعة ليس طرفاً في هذه التعليمة ولا يوقّعها. يتم قراءة المعدل في وقت الجمع، لذا يتم تطبيق تجاوز تم إنشاؤه بعد تراكم الرسوم بالفعل على هذا الرصيد المتراكم أيضاً.

​

CloseCreatorFeeShare

إزالة التجاوز. يعود الزوج إلى AmmConfig.creator_fee_share_rate.

المعاملات — لا توجد.

الحسابات

#	الاسم	W	S	ملاحظات
1	owner	W	S	نفس الموقّعين المقبولين كما في CreateCreatorFeeShare؛ يستقبل الإيجار.
2	creator			منشئ المجموعة الذي كان ينطبق عليه المعدل.
3	amm_config			فئة الرسوم التي كان ينطبق عليها المعدل.
4	creator_fee_share	W		مُغلق إلى owner. يجب أن يكون PDA الأساسي للزوج.
5	system_program

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

• الحساب مُغلق وتذهب lamports الخاصة به إلى owner.
• الجمع لهذا الزوج يحل الحصة من amm_config.creator_fee_share_rate مرة أخرى — وهي 0 ما لم يقم المسؤول بتعيين معامل UpdateAmmConfig 8.

​

CollectExcessLamports

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

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

الوسائط — لا توجد.

الحسابات

#	الاسم	W	S	ملاحظات
1	collect_lamports_wallet	W	S	الوجهة لكل lamport مُكتسح. يجب أن يكون إما مسؤول برنامج CPMM أو محفظة جمع lamports المخصصة — انظر reference/program-addresses. أي موقّع آخر يفشل مع InvalidOwner.
2	authority			PDA سلطة vault و LP mint في البذرة [b"vault_and_lp_mint_auth_seed"]. يوقّع CPIs برنامج الرموز.
3	token_program			SPL Token.
4	token_program_2022			Token-2022. كلاهما مطلوب بشكل غير مشروط؛ يختار البرنامج لكل حساب مصدر.
5..	remaining_accounts	W		M حساب مصدر للمسح، أي عدد، أي ترتيب.

إصلاح الترتيب، 2026-09-19. يقوم البرنامج الآن بمسحتين على remaining_accounts — كل CPIs برنامج الرموز أولاً، ثم الخصومات المباشرة لـ PDAs المملوكة لـ CPMM. كان الفصل بينها يؤدي إلى الإجهاض مع UnbalancedInstruction للوقت التشغيلي (“مجموع أرصدة الحساب قبل وبعد التعليمة لا تتطابق”) كلما تم خصم PDA قبل CPI، لأن التغييرات المعلقة في lamports للمتصل يتم تفريغها فقط في الحسابات التي تحملها CPI فعلاً. لا يتعين على المتصلين تجميع أو فرز القائمة بأنفسهم.

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

يقوم البرنامج بالتوزيع على owner حساب المصدر:

مالك حساب المصدر	المعالجة
SPL Token أو Token-2022، حساب رمز غير أصلي أو mint — خزائن المجموعة و LP mints	CPI WithdrawExcessLamports (مميز برنامج الرموز 38)، موقّع بواسطة authority.
SPL Token أو Token-2022، أصلي (wSOL) حساب رمز	WithdrawExcessLamports يرفض الحسابات الأصلية. يقوم البرنامج بـ CPI SyncNative، يقيس مقدار نمو amount المُغلّف، UnwrapLamports (مميز 45) لهذا الفرق بالضبط، ثم يتطلب أن يساوي الرصيد المُغلّف قيمته قبل المزامنة — وإلا LamportsCalculateError (6015). وبالتالي تحتفظ خزانة المجموعة من جانب SOL بسيولتها الكاملة.
برنامج CPMM نفسه — PoolState، AmmConfig، ObservationState، Permission، SupportMintAssociated	يقوم البرنامج بخصم الحساب مباشرة إلى rent.minimum_balance(data_len).
أي شيء آخر	يتم تخطيه بصمت. لا خطأ، لا lamports مُنقولة.

لأنها تأخذ قائمة remaining_accounts غير محدودة، حجم المعاملة هو الحد الحقيقي — نفس القيد كما هو الحال في المسح من جانب المحفظة الموصوف في solana-fundamentals/rent-and-reclaimable-rent.

الأخطاء الشائعة — InvalidOwner (6001، موقّع خاطئ)، LamportsCalculateError (6015، رحلة wSOL ذهابًا وإيابًا لم تصل إلى الصفر)، و InsufficientFunds من مسار المملوك للبرنامج عندما يحتفظ الحساب بأقل من الحد الأدنى للإيجار الخاص به.

لا يوجد منشئ SDK. @raydium-io/raydium-sdk-v2 لا يشحن منشئًا لهذه التعليمة، وكذلك مستودع raydium-sdk-V2-demo — إنها مسار إداري. قم بترميزها يدويًا، بالطريقة التي يفعلها المسح من جانب المحفظة في solana-fundamentals/rent-and-reclaimable-rent لتعليمة برنامج الرموز.

​

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

التعليمة	lp_supply	أرصدة الخزائن	حقول الرسوم المتراكمة	observation
Initialize	+ init LP	+ init_amount_{0,1}	0	init
InitializeWithPermission	+ init LP	+ init_amount_{0,1}	0	init
Deposit	+	+ كلاهما	—	—
Withdraw	−	− كلاهما	—	—
SwapBaseInput	—	+ في، − خارج	+ trade_fee مقسم إلى بروتوكول/صندوق؛ + creator_fee إذا كان مفعلاً	+ (إذا انقضت الفترة الزمنية)
SwapBaseOutput	—	+ في، − خارج	+ trade_fee مقسم إلى بروتوكول/صندوق؛ + creator_fee إذا كان مفعلاً	+ (إذا انقضت الفترة الزمنية)
CollectProtocolFee	—	− (حسب دلاء البروتوكول)	protocol_* → 0	—
CollectFundFee	—	− (حسب دلاء الصندوق)	fund_* → 0	—
CollectCreatorFee	—	− (بجزء المُنشئ فقط)	creator_* → 0؛ protocol_* += الجزء المشترك	—
CollectCreatorFeePermissionless	—	− (بجزء المُنشئ فقط)	creator_* → 0؛ protocol_* += الجزء المشترك	—
UpdatePoolStatus	—	—	—	—
CreateCreatorFeeShare	—	—	—	—
CloseCreatorFeeShare	—	—	—	—
CollectExcessLamports	—	— (أرصدة الرموز دون تغيير)	—	—

​

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

• products/cpmm/code-demos — عينات TypeScript قابلة للتشغيل للأعلى.
• reference/error-codes — جدول أخطاء Anchor الكامل.
• products/cpmm/fees — نموذج تراكم الرسوم الذي تستنزفه تعليمات Collect*Fee.

المصادر:

• raydium-io/raydium-cp-swap — instructions
• Raydium SDK v2 — @raydium-io/raydium-sdk-v2