recon-crypto-mcp 0.1.0

package/dist/modules/positions/aave.js

@@ -0,0 +1,197 @@
+import { formatUnits, parseUnits, maxUint256 } from "viem";
+import { getClient } from "../../data/rpc.js";
+import { CONTRACTS } from "../../config/contracts.js";
+import { aavePoolAbi, aavePoolAddressProviderAbi } from "../../abis/aave-pool.js";
+import { aaveUiPoolDataProviderAbi } from "../../abis/aave-ui-pool-data-provider.js";
+import { round } from "../../data/format.js";
+const BASE_DECIMALS = 8; // Aave V3 market reference currency (USD) uses 8 decimals.
+const RAY = 10n ** 27n;
+function rayMul(a, b) {
+    return (a * b + RAY / 2n) / RAY;
+}
+/**
+ * Fetch the fully-resolved Aave V3 lending position on a single chain.
+ * Returns null if the user has no Aave activity OR the RPC returned empty data for any of
+ * the required reads (batching mis-handling, rate-limit, transient). The caller treats a
+ * null result as "no position on this chain" — safer than exploding the whole portfolio.
+ */
+export async function getAaveLendingPosition(wallet, chain) {
+    try {
+        return await readAaveLendingPosition(wallet, chain);
+    }
+    catch {
+        return null;
+    }
+}
+async function readAaveLendingPosition(wallet, chain) {
+    const client = getClient(chain);
+    const provider = CONTRACTS[chain].aave.poolAddressProvider;
+    const uiProvider = CONTRACTS[chain].aave.uiPoolDataProvider;
+    // Resolve the current Pool address dynamically.
+    const poolAddr = (await client.readContract({
+        address: provider,
+        abi: aavePoolAddressProviderAbi,
+        functionName: "getPool",
+    }));
+    // Aggregate data (HF, totals, LTV) comes from Pool.getUserAccountData — a stable ABI that
+    // has not changed across Aave V3 upgrades. Per-reserve breakdown relies on the more volatile
+    // UiPoolDataProviderV3 struct, whose shape drifts between chains/versions (stable-rate fields
+    // were removed in 3.2, extra fields added/shifted later). If that decode fails, we keep the
+    // aggregate — the user still gets HF and totals, just without the per-asset split.
+    const account = (await client.readContract({
+        address: poolAddr,
+        abi: aavePoolAbi,
+        functionName: "getUserAccountData",
+        args: [wallet],
+    }));
+    const [totalCollateralBase, totalDebtBase, availableBorrowsBase, currentLiquidationThreshold, ltv, healthFactor] = account;
+    if (totalCollateralBase === 0n && totalDebtBase === 0n)
+        return null;
+    const agg = {
+        totalCollateralBase,
+        totalDebtBase,
+        availableBorrowsBase,
+        currentLiquidationThreshold,
+        ltv,
+        healthFactor,
+    };
+    let userReservesRaw = [];
+    let reservesRaw = [];
+    let baseCurrencyRaw = null;
+    try {
+        const [userReservesResult, reservesResult] = await Promise.all([
+            client.readContract({
+                address: uiProvider,
+                abi: aaveUiPoolDataProviderAbi,
+                functionName: "getUserReservesData",
+                args: [provider, wallet],
+            }),
+            client.readContract({
+                address: uiProvider,
+                abi: aaveUiPoolDataProviderAbi,
+                functionName: "getReservesData",
+                args: [provider],
+            }),
+        ]);
+        [userReservesRaw] = userReservesResult;
+        const [rr, bc] = reservesResult;
+        reservesRaw = rr;
+        baseCurrencyRaw = bc;
+    }
+    catch {
+        // UiPoolDataProvider ABI drift — surface what we have (aggregate only).
+    }
+    const reservesBySymbol = new Map(reservesRaw.map((r) => [r.underlyingAsset.toLowerCase(), r]));
+    const collateral = [];
+    const debt = [];
+    // Skip per-reserve breakdown if the UiPoolDataProvider call failed — aggregate totals above
+    // are still returned.
+    if (!baseCurrencyRaw) {
+        return buildPosition(chain, agg, collateral, debt);
+    }
+    // Unit-of-account price = USD price with `networkBaseTokenPriceDecimals` decimals
+    const usdUnit = 10 ** baseCurrencyRaw.networkBaseTokenPriceDecimals;
+    const marketBase = Number(baseCurrencyRaw.marketReferenceCurrencyUnit);
+    for (const ur of userReservesRaw) {
+        const reserve = reservesBySymbol.get(ur.underlyingAsset.toLowerCase());
+        if (!reserve)
+            continue;
+        const decimals = Number(reserve.decimals);
+        const priceBase = Number(reserve.priceInMarketReferenceCurrency);
+        const tokenPriceUsd = (priceBase / marketBase) * (Number(baseCurrencyRaw.marketReferenceCurrencyPriceInUsd) / usdUnit);
+        // aToken balance (actual) = scaled × liquidityIndex / RAY
+        const aTokenBalance = rayMul(ur.scaledATokenBalance, reserve.liquidityIndex);
+        const variableDebt = rayMul(ur.scaledVariableDebt, reserve.variableBorrowIndex);
+        const stableDebt = ur.principalStableDebt; // approximation; stable is near-zero in practice
+        const totalDebt = variableDebt + stableDebt;
+        if (aTokenBalance > 0n) {
+            const amount = Number(formatUnits(aTokenBalance, decimals));
+            collateral.push({
+                token: ur.underlyingAsset,
+                symbol: reserve.symbol,
+                decimals,
+                amount: aTokenBalance.toString(),
+                formatted: amount.toString(),
+                priceUsd: round(tokenPriceUsd, 6),
+                valueUsd: round(amount * tokenPriceUsd, 2),
+            });
+        }
+        if (totalDebt > 0n) {
+            const amount = Number(formatUnits(totalDebt, decimals));
+            debt.push({
+                token: ur.underlyingAsset,
+                symbol: reserve.symbol,
+                decimals,
+                amount: totalDebt.toString(),
+                formatted: amount.toString(),
+                priceUsd: round(tokenPriceUsd, 6),
+                valueUsd: round(amount * tokenPriceUsd, 2),
+            });
+        }
+    }
+    return buildPosition(chain, agg, collateral, debt);
+}
+function buildPosition(chain, agg, collateral, debt) {
+    const totalCollateralUsd = Number(formatUnits(agg.totalCollateralBase, BASE_DECIMALS));
+    const totalDebtUsd = Number(formatUnits(agg.totalDebtBase, BASE_DECIMALS));
+    // healthFactor returned by Aave is scaled 1e18; cap at a big number if no debt.
+    const hf = agg.totalDebtBase === 0n
+        ? Number.POSITIVE_INFINITY
+        : Number(formatUnits(agg.healthFactor, 18));
+    return {
+        protocol: "aave-v3",
+        chain,
+        collateral,
+        debt,
+        totalCollateralUsd: round(totalCollateralUsd, 2),
+        totalDebtUsd: round(totalDebtUsd, 2),
+        netValueUsd: round(totalCollateralUsd - totalDebtUsd, 2),
+        healthFactor: hf === Number.POSITIVE_INFINITY ? 1e18 : round(hf, 4),
+        liquidationThreshold: Number(agg.currentLiquidationThreshold),
+        ltv: Number(agg.ltv),
+    };
+}
+/**
+ * Simulate a delta to the lending position and return the projected health factor.
+ * We work in USD space: newHF = (newCollateral × liqThreshold) / newDebt.
+ */
+export function simulateHealthFactorChange(base, action, deltaUsd) {
+    let collateral = base.totalCollateralUsd;
+    let debtUsd = base.totalDebtUsd;
+    switch (action) {
+        case "add_collateral":
+            collateral += deltaUsd;
+            break;
+        case "remove_collateral":
+            collateral = Math.max(0, collateral - deltaUsd);
+            break;
+        case "borrow":
+            debtUsd += deltaUsd;
+            break;
+        case "repay":
+            debtUsd = Math.max(0, debtUsd - deltaUsd);
+            break;
+    }
+    const liqThresh = base.liquidationThreshold / 10_000; // bps → fraction
+    const hf = debtUsd === 0
+        ? Number.POSITIVE_INFINITY
+        : (collateral * liqThresh) / debtUsd;
+    return {
+        newHealthFactor: hf === Number.POSITIVE_INFINITY ? 1e18 : round(hf, 4),
+        newCollateralUsd: round(collateral, 2),
+        newDebtUsd: round(debtUsd, 2),
+        safe: hf > 1.0,
+    };
+}
+/** Export a tiny helper for action builders. */
+export async function getAavePoolAddress(chain) {
+    const client = getClient(chain);
+    const provider = CONTRACTS[chain].aave.poolAddressProvider;
+    return (await client.readContract({
+        address: provider,
+        abi: aavePoolAddressProviderAbi,
+        functionName: "getPool",
+    }));
+}
+export { maxUint256, parseUnits };
+//# sourceMappingURL=aave.js.map

