@0xmonaco/react 0.8.7-develop.34bd452 → 0.8.7-develop.a107b34

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,92 @@
+/** 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_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,92 @@
+/** 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_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/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/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,8 +3,9 @@ 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,
@@ -12,6 +13,7 @@ function updateBalanceFromEvent(balance, event) {
         locked_balance: event.data.locked,
         locked_balance_raw: event.data.lockedRaw,
         total_balance: totalBalance,
+        total_balance_raw: totalBalanceRaw,
     };
 }
 function parseDecimal(value) {
@@ -72,6 +74,20 @@ function totalBalanceFromEvent(balance, event) {
     }
     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.total_balance_raw, balance.available_balance_raw, balance.locked_balance_raw);
+    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/useVault/types.d.ts

@@ -1,11 +1,11 @@
-import type { TransactionResult, WithdrawResult } from "@0xmonaco/types";
+import type { 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>;
     /** Get the allowance for a token */

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)

package/package.json

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