개요

요약

mplx genesis 명령어를 사용하면 터미널에서 전체 Genesis 토큰 출시를 실행할 수 있습니다 — 계정 생성, bucket 구성, 입금, 청구, 권한 폐기를 포함합니다.

• 도구: Metaplex CLI(mplx)의 genesis 명령어 그룹
• Bucket 유형: Launch Pool(비례 배분), Presale(고정 가격), unlocked(재무)
• Quote token(수동 흐름): 기본값은 Wrapped SOL이며, 모든 SPL token mint 주소 지원
• Quote token(API 흐름): 현재 SOL 또는 USDC만 지원
• 되돌릴 수 없는 작업: finalize와 revoke는 취소할 수 없습니다

범위 외

Genesis 스마트 컨트랙트 내부, SDK/TypeScript 통합, 프론트엔드 개발, 토큰 경제 설계, 출시 후 유동성 풀 설정.

바로가기: 사전 요구사항 · 일반 흐름 · 명령어 레퍼런스 · 일반적인 오류 · FAQ · 용어집

Metaplex Foundation 관리 · 최종 검증 2026년 2월 · Metaplex CLI(mplx) 필요

사전 요구사항

• Metaplex CLI가 설치되어 PATH에 등록되어 있어야 합니다
• Solana 키페어 파일 (예: ~/.config/solana/id.json)
• 트랜잭션 수수료를 위한 SOL
• mplx config rpc add로 구성하거나 -r로 전달하는 RPC 엔드포인트

설정을 확인하세요:

mplx genesis --help

일반 흐름

Genesis CLI로 token을 출시하는 방법은 두 가지가 있습니다:

API 흐름 (권장)

genesis launch create를 사용하면 Genesis API를 호출하고, 트랜잭션을 빌드하여 서명하고, Metaplex 플랫폼에 출시를 등록하는 올인원 흐름을 단일 명령어로 실행할 수 있습니다. API를 통해 생성된 출시는 metaplex.com과 호환되며 공개 출시 페이지와 함께 플랫폼에 표시됩니다.

mplx genesis launch create \
  --name "My Token" --symbol "MTK" \
  --image "https://gateway.irys.xyz/abc123" \
  --tokenAllocation 500000000 \
  --depositStartTime 2025-03-01T00:00:00Z \
  --raiseGoal 200 --raydiumLiquidityBps 5000 \
  --fundsRecipient <WALLET_ADDRESS>

자세한 내용은 Launch (API)를 참조하세요.

수동 흐름

모든 단계를 완전히 제어하려면:

1. 생성 — genesis create로 Genesis 계정과 token mint를 설정합니다.
2. Bucket 추가 — 하나 이상의 bucket을 추가하여 token 배포 방식을 정의합니다. 비례 배분에는 bucket add-launch-pool을, 고정 가격 판매에는 bucket add-presale을, 팀/재무 할당에는 bucket add-unlocked를 사용합니다.
3. Finalize — genesis finalize로 구성을 잠급니다. 이 단계 이후에는 더 이상 bucket을 추가할 수 없습니다.
4. 입금 — 사용자가 입금 기간 동안 genesis deposit 또는 genesis presale deposit을 사용하여 bucket에 quote token(예: Wrapped SOL)을 입금합니다.
5. 출금 (선택사항) — 입금 기간 동안 genesis withdraw로 Launch Pool에서 출금할 수 있습니다.
6. 전환 (선택사항) — Launch Pool에 종료 동작이 있는 경우, 입금 마감 후 genesis transition을 호출하여 수집된 token을 대상 bucket으로 전달합니다.
7. 청구 — 청구 기간이 시작된 후, 사용자는 genesis claim 또는 genesis presale claim으로 base token을 청구합니다. 재무 지갑은 genesis claim-unlocked를 사용합니다.
8. 폐기 (선택사항) — genesis revoke로 token의 mint 및/또는 freeze 권한을 영구적으로 폐기합니다.

수동 흐름을 사용했고 공개 출시 페이지를 원하는 경우, genesis launch register를 사용하여 Metaplex 플랫폼에 genesis 계정을 등록하세요.

genesis fetch와 genesis bucket fetch로 언제든지 출시 상태를 확인할 수 있습니다.

명령어 레퍼런스

참고사항

• totalSupply와 allocation은 base unit으로 지정합니다 — 소수점 9자리의 경우, 1000000000000000 = 1,000,000 token
• 입금 및 출금 금액은 quote token의 base unit으로 지정합니다 (SOL의 경우 lamport, 1 SOL = 1,000,000,000 lamport)
• SOL을 quote token으로 사용하는 경우, 먼저 mplx toolbox sol wrap <amount>로 래핑하세요
• Finalize는 되돌릴 수 없습니다 — genesis finalize를 실행하기 전에 모든 bucket 구성을 다시 확인하세요
• 모든 명령어의 전체 플래그 문서는 mplx genesis <command> --help를 실행하세요
• 개념, 생명주기 세부 정보, SDK 가이드는 Genesis 문서를 참조하세요

일반적인 오류

FAQ

mplx genesis 명령어란 무엇인가요? mplx genesis 명령어 그룹을 사용하면 터미널에서 전체 Genesis 토큰 출시를 실행할 수 있습니다 — 계정 생성, bucket 구성, 입금, 청구, 권한 폐기를 포함합니다.

Genesis의 다양한 bucket 유형은 무엇인가요? Genesis에는 세 가지 bucket 유형이 있습니다: Launch Pool(입금에 기반한 비례 배분), Presale(고정 가격 token 판매), unlocked(직접 청구할 수 있는 팀/재무 할당).

입금 전에 SOL을 래핑해야 하나요? 네. SOL을 quote token으로 사용하는 경우, 어떤 bucket에 입금하기 전에 먼저 mplx toolbox sol wrap <amount>로 래핑해야 합니다.

Finalize를 취소할 수 있나요? 아니요. Finalize는 되돌릴 수 없습니다. Finalize 후에는 더 이상 bucket을 추가할 수 없으며 구성이 잠깁니다. genesis finalize를 실행하기 전에 모든 것을 다시 확인하세요.

token 수량은 어떻게 지정하나요? 모든 수량은 base unit으로 지정합니다. 소수점 9자리의 경우, 1,000,000 token = 1000000000000000 base unit입니다. 입금 금액은 quote token의 base unit(SOL의 경우 lamport, 1 SOL = 1,000,000,000 lamport)을 사용합니다.

같은 유형의 bucket을 여러 개 만들 수 있나요? 네. --bucketIndex 플래그를 사용하여 같은 유형의 각 bucket에 다른 인덱스를 지정하세요.

용어집