@suigar/sdk 2.0.0-beta.0

package/dist/index.d.cts

@@ -0,0 +1,280 @@
+import { SuiClientTypes, ClientWithCoreApi } from '@mysten/sui/client';
+import { Transaction } from '@mysten/sui/transactions';
+import { BcsType, BcsStruct } from '@mysten/sui/bcs';
+
+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';
+
+type DeepPartial<T> = T extends object ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;
+
+interface SuigarOptions<Name = 'suigar'> extends DeepPartial<SuigarConfig> {
+    name?: Name;
+}
+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;
+};
+
+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;
+
+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>): {
+    name: Name;
+    register: (client: ClientWithCoreApi) => SuigarClient;
+};
+declare class SuigarClient {
+    #private;
+    constructor({ client, options, }: {
+        client: ClientWithCoreApi;
+        options: SuigarOptions;
+    });
+    /**
+     * Builds a transaction with the configured Sui client and returns the BCS bytes as a base64 string.
+     *
+     * @param transaction Transaction block to serialize.
+     * @returns Base64-encoded transaction bytes ready to send over the wire.
+     */
+    serializeTransactionToBase64(transaction: Transaction): Promise<string>;
+    /**
+     * BCS struct constructors for decoding Suigar events emitted on-chain.
+     */
+    bcs: {
+        /**
+         * Event emitted at the end of a standard game (e.g., Coinflip, Limbo), containing the result and payout information.
+         */
+        BetResultEvent: typeof BetResultEvent;
+        /**
+         * Event emitted when a PvP Coinflip game is created, containing the game configuration and initial state.
+         */
+        PvPCoinflipGameCreated: typeof GameCreatedEvent;
+        /**
+         * Event emitted when a PvP Coinflip game is resolved, containing the final outcome.
+         */
+        PvPCoinflipGameResolved: typeof GameResolvedEvent;
+        /**
+         * Event emitted when a PvP Coinflip game is cancelled.
+         */
+        PvPCoinflipGameCancelled: typeof GameCancelledEvent;
+    };
+    /**
+     * Transaction builders for Suigar games.
+     */
+    tx: {
+        /**
+         * Creates a standard game transaction for the provided game id.
+         *
+         * @param gameId Supported standard game identifier.
+         * @param options Transaction builder options for the selected game.
+         * @returns Prepared transaction for the selected game.
+         */
+        createBetTransaction: <GameId extends StandardGame>(gameId: GameId, options: BuildGameOptions<GameId>) => Transaction;
+        /**
+         * Creates a PvP coinflip transaction for the requested action.
+         *
+         * @param action PvP coinflip action to perform.
+         * @param options Transaction builder options for the selected action.
+         * @returns Prepared PvP coinflip transaction.
+         */
+        createPvPCoinflipTransaction: <Action extends PvPCoinflipAction>(action: Action, options: BuildPvPCoinflipTransactionOptions<Action>) => Transaction;
+    };
+}
+
+export { SuigarClient, suigar };

package/dist/index.d.ts

@@ -0,0 +1,280 @@
+import { SuiClientTypes, ClientWithCoreApi } from '@mysten/sui/client';
+import { Transaction } from '@mysten/sui/transactions';
+import { BcsType, BcsStruct } from '@mysten/sui/bcs';
+
+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';
+
+type DeepPartial<T> = T extends object ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;
+
+interface SuigarOptions<Name = 'suigar'> extends DeepPartial<SuigarConfig> {
+    name?: Name;
+}
+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;
+};
+
+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;
+
+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>): {
+    name: Name;
+    register: (client: ClientWithCoreApi) => SuigarClient;
+};
+declare class SuigarClient {
+    #private;
+    constructor({ client, options, }: {
+        client: ClientWithCoreApi;
+        options: SuigarOptions;
+    });
+    /**
+     * Builds a transaction with the configured Sui client and returns the BCS bytes as a base64 string.
+     *
+     * @param transaction Transaction block to serialize.
+     * @returns Base64-encoded transaction bytes ready to send over the wire.
+     */
+    serializeTransactionToBase64(transaction: Transaction): Promise<string>;
+    /**
+     * BCS struct constructors for decoding Suigar events emitted on-chain.
+     */
+    bcs: {
+        /**
+         * Event emitted at the end of a standard game (e.g., Coinflip, Limbo), containing the result and payout information.
+         */
+        BetResultEvent: typeof BetResultEvent;
+        /**
+         * Event emitted when a PvP Coinflip game is created, containing the game configuration and initial state.
+         */
+        PvPCoinflipGameCreated: typeof GameCreatedEvent;
+        /**
+         * Event emitted when a PvP Coinflip game is resolved, containing the final outcome.
+         */
+        PvPCoinflipGameResolved: typeof GameResolvedEvent;
+        /**
+         * Event emitted when a PvP Coinflip game is cancelled.
+         */
+        PvPCoinflipGameCancelled: typeof GameCancelledEvent;
+    };
+    /**
+     * Transaction builders for Suigar games.
+     */
+    tx: {
+        /**
+         * Creates a standard game transaction for the provided game id.
+         *
+         * @param gameId Supported standard game identifier.
+         * @param options Transaction builder options for the selected game.
+         * @returns Prepared transaction for the selected game.
+         */
+        createBetTransaction: <GameId extends StandardGame>(gameId: GameId, options: BuildGameOptions<GameId>) => Transaction;
+        /**
+         * Creates a PvP coinflip transaction for the requested action.
+         *
+         * @param action PvP coinflip action to perform.
+         * @param options Transaction builder options for the selected action.
+         * @returns Prepared PvP coinflip transaction.
+         */
+        createPvPCoinflipTransaction: <Action extends PvPCoinflipAction>(action: Action, options: BuildPvPCoinflipTransactionOptions<Action>) => Transaction;
+    };
+}
+
+export { SuigarClient, suigar };