@basedone/core 0.1.4 → 0.1.6

package/dist/index.d.mts

@@ -471,6 +471,18 @@ declare const formatPriceForOrder: ({ px, szDecimals, isSpot, }: {
     szDecimals: number;
     isSpot: boolean;
 }) => number;
+/**
+ * Formats price for order placement following Hyperliquid rules
+ * - Rounded to priceDecimals of the asset
+ * @param px - The price to format
+ * @param priceDecimals - Price decimals for the asset
+ * @returns Formatted price as number (rounded to priceDecimals if exceeds)
+ */
+declare const formatPriceForDisplay: ({ px, szDecimals, isSpot, }: {
+    px: number;
+    szDecimals: number;
+    isSpot: boolean;
+}) => string;
 /**
  * Formats size for order placement following Hyperliquid rules
  * - Rounded to szDecimals of the asset
@@ -482,6 +494,17 @@ declare const formatSizeForOrder: ({ sz, szDecimals, }: {
     sz: number;
     szDecimals: number;
 }) => number;
+/**
+ * Formats size for order placement following Hyperliquid rules
+ * - Rounded to szDecimals of the asset
+ * @param sz - The size to format
+ * @param szDecimals - Size decimals for the asset
+ * @returns Formatted size as number (rounded down to szDecimals if exceeds)
+ */
+declare const formatSizeForDisplay: ({ sz, szDecimals, }: {
+    sz: number;
+    szDecimals: number;
+}) => string;
 /**
  * Get minimum price decimals for tick size calculations
  * Uses the same logic as internal price formatting
@@ -498,7 +521,7 @@ declare const formatSizeForOrder: ({ sz, szDecimals, }: {
  */
 declare function getPriceDecimals(price: number, szDecimals: number, isSpot: boolean): number;
 
-declare function isHip3Symbol(symbol: string): boolean;
+declare function isHip3Symbol(symbol: string | undefined): boolean;
 declare function getHip3Dex(symbol: string): string | null;
 /**
  * Enable HIP-3 DEX abstraction with the current agent wallet
@@ -521,5 +544,24 @@ declare const UserDexAbstractionTypes: {
  */
 declare function setHip3DexAbstraction(client: ExchangeClient, enabled: boolean, user: string): Promise<SuccessResponse>;
 declare function getHip3DexAbstraction(client: InfoClient, user: string): Promise<boolean | null>;
+declare const isSpotSymbol: (coin: string | undefined) => boolean;
+declare function getStaticCollateralTokenByDex(dex: string): string;
+/**
+ * Get static collateral token symbol for a given coin
+ * @param coin - The coin symbol to get the collateral token symbol for eg. xyz:XYZ100
+ * @returns The collateral token symbol for the given coin
+ */
+declare function getStaticCollateralTokenSymbol(coin: string | undefined): string;
+/**
+ * Get display market symbol for a given coin
+ * @param coin - The coin symbol to get the display market symbol for eg. xyz:XYZ100
+ * @param showCollateralTokenSymbol - Whether to show the collateral token symbol. Default is true.
+ * @returns
+ * HIP-3 symbol: The display market symbol for the given coin eg. XYZ100-USDC, BTC-USDE, etc.
+ * If showCollateralTokenSymbol is false, returns the symbol without the collateral token symbol. eg. rrrrr:BTC -> BTC, hyena:BTC -> BTC
+ * Spot symbol: returns the coin argument itself
+ */
+declare function getDisplayMarketSymbol(coin: string | undefined, showCollateralTokenSymbol?: boolean, collateralTokenSymbol?: string): string | undefined;
+declare function getDexFromCollateralTokenSymbol(collateralTokenSymbol: string): string | undefined;
 
