@basedone/core 0.0.7 → 0.0.8

package/dist/index.d.mts

@@ -274,6 +274,7 @@ interface DexInfo {
     collateralTokenSymbol: string;
     displayName?: string;
     imageUrl?: string;
+    accountName?: string;
 }
 type ExtendedPerpsMeta = PerpsMeta & {
     collateralToken?: number;
@@ -336,6 +337,7 @@ declare class MetadataClient {
     private hip3SymbolToMarket;
     private dexNameToIndex;
     private initialized;
+    private initializing;
     constructor(config?: MetadataClientConfig);
     /**
      * Initialize metadata by fetching from Hyperliquid
@@ -426,6 +428,12 @@ declare class MetadataClient {
         hip3DexsMeta: {
             [k: string]: DexInfo;
         };
+        coinToMarket: {
+            [k: string]: MarketInfo;
+        };
+        hip3SymbolToMarket: {
+            [k: string]: MarketInfo;
+        };
     };
     /**
      * Get network configuration

package/dist/index.d.ts

@@ -274,6 +274,7 @@ interface DexInfo {
     collateralTokenSymbol: string;
     displayName?: string;
     imageUrl?: string;
+    accountName?: string;
 }
 type ExtendedPerpsMeta = PerpsMeta & {
     collateralToken?: number;
@@ -336,6 +337,7 @@ declare class MetadataClient {
     private hip3SymbolToMarket;
     private dexNameToIndex;
     private initialized;
+    private initializing;
     constructor(config?: MetadataClientConfig);
     /**
      * Initialize metadata by fetching from Hyperliquid
@@ -426,6 +428,12 @@ declare class MetadataClient {
         hip3DexsMeta: {
             [k: string]: DexInfo;
         };
+        coinToMarket: {
+            [k: string]: MarketInfo;
+        };
+        hip3SymbolToMarket: {
+            [k: string]: MarketInfo;
+        };
     };
     /**
      * Get network configuration

package/dist/index.js

@@ -48,7 +48,8 @@ var require_staticMeta = __commonJS({
       dexs: {
         xyz: {
           imageUrl: "",
-          displayName: "Stocks"
+          displayName: "Trade.xyz",
+          accountName: "Equities"
         }
       }
     };
@@ -66,7 +67,8 @@ var require_staticMeta2 = __commonJS({
       },
       dexs: {
         rrrrr: {
-          displayName: "Hyena"
+          displayName: "Hyena",
+          accountName: "USDe"
         }
       }
     };
@@ -37069,6 +37071,7 @@ var MetadataClient = class {
     this.dexNameToIndex = /* @__PURE__ */ new Map();
     // Lazy init flag
     this.initialized = false;
+    this.initializing = null;
     const transport = new import_hyperliquid.HttpTransport({
       isTestnet: config.isTestnet ?? false
     });
@@ -37086,44 +37089,54 @@ var MetadataClient = class {
    */
   async initialize() {
     if (this.initialized) return;
-    await this.loadStaticMetaOverrides();
-    if (this.config.onlyUseStaticFallback) {
-      await this.loadStaticMetadata();
-      this.buildLookupMaps();
-      if (this.config.hip3Dexs && this.config.hip3Dexs.length > 0) {
-        await Promise.all(
-          this.config.hip3Dexs.map((dex) => this.loadHip3Metadata(dex))
-        );
-      }
-      this.initialized = true;
-      return;
-    }
-    try {
-      [this.spotMeta, this.perpsMeta, this.perpDexs] = await Promise.all([
-        this.infoClient.spotMeta(),
-        this.infoClient.meta(),
-        this.infoClient.perpDexs()
-      ]);
-      this.buildLookupMaps();
-      if (this.config.hip3Dexs && this.config.hip3Dexs.length > 0) {
-        await Promise.all(
-          this.config.hip3Dexs.map((dex) => this.loadHip3Metadata(dex))
-        );
-      }
-      this.initialized = true;
-    } catch (error) {
-      if (this.config.useStaticFallback) {
-        console.warn(
-          "Failed to fetch metadata from API, using static fallback data",
-          error
-        );
+    if (this.initializing) return this.initializing;
+    this.initializing = new Promise(async (resolve, reject) => {
+      await this.loadStaticMetaOverrides();
+      if (this.config.onlyUseStaticFallback) {
         await this.loadStaticMetadata();
         this.buildLookupMaps();
+        if (this.config.hip3Dexs && this.config.hip3Dexs.length > 0) {
+          await Promise.all(
+            this.config.hip3Dexs.map((dex) => this.loadHip3Metadata(dex))
+          );
+        }
+        resolve();
+        this.initialized = true;
+        return;
+      }
+      try {
+        [this.spotMeta, this.perpsMeta, this.perpDexs] = await Promise.all([
+          this.infoClient.spotMeta(),
+          this.infoClient.meta(),
+          this.infoClient.perpDexs()
+        ]);
+        this.buildLookupMaps();
+        if (this.config.hip3Dexs && this.config.hip3Dexs.length > 0) {
+          await Promise.all(
+            this.config.hip3Dexs.map((dex) => this.loadHip3Metadata(dex))
+          );
+        }
+        this.initialized = true;
+        resolve();
+      } catch (error) {
+        if (this.config.useStaticFallback) {
+          console.warn(
+            "Failed to fetch metadata from API, using static fallback data",
+            error
+          );
+          await this.loadStaticMetadata();
+          this.buildLookupMaps();
+          this.initialized = true;
+          resolve();
+        } else {
+          reject(error);
+        }
+      } finally {
         this.initialized = true;
-      } else {
-        throw error;
+        resolve();
       }
-    }
+    });
+    return this.initializing;
   }
   /**
    * Load staticMeta.json for display overrides
@@ -37176,9 +37189,14 @@ var MetadataClient = class {
     this.spotPairToMarket.clear();
     this.baseTokenToMarkets.clear();
     this.coinToMarket.clear();
-    this.hip3SymbolToMarket.clear();
     this.dexNameToIndex.clear();
     this.quoteAssets = [];
+    console.info(
+      "[MetadataClient] Building lookup maps",
+      this.perpDexs,
+      this.perpsMeta,
+      this.spotMeta
+    );
     if (this.perpDexs) {
       this.perpDexs.forEach((dex, index) => {
         if (dex && dex.name) {
@@ -37289,6 +37307,9 @@ var MetadataClient = class {
         if (staticDexOverrides.imageUrl) {
           dexInfo.imageUrl = staticDexOverrides.imageUrl;
         }
+        if (staticDexOverrides.accountName) {
+          dexInfo.accountName = staticDexOverrides.accountName;
+        }
       }
       this.hip3DexsMeta.set(dexName, dexInfo);
       this.buildHip3MarketsForDex(dexName, dexInfo);
@@ -37325,6 +37346,7 @@ var MetadataClient = class {
           marketInfo.imageUrl = staticOverrides.imageUrl;
         }
       }
+      console.info("[MetadataClient] caching market", symbol, marketInfo);
       this.coinToMarket.set(symbol, marketInfo);
       this.hip3SymbolToMarket.set(symbol, marketInfo);
     });
@@ -37413,6 +37435,7 @@ var MetadataClient = class {
     if (!dexName || !coinName) return null;
     let cachedMarket = this.hip3SymbolToMarket.get(symbol);
     if (cachedMarket) return cachedMarket;
+    console.warn("Missing market", symbol, this.hip3SymbolToMarket);
     const dexMeta = this.hip3DexsMeta.get(dexName);
     if (!dexMeta && this.config.lazyInit) {
       await this.loadHip3Metadata(dexName);
@@ -37471,7 +37494,9 @@ var MetadataClient = class {
       spotMeta: this.spotMeta,
       perpsMeta: this.perpsMeta,
       perpDexs: this.perpDexs,
-      hip3DexsMeta: Object.fromEntries(this.hip3DexsMeta)
+      hip3DexsMeta: Object.fromEntries(this.hip3DexsMeta),
+      coinToMarket: Object.fromEntries(this.coinToMarket),
+      hip3SymbolToMarket: Object.fromEntries(this.hip3SymbolToMarket)
     };
   }
   /**

package/dist/index.mjs

@@ -544,8 +544,8 @@ function isHip3Symbol(symbol) {
 
 // import("./data/**/*/staticMeta.json") in lib/meta/metadata.ts
 var globImport_data_staticMeta_json = __glob({
-  "./data/mainnet/staticMeta.json": () => import("./staticMeta-HRXST42O.mjs"),
-  "./data/testnet/staticMeta.json": () => import("./staticMeta-QWPQK3MD.mjs")
+  "./data/mainnet/staticMeta.json": () => import("./staticMeta-QV2KMX57.mjs"),
+  "./data/testnet/staticMeta.json": () => import("./staticMeta-GM7T3OYL.mjs")
 });
 
 // import("./data/**/*/spotMeta.json") in lib/meta/metadata.ts
@@ -593,6 +593,7 @@ var MetadataClient = class {
     this.dexNameToIndex = /* @__PURE__ */ new Map();
     // Lazy init flag
     this.initialized = false;
+    this.initializing = null;
     const transport = new HttpTransport({
       isTestnet: config.isTestnet ?? false
     });
@@ -610,44 +611,54 @@ var MetadataClient = class {
    */
   async initialize() {
     if (this.initialized) return;
-    await this.loadStaticMetaOverrides();
-    if (this.config.onlyUseStaticFallback) {
-      await this.loadStaticMetadata();
-      this.buildLookupMaps();
-      if (this.config.hip3Dexs && this.config.hip3Dexs.length > 0) {
-        await Promise.all(
-          this.config.hip3Dexs.map((dex) => this.loadHip3Metadata(dex))
-        );
-      }
-      this.initialized = true;
-      return;
-    }
-    try {
-      [this.spotMeta, this.perpsMeta, this.perpDexs] = await Promise.all([
-        this.infoClient.spotMeta(),
-        this.infoClient.meta(),
-        this.infoClient.perpDexs()
-      ]);
-      this.buildLookupMaps();
-      if (this.config.hip3Dexs && this.config.hip3Dexs.length > 0) {
-        await Promise.all(
-          this.config.hip3Dexs.map((dex) => this.loadHip3Metadata(dex))
-        );
-      }
-      this.initialized = true;
-    } catch (error) {
-      if (this.config.useStaticFallback) {
-        console.warn(
-          "Failed to fetch metadata from API, using static fallback data",
-          error
-        );
+    if (this.initializing) return this.initializing;
+    this.initializing = new Promise(async (resolve, reject) => {
+      await this.loadStaticMetaOverrides();
+      if (this.config.onlyUseStaticFallback) {
         await this.loadStaticMetadata();
         this.buildLookupMaps();
+        if (this.config.hip3Dexs && this.config.hip3Dexs.length > 0) {
+          await Promise.all(
+            this.config.hip3Dexs.map((dex) => this.loadHip3Metadata(dex))
+          );
+        }
+        resolve();
+        this.initialized = true;
+        return;
+      }
+      try {
+        [this.spotMeta, this.perpsMeta, this.perpDexs] = await Promise.all([
+          this.infoClient.spotMeta(),
+          this.infoClient.meta(),
+          this.infoClient.perpDexs()
+        ]);
+        this.buildLookupMaps();
+        if (this.config.hip3Dexs && this.config.hip3Dexs.length > 0) {
+          await Promise.all(
+            this.config.hip3Dexs.map((dex) => this.loadHip3Metadata(dex))
+          );
+        }
+        this.initialized = true;
+        resolve();
+      } catch (error) {
+        if (this.config.useStaticFallback) {
+          console.warn(
+            "Failed to fetch metadata from API, using static fallback data",
+            error
+          );
+          await this.loadStaticMetadata();
+          this.buildLookupMaps();
+          this.initialized = true;
+          resolve();
+        } else {
+          reject(error);
+        }
+      } finally {
         this.initialized = true;
-      } else {
-        throw error;
+        resolve();
       }
-    }
+    });
+    return this.initializing;
   }
   /**
    * Load staticMeta.json for display overrides
@@ -700,9 +711,14 @@ var MetadataClient = class {
     this.spotPairToMarket.clear();
     this.baseTokenToMarkets.clear();
     this.coinToMarket.clear();
-    this.hip3SymbolToMarket.clear();
     this.dexNameToIndex.clear();
     this.quoteAssets = [];
+    console.info(
+      "[MetadataClient] Building lookup maps",
+      this.perpDexs,
+      this.perpsMeta,
+      this.spotMeta
+    );
     if (this.perpDexs) {
       this.perpDexs.forEach((dex, index) => {
         if (dex && dex.name) {
@@ -813,6 +829,9 @@ var MetadataClient = class {
         if (staticDexOverrides.imageUrl) {
           dexInfo.imageUrl = staticDexOverrides.imageUrl;
         }
+        if (staticDexOverrides.accountName) {
+          dexInfo.accountName = staticDexOverrides.accountName;
+        }
       }
       this.hip3DexsMeta.set(dexName, dexInfo);
       this.buildHip3MarketsForDex(dexName, dexInfo);
@@ -849,6 +868,7 @@ var MetadataClient = class {
           marketInfo.imageUrl = staticOverrides.imageUrl;
         }
       }
+      console.info("[MetadataClient] caching market", symbol, marketInfo);
       this.coinToMarket.set(symbol, marketInfo);
       this.hip3SymbolToMarket.set(symbol, marketInfo);
     });
@@ -937,6 +957,7 @@ var MetadataClient = class {
     if (!dexName || !coinName) return null;
     let cachedMarket = this.hip3SymbolToMarket.get(symbol);
     if (cachedMarket) return cachedMarket;
+    console.warn("Missing market", symbol, this.hip3SymbolToMarket);
     const dexMeta = this.hip3DexsMeta.get(dexName);
     if (!dexMeta && this.config.lazyInit) {
       await this.loadHip3Metadata(dexName);
@@ -995,7 +1016,9 @@ var MetadataClient = class {
       spotMeta: this.spotMeta,
       perpsMeta: this.perpsMeta,
       perpDexs: this.perpDexs,
-      hip3DexsMeta: Object.fromEntries(this.hip3DexsMeta)
+      hip3DexsMeta: Object.fromEntries(this.hip3DexsMeta),
+      coinToMarket: Object.fromEntries(this.coinToMarket),
+      hip3SymbolToMarket: Object.fromEntries(this.hip3SymbolToMarket)
     };
   }
   /**

package/dist/staticMeta-D2V74GCG.mjs

@@ -0,0 +1,23 @@
+import "./chunk-4UEJOM6W.mjs";
+
+// lib/meta/data/testnet/staticMeta.json
+var coins = {
+  "rrrrr:BTC": {
+    displayName: "BTCe"
+  }
+};
+var dexs = {
+  rrrrr: {
+    displayName: "Hyena",
+    accountName: "USDe Perps"
+  }
+};
+var staticMeta_default = {
+  coins,
+  dexs
+};
+export {
+  coins,
+  staticMeta_default as default,
+  dexs
+};

package/dist/staticMeta-GM7T3OYL.mjs

@@ -0,0 +1,23 @@
+import "./chunk-4UEJOM6W.mjs";
+
+// lib/meta/data/testnet/staticMeta.json
+var coins = {
+  "rrrrr:BTC": {
+    displayName: "BTCe"
+  }
+};
+var dexs = {
+  rrrrr: {
+    displayName: "Hyena",
+    accountName: "USDe"
+  }
+};
+var staticMeta_default = {
+  coins,
+  dexs
+};
+export {
+  coins,
+  staticMeta_default as default,
+  dexs
+};

package/dist/staticMeta-OKNVBUQ5.mjs

@@ -0,0 +1,25 @@
+import "./chunk-4UEJOM6W.mjs";
+
+// lib/meta/data/mainnet/staticMeta.json
+var coins = {
+  "xyz:XYZ100": {
+    imageUrl: "https://app.based.one/hip3/xyz/xyz100.webp",
+    displayName: "Nasdaq-100"
+  }
+};
+var dexs = {
+  xyz: {
+    imageUrl: "",
+    displayName: "Trade.xyz",
+    tags: ["Equities"]
+  }
+};
+var staticMeta_default = {
+  coins,
+  dexs
+};
+export {
+  coins,
+  staticMeta_default as default,
+  dexs
+};

package/dist/staticMeta-QV2KMX57.mjs

@@ -0,0 +1,25 @@
+import "./chunk-4UEJOM6W.mjs";
+
+// lib/meta/data/mainnet/staticMeta.json
+var coins = {
+  "xyz:XYZ100": {
+    imageUrl: "https://app.based.one/hip3/xyz/xyz100.webp",
+    displayName: "Nasdaq-100"
+  }
+};
+var dexs = {
+  xyz: {
+    imageUrl: "",
+    displayName: "Trade.xyz",
+    accountName: "Equities"
+  }
+};
+var staticMeta_default = {
+  coins,
+  dexs
+};
+export {
+  coins,
+  staticMeta_default as default,
+  dexs
+};

package/lib/meta/data/mainnet/staticMeta.json

@@ -8,7 +8,8 @@
     "dexs": {
         "xyz": {
             "imageUrl": "",
-            "displayName": "Stocks"
+            "displayName": "Trade.xyz",
+            "accountName": "Equities"
         }
     }
 }

package/lib/meta/data/testnet/staticMeta.json

@@ -6,7 +6,8 @@
     },
     "dexs": {
         "rrrrr": {
-            "displayName": "Hyena"
+            "displayName": "Hyena",
+            "accountName": "USDe"
         }
     }
 }

package/lib/meta/metadata.ts

@@ -58,6 +58,7 @@ export interface DexInfo {
   collateralTokenSymbol: string;
   displayName?: string; // Display name override for the DEX
   imageUrl?: string; // Image URL override for the DEX
+  accountName?: string; // Account name override for the DEX
 }
 
 export type ExtendedPerpsMeta = PerpsMeta & {
@@ -89,6 +90,7 @@ interface StaticMetadata {
     [dexName: string]: {
       displayName?: string;
       imageUrl?: string;
+      accountName?: string;
     };
   };
 }
@@ -158,6 +160,7 @@ export class MetadataClient {
 
   // Lazy init flag
   private initialized: boolean = false;
+  private initializing: Promise<void> | null = null;
 
   constructor(config: MetadataClientConfig = {}) {
     const transport = new HttpTransport({
@@ -178,58 +181,65 @@ export class MetadataClient {
    */
   async initialize(): Promise<void> {
     if (this.initialized) return;
+    if (this.initializing) return this.initializing;
+    this.initializing = new Promise(async (resolve, reject) => {
+      // Always load staticMeta.json regardless of config.useStaticFallback
+      await this.loadStaticMetaOverrides();
 
-    // Always load staticMeta.json regardless of config.useStaticFallback
-    await this.loadStaticMetaOverrides();
-
-    if (this.config.onlyUseStaticFallback) {
-      await this.loadStaticMetadata();
-      this.buildLookupMaps();
+      if (this.config.onlyUseStaticFallback) {
+        await this.loadStaticMetadata();
+        this.buildLookupMaps();
 
-      // Fetch HIP-3 metadata if configured
-      if (this.config.hip3Dexs && this.config.hip3Dexs.length > 0) {
-        await Promise.all(
-          this.config.hip3Dexs.map((dex) => this.loadHip3Metadata(dex)),
-        );
+        // Fetch HIP-3 metadata if configured
+        if (this.config.hip3Dexs && this.config.hip3Dexs.length > 0) {
+          await Promise.all(
+            this.config.hip3Dexs.map((dex) => this.loadHip3Metadata(dex)),
+          );
+        }
+        resolve();
+        this.initialized = true;
+        return;
       }
 
-      this.initialized = true;
-      return;
-    }
-
-    try {
-      // Fetch core metadata from API
-      [this.spotMeta, this.perpsMeta, this.perpDexs] = await Promise.all([
-        this.infoClient.spotMeta(),
-        this.infoClient.meta(),
-        this.infoClient.perpDexs() as Promise<PerpDex[] | null[]>,
-      ]);
-
-      // Build optimized lookup maps
-      this.buildLookupMaps();
-
-      // Fetch HIP-3 metadata if configured
-      if (this.config.hip3Dexs && this.config.hip3Dexs.length > 0) {
-        await Promise.all(
-          this.config.hip3Dexs.map((dex) => this.loadHip3Metadata(dex)),
-        );
-      }
+      try {
+        // Fetch core metadata from API
+        [this.spotMeta, this.perpsMeta, this.perpDexs] = await Promise.all([
+          this.infoClient.spotMeta(),
+          this.infoClient.meta(),
+          this.infoClient.perpDexs() as Promise<PerpDex[] | null[]>,
+        ]);
 
-      this.initialized = true;
-    } catch (error) {
-      // Fall back to static data if API fetch fails and fallback is enabled
-      if (this.config.useStaticFallback) {
-        console.warn(
-          "Failed to fetch metadata from API, using static fallback data",
-          error,
-        );
-        await this.loadStaticMetadata();
+        // Build optimized lookup maps
         this.buildLookupMaps();
+
+        // Fetch HIP-3 metadata if configured
+        if (this.config.hip3Dexs && this.config.hip3Dexs.length > 0) {
+          await Promise.all(
+            this.config.hip3Dexs.map((dex) => this.loadHip3Metadata(dex)),
+          );
+        }
         this.initialized = true;
-      } else {
-        throw error;
+        resolve();
+      } catch (error) {
+        // Fall back to static data if API fetch fails and fallback is enabled
+        if (this.config.useStaticFallback) {
+          console.warn(
+            "Failed to fetch metadata from API, using static fallback data",
+            error,
+          );
+          await this.loadStaticMetadata();
+          this.buildLookupMaps();
+          this.initialized = true;
+          resolve();
+        } else {
+          reject(error);
+        }
+      } finally {
+        this.initialized = true;
+        resolve();
       }
-    }
+    });
+    return this.initializing;
   }
 
   /**
@@ -293,10 +303,16 @@ export class MetadataClient {
     this.spotPairToMarket.clear();
     this.baseTokenToMarkets.clear();
     this.coinToMarket.clear();
-    this.hip3SymbolToMarket.clear();
     this.dexNameToIndex.clear();
     this.quoteAssets = [];
 
+    console.info(
+      "[MetadataClient] Building lookup maps",
+      this.perpDexs,
+      this.perpsMeta,
+      this.spotMeta,
+    );
+
     // Build dex name to index map
     if (this.perpDexs) {
       this.perpDexs.forEach((dex, index) => {
@@ -457,6 +473,9 @@ export class MetadataClient {
         if (staticDexOverrides.imageUrl) {
           dexInfo.imageUrl = staticDexOverrides.imageUrl;
         }
+        if (staticDexOverrides.accountName) {
+          dexInfo.accountName = staticDexOverrides.accountName;
+        }
       }
 
       this.hip3DexsMeta.set(dexName, dexInfo);
@@ -502,6 +521,8 @@ export class MetadataClient {
         }
       }
 
+      console.info("[MetadataClient] caching market", symbol, marketInfo);
+
       this.coinToMarket.set(symbol, marketInfo);
       this.hip3SymbolToMarket.set(symbol, marketInfo);
     });
@@ -624,6 +645,7 @@ export class MetadataClient {
     // Try O(1) lookup first (if DEX metadata already loaded)
     let cachedMarket = this.hip3SymbolToMarket.get(symbol);
     if (cachedMarket) return cachedMarket;
+    console.warn("Missing market", symbol, this.hip3SymbolToMarket);
 
     // If not found, check if we need to load DEX metadata
     const dexMeta = this.hip3DexsMeta.get(dexName);
@@ -701,6 +723,8 @@ export class MetadataClient {
       perpsMeta: this.perpsMeta,
       perpDexs: this.perpDexs,
       hip3DexsMeta: Object.fromEntries(this.hip3DexsMeta),
+      coinToMarket: Object.fromEntries(this.coinToMarket),
+      hip3SymbolToMarket: Object.fromEntries(this.hip3SymbolToMarket),
     };
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@basedone/core",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "Core utilities for Based One",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",