@suigar/mcp 0.1.1 → 0.2.0-beta.0

package/dist/bin.mjs

@@ -1,12 +1,8 @@
 #!/usr/bin/env node
-import { n as startSuigarMcpServer } from "./server-BD-123-u.mjs";
+import { startSuigarMcpServer } from "./server.mjs";
 //#region src/bin.ts
-const main = async () => {
-	await startSuigarMcpServer();
-};
-main().catch((error) => {
-	console.error(error);
-	process.exitCode = 1;
-});
+await startSuigarMcpServer();
 //#endregion
 export {};
+
+//# sourceMappingURL=bin.mjs.map

package/dist/bin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.mjs","names":[],"sources":["../src/bin.ts"],"sourcesContent":["#!/usr/bin/env node\n// Copyright (c) Suigar\n// SPDX-License-Identifier: Apache-2.0\nimport { startSuigarMcpServer } from './server.js';\n\nawait startSuigarMcpServer();\n"],"mappings":";;;AAKA,MAAM,qBAAqB"}

package/dist/client.d.mts

@@ -0,0 +1,47 @@
+import { BuildTransactionResult, BuilderMode, JsonValue, RawDryRunResult, ResolvedMcpConfig, SuigarMcpConfigInput, TransactionSummary } from "./types.mjs";
+import { SuigarClient, SuigarNetwork } from "@suigar/sdk";
+import { Game, PvPCoinflipAction } from "@suigar/sdk/games";
+import { SuiGrpcClient } from "@mysten/sui/grpc";
+import { ClientWithExtensions } from "@mysten/sui/client";
+import { Transaction } from "@mysten/sui/transactions";
+
+//#region src/client.d.ts
+declare const DEFAULT_NETWORK: SuigarNetwork;
+declare const normalizeNetwork: (network?: string | undefined) => SuigarNetwork;
+declare const getProviderUrl: (network: SuigarNetwork, providerUrl?: string) => string;
+type SuigarClientBundle = {
+  client: ClientWithExtensions<{
+    suigar: SuigarClient;
+  }, SuiGrpcClient>;
+  config: ResolvedMcpConfig;
+  resolveSuiNSName(name: string): Promise<string | null>;
+};
+declare const createSuigarClient: (input?: SuigarMcpConfigInput) => SuigarClientBundle;
+declare const resolveDefaultCoinType: (config: ResolvedMcpConfig, coinType?: string) => string;
+declare const resolveOwnerAddress: (owner: string, bundle: SuigarClientBundle) => Promise<string>;
+declare const dryRunTransaction: (transaction: Transaction, client: ReturnType<typeof createSuigarClient>["client"]) => Promise<RawDryRunResult>;
+declare const summarizeTransaction: (transaction: Transaction, context?: {
+  game?: Game;
+  action?: PvPCoinflipAction;
+  coinType?: string;
+  stake?: bigint | number;
+  stakeDisplay?: string;
+  coinDecimals?: number;
+  gameInputs?: Record<string, JsonValue>;
+}) => TransactionSummary;
+declare const buildTransactionResult: ({
+  mode,
+  transaction,
+  config,
+  client,
+  context
+}: {
+  mode: Exclude<BuilderMode, "read-only">;
+  transaction: Transaction;
+  config: ResolvedMcpConfig;
+  client: ReturnType<typeof createSuigarClient>["client"];
+  context: Parameters<typeof summarizeTransaction>[1];
+}) => Promise<BuildTransactionResult>;
+//#endregion
+export { DEFAULT_NETWORK, SuigarClientBundle, buildTransactionResult, createSuigarClient, dryRunTransaction, getProviderUrl, normalizeNetwork, resolveDefaultCoinType, resolveOwnerAddress, summarizeTransaction };
+//# sourceMappingURL=client.d.mts.map

package/dist/client.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.mts","names":[],"sources":["../src/client.ts"],"mappings":";;;;;;;;cAuCa,eAAA,EAAiB,aAAyB;AAAA,cAE1C,gBAAA,GACZ,OAAA,0BACE,aAQF;AAAA,cAEY,cAAA,GAAkB,OAAA,EAAS,aAAa,EAAE,WAAA;AAAA,KAG3C,kBAAA;EACX,MAAA,EAAQ,oBAAA;IAEN,MAAA,EAAQ,YAAA;EAAA,GAET,aAAA;EAED,MAAA,EAAQ,iBAAA;EACR,gBAAA,CAAiB,IAAA,WAAe,OAAA;AAAA;AAAA,cAGpB,kBAAA,GACZ,KAAA,GAAO,oBAAA,KACL,kBA2BF;AAAA,cAEY,sBAAA,GACZ,MAAA,EAAQ,iBAAiB,EACzB,QAAA;AAAA,cAGY,mBAAA,GACZ,KAAA,UACA,MAAA,EAAQ,kBAAA,KACN,OAAO;AAAA,cA2BG,iBAAA,GACZ,WAAA,EAAa,WAAA,EACb,MAAA,EAAQ,UAAA,QAAkB,kBAAA,gBACxB,OAAA,CAAQ,eAAA;AAAA,cAUE,oBAAA,GACZ,WAAA,EAAa,WAAA,EACb,OAAA;EACC,IAAA,GAAO,IAAA;EACP,MAAA,GAAS,iBAAA;EACT,QAAA;EACA,KAAA;EACA,YAAA;EACA,YAAA;EACA,UAAA,GAAa,MAAA,SAAe,SAAA;AAAA,MAE3B,kBAAA;AAAA,cAwEU,sBAAA;EAAgC,IAAA;EAAA,WAAA;EAAA,MAAA;EAAA,MAAA;EAAA;AAAA;EAO5C,IAAA,EAAM,OAAA,CAAQ,WAAA;EACd,WAAA,EAAa,WAAA;EACb,MAAA,EAAQ,iBAAA;EACR,MAAA,EAAQ,UAAA,QAAkB,kBAAA;EAC1B,OAAA,EAAS,UAAA,QAAkB,oBAAA;AAAA,MACxB,OAAA,CAAQ,sBAAA"}

