@mysten/docs 0.1.74 → 0.1.76

package/dist/sui/clients/executing.md

@@ -110,4 +110,10 @@ Two further options change how the node runs the simulation:
 | Option           | Effect                                                                                                                 |
 | ---------------- | ---------------------------------------------------------------------------------------------------------------------- |
 | `checksEnabled`  | Set `false` to skip transaction validation, so non-public and non-entry functions can be inspected. Defaults to `true` |
-| `doGasSelection` | Overrides whether the server selects gas payment during the simulation                                                 |
+| `doGasSelection` | gRPC and GraphQL only. Overrides whether the node selects real gas. Defaults to `true` only when gas payment is `[]`   |
+
+A transaction with no gas payment is simulated with a mocked gas coin, which also funds anything
+drawn from `tx.gas`, so the result validates the transaction and estimates gas but is not a preview
+of what the sender would spend. To simulate with the sender's real gas, set gas coins on the
+transaction, or on gRPC and GraphQL set an empty gas payment and let the node select gas. The
+result's `gasPaymentMocked` field reports which case ran.

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.76",
   "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/aws-kms-signer": "0.3.30",
     "@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.37",
+    "@mysten/dapp-kit-react": "2.1.39",
+    "@mysten/deepbook-v3": "2.6.8",
+    "@mysten/enoki-connect": "1.1.35",
+    "@mysten/kiosk": "1.4.19",
+    "@mysten/enoki": "1.2.31",
+    "@mysten/payment-kit": "0.2.33",
+    "@mysten/seal": "1.4.19",
+    "@mysten/gcp-kms-signer": "0.2.33",
+    "@mysten/signers": "1.1.33",
+    "@mysten/ledger-signer": "0.2.33",
+    "@mysten/sui": "2.35.0",
+    "@mysten/slush-wallet": "1.3.3",
+    "@mysten/suins": "2.0.15",
     "@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.33",
+    "@mysten/zksend": "1.2.36",
+    "@mysten/wallet-standard": "0.21.33",
+    "@mysten/walrus": "1.2.34"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.3.3",