@gala-chain/launchpad-sdk 3.3.3 → 3.3.5

package/CHANGELOG.md

@@ -4,6 +4,43 @@ All notable changes to the Gala Launchpad SDK will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.3.4] - 2025-10-01
+
+### Fixed
+- **Launchpad token precision loss in trading DTOs** - Fixed critical bug truncating tokens to 8 decimals
+  - `formatForDTO()` now accepts optional `decimals` parameter (defaults to 18)
+  - Added `formatGalaForDTO()` helper for GALA amounts (8 decimals - GalaChain requirement)
+  - Added `formatLaunchpadTokenForDTO()` helper for launchpad tokens (18 decimals - full precision)
+  - Updated all BondingCurveDTOs to use context-aware formatting:
+    - `nativeTokenQuantity` (GALA) → Uses `formatGalaForDTO()` (8 decimals)
+    - `expectedToken` (Launchpad token) → Uses `formatLaunchpadTokenForDTO()` (18 decimals)
+    - `tokenQuantity` (Launchpad token) → Uses `formatLaunchpadTokenForDTO()` (18 decimals)
+    - `expectedNativeToken` (GALA) → Uses `formatGalaForDTO()` (8 decimals)
+  - Prevents precision loss when trading high-precision launchpad tokens
+  - GALA amounts still correctly limited to 8 decimals (GalaChain transaction requirement)
+  - Example: Token amount `1000.123456789012345678` now preserved at full 18 decimals instead of truncated to `1000.12345679`
+
+### Added
+- **Decimal Constants** - Token decimal precision constants for type-safe operations
+  - `GALA_DECIMALS = 8` - GALA token decimal places (GalaChain standard)
+  - `LAUNCHPAD_TOKEN_DECIMALS = 18` - Launchpad token decimal places (ERC-20 standard)
+  - `GALA_TOKEN_CLASS_KEY` - GALA token identifier for GalaChain operations
+  - Import: `import { GALA_DECIMALS, LAUNCHPAD_TOKEN_DECIMALS } from '@gala-chain/launchpad-sdk'`
+  - Provides single source of truth for decimal specifications
+  - Prevents hardcoded magic numbers across SDK
+
+### Changed
+- **precision-math.ts** - Now uses `LAUNCHPAD_TOKEN_DECIMALS` constant instead of hardcoded 18
+  - Improves code maintainability and clarity
+  - Self-documenting code intent
+
+### Benefits
+- ✅ Full precision for launchpad tokens (18 decimals) - no more truncation
+- ✅ Correct precision limits for GALA (8 decimals) - prevents transaction failures
+- ✅ Type-safe decimal constants via const assertions
+- ✅ Context-aware formatting prevents precision bugs
+- ✅ Single source of truth for token specifications
+
 ## [3.3.3] - 2025-10-01
 
 ### Fixed

package/dist/LaunchpadSDK.d.ts

@@ -601,7 +601,7 @@ export declare class LaunchpadSDK {
      * Update user profile information
      *
      * @param data Profile update data
-     * @returns Promise<UserProfile> Update result
+     * @returns Promise<void> No return data - throws on failure
      */
     updateProfile(data: UpdateProfileData): Promise<void>;
     /**

package/dist/constants/decimals.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Token decimal precision constants for GalaChain
+ *
+ * These constants define the decimal places for different token types
+ * used in the Gala Launchpad ecosystem. Following EIP-20 standard.
+ *
+ * @packageDocumentation
+ * @category Constants
+ */
+/**
+ * GALA token decimal places (EIP-20 standard)
+ *
+ * GALA uses 8 decimal places for all operations. This is a GalaChain
+ * requirement - transactions with more than 8 decimal places will fail.
+ *
+ * @example
+ * ```typescript
+ * import { GALA_DECIMALS } from '@gala-chain/launchpad-sdk';
+ *
+ * console.log(`GALA has ${GALA_DECIMALS} decimals`); // 8
+ * const maxPrecision = parseFloat(galaAmount).toFixed(GALA_DECIMALS);
+ * ```
+ */
+export declare const GALA_DECIMALS: 8;
+/**
+ * Launchpad token decimal places (EIP-20 standard)
+ *
+ * All tokens created via the Gala Launchpad use 18 decimal places,
+ * following the standard ERC-20 convention.
+ *
+ * @example
+ * ```typescript
+ * import { LAUNCHPAD_TOKEN_DECIMALS } from '@gala-chain/launchpad-sdk';
+ *
+ * console.log(`Launchpad tokens have ${LAUNCHPAD_TOKEN_DECIMALS} decimals`); // 18
+ * const maxPrecision = parseFloat(tokenAmount).toFixed(LAUNCHPAD_TOKEN_DECIMALS);
+ * ```
+ */
+export declare const LAUNCHPAD_TOKEN_DECIMALS: 18;
+/**
+ * GALA token class key for GalaChain operations
+ *
+ * This is the standard token identifier for GALA on GalaChain.
+ * Used for balance queries, transfers, and other token operations.
+ *
+ * @example
+ * ```typescript
+ * import { GALA_TOKEN_CLASS_KEY } from '@gala-chain/launchpad-sdk';
+ *
+ * const galaBalance = await galaChainService.fetchTokenBalance({
+ *   owner: walletAddress,
+ *   ...GALA_TOKEN_CLASS_KEY,
+ *   instance: "0"
+ * });
+ * ```
+ */
+export declare const GALA_TOKEN_CLASS_KEY: {
+    readonly collection: "GALA";
+    readonly category: "Unit";
+    readonly type: "none";
+    readonly additionalKey: "none";
+};
+//# sourceMappingURL=decimals.d.ts.map

package/dist/constants/decimals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimals.d.ts","sourceRoot":"","sources":["../../src/constants/decimals.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,EAAG,CAAU,CAAC;AAExC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,wBAAwB,EAAG,EAAW,CAAC;AAEpD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB;;;;;CAKvB,CAAC"}