첫 번째 하이브리드 컬렉션 만들기

이 가이드는 하이브리드 컬렉션을 처음부터 끝까지 완전히 만드는 방법을 보여줍니다. 필요한 모든 자산을 만드는 방법부터 에스크로를 만들고 대체 가능한 토큰에서 대체 불가능한 토큰으로 그리고 그 반대로 스왑하기 위한 모든 매개변수를 설정하는 방법까지!

전제 조건

• 선택한 코드 에디터 (권장: Visual Studio Code)
• Node 18.x.x 이상.

초기 설정

이 가이드는 JavaScript를 사용하여 하이브리드 컬렉션을 만드는 방법을 가르칩니다! 필요에 따라 함수를 수정하고 이동해야 할 수도 있습니다.

프로젝트 초기화

선택한 패키지 매니저(npm, yarn, pnpm, bun)로 새 프로젝트를 초기화하고(선택사항) 요구되는 세부사항을 입력합니다.

npm init

필수 패키지

이 가이드에 필요한 패키지들을 설치합니다.

npm i @metaplex-foundation/umi

npm i @metaplex-foundation/umi-bundle-defaults

npm i @metaplex-foundation/mpl-core

npm i @metaplex-foundation/mpl-hybrid

npm i @metaplex-foundation/mpl-token-metadata

준비

대체 가능한 토큰을 대체 불가능한 토큰(NFT)으로 그리고 그 반대로 스왑을 가능하게 하는 MPL-Hybrid 프로그램의 에스크로를 설정하기 전에, Core NFT 컬렉션과 대체 가능한 토큰이 모두 이미 민팅되어 있어야 합니다.

이러한 전제 조건 중 하나라도 누락되어 있다면 걱정하지 마세요! 각 단계를 거치는 데 필요한 모든 리소스를 제공해드립니다.

참고: 작동하려면 에스크로에 NFT, 대체 가능한 토큰, 또는 둘의 조합으로 자금을 조달해야 합니다. 에스크로의 균형을 유지하는 가장 간단한 방법은 한 유형의 자산으로 완전히 채우면서 다른 유형을 배포하는 것입니다!

NFT 컬렉션 만들기

MPL-Hybrid 프로그램에서 메타데이터 무작위화 기능을 활용하려면, 오프체인 메타데이터 URI가 일관되고 증분적인 구조를 따라야 합니다. 이를 위해 Turbo SDK와 함께 Arweave의 path manifest 기능을 사용합니다.

Manifest는 여러 트랜잭션을 단일 기본 트랜잭션 ID 하에 연결하고 사람이 읽을 수 있는 파일 이름을 할당할 수 있게 해줍니다:

• https://arweave.net/manifestID/0.json
• https://arweave.net/manifestID/1.json
• ...
• https://arweave.net/manifestID/9999.json

결정론적 URI 생성에 익숙하지 않다면, 자세한 안내를 위해 이 가이드를 따를 수 있습니다. 또한 Hybrid 프로그램이 작동하는 데 필요한 컬렉션과 자산 생성에 대한 지침도 찾을 수 있습니다.

참고: 현재 MPL-Hybrid 프로그램은 제공된 최소 및 최대 URI 인덱스 사이에서 무작위로 숫자를 선택하며 URI가 이미 사용되었는지 확인하지 않습니다. 따라서 스왑은 생일 역설의 영향을 받습니다. 프로젝트가 충분한 스왑 무작위화의 혜택을 받으려면, 무작위로 선택할 수 있는 최소 25만 개의 자산 메타데이터를 준비하고 업로드하는 것을 권장합니다. 사용 가능한 잠재적 자산이 많을수록 좋습니다!

대체 가능한 토큰 만들기

MPL-Hybrid 에스크로는 NFT의 해제를 상환하거나 지불하는 데 사용할 수 있는 관련 대체 가능한 토큰이 필요합니다. 이는 이미 민팅되어 유통되고 있는 기존 토큰이거나 완전히 새로운 토큰일 수 있습니다!

