@gala-chain/launchpad-sdk 8.0.2 → 9.0.0-rc.0

package/dist/schemas/launchpad.d.ts

@@ -36,8 +36,8 @@ export declare const tokenCollectionSchema: z.ZodDefault<z.ZodString>;
  * Defaults if not provided: { minFeePortion: "0.1", maxFeePortion: "0.5" }
  */
 export declare const reverseBondingCurveConfigSchema: z.ZodObject<{
-    minFeePortion: z.ZodString;
-    maxFeePortion: z.ZodString;
+    minFeePortion: z.ZodDefault<z.ZodString>;
+    maxFeePortion: z.ZodDefault<z.ZodString>;
 }, z.core.$strip>;
 /**
  * Token launch data schema
@@ -59,8 +59,8 @@ export declare const launchTokenDataSchema: z.ZodObject<{
     tokenCategory: z.ZodDefault<z.ZodString>;
     tokenCollection: z.ZodDefault<z.ZodString>;
     reverseBondingCurveConfiguration: z.ZodOptional<z.ZodObject<{
-        minFeePortion: z.ZodString;
-        maxFeePortion: z.ZodString;
+        minFeePortion: z.ZodDefault<z.ZodString>;
+        maxFeePortion: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
     saleStartTime: z.ZodOptional<z.ZodNumber>;
     privateKey: z.ZodOptional<z.ZodString>;

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

@@ -1 +1 @@
-{"version":3,"file":"launchpad.d.ts","sourceRoot":"","sources":["../../src/schemas/launchpad.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;iBAoBzB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,mBAAmB,2BAGd,CAAC;AAEnB;;GAEG;AACH,eAAO,MAAM,qBAAqB,2BAGf,CAAC;AAEpB;;;;;;;;GAQG;AACH,eAAO,MAAM,+BAA+B;;;iBAY3C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;iBAyBhC,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;iBAMnC,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;EAAgC,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;iBAQhC,CAAC;AAMJ;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;EAA6B,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;EAAwB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;iBAcjC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;iBAKrC,CAAC;AAMH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACzE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}
+{"version":3,"file":"launchpad.d.ts","sourceRoot":"","sources":["../../src/schemas/launchpad.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;iBAoBzB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,mBAAmB,2BAGd,CAAC;AAEnB;;GAEG;AACH,eAAO,MAAM,qBAAqB,2BAGf,CAAC;AAEpB;;;;;;;;GAQG;AACH,eAAO,MAAM,+BAA+B;;;iBAc3C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;iBAyBhC,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;iBAMnC,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;EAAgC,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;iBAQhC,CAAC;AAMJ;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;EAA6B,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;EAAwB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;iBAcjC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;iBAKrC,CAAC;AAMH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACzE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/schemas/user.d.ts

@@ -54,20 +54,6 @@ export declare const uploadProfileImageOptionsSchema: z.ZodObject<{
     address: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
     privateKey: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-/**
- * Token hold schema representing a lock on tokens
- * Matches the GalaChain FetchBalances response structure for inUseHolds and lockedHolds
- */
-export declare const tokenHoldSchema: z.ZodObject<{
-    created: z.ZodNumber;
-    createdBy: z.ZodString;
-    expires: z.ZodNumber;
-    instanceId: z.ZodString;
-    lockAuthority: z.ZodString;
-    name: z.ZodString;
-    quantity: z.ZodString;
-    vestingPeriodStart: z.ZodNumber;
-}, z.core.$strip>;
 /**
  * Fetch token balance options schema
  * Supports flexible token identification via tokenId, tokenClassKey, or tokenName
@@ -95,5 +81,4 @@ export type FetchGalaBalanceOptions = z.infer<typeof fetchGalaBalanceOptionsSche
 export type UpdateProfileData = z.infer<typeof updateProfileDataSchema>;
 export type UploadProfileImageOptions = z.infer<typeof uploadProfileImageOptionsSchema>;
 export type FetchTokenBalanceOptions = z.infer<typeof fetchTokenBalanceOptionsSchema>;
-export type TokenHold = z.infer<typeof tokenHoldSchema>;
 //# sourceMappingURL=user.d.ts.map

package/dist/schemas/user.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/schemas/user.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;EAAsC,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;iBAKjC,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;iBAGxC,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;iBAKlC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,+BAA+B;;;;iBAO1C,CAAC;AAMH;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;iBAiB1B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;iBAwB1C,CAAC;AAMF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACxF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACtF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/schemas/user.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;EAAsC,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;iBAKjC,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;iBAGxC,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;iBAKlC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,+BAA+B;;;;iBAO1C,CAAC;AAMH;;;GAGG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;iBAwB1C,CAAC;AAMF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACxF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC"}

package/dist/services/AbstractCacheService.d.ts

@@ -2,8 +2,8 @@
  * Abstract Cache Service Base Class
  *
  * Provides generic cache management functionality for all cache implementations.
- * Eliminates duplication across BridgeableTokenCache, WrappableTokenCache, and TokenMetadataCache
- * by providing a common interface and lifecycle management.
+ * The base of TokenMetadataCache: a common interface and lifecycle management (the bridgeable and
+ * wrappable token caches moved to `@gala-chain/gala-core-sdk/bridge`, inside its token services).
  *
  * ## Architecture
  * - **Generic K/V types**: Supports any key/value structure

package/dist/services/BundleService.d.ts

@@ -29,6 +29,7 @@ import type { ApiResponse } from '../types/common';
 import type { BuyTokenOptions, SellTokenOptions } from '../types/options.dto';
 import type { EIP712Domain, EIP712Types } from '../types/trade.dto';
 import type { HttpClient } from '../utils/http';
+import type { SellFeeCeilingResolver } from '../launchpad/sell-fee-ceiling';
 import { BaseService } from './BaseService';
 import type { TokenResolverService } from './TokenResolverService';
 /**
@@ -60,10 +61,11 @@ export declare class BundleService extends BaseService {
     private userAddress?;
     private defaultSlippageToleranceFactor;
     private defaultMaxAcceptableReverseBondingCurveFeeSlippageFactor;
+    private readonly sellFeeCeiling?;
     private readonly bundleEndpoint;
     private signer?;
     private tokenKeyService?;
-    constructor(httpClient: HttpClient, tokenResolver: TokenResolverService, debugMode?: boolean, _walletProvider?: unknown | undefined, userAddress?: string | undefined, defaultSlippageToleranceFactor?: number, defaultMaxAcceptableReverseBondingCurveFeeSlippageFactor?: number);
+    constructor(httpClient: HttpClient, tokenResolver: TokenResolverService, debugMode?: boolean, _walletProvider?: unknown | undefined, userAddress?: string | undefined, defaultSlippageToleranceFactor?: number, defaultMaxAcceptableReverseBondingCurveFeeSlippageFactor?: number, sellFeeCeiling?: SellFeeCeilingResolver | undefined);
     /**
      * Submit a bundle transaction to the backend
      *
@@ -215,6 +217,12 @@ export declare class BundleService extends BaseService {
      * @private
      */
     private prepareTradingOperation;
