basileus-agentkit-plugin 0.1.0

package/dist/wallet.js

@@ -0,0 +1,47 @@
+import { createWalletClient, createPublicClient, http, formatUnits, } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { erc20Abi } from "viem";
+import { ViemWalletProvider } from "@coinbase/agentkit";
+import { Attribution } from "ox/erc8021";
+const BUILDER_CODE = "bc_kj26kx76";
+// USDC on Base mainnet
+const USDC_BASE = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+// USDC on Base Sepolia
+const USDC_BASE_SEPOLIA = "0x036CbD53842c5426634e7929541eC2318f3dCF7e";
+export async function createAgentWallet(privateKey, chain, rpcUrl) {
+    const account = privateKeyToAccount(privateKey);
+    const dataSuffix = Attribution.toDataSuffix({ codes: [BUILDER_CODE] });
+    const walletClient = createWalletClient({
+        account,
+        chain,
+        transport: http(rpcUrl),
+        dataSuffix,
+    });
+    const publicClient = createPublicClient({
+        chain,
+        transport: http(rpcUrl),
+    });
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const provider = new ViemWalletProvider(walletClient);
+    const usdcAddress = chain.id === 8453 ? USDC_BASE : USDC_BASE_SEPOLIA;
+    return { walletClient, publicClient, provider, account, usdcAddress };
+}
+export async function getBalances(wallet) {
+    const { publicClient, account, usdcAddress, walletClient } = wallet;
+    const [ethBal, usdcBal] = await Promise.all([
+        publicClient.getBalance({ address: account.address }),
+        publicClient.readContract({
+            address: usdcAddress,
+            abi: erc20Abi,
+            functionName: "balanceOf",
+            args: [account.address],
+        }),
+    ]);
+    return {
+        address: account.address,
+        ethBalance: formatUnits(ethBal, 18),
+        usdcBalance: formatUnits(usdcBal, 6),
+        chainName: walletClient.chain?.name ?? "unknown",
+    };
+}
+//# sourceMappingURL=wallet.js.map

package/dist/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../src/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,IAAI,EACJ,WAAW,GAGZ,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,YAAY,GAAG,aAAa,CAAC;AAEnC,uBAAuB;AACvB,MAAM,SAAS,GAAG,4CAAqD,CAAC;AACxE,uBAAuB;AACvB,MAAM,iBAAiB,GAAG,4CAAqD,CAAC;AAShF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,UAAe,EAAE,KAAY,EAAE,MAAe;IACpF,MAAM,OAAO,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,WAAW,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAEvE,MAAM,YAAY,GAAG,kBAAkB,CAAC;QACtC,OAAO;QACP,KAAK;QACL,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;QACvB,UAAU;KACX,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,kBAAkB,CAAC;QACtC,KAAK;QACL,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;KACxB,CAAC,CAAC;IAEH,8DAA8D;IAC9D,MAAM,QAAQ,GAAG,IAAI,kBAAkB,CAAC,YAAmB,CAAC,CAAC;IAE7D,MAAM,WAAW,GAAG,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAEtE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AACxE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAqD;IAErD,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;IAEpE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC1C,YAAY,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;QACrD,YAAY,CAAC,YAAY,CAAC;YACxB,OAAO,EAAE,WAAW;YACpB,GAAG,EAAE,QAAQ;YACb,YAAY,EAAE,WAAW;YACzB,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;SACxB,CAAC;KACH,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;QACnC,WAAW,EAAE,WAAW,CAAC,OAAiB,EAAE,CAAC,CAAC;QAC9C,SAAS,EAAE,YAAY,CAAC,KAAK,EAAE,IAAI,IAAI,SAAS;KACjD,CAAC;AACJ,CAAC"}

package/dist/x402-tracker.d.ts

@@ -0,0 +1,2 @@
+export declare function installX402Tracker(): void;
+export declare function drainX402TxHashes(): string[];

package/dist/x402-tracker.js

