recon-crypto-mcp 0.1.0

package/dist/modules/swap/lifi.d.ts

@@ -0,0 +1,17 @@
+import { type SupportedChain } from "../../types/index.js";
+/** Initialize the LiFi SDK once. Safe to call repeatedly. */
+export declare function initLifi(): void;
+export interface LifiQuoteRequest {
+    fromChain: SupportedChain;
+    toChain: SupportedChain;
+    /** Use "native" or "0x0000000000000000000000000000000000000000" for native token. */
+    fromToken: `0x${string}` | "native";
+    toToken: `0x${string}` | "native";
+    /** Raw integer amount as string (e.g. "1000000" for 1 USDC). */
+    fromAmount: string;
+    fromAddress: `0x${string}`;
+    /** Optional slippage override — LiFi default is 0.5% (0.005). */
+    slippage?: number;
+}
+export declare function fetchQuote(req: LifiQuoteRequest): Promise<import("@lifi/sdk").LiFiStep>;
+export declare function fetchStatus(txHash: string, fromChain: SupportedChain, toChain: SupportedChain): Promise<import("@lifi/sdk").StatusResponse>;

package/dist/modules/swap/lifi.js

@@ -0,0 +1,44 @@
+import { createConfig, getQuote, getStatus } from "@lifi/sdk";
+import { CHAIN_IDS } from "../../types/index.js";
+let initialized = false;
+/** Initialize the LiFi SDK once. Safe to call repeatedly. */
+export function initLifi() {
+    if (initialized)
+        return;
+    createConfig({
+        integrator: "recon-crypto-mcp",
+        // We don't execute routes through LiFi — we just fetch tx data and hand it to WalletConnect.
+    });
+    initialized = true;
+}
+/** Map our chain name to LiFi's numeric chain ID. */
+function toLifiChain(chain) {
+    return CHAIN_IDS[chain];
+}
+const NATIVE = "0x0000000000000000000000000000000000000000";
+export async function fetchQuote(req) {
+    initLifi();
+    const fromChain = toLifiChain(req.fromChain);
+    const toChain = toLifiChain(req.toChain);
+    const fromToken = req.fromToken === "native" ? NATIVE : req.fromToken;
+    const toToken = req.toToken === "native" ? NATIVE : req.toToken;
+    const quote = await getQuote({
+        fromChain: fromChain,
+        toChain: toChain,
+        fromToken,
+        toToken,
+        fromAmount: req.fromAmount,
+        fromAddress: req.fromAddress,
+        slippage: req.slippage,
+    });
+    return quote;
+}
+export async function fetchStatus(txHash, fromChain, toChain) {
+    initLifi();
+    return getStatus({
+        txHash,
+        fromChain: toLifiChain(fromChain),
+        toChain: toLifiChain(toChain),
+    });
+}
+//# sourceMappingURL=lifi.js.map

package/dist/modules/swap/lifi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifi.js","sourceRoot":"","sources":["../../../src/modules/swap/lifi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAA0B,MAAM,WAAW,CAAC;AACtF,OAAO,EAAE,SAAS,EAAuB,MAAM,sBAAsB,CAAC;AAEtE,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB,6DAA6D;AAC7D,MAAM,UAAU,QAAQ;IACtB,IAAI,WAAW;QAAE,OAAO;IACxB,YAAY,CAAC;QACX,UAAU,EAAE,kBAAkB;QAC9B,6FAA6F;KAC9F,CAAC,CAAC;IACH,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC;AAED,qDAAqD;AACrD,SAAS,WAAW,CAAC,KAAqB;IACxC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAeD,MAAM,MAAM,GAAG,4CAA4C,CAAC;AAE5D,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAqB;IACpD,QAAQ,EAAE,CAAC;IACX,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC;IACtE,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;IAEhE,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC;QAC3B,SAAS,EAAE,SAAwB;QACnC,OAAO,EAAE,OAAsB;QAC/B,SAAS;QACT,OAAO;QACP,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,QAAQ,EAAE,GAAG,CAAC,QAAQ;KACvB,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAc,EAAE,SAAyB,EAAE,OAAuB;IAClG,QAAQ,EAAE,CAAC;IACX,OAAO,SAAS,CAAC;QACf,MAAM;QACN,SAAS,EAAE,WAAW,CAAC,SAAS,CAAgB;QAChD,OAAO,EAAE,WAAW,CAAC,OAAO,CAAgB;KAC7C,CAAC,CAAC;AACL,CAAC"}

