플러그인 제거

이 가이드에서는 Core Asset 및 Collection에서 플러그인을 제거하는 방법을 설명합니다. 플러그인을 제거하면 데이터와 기능이 삭제됩니다.

요약

Asset에는 removePlugin(), Collection에는 removeCollectionPlugin()을 사용하여 플러그인을 제거합니다. 플러그인 권한자만 플러그인을 제거할 수 있습니다.

• 제거할 플러그인 유형 지정
• 플러그인 데이터 삭제
• 렌트 회수
• 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에 플러그인 추가
• 플러그인 위임 - 플러그인 권한 변경
• 플러그인 업데이트 - 플러그인 데이터 수정
• 플러그인 개요 - 사용 가능한 플러그인 전체 목록

용어집