@suigar/mcp 0.1.1 → 0.2.0-beta.0

package/dist/tools.mjs

@@ -0,0 +1,352 @@
+import { buildTransactionResult, createSuigarClient, resolveDefaultCoinType, resolveOwnerAddress } from "./client.mjs";
+import { GAMES } from "@suigar/sdk/games";
+//#region src/tools.ts
+const GAME_LABELS = {
+	coinflip: "Coinflip",
+	limbo: "Limbo",
+	plinko: "Plinko",
+	range: "Range",
+	wheel: "Wheel",
+	"pvp-coinflip": "PvP Coinflip"
+};
+const GAME_TO_PACKAGE_KEY = {
+	coinflip: "coinflip",
+	limbo: "limbo",
+	plinko: "plinko",
+	range: "range",
+	wheel: "wheel",
+	"pvp-coinflip": "pvpCoinflip"
+};
+const GAME_TO_TOOLS = {
+	coinflip: ["build_coinflip_transaction"],
+	limbo: ["build_limbo_transaction"],
+	plinko: ["build_plinko_transaction"],
+	range: ["build_range_transaction"],
+	wheel: ["build_wheel_transaction"],
+	"pvp-coinflip": [
+		"build_pvp_coinflip_create_transaction",
+		"build_pvp_coinflip_join_transaction",
+		"build_pvp_coinflip_cancel_transaction"
+	]
+};
+const json = (value) => JSON.stringify(value, (_key, item) => typeof item === "bigint" ? item.toString() : item, 2);
+const asTextResponse = (structuredContent) => ({
+	content: [{
+		type: "text",
+		text: json(structuredContent)
+	}],
+	structuredContent
+});
+const currencyAmountPattern = /^(?:\d+|\d+\.\d+|\.\d+)$/u;
+const coinMetadataForAmount = (config, coinType) => {
+	const resolvedCoinType = resolveDefaultCoinType(config, coinType);
+	const coin = Object.values(config.sdk.coins).find((metadata) => resolveDefaultCoinType(config, metadata.coinType) === resolvedCoinType);
+	if (!coin) throw new RangeError(`Unable to resolve decimals for coin type ${resolvedCoinType}. Add the coin to config.coins before using currency-denominated amounts.`);
+	return {
+		coinType: resolvedCoinType,
+		decimals: coin.decimals
+	};
+};
+const toCurrencyAmountText = (value, fieldName) => {
+	if (typeof value === "number" && Number.isFinite(value) && value >= 0) return String(value);
+	if (typeof value === "string" && currencyAmountPattern.test(value.trim())) return value.trim();
+	throw new TypeError(`Missing or invalid ${fieldName}. Provide a non-negative currency amount such as 1, 2, or 1.5.`);
+};
+const toBaseUnits = (value, fieldName, decimals) => {
+	const [rawWhole, rawFraction = ""] = toCurrencyAmountText(value, fieldName).split(".");
+	const whole = rawWhole === "" ? "0" : rawWhole;
+	const overflow = rawFraction.slice(decimals);
+	if (/[^0]/u.test(overflow)) throw new RangeError(`${fieldName} has more fractional digits than the configured coin decimals (${decimals}).`);
+	const fraction = rawFraction.slice(0, decimals).padEnd(decimals, "0");
+	return BigInt(whole) * 10n ** BigInt(decimals) + BigInt(fraction || "0");
+};
+const toPositiveInteger = (value, fieldName) => {
+	if (typeof value === "number" && Number.isSafeInteger(value) && value > 0) return value;
+	if (typeof value === "string" && /^[1-9]\d*$/u.test(value)) return BigInt(value);
+	throw new TypeError(`Missing or invalid ${fieldName}. Provide a positive integer.`);
+};
+const requireString = (value, fieldName) => {
+	if (typeof value === "string" && value.trim()) return value.trim();
+	throw new TypeError(`Missing required field: ${fieldName}.`);
+};
+const requireNumber = (value, fieldName) => {
+	if (typeof value === "number" && Number.isFinite(value)) return value;
+	throw new TypeError(`Missing or invalid numeric field: ${fieldName}.`);
+};
+const getMode = (mode) => mode ?? "build";
+const getConfigInput = (input) => ({
+	network: input.network,
+	providerUrl: input.providerUrl,
+	config: input.config,
+	partner: input.partner
+});
+const supportedGames = () => GAMES.map((id) => ({
+	id,
+	label: GAME_LABELS[id],
+	tools: [...GAME_TO_TOOLS[id]]
+}));
+const getPackageId = (config, game) => config.sdk.packageIds[GAME_TO_PACKAGE_KEY[game]];
+const getTarget = (config, game, action) => {
+	const packageId = getPackageId(config, game);
+	if (game === "pvp-coinflip") return `${packageId}::pvp_coinflip::${action === "join" ? "join_game" : action === "cancel" ? "cancel_game" : "create_game"}`;
+	return `${packageId}::${game}::play`;
+};
+const readOnlyPlan = ({ input, game, action, requiredInputs, notes }) => {
+	const { config } = createSuigarClient(getConfigInput(input));
+	const coinType = resolveDefaultCoinType(config, input.coinType);
+	return {
+		mode: "read-only",
+		network: config.network,
+		game,
+		action,
+		config,
+		plan: {
+			target: getTarget(config, game, action),
+			typeArguments: [coinType],
+			requiredInputs,
+			notes
+		}
+	};
+};
+const commonOptions = async (input, bundle) => {
+	return {
+		owner: await resolveOwnerAddress(requireString(input.owner, "owner"), bundle),
+		coinType: resolveDefaultCoinType(bundle.config, input.coinType),
+		metadata: input.metadata,
+		gasBudget: input.gasBudget,
+		useGasCoin: input.useGasCoin
+	};
+};
+const stakeOptions = async (input, bundle) => {
+	const { decimals } = coinMetadataForAmount(bundle.config, input.coinType);
+	return {
+		...await commonOptions(input, bundle),
+		stake: toBaseUnits(input.stake, "stake", decimals),
+		...input.cashStake == null ? {} : { cashStake: toBaseUnits(input.cashStake, "cashStake", decimals) },
+		...input.betCount == null ? {} : { betCount: toPositiveInteger(input.betCount, "betCount") }
+	};
+};
+const executeTransactionTool = async ({ input, game, action, createTransaction, stake, stakeDisplay, gameInputs }) => {
+	const mode = getMode(input.mode);
+	if (mode === "read-only") throw new Error("read-only mode must be handled before transaction execution.");
+	const bundle = createSuigarClient(getConfigInput(input));
+	const coin = coinMetadataForAmount(bundle.config, input.coinType);
+	const baseStake = stake ?? (stakeDisplay == null ? void 0 : toBaseUnits(stakeDisplay, "stake", coin.decimals));
+	return asTextResponse(await buildTransactionResult({
+		mode,
+		transaction: await createTransaction(bundle),
+		config: bundle.config,
+		client: bundle.client,
+		context: {
+			game,
+			action,
+			coinType: coin.coinType,
+			stake: baseStake,
+			stakeDisplay,
+			coinDecimals: coin.decimals,
+			gameInputs
+		}
+	}));
+};
+const readConfigTool = async (input = {}) => {
+	const { config } = createSuigarClient(getConfigInput(input));
+	return asTextResponse({
+		network: config.network,
+		config,
+		supportedGames: supportedGames()
+	});
+};
+const readGameMetadataTool = async (input = {}) => {
+	const { config } = createSuigarClient(getConfigInput(input));
+	const game = input.game ?? null;
+	const coinType = resolveDefaultCoinType(config, input.coinType);
+	return asTextResponse({
+		network: config.network,
+		config,
+		supportedGames: supportedGames(),
+		game: game ? {
+			id: game,
+			label: GAME_LABELS[game],
+			packageId: getPackageId(config, game),
+			coinType,
+			notes: [game === "pvp-coinflip" ? "PvP coinflip uses dedicated create, join, and cancel transaction builders." : "Standard games use client.suigar.tx.createBetTransaction().", "Transactions are unsigned and are never executed by the MCP server."]
+		} : null
+	});
+};
+const buildCoinflipTransactionTool = async (input = {}) => {
+	if (getMode(input.mode) === "read-only") return asTextResponse(readOnlyPlan({
+		input,
+		game: "coinflip",
+		requiredInputs: [
+			"owner",
+			"stake",
+			"side"
+		],
+		notes: ["Uses the configured SweetHouse object, Pyth price info, clock, and randomness objects."]
+	}));
+	const side = requireString(input.side, "side");
+	return executeTransactionTool({
+		input,
+		game: "coinflip",
+		stakeDisplay: toCurrencyAmountText(input.stake, "stake"),
+		gameInputs: { side },
+		createTransaction: async (bundle) => bundle.client.suigar.tx.createBetTransaction("coinflip", {
+			...await stakeOptions(input, bundle),
+			side
+		})
+	});
+};
+const buildLimboTransactionTool = async (input = {}) => {
+	if (getMode(input.mode) === "read-only") return asTextResponse(readOnlyPlan({
+		input,
+		game: "limbo",
+		requiredInputs: [
+			"owner",
+			"stake",
+			"targetMultiplier"
+		],
+		notes: ["Target multiplier is encoded by @suigar/sdk using the public fixed-point utility defaults."]
+	}));
+	const targetMultiplier = requireNumber(input.targetMultiplier, "targetMultiplier");
+	return executeTransactionTool({
+		input,
+		game: "limbo",
+		stakeDisplay: toCurrencyAmountText(input.stake, "stake"),
+		gameInputs: { targetMultiplier },
+		createTransaction: async (bundle) => bundle.client.suigar.tx.createBetTransaction("limbo", {
+			...await stakeOptions(input, bundle),
+			targetMultiplier
+		})
+	});
+};
+const buildConfigIdTransactionTool = async (input, game) => {
+	if (getMode(input.mode) === "read-only") return asTextResponse(readOnlyPlan({
+		input,
+		game,
+		requiredInputs: [
+			"owner",
+			"stake",
+			"configId"
+		],
+		notes: ["Config id selects the on-chain game configuration."]
+	}));
+	const configId = requireNumber(input.configId, "configId");
+	return executeTransactionTool({
+		input,
+		game,
+		stakeDisplay: toCurrencyAmountText(input.stake, "stake"),
+		gameInputs: { configId },
+		createTransaction: async (bundle) => bundle.client.suigar.tx.createBetTransaction(game, {
+			...await stakeOptions(input, bundle),
+			configId
+		})
+	});
+};
+const buildPlinkoTransactionTool = (input = {}) => buildConfigIdTransactionTool(input, "plinko");
+const buildWheelTransactionTool = (input = {}) => buildConfigIdTransactionTool(input, "wheel");
+const buildRangeTransactionTool = async (input = {}) => {
+	if (getMode(input.mode) === "read-only") return asTextResponse(readOnlyPlan({
+		input,
+		game: "range",
+		requiredInputs: [
+			"owner",
+			"stake",
+			"leftPoint",
+			"rightPoint"
+		],
+		notes: ["Range points are normalized by @suigar/sdk before Move call construction."]
+	}));
+	const leftPoint = requireNumber(input.leftPoint, "leftPoint");
+	const rightPoint = requireNumber(input.rightPoint, "rightPoint");
+	const outOfRange = Boolean(input.outOfRange);
+	return executeTransactionTool({
+		input,
+		game: "range",
+		stakeDisplay: toCurrencyAmountText(input.stake, "stake"),
+		gameInputs: {
+			leftPoint,
+			rightPoint,
+			outOfRange
+		},
+		createTransaction: async (bundle) => bundle.client.suigar.tx.createBetTransaction("range", {
+			...await stakeOptions(input, bundle),
+			leftPoint,
+			rightPoint,
+			outOfRange
+		})
+	});
+};
+const buildPvpCoinflipCreateTransactionTool = async (input = {}) => {
+	if (getMode(input.mode) === "read-only") return asTextResponse(readOnlyPlan({
+		input,
+		game: "pvp-coinflip",
+		action: "create",
+		requiredInputs: [
+			"owner",
+			"stake",
+			"creatorSide"
+		],
+		notes: ["Creates an unresolved PvP coinflip lobby without signing or executing the transaction."]
+	}));
+	const creatorSide = requireString(input.creatorSide, "creatorSide");
+	return executeTransactionTool({
+		input,
+		game: "pvp-coinflip",
+		action: "create",
+		stakeDisplay: toCurrencyAmountText(input.stake, "stake"),
+		gameInputs: {
+			creatorSide,
+			...input.isPrivate == null ? {} : { isPrivate: input.isPrivate }
+		},
+		createTransaction: async (bundle) => bundle.client.suigar.tx.createPvPCoinflipTransaction("create", {
+			...await commonOptions(input, bundle),
+			stake: toBaseUnits(input.stake, "stake", coinMetadataForAmount(bundle.config, input.coinType).decimals),
+			side: creatorSide,
+			isPrivate: input.isPrivate
+		})
+	});
+};
+const buildPvpCoinflipJoinTransactionTool = async (input = {}) => {
+	if (getMode(input.mode) === "read-only") return asTextResponse(readOnlyPlan({
+		input,
+		game: "pvp-coinflip",
+		action: "join",
+		requiredInputs: ["owner", "gameId"],
+		notes: ["Join resolves the live game object during transaction build so the SDK can source the matching stake."]
+	}));
+	const gameId = requireString(input.gameId, "gameId");
+	return executeTransactionTool({
+		input,
+		game: "pvp-coinflip",
+		action: "join",
+		gameInputs: { gameId },
+		createTransaction: async (bundle) => bundle.client.suigar.tx.createPvPCoinflipTransaction("join", {
+			...await commonOptions(input, bundle),
+			gameId
+		})
+	});
+};
+const buildPvpCoinflipCancelTransactionTool = async (input = {}) => {
+	if (getMode(input.mode) === "read-only") return asTextResponse(readOnlyPlan({
+		input,
+		game: "pvp-coinflip",
+		action: "cancel",
+		requiredInputs: ["owner", "gameId"],
+		notes: ["Cancel only prepares the unsigned cancellation transaction for the game creator."]
+	}));
+	const gameId = requireString(input.gameId, "gameId");
+	return executeTransactionTool({
+		input,
+		game: "pvp-coinflip",
+		action: "cancel",
+		gameInputs: { gameId },
+		createTransaction: async (bundle) => bundle.client.suigar.tx.createPvPCoinflipTransaction("cancel", {
+			...await commonOptions(input, bundle),
+			gameId
+		})
+	});
+};
+//#endregion
+export { buildCoinflipTransactionTool, buildLimboTransactionTool, buildPlinkoTransactionTool, buildPvpCoinflipCancelTransactionTool, buildPvpCoinflipCreateTransactionTool, buildPvpCoinflipJoinTransactionTool, buildRangeTransactionTool, buildWheelTransactionTool, readConfigTool, readGameMetadataTool };
+
+//# sourceMappingURL=tools.mjs.map

