تعليمات CPMM

​

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

​

Initialize

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

• يتم فرز الـ 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، لذا استخدم هذا الحقل ولا تستبدل إمداد 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؛ تعمل الودائع والسحوبات فورًا.

• 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

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

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

​

Withdraw

lp_token_amount:   u64
minimum_token_0:   u64
minimum_token_1:   u64

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

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

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

​

SwapBaseOutput

max_amount_in:  u64
amount_out:     u64

​

CollectProtocolFee

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

​

CollectFundFee

​

CollectCreatorFee

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

​

CollectCreatorFeePermissionless

​

UpdatePoolStatus

status: u8      // new bitmask

​

CreateAmmConfig

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

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

​

UpdateAmmConfig

• 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] (القراءة فقط بخير). يجب ألا يكون المفتاح الافتراضي، وحذف الحساب يرمي على 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، الذي ينقسم رسوم التجارة.

​

CreateCreatorFeeShare

share_rate: u64   // protocol's share OF the creator fee, over FEE_RATE_DENOMINATOR = 1_000_000

• 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

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

​

CollectExcessLamports