@0xmonaco/react 0.8.7-develop.0e951a5 → 0.8.7-develop.0f12336

package/README.md

@@ -47,7 +47,7 @@ function App() {
   return (
     <WagmiProvider config={wagmiConfig}>
       <MonacoProvider
-        network="development"
+        network="staging"
         seiRpcUrl="https://evm-rpc-testnet.sei-apis.com"
       >
         <YourApp />
@@ -372,4 +372,3 @@ For support, please:
 - Join our [Discord community](https://discord.gg/monaco)
 - Visit our [documentation site](https://docs.monaco.xyz)
 - Check our [API documentation](https://docs.0xmonaco.com)
-

package/dist/coverage.d.ts

@@ -0,0 +1,93 @@
+/** operationId → the @0xmonaco/react hook that covers it. */
+export declare const COVERED: {
+    add_position_margin: string;
+    attach_position_tp_sl: string;
+    batch_cancel_all: string;
+    batch_cancel_all_by_pair: string;
+    batch_cancel_orders: string;
+    batch_create_orders: string;
+    batch_replace_orders: string;
+    cancel_conditional_order: string;
+    cancel_order: string;
+    close_position: string;
+    batch_close_all_positions: string;
+    create_challenge: string;
+    create_order: string;
+    get_candles: string;
+    get_funding_state: string;
+    get_index_price: string;
+    get_mark_price: string;
+    get_market_metadata: string;
+    get_open_interest: string;
+    get_order_by_id: string;
+    get_orderbook_snapshot: string;
+    get_orders: string;
+    get_perp_market_config: string;
+    get_perp_market_summary: string;
+    get_position: string;
+    get_position_risk: string;
+    get_trades: string;
+    get_user_balance_by_asset: string;
+    get_user_balances: string;
+    get_user_movements: string;
+    get_user_profile: string;
+    get_withdrawal: string;
+    initiate_withdrawal: string;
+    list_pending_withdrawals: string;
+    list_conditional_orders: string;
+    list_funding_history: string;
+    list_position_history: string;
+    list_positions: string;
+    list_trading_pairs: string;
+    reduce_position_margin: string;
+    refresh_session: string;
+    replace_order: string;
+    revoke_session: string;
+    simulate_fees: string;
+};
+/** operationId → reason it is intentionally not covered by @0xmonaco/react. */
+export declare const INTENTIONALLY_EXCLUDED: {
+    authenticate_backend: string;
+    create_delegated_session: string;
+    create_sub_account_limit: string;
+    delete_sub_account_limit: string;
+    get_application_config: string;
+    get_application_stats: string;
+    get_available_collateral: string;
+    get_margin_account_movements: string;
+    get_margin_account_summary: string;
+    get_market_stats: string;
+    get_parent_margin_account_movements: string;
+    get_parent_margin_account_summary: string;
+    get_portfolio_chart: string;
+    get_portfolio_stats: string;
+    get_screener: string;
+    get_sub_account_limits: string;
+    get_trade_by_id: string;
+    get_trading_pair_by_id: string;
+    get_user_trades: string;
+    health_check: string;
+    list_application_balances: string;
+    list_application_movements: string;
+    list_application_orders: string;
+    list_application_users: string;
+    list_delegated_agent_owners: string;
+    list_delegated_agents: string;
+    list_funding_payments: string;
+    list_margin_accounts: string;
+    list_sub_accounts_with_balances: string;
+    mint_tokens: string;
+    revoke_delegated_agent: string;
+    simulate_risk_bucket_order_risk: string;
+    simulate_order_risk: string;
+    simulate_parent_margin_order_risk: string;
+    submit_whitelist: string;
+    transfer_collateral_from_parent_margin_account: string;
+    transfer_collateral_from_margin_account: string;
+    transfer_collateral_to_margin_account: string;
+    transfer_collateral_to_parent_margin_account: string;
+    transfer_collateral_to_risk_bucket: string;
+    update_sub_account_limit: string;
+    upsert_delegated_agent: string;
+    verify_signature: string;
+};

package/dist/coverage.js

@@ -0,0 +1,93 @@
+/** operationId → the @0xmonaco/react hook that covers it. */
+export const COVERED = {
+    add_position_margin: "usePositions",
+    attach_position_tp_sl: "usePositions",
+    batch_cancel_all: "useTrade",
+    batch_cancel_all_by_pair: "useTrade",
+    batch_cancel_orders: "useTrade",
+    batch_create_orders: "useTrade",
+    batch_replace_orders: "useTrade",
+    cancel_conditional_order: "useTrade",
+    cancel_order: "useTrade",
+    close_position: "usePositions",
+    batch_close_all_positions: "usePositions",
+    create_challenge: "useAuth",
+    create_order: "useTrade",
+    get_candles: "useMarket",
+    get_funding_state: "useMarket",
+    get_index_price: "useMarket",
+    get_mark_price: "useMarket",
+    get_market_metadata: "useMarket",
+    get_open_interest: "useMarket",
+    get_order_by_id: "useTrade",
+    get_orderbook_snapshot: "useOrderbook",
+    get_orders: "useTrade",
+    get_perp_market_config: "useMarket",
+    get_perp_market_summary: "useMarket",
+    get_position: "usePositions",
+    get_position_risk: "usePositions",
+    get_trades: "useTradeFeed",
+    get_user_balance_by_asset: "useProfile",
+    get_user_balances: "useUserBalances",
+    get_user_movements: "useUserMovements",
+    get_user_profile: "useProfile",
+    get_withdrawal: "useVault (retryWithdrawal)",
+    initiate_withdrawal: "useVault (withdraw)",
+    list_pending_withdrawals: "useVault (listPendingWithdrawals)",
+    list_conditional_orders: "useTrade",
+    list_funding_history: "useMarket",
+    list_position_history: "usePositions",
+    list_positions: "usePositions",
+    list_trading_pairs: "useMarket",
+    reduce_position_margin: "usePositions",
+    refresh_session: "useAuth",
+    replace_order: "useTrade",
+    revoke_session: "useAuth",
+    simulate_fees: "useFees",
+};
+/** operationId → reason it is intentionally not covered by @0xmonaco/react. */
+export const INTENTIONALLY_EXCLUDED = {
+    authenticate_backend: "Backend auth is header-based via setServerKey()/the x-server-key header, not an endpoint method (MON-1486).",
+    create_delegated_session: "Delegated-agent management is an automation/agent surface, not a UI workflow; no React hook.",
+    create_sub_account_limit: "Sub-account administration; no React hook.",
+    delete_sub_account_limit: "Sub-account administration; no React hook.",
+    get_application_config: "Application/backend (server-key) admin endpoint; not a user-wallet React workflow.",
+    get_application_stats: "Application/backend (server-key) admin endpoint; not a user-wallet React workflow.",
+    get_available_collateral: "Margin-account management/collateral/simulation endpoint; no React hook yet.",
+    get_margin_account_movements: "Margin-account management/collateral/simulation endpoint; no React hook yet.",
+    get_margin_account_summary: "Margin-account management/collateral/simulation endpoint; no React hook yet.",
+    get_market_stats: "Exchange-wide cumulative stats endpoint; available via the core client but no dedicated React hook yet.",
+    get_parent_margin_account_movements: "Margin-account management/collateral/simulation endpoint; no React hook yet.",
+    get_parent_margin_account_summary: "Margin-account management/collateral/simulation endpoint; no React hook yet.",
+    get_portfolio_chart: "Portfolio analytics endpoint; no React hook yet.",
+    get_portfolio_stats: "Portfolio analytics endpoint; no React hook yet.",
+    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_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.",
+    list_application_balances: "Application/backend (server-key) admin endpoint; not a user-wallet React workflow.",
+    list_application_movements: "Application/backend (server-key) admin endpoint; not a user-wallet React workflow.",
+    list_application_orders: "Application/backend (server-key) admin endpoint; not a user-wallet React workflow.",
+    list_application_users: "Application/backend (server-key) admin endpoint; not a user-wallet React workflow.",
+    list_delegated_agent_owners: "Delegated-agent management is an automation/agent surface, not a UI workflow; no React hook.",
+    list_delegated_agents: "Delegated-agent management is an automation/agent surface, not a UI workflow; no React hook.",
+    list_funding_payments: "Perps funding-payment history; no React hook yet.",
+    list_margin_accounts: "Margin-account management/collateral/simulation endpoint; no React hook yet.",
+    list_sub_accounts_with_balances: "Sub-account administration; no React hook.",
+    mint_tokens: "Test-net faucet; no React hook (use the MCP/core faucet path).",
+    revoke_delegated_agent: "Delegated-agent management is an automation/agent surface, not a UI workflow; no React hook.",
+    simulate_risk_bucket_order_risk: "Margin-account management/collateral/simulation endpoint; no React hook yet.",
+    simulate_order_risk: "Margin-account management/collateral/simulation endpoint; no React hook yet.",
+    simulate_parent_margin_order_risk: "Margin-account management/collateral/simulation endpoint; no React hook yet.",
+    submit_whitelist: "Whitelist submission; no React hook.",
+    transfer_collateral_from_parent_margin_account: "Margin-account management/collateral/simulation endpoint; no React hook yet.",
+    transfer_collateral_from_margin_account: "Margin-account management/collateral/simulation endpoint; no React hook yet.",
+    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.",
+    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/usePositions/types.d.ts

@@ -1,8 +1,9 @@
-import type { AddPositionMarginRequest, AttachPositionTpSlRequest, AttachPositionTpSlResponse, ClosePositionRequest, ClosePositionResponse, GetPositionResponse, ListPositionHistoryParams, ListPositionHistoryResponse, ListPositionsParams, ListPositionsResponse, PositionMarginResponse, PositionRisk, ReducePositionMarginRequest } from "@0xmonaco/types";
+import type { AddPositionMarginRequest, AttachPositionTpSlRequest, AttachPositionTpSlResponse, BatchCloseAllRequest, BatchCloseAllResponse, ClosePositionRequest, ClosePositionResponse, GetPositionResponse, ListPositionHistoryParams, ListPositionHistoryResponse, ListPositionsParams, ListPositionsResponse, PositionMarginResponse, PositionRisk, ReducePositionMarginRequest } from "@0xmonaco/types";
 export interface UsePositionsReturn {
     listPositions: (params?: ListPositionsParams) => Promise<ListPositionsResponse>;
     getPosition: (positionId: string) => Promise<GetPositionResponse>;
     closePosition: (positionId: string, request: ClosePositionRequest) => Promise<ClosePositionResponse>;
+    batchCloseAllPositions: (request?: BatchCloseAllRequest) => Promise<BatchCloseAllResponse>;
     getPositionRisk: (positionId: string) => Promise<PositionRisk>;
     addPositionMargin: (positionId: string, request: AddPositionMarginRequest) => Promise<PositionMarginResponse>;
     reducePositionMargin: (positionId: string, request: ReducePositionMarginRequest) => Promise<PositionMarginResponse>;

package/dist/hooks/usePositions/usePositions.js

@@ -23,6 +23,11 @@ export const usePositions = () => {
         requirePositionId(positionId);
         return await sdk.positions.closePosition(positionId, request);
     }, [sdk]);
+    const batchCloseAllPositions = useCallback(async (request) => {
+        if (!sdk)
+            throw new Error("SDK not available");
+        return await sdk.positions.batchCloseAllPositions(request);
+    }, [sdk]);
     const getPositionRisk = useCallback(async (positionId) => {
         if (!sdk)
             throw new Error("SDK not available");
@@ -56,6 +61,7 @@ export const usePositions = () => {
         listPositions,
         getPosition,
         closePosition,
+        batchCloseAllPositions,
         getPositionRisk,
         addPositionMargin,
         reducePositionMargin,

package/dist/hooks/useProfile/useProfile.js

@@ -51,9 +51,9 @@ export const useProfile = () => {
         try {
             const [userProfileResult, balancesResult, movementsResult, ordersResult] = await Promise.allSettled([
                 sdk.profile.getProfile(),
-                sdk.profile.getUserBalances({ page_size: DEFAULT_PAGE_SIZE, page: 1 }),
-                sdk.profile.getPaginatedUserMovements({ page: 1, page_size: DEFAULT_PAGE_SIZE }),
-                sdk.trading.getPaginatedOrders({ page: 1, page_size: DEFAULT_PAGE_SIZE }),
+                sdk.profile.getUserBalances({ pageSize: DEFAULT_PAGE_SIZE, page: 1 }),
+                sdk.profile.getPaginatedUserMovements({ page: 1, pageSize: DEFAULT_PAGE_SIZE }),
+                sdk.trading.getPaginatedOrders({ page: 1, pageSize: DEFAULT_PAGE_SIZE }),
             ]);
             const userProfile = getSettledValueOrThrow(userProfileResult);
             const balances = getFulfilledValue(balancesResult);

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

@@ -1,35 +1,13 @@
-import type { BatchCancelOrdersResponse, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchReplaceOrderParams, BatchReplaceOrdersResponse, CancelConditionalOrderResponse, CancelOrderResponse, CreateConditionalOrderParams, CreateConditionalOrderResponse, CreateOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, ListConditionalOrdersParams, ListConditionalOrdersResponse, OrderSide, ParentTpSlLegParams, PositionSide, ReplaceOrderResponse, TimeInForce, TradingMode } from "@0xmonaco/types";
+import type { BatchCancelOrdersResponse, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchReplaceOrderParams, BatchReplaceOrdersResponse, CancelConditionalOrderResponse, CancelOrderResponse, CreateOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, ListConditionalOrdersParams, ListConditionalOrdersResponse, OrderSide, ReplaceOrderResponse, TradingAPI } from "@0xmonaco/types";
+type PlaceLimitOrderOptions = NonNullable<Parameters<TradingAPI["placeLimitOrder"]>[4]>;
+type PlaceMarketOrderOptions = NonNullable<Parameters<TradingAPI["placeMarketOrder"]>[3]>;
 export interface UseTradeReturn {
     /** Place a limit order */
-    placeLimitOrder: (tradingPairId: string, side: OrderSide, quantity: string, price: string, options?: {
-        tradingMode?: TradingMode;
-        useMasterBalance?: boolean;
-        expirationDate?: string;
-        timeInForce?: TimeInForce;
-        marginAccountId?: string;
-        strategyKey?: string;
-        positionSide?: PositionSide;
-        leverage?: string;
-        reduceOnly?: boolean;
-        takeProfit?: ParentTpSlLegParams;
-        stopLoss?: ParentTpSlLegParams;
-    }) => Promise<CreateOrderResponse>;
+    placeLimitOrder: (tradingPairId: string, side: OrderSide, quantity: string, price: string, options?: PlaceLimitOrderOptions) => Promise<CreateOrderResponse>;
     /** Place a market order */
-    placeMarketOrder: (tradingPairId: string, side: OrderSide, quantity: string, options?: {
-        tradingMode?: TradingMode;
-        slippageTolerance?: number;
-        marginAccountId?: string;
-        strategyKey?: string;
-        positionSide?: PositionSide;
-        leverage?: string;
-        reduceOnly?: boolean;
-        takeProfit?: ParentTpSlLegParams;
-        stopLoss?: ParentTpSlLegParams;
-    }) => Promise<CreateOrderResponse>;
+    placeMarketOrder: (tradingPairId: string, side: OrderSide, quantity: string, options?: PlaceMarketOrderOptions) => Promise<CreateOrderResponse>;
     /** Cancel an existing order */
     cancelOrder: (orderId: string) => Promise<CancelOrderResponse>;
-    /** Create a standalone conditional TP/SL order */
-    createConditionalOrder: (params: CreateConditionalOrderParams) => Promise<CreateConditionalOrderResponse>;
     /** Cancel an active conditional TP/SL order */
     cancelConditionalOrder: (conditionalOrderId: string) => Promise<CancelConditionalOrderResponse>;
     /** List conditional TP/SL orders */
@@ -53,3 +31,4 @@ export interface UseTradeReturn {
     /** Get a single order by ID */
     getOrder: (orderId: string) => Promise<GetOrderResponse>;
 }
+export {};

package/dist/hooks/useTrade/useTrade.js

@@ -39,11 +39,6 @@ export const useTrade = () => {
             throw new Error("Order ID is required and cannot be empty");
         return await sdk.trading.cancelOrder(orderId);
     }, [sdk]);
-    const createConditionalOrder = useCallback(async (params) => {
-        if (!sdk)
-            throw new Error("SDK not available");
-        return await sdk.trading.createConditionalOrder(params);
-    }, [sdk]);
     const cancelConditionalOrder = useCallback(async (conditionalOrderId) => {
         if (!sdk)
             throw new Error("SDK not available");
@@ -117,7 +112,6 @@ export const useTrade = () => {
         placeMarketOrder,
         // Order management
         cancelOrder,
-        createConditionalOrder,
         cancelConditionalOrder,
         listConditionalOrders,
         batchCancel,

package/dist/hooks/useTradeFeed/useTradeFeed.js

@@ -19,7 +19,7 @@ export function useTradeFeed(tradingPairId) {
         if (!sdk?.ws || !sdk?.trades || !tradingPairId) {
             return;
         }
-        const fetchInitialTrades = () => sdk.trades.getTrades(tradingPairId, { page_size: MAX_TRADES });
+        const fetchInitialTrades = () => sdk.trades.getTrades(tradingPairId, { pageSize: MAX_TRADES });
         const subscribeToWs = (handler) => sdk.ws.trades(tradingPairId, handler);
         return subscribe(tradingPairId, fetchInitialTrades, subscribeToWs);
     }, [sdk?.ws, sdk?.trades, tradingPairId, subscribe]);

package/dist/hooks/useUserBalances/useUserBalances.d.ts

@@ -1,4 +1,9 @@
+import type { AccountBalance, UserBalanceEvent } from "@0xmonaco/types";
 import type { UseUserBalancesReturn } from "./types";
+/**
+ * Update an AccountBalance with data from a WebSocket balance event
+ */
+export declare function updateBalanceFromEvent(balance: AccountBalance, event: UserBalanceEvent): AccountBalance;
 /**
  * Hook for subscribing to real-time user balance updates via WebSocket (authenticated)
  *

package/dist/hooks/useUserBalances/useUserBalances.js

@@ -3,15 +3,17 @@ import { useMonacoSDK } from "../useMonaco";
 /**
  * Update an AccountBalance with data from a WebSocket balance event
  */
-function updateBalanceFromEvent(balance, event) {
+export function updateBalanceFromEvent(balance, event) {
     const totalBalance = totalBalanceFromEvent(balance, event);
+    const totalBalanceRaw = totalBalanceRawFromEvent(balance, event);
     return {
         ...balance,
-        available_balance: event.data.available,
-        available_balance_raw: event.data.availableRaw,
-        locked_balance: event.data.locked,
-        locked_balance_raw: event.data.lockedRaw,
-        total_balance: totalBalance,
+        availableBalance: event.data.available,
+        availableBalanceRaw: event.data.availableRaw,
+        lockedBalance: event.data.locked,
+        lockedBalanceRaw: event.data.lockedRaw,
+        totalBalance: totalBalance,
+        totalBalanceRaw: totalBalanceRaw,
     };
 }
 function parseDecimal(value) {
@@ -66,12 +68,26 @@ function totalBalanceFromEvent(balance, event) {
     if (eventExtraTotal && decimalGreaterThanZero(eventExtraTotal)) {
         return event.data.total;
     }
-    const previousMarginTotal = decimalDifference(balance.total_balance, balance.available_balance, balance.locked_balance);
+    const previousMarginTotal = decimalDifference(balance.totalBalance, balance.availableBalance, balance.lockedBalance);
     if (!previousMarginTotal || !decimalGreaterThanZero(previousMarginTotal)) {
         return event.data.total;
     }
     return decimalSum(event.data.total, previousMarginTotal) ?? event.data.total;
 }
+function totalBalanceRawFromEvent(balance, event) {
+    if (event.data.reason === "margin_transfer_in" || event.data.reason === "margin_transfer_out") {
+        return event.data.totalRaw;
+    }
+    const eventExtraTotalRaw = decimalDifference(event.data.totalRaw, event.data.availableRaw, event.data.lockedRaw);
+    if (eventExtraTotalRaw && decimalGreaterThanZero(eventExtraTotalRaw)) {
+        return event.data.totalRaw;
+    }
+    const previousMarginTotalRaw = decimalDifference(balance.totalBalanceRaw, balance.availableBalanceRaw, balance.lockedBalanceRaw);
+    if (!previousMarginTotalRaw || !decimalGreaterThanZero(previousMarginTotalRaw)) {
+        return event.data.totalRaw;
+    }
+    return decimalSum(event.data.totalRaw, previousMarginTotalRaw) ?? event.data.totalRaw;
+}
 /**
  * Hook for subscribing to real-time user balance updates via WebSocket (authenticated)
  *

package/dist/hooks/useUserMovements/useUserMovements.d.ts

@@ -10,9 +10,9 @@ import type { UseUserMovementsOptions, UseUserMovementsReturn } from "./types";
  *
  * @param options - Optional filter and pagination options
  * @param options.maxMovements - Maximum number of movements to keep in state (default: 50)
- * @param options.page_size - Number of items per page for the API call (default: maxMovements)
- * @param options.entry_type - Filter by entry type (CREDIT, DEBIT, LOCK, UNLOCK, FEE)
- * @param options.transaction_type - Filter by transaction type (DEPOSIT, WITHDRAWAL, TRADE, etc.)
- * @param options.asset_id - Filter by asset ID (UUID)
+ * @param options.pageSize - Number of items per page for the API call (default: maxMovements)
+ * @param options.entryType - Filter by entry type (CREDIT, DEBIT, LOCK, UNLOCK, FEE)
+ * @param options.transactionType - Filter by transaction type (DEPOSIT, WITHDRAWAL, TRADE, etc.)
+ * @param options.assetId - Filter by asset ID (UUID)
  */
 export declare function useUserMovements(options?: UseUserMovementsOptions): UseUserMovementsReturn;

package/dist/hooks/useUserMovements/useUserMovements.js

@@ -10,26 +10,26 @@ function ledgerMovementToEvent(movement, userId) {
         userId,
         data: {
             id: movement.id,
-            entryType: movement.entry_type,
-            transactionType: movement.transaction_type,
+            entryType: movement.entryType,
+            transactionType: movement.transactionType,
             tokenAddress: movement.token,
             symbol: movement.symbol ?? undefined,
             decimals: movement.decimals,
             amount: movement.amount,
-            amountRaw: movement.amount_raw,
-            balanceBefore: movement.balance_before ?? undefined,
-            balanceBeforeRaw: movement.balance_before_raw ?? undefined,
-            balanceAfter: movement.balance_after ?? undefined,
-            balanceAfterRaw: movement.balance_after_raw ?? undefined,
-            lockedBefore: movement.locked_before ?? undefined,
-            lockedBeforeRaw: movement.locked_before_raw ?? undefined,
-            lockedAfter: movement.locked_after ?? undefined,
-            lockedAfterRaw: movement.locked_after_raw ?? undefined,
-            referenceId: movement.reference_id ?? undefined,
-            referenceType: movement.reference_type ?? undefined,
+            amountRaw: movement.amountRaw,
+            balanceBefore: movement.balanceBefore ?? undefined,
+            balanceBeforeRaw: movement.balanceBeforeRaw ?? undefined,
+            balanceAfter: movement.balanceAfter ?? undefined,
+            balanceAfterRaw: movement.balanceAfterRaw ?? undefined,
+            lockedBefore: movement.lockedBefore ?? undefined,
+            lockedBeforeRaw: movement.lockedBeforeRaw ?? undefined,
+            lockedAfter: movement.lockedAfter ?? undefined,
+            lockedAfterRaw: movement.lockedAfterRaw ?? undefined,
+            referenceId: movement.referenceId ?? undefined,
+            referenceType: movement.referenceType ?? undefined,
             description: movement.description ?? undefined,
-            txHash: movement.tx_hash ?? undefined,
-            createdAt: movement.created_at ?? undefined,
+            txHash: movement.txHash ?? undefined,
+            createdAt: movement.createdAt ?? undefined,
         },
     };
 }
@@ -44,22 +44,22 @@ function ledgerMovementToEvent(movement, userId) {
  *
  * @param options - Optional filter and pagination options
  * @param options.maxMovements - Maximum number of movements to keep in state (default: 50)
- * @param options.page_size - Number of items per page for the API call (default: maxMovements)
- * @param options.entry_type - Filter by entry type (CREDIT, DEBIT, LOCK, UNLOCK, FEE)
- * @param options.transaction_type - Filter by transaction type (DEPOSIT, WITHDRAWAL, TRADE, etc.)
- * @param options.asset_id - Filter by asset ID (UUID)
+ * @param options.pageSize - Number of items per page for the API call (default: maxMovements)
+ * @param options.entryType - Filter by entry type (CREDIT, DEBIT, LOCK, UNLOCK, FEE)
+ * @param options.transactionType - Filter by transaction type (DEPOSIT, WITHDRAWAL, TRADE, etc.)
+ * @param options.assetId - Filter by asset ID (UUID)
  */
 export function useUserMovements(options = {}) {
     const { sdk } = useMonacoSDK();
     const { authenticationStatus } = useMonacoContext();
-    const { maxMovements = 50, page_size, entry_type, transaction_type, asset_id } = options;
+    const { maxMovements = 50, pageSize, entryType, transactionType, assetId } = options;
     const [movements, setMovements] = useState([]);
     const [loading, setLoading] = useState(false);
     const [error, setError] = useState(null);
     const [subscribed, setSubscribed] = useState(false);
     const clearError = useCallback(() => setError(null), []);
     const sliceSize = Number.isFinite(maxMovements) && maxMovements > 0 ? maxMovements : 50;
-    const requestLimit = page_size ?? Math.min(Math.max(Math.round(sliceSize), 1), 100);
+    const requestLimit = pageSize ?? Math.min(Math.max(Math.round(sliceSize), 1), 100);
     // Derive userId reactively — authenticationStatus changes on login/logout, triggering a re-render
     const userId = authenticationStatus === "authenticated" ? sdk?.getAuthState()?.user.id : undefined;
     useEffect(() => {
@@ -73,7 +73,7 @@ export function useUserMovements(options = {}) {
         // Fetch initial movements via REST API, then subscribe to WebSocket updates
         let unsubscribe;
         sdk.profile
-            .getPaginatedUserMovements({ page_size: requestLimit, entry_type, transaction_type, asset_id })
+            .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
@@ -117,6 +117,6 @@ export function useUserMovements(options = {}) {
             unsubscribe?.();
             setSubscribed(false);
         };
-    }, [sdk?.ws, sdk?.profile, userId, sliceSize, requestLimit, entry_type, transaction_type, asset_id]);
+    }, [sdk?.ws, sdk?.profile, userId, sliceSize, requestLimit, entryType, transactionType, assetId]);
     return { movements, loading, subscribed, error, clearError };
 }

package/dist/hooks/useUserOrders/useUserOrders.js

@@ -23,7 +23,7 @@ export function useUserOrders(maxOrders = 50) {
         try {
             const response = await sdk.trading.getPaginatedOrders({
                 page: 1,
-                page_size: maxOrders,
+                pageSize: maxOrders,
             });
             // 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
@@ -123,18 +123,18 @@ function orderFromEvent(event) {
         return null;
     return {
         id: event.orderId,
-        trading_pair_id: tradingPairId,
-        order_type: (data.orderType || "LIMIT"),
+        tradingPairId: tradingPairId,
+        orderType: (data.orderType || "LIMIT"),
         side: (data.side || "BUY"),
         price: data.price,
         quantity: data.quantity || "0",
-        filled_quantity: "0",
-        average_fill_price: undefined,
+        filledQuantity: "0",
+        averageFillPrice: undefined,
         status: data.status,
-        trading_mode: (data.tradingMode || "SPOT"),
-        time_in_force: data.timeInForce,
-        created_at: event.timestamp,
-        updated_at: event.timestamp,
+        tradingMode: (data.tradingMode || "SPOT"),
+        timeInForce: data.timeInForce,
+        createdAt: event.timestamp,
+        updatedAt: event.timestamp,
     };
 }
 /**
@@ -170,8 +170,8 @@ function updateOrderFromEvent(order, event) {
         }
     }
     // Get filled quantity from different event types
-    let filledQuantity = order.filled_quantity;
-    let avgFillPrice = order.average_fill_price;
+    let filledQuantity = order.filledQuantity;
+    let avgFillPrice = order.averageFillPrice;
     if ("totalFilled" in data && data.totalFilled) {
         filledQuantity = data.totalFilled;
     }
@@ -184,8 +184,8 @@ function updateOrderFromEvent(order, event) {
     return {
         ...order,
         status: newStatus,
-        filled_quantity: filledQuantity,
-        average_fill_price: avgFillPrice,
-        updated_at: event.timestamp,
+        filledQuantity: filledQuantity,
+        averageFillPrice: avgFillPrice,
+        updatedAt: event.timestamp,
     };
 }

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

@@ -1,13 +1,15 @@
-import type { TransactionResult, WithdrawResult } from "@0xmonaco/types";
+import type { ListPendingWithdrawalsParams, ListPendingWithdrawalsResponse, TransactionResult, WithdrawalSource, WithdrawResult } from "@0xmonaco/types";
 export interface UseVaultReturn {
     /** Approve the vault to spend tokens */
     approve: (assetId: string, amount: bigint, autoWait?: boolean) => Promise<TransactionResult>;
     /** Deposit tokens into the vault */
     deposit: (assetId: string, amount: bigint, autoWait?: boolean) => Promise<TransactionResult>;
     /** Initiate a withdrawal and submit the pre-signed calldata on-chain */
-    withdraw: (assetId: string, amount: bigint, autoWait?: boolean) => Promise<WithdrawResult>;
+    withdraw: (assetId: string, amount: bigint, autoWait?: boolean, source?: WithdrawalSource) => Promise<WithdrawResult>;
     /** Retry a withdrawal whose on-chain submission never landed — does NOT create a new one */
     retryWithdrawal: (withdrawalIndex: number, autoWait?: boolean) => Promise<WithdrawResult>;
+    /** List the caller's pending withdrawals (awaiting on-chain confirmation), newest first */
+    listPendingWithdrawals: (params?: ListPendingWithdrawalsParams) => Promise<ListPendingWithdrawalsResponse>;
     /** Get the allowance for a token */
     getAllowance: (assetId: string) => Promise<bigint>;
     /** Check if a token needs approval for an amount */

package/dist/hooks/useVault/useVault.js

@@ -20,14 +20,14 @@ export const useVault = () => {
             throw new Error("Amount must be greater than 0");
         return await sdk.vault.deposit(assetId, amount, autoWait);
     }, [sdk]);
-    const withdraw = useCallback(async (assetId, amount, autoWait) => {
+    const withdraw = useCallback(async (assetId, amount, autoWait, source) => {
         if (!sdk)
             throw new Error("SDK not available");
         if (!assetId?.trim())
             throw new Error("Asset ID is required and cannot be empty");
         if (amount <= 0n)
             throw new Error("Amount must be greater than 0");
-        return await sdk.vault.withdraw(assetId, amount, autoWait);
+        return await sdk.vault.withdraw(assetId, amount, autoWait, source);
     }, [sdk]);
     const retryWithdrawal = useCallback(async (withdrawalIndex, autoWait) => {
         if (!sdk)
@@ -37,6 +37,11 @@ export const useVault = () => {
         }
         return await sdk.vault.retryWithdrawal(withdrawalIndex, autoWait);
     }, [sdk]);
+    const listPendingWithdrawals = useCallback(async (params) => {
+        if (!sdk)
+            throw new Error("SDK not available");
+        return await sdk.withdrawals.listPendingWithdrawals(params);
+    }, [sdk]);
     const getAllowance = useCallback(async (assetId) => {
         if (!sdk)
             throw new Error("SDK not available");
@@ -59,6 +64,7 @@ export const useVault = () => {
         deposit,
         withdraw,
         retryWithdrawal,
+        listPendingWithdrawals,
         // Approval and allowance queries
         getAllowance,
         needsApproval,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/react",
-	"version": "0.8.7-develop.0e951a5",
+	"version": "0.8.7-develop.0f12336",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -20,8 +20,8 @@
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@0xmonaco/core": "0.8.7-develop.0e951a5",
-		"@0xmonaco/types": "0.8.7-develop.0e951a5"
+		"@0xmonaco/core": "0.8.7-develop.0f12336",
+		"@0xmonaco/types": "0.8.7-develop.0f12336"
 	},
 	"devDependencies": {
 		"@types/react": "^19.1.12",