시작하기

NFT 업데이트하기

Last updated March 12, 2025

업데이트 권한자로서 NFT의 이름과 메타데이터를 업데이트합니다.

NFT 업데이트하기

다음 섹션에서 전체 코드 예제와 변경이 필요할 수 있는 파라미터를 확인할 수 있습니다. NFT 업데이트에 대한 자세한 내용은 Core 문서를 참조하세요.

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')

파라미터

업데이트에 맞게 다음 파라미터를 커스터마이징하세요:

파라미터설명
assetAddress업데이트할 NFT의 공개 키
nameNFT의 새 이름 (선택 사항)
uri새 메타데이터 URI (선택 사항)

작동 방식

업데이트 과정은 세 단계를 포함합니다:

  1. NFT 가져오기 - fetchAsset을 사용하여 현재 NFT 데이터를 가져옵니다
  2. 업데이트 준비 - 변경하려는 새 이름 또는 URI를 지정합니다
  3. 업데이트 전송 - 업데이트 트랜잭션을 실행합니다

NFT의 업데이트 권한자만 NFT를 수정할 수 있습니다. NFT가 컬렉션의 일부이고 컬렉션 권한을 사용하는 경우, 컬렉션의 업데이트 권한자여야 합니다.