@oracle-agent/oracle 0.11.0 → 0.13.0

package/src/data/providers/hl-info.mjs

@@ -1,108 +0,0 @@
-// Hyperliquid public info client — read-only, no agent key.
-
-import { httpJson } from "../http.mjs";
-
-export const HL_INFO_MAINNET = "https://api.hyperliquid.xyz/info";
-export const HL_INFO_TESTNET = "https://api.hyperliquid-testnet.xyz/info";
-
-function infoUrl({ testnet, baseUrl } = {}) {
-  if (baseUrl) {
-    return baseUrl.replace(/\/$/, "").endsWith("/info")
-      ? baseUrl
-      : `${baseUrl.replace(/\/$/, "")}/info`;
-  }
-  if (process.env.HL_INFO_URL) return process.env.HL_INFO_URL;
-  if (process.env.HL_API_URL) {
-    const b = process.env.HL_API_URL.replace(/\/$/, "");
-    return b.endsWith("/info") ? b : `${b}/info`;
-  }
-  return testnet || process.env.HL_TESTNET === "1" ? HL_INFO_TESTNET : HL_INFO_MAINNET;
-}
-
-export async function hlInfo(body, opts = {}) {
-  if (!body || !body.type) throw new Error("hlInfo requires body.type");
-  const url = infoUrl(opts);
-  return httpJson(url, {
-    method: "POST",
-    body,
-    fetchImpl: opts.fetchImpl,
-    timeoutMs: opts.timeoutMs,
-  });
-}
-
-export async function hlHealth(opts = {}) {
-  const mids = await hlInfo({ type: "allMids" }, opts);
-  const n = mids && typeof mids === "object" ? Object.keys(mids).length : 0;
-  return { ok: n > 0, midCount: n };
-}
-
-export async function hlAllMids(opts = {}) {
-  return hlInfo({ type: "allMids" }, opts);
-}
-
-export async function hlL2Book(coin, opts = {}) {
-  if (!coin) throw new Error("hlL2Book requires coin");
-  return hlInfo({ type: "l2Book", coin: String(coin) }, opts);
-}
-
-export async function hlOutcomeMeta(opts = {}) {
-  return hlInfo({ type: "outcomeMeta" }, opts);
-}
-
-export async function hlClearinghouse(user, opts = {}) {
-  if (!user) throw new Error("hlClearinghouse requires user address");
-  return hlInfo({ type: "spotClearinghouseState", user }, opts);
-}
-
-export async function hlUserFills(user, opts = {}) {
-  if (!user) throw new Error("hlUserFills requires user address");
-  return hlInfo({ type: "userFills", user }, opts);
-}
-
-// D1 expansions
-export async function hlMeta(opts = {}) {
-  return hlInfo({ type: "meta" }, opts);
-}
-
-export async function hlMetaAndAssetCtxs(opts = {}) {
-  const body = { type: "metaAndAssetCtxs" };
-  if (opts.dex) body.dex = opts.dex;
-  return hlInfo(body, opts);
-}
-
-export async function hlPerpDexs(opts = {}) {
-  return hlInfo({ type: "perpDexs" }, opts);
-}
-
-export async function hlCandleSnapshot({ coin, interval = "1h", startTime, endTime }, opts = {}) {
-  if (!coin) throw new Error("hlCandleSnapshot requires coin");
-  const req = {
-    type: "candleSnapshot",
-    req: {
-      coin: String(coin),
-      interval,
-      startTime: startTime ?? Date.now() - 24 * 3600 * 1000,
-      endTime: endTime ?? Date.now(),
-    },
-  };
-  return hlInfo(req, opts);
-}
-
-export async function hlOpenOrders(user, opts = {}) {
-  if (!user) throw new Error("hlOpenOrders requires user");
-  return hlInfo({ type: "openOrders", user }, opts);
-}
-
-export async function hlFrontendOpenOrders(user, opts = {}) {
-  if (!user) throw new Error("hlFrontendOpenOrders requires user");
-  return hlInfo({ type: "frontendOpenOrders", user }, opts);
-}
-
-export async function hlUserState(user, opts = {}) {
-  if (!user) throw new Error("hlUserState requires user");
-  return hlInfo({ type: "clearinghouseState", user }, opts);
-}
-
-export async function hlSpotMeta(opts = {}) {
-  return hlInfo({ type: "spotMeta" }, opts);
-}

