@lifi/perps-types 0.1.1-alpha.21 → 0.1.1-alpha.23

package/src/_types/providers/lighter/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './apiTypes.js';
+export * from './mappers/index.js';
+//# sourceMappingURL=index.d.ts.map

package/src/_types/providers/lighter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../providers/lighter/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA"}

package/src/_types/providers/lighter/mappers/fill.d.ts

@@ -0,0 +1,10 @@
+import type { Fill } from '../../../account.js';
+import type { LtTrade } from '../apiTypes.js';
+/**
+ * Map a raw Lighter trade to the generic Fill type.
+ * @param trade - Raw trade from REST or WS
+ * @param accountIndex - The viewer's Lighter account index (to determine buy/sell side)
+ * @param symbol - Resolved symbol (market_id → symbol lookup)
+ */
+export declare const mapFill: (trade: LtTrade, accountIndex: number, symbol: string) => Fill;
+//# sourceMappingURL=fill.d.ts.map

package/src/_types/providers/lighter/mappers/fill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill.d.ts","sourceRoot":"","sources":["../../../../providers/lighter/mappers/fill.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAK7C;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAClB,OAAO,OAAO,EACd,cAAc,MAAM,EACpB,QAAQ,MAAM,KACb,IAwBF,CAAA"}

package/src/_types/providers/lighter/mappers/index.d.ts

@@ -0,0 +1,4 @@
+export { mapPosition } from './position.js';
+export { mapFill } from './fill.js';
+export { mapOrder, mapOrderDetail } from './order.js';
+//# sourceMappingURL=index.d.ts.map

package/src/_types/providers/lighter/mappers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../providers/lighter/mappers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA"}

package/src/_types/providers/lighter/mappers/order.d.ts

@@ -0,0 +1,15 @@
+import type { OpenOrder } from '../../../account.js';
+import type { Order } from '../../../action.js';
+import type { LtOrder } from '../apiTypes.js';
+/**
+ * Map a raw Lighter order to the generic OpenOrder type.
+ * @param order - Raw order from REST or WS
+ * @param symbol - Resolved symbol (market_index → symbol lookup)
+ */
+export declare const mapOrder: (order: LtOrder, symbol: string) => OpenOrder;
+/**
+ * Map a raw Lighter order to the rich Order type used by getOrder.
+ * Includes status, time-in-force, and remaining/filled sizes.
+ */
+export declare const mapOrderDetail: (order: LtOrder, symbol: string) => Order;
+//# sourceMappingURL=order.d.ts.map

package/src/_types/providers/lighter/mappers/order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order.d.ts","sourceRoot":"","sources":["../../../../providers/lighter/mappers/order.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAmD7C;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,EAAE,QAAQ,MAAM,KAAG,SAexD,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,EAAE,QAAQ,MAAM,KAAG,KAmB9D,CAAA"}

package/src/_types/providers/lighter/mappers/position.d.ts

@@ -0,0 +1,9 @@
+import type { Position } from '../../../account.js';
+import type { LtAccountPosition } from '../apiTypes.js';
+/**
+ * Map a raw Lighter account position to the generic Position type.
+ * @param pos - Raw position from REST or WS
+ * @param symbol - Resolved symbol (market_id → symbol lookup, or pos.symbol)
+ */
+export declare const mapPosition: (pos: LtAccountPosition, symbol: string) => Position;
+//# sourceMappingURL=position.d.ts.map

package/src/_types/providers/lighter/mappers/position.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"position.d.ts","sourceRoot":"","sources":["../../../../providers/lighter/mappers/position.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAGvD;;;;GAIG;AACH,eAAO,MAAM,WAAW,GACtB,KAAK,iBAAiB,EACtB,QAAQ,MAAM,KACb,QA6BF,CAAA"}

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