package/dist/tools.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.mjs","names":[],"sources":["../src/tools.ts"],"sourcesContent":["// Copyright (c) Suigar\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { Transaction } from '@mysten/sui/transactions';\nimport { GAMES } from '@suigar/sdk/games';\nimport type {\n\tCoinSide,\n\tGame,\n\tPvPCoinflipAction,\n\tStandardGame,\n} from '@suigar/sdk/games';\nimport {\n\tbuildTransactionResult,\n\tcreateSuigarClient,\n\tresolveDefaultCoinType,\n\tresolveOwnerAddress,\n} from './client.js';\nimport type { SuigarClientBundle } from './client.js';\nimport type {\n\tCoinflipInput,\n\tConfigIdInput,\n\tLimboInput,\n\tPvpCoinflipCancelInput,\n\tPvpCoinflipCreateInput,\n\tPvpCoinflipJoinInput,\n\tRangeInput,\n\tReadConfigInput,\n\tReadGameMetadataInput,\n} from './schemas.js';\nimport type {\n\tBuilderMode,\n\tJsonValue,\n\tReadConfigResult,\n\tReadGameMetadataResult,\n\tReadOnlyPlan,\n\tResolvedMcpConfig,\n\tToolTextResult,\n} from './types.js';\n\nconst GAME_LABELS = {\n\tcoinflip: 'Coinflip',\n\tlimbo: 'Limbo',\n\tplinko: 'Plinko',\n\trange: 'Range',\n\twheel: 'Wheel',\n\t'pvp-coinflip': 'PvP Coinflip',\n} as const satisfies Record<Game, string>;\n\nconst GAME_TO_PACKAGE_KEY = {\n\tcoinflip: 'coinflip',\n\tlimbo: 'limbo',\n\tplinko: 'plinko',\n\trange: 'range',\n\twheel: 'wheel',\n\t'pvp-coinflip': 'pvpCoinflip',\n} as const satisfies Record<Game, keyof ResolvedMcpConfig['sdk']['packageIds']>;\n\nconst GAME_TO_TOOLS = {\n\tcoinflip: ['build_coinflip_transaction'],\n\tlimbo: ['build_limbo_transaction'],\n\tplinko: ['build_plinko_transaction'],\n\trange: ['build_range_transaction'],\n\twheel: ['build_wheel_transaction'],\n\t'pvp-coinflip': [\n\t\t'build_pvp_coinflip_create_transaction',\n\t\t'build_pvp_coinflip_join_transaction',\n\t\t'build_pvp_coinflip_cancel_transaction',\n\t],\n} as const satisfies Record<Game, readonly string[]>;\n\nconst json = (value: unknown) =>\n\tJSON.stringify(\n\t\tvalue,\n\t\t(_key, item) => (typeof item === 'bigint' ? item.toString() : item),\n\t\t2,\n\t);\n\nconst asTextResponse = <T extends ToolTextResult['structuredContent']>(\n\tstructuredContent: T,\n): ToolTextResult => ({\n\tcontent: [{ type: 'text', text: json(structuredContent) }],\n\tstructuredContent,\n});\n\nconst currencyAmountPattern = /^(?:\\d+|\\d+\\.\\d+|\\.\\d+)$/u;\n\nconst coinMetadataForAmount = (\n\tconfig: ResolvedMcpConfig,\n\tcoinType?: string,\n) => {\n\tconst resolvedCoinType = resolveDefaultCoinType(config, coinType);\n\tconst coin = Object.values(config.sdk.coins).find(\n\t\t(metadata) =>\n\t\t\tresolveDefaultCoinType(config, metadata.coinType) === resolvedCoinType,\n\t);\n\n\tif (!coin) {\n\t\tthrow new RangeError(\n\t\t\t`Unable to resolve decimals for coin type ${resolvedCoinType}. Add the coin to config.coins before using currency-denominated amounts.`,\n\t\t);\n\t}\n\n\treturn {\n\t\tcoinType: resolvedCoinType,\n\t\tdecimals: coin.decimals,\n\t};\n};\n\nconst toCurrencyAmountText = (value: unknown, fieldName: string): string => {\n\tif (typeof value === 'number' && Number.isFinite(value) && value >= 0) {\n\t\treturn String(value);\n\t}\n\tif (typeof value === 'string' && currencyAmountPattern.test(value.trim())) {\n\t\treturn value.trim();\n\t}\n\tthrow new TypeError(\n\t\t`Missing or invalid ${fieldName}. Provide a non-negative currency amount such as 1, 2, or 1.5.`,\n\t);\n};\n\nconst toBaseUnits = (\n\tvalue: unknown,\n\tfieldName: string,\n\tdecimals: number,\n): bigint => {\n\tconst amount = toCurrencyAmountText(value, fieldName);\n\tconst [rawWhole, rawFraction = ''] = amount.split('.');\n\tconst whole = rawWhole === '' ? '0' : rawWhole;\n\tconst overflow = rawFraction.slice(decimals);\n\tif (/[^0]/u.test(overflow)) {\n\t\tthrow new RangeError(\n\t\t\t`${fieldName} has more fractional digits than the configured coin decimals (${decimals}).`,\n\t\t);\n\t}\n\tconst fraction = rawFraction.slice(0, decimals).padEnd(decimals, '0');\n\treturn BigInt(whole) * 10n ** BigInt(decimals) + BigInt(fraction || '0');\n};\n\nconst toPositiveInteger = (\n\tvalue: unknown,\n\tfieldName: string,\n): number | bigint => {\n\tif (typeof value === 'number' && Number.isSafeInteger(value) && value > 0) {\n\t\treturn value;\n\t}\n\tif (typeof value === 'string' && /^[1-9]\\d*$/u.test(value)) {\n\t\treturn BigInt(value);\n\t}\n\tthrow new TypeError(\n\t\t`Missing or invalid ${fieldName}. Provide a positive integer.`,\n\t);\n};\n\nconst requireString = (value: unknown, fieldName: string): string => {\n\tif (typeof value === 'string' && value.trim()) {\n\t\treturn value.trim();\n\t}\n\tthrow new TypeError(`Missing required field: ${fieldName}.`);\n};\n\nconst requireNumber = (value: unknown, fieldName: string): number => {\n\tif (typeof value === 'number' && Number.isFinite(value)) {\n\t\treturn value;\n\t}\n\tthrow new TypeError(`Missing or invalid numeric field: ${fieldName}.`);\n};\n\nconst getMode = (mode: BuilderMode | undefined): BuilderMode => mode ?? 'build';\n\nconst getConfigInput = (input: ReadConfigInput) => ({\n\tnetwork: input.network,\n\tproviderUrl: input.providerUrl,\n\tconfig: input.config,\n\tpartner: input.partner,\n});\n\nconst supportedGames = () =>\n\tGAMES.map((id) => ({\n\t\tid,\n\t\tlabel: GAME_LABELS[id],\n\t\ttools: [...GAME_TO_TOOLS[id]],\n\t}));\n\nconst getPackageId = (config: ResolvedMcpConfig, game: Game) =>\n\tconfig.sdk.packageIds[GAME_TO_PACKAGE_KEY[game]];\n\nconst getTarget = (\n\tconfig: ResolvedMcpConfig,\n\tgame: Game,\n\taction?: PvPCoinflipAction,\n) => {\n\tconst packageId = getPackageId(config, game);\n\tif (game === 'pvp-coinflip') {\n\t\tconst functionName =\n\t\t\taction === 'join'\n\t\t\t\t? 'join_game'\n\t\t\t\t: action === 'cancel'\n\t\t\t\t\t? 'cancel_game'\n\t\t\t\t\t: 'create_game';\n\t\treturn `${packageId}::pvp_coinflip::${functionName}`;\n\t}\n\treturn `${packageId}::${game}::play`;\n};\n\nconst readOnlyPlan = ({\n\tinput,\n\tgame,\n\taction,\n\trequiredInputs,\n\tnotes,\n}: {\n\tinput:\n\t\t| CoinflipInput\n\t\t| LimboInput\n\t\t| ConfigIdInput\n\t\t| RangeInput\n\t\t| PvpCoinflipCreateInput\n\t\t| PvpCoinflipJoinInput\n\t\t| PvpCoinflipCancelInput;\n\tgame: Game;\n\taction?: PvPCoinflipAction;\n\trequiredInputs: string[];\n\tnotes: string[];\n}): ReadOnlyPlan => {\n\tconst { config } = createSuigarClient(getConfigInput(input));\n\tconst coinType = resolveDefaultCoinType(config, input.coinType);\n\treturn {\n\t\tmode: 'read-only',\n\t\tnetwork: config.network,\n\t\tgame,\n\t\taction,\n\t\tconfig,\n\t\tplan: {\n\t\t\ttarget: getTarget(config, game, action),\n\t\t\ttypeArguments: [coinType],\n\t\t\trequiredInputs,\n\t\t\tnotes,\n\t\t},\n\t};\n};\n\nconst commonOptions = async (\n\tinput:\n\t\t| CoinflipInput\n\t\t| LimboInput\n\t\t| ConfigIdInput\n\t\t| RangeInput\n\t\t| PvpCoinflipCreateInput\n\t\t| PvpCoinflipJoinInput\n\t\t| PvpCoinflipCancelInput,\n\tbundle: SuigarClientBundle,\n) => {\n\treturn {\n\t\towner: await resolveOwnerAddress(\n\t\t\trequireString(input.owner, 'owner'),\n\t\t\tbundle,\n\t\t),\n\t\tcoinType: resolveDefaultCoinType(bundle.config, input.coinType),\n\t\tmetadata: input.metadata,\n\t\tgasBudget: input.gasBudget,\n\t\tuseGasCoin: input.useGasCoin,\n\t};\n};\n\nconst stakeOptions = async (\n\tinput: CoinflipInput | LimboInput | ConfigIdInput | RangeInput,\n\tbundle: SuigarClientBundle,\n) => {\n\tconst { decimals } = coinMetadataForAmount(bundle.config, input.coinType);\n\treturn {\n\t\t...(await commonOptions(input, bundle)),\n\t\tstake: toBaseUnits(input.stake, 'stake', decimals),\n\t\t...(input.cashStake == null\n\t\t\t? {}\n\t\t\t: { cashStake: toBaseUnits(input.cashStake, 'cashStake', decimals) }),\n\t\t...(input.betCount == null\n\t\t\t? {}\n\t\t\t: { betCount: toPositiveInteger(input.betCount, 'betCount') }),\n\t};\n};\n\nconst executeTransactionTool = async ({\n\tinput,\n\tgame,\n\taction,\n\tcreateTransaction,\n\tstake,\n\tstakeDisplay,\n\tgameInputs,\n}: {\n\tinput:\n\t\t| CoinflipInput\n\t\t| LimboInput\n\t\t| ConfigIdInput\n\t\t| RangeInput\n\t\t| PvpCoinflipCreateInput\n\t\t| PvpCoinflipJoinInput\n\t\t| PvpCoinflipCancelInput;\n\tgame: Game;\n\taction?: PvPCoinflipAction;\n\tcreateTransaction: (bundle: SuigarClientBundle) => Promise<Transaction>;\n\tstake?: number | bigint;\n\tstakeDisplay?: string;\n\tgameInputs?: Record<string, JsonValue>;\n}) => {\n\tconst mode = getMode(input.mode);\n\tif (mode === 'read-only') {\n\t\tthrow new Error(\n\t\t\t'read-only mode must be handled before transaction execution.',\n\t\t);\n\t}\n\n\tconst bundle = createSuigarClient(getConfigInput(input));\n\tconst coin = coinMetadataForAmount(bundle.config, input.coinType);\n\tconst baseStake =\n\t\tstake ??\n\t\t(stakeDisplay == null\n\t\t\t? undefined\n\t\t\t: toBaseUnits(stakeDisplay, 'stake', coin.decimals));\n\tconst transaction = await createTransaction(bundle);\n\treturn asTextResponse(\n\t\tawait buildTransactionResult({\n\t\t\tmode,\n\t\t\ttransaction,\n\t\t\tconfig: bundle.config,\n\t\t\tclient: bundle.client,\n\t\t\tcontext: {\n\t\t\t\tgame,\n\t\t\t\taction,\n\t\t\t\tcoinType: coin.coinType,\n\t\t\t\tstake: baseStake,\n\t\t\t\tstakeDisplay,\n\t\t\t\tcoinDecimals: coin.decimals,\n\t\t\t\tgameInputs,\n\t\t\t},\n\t\t}),\n\t);\n};\n\nexport const readConfigTool = async (input: ReadConfigInput = {}) => {\n\tconst { config } = createSuigarClient(getConfigInput(input));\n\treturn asTextResponse({\n\t\tnetwork: config.network,\n\t\tconfig,\n\t\tsupportedGames: supportedGames(),\n\t} satisfies ReadConfigResult);\n};\n\nexport const readGameMetadataTool = async (\n\tinput: ReadGameMetadataInput = {},\n) => {\n\tconst { config } = createSuigarClient(getConfigInput(input));\n\tconst game = input.game ?? null;\n\tconst coinType = resolveDefaultCoinType(config, input.coinType);\n\treturn asTextResponse({\n\t\tnetwork: config.network,\n\t\tconfig,\n\t\tsupportedGames: supportedGames(),\n\t\tgame: game\n\t\t\t? {\n\t\t\t\t\tid: game,\n\t\t\t\t\tlabel: GAME_LABELS[game],\n\t\t\t\t\tpackageId: getPackageId(config, game),\n\t\t\t\t\tcoinType,\n\t\t\t\t\tnotes: [\n\t\t\t\t\t\tgame === 'pvp-coinflip'\n\t\t\t\t\t\t\t? 'PvP coinflip uses dedicated create, join, and cancel transaction builders.'\n\t\t\t\t\t\t\t: 'Standard games use client.suigar.tx.createBetTransaction().',\n\t\t\t\t\t\t'Transactions are unsigned and are never executed by the MCP server.',\n\t\t\t\t\t],\n\t\t\t\t}\n\t\t\t: null,\n\t} satisfies ReadGameMetadataResult);\n};\n\nexport const buildCoinflipTransactionTool = async (\n\tinput: CoinflipInput = {},\n) => {\n\tif (getMode(input.mode) === 'read-only') {\n\t\treturn asTextResponse(\n\t\t\treadOnlyPlan({\n\t\t\t\tinput,\n\t\t\t\tgame: 'coinflip',\n\t\t\t\trequiredInputs: ['owner', 'stake', 'side'],\n\t\t\t\tnotes: [\n\t\t\t\t\t'Uses the configured SweetHouse object, Pyth price info, clock, and randomness objects.',\n\t\t\t\t],\n\t\t\t}),\n\t\t);\n\t}\n\n\tconst side = requireString(input.side, 'side') as CoinSide;\n\treturn executeTransactionTool({\n\t\tinput,\n\t\tgame: 'coinflip',\n\t\tstakeDisplay: toCurrencyAmountText(input.stake, 'stake'),\n\t\tgameInputs: { side },\n\t\tcreateTransaction: async (bundle) =>\n\t\t\tbundle.client.suigar.tx.createBetTransaction('coinflip', {\n\t\t\t\t...(await stakeOptions(input, bundle)),\n\t\t\t\tside,\n\t\t\t}),\n\t});\n};\n\nexport const buildLimboTransactionTool = async (input: LimboInput = {}) => {\n\tif (getMode(input.mode) === 'read-only') {\n\t\treturn asTextResponse(\n\t\t\treadOnlyPlan({\n\t\t\t\tinput,\n\t\t\t\tgame: 'limbo',\n\t\t\t\trequiredInputs: ['owner', 'stake', 'targetMultiplier'],\n\t\t\t\tnotes: [\n\t\t\t\t\t'Target multiplier is encoded by @suigar/sdk using the public fixed-point utility defaults.',\n\t\t\t\t],\n\t\t\t}),\n\t\t);\n\t}\n\n\tconst targetMultiplier = requireNumber(\n\t\tinput.targetMultiplier,\n\t\t'targetMultiplier',\n\t);\n\treturn executeTransactionTool({\n\t\tinput,\n\t\tgame: 'limbo',\n\t\tstakeDisplay: toCurrencyAmountText(input.stake, 'stake'),\n\t\tgameInputs: { targetMultiplier },\n\t\tcreateTransaction: async (bundle) =>\n\t\t\tbundle.client.suigar.tx.createBetTransaction('limbo', {\n\t\t\t\t...(await stakeOptions(input, bundle)),\n\t\t\t\ttargetMultiplier,\n\t\t\t}),\n\t});\n};\n\nconst buildConfigIdTransactionTool = async (\n\tinput: ConfigIdInput,\n\tgame: Extract<StandardGame, 'plinko' | 'wheel'>,\n) => {\n\tif (getMode(input.mode) === 'read-only') {\n\t\treturn asTextResponse(\n\t\t\treadOnlyPlan({\n\t\t\t\tinput,\n\t\t\t\tgame,\n\t\t\t\trequiredInputs: ['owner', 'stake', 'configId'],\n\t\t\t\tnotes: ['Config id selects the on-chain game configuration.'],\n\t\t\t}),\n\t\t);\n\t}\n\n\tconst configId = requireNumber(input.configId, 'configId');\n\treturn executeTransactionTool({\n\t\tinput,\n\t\tgame,\n\t\tstakeDisplay: toCurrencyAmountText(input.stake, 'stake'),\n\t\tgameInputs: { configId },\n\t\tcreateTransaction: async (bundle) =>\n\t\t\tbundle.client.suigar.tx.createBetTransaction(game, {\n\t\t\t\t...(await stakeOptions(input, bundle)),\n\t\t\t\tconfigId,\n\t\t\t}),\n\t});\n};\n\nexport const buildPlinkoTransactionTool = (input: ConfigIdInput = {}) =>\n\tbuildConfigIdTransactionTool(input, 'plinko');\n\nexport const buildWheelTransactionTool = (input: ConfigIdInput = {}) =>\n\tbuildConfigIdTransactionTool(input, 'wheel');\n\nexport const buildRangeTransactionTool = async (input: RangeInput = {}) => {\n\tif (getMode(input.mode) === 'read-only') {\n\t\treturn asTextResponse(\n\t\t\treadOnlyPlan({\n\t\t\t\tinput,\n\t\t\t\tgame: 'range',\n\t\t\t\trequiredInputs: ['owner', 'stake', 'leftPoint', 'rightPoint'],\n\t\t\t\tnotes: [\n\t\t\t\t\t'Range points are normalized by @suigar/sdk before Move call construction.',\n\t\t\t\t],\n\t\t\t}),\n\t\t);\n\t}\n\n\tconst leftPoint = requireNumber(input.leftPoint, 'leftPoint');\n\tconst rightPoint = requireNumber(input.rightPoint, 'rightPoint');\n\tconst outOfRange = Boolean(input.outOfRange);\n\treturn executeTransactionTool({\n\t\tinput,\n\t\tgame: 'range',\n\t\tstakeDisplay: toCurrencyAmountText(input.stake, 'stake'),\n\t\tgameInputs: { leftPoint, rightPoint, outOfRange },\n\t\tcreateTransaction: async (bundle) =>\n\t\t\tbundle.client.suigar.tx.createBetTransaction('range', {\n\t\t\t\t...(await stakeOptions(input, bundle)),\n\t\t\t\tleftPoint,\n\t\t\t\trightPoint,\n\t\t\t\toutOfRange,\n\t\t\t}),\n\t});\n};\n\nexport const buildPvpCoinflipCreateTransactionTool = async (\n\tinput: PvpCoinflipCreateInput = {},\n) => {\n\tif (getMode(input.mode) === 'read-only') {\n\t\treturn asTextResponse(\n\t\t\treadOnlyPlan({\n\t\t\t\tinput,\n\t\t\t\tgame: 'pvp-coinflip',\n\t\t\t\taction: 'create',\n\t\t\t\trequiredInputs: ['owner', 'stake', 'creatorSide'],\n\t\t\t\tnotes: [\n\t\t\t\t\t'Creates an unresolved PvP coinflip lobby without signing or executing the transaction.',\n\t\t\t\t],\n\t\t\t}),\n\t\t);\n\t}\n\n\tconst creatorSide = requireString(\n\t\tinput.creatorSide,\n\t\t'creatorSide',\n\t) as CoinSide;\n\treturn executeTransactionTool({\n\t\tinput,\n\t\tgame: 'pvp-coinflip',\n\t\taction: 'create',\n\t\tstakeDisplay: toCurrencyAmountText(input.stake, 'stake'),\n\t\tgameInputs: {\n\t\t\tcreatorSide,\n\t\t\t...(input.isPrivate == null ? {} : { isPrivate: input.isPrivate }),\n\t\t},\n\t\tcreateTransaction: async (bundle) =>\n\t\t\tbundle.client.suigar.tx.createPvPCoinflipTransaction('create', {\n\t\t\t\t...(await commonOptions(input, bundle)),\n\t\t\t\tstake: toBaseUnits(\n\t\t\t\t\tinput.stake,\n\t\t\t\t\t'stake',\n\t\t\t\t\tcoinMetadataForAmount(bundle.config, input.coinType).decimals,\n\t\t\t\t),\n\t\t\t\tside: creatorSide,\n\t\t\t\tisPrivate: input.isPrivate,\n\t\t\t}),\n\t});\n};\n\nexport const buildPvpCoinflipJoinTransactionTool = async (\n\tinput: PvpCoinflipJoinInput = {},\n) => {\n\tif (getMode(input.mode) === 'read-only') {\n\t\treturn asTextResponse(\n\t\t\treadOnlyPlan({\n\t\t\t\tinput,\n\t\t\t\tgame: 'pvp-coinflip',\n\t\t\t\taction: 'join',\n\t\t\t\trequiredInputs: ['owner', 'gameId'],\n\t\t\t\tnotes: [\n\t\t\t\t\t'Join resolves the live game object during transaction build so the SDK can source the matching stake.',\n\t\t\t\t],\n\t\t\t}),\n\t\t);\n\t}\n\n\tconst gameId = requireString(input.gameId, 'gameId');\n\treturn executeTransactionTool({\n\t\tinput,\n\t\tgame: 'pvp-coinflip',\n\t\taction: 'join',\n\t\tgameInputs: { gameId },\n\t\tcreateTransaction: async (bundle) =>\n\t\t\tbundle.client.suigar.tx.createPvPCoinflipTransaction('join', {\n\t\t\t\t...(await commonOptions(input, bundle)),\n\t\t\t\tgameId,\n\t\t\t}),\n\t});\n};\n\nexport const buildPvpCoinflipCancelTransactionTool = async (\n\tinput: PvpCoinflipCancelInput = {},\n) => {\n\tif (getMode(input.mode) === 'read-only') {\n\t\treturn asTextResponse(\n\t\t\treadOnlyPlan({\n\t\t\t\tinput,\n\t\t\t\tgame: 'pvp-coinflip',\n\t\t\t\taction: 'cancel',\n\t\t\t\trequiredInputs: ['owner', 'gameId'],\n\t\t\t\tnotes: [\n\t\t\t\t\t'Cancel only prepares the unsigned cancellation transaction for the game creator.',\n\t\t\t\t],\n\t\t\t}),\n\t\t);\n\t}\n\n\tconst gameId = requireString(input.gameId, 'gameId');\n\treturn executeTransactionTool({\n\t\tinput,\n\t\tgame: 'pvp-coinflip',\n\t\taction: 'cancel',\n\t\tgameInputs: { gameId },\n\t\tcreateTransaction: async (bundle) =>\n\t\t\tbundle.client.suigar.tx.createPvPCoinflipTransaction('cancel', {\n\t\t\t\t...(await commonOptions(input, bundle)),\n\t\t\t\tgameId,\n\t\t\t}),\n\t});\n};\n"],"mappings":"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"}

