Add gauge discover: scan V2+CL pools for emission gauges

- gauge discover scans both V2 factory (allPairs) and CL factory (getPool × tickSpacings)
- Filters pools with non-zero gauges via voter.gaugeForPool
- Fix cl_factory config key (was reading V2 factory for CL)
- Fix USDC address (was wrong, now matches config)
- Fix 4 checksum mismatches (WETH, mETH, hyperRAM, UBTC)
- Ramses: 7 gauged pools found (5 V2 + 2 CL)
- CL10 WHYPE/USDT0 + CL1 USDC/USDT0 = emission pools

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: Hiksang

ts/config/protocols/dex/ramses_hl.toml

@@ -10,7 +10,10 @@ description = "Ramses V2 AMM (x(3,3) model) on HyperEVM ($2.6M TVL)"
 [protocol.contracts]
 # V2 AMM
 factory = "0xd0a07E160511c40ccD5340e94660E9C9c01b0D27"
+pair_factory = "0xd0a07E160511c40ccD5340e94660E9C9c01b0D27"
 router = "0xdcC44285fBc236457A5cd91C2f77AD8421B0D8ED"
+# CL AMM (shared voter)
+cl_factory = "0x07E60782535752be279929e2DFfDd136Db2e6b45"
 # x(3,3) governance (shared with Ramses CL)
 voter = "0x9aab8C415aF5936b09C595B09B1ff15cbaDCD843"
 ve_token = "0xAE6D5FcE541216BDA471D311425B5412D9f1DEb9"

ts/packages/defi-cli/config/protocols/dex/ramses_hl.toml

@@ -10,7 +10,10 @@ description = "Ramses V2 AMM (x(3,3) model) on HyperEVM ($2.6M TVL)"
 [protocol.contracts]
 # V2 AMM
 factory = "0xd0a07E160511c40ccD5340e94660E9C9c01b0D27"
+pair_factory = "0xd0a07E160511c40ccD5340e94660E9C9c01b0D27"
 router = "0xdcC44285fBc236457A5cd91C2f77AD8421B0D8ED"
+# CL AMM (shared voter)
+cl_factory = "0x07E60782535752be279929e2DFfDd136Db2e6b45"
 # x(3,3) governance (shared with Ramses CL)
 voter = "0x9aab8C415aF5936b09C595B09B1ff15cbaDCD843"
 ve_token = "0xAE6D5FcE541216BDA471D311425B5412D9f1DEb9"

ts/packages/defi-cli/dist/index.js