+    /**
+     * Fee ceiling for a sell whose caller named none: the quoted reverse bonding curve fee plus the
+     * fee slippage factor (per-call override or the SDK default).
+     * @throws ConfigurationError when no quote source was injected
+     */
+    private defaultSellFeeCeiling;
     /**
      * Calculate effective slippage factors and max fee with slippage protection
      *

package/dist/services/BundleService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BundleService.d.ts","sourceRoot":"","sources":["../../src/services/BundleService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAYH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAIpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAQhD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,SAAS,CAAC;IACrB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB;AAqBD;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAO1C,OAAO,CAAC,aAAa;IAErB,OAAO,CAAC,eAAe,CAAC;IACxB,OAAO,CAAC,WAAW,CAAC;IACpB,OAAO,CAAC,8BAA8B;IACtC,OAAO,CAAC,wDAAwD;IAXlE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAa;IAC5C,OAAO,CAAC,MAAM,CAAC,CAAkB;IACjC,OAAO,CAAC,eAAe,CAAC,CAAuB;gBAG7C,UAAU,EAAE,UAAU,EACd,aAAa,EAAE,oBAAoB,EAC3C,SAAS,GAAE,OAAe,EAClB,eAAe,CAAC,EAAE,OAAO,YAAA,EACzB,WAAW,CAAC,EAAE,MAAM,YAAA,EACpB,8BAA8B,GAAE,MAAa,EAC7C,wDAAwD,GAAE,MAAa;IAkBjF;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,iBAAiB,CACrB,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,WAAW,CAAC;IAiEvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiE1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA4B5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyB1B;;;;;;;;;;;;;;OAcG;IACG,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAkD9E;;;;;OAKG;IACG,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAkDpE;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC;IAqC7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAmG9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACG,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;IAqGhE;;;;;;;;;;;;;OAaG;YACW,uBAAuB;IA+BrC;;;;;;;;;OASG;IACH,OAAO,CAAC,0BAA0B;IAuClC;;OAEG;IACH,OAAO,CAAC,8BAA8B;IActC;;OAEG;YACW,wBAAwB;IAsEtC;;;;;OAKG;YAEW,uBAAuB;CAKtC"}
+{"version":3,"file":"BundleService.d.ts","sourceRoot":"","sources":["../../src/services/BundleService.ts"],"names":[],"mappings":"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"}

package/dist/services/GalaChainBalanceService.d.ts

@@ -1,72 +1,43 @@
 /**
  * GalaChain Balance Service
  *
- * Service responsible for querying token balances from GalaChain.
- * Extracted from GalaChainService for single responsibility.
- *
- * Features:
- * - GALA balance queries
- * - Generic token balance queries
- * - Hold filtering (locked, in-use)
- * - Available quantity calculation
+ * Token balances from GalaChain. The read itself (the `FetchBalances` request, the answer's checks,
+ * the holds in force and their totals) is `@gala-chain/gala-core-sdk`'s `GatewayReads`; this
+ * service keeps the launchpad result shape (`TokenBalanceResult`, `null` for "not held") and error
+ * contract on top of it, and sends the read through the SDK's gateway `HttpClient` (its
+ * interceptors and `Sign` header) exactly as before.
  *
  * @example
  * ```typescript
  * const balanceService = new GalaChainBalanceService(http, debug);
  *
- * // Get GALA balance
  * const galaBalance = await balanceService.fetchGalaBalance({
  *   owner: "eth|1234567890abcdef1234567890abcdef12345678",
  *   collection: "GALA",
  *   category: "Unit",
  *   additionalKey: "none",
  *   type: "none",
- *   instance: "0"
  * });
  *
- * // Get any token balance with hold details
+ * // Any token, with expired holds kept
  * const tokenBalance = await balanceService.fetchTokenBalance({
  *   owner: "eth|...",
  *   collection: "ANIME",
  *   category: "Unit",
  *   additionalKey: "none",
  *   type: "none",
- *   instance: "0"
- * }, true); // include expired holds
+ * }, true);
  * ```
  *
  * @category Services
  * @since 5.15.0
  */
