@gala-chain/launchpad-sdk 8.1.0 → 9.0.0-rc.1

package/dist/schemas/launchpad.d.ts

@@ -73,11 +73,13 @@ export declare const imageUploadOptionsSchema: z.ZodObject<{
     tokenName: z.ZodString;
 }, z.core.$strip>;
 /**
- * Pool fetch type schema - 'RECENT' or 'POPULAR' (matches backend format)
+ * Pool fetch type schema: the `type` values `GET /v1/tokens` accepts ({@link POOL_FETCH_TYPES}).
  */
 export declare const poolFetchTypeSchema: z.ZodEnum<{
     RECENT: "RECENT";
     POPULAR: "POPULAR";
+    RECORDINGS: "RECORDINGS";
+    SECONDS_STREAMED: "SECONDS_STREAMED";
 }>;
 /**
  * Pool check options schema
@@ -126,7 +128,6 @@ export type TokenUrls = z.infer<typeof tokenUrlsSchema>;
 export type LaunchTokenDataInput = z.input<typeof launchTokenDataSchema>;
 export type LaunchTokenData = z.infer<typeof launchTokenDataSchema>;
 export type ImageUploadOptions = z.infer<typeof imageUploadOptionsSchema>;
-export type PoolFetchType = z.infer<typeof poolFetchTypeSchema>;
 export type CheckPoolOptions = z.infer<typeof checkPoolOptionsSchema>;
 export type AmountType = z.infer<typeof amountTypeSchema>;
 export type AmountMethod = z.infer<typeof amountMethodSchema>;

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;;;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"}
+{"version":3,"file":"launchpad.d.ts","sourceRoot":"","sources":["../../src/schemas/launchpad.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB;;;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;;;;;EAA2B,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;iBAShC,CAAC;AAMJ;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;EAA6B,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;EAAwB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;iBAejC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;iBAMrC,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,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/primitives.d.ts

@@ -6,10 +6,20 @@
  */
 import { z } from 'zod';
 /**
- * Token name schema - alphanumeric, 3-20 characters
- * Used for token creation and identification
+ * Token name schema - what the chain and the bundler take as a launched name: ASCII letters and
+ * digits, at least one (the same rule `createSale` checks). It carries NO length cap: the routes cap
+ * differently (1-20 on DTO routes, 1-255 on path routes), and each method validates the rule of its
+ * own route (see `types/constraints`, `TOKEN_NAME_*_CONSTRAINT`).
  */
 export declare const tokenNameSchema: z.ZodString;
