@oracle-agent/oracle 0.14.1 → 0.16.0

package/src/data/providers/pyth-price-feeds.mjs

@@ -1,172 +0,0 @@
-// Pyth Hermes price feeds — keyless real-time Solana-native oracle reads.
-//
-// Hermes serves the same signed price updates Solana on-chain programs consume,
-// so this is the price surface an operator should quote against when the
-// counterparty is a Pyth-pulling program. Read-only: this module never returns
-// the binary VAA as something executable, only the parsed price alongside it.
-
-import { httpJson } from "../http.mjs";
-
-export const PYTH_HERMES_API = "https://hermes.pyth.network";
-
-// Well-known mainnet feed ids (hex, no 0x). Handy defaults for health + lookups.
-export const PYTH_FEEDS = {
-  "SOL/USD": "ef0d8b6fda2ceba41da15d4095d1da392a0d2f8ed0c6c7bc0f4cfac8c280b56d",
-  "BTC/USD": "e62df6c8b4a85fe1a67db44dc12de5db330f7ac66b72dc658afedf0f4a415b43",
-  "ETH/USD": "ff61491a931112ddf1bd8147cd1b641375f79f5825126d665480874634fd0ace",
-  "USDC/USD": "eaa020c61cc479712813461ce153894a96a6c00b21ed0cfc2798d1f9a9e9c94a",
-  "USDT/USD": "2b89b9dc8fdf9f34709a5b106b472f0f39bb6ca9ce04b0fd7f2e971688e2e53b",
-  "JUP/USD": "0a0408d619e9380abad35060f9192039ed5042fa6f82301d0e48bb52be830996",
-  "JTO/USD": "b43660a5f790c69354b0729a5ef9d50d68f1df92107540210b9cccba1f947cc2",
-  "BONK/USD": "72b021217ca3fe68922a19aaf990109cb9d84e9ad004b4d2025ad6f529314419",
-  "PYTH/USD": "0bbf28e9a841a1cc788f6a361b17ca072d0ea3098a1e5df1c3922d06719579ff",
-  "HYPE/USD": "4279e31cc369bbcc2faf022b382b080e32a8e689ff20fbc530d2a603eb6cd98b",
-};
-
-const FEED_ID_RE = /^[0-9a-fA-F]{64}$/;
-
-function base(opts = {}) {
-  return String(opts.baseUrl || process.env.PYTH_HERMES_URL || PYTH_HERMES_API).replace(/\/$/, "");
-}
-
-/**
- * Accept a raw hex feed id, an "0x"-prefixed id, or a symbol from PYTH_FEEDS.
- * Anything else is rejected rather than forwarded — a malformed id silently
- * drops out of the Hermes response and would otherwise look like a missing
- * price rather than a caller bug.
- */
-export function pythFeedId(value, label = "feedId") {
-  const raw = String(value ?? "").trim();
-  if (!raw) throw new Error(`pyth-price-feeds: ${label} required`);
-  const known = PYTH_FEEDS[raw.toUpperCase()] || PYTH_FEEDS[`${raw.toUpperCase()}/USD`];
-  if (known) return known;
-  const hex = raw.startsWith("0x") || raw.startsWith("0X") ? raw.slice(2) : raw;
-  if (!FEED_ID_RE.test(hex)) {
-    throw new Error(`pyth-price-feeds: ${label} must be a 32-byte hex feed id or a known symbol`);
-  }
-  return hex.toLowerCase();
-}
-
-function scaled(component = {}) {
-  const price = Number(component.price);
-  const expo = Number(component.expo);
-  if (!Number.isFinite(price) || !Number.isFinite(expo)) return null;
-  return price * 10 ** expo;
-}
-
-function normalizeParsed(item = {}) {
-  const conf = scaled({ price: Number(item.price?.conf), expo: item.price?.expo });
-  const value = scaled(item.price);
-  return {
-    id: item.id || null,
-    price: value,
-    confidence: conf,
-    // Confidence relative to price — the number that actually decides whether a
-    // quote is safe to act on. A wide band means Pyth publishers disagree.
-    confidenceBps: value && conf != null ? Math.round((conf / Math.abs(value)) * 10_000) : null,
-    emaPrice: scaled(item.ema_price),
-    publishTime: item.price?.publish_time ?? null,
-    publishTimeIso: item.price?.publish_time ? new Date(item.price.publish_time * 1000).toISOString() : null,
-    ageSeconds: item.price?.publish_time ? Math.max(0, Math.round(Date.now() / 1000 - item.price.publish_time)) : null,
-    expo: item.price?.expo ?? null,
-    raw: {
-      price: item.price ?? null,
-      emaPrice: item.ema_price ?? null,
-      metadata: item.metadata ?? null,
-    },
-  };
-}
-
-async function fetchLatest(ids, opts = {}) {
-  const url = new URL(`${base(opts)}/v2/updates/price/latest`);
-  for (const id of ids) url.searchParams.append("ids[]", id);
-  url.searchParams.set("encoding", "hex");
-  url.searchParams.set("parsed", "true");
-  // Without this a single retired id 400s the whole batch.
-  url.searchParams.set("ignore_invalid_price_ids", "true");
-  return httpJson(url.toString(), {
-    fetchImpl: opts.fetchImpl,
-    timeoutMs: opts.timeoutMs ?? 12_000,
-  });
-}
-
-export async function pythHealth(opts = {}) {
-  try {
-    const data = await fetchLatest([PYTH_FEEDS["SOL/USD"]], opts);
-    const parsed = Array.isArray(data?.parsed) ? data.parsed.map(normalizeParsed) : [];
-    const sol = parsed[0] || null;
-    return {
-      ok: Boolean(sol && Number.isFinite(sol.price) && sol.price > 0),
-      provider: "pyth-price-feeds",
-      solUsd: sol?.price ?? null,
-      ageSeconds: sol?.ageSeconds ?? null,
-      exec: false,
-    };
-  } catch (error) {
-    return { ok: false, provider: "pyth-price-feeds", error: String(error?.message || error), exec: false };
-  }
-}
-
-export async function pythLatestPrice(args = {}, opts = {}) {
-  const id = pythFeedId(args.feedId || args.id || args.symbol, "feedId");
-  const data = await fetchLatest([id], opts);
-  const parsed = Array.isArray(data?.parsed) ? data.parsed.map(normalizeParsed) : [];
-  const price = parsed.find((p) => String(p.id).toLowerCase() === id) || parsed[0] || null;
-  if (!price) throw new Error(`pyth-price-feeds: no price returned for feed ${id}`);
-  return {
-    provider: "pyth-price-feeds",
-    chain: "solana-mainnet-beta",
-    feedId: id,
-    ...price,
-    // The signed update bytes an on-chain Pyth consumer would post. Surfaced
-    // for inspection only — Oracle never submits it.
-    binaryUpdate: data?.binary?.data?.[0] || null,
-    binaryEncoding: data?.binary?.encoding || null,
-  };
-}
-
-export async function pythLatestPrices(args = {}, opts = {}) {
-  const list = Array.isArray(args) ? args : args.feedIds || args.ids || args.symbols || [];
-  const ids = [...new Set(list.map((v) => pythFeedId(v, "feedIds[]")))];
-  if (!ids.length) throw new Error("pyth-price-feeds: feedIds[] required");
-  // Hermes caps a single query string; chunk so large batches still resolve.
-  const CHUNK = 40;
-  const chunks = [];
-  for (let i = 0; i < ids.length; i += CHUNK) chunks.push(ids.slice(i, i + CHUNK));
-  const responses = [];
-  for (const chunk of chunks) responses.push(await fetchLatest(chunk, opts));
-  const prices = responses.flatMap((data) => (Array.isArray(data?.parsed) ? data.parsed.map(normalizeParsed) : []));
-  const byId = Object.fromEntries(prices.map((p) => [String(p.id).toLowerCase(), p]));
-  return {
-    provider: "pyth-price-feeds",
-    chain: "solana-mainnet-beta",
-    requested: ids.length,
-    returned: prices.length,
-    missing: ids.filter((id) => !byId[id]),
-    prices,
-    byId,
-  };
-}
-
-export async function pythFeedDirectory(args = {}, opts = {}) {
-  const url = new URL(`${base(opts)}/v2/price_feeds`);
-  if (args.query) url.searchParams.set("query", String(args.query));
-  url.searchParams.set("asset_type", String(args.assetType || "crypto"));
-  const feeds = await httpJson(url.toString(), {
-    fetchImpl: opts.fetchImpl,
-    timeoutMs: opts.timeoutMs ?? 15_000,
-  });
-  const list = Array.isArray(feeds) ? feeds : [];
-  return {
-    provider: "pyth-price-feeds",
-    count: list.length,
-    feeds: list.map((f) => ({
-      id: f.id,
-      symbol: f.attributes?.symbol || null,
-      displaySymbol: f.attributes?.display_symbol || null,
-      base: f.attributes?.base || null,
-      quote: f.attributes?.quote_currency || null,
-      assetType: f.attributes?.asset_type || null,
-    })),
-  };
-}

