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

package/CHANGELOG.md

@@ -1,12 +1,27 @@
 # @suigar/sdk
 
+## 2.0.0-beta.13
+
+### Patch Changes
+
+- 667d7c4: Normalize authored repository wording to use `on-chain` consistently.
+
+## 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
 
-- c7685d2: Add `client.suigar.getGameParameters(game, options?)` for reading live onchain game parameter objects, such as min/max stake and game-specific config bounds, directly from SweetHouse settings.
+- c7685d2: Add `client.suigar.getGameParameters(game, options?)` for reading live on-chain game parameter objects, such as min/max stake and game-specific config bounds, directly from SweetHouse settings.
 
-  The lookup first reads the selected game's settings object from SweetHouse, then reads that game's coin-specific `Parameters<T>` object, parses it with the correct return type for the requested game, and caches the result for SDK integrations that need to display or validate current game limits without repeatedly querying the same onchain objects.
+  The lookup first reads the selected game's settings object from SweetHouse, then reads that game's coin-specific `Parameters<T>` object, parses it with the correct return type for the requested game, and caches the result for SDK integrations that need to display or validate current game limits without repeatedly querying the same on-chain objects.
 
   This update also broadens the public numeric helpers in `@suigar/sdk/utils`: `toBigInt()` accepts booleans and non-negative integer strings in addition to numbers and `bigint`, `toU8()` accepts plain integer strings such as `'1'` for parsed config ids and other `u8` values, and `toU16()` provides the same validation pattern for `u16` values.
 
@@ -14,7 +29,7 @@
 
 ### Patch Changes
 
-- 4b59c7b: Remove the `client.suigar.resolvePvPConflipGame()` client method. Use the exported generated helper `client.suigar.bcs.PvPCoinflipGame.get({ client, objectId })` for one specific live PvP coinflip game object instead.
+- 4b59c7b: Remove the `client.suigar.resolvePvPCoinflipGame()` client method. Use the exported generated helper `client.suigar.bcs.PvPCoinflipGame.get({ client, objectId })` for one specific live PvP coinflip game object instead.
 
   Add `parseCoinType` to `@suigar/sdk/utils` for extracting normalized coin types from generic Move object type strings.
 
@@ -40,7 +55,7 @@
 - a2aa324: Update PvP coinflip lookup helpers to use bulk object reads for unresolved lobby discovery and support forwarded lookup options.
   - Make `getPvPCoinflipGames()` parse bulk `client.core.getObjects()` results instead of resolving each game individually.
   - Skip per-object fetch or parse failures by default and continue supporting strict rejection with `throwOnError: true`.
-  - Forward supported lookup options such as `signal` through `getPvPCoinflipGames()` and `resolvePvPConflipGame(gameId, options?)`.
+  - Forward supported lookup options such as `signal` through `getPvPCoinflipGames()` and `resolvePvPCoinflipGame(gameId, options?)`.
   - Update tests, README guidance, and repo-local PvP skill documentation to match the current client behavior.
 
 ## 2.0.0-beta.7
@@ -85,7 +100,7 @@
 
   Document the PvP coinflip runtime helpers more clearly by describing
   registry-backed unresolved game discovery through `getPvPCoinflipGames()` and
-  the normalized live-game lookup behavior of `resolvePvPConflipGame()`.
+  the normalized live-game lookup behavior of `resolvePvPCoinflipGame()`.
 
 - 4861f55: Add public utility exports for shared scaling constants in `@suigar/sdk/utils`, including `RANGE_POINT_LIMIT` and `DEFAULT_RANGE_SCALE`. Update the SDK example app and documentation to use the exported constants and document limbo/range scaling behavior more clearly.
 

package/README.md

@@ -56,17 +56,24 @@ 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
+  preserving the original on-chain keys
 
 Game-specific type exports are available from the dedicated `games` subpath:
 