-export { type AirdropAllocationData, CloidClientCode, type CloidClientCodeId, CloidClientCodeNameById, type CloidData, type DexInfo, type ExtendedPerpsMeta, type MarketInfo, MetadataClient, PUP_TOKEN_ADDRESS, PUP_TOKEN_THRESHOLDS, type PerpDex, type PupEligibilityResult, ROOT_DEX, TARGET_APPROVED_MAX_BUILDER_FEE, TARGET_APPROVED_MAX_BUILDER_FEE_PERCENT, TESTNET_USDC_SPOT_TOKEN, type TokenInfo, USDC_SPOT_TOKEN, type UpheavalApiResponse, type UpheavalPosition, type UpheavalSnapshot, UserDexAbstractionTypes, type V3LPTokenInfo, WidgetType, WidgetTypeById, type WidgetTypeId, XP_BOOST_PERCENTAGES, buildCloid, calculateBoostPercentage, calculateTotalPupAmount, decodeSlug, enableHip3DexAbstractionWithAgent, encodeSlug, formatPriceAndSize, formatPriceForOrder, formatSizeForOrder, getApprovalAmount, getClientCodeNameById, getCloid, getHip3Dex, getHip3DexAbstraction, getNextTierInfo, getPriceDecimals, getWidgetTypeById, isBasedCloid, isClientCode, isHip3Symbol, isMiniAppCloid, isMiniAppTriggeredCloid, isTenantCloid, isTrackingIdCloid, isWidgetType, normaliseSlug, normaliseTrackingId, normalizeAirdropAmount, parseCloid, setHip3DexAbstraction };
+export { type AirdropAllocationData, CloidClientCode, type CloidClientCodeId, CloidClientCodeNameById, type CloidData, type DexInfo, type ExtendedPerpsMeta, type MarketInfo, MetadataClient, PUP_TOKEN_ADDRESS, PUP_TOKEN_THRESHOLDS, type PerpDex, type PupEligibilityResult, ROOT_DEX, TARGET_APPROVED_MAX_BUILDER_FEE, TARGET_APPROVED_MAX_BUILDER_FEE_PERCENT, TESTNET_USDC_SPOT_TOKEN, type TokenInfo, USDC_SPOT_TOKEN, type UpheavalApiResponse, type UpheavalPosition, type UpheavalSnapshot, UserDexAbstractionTypes, type V3LPTokenInfo, WidgetType, WidgetTypeById, type WidgetTypeId, XP_BOOST_PERCENTAGES, buildCloid, calculateBoostPercentage, calculateTotalPupAmount, decodeSlug, enableHip3DexAbstractionWithAgent, encodeSlug, formatPriceAndSize, formatPriceForDisplay, formatPriceForOrder, formatSizeForDisplay, formatSizeForOrder, getApprovalAmount, getClientCodeNameById, getCloid, getDexFromCollateralTokenSymbol, getDisplayMarketSymbol, getHip3Dex, getHip3DexAbstraction, getNextTierInfo, getPriceDecimals, getStaticCollateralTokenByDex, getStaticCollateralTokenSymbol, getWidgetTypeById, isBasedCloid, isClientCode, isHip3Symbol, isMiniAppCloid, isMiniAppTriggeredCloid, isSpotSymbol, isTenantCloid, isTrackingIdCloid, isWidgetType, normaliseSlug, normaliseTrackingId, normalizeAirdropAmount, parseCloid, setHip3DexAbstraction };

package/dist/index.d.ts

@@ -471,6 +471,18 @@ declare const formatPriceForOrder: ({ px, szDecimals, isSpot, }: {
     szDecimals: number;
     isSpot: boolean;
 }) => number;
+/**
+ * Formats price for order placement following Hyperliquid rules
+ * - Rounded to priceDecimals of the asset
+ * @param px - The price to format
+ * @param priceDecimals - Price decimals for the asset
+ * @returns Formatted price as number (rounded to priceDecimals if exceeds)
+ */
+declare const formatPriceForDisplay: ({ px, szDecimals, isSpot, }: {
+    px: number;
+    szDecimals: number;
+    isSpot: boolean;
+}) => string;
 /**
  * Formats size for order placement following Hyperliquid rules
  * - Rounded to szDecimals of the asset
@@ -482,6 +494,17 @@ declare const formatSizeForOrder: ({ sz, szDecimals, }: {
     sz: number;
     szDecimals: number;
 }) => number;
+/**
+ * Formats size for order placement following Hyperliquid rules
+ * - Rounded to szDecimals of the asset
+ * @param sz - The size to format
+ * @param szDecimals - Size decimals for the asset
+ * @returns Formatted size as number (rounded down to szDecimals if exceeds)
+ */
+declare const formatSizeForDisplay: ({ sz, szDecimals, }: {
+    sz: number;
+    szDecimals: number;
+}) => string;
 /**
  * Get minimum price decimals for tick size calculations
  * Uses the same logic as internal price formatting
@@ -498,7 +521,7 @@ declare const formatSizeForOrder: ({ sz, szDecimals, }: {
  */
 declare function getPriceDecimals(price: number, szDecimals: number, isSpot: boolean): number;
 
-declare function isHip3Symbol(symbol: string): boolean;
+declare function isHip3Symbol(symbol: string | undefined): boolean;
 declare function getHip3Dex(symbol: string): string | null;
 /**
  * Enable HIP-3 DEX abstraction with the current agent wallet
@@ -521,5 +544,24 @@ declare const UserDexAbstractionTypes: {
  */
 declare function setHip3DexAbstraction(client: ExchangeClient, enabled: boolean, user: string): Promise<SuccessResponse>;
 declare function getHip3DexAbstraction(client: InfoClient, user: string): Promise<boolean | null>;
