opentool 0.8.21 → 0.8.23

package/dist/adapters/hyperliquid/index.d.ts

@@ -4,6 +4,30 @@ import 'viem';
 import 'viem/accounts';
 
 type HyperliquidEnvironment = "mainnet" | "testnet";
+type MarketIdentity = {
+    market_type: "perp" | "spot" | "dex";
+    venue: "hyperliquid";
+    environment: HyperliquidEnvironment;
+    base: string;
+    quote?: string | null;
+    dex?: string | null;
+    chain_id?: number | null;
+    pool_address?: string | null;
+    token0_address?: string | null;
+    token1_address?: string | null;
+    fee_tier?: number | null;
+    raw_symbol?: string | null;
+    canonical_symbol: string;
+};
+type HyperliquidMarketIdentityInput = {
+    environment: HyperliquidEnvironment;
+    symbol: string;
+    rawSymbol?: string | null;
+    isSpot?: boolean;
+    base?: string | null;
+    quote?: string | null;
+};
+declare function buildHyperliquidMarketIdentity(input: HyperliquidMarketIdentityInput): MarketIdentity | null;
 type HyperliquidTimeInForce = "Gtc" | "Ioc" | "Alo" | "FrontendMarket" | "LiquidationMarket";
 type HyperliquidGrouping = "na" | "normalTpsl" | "positionTpsl";
 type HyperliquidTriggerType = "tp" | "sl";
@@ -448,4 +472,4 @@ declare const __hyperliquidInternals: {
     splitSignature: typeof splitSignature;
 };
 