package/src/data/providers/hl-markets.mjs

@@ -1,210 +0,0 @@
-// Hyperliquid market datapoints for the Hyperliquid agent.
-//
-// The raw /info endpoints return parallel arrays and stringly-typed numbers
-// that every consumer ends up re-deriving: universe[i] pairs with assetCtxs[i],
-// funding is an 8-hour decimal that people want annualized, open interest is
-// denominated in the coin rather than USD. Doing that join once, here, keeps
-// every chart and card consistent instead of each one inventing its own math.
-//
-// Reads only. No keys, no signing.
-
-import { hlMetaAndAssetCtxs, hlAllMids, hlCandleSnapshot, hlL2Book, hlSpotMeta } from "./hl-info.mjs";
-
-/** Liveness: the media lane is healthy when the underlying info plane answers. */
-export async function hlMarketsHealth(opts = {}) {
-  const t0 = Date.now();
-  try {
-    const mids = await hlAllMids(opts);
-    return {
-      provider: "hl-markets",
-      ok: true,
-      venue: "hyperliquid",
-      symbols: Object.keys(mids || {}).length,
-      latencyMs: Date.now() - t0,
-    };
-  } catch (e) {
-    return { provider: "hl-markets", ok: false, error: String(e?.message || e), latencyMs: Date.now() - t0 };
-  }
-}
-
-const HOURS_PER_YEAR = 24 * 365;
-const FUNDING_INTERVAL_HOURS = 8;
-
-function num(value) {
-  if (value == null) return null;
-  const n = Number(value);
-  return Number.isFinite(n) ? n : null;
-}
-
-function pct(a, b) {
-  if (a == null || b == null || b === 0) return null;
-  return ((a - b) / b) * 100;
-}
-
-/**
- * Join the perp universe with its asset contexts into one flat row per market.
- *
- * This is THE datapoint set for an Hyperliquid agent board: price, 24h change, volume,
- * open interest in both coin and USD, funding (interval + annualized), and the
- * leverage/decimals metadata needed to render or size an order.
- */
-export async function hlMarketDatapoints(args = {}, opts = {}) {
-  const [meta, mids] = await Promise.all([
-    hlMetaAndAssetCtxs(opts),
-    hlAllMids(opts).catch(() => ({})),
-  ]);
-
-  // metaAndAssetCtxs returns [ { universe: [...] }, [ ctx, ... ] ]
-  const universe = meta?.[0]?.universe ?? meta?.universe ?? [];
-  const ctxs = Array.isArray(meta?.[1]) ? meta[1] : [];
-
-  const rows = universe.map((asset, i) => {
-    const ctx = ctxs[i] || {};
-    const mark = num(ctx.markPx);
-    const prev = num(ctx.prevDayPx);
-    const oiCoin = num(ctx.openInterest);
-    const funding = num(ctx.funding);
-
-    return {
-      coin: asset.name,
-      index: i,
-      markPx: mark,
-      oraclePx: num(ctx.oraclePx),
-      midPx: num(ctx.midPx) ?? num(mids?.[asset.name]),
-      prevDayPx: prev,
-      change24hPct: pct(mark, prev),
-      dayNtlVolumeUsd: num(ctx.dayNtlVlm),
-      premium: num(ctx.premium),
-      // funding is the per-8h rate as a decimal; both forms are useful and
-      // people get the conversion wrong constantly.
-      fundingRate: funding,
-      fundingRateAprPct: funding == null ? null : funding * (HOURS_PER_YEAR / FUNDING_INTERVAL_HOURS) * 100,
-      openInterestCoin: oiCoin,
-      openInterestUsd: oiCoin == null || mark == null ? null : oiCoin * mark,
-      maxLeverage: asset.maxLeverage ?? null,
-      szDecimals: asset.szDecimals ?? null,
-      isDelisted: Boolean(asset.isDelisted),
-    };
-  });
-
-  const live = rows.filter((r) => !r.isDelisted);
-  return {
-    provider: "hl-info",
-    venue: "hyperliquid",
-    kind: "market-datapoints",
-    asOfMs: Date.now(),
-    count: live.length,
-    markets: live,
-    totals: {
-      openInterestUsd: live.reduce((a, r) => a + (r.openInterestUsd || 0), 0),
-      dayNtlVolumeUsd: live.reduce((a, r) => a + (r.dayNtlVolumeUsd || 0), 0),
-    },
-  };
-}
-
-/** Top movers / volume / OI / funding leaders — the standard board cuts. */
-export async function hlLeaderboards(args = {}, opts = {}) {
-  const limit = Math.max(1, Math.min(Number(args.limit) || 10, 50));
-  const { markets, asOfMs, totals } = await hlMarketDatapoints(args, opts);
-
-  const by = (key, dir = -1) =>
-    markets
-      .filter((m) => m[key] != null)
-      .sort((a, b) => (a[key] - b[key]) * dir)
-      .slice(0, limit);
-
-  return {
-    provider: "hl-info",
-    venue: "hyperliquid",
-    kind: "leaderboards",
-    asOfMs,
-    totals,
-    gainers: by("change24hPct"),
-    losers: by("change24hPct", 1),
-    byVolume: by("dayNtlVolumeUsd"),
-    byOpenInterest: by("openInterestUsd"),
-    fundingHighest: by("fundingRateAprPct"),
-    fundingLowest: by("fundingRateAprPct", 1),
-  };
-}
-
-/**
- * One coin, everything a segment or card needs: current state, the recent
- * candle series, and top-of-book depth.
- */
-export async function hlCoinDatapoints(args = {}, opts = {}) {
-  const coin = String(args.coin || args.symbol || "").trim().toUpperCase();
-  if (!coin) throw new Error("hl-markets: coin required");
-  const interval = String(args.interval || "1h");
-  const lookbackMs = Number(args.lookbackMs) || 24 * 60 * 60 * 1000;
-  const endTime = Date.now();
-  const startTime = endTime - lookbackMs;
-
-  const [board, candles, book] = await Promise.all([
-    hlMarketDatapoints({}, opts),
-    hlCandleSnapshot({ coin, interval, startTime, endTime }, opts).catch(() => []),
-    // hlL2Book takes a bare coin string, not an args object.
-    hlL2Book(coin, opts).catch(() => null),
-  ]);
-
-  const market = board.markets.find((m) => m.coin === coin) || null;
-  if (!market) throw new Error(`hl-markets: ${coin} is not a listed perp`);
-
-  const series = (Array.isArray(candles) ? candles : []).map((c) => ({
-    t: Number(c.t),
-    open: num(c.o),
-    high: num(c.h),
-    low: num(c.l),
-    close: num(c.c),
-    volume: num(c.v),
-  }));
-
-  const levels = book?.levels ?? [];
-  const bestBid = num(levels?.[0]?.[0]?.px);
-  const bestAsk = num(levels?.[1]?.[0]?.px);
-
-  return {
-    provider: "hl-info",
-    venue: "hyperliquid",
-    kind: "coin-datapoints",
-    asOfMs: Date.now(),
-    coin,
-    market,
-    book: {
-      bestBid,
-      bestAsk,
-      spread: bestBid == null || bestAsk == null ? null : bestAsk - bestBid,
-      spreadBps: bestBid == null || bestAsk == null || bestAsk === 0 ? null : ((bestAsk - bestBid) / bestAsk) * 10_000,
-    },
-    candles: { interval, count: series.length, series },
-  };
-}
-
-/** Spot pairs, joined the same way. */
-export async function hlSpotDatapoints(args = {}, opts = {}) {
-  const spot = await hlSpotMeta(opts);
-  const tokens = spot?.tokens ?? [];
-  const pairs = spot?.universe ?? [];
-  return {
-    provider: "hl-info",
-    venue: "hyperliquid",
-    kind: "spot-datapoints",
-    asOfMs: Date.now(),
-    tokenCount: tokens.length,
-    pairCount: pairs.length,
-    tokens: tokens.map((t) => ({
-      name: t.name,
-      index: t.index,
-      szDecimals: t.szDecimals ?? null,
-      weiDecimals: t.weiDecimals ?? null,
-      tokenId: t.tokenId ?? null,
-      isCanonical: Boolean(t.isCanonical),
-    })),
-    pairs: pairs.map((p) => ({
-      name: p.name,
-      index: p.index,
-      tokens: p.tokens,
-      isCanonical: Boolean(p.isCanonical),
-    })),
-  };
-}