package/dist/modules/positions/aave.js.map

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

package/dist/modules/positions/actions.d.ts

@@ -0,0 +1,18 @@
+import { formatUnits } from "viem";
+import type { SupportedChain, UnsignedTx } from "../../types/index.js";
+interface AaveActionParams {
+    wallet: `0x${string}`;
+    chain: SupportedChain;
+    asset: `0x${string}`;
+    amount: string;
+    decimals: number;
+    symbol: string;
+    /** Optional ERC-20 approval cap — see resolveApprovalCap for semantics. */
+    approvalCap?: string;
+}
+declare function parseAmountFriendly(amount: string, decimals: number): bigint;
+export declare function buildAaveSupply(p: AaveActionParams): Promise<UnsignedTx>;
+export declare function buildAaveWithdraw(p: AaveActionParams): Promise<UnsignedTx>;
+export declare function buildAaveBorrow(p: AaveActionParams): Promise<UnsignedTx>;
+export declare function buildAaveRepay(p: AaveActionParams): Promise<UnsignedTx>;
+export { parseAmountFriendly, formatUnits };

package/dist/modules/positions/actions.js

@@ -0,0 +1,205 @@
+import { encodeFunctionData, parseUnits, maxUint256, formatUnits } from "viem";
+import { aavePoolAbi } from "../../abis/aave-pool.js";
+import { erc20Abi } from "../../abis/erc20.js";
+import { getClient } from "../../data/rpc.js";
+import { getAavePoolAddress } from "./aave.js";
+import { buildApprovalTx, resolveApprovalCap } from "../shared/approval.js";
+/**
+ * "Native" pseudo-addresses some UIs pass to mean "the chain's native coin".
+ * Aave V3 Pool does NOT accept these — supply()/repay() expect a real ERC-20.
+ * Native ETH must be wrapped (WETH) first, or routed through Aave's
+ * WrappedTokenGateway contract, which we don't wire up here.
+ */
+const NATIVE_PSEUDOADDRS = new Set([
+    "0x0000000000000000000000000000000000000000",
+    "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
+]);
+function assertNotNativePseudoaddr(asset, op) {
+    if (NATIVE_PSEUDOADDRS.has(asset.toLowerCase())) {
+        throw new Error(`Aave V3 Pool.${op} does not accept the native coin pseudoaddress ${asset}. ` +
+            "Pass the wrapped-token address (e.g. WETH on Ethereum: 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2) " +
+            "instead, or wrap native → WETH in a separate tx first.");
+    }
+}
+function parseAmountFriendly(amount, decimals) {
+    return parseUnits(amount, decimals);
+}
+export async function buildAaveSupply(p) {
+    assertNotNativePseudoaddr(p.asset, "supply");
+    const pool = await getAavePoolAddress(p.chain);
+    const amountWei = parseAmountFriendly(p.amount, p.decimals);
+    const { approvalAmount, display } = resolveApprovalCap(p.approvalCap, amountWei, p.decimals);
+    const approval = await buildApprovalTx({
+        chain: p.chain,
+        wallet: p.wallet,
+        asset: p.asset,
+        spender: pool,
+        amountWei,
+        approvalAmount,
+        approvalDisplay: display,
+        symbol: p.symbol,
+        spenderLabel: "Aave V3 Pool",
+    });
+    const supplyTx = {
+        chain: p.chain,
+        to: pool,
+        data: encodeFunctionData({
+            abi: aavePoolAbi,
+            functionName: "supply",
+            args: [p.asset, amountWei, p.wallet, 0],
+        }),
+        value: "0",
+        from: p.wallet,
+        description: `Supply ${p.amount} ${p.symbol} to Aave V3 on ${p.chain}`,
+        decoded: {
+            functionName: "supply",
+            args: { asset: p.asset, amount: p.amount, onBehalfOf: p.wallet, referralCode: "0" },
+        },
+    };
+    if (approval) {
+        // Walk to the tail of the approval chain (may be reset→approve) and attach supply.
+        let tail = approval;
+        while (tail.next)
+            tail = tail.next;
+        tail.next = supplyTx;
+        return approval;
+    }
+    return supplyTx;
+}
+export async function buildAaveWithdraw(p) {
+    const pool = await getAavePoolAddress(p.chain);
+    // Special case: passing max uint means "withdraw all" in Aave V3.
+    const amountWei = p.amount === "max" ? maxUint256 : parseAmountFriendly(p.amount, p.decimals);
+    return {
+        chain: p.chain,
+        to: pool,
+        data: encodeFunctionData({
+            abi: aavePoolAbi,
+            functionName: "withdraw",
+            args: [p.asset, amountWei, p.wallet],
+        }),
+        value: "0",
+        from: p.wallet,
+        description: `Withdraw ${p.amount === "max" ? "all" : p.amount} ${p.symbol} from Aave V3 on ${p.chain}`,
+        decoded: {
+            functionName: "withdraw",
+            args: { asset: p.asset, amount: p.amount, to: p.wallet },
+        },
+    };
+}
+/** Aave V3 stable-rate borrowing is disabled on all production markets. We only support variable. */
+const VARIABLE_RATE_MODE = 2n;
+export async function buildAaveBorrow(p) {
+    const pool = await getAavePoolAddress(p.chain);
+    const amountWei = parseAmountFriendly(p.amount, p.decimals);
+    return {
+        chain: p.chain,
+        to: pool,
+        data: encodeFunctionData({
+            abi: aavePoolAbi,
+            functionName: "borrow",
+            args: [p.asset, amountWei, VARIABLE_RATE_MODE, 0, p.wallet],
+        }),
+        value: "0",
+        from: p.wallet,
+        description: `Borrow ${p.amount} ${p.symbol} from Aave V3 on ${p.chain} (variable rate)`,
+        decoded: {
+            functionName: "borrow",
+            args: {
+                asset: p.asset,
+                amount: p.amount,
+                rate: "variable",
+                onBehalfOf: p.wallet,
+            },
+        },
+    };
+}
+/**
+ * Look up the user's current variable debt for an asset by querying the
+ * variableDebtToken.balanceOf(wallet). Used for repay-max so we can size an
+ * approval that covers the actual debt (plus a buffer for interest that
+ * accrues between preparing and signing).
+ */
+async function getCurrentVariableDebt(chain, wallet, asset) {
+    const pool = await getAavePoolAddress(chain);
+    const client = getClient(chain);
+    const reserve = (await client.readContract({
+        address: pool,
+        abi: aavePoolAbi,
+        functionName: "getReserveData",
+        args: [asset],
+    }));
+    const variableDebtToken = reserve.variableDebtTokenAddress;
+    const debt = (await client.readContract({
+        address: variableDebtToken,
+        abi: erc20Abi,
+        functionName: "balanceOf",
+        args: [wallet],
+    }));
+    return { debt, variableDebtToken };
+}
+export async function buildAaveRepay(p) {
+    assertNotNativePseudoaddr(p.asset, "repay");
+    const pool = await getAavePoolAddress(p.chain);
+    let amountWei;
+    let neededForApproval;
+    if (p.amount === "max") {
+        amountWei = maxUint256;
+        // Aave caps the repay at the user's actual debt internally, but transferFrom
+        // still needs allowance to cover it. Size the approval to current debt + 1%
+        // buffer so we don't revert because interest accrued between prepare and sign.
+        const { debt } = await getCurrentVariableDebt(p.chain, p.wallet, p.asset);
+        if (debt === 0n) {
+            throw new Error(`No variable-rate debt for ${p.symbol} on Aave V3 ${p.chain} — nothing to repay. ` +
+                "If you borrowed at stable rate historically, repay via the Aave UI (legacy flow).");
+        }
+        neededForApproval = (debt * 101n) / 100n;
+    }
+    else {
+        amountWei = parseAmountFriendly(p.amount, p.decimals);
+        neededForApproval = amountWei;
+    }
+    const { approvalAmount, display } = resolveApprovalCap(p.approvalCap, neededForApproval, p.decimals);
+    const approval = await buildApprovalTx({
+        chain: p.chain,
+        wallet: p.wallet,
+        asset: p.asset,
+        spender: pool,
+        amountWei: neededForApproval,
+        approvalAmount,
+        approvalDisplay: display,
+        symbol: p.symbol,
+        spenderLabel: "Aave V3 Pool",
+    });
+    const repayTx = {
+        chain: p.chain,
+        to: pool,
+        data: encodeFunctionData({
+            abi: aavePoolAbi,
+            functionName: "repay",
+            args: [p.asset, amountWei, VARIABLE_RATE_MODE, p.wallet],
+        }),
+        value: "0",
+        from: p.wallet,
+        description: `Repay ${p.amount === "max" ? "all" : p.amount} ${p.symbol} on Aave V3 ${p.chain} (variable rate)`,
+        decoded: {
+            functionName: "repay",
+            args: {
+                asset: p.asset,
+                amount: p.amount,
+                rate: "variable",
+                onBehalfOf: p.wallet,
+            },
+        },
+    };
+    if (approval) {
+        let tail = approval;
+        while (tail.next)
+            tail = tail.next;
+        tail.next = repayTx;
+        return approval;
+    }
+    return repayTx;
+}
+export { parseAmountFriendly, formatUnits };
+//# sourceMappingURL=actions.js.map

