@suigar/mcp 0.1.0 → 0.1.1

package/dist/index.d.cts

@@ -1,10 +1,820 @@
-import { GameMcpSupport, McpExecutionSurface, SUPPORTED_MCP_TOOL_NAMES, SuigarMcpToolName, buildMcpSupportCatalog, getMcpSupportForGame } from "./mcp-support.cjs";
-import { BetCoinSource, BetMetadataInput, BetMetadataInputValue, BetMetadataPrimitive, BuilderMode, CasinoBetGameId, CoinReadClient, CoinSide, ConfigInspection, ReadOnlyPlan, SharedBuildOptions, SuigarConfig, SuigarConfigInput, SuigarNetwork, SupportedGameId, TransactionSummary } from "./types.cjs";
-import { assertRequiredConfig, buildGraphqlUrl, buildProviderUrl, getRequiredConfigKeysForGame, inspectResolvedConfig, parseApiUrl, resolveGamePackageId, resolveGameSettingsId, resolvePythPriceInfoId, resolveSuigarConfig } from "./config.cjs";
-import { getCurrencyInfo, getGameMetadata, listConfiguredCurrencies, listSupportedGames, readConfigMetadata } from "./metadata.cjs";
-import { resolveBetCoin } from "./coin.cjs";
-import { createReadOnlyClientBundle, dryRunTransaction, sanitizeForJson, serializeTransactionToBase64 } from "./client.cjs";
-import { buildCoinflipTransaction, buildLimboTransaction, buildPlinkoTransaction, buildPvpCoinflipCancelTransaction, buildPvpCoinflipCreateTransaction, buildPvpCoinflipJoinTransaction, buildRangeTransaction, buildWheelTransaction, summarizeTransaction } from "./transactions.cjs";
-import { buildCoinflipTransactionTool, buildLimboTransactionTool, buildPlinkoTransactionTool, buildPvpCoinflipCancelTransactionTool, buildPvpCoinflipCreateTransactionTool, buildPvpCoinflipJoinTransactionTool, buildRangeTransactionTool, buildWheelTransactionTool, readConfigTool, readGameMetadataTool } from "./tools.cjs";
 import { createSuigarMcpServer, startSuigarMcpServer } from "./server.cjs";
