@hypurrquant/defi-cli 0.2.3 → 0.2.5

package/config/tokens/hyperevm.toml

@@ -23,7 +23,7 @@ tags = ["stablecoin"]
 [[token]]
 symbol = "USDT0"
 name = "Tether USD (USDT0)"
-address = "0xB8CE59FC3717adA4c02EADF9682a9E934F625EBb"
+address = "0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb"
 decimals = 6
 tags = ["stablecoin"]
 

package/dist/index.js

@@ -5,7 +5,7 @@ import { Command } from "commander";
 import { createRequire } from "module";
 
 // src/executor.ts
-import { createPublicClient as createPublicClient2, createWalletClient, http as http2 } from "viem";
+import { createPublicClient as createPublicClient2, createWalletClient, http as http2, parseAbi as parseAbi3, encodeFunctionData as encodeFunctionData3 } from "viem";
 import { privateKeyToAccount } from "viem/accounts";
 
 // ../defi-core/dist/index.js
@@ -1008,8 +1008,13 @@ var Registry = class _Registry {
 };
 
 // src/executor.ts
+var ERC20_ABI = parseAbi3([
+  "function allowance(address owner, address spender) external view returns (uint256)",
+  "function approve(address spender, uint256 amount) external returns (bool)"
+]);
 var GAS_BUFFER_BPS = 12000n;
