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

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @suigar/sdk
 
+## 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

@@ -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
 
-> [!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
@@ -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
@@ -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(...)`, rendered as compact join/cancel cards filtered by the connected wallet
 - 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/{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

@@ -1014,22 +1014,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))
       );

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;

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;

package/dist/index.js

@@ -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))
       );

package/package.json

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