POST런칭 생성

새로운 Genesis 토큰 런칭을 위한 온체인 트랜잭션을 빌드합니다. 런칭 등록을 호출하기 전에 서명하여 전송해야 하는 미서명 트랜잭션을 반환합니다.

엔드포인트

POST /v1/launches/create

요청 본문

요청 본문은 includeBackendSigner, derivedSignerPublicKey, nonce, buildAllTxs도 허용합니다. 이 필드들은 metaplex.com 자체의 서명 흐름에서 사용되므로, API를 직접 호출할 때는 설정하지 마세요.

런칭 구성

launch 객체는 전체 토큰 및 런칭 설정을 설명합니다:

새 토큰의 경우 할당 공급량의 합계는 supply와 정확히 일치해야 합니다. 기본값 1,000,000,000이 아닌 supply를 사용하는 새 토큰은 계정에 사용자 지정 공급량이 활성화되어 있지 않으면 403을 반환합니다.

런칭 유형

스키마에는 auction과 custom도 정의되어 있습니다. auction은 아직 구현되지 않은 자리 표시자이며, custom은 공개 API에서 400으로 거부됩니다.

할당 유형

allocations 배열의 각 할당에는 type 필드, name, supply, 그리고 같은 유형 이름을 키로 하는 구성 객체가 있습니다:

• launchpoolV2 — 비례 배분 풀
• presaleV2 — 고정가 사전 판매
• bondingCurveV2 — 본딩 커브 판매
• unlockedV2 — 수령인에게 잠금 해제된 토큰
• claimScheduleV2 — 베스팅 일정에 따라 수령인에게 해제되는 토큰 (클리프 선택 사항)

Raydium 유동성은 별도의 할당이 아니라 판매 할당의 펀드 플로우로 구성됩니다. RaydiumLP 플로우는 Raydium CPMM 풀을, RaydiumClmmLP 플로우는 Raydium CLMM(집중 유동성) 포지션을 생성합니다. CLMM 런칭은 계정에서 활성화되어 있지 않으면 403을 반환합니다.

기존 토큰

이미 민팅한 토큰을 런칭하려면 useExistingToken: true를 설정하고 토큰의 mintAddress를 전달합니다. decimals는 온체인 민트와 일치해야 합니다. 새 토큰과 달리 할당은 공급량의 일부만 충당할 수 있습니다. 합계는 0보다 크고 supply 이하여야 하며, 나머지는 생성자의 지갑에 남습니다. 기존 토큰 런칭은 계정에서 활성화되어 있지 않으면 403을 반환하며, bondingCurve 유형에서는 사용할 수 없습니다.

에이전트 런칭

등록된 에이전트를 생성자로 하여 런칭을 만들려면 agent를 전달합니다:

에이전트의 자산 서명자 지갑이 런칭 생성자가 됩니다. 런칭 등록에도 같은 agent.mint를 전달하세요.

요청 예시 — Launch Pool Type

curl -X POST https://api.metaplex.com/v1/launches/create \
  -H "Content-Type: application/json" \
  -d '{
    "wallet": "YourWalletPublicKey...",
    "launch": {
      "name": "My Token",
      "symbol": "MTK",
      "image": "https://gateway.irys.xyz/...",
      "decimals": 6,
      "supply": 1000000000,
      "network": "solana-devnet",
      "quoteMint": "So11111111111111111111111111111111111111112",
      "type": "launchpool",
      "finalize": true,
      "publicKey": "YourWalletPublicKey...",
      "allocations": [...]
    }
  }'

성공 응답

{
  "success": true,
  "transactions": [
    "base64-encoded-transaction-1...",
    "base64-encoded-transaction-2..."
  ],
  "blockhash": {
    "blockhash": "...",
    "lastValidBlockHeight": 123456789
  },
  "mintAddress": "MintPublicKey...",
  "genesisAccount": "GenesisAccountPDA..."
}

오류 응답

{
  "success": false,
  "error": "Validation failed",
  "details": [...]
}

오류 코드

권장: SDK 사용

이 엔드포인트를 직접 호출하는 대신, 트랜잭션 생성, 서명, 전송, 등록의 전체 흐름을 한 번의 호출로 처리하는 createAndRegisterLaunch를 사용하세요:

1import {
2  createAndRegisterLaunch,
3  CreateLaunchInput,
4  genesis,
5} from '@metaplex-foundation/genesis'
6import { createUmi } from '@metaplex-foundation/umi-bundle-defaults'
7import { keypairIdentity } from '@metaplex-foundation/umi'
8
9const umi = createUmi('https://api.mainnet-beta.solana.com')
10  .use(genesis())
11
12// Use keypairIdentity to set a wallet when running server-side:
13// umi.use(keypairIdentity(myKeypair))
14
15const input: CreateLaunchInput = {
16  wallet: umi.identity.publicKey,
17  token: {
18    name: 'My Token',
19    symbol: 'MTK',
20    image: 'https://gateway.irys.xyz/...',
21  },
22  launchType: 'launchpool',
23  launch: {
24    launchpool: {
25      tokenAllocation: 500_000_000,
26      depositStartTime: new Date(Date.now() + 48 * 60 * 60 * 1000),
27      raiseGoal: 250,
28      raydiumLiquidityBps: 5000,
29      fundsRecipient: umi.identity.publicKey,
30    },
31  },
32}
33
34const result = await createAndRegisterLaunch(umi, {}, input)
35console.log(`Launch live at: ${result.launch.link}`)

전체 SDK 문서와 세 가지 통합 모드에 대한 자세한 내용은 API 클라이언트를 참조하세요.