@gala-chain/launchpad-sdk 0.4.3 → 3.0.1

package/dist/src/utils/SignatureHelper.d.ts

@@ -0,0 +1,77 @@
+import { ethers } from 'ethers';
+export interface EIP712Domain {
+    name: string;
+    chainId?: number;
+    verifyingContract?: string;
+    version?: string;
+}
+export interface EIP712Types {
+    [key: string]: Array<{
+        name: string;
+        type: string;
+    }>;
+}
+export interface SignedPayload {
+    signature: string;
+    domain: EIP712Domain;
+    types: EIP712Types;
+    signerPublicKey?: string;
+    prefix?: string;
+}
+/**
+ * Helper class for EIP-712 structured data signing
+ * Used for GalaChain transaction signatures
+ */
+export declare class SignatureHelper {
+    private wallet;
+    constructor(wallet: ethers.Wallet);
+    /**
+     * Generate a unique key for idempotency
+     */
+    static generateUniqueKey(): string;
+    /**
+     * Sign a TransferToken payload using EIP-712
+     */
+    signTransferToken(payload: {
+        from: string;
+        to: string;
+        quantity: string;
+        tokenInstance: {
+            collection: string;
+            category: string;
+            type: string;
+            additionalKey: string;
+            instance: string;
+        };
+        uniqueKey: string;
+    }): Promise<SignedPayload>;
+    /**
+     * Convert Ethereum address to GalaChain wallet format
+     */
+    static toGalaChainAddress(address: string): string;
+    /**
+     * Convert GalaChain wallet format to Ethereum address
+     */
+    static fromGalaChainAddress(galaAddress: string): string;
+    /**
+     * Create token instance for GALA transfers
+     */
+    static createGALATokenInstance(): {
+        collection: string;
+        category: string;
+        type: string;
+        additionalKey: string;
+        instance: string;
+    };
+    /**
+     * Create token instance from token class key
+     */
+    static createTokenInstanceFromClassKey(tokenClassKey: string): {
+        collection: string;
+        category: string;
+        type: string;
+        additionalKey: string;
+        instance: string;
+    };
+}
+//# sourceMappingURL=SignatureHelper.d.ts.map

package/dist/src/utils/SignatureHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignatureHelper.d.ts","sourceRoot":"","sources":["../../../src/utils/SignatureHelper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,WAAW,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,MAAM,CAAC,MAAM;IAIjC;;OAEG;IACH,MAAM,CAAC,iBAAiB,IAAI,MAAM;IAMlC;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE;QAC/B,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE;YACb,UAAU,EAAE,MAAM,CAAC;YACnB,QAAQ,EAAE,MAAM,CAAC;YACjB,IAAI,EAAE,MAAM,CAAC;YACb,aAAa,EAAE,MAAM,CAAC;YACtB,QAAQ,EAAE,MAAM,CAAC;SAClB,CAAC;QACF,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,aAAa,CAAC;IAuC1B;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAWlD;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAOxD;;OAEG;IACH,MAAM,CAAC,uBAAuB,IAAI;QAChC,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;KAClB;IAUD;;OAEG;IACH,MAAM,CAAC,+BAA+B,CAAC,aAAa,EAAE,MAAM,GAAG;QAC7D,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;KAClB;CAgBF"}

package/dist/src/utils/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../../src/utils/adapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,gBAAgB,GAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA6BxB;AAWD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,OAAO,kBAAgB,GACtB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAiDrB;AAWD;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,GAAG,EACvC,IAAI,EAAE,GAAG,EACT,OAAO,kBAAgB,GACtB,CAAC,CA2DH;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;IAC9B;;;;OAIG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;OAIG;;IAGH;;;OAGG;;IAGH;;OAEG;;;;;;;;;CASK,CAAC;AAEX;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,GAAG,EACZ,UAAU,EAAE,SAAS,GAAG,UAAU,GACjC,IAAI,CAiCN"}