토큰 생성에 익숙하지 않다면, Solana에서 자신만의 대체 가능한 토큰을 민팅하는 방법을 학습하기 위해 이 가이드를 따를 수 있습니다.

에스크로 만들기

NFT 컬렉션과 토큰을 모두 만든 후, 드디어 에스크로를 만들고 스왑을 시작할 준비가 되었습니다!

하지만 MPL-Hybrid에 대한 관련 정보로 뛰어들기 전에, 가이드 동안 여러 번 설정할 예정이므로 Umi 인스턴스를 설정하는 방법을 배우는 것이 좋습니다.

Umi 설정

Umi를 설정하는 동안 다양한 소스에서 키페어/지갑을 사용하거나 생성할 수 있습니다. 테스트용 새 지갑을 만들거나, 파일 시스템에서 기존 지갑을 가져오거나, 웹사이트/dApp을 만드는 경우 walletAdapter를 사용할 수 있습니다.

참고: 이 예제에서는 generatedSigner()로 Umi를 설정하지만 아래에서 모든 가능한 설정을 찾을 수 있습니다!

참고: walletAdapter 섹션은 이미 walletAdapter를 설치하고 설정했다고 가정하고 Umi에 연결하는 데 필요한 코드만 제공합니다. 포괄적인 가이드는 이것을 참조하세요

매개변수 설정

Umi 인스턴스를 설정한 후, 다음 단계는 MPL-Hybrid 에스크로에 필요한 매개변수를 구성하는 것입니다.

먼저 에스크로 계약의 일반 설정을 정의하겠습니다:

// 에스크로 설정 - 필요에 따라 변경하세요
const name = "MPL-404 Hybrid Escrow";
const uri = "https://arweave.net/manifestId";
const max = 15;
const min = 0;
const path = 0;

다음으로, 에스크로에 필요한 주요 계정들을 구성합니다:

// 에스크로 계정 - 필요에 따라 변경하세요
const collection = publicKey('<YOUR-COLLECTION-ADDRESS>');
const token = publicKey('<YOUR-TOKEN-ADDRESS>');
const feeLocation = publicKey('<YOUR-FEE-ADDRESS>');
const escrow = umi.eddsa.findPda(MPL_HYBRID_PROGRAM_ID, [
    string({ size: 'variable' }).serialize('escrow'),
    publicKeySerializer().serialize(collection),
]);

마지막으로, 토큰 관련 매개변수를 정의하고 소수점을 위해 토큰 양을 조정하는 도우미 함수 addZeros()를 만듭니다:

// 토큰 스왑 설정 - 필요에 따라 변경하세요
const tokenDecimals = 6;
const amount = addZeros(100, tokenDecimals);
const feeAmount = addZeros(1, tokenDecimals);
const solFeeAmount = addZeros(0, 9);

// 숫자에 0을 추가하는 함수, 올바른 소수점 자릿수를 추가하는 데 필요
function addZeros(num: number, numZeros: number): number {
  return num * Math.pow(10, numZeros)
}

에스크로 초기화

이제 설정한 모든 매개변수와 변수를 전달하여 initEscrowV1() 메서드를 사용해 에스크로를 초기화할 수 있습니다. 이것은 당신만의 MPL-Hybrid 에스크로를 만들 것입니다.

const initEscrowTx = await initEscrowV1(umi, {
  name,
  uri,
  max,
  min,
  path,
  escrow,
  collection,
  token,
  feeLocation,
  amount,
  feeAmount,
  solFeeAmount,
}).sendAndConfirm(umi);

const signature = base58.deserialize(initEscrowTx.signature)[0]
console.log(`Escrow created! https://explorer.solana.com/tx/${signature}?cluster=devnet`)

참고: 앞서 말했듯이, 단순히 에스크로를 만드는 것만으로는 스왑을 위해 "준비"되지 않습니다. 에스크로에 NFT나 토큰(또는 둘 다)으로 채워야 합니다. 방법은 다음과 같습니다:

전체 코드 예제

에스크로를 만들기 위한 전체 코드를 단순히 복사하여 붙여넣고 싶다면, 여기 있습니다!

Capture & Release

계정 설정

