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

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @suigar/sdk
 
+## 2.0.0-beta.6
+
+### Patch Changes
+
+- ef6bcd4: Rename getPvPCoinflipGames option from rejectOnError to throwOnError.
+
+## 2.0.0-beta.5
+
+### Patch Changes
+
+- bf98e0a: Update PvP coinflip registry lookups so `getPvPCoinflipGames()` can skip
+  individual game resolution failures by default while still supporting
+  `rejectOnError: true` for strict rejection.
+  - Document the `rejectOnError` behavior in the public JSDoc and README examples.
+  - Clarify repo guidance and skill documentation to distinguish general PvP game
+    guidance from the current PvP coinflip-specific runtime surface.
+
 ## 2.0.0-beta.4
 
 ### 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(
@@ -208,6 +207,10 @@ the Move flow removes it from the registry and deletes the live `Game` object.
 Use this when a product needs the current set of open PvP coinflip matches for
 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
+`throwOnError: true` if you want the call to reject instead.
+
 ```ts
 const games = await client.suigar.getPvPCoinflipGames({ limit: 20 });
 
@@ -217,6 +220,13 @@ for (const game of games) {
 }
 ```
 
+```ts
+const games = await client.suigar.getPvPCoinflipGames({
+	limit: 20,
+	throwOnError: true,
+});
+```
+
 ### `resolvePvPConflipGame(gameId)`
 
 Fetches a PvP coinflip game object from chain and parses it into the SDK's
@@ -239,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 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`
 
@@ -323,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
@@ -332,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
@@ -501,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`
@@ -509,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
@@ -537,10 +547,12 @@ This repository now includes a Next.js integration example in [examples/game-int
 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 game selector ready for future PvP games
+- 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,18 +1014,32 @@ var SuigarClient = class {
    * browsing or lobby views.
    *
    * @param options Optional dynamic field pagination forwarded to `listDynamicFields()`, excluding `parentId`.
-   * @returns Parsed unresolved PvP coinflip game objects for the requested registry page.
+   * 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 `throwOnError` is `false`, entries that fail
+   * `resolvePvPConflipGame()` are omitted from the returned array.
    */
   async getPvPCoinflipGames(options = {
     limit: 50
   }) {
+    const { throwOnError = false, ...listOptions } = options;
     const { dynamicFields } = await this.#client.core.listDynamicFields({
       parentId: this.#config.registryIds.pvpCoinflip,
-      ...options
+      ...listOptions
     });
-    return await Promise.all(
+    if (throwOnError) {
+      return Promise.all(
+        dynamicFields.map(({ childId }) => this.resolvePvPConflipGame(childId))
+      );
+    }
+    const settledGames = await Promise.allSettled(
       dynamicFields.map(({ childId }) => this.resolvePvPConflipGame(childId))
     );
+    return settledGames.flatMap(
+      (result) => result.status === "fulfilled" ? [result.value] : []
+    );
   }
   /**
    * Fetches a PvP coinflip game object from chain and parses it into the SDK's

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,9 +52,14 @@ declare class SuigarClient {
      * browsing or lobby views.
      *
      * @param options Optional dynamic field pagination forwarded to `listDynamicFields()`, excluding `parentId`.
-     * @returns Parsed unresolved PvP coinflip game objects for the requested registry page.
+     * 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 `throwOnError` is `false`, entries that fail
+     * `resolvePvPConflipGame()` are omitted from the returned array.
      */
-    getPvPCoinflipGames(options?: Omit<SuiClientTypes.ListDynamicFieldsOptions, 'parentId'>): 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,9 +52,14 @@ declare class SuigarClient {
      * browsing or lobby views.
      *
      * @param options Optional dynamic field pagination forwarded to `listDynamicFields()`, excluding `parentId`.
-     * @returns Parsed unresolved PvP coinflip game objects for the requested registry page.
+     * 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 `throwOnError` is `false`, entries that fail
+     * `resolvePvPConflipGame()` are omitted from the returned array.
      */
-    getPvPCoinflipGames(options?: Omit<SuiClientTypes.ListDynamicFieldsOptions, 'parentId'>): Promise<{
+    getPvPCoinflipGames(options?: WithThrowOnError<Omit<SuiClientTypes.ListDynamicFieldsOptions, 'parentId'>>): Promise<{
         coinType: string;
         id: string;
         creator: string;

package/dist/index.js

@@ -839,18 +839,32 @@ var SuigarClient = class {
    * browsing or lobby views.
    *
    * @param options Optional dynamic field pagination forwarded to `listDynamicFields()`, excluding `parentId`.
-   * @returns Parsed unresolved PvP coinflip game objects for the requested registry page.
+   * 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 `throwOnError` is `false`, entries that fail
+   * `resolvePvPConflipGame()` are omitted from the returned array.
    */
   async getPvPCoinflipGames(options = {
     limit: 50
   }) {
+    const { throwOnError = false, ...listOptions } = options;
     const { dynamicFields } = await this.#client.core.listDynamicFields({
       parentId: this.#config.registryIds.pvpCoinflip,
-      ...options
+      ...listOptions
     });
-    return await Promise.all(
+    if (throwOnError) {
+      return Promise.all(
+        dynamicFields.map(({ childId }) => this.resolvePvPConflipGame(childId))
+      );
+    }
+    const settledGames = await Promise.allSettled(
       dynamicFields.map(({ childId }) => this.resolvePvPConflipGame(childId))
     );
+    return settledGames.flatMap(
+      (result) => result.status === "fulfilled" ? [result.value] : []
+    );
   }
   /**
    * Fetches a PvP coinflip game object from chain and parses it into the SDK's

package/package.json

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