@nktkas/hyperliquid 0.25.8 → 0.26.0

package/script/src/utils/_symbolConverter.js

@@ -1,176 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SymbolConverter = void 0;
-const meta_js_1 = require("../api/info/meta.js");
-const spotMeta_js_1 = require("../api/info/spotMeta.js");
-const perpDexs_js_1 = require("../api/info/perpDexs.js");
-/**
- * Utility class for converting asset symbols to their corresponding IDs and size decimals.
- * Supports perpetuals, spot markets, and optional builder dexs.
- * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/asset-ids
- * @example
- * ```ts
- * import { HttpTransport } from "@nktkas/hyperliquid";
- * import { SymbolConverter } from "@nktkas/hyperliquid/utils";
- *
- * const transport = new HttpTransport(); // or `WebSocketTransport`
- * const converter = await SymbolConverter.create({ transport });
- *
- * // By default, dexs are not loaded; specify them when creating an instance
- * // const converter = await SymbolConverter.create({ transport, dexs: ["test"] });
- *
- * const btcId = converter.getAssetId("BTC"); // perpetual → 0
- * const hypeUsdcId = converter.getAssetId("HYPE/USDC"); // spot market → 10107
- * const dexAbcId = converter.getAssetId("test:ABC"); // builder dex (if enabled) → 110000
- *
- * const btcSzDecimals = converter.getSzDecimals("BTC"); // perpetual → 5
- * const hypeUsdcSzDecimals = converter.getSzDecimals("HYPE/USDC"); // spot market → 2
- * const dexAbcSzDecimals = converter.getSzDecimals("test:ABC"); // builder dex (if enabled) → 0
- *
- * const spotPairId = converter.getSpotPairId("HFUN/USDC"); // → "@2"
- * ```
- */
-class SymbolConverter {
-    transport;
-    dexOption;
-    nameToAssetId = new Map();
-    nameToSzDecimals = new Map();
-    nameToSpotPairId = new Map();
-    constructor(options) {
-        this.transport = options.transport;
-        this.dexOption = options.dexs ?? false;
-    }
-    /**
-     * Create and initialize a SymbolConverter instance.
-     * @param options - Configuration options including transport and optional dex support.
-     * @returns Initialized SymbolConverter instance.
-     * @example
-     * ```ts
-     * import { HttpTransport } from "@nktkas/hyperliquid";
-     * import { SymbolConverter } from "@nktkas/hyperliquid/utils";
-     *
-     * const transport = new HttpTransport(); // or `WebSocketTransport`
-     * const converter = await SymbolConverter.create({ transport });
-     * ```
-     */
-    static async create(options) {
-        const instance = new SymbolConverter(options);
-        await instance.reload();
-        return instance;
-    }
-    /**
-     * Reload asset mappings from the API.
-     * Useful for refreshing data when new assets are added.
-     */
-    async reload() {
-        const config = { transport: this.transport };
-        const [perpMetaData, spotMetaData, perpDexsData] = await Promise.all([
-            (0, meta_js_1.meta)(config),
-            (0, spotMeta_js_1.spotMeta)(config),
-            (0, perpDexs_js_1.perpDexs)(config),
-        ]);
-        if (!perpMetaData?.universe?.length) {
-            throw new Error("Invalid perpetual metadata response");
-        }
-        if (!spotMetaData?.universe?.length || !spotMetaData?.tokens?.length) {
-            throw new Error("Invalid spot metadata response");
-        }
-        this.nameToAssetId.clear();
-        this.nameToSzDecimals.clear();
-        this.nameToSpotPairId.clear();
-        this.processDefaultPerps(perpMetaData);
-        this.processSpotAssets(spotMetaData);
-        // Only process builder dexs if dex support is enabled
-        if (this.dexOption !== false) {
-            await this.processBuilderDexs(perpDexsData);
-        }
-    }
-    processDefaultPerps(perpMeta) {
-        perpMeta.universe.forEach((asset, index) => {
-            this.nameToAssetId.set(asset.name, index);
-            this.nameToSzDecimals.set(asset.name, asset.szDecimals);
-        });
-    }
-    async processBuilderDexs(perpDexs) {
-        if (!perpDexs || perpDexs.length <= 1)
-            return;
-        const builderDexs = perpDexs
-            .map((dex, index) => ({ dex, index }))
-            .filter((item) => {
-            return item.index > 0 && item.dex !== null && item.dex.name.length > 0;
-        });
-        if (builderDexs.length === 0)
-            return;
-        // Filter dexs based on the dexOption
-        const dexsToProcess = Array.isArray(this.dexOption)
-            ? builderDexs.filter((item) => this.dexOption.includes(item.dex.name))
-            : builderDexs; // true means process all
-        if (dexsToProcess.length === 0)
-            return;
-        const config = { transport: this.transport };
-        const results = await Promise.allSettled(dexsToProcess.map((item) => (0, meta_js_1.meta)(config, { dex: item.dex.name })));
-        results.forEach((result, idx) => {
-            if (result.status !== "fulfilled")
-                return;
-            this.processBuilderDexResult(result.value, dexsToProcess[idx].index);
-        });
-    }
-    processBuilderDexResult(meta, perpDexIndex) {
-        const offset = 100000 + perpDexIndex * 10000;
-        meta.universe.forEach((asset, index) => {
-            const assetId = offset + index;
-            this.nameToAssetId.set(asset.name, assetId);
-            this.nameToSzDecimals.set(asset.name, asset.szDecimals);
-        });
-    }
-    processSpotAssets(spotMeta) {
-        const tokenMap = new Map();
-        spotMeta.tokens.forEach((token) => {
-            tokenMap.set(token.index, { name: token.name, szDecimals: token.szDecimals });
-        });
-        spotMeta.universe.forEach((market) => {
-            if (market.tokens.length < 2)
-                return;
-            const baseToken = tokenMap.get(market.tokens[0]);
-            const quoteToken = tokenMap.get(market.tokens[1]);
-            if (!baseToken || !quoteToken)
-                return;
-            const assetId = 10000 + market.index;
-            const baseQuoteKey = `${baseToken.name}/${quoteToken.name}`;
-            this.nameToAssetId.set(baseQuoteKey, assetId);
-            this.nameToSzDecimals.set(baseQuoteKey, baseToken.szDecimals);
-            this.nameToSpotPairId.set(baseQuoteKey, market.name);
-        });
-    }
-    /**
-     * Get asset ID for a coin.
-     * - For Perpetuals, use the coin name (e.g., "BTC").
-     * - For Spot markets, use the "BASE/QUOTE" format (e.g., "HYPE/USDC").
-     * - For Builder Dex assets, use the "DEX_NAME:ASSET_NAME" format (e.g., "test:ABC").
-     * @example "BTC" → 0, "HYPE/USDC" → 10107, "test:ABC" → 110000
-     */
-    getAssetId(name) {
-        return this.nameToAssetId.get(name);
-    }
-    /**
-     * Get size decimals for a coin.
-     * - For Perpetuals, use the coin name (e.g., "BTC").
-     * - For Spot markets, use the "BASE/QUOTE" format (e.g., "HYPE/USDC").
-     * - For Builder Dex assets, use the "DEX_NAME:ASSET_NAME" format (e.g., "test:ABC").
-     * @example "BTC" → 5, "HYPE/USDC" → 2, "test:ABC" → 0
-     */
-    getSzDecimals(name) {
-        return this.nameToSzDecimals.get(name);
-    }
-    /**
-     * Get spot pair ID for info endpoints and subscriptions (e.g., l2book, trades).
-     *
-     * Accepts spot markets in the "BASE/QUOTE" format (e.g., "HFUN/USDC").
-     * @example "HFUN/USDC" → "@2", "PURR/USDC" → "PURR/USDC"
-     */
-    getSpotPairId(name) {
-        return this.nameToSpotPairId.get(name);
-    }
-}
-exports.SymbolConverter = SymbolConverter;
-//# sourceMappingURL=_symbolConverter.js.map