@@ -0,0 +1,90 @@
+/** Backend-provided params for SignCreateOrder. */
+export type LtCreateOrderWasmParams = {
+    market_index: number;
+    client_order_index: number;
+    base_amount: number;
+    price: number;
+    is_ask: number;
+    order_type: number;
+    time_in_force: number;
+    reduce_only: boolean;
+    trigger_price: number;
+    order_expiry: number;
+    integrator_account_index: number;
+    integrator_taker_fee: number;
+    integrator_maker_fee: number;
+};
+/** Backend-provided params for SignCancelOrder. */
+export type LtCancelOrderWasmParams = {
+    market_index: number;
+    order_index: number;
+};
+/** Backend-provided params for SignModifyOrder. */
+export type LtModifyOrderWasmParams = {
+    market_index: number;
+    order_index: number;
+    base_amount: number;
+    price: number;
+    trigger_price: number;
+    integrator_account_index: number;
+    integrator_taker_fee: number;
+    integrator_maker_fee: number;
+};
+/** Backend-provided params for SignUpdateLeverage. */
+export type LtUpdateLeverageWasmParams = {
+    market_index: number;
+    fraction: number;
+    margin_mode: number;
+};
+/** Backend-provided params for SignUpdateMargin. */
+export type LtUpdateMarginWasmParams = {
+    market_index: number;
+    usdc_amount: number;
+    direction: number;
+};
+/** Backend-provided params for SignWithdraw. */
+export type LtWithdrawWasmParams = {
+    asset_index: number;
+    route_type: number;
+    amount: number;
+};
+/** Backend-provided params for SignCancelAllOrders. */
+export type LtCancelAllOrdersWasmParams = {
+    /** 0=immediate (cancel GTC), 1=scheduled, 2=abort scheduled */
+    time_in_force: number;
+    /** Unix timestamp in milliseconds. Use Date.now() for immediate cancels. */
+    timestamp_ms: number;
+};
+/**
+ * Backend-provided params for SignChangePubKey (REGISTER_API_KEY).
+ *
+ * NOTE: `new_public_key` is a placeholder here — the SDK generates the actual
+ * keypair via the WASM signer and fills this in before calling SignChangePubKey.
+ * This action also requires an L1 Ethereum signature (the user's wallet signs
+ * the ChangePubKey message), so it is a hybrid: WASM blob + EIP-191 eth_sign.
+ */
+export type LtChangePubKeyWasmParams = {
+    /** API key slot index to register (0-255). SDK fills in the generated public key. */
+    api_key_index: number;
+    nonce: number;
+};
+export declare const LT_ORDER_TYPE_LIMIT = 0;
+export declare const LT_ORDER_TYPE_MARKET = 1;
+export declare const LT_ORDER_TYPE_STOP_LOSS = 2;
+export declare const LT_ORDER_TYPE_STOP_LOSS_LIMIT = 3;
+export declare const LT_ORDER_TYPE_TAKE_PROFIT = 4;
+export declare const LT_ORDER_TYPE_TAKE_PROFIT_LIMIT = 5;
+export declare const LT_ORDER_TYPE_TWAP = 6;
+export declare const LT_TIME_IN_FORCE_IOC = 0;
+export declare const LT_TIME_IN_FORCE_GTC = 1;
+export declare const LT_TIME_IN_FORCE_POST_ONLY = 2;
+export declare const LT_MARGIN_MODE_CROSS = 0;
+export declare const LT_MARGIN_MODE_ISOLATED = 1;
+export declare const LT_MARGIN_DIRECTION_REMOVE = 0;
+export declare const LT_MARGIN_DIRECTION_ADD = 1;
+export declare const LT_ROUTE_PERP = 0;
+export declare const LT_ROUTE_SPOT = 1;
+export declare const LT_ASSET_ID_USDC = 3;
+export declare const LT_NIL_TRIGGER_PRICE = 0;
+export declare const LT_DEFAULT_ORDER_EXPIRY = -1;
+//# sourceMappingURL=types.d.ts.map

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

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

package/src/_types/providers.d.ts

