Asset 전송

이 가이드는 Metaplex Core SDK를 사용하여 Solana에서 지갑 간에 Core Asset을 전송하는 방법을 보여줍니다. 단일 명령어로 다른 사용자에게 NFT를 보냅니다.

요약

transfer 명령어를 사용하여 Core Asset을 새 소유자에게 전송합니다. 현재 소유자(또는 승인된 Transfer Delegate)만 전송을 시작할 수 있습니다.

• 수신자의 주소로 transfer(umi, { asset, newOwner }) 호출
• Collection Asset의 경우 collection 파라미터 포함
• Transfer Delegate는 소유자를 대신하여 전송 가능
• 전송은 무료 (트랜잭션 수수료만 적용)

범위 외

Token Metadata 전송 (mpl-token-metadata 사용), 배치 전송 (Asset 루프), 마켓플레이스 판매 (에스크로 프로그램 사용).

빠른 시작

바로가기: 기본 전송 · 컬렉션 전송 · 위임자 전송

1. 설치: npm install @metaplex-foundation/mpl-core @metaplex-foundation/umi
2. Asset을 가져와서 소유권과 컬렉션 멤버십 확인
3. transfer(umi, { asset, newOwner }) 호출
4. fetchAsset()로 소유권이 변경되었는지 확인

전제 조건

• Asset을 소유한 (또는 Transfer Delegate인) 서명자로 구성된 Umi
• 전송할 Asset의 Asset 주소
• 새 소유자의 수신자 주소 (공개 키) Core Asset의 소유자는 MPL Core 프로그램에 transfer 명령어를 사용하여 다른 계정으로 소유권을 전송할 수 있습니다.

Core Asset 전송

1import { createUmi } from '@metaplex-foundation/umi-bundle-defaults'
2import { transfer } from '@metaplex-foundation/mpl-core'
3import { mplCore } from '@metaplex-foundation/mpl-core'
4import { publicKey } from '@metaplex-foundation/umi'
5
6// Initialize UMI
7const umi = createUmi('https://api.devnet.solana.com')
8  .use(mplCore())
9
10// Transfer an existing NFT asset to a new owner
11const result = await transfer(umi, {
12  asset: publicKey('AssetAddressHere...'),
13  newOwner: publicKey('RecipientAddressHere...'),
14}).sendAndConfirm(umi)
15
16console.log('Asset transferred:', result.signature)

Collection 내 Core Asset 전송

컬렉션이 있는 Asset을 전송하는 경우 컬렉션 주소를 전달해야 합니다. Asset이 Collection에 있는지 확인하는 방법

import { publicKey } from '@metaplex-foundation/umi'
import { transferV1 } from '@metaplex-foundation/mpl-core'
const asset = publicKey('11111111111111111111111111111111')
await transferV1(umi, {
  asset: asset.publicKey,
  newOwner: newOwner.publicKey,
  collection: colleciton.publicKey,
}).sendAndConfirm(umi)

Asset의 Transfer Delegate인 경우는?

Transfer Delegate 플러그인을 통해 Asset의 Transfer Delegate인 경우, Asset의 소유자인 것처럼 transferV1 함수를 호출할 수 있습니다.

일반적인 오류

Authority mismatch

Asset의 소유자나 Transfer Delegate가 아닙니다. 소유권을 확인하세요:

const asset = await fetchAsset(umi, assetAddress)
console.log(asset.owner) // 서명자와 일치해야 함

Asset is frozen

Asset에 Freeze Delegate 플러그인이 있고 현재 동결되어 있습니다. 전송 전에 동결 권한자가 해제해야 합니다.

Missing collection parameter

Collection 내 Asset의 경우 collection 주소를 전달해야 합니다. Asset에 컬렉션이 있는지 확인하세요:

const asset = await fetchAsset(umi, assetAddress)
if (asset.updateAuthority.type === 'Collection') {
  console.log('Collection:', asset.updateAuthority.address)
}

참고사항

• 전송은 무료 - 렌트 비용 없음, 트랜잭션 수수료만 (~0.000005 SOL)
• 새 소유자는 Asset의 전체 제어권을 받음
• Transfer, Burn, Freeze Delegate는 전송 성공 후 취소됨
• 동결된 Asset은 해제될 때까지 전송 불가
• 컬렉션 멤버십을 확인하기 위해 항상 먼저 Asset을 가져오세요

빠른 참조

전송 파라미터

누가 전송할 수 있나요?

FAQ

Asset이 Collection에 있는지 어떻게 알 수 있나요?

Asset을 가져와서 updateAuthority를 확인합니다:

const asset = await fetchAsset(umi, assetAddress)
if (asset.updateAuthority.type === 'Collection') {
  // asset.updateAuthority.address를 collection 파라미터로 전달
}

나 자신에게 전송할 수 있나요?

예. 자신의 주소로 전송하는 것은 유효합니다 (지갑 통합이나 테스트에 유용).

전송 후 Transfer Delegate는 어떻게 되나요?

Transfer Delegate 플러그인은 전송이 완료되면 자동으로 취소됩니다. 새 소유자는 필요시 새 위임자를 할당해야 합니다.

전송을 취소할 수 있나요?

아니요. 전송은 원자적입니다 - 트랜잭션이 확인되면 소유권이 변경됩니다. 취소할 보류 상태가 없습니다.

여러 Asset을 한 번에 전송할 수 있나요?

단일 명령어로는 불가능합니다. 하나의 트랜잭션에 여러 전송 명령어를 배치할 수 있습니다 (트랜잭션 크기 제한 내에서), 하지만 각 Asset에는 자체 전송 호출이 필요합니다.

전송하면 update authority가 변경되나요?

아니요. 전송은 소유권만 변경합니다. update authority는 update 명령어를 통해 명시적으로 변경하지 않는 한 동일하게 유지됩니다.

용어집