package/script/src/utils/_symbolConverter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"_symbolConverter.js","sourceRoot":"","sources":["../../../src/src/utils/_symbolConverter.ts"],"names":[],"mappings":"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"}

package/script/src/utils/mod.d.ts

@@ -1,4 +0,0 @@
-export * from "./_symbolConverter.js";
-export * from "./_format.js";
-export * from "./_recover.js";
-//# sourceMappingURL=mod.d.ts.map

package/script/src/utils/mod.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/utils/mod.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/script/src/utils/mod.js

@@ -1,20 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./_symbolConverter.js"), exports);
-__exportStar(require("./_format.js"), exports);
-__exportStar(require("./_recover.js"), exports);
-//# sourceMappingURL=mod.js.map

package/script/src/utils/mod.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../../src/src/utils/mod.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,+CAA6B;AAC7B,gDAA8B"}

package/src/bin/cli.ts

@@ -1,319 +0,0 @@
-#!/usr/bin/env node
-import * as hl from "../src/mod.js";
-import * as v from "valibot";
-import { type Args, parseArgs, transformArgs } from "./_utils.js";
-
-// Hack to avoid `npm i --save-dev @types/node`
-declare const process: {
-  argv: string[];
-};
-
-function transformParams(method: string, params: Args) {
-  switch (method) {
-    case "spotUser": {
-      return { toggleSpotDusting: { ...params } };
-    }
-    case "twapOrder": {
-      return { twap: { ...params } };
-    }
-    default: {
-      return params;
-    }
-  }
-}
-
-class EchoTransport implements hl.IRequestTransport {
-  constructor(public isTestnet: boolean) {}
-  request<T>(_: "info" | "exchange" | "explorer", payload: unknown): Promise<T> {
-    return new Promise((resolve) => resolve({ status: "ok", response: payload } as T));
-  }
-}
-async function executeEndpointMethod(
-  endpoint: string,
-  method: string,
-  args: Args,
-): Promise<unknown> {
-  const isTestnet = "testnet" in args;
-  const timeout = Number(args.timeout) || undefined;
-  const isOffline = "offline" in args;
-
-  const transport = isOffline ? new EchoTransport(isTestnet) : new hl.HttpTransport({ isTestnet, timeout });
-  let client: hl.InfoClient | hl.ExchangeClient;
-
-  if (endpoint === "info") {
-    client = new hl.InfoClient({ transport });
-
-    if (!(method in client)) {
-      throw new Error(`CLI does not support the "${method}" method in the "${endpoint}" endpoint`);
-    }
-  } else if (endpoint === "exchange") {
-    const pk = v.parse(
-      v.pipe(v.string(), v.hexadecimal()),
-      args["private-key"],
-      { message: 'Invalid format "private-key": Expected 32-byte hexadecimal string' },
-    );
-    delete args["private-key"]; // just in case
-
-    const defaultVaultAddress = v.parse(
-      v.optional(v.pipe(v.string(), v.hexadecimal())),
-      args.vault,
-      { message: 'Invalid format "vault": Expected 20-byte hexadecimal string OR nothing' },
-    );
-
-    client = new hl.ExchangeClient({ transport, wallet: pk, defaultVaultAddress });
-
-    if (!(method in client)) {
-      throw new Error(`CLI does not support the "${method}" method in the "${endpoint}" endpoint`);
-    }
-  } else {
-    throw new Error(`Invalid endpoint "${endpoint}". Use "info" or "exchange"`);
-  }
-
-  if (isOffline) {
-    // @ts-ignore - dynamic method access
-    const response = await client[method](transformParams(method, args));
-    return response.response;
-  } else {
-    // @ts-ignore - dynamic method access
-    return await client[method](transformParams(method, args));
-  }
-}
-
-// ──────────────────── Main ────────────────────
-
-function printHelp() {
-  console.log(`Hyperliquid CLI
-
-Usage:
-  npx @nktkas/hyperliquid <endpoint> <method> [options]
-
-Endpoints:
-  info      - Query blockchain and market information
-  exchange  - Execute trading operations (requires --private-key)
-
-Common Options:
-  --testnet               Use testnet instead of mainnet
-  --timeout <number>      Request timeout in milliseconds (default: 10000)
-  --help, -h              Show this help message
-  --offline               Generate transactions offline without broadcasting
-
-Exchange Options:
-  --private-key <key>     Private key for exchange operations (required)
-  --vault <address>       Vault address for operations
-
-=============================================================================
-INFO ENDPOINT METHODS
-=============================================================================
-
-Market Data:
-  alignedQuoteTokenInfo   --token <number>
-  allMids                 [--dex <string>]
-  allPerpMetas            (no params)
-  candleSnapshot          --coin <string> --interval <1m|3m|5m|15m|30m|1h|2h|4h|8h|12h|1d|3d|1w|1M>
-                          --startTime <number> [--endTime <number>]
-  fundingHistory          --coin <string> --startTime <number> [--endTime <number>]
-  l2Book                  --coin <string> [--nSigFigs <2|3|4|5>] [--mantissa <2|5>]
-  liquidatable            (no params)
-  marginTable             --id <number>
-  maxMarketOrderNtls      (no params)
-  meta                    [--dex <string>]
-  metaAndAssetCtxs        [--dex <string>]
-  perpDexLimits           --dex <string>
-  perpDexs                (no params)
-  perpsAtOpenInterestCap  [--dex <string>]
-  predictedFundings       (no params)
-  recentTrades            --coin <string>
-  spotMeta                (no params)
-  spotMetaAndAssetCtxs    (no params)
-
-User Account:
-  activeAssetData         --user <address> --coin <string>
-  clearinghouseState      --user <address> [--dex <string>]
-  extraAgents             --user <address>
-  isVip                   --user <address>
-  legalCheck              --user <address>
-  maxBuilderFee           --user <address> --builder <address>
-  portfolio               --user <address>
-  preTransferCheck        --user <address> --source <address>
-  referral                --user <address>
-  spotClearinghouseState  --user <address> [--dex <string>]
-  subAccounts             --user <address>
-  subAccounts2            --user <address>
-  userDexAbstraction      --user <address>
-  userFees                --user <address>
-  userFunding             --user <address> --startTime <number> [--endTime <number>]
-  userNonFundingLedgerUpdates  --user <address> --startTime <number> [--endTime <number>]
-  userRateLimit           --user <address>
-  userRole                --user <address>
-  userToMultiSigSigners   --user <address>
-  webData2                --user <address>
-
-Orders & TWAP & Position:
-  frontendOpenOrders      --user <address> [--dex <string>]
-  historicalOrders        --user <address>
-  openOrders              --user <address> [--dex <string>]
-  orderStatus             --user <address> --oid <number|hex>
-  twapHistory             --user <address>
-  userFills               --user <address> [--aggregateByTime <bool>]
-  userFillsByTime         --user <address> --startTime <number>
-                          [--endTime <number>] [--aggregateByTime <bool>]
-  userTwapSliceFills           --user <address>
-  userTwapSliceFillsByTime     --user <address> --startTime <number>
-                               [--endTime <number>] [--aggregateByTime <bool>]
-
-Delegation & Validators:
-  delegations             --user <address>
-  delegatorHistory        --user <address>
-  delegatorRewards        --user <address>
-  delegatorSummary        --user <address>
-  gossipRootIps           (no params)
-  validatorL1Votes        (no params)
-  validatorSummaries      (no params)
-
-Vault:
-  leadingVaults           --user <address>
-  userVaultEquities       --user <address>
-  vaultDetails            --vaultAddress <address> [--user <address>]
-  vaultSummaries          (no params)
-
-Deploy Market:
-  perpDeployAuctionStatus      (no params)
-  spotDeployState              --user <address>
-  spotPairDeployAuctionStatus  (no params)
-
-Other:
-  exchangeStatus          (no params)
-
-Transaction & Block Details:
-  blockDetails            --height <number>
-  tokenDetails            --tokenId <hex>
-  txDetails               --hash <hex>
-  userDetails             --user <address>
-
-=============================================================================
-EXCHANGE ENDPOINT METHODS
-=============================================================================
-
-Order & TWAP & Position:
-  batchModify             --modifies <json>
-  cancel                  --cancels <json>
-  cancelByCloid           --cancels <json>
-  modify                  --oid <number|hex> --order <json>
-  order                   --orders <json> [--grouping <na|normalTpsl|positionTpsl>] [--builder <json>]
-  scheduleCancel          [--time <number>]
-  twapCancel              --a <number> --t <number>
-  twapOrder               --a <number> --b <bool> --s <number> --r <bool> --m <number> --t <bool>
-  updateIsolatedMargin    --asset <number> --isBuy <bool> --ntli <number>
-  updateLeverage          --asset <number> --isCross <bool> --leverage <number>
-
-Account:
-  agentEnableDexAbstraction  (no params)
-  approveAgent            --agentAddress <address> [--agentName <string>]
-  approveBuilderFee       --maxFeeRate <number> --builder <address>
-  evmUserModify           --usingBigBlocks <bool>
-  noop                    (no params)
-  reserveRequestWeight    --weight <number>
-  setDisplayName          --displayName <string>
-  spotUser                --optOut <bool>
-  userDexAbstraction      --user <address> --enabled <bool>
-
-Fund Transfers:
-  sendAsset               --destination <address> --token <name:address> --amount <number>
-                          --sourceDex <string> --destinationDex <string> [--fromSubAccount <address>]
-  spotSend                --destination <address> --token <name:address> --amount <number>
-  usdClassTransfer        --amount <number> --toPerp <bool>
-  usdSend                 --destination <address> --amount <number>
-  withdraw3               --destination <address> --amount <number>
-
-Sub-Account:
-  createSubAccount        --name <string>
-  subAccountModify        --subAccountUser <address> --name <string>
-  subAccountSpotTransfer  --subAccountUser <address> --isDeposit <bool>
-                          --token <name:address> --amount <number>
-  subAccountTransfer      --subAccountUser <address> --isDeposit <bool> --usd <number>
-
-Referrer:
-  claimRewards            (no params)
-  registerReferrer        --code <string>
-  setReferrer             --code <string>
-
-Staking & Delegation:
-  cDeposit                --wei <number>
-  cWithdraw               --wei <number>
-  linkStakingUser         --user <address> --isFinalize <bool>
-  tokenDelegate           --validator <address> --wei <number> --isUndelegate <bool>
-
-Vault:
-  createVault             --name <string> --description <string> --initialUsd <number>
-  vaultDistribute         --vaultAddress <address> --usd <number>
-  vaultModify             --vaultAddress <address> [--allowDeposits <bool>]
-                          [--alwaysCloseOnWithdraw <bool>]
-  vaultTransfer           --vaultAddress <address> --isDeposit <bool> --usd <number>
-
-Deploy Market:
-  perpDeploy              --registerAsset <json> | --setOracle <json> | --setFundingMultipliers <json> |
-                          --haltTrading <json> | --setMarginTableIds <json> | --setFeeRecipient <json> |
-                          --setOpenInterestCaps <json>
-  spotDeploy              --genesis <json> | --registerHyperliquidity <json> | --registerSpot <json> |
-                          --registerToken2 <json> | --setDeployerTradingFeeShare <json> | --userGenesis <json> |
-                          --enableQuoteToken <json>
-
-Validator Actions:
-  cSignerAction           --jailSelf null | --unjailSelf null
-  cValidatorAction        --changeProfile <json> | --register <json> | --unregister null
-
-Other:
-  convertToMultiSigUser   --authorizedUsers <json> --threshold <number>
-
-=============================================================================
-
-Examples:
-  # Get all mid prices
-  npx @nktkas/hyperliquid info allMids
-
-  # Get ETH order book with 3 significant figures
-  npx @nktkas/hyperliquid info l2Book --coin ETH --nSigFigs 3
-
-  # Get user's portfolio
-  npx @nktkas/hyperliquid info portfolio --user 0x...
-
-  # Get candle data for BTC
-  npx @nktkas/hyperliquid info candleSnapshot --coin BTC --interval 1h --startTime 1700000000000
-
-  # Place a limit order
-  npx @nktkas/hyperliquid exchange order --private-key 0x... --orders '[{\\"a\\":0,\\"b\\":true,\\"p\\":30000,\\"s\\":0.1,\\"r\\":false,\\"t\\":{\\"limit\\":{\\"tif\\":\\"Gtc\\"}}}]'
-
-  # Modify an existing order
-  npx @nktkas/hyperliquid exchange modify --private-key 0x... --oid 12345 --order '{\\"a\\":0,\\"b\\":true,\\"p\\":31000,\\"s\\":0.1,\\"r\\":false,\\"t\\":{\\"limit\\":{\\"tif\\":\\"Gtc\\"}}}'
-
-  # Cancel orders
-  npx @nktkas/hyperliquid exchange cancel --private-key 0x... --cancels '[{\\"a\\":0,\\"o\\":12345}]'
-
-  # Update leverage
-  npx @nktkas/hyperliquid exchange updateLeverage --private-key 0x... --asset 0 --isCross true --leverage 5
-
-  # Withdraw funds
-  npx @nktkas/hyperliquid exchange withdraw3 --private-key 0x... --destination 0x... --amount 100.5
-
-  # Send USD to another user
-  npx @nktkas/hyperliquid exchange usdSend --private-key 0x... --destination 0x... --amount 50
-
-  # Create a vault
-  npx @nktkas/hyperliquid exchange createVault --private-key 0x... --name "My Vault" --description "Test vault" --initialUsd 1000`);
-}
-
-const rawArgs = parseArgs(process.argv.slice(2), {
-  flags: ["testnet", "help", "h", "offline"],
-});
-const args = transformArgs(rawArgs, {
-  number: "string",
-});
-const [endpoint, method] = args._;
-
-if (args.help || args.h || !endpoint || !method) {
-  printHelp();
-} else {
-  executeEndpointMethod(endpoint, method, args)
-    .then((result) => console.log(JSON.stringify(result)))
-    .catch((error) => console.error("Error:", error instanceof Error ? error.message : String(error)));
-}

