@0xmonaco/types 1.0.3 → 1.0.14

package/dist/faucet/index.d.ts

@@ -29,6 +29,15 @@ export interface FailedMint {
     /** Error message describing why the mint failed */
     error: string;
 }
+/** Parameters for a faucet mint request. */
+export interface MintTokensParams {
+    /**
+     * Cloudflare Turnstile token proving the request came from a real client.
+     * Required when the gateway has captcha enforcement enabled; ignored
+     * otherwise.
+     */
+    turnstileToken?: string;
+}
 /** Result of a faucet mint request. */
 export interface MintTokensResponse {
     /** Tokens that were successfully minted */
@@ -45,10 +54,17 @@ export interface FaucetAPI extends BaseAPI {
     /**
      * Mints the full set of testnet tokens to the authenticated user.
      *
-     * Testnet-only and rate-limited; see the module note. Partial success is
-     * possible — inspect `minted` and `failed` in the response.
+     * Testnet-only and rate-limited; see the module note. The call is
+     * synchronous and resolves only when every faucet transaction confirmed
+     * on-chain (HTTP 200). Failures reject with meaningful status codes:
+     * 429 when the daily quota is exhausted, 502 when transactions failed or
+     * were only partially confirmed on-chain (the error details carry the
+     * minted/failed breakdown; delivered legs still consume the quota), and
+     * 503 when the faucet is unavailable (nothing credited, safe to retry).
      *
-     * @returns Promise resolving to the minted/failed tokens and remaining quota
+     * @param params - Optional parameters (Turnstile captcha token when the
+     *   gateway requires one)
+     * @returns Promise resolving to the minted tokens and remaining quota
      */
-    mint(): Promise<MintTokensResponse>;
+    mint(params?: MintTokensParams): Promise<MintTokensResponse>;
 }

package/dist/wire/schema.d.ts

@@ -671,7 +671,8 @@ export interface paths {
          * @description Mint all testnet tokens.
          *
          *      Mint all available testnet tokens to the authenticated user's address.
-         *      Rate limited per 24 hours.
+         *      Rate limited per 24 hours. The request is synchronous: it returns 200
+         *      only once every faucet transaction is confirmed on-chain.
          */
         post: operations["mint_tokens"];
         delete?: never;
@@ -4707,6 +4708,10 @@ export interface components {
             maxSlippageBps?: number | null;
             executionPriceRange?: components["schemas"]["ExecutionPriceRange"];
         };
+        MintTokensRequest: {
+            /** @description Cloudflare Turnstile token; required when faucet captcha enforcement is enabled */
+            turnstileToken?: string | null;
+        };
         MintTokensResponse: {
             minted?: components["schemas"]["MintedToken"][] | null;
             failed?: components["schemas"]["FailedMint"][] | null;
@@ -7509,7 +7514,11 @@ export interface operations {
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["MintTokensRequest"];
+            };
+        };
         responses: {
             /** @description OK */
             200: {
@@ -7548,6 +7557,20 @@ export interface operations {
                 };
                 content?: never;
             };
+            /** @description Faucet transactions failed or were only partially confirmed on-chain; the error details carry the minted/failed breakdown. Do not blindly retry: delivered legs consume the daily quota */
+            502: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Faucet unavailable (not configured, resolver down, or reply timed out); nothing is known to have been credited, safe to retry */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
         };
     };
     simulate_fees: {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/types",
-	"version": "1.0.3",
+	"version": "1.0.14",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -20,7 +20,7 @@
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.3",
+		"@0xmonaco/contracts": "1.0.14",
 		"zod": "^4.1.12"
 	},
 	"peerDependencies": {