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

package/dist/index.d.cts

@@ -1,121 +1,22 @@
-import { BcsType, BcsStruct } from '@mysten/sui/bcs';
-import { SuiClientTypes, ClientWithCoreApi } from '@mysten/sui/client';
+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';
-
-interface GetOptions<Include extends Omit<SuiClientTypes.ObjectInclude, 'content'> = {}> extends SuiClientTypes.GetObjectOptions<Include> {
-    client: ClientWithCoreApi;
-}
-interface GetManyOptions<Include extends Omit<SuiClientTypes.ObjectInclude, 'content'> = {}> extends SuiClientTypes.GetObjectsOptions<Include> {
-    client: ClientWithCoreApi;
-}
-declare class MoveStruct<T extends Record<string, BcsType<any>>, const Name extends string = string> extends BcsStruct<T, Name> {
-    get<Include extends Omit<SuiClientTypes.ObjectInclude, 'content' | 'json'> = {}>({ objectId, ...options }: GetOptions<Include>): Promise<SuiClientTypes.Object<Include & {
-        content: true;
-        json: true;
-    }> & {
-        json: BcsStruct<T>['$inferType'];
-    }>;
-    getMany<Include extends Omit<SuiClientTypes.ObjectInclude, 'content' | 'json'> = {}>({ client, ...options }: GetManyOptions<Include>): Promise<Array<SuiClientTypes.Object<Include & {
-        content: true;
-        json: true;
-    }> & {
-        json: BcsStruct<T>['$inferType'];
-    }>>;
-}
-
-type BetMetadataPrimitive = string | number | boolean | bigint;
-type BetMetadataValue = BetMetadataPrimitive | Uint8Array | number[];
-type BetMetadataInput = Record<string, BetMetadataValue | null | undefined>;
-
-declare const GAMES: readonly ["coinflip", "limbo", "plinko", "pvp-coinflip", "range", "wheel"];
-type Game = (typeof GAMES)[number];
-type StandardGame = Exclude<Game, PvPGame>;
-type PvPGame = 'pvp-coinflip';
-type CoinSide = 'heads' | 'tails';
-
-interface SuigarExtensionOptions<Name = 'suigar'> {
-    name?: Name;
-}
-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 SuigarConfig = {
-    packageIds: SuigarPackage;
-    coinTypes: SuigarCoinTypes;
-    priceInfoObjectIds: SuigarPriceInfoObjectId;
-};
-
-type SharedBetTransactionOptions = {
-    config: SuigarConfig;
-    owner: string;
-    coinType: string;
-    stake: number | bigint;
-    cashStake?: number | bigint;
-    betCount?: number | bigint;
-    metadata?: BetMetadataInput;
-    gasBudget?: number | bigint;
-    sender?: string;
-    allowGasCoinShortcut?: boolean;
-};
-
-type BuildCoinflipTransactionOptions = SharedBetTransactionOptions & {
-    side: CoinSide;
-};
-type BuildLimboTransactionOptions = SharedBetTransactionOptions & {
-    targetMultiplier: number;
-    scale?: number;
-};
-type BuildPlinkoTransactionOptions = SharedBetTransactionOptions & {
-    configId: number;
-};
-type BuildRangeTransactionOptions = SharedBetTransactionOptions & {
-    leftPoint: number;
-    rightPoint: number;
-    outOfRange?: boolean;
-    scale?: number;
-};
-type BuildWheelTransactionOptions = SharedBetTransactionOptions & {
-    configId: number;
-};
-type PvPCoinflipAction = 'create' | 'join' | 'cancel';
-type SharedPvPCoinflipTransactionOptions = {
-    config: SuigarConfig;
-    owner: string;
-    coinType: string;
-    metadata?: BetMetadataInput;
-    gasBudget?: number | bigint;
-    sender?: string;
-    allowGasCoinShortcut?: boolean;
-};
-type BuildCreatePvPCoinflipTransactionOptions = SharedPvPCoinflipTransactionOptions & {
-    stake: number | bigint;
-    side: CoinSide;
-    isPrivate?: boolean;
-};
-type BuildJoinPvPCoinflipTransactionOptions = SharedPvPCoinflipTransactionOptions & {
-    gameId: string;
-    stake: number | bigint;
-    extraObjectId: string;
-};
-type BuildCancelPvPCoinflipTransactionOptions = SharedPvPCoinflipTransactionOptions & {
-    gameId: string;
-};
-type BuildPvPCoinflipTransactionOptions<Action extends PvPCoinflipAction = PvPCoinflipAction> = Action extends 'create' ? BuildCreatePvPCoinflipTransactionOptions : Action extends 'join' ? BuildJoinPvPCoinflipTransactionOptions : Action extends 'cancel' ? BuildCancelPvPCoinflipTransactionOptions : never;
+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 '@mysten/sui/bcs';
 
 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;
 
