@lifi/perps-sdk-provider-hyperliquid 4.2.0 → 4.3.1

package/dist/types/utils/assetLogo.d.ts

@@ -0,0 +1,20 @@
+import type { Asset } from '@lifi/perps-types';
+/** Token `name`s of the Unit-bridged HL spot assets. */
+export declare const UNIT_TOKEN_NAMES: ReadonlySet<string>;
+/** Return `asset` with its `logoURI` replaced when a display-symbol override exists. */
+export declare const applyLogoOverride: (asset: Asset) => Asset;
+/**
+ * Override-aware logo URI for a Hyperliquid spot token. Base rule is
+ * `coins/${name}_spot.svg`; a Unit-bridged token (`fullName` starts with
+ * "Unit") resolves to its underlying's icon instead; the override table wins
+ * over both.
+ *
+ * When `fullName` is absent — spot *balances* (`HlSpotBalance`) carry no
+ * `fullName` and this issue deliberately does not fetch `spotMeta` on the
+ * account path — the derivation degrades to the symbol-keyed override + base
+ * `_spot` rule, so a Unit-bridged balance uses the base rule rather than its
+ * underlying's icon. The registry path (which has `fullName`) keeps full Unit
+ * resolution.
+ */
+export declare const spotLogoURI: (name: string, fullName?: string | null) => string;
+//# sourceMappingURL=assetLogo.d.ts.map

package/dist/types/utils/assetLogo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assetLogo.d.ts","sourceRoot":"","sources":["../../../src/utils/assetLogo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAiD9C,wDAAwD;AACxD,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAEhD,CAAA;AAQD,wFAAwF;AACxF,eAAO,MAAM,iBAAiB,GAAI,OAAO,KAAK,KAAG,KAGhD,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,WAAW,MAAM,GAAG,IAAI,KAAG,MAKpE,CAAA"}

package/dist/types/utils/index.d.ts

@@ -1,4 +1,5 @@
 export { assetIsSpot, calculateAssetId, getProviderIndex } from './assetId.js';
+export { applyLogoOverride, spotLogoURI, UNIT_TOKEN_NAMES, } from './assetLogo.js';
 export { decodeCompressedJson, decodeFastAssetCtxs, } from './decodeFastAssetCtxs.js';
 export type { InfoRequestOptions } from './infoClient.js';
 export { hlInfoOptions, infoRequest } from './infoClient.js';

