@suigar/sdk 2.0.0-beta.11 → 2.0.0-beta.12

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @suigar/sdk
 
+## 2.0.0-beta.12
+
+### Patch Changes
+
+- 85ae057: Refine public validation failures to use `RangeError` and `TypeError` instead
+  of generic `Error` for unsupported networks, unsupported game or PvP action
+  inputs, unsupported configured coin types, bounded integer helpers, and
+  `parseCoinType()` parsing failures.
+
 ## 2.0.0-beta.11
 
 ### Patch Changes

package/README.md

@@ -56,14 +56,21 @@ Numeric helper behavior:
 
 - `toBigInt(value)` accepts `bigint`, finite `number`, non-negative integer
   `string`, and `boolean` inputs and returns a normalized non-negative `bigint`
+  while throwing `TypeError` for invalid input shapes and `RangeError` for
+  negative values
 - `toU8(value)` accepts a finite integer `number` or plain integer `string` in
-  the inclusive `0..255` range and rejects booleans or fractional values
+  the inclusive `0..255` range, throwing `TypeError` for non-numeric input and
+  `RangeError` for booleans, fractional values, or out-of-range integers
 - `toU16(value)` accepts a finite integer `number` or plain integer `string`
-  in the inclusive `0..65535` range and rejects booleans or fractional values
+  in the inclusive `0..65535` range, throwing `TypeError` for non-numeric
+  input and `RangeError` for booleans, fractional values, or out-of-range
+  integers
 - `fromMoveI64(value)` converts a generated Move `i64` wrapper into a
   JavaScript `number`
 - `fromMoveFloat(value)` converts a generated Move float struct into a
   JavaScript `number`
+- `parseCoinType(type)` extracts the normalized first generic coin type from a
+  Move object type string and throws `TypeError` when no coin type can be parsed
 - `parseGameDetails(gameDetails)` decodes standard `BetResultEvent.game_details`
   byte arrays into the expected string, number, and boolean values while
   preserving the original onchain keys
@@ -122,6 +129,9 @@ const base64 = await client.suigar.serializeTransactionToBase64(tx);
 
 Creates a named Sui client extension. By default, it registers under `client.suigar`.
 
+The extension constructor throws `RangeError` when the connected client network
+is not one of the SDK's supported Sui networks.
+
 ### Partner Setup
 
 > **Important:** `partner` is the partner wallet address. Configure it once
@@ -321,6 +331,12 @@ Shared behavior:
 - the SDK resolves the price info object from the configured supported-coin mapping
 - the reward object is transferred back to `playerAddress`
 
+Error behavior:
+
+- `RangeError` when `gameId` is unsupported
+- `RangeError` when `coinType` is not in the resolved supported-coin config for the active network
+- `RangeError` from bounded numeric helpers such as `toU8()` when `plinko` or `wheel` `configId` is out of range or not an integer
+
 Per-game options:
 
 - `coinflip`: `side: 'heads' | 'tails'`
@@ -420,6 +436,11 @@ Action-specific options:
 - `join`: `gameId`
 - `cancel`: `gameId`
 
+Error behavior:
+
+- `RangeError` when `action` is unsupported
+- `RangeError` when `coinType` is not in the resolved supported-coin config for the active network
+
 ## `bcs`
 
 BCS helpers live under `client.suigar.bcs`.
@@ -438,6 +459,7 @@ These are generated Move event decoders. Use them to parse Suigar event payloads
 - `fromMoveI64(float.exp)` converts a generated Move `i64` exponent to a JavaScript number
 - `fromMoveFloat(float)` converts a generated Move `Float` struct to a JavaScript number
 - `parseCoinType(type)` extracts the normalized coin type from generic Move object type strings such as PvP coinflip `Game<T>`
+  and throws `TypeError` when the type string does not include a first generic coin type
 - `parseGameDetails(game_details)` decodes `BetResultEvent.game_details` entries into the expected string, number, and boolean values
 
 ### Parse PvP Coinflip Game Object Data

package/dist/{chunk-TBJ5TYYE.js → chunk-7N55D2TV.js}

@@ -40,7 +40,9 @@ function toBoundedInt(value, max, typeName) {
   const num = typeof value === "string" && value.trim() === "" ? NaN : Number(value);
   assertFiniteNumber(num, "Value must be a finite number or integer string");
   if (typeof value === "boolean" || value == null || !Number.isInteger(num) || num < 0 || num > max) {
-    throw new Error(`Value must be a ${typeName} integer (0-${max}): ${value}`);
+    throw new RangeError(
+      `Value must be a ${typeName} integer (0-${max}): ${value}`
+    );
   }
   return num;
 }