+/**
+ * Token name of a DTO route (`@TokenNameField()`): letters and digits, 1-20.
+ */
+export declare const dtoTokenNameSchema: z.ZodString;
+/**
+ * Token name of the availability check (`POST /v1/utils/validate-token`): any text of 1-50 characters.
+ */
+export declare const availabilityTokenNameSchema: z.ZodString;
 /**
  * Token symbol schema - uppercase letters, 1-8 characters
  * Used for token ticker symbols

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

@@ -1 +1 @@
-{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/schemas/primitives.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB;;;GAGG;AACH,eAAO,MAAM,eAAe,aAIsD,CAAC;AAEnF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,aAIyC,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,sBAAsB,aAG4B,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,aAGsB,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,aAG4B,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,cAAc,aAI+C,CAAC;AAM3E;;;GAGG;AACH,eAAO,MAAM,mBAAmB,aAE2D,CAAC;AAE5F;;;GAGG;AACH,eAAO,MAAM,qBAAqB,aAEuC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,qBAAqB,wDAa9B,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,kBAAkB,aAO5B,CAAC;AAMJ;;;GAGG;AACH,eAAO,MAAM,2BAA2B,aAMrC,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,8BAA8B,aAMxC,CAAC;AAMJ;;;GAGG;AACH,eAAO,MAAM,SAAS,aAG6C,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,4BAM3B,CAAC;AAMJ;;;GAGG;AACH,eAAO,MAAM,gBAAgB,2BAKhB,CAAC;AAEd;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,GAAE,MAAY,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAOnF;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,2BAAyB,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,eAAe,2BAAwB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,gBAAgB,2BAAwB,CAAC;AAMtD;;GAEG;AACH,eAAO,MAAM,cAAc,aAI0B,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,cAAc,aAE2B,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;EAO9B,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,mBAAmB,aAEmB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,eAAe,aAGe,CAAC;AAM5C;;;GAGG;AACH,eAAO,MAAM,gBAAgB,aAEwD,CAAC;AAEtF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,aAK7B,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,eAAe,aAKzB,CAAC"}
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/schemas/primitives.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB;;;;;GAKG;AACH,eAAO,MAAM,eAAe,aAGiD,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,kBAAkB,aAAsE,CAAC;AAEtG;;GAEG;AACH,eAAO,MAAM,2BAA2B,aAGc,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,aAIyC,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,sBAAsB,aAG4B,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,aAGsB,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,aAG4B,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,cAAc,aAI+C,CAAC;AAM3E;;;GAGG;AACH,eAAO,MAAM,mBAAmB,aAE2D,CAAC;AAE5F;;;GAGG;AACH,eAAO,MAAM,qBAAqB,aAEuC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,qBAAqB,wDAa9B,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,kBAAkB,aAO5B,CAAC;AAMJ;;;GAGG;AACH,eAAO,MAAM,2BAA2B,aAMrC,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,8BAA8B,aAMxC,CAAC;AAMJ;;;GAGG;AACH,eAAO,MAAM,SAAS,aAG6C,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,4BAM3B,CAAC;AAMJ;;;GAGG;AACH,eAAO,MAAM,gBAAgB,2BAKhB,CAAC;AAEd;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,GAAE,MAAY,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAOnF;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,2BAAyB,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,eAAe,2BAAwB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,gBAAgB,2BAAwB,CAAC;AAMtD;;GAEG;AACH,eAAO,MAAM,cAAc,aAI0B,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,cAAc,aAE2B,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;EAO9B,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,mBAAmB,aAEmB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,eAAe,aAGe,CAAC;AAM5C;;;GAGG;AACH,eAAO,MAAM,gBAAgB,aAEwD,CAAC;AAEtF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,aAK7B,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,eAAe,aAKzB,CAAC"}

package/dist/schemas/user.d.ts

@@ -41,9 +41,9 @@ export declare const fetchGalaBalanceOptionsSchema: z.ZodObject<{
  * Update profile data schema
  */
 export declare const updateProfileDataSchema: z.ZodObject<{
-    profileImage: z.ZodString;
-    fullName: z.ZodString;
-    address: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    profileImage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    fullName: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
     privateKey: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
@@ -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/schemas/validators.d.ts

@@ -221,9 +221,9 @@ export declare const validateFetchGalaBalanceOptions: (value: unknown) => Valida
  * Replaces: isUpdateProfileData()
  */
 export declare const validateUpdateProfileData: (value: unknown) => ValidationResult<{
-    profileImage: string;
-    fullName: string;
-    address: string;
+    profileImage?: string | null | undefined;
+    fullName?: string | undefined;
+    address?: string | undefined;
     privateKey?: string | undefined;
 }>;
 /**

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/ApiKeyService.d.ts

@@ -109,7 +109,7 @@ export declare class ApiKeyService extends BaseService {
      * if (page1.pageInfo.hasNextPage) {
      *   const page2 = await apiKeyService.findAll({
      *     pageSize: 20,
-     *     cursor: page1.pageInfo.nextCursor
+     *     cursor: page1.pageInfo.endCursor ?? undefined
      *   });
      * }
      *

package/dist/services/BanService.d.ts

@@ -144,7 +144,7 @@ export declare class BanService extends StreamTokenServiceBase {
      *   const page2 = await banService.listBans({
      *     tokenName: 'mytoken',
      *     pageSize: 20,
-     *     cursor: page1.pageInfo.nextCursor
+     *     cursor: page1.pageInfo.endCursor ?? undefined
      *   });
      * }
      * ```

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

@@ -1 +1 @@
-{"version":3,"file":"ChartService.d.ts","sourceRoot":"","sources":["../../src/services/ChartService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,sCAAsC;IACtC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,YAAa,SAAQ,WAAW;gBAC/B,IAAI,EAAE,UAAU,EAAE,SAAS,GAAE,OAAe;IAIxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;CA8I/D"}
+{"version":3,"file":"ChartService.d.ts","sourceRoot":"","sources":["../../src/services/ChartService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,sCAAsC;IACtC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,YAAa,SAAQ,WAAW;gBAC/B,IAAI,EAAE,UAAU,EAAE,SAAS,GAAE,OAAe;IAIxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;CA+I/D"}

package/dist/services/ContentReactionService.d.ts

@@ -25,14 +25,12 @@ import { StreamTokenServiceBase } from './StreamTokenServiceBase';
  *
  * // Add a reaction to a chat message
  * const result = await reactionService.addContentReaction({
- *   tokenName: 'mytoken',
  *   messageId: 'msg-1703443200000-a1b2c3d4e5f6789012345678901234ab',
  *   reactionType: 'heart'
  * });
  *
  * // Remove a reaction
  * await reactionService.removeContentReaction({
- *   tokenName: 'mytoken',
  *   messageId: 'msg-1703443200000-a1b2c3d4e5f6789012345678901234ab',
  *   reactionType: 'heart'
  * });
@@ -40,10 +38,6 @@ import { StreamTokenServiceBase } from './StreamTokenServiceBase';
  */
 export declare class ContentReactionService extends StreamTokenServiceBase {
     constructor(http: HttpClient, adminApiKey?: string, jwtAuth?: JwtAuth, debugMode?: boolean, userApiKey?: string);
-    /**
-     * Validate token name using content reaction constraints
-     */
-    private validateReactionTokenName;
     /**
      * Validate message ID format
      */
@@ -59,7 +53,7 @@ export declare class ContentReactionService extends StreamTokenServiceBase {
      * Adding the same reaction type again is a no-op (idempotent).
      * Users can have multiple different reaction types on the same message.
      *
-     * @param options Options including tokenName, messageId, and reactionType
+     * @param options Options including messageId and reactionType
      * @returns Updated reaction data and whether reaction was newly created
      * @throws ValidationError if parameters are invalid
      * @throws ConfigurationError if authentication is not configured
@@ -68,7 +62,6 @@ export declare class ContentReactionService extends StreamTokenServiceBase {
      * ```typescript
      * // Add a heart reaction
      * const result = await reactionService.addContentReaction({
-     *   tokenName: 'mytoken',
      *   messageId: 'msg-1703443200000-a1b2c3d4e5f6789012345678901234ab',
      *   reactionType: 'heart'
      * });
@@ -83,7 +76,7 @@ export declare class ContentReactionService extends StreamTokenServiceBase {
      * Requires JWT or API key authentication.
      * Only the user who created the reaction can remove it (no admin override).
      *
-     * @param options Options including tokenName, messageId, and reactionType
+     * @param options Options including messageId and reactionType
      * @returns Success indicator
      * @throws ValidationError if parameters are invalid
      * @throws ConfigurationError if authentication is not configured
@@ -92,7 +85,6 @@ export declare class ContentReactionService extends StreamTokenServiceBase {
      * ```typescript
      * // Remove a heart reaction
      * await reactionService.removeContentReaction({
-     *   tokenName: 'mytoken',
      *   messageId: 'msg-1703443200000-a1b2c3d4e5f6789012345678901234ab',
      *   reactionType: 'heart'
      * });
@@ -104,13 +96,12 @@ export declare class ContentReactionService extends StreamTokenServiceBase {
      *
      * Convenience wrapper for addContentReaction specifically for chat messages.
      *
-     * @param options Options including tokenName, messageId, and reactionType
+     * @param options Options including messageId and reactionType
      * @returns Updated reaction data
      *
      * @example
      * ```typescript
      * await reactionService.addReactionToChatMessage({
-     *   tokenName: 'mytoken',
      *   messageId: 'msg-1703443200000-a1b2c3d4e5f6789012345678901234ab',
      *   reactionType: 'fire'
      * });
@@ -122,13 +113,12 @@ export declare class ContentReactionService extends StreamTokenServiceBase {
      *
      * Convenience wrapper for removeContentReaction specifically for chat messages.
      *
-     * @param options Options including tokenName, messageId, and reactionType
+     * @param options Options including messageId and reactionType
      * @returns Success indicator
      *
      * @example
      * ```typescript
      * await reactionService.removeReactionFromChatMessage({
-     *   tokenName: 'mytoken',
      *   messageId: 'msg-1703443200000-a1b2c3d4e5f6789012345678901234ab',
      *   reactionType: 'fire'
      * });
@@ -140,13 +130,12 @@ export declare class ContentReactionService extends StreamTokenServiceBase {
      *
      * Convenience wrapper for addContentReaction specifically for comments.
      *
-     * @param options Options including tokenName, messageId, and reactionType
+     * @param options Options including messageId and reactionType
      * @returns Updated reaction data
      *
      * @example
      * ```typescript
      * await reactionService.addReactionToComment({
-     *   tokenName: 'mytoken',
      *   messageId: 'msg-1703443200000-a1b2c3d4e5f6789012345678901234ab',
      *   reactionType: 'thumbs_up'
      * });
@@ -158,13 +147,12 @@ export declare class ContentReactionService extends StreamTokenServiceBase {
      *
      * Convenience wrapper for removeContentReaction specifically for comments.
      *
-     * @param options Options including tokenName, messageId, and reactionType
+     * @param options Options including messageId and reactionType
      * @returns Success indicator
      *
      * @example
      * ```typescript
      * await reactionService.removeReactionFromComment({
-     *   tokenName: 'mytoken',
      *   messageId: 'msg-1703443200000-a1b2c3d4e5f6789012345678901234ab',
      *   reactionType: 'thumbs_up'
      * });

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

@@ -1 +1 @@
-{"version":3,"file":"ContentReactionService.d.ts","sourceRoot":"","sources":["../../src/services/ContentReactionService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EAGS,4BAA4B,EAC7D,2BAA2B,EAAC,MAAM,gCAAgC,CAAC;AAKrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,sBAAuB,SAAQ,sBAAsB;gBAE9D,IAAI,EAAE,UAAU,EAChB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,OAAO,EACjB,SAAS,GAAE,OAAe,EAC1B,UAAU,CAAC,EAAE,MAAM;IASrB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAIjC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAc5B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAkC/F;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,2BAA2B,CAAC;IA6BxG;;;;;;;;;;;;;;;;OAgBG;IACG,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIrG;;;;;;;;;;;;;;;;OAgBG;IACG,6BAA6B,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAQhH;;;;;;;;;;;;;;;;OAgBG;IACG,oBAAoB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIjG;;;;;;;;;;;;;;;;OAgBG;IACG,yBAAyB,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,2BAA2B,CAAC;CAG7G"}
+{"version":3,"file":"ContentReactionService.d.ts","sourceRoot":"","sources":["../../src/services/ContentReactionService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EAGS,4BAA4B,EAC7D,2BAA2B,EAAC,MAAM,gCAAgC,CAAC;AAKrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,sBAAuB,SAAQ,sBAAsB;gBAE9D,IAAI,EAAE,UAAU,EAChB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,OAAO,EACjB,SAAS,GAAE,OAAe,EAC1B,UAAU,CAAC,EAAE,MAAM;IASrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAc5B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IA6B/F;;;;;;;;;;;;;;;;;;;OAmBG;IACG,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,2BAA2B,CAAC;IA0BxG;;;;;;;;;;;;;;;OAeG;IACG,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIrG;;;;;;;;;;;;;;;OAeG;IACG,6BAA6B,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAQhH;;;;;;;;;;;;;;;OAeG;IACG,oBAAoB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIjG;;;;;;;;;;;;;;;OAeG;IACG,yBAAyB,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,2BAA2B,CAAC;CAG7G"}

package/dist/services/EventsQueryService.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Events Query Service
+ *
+ * Reads of stored events (`GET /v1/events`) and their aggregate statistics
+ * (`GET /v1/events/stats`). Both routes are Admin API key or Overseer (JWT) and answer a BARE body,
+ * not the `{ data }` envelope most routes use. Event submission is `EventsBatcherService`.
+ *
+ * @category Services
+ * @since 9.0.0
+ */
+import type { JwtAuth } from '../auth/JwtAuth';
+import { type EventStats, type QueryEventsOptions, type QueryEventsResult } from '../types/events.dto';
+import type { HttpClient } from '../utils/http';
+import { StreamTokenServiceBase } from './StreamTokenServiceBase';
+/**
+ * Reads stored events and their statistics (Admin API key or Overseer JWT).
+ *
+ * @example
+ * ```typescript
+ * const events = new EventsQueryService(httpClient, undefined, jwtAuth);
+ * const stats = await events.getEventStats();
+ * const page = await events.queryEvents({ eventTypes: ['token_buy'], page: 1, limit: 50 });
+ * ```
+ */
+export declare class EventsQueryService extends StreamTokenServiceBase {
+    constructor(http: HttpClient, adminApiKey?: string, jwtAuth?: JwtAuth, debugMode?: boolean, userApiKey?: string);
+    /**
+     * Aggregate event statistics for the dashboard cards.
+     *
+     * @throws ConfigurationError when neither an admin API key nor a JWT is configured
+     * @throws NetworkError when the request fails or the body is not the statistics shape
+     * @since 9.0.0
+     */
+    getEventStats(): Promise<EventStats>;
+    /**
+     * One page of stored events (offset paging: `page`, `limit`).
+     *
+     * Only the filters given are sent. `eventTypes` / `categories` go as repeated array parameters.
+     *
+     * @throws ValidationError for a limit outside 1..100, a page below 1 or an unknown sort / preset / source
+     * @throws ConfigurationError when neither an admin API key nor a JWT is configured
+     * @throws NetworkError when the request fails or the body is not the events shape
+     * @since 9.0.0
+     */
+    queryEvents(options?: QueryEventsOptions): Promise<QueryEventsResult>;
+}
+//# sourceMappingURL=EventsQueryService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EventsQueryService.d.ts","sourceRoot":"","sources":["../../src/services/EventsQueryService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AA2FlE;;;;;;;;;GASG;AACH,qBAAa,kBAAmB,SAAQ,sBAAsB;gBAE1D,IAAI,EAAE,UAAU,EAChB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,OAAO,EACjB,SAAS,GAAE,OAAe,EAC1B,UAAU,CAAC,EAAE,MAAM;IAKrB;;;;;;OAMG;IACG,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IAK1C;;;;;;;;;OASG;IACG,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAwBhF"}

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;AAqB3B,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;IAkChC;;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"}