+declare const isSpotSymbol: (coin: string | undefined) => boolean;
+declare function getStaticCollateralTokenByDex(dex: string): string;
+/**
+ * Get static collateral token symbol for a given coin
+ * @param coin - The coin symbol to get the collateral token symbol for eg. xyz:XYZ100
+ * @returns The collateral token symbol for the given coin
+ */
+declare function getStaticCollateralTokenSymbol(coin: string | undefined): string;
+/**
+ * Get display market symbol for a given coin
+ * @param coin - The coin symbol to get the display market symbol for eg. xyz:XYZ100
+ * @param showCollateralTokenSymbol - Whether to show the collateral token symbol. Default is true.
+ * @returns
+ * HIP-3 symbol: The display market symbol for the given coin eg. XYZ100-USDC, BTC-USDE, etc.
+ * If showCollateralTokenSymbol is false, returns the symbol without the collateral token symbol. eg. rrrrr:BTC -> BTC, hyena:BTC -> BTC
+ * Spot symbol: returns the coin argument itself
+ */
+declare function getDisplayMarketSymbol(coin: string | undefined, showCollateralTokenSymbol?: boolean, collateralTokenSymbol?: string): string | undefined;
+declare function getDexFromCollateralTokenSymbol(collateralTokenSymbol: string): string | undefined;
 
-export { type AirdropAllocationData, CloidClientCode, type CloidClientCodeId, CloidClientCodeNameById, type CloidData, type DexInfo, type ExtendedPerpsMeta, type MarketInfo, MetadataClient, PUP_TOKEN_ADDRESS, PUP_TOKEN_THRESHOLDS, type PerpDex, type PupEligibilityResult, ROOT_DEX, TARGET_APPROVED_MAX_BUILDER_FEE, TARGET_APPROVED_MAX_BUILDER_FEE_PERCENT, TESTNET_USDC_SPOT_TOKEN, type TokenInfo, USDC_SPOT_TOKEN, type UpheavalApiResponse, type UpheavalPosition, type UpheavalSnapshot, UserDexAbstractionTypes, type V3LPTokenInfo, WidgetType, WidgetTypeById, type WidgetTypeId, XP_BOOST_PERCENTAGES, buildCloid, calculateBoostPercentage, calculateTotalPupAmount, decodeSlug, enableHip3DexAbstractionWithAgent, encodeSlug, formatPriceAndSize, formatPriceForOrder, formatSizeForOrder, getApprovalAmount, getClientCodeNameById, getCloid, getHip3Dex, getHip3DexAbstraction, getNextTierInfo, getPriceDecimals, getWidgetTypeById, isBasedCloid, isClientCode, isHip3Symbol, isMiniAppCloid, isMiniAppTriggeredCloid, isTenantCloid, isTrackingIdCloid, isWidgetType, normaliseSlug, normaliseTrackingId, normalizeAirdropAmount, parseCloid, setHip3DexAbstraction };
+export { type AirdropAllocationData, CloidClientCode, type CloidClientCodeId, CloidClientCodeNameById, type CloidData, type DexInfo, type ExtendedPerpsMeta, type MarketInfo, MetadataClient, PUP_TOKEN_ADDRESS, PUP_TOKEN_THRESHOLDS, type PerpDex, type PupEligibilityResult, ROOT_DEX, TARGET_APPROVED_MAX_BUILDER_FEE, TARGET_APPROVED_MAX_BUILDER_FEE_PERCENT, TESTNET_USDC_SPOT_TOKEN, type TokenInfo, USDC_SPOT_TOKEN, type UpheavalApiResponse, type UpheavalPosition, type UpheavalSnapshot, UserDexAbstractionTypes, type V3LPTokenInfo, WidgetType, WidgetTypeById, type WidgetTypeId, XP_BOOST_PERCENTAGES, buildCloid, calculateBoostPercentage, calculateTotalPupAmount, decodeSlug, enableHip3DexAbstractionWithAgent, encodeSlug, formatPriceAndSize, formatPriceForDisplay, formatPriceForOrder, formatSizeForDisplay, formatSizeForOrder, getApprovalAmount, getClientCodeNameById, getCloid, getDexFromCollateralTokenSymbol, getDisplayMarketSymbol, getHip3Dex, getHip3DexAbstraction, getNextTierInfo, getPriceDecimals, getStaticCollateralTokenByDex, getStaticCollateralTokenSymbol, getWidgetTypeById, isBasedCloid, isClientCode, isHip3Symbol, isMiniAppCloid, isMiniAppTriggeredCloid, isSpotSymbol, isTenantCloid, isTrackingIdCloid, isWidgetType, normaliseSlug, normaliseTrackingId, normalizeAirdropAmount, parseCloid, setHip3DexAbstraction };

package/dist/index.js

