@oracle-agent/oracle 0.3.2 → 0.3.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oracle-agent/oracle",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Oracle: prepare-only multichain agent control plane. Policy-bounded intents for a user-signed wallet. Self-custody by default — the public package never takes your key. Built for Hermes; no model key required.",
   "license": "Apache-2.0",
   "type": "module",

package/src/data/providers/uniswap-v3.mjs

@@ -29,6 +29,22 @@ export const UNI_V3_CHAINS = {
     weth: "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1",
     usdc: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
   },
+  // Robinhood Chain. Addresses mirror rhbot server/swap.js SWAP_CONFIG (the vetted
+  // source) and were re-proved on the live chain before being added here:
+  // eth_chainId == 4663, eth_getCode non-empty for every address below, and a real
+  // quoteExactInputSingle returned 1 WETH -> 1866.58 USDG at fee 100 (2026-07-31).
+  //
+  // Why this entry matters: LI.FI / ParaSwap / CoW do not index 4663, so the router's
+  // aggregator-only candidate list returned "no usable route" for every RH swap. The
+  // on-chain QuoterV2 is the only source that can price this chain. `usdc` is USDG
+  // (Global Dollar, 6-dec) — the stable quote RH pools actually use.
+  4663: {
+    name: "robinhood",
+    quoter: "0x33e885ed0ec9bf04ecfb19341582aadcb4c8a9e7",
+    router: "0xcaf681a66d020601342297493863e78c959e5cb2",
+    weth: "0x0bd7d308f8e1639fab988df18a8011f41eacad73",
+    usdc: "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168",
+  },
 };
 
 export const UNI_V3_FEE_TIERS = [100, 500, 3000, 10000];
@@ -274,7 +290,7 @@ export async function uniV3PrepareExactIn(q = {}, opts = {}) {
       value: nativeInput ? quote.amountIn : "0",
       slippageGuard: bindAutoSlippageGuardToCall(quote.autoSlippage, { chainId, venue: meta.router, data }),
     },
-  });
+  }, { provider: "uniswap-v3", kind: "univ3-swap-tx" });
 }
 
 export async function uniV3Health(opts = {}) {

package/src/router/prepare-route.mjs

@@ -45,6 +45,29 @@ export const ARTIFACT = Object.freeze({
 const DEFAULT_DRIFT_TOLERANCE_BPS = 100;
 
 const PREPARERS = {
+  // On-chain Uniswap V3. Unlike the aggregators below, this builds calldata from the
+  // chain's own router rather than an API's transaction payload — which is what makes
+  // chains no aggregator indexes (e.g. Robinhood 4663) preparable at all.
+  //
+  // The provider stamps requiresUserSignature:true / signingReady:false /
+  // broadcastReady:false. Preparing is NOT permission to execute: the wallet is still
+  // the only thing that can authorize this, and the unattended daemon surface list
+  // (hl, poly) is deliberately unchanged by adding this.
+  "uniswap-v3": async ({ chainId, tokenIn, tokenOut, amountIn, taker }, opts) => {
+    const { uniV3PrepareExactIn } = await import("../data/providers/uniswap-v3.mjs");
+    const p = await uniV3PrepareExactIn(
+      { chainId, tokenIn, tokenOut, amountIn, recipient: taker },
+      opts,
+    );
+    return {
+      artifactKind: ARTIFACT.TRANSACTION,
+      transaction: p.transaction,
+      requiresApproval: p.requiresApproval ?? null,
+      amountOut: p.quote?.amountOut ?? null,
+      minOut: p.quote?.amountOutMinimum ?? null,
+    };
+  },
+
   lifi: async ({ chainId, tokenIn, tokenOut, amountIn, taker }, opts) => {
     const { lifiPrepare } = await import("../data/providers/lifi.mjs");
     const p = await lifiPrepare(

package/src/router/route-sources.mjs

@@ -20,6 +20,7 @@ import { paraswapPrice } from "../data/providers/paraswap.mjs";
 import { zeroxQuote } from "../data/providers/zerox.mjs";
 import { oneinchQuote } from "../data/providers/oneinch.mjs";
 import { cowQuote } from "../data/providers/cowswap.mjs";
+import { uniV3QuoteExactIn, UNI_V3_CHAINS } from "../data/providers/uniswap-v3.mjs";
 import { llamaPrices } from "../data/providers/defillama.mjs";
 import { NATIVE_PRICE_KEY } from "./best-execution.mjs";
 
@@ -188,6 +189,42 @@ export function swapCandidates({
     },
   });
 
+  // On-chain Uniswap V3 QuoterV2. UNLIKE every other source in this list, this is
+  // not a third-party API — it is an eth_call against the chain itself.
+  //
+  // Why it exists here: aggregators only index chains they chose to support. On
+  // Robinhood Chain (4663) LI.FI/ParaSwap/CoW all return nothing, so the candidate
+  // list came back empty and the router reported "no usable route" — which reads
+  // like a permission wall but is really zero coverage. A chain with a live V3
+  // deployment can always be priced directly, with no API key and no indexer.
+  //
+  // Kept LAST so it acts as a floor: when aggregators do cover a chain they usually
+  // win on route quality, and best-execution still compares net output. This only
+  // decides the trade when it is the sole source that answered.
+  //
+  // Read-only. quoteExactInputSingle is a view call; this cannot sign or broadcast.
+  if (UNI_V3_CHAINS[Number(chainId)]) {
+    c.push({
+      source: "uniswap-v3",
+      run: async () => {
+        const q = await uniV3QuoteExactIn(
+          { chainId, tokenIn, tokenOut, amountIn },
+          opts,
+        );
+        // Gas is deliberately null, not 0: the quoter returns a gasEstimate in UNITS,
+        // and without a gas price that is not a USD cost. Reporting 0 would make this
+        // source look free and beat correctly-priced aggregators. See CoW above for
+        // the one case where 0 is a measured fact rather than a missing number.
+        return {
+          amountOut: q?.amountOut,
+          minOut: q?.minOut ?? q?.amountOutMinimum ?? null,
+          gasUsd: null,
+          meta: { onchain: true, fee: q?.fee, gasUnits: q?.gasEstimate, quoter: q?.quoter },
+        };
+      },
+    });
+  }
+
   return c;
 }