@@ -0,0 +1,39 @@
+let paymentTxHashes = [];
+let installed = false;
+export function installX402Tracker() {
+    if (installed)
+        return;
+    const originalFetch = globalThis.fetch;
+    globalThis.fetch = async (...args) => {
+        const response = await originalFetch(...args);
+        const receipt = response.headers.get("x-payment-receipt");
+        if (receipt && /^0x[a-fA-F0-9]{64}$/.test(receipt)) {
+            paymentTxHashes.push(receipt);
+            console.log(`[x402] Captured payment tx: ${receipt.slice(0, 14)}...`);
+            return response;
+        }
+        const paymentHeader = response.headers.get("payment-response");
+        if (paymentHeader) {
+            try {
+                const decoded = JSON.parse(atob(paymentHeader));
+                const txHash = decoded.transaction ?? decoded.txHash;
+                if (txHash && typeof txHash === "string") {
+                    paymentTxHashes.push(txHash);
+                    console.log(`[x402] Captured payment tx: ${txHash.slice(0, 14)}...`);
+                }
+            }
+            catch {
+                console.warn("[x402] Failed to decode payment-response header");
+            }
+        }
+        return response;
+    };
+    installed = true;
+    console.log("[x402] Fetch interceptor installed");
+}
+export function drainX402TxHashes() {
+    const hashes = [...paymentTxHashes];
+    paymentTxHashes = [];
+    return hashes;
+}
+//# sourceMappingURL=x402-tracker.js.map

package/dist/x402-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402-tracker.js","sourceRoot":"","sources":["../src/x402-tracker.ts"],"names":[],"mappings":"AAAA,IAAI,eAAe,GAAa,EAAE,CAAC;AACnC,IAAI,SAAS,GAAG,KAAK,CAAC;AAEtB,MAAM,UAAU,kBAAkB;IAChC,IAAI,SAAS;QAAE,OAAO;IACtB,MAAM,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC;IAEvC,UAAU,CAAC,KAAK,GAAG,KAAK,EAAE,GAAG,IAA8B,EAAqB,EAAE;QAChF,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,GAAG,IAAI,CAAC,CAAC;QAE9C,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QAC1D,IAAI,OAAO,IAAI,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,+BAA+B,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;YACtE,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAC/D,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;gBAChD,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;gBACrD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;oBACzC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBAC7B,OAAO,CAAC,GAAG,CAAC,+BAA+B,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;gBACvE,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,SAAS,GAAG,IAAI,CAAC;IACjB,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,MAAM,GAAG,CAAC,GAAG,eAAe,CAAC,CAAC;IACpC,eAAe,GAAG,EAAE,CAAC;IACrB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/eslint.config.js

@@ -0,0 +1,26 @@
+import tseslint from "@typescript-eslint/eslint-plugin";
+import tsparser from "@typescript-eslint/parser";
+
+export default [
+  {
+    files: ["src/**/*.ts"],
+    languageOptions: {
+      parser: tsparser,
+      parserOptions: {
+        ecmaVersion: "latest",
+        sourceType: "module",
+      },
+    },
+    plugins: {
+      "@typescript-eslint": tseslint,
+    },
+    rules: {
+      ...tseslint.configs.recommended.rules,
+      "@typescript-eslint/no-unused-vars": ["error", { argsIgnorePattern: "^_" }],
+      "@typescript-eslint/no-explicit-any": "warn",
+    },
+  },
+  {
+    ignores: ["dist/"],
+  },
+];

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "basileus-agentkit-plugin",
+  "version": "0.1.0",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/RezaRahemtola/ETHDenver-2026",
+    "directory": "basileus-agentkit-plugin"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./x402": {
+      "types": "./dist/x402-tracker.d.ts",
+      "import": "./dist/x402-tracker.js"
+    },
+    "./aleph": {
+      "types": "./dist/aleph-publisher.d.ts",
+      "import": "./dist/aleph-publisher.js"
+    },
+    "./agent-loop": {
+      "types": "./dist/agent-loop.d.ts",
+      "import": "./dist/agent-loop.js"
+    },
+    "./tools": {
+      "types": "./dist/tools.d.ts",
+      "import": "./dist/tools.js"
+    },
+    "./summarizer": {
+      "types": "./dist/summarizer.d.ts",
+      "import": "./dist/summarizer.js"
+    },
+    "./actions": {
+      "types": "./dist/actions/index.d.ts",
+      "import": "./dist/actions/index.js"
+    },
+    "./actions/aleph": {
+      "types": "./dist/actions/aleph.d.ts",
+      "import": "./dist/actions/aleph.js"
+    },
+    "./actions/compound": {
+      "types": "./dist/actions/compound/index.d.ts",
+      "import": "./dist/actions/compound/index.js"
+    },
+    "./wallet": {
+      "types": "./dist/wallet.d.ts",
+      "import": "./dist/wallet.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "format": "prettier --write src/",
+    "format:check": "prettier --check src/"
+  },
+  "peerDependencies": {
+    "@blockrun/llm": "^0.3.0",
+    "@coinbase/agentkit": "^0.10.4",
+    "viem": "^2.0.0"
+  },
+  "dependencies": {
+    "@aleph-sdk/client": "^1.4.5",
+    "@aleph-sdk/ethereum": "^1.5.0",
+    "@aleph-sdk/message": "^1.6.3",
+    "decimal.js": "^10.0.0",
+    "ox": "^0.12.4",
+    "zod": "^3.0.0",
+    "zod-to-json-schema": "^3.25.0"
+  },
+  "devDependencies": {
+    "@blockrun/llm": "^0.3.0",
+    "@coinbase/agentkit": "^0.10.4",
+    "@types/node": "^22.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "prettier": "^3.8.1",
+    "typescript": "^5.7.0",
+    "viem": "^2.45.3"
+  }
+}