package/dist/types.d.mts

@@ -0,0 +1,137 @@
+import { SuigarClient, SuigarNetwork, suigar } from "@suigar/sdk";
+import { Game, PvPCoinflipAction } from "@suigar/sdk/games";
+import { SuiClientTypes } from "@mysten/sui/client";
+
+//#region src/types.d.ts
+type SuigarConfig = ReturnType<SuigarClient['getConfig']>;
+type SuigarConfigOverrides = NonNullable<Parameters<typeof suigar>[0]>['config'];
+type RawDryRunResult = SuiClientTypes.SimulateTransactionResult<{
+  effects: true;
+  events: true;
+  balanceChanges: true;
+}>;
+type JsonValue = string | number | boolean | null | JsonValue[] | {
+  [key: string]: JsonValue;
+};
+type DryRunResult = {
+  [key: string]: JsonValue;
+};
+type BuilderMode = 'build' | 'dry-run' | 'read-only';
+type SuigarMcpConfigInput = {
+  network?: SuigarNetwork;
+  providerUrl?: string;
+  config?: SuigarConfigOverrides;
+  partner?: string;
+};
+type ResolvedMcpConfig = {
+  network: SuigarNetwork;
+  providerUrl: string;
+  sdk: SuigarConfig;
+};
+type TransactionCommandSummary = {
+  kind: string;
+  target?: string;
+  typeArguments?: string[];
+};
+type TransactionSummary = {
+  sender: string | null;
+  gasBudget: string | null;
+  gasBudgetDisplay: string | null;
+  gasPrice: string | null;
+  commandCount: number;
+  commands: TransactionCommandSummary[];
+  inputs: number;
+  objectInputs: string[];
+  game?: Game;
+  action?: PvPCoinflipAction;
+  coinType?: string;
+  stake?: string;
+  stakeDisplay?: string;
+  coinDecimals?: number;
+  gameInputs?: {
+    [key: string]: JsonValue;
+  };
+};
+type FormattedAmount = {
+  raw: string;
+  display: string;
+};
+type DryRunEventSummary = {
+  type: string;
+  game?: Game;
+  eventName?: string;
+  fields: {
+    [key: string]: JsonValue;
+  };
+};
+type DryRunSummary = {
+  success: boolean;
+  error: string | null;
+  gasUsed: {
+    computation: FormattedAmount | null;
+    storage: FormattedAmount | null;
+    rebate: FormattedAmount | null;
+    nonRefundableStorageFee: FormattedAmount | null;
+    net: FormattedAmount | null;
+  };
+  balanceChanges: Array<{
+    address: string;
+    coinType: string;
+    amount: FormattedAmount;
+  }>;
+  events: DryRunEventSummary[];
+};
+type ReadOnlyPlan = {
+  mode: 'read-only';
+  network: SuigarNetwork;
+  game: Game;
+  action?: PvPCoinflipAction;
+  config: ResolvedMcpConfig;
+  plan: {
+    target: string | null;
+    typeArguments: string[];
+    requiredInputs: string[];
+    notes: string[];
+  };
+};
+type BuildTransactionResult = {
+  mode: 'build' | 'dry-run';
+  network: SuigarNetwork;
+  config: ResolvedMcpConfig;
+  summary: TransactionSummary;
+  transactionBytesBase64?: string;
+  dryRun?: DryRunResult;
+  dryRunSummary?: DryRunSummary;
+  errors?: string[];
+};
+type ReadConfigResult = {
+  network: SuigarNetwork;
+  config: ResolvedMcpConfig;
+  supportedGames: Array<{
+    id: Game;
+    label: string;
+    tools: string[];
+  }>;
+};
+type ReadGameMetadataResult = ReadConfigResult & {
+  game: {
+    id: Game;
+    label: string;
+    packageId: string;
+    coinType: string;
+    action?: PvPCoinflipAction;
+    notes: string[];
+  } | null;
+};
+type ToolStructuredResult = ReadConfigResult | ReadGameMetadataResult | ReadOnlyPlan | BuildTransactionResult;
+type ToolTextResult = {
+  content: [{
+    type: 'text';
+    text: string;
+  }];
+  structuredContent: ToolStructuredResult;
+  _meta?: Record<string, unknown>;
+};
+//#endregion
+export { BuildTransactionResult, BuilderMode, DryRunEventSummary, DryRunResult, DryRunSummary, FormattedAmount, JsonValue, RawDryRunResult, ReadConfigResult, ReadGameMetadataResult, ReadOnlyPlan, ResolvedMcpConfig, SuigarConfig, SuigarConfigOverrides, SuigarMcpConfigInput, ToolStructuredResult, ToolTextResult, TransactionCommandSummary, TransactionSummary };
+//# sourceMappingURL=types.d.mts.map