@@ -37039,21 +37039,28 @@ __export(index_exports, {
   enableHip3DexAbstractionWithAgent: () => enableHip3DexAbstractionWithAgent,
   encodeSlug: () => encodeSlug,
   formatPriceAndSize: () => formatPriceAndSize,
+  formatPriceForDisplay: () => formatPriceForDisplay,
   formatPriceForOrder: () => formatPriceForOrder,
+  formatSizeForDisplay: () => formatSizeForDisplay,
   formatSizeForOrder: () => formatSizeForOrder,
   getApprovalAmount: () => getApprovalAmount,
   getClientCodeNameById: () => getClientCodeNameById,
   getCloid: () => getCloid,
+  getDexFromCollateralTokenSymbol: () => getDexFromCollateralTokenSymbol,
+  getDisplayMarketSymbol: () => getDisplayMarketSymbol,
   getHip3Dex: () => getHip3Dex,
   getHip3DexAbstraction: () => getHip3DexAbstraction,
   getNextTierInfo: () => getNextTierInfo,
   getPriceDecimals: () => getPriceDecimals,
+  getStaticCollateralTokenByDex: () => getStaticCollateralTokenByDex,
+  getStaticCollateralTokenSymbol: () => getStaticCollateralTokenSymbol,
   getWidgetTypeById: () => getWidgetTypeById,
   isBasedCloid: () => isBasedCloid,
   isClientCode: () => isClientCode,
   isHip3Symbol: () => isHip3Symbol,
   isMiniAppCloid: () => isMiniAppCloid,
   isMiniAppTriggeredCloid: () => isMiniAppTriggeredCloid,
+  isSpotSymbol: () => isSpotSymbol,
   isTenantCloid: () => isTenantCloid,
   isTrackingIdCloid: () => isTrackingIdCloid,
   isWidgetType: () => isWidgetType,
@@ -37663,6 +37670,39 @@ async function getHip3DexAbstraction(client, user) {
     user
   });
 }