-import type { TokenBalanceResult, TokenHold } from '../types/user.dto';
+import type { TokenBalanceResult } from '../types/user.dto';
 import type { HttpClient } from '../utils/http';
 import { BaseService } from './BaseService';
 /**
- * Sum the quantities of multiple token holds
- *
- * @param holds Array of token holds
- * @returns Total quantity as decimal string
- */
-declare function sumHoldQuantities(holds: TokenHold[]): string;
-/**
- * Filter out expired holds based on current timestamp
- *
- * @param holds Array of token holds
- * @param withExpired If true, return all holds including expired
- * @returns Filtered array of holds
- */
-declare function filterHolds(holds: TokenHold[], withExpired: boolean): TokenHold[];
-/**
- * Calculate available (unlocked, not in-use) quantity
- *
- * @param total Total quantity held
- * @param locked Quantity locked (from lockedHolds)
- * @param inUse Quantity in use (from inUseHolds)
- * @returns Available quantity as decimal string
- */
-declare function calculateAvailableQuantity(total: string, locked?: string, inUse?: string): string;
-/**
- * Balance query request parameters
+ * Balance query request parameters: the owner and the token class. (The chain's `FetchBalances`
+ * takes no instance: a body that names one is refused.)
  */
 export interface BalanceQueryParams {
     owner: string;
@@ -74,7 +45,6 @@ export interface BalanceQueryParams {
     category: string;
     additionalKey: string;
     type: string;
-    instance: string;
 }
 /**
  * GalaChain Balance Service
@@ -89,67 +59,25 @@ export declare class GalaChainBalanceService extends BaseService {
      * @param debug - Enable debug logging (default: false)
      */
     constructor(http: HttpClient, debug?: boolean);
-    /**
-     * Determines the GalaChain channel for a given token collection.
-     * Most tokens are on the asset channel, but some tokens like MUSIC
-     * are on their own dedicated channels.
-     *
-     * @param collection - Token collection name (e.g., "$GMUSIC", "$MUSIC", "ANIME")
-     * @returns Channel name: 'asset', 'music', etc.
-     */
-    private getChannelForCollection;
     /**
      * Fetches GALA balance for a user from GalaChain
      *
-     * Uses the GalaChain FetchBalances endpoint with GALA token parameters.
-     *
      * @param requestBody Balance query parameters
      * @returns Promise<TokenBalanceResult | null> Clean balance information or null if not held
-     * @throws Error if balance fetch fails
-     *
-     * @example
-     * ```typescript
-     * const balance = await balanceService.fetchGalaBalance({
-     *   owner: "eth|1234567890abcdef1234567890abcdef12345678",
-     *   collection: "GALA",
-     *   category: "Unit",
-     *   additionalKey: "none",
-     *   type: "none",
-     *   instance: "0"
-     * });
-     * ```
+     * @throws NetworkError if balance fetch fails
      */
     fetchGalaBalance(requestBody: BalanceQueryParams): Promise<TokenBalanceResult | null>;
     /**
-     * Fetches token balance for any token from GalaChain
-     *
-     * Generic method for querying token balances using the GalaChain FetchBalances endpoint.
-     * Returns balance information including locked/in-use holds and computed available quantity.
+     * Fetches token balance for any token from GalaChain (`FetchBalances`), with the holds in force
+     * (locked, in use) and the quantity they leave available. MUSIC (`$MUSIC`) is read on the
+     * gateway's music channel, every other token on the asset channel.
      *
      * @param requestBody Balance query parameters
      * @param withExpired If true, include expired holds in results (default: false)
-     * @returns Promise<TokenBalanceResult | null> Clean balance information or null if not held
-     * @throws Error if balance fetch fails
-     *
-     * @example
-     * ```typescript
-     * const balance = await balanceService.fetchTokenBalance({
-     *   owner: "eth|1234567890abcdef1234567890abcdef12345678",
-     *   collection: "ANIME",
-     *   category: "Unit",
-     *   additionalKey: "none",
-     *   type: "none",
-     *   instance: "0"
-     * });
-     *
-     * // Check lock details
-     * if (balance?.lockedHolds?.length) {
-     *   console.log('Locked:', balance.lockedQuantity);
-     *   console.log('Available:', balance.availableQuantity);
-     * }
-     * ```
+     * @returns Promise<TokenBalanceResult | null> The balance, or null when it is not held (no record,
+     *   a zero quantity, or a gateway answer that is not a usable balance list)
+     * @throws NetworkError if the request fails (HTTP error, network) or the owner is not a GalaChain user
      */
     fetchTokenBalance(requestBody: BalanceQueryParams, withExpired?: boolean): Promise<TokenBalanceResult | null>;
 }