package/dist/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;KAOY,YAAA,GAAe,UAAU,CAAC,YAAA;AAAA,KAC1B,qBAAA,GAAwB,WAAA,CACnC,UAAA,QAAkB,MAAA;AAAA,KAEP,eAAA,GAAkB,cAAA,CAAe,yBAAyB;EACrE,OAAA;EACA,MAAA;EACA,cAAA;AAAA;AAAA,KAGW,SAAA,sCACwB,SAAA;EAAA,CAAiB,GAAA,WAAc,SAAS;AAAA;AAAA,KAEhE,YAAA;EAAA,CAAkB,GAAA,WAAc,SAAS;AAAA;AAAA,KAEzC,WAAA;AAAA,KAEA,oBAAA;EACX,OAAA,GAAU,aAAA;EACV,WAAA;EACA,MAAA,GAAS,qBAAqB;EAC9B,OAAA;AAAA;AAAA,KAGW,iBAAA;EACX,OAAA,EAAS,aAAA;EACT,WAAA;EACA,GAAA,EAAK,YAAY;AAAA;AAAA,KAGN,yBAAA;EACX,IAAA;EACA,MAAA;EACA,aAAA;AAAA;AAAA,KAGW,kBAAA;EACX,MAAA;EACA,SAAA;EACA,gBAAA;EACA,QAAA;EACA,YAAA;EACA,QAAA,EAAU,yBAAA;EACV,MAAA;EACA,YAAA;EACA,IAAA,GAAO,IAAA;EACP,MAAA,GAAS,iBAAA;EACT,QAAA;EACA,KAAA;EACA,YAAA;EACA,YAAA;EACA,UAAA;IAAA,CAAgB,GAAA,WAAc,SAAA;EAAA;AAAA;AAAA,KAGnB,eAAA;EACX,GAAA;EACA,OAAO;AAAA;AAAA,KAGI,kBAAA;EACX,IAAA;EACA,IAAA,GAAO,IAAA;EACP,SAAA;EACA,MAAA;IAAA,CAAW,GAAA,WAAc,SAAS;EAAA;AAAA;AAAA,KAGvB,aAAA;EACX,OAAA;EACA,KAAA;EACA,OAAA;IACC,WAAA,EAAa,eAAA;IACb,OAAA,EAAS,eAAA;IACT,MAAA,EAAQ,eAAA;IACR,uBAAA,EAAyB,eAAA;IACzB,GAAA,EAAK,eAAA;EAAA;EAEN,cAAA,EAAgB,KAAA;IACf,OAAA;IACA,QAAA;IACA,MAAA,EAAQ,eAAA;EAAA;EAET,MAAA,EAAQ,kBAAA;AAAA;AAAA,KAGG,YAAA;EACX,IAAA;EACA,OAAA,EAAS,aAAA;EACT,IAAA,EAAM,IAAA;EACN,MAAA,GAAS,iBAAA;EACT,MAAA,EAAQ,iBAAA;EACR,IAAA;IACC,MAAA;IACA,aAAA;IACA,cAAA;IACA,KAAA;EAAA;AAAA;AAAA,KAIU,sBAAA;EACX,IAAA;EACA,OAAA,EAAS,aAAA;EACT,MAAA,EAAQ,iBAAA;EACR,OAAA,EAAS,kBAAA;EACT,sBAAA;EACA,MAAA,GAAS,YAAA;EACT,aAAA,GAAgB,aAAA;EAChB,MAAA;AAAA;AAAA,KAGW,gBAAA;EACX,OAAA,EAAS,aAAA;EACT,MAAA,EAAQ,iBAAA;EACR,cAAA,EAAgB,KAAA;IACf,EAAA,EAAI,IAAA;IACJ,KAAA;IACA,KAAA;EAAA;AAAA;AAAA,KAIU,sBAAA,GAAyB,gBAAA;EACpC,IAAA;IACC,EAAA,EAAI,IAAA;IACJ,KAAA;IACA,SAAA;IACA,QAAA;IACA,MAAA,GAAS,iBAAA;IACT,KAAA;EAAA;AAAA;AAAA,KAIU,oBAAA,GACT,gBAAA,GACA,sBAAA,GACA,YAAA,GACA,sBAAA;AAAA,KAES,cAAA;EACX,OAAA;IAAY,IAAA;IAAc,IAAA;EAAA;EAC1B,iBAAA,EAAmB,oBAAA;EACnB,KAAA,GAAQ,MAAM;AAAA"}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@suigar/mcp",
-  "version": "0.1.1",
-  "description": "Lightweight MCP tools and transaction builders for Suigar on Sui",
+  "version": "0.2.0-beta.0",
+  "description": "MCP server and MCP App for building and inspecting Suigar transactions on Sui.",
   "keywords": [
     "suigar",
     "sui",
     "mcp",
+    "mcp-app",
     "typescript",
     "move",
     "web3",
@@ -19,58 +20,65 @@
     "CHANGELOG.md",
     "README.md"
   ],
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.mjs",
+  "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "exports": {
     ".": {
       "types": "./dist/index.d.mts",
-      "require": "./dist/index.cjs",
-      "import": "./dist/index.mjs"
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
     },
     "./server": {
       "types": "./dist/server.d.mts",
-      "require": "./dist/server.cjs",
-      "import": "./dist/server.mjs"
+      "import": "./dist/server.mjs",
+      "default": "./dist/server.mjs"
     }
   },
   "bin": {
-    "suigar": "dist/bin.cjs"
+    "suigar": "./dist/bin.mjs"
   },
   "engines": {
     "node": "^22.18.0 || >=24.0.0"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Suigar-Gaming/suigar-skill.git"
+    "url": "git+https://github.com/Suigar-Gaming/sdk.git",
+    "directory": "packages/mcp"
   },
   "publishConfig": {
     "access": "public"
   },
   "bugs": {
-    "url": "https://github.com/Suigar-Gaming/suigar-skill/issues"
+    "url": "https://github.com/Suigar-Gaming/sdk/issues"
   },