package/src/actions/aleph.ts

@@ -0,0 +1,145 @@
+import { z } from "zod";
+import {
+  customActionProvider,
+  EvmWalletProvider,
+  SuperfluidQueryActionProvider,
+} from "@coinbase/agentkit";
+import { createPublicClient, formatUnits, http, parseEther, encodeFunctionData } from "viem";
+import { base } from "viem/chains";
+import {
+  ALEPH_ADDRESS,
+  WETH_ADDRESS,
+  UNISWAP_ROUTER,
+  UNISWAP_ALEPH_POOL,
+  uniswapV3PoolAbi,
+  uniswapRouterAbi,
+} from "./constants.js";
+
+const balanceOfAbi = [
+  {
+    inputs: [{ name: "account", type: "address" }],
+    name: "balanceOf",
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view",
+    type: "function",
+  },
+] as const;
+
+export function createAlephActionProvider(rpcUrl?: string) {
+  const publicClient = createPublicClient({
+    chain: base,
+    transport: http(rpcUrl),
+  });
+
+  return customActionProvider<EvmWalletProvider>([
+    {
+      name: "get_aleph_info",
+      description:
+        "Get your current ALEPH balance, hourly consumption rate, estimated hours of compute left, ETH balance, and ALEPH/ETH price. Use this to decide whether you need to buy more ALEPH.",
+      schema: z.object({}),
+      invoke: async (walletProvider: EvmWalletProvider, _args: unknown) => {
+        try {
+          const address = walletProvider.getAddress() as `0x${string}`;
+
+          const sfQuery = new SuperfluidQueryActionProvider();
+          const streamsResult = await sfQuery.queryStreams(walletProvider);
+
+          let alephPerHour = 0;
+          try {
+            const jsonStr = streamsResult.replace("Current outflows are ", "");
+            const outflows = JSON.parse(jsonStr) as Array<{
+              currentFlowRate: string;
+              token: { symbol: string };
+              receiver: { id: string };
+            }>;
+            const alephOutflows = outflows.filter((o) =>
+              o.token.symbol.toLowerCase().includes("aleph"),
+            );
+            const totalFlowRate = alephOutflows.reduce(
+              (sum, o) => sum + BigInt(o.currentFlowRate),
+              0n,
+            );
+            alephPerHour = parseFloat(formatUnits(totalFlowRate * 3600n, 18));
+          } catch {
+            // No outflows or parse error
+          }
+
+          const rawBalance = await publicClient.readContract({
+            address: ALEPH_ADDRESS,
+            abi: balanceOfAbi,
+            functionName: "balanceOf",
+            args: [address],
+          });
+          const alephBalance = parseFloat(formatUnits(rawBalance, 18));
+
+          let hoursLeft = 1000000;
+          if (alephPerHour > 0) {
+            hoursLeft = Math.round(alephBalance / alephPerHour);
+          }
+
+          const ethBalanceWei = await publicClient.getBalance({ address });
+          const ethBalance = parseFloat(formatUnits(ethBalanceWei, 18));
+
+          const slot0 = await publicClient.readContract({
+            address: UNISWAP_ALEPH_POOL,
+            abi: uniswapV3PoolAbi,
+            functionName: "slot0",
+          });
+          const sqrtPriceX96 = slot0[0];
+          const price = Number(sqrtPriceX96) / 2 ** 96;
+          const alephPerEth = price * price;
+
+          return JSON.stringify({
+            aleph_balance: Math.round(alephBalance * 1000) / 1000,
+            aleph_consumed_per_hour: Math.round(alephPerHour * 1000) / 1000,
+            hours_left_until_death: hoursLeft,
+            eth_balance: Math.round(ethBalance * 10000) / 10000,
+            aleph_per_eth: Math.round(alephPerEth * 100) / 100,
+          });
+        } catch (err) {
+          return `Error getting ALEPH info: ${err instanceof Error ? err.message : String(err)}`;
+        }
+      },
+    },
+    {
+      name: "swap_eth_to_aleph",
+      description:
+        "Swap ETH to ALEPH via Uniswap V3 to pay for your computing. Provide the amount of ETH to swap.",
+      schema: z.object({
+        ethAmount: z.string().describe("Amount of ETH to swap, e.g. '0.01'"),
+      }),
+      invoke: async (walletProvider: EvmWalletProvider, args: { ethAmount: string }) => {
+        try {
+          const amountInWei = parseEther(args.ethAmount);
+          const address = walletProvider.getAddress() as `0x${string}`;
+
+          const data = encodeFunctionData({
+            abi: uniswapRouterAbi,
+            functionName: "exactInputSingle",
+            args: [
+              {
+                tokenIn: WETH_ADDRESS,
+                tokenOut: ALEPH_ADDRESS,
+                fee: 10000,
+                recipient: address,
+                amountIn: amountInWei,
+                amountOutMinimum: 0n,
+                sqrtPriceLimitX96: 0n,
+              },
+            ],
+          });
+
+          const txHash = await walletProvider.sendTransaction({
+            to: UNISWAP_ROUTER,
+            data,
+            value: amountInWei,
+          });
+
+          return `Swap transaction sent. Hash: ${txHash}`;
+        } catch (err) {
+          return `Error swapping ETH to ALEPH: ${err instanceof Error ? err.message : String(err)}`;
+        }
+      },
+    },
+  ]);
+}

