@pear-protocol/exchanges-sdk 0.14.1 → 0.16.0

package/dist/index.d.ts

@@ -176,9 +176,17 @@ declare class HyperliquidExchangeWs extends ExchangeWs {
     }): Promise<HyperliquidExchangeWs>;
 }
 
+/**
+ * The connector values that are deployments of the Lighter stack. The deployments share the
+ * protocol but nothing else — hosts, account indices, and market indices are all per-deployment —
+ * so every Lighter code path in this SDK names the deployment it reads instead of assuming one.
+ */
+type LighterConnector = Extract<Connector, 'lighter' | 'lighter_rhc'>;
+
 declare class LighterWs extends BaseWs {
+    private readonly connector;
     private readonly demo;
-    constructor(demo?: boolean);
+    constructor(connector: LighterConnector, demo?: boolean);
     protected getWsUrl(): string;
     protected getPingIntervalMs(): number;
     protected buildPingMessage(): WsMessage;
@@ -188,10 +196,13 @@ declare class LighterWs extends BaseWs {
 
 declare class LighterExchangeWs extends ExchangeWs {
     main: LighterWs;
-    readonly exchange: "lighter";
-    constructor(main: LighterWs);
+    readonly exchange: LighterConnector;
+    /** Binds the socket bundle to the deployment that opened it, so consumers can tell them apart. */
+    constructor(exchange: LighterConnector, main: LighterWs);
     protected connections(): BaseWs[];
-    static create(config?: {
+    /** Opens the deployment's stream and returns the bundle only once it is connected. */
+    static create(config: {
+        connector: LighterConnector;
         demo: boolean;
     }): Promise<LighterExchangeWs>;
 }
@@ -227,6 +238,7 @@ type ExchangeWsByConnector = {
     okx: OkxExchangeWs;
     hyperliquid: HyperliquidExchangeWs;
     lighter: LighterExchangeWs;
+    lighter_rhc: LighterExchangeWs;
 };
 type CreateExchangeWsConfig = {
     demo: boolean;
@@ -405,7 +417,7 @@ type LighterAuthCredentials = {
     apiPrivateKey: string;
 };
 /** Returns a live token while coalescing concurrent signing requests. */
-declare function retrieveLighterAuthToken(sdk: PearSDK, credentials: LighterAuthCredentials, demo: boolean): Promise<string>;
+declare function retrieveLighterAuthToken(sdk: PearSDK, connector: LighterConnector, credentials: LighterAuthCredentials, demo: boolean): Promise<string>;
 
 type WalletClientWithAccount = WalletClient<Transport, Chain | undefined, Account>;
 
@@ -458,6 +470,13 @@ declare const usdcAbi: readonly [{
 /** Names native USDC for a source chain this SDK can transfer from safely. */
 declare function getLighterNativeUsdcAddress(chainId: number): `0x${string}` | undefined;
 
+/**
+ * Asset indices on Lighter's Robinhood Chain deployment that this SDK names. Only the collateral is
+ * needed today — RHC's equity assets are read by index and shown as such until a flow needs them.
+ */
+declare const LighterRhcAssetId: {
+    readonly USDG: 3;
+};
 declare const AssetId: {
     readonly ETH: 1;
     readonly LIT: 2;
@@ -476,7 +495,30 @@ declare const RouteType: {
 };
 type RouteType = (typeof RouteType)[keyof typeof RouteType];
 declare const MIN_LIGHTER_CCTP_DEPOSIT_USDC = "5";
-declare const MIN_LIGHTER_FAST_WITHDRAW_USDC = "4";
+/**
+ * Fast-withdraw floor per deployment, in that deployment's own collateral.
+ *
+ * Lighter documents the zkLighter floor as "Fast Withdrawal (USDC only, 4 USDC minimum)" and
+ * publishes no floor for Robinhood Chain; `/api/v1/fastwithdraw/info` reports `withdraw_limit`
+ * and `max_withdrawal_amount` but no minimum, so the value cannot be read from the venue either.
+ * Robinhood Chain therefore carries zkLighter's number until the venue states its own — correcting
+ * it is one line here, and the venue rejects a short transfer regardless.
+ */
+declare const MIN_LIGHTER_FAST_WITHDRAW_COLLATERAL: Record<LighterConnector, string>;
+declare const MIN_LIGHTER_RHC_DEPOSIT_USDG = "1";
+/**
+ * Robinhood Chain's EVM chain id — the chain a deposit is sent on, not the id the signer signs
+ * under. Read from Lighter's own deposit network list at runtime; this constant only lets a caller
+ * configure a wallet for the chain before any read has happened.
+ */
+declare const LIGHTER_RHC_CHAIN_ID = 4663;
+/**
+ * USDG on Robinhood Chain, as `assetDetails` reports its `l1_address` for asset index 3, verified
+ * on chain to answer `USDG` and six decimals. A deposit transfers this token and nothing else.
+ */
+declare const LIGHTER_RHC_USDG_ADDRESS: "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168";
+/** USDG carries six decimals, matching the venue's own units. */
+declare const LIGHTER_RHC_USDG_DECIMALS = 6;
 /** Lighter L2/base-amount precision (`assetDetails.decimals`). */
 declare const L2_ASSET_DECIMALS: Record<number, number>;
 /**
@@ -640,7 +682,7 @@ type CctpDepositParams = {
     connectedAddress: `0x${string}` | undefined;
     /** A `chainId` from `listCctpDepositNetworks()`; the connected wallet must already be on it. */
     chainId: number;
-    /** Positive human-readable USDC amount with at most six fractional digits. */
+    /** Positive human-readable collateral amount (USDC on zkLighter, USDG on RHC), at most six fractional digits. */
     amount: string;
     /** Supplies wallet transport operations without coupling the SDK to Wagmi. */
     wallet: LighterDepositWalletAdapter;
@@ -749,6 +791,65 @@ type FunxyzDepositAddressResult = {
     credits: FunxyzDepositCredit;
 };
 type LighterDepositAddressResult = CctpDepositAddressResult | FunxyzDepositAddressResult;
+/**
+ * What minting a Robinhood Chain deposit address needs.
+ *
+ * No route tag and no chain id: Robinhood Chain offers exactly one deposit method on exactly one
+ * chain, so there is nothing to select. A second of either would be a new contract, not a new field.
+ */
+type LighterRhcDepositAddressParams = {
+    /** The L1 owner whose Lighter account receives funds, not necessarily the sender. */
+    ownerAddress: `0x${string}`;
+};
+/**
+ * Wallet transport a Robinhood Chain deposit borrows from its caller.
+ *
+ * Separate from `LighterDepositWalletAdapter`, which reads native USDC: this deployment moves USDG
+ * on its own chain, so the token is named rather than inferred from a chain id.
+ */
+type LighterRhcDepositWallet = {
+    /** Reads one ERC-20 balance for an owner on one chain. */
+    readTokenBalance: (chainId: number, token: `0x${string}`, ownerAddress: `0x${string}`) => Promise<bigint>;
+    /** Moves the connector to the chain and returns a wallet client bound to it. */
+    retrieveWallet: (chainId: number) => Promise<WalletClientWithAccount>;
+    /** Resolves once the chain has mined the transfer, throwing when it reverted. */
+    confirmTransaction: (chainId: number, txHash: string) => Promise<void>;
+};
+/** What sending USDG from the connected wallet into a Robinhood Chain account needs. */
+type LighterRhcDepositParams = {
+    /** The L1 owner whose Lighter account receives funds. */
+    ownerAddress: `0x${string}`;
+    /** The wallet currently connected in the browser, which must be the owner. */
+    connectedAddress: `0x${string}` | undefined;
+    /** Positive human-readable USDG amount with at most six fractional digits. */
+    amount: string;
+    wallet: LighterRhcDepositWallet;
+    /** Receives transfer-confirmation and Lighter-settlement state changes. */
+    onProgress: (progress: LighterDepositProgress) => void;
+    /** Cancels the settlement watch; the transfer itself is already on chain. */
+    signal?: AbortSignal;
+    /** Caps the settlement watch; defaults to the shared one-hour limit. */
+    settlementTimeoutMs?: number;
+};
+/** What a submitted Robinhood Chain deposit reports back. */
+type LighterRhcDepositResult = {
+    txHash: string;
+    /** The address the transfer was sent to, which keeps crediting this owner. */
+    intentAddress: `0x${string}`;
+    chainId: number;
+};
+/**
+ * The address USDG is sent to, and the chain it must arrive on.
+ *
+ * Persistent, unlike a CCTP intent: Lighter binds it to the address that generated it and returns
+ * the same one on every request, so there is no expiry for a caller to race.
+ */
+type LighterRhcDepositAddressResult = {
+    /** Send at least `MIN_LIGHTER_RHC_DEPOSIT_USDG` in USDG on `chainId` to this address. */
+    intentAddress: `0x${string}`;
+    /** The chain the address credits from, as Lighter's own deposit network list names it. */
+    chainId: number;
+};
 type WithdrawParams = {
     accountIndex: number;
     assetId: number;
@@ -890,6 +991,34 @@ interface LighterHelper {
     /** Reads one page of the owner's referral record, including the code that referred them. */
     getUserReferrals(params: LighterUserReferralsParams): Promise<LighterUserReferrals>;
 }
+/**
+ * Everything both Lighter deployments share.
+ *
+ * What it leaves out is what zkLighter wires to its own bridges and Ethereum contracts: the CCTP
+ * and Fun.xyz deposit routes, and the gateway withdrawal. Robinhood Chain runs none of them, so
+ * they are absent at the type level rather than refused at runtime.
+ */
+type LighterSharedHelper = Omit<LighterHelper, 'listCctpDepositNetworks' | 'deposit' | 'createDepositAddress' | 'withdraw' | 'listUdaDeposits'>;
+/**
+ * The helper surface for Lighter's Robinhood Chain deployment.
+ *
+ * The shared surface plus the one deposit method RHC has of its own. Its on-chain withdrawal still
+ * has no equivalent here: that is RHC's own gateway contract, which this SDK does not yet call.
+ */
+type LighterRhcHelper = LighterSharedHelper & {
+    /**
+     * Mints the persistent address that credits this owner's Robinhood Chain account.
+     *
+     * Deliberately not zkLighter's route-tagged `createDepositAddress`: the two deployments share no
+     * deposit route, so a caller cannot pass a `cctp` or `funxyz` route here by mistake.
+     */
+    createDepositAddress(params: LighterRhcDepositAddressParams): Promise<LighterRhcDepositAddressResult>;
+    /**
+     * Sends USDG from the connected wallet into this owner's account, and follows it until Lighter
+     * registers the account. Also not zkLighter's route-tagged `deposit`: Robinhood Chain has one way in.
+     */
+    deposit(params: LighterRhcDepositParams): Promise<LighterRhcDepositResult>;
+};
 type LighterLookupResult = {
     mainAccountIndex: number;
     subAccountIndexes: number[];
@@ -926,10 +1055,19 @@ declare const MIN_USER_API_KEY_INDEX = 4;
 declare const MAX_API_KEY_INDEX = 254;
 declare function findAvailableApiKeyIndex(apiKeys: ReadonlyArray<Pick<ApiKey, 'api_key_index'>>): number;
 declare function createLighterHelper(sdk: PearSDK, demo?: boolean): LighterHelper;
+/**
+ * The helper for Lighter's Robinhood Chain deployment: the shared surface plus its own deposit.
+ *
+ * zkLighter's bridge deposits and gateway withdrawal stay absent — they are wired to contracts
+ * Robinhood Chain does not run. RHC funds instead through an intent address, and its on-chain
+ * withdrawal is still the venue's own front end.
+ */
+declare function createLighterRhcHelper(sdk: PearSDK, demo?: boolean): LighterRhcHelper;
 
 type ExchangeHelperMap = {
     hyperliquid: HyperliquidHelper;
     lighter: LighterHelper;
+    lighter_rhc: LighterRhcHelper;
 };
 type ExchangeHelperExchange = keyof ExchangeHelperMap;
 
@@ -1167,11 +1305,20 @@ declare class HyperliquidAccountSyncer extends BaseAccountSyncer<HyperliquidRawF
 }
 
 type RawFill$1 = LighterRawTrade;
+/** The syncer config narrowed to the deployments this syncer serves. */
+type LighterAccountSyncerConfig = AccountSyncerConfig & {
+    connector: LighterConnector;
+};
 declare class LighterAccountSyncer extends BaseAccountSyncer<RawFill$1> {
+    /**
+     * Narrows the connector the base constructor already assigned from the config. Declared, not
+     * assigned: the deployment has exactly one source, so no caller can hand in a second value.
+     */
+    protected connector: LighterConnector;
     private readonly accountIndex;
     private readonly apiKeyIndex;
     private readonly apiPrivateKey;
-    constructor(config: AccountSyncerConfig);
+    constructor(config: LighterAccountSyncerConfig);
     /** Returns this account's shared Lighter auth token. */
     private retrieveAuthToken;
     protected listExternalPositions({ instruments, }: ListExternalPositionsParams): Promise<HttpTypes.ExternalPosition[]>;
@@ -1300,6 +1447,7 @@ declare const AccountBalance: z.ZodDiscriminatedUnion<[z.ZodObject<{
         withdrawable: z.ZodString;
         ltv: z.ZodNullable<z.ZodString>;
         borrowCapUsed: z.ZodNullable<z.ZodString>;
+        borrowed: z.ZodString;
     }, z.core.$strip>>;
     tradingEquity: z.ZodNullable<z.ZodString>;
     vaultEquity: z.ZodString;
@@ -1311,6 +1459,13 @@ declare const AccountBalance: z.ZodDiscriminatedUnion<[z.ZodObject<{
     portfolioMarginRatio: z.ZodNullable<z.ZodString>;
     portfolioAccountLeverage: z.ZodNullable<z.ZodString>;
     borrowCapUsed: z.ZodNullable<z.ZodString>;
+    borrowedValue: z.ZodNullable<z.ZodString>;
+    healthFactor: z.ZodNullable<z.ZodString>;
+    borrowLendReserves: z.ZodArray<z.ZodObject<{
+        asset: z.ZodString;
+        borrowYearlyRate: z.ZodString;
+        supplyYearlyRate: z.ZodString;
+    }, z.core.$strip>>;
     perDexState: z.ZodArray<z.ZodObject<{
         dex: z.ZodString;
         collateralToken: z.ZodNullable<z.ZodNumber>;
@@ -2027,8 +2182,9 @@ type HyperliquidUnifiedBalance = z.infer<typeof HyperliquidUnifiedBalance>;
  *   accounts measured hold one — `0x0871deb3…` reports USDC at −957,802.15. An unsigned row cannot
  *   state that at all, which is the defect that made a borrowed pool indistinguishable from an
  *   untouched one.
- * - **two more columns.** `ltv` and `borrowCapUsed` are per-coin risk weights the venue renders
- *   beside the quantities, and both are PM-only wire fields.
+ * - **three more columns.** `ltv` and `borrowCapUsed` are per-coin risk weights the venue renders
+ *   beside the quantities, and both are PM-only wire fields. `borrowed`, the coin's outstanding
+ *   debt, is the third, and PM-only as well.
  *
  * The row is otherwise the shared shape: same keys, same meanings, so a consumer reading
  * `perCollateral` without narrowing still reads `asset` / `equity` / `availableMargin` /
@@ -2041,8 +2197,16 @@ declare const HyperliquidPortfolioMarginCollateral: z.ZodObject<{
     withdrawable: z.ZodString;
     ltv: z.ZodNullable<z.ZodString>;
     borrowCapUsed: z.ZodNullable<z.ZodString>;
+    borrowed: z.ZodString;
 }, z.core.$strip>;
 type HyperliquidPortfolioMarginCollateral = z.infer<typeof HyperliquidPortfolioMarginCollateral>;
+/** One borrow/lend reserve's yearly rates, named by its coin's wire name. */
+declare const HyperliquidBorrowLendReserve: z.ZodObject<{
+    asset: z.ZodString;
+    borrowYearlyRate: z.ZodString;
+    supplyYearlyRate: z.ZodString;
+}, z.core.$strip>;
+type HyperliquidBorrowLendReserve = z.infer<typeof HyperliquidBorrowLendReserve>;
 declare const HyperliquidPortfolioMarginBalance: z.ZodObject<{
     totalEquity: z.ZodNullable<z.ZodString>;
     withdrawableBalance: z.ZodNullable<z.ZodString>;
@@ -2057,6 +2221,7 @@ declare const HyperliquidPortfolioMarginBalance: z.ZodObject<{
         withdrawable: z.ZodString;
         ltv: z.ZodNullable<z.ZodString>;
         borrowCapUsed: z.ZodNullable<z.ZodString>;
+        borrowed: z.ZodString;
     }, z.core.$strip>>;
     tradingEquity: z.ZodNullable<z.ZodString>;
     vaultEquity: z.ZodString;
@@ -2068,6 +2233,13 @@ declare const HyperliquidPortfolioMarginBalance: z.ZodObject<{
     portfolioMarginRatio: z.ZodNullable<z.ZodString>;
     portfolioAccountLeverage: z.ZodNullable<z.ZodString>;
     borrowCapUsed: z.ZodNullable<z.ZodString>;
+    borrowedValue: z.ZodNullable<z.ZodString>;
+    healthFactor: z.ZodNullable<z.ZodString>;
+    borrowLendReserves: z.ZodArray<z.ZodObject<{
+        asset: z.ZodString;
+        borrowYearlyRate: z.ZodString;
+        supplyYearlyRate: z.ZodString;
+    }, z.core.$strip>>;
     perDexState: z.ZodArray<z.ZodObject<{
         dex: z.ZodString;
         collateralToken: z.ZodNullable<z.ZodNumber>;
@@ -2085,9 +2257,10 @@ type HyperliquidPortfolioMarginBalance = z.infer<typeof HyperliquidPortfolioMarg
  * Both fill the same `HyperliquidBalanceContext` and hand it to the same mapper, which is what
  * makes "same account state, same balance" true across two different transports. The tracker takes
  * every CHANGING value off a channel — `allDexsClearinghouseState`, `spotState`, `webData3`,
- * `allMids`, `activeAssetData` — including vault equity, which rides `webData3`. Its only REST
- * reads happen at `start()`: the static dex metadata, and the staking position, which the venue
- * publishes on no channel at all.
+ * `allMids`, `activeAssetData` — including vault equity, which rides `webData3`, save one:
+ * Portfolio Margin's health factor and reserve rates ride no channel, so it polls them while the
+ * account is in that mode. Its only other REST reads happen at `start()`: the static dex metadata,
+ * and the staking position, which the venue publishes on no channel at all.
  *
  * The snapshot has no channels, so it reads the same figures over REST — vault equity from
  * `userVaultEquities`, which was measured equal to the `webData3` figure on ten live accounts.
@@ -2109,6 +2282,11 @@ declare class HyperliquidAccountTracker extends BaseAccountTracker {
     /** Portfolio Margin's own risk scalars, which ride the same `spotState` frame the balances do. */
     private portfolioMarginRatio;
     private borrowRatioByToken;
+    /** Portfolio Margin's REST-only figures, and the timer that keeps them fresh while in that mode. */
+    private borrowLend;
+    private borrowLendPollTimer;
+    /** Advances on every stop, so a read fired in an earlier poll period is recognised and dropped. */
+    private borrowLendPollGeneration;
     private hasSpotState;
     private hasClearinghouseState;
     private accountType;
@@ -2167,6 +2345,27 @@ declare class HyperliquidAccountTracker extends BaseAccountTracker {
      * vault. Partial equity is worse than no equity, so nothing is published early.
      */
     private buildBalance;
+    /**
+     * Runs the borrow/lend poll exactly while the account is in Portfolio Margin.
+     *
+     * Safe to call on every mode read: a poll already in the state the mode asks for is left alone,
+     * so a steady stream of `webData3` frames neither restarts the timer nor refires a read.
+     */
+    private syncBorrowLendPoll;
+    /**
+     * Stops the borrow/lend poll and drops its figures, so no later mode or session inherits them.
+     *
+     * Every stop opens a new generation — a session ending, a restart, or the account leaving
+     * Portfolio Margin — so a read still in flight from the period just ended can never land.
+     */
+    private stopBorrowLendPoll;
+    /**
+     * Reads the health factor and reserve rates once, then republishes the balance with them.
+     *
+     * A failed read is reported and left for the next tick: the previous figures stay in place, since
+     * one missed read says nothing about the account that the last good one did not.
+     */
+    private refreshBorrowLendState;
     /** The floor of `availableToTrade` over the tracked set; `null` when nothing is tracked. */
     private availableMargin;
     /** Clears both sides of the live balance join and the public account cache without emitting. */
@@ -2236,9 +2435,17 @@ declare const LighterUnifiedBalance: z.ZodObject<{
 }, z.core.$strip>;
 type LighterUnifiedBalance = z.infer<typeof LighterUnifiedBalance>;
 
+/**
+ * The collateral asset each Lighter deployment margins perps in, as the venue names it in account
+ * payloads. Everything else about the balance model is identical across deployments.
+ */
+declare const LIGHTER_QUOTE_ASSETS: Record<LighterConnector, string>;
+
 type LighterAccountTrackerConfig = AccountTrackerConfig & {
     /** Null leaves the tier unread: `/accountLimits` is authenticated and only Core mints a token. */
     sdk: PearSDK | null;
+    /** The Lighter deployment this account lives on; hosts and collateral follow it. */
+    connector: LighterConnector;
     account: TradeAccount;
     credentials: SupportedCredentials;
 };
@@ -2246,6 +2453,8 @@ type LighterAccountTrackerConfig = AccountTrackerConfig & {
 type AccountTierCallback = (tier: LighterAccountTier | null) => void;
 declare class LighterAccountTracker extends BaseAccountTracker {
     private readonly sdk;
+    private readonly connector;
+    private readonly quoteAsset;
     private readonly accountIdentifier;
     private readonly apiKeyIndex;
     private readonly apiPrivateKey;
@@ -2621,4 +2830,4 @@ declare class ExchangesSDK {
     private fetchCredentials;
 }
 
-export { ACCOUNT_MODE_LABELS, ASSET_DECIMALS, AccountBalance, AccountBalanceCore, type AccountHealthStatus, AccountMode, type AccountPosition, type AccountSnapshot, type AccountStatus, type AccountSyncer, type AccountSyncerConfig, type AccountTierCallback, type AccountTracker, type AccountTrackerConfig, type AccountWarningReason, type ApiKey, type ApproveIntegratorParams, type ApproveIntegratorResult, AssetId, type AssetSnapshotMap, type BalanceCallback, BaseAccountSyncer, BaseAccountTracker, BaseWs, BinanceAccountSyncer, BinanceAccountTracker, type BinanceAccountTrackerConfig, BinanceExchangeWs, BinanceMultiAssetBalance, BinanceSingleAssetBalance, BinanceUserDataWs, type BinanceUserDataWsConfig, BinanceWsApi, type BinanceWsApiConfig, BybitAccountSyncer, BybitAccountTracker, type BybitAccountTrackerConfig, BybitExchangeWs, BybitIsolatedMarginBalance, BybitPortfolioMarginBalance, BybitRegularMarginBalance, BybitWs, type BybitWsConfig, type CctpDepositAddressParams, type CctpDepositAddressResult, type CctpDepositHistorySettlement, type CctpDepositParams, type CctpDepositRegistrationSettlement, type CctpDepositResult, type CctpDepositSettlement, type ChangeAccountTierParams, type ChangeAccountTierResult, type CheckApiWalletParams, CollateralBalance, type ConnectOptions, type ConnectWalletParams, type ConnectWalletResult, type CreateAccountTrackerConfig, type CreateExchangeWsConfig, DecimalString, type EthereumDepositParams, type EthereumDepositResult, type ExchangeConnection, type ExchangeHelperExchange, type ExchangeHelperMap, type ExchangeState, ExchangeWs, type ExchangeWsByConnector, ExchangesSDK, type ExchangesSDKConfig, FUNXYZ_DEPOSIT_MINIMUMS_USD, FUNXYZ_ETHEREUM_MAINNET_CHAIN_ID, FUNXYZ_EVM_CHAIN_NAMES, type FastWithdrawParams, type FastWithdrawResult, type FillSyncOutcome, type FundingSyncOutcome, type FunxyzAccountState, type FunxyzAsset, type FunxyzDepositAddressParams, type FunxyzDepositAddressResult, type FunxyzDepositCredit, type FunxyzDepositParams, type FunxyzDepositResult, type FunxyzDepositSettlement, type FunxyzDepositSource, type FunxyzMarket, HyperliquidAccountSyncer, HyperliquidAccountTracker, type HyperliquidAccountTrackerConfig, HyperliquidDexState, HyperliquidExchangeWs, type HyperliquidHelper, HyperliquidPortfolioMarginBalance, HyperliquidPortfolioMarginCollateral, HyperliquidStandardBalance, HyperliquidUnifiedBalance, HyperliquidWs, type IntegratorApprovalRequirements, L2_ASSET_DECIMALS, LIGHTER_NATIVE_USDC_ADDRESSES, LIGHTER_USDC_DECIMALS, LighterAccountSyncer, type LighterAccountTier, LighterAccountTracker, type LighterAccountTrackerConfig, type LighterApplyReferralCodeParams, type LighterAuthCredentials, LighterClassicBalance, type LighterDeposit, type LighterDepositAddressParams, type LighterDepositAddressResult, type LighterDepositCredit, type LighterDepositHistoryParams, type LighterDepositNetwork, type LighterDepositPage, type LighterDepositParams, type LighterDepositProgress, type LighterDepositResult, type LighterDepositStatus, type LighterDepositWalletAdapter, LighterExchangeWs, type LighterHelper, type LighterLookupResult, type LighterOnboardingStatus, type LighterReferral, type LighterReferralTotals, type LighterReferralTradeStats, LighterUnifiedBalance, type LighterUserReferrals, type LighterUserReferralsParams, type LighterWithdraw, type LighterWithdrawHistoryParams, type LighterWithdrawPage, type LighterWithdrawStatus, type LighterWithdrawType, LighterWs, type ListExternalFillsParams, type ListExternalFundingParams, type ListExternalPositionsParams, MAX_API_KEY_INDEX, MIN_LIGHTER_CCTP_DEPOSIT_USDC, MIN_LIGHTER_FAST_WITHDRAW_USDC, MIN_USER_API_KEY_INDEX, MarginMode, type MessageListener, OkxAccountSyncer, OkxAccountTracker, type OkxAccountTrackerConfig, OkxExchangeWs, OkxFuturesBalance, OkxMultiCurrencyMarginBalance, OkxPortfolioMarginBalance, OkxSpotBalance, OkxWs, type OkxWsConfig, type OpenListener, type PositionsCallback, RouteType, Side, SignedDecimalString, type StateUpdate, type SupportedCredentials, type SyncerThrottle, type TrackedAssetCallback, type TrackedAssetInfo, type WalletClientWithAccount, type WithdrawParams, type WithdrawResult, type WsMessage, createAccountSyncer, createAccountTracker, createExchangeWs, createHyperliquidHelper, createLighterHelper, findAvailableApiKeyIndex, getAssetDecimals, getLighterNativeUsdcAddress, listFunxyzTransferableChains, readFunxyzChainSource, readFunxyzMinimumUsd, retrieveLighterAuthToken, usdcAbi };
+export { ACCOUNT_MODE_LABELS, ASSET_DECIMALS, AccountBalance, AccountBalanceCore, type AccountHealthStatus, AccountMode, type AccountPosition, type AccountSnapshot, type AccountStatus, type AccountSyncer, type AccountSyncerConfig, type AccountTierCallback, type AccountTracker, type AccountTrackerConfig, type AccountWarningReason, type ApiKey, type ApproveIntegratorParams, type ApproveIntegratorResult, AssetId, type AssetSnapshotMap, type BalanceCallback, BaseAccountSyncer, BaseAccountTracker, BaseWs, BinanceAccountSyncer, BinanceAccountTracker, type BinanceAccountTrackerConfig, BinanceExchangeWs, BinanceMultiAssetBalance, BinanceSingleAssetBalance, BinanceUserDataWs, type BinanceUserDataWsConfig, BinanceWsApi, type BinanceWsApiConfig, BybitAccountSyncer, BybitAccountTracker, type BybitAccountTrackerConfig, BybitExchangeWs, BybitIsolatedMarginBalance, BybitPortfolioMarginBalance, BybitRegularMarginBalance, BybitWs, type BybitWsConfig, type CctpDepositAddressParams, type CctpDepositAddressResult, type CctpDepositHistorySettlement, type CctpDepositParams, type CctpDepositRegistrationSettlement, type CctpDepositResult, type CctpDepositSettlement, type ChangeAccountTierParams, type ChangeAccountTierResult, type CheckApiWalletParams, CollateralBalance, type ConnectOptions, type ConnectWalletParams, type ConnectWalletResult, type CreateAccountTrackerConfig, type CreateExchangeWsConfig, DecimalString, type EthereumDepositParams, type EthereumDepositResult, type ExchangeConnection, type ExchangeHelperExchange, type ExchangeHelperMap, type ExchangeState, ExchangeWs, type ExchangeWsByConnector, ExchangesSDK, type ExchangesSDKConfig, FUNXYZ_DEPOSIT_MINIMUMS_USD, FUNXYZ_ETHEREUM_MAINNET_CHAIN_ID, FUNXYZ_EVM_CHAIN_NAMES, type FastWithdrawParams, type FastWithdrawResult, type FillSyncOutcome, type FundingSyncOutcome, type FunxyzAccountState, type FunxyzAsset, type FunxyzDepositAddressParams, type FunxyzDepositAddressResult, type FunxyzDepositCredit, type FunxyzDepositParams, type FunxyzDepositResult, type FunxyzDepositSettlement, type FunxyzDepositSource, type FunxyzMarket, HyperliquidAccountSyncer, HyperliquidAccountTracker, type HyperliquidAccountTrackerConfig, HyperliquidBorrowLendReserve, HyperliquidDexState, HyperliquidExchangeWs, type HyperliquidHelper, HyperliquidPortfolioMarginBalance, HyperliquidPortfolioMarginCollateral, HyperliquidStandardBalance, HyperliquidUnifiedBalance, HyperliquidWs, type IntegratorApprovalRequirements, L2_ASSET_DECIMALS, LIGHTER_NATIVE_USDC_ADDRESSES, LIGHTER_QUOTE_ASSETS, LIGHTER_RHC_CHAIN_ID, LIGHTER_RHC_USDG_ADDRESS, LIGHTER_RHC_USDG_DECIMALS, LIGHTER_USDC_DECIMALS, LighterAccountSyncer, type LighterAccountSyncerConfig, type LighterAccountTier, LighterAccountTracker, type LighterAccountTrackerConfig, type LighterApplyReferralCodeParams, type LighterAuthCredentials, LighterClassicBalance, type LighterConnector, type LighterDeposit, type LighterDepositAddressParams, type LighterDepositAddressResult, type LighterDepositCredit, type LighterDepositHistoryParams, type LighterDepositNetwork, type LighterDepositPage, type LighterDepositParams, type LighterDepositProgress, type LighterDepositResult, type LighterDepositStatus, type LighterDepositWalletAdapter, LighterExchangeWs, type LighterHelper, type LighterLookupResult, type LighterOnboardingStatus, type LighterReferral, type LighterReferralTotals, type LighterReferralTradeStats, LighterRhcAssetId, type LighterRhcDepositAddressParams, type LighterRhcDepositAddressResult, type LighterRhcDepositParams, type LighterRhcDepositResult, type LighterRhcDepositWallet, type LighterRhcHelper, type LighterSharedHelper, LighterUnifiedBalance, type LighterUserReferrals, type LighterUserReferralsParams, type LighterWithdraw, type LighterWithdrawHistoryParams, type LighterWithdrawPage, type LighterWithdrawStatus, type LighterWithdrawType, LighterWs, type ListExternalFillsParams, type ListExternalFundingParams, type ListExternalPositionsParams, MAX_API_KEY_INDEX, MIN_LIGHTER_CCTP_DEPOSIT_USDC, MIN_LIGHTER_FAST_WITHDRAW_COLLATERAL, MIN_LIGHTER_RHC_DEPOSIT_USDG, MIN_USER_API_KEY_INDEX, MarginMode, type MessageListener, OkxAccountSyncer, OkxAccountTracker, type OkxAccountTrackerConfig, OkxExchangeWs, OkxFuturesBalance, OkxMultiCurrencyMarginBalance, OkxPortfolioMarginBalance, OkxSpotBalance, OkxWs, type OkxWsConfig, type OpenListener, type PositionsCallback, RouteType, Side, SignedDecimalString, type StateUpdate, type SupportedCredentials, type SyncerThrottle, type TrackedAssetCallback, type TrackedAssetInfo, type WalletClientWithAccount, type WithdrawParams, type WithdrawResult, type WsMessage, createAccountSyncer, createAccountTracker, createExchangeWs, createHyperliquidHelper, createLighterHelper, createLighterRhcHelper, findAvailableApiKeyIndex, getAssetDecimals, getLighterNativeUsdcAddress, listFunxyzTransferableChains, readFunxyzChainSource, readFunxyzMinimumUsd, retrieveLighterAuthToken, usdcAbi };

package/dist/sdk.js

@@ -63,6 +63,12 @@ class ExchangesSDK {
           sdk: this.sdk,
           demo: this.demo
         });
+      case "lighter_rhc":
+        return createExchangeHelper({
+          exchange: "lighter_rhc",
+          sdk: this.sdk,
+          demo: this.demo
+        });
     }
   }
   createSyncer(connection) {

package/dist/status/factory.js

@@ -17,7 +17,8 @@ function checkAccountStatus(exchange, config) {
     case "hyperliquid":
       return checkHyperliquidAccountStatus(config);
     case "lighter":
-      return checkLighterAccountStatus(config);
+    case "lighter_rhc":
+      return checkLighterAccountStatus(config, exchange);
     default: {
       const _exhaustive = exchange;
       throw new Error(`Unsupported exchange: ${String(_exhaustive)}`);

package/dist/status/lighter/status.js

@@ -5,7 +5,7 @@ import { warningStatus } from '../base';
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-async function checkLighterAccountStatus(config) {
+async function checkLighterAccountStatus(config, connector) {
   const reasons = [];
   const options = config.statusOptions;
   const integratorAccountIndex = options?.integratorAccountIndex;
@@ -20,25 +20,25 @@ async function checkLighterAccountStatus(config) {
     reasons.push("lighter_api_key_invalid");
   } else {
     try {
-      const token = await retrieveLighterAuthToken(config.sdk, {
+      const token = await retrieveLighterAuthToken(config.sdk, connector, {
         accountIndex,
         apiKeyIndex: credentials.api_key_index,
         apiPrivateKey: credentials.api_private_key
       }, config.demo);
-      await fetchAccountMetadata(accountIndex, token, config.demo);
+      await fetchAccountMetadata(accountIndex, token, connector, config.demo);
     } catch {
       reasons.push("lighter_api_key_invalid");
     }
   }
   if (integratorAccountIndex !== void 0 && integratorMinPerpsMakerFee !== void 0 && integratorMinPerpsTakerFee !== void 0) {
     try {
-      const token = await retrieveLighterAuthToken(config.sdk, {
+      const token = await retrieveLighterAuthToken(config.sdk, connector, {
         accountIndex,
         apiKeyIndex: credentials.api_key_index,
         apiPrivateKey: credentials.api_private_key
       }, config.demo);
       const helper = createExchangeHelper({
-        exchange: "lighter",
+        exchange: connector,
         sdk: config.sdk,
         demo: config.demo
       });

package/dist/syncer/factory.js

@@ -17,7 +17,11 @@ function createAccountSyncer(exchange, config) {
     case "hyperliquid":
       return new HyperliquidAccountSyncer(config);
     case "lighter":
-      return new LighterAccountSyncer(config);
+    case "lighter_rhc":
+      return new LighterAccountSyncer({
+        ...config,
+        connector: exchange
+      });
     default: {
       const _exhaustive = exchange;
       throw new Error(`Unsupported exchange: ${String(_exhaustive)}`);

package/dist/syncer/lighter/funding.js

@@ -2,7 +2,7 @@ import BigNumber from 'bignumber.js';
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-function toFundingPaymentEntries(events, instrumentIds) {
+function toFundingPaymentEntries(events, instrumentIds, connector) {
   return events.reduce((entries, event) => {
     const instrumentId = event.market_id.toString();
     if (!instrumentIds.has(instrumentId)) {
@@ -13,7 +13,7 @@ function toFundingPaymentEntries(events, instrumentIds) {
     const signedSize = event.position_side === "short" ? unsignedSize.negated() : unsignedSize;
     const fundingPerUnit = signedSize.isZero() ? "0" : new BigNumber(event.change).div(signedSize).toFixed();
     entries.push({
-      connector: "lighter",
+      connector,
       instrumentId,
       fundingRate: event.rate,
       notional: event.change,

package/dist/syncer/lighter/syncer.js

@@ -23,7 +23,7 @@ class LighterAccountSyncer extends BaseAccountSyncer {
   }
   /** Returns this account's shared Lighter auth token. */
   async retrieveAuthToken() {
-    return retrieveLighterAuthToken(this.sdk, {
+    return retrieveLighterAuthToken(this.sdk, this.connector, {
       accountIndex: this.accountIndex,
       apiKeyIndex: this.apiKeyIndex,
       apiPrivateKey: this.apiPrivateKey
@@ -36,7 +36,7 @@ class LighterAccountSyncer extends BaseAccountSyncer {
       instrument.precision.quantity.contractSize
     ]));
     const token = await this.retrieveAuthToken();
-    const response = await fetchAccount(this.accountIndex, token, this.demo, this.throttle);
+    const response = await fetchAccount(this.accountIndex, token, this.connector, this.demo, this.throttle);
     const rawPositions = response.accounts?.[0]?.positions ?? [];
     return rawPositions.reduce((positions, rawPosition) => {
       const instrumentId = rawPosition.market_id.toString();
@@ -59,7 +59,7 @@ class LighterAccountSyncer extends BaseAccountSyncer {
   async listExternalFills({ since, instruments }) {
     this.assertAuthenticatedSyncAvailable();
     const token = await this.retrieveAuthToken();
-    const trades = await fetchTradesSince(this.accountIndex, token, since, this.demo, this.throttle);
+    const trades = await fetchTradesSince(this.accountIndex, token, since, this.connector, this.demo, this.throttle);
     const instrumentIds = new Set(instruments.map((instrument) => instrument.id));
     return trades.toSorted((a, b) => a.timestamp - b.timestamp).reduce((fills, rawFill) => {
       const instrumentId = rawFill.market_id.toString();
@@ -71,7 +71,7 @@ class LighterAccountSyncer extends BaseAccountSyncer {
       if (!accountSide) return fills;
       const side = accountSide === "ask" ? "SELL" : "BUY";
       fills.push({
-        connector: "lighter",
+        connector: this.connector,
         exchangeFillId: rawFill.trade_id_str ?? rawFill.trade_id.toString(),
         cloid: this.getClientOrderId(rawFill, accountSide),
         symbol: instrumentId,
@@ -92,9 +92,9 @@ class LighterAccountSyncer extends BaseAccountSyncer {
   async listExternalFunding({ since, instruments }) {
     this.assertAuthenticatedSyncAvailable();
     const token = await this.retrieveAuthToken();
-    const fundingEvents = await fetchPositionFundingSince(this.accountIndex, token, since, this.demo, this.throttle);
+    const fundingEvents = await fetchPositionFundingSince(this.accountIndex, token, since, this.connector, this.demo, this.throttle);
     const instrumentIds = new Set(instruments.map((instrument) => instrument.id));
-    return toFundingPaymentEntries(fundingEvents, instrumentIds);
+    return toFundingPaymentEntries(fundingEvents, instrumentIds, this.connector);
   }
   isReduceOnly(rawFill) {
     if (rawFill.type === "liquidation" || rawFill.type === "deleverage" || rawFill.type === "market-settlement") {

package/dist/tracker/hyperliquid/balance.js

@@ -146,7 +146,22 @@ const HyperliquidPortfolioMarginCollateral = z.object({
   * `borrowed / borrow cap` for this coin, and `null` where the venue renders `--` — no borrow.
   * NOT clipped at one: `0x0871deb3…` reports 1.0081 on USDT0.
   */
-  borrowCapUsed: DecimalString.nullable()
+  borrowCapUsed: DecimalString.nullable(),
+  /**
+  * The coin's outstanding borrow in its own units, and `0` on a coin never borrowed.
+  *
+  * Read from the wire's `borrowed`, never from a negative `equity`: the USDC row already contains
+  * the perps account value, so `equity` is `supplied − borrowed + accountValue` and its negative
+  * understates the debt by exactly that wallet.
+  */
+  borrowed: DecimalString
+});
+const HyperliquidBorrowLendReserve = z.object({
+  asset: z.string(),
+  /** What borrowing the coin costs per year, as a fraction — `0.05` is 5% APY. */
+  borrowYearlyRate: DecimalString,
+  /** What supplying the coin earns per year; Portfolio Margin supplies idle balances automatically. */
+  supplyYearlyRate: DecimalString
 });
 const HyperliquidPortfolioMarginBalance = AccountBalanceCore.extend({
   accountMode: z.literal("hyperliquid:portfolioMargin"),
@@ -194,7 +209,27 @@ const HyperliquidPortfolioMarginBalance = AccountBalanceCore.extend({
   * account borrows nothing. Not clipped at one, and never the USDC entry alone.
   */
   borrowCapUsed: DecimalString.nullable(),
+  /**
+  * The venue's Your Borrowed: every row's `borrowed` valued at its own mid, in USD, and `0` when
+  * the account borrows nothing. Null when a borrowed coin cannot be priced, since a debt counted
+  * as zero would hide exactly the part nobody could value.
+  */
+  borrowedValue: DecimalString.nullable(),
+  /**
+  * The venue's Health Factor — LTV-weighted collateral over the borrowed value — at four decimals.
+  * Below `1` the account can borrow no more, which is not by itself liquidation: that is
+  * `portfolioMarginRatio`. Null when the account borrows nothing, and until the first read lands.
+  *
+  * Read, never derived, and over REST because no channel carries it: the live tracker refreshes it
+  * on a timer, so it can trail the channel-fed figures beside it by up to one poll interval.
+  */
+  healthFactor: DecimalString.nullable(),
+  /**
+  * Every reserve's yearly rates, listed whatever the account holds, so what a borrow will cost
+  * shows before the first one happens. Empty until the first read lands.
+  */
+  borrowLendReserves: z.array(HyperliquidBorrowLendReserve),
   perDexState: z.array(HyperliquidDexState)
 });
 
-export { HyperliquidDexState, HyperliquidPortfolioMarginBalance, HyperliquidPortfolioMarginCollateral, HyperliquidStandardBalance, HyperliquidUnifiedBalance };
+export { HyperliquidBorrowLendReserve, HyperliquidDexState, HyperliquidPortfolioMarginBalance, HyperliquidPortfolioMarginCollateral, HyperliquidStandardBalance, HyperliquidUnifiedBalance };

package/dist/tracker/hyperliquid/borrow-lend.js

@@ -0,0 +1,32 @@
+import { fetchBorrowLendUserState, fetchAllBorrowLendReserveStates } from '../../client/hyperliquid/rest';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const EMPTY_BORROW_LEND_STATE = {
+  healthFactor: null,
+  ratesByToken: /* @__PURE__ */ new Map()
+};
+async function fetchBorrowLendState(user, demo) {
+  const [userState, reserves] = await Promise.all([
+    fetchBorrowLendUserState(user, demo),
+    fetchAllBorrowLendReserveStates(demo)
+  ]);
+  return {
+    healthFactor: userState.healthFactor ?? null,
+    ratesByToken: ratesByToken(reserves)
+  };
+}
+__name(fetchBorrowLendState, "fetchBorrowLendState");
+function ratesByToken(reserves) {
+  const rates = /* @__PURE__ */ new Map();
+  for (const [token, reserve] of reserves) {
+    rates.set(token, {
+      borrowYearlyRate: reserve.borrowYearlyRate,
+      supplyYearlyRate: reserve.supplyYearlyRate
+    });
+  }
+  return rates;
+}
+__name(ratesByToken, "ratesByToken");
+
+export { EMPTY_BORROW_LEND_STATE, fetchBorrowLendState };