@pear-protocol/exchanges-sdk 0.17.0 → 0.18.0

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import { HttpTypes, Connector, BinanceCredentialsDTO, BybitCredentialsDTO, OkxCr
 import PearSDK from '@pear-protocol/core-sdk';
 import { ProxyConfig } from '@pear-protocol/utils';
 import { WebSocket } from 'partysocket';
+import { AbstractWallet } from '@nktkas/hyperliquid/signing';
 import { WalletClient, Transport, Chain, Account } from 'viem';
 import { z } from 'zod';
 
@@ -245,41 +246,6 @@ declare class OkxExchangeWs extends ExchangeWs {
     }): Promise<OkxExchangeWs>;
 }
 
-type ExchangeWsByConnector = {
-    binance: BinanceExchangeWs;
-    bybit: BybitExchangeWs;
-    okx: OkxExchangeWs;
-    hyperliquid: HyperliquidExchangeWs;
-    lighter: LighterExchangeWs;
-    lighter_rhc: LighterExchangeWs;
-};
-/**
- * Hyperliquid's account channels are public, so its socket needs no credentials; every other venue
- * still requires them. The tuple keeps the check whole, so a connector not known to be Hyperliquid
- * (a `Connector` union) still requires them too.
- */
-type CreateExchangeWsConfig<E extends Connector = Connector> = {
-    demo: boolean;
-} & ([E] extends ['hyperliquid'] ? {
-    credentials?: SupportedCredentials;
-} : {
-    credentials: SupportedCredentials;
-});
-declare function createExchangeWs<E extends Connector>(exchange: E, config: CreateExchangeWsConfig<E>): Promise<ExchangeWsByConnector[E]>;
-
-interface HyperliquidHelper {
-    checkAccountActivation(userAddress: `0x${string}`): Promise<boolean>;
-    checkApiWallet(params: CheckApiWalletParams): Promise<boolean>;
-    checkBuilderFeeApproval(userAddress: `0x${string}`, builderAddress: `0x${string}`, requiredFeeTenthsBps?: number): Promise<boolean>;
-}
-type CheckApiWalletParams = {
-    userAddress: `0x${string}`;
-    agentWalletAddress: `0x${string}`;
-};
-
-/** Creates Hyperliquid approval checks for the selected network. */
-declare function createHyperliquidHelper(demo?: boolean): HyperliquidHelper;
-
 type LighterRawTrade = {
     trade_id: number;
     trade_id_str?: string;
@@ -311,6 +277,12 @@ type ApiKey = {
     public_key: string;
     transaction_time: number;
 };
+type LighterAccountMetadata = {
+    account_index: number;
+    name: string;
+    description: string;
+    created_at: number;
+};
 /**
  * The three account tiers Lighter offers, spelled the way the venue spells them.
  *
@@ -430,6 +402,62 @@ type LighterUserReferrals = {
     nextCursor: string | null;
 };
 
+type ExchangeWsByConnector = {
+    binance: BinanceExchangeWs;
+    bybit: BybitExchangeWs;
+    okx: OkxExchangeWs;
+    hyperliquid: HyperliquidExchangeWs;
+    lighter: LighterExchangeWs;
+    lighter_rhc: LighterExchangeWs;
+};
+/**
+ * Hyperliquid's account channels are public, so its socket needs no credentials; every other venue
+ * still requires them. The tuple keeps the check whole, so a connector not known to be Hyperliquid
+ * (a `Connector` union) still requires them too.
+ */
+type CreateExchangeWsConfig<E extends Connector = Connector> = {
+    demo: boolean;
+} & ([E] extends ['hyperliquid'] ? {
+    credentials?: SupportedCredentials;
+} : {
+    credentials: SupportedCredentials;
+});
+declare function createExchangeWs<E extends Connector>(exchange: E, config: CreateExchangeWsConfig<E>): Promise<ExchangeWsByConnector[E]>;
+
+type SubAccountTransferDirection = 'main-to-subaccount' | 'subaccount-to-main';
+
+interface HyperliquidHelper {
+    checkAccountActivation(userAddress: `0x${string}`): Promise<boolean>;
+    createSubAccount(wallet: AbstractWallet, params: CreateHyperliquidSubAccountParams): Promise<CreateHyperliquidSubAccountResult>;
+    transferSubAccount(wallet: AbstractWallet, params: HyperliquidSubAccountTransferParams): Promise<void>;
+    listSubAccounts(userAddress: `0x${string}`): Promise<HyperliquidSubAccountSummary[]>;
+    checkApiWallet(params: CheckApiWalletParams): Promise<boolean>;
+    checkBuilderFeeApproval(userAddress: `0x${string}`, builderAddress: `0x${string}`, requiredFeeTenthsBps?: number): Promise<boolean>;
+}
+type CreateHyperliquidSubAccountParams = {
+    name: string;
+};
+type CreateHyperliquidSubAccountResult = {
+    subAccountAddress: `0x${string}`;
+};
+type HyperliquidSubAccountTransferParams = {
+    subAccountAddress: `0x${string}`;
+    direction: SubAccountTransferDirection;
+    /** Positive human-readable USDC amount with at most six fractional digits. */
+    amount: string;
+};
+type HyperliquidSubAccountSummary = {
+    name: string;
+    subAccountUser: `0x${string}`;
+};
+type CheckApiWalletParams = {
+    userAddress: `0x${string}`;
+    agentWalletAddress: `0x${string}`;
+};
+
+/** Creates Hyperliquid account-management helpers for the selected network. */
+declare function createHyperliquidHelper(demo?: boolean): HyperliquidHelper;
+
 /** Shares one live Lighter auth token per account without crossing rotated credentials. */
 
 type LighterAuthCredentials = {
@@ -555,6 +583,53 @@ declare function getAssetDecimals(assetId: number): number;
 type ConnectWalletParams = {
     accountIndex: number;
 };
+type CreateLighterSubAccountParams = {
+    mainAccountIndex: number;
+    /** API key index registered on `mainAccountIndex`. */
+    apiKeyIndex: number;
+    /** API private key registered on `mainAccountIndex`. */
+    apiPrivateKey: string;
+};
+type CreateLighterSubAccountResult = {
+    txHash: string;
+};
+/** Creates, discovers, and names a subaccount owned by this L1 address. */
+type CreateNamedLighterSubAccountParams = CreateLighterSubAccountParams & {
+    l1Address: string;
+    name: string;
+    description?: string;
+};
+/** Creation completes after the indexed subaccount receives its display metadata. */
+type CreateNamedLighterSubAccountResult = CreateLighterSubAccountResult & {
+    subAccountIndex: number;
+};
+type SetLighterSubAccountMetadataParams = {
+    mainAccountIndex: number;
+    subAccountIndex: number;
+    /** Display name shown by Lighter for the target subaccount. */
+    name: string;
+    description?: string;
+    /** API key index registered on `mainAccountIndex`. */
+    apiKeyIndex: number;
+    /** API private key registered on `mainAccountIndex`. */
+    apiPrivateKey: string;
+};
+type LighterSubAccountTransferParams = {
+    /** L1 address that owns both accounts; Core refuses the transfer unless Lighter agrees. */
+    l1Address: string;
+    mainAccountIndex: number;
+    subAccountIndex: number;
+    direction: SubAccountTransferDirection;
+    /** Positive human-readable collateral amount (USDC on Lighter, USDG on RHC) with at most six fractional digits. */
+    amount: string;
+    /** API key index registered on the source account selected by `direction`. */
+    apiKeyIndex: number;
+    /** API private key registered on the source account selected by `direction`. */
+    apiPrivateKey: string;
+};
+type LighterSubAccountTransferResult = {
+    txHash: string;
+};
 /** The Lighter book a Fun.xyz deposit funds. */
 type FunxyzMarket = 'perps' | 'spot';
 /** What a Fun.xyz deposit is denominated in at its source. Fun.xyz converts ETH to USDC on arrival. */
@@ -986,8 +1061,13 @@ type LighterUserReferralsParams = {
 interface LighterHelper {
     checkOnboarding(l1Address: string): Promise<LighterOnboardingStatus>;
     lookupAccount(l1Address: string): Promise<LighterLookupResult>;
+    fetchAccountMetadata(params: FetchLighterAccountMetadataParams): Promise<FetchLighterAccountMetadataResult>;
     checkIntegratorApproval(accountIndex: number, integratorAccountIndex: number, requirements?: IntegratorApprovalRequirements, authToken?: string): Promise<boolean>;
     connectWallet(walletClient: WalletClientWithAccount, params: ConnectWalletParams): Promise<ConnectWalletResult>;
+    createSubAccount(params: CreateLighterSubAccountParams): Promise<CreateLighterSubAccountResult>;
+    createNamedSubAccount(params: CreateNamedLighterSubAccountParams): Promise<CreateNamedLighterSubAccountResult>;
+    setSubAccountMetadata(params: SetLighterSubAccountMetadataParams): Promise<void>;
+    transferSubAccount(params: LighterSubAccountTransferParams): Promise<LighterSubAccountTransferResult>;
     approveIntegrator(walletClient: WalletClientWithAccount, params: ApproveIntegratorParams): Promise<ApproveIntegratorResult>;
     changeAccountTier(params: ChangeAccountTierParams): Promise<ChangeAccountTierResult>;
     listCctpDepositNetworks(): Promise<LighterDepositNetwork[]>;
@@ -1044,6 +1124,17 @@ type LighterLookupResult = {
     mainAccountIndex: number;
     subAccountIndexes: number[];
 };
+type FetchLighterAccountMetadataParams = {
+    l1Address: string;
+    /** Account whose API key authenticates the lookup; its own family is returned. */
+    accountIndex: number;
+    apiKeyIndex: number;
+    apiPrivateKey: string;
+};
+type FetchLighterAccountMetadataResult = {
+    /** Full Lighter account metadata (name, description, created_at, …) by account index. */
+    accounts: Record<number, LighterAccountMetadata>;
+};
 
 /**
  * Functional Lighter deposit operations that route through the Fun.xyz bridge.
@@ -1075,6 +1166,7 @@ declare function readFunxyzChainSource(chainId: number): FunxyzDepositSource;
 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;
+/** Creates Lighter account-management helpers backed by the Pear Core signing boundary. */
 declare function createLighterHelper(sdk: PearSDK, demo?: boolean): LighterHelper;
 /**
  * The helper for Lighter's Robinhood Chain deployment: the shared surface plus its own deposit.
@@ -1085,6 +1177,15 @@ declare function createLighterHelper(sdk: PearSDK, demo?: boolean): LighterHelpe
  */
 declare function createLighterRhcHelper(sdk: PearSDK, demo?: boolean): LighterRhcHelper;
 
+/**
+ * Converts a human-readable collateral amount to safe six-decimal integer units.
+ *
+ * Every collateral this SDK moves is a six-decimal stablecoin, but the deployments name it
+ * differently — zkLighter margins in USDC, Robinhood Chain in USDG — so the caller names the asset
+ * a rejection should mention. The scaling itself is deployment-blind.
+ */
+declare function parseCollateralAmount(amount: string, assetSymbol: string): number;
+
 type ExchangeHelperMap = {
     hyperliquid: HyperliquidHelper;
     lighter: LighterHelper;
@@ -1296,7 +1397,7 @@ type UserFillsByTimeResponse = {
          * Address of the liquidated user.
          * @pattern ^0x[a-fA-F0-9]{40}$
          */
-        liquidatedUser: `0x${string}`;
+        liquidatedUser?: `0x${string}`;
         /**
          * Mark price at the time of liquidation.
          * @pattern ^[0-9]+(\.[0-9]+)?$
@@ -1424,6 +1525,13 @@ declare const AccountBalance: z.ZodDiscriminatedUnion<[z.ZodObject<{
         crossMaintenanceMargin: z.ZodString;
         withdrawable: z.ZodString;
     }, z.core.$strip>>;
+    spotHoldings: z.ZodArray<z.ZodObject<{
+        asset: z.ZodString;
+        token: z.ZodNumber;
+        total: z.ZodString;
+        hold: z.ZodString;
+        entryNotional: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
     totalEquity: z.ZodNullable<z.ZodString>;
     withdrawableBalance: z.ZodNullable<z.ZodString>;
@@ -1454,6 +1562,13 @@ declare const AccountBalance: z.ZodDiscriminatedUnion<[z.ZodObject<{
         crossMaintenanceMargin: z.ZodString;
         withdrawable: z.ZodString;
     }, z.core.$strip>>;
+    spotHoldings: z.ZodArray<z.ZodObject<{
+        asset: z.ZodString;
+        token: z.ZodNumber;
+        total: z.ZodString;
+        hold: z.ZodString;
+        entryNotional: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
     totalEquity: z.ZodNullable<z.ZodString>;
     withdrawableBalance: z.ZodNullable<z.ZodString>;
@@ -1495,6 +1610,13 @@ declare const AccountBalance: z.ZodDiscriminatedUnion<[z.ZodObject<{
         crossMaintenanceMargin: z.ZodString;
         withdrawable: z.ZodString;
     }, z.core.$strip>>;
+    spotHoldings: z.ZodArray<z.ZodObject<{
+        asset: z.ZodString;
+        token: z.ZodNumber;
+        total: z.ZodString;
+        hold: z.ZodString;
+        entryNotional: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
     totalEquity: z.ZodNullable<z.ZodString>;
     withdrawableBalance: z.ZodNullable<z.ZodString>;
@@ -1666,6 +1788,24 @@ declare const AccountBalance: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>], "accountMode">;
 type AccountBalance = z.infer<typeof AccountBalance>;
 
+declare const PublicExchangeAccount: z.ZodObject<{
+    connector: z.ZodEnum<{
+        hyperliquid: "hyperliquid";
+        binance: "binance";
+        bybit: "bybit";
+        okx: "okx";
+        lighter: "lighter";
+        lighter_rhc: "lighter_rhc";
+    }>;
+    exchangeIdentifier: z.ZodString;
+}, z.core.$strip>;
+type PublicExchangeAccount = z.infer<typeof PublicExchangeAccount>;
+declare const TradingEquity: z.ZodObject<{
+    tradingEquityUsd: z.ZodString;
+    timestamp: z.ZodNumber;
+}, z.core.$strip>;
+type TradingEquity = z.infer<typeof TradingEquity>;
+
 /**
  * The primitives every account-balance variant is built from: decimal string formats, the
  * `accountMode` union tag, and the four core fields every venue fills in every mode.
@@ -1813,6 +1953,7 @@ interface AccountTracker {
     start(): Promise<void>;
     disconnect(): Promise<void>;
     snapshot(): Promise<AccountSnapshot>;
+    tradingEquity(): Promise<TradingEquity>;
     snapshotAssets(coins: string[]): Promise<AssetSnapshotMap>;
     readonly isConnected: boolean;
     readonly isInitialized: boolean;
@@ -1835,6 +1976,8 @@ declare abstract class BaseAccountTracker implements AccountTracker {
     private positionListeners;
     private assetEntries;
     constructor(config: AccountTrackerConfig);
+    /** Only public account venues implement credential-free trading equity. */
+    tradingEquity(): Promise<TradingEquity>;
     snapshotAssets(coins: string[]): Promise<AssetSnapshotMap>;
     disconnect(): Promise<void>;
     get isInitialized(): boolean;
@@ -2131,6 +2274,24 @@ declare const HyperliquidDexState: z.ZodObject<{
     withdrawable: z.ZodString;
 }, z.core.$strip>;
 type HyperliquidDexState = z.infer<typeof HyperliquidDexState>;
+/**
+ * One spot holding as the venue lists it, in the coin's own units and in every account mode.
+ *
+ * The whole spot wallet, not the dex collateral tokens alone: a PURR or HYPE holding gets a row in
+ * Standard and Unified as well as in Portfolio Margin. The row set is the venue's own — every coin
+ * where `total ≠ 0` OR `hold ≠ 0` — so a coin that empties leaves the list rather than reading zero.
+ *
+ * Quantities only, NEVER priced: valuing the wallet is the variant's own equity scalar's job, and
+ * that scalar reports `null` for a holding it cannot price instead of guessing.
+ */
+declare const HyperliquidSpotHolding: z.ZodObject<{
+    asset: z.ZodString;
+    token: z.ZodNumber;
+    total: z.ZodString;
+    hold: z.ZodString;
+    entryNotional: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type HyperliquidSpotHolding = z.infer<typeof HyperliquidSpotHolding>;
 declare const HyperliquidStandardBalance: z.ZodObject<{
     totalEquity: z.ZodNullable<z.ZodString>;
     withdrawableBalance: z.ZodNullable<z.ZodString>;
@@ -2161,6 +2322,13 @@ declare const HyperliquidStandardBalance: z.ZodObject<{
         crossMaintenanceMargin: z.ZodString;
         withdrawable: z.ZodString;
     }, z.core.$strip>>;
+    spotHoldings: z.ZodArray<z.ZodObject<{
+        asset: z.ZodString;
+        token: z.ZodNumber;
+        total: z.ZodString;
+        hold: z.ZodString;
+        entryNotional: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 type HyperliquidStandardBalance = z.infer<typeof HyperliquidStandardBalance>;
 declare const HyperliquidUnifiedBalance: z.ZodObject<{
@@ -2193,6 +2361,13 @@ declare const HyperliquidUnifiedBalance: z.ZodObject<{
         crossMaintenanceMargin: z.ZodString;
         withdrawable: z.ZodString;
     }, z.core.$strip>>;
+    spotHoldings: z.ZodArray<z.ZodObject<{
+        asset: z.ZodString;
+        token: z.ZodNumber;
+        total: z.ZodString;
+        hold: z.ZodString;
+        entryNotional: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 type HyperliquidUnifiedBalance = z.infer<typeof HyperliquidUnifiedBalance>;
 /**
@@ -2271,13 +2446,39 @@ declare const HyperliquidPortfolioMarginBalance: z.ZodObject<{
         crossMaintenanceMargin: z.ZodString;
         withdrawable: z.ZodString;
     }, z.core.$strip>>;
+    spotHoldings: z.ZodArray<z.ZodObject<{
+        asset: z.ZodString;
+        token: z.ZodNumber;
+        total: z.ZodString;
+        hold: z.ZodString;
+        entryNotional: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 type HyperliquidPortfolioMarginBalance = z.infer<typeof HyperliquidPortfolioMarginBalance>;
 
-type HyperliquidAccountTrackerConfig = AccountTrackerConfig & {
-    /** The account whose state is read. Hyperliquid answers for any address, so no credentials are needed. */
+/**
+ * Hyperliquid's two read paths: the live WebSocket tracker and the one-shot REST snapshot.
+ *
+ * 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`, 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 other REST reads are the static dex metadata, read at `start()`, and
+ * the staking position, which the venue publishes on no channel at all: read at `start()` too, then
+ * again on the first spot frame and after spot HYPE rises while the account holds staked HYPE,
+ * rate-limited to one minute with a known queue and five minutes without one.
+ *
+ * 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.
+ */
+
+type HyperliquidAccountTrackerConfig = AccountTrackerConfig & ({
+    account: Pick<TradeAccount, 'exchangeIdentifier'>;
+} | {
+    /** The address whose state is read without credentials. */
     address: `0x${string}`;
-};
+});
 declare class HyperliquidAccountTracker extends BaseAccountTracker {
     private readonly address;
     private ws;
@@ -2326,6 +2527,8 @@ declare class HyperliquidAccountTracker extends BaseAccountTracker {
      * per-asset headroom without opening a socket.
      */
     snapshot(): Promise<AccountSnapshot>;
+    /** Value trading holdings with the same account reads and pricing used by snapshots. */
+    tradingEquity(): Promise<TradingEquity>;
     /**
      * Stateless one-shot per-asset settings read via the `activeAssetData` info request (the REST
      * twin of the live WS subscription), one request per coin fired in parallel — the info endpoint
@@ -2357,6 +2560,10 @@ declare class HyperliquidAccountTracker extends BaseAccountTracker {
     private onSocketClosed;
     private routeRaw;
     private handle;
+    /** Share the public account-mode and spot valuation inputs across one-shot reads. */
+    private fetchAccountState;
+    /** Retain each DEX's collateral identity when reading separate perpetual wallets. */
+    private fetchPerpStates;
     private loadPerpMetas;
     /** Reads `activeAssetData` for each coin in parallel, dropping the coins the venue refuses. */
     private fetchActiveAssetEvents;
@@ -2504,13 +2711,17 @@ type LighterUnifiedBalance = z.infer<typeof LighterUnifiedBalance>;
 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;
+    account: Pick<TradeAccount, 'exchangeIdentifier'>;
+} & ({
+    access: 'public';
+} | {
+    access?: 'authenticated';
+    /** Null leaves the tier unread: `/accountLimits` is authenticated and only Core mints a token. */
+    sdk: PearSDK | null;
     credentials: SupportedCredentials;
-};
+});
 /** Told the account's tier, or told there is no answer yet. */
 type AccountTierCallback = (tier: LighterAccountTier | null) => void;
 declare class LighterAccountTracker extends BaseAccountTracker {
@@ -2518,8 +2729,6 @@ declare class LighterAccountTracker extends BaseAccountTracker {
     private readonly connector;
     private readonly quoteAsset;
     private readonly accountIdentifier;
-    private readonly apiKeyIndex;
-    private readonly apiPrivateKey;
     private readonly creds;
     private ws;
     private messageListenerId;
@@ -2564,6 +2773,8 @@ declare class LighterAccountTracker extends BaseAccountTracker {
     refreshAccountTier(): Promise<void>;
     /** Stateless one-shot account read — authenticated for connected accounts, and no websocket. */
     snapshot(): Promise<AccountSnapshot>;
+    /** Reuse the snapshot read path and let the mapper include open PnL exactly once. */
+    tradingEquity(): Promise<TradingEquity>;
     /**
      * Stateless one-shot per-asset settings read, keyed by market id (the same identifier the live
      * trackAsset path uses). One public `GET /api/v1/account` covers every market the account holds
@@ -2621,7 +2832,7 @@ declare class LighterAccountTracker extends BaseAccountTracker {
     private fetchPrimaryAccount;
     /** Reads market context under the same account identity as the snapshot that consumes it. */
     private fetchMarkets;
-    /** Returns this account's cached auth token, or no token for the explicit empty-key verifier. */
+    /** Public access has no credentials; connected accounts reuse their cached auth token. */
     private retrieveAuthToken;
     /** Requires credentials for private WebSocket channels even when REST is in verifier mode. */
     private retrieveRequiredAuthToken;
@@ -2863,12 +3074,16 @@ declare class OkxAccountTracker extends BaseAccountTracker {
     private performWithdrawableRefresh;
 }
 
-type CreateAccountTrackerConfig = AccountTrackerConfig & {
+type CreateAccountTrackerConfig = AccountTrackerConfig & ({
+    access: 'public';
+    account: PublicExchangeAccount;
+} | {
+    access?: 'authenticated';
     /** Lighter only: null there leaves the account's tier unread. */
     sdk: PearSDK | null;
     account: TradeAccount;
     credentials: SupportedCredentials;
-};
+});
 declare function createAccountTracker(exchange: Connector, config: CreateAccountTrackerConfig): AccountTracker;
 
 declare class ExchangesSDK {
@@ -2877,6 +3092,8 @@ declare class ExchangesSDK {
     private throttle;
     private hyperliquidPerpDexNames;
     constructor(config: ExchangesSDKConfig);
+    /** Value public trading holdings and open PnL without connecting or retrieving credentials. */
+    tradingEquity(account: PublicExchangeAccount): Promise<TradingEquity>;
     connect(tradeAccountId: string): Promise<ExchangeConnection>;
     /**
      * Options come in per call rather than at construction: the approval targets live in the
@@ -2885,6 +3102,9 @@ declare class ExchangesSDK {
      */
     status(connection: ExchangeConnection, options?: ConnectOptions): Promise<AccountStatus>;
     createTracker(connection: ExchangeConnection): AccountTracker;
+    createTracker(account: PublicExchangeAccount, options: {
+        access: 'public';
+    }): AccountTracker;
     /**
      * A read-only tracker for any address, built without `connect()`: Hyperliquid answers account
      * state for an address with no credentials, so none are fetched and no trade account is needed.
@@ -2898,4 +3118,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, type CloseListener, 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, type PublicTrackerConfig, 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 };
+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, type CloseListener, CollateralBalance, type ConnectOptions, type ConnectWalletParams, type ConnectWalletResult, type CreateAccountTrackerConfig, type CreateExchangeWsConfig, type CreateHyperliquidSubAccountParams, type CreateHyperliquidSubAccountResult, type CreateLighterSubAccountParams, type CreateLighterSubAccountResult, type CreateNamedLighterSubAccountParams, type CreateNamedLighterSubAccountResult, 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 FetchLighterAccountMetadataParams, type FetchLighterAccountMetadataResult, 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, HyperliquidSpotHolding, HyperliquidStandardBalance, type HyperliquidSubAccountSummary, type HyperliquidSubAccountTransferParams, 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, type LighterAccountMetadata, 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, type LighterSubAccountTransferParams, type LighterSubAccountTransferResult, 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, PublicExchangeAccount, type PublicTrackerConfig, RouteType, type SetLighterSubAccountMetadataParams, Side, SignedDecimalString, type StateUpdate, type SubAccountTransferDirection, type SupportedCredentials, type SyncerThrottle, type TrackedAssetCallback, type TrackedAssetInfo, TradingEquity, type WalletClientWithAccount, type WithdrawParams, type WithdrawResult, type WsMessage, createAccountSyncer, createAccountTracker, createExchangeWs, createHyperliquidHelper, createLighterHelper, createLighterRhcHelper, findAvailableApiKeyIndex, getAssetDecimals, getLighterNativeUsdcAddress, listFunxyzTransferableChains, parseCollateralAmount, readFunxyzChainSource, readFunxyzMinimumUsd, retrieveLighterAuthToken, usdcAbi };

package/dist/sdk.js

@@ -2,7 +2,8 @@ import { configureProxy } from '@pear-protocol/utils';
 import { createExchangeHelper } from './helper/factory';
 import { checkAccountStatus } from './status';
 import { createAccountSyncer } from './syncer';
-import { HyperliquidAccountTracker, createAccountTracker } from './tracker';
+import { createAccountTracker } from './tracker';
+import { PublicExchangeAccount } from './tracker/equity';
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
@@ -21,6 +22,12 @@ class ExchangesSDK {
     this.hyperliquidPerpDexNames = config.hyperliquidPerpDexNames;
     if (config.proxy) configureProxy(config.proxy);
   }
+  /** Value public trading holdings and open PnL without connecting or retrieving credentials. */
+  async tradingEquity(account) {
+    return await this.createTracker(account, {
+      access: "public"
+    }).tradingEquity();
+  }
   async connect(tradeAccountId) {
     return this.fetchCredentials(tradeAccountId);
   }
@@ -39,8 +46,19 @@ class ExchangesSDK {
       demo: this.demo
     });
   }
-  createTracker(connection) {
-    return this.buildTracker(connection);
+  createTracker(account, options) {
+    if (options?.access === "public") {
+      const identity = PublicExchangeAccount.parse(account);
+      return createAccountTracker(identity.connector, {
+        access: "public",
+        account: identity,
+        demo: this.demo
+      });
+    }
+    if ("credentials" in account) {
+      return this.buildTracker(account);
+    }
+    throw new Error("Authenticated trackers require an exchange connection");
   }
   /**
   * A read-only tracker for any address, built without `connect()`: Hyperliquid answers account
@@ -49,10 +67,14 @@ class ExchangesSDK {
   createPublicTracker(config) {
     switch (config.connector) {
       case "hyperliquid":
-        return new HyperliquidAccountTracker({
+        return createAccountTracker("hyperliquid", {
+          access: "public",
+          account: {
+            connector: "hyperliquid",
+            exchangeIdentifier: config.address
+          },
           demo: this.demo,
-          onError: config.onError,
-          address: config.address
+          onError: config.onError
         });
     }
   }

package/dist/status/hyperliquid/status.js

@@ -16,8 +16,8 @@ async function checkHyperliquidAccountStatus(config) {
     exchange: "hyperliquid",
     demo: config.demo
   });
-  const metadata = config.account.metadata;
-  const approvalAddress = metadata && "isSubaccount" in metadata && metadata.isSubaccount ? metadata.mainAccountAddress : config.account.exchangeIdentifier;
+  const metadata = config.account.connector === "hyperliquid" ? config.account.metadata : void 0;
+  const approvalAddress = metadata?.isSubaccount === true ? metadata.mainAccountAddress : config.account.exchangeIdentifier;
   try {
     const abstraction = await fetchUserAbstraction(config.account.exchangeIdentifier, config.demo);
     const supportedAccountMode = abstraction === HyperliquidAccountType.DEFAULT || abstraction === HyperliquidAccountType.DISABLED || abstraction === HyperliquidAccountType.UNIFIED_ACCOUNT || abstraction === HyperliquidAccountType.PORTFOLIO_MARGIN;
@@ -27,7 +27,7 @@ async function checkHyperliquidAccountStatus(config) {
   } catch {
     reasons.push("hyperliquid_account_mode_check_failed");
   }
-  if (!metadata || !("agentWalletAddress" in metadata)) {
+  if (!metadata) {
     reasons.push("hyperliquid_api_wallet_invalid");
   } else {
     try {

package/dist/syncer/base.js

@@ -82,7 +82,7 @@ class BaseAccountSyncer {
       firstSyncStartedAt
     };
   }
-  // Phase C: Compute the sync payload and post it across the three sync endpoints.
+  // Phase C: Compute the sync payload and post the applicables to the create endpoint.
   async computeAndPostSync(state, snapshot) {
     const { openPositions, entryBySymbol, provisionalFills, watermark } = state;
     const { exchangePositions, externalFills, firstSyncStartedAt } = snapshot;
@@ -100,26 +100,6 @@ class BaseAccountSyncer {
     if (!payload) {
       return;
     }
-    if (payload.reconcilables) {
-      const reconcileBytes = new Blob([
-        JSON.stringify(payload.reconcilables)
-      ]).size;
-      if (reconcileBytes > 50 * 1024) {
-        await this.sdk.core.sync.fills.reconcileBulk(payload.reconcilables);
-      } else {
-        await this.sdk.core.sync.fills.reconcile(payload.reconcilables);
-      }
-    }
-    if (payload.confirmables) {
-      const confirmBytes = new Blob([
-        JSON.stringify(payload.confirmables)
-      ]).size;
-      if (confirmBytes > 50 * 1024) {
-        await this.sdk.core.sync.fills.confirmBulk(payload.confirmables);
-      } else {
-        await this.sdk.core.sync.fills.confirm(payload.confirmables);
-      }
-    }
     const { firstSyncTrim } = payload;
     let meta = {
       ...payload.meta,