@mysten/docs 0.1.17 → 0.1.18

package/dist/llms-index.md

@@ -124,3 +124,4 @@
 
 - [zkSend SDK](./zksend.md): Send Sui assets via shareable links with zkSend
 - [Creating zkSend Links](./zksend/link-builder.md): Create and customize zkSend claim links
+- [Composable Claims](./zksend/composable-claim.md): Claim a zkSend link and use the assets in the same transaction

package/dist/sui/utils/index.md

@@ -31,6 +31,13 @@ You can use the following helpers to format various values:
 - `normalizeSuiNSName`
 - `normalizeSuiNSName`
 
+## Parsers
+
+You can use the following helpers to parse decimal strings into smallest-unit bigints:
+
+- `parseToUnits`: Parse a decimal string into a `bigint`, given a coin's `decimals`
+- `parseToMist`: Parse a SUI decimal string into MIST (9 decimals)
+
 ## Validators
 
 You can use the following helpers to validate the format of various values (this only validates that

package/dist/zksend/composable-claim.md

@@ -0,0 +1,70 @@
+# Composable Claims
+
+> Claim a zkSend link and use the assets in the same transaction
+
+By default, `link.claimAssets(address)` builds a claim transaction that transfers every asset to the
+recipient and submits it via a Mysten-hosted sponsor. If you want to _use_ a claimed object in the
+same transaction — for example, inserting a claimed NFT into another on-chain object, staking a
+claimed coin, or depositing into a vault — use `link.claimFlow()` to compose the claim into your own
+transaction.
+
+## How it works
+
+`link.claimFlow()` returns three transaction thunks:
+
+- **`init`** — adds the `init_claim` (or `reclaim`) move call that creates the claim proof.
+- **`assets`** — an array of claimable assets. Each `asset.argument` is a lazy
+  `TransactionObjectArgument` that emits the backing `claim<T>` move call the first time it's used.
+- **`finalize`** — consumes the claim proof. Must be added after every asset is claimed.
+
+```ts
+
+const tx = new Transaction();
+tx.setSender(claimLink.keypair!.toSuiAddress());
+
+const { init, assets, finalize } = claimLink.claimFlow();
+
+tx.add(init);
+
+for (const asset of assets) {
+	if (asset.type === `${PACKAGE_ID}::record::Record`) {
+		// Insert the claimed record directly into the recipient's player object
+		tx.moveCall({
+			target: `${PACKAGE_ID}::player::add_record`,
+			arguments: [tx.object(playerId), asset.argument],
+		});
+	} else {
+		tx.transferObjects([asset.argument], recipient);
+	}
+}
+
+tx.add(finalize);
+```
+
+Every asset in the returned list must be claimed somewhere in the transaction — assets that are
+never used won't create a `claim<T>` command and the transaction will fail. If you only want the
+default claim-and-transfer behavior, use `link.createClaimTransaction(address)` instead.
+
+## Sponsorship
+
+`link.claimAssets(address)` uses a sponsorship flow so the claimer does not need gas to claim the
+assets, but it only accepts the standard `init_claim` → `claim<T>` → transfer → `finalize` shape.
+Transactions built with `claimFlow()` may include extra move calls, so the default sponsor may
+reject them.
+
+Apps using `claimFlow()` are responsible for their own gas and sponsorship. The ephemeral link
+keypair is still the transaction sender (it authorizes the claim), so the typical pattern is dual
+signing: the link keypair signs as sender and your app's sponsor signs for gas.
+
+```ts
+tx.setGasOwner(sponsorAddress);
+const txBytes = await tx.build({ client });
+
+const linkSig = await claimLink.keypair!.signTransaction(txBytes);
+const sponsorSig = await sponsor.signTransaction(txBytes);
+
+const result = await client.core.executeTransaction({
+	transaction: txBytes,
+	signatures: [linkSig.signature, sponsorSig.signature],
+});
+```

package/dist/zksend/llms-index.md

@@ -3,3 +3,4 @@
 
 - [zkSend SDK](..md): Send Sui assets via shareable links with zkSend
 - [Creating zkSend Links](./link-builder.md): Create and customize zkSend claim links
+- [Composable Claims](./composable-claim.md): Claim a zkSend link and use the assets in the same transaction

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mysten/docs",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "description": "LLM-friendly documentation for the Sui TypeScript SDK ecosystem",
   "license": "Apache-2.0",
   "repository": {
@@ -30,20 +30,20 @@
     "@mysten/dapp-kit": "1.0.4",
     "@mysten/dapp-kit-core": "1.3.0",
     "@mysten/dapp-kit-react": "2.0.1",
-    "@mysten/deepbook-v3": "1.3.0",
+    "@mysten/deepbook-v3": "1.3.1",
     "@mysten/enoki": "1.0.4",
     "@mysten/enoki-connect": "1.0.2",
-    "@mysten/kiosk": "1.2.1",
-    "@mysten/payment-kit": "0.1.6",
+    "@mysten/kiosk": "1.2.2",
+    "@mysten/payment-kit": "0.1.7",
     "@mysten/seal": "1.1.1",
     "@mysten/signers": "1.0.2",
     "@mysten/slush-wallet": "1.0.3",
-    "@mysten/sui": "2.15.0",
-    "@mysten/suins": "1.0.4",
+    "@mysten/sui": "2.16.0",
+    "@mysten/suins": "1.0.5",
     "@mysten/utils": "0.3.1",
     "@mysten/wallet-standard": "0.20.1",
-    "@mysten/walrus": "1.1.1",
-    "@mysten/zksend": "1.0.3"
+    "@mysten/walrus": "1.1.2",
+    "@mysten/zksend": "1.1.0"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.1.18",