+var dexToCollateralTokenSymbol = {
+  rrrrr: "USDEEE",
+  hyena: "USDE"
+};
+var isSpotSymbol = (coin) => {
+  if (!coin) return false;
+  return coin.includes("/") || coin.includes("@");
+};
+function getStaticCollateralTokenByDex(dex) {
+  return dexToCollateralTokenSymbol[dex] ?? "USDC";
+}
+function getStaticCollateralTokenSymbol(coin) {
+  if (!coin) return "USDC";
+  if (!isHip3Symbol(coin)) return "USDC";
+  const dex = getHip3Dex(coin);
+  if (!dex) return "USDC";
+  return getStaticCollateralTokenByDex(dex);
+}
+function getDisplayMarketSymbol(coin, showCollateralTokenSymbol = true, collateralTokenSymbol) {
+  if (!coin || isSpotSymbol(coin)) return coin;
+  if (isHip3Symbol(coin)) {
+    const [_, symbol] = coin.split(":");
+    if (!showCollateralTokenSymbol) return symbol;
+    return `${symbol}-${collateralTokenSymbol ?? getStaticCollateralTokenSymbol(coin)}`;
+  }
+  if (!showCollateralTokenSymbol) return coin;
+  return `${coin}-USDC`;
+}
+function getDexFromCollateralTokenSymbol(collateralTokenSymbol) {
+  return Object.keys(dexToCollateralTokenSymbol).find(
+    (dex) => dexToCollateralTokenSymbol[dex] === collateralTokenSymbol
+  );
+}
 
 // import("./data/**/*/staticMeta.json") in lib/meta/metadata.ts
 var globImport_data_staticMeta_json = __glob({
@@ -37735,6 +37775,9 @@ var MetadataClient = class {
     if (this.initialized) return;
     if (this.initializing) return this.initializing;
     this.initializing = new Promise(async (resolve, reject) => {
+      if (this.config.debug) {
+        console.info("[MetadataClient] Initializing...", this.config);
+      }
       await this.loadStaticMetaOverrides();
       if (this.config.onlyUseStaticFallback) {
         await this.loadStaticMetadata();
@@ -37754,6 +37797,14 @@ var MetadataClient = class {
           this.infoClient.meta(),
           this.infoClient.perpDexs()
         ]);
+        if (this.config.debug) {
+          console.info(
+            "[MetadataClient] Core metadata",
+            this.spotMeta,
+            this.perpsMeta,
+            this.perpDexs
+          );
+        }
         this.buildLookupMaps();
         if (this.config.hip3Dexs && this.config.hip3Dexs.length > 0) {
           await Promise.all(
@@ -37761,6 +37812,9 @@ var MetadataClient = class {
           );
         }
         this.initialized = true;
+        if (this.config.debug) {
+          console.info("[MetadataClient] Initialized");
+        }
         resolve();
       } catch (error) {
         if (this.config.useStaticFallback) {
@@ -37791,6 +37845,12 @@ var MetadataClient = class {
     try {
       const staticMetaModule = await globImport_data_staticMeta_json(`./data/${network}/staticMeta.json`);
       this.staticMeta = staticMetaModule.default;
+      if (this.config.debug) {
+        console.info(
+          "[MetadataClient] Loaded static metadata overrides",
+          this.staticMeta
+        );
+      }
     } catch (error) {
       console.warn(`Failed to load staticMeta.json for ${network}:`, error);
       this.staticMeta = null;
@@ -37817,7 +37877,7 @@ var MetadataClient = class {
       this.perpsMeta = perpsMetaModule.default;
       this.perpDexs = perpDexsModule.default;
       this.staticMeta = staticMetaModule.default;
-      console.warn(`Using static ${network} metadata`);
+      console.warn(`[MetadataClient] Using static ${network} metadata`);
     } catch (error) {
       console.error(`Failed to load static ${network} metadata:`, error);
       throw new Error(`Could not load metadata for ${network}`);
@@ -37924,6 +37984,14 @@ var MetadataClient = class {
       const [meta, contexts] = await this.infoClient.metaAndAssetCtxs({
         dex: dexName
       });
+      if (this.config.debug) {
+        console.info(
+          "[MetadataClient] Loaded HIP-3 metadata",
+          dexName,
+          meta,
+          contexts
+        );
+      }
       let dexIndex = this.dexNameToIndex.get(dexName.toLowerCase());
       if (dexIndex === void 0) {
         dexIndex = this.perpDexs.findIndex(
@@ -38185,12 +38253,34 @@ var formatPriceForOrder = ({
   const price = new import_decimal.Decimal(px).toDP(priceDecimals).toNumber();
   return price;
 };
+var formatPriceForDisplay = ({
+  px,
+  szDecimals,
+  isSpot
+}) => {
+  const priceDecimals = getPriceDecimals(px, szDecimals, isSpot);
+  return new Intl.NumberFormat("en-US", {
+    style: "decimal",
+    minimumFractionDigits: priceDecimals,
+    maximumFractionDigits: priceDecimals
+  }).format(px);
+};
 var formatSizeForOrder = ({
   sz,
   szDecimals
 }) => {
   return new import_decimal.Decimal(sz).toDP(szDecimals, import_decimal.Decimal.ROUND_DOWN).toNumber();
 };
+var formatSizeForDisplay = ({
+  sz,
+  szDecimals
+}) => {
+  return new Intl.NumberFormat("en-US", {
+    style: "decimal",
+    minimumFractionDigits: szDecimals,
+    maximumFractionDigits: szDecimals
+  }).format(sz);
+};
 function getPriceDecimals(price, szDecimals, isSpot) {
   const baseDecimals = isSpot ? 8 : 6;
   const maxDP = Math.max(baseDecimals - szDecimals, 0);
@@ -38228,21 +38318,28 @@ function getPriceDecimals(price, szDecimals, isSpot) {
   enableHip3DexAbstractionWithAgent,
   encodeSlug,
   formatPriceAndSize,
+  formatPriceForDisplay,
   formatPriceForOrder,
+  formatSizeForDisplay,
   formatSizeForOrder,
   getApprovalAmount,
   getClientCodeNameById,
   getCloid,
+  getDexFromCollateralTokenSymbol,
+  getDisplayMarketSymbol,
   getHip3Dex,
   getHip3DexAbstraction,
   getNextTierInfo,
   getPriceDecimals,
+  getStaticCollateralTokenByDex,
+  getStaticCollateralTokenSymbol,
   getWidgetTypeById,
   isBasedCloid,
   isClientCode,
   isHip3Symbol,
   isMiniAppCloid,
   isMiniAppTriggeredCloid,
+  isSpotSymbol,
   isTenantCloid,
   isTrackingIdCloid,
   isWidgetType,

package/dist/index.mjs

@@ -606,6 +606,39 @@ async function getHip3DexAbstraction(client, user) {
     user
   });
 }
+var dexToCollateralTokenSymbol = {
+  rrrrr: "USDEEE",
+  hyena: "USDE"
+};
+var isSpotSymbol = (coin) => {
+  if (!coin) return false;
+  return coin.includes("/") || coin.includes("@");
+};
+function getStaticCollateralTokenByDex(dex) {
+  return dexToCollateralTokenSymbol[dex] ?? "USDC";
+}
+function getStaticCollateralTokenSymbol(coin) {
+  if (!coin) return "USDC";
+  if (!isHip3Symbol(coin)) return "USDC";
+  const dex = getHip3Dex(coin);
+  if (!dex) return "USDC";
+  return getStaticCollateralTokenByDex(dex);
+}
+function getDisplayMarketSymbol(coin, showCollateralTokenSymbol = true, collateralTokenSymbol) {
+  if (!coin || isSpotSymbol(coin)) return coin;
+  if (isHip3Symbol(coin)) {
+    const [_, symbol] = coin.split(":");
+    if (!showCollateralTokenSymbol) return symbol;
+    return `${symbol}-${collateralTokenSymbol ?? getStaticCollateralTokenSymbol(coin)}`;
+  }
+  if (!showCollateralTokenSymbol) return coin;
+  return `${coin}-USDC`;
+}
+function getDexFromCollateralTokenSymbol(collateralTokenSymbol) {
+  return Object.keys(dexToCollateralTokenSymbol).find(
+    (dex) => dexToCollateralTokenSymbol[dex] === collateralTokenSymbol
+  );
+}
 
 // import("./data/**/*/staticMeta.json") in lib/meta/metadata.ts
 var globImport_data_staticMeta_json = __glob({
@@ -678,6 +711,9 @@ var MetadataClient = class {
     if (this.initialized) return;
     if (this.initializing) return this.initializing;
     this.initializing = new Promise(async (resolve, reject) => {
+      if (this.config.debug) {
+        console.info("[MetadataClient] Initializing...", this.config);
+      }
       await this.loadStaticMetaOverrides();
       if (this.config.onlyUseStaticFallback) {
         await this.loadStaticMetadata();
@@ -697,6 +733,14 @@ var MetadataClient = class {
           this.infoClient.meta(),
           this.infoClient.perpDexs()
         ]);
+        if (this.config.debug) {
+          console.info(
+            "[MetadataClient] Core metadata",
+            this.spotMeta,
+            this.perpsMeta,
+            this.perpDexs
+          );
+        }
         this.buildLookupMaps();
         if (this.config.hip3Dexs && this.config.hip3Dexs.length > 0) {
           await Promise.all(
@@ -704,6 +748,9 @@ var MetadataClient = class {
           );
         }
         this.initialized = true;
+        if (this.config.debug) {
+          console.info("[MetadataClient] Initialized");
+        }
         resolve();
       } catch (error) {
         if (this.config.useStaticFallback) {
@@ -734,6 +781,12 @@ var MetadataClient = class {
     try {
       const staticMetaModule = await globImport_data_staticMeta_json(`./data/${network}/staticMeta.json`);
       this.staticMeta = staticMetaModule.default;
+      if (this.config.debug) {
+        console.info(
+          "[MetadataClient] Loaded static metadata overrides",
+          this.staticMeta
+        );
+      }
     } catch (error) {
       console.warn(`Failed to load staticMeta.json for ${network}:`, error);
       this.staticMeta = null;
@@ -760,7 +813,7 @@ var MetadataClient = class {
       this.perpsMeta = perpsMetaModule.default;
       this.perpDexs = perpDexsModule.default;
       this.staticMeta = staticMetaModule.default;
-      console.warn(`Using static ${network} metadata`);
+      console.warn(`[MetadataClient] Using static ${network} metadata`);
     } catch (error) {
       console.error(`Failed to load static ${network} metadata:`, error);
       throw new Error(`Could not load metadata for ${network}`);
@@ -867,6 +920,14 @@ var MetadataClient = class {
       const [meta, contexts] = await this.infoClient.metaAndAssetCtxs({
         dex: dexName
       });
+      if (this.config.debug) {
+        console.info(
+          "[MetadataClient] Loaded HIP-3 metadata",
+          dexName,
+          meta,
+          contexts
+        );
+      }
       let dexIndex = this.dexNameToIndex.get(dexName.toLowerCase());
       if (dexIndex === void 0) {
         dexIndex = this.perpDexs.findIndex(
@@ -1128,12 +1189,34 @@ var formatPriceForOrder = ({
   const price = new Decimal(px).toDP(priceDecimals).toNumber();
   return price;
 };
+var formatPriceForDisplay = ({
+  px,
+  szDecimals,
+  isSpot
+}) => {
+  const priceDecimals = getPriceDecimals(px, szDecimals, isSpot);
+  return new Intl.NumberFormat("en-US", {
+    style: "decimal",
+    minimumFractionDigits: priceDecimals,
+    maximumFractionDigits: priceDecimals
+  }).format(px);
+};
 var formatSizeForOrder = ({
   sz,
   szDecimals
 }) => {
   return new Decimal(sz).toDP(szDecimals, Decimal.ROUND_DOWN).toNumber();
 };
+var formatSizeForDisplay = ({
+  sz,
+  szDecimals
+}) => {
+  return new Intl.NumberFormat("en-US", {
+    style: "decimal",
+    minimumFractionDigits: szDecimals,
+    maximumFractionDigits: szDecimals
+  }).format(sz);
+};
 function getPriceDecimals(price, szDecimals, isSpot) {
   const baseDecimals = isSpot ? 8 : 6;
   const maxDP = Math.max(baseDecimals - szDecimals, 0);
@@ -1170,21 +1253,28 @@ export {
   enableHip3DexAbstractionWithAgent,
   encodeSlug,
   formatPriceAndSize,
+  formatPriceForDisplay,
   formatPriceForOrder,
+  formatSizeForDisplay,
   formatSizeForOrder,
   getApprovalAmount,
   getClientCodeNameById,
   getCloid,
+  getDexFromCollateralTokenSymbol,
+  getDisplayMarketSymbol,
   getHip3Dex,
   getHip3DexAbstraction,
   getNextTierInfo,
   getPriceDecimals,
+  getStaticCollateralTokenByDex,
+  getStaticCollateralTokenSymbol,
   getWidgetTypeById,
   isBasedCloid,
   isClientCode,
   isHip3Symbol,
   isMiniAppCloid,
   isMiniAppTriggeredCloid,
+  isSpotSymbol,
   isTenantCloid,
   isTrackingIdCloid,
   isWidgetType,

package/lib/hip3/market-info.ts

@@ -1,25 +1,17 @@
-// static HIP-3 market info
+import { PerpsMeta, InfoClient } from "@nktkas/hyperliquid";
 
-import { SpotToken, PerpDex } from "@nktkas/hyperliquid";
-import { TESTNET_USDC_SPOT_TOKEN, USDC_SPOT_TOKEN } from "../constants/tokens";
-
-// currently /info type: perpDexs doesn't include collateral token
-interface HIP3DexInfo extends PerpDex {
-  collateralToken: SpotToken;
-}
-
-export const HIP3_DEX_INFO: Record<string, HIP3DexInfo> = {};
-
-const TESTNET_DEX_INFO: Record<string, HIP3DexInfo> = {
-  vtnls: {
-    collateralToken: TESTNET_USDC_SPOT_TOKEN,
-    name: "vntls",
-    full_name: "Ventuals",
-    deployer: "0xc65008a70f511ae0407d26022ff1516422acea94",
-    oracle_updater: null,
-  },
+export type PerpsMetaWithCollateralToken = PerpsMeta & {
+  collateralToken?: number; // spot token index
 };
 
-function getHIP3DexInfo(dex: string, isTestnet: boolean) {
-  return isTestnet ? TESTNET_DEX_INFO[dex] : HIP3_DEX_INFO[dex];
+export type AllPerpsMeta = PerpsMetaWithCollateralToken[];
+
+export async function getAllPerpsMeta(
+  infoClient: InfoClient,
+): Promise<AllPerpsMeta> {
+  return infoClient.transport.request<AllPerpsMeta>("info", {
+    action: {
+      type: "allPerpMetas",
+    },
+  });
 }

package/lib/hip3/utils.ts

@@ -8,7 +8,7 @@ import {
   signUserSignedAction,
 } from "@nktkas/hyperliquid/signing";
 
-export function isHip3Symbol(symbol: string) {
+export function isHip3Symbol(symbol: string | undefined) {
   if (!symbol) return false;
   return symbol.includes(":");
 }
@@ -96,3 +96,69 @@ export async function getHip3DexAbstraction(client: InfoClient, user: string) {
     user,
   });
 }
+
+const dexToCollateralTokenSymbol = {
+  rrrrr: "USDEEE",
+  hyena: "USDE",
+};
+
+export const isSpotSymbol = (coin: string | undefined) => {
+  if (!coin) return false;
+  return coin.includes("/") || coin.includes("@");
+};
+
+export function getStaticCollateralTokenByDex(dex: string) {
+  return (
+    dexToCollateralTokenSymbol[
+      dex as keyof typeof dexToCollateralTokenSymbol
+    ] ?? "USDC"
+  );
+}
+
+/**
+ * Get static collateral token symbol for a given coin
+ * @param coin - The coin symbol to get the collateral token symbol for eg. xyz:XYZ100
+ * @returns The collateral token symbol for the given coin
+ */
+export function getStaticCollateralTokenSymbol(coin: string | undefined) {
+  if (!coin) return "USDC";
+  if (!isHip3Symbol(coin)) return "USDC";
+  const dex = getHip3Dex(coin);
+  if (!dex) return "USDC";
+  return getStaticCollateralTokenByDex(dex);
+}
+
+/**
+ * Get display market symbol for a given coin
+ * @param coin - The coin symbol to get the display market symbol for eg. xyz:XYZ100
+ * @param showCollateralTokenSymbol - Whether to show the collateral token symbol. Default is true.
+ * @returns
+ * HIP-3 symbol: The display market symbol for the given coin eg. XYZ100-USDC, BTC-USDE, etc.
+ * If showCollateralTokenSymbol is false, returns the symbol without the collateral token symbol. eg. rrrrr:BTC -> BTC, hyena:BTC -> BTC
+ * Spot symbol: returns the coin argument itself
+ */
+export function getDisplayMarketSymbol(
+  coin: string | undefined,
+  showCollateralTokenSymbol: boolean = true,
+  collateralTokenSymbol?: string,
+) {
+  if (!coin || isSpotSymbol(coin)) return coin;
+
+  if (isHip3Symbol(coin)) {
+    const [_, symbol] = coin.split(":");
+    if (!showCollateralTokenSymbol) return symbol;
+    return `${symbol}-${collateralTokenSymbol ?? getStaticCollateralTokenSymbol(coin)}`;
+  }
+  if (!showCollateralTokenSymbol) return coin;
+
+  return `${coin}-USDC`;
+}
+
+export function getDexFromCollateralTokenSymbol(collateralTokenSymbol: string) {
+  return Object.keys(dexToCollateralTokenSymbol).find(
+    (dex) =>
+      dexToCollateralTokenSymbol[
+        dex as keyof typeof dexToCollateralTokenSymbol
+      ] === collateralTokenSymbol,
+  );
+}

package/lib/meta/metadata.ts

@@ -176,6 +176,7 @@ export class MetadataClient {
       useStaticFallback: config.useStaticFallback ?? true,
     };
     this.isTestnet = config.isTestnet ?? false;
+
     this.initialize();
   }
 
@@ -186,6 +187,9 @@ export class MetadataClient {
     if (this.initialized) return;
     if (this.initializing) return this.initializing;
     this.initializing = new Promise(async (resolve, reject) => {
+      if (this.config.debug) {
+        console.info("[MetadataClient] Initializing...", this.config);
+      }
       // Always load staticMeta.json regardless of config.useStaticFallback
       await this.loadStaticMetaOverrides();
 
@@ -212,6 +216,15 @@ export class MetadataClient {
           this.infoClient.perpDexs() as Promise<PerpDex[] | null[]>,
         ]);
 
+        if (this.config.debug) {
+          console.info(
+            "[MetadataClient] Core metadata",
+            this.spotMeta,
+            this.perpsMeta,
+            this.perpDexs,
+          );
+        }
+
         // Build optimized lookup maps
         this.buildLookupMaps();
 
@@ -222,6 +235,9 @@ export class MetadataClient {
           );
         }
         this.initialized = true;
+        if (this.config.debug) {
+          console.info("[MetadataClient] Initialized");
+        }
         resolve();
       } catch (error) {
         // Fall back to static data if API fetch fails and fallback is enabled
@@ -257,6 +273,12 @@ export class MetadataClient {
         `./data/${network}/staticMeta.json`
       );
       this.staticMeta = staticMetaModule.default as StaticMetadata;
+      if (this.config.debug) {
+        console.info(
+          "[MetadataClient] Loaded static metadata overrides",
+          this.staticMeta,
+        );
+      }
     } catch (error) {
       console.warn(`Failed to load staticMeta.json for ${network}:`, error);
       this.staticMeta = null;
@@ -288,7 +310,7 @@ export class MetadataClient {
       this.perpDexs = perpDexsModule.default as (PerpDex | null)[];
       this.staticMeta = staticMetaModule.default as StaticMetadata;
 
-      console.warn(`Using static ${network} metadata`);
+      console.warn(`[MetadataClient] Using static ${network} metadata`);
     } catch (error) {
       console.error(`Failed to load static ${network} metadata:`, error);
       throw new Error(`Could not load metadata for ${network}`);
@@ -436,6 +458,15 @@ export class MetadataClient {
         dex: dexName,
       });
 
+      if (this.config.debug) {
+        console.info(
+          "[MetadataClient] Loaded HIP-3 metadata",
+          dexName,
+          meta,
+          contexts,
+        );
+      }
+
       // O(1) lookup using pre-computed map
       let dexIndex = this.dexNameToIndex.get(dexName.toLowerCase());
 

package/lib/utils/formatter.ts

@@ -44,6 +44,31 @@ export const formatPriceForOrder = ({
   return price;
 };
 
+/**
+ * Formats price for order placement following Hyperliquid rules
+ * - Rounded to priceDecimals of the asset
+ * @param px - The price to format
+ * @param priceDecimals - Price decimals for the asset
+ * @returns Formatted price as number (rounded to priceDecimals if exceeds)
+ */
+export const formatPriceForDisplay = ({
+  px,
+  szDecimals,
+  isSpot,
+}: {
+  px: number;
+  szDecimals: number;
+  isSpot: boolean;
+}) => {
+  const priceDecimals = getPriceDecimals(px, szDecimals, isSpot);
+
+  return new Intl.NumberFormat("en-US", {
+    style: "decimal",
+    minimumFractionDigits: priceDecimals,
+    maximumFractionDigits: priceDecimals,
+  }).format(px);
+};
+
 /**
  * Formats size for order placement following Hyperliquid rules
  * - Rounded to szDecimals of the asset
@@ -61,6 +86,27 @@ export const formatSizeForOrder = ({
   return new Decimal(sz).toDP(szDecimals, Decimal.ROUND_DOWN).toNumber();
 };
 
+/**
+ * Formats size for order placement following Hyperliquid rules
+ * - Rounded to szDecimals of the asset
+ * @param sz - The size to format
+ * @param szDecimals - Size decimals for the asset
+ * @returns Formatted size as number (rounded down to szDecimals if exceeds)
+ */
+export const formatSizeForDisplay = ({
+  sz,
+  szDecimals,
+}: {
+  sz: number;
+  szDecimals: number;
+}) => {
+  return new Intl.NumberFormat("en-US", {
+    style: "decimal",
+    minimumFractionDigits: szDecimals,
+    maximumFractionDigits: szDecimals,
+  }).format(sz);
+};
+
 /**
  * Get minimum price decimals for tick size calculations
  * Uses the same logic as internal price formatting

package/package.json

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