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

​

インテグレーター向け TL;DR

• 新しいポジション NFT ミントはフリーズ権限を持ちますが、デフォルトではフリーズされません。 OpenPosition、OpenPositionV2、OpenPositionWithToken22Nft はポジションの pool_state をミントフリーズ権限として設定します。ミント権限は単一の NFT がミントされた後も削除されます。
• フリーズには V2 パスと発行者マッチが必要です。 OpenPositionV2 と OpenPositionWithToken22Nft は vault_0_mint.freeze_authority と vault_1_mint.freeze_authority を検査します。新しい NFT アカウントは、少なくとも 1 つがプログラムリストと一致する場合にのみフリーズされます。マッチがない場合、それはフリーズされたままで転送可能です。
• フリーズは所有者にバインドされることを意味します。 SPL Token は、ネイティブ AccountFrozen エラーで NFT 転送とトークンアカウント所有者の変更を拒否します。NFT 所有者が署名する場合、リクイディティの増加・減少とフィー・報酬の収集は引き続き機能します。
• クローズは利用可能なままです。 ClosePosition はフリーズされた NFT アカウントを検出し、プール PDA を使用してそれをシャーすると、NFT をバーンしてポジションをアトミックに閉じます。
• フリーズされたクローズには 1 つの残りアカウントが必要です。 クライアントは personal_position.pool_id を最初の残りアカウントとして追加する必要があります。それがない場合は CLMM AccountLack を返します。間違ったプールを渡すと 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

NFT アカウントをシャー → NFT をバーン → NFT トークンアカウント / ポジション状態をクローズ

​

互換性マトリックス

​

更新されたページ

• 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 — フリーズされたポジションはロックエスクローに転送できません。
• 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 at ecb157760776f83f97507fa78c6e32cfb30d92a9。
• コミット 2e95310（制限発行者 NFT フリーズ）と ecb1577（プール範囲フリーズ権限）、master at 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 シャー前クローズフローをカバー。