@basedone/core 0.1.8 → 0.2.0

package/dist/react.d.mts

@@ -0,0 +1,39 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { SpotMeta } from '@nktkas/hyperliquid';
+import { A as AllPerpsMeta, I as InstrumentClient } from './client-CgmiTuEX.mjs';
+
+interface InstrumentsProviderProps {
+    spotMeta: SpotMeta;
+    allPerpsMeta: AllPerpsMeta;
+    children: ReactNode;
+}
+/**
+ * Provides InstrumentClient to the React tree.
+ *
+ * @example
+ * ```tsx
+ * <InstrumentsProvider spotMeta={spotMeta} allPerpsMeta={allPerpsMeta}>
+ *   <App />
+ * </InstrumentsProvider>
+ * ```
+ */
+declare function InstrumentsProvider({ spotMeta, allPerpsMeta, children, }: InstrumentsProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Access the InstrumentClient from context.
+ * Must be used within an InstrumentsProvider.
+ *
+ * @example
+ * ```tsx
+ * const client = useInstruments();
+ * const btc = client.getInstrument("BTC");
+ * ```
+ */
+declare function useInstruments(): InstrumentClient;
+/**
+ * Access the InstrumentClient from context, returns null if not in provider.
+ * Useful for optional instrument access.
+ */
+declare function useInstrumentsOptional(): InstrumentClient | null;
+
+export { InstrumentsProvider, type InstrumentsProviderProps, useInstruments, useInstrumentsOptional };

package/dist/react.d.ts

@@ -0,0 +1,39 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { SpotMeta } from '@nktkas/hyperliquid';
+import { A as AllPerpsMeta, I as InstrumentClient } from './client-CgmiTuEX.js';
+
+interface InstrumentsProviderProps {
+    spotMeta: SpotMeta;
+    allPerpsMeta: AllPerpsMeta;
+    children: ReactNode;
+}
+/**
+ * Provides InstrumentClient to the React tree.
+ *
+ * @example
+ * ```tsx
+ * <InstrumentsProvider spotMeta={spotMeta} allPerpsMeta={allPerpsMeta}>
+ *   <App />
+ * </InstrumentsProvider>
+ * ```
+ */
+declare function InstrumentsProvider({ spotMeta, allPerpsMeta, children, }: InstrumentsProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Access the InstrumentClient from context.
+ * Must be used within an InstrumentsProvider.
+ *
+ * @example
+ * ```tsx
+ * const client = useInstruments();
+ * const btc = client.getInstrument("BTC");
+ * ```
+ */
+declare function useInstruments(): InstrumentClient;
+/**
+ * Access the InstrumentClient from context, returns null if not in provider.
+ * Useful for optional instrument access.
+ */
+declare function useInstrumentsOptional(): InstrumentClient | null;
+
+export { InstrumentsProvider, type InstrumentsProviderProps, useInstruments, useInstrumentsOptional };

package/dist/react.js

@@ -0,0 +1,268 @@
+'use strict';
+
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+// lib/react/InstrumentProvider.tsx
+
+// lib/instrument/client.ts
+var AssetIdUtils = {
+  /**
+   * Calculate perp asset ID
+   * - Root dex: assetIndex (0, 1, 2, ...)
+   * - HIP3 dex: 100000 + dexIndex * 10000 + assetIndex
+   */
+  calcPerpAssetId(dexIndex, assetIndex) {
+    if (dexIndex === 0) return assetIndex;
+    return 1e5 + dexIndex * 1e4 + assetIndex;
+  },
+  /**
+   * Calculate spot asset ID: 10000 + pairIndex
+   */
+  calcSpotAssetId(pairIndex) {
+    return 1e4 + pairIndex;
+  },
+  /**
+   * Check if symbol is HIP3 format (contains ":")
+   */
+  isHip3Symbol(symbol) {
+    return symbol?.includes(":") ?? false;
+  },
+  /**
+   * Extract dex name from HIP3 symbol (e.g., "xyz:MSTR" -> "xyz")
+   */
+  extractDexName(symbol) {
+    if (!this.isHip3Symbol(symbol)) return void 0;
+    return symbol.split(":")[0];
+  }
+};
+var InstrumentClient = class {
+  constructor(spotMeta, allPerpsMeta) {
+    this.spotMeta = spotMeta;
+    this.allPerpsMeta = allPerpsMeta;
+    this.instruments = [];
+    // O(1) lookup maps for efficient retrieval
+    this.instrumentsBySymbol = /* @__PURE__ */ new Map();
+    this.instrumentsByCoin = /* @__PURE__ */ new Map();
+    this.instrumentsByAssetId = /* @__PURE__ */ new Map();
+    // Additional spot lookups (base token -> instrument)
+    this.spotByBaseToken = /* @__PURE__ */ new Map();
+    // Dex metadata map (dex name -> PerpsMeta)
+    // Key: "" for root dex, dex name for HIP3 (e.g., "xyz")
+    this.dexMetaMap = /* @__PURE__ */ new Map();
+    // Token index lookup for spot
+    this.spotTokensByIndex = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Initialize the client by processing meta into instruments.
+   * Call this after construction to populate the instrument registry.
+   * @returns this for chaining
+   */
+  init() {
+    if (!this.spotMeta || !this.allPerpsMeta) {
+      throw new Error("SpotMeta and allPerpsMeta are required");
+    }
+    this.indexSpotTokens();
+    this.processPerpsInstruments();
+    this.processSpotInstruments();
+    return this;
+  }
+  // ===== Perps Meta Accessors =====
+  getAllPerpsMeta() {
+    return this.allPerpsMeta;
+  }
+  /**
+   * Get PerpsMeta for a specific dex
+   * @param dex - Dex name ("" for root dex, or HIP3 dex name)
+   */
+  getPerpDex(dex) {
+    return this.dexMetaMap.get(dex);
+  }
+  /**
+   * Get PerpsMeta by dex index in allPerpsMeta array
+   */
+  getPerpDexByIndex(index) {
+    return this.allPerpsMeta[index];
+  }
+  // ===== Instrument Accessors =====
+  /**
+   * Get all instruments
+   */
+  getAllInstruments() {
+    return this.instruments;
+  }
+  /**
+   * Get all perps instruments
+   */
+  getPerpsInstruments() {
+    return this.instruments.filter(
+      (i) => i.type === "futures"
+    );
+  }
+  getHip3Instruments() {
+    return this.instruments.filter(
+      (i) => i.type === "futures" && !!i.dex
+    );
+  }
+  /**
+   * Get all spot instruments
+   */
+  getSpotInstruments() {
+    return this.instruments.filter(
+      (i) => i.type === "spot"
+    );
+  }
+  /**
+   * Get instrument by symbol or coin (tries both)
+   * @param coinOrSymbol - Symbol (e.g., "BTC", "BTC/USDC") or coin (e.g., "@107")
+   */
+  getInstrument(coinOrSymbol) {
+    return this.instrumentsByCoin.get(coinOrSymbol) ?? this.instrumentsBySymbol.get(coinOrSymbol);
+  }
+  /**
+   * Get instrument by display symbol
+   * @param symbol - Display symbol (e.g., "BTC", "BTC/USDC", "xyz:MSTR")
+   */
+  getInstrumentBySymbol(symbol) {
+    return this.instrumentsBySymbol.get(symbol);
+  }
+  /**
+   * Get instrument by Hyperliquid API coin format
+   * @param coin - API coin name (e.g., "BTC", "@107", "xyz:MSTR")
+   */
+  getInstrumentByCoin(coin) {
+    return this.instrumentsByCoin.get(coin);
+  }
+  /**
+   * Get instrument by asset ID
+   * @param assetId - Numeric asset ID (e.g., 1 for perps, 10001 for spot)
+   */
+  getInstrumentByAssetId(assetId) {
+    return this.instrumentsByAssetId.get(assetId);
+  }
+  /**
+   * Get spot instrument by base token symbol
+   * @param baseSymbol - Base token symbol (e.g., "HYPE" to find "HYPE/USDC")
+   */
+  getSpotInstrumentByBaseToken(baseSymbol) {
+    return this.spotByBaseToken.get(baseSymbol);
+  }
+  /** Search instruments by symbol, coin, or assetId */
+  searchInstruments(query, type) {
+    return this.instruments.filter((i) => {
+      if (type && i.type !== type) return false;
+      return i.symbol.toLowerCase().includes(query.toLowerCase()) || i.coin.toLowerCase().includes(query.toLowerCase());
+    });
+  }
+  /**
+   * Get spot token by index
+   */
+  getSpotToken(index) {
+    return this.spotTokensByIndex.get(index);
+  }
+  // ===== Internal Processing =====
+  indexSpotTokens() {
+    for (const token of this.spotMeta.tokens) {
+      this.spotTokensByIndex.set(token.index, token);
+    }
+  }
+  processPerpsInstruments() {
+    for (let dexIndex = 0; dexIndex < this.allPerpsMeta.length; dexIndex++) {
+      const perpMeta = this.allPerpsMeta[dexIndex];
+      const dexName = this.extractDexNameFromMeta(perpMeta, dexIndex);
+      this.dexMetaMap.set(dexName, perpMeta);
+      const collateralToken = this.spotTokensByIndex.get(
+        perpMeta.collateralToken
+      );
+      const collateralTokenSymbol = collateralToken?.name ?? "USDC";
+      for (let assetIndex = 0; assetIndex < perpMeta.universe.length; assetIndex++) {
+        const info = perpMeta.universe[assetIndex];
+        const assetId = AssetIdUtils.calcPerpAssetId(dexIndex, assetIndex);
+        const instrument = {
+          assetId,
+          symbol: info.name,
+          coin: info.name,
+          szDecimals: info.szDecimals,
+          leverage: info.maxLeverage,
+          collateralTokenSymbol,
+          type: "futures",
+          isDelisted: info.isDelisted,
+          dex: AssetIdUtils.extractDexName(info.name),
+          collateralTokenIndex: perpMeta.collateralToken
+        };
+        this.addInstrument(instrument);
+      }
+    }
+  }
+  processSpotInstruments() {
+    const seenSymbols = /* @__PURE__ */ new Set();
+    for (const pair of this.spotMeta.universe) {
+      const [baseTokenIndex, quoteTokenIndex] = pair.tokens;
+      const baseToken = this.spotTokensByIndex.get(baseTokenIndex);
+      const quoteToken = this.spotTokensByIndex.get(quoteTokenIndex);
+      if (!baseToken || !quoteToken) continue;
+      const symbol = `${baseToken.name}/${quoteToken.name}`;
+      if (seenSymbols.has(symbol)) continue;
+      seenSymbols.add(symbol);
+      const assetId = AssetIdUtils.calcSpotAssetId(pair.index);
+      const instrument = {
+        assetId,
+        symbol,
+        coin: pair.name,
+        // e.g., "@107"
+        szDecimals: baseToken.szDecimals,
+        type: "spot",
+        baseToken,
+        quoteToken
+      };
+      this.addInstrument(instrument);
+      if (!this.spotByBaseToken.has(baseToken.name)) {
+        this.spotByBaseToken.set(baseToken.name, instrument);
+      }
+    }
+  }
+  addInstrument(instrument) {
+    this.instruments.push(instrument);
+    this.instrumentsBySymbol.set(instrument.symbol, instrument);
+    this.instrumentsByCoin.set(instrument.coin, instrument);
+    this.instrumentsByAssetId.set(instrument.assetId, instrument);
+  }
+  /**
+   * Extract dex name from PerpsMeta
+   * Root dex (index 0) returns "", HIP3 dexes return the dex name (e.g., "xyz")
+   */
+  extractDexNameFromMeta(perpMeta, dexIndex) {
+    if (dexIndex === 0) return "";
+    const firstAsset = perpMeta.universe[0];
+    if (!firstAsset) return "";
+    return AssetIdUtils.extractDexName(firstAsset.name) ?? "";
+  }
+};
+var InstrumentContext = react.createContext(null);
+function InstrumentsProvider({
+  spotMeta,
+  allPerpsMeta,
+  children
+}) {
+  const client = react.useMemo(
+    () => new InstrumentClient(spotMeta, allPerpsMeta).init(),
+    [spotMeta, allPerpsMeta]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(InstrumentContext.Provider, { value: client, children });
+}
+function useInstruments() {
+  const client = react.useContext(InstrumentContext);
+  if (!client) {
+    throw new Error(
+      "useInstruments must be used within an InstrumentsProvider"
+    );
+  }
+  return client;
+}
+function useInstrumentsOptional() {
+  return react.useContext(InstrumentContext);
+}
+
+exports.InstrumentsProvider = InstrumentsProvider;
+exports.useInstruments = useInstruments;
+exports.useInstrumentsOptional = useInstrumentsOptional;

package/dist/react.mjs

@@ -0,0 +1,31 @@
+import { InstrumentClient } from './chunk-VBC6EQ7Q.mjs';
+import './chunk-4UEJOM6W.mjs';
+import { createContext, useMemo, useContext } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+var InstrumentContext = createContext(null);
+function InstrumentsProvider({
+  spotMeta,
+  allPerpsMeta,
+  children
+}) {
+  const client = useMemo(
+    () => new InstrumentClient(spotMeta, allPerpsMeta).init(),
+    [spotMeta, allPerpsMeta]
+  );
+  return /* @__PURE__ */ jsx(InstrumentContext.Provider, { value: client, children });
+}
+function useInstruments() {
+  const client = useContext(InstrumentContext);
+  if (!client) {
+    throw new Error(
+      "useInstruments must be used within an InstrumentsProvider"
+    );
+  }
+  return client;
+}
+function useInstrumentsOptional() {
+  return useContext(InstrumentContext);
+}
+
+export { InstrumentsProvider, useInstruments, useInstrumentsOptional };

package/dist/{spotMeta-WQ4PXRNY.mjs → spotMeta-GHXX7C5M.mjs}

@@ -1,4 +1,4 @@
-import "./chunk-4UEJOM6W.mjs";
+import './chunk-4UEJOM6W.mjs';
 
 // lib/meta/data/mainnet/spotMeta.json
 var universe = [
@@ -2143,6 +2143,51 @@ var universe = [
     name: "@253",
     index: 253,
     isCanonical: false
+  },
+  {
+    tokens: [
+      124,
+      360
+    ],
+    name: "@254",
+    index: 254,
+    isCanonical: false
+  },
+  {
+    tokens: [
+      150,
+      235
+    ],
+    name: "@255",
+    index: 255,
+    isCanonical: false
+  },
+  {
+    tokens: [
+      374,
+      0
+    ],
+    name: "@256",
+    index: 256,
+    isCanonical: false
+  },
+  {
+    tokens: [
+      403,
+      0
+    ],
+    name: "@257",
+    index: 257,
+    isCanonical: false
+  },
+  {
+    tokens: [
+      398,
+      0
+    ],
+    name: "@258",
+    index: 258,
+    isCanonical: false
   }
 ];
 var tokens = [
@@ -2153,7 +2198,10 @@ var tokens = [
     index: 0,
     tokenId: "0x6d1e7cde53ba9467b783cb7c530ce054",
     isCanonical: true,
-    evmContract: null,
+    evmContract: {
+      address: "0x6b9e773128f453f5c2c60935ee2de2cbc5390a24",
+      evm_extra_wei_decimals: -2
+    },
     fullName: null,
     deployerTradingFeeShare: "0.0"
   },
@@ -3574,9 +3622,12 @@ var tokens = [
     index: 124,
     tokenId: "0xbd31bd605c0a1b82c72aae3587f9061f",
     isCanonical: false,
-    evmContract: null,
+    evmContract: {
+      address: "0x000000000000780555bd0bca3791f89f9542c2d6",
+      evm_extra_wei_decimals: 10
+    },
     fullName: "Kinetiq",
-    deployerTradingFeeShare: "0.0"
+    deployerTradingFeeShare: "1.0"
   },
   {
     name: "BUSSY",
@@ -4068,7 +4119,7 @@ var tokens = [
       evm_extra_wei_decimals: 10
     },
     fullName: null,
-    deployerTradingFeeShare: "0.0"
+    deployerTradingFeeShare: "1.0"
   },
   {
     name: "ANIME",
@@ -6564,7 +6615,10 @@ var tokens = [
     index: 374,
     tokenId: "0x83a0bf54708a0236a49f7301677ffdc2",
     isCanonical: false,
-    evmContract: null,
+    evmContract: {
+      address: "0x4f96b683714377c38123631f2d17cdf18b3f46a7",
+      evm_extra_wei_decimals: 10
+    },
     fullName: "SEDA",
     deployerTradingFeeShare: "1.0"
   },
@@ -6641,7 +6695,10 @@ var tokens = [
     index: 381,
     tokenId: "0xbd6af8c18f3e56d2da95a3c81d18e814",
     isCanonical: false,
-    evmContract: null,
+    evmContract: {
+      address: "0x99603f5cb890faca5cc5495ccc74391cdffa28bc",
+      evm_extra_wei_decimals: 10
+    },
     fullName: "Funnel BNB",
     deployerTradingFeeShare: "1.0"
   },
@@ -6804,7 +6861,10 @@ var tokens = [
     index: 395,
     tokenId: "0xedfb8d993ee8cb935338601d8673dfcf",
     isCanonical: false,
-    evmContract: null,
+    evmContract: {
+      address: "0x3073f7aaa4db83f95e9fff17424f71d4751a3073",
+      evm_extra_wei_decimals: 0
+    },
     fullName: null,
     deployerTradingFeeShare: "1.0"
   },
@@ -6837,7 +6897,10 @@ var tokens = [
     index: 398,
     tokenId: "0xec43194f64d555bdaef5afb5b6c6c686",
     isCanonical: false,
-    evmContract: null,
+    evmContract: {
+      address: "0xa51dc81944a15623874981181a99d6c56b20ed56",
+      evm_extra_wei_decimals: 11
+    },
     fullName: "Stable",
     deployerTradingFeeShare: "1.0"
   },
@@ -6884,14 +6947,22 @@ var tokens = [
     evmContract: null,
     fullName: "UltraSolid",
     deployerTradingFeeShare: "1.0"
+  },
+  {
+    name: "UMEGA",
+    szDecimals: 1,
+    weiDecimals: 6,
+    index: 403,
+    tokenId: "0xc99926509a189b40651055a15d3be621",
+    isCanonical: false,
+    evmContract: null,
+    fullName: "Unit MegaETH",
+    deployerTradingFeeShare: "1.0"
   }
 ];
 var spotMeta_default = {
   universe,
   tokens
 };
-export {
-  spotMeta_default as default,
-  tokens,
-  universe
-};
+
+export { spotMeta_default as default, tokens, universe };