@0xmonaco/core 1.0.2 → 1.0.7

package/dist/api/faucet/api.d.ts

@@ -17,9 +17,13 @@ export declare class FaucetAPIImpl extends BaseAPI implements FaucetAPI {
     /**
      * Mints the full set of testnet tokens to the authenticated user.
      *
-     * Partial success is possible — inspect `minted` and `failed` in the response.
+     * Synchronous: resolves only when every faucet transaction confirmed
+     * on-chain (HTTP 200). Rejects with 429 when the daily quota is exhausted,
+     * 502 when transactions failed or were only partially confirmed (the error
+     * details carry the minted/failed breakdown; delivered legs still consume
+     * the quota), and 503 when the faucet is unavailable (safe to retry).
      *
-     * @returns Promise resolving to the minted/failed tokens and remaining quota
+     * @returns Promise resolving to the minted tokens and remaining quota
      */
     mint(): Promise<MintTokensResponse>;
 }

package/dist/api/faucet/api.js

@@ -17,9 +17,13 @@ export class FaucetAPIImpl extends BaseAPI {
     /**
      * Mints the full set of testnet tokens to the authenticated user.
      *
-     * Partial success is possible — inspect `minted` and `failed` in the response.
+     * Synchronous: resolves only when every faucet transaction confirmed
+     * on-chain (HTTP 200). Rejects with 429 when the daily quota is exhausted,
+     * 502 when transactions failed or were only partially confirmed (the error
+     * details carry the minted/failed breakdown; delivered legs still consume
+     * the quota), and 503 when the faucet is unavailable (safe to retry).
      *
-     * @returns Promise resolving to the minted/failed tokens and remaining quota
+     * @returns Promise resolving to the minted tokens and remaining quota
      */
     async mint() {
         return await this.makeAuthenticatedRequest(perpRoutes.faucet.mint(), {

package/dist/api/perp/routes.d.ts

@@ -167,6 +167,7 @@ export declare const perpRoutes: {
             tradingPairId?: string;
             page?: number;
             pageSize?: number;
+            reductionOnly?: boolean;
         }) => string;
         readonly pnlHistory: (positionId: string, params: {
             interval: string;

package/dist/api/vault/api.d.ts

@@ -211,12 +211,16 @@ export declare class VaultAPIImpl extends BaseAPI implements VaultAPI {
      *
      * @param assetId - The asset identifier (UUID) to withdraw
      * @param amount - The raw token amount to withdraw (as bigint)
-     * @param autoWait - Whether to automatically wait for transaction confirmation (defaults to true)
+     * @param autoWait - When `true` (default) polls for the merkle-proof calldata
+     *   and submits the on-chain `executeWithdrawal` transaction, then waits for
+     *   confirmation. When `false`, returns `{ withdrawalIndex, status: "awaiting_proof" }`
+     *   immediately after the POST — skipping both the calldata poll and the
+     *   on-chain submission. Use `retryWithdrawal(withdrawalIndex)` to finish later.
      * @param sourceOrRetry - Source ledger (`"spot"` or `"margin"`) or legacy retry options
      * @param retry - Polling cadence/timeout while waiting for the proof when a source is supplied
      * @returns Promise resolving to a [`WithdrawResult`]: on success the submitted
-     *   transaction plus `withdrawalIndex`; on poll-timeout `{ withdrawalIndex,
-     *   status: "awaiting_proof" }`.
+     *   transaction plus `withdrawalIndex`; on poll-timeout or `autoWait=false`
+     *   returns `{ withdrawalIndex, status: "awaiting_proof" }`.
      * @throws {APIError} When the asset is not found or the initiate request is rejected
      * @throws {ContractError} When the on-chain submission fails
      * @throws {InvalidConfigError} When wallet account is not available

package/dist/api/vault/api.js

@@ -382,12 +382,16 @@ export class VaultAPIImpl extends BaseAPI {
      *
      * @param assetId - The asset identifier (UUID) to withdraw
      * @param amount - The raw token amount to withdraw (as bigint)
-     * @param autoWait - Whether to automatically wait for transaction confirmation (defaults to true)
+     * @param autoWait - When `true` (default) polls for the merkle-proof calldata
+     *   and submits the on-chain `executeWithdrawal` transaction, then waits for
+     *   confirmation. When `false`, returns `{ withdrawalIndex, status: "awaiting_proof" }`
+     *   immediately after the POST — skipping both the calldata poll and the
+     *   on-chain submission. Use `retryWithdrawal(withdrawalIndex)` to finish later.
      * @param sourceOrRetry - Source ledger (`"spot"` or `"margin"`) or legacy retry options
      * @param retry - Polling cadence/timeout while waiting for the proof when a source is supplied
      * @returns Promise resolving to a [`WithdrawResult`]: on success the submitted
-     *   transaction plus `withdrawalIndex`; on poll-timeout `{ withdrawalIndex,
-     *   status: "awaiting_proof" }`.
+     *   transaction plus `withdrawalIndex`; on poll-timeout or `autoWait=false`
+     *   returns `{ withdrawalIndex, status: "awaiting_proof" }`.
      * @throws {APIError} When the asset is not found or the initiate request is rejected
      * @throws {ContractError} When the on-chain submission fails
      * @throws {InvalidConfigError} When wallet account is not available
@@ -440,7 +444,14 @@ export class VaultAPIImpl extends BaseAPI {
                 source,
             }),
         });
-        // 2. Poll for the executeWithdrawal calldata until the proof is confirmed.
+        // 2. When autoWait=false the caller wants the index immediately so it can
+        // finish on-chain later via retryWithdrawal(index). Skip the calldata poll
+        // entirely — the proof never lands this early, and the 5-minute default
+        // would block the wallet prompt indefinitely (the MACH1 bug).
+        if (!autoWait) {
+            return { withdrawalIndex, status: "awaiting_proof" };
+        }
+        // 3. Poll for the executeWithdrawal calldata until the proof is confirmed.
         // The vault address comes back with it, keeping calldata + target contract
         // in lockstep.
         const poll = await this.pollWithdrawalCalldata(withdrawalIndex, retryOptions);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/core",
-	"version": "1.0.2",
+	"version": "1.0.7",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -23,8 +23,8 @@
 		"viem": "^2.45.2"
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.2",
-		"@0xmonaco/types": "1.0.2",
+		"@0xmonaco/contracts": "1.0.7",
+		"@0xmonaco/types": "1.0.7",
 		"@noble/curves": "^1.9.1",
 		"@noble/hashes": "^1.8.0",
 		"http-status-codes": "^2.3.0"