@@ -18,6 +18,20 @@ function resolveAccount(): Address | undefined {
 export function registerGauge(parent: Command, getOpts: () => OutputMode, makeExecutor: () => Executor): void {
   const gauge = parent.command("gauge").description("Gauge operations: find, deposit, withdraw, claim, earned");
 
+  gauge.command("discover")
+    .description("Find all pools with emission gauges (scans V2 + CL factories)")
+    .requiredOption("--protocol <protocol>", "Protocol slug")
+    .action(async (opts) => {
+      const chainName = parent.opts<{ chain?: string }>().chain ?? "hyperevm";
+      const registry = Registry.loadEmbedded();
+      const chain = registry.getChain(chainName);
+      const protocol = registry.getProtocol(opts.protocol);
+      const adapter = createGauge(protocol, chain.effectiveRpcUrl());
+      if (!adapter.discoverGaugedPools) throw new Error(`${protocol.name} does not support gauge discovery`);
+      const pools = await adapter.discoverGaugedPools();
+      printOutput(pools, getOpts());
+    });
+
   gauge.command("find")
     .description("Find gauge address for a pool via voter contract")
     .requiredOption("--protocol <protocol>", "Protocol slug")

ts/packages/defi-cli/dist/index.js.map

@@ -238,6 +238,16 @@ interface OptionParams {
     is_call: boolean;
     amount: bigint;
 }
+/** A pool that has an active emission gauge */
+interface GaugedPool {
+    pool: Address;
+    gauge: Address;
+    token0: string;
+    token1: string;
+    type: "V2" | "CL";
+    tickSpacing?: number;
+    stable?: boolean;
+}
 interface RewardInfo {
     token: Address;
     symbol: string;
@@ -492,6 +502,8 @@ interface IGauge {
     getPendingRewards(gauge: Address, user: Address): Promise<RewardInfo[]>;
     /** Get pending rewards for a CL gauge NFT position */
     getPendingRewardsByTokenId?(gauge: Address, tokenId: bigint): Promise<bigint>;
+    /** Discover all pools that have active emission gauges */
+    discoverGaugedPools?(): Promise<GaugedPool[]>;
 }
 /** ve(3,3) Vote-escrow operations — lock tokens for veNFT */
 interface IVoteEscrow {
@@ -679,4 +691,4 @@ declare class Registry {
     resolvePool(protocolSlug: string, poolName: string): PoolInfo;
 }
 
-export { type ActionResult, type AddLiquidityParams, type AdjustCdpParams, type BorrowParams, type CdpInfo, ChainConfig, type CloseCdpParams, type DeFiTx, DefiError, type DefiErrorCode, type DefiPosition, type DerivativesPositionParams, type GaugeInfo, type ICdp, type IDerivatives, type IDex, type IGauge, type IGaugeSystem, type ILending, type ILiquidStaking, type INft, type IOptions, type IOracle, type IVault, type IVoteEscrow, type IVoter, type IYieldAggregator, type IYieldSource, InterestRateMode, type LendingRates, MULTICALL3_ADDRESS, type NftCollectionInfo, type NftTokenInfo, type OpenCdpParams, type OptionParams, type PoolInfo, type PortfolioPnL, type PortfolioSnapshot, type PositionAsset, type PriceData, ProtocolCategory, type ProtocolEntry, type QuoteParams, type QuoteResult, Registry, type RemoveLiquidityParams, type RepayParams, type Result, type RewardInfo, type Slippage, type StakeParams, type StakingInfo, type SupplyParams, type SwapParams, type TokenAmount, type TokenBalance, type TokenChange, type TokenEntry, TxStatus, type UnstakeParams, type UserPosition, type VaultInfo, type VeNftInfo, type WithdrawParams, type YieldInfo, applyMinSlippage, buildApprove, buildMulticall, buildTransfer, clearProviderCache, decodeU128, decodeU256, defaultSwapSlippage, erc20Abi, formatHuman, getProvider, jsonReplacer, jsonReplacerDecimal, jsonStringify, multicallRead, newSlippage, parseBigInt, protocolCategoryLabel };
+export { type ActionResult, type AddLiquidityParams, type AdjustCdpParams, type BorrowParams, type CdpInfo, ChainConfig, type CloseCdpParams, type DeFiTx, DefiError, type DefiErrorCode, type DefiPosition, type DerivativesPositionParams, type GaugeInfo, type GaugedPool, type ICdp, type IDerivatives, type IDex, type IGauge, type IGaugeSystem, type ILending, type ILiquidStaking, type INft, type IOptions, type IOracle, type IVault, type IVoteEscrow, type IVoter, type IYieldAggregator, type IYieldSource, InterestRateMode, type LendingRates, MULTICALL3_ADDRESS, type NftCollectionInfo, type NftTokenInfo, type OpenCdpParams, type OptionParams, type PoolInfo, type PortfolioPnL, type PortfolioSnapshot, type PositionAsset, type PriceData, ProtocolCategory, type ProtocolEntry, type QuoteParams, type QuoteResult, Registry, type RemoveLiquidityParams, type RepayParams, type Result, type RewardInfo, type Slippage, type StakeParams, type StakingInfo, type SupplyParams, type SwapParams, type TokenAmount, type TokenBalance, type TokenChange, type TokenEntry, TxStatus, type UnstakeParams, type UserPosition, type VaultInfo, type VeNftInfo, type WithdrawParams, type YieldInfo, applyMinSlippage, buildApprove, buildMulticall, buildTransfer, clearProviderCache, decodeU128, decodeU256, defaultSwapSlippage, erc20Abi, formatHuman, getProvider, jsonReplacer, jsonReplacerDecimal, jsonStringify, multicallRead, newSlippage, parseBigInt, protocolCategoryLabel };