package/dist/modules/positions/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../../src/modules/positions/actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAG5E;;;;;GAKG;AACH,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAS;IACzC,4CAA4C;IAC5C,4CAA4C;CAC7C,CAAC,CAAC;AAEH,SAAS,yBAAyB,CAAC,KAAoB,EAAE,EAAU;IACjE,IAAI,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CACb,gBAAgB,EAAE,kDAAkD,KAAK,IAAI;YAC3E,qGAAqG;YACrG,wDAAwD,CAC3D,CAAC;IACJ,CAAC;AACH,CAAC;AAaD,SAAS,mBAAmB,CAAC,MAAc,EAAE,QAAgB;IAC3D,OAAO,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,CAAmB;IACvD,yBAAyB,CAAC,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,mBAAmB,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC5D,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,kBAAkB,CACpD,CAAC,CAAC,WAAW,EACb,SAAS,EACT,CAAC,CAAC,QAAQ,CACX,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC;QACrC,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,OAAO,EAAE,IAAI;QACb,SAAS;QACT,cAAc;QACd,eAAe,EAAE,OAAO;QACxB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,YAAY,EAAE,cAAc;KAC7B,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAe;QAC3B,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,kBAAkB,CAAC;YACvB,GAAG,EAAE,WAAW;YAChB,YAAY,EAAE,QAAQ;YACtB,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;SACxC,CAAC;QACF,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,CAAC,CAAC,MAAM;QACd,WAAW,EAAE,UAAU,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,kBAAkB,CAAC,CAAC,KAAK,EAAE;QACtE,OAAO,EAAE;YACP,YAAY,EAAE,QAAQ;YACtB,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE;SACpF;KACF,CAAC;IAEF,IAAI,QAAQ,EAAE,CAAC;QACb,mFAAmF;QACnF,IAAI,IAAI,GAAG,QAAQ,CAAC;QACpB,OAAO,IAAI,CAAC,IAAI;YAAE,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC;QACrB,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,CAAmB;IACzD,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/C,kEAAkE;IAClE,MAAM,SAAS,GACb,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9E,OAAO;QACL,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,kBAAkB,CAAC;YACvB,GAAG,EAAE,WAAW;YAChB,YAAY,EAAE,UAAU;YACxB,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;SACrC,CAAC;QACF,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,CAAC,CAAC,MAAM;QACd,WAAW,EAAE,YAAY,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,oBAAoB,CAAC,CAAC,KAAK,EAAE;QACvG,OAAO,EAAE;YACP,YAAY,EAAE,UAAU;YACxB,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;SACzD;KACF,CAAC;AACJ,CAAC;AAED,qGAAqG;AACrG,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAE9B,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,CAAmB;IACvD,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,mBAAmB,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC5D,OAAO;QACL,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,kBAAkB,CAAC;YACvB,GAAG,EAAE,WAAW;YAChB,YAAY,EAAE,QAAQ;YACtB,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;SAC5D,CAAC;QACF,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,CAAC,CAAC,MAAM;QACd,WAAW,EAAE,UAAU,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,oBAAoB,CAAC,CAAC,KAAK,kBAAkB;QACxF,OAAO,EAAE;YACP,YAAY,EAAE,QAAQ;YACtB,IAAI,EAAE;gBACJ,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,IAAI,EAAE,UAAU;gBAChB,UAAU,EAAE,CAAC,CAAC,MAAM;aACrB;SACF;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,sBAAsB,CACnC,KAAqB,EACrB,MAAqB,EACrB,KAAoB;IAEpB,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC;QACzC,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,WAAW;QAChB,YAAY,EAAE,gBAAgB;QAC9B,IAAI,EAAE,CAAC,KAAK,CAAC;KACd,CAAC,CAAgD,CAAC;IACnD,MAAM,iBAAiB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAC3D,MAAM,IAAI,GAAG,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC;QACtC,OAAO,EAAE,iBAAiB;QAC1B,GAAG,EAAE,QAAQ;QACb,YAAY,EAAE,WAAW;QACzB,IAAI,EAAE,CAAC,MAAM,CAAC;KACf,CAAC,CAAW,CAAC;IACd,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,CAAmB;IACtD,yBAAyB,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,SAAiB,CAAC;IACtB,IAAI,iBAAyB,CAAC;IAC9B,IAAI,CAAC,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QACvB,SAAS,GAAG,UAAU,CAAC;QACvB,6EAA6E;QAC7E,4EAA4E;QAC5E,+EAA+E;QAC/E,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,sBAAsB,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;QAC1E,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,6BAA6B,CAAC,CAAC,MAAM,eAAe,CAAC,CAAC,KAAK,uBAAuB;gBAChF,mFAAmF,CACtF,CAAC;QACJ,CAAC;QACD,iBAAiB,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,SAAS,GAAG,mBAAmB,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;QACtD,iBAAiB,GAAG,SAAS,CAAC;IAChC,CAAC;IAED,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,kBAAkB,CACpD,CAAC,CAAC,WAAW,EACb,iBAAiB,EACjB,CAAC,CAAC,QAAQ,CACX,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC;QACrC,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,iBAAiB;QAC5B,cAAc;QACd,eAAe,EAAE,OAAO;QACxB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,YAAY,EAAE,cAAc;KAC7B,CAAC,CAAC;IAEH,MAAM,OAAO,GAAe;QAC1B,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,kBAAkB,CAAC;YACvB,GAAG,EAAE,WAAW;YAChB,YAAY,EAAE,OAAO;YACrB,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,CAAC,MAAM,CAAC;SACzD,CAAC;QACF,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,CAAC,CAAC,MAAM;QACd,WAAW,EAAE,SAAS,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,eAAe,CAAC,CAAC,KAAK,kBAAkB;QAC/G,OAAO,EAAE;YACP,YAAY,EAAE,OAAO;YACrB,IAAI,EAAE;gBACJ,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,IAAI,EAAE,UAAU;gBAChB,UAAU,EAAE,CAAC,CAAC,MAAM;aACrB;SACF;KACF,CAAC;IAEF,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,IAAI,GAAG,QAAQ,CAAC;QACpB,OAAO,IAAI,CAAC,IAAI;YAAE,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;QACpB,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,CAAC"}