package/src/src/api/_base.ts

@@ -1,145 +0,0 @@
-// deno-lint-ignore-file no-explicit-any ban-types
-import * as v from "valibot";
-import { HyperliquidError } from "../_base.js";
-
-// -------------------- Types --------------------
-
-export type MaybePromise<T> = T | Promise<T>;
-
-export type Prettify<T> =
-  & { [K in keyof T]: T[K] }
-  & {};
-
-export type DeepImmutable<T> = {
-  readonly [K in keyof T]: DeepImmutable<T[K]>;
-};
-
-export type OmitFirst<T extends readonly any[]> = T extends readonly [any, ...infer R] ? R : [];
-
-export type OverloadedParameters<T> = T extends {
-  (...args: infer A1): unknown;
-  (...args: infer A2): unknown;
-  (...args: infer A3): unknown;
-  (...args: infer A4): unknown;
-} ? A1 | A2 | A3 | A4
-  : T extends {
-    (...args: infer A1): unknown;
-    (...args: infer A2): unknown;
-    (...args: infer A3): unknown;
-  } ? A1 | A2 | A3
-  : T extends {
-    (...args: infer A1): unknown;
-    (...args: infer A2): unknown;
-  } ? A1 | A2
-  : T extends (...args: infer A) => unknown ? A
-  : never;
-
-// -------------------- Schemas --------------------
-
-export const UnsignedDecimal = /* @__PURE__ */ (() => {
-  return v.pipe(
-    v.union([v.string(), v.number()]),
-    v.transform(String),
-    v.trim(),
-    v.regex(/^[0-9]+(\.[0-9]+)?$/),
-    v.transform((value) => formatDecimal(value)),
-  );
-})();
-export type UnsignedDecimal = v.InferOutput<typeof UnsignedDecimal>;
-
-export const Decimal = /* @__PURE__ */ (() => {
-  return v.pipe(
-    v.union([v.string(), v.number()]),
-    v.transform(String),
-    v.trim(),
-    v.regex(/^-?[0-9]+(\.[0-9]+)?$/),
-    v.transform((value) => formatDecimal(value)),
-  );
-})();
-export type Decimal = v.InferOutput<typeof Decimal>;
-
-export const Integer = /* @__PURE__ */ (() => {
-  return v.pipe(
-    v.union([v.string(), v.number()]),
-    v.transform(Number),
-    v.safeInteger(),
-  );
-})();
-export type Integer = v.InferOutput<typeof Integer>;
-
-export const UnsignedInteger = /* @__PURE__ */ (() => {
-  return v.pipe(
-    v.union([v.string(), v.number()]),
-    v.transform(Number),
-    v.safeInteger(),
-    v.minValue(0),
-  );
-})();
-export type UnsignedInteger = v.InferOutput<typeof UnsignedInteger>;
-
-export const Hex = /* @__PURE__ */ (() => {
-  return v.pipe(
-    v.string(),
-    v.regex(/^0[xX][0-9a-fA-F]+$/),
-    v.transform((value) => value.toLowerCase() as `0x${string}`),
-  );
-})();
-export type Hex = v.InferOutput<typeof Hex>;
-
-export const Address = /* @__PURE__ */ (() => {
-  return v.pipe(Hex, v.length(42));
-})();
-export type Address = v.InferOutput<typeof Address>;
-
-export const TokenId = /* @__PURE__ */ (() => {
-  return v.pipe(
-    v.string(),
-    v.regex(/^[^:]+:0x[0-9a-fA-F]+$/),
-    v.transform((value) => value as `${string}:${Hex}`),
-  );
-})();
-export type TokenId = v.InferOutput<typeof TokenId>;
-
-export const Percent = /* @__PURE__ */ (() => {
-  return v.pipe(
-    v.string(),
-    v.regex(/^[0-9]+(\.[0-9]+)?%$/),
-    v.transform((value) => value as `${string}%`),
-  );
-})();
-export type Percent = v.InferOutput<typeof Percent>;
-
-/** Removes leading/trailing zeros from decimal string without precision loss. */
-function formatDecimal(numStr: string): string {
-  return numStr
-    .trim()
-    .replace(/^(-?)0+(?=\d)/, "$1") // Remove leading zeros, keep sign
-    .replace(/(\.\d*?)0+$/, "$1") // Remove trailing zeros after decimal
-    .replace(/\.$/, ""); // Remove lone decimal point
-}
-
-/** Thrown when a schema validation error occurs.  */
-export class SchemaError extends HyperliquidError {
-  constructor(message: string) {
-    super(message);
-    this.name = "SchemaError";
-  }
-}
-
-/**
- * Creates a valibot parser with summarized error messages.
- * Used for validating, formatting, and sorting object keys for correct signature generation.
- * @param schema - The valibot schema to validate against.
- * @returns A parser function that validates input against the schema.
- */
-export function parser<TSchema extends v.GenericSchema>(schema: TSchema): v.Parser<TSchema, undefined> {
-  const safeParser = v.safeParser(schema);
-  const parser = (input: unknown) => {
-    const result = safeParser(input);
-    if (result.issues) throw new SchemaError("\n" + v.summarize(result.issues));
-    return result.output;
-  };
-  parser.schema = schema;
-  parser.config = undefined;
-  return parser;
-}