-export { calculateAvailableQuantity, filterHolds, sumHoldQuantities };
 //# sourceMappingURL=GalaChainBalanceService.d.ts.map

package/dist/services/GalaChainBalanceService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GalaChainBalanceService.d.ts","sourceRoot":"","sources":["../../src/services/GalaChainBalanceService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAIH,OAAO,KAAK,EAEV,kBAAkB,EAClB,SAAS,EACV,MAAM,mBAAmB,CAAC;AAG3B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAM5C;;;;;GAKG;AACH,iBAAS,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,CAQrD;AAED;;;;;;GAMG;AACH,iBAAS,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,OAAO,GAAG,SAAS,EAAE,CAU1E;AAED;;;;;;;GAOG;AACH,iBAAS,0BAA0B,CACjC,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,MAAY,EACpB,KAAK,GAAE,MAAY,GAClB,MAAM,CAER;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,WAAW;IACtD;;;;;OAKG;gBACS,IAAI,EAAE,UAAU,EAAE,KAAK,GAAE,OAAe;IAIpD;;;;;;;OAOG;IACH,OAAO,CAAC,uBAAuB;IAe/B;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,gBAAgB,CAAC,WAAW,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAI3F;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,iBAAiB,CACrB,WAAW,EAAE,kBAAkB,EAC/B,WAAW,GAAE,OAAe,GAC3B,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;CA8FtC;AAGD,OAAO,EAAE,0BAA0B,EAAC,WAAW,EAAE,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"GalaChainBalanceService.d.ts","sourceRoot":"","sources":["../../src/services/GalaChainBalanceService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAQH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAgCD;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,WAAW;IACtD;;;;;OAKG;gBACS,IAAI,EAAE,UAAU,EAAE,KAAK,GAAE,OAAe;IAIpD;;;;;;OAMG;IACG,gBAAgB,CAAC,WAAW,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAI3F;;;;;;;;;;OAUG;IACG,iBAAiB,CACrB,WAAW,EAAE,kBAAkB,EAC/B,WAAW,GAAE,OAAe,GAC3B,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;CAsBtC"}

