recon-crypto-mcp 0.1.0

package/dist/abis/uniswap-position-manager.d.ts

@@ -0,0 +1,71 @@
+export declare const uniswapPositionManagerAbi: readonly [{
+    readonly type: "function";
+    readonly name: "balanceOf";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "tokenOfOwnerByIndex";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "index";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "positions";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "tokenId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "nonce";
+        readonly type: "uint96";
+    }, {
+        readonly name: "operator";
+        readonly type: "address";
+    }, {
+        readonly name: "token0";
+        readonly type: "address";
+    }, {
+        readonly name: "token1";
+        readonly type: "address";
+    }, {
+        readonly name: "fee";
+        readonly type: "uint24";
+    }, {
+        readonly name: "tickLower";
+        readonly type: "int24";
+    }, {
+        readonly name: "tickUpper";
+        readonly type: "int24";
+    }, {
+        readonly name: "liquidity";
+        readonly type: "uint128";
+    }, {
+        readonly name: "feeGrowthInside0LastX128";
+        readonly type: "uint256";
+    }, {
+        readonly name: "feeGrowthInside1LastX128";
+        readonly type: "uint256";
+    }, {
+        readonly name: "tokensOwed0";
+        readonly type: "uint128";
+    }, {
+        readonly name: "tokensOwed1";
+        readonly type: "uint128";
+    }];
+}];

package/dist/abis/uniswap-position-manager.js

@@ -0,0 +1,41 @@
+// Uniswap V3 NonfungiblePositionManager — functions needed to enumerate LP NFTs.
+export const uniswapPositionManagerAbi = [
+    {
+        type: "function",
+        name: "balanceOf",
+        stateMutability: "view",
+        inputs: [{ name: "owner", type: "address" }],
+        outputs: [{ type: "uint256" }],
+    },
+    {
+        type: "function",
+        name: "tokenOfOwnerByIndex",
+        stateMutability: "view",
+        inputs: [
+            { name: "owner", type: "address" },
+            { name: "index", type: "uint256" },
+        ],
+        outputs: [{ type: "uint256" }],
+    },
+    {
+        type: "function",
+        name: "positions",
+        stateMutability: "view",
+        inputs: [{ name: "tokenId", type: "uint256" }],
+        outputs: [
+            { name: "nonce", type: "uint96" },
+            { name: "operator", type: "address" },
+            { name: "token0", type: "address" },
+            { name: "token1", type: "address" },
+            { name: "fee", type: "uint24" },
+            { name: "tickLower", type: "int24" },
+            { name: "tickUpper", type: "int24" },
+            { name: "liquidity", type: "uint128" },
+            { name: "feeGrowthInside0LastX128", type: "uint256" },
+            { name: "feeGrowthInside1LastX128", type: "uint256" },
+            { name: "tokensOwed0", type: "uint128" },
+            { name: "tokensOwed1", type: "uint128" },
+        ],
+    },
+];
+//# sourceMappingURL=uniswap-position-manager.js.map

package/dist/abis/uniswap-position-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniswap-position-manager.js","sourceRoot":"","sources":["../../src/abis/uniswap-position-manager.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,WAAW;QACjB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC5C,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KAC/B;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,qBAAqB;QAC3B,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;YAClC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;SACnC;QACD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KAC/B;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,WAAW;QACjB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC9C,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;YACjC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;YACrC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;YACnC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;YACnC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/B,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE;YACpC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE;YACpC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;YACtC,EAAE,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE,SAAS,EAAE;YACrD,EAAE,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE,SAAS,EAAE;YACrD,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;YACxC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;SACzC;KACF;CACO,CAAC"}

package/dist/config/cache.d.ts