package/dist/client.mjs

@@ -0,0 +1,116 @@
+import { formatBaseUnitAmount } from "./format.mjs";
+import { extractDryRunErrors, summarizeDryRun, toJsonValue } from "./dry-run.mjs";
+import { suigar } from "@suigar/sdk";
+import { SuiGrpcClient } from "@mysten/sui/grpc";
+import { isValidSuiAddress, isValidSuiNSName, normalizeStructTag, normalizeSuiAddress, normalizeSuiNSName } from "@mysten/sui/utils";
+//#region src/client.ts
+const DEFAULT_PROVIDER_URLS = {
+	mainnet: "https://fullnode.mainnet.sui.io:443",
+	testnet: "https://fullnode.testnet.sui.io:443"
+};
+const DEFAULT_NETWORK = "testnet";
+const normalizeNetwork = (network = DEFAULT_NETWORK) => {
+	if (network === "mainnet" || network === "testnet") return network;
+	throw new RangeError(`Unsupported network: ${network}. Use "mainnet" or "testnet".`);
+};
+const getProviderUrl = (network, providerUrl) => providerUrl ?? DEFAULT_PROVIDER_URLS[network];
+const createSuigarClient = (input = {}) => {
+	const network = normalizeNetwork(input.network);
+	const baseClient = new SuiGrpcClient({
+		baseUrl: getProviderUrl(network, input.providerUrl),
+		network
+	});
+	const client = baseClient.$extend(suigar({
+		config: input.config,
+		partner: input.partner
+	}));
+	return {
+		client,
+		config: {
+			network,
+			providerUrl: getProviderUrl(network, input.providerUrl),
+			sdk: client.suigar.getConfig()
+		},
+		resolveSuiNSName: async (name) => (await baseClient.nameService.lookupName({ name })).response.record?.targetAddress ?? null
+	};
+};
+const resolveDefaultCoinType = (config, coinType) => normalizeStructTag(coinType ?? config.sdk.coins.sui.coinType);
+const resolveOwnerAddress = async (owner, bundle) => {
+	try {
+		const normalizedAddress = normalizeSuiAddress(owner);
+		if (isValidSuiAddress(normalizedAddress)) return normalizedAddress;
+	} catch {}
+	if (!isValidSuiNSName(owner)) throw new TypeError("owner must be a valid Sui address or SuiNS name such as name.sui or sub.name.sui.");
+	const normalizedName = normalizeSuiNSName(owner, "dot");
+	const resolvedAddress = await bundle.resolveSuiNSName(normalizedName);
+	if (!resolvedAddress) throw new Error(`SuiNS name ${normalizedName} did not resolve to an address.`);
+	return normalizeSuiAddress(resolvedAddress);
+};
+const dryRunTransaction = async (transaction, client) => client.core.simulateTransaction({
+	transaction,
+	include: {
+		effects: true,
+		events: true,
+		balanceChanges: true
+	}
+});
+const summarizeTransaction = (transaction, context = {}) => {
+	const data = transaction.getData();
+	const commands = (data.commands ?? []).map((command) => {
+		const kind = String(command.$kind ?? Object.keys(command)[0] ?? "Unknown");
+		const moveCall = command.MoveCall;
+		const target = moveCall?.package && moveCall?.module && moveCall?.function ? `${moveCall.package}::${moveCall.module}::${moveCall.function}` : void 0;
+		return {
+			kind,
+			...target ? { target } : {},
+			...moveCall?.typeArguments ? { typeArguments: moveCall.typeArguments } : {}
+		};
+	});
+	const objectInputs = (data.inputs ?? []).flatMap((input) => input.$kind === "UnresolvedObject" && input.UnresolvedObject?.objectId ? [input.UnresolvedObject.objectId] : []);
+	return {
+		sender: data.sender ?? null,
+		gasBudget: data.gasData?.budget == null ? null : String(data.gasData.budget),
+		gasBudgetDisplay: data.gasData?.budget == null ? null : formatBaseUnitAmount(data.gasData.budget, context.coinDecimals),
+		gasPrice: data.gasData?.price == null ? null : String(data.gasData.price),
+		commandCount: commands.length,
+		commands,
+		inputs: data.inputs?.length ?? 0,
+		objectInputs,
+		...context.game ? { game: context.game } : {},
+		...context.action ? { action: context.action } : {},
+		...context.coinType ? { coinType: normalizeStructTag(context.coinType) } : {},
+		...context.stake == null ? {} : { stake: String(context.stake) },
+		...context.stakeDisplay ? { stakeDisplay: context.stakeDisplay } : {},
+		...context.coinDecimals == null ? {} : { coinDecimals: context.coinDecimals },
+		...context.gameInputs ? { gameInputs: context.gameInputs } : {}
+	};
+};
+const buildTransactionResult = async ({ mode, transaction, config, client, context }) => {
+	const summary = summarizeTransaction(transaction, context);
+	if (mode === "dry-run") {
+		const rawDryRun = await dryRunTransaction(transaction, client);
+		const dryRun = toJsonValue(rawDryRun);
+		const dryRunSummary = summarizeDryRun(rawDryRun, client, context);
+		const errors = extractDryRunErrors(rawDryRun);
+		return {
+			mode,
+			network: config.network,
+			config,
+			summary,
+			dryRun,
+			dryRunSummary,
+			...errors.length > 0 ? { errors } : {}
+		};
+	}
+	return {
+		mode,
+		network: config.network,
+		config,
+		summary,
+		transactionBytesBase64: await client.suigar.serializeTransactionToBase64(transaction)
+	};
+};
+//#endregion
+export { DEFAULT_NETWORK, buildTransactionResult, createSuigarClient, dryRunTransaction, getProviderUrl, normalizeNetwork, resolveDefaultCoinType, resolveOwnerAddress, summarizeTransaction };
+
+//# sourceMappingURL=client.mjs.map