-export { DEFAULT_HYPERLIQUID_MARKET_SLIPPAGE_BPS, type HyperliquidAbstraction, type HyperliquidAccountMode, HyperliquidApiError, type HyperliquidApproveBuilderFeeOptions, type HyperliquidApproveBuilderFeeResponse, HyperliquidBuilderApprovalError, type HyperliquidBuilderApprovalRecordInput, type HyperliquidBuilderFee, type HyperliquidClearinghouseState, type HyperliquidDepositResult, type HyperliquidEnvironment, HyperliquidExchangeClient, type HyperliquidExchangeResponse, type HyperliquidGrouping, HyperliquidGuardError, HyperliquidInfoClient, type HyperliquidOrderIntent, type HyperliquidOrderOptions, type HyperliquidOrderResponse, type HyperliquidOrderStatus, HyperliquidTermsError, type HyperliquidTermsRecordInput, type HyperliquidTimeInForce, type HyperliquidTriggerOptions, type HyperliquidTriggerType, type HyperliquidWithdrawResult, type NonceSource, __hyperliquidInternals, approveHyperliquidBuilderFee, batchModifyHyperliquidOrders, cancelAllHyperliquidOrders, cancelHyperliquidOrders, cancelHyperliquidOrdersByCloid, cancelHyperliquidTwapOrder, computeHyperliquidMarketIocLimitPrice, createHyperliquidSubAccount, createMonotonicNonceFactory, depositToHyperliquidBridge, fetchHyperliquidAssetCtxs, fetchHyperliquidClearinghouseState, fetchHyperliquidFrontendOpenOrders, fetchHyperliquidHistoricalOrders, fetchHyperliquidMeta, fetchHyperliquidMetaAndAssetCtxs, fetchHyperliquidOpenOrders, fetchHyperliquidOrderStatus, fetchHyperliquidPreTransferCheck, fetchHyperliquidSpotAssetCtxs, fetchHyperliquidSpotClearinghouseState, fetchHyperliquidSpotMeta, fetchHyperliquidSpotMetaAndAssetCtxs, fetchHyperliquidUserFills, fetchHyperliquidUserFillsByTime, fetchHyperliquidUserRateLimit, getHyperliquidMaxBuilderFee, modifyHyperliquidOrder, placeHyperliquidOrder, placeHyperliquidTwapOrder, recordHyperliquidBuilderApproval, recordHyperliquidTermsAcceptance, reserveHyperliquidRequestWeight, resolveHyperliquidAbstractionFromMode, scheduleHyperliquidCancel, sendHyperliquidSpot, setHyperliquidAccountAbstractionMode, setHyperliquidDexAbstraction, setHyperliquidPortfolioMargin, transferHyperliquidSubAccount, updateHyperliquidIsolatedMargin, updateHyperliquidLeverage, withdrawFromHyperliquid };
+export { DEFAULT_HYPERLIQUID_MARKET_SLIPPAGE_BPS, type HyperliquidAbstraction, type HyperliquidAccountMode, HyperliquidApiError, type HyperliquidApproveBuilderFeeOptions, type HyperliquidApproveBuilderFeeResponse, HyperliquidBuilderApprovalError, type HyperliquidBuilderApprovalRecordInput, type HyperliquidBuilderFee, type HyperliquidClearinghouseState, type HyperliquidDepositResult, type HyperliquidEnvironment, HyperliquidExchangeClient, type HyperliquidExchangeResponse, type HyperliquidGrouping, HyperliquidGuardError, HyperliquidInfoClient, type HyperliquidMarketIdentityInput, type HyperliquidOrderIntent, type HyperliquidOrderOptions, type HyperliquidOrderResponse, type HyperliquidOrderStatus, HyperliquidTermsError, type HyperliquidTermsRecordInput, type HyperliquidTimeInForce, type HyperliquidTriggerOptions, type HyperliquidTriggerType, type HyperliquidWithdrawResult, type MarketIdentity, type NonceSource, __hyperliquidInternals, approveHyperliquidBuilderFee, batchModifyHyperliquidOrders, buildHyperliquidMarketIdentity, cancelAllHyperliquidOrders, cancelHyperliquidOrders, cancelHyperliquidOrdersByCloid, cancelHyperliquidTwapOrder, computeHyperliquidMarketIocLimitPrice, createHyperliquidSubAccount, createMonotonicNonceFactory, depositToHyperliquidBridge, fetchHyperliquidAssetCtxs, fetchHyperliquidClearinghouseState, fetchHyperliquidFrontendOpenOrders, fetchHyperliquidHistoricalOrders, fetchHyperliquidMeta, fetchHyperliquidMetaAndAssetCtxs, fetchHyperliquidOpenOrders, fetchHyperliquidOrderStatus, fetchHyperliquidPreTransferCheck, fetchHyperliquidSpotAssetCtxs, fetchHyperliquidSpotClearinghouseState, fetchHyperliquidSpotMeta, fetchHyperliquidSpotMetaAndAssetCtxs, fetchHyperliquidUserFills, fetchHyperliquidUserFillsByTime, fetchHyperliquidUserRateLimit, getHyperliquidMaxBuilderFee, modifyHyperliquidOrder, placeHyperliquidOrder, placeHyperliquidTwapOrder, recordHyperliquidBuilderApproval, recordHyperliquidTermsAcceptance, reserveHyperliquidRequestWeight, resolveHyperliquidAbstractionFromMode, scheduleHyperliquidCancel, sendHyperliquidSpot, setHyperliquidAccountAbstractionMode, setHyperliquidDexAbstraction, setHyperliquidPortfolioMargin, transferHyperliquidSubAccount, updateHyperliquidIsolatedMargin, updateHyperliquidLeverage, withdrawFromHyperliquid };

package/dist/adapters/hyperliquid/index.js

@@ -14,6 +14,14 @@ var StoreError = class extends Error {
     this.name = "StoreError";
   }
 };