package/src/data/providers/raydium.mjs

@@ -1,35 +0,0 @@
-// Raydium — largest Solana DEX (AMM + CLMM).
-// https://docs.raydium.io — public REST API via Jupiter routing.
-// Never signs, never broadcasts.
-
-import { httpJson } from "../http.mjs";
-
-const JUPITER_QUOTE_API = "https://quote-api.jup.ag/v6";
-
-export async function raydiumQuote({ inputMint, outputMint, amount, slippageBps = 50 } = {}) {
-  if (!inputMint || !outputMint || !amount) {
-    return { error: "raydium quote requires inputMint, outputMint, amount" };
-  }
-  try {
-    const params = new URLSearchParams({ inputMint, outputMint, amount: String(amount), slippageBps: String(slippageBps), onlyDirectRoutes: "true" });
-    const data = await httpJson(`${JUPITER_QUOTE_API}/quote?${params}`);
-    // Filter for Raydium routes specifically
-    const raydiumRoutes = (data?.routePlan || []).filter(r => r?.swapInfo?.label?.toLowerCase().includes("raydium"));
-    return {
-      amountOut: data?.outAmount,
-      priceImpactPct: data?.priceImpactPct,
-      raydiumRoutes: raydiumRoutes.length,
-      allRoutes: data?.routePlan?.length || 0,
-    };
-  } catch (e) {
-    return { error: String(e.message || e).slice(0, 200) };
-  }
-}
-
-export async function raydiumHealth() {
-  try {
-    return { ok: true, note: "Raydium routes through Jupiter aggregator on Solana" };
-  } catch (e) {
-    return { ok: false, error: String(e.message || e).slice(0, 160) };
-  }
-}

