@oracle-agent/oracle 0.11.0 → 0.12.0

package/src/data/providers/defillama.mjs

@@ -1,88 +0,0 @@
-// DeFiLlama public prices — protocol pack D3 (no API key).
-
-import { httpJson } from "../http.mjs";
-
-export const DEFILLAMA_COINS = "https://coins.llama.fi";
-export const DEFILLAMA_API = "https://api.llama.fi";
-export const DEFILLAMA_YIELDS = "https://yields.llama.fi";
-export const DEFILLAMA_STABLECOINS = "https://stablecoins.llama.fi";
-
-function coinsBase(opts = {}) {
-  return (opts.baseUrl || process.env.DEFILLAMA_COINS_URL || DEFILLAMA_COINS).replace(/\/$/, "");
-}
-
-function apiBase(opts = {}) {
-  return (opts.baseUrl || process.env.DEFILLAMA_API_URL || DEFILLAMA_API).replace(/\/$/, "");
-}
-
-/** @param {string[]} coins e.g. ['coingecko:ethereum','coingecko:bitcoin'] */
-export async function llamaPrices(coins, opts = {}) {
-  if (!Array.isArray(coins) || !coins.length) throw new Error("llamaPrices requires coins[]");
-  const path = coins.map(encodeURIComponent).join(",");
-  return httpJson(`${coinsBase(opts)}/prices/current/${path}`, {
-    fetchImpl: opts.fetchImpl,
-    timeoutMs: opts.timeoutMs,
-  });
-}
-
-export async function llamaHealth(opts = {}) {
-  const data = await llamaPrices(["coingecko:ethereum"], opts);
-  const eth = data?.coins?.["coingecko:ethereum"];
-  return { ok: !!eth?.price, ethUsd: eth?.price ?? null };
-}
-
-export async function llamaProtocols(opts = {}) {
-  return httpJson(`${apiBase(opts)}/protocols`, {
-    fetchImpl: opts.fetchImpl,
-    timeoutMs: opts.timeoutMs ?? 20_000,
-  });
-}
-
-export async function llamaYields(args = {}, opts = {}) {
-  const base = (opts.yieldsBaseUrl || process.env.DEFILLAMA_YIELDS_URL || DEFILLAMA_YIELDS).replace(/\/$/, "");
-  const result = await httpJson(`${base}/pools`, {
-    fetchImpl: opts.fetchImpl,
-    timeoutMs: opts.timeoutMs ?? 30_000,
-  });
-  let rows = Array.isArray(result?.data) ? result.data : [];
-  if (args.chain) rows = rows.filter((x) => String(x.chain).toLowerCase() === String(args.chain).toLowerCase());
-  if (args.project) rows = rows.filter((x) => String(x.project).toLowerCase() === String(args.project).toLowerCase());
-  if (args.stablecoin != null) rows = rows.filter((x) => Boolean(x.stablecoin) === Boolean(args.stablecoin));
-  rows.sort((a, b) => Number(b.tvlUsd || 0) - Number(a.tvlUsd || 0));
-  const limit = Math.min(5000, Math.max(1, Number(args.limit || rows.length || 1)));
-  return { ...result, data: rows.slice(0, limit) };
-}
-
-export async function llamaStablecoins(args = {}, opts = {}) {
-  const base = (opts.stablecoinsBaseUrl || process.env.DEFILLAMA_STABLECOINS_URL || DEFILLAMA_STABLECOINS).replace(/\/$/, "");
-  const includePrices = args.includePrices !== false;
-  return httpJson(`${base}/stablecoins?includePrices=${includePrices}`, {
-    fetchImpl: opts.fetchImpl,
-    timeoutMs: opts.timeoutMs ?? 30_000,
-  });
-}
-
-export async function llamaDexVolumes(args = {}, opts = {}) {
-  const chain = encodeURIComponent(String(args.chain || "Ethereum"));
-  const params = new URLSearchParams({
-    excludeTotalDataChart: String(args.includeChart !== true),
-    excludeTotalDataChartBreakdown: String(args.includeBreakdown !== true),
-    dataType: "dailyVolume",
-  });
-  return httpJson(`${apiBase(opts)}/overview/dexs/${chain}?${params}`, {
-    fetchImpl: opts.fetchImpl,
-    timeoutMs: opts.timeoutMs ?? 30_000,
-  });
-}
-
-/** Convenience: map symbols via coingecko ids */
-export async function llamaPricesBySymbol(symbols = ["ethereum", "bitcoin", "solana"], opts = {}) {
-  const coins = symbols.map((s) => `coingecko:${String(s).toLowerCase()}`);
-  const data = await llamaPrices(coins, opts);
-  const out = {};
-  for (const s of symbols) {
-    const key = `coingecko:${String(s).toLowerCase()}`;
-    out[s] = data?.coins?.[key] || null;
-  }
-  return out;
-}

