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

package/CHANGELOG.md

@@ -1,10 +1,21 @@
 # @suigar/sdk
 
+## 2.0.0-beta.14
+
+### Patch Changes
+
+- f846d27: Rename exported SDK config types to distinguish key unions from ID maps more clearly.
+  - Rename `SuigarPackageKey` to `SuigarPackage`.
+  - Rename the old `SuigarPackage` record type to `SuigarPackageIds`.
+  - Rename `SuigarRegistryKey` to `SuigarRegistry`.
+  - Rename the old `SuigarRegistry` record type to `SuigarRegistryIds`.
+  - Rename `SuigarPriceInfoObjectId` to `SuigarPriceInfoObjectIds`.
+
 ## 2.0.0-beta.13
 
 ### Patch Changes
 
-- 667d7c4: Normalize authored repository wording to use `on-chain` consistently.
+- 667d7c4: Normalize repository wording to use `on-chain` consistently.
 
 ## 2.0.0-beta.12
 
@@ -85,18 +96,18 @@
 
 ### Patch Changes
 
-- 6daa819: Add BCS parser helpers and a Next.js game integration example app.
+- 6daa819: Add BCS parser helpers and a Next.js playground example app.
   - expose parser helpers through `@suigar/sdk/utils`
   - add `parseGameDetails` for decoding `BetResultEvent.game_details`
   - document generated BCS event decoding and game detail parsing guidance
-  - add a testnet-only `apps/playground` app for standard and PvP Suigar transactions
+  - add a testnet-only app for standard and PvP Suigar transactions
   - integrate Mysten dApp Kit wallet connection, signing, and execution
   - add live transaction code previews and shared decoded event logging with SDK parser helpers
   - add Suigar-themed responsive UI, supported coin selection, and human-readable stake handling
   - update PvP coinflip join so callers only provide `gameId` and the SDK derives the join stake while using the configured price info object id
 
 - b89d0b4: Add a public `@suigar/sdk/games` export subpath for shared game option types, and export `SuigarClient` from the package root.
-- bf1f71b: Add `registryIds` to `SuigarConfig` and resolve it from the network config registry map.
+- bf1f71b: Add `registryIds` to `SuigarConfig` and resolve them from the network config registry map.
 
   Document the PvP coinflip runtime helpers more clearly by describing
   registry-backed unresolved game discovery through `getPvPCoinflipGames()` and

package/dist/{games-BHYRg31e.d.cts → games-Da2uZvVJ.d.cts}

@@ -28,16 +28,16 @@ interface SuigarExtensionOptions<Name = 'suigar'> {
 }
 type SuigarCoin = 'sui' | 'usdc';
 type SuigarCoinTypes = Record<SuigarCoin, string>;