package/src/data/providers/relayscan-mev.mjs

@@ -1,72 +0,0 @@
-// Relayscan (Flashbots) — Ethereum MEV-Boost relay + builder monitoring, no key.
-//
-// Read-only mainnet MEV data: relay payload share, builder block counts and
-// measured builder profit, and per-day aggregates.
-//
-// Endpoint reality, probed live 2026-08-06:
-//   GET /overview/json?t=24h            -> 200
-//   GET /builder-profit/json?t=24h      -> 200
-//   GET /stats/day/{YYYY-MM-DD}/json    -> 200   (there is NO /stats/day/json)
-// Supported `t` windows mirror the site nav: 1h, 12h, 24h, 7d.
-
-import { httpJson } from "../http.mjs";
-
-export const RELAYSCAN_API = "https://relayscan.io";
-
-const TIMESPANS = new Set(["1h", "12h", "24h", "7d"]);
-
-function base(opts = {}) {
-  return (opts.baseUrl || process.env.RELAYSCAN_API_URL || RELAYSCAN_API).replace(/\/$/, "");
-}
-
-function timespan(args = {}) {
-  const t = String(args.timespan || args.t || "24h").toLowerCase();
-  if (!TIMESPANS.has(t)) throw new Error(`relayscan-mev: timespan must be one of ${[...TIMESPANS].join(", ")}`);
-  return t;
-}
-
-function isoDate(args = {}) {
-  // Default to yesterday: today's bucket is incomplete until UTC midnight.
-  const raw = args.date || args.day;
-  if (raw == null) {
-    const d = new Date(Date.now() - 24 * 60 * 60 * 1000);
-    return d.toISOString().slice(0, 10);
-  }
-  const text = String(raw).trim();
-  if (!/^\d{4}-\d{2}-\d{2}$/.test(text)) throw new Error("relayscan-mev: date must be YYYY-MM-DD");
-  return text;
-}
-
-/** Relay payload share over a window (which relays delivered blocks). */
-export async function relayscanOverview(args = {}, opts = {}) {
-  return httpJson(`${base(opts)}/overview/json?t=${timespan(args)}`, {
-    fetchImpl: opts.fetchImpl,
-    timeoutMs: opts.timeoutMs ?? 20_000,
-  });
-}
-
-/** Per-builder block counts and measured profit (coinbase balance delta). */
-export async function relayscanBuilderProfit(args = {}, opts = {}) {
-  return httpJson(`${base(opts)}/builder-profit/json?t=${timespan(args)}`, {
-    fetchImpl: opts.fetchImpl,
-    timeoutMs: opts.timeoutMs ?? 20_000,
-  });
-}
-
-/** One UTC day of relay + builder aggregates. */
-export async function relayscanDailyStats(args = {}, opts = {}) {
-  const date = isoDate(args);
-  return httpJson(`${base(opts)}/stats/day/${date}/json`, {
-    fetchImpl: opts.fetchImpl,
-    timeoutMs: opts.timeoutMs ?? 25_000,
-  });
-}
-
-export async function relayscanHealth(opts = {}) {
-  const data = await relayscanOverview({ timespan: "1h" }, opts);
-  return {
-    ok: Array.isArray(data?.relays) && data.relays.length > 0,
-    provider: "relayscan-mev",
-    relays: Array.isArray(data?.relays) ? data.relays.length : 0,
-  };
-}