package/dist/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["// Copyright (c) Suigar\n// SPDX-License-Identifier: Apache-2.0\n\nimport { ClientWithExtensions } from '@mysten/sui/client';\nimport { SuiGrpcClient } from '@mysten/sui/grpc';\nimport type { Transaction } from '@mysten/sui/transactions';\nimport {\n\tisValidSuiAddress,\n\tisValidSuiNSName,\n\tnormalizeStructTag,\n\tnormalizeSuiAddress,\n\tnormalizeSuiNSName,\n} from '@mysten/sui/utils';\nimport { suigar } from '@suigar/sdk';\nimport type { SuigarClient, SuigarNetwork } from '@suigar/sdk';\nimport type { Game, PvPCoinflipAction } from '@suigar/sdk/games';\nimport {\n\textractDryRunErrors,\n\tsummarizeDryRun,\n\ttoJsonValue,\n} from './dry-run.js';\nimport { formatBaseUnitAmount } from './format.js';\nimport type {\n\tBuilderMode,\n\tBuildTransactionResult,\n\tDryRunResult,\n\tJsonValue,\n\tRawDryRunResult,\n\tResolvedMcpConfig,\n\tSuigarConfigOverrides,\n\tSuigarMcpConfigInput,\n\tTransactionSummary,\n} from './types.js';\n\nconst DEFAULT_PROVIDER_URLS = {\n\tmainnet: 'https://fullnode.mainnet.sui.io:443',\n\ttestnet: 'https://fullnode.testnet.sui.io:443',\n} as const satisfies Record<SuigarNetwork, string>;\n\nexport const DEFAULT_NETWORK: SuigarNetwork = 'testnet';\n\nexport const normalizeNetwork = (\n\tnetwork: string | undefined = DEFAULT_NETWORK,\n): SuigarNetwork => {\n\tif (network === 'mainnet' || network === 'testnet') {\n\t\treturn network;\n\t}\n\n\tthrow new RangeError(\n\t\t`Unsupported network: ${network}. Use \"mainnet\" or \"testnet\".`,\n\t);\n};\n\nexport const getProviderUrl = (network: SuigarNetwork, providerUrl?: string) =>\n\tproviderUrl ?? DEFAULT_PROVIDER_URLS[network];\n\nexport type SuigarClientBundle = {\n\tclient: ClientWithExtensions<\n\t\t{\n\t\t\tsuigar: SuigarClient;\n\t\t},\n\t\tSuiGrpcClient\n\t>;\n\tconfig: ResolvedMcpConfig;\n\tresolveSuiNSName(name: string): Promise<string | null>;\n};\n\nexport const createSuigarClient = (\n\tinput: SuigarMcpConfigInput = {},\n): SuigarClientBundle => {\n\tconst network = normalizeNetwork(input.network);\n\tconst baseClient = new SuiGrpcClient({\n\t\tbaseUrl: getProviderUrl(network, input.providerUrl),\n\t\tnetwork,\n\t});\n\tconst client = baseClient.$extend(\n\t\tsuigar({\n\t\t\tconfig: input.config as SuigarConfigOverrides | undefined,\n\t\t\tpartner: input.partner,\n\t\t}),\n\t);\n\n\treturn {\n\t\tclient,\n\t\tconfig: {\n\t\t\tnetwork,\n\t\t\tproviderUrl: getProviderUrl(network, input.providerUrl),\n\t\t\tsdk: client.suigar.getConfig(),\n\t\t} satisfies ResolvedMcpConfig,\n\t\tresolveSuiNSName: async (name) =>\n\t\t\t(\n\t\t\t\tawait baseClient.nameService.lookupName({\n\t\t\t\t\tname,\n\t\t\t\t})\n\t\t\t).response.record?.targetAddress ?? null,\n\t};\n};\n\nexport const resolveDefaultCoinType = (\n\tconfig: ResolvedMcpConfig,\n\tcoinType?: string,\n) => normalizeStructTag(coinType ?? config.sdk.coins.sui.coinType);\n\nexport const resolveOwnerAddress = async (\n\towner: string,\n\tbundle: SuigarClientBundle,\n): Promise<string> => {\n\ttry {\n\t\tconst normalizedAddress = normalizeSuiAddress(owner);\n\t\tif (isValidSuiAddress(normalizedAddress)) {\n\t\t\treturn normalizedAddress;\n\t\t}\n\t} catch {\n\t\t// Fall through to SuiNS validation.\n\t}\n\n\tif (!isValidSuiNSName(owner)) {\n\t\tthrow new TypeError(\n\t\t\t'owner must be a valid Sui address or SuiNS name such as name.sui or sub.name.sui.',\n\t\t);\n\t}\n\n\tconst normalizedName = normalizeSuiNSName(owner, 'dot');\n\tconst resolvedAddress = await bundle.resolveSuiNSName(normalizedName);\n\tif (!resolvedAddress) {\n\t\tthrow new Error(\n\t\t\t`SuiNS name ${normalizedName} did not resolve to an address.`,\n\t\t);\n\t}\n\n\treturn normalizeSuiAddress(resolvedAddress);\n};\n\nexport const dryRunTransaction = async (\n\ttransaction: Transaction,\n\tclient: ReturnType<typeof createSuigarClient>['client'],\n): Promise<RawDryRunResult> =>\n\tclient.core.simulateTransaction({\n\t\ttransaction,\n\t\tinclude: {\n\t\t\teffects: true,\n\t\t\tevents: true,\n\t\t\tbalanceChanges: true,\n\t\t},\n\t});\n\nexport const summarizeTransaction = (\n\ttransaction: Transaction,\n\tcontext: {\n\t\tgame?: Game;\n\t\taction?: PvPCoinflipAction;\n\t\tcoinType?: string;\n\t\tstake?: bigint | number;\n\t\tstakeDisplay?: string;\n\t\tcoinDecimals?: number;\n\t\tgameInputs?: Record<string, JsonValue>;\n\t} = {},\n): TransactionSummary => {\n\tconst data = transaction.getData() as {\n\t\tsender?: string | null;\n\t\tgasData?: {\n\t\t\tbudget?: string | number | bigint | null;\n\t\t\tprice?: string | number | bigint | null;\n\t\t};\n\t\tcommands?: Array<Record<string, unknown> & { $kind?: string }>;\n\t\tinputs?: Array<{\n\t\t\t$kind?: string;\n\t\t\tUnresolvedObject?: { objectId?: string } | null;\n\t\t}>;\n\t};\n\n\tconst commands = (data.commands ?? []).map((command) => {\n\t\tconst kind = String(command.$kind ?? Object.keys(command)[0] ?? 'Unknown');\n\t\tconst moveCall = (\n\t\t\tcommand as {\n\t\t\t\tMoveCall?: {\n\t\t\t\t\tpackage?: string;\n\t\t\t\t\tmodule?: string;\n\t\t\t\t\tfunction?: string;\n\t\t\t\t\ttypeArguments?: string[];\n\t\t\t\t};\n\t\t\t}\n\t\t).MoveCall;\n\t\tconst target =\n\t\t\tmoveCall?.package && moveCall?.module && moveCall?.function\n\t\t\t\t? `${moveCall.package}::${moveCall.module}::${moveCall.function}`\n\t\t\t\t: undefined;\n\t\treturn {\n\t\t\tkind,\n\t\t\t...(target ? { target } : {}),\n\t\t\t...(moveCall?.typeArguments\n\t\t\t\t? { typeArguments: moveCall.typeArguments }\n\t\t\t\t: {}),\n\t\t};\n\t});\n\n\tconst objectInputs = (data.inputs ?? []).flatMap((input) =>\n\t\tinput.$kind === 'UnresolvedObject' && input.UnresolvedObject?.objectId\n\t\t\t? [input.UnresolvedObject.objectId]\n\t\t\t: [],\n\t);\n\n\treturn {\n\t\tsender: data.sender ?? null,\n\t\tgasBudget:\n\t\t\tdata.gasData?.budget == null ? null : String(data.gasData.budget),\n\t\tgasBudgetDisplay:\n\t\t\tdata.gasData?.budget == null\n\t\t\t\t? null\n\t\t\t\t: formatBaseUnitAmount(data.gasData.budget, context.coinDecimals),\n\t\tgasPrice: data.gasData?.price == null ? null : String(data.gasData.price),\n\t\tcommandCount: commands.length,\n\t\tcommands,\n\t\tinputs: data.inputs?.length ?? 0,\n\t\tobjectInputs,\n\t\t...(context.game ? { game: context.game } : {}),\n\t\t...(context.action ? { action: context.action } : {}),\n\t\t...(context.coinType\n\t\t\t? { coinType: normalizeStructTag(context.coinType) }\n\t\t\t: {}),\n\t\t...(context.stake == null ? {} : { stake: String(context.stake) }),\n\t\t...(context.stakeDisplay ? { stakeDisplay: context.stakeDisplay } : {}),\n\t\t...(context.coinDecimals == null\n\t\t\t? {}\n\t\t\t: { coinDecimals: context.coinDecimals }),\n\t\t...(context.gameInputs ? { gameInputs: context.gameInputs } : {}),\n\t};\n};\n\nexport const buildTransactionResult = async ({\n\tmode,\n\ttransaction,\n\tconfig,\n\tclient,\n\tcontext,\n}: {\n\tmode: Exclude<BuilderMode, 'read-only'>;\n\ttransaction: Transaction;\n\tconfig: ResolvedMcpConfig;\n\tclient: ReturnType<typeof createSuigarClient>['client'];\n\tcontext: Parameters<typeof summarizeTransaction>[1];\n}): Promise<BuildTransactionResult> => {\n\tconst summary = summarizeTransaction(transaction, context);\n\tif (mode === 'dry-run') {\n\t\tconst rawDryRun = await dryRunTransaction(transaction, client);\n\t\tconst dryRun = toJsonValue(rawDryRun) as DryRunResult;\n\t\tconst dryRunSummary = summarizeDryRun(rawDryRun, client, context);\n\t\tconst errors = extractDryRunErrors(rawDryRun);\n\t\treturn {\n\t\t\tmode,\n\t\t\tnetwork: config.network,\n\t\t\tconfig,\n\t\t\tsummary,\n\t\t\tdryRun,\n\t\t\tdryRunSummary,\n\t\t\t...(errors.length > 0 ? { errors } : {}),\n\t\t};\n\t}\n\n\treturn {\n\t\tmode,\n\t\tnetwork: config.network,\n\t\tconfig,\n\t\tsummary,\n\t\ttransactionBytesBase64:\n\t\t\tawait client.suigar.serializeTransactionToBase64(transaction),\n\t};\n};\n"],"mappings":"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"}

