@spectratools/aborean-cli 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 spectra-the-bot
+
+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/dist/cli.js

@@ -0,0 +1,653 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { readFileSync } from "fs";
+import { dirname, resolve } from "path";
+import { fileURLToPath } from "url";
+import { Cli, z } from "incur";
+
+// src/contracts/abis/CLFactory.abi.json
+var CLFactory_abi_default = [
+  {
+    type: "function",
+    name: "allPoolsLength",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "allPools",
+    inputs: [{ name: "index", type: "uint256", internalType: "uint256" }],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getPool",
+    inputs: [
+      { name: "tokenA", type: "address", internalType: "address" },
+      { name: "tokenB", type: "address", internalType: "address" },
+      { name: "tickSpacing", type: "int24", internalType: "int24" }
+    ],
+    outputs: [{ name: "pool", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "owner",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "poolImplementation",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "voter",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "tickSpacings",
+    inputs: [],
+    outputs: [{ name: "", type: "int24[]", internalType: "int24[]" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "tickSpacingToFee",
+    inputs: [{ name: "tickSpacing", type: "int24", internalType: "int24" }],
+    outputs: [{ name: "fee", type: "uint24", internalType: "uint24" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "isPool",
+    inputs: [{ name: "pool", type: "address", internalType: "address" }],
+    outputs: [{ name: "", type: "bool", internalType: "bool" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getSwapFee",
+    inputs: [{ name: "pool", type: "address", internalType: "address" }],
+    outputs: [{ name: "", type: "uint24", internalType: "uint24" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getUnstakedFee",
+    inputs: [{ name: "pool", type: "address", internalType: "address" }],
+    outputs: [{ name: "", type: "uint24", internalType: "uint24" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "defaultUnstakedFee",
+    inputs: [],
+    outputs: [{ name: "", type: "uint24", internalType: "uint24" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "swapFeeModule",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "unstakedFeeModule",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "factoryRegistry",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  }
+];
+
+// src/contracts/abis/PoolFactory.abi.json
+var PoolFactory_abi_default = [
+  {
+    type: "function",
+    name: "allPoolsLength",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "allPools",
+    inputs: [{ name: "index", type: "uint256", internalType: "uint256" }],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getPool",
+    inputs: [
+      { name: "tokenA", type: "address", internalType: "address" },
+      { name: "tokenB", type: "address", internalType: "address" },
+      { name: "stable", type: "bool", internalType: "bool" }
+    ],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "isPair",
+    inputs: [{ name: "pool", type: "address", internalType: "address" }],
+    outputs: [{ name: "", type: "bool", internalType: "bool" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getFee",
+    inputs: [
+      { name: "pool", type: "address", internalType: "address" },
+      { name: "stable", type: "bool", internalType: "bool" }
+    ],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "implementation",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "voter",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  }
+];
+
+// src/contracts/abis/Voter.abi.json
+var Voter_abi_default = [
+  {
+    type: "function",
+    name: "length",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "totalWeight",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "gauges",
+    inputs: [{ name: "pool", type: "address", internalType: "address" }],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "poolForGauge",
+    inputs: [{ name: "gauge", type: "address", internalType: "address" }],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "weights",
+    inputs: [{ name: "pool", type: "address", internalType: "address" }],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "isAlive",
+    inputs: [{ name: "gauge", type: "address", internalType: "address" }],
+    outputs: [{ name: "", type: "bool", internalType: "bool" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "isGauge",
+    inputs: [{ name: "", type: "address", internalType: "address" }],
+    outputs: [{ name: "", type: "bool", internalType: "bool" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "ve",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "minter",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "factoryRegistry",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "forwarder",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "governor",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "emergencyCouncil",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "maxVotingNum",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "claimable",
+    inputs: [{ name: "gauge", type: "address", internalType: "address" }],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  }
+];
+
+// src/contracts/abis/VotingEscrow.abi.json
+var VotingEscrow_abi_default = [
+  {
+    type: "function",
+    name: "totalSupply",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "balanceOf",
+    inputs: [{ name: "owner", type: "address", internalType: "address" }],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "locked",
+    inputs: [{ name: "tokenId", type: "uint256", internalType: "uint256" }],
+    outputs: [
+      { name: "amount", type: "int128", internalType: "int128" },
+      { name: "end", type: "uint256", internalType: "uint256" },
+      { name: "isPermanent", type: "bool", internalType: "bool" }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "ownerOf",
+    inputs: [{ name: "tokenId", type: "uint256", internalType: "uint256" }],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "tokenOfOwnerByIndex",
+    inputs: [
+      { name: "owner", type: "address", internalType: "address" },
+      { name: "index", type: "uint256", internalType: "uint256" }
+    ],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "balanceOfNFT",
+    inputs: [{ name: "tokenId", type: "uint256", internalType: "uint256" }],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "token",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "supply",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  }
+];
+
+// src/contracts/abis.ts
+var clFactoryAbi = CLFactory_abi_default;
+var poolFactoryAbi = PoolFactory_abi_default;
+var voterAbi = Voter_abi_default;
+var votingEscrowAbi = VotingEscrow_abi_default;
+
+// src/contracts/addresses.ts
+var ABOREAN_V2_ADDRESSES = {
+  /** ABX protocol token (ERC-20) */
+  abx: "0x4C68E4102c0F120cce9F08625bd12079806b7C4D",
+  /** Airdrop distributor for permanently locked veNFTs */
+  airdropDistributor: "0xd29d05bFfb2F0AfBB76ed217d726Ff5922253086",
+  /** Registry of approved pool/gauge/reward factories */
+  factoryRegistry: "0x5927E0C4b307Af16260327DE3276CE17d8A4aB49",
+  /** Trusted forwarder */
+  forwarder: "0x3f91b806F1968Fca85C08A7eE9A7262D7207A9c1",
+  /** Gauge factory (v2) */
+  gaugeFactory: "0x29BfEd845b1C10e427766b21d4533800B6f4e111",
+  /** Managed rewards factory */
+  managedRewardsFactory: "0x889d93f9c3586ec7CD287eE4e7C96E544985Ee95",
+  /** Protocol token minter — distributes emissions to Voter and rebases to RewardsDistributor */
+  minter: "0x58564Fcfc5a0C57887eFC0beDeC3EB5Ec37f1626",
+  /** V2 Pool implementation */
+  pool: "0x3E5791019A9Fae2805d69965b06dcEFC43Cd1A79",
+  /** V2 Pool factory */
+  poolFactory: "0xF6cDfFf7Ad51caaD860e7A35d6D4075d74039a6B",
+  /** Rebases distribution for veNFT lockers */
+  rewardsDistributor: "0x36cbf77D8F8355D7A077d670C29E290E41367072",
+  /** V2 swap router */
+  router: "0xE8142D2f82036B6FC1e79E4aE85cF53FBFfDC998",
+  /** veNFT art proxy */
+  veArtProxy: "0x53AF068205CB466d7Ce6e55fD1E64eB9eBcB7ce0",
+  /** Handles votes, gauge creation, and emission distribution */
+  voter: "0xC0F53703e9f4b79fA2FB09a2aeBA487FA97729c9",
+  /** Vote-escrow NFT (veABX) */
+  votingEscrow: "0x27B04370D8087e714a9f557c1EFF7901cea6bB63",
+  /** Voting rewards factory */
+  votingRewardsFactory: "0xCEf48ee1b2F7c0833D6F097c69D1ed4159b60958"
+};
+var ABOREAN_CL_ADDRESSES = {
+  /** CL pool factory */
+  clFactory: "0x8cfE21F272FdFDdf42851f6282c0f998756eEf27",
+  /** CL gauge factory */
+  clGaugeFactory: "0xF0361d1aD99971791C002E9c281B18739e9abad8",
+  /** CL gauge implementation */
+  clGauge: "0xB037CBbD1208fBc58D3cAc91a22E55D7727ac2BF",
+  /** CL pool implementation */
+  clPool: "0x751C0c219Ef28A96d6B3926b8247fe508C4277BC",
+  /** Custom swap fee module */
+  customSwapFeeModule: "0xd09DCeeB71bF20FE229E0dd5D739060efFB60e14",
+  /** Custom unstaked fee module */
+  customUnstakedFeeModule: "0x2F59EC82D990DdbE501b2B5E9796e3d5BB45438F",
+  /** Mixed-route quoter (v2 + CL paths) */
+  mixedRouteQuoterV1: "0x9dB89879fEB50fDeAa52EF9a1235BAC242E4Efc7",
+  /** NFT position manager for CL positions */
+  nonfungiblePositionManager: "0xa4890B89dC628baE614780079ACc951Fb0ECdC5F",
+  /** NFT position descriptor (metadata) */
+  nonfungibleTokenPositionDescriptor: "0x04113b91BF0F9D87d712f3CA843Fb1374AEE8A89",
+  /** Quoter V2 for CL swap quotes */
+  quoterV2: "0x9055782E3797231b970C067d067Ee7dFA3396Cdd",
+  /** CL swap router */
+  swapRouter: "0xAda5d0E79681038A9547fe6a59f1413F3E720839"
+};
+var ABOREAN_ADDRESSES = {
+  ...ABOREAN_V2_ADDRESSES,
+  ...ABOREAN_CL_ADDRESSES
+};
+
+// src/contracts/client.ts
+import { http, createPublicClient, defineChain } from "viem";
+var abstractMainnet = defineChain({
+  id: 2741,
+  name: "Abstract Mainnet",
+  nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+  rpcUrls: {
+    default: { http: ["https://api.mainnet.abs.xyz"] },
+    public: { http: ["https://api.mainnet.abs.xyz"] }
+  },
+  contracts: {
+    multicall3: {
+      address: "0xcA11bde05977b3631167028862bE2a173976CA11"
+    }
+  }
+});
+function createAboreanPublicClient(rpcUrl) {
+  return createPublicClient({
+    chain: abstractMainnet,
+    transport: http(rpcUrl ?? process.env.ABSTRACT_RPC_URL ?? "https://api.mainnet.abs.xyz")
+  });
+}
+
+// src/error-handling.ts
+import { AsyncLocalStorage } from "async_hooks";
+import { Errors } from "incur";
+var VIEM_VERSION_PATTERN = /\n*Version:\s*viem@[^\n]+/i;
+var VIEM_VERSION_PATTERN_GLOBAL = /\n*Version:\s*viem@[^\n]+/gi;
+var debugFlagStore = new AsyncLocalStorage();
+var VIEM_ERROR_NAMES = /* @__PURE__ */ new Set([
+  "CallExecutionError",
+  "ContractFunctionExecutionError",
+  "ContractFunctionRevertedError",
+  "HttpRequestError",
+  "InvalidAddressError",
+  "TransactionExecutionError"
+]);
+function parseDebugFlag(argv) {
+  const cleaned = [];
+  let debug = false;
+  for (let i = 0; i < argv.length; i += 1) {
+    const token = argv[i];
+    if (token === "--debug") {
+      debug = true;
+      continue;
+    }
+    if (token === "--debug=true" || token === "--debug=1") {
+      debug = true;
+      continue;
+    }
+    if (token === "--debug=false" || token === "--debug=0") {
+      debug = false;
+      continue;
+    }
+    cleaned.push(token);
+  }
+  return { argv: cleaned, debug };
+}
+function isViemLikeError(error) {
+  if (!(error instanceof Error)) return false;
+  const shortMessage = error.shortMessage;
+  return VIEM_ERROR_NAMES.has(error.name) || VIEM_VERSION_PATTERN.test(error.message) || typeof shortMessage === "string" && error.message.includes("Docs: https://viem.sh");
+}
+function sanitizeViemMessage(message) {
+  return message.replace(VIEM_VERSION_PATTERN_GLOBAL, "").trim();
+}
+function toFriendlyViemError(error) {
+  const shortMessage = typeof error.shortMessage === "string" && error.shortMessage.trim().length > 0 ? error.shortMessage.trim() : void 0;
+  if (error.name === "InvalidAddressError" || shortMessage?.startsWith('Address "')) {
+    return {
+      code: "INVALID_ADDRESS",
+      message: `${shortMessage ?? "Invalid address."} Use a valid 0x-prefixed 20-byte address. Run with --debug for full error details.`
+    };
+  }
+  if (shortMessage?.toLowerCase().includes("http request failed") || error.message.toLowerCase().includes("http request failed")) {
+    return {
+      code: "RPC_CONNECTION_FAILED",
+      message: "RPC connection failed. Check ABSTRACT_RPC_URL and try again. Run with --debug for full error details."
+    };
+  }
+  if (shortMessage || VIEM_VERSION_PATTERN.test(error.message)) {
+    return {
+      code: "UPSTREAM_ERROR",
+      message: `${sanitizeViemMessage(shortMessage ?? error.message)} Run with --debug for full error details.`
+    };
+  }
+  return void 0;
+}
+function isMissingRequiredArgValidation(error) {
+  return error.fieldErrors.some((fieldError) => {
+    const msg = fieldError.message.toLowerCase();
+    return msg.includes("received undefined") || fieldError.received === "";
+  });
+}
+function missingArgPaths(error) {
+  const paths = /* @__PURE__ */ new Set();
+  for (const fieldError of error.fieldErrors) {
+    const msg = fieldError.message.toLowerCase();
+    if (msg.includes("received undefined") || fieldError.received === "") {
+      paths.add(fieldError.path);
+    }
+  }
+  return [...paths];
+}
+function toFriendlyValidationError(ctx, error) {
+  const missing = missingArgPaths(error);
+  if (missing.length === 0) return void 0;
+  const helpCommand = `${ctx.name} ${ctx.command} --help`;
+  const argsList = missing.join(", ");
+  return {
+    code: "VALIDATION_ERROR",
+    cta: {
+      description: "See command usage:",
+      commands: [{ command: helpCommand }]
+    },
+    message: missing.length === 1 ? `Missing required argument: ${argsList}. Run \`${helpCommand}\` for usage.` : `Missing required arguments: ${argsList}. Run \`${helpCommand}\` for usage.`
+  };
+}
+function handleError(ctx, error) {
+  if (debugFlagStore.getStore()) throw error;
+  if (error instanceof Errors.ValidationError && isMissingRequiredArgValidation(error)) {
+    const friendly = toFriendlyValidationError(ctx, error);
+    if (friendly) {
+      return ctx.error(friendly);
+    }
+  }
+  if (isViemLikeError(error)) {
+    const friendly = toFriendlyViemError(error);
+    if (friendly) {
+      return ctx.error(friendly);
+    }
+  }
+  throw error;
+}
+function applyFriendlyErrorHandling(cli2) {
+  const originalServe = cli2.serve.bind(cli2);
+  cli2.serve = (async (argv, options) => {
+    const rawArgv = argv ?? process.argv.slice(2);
+    const parsed = parseDebugFlag(rawArgv);
+    return debugFlagStore.run(parsed.debug, () => originalServe(parsed.argv, options));
+  });
+  cli2.use(async (context, next) => {
+    try {
+      await next();
+    } catch (error) {
+      return handleError(context, error);
+    }
+  });
+}
+
+// src/cli.ts
+var __dirname = dirname(fileURLToPath(import.meta.url));
+var pkg = JSON.parse(readFileSync(resolve(__dirname, "../package.json"), "utf8"));
+var cli = Cli.create("aborean", {
+  version: pkg.version,
+  description: "Aborean Finance DEX CLI for Abstract chain."
+});
+var rootEnv = z.object({
+  ABSTRACT_RPC_URL: z.string().optional().describe("Abstract RPC URL override")
+});
+cli.command("status", {
+  description: "Get a cross-contract Aborean protocol snapshot (pool counts, gauge count, veABX supply).",
+  env: rootEnv,
+  output: z.object({
+    v2PoolCount: z.number().describe("Number of V2 AMM pools"),
+    clPoolCount: z.number().describe("Number of Slipstream (CL) pools"),
+    gaugeCount: z.number().describe("Number of pools with gauges"),
+    totalVotingWeight: z.string().describe("Total voting weight (wei)"),
+    veABXTotalSupply: z.string().describe("Total veABX supply (wei)"),
+    veABXLockedSupply: z.string().describe("Total ABX locked in VotingEscrow (wei)")
+  }),
+  examples: [{ description: "Fetch the current Aborean protocol status" }],
+  async run(c) {
+    const client = createAboreanPublicClient(c.env.ABSTRACT_RPC_URL);
+    const [
+      v2PoolCount,
+      clPoolCount,
+      gaugeCount,
+      totalVotingWeight,
+      veABXTotalSupply,
+      veABXLockedSupply
+    ] = await Promise.all([
+      client.readContract({
+        abi: poolFactoryAbi,
+        address: ABOREAN_V2_ADDRESSES.poolFactory,
+        functionName: "allPoolsLength"
+      }),
+      client.readContract({
+        abi: clFactoryAbi,
+        address: ABOREAN_CL_ADDRESSES.clFactory,
+        functionName: "allPoolsLength"
+      }),
+      client.readContract({
+        abi: voterAbi,
+        address: ABOREAN_V2_ADDRESSES.voter,
+        functionName: "length"
+      }),
+      client.readContract({
+        abi: voterAbi,
+        address: ABOREAN_V2_ADDRESSES.voter,
+        functionName: "totalWeight"
+      }),
+      client.readContract({
+        abi: votingEscrowAbi,
+        address: ABOREAN_V2_ADDRESSES.votingEscrow,
+        functionName: "totalSupply"
+      }),
+      client.readContract({
+        abi: votingEscrowAbi,
+        address: ABOREAN_V2_ADDRESSES.votingEscrow,
+        functionName: "supply"
+      })
+    ]);
+    return c.ok({
+      v2PoolCount: Number(v2PoolCount),
+      clPoolCount: Number(clPoolCount),
+      gaugeCount: Number(gaugeCount),
+      totalVotingWeight: String(totalVotingWeight),
+      veABXTotalSupply: String(veABXTotalSupply),
+      veABXLockedSupply: String(veABXLockedSupply)
+    });
+  }
+});
+applyFriendlyErrorHandling(cli);
+cli.serve();
+export {
+  cli
+};

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@spectratools/aborean-cli",
+  "version": "0.2.0",
+  "description": "CLI for Aborean Finance DEX on Abstract (pools, swaps, gauges, voting escrow).",
+  "type": "module",
+  "license": "MIT",
+  "author": "spectra-the-bot",
+  "keywords": [
+    "aborean",
+    "abstract",
+    "dex",
+    "amm",
+    "ve33",
+    "ethereum",
+    "web3",
+    "cli",
+    "incur",
+    "spectratools"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/spectra-the-bot/spectra-tools.git",
+    "directory": "packages/aborean"
+  },
+  "homepage": "https://github.com/spectra-the-bot/spectra-tools/tree/main/packages/aborean#readme",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "aborean-cli": "./dist/cli.js"
+  },
+  "dependencies": {
+    "incur": "^0.2.2",
+    "ox": "^0.14.0",
+    "viem": "^2.47.0",
+    "@spectratools/cli-shared": "0.1.1"
+  },
+  "devDependencies": {
+    "typescript": "5.7.3",
+    "vitest": "2.1.8"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "main": "./dist/cli.js",
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run"
+  }
+}