@suigar/sdk 2.0.0-beta.5 → 2.0.0-beta.7

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @suigar/sdk
 
+## 2.0.0-beta.7
+
+### Patch Changes
+
+- f0ea104: Align numeric utility names, Move decoding helpers, and PvP BCS event helper references with the current SDK API.
+
+## 2.0.0-beta.6
+
+### Patch Changes
+
+- ef6bcd4: Rename getPvPCoinflipGames option from rejectOnError to throwOnError.
+
 ## 2.0.0-beta.5
 
 ### Patch Changes

package/README.md

@@ -42,11 +42,11 @@ import {
 	DEFAULT_LIMBO_MULTIPLIER_SCALE,
 	DEFAULT_RANGE_SCALE,
 	RANGE_POINT_LIMIT,
-	parseFloat,
+	fromMoveFloat,
+	fromMoveI64,
 	parseGameDetails,
-	parseI64,
-	toBigIntAmount,
-	toU8Number,
+	toBigInt,
+	toU8,
 } from '@suigar/sdk/utils';
 ```
 
@@ -109,10 +109,9 @@ Creates a named Sui client extension. By default, it registers under `client.sui
 
 ### Partner Setup
 
-> [!IMPORTANT]
-> `partner` is the partner wallet address. Configure it once when you
-> register the extension so the SDK can append that wallet address to supported
-> bet metadata automatically.
+> **Important:** `partner` is the partner wallet address. Configure it once
+> when you register the extension so the SDK can append that wallet address to
+> supported bet metadata automatically.
 
 ```ts
 const client = new SuiGrpcClient({ baseUrl, network }).$extend(
@@ -210,7 +209,7 @@ browsing or lobby views.
 
 By default, failures to resolve an individual game are skipped so one broken or
 already-deleted registry entry does not reject the full lookup. Pass
-`rejectOnError: true` if you want the call to reject instead.
+`throwOnError: true` if you want the call to reject instead.
 
 ```ts
 const games = await client.suigar.getPvPCoinflipGames({ limit: 20 });
