Permanent Burn Delegate

Permanent Burn Delegate Plugin提供永久有效的不可撤销burn权限。delegate即使在冻结状态下也可以burn Asset，非常适合游戏和订阅服务。

概述

Permanent Burn Delegate是一个只能在创建时添加的permanent plugin。delegate可以在任何时候burn Asset，即使Asset处于冻结状态。

• 只能在Asset/Collection创建时添加
• 权限永久有效（永不撤销）
• 使用forceApprove - 即使冻结也可以burn
• Collection级别：允许burn Collection中的任何Asset

范围外

普通burn delegate（参见Burn Delegate）、条件burn和Token Metadata burn权限。

快速开始

跳转到: 创建Asset

1. 在Asset/Collection创建时添加PermanentBurnDelegate plugin
2. 将authority设置为您的程序或delegate地址
3. delegate可以在任何时候burn Asset，即使冻结

常见用例

• 游戏机制：当游戏中物品被消耗、丢失或销毁时销毁Asset
• 订阅过期：即使冻结也自动burn过期的订阅代币
• 紧急销毁：无论状态如何，删除受损或不需要的Asset
• 制作系统：制作时burn原料NFT（即使锁定）
• 限时资产：自动销毁过期内容
• 合规：即使所有者尝试冻结，也删除违反条款的Asset

兼容性

行为

• Asset：允许使用delegated地址burn Asset。
• Collection：允许使用collection authority burn Collection中的任何Asset。不会一次性burn所有Asset。

参数

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创建时添加。您无法将Permanent Burn Delegate添加到现有Asset。

Authority mismatch

只有plugin authority可以burn。请验证您是否使用正确的密钥对签名。

注意事项

• 仅限创建时：Asset/Collection存在后无法添加
• Force approve：即使冻结也可以burn
• Collection行为：可以单独burn Collection中的任何Asset
• 永久有效：权限永不撤销
• 不可逆：burn的Asset无法恢复

FAQ

Burn Delegate和Permanent Burn Delegate有什么区别？

普通Burn Delegate无法burn冻结的Asset，且在转移时会被撤销。Permanent Burn Delegate可以burn冻结的Asset（forceApprove）并永久有效。

Permanent Burn Delegate能burn冻结的Asset吗？

是的。Permanent plugin使用forceApprove，可以覆盖冻结拒绝。这对于需要物品可销毁的游戏机制很有用。

我可以将此添加到现有Asset吗？

不可以。Permanent plugin只能在Asset创建时添加。对于现有Asset，请使用普通Burn Delegate。

Collection级别的Permanent Burn Delegate如何工作？

delegate可以burn Collection中的任何单个Asset，但不能一次性burn所有Asset。每次burn都是单独的交易。

使用这个安全吗？

请谨慎使用。delegate可以在任何时候无需所有者批准就burn Asset。只分配给可信任的程序或地址。

相关Plugin

• Burn Delegate - 可撤销的burn权限
• Permanent Freeze Delegate - 永久freeze权限
• Permanent Transfer Delegate - 永久transfer权限

术语表