package/src/actions/compound/compoundActionProvider.ts

@@ -0,0 +1,166 @@
+/**
+ * Fixed Compound action provider — local copy with base asset fixes.
+ *
+ * Fixes from upstream @coinbase/agentkit:
+ * - get_portfolio: reads base asset supply via Comet.balanceOf() (was missing)
+ * - withdraw: for base asset (USDC), checks balanceOf instead of collateralBalanceOf
+ *
+ * Uses customActionProvider (no decorators) so tsx/esbuild can run it.
+ * TODO: Remove this directory once agentkit merges the fix.
+ */
+import { encodeFunctionData, formatUnits, parseUnits, erc20Abi } from "viem";
+import { customActionProvider, EvmWalletProvider } from "@coinbase/agentkit";
+import { COMET_ABI } from "./constants.js";
+import {
+  CompoundSupplySchema,
+  CompoundWithdrawSchema,
+  CompoundPortfolioSchema,
+} from "./schemas.js";
+import {
+  getBaseAssetBalance,
+  getCollateralBalance,
+  getHealthRatio,
+  getHealthRatioAfterWithdraw,
+  getTokenBalance,
+  getTokenDecimals,
+  getTokenSymbol,
+  getPortfolioDetailsMarkdown,
+  getCometAddress,
+  getAssetAddress,
+  getBaseTokenAddress,
+} from "./utils.js";
+
+async function approve(
+  wallet: EvmWalletProvider,
+  tokenAddress: string,
+  spenderAddress: string,
+  amount: bigint,
+): Promise<string> {
+  try {
+    const data = encodeFunctionData({
+      abi: erc20Abi,
+      functionName: "approve",
+      args: [spenderAddress as `0x${string}`, amount],
+    });
+    const txHash = await wallet.sendTransaction({
+      to: tokenAddress as `0x${string}`,
+      data,
+    });
+    await wallet.waitForTransactionReceipt(txHash);
+    return `Successfully approved ${spenderAddress} to spend ${amount} tokens`;
+  } catch (error) {
+    return `Error approving tokens: ${error}`;
+  }
+}
+
+export const compoundFixedProvider = customActionProvider<EvmWalletProvider>([
+  {
+    name: "compound_supply",
+    description:
+      "Supply assets to Compound. assetId: 'weth', 'cbeth', 'cbbtc', 'wsteth', or 'usdc'. amount: human-readable.",
+    schema: CompoundSupplySchema,
+    invoke: async (wallet, args) => {
+      try {
+        const network = wallet.getNetwork();
+        const cometAddress = getCometAddress(network);
+        const tokenAddress = getAssetAddress(network, args.assetId);
+
+        const decimals = await getTokenDecimals(wallet, tokenAddress);
+        const amountAtomic = parseUnits(args.amount, decimals);
+
+        const walletBalance = await getTokenBalance(wallet, tokenAddress);
+        if (walletBalance < amountAtomic) {
+          const humanBalance = formatUnits(walletBalance, decimals);
+          return `Error: Insufficient balance. You have ${humanBalance}, but trying to supply ${args.amount}`;
+        }
+
+        const approvalResult = await approve(wallet, tokenAddress, cometAddress, amountAtomic);
+        if (approvalResult.startsWith("Error")) {
+          return `Error approving token: ${approvalResult}`;
+        }
+
+        const data = encodeFunctionData({
+          abi: COMET_ABI,
+          functionName: "supply",
+          args: [tokenAddress, amountAtomic],
+        });
+        const txHash = await wallet.sendTransaction({ to: cometAddress, data });
+        await wallet.waitForTransactionReceipt(txHash);
+
+        const sym = await getTokenSymbol(wallet, tokenAddress);
+        return `Supplied ${args.amount} ${sym} to Compound.\nTransaction hash: ${txHash}`;
+      } catch (err) {
+        return `Error supplying to Compound: ${err instanceof Error ? err.message : err}`;
+      }
+    },
+  },
+  {
+    name: "compound_withdraw",
+    description:
+      "Withdraw assets from Compound. assetId: 'weth', 'cbeth', 'cbbtc', 'wsteth', or 'usdc'. amount: human-readable.",
+    schema: CompoundWithdrawSchema,
+    invoke: async (wallet, args) => {
+      try {
+        const cometAddress = getCometAddress(wallet.getNetwork());
+        const tokenAddress = getAssetAddress(wallet.getNetwork(), args.assetId);
+
+        const decimals = await getTokenDecimals(wallet, tokenAddress);
+        const amountAtomic = parseUnits(args.amount, decimals);
+
+        const baseTokenAddress = await getBaseTokenAddress(wallet, cometAddress);
+        const isBaseAsset = tokenAddress.toLowerCase() === baseTokenAddress.toLowerCase();
+
+        if (isBaseAsset) {
+          const baseBalance = await getBaseAssetBalance(wallet, cometAddress);
+          if (amountAtomic > baseBalance) {
+            return `Error: Insufficient balance. Trying to withdraw ${args.amount}, but only have ${formatUnits(baseBalance, decimals)} supplied`;
+          }
+        } else {
+          const collateralBalance = await getCollateralBalance(wallet, cometAddress, tokenAddress);
+          if (amountAtomic > collateralBalance) {
+            return `Error: Insufficient balance. Trying to withdraw ${args.amount}, but only have ${formatUnits(collateralBalance, decimals)} supplied`;
+          }
+
+          const projectedHealth = await getHealthRatioAfterWithdraw(
+            wallet,
+            cometAddress,
+            tokenAddress,
+            amountAtomic,
+          );
+          if (projectedHealth.lessThan(1)) {
+            return `Error: Withdrawing ${args.amount} would result in unhealthy position. Health ratio would be ${projectedHealth.toFixed(2)}`;
+          }
+        }
+
+        const data = encodeFunctionData({
+          abi: COMET_ABI,
+          functionName: "withdraw",
+          args: [tokenAddress, amountAtomic],
+        });
+        const txHash = await wallet.sendTransaction({ to: cometAddress, data });
+        await wallet.waitForTransactionReceipt(txHash);
+
+        const sym = await getTokenSymbol(wallet, tokenAddress);
+        const health = await getHealthRatio(wallet, cometAddress);
+        return `Withdrawn ${args.amount} ${sym} from Compound.\nTransaction hash: ${txHash}\nHealth ratio: ${health.toFixed(2)}`;
+      } catch (err) {
+        return `Error withdrawing from Compound: ${err instanceof Error ? err.message : err}`;
+      }
+    },
+  },
+  {
+    name: "compound_get_portfolio",
+    description:
+      "Get Compound portfolio: base asset supply (earns APY), collateral balances, borrow positions.",
+    schema: CompoundPortfolioSchema,
+    // NOTE: must have 2 params so customActionProvider passes wallet as first arg
+    invoke: async (wallet, _args) => {
+      try {
+        const cometAddress = getCometAddress(wallet.getNetwork());
+        return await getPortfolioDetailsMarkdown(wallet, cometAddress);
+      } catch (err) {
+        return `Error getting portfolio: ${err instanceof Error ? err.message : err}`;
+      }
+    },
+  },
+]);

