2026-08-17 — CLMM: restricted-issuer position NFT freezing

​

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

• Các mint position NFT mới có freeze authority, nhưng không bị đóng băng theo mặc định. OpenPosition, OpenPositionV2, và OpenPositionWithToken22Nft đặt pool_state của position làm mint freeze authority. Mint authority vẫn bị xóa sau khi NFT duy nhất được mint.
• Đóng băng 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ị đóng băng 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ị đóng băng và có thể chuyển nhượng.
• Đóng băng có nghĩa là bị ràng buộc 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ị đóng băng, sử dụng pool PDA để thaw nó, sau đó đốt NFT và đóng position một cách nguyên tử.
• Đóng bị đóng băng 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 position hiện có không bị ảnh hưởng. Bản cập nhật không thay đổi retroactively mint authorities của NFT hoặc đóng băng 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 authority position NFT

1. Đóng băng ngay sau khi mint khi kiểm tra issuer cơ bản khớp.
2. Thaw trong ClosePosition ngay trước khi đốt.

​

Quá trình 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 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 position NFT và hành vi vòng đời.
• products/clmm/instructions — postconditions mở và đường dẫn remaining-account ClosePosition bị đóng băng.
• 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 position bị hạn chế đối mặt với người dùng.
• user-flows/burn-and-earn — các position bị đóng băng không thể chuyển vào lock escrow.
• security/oracle-and-token-risks / security/attack-vectors — ranh giới issuer và transfer-risk.
• reference/token-2022-support — sự phân biệt giữa allow-listing pool và custody position.
• reference/error-codes — nguyên nhân AccountLack và NotApproved được mở rộng.
• reference/program-addresses — khóa khớp restricted-issuer authority.
• reference/fee-comparison / reference/glossary — ngoại lệ chuyển nhượng.

• Nhánh CLMM trước phát hành feat/position-nft-freeze tại ecb157760776f83f97507fa78c6e32cfb30d92a9.
• Commits 2e95310 (restricted-issuer NFT freezing) và ecb1577 (pool-scoped freeze authority), 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 chuyển nhượng thông thường, từ chối chuyển/thay đổi chủ sở hữu bị đóng băng, và luồng thaw-before-close V2 cộng với Token-2022.