@@ -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
@@ -137,7 +147,7 @@ client.suigar;
 ```
 
 Do not pass a partner slug, label, or display name here. Use the wallet
-address that should receive partner attribution onchain.
+address that should receive partner attribution on-chain.
 
 You can rename the extension:
 
@@ -167,11 +177,11 @@ Supported override areas:
 - `cacheTtl`
 
 If `partner` is configured, the SDK automatically writes that partner wallet
-address into the onchain metadata vec-map. Transaction builder options may also
+address into the on-chain metadata vec-map. Transaction builder options may also
 include `metadata`, but reserved keys such as `partner` and `referrer` are
 ignored with a warning when provided manually.
 
-`cacheTtl` controls the SDK cache for onchain reads such as parsed game
+`cacheTtl` controls the SDK cache for on-chain reads such as parsed game
 parameters. It is expressed in milliseconds and defaults to 30 minutes.
 
 ## Runtime Surface
@@ -206,7 +216,7 @@ console.log(config.packageIds);
 
 ### `getGameParameters(game, options?)`
 
-Returns the onchain `Parameters<T>` object for any supported game and coin type.
+Returns the on-chain `Parameters<T>` object for any supported game and coin type.
 The return type is inferred from `game`.
 
 The SDK first reads the selected game's settings object from the configured
@@ -227,7 +237,7 @@ const parameters = await client.suigar.getGameParameters('coinflip', {
 console.log(parameters.min_stake);
 ```
 
-Pass `ignoreCache: true` to refresh the onchain read and replace the cached
+Pass `ignoreCache: true` to refresh the on-chain read and replace the cached
 value.
 
 ### `serializeTransactionToBase64(transaction, options?)`