package/dist/services/GalaChainLockService.d.ts

@@ -4,6 +4,10 @@
  * Service responsible for token locking and unlocking operations on GalaChain.
  * Extracted from GalaChainService for single responsibility.
  *
+ * The writes themselves are `@gala-chain/gala-core-sdk`'s `GatewayWrites` (DTO, signature, the
+ * POST and the reading of GalaChain's answer); this service keeps the launchpad API on top of it:
+ * its input checks, launchpad token-name resolution, its result shapes and its error classes.
+ *
  * Features:
  * - Batch token locking (staking, escrow, vesting)
  * - Batch token unlocking
@@ -32,29 +36,14 @@
  * @since 5.15.0
  */
 import '../utils/errors';
-import type { Wallet } from 'ethers';
 import type { LockTokensData, LockTokensResult, UnlockTokensData, UnlockTokensResult } from '../types/lock.dto';
-import type { HttpClient } from '../utils/http';
-import { BaseService } from './BaseService';
-import type { TokenResolverService } from './TokenResolverService';
+import { GatewayWriteService } from './gateway-writes';
 /**
  * GalaChain Lock Service
  *
  * Handles all token locking and unlocking operations on GalaChain.
  */
-export declare class GalaChainLockService extends BaseService {
-    private readonly wallet;
-    private readonly tokenResolver;
-    private readonly nativeSigner;
-    /**
-     * Initialize GalaChain Lock Service
-     *
-     * @param http - HTTP client configured for GalaChain gateway
-     * @param wallet - Ethers wallet for signing transactions (optional for read-only operations)
-     * @param tokenResolver - Token resolver service for vault address resolution
-     * @param debug - Enable debug logging (default: false)
-     */
-    constructor(http: HttpClient, wallet: Wallet | undefined, tokenResolver: TokenResolverService, debug?: boolean);
+export declare class GalaChainLockService extends GatewayWriteService {
     /**
      * Lock tokens on GalaChain (batch operation)
      *
@@ -64,7 +53,7 @@ export declare class GalaChainLockService extends BaseService {
      * or other hold scenarios.
      *
      * @param data - Lock parameters containing array of tokens to lock
-     * @returns LockTokensResult with transaction ID and locked token details
+     * @returns LockTokensResult with transaction ID, block (when the gateway sends it) and locked token details
      *
      * @example
      * ```typescript
@@ -94,7 +83,7 @@ export declare class GalaChainLockService extends BaseService {
      * or was designated as lock authority).
      *
      * @param data - Unlock parameters containing array of tokens to unlock
-     * @returns UnlockTokensResult with transaction ID and unlocked token details
+     * @returns UnlockTokensResult with transaction ID, block (when the gateway sends it) and unlocked token details
      *
      * @example
      * ```typescript
@@ -115,6 +104,12 @@ export declare class GalaChainLockService extends BaseService {
      * @throws {LockError} When validation fails or unlock operation is rejected
      */
     unlockTokens(data: UnlockTokensData): Promise<UnlockTokensResult>;
+    /**
+     * GalaChain's answer to a lock or unlock must carry `Status: 1`. Called with every answer, the
+     * ones core accepted and the ones it refused, so a refused answer is reported exactly as this
+     * service always reported it.
+     */
+    private assertLockAnswer;
     private validateSharedTokenEntry;
     /**
      * Validate lock tokens data (batch operation)
@@ -124,6 +119,11 @@ export declare class GalaChainLockService extends BaseService {
      * Validate unlock tokens data (batch operation)
      */
     private validateUnlockTokensData;
+    /**
+     * The transaction id of a lock or unlock: the gateway's `x-transaction-id` (core's receipt),
+     * else the first `Data` item's id.
+     */
+    private transactionIdOf;
     /**
      * Extract lock result from GalaChain response
      */
@@ -142,6 +142,5 @@ export declare class GalaChainLockService extends BaseService {
      */
     private resolveTokenInstance;
     private resolveTokenEntry;
-    private createTokenOperationContext;
 }
 //# sourceMappingURL=GalaChainLockService.d.ts.map

package/dist/services/GalaChainLockService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GalaChainLockService.d.ts","sourceRoot":"","sources":["../../src/services/GalaChainLockService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIrC,OAAO,KAAK,EAC8B,cAAc,EACtD,gBAAgB,EAGE,gBAAgB,EAClC,kBAAkB,EAAC,MAAM,mBAAmB,CAAC;AAe/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAOhD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAyBnE;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;IAajD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAbhC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;IAE5D;;;;;;;OAOG;gBAED,IAAI,EAAE,UAAU,EACC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,aAAa,EAAE,oBAAoB,EACpD,KAAK,GAAE,OAAe;IAMxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyGjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA+FvE,OAAO,CAAC,wBAAwB;IAiChC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2C9B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAsBhC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyBzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyB3B;;OAEG;IACH,OAAO,CAAC,eAAe;IA+CvB;;;OAGG;YACW,oBAAoB;YA2BpB,iBAAiB;IAqB/B,OAAO,CAAC,2BAA2B;CASpC"}
+{"version":3,"file":"GalaChainLockService.d.ts","sourceRoot":"","sources":["../../src/services/GalaChainLockService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,iBAAiB,CAAC;AAIzB,OAAO,KAAK,EAGV,cAAc,EACd,gBAAgB,EAIhB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAoB3B,OAAO,EAEL,mBAAmB,EAIpB,MAAM,kBAAkB,CAAC;AAY1B;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,mBAAmB;IAG3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA+EjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkEvE;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,wBAAwB;IAiChC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2C9B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAsBhC;;;OAGG;IACH,OAAO,CAAC,eAAe;IAevB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAezB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAwDvB;;;OAGG;YACW,oBAAoB;YAqBpB,iBAAiB;CAchC"}

package/dist/services/GalaChainService.d.ts

@@ -12,7 +12,6 @@
  * - GalaChainTransferService: Token transfers and burns
  *
  * Features:
- * - Pool details fetching (for bonding curves)
  * - GALA balance queries
  * - Token balance queries
  * - GALA transfers with EIP-712 signatures
@@ -24,19 +23,13 @@
  * ```typescript
  * const galaChainService = new GalaChainService(galaChainHttp, wallet);
  *
- * // Fetch pool details for bonding curve
- * const poolDetails = await galaChainService.fetchPoolDetails({
- *   vaultAddress: "service|Token$Unit$MYSYMBOL$address$launchpad"
- * });
- *
  * // Get GALA balance
  * const balance = await galaChainService.fetchGalaBalance({
  *   owner: "eth|1234567890abcdef1234567890abcdef12345678",
  *   collection: "GALA",
  *   category: "Unit",
  *   additionalKey: "none",
- *   type: "none",
- *   instance: "0"
+ *   type: "none"
  * });
  *
  * // Transfer tokens
@@ -49,19 +42,18 @@
  * });
  * ```
  */
-import type { TokenClass } from '@gala-chain/api';
+import { type GalaChainTokenClass, type GalaChainTokenClassKey, type GalaChainTokenDetails } from '@gala-chain/gala-core-sdk';
 import type { AxiosInstance } from 'axios';
 import type { Wallet } from 'ethers';
 import type { BurnTokensData, BurnTokensResult } from '../types/burn.dto';
-import type { TokenClassKey } from '../types/common';
-import type { TokenClassWithSupply } from '../types/launchpad.dto';
+import type { TokenId } from '../types/common';
 import type { LockTokensData, LockTokensResult, UnlockTokensData, UnlockTokensResult } from '../types/lock.dto';
-import type { FetchPoolDetailsData, InternalFetchPoolDetailsResponse } from '../types/trade.dto';
 import type { GalaChainTransferReceipt, TransferGalaData, TransferTokenData } from '../types/transfer.dto';
 import type { TokenBalanceResult } from '../types/user.dto';
 import type { HttpClient } from '../utils/http';
 import { BaseService } from './BaseService';
 import type { BalanceQueryParams } from './GalaChainBalanceService';
+import type { GatewayWriter } from './gateway-writes';
 import type { TokenResolverService } from './TokenResolverService';
 /**
  * GalaChain Service for blockchain operations (Facade Pattern)
@@ -82,50 +74,9 @@ export declare class GalaChainService extends BaseService {
      * @param tokenResolver - Token resolver service for vault address resolution
      * @param debug - Enable debug logging (default: false)
      * @param publicAxios - Unauthenticated axios instance for public token queries
+     * @param writer - For an SDK with no wallet: the signer and declared identity of its token writes
      */
-    constructor(http: HttpClient, wallet: Wallet | undefined, tokenResolver: TokenResolverService, debug?: boolean, publicAxios?: AxiosInstance);
-    /**
-     * Fetches pool details by vault address from GalaChain
-     *
-     * Internal method for fetching pool details by vault address
-     * Used internally after vault resolution
-     *
-     * @param data Fetch pool details data with vault address
-     * @returns Promise<InternalFetchPoolDetailsResponse> Current trading pool state
-     * @throws ValidationError if input validation fails
-     * @throws Error if pool details fetch fails
-     *
-     * @example
-     * ```typescript
-     * const poolDetails = await galaChainService.fetchPoolDetails({
-     *   vaultAddress: "service|Token$Unit$MYSYMBOL$eth:address$launchpad"
-     * });
-     * console.log('GALA in vault:', poolDetails.Data.nativeTokenQuantity);
-     * ```
-     */
-    fetchPoolDetails(data: FetchPoolDetailsData): Promise<InternalFetchPoolDetailsResponse>;
-    /**
-     * Fetch the current launch token fee
-     *
-     * Returns the GALA fee required to launch a new token on the launchpad.
-     * This is a dynamic value that may change based on network conditions.
-     *
-     * @returns Promise resolving to fee amount in GALA (e.g., 0.001)
-     * @throws {Error} Network errors from HTTP request failures
-     * @throws {Error} Authentication errors if credentials are invalid
-     * @throws {Error} API errors when Status !== 1 in response
-     *
-     * @example
-     * ```typescript
-     * const fee = await galaChainService.fetchLaunchTokenFee();
-     * console.log(`Launch fee: ${fee} GALA`);
-     * ```
-     */
-    fetchLaunchTokenFee(): Promise<number>;
-    /**
-     * Validates fetch pool details data
-     */
-    private validateFetchPoolDetailsData;
+    constructor(http: HttpClient, wallet: Wallet | undefined, tokenResolver: TokenResolverService, debug?: boolean, publicAxios?: AxiosInstance, writer?: GatewayWriter);
     /**
      * Fetches GALA balance for a user from GalaChain
      *
@@ -142,8 +93,7 @@ export declare class GalaChainService extends BaseService {
      *   collection: "GALA",
      *   category: "Unit",
      *   additionalKey: "none",
-     *   type: "none",
-     *   instance: "0"
+     *   type: "none"
      * });
      * ```
      */
@@ -166,8 +116,7 @@ export declare class GalaChainService extends BaseService {
      *   collection: "ANIME",
      *   category: "Unit",
      *   additionalKey: "none",
-     *   type: "none",
-     *   instance: "0"
+     *   type: "none"
      * });
      *
      * // Check lock details
@@ -188,7 +137,7 @@ export declare class GalaChainService extends BaseService {
      * Supports both native tokens (GALA, etc.) and wrapped DEX tokens.
      *
      * @param tokenId Token identifier (string or TokenClassKey format)
-     * @returns Promise<TokenClass> Complete token metadata from GalaChain
+     * @returns Promise<GalaChainTokenClass> Complete token metadata from GalaChain
      * @throws ValidationError if tokenId validation fails
      * @throws Error if token fetch fails or token not found
      *
@@ -209,7 +158,22 @@ export declare class GalaChainService extends BaseService {
      * console.log(`Symbol: ${gusdc.symbol}`); // "GUSDC"
      * ```
      */
-    fetchTokenClassFromChain(tokenId: string | TokenClassKey): Promise<TokenClass>;
+    fetchTokenClassFromChain(tokenId: string | GalaChainTokenClassKey): Promise<GalaChainTokenClass>;
+    /**
+     * A token's details (symbol, decimals, name, image, description, network, contract address) from
+     * its GalaChain token class, as gala-core-sdk's `tokenDetailsOf` maps them.
+     *
+     * @param tokenId Token identifier (pipe string, class key or instance key)
+     * @returns The token's details
+     * @throws NetworkError if the read fails or the token class is not found
+     *
+     * @example
+     * ```typescript
+     * const details = await galaChainService.fetchTokenDetails('GUSDC|Unit|none|none');
+     * console.log(details.symbol, details.decimals);
+     * ```
+     */
+    fetchTokenDetails(tokenId: TokenId): Promise<GalaChainTokenDetails>;
     /**
      * Fetch supply information for one or more token classes from GalaChain
      *
@@ -220,7 +184,7 @@ export declare class GalaChainService extends BaseService {
      * - Token metadata (symbol, decimals, name)
      *
      * @param tokenClasses - Array of token class keys to query
-     * @returns Promise<TokenClassWithSupply[]> Array of token classes with supply information
+     * @returns Promise<GalaChainTokenClass[]> Array of token classes with supply information
      * @throws {ValidationError} if tokenClasses array is empty
      * @throws {Error} if network request fails or GalaChain returns error status
      *
@@ -234,7 +198,7 @@ export declare class GalaChainService extends BaseService {
      * console.log(`${supplies[0].symbol}: ${supplies[0].totalSupply}`);
      * ```
      */
-    fetchTokenClassesWithSupply(tokenClasses: TokenClassKey[]): Promise<TokenClassWithSupply[]>;
+    fetchTokenClassesWithSupply(tokenClasses: GalaChainTokenClassKey[]): Promise<GalaChainTokenClass[]>;
     /**
      * Transfer GALA tokens between wallets
      *
@@ -305,7 +269,7 @@ export declare class GalaChainService extends BaseService {
      *
      * @throws {TransferError} When token name cannot be resolved
      */
-    resolveTokenClassKey(tokenName: string): Promise<TokenClassKey>;
+    resolveTokenClassKey(tokenName: string): Promise<GalaChainTokenClassKey>;
     /**
      * Lock tokens on GalaChain (batch operation)
      *

package/dist/services/GalaChainService.d.ts.map

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