2026-08-17 — CLMM: تجميد NFT للمراكز ذات المُصدِّر المقيّد

​

ملخص سريع للمدمجين

• عملات NFT للمراكز الجديدة لها سلطة تجميد، لكنها غير مجمّدة بشكل افتراضي. يقوم OpenPosition و OpenPositionV2 و OpenPositionWithToken22Nft بتعيين pool_state للمركز كسلطة تجميد العملة. لا تزال سلطة العملة مُزالة بعد صك NFT الواحد.
• التجميد يتطلب مسار V2 بالإضافة إلى تطابق المُصدِّر. يفحص OpenPositionV2 و OpenPositionWithToken22Nft قيم vault_0_mint.freeze_authority و vault_1_mint.freeze_authority. يتم تجميد حساب NFT الجديد فقط إذا طابقت إحدى القيم قائمة البرنامج. بدون تطابق، يبقى غير مجمّد وقابل للتحويل.
• التجميد يعني الربط بالمالك. يرفض SPL Token نقل NFT وتغييرات مالك حساب الرمز برسالة الخطأ الأصلية AccountFrozen. تستمر عمليات زيادة/تقليل السيولة وجمع الرسوم/المكافآت في العمل عندما يوقّع مالك NFT.
• الإغلاق يبقى متاحًا. يكتشف ClosePosition حساب NFT المجمّد، ويستخدم pool PDA لإذابته، ثم يحرق NFT ويغلق المركز بشكل ذري.
• إغلاق مجمّد يتطلب حساب متبقي واحد. يجب على العميل إضافة personal_position.pool_id كأول حساب متبقي. عدم وجوده يُرجع AccountLack من CLMM؛ تمرير مجموعة خاطئة يُرجع NotApproved.
• المراكز الموجودة لم تتأثر. لا يقوم التحديث بتغيير سلطات عملة NFT بأثر رجعي أو تجميد حسابات الرموز الموجودة.
• لا توجد تغييرات في تخطيط حالة CLMM أو قائمة حسابات IDL المُعلنة. يبقى PoolState و PersonalPositionState وحجج التعليمات متوافقة على مستوى البايت. يتم نقل متطلبات مسار الإغلاق عبر remaining_accounts.

​

منطق التشغيل

must_freeze = restricted_ids.contains(vault_0_mint.freeze_authority)
           || restricted_ids.contains(vault_1_mint.freeze_authority)

​

تغييرات سلطة NFT للمركز

1. التجميد فورًا بعد الصك عندما يطابق فحص المُصدِّر الأساسي.
2. الإذابة أثناء ClosePosition مباشرة قبل الحرق.

​

هجرة ClosePosition

declared: nft_owner, position_nft_mint, position_nft_account,
          personal_position, system_program, token_program
remaining[0]: personal_position.pool_id   // read-only, non-signer

thaw NFT account → burn NFT → close NFT token account / position state

​

مصفوفة التوافقية

​

الصفحات المُحدّثة

• products/clmm/overview — ملخص الإصدار وتحذير عدم القابلية للتحويل المقيّد.
• products/clmm/ticks-and-positions — نموذج السلطة والمشغل وقدرات المالك وتحذير هجرة الإغلاق.
• products/clmm/accounts — عملة NFT للمركز وسلوك دورة الحياة.
• products/clmm/instructions — شروط ما بعد الفتح ومسار حساب ClosePosition المتبقي المجمّد.
• products/clmm/code-demos — مثال Anchor مباشر للإغلاق وتحذير SDK المثبّت.
• user-flows/add-remove-liquidity — سلوك المركز المقيّد الموجه للمستخدم.
• user-flows/burn-and-earn — لا يمكن للمراكز المجمّدة النقل إلى قفل escrow.
• security/oracle-and-token-risks / security/attack-vectors — حدود المُصدِّر وخطر النقل.
• reference/token-2022-support — التمييز بين قائمة السماح بالمجموعة وحضانة المركز.
• reference/error-codes — أسباب AccountLack و NotApproved الموسّعة.
• reference/program-addresses — مفاتيح تطابق سلطة المُصدِّر المقيّد.
• reference/fee-comparison / reference/glossary — استثناءات القابلية للتحويل.

• فرع CLMM قبل الإصدار feat/position-nft-freeze في ecb157760776f83f97507fa78c6e32cfb30d92a9.
• الالتزامات 2e95310 (تجميد NFT للمُصدِّر المقيّد) و ecb1577 (سلطة التجميد ذات النطاق المجموعة)، مقارنة مع master في 51fdba2.
• مصادر البرنامج تحت instructions/{open_position,open_position_v2,open_position_with_token22_nft,close_position}.rs و util/token.rs.
• position-nft-freeze.test.ts، تغطي القابلية للتحويل العادية ورفض النقل/تغيير المالك المجمّد وتدفقات الإذابة قبل الإغلاق V2 و Token-2022.