package/dist/types/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC9E,OAAO,EACL,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,0BAA0B,CAAA;AACjC,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,EACL,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EACL,cAAc,EACd,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,aAAa,GACd,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,qBAAqB,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC9E,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,gBAAgB,GACjB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,0BAA0B,CAAA;AACjC,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,EACL,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EACL,cAAc,EACd,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,aAAa,GACd,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,qBAAqB,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/types/utils/infoClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"infoClient.d.ts","sourceRoot":"","sources":["../../../src/utils/infoClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,mBAAmB,EAExB,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAA;AAIxB,gBAAgB;AAChB,eAAO,MAAM,0BAA0B,EAAE,mBAmBxC,CAAA;AAED,cAAc;AACd,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,MAAM,CAAC,EAAE,mBAAmB,CAAA;IAC5B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CACzB;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,cAAc,EACtB,UAAU,iBAAiB,KAC1B,kBAQD,CAAA;AAEF;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,CAAC,CAAC,CAqCZ"}
+{"version":3,"file":"infoClient.d.ts","sourceRoot":"","sources":["../../../src/utils/infoClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,mBAAmB,EAExB,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAA;AAuBxB,gBAAgB;AAChB,eAAO,MAAM,0BAA0B,EAAE,mBAmBxC,CAAA;AAED,cAAc;AACd,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,MAAM,CAAC,EAAE,mBAAmB,CAAA;IAC5B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CACzB;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,cAAc,EACtB,UAAU,iBAAiB,KAC1B,kBAQD,CAAA;AAEF;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,CAAC,CAAC,CAqCZ"}

package/dist/types/utils/mapMarket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapMarket.d.ts","sourceRoot":"","sources":["../../../src/utils/mapMarket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAQvD;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GACpB,UAAU,cAAc,EACxB,YAAY,MAAM,KACjB,WAWD,CAAA"}
+{"version":3,"file":"mapMarket.d.ts","sourceRoot":"","sources":["../../../src/utils/mapMarket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAQvD;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GACpB,UAAU,cAAc,EACxB,YAAY,MAAM,KACjB,WAcD,CAAA"}

package/dist/types/utils/marketDisplay.d.ts

@@ -1,9 +1,10 @@
 import type { Asset, Market } from '@lifi/perps-types';
 /**
- * Synthesise the {@link Asset} for a Hyperliquid wire coin. `id` and `logoURI`
- * keep the raw coin — the logo CDN is keyed by it, HIP-3 `dex:` prefix
- * included. `displaySymbol` drops the prefix: the category is carried by
- * `categoryId`, never by the display string.
+ * Synthesise the {@link Asset} for a Hyperliquid wire coin. `id` keeps the raw
+ * coin — the logo CDN is keyed by it, HIP-3 `dex:` prefix included.
+ * `displaySymbol` drops the prefix: the category is carried by `categoryId`,
+ * never by the display string. `logoURI` is the CDN URL corrected by the
+ * shared override table (see {@link applyLogoOverride}).
  * @public
  */
 export declare const coinAsset: (coin: string) => Asset;

package/dist/types/utils/marketDisplay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"marketDisplay.d.ts","sourceRoot":"","sources":["../../../src/utils/marketDisplay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAQtD;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,KAKvC,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,SAAS,MAAM,EAAE,KAAG,MAAM,EAShE,CAAA"}
+{"version":3,"file":"marketDisplay.d.ts","sourceRoot":"","sources":["../../../src/utils/marketDisplay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAStD;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,KAQrC,CAAA;AAEJ;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,SAAS,MAAM,EAAE,KAAG,MAAM,EAShE,CAAA"}

package/dist/types/utils/spotBalance.d.ts

@@ -10,7 +10,9 @@ export declare const spotPriceById: (markets: readonly Market[], priceByMarketId
 /**
  * The held spot {@link Asset} for an HL balance: the venue token index
  * (`b.token`) as `Asset.id` — equal to that token's spot `Market.baseAsset.id`
- * — with display fields derived from the coin.
+ * — with display fields derived from the coin and the override-aware spot logo.
+ * `HlSpotBalance` carries no `fullName`, so Unit-bridged balances take the base
+ * `_spot` rule (see {@link spotLogoURI}).
  */
 export declare const spotAssetFromToken: (b: HlSpotBalance) => Asset;
 /** Assemble a typed spot {@link Balance} from its resolved asset and raw size. */

package/dist/types/utils/spotBalance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spotBalance.d.ts","sourceRoot":"","sources":["../../../src/utils/spotBalance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAGtD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACxB,SAAS,SAAS,MAAM,EAAE,EAC1B,iBAAiB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,KAC3C,GAAG,CAAC,MAAM,EAAE,MAAM,CAapB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,GAAG,aAAa,KAAG,KAGpD,CAAA;AAEF,kFAAkF;AAClF,eAAO,MAAM,WAAW,GACtB,OAAO,KAAK,EACZ,OAAO,MAAM,EACb,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAC7B,OAKD,CAAA"}
+{"version":3,"file":"spotBalance.d.ts","sourceRoot":"","sources":["../../../src/utils/spotBalance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAItD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACxB,SAAS,SAAS,MAAM,EAAE,EAC1B,iBAAiB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,KAC3C,GAAG,CAAC,MAAM,EAAE,MAAM,CAapB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,GAAG,aAAa,KAAG,KAIpD,CAAA;AAEF,kFAAkF;AAClF,eAAO,MAAM,WAAW,GACtB,OAAO,KAAK,EACZ,OAAO,MAAM,EACb,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAC7B,OAKD,CAAA"}

package/dist/types/websocket/HyperliquidWsProvider.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifi/perps-sdk-provider-hyperliquid",
-  "version": "4.2.0",
+  "version": "4.3.1",
   "description": "Hyperliquid provider plugin for @lifi/perps-sdk",
   "homepage": "https://github.com/lifinance/perps-sdk",
   "bugs": {
@@ -48,10 +48,10 @@
   "dependencies": {
     "big.js": "^7.0.1",
     "viem": "^2.48.8",
-    "@lifi/perps-types": "^3.1.0"
+    "@lifi/perps-types": "^3.3.1"
   },
   "peerDependencies": {
-    "@lifi/perps-sdk": "^4.2.0"
+    "@lifi/perps-sdk": "^4.3.1"
   },
   "publishConfig": {
     "access": "public"

package/src/accountConfig.ts

@@ -61,6 +61,7 @@ function projectHyperliquidDescriptor(
     case ActionType.REGISTER_API_KEY:
     case ActionType.APPROVE_READ_ONLY_TOKEN:
     case ActionType.SIWE_LOGIN:
+    case ActionType.CREATE_DEPOSIT_ADDRESS:
     case ActionType.ACCEPT_PROVIDER_TERMS:
     case ActionType.DEPOSIT:
     case ActionType.META_VOTE:

package/src/utils/assetLogo.ts

@@ -0,0 +1,85 @@
+import type { Asset } from '@lifi/perps-types'
+
+const HL_COIN_CDN = 'https://app.hyperliquid.xyz/coins'
+
+const HYPE_LOGO_URI =
+  'https://static.debank.com/image/hyper_token/logo_url/hyper/0b3e288cfe418e9ce69eef4c96374583.png'
+
+/**
+ * Per-symbol logo overrides applied on top of the derived HL CDN URL, keyed by
+ * `Asset.displaySymbol`. Each entry notes why the default URL is wrong.
+ */
+const BASE_ASSET_LOGO_OVERRIDES: Readonly<Record<string, string>> = {
+  // coins/HYPE.svg is low quality; the debank hyper_token PNG is the canonical icon.
+  HYPE: HYPE_LOGO_URI,
+  // coins/USDC_spot.svg doesn't exist — HL's app 200s with its SPA shell HTML
+  // instead of a 404, so the collateral asset needs the non-suffixed path.
+  USDC: `${HL_COIN_CDN}/USDC.svg`,
+  // Neither coins/USDT0.svg nor coins/USDT0_spot.svg serves an image (both 200
+  // with the SPA shell); USDT0 is HL's USDT deployment, so reuse USDT's icon.
+  USDT0: `${HL_COIN_CDN}/USDT.svg`,
+}
+
+/**
+ * Underlying spot symbol for each Unit-bridged token (`fullName` starts with
+ * "Unit"), keyed by the token `name`. Hand-verified that `coins/<symbol>.svg`
+ * serves a real image; the Unit-suffixed `NAME_spot.svg` path 200s with HTML
+ * instead. Unit tokens absent here have no working HL icon and intentionally
+ * resolve to '' (client letter avatar).
+ */
+const UNIT_UNDERLYING_SYMBOL: Readonly<Record<string, string>> = {
+  UBTC: 'BTC',
+  UETH: 'ETH',
+  USOL: 'SOL',
+  UFART: 'FARTCOIN',
+  UPUMP: 'PUMP',
+  UUUSPX: 'SPX',
+  UVIRT: 'VIRTUAL',
+  UBONK: 'BONK',
+  UDOGE: 'DOGE',
+  UZEC: 'ZEC',
+  UMON: 'MON',
+  UWLD: 'WLD',
+  UENA: 'ENA',
+  UXPL: 'XPL',
+  UAVAX: 'AVAX',
+  UMEGA: 'MEGA',
+  UANSEM: 'ANSEM',
+}
+
+/** Token `name`s of the Unit-bridged HL spot assets. */
+export const UNIT_TOKEN_NAMES: ReadonlySet<string> = new Set(
+  Object.keys(UNIT_UNDERLYING_SYMBOL)
+)
+
+/** Logo URI for a Unit-bridged spot token; '' when the underlying is unmapped. */
+const unitSpotLogoURI = (name: string): string => {
+  const underlying = UNIT_UNDERLYING_SYMBOL[name]
+  return underlying === undefined ? '' : `${HL_COIN_CDN}/${underlying}.svg`
+}
+
+/** Return `asset` with its `logoURI` replaced when a display-symbol override exists. */
+export const applyLogoOverride = (asset: Asset): Asset => {
+  const override = BASE_ASSET_LOGO_OVERRIDES[asset.displaySymbol]
+  return override === undefined ? asset : { ...asset, logoURI: override }
+}
+
+/**
+ * Override-aware logo URI for a Hyperliquid spot token. Base rule is
+ * `coins/${name}_spot.svg`; a Unit-bridged token (`fullName` starts with
+ * "Unit") resolves to its underlying's icon instead; the override table wins
+ * over both.
+ *
+ * When `fullName` is absent — spot *balances* (`HlSpotBalance`) carry no
+ * `fullName` and this issue deliberately does not fetch `spotMeta` on the
+ * account path — the derivation degrades to the symbol-keyed override + base
+ * `_spot` rule, so a Unit-bridged balance uses the base rule rather than its
+ * underlying's icon. The registry path (which has `fullName`) keeps full Unit
+ * resolution.
+ */
+export const spotLogoURI = (name: string, fullName?: string | null): string => {
+  const base = fullName?.startsWith('Unit')
+    ? unitSpotLogoURI(name)
+    : `${HL_COIN_CDN}/${name}_spot.svg`
+  return BASE_ASSET_LOGO_OVERRIDES[name] ?? base
+}

package/src/utils/index.ts

@@ -3,6 +3,11 @@
 // (e.g. `./assetId.js`, `./mapFill.js`) directly.
 
 export { assetIsSpot, calculateAssetId, getProviderIndex } from './assetId.js'
+export {
+  applyLogoOverride,
+  spotLogoURI,
+  UNIT_TOKEN_NAMES,
+} from './assetLogo.js'
 export {
   decodeCompressedJson,
   decodeFastAssetCtxs,

package/src/utils/infoClient.ts

@@ -7,8 +7,27 @@ import {
   type SDKRequestOptions,
 } from '@lifi/perps-sdk'
 import { PerpsErrorCode } from '@lifi/perps-types'
+import { isAddress } from 'viem'
 import { PROVIDER_KEY } from '../constants.js'
 
+const normalizeInfoValue = (value: unknown): unknown => {
+  if (typeof value === 'string') {
+    return isAddress(value, { strict: false }) ? value.toLowerCase() : value
+  }
+  if (Array.isArray(value)) {
+    return value.map(normalizeInfoValue)
+  }
+  if (value !== null && typeof value === 'object') {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, nestedValue]) => [
+        key,
+        normalizeInfoValue(nestedValue),
+      ])
+    )
+  }
+  return value
+}
+
 /** @internal */
 export const HYPERLIQUID_RETRY_DEFAULTS: ResolvedRetryPolicy = {
   enabled: true,
@@ -81,7 +100,7 @@ export async function infoRequest<T>(
       {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify(body),
+        body: JSON.stringify(normalizeInfoValue(body)),
       },
       {
         policy,

package/src/utils/mapMarket.ts

@@ -22,6 +22,9 @@ export const mapMarket = (
 ): PerpsMarket => ({
   providerId: PROVIDER_KEY,
   id: universe.name,
+  ...(universe.isDelisted === undefined
+    ? {}
+    : { isDelisted: universe.isDelisted }),
   categoryId,
   baseAsset: coinAsset(universe.name),
   quoteAsset: coinAsset(QUOTE_SYMBOL),

package/src/utils/marketDisplay.ts

@@ -5,20 +5,25 @@ import {
   PROVIDER_KEY,
   SPOT_MARKET_ID,
 } from '../constants.js'
+import { applyLogoOverride } from './assetLogo.js'
 
 /**
- * Synthesise the {@link Asset} for a Hyperliquid wire coin. `id` and `logoURI`
- * keep the raw coin — the logo CDN is keyed by it, HIP-3 `dex:` prefix
- * included. `displaySymbol` drops the prefix: the category is carried by
- * `categoryId`, never by the display string.
+ * Synthesise the {@link Asset} for a Hyperliquid wire coin. `id` keeps the raw
+ * coin — the logo CDN is keyed by it, HIP-3 `dex:` prefix included.
+ * `displaySymbol` drops the prefix: the category is carried by `categoryId`,
+ * never by the display string. `logoURI` is the CDN URL corrected by the
+ * shared override table (see {@link applyLogoOverride}).
  * @public
  */
-export const coinAsset = (coin: string): Asset => ({
-  providerId: PROVIDER_KEY,
-  id: coin,
-  displaySymbol: coin.includes(':') ? coin.slice(coin.indexOf(':') + 1) : coin,
-  logoURI: `https://app.hyperliquid.xyz/coins/${coin}.svg`,
-})
+export const coinAsset = (coin: string): Asset =>
+  applyLogoOverride({
+    providerId: PROVIDER_KEY,
+    id: coin,
+    displaySymbol: coin.includes(':')
+      ? coin.slice(coin.indexOf(':') + 1)
+      : coin,
+    logoURI: `https://app.hyperliquid.xyz/coins/${coin}.svg`,
+  })
 
 /**
  * Distinct wire `dex` names to fan `clearinghouseState` / `frontendOpenOrders`

package/src/utils/spotBalance.ts

@@ -2,6 +2,7 @@ import { stringToFloat } from '@lifi/perps-sdk'
 import type { Asset, Balance, Market } from '@lifi/perps-types'
 import { SPOT_MARKET_ID } from '../constants.js'
 import type { HlSpotBalance } from '../types/index.js'
+import { spotLogoURI } from './assetLogo.js'
 import { coinAsset } from './marketDisplay.js'
 
 /**
@@ -31,11 +32,14 @@ export const spotPriceById = (
 /**
  * The held spot {@link Asset} for an HL balance: the venue token index
  * (`b.token`) as `Asset.id` — equal to that token's spot `Market.baseAsset.id`
- * — with display fields derived from the coin.
+ * — with display fields derived from the coin and the override-aware spot logo.
+ * `HlSpotBalance` carries no `fullName`, so Unit-bridged balances take the base
+ * `_spot` rule (see {@link spotLogoURI}).
  */
 export const spotAssetFromToken = (b: HlSpotBalance): Asset => ({
   ...coinAsset(b.coin),
   id: String(b.token),
+  logoURI: spotLogoURI(b.coin),
 })
 
 /** Assemble a typed spot {@link Balance} from its resolved asset and raw size. */

package/src/websocket/HyperliquidWsProvider.ts

@@ -1,5 +1,6 @@
 import {
   getMarketRegistry,
+  isActiveMarket,
   isActiveOrderStatus,
   type MarketRegistry,
   type PerpsSDKClient,
@@ -28,6 +29,7 @@ import {
   type TriggerOrder,
 } from '@lifi/perps-types'
 import Big from 'big.js'
+import { isAddress } from 'viem'
 import {
   DEFAULT_HYPERLIQUID_API_URL,
   HYPERLIQUID_FEE_TIER_FALLBACK,
@@ -80,6 +82,9 @@ import { DecodeChain } from './decodeChain.js'
 /** HL's compact `l2` snapshot carries 20 levels per side. */
 const HL_L2_BOOK_MAX_LEVELS_PER_SIDE = 20
 
+const normalizeHlAddress = (address: string): string =>
+  isAddress(address, { strict: false }) ? address.toLowerCase() : address
+
 /**
  * `WsProviderFactory` constructor for Hyperliquid — pass to
  * `new PerpsWsClient(client, { wsProviders: { hyperliquid: hyperliquidWsProvider() } })`.
@@ -249,6 +254,16 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
 
     await this.registry?.sync()
 
+    if (
+      this.registry !== undefined &&
+      (sub.channel === 'marketContext' ||
+        sub.channel === 'orderbook' ||
+        sub.channel === 'candle' ||
+        sub.channel === 'trades')
+    ) {
+      this.registry.requireActive(sub.marketId)
+    }
+
     // Markets context aggregates slower asset-context feeds with fast mid/mark
     // ticks from `fastAssetCtxs`.
     if (sub.channel === 'marketsContext') {
@@ -535,14 +550,17 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
           coin: sub.marketId,
         }
       case 'orderUpdates':
-        return { type: 'orderUpdates', user: sub.address }
+        return { type: 'orderUpdates', user: normalizeHlAddress(sub.address) }
       case 'fills':
-        return { type: 'userFills', user: sub.address }
+        return { type: 'userFills', user: normalizeHlAddress(sub.address) }
       case 'positions':
       case 'accountSummary':
-        return { type: 'allDexsClearinghouseState', user: sub.address }
+        return {
+          type: 'allDexsClearinghouseState',
+          user: normalizeHlAddress(sub.address),
+        }
       case 'spotBalances':
-        return { type: 'spotState', user: sub.address }
+        return { type: 'spotState', user: normalizeHlAddress(sub.address) }
     }
   }
 
@@ -688,7 +706,7 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
 
   private spotMarketIdBySacKey(): Map<string, string> {
     const map = new Map<string, string>()
-    for (const market of this.registry?.markets ?? []) {
+    for (const market of this.registry?.activeMarkets ?? []) {
       if (market.categoryId !== SPOT_MARKET_ID) {
         continue
       }
@@ -751,6 +769,10 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
    * other where it carries only one of mid/mark.
    */
   private computeMarketContext(marketId: string): MarketContext | undefined {
+    const market = this.registry?.get(marketId)
+    if (market !== undefined && !isActiveMarket(market)) {
+      return undefined
+    }
     const fast = this.fastCtxByMarketId[marketId]
     const spotCtx = this.spotCtxByMarketId[marketId]
     if (spotCtx !== undefined) {
@@ -1252,7 +1274,7 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
 
   private handleSpotState(data: HlWsSpotStateData) {
     const user = data.user.toLowerCase()
-    const markets = this.registry?.markets ?? []
+    const markets = this.registry?.activeMarkets ?? []
     const priceById = spotPriceById(markets, this.mergedMids())
     const rows = data.spotState.balances.map((b) => ({
       balance: spotBalance(spotAssetFromToken(b), b.total, priceById),