시작하기

빌드하기 전에 Genesis 토큰 출시 흐름을 이해하세요. 솔라나에서 프리세일, 공정한 출시, 토큰 세일을 계획하고 있다면, 이 가이드가 SPL 토큰 생성부터 배포까지 각 단계를 설명합니다.

Genesis 흐름

모든 Genesis 출시는 다음 생명주기를 따릅니다:

┌─────────────────────────────────────────────────────────────────┐
│  1. INITIALIZE                                                   │
│     Create Genesis Account → Mint token → Hold supply in escrow │
└─────────────────────────────────────────────────────────────────┘
                                 ↓
┌─────────────────────────────────────────────────────────────────┐
│  2. ADD BUCKETS                                                  │
│     Configure distribution (Launch Pool, Presale, Treasury)     │
└─────────────────────────────────────────────────────────────────┘
                                 ↓
┌─────────────────────────────────────────────────────────────────┐
│  3. FINALIZE                                                     │
│     Lock configuration → Activate time conditions               │
└─────────────────────────────────────────────────────────────────┘
                                 ↓
┌─────────────────────────────────────────────────────────────────┐
│  4. DEPOSIT PERIOD                                               │
│     Users deposit SOL based on bucket type                      │
└─────────────────────────────────────────────────────────────────┘
                                 ↓
┌─────────────────────────────────────────────────────────────────┐
│  5. TRANSITION                                                   │
│     Execute end behaviors → Route funds to treasury             │
└─────────────────────────────────────────────────────────────────┘
                                 ↓
┌─────────────────────────────────────────────────────────────────┐
│  6. CLAIM PERIOD                                                 │
│     Users claim tokens → Team claims raised funds               │
└─────────────────────────────────────────────────────────────────┘
                                 ↓
┌─────────────────────────────────────────────────────────────────┐
│  7. POST-LAUNCH (Optional)                                       │
│     Revoke mint/freeze authorities for security                 │
└─────────────────────────────────────────────────────────────────┘

1단계: 초기화

진행 사항: 토큰을 발행하고 전체 공급량을 에스크로에 보관하는 Genesis Account를 생성합니다.

제공해야 할 것:

• 토큰 메타데이터 (이름, 심볼, URI)
• 총 공급량 (소수점 포함)
• Quote 토큰 (일반적으로 wSOL)

결과: 새로운 SPL 토큰이 생성되어 배포 시까지 Genesis Account가 관리합니다.

토큰 공급량 계획

SPL 토큰은 기본적으로 9자리 소수점을 사용합니다:

중요: 총 공급량은 모든 Bucket 할당량의 합과 같아야 합니다.

2단계: Bucket 추가

진행 사항: Bucket을 추가하여 토큰 배포 방식을 구성합니다.

Bucket 유형

구성 예시

일반적인 출시는 다음을 사용합니다:

1. Inflow Bucket (Launch Pool 또는 Presale) - 참가자로부터 SOL 수집
2. Outflow Bucket (Unlocked) - 팀/재무를 위해 수집된 SOL 수령

Token Allocation Example (1 million tokens):
├── Launch Pool: 800,000 tokens (80%)
└── Unlocked:    200,000 tokens (20% team allocation)

Fund Flow:
Users deposit SOL → Launch Pool → End Behavior → Unlocked Bucket → Team claims

시간 조건

각 Bucket에는 네 가지 시간 조건이 있습니다:

Unix 타임스탬프를 사용합니다 (밀리초가 아닌 초 단위).

3단계: Finalize

진행 사항: 구성이 영구적으로 잠깁니다. 시간 조건에 따라 출시가 활성화됩니다.

Finalize 전후 비교

4단계: 예치 기간

진행 사항: 사용자가 Inflow Bucket에 SOL을 예치합니다.

• Launch Pool: 사용자가 SOL을 예치하고, 2% 수수료로 출금 가능
• Presale: 사용자가 고정 가격으로 SOL을 예치하며, 사용자당 예치 상한(각 사용자가 기여할 수 있는 최대 금액)까지 가능