-declare function suigar<const Name = 'suigar'>({ name, }?: SuigarExtensionOptions<Name>): {
+declare function suigar<const Name = 'suigar'>({ name, partner, }?: SuigarExtensionOptions<Name>): {
     name: Name;
     register: (client: ClientWithCoreApi) => SuigarClient;
 };
 declare class SuigarClient {
     #private;
-    constructor({ client }: {
+    constructor({ client, partner, }: {
         client: ClientWithCoreApi;
+        partner?: string;
     });
     /**
      * Returns the resolved SDK configuration for the connected network.
@@ -140,9 +41,113 @@ declare class SuigarClient {
      */
     serializeTransactionToBase64(transaction: Transaction, options?: Omit<BuildTransactionOptions, 'client'>): Promise<string>;
     /**
-     * BCS struct constructors for decoding Suigar events emitted on-chain.
+     * Lists unresolved PvP coinflip games from the configured registry and resolves
+     * each entry into parsed onchain game state.
+     *
+     * This fetches dynamic fields from the PvP coinflip registry object, then loads
+     * each referenced game object through `resolvePvPConflipGame()`. Registry
+     * membership is the unresolved-state signal: when a game is joined and resolved,
+     * 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.
+     *
+     * @param options Optional dynamic field pagination forwarded to `listDynamicFields()`, excluding `parentId`.
+     * @returns Parsed unresolved PvP coinflip game objects for the requested registry page.
+     */
+    getPvPCoinflipGames(options?: Omit<SuiClientTypes.ListDynamicFieldsOptions, 'parentId'>): Promise<{
+        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;
+        };
+    }[]>;
+    /**
+     * Fetches a PvP coinflip game object from chain and parses it into the SDK's
+     * normalized runtime shape.
+     *
+     * This resolves the raw object through the configured client, requires the
+     * object's `content` to be present, decodes that content with the generated
+     * `PvPCoinflipGame` BCS parser, and normalizes the generic coin type into a
+     * standard struct tag string. Use this when a product needs the current state
+     * of a specific PvP coinflip match before rendering join, cancel, or result UI.
+     *
+     * @param gameId On-chain object id of the PvP coinflip game.
+     * @returns Parsed PvP coinflip game state with a normalized `coinType`.
+     * @throws Error If the object cannot be decoded because no content was returned.
+     */
+    resolvePvPConflipGame(gameId: string): Promise<{
+        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.
+     *
+     * These can be used to parse the `content` field of on-chain objects and events into structured data with the
+     * expected types. For example, use `client.suigar.bcs.PvPCoinflipGame.parse(object.content)` to decode a PvP
+     * coinflip game object.
+     *
+     * Note that these constructors are not meant for encoding transaction arguments, as the SDK's transaction
+     * builders handle argument serialization internally. Use these primarily for decoding and parsing on-chain data.
      */
     bcs: {
+        /**
+         * Object representing the state of a PvP coinflip game, as stored on-chain.
+         */
+        PvPCoinflipGame: 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>">;
         /**
          * Event emitted at the end of a standard game (e.g., Coinflip, Limbo), containing the result and payout information.
          */
@@ -265,4 +270,4 @@ declare class SuigarClient {
     };
 }
 
-export { suigar };
+export { SuigarClient, suigar };

package/dist/index.d.ts

@@ -1,121 +1,22 @@
-import { BcsType, BcsStruct } from '@mysten/sui/bcs';
-import { SuiClientTypes, ClientWithCoreApi } from '@mysten/sui/client';
+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';
-
-interface GetOptions<Include extends Omit<SuiClientTypes.ObjectInclude, 'content'> = {}> extends SuiClientTypes.GetObjectOptions<Include> {
-    client: ClientWithCoreApi;
-}
-interface GetManyOptions<Include extends Omit<SuiClientTypes.ObjectInclude, 'content'> = {}> extends SuiClientTypes.GetObjectsOptions<Include> {
-    client: ClientWithCoreApi;
-}
-declare class MoveStruct<T extends Record<string, BcsType<any>>, const Name extends string = string> extends BcsStruct<T, Name> {
-    get<Include extends Omit<SuiClientTypes.ObjectInclude, 'content' | 'json'> = {}>({ objectId, ...options }: GetOptions<Include>): Promise<SuiClientTypes.Object<Include & {
-        content: true;
-        json: true;
-    }> & {
-        json: BcsStruct<T>['$inferType'];
-    }>;
-    getMany<Include extends Omit<SuiClientTypes.ObjectInclude, 'content' | 'json'> = {}>({ client, ...options }: GetManyOptions<Include>): Promise<Array<SuiClientTypes.Object<Include & {
-        content: true;
-        json: true;
-    }> & {
-        json: BcsStruct<T>['$inferType'];
-    }>>;
-}
-
-type BetMetadataPrimitive = string | number | boolean | bigint;
-type BetMetadataValue = BetMetadataPrimitive | Uint8Array | number[];
-type BetMetadataInput = Record<string, BetMetadataValue | null | undefined>;
-
-declare const GAMES: readonly ["coinflip", "limbo", "plinko", "pvp-coinflip", "range", "wheel"];
-type Game = (typeof GAMES)[number];
-type StandardGame = Exclude<Game, PvPGame>;
-type PvPGame = 'pvp-coinflip';
-type CoinSide = 'heads' | 'tails';
-
-interface SuigarExtensionOptions<Name = 'suigar'> {
-    name?: Name;
-}
-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 SuigarConfig = {
-    packageIds: SuigarPackage;
-    coinTypes: SuigarCoinTypes;
-    priceInfoObjectIds: SuigarPriceInfoObjectId;
-};
-
-type SharedBetTransactionOptions = {
-    config: SuigarConfig;
-    owner: string;
-    coinType: string;
-    stake: number | bigint;
-    cashStake?: number | bigint;
-    betCount?: number | bigint;
-    metadata?: BetMetadataInput;
-    gasBudget?: number | bigint;
-    sender?: string;
-    allowGasCoinShortcut?: boolean;
-};
-
-type BuildCoinflipTransactionOptions = SharedBetTransactionOptions & {
-    side: CoinSide;
-};
-type BuildLimboTransactionOptions = SharedBetTransactionOptions & {
-    targetMultiplier: number;
-    scale?: number;
-};
-type BuildPlinkoTransactionOptions = SharedBetTransactionOptions & {
-    configId: number;
-};
-type BuildRangeTransactionOptions = SharedBetTransactionOptions & {
-    leftPoint: number;
-    rightPoint: number;
-    outOfRange?: boolean;
-    scale?: number;
-};
-type BuildWheelTransactionOptions = SharedBetTransactionOptions & {
-    configId: number;
-};
-type PvPCoinflipAction = 'create' | 'join' | 'cancel';
-type SharedPvPCoinflipTransactionOptions = {
-    config: SuigarConfig;
-    owner: string;
-    coinType: string;
-    metadata?: BetMetadataInput;
-    gasBudget?: number | bigint;
-    sender?: string;
-    allowGasCoinShortcut?: boolean;
-};
-type BuildCreatePvPCoinflipTransactionOptions = SharedPvPCoinflipTransactionOptions & {
-    stake: number | bigint;
-    side: CoinSide;
-    isPrivate?: boolean;
-};
-type BuildJoinPvPCoinflipTransactionOptions = SharedPvPCoinflipTransactionOptions & {
-    gameId: string;
-    stake: number | bigint;
-    extraObjectId: string;
-};
-type BuildCancelPvPCoinflipTransactionOptions = SharedPvPCoinflipTransactionOptions & {
-    gameId: string;
-};
-type BuildPvPCoinflipTransactionOptions<Action extends PvPCoinflipAction = PvPCoinflipAction> = Action extends 'create' ? BuildCreatePvPCoinflipTransactionOptions : Action extends 'join' ? BuildJoinPvPCoinflipTransactionOptions : Action extends 'cancel' ? BuildCancelPvPCoinflipTransactionOptions : never;
+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 '@mysten/sui/bcs';
 
 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;
 
-declare function suigar<const Name = 'suigar'>({ name, }?: SuigarExtensionOptions<Name>): {
+declare function suigar<const Name = 'suigar'>({ name, partner, }?: SuigarExtensionOptions<Name>): {
     name: Name;
     register: (client: ClientWithCoreApi) => SuigarClient;
 };
 declare class SuigarClient {
     #private;
-    constructor({ client }: {
+    constructor({ client, partner, }: {
         client: ClientWithCoreApi;
+        partner?: string;
     });
     /**
      * Returns the resolved SDK configuration for the connected network.
@@ -140,9 +41,113 @@ declare class SuigarClient {
      */
     serializeTransactionToBase64(transaction: Transaction, options?: Omit<BuildTransactionOptions, 'client'>): Promise<string>;
     /**
-     * BCS struct constructors for decoding Suigar events emitted on-chain.
+     * Lists unresolved PvP coinflip games from the configured registry and resolves
+     * each entry into parsed onchain game state.
+     *
+     * This fetches dynamic fields from the PvP coinflip registry object, then loads
+     * each referenced game object through `resolvePvPConflipGame()`. Registry
+     * membership is the unresolved-state signal: when a game is joined and resolved,
+     * 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.
+     *
+     * @param options Optional dynamic field pagination forwarded to `listDynamicFields()`, excluding `parentId`.
+     * @returns Parsed unresolved PvP coinflip game objects for the requested registry page.
+     */
+    getPvPCoinflipGames(options?: Omit<SuiClientTypes.ListDynamicFieldsOptions, 'parentId'>): Promise<{
+        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;
+        };
+    }[]>;
+    /**
+     * Fetches a PvP coinflip game object from chain and parses it into the SDK's
+     * normalized runtime shape.
+     *
+     * This resolves the raw object through the configured client, requires the
+     * object's `content` to be present, decodes that content with the generated
+     * `PvPCoinflipGame` BCS parser, and normalizes the generic coin type into a
+     * standard struct tag string. Use this when a product needs the current state
+     * of a specific PvP coinflip match before rendering join, cancel, or result UI.
+     *
+     * @param gameId On-chain object id of the PvP coinflip game.
+     * @returns Parsed PvP coinflip game state with a normalized `coinType`.
+     * @throws Error If the object cannot be decoded because no content was returned.
+     */
+    resolvePvPConflipGame(gameId: string): Promise<{
+        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.
+     *
+     * These can be used to parse the `content` field of on-chain objects and events into structured data with the
+     * expected types. For example, use `client.suigar.bcs.PvPCoinflipGame.parse(object.content)` to decode a PvP
+     * coinflip game object.
+     *
+     * Note that these constructors are not meant for encoding transaction arguments, as the SDK's transaction
+     * builders handle argument serialization internally. Use these primarily for decoding and parsing on-chain data.
      */
     bcs: {
+        /**
+         * Object representing the state of a PvP coinflip game, as stored on-chain.
+         */
+        PvPCoinflipGame: 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>">;
         /**
          * Event emitted at the end of a standard game (e.g., Coinflip, Limbo), containing the result and payout information.
          */
@@ -265,4 +270,4 @@ declare class SuigarClient {
     };
 }
 
-export { suigar };
+export { SuigarClient, suigar };