package/dist/modules/swap/oneinch.d.ts

@@ -0,0 +1,26 @@
+import { type SupportedChain } from "../../types/index.js";
+export interface OneInchQuoteRequest {
+    chain: SupportedChain;
+    fromToken: `0x${string}` | "native";
+    toToken: `0x${string}` | "native";
+    /** Raw integer amount as string (e.g. "1000000" for 1 USDC). */
+    fromAmount: string;
+    apiKey: string;
+}
+export interface OneInchQuoteRaw {
+    dstAmount: string;
+    srcToken?: {
+        address: string;
+        symbol: string;
+        decimals: number;
+    };
+    dstToken?: {
+        address: string;
+        symbol: string;
+        decimals: number;
+    };
+    /** Estimated gas (units) for the swap, if `includeGas=true` was requested. */
+    gas?: number;
+    protocols?: unknown[];
+}
+export declare function fetchOneInchQuote(req: OneInchQuoteRequest): Promise<OneInchQuoteRaw>;

package/dist/modules/swap/oneinch.js

@@ -0,0 +1,33 @@
+import { CHAIN_IDS } from "../../types/index.js";
+/**
+ * 1inch Aggregation API v6.0 client. Used for intra-chain swap comparison against LiFi.
+ *
+ * 1inch is intra-chain only (no bridges), so cross-chain routes skip this entirely.
+ * The public API requires a Bearer token from https://portal.1inch.dev — when no
+ * key is configured, callers should skip the comparison silently rather than error.
+ */
+/** 1inch uses this sentinel for the chain's native asset. */
+const ONEINCH_NATIVE = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
+export async function fetchOneInchQuote(req) {
+    const chainId = CHAIN_IDS[req.chain];
+    const src = req.fromToken === "native" ? ONEINCH_NATIVE : req.fromToken;
+    const dst = req.toToken === "native" ? ONEINCH_NATIVE : req.toToken;
+    const url = new URL(`https://api.1inch.dev/swap/v6.0/${chainId}/quote`);
+    url.searchParams.set("src", src);
+    url.searchParams.set("dst", dst);
+    url.searchParams.set("amount", req.fromAmount);
+    url.searchParams.set("includeTokensInfo", "true");
+    url.searchParams.set("includeGas", "true");
+    const res = await fetch(url, {
+        headers: {
+            Authorization: `Bearer ${req.apiKey}`,
+            Accept: "application/json",
+        },
+    });
+    if (!res.ok) {
+        const body = await res.text().catch(() => "");
+        throw new Error(`1inch quote ${res.status}: ${body.slice(0, 200)}`);
+    }
+    return (await res.json());
+}
+//# sourceMappingURL=oneinch.js.map

package/dist/modules/swap/oneinch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oneinch.js","sourceRoot":"","sources":["../../../src/modules/swap/oneinch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAuB,MAAM,sBAAsB,CAAC;AAEtE;;;;;;GAMG;AAEH,6DAA6D;AAC7D,MAAM,cAAc,GAAG,4CAA4C,CAAC;AAoBpE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAwB;IAC9D,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC;IACxE,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;IAEpE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,mCAAmC,OAAO,QAAQ,CAAC,CAAC;IACxE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACjC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACjC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IAC/C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;IAClD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAE3C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,GAAG,CAAC,MAAM,EAAE;YACrC,MAAM,EAAE,kBAAkB;SAC3B;KACF,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,eAAe,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAoB,CAAC;AAC/C,CAAC"}

package/dist/modules/swap/schemas.d.ts