-type SuigarPackageKey = 'sweetHouse' | 'core' | 'coinflip' | 'limbo' | 'plinko' | 'pvpCoinflip' | 'range' | 'wheel';
-type SuigarPackage = Record<SuigarPackageKey, string>;
-type SuigarPriceInfoObjectId = Record<SuigarCoin, string>;
-type SuigarRegistryKey = 'pvpCoinflip';
-type SuigarRegistryId = Record<SuigarRegistryKey, string>;
+type SuigarPackage = 'sweetHouse' | 'core' | 'coinflip' | 'limbo' | 'plinko' | 'pvpCoinflip' | 'range' | 'wheel';
+type SuigarPackageIds = Record<SuigarPackage, string>;
+type SuigarRegistry = 'pvpCoinflip';
+type SuigarRegistryIds = Record<SuigarRegistry, string>;
+type SuigarPriceInfoObjectIds = Record<SuigarCoin, string>;
 type SuigarConfig = {
-    packageIds: SuigarPackage;
-    registryIds: SuigarRegistryId;
+    packageIds: SuigarPackageIds;
+    registryIds: SuigarRegistryIds;
     coinTypes: SuigarCoinTypes;
-    priceInfoObjectIds: SuigarPriceInfoObjectId;
+    priceInfoObjectIds: SuigarPriceInfoObjectIds;
 };
 
 type WithGasBudget = {

package/dist/{games-BHYRg31e.d.ts → games-Da2uZvVJ.d.ts}

@@ -28,16 +28,16 @@ interface SuigarExtensionOptions<Name = 'suigar'> {
 }
 type SuigarCoin = 'sui' | 'usdc';
 type SuigarCoinTypes = Record<SuigarCoin, string>;
-type SuigarPackageKey = 'sweetHouse' | 'core' | 'coinflip' | 'limbo' | 'plinko' | 'pvpCoinflip' | 'range' | 'wheel';
-type SuigarPackage = Record<SuigarPackageKey, string>;
-type SuigarPriceInfoObjectId = Record<SuigarCoin, string>;
-type SuigarRegistryKey = 'pvpCoinflip';
-type SuigarRegistryId = Record<SuigarRegistryKey, string>;
+type SuigarPackage = 'sweetHouse' | 'core' | 'coinflip' | 'limbo' | 'plinko' | 'pvpCoinflip' | 'range' | 'wheel';
+type SuigarPackageIds = Record<SuigarPackage, string>;
+type SuigarRegistry = 'pvpCoinflip';
+type SuigarRegistryIds = Record<SuigarRegistry, string>;
+type SuigarPriceInfoObjectIds = Record<SuigarCoin, string>;
 type SuigarConfig = {
-    packageIds: SuigarPackage;
-    registryIds: SuigarRegistryId;
+    packageIds: SuigarPackageIds;
+    registryIds: SuigarRegistryIds;
     coinTypes: SuigarCoinTypes;
-    priceInfoObjectIds: SuigarPriceInfoObjectId;
+    priceInfoObjectIds: SuigarPriceInfoObjectIds;
 };
 
 type WithGasBudget = {

package/dist/games.d.cts

@@ -1,2 +1,2 @@
-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-BHYRg31e.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-Da2uZvVJ.cjs';
 import '@mysten/sui/transactions';

package/dist/games.d.ts

@@ -1,2 +1,2 @@
-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-BHYRg31e.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-Da2uZvVJ.js';
 import '@mysten/sui/transactions';

package/dist/index.cjs

@@ -415,19 +415,19 @@ var PRICE_INFO_OBJECT_IDS = {
 };
 
 // src/configs/registry.mainnet.ts
-var PVP_COINFLIP_REGISTRY_ID = "0x3d73568546c539c1da3eb2b8fe917faef3c0acdbec78a67fe6d52800a0729349";
+var MAINNET_REGISTRY_IDS = {
+  pvpCoinflip: "0x3d73568546c539c1da3eb2b8fe917faef3c0acdbec78a67fe6d52800a0729349"
+};
 
 // src/configs/registry.testnet.ts
-var PVP_COINFLIP_REGISTRY_ID2 = "0x99f20d8e4be012ea14a681144ae72ac349d0a1a1585205880183eb167f075bad";
+var TESTNET_REGISTRY_IDS = {
+  pvpCoinflip: "0x99f20d8e4be012ea14a681144ae72ac349d0a1a1585205880183eb167f075bad"
+};
 
 // src/configs/registry.ts
 var REGISTRY_IDS = {
-  mainnet: {
-    pvpCoinflip: PVP_COINFLIP_REGISTRY_ID
-  },
-  testnet: {
-    pvpCoinflip: PVP_COINFLIP_REGISTRY_ID2
-  }
+  mainnet: { ...MAINNET_REGISTRY_IDS },
+  testnet: { ...TESTNET_REGISTRY_IDS }
 };
 
 // src/helpers/config.ts

package/dist/index.d.cts

@@ -2,9 +2,36 @@ import { M as MoveStruct } from './index-3P_LBbDM.cjs';
 import * as _mysten_bcs from '@mysten/bcs';
 import { SuiClientTypes, ClientWithCoreApi } 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, G as Game, e as SuigarConfig, W as WithThrowOnError, P as PvPCoinflipAction, f as BuildPvPCoinflipTransactionOptions, g as SuigarExtensionOptions } from './games-BHYRg31e.cjs';
+import { S as StandardGame, B as BuildCoinflipTransactionOptions, a as BuildWheelTransactionOptions, b as BuildLimboTransactionOptions, c as BuildPlinkoTransactionOptions, d as BuildRangeTransactionOptions, G as Game$1, e as SuigarConfig, W as WithThrowOnError, P as PvPCoinflipAction, f as BuildPvPCoinflipTransactionOptions, g as SuigarExtensionOptions } from './games-Da2uZvVJ.cjs';
 import '@mysten/sui/bcs';
 
+declare const Game: MoveStruct<{
+    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">;
+    is_private: _mysten_bcs.BcsType<boolean, boolean, "bool">;
+    creator_metadata: MoveStruct<{
+        contents: _mysten_bcs.BcsType<{
+            key: string;
+            value: number[];
+        }[], Iterable<{
+            key: string;
+            value: Iterable<number> & {
+                length: number;
+            };
+        }> & {
+            length: number;
+        }, string>;
+    }, "0x2::vec_map::VecMap<string, vector<u8>>">;
+    joiner: _mysten_bcs.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+    winner: _mysten_bcs.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+    stake_per_player: _mysten_bcs.BcsType<string, string | number | bigint, "u64">;
+    house_edge_bps: _mysten_bcs.BcsType<string, string | number | bigint, "u64">;
+    stake_pot: MoveStruct<{
+        value: _mysten_bcs.BcsType<string, string | number | bigint, "u64">;
+    }, "0x2::balance::Balance<phantom T0>">;
+}, "0xb43cf6583c0c15315c7e66f173af4be79ac40c38aad1fd92ec08638ab2026202::pvp_coinflip::Game<phantom T0>">;
+
 type WithoutConfig<T> = Omit<T, 'config'>;
 type BuildGameOptions<GameId extends StandardGame> = GameId extends 'coinflip' ? WithoutConfig<BuildCoinflipTransactionOptions> : GameId extends 'wheel' ? WithoutConfig<BuildWheelTransactionOptions> : GameId extends 'limbo' ? WithoutConfig<BuildLimboTransactionOptions> : GameId extends 'plinko' ? WithoutConfig<BuildPlinkoTransactionOptions> : GameId extends 'range' ? WithoutConfig<BuildRangeTransactionOptions> : never;
 
@@ -195,9 +222,9 @@ declare const GAME_SETTINGS: {
     };
 };
 type GameParametersMap = {
-    [TGame in Game]: ReturnType<(typeof GAME_SETTINGS)[TGame]['parameters']['parse']>;
+    [TGame in Game$1]: ReturnType<(typeof GAME_SETTINGS)[TGame]['parameters']['parse']>;
 };