+import { SuiGraphQLClient } from "@mysten/sui/graphql";
+import { SuiGrpcClient } from "@mysten/sui/grpc";
+import { Transaction } from "@mysten/sui/transactions";
+
+//#region ../currency-registry/dist/index.d.mts
+//#region src/index.d.ts
+type CurrencyFamilyId = 'sui' | 'usdc';
+type ConfiguredCurrencyId = 'sui' | 'usdc';
+type ConfiguredCurrencyEntry = {
+  id: ConfiguredCurrencyId;
+  familyId: CurrencyFamilyId;
+  symbol: string;
+  name: string;
+  type: string;
+  normalizedType: string;
+  decimals: number;
+};
+//#endregion
+//#region ../game-registry/dist/index.d.mts
+//#region src/index.d.ts
+type GameId = 'coinflip' | 'pvp-coinflip' | 'lootbox' | 'slots' | 'limbo' | 'plinko' | 'wheel' | 'range' | 'soccer';
+type GameModule = 'coinflip' | 'pvp_coinflip' | 'lootbox' | 'slots' | 'limbo' | 'plinko' | 'wheel' | 'range' | 'soccer';
+type GameStatus = 'active' | 'disabled' | 'hidden';
+type OnchainGameSettingsId = 'coinflip' | 'pvp-coinflip' | 'range' | 'limbo' | 'wheel' | 'plinko' | 'soccer' | 'rps';
+interface GameDefinition {
+  id: GameId;
+  name: string;
+  module: GameModule;
+  eventTypeName: string;
+  description?: string;
+  aliases: string[];
+  tags?: string[];
+  status?: GameStatus;
+  updatedAt?: string;
+}
+interface OnchainGameSettingsDefinition {
+  id: OnchainGameSettingsId;
+  moduleName: string;
+  keyName: string;
+  settingsStructName: string;
+  parametersStructName: string;
+}
+//#endregion
+//#region ../sui-rpc-pool/dist/index.d.mts
+//#region src/index.d.ts
+type NetworkName = 'mainnet' | 'testnet' | 'devnet' | 'localnet' | (string & {});
+type SuiNetwork = NetworkName;
+type ResilientGrpcPoolOptions = {
+  network?: string;
+  providerUrl?: string;
+  extraPublicEndpoints?: string[];
+  defaultPublicEndpoints?: string[];
+  requestTimeoutMs?: number;
+  maxAttempts?: number;
+  cooldownMs?: number;
+  maxCooldownMs?: number;
+  failureThreshold?: number;
+  retryBackoffMs?: number;
+  maxRetryRounds?: number;
+  debug?: boolean;
+};
+type ResilientGrpcCallOptions<T = unknown> = {
+  isDeterministicError?: (error: unknown) => boolean;
+  resolveDeterministicError?: (error: unknown) => T | undefined;
+};
+type SuiObjectDataOptions = {
+  showType?: boolean;
+  showOwner?: boolean;
+  showPreviousTransaction?: boolean;
+  showStorageRebate?: boolean;
+  showContent?: boolean;
+  showDisplay?: boolean;
+  showBcs?: boolean;
+};
+type SuiParsedData = {
+  dataType?: string;
+  type?: string;
+  fields?: Record<string, unknown>;
+  hasPublicTransfer?: boolean;
+} & Record<string, unknown>;
+type ObjectOwner = {
+  AddressOwner: string;
+} | {
+  ObjectOwner: string;
+} | {
+  Shared: {
+    initial_shared_version?: string;
+  } | Record<string, unknown>;
+} | {
+  Immutable: true;
+} | {
+  ConsensusAddressOwner: {
+    owner?: string;
+    startVersion?: string;
+  };
+} | Record<string, unknown>;
+type SuiObjectData = {
+  objectId?: string;
+  version?: string;
+  digest?: string;
+  type?: string;
+  owner?: ObjectOwner;
+  previousTransaction?: string;
+  storageRebate?: string;
+  content?: SuiParsedData | null;
+  bcs?: {
+    bcsBytes: string;
+  };
+};
+type SuiObjectResponse = {
+  data: SuiObjectData | null;
+  error?: Record<string, unknown>;
+};
+type GetObjectParams = {
+  id: string;
+  options?: SuiObjectDataOptions | null;
+};
+type MultiGetObjectsParams = {
+  ids: string[];
+  options?: SuiObjectDataOptions | null;
+};
+type GetOwnedObjectsParams = {
+  owner: string;
+  filter?: {
+    StructType: string;
+  } | {
+    MoveModule: {
+      package: string;
+      module: string;
+    };
+  } | {
+    MatchAll: unknown[];
+  } | {
+    MatchAny: unknown[];
+  } | {
+    MatchNone: unknown[];
+  } | Record<string, unknown> | null;
+  options?: SuiObjectDataOptions | null;
+  cursor?: string | null;
+  limit?: number | null;
+};
+type PaginatedObjectsResponse = {
+  data: SuiObjectResponse[];
+  hasNextPage: boolean;
+  nextCursor: string | null;
+};
+type GetCoinsParams = {
+  owner: string;
+  coinType?: string | null;
+  cursor?: string | null;
+  limit?: number | null;
+};
+type PaginatedCoins = {
+  data: Array<{
+    coinObjectId: string;
+    version: string;
+    digest: string;
+    coinType: string;
+    balance: string;
+    previousTransaction: string;
+  }>;
+  hasNextPage: boolean;
+  nextCursor: string | null;
+};
+type GetBalanceParams = {
+  owner: string;
+  coinType?: string | null;
+};
+type CoinBalance = {
+  coinType: string;
+  totalBalance: string;
+  coinObjectCount: number;
+  lockedBalance: Record<string, string>;
+};
+type GetAllBalancesParams = {
+  owner: string;
+};
+type DynamicFieldInfo = {
+  name: {
+    type?: string;
+    value?: unknown;
+    bcsName?: string;
+  } & Record<string, unknown>;
+  bcsEncoding: 'base64';
+  bcsName: string;
+  type: 'DynamicField' | 'DynamicObject';
+  objectType: string;
+  objectId: string;
+  version: string;
+  digest: string;
+};
+type DynamicFieldPage = {
+  data: DynamicFieldInfo[];
+  hasNextPage: boolean;
+  nextCursor: string | null;
+};
+type GetDynamicFieldsParams = {
+  parentId: string;
+  cursor?: string | null;
+  limit?: number | null;
+};
+type GetDynamicFieldObjectParams = {
+  parentId: string;
+  name: {
+    type?: string;
+    value?: unknown;
+    bcsName?: string;
+  } & Record<string, unknown>;
+};
+type PaginatedStrings = {
+  data: string[];
+  hasNextPage: boolean;
+  nextCursor: string | null;
+};
+type ResolveNameServiceNamesParams = {
+  address: string;
+  limit?: number | null;
+};
+type ResolveNameServiceAddressParams = {
+  name: string;
+};
+type EventId = {
+  txDigest: string;
+  eventSeq: string;
+  cursor?: string;
+};
+type SuiEvent = {
+  id: EventId;
+  type: string;
+  packageId?: string;
+  transactionModule?: string;
+  sender?: string;
+  parsedJson?: Record<string, unknown> | null;
+  bcs?: string;
+  timestampMs?: string | null;
+};
+type SuiEventFilter = {
+  MoveEventType: string;
+} | {
+  MoveEventModule: {
+    package: string;
+    module: string;
+  };
+} | {
+  Sender: string;
+};
+type QueryEventsParams = {
+  query: SuiEventFilter;
+  cursor?: EventId | null;
+  limit?: number | null;
+  order?: 'ascending' | 'descending';
+};
+type PaginatedEvents = {
+  data: SuiEvent[];
+  hasNextPage: boolean;
+  nextCursor: EventId | null;
+};
+type SuiObjectChangeCreated = {
+  type: 'created';
+  sender?: string;
+  owner?: ObjectOwner;
+  objectType?: string;
+  objectId: string;
+  version?: string;
+  digest?: string;
+};
+type SuiObjectChange = SuiObjectChangeCreated | {
+  type: 'mutated' | 'deleted' | 'transferred' | 'published' | 'wrapped';
+  sender?: string;
+  owner?: ObjectOwner;
+  objectType?: string;
+  objectId: string;
+  version?: string;
+  digest?: string;
+};
+type SuiTransactionBlockResponse = {
+  digest: string;
+  transaction?: {
+    data?: Record<string, unknown>;
+  };
+  effects?: {
+    status: {
+      status: 'success' | 'failure';
+      error?: string;
+    };
+    transactionDigest?: string;
+    gasUsed?: Record<string, unknown>;
+    created?: Array<{
+      owner?: ObjectOwner;
+      reference?: {
+        objectId: string;
+        version?: string;
+        digest?: string;
+      };
+    }>;
+    mutated?: Array<{
+      owner?: ObjectOwner;
+      reference?: {
+        objectId: string;
+        version?: string;
+        digest?: string;
+      };
+    }>;
+  };
+  events?: SuiEvent[];
+  balanceChanges?: Array<{
+    owner: ObjectOwner | null;
+    coinType: string;
+    amount: string;
+  }>;
+  objectChanges?: SuiObjectChange[];
+  timestampMs?: string | null;
+};
+type QueryTransactionBlocksParams = {
+  filter?: {
+    FromAddress?: string;
+    ToAddress?: string;
+  } | null;
+  options?: {
+    showInput?: boolean;
+    showEffects?: boolean;
+    showEvents?: boolean;
+    showBalanceChanges?: boolean;
+    showObjectChanges?: boolean;
+  } | null;
+  cursor?: string | null;
+  limit?: number | null;
+  order?: 'ascending' | 'descending';
+};
+type PaginatedTransactionResponse = {
+  data: SuiTransactionBlockResponse[];
+  hasNextPage: boolean;
+  nextCursor: string | null;
+};
+type WaitForTransactionParams = {
+  digest?: string;
+  result?: unknown;
+  options?: {
+    showEffects?: boolean;
+    showEvents?: boolean;
+    showBalanceChanges?: boolean;
+    showObjectChanges?: boolean;
+    showInput?: boolean;
+  } | null;
+  timeout?: number;
+};
+type SuiCompatClient = {
+  getObject(params: GetObjectParams): Promise<SuiObjectResponse>;
+  multiGetObjects(params: MultiGetObjectsParams): Promise<SuiObjectResponse[]>;
+  getOwnedObjects(params: GetOwnedObjectsParams): Promise<PaginatedObjectsResponse>;
+  getCoins(params: GetCoinsParams): Promise<PaginatedCoins>;
+  getBalance(params: GetBalanceParams): Promise<CoinBalance>;
+  getAllBalances(params: GetAllBalancesParams): Promise<CoinBalance[]>;
+  getDynamicFields(params: GetDynamicFieldsParams): Promise<DynamicFieldPage>;
+  getDynamicFieldObject(params: GetDynamicFieldObjectParams): Promise<SuiObjectResponse>;
+  resolveNameServiceNames(params: ResolveNameServiceNamesParams): Promise<PaginatedStrings>;
+  resolveNameServiceAddress(params: ResolveNameServiceAddressParams): Promise<string | null>;
+  getReferenceGasPrice(): Promise<bigint>;
+  queryEvents(params: QueryEventsParams): Promise<PaginatedEvents>;
+  queryTransactionBlocks(params: QueryTransactionBlocksParams): Promise<PaginatedTransactionResponse>;
+  waitForTransaction(params: WaitForTransactionParams): Promise<SuiTransactionBlockResponse>;
+};
+type BuildSuiCompatClientOptions = {
+  network: SuiNetwork;
+  defaultCoinType?: string;
+  graphqlUrl?: string;
+  graphqlClient?: SuiGraphQLClient;
+  grpcPool?: ResilientGrpcPool;
+  resolveGrpcClient?: (endpointUrl: string) => SuiGrpcClient;
+  providerGrpcUrl?: string;
+};
+declare class ResilientGrpcPool {
+  private readonly network;
+  private readonly providerUrl;
+  private readonly endpoints;
+  private readonly maxAttempts;
+  private readonly failureThreshold;
+  private readonly cooldownMs;
+  private readonly maxCooldownMs;
+  private readonly requestTimeoutMs;
+  private readonly retryBackoffMs;
+  private readonly maxRetryRounds;
+  private readonly debug;
+  constructor(options: ResilientGrpcPoolOptions);
+  getProviderUrl(): string;
+  call<T>(method: string, invoke: (endpointUrl: string) => Promise<T>, options?: ResilientGrpcCallOptions<T>): Promise<T>;
+  private pickAttemptOrder;
+  private endpointScore;
+  private invoke;
+  private markSuccess;
+  private markFailure;
+}
+type ResilientSuiClientRuntimeOptions = ResilientGrpcPoolOptions;
+type ResilientSuiCompatClientOptions = Omit<BuildSuiCompatClientOptions, 'network' | 'grpcPool' | 'providerGrpcUrl' | 'resolveGrpcClient'> & {
+  rawClient?: SuiGrpcClient;
+};
+declare class ResilientSuiClientRuntime {
+  readonly network: SuiNetwork;
+  readonly grpcPool: ResilientGrpcPool;
+  private readonly grpcClientByUrl;
+  constructor(options: ResilientSuiClientRuntimeOptions);
+  getProviderUrl(): string;
+  getGrpcClient(endpointUrl?: string): SuiGrpcClient;
+  createCompatClient(options?: ResilientSuiCompatClientOptions): SuiCompatClient;
+}
+//#endregion
+//#region src/mcp-support.d.ts
+type SuigarMcpToolName = 'read_config' | 'read_game_metadata' | 'build_coinflip_transaction' | 'build_limbo_transaction' | 'build_plinko_transaction' | 'build_wheel_transaction' | 'build_range_transaction' | 'build_pvp_coinflip_create_transaction' | 'build_pvp_coinflip_join_transaction' | 'build_pvp_coinflip_cancel_transaction';
+type McpExecutionSurface = 'onchain' | 'backend';
+type GameMcpSupport = {
+  executionSurface: McpExecutionSurface;
+  toolSupported: boolean;
+  primaryToolName: SuigarMcpToolName | null;
+};
+declare const SUPPORTED_MCP_TOOL_NAMES: SuigarMcpToolName[];
+declare const getMcpSupportForGame: (gameId: string) => GameMcpSupport;
+declare const buildMcpSupportCatalog: () => Readonly<{
+  serverName: "suigar";
+  supportedToolNames: SuigarMcpToolName[];
+}>;
+//#endregion
+//#region src/types.d.ts
+type SuigarNetwork = 'mainnet' | 'testnet' | 'devnet' | 'localnet' | (string & {});
+type BetMetadataPrimitive = string | number | boolean | bigint;
+type BetMetadataInputValue = BetMetadataPrimitive | Uint8Array | number[];
+type BetMetadataInput = Record<string, BetMetadataInputValue>;
+type CoinSide = 'heads' | 'tails';
+type BuilderMode = 'build' | 'dry-run' | 'read-only';
+type CasinoBetGameId = 'coinflip' | 'limbo' | 'plinko' | 'wheel' | 'range';
+type SupportedGameId = CasinoBetGameId | 'pvp-coinflip';
+type SuigarConfig = {
+  network: SuigarNetwork;
+  providerUrl: string;
+  graphqlUrl: string;
+  siteUrl: string;
+  suigarPackageId: string;
+  coinflipPackageId: string;
+  pvpCoinflipPackageId: string;
+  plinkoPackageId: string;
+  limboPackageId: string;
+  rangePackageId: string;
+  wheelPackageId: string;
+  sweethouseId: string;
+  suiCoinType: string;
+  usdcCoinType: string;
+  suiPythPriceInfoObjectId: string;
+  usdcPythPriceInfoObjectId: string;
+  coinflipSettingsId: string;
+  pvpCoinflipSettingsId: string;
+  plinkoSettingsId: string;
+  limboSettingsId: string;
+  rangeSettingsId: string;
+  wheelSettingsId: string;
+  pvpCoinflipRegistryId: string;
+};
+type SuigarConfigInput = Partial<SuigarConfig> & {
+  network?: SuigarNetwork;
+  providerUrl?: string;
+  graphqlUrl?: string;
+  config?: Partial<SuigarConfig>;
+};
+type ConfigInspection = {
+  config: SuigarConfig;
+  configuredCurrencies: ConfiguredCurrencyEntry[];
+  availableGames: Array<GameDefinition & {
+    mcpSupport: GameMcpSupport;
+  }>;
+  missingValues: Array<keyof SuigarConfig>;
+  mcp: {
+    serverName: string;
+    supportedToolNames: SuigarMcpToolName[];
+  };
+};
+type CoinReadClient = Pick<SuiCompatClient, 'getCoins' | 'getReferenceGasPrice'>;
+type BetCoinSource = {
+  kind: 'gas';
+  split?: boolean;
+} | {
+  kind: 'object-ids';
+  objectIds: string[];
+  split?: boolean;
+};
+type SharedBuildOptions = {
+  config?: SuigarConfigInput;
+  client?: CoinReadClient;
+  owner: string;
+  coinType: string;
+  stake: number | bigint;
+  cashStake?: number | bigint;
+  betCount?: number | bigint;
+  metadata?: BetMetadataInput;
+  partner?: string;
+  gasBudget?: number | bigint;
+  coinSource?: BetCoinSource;
+  sender?: string;
+  allowGasCoinShortcut?: boolean;
+};
+type TransactionSummary = {
+  sender: string | null;
+  gasBudget: string | null;
+  gasPrice: string | null;
+  commandCount: number;
+  commands: Array<{
+    kind: string;
+    target?: string;
+    typeArguments?: string[];
+  }>;
+  inputs: number;
+  objectInputs: string[];
+  game?: SupportedGameId;
+  coinType?: string;
+  stake?: string;
+};
+type ReadOnlyPlan = {
+  mode: 'read-only';
+  network: SuigarNetwork;
+  game: SupportedGameId;
+  config: ConfigInspection;
+  plan: {
+    target: string | null;
+    typeArguments: string[];
+    requiredConfigKeys: Array<keyof SuigarConfig>;
+    notes: string[];
+  };
+};
+//#endregion
+//#region src/config.d.ts
+declare const resolveSuigarConfig: (input?: SuigarConfigInput) => SuigarConfig;
+declare const getRequiredConfigKeysForGame: (game: SupportedGameId) => Array<keyof SuigarConfig>;
+declare const inspectResolvedConfig: (input?: SuigarConfigInput) => ConfigInspection;
+declare const resolvePythPriceInfoId: (coinType: string, configInput?: SuigarConfigInput) => string;
+declare const resolveGamePackageId: (game: SupportedGameId, configInput?: SuigarConfigInput) => string | null;
+declare const resolveGameSettingsId: (game: CasinoBetGameId | "pvp-coinflip", configInput?: SuigarConfigInput) => string | null;
+declare const assertRequiredConfig: (game: SupportedGameId, configInput?: SuigarConfigInput) => SuigarConfig;
+declare const buildProviderUrl: (network: string) => "https://fullnode.mainnet.sui.io:443" | "https://fullnode.devnet.sui.io:443" | "http://127.0.0.1:9000" | "https://fullnode.testnet.sui.io:443";
+declare const buildGraphqlUrl: (network: string) => string;
+declare const parseApiUrl: (value: string | undefined) => string;
+//#endregion
+//#region src/metadata.d.ts
+declare const listSupportedGames: ({
+  activeOnly
+}?: {
+  activeOnly?: boolean;
+}) => {
+  mcpSupport: GameMcpSupport;
+  id: GameId;
+  name: string;
+  module: GameModule;
+  eventTypeName: string;
+  description?: string;
+  aliases: string[];
+  tags?: string[];
+  status?: GameStatus;
+  updatedAt?: string;
+}[];
+declare const getGameMetadata: (game: string, configInput?: SuigarConfigInput) => {
+  mcpSupport: GameMcpSupport;
+  packageId: string | null;
+  settingsId: string | null;
+  onchainSettings: {
+    definition: OnchainGameSettingsDefinition;
+    objectType: string;
+    parametersTypePrefix: string;
+  } | null;
+  id: GameId;
+  name: string;
+  module: GameModule;
+  eventTypeName: string;
+  description?: string;
+  aliases: string[];
+  tags?: string[];
+  status?: GameStatus;
+  updatedAt?: string;
+};
+declare const listConfiguredCurrencies: (configInput?: SuigarConfigInput) => ConfiguredCurrencyEntry[];
+declare const getCurrencyInfo: (coinType: string, configInput?: SuigarConfigInput) => {
+  coinType: string;
+  configuredCurrencies: ConfiguredCurrencyEntry[];
+  metadata: {
+    symbol: string;
+    name: string;
+    decimals: number;
+  };
+};
+declare const readConfigMetadata: (configInput?: SuigarConfigInput) => ConfigInspection;
+//#endregion
+//#region src/coin.d.ts
+declare const resolveBetCoin: ({
+  tx,
+  coinType,
+  amount,
+  suiCoinType: _suiCoinType,
+  coinSource,
+  client,
+  owner,
+  allowGasCoinShortcut
+}: {
+  tx: Transaction;
+  coinType: string;
+  amount: number | bigint;
+  suiCoinType?: string;
+  coinSource?: BetCoinSource;
+  client?: CoinReadClient;
+  owner?: string;
+  allowGasCoinShortcut?: boolean;
+}) => Promise<{
+  NestedResult: [number, number];
+  $kind: "NestedResult";
+} | import("@mysten/sui/transactions").TransactionResult | {
+  $kind: "Input";
+  Input: number;
+  type?: "object";
+} | {
+  $kind: "GasCoin";
+  GasCoin: true;
+}>;
+//#endregion
+//#region src/client.d.ts
+declare const createReadOnlyClientBundle: (configInput?: SuigarConfigInput) => {
+  config: SuigarConfig;
+  runtime: ResilientSuiClientRuntime;
+  client: SuiCompatClient;
+  rawClient: SuiGrpcClient;
+};
+declare const serializeTransactionToBase64: (transaction: Transaction, client: SuiGrpcClient) => Promise<string>;
+declare const sanitizeForJson: (value: unknown) => unknown;
+declare const dryRunTransaction: (transaction: Transaction, configInput?: SuigarConfigInput) => Promise<unknown>;
+//#endregion
+//#region src/transactions.d.ts
+declare const buildCoinflipTransaction: (args: SharedBuildOptions & {
+  side: CoinSide;
+}) => Promise<Transaction>;
+declare const buildLimboTransaction: (args: SharedBuildOptions & {
+  targetMultiplier: number;
+}) => Promise<Transaction>;
+declare const buildPlinkoTransaction: (args: SharedBuildOptions & {
+  configId: number;
+}) => Promise<Transaction>;
+declare const buildWheelTransaction: (args: SharedBuildOptions & {
+  configId: number;
+}) => Promise<Transaction>;
+declare const buildRangeTransaction: (args: SharedBuildOptions & {
+  leftPoint: number;
+  rightPoint: number;
+  outOfRange?: boolean;
+  scale?: number;
+}) => Promise<Transaction>;
+declare const buildPvpCoinflipCreateTransaction: (args: SharedBuildOptions & {
+  creatorSide: CoinSide;
+  isPrivate?: boolean;
+}) => Promise<Transaction>;
+declare const buildPvpCoinflipJoinTransaction: (args: SharedBuildOptions & {
+  gameId: string;
+}) => Promise<Transaction>;
+declare const buildPvpCoinflipCancelTransaction: (args: Pick<SharedBuildOptions, "config" | "owner" | "sender" | "gasBudget"> & {
+  gameId: string;
+  coinType: string;
+}) => Transaction;
+declare const summarizeTransaction: (transaction: Transaction, context?: {
+  game?: SupportedGameId;
+  coinType?: string;
+  stake?: bigint | number;
+}) => TransactionSummary;
+//#endregion
+//#region src/tools.d.ts
+declare const readConfigTool: (input?: unknown) => Promise<ConfigInspection>;
+declare const readGameMetadataTool: (input?: unknown) => Promise<{
+  config: ConfigInspection;
+  game: {
+    mcpSupport: GameMcpSupport;
+    packageId: string | null;
+    settingsId: string | null;
+    onchainSettings: {
+      definition: OnchainGameSettingsDefinition;
+      objectType: string;
+      parametersTypePrefix: string;
+    } | null;
+    id: GameId;
+    name: string;
+    module: GameModule;
+    eventTypeName: string;
+    description?: string;
+    aliases: string[];
+    tags?: string[];
+    status?: GameStatus;
+    updatedAt?: string;
+  } | null;
+  currency: {
+    coinType: string;
+    configuredCurrencies: ConfiguredCurrencyEntry[];
+    metadata: {
+      symbol: string;
+      name: string;
+      decimals: number;
+    };
+  } | null;
+}>;
+declare const buildCoinflipTransactionTool: (input?: unknown) => Promise<ReadOnlyPlan | {
+  mode: "dry-run";
+  network: SuigarNetwork;
+  config: ConfigInspection;
+  summary: TransactionSummary;
+  dryRun: unknown;
+  transactionBytesBase64?: undefined;
+} | {
+  mode: "build" | "read-only";
+  network: SuigarNetwork;
+  config: ConfigInspection;
+  summary: TransactionSummary;
+  transactionBytesBase64: string;
+  dryRun?: undefined;
+}>;
+declare const buildLimboTransactionTool: (input?: unknown) => Promise<ReadOnlyPlan | {
+  mode: "dry-run";
+  network: SuigarNetwork;
+  config: ConfigInspection;
+  summary: TransactionSummary;
+  dryRun: unknown;
+  transactionBytesBase64?: undefined;
+} | {
+  mode: "build" | "read-only";
+  network: SuigarNetwork;
+  config: ConfigInspection;
+  summary: TransactionSummary;
+  transactionBytesBase64: string;
+  dryRun?: undefined;
+}>;
+declare const buildPlinkoTransactionTool: (input?: unknown) => Promise<ReadOnlyPlan | {
+  mode: "dry-run";
+  network: SuigarNetwork;
+  config: ConfigInspection;
+  summary: TransactionSummary;
+  dryRun: unknown;
+  transactionBytesBase64?: undefined;
+} | {
+  mode: "build" | "read-only";
+  network: SuigarNetwork;
+  config: ConfigInspection;
+  summary: TransactionSummary;
+  transactionBytesBase64: string;
+  dryRun?: undefined;
+}>;
+declare const buildWheelTransactionTool: (input?: unknown) => Promise<ReadOnlyPlan | {
+  mode: "dry-run";
+  network: SuigarNetwork;
+  config: ConfigInspection;
+  summary: TransactionSummary;
+  dryRun: unknown;
+  transactionBytesBase64?: undefined;
+} | {
+  mode: "build" | "read-only";
+  network: SuigarNetwork;
+  config: ConfigInspection;
+  summary: TransactionSummary;
+  transactionBytesBase64: string;
+  dryRun?: undefined;
+}>;
+declare const buildRangeTransactionTool: (input?: unknown) => Promise<ReadOnlyPlan | {
+  mode: "dry-run";
+  network: SuigarNetwork;
+  config: ConfigInspection;
+  summary: TransactionSummary;
+  dryRun: unknown;
+  transactionBytesBase64?: undefined;
+} | {
+  mode: "build" | "read-only";
+  network: SuigarNetwork;
+  config: ConfigInspection;
+  summary: TransactionSummary;
+  transactionBytesBase64: string;
+  dryRun?: undefined;
+}>;
+declare const buildPvpCoinflipCreateTransactionTool: (input?: unknown) => Promise<ReadOnlyPlan | {
+  mode: "dry-run";
+  network: SuigarNetwork;
+  config: ConfigInspection;
+  summary: TransactionSummary;
+  dryRun: unknown;
+  transactionBytesBase64?: undefined;
+} | {
+  mode: "build" | "read-only";
+  network: SuigarNetwork;
+  config: ConfigInspection;
+  summary: TransactionSummary;
+  transactionBytesBase64: string;
+  dryRun?: undefined;
+}>;
+declare const buildPvpCoinflipJoinTransactionTool: (input?: unknown) => Promise<ReadOnlyPlan | {
+  mode: "dry-run";
+  network: SuigarNetwork;
+  config: ConfigInspection;
+  summary: TransactionSummary;
+  dryRun: unknown;
+  transactionBytesBase64?: undefined;
+} | {
+  mode: "build" | "read-only";
+  network: SuigarNetwork;
+  config: ConfigInspection;
+  summary: TransactionSummary;
+  transactionBytesBase64: string;
+  dryRun?: undefined;
+}>;
+declare const buildPvpCoinflipCancelTransactionTool: (input?: unknown) => Promise<ReadOnlyPlan | {
+  mode: "dry-run";
+  network: SuigarNetwork;
+  config: ConfigInspection;
+  summary: TransactionSummary;
+  dryRun: unknown;
+  transactionBytesBase64?: undefined;
+} | {
+  mode: "build" | "read-only";
+  network: SuigarNetwork;
+  config: ConfigInspection;
+  summary: TransactionSummary;
+  transactionBytesBase64: string;
+  dryRun?: undefined;
+}>;
+//#endregion
 export { BetCoinSource, BetMetadataInput, BetMetadataInputValue, BetMetadataPrimitive, BuilderMode, CasinoBetGameId, CoinReadClient, CoinSide, ConfigInspection, GameMcpSupport, McpExecutionSurface, ReadOnlyPlan, SUPPORTED_MCP_TOOL_NAMES, SharedBuildOptions, SuigarConfig, SuigarConfigInput, SuigarMcpToolName, SuigarNetwork, SupportedGameId, TransactionSummary, assertRequiredConfig, buildCoinflipTransaction, buildCoinflipTransactionTool, buildGraphqlUrl, buildLimboTransaction, buildLimboTransactionTool, buildMcpSupportCatalog, buildPlinkoTransaction, buildPlinkoTransactionTool, buildProviderUrl, buildPvpCoinflipCancelTransaction, buildPvpCoinflipCancelTransactionTool, buildPvpCoinflipCreateTransaction, buildPvpCoinflipCreateTransactionTool, buildPvpCoinflipJoinTransaction, buildPvpCoinflipJoinTransactionTool, buildRangeTransaction, buildRangeTransactionTool, buildWheelTransaction, buildWheelTransactionTool, createReadOnlyClientBundle, createSuigarMcpServer, dryRunTransaction, getCurrencyInfo, getGameMetadata, getMcpSupportForGame, getRequiredConfigKeysForGame, inspectResolvedConfig, listConfiguredCurrencies, listSupportedGames, parseApiUrl, readConfigMetadata, readConfigTool, readGameMetadataTool, resolveBetCoin, resolveGamePackageId, resolveGameSettingsId, resolvePythPriceInfoId, resolveSuigarConfig, sanitizeForJson, serializeTransactionToBase64, startSuigarMcpServer, summarizeTransaction };