@lifi/perps-types 0.1.1-alpha.1 → 0.1.1-alpha.11

package/src/_types/providers/hyperliquid/types.d.ts

@@ -0,0 +1,201 @@
+export type HlUniverseItem = {
+    name: string;
+    szDecimals: number;
+    maxLeverage: number;
+    onlyIsolated?: boolean;
+    isDelisted?: boolean;
+};
+export type HlMeta = {
+    universe: HlUniverseItem[];
+};
+export type HlAssetCtx = {
+    funding: string;
+    openInterest: string;
+    dayNtlVlm: string;
+    markPx: string;
+};
+export type HlMetaAndAssetCtxs = [HlMeta, HlAssetCtx[]];
+export type HlUniverse = HlMeta['universe'];
+export type HlAllMids = Record<string, string>;
+export type HlCandle = {
+    t: number;
+    o: string;
+    h: string;
+    l: string;
+    c: string;
+    v: string;
+};
+export type HlCandleSnapshot = HlCandle[];
+export type HlLevel = {
+    px: string;
+    sz: string;
+    n: number;
+};
+export type HlL2Book = {
+    levels: [HlLevel[], HlLevel[]];
+    time: number;
+};
+export type HlPosition = {
+    coin: string;
+    szi: string;
+    entryPx: string;
+    positionValue: string;
+    liquidationPx: string;
+    unrealizedPnl: string;
+    marginUsed: string;
+    leverage: {
+        type: string;
+        value: number;
+    };
+};
+export type HlAssetPosition = {
+    position: HlPosition;
+};
+export type HlClearinghouseState = {
+    assetPositions: HlAssetPosition[];
+    marginSummary: {
+        accountValue: string;
+        totalMarginUsed: string;
+    };
+    crossMarginSummary: {
+        accountValue: string;
+        totalMarginUsed: string;
+    };
+};
+export type HlSpotBalance = {
+    coin: string;
+    token: number;
+    total: string;
+    hold: string;
+    entryNtl: string;
+};
+export type HlSpotClearinghouseState = {
+    balances: HlSpotBalance[];
+};
+export type HlUserFees = {
+    userAddRate: string;
+    userCrossRate: string;
+    activeReferralDiscount: string;
+};
+export type HlFrontendOpenOrder = {
+    oid: number;
+    coin: string;
+    side: string;
+    sz: string;
+    limitPx: string;
+    orderType: string;
+    origSz: string;
+    reduceOnly: boolean;
+    timestamp: number;
+};
+export type HlFrontendOpenOrders = HlFrontendOpenOrder[];
+export type HlExtraAgents = Record<string, unknown>[];
+export type HlUserFill = {
+    tid: number;
+    coin: string;
+    side: string;
+    sz: string;
+    px: string;
+    dir: string;
+    fee: string;
+    closedPnl: string;
+    time: number;
+};
+export type HlUserFills = HlUserFill[];
+export type HlUserFillsByTime = HlUserFill[];
+export type HlOrderDetail = {
+    order: {
+        oid: number;
+        coin: string;
+        side: string;
+        sz: string;
+        limitPx: string;
+        orderType: string;
+        origSz: string;
+        reduceOnly: boolean;
+        timestamp: number;
+        tif: string | null;
+        cloid: string | null;
+        triggerCondition: string;
+        triggerPx: string | null;
+    };
+    status: string;
+    statusTimestamp: number;
+};
+export type HlOrderStatusFound = {
+    status: 'order';
+    order: HlOrderDetail;
+};
+export type HlOrderStatusResponse = HlOrderStatusFound | {
+    status: 'unknownOid';
+};
+export type HlLedgerDelta = {
+    type: string;
+    usdc?: string;
+    [key: string]: unknown;
+};
+export type HlLedgerUpdate = {
+    time: number;
+    hash: string;
+    delta: HlLedgerDelta;
+};
+export type HlUserNonFundingLedgerUpdates = HlLedgerUpdate[];
+export type HlFundingDelta = {
+    type: 'funding';
+    coin: string;
+    usdc: string;
+    szi: string;
+    fundingRate: string;
+};
+export type HlFundingUpdate = {
+    time: number;
+    hash: string;
+    delta: HlFundingDelta;
+};
+export type HlUserFunding = HlFundingUpdate[];
+export type HlPerpDexs = (null | {
+    name: string;
+})[];
+export type HlExchangeRequest = {
+    action: Record<string, unknown>;
+    signature: {
+        r: string;
+        s: string;
+        v: number;
+    };
+    nonce: number;
+    vaultAddress?: string | null;
+};
+export type HlExchangeResponse = {
+    status: string;
+    response?: string | {
+        type: string;
+        data?: {
+            statuses?: (string | {
+                filled: {
+                    totalSz: string;
+                    avgPx: string;
+                    oid: number;
+                };
+            } | {
+                resting: {
+                    oid: number;
+                };
+            } | {
+                waitingForFill: {
+                    oid: number;
+                };
+            } | {
+                waitingForTrigger: {
+                    oid: number;
+                };
+            } | {
+                success: true;
+            } | {
+                error: string;
+            })[];
+            status?: unknown;
+        };
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/src/_types/providers/hyperliquid/types.d.ts.map

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

package/src/_types/subscriptions.d.ts

@@ -0,0 +1,71 @@
+import type { Address } from './typedData.js';
+import type { Candle, OhlcvInterval, OrderbookResponse, PricesResponse } from './market.js';
+import type { HistoryItem, Position } from './account.js';
+import type { Order } from './trading.js';
+export type PricesSubscription = {
+    channel: 'prices';
+    dex: string;
+};
+export type OrderbookSubscription = {
+    channel: 'orderbook';
+    dex: string;
+    symbol: string;
+    depth?: number;
+};
+export type TradesSubscription = {
+    channel: 'trades';
+    dex: string;
+    symbol: string;
+};
+export type CandleSubscription = {
+    channel: 'candle';
+    dex: string;
+    symbol: string;
+    interval: OhlcvInterval;
+};
+export type OrderUpdatesSubscription = {
+    channel: 'orderUpdates';
+    dex: string;
+    address: Address;
+};
+export type FillsSubscription = {
+    channel: 'fills';
+    dex: string;
+    address: Address;
+};
+export type PositionsSubscription = {
+    channel: 'positions';
+    dex: string;
+    address: Address;
+};
+export type Subscription = PricesSubscription | OrderbookSubscription | TradesSubscription | CandleSubscription | OrderUpdatesSubscription | FillsSubscription | PositionsSubscription;
+export type PricesEvent = {
+    channel: 'prices';
+    data: PricesResponse;
+};
+export type OrderbookEvent = {
+    channel: 'orderbook';
+    data: OrderbookResponse;
+};
+export type TradesEvent = {
+    channel: 'trades';
+    data: HistoryItem[];
+};
+export type CandleEvent = {
+    channel: 'candle';
+    data: Candle;
+};
+export type OrderUpdatesEvent = {
+    channel: 'orderUpdates';
+    data: Order[];
+};
+export type FillsEvent = {
+    channel: 'fills';
+    data: HistoryItem[];
+};
+export type PositionsEvent = {
+    channel: 'positions';
+    data: Position[];
+};
+export type SubscriptionEvent = PricesEvent | OrderbookEvent | TradesEvent | CandleEvent | OrderUpdatesEvent | FillsEvent | PositionsEvent;
+//# sourceMappingURL=subscriptions.d.ts.map

package/src/_types/subscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../subscriptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,KAAK,EACV,MAAM,EACN,aAAa,EACb,iBAAiB,EACjB,cAAc,EACf,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AAIzC,MAAM,MAAM,kBAAkB,GAAG;IAAE,OAAO,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAA;AACnE,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,WAAW,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AACD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,QAAQ,CAAA;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AACD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,QAAQ,CAAA;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,aAAa,CAAA;CACxB,CAAA;AACD,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,cAAc,CAAA;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AACD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AACD,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,WAAW,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,YAAY,GACpB,kBAAkB,GAClB,qBAAqB,GACrB,kBAAkB,GAClB,kBAAkB,GAClB,wBAAwB,GACxB,iBAAiB,GACjB,qBAAqB,CAAA;AAIzB,MAAM,MAAM,WAAW,GAAG;IAAE,OAAO,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,CAAA;AACrE,MAAM,MAAM,cAAc,GAAG;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,CAAA;AAC9E,MAAM,MAAM,WAAW,GAAG;IAAE,OAAO,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,WAAW,EAAE,CAAA;CAAE,CAAA;AACpE,MAAM,MAAM,WAAW,GAAG;IAAE,OAAO,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAC7D,MAAM,MAAM,iBAAiB,GAAG;IAAE,OAAO,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,KAAK,EAAE,CAAA;CAAE,CAAA;AAC1E,MAAM,MAAM,UAAU,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,WAAW,EAAE,CAAA;CAAE,CAAA;AAClE,MAAM,MAAM,cAAc,GAAG;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAA;AAEvE,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,cAAc,GACd,WAAW,GACX,WAAW,GACX,iBAAiB,GACjB,UAAU,GACV,cAAc,CAAA"}

package/src/_types/trading.d.ts

@@ -8,12 +8,11 @@ export interface CreateOrderRequest {
     dex: string;
     address: Address;
     signerAddress?: Address;
-    clientOrderId?: string;
     symbol: string;
     side: OrderSide;
-    type: OrderType;
+    type?: OrderType;
     size: string;
-    price: string;
+    price?: string;
     leverage?: number;
     reduceOnly?: boolean;
     timeInForce?: TimeInForce;
@@ -60,7 +59,6 @@ export interface SubmitOrderResponse {
 }
 export interface Order {
     orderId: string;
-    clientOrderId?: string;
     symbol: string;
     side: OrderSide;
     type: OrderType;

package/src/_types/trading.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trading.d.ts","sourceRoot":"","sources":["../trading.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"trading.d.ts","sourceRoot":"","sources":["../trading.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAClE,OAAO,KAAK,EACV,eAAe,EACf,SAAS,EACT,WAAW,EACX,SAAS,EACT,WAAW,EACX,gBAAgB,EACjB,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,SAAS,CAAA;IACf,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,iBAAiB,CAAA;IAC9B,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,eAAe,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,cAAc,CAAA;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,WAAW,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,GAAG,EAAE,MAAM,EAAE,CAAA;CACd;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,WAAW,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,eAAe,CAAA;IACvB,SAAS,EAAE,cAAc,CAAA;IACzB,SAAS,EAAE,GAAG,CAAA;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,OAAO,EAAE,iBAAiB,EAAE,CAAA;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,eAAe,CAAA;IACvB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,iBAAiB,EAAE,CAAA;CAC7B;AAED,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,SAAS,CAAA;IACf,IAAI,EAAE,SAAS,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,MAAM,EAAE,WAAW,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB"}

package/src/account.ts

@@ -1,5 +1,6 @@
 import type { Address } from './typedData.js'
 import type {
+  ActivityType,
   HistoryItemStatus,
   MarginMode,
   OrderSide,
@@ -86,3 +87,57 @@ export interface HistoryResponse {
   items: HistoryItem[]
   pagination: Pagination
 }
+
+// ---------------------------------------------------------------------------
+// Activities
+// ---------------------------------------------------------------------------
+
+export interface BaseActivity {
+  id: string
+  dex: string
+  timestamp: string
+}
+
+export interface DepositActivity extends BaseActivity {
+  type: ActivityType.DEPOSIT
+  amount: string
+}
+
+export interface WithdrawalActivity extends BaseActivity {
+  type: ActivityType.WITHDRAWAL
+  amount: string
+  fee: string
+}
+
+export interface LiquidatedPosition {
+  symbol: string
+  size: string
+}
+
+export interface LiquidationActivity extends BaseActivity {
+  type: ActivityType.LIQUIDATION
+  liquidatedNotionalPosition: string
+  accountValue: string
+  leverageType: string
+  liquidatedPositions: LiquidatedPosition[]
+}
+
+export interface FundingActivity extends BaseActivity {
+  type: ActivityType.FUNDING
+  symbol: string
+  amount: string
+  positionSize: string
+  fundingRate: string
+}
+
+export type ActivityItem =
+  | DepositActivity
+  | WithdrawalActivity
+  | LiquidationActivity
+  | FundingActivity
+
+export interface ActivitiesResponse {
+  dex: string
+  items: ActivityItem[]
+  pagination: Pagination
+}

package/src/enums.ts

@@ -38,6 +38,7 @@ export enum OrderSide {
 export enum OrderType {
   MARKET = 'MARKET',
   LIMIT = 'LIMIT',
+  TRIGGER_ONLY = 'TRIGGER_ONLY',
 }
 
 export enum PositionSide {
@@ -97,3 +98,10 @@ export enum TriggerOrderStatus {
   TRIGGERED = 'TRIGGERED',
   CANCELLED = 'CANCELLED',
 }
+
+export enum ActivityType {
+  DEPOSIT = 'DEPOSIT',
+  WITHDRAWAL = 'WITHDRAWAL',
+  LIQUIDATION = 'LIQUIDATION',
+  FUNDING = 'FUNDING',
+}

package/src/index.ts

@@ -6,3 +6,4 @@ export * from './account.js'
 export * from './trading.js'
 export * from './withdrawal.js'
 export * from './errors.js'
+export * from './subscriptions.js'

package/src/market.ts

@@ -16,6 +16,7 @@ export interface Dex {
   logoURI: string
   authorizations: Authorization[]
   extraData?: Record<string, unknown>
+  wsUrl?: string
 }
 
 export interface DexesResponse {

package/src/providers/hyperliquid/assetId.ts

@@ -0,0 +1,26 @@
+/**
+ * Calculate the asset ID for a given DEX index and asset index.
+ *
+ * Main DEX (dex = ''): assetId = indexInDex
+ * HIP-3 DEXes (dex = 'xyz'): assetId = 100_000 + perpDexIndex * 10_000 + indexInDex
+ */
+export const calculateAssetId = (
+  dexIndex: number,
+  indexInDex: number
+): number => {
+  if (dexIndex === 0) {
+    return indexInDex
+  }
+  return 100_000 + dexIndex * 10_000 + indexInDex
+}
+
+/**
+ * Get the DEX index from the given list of dex names.
+ */
+export const getDexIndex = (dex: string, dexNames: string[]): number => {
+  const index = dexNames.indexOf(dex)
+  if (index === -1) {
+    throw new Error(`Unknown sub-dex: ${dex}`)
+  }
+  return index
+}

package/src/providers/hyperliquid/index.ts

@@ -0,0 +1,3 @@
+export * from './types.js'
+export * from './assetId.js'
+export * from './mappers/index.js'

package/src/providers/hyperliquid/mappers/activity.ts

@@ -0,0 +1,84 @@
+import { ActivityType } from '../../../enums.js'
+import type {
+  ActivityItem,
+  DepositActivity,
+  WithdrawalActivity,
+  LiquidationActivity,
+  FundingActivity,
+} from '../../../account.js'
+import type { HlLedgerUpdate, HlFundingUpdate } from '../types.js'
+
+/**
+ * Map a Hyperliquid non-funding ledger entry to an ActivityItem.
+ * Returns null for unsupported delta types (accountClassTransfer,
+ * internalTransfer, subAccountTransfer, spotTransfer).
+ */
+export const mapLedgerEntry = (
+  entry: HlLedgerUpdate,
+  dexKey: string
+): ActivityItem | null => {
+  const { delta } = entry
+  const base = {
+    id: entry.hash,
+    dex: dexKey,
+    timestamp: new Date(entry.time).toISOString(),
+  }
+
+  switch (delta.type) {
+    case 'deposit':
+      return {
+        ...base,
+        type: ActivityType.DEPOSIT,
+        amount: delta.usdc ?? '0',
+      } satisfies DepositActivity
+
+    case 'withdraw':
+      return {
+        ...base,
+        type: ActivityType.WITHDRAWAL,
+        amount: delta.usdc ?? '0',
+        fee: (delta as { fee?: string }).fee ?? '0',
+      } satisfies WithdrawalActivity
+
+    case 'liquidation': {
+      const d = delta as unknown as {
+        type: string
+        liquidatedNtlPos: string
+        accountValue: string
+        leverageType: string
+        liquidatedPositions?: { coin: string; szi: string }[]
+      }
+      return {
+        ...base,
+        type: ActivityType.LIQUIDATION,
+        liquidatedNotionalPosition: d.liquidatedNtlPos,
+        accountValue: d.accountValue,
+        leverageType: d.leverageType,
+        liquidatedPositions: (d.liquidatedPositions ?? []).map((p) => ({
+          symbol: p.coin,
+          size: p.szi,
+        })),
+      } satisfies LiquidationActivity
+    }
+
+    default:
+      return null
+  }
+}
+
+/**
+ * Map a Hyperliquid funding entry to a FundingActivity.
+ */
+export const mapFundingActivity = (
+  entry: HlFundingUpdate,
+  dexKey: string
+): FundingActivity => ({
+  id: entry.hash,
+  dex: dexKey,
+  timestamp: new Date(entry.time).toISOString(),
+  type: ActivityType.FUNDING,
+  symbol: entry.delta.coin,
+  amount: entry.delta.usdc,
+  positionSize: entry.delta.szi,
+  fundingRate: entry.delta.fundingRate,
+})

package/src/providers/hyperliquid/mappers/history.ts

@@ -0,0 +1,25 @@
+import { HistoryItemStatus, OrderSide, OrderType } from '../../../enums.js'
+import type { HistoryItem } from '../../../account.js'
+import type { HlUserFill } from '../types.js'
+
+import { resolveAssetIdFromLookup } from './shared.js'
+
+export const mapHistoryItem = (
+  fill: HlUserFill,
+  dexKey: string,
+  assetIdLookup: Map<string, number>
+): HistoryItem => ({
+  id: String(fill.tid),
+  symbol: fill.coin,
+  assetId: resolveAssetIdFromLookup(assetIdLookup, fill.coin),
+  dex: dexKey,
+  side: fill.side === 'B' ? OrderSide.BUY : OrderSide.SELL,
+  type: fill.dir?.includes('Limit') ? OrderType.LIMIT : OrderType.MARKET,
+  size: fill.sz,
+  price: fill.px,
+  status: HistoryItemStatus.FILLED,
+  filledSize: fill.sz,
+  fee: fill.fee,
+  realizedPnl: fill.closedPnl === '0' ? null : fill.closedPnl,
+  createdAt: new Date(fill.time).toISOString(),
+})

package/src/providers/hyperliquid/mappers/index.ts

@@ -0,0 +1,6 @@
+export { resolveAssetIdFromLookup } from './shared.js'
+export { mapMarket } from './market.js'
+export { mapOpenOrder, mapOrder } from './order.js'
+export { mapPosition } from './position.js'
+export { mapHistoryItem } from './history.js'
+export { mapLedgerEntry, mapFundingActivity } from './activity.js'

package/src/providers/hyperliquid/mappers/market.ts

@@ -0,0 +1,35 @@
+import type { Market } from '../../../market.js'
+import { calculateAssetId } from '../assetId.js'
+import type { HlAssetCtx, HlUniverseItem } from '../types.js'
+
+const NEXT_FUNDING_INTERVAL_MS = 60 * 60 * 1000 // 1 hour
+
+export const mapMarket = (
+  universe: HlUniverseItem,
+  assetCtx: HlAssetCtx,
+  dexIndex: number,
+  indexInDex: number,
+  dexKey: string
+): Market => {
+  const now = Date.now()
+  const nextFundingTime =
+    Math.ceil(now / NEXT_FUNDING_INTERVAL_MS) * NEXT_FUNDING_INTERVAL_MS
+
+  return {
+    symbol: universe.name,
+    name: universe.name,
+    logoURI: `https://app.hyperliquid.xyz/coins/${universe.name}.svg`,
+    assetId: calculateAssetId(dexIndex, indexInDex),
+    dex: dexKey,
+    szDecimals: universe.szDecimals,
+    maxLeverage: universe.maxLeverage,
+    onlyIsolated: universe.onlyIsolated === true,
+    funding: {
+      rate: assetCtx.funding,
+      nextFundingTime,
+    },
+    openInterest: assetCtx.openInterest,
+    volume24h: assetCtx.dayNtlVlm,
+    markPrice: assetCtx.markPx,
+  }
+}