2026-08-17 — CLMM: khóa NFT vị trí với restricted-issuer

​

TL;DR cho các nhà tích hợp

• Các mint NFT vị trí mới có freeze authority, nhưng không bị khóa theo mặc định. OpenPosition, OpenPositionV2, và OpenPositionWithToken22Nft đặt pool_state của vị trí làm freeze authority của mint. Mint authority vẫn bị xóa sau khi NFT duy nhất được mint.
• Khóa yêu cầu đường dẫn V2 cộng với khớp nhà phát hành. OpenPositionV2 và OpenPositionWithToken22Nft kiểm tra vault_0_mint.freeze_authority và vault_1_mint.freeze_authority. Tài khoản NFT mới chỉ bị khóa nếu ít nhất một khớp với danh sách chương trình. Nếu không khớp, nó vẫn không bị khóa và có thể chuyển nhượng.
• Khóa có nghĩa là gắn với chủ sở hữu. SPL Token từ chối chuyển NFT và thay đổi chủ sở hữu tài khoản token bằng lỗi AccountFrozen gốc của nó. Tăng/giảm thanh khoản và thu thập phí/phần thưởng tiếp tục hoạt động khi chủ sở hữu NFT ký.
• Đóng vẫn khả dụng. ClosePosition phát hiện tài khoản NFT bị khóa, sử dụng pool PDA để thaw nó, sau đó đốt NFT và đóng vị trí một cách nguyên tử.
• Đóng bị khóa yêu cầu một tài khoản còn lại. Client phải thêm personal_position.pool_id làm tài khoản còn lại đầu tiên. Thiếu nó trả về CLMM AccountLack; truyền pool sai trả về NotApproved.
• Các vị trí hiện có không bị ảnh hưởng. Bản cập nhật không thay đổi retroactively freeze authorities của NFT mint hoặc khóa các tài khoản token hiện có.
• Không có thay đổi bố cục trạng thái CLMM hoặc danh sách tài khoản IDL được khai báo. PoolState, PersonalPositionState, và các đối số hướng dẫn vẫn tương thích byte. Yêu cầu đường dẫn đóng được thực hiện thông qua remaining_accounts.

​

Logic kích hoạt

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

​

Thay đổi freeze authority của NFT vị trí

1. Khóa ngay sau khi mint khi kiểm tra nhà phát hành cơ bản khớp.
2. Thaw trong ClosePosition ngay trước khi đốt.

​

Di chuyển 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

​

Ma trận tương thích

​

Trang được cập nhật

• products/clmm/overview — tóm tắt bản phát hành và cảnh báo không chuyển nhượng bị hạn chế.
• products/clmm/ticks-and-positions — mô hình freeze authority, kích hoạt, khả năng chủ sở hữu, và cảnh báo di chuyển đóng.
• products/clmm/accounts — mint NFT vị trí và hành vi vòng đời.
• products/clmm/instructions — postconditions mở và đường dẫn tài khoản còn lại ClosePosition bị khóa.
• products/clmm/code-demos — ví dụ đóng Anchor trực tiếp và cảnh báo SDK được ghim.
• user-flows/add-remove-liquidity — hành vi vị trí bị hạn chế hướng tới người dùng.
• user-flows/burn-and-earn — các vị trí bị khóa không thể chuyển vào escrow khóa.
• security/oracle-and-token-risks / security/attack-vectors — ranh giới rủi ro nhà phát hành và chuyển.
• reference/token-2022-support — sự phân biệt giữa danh sách cho phép pool và quyền giám sát vị trí.
• reference/error-codes — nguyên nhân AccountLack và NotApproved được mở rộng.
• reference/program-addresses — khóa khớp freeze authority restricted-issuer.
• reference/fee-comparison / reference/glossary — ngoại lệ khả năng chuyển nhượng.

• Nhánh CLMM trước phát hành feat/position-nft-freeze tại ecb157760776f83f97507fa78c6e32cfb30d92a9.
• Commits 2e95310 (khóa NFT restricted-issuer) và ecb1577 (freeze authority có phạm vi pool), so sánh với master tại 51fdba2.
• Nguồn chương trình dưới instructions/{open_position,open_position_v2,open_position_with_token22_nft,close_position}.rs và util/token.rs.
• position-nft-freeze.test.ts, bao gồm khả năng chuyển nhượng thông thường, từ chối chuyển/thay đổi chủ sở hữu bị khóa, và luồng thaw-before-close V2 cộng với Token-2022.