@@ -302,7 +304,7 @@ function fromMoveFloat(float) {
 function parseCoinType(type) {
   const coinType = parseStructTag(type).typeParams[0];
   if (!coinType) {
-    throw new Error(`Unable to parse coin type from ${type}`);
+    throw new TypeError(`Unable to parse coin type from ${type}`);
   }
   return normalizeStructTag(coinType);
 }

package/dist/index.cjs

@@ -485,7 +485,7 @@ function resolvePriceInfoObjectId(config, coinType) {
 function resolveSupportedCoin(config, coinType) {
   const [supportedCoin] = Object.entries(config.coinTypes).find(([_, value]) => value === coinType) ?? [];
   if (!supportedCoin) {
-    throw new Error(
+    throw new RangeError(
       `Unsupported coin type ${coinType}. Supported coin types: ${Object.values(
         config.coinTypes
       ).join(", ")}`
@@ -627,7 +627,9 @@ function toBoundedInt(value, max, typeName) {
   const num = typeof value === "string" && value.trim() === "" ? NaN : Number(value);
   assertFiniteNumber(num, "Value must be a finite number or integer string");
   if (typeof value === "boolean" || value == null || !Number.isInteger(num) || num < 0 || num > max) {
-    throw new Error(`Value must be a ${typeName} integer (0-${max}): ${value}`);
+    throw new RangeError(
+      `Value must be a ${typeName} integer (0-${max}): ${value}`
+    );
   }
   return num;
 }
@@ -652,7 +654,7 @@ new TextDecoder();
 function parseCoinType(type) {
   const coinType = utils.parseStructTag(type).typeParams[0];
   if (!coinType) {
-    throw new Error(`Unable to parse coin type from ${type}`);
+    throw new TypeError(`Unable to parse coin type from ${type}`);
   }
   return utils.normalizeStructTag(coinType);
 }
@@ -1036,7 +1038,7 @@ function buildPvPCoinflipTransaction(action, options) {
       return tx;
     }
     default:
-      throw new Error(`Unsupported PvP coinflip action: ${action}`);
+      throw new RangeError(`Unsupported PvP coinflip action: ${action}`);
   }
 }
 var $moduleName18 = "0xf391858d2a08473e8d4defcc8df89976bd7b123d3865c6b9341b237f7853dbbc::i64";
@@ -1402,7 +1404,7 @@ var SuigarClient = class {
     });
     const network = this.#client.network;
     if (!SUPPORTED_SUI_NETWORKS.includes(network)) {
-      throw new Error(`Unsupported network: ${network}`);
+      throw new RangeError(`Unsupported network: ${network}`);
     }
     this.#config = resolveSuigarConfig(network);
   }
@@ -1520,41 +1522,6 @@ var SuigarClient = class {
       (game) => game instanceof Error ? [] : [game]
     );
   }
-  async #fetchGameParameters(game, coinType, signal) {
-    const gameDefinition = GAME_SETTINGS[game];
-    const { object: settingsObject } = await this.#client.core.getDynamicObjectField({
-      parentId: this.#config.packageIds.sweetHouse,
-      name: {
-        type: resolveGameSettingsKeyType(
-          gameDefinition.settingsKey.name,
-          resolveGamePackageId(this.#config, game)
-        ),
-        bcs: gameDefinition.settingsKey.serialize({ dummy_field: false }).toBytes()
-      },
-      signal
-    });
-    const { object } = await this.#client.core.getDynamicObjectField({
-      parentId: settingsObject.objectId,
-      name: {
-        type: TypeName.name,
-        bcs: TypeName.serialize({
-          name: resolveCoinTypeNameForTypeNameKey(coinType)
-        }).toBytes()
-      },
-      include: {
-        content: true
-      },
-      signal
-    });
-    if (!object?.content) {
-      throw new Error(
-        `Missing parameters object content for ${game} and coin type ${coinType}`
-      );
-    }
-    return gameDefinition.parameters.parse(
-      object.content
-    );
-  }
   /**
    * BCS struct constructors for decoding on-chain objects and events related to Suigar games.
    *
@@ -1633,7 +1600,7 @@ var SuigarClient = class {
             partner: this.#partner
           });
         default:
-          throw new Error(`Unsupported game: ${gameId}`);
+          throw new RangeError(`Unsupported game: ${gameId}`);
       }
     },
     /**
@@ -1667,7 +1634,7 @@ var SuigarClient = class {
             partner: this.#partner
           });
         default:
-          throw new Error(`Unsupported PvP coinflip action: ${action}`);
+          throw new RangeError(`Unsupported PvP coinflip action: ${action}`);
       }
     }
   };
@@ -1684,6 +1651,41 @@ var SuigarClient = class {
       });
     };
   }
+  async #fetchGameParameters(game, coinType, signal) {
+    const gameDefinition = GAME_SETTINGS[game];
+    const { object: settingsObject } = await this.#client.core.getDynamicObjectField({
+      parentId: this.#config.packageIds.sweetHouse,
+      name: {
+        type: resolveGameSettingsKeyType(
+          gameDefinition.settingsKey.name,
+          resolveGamePackageId(this.#config, game)
+        ),
+        bcs: gameDefinition.settingsKey.serialize({ dummy_field: false }).toBytes()
+      },
+      signal
+    });
+    const { object } = await this.#client.core.getDynamicObjectField({
+      parentId: settingsObject.objectId,
+      name: {
+        type: TypeName.name,
+        bcs: TypeName.serialize({
+          name: resolveCoinTypeNameForTypeNameKey(coinType)
+        }).toBytes()
+      },
+      include: {
+        content: true
+      },
+      signal
+    });
+    if (!object?.content) {
+      throw new Error(
+        `Missing parameters object content for ${game} and coin type ${coinType}`
+      );
+    }
+    return gameDefinition.parameters.parse(
+      object.content
+    );
+  }
 };
 
 exports.SuigarClient = SuigarClient;

package/dist/index.js

@@ -1,4 +1,4 @@
-import { MoveStruct, Float, parseCoinType, toBigInt, toU8, DEFAULT_GAS_BUDGET_MIST, normalizeMoveArguments, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE } from './chunk-TBJ5TYYE.js';
+import { MoveStruct, Float, parseCoinType, toBigInt, toU8, DEFAULT_GAS_BUDGET_MIST, normalizeMoveArguments, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE } from './chunk-7N55D2TV.js';
 import { toBase64, normalizeStructTag, parseStructTag, normalizeSuiAddress, fromHex } from '@mysten/sui/utils';
 import { bcs } from '@mysten/sui/bcs';
 import { Transaction } from '@mysten/sui/transactions';
@@ -325,7 +325,7 @@ function resolvePriceInfoObjectId(config, coinType) {
 function resolveSupportedCoin(config, coinType) {
   const [supportedCoin] = Object.entries(config.coinTypes).find(([_, value]) => value === coinType) ?? [];
   if (!supportedCoin) {
-    throw new Error(
+    throw new RangeError(
       `Unsupported coin type ${coinType}. Supported coin types: ${Object.values(
         config.coinTypes
       ).join(", ")}`
@@ -817,7 +817,7 @@ function buildPvPCoinflipTransaction(action, options) {
       return tx;
     }
     default:
-      throw new Error(`Unsupported PvP coinflip action: ${action}`);
+      throw new RangeError(`Unsupported PvP coinflip action: ${action}`);
   }
 }
 var $moduleName16 = "0xf391858d2a08473e8d4defcc8df89976bd7b123d3865c6b9341b237f7853dbbc::i64";
@@ -1183,7 +1183,7 @@ var SuigarClient = class {
     });
     const network = this.#client.network;
     if (!SUPPORTED_SUI_NETWORKS.includes(network)) {
-      throw new Error(`Unsupported network: ${network}`);
+      throw new RangeError(`Unsupported network: ${network}`);
     }
     this.#config = resolveSuigarConfig(network);
   }
@@ -1301,41 +1301,6 @@ var SuigarClient = class {
       (game) => game instanceof Error ? [] : [game]
     );
   }
-  async #fetchGameParameters(game, coinType, signal) {
-    const gameDefinition = GAME_SETTINGS[game];
-    const { object: settingsObject } = await this.#client.core.getDynamicObjectField({
-      parentId: this.#config.packageIds.sweetHouse,
-      name: {
-        type: resolveGameSettingsKeyType(
-          gameDefinition.settingsKey.name,
-          resolveGamePackageId(this.#config, game)
-        ),
-        bcs: gameDefinition.settingsKey.serialize({ dummy_field: false }).toBytes()
-      },
-      signal
-    });
-    const { object } = await this.#client.core.getDynamicObjectField({
-      parentId: settingsObject.objectId,
-      name: {
-        type: TypeName.name,
-        bcs: TypeName.serialize({
-          name: resolveCoinTypeNameForTypeNameKey(coinType)
-        }).toBytes()
-      },
-      include: {
-        content: true
-      },
-      signal
-    });
-    if (!object?.content) {
-      throw new Error(
-        `Missing parameters object content for ${game} and coin type ${coinType}`
-      );
-    }
-    return gameDefinition.parameters.parse(
-      object.content
-    );
-  }
   /**
    * BCS struct constructors for decoding on-chain objects and events related to Suigar games.
    *
@@ -1414,7 +1379,7 @@ var SuigarClient = class {
             partner: this.#partner
           });
         default:
-          throw new Error(`Unsupported game: ${gameId}`);
+          throw new RangeError(`Unsupported game: ${gameId}`);
       }
     },
     /**
@@ -1448,7 +1413,7 @@ var SuigarClient = class {
             partner: this.#partner
           });
         default:
-          throw new Error(`Unsupported PvP coinflip action: ${action}`);
+          throw new RangeError(`Unsupported PvP coinflip action: ${action}`);
       }
     }
   };
@@ -1465,6 +1430,41 @@ var SuigarClient = class {
       });
     };
   }
+  async #fetchGameParameters(game, coinType, signal) {
+    const gameDefinition = GAME_SETTINGS[game];
+    const { object: settingsObject } = await this.#client.core.getDynamicObjectField({
+      parentId: this.#config.packageIds.sweetHouse,
+      name: {
+        type: resolveGameSettingsKeyType(
+          gameDefinition.settingsKey.name,
+          resolveGamePackageId(this.#config, game)
+        ),
+        bcs: gameDefinition.settingsKey.serialize({ dummy_field: false }).toBytes()
+      },
+      signal
+    });
+    const { object } = await this.#client.core.getDynamicObjectField({
+      parentId: settingsObject.objectId,
+      name: {
+        type: TypeName.name,
+        bcs: TypeName.serialize({
+          name: resolveCoinTypeNameForTypeNameKey(coinType)
+        }).toBytes()
+      },
+      include: {
+        content: true
+      },
+      signal
+    });
+    if (!object?.content) {
+      throw new Error(
+        `Missing parameters object content for ${game} and coin type ${coinType}`
+      );
+    }
+    return gameDefinition.parameters.parse(
+      object.content
+    );
+  }
 };
 
 export { SuigarClient, suigar };

package/dist/utils.cjs

@@ -42,7 +42,9 @@ function toBoundedInt(value, max, typeName) {
   const num = typeof value === "string" && value.trim() === "" ? NaN : Number(value);
   assertFiniteNumber(num, "Value must be a finite number or integer string");
   if (typeof value === "boolean" || value == null || !Number.isInteger(num) || num < 0 || num > max) {
-    throw new Error(`Value must be a ${typeName} integer (0-${max}): ${value}`);
+    throw new RangeError(
+      `Value must be a ${typeName} integer (0-${max}): ${value}`
+    );
   }
   return num;
 }
@@ -192,7 +194,7 @@ function fromMoveFloat(float) {
 function parseCoinType(type) {
   const coinType = utils.parseStructTag(type).typeParams[0];
   if (!coinType) {
-    throw new Error(`Unable to parse coin type from ${type}`);
+    throw new TypeError(`Unable to parse coin type from ${type}`);
   }
   return utils.normalizeStructTag(coinType);
 }

package/dist/utils.js

@@ -1 +1 @@
-export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT, fromMoveFloat, fromMoveI64, parseCoinType, parseGameDetails, toBigInt, toU16, toU8 } from './chunk-TBJ5TYYE.js';
+export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT, fromMoveFloat, fromMoveI64, parseCoinType, parseGameDetails, toBigInt, toU16, toU8 } from './chunk-7N55D2TV.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suigar/sdk",
-  "version": "2.0.0-beta.11",
+  "version": "2.0.0-beta.12",
   "description": "TypeScript SDK for Suigar v2 Move contracts on Sui.",
   "keywords": [
     "suigar",