Edition 플러그인

Edition 플러그인은 개별 Asset에 에디션 번호를 저장합니다. 수집 시리즈와 한정판을 위해 "1 of 100"과 같은 번호가 매겨진 프린트를 만드는 데 사용합니다.

요약

Edition 플러그인은 Asset에 고유한 에디션 번호를 저장하는 권한 관리 플러그인입니다. 번호가 매겨진 에디션을 함께 그룹화하기 위해 Collection의 Master Edition 플러그인과 함께 사용하는 것이 좋습니다.

• 권한 관리 (업데이트 권한자가 제어)
• Asset 생성 시 추가해야 함
• 권한이 변경 가능하면 번호 업데이트 가능
• 자동 번호 부여를 위해 Candy Machine Edition Guard와 함께 사용

범위 외

공급량 강제 (정보 제공만), 자동 번호 부여 (Candy Machine 사용), Collection 수준 에디션 (Collection에는 Master Edition 플러그인 사용).

빠른 시작

바로 가기: 변경 가능한 에디션 생성 · 불변 에디션 생성 · 에디션 업데이트

1. Asset 생성 시 고유 번호와 함께 Edition 플러그인 추가
2. 선택적으로 불변성을 위해 권한을 None으로 설정
3. 변경 가능하면 나중에 번호 업데이트

호환 대상

인자

editions 플러그인으로 Asset 생성

Editions Plugin은 자산 생성 시 추가해야 합니다. 변경 가능한 한 번호를 변경할 수 있습니다.

변경 가능한 플러그인으로 생성

import { publicKey } from '@metaplex-foundation/umi'
import { create } from '@metaplex-foundation/mpl-core'
const assetSigner = generateSigner(umi)
const result = create(umi, {
  asset: assetSigner,
  name: 'My Asset',
  uri: 'https://example.com/my-asset.json',
  plugins: [
    {
      type: 'Edition',
      number: 1
    },
  ],
}).sendAndConfirm(umi)

불변 플러그인으로 생성

불변 Edition Plugin으로 Asset을 생성하려면 다음 코드를 사용할 수 있습니다:

import { publicKey } from '@metaplex-foundation/umi'
import { create } from '@metaplex-foundation/mpl-core'
const asset = generateSigner(umi)
const result = create(umi, {
  asset: asset,
  name: 'My Nft',
  uri: 'https://example.com/my-nft',
  plugins: [
    {
      type: 'Edition',
      number: 1,
      authority: { type: 'None' },
    },
  ],
}).sendAndConfirm(umi)

Editions 플러그인 업데이트

Editions Plugin이 변경 가능하면 다른 플러그인과 유사하게 업데이트할 수 있습니다:

import { publicKey } from '@metaplex-foundation/umi'
import { updatePlugin } from '@metaplex-foundation/mpl-core'
const asset = publicKey('11111111111111111111111111111111')
  await updatePlugin(umi, {
    asset: assetAccount.publicKey,
    plugin: { type: 'Edition', number: 2 },
  }).sendAndConfirm(umi);

일반적인 오류

Cannot add Edition plugin after creation

Edition 플러그인은 Asset 생성 시 추가해야 합니다. 기존 Asset에는 추가할 수 없습니다.

Authority mismatch

업데이트 권한자만 에디션 번호를 업데이트할 수 있습니다 (변경 가능한 경우).

Plugin is immutable

Edition 플러그인의 권한이 None으로 설정되어 있습니다. 번호를 변경할 수 없습니다.

참고 사항

• 에디션 번호는 고유하도록 강제되지 않음—창작자가 이를 추적해야 함
• 플러그인은 create() 중에 추가해야 하며, 이후에는 안 됨
• 권한을 None으로 설정하면 에디션 번호가 영구적이 됨
• 적절한 그룹화를 위해 Collection의 Master Edition 플러그인과 함께 사용

빠른 참조

권한 옵션

권장 설정

FAQ

에디션 번호가 고유하도록 강제되나요?

아니요. 에디션 번호는 정보 제공 목적입니다. 창작자가 고유 번호를 보장할 책임이 있습니다. 자동 순차 번호 부여를 위해 Edition Guard가 있는 Candy Machine을 사용하세요.

기존 Asset에 Edition 플러그인을 추가할 수 있나요?

아니요. Edition 플러그인은 Asset 생성 시 추가해야 합니다. 에디션 번호가 필요하면 미리 계획하세요.

"1 of 100" 스타일 에디션을 어떻게 만드나요?

Asset에 Edition 플러그인을 추가하고 (1-100 번호로) Collection에 maxSupply: 100으로 Master Edition 플러그인을 추가합니다. Master Edition은 에디션을 그룹화하고 총 공급량을 나타냅니다.

생성 후 에디션 번호를 변경할 수 있나요?

네, 플러그인 권한이 None으로 설정되지 않았다면 가능합니다. 업데이트 권한자가 updatePlugin을 사용하여 번호를 수정할 수 있습니다.

Edition과 Master Edition의 차이점은 무엇인가요?

Edition은 개별 번호 (예: #5)를 Asset에 저장합니다. Master Edition은 컬렉션 수준 데이터 (최대 공급량, 에디션 이름/URI)를 Collection에 저장하고 에디션을 함께 그룹화합니다.

용어집