모든 예치에 2% 프로토콜 수수료가 적용됩니다.

5단계: Transition

진행 사항: 예치가 마감된 후, 종료 동작을 실행하여 자금을 라우팅합니다.

일반적인 종료 동작: 수집된 SOL의 100%를 Unlocked Bucket (재무)으로 전송합니다.

여러 목적지로 자금을 분할할 수 있습니다:

• 80%는 재무로
• 20%는 유동성 풀 Bucket으로

6단계: 청구 기간

진행 사항:

• 사용자가 예치금에 따라 토큰을 청구합니다
• 팀이 Unlocked Bucket에서 모금된 SOL을 청구합니다

토큰 배분

Launch Pool: 사용자 토큰 = (사용자 예치금 / 총 예치금) × Bucket 할당량

Presale: 사용자 토큰 = 사용자 예치금 / 토큰당 가격

7단계: 출시 후 (선택 사항)

진행 사항: 보안을 위해 토큰 권한을 폐기합니다.

• Mint authority - 더 이상 토큰을 발행할 수 없도록 폐기
• Freeze authority - 토큰을 동결할 수 없도록 폐기

이는 보유자와 러그 체커에게 토큰 공급량이 고정되었음을 알려줍니다.

일반적인 오류

계획 체크리스트

빌드를 시작하기 전에:

• [ ] 출시 메커니즘 결정 (공정한 출시/크라우드세일을 위한 Launch Pool, 고정 가격 판매를 위한 Presale)
• [ ] 소수점이 포함된 총 토큰 공급량 계산
• [ ] Bucket 할당 계획 (총 공급량과 합이 일치해야 함)
• [ ] 시간 창 설정 (예치 시작/종료, 청구 시작/종료)
• [ ] 종료 동작 결정 (자금은 어디로 가는가?)
• [ ] 토큰 메타데이터 준비 (이름, 심볼, 이미지 URI)

FAQ

Genesis Account 초기화 시 무엇이 생성되나요?

메타데이터가 포함된 새로운 SPL 토큰, 마스터 조정 계정 (Genesis Account PDA), 그리고 배포를 위해 에스크로에 보관되는 총 공급량이 발행됩니다.

Finalize 후에 Bucket을 더 추가할 수 있나요?

아니요. Finalize는 영구적입니다. Bucket을 더 추가하거나 구성을 변경할 수 없습니다. Finalize 전에 완전한 Bucket 구조를 계획하세요.

Inflow와 Outflow Bucket의 차이점은 무엇인가요?

Inflow Bucket은 사용자로부터 SOL을 수집합니다 (Launch Pool, Presale). Outflow Bucket은 종료 동작을 통해 토큰 또는 SOL을 받습니다—일반적으로 팀/재무 청구를 위한 Unlocked Bucket입니다.

출시는 언제 활성화되나요?

Finalize 후, Bucket 시간 조건에 따라 출시가 활성화됩니다. 현재 시간이 Bucket의 예치 창 내에 있을 때 사용자가 참여할 수 있습니다.

소수점이 있는 토큰 공급량은 어떻게 계산하나요?

원하는 공급량에 10^소수점을 곱합니다. 소수점 9자리의 100만 토큰의 경우: 1,000,000 × 1,000,000,000 = 1,000,000,000,000,000.

SOL 이외의 토큰을 예치에 사용할 수 있나요?

예. quoteMint를 아무 SPL 토큰으로 설정할 수 있습니다. 그러나 SOL 단위 출시에는 wSOL이 표준입니다.

용어집

다음 단계

빌드할 준비가 되셨나요? 토큰 출시 유형을 선택하세요:

1. 토큰 출시하기 - 엔드투엔드 토큰 출시 가이드
2. JavaScript SDK - 설치 및 구성
3. Launch Pool 튜토리얼 - 비례 배분을 통한 공정한 출시
4. Presale 튜토리얼 - 고정 가격 토큰 판매