솔라나 토큰 런치패드 | 토큰 세일 & 공정한 출시 토큰 런치패드

Genesis를 사용하여 솔라나에서 SPL 토큰을 출시하세요 — 온체인 토큰 런치패드이자 공정한 출시 플랫폼입니다. 토큰 세일, 크라우드세일을 실행하려는 경우, Genesis Launch Pool은 온체인에서 투명하게 토큰 배포를 처리합니다. 사용자는 설정한 기간 동안 SOL을 예치하고, 총 예치금에서 자신의 지분 비율에 따라 토큰을 받습니다.

노코드 옵션

코드를 작성하고 싶지 않으신가요? Metaplex 토큰 런치패드를 사용하여 코딩 없이 토큰을 출시하세요. 이 가이드는 Genesis SDK를 사용하여 자체 토큰 출시 경험을 구축하거나 자체 웹사이트에서 토큰 세일을 호스팅하려는 개발자를 위한 것입니다.

다른 출시 방법

이 가이드는 Launch Pool 방식을 다루지만, Genesis는 고정 가격으로 토큰을 판매하는 프리세일 출시도 지원합니다. Genesis 개요에서 각 방식을 비교하고 프로젝트에 가장 적합한 방법을 선택하세요.

개요

Genesis는 공정한 온체인 토큰 출시 메커니즘을 제공하는 솔라나 토큰 런치패드입니다. 고정 가격으로 토큰을 판매하는 기존 중앙화된 토큰 세일 플랫폼과 달리, Launch Pool은 시장이 토큰 배분을 결정합니다 — 모든 참가자가 예치금에 비례하여 토큰을 받아 공정하고 투명한 토큰 생성 이벤트(TGE)를 보장합니다. 모든 SPL 토큰 생성, 자금 조달, 배포가 중개자 없이 온체인에서 이루어집니다.

Launch Pool 토큰 출시에는 세 가지 단계가 있습니다:

설정 (한 번 실행) - 토큰을 생성하고, 출시를 구성하고, 활성화합니다
예치 기간 (사용자 참여) - 설정한 기간 동안 사용자가 SOL을 예치합니다
출시 후 (당신 + 사용자) - 전환을 실행하고, 사용자가 토큰을 청구하고, 권한을 철회합니다

이 가이드에서는 서로 다른 단계에서 실행할 4개의 별도 스크립트를 만드는 방법을 안내합니다:

스크립트	실행 시점	목적
`launch.ts`	한 번, 시작 시	토큰을 생성하고 출시를 활성화
`transition.ts`	예치 종료 후	수집된 SOL을 잠금 해제 버킷으로 이동
`claim.ts`	전환 후	사용자가 토큰을 청구하기 위해 실행
`revoke.ts`	출시 완료 시	민트/동결 권한을 영구적으로 제거

사전 요구 사항

새 프로젝트를 만들고 종속성을 설치합니다:

mkdir my-token-launch
cd my-token-launch
npm init -y
npm install @metaplex-foundation/genesis @metaplex-foundation/umi @metaplex-foundation/umi-bundle-defaults @metaplex-foundation/mpl-toolbox

전체 출시 스크립트

아래는 완전하고 실행 가능한 스크립트입니다. 각 섹션에는 설명하는 주석이 있습니다. 이 스크립트를 한 번 실행하여 출시를 설정합니다.

키페어 필요

트랜잭션에 서명하려면 머신에 Solana 키페어 파일이 필요합니다. 이것은 일반적으로 ~/.config/solana/id.json에 있는 Solana CLI 지갑입니다. 스크립트의 walletFile 경로를 키페어 파일을 가리키도록 업데이트하세요. 이 지갑에 트랜잭션 수수료를 위한 SOL이 있는지 확인하세요.

launch.ts라는 파일을 만듭니다:

import { createUmi } from '@metaplex-foundation/umi-bundle-defaults';
import {
  genesis,
  initializeV2,
  findGenesisAccountV2Pda,
  findLaunchPoolBucketV2Pda,
  findUnlockedBucketV2Pda,
  addLaunchPoolBucketV2,
  addUnlockedBucketV2,
  finalizeV2,
} from '@metaplex-foundation/genesis';
import { generateSigner, publicKey, keypairIdentity } from '@metaplex-foundation/umi';

