Core Collection 생성

createCollection 명령어는 이름, 메타데이터 URI, 선택적 플러그인을 가진 새로운 Core Collection 계정을 Solana에 생성합니다.

Summary

createCollection은 Core Asset을 공유 메타데이터와 플러그인 아래에 그룹화하는 새로운 Collection 계정을 배포합니다.

• collection 주소로 새로운 키페어가 필요합니다 — 기존 주소를 재사용하면 실패합니다
• 생성 시 선택적 플러그인을 지정할 수 있습니다
• 렌트로 약 0.0015 SOL이 필요합니다
• 기본적으로 페이어가 updateAuthority가 됩니다

Quick Start

1. 설치: npm install @metaplex-foundation/mpl-core @metaplex-foundation/umi
2. 컬렉션 메타데이터 JSON을 업로드하여 URI 획득
3. createCollection(umi, { collection, name, uri }) 호출
4. Asset 생성 시 collection 주소 전달

이동: 간단한 Collection · 플러그인 포함 · 오류 처리

전제 조건

• 서명자와 RPC 연결이 설정된 Umi — JavaScript SDK 참조
• 트랜잭션 수수료용 SOL (Collection 당 약 0.002 SOL)
• Arweave 또는 IPFS에 업로드된 컬렉션 이미지와 이름이 포함된 메타데이터 JSON

간단한 Collection 생성

createCollection에는 name, 메타데이터 uri, 그리고 collection 서명자로 새로운 키페어가 필요합니다.

1import { createUmi } from '@metaplex-foundation/umi-bundle-defaults'
2import { createCollection } from '@metaplex-foundation/mpl-core'
3import { mplCore } from '@metaplex-foundation/mpl-core'
4import { generateSigner } from '@metaplex-foundation/umi'
5
6// Initialize UMI
7const umi = createUmi('https://api.devnet.solana.com')
8  .use(mplCore())
9
10// Generate a new keypair for the collection
11const collectionSigner = generateSigner(umi)
12
13// Create a new Collection
14await createCollection(umi, {
15  collection: collectionSigner,
16  name: 'My Collection',
17  uri: 'https://example.com/collection.json',
18}).sendAndConfirm(umi)
19
20console.log('Collection created:', collectionSigner.publicKey)

플러그인이 포함된 Collection 생성

createCollection에 plugins 배열을 전달하여 생성 시 플러그인을 부착할 수 있습니다. 아래 예시는 Royalties 플러그인을 부착합니다.

import { generateSigner, publicKey } from '@metaplex-foundation/umi'
import { createCollection, ruleSet } from '@metaplex-foundation/mpl-core'

const collectionSigner = generateSigner(umi)
const creator1 = publicKey('11111111111111111111111111111111')
const creator2 = publicKey('22222222222222222222222222222222')

await createCollection(umi, {
  collection: collectionSigner,
  name: 'My NFT',
  uri: 'https://example.com/my-nft.json',
  plugins: [
    {
      type: 'Royalties',
      basisPoints: 500,
      creators: [
        { address: creator1, percentage: 20 },
        { address: creator2, percentage: 80 },
      ],
      ruleSet: ruleSet('None'),
    },
  ],
}).sendAndConfirm(umi)

일반적인 오류

Collection account already exists

이 네트워크에서 collection 키페어가 이미 사용되었습니다. 매번 새로운 서명자를 생성하세요:

const collectionSigner = generateSigner(umi) // 고유한 키페어여야 함

Insufficient funds

페이어 지갑에 약 0.002 SOL이 필요합니다. 데브넷에서 충전하는 방법:

solana airdrop 1 <WALLET_ADDRESS> --url devnet

Notes

• 생성 시 추가한 플러그인은 나중에 updateCollectionPlugin으로 업데이트할 수 있습니다 — Collection 업데이트 참조
• updateAuthority는 기본적으로 페이어가 됩니다 — 다른 계정으로 설정하려면 명시적으로 updateAuthority를 전달하세요
• Asset에 사용 가능한 모든 플러그인은 Collection에도 적용할 수 있습니다 — 플러그인 개요 참조

Quick Reference