package/src/data/providers/dexscreener.mjs

@@ -1,43 +0,0 @@
-// DexScreener public API — token/pair discovery, no key.
-
-import { httpJson } from "../http.mjs";
-
-export const DEXSCREENER_API = "https://api.dexscreener.com";
-
-function base(opts = {}) {
-  return (opts.baseUrl || process.env.DEXSCREENER_API_URL || DEXSCREENER_API).replace(/\/$/, "");
-}
-
-export async function dexscreenerHealth(opts = {}) {
-  // tokenless root sometimes 404 — use a known stablecoin query
-  const data = await httpJson(
-    `${base(opts)}/latest/dex/search?q=USDC`,
-    { fetchImpl: opts.fetchImpl, timeoutMs: opts.timeoutMs ?? 12_000 }
-  );
-  const n = data?.pairs?.length || 0;
-  return { ok: n > 0, pairSample: n };
-}
-
-export async function dexscreenerToken(tokenAddress, opts = {}) {
-  if (!tokenAddress) throw new Error("tokenAddress required");
-  return httpJson(`${base(opts)}/latest/dex/tokens/${tokenAddress}`, {
-    fetchImpl: opts.fetchImpl,
-    timeoutMs: opts.timeoutMs ?? 12_000,
-  });
-}
-
-export async function dexscreenerSearch(q, opts = {}) {
-  if (!q) throw new Error("query required");
-  return httpJson(`${base(opts)}/latest/dex/search?q=${encodeURIComponent(q)}`, {
-    fetchImpl: opts.fetchImpl,
-    timeoutMs: opts.timeoutMs ?? 12_000,
-  });
-}
-
-export async function dexscreenerPair(chainId, pairAddress, opts = {}) {
-  if (!chainId || !pairAddress) throw new Error("chainId and pairAddress required");
-  return httpJson(`${base(opts)}/latest/dex/pairs/${chainId}/${pairAddress}`, {
-    fetchImpl: opts.fetchImpl,
-    timeoutMs: opts.timeoutMs ?? 12_000,
-  });
-}

package/src/data/providers/evm-rpc.mjs

