project-cpu-mcp 0.7.1

package/dist/tools/transport/quote/quote-transport.js

@@ -0,0 +1,19 @@
+import { summarizeQuote } from '../format.utils.js';
+import { transportInputSchema } from '../types.js';
+import { QUOTE_TRANSPORT_DESCRIPTION } from './constants.js';
+export function registerQuoteTransportTool(server, context) {
+    server.registerTool('cpu_quote_transport', { description: QUOTE_TRANSPORT_DESCRIPTION, inputSchema: transportInputSchema }, async (args) => {
+        const quote = await context.transport.quote({
+            path: args.path,
+            resourceId: args.resourceId,
+            amount: args.amount,
+        });
+        return {
+            content: [
+                { type: 'text', text: summarizeQuote(quote) },
+                { type: 'text', text: JSON.stringify(quote) },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=quote-transport.js.map

package/dist/tools/transport/quote/quote-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-transport.js","sourceRoot":"","sources":["../../../../src/tools/transport/quote/quote-transport.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAE7D,MAAM,UAAU,0BAA0B,CAAC,MAAqB,EAAE,OAAmB;IACjF,MAAM,CAAC,YAAY,CACf,qBAAqB,EACrB,EAAE,WAAW,EAAE,2BAA2B,EAAE,WAAW,EAAE,oBAAoB,EAAE,EAC/E,KAAK,EAAE,IAAI,EAAE,EAAE;QACX,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC;YACxC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;SACtB,CAAC,CAAC;QAEH,OAAO;YACH,OAAO,EAAE;gBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE;gBAC7C,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;aAChD;SACJ,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/transport/transport.d.ts

@@ -0,0 +1,4 @@
+import type { AppContext } from '../../types.js';
+import type { ToolRegistrar } from '../types.js';
+export declare function registerTransportTool(server: ToolRegistrar, context: AppContext): void;
+//# sourceMappingURL=transport.d.ts.map

package/dist/tools/transport/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/tools/transport/transport.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAqBtF"}

package/dist/tools/transport/transport.js

@@ -0,0 +1,20 @@
+import { TRANSPORT_DESCRIPTION } from './constants.js';
+import { summarizeTransport } from './format.utils.js';
+import { transportInputSchema } from './types.js';
+export function registerTransportTool(server, context) {
+    server.registerTool('cpu_transport', { description: TRANSPORT_DESCRIPTION, inputSchema: transportInputSchema }, async (args) => {
+        const result = await context.transport.transport({
+            path: args.path,
+            resourceId: args.resourceId,
+            amount: args.amount,
+        });
+        const { resources } = await context.appConfig.load();
+        return {
+            content: [
+                { type: 'text', text: summarizeTransport(result, resources) },
+                { type: 'text', text: JSON.stringify(result) },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=transport.js.map

package/dist/tools/transport/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/tools/transport/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIlD,MAAM,UAAU,qBAAqB,CAAC,MAAqB,EAAE,OAAmB;IAC5E,MAAM,CAAC,YAAY,CACf,eAAe,EACf,EAAE,WAAW,EAAE,qBAAqB,EAAE,WAAW,EAAE,oBAAoB,EAAE,EACzE,KAAK,EAAE,IAAI,EAAE,EAAE;QACX,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC;YAC7C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;SACtB,CAAC,CAAC;QAEH,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAErD,OAAO;YACH,OAAO,EAAE;gBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE;gBAC7D,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE;aACjD;SACJ,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/transport/types.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import { DeliveryFilter } from '../../services/types.js';
+export declare const transportInputSchema: {
+    path: z.ZodArray<z.ZodNumber, "many">;
+    resourceId: z.ZodNumber;
+    amount: z.ZodString;
+};
+export declare const routeNetworkInputSchema: {
+    resourceId: z.ZodNumber;
+    from: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    towards: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+};
+export declare const nextHopsInputSchema: {
+    from: z.ZodNumber;
+    resourceId: z.ZodNumber;
+    towards: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+};
+export declare const getTransportStatusInputSchema: {
+    deliveryId: z.ZodString;
+};
+export declare const listMyTransportsInputSchema: {
+    filter: z.ZodDefault<z.ZodNativeEnum<typeof DeliveryFilter>>;
+};
+export declare const finalizeDeliveryInputSchema: {
+    ids: z.ZodArray<z.ZodString, "many">;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/transport/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/transport/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,eAAO,MAAM,oBAAoB;;;;CAehC,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;CAanC,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;CAU/B,CAAC;AAEF,eAAO,MAAM,6BAA6B;;CAEzC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;CAKvC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;CAKvC,CAAC"}

package/dist/tools/transport/types.js

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+import { tokenIdSchema } from '../../geometry/types.js';
+import { DeliveryFilter } from '../../services/types.js';
+export const transportInputSchema = {
+    path: z
+        .array(tokenIdSchema)
+        .min(2)
+        .describe('Waypoint chain of cell tokenIds [source, ...intermediate, target]. Every waypoint must be revealed ' +
+        'and eligible (your own cell, or a Hub); each hop must span at most radius(from)+radius(to)−1 grid ' +
+        'steps (a plain cell reaches moveRadius, a Hub hubRadius — see get_game_config transport). ' +
+        'Scout legal hops with cpu_next_hops and chain them yourself; the Transport contract validates.'),
+    resourceId: z.number().int().describe('Resource type id to move (must have a balance at the source cell).'),
+    amount: z
+        .string()
+        .regex(/^[1-9]\d*$/)
+        .describe('Units to move, as a positive integer string (matches on-map resource balances).'),
+};
+export const routeNetworkInputSchema = {
+    resourceId: z
+        .number()
+        .int()
+        .describe('The cargo resource id — every foreign-hub waypoint shows its exact per-unit transit fee for it.'),
+    from: tokenIdSchema
+        .nullable()
+        .default(null)
+        .describe('Optional source cell — annotates every waypoint with its grid distance from here.'),
+    towards: tokenIdSchema
+        .nullable()
+        .default(null)
+        .describe('Optional destination cell — annotates every waypoint with its remaining grid distance.'),
+};
+export const nextHopsInputSchema = {
+    from: tokenIdSchema.describe('The cell to hop from (your revealed cell, or a Hub).'),
+    resourceId: z
+        .number()
+        .int()
+        .describe('The cargo resource id — each candidate hub shows its exact per-unit transit fee for it.'),
+    towards: tokenIdSchema
+        .nullable()
+        .default(null)
+        .describe('Optional destination — adds the remaining grid distance to it for each candidate (a compass).'),
+};
+export const getTransportStatusInputSchema = {
+    deliveryId: z.string().describe('The on-chain delivery id (from `transport` or `list_my_transports`).'),
+};
+export const listMyTransportsInputSchema = {
+    filter: z
+        .nativeEnum(DeliveryFilter)
+        .default(DeliveryFilter.All)
+        .describe('Filter your deliveries: all, in_transit, delivered, ready_to_finalize.'),
+};
+export const finalizeDeliveryInputSchema = {
+    ids: z
+        .array(z.string())
+        .min(1)
+        .describe('On-chain delivery ids to finalize (arrived deliveries, from `list_my_transports`).'),
+};
+//# sourceMappingURL=types.js.map

package/dist/tools/transport/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/transport/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAChC,IAAI,EAAE,CAAC;SACF,KAAK,CAAC,aAAa,CAAC;SACpB,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACL,qGAAqG;QACjG,oGAAoG;QACpG,4FAA4F;QAC5F,gGAAgG,CACvG;IACL,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;IAC3G,MAAM,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,KAAK,CAAC,YAAY,CAAC;SACnB,QAAQ,CAAC,iFAAiF,CAAC;CACnG,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACnC,UAAU,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,CAAC,iGAAiG,CAAC;IAChH,IAAI,EAAE,aAAa;SACd,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,mFAAmF,CAAC;IAClG,OAAO,EAAE,aAAa;SACjB,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,wFAAwF,CAAC;CAC1G,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAC/B,IAAI,EAAE,aAAa,CAAC,QAAQ,CAAC,sDAAsD,CAAC;IACpF,UAAU,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,CAAC,yFAAyF,CAAC;IACxG,OAAO,EAAE,aAAa;SACjB,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,+FAA+F,CAAC;CACjH,CAAC;AAEF,MAAM,CAAC,MAAM,6BAA6B,GAAG;IACzC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sEAAsE,CAAC;CAC1G,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACvC,MAAM,EAAE,CAAC;SACJ,UAAU,CAAC,cAAc,CAAC;SAC1B,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC;SAC3B,QAAQ,CAAC,wEAAwE,CAAC;CAC1F,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACvC,GAAG,EAAE,CAAC;SACD,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,oFAAoF,CAAC;CACtG,CAAC"}

package/dist/tools/types.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export type ToolRegistrar = Pick<McpServer, 'registerTool'>;
+export type ToolHandler<TArgs extends Array<unknown> = Array<unknown>> = (...args: TArgs) => CallToolResult | Promise<CallToolResult>;
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AAE5D,MAAM,MAAM,WAAW,CAAC,KAAK,SAAS,KAAK,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CACrE,GAAG,IAAI,EAAE,KAAK,KACb,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC"}

package/dist/tools/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":""}

package/dist/tools/withdraw/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const WITHDRAW_MAX_UNITS: bigint;
+export declare const WITHDRAW_DESCRIPTION: string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/tools/withdraw/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tools/withdraw/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,QAAiB,CAAC;AAEjD,eAAO,MAAM,oBAAoB,QAQtB,CAAC"}

package/dist/tools/withdraw/constants.js

@@ -0,0 +1,11 @@
+export const WITHDRAW_MAX_UNITS = 2n ** 64n - 1n;
+export const WITHDRAW_DESCRIPTION = [
+    'Cash out a cell’s wCPU (resource id 1, the CPU Forge output) to the on-chain $CPU token in your wallet, 1:1',
+    '(needs a session — `cpu_authenticate` first; you must own the cell). Pass the amount in whole wCPU units up',
+    'to the cell’s wCPU balance; it debits the cell and mints $CPU to your wallet (no approve needed). If the',
+    'on-chain $CPU emission budget cannot cover the full amount, only a partial tranche executes — up to what',
+    'remains — and the rest stays in the cell; the result reports the requested and executed amounts separately.',
+    'Waits for confirmation and returns the tx hash — check the result with `cpu_get_balance`. wCPU lives on the',
+    'cell, so selling or transferring the cell takes it along: withdraw before you sell.',
+].join(' ');
+//# sourceMappingURL=constants.js.map

package/dist/tools/withdraw/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/tools/withdraw/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,IAAI,GAAG,GAAG,EAAE,CAAC;AAEjD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAChC,6GAA6G;IAC7G,6GAA6G;IAC7G,0GAA0G;IAC1G,0GAA0G;IAC1G,6GAA6G;IAC7G,6GAA6G;IAC7G,qFAAqF;CACxF,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/tools/withdraw/types.d.ts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+export declare const withdrawInputSchema: {
+    tokenId: z.ZodEffects<z.ZodNumber, string, number>;
+    amount: z.ZodEffects<z.ZodString, string, string>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/withdraw/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/withdraw/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,mBAAmB;;;CAa/B,CAAC"}

package/dist/tools/withdraw/types.js

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+import { WITHDRAW_MAX_UNITS } from './constants.js';
+import { tokenIdSchema } from '../../geometry/types.js';
+export const withdrawInputSchema = {
+    tokenId: tokenIdSchema.transform(String).describe('The tokenId of a cell you own holding wCPU to cash out.'),
+    amount: z
+        .string()
+        .regex(/^\d+$/, 'amount must be a whole number of wCPU units (e.g. "100")')
+        .refine((v) => {
+        const units = BigInt(v);
+        return units > 0n && units <= WITHDRAW_MAX_UNITS;
+    }, `amount must be greater than 0 and at most ${WITHDRAW_MAX_UNITS.toString()}`)
+        .describe('How much wCPU (resource id 1) to convert to on-chain $CPU, 1:1, in whole units (e.g. "100"). ' +
+        'Must be greater than 0 and at most the cell’s wCPU balance. See it with get_cell.'),
+};
+//# sourceMappingURL=types.js.map

package/dist/tools/withdraw/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/withdraw/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAC/B,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,yDAAyD,CAAC;IAC5G,MAAM,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,KAAK,CAAC,OAAO,EAAE,0DAA0D,CAAC;SAC1E,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACV,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACxB,OAAO,KAAK,GAAG,EAAE,IAAI,KAAK,IAAI,kBAAkB,CAAC;IACrD,CAAC,EAAE,6CAA6C,kBAAkB,CAAC,QAAQ,EAAE,EAAE,CAAC;SAC/E,QAAQ,CACL,+FAA+F;QAC3F,mFAAmF,CAC1F;CACR,CAAC"}

package/dist/tools/withdraw/withdraw.d.ts

@@ -0,0 +1,4 @@
+import type { AppContext } from '../../types.js';
+import type { ToolRegistrar } from '../types.js';
+export declare function registerWithdrawTool(server: ToolRegistrar, context: AppContext): void;
+//# sourceMappingURL=withdraw.d.ts.map

package/dist/tools/withdraw/withdraw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withdraw.d.ts","sourceRoot":"","sources":["../../../src/tools/withdraw/withdraw.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAuBrF"}

package/dist/tools/withdraw/withdraw.js

@@ -0,0 +1,21 @@
+import { WITHDRAW_DESCRIPTION } from './constants.js';
+import { withdrawInputSchema } from './types.js';
+export function registerWithdrawTool(server, context) {
+    server.registerTool('cpu_withdraw', { description: WITHDRAW_DESCRIPTION, inputSchema: withdrawInputSchema }, async (args) => {
+        const result = await context.withdraw.withdraw({ tokenId: args.tokenId, amount: args.amount });
+        const remainder = (BigInt(result.requested) - BigInt(result.executed)).toString();
+        const header = result.partial
+            ? `Withdrew from cell ${result.tokenId}: requested ${result.requested} but the $CPU emission budget ` +
+                `capped it — minted ${result.executed} $CPU to your wallet, ${remainder} wCPU stays in the cell. ` +
+                `Withdraw tx ${result.txHash} confirmed in block ${result.blockNumber}. Check it with get_balance.`
+            : `Withdrew from cell ${result.tokenId}: minted ${result.executed} $CPU to your wallet — withdraw tx ` +
+                `${result.txHash} confirmed in block ${result.blockNumber}. Check it with get_balance.`;
+        return {
+            content: [
+                { type: 'text', text: header },
+                { type: 'text', text: JSON.stringify(result) },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=withdraw.js.map

package/dist/tools/withdraw/withdraw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withdraw.js","sourceRoot":"","sources":["../../../src/tools/withdraw/withdraw.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAIjD,MAAM,UAAU,oBAAoB,CAAC,MAAqB,EAAE,OAAmB;IAC3E,MAAM,CAAC,YAAY,CACf,cAAc,EACd,EAAE,WAAW,EAAE,oBAAoB,EAAE,WAAW,EAAE,mBAAmB,EAAE,EACvE,KAAK,EAAE,IAAI,EAAE,EAAE;QACX,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAE/F,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAClF,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO;YACzB,CAAC,CAAC,sBAAsB,MAAM,CAAC,OAAO,eAAe,MAAM,CAAC,SAAS,gCAAgC;gBACnG,sBAAsB,MAAM,CAAC,QAAQ,yBAAyB,SAAS,2BAA2B;gBAClG,eAAe,MAAM,CAAC,MAAM,uBAAuB,MAAM,CAAC,WAAW,8BAA8B;YACrG,CAAC,CAAC,sBAAsB,MAAM,CAAC,OAAO,YAAY,MAAM,CAAC,QAAQ,qCAAqC;gBACpG,GAAG,MAAM,CAAC,MAAM,uBAAuB,MAAM,CAAC,WAAW,8BAA8B,CAAC;QAE9F,OAAO;YACH,OAAO,EAAE;gBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;gBAC9B,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE;aACjD;SACJ,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,54 @@
+import type { ApiClient } from './api/client.js';
+import type { EnvConfig } from './config/types.js';
+import type { ILogger } from './logger/types.js';
+import type { MapReader } from './map/reader.js';
+import type { MapSync } from './map/sync.js';
+import type { AppConfigService } from './services/app-config.service.js';
+import type { AuthService } from './services/auth.service.js';
+import type { BalanceService } from './services/balance.service.js';
+import type { BuildService } from './services/build.service.js';
+import type { CraftService } from './services/craft.service.js';
+import type { MiningService } from './services/mining.service.js';
+import type { MintService } from './services/mint.service.js';
+import type { RevealFulfilmentService } from './services/reveal-fulfilment.service.js';
+import type { RevealService } from './services/reveal.service.js';
+import type { RouteService } from './services/route.service.js';
+import type { SwapService } from './services/swap.service.js';
+import type { SyndicateService } from './services/syndicate.service.js';
+import type { TradeService } from './services/trade.service.js';
+import type { TransportService } from './services/transport.service.js';
+import type { WithdrawService } from './services/withdraw.service.js';
+import type { SessionManager } from './session/manager.js';
+import type { IBackendVersionSignal, IPackageVersionSignal } from './version/types.js';
+import type { WalletProvider } from './wallet/types.js';
+export declare enum WalletMode {
+    EVM = "evm",
+    AGW = "agw"
+}
+export interface AppContext {
+    config: EnvConfig;
+    session: SessionManager;
+    wallet: WalletProvider;
+    api: ApiClient;
+    auth: AuthService;
+    appConfig: AppConfigService;
+    reveal: RevealService;
+    revealFulfilment: RevealFulfilmentService;
+    build: BuildService;
+    craft: CraftService;
+    mining: MiningService;
+    transport: TransportService;
+    route: RouteService;
+    trade: TradeService;
+    syndicate: SyndicateService;
+    swap: SwapService;
+    mint: MintService;
+    balance: BalanceService;
+    withdraw: WithdrawService;
+    mapSync: MapSync;
+    mapReader: MapReader;
+    backendVersion: IBackendVersionSignal;
+    packageVersion: IPackageVersionSignal;
+    logger: ILogger;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,oBAAY,UAAU;IAClB,GAAG,QAAQ;IACX,GAAG,QAAQ;CACd;AAED,MAAM,WAAW,UAAU;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,EAAE,SAAS,CAAC;IACf,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,gBAAgB,EAAE,uBAAuB,CAAC;IAC1C,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,cAAc,EAAE,qBAAqB,CAAC;IACtC,cAAc,EAAE,qBAAqB,CAAC;IACtC,MAAM,EAAE,OAAO,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,6 @@
+export var WalletMode;
+(function (WalletMode) {
+    WalletMode["EVM"] = "evm";
+    WalletMode["AGW"] = "agw";
+})(WalletMode || (WalletMode = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAwBA,MAAM,CAAN,IAAY,UAGX;AAHD,WAAY,UAAU;IAClB,yBAAW,CAAA;IACX,yBAAW,CAAA;AACf,CAAC,EAHW,UAAU,KAAV,UAAU,QAGrB"}

package/dist/utils/async.utils.d.ts

@@ -0,0 +1,2 @@
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=async.utils.d.ts.map

package/dist/utils/async.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.utils.d.ts","sourceRoot":"","sources":["../../src/utils/async.utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/utils/async.utils.js

@@ -0,0 +1,4 @@
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=async.utils.js.map

package/dist/utils/async.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.utils.js","sourceRoot":"","sources":["../../src/utils/async.utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,KAAK,CAAC,EAAU;IAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/utils/error.utils.d.ts

@@ -0,0 +1,2 @@
+export declare function errorMessage(error: unknown): string;
+//# sourceMappingURL=error.utils.d.ts.map

package/dist/utils/error.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.utils.d.ts","sourceRoot":"","sources":["../../src/utils/error.utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD"}

package/dist/utils/error.utils.js

@@ -0,0 +1,4 @@
+export function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=error.utils.js.map

package/dist/utils/error.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.utils.js","sourceRoot":"","sources":["../../src/utils/error.utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAC,KAAc;IACvC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC"}

package/dist/utils/format.utils.d.ts

@@ -0,0 +1,20 @@
+/** Resource id → name map, as served by `GET /api/v1/config` and held in the loaded chain config. */
+export type ResourceNames = Record<number, string>;
+/** Plain display name for a resource id, falling back to `#3` when unknown. For id-adjacent labels. */
+export declare function resourceName(resources: ResourceNames, id: number): string;
+/** Human label for a resource id, e.g. `Iron (#5)`, falling back to `resource #5` when unknown. */
+export declare function resourceLabel(resources: ResourceNames, id: number): string;
+/** Renders a list of resource stacks like `3 Steel (#102), 2 Concrete (#101)` — the amount+label rendering
+ *  repeated across tool output (recipes, claim outputs, demolish cost). Amount is number or string. */
+export declare function formatStacks(resources: ResourceNames, stacks: Array<{
+    resourceId: number;
+    amount: number | string;
+}>, separator?: string): string;
+/** On-chain $CPU amounts are wei; render them human-readable. */
+export declare function cpuFromWei(wei: string): string;
+export declare function percentToBp(percent: number): number;
+export declare function bpToPercent(bp: number): number;
+export declare function saleFeeOverridesToPercent(overrides: Record<number, number> | null): Record<number, number> | null;
+export declare function formatUnixSeconds(seconds: number): string;
+export declare function summarizeTransit(transitPaid: string, transitDiscount: string): string;
+//# sourceMappingURL=format.utils.d.ts.map

package/dist/utils/format.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.utils.d.ts","sourceRoot":"","sources":["../../src/utils/format.utils.ts"],"names":[],"mappings":"AAEA,qGAAqG;AACrG,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEnD,uGAAuG;AACvG,wBAAgB,YAAY,CAAC,SAAS,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,mGAAmG;AACnG,wBAAgB,aAAa,CAAC,SAAS,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAG1E;AAED;uGACuG;AACvG,wBAAgB,YAAY,CACxB,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC,EAC9D,SAAS,SAAO,GACjB,MAAM,CAER;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAKD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOnD;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CASjH;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAGrF"}

package/dist/utils/format.utils.js

@@ -0,0 +1,50 @@
+import { formatEther } from 'viem';
+/** Plain display name for a resource id, falling back to `#3` when unknown. For id-adjacent labels. */
+export function resourceName(resources, id) {
+    return resources[id] ?? `#${id}`;
+}
+/** Human label for a resource id, e.g. `Iron (#5)`, falling back to `resource #5` when unknown. */
+export function resourceLabel(resources, id) {
+    const name = resources[id];
+    return name !== undefined ? `${name} (#${id})` : `resource #${id}`;
+}
+/** Renders a list of resource stacks like `3 Steel (#102), 2 Concrete (#101)` — the amount+label rendering
+ *  repeated across tool output (recipes, claim outputs, demolish cost). Amount is number or string. */
+export function formatStacks(resources, stacks, separator = ', ') {
+    return stacks.map((s) => `${s.amount} ${resourceLabel(resources, s.resourceId)}`).join(separator);
+}
+/** On-chain $CPU amounts are wei; render them human-readable. */
+export function cpuFromWei(wei) {
+    return formatEther(BigInt(wei));
+}
+const BP_PER_PERCENT = 100;
+const BP_EPSILON = 1e-6;
+export function percentToBp(percent) {
+    const scaled = percent * BP_PER_PERCENT;
+    const bp = Math.round(scaled);
+    if (Math.abs(scaled - bp) > BP_EPSILON) {
+        throw new Error(`Rate ${percent}% is finer than 0.01% (one basis point); use a rate on a whole basis point.`);
+    }
+    return bp;
+}
+export function bpToPercent(bp) {
+    return bp / BP_PER_PERCENT;
+}
+export function saleFeeOverridesToPercent(overrides) {
+    if (overrides === null) {
+        return null;
+    }
+    const out = {};
+    for (const [resourceId, bp] of Object.entries(overrides)) {
+        out[Number(resourceId)] = bpToPercent(bp);
+    }
+    return out;
+}
+export function formatUnixSeconds(seconds) {
+    return `${new Date(seconds * 1000).toISOString().slice(0, 19).replace('T', ' ')} UTC`;
+}
+export function summarizeTransit(transitPaid, transitDiscount) {
+    const saved = transitDiscount === '0' ? '' : ` (saved ${transitDiscount} $CPU via syndicate)`;
+    return `${transitPaid} $CPU${saved}`;
+}
+//# sourceMappingURL=format.utils.js.map

package/dist/utils/format.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.utils.js","sourceRoot":"","sources":["../../src/utils/format.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAKnC,uGAAuG;AACvG,MAAM,UAAU,YAAY,CAAC,SAAwB,EAAE,EAAU;IAC7D,OAAO,SAAS,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;AACrC,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,aAAa,CAAC,SAAwB,EAAE,EAAU;IAC9D,MAAM,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;IAC3B,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC;AACvE,CAAC;AAED;uGACuG;AACvG,MAAM,UAAU,YAAY,CACxB,SAAwB,EACxB,MAA8D,EAC9D,SAAS,GAAG,IAAI;IAEhB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACtG,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,UAAU,CAAC,GAAW;IAClC,OAAO,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,cAAc,GAAG,GAAG,CAAC;AAC3B,MAAM,UAAU,GAAG,IAAI,CAAC;AAExB,MAAM,UAAU,WAAW,CAAC,OAAe;IACvC,MAAM,MAAM,GAAG,OAAO,GAAG,cAAc,CAAC;IACxC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,QAAQ,OAAO,6EAA6E,CAAC,CAAC;IAClH,CAAC;IACD,OAAO,EAAE,CAAC;AACd,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAAU;IAClC,OAAO,EAAE,GAAG,cAAc,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,SAAwC;IAC9E,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACvD,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC7C,OAAO,GAAG,IAAI,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,WAAmB,EAAE,eAAuB;IACzE,MAAM,KAAK,GAAG,eAAe,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,eAAe,sBAAsB,CAAC;IAC9F,OAAO,GAAG,WAAW,QAAQ,KAAK,EAAE,CAAC;AACzC,CAAC"}

package/dist/utils/query.utils.d.ts

@@ -0,0 +1,2 @@
+export declare function buildQuery(params: Record<string, string | number | null>): string;
+//# sourceMappingURL=query.utils.d.ts.map

package/dist/utils/query.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.utils.d.ts","sourceRoot":"","sources":["../../src/utils/query.utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,CAQjF"}

package/dist/utils/query.utils.js

@@ -0,0 +1,10 @@
+export function buildQuery(params) {
+    const pairs = [];
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== null) {
+            pairs.push(`${key}=${encodeURIComponent(String(value))}`);
+        }
+    }
+    return pairs.length === 0 ? '' : `?${pairs.join('&')}`;
+}
+//# sourceMappingURL=query.utils.js.map

package/dist/utils/query.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.utils.js","sourceRoot":"","sources":["../../src/utils/query.utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,MAA8C;IACrE,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9D,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAC3D,CAAC"}

package/dist/utils/retry.constants.d.ts

@@ -0,0 +1,10 @@
+export declare const DEFAULT_RETRY_OPTIONS: {
+    readonly maxAttempts: 3;
+    readonly baseDelayMs: 250;
+    readonly maxDelayMs: 4000;
+    readonly factor: 2;
+};
+export declare const RETRYABLE_ERROR_PATTERNS: readonly ["timeout", "timed out", "etimedout", "econnreset", "econnrefused", "enotfound", "eai_again", "socket hang up", "network error", "fetch failed", "rate limit", "too many requests", "service unavailable", "bad gateway", "gateway timeout"];
+export declare const REVERT_ERROR_NAMES: readonly ["ContractFunctionRevertedError", "ContractFunctionExecutionError", "ExecutionRevertedError", "RawContractError", "InvalidInputRpcError"];
+export declare const RETRYABLE_HTTP_STATUSES: Set<number>;
+//# sourceMappingURL=retry.constants.d.ts.map

package/dist/utils/retry.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.constants.d.ts","sourceRoot":"","sources":["../../src/utils/retry.constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB;;;;;CAKxB,CAAC;AAEX,eAAO,MAAM,wBAAwB,uPAgB3B,CAAC;AAEX,eAAO,MAAM,kBAAkB,oJAMrB,CAAC;AAEX,eAAO,MAAM,uBAAuB,aAA+C,CAAC"}

package/dist/utils/retry.constants.js

@@ -0,0 +1,32 @@
+export const DEFAULT_RETRY_OPTIONS = {
+    maxAttempts: 3,
+    baseDelayMs: 250,
+    maxDelayMs: 4_000,
+    factor: 2,
+};
+export const RETRYABLE_ERROR_PATTERNS = [
+    'timeout',
+    'timed out',
+    'etimedout',
+    'econnreset',
+    'econnrefused',
+    'enotfound',
+    'eai_again',
+    'socket hang up',
+    'network error',
+    'fetch failed',
+    'rate limit',
+    'too many requests',
+    'service unavailable',
+    'bad gateway',
+    'gateway timeout',
+];
+export const REVERT_ERROR_NAMES = [
+    'ContractFunctionRevertedError',
+    'ContractFunctionExecutionError',
+    'ExecutionRevertedError',
+    'RawContractError',
+    'InvalidInputRpcError',
+];
+export const RETRYABLE_HTTP_STATUSES = new Set([408, 425, 429, 500, 502, 503, 504]);
+//# sourceMappingURL=retry.constants.js.map

package/dist/utils/retry.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.constants.js","sourceRoot":"","sources":["../../src/utils/retry.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACjC,WAAW,EAAE,CAAC;IACd,WAAW,EAAE,GAAG;IAChB,UAAU,EAAE,KAAK;IACjB,MAAM,EAAE,CAAC;CACH,CAAC;AAEX,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACpC,SAAS;IACT,WAAW;IACX,WAAW;IACX,YAAY;IACZ,cAAc;IACd,WAAW;IACX,WAAW;IACX,gBAAgB;IAChB,eAAe;IACf,cAAc;IACd,YAAY;IACZ,mBAAmB;IACnB,qBAAqB;IACrB,aAAa;IACb,iBAAiB;CACX,CAAC;AAEX,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAC9B,+BAA+B;IAC/B,gCAAgC;IAChC,wBAAwB;IACxB,kBAAkB;IAClB,sBAAsB;CAChB,CAAC;AAEX,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC"}

package/dist/utils/retry.utils.d.ts

@@ -0,0 +1,13 @@
+import type { ILogger } from '../logger/types.js';
+export interface RetryOptions {
+    maxAttempts: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+    factor: number;
+    isRetryable: (error: unknown) => boolean;
+    logger: ILogger | null;
+    label: string;
+}
+export declare function isRetryableRpcError(error: unknown): boolean;
+export declare function withRetry<T>(fn: () => Promise<T>, options?: Partial<RetryOptions>): Promise<T>;
+//# sourceMappingURL=retry.utils.d.ts.map

package/dist/utils/retry.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.utils.d.ts","sourceRoot":"","sources":["../../src/utils/retry.utils.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,WAAW,YAAY;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACzC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAe3D;AAOD,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CA6BxG"}

package/dist/utils/retry.utils.js

@@ -0,0 +1,55 @@
+import { BaseError, HttpRequestError, TimeoutError } from 'viem';
+import { sleep } from './async.utils.js';
+import { errorMessage } from './error.utils.js';
+import { DEFAULT_RETRY_OPTIONS, RETRYABLE_ERROR_PATTERNS, RETRYABLE_HTTP_STATUSES, REVERT_ERROR_NAMES, } from './retry.constants.js';
+export function isRetryableRpcError(error) {
+    if (error instanceof BaseError) {
+        const revert = error.walk((e) => REVERT_ERROR_NAMES.includes(e.name));
+        if (revert !== null) {
+            return false;
+        }
+        const transport = error.walk((e) => e instanceof HttpRequestError || e instanceof TimeoutError);
+        if (transport instanceof TimeoutError) {
+            return true;
+        }
+        if (transport instanceof HttpRequestError) {
+            return transport.status === undefined || RETRYABLE_HTTP_STATUSES.has(transport.status);
+        }
+    }
+    return messageLooksTransient(error);
+}
+function messageLooksTransient(error) {
+    const message = errorMessage(error).toLowerCase();
+    return RETRYABLE_ERROR_PATTERNS.some((pattern) => message.includes(pattern));
+}
+export async function withRetry(fn, options = {}) {
+    const opts = {
+        ...DEFAULT_RETRY_OPTIONS,
+        isRetryable: isRetryableRpcError,
+        logger: null,
+        label: 'rpc call',
+        ...options,
+    };
+    let lastError;
+    for (let attempt = 1; attempt <= opts.maxAttempts; attempt += 1) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt >= opts.maxAttempts || !opts.isRetryable(error)) {
+                break;
+            }
+            const delay = Math.min(opts.maxDelayMs, opts.baseDelayMs * opts.factor ** (attempt - 1));
+            opts.logger?.warn('transient error — retrying', {
+                label: opts.label,
+                attempt,
+                nextDelayMs: delay,
+                error: errorMessage(error),
+            });
+            await sleep(delay);
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=retry.utils.js.map