Permanent Transfer Delegate

Permanent Transfer Delegate Plugin提供永久有效的不可撤销transfer权限。与普通Transfer Delegate不同，此权限永不撤销，可以重复转移Asset。

概述

Permanent Transfer Delegate是一个只能在创建时添加的permanent plugin。delegate可以无需所有者批准无限次转移Asset。

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

范围外

普通transfer delegate（参见Transfer Delegate）、无托管列表（使用普通delegate）和Token Metadata transfer权限。

快速开始

跳转到: 创建Asset

1. 在Asset/Collection创建时添加PermanentTransferDelegate plugin
2. 将authority设置为您的程序或delegate地址
3. delegate可以在任何时候无限次转移Asset

常见用例

• 游戏机制：当游戏事件发生时（战斗失败、交易）转移Asset
• 租赁返还：自动将租借的NFT返还给所有者
• 订阅管理：当订阅结束或续订时转移代币
• DAO财库管理：允许DAO管理Asset分配
• 自动化系统：需要在无需每次转移批准的情况下移动Asset的程序

兼容性

行为

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

参数

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

Authority mismatch

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

注意事项

• 仅限创建时：Asset/Collection存在后无法添加
• Force approve：即使冻结也可以转移
• Collection行为：可以单独转移Collection中的任何Asset
• 永久有效：权限永不撤销
• 无限转移：delegate可以转移的次数没有限制

FAQ

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

普通Transfer Delegate在一次转移后会被撤销。Permanent Transfer Delegate永久有效，可以无限次转移。

Permanent Transfer Delegate能转移冻结的Asset吗？

是的。Permanent plugin使用forceApprove，可以覆盖冻结拒绝。

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

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

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

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

相关Plugin

• Transfer Delegate - 一次性transfer权限
• Permanent Freeze Delegate - 永久freeze权限
• Permanent Burn Delegate - 永久burn权限

术语表