@0xmonaco/types 0.8.11 → 0.8.15

package/dist/vault/responses.d.ts

@@ -3,6 +3,7 @@
  *
  * Response types for vault operations.
  */
+import type { Address } from "viem";
 /**
  * Response from a transaction.
  */
@@ -17,29 +18,66 @@ export interface TransactionResult {
     receipt?: import("viem").TransactionReceipt;
 }
 /**
- * Result of initiating a withdrawal.
+ * Result of a withdrawal.
  *
  * The API gateway allocates a `withdrawalIndex` via the matching engine and
- * returns pre-signed calldata for the vault contract's
- * `executeSignedWithdrawal(...)` function. The SDK submits that calldata on
- * behalf of the connected wallet — the user is the on-chain caller, but the
- * `WITHDRAWAL_SIGNER` signature embedded in the calldata is what the contract
- * authenticates against.
+ * debits the balance immediately. The executable `executeWithdrawal(...)`
+ * calldata only exists once the withdrawal's root is confirmed on-chain and its
+ * merkle proof is persisted; the SDK polls for it and submits it through the
+ * connected wallet.
  *
- * Extends [`TransactionResult`] so callers can read `hash`, `status`, `nonce`
- * (and `receipt` when `autoWait` is true) directly off the result, just like
- * `approve` / `deposit`.
+ * `withdrawalIndex` is therefore ALWAYS present — even when the proof did not
+ * become available within the poll window. In that case `status` is
+ * `"awaiting_proof"` and no transaction was submitted (`hash`, `nonce`, and
+ * `receipt` are absent); the caller keeps `withdrawalIndex` and finishes the
+ * withdrawal later with `retryWithdrawal(withdrawalIndex)`. This is why the
+ * transaction fields are optional rather than inherited as required from
+ * [`TransactionResult`]: a debited-but-unproven withdrawal must never strand the
+ * index inside a thrown error.
  */
