@mysten/docs 0.1.74 → 0.1.75

package/dist/sui/index.md

@@ -50,8 +50,8 @@ The following table lists the locations for Sui networks.
 | Network | Full node                             | faucet                                   |
 | ------- | ------------------------------------- | ---------------------------------------- |
 | local   | `http://127.0.0.1:9000` (default)     | `http://127.0.0.1:9123/v2/gas` (default) |
-| Devnet  | `https://fullnode.devnet.sui.io:443`  | `https://faucet.devnet.sui.io/v2/gas`    |
-| Testnet | `https://fullnode.testnet.sui.io:443` | `https://faucet.testnet.sui.io/v2/gas`   |
+| Devnet  | `https://fullnode.devnet.sui.io:443`  | `https://faucet.devnet.sui.io/v3/gas`    |
+| Testnet | `https://fullnode.testnet.sui.io:443` | `https://faucet.testnet.sui.io/v3/gas`   |
 | Mainnet | `https://fullnode.mainnet.sui.io:443` | `null`                                   |
 
 > **Warning:** Use dedicated nodes/shared services rather than public endpoints for production apps. The public
@@ -92,7 +92,7 @@ console.log('Address:', keypair.toSuiAddress());
 console.log('Secret key:', keypair.getSecretKey());
 
 // Request SUI from the devnet faucet
-await requestSuiFromFaucetV2({
+await requestSuiFromFaucetV3({
 	host: getFaucetHost('devnet'),
 	recipient: keypair.toSuiAddress(),
 });
@@ -183,17 +183,57 @@ node transfer.ts
 
 ### Faucet
 
-Devnet, Testnet, and local networks include faucets that mint SUI. Use `requestSuiFromFaucetV2` to
-request SUI programmatically:
+Use `requestSuiFromFaucetV3` on Devnet and Testnet. It fetches a challenge from `/v3/challenge`,
+computes Argon2d proof-of-work, and submits the proof to `/v3/gas`:
 
 ```typescript
 
-await requestSuiFromFaucetV2({
+const result = await requestSuiFromFaucetV3({
 	host: getFaucetHost('testnet'),
-	recipient: '0xYourAddress',
+	recipient: '0xYourAddress', // Replace with your Sui address.
+	timeout: 180_000,
 });
+
+console.log(result.digest, result.amountMist);
 ```
 
+V3 credits the recipient's address balance, not a coin object. Its response contains `digest`,
+`recipient`, `amountMist`, and `difficulty`; it does not contain V2's `coins_sent`. Amounts are
+returned as decimal strings to preserve precision. The faucet sets the payout amount.
+
+Set `host` to the faucet's origin (scheme, hostname, and optional port), such as
+`https://faucet.testnet.sui.io`. The API must serve `/v3/challenge` and `/v3/gas` at the origin
+root. Path prefixes such as `/faucet` are not supported; any path in `host` is discarded.
+
+Optional `headers` apply to both requests. The `timeout` covers fetching, solving, and submission,
+and defaults to 180,000 milliseconds. Pass an `AbortSignal` as `signal` to cancel earlier.
+
+The helper uses Node's asynchronous native Argon2d when available (Node 24.7 or newer), with Noble
+as the fallback for Node 22 and browsers. Native hashing does not require an addon. Browser apps can
+run the helper in a Web Worker to keep proof-of-work off the UI thread.
+
+For a local **no-PoW faucet**, keep using V2:
+
+```typescript
+
+await requestSuiFromFaucetV2({
+	host: getFaucetHost('localnet'),
+	recipient: '0xYourAddress', // Replace with your Sui address.
+});
+```
+
+For a local **PoW faucet**, use `requestSuiFromFaucetV3` and set `host` to its origin, with
+`/v3/challenge` and `/v3/gas` served at the origin root. If it listens on the default local faucet
+port, use `getFaucetHost('localnet')`. The helper does not infer the protocol from the host or fall
+back to V2.
+
+V3 refreshes expired challenges before submission but never automatically retries a payout. HTTP 429
+throws `FaucetRateLimitError`. Other HTTP errors throw `FaucetError`, which exposes `status` and,
+when provided by the server, `code` and a transaction `digest`. Non-JSON error responses use a
+fallback message and preserve the parse error as `cause`. If a digest is present, resolve that
+transaction before requesting another payout. A timeout or connection loss during submission does
+not prove the payout failed; do not blindly retry it.
+
 > **Note:** Faucets on Devnet and Testnet are rate limited. If you hit the limit, wait before trying again.
 > For Testnet, you can also get SUI through the web UI at `faucet.sui.io` or through the [Sui
 > Discord](https://discord.gg/sui) faucet channels.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mysten/docs",
-  "version": "0.1.74",
+  "version": "0.1.75",
   "description": "LLM-friendly documentation for the Sui TypeScript SDK ecosystem",
   "license": "Apache-2.0",
   "repository": {
@@ -25,30 +25,30 @@
     "fumadocs-mdx": "15.2.3",
     "fumadocs-typescript": "^5.3.0",
     "fumadocs-ui": "16.14.4",
-    "next": "^16.3.4",
+    "next": "^16.3.6",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
-    "@mysten/aws-kms-signer": "0.3.28",
-    "@mysten/dapp-kit-core": "1.6.35",
-    "@mysten/deepbook-v3": "2.6.6",
-    "@mysten/enoki": "1.2.29",
-    "@mysten/dapp-kit-react": "2.1.37",
-    "@mysten/gcp-kms-signer": "0.2.31",
-    "@mysten/kiosk": "1.4.17",
     "@mysten/bcs": "2.1.2",
-    "@mysten/enoki-connect": "1.1.33",
-    "@mysten/ledger-signer": "0.2.31",
-    "@mysten/payment-kit": "0.2.31",
-    "@mysten/seal": "1.4.17",
-    "@mysten/signers": "1.1.31",
-    "@mysten/slush-wallet": "1.3.1",
-    "@mysten/sui": "2.33.2",
-    "@mysten/suins": "2.0.13",
+    "@mysten/dapp-kit-core": "1.6.36",
+    "@mysten/deepbook-v3": "2.6.7",
+    "@mysten/enoki": "1.2.30",
+    "@mysten/aws-kms-signer": "0.3.29",
+    "@mysten/dapp-kit-react": "2.1.38",
+    "@mysten/enoki-connect": "1.1.34",
+    "@mysten/gcp-kms-signer": "0.2.32",
+    "@mysten/kiosk": "1.4.18",
+    "@mysten/ledger-signer": "0.2.32",
+    "@mysten/payment-kit": "0.2.32",
+    "@mysten/signers": "1.1.32",
+    "@mysten/seal": "1.4.18",
+    "@mysten/slush-wallet": "1.3.2",
+    "@mysten/sui": "2.34.0",
+    "@mysten/suins": "2.0.14",
+    "@mysten/wallet-standard": "0.21.32",
     "@mysten/utils": "0.4.1",
-    "@mysten/wallet-standard": "0.21.31",
-    "@mysten/walrus": "1.2.32",
-    "@mysten/zksend": "1.2.34",
-    "@mysten/webcrypto-signer": "0.2.31"
+    "@mysten/webcrypto-signer": "0.2.32",
+    "@mysten/zksend": "1.2.35",
+    "@mysten/walrus": "1.2.33"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.3.3",