@fidesbuild/mcp-server 0.8.2 → 0.9.0

package/dist/server.js

@@ -21,6 +21,7 @@ import { createX402, decodePaymentRequired, exactEip3009 } from '@fidesbuild/x40
 import { netObligations, settle, netRoots, PUBLISH_SELECTOR, NetError } from '@fidesbuild/net';
 import { createSubClient, SubFidesKit, SubAgent, SubFidesError, subDeployments } from '@fidesbuild/sub';
 import { quoteUniswap, checkMandate, swapActions, verifySwap, describeRoute, mandateOf, uniswap, NATIVE, SwapError } from '@fidesbuild/swap';
+import { route } from '@fidesbuild/router';
 export function configFromEnv(env = process.env) {
     const home = env.FIDES_HOME ?? path.join(os.homedir(), '.fides');
     return {
@@ -822,7 +823,7 @@ export function createFidesMcpServer(cfg) {
     const tokenArg = (t) => (/^eth$/i.test(t) ? 'ETH' : /^weth$/i.test(t) ? uniswap[cfg.chainId]?.weth : isAddress(t) ? getAddress(t) : null);
     server.registerTool('fides_swap', {
         title: 'Swap on Uniswap inside the FIDES',
-        description: 'Gets the best route from Uniswap on Robinhood Chain (v2, v3 and v4 pools, including v4 pools with hooks such as the aggregator hooks) for the FIDES Account, checks it against the trading mandate the owner signed (tokens it may buy, worst price, most per swap), and simulates it to measure what would actually arrive. Sends nothing. Returns a plan_id for fides_execute, which sends an exact approval and the swap as one transaction; gas is paid by the relayer. Show the route, the quoted amount and the worst accepted amount to the user before executing. Needs a FIDES that allows swaps: fides_setup with swap.',
+        description: 'Swaps on Uniswap on Robinhood Chain with FIDES ROUTER: gets a route through each kind of pool (v2, v3 and v4, including v4 pools with hooks), checks each against the FIDES and the trading mandate the owner signed (tokens it may buy, worst price, most per swap), simulates them, ranks them by output, and offers only the best valid one. Show the user routes_compared (the ranking, how far behind each route is, and why any are out) with the chosen route, before executing. Sends nothing. Returns a plan_id for fides_execute, which sends an exact approval and the swap as one transaction; gas is paid by the relayer. Show the route, the quoted amount and the worst accepted amount to the user before executing. Needs a FIDES that allows swaps: fides_setup with swap.',
         inputSchema: {
             token_out: z.string().describe('What to buy: "ETH", "WETH" or a token address'),
             amount: z.string().describe('How much of the budget token to spend, e.g. "1"'),
@@ -850,28 +851,51 @@ export function createFidesMcpServer(cfg) {
                 return fail(`"amount" must be a number of ${tIn.symbol}, like "1".`);
             }
             const slippageBps = max_slippage_percent ? Math.round(max_slippage_percent * 100) : m.maxSlippageBps;
-            let q, blocked;
-            if (cfg.api) {
-                const r = await post('/v1/swap/quote', { fides, tokenOut: out, amount: value, slippageBps });
-                q = r.quote;
-                blocked = r.mandate?.allowed ? null : { code: r.mandate.code, message: r.mandate.message };
-            }
-            else {
-                if (!process.env.UNISWAP_API_KEY)
-                    return fail('Swaps need the FIDES API, or UNISWAP_API_KEY when running without it.');
-                q = await quoteUniswap({ apiKey: process.env.UNISWAP_API_KEY, fides, tokenOut: out, amount: value, slippageBps });
-                blocked = checkMandate(fides, q);
+            if (!cfg.api && !process.env.UNISWAP_API_KEY)
+                return fail('Swaps need the FIDES API, or UNISWAP_API_KEY when running without it.');
+            // FIDES ROUTER: a route through each kind of Uniswap pool, each checked against the trading mandate and the
+            // FIDES, simulated and ranked by output. Only the best valid one is offered to execute.
+            const POOLS = [['uniswap v2', ['V2']], ['uniswap v3', ['V3']], ['uniswap v4', ['V4']]];
+            const quotes = new Map(), excluded = [];
+            await Promise.all(POOLS.map(async ([name, protocols]) => {
+                try {
+                    let q, blocked;
+                    if (cfg.api) {
+                        const r = await post('/v1/swap/quote', { fides, tokenOut: out, amount: value, slippageBps, protocols });
+                        q = r.quote;
+                        blocked = r.mandate?.allowed ? null : { code: r.mandate.code, message: r.mandate.message };
+                    }
+                    else {
+                        q = await quoteUniswap({ apiKey: process.env.UNISWAP_API_KEY, fides, tokenOut: out, amount: value, slippageBps, protocols });
+                        blocked = checkMandate(fides, q);
+                    }
+                    if (blocked)
+                        excluded.push({ route: name, why: `trading mandate: ${blocked.message}` });
+                    else
+                        quotes.set(name, q);
+                }
+                catch (err) {
+                    excluded.push({ route: name, why: `no route: ${err?.message ?? err}` });
+                }
+            }));
+            if (!quotes.size) {
+                const mandate = excluded.find((x) => x.why.startsWith('trading mandate'));
+                return fail(mandate ? `Blocked by the ${mandate.why} Nothing was sent.` : `Uniswap has no route for this swap: ${excluded.map((x) => `${x.route} (${x.why})`).join('; ')}. Nothing was sent.`);
             }
-            const outInfo = q.tokenOut === NATIVE ? { symbol: 'ETH', decimals: 18 } : await token(q.tokenOut);
+            const first = [...quotes.values()][0];
+            const outInfo = first.tokenOut === NATIVE ? { symbol: 'ETH', decimals: 18 } : await token(first.tokenOut);
             const fmt = (v) => `${formatUnits(v, outInfo.decimals)} ${outInfo.symbol}`;
-            if (blocked)
-                return fail(`Blocked by the trading mandate: ${blocked.message} Nothing was sent.`);
-            const actions = swapActions(q, `swap ${amount} ${tIn.symbol} to ${outInfo.symbol} on Uniswap`);
-            const plan = await new FidesBuilder({ client, fides, agent }).add(actions).build();
-            if (plan.rejected().length) {
-                const r = plan.rejected()[0];
-                return fail(`Blocked by the FIDES: ${REASONS[r.reason ?? ''] ?? r.reason}. Nothing was sent.`);
-            }
+            const label = `swap ${amount} ${tIn.symbol} to ${outInfo.symbol} on Uniswap`;
+            const routed = await route({ client, fides, agent }, [...quotes].map(([name, q]) => ({ name, actions: swapActions(q, label), expectedOut: q.quotedOut, minOut: q.minOut })));
+            const ranking = [
+                ...routed.ranked.map((x) => x.valid
+                    ? { route: x.name, verdict: x === routed.best ? 'best, chosen' : 'valid', quoted: fmt(x.expectedOut ?? 0n), behind_best: `${(x.slippageBps ?? 0) / 100}%`, gas: String(x.gas), pools: describeRoute(quotes.get(x.name)) }
+                    : { route: x.name, verdict: 'out', why: REASONS[x.reasons[0]?.split(': ')[1] ?? ''] ?? x.reasons[0] }),
+                ...excluded.map((x) => ({ route: x.route, verdict: 'out', why: x.why })),
+            ];
+            if (!routed.best)
+                return fail(`No route is inside the FIDES, so nothing can run: ${ranking.map((x) => `${x.route} (${x.why})`).join('; ')}. Nothing was sent.`);
+            const q = quotes.get(routed.best.name), plan = routed.plan(routed.best.name), actions = swapActions(q, label);
             const v = await verifySwap(client, fides, plan, q);
             const id = plan.planHash.slice(0, 18);
             if (v.ok)
@@ -879,6 +903,9 @@ export function createFidesMcpServer(cfg) {
             return ok({
                 plan_id: v.ok ? id : null,
                 ready_to_execute: v.ok,
+                router: `FIDES ROUTER compared ${ranking.length} routes, one per kind of Uniswap pool: each checked against the FIDES and the trading mandate, simulated, and ranked by output. Only the chosen route runs.`,
+                routes_compared: ranking,
+                chosen: routed.best.name,
                 route: describeRoute(q),
                 spend: `${amount} ${tIn.symbol}`,
                 quoted: fmt(q.quotedOut),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fidesbuild/mcp-server",
-  "version": "0.8.2",
+  "version": "0.9.0",
   "description": "FIDES as tools for Claude and any MCP client: plan and execute actions inside a signed FIDES, gas paid by the hosted relayer.",
   "keywords": [
     "fides",
@@ -42,6 +42,7 @@
     "@fidesbuild/x402": "0.2.0",
     "@fidesbuild/net": "0.2.1",
     "@fidesbuild/sub": "0.2.0",
-    "@fidesbuild/swap": "0.2.0"
+    "@fidesbuild/swap": "0.2.1",
+    "@fidesbuild/router": "0.2.0"
   }
 }