package/dist/dry-run.mjs

@@ -0,0 +1,163 @@
+import { formatAmount } from "./format.mjs";
+import { GAMES } from "@suigar/sdk/games";
+import { parseGameDetails, parseGameEvent } from "@suigar/sdk/utils";
+//#region src/dry-run.ts
+const amountFieldNames = /* @__PURE__ */ new Set([
+	"stake_amount",
+	"outcome_amount",
+	"payout_amount",
+	"amount"
+]);
+const isRecord = (value) => value !== null && typeof value === "object";
+const getDryRunTransaction = (dryRun) => {
+	if (!isRecord(dryRun)) return;
+	return dryRun.FailedTransaction ?? dryRun.Transaction;
+};
+const toJsonValue = (value) => {
+	if (value == null || typeof value === "string" || typeof value === "boolean") return value ?? null;
+	if (typeof value === "number") return Number.isFinite(value) ? value : String(value);
+	if (typeof value === "bigint") return value.toString();
+	if (value instanceof Uint8Array) return Array.from(value);
+	if (Array.isArray(value)) return value.map((item) => toJsonValue(item)).filter((item) => item !== void 0);
+	if (isRecord(value)) {
+		const entries = Object.entries(value).map(([key, item]) => [key, toJsonValue(item)]).filter((entry) => entry[1] !== void 0);
+		return Object.fromEntries(entries);
+	}
+};
+const collectStrings = (value, path) => {
+	if (!isRecord(value)) return [];
+	return path.flatMap((key) => {
+		const next = value[key];
+		if (typeof next === "string" && next.trim()) return [next.trim()];
+		if (Array.isArray(next)) return next.filter((item) => typeof item === "string");
+		if (isRecord(next)) return collectStrings(next, path);
+		return [];
+	});
+};
+const extractDryRunErrors = (dryRun) => {
+	const source = getDryRunTransaction(dryRun) ?? dryRun;
+	const effects = isRecord(source) ? source.effects : void 0;
+	const errors = [
+		source,
+		effects,
+		isRecord(effects) ? effects.status : void 0
+	].filter(isRecord).flatMap((item) => collectStrings(item, [
+		"error",
+		"cleverError",
+		"message"
+	]));
+	return [...new Set(errors)];
+};
+const stringField = (record, key) => {
+	const value = record[key];
+	return typeof value === "string" || typeof value === "number" || typeof value === "bigint" ? String(value) : void 0;
+};
+const gasUsedSummary = (effects, decimals) => {
+	const gasUsed = isRecord(effects) ? effects.gasUsed : void 0;
+	if (!isRecord(gasUsed)) return {
+		computation: null,
+		storage: null,
+		rebate: null,
+		nonRefundableStorageFee: null,
+		net: null
+	};
+	const computation = stringField(gasUsed, "computationCost");
+	const storage = stringField(gasUsed, "storageCost");
+	const rebate = stringField(gasUsed, "storageRebate");
+	const nonRefundableStorageFee = stringField(gasUsed, "nonRefundableStorageFee");
+	const net = computation && storage && rebate ? String(-(BigInt(computation) + BigInt(storage) - BigInt(rebate))) : void 0;
+	return {
+		computation: formatAmount(computation, decimals),
+		storage: formatAmount(storage, decimals),
+		rebate: formatAmount(rebate, decimals),
+		nonRefundableStorageFee: formatAmount(nonRefundableStorageFee, decimals),
+		net: formatAmount(net, decimals)
+	};
+};
+const eventFields = (fields, decimals) => {
+	const entries = Object.entries(fields).flatMap(([key, value]) => {
+		const jsonValue = toJsonValue(value);
+		if (jsonValue === void 0) return [];
+		const displayValue = amountFieldNames.has(key) ? formatAmount(value, decimals) : null;
+		return displayValue ? [[key, jsonValue], [`${key}_display`, displayValue.display]] : [[key, jsonValue]];
+	});
+	return Object.fromEntries(entries);
+};
+const parseDryRunEvent = (event, eventType) => {
+	const module = typeof event.module === "string" ? event.module : eventType.includes("::core::") ? "core" : eventType.includes("::pvp_coinflip::") ? "pvp_coinflip" : "";
+	if (!module) return null;
+	try {
+		const parsedEvent = parseGameEvent({
+			...event,
+			eventType,
+			module
+		});
+		if (parsedEvent) return parsedEvent;
+	} catch {}
+	const gameId = /::BetResultEvent<[^>]+::([^:<>,]+)::Game>/u.exec(eventType)?.[1]?.replaceAll("_", "-");
+	return gameId && GAMES.includes(gameId) ? {
+		gameId,
+		eventName: "BetResultEvent"
+	} : null;
+};
+const summarizeDryRunEvent = (event, client, decimals) => {
+	if (!isRecord(event)) return null;
+	const eventType = typeof event.eventType === "string" ? event.eventType : typeof event.type === "string" ? event.type : "unknown";
+	const baseSummary = { type: eventType };
+	let parsedEvent = null;
+	try {
+		parsedEvent = parseDryRunEvent(event, eventType);
+		if (parsedEvent && event.bcs instanceof Uint8Array) {
+			const decoded = client.suigar.bcs.BetResultEvent.parse(event.bcs);
+			const details = parseGameDetails(parsedEvent.gameId, decoded.game_details);
+			return {
+				...baseSummary,
+				game: parsedEvent.gameId,
+				eventName: parsedEvent.eventName,
+				fields: eventFields({
+					...decoded,
+					game_details: details,
+					...details
+				}, decimals)
+			};
+		}
+	} catch {}
+	const json = isRecord(event.json) ? event.json : isRecord(event.parsedJson) ? event.parsedJson : null;
+	return json ? {
+		...baseSummary,
+		...parsedEvent ? {
+			game: parsedEvent.gameId,
+			eventName: parsedEvent.eventName
+		} : {},
+		fields: eventFields(json, decimals)
+	} : null;
+};
+const summarizeDryRun = (dryRun, client, context = {}) => {
+	const transaction = getDryRunTransaction(dryRun);
+	const transactionRecord = isRecord(transaction) ? transaction : {};
+	const effects = transactionRecord.effects;
+	const status = isRecord(effects) ? effects.status : void 0;
+	const success = isRecord(status) ? status.success === true : false;
+	const statusError = isRecord(status) ? status.error : void 0;
+	const error = typeof statusError === "string" ? statusError : isRecord(statusError) && typeof statusError.message === "string" ? statusError.message : null;
+	const balanceChanges = Array.isArray(transactionRecord.balanceChanges) ? transactionRecord.balanceChanges.filter(isRecord).map((change) => ({
+		address: String(change.address ?? ""),
+		coinType: String(change.coinType ?? ""),
+		amount: formatAmount(change.amount, context.coinDecimals) ?? {
+			raw: String(change.amount ?? ""),
+			display: ""
+		}
+	})) : [];
+	const events = Array.isArray(transactionRecord.events) ? transactionRecord.events.map((event) => summarizeDryRunEvent(event, client, context.coinDecimals)).filter((event) => event !== null) : [];
+	return {
+		success,
+		error,
+		gasUsed: gasUsedSummary(effects, context.coinDecimals),
+		balanceChanges,
+		events
+	};
+};
+//#endregion
+export { extractDryRunErrors, summarizeDryRun, toJsonValue };
+
+//# sourceMappingURL=dry-run.mjs.map