@@ -0,0 +1,65 @@
+import { z } from "zod";
+export declare const getSwapQuoteInput: z.ZodObject<{
+    wallet: z.ZodString;
+    fromChain: z.ZodEnum<[string, ...string[]]>;
+    toChain: z.ZodEnum<[string, ...string[]]>;
+    fromToken: z.ZodUnion<[z.ZodLiteral<"native">, z.ZodString]>;
+    toToken: z.ZodUnion<[z.ZodLiteral<"native">, z.ZodString]>;
+    amount: z.ZodString;
+    fromTokenDecimals: z.ZodOptional<z.ZodNumber>;
+    slippageBps: z.ZodOptional<z.ZodNumber>;
+    acknowledgeHighSlippage: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+    wallet: string;
+    fromChain: string;
+    toChain: string;
+    fromToken: string;
+    toToken: string;
+    fromTokenDecimals?: number | undefined;
+    slippageBps?: number | undefined;
+    acknowledgeHighSlippage?: boolean | undefined;
+}, {
+    amount: string;
+    wallet: string;
+    fromChain: string;
+    toChain: string;
+    fromToken: string;
+    toToken: string;
+    fromTokenDecimals?: number | undefined;
+    slippageBps?: number | undefined;
+    acknowledgeHighSlippage?: boolean | undefined;
+}>;
+export declare const prepareSwapInput: z.ZodObject<{
+    wallet: z.ZodString;
+    fromChain: z.ZodEnum<[string, ...string[]]>;
+    toChain: z.ZodEnum<[string, ...string[]]>;
+    fromToken: z.ZodUnion<[z.ZodLiteral<"native">, z.ZodString]>;
+    toToken: z.ZodUnion<[z.ZodLiteral<"native">, z.ZodString]>;
+    amount: z.ZodString;
+    fromTokenDecimals: z.ZodOptional<z.ZodNumber>;
+    slippageBps: z.ZodOptional<z.ZodNumber>;
+    acknowledgeHighSlippage: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+    wallet: string;
+    fromChain: string;
+    toChain: string;
+    fromToken: string;
+    toToken: string;
+    fromTokenDecimals?: number | undefined;
+    slippageBps?: number | undefined;
+    acknowledgeHighSlippage?: boolean | undefined;
+}, {
+    amount: string;
+    wallet: string;
+    fromChain: string;
+    toChain: string;
+    fromToken: string;
+    toToken: string;
+    fromTokenDecimals?: number | undefined;
+    slippageBps?: number | undefined;
+    acknowledgeHighSlippage?: boolean | undefined;
+}>;
+export type GetSwapQuoteArgs = z.infer<typeof getSwapQuoteInput>;
+export type PrepareSwapArgs = z.infer<typeof prepareSwapInput>;

package/dist/modules/swap/schemas.js

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import { SUPPORTED_CHAINS } from "../../types/index.js";
+const chainEnum = z.enum(SUPPORTED_CHAINS);
+const walletSchema = z.string().regex(/^0x[a-fA-F0-9]{40}$/);
+const tokenSchema = z.union([
+    z.literal("native"),
+    z.string().regex(/^0x[a-fA-F0-9]{40}$/),
+]);
+const baseSwapSchema = z.object({
+    wallet: walletSchema,
+    fromChain: chainEnum,
+    toChain: chainEnum,
+    fromToken: tokenSchema,
+    toToken: tokenSchema,
+    amount: z
+        .string()
+        .describe('Human-readable decimal amount of fromToken, NOT raw wei/base units. ' +
+        'Example: "1.5" for 1.5 USDC, "0.01" for 0.01 ETH. The tool resolves ' +
+        'decimals on-chain and converts internally.'),
+    fromTokenDecimals: z
+        .number()
+        .int()
+        .min(0)
+        .max(36)
+        .optional()
+        .describe("Optional decimals hint for fromToken if on-chain lookup fails (rare). Native is 18."),
+    slippageBps: z
+        .number()
+        .int()
+        .min(1)
+        .max(500)
+        .optional()
+        .describe("Slippage tolerance in basis points (50 = 0.5%, 100 = 1%). Default ~50. " +
+        "Hard-capped at 500 (5%) — anything higher is almost always a sandwich-bait " +
+        "misconfiguration. If a legitimate thin-liquidity route genuinely needs >1%, " +
+        "also pass `acknowledgeHighSlippage: true`."),
+    acknowledgeHighSlippage: z
+        .boolean()
+        .optional()
+        .describe("Opt-in flag required when slippageBps > 100 (1%). Forces the caller to state " +
+        "that an unusually-high slippage is intentional — the default rejects the tx " +
+        "to protect the user from MEV sandwich attacks."),
+});
+export const getSwapQuoteInput = baseSwapSchema;
+export const prepareSwapInput = baseSwapSchema;
+//# sourceMappingURL=schemas.js.map

