Permanent Transfer Delegate

Q: Permanent Transfer Delegateはフリーズ中のAssetを転送できますか？

はい。Permanent pluginはforceApproveを使用し、フリーズの拒否を上書きします。

Permanent Transfer Delegate Pluginは、永続的に有効な取り消し不可能なtransfer権限を提供します。通常のTransfer Delegateとは異なり、この権限は取り消されず、Assetを繰り返し転送できます。

学習内容

永続的なtransfer機能を持つAssetの作成
Collection全体のtransfer権限の有効化
ユースケース：ゲーム、サブスクリプション、自動化システム
permanent vs 通常のtransfer delegateの理解

概要

Permanent Transfer Delegateは、作成時にのみ追加できるpermanent pluginです。delegateはオーナーの承認なしに無制限にAssetを転送できます。

Asset/Collection作成時にのみ追加可能
権限は永続的（取り消されない）
forceApproveを使用 - フリーズ中でも転送可能
Collectionレベル：Collection内の任意のAssetを転送可能

対象外

通常のtransfer delegate（Transfer Delegateを参照）、エスクローレスリスティング（通常のdelegateを使用）、Token Metadata transfer権限。

クイックスタート

移動先: Assetの作成

Asset/Collection作成時にPermanentTransferDelegate pluginを追加
authorityをプログラムまたはdelegateアドレスに設定
delegateはいつでも無制限にAssetを転送可能

Permanent vs 通常のTransfer Delegate

機能	Transfer Delegate	Permanent Transfer Delegate
作成後に追加	✅ 可能	❌ 作成時のみ
転送後も権限が持続	❌ 1回の転送後に取り消し	✅ 永続
複数回の転送	❌ 1回限り	✅ 無制限
フリーズ中のAssetを転送可能	❌ 不可	✅ 可能（forceApprove）
Collectionで動作	❌ 不可	✅ 可能
Transfer Delegateを選択：1回限りのエスクローレス販売の場合。
Permanent Transfer Delegateを選択：ゲーム、レンタル、または繰り返し転送が必要な自動化システムの場合。

一般的なユースケース

ゲームメカニクス：ゲームイベント（バトルでの敗北、取引）発生時にAssetを転送
レンタル返却：レンタルしたNFTを自動的にオーナーに返却
サブスクリプション管理：サブスクリプションの終了または更新時にトークンを転送
DAOトレジャリー管理：DAOがAsset配布を管理できるようにする
自動化システム：転送ごとの承認なしにAssetを移動する必要があるプログラム

対応


MPL Core Asset	✅
MPL Core Collection	✅

動作

Asset：delegatedアドレスを使用してAssetの転送を許可します。
Collection：collection authorityを使用してCollection内の任意のAssetの転送を許可します。一度に全てを転送するわけではありません。

引数

引数	値
frozen	bool

Permanent Transfer Pluginを持つMPL Core Assetの作成

import { publicKey } from '@metaplex-foundation/umi'
import { create } from '@metaplex-foundation/mpl-core'
const assetSigner = generateSigner(umi)
const delegate = publicKey('33333333333333333333333333333')
await create(umi, {
  asset: assetSigner,
  name: 'My Asset',
  uri: 'https://example.com/my-asset.json',
  plugins: [
    {
      type: 'PermanentTransferDelegate',
      authority: { type: 'Address', address: delegate },
    },
  ],
}).sendAndConfirm(umi)

一般的なエラー

`Cannot add permanent plugin after creation`

Permanent pluginはAsset/Collection作成時にのみ追加できます。既存のAssetにPermanent Transfer Delegateを追加することはできません。

`Authority mismatch`

plugin authorityのみが転送できます。正しいキーペアで署名しているか確認してください。

注意事項

作成時のみ：Asset/Collection存在後は追加不可
Force approve：フリーズ中でも転送可能
Collection動作：Collection内の任意のAssetを個別に転送可能
永続的：権限は取り消されない
無制限の転送：delegateが転送できる回数に制限なし

FAQ

Transfer DelegateとPermanent Transfer Delegateの違いは何ですか？

通常のTransfer Delegateは1回の転送後に取り消されます。Permanent Transfer Delegateは永続的に有効で、無制限に転送できます。