컬렉션 관리

Summary

Managing collections for compressed NFTs uses the setCollectionV2 instruction to add, change, or remove MPL-Core collections on existing cNFTs. This page covers setting and removing collections after minting.

• Set an MPL-Core collection on an existing cNFT using setCollectionV2
• Remove a collection from a cNFT
• Change between collections (both authorities must sign)
• Collections must have the BubblegumV2 plugin enabled

cNFT는 민팅 시 또는 나중에 MPL-Core 컬렉션에 추가될 수 있습니다.

NFT와 관련된 컬렉션의 개념에 익숙하지 않다면, 이는 다른 NFT를 함께 그룹화하는 데 사용할 수 있는 특별한 비압축 NFT입니다. 따라서 컬렉션의 데이터는 전체 컬렉션의 이름과 브랜딩을 설명하는 데 사용됩니다. Bubblegum V2부터는 리프 소유자의 상호 작용 없이 위임자가 cNFT를 동결하고 해동할 수 있도록 하는 등 컬렉션 수준에서 추가 기능을 허용합니다. MPL-Core 컬렉션에 대한 자세한 내용은 여기에서 읽을 수 있습니다.

여기에 문서화된 MintV2 명령어를 사용하여 압축된 NFT를 컬렉션에 직접 민팅하는 것이 가능합니다. 그렇긴 하지만 컬렉션 없이 cNFT를 이미 민팅했다면 해당 cNFT에 컬렉션을 설정하는 방법을 살펴보겠습니다. "verified" 부울이 있는 Metaplex Token Metadata 컬렉션을 사용하는 Bubblegum v1과 달리 Bubblegum V2는 해당 부울이 없는 MPL-Core 컬렉션을 사용합니다.

MPL-Core 컬렉션은 BubblegumV2 플러그인을 포함해야 합니다.

다음 섹션은 단일 단계 트랜잭션에서 cNFT에서 컬렉션을 설정하고 제거하는 방법을 보여줍니다. coreCollection과 newCoreCollection 매개변수를 추가할 때 단일 명령어에서 두 작업을 모두 수행하는 것도 가능합니다. 두 컬렉션 권한이 동일한 지갑이 아닌 경우 둘 다 서명해야 합니다.

압축된 NFT의 컬렉션 설정

setCollectionV2 명령어는 cNFT의 컬렉션을 설정하는 데 사용할 수 있습니다. cNFT에서 컬렉션을 제거하거나 cNFT의 컬렉션을 변경하는 데도 사용할 수 있습니다.

import {
  getAssetWithProof,
  setCollectionV2,
  MetadataArgsV2Args
} from '@metaplex-foundation/mpl-bubblegum';
import {
  unwrapOption,
  none,
} from '@metaplex-foundation/umi';

const assetWithProof = await getAssetWithProof(umi, assetId, {truncateCanopy: true});

const metadata = assetWithProof.currentMetadata

const signature = await setCollectionV2(umi, {
  ...assetWithProof,
  newCollectionAuthority: newCollectionUpdateAuthority,
  metadata,
  newCoreCollection: newCoreCollection.publicKey,
}).sendAndConfirm(umi);

압축된 NFT의 컬렉션 제거

setCollectionV2 명령어는 cNFT에서 컬렉션을 제거하는 데도 사용할 수 있습니다.

import {
  getAssetWithProof,
  setCollectionV2,
  MetadataArgsV2Args
} from '@metaplex-foundation/mpl-bubblegum'
import {
  unwrapOption,
  none,
} from '@metaplex-foundation/umi';

const assetWithProof = await getAssetWithProof(umi, assetId, {truncateCanopy: true});

const collection = unwrapOption(assetWithProof.currentMetadata.collection)

const signature = await setCollectionV2(umi, {
  ...assetWithProof,
  metadata: assetWithProof.currentMetadata,
  authority: collectionAuthoritySigner,
  coreCollection: collection!,
}).sendAndConfirm(umi);

상속된 로열티

컬렉션에서 seller fee basis points를 상속하여 민팅된 cNFT는 리프에 센티널 값 65535를 저장합니다. 이는 컬렉션 관리에 영향을 줍니다:

• 컬렉션 제거 — 리프가 여전히 상속 센티널을 사용하는 동안 setCollectionV2는 작업을 거부합니다. 먼저 updateMetadataV2를 통해 cNFT의 sellerFeeBasisPoints를 명시적인 값으로 업데이트하세요.
• 다른 컬렉션으로 이동 — 대상 컬렉션에 Royalties 플러그인이 있으면 허용됩니다. cNFT는 상속 센티널을 유지하고 새 컬렉션에서 로열티를 해석합니다.
• 로열티가 없는 컬렉션으로 이동 — CollectionMustHaveRoyaltiesPlugin으로 거부됩니다.

Notes

• The MPL-Core collection must have the BubblegumV2 plugin enabled before cNFTs can be added to it.
• Unlike Bubblegum V1 (which uses Token Metadata collections with a "verified" boolean), V2 uses MPL-Core collections without verification flags.
• When changing between collections, both the old and new collection authorities must sign the transaction.
• 상속된 seller fee를 사용하는 cNFT는 리프에서 로열티가 명시적인 값으로 설정될 때까지 컬렉션에서 제거할 수 없습니다.

FAQ

민팅 후 cNFT를 컬렉션에 추가하려면 어떻게 해야 하나요?

컬렉션의 공개 키로 newCoreCollection 매개변수를 설정하여 setCollectionV2 명령을 사용하세요. 컬렉션 권한이 서명해야 합니다.

cNFT의 컬렉션을 변경할 수 있나요?

예. coreCollection(현재)과 newCoreCollection(새로운) 모두와 함께 setCollectionV2를 사용하세요. 권한이 다른 계정인 경우 두 컬렉션 권한이 모두 서명해야 합니다.

BubblegumV2 플러그인이란 무엇인가요?

동결/해동, 소울바운드 cNFT, 로열티 강제, 컬렉션 수준의 영구 위임자 등 Bubblegum V2 기능을 활성화하는 MPL-Core 컬렉션 플러그인입니다.

로열티를 상속하는 cNFT를 컬렉션에서 제거할 수 있나요?

아니요. 프로그램은 CannotRemoveFromCollectionWithInheritedSellerFee를 반환합니다. 먼저 updateMetadataV2로 sellerFeeBasisPoints를 명시적인 값으로 설정한 다음 setCollectionV2를 호출하여 컬렉션을 제거하세요.

Glossary