@suigar/mcp 0.1.0 → 0.1.1

package/dist/tools.mjs

@@ -1,608 +0,0 @@
-import { getRequiredConfigKeysForGame, inspectResolvedConfig, resolveGamePackageId, resolveSuigarConfig } from "./config.mjs";
-import { getCurrencyInfo, getGameMetadata, readConfigMetadata } from "./metadata.mjs";
-import { createReadOnlyClientBundle, dryRunTransaction, serializeTransactionToBase64 } from "./client.mjs";
-import { buildCoinflipTransaction, buildLimboTransaction, buildPlinkoTransaction, buildPvpCoinflipCancelTransaction, buildPvpCoinflipCreateTransaction, buildPvpCoinflipJoinTransaction, buildRangeTransaction, buildWheelTransaction, summarizeTransaction } from "./transactions.mjs";
-import { normalizeCoinType } from "@suigar/currency-registry";
-import { SuiGrpcClient } from "@mysten/sui/grpc";
-import { suigar } from "@suigar/sdk";
-//#region src/tools.ts
-const asRecord = (value) => value && typeof value === "object" ? value : {};
-const asString = (value, fieldName, fallback) => {
-	if (typeof value === "string" && value.trim()) return value.trim();
-	if (fallback !== void 0) return fallback;
-	throw new Error(`Missing required string field: ${fieldName}`);
-};
-const asOptionalString = (value) => typeof value === "string" && value.trim() ? value.trim() : void 0;
-const asNumber = (value, fieldName) => {
-	const numeric = typeof value === "bigint" ? Number(value) : Number(value);
-	if (!Number.isFinite(numeric)) throw new Error(`Missing or invalid numeric field: ${fieldName}`);
-	return numeric;
-};
-const asBoolean = (value, fallback = false) => typeof value === "boolean" ? value : fallback;
-const asStringArray = (value) => Array.isArray(value) ? value.filter((entry) => typeof entry === "string" && entry.trim().length > 0) : [];
-const asMode = (value) => value === "dry-run" || value === "read-only" || value === "build" ? value : "build";
-const SDK_BUILD_NETWORKS = /* @__PURE__ */ new Set(["mainnet", "testnet"]);
-const SDK_UNSUPPORTED_CONFIG_OVERRIDE_KEYS = [
-	"suigarPackageId",
-	"coinflipPackageId",
-	"pvpCoinflipPackageId",
-	"plinkoPackageId",
-	"limboPackageId",
-	"rangePackageId",
-	"wheelPackageId",
-	"sweethouseId",
-	"suiPythPriceInfoObjectId",
-	"usdcPythPriceInfoObjectId",
-	"pvpCoinflipRegistryId"
-];
-const buildReadOnlyPlan = ({ game, config, coinType, targetSuffix, notes }) => {
-	const resolvedConfig = resolveSuigarConfig(config);
-	const packageId = resolveGamePackageId(game, resolvedConfig);
-	return {
-		mode: "read-only",
-		network: resolvedConfig.network,
-		game,
-		config: inspectResolvedConfig(resolvedConfig),
-		plan: {
-			target: packageId ? `${packageId}${targetSuffix}` : null,
-			typeArguments: coinType ? [normalizeCoinType(coinType)] : [],
-			requiredConfigKeys: getRequiredConfigKeysForGame(game),
-			notes
-		}
-	};
-};
-const buildTransactionResult = async ({ mode, config, transaction, context }) => {
-	const bundle = createReadOnlyClientBundle(config);
-	const summary = summarizeTransaction(transaction, context);
-	if (mode === "dry-run") return {
-		mode,
-		network: bundle.config.network,
-		config: inspectResolvedConfig(bundle.config),
-		summary,
-		dryRun: await dryRunTransaction(transaction, bundle.config)
-	};
-	return {
-		mode,
-		network: bundle.config.network,
-		config: inspectResolvedConfig(bundle.config),
-		summary,
-		transactionBytesBase64: await serializeTransactionToBase64(transaction, bundle.rawClient)
-	};
-};
-const extractConfigInput = (input) => {
-	const nestedConfig = asRecord(input.config);
-	return {
-		...nestedConfig,
-		network: asOptionalString(input.network) ?? asOptionalString(nestedConfig.network),
-		providerUrl: asOptionalString(input.providerUrl) ?? asOptionalString(nestedConfig.providerUrl),
-		graphqlUrl: asOptionalString(input.graphqlUrl) ?? asOptionalString(nestedConfig.graphqlUrl)
-	};
-};
-const extractPartner = (input) => asOptionalString(input.partner) ?? asOptionalString(asRecord(input.config).partner);
-const hasSdkUnsupportedConfigOverrides = (input) => {
-	const mergedInput = {
-		...asRecord(input.config),
-		...input
-	};
-	return SDK_UNSUPPORTED_CONFIG_OVERRIDE_KEYS.some((key) => asOptionalString(mergedInput[key]));
-};
-const buildCommonSdkOptions = (record, coinType) => {
-	const owner = asString(record.owner, "owner");
-	return {
-		owner,
-		playerAddress: owner,
-		coinType,
-		metadata: asRecord(record.metadata),
-		allowGasCoinShortcut: asBoolean(record.allowGasCoinShortcut, true),
-		...record.gasBudget == null ? {} : { gasBudget: asNumber(record.gasBudget, "gasBudget") }
-	};
-};
-const buildStakeSdkOptions = (record, coinType) => ({
-	...buildCommonSdkOptions(record, coinType),
-	stake: asNumber(record.stake, "stake"),
-	...record.cashStake == null ? {} : { cashStake: asNumber(record.cashStake, "cashStake") },
-	...record.betCount == null ? {} : { betCount: asNumber(record.betCount, "betCount") }
-});
-const tryBuildSdkTransaction = ({ record, config, coinType, game, pvpAction }) => {
-	if (asStringArray(record.coinObjectIds).length > 0 || hasSdkUnsupportedConfigOverrides(record)) return null;
-	const resolvedConfig = resolveSuigarConfig(config);
-	if (!SDK_BUILD_NETWORKS.has(resolvedConfig.network)) return null;
-	const partner = extractPartner(record);
-	const client = new SuiGrpcClient({
-		baseUrl: resolvedConfig.providerUrl,
-		network: resolvedConfig.network
-	}).$extend(suigar(partner ? { partner } : void 0));
-	try {
-		switch (game) {
-			case "coinflip": return client.suigar.tx.createBetTransaction("coinflip", {
-				...buildStakeSdkOptions(record, coinType),
-				side: asString(record.side, "side")
-			});
-			case "limbo": return client.suigar.tx.createBetTransaction("limbo", {
-				...buildStakeSdkOptions(record, coinType),
-				targetMultiplier: asNumber(record.targetMultiplier, "targetMultiplier")
-			});
-			case "plinko": return client.suigar.tx.createBetTransaction("plinko", {
-				...buildStakeSdkOptions(record, coinType),
-				configId: asNumber(record.configId, "configId")
-			});
-			case "wheel": return client.suigar.tx.createBetTransaction("wheel", {
-				...buildStakeSdkOptions(record, coinType),
-				configId: asNumber(record.configId, "configId")
-			});
-			case "range": return client.suigar.tx.createBetTransaction("range", {
-				...buildStakeSdkOptions(record, coinType),
-				leftPoint: asNumber(record.leftPoint, "leftPoint"),
-				rightPoint: asNumber(record.rightPoint, "rightPoint"),
-				outOfRange: asBoolean(record.outOfRange)
-			});
-			case "pvp-coinflip":
-				if (pvpAction === "join" || pvpAction === "cancel") return client.suigar.tx.createPvPCoinflipTransaction(pvpAction, {
-					...buildCommonSdkOptions(record, coinType),
-					config: client.suigar.getConfig(),
-					gameId: asString(record.gameId, "gameId")
-				});
-				return client.suigar.tx.createPvPCoinflipTransaction("create", {
-					...buildCommonSdkOptions(record, coinType),
-					config: client.suigar.getConfig(),
-					stake: asNumber(record.stake, "stake"),
-					side: asString(record.creatorSide, "creatorSide"),
-					isPrivate: asBoolean(record.isPrivate)
-				});
-		}
-	} catch {
-		return null;
-	}
-};
-const readConfigTool = async (input = {}) => {
-	return readConfigMetadata(extractConfigInput(asRecord(input)));
-};
-const readGameMetadataTool = async (input = {}) => {
-	const record = asRecord(input);
-	const config = extractConfigInput(record);
-	const game = asOptionalString(record.game);
-	const coinType = asOptionalString(record.coinType);
-	return {
-		config: readConfigMetadata(config),
-		game: game ? getGameMetadata(game, config) : null,
-		currency: coinType ? getCurrencyInfo(coinType, config) : null
-	};
-};
-const buildCoinflipTransactionTool = async (input = {}) => {
-	const record = asRecord(input);
-	const config = extractConfigInput(record);
-	const mode = asMode(record.mode);
-	const coinType = asString(record.coinType, "coinType", resolveSuigarConfig(config).suiCoinType);
-	if (mode === "read-only") return buildReadOnlyPlan({
-		game: "coinflip",
-		config,
-		coinType,
-		targetSuffix: "::coinflip::play",
-		notes: ["Uses the sweethouse shared object, a prepared bet coin, Pyth price info, clock, and random."]
-	});
-	const sdkTransaction = tryBuildSdkTransaction({
-		record,
-		config,
-		coinType,
-		game: "coinflip"
-	});
-	if (sdkTransaction) return buildTransactionResult({
-		mode,
-		config,
-		transaction: sdkTransaction,
-		context: {
-			game: "coinflip",
-			coinType,
-			stake: asNumber(record.stake, "stake")
-		}
-	});
-	const bundle = createReadOnlyClientBundle(config);
-	const transaction = await buildCoinflipTransaction({
-		client: bundle.client,
-		config: bundle.config,
-		owner: asString(record.owner, "owner"),
-		coinType,
-		stake: asNumber(record.stake, "stake"),
-		cashStake: record.cashStake == null ? void 0 : asNumber(record.cashStake, "cashStake"),
-		betCount: record.betCount == null ? void 0 : asNumber(record.betCount, "betCount"),
-		side: asString(record.side, "side"),
-		metadata: asRecord(record.metadata),
-		partner: extractPartner(record),
-		coinSource: asStringArray(record.coinObjectIds).length > 0 ? {
-			kind: "object-ids",
-			objectIds: asStringArray(record.coinObjectIds)
-		} : void 0
-	});
-	return buildTransactionResult({
-		mode,
-		config: bundle.config,
-		transaction,
-		context: {
-			game: "coinflip",
-			coinType,
-			stake: asNumber(record.stake, "stake")
-		}
-	});
-};
-const buildLimboTransactionTool = async (input = {}) => {
-	const record = asRecord(input);
-	const config = extractConfigInput(record);
-	const mode = asMode(record.mode);
-	const coinType = asString(record.coinType, "coinType", resolveSuigarConfig(config).suiCoinType);
-	if (mode === "read-only") return buildReadOnlyPlan({
-		game: "limbo",
-		config,
-		coinType,
-		targetSuffix: "::limbo::play",
-		notes: ["Target multiplier is encoded as a fixed-point numerator and denominator."]
-	});
-	const sdkTransaction = tryBuildSdkTransaction({
-		record,
-		config,
-		coinType,
-		game: "limbo"
-	});
-	if (sdkTransaction) return buildTransactionResult({
-		mode,
-		config,
-		transaction: sdkTransaction,
-		context: {
-			game: "limbo",
-			coinType,
-			stake: asNumber(record.stake, "stake")
-		}
-	});
-	const bundle = createReadOnlyClientBundle(config);
-	const transaction = await buildLimboTransaction({
-		client: bundle.client,
-		config: bundle.config,
-		owner: asString(record.owner, "owner"),
-		coinType,
-		stake: asNumber(record.stake, "stake"),
-		cashStake: record.cashStake == null ? void 0 : asNumber(record.cashStake, "cashStake"),
-		betCount: record.betCount == null ? void 0 : asNumber(record.betCount, "betCount"),
-		targetMultiplier: asNumber(record.targetMultiplier, "targetMultiplier"),
-		metadata: asRecord(record.metadata),
-		partner: extractPartner(record),
-		coinSource: asStringArray(record.coinObjectIds).length > 0 ? {
-			kind: "object-ids",
-			objectIds: asStringArray(record.coinObjectIds)
-		} : void 0
-	});
-	return buildTransactionResult({
-		mode,
-		config: bundle.config,
-		transaction,
-		context: {
-			game: "limbo",
-			coinType,
-			stake: asNumber(record.stake, "stake")
-		}
-	});
-};
-const buildPlinkoTransactionTool = async (input = {}) => {
-	const record = asRecord(input);
-	const config = extractConfigInput(record);
-	const mode = asMode(record.mode);
-	const coinType = asString(record.coinType, "coinType", resolveSuigarConfig(config).suiCoinType);
-	if (mode === "read-only") return buildReadOnlyPlan({
-		game: "plinko",
-		config,
-		coinType,
-		targetSuffix: "::plinko::play",
-		notes: ["The config id is a u8 that selects the on-chain plinko board setup."]
-	});
-	const sdkTransaction = tryBuildSdkTransaction({
-		record,
-		config,
-		coinType,
-		game: "plinko"
-	});
-	if (sdkTransaction) return buildTransactionResult({
-		mode,
-		config,
-		transaction: sdkTransaction,
-		context: {
-			game: "plinko",
-			coinType,
-			stake: asNumber(record.stake, "stake")
-		}
-	});
-	const bundle = createReadOnlyClientBundle(config);
-	const transaction = await buildPlinkoTransaction({
-		client: bundle.client,
-		config: bundle.config,
-		owner: asString(record.owner, "owner"),
-		coinType,
-		stake: asNumber(record.stake, "stake"),
-		cashStake: record.cashStake == null ? void 0 : asNumber(record.cashStake, "cashStake"),
-		betCount: record.betCount == null ? void 0 : asNumber(record.betCount, "betCount"),
-		configId: asNumber(record.configId, "configId"),
-		metadata: asRecord(record.metadata),
-		partner: extractPartner(record),
-		coinSource: asStringArray(record.coinObjectIds).length > 0 ? {
-			kind: "object-ids",
-			objectIds: asStringArray(record.coinObjectIds)
-		} : void 0
-	});
-	return buildTransactionResult({
-		mode,
-		config: bundle.config,
-		transaction,
-		context: {
-			game: "plinko",
-			coinType,
-			stake: asNumber(record.stake, "stake")
-		}
-	});
-};
-const buildWheelTransactionTool = async (input = {}) => {
-	const record = asRecord(input);
-	const config = extractConfigInput(record);
-	const mode = asMode(record.mode);
-	const coinType = asString(record.coinType, "coinType", resolveSuigarConfig(config).suiCoinType);
-	if (mode === "read-only") return buildReadOnlyPlan({
-		game: "wheel",
-		config,
-		coinType,
-		targetSuffix: "::wheel::play",
-		notes: ["The config id is a u8 that selects the on-chain wheel table."]
-	});
-	const sdkTransaction = tryBuildSdkTransaction({
-		record,
-		config,
-		coinType,
-		game: "wheel"
-	});
-	if (sdkTransaction) return buildTransactionResult({
-		mode,
-		config,
-		transaction: sdkTransaction,
-		context: {
-			game: "wheel",
-			coinType,
-			stake: asNumber(record.stake, "stake")
-		}
-	});
-	const bundle = createReadOnlyClientBundle(config);
-	const transaction = await buildWheelTransaction({
-		client: bundle.client,
-		config: bundle.config,
-		owner: asString(record.owner, "owner"),
-		coinType,
-		stake: asNumber(record.stake, "stake"),
-		cashStake: record.cashStake == null ? void 0 : asNumber(record.cashStake, "cashStake"),
-		betCount: record.betCount == null ? void 0 : asNumber(record.betCount, "betCount"),
-		configId: asNumber(record.configId, "configId"),
-		metadata: asRecord(record.metadata),
-		partner: extractPartner(record),
-		coinSource: asStringArray(record.coinObjectIds).length > 0 ? {
-			kind: "object-ids",
-			objectIds: asStringArray(record.coinObjectIds)
-		} : void 0
-	});
-	return buildTransactionResult({
-		mode,
-		config: bundle.config,
-		transaction,
-		context: {
-			game: "wheel",
-			coinType,
-			stake: asNumber(record.stake, "stake")
-		}
-	});
-};
-const buildRangeTransactionTool = async (input = {}) => {
-	const record = asRecord(input);
-	const config = extractConfigInput(record);
-	const mode = asMode(record.mode);
-	const coinType = asString(record.coinType, "coinType", resolveSuigarConfig(config).suiCoinType);
-	if (mode === "read-only") return buildReadOnlyPlan({
-		game: "range",
-		config,
-		coinType,
-		targetSuffix: "::range::play",
-		notes: ["Range points are encoded as fixed-point integers with a 1e6 scale by default."]
-	});
-	const sdkTransaction = tryBuildSdkTransaction({
-		record,
-		config,
-		coinType,
-		game: "range"
-	});
-	if (sdkTransaction) return buildTransactionResult({
-		mode,
-		config,
-		transaction: sdkTransaction,
-		context: {
-			game: "range",
-			coinType,
-			stake: asNumber(record.stake, "stake")
-		}
-	});
-	const bundle = createReadOnlyClientBundle(config);
-	const transaction = await buildRangeTransaction({
-		client: bundle.client,
-		config: bundle.config,
-		owner: asString(record.owner, "owner"),
-		coinType,
-		stake: asNumber(record.stake, "stake"),
-		cashStake: record.cashStake == null ? void 0 : asNumber(record.cashStake, "cashStake"),
-		betCount: record.betCount == null ? void 0 : asNumber(record.betCount, "betCount"),
-		leftPoint: asNumber(record.leftPoint, "leftPoint"),
-		rightPoint: asNumber(record.rightPoint, "rightPoint"),
-		outOfRange: asBoolean(record.outOfRange),
-		metadata: asRecord(record.metadata),
-		partner: extractPartner(record),
-		coinSource: asStringArray(record.coinObjectIds).length > 0 ? {
-			kind: "object-ids",
-			objectIds: asStringArray(record.coinObjectIds)
-		} : void 0
-	});
-	return buildTransactionResult({
-		mode,
-		config: bundle.config,
-		transaction,
-		context: {
-			game: "range",
-			coinType,
-			stake: asNumber(record.stake, "stake")
-		}
-	});
-};
-const buildPvpCoinflipCreateTransactionTool = async (input = {}) => {
-	const record = asRecord(input);
-	const config = extractConfigInput(record);
-	const mode = asMode(record.mode);
-	const coinType = asString(record.coinType, "coinType", resolveSuigarConfig(config).suiCoinType);
-	if (mode === "read-only") return buildReadOnlyPlan({
-		game: "pvp-coinflip",
-		config,
-		coinType,
-		targetSuffix: "::pvp_coinflip::create_game",
-		notes: ["Creates a public or private PvP lobby without needing a private key."]
-	});
-	const sdkTransaction = tryBuildSdkTransaction({
-		record,
-		config,
-		coinType,
-		game: "pvp-coinflip",
-		pvpAction: "create"
-	});
-	if (sdkTransaction) return buildTransactionResult({
-		mode,
-		config,
-		transaction: sdkTransaction,
-		context: {
-			game: "pvp-coinflip",
-			coinType,
-			stake: asNumber(record.stake, "stake")
-		}
-	});
-	const bundle = createReadOnlyClientBundle(config);
-	const transaction = await buildPvpCoinflipCreateTransaction({
-		client: bundle.client,
-		config: bundle.config,
-		owner: asString(record.owner, "owner"),
-		coinType,
-		stake: asNumber(record.stake, "stake"),
-		creatorSide: asString(record.creatorSide, "creatorSide"),
-		isPrivate: asBoolean(record.isPrivate),
-		metadata: asRecord(record.metadata),
-		partner: extractPartner(record),
-		coinSource: asStringArray(record.coinObjectIds).length > 0 ? {
-			kind: "object-ids",
-			objectIds: asStringArray(record.coinObjectIds)
-		} : void 0
-	});
-	return buildTransactionResult({
-		mode,
-		config: bundle.config,
-		transaction,
-		context: {
-			game: "pvp-coinflip",
-			coinType,
-			stake: asNumber(record.stake, "stake")
-		}
-	});
-};
-const buildPvpCoinflipJoinTransactionTool = async (input = {}) => {
-	const record = asRecord(input);
-	const config = extractConfigInput(record);
-	const mode = asMode(record.mode);
-	const coinType = asString(record.coinType, "coinType", resolveSuigarConfig(config).suiCoinType);
-	if (mode === "read-only") return buildReadOnlyPlan({
-		game: "pvp-coinflip",
-		config,
-		coinType,
-		targetSuffix: "::pvp_coinflip::join_game",
-		notes: ["Joining requires the game id, stake amount, and a price info object for the selected coin."]
-	});
-	const sdkTransaction = tryBuildSdkTransaction({
-		record,
-		config,
-		coinType,
-		game: "pvp-coinflip",
-		pvpAction: "join"
-	});
-	if (sdkTransaction) return buildTransactionResult({
-		mode,
-		config,
-		transaction: sdkTransaction,
-		context: {
-			game: "pvp-coinflip",
-			coinType,
-			stake: asNumber(record.stake, "stake")
-		}
-	});
-	const bundle = createReadOnlyClientBundle(config);
-	const transaction = await buildPvpCoinflipJoinTransaction({
-		client: bundle.client,
-		config: bundle.config,
-		owner: asString(record.owner, "owner"),
-		gameId: asString(record.gameId, "gameId"),
-		coinType,
-		stake: asNumber(record.stake, "stake"),
-		metadata: asRecord(record.metadata),
-		partner: extractPartner(record),
-		coinSource: asStringArray(record.coinObjectIds).length > 0 ? {
-			kind: "object-ids",
-			objectIds: asStringArray(record.coinObjectIds)
-		} : void 0
-	});
-	return buildTransactionResult({
-		mode,
-		config: bundle.config,
-		transaction,
-		context: {
-			game: "pvp-coinflip",
-			coinType,
-			stake: asNumber(record.stake, "stake")
-		}
-	});
-};
-const buildPvpCoinflipCancelTransactionTool = async (input = {}) => {
-	const record = asRecord(input);
-	const config = extractConfigInput(record);
-	const mode = asMode(record.mode);
-	const coinType = asString(record.coinType, "coinType", resolveSuigarConfig(config).suiCoinType);
-	if (mode === "read-only") return buildReadOnlyPlan({
-		game: "pvp-coinflip",
-		config,
-		coinType,
-		targetSuffix: "::pvp_coinflip::cancel_game",
-		notes: ["Cancel only needs the game id, sweethouse object, and coin type argument."]
-	});
-	const sdkTransaction = tryBuildSdkTransaction({
-		record,
-		config,
-		coinType,
-		game: "pvp-coinflip",
-		pvpAction: "cancel"
-	});
-	if (sdkTransaction) return buildTransactionResult({
-		mode,
-		config,
-		transaction: sdkTransaction,
-		context: {
-			game: "pvp-coinflip",
-			coinType
-		}
-	});
-	return buildTransactionResult({
-		mode,
-		config,
-		transaction: buildPvpCoinflipCancelTransaction({
-			config,
-			owner: asString(record.owner, "owner"),
-			gameId: asString(record.gameId, "gameId"),
-			coinType
-		}),
-		context: {
-			game: "pvp-coinflip",
-			coinType
-		}
-	});
-};
-//#endregion
-export { buildCoinflipTransactionTool, buildLimboTransactionTool, buildPlinkoTransactionTool, buildPvpCoinflipCancelTransactionTool, buildPvpCoinflipCreateTransactionTool, buildPvpCoinflipJoinTransactionTool, buildRangeTransactionTool, buildWheelTransactionTool, readConfigTool, readGameMetadataTool };