package/dist/src/utils/agent-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-config.d.ts","sourceRoot":"","sources":["../../../src/utils/agent-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAe,eAAe,EAAE,MAAM,UAAU,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,aAAa,GAAG,SAAS,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACjC,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,YAAY,CAAC;IAClB,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE;QACZ,QAAQ,EAAE,OAAO,CAAC;QAClB,eAAe,EAAE,OAAO,CAAC;QACzB,UAAU,EAAE,OAAO,CAAC;QACpB,iBAAiB,EAAE,OAAO,CAAC;KAC5B,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;WACU,UAAU,CAAC,MAAM,GAAE,cAAmB,GAAG,OAAO,CAAC;QAC5D,GAAG,EAAE,YAAY,CAAC;QAClB,MAAM,EAAE,eAAe,CAAC;QACxB,MAAM,EAAE,kBAAkB,CAAC;QAC3B,UAAU,CAAC,EAAE,eAAe,CAAC;KAC9B,CAAC;IAkCF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;WACU,aAAa,CACxB,GAAG,EAAE,YAAY,EACjB,MAAM,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,eAAe,CAAC;IAyE3B;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,oBAAoB,CACzB,WAAW,EAAE,gBAAgB,EAC7B,OAAO,GAAE,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,SAAqB,GACrE,cAAc;IA4CjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;WACU,gBAAgB,CAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,WAAW,GAAE,gBAAgC,GAC5C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAkBxC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAQhC,OAAO,CAAC,MAAM,CAAC,WAAW;IAoB1B,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAWhC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAahC,OAAO,CAAC,MAAM,CAAC,sBAAsB;CAuBtC"}

package/dist/src/utils/date-utils.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Date parsing utilities for safe type conversion
+ *
+ * These utilities provide safe date parsing with fallback handling
+ * to prevent runtime errors from malformed date strings.
+ */
+/**
+ * Safely parse a date string to a Date object with fallback
+ *
+ * @param dateString - ISO date string from backend
+ * @param fallback - Fallback date if parsing fails (defaults to current date)
+ * @returns Valid Date object
+ */
+export declare function safeParseDate(dateString: string | Date | null | undefined, fallback?: Date): Date;
+/**
+ * Safely parse multiple date strings to Date objects
+ *
+ * @param dateStrings - Array of ISO date strings
+ * @param fallback - Fallback date for any parsing failures
+ * @returns Array of valid Date objects
+ */
+export declare function safeParseDates(dateStrings: (string | Date | null | undefined)[], fallback?: Date): Date[];
+/**
+ * Validate if a string is a valid date format before parsing
+ *
+ * @param dateString - String to validate
+ * @returns True if the string represents a valid date
+ */
+export declare function isValidDateString(dateString: string | Date | null | undefined): boolean;
+/**
+ * Parse date with validation and detailed error context
+ *
+ * @param dateString - Date string to parse
+ * @param context - Context information for debugging (e.g., 'user.createdAt')
+ * @param fallback - Fallback date if parsing fails
+ * @returns Valid Date object with debug information
+ */
+export declare function safeParseWithContext(dateString: string | Date | null | undefined, context: string, fallback?: Date): Date;
+//# sourceMappingURL=date-utils.d.ts.map

package/dist/src/utils/date-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/date-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,EAC5C,QAAQ,CAAC,EAAE,IAAI,GACd,IAAI,CA2BN;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EACjD,QAAQ,CAAC,EAAE,IAAI,GACd,IAAI,EAAE,CAER;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,GAC3C,OAAO,CAiBT;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,EAC5C,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,IAAI,GACd,IAAI,CAiCN"}

package/dist/src/utils/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/utils/http.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAiB,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE1E,OAAO,EAAiB,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;gBAEpB,IAAI,EAAE,aAAa,EAAE,MAAM,GAAE,SAAc;IAiBvD;;;;;OAKG;IACG,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IA8DzD;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EACf,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IASb;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,GAAG,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IASb;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EACf,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IASb;;OAEG;IACG,MAAM,CAAC,CAAC,GAAG,GAAG,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IASb;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,GAAG,EACjB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IASb;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKnD;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3E;;;;;;OAMG;IACG,iBAAiB,CACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;IA6B3E;;;OAGG;IACG,iBAAiB,CAAC,CAAC,SAAS,MAAM,EACtC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,CAAC,EACN,WAAW,GAAE,WAAyC,GACrD,OAAO,CACR,CAAC,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,GAAG,CAAC;QAAC,MAAM,EAAE,GAAG,CAAA;KAAE,CACpE;IAkBD;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAkF1B"}

package/dist/src/utils/multipart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipart.d.ts","sourceRoot":"","sources":["../../../src/utils/multipart.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAGnC,QAAQ,CAAC,EAAE,MAAM;IACjB,QAAQ,CAAC,EAAE,MAAM;gBAFxB,OAAO,EAAE,MAAM,EACR,QAAQ,CAAC,EAAE,MAAM,YAAA,EACjB,QAAQ,CAAC,EAAE,MAAM,YAAA;CAK3B;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,GAAG,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CAmKN;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CASzD;AA0BD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACzB,QAAQ,CAiBV;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CA0CnD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAuB9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAM3C"}

