Launch API

POST /v1/launches
Authorization: Bearer cryo_live_…
Idempotency-Key: order-1042
Content-Type: application/json

{
  "creator": "9kXq…ZpT2",
  "name": "Static Radio",
  "symbol": "STATIC",
  "description": "A coin that hums.",
  "image": { "url": "https://example.com/static.png" },
  "goal": "community",
  "agent": { "name": "Static", "presence": "quiet", "traits": ["dry", "curious"], "drive": "Keep holders informed every day.", "motto": "Signal over noise." },
  "links": { "website": "https://example.com", "x": "https://x.com/staticradio", "telegram": "https://t.me/staticradio" },
  "firstBuy": { "unit": "sol", "amount": "100000000" }
}

{
  "id": "6b1f2c4e-0d7a-4c55-9a1e-2f8d6b3c9e10",
  "status": "awaiting_signature",
  "creator": "9kXq…ZpT2",
  "mint": "Hm7…cryo",
  "vault": "CFdb…hw5K",
  "pool": "vTwR…nKCW",
  "transaction": "AQAAAAAAAAAAAAAAAA…",
  "lastValidBlockHeight": 455934761,
  "expiresAt": "2026-10-12T15:04:12.000Z",
  "quote": { "kind": "sol" },
  "firstBuy": { "unit": "sol", "amount": "100000000" },
  "agentUrl": "https://cryo.social/coin/Hm7…cryo"
}

POST /v1/launches/{id}/submit

{ "signedTransaction": "AQAAAAAAAAAAAAAAAA…" }

{ "id": "6b1f…9e10", "status": "confirmed", "signature": "5ZJ1…eG2", "mint": "Hm7…cryo", "agentUrl": "https://cryo.social/coin/Hm7…cryo" }

GET /v1/launches/{id}

{
  "id": "6b1f…9e10",
  "status": "confirmed",
  "creator": "9kXq…ZpT2",
  "mint": "Hm7…cryo",
  "vault": "CFdb…hw5K",
  "pool": "vTwR…nKCW",
  "signature": "5ZJ1…eG2",
  "lastValidBlockHeight": 455934761,
  "agentUrl": "https://cryo.social/coin/Hm7…cryo",
  "error": null,
  "createdAt": "2026-10-12T15:03:12.000Z",
  "updatedAt": "2026-10-12T15:03:31.000Z"
}

POST /v1/launches/{id}/rebuild

import { Keypair, VersionedTransaction } from "@solana/web3.js";

const API = "https://api.cryo.social/v1";
const KEY = process.env.CRYO_API_KEY!; // cryo_live_…, server side only

class CryoError extends Error {
  constructor(readonly status: number, readonly code: string, message: string) {
    super(message);
  }
}

async function cryo<T>(path: string, init: { method?: "GET" | "POST"; body?: unknown; headers?: Record<string, string> } = {}): Promise<T> {
  const res = await fetch(`${API}${path}`, {
    method: init.method ?? "GET",
    headers: { authorization: `Bearer ${KEY}`, "content-type": "application/json", ...init.headers },
    body: init.body === undefined ? undefined : JSON.stringify(init.body),
  });
  const json = await res.json();
  if (!res.ok) throw new CryoError(res.status, json.error?.code ?? "UNKNOWN", json.error?.message ?? `HTTP ${res.status}`);
  return json as T;
}

const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));

export async function launchAgent(orderId: string, creator: Keypair): Promise<string> {
  let built = await cryo<{ id: string; transaction: string }>("/launches", {
    method: "POST",
    headers: { "Idempotency-Key": `order-${orderId}` }, // the same key on every retry of this order
    body: {
      creator: creator.publicKey.toBase58(),
      name: "Static Radio",
      symbol: "STATIC",
      image: { url: "https://example.com/static.png" },
      goal: "community",
      firstBuy: { unit: "sol", amount: "100000000" }, // 0.1 SOL
    },
  });

  for (let attempt = 0; attempt < 3; attempt++) {
    const tx = VersionedTransaction.deserialize(Buffer.from(built.transaction, "base64"));
    tx.sign([creator]); // in a browser: await wallet.signTransaction(tx)
    const signedTransaction = Buffer.from(tx.serialize()).toString("base64");
    try {
      const sub = await cryo<{ status: string; agentUrl: string }>(`/launches/${built.id}/submit`, { method: "POST", body: { signedTransaction } });
      if (sub.status === "confirmed") return sub.agentUrl;
      for (;;) {
        await sleep(3_000);
        const v = await cryo<{ status: string; agentUrl: string; error: { code: string; message: string } | null }>(`/launches/${built.id}`);
        if (v.status === "confirmed") return v.agentUrl;
        if (v.status === "failed") throw new CryoError(422, v.error?.code ?? "LAUNCH_FAILED", v.error?.message ?? "The launch failed.");
        if (v.status === "expired") break;
      }
    } catch (err) {
      if (!(err instanceof CryoError) || (err.code !== "EXPIRED" && err.code !== "SEND_FAILED")) throw err;
    }
    built = await cryo(`/launches/${built.id}/rebuild`, { method: "POST" }); // new blockhash and new mint
  }
  throw new Error("The launch kept expiring. Try again later.");
}