opentool 0.8.29 → 0.10.0

package/README.md

@@ -179,8 +179,7 @@ Test the payment flow:
 # Start dev server
 WALLET_ADDRESS=0x... npx opentool dev --input tools
 
-# Test with the x402 client
-PRIVATE_KEY=0x... bun examples/full-metadata/test-x402.ts
+# Test with your x402 client/facilitator implementation
 ```
 
 Or test manually:
@@ -213,21 +212,20 @@ Tools without this export stay HTTP-only, which is useful when you want selectiv
 
 ### Testing with MCP Inspector
 
-The `examples/full-metadata` project has an `inspector.json` config ready to go:
+You can run MCP Inspector against your local tool set:
 
 ```bash
-cd examples/full-metadata
-npx mcp-inspector --config inspector.json --server opentool-dev
+npx mcp-inspector --server "npx opentool dev --input tools"
 ```
 
-Copy `.env.example` to `.env` and add your credentials if you're using wallet/payment features. The inspector starts `opentool dev` automatically, so you only need one terminal. Only tools with `mcp = { enabled: true }` show up in the inspector - HTTP-only tools keep running on localhost.
+Only tools with `mcp = { enabled: true }` show up in the inspector - HTTP-only tools keep running on localhost.
 
 ### Quick x402 test with curl
 
-1. Start the dev server against the example tools:
+1. Start the dev server:
 
    ```bash
-   npx opentool dev --input examples/full-metadata/tools
+   npx opentool dev --input tools
    ```
 
 2. Trigger the paywall and inspect the returned payment requirements:
@@ -392,32 +390,14 @@ Push your repo to GitHub and connect it to [OpenPond](https://openpond.ai):
 3. Deploys to AWS Lambda with Function URLs
 4. Done - your tools are live
 
-## Examples
+## Example Usage
 
-Check `examples/full-metadata/` for a complete example with payment and discovery features.
-
-### Testing Examples Locally
+Build your own tool folder (for example `tools/`) and run:
 
 ```bash
