agent-treasury 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Clicks Protocol
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,143 @@
+# agent-treasury
+
+Treasury management utilities for AI agents.
+
+Your agent earns USDC. It sits idle. You earn 0%.
+
+`agent-treasury` fixes that. Track balances across chains, compare DeFi yields in real time, get alerts when funds go idle, and activate earning with one call.
+
+## Install
+
+```bash
+npm install agent-treasury ethers
+```
+
+## Quick Start
+
+```ts
+import { AgentTreasury } from "agent-treasury";
+
+const treasury = new AgentTreasury();
+const report = await treasury.report("0xYourAgentWallet");
+console.log(report.recommendation);
+// → "500.00 USDC is idle. Best yield: 4.2% APY (~$21.00/year). Consider activating yield."
+```
+
+## Features
+
+### Balance Tracker
+
+Check USDC balances across Base, Ethereum, Arbitrum, and Optimism in a single call.
+
+```ts
+const balances = await treasury.getBalances("0x...");
+console.log(balances.totalFormatted); // "1250.00"
+console.log(balances.balances);       // per-chain breakdown
+```
+
+### Yield Finder
+
+Compare live supply APY across Aave V3, Compound V3, and Morpho on Base.
+
+```ts
+const yields = await treasury.compareYields();
+console.log(yields.best);
+// → { protocol: "aave-v3", supplyAPY: 4.2, asset: "USDC", chain: "base" }
+```
+
+### Idle Balance Detection
+
+Get alerted when USDC sits idle too long.
+
+```ts
+// One-time check
+const idle = await treasury.getIdleBalance("0x...");
+
+// Continuous monitoring
+treasury.watchIdle("0x...", (alert) => {
+  console.log(`${alert.totalIdleFormatted} USDC idle for ${alert.idleDurationHuman}`);
+});
+```
+
+Configure thresholds:
+
+```ts
+const treasury = new AgentTreasury({
+  idleThresholdUsdc: 50,          // Alert when > 50 USDC
+  idleTimeMs: 30 * 60 * 1000,    // idle for > 30 minutes
+});
+```
+
+### Activate Yield
+
+Put idle USDC to work with one call.
+
+```ts
+import { ClicksActivator } from "agent-treasury";
+
+const clicks = new ClicksActivator();
+const result = await clicks.deposit(signer, "500.00");
+// → Deposits 500 USDC into optimized yield strategy
+```
+
+### Full Report
+
+Get a complete treasury overview: balances, yields, idle status, and recommendations.
+
+```ts
+const report = await treasury.report("0x...");
+// {
+//   balances: { totalFormatted: "500.00", ... },
+//   yields: { best: { protocol: "aave-v3", supplyAPY: 4.2 }, ... },
+//   idleStatus: { idleDurationHuman: "3d 2h", ... },
+//   recommendation: "500.00 USDC is idle. Best yield: 4.2% APY..."
+// }
+```
+
+## Configuration
+
+```ts
+const treasury = new AgentTreasury({
+  // Custom RPC endpoints
+  rpcs: {
+    base: "https://your-base-rpc.com",
+    ethereum: "https://your-eth-rpc.com",
+  },
+  // Track specific chains only
+  chains: ["base", "ethereum"],
+  // Yield protocols to compare
+  protocols: ["aave-v3", "compound-v3"],
+  // Idle detection settings
+  idleThresholdUsdc: 100,
+  idleTimeMs: 60 * 60 * 1000,
+});
+```
+
+## API
+
+| Method | Description |
+|--------|-------------|
+| `getBalances(address)` | Multi-chain USDC balances |
+| `compareYields()` | Compare DeFi APYs on Base |
+| `getBestYield()` | Get highest current APY |
+| `getIdleBalance(address)` | Check if balance is idle |
+| `watchIdle(address, callback)` | Monitor for idle balances |
+| `unwatchIdle(address)` | Stop monitoring |
+| `report(address)` | Full treasury report |
+
+## How It Works
+
+1. **Balance Tracker** reads USDC balances via public RPC on Base, Ethereum, Arbitrum, and Optimism
+2. **Yield Finder** queries Aave V3 and Compound V3 smart contracts on Base for current supply rates
+3. **Idle Detector** compares balance snapshots over time to detect stagnant funds
+4. **Activate** (optional) connects to Clicks Protocol to deposit idle USDC into yield strategies
+
+Balance tracking and yield comparison work entirely standalone. The Clicks integration is an optional feature for agents that want automated yield activation.
+
+## License
+
+MIT
+
+---
+
+Powered by [Clicks Protocol](https://clicksprotocol.xyz)

package/dist/activate.d.ts

@@ -0,0 +1,59 @@
+import { ethers } from "ethers";
+export interface ActivateConfig {
+    /** Custom Clicks Router address (for testnet/custom deployments) */
+    routerAddress?: string;
+    /** Max slippage in basis points (default: 50 = 0.5%) */
+    maxSlippageBps?: number;
+}
+export interface ActivateResult {
+    success: boolean;
+    txHash?: string;
+    sharesReceived?: string;
+    amountDeposited?: string;
+    error?: string;
+}
+export interface YieldPosition {
+    shares: bigint;
+    estimatedValue: string;
+    protocol: string;
+}
+/**
+ * Activate yield on idle USDC via Clicks Protocol.
+ *
+ * This is the optional "earn on idle" feature.
+ * All other agent-treasury features work without it.
+ */
+export declare class ClicksActivator {
+    private routerAddress;
+    private maxSlippageBps;
+    constructor(config?: ActivateConfig);
+    /**
+     * Check if Clicks Protocol is available (contracts deployed).
+     * Returns false if router address is the zero address (pre-launch).
+     */
+    isAvailable(): boolean;
+    /**
+     * Deposit idle USDC into Clicks Protocol yield strategies.
+     *
+     * @param signer - Ethers signer with USDC balance
+     * @param amountUsdc - Amount in USDC (human readable, e.g. "500.00")
+     */
+    deposit(signer: ethers.Signer, amountUsdc: string): Promise<ActivateResult>;
+    /**
+     * Withdraw from Clicks Protocol back to USDC.
+     *
+     * @param signer - Ethers signer that deposited
+     * @param shares - Amount of shares to withdraw
+     */
+    withdraw(signer: ethers.Signer, shares: string): Promise<ActivateResult>;
+    /**
+     * Get current Clicks Protocol position for an address.
+     */
+    getPosition(provider: ethers.Provider, address: string): Promise<YieldPosition | null>;
+    /**
+     * Quick start: one-call yield activation.
+     * Checks balance, finds best yield, deposits via Clicks.
+     */
+    static quickStartMessage(idleAmount: string): string;
+}
+//# sourceMappingURL=activate.d.ts.map

package/dist/activate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activate.d.ts","sourceRoot":"","sources":["../src/activate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAmChC,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,cAAc,CAAS;gBAEnB,MAAM,GAAE,cAAmB;IAKvC;;;OAGG;IACH,WAAW,IAAI,OAAO;IAMtB;;;;;OAKG;IACG,OAAO,CACX,MAAM,EAAE,MAAM,CAAC,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,CAAC;IA0D1B;;;;;OAKG;IACG,QAAQ,CACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC;IAkC1B;;OAEG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAyBhC;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;CAWrD"}

package/dist/activate.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClicksActivator = void 0;
+const ethers_1 = require("ethers");
+/**
+ * Clicks Protocol integration for activating yield on idle USDC.
+ *
+ * This module connects to the Clicks Protocol smart contracts on Base
+ * to deposit idle USDC into optimized yield strategies.
+ *
+ * Clicks Protocol: https://clicksprotocol.xyz
+ */
+// Clicks Protocol contract addresses on Base
+const CLICKS_CONTRACTS = {
+    /** Clicks Router — entry point for deposits */
+    router: "0x0000000000000000000000000000000000000000", // Placeholder until mainnet deploy
+    /** USDC on Base */
+    usdc: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+};
+// ERC-20 approve ABI
+const ERC20_APPROVE_ABI = [
+    "function approve(address spender, uint256 amount) returns (bool)",
+    "function allowance(address owner, address spender) view returns (uint256)",
+];
+// Clicks Router ABI (deposit interface)
+const CLICKS_ROUTER_ABI = [
+    "function deposit(uint256 amount) external returns (uint256 shares)",
+    "function withdraw(uint256 shares) external returns (uint256 amount)",
+    "function balanceOf(address account) view returns (uint256)",
+    "function previewDeposit(uint256 assets) view returns (uint256 shares)",
+    "function previewWithdraw(uint256 shares) view returns (uint256 assets)",
+    "function totalAssets() view returns (uint256)",
+];
+/**
+ * Activate yield on idle USDC via Clicks Protocol.
+ *
+ * This is the optional "earn on idle" feature.
+ * All other agent-treasury features work without it.
+ */
+class ClicksActivator {
+    constructor(config = {}) {
+        this.routerAddress = config.routerAddress ?? CLICKS_CONTRACTS.router;
+        this.maxSlippageBps = config.maxSlippageBps ?? 50;
+    }
+    /**
+     * Check if Clicks Protocol is available (contracts deployed).
+     * Returns false if router address is the zero address (pre-launch).
+     */
+    isAvailable() {
+        return (this.routerAddress !== "0x0000000000000000000000000000000000000000");
+    }
+    /**
+     * Deposit idle USDC into Clicks Protocol yield strategies.
+     *
+     * @param signer - Ethers signer with USDC balance
+     * @param amountUsdc - Amount in USDC (human readable, e.g. "500.00")
+     */
+    async deposit(signer, amountUsdc) {
+        if (!this.isAvailable()) {
+            return {
+                success: false,
+                error: "Clicks Protocol not yet deployed. Visit https://clicksprotocol.xyz for launch updates.",
+            };
+        }
+        try {
+            const amount = ethers_1.ethers.parseUnits(amountUsdc, 6);
+            const signerAddress = await signer.getAddress();
+            // Check and set approval
+            const usdc = new ethers_1.ethers.Contract(CLICKS_CONTRACTS.usdc, ERC20_APPROVE_ABI, signer);
+            const currentAllowance = await usdc.allowance(signerAddress, this.routerAddress);
+            if (currentAllowance < amount) {
+                const approveTx = await usdc.approve(this.routerAddress, amount);
+                await approveTx.wait();
+            }
+            // Deposit into Clicks
+            const router = new ethers_1.ethers.Contract(this.routerAddress, CLICKS_ROUTER_ABI, signer);
+            // Preview expected shares
+            const expectedShares = await router.previewDeposit(amount);
+            const minShares = expectedShares - (expectedShares * BigInt(this.maxSlippageBps)) / 10000n;
+            const tx = await router.deposit(amount);
+            const receipt = await tx.wait();
+            return {
+                success: true,
+                txHash: receipt.hash,
+                sharesReceived: expectedShares.toString(),
+                amountDeposited: amountUsdc,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+    /**
+     * Withdraw from Clicks Protocol back to USDC.
+     *
+     * @param signer - Ethers signer that deposited
+     * @param shares - Amount of shares to withdraw
+     */
+    async withdraw(signer, shares) {
+        if (!this.isAvailable()) {
+            return {
+                success: false,
+                error: "Clicks Protocol not yet deployed.",
+            };
+        }
+        try {
+            const router = new ethers_1.ethers.Contract(this.routerAddress, CLICKS_ROUTER_ABI, signer);
+            const sharesAmount = BigInt(shares);
+            const expectedAmount = await router.previewWithdraw(sharesAmount);
+            const tx = await router.withdraw(sharesAmount);
+            const receipt = await tx.wait();
+            return {
+                success: true,
+                txHash: receipt.hash,
+                amountDeposited: ethers_1.ethers.formatUnits(expectedAmount, 6),
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+    /**
+     * Get current Clicks Protocol position for an address.
+     */
+    async getPosition(provider, address) {
+        if (!this.isAvailable())
+            return null;
+        try {
+            const router = new ethers_1.ethers.Contract(this.routerAddress, CLICKS_ROUTER_ABI, provider);
+            const shares = await router.balanceOf(address);
+            if (shares === 0n)
+                return null;
+            const estimatedAssets = await router.previewWithdraw(shares);
+            return {
+                shares,
+                estimatedValue: ethers_1.ethers.formatUnits(estimatedAssets, 6),
+                protocol: "clicks",
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Quick start: one-call yield activation.
+     * Checks balance, finds best yield, deposits via Clicks.
+     */
+    static quickStartMessage(idleAmount) {
+        return [
+            `💰 You have ${idleAmount} USDC sitting idle.`,
+            ``,
+            `Activate yield with Clicks Protocol:`,
+            `  const clicks = new ClicksActivator();`,
+            `  await clicks.deposit(signer, "${idleAmount}");`,
+            ``,
+            `Learn more: https://clicksprotocol.xyz`,
+        ].join("\n");
+    }
+}
+exports.ClicksActivator = ClicksActivator;
+//# sourceMappingURL=activate.js.map

package/dist/activate.js.map

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

package/dist/balance.d.ts

@@ -0,0 +1,47 @@
+/** USDC contract addresses per chain */
+export declare const USDC_ADDRESSES: Record<string, string>;
+/** Default public RPC endpoints */
+export declare const DEFAULT_RPCS: Record<string, string>;
+export type ChainName = "base" | "ethereum" | "arbitrum" | "optimism";
+export interface ChainBalance {
+    chain: ChainName;
+    balance: bigint;
+    formatted: string;
+    timestamp: number;
+}
+export interface BalanceSnapshot {
+    address: string;
+    balances: ChainBalance[];
+    total: bigint;
+    totalFormatted: string;
+    timestamp: number;
+}
+export interface BalanceHistoryEntry {
+    snapshot: BalanceSnapshot;
+    recordedAt: number;
+}
+export interface BalanceTrackerConfig {
+    /** Override RPC URLs per chain */
+    rpcs?: Partial<Record<ChainName, string>>;
+    /** Which chains to track (default: all) */
+    chains?: ChainName[];
+}
+/**
+ * Multi-chain USDC balance tracker.
+ * Works standalone, no Clicks Protocol dependency.
+ */
+export declare class BalanceTracker {
+    private providers;
+    private chains;
+    private history;
+    constructor(config?: BalanceTrackerConfig);
+    /** Get USDC balance on a single chain */
+    getBalance(address: string, chain: ChainName): Promise<ChainBalance>;
+    /** Get USDC balances across all configured chains */
+    getBalances(address: string): Promise<BalanceSnapshot>;
+    /** Get balance history for an address */
+    getHistory(address: string): BalanceHistoryEntry[];
+    /** Clear history for an address (or all) */
+    clearHistory(address?: string): void;
+}
+//# sourceMappingURL=balance.d.ts.map

package/dist/balance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.d.ts","sourceRoot":"","sources":["../src/balance.ts"],"names":[],"mappings":"AAEA,wCAAwC;AACxC,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKjD,CAAC;AAEF,mCAAmC;AACnC,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAK/C,CAAC;AAKF,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;AAEtE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,eAAe,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,kCAAkC;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1C,2CAA2C;IAC3C,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAqD;IACtE,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAAiD;gBAEpD,MAAM,GAAE,oBAAyB;IAS7C,yCAAyC;IACnC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC;IAgB1E,qDAAqD;IAC/C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA+B5D,yCAAyC;IACzC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAIlD,4CAA4C;IAC5C,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;CAOrC"}

package/dist/balance.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BalanceTracker = exports.DEFAULT_RPCS = exports.USDC_ADDRESSES = void 0;
+const ethers_1 = require("ethers");
+/** USDC contract addresses per chain */
+exports.USDC_ADDRESSES = {
+    base: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+    ethereum: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+    arbitrum: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
+    optimism: "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
+};
+/** Default public RPC endpoints */
+exports.DEFAULT_RPCS = {
+    base: "https://mainnet.base.org",
+    ethereum: "https://eth.llamarpc.com",
+    arbitrum: "https://arb1.arbitrum.io/rpc",
+    optimism: "https://mainnet.optimism.io",
+};
+/** ERC-20 balanceOf ABI fragment */
+const ERC20_ABI = ["function balanceOf(address) view returns (uint256)"];
+/**
+ * Multi-chain USDC balance tracker.
+ * Works standalone, no Clicks Protocol dependency.
+ */
+class BalanceTracker {
+    constructor(config = {}) {
+        this.providers = new Map();
+        this.history = new Map();
+        this.chains = config.chains ?? Object.keys(exports.USDC_ADDRESSES);
+        for (const chain of this.chains) {
+            const rpcUrl = config.rpcs?.[chain] ?? exports.DEFAULT_RPCS[chain];
+            this.providers.set(chain, new ethers_1.ethers.JsonRpcProvider(rpcUrl));
+        }
+    }
+    /** Get USDC balance on a single chain */
+    async getBalance(address, chain) {
+        const provider = this.providers.get(chain);
+        if (!provider)
+            throw new Error(`Chain "${chain}" not configured`);
+        const usdcAddress = exports.USDC_ADDRESSES[chain];
+        const contract = new ethers_1.ethers.Contract(usdcAddress, ERC20_ABI, provider);
+        const balance = await contract.balanceOf(address);
+        return {
+            chain,
+            balance,
+            formatted: ethers_1.ethers.formatUnits(balance, 6),
+            timestamp: Date.now(),
+        };
+    }
+    /** Get USDC balances across all configured chains */
+    async getBalances(address) {
+        const results = await Promise.allSettled(this.chains.map((chain) => this.getBalance(address, chain)));
+        const balances = [];
+        for (const result of results) {
+            if (result.status === "fulfilled") {
+                balances.push(result.value);
+            }
+        }
+        const total = balances.reduce((sum, b) => sum + b.balance, 0n);
+        const snapshot = {
+            address,
+            balances,
+            total,
+            totalFormatted: ethers_1.ethers.formatUnits(total, 6),
+            timestamp: Date.now(),
+        };
+        // Store in history
+        const existing = this.history.get(address) ?? [];
+        existing.push({ snapshot, recordedAt: Date.now() });
+        // Keep last 1000 entries per address
+        if (existing.length > 1000)
+            existing.shift();
+        this.history.set(address, existing);
+        return snapshot;
+    }
+    /** Get balance history for an address */
+    getHistory(address) {
+        return this.history.get(address) ?? [];
+    }
+    /** Clear history for an address (or all) */
+    clearHistory(address) {
+        if (address) {
+            this.history.delete(address);
+        }
+        else {
+            this.history.clear();
+        }
+    }
+}
+exports.BalanceTracker = BalanceTracker;
+//# sourceMappingURL=balance.js.map

package/dist/balance.js.map

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

package/dist/idle-detector.d.ts

@@ -0,0 +1,45 @@
+import { BalanceTracker, BalanceTrackerConfig, ChainName } from "./balance";
+export interface IdleBalanceAlert {
+    address: string;
+    totalIdle: bigint;
+    totalIdleFormatted: string;
+    idleSince: number;
+    idleDurationMs: number;
+    idleDurationHuman: string;
+    chains: ChainName[];
+}
+export type IdleCallback = (alert: IdleBalanceAlert) => void | Promise<void>;
+export interface IdleDetectorConfig extends BalanceTrackerConfig {
+    /** Minimum balance in USDC (raw 6-decimal) to consider "idle" (default: 100 USDC) */
+    thresholdUsdc?: number;
+    /** How long balance must be idle before alerting, in ms (default: 1 hour) */
+    idleTimeMs?: number;
+    /** Polling interval in ms (default: 5 minutes) */
+    pollIntervalMs?: number;
+}
+/**
+ * Detects idle USDC balances and triggers alerts.
+ * Works standalone, no Clicks Protocol dependency.
+ */
+export declare class IdleDetector {
+    private tracker;
+    private thresholdRaw;
+    private idleTimeMs;
+    private pollIntervalMs;
+    private watched;
+    private timers;
+    constructor(config?: IdleDetectorConfig);
+    /** Start watching an address for idle balances */
+    watch(address: string, callback: IdleCallback): void;
+    /** Stop watching an address */
+    unwatch(address: string): void;
+    /** Stop watching all addresses */
+    unwatchAll(): void;
+    /** Check an address once (can be called manually) */
+    checkOnce(address: string): Promise<IdleBalanceAlert | null>;
+    /** Get the underlying balance tracker */
+    getTracker(): BalanceTracker;
+    private checkAddress;
+    private evaluateSnapshot;
+}
+//# sourceMappingURL=idle-detector.d.ts.map

package/dist/idle-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle-detector.d.ts","sourceRoot":"","sources":["../src/idle-detector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAmB,oBAAoB,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE7F,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE7E,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,qFAAqF;IACrF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAoBD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,OAAO,CAA0C;IACzD,OAAO,CAAC,MAAM,CAA0D;gBAE5D,MAAM,GAAE,kBAAuB;IAS3C,kDAAkD;IAClD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAoBpD,+BAA+B;IAC/B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAS9B,kCAAkC;IAClC,UAAU,IAAI,IAAI;IAMlB,qDAAqD;IAC/C,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAKlE,yCAAyC;IACzC,UAAU,IAAI,cAAc;YAId,YAAY;IAiC1B,OAAO,CAAC,gBAAgB;CAwBzB"}

package/dist/idle-detector.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IdleDetector = void 0;
+const balance_1 = require("./balance");
+function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    if (seconds < 60)
+        return `${seconds}s`;
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours}h ${minutes % 60}m`;
+    const days = Math.floor(hours / 24);
+    return `${days}d ${hours % 24}h`;
+}
+/**
+ * Detects idle USDC balances and triggers alerts.
+ * Works standalone, no Clicks Protocol dependency.
+ */
+class IdleDetector {
+    constructor(config = {}) {
+        this.watched = new Map();
+        this.timers = new Map();
+        this.tracker = new balance_1.BalanceTracker(config);
+        // Convert USDC threshold to 6-decimal raw
+        const thresholdUsdc = config.thresholdUsdc ?? 100;
+        this.thresholdRaw = BigInt(Math.floor(thresholdUsdc * 1e6));
+        this.idleTimeMs = config.idleTimeMs ?? 60 * 60 * 1000; // 1 hour
+        this.pollIntervalMs = config.pollIntervalMs ?? 5 * 60 * 1000; // 5 min
+    }
+    /** Start watching an address for idle balances */
+    watch(address, callback) {
+        if (this.watched.has(address)) {
+            this.unwatch(address);
+        }
+        const tracked = {
+            address,
+            lastChangeAt: Date.now(),
+            lastBalance: 0n,
+            callback,
+        };
+        this.watched.set(address, tracked);
+        // Initial check + start polling
+        this.checkAddress(tracked);
+        const timer = setInterval(() => this.checkAddress(tracked), this.pollIntervalMs);
+        this.timers.set(address, timer);
+    }
+    /** Stop watching an address */
+    unwatch(address) {
+        this.watched.delete(address);
+        const timer = this.timers.get(address);
+        if (timer) {
+            clearInterval(timer);
+            this.timers.delete(address);
+        }
+    }
+    /** Stop watching all addresses */
+    unwatchAll() {
+        for (const address of this.watched.keys()) {
+            this.unwatch(address);
+        }
+    }
+    /** Check an address once (can be called manually) */
+    async checkOnce(address) {
+        const snapshot = await this.tracker.getBalances(address);
+        return this.evaluateSnapshot(address, snapshot);
+    }
+    /** Get the underlying balance tracker */
+    getTracker() {
+        return this.tracker;
+    }
+    async checkAddress(tracked) {
+        try {
+            const snapshot = await this.tracker.getBalances(tracked.address);
+            // Check if balance changed
+            if (snapshot.total !== tracked.lastBalance) {
+                tracked.lastBalance = snapshot.total;
+                tracked.lastChangeAt = Date.now();
+                return; // Balance changed, reset idle timer
+            }
+            // Balance unchanged, check if idle long enough
+            const idleDuration = Date.now() - tracked.lastChangeAt;
+            if (snapshot.total >= this.thresholdRaw && idleDuration >= this.idleTimeMs) {
+                const alert = {
+                    address: tracked.address,
+                    totalIdle: snapshot.total,
+                    totalIdleFormatted: snapshot.totalFormatted,
+                    idleSince: tracked.lastChangeAt,
+                    idleDurationMs: idleDuration,
+                    idleDurationHuman: formatDuration(idleDuration),
+                    chains: snapshot.balances
+                        .filter((b) => b.balance > 0n)
+                        .map((b) => b.chain),
+                };
+                await tracked.callback(alert);
+            }
+        }
+        catch {
+            // Silently skip failed checks — network issues are transient
+        }
+    }
+    evaluateSnapshot(address, snapshot) {
+        const tracked = this.watched.get(address);
+        const lastChangeAt = tracked?.lastChangeAt ?? Date.now();
+        const idleDuration = Date.now() - lastChangeAt;
+        if (snapshot.total >= this.thresholdRaw) {
+            return {
+                address,
+                totalIdle: snapshot.total,
+                totalIdleFormatted: snapshot.totalFormatted,
+                idleSince: lastChangeAt,
+                idleDurationMs: idleDuration,
+                idleDurationHuman: formatDuration(idleDuration),
+                chains: snapshot.balances
+                    .filter((b) => b.balance > 0n)
+                    .map((b) => b.chain),
+            };
+        }
+        return null;
+    }
+}
+exports.IdleDetector = IdleDetector;
+//# sourceMappingURL=idle-detector.js.map

package/dist/idle-detector.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,76 @@
+export { BalanceTracker, USDC_ADDRESSES, DEFAULT_RPCS, type ChainName, type ChainBalance, type BalanceSnapshot, type BalanceHistoryEntry, type BalanceTrackerConfig, } from "./balance";
+export { YieldFinder, type Protocol, type YieldRate, type YieldComparison, type YieldHistoryEntry, type YieldFinderConfig, } from "./yield-finder";
+export { IdleDetector, type IdleBalanceAlert, type IdleCallback, type IdleDetectorConfig, } from "./idle-detector";
+export { ClicksActivator, type ActivateConfig, type ActivateResult, type YieldPosition, } from "./activate";
+import { BalanceTracker, type ChainName } from "./balance";
+import { YieldFinder } from "./yield-finder";
+import { IdleDetector, type IdleCallback } from "./idle-detector";
+import { ClicksActivator } from "./activate";
+import { ethers } from "ethers";
+export interface AgentTreasuryConfig {
+    /** Base RPC URL override */
+    rpcUrl?: string;
+    /** Override RPC URLs per chain */
+    rpcs?: Partial<Record<ChainName, string>>;
+    /** Which chains to track (default: all) */
+    chains?: ChainName[];
+    /** Yield finder protocols */
+    protocols?: ("aave-v3" | "morpho" | "compound-v3")[];
+    /** Idle detection: minimum USDC to alert (default: 100) */
+    idleThresholdUsdc?: number;
+    /** Idle detection: time before alert in ms (default: 1 hour) */
+    idleTimeMs?: number;
+    /** Clicks Protocol router address override */
+    clicksRouterAddress?: string;
+}
+/**
+ * AgentTreasury — unified treasury management for AI agents.
+ *
+ * Track balances, compare yields, detect idle funds, and optionally
+ * activate yield via Clicks Protocol.
+ *
+ * @example
+ * ```ts
+ * import { AgentTreasury } from "agent-treasury";
+ *
+ * const treasury = new AgentTreasury();
+ * const balances = await treasury.getBalances("0x...");
+ * const yields = await treasury.compareYields();
+ * const idle = await treasury.getIdleBalance("0x...");
+ * ```
+ */
+export declare class AgentTreasury {
+    readonly balance: BalanceTracker;
+    readonly yields: YieldFinder;
+    readonly idle: IdleDetector;
+    readonly clicks: ClicksActivator;
+    constructor(config?: AgentTreasuryConfig);
+    /** Get USDC balances across all chains */
+    getBalances(address: string): Promise<import("./balance").BalanceSnapshot>;
+    /** Get idle balance info for an address */
+    getIdleBalance(address: string): Promise<import("./idle-detector").IdleBalanceAlert | null>;
+    /** Compare current DeFi yields on Base */
+    compareYields(): Promise<import("./yield-finder").YieldComparison>;
+    /** Get the best available yield */
+    getBestYield(): Promise<import("./yield-finder").YieldRate | null>;
+    /** Watch an address for idle balances */
+    watchIdle(address: string, callback: IdleCallback): void;
+    /** Stop watching an address */
+    unwatchIdle(address: string): void;
+    /** Stop all idle watchers */
+    stopAll(): void;
+    /**
+     * Full treasury report: balances + yields + idle status + Clicks position.
+     */
+    report(address: string, provider?: ethers.Provider): Promise<{
+        address: string;
+        balances: import("./balance").BalanceSnapshot;
+        yields: import("./yield-finder").YieldComparison;
+        idleStatus: import("./idle-detector").IdleBalanceAlert | null;
+        clicksPosition: import("./activate").YieldPosition | null;
+        recommendation: string;
+        generatedAt: number;
+    }>;
+    private getRecommendation;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,cAAc,EACd,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,WAAW,EACX,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAA6B,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AACtF,OAAO,EAAE,WAAW,EAA0B,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,YAAY,EAA2B,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAuB,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,WAAW,mBAAmB;IAClC,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1C,2CAA2C;IAC3C,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,CAAC,SAAS,GAAG,QAAQ,GAAG,aAAa,CAAC,EAAE,CAAC;IACrD,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAa;IACxB,SAAgB,OAAO,EAAE,cAAc,CAAC;IACxC,SAAgB,MAAM,EAAE,WAAW,CAAC;IACpC,SAAgB,IAAI,EAAE,YAAY,CAAC;IACnC,SAAgB,MAAM,EAAE,eAAe,CAAC;gBAE5B,MAAM,GAAE,mBAAwB;IA6B5C,0CAA0C;IACpC,WAAW,CAAC,OAAO,EAAE,MAAM;IAIjC,2CAA2C;IACrC,cAAc,CAAC,OAAO,EAAE,MAAM;IAIpC,0CAA0C;IACpC,aAAa;IAInB,mCAAmC;IAC7B,YAAY;IAIlB,yCAAyC;IACzC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY;IAIjD,+BAA+B;IAC/B,WAAW,CAAC,OAAO,EAAE,MAAM;IAI3B,6BAA6B;IAC7B,OAAO;IAIP;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ;;;;;;;;;IAsBxD,OAAO,CAAC,iBAAiB;CAa1B"}

package/dist/index.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentTreasury = exports.ClicksActivator = exports.IdleDetector = exports.YieldFinder = exports.DEFAULT_RPCS = exports.USDC_ADDRESSES = exports.BalanceTracker = void 0;
+var balance_1 = require("./balance");
+Object.defineProperty(exports, "BalanceTracker", { enumerable: true, get: function () { return balance_1.BalanceTracker; } });
+Object.defineProperty(exports, "USDC_ADDRESSES", { enumerable: true, get: function () { return balance_1.USDC_ADDRESSES; } });
+Object.defineProperty(exports, "DEFAULT_RPCS", { enumerable: true, get: function () { return balance_1.DEFAULT_RPCS; } });
+var yield_finder_1 = require("./yield-finder");
+Object.defineProperty(exports, "YieldFinder", { enumerable: true, get: function () { return yield_finder_1.YieldFinder; } });
+var idle_detector_1 = require("./idle-detector");
+Object.defineProperty(exports, "IdleDetector", { enumerable: true, get: function () { return idle_detector_1.IdleDetector; } });
+var activate_1 = require("./activate");
+Object.defineProperty(exports, "ClicksActivator", { enumerable: true, get: function () { return activate_1.ClicksActivator; } });
+const balance_2 = require("./balance");
+const yield_finder_2 = require("./yield-finder");
+const idle_detector_2 = require("./idle-detector");
+const activate_2 = require("./activate");
+/**
+ * AgentTreasury — unified treasury management for AI agents.
+ *
+ * Track balances, compare yields, detect idle funds, and optionally
+ * activate yield via Clicks Protocol.
+ *
+ * @example
+ * ```ts
+ * import { AgentTreasury } from "agent-treasury";
+ *
+ * const treasury = new AgentTreasury();
+ * const balances = await treasury.getBalances("0x...");
+ * const yields = await treasury.compareYields();
+ * const idle = await treasury.getIdleBalance("0x...");
+ * ```
+ */
+class AgentTreasury {
+    constructor(config = {}) {
+        const balanceConfig = {
+            rpcs: config.rpcs,
+            chains: config.chains,
+        };
+        const yieldConfig = {
+            rpcUrl: config.rpcUrl ?? config.rpcs?.base,
+            protocols: config.protocols,
+        };
+        const idleConfig = {
+            ...balanceConfig,
+            thresholdUsdc: config.idleThresholdUsdc,
+            idleTimeMs: config.idleTimeMs,
+        };
+        const activateConfig = {
+            routerAddress: config.clicksRouterAddress,
+        };
+        this.balance = new balance_2.BalanceTracker(balanceConfig);
+        this.yields = new yield_finder_2.YieldFinder(yieldConfig);
+        this.idle = new idle_detector_2.IdleDetector(idleConfig);
+        this.clicks = new activate_2.ClicksActivator(activateConfig);
+    }
+    // ── Convenience methods ──────────────────────────────────────────
+    /** Get USDC balances across all chains */
+    async getBalances(address) {
+        return this.balance.getBalances(address);
+    }
+    /** Get idle balance info for an address */
+    async getIdleBalance(address) {
+        return this.idle.checkOnce(address);
+    }
+    /** Compare current DeFi yields on Base */
+    async compareYields() {
+        return this.yields.compareYields();
+    }
+    /** Get the best available yield */
+    async getBestYield() {
+        return this.yields.getBestYield();
+    }
+    /** Watch an address for idle balances */
+    watchIdle(address, callback) {
+        this.idle.watch(address, callback);
+    }
+    /** Stop watching an address */
+    unwatchIdle(address) {
+        this.idle.unwatch(address);
+    }
+    /** Stop all idle watchers */
+    stopAll() {
+        this.idle.unwatchAll();
+    }
+    /**
+     * Full treasury report: balances + yields + idle status + Clicks position.
+     */
+    async report(address, provider) {
+        const [balances, yields, idleStatus] = await Promise.all([
+            this.getBalances(address),
+            this.compareYields(),
+            this.getIdleBalance(address),
+        ]);
+        const clicksPosition = provider
+            ? await this.clicks.getPosition(provider, address)
+            : null;
+        return {
+            address,
+            balances,
+            yields,
+            idleStatus,
+            clicksPosition,
+            recommendation: this.getRecommendation(balances.totalFormatted, yields.best?.supplyAPY ?? 0, idleStatus !== null),
+            generatedAt: Date.now(),
+        };
+    }
+    getRecommendation(totalUsdc, bestApy, isIdle) {
+        const amount = parseFloat(totalUsdc);
+        if (amount === 0)
+            return "No USDC balance detected.";
+        if (!isIdle)
+            return `Balance of ${totalUsdc} USDC is active.`;
+        if (bestApy === 0)
+            return `${totalUsdc} USDC is idle. Yield data unavailable.`;
+        const yearlyEarning = (amount * bestApy) / 100;
+        return `${totalUsdc} USDC is idle. Best yield: ${bestApy}% APY (~$${yearlyEarning.toFixed(2)}/year). Consider activating yield.`;
+    }
+}
+exports.AgentTreasury = AgentTreasury;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/yield-finder.d.ts

@@ -0,0 +1,47 @@
+/** Supported yield protocols on Base */
+export type Protocol = "aave-v3" | "morpho" | "compound-v3";
+export interface YieldRate {
+    protocol: Protocol;
+    asset: string;
+    chain: string;
+    supplyAPY: number;
+    timestamp: number;
+}
+export interface YieldComparison {
+    rates: YieldRate[];
+    best: YieldRate | null;
+    fetchedAt: number;
+}
+export interface YieldHistoryEntry {
+    comparison: YieldComparison;
+    recordedAt: number;
+}
+export interface YieldFinderConfig {
+    /** Base RPC URL override */
+    rpcUrl?: string;
+    /** Which protocols to check (default: all) */
+    protocols?: Protocol[];
+}
+/**
+ * Compare DeFi yields for USDC on Base.
+ * Works standalone, no Clicks Protocol dependency.
+ */
+export declare class YieldFinder {
+    private provider;
+    private protocols;
+    private history;
+    constructor(config?: YieldFinderConfig);
+    /** Fetch Aave V3 USDC supply APY on Base */
+    private getAaveRate;
+    /** Fetch Compound V3 USDC supply APY on Base */
+    private getCompoundRate;
+    /** Fetch Morpho USDC supply APY on Base (simplified) */
+    private getMorphoRate;
+    /** Compare yields across configured protocols */
+    compareYields(): Promise<YieldComparison>;
+    /** Get the best current yield */
+    getBestYield(): Promise<YieldRate | null>;
+    /** Get historical yield comparisons */
+    getHistory(): YieldHistoryEntry[];
+}
+//# sourceMappingURL=yield-finder.d.ts.map

package/dist/yield-finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yield-finder.d.ts","sourceRoot":"","sources":["../src/yield-finder.ts"],"names":[],"mappings":"AAEA,wCAAwC;AACxC,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,CAAC;AAE5D,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,eAAe,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAkCD,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,OAAO,CAA2B;gBAE9B,MAAM,GAAE,iBAAsB;IAO1C,4CAA4C;YAC9B,WAAW;IA+BzB,gDAAgD;YAClC,eAAe;IA8B7B,wDAAwD;YAC1C,aAAa;IAa3B,iDAAiD;IAC3C,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC;IAkC/C,iCAAiC;IAC3B,YAAY,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAK/C,uCAAuC;IACvC,UAAU,IAAI,iBAAiB,EAAE;CAGlC"}

package/dist/yield-finder.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.YieldFinder = void 0;
+const ethers_1 = require("ethers");
+// On-chain contract addresses on Base for reading supply rates
+const PROTOCOL_CONTRACTS = {
+    "aave-v3": {
+        // Aave V3 Pool on Base — getReserveData returns supply rate
+        address: "0xA238Dd80C259a72e81d7e4664a9801593F98d1c5",
+        abi: [
+            "function getReserveData(address asset) view returns (uint256 configuration, uint128 liquidityIndex, uint128 currentLiquidityRate, uint128 variableBorrowIndex, uint128 currentVariableBorrowRate, uint128 currentStableBorrowRate, uint40 lastUpdateTimestamp, uint16 id, address aTokenAddress, address stableDebtTokenAddress, address variableDebtTokenAddress, address interestRateStrategyAddress, uint128 accruedToTreasury, uint128 unbacked, uint128 isolationModeTotalDebt)",
+        ],
+    },
+    "morpho": {
+        // Morpho Blue on Base
+        address: "0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb",
+        abi: [
+            "function market(bytes32 id) view returns (uint128 totalSupplyAssets, uint128 totalSupplyShares, uint128 totalBorrowAssets, uint128 totalBorrowShares, uint128 lastUpdate, uint128 fee)",
+        ],
+    },
+    "compound-v3": {
+        // Compound V3 (Comet) USDC on Base
+        address: "0xb125E6687d4313864e53df431d5425969c15Eb2F",
+        abi: [
+            "function getSupplyRate(uint256 utilization) view returns (uint64)",
+            "function getUtilization() view returns (uint256)",
+        ],
+    },
+};
+const USDC_BASE = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+// Ray = 1e27 (Aave rate precision)
+const RAY = 10n ** 27n;
+const SECONDS_PER_YEAR = 31536000;
+/**
+ * Compare DeFi yields for USDC on Base.
+ * Works standalone, no Clicks Protocol dependency.
+ */
+class YieldFinder {
+    constructor(config = {}) {
+        this.history = [];
+        this.provider = new ethers_1.ethers.JsonRpcProvider(config.rpcUrl ?? "https://mainnet.base.org");
+        this.protocols = config.protocols ?? ["aave-v3", "compound-v3"];
+    }
+    /** Fetch Aave V3 USDC supply APY on Base */
+    async getAaveRate() {
+        const { address, abi } = PROTOCOL_CONTRACTS["aave-v3"];
+        const contract = new ethers_1.ethers.Contract(address, abi, this.provider);
+        try {
+            const data = await contract.getReserveData(USDC_BASE);
+            // currentLiquidityRate is at index 2, in RAY (1e27)
+            const liquidityRate = BigInt(data[2]);
+            // APY = ((1 + rate/secondsPerYear)^secondsPerYear - 1) * 100
+            // Simplified: APY ≈ rate * 100 / RAY (for display purposes)
+            const apyPercent = Number((liquidityRate * 10000n) / RAY) / 100;
+            return {
+                protocol: "aave-v3",
+                asset: "USDC",
+                chain: "base",
+                supplyAPY: apyPercent,
+                timestamp: Date.now(),
+            };
+        }
+        catch {
+            return {
+                protocol: "aave-v3",
+                asset: "USDC",
+                chain: "base",
+                supplyAPY: 0,
+                timestamp: Date.now(),
+            };
+        }
+    }
+    /** Fetch Compound V3 USDC supply APY on Base */
+    async getCompoundRate() {
+        const { address, abi } = PROTOCOL_CONTRACTS["compound-v3"];
+        const contract = new ethers_1.ethers.Contract(address, abi, this.provider);
+        try {
+            const utilization = await contract.getUtilization();
+            const supplyRatePerSecond = await contract.getSupplyRate(utilization);
+            // Compound rate is per-second, scaled by 1e18
+            // APY = (1 + ratePerSecond)^secondsPerYear - 1
+            const ratePerSecond = Number(supplyRatePerSecond) / 1e18;
+            const apy = (Math.pow(1 + ratePerSecond, SECONDS_PER_YEAR) - 1) * 100;
+            return {
+                protocol: "compound-v3",
+                asset: "USDC",
+                chain: "base",
+                supplyAPY: Math.round(apy * 100) / 100,
+                timestamp: Date.now(),
+            };
+        }
+        catch {
+            return {
+                protocol: "compound-v3",
+                asset: "USDC",
+                chain: "base",
+                supplyAPY: 0,
+                timestamp: Date.now(),
+            };
+        }
+    }
+    /** Fetch Morpho USDC supply APY on Base (simplified) */
+    async getMorphoRate() {
+        // Morpho Blue uses market IDs; the USDC/WETH market is common
+        // For simplicity, we estimate from utilization
+        // In production, you'd query specific market IDs
+        return {
+            protocol: "morpho",
+            asset: "USDC",
+            chain: "base",
+            supplyAPY: 0, // Requires market ID — set to 0 if unavailable
+            timestamp: Date.now(),
+        };
+    }
+    /** Compare yields across configured protocols */
+    async compareYields() {
+        const fetchers = {
+            "aave-v3": () => this.getAaveRate(),
+            "morpho": () => this.getMorphoRate(),
+            "compound-v3": () => this.getCompoundRate(),
+        };
+        const results = await Promise.allSettled(this.protocols.map((p) => fetchers[p]()));
+        const rates = [];
+        for (const result of results) {
+            if (result.status === "fulfilled") {
+                rates.push(result.value);
+            }
+        }
+        // Sort descending by APY
+        rates.sort((a, b) => b.supplyAPY - a.supplyAPY);
+        const comparison = {
+            rates,
+            best: rates.length > 0 ? rates[0] : null,
+            fetchedAt: Date.now(),
+        };
+        // Store history
+        this.history.push({ comparison, recordedAt: Date.now() });
+        if (this.history.length > 500)
+            this.history.shift();
+        return comparison;
+    }
+    /** Get the best current yield */
+    async getBestYield() {
+        const comparison = await this.compareYields();
+        return comparison.best;
+    }
+    /** Get historical yield comparisons */
+    getHistory() {
+        return [...this.history];
+    }
+}
+exports.YieldFinder = YieldFinder;
+//# sourceMappingURL=yield-finder.js.map

package/dist/yield-finder.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "agent-treasury",
+  "version": "0.1.0",
+  "description": "Treasury management utilities for AI agents. Track balances, detect idle USDC, compare DeFi yields, and activate autonomous earning.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "agent",
+    "treasury",
+    "ai-agent",
+    "usdc",
+    "yield",
+    "defi",
+    "base",
+    "idle",
+    "balance",
+    "autonomous",
+    "wallet",
+    "x402"
+  ],
+  "homepage": "https://clicksprotocol.xyz",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/clicks-protocol/agent-treasury"
+  },
+  "license": "MIT",
+  "author": "Clicks Protocol <hello@clicksprotocol.xyz>",
+  "peerDependencies": {
+    "ethers": "^6.0.0"
+  },
+  "devDependencies": {
+    "ethers": "^6.13.0",
+    "typescript": "^5.4.0"
+  }
+}