@0xmonaco/react 1.0.37 → 1.0.38-develop.ebf8e8c

package/dist/coverage.d.ts

@@ -33,6 +33,8 @@ export declare const COVERED: {
     get_position: string;
     get_position_pnl_history: string;
     get_position_risk: string;
+    get_rewards_balance: string;
+    get_trader_code_info: string;
     get_trades: string;
     get_user_balance_by_asset: string;
     get_user_balances: string;
@@ -51,6 +53,7 @@ export declare const COVERED: {
     replace_order: string;
     revoke_session: string;
     simulate_fees: string;
+    transfer_rewards: string;
 };
 /** operationId → reason it is intentionally not covered by @0xmonaco/react. */
 export declare const INTENTIONALLY_EXCLUDED: {
@@ -74,11 +77,9 @@ export declare const INTENTIONALLY_EXCLUDED: {
     get_portfolio_realized_pnl: string;
     get_portfolio_stats: string;
     get_portfolio_summary: string;
-    get_rewards_balance: string;
     get_screener: string;
     get_sub_account_limits: string;
     get_trade_by_id: string;
-    get_trader_code_info: string;
     get_trading_pair_by_id: string;
     get_user_trades: string;
     health_check: string;
@@ -104,7 +105,6 @@ export declare const INTENTIONALLY_EXCLUDED: {
     transfer_collateral_to_margin_account: string;
     transfer_collateral_to_parent_margin_account: string;
     transfer_collateral_to_risk_bucket: string;
-    transfer_rewards: string;
     update_sub_account_limit: string;
     upsert_delegated_agent: string;
     verify_signature: string;

package/dist/coverage.js

@@ -33,6 +33,8 @@ export const COVERED = {
     get_position: "usePositions",
     get_position_pnl_history: "usePositionPnlHistory",
     get_position_risk: "usePositions",
+    get_rewards_balance: "useRewardsBalance",
+    get_trader_code_info: "useTraderCodeInfo",
     get_trades: "useTradeFeed",
     get_user_balance_by_asset: "useProfile",
     get_user_balances: "useUserBalances",
@@ -51,6 +53,7 @@ export const COVERED = {
     replace_order: "useTrade",
     revoke_session: "useAuth",
     simulate_fees: "useFees",
+    transfer_rewards: "useTransferRewards",
 };
 /** operationId → reason it is intentionally not covered by @0xmonaco/react. */
 export const INTENTIONALLY_EXCLUDED = {
@@ -74,11 +77,9 @@ export const INTENTIONALLY_EXCLUDED = {
     get_portfolio_realized_pnl: "Authoritative portfolio analytics is available through @0xmonaco/core; no dedicated React hook in this release.",
     get_portfolio_stats: "Portfolio analytics endpoint; no React hook yet.",
     get_portfolio_summary: "Authoritative portfolio analytics is available through @0xmonaco/core; no dedicated React hook in this release.",
-    get_rewards_balance: "PitPass rewards-balance read is available via @0xmonaco/core; no dedicated React hook.",
     get_screener: "Market lookup available via the core client / list+symbol hooks; no dedicated React hook.",
     get_sub_account_limits: "Sub-account administration; no React hook.",
     get_trade_by_id: "Trade-history lookup with a core client method but no dedicated React hook yet.",
-    get_trader_code_info: "Public PitPass TraderCode lookup is available via @0xmonaco/core; no dedicated React hook.",
     get_trading_pair_by_id: "Market lookup available via the core client / list+symbol hooks; no dedicated React hook.",
     get_user_trades: "Trade-history lookup with a core client method but no dedicated React hook yet.",
     health_check: "Infrastructure liveness probe (GET /health); not part of the data SDK surface.",
@@ -104,7 +105,6 @@ export const INTENTIONALLY_EXCLUDED = {
     transfer_collateral_to_margin_account: "Margin-account management/collateral/simulation endpoint; no React hook yet.",
     transfer_collateral_to_parent_margin_account: "Margin-account management/collateral/simulation endpoint; no React hook yet.",
     transfer_collateral_to_risk_bucket: "Margin-account management/collateral/simulation endpoint; no React hook yet.",
-    transfer_rewards: "PitPass rewards transfer is available via @0xmonaco/core; no dedicated React hook.",
     update_sub_account_limit: "Sub-account administration; no React hook.",
     upsert_delegated_agent: "Delegated-agent management is an automation/agent surface, not a UI workflow; no React hook.",
     verify_signature: "Auth verification runs inside login()/authenticate(); useAuth does not expose verifySignature as its own hook method.",

package/dist/hooks/usePitpass/index.d.ts

@@ -1,5 +1,8 @@
-export type { UseClearTraderCodeReturn, UseMyTraderCodeReturn, UseSetTraderCodeReturn, UseTraderCodeAvailabilityReturn } from "./types";
+export type { UseClearTraderCodeReturn, UseMyTraderCodeReturn, UseRewardsBalanceReturn, UseSetTraderCodeReturn, UseTraderCodeAvailabilityReturn, UseTraderCodeInfoReturn, UseTransferRewardsReturn, } from "./types";
 export { useClearTraderCode } from "./useClearTraderCode";
 export { useMyTraderCode } from "./useMyTraderCode";
+export { useRewardsBalance } from "./useRewardsBalance";
 export { useSetTraderCode } from "./useSetTraderCode";
 export { useTraderCodeAvailability } from "./useTraderCodeAvailability";
+export { useTraderCodeInfo } from "./useTraderCodeInfo";
+export { useTransferRewards } from "./useTransferRewards";

package/dist/hooks/usePitpass/index.js

@@ -1,4 +1,7 @@
 export { useClearTraderCode } from "./useClearTraderCode";
 export { useMyTraderCode } from "./useMyTraderCode";
+export { useRewardsBalance } from "./useRewardsBalance";
 export { useSetTraderCode } from "./useSetTraderCode";
 export { useTraderCodeAvailability } from "./useTraderCodeAvailability";
+export { useTraderCodeInfo } from "./useTraderCodeInfo";
+export { useTransferRewards } from "./useTransferRewards";

package/dist/hooks/usePitpass/types.d.ts

@@ -1,4 +1,4 @@
-import type { TraderCodeAvailabilityResponse, TraderCodeResponse } from "@0xmonaco/types";
+import type { GetRewardsBalanceResponse, TraderCodeAvailabilityResponse, TraderCodeInfoResponse, TraderCodeResponse, TransferRewardsParams, TransferRewardsResponse } from "@0xmonaco/types";
 export interface UseMyTraderCodeReturn {
     /** Read the caller's TraderCode identity (wallet-derived `code` plus the custom-handle fields). */
     getMyTraderCode: () => Promise<TraderCodeResponse>;
@@ -15,3 +15,15 @@ export interface UseTraderCodeAvailabilityReturn {
     /** Public advisory check of whether a custom TraderCode handle is available. */
     checkTraderCodeAvailability: (code: string) => Promise<TraderCodeAvailabilityResponse>;
 }
+export interface UseRewardsBalanceReturn {
+    /** Read the caller's current PitPass rewards-bucket balances. */
+    getRewardsBalance: () => Promise<GetRewardsBalanceResponse>;
+}
+export interface UseTraderCodeInfoReturn {
+    /** Public lookup of a TraderCode by wallet address (bare or `Monaco - <address>` display form). */
+    getTraderCodeInfo: (code: string) => Promise<TraderCodeInfoResponse>;
+}
+export interface UseTransferRewardsReturn {
+    /** Transfer earned PitPass rewards into a tradeable balance. */
+    transferRewards: (params: TransferRewardsParams) => Promise<TransferRewardsResponse>;
+}

package/dist/hooks/usePitpass/useRewardsBalance.d.ts

@@ -0,0 +1,8 @@
+import type { UseRewardsBalanceReturn } from "./types";
+/**
+ * Read the authenticated caller's current PitPass rewards-bucket balances.
+ *
+ * Rewards accrue in a separate bucket per token; call
+ * {@link useTransferRewards} to move them into a tradeable balance.
+ */
+export declare const useRewardsBalance: () => UseRewardsBalanceReturn;

package/dist/hooks/usePitpass/useRewardsBalance.js

@@ -0,0 +1,17 @@
+import { useCallback } from "react";
+import { useMonacoSDK } from "../useMonaco";
+/**
+ * Read the authenticated caller's current PitPass rewards-bucket balances.
+ *
+ * Rewards accrue in a separate bucket per token; call
+ * {@link useTransferRewards} to move them into a tradeable balance.
+ */
+export const useRewardsBalance = () => {
+    const { sdk } = useMonacoSDK();
+    const getRewardsBalance = useCallback(async () => {
+        if (!sdk)
+            throw new Error("SDK not available");
+        return await sdk.pitpass.getRewardsBalance();
+    }, [sdk]);
+    return { getRewardsBalance };
+};

package/dist/hooks/usePitpass/useTraderCodeInfo.d.ts

@@ -0,0 +1,9 @@
+import type { UseTraderCodeInfoReturn } from "./types";
+/**
+ * Public lookup of a PitPass TraderCode by wallet address.
+ *
+ * Accepts the bare address or the `Monaco - <address>` display form. Used at
+ * sign-up to validate a referral code before it is applied. No authentication
+ * required.
+ */
+export declare const useTraderCodeInfo: () => UseTraderCodeInfoReturn;

package/dist/hooks/usePitpass/useTraderCodeInfo.js

@@ -0,0 +1,18 @@
+import { useCallback } from "react";
+import { useMonacoSDK } from "../useMonaco";
+/**
+ * Public lookup of a PitPass TraderCode by wallet address.
+ *
+ * Accepts the bare address or the `Monaco - <address>` display form. Used at
+ * sign-up to validate a referral code before it is applied. No authentication
+ * required.
+ */
+export const useTraderCodeInfo = () => {
+    const { sdk } = useMonacoSDK();
+    const getTraderCodeInfo = useCallback(async (code) => {
+        if (!sdk)
+            throw new Error("SDK not available");
+        return await sdk.pitpass.getTraderCodeInfo(code);
+    }, [sdk]);
+    return { getTraderCodeInfo };
+};

package/dist/hooks/usePitpass/useTransferRewards.d.ts

@@ -0,0 +1,9 @@
+import type { UseTransferRewardsReturn } from "./types";
+/**
+ * Transfer the authenticated caller's earned PitPass rewards into a tradeable
+ * balance.
+ *
+ * Parameters (`token`, `amount`) are validated by the SDK core using Zod; the
+ * response echoes the remaining rewards balance. Requires authentication.
+ */
+export declare const useTransferRewards: () => UseTransferRewardsReturn;

package/dist/hooks/usePitpass/useTransferRewards.js

@@ -0,0 +1,19 @@
+import { useCallback } from "react";
+import { useMonacoSDK } from "../useMonaco";
+/**
+ * Transfer the authenticated caller's earned PitPass rewards into a tradeable
+ * balance.
+ *
+ * Parameters (`token`, `amount`) are validated by the SDK core using Zod; the
+ * response echoes the remaining rewards balance. Requires authentication.
+ */
+export const useTransferRewards = () => {
+    const { sdk } = useMonacoSDK();
+    const transferRewards = useCallback(async (params) => {
+        if (!sdk)
+            throw new Error("SDK not available");
+        // Parameter validation is handled by the SDK core using Zod
+        return await sdk.pitpass.transferRewards(params);
+    }, [sdk]);
+    return { transferRewards };
+};

package/dist/hooks/useTokenLifecycle/types.d.ts

@@ -1,23 +1,37 @@
 import type { AuthState } from "@0xmonaco/types";
+/**
+ * Configuration for the session lifecycle hook.
+ *
+ * The `persistTokens` field name is a retained legacy compatibility name; it
+ * persists the ed25519 session key (the `AuthState`), not any JWT or bearer
+ * credential.
+ */
 export interface TokenLifecycleConfig {
-    /** Enable automatic token refresh (default: true) */
+    /** Enable automatic session refresh before expiry (default: true) */
     autoRefresh?: boolean;
-    /** Enable token persistence in localStorage (default: true) */
+    /** Persist the session in localStorage so it survives reloads (default: true) */
     persistTokens?: boolean;
-    /** Buffer time in seconds before token expiry to trigger refresh (default: 300 = 5 minutes) */
+    /** Buffer time in seconds before session expiry to trigger a refresh (default: 300 = 5 minutes) */
     refreshBufferSeconds?: number;
-    /** Callback when token refresh fails */
+    /** Callback when a session refresh fails */
     onRefreshError?: (error: Error) => void;
-    /** Callback when token is refreshed successfully */
+    /** Callback when the session is refreshed successfully */
     onRefreshSuccess?: (authState: AuthState) => void;
 }
+/**
+ * Return shape of the session lifecycle hook.
+ *
+ * The `initializeTokens`, `clearTokens`, `refreshTokens`, and `isTokenExpired`
+ * member names are retained legacy compatibility names; they all act on the
+ * session key.
+ */
 export interface UseTokenLifecycleReturn {
-    /** Initialize token lifecycle with auth state */
+    /** Start managing a session from an auth state (persists it and schedules auto-refresh) */
     initializeTokens: (authState: AuthState) => void;
-    /** Clear tokens and stop lifecycle management */
+    /** Stop managing the session, cancel scheduled refreshes, and clear persistence */
     clearTokens: () => void;
-    /** Manually trigger token refresh */
+    /** Manually extend the session's expiry now */
     refreshTokens: () => Promise<AuthState | null>;
-    /** Check if token is expired or near expiry */
+    /** Whether the session is expired or within the refresh buffer of expiry */
     isTokenExpired: (authState: AuthState | null) => boolean;
 }

package/dist/hooks/useTokenLifecycle/useTokenLifecycle.d.ts

@@ -1,11 +1,23 @@
 import type { MonacoSDK } from "@0xmonaco/core";
 import type { TokenLifecycleConfig, UseTokenLifecycleReturn } from "./types";
 /**
- * Hook for managing token lifecycle including automatic refresh and persistence
+ * Hook for managing the authenticated session lifecycle, including automatic
+ * refresh and persistence.
+ *
+ * Monaco authenticates with a wallet-authorized ed25519 session key (the
+ * `AuthState` returned by `login()`), not a JWT or bearer credential. This hook
+ * extends that session's expiry via `sdk.refreshAuth()` and persists the
+ * resulting `AuthState`; there is no separate access or refresh credential.
+ *
+ * The exported members and config fields listed here — `useTokenLifecycle`,
+ * `TokenLifecycleConfig`, `persistTokens`, `initializeTokens`, `clearTokens`,
+ * `refreshTokens`, `isTokenExpired`, and the like — are retained legacy
+ * compatibility names kept stable for existing consumers; they all operate on
+ * the session key.
  *
  * @param sdk - Monaco SDK instance
- * @param config - Configuration options for token lifecycle
- * @returns Token lifecycle management functions
+ * @param config - Configuration options for the session lifecycle
+ * @returns Session lifecycle management functions
  *
  * @example
  * ```tsx
@@ -13,7 +25,7 @@ import type { TokenLifecycleConfig, UseTokenLifecycleReturn } from "./types";
  *   autoRefresh: true,
  *   persistTokens: true,
  *   refreshBufferSeconds: 300, // 5 minutes
- *   onRefreshError: (error) => console.error('Token refresh failed:', error),
+ *   onRefreshError: (error) => console.error('Session refresh failed:', error),
  * });
  * ```
  */

package/dist/hooks/useTokenLifecycle/useTokenLifecycle.js

@@ -2,11 +2,23 @@ import { useCallback, useEffect, useMemo, useRef } from "react";
 import { clearAuthState, getTimeUntilExpiry, isTokenExpired, saveAuthState } from "../../utils";
 import { validateRefreshBuffer } from "./utils";
 /**
- * Hook for managing token lifecycle including automatic refresh and persistence
+ * Hook for managing the authenticated session lifecycle, including automatic
+ * refresh and persistence.
+ *
+ * Monaco authenticates with a wallet-authorized ed25519 session key (the
+ * `AuthState` returned by `login()`), not a JWT or bearer credential. This hook
+ * extends that session's expiry via `sdk.refreshAuth()` and persists the
+ * resulting `AuthState`; there is no separate access or refresh credential.
+ *
+ * The exported members and config fields listed here — `useTokenLifecycle`,
+ * `TokenLifecycleConfig`, `persistTokens`, `initializeTokens`, `clearTokens`,
+ * `refreshTokens`, `isTokenExpired`, and the like — are retained legacy
+ * compatibility names kept stable for existing consumers; they all operate on
+ * the session key.
  *
  * @param sdk - Monaco SDK instance
- * @param config - Configuration options for token lifecycle
- * @returns Token lifecycle management functions
+ * @param config - Configuration options for the session lifecycle
+ * @returns Session lifecycle management functions
  *
  * @example
  * ```tsx
@@ -14,7 +26,7 @@ import { validateRefreshBuffer } from "./utils";
  *   autoRefresh: true,
  *   persistTokens: true,
  *   refreshBufferSeconds: 300, // 5 minutes
- *   onRefreshError: (error) => console.error('Token refresh failed:', error),
+ *   onRefreshError: (error) => console.error('Session refresh failed:', error),
  * });
  * ```
  */
@@ -61,7 +73,7 @@ export const useTokenLifecycle = (sdk, config = {}) => {
             try {
                 // Re-check SDK in case it became null during async operations
                 if (!sdk) {
-                    console.warn("SDK became null during token refresh");
+                    console.warn("SDK became null during session refresh");
                     return null;
                 }
                 const newAuthState = await sdk.refreshAuth();
@@ -75,7 +87,7 @@ export const useTokenLifecycle = (sdk, config = {}) => {
             }
             catch (error) {
                 const err = error instanceof Error ? error : new Error(String(error));
-                console.error("Failed to refresh tokens:", err);
+                console.error("Failed to refresh session:", err);
                 if (persistTokens) {
                     clearAuthState();
                 }

package/dist/hooks/useUserMovements/useUserMovements.js

@@ -75,21 +75,17 @@ export function useUserMovements(options = {}) {
         sdk.profile
             .getPaginatedUserMovements({ pageSize: requestLimit, entryType, transactionType, assetId })
             .then(async (response) => {
-            // Combine latest_movements (from the live engine cache) with movements (from PostgreSQL)
-            // latest_movements contains real-time data that may not yet be in PostgreSQL
-            // Deduplicate by id, preferring latest_movements (newer data)
-            const latestMovements = (response.latest_movements || []).map((m) => ledgerMovementToEvent(m, userId));
+            // Deduplicate the paginated movements by id, keeping the first occurrence.
             const historicalMovements = response.movements.map((m) => ledgerMovementToEvent(m, userId));
-            // Merge: latest_movements first, then historical, deduplicated by id
             const seenIds = new Set();
-            const mergedMovements = [];
-            for (const movement of [...latestMovements, ...historicalMovements]) {
+            const dedupedMovements = [];
+            for (const movement of historicalMovements) {
                 if (!seenIds.has(movement.data.id)) {
                     seenIds.add(movement.data.id);
-                    mergedMovements.push(movement);
+                    dedupedMovements.push(movement);
                 }
             }
-            setMovements(mergedMovements.slice(0, sliceSize));
+            setMovements(dedupedMovements.slice(0, sliceSize));
             // Subscribe to WebSocket movement updates after initial data is loaded
             // This prevents race conditions where WS events could be overwritten by REST response
             try {

package/dist/hooks/useUserOrders/useUserOrders.js

@@ -27,21 +27,16 @@ export function useUserOrders(maxOrders = 50) {
                 pageSize: maxOrders,
                 pageToken: "",
             });
-            // Combine latest_orders (from the live engine cache) with orders (from PostgreSQL)
-            // latest_orders contains real-time data that may not yet be in PostgreSQL
-            // Deduplicate by id, preferring latest_orders (newer data)
-            const latestOrders = response.latest_orders || [];
-            const historicalOrders = response.orders;
-            // Merge: latest_orders first, then historical, deduplicated by id
+            // Deduplicate the paginated orders by id, keeping the first occurrence.
             const seenIds = new Set();
-            const mergedOrders = [];
-            for (const order of [...latestOrders, ...historicalOrders]) {
+            const dedupedOrders = [];
+            for (const order of response.orders) {
                 if (!seenIds.has(order.id)) {
                     seenIds.add(order.id);
-                    mergedOrders.push(order);
+                    dedupedOrders.push(order);
                 }
             }
-            setOrders(mergedOrders.slice(0, maxOrders));
+            setOrders(dedupedOrders.slice(0, maxOrders));
         }
         catch (err) {
             setError(err instanceof Error ? err : new Error(String(err)));
@@ -120,7 +115,7 @@ function orderFromEvent(event) {
     if (event.eventType !== "OrderPlaced")
         return null;
     const { data } = event;
-    const tradingPairId = data.tradingPairId || data.symbol;
+    const tradingPairId = data.tradingPairId || data.tradingPair;
     if (!tradingPairId)
         return null;
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/react",
-	"version": "1.0.37",
+	"version": "1.0.38-develop.ebf8e8c",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -20,8 +20,8 @@
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@0xmonaco/core": "1.0.37",
-		"@0xmonaco/types": "1.0.37"
+		"@0xmonaco/core": "1.0.38-develop.ebf8e8c",
+		"@0xmonaco/types": "1.0.38-develop.ebf8e8c"
 	},
 	"devDependencies": {
 		"@types/react": "^19.1.12",
@@ -29,8 +29,8 @@
 	},
 	"peerDependencies": {
 		"react": "^17.0.0 || ^18.0.0 || ^19.0.0",
-		"wagmi": "^2.0.0 || ^3.0.0",
-		"viem": "^2.45.2"
+		"viem": "^2.45.2",
+		"wagmi": "^2.0.0 || ^3.0.0"
 	},
 	"exports": {
 		".": {