async function main() {
  // ============================================
  // 설정: 연결 및 지갑 구성
  // ============================================

  const umi = createUmi('https://api.devnet.solana.com')
    .use(genesis());

  // 머신의 파일에서 지갑 키페어 로드
  // 이것은 일반적으로 ~/.config/solana/id.json에 있는 Solana CLI 지갑입니다
  // 또는 액세스할 수 있는 모든 키페어 파일 사용
  const walletFile = '/path/to/your/keypair.json'; // <-- 이 경로 업데이트
  const secretKey = JSON.parse(require('fs').readFileSync(walletFile, 'utf-8'));
  const keypair = umi.eddsa.createKeypairFromSecretKey(new Uint8Array(secretKey));
  umi.use(keypairIdentity(keypair));

  // ============================================
  // 구성: 이 값들을 커스터마이즈
  // ============================================

  // 토큰 세부 정보
  const TOKEN_NAME = 'My Token';
  const TOKEN_SYMBOL = 'MTK';
  const TOKEN_URI = 'https://example.com/metadata.json'; // 메타데이터 JSON URL
  const TOTAL_SUPPLY = 1_000_000_000_000n; // 1조 토큰 (필요에 따라 조정)

  // 타이밍 (현재부터 초 단위)
  const DEPOSIT_DURATION = 24 * 60 * 60; // 24시간
  const CLAIM_DURATION = 7 * 24 * 60 * 60; // 7일

  // 타임스탬프 계산
  const now = BigInt(Math.floor(Date.now() / 1000));
  const depositStart = now;
  const depositEnd = now + BigInt(DEPOSIT_DURATION);
  const claimStart = depositEnd + 1n;
  const claimEnd = claimStart + BigInt(CLAIM_DURATION);

  // ============================================
  // 1단계: 토큰 생성
  // ============================================
  console.log('1단계: 토큰 생성 중...');

  const baseMint = generateSigner(umi);

  const [genesisAccount] = findGenesisAccountV2Pda(umi, {
    baseMint: baseMint.publicKey,
    genesisIndex: 0,
  });

  await initializeV2(umi, {
    baseMint,
    fundingMode: 0,
    totalSupplyBaseToken: TOTAL_SUPPLY,
    name: TOKEN_NAME,
    uri: TOKEN_URI,
    symbol: TOKEN_SYMBOL,
  }).sendAndConfirm(umi);

  console.log('✓ 토큰 생성 완료!');
  console.log('  토큰 민트:', baseMint.publicKey);
  console.log('  Genesis 계정:', genesisAccount);

  // ============================================
  // 2단계: Launch Pool 버킷 추가
  // 사용자가 SOL을 예치하는 곳
  // ============================================
  console.log('\n2단계: Launch Pool 버킷 추가 중...');

  const [launchPoolBucket] = findLaunchPoolBucketV2Pda(umi, {
    genesisAccount,
    bucketIndex: 0,
  });

  const [unlockedBucket] = findUnlockedBucketV2Pda(umi, {
    genesisAccount,
    bucketIndex: 0,
  });

  await addLaunchPoolBucketV2(umi, {
    genesisAccount,
    baseMint: baseMint.publicKey,
    baseTokenAllocation: TOTAL_SUPPLY,
    depositStartCondition: {
      __kind: 'TimeAbsolute',
      padding: Array(47).fill(0),
      time: depositStart,
      triggeredTimestamp: null,
    },
    depositEndCondition: {
      __kind: 'TimeAbsolute',
      padding: Array(47).fill(0),
      time: depositEnd,
      triggeredTimestamp: null,
    },
    claimStartCondition: {
      __kind: 'TimeAbsolute',
      padding: Array(47).fill(0),
      time: claimStart,
      triggeredTimestamp: null,
    },
    claimEndCondition: {
      __kind: 'TimeAbsolute',
      padding: Array(47).fill(0),
      time: claimEnd,
      triggeredTimestamp: null,
    },
    minimumDepositAmount: null,
    endBehaviors: [
      {
        __kind: 'SendQuoteTokenPercentage',
        padding: Array(4).fill(0),
        destinationBucket: publicKey(unlockedBucket),
        percentageBps: 10000, // 수집된 SOL의 100%가 잠금 해제 버킷으로
        processed: false,
      },
    ],
  }).sendAndConfirm(umi);

  console.log('✓ Launch Pool 버킷 추가 완료!');
  console.log('  버킷 주소:', launchPoolBucket);

  // ============================================
  // 3단계: 잠금 해제 버킷 추가
  // 수집된 SOL이 팀에게 전송되는 곳
  // ============================================
  console.log('\n3단계: 잠금 해제 버킷 추가 중...');

  await addUnlockedBucketV2(umi, {
    genesisAccount,
    baseMint: baseMint.publicKey,
    baseTokenAllocation: 0n,
    recipient: umi.identity.publicKey,
    claimStartCondition: {
      __kind: 'TimeAbsolute',
      padding: Array(47).fill(0),
      time: claimStart,
      triggeredTimestamp: null,
    },
    claimEndCondition: {
      __kind: 'TimeAbsolute',
      padding: Array(47).fill(0),
      time: claimEnd,
      triggeredTimestamp: null,
    },
    backendSigner: null,
  }).sendAndConfirm(umi);

  console.log('✓ 잠금 해제 버킷 추가 완료!');
  console.log('  버킷 주소:', unlockedBucket);

  // ============================================
  // 4단계: 마무리 - 출시 활성화
  // 이후에는 더 이상 변경할 수 없음
  // ============================================
  console.log('\n4단계: 마무리 중...');

  await finalizeV2(umi, {
    baseMint: baseMint.publicKey,
    genesisAccount,
  }).sendAndConfirm(umi);

  console.log('✓ 출시가 활성화되었습니다!');

  // ============================================
  // 요약: 이 주소들을 저장하세요!
  // ============================================
  console.log('\n========================================');
  console.log('출시 완료 - 이 주소들을 저장하세요:');
  console.log('========================================');
  console.log('토큰 민트:', baseMint.publicKey);
  console.log('Genesis 계정:', genesisAccount);
  console.log('Launch Pool 버킷:', launchPoolBucket);
  console.log('잠금 해제 버킷:', unlockedBucket);
  console.log('');
  console.log('타이밍:');
  console.log('예치 시작:', new Date(Number(depositStart) * 1000).toISOString());
  console.log('예치 종료:', new Date(Number(depositEnd) * 1000).toISOString());
  console.log('청구 시작:', new Date(Number(claimStart) * 1000).toISOString());
  console.log('청구 종료:', new Date(Number(claimEnd) * 1000).toISOString());
}