package/dist/src/utils/number-utils.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Numeric parsing utilities for safe type conversion
+ *
+ * These utilities provide safe number parsing with fallback handling
+ * to prevent silent failures in string-to-number conversions.
+ */
+/**
+ * Safely parse a string to a number with fallback
+ *
+ * @param value - String value to parse
+ * @param fallback - Fallback number if parsing fails
+ * @returns Valid number
+ */
+export declare function safeParseNumber(value: string | number | null | undefined, fallback: number): number;
+/**
+ * Safely parse an integer with validation
+ *
+ * @param value - String or number to parse as integer
+ * @param fallback - Fallback integer if parsing fails
+ * @returns Valid integer
+ */
+export declare function safeParseInt(value: string | number | null | undefined, fallback: number): number;
+/**
+ * Validate if a value can be safely converted to a number
+ *
+ * @param value - Value to validate
+ * @returns True if the value can be converted to a valid number
+ */
+export declare function isValidNumberString(value: string | number | null | undefined): boolean;
+/**
+ * Parse number with validation and detailed error context
+ *
+ * @param value - Value to parse
+ * @param context - Context information for debugging (e.g., 'pagination.page')
+ * @param fallback - Fallback number if parsing fails
+ * @returns Valid number with debug information
+ */
+export declare function safeParseWithContext(value: string | number | null | undefined, context: string, fallback: number): number;
+/**
+ * Format a number string for DTO validation with 8-decimal precision limit
+ *
+ * This prevents DTO validation errors caused by excessive floating-point precision
+ * and ensures numbers are in the correct format (fixed notation, no trailing zeros).
+ *
+ * @param num - Number string to format
+ * @returns Formatted string with maximum 8 decimal places
+ *
+ * @example
+ * ```typescript
+ * formatForDTO('0.000000047499999999999995') // '0.00000005'
+ * formatForDTO('123.456789123456789') // '123.45678912'
+ * formatForDTO('0') // '0'
+ * formatForDTO('100.0000') // '100'
+ * ```
+ */
+export declare function formatForDTO(num: string): string;
+//# sourceMappingURL=number-utils.d.ts.map

package/dist/src/utils/number-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/number-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACzC,QAAQ,EAAE,MAAM,GACf,MAAM,CAuBR;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACzC,QAAQ,EAAE,MAAM,GACf,MAAM,CAmBR;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GACxC,OAAO,CAWT;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACzC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,MAAM,CA0BR;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOhD"}

package/dist/src/utils/precision-math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"precision-math.d.ts","sourceRoot":"","sources":["../../../src/utils/precision-math.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,OAAO,GAChB,MAAM,CA6BR;AAkFD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAcpD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAuBrD"}