@@ -0,0 +1,12 @@
+/** TTLs (milliseconds) for the in-memory cache, keyed by data category. */
+export declare const CACHE_TTL: {
+    readonly PRICE: 30000;
+    readonly POSITION: 60000;
+    readonly STAKING: 120000;
+    readonly YIELD: 600000;
+    readonly SECURITY_VERIFICATION: 86400000;
+    readonly SECURITY_PERMISSIONS: 3600000;
+    readonly PROTOCOL_RISK: 3600000;
+    readonly IMMUNEFI: 86400000;
+};
+export type CacheTTLKey = keyof typeof CACHE_TTL;

package/dist/config/cache.js

@@ -0,0 +1,12 @@
+/** TTLs (milliseconds) for the in-memory cache, keyed by data category. */
+export const CACHE_TTL = {
+    PRICE: 30_000,
+    POSITION: 60_000,
+    STAKING: 120_000,
+    YIELD: 600_000,
+    SECURITY_VERIFICATION: 86_400_000,
+    SECURITY_PERMISSIONS: 3_600_000,
+    PROTOCOL_RISK: 3_600_000,
+    IMMUNEFI: 86_400_000,
+};
+//# sourceMappingURL=cache.js.map

package/dist/config/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/config/cache.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,KAAK,EAAE,MAAM;IACb,QAAQ,EAAE,MAAM;IAChB,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,OAAO;IACd,qBAAqB,EAAE,UAAU;IACjC,oBAAoB,EAAE,SAAS;IAC/B,aAAa,EAAE,SAAS;IACxB,QAAQ,EAAE,UAAU;CACZ,CAAC"}

package/dist/config/chains.d.ts

@@ -0,0 +1,24 @@
+import type { Chain } from "viem";
+import type { SupportedChain, UserConfig } from "../types/index.js";
+export declare const VIEM_CHAINS: Record<SupportedChain, Chain>;
+export declare class RpcConfigError extends Error {
+    constructor(message: string);
+}
+/**
+ * Reject RPC URLs that are obviously unsafe to talk to:
+ *  - non-https (http plaintext leaks your wallet query pattern to anything on
+ *    the network path)
+ *  - loopback / private / link-local hosts (RFC1918, 127/8, ::1, *.local).
+ *    Private-range URLs in a shared config are a strong indicator something
+ *    got mis-pasted (e.g. a neighbour's dev box) and we'd rather fail loud
+ *    than exfiltrate wallet addresses to an unexpected host.
+ * Callers who intentionally want to hit a local forked node (anvil, hardhat,
+ * etc.) can opt out with RECON_ALLOW_INSECURE_RPC=1.
+ */
+export declare function validateRpcUrl(chain: SupportedChain, url: string): void;
+export declare function isPrivateOrLoopbackHost(host: string): boolean;
+/**
+ * Resolve the RPC URL for a given chain based on env vars (highest priority)
+ * then the user's ~/.recon-crypto-mcp/config.json.
+ */
+export declare function resolveRpcUrl(chain: SupportedChain, userConfig: UserConfig | null): string;

package/dist/config/chains.js