package/src/data/providers/rfq.mjs

@@ -1,15 +0,0 @@
-import { normalizeRfqIntent } from "../../rfq/intent.mjs";
-import { requestRfqQuotes } from "../../rfq/sources.mjs";
-
-export function rfqIntent(args = {}, opts = {}) {
-  return normalizeRfqIntent(args, opts);
-}
-
-export async function rfqQuote(args = {}, opts = {}) {
-  const intent = args.intent?.kind === "rfq-intent" ? args.intent : normalizeRfqIntent(args, opts);
-  return requestRfqQuotes(intent, opts);
-}
-
-export async function rfqHealth() {
-  return { ok: true, provider: "rfq", mode: "intent-rfq", execution: "prepare" };
-}

package/src/data/providers/rh-agent.mjs

@@ -1,59 +0,0 @@
-// RH agent HTTP read client — talks to the live RH product over HTTP.
-// Unauthenticated D0/D1 ops only. Does NOT import rhbot.
-
-import { httpJson } from "../http.mjs";
-
-export const RH_AGENT_DEFAULT_BASE = "http://127.0.0.1:8792";
-
-function baseUrl(opts = {}) {
-  return (
-    opts.baseUrl ||
-    process.env.RH_AGENT_BASE_URL ||
-    process.env.RH_AGENT_URL ||
-    RH_AGENT_DEFAULT_BASE
-  ).replace(/\/$/, "");
-}
-
-async function get(path, opts = {}) {
-  return httpJson(`${baseUrl(opts)}${path}`, {
-    fetchImpl: opts.fetchImpl,
-    timeoutMs: opts.timeoutMs,
-  });
-}
-
-export async function rhHealth(opts = {}) {
-  return get("/api/health", opts);
-}
-
-export async function rhPolicy(opts = {}) {
-  return get("/api/agent/policy", opts);
-}
-
-// D1 — public RH routes (no requireUser)
-export async function rhChainConfig(opts = {}) {
-  return get("/api/chain/config", opts);
-}
-
-export async function rhChainGas(opts = {}) {
-  return get("/api/chain/gas", opts);
-}
-
-export async function rhSwapsConfig(opts = {}) {
-  return get("/api/swaps/config", opts);
-}
-
-export async function rhSwapsPresets(opts = {}) {
-  return get("/api/swaps/presets", opts);
-}
-
-export async function rhTradingStatus(opts = {}) {
-  return get("/api/trading/status", opts);
-}
-
-export async function rhNftDrops(opts = {}) {
-  return get("/api/nft-drops", opts);
-}
-
-export async function rhFeeEstimate(opts = {}) {
-  return get("/api/fee/estimate", opts);
-}

package/src/data/providers/sanctum-lst.mjs