-type GameParameters<TGame extends Game> = GameParametersMap[TGame];
+type GameParameters<TGame extends Game$1> = GameParametersMap[TGame];
 type GetGameParametersOptions = SuiClientTypes.CoreClientMethodOptions & {
     coinType?: string;
     ignoreCache?: boolean;
@@ -250,7 +277,7 @@ declare class SuigarClient {
      * @param options Optional coin type, cache override, and abort signal.
      * @returns Parsed game parameters typed for the requested game.
      */
-    getGameParameters<TGame extends Game>(game: TGame, options?: GetGameParametersOptions): Promise<GameParameters<TGame>>;
+    getGameParameters<TGame extends Game$1>(game: TGame, options?: GetGameParametersOptions): Promise<GameParameters<TGame>>;
     /**
      * Lists unresolved PvP coinflip games from the configured registry and resolves
      * each entry into parsed on-chain game state.
@@ -272,26 +299,9 @@ declare class SuigarClient {
      * registry page. When `throwOnError` is `false`, entries that fail object fetch
      * or parse are omitted from the returned array.
      */
-    getPvPCoinflipGames(options?: WithThrowOnError<Omit<SuiClientTypes.ListDynamicFieldsOptions, 'parentId'>>): Promise<{
+    getPvPCoinflipGames(options?: WithThrowOnError<Omit<SuiClientTypes.ListDynamicFieldsOptions, 'parentId'>>): Promise<((typeof Game)['$inferType'] & {
         coinType: string;
-        id: string;
-        creator: string;
-        creator_is_tails: boolean;
-        is_private: boolean;
-        creator_metadata: {
-            contents: {
-                key: string;
-                value: number[];
-            }[];
-        };
-        joiner: string;
-        winner: string;
-        stake_per_player: string;
-        house_edge_bps: string;
-        stake_pot: {
-            value: string;
-        };
-    }[]>;
+    })[]>;
     /**
      * BCS struct constructors for decoding on-chain objects and events related to Suigar games.
      *

package/dist/index.d.ts

@@ -2,9 +2,36 @@ import { M as MoveStruct } from './index-3P_LBbDM.js';
 import * as _mysten_bcs from '@mysten/bcs';
 import { SuiClientTypes, ClientWithCoreApi } 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, G as Game, e as SuigarConfig, W as WithThrowOnError, P as PvPCoinflipAction, f as BuildPvPCoinflipTransactionOptions, g as SuigarExtensionOptions } from './games-BHYRg31e.js';
+import { S as StandardGame, B as BuildCoinflipTransactionOptions, a as BuildWheelTransactionOptions, b as BuildLimboTransactionOptions, c as BuildPlinkoTransactionOptions, d as BuildRangeTransactionOptions, G as Game$1, e as SuigarConfig, W as WithThrowOnError, P as PvPCoinflipAction, f as BuildPvPCoinflipTransactionOptions, g as SuigarExtensionOptions } from './games-Da2uZvVJ.js';
 import '@mysten/sui/bcs';
 
+declare const Game: MoveStruct<{
+    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">;
+    is_private: _mysten_bcs.BcsType<boolean, boolean, "bool">;
+    creator_metadata: MoveStruct<{
+        contents: _mysten_bcs.BcsType<{
+            key: string;
+            value: number[];
+        }[], Iterable<{
+            key: string;
+            value: Iterable<number> & {
+                length: number;
+            };
+        }> & {
+            length: number;
+        }, string>;
+    }, "0x2::vec_map::VecMap<string, vector<u8>>">;
+    joiner: _mysten_bcs.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+    winner: _mysten_bcs.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+    stake_per_player: _mysten_bcs.BcsType<string, string | number | bigint, "u64">;
+    house_edge_bps: _mysten_bcs.BcsType<string, string | number | bigint, "u64">;
+    stake_pot: MoveStruct<{
+        value: _mysten_bcs.BcsType<string, string | number | bigint, "u64">;
+    }, "0x2::balance::Balance<phantom T0>">;
+}, "0xb43cf6583c0c15315c7e66f173af4be79ac40c38aad1fd92ec08638ab2026202::pvp_coinflip::Game<phantom T0>">;
+
 type WithoutConfig<T> = Omit<T, 'config'>;
 type BuildGameOptions<GameId extends StandardGame> = GameId extends 'coinflip' ? WithoutConfig<BuildCoinflipTransactionOptions> : GameId extends 'wheel' ? WithoutConfig<BuildWheelTransactionOptions> : GameId extends 'limbo' ? WithoutConfig<BuildLimboTransactionOptions> : GameId extends 'plinko' ? WithoutConfig<BuildPlinkoTransactionOptions> : GameId extends 'range' ? WithoutConfig<BuildRangeTransactionOptions> : never;
 
@@ -195,9 +222,9 @@ declare const GAME_SETTINGS: {
     };
 };
 type GameParametersMap = {
-    [TGame in Game]: ReturnType<(typeof GAME_SETTINGS)[TGame]['parameters']['parse']>;
+    [TGame in Game$1]: ReturnType<(typeof GAME_SETTINGS)[TGame]['parameters']['parse']>;
 };
-type GameParameters<TGame extends Game> = GameParametersMap[TGame];
+type GameParameters<TGame extends Game$1> = GameParametersMap[TGame];
 type GetGameParametersOptions = SuiClientTypes.CoreClientMethodOptions & {
     coinType?: string;
     ignoreCache?: boolean;
@@ -250,7 +277,7 @@ declare class SuigarClient {
      * @param options Optional coin type, cache override, and abort signal.
      * @returns Parsed game parameters typed for the requested game.
      */
-    getGameParameters<TGame extends Game>(game: TGame, options?: GetGameParametersOptions): Promise<GameParameters<TGame>>;
+    getGameParameters<TGame extends Game$1>(game: TGame, options?: GetGameParametersOptions): Promise<GameParameters<TGame>>;
     /**
      * Lists unresolved PvP coinflip games from the configured registry and resolves
      * each entry into parsed on-chain game state.
@@ -272,26 +299,9 @@ declare class SuigarClient {
      * registry page. When `throwOnError` is `false`, entries that fail object fetch
      * or parse are omitted from the returned array.
      */
-    getPvPCoinflipGames(options?: WithThrowOnError<Omit<SuiClientTypes.ListDynamicFieldsOptions, 'parentId'>>): Promise<{
+    getPvPCoinflipGames(options?: WithThrowOnError<Omit<SuiClientTypes.ListDynamicFieldsOptions, 'parentId'>>): Promise<((typeof Game)['$inferType'] & {
         coinType: string;
-        id: string;
-        creator: string;
-        creator_is_tails: boolean;
-        is_private: boolean;
-        creator_metadata: {
-            contents: {
-                key: string;
-                value: number[];
-            }[];
-        };
-        joiner: string;
-        winner: string;
-        stake_per_player: string;
-        house_edge_bps: string;
-        stake_pot: {
-            value: string;
-        };
-    }[]>;
+    })[]>;
     /**
      * BCS struct constructors for decoding on-chain objects and events related to Suigar games.
      *

package/dist/index.js

@@ -255,19 +255,19 @@ var PRICE_INFO_OBJECT_IDS = {
 };
 
 // src/configs/registry.mainnet.ts
-var PVP_COINFLIP_REGISTRY_ID = "0x3d73568546c539c1da3eb2b8fe917faef3c0acdbec78a67fe6d52800a0729349";
+var MAINNET_REGISTRY_IDS = {
+  pvpCoinflip: "0x3d73568546c539c1da3eb2b8fe917faef3c0acdbec78a67fe6d52800a0729349"
+};
 
 // src/configs/registry.testnet.ts
-var PVP_COINFLIP_REGISTRY_ID2 = "0x99f20d8e4be012ea14a681144ae72ac349d0a1a1585205880183eb167f075bad";
+var TESTNET_REGISTRY_IDS = {
+  pvpCoinflip: "0x99f20d8e4be012ea14a681144ae72ac349d0a1a1585205880183eb167f075bad"
+};
 
 // src/configs/registry.ts
 var REGISTRY_IDS = {
-  mainnet: {
-    pvpCoinflip: PVP_COINFLIP_REGISTRY_ID
-  },
-  testnet: {
-    pvpCoinflip: PVP_COINFLIP_REGISTRY_ID2
-  }
+  mainnet: { ...MAINNET_REGISTRY_IDS },
+  testnet: { ...TESTNET_REGISTRY_IDS }
 };
 
 // src/helpers/config.ts

package/package.json

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