-export interface WithdrawResult extends TransactionResult {
-    /** Allocated withdrawal index — matches `executeSignedWithdrawal.index`. */
+export interface WithdrawResult {
+    /** Allocated withdrawal index — matches `executeWithdrawal.index`. Always present. */
     withdrawalIndex: number;
+    /**
+     * Outcome of the withdrawal:
+     * - `"awaiting_proof"` — index allocated and balance debited, but the merkle
+     *   proof was not available within the poll window, so nothing was submitted
+     *   on-chain. Call `retryWithdrawal(withdrawalIndex)` once the root confirms.
+     * - `"pending" | "confirmed" | "failed"` — the calldata was submitted on-chain;
+     *   semantics match [`TransactionResult.status`].
+     */
+    status: TransactionResult["status"] | "awaiting_proof";
+    /** Transaction hash — absent when `status === "awaiting_proof"`. */
+    hash?: string;
+    /** Nonce used for the on-chain submission — absent when `status === "awaiting_proof"`. */
+    nonce?: bigint;
+    /** Transaction receipt (only when `autoWait` is enabled and the tx was submitted). */
+    receipt?: import("viem").TransactionReceipt;
+}
+/**
+ * Controls how the SDK polls for a withdrawal's `executeWithdrawal` calldata
+ * while its merkle proof is not yet available (the withdrawal root has not been
+ * confirmed on-chain). The gateway returns 404 (row not persisted yet) or 409
+ * (proof not confirmed yet) until ready; the SDK retries on both.
+ */
+export interface WithdrawalRetryOptions {
+    /** Delay between polls, in milliseconds. Defaults to 5000. */
+    pollIntervalMs?: number;
+    /**
+     * Maximum total time to wait for the proof, in milliseconds. Defaults to
+     * 300_000 (5 minutes). On timeout the SDK does not throw — `withdraw` /
+     * `retryWithdrawal` return `{ status: "awaiting_proof", withdrawalIndex }` so
+     * the caller can retry later. Pass `Infinity` to poll indefinitely until the
+     * proof is available.
+     */
+    timeoutMs?: number;
 }
 /**
  * Token balance information.
  */
 export interface Balance {
     /** Token address */
-    token: string;
+    token: Address;
     /** Balance amount */
     amount: bigint;
     /** Formatted balance string */

package/dist/websocket/events/balance-events.d.ts

@@ -4,6 +4,7 @@
  * Types for real-time user balance update events.
  * This is an authenticated channel - requires JWT token.
  */
+import type { Address } from "viem";
 /**
  * Reason for the balance update
  */
@@ -13,7 +14,7 @@ export type BalanceUpdateReason = "lock" | "unlock" | "deposit" | "withdrawal" |
  */
 export interface UserBalanceEventData {
     /** Token contract address */
-    tokenAddress: string;
+    tokenAddress: Address;
     /** Token symbol */
     tokenSymbol: string | null;
     /** Available balance for trading (normalized) */

package/dist/websocket/events/movement-events.d.ts

@@ -4,6 +4,7 @@
  * Types for real-time user ledger movement events (deposits, withdrawals, transfers).
  * This is an authenticated channel - requires JWT token.
  */
+import type { Address } from "viem";
 /**
  * User movement event data containing ledger entry details
  */
@@ -15,7 +16,7 @@ export interface UserMovementEventData {
     /** Transaction type (e.g., "deposit", "withdrawal", "trade") */
     transactionType: string;
     /** Token contract address */
-    tokenAddress: string;
+    tokenAddress: Address;
     /** Token symbol */
     symbol?: string;
     /** Token decimals */

package/dist/whitelist/index.d.ts

@@ -12,20 +12,20 @@ import type { BaseAPI } from "../api";
 /** Body for a whitelist application. */
 export interface SubmitWhitelistRequest {
     /** Applicant wallet address (0x-prefixed, 40 hex chars) */
-    wallet_address: string;
+    walletAddress: string;
     /** Applicant email address */
     email: string;
     /** Applicant Twitter/X username (1-15 chars) */
-    twitter_username?: string;
+    twitterUsername?: string;
     /** Applicant Telegram username (5-32 chars) */
-    telegram_username?: string;
+    telegramUsername?: string;
 }
 /** Response to a whitelist application. */
 export interface SubmitWhitelistResponse {
     /** Human-readable status message */
     message: string;
     /** Created user UUID (pending approval) */
-    user_id: string | null;
+    userId: string | null;
 }
 /**
  * Whitelist API interface. The submit endpoint is public (no auth required).

package/dist/wire/operations.d.ts

@@ -10,6 +10,6 @@
  * hand-written SDK surface. CI regenerates it and fails on a diff, identical to
  * the `schema.ts` wire-types tripwire (MON-1476), so it can never go stale.
  */
-export declare const OPERATION_IDS: readonly ["add_position_margin", "attach_position_tp_sl", "authenticate_backend", "batch_cancel_all", "batch_cancel_all_by_pair", "batch_cancel_orders", "batch_create_orders", "batch_replace_orders", "cancel_conditional_order", "cancel_order", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_candles", "get_funding_state", "get_index_price", "get_margin_account_movements", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_open_interest", "get_order_by_id", "get_orderbook_snapshot", "get_orders", "get_perp_market_config", "get_perp_market_summary", "get_portfolio_chart", "get_portfolio_stats", "get_position", "get_position_risk", "get_screener", "get_sub_account_limits", "get_trade_by_id", "get_trades", "get_trading_pair_by_id", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_funding_history", "list_funding_payments", "list_margin_accounts", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "mint_tokens", "reduce_position_margin", "refresh_session", "replace_order", "revoke_delegated_agent", "revoke_session", "simulate_auto_margin_order_risk", "simulate_fees", "simulate_order_risk", "submit_whitelist", "transfer_collateral_from_margin_account", "transfer_collateral_to_auto_margin_account", "transfer_collateral_to_margin_account", "update_sub_account_limit", "upsert_delegated_agent", "verify_signature"];
+export declare const OPERATION_IDS: readonly ["add_position_margin", "attach_position_tp_sl", "authenticate_backend", "batch_cancel_all", "batch_cancel_all_by_pair", "batch_cancel_orders", "batch_close_all_positions", "batch_create_orders", "batch_replace_orders", "cancel_conditional_order", "cancel_order", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_candles", "get_funding_state", "get_index_price", "get_margin_account_movements", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_open_interest", "get_order_by_id", "get_orderbook_snapshot", "get_orders", "get_parent_margin_account_movements", "get_parent_margin_account_summary", "get_perp_market_config", "get_perp_market_summary", "get_portfolio_chart", "get_portfolio_stats", "get_position", "get_position_risk", "get_screener", "get_sub_account_limits", "get_trade_by_id", "get_trades", "get_trading_pair_by_id", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_funding_history", "list_funding_payments", "list_margin_accounts", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "mint_tokens", "reduce_position_margin", "refresh_session", "replace_order", "revoke_delegated_agent", "revoke_session", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "submit_whitelist", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "update_sub_account_limit", "upsert_delegated_agent", "verify_signature"];
 /** Union of every OpenAPI operationId in the spec. */
 export type OperationId = (typeof OPERATION_IDS)[number];

package/dist/wire/operations.js

@@ -17,6 +17,7 @@ export const OPERATION_IDS = [
     "batch_cancel_all",
     "batch_cancel_all_by_pair",
     "batch_cancel_orders",
+    "batch_close_all_positions",
     "batch_create_orders",
     "batch_replace_orders",
     "cancel_conditional_order",
@@ -42,6 +43,8 @@ export const OPERATION_IDS = [
     "get_order_by_id",
     "get_orderbook_snapshot",
     "get_orders",
+    "get_parent_margin_account_movements",
+    "get_parent_margin_account_summary",
     "get_perp_market_config",
     "get_perp_market_summary",
     "get_portfolio_chart",
@@ -71,6 +74,7 @@ export const OPERATION_IDS = [
     "list_funding_history",
     "list_funding_payments",
     "list_margin_accounts",
+    "list_pending_withdrawals",
     "list_position_history",
     "list_positions",
     "list_sub_accounts_with_balances",
@@ -81,13 +85,16 @@ export const OPERATION_IDS = [
     "replace_order",
     "revoke_delegated_agent",
     "revoke_session",
-    "simulate_auto_margin_order_risk",
     "simulate_fees",
     "simulate_order_risk",
+    "simulate_parent_margin_order_risk",
+    "simulate_risk_bucket_order_risk",
     "submit_whitelist",
     "transfer_collateral_from_margin_account",
-    "transfer_collateral_to_auto_margin_account",
+    "transfer_collateral_from_parent_margin_account",
     "transfer_collateral_to_margin_account",
+    "transfer_collateral_to_parent_margin_account",
+    "transfer_collateral_to_risk_bucket",
     "update_sub_account_limit",
     "upsert_delegated_agent",
     "verify_signature",