main().catch(console.error);

스크립트 실행:

npx ts-node launch.ts

출력된 주소를 저장하세요! 다음 단계에서 필요합니다.

다음에 일어나는 일

출시 스크립트를 실행하면 출시가 라이브됩니다. 각 단계에서 일어나는 일은 다음과 같습니다:

예치 기간 동안

사용자는 프론트엔드 또는 SDK를 직접 사용하여 SOL을 예치합니다. 각 예치:

2% 수수료가 적용됩니다
예치 PDA에서 추적됩니다
부분적으로 또는 전체적으로 출금 가능 (2% 수수료 포함)

예치 종료 후

예치 기간이 끝나면 수집된 SOL을 잠금 해제 버킷으로 이동하기 위해 전환을 실행해야 합니다. transition.ts라는 파일을 만듭니다:

import { createUmi } from '@metaplex-foundation/umi-bundle-defaults';
import {
  genesis,
  transitionV2,
  WRAPPED_SOL_MINT,
} from '@metaplex-foundation/genesis';
import { findAssociatedTokenPda } from '@metaplex-foundation/mpl-toolbox';
import { publicKey, keypairIdentity } from '@metaplex-foundation/umi';

async function main() {
  const umi = createUmi('https://api.devnet.solana.com')
    .use(genesis());

  // 지갑 키페어 로드 (출시에 사용한 것과 동일한 지갑)
  const walletFile = '/path/to/your/keypair.json'; // <-- 이 경로 업데이트
  const secretKey = JSON.parse(require('fs').readFileSync(walletFile, 'utf-8'));
  const keypair = umi.eddsa.createKeypairFromSecretKey(new Uint8Array(secretKey));
  umi.use(keypairIdentity(keypair));

  // 출시 스크립트에서 출력된 주소를 입력
  const genesisAccount = publicKey('YOUR_GENESIS_ACCOUNT');
  const baseMint = publicKey('YOUR_TOKEN_MINT');
  const launchPoolBucket = publicKey('YOUR_LAUNCH_POOL_BUCKET');
  const unlockedBucket = publicKey('YOUR_UNLOCKED_BUCKET');

  const unlockedBucketQuoteTokenAccount = findAssociatedTokenPda(umi, {
    owner: unlockedBucket,
    mint: WRAPPED_SOL_MINT,
  });

  console.log('전환 실행 중...');

  await transitionV2(umi, {
    genesisAccount,
    primaryBucket: launchPoolBucket,
    baseMint,
  })
    .addRemainingAccounts([
      {
        pubkey: unlockedBucket,
        isSigner: false,
        isWritable: true,
      },
      {
        pubkey: publicKey(unlockedBucketQuoteTokenAccount),
        isSigner: false,
        isWritable: true,
      },
    ])
    .sendAndConfirm(umi);

  console.log('✓ 전환 완료! SOL이 잠금 해제 버킷으로 이동했습니다.');
}