package/src/data/providers/hl-outcome.mjs

@@ -1,61 +0,0 @@
-// HIP-4 outcome market prepare helpers (local, no VPS).
-import { stampPrepared } from "../../prepare-envelope.mjs";
-import { hlOutcomeMeta } from "./hl-info.mjs";
-import { outcomeAssetId, parseOutcomeCoin } from "./hl-assets.mjs";
-import { hlPreparePerpOrder, hlPrepareCancelOrder } from "./hl-perps.mjs";
-
-export async function hlOutcomeList(opts = {}) {
-  const meta = await hlOutcomeMeta(opts);
-  return {
-    provider: "hl-outcome",
-    kind: "outcome-meta",
-    outcomes: meta?.outcomes || [],
-    questions: meta?.questions || [],
-  };
-}
-
-/**
- * Prepare a HIP-4 outcome order.
- * args: { outcome, side: 0|1|'yes'|'no', sideName?, coin?, ...hlPreparePerpOrder fields }
- */
-export async function hlPrepareOutcomeOrder(args = {}, opts = {}) {
-  let coin = args.coin;
-  let outcome = args.outcome;
-  let side = args.side;
-  if (typeof side === "string") {
-    const s = side.toLowerCase();
-    if (s === "yes" || s === "0") side = 0;
-    else if (s === "no" || s === "1") side = 1;
-  }
-  if (args.sideName && outcome != null) {
-    const meta = await hlOutcomeMeta(opts);
-    const o = (meta?.outcomes || []).find((x) => Number(x.outcome) === Number(outcome));
-    if (o?.sideSpecs) {
-      const idx = o.sideSpecs.findIndex(
-        (sp) => String(sp.name).toLowerCase() === String(args.sideName).toLowerCase()
-      );
-      if (idx >= 0) side = idx;
-    }
-  }
-  if (!coin) {
-    if (outcome == null || side == null) {
-      throw new Error("hl-outcome: provide coin (#N) or outcome + side (0/1 or yes/no)");
-    }
-    coin = outcomeAssetId(outcome, side).coin;
-  }
-  const prepared = await hlPreparePerpOrder({ ...args, coin }, opts);
-  // ensure stamped kind
-  return stampPrepared(
-    { ...prepared, kind: "hip4-order", provider: "hl-perps" },
-    { provider: "hl-perps", kind: "hip4-order" }
-  );
-}
-
-export async function hlPrepareOutcomeCancel(args = {}, opts = {}) {
-  let coin = args.coin;
-  if (!coin && args.outcome != null) {
-    const side = args.side ?? 0;
-    coin = outcomeAssetId(args.outcome, side).coin;
-  }
-  return hlPrepareCancelOrder({ ...args, coin }, opts);
-}