기능

Core Collections

Last updated April 8, 2026

Summary

Core Collection은 관련 Core Asset을 공유 메타데이터와 플러그인 아래에 그룹화하는 Solana 계정입니다.

  • Collection은 이름, URI, 그리고 모든 멤버 Asset에 적용되는 선택적 플러그인을 저장합니다
  • Asset은 생성 또는 업데이트 시 collection 필드를 통해 Collection을 참조합니다
  • 컬렉션 레벨 플러그인(예: Royalties)은 Asset 레벨에서 재정의되지 않는 한 모든 멤버 Asset에 적용됩니다
  • Collection 생성에는 렌트로 약 0.0015 SOL이 필요합니다

작업으로 이동: Collection 생성 · Collection 조회 · Collection 업데이트

Collection이란?

Core Collection은 같은 시리즈나 세트에 속하는 Asset의 그룹입니다. Asset을 그룹화하려면 먼저 컬렉션 이름과 이미지 URI 등 공유 메타데이터를 저장하는 Collection 계정을 생성해야 합니다. Collection 계정은 컬렉션의 표지 역할을 하며 컬렉션 전체 플러그인도 보유할 수 있습니다.

Collection 계정에 저장되는 데이터는 다음과 같습니다:

필드설명
key계정 키 식별자
updateAuthority컬렉션의 관리자
name컬렉션 이름
uri컬렉션의 오프체인 메타데이터 URI
numMinted컬렉션에서 생성된 총 Asset 수
currentSize현재 컬렉션 내 Asset 수

Core Collection은 Core Asset만 그룹화합니다. Token Metadata NFT에는 mpl-token-metadata를, 압축 NFT에는 Bubblegum을 사용하세요.

컬렉션 멤버십 관리

Asset은 생성 후 update 명령어를 사용해 Collection에 추가, 이동, 또는 제거할 수 있습니다. 이러한 작업은 Asset의 update authority를 변경합니다. 추가하면 Collection으로 설정되고, 제거하면 지갑 주소로 돌아옵니다.

작업설명가이드
Collection에 Asset 추가독립 Asset을 Collection에 할당SDK · CLI
Asset을 다른 Collection으로 이동Asset을 한 Collection에서 다른 Collection으로 이전SDK · CLI
Collection에서 Asset 제거Asset을 분리하여 독립 상태로 복원SDK · CLI

멤버십을 변경하려면 Collection의 update authority(독립 상태인 경우 Asset도 포함)여야 합니다. Collection 간 이동에는 소스와 대상 Collection 모두에 대한 권한이 필요합니다.

Collection에 등록된 Update Delegate도 루트 update authority의 서명 없이 이러한 작업을 수행할 수 있습니다. Collection에서 Asset 제거 및 권한을 가진 Asset 추가가 가능합니다.

Notes

  • Asset은 Collection 없이 독립적으로 존재할 수 있습니다 — Collection은 필수가 아닙니다
  • 컬렉션 레벨 플러그인은 동일한 타입의 자체 플러그인을 가진 Asset을 제외한 멤버 Asset에 상속됩니다
  • numMinted는 컬렉션에서 생성된 모든 Asset의 누적 수이고, currentSize는 실시간 카운트입니다
  • Collection은 Asset이 포함된 동안 닫을 수 없습니다 — 먼저 모든 Asset을 제거하세요

Quick Reference

프로그램 ID

네트워크주소
MainnetCoREENxT6tW1HoK8ypY1SxRMZTcVPm7R94rH4PZNhX7d
DevnetCoREENxT6tW1HoK8ypY1SxRMZTcVPm7R94rH4PZNhX7d

Collection 작업

작업페이지SDK 함수
Collection 생성Collection 생성createCollection
Collection 조회Collection 조회fetchCollection
Collection 메타데이터 업데이트Collection 업데이트updateCollection
Collection 플러그인 업데이트Collection 업데이트updateCollectionPlugin

비용 내역

항목비용
Collection 계정 렌트약 0.0015 SOL
트랜잭션 수수료약 0.000005 SOL
합계약 0.002 SOL

FAQ

Collection과 Asset의 차이점은 무엇인가요?

Collection은 Asset을 그룹화하는 컨테이너입니다. 자체 메타데이터(이름, 이미지)를 가지지만 Asset처럼 소유하거나 전송할 수 없습니다. Asset은 사용자가 소유하는 실제 NFT입니다.

기존 Asset을 Collection에 추가할 수 있나요?

네, newCollection 파라미터를 사용하여 update 명령어를 사용하면 됩니다. Asset의 Update Authority가 대상 Collection에 Asset을 추가할 권한을 가지고 있어야 합니다.

NFT에 Collection이 필요한가요?

아니요. Asset은 Collection 없이 독립적으로 존재할 수 있습니다. 하지만 Collection을 사용하면 컬렉션 레벨 로열티 설정, 더 쉬운 검색, 일괄 작업이 가능해집니다.

Collection에서 Asset을 제거할 수 있나요?

네, update 명령어를 사용하여 Asset의 컬렉션을 변경하면 됩니다. Asset과 Collection 모두에 대한 적절한 권한이 필요합니다.

Collection을 삭제하면 어떻게 되나요?

Collection은 Asset이 포함되어 있는 동안 삭제할 수 없습니다. 먼저 모든 Asset을 제거한 후 Collection 계정을 닫을 수 있습니다.

Glossary

용어정의
Collection관련 Asset을 공유 메타데이터 아래에 그룹화하는 Core 계정
Update AuthorityCollection 메타데이터와 플러그인을 수정할 수 있는 계정
numMinted컬렉션에서 생성된 총 Asset 수를 추적하는 카운터
currentSize현재 컬렉션 내 Asset 수
Collection Plugin모든 멤버 Asset에 적용될 수 있는 Collection에 부착된 플러그인
URICollection의 오프체인 JSON 메타데이터를 가리키는 URL