Umi를 설정한 후 (이전 섹션에서 했던 대로), 다음 단계는 Capture & Release 프로세스에 필요한 계정을 구성하는 것입니다. 이 계정들은 앞서 사용한 것과 유사하고 두 명령어 모두에 동일하므로 친숙할 것입니다:

// 2단계: 에스크로 계정 - 필요에 따라 변경하세요
const collection = publicKey('<YOUR-COLLECTION-ADDRESS>');
const token = publicKey('<YOUR-TOKEN-ADDRESS>');
const feeProjectAccount = publicKey('<YOUR-FEE-ADDRESS>');
const escrow = umi.eddsa.findPda(MPL_HYBRID_PROGRAM_ID, [
    string({ size: 'variable' }).serialize('escrow'),
    publicKeySerializer().serialize(collection),
]);

참고: feeProjectAccount는 마지막 스크립트의 feeLocation 필드와 동일합니다.

캡처/릴리스할 자산 선택

캡처하고 릴리스할 자산을 선택하는 방법은 에스크로를 만들 때 선택한 경로에 따라 다릅니다:

• Path 0: 경로가 0으로 설정되면, 스왑 중에 NFT 메타데이터가 업데이트되므로, 이것은 중요하지 않기 때문에 에스크로에서 무작위 자산을 가져올 수 있습니다.
• Path 1: 경로가 1로 설정되면, 스왑 후에도 NFT 메타데이터가 동일하게 유지되므로, 사용자가 스왑하고 싶은 특정 NFT를 선택하게 할 수 있습니다.

Capture의 경우

NFT를 캡처하는 경우, 에스크로가 소유한 무작위 자산을 선택하는 방법은 다음과 같습니다:

// 컬렉션의 모든 자산 가져오기
const assetsListByCollection = await fetchAssetsByCollection(umi, collection, {
    skipDerivePlugins: false,
})

// 에스크로가 소유한 자산 찾기
const asset = assetsListByCollection.filter(
    (a) => a.owner === publicKey(escrow)
)[0].publicKey

Release의 경우

NFT를 릴리스하는 경우, 일반적으로 사용자가 릴리스하고 싶은 것을 선택합니다. 하지만 이 예제에서는 사용자가 소유한 무작위 자산을 선택하겠습니다:

// 컬렉션의 모든 자산 가져오기
const assetsListByCollection = await fetchAssetsByCollection(umi, collection, {
    skipDerivePlugins: false,
})

// 보통 사용자가 교환할 것을 선택합니다
const asset = assetsListByCollection.filter(
    (a) => a.owner === umi.identity.publicKey
)[0].publicKey

Capture (대체 가능한 것에서 대체 불가능한 것으로)

이제 드디어 Capture 명령어에 대해 이야기해봅시다. 이는 대체 가능한 토큰을 NFT로 스왑하는 과정입니다 (스왑에 필요한 토큰의 양은 에스크로 생성 시 설정됩니다).

// 대체 가능한 토큰을 스왑하여 NFT 캡처
const captureTx = await captureV1(umi, {
  owner: umi.identity.publicKey,
  escrow,
  asset,
  collection,
  token,
  feeProjectAccount,
  amount,
}).sendAndConfirm(umi);

const signature = base58.deserialize(captureTx.signature)[0];
console.log(`Captured! Check it out: https://explorer.solana.com/tx/${signature}?cluster=devnet`);

Release (대체 불가능한 것에서 대체 가능한 것으로)

릴리스는 캡처의 반대입니다—여기서는 NFT를 대체 가능한 토큰으로 스왑합니다:

// NFT를 릴리스하고 대체 가능한 토큰 받기
const releaseTx = await releaseV1(umi, {
  owner: umi.payer,
  escrow,
  asset,
  collection,
  token,
  feeProjectAccount,
}).sendAndConfirm(umi);

const signature = base58.deserialize(releaseTx.signature)[0];
console.log(`Released! Check it out: https://explorer.solana.com/tx/${signature}?cluster=devnet`);

전체 코드 예제

Capture와 Release를 위한 전체 코드입니다