@mysten/sui 2.18.0 → 2.19.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @mysten/sui.js
 
+## 2.19.0
+
+### Minor Changes
+
+- 2be98ce: Add `isValidSignature`, `isValidPersonalMessageSignature`, and
+  `isValidTransactionSignature` to `@mysten/sui/verify` — boolean-returning siblings of the existing
+  `verify*` functions, taking the same arguments. They return `false` for a malformed or invalid
+  signature (or one that doesn't match a supplied `address`) instead of throwing, while still
+  letting a genuine environmental failure during verification (e.g. a zkLogin JWK/epoch lookup)
+  propagate. The `verify*` functions now delegate to these.
+
 ## 2.18.0
 
 ### Minor Changes

package/dist/bcs/bcs.d.mts

@@ -1,21 +1,21 @@
 import { TypeTag as TypeTag$1 } from "./types.mjs";
-import * as _mysten_bcs830 from "@mysten/bcs";
+import * as _mysten_bcs823 from "@mysten/bcs";
 import { BcsType } from "@mysten/bcs";
 
 //#region src/bcs/bcs.d.ts
 declare const TypeTag: BcsType<string, string | TypeTag$1, string>;
-declare function IntentMessage<T extends BcsType<any>>(T: T): _mysten_bcs830.BcsStruct<{
-  intent: _mysten_bcs830.BcsStruct<{
-    scope: _mysten_bcs830.BcsEnum<{
+declare function IntentMessage<T extends BcsType<any>>(T: T): _mysten_bcs823.BcsStruct<{
+  intent: _mysten_bcs823.BcsStruct<{
+    scope: _mysten_bcs823.BcsEnum<{
       TransactionData: null;
       TransactionEffects: null;
       CheckpointSummary: null;
       PersonalMessage: null;
     }, "IntentScope">;
-    version: _mysten_bcs830.BcsEnum<{
+    version: _mysten_bcs823.BcsEnum<{
       V0: null;
     }, "IntentVersion">;
-    appId: _mysten_bcs830.BcsEnum<{
+    appId: _mysten_bcs823.BcsEnum<{
       Sui: null;
     }, "AppId">;
   }, string>;

package/dist/bcs/index.d.mts

@@ -545,7 +545,7 @@ declare const suiBcs: {
           version: string;
           digest: string;
         };
-      }, "Receiving" | "ImmOrOwnedObject" | "SharedObject">;
+      }, "ImmOrOwnedObject" | "SharedObject" | "Receiving">;
       FundsWithdrawal: {
         reservation: {
           MaxAmountU64: string;
@@ -560,7 +560,7 @@ declare const suiBcs: {
           Sponsor: true;
         }, "Sender" | "Sponsor">;
       };
-    }, "Object" | "Pure" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
+    }, "Pure" | "Object" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
       Pure: {
         bytes: string | Uint8Array<ArrayBufferLike>;
       };
@@ -793,7 +793,7 @@ declare const suiBcs: {
           TransactionEffects: true;
           CheckpointSummary: true;
           PersonalMessage: true;
-        }, "TransactionEffects" | "TransactionData" | "CheckpointSummary" | "PersonalMessage">;
+        }, "TransactionData" | "TransactionEffects" | "CheckpointSummary" | "PersonalMessage">;
         version: {
           V0: true;
           $kind: "V0";
@@ -827,7 +827,7 @@ declare const suiBcs: {
                     version: string;
                     digest: string;
                   };
-                }, "Receiving" | "ImmOrOwnedObject" | "SharedObject">;
+                }, "ImmOrOwnedObject" | "SharedObject" | "Receiving">;
                 FundsWithdrawal: {
                   reservation: {
                     MaxAmountU64: string;
@@ -842,7 +842,7 @@ declare const suiBcs: {
                     Sponsor: true;
                   }, "Sender" | "Sponsor">;
                 };
-              }, "Object" | "Pure" | "FundsWithdrawal">[];
+              }, "Pure" | "Object" | "FundsWithdrawal">[];
               commands: _mysten_bcs0.EnumOutputShapeWithKeys<{
                 MoveCall: {
                   package: string;
@@ -950,7 +950,7 @@ declare const suiBcs: {
               chain: string;
               nonce: number;
             };
-          }, "Epoch" | "None" | "ValidDuring">;
+          }, "None" | "Epoch" | "ValidDuring">;
         };
         $kind: "V1";
       };
@@ -1193,7 +1193,7 @@ declare const suiBcs: {
                     version: string;
                     digest: string;
                   };
-                }, "Receiving" | "ImmOrOwnedObject" | "SharedObject">;
+                }, "ImmOrOwnedObject" | "SharedObject" | "Receiving">;
                 FundsWithdrawal: {
                   reservation: {
                     MaxAmountU64: string;
@@ -1208,7 +1208,7 @@ declare const suiBcs: {
                     Sponsor: true;
                   }, "Sender" | "Sponsor">;
                 };
-              }, "Object" | "Pure" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
+              }, "Pure" | "Object" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
                 Pure: {
                   bytes: string | Uint8Array<ArrayBufferLike>;
                 };
@@ -1508,7 +1508,7 @@ declare const suiBcs: {
                 version: string;
                 digest: string;
               };
-            }, "Receiving" | "ImmOrOwnedObject" | "SharedObject">;
+            }, "ImmOrOwnedObject" | "SharedObject" | "Receiving">;
             FundsWithdrawal: {
               reservation: {
                 MaxAmountU64: string;
@@ -1523,7 +1523,7 @@ declare const suiBcs: {
                 Sponsor: true;
               }, "Sender" | "Sponsor">;
             };
-          }, "Object" | "Pure" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
+          }, "Pure" | "Object" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
             Pure: {
               bytes: string | Uint8Array<ArrayBufferLike>;
             };
@@ -1799,7 +1799,7 @@ declare const suiBcs: {
               version: string;
               digest: string;
             };
-          }, "Receiving" | "ImmOrOwnedObject" | "SharedObject">;
+          }, "ImmOrOwnedObject" | "SharedObject" | "Receiving">;
           FundsWithdrawal: {
             reservation: {
               MaxAmountU64: string;
@@ -1814,7 +1814,7 @@ declare const suiBcs: {
               Sponsor: true;
             }, "Sender" | "Sponsor">;
           };
-        }, "Object" | "Pure" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
+        }, "Pure" | "Object" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
           Pure: {
             bytes: string | Uint8Array<ArrayBufferLike>;
           };
@@ -2271,7 +2271,7 @@ declare const suiBcs: {
           startVersion: string;
           owner: string;
         };