-# Build and link the OpenTool package
-npm run build
-npm link
-
-# Test the example
-cd examples/full-metadata
-npm link opentool
-npm run build
-
-# Check the output
-cat dist/metadata.json
-
-# Test the MCP server
-echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | node dist/mcp-server.js
-
-# Or from repo root:
-npm run examples:build      # Build example (CJS+ESM)
-npm run examples:validate   # Validate metadata and tools
-npm run examples:metadata   # Regenerate metadata.json
+npx opentool validate --input tools
+npx opentool metadata --input tools --output metadata.json
+npx opentool build --input tools --output dist
 ```
 
 ## Metadata System

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

@@ -481,6 +481,16 @@ type SpotMetaResponse = {
     universe?: SpotUniverseItem[];
     tokens?: SpotToken[];
 };
+type HyperliquidBarResolution = "1" | "5" | "15" | "30" | "60" | "240" | "1D" | "1W";
+type HyperliquidBar = {
+    time: number;
+    open?: number;
+    high?: number;
+    low?: number;
+    close: number;
+    volume?: number;
+    [key: string]: unknown;
+};
 type HyperliquidPerpMarketInfo = {
     symbol: string;
     price: number;
@@ -500,6 +510,14 @@ declare function maxDecimals(values: string[]): number;
 declare function toScaledInt(value: string, decimals: number): bigint;
 declare function formatScaledInt(value: bigint, decimals: number): string;
 declare function fetchHyperliquidAllMids(environment: HyperliquidEnvironment): Promise<Record<string, string | number>>;
+declare function fetchHyperliquidBars(params: {
+    symbol: string;
+    resolution: HyperliquidBarResolution;
+    countBack: number;
+    fromSeconds?: number;
+    toSeconds?: number;
+    gatewayBase?: string | null;
+}): Promise<HyperliquidBar[]>;
 declare function fetchHyperliquidTickSize(params: {
     environment: HyperliquidEnvironment;
     symbol: string;
@@ -650,4 +668,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 HyperliquidChain, type HyperliquidClearinghouseState, type HyperliquidDepositResult, type HyperliquidEnvironment, HyperliquidExchangeClient, type HyperliquidExchangeResponse, type HyperliquidGrouping, HyperliquidGuardError, HyperliquidInfoClient, type HyperliquidMarketIdentityInput, type HyperliquidMarketType, type HyperliquidOrderIntent, type HyperliquidOrderOptions, type HyperliquidOrderResponse, type HyperliquidOrderStatus, type HyperliquidPerpMarketInfo, type HyperliquidProfileAsset, type HyperliquidProfileAssetInput, type HyperliquidProfileChain, type HyperliquidSpotMarketInfo, type HyperliquidStoreNetwork, HyperliquidTermsError, type HyperliquidTermsRecordInput, type HyperliquidTickSize, type HyperliquidTimeInForce, type HyperliquidTriggerOptions, type HyperliquidTriggerType, type HyperliquidWithdrawResult, type MarketIdentity, type NonceSource, __hyperliquidInternals, __hyperliquidMarketDataInternals, approveHyperliquidBuilderFee, batchModifyHyperliquidOrders, buildHyperliquidMarketIdentity, buildHyperliquidProfileAssets, buildHyperliquidSpotUsdPriceMap, cancelAllHyperliquidOrders, cancelHyperliquidOrders, cancelHyperliquidOrdersByCloid, cancelHyperliquidTwapOrder, computeHyperliquidMarketIocLimitPrice, createHyperliquidSubAccount, createMonotonicNonceFactory, depositToHyperliquidBridge, extractHyperliquidDex, extractHyperliquidOrderIds, fetchHyperliquidAllMids, fetchHyperliquidAssetCtxs, fetchHyperliquidClearinghouseState, fetchHyperliquidFrontendOpenOrders, fetchHyperliquidHistoricalOrders, fetchHyperliquidMeta, fetchHyperliquidMetaAndAssetCtxs, fetchHyperliquidOpenOrders, fetchHyperliquidOrderStatus, fetchHyperliquidPerpMarketInfo, fetchHyperliquidPreTransferCheck, fetchHyperliquidSizeDecimals, fetchHyperliquidSpotAccountValue, fetchHyperliquidSpotAssetCtxs, fetchHyperliquidSpotClearinghouseState, fetchHyperliquidSpotMarketInfo, fetchHyperliquidSpotMeta, fetchHyperliquidSpotMetaAndAssetCtxs, fetchHyperliquidSpotTickSize, fetchHyperliquidSpotUsdPriceMap, fetchHyperliquidTickSize, fetchHyperliquidUserFills, fetchHyperliquidUserFillsByTime, fetchHyperliquidUserRateLimit, formatHyperliquidMarketablePrice, formatHyperliquidOrderSize, formatHyperliquidPrice, formatHyperliquidSize, getHyperliquidMaxBuilderFee, isHyperliquidSpotSymbol, modifyHyperliquidOrder, normalizeHyperliquidBaseSymbol, normalizeHyperliquidMetaSymbol, normalizeSpotTokenName, parseSpotPairSymbol, placeHyperliquidOrder, placeHyperliquidTwapOrder, readHyperliquidAccountValue, readHyperliquidNumber, readHyperliquidPerpPosition, readHyperliquidPerpPositionSize, readHyperliquidSpotAccountValue, readHyperliquidSpotBalance, readHyperliquidSpotBalanceSize, recordHyperliquidBuilderApproval, recordHyperliquidTermsAcceptance, reserveHyperliquidRequestWeight, resolveHyperliquidAbstractionFromMode, resolveHyperliquidChain, resolveHyperliquidChainConfig, resolveHyperliquidErrorDetail, resolveHyperliquidOrderRef, resolveHyperliquidOrderSymbol, resolveHyperliquidPair, resolveHyperliquidProfileChain, resolveHyperliquidRpcEnvVar, resolveHyperliquidStoreNetwork, resolveHyperliquidSymbol, resolveSpotMidCandidates, resolveSpotTokenCandidates, roundHyperliquidPriceToTick, scheduleHyperliquidCancel, sendHyperliquidSpot, setHyperliquidAccountAbstractionMode, setHyperliquidDexAbstraction, setHyperliquidPortfolioMargin, transferHyperliquidSubAccount, updateHyperliquidIsolatedMargin, updateHyperliquidLeverage, withdrawFromHyperliquid };
+export { DEFAULT_HYPERLIQUID_MARKET_SLIPPAGE_BPS, type HyperliquidAbstraction, type HyperliquidAccountMode, HyperliquidApiError, type HyperliquidApproveBuilderFeeOptions, type HyperliquidApproveBuilderFeeResponse, type HyperliquidBar, type HyperliquidBarResolution, HyperliquidBuilderApprovalError, type HyperliquidBuilderApprovalRecordInput, type HyperliquidBuilderFee, type HyperliquidChain, type HyperliquidClearinghouseState, type HyperliquidDepositResult, type HyperliquidEnvironment, HyperliquidExchangeClient, type HyperliquidExchangeResponse, type HyperliquidGrouping, HyperliquidGuardError, HyperliquidInfoClient, type HyperliquidMarketIdentityInput, type HyperliquidMarketType, type HyperliquidOrderIntent, type HyperliquidOrderOptions, type HyperliquidOrderResponse, type HyperliquidOrderStatus, type HyperliquidPerpMarketInfo, type HyperliquidProfileAsset, type HyperliquidProfileAssetInput, type HyperliquidProfileChain, type HyperliquidSpotMarketInfo, type HyperliquidStoreNetwork, HyperliquidTermsError, type HyperliquidTermsRecordInput, type HyperliquidTickSize, type HyperliquidTimeInForce, type HyperliquidTriggerOptions, type HyperliquidTriggerType, type HyperliquidWithdrawResult, type MarketIdentity, type NonceSource, __hyperliquidInternals, __hyperliquidMarketDataInternals, approveHyperliquidBuilderFee, batchModifyHyperliquidOrders, buildHyperliquidMarketIdentity, buildHyperliquidProfileAssets, buildHyperliquidSpotUsdPriceMap, cancelAllHyperliquidOrders, cancelHyperliquidOrders, cancelHyperliquidOrdersByCloid, cancelHyperliquidTwapOrder, computeHyperliquidMarketIocLimitPrice, createHyperliquidSubAccount, createMonotonicNonceFactory, depositToHyperliquidBridge, extractHyperliquidDex, extractHyperliquidOrderIds, fetchHyperliquidAllMids, fetchHyperliquidAssetCtxs, fetchHyperliquidBars, fetchHyperliquidClearinghouseState, fetchHyperliquidFrontendOpenOrders, fetchHyperliquidHistoricalOrders, fetchHyperliquidMeta, fetchHyperliquidMetaAndAssetCtxs, fetchHyperliquidOpenOrders, fetchHyperliquidOrderStatus, fetchHyperliquidPerpMarketInfo, fetchHyperliquidPreTransferCheck, fetchHyperliquidSizeDecimals, fetchHyperliquidSpotAccountValue, fetchHyperliquidSpotAssetCtxs, fetchHyperliquidSpotClearinghouseState, fetchHyperliquidSpotMarketInfo, fetchHyperliquidSpotMeta, fetchHyperliquidSpotMetaAndAssetCtxs, fetchHyperliquidSpotTickSize, fetchHyperliquidSpotUsdPriceMap, fetchHyperliquidTickSize, fetchHyperliquidUserFills, fetchHyperliquidUserFillsByTime, fetchHyperliquidUserRateLimit, formatHyperliquidMarketablePrice, formatHyperliquidOrderSize, formatHyperliquidPrice, formatHyperliquidSize, getHyperliquidMaxBuilderFee, isHyperliquidSpotSymbol, modifyHyperliquidOrder, normalizeHyperliquidBaseSymbol, normalizeHyperliquidMetaSymbol, normalizeSpotTokenName, parseSpotPairSymbol, placeHyperliquidOrder, placeHyperliquidTwapOrder, readHyperliquidAccountValue, readHyperliquidNumber, readHyperliquidPerpPosition, readHyperliquidPerpPositionSize, readHyperliquidSpotAccountValue, readHyperliquidSpotBalance, readHyperliquidSpotBalanceSize, recordHyperliquidBuilderApproval, recordHyperliquidTermsAcceptance, reserveHyperliquidRequestWeight, resolveHyperliquidAbstractionFromMode, resolveHyperliquidChain, resolveHyperliquidChainConfig, resolveHyperliquidErrorDetail, resolveHyperliquidOrderRef, resolveHyperliquidOrderSymbol, resolveHyperliquidPair, resolveHyperliquidProfileChain, resolveHyperliquidRpcEnvVar, resolveHyperliquidStoreNetwork, resolveHyperliquidSymbol, resolveSpotMidCandidates, resolveSpotTokenCandidates, roundHyperliquidPriceToTick, scheduleHyperliquidCancel, sendHyperliquidSpot, setHyperliquidAccountAbstractionMode, setHyperliquidDexAbstraction, setHyperliquidPortfolioMargin, transferHyperliquidSubAccount, updateHyperliquidIsolatedMargin, updateHyperliquidLeverage, withdrawFromHyperliquid };

package/dist/adapters/hyperliquid/index.js

@@ -6,11 +6,7 @@ import { hexToBytes, concatBytes, bytesToHex } from '@noble/hashes/utils';
 // src/adapters/hyperliquid/index.ts
 
 // src/store/index.ts
-var STORE_EVENT_LEVELS = [
-  "decision",
-  "execution",
-  "lifecycle"
-];
+var STORE_EVENT_LEVELS = ["decision", "execution", "lifecycle"];
 var STORE_EVENT_LEVEL_SET = new Set(STORE_EVENT_LEVELS);
 var MARKET_REQUIRED_ACTIONS = [
   "swap",
@@ -77,7 +73,7 @@ var resolveEventLevel = (input) => {
   return null;
 };
 var normalizeStoreInput = (input) => {
-  const metadata = { ...input.metadata ?? {} };
+  const metadata = { ...input.metadata };
   const eventLevel = resolveEventLevel({ ...input, metadata });
   if (eventLevel) {
     metadata.eventLevel = eventLevel;
@@ -96,9 +92,7 @@ function resolveConfig(options) {
     throw new StoreError("BASE_URL is required to store activity events");
   }
   if (!apiKey) {
-    throw new StoreError(
-      "OPENPOND_API_KEY is required to store activity events"
-    );
+    throw new StoreError("OPENPOND_API_KEY is required to store activity events");
   }
   const normalizedBaseUrl = baseUrl.replace(/\/$/, "");
   const fetchFn = options?.fetchFn ?? globalThis.fetch;
@@ -113,15 +107,11 @@ async function store(input, options) {
   const eventLevel = normalizedInput.eventLevel;
   const normalizedAction = normalizeAction(normalizedInput.action);
   if (mode === "backtest" && !normalizedInput.backtestRunId) {
-    throw new StoreError(
-      `backtestRunId is required when mode is "backtest"`
-    );
+    throw new StoreError(`backtestRunId is required when mode is "backtest"`);
   }
   if (eventLevel === "execution" || eventLevel === "lifecycle") {
     if (!normalizedAction || !EXECUTION_ACTIONS_SET.has(normalizedAction)) {
-      throw new StoreError(
-        `eventLevel "${eventLevel}" requires an execution action`
-      );
+      throw new StoreError(`eventLevel "${eventLevel}" requires an execution action`);
     }
   }
   if (eventLevel === "execution" && !hasMarketIdentity(normalizedInput.market)) {
@@ -375,9 +365,7 @@ async function getUniverse(args) {
   const response = await args.fetcher(`${args.baseUrl}/info`, {
     method: "POST",
     headers: { "content-type": "application/json" },
-    body: JSON.stringify(
-      dexKey ? { type: "meta", dex: dexKey } : { type: "meta" }
-    )
+    body: JSON.stringify(dexKey ? { type: "meta", dex: dexKey } : { type: "meta" })
   });
   const json = await response.json().catch(() => null);
   if (!response.ok || !json?.universe) {
@@ -415,9 +403,7 @@ async function getSpotMeta(args) {
 function resolveAssetIndex(symbol, universe) {
   const [raw] = symbol.split("-");
   const target = raw.trim();
-  const index = universe.findIndex(
-    (entry) => entry.name.toUpperCase() === target.toUpperCase()
-  );
+  const index = universe.findIndex((entry) => entry.name.toUpperCase() === target.toUpperCase());
   if (index === -1) {
     throw new Error(`Unknown Hyperliquid asset symbol: ${symbol}`);
   }
@@ -447,9 +433,7 @@ async function getPerpDexs(args) {
 async function resolveDexIndex(args) {
   const dexs = await getPerpDexs(args);
   const target = args.dex.trim().toLowerCase();
-  const index = dexs.findIndex(
-    (entry) => entry?.name?.toLowerCase() === target
-  );
+  const index = dexs.findIndex((entry) => entry?.name?.toLowerCase() === target);
   if (index === -1) {
     throw new Error(`Unknown Hyperliquid perp dex: ${args.dex}`);
   }
@@ -636,15 +620,7 @@ async function signL1Action(args) {
   return splitSignature(signatureHex);
 }
 async function signSpotSend(args) {
-  const {
-    wallet,
-    hyperliquidChain,
-    signatureChainId,
-    destination,
-    token,
-    amount,
-    time
-  } = args;
+  const { wallet, hyperliquidChain, signatureChainId, destination, token, amount, time } = args;
   const domain = {
     name: "HyperliquidSignTransaction",
     version: "1",
@@ -1053,9 +1029,7 @@ var HyperliquidExchangeClient = class {
     this.expiresAfter = args.expiresAfter;
     const resolvedNonceSource = args.walletNonceProvider ?? args.wallet.nonceSource ?? args.nonceSource;
     if (!resolvedNonceSource) {
-      throw new Error(
-        "Wallet nonce source is required for Hyperliquid exchange actions."
-      );
+      throw new Error("Wallet nonce source is required for Hyperliquid exchange actions.");
     }
     this.nonceSource = resolvedNonceSource;
   }
@@ -1185,9 +1159,7 @@ var HyperliquidExchangeClient = class {
       expiresAfter: this.expiresAfter,
       nonceSource: this.nonceSource
     };
-    return setHyperliquidDexAbstraction(
-      params.user ? { ...base, user: params.user } : base
-    );
+    return setHyperliquidDexAbstraction(params.user ? { ...base, user: params.user } : base);
   }
   setAccountAbstractionMode(params) {
     const base = {
@@ -1211,24 +1183,18 @@ var HyperliquidExchangeClient = class {
       expiresAfter: this.expiresAfter,
       nonceSource: this.nonceSource
     };
-    return setHyperliquidPortfolioMargin(
-      params.user ? { ...base, user: params.user } : base
-    );
+    return setHyperliquidPortfolioMargin(params.user ? { ...base, user: params.user } : base);
   }
 };
 async function setHyperliquidPortfolioMargin(options) {
   const env = options.environment ?? "mainnet";
   if (!options.wallet?.account || !options.wallet.walletClient) {
-    throw new Error(
-      "Wallet with signing capability is required for portfolio margin."
-    );
+    throw new Error("Wallet with signing capability is required for portfolio margin.");
   }
   const nonce = options.nonce ?? options.walletNonceProvider?.() ?? options.wallet.nonceSource?.() ?? options.nonceSource?.() ?? Date.now();
   const signatureChainId = getSignatureChainId(env);
   const hyperliquidChain = HL_CHAIN_LABEL[env];
-  const user = normalizeAddress(
-    options.user ?? options.wallet.address
-  );
+  const user = normalizeAddress(options.user ?? options.wallet.address);
   const action = {
     type: "userPortfolioMargin",
     enabled: Boolean(options.enabled),
@@ -1257,16 +1223,12 @@ async function setHyperliquidPortfolioMargin(options) {
 async function setHyperliquidDexAbstraction(options) {
   const env = options.environment ?? "mainnet";
   if (!options.wallet?.account || !options.wallet.walletClient) {
-    throw new Error(
-      "Wallet with signing capability is required for dex abstraction."
-    );
+    throw new Error("Wallet with signing capability is required for dex abstraction.");
   }
   const nonce = options.nonce ?? options.walletNonceProvider?.() ?? options.wallet.nonceSource?.() ?? options.nonceSource?.() ?? Date.now();
   const signatureChainId = getSignatureChainId(env);
   const hyperliquidChain = HL_CHAIN_LABEL[env];
-  const user = normalizeAddress(
-    options.user ?? options.wallet.address
-  );
+  const user = normalizeAddress(options.user ?? options.wallet.address);
   const action = {
     type: "userDexAbstraction",
     enabled: Boolean(options.enabled),
@@ -1295,16 +1257,12 @@ async function setHyperliquidDexAbstraction(options) {
 async function setHyperliquidAccountAbstractionMode(options) {
   const env = options.environment ?? "mainnet";
   if (!options.wallet?.account || !options.wallet.walletClient) {
-    throw new Error(
-      "Wallet with signing capability is required for account abstraction mode."
-    );
+    throw new Error("Wallet with signing capability is required for account abstraction mode.");
   }
   const nonce = options.nonce ?? options.walletNonceProvider?.() ?? options.wallet.nonceSource?.() ?? options.nonceSource?.() ?? Date.now();
   const signatureChainId = getSignatureChainId(env);
   const hyperliquidChain = HL_CHAIN_LABEL[env];
-  const user = normalizeAddress(
-    options.user ?? options.wallet.address
-  );
+  const user = normalizeAddress(options.user ?? options.wallet.address);
   const abstraction = resolveHyperliquidAbstractionFromMode(options.mode);
   const action = {
     type: "userSetAbstraction",
@@ -1346,14 +1304,10 @@ async function cancelHyperliquidOrdersByCloid(options) {
   options.cancels.forEach((c) => assertSymbol(c.symbol));
   const action = {
     type: "cancelByCloid",
-    cancels: await withAssetIndexes(
-      options,
-      options.cancels,
-      (idx, entry) => ({
-        asset: idx,
-        cloid: normalizeCloid(entry.cloid)
-      })
-    )
+    cancels: await withAssetIndexes(options, options.cancels, (idx, entry) => ({
+      asset: idx,
+      cloid: normalizeCloid(entry.cloid)
+    }))
   };
   return submitExchangeAction(options, action);
 }
@@ -2235,6 +2189,28 @@ function readHyperliquidSpotAccountValue(params) {
 // src/adapters/hyperliquid/market-data.ts
 var META_CACHE_TTL_MS = 5 * 60 * 1e3;
 var allMidsCache = /* @__PURE__ */ new Map();
+function resolveGatewayBase(override) {
+  const value = override ?? process.env.OPENPOND_GATEWAY_URL ?? null;
+  if (typeof value !== "string") {
+    return null;
+  }
+  const trimmed = value.trim();
+  if (!trimmed) {
+    return null;
+  }
+  return trimmed.replace(/\/$/, "");
+}
+function normalizeGatewaySymbol(value) {
+  const trimmed = value.trim();
+  if (!trimmed) return trimmed;
+  const idx = trimmed.indexOf(":");
+  if (idx > 0) {
+    const dex = trimmed.slice(0, idx).toLowerCase();
+    const rest = trimmed.slice(idx + 1);
+    return `${dex}:${rest.toUpperCase()}`;
+  }
+  return trimmed.toUpperCase();
+}
 function gcd(a, b) {
   let left = a < 0n ? -a : a;
   let right = b < 0n ? -b : b;
@@ -2282,10 +2258,7 @@ function formatScaledInt(value, decimals) {
     return `${negative ? "-" : ""}${integer.toString()}`;
   }
   const fractionStr = fraction.toString().padStart(decimals, "0");
-  return `${negative ? "-" : ""}${integer.toString()}.${fractionStr}`.replace(
-    /\.?0+$/,
-    ""
-  );
+  return `${negative ? "-" : ""}${integer.toString()}.${fractionStr}`.replace(/\.?0+$/, "");
 }
 function resolveSpotSizeDecimals(meta, symbol) {
   const universe = meta.universe ?? [];
@@ -2355,6 +2328,37 @@ async function fetchHyperliquidAllMids(environment) {
   allMidsCache.set(cacheKey, { fetchedAt: Date.now(), mids: json });
   return json;
 }
+async function fetchHyperliquidBars(params) {
+  const gatewayBase = resolveGatewayBase(params.gatewayBase);
+  if (!gatewayBase) {
+    throw new Error("OPENPOND_GATEWAY_URL is required.");
+  }
+  const normalizedCountBack = Math.max(1, Math.trunc(params.countBack));
+  if (!Number.isFinite(normalizedCountBack) || normalizedCountBack <= 0) {
+    throw new Error("countBack must be a positive integer.");
+  }
+  const url = new URL(`${gatewayBase}/v1/hyperliquid/bars`);
+  url.searchParams.set("symbol", normalizeGatewaySymbol(params.symbol));
+  url.searchParams.set("resolution", params.resolution);
+  url.searchParams.set("countBack", normalizedCountBack.toString());
+  if (typeof params.fromSeconds === "number" && Number.isFinite(params.fromSeconds)) {
+    url.searchParams.set("from", Math.max(0, Math.trunc(params.fromSeconds)).toString());
+  }
+  if (typeof params.toSeconds === "number" && Number.isFinite(params.toSeconds)) {
+    url.searchParams.set("to", Math.max(0, Math.trunc(params.toSeconds)).toString());
+  }
+  const response = await fetch(url.toString());
+  if (!response.ok) {
+    throw new Error(`Gateway error (${response.status})`);
+  }
+  const data = await response.json().catch(() => null);
+  const bars = Array.isArray(data?.bars) ? data.bars : [];
+  return bars.filter((bar) => {
+    if (!bar || typeof bar !== "object") return false;
+    const record = bar;
+    return typeof record.close === "number" && Number.isFinite(record.close) && typeof record.time === "number" && Number.isFinite(record.time);
+  });
+}
 async function fetchHyperliquidTickSize(params) {
   return fetchHyperliquidTickSizeForCoin(params.environment, params.symbol);
 }
@@ -2362,10 +2366,7 @@ async function fetchHyperliquidSpotTickSize(params) {
   if (!Number.isFinite(params.marketIndex)) {
     throw new Error("Hyperliquid spot market index is invalid.");
   }
-  return fetchHyperliquidTickSizeForCoin(
-    params.environment,
-    `@${params.marketIndex}`
-  );
+  return fetchHyperliquidTickSizeForCoin(params.environment, `@${params.marketIndex}`);
 }
 async function fetchHyperliquidTickSizeForCoin(environment, coin) {
   const base = API_BASES[environment];
@@ -2379,9 +2380,7 @@ async function fetchHyperliquidTickSizeForCoin(environment, coin) {
   }
   const data = await res.json().catch(() => null);
   const levels = Array.isArray(data?.levels) ? data?.levels ?? [] : [];
-  const prices = levels.flatMap(
-    (side) => Array.isArray(side) ? side.map((entry) => String(entry?.px ?? "")) : []
-  ).filter((px) => px.length > 0);
+  const prices = levels.flatMap((side) => Array.isArray(side) ? side.map((entry) => String(entry?.px ?? "")) : []).filter((px) => px.length > 0);
   if (prices.length < 2) {
     throw new Error(`Hyperliquid l2Book missing price levels for ${coin}`);
   }
@@ -2472,9 +2471,7 @@ async function fetchHyperliquidSpotMarketInfo(params) {
         price = readHyperliquidNumber(ctx?.markPx ?? ctx?.midPx ?? ctx?.oraclePx);
       }
       if (!price || price <= 0) {
-        throw new Error(
-          `No spot price available for ${normalizedBase}/${normalizedQuote}`
-        );
+        throw new Error(`No spot price available for ${normalizedBase}/${normalizedQuote}`);
       }
       const marketIndex = typeof market?.index === "number" ? market.index : idx;
       return {
@@ -2624,9 +2621,7 @@ async function placeHyperliquidOrder(options) {
   } = options;
   const effectiveBuilder = BUILDER_CODE;
   if (!wallet?.account || !wallet.walletClient) {
-    throw new Error(
-      "Hyperliquid order signing requires a wallet with signing capabilities."
-    );
+    throw new Error("Hyperliquid order signing requires a wallet with signing capabilities.");
   }
   if (!orders.length) {
     throw new Error("At least one order is required.");
@@ -2740,10 +2735,7 @@ async function placeHyperliquidOrder(options) {
   );
   if (errorStatuses.length) {
     const message = errorStatuses.map((entry) => entry.error).join(", ");
-    throw new HyperliquidApiError(
-      message || "Hyperliquid rejected the order.",
-      json
-    );
+    throw new HyperliquidApiError(message || "Hyperliquid rejected the order.", json);
   }
   return json;
 }
@@ -2763,9 +2755,7 @@ async function depositToHyperliquidBridge(options) {
   const usdcAddress = getUsdcAddress(environment);
   const amountUnits = parseUnits(amount, 6);
   if (!wallet.walletClient || !wallet.publicClient) {
-    throw new Error(
-      "Wallet client and public client are required for deposit."
-    );
+    throw new Error("Wallet client and public client are required for deposit.");
   }
   const walletClient = wallet.walletClient;
   const publicClient = wallet.publicClient;
@@ -2790,15 +2780,10 @@ async function depositToHyperliquidBridge(options) {
 }
 async function withdrawFromHyperliquid(options) {
   const { environment, amount, destination, wallet } = options;
-  const normalizedAmount = normalizePositiveDecimalString(
-    amount,
-    "Withdraw amount"
-  );
+  const normalizedAmount = normalizePositiveDecimalString(amount, "Withdraw amount");
   const parsedAmount = Number.parseFloat(normalizedAmount);
   if (!wallet.account || !wallet.walletClient || !wallet.publicClient) {
-    throw new Error(
-      "Wallet client and public client are required for withdraw."
-    );
+    throw new Error("Wallet client and public client are required for withdraw.");
   }
   const signatureChainId = getSignatureChainId(environment);
   const hyperliquidChain = HL_CHAIN_LABEL[environment];
@@ -2881,9 +2866,7 @@ async function fetchHyperliquidClearinghouseState(params) {
 async function approveHyperliquidBuilderFee(options) {
   const { environment, wallet, nonce, signatureChainId } = options;
   if (!wallet?.account || !wallet.walletClient) {
-    throw new Error(
-      "Hyperliquid builder approval requires a wallet with signing capabilities."
-    );
+    throw new Error("Hyperliquid builder approval requires a wallet with signing capabilities.");
   }
   const maxFeeRateValue = BUILDER_CODE.fee / 1e3;
   const formattedPercent = `${maxFeeRateValue}%`;
@@ -3009,6 +2992,6 @@ var __hyperliquidInternals = {
   splitSignature
 };
 
-export { DEFAULT_HYPERLIQUID_MARKET_SLIPPAGE_BPS, HyperliquidApiError, HyperliquidBuilderApprovalError, HyperliquidExchangeClient, HyperliquidGuardError, HyperliquidInfoClient, HyperliquidTermsError, __hyperliquidInternals, __hyperliquidMarketDataInternals, approveHyperliquidBuilderFee, batchModifyHyperliquidOrders, buildHyperliquidMarketIdentity, buildHyperliquidProfileAssets, buildHyperliquidSpotUsdPriceMap, cancelAllHyperliquidOrders, cancelHyperliquidOrders, cancelHyperliquidOrdersByCloid, cancelHyperliquidTwapOrder, computeHyperliquidMarketIocLimitPrice, createHyperliquidSubAccount, createMonotonicNonceFactory, depositToHyperliquidBridge, extractHyperliquidDex, extractHyperliquidOrderIds, fetchHyperliquidAllMids, fetchHyperliquidAssetCtxs, fetchHyperliquidClearinghouseState, fetchHyperliquidFrontendOpenOrders, fetchHyperliquidHistoricalOrders, fetchHyperliquidMeta, fetchHyperliquidMetaAndAssetCtxs, fetchHyperliquidOpenOrders, fetchHyperliquidOrderStatus, fetchHyperliquidPerpMarketInfo, fetchHyperliquidPreTransferCheck, fetchHyperliquidSizeDecimals, fetchHyperliquidSpotAccountValue, fetchHyperliquidSpotAssetCtxs, fetchHyperliquidSpotClearinghouseState, fetchHyperliquidSpotMarketInfo, fetchHyperliquidSpotMeta, fetchHyperliquidSpotMetaAndAssetCtxs, fetchHyperliquidSpotTickSize, fetchHyperliquidSpotUsdPriceMap, fetchHyperliquidTickSize, fetchHyperliquidUserFills, fetchHyperliquidUserFillsByTime, fetchHyperliquidUserRateLimit, formatHyperliquidMarketablePrice, formatHyperliquidOrderSize, formatHyperliquidPrice, formatHyperliquidSize, getHyperliquidMaxBuilderFee, isHyperliquidSpotSymbol, modifyHyperliquidOrder, normalizeHyperliquidBaseSymbol, normalizeHyperliquidMetaSymbol, normalizeSpotTokenName2 as normalizeSpotTokenName, parseSpotPairSymbol, placeHyperliquidOrder, placeHyperliquidTwapOrder, readHyperliquidAccountValue, readHyperliquidNumber, readHyperliquidPerpPosition, readHyperliquidPerpPositionSize, readHyperliquidSpotAccountValue, readHyperliquidSpotBalance, readHyperliquidSpotBalanceSize, recordHyperliquidBuilderApproval, recordHyperliquidTermsAcceptance, reserveHyperliquidRequestWeight, resolveHyperliquidAbstractionFromMode, resolveHyperliquidChain, resolveHyperliquidChainConfig, resolveHyperliquidErrorDetail, resolveHyperliquidOrderRef, resolveHyperliquidOrderSymbol, resolveHyperliquidPair, resolveHyperliquidProfileChain, resolveHyperliquidRpcEnvVar, resolveHyperliquidStoreNetwork, resolveHyperliquidSymbol, resolveSpotMidCandidates, resolveSpotTokenCandidates, roundHyperliquidPriceToTick, scheduleHyperliquidCancel, sendHyperliquidSpot, setHyperliquidAccountAbstractionMode, setHyperliquidDexAbstraction, setHyperliquidPortfolioMargin, transferHyperliquidSubAccount, updateHyperliquidIsolatedMargin, updateHyperliquidLeverage, withdrawFromHyperliquid };
+export { DEFAULT_HYPERLIQUID_MARKET_SLIPPAGE_BPS, HyperliquidApiError, HyperliquidBuilderApprovalError, HyperliquidExchangeClient, HyperliquidGuardError, HyperliquidInfoClient, HyperliquidTermsError, __hyperliquidInternals, __hyperliquidMarketDataInternals, approveHyperliquidBuilderFee, batchModifyHyperliquidOrders, buildHyperliquidMarketIdentity, buildHyperliquidProfileAssets, buildHyperliquidSpotUsdPriceMap, cancelAllHyperliquidOrders, cancelHyperliquidOrders, cancelHyperliquidOrdersByCloid, cancelHyperliquidTwapOrder, computeHyperliquidMarketIocLimitPrice, createHyperliquidSubAccount, createMonotonicNonceFactory, depositToHyperliquidBridge, extractHyperliquidDex, extractHyperliquidOrderIds, fetchHyperliquidAllMids, fetchHyperliquidAssetCtxs, fetchHyperliquidBars, fetchHyperliquidClearinghouseState, fetchHyperliquidFrontendOpenOrders, fetchHyperliquidHistoricalOrders, fetchHyperliquidMeta, fetchHyperliquidMetaAndAssetCtxs, fetchHyperliquidOpenOrders, fetchHyperliquidOrderStatus, fetchHyperliquidPerpMarketInfo, fetchHyperliquidPreTransferCheck, fetchHyperliquidSizeDecimals, fetchHyperliquidSpotAccountValue, fetchHyperliquidSpotAssetCtxs, fetchHyperliquidSpotClearinghouseState, fetchHyperliquidSpotMarketInfo, fetchHyperliquidSpotMeta, fetchHyperliquidSpotMetaAndAssetCtxs, fetchHyperliquidSpotTickSize, fetchHyperliquidSpotUsdPriceMap, fetchHyperliquidTickSize, fetchHyperliquidUserFills, fetchHyperliquidUserFillsByTime, fetchHyperliquidUserRateLimit, formatHyperliquidMarketablePrice, formatHyperliquidOrderSize, formatHyperliquidPrice, formatHyperliquidSize, getHyperliquidMaxBuilderFee, isHyperliquidSpotSymbol, modifyHyperliquidOrder, normalizeHyperliquidBaseSymbol, normalizeHyperliquidMetaSymbol, normalizeSpotTokenName2 as normalizeSpotTokenName, parseSpotPairSymbol, placeHyperliquidOrder, placeHyperliquidTwapOrder, readHyperliquidAccountValue, readHyperliquidNumber, readHyperliquidPerpPosition, readHyperliquidPerpPositionSize, readHyperliquidSpotAccountValue, readHyperliquidSpotBalance, readHyperliquidSpotBalanceSize, recordHyperliquidBuilderApproval, recordHyperliquidTermsAcceptance, reserveHyperliquidRequestWeight, resolveHyperliquidAbstractionFromMode, resolveHyperliquidChain, resolveHyperliquidChainConfig, resolveHyperliquidErrorDetail, resolveHyperliquidOrderRef, resolveHyperliquidOrderSymbol, resolveHyperliquidPair, resolveHyperliquidProfileChain, resolveHyperliquidRpcEnvVar, resolveHyperliquidStoreNetwork, resolveHyperliquidSymbol, resolveSpotMidCandidates, resolveSpotTokenCandidates, roundHyperliquidPriceToTick, scheduleHyperliquidCancel, sendHyperliquidSpot, setHyperliquidAccountAbstractionMode, setHyperliquidDexAbstraction, setHyperliquidPortfolioMargin, transferHyperliquidSubAccount, updateHyperliquidIsolatedMargin, updateHyperliquidLeverage, withdrawFromHyperliquid };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map