@@ -224,7 +223,7 @@ for (const game of games) {
 ```ts
 const games = await client.suigar.getPvPCoinflipGames({
 	limit: 20,
-	rejectOnError: true,
+	throwOnError: true,
 });
 ```
 
@@ -250,14 +249,14 @@ console.log(game.stake_per_player);
 console.log(game.is_private);
 ```
 
-> [!NOTE]
+> **Note:**
 >
 > - it throws if the object response does not include decodable `content`
 > - the PvP join builder uses this internally to derive the required join stake
-> - after a game is joined and resolved, the live `Game` object is removed from the registry and deleted, so inspect `PvPCoinflipGameResolved` to read the final result
+> - after a game is joined and resolved, the live `Game` object is removed from the registry and deleted, so inspect `PvPCoinflipGameResolvedEvent` to read the final result
 
-> [!TIP]
-> Prefer this helper over manual object parsing when you only need the parsed state for a live PvP coinflip game object.
+> **Tip:** Prefer this helper over manual object parsing when you only need the
+> parsed state for a live PvP coinflip game object.
 
 ## `tx`
 
@@ -334,7 +333,7 @@ const rangeTx = client.suigar.tx.createBetTransaction('range', {
 });
 ```
 
-> [!NOTE]
+> **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
@@ -343,7 +342,7 @@ const rangeTx = client.suigar.tx.createBetTransaction('range', {
 > - with the default range scale `1_000_000`, exposed as `DEFAULT_RANGE_SCALE`, valid UI values are `0` to `100`
 > - plinko and wheel `configId` must fit in `u8`
 
-> [!TIP]
+> **Tip:**
 >
 > - if you set `scale` to `10_000_000`, valid UI values become `0` to `10`
 > - do not pre-scale range points before passing them to the SDK; pass the human value and let the SDK scale it once
@@ -414,15 +413,15 @@ Current exposed helpers:
 
 - `PvPCoinflipGame`
 - `BetResultEvent`
-- `PvPCoinflipGameCreated`
-- `PvPCoinflipGameResolved`
-- `PvPCoinflipGameCancelled`
+- `PvPCoinflipGameCreatedEvent`
+- `PvPCoinflipGameResolvedEvent`
+- `PvPCoinflipGameCancelledEvent`
 
 These are generated Move event decoders. Use them to parse Suigar event payloads from transaction results. The `@suigar/sdk/utils` subpath also exposes parser helpers for generated BCS values:
 
 - `PvPCoinflipGame` parses a PvP coinflip game object's `content`
-- `parseI64(float.exp)` converts a generated Move `i64` exponent to a JavaScript number
-- `parseFloat(float)` converts a generated Move `Float` struct to a JavaScript number
+- `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
 - `parseGameDetails(game_details)` decodes `BetResultEvent.game_details` entries into the expected string, number, and boolean values
 
 ### Parse PvP Coinflip Game Object Data
@@ -512,7 +511,7 @@ const gameDetails = parseGameDetails(decoded.game_details);
 When the extension is configured with `partner`, decoded event `metadata` will
 contain that partner wallet address under the `partner` entry.
 
-> [!IMPORTANT]
+> **Important:**
 >
 > - execute or wait for the transaction with `include: { events: true }`
 > - unwrap the core API union with `result.$kind`, `result.Transaction`, and `result.FailedTransaction`
@@ -520,7 +519,7 @@ contain that partner wallet address under the `partner` entry.
 > - use `event.bcs` for consistent decoding across transports
 > - use `parseGameDetails(decoded.game_details)` instead of hand-decoding standard game detail byte arrays
 
-> [!TIP]
+> **Tip:**
 >
 > - `waitForTransaction({ result, include: { effects: true, events: true } })` is useful when you want the finalized transaction result before decoding
 > - these helpers decode the event payload itself, not a full transaction response
@@ -529,9 +528,9 @@ contain that partner wallet address under the `partner` entry.
 
 Use the matching helper for each PvP coinflip event payload found in `transactionResult.events`:
 
-- `client.suigar.bcs.PvPCoinflipGameCreated`
-- `client.suigar.bcs.PvPCoinflipGameResolved`
-- `client.suigar.bcs.PvPCoinflipGameCancelled`
+- `client.suigar.bcs.PvPCoinflipGameCreatedEvent`
+- `client.suigar.bcs.PvPCoinflipGameResolvedEvent`
+- `client.suigar.bcs.PvPCoinflipGameCancelledEvent`
 
 ## Development
 
@@ -549,9 +548,11 @@ It demonstrates:
 
 - standard game transactions through `client.suigar.tx.createBetTransaction(...)`
 - PvP coinflip create, join, and cancel flows through `client.suigar.tx.createPvPCoinflipTransaction(...)`, exposed in the example through a PvP coinflip action selector
+- unresolved PvP lobby browsing through `client.suigar.getPvPCoinflipGames(...)`, including public join cards while disconnected, an optional private-lobby join toggle, and connected-wallet filtering for cancel
 - wallet connection and execution with `@mysten/dapp-kit-core` and `@mysten/dapp-kit-react`
 - supported coin selection from `client.suigar.getConfig()`
 - connected-wallet balance display for each supported coin in the example app
+- privacy badges and copyable PvP game ids in the lobby UI
 - decoding `BetResultEvent` and PvP events into a persistent event log
 - parsing `BetResultEvent.game_details` with `parseGameDetails`
 

package/dist/{chunk-W3WZ2BHO.js → chunk-YGYMLRE4.js}

@@ -9,21 +9,34 @@ var RANGE_POINT_LIMIT = DEFAULT_RANGE_SCALE * 100;
 var DEFAULT_LIMBO_MULTIPLIER_SCALE = 100;
 
 // src/utils/numeric.ts
-function toBigIntAmount(value, fieldName) {
+function isFiniteNumber(value, message) {
+  if (typeof value !== "number") {
+    throw new Error(`${message}: ${String(value)}`);
+  }
+  if (!Number.isFinite(value)) {
+    throw new Error(`Value must be a finite number: ${value}`);
+  }
+}
+function toBigInt(value) {
   if (typeof value === "bigint") {
     if (value < 0n) {
-      throw new Error(`${fieldName} must be non-negative`);
+      throw new Error(`Value must be non-negative: ${value}`);
     }
     return value;
   }
-  if (!Number.isFinite(value) || value < 0) {
-    throw new Error(`${fieldName} must be a finite non-negative number`);
+  isFiniteNumber(value, "Value must be a bigint or number");
+  if (value < 0) {
+    throw new Error(`Value must be a finite non-negative number: ${value}`);
   }
   return BigInt(Math.trunc(value));
 }
-function toU8Number(value, fieldName) {
-  if (!Number.isInteger(value) || value < 0 || value > 255) {
-    throw new Error(`${fieldName} must be an integer between 0 and 255`);
+function toU8(value) {
+  isFiniteNumber(value, "Value must be a number");
+  if (!Number.isInteger(value)) {
+    throw new Error(`Value must be an integer: ${value}`);
+  }
+  if (value < 0 || value > 255) {
+    throw new Error(`Value must be an integer between 0 and 255: ${value}`);
   }
   return value;
 }
@@ -255,7 +268,7 @@ var GAME_DETAIL_BCS = {
   float: Float,
   string: bcsString
 };
-function parseI64(i64) {
+function fromMoveI64(i64) {
   try {
     const value = BigInt(i64.bits ?? 0);
     const maxPositive = 1n << 63n;
@@ -266,18 +279,18 @@ function parseI64(i64) {
     return 0;
   }
 }
-function parseFloat(float) {
+function fromMoveFloat(float) {
   const mantissa = BigInt(float.mant);
   if (mantissa === 0n) {
     return 0;
   }
-  const exponent = parseI64(float.exp) - 52;
+  const exponent = fromMoveI64(float.exp) - 52;
   const magnitude = Number(mantissa) * Math.pow(2, exponent);
   return float.is_negative ? -magnitude : magnitude;
 }
 function normalizeGameDetailValue(valueType, parsed) {
   if (valueType === "float") {
-    return parseFloat(parsed);
+    return fromMoveFloat(parsed);
   }
   if (valueType === "u64") {
     return Number(parsed);
@@ -307,4 +320,4 @@ function parseGameDetails(gameDetails) {
   }, {});
 }
 
-export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, Float, MoveStruct, RANGE_POINT_LIMIT, normalizeMoveArguments, parseFloat, parseGameDetails, parseI64, toBigIntAmount, toU8Number };
+export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, Float, MoveStruct, RANGE_POINT_LIMIT, fromMoveFloat, fromMoveI64, normalizeMoveArguments, parseGameDetails, toBigInt, toU8 };

package/dist/{games-nFnPbPuK.d.cts → games--Haw_z7M.d.cts}

@@ -39,6 +39,9 @@ type SharedBetTransactionOptions = {
     allowGasCoinShortcut?: boolean;
 };
 
+type WithThrowOnError<T = object> = T & {
+    throwOnError?: boolean;
+};
 type BuildCoinflipTransactionOptions = SharedBetTransactionOptions & {
     side: CoinSide;
 };
@@ -81,4 +84,4 @@ type BuildCancelPvPCoinflipTransactionOptions = SharedPvPCoinflipTransactionOpti
 };
 type BuildPvPCoinflipTransactionOptions<Action extends PvPCoinflipAction = PvPCoinflipAction> = Action extends 'create' ? BuildCreatePvPCoinflipTransactionOptions : Action extends 'join' ? BuildJoinPvPCoinflipTransactionOptions : Action extends 'cancel' ? BuildCancelPvPCoinflipTransactionOptions : never;
 
-export type { BuildCoinflipTransactionOptions as B, CoinSide as C, PvPCoinflipAction as P, StandardGame as S, BuildWheelTransactionOptions as a, BuildLimboTransactionOptions as b, BuildPlinkoTransactionOptions as c, BuildRangeTransactionOptions as d, SuigarConfig as e, BuildPvPCoinflipTransactionOptions as f, SuigarExtensionOptions as g, BuildCancelPvPCoinflipTransactionOptions as h, BuildCreatePvPCoinflipTransactionOptions as i, BuildJoinPvPCoinflipTransactionOptions as j };
+export type { BuildCoinflipTransactionOptions as B, CoinSide as C, PvPCoinflipAction as P, StandardGame as S, WithThrowOnError as W, BuildWheelTransactionOptions as a, BuildLimboTransactionOptions as b, BuildPlinkoTransactionOptions as c, BuildRangeTransactionOptions as d, SuigarConfig as e, BuildPvPCoinflipTransactionOptions as f, SuigarExtensionOptions as g, BuildCancelPvPCoinflipTransactionOptions as h, BuildCreatePvPCoinflipTransactionOptions as i, BuildJoinPvPCoinflipTransactionOptions as j };

package/dist/{games-nFnPbPuK.d.ts → games--Haw_z7M.d.ts}

@@ -39,6 +39,9 @@ type SharedBetTransactionOptions = {
     allowGasCoinShortcut?: boolean;
 };
 
+type WithThrowOnError<T = object> = T & {
+    throwOnError?: boolean;
+};
 type BuildCoinflipTransactionOptions = SharedBetTransactionOptions & {
     side: CoinSide;
 };
@@ -81,4 +84,4 @@ type BuildCancelPvPCoinflipTransactionOptions = SharedPvPCoinflipTransactionOpti
 };
 type BuildPvPCoinflipTransactionOptions<Action extends PvPCoinflipAction = PvPCoinflipAction> = Action extends 'create' ? BuildCreatePvPCoinflipTransactionOptions : Action extends 'join' ? BuildJoinPvPCoinflipTransactionOptions : Action extends 'cancel' ? BuildCancelPvPCoinflipTransactionOptions : never;
 
-export type { BuildCoinflipTransactionOptions as B, CoinSide as C, PvPCoinflipAction as P, StandardGame as S, BuildWheelTransactionOptions as a, BuildLimboTransactionOptions as b, BuildPlinkoTransactionOptions as c, BuildRangeTransactionOptions as d, SuigarConfig as e, BuildPvPCoinflipTransactionOptions as f, SuigarExtensionOptions as g, BuildCancelPvPCoinflipTransactionOptions as h, BuildCreatePvPCoinflipTransactionOptions as i, BuildJoinPvPCoinflipTransactionOptions as j };
+export type { BuildCoinflipTransactionOptions as B, CoinSide as C, PvPCoinflipAction as P, StandardGame as S, WithThrowOnError as W, BuildWheelTransactionOptions as a, BuildLimboTransactionOptions as b, BuildPlinkoTransactionOptions as c, BuildRangeTransactionOptions as d, SuigarConfig as e, BuildPvPCoinflipTransactionOptions as f, SuigarExtensionOptions as g, BuildCancelPvPCoinflipTransactionOptions as h, BuildCreatePvPCoinflipTransactionOptions as i, BuildJoinPvPCoinflipTransactionOptions as j };

package/dist/games.d.cts

@@ -1 +1 @@
-export { h as BuildCancelPvPCoinflipTransactionOptions, B as BuildCoinflipTransactionOptions, i as BuildCreatePvPCoinflipTransactionOptions, j as BuildJoinPvPCoinflipTransactionOptions, b as BuildLimboTransactionOptions, c as BuildPlinkoTransactionOptions, d as BuildRangeTransactionOptions, a as BuildWheelTransactionOptions, C as CoinSide, P as PvPCoinflipAction } from './games-nFnPbPuK.cjs';
+export { h as BuildCancelPvPCoinflipTransactionOptions, B as BuildCoinflipTransactionOptions, i as BuildCreatePvPCoinflipTransactionOptions, j as BuildJoinPvPCoinflipTransactionOptions, b as BuildLimboTransactionOptions, c as BuildPlinkoTransactionOptions, d as BuildRangeTransactionOptions, a as BuildWheelTransactionOptions, C as CoinSide, P as PvPCoinflipAction } from './games--Haw_z7M.cjs';

package/dist/games.d.ts

@@ -1 +1 @@
-export { h as BuildCancelPvPCoinflipTransactionOptions, B as BuildCoinflipTransactionOptions, i as BuildCreatePvPCoinflipTransactionOptions, j as BuildJoinPvPCoinflipTransactionOptions, b as BuildLimboTransactionOptions, c as BuildPlinkoTransactionOptions, d as BuildRangeTransactionOptions, a as BuildWheelTransactionOptions, C as CoinSide, P as PvPCoinflipAction } from './games-nFnPbPuK.js';
+export { h as BuildCancelPvPCoinflipTransactionOptions, B as BuildCoinflipTransactionOptions, i as BuildCreatePvPCoinflipTransactionOptions, j as BuildJoinPvPCoinflipTransactionOptions, b as BuildLimboTransactionOptions, c as BuildPlinkoTransactionOptions, d as BuildRangeTransactionOptions, a as BuildWheelTransactionOptions, C as CoinSide, P as PvPCoinflipAction } from './games--Haw_z7M.js';

package/dist/index.cjs

@@ -367,21 +367,34 @@ var DEFAULT_RANGE_SCALE = 1e6;
 var DEFAULT_LIMBO_MULTIPLIER_SCALE = 100;
 
 // src/utils/numeric.ts
-function toBigIntAmount(value, fieldName) {
+function isFiniteNumber(value, message) {
+  if (typeof value !== "number") {
+    throw new Error(`${message}: ${String(value)}`);
+  }
+  if (!Number.isFinite(value)) {
+    throw new Error(`Value must be a finite number: ${value}`);
+  }
+}
+function toBigInt(value) {
   if (typeof value === "bigint") {
     if (value < 0n) {
-      throw new Error(`${fieldName} must be non-negative`);
+      throw new Error(`Value must be non-negative: ${value}`);
     }
     return value;
   }
-  if (!Number.isFinite(value) || value < 0) {
-    throw new Error(`${fieldName} must be a finite non-negative number`);
+  isFiniteNumber(value, "Value must be a bigint or number");
+  if (value < 0) {
+    throw new Error(`Value must be a finite non-negative number: ${value}`);
   }
   return BigInt(Math.trunc(value));
 }
-function toU8Number(value, fieldName) {
-  if (!Number.isInteger(value) || value < 0 || value > 255) {
-    throw new Error(`${fieldName} must be an integer between 0 and 255`);
+function toU8(value) {
+  isFiniteNumber(value, "Value must be a number");
+  if (!Number.isInteger(value)) {
+    throw new Error(`Value must be an integer: ${value}`);
+  }
+  if (value < 0 || value > 255) {
+    throw new Error(`Value must be an integer between 0 and 255: ${value}`);
   }
   return value;
 }
@@ -426,9 +439,9 @@ function buildSharedStandardGameBetCall({
   return (tx) => {
     const normalizedOwner = utils.normalizeSuiAddress(sender ?? owner);
     const normalizedCoinType = utils.normalizeStructTag(coinType);
-    const resolvedStake = toBigIntAmount(stake, "stake");
-    const resolvedCashStake = toBigIntAmount(cashStake ?? stake, "cashStake");
-    const resolvedBetCount = toBigIntAmount(betCount ?? 1, "betCount");
+    const resolvedStake = toBigInt(stake);
+    const resolvedCashStake = toBigInt(cashStake ?? stake);
+    const resolvedBetCount = toBigInt(betCount ?? 1);
     const encodedMetadata = encodeBetMetadata(metadata, partner);
     const priceInfoObjectId = resolvePriceInfoObjectId(
       config,
@@ -577,7 +590,7 @@ function play3(options) {
 
 // src/transactions/plinko.ts
 function buildPlinkoTransaction(options) {
-  const configId = toU8Number(options.configId, "configId");
+  const configId = toU8(options.configId);
   return buildSharedStandardGameBetTransaction({
     ...options,
     game: "plinko",
@@ -737,7 +750,7 @@ function buildPvPCoinflipTransaction(action, options) {
   switch (action) {
     case "create": {
       const createOptions = options;
-      const stake = toBigIntAmount(createOptions.stake, "stake");
+      const stake = toBigInt(createOptions.stake);
       const betCoin = tx.coin({
         type: normalizedCoinType,
         balance: stake,
@@ -888,7 +901,7 @@ function play5(options) {
 
 // src/transactions/wheel.ts
 function buildWheelTransaction(options) {
-  const configId = toU8Number(options.configId, "configId");
+  const configId = toU8(options.configId);
   return buildSharedStandardGameBetTransaction({
     ...options,
     game: "wheel",
@@ -1014,22 +1027,22 @@ var SuigarClient = class {
    * browsing or lobby views.
    *
    * @param options Optional dynamic field pagination forwarded to `listDynamicFields()`, excluding `parentId`.
-   * Pass `rejectOnError: true` to fail the whole lookup when any referenced game
+   * Pass `throwOnError: true` to fail the whole lookup when any referenced game
    * cannot be resolved. By default, failed game resolutions are skipped and only
    * successfully parsed unresolved games are returned.
    * @returns Parsed unresolved PvP coinflip game objects for the requested
-   * registry page. When `rejectOnError` is `false`, entries that fail
+   * registry page. When `throwOnError` is `false`, entries that fail
    * `resolvePvPConflipGame()` are omitted from the returned array.
    */
   async getPvPCoinflipGames(options = {
     limit: 50
   }) {
-    const { rejectOnError = false, ...listOptions } = options;
+    const { throwOnError = false, ...listOptions } = options;
     const { dynamicFields } = await this.#client.core.listDynamicFields({
       parentId: this.#config.registryIds.pvpCoinflip,
       ...listOptions
     });
-    if (rejectOnError) {
+    if (throwOnError) {
       return Promise.all(
         dynamicFields.map(({ childId }) => this.resolvePvPConflipGame(childId))
       );
@@ -1092,15 +1105,15 @@ var SuigarClient = class {
     /**
      * Event emitted when a PvP Coinflip game is created, containing the game configuration and initial state.
      */
-    PvPCoinflipGameCreated: GameCreatedEvent,
+    PvPCoinflipGameCreatedEvent: GameCreatedEvent,
     /**
      * Event emitted when a PvP Coinflip game is resolved, containing the final outcome.
      */
-    PvPCoinflipGameResolved: GameResolvedEvent,
+    PvPCoinflipGameResolvedEvent: GameResolvedEvent,
     /**
      * Event emitted when a PvP Coinflip game is cancelled.
      */
-    PvPCoinflipGameCancelled: GameCancelledEvent
+    PvPCoinflipGameCancelledEvent: GameCancelledEvent
   };
   /**
    * Transaction builders for Suigar games.

package/dist/index.d.cts

@@ -2,7 +2,7 @@ import { M as MoveStruct } from './index-jwSXA8q3.cjs';
 import * as _mysten_bcs from '@mysten/bcs';
 import { ClientWithCoreApi, SuiClientTypes } from '@mysten/sui/client';
 import { Transaction, BuildTransactionOptions } from '@mysten/sui/transactions';
-import { S as StandardGame, B as BuildCoinflipTransactionOptions, a as BuildWheelTransactionOptions, b as BuildLimboTransactionOptions, c as BuildPlinkoTransactionOptions, d as BuildRangeTransactionOptions, e as SuigarConfig, P as PvPCoinflipAction, f as BuildPvPCoinflipTransactionOptions, g as SuigarExtensionOptions } from './games-nFnPbPuK.cjs';
+import { S as StandardGame, B as BuildCoinflipTransactionOptions, a as BuildWheelTransactionOptions, b as BuildLimboTransactionOptions, c as BuildPlinkoTransactionOptions, d as BuildRangeTransactionOptions, e as SuigarConfig, W as WithThrowOnError, P as PvPCoinflipAction, f as BuildPvPCoinflipTransactionOptions, g as SuigarExtensionOptions } from './games--Haw_z7M.cjs';
 import '@mysten/sui/bcs';
 
 type WithoutConfig<T> = Omit<T, 'config'>;
@@ -52,16 +52,14 @@ declare class SuigarClient {
      * browsing or lobby views.
      *
      * @param options Optional dynamic field pagination forwarded to `listDynamicFields()`, excluding `parentId`.
-     * Pass `rejectOnError: true` to fail the whole lookup when any referenced game
+     * Pass `throwOnError: true` to fail the whole lookup when any referenced game
      * cannot be resolved. By default, failed game resolutions are skipped and only
      * successfully parsed unresolved games are returned.
      * @returns Parsed unresolved PvP coinflip game objects for the requested
-     * registry page. When `rejectOnError` is `false`, entries that fail
+     * registry page. When `throwOnError` is `false`, entries that fail
      * `resolvePvPConflipGame()` are omitted from the returned array.
      */
-    getPvPCoinflipGames(options?: Omit<SuiClientTypes.ListDynamicFieldsOptions, 'parentId'> & {
-        rejectOnError?: boolean;
-    }): Promise<{
+    getPvPCoinflipGames(options?: WithThrowOnError<Omit<SuiClientTypes.ListDynamicFieldsOptions, 'parentId'>>): Promise<{
         coinType: string;
         id: string;
         creator: string;
@@ -209,7 +207,7 @@ declare class SuigarClient {
         /**
          * Event emitted when a PvP Coinflip game is created, containing the game configuration and initial state.
          */
-        PvPCoinflipGameCreated: MoveStruct<{
+        PvPCoinflipGameCreatedEvent: MoveStruct<{
             game_id: _mysten_bcs.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
             creator: _mysten_bcs.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
             creator_is_tails: _mysten_bcs.BcsType<boolean, boolean, "bool">;
@@ -224,7 +222,7 @@ declare class SuigarClient {
         /**
          * Event emitted when a PvP Coinflip game is resolved, containing the final outcome.
          */
-        PvPCoinflipGameResolved: MoveStruct<{
+        PvPCoinflipGameResolvedEvent: MoveStruct<{
             game_id: _mysten_bcs.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
             creator: _mysten_bcs.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
             joiner: _mysten_bcs.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
@@ -243,7 +241,7 @@ declare class SuigarClient {
         /**
          * Event emitted when a PvP Coinflip game is cancelled.
          */
-        PvPCoinflipGameCancelled: MoveStruct<{
+        PvPCoinflipGameCancelledEvent: MoveStruct<{
             game_id: _mysten_bcs.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
             creator: _mysten_bcs.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
             creator_is_tails: _mysten_bcs.BcsType<boolean, boolean, "bool">;

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { M as MoveStruct } from './index-jwSXA8q3.js';
 import * as _mysten_bcs from '@mysten/bcs';
 import { ClientWithCoreApi, SuiClientTypes } from '@mysten/sui/client';
 import { Transaction, BuildTransactionOptions } from '@mysten/sui/transactions';
-import { S as StandardGame, B as BuildCoinflipTransactionOptions, a as BuildWheelTransactionOptions, b as BuildLimboTransactionOptions, c as BuildPlinkoTransactionOptions, d as BuildRangeTransactionOptions, e as SuigarConfig, P as PvPCoinflipAction, f as BuildPvPCoinflipTransactionOptions, g as SuigarExtensionOptions } from './games-nFnPbPuK.js';
+import { S as StandardGame, B as BuildCoinflipTransactionOptions, a as BuildWheelTransactionOptions, b as BuildLimboTransactionOptions, c as BuildPlinkoTransactionOptions, d as BuildRangeTransactionOptions, e as SuigarConfig, W as WithThrowOnError, P as PvPCoinflipAction, f as BuildPvPCoinflipTransactionOptions, g as SuigarExtensionOptions } from './games--Haw_z7M.js';
 import '@mysten/sui/bcs';
 
 type WithoutConfig<T> = Omit<T, 'config'>;
@@ -52,16 +52,14 @@ declare class SuigarClient {
      * browsing or lobby views.
      *
      * @param options Optional dynamic field pagination forwarded to `listDynamicFields()`, excluding `parentId`.
-     * Pass `rejectOnError: true` to fail the whole lookup when any referenced game
+     * Pass `throwOnError: true` to fail the whole lookup when any referenced game
      * cannot be resolved. By default, failed game resolutions are skipped and only
      * successfully parsed unresolved games are returned.
      * @returns Parsed unresolved PvP coinflip game objects for the requested
-     * registry page. When `rejectOnError` is `false`, entries that fail
+     * registry page. When `throwOnError` is `false`, entries that fail
      * `resolvePvPConflipGame()` are omitted from the returned array.
      */
-    getPvPCoinflipGames(options?: Omit<SuiClientTypes.ListDynamicFieldsOptions, 'parentId'> & {
-        rejectOnError?: boolean;
-    }): Promise<{
+    getPvPCoinflipGames(options?: WithThrowOnError<Omit<SuiClientTypes.ListDynamicFieldsOptions, 'parentId'>>): Promise<{
         coinType: string;
         id: string;
         creator: string;
@@ -209,7 +207,7 @@ declare class SuigarClient {
         /**
          * Event emitted when a PvP Coinflip game is created, containing the game configuration and initial state.
          */
-        PvPCoinflipGameCreated: MoveStruct<{
+        PvPCoinflipGameCreatedEvent: MoveStruct<{
             game_id: _mysten_bcs.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
             creator: _mysten_bcs.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
             creator_is_tails: _mysten_bcs.BcsType<boolean, boolean, "bool">;
@@ -224,7 +222,7 @@ declare class SuigarClient {
         /**
          * Event emitted when a PvP Coinflip game is resolved, containing the final outcome.
          */
-        PvPCoinflipGameResolved: MoveStruct<{
+        PvPCoinflipGameResolvedEvent: MoveStruct<{
             game_id: _mysten_bcs.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
             creator: _mysten_bcs.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
             joiner: _mysten_bcs.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
@@ -243,7 +241,7 @@ declare class SuigarClient {
         /**
          * Event emitted when a PvP Coinflip game is cancelled.
          */
-        PvPCoinflipGameCancelled: MoveStruct<{
+        PvPCoinflipGameCancelledEvent: MoveStruct<{
             game_id: _mysten_bcs.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
             creator: _mysten_bcs.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
             creator_is_tails: _mysten_bcs.BcsType<boolean, boolean, "bool">;

package/dist/index.js

@@ -1,4 +1,4 @@
-import { MoveStruct, Float, toBigIntAmount, toU8Number, DEFAULT_GAS_BUDGET_MIST, normalizeMoveArguments, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE } from './chunk-W3WZ2BHO.js';
+import { MoveStruct, Float, toBigInt, toU8, DEFAULT_GAS_BUDGET_MIST, normalizeMoveArguments, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE } from './chunk-YGYMLRE4.js';
 import { toBase64, normalizeStructTag, parseStructTag, normalizeSuiAddress, isValidSuiAddress } from '@mysten/sui/utils';
 import { Transaction } from '@mysten/sui/transactions';
 import { bcs } from '@mysten/sui/bcs';
@@ -251,9 +251,9 @@ function buildSharedStandardGameBetCall({
   return (tx) => {
     const normalizedOwner = normalizeSuiAddress(sender ?? owner);
     const normalizedCoinType = normalizeStructTag(coinType);
-    const resolvedStake = toBigIntAmount(stake, "stake");
-    const resolvedCashStake = toBigIntAmount(cashStake ?? stake, "cashStake");
-    const resolvedBetCount = toBigIntAmount(betCount ?? 1, "betCount");
+    const resolvedStake = toBigInt(stake);
+    const resolvedCashStake = toBigInt(cashStake ?? stake);
+    const resolvedBetCount = toBigInt(betCount ?? 1);
     const encodedMetadata = encodeBetMetadata(metadata, partner);
     const priceInfoObjectId = resolvePriceInfoObjectId(
       config,
@@ -402,7 +402,7 @@ function play3(options) {
 
 // src/transactions/plinko.ts
 function buildPlinkoTransaction(options) {
-  const configId = toU8Number(options.configId, "configId");
+  const configId = toU8(options.configId);
   return buildSharedStandardGameBetTransaction({
     ...options,
     game: "plinko",
@@ -562,7 +562,7 @@ function buildPvPCoinflipTransaction(action, options) {
   switch (action) {
     case "create": {
       const createOptions = options;
-      const stake = toBigIntAmount(createOptions.stake, "stake");
+      const stake = toBigInt(createOptions.stake);
       const betCoin = tx.coin({
         type: normalizedCoinType,
         balance: stake,
@@ -713,7 +713,7 @@ function play5(options) {
 
 // src/transactions/wheel.ts
 function buildWheelTransaction(options) {
-  const configId = toU8Number(options.configId, "configId");
+  const configId = toU8(options.configId);
   return buildSharedStandardGameBetTransaction({
     ...options,
     game: "wheel",
@@ -839,22 +839,22 @@ var SuigarClient = class {
    * browsing or lobby views.
    *
    * @param options Optional dynamic field pagination forwarded to `listDynamicFields()`, excluding `parentId`.
-   * Pass `rejectOnError: true` to fail the whole lookup when any referenced game
+   * Pass `throwOnError: true` to fail the whole lookup when any referenced game
    * cannot be resolved. By default, failed game resolutions are skipped and only
    * successfully parsed unresolved games are returned.
    * @returns Parsed unresolved PvP coinflip game objects for the requested
-   * registry page. When `rejectOnError` is `false`, entries that fail
+   * registry page. When `throwOnError` is `false`, entries that fail
    * `resolvePvPConflipGame()` are omitted from the returned array.
    */
   async getPvPCoinflipGames(options = {
     limit: 50
   }) {
-    const { rejectOnError = false, ...listOptions } = options;
+    const { throwOnError = false, ...listOptions } = options;
     const { dynamicFields } = await this.#client.core.listDynamicFields({
       parentId: this.#config.registryIds.pvpCoinflip,
       ...listOptions
     });
-    if (rejectOnError) {
+    if (throwOnError) {
       return Promise.all(
         dynamicFields.map(({ childId }) => this.resolvePvPConflipGame(childId))
       );
@@ -917,15 +917,15 @@ var SuigarClient = class {
     /**
      * Event emitted when a PvP Coinflip game is created, containing the game configuration and initial state.
      */
-    PvPCoinflipGameCreated: GameCreatedEvent,
+    PvPCoinflipGameCreatedEvent: GameCreatedEvent,
     /**
      * Event emitted when a PvP Coinflip game is resolved, containing the final outcome.
      */
-    PvPCoinflipGameResolved: GameResolvedEvent,
+    PvPCoinflipGameResolvedEvent: GameResolvedEvent,
     /**
      * Event emitted when a PvP Coinflip game is cancelled.
      */
-    PvPCoinflipGameCancelled: GameCancelledEvent
+    PvPCoinflipGameCancelledEvent: GameCancelledEvent
   };
   /**
    * Transaction builders for Suigar games.

package/dist/utils.cjs

@@ -11,21 +11,34 @@ var RANGE_POINT_LIMIT = DEFAULT_RANGE_SCALE * 100;
 var DEFAULT_LIMBO_MULTIPLIER_SCALE = 100;
 
 // src/utils/numeric.ts
-function toBigIntAmount(value, fieldName) {
+function isFiniteNumber(value, message) {
+  if (typeof value !== "number") {
+    throw new Error(`${message}: ${String(value)}`);
+  }
+  if (!Number.isFinite(value)) {
+    throw new Error(`Value must be a finite number: ${value}`);
+  }
+}
+function toBigInt(value) {
   if (typeof value === "bigint") {
     if (value < 0n) {
-      throw new Error(`${fieldName} must be non-negative`);
+      throw new Error(`Value must be non-negative: ${value}`);
     }
     return value;
   }
-  if (!Number.isFinite(value) || value < 0) {
-    throw new Error(`${fieldName} must be a finite non-negative number`);
+  isFiniteNumber(value, "Value must be a bigint or number");
+  if (value < 0) {
+    throw new Error(`Value must be a finite non-negative number: ${value}`);
   }
   return BigInt(Math.trunc(value));
 }
-function toU8Number(value, fieldName) {
-  if (!Number.isInteger(value) || value < 0 || value > 255) {
-    throw new Error(`${fieldName} must be an integer between 0 and 255`);
+function toU8(value) {
+  isFiniteNumber(value, "Value must be a number");
+  if (!Number.isInteger(value)) {
+    throw new Error(`Value must be an integer: ${value}`);
+  }
+  if (value < 0 || value > 255) {
+    throw new Error(`Value must be an integer between 0 and 255: ${value}`);
   }
   return value;
 }
@@ -145,7 +158,7 @@ var GAME_DETAIL_BCS = {
   float: Float,
   string: bcsString
 };
-function parseI64(i64) {
+function fromMoveI64(i64) {
   try {
     const value = BigInt(i64.bits ?? 0);
     const maxPositive = 1n << 63n;
@@ -156,18 +169,18 @@ function parseI64(i64) {
     return 0;
   }
 }
-function parseFloat(float) {
+function fromMoveFloat(float) {
   const mantissa = BigInt(float.mant);
   if (mantissa === 0n) {
     return 0;
   }
-  const exponent = parseI64(float.exp) - 52;
+  const exponent = fromMoveI64(float.exp) - 52;
   const magnitude = Number(mantissa) * Math.pow(2, exponent);
   return float.is_negative ? -magnitude : magnitude;
 }
 function normalizeGameDetailValue(valueType, parsed) {
   if (valueType === "float") {
-    return parseFloat(parsed);
+    return fromMoveFloat(parsed);
   }
   if (valueType === "u64") {
     return Number(parsed);
@@ -201,8 +214,8 @@ exports.DEFAULT_GAS_BUDGET_MIST = DEFAULT_GAS_BUDGET_MIST;
 exports.DEFAULT_LIMBO_MULTIPLIER_SCALE = DEFAULT_LIMBO_MULTIPLIER_SCALE;
 exports.DEFAULT_RANGE_SCALE = DEFAULT_RANGE_SCALE;
 exports.RANGE_POINT_LIMIT = RANGE_POINT_LIMIT;
-exports.parseFloat = parseFloat;
+exports.fromMoveFloat = fromMoveFloat;
+exports.fromMoveI64 = fromMoveI64;
 exports.parseGameDetails = parseGameDetails;
-exports.parseI64 = parseI64;
-exports.toBigIntAmount = toBigIntAmount;
-exports.toU8Number = toU8Number;
+exports.toBigInt = toBigInt;
+exports.toU8 = toU8;

package/dist/utils.d.cts

@@ -61,8 +61,8 @@ declare const DEFAULT_RANGE_SCALE = 1000000;
 declare const RANGE_POINT_LIMIT: number;
 declare const DEFAULT_LIMBO_MULTIPLIER_SCALE = 100;
 
-declare function toBigIntAmount(value: bigint | number, fieldName: string): bigint;
-declare function toU8Number(value: number, fieldName: string): number;
+declare function toBigInt(value: unknown): bigint;
+declare function toU8(value: unknown): number;
 
 declare const Float: MoveStruct<{
     is_negative: _mysten_bcs.BcsType<boolean, boolean, "bool">;
@@ -72,8 +72,9 @@ declare const Float: MoveStruct<{
     mant: _mysten_bcs.BcsType<string, string | number | bigint, "u64">;
 }, "0xf391858d2a08473e8d4defcc8df89976bd7b123d3865c6b9341b237f7853dbbc::float::Float">;
 
-declare function parseI64(i64: ReturnType<(typeof Float)['parse']>['exp']): number;
-declare function parseFloat(float: ReturnType<(typeof Float)['parse']>): number;
+type MoveFloat = ReturnType<(typeof Float)['parse']>;
+declare function fromMoveI64(i64: MoveFloat['exp']): number;
+declare function fromMoveFloat(float: MoveFloat): number;
 declare function parseGameDetails(gameDetails: BetResultGameDetails): ParsedGameDetails;
 
-export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT, parseFloat, parseGameDetails, parseI64, toBigIntAmount, toU8Number };
+export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT, fromMoveFloat, fromMoveI64, parseGameDetails, toBigInt, toU8 };

package/dist/utils.d.ts

@@ -61,8 +61,8 @@ declare const DEFAULT_RANGE_SCALE = 1000000;
 declare const RANGE_POINT_LIMIT: number;
 declare const DEFAULT_LIMBO_MULTIPLIER_SCALE = 100;
 
-declare function toBigIntAmount(value: bigint | number, fieldName: string): bigint;
-declare function toU8Number(value: number, fieldName: string): number;
+declare function toBigInt(value: unknown): bigint;
+declare function toU8(value: unknown): number;
 
 declare const Float: MoveStruct<{
     is_negative: _mysten_bcs.BcsType<boolean, boolean, "bool">;
@@ -72,8 +72,9 @@ declare const Float: MoveStruct<{
     mant: _mysten_bcs.BcsType<string, string | number | bigint, "u64">;
 }, "0xf391858d2a08473e8d4defcc8df89976bd7b123d3865c6b9341b237f7853dbbc::float::Float">;
 
-declare function parseI64(i64: ReturnType<(typeof Float)['parse']>['exp']): number;
-declare function parseFloat(float: ReturnType<(typeof Float)['parse']>): number;
+type MoveFloat = ReturnType<(typeof Float)['parse']>;
+declare function fromMoveI64(i64: MoveFloat['exp']): number;
+declare function fromMoveFloat(float: MoveFloat): number;
 declare function parseGameDetails(gameDetails: BetResultGameDetails): ParsedGameDetails;
 
-export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT, parseFloat, parseGameDetails, parseI64, toBigIntAmount, toU8Number };
+export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT, fromMoveFloat, fromMoveI64, parseGameDetails, toBigInt, toU8 };

package/dist/utils.js

@@ -1 +1 @@
-export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT, parseFloat, parseGameDetails, parseI64, toBigIntAmount, toU8Number } from './chunk-W3WZ2BHO.js';
+export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT, fromMoveFloat, fromMoveI64, parseGameDetails, toBigInt, toU8 } from './chunk-YGYMLRE4.js';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@suigar/sdk",
-	"version": "2.0.0-beta.5",
+	"version": "2.0.0-beta.7",
 	"description": "TypeScript SDK for Suigar v2 Move contracts on Sui.",
 	"keywords": [
 		"suigar",
@@ -91,20 +91,5 @@
 		"typescript": "^5.9.3",
 		"typescript-eslint": "^8.59.0",
 		"vitest": "^4.1.5"
-	},
-	"lint-staged": {
-		"{src,test,scripts}/**/*.{ts,tsx,js,mjs,cjs}": [
-			"eslint --fix",
-			"prettier --write"
-		],
-		"./*.{ts,tsx,js,mjs,cjs}": [
-			"eslint --fix",
-			"prettier --write"
-		],
-		"examples/game-integration/**/*.{ts,tsx,js,mjs,cjs}": [
-			"npm --prefix examples/game-integration exec eslint -- --fix",
-			"prettier --write"
-		],
-		"*.{json,md,yml,yaml}": "prettier --write"
 	}
 }