-      }, "AddressOwner" | "ConsensusAddressOwner" | "Immutable" | "ObjectOwner" | "Shared">][], Iterable<readonly [{
+      }, "AddressOwner" | "ObjectOwner" | "Shared" | "Immutable" | "ConsensusAddressOwner">][], Iterable<readonly [{
         objectId: string | Uint8Array<ArrayBufferLike>;
         version: string | number | bigint;
         digest: string;
@@ -2304,7 +2304,7 @@ declare const suiBcs: {
           startVersion: string;
           owner: string;
         };
-      }, "AddressOwner" | "ConsensusAddressOwner" | "Immutable" | "ObjectOwner" | "Shared">][], Iterable<readonly [{
+      }, "AddressOwner" | "ObjectOwner" | "Shared" | "Immutable" | "ConsensusAddressOwner">][], Iterable<readonly [{
         objectId: string | Uint8Array<ArrayBufferLike>;
         version: string | number | bigint;
         digest: string;
@@ -2337,7 +2337,7 @@ declare const suiBcs: {
           startVersion: string;
           owner: string;
         };
-      }, "AddressOwner" | "ConsensusAddressOwner" | "Immutable" | "ObjectOwner" | "Shared">][], Iterable<readonly [{
+      }, "AddressOwner" | "ObjectOwner" | "Shared" | "Immutable" | "ConsensusAddressOwner">][], Iterable<readonly [{
         objectId: string | Uint8Array<ArrayBufferLike>;
         version: string | number | bigint;
         digest: string;
@@ -2604,7 +2604,7 @@ declare const suiBcs: {
               startVersion: string;
               owner: string;
             };
-          }, "AddressOwner" | "ConsensusAddressOwner" | "Immutable" | "ObjectOwner" | "Shared">];
+          }, "AddressOwner" | "ObjectOwner" | "Shared" | "Immutable" | "ConsensusAddressOwner">];
         }, "NotExist" | "Exist">;
         outputState: _mysten_bcs0.EnumOutputShapeWithKeys<{
           NotExist: true;
@@ -2619,7 +2619,7 @@ declare const suiBcs: {
               startVersion: string;
               owner: string;
             };
-          }, "AddressOwner" | "ConsensusAddressOwner" | "Immutable" | "ObjectOwner" | "Shared">];
+          }, "AddressOwner" | "ObjectOwner" | "Shared" | "Immutable" | "ConsensusAddressOwner">];
           PackageWrite: [string, string];
           AccumulatorWriteV1: {
             address: {
@@ -2705,7 +2705,7 @@ declare const suiBcs: {
         ReadConsensusStreamEnded: string;
         Cancelled: string;
         PerEpochConfig: true;
-      }, "MutateConsensusStreamEnded" | "PerEpochConfig" | "ReadConsensusStreamEnded" | "ReadOnlyRoot" | "Cancelled">][], Iterable<readonly [string | Uint8Array<ArrayBufferLike>, _mysten_bcs0.EnumInputShape<{
+      }, "ReadOnlyRoot" | "MutateConsensusStreamEnded" | "ReadConsensusStreamEnded" | "Cancelled" | "PerEpochConfig">][], Iterable<readonly [string | Uint8Array<ArrayBufferLike>, _mysten_bcs0.EnumInputShape<{
         ReadOnlyRoot: readonly [string | number | bigint, string];
         MutateConsensusStreamEnded: string | number | bigint;
         ReadConsensusStreamEnded: string | number | bigint;
@@ -2751,7 +2751,7 @@ declare const suiBcs: {
             version: string;
             digest: string;
           };
-        }, "Receiving" | "ImmOrOwnedObject" | "SharedObject">;
+        }, "ImmOrOwnedObject" | "SharedObject" | "Receiving">;
         FundsWithdrawal: {
           reservation: {
             MaxAmountU64: string;
@@ -2766,7 +2766,7 @@ declare const suiBcs: {
             Sponsor: true;
           }, "Sender" | "Sponsor">;
         };
-      }, "Object" | "Pure" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
+      }, "Pure" | "Object" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
         Pure: {
           bytes: string | Uint8Array<ArrayBufferLike>;
         };

package/dist/cryptography/signature.d.mts