package/dist/modules/swap/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/modules/swap/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,gBAAoD,CAAC,CAAC;AAC/E,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;AAC7D,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC;IAC1B,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACnB,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qBAAqB,CAAC;CACxC,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,SAAS;IACpB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,WAAW;IACpB,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,CACP,sEAAsE;QACpE,sEAAsE;QACtE,4CAA4C,CAC/C;IACH,iBAAiB,EAAE,CAAC;SACjB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CACP,qFAAqF,CACtF;IACH,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,yEAAyE;QACvE,6EAA6E;QAC7E,8EAA8E;QAC9E,4CAA4C,CAC/C;IACH,uBAAuB,EAAE,CAAC;SACvB,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,+EAA+E;QAC7E,8EAA8E;QAC9E,gDAAgD,CACnD;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAChD,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC"}

package/dist/setup.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/setup.js

@@ -0,0 +1,257 @@
+#!/usr/bin/env node
+/**
+ * Interactive setup for Recon Crypto MCP.
+ *
+ *   - Picks an RPC provider (Infura / Alchemy / custom) and validates the API key
+ *     against a live eth_chainId call.
+ *   - Optionally captures an Etherscan API key (improves contract-verification tools).
+ *   - Optionally captures a WalletConnect Cloud project ID.
+ *   - Optionally pairs Ledger Live over WalletConnect right now.
+ *   - Persists everything to ~/.recon-crypto-mcp/config.json (0600) and prints a
+ *     Claude Desktop config snippet the user can copy.
+ *
+ * Env vars always override the config file at runtime — the setup flow is for
+ * users who'd rather not manage env vars.
+ */
+import { createInterface } from "node:readline";
+import { createPublicClient, http } from "viem";
+import { mainnet } from "viem/chains";
+import qrcodeTerminal from "qrcode-terminal";
+import { patchUserConfig, readUserConfig, getConfigPath, } from "./config/user-config.js";
+/** Thin readline wrapper so each prompt is a single awaited call. */
+class Prompt {
+    rl;
+    constructor() {
+        this.rl = createInterface({ input: process.stdin, output: process.stdout });
+    }
+    ask(question) {
+        return new Promise((resolve) => this.rl.question(question, (a) => resolve(a.trim())));
+    }
+    async askDefault(question, def) {
+        const answer = await this.ask(`${question} [${def}]: `);
+        return answer === "" ? def : answer;
+    }
+    async askYesNo(question, def) {
+        const hint = def ? "Y/n" : "y/N";
+        const answer = (await this.ask(`${question} (${hint}): `)).toLowerCase();
+        if (answer === "")
+            return def;
+        return answer === "y" || answer === "yes";
+    }
+    async askChoice(question, choices, def) {
+        console.log(question);
+        choices.forEach((c, i) => console.log(`  ${i + 1}) ${c}`));
+        const raw = await this.ask(`Choose [${def + 1}]: `);
+        if (raw === "")
+            return def;
+        const n = Number(raw);
+        if (!Number.isInteger(n) || n < 1 || n > choices.length) {
+            console.log(`  Invalid selection — defaulting to ${choices[def]}.`);
+            return def;
+        }
+        return n - 1;
+    }
+    close() {
+        this.rl.close();
+    }
+}
+const PROVIDER_URLS = {
+    infura: {
+        ethereum: (k) => `https://mainnet.infura.io/v3/${k}`,
+        arbitrum: (k) => `https://arbitrum-mainnet.infura.io/v3/${k}`,
+        polygon: (k) => `https://polygon-mainnet.infura.io/v3/${k}`,
+    },
+    alchemy: {
+        ethereum: (k) => `https://eth-mainnet.g.alchemy.com/v2/${k}`,
+        arbitrum: (k) => `https://arb-mainnet.g.alchemy.com/v2/${k}`,
+        polygon: (k) => `https://polygon-mainnet.g.alchemy.com/v2/${k}`,
+    },
+};
+/** Make a minimal eth_chainId call against the URL. Returns the numeric chain ID on success. */
+async function validateRpcUrl(url) {
+    const client = createPublicClient({ chain: mainnet, transport: http(url, { retryCount: 0 }) });
+    const id = await client.getChainId();
+    return id;
+}
+async function configureRpc(p) {
+    console.log("\n--- RPC Provider ---");
+    const providerIdx = await p.askChoice("Select an RPC provider:", ["Infura", "Alchemy", "Custom (bring your own URLs)"], 0);
+    const provider = ["infura", "alchemy", "custom"][providerIdx];
+    if (provider === "custom") {
+        const ethUrl = await p.ask("Ethereum RPC URL: ");
+        const arbUrl = await p.ask("Arbitrum RPC URL (leave blank to skip): ");
+        const polyUrl = await p.ask("Polygon RPC URL (leave blank to skip): ");
+        if (ethUrl) {
+            try {
+                const id = await validateRpcUrl(ethUrl);
+                if (id !== 1)
+                    console.warn(`  Warning: Ethereum URL returned chain ID ${id}, expected 1.`);
+                else
+                    console.log("  Ethereum URL OK.");
+            }
+            catch (e) {
+                console.warn(`  Warning: could not validate Ethereum URL — ${e.message}`);
+            }
+        }
+        return {
+            provider: "custom",
+            customUrls: {
+                ...(ethUrl ? { ethereum: ethUrl } : {}),
+                ...(arbUrl ? { arbitrum: arbUrl } : {}),
+                ...(polyUrl ? { polygon: polyUrl } : {}),
+            },
+        };
+    }
+    // infura / alchemy
+    const existing = readUserConfig();
+    const prevKey = existing?.rpc.provider === provider ? existing.rpc.apiKey : undefined;
+    let apiKey = prevKey ?? "";
+    for (let attempt = 0; attempt < 3; attempt++) {
+        const prompt = prevKey
+            ? `${provider} API key [press enter to keep existing]: `
+            : `${provider} API key: `;
+        const entered = await p.ask(prompt);
+        apiKey = entered || prevKey || "";
+        if (!apiKey) {
+            console.log("  An API key is required.");
+            continue;
+        }
+        const testUrl = PROVIDER_URLS[provider].ethereum(apiKey);
+        try {
+            const id = await validateRpcUrl(testUrl);
+            if (id === 1) {
+                console.log(`  ${provider} API key OK — Ethereum chain ID ${id}.`);
+                return { provider, apiKey };
+            }
+            console.warn(`  Unexpected chain ID ${id} from ${provider}.`);
+        }
+        catch (e) {
+            console.warn(`  Validation failed: ${e.message}`);
+        }
+    }
+    throw new Error(`Could not validate ${provider} API key after 3 attempts.`);
+}
+async function configureEtherscan(p) {
+    console.log("\n--- Etherscan (optional) ---");
+    console.log("Improves contract-verification tools. Skip with empty input.");
+    const existing = readUserConfig()?.etherscanApiKey;
+    const answer = await p.ask(existing
+        ? "Etherscan API key [press enter to keep existing]: "
+        : "Etherscan API key (or blank to skip): ");
+    if (!answer && existing)
+        return existing;
+    return answer || undefined;
+}
+async function configureOneInch(p) {
+    console.log("\n--- 1inch (optional — enables swap-quote comparison vs LiFi) ---");
+    console.log("Create a free key at https://portal.1inch.dev. Skip with empty input.");
+    const existing = readUserConfig()?.oneInchApiKey;
+    const answer = await p.ask(existing
+        ? "1inch API key [press enter to keep existing]: "
+        : "1inch API key (or blank to skip): ");
+    if (!answer && existing)
+        return existing;
+    return answer || undefined;
+}
+async function configureWalletConnect(p) {
+    console.log("\n--- WalletConnect (optional — required for Ledger Live signing) ---");
+    console.log("Create a free project at https://cloud.walletconnect.com.");
+    const existing = readUserConfig()?.walletConnect?.projectId;
+    const answer = await p.ask(existing
+        ? "WalletConnect project ID [press enter to keep existing]: "
+        : "WalletConnect project ID (or blank to skip): ");
+    if (!answer && existing)
+        return existing;
+    return answer || undefined;
+}
+async function pairLedgerLiveFlow(p) {
+    console.log("\n--- Ledger Live pairing ---");
+    const proceed = await p.askYesNo("Pair Ledger Live now via WalletConnect?", false);
+    if (!proceed)
+        return;
+    // Dynamically import so the setup still runs cleanly when WC fails to initialize.
+    const { initiatePairing } = await import("./signing/walletconnect.js");
+    let pairing;
+    try {
+        pairing = await initiatePairing();
+    }
+    catch (e) {
+        console.error(`  Could not initiate pairing: ${e.message}`);
+        return;
+    }
+    console.log("\nScan this QR in Ledger Live → Discover → WalletConnect, or paste the URI:\n");
+    await new Promise((resolve) => qrcodeTerminal.generate(pairing.uri, { small: true }, (qr) => {
+        console.log(qr);
+        resolve();
+    }));
+    console.log(`URI: ${pairing.uri}\n`);
+    console.log("Waiting for you to approve the session in Ledger Live (Ctrl-C to cancel)...");
+    try {
+        await pairing.approval;
+        console.log("Paired. Session persisted to config.");
+    }
+    catch (e) {
+        console.error(`Pairing failed: ${e.message}`);
+    }
+}
+function printClaudeDesktopSnippet() {
+    const binPath = "recon-crypto-mcp"; // installed via `npm i -g recon-crypto-mcp`
+    const snippet = {
+        mcpServers: {
+            "recon-crypto-mcp": {
+                command: binPath,
+            },
+        },
+    };
+    console.log("\n--- Claude Desktop config snippet ---");
+    console.log("Add the following to `claude_desktop_config.json`:\n");
+    console.log(JSON.stringify(snippet, null, 2));
+    console.log("\nIf you're running from source rather than a global install, use:\n" +
+        JSON.stringify({
+            mcpServers: {
+                "recon-crypto-mcp": {
+                    command: "node",
+                    args: [`${process.cwd()}/dist/index.js`],
+                },
+            },
+        }, null, 2));
+}
+async function main() {
+    console.log("Recon Crypto MCP — interactive setup\n");
+    console.log(`Config path: ${getConfigPath()}`);
+    const p = new Prompt();
+    try {
+        const rpc = await configureRpc(p);
+        patchUserConfig({ rpc });
+        const etherscanApiKey = await configureEtherscan(p);
+        if (etherscanApiKey !== undefined) {
+            patchUserConfig({ etherscanApiKey });
+        }
+        const oneInchApiKey = await configureOneInch(p);
+        if (oneInchApiKey !== undefined) {
+            patchUserConfig({ oneInchApiKey });
+        }
+        const wcProjectId = await configureWalletConnect(p);
+        if (wcProjectId !== undefined) {
+            patchUserConfig({ walletConnect: { projectId: wcProjectId } });
+        }
+        // Pairing needs the project ID to be in config already (getSignClient reads it).
+        if (wcProjectId) {
+            await pairLedgerLiveFlow(p);
+        }
+        else {
+            console.log("\nSkipping Ledger Live pairing (no WalletConnect project ID set).");
+        }
+        console.log(`\nConfig written to ${getConfigPath()}.`);
+        printClaudeDesktopSnippet();
+    }
+    catch (err) {
+        console.error(`\nSetup aborted: ${err.message}`);
+        process.exitCode = 1;
+    }
+    finally {
+        p.close();
+    }
+}
+main();
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"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"}

package/dist/signing/pre-sign-check.d.ts

@@ -0,0 +1,8 @@
+import type { UnsignedTx } from "../types/index.js";
+/**
+ * Throws a descriptive error if `tx` looks unsafe to sign. Call synchronously
+ * before every WalletConnect submission. "Unsafe" is conservative: unknown
+ * destination + non-empty data, approves to non-allowlisted spenders, or
+ * selectors that don't belong to the contract we think we're calling.
+ */
+export declare function assertTransactionSafe(tx: UnsignedTx): Promise<void>;