package/src/actions/compound/constants.ts

@@ -0,0 +1,140 @@
+import { type Address } from "viem";
+import { erc20Abi as ERC20_ABI } from "viem";
+
+export const SUPPORTED_NETWORKS = ["base-mainnet", "base-sepolia"];
+
+export const COMET_ADDRESSES: Record<string, Address> = {
+  "base-mainnet": "0xb125E6687d4313864e53df431d5425969c15Eb2F",
+  "base-sepolia": "0x571621Ce60Cebb0c1D442B5afb38B1663C6Bf017",
+};
+
+export const ASSET_ADDRESSES: Record<string, Record<string, Address>> = {
+  "base-mainnet": {
+    weth: "0x4200000000000000000000000000000000000006",
+    cbeth: "0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22",
+    cbbtc: "0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf",
+    wsteth: "0xc1CBa3fCea344f92D9239c08C0568f6F2F0ee452",
+    usdc: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+  },
+  "base-sepolia": {
+    weth: "0x4200000000000000000000000000000000000006",
+    usdc: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+    wsteth: "0x774eD9EDB0C5202dF9A86183804b5D9E99dC6CA3",
+  },
+};
+
+export { ERC20_ABI };
+
+export const COMET_ABI = [
+  {
+    inputs: [
+      { internalType: "address", name: "asset", type: "address" },
+      { internalType: "uint256", name: "amount", type: "uint256" },
+    ],
+    name: "supply",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function",
+  },
+  {
+    inputs: [
+      { internalType: "address", name: "asset", type: "address" },
+      { internalType: "uint256", name: "amount", type: "uint256" },
+    ],
+    name: "withdraw",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function",
+  },
+  {
+    inputs: [{ internalType: "address", name: "priceFeed", type: "address" }],
+    name: "getPrice",
+    outputs: [{ internalType: "uint256", name: "", type: "uint256" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [{ internalType: "address", name: "account", type: "address" }],
+    name: "borrowBalanceOf",
+    outputs: [{ internalType: "uint256", name: "", type: "uint256" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [],
+    name: "numAssets",
+    outputs: [{ internalType: "uint8", name: "", type: "uint8" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [{ internalType: "uint8", name: "i", type: "uint8" }],
+    name: "getAssetInfo",
+    outputs: [
+      {
+        components: [
+          { internalType: "uint8", name: "offset", type: "uint8" },
+          { internalType: "address", name: "asset", type: "address" },
+          { internalType: "address", name: "priceFeed", type: "address" },
+          { internalType: "uint64", name: "scale", type: "uint64" },
+          { internalType: "uint64", name: "borrowCollateralFactor", type: "uint64" },
+          { internalType: "uint64", name: "liquidateCollateralFactor", type: "uint64" },
+          { internalType: "uint64", name: "liquidationFactor", type: "uint64" },
+          { internalType: "uint128", name: "supplyCap", type: "uint128" },
+        ],
+        internalType: "struct CometCore.AssetInfo",
+        name: "",
+        type: "tuple",
+      },
+    ],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [],
+    name: "baseToken",
+    outputs: [{ internalType: "address", name: "", type: "address" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [],
+    name: "baseTokenPriceFeed",
+    outputs: [{ internalType: "address", name: "", type: "address" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [
+      { internalType: "address", name: "account", type: "address" },
+      { internalType: "address", name: "asset", type: "address" },
+    ],
+    name: "collateralBalanceOf",
+    outputs: [{ internalType: "uint128", name: "balance", type: "uint128" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [{ internalType: "address", name: "account", type: "address" }],
+    name: "balanceOf",
+    outputs: [{ internalType: "uint256", name: "", type: "uint256" }],
+    stateMutability: "view",
+    type: "function",
+  },
+] as const;
+
+export const PRICE_FEED_ABI = [
+  {
+    inputs: [],
+    name: "latestRoundData",
+    outputs: [
+      { name: "roundId", type: "uint80" },
+      { name: "answer", type: "int256" },
+      { name: "startedAt", type: "uint256" },
+      { name: "updatedAt", type: "uint256" },
+      { name: "answeredInRound", type: "uint80" },
+    ],
+    stateMutability: "view",
+    type: "function",
+  },
+] as const;

package/src/actions/compound/index.ts

@@ -0,0 +1 @@
+export { compoundFixedProvider } from "./compoundActionProvider.js";