プラグイン

プラグインの削除

Last updated January 31, 2026

このガイドでは、Core Asset と Collection からプラグインを削除する方法を説明します。プラグインを削除すると、そのデータと機能が削除されます。

学習内容

  • Asset からプラグインを削除
  • Collection からプラグインを削除
  • 削除に必要な権限要件を理解
  • 削除したプラグインからレントを回収

概要

Asset には removePlugin()、Collection には removeCollectionPlugin() を使用してプラグインを削除します。プラグインを削除できるのはプラグイン権限者のみです。

  • 削除するプラグインタイプを指定
  • プラグインデータは削除される
  • レントは回収される
  • Permanent プラグインは削除不可

対象外

Permanent プラグインの削除(不可能)、プラグインの更新(プラグインの更新を参照)、権限の変更(プラグインの委任を参照)。

クイックスタート

ジャンプ先: Asset から削除 · Collection から削除

  1. 削除するプラグインタイプを特定
  2. Asset とプラグインタイプを指定して removePlugin() を呼び出す
  3. プラグインは即座に削除される プラグインは MPL Core Asset と MPL Core Collection からも削除できます。

MPL Core Asset からプラグインを削除

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 からプラグインを削除

MPL Core 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 プラグインは削除不可

クイックリファレンス

削除権限の要件

プラグインタイプ削除できる人
Owner Managed所有者または委任者
Authority ManagedUpdate authority または委任者
Permanent削除不可

FAQ

プラグインを削除した後、データを復元できますか?

いいえ。プラグインを削除するとすべてのデータが完全に削除されます。削除前に重要なデータをバックアップしてください。

プラグインを削除するとレントはどうなりますか?

プラグインデータの保存に使用されていたレントは回収され、支払者に返還されます。

他の人が委任したプラグインを削除できますか?

はい。そのプラグインの委任された権限者であれば削除できます。

Permanent プラグインを削除できないのはなぜですか?

Permanent プラグインは作成後に削除できません。ただし、設定は引き続き調整できます。これは、プラグインの存在を保証する必要があるユースケースのための設計です。

Collection とその Asset のプラグインを一度に削除できますか?

いいえ。Collection プラグインと Asset プラグインは個別に管理されます。ただし、Collection プラグインを削除すると、そこから継承している Asset に影響を与える可能性があります(例:独自の Royalties プラグインを持たない Asset はロイヤリティが適用されなくなります)。

関連操作

用語集

用語定義
Plugin Authorityプラグインを管理する権限を持つアドレス
Permanent Plugin作成後に削除できないプラグイン
RentSolana でアカウントデータを保存するために預けられる SOL
Owner Managed所有者が削除を制御するプラグイン
Authority ManagedUpdate authority が削除を制御するプラグイン