@spectratools/aborean-cli 0.2.0 → 0.3.0

package/dist/cli.js

@@ -4,6 +4,9 @@
 import { readFileSync } from "fs";
 import { dirname, resolve } from "path";
 import { fileURLToPath } from "url";
+import { Cli as Cli4, z as z4 } from "incur";
+
+// src/commands/gauges.ts
 import { Cli, z } from "incur";
 
 // src/contracts/abis/CLFactory.abi.json
@@ -119,6 +122,140 @@ var CLFactory_abi_default = [
   }
 ];
 
+// src/contracts/abis/Gauge.abi.json
+var Gauge_abi_default = [
+  {
+    type: "function",
+    name: "stakingToken",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "rewardToken",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "periodFinish",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "rewardRate",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "lastUpdateTime",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "rewardPerTokenStored",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "totalSupply",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "balanceOf",
+    inputs: [{ name: "account", type: "address", internalType: "address" }],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "earned",
+    inputs: [{ name: "account", type: "address", internalType: "address" }],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "fees0",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "fees1",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "left",
+    inputs: [],
+    outputs: [{ name: "_left", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  }
+];
+
+// src/contracts/abis/Minter.abi.json
+var Minter_abi_default = [
+  {
+    type: "function",
+    name: "WEEK",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "weekly",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "activePeriod",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "epochCount",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "teamRate",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "tailEmissionRate",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  }
+];
+
 // src/contracts/abis/PoolFactory.abi.json
 var PoolFactory_abi_default = [
   {
@@ -179,6 +316,59 @@ var PoolFactory_abi_default = [
   }
 ];
 
+// src/contracts/abis/RewardsDistributor.abi.json
+var RewardsDistributor_abi_default = [
+  {
+    type: "function",
+    name: "WEEK",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "startTime",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "timeCursorOf",
+    inputs: [{ name: "tokenId", type: "uint256", internalType: "uint256" }],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "lastTokenTime",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "token",
+    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: "claimable",
+    inputs: [{ name: "tokenId", type: "uint256", internalType: "uint256" }],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  }
+];
+
 // src/contracts/abis/Voter.abi.json
 var Voter_abi_default = [
   {
@@ -209,6 +399,20 @@ var Voter_abi_default = [
     outputs: [{ name: "", type: "address", internalType: "address" }],
     stateMutability: "view"
   },
+  {
+    type: "function",
+    name: "gaugeToFees",
+    inputs: [{ name: "gauge", type: "address", internalType: "address" }],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "gaugeToBribe",
+    inputs: [{ name: "gauge", type: "address", internalType: "address" }],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
   {
     type: "function",
     name: "weights",
@@ -216,6 +420,30 @@ var Voter_abi_default = [
     outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
     stateMutability: "view"
   },
+  {
+    type: "function",
+    name: "votes",
+    inputs: [
+      { name: "tokenId", type: "uint256", internalType: "uint256" },
+      { name: "pool", type: "address", internalType: "address" }
+    ],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "usedWeights",
+    inputs: [{ name: "tokenId", type: "uint256", internalType: "uint256" }],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "lastVoted",
+    inputs: [{ name: "tokenId", type: "uint256", internalType: "uint256" }],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
   {
     type: "function",
     name: "isAlive",
@@ -265,6 +493,13 @@ var Voter_abi_default = [
     outputs: [{ name: "", type: "address", internalType: "address" }],
     stateMutability: "view"
   },
+  {
+    type: "function",
+    name: "epochGovernor",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
   {
     type: "function",
     name: "emergencyCouncil",
@@ -297,6 +532,51 @@ var VotingEscrow_abi_default = [
     outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
     stateMutability: "view"
   },
+  {
+    type: "function",
+    name: "supply",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "permanentLockBalance",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "epoch",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "pointHistory",
+    inputs: [{ name: "_loc", type: "uint256", internalType: "uint256" }],
+    outputs: [
+      {
+        name: "",
+        type: "tuple",
+        internalType: "struct IVotingEscrow.GlobalPoint",
+        components: [
+          { name: "bias", type: "int128", internalType: "int128" },
+          { name: "slope", type: "int128", internalType: "int128" },
+          { name: "ts", type: "uint256", internalType: "uint256" },
+          { name: "blk", type: "uint256", internalType: "uint256" },
+          {
+            name: "permanentLockBalance",
+            type: "uint256",
+            internalType: "uint256"
+          }
+        ]
+      }
+    ],
+    stateMutability: "view"
+  },
   {
     type: "function",
     name: "balanceOf",
@@ -345,21 +625,56 @@ var VotingEscrow_abi_default = [
     inputs: [],
     outputs: [{ name: "", type: "address", internalType: "address" }],
     stateMutability: "view"
-  },
+  }
+];
+
+// src/contracts/abis/VotingReward.abi.json
+var VotingReward_abi_default = [
   {
     type: "function",
-    name: "supply",
+    name: "rewardsListLength",
     inputs: [],
     outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
     stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "rewards",
+    inputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "tokenRewardsPerEpoch",
+    inputs: [
+      { name: "token", type: "address", internalType: "address" },
+      { name: "epochStart", type: "uint256", internalType: "uint256" }
+    ],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "earned",
+    inputs: [
+      { name: "token", type: "address", internalType: "address" },
+      { name: "tokenId", type: "uint256", internalType: "uint256" }
+    ],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
   }
 ];
 
 // src/contracts/abis.ts
 var clFactoryAbi = CLFactory_abi_default;
+var gaugeAbi = Gauge_abi_default;
+var minterAbi = Minter_abi_default;
 var poolFactoryAbi = PoolFactory_abi_default;
+var rewardsDistributorAbi = RewardsDistributor_abi_default;
 var voterAbi = Voter_abi_default;
 var votingEscrowAbi = VotingEscrow_abi_default;
+var votingRewardAbi = VotingReward_abi_default;
 
 // src/contracts/addresses.ts
 var ABOREAN_V2_ADDRESSES = {
@@ -446,6 +761,985 @@ function createAboreanPublicClient(rpcUrl) {
   });
 }
 
+// src/commands/_common.ts
+import { checksumAddress, weiToEth } from "@spectratools/cli-shared";
+var ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+function toChecksum(address) {
+  try {
+    return checksumAddress(address);
+  } catch {
+    return address;
+  }
+}
+function asNum(value) {
+  return Number(value);
+}
+function relTime(unixSeconds) {
+  const ts = typeof unixSeconds === "bigint" ? Number(unixSeconds) : unixSeconds;
+  if (!Number.isFinite(ts) || ts <= 0) return "n/a";
+  const delta = ts - Math.floor(Date.now() / 1e3);
+  const abs = Math.abs(delta);
+  const hours = Math.floor(abs / 3600);
+  const minutes = Math.floor(abs % 3600 / 60);
+  const label = hours > 0 ? `${hours}h ${minutes}m` : `${minutes}m`;
+  return delta >= 0 ? `in ${label}` : `${label} ago`;
+}
+function clampPositive(seconds) {
+  return seconds > 0 ? seconds : 0;
+}
+
+// src/commands/gauges.ts
+var env = z.object({
+  ABSTRACT_RPC_URL: z.string().optional().describe("Abstract RPC URL override")
+});
+async function discoverGaugePools(client) {
+  const [v2PoolCount, clPoolCount] = 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"
+    })
+  ]);
+  const v2Indices = Array.from({ length: asNum(v2PoolCount) }, (_, i) => BigInt(i));
+  const clIndices = Array.from({ length: asNum(clPoolCount) }, (_, i) => BigInt(i));
+  const [v2Pools, clPools] = await Promise.all([
+    v2Indices.length ? client.multicall({
+      allowFailure: false,
+      contracts: v2Indices.map((index) => ({
+        abi: poolFactoryAbi,
+        address: ABOREAN_V2_ADDRESSES.poolFactory,
+        functionName: "allPools",
+        args: [index]
+      }))
+    }) : Promise.resolve([]),
+    clIndices.length ? client.multicall({
+      allowFailure: false,
+      contracts: clIndices.map((index) => ({
+        abi: clFactoryAbi,
+        address: ABOREAN_CL_ADDRESSES.clFactory,
+        functionName: "allPools",
+        args: [index]
+      }))
+    }) : Promise.resolve([])
+  ]);
+  const pools = [...v2Pools, ...clPools];
+  if (!pools.length) return [];
+  const gauges2 = await client.multicall({
+    allowFailure: false,
+    contracts: pools.map((pool) => ({
+      abi: voterAbi,
+      address: ABOREAN_V2_ADDRESSES.voter,
+      functionName: "gauges",
+      args: [pool]
+    }))
+  });
+  return pools.map((pool, index) => ({ pool, gauge: gauges2[index] })).filter(({ gauge }) => gauge.toLowerCase() !== ZERO_ADDRESS.toLowerCase());
+}
+var gauges = Cli.create("gauges", {
+  description: "Inspect Aborean gauge emissions, staking, and user positions."
+});
+gauges.command("list", {
+  description: "List active gauges with pool, emissions, and staking stats.",
+  env,
+  output: z.object({
+    gauges: z.array(
+      z.object({
+        pool: z.string(),
+        gauge: z.string(),
+        rewardToken: z.string(),
+        rewardRate: z.string(),
+        totalStaked: z.string(),
+        claimableEmissions: z.string(),
+        periodFinish: z.number(),
+        periodFinishRelative: z.string()
+      })
+    ),
+    count: z.number()
+  }),
+  examples: [{ description: "List all active gauges and current emissions state" }],
+  async run(c) {
+    const client = createAboreanPublicClient(c.env.ABSTRACT_RPC_URL);
+    const gaugePools = await discoverGaugePools(client);
+    if (!gaugePools.length) {
+      return c.ok({ gauges: [], count: 0 });
+    }
+    const details = await client.multicall({
+      allowFailure: false,
+      contracts: gaugePools.flatMap(({ gauge }) => [
+        {
+          abi: gaugeAbi,
+          address: gauge,
+          functionName: "rewardToken"
+        },
+        {
+          abi: gaugeAbi,
+          address: gauge,
+          functionName: "rewardRate"
+        },
+        {
+          abi: gaugeAbi,
+          address: gauge,
+          functionName: "totalSupply"
+        },
+        {
+          abi: gaugeAbi,
+          address: gauge,
+          functionName: "periodFinish"
+        },
+        {
+          abi: voterAbi,
+          address: ABOREAN_V2_ADDRESSES.voter,
+          functionName: "claimable",
+          args: [gauge]
+        }
+      ])
+    });
+    const items = gaugePools.map(({ pool, gauge }, index) => {
+      const offset = index * 5;
+      const rewardToken = details[offset];
+      const rewardRate = details[offset + 1];
+      const totalStaked = details[offset + 2];
+      const periodFinish = details[offset + 3];
+      const claimableEmissions = details[offset + 4];
+      return {
+        pool: toChecksum(pool),
+        gauge: toChecksum(gauge),
+        rewardToken: toChecksum(rewardToken),
+        rewardRate: rewardRate.toString(),
+        totalStaked: totalStaked.toString(),
+        claimableEmissions: claimableEmissions.toString(),
+        periodFinish: asNum(periodFinish),
+        periodFinishRelative: relTime(periodFinish)
+      };
+    });
+    return c.ok({
+      gauges: items,
+      count: items.length
+    });
+  }
+});
+gauges.command("info", {
+  description: "Get detailed state for one gauge address.",
+  args: z.object({
+    gauge: z.string().describe("Gauge contract address")
+  }),
+  env,
+  output: z.object({
+    gauge: z.string(),
+    pool: z.string(),
+    isAlive: z.boolean(),
+    stakingToken: z.string(),
+    rewardToken: z.string(),
+    totalStaked: z.string(),
+    rewardRate: z.string(),
+    rewardPerTokenStored: z.string(),
+    fees0: z.string(),
+    fees1: z.string(),
+    left: z.string(),
+    periodFinish: z.number(),
+    periodFinishRelative: z.string(),
+    lastUpdateTime: z.number(),
+    bribeContract: z.string(),
+    feeContract: z.string()
+  }),
+  examples: [
+    {
+      args: { gauge: "0x0000000000000000000000000000000000000001" },
+      description: "Inspect one gauge in detail"
+    }
+  ],
+  async run(c) {
+    const client = createAboreanPublicClient(c.env.ABSTRACT_RPC_URL);
+    const gauge = c.args.gauge;
+    const [
+      pool,
+      isAlive,
+      bribeContract,
+      feeContract,
+      stakingToken,
+      rewardToken,
+      totalStaked,
+      rewardRate,
+      periodFinish,
+      lastUpdateTime,
+      rewardPerTokenStored,
+      fees0,
+      fees1,
+      left
+    ] = await Promise.all([
+      client.readContract({
+        abi: voterAbi,
+        address: ABOREAN_V2_ADDRESSES.voter,
+        functionName: "poolForGauge",
+        args: [gauge]
+      }),
+      client.readContract({
+        abi: voterAbi,
+        address: ABOREAN_V2_ADDRESSES.voter,
+        functionName: "isAlive",
+        args: [gauge]
+      }),
+      client.readContract({
+        abi: voterAbi,
+        address: ABOREAN_V2_ADDRESSES.voter,
+        functionName: "gaugeToBribe",
+        args: [gauge]
+      }),
+      client.readContract({
+        abi: voterAbi,
+        address: ABOREAN_V2_ADDRESSES.voter,
+        functionName: "gaugeToFees",
+        args: [gauge]
+      }),
+      client.readContract({
+        abi: gaugeAbi,
+        address: gauge,
+        functionName: "stakingToken"
+      }),
+      client.readContract({
+        abi: gaugeAbi,
+        address: gauge,
+        functionName: "rewardToken"
+      }),
+      client.readContract({
+        abi: gaugeAbi,
+        address: gauge,
+        functionName: "totalSupply"
+      }),
+      client.readContract({
+        abi: gaugeAbi,
+        address: gauge,
+        functionName: "rewardRate"
+      }),
+      client.readContract({
+        abi: gaugeAbi,
+        address: gauge,
+        functionName: "periodFinish"
+      }),
+      client.readContract({
+        abi: gaugeAbi,
+        address: gauge,
+        functionName: "lastUpdateTime"
+      }),
+      client.readContract({
+        abi: gaugeAbi,
+        address: gauge,
+        functionName: "rewardPerTokenStored"
+      }),
+      client.readContract({
+        abi: gaugeAbi,
+        address: gauge,
+        functionName: "fees0"
+      }),
+      client.readContract({
+        abi: gaugeAbi,
+        address: gauge,
+        functionName: "fees1"
+      }),
+      client.readContract({
+        abi: gaugeAbi,
+        address: gauge,
+        functionName: "left"
+      })
+    ]);
+    return c.ok({
+      gauge: toChecksum(gauge),
+      pool: toChecksum(pool),
+      isAlive,
+      stakingToken: toChecksum(stakingToken),
+      rewardToken: toChecksum(rewardToken),
+      totalStaked: totalStaked.toString(),
+      rewardRate: rewardRate.toString(),
+      rewardPerTokenStored: rewardPerTokenStored.toString(),
+      fees0: fees0.toString(),
+      fees1: fees1.toString(),
+      left: left.toString(),
+      periodFinish: asNum(periodFinish),
+      periodFinishRelative: relTime(periodFinish),
+      lastUpdateTime: asNum(lastUpdateTime),
+      bribeContract: toChecksum(bribeContract),
+      feeContract: toChecksum(feeContract)
+    });
+  }
+});
+gauges.command("staked", {
+  description: "Show one address staking positions across all gauges.",
+  args: z.object({
+    address: z.string().describe("Wallet address to inspect")
+  }),
+  env,
+  output: z.object({
+    address: z.string(),
+    positions: z.array(
+      z.object({
+        pool: z.string(),
+        gauge: z.string(),
+        rewardToken: z.string(),
+        staked: z.string(),
+        earned: z.string()
+      })
+    ),
+    count: z.number()
+  }),
+  examples: [
+    {
+      args: { address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" },
+      description: "List gauge positions for a wallet"
+    }
+  ],
+  async run(c) {
+    const client = createAboreanPublicClient(c.env.ABSTRACT_RPC_URL);
+    const gaugePools = await discoverGaugePools(client);
+    if (!gaugePools.length) {
+      return c.ok({
+        address: toChecksum(c.args.address),
+        positions: [],
+        count: 0
+      });
+    }
+    const positionData = await client.multicall({
+      allowFailure: false,
+      contracts: gaugePools.flatMap(({ gauge }) => [
+        {
+          abi: gaugeAbi,
+          address: gauge,
+          functionName: "balanceOf",
+          args: [c.args.address]
+        },
+        {
+          abi: gaugeAbi,
+          address: gauge,
+          functionName: "earned",
+          args: [c.args.address]
+        },
+        {
+          abi: gaugeAbi,
+          address: gauge,
+          functionName: "rewardToken"
+        }
+      ])
+    });
+    const positions = gaugePools.map(({ pool, gauge }, index) => {
+      const offset = index * 3;
+      const staked = positionData[offset];
+      const earned = positionData[offset + 1];
+      const rewardToken = positionData[offset + 2];
+      return {
+        pool: toChecksum(pool),
+        gauge: toChecksum(gauge),
+        rewardToken: toChecksum(rewardToken),
+        staked,
+        earned
+      };
+    }).filter((position) => position.staked > 0n || position.earned > 0n).map((position) => ({
+      pool: position.pool,
+      gauge: position.gauge,
+      rewardToken: position.rewardToken,
+      staked: position.staked.toString(),
+      earned: position.earned.toString()
+    }));
+    return c.ok({
+      address: toChecksum(c.args.address),
+      positions,
+      count: positions.length
+    });
+  }
+});
+
+// src/commands/ve.ts
+import { Cli as Cli2, z as z2 } from "incur";
+var env2 = z2.object({
+  ABSTRACT_RPC_URL: z2.string().optional().describe("Abstract RPC URL override")
+});
+var ve = Cli2.create("ve", {
+  description: "Inspect Aborean VotingEscrow (veABX) global and per-NFT lock state."
+});
+ve.command("stats", {
+  description: "Get global VotingEscrow supply, locks, and decay checkpoint data.",
+  env: env2,
+  output: z2.object({
+    token: z2.string(),
+    totalVotingPower: z2.string(),
+    totalLocked: z2.string(),
+    permanentLocked: z2.string(),
+    epoch: z2.number(),
+    decayBias: z2.string(),
+    decaySlope: z2.string(),
+    lastCheckpointTimestamp: z2.number(),
+    lastCheckpointBlock: z2.number()
+  }),
+  examples: [{ description: "Show global veABX state and decay metrics" }],
+  async run(c) {
+    const client = createAboreanPublicClient(c.env.ABSTRACT_RPC_URL);
+    const [token, totalVotingPower, totalLocked, permanentLocked, epoch] = await Promise.all([
+      client.readContract({
+        abi: votingEscrowAbi,
+        address: ABOREAN_V2_ADDRESSES.votingEscrow,
+        functionName: "token"
+      }),
+      client.readContract({
+        abi: votingEscrowAbi,
+        address: ABOREAN_V2_ADDRESSES.votingEscrow,
+        functionName: "totalSupply"
+      }),
+      client.readContract({
+        abi: votingEscrowAbi,
+        address: ABOREAN_V2_ADDRESSES.votingEscrow,
+        functionName: "supply"
+      }),
+      client.readContract({
+        abi: votingEscrowAbi,
+        address: ABOREAN_V2_ADDRESSES.votingEscrow,
+        functionName: "permanentLockBalance"
+      }),
+      client.readContract({
+        abi: votingEscrowAbi,
+        address: ABOREAN_V2_ADDRESSES.votingEscrow,
+        functionName: "epoch"
+      })
+    ]);
+    const point = await client.readContract({
+      abi: votingEscrowAbi,
+      address: ABOREAN_V2_ADDRESSES.votingEscrow,
+      functionName: "pointHistory",
+      args: [epoch]
+    });
+    return c.ok({
+      token: toChecksum(token),
+      totalVotingPower: totalVotingPower.toString(),
+      totalLocked: totalLocked.toString(),
+      permanentLocked: permanentLocked.toString(),
+      epoch: asNum(epoch),
+      decayBias: point.bias.toString(),
+      decaySlope: point.slope.toString(),
+      lastCheckpointTimestamp: asNum(point.ts),
+      lastCheckpointBlock: asNum(point.blk)
+    });
+  }
+});
+ve.command("lock", {
+  description: "Get lock details and voting power for one veNFT token id.",
+  args: z2.object({
+    tokenId: z2.coerce.number().int().nonnegative().describe("veNFT token id")
+  }),
+  env: env2,
+  output: z2.object({
+    tokenId: z2.number(),
+    owner: z2.string(),
+    amount: z2.string(),
+    unlockTime: z2.number(),
+    isPermanent: z2.boolean(),
+    votingPower: z2.string()
+  }),
+  examples: [{ args: { tokenId: 1 }, description: "Inspect lock details for veNFT #1" }],
+  async run(c) {
+    const client = createAboreanPublicClient(c.env.ABSTRACT_RPC_URL);
+    const tokenId = BigInt(c.args.tokenId);
+    const [owner, locked, votingPower] = await Promise.all([
+      client.readContract({
+        abi: votingEscrowAbi,
+        address: ABOREAN_V2_ADDRESSES.votingEscrow,
+        functionName: "ownerOf",
+        args: [tokenId]
+      }),
+      client.readContract({
+        abi: votingEscrowAbi,
+        address: ABOREAN_V2_ADDRESSES.votingEscrow,
+        functionName: "locked",
+        args: [tokenId]
+      }),
+      client.readContract({
+        abi: votingEscrowAbi,
+        address: ABOREAN_V2_ADDRESSES.votingEscrow,
+        functionName: "balanceOfNFT",
+        args: [tokenId]
+      })
+    ]);
+    return c.ok({
+      tokenId: c.args.tokenId,
+      owner: toChecksum(owner),
+      amount: locked.amount.toString(),
+      unlockTime: asNum(locked.end),
+      isPermanent: locked.isPermanent,
+      votingPower: votingPower.toString()
+    });
+  }
+});
+ve.command("locks", {
+  description: "List all veNFT locks owned by an address.",
+  args: z2.object({
+    address: z2.string().describe("Owner address")
+  }),
+  env: env2,
+  output: z2.object({
+    address: z2.string(),
+    locks: z2.array(
+      z2.object({
+        tokenId: z2.string(),
+        amount: z2.string(),
+        unlockTime: z2.number(),
+        isPermanent: z2.boolean(),
+        votingPower: z2.string()
+      })
+    ),
+    count: z2.number()
+  }),
+  examples: [
+    {
+      args: { address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" },
+      description: "List all veNFT locks for an address"
+    }
+  ],
+  async run(c) {
+    const client = createAboreanPublicClient(c.env.ABSTRACT_RPC_URL);
+    const balance = await client.readContract({
+      abi: votingEscrowAbi,
+      address: ABOREAN_V2_ADDRESSES.votingEscrow,
+      functionName: "balanceOf",
+      args: [c.args.address]
+    });
+    const count = asNum(balance);
+    if (!count) {
+      return c.ok({
+        address: toChecksum(c.args.address),
+        locks: [],
+        count: 0
+      });
+    }
+    const indices = Array.from({ length: count }, (_, i) => BigInt(i));
+    const tokenIds = await client.multicall({
+      allowFailure: false,
+      contracts: indices.map((index) => ({
+        abi: votingEscrowAbi,
+        address: ABOREAN_V2_ADDRESSES.votingEscrow,
+        functionName: "tokenOfOwnerByIndex",
+        args: [c.args.address, index]
+      }))
+    });
+    const lockData = await client.multicall({
+      allowFailure: false,
+      contracts: tokenIds.flatMap((tokenId) => [
+        {
+          abi: votingEscrowAbi,
+          address: ABOREAN_V2_ADDRESSES.votingEscrow,
+          functionName: "locked",
+          args: [tokenId]
+        },
+        {
+          abi: votingEscrowAbi,
+          address: ABOREAN_V2_ADDRESSES.votingEscrow,
+          functionName: "balanceOfNFT",
+          args: [tokenId]
+        }
+      ])
+    });
+    const locks = tokenIds.map((tokenId, index) => {
+      const offset = index * 2;
+      const locked = lockData[offset];
+      const votingPower = lockData[offset + 1];
+      return {
+        tokenId: tokenId.toString(),
+        amount: locked.amount.toString(),
+        unlockTime: asNum(locked.end),
+        isPermanent: locked.isPermanent,
+        votingPower: votingPower.toString()
+      };
+    });
+    return c.ok({
+      address: toChecksum(c.args.address),
+      locks,
+      count: locks.length
+    });
+  }
+});
+ve.command("voting-power", {
+  description: "Get current voting power for one veNFT token id.",
+  args: z2.object({
+    tokenId: z2.coerce.number().int().nonnegative().describe("veNFT token id")
+  }),
+  env: env2,
+  output: z2.object({
+    tokenId: z2.number(),
+    votingPower: z2.string()
+  }),
+  examples: [{ args: { tokenId: 1 }, description: "Get current voting power for veNFT #1" }],
+  async run(c) {
+    const client = createAboreanPublicClient(c.env.ABSTRACT_RPC_URL);
+    const votingPower = await client.readContract({
+      abi: votingEscrowAbi,
+      address: ABOREAN_V2_ADDRESSES.votingEscrow,
+      functionName: "balanceOfNFT",
+      args: [BigInt(c.args.tokenId)]
+    });
+    return c.ok({
+      tokenId: c.args.tokenId,
+      votingPower: votingPower.toString()
+    });
+  }
+});
+
+// src/commands/voter.ts
+import { Cli as Cli3, z as z3 } from "incur";
+var env3 = z3.object({
+  ABSTRACT_RPC_URL: z3.string().optional().describe("Abstract RPC URL override")
+});
+async function discoverPools(client) {
+  const [v2PoolCount, clPoolCount] = 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"
+    })
+  ]);
+  const v2Indices = Array.from({ length: asNum(v2PoolCount) }, (_, i) => BigInt(i));
+  const clIndices = Array.from({ length: asNum(clPoolCount) }, (_, i) => BigInt(i));
+  const [v2Pools, clPools] = await Promise.all([
+    v2Indices.length ? client.multicall({
+      allowFailure: false,
+      contracts: v2Indices.map((index) => ({
+        abi: poolFactoryAbi,
+        address: ABOREAN_V2_ADDRESSES.poolFactory,
+        functionName: "allPools",
+        args: [index]
+      }))
+    }) : Promise.resolve([]),
+    clIndices.length ? client.multicall({
+      allowFailure: false,
+      contracts: clIndices.map((index) => ({
+        abi: clFactoryAbi,
+        address: ABOREAN_CL_ADDRESSES.clFactory,
+        functionName: "allPools",
+        args: [index]
+      }))
+    }) : Promise.resolve([])
+  ]);
+  return [...v2Pools, ...clPools];
+}
+var voter = Cli3.create("voter", {
+  description: "Inspect Aborean voter epoch, pool weights, and claimable rewards context."
+});
+voter.command("epoch", {
+  description: "Show current emissions epoch timing from Minter.",
+  env: env3,
+  output: z3.object({
+    activePeriod: z3.number(),
+    epochEnd: z3.number(),
+    secondsRemaining: z3.number(),
+    timeRemaining: z3.string(),
+    weekSeconds: z3.number(),
+    epochCount: z3.number(),
+    weeklyEmission: z3.string()
+  }),
+  examples: [{ description: "Inspect current voter epoch boundaries" }],
+  async run(c) {
+    const client = createAboreanPublicClient(c.env.ABSTRACT_RPC_URL);
+    const [activePeriod, weekSeconds, epochCount, weeklyEmission] = await Promise.all([
+      client.readContract({
+        abi: minterAbi,
+        address: ABOREAN_V2_ADDRESSES.minter,
+        functionName: "activePeriod"
+      }),
+      client.readContract({
+        abi: minterAbi,
+        address: ABOREAN_V2_ADDRESSES.minter,
+        functionName: "WEEK"
+      }),
+      client.readContract({
+        abi: minterAbi,
+        address: ABOREAN_V2_ADDRESSES.minter,
+        functionName: "epochCount"
+      }),
+      client.readContract({
+        abi: minterAbi,
+        address: ABOREAN_V2_ADDRESSES.minter,
+        functionName: "weekly"
+      })
+    ]);
+    const now = Math.floor(Date.now() / 1e3);
+    const epochEnd = asNum(activePeriod + weekSeconds);
+    return c.ok({
+      activePeriod: asNum(activePeriod),
+      epochEnd,
+      secondsRemaining: clampPositive(epochEnd - now),
+      timeRemaining: relTime(activePeriod + weekSeconds),
+      weekSeconds: asNum(weekSeconds),
+      epochCount: asNum(epochCount),
+      weeklyEmission: weeklyEmission.toString()
+    });
+  }
+});
+voter.command("weights", {
+  description: "Show current pool voting weight distribution.",
+  env: env3,
+  output: z3.object({
+    totalWeight: z3.string(),
+    pools: z3.array(
+      z3.object({
+        pool: z3.string(),
+        gauge: z3.string(),
+        weight: z3.string()
+      })
+    ),
+    count: z3.number()
+  }),
+  examples: [{ description: "List all pools with non-zero voting weight" }],
+  async run(c) {
+    const client = createAboreanPublicClient(c.env.ABSTRACT_RPC_URL);
+    const pools = await discoverPools(client);
+    if (!pools.length) {
+      return c.ok({ totalWeight: "0", pools: [], count: 0 });
+    }
+    const [totalWeight, poolData] = await Promise.all([
+      client.readContract({
+        abi: voterAbi,
+        address: ABOREAN_V2_ADDRESSES.voter,
+        functionName: "totalWeight"
+      }),
+      client.multicall({
+        allowFailure: false,
+        contracts: pools.flatMap((pool) => [
+          {
+            abi: voterAbi,
+            address: ABOREAN_V2_ADDRESSES.voter,
+            functionName: "gauges",
+            args: [pool]
+          },
+          {
+            abi: voterAbi,
+            address: ABOREAN_V2_ADDRESSES.voter,
+            functionName: "weights",
+            args: [pool]
+          }
+        ])
+      })
+    ]);
+    const entries = pools.map((pool, index) => {
+      const offset = index * 2;
+      const gauge = poolData[offset] ?? ZERO_ADDRESS;
+      const weight = poolData[offset + 1] ?? 0n;
+      return {
+        pool,
+        gauge,
+        weight
+      };
+    }).filter(
+      (entry) => entry.gauge.toLowerCase() !== ZERO_ADDRESS.toLowerCase() && entry.weight > 0n
+    ).sort((a, b) => a.weight > b.weight ? -1 : a.weight < b.weight ? 1 : 0).map((entry) => ({
+      pool: toChecksum(entry.pool),
+      gauge: toChecksum(entry.gauge),
+      weight: entry.weight.toString()
+    }));
+    return c.ok({
+      totalWeight: totalWeight.toString(),
+      pools: entries,
+      count: entries.length
+    });
+  }
+});
+voter.command("rewards", {
+  description: "Show claimable rebase rewards and voting context for a veNFT.",
+  args: z3.object({
+    tokenId: z3.coerce.number().int().nonnegative().describe("veNFT token id")
+  }),
+  env: env3,
+  output: z3.object({
+    tokenId: z3.number(),
+    rewardToken: z3.string(),
+    claimableRebase: z3.string(),
+    timeCursor: z3.number(),
+    lastTokenTime: z3.number(),
+    distributorStartTime: z3.number(),
+    usedWeight: z3.string(),
+    lastVoted: z3.number()
+  }),
+  examples: [{ args: { tokenId: 1 }, description: "Check claimable voter/distributor rewards" }],
+  async run(c) {
+    const client = createAboreanPublicClient(c.env.ABSTRACT_RPC_URL);
+    const tokenId = BigInt(c.args.tokenId);
+    const [
+      rewardToken,
+      claimableRebase,
+      timeCursor,
+      lastTokenTime,
+      distributorStartTime,
+      usedWeight,
+      lastVoted
+    ] = await Promise.all([
+      client.readContract({
+        abi: rewardsDistributorAbi,
+        address: ABOREAN_V2_ADDRESSES.rewardsDistributor,
+        functionName: "token"
+      }),
+      client.readContract({
+        abi: rewardsDistributorAbi,
+        address: ABOREAN_V2_ADDRESSES.rewardsDistributor,
+        functionName: "claimable",
+        args: [tokenId]
+      }),
+      client.readContract({
+        abi: rewardsDistributorAbi,
+        address: ABOREAN_V2_ADDRESSES.rewardsDistributor,
+        functionName: "timeCursorOf",
+        args: [tokenId]
+      }),
+      client.readContract({
+        abi: rewardsDistributorAbi,
+        address: ABOREAN_V2_ADDRESSES.rewardsDistributor,
+        functionName: "lastTokenTime"
+      }),
+      client.readContract({
+        abi: rewardsDistributorAbi,
+        address: ABOREAN_V2_ADDRESSES.rewardsDistributor,
+        functionName: "startTime"
+      }),
+      client.readContract({
+        abi: voterAbi,
+        address: ABOREAN_V2_ADDRESSES.voter,
+        functionName: "usedWeights",
+        args: [tokenId]
+      }),
+      client.readContract({
+        abi: voterAbi,
+        address: ABOREAN_V2_ADDRESSES.voter,
+        functionName: "lastVoted",
+        args: [tokenId]
+      })
+    ]);
+    return c.ok({
+      tokenId: c.args.tokenId,
+      rewardToken: toChecksum(rewardToken),
+      claimableRebase: claimableRebase.toString(),
+      timeCursor: asNum(timeCursor),
+      lastTokenTime: asNum(lastTokenTime),
+      distributorStartTime: asNum(distributorStartTime),
+      usedWeight: usedWeight.toString(),
+      lastVoted: asNum(lastVoted)
+    });
+  }
+});
+voter.command("bribes", {
+  description: "Show active bribe reward tokens and current-epoch amounts for a pool.",
+  args: z3.object({
+    pool: z3.string().describe("Pool address")
+  }),
+  env: env3,
+  output: z3.object({
+    pool: z3.string(),
+    gauge: z3.string(),
+    bribeContract: z3.string(),
+    epochStart: z3.number(),
+    rewardTokens: z3.array(
+      z3.object({
+        token: z3.string(),
+        epochAmount: z3.string()
+      })
+    ),
+    count: z3.number()
+  }),
+  examples: [
+    {
+      args: { pool: "0x0000000000000000000000000000000000000001" },
+      description: "Inspect bribe reward tokens for one pool"
+    }
+  ],
+  async run(c) {
+    const client = createAboreanPublicClient(c.env.ABSTRACT_RPC_URL);
+    const [gauge, epochStart] = await Promise.all([
+      client.readContract({
+        abi: voterAbi,
+        address: ABOREAN_V2_ADDRESSES.voter,
+        functionName: "gauges",
+        args: [c.args.pool]
+      }),
+      client.readContract({
+        abi: minterAbi,
+        address: ABOREAN_V2_ADDRESSES.minter,
+        functionName: "activePeriod"
+      })
+    ]);
+    if (gauge.toLowerCase() === ZERO_ADDRESS.toLowerCase()) {
+      return c.error({
+        code: "NOT_FOUND",
+        message: `No gauge exists for pool ${c.args.pool}`,
+        retryable: false
+      });
+    }
+    const bribeContract = await client.readContract({
+      abi: voterAbi,
+      address: ABOREAN_V2_ADDRESSES.voter,
+      functionName: "gaugeToBribe",
+      args: [gauge]
+    });
+    if (bribeContract.toLowerCase() === ZERO_ADDRESS.toLowerCase()) {
+      return c.ok({
+        pool: toChecksum(c.args.pool),
+        gauge: toChecksum(gauge),
+        bribeContract: toChecksum(bribeContract),
+        epochStart: asNum(epochStart),
+        rewardTokens: [],
+        count: 0
+      });
+    }
+    const rewardsLength = await client.readContract({
+      abi: votingRewardAbi,
+      address: bribeContract,
+      functionName: "rewardsListLength"
+    });
+    const tokenCount = asNum(rewardsLength);
+    if (!tokenCount) {
+      return c.ok({
+        pool: toChecksum(c.args.pool),
+        gauge: toChecksum(gauge),
+        bribeContract: toChecksum(bribeContract),
+        epochStart: asNum(epochStart),
+        rewardTokens: [],
+        count: 0
+      });
+    }
+    const tokenIndices = Array.from({ length: tokenCount }, (_, i) => BigInt(i));
+    const rewardTokens = await client.multicall({
+      allowFailure: false,
+      contracts: tokenIndices.map((index) => ({
+        abi: votingRewardAbi,
+        address: bribeContract,
+        functionName: "rewards",
+        args: [index]
+      }))
+    });
+    const epochAmounts = await client.multicall({
+      allowFailure: false,
+      contracts: rewardTokens.map((token) => ({
+        abi: votingRewardAbi,
+        address: bribeContract,
+        functionName: "tokenRewardsPerEpoch",
+        args: [token, epochStart]
+      }))
+    });
+    const items = rewardTokens.map((token, index) => ({
+      token: toChecksum(token),
+      epochAmount: epochAmounts[index].toString()
+    }));
+    return c.ok({
+      pool: toChecksum(c.args.pool),
+      gauge: toChecksum(gauge),
+      bribeContract: toChecksum(bribeContract),
+      epochStart: asNum(epochStart),
+      rewardTokens: items,
+      count: items.length
+    });
+  }
+});
+
 // src/error-handling.ts
 import { AsyncLocalStorage } from "async_hooks";
 import { Errors } from "incur";
@@ -576,23 +1870,26 @@ function applyFriendlyErrorHandling(cli2) {
 // 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", {
+var cli = Cli4.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(gauges);
+cli.command(ve);
+cli.command(voter);
+var rootEnv = z4.object({
+  ABSTRACT_RPC_URL: z4.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)")
+  output: z4.object({
+    v2PoolCount: z4.number().describe("Number of V2 AMM pools"),
+    clPoolCount: z4.number().describe("Number of Slipstream (CL) pools"),
+    gaugeCount: z4.number().describe("Number of pools with gauges"),
+    totalVotingWeight: z4.string().describe("Total voting weight (wei)"),
+    veABXTotalSupply: z4.string().describe("Total veABX supply (wei)"),
+    veABXLockedSupply: z4.string().describe("Total ABX locked in VotingEscrow (wei)")
   }),
   examples: [{ description: "Fetch the current Aborean protocol status" }],
   async run(c) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spectratools/aborean-cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "CLI for Aborean Finance DEX on Abstract (pools, swaps, gauges, voting escrow).",
   "type": "module",
   "license": "MIT",