ImmutableMetadata 플러그인

ImmutableMetadata 플러그인은 Asset 또는 Collection의 이름과 URI를 영구적으로 잠급니다. 한번 추가되면 누구도 메타데이터를 변경할 수 없어 영구적인 출처를 보장합니다.

요약

ImmutableMetadata 플러그인은 Asset 또는 Collection의 이름과 URI에 대한 모든 변경을 방지하는 권한 관리 플러그인입니다. 한번 추가되면 이 보호는 영구적입니다.

• 권한 관리 (업데이트 권한만 추가 가능)
• 이름과 URI를 영구적으로 변경 불가능하게 만듦
• 추가 후 제거 불가
• Collection 플러그인은 해당 Collection의 모든 Asset에 영향

범위 외

다른 플러그인 데이터를 불변으로 만들기 (해당 플러그인에 권한 None 사용), 선택적 필드 불변성, 임시 잠금은 범위 외입니다.

빠른 시작

바로가기: Asset에 추가 · Collection에 추가

1. 메타데이터(이름, URI)가 최종 확정되었는지 확인
2. 업데이트 권한으로 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

업데이트 권한만 ImmutableMetadata 플러그인을 추가할 수 있습니다.

Cannot update metadata

ImmutableMetadata 플러그인이 활성화되어 있습니다. 이름과 URI를 변경할 수 없습니다.

참고 사항

• 이 작업은 영구적이며 되돌릴 수 없습니다
• 이 플러그인을 추가하기 전에 이름과 URI를 다시 확인하세요
• Collection에 추가하면 해당 Collection의 모든 Asset이 불변이 됩니다
• 플러그인은 인수가 없습니다 - 추가하기만 하면 메타데이터가 잠깁니다

빠른 참조

영향받는 필드

상속 동작

FAQ

ImmutableMetadata 추가를 취소할 수 있나요?

아니요. 한번 추가되면 ImmutableMetadata 플러그인은 제거할 수 없습니다. 메타데이터는 영구적으로 잠깁니다. 이는 출처 보장을 위해 의도된 설계입니다.

정확히 무엇이 불변이 되나요?

Asset 또는 Collection의 name과 uri 필드입니다. 다른 플러그인 데이터는 영향을 받지 않습니다 - 개별 플러그인의 데이터를 불변으로 만들려면 권한 None을 사용하세요.

Collection에 이것을 추가하면 기존 Asset들도 영향을 받나요?

네. ImmutableMetadata가 Collection에 있으면 해당 Collection의 모든 Asset이 불변성을 상속합니다. 메타데이터를 변경할 수 없게 됩니다.

Asset 생성 시 이것을 추가할 수 있나요?

네. create() 중에 ImmutableMetadata를 추가하여 처음부터 메타데이터가 잠기도록 할 수 있습니다.

왜 불변 메타데이터가 필요한가요?

불변 메타데이터는 영구적인 출처를 제공합니다 - 수집가들은 NFT의 이름과 관련 메타데이터 URI가 절대 변경될 수 없다는 것을 알게 되어 창작자가 아트워크나 설명을 바꾸는 러그풀을 방지합니다.

관련 플러그인

• AddBlocker - 새 플러그인 추가 방지 (ImmutableMetadata와 보완적)
• Attributes - 온체인 데이터 (ImmutableMetadata에 의해 잠기지 않음)
• Royalties - 불변으로 만들기 전에 로열티 설정

용어집