@@ -1,180 +0,0 @@
-// Sanctum — Solana liquid staking token (LST) directory, APY, and TVL.
-//
-// Sanctum's extra-api is the keyless aggregate view across every LST in the
-// Sanctum universe (JitoSOL, mSOL, bSOL, and the long tail of validator LSTs).
-// Read-only: no stake, unstake, or swap preparation lives here.
-//
-// Endpoint shape notes learned the hard way:
-//   - there is no /v1/apy/indiv; the individual read is the same batch
-//     endpoint with one lst= parameter
-//   - every apy/tvl endpoint REQUIRES at least one lst= query parameter and
-//     returns HTTP 400 "missing field lst" without one
-//   - lst= accepts either the symbol (jitoSOL) or the mint
-
-import { httpJson } from "../http.mjs";
-
-export const SANCTUM_API = "https://extra-api.sanctum.so";
-// Sanctum's own batch ceiling — larger queries start dropping entries.
-const MAX_BATCH = 30;
-
-export const SANCTUM_MAJOR_LSTS = ["jitoSOL", "mSOL", "bSOL", "INF", "hSOL", "bonkSOL", "jupSOL", "dSOL"];
-
-function base(opts = {}) {
-  return String(opts.baseUrl || process.env.SANCTUM_API_URL || SANCTUM_API).replace(/\/$/, "");
-}
-
-function lstParam(value, label = "lst") {
-  const text = String(value ?? "").trim();
-  if (!text || /[?&=\s]/.test(text)) throw new Error(`sanctum-lst: ${label} must be an LST symbol or mint`);
-  return text;
-}
-
-function chunk(list, size) {
-  const out = [];
-  for (let i = 0; i < list.length; i += size) out.push(list.slice(i, i + size));
-  return out;
-}
-
-async function batched(path, lsts, opts = {}) {
-  const merged = {};
-  const errs = {};
-  for (const group of chunk(lsts, MAX_BATCH)) {
-    const url = new URL(`${base(opts)}/v1/${path}`);
-    for (const lst of group) url.searchParams.append("lst", lst);
-    const data = await httpJson(url.toString(), {
-      fetchImpl: opts.fetchImpl,
-      timeoutMs: opts.timeoutMs ?? 20_000,
-    });
-    // Each endpoint names its payload differently (apys / tvls / solValues).
-    const payload = data?.apys || data?.tvls || data?.solValues || {};
-    Object.assign(merged, payload);
-    Object.assign(errs, data?.errs || {});
-  }
-  return { values: merged, errs };
-}
-
-export async function sanctumHealth(opts = {}) {
-  try {
-    // Probe the directory AND a live APY read — the directory alone can serve
-    // from cache while the pricing side is down.
-    const [directory, apy] = await Promise.all([
-      httpJson(`${base(opts)}/v1/lsts`, { fetchImpl: opts.fetchImpl, timeoutMs: opts.timeoutMs ?? 15_000 }),
-      batched("apy/inception", ["jitoSOL"], opts),
-    ]);
-    const lsts = Array.isArray(directory?.lsts) ? directory.lsts : [];
-    return {
-      ok: lsts.length > 0 && Number.isFinite(Number(apy.values.jitoSOL)),
-      provider: "sanctum-lst",
-      lstCount: lsts.length,
-      jitoSolApyInception: Number(apy.values.jitoSOL) ?? null,
-      exec: false,
-    };
-  } catch (error) {
-    return { ok: false, provider: "sanctum-lst", error: String(error?.message || error), exec: false };
-  }
-}
-
-export async function sanctumLstList(args = {}, opts = {}) {
-  const data = await httpJson(`${base(opts)}/v1/lsts`, {
-    fetchImpl: opts.fetchImpl,
-    timeoutMs: opts.timeoutMs ?? 20_000,
-  });
-  let lsts = (Array.isArray(data?.lsts) ? data.lsts : []).map((l) => ({
-    symbol: l.symbol || null,
-    name: l.name || null,
-    mint: l.mint || null,
-    decimals: l.decimals ?? null,
-    pool: l.pool?.pool || null,
-    poolProgram: l.pool?.program || null,
-    voteAccount: l.pool?.vote_account || null,
-    logoUri: l.logo_uri || null,
-  }));
-  if (args.symbol) {
-    const want = String(args.symbol).toLowerCase();
-    lsts = lsts.filter((l) => String(l.symbol || "").toLowerCase() === want || l.mint === args.symbol);
-  }
-  const limit = Number(args.limit);
-  if (Number.isFinite(limit) && limit > 0) lsts = lsts.slice(0, limit);
-  return { provider: "sanctum-lst", chain: "solana-mainnet-beta", count: lsts.length, lsts };
-}
-
-/**
- * APY across a set of LSTs. Defaults to the major LSTs rather than all 240+,
- * because the full universe costs 9 upstream round-trips.
- *
- * `latest` is the current-epoch figure and legitimately reads 0 early in an
- * epoch before enough samples land; `inception` is the since-launch figure and
- * is the number to trust for ranking. Both are returned.
- */
-export async function sanctumApyAll(args = {}, opts = {}) {
-  let symbols = args.lsts || args.symbols || null;
-  if (args.all === true) {
-    const directory = await sanctumLstList({}, opts);
-    symbols = directory.lsts.map((l) => l.symbol).filter(Boolean);
-  }
-  if (!Array.isArray(symbols) || !symbols.length) symbols = SANCTUM_MAJOR_LSTS;
-  const list = [...new Set(symbols.map((s) => lstParam(s, "lsts[]")))];
-
-  const [latest, inception] = await Promise.all([
-    batched("apy/latest", list, opts),
-    batched("apy/inception", list, opts),
-  ]);
-
-  const apys = list.map((symbol) => {
-    const epoch = Number(latest.values[symbol]);
-    const since = Number(inception.values[symbol]);
-    return {
-      lst: symbol,
-      apyLatest: Number.isFinite(epoch) ? epoch : null,
-      apyLatestPct: Number.isFinite(epoch) ? epoch * 100 : null,
-      apyInception: Number.isFinite(since) ? since : null,
-      apyInceptionPct: Number.isFinite(since) ? since * 100 : null,
-      error: latest.errs[symbol] || inception.errs[symbol] || null,
-    };
-  });
-  apys.sort((a, b) => (b.apyInception ?? -1) - (a.apyInception ?? -1));
-
-  return {
-    provider: "sanctum-lst",
-    chain: "solana-mainnet-beta",
-    count: apys.length,
-    apys,
-    byLst: Object.fromEntries(apys.map((a) => [a.lst, a])),
-  };
-}
-
-/**
- * Full picture for one LST: current + inception APY, TVL in lamports, and the
- * SOL value of one token (the number that reveals accrued staking value).
- */
-export async function sanctumApyIndividual(args = {}, opts = {}) {
-  const lst = lstParam(args.lst || args.mint || args.symbol, "lst");
-  const [latest, inception, tvl, solValue] = await Promise.all([
-    batched("apy/latest", [lst], opts),
-    batched("apy/inception", [lst], opts),
-    batched("tvl/current", [lst], opts).catch(() => ({ values: {}, errs: {} })),
-    batched("sol-value/current", [lst], opts).catch(() => ({ values: {}, errs: {} })),
-  ]);
-  const epoch = Number(latest.values[lst]);
-  const since = Number(inception.values[lst]);
-  const err = latest.errs[lst] || inception.errs[lst] || null;
-  if (!Number.isFinite(epoch) && !Number.isFinite(since)) {
-    throw new Error(`sanctum-lst: no APY for ${lst}${err ? ` (${JSON.stringify(err)})` : ""}`);
-  }
-  const solValueRaw = solValue.values[lst];
-  return {
-    provider: "sanctum-lst",
-    chain: "solana-mainnet-beta",
-    lst,
-    apyLatest: Number.isFinite(epoch) ? epoch : null,
-    apyLatestPct: Number.isFinite(epoch) ? epoch * 100 : null,
-    apyInception: Number.isFinite(since) ? since : null,
-    apyInceptionPct: Number.isFinite(since) ? since * 100 : null,
-    tvlLamports: tvl.values[lst] ?? null,
-    tvlSol: tvl.values[lst] != null ? Number(tvl.values[lst]) / 1e9 : null,
-    // Lamports of SOL backing one LST token (9 decimals).
-    solValueLamports: solValueRaw ?? null,
-    solPerToken: solValueRaw != null ? Number(solValueRaw) / 1e9 : null,
-    error: err,
-  };
-}