외부 플러그인 제거

이 가이드는 Core Asset과 Collection에서 외부 플러그인을 제거하는 방법을 보여줍니다. 더 이상 필요하지 않을 때 Oracle 또는 AppData 플러그인을 제거하세요.

요약

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

• 플러그인 유형과 기본 주소 지정
• 플러그인 데이터가 삭제됨
• 렌트 회수
• 플러그인 권한 서명 필요

범위 외

외부 플러그인 추가(외부 플러그인 추가 참조), 플러그인 데이터 업데이트, 내장 플러그인 제거(플러그인 제거 참조).

빠른 시작

바로 가기: Asset에서 제거 · Collection에서 제거

1. 제거할 플러그인 유형과 기본 주소 확인
2. 플러그인 키로 removePlugin() 호출
3. 플러그인이 즉시 제거되고 렌트 회수

Asset에서 제거

import {publicKey } from '@metaplex-foundation/umi'
import { removePlugin, CheckResult } from '@metaplex-foundation/mpl-core'
const asset = publicKey('1111111111111111111111111111111')
const oracleAccount = publicKey('2222222222222222222222222222222')
await removePlugin(umi, {
  asset,
  plugin: {
    type: 'Oracle',
    baseAddress: oracleAccount,
  },
})

Collection에서 제거

import { publicKey } from '@metaplex-foundation/umi'
import { removeCollectionPlugin, CheckResult } from '@metaplex-foundation/mpl-core'
const collection = publicKey('1111111111111111111111111111111')
const oracleAccount = publicKey('2222222222222222222222222222222')
removeCollectionPlugin(umi, {
  collection,
  plugin: {
    type: 'Oracle',
    baseAddress: publicKey(oracleAccount),
  },
})

일반적인 오류

Authority mismatch

플러그인 권한만 외부 플러그인을 제거할 수 있습니다. 올바른 키페어로 서명하고 있는지 확인하세요.

Plugin not found

지정된 키를 가진 외부 플러그인이 이 Asset/Collection에 존재하지 않습니다.

참고 사항

• 플러그인을 제거하면 모든 데이터가 삭제됩니다
• 렌트가 회수되어 지불자에게 반환됩니다
• 플러그인 권한만 제거할 수 있습니다(일반적으로 Update Authority)
• 외부 Oracle/AppData 계정은 삭제되지 않습니다—어댑터만 삭제됩니다

FAQ

Oracle 플러그인을 제거하면 Oracle 계정이 삭제되나요?

아니요. Asset의 플러그인 어댑터만 제거됩니다. 외부 Oracle 계정은 유지되며 재사용할 수 있습니다.

제거하기 전에 AppData를 복구할 수 있나요?

네. 데이터를 보존해야 하는 경우 플러그인을 제거하기 전에 fetchAsset()을 사용하여 AppData를 읽으세요.

렌트는 어떻게 되나요?

플러그인 어댑터의 렌트가 회수되어 트랜잭션 지불자에게 반환됩니다.

관련 작업

• 외부 플러그인 추가 - 외부 플러그인 추가
• 외부 플러그인 개요 - 외부 플러그인 이해하기
• 플러그인 제거 - 내장 플러그인 제거