Asset 업데이트

이 가이드에서는 Metaplex Core SDK를 사용하여 Solana에서 Core Asset 메타데이터를 업데이트하는 방법을 설명합니다. 관리하는 Asset의 이름, URI 또는 컬렉션 멤버십을 변경할 수 있습니다.

요약

update 명령어를 사용하여 Core Asset의 메타데이터를 업데이트합니다. Update Authority(또는 승인된 위임자)만 Asset을 수정할 수 있습니다.

• name과 uri를 변경하여 메타데이터 업데이트
• newCollection을 사용하여 Collection 간 Asset 이동
• updateAuthority를 None으로 설정하여 불변으로 만들기
• 계정 크기를 변경하지 않는 한 업데이트는 무료(렌트 비용 없음)

범위 외

Token Metadata NFT 업데이트(mpl-token-metadata 사용), 플러그인 수정(플러그인 참조), 소유권 전송(Asset 전송 참조).

빠른 시작

바로가기: Asset 업데이트 · Collection 변경 · 불변화

1. 설치: npm install @metaplex-foundation/mpl-core @metaplex-foundation/umi
2. 현재 상태를 가져오기 위해 Asset 페치
3. 새 값으로 update(umi, { asset, name, uri }) 호출
4. fetchAsset()으로 변경 사항 확인

전제 조건

• Asset의 Update Authority인 서명자가 구성된 Umi
• 업데이트할 Asset 주소
• Arweave/IPFS에 업로드된 새 메타데이터(URI 변경 시) Core Asset의 Update Authority 또는 위임자는 Asset 데이터의 일부를 변경할 권한이 있습니다.

Core Asset 업데이트

SDK를 사용하여 MPL Core Asset을 업데이트하는 방법입니다.

1import { createUmi } from '@metaplex-foundation/umi-bundle-defaults'
2import { update } from '@metaplex-foundation/mpl-core'
3import { mplCore } from '@metaplex-foundation/mpl-core'
4import { publicKey } from '@metaplex-foundation/umi'
5
6const umi = createUmi('https://api.devnet.solana.com').use(mplCore())
7const assetAddress = publicKey('AssetAddressHere...')
8
9// Update an existing NFT asset's metadata
10const result = await update(umi, {
11  asset: assetAddress,
12  name: 'Updated NFT Name',
13  uri: 'https://updated-example.com/metadata.json',
14}).sendAndConfirm(umi)
15
16console.log('Asset updated successfully')

Core Asset의 Collection 변경

SDK를 사용하여 Core Asset의 Collection을 변경하는 방법입니다.

import { publicKey } from "@metaplex-foundation/umi";
import {
  update,
  fetchAsset,
  fetchCollection,
  collectionAddress,
  updateAuthority
} from "@metaplex-foundation/mpl-core";
const assetId = publicKey("11111111111111111111111111111111");
const asset = await fetchAsset(umi, assetId);
const collectionId = collectionAddress(asset)
if (!collectionId) {
  console.log("Collection not found");
  return;
}
const collection = await fetchCollection(umi, collectionId);
const newCollectionId = publicKey("22222222222222222222222222222222")
const updateTx = await update(umi, {
  asset,
  collection,
  newCollection: newCollectionId,
  newUpdateAuthority: updateAuthority('Collection', [newCollectionId]),
}).sendAndConfirm(umi);

Core Asset 데이터 불변화

SDK를 사용하여 Core Asset을 완전히 불변으로 만드는 방법입니다. 불변성 가이드에서 설명하는 다양한 수준의 불변성이 있다는 점에 유의하세요.

import { publicKey } from '@metaplex-foundation/umi'
import { update, fetchAsset } from '@metaplex-foundation/mpl-core'
const assetId = publicKey('11111111111111111111111111111111')
const asset = await fetchAsset(umi, asset)
await update(umi, {
  asset: asset,
  newUpdateAuthority: updateAuthority('None'),
}).sendAndConfirm(umi)

일반적인 오류

Authority mismatch

당신은 Asset의 Update Authority가 아닙니다. 확인하세요:

const asset = await fetchAsset(umi, assetAddress)
console.log(asset.updateAuthority) // 서명자와 일치해야 합니다

Collection authority required

Collection을 변경할 때 Asset과 대상 Collection 모두에서 권한이 필요합니다.

Asset is immutable

Asset의 Update Authority가 None으로 설정되어 있습니다. 이것은 되돌릴 수 없습니다.

참고 사항

• 업데이트 전에 Asset을 페치하여 현재 상태 확인
• Update Authority(또는 위임자)만 Asset을 업데이트할 수 있음
• Asset을 불변으로 만드는 것은 영구적이고 되돌릴 수 없음
• Collection을 변경하면 상속된 플러그인(로열티 등)에 영향을 줄 수 있음
• 업데이트로 Asset의 소유자는 변경되지 않음

빠른 참조

업데이트 매개변수

Authority 타입

FAQ

Asset을 불변으로 만든 후 되돌릴 수 있나요?

아니요. Update Authority를 None으로 설정하는 것은 영구적입니다. Asset의 이름, URI, 컬렉션 멤버십이 영원히 고정됩니다. 확실할 때만 수행하세요.

URI를 변경하지 않고 이름만 업데이트하려면 어떻게 하나요?

변경하려는 필드만 전달합니다. 현재 값을 유지하려면 uri를 생략하세요:

await update(umi, { asset, name: 'New Name' }).sendAndConfirm(umi)

업데이트와 전송의 차이점은 무엇인가요?

업데이트는 Asset의 메타데이터(이름, URI)를 변경합니다. 전송은 소유권을 변경합니다. 서로 다른 권한 요구사항을 가진 별개의 작업입니다.

위임자가 Asset을 업데이트할 수 있나요?

네, Update Delegate 플러그인을 통해 Update Delegate로 지정된 경우 가능합니다.

업데이트에 SOL이 드나요?

새 데이터가 현재 계정 크기보다 큰 경우(드물게)를 제외하고 업데이트는 무료입니다. 트랜잭션 수수료(약 0.000005 SOL)는 여전히 적용됩니다.

용어집