main().catch(console.error);

예치 기간 종료 후 실행:

npx ts-node transition.ts

사용자가 토큰 청구

전환 후 사용자는 토큰을 청구할 수 있습니다. 각 사용자는 총 예치금에서 자신의 지분 비율에 따라 토큰을 받습니다:

userTokens = (userDeposit / totalDeposits) * totalTokenSupply

사용자는 프론트엔드 또는 이 스크립트를 사용하여 청구할 수 있습니다 (claim.ts 생성):

import { createUmi } from '@metaplex-foundation/umi-bundle-defaults';
import {
  genesis,
  claimLaunchPoolV2,
} from '@metaplex-foundation/genesis';
import { publicKey, keypairIdentity } from '@metaplex-foundation/umi';

async function main() {
  const umi = createUmi('https://api.devnet.solana.com')
    .use(genesis());

  // 사용자의 지갑 키페어 로드 (SOL을 예치한 사람)
  const walletFile = '/path/to/your/keypair.json'; // <-- 이 경로 업데이트
  const secretKey = JSON.parse(require('fs').readFileSync(walletFile, 'utf-8'));
  const keypair = umi.eddsa.createKeypairFromSecretKey(new Uint8Array(secretKey));
  umi.use(keypairIdentity(keypair));

  // 출시에서 가져온 주소 입력
  const genesisAccount = publicKey('YOUR_GENESIS_ACCOUNT');
  const baseMint = publicKey('YOUR_TOKEN_MINT');
  const launchPoolBucket = publicKey('YOUR_LAUNCH_POOL_BUCKET');

  console.log('토큰 청구 중...');

  await claimLaunchPoolV2(umi, {
    genesisAccount,
    bucket: launchPoolBucket,
    baseMint,
    recipient: umi.identity.publicKey,
  }).sendAndConfirm(umi);

  console.log('✓ 토큰 청구 완료!');
}

main().catch(console.error);

마무리: 권한 철회

출시가 완료되면 민트 및 동결 권한을 철회합니다. 이는 보유자에게 추가 토큰을 발행할 수 없음을 알립니다.

이것은 되돌릴 수 없습니다. 한 번 철회하면 추가 토큰을 발행하거나 계정을 동결할 수 없습니다. 출시가 완료되었다고 확신할 때만 이 작업을 수행하세요.

revoke.ts 생성:

import { createUmi } from '@metaplex-foundation/umi-bundle-defaults';
import {
  genesis,
  revokeMintAuthorityV2,
  revokeFreezeAuthorityV2,
} from '@metaplex-foundation/genesis';
import { publicKey, keypairIdentity } from '@metaplex-foundation/umi';

async function main() {
  const umi = createUmi('https://api.devnet.solana.com')
    .use(genesis());

  // 지갑 키페어 로드 (출시에 사용한 것과 동일한 지갑)
  const walletFile = '/path/to/your/keypair.json'; // <-- 이 경로 업데이트
  const secretKey = JSON.parse(require('fs').readFileSync(walletFile, 'utf-8'));
  const keypair = umi.eddsa.createKeypairFromSecretKey(new Uint8Array(secretKey));
  umi.use(keypairIdentity(keypair));

  // 출시에서 가져온 토큰 민트 주소 입력
  const baseMint = publicKey('YOUR_TOKEN_MINT');

  console.log('민트 권한 철회 중...');
  await revokeMintAuthorityV2(umi, {
    baseMint,
  }).sendAndConfirm(umi);
  console.log('✓ 민트 권한 철회 완료');

  console.log('동결 권한 철회 중...');
  await revokeFreezeAuthorityV2(umi, {
    baseMint,
  }).sendAndConfirm(umi);
  console.log('✓ 동결 권한 철회 완료');

  console.log('\n✓ 출시 완료! 토큰이 완전히 탈중앙화되었습니다.');
}

main().catch(console.error);

다음 단계

Genesis 개요 - 솔라나 토큰 런치패드에 대해 더 알아보기
Launch Pool - 상세한 공정한 출시 문서
프리세일 - 고정 가격으로 토큰 프리세일 실행
Aggregation API - API를 통해 출시 및 토큰 세일 데이터 쿼리