@0xmonaco/types 1.0.3 → 1.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -45,10 +45,15 @@ export interface FaucetAPI extends BaseAPI {
45
45
  /**
46
46
  * Mints the full set of testnet tokens to the authenticated user.
47
47
  *
48
- * Testnet-only and rate-limited; see the module note. Partial success is
49
- * possible — inspect `minted` and `failed` in the response.
48
+ * Testnet-only and rate-limited; see the module note. The call is
49
+ * synchronous and resolves only when every faucet transaction confirmed
50
+ * on-chain (HTTP 200). Failures reject with meaningful status codes:
51
+ * 429 when the daily quota is exhausted, 502 when transactions failed or
52
+ * were only partially confirmed on-chain (the error details carry the
53
+ * minted/failed breakdown; delivered legs still consume the quota), and
54
+ * 503 when the faucet is unavailable (nothing credited, safe to retry).
50
55
  *
51
- * @returns Promise resolving to the minted/failed tokens and remaining quota
56
+ * @returns Promise resolving to the minted tokens and remaining quota
52
57
  */
53
58
  mint(): Promise<MintTokensResponse>;
54
59
  }
@@ -671,7 +671,8 @@ export interface paths {
671
671
  * @description Mint all testnet tokens.
672
672
  *
673
673
  * Mint all available testnet tokens to the authenticated user's address.
674
- * Rate limited per 24 hours.
674
+ * Rate limited per 24 hours. The request is synchronous: it returns 200
675
+ * only once every faucet transaction is confirmed on-chain.
675
676
  */
676
677
  post: operations["mint_tokens"];
677
678
  delete?: never;
@@ -7548,6 +7549,20 @@ export interface operations {
7548
7549
  };
7549
7550
  content?: never;
7550
7551
  };
7552
+ /** @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 */
7553
+ 502: {
7554
+ headers: {
7555
+ [name: string]: unknown;
7556
+ };
7557
+ content?: never;
7558
+ };
7559
+ /** @description Faucet unavailable (not configured, resolver down, or reply timed out); nothing is known to have been credited, safe to retry */
7560
+ 503: {
7561
+ headers: {
7562
+ [name: string]: unknown;
7563
+ };
7564
+ content?: never;
7565
+ };
7551
7566
  };
7552
7567
  };
7553
7568
  simulate_fees: {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@0xmonaco/types",
3
- "version": "1.0.3",
3
+ "version": "1.0.7",
4
4
  "type": "module",
5
5
  "repository": {
6
6
  "type": "git",
@@ -20,7 +20,7 @@
20
20
  "lint": "biome lint ."
21
21
  },
22
22
  "dependencies": {
23
- "@0xmonaco/contracts": "1.0.3",
23
+ "@0xmonaco/contracts": "1.0.7",
24
24
  "zod": "^4.1.12"
25
25
  },
26
26
  "peerDependencies": {