移除插件

本指南展示如何从 Core Asset 和 Collection 中移除插件。移除插件会删除其数据和功能。

摘要

使用 removePlugin() 从 Asset 移除插件，使用 removeCollectionPlugin() 从 Collection 移除。只有插件权限者可以移除插件。

• 指定要移除的插件类型
• 插件数据被删除
• 租金被回收
• Permanent 插件无法移除

范围外

Permanent 插件移除（不可能）、插件更新（参见更新插件）和权限变更（参见委托插件）。

快速开始

跳转至： 从 Asset 移除 · 从 Collection 移除

1. 确定要移除的插件类型
2. 使用 Asset 和插件类型调用 removePlugin()
3. 插件立即被移除 也可以从 MPL Core Asset 和 MPL Core Collection 中移除插件。

从 MPL Core Asset 移除插件

import { publicKey } from '@metaplex-foundation/umi'
import { removePlugin } from '@metaplex-foundation/mpl-core'
const asset = publicKey('11111111111111111111111111111111')
await removePlugin(umi, {
  asset: asset.publicKey,
  plugin: { type: 'Attributes' },
}).sendAndConfirm(umi)

从 Collection 移除插件

import { publicKey } from '@metaplex-foundation/umi'
import {
  removeCollectionPluginV1,
  PluginType,
} from '@metaplex-foundation/mpl-core'
const collectionAddress = publicKey('11111111111111111111111111111111')
await removeCollectionPlugin(umi, {
  collection: collectionAddress,
  pluginType: { type: 'Royalties' },
}).sendAndConfirm(umi)

常见错误

Authority mismatch

您没有权限移除此插件。检查谁拥有该插件的权限。

Plugin not found

Asset/Collection 没有附加此插件类型。

Cannot remove permanent plugin

Permanent 插件在创建后无法移除。它们是永久附加的。

注意事项

• 移除插件会删除所有数据
• 已移除插件的租金会被回收
• 只有插件权限者可以移除插件
• Permanent 插件永远无法移除

快速参考

移除权限要求

FAQ

移除插件后可以恢复数据吗？

不可以。移除插件会永久删除所有数据。请在移除前备份重要数据。

移除插件时租金会怎样？

用于存储插件数据的租金会被回收并返还给支付者。

我可以移除别人委托给我的插件吗？

可以，如果您是该插件的委托权限者，就可以移除它。

为什么不能移除 Permanent 插件？

Permanent 插件在创建后无法移除，但其设置仍可调整。这是为需要保证插件存在的用例而设计的。

可以同时移除 Collection 及其 Asset 的插件吗？

不可以。Collection 插件和 Asset 插件是分开管理的。但是，移除 Collection 插件可能会影响从其继承的 Asset（例如，没有自己 Royalties 插件的 Asset 将不再执行版税）。

相关操作

• 添加插件 - 向 Asset/Collection 添加插件
• 委托插件 - 更改插件权限
• 更新插件 - 修改插件数据
• 插件概述 - 可用插件完整列表

术语表