@mysten/sui 2.15.0 → 2.16.1

package/dist/utils/format.mjs

@@ -1,3 +1,5 @@
+import { SUI_DECIMALS } from "./constants.mjs";
+
 //#region src/utils/format.ts
 const ELLIPSIS = "…";
 function formatAddress(address) {
@@ -8,7 +10,23 @@ function formatAddress(address) {
 function formatDigest(digest) {
 	return `${digest.slice(0, 10)}${ELLIPSIS}`;
 }
+const AMOUNT_REGEX = /^-?(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+)$/;
+/** Parse a decimal string into its smallest-unit bigint representation. No floating point. */
+function parseToUnits(amount, decimals) {
+	if (decimals < 0 || !Number.isInteger(decimals)) throw new Error(`Invalid decimals: ${decimals}`);
+	if (!AMOUNT_REGEX.test(amount)) throw new Error(`Invalid amount: "${amount}"`);
+	const negative = amount.startsWith("-");
+	const [whole, fraction = ""] = (negative ? amount.slice(1) : amount).split(".");
+	if (fraction.length > decimals) throw new Error(`Too many decimal places: "${amount}" has ${fraction.length} but max is ${decimals}`);
+	const paddedFraction = fraction.padEnd(decimals, "0") || "0";
+	const result = BigInt(whole || "0") * 10n ** BigInt(decimals) + BigInt(paddedFraction);
+	return negative ? -result : result;
+}
+/** Parse a SUI decimal string into MIST. */
+function parseToMist(amount) {
+	return parseToUnits(amount, SUI_DECIMALS);
+}
 
 //#endregion
-export { formatAddress, formatDigest };
+export { formatAddress, formatDigest, parseToMist, parseToUnits };
 //# sourceMappingURL=format.mjs.map

package/dist/utils/format.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"format.mjs","names":[],"sources":["../../src/utils/format.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nconst ELLIPSIS = '\\u{2026}';\n\nexport function formatAddress(address: string) {\n\tif (address.length <= 6) {\n\t\treturn address;\n\t}\n\n\tconst offset = address.startsWith('0x') ? 2 : 0;\n\n\treturn `0x${address.slice(offset, offset + 4)}${ELLIPSIS}${address.slice(-4)}`;\n}\n\nexport function formatDigest(digest: string) {\n\t// Use 10 first characters\n\treturn `${digest.slice(0, 10)}${ELLIPSIS}`;\n}\n"],"mappings":";AAGA,MAAM,WAAW;AAEjB,SAAgB,cAAc,SAAiB;AAC9C,KAAI,QAAQ,UAAU,EACrB,QAAO;CAGR,MAAM,SAAS,QAAQ,WAAW,KAAK,GAAG,IAAI;AAE9C,QAAO,KAAK,QAAQ,MAAM,QAAQ,SAAS,EAAE,GAAG,WAAW,QAAQ,MAAM,GAAG;;AAG7E,SAAgB,aAAa,QAAgB;AAE5C,QAAO,GAAG,OAAO,MAAM,GAAG,GAAG,GAAG"}
+{"version":3,"file":"format.mjs","names":[],"sources":["../../src/utils/format.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { SUI_DECIMALS } from './constants.js';\n\nconst ELLIPSIS = '\\u{2026}';\n\nexport function formatAddress(address: string) {\n\tif (address.length <= 6) {\n\t\treturn address;\n\t}\n\n\tconst offset = address.startsWith('0x') ? 2 : 0;\n\n\treturn `0x${address.slice(offset, offset + 4)}${ELLIPSIS}${address.slice(-4)}`;\n}\n\nexport function formatDigest(digest: string) {\n\t// Use 10 first characters\n\treturn `${digest.slice(0, 10)}${ELLIPSIS}`;\n}\n\nconst AMOUNT_REGEX = /^-?(?:[0-9]+(?:\\.[0-9]+)?|\\.[0-9]+)$/;\n\n/** Parse a decimal string into its smallest-unit bigint representation. No floating point. */\nexport function parseToUnits(amount: string, decimals: number): bigint {\n\tif (decimals < 0 || !Number.isInteger(decimals)) {\n\t\tthrow new Error(`Invalid decimals: ${decimals}`);\n\t}\n\n\tif (!AMOUNT_REGEX.test(amount)) {\n\t\tthrow new Error(`Invalid amount: \"${amount}\"`);\n\t}\n\n\tconst negative = amount.startsWith('-');\n\tconst stripped = negative ? amount.slice(1) : amount;\n\n\tconst [whole, fraction = ''] = stripped.split('.');\n\n\tif (fraction.length > decimals) {\n\t\tthrow new Error(\n\t\t\t`Too many decimal places: \"${amount}\" has ${fraction.length} but max is ${decimals}`,\n\t\t);\n\t}\n\n\tconst paddedFraction = fraction.padEnd(decimals, '0') || '0';\n\tconst result = BigInt(whole || '0') * 10n ** BigInt(decimals) + BigInt(paddedFraction);\n\n\treturn negative ? -result : result;\n}\n\n/** Parse a SUI decimal string into MIST. */\nexport function parseToMist(amount: string): bigint {\n\treturn parseToUnits(amount, SUI_DECIMALS);\n}\n"],"mappings":";;;AAKA,MAAM,WAAW;AAEjB,SAAgB,cAAc,SAAiB;AAC9C,KAAI,QAAQ,UAAU,EACrB,QAAO;CAGR,MAAM,SAAS,QAAQ,WAAW,KAAK,GAAG,IAAI;AAE9C,QAAO,KAAK,QAAQ,MAAM,QAAQ,SAAS,EAAE,GAAG,WAAW,QAAQ,MAAM,GAAG;;AAG7E,SAAgB,aAAa,QAAgB;AAE5C,QAAO,GAAG,OAAO,MAAM,GAAG,GAAG,GAAG;;AAGjC,MAAM,eAAe;;AAGrB,SAAgB,aAAa,QAAgB,UAA0B;AACtE,KAAI,WAAW,KAAK,CAAC,OAAO,UAAU,SAAS,CAC9C,OAAM,IAAI,MAAM,qBAAqB,WAAW;AAGjD,KAAI,CAAC,aAAa,KAAK,OAAO,CAC7B,OAAM,IAAI,MAAM,oBAAoB,OAAO,GAAG;CAG/C,MAAM,WAAW,OAAO,WAAW,IAAI;CAGvC,MAAM,CAAC,OAAO,WAAW,OAFR,WAAW,OAAO,MAAM,EAAE,GAAG,QAEN,MAAM,IAAI;AAElD,KAAI,SAAS,SAAS,SACrB,OAAM,IAAI,MACT,6BAA6B,OAAO,QAAQ,SAAS,OAAO,cAAc,WAC1E;CAGF,MAAM,iBAAiB,SAAS,OAAO,UAAU,IAAI,IAAI;CACzD,MAAM,SAAS,OAAO,SAAS,IAAI,GAAG,OAAO,OAAO,SAAS,GAAG,OAAO,eAAe;AAEtF,QAAO,WAAW,CAAC,SAAS;;;AAI7B,SAAgB,YAAY,QAAwB;AACnD,QAAO,aAAa,QAAQ,aAAa"}

package/dist/utils/index.d.mts

@@ -1,10 +1,10 @@
 import { normalizeTypeTag } from "../bcs/type-tag-serializer.mjs";
 import { SUI_ADDRESS_LENGTH, isValidStructTag, isValidSuiAddress, isValidSuiObjectId, isValidTransactionDigest, normalizeStructTag, normalizeSuiAddress, normalizeSuiObjectId, parseStructTag } from "./sui-types.mjs";
-import { formatAddress, formatDigest } from "./format.mjs";
+import { formatAddress, formatDigest, parseToMist, parseToUnits } from "./format.mjs";
 import { isValidSuiNSName, normalizeSuiNSName } from "./suins.mjs";
 import { MIST_PER_SUI, MOVE_STDLIB_ADDRESS, SUI_CLOCK_OBJECT_ID, SUI_COIN_REGISTRY_OBJECT_ID, SUI_DECIMALS, SUI_DENY_LIST_OBJECT_ID, SUI_FRAMEWORK_ADDRESS, SUI_RANDOM_OBJECT_ID, SUI_SYSTEM_ADDRESS, SUI_SYSTEM_MODULE_NAME, SUI_SYSTEM_STATE_OBJECT_ID, SUI_TYPE_ARG } from "./constants.mjs";
 import { isValidNamedPackage, isValidNamedType } from "./move-registry.mjs";
 import { deriveDynamicFieldID } from "./dynamic-fields.mjs";
 import { deriveObjectID } from "./derived-objects.mjs";
 import { fromBase58, fromBase64, fromHex, toBase58, toBase64, toHex } from "@mysten/bcs";
-export { MIST_PER_SUI, MOVE_STDLIB_ADDRESS, SUI_ADDRESS_LENGTH, SUI_CLOCK_OBJECT_ID, SUI_COIN_REGISTRY_OBJECT_ID, SUI_DECIMALS, SUI_DENY_LIST_OBJECT_ID, SUI_FRAMEWORK_ADDRESS, SUI_RANDOM_OBJECT_ID, SUI_SYSTEM_ADDRESS, SUI_SYSTEM_MODULE_NAME, SUI_SYSTEM_STATE_OBJECT_ID, SUI_TYPE_ARG, deriveDynamicFieldID, deriveObjectID, formatAddress, formatDigest, fromBase58, fromBase64, fromHex, isValidNamedPackage, isValidNamedType, isValidStructTag, isValidSuiAddress, isValidSuiNSName, isValidSuiObjectId, isValidTransactionDigest, normalizeStructTag, normalizeSuiAddress, normalizeSuiNSName, normalizeSuiObjectId, normalizeTypeTag, parseStructTag, toBase58, toBase64, toHex };
+export { MIST_PER_SUI, MOVE_STDLIB_ADDRESS, SUI_ADDRESS_LENGTH, SUI_CLOCK_OBJECT_ID, SUI_COIN_REGISTRY_OBJECT_ID, SUI_DECIMALS, SUI_DENY_LIST_OBJECT_ID, SUI_FRAMEWORK_ADDRESS, SUI_RANDOM_OBJECT_ID, SUI_SYSTEM_ADDRESS, SUI_SYSTEM_MODULE_NAME, SUI_SYSTEM_STATE_OBJECT_ID, SUI_TYPE_ARG, deriveDynamicFieldID, deriveObjectID, formatAddress, formatDigest, fromBase58, fromBase64, fromHex, isValidNamedPackage, isValidNamedType, isValidStructTag, isValidSuiAddress, isValidSuiNSName, isValidSuiObjectId, isValidTransactionDigest, normalizeStructTag, normalizeSuiAddress, normalizeSuiNSName, normalizeSuiObjectId, normalizeTypeTag, parseStructTag, parseToMist, parseToUnits, toBase58, toBase64, toHex };

package/dist/utils/index.mjs

@@ -4,8 +4,8 @@ import { SUI_ADDRESS_LENGTH, isValidStructTag, isValidSuiAddress, isValidSuiObje
 import { normalizeTypeTag } from "../bcs/type-tag-serializer.mjs";
 import { deriveDynamicFieldID } from "./dynamic-fields.mjs";
 import { MIST_PER_SUI, MOVE_STDLIB_ADDRESS, SUI_CLOCK_OBJECT_ID, SUI_COIN_REGISTRY_OBJECT_ID, SUI_DECIMALS, SUI_DENY_LIST_OBJECT_ID, SUI_FRAMEWORK_ADDRESS, SUI_RANDOM_OBJECT_ID, SUI_SYSTEM_ADDRESS, SUI_SYSTEM_MODULE_NAME, SUI_SYSTEM_STATE_OBJECT_ID, SUI_TYPE_ARG } from "./constants.mjs";
-import { formatAddress, formatDigest } from "./format.mjs";
+import { formatAddress, formatDigest, parseToMist, parseToUnits } from "./format.mjs";
 import { deriveObjectID } from "./derived-objects.mjs";
 import { fromBase58, fromBase64, fromHex, toBase58, toBase64, toHex } from "@mysten/bcs";
 
-export { MIST_PER_SUI, MOVE_STDLIB_ADDRESS, SUI_ADDRESS_LENGTH, SUI_CLOCK_OBJECT_ID, SUI_COIN_REGISTRY_OBJECT_ID, SUI_DECIMALS, SUI_DENY_LIST_OBJECT_ID, SUI_FRAMEWORK_ADDRESS, SUI_RANDOM_OBJECT_ID, SUI_SYSTEM_ADDRESS, SUI_SYSTEM_MODULE_NAME, SUI_SYSTEM_STATE_OBJECT_ID, SUI_TYPE_ARG, deriveDynamicFieldID, deriveObjectID, formatAddress, formatDigest, fromBase58, fromBase64, fromHex, isValidNamedPackage, isValidNamedType, isValidStructTag, isValidSuiAddress, isValidSuiNSName, isValidSuiObjectId, isValidTransactionDigest, normalizeStructTag, normalizeSuiAddress, normalizeSuiNSName, normalizeSuiObjectId, normalizeTypeTag, parseStructTag, toBase58, toBase64, toHex };
+export { MIST_PER_SUI, MOVE_STDLIB_ADDRESS, SUI_ADDRESS_LENGTH, SUI_CLOCK_OBJECT_ID, SUI_COIN_REGISTRY_OBJECT_ID, SUI_DECIMALS, SUI_DENY_LIST_OBJECT_ID, SUI_FRAMEWORK_ADDRESS, SUI_RANDOM_OBJECT_ID, SUI_SYSTEM_ADDRESS, SUI_SYSTEM_MODULE_NAME, SUI_SYSTEM_STATE_OBJECT_ID, SUI_TYPE_ARG, deriveDynamicFieldID, deriveObjectID, formatAddress, formatDigest, fromBase58, fromBase64, fromHex, isValidNamedPackage, isValidNamedType, isValidStructTag, isValidSuiAddress, isValidSuiNSName, isValidSuiObjectId, isValidTransactionDigest, normalizeStructTag, normalizeSuiAddress, normalizeSuiNSName, normalizeSuiObjectId, normalizeTypeTag, parseStructTag, parseToMist, parseToUnits, toBase58, toBase64, toHex };

package/dist/version.mjs

@@ -1,7 +1,6 @@
 //#region src/version.ts
-const PACKAGE_VERSION = "2.15.0";
-const TARGETED_RPC_VERSION = "1.70.0";
+const PACKAGE_VERSION = "2.16.1";
 
 //#endregion
-export { PACKAGE_VERSION, TARGETED_RPC_VERSION };
+export { PACKAGE_VERSION };
 //# sourceMappingURL=version.mjs.map

package/dist/version.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"version.mjs","names":[],"sources":["../src/version.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\n// This file is generated by genversion.mjs. Do not edit it directly.\n\nexport const PACKAGE_VERSION = '2.15.0';\nexport const TARGETED_RPC_VERSION = '1.70.0';\n"],"mappings":";AAKA,MAAa,kBAAkB;AAC/B,MAAa,uBAAuB"}
+{"version":3,"file":"version.mjs","names":[],"sources":["../src/version.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\n// This file is generated by genversion.mjs. Do not edit it directly.\n\nexport const PACKAGE_VERSION = '2.16.1';\n"],"mappings":";AAKA,MAAa,kBAAkB"}

package/dist/zklogin/bcs.d.mts

@@ -1,31 +1,31 @@
-import * as _mysten_bcs810 from "@mysten/bcs";
+import * as _mysten_bcs1118 from "@mysten/bcs";
 import { InferBcsInput } from "@mysten/bcs";
 
 //#region src/zklogin/bcs.d.ts
-declare const zkLoginSignature: _mysten_bcs810.BcsStruct<{
-  inputs: _mysten_bcs810.BcsStruct<{
-    proofPoints: _mysten_bcs810.BcsStruct<{
-      a: _mysten_bcs810.BcsType<string[], Iterable<string> & {
+declare const zkLoginSignature: _mysten_bcs1118.BcsStruct<{
+  inputs: _mysten_bcs1118.BcsStruct<{
+    proofPoints: _mysten_bcs1118.BcsStruct<{
+      a: _mysten_bcs1118.BcsType<string[], Iterable<string> & {
         length: number;
       }, string>;
-      b: _mysten_bcs810.BcsType<string[][], Iterable<Iterable<string> & {
+      b: _mysten_bcs1118.BcsType<string[][], Iterable<Iterable<string> & {
         length: number;
       }> & {
         length: number;
       }, string>;
-      c: _mysten_bcs810.BcsType<string[], Iterable<string> & {
+      c: _mysten_bcs1118.BcsType<string[], Iterable<string> & {
         length: number;
       }, string>;
     }, string>;
-    issBase64Details: _mysten_bcs810.BcsStruct<{
-      value: _mysten_bcs810.BcsType<string, string, "string">;
-      indexMod4: _mysten_bcs810.BcsType<number, number, "u8">;
+    issBase64Details: _mysten_bcs1118.BcsStruct<{
+      value: _mysten_bcs1118.BcsType<string, string, "string">;
+      indexMod4: _mysten_bcs1118.BcsType<number, number, "u8">;
     }, string>;
-    headerBase64: _mysten_bcs810.BcsType<string, string, "string">;
-    addressSeed: _mysten_bcs810.BcsType<string, string, "string">;
+    headerBase64: _mysten_bcs1118.BcsType<string, string, "string">;
+    addressSeed: _mysten_bcs1118.BcsType<string, string, "string">;
   }, string>;
-  maxEpoch: _mysten_bcs810.BcsType<string, string | number | bigint, "u64">;
-  userSignature: _mysten_bcs810.BcsType<Uint8Array<ArrayBufferLike>, Iterable<number>, "vector<u8>">;
+  maxEpoch: _mysten_bcs1118.BcsType<string, string | number | bigint, "u64">;
+  userSignature: _mysten_bcs1118.BcsType<Uint8Array<ArrayBufferLike>, Iterable<number>, "vector<u8>">;
 }, string>;
 type ZkLoginSignature = InferBcsInput<typeof zkLoginSignature>;
 type ZkLoginSignatureInputs = ZkLoginSignature['inputs'];

package/dist/zklogin/bcs.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"bcs.d.mts","names":[],"sources":["../../src/zklogin/bcs.ts"],"mappings":";;;;cAMa,gBAAA,iBAAgB,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;KAkBjB,gBAAA,GAAmB,aAAA,QAAqB,gBAAA;AAAA,KACxC,sBAAA,GAAyB,gBAAA"}
+{"version":3,"file":"bcs.d.mts","names":[],"sources":["../../src/zklogin/bcs.ts"],"mappings":";;;;cAMa,gBAAA,kBAAgB,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;KAkBjB,gBAAA,GAAmB,aAAA,QAAqB,gBAAA;AAAA,KACxC,sBAAA,GAAyB,gBAAA"}

package/package.json

@@ -3,7 +3,7 @@
   "author": "Mysten Labs <build@mystenlabs.com>",
   "description": "Sui TypeScript API",
   "homepage": "https://sdk.mystenlabs.com",
-  "version": "2.15.0",
+  "version": "2.16.1",
   "license": "Apache-2.0",
   "sideEffects": false,
   "files": [
@@ -139,7 +139,6 @@
     "@graphql-codegen/typescript-document-nodes": "5.0.7",
     "@graphql-codegen/typescript-operations": "^5.0.7",
     "@grpc/grpc-js": "^1.13.3",
-    "@iarna/toml": "^2.2.5",
     "@parcel/watcher": "^2.5.4",
     "@protobuf-ts/grpc-transport": "^2.11.1",
     "@types/node": "^25.0.8",
@@ -169,8 +168,8 @@
     "graphql": "^16.12.0",
     "poseidon-lite": "0.2.1",
     "valibot": "^1.2.0",
-    "@mysten/bcs": "^2.0.3",
-    "@mysten/utils": "^0.3.1"
+    "@mysten/bcs": "^2.0.4",
+    "@mysten/utils": "^0.3.2"
   },
   "scripts": {
     "clean": "rm -rf tsconfig.tsbuildinfo ./dist",
@@ -183,7 +182,7 @@
     "codegen:grpc-header": "find src/grpc/proto -type f -exec sh -c 'echo \"// Copyright (c) Mysten Labs, Inc.\\n// SPDX-License-Identifier: Apache-2.0\\n\" | cat - {} > temp && mv temp {}' \\;",
     "codegen:grpc-extensions": "find src/grpc/proto -name '*.ts' | xargs sed -i '' -E 's/from \"(\\.[^\"]+)\"/from \"\\1.js\"/g'",
     "build": "rm -rf dist && node genversion.mjs && tsc --noEmit && tsdown",
-    "build:docs": "tsx ../docs/scripts/build-docs.ts",
+    "build:docs": "node ../docs/scripts/build-docs.ts",
     "vitest": "vitest",
     "test": "pnpm test:typecheck && pnpm test:unit",
     "test:typecheck": "tsc -p ./test",

package/src/client/mvr.ts

@@ -332,6 +332,10 @@ function validateOverrides(overrides?: {
 export function extractMvrTypes(type: string | StructTag, types = new Set<string>()) {
 	if (typeof type === 'string' && !hasMvrName(type)) return types;
 
+	if (typeof type === 'string' && type.startsWith('vector<') && type.endsWith('>')) {
+		return extractMvrTypes(type.slice(7, -1), types);
+	}
+
 	const tag = isStructTag(type) ? type : parseStructTag(type);
 
 	if (hasMvrName(tag.address)) types.add(`${tag.address}::${tag.module}::${tag.name}`);
@@ -348,6 +352,14 @@ export function extractMvrTypes(type: string | StructTag, types = new Set<string
  * based on the supplied type cache.
  */
 function replaceMvrNames(tag: string | StructTag, typeCache: Record<string, string>): string {
+	if (typeof tag === 'string' && !tag.includes('::')) {
+		return tag;
+	}
+
+	if (typeof tag === 'string' && tag.startsWith('vector<') && tag.endsWith('>')) {
+		return `vector<${replaceMvrNames(tag.slice(7, -1), typeCache)}>`;
+	}
+
 	const type = isStructTag(tag) ? tag : parseStructTag(tag);
 
 	const typeTag = `${type.address}::${type.module}::${type.name}`;

package/src/jsonRpc/http-transport.ts

@@ -1,7 +1,7 @@
 // Copyright (c) Mysten Labs, Inc.
 // SPDX-License-Identifier: Apache-2.0
 
-import { PACKAGE_VERSION, TARGETED_RPC_VERSION } from '../version.js';
+import { PACKAGE_VERSION } from '../version.js';
 import { JsonRpcError, SuiHTTPStatusError } from './errors.js';
 
 /**
@@ -58,7 +58,6 @@ export class JsonRpcHTTPTransport implements JsonRpcTransport {
 				'Content-Type': 'application/json',
 				'Client-Sdk-Type': 'typescript',
 				'Client-Sdk-Version': PACKAGE_VERSION,
-				'Client-Target-Api-Version': TARGETED_RPC_VERSION,
 				'Client-Request-Method': input.method,
 				...this.#options.rpc?.headers,
 			},

package/src/utils/format.ts

@@ -1,6 +1,8 @@
 // Copyright (c) Mysten Labs, Inc.
 // SPDX-License-Identifier: Apache-2.0
 
+import { SUI_DECIMALS } from './constants.js';
+
 const ELLIPSIS = '\u{2026}';
 
 export function formatAddress(address: string) {
@@ -17,3 +19,37 @@ export function formatDigest(digest: string) {
 	// Use 10 first characters
 	return `${digest.slice(0, 10)}${ELLIPSIS}`;
 }
+
+const AMOUNT_REGEX = /^-?(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+)$/;
+
+/** Parse a decimal string into its smallest-unit bigint representation. No floating point. */
+export function parseToUnits(amount: string, decimals: number): bigint {
+	if (decimals < 0 || !Number.isInteger(decimals)) {
+		throw new Error(`Invalid decimals: ${decimals}`);
+	}
+
+	if (!AMOUNT_REGEX.test(amount)) {
+		throw new Error(`Invalid amount: "${amount}"`);
+	}
+
+	const negative = amount.startsWith('-');
+	const stripped = negative ? amount.slice(1) : amount;
+
+	const [whole, fraction = ''] = stripped.split('.');
+
+	if (fraction.length > decimals) {
+		throw new Error(
+			`Too many decimal places: "${amount}" has ${fraction.length} but max is ${decimals}`,
+		);
+	}
+
+	const paddedFraction = fraction.padEnd(decimals, '0') || '0';
+	const result = BigInt(whole || '0') * 10n ** BigInt(decimals) + BigInt(paddedFraction);
+
+	return negative ? -result : result;
+}
+
+/** Parse a SUI decimal string into MIST. */
+export function parseToMist(amount: string): bigint {
+	return parseToUnits(amount, SUI_DECIMALS);
+}

package/src/utils/index.ts

@@ -1,7 +1,7 @@
 // Copyright (c) Mysten Labs, Inc.
 // SPDX-License-Identifier: Apache-2.0
 
-export { formatAddress, formatDigest } from './format.js';
+export { formatAddress, formatDigest, parseToUnits, parseToMist } from './format.js';
 export {
 	isValidStructTag,
 	isValidSuiAddress,

package/src/version.ts

@@ -3,5 +3,4 @@
 
 // This file is generated by genversion.mjs. Do not edit it directly.
 
-export const PACKAGE_VERSION = '2.15.0';
-export const TARGETED_RPC_VERSION = '1.70.0';
+export const PACKAGE_VERSION = '2.16.1';

package/docs/bcs.md

@@ -1,131 +0,0 @@
-# BCS
-
-> Binary Canonical Serialization for encoding Sui Move types
-
-The `@mysten/sui/bcs` package extends `@mysten/bcs` with Sui specific scheme definitions.
-
-To learn more about using BCS see the [BCS documentation](/bcs).
-
-the `bcs` export of `@mysten/sui/bcs` contains all the same exports as `bcs` from `@mysten/bcs` plus
-the following pre-defined schemes:
-
-- `U8`
-- `U16`
-- `U32`
-- `U64`
-- `U128`
-- `U256`
-- `ULEB128`
-- `Bool`
-- `String`
-- `Address`
-- `Argument`
-- `CallArg`
-- `CompressedSignature`
-- `GasData`
-- `MultiSig`
-- `MultiSigPkMap`
-- `MultiSigPublicKey`
-- `ObjectArg`
-- `ObjectDigest`
-- `ProgrammableMoveCall`
-- `ProgrammableTransaction`
-- `PublicKey`
-- `SenderSignedData`
-- `SharedObjectRef`
-- `StructTag`
-- `SuiObjectRef`
-- `Transaction`
-- `TransactionData`
-- `TransactionDataV1`
-- `TransactionExpiration`
-- `TransactionKind`
-- `TypeTag`
-- `Object` - Complete object with data, owner, previousTransaction, and storageRebate
-- `TransactionEffects` - Transaction execution effects (supports both V1 and V2)
-- `TransactionEffectsV1` - Legacy transaction effects format
-- `TransactionEffectsV2` - Current transaction effects format with detailed object changes
-
-All the upper-cased values are `BcsType` instances, and can be used directly to parse and serialize
-data.
-
-```typescript
-bcs.U8.serialize(1);
-bcs.Address.serialize('0x1');
-bcs.TypeTag.serialize({
-	vector: {
-		u8: true,
-	},
-});
-```
-
-## Working with Objects
-
-To parse on-chain objects, fetch them with `include: { content: true }` and pass `object.content` to
-a generated BCS type or a manual struct definition. The `content` field contains only the inner Move
-struct bytes:
-
-```typescript
-const { object } = await client.core.getObject({
-	objectId: '0x123...',
-	include: { content: true },
-});
-
-const parsed = MyStruct.parse(object.content);
-```
-
-### `bcs.Object` — Full object envelope
-
-The `bcs.Object` schema represents the complete on-chain object, including metadata (type, owner,
-version, previous transaction, storage rebate) wrapping the inner struct bytes. This is what the
-`objectBcs` include option returns. Most of this metadata is already available as fields on the
-object response, so you typically only need `content`.
-
-```typescript
-
-// Parse a full object envelope (from objectBcs include option)
-const envelope = bcs.Object.parse(object.objectBcs);
-console.log('Owner:', envelope.owner);
-console.log('Inner struct bytes:', envelope.data.Move.contents);
-
-// Serialize a full object envelope
-const serialized = bcs.Object.serialize({
-	data: {
-		Move: {
-			type: { GasCoin: null },
-			hasPublicTransfer: true,
-			version: '1',
-			contents: new Uint8Array([...]),
-		},
-	},
-	owner: { AddressOwner: '0x...' },
-	previousTransaction: '...',
-	storageRebate: '1000',
-});
-```
-
-> **Warning:** Do not pass `objectBcs` bytes to a Move struct parser — it contains wrapping metadata
-> that will cause parsing to fail. Use `content` for parsing Move struct fields. See the
-> [Core API docs](/sui/clients/core#objectbcs) for details.
-
-## Working with Transaction Effects
-
-The `bcs.TransactionEffects` schema can be used to parse transaction effects:
-
-```typescript
-// Parse transaction effects
-const effects = bcs.TransactionEffects.parse(effectsBytes);
-
-// Check execution status
-if (effects.V2.status.$kind === 'Success') {
-	console.log('Transaction succeeded');
-} else {
-	console.log('Transaction failed:', effects.V2.status.Failure.error);
-}
-
-// Access changed objects
-for (const [objectId, change] of effects.V2.changedObjects) {
-	console.log('Object:', objectId);
-	console.log('Output state:', change.outputState.$kind);
-}
-```