ImmutableMetadataプラグイン

ImmutableMetadataプラグインは、AssetsまたはCollectionsの名前とURIを永続的にロックします。一度追加されると、メタデータは誰も変更できなくなり、永続的な来歴を保証します。

概要

ImmutableMetadataプラグインは、AssetまたはCollectionの名前とURIへの変更を防ぐAuthority Managedプラグインです。一度追加されると、この保護は永続的です。

• Authority Managed（update authorityのみが追加可能）
• 名前とURIを永続的に変更不可にする
• 追加後は削除不可
• Collectionプラグインはそのコレクション内のすべてのAssetsに影響

対象外

他のプラグインデータを不変にする（それらのプラグインでauthority Noneを使用）、選択的なフィールドの不変性、一時的なロック。

クイックスタート

ジャンプ先: Assetに追加 · Collectionに追加

1. メタデータ（名前、URI）が最終版であることを確認
2. Update authorityとしてImmutableMetadataプラグインを追加
3. メタデータが永続的にロックされる

一般的なユースケース

• アートコレクティブル: アートワークとメタデータが決して変更されないことを保証
• 証明書: 変更できない資格を発行
• 来歴保護: メタデータをロックしてラグプルを防止
• 歴史的記録: NFTデータを永続的に保存
• ブランド保証: NFTのアイデンティティが固定されていることをコレクターに保証

対応

引数

ImmutableMetadataプラグインには引数は必要ありません。

Assetへのimmutablemetadataプラグインの追加コード例

import {
  addPlugin,
} from '@metaplex-foundation/mpl-core'
await addPlugin(umi, {
  asset: asset.publicKey,
  plugin: {
    type: 'ImmutableMetadata',
  },
}).sendAndConfirm(umi)

Collectionへのimmutablemetadataプラグインの追加コード例

import {
  addCollectionPlugin,
} from '@metaplex-foundation/mpl-core'
await addCollectionPlugin(umi, {
  collection: collection.publicKey,
  plugin: {
    type: 'ImmutableMetadata',
  },
}).sendAndConfirm(umi)

一般的なエラー

Authority mismatch

Update authorityのみがImmutableMetadataプラグインを追加できます。

Cannot update metadata

ImmutableMetadataプラグインがアクティブです。名前とURIは変更できません。

注意事項

• このアクションは永続的で不可逆です
• このプラグインを追加する前に名前とURIを再確認してください
• Collectionに追加すると、そのCollection内のすべてのAssetsが不変になります
• プラグインには引数がありません—追加するだけでメタデータがロックされます

クイックリファレンス

影響を受けるフィールド

継承動作

FAQ

ImmutableMetadataの追加を取り消せますか？

いいえ。一度追加されると、ImmutableMetadataプラグインは削除できません。メタデータは永続的にロックされます。これは来歴保証のための設計です。

具体的に何が不変になりますか？

AssetまたはCollectionのnameとuriフィールドです。他のプラグインデータは影響を受けません—それらのデータを不変にするには個別のプラグインでauthority Noneを使用してください。

Collectionにこれを追加すると、既存のAssetsに影響しますか？

はい。ImmutableMetadataがCollectionにあると、そのCollection内のすべてのAssetsが不変性を継承します。それらのメタデータは変更できなくなります。

Asset作成時にこれを追加できますか？

はい。create()中にImmutableMetadataを追加して、メタデータが最初からロックされるようにできます。

なぜ不変メタデータが必要なのですか？

不変メタデータは永続的な来歴を提供します—コレクターはNFTの名前と関連するメタデータURIが決して変更されないことを知り、クリエイターがアートワークや説明を差し替えるラグプルを防ぎます。

関連プラグイン

• AddBlocker - 新しいプラグインを防止（ImmutableMetadataを補完）
• Attributes - オンチェーンデータ（ImmutableMetadataではロックされない）
• Royalties - 不変にする前にロイヤリティを設定

用語集