package/dist/src/utils/slippage-utils.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Slippage tolerance utilities for trading operations
+ *
+ * Provides precise slippage calculations for buy and sell operations to protect
+ * against price movement between quote calculation and transaction execution.
+ *
+ * @category Utilities
+ * @since 2.0.0
+ */
+/**
+ * Operation types for slippage calculation
+ */
+export type SlippageOperationType = 'buy-native' | 'buy-exact' | 'sell-exact' | 'sell-native';
+/**
+ * Apply slippage tolerance to an expected amount for trading operations
+ *
+ * Slippage tolerance protects against price movement by adjusting the minimum/maximum
+ * acceptable amounts in the direction that favors the user:
+ *
+ * **Buy Operations:**
+ * - buy-native: Reduce minimum tokens expected (accept receiving less)
+ * - buy-exact: Increase maximum GALA cost (accept paying more)
+ *
+ * **Sell Operations:**
+ * - sell-exact: Reduce minimum GALA expected (accept receiving less)
+ * - sell-native: Increase maximum tokens to sell (accept selling more)
+ *
+ * @param expectedAmount The calculated expected amount from bonding curve
+ * @param slippageToleranceFactor Slippage tolerance as decimal (e.g., 0.05 = 5%)
+ * @param operationType The specific trading operation type
+ * @returns Adjusted amount with slippage protection applied
+ *
+ * @example
+ * ```typescript
+ * // Buy native: Accept receiving 5% fewer tokens
+ * const protectedTokens = applySlippageTolerance("1000", 0.05, "buy-native");
+ * // Returns "950" (5% less tokens acceptable)
+ *
+ * // Buy exact: Accept paying 5% more GALA
+ * const protectedGala = applySlippageTolerance("100", 0.05, "buy-exact");
+ * // Returns "105" (5% more GALA acceptable)
+ *
+ * // Sell exact: Accept receiving 5% less GALA
+ * const protectedGala = applySlippageTolerance("100", 0.05, "sell-exact");
+ * // Returns "95" (5% less GALA acceptable)
+ * ```
+ *
+ * @throws {Error} If slippageToleranceFactor is negative or greater than 1
+ * @throws {Error} If expectedAmount is not a valid number
+ */
+export declare function applySlippageTolerance(expectedAmount: string, slippageToleranceFactor: number, operationType: SlippageOperationType): string;
+/**
+ * Calculate the effective slippage percentage between two amounts
+ *
+ * Useful for debugging and logging to show the actual slippage applied.
+ *
+ * @param originalAmount The original expected amount
+ * @param adjustedAmount The slippage-adjusted amount
+ * @returns The effective slippage percentage as a decimal (e.g., 0.05 = 5%)
+ *
+ * @example
+ * ```typescript
+ * const original = "1000";
+ * const adjusted = "950";
+ * const slippage = calculateEffectiveSlippage(original, adjusted);
+ * console.log(`Applied ${slippage * 100}% slippage`); // "Applied 5% slippage"
+ * ```
+ */
+export declare function calculateEffectiveSlippage(originalAmount: string, adjustedAmount: string): number;
+//# sourceMappingURL=slippage-utils.d.ts.map

package/dist/src/utils/slippage-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slippage-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/slippage-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,aAAa,CAAC;AAE9F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,MAAM,EACtB,uBAAuB,EAAE,MAAM,EAC/B,aAAa,EAAE,qBAAqB,GACnC,MAAM,CAuDR;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,GACrB,MAAM,CAYR"}

package/dist/src/utils/tokenNormalizer.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Token Normalization Utilities
+ *
+ * This module provides utilities for normalizing different token identifier formats
+ * into a consistent TokenInstanceKey format that can be used with GalaChain APIs.
+ */
+import { TokenId, TokenClassKey, TokenInstanceKey } from '../types/common';
+/**
+ * Normalizes any token identifier format to TokenInstanceKey
+ *
+ * Accepts:
+ * - String format: "collection|category|type|additionalKey" or "collection|category|type|additionalKey|instance"
+ * - TokenClassKey object: { collection, category, type, additionalKey }
+ * - TokenInstanceKey object: { collection, category, type, additionalKey, instance }
+ *
+ * @param tokenId Token identifier in any supported format
+ * @returns TokenInstanceKey with instance defaulted to "0" if not provided
+ * @throws ValidationError if the format is invalid
+ *
+ * @example
+ * ```typescript
+ * // String format (no instance)
+ * const result1 = normalizeToTokenInstanceKey("GALA|Unit|none|none");
+ * // → { collection: "GALA", category: "Unit", type: "none", additionalKey: "none", instance: "0" }
+ *
+ * // String format (with instance)
+ * const result2 = normalizeToTokenInstanceKey("Token|Unit|UNI|eth:address|1");
+ * // → { collection: "Token", category: "Unit", type: "UNI", additionalKey: "eth:address", instance: "1" }
+ *
+ * // TokenClassKey object
+ * const tokenClass = { collection: "Token", category: "Unit", type: "UNI", additionalKey: "eth:address" };
+ * const result3 = normalizeToTokenInstanceKey(tokenClass);
+ * // → { collection: "Token", category: "Unit", type: "UNI", additionalKey: "eth:address", instance: "0" }
+ *
+ * // TokenInstanceKey object (already normalized)
+ * const tokenInstance = { collection: "GALA", category: "Unit", type: "none", additionalKey: "none", instance: "0" };
+ * const result4 = normalizeToTokenInstanceKey(tokenInstance);
+ * // → Same object returned
+ * ```
+ */
+export declare function normalizeToTokenInstanceKey(tokenId: TokenId): TokenInstanceKey;
+/**
+ * Type guard to check if a TokenId is a TokenInstanceKey object
+ *
+ * @param tokenId Token identifier to check
+ * @returns True if tokenId is a TokenInstanceKey object
+ */
+export declare function isTokenInstanceKey(tokenId: TokenId): tokenId is TokenInstanceKey;
+/**
+ * Type guard to check if a TokenId is a TokenClassKey object
+ *
+ * @param tokenId Token identifier to check
+ * @returns True if tokenId is a TokenClassKey object (no instance field)
+ */
+export declare function isTokenClassKey(tokenId: TokenId): tokenId is TokenClassKey;
+/**
+ * Type guard to check if a TokenId is a string
+ *
+ * @param tokenId Token identifier to check
+ * @returns True if tokenId is a string
+ */
+export declare function isTokenIdString(tokenId: TokenId): tokenId is string;
+/**
+ * Converts a TokenInstanceKey to pipe-separated string format
+ *
+ * @param tokenInstance TokenInstanceKey to convert
+ * @returns String in format "collection|category|type|additionalKey|instance"
+ *
+ * @example
+ * ```typescript
+ * const tokenInstance = {
+ *   collection: "GALA",
+ *   category: "Unit",
+ *   type: "none",
+ *   additionalKey: "none",
+ *   instance: "0"
+ * };
+ *
+ * const result = tokenInstanceKeyToString(tokenInstance);
+ * // → "GALA|Unit|none|none|0"
+ * ```
+ */
+export declare function tokenInstanceKeyToString(tokenInstance: TokenInstanceKey): string;
+/**
+ * Converts a TokenClassKey to pipe-separated string format (without instance)
+ *
+ * @param tokenClass TokenClassKey to convert
+ * @returns String in format "collection|category|type|additionalKey"
+ *
+ * @example
+ * ```typescript
+ * const tokenClass = {
+ *   collection: "Token",
+ *   category: "Unit",
+ *   type: "UNI",
+ *   additionalKey: "eth:9401b171307bE656f00F9e18DF756643FD3a91dE"
+ * };
+ *
+ * const result = tokenClassKeyToString(tokenClass);
+ * // → "Token|Unit|UNI|eth:9401b171307bE656f00F9e18DF756643FD3a91dE"
+ * ```
+ */
+export declare function tokenClassKeyToString(tokenClass: TokenClassKey): string;
+/**
+ * Validates that a TokenId has all required fields
+ *
+ * @param tokenId Token identifier to validate
+ * @throws ValidationError if validation fails
+ */
+export declare function validateTokenId(tokenId: TokenId): void;
+//# sourceMappingURL=tokenNormalizer.d.ts.map