@@ -1,7 +1,38 @@
-import type { ActionType, PerpsSigner } from './enums.js';
+import type { ActionType, PerpsSigner, SigningMethod } from './enums.js';
 export interface ActionDescriptor {
     type: ActionType;
     signers: PerpsSigner[];
+    /**
+     * How the SDK must sign this specific action. Most actions match the
+     * provider's dominant pattern (Hyperliquid: EIP712, Lighter: WASM_BLOB),
+     * but on-chain bridge actions like DEPOSIT are EVM_TX regardless of
+     * provider — the SDK dispatches by this field rather than by
+     * `Provider.signingMethod`.
+     */
+    signingMethod: SigningMethod;
+}
+/**
+ * Self-documenting account-setup step the user must (or may) fulfill before
+ * trading with a given provider. Mirrors a single entry of the `config`
+ * object returned by `GET /perps/account` — that endpoint reports the
+ * *state* of these items, while `Provider.accountConfiguration` declares
+ * what items exist and how to fulfill them.
+ *
+ * Extends `ActionDescriptor` because each item resolves to exactly one
+ * action the SDK dispatches when the user proceeds; the additional fields
+ * are the presentation and gating metadata the widget needs to render the
+ * onboarding overlay without hardcoded labels.
+ *
+ * `optional: false` means the item must be fulfilled before the user can
+ * proceed; `optional: true` means the user may skip it.
+ */
+export interface AccountConfigurationItem extends ActionDescriptor {
+    /** User-facing row title rendered in the onboarding overlay. */
+    title: string;
+    /** User-facing description rendered in the onboarding overlay. */
+    description: string;
+    /** When true the user may skip the item; when false it gates the trade flow. */
+    optional: boolean;
 }
 export interface ProviderMarketInfo {
     id: string;
@@ -11,7 +42,14 @@ export interface Provider {
     key: string;
     name: string;
     logoURI: string;
-    prepareAccountActions: ActionDescriptor[];
+    signingMethod: SigningMethod;
+    /**
+     * Account-setup items required (or optional) for trading with this
+     * provider. Replaces the previous `prepareAccountActions: ActionDescriptor[]`:
+     * same operational fields, plus the user-facing metadata the widget needs.
+     * An empty array is valid and indicates the provider has no setup gates.
+     */
+    accountConfiguration: AccountConfigurationItem[];
     actions: ActionDescriptor[];
     markets: ProviderMarketInfo[];
     wsUrl?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAA;IAChB,OAAO,EAAE,WAAW,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,qBAAqB,EAAE,gBAAgB,EAAE,CAAA;IACzC,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,OAAO,EAAE,kBAAkB,EAAE,CAAA;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,QAAQ,EAAE,CAAA;CACtB"}
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAExE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAA;IAChB,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB;;;;;;OAMG;IACH,aAAa,EAAE,aAAa,CAAA;CAC7B;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAChE,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAA;IACb,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAA;IACnB,gFAAgF;IAChF,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,aAAa,CAAA;IAC5B;;;;;OAKG;IACH,oBAAoB,EAAE,wBAAwB,EAAE,CAAA;IAChD,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,OAAO,EAAE,kBAAkB,EAAE,CAAA;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,QAAQ,EAAE,CAAA;CACtB"}

package/src/_types/typedData.d.ts

@@ -1,10 +1,18 @@
-import type { TypedData, SignedTypedData } from '@lifi/types';
 import type { Address, Hex, TypedDataDomain, TypedDataParameter } from 'viem';
-export type PerpsTypedData = Omit<TypedData, 'primaryType'> & {
-    primaryType: string;
+import type { HlPrimaryType } from './providers/hyperliquid/types.js';
+/**
+ * All known EIP-712 primaryType values across supported providers.
+ * Extend this union when adding a new EIP-712 provider.
+ */
+export type PerpsPrimaryType = HlPrimaryType;
+export type PerpsTypedData = {
+    domain: TypedDataDomain;
+    types: Record<string, readonly TypedDataParameter[]>;
+    primaryType: PerpsPrimaryType;
+    message: Record<string, any>;
 };
-export type PerpsSignedTypedData = Omit<SignedTypedData, 'primaryType'> & {
-    primaryType: string;
+export type PerpsSignedTypedData = PerpsTypedData & {
+    signature: Hex;
 };
 export type { Address, Hex, TypedDataDomain, TypedDataParameter };
 //# sourceMappingURL=typedData.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"typedData.d.ts","sourceRoot":"","sources":["../typedData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAA;AAE7E,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,GAAG;IAC5D,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,GAAG;IACxE,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAGD,YAAY,EAAE,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE,kBAAkB,EAAE,CAAA"}
+{"version":3,"file":"typedData.d.ts","sourceRoot":"","sources":["../typedData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAA;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAErE;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAA;AAE5C,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,eAAe,CAAA;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC,CAAA;IACpD,WAAW,EAAE,gBAAgB,CAAA;IAE7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG;IAClD,SAAS,EAAE,GAAG,CAAA;CACf,CAAA;AAGD,YAAY,EAAE,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE,kBAAkB,EAAE,CAAA"}

package/src/account.ts

@@ -4,6 +4,7 @@ import type {
   ActivityType,
   FillClassification,
   FillStatus,
+  LiquidityRole,
   MarginMode,
   OrderSide,
   OrderType,
@@ -82,12 +83,14 @@ export interface OrdersResponse {
 
 export interface Fill {
   id: string
+  orderId: string
   asset: AssetDisplay
   side: OrderSide
   type: OrderType
   size: string
   price: string
   status: FillStatus
+  liquidity: LiquidityRole
   filledSize?: string
   fee?: string
   realizedPnl?: string | null
@@ -151,11 +154,26 @@ export interface FundingActivity extends BaseActivity {
   fundingRate: string
 }
 
+/**
+ * Internal transfer between two accounts on the same L2 (e.g. Lighter
+ * `/api/v1/transfer/history`). Direction is relative to the queried
+ * account; `counterpartyAccountIndex` identifies the other side.
+ */
+export interface TransferActivity extends BaseActivity {
+  type: ActivityType.TRANSFER
+  direction: 'IN' | 'OUT'
+  counterpartyAccountIndex: number
+  asset: string
+  amount: string
+  meta?: Record<string, unknown>
+}
+
 export type ActivityItem =
   | DepositActivity
   | WithdrawalActivity
   | LiquidationActivity
   | FundingActivity
+  | TransferActivity
 
 export interface ActivitiesResponse {
   provider: string

package/src/action.ts

@@ -1,4 +1,4 @@
-import type { OrderType } from './enums.js'
+import type { MarginMode, OrderType } from './enums.js'
 import {
   type ActionType,
   type OrderSide,
@@ -11,19 +11,59 @@ import type { AssetIdentity, AssetDisplay } from './asset.js'
 
 // ---------------------------------------------------------------------------
 // Action step types (create → sign → execute flow)
+//
+// Union by structural shape — the SDK knows which variant to expect based
+// on the provider's `signingMethod` from the /providers response.
+//
+//   Eip712    – Hyperliquid and future EVM dexes (EIP-712 typed data + ECDSA sig)
+//   WasmBlob  – Lighter and zk-rollup dexes (WASM signer → {txType, txInfo, txHash})
+//   EvmTx     – plain EVM transaction (reserved for future use)
 // ---------------------------------------------------------------------------
 
-export interface ActionStep {
+export interface Eip712ActionStep {
   action: ActionType
   typedData: PerpsTypedData
 }
 
-export interface SignedActionStep {
+export interface WasmBlobActionStep {
+  action: ActionType
+  wasmSignParams: Record<string, unknown>
+}
+
+export interface EvmTxActionStep {
+  action: ActionType
+  txParams: Record<string, unknown>
+}
+
+export type ActionStep = Eip712ActionStep | WasmBlobActionStep | EvmTxActionStep
+
+export interface Eip712SignedActionStep {
   action: ActionType
   typedData: PerpsTypedData
   signature: Hex
 }
 
+export interface WasmBlobSignedActionStep {
+  action: ActionType
+  wasmSignParams: Record<string, unknown>
+  signedTx: {
+    txType: number
+    txInfo: string
+    txHash: string
+  }
+}
+
+export interface EvmTxSignedActionStep {
+  action: ActionType
+  txParams: Record<string, unknown>
+  txHash: string
+}
+
+export type SignedActionStep =
+  | Eip712SignedActionStep
+  | WasmBlobSignedActionStep
+  | EvmTxSignedActionStep
+
 export interface ActionResult {
   action: ActionType
   success: boolean
@@ -80,6 +120,12 @@ export interface PlaceOrderParams {
   size: string
   price?: string
   leverage?: number
+  /**
+   * Margin mode to use for the position. When omitted, the backend falls back
+   * to the provider's default (currently CROSS for both Hyperliquid and
+   * Lighter). Callers should set this explicitly when they need ISOLATED.
+   */
+  marginMode?: MarginMode
   reduceOnly?: boolean
   timeInForce?: TimeInForce
   expiresAt?: string
@@ -105,6 +151,12 @@ export interface ModifyOrderParams {
 export interface UpdateLeverageParams {
   asset: AssetIdentity
   leverage: number
+  /**
+   * Margin mode to use for the position. When omitted, the backend falls back
+   * to the provider's default (currently CROSS for both Hyperliquid and
+   * Lighter). Callers should set this explicitly when they need ISOLATED.
+   */
+  marginMode?: MarginMode
 }
 
 export interface UpdatePositionMarginParams {
@@ -118,6 +170,15 @@ export interface WithdrawalParams {
   amount: string
 }
 
+export interface DepositParams {
+  /** Amount of the token to deposit (human-readable, e.g. "100.5"). */
+  amount: string
+  /** ERC-20 token address on the source chain. */
+  tokenAddress: Address
+  /** Chain ID of the source chain (e.g. 1 for Ethereum, 42161 for Arbitrum). */
+  chainId: number
+}
+
 export interface ApproveAgentParams {
   agentAddress: string
   agentTtlMs?: number
@@ -138,6 +199,18 @@ export interface SendAssetParams {
 // ActionParamsMap — compile-time type resolution for SDK
 // ---------------------------------------------------------------------------
 
+export interface CancelAllOrdersParams {
+  /** 0=immediate (cancel GTC), 1=scheduled, 2=abort scheduled */
+  timeInForce: number
+  /** Unix timestamp in milliseconds (required for scheduled cancels) */
+  timestampMs?: number
+}
+
+export interface RegisterApiKeyParams {
+  /** The API key slot index to register (0-255). Reusing a fixed slot overwrites the old key. */
+  apiKeyIndex: number
+}
+
 export interface ActionParamsMap {
   [ActionType.APPROVE_AGENT]: ApproveAgentParams
   [ActionType.APPROVE_BUILDER_FEE]: Record<string, never>
@@ -145,12 +218,16 @@ export interface ActionParamsMap {
   [ActionType.AGENT_SET_ABSTRACTION]: SetAbstractionParams
   [ActionType.SEND_ASSET]: SendAssetParams
   [ActionType.WITHDRAWAL]: WithdrawalParams
+  [ActionType.TRANSFER]: Record<string, never>
   [ActionType.PLACE_ORDER]: PlaceOrderParams
   [ActionType.PLACE_TRIGGER_ORDER]: PlaceTriggerOrderParams
   [ActionType.CANCEL_ORDER]: CancelOrderParams
+  [ActionType.CANCEL_ALL_ORDERS]: CancelAllOrdersParams
   [ActionType.MODIFY_ORDER]: ModifyOrderParams
   [ActionType.UPDATE_LEVERAGE]: UpdateLeverageParams
   [ActionType.UPDATE_POSITION_MARGIN]: UpdatePositionMarginParams
+  [ActionType.REGISTER_API_KEY]: RegisterApiKeyParams
+  [ActionType.DEPOSIT]: DepositParams
 }
 
 // ---------------------------------------------------------------------------

package/src/enums.ts

@@ -18,6 +18,7 @@ export enum PerpsErrorCode {
   MarketNotFound = 2023,
   OrderNotFound = 2024,
   PositionNotFound = 2025,
+  AccountNotFound = 2026,
 
   // Nonce errors (2040-2049)
   InvalidNonce = 2040,
@@ -81,6 +82,11 @@ export enum FillStatus {
   REJECTED = 'REJECTED',
 }
 
+export enum LiquidityRole {
+  MAKER = 'maker',
+  TAKER = 'taker',
+}
+
 export enum ActionType {
   APPROVE_AGENT = 'approveAgent',
   APPROVE_BUILDER_FEE = 'approveBuilderFee',
@@ -88,12 +94,16 @@ export enum ActionType {
   AGENT_SET_ABSTRACTION = 'agentSetAbstraction',
   SEND_ASSET = 'sendAsset',
   WITHDRAWAL = 'withdrawal',
+  TRANSFER = 'transfer',
   PLACE_ORDER = 'placeOrder',
   PLACE_TRIGGER_ORDER = 'placeTriggerOrder',
   CANCEL_ORDER = 'cancelOrder',
+  CANCEL_ALL_ORDERS = 'cancelAllOrders',
   MODIFY_ORDER = 'modifyOrder',
   UPDATE_LEVERAGE = 'updateLeverage',
   UPDATE_POSITION_MARGIN = 'updatePositionMargin',
+  REGISTER_API_KEY = 'registerApiKey',
+  DEPOSIT = 'deposit',
 }
 
 export enum TriggerCondition {
@@ -117,6 +127,7 @@ export enum ActivityType {
   WITHDRAWAL = 'WITHDRAWAL',
   LIQUIDATION = 'LIQUIDATION',
   FUNDING = 'FUNDING',
+  TRANSFER = 'TRANSFER',
 }
 
 export enum FillClassification {
@@ -156,4 +167,11 @@ export type ActivityClassification =
 export enum PerpsSigner {
   USER = 'USER',
   AGENT = 'AGENT',
+  API_KEY = 'API_KEY',
+}
+
+export enum SigningMethod {
+  EIP712 = 'eip712',
+  WASM_BLOB = 'wasmBlob',
+  EVM_TX = 'evmTx',
 }

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

@@ -1,6 +1,7 @@
 import {
   FillClassification,
   FillStatus,
+  LiquidityRole,
   OrderSide,
   OrderType,
 } from '../../../enums.js'
@@ -53,6 +54,7 @@ export function classifyFillFromPosition(
 
 export const mapFill = (fill: HlUserFill): Fill => ({
   id: String(fill.tid),
+  orderId: String(fill.oid),
   asset: {
     assetId: fill.coin,
     market: '',
@@ -64,6 +66,7 @@ export const mapFill = (fill: HlUserFill): Fill => ({
   size: fill.sz,
   price: fill.px,
   status: FillStatus.FILLED,
+  liquidity: fill.crossed ? LiquidityRole.TAKER : LiquidityRole.MAKER,
   filledSize: fill.sz,
   fee: fill.fee,
   realizedPnl: fill.closedPnl === '0' ? null : fill.closedPnl,

package/src/providers/hyperliquid/types.ts

@@ -143,6 +143,7 @@ export type HlExtraAgents = Record<string, unknown>[]
 
 export type HlUserFill = {
   tid: number
+  oid: number
   coin: string
   side: string
   sz: string
@@ -150,6 +151,7 @@ export type HlUserFill = {
   dir: string
   fee: string
   closedPnl: string
+  crossed: boolean
   time: number
   startPosition: string
 }
@@ -278,3 +280,30 @@ export type HlExchangeResponse = {
         }
       }
 }
+
+// ---------------------------------------------------------------------------
+// Hyperliquid EIP-712 primary type constants
+// ---------------------------------------------------------------------------
+
+export const HL_PRIMARY_TYPE_APPROVE_AGENT =
+  'HyperliquidTransaction:ApproveAgent' as const
+export const HL_PRIMARY_TYPE_APPROVE_BUILDER_FEE =
+  'HyperliquidTransaction:ApproveBuilderFee' as const
+export const HL_PRIMARY_TYPE_USER_SET_ABSTRACTION =
+  'HyperliquidTransaction:UserSetAbstraction' as const
+export const HL_PRIMARY_TYPE_AGENT_SET_ABSTRACTION =
+  'HyperliquidTransaction:AgentSetAbstraction' as const
+export const HL_PRIMARY_TYPE_WITHDRAW =
+  'HyperliquidTransaction:Withdraw' as const
+export const HL_PRIMARY_TYPE_SEND_ASSET =
+  'HyperliquidTransaction:SendAsset' as const
+export const HL_PRIMARY_TYPE_AGENT = 'Agent' as const
+
+export type HlPrimaryType =
+  | typeof HL_PRIMARY_TYPE_APPROVE_AGENT
+  | typeof HL_PRIMARY_TYPE_APPROVE_BUILDER_FEE
+  | typeof HL_PRIMARY_TYPE_USER_SET_ABSTRACTION
+  | typeof HL_PRIMARY_TYPE_AGENT_SET_ABSTRACTION
+  | typeof HL_PRIMARY_TYPE_WITHDRAW
+  | typeof HL_PRIMARY_TYPE_SEND_ASSET
+  | typeof HL_PRIMARY_TYPE_AGENT

package/src/providers/lighter/apiTypes.ts

@@ -0,0 +1,84 @@
+// ---------------------------------------------------------------------------
+// Lighter raw API response types — shared between backend (REST) and SDK (WS)
+// ---------------------------------------------------------------------------
+
+export type LtAccountPosition = {
+  market_id: number
+  symbol: string
+  initial_margin_fraction: string
+  open_order_count: number
+  pending_order_count: number
+  position_tied_order_count: number
+  sign: number
+  position: string
+  avg_entry_price: string
+  position_value: string
+  unrealized_pnl: string
+  realized_pnl: string
+  liquidation_price: string
+  total_funding_paid_out: string
+  margin_mode: number
+  allocated_margin: string
+  total_discount: string
+}
+
+export type LtAccountAsset = {
+  symbol: string
+  asset_id: number
+  balance: string
+  locked_balance: string
+}
+
+export type LtTrade = {
+  trade_id: number
+  tx_hash: string
+  type: string
+  market_id: number
+  size: string
+  price: string
+  usd_amount: string
+  ask_id: number
+  bid_id: number
+  ask_account_id: number
+  bid_account_id: number
+  is_maker_ask: boolean
+  block_height: number
+  timestamp: number
+  // Lighter's OpenAPI spec marks these as required `StrictInt`, but the live
+  // /api/v1/trades endpoint omits them on some `type: "trade"` rows (observed
+  // on older trades). Treat as optional and let the mapper produce `undefined`
+  // for Fill.fee (already optional) when missing.
+  taker_fee?: number
+  maker_fee?: number
+  transaction_time: number
+}
+
+export type LtOrder = {
+  order_index: number
+  client_order_index: number
+  order_id: string
+  client_order_id: string
+  market_index: number
+  owner_account_index: number
+  initial_base_amount: string
+  price: string
+  nonce: number
+  remaining_base_amount: string
+  is_ask: boolean
+  filled_base_amount: string
+  filled_quote_amount: string
+  side: string
+  type: string
+  time_in_force: string
+  reduce_only: boolean
+  trigger_price: string
+  order_expiry: number
+  status: string
+  trigger_status: string
+  trigger_time: number
+  block_height: number
+  timestamp: number
+  created_at: number
+  updated_at: number
+  transaction_time: number
+}

package/src/providers/lighter/index.ts

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