@@ -1,225 +0,0 @@
-// EVM JSON-RPC read pack — multi-chain balances/blocks via public or env RPCs.
-// No wallet keys. Uses chain registry rpcEnv + optional public fallbacks.
-
-import { httpJson } from "../http.mjs";
-import { CHAINS, chainById, rpcUrlFor, isSupportedChain } from "../../chains.mjs";
-import { Interface, getAddress } from "ethers";
-
-const ERC20 = new Interface([
-  "function allowance(address owner,address spender) view returns (uint256)",
-  "function balanceOf(address account) view returns (uint256)",
-]);
-
-function normalizeAddress(value, label) {
-  try {
-    return getAddress(value).toLowerCase();
-  } catch {
-    throw new Error(`${label} must be a valid EVM address`);
-  }
-}
-
-function normalizeTxHash(value) {
-  const hash = String(value || "").trim();
-  if (!/^0x[0-9a-fA-F]{64}$/.test(hash)) throw new Error("txHash must be a 32-byte hex transaction hash");
-  return hash.toLowerCase();
-}
-
-function parseHexInt(value) {
-  if (value == null) return null;
-  return Number.parseInt(String(value), 16);
-}
-
-/** Public fallbacks when env RPC unset — rate-limited, fine for health/read. */
-export const PUBLIC_RPC_FALLBACKS = {
-  1: "https://ethereum.publicnode.com",
-  137: "https://polygon-bor-rpc.publicnode.com",
-  42161: "https://arbitrum-one-rpc.publicnode.com",
-  8453: "https://base-rpc.publicnode.com",
-  10: "https://optimism-rpc.publicnode.com",
-  988: "https://rpc.stable.xyz",
-  56: "https://bsc-rpc.publicnode.com",
-  43114: "https://avalanche-c-chain-rpc.publicnode.com",
-  999: "https://rpc.hyperliquid.xyz/evm",
-  2741: "https://api.mainnet.abs.xyz",
-  4663: "https://rpc.mainnet.chain.robinhood.com",
-};
-
-/**
- * Resolve RPC URL for a chainId: explicit > env (registry) > public fallback.
- */
-export function resolveRpcUrl(chainId, { rpcUrl, env = process.env } = {}) {
-  if (rpcUrl) return rpcUrl;
-  const fromEnv = rpcUrlFor(chainId, env);
-  if (fromEnv) return fromEnv;
-  return PUBLIC_RPC_FALLBACKS[Number(chainId)] || null;
-}
-
-/**
- * JSON-RPC call
- * @param {number} chainId
- * @param {string} method
- * @param {any[]} [params]
- */
-
-// `rpcCall` is the raw public transport exposed by the data facade. It must be
-// an allowlist, not a partial write denylist: every unrecognized method is
-// unsafe to forward because vendors add write namespaces (`wallet_send*`,
-// `pm_sendUserOperation`, `mev_sendBundle`) faster than a denylist stays fresh.
-//
-// Canonical JSON-RPC method names are ASCII lowercase + underscores. Reject
-// whitespace, separator tricks, and Unicode homoglyphs rather than normalizing
-// them into a different network request.
-const EVM_READ_RPC = /^(?:eth_(?:call|blocknumber|chainid|get[a-z0-9]+|feehistory|gasprice|maxpriorityfeepergas|syncing|protocolversion|estimategas|createaccesslist)|net_(?:version|listening|peercount)|web3_(?:clientversion|sha3))$/;
-
-function readRpcMethod(method) {
-  const raw = String(method || "");
-  const probe = raw.toLowerCase();
-  if (raw !== raw.trim() || !/^[a-zA-Z0-9_]+$/.test(raw) || !EVM_READ_RPC.test(probe)) {
-    throw new Error(`evm-rpc: ${raw} refused — @oracle-agent/oracle is prepare-only (read RPC only; no broadcast/sign)`);
-  }
-  return probe;
-}
-
-export async function rpcCall(chainId, method, params = [], opts = {}) {
-  const methodName = String(method || "");
-  readRpcMethod(methodName);
-  const url = resolveRpcUrl(chainId, opts);
-  if (!url) {
-    throw new Error(
-      `No RPC URL for chainId ${chainId} (set env from chain registry rpcEnv or pass rpcUrl)`
-    );
-  }
-  const body = { jsonrpc: "2.0", id: 1, method, params };
-  const res = await httpJson(url, {
-    method: "POST",
-    body,
-    fetchImpl: opts.fetchImpl,
-    timeoutMs: opts.timeoutMs ?? 12_000,
-  });
-  if (res?.error) {
-    const err = new Error(res.error.message || JSON.stringify(res.error));
-    err.code = res.error.code;
-    throw err;
-  }
-  return res.result;
-}
-
-export async function rpcHealth(chainId, opts = {}) {
-  const blockHex = await rpcCall(chainId, "eth_blockNumber", [], opts);
-  const block = parseInt(blockHex, 16);
-  const idHex = await rpcCall(chainId, "eth_chainId", [], opts);
-  const reported = parseInt(idHex, 16);
-  return {
-    ok: Number.isFinite(block) && reported === Number(chainId),
-    chainId: Number(chainId),
-    reportedChainId: reported,
-    blockNumber: block,
-    name: chainById(chainId)?.name || null,
-  };
-}
-
-export async function rpcBlockNumber(chainId, opts = {}) {
-  const hex = await rpcCall(chainId, "eth_blockNumber", [], opts);
-  return parseInt(hex, 16);
-}
-
-export async function rpcChainId(chainId, opts = {}) {
-  const hex = await rpcCall(chainId, "eth_chainId", [], opts);
-  return parseInt(hex, 16);
-}
-
-export async function rpcGetBalance(chainId, address, opts = {}) {
-  if (!address) throw new Error("rpcGetBalance requires address");
-  const hex = await rpcCall(chainId, "eth_getBalance", [address, "latest"], opts);
-  return { chainId: Number(chainId), address, balanceWei: BigInt(hex).toString(), balanceHex: hex };
-}
-
-export async function erc20Allowance(args = {}, opts = {}) {
-  const chainId = Number(args.chainId ?? opts.chainId ?? 1);
-  const token = normalizeAddress(args.token || args.tokenAddress, "token");
-  const owner = normalizeAddress(args.owner, "owner");
-  const spender = normalizeAddress(args.spender, "spender");
-  const data = ERC20.encodeFunctionData("allowance", [owner, spender]);
-  const result = await rpcCall(chainId, "eth_call", [{ to: token, data }, args.blockTag || "latest"], opts);
-  const decoded = ERC20.decodeFunctionResult("allowance", result);
-  const allowance = BigInt(decoded[0]);
-  return {
-    chainId,
-    token,
-    owner,
-    spender,
-    allowance: allowance.toString(),
-    allowanceHex: `0x${allowance.toString(16)}`,
-    blockTag: args.blockTag || "latest",
-  };
-}
-
-export async function erc20BalanceOf(args = {}, opts = {}) {
-  const chainId = Number(args.chainId ?? opts.chainId ?? 1);
-  const token = normalizeAddress(args.token || args.tokenAddress, "token");
-  const account = normalizeAddress(args.account || args.owner || args.address, "account");
-  const data = ERC20.encodeFunctionData("balanceOf", [account]);
-  const result = await rpcCall(chainId, "eth_call", [{ to: token, data }, args.blockTag || "latest"], opts);
-  const decoded = ERC20.decodeFunctionResult("balanceOf", result);
-  const balance = BigInt(decoded[0]);
-  return {
-    chainId,
-    token,
-    account,
-    balance: balance.toString(),
-    balanceHex: `0x${balance.toString(16)}`,
-    blockTag: args.blockTag || "latest",
-  };
-}
-
-export async function transactionReceipt(args = {}, opts = {}) {
-  const chainId = Number(args.chainId ?? opts.chainId ?? 1);
-  const txHash = normalizeTxHash(args.txHash || args.hash || args.transactionHash);
-  const receipt = await rpcCall(chainId, "eth_getTransactionReceipt", [txHash], opts);
-  if (!receipt) {
-    return { ok: false, chainId, txHash, status: "pending", receipt: null, reason: "receipt pending" };
-  }
-  const statusNumber = parseHexInt(receipt.status);
-  let ok = statusNumber === 1;
-  const status = statusNumber === 1 ? "success" : statusNumber === 0 ? "reverted" : "unknown";
-  let reason = ok ? null : status === "reverted" ? "transaction reverted" : "unknown receipt status";
-  const expectedTo = args.expectedTo ? normalizeAddress(args.expectedTo, "expectedTo") : null;
-  const actualTo = receipt.to ? normalizeAddress(receipt.to, "receipt.to") : null;
-  if (expectedTo && actualTo !== expectedTo) {
-    ok = false;
-    reason = `to mismatch: expected ${expectedTo}, got ${actualTo || "null"}`;
-  }
-  return {
-    ok,
-    chainId,
-    txHash,
-    status,
-    reason,
-    statusCode: statusNumber,
-    to: actualTo,
-    from: receipt.from ? normalizeAddress(receipt.from, "receipt.from") : null,
-    blockNumber: parseHexInt(receipt.blockNumber),
-    transactionIndex: parseHexInt(receipt.transactionIndex),
-    logs: Array.isArray(receipt.logs) ? receipt.logs : [],
-    receipt,
-  };
-}
-
-export async function rpcHealthAll(opts = {}) {
-  const ids = opts.chainIds || Object.values(CHAINS).map((c) => c.chainId);
-  const out = {};
-  await Promise.all(
-    ids.map(async (id) => {
-      if (!isSupportedChain(id) && !PUBLIC_RPC_FALLBACKS[id] && !resolveRpcUrl(id, opts)) {
-        out[id] = { ok: false, error: "no rpc configured", chainId: id };
-        return;
-      }
-      try {
-        out[id] = await rpcHealth(id, opts);
-      } catch (e) {
-        out[id] = { ok: false, chainId: id, error: String(e.message || e) };
-      }
-    })
-  );
-  return out;
-}