package/dist/src/utils/tokenNormalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenNormalizer.d.ts","sourceRoot":"","sources":["../../../src/utils/tokenNormalizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAG3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CA2D9E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,gBAAgB,CAKhF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,aAAa,CAI1E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,MAAM,CAEnE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,gBAAgB,GAAG,MAAM,CAEhF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,aAAa,GAAG,MAAM,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CActD"}

package/dist/{utils → src/utils}/validation.d.ts

@@ -65,7 +65,7 @@ export declare function validateGetAmountOptions(options: GetAmountOptions): voi
  */
 export declare function validateGetGraphOptions(options: GetGraphOptions): void;
 /**
- * Validates create pool data (supports both CreatePoolData and CreateSaleData formats)
+ * Validates create pool data (supports both CreatePoolData and LaunchTokenData formats)
  *
  * @param data Pool creation data to validate
  * @throws ValidationError if validation fails
@@ -86,12 +86,12 @@ export declare function toBackendAddressFormat(ethereumAddress: string): Address
  */
 export declare function fromBackendAddressFormat(backendAddress: string): string;
 /**
- * Validates create sale data (for bundle backend)
+ * Validates launch token data (for bundle backend)
  *
- * @param data Sale creation data to validate
+ * @param data Token launch data to validate
  * @throws ValidationError if validation fails
  */
-export declare function validateCreateSaleData(data: any): void;
+export declare function validateLaunchTokenData(data: any): void;
 export declare function isValidEthereumAddress(address: string): boolean;
 export declare function isValidAddressFormat(address: string): address is AddressFormat;
 export declare function formatAddressForBackend(address: EthereumAddress): AddressFormat;

