@gala-chain/launchpad-sdk 5.1.1 → 7.0.0-beta.1

package/dist/launchpad/bundle-submission.d.ts

@@ -0,0 +1,88 @@
+import type { LaunchpadSigner } from '../signing/types.js';
+/** Minimal response surface needed by the SDK's injectable HTTP requestor. */
+export interface HttpResponse {
+    ok: boolean;
+    status: number;
+    json(): Promise<unknown>;
+    text(): Promise<string>;
+}
+/** Fetch-compatible request function used by write transports and tests. */
+export type HttpRequestor = (url: string, options?: Parameters<typeof fetch>[1]) => Promise<HttpResponse>;
+/** Result delivered by the bundle socket or its REST confirmation fallback. */
+export interface BundleResult {
+    status: 'PROCESSED' | 'FAILED';
+    data: unknown;
+}
+export interface BundleSocket {
+    on(event: string, listener: (value: unknown) => void): BundleSocket;
+    off(event: string, listener: (value: unknown) => void): BundleSocket;
+    disconnect(): void;
+}
+export type SocketFactory = (url: string) => BundleSocket;
+/** Options accepted by {@link BundleSubmission.wait}. */
+export interface BundleWaitOptions {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}
+/** A submitted launchpad bundle that can be confirmed through socket or REST. */
+export declare class BundleSubmission {
+    /** Bundler-assigned identifier used as the socket event name. */
+    readonly bundleId: string;
+    /** Client-generated idempotency key included in the signed DTO. */
+    readonly uniqueKey: string;
+    /** Chaincode method relayed by the bundler. */
+    readonly method: string;
+    private readonly waitForResult;
+    /** Construct a submission; transports normally create this for callers. */
+    constructor(options: {
+        bundleId: string;
+        uniqueKey: string;
+        method: string;
+        wait: (options?: BundleWaitOptions) => Promise<BundleResult>;
+    });
+    /**
+     * Wait for PROCESSED or FAILED confirmation.
+     * @example
+     * ```typescript
+     * const result = await submission.wait({ timeoutMs: 30_000 });
+     * console.log(result.status);
+     * ```
+     */
+    wait(options?: BundleWaitOptions): Promise<BundleResult>;
+}
+/** Input handed from DTO builders to the launchpad transport seam. */
+export interface LaunchpadWriteRequest {
+    method: string;
+    dto: Record<string, unknown>;
+    stringsInstructions: string[];
+}
+/** The only current launchpad transport: typed-data signing plus `/bundle`. */
+export declare class BundlerTransport {
+    private readonly bundleBaseUrl;
+    private readonly launchpadBaseUrl;
+    private readonly requestor;
+    private readonly signer;
+    private readonly walletAddress;
+    private readonly socketFactory;
+    /** Create a bundler transport with an injectable requestor and socket factory. */
+    constructor(options: {
+        bundleBaseUrl: string;
+        launchpadBaseUrl: string;
+        signer: LaunchpadSigner;
+        walletAddress: string;
+        httpRequestor?: HttpRequestor;
+        socketFactory?: SocketFactory;
+    });
+    /**
+     * Sign and submit one allowlisted launchpad write to the bundler.
+     * @example
+     * ```typescript
+     * const submission = await transport.submit({ method: 'BuyWithNative', dto, stringsInstructions });
+     * await submission.wait();
+     * ```
+     */
+    submit(request: LaunchpadWriteRequest): Promise<BundleSubmission>;
+    private waitForResult;
+    private pollConfirmation;
+}
+//# sourceMappingURL=bundle-submission.d.ts.map

package/dist/launchpad/bundle-submission.d.ts.map

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

package/dist/launchpad/strings-instructions.d.ts

@@ -0,0 +1,15 @@
+import type { LaunchTokenData } from '../types/launchpad.dto.js';
+/** The three launchpad trade fields encoded in a sale vault address. */
+export interface LaunchpadVaultKey {
+    collection: string;
+    category: string;
+    type: string;
+    additionalKey: string;
+}
+/** Parse a GalaChain launchpad vault address. */
+export declare function parseLaunchpadVaultAddress(vaultAddress: string): LaunchpadVaultKey;
+/** Generate the frontend-identical five resource instructions for a trade. */
+export declare function generateBuySellStringsInstructions(vaultAddress: string): string[];
+/** Generate the exact CreateSale resource set emitted by LaunchForm.tsx. */
+export declare function generateCreateSaleStringsInstructions(input: Pick<LaunchTokenData, 'tokenName' | 'preBuyQuantity'>): string[];
+//# sourceMappingURL=strings-instructions.d.ts.map

package/dist/launchpad/strings-instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings-instructions.d.ts","sourceRoot":"","sources":["../../src/launchpad/strings-instructions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,iDAAiD;AACjD,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,iBAAiB,CA2BlF;AAED,8EAA8E;AAC9E,wBAAgB,kCAAkC,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAWjF;AAED,4EAA4E;AAC5E,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,GAAG,gBAAgB,CAAC,GAC3D,MAAM,EAAE,CAmBV"}

package/dist/launchpad/transport.d.ts