package/dist/dry-run.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dry-run.mjs","names":[],"sources":["../src/dry-run.ts"],"sourcesContent":["// Copyright (c) Suigar\n// SPDX-License-Identifier: Apache-2.0\n\nimport { GAMES, type Game } from '@suigar/sdk/games';\nimport { parseGameDetails, parseGameEvent } from '@suigar/sdk/utils';\nimport { formatAmount } from './format.js';\nimport type {\n\tDryRunEventSummary,\n\tDryRunSummary,\n\tJsonValue,\n\tRawDryRunResult,\n} from './types.js';\n\ntype DryRunSummaryClient = {\n\tsuigar: {\n\t\tbcs: {\n\t\t\tBetResultEvent: {\n\t\t\t\tparse(value: Uint8Array): Record<string, unknown> & {\n\t\t\t\t\tgame_details: {\n\t\t\t\t\t\tcontents: Array<{\n\t\t\t\t\t\t\tkey: string;\n\t\t\t\t\t\t\tvalue: number[];\n\t\t\t\t\t\t}>;\n\t\t\t\t\t};\n\t\t\t\t};\n\t\t\t};\n\t\t};\n\t};\n};\n\nconst amountFieldNames = new Set([\n\t'stake_amount',\n\t'outcome_amount',\n\t'payout_amount',\n\t'amount',\n]);\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n\tvalue !== null && typeof value === 'object';\n\nconst getDryRunTransaction = (dryRun: RawDryRunResult) => {\n\tif (!isRecord(dryRun)) {\n\t\treturn undefined;\n\t}\n\treturn dryRun.FailedTransaction ?? dryRun.Transaction;\n};\n\nexport const toJsonValue = (value: unknown): JsonValue | undefined => {\n\tif (\n\t\tvalue == null ||\n\t\ttypeof value === 'string' ||\n\t\ttypeof value === 'boolean'\n\t) {\n\t\treturn value ?? null;\n\t}\n\tif (typeof value === 'number') {\n\t\treturn Number.isFinite(value) ? value : String(value);\n\t}\n\tif (typeof value === 'bigint') {\n\t\treturn value.toString();\n\t}\n\tif (value instanceof Uint8Array) {\n\t\treturn Array.from(value);\n\t}\n\tif (Array.isArray(value)) {\n\t\treturn value\n\t\t\t.map((item) => toJsonValue(item))\n\t\t\t.filter((item): item is JsonValue => item !== undefined);\n\t}\n\tif (isRecord(value)) {\n\t\tconst entries = Object.entries(value)\n\t\t\t.map(([key, item]) => [key, toJsonValue(item)] as const)\n\t\t\t.filter(\n\t\t\t\t(entry): entry is readonly [string, JsonValue] =>\n\t\t\t\t\tentry[1] !== undefined,\n\t\t\t);\n\t\treturn Object.fromEntries(entries);\n\t}\n\treturn undefined;\n};\n\nconst collectStrings = (value: unknown, path: string[]): string[] => {\n\tif (!isRecord(value)) {\n\t\treturn [];\n\t}\n\n\treturn path.flatMap((key) => {\n\t\tconst next = value[key];\n\t\tif (typeof next === 'string' && next.trim()) {\n\t\t\treturn [next.trim()];\n\t\t}\n\t\tif (Array.isArray(next)) {\n\t\t\treturn next.filter((item): item is string => typeof item === 'string');\n\t\t}\n\t\tif (isRecord(next)) {\n\t\t\treturn collectStrings(next, path);\n\t\t}\n\t\treturn [];\n\t});\n};\n\nexport const extractDryRunErrors = (dryRun: RawDryRunResult): string[] => {\n\tconst source: unknown = getDryRunTransaction(dryRun) ?? dryRun;\n\tconst effects = isRecord(source) ? source.effects : undefined;\n\tconst status = isRecord(effects) ? effects.status : undefined;\n\tconst errorSources = [source, effects, status].filter(isRecord);\n\n\tconst errors = errorSources.flatMap((item) =>\n\t\tcollectStrings(item, ['error', 'cleverError', 'message']),\n\t);\n\treturn [...new Set(errors)];\n};\n\nconst stringField = (record: Record<string, unknown>, key: string) => {\n\tconst value = record[key];\n\treturn typeof value === 'string' ||\n\t\ttypeof value === 'number' ||\n\t\ttypeof value === 'bigint'\n\t\t? String(value)\n\t\t: undefined;\n};\n\nconst gasUsedSummary = (\n\teffects: unknown,\n\tdecimals?: number,\n): DryRunSummary['gasUsed'] => {\n\tconst gasUsed = isRecord(effects) ? effects.gasUsed : undefined;\n\tif (!isRecord(gasUsed)) {\n\t\treturn {\n\t\t\tcomputation: null,\n\t\t\tstorage: null,\n\t\t\trebate: null,\n\t\t\tnonRefundableStorageFee: null,\n\t\t\tnet: null,\n\t\t};\n\t}\n\n\tconst computation = stringField(gasUsed, 'computationCost');\n\tconst storage = stringField(gasUsed, 'storageCost');\n\tconst rebate = stringField(gasUsed, 'storageRebate');\n\tconst nonRefundableStorageFee = stringField(\n\t\tgasUsed,\n\t\t'nonRefundableStorageFee',\n\t);\n\tconst net =\n\t\tcomputation && storage && rebate\n\t\t\t? String(-(BigInt(computation) + BigInt(storage) - BigInt(rebate)))\n\t\t\t: undefined;\n\n\treturn {\n\t\tcomputation: formatAmount(computation, decimals),\n\t\tstorage: formatAmount(storage, decimals),\n\t\trebate: formatAmount(rebate, decimals),\n\t\tnonRefundableStorageFee: formatAmount(nonRefundableStorageFee, decimals),\n\t\tnet: formatAmount(net, decimals),\n\t};\n};\n\nconst eventFields = (\n\tfields: Record<string, unknown>,\n\tdecimals?: number,\n): Record<string, JsonValue> => {\n\tconst entries = Object.entries(fields).flatMap(([key, value]) => {\n\t\tconst jsonValue = toJsonValue(value);\n\t\tif (jsonValue === undefined) {\n\t\t\treturn [];\n\t\t}\n\t\tconst displayValue = amountFieldNames.has(key)\n\t\t\t? formatAmount(value, decimals)\n\t\t\t: null;\n\t\treturn displayValue\n\t\t\t? [\n\t\t\t\t\t[key, jsonValue] as const,\n\t\t\t\t\t[`${key}_display`, displayValue.display] as const,\n\t\t\t\t]\n\t\t\t: [[key, jsonValue] as const];\n\t});\n\treturn Object.fromEntries(entries);\n};\n\nconst parseDryRunEvent = (\n\tevent: Record<string, unknown>,\n\teventType: string,\n): ReturnType<typeof parseGameEvent> => {\n\tconst module =\n\t\ttypeof event.module === 'string'\n\t\t\t? event.module\n\t\t\t: eventType.includes('::core::')\n\t\t\t\t? 'core'\n\t\t\t\t: eventType.includes('::pvp_coinflip::')\n\t\t\t\t\t? 'pvp_coinflip'\n\t\t\t\t\t: '';\n\n\tif (!module) {\n\t\treturn null;\n\t}\n\n\ttry {\n\t\tconst parsedEvent = parseGameEvent({\n\t\t\t...event,\n\t\t\teventType,\n\t\t\tmodule,\n\t\t} as never);\n\t\tif (parsedEvent) {\n\t\t\treturn parsedEvent;\n\t\t}\n\t} catch {\n\t\t// Fall back to string matching below for JSON-only simulated events.\n\t}\n\n\tconst standardBetResult = /::BetResultEvent<[^>]+::([^:<>,]+)::Game>/u.exec(\n\t\teventType,\n\t);\n\tconst gameId = standardBetResult?.[1]?.replaceAll('_', '-');\n\treturn gameId && GAMES.includes(gameId as Game)\n\t\t? {\n\t\t\t\tgameId: gameId as Game,\n\t\t\t\teventName: 'BetResultEvent',\n\t\t\t}\n\t\t: null;\n};\n\nconst summarizeDryRunEvent = (\n\tevent: unknown,\n\tclient: DryRunSummaryClient,\n\tdecimals?: number,\n): DryRunEventSummary | null => {\n\tif (!isRecord(event)) {\n\t\treturn null;\n\t}\n\n\tconst eventType =\n\t\ttypeof event.eventType === 'string'\n\t\t\t? event.eventType\n\t\t\t: typeof event.type === 'string'\n\t\t\t\t? event.type\n\t\t\t\t: 'unknown';\n\tconst baseSummary = {\n\t\ttype: eventType,\n\t};\n\tlet parsedEvent: ReturnType<typeof parseGameEvent> = null;\n\n\ttry {\n\t\tparsedEvent = parseDryRunEvent(event, eventType);\n\t\tif (parsedEvent && event.bcs instanceof Uint8Array) {\n\t\t\tconst decoded = client.suigar.bcs.BetResultEvent.parse(event.bcs);\n\t\t\tconst details = parseGameDetails(\n\t\t\t\tparsedEvent.gameId,\n\t\t\t\tdecoded.game_details,\n\t\t\t);\n\t\t\treturn {\n\t\t\t\t...baseSummary,\n\t\t\t\tgame: parsedEvent.gameId,\n\t\t\t\teventName: parsedEvent.eventName,\n\t\t\t\tfields: eventFields(\n\t\t\t\t\t{\n\t\t\t\t\t\t...decoded,\n\t\t\t\t\t\tgame_details: details,\n\t\t\t\t\t\t...details,\n\t\t\t\t\t},\n\t\t\t\t\tdecimals,\n\t\t\t\t),\n\t\t\t};\n\t\t}\n\t} catch {\n\t\t// Fall back to API-provided JSON below.\n\t}\n\n\tconst json = isRecord(event.json)\n\t\t? event.json\n\t\t: isRecord(event.parsedJson)\n\t\t\t? event.parsedJson\n\t\t\t: null;\n\treturn json\n\t\t? {\n\t\t\t\t...baseSummary,\n\t\t\t\t...(parsedEvent\n\t\t\t\t\t? {\n\t\t\t\t\t\t\tgame: parsedEvent.gameId,\n\t\t\t\t\t\t\teventName: parsedEvent.eventName,\n\t\t\t\t\t\t}\n\t\t\t\t\t: {}),\n\t\t\t\tfields: eventFields(json, decimals),\n\t\t\t}\n\t\t: null;\n};\n\nexport const summarizeDryRun = (\n\tdryRun: RawDryRunResult,\n\tclient: DryRunSummaryClient,\n\tcontext: { coinDecimals?: number } = {},\n): DryRunSummary => {\n\tconst transaction = getDryRunTransaction(dryRun);\n\tconst transactionRecord: Record<string, unknown> = isRecord(transaction)\n\t\t? transaction\n\t\t: {};\n\tconst effects = transactionRecord.effects;\n\tconst status = isRecord(effects) ? effects.status : undefined;\n\tconst success = isRecord(status) ? status.success === true : false;\n\tconst statusError = isRecord(status) ? status.error : undefined;\n\tconst error =\n\t\ttypeof statusError === 'string'\n\t\t\t? statusError\n\t\t\t: isRecord(statusError) && typeof statusError.message === 'string'\n\t\t\t\t? statusError.message\n\t\t\t\t: null;\n\tconst balanceChanges = Array.isArray(transactionRecord.balanceChanges)\n\t\t? transactionRecord.balanceChanges.filter(isRecord).map((change) => ({\n\t\t\t\taddress: String(change.address ?? ''),\n\t\t\t\tcoinType: String(change.coinType ?? ''),\n\t\t\t\tamount:\n\t\t\t\t\tformatAmount(change.amount, context.coinDecimals) ??\n\t\t\t\t\t({ raw: String(change.amount ?? ''), display: '' } as const),\n\t\t\t}))\n\t\t: [];\n\tconst events = Array.isArray(transactionRecord.events)\n\t\t? transactionRecord.events\n\t\t\t\t.map((event) =>\n\t\t\t\t\tsummarizeDryRunEvent(event, client, context.coinDecimals),\n\t\t\t\t)\n\t\t\t\t.filter((event): event is DryRunEventSummary => event !== null)\n\t\t: [];\n\n\treturn {\n\t\tsuccess,\n\t\terror,\n\t\tgasUsed: gasUsedSummary(effects, context.coinDecimals),\n\t\tbalanceChanges,\n\t\tevents,\n\t};\n};\n"],"mappings":"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"}

