@metaplex-foundation/genesis 0.20.3 → 0.20.5

package/README.md

@@ -14,3 +14,93 @@ A Umi-compatible JavaScript library for the project.
    import { genesis } from '@metaplex-foundation/genesis';
    umi.use(genesis());
    ```
+
+## API Client
+
+The API client provides three levels of control for creating and registering launches.
+
+### Setup
+
+All examples below assume the following shared setup:
+
+```ts
+import {
+  createAndRegisterLaunch,
+  createLaunch,
+  registerLaunch,
+} from '@metaplex-foundation/genesis';
+
+const config = {}; // uses default API URL; set { baseUrl: '...' } to override
+const input = {
+  wallet: umi.identity.publicKey,
+  launchType: 'project' as const,
+  token: {
+    name: 'My Token',
+    symbol: 'MTK',
+    image: 'https://gateway.irys.xyz/...',
+  },
+  launch: {
+    launchpool: {
+      tokenAllocation: 500_000_000,
+      depositStartTime: new Date('2026-03-01T00:00:00Z'),
+      raiseGoal: 200,
+      raydiumLiquidityBps: 5000,
+      fundsRecipient: 'RecipientWallet...',
+    },
+  },
+};
+```
+
+### Basic — `createAndRegisterLaunch`
+
+The simplest approach. The SDK creates the launch, signs and sends all transactions via Umi, then registers the launch — all in one call.
+
+```ts
+const result = await createAndRegisterLaunch(umi, config, input);
+
+console.log(`Mint: ${result.mintAddress}`);
+console.log(`Launch: ${result.launch.link}`);
+```
+
+### Custom transaction sender — `createAndRegisterLaunch` with `txSender`
+
+If you need control over how transactions are signed and sent (e.g. using a custom wallet adapter), pass a `txSender` callback. The SDK still handles the create and register steps for you.
+
+```ts
+const result = await createAndRegisterLaunch(umi, config, input, {
+  txSender: async (transactions) => {
+    const signatures: Uint8Array[] = [];
+    for (const tx of transactions) {
+      const signed = await myCustomWallet.signTransaction(tx);
+      const sig = await myCustomRpc.sendTransaction(signed);
+      signatures.push(sig);
+    }
+    return signatures;
+  },
+});
+
+console.log(`Launch: ${result.launch.link}`);
+```
+
+### Full control — `createLaunch` + `registerLaunch`
+
+For complete control over the transaction lifecycle, call `createLaunch` and `registerLaunch` separately. You are responsible for signing, sending, and confirming the transactions yourself.
+
+```ts
+// Step 1: Create the launch (returns unsigned transactions)
+const createResult = await createLaunch(umi, config, input);
+
+// Step 2: Sign and send each transaction yourself
+for (const tx of createResult.transactions) {
+  const signed = await umi.identity.signTransaction(tx);
+  await umi.rpc.sendTransaction(signed);
+}
+
+// Step 3: Register the launch after transactions are confirmed on-chain
+const registerResult = await registerLaunch(umi, config, {
+  genesisAccount: createResult.genesisAccount,
+  createLaunchInput: input,
+});
+
+console.log(`Launch: ${registerResult.launch.link}`);
+```

package/dist/src/api/client.d.ts

@@ -0,0 +1,70 @@
+import { Umi } from '@metaplex-foundation/umi';
+import { CreateAndRegisterLaunchResult, CreateLaunchInput, CreateLaunchResponse, GenesisApiConfig, RegisterLaunchInput, RegisterLaunchResponse, SignAndSendOptions } from './types';
+/**
+ * Creates a project launch via the Genesis API.
+ *
+ * Returns deserialized Umi transactions that can be signed and sent
+ * using standard Umi methods before calling {@link registerLaunch}.
+ *
+ * @example
+ * ```ts
+ * const result = await createLaunch({}, umi, {
+ *   wallet: umi.identity.publicKey,
+ *   token: { name: 'My Token', symbol: 'MTK', image: 'https://gateway.irys.xyz/...' },
+ *   launchpool: {
+ *     tokenAllocation: 500_000_000,
+ *     depositStartTime: new Date('2026-03-01T00:00:00Z'),
+ *     raiseGoal: 200,
+ *     raydiumLiquidityBps: 5000,
+ *     fundsRecipient: 'RecipientWallet...',
+ *   },
+ * });
+ *
+ * // Sign and send using Umi directly
+ * for (const tx of result.transactions) {
+ *   const signed = await umi.identity.signTransaction(tx);
+ *   await umi.rpc.sendTransaction(signed);
+ * }
+ * ```
+ */
+export declare function createLaunch(umi: Umi, config: GenesisApiConfig, input: CreateLaunchInput): Promise<CreateLaunchResponse>;
+/**
+ * Registers a launched genesis account.
+ *
+ * Call this after the create transactions have been signed and confirmed
+ * on-chain.
+ *
+ * @example
+ * ```ts
+ * const registered = await registerLaunch(
+ *   {},
+ *   { genesisAccount: createResult.genesisAccount }
+ * );
+ * console.log(`Launch live at: ${registered.launch.link}`);
+ * ```
+ */
+export declare function registerLaunch(_umi: Umi, config: GenesisApiConfig, input: RegisterLaunchInput): Promise<RegisterLaunchResponse>;
+/**
+ * High-level convenience method that orchestrates the full launch flow:
+ *
+ * 1. Creates the launch via the Genesis API (get unsigned transactions)
+ * 2. Signs and sends all transactions to the Solana RPC via Umi
+ * 3. Registers the launch
+ *
+ * @example
+ * ```ts
+ * const result = await createAndRegisterLaunch({}, umi, {
+ *   wallet: umi.identity.publicKey,
+ *   token: { name: 'My Token', symbol: 'MTK', image: 'https://gateway.irys.xyz/...' },
+ *   launchpool: {
+ *     tokenAllocation: 500_000_000,
+ *     depositStartTime: new Date('2026-03-01T00:00:00Z'),
+ *     raiseGoal: 200,
+ *     raydiumLiquidityBps: 5000,
+ *     fundsRecipient: 'RecipientWallet...',
+ *   },
+ * });
+ * console.log(`Launch live at: ${result.launch.link}`);
+ * ```
+ */
+export declare function createAndRegisterLaunch(umi: Umi, config: GenesisApiConfig, input: CreateLaunchInput, signAndSendOptions?: SignAndSendOptions): Promise<CreateAndRegisterLaunchResult>;

package/dist/src/api/client.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAndRegisterLaunch = exports.registerLaunch = exports.createLaunch = void 0;
+const serializers_1 = require("@metaplex-foundation/umi/serializers");
+const payloadBuilder_1 = require("./payloadBuilder");
+const transactionHelper_1 = require("./transactionHelper");
+const errors_1 = require("./errors");
+const DEFAULT_BASE_URL = 'https://api.metaplex.com';
+function resolveBaseUrl(config) {
+    return config.baseUrl ?? DEFAULT_BASE_URL;
+}
+function toKeyString(key) {
+    return typeof key === 'string' ? key : key.toString();
+}
+/**
+ * Creates a project launch via the Genesis API.
+ *
+ * Returns deserialized Umi transactions that can be signed and sent
+ * using standard Umi methods before calling {@link registerLaunch}.
+ *
+ * @example
+ * ```ts
+ * const result = await createLaunch({}, umi, {
+ *   wallet: umi.identity.publicKey,
+ *   token: { name: 'My Token', symbol: 'MTK', image: 'https://gateway.irys.xyz/...' },
+ *   launchpool: {
+ *     tokenAllocation: 500_000_000,
+ *     depositStartTime: new Date('2026-03-01T00:00:00Z'),
+ *     raiseGoal: 200,
+ *     raydiumLiquidityBps: 5000,
+ *     fundsRecipient: 'RecipientWallet...',
+ *   },
+ * });
+ *
+ * // Sign and send using Umi directly
+ * for (const tx of result.transactions) {
+ *   const signed = await umi.identity.signTransaction(tx);
+ *   await umi.rpc.sendTransaction(signed);
+ * }
+ * ```
+ */
+async function createLaunch(umi, config, input) {
+    const payload = (0, payloadBuilder_1.buildCreateLaunchPayload)(input);
+    const fetchFn = config.fetch ?? globalThis.fetch;
+    const baseUrl = resolveBaseUrl(config);
+    let response;
+    try {
+        response = await fetchFn(`${baseUrl}/v1/launches/create`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(payload),
+        });
+    }
+    catch (err) {
+        throw (0, errors_1.genesisApiNetworkError)(`Network error calling createLaunch: ${err.message}`, err);
+    }
+    let body;
+    try {
+        body = await response.json();
+    }
+    catch (parseError) {
+        const rawText = await response.text().catch(() => '<unable to read body>');
+        throw (0, errors_1.genesisApiError)(`Failed to parse createLaunch response as JSON: ${parseError.message} — raw body: ${rawText}`, response.status, { rawText });
+    }
+    if (!response.ok || !body.success) {
+        throw (0, errors_1.genesisApiError)(body.error ?? `API returned status ${response.status}`, response.status, body);
+    }
+    const transactions = body.transactions.map((txBase64) => {
+        const txBytes = serializers_1.base64.serialize(txBase64);
+        return umi.transactions.deserialize(txBytes);
+    });
+    return {
+        transactions,
+        blockhash: body.blockhash,
+        mintAddress: typeof body.mintAddress === 'string'
+            ? body.mintAddress
+            : body.mintAddress.toString(),
+        genesisAccount: typeof body.genesisAccount === 'string'
+            ? body.genesisAccount
+            : body.genesisAccount.toString(),
+    };
+}
+exports.createLaunch = createLaunch;
+/**
+ * Registers a launched genesis account.
+ *
+ * Call this after the create transactions have been signed and confirmed
+ * on-chain.
+ *
+ * @example
+ * ```ts
+ * const registered = await registerLaunch(
+ *   {},
+ *   { genesisAccount: createResult.genesisAccount }
+ * );
+ * console.log(`Launch live at: ${registered.launch.link}`);
+ * ```
+ */
+async function registerLaunch(_umi, config, input) {
+    const fetchFn = config.fetch ?? globalThis.fetch;
+    const baseUrl = resolveBaseUrl(config);
+    const payload = (0, payloadBuilder_1.buildCreateLaunchPayload)(input.createLaunchInput);
+    const requestBody = {
+        genesisAccount: toKeyString(input.genesisAccount),
+        network: input.createLaunchInput.network ?? 'solana-mainnet',
+        ...payload,
+    };
+    let response;
+    try {
+        response = await fetchFn(`${baseUrl}/v1/launches/register`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(requestBody),
+        });
+    }
+    catch (err) {
+        throw (0, errors_1.genesisApiNetworkError)(`Network error calling registerLaunch: ${err.message}`, err);
+    }
+    let body;
+    try {
+        body = await response.json();
+    }
+    catch (parseError) {
+        const rawText = await response.text().catch(() => '<unable to read body>');
+        throw (0, errors_1.genesisApiError)(`Failed to parse registerLaunch response as JSON: ${parseError.message} — raw body: ${rawText}`, response.status, { rawText });
+    }
+    if (!response.ok || !body.success) {
+        throw (0, errors_1.genesisApiError)(body.error ?? `API returned status ${response.status}`, response.status, body);
+    }
+    return {
+        existing: body.existing,
+        launch: body.launch,
+        token: body.token,
+    };
+}
+exports.registerLaunch = registerLaunch;
+/**
+ * High-level convenience method that orchestrates the full launch flow:
+ *
+ * 1. Creates the launch via the Genesis API (get unsigned transactions)
+ * 2. Signs and sends all transactions to the Solana RPC via Umi
+ * 3. Registers the launch
+ *
+ * @example
+ * ```ts
+ * const result = await createAndRegisterLaunch({}, umi, {
+ *   wallet: umi.identity.publicKey,
+ *   token: { name: 'My Token', symbol: 'MTK', image: 'https://gateway.irys.xyz/...' },
+ *   launchpool: {
+ *     tokenAllocation: 500_000_000,
+ *     depositStartTime: new Date('2026-03-01T00:00:00Z'),
+ *     raiseGoal: 200,
+ *     raydiumLiquidityBps: 5000,
+ *     fundsRecipient: 'RecipientWallet...',
+ *   },
+ * });
+ * console.log(`Launch live at: ${result.launch.link}`);
+ * ```
+ */
+async function createAndRegisterLaunch(umi, config, input, signAndSendOptions) {
+    const createResult = await createLaunch(umi, config, input);
+    let signatures = [];
+    if (signAndSendOptions?.txSender) {
+        signatures = await signAndSendOptions.txSender(createResult.transactions);
+    }
+    else {
+        signatures = await (0, transactionHelper_1.signAndSendLaunchTransactions)(umi, createResult, {
+            commitment: signAndSendOptions?.commitment ?? 'confirmed',
+            preflightCommitment: signAndSendOptions?.preflightCommitment ?? 'confirmed',
+            skipPreflight: signAndSendOptions?.skipPreflight ?? false,
+        });
+    }
+    const registerResult = await registerLaunch(umi, config, {
+        genesisAccount: createResult.genesisAccount,
+        createLaunchInput: input,
+    });
+    return {
+        signatures,
+        mintAddress: createResult.mintAddress,
+        genesisAccount: createResult.genesisAccount,
+        launch: registerResult.launch,
+        token: registerResult.token,
+    };
+}
+exports.createAndRegisterLaunch = createAndRegisterLaunch;
+//# sourceMappingURL=client.js.map

package/dist/src/api/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/api/client.ts"],"names":[],"mappings":"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"}

package/dist/src/api/errors.d.ts

@@ -0,0 +1,19 @@
+export interface GenesisApiError extends Error {
+    readonly name: 'GenesisApiError';
+    readonly statusCode: number;
+    readonly responseBody: unknown;
+}
+export declare function genesisApiError(message: string, statusCode: number, responseBody: unknown): GenesisApiError;
+export declare function isGenesisApiError(err: unknown): err is GenesisApiError;
+export interface GenesisApiNetworkError extends Error {
+    readonly name: 'GenesisApiNetworkError';
+    readonly cause: Error;
+}
+export declare function genesisApiNetworkError(message: string, cause: Error): GenesisApiNetworkError;
+export declare function isGenesisApiNetworkError(err: unknown): err is GenesisApiNetworkError;
+export interface GenesisValidationError extends Error {
+    readonly name: 'GenesisValidationError';
+    readonly field: string;
+}
+export declare function genesisValidationError(message: string, field: string): GenesisValidationError;
+export declare function isGenesisValidationError(err: unknown): err is GenesisValidationError;

package/dist/src/api/errors.js

@@ -0,0 +1,39 @@
+"use strict";
+// ─── API Error ───────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isGenesisValidationError = exports.genesisValidationError = exports.isGenesisApiNetworkError = exports.genesisApiNetworkError = exports.isGenesisApiError = exports.genesisApiError = void 0;
+function genesisApiError(message, statusCode, responseBody) {
+    const error = new Error(message);
+    error.name = 'GenesisApiError';
+    error.statusCode = statusCode;
+    error.responseBody = responseBody;
+    return error;
+}
+exports.genesisApiError = genesisApiError;
+function isGenesisApiError(err) {
+    return err instanceof Error && err.name === 'GenesisApiError';
+}
+exports.isGenesisApiError = isGenesisApiError;
+function genesisApiNetworkError(message, cause) {
+    const error = new Error(message);
+    error.name = 'GenesisApiNetworkError';
+    error.cause = cause;
+    return error;
+}
+exports.genesisApiNetworkError = genesisApiNetworkError;
+function isGenesisApiNetworkError(err) {
+    return err instanceof Error && err.name === 'GenesisApiNetworkError';
+}
+exports.isGenesisApiNetworkError = isGenesisApiNetworkError;
+function genesisValidationError(message, field) {
+    const error = new Error(message);
+    error.name = 'GenesisValidationError';
+    error.field = field;
+    return error;
+}
+exports.genesisValidationError = genesisValidationError;
+function isGenesisValidationError(err) {
+    return err instanceof Error && err.name === 'GenesisValidationError';
+}
+exports.isGenesisValidationError = isGenesisValidationError;
+//# sourceMappingURL=errors.js.map

package/dist/src/api/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/api/errors.ts"],"names":[],"mappings":";AAAA,gFAAgF;;;AAQhF,SAAgB,eAAe,CAC7B,OAAe,EACf,UAAkB,EAClB,YAAqB;IAErB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAAoB,CAAC;IACnD,KAA0B,CAAC,IAAI,GAAG,iBAAiB,CAAC;IACpD,KAAgC,CAAC,UAAU,GAAG,UAAU,CAAC;IACzD,KAAmC,CAAC,YAAY,GAAG,YAAY,CAAC;IACjE,OAAO,KAAK,CAAC;AACf,CAAC;AAVD,0CAUC;AAED,SAAgB,iBAAiB,CAAC,GAAY;IAC5C,OAAO,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,iBAAiB,CAAC;AAChE,CAAC;AAFD,8CAEC;AASD,SAAgB,sBAAsB,CACpC,OAAe,EACf,KAAY;IAEZ,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAA2B,CAAC;IAC1D,KAA0B,CAAC,IAAI,GAAG,wBAAwB,CAAC;IAC3D,KAA0B,CAAC,KAAK,GAAG,KAAK,CAAC;IAC1C,OAAO,KAAK,CAAC;AACf,CAAC;AARD,wDAQC;AAED,SAAgB,wBAAwB,CACtC,GAAY;IAEZ,OAAO,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,wBAAwB,CAAC;AACvE,CAAC;AAJD,4DAIC;AASD,SAAgB,sBAAsB,CACpC,OAAe,EACf,KAAa;IAEb,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAA2B,CAAC;IAC1D,KAA0B,CAAC,IAAI,GAAG,wBAAwB,CAAC;IAC3D,KAA2B,CAAC,KAAK,GAAG,KAAK,CAAC;IAC3C,OAAO,KAAK,CAAC;AACf,CAAC;AARD,wDAQC;AAED,SAAgB,wBAAwB,CACtC,GAAY;IAEZ,OAAO,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,wBAAwB,CAAC;AACvE,CAAC;AAJD,4DAIC"}

package/dist/src/api/index.d.ts

@@ -0,0 +1,6 @@
+export { createLaunch, registerLaunch, createAndRegisterLaunch, } from './client';
+export { buildCreateLaunchPayload } from './payloadBuilder';
+export { signAndSendLaunchTransactions } from './transactionHelper';
+export type { GenesisApiError, GenesisApiNetworkError, GenesisValidationError, } from './errors';
+export { genesisApiError, genesisApiNetworkError, genesisValidationError, isGenesisApiError, isGenesisApiNetworkError, isGenesisValidationError, } from './errors';
+export type { GenesisApiConfig, CreateLaunchInput, CreateLaunchResponse, RegisterLaunchInput, RegisterLaunchResponse, CreateAndRegisterLaunchResult, SignAndSendOptions, SvmNetwork, TokenMetadata, LaunchpoolConfig, LockedAllocation, ExternalLinks, TimeUnit, QuoteMintInput, } from './types';

package/dist/src/api/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isGenesisValidationError = exports.isGenesisApiNetworkError = exports.isGenesisApiError = exports.genesisValidationError = exports.genesisApiNetworkError = exports.genesisApiError = exports.signAndSendLaunchTransactions = exports.buildCreateLaunchPayload = exports.createAndRegisterLaunch = exports.registerLaunch = exports.createLaunch = void 0;
+// Client functions
+var client_1 = require("./client");
+Object.defineProperty(exports, "createLaunch", { enumerable: true, get: function () { return client_1.createLaunch; } });
+Object.defineProperty(exports, "registerLaunch", { enumerable: true, get: function () { return client_1.registerLaunch; } });
+Object.defineProperty(exports, "createAndRegisterLaunch", { enumerable: true, get: function () { return client_1.createAndRegisterLaunch; } });
+// Payload builder (exported for testing and advanced use)
+var payloadBuilder_1 = require("./payloadBuilder");
+Object.defineProperty(exports, "buildCreateLaunchPayload", { enumerable: true, get: function () { return payloadBuilder_1.buildCreateLaunchPayload; } });
+// Transaction helper
+var transactionHelper_1 = require("./transactionHelper");
+Object.defineProperty(exports, "signAndSendLaunchTransactions", { enumerable: true, get: function () { return transactionHelper_1.signAndSendLaunchTransactions; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "genesisApiError", { enumerable: true, get: function () { return errors_1.genesisApiError; } });
+Object.defineProperty(exports, "genesisApiNetworkError", { enumerable: true, get: function () { return errors_1.genesisApiNetworkError; } });
+Object.defineProperty(exports, "genesisValidationError", { enumerable: true, get: function () { return errors_1.genesisValidationError; } });
+Object.defineProperty(exports, "isGenesisApiError", { enumerable: true, get: function () { return errors_1.isGenesisApiError; } });
+Object.defineProperty(exports, "isGenesisApiNetworkError", { enumerable: true, get: function () { return errors_1.isGenesisApiNetworkError; } });
+Object.defineProperty(exports, "isGenesisValidationError", { enumerable: true, get: function () { return errors_1.isGenesisValidationError; } });
+//# sourceMappingURL=index.js.map

package/dist/src/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/index.ts"],"names":[],"mappings":";;;AAAA,mBAAmB;AACnB,mCAIkB;AAHhB,sGAAA,YAAY,OAAA;AACZ,wGAAA,cAAc,OAAA;AACd,iHAAA,uBAAuB,OAAA;AAGzB,0DAA0D;AAC1D,mDAA4D;AAAnD,0HAAA,wBAAwB,OAAA;AAEjC,qBAAqB;AACrB,yDAAoE;AAA3D,kIAAA,6BAA6B,OAAA;AAQtC,mCAOkB;AANhB,yGAAA,eAAe,OAAA;AACf,gHAAA,sBAAsB,OAAA;AACtB,gHAAA,sBAAsB,OAAA;AACtB,2GAAA,iBAAiB,OAAA;AACjB,kHAAA,wBAAwB,OAAA;AACxB,kHAAA,wBAAwB,OAAA"}

package/dist/src/api/payloadBuilder.d.ts

@@ -0,0 +1,19 @@
+import { CreateLaunchInput } from './types';
+/**
+ * Builds the API payload for `/v1/launches/create` from simplified input.
+ */
+export declare function buildCreateLaunchPayload(input: CreateLaunchInput): {
+    wallet: string;
+    launch: {
+        allocations: unknown[];
+        quoteMint?: string | undefined;
+        network?: "solana-devnet" | undefined;
+        publicKey: string;
+        externalLinks?: import("./types").ExternalLinks | undefined;
+        description?: string | undefined;
+        type: "project";
+        name: string;
+        symbol: string;
+        image: string;
+    };
+};

package/dist/src/api/payloadBuilder.js

@@ -0,0 +1,241 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCreateLaunchPayload = void 0;
+const errors_1 = require("./errors");
+// ─── Constants ──────────────────────────────────────────────────────────────
+const PROJECT_TOTAL_SUPPLY = 1000000000;
+const DEPOSIT_DURATION_MS = 48 * 60 * 60 * 1000; // 48 hours
+const MAX_VALID_JS_DATE_ISO = '9999-12-31T23:59:59.999Z';
+const TOTAL_BPS = 10000;
+const RAYDIUM_MIN_BPS = 2000;
+const DEFAULT_UNLOCKED_BUCKET_NAME = 'Creator Allocation';
+// ─── Quote Mint Resolution ──────────────────────────────────────────────────
+const USDC_MINTS = {
+    'solana-mainnet': 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
+    'solana-devnet': '4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU',
+};
+function resolveQuoteMint(input, network) {
+    if (!input || input === 'SOL')
+        return undefined;
+    if (input === 'USDC')
+        return USDC_MINTS[network];
+    throw (0, errors_1.genesisValidationError)(`Unsupported quote mint: '${input}'. Must be 'SOL' or 'USDC'.`, 'quoteMint');
+}
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function toIsoString(time) {
+    if (typeof time === 'string') {
+        const d = new Date(time);
+        if (Number.isNaN(d.getTime())) {
+            throw (0, errors_1.genesisValidationError)(`Invalid date string: ${time}`, 'time');
+        }
+        return d.toISOString();
+    }
+    if (Number.isNaN(time.getTime())) {
+        throw (0, errors_1.genesisValidationError)(`Invalid date: ${time}`, 'time');
+    }
+    return time.toISOString();
+}
+function toMs(time) {
+    const d = typeof time === 'string' ? new Date(time) : time;
+    return d.getTime();
+}
+function toKeyString(key) {
+    return typeof key === 'string' ? key : key.toString();
+}
+function timeAbsolute(time) {
+    return { type: 'TimeAbsolute', timestamp: toIsoString(time) };
+}
+// ─── Validation ─────────────────────────────────────────────────────────────
+function validateInput(input) {
+    const { token, launch, launchType } = input;
+    if (!token.name || token.name.length < 1 || token.name.length > 32) {
+        throw (0, errors_1.genesisValidationError)('Token name must be between 1 and 32 characters', 'token.name');
+    }
+    if (!token.symbol || token.symbol.length < 1 || token.symbol.length > 10) {
+        throw (0, errors_1.genesisValidationError)('Token symbol must be between 1 and 10 characters', 'token.symbol');
+    }
+    try {
+        const url = new URL(token.image);
+        if (url.protocol !== 'https:' && url.protocol !== 'http:') {
+            throw new Error();
+        }
+    }
+    catch {
+        throw (0, errors_1.genesisValidationError)('Token image must be a valid URL', 'token.image');
+    }
+    if (token.description && token.description.length > 250) {
+        throw (0, errors_1.genesisValidationError)('Token description must be at most 250 characters', 'token.description');
+    }
+    if (launchType !== 'project') {
+        throw (0, errors_1.genesisValidationError)('Invalid launch type', 'launchType');
+    }
+    const { launchpool, lockedAllocations } = launch;
+    if (launchpool.tokenAllocation <= 0) {
+        throw (0, errors_1.genesisValidationError)('Launchpool token allocation must be greater than 0', 'launchpool.tokenAllocation');
+    }
+    if (launchpool.raiseGoal <= 0) {
+        throw (0, errors_1.genesisValidationError)('Raise goal must be greater than 0', 'launchpool.raiseGoal');
+    }
+    if (launchpool.raydiumLiquidityBps < RAYDIUM_MIN_BPS ||
+        launchpool.raydiumLiquidityBps > TOTAL_BPS) {
+        throw (0, errors_1.genesisValidationError)(`Raydium liquidity must be between ${RAYDIUM_MIN_BPS} and ${TOTAL_BPS} basis points`, 'launchpool.raydiumLiquidityBps');
+    }
+    let totalAllocated = launchpool.tokenAllocation;
+    if (lockedAllocations) {
+        for (const alloc of lockedAllocations) {
+            if (alloc.tokenAmount <= 0) {
+                throw (0, errors_1.genesisValidationError)('Locked allocation token amount must be > 0', 'lockedAllocations.tokenAmount');
+            }
+            totalAllocated += alloc.tokenAmount;
+        }
+    }
+    if (totalAllocated > PROJECT_TOTAL_SUPPLY) {
+        throw (0, errors_1.genesisValidationError)(`Total allocated tokens (${totalAllocated}) exceeds total supply (${PROJECT_TOTAL_SUPPLY})`, 'allocations');
+    }
+}
+// ─── Payload Builder ────────────────────────────────────────────────────────
+/**
+ * Builds the API payload for `/v1/launches/create` from simplified input.
+ */
+function buildCreateLaunchPayload(input) {
+    validateInput(input);
+    const { launchType, launch } = input;
+    const { launchpool, lockedAllocations } = launch;
+    const network = input.network ?? 'solana-mainnet';
+    const quoteMint = resolveQuoteMint(input.quoteMint, network);
+    const walletStr = toKeyString(input.wallet);
+    // ── Launchpool timing ─────────────────────────────────────────────────
+    const depositStartMs = toMs(launch.launchpool.depositStartTime);
+    const depositEndMs = depositStartMs + DEPOSIT_DURATION_MS;
+    const depositStartCondition = timeAbsolute(new Date(depositStartMs));
+    const depositEndCondition = timeAbsolute(new Date(depositEndMs));
+    const claimEndCondition = timeAbsolute(MAX_VALID_JS_DATE_ISO);
+    // Claim start is relative to Raydium graduation (not an absolute time).
+    // The server resolves the bucket PDA address at transaction build time.
+    const claimStartCondition = {
+        type: 'TimeRelativeToUnknownAddress',
+        bucketType: 'raydiumV2',
+        bucketIndex: 0,
+        bucketTime: 'Graduate',
+        timeOffset: 0,
+    };
+    // ── Fund flows ────────────────────────────────────────────────────────
+    const raydiumBps = launchpool.raydiumLiquidityBps;
+    const unlockedBps = TOTAL_BPS - raydiumBps;
+    const raydiumLpSupply = (launchpool.tokenAllocation * raydiumBps) / TOTAL_BPS;
+    const fundFlows = [
+        {
+            type: 'MinimumQuoteTokenThreshold',
+            recipient: walletStr,
+            claimStartCondition: depositEndCondition,
+            claimEndCondition,
+        },
+        {
+            type: 'UnlockedFunds',
+            percentageBps: unlockedBps,
+            recipient: toKeyString(launchpool.fundsRecipient),
+            claimStartCondition,
+            claimEndCondition,
+        },
+        {
+            type: 'RaydiumLP',
+            percentageBps: raydiumBps,
+            supply: raydiumLpSupply,
+            startCondition: depositEndCondition,
+            lpLockSchedule: {
+                startCondition: depositEndCondition,
+                cliffCondition: depositEndCondition,
+            },
+        },
+    ];
+    // ── Allocations ───────────────────────────────────────────────────────
+    const allocations = [];
+    // Launchpool (always first)
+    allocations.push({
+        type: 'launchpoolV2',
+        name: 'Launchpool',
+        supply: launchpool.tokenAllocation,
+        launchpoolV2: {
+            depositStartCondition,
+            depositEndCondition,
+            claimStartCondition,
+            claimEndCondition,
+            minimumQuoteTokenThreshold: launchpool.raiseGoal,
+            depositBonus: {},
+            withdrawPenalty: {},
+            fundFlows,
+        },
+    });
+    // Locked/vesting allocations (Streamflow)
+    if (lockedAllocations) {
+        for (const alloc of lockedAllocations) {
+            allocations.push({
+                type: 'lockedV2',
+                name: alloc.name,
+                supply: alloc.tokenAmount,
+                lockedV2: {
+                    type: 'streamflow',
+                    vesting: {
+                        recipient: toKeyString(alloc.recipient),
+                        startTime: toIsoString(alloc.vestingStartTime),
+                        durationValue: alloc.vestingDuration.value,
+                        durationUnit: alloc.vestingDuration.unit,
+                        unlockSchedule: alloc.unlockSchedule,
+                        cliff: alloc.cliff
+                            ? {
+                                enabled: true,
+                                durationValue: alloc.cliff.duration.value,
+                                durationUnit: alloc.cliff.duration.unit,
+                                ...(alloc.cliff.unlockAmount !== undefined
+                                    ? { unlockAmount: alloc.cliff.unlockAmount }
+                                    : {}),
+                            }
+                            : { enabled: false },
+                    },
+                },
+            });
+        }
+    }
+    // Unlocked allocation for remaining supply
+    let totalAllocated = launchpool.tokenAllocation + raydiumLpSupply;
+    if (lockedAllocations) {
+        for (const alloc of lockedAllocations) {
+            totalAllocated += alloc.tokenAmount;
+        }
+    }
+    const remainingSupply = PROJECT_TOTAL_SUPPLY - totalAllocated;
+    if (remainingSupply > 0) {
+        allocations.push({
+            type: 'unlockedV2',
+            name: DEFAULT_UNLOCKED_BUCKET_NAME,
+            supply: remainingSupply,
+            unlockedV2: {
+                recipient: walletStr,
+                claimStartCondition,
+                claimEndCondition,
+            },
+        });
+    }
+    // ── Assemble payload ──────────────────────────────────────────────────
+    return {
+        wallet: walletStr,
+        launch: {
+            type: launchType,
+            name: input.token.name,
+            symbol: input.token.symbol,
+            image: input.token.image,
+            ...(input.token.description
+                ? { description: input.token.description }
+                : {}),
+            ...(input.token.externalLinks
+                ? { externalLinks: input.token.externalLinks }
+                : {}),
+            publicKey: walletStr,
+            ...(network !== 'solana-mainnet' ? { network } : {}),
+            ...(quoteMint ? { quoteMint } : {}),
+            allocations,
+        },
+    };
+}
+exports.buildCreateLaunchPayload = buildCreateLaunchPayload;
+//# sourceMappingURL=payloadBuilder.js.map

package/dist/src/api/payloadBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payloadBuilder.js","sourceRoot":"","sources":["../../../src/api/payloadBuilder.ts"],"names":[],"mappings":"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"}

package/dist/src/api/transactionHelper.d.ts

@@ -0,0 +1,20 @@
+import { Umi } from '@metaplex-foundation/umi';
+import { CreateLaunchResponse, SignAndSendOptions } from './types';
+/**
+ * Signs and sends the transactions returned by {@link createLaunch}.
+ *
+ * Transactions are sent **sequentially** and each is confirmed before
+ * sending the next.
+ *
+ * @param umi - Umi instance configured with the signer identity and RPC
+ * @param createResponse - The response from {@link createLaunch}
+ * @param options - Optional confirmation settings
+ * @returns Array of transaction signatures in the same order as the input transactions
+ *
+ * @example
+ * ```ts
+ * const createResult = await createLaunch(config, umi, input);
+ * const signatures = await signAndSendLaunchTransactions(umi, createResult);
+ * ```
+ */
+export declare function signAndSendLaunchTransactions(umi: Umi, createResponse: CreateLaunchResponse, options?: SignAndSendOptions): Promise<Uint8Array[]>;

package/dist/src/api/transactionHelper.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.signAndSendLaunchTransactions = void 0;
+/**
+ * Signs and sends the transactions returned by {@link createLaunch}.
+ *
+ * Transactions are sent **sequentially** and each is confirmed before
+ * sending the next.
+ *
+ * @param umi - Umi instance configured with the signer identity and RPC
+ * @param createResponse - The response from {@link createLaunch}
+ * @param options - Optional confirmation settings
+ * @returns Array of transaction signatures in the same order as the input transactions
+ *
+ * @example
+ * ```ts
+ * const createResult = await createLaunch(config, umi, input);
+ * const signatures = await signAndSendLaunchTransactions(umi, createResult);
+ * ```
+ */
+async function signAndSendLaunchTransactions(umi, createResponse, options) {
+    const commitment = options?.commitment ?? 'confirmed';
+    const preflightCommitment = options?.preflightCommitment ?? 'confirmed';
+    const skipPreflight = options?.skipPreflight ?? false;
+    const signatures = [];
+    for (const transaction of createResponse.transactions) {
+        const signedTransaction = await umi.identity.signTransaction(transaction);
+        const signature = await umi.rpc.sendTransaction(signedTransaction, {
+            skipPreflight,
+            commitment,
+            preflightCommitment,
+        });
+        await umi.rpc.confirmTransaction(signature, {
+            strategy: {
+                type: 'blockhash',
+                ...createResponse.blockhash,
+            },
+            commitment,
+        });
+        signatures.push(signature);
+    }
+    return signatures;
+}
+exports.signAndSendLaunchTransactions = signAndSendLaunchTransactions;
+//# sourceMappingURL=transactionHelper.js.map

package/dist/src/api/transactionHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactionHelper.js","sourceRoot":"","sources":["../../../src/api/transactionHelper.ts"],"names":[],"mappings":";;;AAKA;;;;;;;;;;;;;;;;GAgBG;AACI,KAAK,UAAU,6BAA6B,CACjD,GAAQ,EACR,cAAoC,EACpC,OAA4B;IAE5B,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,WAAW,CAAC;IACtD,MAAM,mBAAmB,GAAG,OAAO,EAAE,mBAAmB,IAAI,WAAW,CAAC;IACxE,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,KAAK,CAAC;IACtD,MAAM,UAAU,GAAiB,EAAE,CAAC;IAEpC,KAAK,MAAM,WAAW,IAAI,cAAc,CAAC,YAAY,EAAE;QACrD,MAAM,iBAAiB,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QAE1E,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,iBAAiB,EAAE;YACjE,aAAa;YACb,UAAU;YACV,mBAAmB;SACpB,CAAC,CAAC;QACH,MAAM,GAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,SAAS,EAAE;YAC1C,QAAQ,EAAE;gBACR,IAAI,EAAE,WAAW;gBACjB,GAAG,cAAc,CAAC,SAAS;aAC5B;YACD,UAAU;SACX,CAAC,CAAC;QAEH,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;KAC5B;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AA9BD,sEA8BC"}

package/dist/src/api/types.d.ts

@@ -0,0 +1,166 @@
+import { BlockhashWithExpiryBlockHeight, PublicKey, RpcSendTransactionOptions, Transaction } from '@metaplex-foundation/umi';
+export type SvmNetwork = 'solana-mainnet' | 'solana-devnet';
+export type TimeUnit = 'SECOND' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' | 'TWO_WEEKS' | 'MONTH' | 'QUARTER' | 'YEAR';
+/**
+ * Quote mint can be a friendly name ('SOL', 'USDC') or a raw mint address.
+ * The SDK resolves friendly names to the correct mint address per network.
+ */
+export type QuoteMintInput = 'SOL' | 'USDC' | (string & {});
+export type LaunchType = 'project';
+export interface ExternalLinks {
+    /** Website URL */
+    website?: string;
+    /** Twitter/X handle (e.g. '@mytoken') or full URL */
+    twitter?: string;
+    /** Telegram handle (e.g. '@mytoken') or full URL */
+    telegram?: string;
+}
+export interface TokenMetadata {
+    /** Token name, 1-32 characters */
+    name: string;
+    /** Token ticker symbol, 1-10 characters */
+    symbol: string;
+    /** Token image URL hosted on Irys (must start with https://gateway.irys.xyz/) */
+    image: string;
+    /** Optional description, max 250 characters */
+    description?: string;
+    /** Optional social and web links */
+    externalLinks?: ExternalLinks;
+}
+export interface LaunchpoolConfig {
+    /**
+     * Number of tokens to sell via the launchpool.
+     * Must be a portion of the 1 billion total supply (e.g., 500_000_000).
+     */
+    tokenAllocation: number;
+    /**
+     * When the deposit period opens.
+     * The deposit period lasts exactly 48 hours from this time.
+     */
+    depositStartTime: Date | string;
+    /**
+     * Minimum amount of quote tokens to raise for the launch to succeed.
+     * Specified in whole units (e.g., 200 means 200 SOL, 25000 means 25000 USDC).
+     */
+    raiseGoal: number;
+    /**
+     * Percentage of raised funds allocated to Raydium LP, in basis points.
+     * Minimum 2000 (20%), maximum 10000 (100%).
+     * The remainder goes to the funds recipient as unlocked funds.
+     */
+    raydiumLiquidityBps: number;
+    /**
+     * Wallet address that receives the unlocked portion of raised funds.
+     */
+    fundsRecipient: PublicKey | string;
+}
+export interface LockedAllocation {
+    /** Human-readable name (e.g., 'Team', 'Advisors') for this vesting stream (max 64 chars) */
+    name: string;
+    /** Recipient wallet address */
+    recipient: PublicKey | string;
+    /** Total number of tokens in the vesting schedule */
+    tokenAmount: number;
+    /** When the vesting stream starts */
+    vestingStartTime: Date | string;
+    /** Duration of the full vesting period */
+    vestingDuration: {
+        value: number;
+        unit: TimeUnit;
+    };
+    /** How frequently tokens are released */
+    unlockSchedule: TimeUnit;
+    /** Optional cliff configuration */
+    cliff?: {
+        /** Duration until the cliff */
+        duration: {
+            value: number;
+            unit: TimeUnit;
+        };
+        /** Tokens released at cliff (in whole tokens). Defaults to linear vesting if not set. */
+        unlockAmount?: number;
+    };
+}
+export interface CreateLaunchInput {
+    /** The creator's wallet public key (will sign transactions) */
+    wallet: PublicKey | string;
+    /** Token metadata */
+    token: TokenMetadata;
+    /** Network, defaults to 'solana-mainnet' */
+    network?: SvmNetwork;
+    /**
+     * Quote token for the sale.
+     * Accepts 'SOL', 'USDC', or a raw mint address string.
+     * Defaults to 'SOL'.
+     */
+    quoteMint?: QuoteMintInput;
+    launchType: LaunchType;
+    launch: ProjectLaunchInput;
+}
+/**
+ * Simplified input for creating a project launch.
+ *
+ */
+export interface ProjectLaunchInput {
+    /** Launchpool (primary sale mechanism) configuration */
+    launchpool: LaunchpoolConfig;
+    /** Optional: locked/vesting token allocations via Streamflow */
+    lockedAllocations?: LockedAllocation[];
+}
+export interface GenesisApiConfig {
+    /** Base URL of the Genesis API. Defaults to 'https://api.metaplex.com'. */
+    baseUrl?: string;
+    /** Custom fetch implementation. Defaults to globalThis.fetch. */
+    fetch?: typeof globalThis.fetch;
+}
+export interface RegisterLaunchInput {
+    /** The genesis account public key (returned by createLaunch) */
+    genesisAccount: PublicKey | string;
+    createLaunchInput: CreateLaunchInput;
+}
+export interface CreateLaunchResponse {
+    /** Deserialized Umi transactions ready to be signed and sent */
+    transactions: Transaction[];
+    /** Blockhash for transaction validity */
+    blockhash: BlockhashWithExpiryBlockHeight;
+    /** The mint address of the created token */
+    mintAddress: string;
+    /** The genesis account PDA address */
+    genesisAccount: string;
+}
+export interface RegisterLaunchResponse {
+    /** Whether this launch was already registered */
+    existing?: boolean;
+    /** Launch information */
+    launch: {
+        id: string;
+        link: string;
+    };
+    /** Token information */
+    token: {
+        id: string;
+        mintAddress: string;
+    };
+}
+export interface CreateAndRegisterLaunchResult {
+    /** Transaction signatures from signing and sending */
+    signatures: Uint8Array[];
+    /** The mint address of the created token */
+    mintAddress: string;
+    /** The genesis account PDA address */
+    genesisAccount: string;
+    /** Launch information from registration */
+    launch: {
+        id: string;
+        link: string;
+    };
+    /** Token information from registration */
+    token: {
+        id: string;
+        mintAddress: string;
+    };
+}
+export interface SignAndSendOptions extends RpcSendTransactionOptions {
+    /** custom tx sender which returns the signatures of the transaction */
+    txSender?: (txs: Transaction[]) => Promise<Uint8Array[]>;
+}

package/dist/src/api/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/src/api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/api/types.ts"],"names":[],"mappings":""}

package/dist/src/conditions.d.ts

@@ -1,4 +1,5 @@
-import { ConditionArgs } from './generated';
+import { PublicKey } from '@metaplex-foundation/umi';
+import { BucketTimes, ClaimScheduleArgs, ConditionArgs } from './generated';
 /**
  * Type guard to narrow a ConditionArgs to a specific variant.
  * @param kind - The discriminant to check for ('TimeAbsolute' or 'TimeRelative')
@@ -8,3 +9,56 @@ import { ConditionArgs } from './generated';
 export declare function isConditionArgs<K extends ConditionArgs['__kind']>(kind: K, value: ConditionArgs): value is ConditionArgs & {
     __kind: K;
 };
+/**
+ * Creates a TimeAbsolute condition that triggers at a specific Unix timestamp.
+ * @param time - Unix timestamp (seconds) when the condition is met
+ */
+export declare function createTimeAbsoluteCondition(time: bigint): ConditionArgs;
+/**
+ * Creates a TimeRelative condition that triggers relative to another bucket's
+ * start or end time.
+ * @param referenceBucket - The public key of the bucket to reference
+ * @param bucketTime - Which time on the reference bucket (e.g. Start, End)
+ * @param timeOffset - Offset in seconds from the reference time (default 0)
+ */
+export declare function createTimeRelativeCondition(referenceBucket: PublicKey, bucketTime: BucketTimes, timeOffset?: bigint): ConditionArgs;
+/**
+ * Creates a Never condition. The condition will never be met and its
+ * `triggeredTimestamp` will never be set. Use this for permanently locked
+ * schedules (e.g. LP tokens that should never vest).
+ */
+export declare function createNeverCondition(): ConditionArgs;
+/**
+ * Creates a ClaimSchedule with TimeAbsolute conditions.
+ *
+ * Conditions start untriggered — call `CrankExtensionConditionsV2`
+ * (or `TriggerConditionsV2`) before claiming to trigger them on-chain.
+ *
+ * @param params.startTime  - Unix timestamp when linear vesting begins
+ * @param params.endTime    - Unix timestamp when linear vesting ends
+ * @param params.cliffTime  - Unix timestamp for the cliff
+ * @param params.cliffAmountBps - Basis points (0-10000) unlocked at cliff
+ * @param params.period     - Vesting period length in seconds
+ */
+export declare function createClaimSchedule(params: {
+    startTime: bigint;
+    endTime: bigint;
+    cliffTime: bigint;
+    cliffAmountBps: number;
+    period: bigint;
+}): ClaimScheduleArgs;
+/**
+ * Creates a ClaimSchedule with Never conditions for both start and cliff.
+ * Represents a **permanently locked** schedule where tokens never vest.
+ *
+ * Use this for LP tokens that should be locked forever.
+ *
+ * @example
+ * ```ts
+ * import { createNeverClaimSchedule } from '@metaplex-foundation/genesis';
+ *
+ * const schedule = createNeverClaimSchedule();
+ * // pass as lpLockSchedule when adding a Raydium CPMM bucket
+ * ```
+ */
+export declare function createNeverClaimSchedule(): ClaimScheduleArgs;

package/dist/src/conditions.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isConditionArgs = void 0;
+exports.createNeverClaimSchedule = exports.createClaimSchedule = exports.createNeverCondition = exports.createTimeRelativeCondition = exports.createTimeAbsoluteCondition = exports.isConditionArgs = void 0;
 /**
  * Type guard to narrow a ConditionArgs to a specific variant.
  * @param kind - The discriminant to check for ('TimeAbsolute' or 'TimeRelative')
@@ -11,4 +11,102 @@ function isConditionArgs(kind, value) {
     return value.__kind === kind;
 }
 exports.isConditionArgs = isConditionArgs;
+// ---------------------------------------------------------------------------
+// Condition Creators
+// ---------------------------------------------------------------------------
+/**
+ * Creates a TimeAbsolute condition that triggers at a specific Unix timestamp.
+ * @param time - Unix timestamp (seconds) when the condition is met
+ */
+function createTimeAbsoluteCondition(time) {
+    return {
+        __kind: 'TimeAbsolute',
+        padding: Array(47).fill(0),
+        time,
+        triggeredTimestamp: null,
+    };
+}
+exports.createTimeAbsoluteCondition = createTimeAbsoluteCondition;
+/**
+ * Creates a TimeRelative condition that triggers relative to another bucket's
+ * start or end time.
+ * @param referenceBucket - The public key of the bucket to reference
+ * @param bucketTime - Which time on the reference bucket (e.g. Start, End)
+ * @param timeOffset - Offset in seconds from the reference time (default 0)
+ */
+function createTimeRelativeCondition(referenceBucket, bucketTime, timeOffset = 0n) {
+    return {
+        __kind: 'TimeRelative',
+        bucketTime,
+        padding: Array(14).fill(0),
+        timeOffset,
+        bucket: referenceBucket,
+        triggeredTimestamp: null,
+    };
+}
+exports.createTimeRelativeCondition = createTimeRelativeCondition;
+/**
+ * Creates a Never condition. The condition will never be met and its
+ * `triggeredTimestamp` will never be set. Use this for permanently locked
+ * schedules (e.g. LP tokens that should never vest).
+ */
+function createNeverCondition() {
+    return {
+        __kind: 'Never',
+        padding: Array(55).fill(0),
+        triggeredTimestamp: null,
+    };
+}
+exports.createNeverCondition = createNeverCondition;
+// ---------------------------------------------------------------------------
+// ClaimSchedule Creators
+// ---------------------------------------------------------------------------
+/**
+ * Creates a ClaimSchedule with TimeAbsolute conditions.
+ *
+ * Conditions start untriggered — call `CrankExtensionConditionsV2`
+ * (or `TriggerConditionsV2`) before claiming to trigger them on-chain.
+ *
+ * @param params.startTime  - Unix timestamp when linear vesting begins
+ * @param params.endTime    - Unix timestamp when linear vesting ends
+ * @param params.cliffTime  - Unix timestamp for the cliff
+ * @param params.cliffAmountBps - Basis points (0-10000) unlocked at cliff
+ * @param params.period     - Vesting period length in seconds
+ */
+function createClaimSchedule(params) {
+    return {
+        startCondition: createTimeAbsoluteCondition(params.startTime),
+        duration: params.endTime - params.startTime,
+        period: params.period,
+        cliffCondition: createTimeAbsoluteCondition(params.cliffTime),
+        cliffAmountBps: params.cliffAmountBps,
+        reserved: Array(126).fill(0),
+    };
+}
+exports.createClaimSchedule = createClaimSchedule;
+/**
+ * Creates a ClaimSchedule with Never conditions for both start and cliff.
+ * Represents a **permanently locked** schedule where tokens never vest.
+ *
+ * Use this for LP tokens that should be locked forever.
+ *
+ * @example
+ * ```ts
+ * import { createNeverClaimSchedule } from '@metaplex-foundation/genesis';
+ *
+ * const schedule = createNeverClaimSchedule();
+ * // pass as lpLockSchedule when adding a Raydium CPMM bucket
+ * ```
+ */
+function createNeverClaimSchedule() {
+    return {
+        startCondition: createNeverCondition(),
+        duration: 1n,
+        period: 1n,
+        cliffCondition: createNeverCondition(),
+        cliffAmountBps: 0,
+        reserved: Array(126).fill(0),
+    };
+}
+exports.createNeverClaimSchedule = createNeverClaimSchedule;
 //# sourceMappingURL=conditions.js.map

package/dist/src/conditions.js.map

@@ -1 +1 @@
-{"version":3,"file":"conditions.js","sourceRoot":"","sources":["../../src/conditions.ts"],"names":[],"mappings":";;;AAEA;;;;;GAKG;AACH,SAAgB,eAAe,CAC7B,IAAO,EACP,KAAoB;IAEpB,OAAO,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC;AAC/B,CAAC;AALD,0CAKC"}
+{"version":3,"file":"conditions.js","sourceRoot":"","sources":["../../src/conditions.ts"],"names":[],"mappings":";;;AAGA;;;;;GAKG;AACH,SAAgB,eAAe,CAC7B,IAAO,EACP,KAAoB;IAEpB,OAAO,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC;AAC/B,CAAC;AALD,0CAKC;AAED,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E;;;GAGG;AACH,SAAgB,2BAA2B,CAAC,IAAY;IACtD,OAAO;QACL,MAAM,EAAE,cAAc;QACtB,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1B,IAAI;QACJ,kBAAkB,EAAE,IAAI;KACzB,CAAC;AACJ,CAAC;AAPD,kEAOC;AAED;;;;;;GAMG;AACH,SAAgB,2BAA2B,CACzC,eAA0B,EAC1B,UAAuB,EACvB,aAAqB,EAAE;IAEvB,OAAO;QACL,MAAM,EAAE,cAAc;QACtB,UAAU;QACV,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1B,UAAU;QACV,MAAM,EAAE,eAAe;QACvB,kBAAkB,EAAE,IAAI;KACzB,CAAC;AACJ,CAAC;AAbD,kEAaC;AAED;;;;GAIG;AACH,SAAgB,oBAAoB;IAClC,OAAO;QACL,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1B,kBAAkB,EAAE,IAAI;KACzB,CAAC;AACJ,CAAC;AAND,oDAMC;AAED,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E;;;;;;;;;;;GAWG;AACH,SAAgB,mBAAmB,CAAC,MAMnC;IACC,OAAO;QACL,cAAc,EAAE,2BAA2B,CAAC,MAAM,CAAC,SAAS,CAAC;QAC7D,QAAQ,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,SAAS;QAC3C,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,cAAc,EAAE,2BAA2B,CAAC,MAAM,CAAC,SAAS,CAAC;QAC7D,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;KAC7B,CAAC;AACJ,CAAC;AAfD,kDAeC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,wBAAwB;IACtC,OAAO;QACL,cAAc,EAAE,oBAAoB,EAAE;QACtC,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,EAAE;QACV,cAAc,EAAE,oBAAoB,EAAE;QACtC,cAAc,EAAE,CAAC;QACjB,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;KAC7B,CAAC;AACJ,CAAC;AATD,4DASC"}

package/dist/src/index.d.ts

@@ -1,4 +1,5 @@
 export * from './allowlist';
+export * from './api';
 export * from './auction';
 export * from './bondingCurveHelpers';
 export * from './conditions';

package/dist/src/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BACKEND_SIGNER = exports.FEE_WALLET = exports.SPL_TOKEN_2022_PROGRAM_ID = exports.WRAPPED_SOL_MINT = void 0;
 const umi_1 = require("@metaplex-foundation/umi");
 __exportStar(require("./allowlist"), exports);
+__exportStar(require("./api"), exports);
 __exportStar(require("./auction"), exports);
 __exportStar(require("./bondingCurveHelpers"), exports);
 __exportStar(require("./conditions"), exports);

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,kDAAqD;AAErD,8CAA4B;AAC5B,4CAA0B;AAC1B,wDAAsC;AACtC,+CAA6B;AAC7B,yCAAuB;AACvB,8CAA4B;AAC5B,2CAAyB;AACzB,4CAA0B;AAC1B,2CAAyB;AACzB,4CAA0B;AAC1B,4CAA0B;AAC1B,6CAA2B;AAC3B,+CAA6B;AAEhB,QAAA,gBAAgB,GAAG,IAAA,eAAS,EACvC,6CAA6C,CAC9C,CAAC;AAEW,QAAA,yBAAyB,GAAG,IAAA,eAAS,EAChD,6CAA6C,CAC9C,CAAC;AAEW,QAAA,UAAU,GAAG,IAAA,eAAS,EACjC,8CAA8C,CAC/C,CAAC;AAEF,wDAAwD;AAC3C,QAAA,cAAc,GAAG,IAAA,eAAS,EACrC,8CAA8C,CAC/C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,kDAAqD;AAErD,8CAA4B;AAC5B,wCAAsB;AACtB,4CAA0B;AAC1B,wDAAsC;AACtC,+CAA6B;AAC7B,yCAAuB;AACvB,8CAA4B;AAC5B,2CAAyB;AACzB,4CAA0B;AAC1B,2CAAyB;AACzB,4CAA0B;AAC1B,4CAA0B;AAC1B,6CAA2B;AAC3B,+CAA6B;AAEhB,QAAA,gBAAgB,GAAG,IAAA,eAAS,EACvC,6CAA6C,CAC9C,CAAC;AAEW,QAAA,yBAAyB,GAAG,IAAA,eAAS,EAChD,6CAA6C,CAC9C,CAAC;AAEW,QAAA,UAAU,GAAG,IAAA,eAAS,EACjC,8CAA8C,CAC/C,CAAC;AAEF,wDAAwD;AAC3C,QAAA,cAAc,GAAG,IAAA,eAAS,EACrC,8CAA8C,CAC/C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metaplex-foundation/genesis",
-  "version": "0.20.3",
+  "version": "0.20.5",
   "description": "The Metaplex Genesis Program",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",