@suigar/sdk 2.0.0-beta.0 → 2.0.0-beta.2

package/dist/index.d.ts

@@ -1,6 +1,28 @@
-import { SuiClientTypes, ClientWithCoreApi } from '@mysten/sui/client';
-import { Transaction } from '@mysten/sui/transactions';
 import { BcsType, BcsStruct } from '@mysten/sui/bcs';
+import { SuiClientTypes, ClientWithCoreApi } from '@mysten/sui/client';
+import * as _mysten_bcs from '@mysten/bcs';
+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[];
@@ -12,28 +34,18 @@ type StandardGame = Exclude<Game, PvPGame>;
 type PvPGame = 'pvp-coinflip';
 type CoinSide = 'heads' | 'tails';
 
-type DeepPartial<T> = T extends object ? {
-    [P in keyof T]?: DeepPartial<T[P]>;
-} : T;
-
-interface SuigarOptions<Name = 'suigar'> extends DeepPartial<SuigarConfig> {
+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 = {
-    sweetHousePackageId: string;
-    coinTypes: {
-        sui: string;
-        usdc: string;
-        usdcFlowx: string;
-    };
-    gamesPackageId: Record<Game, string>;
-    pyth: SuigarPythConfig;
-};
-type SuigarPythConfig = {
-    packageId?: string;
-    priceInfoObjectIds: Record<string, string>;
-    suiPriceInfoObjectId: string;
-    usdcPriceInfoObjectId: string;
+    packageIds: SuigarPackage;
+    coinTypes: SuigarCoinTypes;
+    priceInfoObjectIds: SuigarPriceInfoObjectId;
 };
 
 type SharedBetTransactionOptions = {
@@ -95,144 +107,37 @@ type BuildPvPCoinflipTransactionOptions<Action extends PvPCoinflipAction = PvPCo
 
 type BuildGameOptions<GameId extends StandardGame> = GameId extends 'coinflip' ? BuildCoinflipTransactionOptions : GameId extends 'wheel' ? BuildWheelTransactionOptions : GameId extends 'limbo' ? BuildLimboTransactionOptions : GameId extends 'plinko' ? BuildPlinkoTransactionOptions : GameId extends 'range' ? BuildRangeTransactionOptions : never;
 
-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'];
-    }>>;
-}
-
-/**************************************************************
- * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *
- **************************************************************/
-
-declare function BetResultEvent<T0 extends BcsType<any>>(...typeParameters: [
-    T0
-]): MoveStruct<{
-    player: BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
-    coin_type: MoveStruct<{
-        name: BcsType<string, string, "string">;
-    }, "0x0000000000000000000000000000000000000000000000000000000000000001::type_name::TypeName">;
-    stake_amount: BcsType<string, string | number | bigint, "u64">;
-    unsafe_oracle_usd_coin_price: MoveStruct<{
-        is_negative: BcsType<boolean, boolean, "bool">;
-        exp: MoveStruct<{
-            bits: BcsType<string, string | number | bigint, "u64">;
-        }, "0xf391858d2a08473e8d4defcc8df89976bd7b123d3865c6b9341b237f7853dbbc::i64::I64">;
-        mant: BcsType<string, string | number | bigint, "u64">;
-    }, "0xf391858d2a08473e8d4defcc8df89976bd7b123d3865c6b9341b237f7853dbbc::float::Float">;
-    adjusted_oracle_usd_coin_price: MoveStruct<{
-        is_negative: BcsType<boolean, boolean, "bool">;
-        exp: MoveStruct<{
-            bits: BcsType<string, string | number | bigint, "u64">;
-        }, "0xf391858d2a08473e8d4defcc8df89976bd7b123d3865c6b9341b237f7853dbbc::i64::I64">;
-        mant: BcsType<string, string | number | bigint, "u64">;
-    }, "0xf391858d2a08473e8d4defcc8df89976bd7b123d3865c6b9341b237f7853dbbc::float::Float">;
-    outcome_amount: BcsType<string, string | number | bigint, "u64">;
-    game_details: MoveStruct<{
-        contents: BcsType<{
-            key: string;
-            value: number[];
-        }[], Iterable<{
-            key: string;
-            value: Iterable<number> & {
-                length: number;
-            };
-        }> & {
-            length: number;
-        }, string>;
-    }, "0x2::vec_map::VecMap<string, vector<u8>>">;
-    metadata: MoveStruct<{
-        contents: BcsType<{
-            key: string;
-            value: number[];
-        }[], Iterable<{
-            key: string;
-            value: Iterable<number> & {
-                length: number;
-            };
-        }> & {
-            length: number;
-        }, string>;
-    }, "0x2::vec_map::VecMap<string, vector<u8>>">;
-}, `0xf391858d2a08473e8d4defcc8df89976bd7b123d3865c6b9341b237f7853dbbc::core::BetResultEvent<${T0["name"]}>`>;
-
-declare function GameCreatedEvent<T0 extends BcsType<any>>(...typeParameters: [
-    T0
-]): MoveStruct<{
-    game_id: BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
-    creator: BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
-    creator_is_tails: BcsType<boolean, boolean, "bool">;
-    is_private: BcsType<boolean, boolean, "bool">;
-    joiner_is_tails: BcsType<boolean, boolean, "bool">;
-    stake_per_player: BcsType<string, string | number | bigint, "u64">;
-    house_edge_bps: BcsType<string, string | number | bigint, "u64">;
-    coin_type: MoveStruct<{
-        name: BcsType<string, string, "string">;
-    }, "0x0000000000000000000000000000000000000000000000000000000000000001::type_name::TypeName">;
-}, `0xb43cf6583c0c15315c7e66f173af4be79ac40c38aad1fd92ec08638ab2026202::pvp_coinflip::GameCreatedEvent<${T0["name"]}>`>;
-declare function GameResolvedEvent<T0 extends BcsType<any>>(...typeParameters: [
-    T0
-]): MoveStruct<{
-    game_id: BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
-    creator: BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
-    joiner: BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
-    winner: BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
-    creator_is_tails: BcsType<boolean, boolean, "bool">;
-    is_private: BcsType<boolean, boolean, "bool">;
-    joiner_is_tails: BcsType<boolean, boolean, "bool">;
-    stake_per_player: BcsType<string, string | number | bigint, "u64">;
-    total_pot: BcsType<string, string | number | bigint, "u64">;
-    house_edge_amount: BcsType<string, string | number | bigint, "u64">;
-    payout_amount: BcsType<string, string | number | bigint, "u64">;
-    coin_type: MoveStruct<{
-        name: BcsType<string, string, "string">;
-    }, "0x0000000000000000000000000000000000000000000000000000000000000001::type_name::TypeName">;
-}, `0xb43cf6583c0c15315c7e66f173af4be79ac40c38aad1fd92ec08638ab2026202::pvp_coinflip::GameResolvedEvent<${T0["name"]}>`>;
-declare function GameCancelledEvent<T0 extends BcsType<any>>(...typeParameters: [
-    T0
-]): MoveStruct<{
-    game_id: BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
-    creator: BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
-    creator_is_tails: BcsType<boolean, boolean, "bool">;
-    is_private: BcsType<boolean, boolean, "bool">;
-    stake_per_player: BcsType<string, string | number | bigint, "u64">;
-    coin_type: MoveStruct<{
-        name: BcsType<string, string, "string">;
-    }, "0x0000000000000000000000000000000000000000000000000000000000000001::type_name::TypeName">;
-}, `0xb43cf6583c0c15315c7e66f173af4be79ac40c38aad1fd92ec08638ab2026202::pvp_coinflip::GameCancelledEvent<${T0["name"]}>`>;
-
-declare function suigar<const Name = 'suigar'>({ name, ...options }?: SuigarOptions<Name>): {
+declare function suigar<const Name = 'suigar'>({ name, }?: SuigarExtensionOptions<Name>): {
     name: Name;
     register: (client: ClientWithCoreApi) => SuigarClient;
 };
 declare class SuigarClient {
     #private;
-    constructor({ client, options, }: {
+    constructor({ client }: {
         client: ClientWithCoreApi;
-        options: SuigarOptions;
     });
     /**
-     * Builds a transaction with the configured Sui client and returns the BCS bytes as a base64 string.
+     * Returns the resolved SDK configuration for the connected network.
+     *
+     * This is primarily useful for debugging or inspecting which package ids,
+     * supported coin types, and price info object ids the SDK resolved for the
+     * current client network.
+     *
+     * @returns Network-resolved Suigar configuration.
+     */
+    getConfig(): SuigarConfig;
+    /**
+     * Builds a transaction with the configured Sui client and encodes the resulting BCS bytes as base64.
+     *
+     * Use this when an external wallet, API, or transport expects the built transaction payload as a base64 string
+     * instead of raw bytes. The SDK always injects the configured Sui client, so `options` accepts the standard
+     * transaction build options except for `client`.
      *
-     * @param transaction Transaction block to serialize.
+     * @param transaction Transaction to build and serialize.
+     * @param options Optional transaction build options forwarded to `transaction.build()`, excluding `client`.
      * @returns Base64-encoded transaction bytes ready to send over the wire.
      */
-    serializeTransactionToBase64(transaction: Transaction): Promise<string>;
+    serializeTransactionToBase64(transaction: Transaction, options?: Omit<BuildTransactionOptions, 'client'>): Promise<string>;
     /**
      * BCS struct constructors for decoding Suigar events emitted on-chain.
      */
@@ -240,19 +145,101 @@ declare class SuigarClient {
         /**
          * Event emitted at the end of a standard game (e.g., Coinflip, Limbo), containing the result and payout information.
          */
-        BetResultEvent: typeof BetResultEvent;
+        BetResultEvent: MoveStruct<{
+            player: _mysten_bcs.BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+            coin_type: MoveStruct<{
+                name: _mysten_bcs.BcsType<string, string, "string">;
+            }, "0x0000000000000000000000000000000000000000000000000000000000000001::type_name::TypeName">;
+            stake_amount: _mysten_bcs.BcsType<string, string | number | bigint, "u64">;
+            unsafe_oracle_usd_coin_price: MoveStruct<{
+                is_negative: _mysten_bcs.BcsType<boolean, boolean, "bool">;
+                exp: MoveStruct<{
+                    bits: _mysten_bcs.BcsType<string, string | number | bigint, "u64">;
+                }, "0xf391858d2a08473e8d4defcc8df89976bd7b123d3865c6b9341b237f7853dbbc::i64::I64">;
+                mant: _mysten_bcs.BcsType<string, string | number | bigint, "u64">;
+            }, "0xf391858d2a08473e8d4defcc8df89976bd7b123d3865c6b9341b237f7853dbbc::float::Float">;
+            adjusted_oracle_usd_coin_price: MoveStruct<{
+                is_negative: _mysten_bcs.BcsType<boolean, boolean, "bool">;
+                exp: MoveStruct<{
+                    bits: _mysten_bcs.BcsType<string, string | number | bigint, "u64">;
+                }, "0xf391858d2a08473e8d4defcc8df89976bd7b123d3865c6b9341b237f7853dbbc::i64::I64">;
+                mant: _mysten_bcs.BcsType<string, string | number | bigint, "u64">;
+            }, "0xf391858d2a08473e8d4defcc8df89976bd7b123d3865c6b9341b237f7853dbbc::float::Float">;
+            outcome_amount: _mysten_bcs.BcsType<string, string | number | bigint, "u64">;
+            game_details: 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>>">;
+            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>>">;
+        }, "0xf391858d2a08473e8d4defcc8df89976bd7b123d3865c6b9341b237f7853dbbc::core::BetResultEvent<phantom T0>">;
         /**
          * Event emitted when a PvP Coinflip game is created, containing the game configuration and initial state.
          */
-        PvPCoinflipGameCreated: typeof GameCreatedEvent;
+        PvPCoinflipGameCreated: 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">;
+            is_private: _mysten_bcs.BcsType<boolean, boolean, "bool">;
+            joiner_is_tails: _mysten_bcs.BcsType<boolean, boolean, "bool">;
+            stake_per_player: _mysten_bcs.BcsType<string, string | number | bigint, "u64">;
+            house_edge_bps: _mysten_bcs.BcsType<string, string | number | bigint, "u64">;
+            coin_type: MoveStruct<{
+                name: _mysten_bcs.BcsType<string, string, "string">;
+            }, "0x0000000000000000000000000000000000000000000000000000000000000001::type_name::TypeName">;
+        }, "0xb43cf6583c0c15315c7e66f173af4be79ac40c38aad1fd92ec08638ab2026202::pvp_coinflip::GameCreatedEvent<phantom T0>">;
         /**
          * Event emitted when a PvP Coinflip game is resolved, containing the final outcome.
          */
-        PvPCoinflipGameResolved: typeof GameResolvedEvent;
+        PvPCoinflipGameResolved: 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]">;
+            winner: _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">;
+            joiner_is_tails: _mysten_bcs.BcsType<boolean, boolean, "bool">;
+            stake_per_player: _mysten_bcs.BcsType<string, string | number | bigint, "u64">;
+            total_pot: _mysten_bcs.BcsType<string, string | number | bigint, "u64">;
+            house_edge_amount: _mysten_bcs.BcsType<string, string | number | bigint, "u64">;
+            payout_amount: _mysten_bcs.BcsType<string, string | number | bigint, "u64">;
+            coin_type: MoveStruct<{
+                name: _mysten_bcs.BcsType<string, string, "string">;
+            }, "0x0000000000000000000000000000000000000000000000000000000000000001::type_name::TypeName">;
+        }, "0xb43cf6583c0c15315c7e66f173af4be79ac40c38aad1fd92ec08638ab2026202::pvp_coinflip::GameResolvedEvent<phantom T0>">;
         /**
          * Event emitted when a PvP Coinflip game is cancelled.
          */
-        PvPCoinflipGameCancelled: typeof GameCancelledEvent;
+        PvPCoinflipGameCancelled: 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">;
+            is_private: _mysten_bcs.BcsType<boolean, boolean, "bool">;
+            stake_per_player: _mysten_bcs.BcsType<string, string | number | bigint, "u64">;
+            coin_type: MoveStruct<{
+                name: _mysten_bcs.BcsType<string, string, "string">;
+            }, "0x0000000000000000000000000000000000000000000000000000000000000001::type_name::TypeName">;
+        }, "0xb43cf6583c0c15315c7e66f173af4be79ac40c38aad1fd92ec08638ab2026202::pvp_coinflip::GameCancelledEvent<phantom T0>">;
     };
     /**
      * Transaction builders for Suigar games.
@@ -277,4 +264,4 @@ declare class SuigarClient {
     };
 }
 
-export { SuigarClient, suigar };
+export { suigar };