-  "homepage": "https://docs.suigar.com",
+  "homepage": "https://docs.suigar.com/mcp",
   "dependencies": {
+    "@modelcontextprotocol/ext-apps": "1.7.4",
     "@modelcontextprotocol/sdk": "1.29.0",
-    "@mysten/bcs": "2.1.0",
-    "@mysten/sui": "2.20.1",
-    "@suigar/sdk": "2.0.0-beta.21"
+    "@mysten/sui": "^2.20.1",
+    "zod": "4.4.3",
+    "@suigar/sdk": "^2.0.0-beta.22"
   },
   "devDependencies": {
-    "@types/node": "24.13.2",
-    "tsdown": "0.22.3",
-    "typescript": "5.9.3",
-    "vitest": "4.1.9",
-    "@suigar/game-registry": "^0.0.0",
-    "@suigar/currency-registry": "^0.0.0",
-    "@suigar/sui-rpc-pool": "^0.0.0"
+    "@types/node": "^24.0.0",
+    "tsdown": "^0.22.3",
+    "typescript": "^6.0.3",
+    "vite": "^8.1.0",
+    "vite-plugin-singlefile": "^2.3.3",
+    "vitest": "^4.1.9"
   },
   "scripts": {
-    "prebuild": "pnpm --filter @suigar/currency-registry build && pnpm --filter @suigar/game-registry build && pnpm --filter @suigar/sui-rpc-pool build",
-    "build": "pnpm clean && tsdown",
+    "start:local": "pnpm --filter @suigar/sdk build:ci && pnpm build && node dist/bin.mjs",
+    "build": "pnpm clean && tsdown && vite build",
+    "build:ci": "pnpm build",
     "clean": "rm -rf dist",
+    "test": "vitest run",
     "typecheck": "tsc --noEmit",
-    "test": "vitest run"
+    "eslint": "eslint .",
+    "eslint:fix": "eslint . --fix",
+    "prettier": "prettier --check --ignore-unknown .",
+    "prettier:fix": "prettier --write --ignore-unknown .",
+    "lint": "pnpm eslint && pnpm prettier",
+    "lint:fix": "pnpm eslint:fix && pnpm prettier:fix"
   }
 }

package/dist/bin.cjs

@@ -1,11 +0,0 @@
-#!/usr/bin/env node
-const require_server = require("./server-Cmo8UaHE.cjs");
-//#region src/bin.ts
-const main = async () => {
-	await require_server.startSuigarMcpServer();
-};
-main().catch((error) => {
-	console.error(error);
-	process.exitCode = 1;
-});
-//#endregion

package/dist/bin.d.cts

@@ -1 +0,0 @@
-export { };