-var DEFAULT_PRIORITY_FEE_WEI = 100000000n;
+var DEFAULT_PRIORITY_FEE_WEI = 20000000000n;
+var MAX_GAS_LIMIT = 5000000000n;
 var Executor = class _Executor {
   dryRun;
   rpcUrl;
@@ -1023,6 +1028,62 @@ var Executor = class _Executor {
   static applyGasBuffer(gas) {
     return gas * GAS_BUFFER_BPS / 10000n;
   }
+  /**
+   * Check allowance for a single token/spender pair and send an approve tx if needed.
+   * Only called in broadcast mode (not dry-run).
+   */
+  async checkAndApprove(token, spender, amount, owner, publicClient, walletClient) {
+    const allowance = await publicClient.readContract({
+      address: token,
+      abi: ERC20_ABI,
+      functionName: "allowance",
+      args: [owner, spender]
+    });
+    if (allowance >= amount) return;
+    process.stderr.write(
+      `  Approving ${amount} of ${token} for ${spender}...
+`
+    );
+    const approveData = encodeFunctionData3({
+      abi: ERC20_ABI,
+      functionName: "approve",
+      args: [spender, amount]
+    });
+    const rpcUrl = this.rpcUrl;
+    const gasLimit = await (async () => {
+      try {
+        const estimated = await publicClient.estimateGas({
+          to: token,
+          data: approveData,
+          account: owner
+        });
+        const buffered = _Executor.applyGasBuffer(estimated);
+        return buffered > MAX_GAS_LIMIT ? MAX_GAS_LIMIT : buffered;
+      } catch {
+        return 80000n;
+      }
+    })();
+    const [maxFeePerGas, maxPriorityFeePerGas] = await this.fetchEip1559Fees(rpcUrl);
+    const approveTxHash = await walletClient.sendTransaction({
+      chain: null,
+      account: walletClient.account,
+      to: token,
+      data: approveData,
+      gas: gasLimit > 0n ? gasLimit : void 0,
+      maxFeePerGas: maxFeePerGas > 0n ? maxFeePerGas : void 0,
+      maxPriorityFeePerGas: maxPriorityFeePerGas > 0n ? maxPriorityFeePerGas : void 0
+    });
+    const approveTxUrl = this.explorerUrl ? `${this.explorerUrl}/tx/${approveTxHash}` : void 0;
+    process.stderr.write(`  Approve tx: ${approveTxHash}
+`);
+    if (approveTxUrl) process.stderr.write(`  Explorer: ${approveTxUrl}
+`);
+    await publicClient.waitForTransactionReceipt({ hash: approveTxHash });
+    process.stderr.write(
+      `  Approved ${amount} of ${token} for ${spender}
+`
+    );
+  }
   /** Fetch EIP-1559 fee params from the network. Returns [maxFeePerGas, maxPriorityFeePerGas]. */
   async fetchEip1559Fees(rpcUrl) {
     try {
@@ -1049,7 +1110,10 @@ var Executor = class _Executor {
         value: tx.value,
         account: from
       });
-      if (estimated > 0n) return _Executor.applyGasBuffer(estimated);
+      if (estimated > 0n) {
+        const buffered = _Executor.applyGasBuffer(estimated);
+        return buffered > MAX_GAS_LIMIT ? MAX_GAS_LIMIT : buffered;
+      }
     } catch {
     }
     return tx.gas_estimate ? BigInt(tx.gas_estimate) : 0n;
@@ -1135,6 +1199,18 @@ var Executor = class _Executor {
     }
     const publicClient = createPublicClient2({ transport: http2(rpcUrl) });
     const walletClient = createWalletClient({ account, transport: http2(rpcUrl) });
+    if (tx.approvals && tx.approvals.length > 0) {
+      for (const approval of tx.approvals) {
+        await this.checkAndApprove(
+          approval.token,
+          approval.spender,
+          approval.amount,
+          account.address,
+          publicClient,
+          walletClient
+        );
+      }
+    }
     const gasLimit = await this.estimateGasWithBuffer(rpcUrl, tx, account.address);
     const [maxFeePerGas, maxPriorityFeePerGas] = await this.fetchEip1559Fees(rpcUrl);
     process.stderr.write(`Broadcasting transaction to ${rpcUrl}...
@@ -1711,10 +1787,10 @@ function registerSchema(parent, getOpts) {
 }
 
 // ../defi-protocols/dist/index.js
-import { encodeFunctionData as encodeFunctionData3, parseAbi as parseAbi3, createPublicClient as createPublicClient4, http as http4, decodeAbiParameters } from "viem";
+import { encodeFunctionData as encodeFunctionData4, parseAbi as parseAbi4, createPublicClient as createPublicClient4, http as http4, decodeAbiParameters } from "viem";
 import { encodeFunctionData as encodeFunctionData22, parseAbi as parseAbi22, createPublicClient as createPublicClient22, http as http22, decodeFunctionResult as decodeFunctionResult2, decodeAbiParameters as decodeAbiParameters2 } from "viem";
 import { encodeFunctionData as encodeFunctionData32, parseAbi as parseAbi32, createPublicClient as createPublicClient32, http as http32, decodeAbiParameters as decodeAbiParameters3, concatHex, zeroAddress } from "viem";
-import { encodeFunctionData as encodeFunctionData4, parseAbi as parseAbi4, zeroAddress as zeroAddress2 } from "viem";
+import { encodeFunctionData as encodeFunctionData42, parseAbi as parseAbi42, zeroAddress as zeroAddress2 } from "viem";
 import { encodeFunctionData as encodeFunctionData5, parseAbi as parseAbi5 } from "viem";
 import { encodeFunctionData as encodeFunctionData6, parseAbi as parseAbi6, createPublicClient as createPublicClient42, http as http42, decodeAbiParameters as decodeAbiParameters4 } from "viem";
 import { encodeFunctionData as encodeFunctionData7, parseAbi as parseAbi7, zeroAddress as zeroAddress3 } from "viem";
@@ -1737,19 +1813,19 @@ import { parseAbi as parseAbi23, encodeFunctionData as encodeFunctionData21 } fr
 import { parseAbi as parseAbi24, encodeFunctionData as encodeFunctionData222 } from "viem";
 import { createPublicClient as createPublicClient19, http as http19, parseAbi as parseAbi25 } from "viem";
 var DEFAULT_FEE = 3e3;
-var swapRouterAbi = parseAbi3([
+var swapRouterAbi = parseAbi4([
   "struct ExactInputSingleParams { address tokenIn; address tokenOut; uint24 fee; address recipient; uint256 deadline; uint256 amountIn; uint256 amountOutMinimum; uint160 sqrtPriceLimitX96; }",
   "function exactInputSingle(ExactInputSingleParams calldata params) external payable returns (uint256 amountOut)"
 ]);
-var quoterAbi = parseAbi3([
+var quoterAbi = parseAbi4([
   "struct QuoteExactInputSingleParams { address tokenIn; address tokenOut; uint256 amountIn; uint24 fee; uint160 sqrtPriceLimitX96; }",
   "function quoteExactInputSingle(QuoteExactInputSingleParams memory params) external returns (uint256 amountOut, uint160 sqrtPriceX96After, uint32 initializedTicksCrossed, uint256 gasEstimate)"
 ]);
-var ramsesQuoterAbi = parseAbi3([
+var ramsesQuoterAbi = parseAbi4([
   "struct QuoteExactInputSingleParams { address tokenIn; address tokenOut; uint256 amountIn; int24 tickSpacing; uint160 sqrtPriceLimitX96; }",
   "function quoteExactInputSingle(QuoteExactInputSingleParams memory params) external returns (uint256 amountOut, uint160 sqrtPriceX96After, uint32 initializedTicksCrossed, uint256 gasEstimate)"
 ]);
-var positionManagerAbi = parseAbi3([
+var positionManagerAbi = parseAbi4([
   "struct MintParams { address token0; address token1; uint24 fee; int24 tickLower; int24 tickUpper; uint256 amount0Desired; uint256 amount1Desired; uint256 amount0Min; uint256 amount1Min; address recipient; uint256 deadline; }",
   "function mint(MintParams calldata params) external payable returns (uint256 tokenId, uint128 liquidity, uint256 amount0, uint256 amount1)"
 ]);
@@ -1782,7 +1858,7 @@ var UniswapV3Adapter = class {
   async buildSwap(params) {
     const deadline = BigInt(params.deadline ?? 18446744073709551615n);
     const amountOutMinimum = 0n;
-    const data = encodeFunctionData3({
+    const data = encodeFunctionData4({
       abi: swapRouterAbi,
       functionName: "exactInputSingle",
       args: [
@@ -1803,7 +1879,8 @@ var UniswapV3Adapter = class {
       to: this.router,
       data,
       value: 0n,
-      gas_estimate: 2e5
+      gas_estimate: 2e5,
+      approvals: [{ token: params.token_in, spender: this.router, amount: params.amount_in }]
     };
   }
   async quote(params) {
@@ -1818,7 +1895,7 @@ var UniswapV3Adapter = class {
           tickSpacings.map(async (ts) => {
             const result = await client2.call({
               to: this.quoter,
-              data: encodeFunctionData3({
+              data: encodeFunctionData4({
                 abi: ramsesQuoterAbi,
                 functionName: "quoteExactInputSingle",
                 args: [
@@ -1864,7 +1941,7 @@ var UniswapV3Adapter = class {
         feeTiers.map(async (fee) => {
           const result = await client2.call({
             to: this.quoter,
-            data: encodeFunctionData3({
+            data: encodeFunctionData4({
               abi: quoterAbi,
               functionName: "quoteExactInputSingle",
               args: [
@@ -1903,7 +1980,7 @@ var UniswapV3Adapter = class {
       }
     }
     const client = createPublicClient4({ transport: http4(this.rpcUrl) });
-    const callData = encodeFunctionData3({
+    const callData = encodeFunctionData4({
       abi: swapRouterAbi,
       functionName: "exactInputSingle",
       args: [
@@ -1949,7 +2026,7 @@ var UniswapV3Adapter = class {
     const [token0, token1, rawAmount0, rawAmount1] = params.token_a.toLowerCase() < params.token_b.toLowerCase() ? [params.token_a, params.token_b, params.amount_a, params.amount_b] : [params.token_b, params.token_a, params.amount_b, params.amount_a];
     const amount0 = rawAmount0 === 0n && rawAmount1 > 0n ? 1n : rawAmount0;
     const amount1 = rawAmount1 === 0n && rawAmount0 > 0n ? 1n : rawAmount1;
-    const data = encodeFunctionData3({
+    const data = encodeFunctionData4({
       abi: positionManagerAbi,
       functionName: "mint",
       args: [
@@ -1973,7 +2050,11 @@ var UniswapV3Adapter = class {
       to: pm,
       data,
       value: 0n,
-      gas_estimate: 5e5
+      gas_estimate: 5e5,
+      approvals: [
+        { token: token0, spender: pm, amount: amount0 },
+        { token: token1, spender: pm, amount: amount1 }
+      ]
     };
   }
   async buildRemoveLiquidity(_params) {
@@ -2032,7 +2113,8 @@ var UniswapV2Adapter = class {
       to: this.router,
       data,
       value: 0n,
-      gas_estimate: 15e4
+      gas_estimate: 15e4,
+      approvals: [{ token: params.token_in, spender: this.router, amount: params.amount_in }]
     };
   }
   async quote(params) {
@@ -2151,7 +2233,11 @@ var UniswapV2Adapter = class {
       to: this.router,
       data,
       value: 0n,
-      gas_estimate: 3e5
+      gas_estimate: 3e5,
+      approvals: [
+        { token: params.token_a, spender: this.router, amount: params.amount_a },
+        { token: params.token_b, spender: this.router, amount: params.amount_b }
+      ]
     };
   }
   async buildRemoveLiquidity(params) {
@@ -2238,7 +2324,8 @@ var AlgebraV3Adapter = class {
       to: this.router,
       data,
       value: 0n,
-      gas_estimate: 25e4
+      gas_estimate: 25e4,
+      approvals: [{ token: params.token_in, spender: this.router, amount: params.amount_in }]
     };
   }
   async quote(params) {
@@ -2356,7 +2443,11 @@ var AlgebraV3Adapter = class {
       to: pm,
       data,
       value: 0n,
-      gas_estimate: 5e5
+      gas_estimate: 5e5,
+      approvals: [
+        { token: token0, spender: pm, amount: amount0 },
+        { token: token1, spender: pm, amount: amount1 }
+      ]
     };
   }
   async buildRemoveLiquidity(_params) {
@@ -2365,7 +2456,7 @@ var AlgebraV3Adapter = class {
     );
   }
 };
-var abi3 = parseAbi4([
+var abi3 = parseAbi42([
   "function swapSingleTokenExactIn(address pool, address tokenIn, address tokenOut, uint256 exactAmountIn, uint256 minAmountOut, uint256 deadline, bool wethIsEth, bytes calldata userData) external returns (uint256 amountOut)"
 ]);
 var BalancerV3Adapter = class {
@@ -2385,7 +2476,7 @@ var BalancerV3Adapter = class {
   async buildSwap(params) {
     const minAmountOut = 0n;
     const deadline = BigInt(params.deadline ?? 18446744073709551615n);
-    const data = encodeFunctionData4({
+    const data = encodeFunctionData42({
       abi: abi3,
       functionName: "swapSingleTokenExactIn",
       args: [
@@ -2533,7 +2624,8 @@ var SolidlyAdapter = class {
       to: this.router,
       data,
       value: 0n,
-      gas_estimate: 2e5
+      gas_estimate: 2e5,
+      approvals: [{ token: params.token_in, spender: this.router, amount: params.amount_in }]
     };
   }
   async callGetAmountsOut(client, callData) {
@@ -2616,7 +2708,11 @@ var SolidlyAdapter = class {
       to: this.router,
       data,
       value: 0n,
-      gas_estimate: 35e4
+      gas_estimate: 35e4,
+      approvals: [
+        { token: params.token_a, spender: this.router, amount: params.amount_a },
+        { token: params.token_b, spender: this.router, amount: params.amount_b }
+      ]
     };
   }
   async buildRemoveLiquidity(params) {
@@ -2742,7 +2838,7 @@ var SolidlyGaugeAdapter = class {
     return this.protocolName;
   }
   // IGauge
-  async buildDeposit(gauge, amount, tokenId) {
+  async buildDeposit(gauge, amount, tokenId, lpToken) {
     if (tokenId !== void 0) {
       const data2 = encodeFunctionData8({
         abi: gaugeAbi,
@@ -2754,7 +2850,8 @@ var SolidlyGaugeAdapter = class {
         to: gauge,
         data: data2,
         value: 0n,
-        gas_estimate: 2e5
+        gas_estimate: 2e5,
+        approvals: lpToken ? [{ token: lpToken, spender: gauge, amount }] : void 0
       };
     }
     const data = encodeFunctionData8({
@@ -2767,7 +2864,8 @@ var SolidlyGaugeAdapter = class {
       to: gauge,
       data,
       value: 0n,
-      gas_estimate: 2e5
+      gas_estimate: 2e5,
+      approvals: lpToken ? [{ token: lpToken, spender: gauge, amount }] : void 0
     };
   }
   async buildWithdraw(gauge, amount) {
@@ -3067,7 +3165,7 @@ var POOL_ABI = parseAbi10([
   "function getUserAccountData(address user) external view returns (uint256 totalCollateralBase, uint256 totalDebtBase, uint256 availableBorrowsBase, uint256 currentLiquidationThreshold, uint256 ltv, uint256 healthFactor)",
   "function getReserveData(address asset) external 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)"
 ]);
-var ERC20_ABI = parseAbi10([
+var ERC20_ABI2 = parseAbi10([
   "function totalSupply() external view returns (uint256)"
 ]);
 var INCENTIVES_ABI = parseAbi10([
@@ -3120,7 +3218,8 @@ var AaveV3Adapter = class {
       to: this.pool,
       data,
       value: 0n,
-      gas_estimate: 3e5
+      gas_estimate: 3e5,
+      approvals: [{ token: params.asset, spender: this.pool, amount: params.amount }]
     };
   }
   async buildBorrow(params) {
@@ -3150,7 +3249,8 @@ var AaveV3Adapter = class {
       to: this.pool,
       data,
       value: 0n,
-      gas_estimate: 3e5
+      gas_estimate: 3e5,
+      approvals: [{ token: params.asset, spender: this.pool, amount: params.amount }]
     };
   }
   async buildWithdraw(params) {
@@ -3192,12 +3292,12 @@ var AaveV3Adapter = class {
     const [totalSupply, totalBorrow] = await Promise.all([
       client.readContract({
         address: aTokenAddress,
-        abi: ERC20_ABI,
+        abi: ERC20_ABI2,
         functionName: "totalSupply"
       }).catch(() => 0n),
       client.readContract({
         address: variableDebtTokenAddress,
-        abi: ERC20_ABI,
+        abi: ERC20_ABI2,
         functionName: "totalSupply"
       }).catch(() => 0n)
     ]);
@@ -3421,7 +3521,7 @@ var POOL_ABI2 = parseAbi11([
   //            [9]=variableDebtTokenAddress, [10]=interestRateStrategyAddress, [11]=id
   "function getReserveData(address asset) external view returns (uint256 configuration, uint128 liquidityIndex, uint128 variableBorrowIndex, uint128 currentLiquidityRate, uint128 currentVariableBorrowRate, uint128 currentStableBorrowRate, uint40 lastUpdateTimestamp, address aTokenAddress, address stableDebtTokenAddress, address variableDebtTokenAddress, address interestRateStrategyAddress, uint8 id)"
 ]);
-var ERC20_ABI2 = parseAbi11([
+var ERC20_ABI22 = parseAbi11([
   "function totalSupply() external view returns (uint256)"
 ]);
 function u256ToF642(v) {
@@ -3454,7 +3554,8 @@ var AaveV2Adapter = class {
       to: this.pool,
       data,
       value: 0n,
-      gas_estimate: 3e5
+      gas_estimate: 3e5,
+      approvals: [{ token: params.asset, spender: this.pool, amount: params.amount }]
     };
   }
   async buildBorrow(params) {
@@ -3484,7 +3585,8 @@ var AaveV2Adapter = class {
       to: this.pool,
       data,
       value: 0n,
-      gas_estimate: 3e5
+      gas_estimate: 3e5,
+      approvals: [{ token: params.asset, spender: this.pool, amount: params.amount }]
     };
   }
   async buildWithdraw(params) {
@@ -3526,12 +3628,12 @@ var AaveV2Adapter = class {
     const [totalSupply, totalBorrow] = await Promise.all([
       client.readContract({
         address: aTokenAddress,
-        abi: ERC20_ABI2,
+        abi: ERC20_ABI22,
         functionName: "totalSupply"
       }).catch(() => 0n),
       client.readContract({
         address: variableDebtTokenAddress,
-        abi: ERC20_ABI2,
+        abi: ERC20_ABI22,
         functionName: "totalSupply"
       }).catch(() => 0n)
     ]);
@@ -8219,6 +8321,150 @@ function registerFarm(parent, getOpts, makeExecutor2) {
   });
 }
 
+// src/commands/setup.ts
+import pc2 from "picocolors";
+import { createInterface } from "readline";
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
+import { resolve as resolve3 } from "path";
+var DEFI_DIR = resolve3(process.env.HOME || "~", ".defi");
+var ENV_FILE = resolve3(DEFI_DIR, ".env");
+function ensureDefiDir() {
+  if (!existsSync3(DEFI_DIR)) mkdirSync2(DEFI_DIR, { recursive: true, mode: 448 });
+}
+function loadEnvFile() {
+  if (!existsSync3(ENV_FILE)) return {};
+  const lines = readFileSync3(ENV_FILE, "utf-8").split("\n");
+  const env = {};
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const eqIdx = trimmed.indexOf("=");
+    if (eqIdx > 0) {
+      env[trimmed.slice(0, eqIdx)] = trimmed.slice(eqIdx + 1);
+    }
+  }
+  return env;
+}
+function writeEnvFile(env) {
+  ensureDefiDir();
+  const lines = [
+    "# defi-cli configuration",
+    "# Generated by 'defi setup' \u2014 edit freely",
+    ""
+  ];
+  for (const [key, value] of Object.entries(env)) {
+    lines.push(`${key}=${value}`);
+  }
+  lines.push("");
+  writeFileSync2(ENV_FILE, lines.join("\n"), { mode: 384 });
+}
+function ask(rl, question) {
+  return new Promise((res) => rl.question(question, (answer) => res(answer.trim())));
+}
+function isValidAddress(s) {
+  return /^0x[0-9a-fA-F]{40}$/.test(s);
+}
+function isValidPrivateKey(s) {
+  return /^0x[0-9a-fA-F]{64}$/.test(s);
+}
+async function deriveAddress(privateKey) {
+  try {
+    const { privateKeyToAccount: privateKeyToAccount3 } = await import("viem/accounts");
+    const account = privateKeyToAccount3(privateKey);
+    return account.address;
+  } catch {
+    return null;
+  }
+}
+function registerSetup(program2) {
+  program2.command("setup").alias("init").description("Interactive setup wizard \u2014 configure wallet & RPC URLs").action(async () => {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+      console.log(pc2.cyan(pc2.bold("\n  defi-cli Setup Wizard\n")));
+      const existing = loadEnvFile();
+      if (Object.keys(existing).length > 0) {
+        console.log(pc2.white("  Current configuration:"));
+        for (const [key, value] of Object.entries(existing)) {
+          const masked = key.toLowerCase().includes("key") ? value.slice(0, 6) + "..." + value.slice(-4) : value;
+          console.log(`    ${pc2.cyan(key.padEnd(24))} ${pc2.gray(masked)}`);
+        }
+        console.log();
+        const overwrite = await ask(rl, "  Overwrite existing config? (y/N): ");
+        if (overwrite.toLowerCase() !== "y" && overwrite.toLowerCase() !== "yes") {
+          console.log(pc2.gray("\n  Keeping existing configuration.\n"));
+          rl.close();
+          return;
+        }
+        console.log();
+      }
+      const newEnv = {};
+      console.log(pc2.cyan(pc2.bold("  Wallet")));
+      const privateKey = await ask(rl, "  Private key (optional, for --broadcast, 0x...): ");
+      if (privateKey) {
+        const normalized = privateKey.startsWith("0x") ? privateKey : `0x${privateKey}`;
+        if (!isValidPrivateKey(normalized)) {
+          console.log(pc2.red("  Invalid private key (must be 0x + 64 hex chars). Skipped."));
+        } else {
+          newEnv.DEFI_PRIVATE_KEY = normalized;
+          const derived = await deriveAddress(normalized);
+          if (derived) {
+            newEnv.DEFI_WALLET_ADDRESS = derived;
+            console.log(`  ${pc2.green("OK")} derived address: ${pc2.gray(derived)}`);
+          }
+        }
+      }
+      if (!newEnv.DEFI_WALLET_ADDRESS) {
+        const address = await ask(rl, "  Wallet address (0x...): ");
+        if (address) {
+          if (!isValidAddress(address)) {
+            console.log(pc2.yellow("  Invalid address format. Skipping."));
+          } else {
+            newEnv.DEFI_WALLET_ADDRESS = address;
+            console.log(`  ${pc2.green("OK")} ${pc2.gray(address)}`);
+          }
+        }
+      }
+      console.log(pc2.cyan(pc2.bold("\n  RPC URLs")) + pc2.gray(" (press Enter to use public defaults)"));
+      const hyperevmRpc = await ask(rl, "  HyperEVM RPC URL: ");
+      if (hyperevmRpc) {
+        newEnv.HYPEREVM_RPC_URL = hyperevmRpc;
+        console.log(`  ${pc2.green("OK")} HyperEVM RPC set`);
+      }
+      const mantleRpc = await ask(rl, "  Mantle RPC URL: ");
+      if (mantleRpc) {
+        newEnv.MANTLE_RPC_URL = mantleRpc;
+        console.log(`  ${pc2.green("OK")} Mantle RPC set`);
+      }
+      const finalEnv = { ...existing, ...newEnv };
+      writeEnvFile(finalEnv);
+      console.log(pc2.cyan(pc2.bold("\n  Setup Complete!\n")));
+      console.log(`  Config:  ${pc2.gray(ENV_FILE)}`);
+      if (finalEnv.DEFI_WALLET_ADDRESS) {
+        console.log(`  Wallet:  ${pc2.gray(finalEnv.DEFI_WALLET_ADDRESS)}`);
+      }
+      if (finalEnv.DEFI_PRIVATE_KEY) {
+        console.log(`  Key:     ${pc2.green("configured")}`);
+      }
+      if (finalEnv.HYPEREVM_RPC_URL) {
+        console.log(`  HyperEVM RPC: ${pc2.gray(finalEnv.HYPEREVM_RPC_URL)}`);
+      }
+      if (finalEnv.MANTLE_RPC_URL) {
+        console.log(`  Mantle RPC:   ${pc2.gray(finalEnv.MANTLE_RPC_URL)}`);
+      }
+      console.log(pc2.bold(pc2.white("\n  Next steps:")));
+      console.log(`    ${pc2.green("defi portfolio")}          view balances & positions`);
+      console.log(`    ${pc2.green("defi scan")}               scan for exploits`);
+      console.log(`    ${pc2.green("defi dex quote")}          get a swap quote`);
+      console.log(`    ${pc2.green("defi --help")}             browse all commands
+`);
+      rl.close();
+    } catch (err) {
+      rl.close();
+      throw err;
+    }
+  });
+}
+
 // src/cli.ts
 var _require = createRequire(import.meta.url);
 var _pkg = _require("../package.json");
@@ -8270,6 +8516,7 @@ registerSwap(program, getOutputMode, makeExecutor);
 registerBridge(program, getOutputMode);
 registerNft(program, getOutputMode);
 registerFarm(program, getOutputMode, makeExecutor);
+registerSetup(program);
 program.command("agent").description("Agent mode: read JSON commands from stdin (for AI agents)").action(async () => {
   const executor = makeExecutor();
   process.stderr.write("Agent mode: reading JSON commands from stdin...\n");