package/dist/modules/positions/index.d.ts

@@ -0,0 +1,37 @@
+import type { GetLendingPositionsArgs, GetLpPositionsArgs, GetHealthAlertsArgs, SimulatePositionChangeArgs } from "./schemas.js";
+import type { LendingPosition, LPPosition, SupportedChain } from "../../types/index.js";
+export declare function getLendingPositions(args: GetLendingPositionsArgs): Promise<{
+    wallet: string;
+    positions: LendingPosition[];
+}>;
+export declare function getLpPositions(args: GetLpPositionsArgs): Promise<{
+    wallet: string;
+    positions: LPPosition[];
+}>;
+export declare function getHealthAlerts(args: GetHealthAlertsArgs): Promise<{
+    wallet: string;
+    threshold: number;
+    atRisk: Array<{
+        chain: SupportedChain;
+        healthFactor: number;
+        collateralUsd: number;
+        debtUsd: number;
+        marginToLiquidation: number;
+    }>;
+}>;
+export declare function simulatePositionChange(args: SimulatePositionChangeArgs): Promise<{
+    wallet: string;
+    chain: SupportedChain;
+    action: string;
+    before: {
+        healthFactor: number;
+        collateralUsd: number;
+        debtUsd: number;
+    };
+    after: {
+        healthFactor: number;
+        collateralUsd: number;
+        debtUsd: number;
+        safe: boolean;
+    };
+}>;

