@pear-protocol/hyperliquid-sdk 0.0.22 → 0.0.26

package/dist/provider.d.ts

@@ -1,15 +1,11 @@
 import React, { ReactNode } from 'react';
 import { ReadyState } from 'react-use-websocket';
-import { PearHyperliquidClient } from './client';
-import { PearHyperliquidConfig } from './types';
-import { PearMigrationSDK } from './migration-sdk';
-export interface TokenSelectorConfig {
-    isLong: boolean;
-    index: number;
-}
+import type { UserProfile } from './types';
+import { AuthStatus } from './types';
+import type { AgentWalletState } from './types';
 export interface PearHyperliquidContextType {
-    client: PearHyperliquidClient;
-    migrationSDK: PearMigrationSDK;
+    apiBaseUrl: string;
+    wsUrl: string;
     address: string | null;
     setAddress: (address: string | null) => void;
     connectionStatus: ReadyState;
@@ -18,27 +14,65 @@ export interface PearHyperliquidContextType {
     nativeConnectionStatus: ReadyState;
     nativeIsConnected: boolean;
     nativeLastError: string | null;
+    authStatus: AuthStatus;
+    isAuthenticated: boolean;
+    accessToken: string | null;
+    user: UserProfile | null;
+    authError: string | null;
+    getEip712: (address: string) => Promise<any>;
+    loginWithSignedMessage: (address: string, signature: string, timestamp: number) => Promise<void>;
+    loginWithPrivyToken: (address: string, appId: string, accessToken: string) => Promise<void>;
+    refreshTokens: () => Promise<any>;
+    logout: () => Promise<void>;
+    agentWallet: AgentWalletState;
+    isAgentWalletReady: boolean;
+    agentWalletError: string | null;
+    agentWalletLoading: boolean;
+    refreshAgentWalletStatus: () => Promise<any>;
+    createAgentWallet: () => Promise<any>;
+    notifyAgentWalletApproved: () => Promise<any>;
 }
 export declare const PearHyperliquidContext: React.Context<PearHyperliquidContextType | undefined>;
 interface PearHyperliquidProviderProps {
-    config: PearHyperliquidConfig;
-    /**
-     * WebSocket server URL
-     * @default 'wss://hl-v2.pearprotocol.io/ws'
-     */
-    wsUrl?: string;
     children: ReactNode;
+    apiBaseUrl?: string;
+    clientId?: string;
+    wsUrl?: string;
 }
 /**
  * React Provider for PearHyperliquidClient
  */
 export declare const PearHyperliquidProvider: React.FC<PearHyperliquidProviderProps>;
 /**
- * Hook to use PearHyperliquidClient from context
+ * Hook to access the entire Pear Hyperliquid context.
+ * Prefer using the more specific hooks below when possible.
+ */
+export declare function usePearHyperliquid(): PearHyperliquidContextType;
+/**
+ * Provider-aware Auth hook. Uses auth state/actions provided by PearHyperliquidProvider.
+ * Callers do not need to pass baseUrl/clientId.
  */
-export declare const usePearHyperliquidClient: () => PearHyperliquidClient;
+export declare function usePearAuth(): {
+    readonly status: AuthStatus;
+    readonly isAuthenticated: boolean;
+    readonly user: UserProfile | null;
+    readonly error: string | null;
+    readonly getEip712: (address: string) => Promise<any>;
+    readonly loginWithSignedMessage: (address: string, signature: string, timestamp: number) => Promise<void>;
+    readonly loginWithPrivyToken: (address: string, appId: string, accessToken: string) => Promise<void>;
+    readonly refreshTokens: () => Promise<any>;
+    readonly logout: () => Promise<void>;
+};
 /**
- * Hook to use migration SDK from context
+ * Provider-aware Agent Wallet hook. Uses agent wallet state/actions provided by PearHyperliquidProvider.
  */
-export declare const useMigrationSDK: () => PearMigrationSDK;
+export declare function usePearAgentWallet(): {
+    readonly agentWallet: AgentWalletState;
+    readonly isReady: boolean;
+    readonly loading: boolean;
+    readonly error: string | null;
+    readonly refreshAgentWalletStatus: () => Promise<any>;
+    readonly createAgentWallet: () => Promise<any>;
+    readonly notifyAgentWalletApproved: () => Promise<any>;
+};
 export {};

package/dist/store/userSelection.d.ts

@@ -1,5 +1,4 @@
-import type { CandleInterval, TokenConflict, TokenSelection } from "../types";
-import type { TokenSelectorConfig } from "../provider";
+import type { CandleInterval, TokenConflict, TokenSelection, TokenSelectorConfig } from "../types";
 interface UserSelectionState {
     longTokens: TokenSelection[];
     shortTokens: TokenSelection[];

package/dist/types.d.ts

@@ -1,71 +1,8 @@
-/**
- * Raw value data for trade history positions
- */
-export interface RawValueDto {
-    coin: string;
-    size: string;
-    leverage: number;
-    openPx: string;
-    closePx: string;
-    marginUsed: string;
-    positionValue: string;
-}
-/**
- * Trade history data structure from V1 API
- */
-export interface TradeHistoryV1Dto {
-    pearId: string;
-    openedDate: string;
-    closedDate: string;
-    time: string;
-    pair: string;
-    direction: Record<string, string>;
-    closedPrice: number;
-    openedPrice: number;
-    size: string;
-    longPositionValue: number;
-    shortPositionValue: number;
-    positionValue: number;
-    fee: number;
-    builderFee: number;
-    closedPNL: number;
-    closedPnlPercentage: number;
-    leverage: number;
-    rawLongValue: RawValueDto;
-    rawShortValue: RawValueDto;
-}
-/**
- * Request payload for syncing trade history
- */
-export interface SyncTradeHistoryDto {
-    address: string;
-    data: TradeHistoryV1Dto[];
-}
-/**
- * Response from sync trade history endpoint
- */
-export interface SyncTradeHistoryResponseDto {
-    success: boolean;
-    positionId: string;
-    tradeHistoryId: string;
-    message: string;
-}
-/**
- * Base API error response
- */
 export interface ApiErrorResponse {
     statusCode: number;
     message: string;
     error?: string;
 }
-/**
- * Configuration options for the SDK
- */
-export interface PearHyperliquidConfig {
-    baseUrl: string;
-    timeout?: number;
-    headers?: Record<string, string>;
-}
 /**
  * HTTP client response wrapper
  */
@@ -74,136 +11,38 @@ export interface ApiResponse<T> {
     status: number;
     headers: Record<string, string>;
 }
-/**
- * Hook state interface for migration operations
- */
-export interface MigrationHookState<T> {
-    loading: boolean;
-    error: ApiErrorResponse | null;
-    data: T | null;
-}
-/**
- * PnL data structure for open positions
- */
-export interface PnlDto {
-    value: number;
-    percentage: number;
-}
-/**
- * Take profit and stop loss data structure
- */
-export interface TpSlDto {
-    takeProfit?: number;
-    stopLoss?: number;
+export interface ExternalLiquidationDto {
+    liquidatedUser: string;
+    markPx: string;
+    method: string;
 }
-/**
- * Position side data structure for open positions
- */
-export interface PositionSideDto {
+export interface ExternalFillDto {
     coin: string;
-    size: string;
-    leverage: number;
-    entryPx: string;
-    marginUsed: string;
-    liquidationPx: string | undefined;
-    unrealizedPnl: string;
-    roe: string;
-    positionValue: string;
-    funding: string;
-}
-/**
- * Open position data structure from V1 API
- */
-export interface OpenPositionV1Dto {
-    pair: string;
-    leverage: number;
-    size: number;
-    longPositionValue?: number;
-    shortPositionValue?: number;
-    positionValue: number;
-    entryPrice: number;
-    markPrice: number;
-    pnl: PnlDto;
-    liqPrice: string | number;
-    margin: number;
-    funding: number;
-    pearId: string;
-    openedDate: string;
-    tpsl: TpSlDto;
-    long: PositionSideDto;
-    short: PositionSideDto;
-}
-/**
- * Request payload for syncing open positions
- */
-export interface SyncOpenPositionDto {
-    address: string;
-    data: OpenPositionV1Dto[];
-}
-/**
- * Response from sync open positions endpoint
- */
-export interface SyncOpenPositionResponseDto {
-    success: boolean;
-    positionIds: string[];
-    count: number;
-    message: string;
-}
-/**
- * Open order data structure from V1 API
- */
-export interface OpenOrderV1Dto {
-    id: string;
-    time: string;
-    pair: string;
-    type: string;
-    orderValue: number;
-    price: number;
-    triggerConditions: string;
-    status: string;
-    leverage?: string;
+    px: string;
+    sz: string;
+    side: 'B' | 'A';
+    time: number;
+    dir: string;
+    fee: string;
+    builderFee?: string;
+    oid?: string | number;
+    tid?: string | number;
+    cloid?: string | null;
+    hash?: string | null;
+    feeToken?: string | null;
+    liquidation?: ExternalLiquidationDto | null;
+}
+export interface SyncFillsRequestDto {
+    user: string;
+    fills: ExternalFillDto[];
 }
-/**
- * Request payload for syncing open orders
- */
-export interface SyncOpenOrderDto {
-    address: string;
-    data: OpenOrderV1Dto[];
-}
-/**
- * Response from sync open orders endpoint
- */
-export interface SyncOpenOrderResponseDto {
-    success: boolean;
-    orderIds: string[];
-    count: number;
-    message: string;
-}
-/**
- * Migration hooks interface
- */
-export interface MigrationHooks {
-    tradeHistory: {
-        sync: (payload: SyncTradeHistoryDto) => Promise<ApiResponse<SyncTradeHistoryResponseDto>>;
-        loading: boolean;
-        error: ApiErrorResponse | null;
-        data: SyncTradeHistoryResponseDto | null;
-        reset: () => void;
-    };
-    openPositions: {
-        sync: (payload: SyncOpenPositionDto) => Promise<ApiResponse<SyncOpenPositionResponseDto>>;
-        loading: boolean;
-        error: ApiErrorResponse | null;
-        data: SyncOpenPositionResponseDto | null;
-        reset: () => void;
-    };
-    openOrders: {
-        sync: (payload: SyncOpenOrderDto) => Promise<ApiResponse<SyncOpenOrderResponseDto>>;
-        loading: boolean;
-        error: ApiErrorResponse | null;
-        data: SyncOpenOrderResponseDto | null;
-        reset: () => void;
-    };
+export interface SyncFillsResponseDto {
+    insertedFills: number;
+    skippedDuplicates: number;
+    createdOrders: number;
+    updatedPositions: number;
+    createdPositions: number;
+    closedPositions: number;
 }
 /**
  * WebSocket connection states
@@ -257,6 +96,7 @@ export interface TradeHistoryDataDto {
     externalFeePaid: number;
     builderFeePaid: number;
     realizedPnl: number;
+    totalEntryValue: number;
     totalValue: number;
     entryRatio: number;
     exitRatio: number;
@@ -283,15 +123,16 @@ export interface PositionAssetDetailDto {
     actualSize: number;
     cumFunding: CumFundingDto;
     marginUsed: number;
+    entryPositionValue: number;
     positionValue: number;
     unrealizedPnl: number;
     liquidationPrice: number;
-    isExternallyModified: boolean;
+    initialWeight: number;
+}
+export interface TpSlThreshold {
+    type: 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE';
+    value: number;
 }
-/**
- * Position sync status
- */
-export type PositionSyncStatus = 'SYNCED' | 'EXTERNALLY_MODIFIED' | 'EXTERNALLY_CLOSED' | 'PAIR_BROKEN';
 /**
  * Open position data structure
  */
@@ -299,18 +140,17 @@ export interface OpenPositionDto {
     positionId: string;
     address: string;
     leverage: number;
-    stopLoss: number | null;
-    takeProfit: number | null;
+    stopLoss: TpSlThreshold | null;
+    takeProfit: TpSlThreshold | null;
     entryRatio: number;
     markRatio: number;
     netFunding: number;
+    entryPositionValue: number;
     positionValue: number;
     marginUsed: number;
     unrealizedPnl: number;
     longAssets: PositionAssetDetailDto[];
     shortAssets: PositionAssetDetailDto[];
-    syncStatus: PositionSyncStatus;
-    lastSyncAt: string;
     createdAt: string;
     updatedAt: string;
 }
@@ -406,6 +246,95 @@ export interface AddressState {
     autoConnect: boolean;
     previousAddresses: string[];
 }
+export declare enum AuthStatus {
+    Idle = "idle",
+    Authenticating = "authenticating",
+    Authenticated = "authenticated",
+    Error = "error"
+}
+export interface UseAuthOptions {
+    baseUrl: string;
+    clientId: string;
+}
+export interface UserProfile {
+    userId: string;
+    address: string;
+    appId: string;
+}
+export interface EIP712AuthDetails {
+    primaryType: string;
+    domain: {
+        name: string;
+        version: string;
+        chainId: number;
+        verifyingContract: string;
+    };
+    types: Record<string, Array<{
+        name: string;
+        type: string;
+    }>>;
+    message: Record<string, unknown>;
+    timestamp: number;
+}
+export interface GetEIP712MessageResponse extends EIP712AuthDetails {
+}
+export interface PrivyAuthDetails {
+    appId: string;
+    accessToken: string;
+}
+export interface AuthenticateRequest {
+    method: 'eip712' | 'api_key' | 'privy_access_token';
+    address: string;
+    clientId: string;
+    details: {
+        signature: string;
+        timestamp: number;
+    } | {
+        apiKey: string;
+    } | PrivyAuthDetails;
+}
+export interface AuthenticateResponse {
+    accessToken: string;
+    refreshToken: string;
+    tokenType: string;
+    expiresIn: number;
+    address: string;
+    clientId: string;
+}
+export interface RefreshTokenRequest {
+    refreshToken: string;
+}
+export interface RefreshTokenResponse {
+    accessToken: string;
+    refreshToken: string;
+    tokenType: string;
+    expiresIn: number;
+}
+export interface LogoutRequest {
+    refreshToken: string;
+}
+export interface LogoutResponse {
+    message: string;
+}
+export type AgentWalletStatus = 'ACTIVE' | 'EXPIRED' | 'NOT_FOUND';
+export interface GetAgentWalletResponseDto {
+    agentWalletAddress?: string;
+    agentName: string;
+    status: AgentWalletStatus;
+}
+export interface CreateAgentWalletResponseDto {
+    agentWalletAddress: string;
+    message: string;
+}
+export interface UseAgentWalletOptions {
+    baseUrl: string;
+}
+export interface AgentWalletState {
+    address: string | null;
+    name: string | null;
+    status: AgentWalletStatus | 'PENDING' | null;
+    isActive: boolean;
+}
 /**
  * WebSocket message from HyperLiquid native API
  */
@@ -620,16 +549,13 @@ export type CandleInterval = "1m" | "3m" | "5m" | "15m" | "30m" | "1h" | "2h" |
  * Candle data structure from WebSocket
  */
 export interface CandleData {
+    s?: string;
     t: number;
     T: number;
-    s: string;
-    i: string;
-    o: string;
-    c: string;
-    h: string;
-    l: string;
-    v: string;
-    n: number;
+    o: number;
+    c: number;
+    h: number;
+    l: number;
 }
 /**
  * Candle chart data organized by symbol only
@@ -648,16 +574,7 @@ export interface CandleSnapshotRequest {
     };
     type: "candleSnapshot";
 }
-/**
- * Weighted candle data for chart visualization
- */
-export interface WeightedCandleData {
-    t: number;
-    T: number;
-    o: number;
-    c: number;
-    h: number;
-    l: number;
-    v: number;
-    n: number;
+export interface TokenSelectorConfig {
+    isLong: boolean;
+    index: number;
 }

package/dist/utils/basket-calculator.d.ts

@@ -1,4 +1,4 @@
-import type { CandleData, TokenSelection, WeightedCandleData } from '../types';
+import type { CandleData, TokenSelection } from '../types';
 /**
  * Create efficient timestamp-based lookup maps for candle data
  */
@@ -21,4 +21,4 @@ export declare const getCompleteTimestamps: (candleLookups: Record<string, Map<n
  * Compute basket candles from individual token candles using weighted ratios
  * Optimized version that creates lookup maps once and reuses them
  */
-export declare const computeBasketCandles: (longTokens: TokenSelection[], shortTokens: TokenSelection[], tokenCandles: Record<string, CandleData[]>) => WeightedCandleData[];
+export declare const computeBasketCandles: (longTokens: TokenSelection[], shortTokens: TokenSelection[], tokenCandles: Record<string, CandleData[]>) => CandleData[];

package/dist/utils/http.d.ts

@@ -0,0 +1,3 @@
+import { ApiErrorResponse } from '../types';
+export declare function toApiError(error: unknown): ApiErrorResponse;
+export declare function joinUrl(baseUrl: string, path: string): string;

package/dist/utils/position-processor.d.ts

@@ -1,22 +1,2 @@
-import type { OpenPositionDto, WebData2Response, WsAllMidsData, RawPositionDto } from '../types';
-export declare class PositionProcessor {
-    private webData2;
-    private allMids;
-    constructor(webData2: WebData2Response | null, allMids: WsAllMidsData | null);
-    execute(rawPositions: RawPositionDto[]): OpenPositionDto[];
-    private getUserPositions;
-    private getMarketPrice;
-    private calculatePlatformTotalsByAsset;
-    private extractBaseCurrency;
-    private syncPositionWithAggregateData;
-    private determineSyncStatus;
-    private syncAssetWithAggregateData;
-    private mapPositionToDtoWithSyncData;
-    private mapAssetToDetailDto;
-    private calculateEntryRatio;
-    private calculateMarkRatio;
-    private calculateNetFundingFromSyncResults;
-    private calculateTotalUnrealizedPnlFromSyncResults;
-    private calculateCurrentTotalPositionValue;
-    private calculateEntryTotalPositionValue;
-}
+import { OpenPositionDto, RawPositionDto, WebData2Response, WsAllMidsData } from "../types";
+export declare const buildPositionValue: (rawPositions: RawPositionDto[], webData2: WebData2Response, allMids: WsAllMidsData) => OpenPositionDto[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pear-protocol/hyperliquid-sdk",
-  "version": "0.0.22",
+  "version": "0.0.26",
   "description": "React SDK for Pear Protocol Hyperliquid API integration",
   "type": "module",
   "main": "dist/index.js",

package/dist/migration-sdk.d.ts

@@ -1,59 +0,0 @@
-import { PearHyperliquidClient } from './client';
-import { SyncTradeHistoryDto, SyncTradeHistoryResponseDto, SyncOpenPositionDto, SyncOpenPositionResponseDto, SyncOpenOrderDto, SyncOpenOrderResponseDto, ApiResponse } from './types';
-/**
- * Main Migration SDK Class - Simple request/response pattern
- */
-export declare class PearMigrationSDK {
-    private client;
-    private isTradeHistorySyncRunning;
-    private isOpenPositionsSyncRunning;
-    private isOpenOrdersSyncRunning;
-    constructor(client: PearHyperliquidClient);
-    /**
-     * Sync trade history data - can only run one at a time
-     * If called while already running, returns immediately without making request
-     */
-    syncTradeHistory(payload: SyncTradeHistoryDto): Promise<ApiResponse<SyncTradeHistoryResponseDto> | null>;
-    /**
-     * Sync open positions data - can only run one at a time
-     * If called while already running, returns immediately without making request
-     */
-    syncOpenPositions(payload: SyncOpenPositionDto): Promise<ApiResponse<SyncOpenPositionResponseDto> | null>;
-    /**
-     * Sync open orders data - can only run one at a time
-     * If called while already running, returns immediately without making request
-     */
-    syncOpenOrders(payload: SyncOpenOrderDto): Promise<ApiResponse<SyncOpenOrderResponseDto> | null>;
-    /**
-     * Check if any sync is currently running
-     */
-    isSyncInProgress(): boolean;
-    /**
-     * Check if trade history sync is currently running
-     */
-    isTradeHistorySyncInProgress(): boolean;
-    /**
-     * Check if open positions sync is currently running
-     */
-    isOpenPositionsSyncInProgress(): boolean;
-    /**
-     * Check if open orders sync is currently running
-     */
-    isOpenOrdersSyncInProgress(): boolean;
-    /**
-     * Get the underlying client instance
-     */
-    getClient(): PearHyperliquidClient;
-    /**
-     * Set authorization token on the client
-     */
-    setAuthToken(token: string): void;
-    /**
-     * Set custom headers on the client
-     */
-    setHeaders(headers: Record<string, string>): void;
-    /**
-     * Get base URL from client
-     */
-    getBaseUrl(): string;
-}