@@ -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'`
@@ -352,7 +368,7 @@ const rangeTx = client.suigar.tx.createBetTransaction('range', {
 > **Note:**
 >
 > - limbo converts `targetMultiplier` with `Math.round(targetMultiplier * scale)`
-> - with the default limbo scale `100`, exposed as `DEFAULT_LIMBO_MULTIPLIER_SCALE`, a target multiplier of `2.5` becomes `250` onchain
+> - with the default limbo scale `100`, exposed as `DEFAULT_LIMBO_MULTIPLIER_SCALE`, a target multiplier of `2.5` becomes `250` on-chain
 > - range converts each point with `Math.round(value * scale)`
 > - range points are bounded by the contract limit exposed as `RANGE_POINT_LIMIT`
 > - with the default range scale `1_000_000`, exposed as `DEFAULT_RANGE_SCALE`, valid UI values are `0` to `100`
@@ -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
@@ -512,7 +534,7 @@ const decoded = client.suigar.bcs.BetResultEvent.parse(event.bcs);
 const gameDetails = parseGameDetails(decoded.game_details);
 ```
 
-`parseGameDetails` preserves the onchain keys and only changes the value representation. For example, coinflip details keep keys such as `player_bet` and `coin_outcome`; range details keep keys such as `roll_value`, `win`, and `payout_multiplier`.
+`parseGameDetails` preserves the on-chain keys and only changes the value representation. For example, coinflip details keep keys such as `player_bet` and `coin_outcome`; range details keep keys such as `roll_value`, `win`, and `payout_multiplier`.
 
 When the extension is configured with `partner`, decoded event `metadata` will
 contain that partner wallet address under the `partner` entry.

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);
   }
@@ -1439,7 +1441,7 @@ var SuigarClient = class {
    * The SDK first reads the selected game's settings object from SweetHouse,
    * then reads that game's coin-specific `Parameters<T>` object. Results are
    * cached according to the extension `cacheTtl` option. Pass
-   * `ignoreCache: true` to refresh the onchain read and replace the cached
+   * `ignoreCache: true` to refresh the on-chain read and replace the cached
    * value.
    *
    * @param game Game whose parameters should be loaded.
@@ -1458,7 +1460,7 @@ var SuigarClient = class {
   }
   /**
    * Lists unresolved PvP coinflip games from the configured registry and resolves
-   * each entry into parsed onchain game state.
+   * each entry into parsed on-chain game state.
    *
    * This fetches dynamic fields from the PvP coinflip registry object, then bulk
    * loads the referenced game objects through `client.core.getObjects()`. Registry
@@ -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.d.cts

@@ -243,7 +243,7 @@ declare class SuigarClient {
      * The SDK first reads the selected game's settings object from SweetHouse,
      * then reads that game's coin-specific `Parameters<T>` object. Results are
      * cached according to the extension `cacheTtl` option. Pass
-     * `ignoreCache: true` to refresh the onchain read and replace the cached
+     * `ignoreCache: true` to refresh the on-chain read and replace the cached
      * value.
      *
      * @param game Game whose parameters should be loaded.
@@ -253,7 +253,7 @@ declare class SuigarClient {
     getGameParameters<TGame extends Game>(game: TGame, options?: GetGameParametersOptions): Promise<GameParameters<TGame>>;
     /**
      * Lists unresolved PvP coinflip games from the configured registry and resolves
-     * each entry into parsed onchain game state.
+     * each entry into parsed on-chain game state.
      *
      * This fetches dynamic fields from the PvP coinflip registry object, then bulk
      * loads the referenced game objects through `client.core.getObjects()`. Registry

package/dist/index.d.ts

@@ -243,7 +243,7 @@ declare class SuigarClient {
      * The SDK first reads the selected game's settings object from SweetHouse,
      * then reads that game's coin-specific `Parameters<T>` object. Results are
      * cached according to the extension `cacheTtl` option. Pass
-     * `ignoreCache: true` to refresh the onchain read and replace the cached
+     * `ignoreCache: true` to refresh the on-chain read and replace the cached
      * value.
      *
      * @param game Game whose parameters should be loaded.
@@ -253,7 +253,7 @@ declare class SuigarClient {
     getGameParameters<TGame extends Game>(game: TGame, options?: GetGameParametersOptions): Promise<GameParameters<TGame>>;
     /**
      * Lists unresolved PvP coinflip games from the configured registry and resolves
-     * each entry into parsed onchain game state.
+     * each entry into parsed on-chain game state.
      *
      * This fetches dynamic fields from the PvP coinflip registry object, then bulk
      * loads the referenced game objects through `client.core.getObjects()`. Registry

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);
   }
@@ -1220,7 +1220,7 @@ var SuigarClient = class {
    * The SDK first reads the selected game's settings object from SweetHouse,
    * then reads that game's coin-specific `Parameters<T>` object. Results are
    * cached according to the extension `cacheTtl` option. Pass
-   * `ignoreCache: true` to refresh the onchain read and replace the cached
+   * `ignoreCache: true` to refresh the on-chain read and replace the cached
    * value.
    *
    * @param game Game whose parameters should be loaded.
@@ -1239,7 +1239,7 @@ var SuigarClient = class {
   }
   /**
    * Lists unresolved PvP coinflip games from the configured registry and resolves
-   * each entry into parsed onchain game state.
+   * each entry into parsed on-chain game state.
    *
    * This fetches dynamic fields from the PvP coinflip registry object, then bulk
    * loads the referenced game objects through `client.core.getObjects()`. Registry
@@ -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.d.cts

@@ -145,7 +145,7 @@ declare function fromMoveI64(i64: MoveFloat['exp']): number;
  *
  * Suigar float values are represented as a sign flag, an unsigned mantissa,
  * and a Move `i64` exponent. This helper rebuilds the numeric value using the
- * same normalization expected by the onchain format and applies the sign at
+ * same normalization expected by the on-chain format and applies the sign at
  * the end. Missing mantissas are treated as `0`, and a zero mantissa returns `0`.
  *
  * @param float Generated Move float value with `mant`, `exp`, and `is_negative`.
@@ -169,7 +169,7 @@ declare function parseCoinType(type: string): string;
  * Suigar stores game detail entries as `VecMap<string, vector<u8>>`, so raw BCS
  * decoding leaves each value as bytes. This helper looks up the known schema for
  * each key, parses the bytes into the expected runtime type, and preserves the
- * original onchain keys in the returned object. Unknown keys fall back to
+ * original on-chain keys in the returned object. Unknown keys fall back to
  * string decoding so newer detail fields remain readable by default.
  *
  * @param gameDetails Raw `game_details` map from a decoded bet result event.

package/dist/utils.d.ts

@@ -145,7 +145,7 @@ declare function fromMoveI64(i64: MoveFloat['exp']): number;
  *
  * Suigar float values are represented as a sign flag, an unsigned mantissa,
  * and a Move `i64` exponent. This helper rebuilds the numeric value using the
- * same normalization expected by the onchain format and applies the sign at
+ * same normalization expected by the on-chain format and applies the sign at
  * the end. Missing mantissas are treated as `0`, and a zero mantissa returns `0`.
  *
  * @param float Generated Move float value with `mant`, `exp`, and `is_negative`.
@@ -169,7 +169,7 @@ declare function parseCoinType(type: string): string;
  * Suigar stores game detail entries as `VecMap<string, vector<u8>>`, so raw BCS
  * decoding leaves each value as bytes. This helper looks up the known schema for
  * each key, parses the bytes into the expected runtime type, and preserves the
- * original onchain keys in the returned object. Unknown keys fall back to
+ * original on-chain keys in the returned object. Unknown keys fall back to
  * string decoding so newer detail fields remain readable by default.
  *
  * @param gameDetails Raw `game_details` map from a decoded bet result event.

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.13",
   "description": "TypeScript SDK for Suigar v2 Move contracts on Sui.",
   "keywords": [
     "suigar",