@mysten/sui 2.20.0 → 2.20.2

package/docs/llms-index.md

@@ -13,10 +13,15 @@
 - [Coins and Balances](./transactions/coins-and-balances.md): Work with coin objects and address balances in transactions
 - [Commands and Inputs Reference](./transactions/reference.md): Complete reference for transaction commands and input types
 - [Building Offline](./transactions/offline.md): Build transactions without a network connection
-- [Key pairs](./cryptography/keypairs.md): Create and manage Ed25519, Secp256k1, and Secp256r1 keypairs for Sui transaction signing.
-- [Multi-Signature Transactions](./cryptography/multisig.md): Create multi-signature transactions with multiple signers on Sui.
-- [Passkey](./cryptography/passkey.md): Use WebAuthn passkeys for Sui transaction signing.
-- [Web Crypto Signer](./cryptography/webcrypto-signer.md): Sign transactions using the Web Crypto API for secure browser-based key management.
+- [Cryptography](./cryptography.md): Sign and verify Sui transactions and messages with keypairs and external signers
+- [Key pairs](./cryptography/keypairs.md): Create Ed25519, Secp256k1, and Secp256r1 keypairs and derive them from mnemonics and secret keys
+- [Signers](./cryptography/signers.md): Signer implementations beyond keypairs — cloud KMS, Ledger, Web Crypto, passkeys, and multisig
+- [AWS KMS Signer](./cryptography/signers/aws-kms.md): Sign Sui transactions with a key stored in AWS Key Management Service
+- [GCP KMS Signer](./cryptography/signers/gcp-kms.md): Sign Sui transactions with a key stored in Google Cloud Key Management Service
+- [Ledger Signer](./cryptography/signers/ledger.md): Sign Sui transactions with a Ledger hardware wallet
+- [Web Crypto Signer](./cryptography/signers/webcrypto.md): Sign transactions using the Web Crypto API for secure browser-based key management
+- [Passkey](./cryptography/signers/passkey.md): Use WebAuthn passkeys for Sui transaction signing.
+- [Multi-Signature Transactions](./cryptography/signers/multisig.md): Create multi-signature transactions with multiple signers on Sui.
 - [The `@mysten/sui/utils` package](./utils.md): Utility functions for addresses, coins, and common operations in the Sui TypeScript SDK.
 - [Derived Objects](./utils/derived_objects.md): Compute derived object IDs from parent objects for deterministic offline derivation.
 - [BCS](./bcs.md): Binary Canonical Serialization for encoding Sui Move types.

package/docs/migrations/sui-2.0/index.md

@@ -155,4 +155,17 @@ For wallet builders and SDK maintainers building on the Sui ecosystem:
 - **[Wallet builders](/sui/migrations/sui-2.0/wallet-builders):** Guide for wallet implementations
   adapting to `reportTransactionEffects` removal and new core API response format
 - **[SDK maintainers](/sui/migrations/sui-2.0/sdk-maintainers):** Guide for SDK authors migrating to
-  `ClientWithCoreApi` and the new transport-agnostic architecture
+  `ClientWithCoreApi` and the new transport-agnostic architecture
+
+## Non-existent objects
+
+When migrating from the v1 SDK to the v2 SDK, review any code paths that read objects or dynamic
+fields that may not exist.
+
+In v1, methods such as `core.getObject` and `getDynamicField` return `null` when the requested
+object or field does not exist. In v2, the same operations throw an exception instead. Applications
+that previously relied on `null` checks should be updated to handle exceptions appropriately, either
+through try/catch blocks or by validating object existence before attempting to read it.
+
+This behavioral change may require updates to error handling logic to avoid unexpected runtime
+failures after migration.

package/docs/zklogin.md

@@ -46,8 +46,8 @@ const address = computeZkLoginAddress({
 });
 ```
 
-To use zkLogin inside a multisig, see the [Multisig Guide](../sui/cryptography/multisig) for more
-details.
+To use zkLogin inside a multisig, see the [Multisig Guide](../sui/cryptography/signers/multisig) for
+more details.
 
 ## Legacy addresses
 

package/package.json

@@ -3,7 +3,7 @@
   "author": "Mysten Labs <build@mystenlabs.com>",
   "description": "Sui TypeScript API",
   "homepage": "https://sdk.mystenlabs.com",
-  "version": "2.20.0",
+  "version": "2.20.2",
   "license": "Apache-2.0",
   "sideEffects": false,
   "files": [

package/src/graphql/core.ts

@@ -317,7 +317,11 @@ export class GraphQLCoreClient extends CoreClient {
 		const balances = await this.#graphqlQuery(
 			{
 				query: GetAllBalancesDocument,
-				variables: { owner: options.owner },
+				variables: {
+					owner: options.owner,
+					limit: options.limit,
+					cursor: options.cursor,
+				},
 			},
 			(result) => result.address?.balances,
 		);

package/src/grpc/core.ts

@@ -211,6 +211,7 @@ export class GrpcCoreClient extends CoreClient {
 			owner: options.owner,
 			objectType: `0x2::coin::Coin<${(await this.mvr.resolveType({ type: coinType })).type}>`,
 			pageToken: options.cursor ? fromBase64(options.cursor) : undefined,
+			pageSize: options.limit,
 			readMask: {
 				paths,
 			},

package/src/transactions/intents/CoinWithBalance.ts

@@ -2,7 +2,19 @@
 // SPDX-License-Identifier: Apache-2.0
 
 import type { InferInput } from 'valibot';
-import { bigint, object, optional, parse, picklist, string } from 'valibot';
+import {
+	bigint,
+	integer,
+	number,
+	object,
+	optional,
+	parse,
+	picklist,
+	pipe,
+	string,
+	transform,
+	union,
+} from 'valibot';
 
 import { bcs } from '../../bcs/index.js';
 import { normalizeStructTag } from '../../utils/sui-types.js';
@@ -87,9 +99,15 @@ export function createBalance({
 	};
 }
 
+// `balance` is a bigint in memory, but serializing a transaction to JSON converts it to a
+// string. When that JSON is deserialized with `Transaction.from`, the value stays a string
+// (the intent `data` is opaque to the transaction schema), so coerce it back to a bigint here.
 const CoinWithBalanceData = object({
 	type: string(),
-	balance: bigint(),
+	balance: pipe(
+		union([bigint(), string(), pipe(number(), integer())]),
+		transform((value) => BigInt(value)),
+	),
 	outputKind: optional(picklist(['coin', 'balance'])),
 });
 
@@ -208,10 +226,7 @@ export async function resolveCoinBalance(
 			continue;
 		}
 
-		const { type, balance } = transaction.$Intent.data as {
-			type: string;
-			balance: bigint;
-		};
+		const { type, balance } = parse(CoinWithBalanceData, transaction.$Intent.data);
 		const coinType = type === 'gas' ? SUI_TYPE : type;
 		const totalRequired = totalByType.get(type)!;
 		const addressBalance = addressBalanceByType.get(type) ?? 0n;

package/src/version.ts

@@ -3,4 +3,4 @@
 
 // This file is generated by genversion.mjs. Do not edit it directly.
 
-export const PACKAGE_VERSION = '2.20.0';
+export const PACKAGE_VERSION = '2.20.2';