@@ -0,0 +1,158 @@
+import { mainnet, arbitrum, polygon } from "viem/chains";
+export const VIEM_CHAINS = {
+    ethereum: mainnet,
+    arbitrum,
+    polygon,
+};
+/** URL path segment per provider + chain. */
+const PROVIDER_URL_TEMPLATES = {
+    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}`,
+    },
+};
+const ENV_URL_VAR = {
+    ethereum: "ETHEREUM_RPC_URL",
+    arbitrum: "ARBITRUM_RPC_URL",
+    polygon: "POLYGON_RPC_URL",
+};
+export class RpcConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "RpcConfigError";
+    }
+}
+/**
+ * Reject RPC URLs that are obviously unsafe to talk to:
+ *  - non-https (http plaintext leaks your wallet query pattern to anything on
+ *    the network path)
+ *  - loopback / private / link-local hosts (RFC1918, 127/8, ::1, *.local).
+ *    Private-range URLs in a shared config are a strong indicator something
+ *    got mis-pasted (e.g. a neighbour's dev box) and we'd rather fail loud
+ *    than exfiltrate wallet addresses to an unexpected host.
+ * Callers who intentionally want to hit a local forked node (anvil, hardhat,
+ * etc.) can opt out with RECON_ALLOW_INSECURE_RPC=1.
+ */
+export function validateRpcUrl(chain, url) {
+    if (process.env.RECON_ALLOW_INSECURE_RPC === "1")
+        return;
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new RpcConfigError(`RPC URL for ${chain} is not a valid URL: ${url}. Fix it via \`recon-crypto-mcp-setup\` or the relevant env var.`);
+    }
+    if (parsed.protocol !== "https:") {
+        throw new RpcConfigError(`RPC URL for ${chain} must use https (got ${parsed.protocol}//). ` +
+            `Plaintext RPCs leak wallet addresses to anyone on the network path. ` +
+            `Set RECON_ALLOW_INSECURE_RPC=1 only if you're pointing at a local anvil/hardhat fork.`);
+    }
+    const host = parsed.hostname.toLowerCase();
+    if (isPrivateOrLoopbackHost(host)) {
+        throw new RpcConfigError(`RPC URL for ${chain} points at a private/loopback host (${host}). ` +
+            `This is almost always a mis-pasted config. ` +
+            `Set RECON_ALLOW_INSECURE_RPC=1 if you intend to hit a local fork.`);
+    }
+}
+export function isPrivateOrLoopbackHost(host) {
+    // Strip IPv6 bracket form. The URL parser can return hostnames like "[::1]"
+    // or "[fe80::1]"; normalise to the bare address for matching.
+    let h = host;
+    if (h.startsWith("[") && h.endsWith("]"))
+        h = h.slice(1, -1);
+    h = h.toLowerCase();
+    if (h === "localhost" || h.endsWith(".local") || h.endsWith(".localhost"))
+        return true;
+    // IPv4 literal.
+    const v4 = h.match(/^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/);
+    if (v4 && isPrivateOrLoopbackIPv4(Number(v4[1]), Number(v4[2]))) {
+        return true;
+    }
+    // IPv4-mapped IPv6, e.g. ::ffff:10.0.0.1 or ::ffff:c0a8:0001.
+    const mapped = h.match(/^::ffff:(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/);
+    if (mapped && isPrivateOrLoopbackIPv4(Number(mapped[1]), Number(mapped[2]))) {
+        return true;
+    }
+    // IPv6 literals. We match on prefix rather than fully parsing the address
+    // because the forms we care about all have a fixed high-order signature:
+    //   ::1             loopback
+    //   fc00::/7        ULA (matches fc.. and fd.. as first hex pair)
+    //   fe80::/10       link-local (fe8., fe9., fea., feb.)
+    //   ::              unspecified
+    if (h === "::1" || h === "::")
+        return true;
+    // Hex-pair prefix — first group before ':' or string end.
+    const firstGroup = h.split(":")[0];
+    if (/^fc[0-9a-f]{0,2}$/.test(firstGroup) || /^fd[0-9a-f]{0,2}$/.test(firstGroup)) {
+        return true;
+    }
+    if (/^fe[89ab][0-9a-f]?$/.test(firstGroup)) {
+        return true;
+    }
+    return false;
+}
+function isPrivateOrLoopbackIPv4(a, b) {
+    if (a === 10)
+        return true;
+    if (a === 127)
+        return true;
+    if (a === 172 && b >= 16 && b <= 31)
+        return true;
+    if (a === 192 && b === 168)
+        return true;
+    if (a === 169 && b === 254)
+        return true; // link-local
+    if (a === 0)
+        return true;
+    return false;
+}
+/**
+ * Resolve the RPC URL for a given chain based on env vars (highest priority)
+ * then the user's ~/.recon-crypto-mcp/config.json.
+ */
+export function resolveRpcUrl(chain, userConfig) {
+    const url = resolveRpcUrlRaw(chain, userConfig);
+    validateRpcUrl(chain, url);
+    return url;
+}
+function resolveRpcUrlRaw(chain, userConfig) {
+    // Env overrides — per-chain full URL beats everything.
+    const envChainUrl = process.env[ENV_URL_VAR[chain]];
+    if (envChainUrl)
+        return envChainUrl;
+    // Env provider + key.
+    const envProvider = process.env.RPC_PROVIDER?.toLowerCase();
+    const envKey = process.env.RPC_API_KEY;
+    if (envProvider && envProvider !== "custom" && envKey) {
+        if (envProvider !== "infura" && envProvider !== "alchemy") {
+            throw new RpcConfigError(`Unknown RPC_PROVIDER: ${envProvider}`);
+        }
+        return PROVIDER_URL_TEMPLATES[envProvider][chain](envKey);
+    }
+    // User config file.
+    if (userConfig) {
+        const { provider, apiKey, customUrls } = userConfig.rpc;
+        if (provider === "custom") {
+            const url = customUrls?.[chain];
+            if (url)
+                return url;
+            throw new RpcConfigError(`No custom RPC URL configured for chain "${chain}". Re-run \`recon-crypto-mcp-setup\`.`);
+        }
+        if (provider === "infura" || provider === "alchemy") {
+            if (!apiKey) {
+                throw new RpcConfigError(`Missing API key for RPC provider "${provider}". Re-run \`recon-crypto-mcp-setup\`.`);
+            }
+            return PROVIDER_URL_TEMPLATES[provider][chain](apiKey);
+        }
+    }
+    throw new RpcConfigError(`No RPC provider configured for chain "${chain}". ` +
+        `Run \`recon-crypto-mcp-setup\` to configure Infura, Alchemy, or a custom endpoint.`);
+}
+//# sourceMappingURL=chains.js.map

package/dist/config/chains.js.map

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

package/dist/config/contracts.d.ts

@@ -0,0 +1,107 @@
+import type { SupportedChain } from "../types/index.js";
+/**
+ * Canonical contract addresses per chain.
+ * Source: Aave V3 deployments, Uniswap V3 deployments, Lido docs, EigenLayer repo.
+ */
+export declare const CONTRACTS: {
+    readonly ethereum: {
+        readonly aave: {
+            readonly poolAddressProvider: "0x2f39d218133AFaB8F2B819B1066c7E434Ad94E9e";
+            readonly uiPoolDataProvider: "0x3F78BBD206e4D3c504Eb854232EdA7e47E9Fd8FC";
+            readonly pool: "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2";
+        };
+        readonly uniswap: {
+            readonly positionManager: "0xC36442b4a4522E871399CD717aBDD847Ab11FE88";
+            readonly factory: "0x1F98431c8aD98523631AE4a59f267346ea31F984";
+        };
+        readonly lido: {
+            readonly stETH: "0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84";
+            readonly wstETH: "0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0";
+            readonly withdrawalQueue: "0x889edC2eDab5f40e902b864aD4d7AdE8E412F9B1";
+        };
+        readonly eigenlayer: {
+            readonly strategyManager: "0x858646372CC42E1A627fcE94aa7A7033e7CF075A";
+            readonly delegationManager: "0x39053D51B77DC0d36036Fc1fCc8Cb819df8Ef37A";
+        };
+        readonly tokens: {
+            readonly USDC: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48";
+            readonly USDT: "0xdAC17F958D2ee523a2206206994597C13D831ec7";
+            readonly DAI: "0x6B175474E89094C44Da98b954EedeAC495271d0F";
+            readonly WETH: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2";
+            readonly WBTC: "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599";
+            readonly LINK: "0x514910771AF9Ca656af840dff83E8264EcF986CA";
+            readonly UNI: "0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984";
+            readonly AAVE: "0x7Fc66500c84A76Ad7e9c93437bFc5Ac33E2DDaE9";
+            readonly LDO: "0x5A98FcBEA516Cf06857215779Fd812CA3beF1B32";
+        };
+        readonly compound: {
+            readonly cUSDCv3: "0xc3d688B66703497DAA19211EEdff47f25384cdc3";
+            readonly cUSDTv3: "0x3Afdc9BCA9213A35503b077a6072F3D0d5AB0840";
+            readonly cWETHv3: "0xA17581A9E3356d9A858b789D68B4d866e593aE94";
+            readonly cwstETHv3: "0x3D0bb1ccaB520A66e607822fC55BC921738fAFE3";
+        };
+        readonly morpho: {
+            /** Morpho Blue singleton on Ethereum. */
+            readonly blue: "0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb";
+        };
+    };
+    readonly arbitrum: {
+        readonly aave: {
+            readonly poolAddressProvider: "0xa97684ead0e402dC232d5A977953DF7ECBaB3CDb";
+            readonly uiPoolDataProvider: "0x5c5228aC8BC1528482514aF3e27E692495148717";
+            readonly pool: "0x794a61358D6845594F94dc1DB02A252b5b4814aD";
+        };
+        readonly uniswap: {
+            readonly positionManager: "0xC36442b4a4522E871399CD717aBDD847Ab11FE88";
+            readonly factory: "0x1F98431c8aD98523631AE4a59f267346ea31F984";
+        };
+        readonly lido: {
+            readonly wstETH: "0x5979D7b546E38E414F7E9822514be443A4800529";
+        };
+        readonly tokens: {
+            readonly USDC: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831";
+            readonly "USDC.e": "0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8";
+            readonly USDT: "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9";
+            readonly DAI: "0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1";
+            readonly WETH: "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1";
+            readonly WBTC: "0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f";
+            readonly LINK: "0xf97f4df75117a78c1A5a0DBb814Af92458539FB4";
+            readonly ARB: "0x912CE59144191C1204E64559FE8253a0e49E6548";
+        };
+        readonly compound: {
+            readonly cUSDCv3: "0x9c4ec768c28520B50860ea7a15bd7213a9fF58bf";
+            readonly "cUSDC.ev3": "0xA5EDBDD9646f8dFF606d7448e414884C7d905dCA";
+            readonly cUSDTv3: "0xd98Be00b5D27fc98112BdE293e487f8D4cA57d07";
+            readonly cWETHv3: "0x6f7D514bbD4aFf3BcD1140B7344b32f063dEe486";
+        };
+    };
+    readonly polygon: {
+        readonly aave: {
+            readonly poolAddressProvider: "0xa97684ead0e402dC232d5A977953DF7ECBaB3CDb";
+            readonly uiPoolDataProvider: "0xC69728f11E9E6127733751c8410432913123acf1";
+            readonly pool: "0x794a61358D6845594F94dc1DB02A252b5b4814aD";
+        };
+        readonly uniswap: {
+            readonly positionManager: "0xC36442b4a4522E871399CD717aBDD847Ab11FE88";
+            readonly factory: "0x1F98431c8aD98523631AE4a59f267346ea31F984";
+        };
+        readonly tokens: {
+            readonly USDC: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359";
+            readonly "USDC.e": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174";
+            readonly USDT: "0xc2132D05D31c914a87C6611C10748AEb04B58e8F";
+            readonly DAI: "0x8f3Cf7ad23Cd3CaDbD9735AFf958023239c6A063";
+            readonly WETH: "0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619";
+            readonly WMATIC: "0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270";
+            readonly WBTC: "0x1BFD67037B42Cf73acF2047067bd4F2C47D9BfD6";
+            readonly LINK: "0x53E0bca35eC356BD5ddDFebbD1Fc0fD03FaBad39";
+            readonly AAVE: "0xD6DF932A45C0f255f85145f286eA0b292B21C90B";
+        };
+        readonly compound: {
+            readonly cUSDCv3: "0xF25212E676D1F7F89Cd72fFEe66158f541246445";
+            readonly "cUSDT.ev3": "0xaeB318360f27748Acb200CE616E389A6C9409a07";
+        };
+    };
+};
+export type ChainContracts<C extends SupportedChain> = (typeof CONTRACTS)[C];
+/** Native asset symbol per chain. */
+export declare const NATIVE_SYMBOL: Record<SupportedChain, string>;

package/dist/config/contracts.js

@@ -0,0 +1,123 @@
+/**
+ * Canonical contract addresses per chain.
+ * Source: Aave V3 deployments, Uniswap V3 deployments, Lido docs, EigenLayer repo.
+ */
+export const CONTRACTS = {
+    ethereum: {
+        aave: {
+            poolAddressProvider: "0x2f39d218133AFaB8F2B819B1066c7E434Ad94E9e",
+            uiPoolDataProvider: "0x3F78BBD206e4D3c504Eb854232EdA7e47E9Fd8FC",
+            // Pinned Pool address used by the pre-sign safety check. Derived from
+            // PoolAddressesProvider.getPool() at deploy time and stable since Aave
+            // V3 launch on this chain. Used in place of a live getPool() read so a
+            // compromised RPC cannot forge a malicious pool into our allowlist.
+            pool: "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2",
+        },
+        uniswap: {
+            positionManager: "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
+            factory: "0x1F98431c8aD98523631AE4a59f267346ea31F984",
+        },
+        lido: {
+            stETH: "0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84",
+            wstETH: "0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0",
+            withdrawalQueue: "0x889edC2eDab5f40e902b864aD4d7AdE8E412F9B1",
+        },
+        eigenlayer: {
+            strategyManager: "0x858646372CC42E1A627fcE94aa7A7033e7CF075A",
+            // EIP-55 checksum: second `f` is lowercase in the canonical form. viem's readContract
+            // re-validates address checksums and will throw InvalidAddressError otherwise.
+            delegationManager: "0x39053D51B77DC0d36036Fc1fCc8Cb819df8Ef37A",
+        },
+        // Common ERC-20 tokens used for portfolio summary.
+        tokens: {
+            USDC: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+            USDT: "0xdAC17F958D2ee523a2206206994597C13D831ec7",
+            DAI: "0x6B175474E89094C44Da98b954EedeAC495271d0F",
+            WETH: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
+            WBTC: "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599",
+            LINK: "0x514910771AF9Ca656af840dff83E8264EcF986CA",
+            UNI: "0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984",
+            AAVE: "0x7Fc66500c84A76Ad7e9c93437bFc5Ac33E2DDaE9",
+            LDO: "0x5A98FcBEA516Cf06857215779Fd812CA3beF1B32",
+        },
+        compound: {
+            cUSDCv3: "0xc3d688B66703497DAA19211EEdff47f25384cdc3",
+            cUSDTv3: "0x3Afdc9BCA9213A35503b077a6072F3D0d5AB0840",
+            cWETHv3: "0xA17581A9E3356d9A858b789D68B4d866e593aE94",
+            cwstETHv3: "0x3D0bb1ccaB520A66e607822fC55BC921738fAFE3",
+        },
+        morpho: {
+            /** Morpho Blue singleton on Ethereum. */
+            blue: "0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb",
+        },
+    },
+    arbitrum: {
+        aave: {
+            poolAddressProvider: "0xa97684ead0e402dC232d5A977953DF7ECBaB3CDb",
+            uiPoolDataProvider: "0x5c5228aC8BC1528482514aF3e27E692495148717",
+            pool: "0x794a61358D6845594F94dc1DB02A252b5b4814aD",
+        },
+        uniswap: {
+            positionManager: "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
+            factory: "0x1F98431c8aD98523631AE4a59f267346ea31F984",
+        },
+        lido: {
+            wstETH: "0x5979D7b546E38E414F7E9822514be443A4800529",
+        },
+        tokens: {
+            USDC: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
+            "USDC.e": "0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8",
+            USDT: "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
+            DAI: "0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1",
+            WETH: "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1",
+            WBTC: "0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f",
+            LINK: "0xf97f4df75117a78c1A5a0DBb814Af92458539FB4",
+            ARB: "0x912CE59144191C1204E64559FE8253a0e49E6548",
+        },
+        compound: {
+            cUSDCv3: "0x9c4ec768c28520B50860ea7a15bd7213a9fF58bf",
+            "cUSDC.ev3": "0xA5EDBDD9646f8dFF606d7448e414884C7d905dCA",
+            cUSDTv3: "0xd98Be00b5D27fc98112BdE293e487f8D4cA57d07",
+            cWETHv3: "0x6f7D514bbD4aFf3BcD1140B7344b32f063dEe486",
+        },
+    },
+    polygon: {
+        aave: {
+            // Aave V3 uses the same PoolAddressesProvider address across most L2s
+            // (deterministic deploy); UiPoolDataProviderV3 is chain-specific.
+            poolAddressProvider: "0xa97684ead0e402dC232d5A977953DF7ECBaB3CDb",
+            uiPoolDataProvider: "0xC69728f11E9E6127733751c8410432913123acf1",
+            pool: "0x794a61358D6845594F94dc1DB02A252b5b4814aD",
+        },
+        uniswap: {
+            positionManager: "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
+            factory: "0x1F98431c8aD98523631AE4a59f267346ea31F984",
+        },
+        // Lido has no native deployment on Polygon (stMATIC is a separate protocol
+        // from a different team); we intentionally omit the `lido` entry so the
+        // staking reader short-circuits for this chain.
+        tokens: {
+            USDC: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
+            "USDC.e": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
+            USDT: "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",
+            DAI: "0x8f3Cf7ad23Cd3CaDbD9735AFf958023239c6A063",
+            WETH: "0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619",
+            WMATIC: "0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270",
+            WBTC: "0x1BFD67037B42Cf73acF2047067bd4F2C47D9BfD6",
+            LINK: "0x53E0bca35eC356BD5ddDFebbD1Fc0fD03FaBad39",
+            AAVE: "0xD6DF932A45C0f255f85145f286eA0b292B21C90B",
+        },
+        compound: {
+            cUSDCv3: "0xF25212E676D1F7F89Cd72fFEe66158f541246445",
+            "cUSDT.ev3": "0xaeB318360f27748Acb200CE616E389A6C9409a07",
+        },
+    },
+};
+/** Native asset symbol per chain. */
+export const NATIVE_SYMBOL = {
+    ethereum: "ETH",
+    arbitrum: "ETH",
+    // Polygon's native token is MATIC (rebranding to POL is in progress — same contract).
+    polygon: "MATIC",
+};
+//# sourceMappingURL=contracts.js.map

package/dist/config/contracts.js.map

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

package/dist/config/user-config.d.ts

@@ -0,0 +1,15 @@
+import type { UserConfig } from "../types/index.js";
+/** Read the user config file; returns null if it doesn't exist. Throws on malformed JSON. */
+export declare function readUserConfig(): UserConfig | null;
+export declare function writeUserConfig(config: UserConfig): void;
+export declare function onRpcConfigChange(hook: () => void): void;
+/** Merge a partial update into the existing config (or create a fresh one). */
+export declare function patchUserConfig(patch: Partial<UserConfig>): UserConfig;
+export declare function getConfigPath(): string;
+export declare function getConfigDir(): string;
+/** Pull the Etherscan API key from env (highest priority) or user config. */
+export declare function resolveEtherscanApiKey(userConfig: UserConfig | null): string | undefined;
+/** Pull the 1inch Developer Portal API key from env or user config; undefined if none set. */
+export declare function resolveOneInchApiKey(userConfig: UserConfig | null): string | undefined;
+/** Pull the WalletConnect project ID from env or user config; undefined if none set. */
+export declare function resolveWalletConnectProjectId(userConfig: UserConfig | null): string | undefined;