@@ -0,0 +1,28 @@
+import type { BundleSubmission, BundleWaitOptions, HttpRequestor } from './bundle-submission.js';
+/** Allowlisted launchpad chaincode methods accepted by the bundler. */
+export type LaunchpadWriteMethod = 'CreateSale' | 'BuyWithNative' | 'BuyExactToken' | 'SellWithNative' | 'SellExactToken';
+/** Transport seam for launchpad writes; signing belongs to the implementation. */
+export interface LaunchpadWriteTransport {
+    /**
+     * Submit an unsigned DTO and its resource instructions.
+     * @example
+     * ```typescript
+     * const submission = await transport.submit({ method: 'CreateSale', dto, stringsInstructions });
+     * await submission.wait();
+     * ```
+     */
+    submit(request: {
+        method: LaunchpadWriteMethod;
+        dto: Record<string, unknown>;
+        stringsInstructions: string[];
+    }): Promise<BundleSubmission>;
+}
+/** Narrow options shared by the concrete bundler transport factory. */
+export interface LaunchpadTransportOptions {
+    bundleBaseUrl: string;
+    launchpadBaseUrl: string;
+    walletAddress: string;
+    httpRequestor?: HttpRequestor;
+    waitOptions?: BundleWaitOptions;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/launchpad/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/launchpad/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEjG,uEAAuE;AACvE,MAAM,MAAM,oBAAoB,GAC5B,YAAY,GACZ,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,gBAAgB,CAAC;AAErB,kFAAkF;AAClF,MAAM,WAAW,uBAAuB;IACtC;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,EAAE;QACd,MAAM,EAAE,oBAAoB,CAAC;QAC7B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7B,mBAAmB,EAAE,MAAM,EAAE,CAAC;KAC/B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC/B;AAED,uEAAuE;AACvE,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC"}

package/dist/launchpad/writes.d.ts

@@ -0,0 +1,74 @@
+import type { LaunchTokenData } from '../types/launchpad.dto.js';
+import type { BundleSubmission } from './bundle-submission.js';
+import type { LaunchpadWriteTransport } from './transport.js';
+/** Common fee fields copied into every frontend trade DTO. */
+export interface LaunchpadExtraFees {
+    maxAcceptableReverseBondingCurveFee: string;
+}
+/** Input for a bundler launchpad trade. */
+export interface LaunchpadTradeInput {
+    vaultAddress: string;
+    quantity: string;
+    expectedAmount: string;
+    extraFees?: LaunchpadExtraFees;
+    uniqueKey?: string;
+}
+/** Input for a CreateSale bundler write. */
+export interface CreateSaleInput extends Omit<LaunchTokenData, 'tokenImage'> {
+    tokenImage: string;
+    uniqueKey?: string;
+}
+/** Public launchpad write facade; callers only build inputs and receive submissions. */
+export declare class LaunchpadWrites {
+    private readonly transport;
+    private readonly walletAddress;
+    /** Construct launchpad write methods around an injected transport. */
+    constructor(options: {
+        transport: LaunchpadWriteTransport;
+        walletAddress: string;
+    });
+    /**
+     * Create a sale using the frontend's CreateSale DTO and instruction set.
+     * @example
+     * ```typescript
+     * const submission = await sdk.launchpad.createSale({ tokenName: 'anime', tokenSymbol: 'ANIME', tokenImage: 'https://example.test/anime.png' });
+     * await submission.wait();
+     * ```
+     */
+    createSale(input: CreateSaleInput): Promise<BundleSubmission>;
+    /**
+     * Buy an exact native quantity through BuyWithNative.
+     * @example
+     * ```typescript
+     * const submission = await sdk.launchpad.buyWithNative({ vaultAddress, quantity: '1', expectedAmount: '2' });
+     * await submission.wait();
+     * ```
+     */
+    buyWithNative(input: LaunchpadTradeInput): Promise<BundleSubmission>;
+    /**
+     * Buy an exact token quantity through BuyExactToken.
+     * @example
+     * ```typescript
+     * await sdk.launchpad.buyExactToken({ vaultAddress, quantity: '1', expectedAmount: '2' });
+     * ```
+     */
+    buyExactToken(input: LaunchpadTradeInput): Promise<BundleSubmission>;
+    /**
+     * Sell an exact native output through SellWithNative.
+     * @example
+     * ```typescript
+     * await sdk.launchpad.sellWithNative({ vaultAddress, quantity: '1', expectedAmount: '2' });
+     * ```
+     */
+    sellWithNative(input: LaunchpadTradeInput): Promise<BundleSubmission>;
+    /**
+     * Sell an exact token quantity through SellExactToken.
+     * @example
+     * ```typescript
+     * await sdk.launchpad.sellExactToken({ vaultAddress, quantity: '1', expectedAmount: '2' });
+     * ```
+     */
+    sellExactToken(input: LaunchpadTradeInput): Promise<BundleSubmission>;
+    private submitTrade;
+}
+//# sourceMappingURL=writes.d.ts.map

package/dist/launchpad/writes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writes.d.ts","sourceRoot":"","sources":["../../src/launchpad/writes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,KAAK,EAAwB,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEpF,8DAA8D;AAC9D,MAAM,WAAW,kBAAkB;IACjC,mCAAmC,EAAE,MAAM,CAAC;CAC7C;AAED,2CAA2C;AAC3C,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,4CAA4C;AAC5C,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wFAAwF;AACxF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IAEvC,sEAAsE;gBACnD,OAAO,EAAE;QAAE,SAAS,EAAE,uBAAuB,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE;IAKzF;;;;;;;OAOG;IACI,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IASpE;;;;;;;OAOG;IACI,aAAa,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAO3E;;;;;;OAMG;IACI,aAAa,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAO3E;;;;;;OAMG;IACI,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAO5E;;;;;;OAMG;IACI,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAO5E,OAAO,CAAC,WAAW;CAiBpB"}