package/dist/src/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAIL,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEjE;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAG/B,KAAK,CAAC,EAAE,MAAM;IACd,IAAI,CAAC,EAAE,MAAM;gBAFpB,OAAO,EAAE,MAAM,EACR,KAAK,CAAC,EAAE,MAAM,YAAA,EACd,IAAI,CAAC,EAAE,MAAM,YAAA;CAKvB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAgCzD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CA4BlE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAkB,GAC5B,IAAI,CAkBN;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAqCxD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAkCxE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAwFxE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CA6EtE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAwKtD;AAgBD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,MAAM,GAAG,aAAa,CAsB7E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAoBvE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAoDvD;AAGD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAa/D;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,GACd,OAAO,IAAI,aAAa,CAQ1B;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,GACvB,aAAa,CAEf;AAED,wBAAgB,wBAAwB,CACtC,gBAAgB,EAAE,aAAa,GAC9B,eAAe,CAEjB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,MAAM,CAuBR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,GACnB;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkBxD"}

package/dist/{utils → src/utils}/wallet.d.ts

@@ -22,10 +22,10 @@ export interface GeneratedWallet {
  *
  * @example
  * ```typescript
- * import { WalletUtils } from '@gala-chain/launchpad-sdk';
+ * import { createWallet } from '@gala-chain/launchpad-sdk';
  *
  * // Generate a new wallet
- * const newWallet = WalletUtils.generateWallet();
+ * const newWallet = createWallet();
  * console.log('Address:', newWallet.address);
  * console.log('Gala Address:', newWallet.galaAddress);
  * console.log('Mnemonic:', newWallet.mnemonic);

package/dist/src/utils/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../../src/utils/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA0B,MAAM,QAAQ,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,WAAW,CAAK;IAC/B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,cAAc,IAAI,eAAe;IAyCxC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe;IAa1D;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,eAAe;IAwCzE;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAY7C;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAiBrD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAUvD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAYnD;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,uBAAuB,CAAC,KAAK,GAAE,MAAU,GAAG,eAAe,EAAE;IA0BpE;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,gBAAgB,CACrB,MAAM,EAAE,eAAe,EACvB,gBAAgB,GAAE,OAAe,GAChC,MAAM;CAyBV"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gala-chain/launchpad-sdk",
-  "version": "0.4.3",
+  "version": "3.0.1",
   "description": "TypeScript SDK for Gala Launchpad Backend API - Production-ready DeFi token launchpad integration with wallet-based authentication, GalaChain trading, and comprehensive user operations. 100% tested (22/22 endpoints working).",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
@@ -36,19 +36,11 @@
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
     "test:ci": "jest --coverage --ci --watchAll=false",
-    "test:unit": "jest --selectProjects unit",
-    "test:integration": "jest --selectProjects integration",
-    "test:live": "tsx examples/trading/test-real-api-comprehensive.ts",
-    "test:live:help": "echo 'Live API Testing requires .env file with: WALLET_PRIVATE_KEY=your_test_wallet_private_key'",
-    "test:all": "npm run test:unit && npm run test:integration",
-    "test:trading": "tsx examples/trading/test-5-buys-5-sells.ts",
-    "test:websocket": "tsx examples/trading/test-websocket-monitoring.ts",
-    "demo": "tsx examples/demo-showcase.ts",
+    "demo": "tsx examples/complete-sdk-demo.ts",
     "lint": "eslint src --ext .ts,.tsx --fix",
     "lint:check": "eslint src --ext .ts,.tsx",
     "typecheck": "tsc --noEmit",
     "typecheck:watch": "tsc --noEmit --watch",
-    "typecheck:examples": "tsc --project tsconfig.examples.json --noEmit",
     "format": "prettier --write \"src/**/*.{ts,tsx,json,md}\"",
     "format:check": "prettier --check \"src/**/*.{ts,tsx,json,md}\"",
     "prepublishOnly": "npm run build",
@@ -96,7 +88,12 @@
     "bonding-curve",
     "token-creation",
     "portfolio",
-    "comments"
+    "comments",
+    "mcp",
+    "ai-agent",
+    "automation",
+    "agent-sdk",
+    "model-context-protocol"
   ],
   "author": {
     "name": "Gala Launchpad Team",
@@ -127,13 +124,13 @@
     "not ie 11"
   ],
   "dependencies": {
-    "@gala-chain/api": "^1.10.10",
+    "@gala-chain/api": "^2.4.3",
     "@gala-chain/connect": "^2.4.3",
     "@types/uuid": "^10.0.0",
     "axios": "^1.12.2",
     "bignumber.js": "^9.1.2",
     "crypto-js": "^4.2.0",
-    "dotenv": "^17.2.2",
+    "dotenv": "^17.2.3",
     "ethers": "^6.15.0",
     "socket.io-client": "^4.8.1",
     "uuid": "^13.0.0"