Permanent Burn Delegate

Permanent Burn Delegate Pluginは、永続的に有効な取り消し不可能なburn権限を提供します。delegateはフリーズ中でもAssetをburnでき、ゲームやサブスクリプションサービスに最適です。

概要

Permanent Burn Delegateは、作成時にのみ追加できるpermanent pluginです。delegateはAssetがフリーズ中でも、いつでもAssetをburnできます。

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

対象外

通常のburn delegate（Burn Delegateを参照）、条件付きburn、Token Metadata burn権限。

クイックスタート

移動先: Assetの作成

1. Asset/Collection作成時にPermanentBurnDelegate pluginを追加
2. authorityをプログラムまたはdelegateアドレスに設定
3. delegateはフリーズ中でもいつでもAssetをburn可能

一般的なユースケース

• ゲームメカニクス：ゲーム内でアイテムが消費、紛失、破壊された時にAssetを破棄
• サブスクリプション期限切れ：フリーズ中でも期限切れのサブスクリプショントークンを自動burn
• 緊急破棄：状態に関係なく、侵害されたまたは不要なAssetを削除
• クラフトシステム：クラフト時に素材NFTをburn（ロック中でも可能）
• 期間限定アセット：期限切れのコンテンツを自動的に破棄
• コンプライアンス：オーナーがフリーズしようとしても、規約に違反するAssetを削除

対応

動作

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

引数

Permanent Burn Pluginには渡す引数はありません。

Permanent Burn Pluginを持つ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: 'PermanentBurnDelegate',
      authority: { type: 'Address', address: delegate },
    },
  ],
}).sendAndConfirm(umi)

一般的なエラー

Cannot add permanent plugin after creation

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

Authority mismatch

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

注意事項

• 作成時のみ：Asset/Collection存在後は追加不可
• Force approve：フリーズ中でもburn可能
• Collection動作：Collection内の任意のAssetを個別にburn可能
• 永続的：権限は取り消されない
• 不可逆：burnされたAssetは復元不可

FAQ

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

通常のBurn Delegateはフリーズ中のAssetをburnできず、転送時に取り消されます。Permanent Burn Delegateはフリーズ中のAssetもburn可能（forceApprove）で、永続的に有効です。

Permanent Burn Delegateはフリーズ中のAssetをburnできますか？

はい。Permanent pluginはforceApproveを使用し、フリーズの拒否を上書きします。これはアイテムを破壊可能にする必要があるゲームメカニクスに便利です。

既存のAssetにこれを追加できますか？

いいえ。Permanent pluginはAsset作成時にのみ追加できます。既存のAssetには通常のBurn Delegateを使用してください。

CollectionレベルのPermanent Burn Delegateはどのように機能しますか？

delegateはCollection内の任意の個別Assetをburnできますが、一度に全てをburnすることはできません。各burnは別々のトランザクションです。

これは安全に使用できますか？

注意して使用してください。delegateはオーナーの承認なしにいつでもAssetをburnできます。信頼できるプログラムまたはアドレスにのみ割り当ててください。

関連Plugin

• Burn Delegate - 取り消し可能なburn権限
• Permanent Freeze Delegate - 永続的なfreeze権限
• Permanent Transfer Delegate - 永続的なtransfer権限

用語集