@@ -23,12 +23,6 @@ declare function toSerializedSignature({
  * Decodes a serialized signature into its constituent components: the signature scheme, the actual signature, and the public key
  */
 declare function parseSerializedSignature(serializedSignature: string): {
-  serializedSignature: string;
-  signatureScheme: "ED25519" | "Secp256k1" | "Secp256r1";
-  signature: Uint8Array<ArrayBuffer>;
-  publicKey: Uint8Array<ArrayBuffer>;
-  bytes: Uint8Array<ArrayBuffer>;
-} | {
   signatureScheme: "Passkey";
   serializedSignature: string;
   signature: Uint8Array<ArrayBufferLike>;
@@ -36,6 +30,12 @@ declare function parseSerializedSignature(serializedSignature: string): {
   clientDataJson: string;
   userSignature: Uint8Array<ArrayBuffer>;
   publicKey: Uint8Array<ArrayBuffer>;
+} | {
+  serializedSignature: string;
+  signatureScheme: "ED25519" | "Secp256k1" | "Secp256r1";
+  signature: Uint8Array<ArrayBuffer>;
+  publicKey: Uint8Array<ArrayBuffer>;
+  bytes: Uint8Array<ArrayBuffer>;
 } | {
   serializedSignature: string;
   signatureScheme: "ZkLogin";

package/dist/grpc/proto/sui/rpc/v2/ledger_service.client.d.mts

@@ -1,6 +1,6 @@
 import { BatchGetObjectsRequest, BatchGetObjectsResponse, BatchGetTransactionsRequest, BatchGetTransactionsResponse, GetCheckpointRequest, GetCheckpointResponse, GetEpochRequest, GetEpochResponse, GetObjectRequest, GetObjectResponse, GetServiceInfoRequest, GetServiceInfoResponse, GetTransactionRequest, GetTransactionResponse } from "./ledger_service.mjs";
-import * as _protobuf_ts_runtime5 from "@protobuf-ts/runtime";
-import * as _protobuf_ts_runtime_rpc5 from "@protobuf-ts/runtime-rpc";
+import * as _protobuf_ts_runtime1 from "@protobuf-ts/runtime";
+import * as _protobuf_ts_runtime_rpc1 from "@protobuf-ts/runtime-rpc";
 import { RpcOptions, RpcTransport, ServiceInfo, UnaryCall } from "@protobuf-ts/runtime-rpc";
 
 //#region src/grpc/proto/sui/rpc/v2/ledger_service.client.d.ts
@@ -45,9 +45,9 @@ interface ILedgerServiceClient {
 declare class LedgerServiceClient implements ILedgerServiceClient, ServiceInfo {
   private readonly _transport;
   typeName: string;
-  methods: _protobuf_ts_runtime_rpc5.MethodInfo<any, any>[];
+  methods: _protobuf_ts_runtime_rpc1.MethodInfo<any, any>[];
   options: {
-    [extensionName: string]: _protobuf_ts_runtime5.JsonValue;
+    [extensionName: string]: _protobuf_ts_runtime1.JsonValue;
   };
   constructor(_transport: RpcTransport);
   /**

package/dist/grpc/proto/sui/rpc/v2/move_package_service.client.d.mts

@@ -1,6 +1,6 @@
 import { GetDatatypeRequest, GetDatatypeResponse, GetFunctionRequest, GetFunctionResponse, GetPackageRequest, GetPackageResponse, ListPackageVersionsRequest, ListPackageVersionsResponse } from "./move_package_service.mjs";
-import * as _protobuf_ts_runtime6 from "@protobuf-ts/runtime";
-import * as _protobuf_ts_runtime_rpc6 from "@protobuf-ts/runtime-rpc";
+import * as _protobuf_ts_runtime2 from "@protobuf-ts/runtime";
+import * as _protobuf_ts_runtime_rpc2 from "@protobuf-ts/runtime-rpc";
 import { RpcOptions, RpcTransport, ServiceInfo, UnaryCall } from "@protobuf-ts/runtime-rpc";
 
 //#region src/grpc/proto/sui/rpc/v2/move_package_service.client.d.ts
@@ -31,9 +31,9 @@ interface IMovePackageServiceClient {
 declare class MovePackageServiceClient implements IMovePackageServiceClient, ServiceInfo {
   private readonly _transport;
   typeName: string;
-  methods: _protobuf_ts_runtime_rpc6.MethodInfo<any, any>[];
+  methods: _protobuf_ts_runtime_rpc2.MethodInfo<any, any>[];
   options: {
-    [extensionName: string]: _protobuf_ts_runtime6.JsonValue;
+    [extensionName: string]: _protobuf_ts_runtime2.JsonValue;
   };
   constructor(_transport: RpcTransport);
   /**

package/dist/grpc/proto/sui/rpc/v2/name_service.client.d.mts

@@ -1,6 +1,6 @@
 import { LookupNameRequest, LookupNameResponse, ReverseLookupNameRequest, ReverseLookupNameResponse } from "./name_service.mjs";
-import * as _protobuf_ts_runtime4 from "@protobuf-ts/runtime";
-import * as _protobuf_ts_runtime_rpc4 from "@protobuf-ts/runtime-rpc";
+import * as _protobuf_ts_runtime6 from "@protobuf-ts/runtime";
+import * as _protobuf_ts_runtime_rpc6 from "@protobuf-ts/runtime-rpc";
 import { RpcOptions, RpcTransport, ServiceInfo, UnaryCall } from "@protobuf-ts/runtime-rpc";
 
 //#region src/grpc/proto/sui/rpc/v2/name_service.client.d.ts
@@ -23,9 +23,9 @@ interface INameServiceClient {
 declare class NameServiceClient implements INameServiceClient, ServiceInfo {
   private readonly _transport;
   typeName: string;
-  methods: _protobuf_ts_runtime_rpc4.MethodInfo<any, any>[];
+  methods: _protobuf_ts_runtime_rpc6.MethodInfo<any, any>[];
   options: {
-    [extensionName: string]: _protobuf_ts_runtime4.JsonValue;
+    [extensionName: string]: _protobuf_ts_runtime6.JsonValue;
   };
   constructor(_transport: RpcTransport);
   /**

package/dist/grpc/proto/sui/rpc/v2/state_service.client.d.mts

@@ -1,6 +1,6 @@
 import { GetBalanceRequest, GetBalanceResponse, GetCoinInfoRequest, GetCoinInfoResponse, ListBalancesRequest, ListBalancesResponse, ListDynamicFieldsRequest, ListDynamicFieldsResponse, ListOwnedObjectsRequest, ListOwnedObjectsResponse } from "./state_service.mjs";
-import * as _protobuf_ts_runtime1 from "@protobuf-ts/runtime";
-import * as _protobuf_ts_runtime_rpc1 from "@protobuf-ts/runtime-rpc";
+import * as _protobuf_ts_runtime4 from "@protobuf-ts/runtime";
+import * as _protobuf_ts_runtime_rpc4 from "@protobuf-ts/runtime-rpc";
 import { RpcOptions, RpcTransport, ServiceInfo, UnaryCall } from "@protobuf-ts/runtime-rpc";
 
 //#region src/grpc/proto/sui/rpc/v2/state_service.client.d.ts
@@ -35,9 +35,9 @@ interface IStateServiceClient {
 declare class StateServiceClient implements IStateServiceClient, ServiceInfo {
   private readonly _transport;
   typeName: string;
-  methods: _protobuf_ts_runtime_rpc1.MethodInfo<any, any>[];
+  methods: _protobuf_ts_runtime_rpc4.MethodInfo<any, any>[];
   options: {
-    [extensionName: string]: _protobuf_ts_runtime1.JsonValue;
+    [extensionName: string]: _protobuf_ts_runtime4.JsonValue;
   };
   constructor(_transport: RpcTransport);
   /**

package/dist/grpc/proto/sui/rpc/v2/subscription_service.client.d.mts

@@ -1,6 +1,6 @@
 import { SubscribeCheckpointsRequest, SubscribeCheckpointsResponse } from "./subscription_service.mjs";
-import * as _protobuf_ts_runtime2 from "@protobuf-ts/runtime";
-import * as _protobuf_ts_runtime_rpc2 from "@protobuf-ts/runtime-rpc";
+import * as _protobuf_ts_runtime5 from "@protobuf-ts/runtime";
+import * as _protobuf_ts_runtime_rpc5 from "@protobuf-ts/runtime-rpc";
 import { RpcOptions, RpcTransport, ServerStreamingCall, ServiceInfo } from "@protobuf-ts/runtime-rpc";
 
 //#region src/grpc/proto/sui/rpc/v2/subscription_service.client.d.ts
@@ -31,9 +31,9 @@ interface ISubscriptionServiceClient {
 declare class SubscriptionServiceClient implements ISubscriptionServiceClient, ServiceInfo {
   private readonly _transport;
   typeName: string;
-  methods: _protobuf_ts_runtime_rpc2.MethodInfo<any, any>[];
+  methods: _protobuf_ts_runtime_rpc5.MethodInfo<any, any>[];
   options: {
-    [extensionName: string]: _protobuf_ts_runtime2.JsonValue;
+    [extensionName: string]: _protobuf_ts_runtime5.JsonValue;
   };
   constructor(_transport: RpcTransport);
   /**

package/dist/transactions/Transaction.d.mts

@@ -8,7 +8,7 @@ import { createPure } from "./pure.mjs";
 import { SignatureWithBytes, Signer } from "../cryptography/keypair.mjs";
 import "../cryptography/index.mjs";
 import { ClientWithCoreApi } from "../client/core.mjs";
-import * as _mysten_bcs823 from "@mysten/bcs";
+import * as _mysten_bcs1124 from "@mysten/bcs";
 import { SerializedBcs } from "@mysten/bcs";
 import { InferInput } from "valibot";
 
@@ -91,7 +91,7 @@ declare class Transaction {
   getData(): {
     version: 2;
     sender?: string | null | undefined;
-    expiration?: _mysten_bcs823.EnumOutputShapeWithKeys<{
+    expiration?: _mysten_bcs1124.EnumOutputShapeWithKeys<{
       None: true;
       Epoch: string | number;
       ValidDuring: {
@@ -102,7 +102,7 @@ declare class Transaction {
         chain: string;
         nonce: number;
       };
-    }, "Epoch" | "None" | "ValidDuring"> | null | undefined;
+    }, "None" | "Epoch" | "ValidDuring"> | null | undefined;
     gasData: {
       budget: string | number | null;
       price: string | number | null;
@@ -113,8 +113,8 @@ declare class Transaction {
         digest: string;
       }[] | null;
     };
-    inputs: _mysten_bcs823.EnumOutputShapeWithKeys<{
-      Object: _mysten_bcs823.EnumOutputShapeWithKeys<{
+    inputs: _mysten_bcs1124.EnumOutputShapeWithKeys<{
+      Object: _mysten_bcs1124.EnumOutputShapeWithKeys<{
         ImmOrOwnedObject: {
           objectId: string;
           version: string | number;
@@ -130,7 +130,7 @@ declare class Transaction {
           version: string | number;
           digest: string;
         };
-      }, "Receiving" | "ImmOrOwnedObject" | "SharedObject">;
+      }, "ImmOrOwnedObject" | "SharedObject" | "Receiving">;
       Pure: {
         bytes: string;
       };
@@ -153,13 +153,13 @@ declare class Transaction {
           Balance: string;
           $kind: "Balance";
         };
-        withdrawFrom: _mysten_bcs823.EnumOutputShapeWithKeys<{
+        withdrawFrom: _mysten_bcs1124.EnumOutputShapeWithKeys<{
           Sender: true;
           Sponsor: true;
         }, "Sender" | "Sponsor">;
       };
-    }, "Object" | "Pure" | "FundsWithdrawal" | "UnresolvedPure" | "UnresolvedObject">[];
-    commands: _mysten_bcs823.EnumOutputShapeWithKeys<{
+    }, "Pure" | "Object" | "FundsWithdrawal" | "UnresolvedPure" | "UnresolvedObject">[];
+    commands: _mysten_bcs1124.EnumOutputShapeWithKeys<{
       MoveCall: {
         package: string;
         module: string;

package/dist/transactions/Transaction.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"Transaction.d.mts","names":[],"sources":["../../src/transactions/Transaction.ts"],"mappings":"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"}
+{"version":3,"file":"Transaction.d.mts","names":[],"sources":["../../src/transactions/Transaction.ts"],"mappings":"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"}

package/dist/verify/index.d.mts

@@ -1,2 +1,2 @@
-import { publicKeyFromRawBytes, publicKeyFromSuiBytes, verifyPersonalMessageSignature, verifySignature, verifyTransactionSignature } from "./verify.mjs";
-export { publicKeyFromRawBytes, publicKeyFromSuiBytes, verifyPersonalMessageSignature, verifySignature, verifyTransactionSignature };
+import { isValidPersonalMessageSignature, isValidSignature, isValidTransactionSignature, publicKeyFromRawBytes, publicKeyFromSuiBytes, verifyPersonalMessageSignature, verifySignature, verifyTransactionSignature } from "./verify.mjs";
+export { isValidPersonalMessageSignature, isValidSignature, isValidTransactionSignature, publicKeyFromRawBytes, publicKeyFromSuiBytes, verifyPersonalMessageSignature, verifySignature, verifyTransactionSignature };

package/dist/verify/index.mjs

@@ -1,3 +1,3 @@
-import { publicKeyFromRawBytes, publicKeyFromSuiBytes, verifyPersonalMessageSignature, verifySignature, verifyTransactionSignature } from "./verify.mjs";
+import { isValidPersonalMessageSignature, isValidSignature, isValidTransactionSignature, publicKeyFromRawBytes, publicKeyFromSuiBytes, verifyPersonalMessageSignature, verifySignature, verifyTransactionSignature } from "./verify.mjs";
 
-export { publicKeyFromRawBytes, publicKeyFromSuiBytes, verifyPersonalMessageSignature, verifySignature, verifyTransactionSignature };
+export { isValidPersonalMessageSignature, isValidSignature, isValidTransactionSignature, publicKeyFromRawBytes, publicKeyFromSuiBytes, verifyPersonalMessageSignature, verifySignature, verifyTransactionSignature };

package/dist/verify/verify.d.mts

@@ -4,6 +4,26 @@ import "../cryptography/index.mjs";
 import { ClientWithCoreApi } from "../client/core.mjs";
 
 //#region src/verify/verify.d.ts
+/**
+ * Whether `signature` is a valid signature over `bytes` (and, if `options.address`
+ * is given, was produced by that address). Returns `false` for a malformed or
+ * cryptographically invalid signature, or one that doesn't match the address;
+ * only an *environmental* failure (e.g. a zkLogin JWK/epoch lookup) throws, so a
+ * network blip is never reported as an invalid signature.
+ */
+declare function isValidSignature(bytes: Uint8Array, signature: string, options?: {
+  address?: string;
+}): Promise<boolean>;
+/** Like {@link isValidSignature}, for a personal message. */
+declare function isValidPersonalMessageSignature(message: Uint8Array, signature: string, options?: {
+  client?: ClientWithCoreApi;
+  address?: string;
+}): Promise<boolean>;
+/** Like {@link isValidSignature}, for transaction bytes. */
+declare function isValidTransactionSignature(transaction: Uint8Array, signature: string, options?: {
+  client?: ClientWithCoreApi;
+  address?: string;
+}): Promise<boolean>;
 declare function verifySignature(bytes: Uint8Array, signature: string, options?: {
   address?: string;
 }): Promise<PublicKey>;
@@ -24,5 +44,5 @@ declare function publicKeyFromSuiBytes(publicKey: string | Uint8Array, options?:
   address?: string;
 }): PublicKey;
 //#endregion
-export { publicKeyFromRawBytes, publicKeyFromSuiBytes, verifyPersonalMessageSignature, verifySignature, verifyTransactionSignature };
+export { isValidPersonalMessageSignature, isValidSignature, isValidTransactionSignature, publicKeyFromRawBytes, publicKeyFromSuiBytes, verifyPersonalMessageSignature, verifySignature, verifyTransactionSignature };
 //# sourceMappingURL=verify.d.mts.map

package/dist/verify/verify.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"verify.d.mts","names":[],"sources":["../../src/verify/verify.ts"],"mappings":";;;;;;iBAesB,eAAA,CACrB,KAAA,EAAO,UAAA,EACP,SAAA,UACA,OAAA;EACC,OAAA;AAAA,IAEC,OAAA,CAAQ,SAAA;AAAA,iBAcW,8BAAA,CACrB,OAAA,EAAS,UAAA,EACT,SAAA,UACA,OAAA;EAAW,MAAA,GAAS,iBAAA;EAAmB,OAAA;AAAA,IACrC,OAAA,CAAQ,SAAA;AAAA,iBAmBW,0BAAA,CACrB,WAAA,EAAa,UAAA,EACb,SAAA,UACA,OAAA;EAAW,MAAA,GAAS,iBAAA;EAAmB,OAAA;AAAA,IACrC,OAAA,CAAQ,SAAA;AAAA,iBAwCK,qBAAA,CACf,eAAA,EAAiB,eAAA,EACjB,KAAA,EAAO,UAAA,EACP,OAAA;EAAW,MAAA,GAAS,iBAAA;EAAmB,OAAA;AAAA,IACrC,SAAA;AAAA,iBAgCa,qBAAA,CACf,SAAA,WAAoB,UAAA,EACpB,OAAA;EAAW,MAAA,GAAS,iBAAA;EAAmB,OAAA;AAAA,IAAuB,SAAA"}
+{"version":3,"file":"verify.d.mts","names":[],"sources":["../../src/verify/verify.ts"],"mappings":";;;;;;;;;;AAsBA;;;iBAAsB,gBAAA,CACrB,KAAA,EAAO,UAAA,EACP,SAAA,UACA,OAAA;EAAW,OAAA;AAAA,IACT,OAAA;;iBAQmB,+BAAA,CACrB,OAAA,EAAS,UAAA,EACT,SAAA,UACA,OAAA;EAAW,MAAA,GAAS,iBAAA;EAAmB,OAAA;AAAA,IACrC,OAAA;;iBAUmB,2BAAA,CACrB,WAAA,EAAa,UAAA,EACb,SAAA,UACA,OAAA;EAAW,MAAA,GAAS,iBAAA;EAAmB,OAAA;AAAA,IACrC,OAAA;AAAA,iBASmB,eAAA,CACrB,KAAA,EAAO,UAAA,EACP,SAAA,UACA,OAAA;EAAW,OAAA;AAAA,IACT,OAAA,CAAQ,SAAA;AAAA,iBAWW,8BAAA,CACrB,OAAA,EAAS,UAAA,EACT,SAAA,UACA,OAAA;EAAW,MAAA,GAAS,iBAAA;EAAmB,OAAA;AAAA,IACrC,OAAA,CAAQ,SAAA;AAAA,iBAWW,0BAAA,CACrB,WAAA,EAAa,UAAA,EACb,SAAA,UACA,OAAA;EAAW,MAAA,GAAS,iBAAA;EAAmB,OAAA;AAAA,IACrC,OAAA,CAAQ,SAAA;AAAA,iBAyCK,qBAAA,CACf,eAAA,EAAiB,eAAA,EACjB,KAAA,EAAO,UAAA,EACP,OAAA;EAAW,MAAA,GAAS,iBAAA;EAAmB,OAAA;AAAA,IACrC,SAAA;AAAA,iBAgCa,qBAAA,CACf,SAAA,WAAoB,UAAA,EACpB,OAAA;EAAW,MAAA,GAAS,iBAAA;EAAmB,OAAA;AAAA,IAAuB,SAAA"}

package/dist/verify/verify.mjs

@@ -9,23 +9,50 @@ import { MultiSigPublicKey } from "../multisig/publickey.mjs";
 import { fromBase64 } from "@mysten/bcs";
 
 //#region src/verify/verify.ts
-async function verifySignature(bytes, signature, options) {
-	const parsedSignature = parseSignature(signature);
-	if (!await parsedSignature.publicKey.verify(bytes, parsedSignature.serializedSignature)) throw new Error(`Signature is not valid for the provided data`);
-	if (options?.address && !parsedSignature.publicKey.verifyAddress(options.address)) throw new Error(`Signature is not valid for the provided address`);
-	return parsedSignature.publicKey;
+/**
+* Whether `signature` is a valid signature over `bytes` (and, if `options.address`
+* is given, was produced by that address). Returns `false` for a malformed or
+* cryptographically invalid signature, or one that doesn't match the address;
+* only an *environmental* failure (e.g. a zkLogin JWK/epoch lookup) throws, so a
+* network blip is never reported as an invalid signature.
+*/
+async function isValidSignature(bytes, signature, options = {}) {
+	const parsed = tryParseSignature(signature);
+	if (!parsed) return false;
+	if (!await parsed.publicKey.verify(bytes, parsed.serializedSignature)) return false;
+	return options.address ? parsed.publicKey.verifyAddress(options.address) : true;
+}
+/** Like {@link isValidSignature}, for a personal message. */
+async function isValidPersonalMessageSignature(message, signature, options = {}) {
+	const parsed = tryParseSignature(signature, { client: options.client });
+	if (!parsed) return false;
+	if (!await parsed.publicKey.verifyPersonalMessage(message, parsed.serializedSignature)) return false;
+	return options.address ? parsed.publicKey.verifyAddress(options.address) : true;
+}
+/** Like {@link isValidSignature}, for transaction bytes. */
+async function isValidTransactionSignature(transaction, signature, options = {}) {
+	const parsed = tryParseSignature(signature, { client: options.client });
+	if (!parsed) return false;
+	if (!await parsed.publicKey.verifyTransaction(transaction, parsed.serializedSignature)) return false;
+	return options.address ? parsed.publicKey.verifyAddress(options.address) : true;
+}
+async function verifySignature(bytes, signature, options = {}) {
+	const { publicKey } = parseSignature(signature);
+	if (!await isValidSignature(bytes, signature)) throw new Error(`Signature is not valid for the provided data`);
+	if (options.address && !publicKey.verifyAddress(options.address)) throw new Error(`Signature is not valid for the provided address`);
+	return publicKey;
 }
 async function verifyPersonalMessageSignature(message, signature, options = {}) {
-	const parsedSignature = parseSignature(signature, options);
-	if (!await parsedSignature.publicKey.verifyPersonalMessage(message, parsedSignature.serializedSignature)) throw new Error(`Signature is not valid for the provided message`);
-	if (options?.address && !parsedSignature.publicKey.verifyAddress(options.address)) throw new Error(`Signature is not valid for the provided address`);
-	return parsedSignature.publicKey;
+	const { publicKey } = parseSignature(signature, options);
+	if (!await isValidPersonalMessageSignature(message, signature, { client: options.client })) throw new Error(`Signature is not valid for the provided message`);
+	if (options.address && !publicKey.verifyAddress(options.address)) throw new Error(`Signature is not valid for the provided address`);
+	return publicKey;
 }
 async function verifyTransactionSignature(transaction, signature, options = {}) {
-	const parsedSignature = parseSignature(signature, options);
-	if (!await parsedSignature.publicKey.verifyTransaction(transaction, parsedSignature.serializedSignature)) throw new Error(`Signature is not valid for the provided Transaction`);
-	if (options?.address && !parsedSignature.publicKey.verifyAddress(options.address)) throw new Error(`Signature is not valid for the provided address`);
-	return parsedSignature.publicKey;
+	const { publicKey } = parseSignature(signature, options);
+	if (!await isValidTransactionSignature(transaction, signature, { client: options.client })) throw new Error(`Signature is not valid for the provided Transaction`);
+	if (options.address && !publicKey.verifyAddress(options.address)) throw new Error(`Signature is not valid for the provided address`);
+	return publicKey;
 }
 function parseSignature(signature, options = {}) {
 	const parsedSignature = parseSerializedSignature(signature);
@@ -39,6 +66,14 @@ function parseSignature(signature, options = {}) {
 		publicKey
 	};
 }
+/** {@link parseSignature}, returning `null` instead of throwing on a malformed signature. */
+function tryParseSignature(signature, options = {}) {
+	try {
+		return parseSignature(signature, options);
+	} catch {
+		return null;
+	}
+}
 function publicKeyFromRawBytes(signatureScheme, bytes, options = {}) {
 	let publicKey;
 	switch (signatureScheme) {
@@ -72,5 +107,5 @@ function publicKeyFromSuiBytes(publicKey, options = {}) {
 }
 
 //#endregion
-export { publicKeyFromRawBytes, publicKeyFromSuiBytes, verifyPersonalMessageSignature, verifySignature, verifyTransactionSignature };
+export { isValidPersonalMessageSignature, isValidSignature, isValidTransactionSignature, publicKeyFromRawBytes, publicKeyFromSuiBytes, verifyPersonalMessageSignature, verifySignature, verifyTransactionSignature };
 //# sourceMappingURL=verify.mjs.map

package/dist/verify/verify.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"verify.mjs","names":[],"sources":["../../src/verify/verify.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { fromBase64 } from '@mysten/bcs';\n\nimport type { PublicKey, SignatureFlag, SignatureScheme } from '../cryptography/index.js';\nimport { parseSerializedSignature, SIGNATURE_FLAG_TO_SCHEME } from '../cryptography/index.js';\nimport { Ed25519PublicKey } from '../keypairs/ed25519/publickey.js';\nimport { PasskeyPublicKey } from '../keypairs/passkey/publickey.js';\nimport { Secp256k1PublicKey } from '../keypairs/secp256k1/publickey.js';\nimport { Secp256r1PublicKey } from '../keypairs/secp256r1/publickey.js';\nimport { MultiSigPublicKey } from '../multisig/publickey.js';\nimport { ZkLoginPublicIdentifier } from '../zklogin/publickey.js';\nimport type { ClientWithCoreApi } from '../client/core.js';\n\nexport async function verifySignature(\n\tbytes: Uint8Array,\n\tsignature: string,\n\toptions?: {\n\t\taddress?: string;\n\t},\n): Promise<PublicKey> {\n\tconst parsedSignature = parseSignature(signature);\n\n\tif (!(await parsedSignature.publicKey.verify(bytes, parsedSignature.serializedSignature))) {\n\t\tthrow new Error(`Signature is not valid for the provided data`);\n\t}\n\n\tif (options?.address && !parsedSignature.publicKey.verifyAddress(options.address)) {\n\t\tthrow new Error(`Signature is not valid for the provided address`);\n\t}\n\n\treturn parsedSignature.publicKey;\n}\n\nexport async function verifyPersonalMessageSignature(\n\tmessage: Uint8Array,\n\tsignature: string,\n\toptions: { client?: ClientWithCoreApi; address?: string } = {},\n): Promise<PublicKey> {\n\tconst parsedSignature = parseSignature(signature, options);\n\n\tif (\n\t\t!(await parsedSignature.publicKey.verifyPersonalMessage(\n\t\t\tmessage,\n\t\t\tparsedSignature.serializedSignature,\n\t\t))\n\t) {\n\t\tthrow new Error(`Signature is not valid for the provided message`);\n\t}\n\n\tif (options?.address && !parsedSignature.publicKey.verifyAddress(options.address)) {\n\t\tthrow new Error(`Signature is not valid for the provided address`);\n\t}\n\n\treturn parsedSignature.publicKey;\n}\n\nexport async function verifyTransactionSignature(\n\ttransaction: Uint8Array,\n\tsignature: string,\n\toptions: { client?: ClientWithCoreApi; address?: string } = {},\n): Promise<PublicKey> {\n\tconst parsedSignature = parseSignature(signature, options);\n\n\tif (\n\t\t!(await parsedSignature.publicKey.verifyTransaction(\n\t\t\ttransaction,\n\t\t\tparsedSignature.serializedSignature,\n\t\t))\n\t) {\n\t\tthrow new Error(`Signature is not valid for the provided Transaction`);\n\t}\n\n\tif (options?.address && !parsedSignature.publicKey.verifyAddress(options.address)) {\n\t\tthrow new Error(`Signature is not valid for the provided address`);\n\t}\n\n\treturn parsedSignature.publicKey;\n}\n\nfunction parseSignature(signature: string, options: { client?: ClientWithCoreApi } = {}) {\n\tconst parsedSignature = parseSerializedSignature(signature);\n\n\tif (parsedSignature.signatureScheme === 'MultiSig') {\n\t\treturn {\n\t\t\t...parsedSignature,\n\t\t\tpublicKey: new MultiSigPublicKey(parsedSignature.multisig.multisig_pk),\n\t\t};\n\t}\n\n\tconst publicKey = publicKeyFromRawBytes(\n\t\tparsedSignature.signatureScheme,\n\t\tparsedSignature.publicKey,\n\t\toptions,\n\t);\n\treturn {\n\t\t...parsedSignature,\n\t\tpublicKey,\n\t};\n}\n\nexport function publicKeyFromRawBytes(\n\tsignatureScheme: SignatureScheme,\n\tbytes: Uint8Array,\n\toptions: { client?: ClientWithCoreApi; address?: string } = {},\n): PublicKey {\n\tlet publicKey: PublicKey;\n\tswitch (signatureScheme) {\n\t\tcase 'ED25519':\n\t\t\tpublicKey = new Ed25519PublicKey(bytes);\n\t\t\tbreak;\n\t\tcase 'Secp256k1':\n\t\t\tpublicKey = new Secp256k1PublicKey(bytes);\n\t\t\tbreak;\n\t\tcase 'Secp256r1':\n\t\t\tpublicKey = new Secp256r1PublicKey(bytes);\n\t\t\tbreak;\n\t\tcase 'MultiSig':\n\t\t\tpublicKey = new MultiSigPublicKey(bytes);\n\t\t\tbreak;\n\t\tcase 'ZkLogin':\n\t\t\tpublicKey = ZkLoginPublicIdentifier.fromBytes(bytes, options);\n\t\t\tbreak;\n\t\tcase 'Passkey':\n\t\t\tpublicKey = new PasskeyPublicKey(bytes);\n\t\t\tbreak;\n\t\tdefault:\n\t\t\tthrow new Error(`Unsupported signature scheme ${signatureScheme}`);\n\t}\n\n\tif (options.address && publicKey.toSuiAddress() !== options.address) {\n\t\tthrow new Error(`Public key bytes do not match the provided address`);\n\t}\n\n\treturn publicKey;\n}\n\nexport function publicKeyFromSuiBytes(\n\tpublicKey: string | Uint8Array,\n\toptions: { client?: ClientWithCoreApi; address?: string } = {},\n) {\n\tconst bytes = typeof publicKey === 'string' ? fromBase64(publicKey) : publicKey;\n\n\tconst signatureScheme = SIGNATURE_FLAG_TO_SCHEME[bytes[0] as SignatureFlag];\n\n\treturn publicKeyFromRawBytes(signatureScheme, bytes.slice(1), options);\n}\n"],"mappings":";;;;;;;;;;;AAeA,eAAsB,gBACrB,OACA,WACA,SAGqB;CACrB,MAAM,kBAAkB,eAAe,UAAU;AAEjD,KAAI,CAAE,MAAM,gBAAgB,UAAU,OAAO,OAAO,gBAAgB,oBAAoB,CACvF,OAAM,IAAI,MAAM,+CAA+C;AAGhE,KAAI,SAAS,WAAW,CAAC,gBAAgB,UAAU,cAAc,QAAQ,QAAQ,CAChF,OAAM,IAAI,MAAM,kDAAkD;AAGnE,QAAO,gBAAgB;;AAGxB,eAAsB,+BACrB,SACA,WACA,UAA4D,EAAE,EACzC;CACrB,MAAM,kBAAkB,eAAe,WAAW,QAAQ;AAE1D,KACC,CAAE,MAAM,gBAAgB,UAAU,sBACjC,SACA,gBAAgB,oBAChB,CAED,OAAM,IAAI,MAAM,kDAAkD;AAGnE,KAAI,SAAS,WAAW,CAAC,gBAAgB,UAAU,cAAc,QAAQ,QAAQ,CAChF,OAAM,IAAI,MAAM,kDAAkD;AAGnE,QAAO,gBAAgB;;AAGxB,eAAsB,2BACrB,aACA,WACA,UAA4D,EAAE,EACzC;CACrB,MAAM,kBAAkB,eAAe,WAAW,QAAQ;AAE1D,KACC,CAAE,MAAM,gBAAgB,UAAU,kBACjC,aACA,gBAAgB,oBAChB,CAED,OAAM,IAAI,MAAM,sDAAsD;AAGvE,KAAI,SAAS,WAAW,CAAC,gBAAgB,UAAU,cAAc,QAAQ,QAAQ,CAChF,OAAM,IAAI,MAAM,kDAAkD;AAGnE,QAAO,gBAAgB;;AAGxB,SAAS,eAAe,WAAmB,UAA0C,EAAE,EAAE;CACxF,MAAM,kBAAkB,yBAAyB,UAAU;AAE3D,KAAI,gBAAgB,oBAAoB,WACvC,QAAO;EACN,GAAG;EACH,WAAW,IAAI,kBAAkB,gBAAgB,SAAS,YAAY;EACtE;CAGF,MAAM,YAAY,sBACjB,gBAAgB,iBAChB,gBAAgB,WAChB,QACA;AACD,QAAO;EACN,GAAG;EACH;EACA;;AAGF,SAAgB,sBACf,iBACA,OACA,UAA4D,EAAE,EAClD;CACZ,IAAI;AACJ,SAAQ,iBAAR;EACC,KAAK;AACJ,eAAY,IAAI,iBAAiB,MAAM;AACvC;EACD,KAAK;AACJ,eAAY,IAAI,mBAAmB,MAAM;AACzC;EACD,KAAK;AACJ,eAAY,IAAI,mBAAmB,MAAM;AACzC;EACD,KAAK;AACJ,eAAY,IAAI,kBAAkB,MAAM;AACxC;EACD,KAAK;AACJ,eAAY,wBAAwB,UAAU,OAAO,QAAQ;AAC7D;EACD,KAAK;AACJ,eAAY,IAAI,iBAAiB,MAAM;AACvC;EACD,QACC,OAAM,IAAI,MAAM,gCAAgC,kBAAkB;;AAGpE,KAAI,QAAQ,WAAW,UAAU,cAAc,KAAK,QAAQ,QAC3D,OAAM,IAAI,MAAM,qDAAqD;AAGtE,QAAO;;AAGR,SAAgB,sBACf,WACA,UAA4D,EAAE,EAC7D;CACD,MAAM,QAAQ,OAAO,cAAc,WAAW,WAAW,UAAU,GAAG;CAEtE,MAAM,kBAAkB,yBAAyB,MAAM;AAEvD,QAAO,sBAAsB,iBAAiB,MAAM,MAAM,EAAE,EAAE,QAAQ"}
+{"version":3,"file":"verify.mjs","names":[],"sources":["../../src/verify/verify.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { fromBase64 } from '@mysten/bcs';\n\nimport type { PublicKey, SignatureFlag, SignatureScheme } from '../cryptography/index.js';\nimport { parseSerializedSignature, SIGNATURE_FLAG_TO_SCHEME } from '../cryptography/index.js';\nimport { Ed25519PublicKey } from '../keypairs/ed25519/publickey.js';\nimport { PasskeyPublicKey } from '../keypairs/passkey/publickey.js';\nimport { Secp256k1PublicKey } from '../keypairs/secp256k1/publickey.js';\nimport { Secp256r1PublicKey } from '../keypairs/secp256r1/publickey.js';\nimport { MultiSigPublicKey } from '../multisig/publickey.js';\nimport { ZkLoginPublicIdentifier } from '../zklogin/publickey.js';\nimport type { ClientWithCoreApi } from '../client/core.js';\n\n/**\n * Whether `signature` is a valid signature over `bytes` (and, if `options.address`\n * is given, was produced by that address). Returns `false` for a malformed or\n * cryptographically invalid signature, or one that doesn't match the address;\n * only an *environmental* failure (e.g. a zkLogin JWK/epoch lookup) throws, so a\n * network blip is never reported as an invalid signature.\n */\nexport async function isValidSignature(\n\tbytes: Uint8Array,\n\tsignature: string,\n\toptions: { address?: string } = {},\n): Promise<boolean> {\n\tconst parsed = tryParseSignature(signature);\n\tif (!parsed) return false;\n\tif (!(await parsed.publicKey.verify(bytes, parsed.serializedSignature))) return false;\n\treturn options.address ? parsed.publicKey.verifyAddress(options.address) : true;\n}\n\n/** Like {@link isValidSignature}, for a personal message. */\nexport async function isValidPersonalMessageSignature(\n\tmessage: Uint8Array,\n\tsignature: string,\n\toptions: { client?: ClientWithCoreApi; address?: string } = {},\n): Promise<boolean> {\n\tconst parsed = tryParseSignature(signature, { client: options.client });\n\tif (!parsed) return false;\n\tif (!(await parsed.publicKey.verifyPersonalMessage(message, parsed.serializedSignature))) {\n\t\treturn false;\n\t}\n\treturn options.address ? parsed.publicKey.verifyAddress(options.address) : true;\n}\n\n/** Like {@link isValidSignature}, for transaction bytes. */\nexport async function isValidTransactionSignature(\n\ttransaction: Uint8Array,\n\tsignature: string,\n\toptions: { client?: ClientWithCoreApi; address?: string } = {},\n): Promise<boolean> {\n\tconst parsed = tryParseSignature(signature, { client: options.client });\n\tif (!parsed) return false;\n\tif (!(await parsed.publicKey.verifyTransaction(transaction, parsed.serializedSignature))) {\n\t\treturn false;\n\t}\n\treturn options.address ? parsed.publicKey.verifyAddress(options.address) : true;\n}\n\nexport async function verifySignature(\n\tbytes: Uint8Array,\n\tsignature: string,\n\toptions: { address?: string } = {},\n): Promise<PublicKey> {\n\tconst { publicKey } = parseSignature(signature);\n\tif (!(await isValidSignature(bytes, signature))) {\n\t\tthrow new Error(`Signature is not valid for the provided data`);\n\t}\n\tif (options.address && !publicKey.verifyAddress(options.address)) {\n\t\tthrow new Error(`Signature is not valid for the provided address`);\n\t}\n\treturn publicKey;\n}\n\nexport async function verifyPersonalMessageSignature(\n\tmessage: Uint8Array,\n\tsignature: string,\n\toptions: { client?: ClientWithCoreApi; address?: string } = {},\n): Promise<PublicKey> {\n\tconst { publicKey } = parseSignature(signature, options);\n\tif (!(await isValidPersonalMessageSignature(message, signature, { client: options.client }))) {\n\t\tthrow new Error(`Signature is not valid for the provided message`);\n\t}\n\tif (options.address && !publicKey.verifyAddress(options.address)) {\n\t\tthrow new Error(`Signature is not valid for the provided address`);\n\t}\n\treturn publicKey;\n}\n\nexport async function verifyTransactionSignature(\n\ttransaction: Uint8Array,\n\tsignature: string,\n\toptions: { client?: ClientWithCoreApi; address?: string } = {},\n): Promise<PublicKey> {\n\tconst { publicKey } = parseSignature(signature, options);\n\tif (!(await isValidTransactionSignature(transaction, signature, { client: options.client }))) {\n\t\tthrow new Error(`Signature is not valid for the provided Transaction`);\n\t}\n\tif (options.address && !publicKey.verifyAddress(options.address)) {\n\t\tthrow new Error(`Signature is not valid for the provided address`);\n\t}\n\treturn publicKey;\n}\n\nfunction parseSignature(signature: string, options: { client?: ClientWithCoreApi } = {}) {\n\tconst parsedSignature = parseSerializedSignature(signature);\n\n\tif (parsedSignature.signatureScheme === 'MultiSig') {\n\t\treturn {\n\t\t\t...parsedSignature,\n\t\t\tpublicKey: new MultiSigPublicKey(parsedSignature.multisig.multisig_pk),\n\t\t};\n\t}\n\n\tconst publicKey = publicKeyFromRawBytes(\n\t\tparsedSignature.signatureScheme,\n\t\tparsedSignature.publicKey,\n\t\toptions,\n\t);\n\treturn {\n\t\t...parsedSignature,\n\t\tpublicKey,\n\t};\n}\n\n/** {@link parseSignature}, returning `null` instead of throwing on a malformed signature. */\nfunction tryParseSignature(signature: string, options: { client?: ClientWithCoreApi } = {}) {\n\ttry {\n\t\treturn parseSignature(signature, options);\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nexport function publicKeyFromRawBytes(\n\tsignatureScheme: SignatureScheme,\n\tbytes: Uint8Array,\n\toptions: { client?: ClientWithCoreApi; address?: string } = {},\n): PublicKey {\n\tlet publicKey: PublicKey;\n\tswitch (signatureScheme) {\n\t\tcase 'ED25519':\n\t\t\tpublicKey = new Ed25519PublicKey(bytes);\n\t\t\tbreak;\n\t\tcase 'Secp256k1':\n\t\t\tpublicKey = new Secp256k1PublicKey(bytes);\n\t\t\tbreak;\n\t\tcase 'Secp256r1':\n\t\t\tpublicKey = new Secp256r1PublicKey(bytes);\n\t\t\tbreak;\n\t\tcase 'MultiSig':\n\t\t\tpublicKey = new MultiSigPublicKey(bytes);\n\t\t\tbreak;\n\t\tcase 'ZkLogin':\n\t\t\tpublicKey = ZkLoginPublicIdentifier.fromBytes(bytes, options);\n\t\t\tbreak;\n\t\tcase 'Passkey':\n\t\t\tpublicKey = new PasskeyPublicKey(bytes);\n\t\t\tbreak;\n\t\tdefault:\n\t\t\tthrow new Error(`Unsupported signature scheme ${signatureScheme}`);\n\t}\n\n\tif (options.address && publicKey.toSuiAddress() !== options.address) {\n\t\tthrow new Error(`Public key bytes do not match the provided address`);\n\t}\n\n\treturn publicKey;\n}\n\nexport function publicKeyFromSuiBytes(\n\tpublicKey: string | Uint8Array,\n\toptions: { client?: ClientWithCoreApi; address?: string } = {},\n) {\n\tconst bytes = typeof publicKey === 'string' ? fromBase64(publicKey) : publicKey;\n\n\tconst signatureScheme = SIGNATURE_FLAG_TO_SCHEME[bytes[0] as SignatureFlag];\n\n\treturn publicKeyFromRawBytes(signatureScheme, bytes.slice(1), options);\n}\n"],"mappings":"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"}

package/dist/version.mjs

@@ -1,5 +1,5 @@
 //#region src/version.ts
-const PACKAGE_VERSION = "2.18.0";
+const PACKAGE_VERSION = "2.19.0";
 
 //#endregion
 export { PACKAGE_VERSION };

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.18.0';\n"],"mappings":";AAKA,MAAa,kBAAkB"}
+{"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.19.0';\n"],"mappings":";AAKA,MAAa,kBAAkB"}

package/docs/migrations/sui-2.0/dapp-kit.md

@@ -185,7 +185,11 @@ The built-in mutation hooks have been removed. Use TanStack Query's `useMutation
 
 In the old dApp kit, you could optionally pass a `chain` parameter (for example, `sui:mainnet`) to
 methods like `signTransaction` and `signAndExecuteTransaction`. In the new dApp kit, use the
-`network` parameter instead - the chain is automatically derived from the network.
+`network` parameter instead - the chain is automatically derived from the network. It is optional
+and defaults to the active network, so you only need it when targeting a network other than the
+active one (for example, an app that operates on both mainnet and testnet). Likewise, the
+per-account `account` override is preserved as an optional parameter that defaults to the connected
+account.
 
 ```diff
 - const { mutateAsync: signAndExecute } = useSignAndExecuteTransaction();

package/package.json

@@ -3,7 +3,7 @@
   "author": "Mysten Labs <build@mystenlabs.com>",
   "description": "Sui TypeScript API",
   "homepage": "https://sdk.mystenlabs.com",
-  "version": "2.18.0",
+  "version": "2.19.0",
   "license": "Apache-2.0",
   "sideEffects": false,
   "files": [
@@ -168,8 +168,8 @@
     "graphql": "^16.14.2",
     "poseidon-lite": "0.2.1",
     "valibot": "^1.4.1",
-    "@mysten/utils": "^0.4.0",
-    "@mysten/bcs": "^2.1.0"
+    "@mysten/bcs": "^2.1.0",
+    "@mysten/utils": "^0.4.0"
   },
   "scripts": {
     "clean": "rm -rf tsconfig.tsbuildinfo ./dist",

package/src/verify/index.ts

@@ -5,6 +5,9 @@ export {
 	verifySignature,
 	verifyPersonalMessageSignature,
 	verifyTransactionSignature,
+	isValidSignature,
+	isValidPersonalMessageSignature,
+	isValidTransactionSignature,
 	publicKeyFromRawBytes,
 	publicKeyFromSuiBytes,
 } from './verify.js';

package/src/verify/verify.ts

@@ -13,24 +13,65 @@ import { MultiSigPublicKey } from '../multisig/publickey.js';
 import { ZkLoginPublicIdentifier } from '../zklogin/publickey.js';
 import type { ClientWithCoreApi } from '../client/core.js';
 
+/**
+ * Whether `signature` is a valid signature over `bytes` (and, if `options.address`
+ * is given, was produced by that address). Returns `false` for a malformed or
+ * cryptographically invalid signature, or one that doesn't match the address;
+ * only an *environmental* failure (e.g. a zkLogin JWK/epoch lookup) throws, so a
+ * network blip is never reported as an invalid signature.
+ */
+export async function isValidSignature(
+	bytes: Uint8Array,
+	signature: string,
+	options: { address?: string } = {},
+): Promise<boolean> {
+	const parsed = tryParseSignature(signature);
+	if (!parsed) return false;
+	if (!(await parsed.publicKey.verify(bytes, parsed.serializedSignature))) return false;
+	return options.address ? parsed.publicKey.verifyAddress(options.address) : true;
+}
+
+/** Like {@link isValidSignature}, for a personal message. */
+export async function isValidPersonalMessageSignature(
+	message: Uint8Array,
+	signature: string,
+	options: { client?: ClientWithCoreApi; address?: string } = {},
+): Promise<boolean> {
+	const parsed = tryParseSignature(signature, { client: options.client });
+	if (!parsed) return false;
+	if (!(await parsed.publicKey.verifyPersonalMessage(message, parsed.serializedSignature))) {
+		return false;
+	}
+	return options.address ? parsed.publicKey.verifyAddress(options.address) : true;
+}
+
+/** Like {@link isValidSignature}, for transaction bytes. */
+export async function isValidTransactionSignature(
+	transaction: Uint8Array,
+	signature: string,
+	options: { client?: ClientWithCoreApi; address?: string } = {},
+): Promise<boolean> {
+	const parsed = tryParseSignature(signature, { client: options.client });
+	if (!parsed) return false;
+	if (!(await parsed.publicKey.verifyTransaction(transaction, parsed.serializedSignature))) {
+		return false;
+	}
+	return options.address ? parsed.publicKey.verifyAddress(options.address) : true;
+}
+
 export async function verifySignature(
 	bytes: Uint8Array,
 	signature: string,
-	options?: {
-		address?: string;
-	},
+	options: { address?: string } = {},
 ): Promise<PublicKey> {
-	const parsedSignature = parseSignature(signature);
-
-	if (!(await parsedSignature.publicKey.verify(bytes, parsedSignature.serializedSignature))) {
+	const { publicKey } = parseSignature(signature);
+	if (!(await isValidSignature(bytes, signature))) {
 		throw new Error(`Signature is not valid for the provided data`);
 	}
-
-	if (options?.address && !parsedSignature.publicKey.verifyAddress(options.address)) {
+	if (options.address && !publicKey.verifyAddress(options.address)) {
 		throw new Error(`Signature is not valid for the provided address`);
 	}
-
-	return parsedSignature.publicKey;
+	return publicKey;
 }
 
 export async function verifyPersonalMessageSignature(
@@ -38,22 +79,14 @@ export async function verifyPersonalMessageSignature(
 	signature: string,
 	options: { client?: ClientWithCoreApi; address?: string } = {},
 ): Promise<PublicKey> {
-	const parsedSignature = parseSignature(signature, options);
-
-	if (
-		!(await parsedSignature.publicKey.verifyPersonalMessage(
-			message,
-			parsedSignature.serializedSignature,
-		))
-	) {
+	const { publicKey } = parseSignature(signature, options);
+	if (!(await isValidPersonalMessageSignature(message, signature, { client: options.client }))) {
 		throw new Error(`Signature is not valid for the provided message`);
 	}
-
-	if (options?.address && !parsedSignature.publicKey.verifyAddress(options.address)) {
+	if (options.address && !publicKey.verifyAddress(options.address)) {
 		throw new Error(`Signature is not valid for the provided address`);
 	}
-
-	return parsedSignature.publicKey;
+	return publicKey;
 }
 
 export async function verifyTransactionSignature(
@@ -61,22 +94,14 @@ export async function verifyTransactionSignature(
 	signature: string,
 	options: { client?: ClientWithCoreApi; address?: string } = {},
 ): Promise<PublicKey> {
-	const parsedSignature = parseSignature(signature, options);
-
-	if (
-		!(await parsedSignature.publicKey.verifyTransaction(
-			transaction,
-			parsedSignature.serializedSignature,
-		))
-	) {
+	const { publicKey } = parseSignature(signature, options);
+	if (!(await isValidTransactionSignature(transaction, signature, { client: options.client }))) {
 		throw new Error(`Signature is not valid for the provided Transaction`);
 	}
-
-	if (options?.address && !parsedSignature.publicKey.verifyAddress(options.address)) {
+	if (options.address && !publicKey.verifyAddress(options.address)) {
 		throw new Error(`Signature is not valid for the provided address`);
 	}
-
-	return parsedSignature.publicKey;
+	return publicKey;
 }
 
 function parseSignature(signature: string, options: { client?: ClientWithCoreApi } = {}) {
@@ -100,6 +125,15 @@ function parseSignature(signature: string, options: { client?: ClientWithCoreApi
 	};
 }
 
+/** {@link parseSignature}, returning `null` instead of throwing on a malformed signature. */
+function tryParseSignature(signature: string, options: { client?: ClientWithCoreApi } = {}) {
+	try {
+		return parseSignature(signature, options);
+	} catch {
+		return null;
+	}
+}
+
 export function publicKeyFromRawBytes(
 	signatureScheme: SignatureScheme,
 	bytes: Uint8Array,

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.18.0';
+export const PACKAGE_VERSION = '2.19.0';