package/dist/modules/positions/index.js

@@ -0,0 +1,59 @@
+import { getAaveLendingPosition, simulateHealthFactorChange } from "./aave.js";
+import { getUniswapPositions } from "./uniswap.js";
+import { SUPPORTED_CHAINS } from "../../types/index.js";
+function resolveChains(chains) {
+    return chains ?? [...SUPPORTED_CHAINS];
+}
+export async function getLendingPositions(args) {
+    const wallet = args.wallet;
+    const chains = resolveChains(args.chains);
+    const results = await Promise.all(chains.map((c) => getAaveLendingPosition(wallet, c)));
+    return { wallet, positions: results.filter((p) => p !== null) };
+}
+export async function getLpPositions(args) {
+    const wallet = args.wallet;
+    const chains = resolveChains(args.chains);
+    const perChain = await Promise.all(chains.map((c) => getUniswapPositions(wallet, c)));
+    return { wallet, positions: perChain.flat() };
+}
+export async function getHealthAlerts(args) {
+    const threshold = args.threshold ?? 1.5;
+    const { positions, wallet } = await getLendingPositions({ wallet: args.wallet, chains: undefined });
+    const atRisk = positions
+        .filter((p) => p.healthFactor < threshold && p.totalDebtUsd > 0)
+        .map((p) => ({
+        chain: p.chain,
+        healthFactor: p.healthFactor,
+        collateralUsd: p.totalCollateralUsd,
+        debtUsd: p.totalDebtUsd,
+        // Margin is the % HF would need to drop by to hit 1.0.
+        marginToLiquidation: Math.max(0, Math.round(((p.healthFactor - 1) / p.healthFactor) * 10000) / 100),
+    }));
+    return { wallet, threshold, atRisk };
+}
+export async function simulatePositionChange(args) {
+    const wallet = args.wallet;
+    const chain = (args.chain ?? "ethereum");
+    const base = await getAaveLendingPosition(wallet, chain);
+    if (!base) {
+        throw new Error(`Wallet ${wallet} has no Aave V3 position on ${chain}.`);
+    }
+    const sim = simulateHealthFactorChange(base, args.action, args.amountUsd);
+    return {
+        wallet,
+        chain,
+        action: args.action,
+        before: {
+            healthFactor: base.healthFactor,
+            collateralUsd: base.totalCollateralUsd,
+            debtUsd: base.totalDebtUsd,
+        },
+        after: {
+            healthFactor: sim.newHealthFactor,
+            collateralUsd: sim.newCollateralUsd,
+            debtUsd: sim.newDebtUsd,
+            safe: sim.safe,
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/modules/positions/index.js.map

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

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

@@ -0,0 +1,55 @@
+import { z } from "zod";
+export declare const getLendingPositionsInput: z.ZodObject<{
+    wallet: z.ZodString;
+    chains: z.ZodOptional<z.ZodArray<z.ZodEnum<[string, ...string[]]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    wallet: string;
+    chains?: string[] | undefined;
+}, {
+    wallet: string;
+    chains?: string[] | undefined;
+}>;
+export declare const getLpPositionsInput: z.ZodObject<{
+    wallet: z.ZodString;
+    chains: z.ZodOptional<z.ZodArray<z.ZodEnum<[string, ...string[]]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    wallet: string;
+    chains?: string[] | undefined;
+}, {
+    wallet: string;
+    chains?: string[] | undefined;
+}>;
+export declare const getHealthAlertsInput: z.ZodObject<{
+    wallet: z.ZodString;
+    threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    wallet: string;
+    threshold: number;
+}, {
+    wallet: string;
+    threshold?: number | undefined;
+}>;
+export declare const simulatePositionChangeInput: z.ZodObject<{
+    wallet: z.ZodString;
+    chain: z.ZodDefault<z.ZodOptional<z.ZodEnum<[string, ...string[]]>>>;
+    action: z.ZodEnum<["add_collateral", "remove_collateral", "borrow", "repay"]>;
+    asset: z.ZodString;
+    /** Amount in USD (base currency) — we approximate since asset price lookups are cheap. */
+    amountUsd: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    chain: string;
+    asset: string;
+    wallet: string;
+    action: "borrow" | "repay" | "add_collateral" | "remove_collateral";
+    amountUsd: number;
+}, {
+    asset: string;
+    wallet: string;
+    action: "borrow" | "repay" | "add_collateral" | "remove_collateral";
+    amountUsd: number;
+    chain?: string | undefined;
+}>;
+export type GetLendingPositionsArgs = z.infer<typeof getLendingPositionsInput>;
+export type GetLpPositionsArgs = z.infer<typeof getLpPositionsInput>;
+export type GetHealthAlertsArgs = z.infer<typeof getHealthAlertsInput>;
+export type SimulatePositionChangeArgs = z.infer<typeof simulatePositionChangeInput>;

package/dist/modules/positions/schemas.js

@@ -0,0 +1,25 @@
+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}$/, "must be a 0x-prefixed EVM address");
+export const getLendingPositionsInput = z.object({
+    wallet: walletSchema,
+    chains: z.array(chainEnum).optional(),
+});
+export const getLpPositionsInput = z.object({
+    wallet: walletSchema,
+    chains: z.array(chainEnum).optional(),
+});
+export const getHealthAlertsInput = z.object({
+    wallet: walletSchema,
+    threshold: z.number().min(1).max(10).optional().default(1.5),
+});
+export const simulatePositionChangeInput = z.object({
+    wallet: walletSchema,
+    chain: chainEnum.optional().default("ethereum"),
+    action: z.enum(["add_collateral", "remove_collateral", "borrow", "repay"]),
+    asset: z.string().regex(/^0x[a-fA-F0-9]{40}$/),
+    /** Amount in USD (base currency) — we approximate since asset price lookups are cheap. */
+    amountUsd: z.number().positive(),
+});
+//# sourceMappingURL=schemas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/modules/positions/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,EAAE,mCAAmC,CAAC,CAAC;AAElG,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;CAC7D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC;IAC/C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,mBAAmB,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qBAAqB,CAAC;IAC9C,0FAA0F;IAC1F,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC"}

package/dist/modules/positions/uniswap.d.ts

@@ -0,0 +1,4 @@
+import type { LPPosition, SupportedChain } from "../../types/index.js";
+/** Deterministically compute the Uniswap V3 pool address from (factory, token0, token1, fee). */
+export declare function computePoolAddress(factory: `0x${string}`, tokenA: `0x${string}`, tokenB: `0x${string}`, fee: number): `0x${string}`;
+export declare function getUniswapPositions(wallet: `0x${string}`, chain: SupportedChain): Promise<LPPosition[]>;