@pear-protocol/exchanges-sdk 0.14.0 → 0.15.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[]>;
@@ -2236,9 +2383,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 +2401,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 +2778,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, 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/index.js

@@ -15,6 +15,7 @@ export { BinanceMultiAssetBalance, BinanceSingleAssetBalance } from './binance/b
 export { BybitIsolatedMarginBalance, BybitPortfolioMarginBalance, BybitRegularMarginBalance } from './bybit/balance';
 export { HyperliquidDexState, HyperliquidPortfolioMarginBalance, HyperliquidPortfolioMarginCollateral, HyperliquidStandardBalance, HyperliquidUnifiedBalance } from './hyperliquid/balance';
 export { LighterClassicBalance, LighterUnifiedBalance } from './lighter/balance';
+export { LIGHTER_QUOTE_ASSETS } from './lighter/const';
 export { OkxFuturesBalance, OkxMultiCurrencyMarginBalance, OkxPortfolioMarginBalance, OkxSpotBalance } from './okx/balance';
 export * from './types';
 
@@ -48,8 +49,10 @@ function createAccountTracker(exchange, config) {
         credentials: config.credentials
       });
     case "lighter":
+    case "lighter_rhc":
       return new LighterAccountTracker({
         sdk: config.sdk,
+        connector: exchange,
         demo: config.demo,
         onError: config.onError,
         account: config.account,

package/dist/tracker/lighter/const.js

@@ -1,3 +1,6 @@
-const QUOTE_ASSET = "USDC";
+const LIGHTER_QUOTE_ASSETS = {
+  lighter: "USDC",
+  lighter_rhc: "USDG"
+};
 
-export { QUOTE_ASSET };
+export { LIGHTER_QUOTE_ASSETS };

package/dist/tracker/lighter/mapper.js

@@ -1,6 +1,5 @@
 import BigNumber from 'bignumber.js';
 import { positionKey } from '../utils';
-import { QUOTE_ASSET } from './const';
 import { LighterAccountType } from './types';
 
 var __defProp = Object.defineProperty;
@@ -19,8 +18,8 @@ function mapLiveBalance(stats, assets, positions, markets, timestamp) {
   const heldAssets = Array.from(assets);
   const risks = toPositionRisks(openPositions, markets.perpByMarketId);
   const crossEquity = toDecimal(stats.cross.portfolio_value);
-  const equity = toEquitySplit(heldAssets, markets.spotPriceBySymbol);
-  const perCollateral = toCollateralRows(heldAssets, stats.total.available_balance);
+  const equity = toEquitySplit(heldAssets, markets.spotPriceBySymbol, markets.quoteAsset);
+  const perCollateral = toCollateralRows(heldAssets, stats.total.available_balance, markets.quoteAsset);
   const crossMaintenance = asMarginRequirement(sumMaintenance(risks, "cross"));
   const isolatedMaintenance = asMarginRequirement(sumMaintenance(risks, "isolated"));
   return toLighterBalance({
@@ -51,8 +50,8 @@ function mapRestBalance(account, markets, timestamp) {
   const crossEquity = toDecimal(account.cross_asset_value);
   const crossMaintenance = toDecimal(account.cross_maintenance_margin_requirement);
   const isolatedMaintenance = asMarginRequirement(sumMaintenance(risks, "isolated"));
-  const equity = toEquitySplit(assets, markets.spotPriceBySymbol);
-  const perCollateral = toCollateralRows(assets, account.available_balance);
+  const equity = toEquitySplit(assets, markets.spotPriceBySymbol, markets.quoteAsset);
+  const perCollateral = toCollateralRows(assets, account.available_balance, markets.quoteAsset);
   return toLighterBalance({
     accountMode: ACCOUNT_MODE_BY_TYPE[toLighterAccountType(account.account_trading_mode)],
     equity,
@@ -119,10 +118,10 @@ function mapMarketDefaultAssetInfo(market) {
   };
 }
 __name(mapMarketDefaultAssetInfo, "mapMarketDefaultAssetInfo");
-function buildSpotPriceIndex(spotMarkets) {
+function buildSpotPriceIndex(spotMarkets, quoteAsset) {
   const priceBySymbol = /* @__PURE__ */ new Map([
     [
-      QUOTE_ASSET,
+      quoteAsset,
       "1"
     ]
   ]);
@@ -206,11 +205,11 @@ function toLighterBalance(figures) {
   }
 }
 __name(toLighterBalance, "toLighterBalance");
-function toEquitySplit(assets, priceBySymbol) {
+function toEquitySplit(assets, priceBySymbol, quoteAsset) {
   let perpetuals = new BigNumber(0);
   let spot = new BigNumber(0);
   for (const asset of assets) {
-    if (asset.symbol === QUOTE_ASSET) {
+    if (asset.symbol === quoteAsset) {
       perpetuals = sumOf([
         perpetuals,
         toDecimal(asset.margin_balance)
@@ -240,14 +239,14 @@ function toEquitySplit(assets, priceBySymbol) {
   };
 }
 __name(toEquitySplit, "toEquitySplit");
-function toCollateralRows(assets, availableBalance) {
+function toCollateralRows(assets, availableBalance, quoteAsset) {
   const rows = [];
   for (const asset of assets) {
     const held = heldAmount(asset);
     if (held === null || held.isZero()) {
       continue;
     }
-    rows.push(toCollateralRow(asset.symbol, held, availableBalance));
+    rows.push(toCollateralRow(asset.symbol, held, availableBalance, quoteAsset));
   }
   rows.sort(byAssetName);
   return rows;
@@ -260,8 +259,8 @@ function heldAmount(asset) {
   ]);
 }
 __name(heldAmount, "heldAmount");
-function toCollateralRow(asset, held, availableBalance) {
-  if (asset !== QUOTE_ASSET) {
+function toCollateralRow(asset, held, availableBalance, quoteAsset) {
+  if (asset !== quoteAsset) {
     return {
       asset,
       equity: held.toFixed(),