+var requiresMarketIdentity = (input) => {
+  const action = (input.action ?? "").toLowerCase();
+  if (action === "order" || action === "swap" || action === "trade") return true;
+  return false;
+};
+var hasMarketIdentity = (value) => {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+};
 function resolveConfig(options) {
   const baseUrl = options?.baseUrl ?? process.env.BASE_URL ?? "https://api.openpond.ai";
   const apiKey = options?.apiKey ?? process.env.OPENPOND_API_KEY;
@@ -33,6 +41,9 @@ function resolveConfig(options) {
   return { baseUrl: normalizedBaseUrl, apiKey, fetchFn };
 }
 async function store(input, options) {
+  if (requiresMarketIdentity(input) && !hasMarketIdentity(input.market)) {
+    throw new StoreError("market is required for trade events");
+  }
   const { baseUrl, apiKey, fetchFn } = resolveConfig(options);
   const url = `${baseUrl}/apps/positions/tx`;
   let response;
@@ -109,7 +120,83 @@ var BUILDER_CODE = {
   fee: 100
 };
 var metaCache = /* @__PURE__ */ new Map();
+var spotMetaCache = /* @__PURE__ */ new Map();
 var perpDexsCache = /* @__PURE__ */ new Map();
+var UNKNOWN_SYMBOL = "UNKNOWN";
+var extractDexPrefix = (value) => {
+  if (!value) return null;
+  const trimmed = value.trim();
+  if (!trimmed) return null;
+  if (!trimmed.includes(":")) return null;
+  if (trimmed.startsWith("@")) return null;
+  const [prefix] = trimmed.split(":");
+  const dex = prefix?.trim().toLowerCase() ?? "";
+  return dex || null;
+};
+var normalizeHyperliquidBase = (value) => {
+  if (!value) return null;
+  const trimmed = value.trim();
+  if (!trimmed) return null;
+  const withoutDex = trimmed.includes(":") ? trimmed.split(":").slice(1).join(":") : trimmed;
+  const base = withoutDex.split("-")[0] ?? withoutDex;
+  const normalized = (base.split("/")[0] ?? base).trim().toUpperCase();
+  if (!normalized || normalized === UNKNOWN_SYMBOL) return null;
+  return normalized;
+};
+var normalizeSpotTokenName = (value) => {
+  const raw = (value ?? "").trim().toUpperCase();
+  if (!raw) return "";
+  if (raw.endsWith("0") && raw.length > 1) {
+    return raw.slice(0, -1);
+  }
+  return raw;
+};
+var parseHyperliquidPair = (value) => {
+  if (!value) return null;
+  const trimmed = value.trim();
+  if (!trimmed) return null;
+  const withoutDex = trimmed.includes(":") ? trimmed.split(":").slice(1).join(":") : trimmed;
+  const separator = withoutDex.includes("/") ? "/" : withoutDex.includes("-") ? "-" : null;
+  if (!separator) return null;
+  const [baseRaw, ...rest] = withoutDex.split(separator);
+  const quoteRaw = rest.join(separator);
+  if (!baseRaw || !quoteRaw) return null;
+  const base = baseRaw.trim().toUpperCase();
+  const quote = quoteRaw.trim().toUpperCase();
+  if (!base || !quote) return null;
+  return { base, quote };
+};
+function buildHyperliquidMarketIdentity(input) {
+  const rawSymbol = input.rawSymbol ?? input.symbol;
+  const dex = extractDexPrefix(rawSymbol);
+  const pair = parseHyperliquidPair(rawSymbol) ?? parseHyperliquidPair(input.symbol);
+  const isSpot = input.isSpot ?? (Boolean(pair) || rawSymbol.startsWith("@") || input.symbol.includes("/"));
+  const base = (input.base ? input.base.trim().toUpperCase() : null) ?? pair?.base ?? normalizeHyperliquidBase(input.symbol) ?? normalizeHyperliquidBase(rawSymbol);
+  if (!base) return null;
+  if (isSpot) {
+    const quote = (input.quote ? input.quote.trim().toUpperCase() : null) ?? pair?.quote ?? null;
+    if (!quote) return null;
+    return {
+      market_type: "spot",
+      venue: "hyperliquid",
+      environment: input.environment,
+      base,
+      quote,
+      dex,
+      raw_symbol: rawSymbol ?? null,
+      canonical_symbol: `spot:hyperliquid:${base}-${quote}`
+    };
+  }
+  return {
+    market_type: "perp",
+    venue: "hyperliquid",
+    environment: input.environment,
+    base,
+    dex,
+    raw_symbol: rawSymbol ?? null,
+    canonical_symbol: `perp:hyperliquid:${base}`
+  };
+}
 function resolveHyperliquidAbstractionFromMode(mode) {
   switch (mode) {
     case "standard":
@@ -210,6 +297,29 @@ async function getUniverse(args) {
   metaCache.set(cacheKey, { fetchedAt: Date.now(), universe: json.universe });
   return json.universe;
 }
+async function getSpotMeta(args) {
+  const cacheKey = `${args.environment}:${args.baseUrl}`;
+  const cached = spotMetaCache.get(cacheKey);
+  if (cached && Date.now() - cached.fetchedAt < CACHE_TTL_MS) {
+    return { universe: cached.universe, tokens: cached.tokens };
+  }
+  const response = await args.fetcher(`${args.baseUrl}/info`, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({ type: "spotMeta" })
+  });
+  const json = await response.json().catch(() => null);
+  if (!response.ok || !json?.universe) {
+    throw new HyperliquidApiError(
+      "Unable to load Hyperliquid spot metadata.",
+      json ?? { status: response.status }
+    );
+  }
+  const universe = json.universe ?? [];
+  const tokens = json.tokens ?? [];
+  spotMetaCache.set(cacheKey, { fetchedAt: Date.now(), universe, tokens });
+  return { universe, tokens };
+}
 function resolveAssetIndex(symbol, universe) {
   const [raw] = symbol.split("-");
   const target = raw.trim();
@@ -253,11 +363,57 @@ async function resolveDexIndex(args) {
   }
   return index;
 }
+function buildSpotTokenIndexMap(tokens) {
+  const map = /* @__PURE__ */ new Map();
+  for (const token of tokens) {
+    const name = normalizeSpotTokenName(token?.name);
+    const index = typeof token?.index === "number" && Number.isFinite(token.index) ? token.index : null;
+    if (!name || index == null) continue;
+    if (!map.has(name) || token?.isCanonical) {
+      map.set(name, index);
+    }
+  }
+  return map;
+}
+function resolveSpotTokenIndex(tokenMap, value) {
+  const normalized = normalizeSpotTokenName(value);
+  if (!normalized) return null;
+  const direct = tokenMap.get(normalized);
+  if (direct != null) return direct;
+  if (!normalized.startsWith("U")) {
+    const prefixed = tokenMap.get(`U${normalized}`);
+    if (prefixed != null) return prefixed;
+  }
+  return null;
+}
+function resolveSpotMarketIndex(args) {
+  for (let i = 0; i < args.universe.length; i += 1) {
+    const entry = args.universe[i];
+    const tokens = Array.isArray(entry?.tokens) ? entry.tokens : null;
+    const baseToken = tokens?.[0] ?? entry?.baseToken ?? null;
+    const quoteToken = tokens?.[1] ?? entry?.quoteToken ?? null;
+    if (baseToken === args.baseToken && quoteToken === args.quoteToken) {
+      if (typeof entry?.index === "number" && Number.isFinite(entry.index)) {
+        return entry.index;
+      }
+      return i;
+    }
+  }
+  return null;
+}
 async function resolveHyperliquidAssetIndex(args) {
   const trimmed = args.symbol.trim();
   if (!trimmed) {
     throw new Error("Hyperliquid symbol must be a non-empty string.");
   }
+  if (trimmed.startsWith("@")) {
+    const rawIndex = trimmed.slice(1).trim();
+    const index = Number(rawIndex);
+    if (!Number.isFinite(index)) {
+      throw new Error(`Hyperliquid spot market index is invalid: ${trimmed}`);
+    }
+    return 1e4 + index;
+  }
   const separator = trimmed.indexOf(":");
   if (separator > 0) {
     const dex = trimmed.slice(0, separator).trim();
@@ -284,6 +440,29 @@ async function resolveHyperliquidAssetIndex(args) {
     }
     return 1e5 + dexIndex * 1e4 + assetIndex;
   }
+  const pair = parseHyperliquidPair(trimmed);
+  if (pair) {
+    const { universe: universe2, tokens } = await getSpotMeta({
+      baseUrl: args.baseUrl,
+      environment: args.environment,
+      fetcher: args.fetcher
+    });
+    const tokenMap = buildSpotTokenIndexMap(tokens);
+    const baseToken = resolveSpotTokenIndex(tokenMap, pair.base);
+    const quoteToken = resolveSpotTokenIndex(tokenMap, pair.quote);
+    if (baseToken == null || quoteToken == null) {
+      throw new Error(`Unknown Hyperliquid spot symbol: ${trimmed}`);
+    }
+    const marketIndex = resolveSpotMarketIndex({
+      universe: universe2,
+      baseToken,
+      quoteToken
+    });
+    if (marketIndex == null) {
+      throw new Error(`Unknown Hyperliquid spot symbol: ${trimmed}`);
+    }
+    return 1e4 + marketIndex;
+  }
   const universe = await getUniverse({
     baseUrl: args.baseUrl,
     environment: args.environment,
@@ -1788,6 +1967,6 @@ var __hyperliquidInternals = {
   splitSignature
 };
 
-export { DEFAULT_HYPERLIQUID_MARKET_SLIPPAGE_BPS, HyperliquidApiError, HyperliquidBuilderApprovalError, HyperliquidExchangeClient, HyperliquidGuardError, HyperliquidInfoClient, HyperliquidTermsError, __hyperliquidInternals, approveHyperliquidBuilderFee, batchModifyHyperliquidOrders, cancelAllHyperliquidOrders, cancelHyperliquidOrders, cancelHyperliquidOrdersByCloid, cancelHyperliquidTwapOrder, computeHyperliquidMarketIocLimitPrice, createHyperliquidSubAccount, createMonotonicNonceFactory, depositToHyperliquidBridge, fetchHyperliquidAssetCtxs, fetchHyperliquidClearinghouseState, fetchHyperliquidFrontendOpenOrders, fetchHyperliquidHistoricalOrders, fetchHyperliquidMeta, fetchHyperliquidMetaAndAssetCtxs, fetchHyperliquidOpenOrders, fetchHyperliquidOrderStatus, fetchHyperliquidPreTransferCheck, fetchHyperliquidSpotAssetCtxs, fetchHyperliquidSpotClearinghouseState, fetchHyperliquidSpotMeta, fetchHyperliquidSpotMetaAndAssetCtxs, fetchHyperliquidUserFills, fetchHyperliquidUserFillsByTime, fetchHyperliquidUserRateLimit, getHyperliquidMaxBuilderFee, modifyHyperliquidOrder, placeHyperliquidOrder, placeHyperliquidTwapOrder, recordHyperliquidBuilderApproval, recordHyperliquidTermsAcceptance, reserveHyperliquidRequestWeight, resolveHyperliquidAbstractionFromMode, scheduleHyperliquidCancel, sendHyperliquidSpot, setHyperliquidAccountAbstractionMode, setHyperliquidDexAbstraction, setHyperliquidPortfolioMargin, transferHyperliquidSubAccount, updateHyperliquidIsolatedMargin, updateHyperliquidLeverage, withdrawFromHyperliquid };
+export { DEFAULT_HYPERLIQUID_MARKET_SLIPPAGE_BPS, HyperliquidApiError, HyperliquidBuilderApprovalError, HyperliquidExchangeClient, HyperliquidGuardError, HyperliquidInfoClient, HyperliquidTermsError, __hyperliquidInternals, approveHyperliquidBuilderFee, batchModifyHyperliquidOrders, buildHyperliquidMarketIdentity, cancelAllHyperliquidOrders, cancelHyperliquidOrders, cancelHyperliquidOrdersByCloid, cancelHyperliquidTwapOrder, computeHyperliquidMarketIocLimitPrice, createHyperliquidSubAccount, createMonotonicNonceFactory, depositToHyperliquidBridge, fetchHyperliquidAssetCtxs, fetchHyperliquidClearinghouseState, fetchHyperliquidFrontendOpenOrders, fetchHyperliquidHistoricalOrders, fetchHyperliquidMeta, fetchHyperliquidMetaAndAssetCtxs, fetchHyperliquidOpenOrders, fetchHyperliquidOrderStatus, fetchHyperliquidPreTransferCheck, fetchHyperliquidSpotAssetCtxs, fetchHyperliquidSpotClearinghouseState, fetchHyperliquidSpotMeta, fetchHyperliquidSpotMetaAndAssetCtxs, fetchHyperliquidUserFills, fetchHyperliquidUserFillsByTime, fetchHyperliquidUserRateLimit, getHyperliquidMaxBuilderFee, modifyHyperliquidOrder, placeHyperliquidOrder, placeHyperliquidTwapOrder, recordHyperliquidBuilderApproval, recordHyperliquidTermsAcceptance, reserveHyperliquidRequestWeight, resolveHyperliquidAbstractionFromMode, scheduleHyperliquidCancel, sendHyperliquidSpot, setHyperliquidAccountAbstractionMode, setHyperliquidDexAbstraction, setHyperliquidPortfolioMargin, transferHyperliquidSubAccount, updateHyperliquidIsolatedMargin, updateHyperliquidLeverage, withdrawFromHyperliquid };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map