package/dist/format.mjs

@@ -0,0 +1,24 @@
+//#region src/format.ts
+const formatBaseUnitAmount = (value, decimals = 9) => {
+	const raw = String(value);
+	const negative = raw.startsWith("-");
+	const digits = negative ? raw.slice(1) : raw;
+	if (!/^\d+$/u.test(digits)) return raw;
+	if (decimals === 0) return `${negative ? "-" : ""}${digits}`;
+	const padded = digits.length <= decimals ? digits.padStart(decimals + 1, "0") : digits;
+	const whole = padded.slice(0, -decimals) || "0";
+	const fraction = padded.slice(-decimals).replace(/0+$/u, "");
+	return `${negative ? "-" : ""}${whole}${fraction ? `.${fraction}` : ""}`;
+};
+const formatAmount = (value, decimals) => {
+	if (typeof value !== "string" && typeof value !== "number" && typeof value !== "bigint") return null;
+	const raw = String(value);
+	return {
+		raw,
+		display: formatBaseUnitAmount(raw, decimals)
+	};
+};
+//#endregion
+export { formatAmount, formatBaseUnitAmount };
+
+//# sourceMappingURL=format.mjs.map

package/dist/format.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.mjs","names":[],"sources":["../src/format.ts"],"sourcesContent":["// Copyright (c) Suigar\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { FormattedAmount } from './types.js';\n\nexport const formatBaseUnitAmount = (\n\tvalue: string | number | bigint,\n\tdecimals = 9,\n): string => {\n\tconst raw = String(value);\n\tconst negative = raw.startsWith('-');\n\tconst digits = negative ? raw.slice(1) : raw;\n\tif (!/^\\d+$/u.test(digits)) {\n\t\treturn raw;\n\t}\n\tif (decimals === 0) {\n\t\treturn `${negative ? '-' : ''}${digits}`;\n\t}\n\n\tconst padded =\n\t\tdigits.length <= decimals ? digits.padStart(decimals + 1, '0') : digits;\n\tconst whole = padded.slice(0, -decimals) || '0';\n\tconst fraction = padded.slice(-decimals).replace(/0+$/u, '');\n\treturn `${negative ? '-' : ''}${whole}${fraction ? `.${fraction}` : ''}`;\n};\n\nexport const formatAmount = (\n\tvalue: unknown,\n\tdecimals?: number,\n): FormattedAmount | null => {\n\tif (\n\t\ttypeof value !== 'string' &&\n\t\ttypeof value !== 'number' &&\n\t\ttypeof value !== 'bigint'\n\t) {\n\t\treturn null;\n\t}\n\tconst raw = String(value);\n\treturn {\n\t\traw,\n\t\tdisplay: formatBaseUnitAmount(raw, decimals),\n\t};\n};\n"],"mappings":";AAKA,MAAa,wBACZ,OACA,WAAW,MACC;CACZ,MAAM,MAAM,OAAO,KAAK;CACxB,MAAM,WAAW,IAAI,WAAW,GAAG;CACnC,MAAM,SAAS,WAAW,IAAI,MAAM,CAAC,IAAI;CACzC,IAAI,CAAC,SAAS,KAAK,MAAM,GACxB,OAAO;CAER,IAAI,aAAa,GAChB,OAAO,GAAG,WAAW,MAAM,KAAK;CAGjC,MAAM,SACL,OAAO,UAAU,WAAW,OAAO,SAAS,WAAW,GAAG,GAAG,IAAI;CAClE,MAAM,QAAQ,OAAO,MAAM,GAAG,CAAC,QAAQ,KAAK;CAC5C,MAAM,WAAW,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,QAAQ,EAAE;CAC3D,OAAO,GAAG,WAAW,MAAM,KAAK,QAAQ,WAAW,IAAI,aAAa;AACrE;AAEA,MAAa,gBACZ,OACA,aAC4B;CAC5B,IACC,OAAO,UAAU,YACjB,OAAO,UAAU,YACjB,OAAO,UAAU,UAEjB,OAAO;CAER,MAAM,MAAM,OAAO,KAAK;CACxB,OAAO;EACN;EACA,SAAS,qBAAqB,KAAK,QAAQ;CAC5C;AACD"}