package/src/data/providers/geckoterminal.mjs

@@ -1,34 +0,0 @@
-// GeckoTerminal public market-data API — no key.
-import { httpJson } from "../http.mjs";
-
-export const GECKOTERMINAL_API = "https://api.geckoterminal.com/api/v2";
-const base = (o={}) => (o.baseUrl || process.env.GECKOTERMINAL_API_URL || GECKOTERMINAL_API).replace(/\/$/, "");
-const enc = (v) => encodeURIComponent(String(v));
-
-export async function geckoNetworks(args = {}, opts = {}) {
-  const page = Math.max(1, Number(args.page || 1));
-  return httpJson(`${base(opts)}/networks?page=${page}`, { fetchImpl: opts.fetchImpl, timeoutMs: opts.timeoutMs });
-}
-export async function geckoPool(args = {}, opts = {}) {
-  if (!args.network || !args.poolAddress) throw new Error("network and poolAddress required");
-  return httpJson(`${base(opts)}/networks/${enc(args.network)}/pools/${enc(args.poolAddress)}`, { fetchImpl: opts.fetchImpl, timeoutMs: opts.timeoutMs });
-}
-export async function geckoToken(args = {}, opts = {}) {
-  if (!args.network || !(args.address || args.tokenAddress)) throw new Error("network and token address required");
-  return httpJson(`${base(opts)}/networks/${enc(args.network)}/tokens/${enc(args.address || args.tokenAddress)}`, { fetchImpl: opts.fetchImpl, timeoutMs: opts.timeoutMs });
-}
-export async function geckoPoolOhlcv(args = {}, opts = {}) {
-  if (!args.network || !args.poolAddress) throw new Error("network and poolAddress required");
-  const timeframe = ["minute","hour","day"].includes(args.timeframe) ? args.timeframe : "hour";
-  const p = new URLSearchParams();
-  p.set("aggregate", String(Math.max(1, Number(args.aggregate || 1))));
-  p.set("limit", String(Math.min(1000, Math.max(1, Number(args.limit || 168)))));
-  if (args.beforeTimestamp != null) p.set("before_timestamp", String(args.beforeTimestamp));
-  if (args.currency) p.set("currency", String(args.currency));
-  if (args.token) p.set("token", String(args.token));
-  return httpJson(`${base(opts)}/networks/${enc(args.network)}/pools/${enc(args.poolAddress)}/ohlcv/${timeframe}?${p}`, { fetchImpl: opts.fetchImpl, timeoutMs: opts.timeoutMs });
-}
-export async function geckoHealth(opts = {}) {
-  const data = await geckoNetworks({ page: 1 }, opts);
-  return { ok: Array.isArray(data?.data) && data.data.length > 0, networkSample: data?.data?.length || 0 };
-}