@mysten/sui 2.25.0 → 2.26.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @mysten/sui.js
 
+## 2.26.0
+
+### Minor Changes
+
+- 87989d5: Add transport-neutral `ObjectError` and `TransactionError` lookup details across the Core
+  API clients. The existing transport-specific `ObjectError.code` field and `(code, message)`
+  constructor remain supported; the transport-neutral `reason`, resource identity, and `cause`
+  fields are additive.
+
 ## 2.25.0
 
 ### Minor Changes

package/dist/bcs/bcs.d.mts

@@ -1,21 +1,21 @@
 import { TypeTag as TypeTag$1 } from "./types.mjs";
-import * as _mysten_bcs1219 from "@mysten/bcs";
+import * as _mysten_bcs1226 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_bcs1219.BcsStruct<{
-  intent: _mysten_bcs1219.BcsStruct<{
-    scope: _mysten_bcs1219.BcsEnum<{
+declare function IntentMessage<T extends BcsType<any>>(T: T): _mysten_bcs1226.BcsStruct<{
+  intent: _mysten_bcs1226.BcsStruct<{
+    scope: _mysten_bcs1226.BcsEnum<{
       TransactionData: null;
       TransactionEffects: null;
       CheckpointSummary: null;
       PersonalMessage: null;
     }, "IntentScope">;
-    version: _mysten_bcs1219.BcsEnum<{
+    version: _mysten_bcs1226.BcsEnum<{
       V0: null;
     }, "IntentVersion">;
-    appId: _mysten_bcs1219.BcsEnum<{
+    appId: _mysten_bcs1226.BcsEnum<{
       Sui: null;
     }, "AppId">;
   }, string>;

package/dist/bcs/index.d.mts

@@ -545,7 +545,7 @@ declare const suiBcs: {
           version: string;
           digest: string;
         };
-      }, "ImmOrOwnedObject" | "SharedObject" | "Receiving">;
+      }, "Receiving" | "ImmOrOwnedObject" | "SharedObject">;
       FundsWithdrawal: {
         reservation: {
           MaxAmountU64: string;
@@ -560,7 +560,7 @@ declare const suiBcs: {
           Sponsor: true;
         }, "Sender" | "Sponsor">;
       };
-    }, "Pure" | "Object" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
+    }, "Object" | "Pure" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
       Pure: {
         bytes: string | Uint8Array<ArrayBufferLike>;
       };
@@ -793,7 +793,7 @@ declare const suiBcs: {
           TransactionEffects: true;
           CheckpointSummary: true;
           PersonalMessage: true;
-        }, "TransactionData" | "TransactionEffects" | "CheckpointSummary" | "PersonalMessage">;
+        }, "TransactionEffects" | "TransactionData" | "CheckpointSummary" | "PersonalMessage">;
         version: {
           V0: true;
           $kind: "V0";
@@ -827,7 +827,7 @@ declare const suiBcs: {
                     version: string;
                     digest: string;
                   };
-                }, "ImmOrOwnedObject" | "SharedObject" | "Receiving">;
+                }, "Receiving" | "ImmOrOwnedObject" | "SharedObject">;
                 FundsWithdrawal: {
                   reservation: {
                     MaxAmountU64: string;
@@ -842,7 +842,7 @@ declare const suiBcs: {
                     Sponsor: true;
                   }, "Sender" | "Sponsor">;
                 };
-              }, "Pure" | "Object" | "FundsWithdrawal">[];
+              }, "Object" | "Pure" | "FundsWithdrawal">[];
               commands: _mysten_bcs0.EnumOutputShapeWithKeys<{
                 MoveCall: {
                   package: string;
@@ -981,7 +981,7 @@ declare const suiBcs: {
                       startVersion: string;
                       owner: string;
                     };
-                  }, "AddressOwner" | "ObjectOwner" | "Shared" | "Immutable" | "ConsensusAddressOwner">;
+                  }, "AddressOwner" | "ConsensusAddressOwner" | "Immutable" | "ObjectOwner" | "Shared">;
                 };
                 $kind: "RawObject";
               }[];
@@ -1113,7 +1113,7 @@ declare const suiBcs: {
                     version: string;
                     digest: string;
                   };
-                }, "ImmOrOwnedObject" | "SharedObject" | "Receiving">;
+                }, "Receiving" | "ImmOrOwnedObject" | "SharedObject">;
                 FundsWithdrawal: {
                   reservation: {
                     MaxAmountU64: string;
@@ -1128,7 +1128,7 @@ declare const suiBcs: {
                     Sponsor: true;
                   }, "Sender" | "Sponsor">;
                 };
-              }, "Pure" | "Object" | "FundsWithdrawal">[];
+              }, "Object" | "Pure" | "FundsWithdrawal">[];
               commands: _mysten_bcs0.EnumOutputShapeWithKeys<{
                 MoveCall: {
                   package: string;
@@ -1210,7 +1210,7 @@ declare const suiBcs: {
                 };
               }, "MoveCall" | "TransferObjects" | "SplitCoins" | "MergeCoins" | "Publish" | "MakeMoveVec" | "Upgrade">[];
             };
-          }, "ProgrammableTransaction" | "ChangeEpoch" | "Genesis" | "ConsensusCommitPrologue" | "AuthenticatorStateUpdate" | "EndOfEpochTransaction" | "RandomnessStateUpdate" | "ConsensusCommitPrologueV2" | "ConsensusCommitPrologueV3" | "ConsensusCommitPrologueV4" | "ProgrammableSystemTransaction">;
+          }, "EndOfEpochTransaction" | "ProgrammableSystemTransaction" | "ProgrammableTransaction" | "ChangeEpoch" | "Genesis" | "ConsensusCommitPrologue" | "AuthenticatorStateUpdate" | "RandomnessStateUpdate" | "ConsensusCommitPrologueV2" | "ConsensusCommitPrologueV3" | "ConsensusCommitPrologueV4">;
           sender: string;
           gasData: {
             payment: {
@@ -1233,7 +1233,7 @@ declare const suiBcs: {
               chain: string;
               nonce: number;
             };
-          }, "None" | "Epoch" | "ValidDuring">;
+          }, "Epoch" | "None" | "ValidDuring">;
         };
         $kind: "V1";
       };
@@ -1823,7 +1823,7 @@ declare const suiBcs: {
                     version: string;
                     digest: string;
                   };
-                }, "ImmOrOwnedObject" | "SharedObject" | "Receiving">;
+                }, "Receiving" | "ImmOrOwnedObject" | "SharedObject">;
                 FundsWithdrawal: {
                   reservation: {
                     MaxAmountU64: string;
@@ -1838,7 +1838,7 @@ declare const suiBcs: {
                     Sponsor: true;
                   }, "Sender" | "Sponsor">;
                 };
-              }, "Pure" | "Object" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
+              }, "Object" | "Pure" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
                 Pure: {
                   bytes: string | Uint8Array<ArrayBufferLike>;
                 };
@@ -2119,7 +2119,7 @@ declare const suiBcs: {
                       startVersion: string;
                       owner: string;
                     };
-                  }, "AddressOwner" | "ObjectOwner" | "Shared" | "Immutable" | "ConsensusAddressOwner">;
+                  }, "AddressOwner" | "ConsensusAddressOwner" | "Immutable" | "ObjectOwner" | "Shared">;
                 };
                 $kind: "RawObject";
               }[], Iterable<{
@@ -2395,7 +2395,7 @@ declare const suiBcs: {
                     version: string;
                     digest: string;
                   };
-                }, "ImmOrOwnedObject" | "SharedObject" | "Receiving">;
+                }, "Receiving" | "ImmOrOwnedObject" | "SharedObject">;
                 FundsWithdrawal: {
                   reservation: {
                     MaxAmountU64: string;
@@ -2410,7 +2410,7 @@ declare const suiBcs: {
                     Sponsor: true;
                   }, "Sender" | "Sponsor">;
                 };
-              }, "Pure" | "Object" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
+              }, "Object" | "Pure" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
                 Pure: {
                   bytes: string | Uint8Array<ArrayBufferLike>;
                 };
@@ -2707,7 +2707,7 @@ declare const suiBcs: {
                 version: string;
                 digest: string;
               };
-            }, "ImmOrOwnedObject" | "SharedObject" | "Receiving">;
+            }, "Receiving" | "ImmOrOwnedObject" | "SharedObject">;
             FundsWithdrawal: {
               reservation: {
                 MaxAmountU64: string;
@@ -2722,7 +2722,7 @@ declare const suiBcs: {
                 Sponsor: true;
               }, "Sender" | "Sponsor">;
             };
-          }, "Pure" | "Object" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
+          }, "Object" | "Pure" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
             Pure: {
               bytes: string | Uint8Array<ArrayBufferLike>;
             };
@@ -3003,7 +3003,7 @@ declare const suiBcs: {
                   startVersion: string;
                   owner: string;
                 };
-              }, "AddressOwner" | "ObjectOwner" | "Shared" | "Immutable" | "ConsensusAddressOwner">;
+              }, "AddressOwner" | "ConsensusAddressOwner" | "Immutable" | "ObjectOwner" | "Shared">;
             };
             $kind: "RawObject";
           }[], Iterable<{
@@ -3279,7 +3279,7 @@ declare const suiBcs: {
                 version: string;
                 digest: string;
               };
-            }, "ImmOrOwnedObject" | "SharedObject" | "Receiving">;
+            }, "Receiving" | "ImmOrOwnedObject" | "SharedObject">;
             FundsWithdrawal: {
               reservation: {
                 MaxAmountU64: string;
@@ -3294,7 +3294,7 @@ declare const suiBcs: {
                 Sponsor: true;
               }, "Sender" | "Sponsor">;
             };
-          }, "Pure" | "Object" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
+          }, "Object" | "Pure" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
             Pure: {
               bytes: string | Uint8Array<ArrayBufferLike>;
             };
@@ -3567,7 +3567,7 @@ declare const suiBcs: {
               version: string;
               digest: string;
             };
-          }, "ImmOrOwnedObject" | "SharedObject" | "Receiving">;
+          }, "Receiving" | "ImmOrOwnedObject" | "SharedObject">;
           FundsWithdrawal: {
             reservation: {
               MaxAmountU64: string;
@@ -3582,7 +3582,7 @@ declare const suiBcs: {
               Sponsor: true;
             }, "Sender" | "Sponsor">;
           };
-        }, "Pure" | "Object" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
+        }, "Object" | "Pure" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
           Pure: {
             bytes: string | Uint8Array<ArrayBufferLike>;
           };
@@ -3863,7 +3863,7 @@ declare const suiBcs: {
                 startVersion: string;
                 owner: string;
               };
-            }, "AddressOwner" | "ObjectOwner" | "Shared" | "Immutable" | "ConsensusAddressOwner">;
+            }, "AddressOwner" | "ConsensusAddressOwner" | "Immutable" | "ObjectOwner" | "Shared">;
           };
           $kind: "RawObject";
         }[], Iterable<{
@@ -4139,7 +4139,7 @@ declare const suiBcs: {
               version: string;
               digest: string;
             };
-          }, "ImmOrOwnedObject" | "SharedObject" | "Receiving">;
+          }, "Receiving" | "ImmOrOwnedObject" | "SharedObject">;
           FundsWithdrawal: {
             reservation: {
               MaxAmountU64: string;
@@ -4154,7 +4154,7 @@ declare const suiBcs: {
               Sponsor: true;
             }, "Sender" | "Sponsor">;
           };
-        }, "Pure" | "Object" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
+        }, "Object" | "Pure" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
           Pure: {
             bytes: string | Uint8Array<ArrayBufferLike>;
           };
@@ -4608,7 +4608,7 @@ declare const suiBcs: {
           startVersion: string;
           owner: string;
         };
-      }, "AddressOwner" | "ObjectOwner" | "Shared" | "Immutable" | "ConsensusAddressOwner">][], Iterable<readonly [{
+      }, "AddressOwner" | "ConsensusAddressOwner" | "Immutable" | "ObjectOwner" | "Shared">][], Iterable<readonly [{
         objectId: string | Uint8Array<ArrayBufferLike>;
         version: string | number | bigint;
         digest: string;
@@ -4641,7 +4641,7 @@ declare const suiBcs: {
           startVersion: string;
           owner: string;
         };
-      }, "AddressOwner" | "ObjectOwner" | "Shared" | "Immutable" | "ConsensusAddressOwner">][], Iterable<readonly [{
+      }, "AddressOwner" | "ConsensusAddressOwner" | "Immutable" | "ObjectOwner" | "Shared">][], Iterable<readonly [{
         objectId: string | Uint8Array<ArrayBufferLike>;
         version: string | number | bigint;
         digest: string;
@@ -4674,7 +4674,7 @@ declare const suiBcs: {
           startVersion: string;
           owner: string;
         };
-      }, "AddressOwner" | "ObjectOwner" | "Shared" | "Immutable" | "ConsensusAddressOwner">][], Iterable<readonly [{
+      }, "AddressOwner" | "ConsensusAddressOwner" | "Immutable" | "ObjectOwner" | "Shared">][], Iterable<readonly [{
         objectId: string | Uint8Array<ArrayBufferLike>;
         version: string | number | bigint;
         digest: string;
@@ -4941,7 +4941,7 @@ declare const suiBcs: {
               startVersion: string;
               owner: string;
             };
-          }, "AddressOwner" | "ObjectOwner" | "Shared" | "Immutable" | "ConsensusAddressOwner">];
+          }, "AddressOwner" | "ConsensusAddressOwner" | "Immutable" | "ObjectOwner" | "Shared">];
         }, "NotExist" | "Exist">;
         outputState: _mysten_bcs0.EnumOutputShapeWithKeys<{
           NotExist: true;
@@ -4956,7 +4956,7 @@ declare const suiBcs: {
               startVersion: string;
               owner: string;
             };
-          }, "AddressOwner" | "ObjectOwner" | "Shared" | "Immutable" | "ConsensusAddressOwner">];
+          }, "AddressOwner" | "ConsensusAddressOwner" | "Immutable" | "ObjectOwner" | "Shared">];
           PackageWrite: [string, string];
           AccumulatorWriteV1: {
             address: {
@@ -5042,7 +5042,7 @@ declare const suiBcs: {
         ReadConsensusStreamEnded: string;
         Cancelled: string;
         PerEpochConfig: true;
-      }, "ReadOnlyRoot" | "MutateConsensusStreamEnded" | "ReadConsensusStreamEnded" | "Cancelled" | "PerEpochConfig">][], Iterable<readonly [string | Uint8Array<ArrayBufferLike>, _mysten_bcs0.EnumInputShape<{
+      }, "MutateConsensusStreamEnded" | "PerEpochConfig" | "ReadConsensusStreamEnded" | "ReadOnlyRoot" | "Cancelled">][], Iterable<readonly [string | Uint8Array<ArrayBufferLike>, _mysten_bcs0.EnumInputShape<{
         ReadOnlyRoot: readonly [string | number | bigint, string];
         MutateConsensusStreamEnded: string | number | bigint;
         ReadConsensusStreamEnded: string | number | bigint;
@@ -5088,7 +5088,7 @@ declare const suiBcs: {
             version: string;
             digest: string;
           };
-        }, "ImmOrOwnedObject" | "SharedObject" | "Receiving">;
+        }, "Receiving" | "ImmOrOwnedObject" | "SharedObject">;
         FundsWithdrawal: {
           reservation: {
             MaxAmountU64: string;
@@ -5103,7 +5103,7 @@ declare const suiBcs: {
             Sponsor: true;
           }, "Sender" | "Sponsor">;
         };
-      }, "Pure" | "Object" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
+      }, "Object" | "Pure" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
         Pure: {
           bytes: string | Uint8Array<ArrayBufferLike>;
         };
@@ -5384,7 +5384,7 @@ declare const suiBcs: {
               startVersion: string;
               owner: string;
             };
-          }, "AddressOwner" | "ObjectOwner" | "Shared" | "Immutable" | "ConsensusAddressOwner">;
+          }, "AddressOwner" | "ConsensusAddressOwner" | "Immutable" | "ObjectOwner" | "Shared">;
         };
         $kind: "RawObject";
       }[], Iterable<{
@@ -5660,7 +5660,7 @@ declare const suiBcs: {
             version: string;
             digest: string;
           };
-        }, "ImmOrOwnedObject" | "SharedObject" | "Receiving">;
+        }, "Receiving" | "ImmOrOwnedObject" | "SharedObject">;
         FundsWithdrawal: {
           reservation: {
             MaxAmountU64: string;
@@ -5675,7 +5675,7 @@ declare const suiBcs: {
             Sponsor: true;
           }, "Sender" | "Sponsor">;
         };
-      }, "Pure" | "Object" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
+      }, "Object" | "Pure" | "FundsWithdrawal">[], Iterable<_mysten_bcs0.EnumInputShape<{
         Pure: {
           bytes: string | Uint8Array<ArrayBufferLike>;
         };

package/dist/client/errors.d.mts

@@ -1,5 +1,4 @@
 import { SuiClientTypes } from "./types.mjs";
-import "../jsonRpc/index.mjs";
 
 //#region src/client/errors.d.ts
 declare class SuiClientError extends Error {}
@@ -10,6 +9,36 @@ declare class SimulationError extends SuiClientError {
     executionError?: SuiClientTypes.ExecutionError;
   });
 }
+type ObjectErrorReason = 'notFound' | 'deleted' | 'unknown';
+interface ObjectErrorOptions {
+  /** A transport-neutral reason shared by all Core API clients. */
+  reason: ObjectErrorReason;
+  /** The requested object ID, when the lookup identifies one. */
+  objectId?: string;
+  /** The original transport error or response. */
+  cause?: unknown;
+}
+/** An error returned for an individual object lookup. */
+declare class ObjectError extends SuiClientError {
+  /** The transport's error code. Use `reason` for transport-neutral handling. */
+  code: string;
+  /** A transport-neutral reason shared by all Core API clients. */
+  readonly reason: ObjectErrorReason;
+  /** The requested object ID, when the lookup identifies one. */
+  readonly objectId?: string;
+  constructor(code: string, message: string, options?: ObjectErrorOptions);
+}
+type TransactionErrorReason = 'notFound';
+/** An error returned by a transaction lookup. */
+declare class TransactionError extends SuiClientError {
+  /** A transport-neutral reason shared by all Core API clients. */
+  readonly reason: TransactionErrorReason;
+  /** The requested transaction digest. */
+  readonly digest: string;
+  constructor(reason: TransactionErrorReason, digest: string, options?: {
+    cause?: unknown;
+  });
+}
 //#endregion
-export { SimulationError };
+export { ObjectError, ObjectErrorOptions, ObjectErrorReason, SimulationError, SuiClientError, TransactionError, TransactionErrorReason };
 //# sourceMappingURL=errors.d.mts.map

package/dist/client/errors.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.mts","names":[],"sources":["../../src/client/errors.ts"],"mappings":";;;;cAMa,cAAA,SAAuB,KAAA;AAAA,cAEvB,eAAA,SAAwB,cAAA;EACpC,cAAA,GAAiB,cAAA,CAAe,cAAA;cAG/B,OAAA,UACA,OAAA;IAAY,KAAA;IAAiB,cAAA,GAAiB,cAAA,CAAe,cAAA;EAAA;AAAA"}
+{"version":3,"file":"errors.d.mts","names":[],"sources":["../../src/client/errors.ts"],"mappings":";;;cAKa,cAAA,SAAuB,KAAA;AAAA,cAEvB,eAAA,SAAwB,cAAA;EACpC,cAAA,GAAiB,cAAA,CAAe,cAAA;cAG/B,OAAA,UACA,OAAA;IAAY,KAAA;IAAiB,cAAA,GAAiB,cAAA,CAAe,cAAA;EAAA;AAAA;AAAA,KAOnD,iBAAA;AAAA,UAEK,kBAAA;EAT+B;EAW/C,MAAA,EAAQ,iBAAA;EAhB0C;EAkBlD,QAAA;EAlBoC;EAoBpC,KAAA;AAAA;;cAIY,WAAA,SAAoB,cAAA;EApB/B;EAsBD,IAAA;EArB8B;EAAA,SAuBrB,MAAA,EAAQ,iBAAA;EAvB6C;EAAA,SAyBrD,QAAA;cAEG,IAAA,UAAc,OAAA,UAAiB,OAAA,GAAU,kBAAA;AAAA;AAAA,KAQ1C,sBAAA;;cAOC,gBAAA,SAAyB,cAAA;EAnCT;EAAA,SAqCnB,MAAA,EAAQ,sBAAA;EAnCD;EAAA,SAqCP,MAAA;cAEG,MAAA,EAAQ,sBAAA,EAAwB,MAAA,UAAgB,OAAA;IAAY,KAAA;EAAA;AAAA"}

package/dist/client/errors.mjs

@@ -6,23 +6,25 @@ var SimulationError = class extends SuiClientError {
 		this.executionError = options?.executionError;
 	}
 };
-var ObjectError = class ObjectError extends SuiClientError {
-	constructor(code, message) {
-		super(message);
+/** An error returned for an individual object lookup. */
+var ObjectError = class extends SuiClientError {
+	constructor(code, message, options) {
+		super(message, { cause: options?.cause });
 		this.code = code;
+		this.reason = options?.reason ?? "unknown";
+		this.objectId = options?.objectId;
 	}
-	static fromResponse(response, objectId) {
-		switch (response.code) {
-			case "notExists": return new ObjectError(response.code, `Object ${response.object_id} does not exist`);
-			case "dynamicFieldNotFound": return new ObjectError(response.code, `Dynamic field not found for object ${response.parent_object_id}`);
-			case "deleted": return new ObjectError(response.code, `Object ${response.object_id} has been deleted`);
-			case "displayError": return new ObjectError(response.code, `Display error: ${response.error}`);
-			case "unknown":
-			default: return new ObjectError(response.code, `Unknown error while loading object${objectId ? ` ${objectId}` : ""}`);
-		}
+};
+const TRANSACTION_ERROR_MESSAGES = { notFound: (digest) => `Transaction ${digest} not found` };
+/** An error returned by a transaction lookup. */
+var TransactionError = class extends SuiClientError {
+	constructor(reason, digest, options) {
+		super(TRANSACTION_ERROR_MESSAGES[reason](digest), options);
+		this.reason = reason;
+		this.digest = digest;
 	}
 };
 
 //#endregion
-export { ObjectError, SimulationError };
+export { ObjectError, SimulationError, SuiClientError, TransactionError };
 //# sourceMappingURL=errors.mjs.map

package/dist/client/errors.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.mjs","names":[],"sources":["../../src/client/errors.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { ObjectResponseError } from '../jsonRpc/index.js';\nimport type { SuiClientTypes } from './types.js';\n\nexport class SuiClientError extends Error {}\n\nexport class SimulationError extends SuiClientError {\n\texecutionError?: SuiClientTypes.ExecutionError;\n\n\tconstructor(\n\t\tmessage: string,\n\t\toptions?: { cause?: unknown; executionError?: SuiClientTypes.ExecutionError },\n\t) {\n\t\tsuper(message, { cause: options?.cause });\n\t\tthis.executionError = options?.executionError;\n\t}\n}\n\nexport class ObjectError extends SuiClientError {\n\tcode: string;\n\n\tconstructor(code: string, message: string) {\n\t\tsuper(message);\n\t\tthis.code = code;\n\t}\n\n\tstatic fromResponse(response: ObjectResponseError, objectId?: string): ObjectError {\n\t\tswitch (response.code) {\n\t\t\tcase 'notExists':\n\t\t\t\treturn new ObjectError(response.code, `Object ${response.object_id} does not exist`);\n\t\t\tcase 'dynamicFieldNotFound':\n\t\t\t\treturn new ObjectError(\n\t\t\t\t\tresponse.code,\n\t\t\t\t\t`Dynamic field not found for object ${response.parent_object_id}`,\n\t\t\t\t);\n\t\t\tcase 'deleted':\n\t\t\t\treturn new ObjectError(response.code, `Object ${response.object_id} has been deleted`);\n\t\t\tcase 'displayError':\n\t\t\t\treturn new ObjectError(response.code, `Display error: ${response.error}`);\n\t\t\tcase 'unknown':\n\t\t\tdefault:\n\t\t\t\treturn new ObjectError(\n\t\t\t\t\tresponse.code,\n\t\t\t\t\t`Unknown error while loading object${objectId ? ` ${objectId}` : ''}`,\n\t\t\t\t);\n\t\t}\n\t}\n}\n"],"mappings":";AAMA,IAAa,iBAAb,cAAoC,MAAM;AAE1C,IAAa,kBAAb,cAAqC,eAAe;CAGnD,YACC,SACA,SACC;AACD,QAAM,SAAS,EAAE,OAAO,SAAS,OAAO,CAAC;AACzC,OAAK,iBAAiB,SAAS;;;AAIjC,IAAa,cAAb,MAAa,oBAAoB,eAAe;CAG/C,YAAY,MAAc,SAAiB;AAC1C,QAAM,QAAQ;AACd,OAAK,OAAO;;CAGb,OAAO,aAAa,UAA+B,UAAgC;AAClF,UAAQ,SAAS,MAAjB;GACC,KAAK,YACJ,QAAO,IAAI,YAAY,SAAS,MAAM,UAAU,SAAS,UAAU,iBAAiB;GACrF,KAAK,uBACJ,QAAO,IAAI,YACV,SAAS,MACT,sCAAsC,SAAS,mBAC/C;GACF,KAAK,UACJ,QAAO,IAAI,YAAY,SAAS,MAAM,UAAU,SAAS,UAAU,mBAAmB;GACvF,KAAK,eACJ,QAAO,IAAI,YAAY,SAAS,MAAM,kBAAkB,SAAS,QAAQ;GAC1E,KAAK;GACL,QACC,QAAO,IAAI,YACV,SAAS,MACT,qCAAqC,WAAW,IAAI,aAAa,KACjE"}
+{"version":3,"file":"errors.mjs","names":[],"sources":["../../src/client/errors.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { SuiClientTypes } from './types.js';\n\nexport class SuiClientError extends Error {}\n\nexport class SimulationError extends SuiClientError {\n\texecutionError?: SuiClientTypes.ExecutionError;\n\n\tconstructor(\n\t\tmessage: string,\n\t\toptions?: { cause?: unknown; executionError?: SuiClientTypes.ExecutionError },\n\t) {\n\t\tsuper(message, { cause: options?.cause });\n\t\tthis.executionError = options?.executionError;\n\t}\n}\n\nexport type ObjectErrorReason = 'notFound' | 'deleted' | 'unknown';\n\nexport interface ObjectErrorOptions {\n\t/** A transport-neutral reason shared by all Core API clients. */\n\treason: ObjectErrorReason;\n\t/** The requested object ID, when the lookup identifies one. */\n\tobjectId?: string;\n\t/** The original transport error or response. */\n\tcause?: unknown;\n}\n\n/** An error returned for an individual object lookup. */\nexport class ObjectError extends SuiClientError {\n\t/** The transport's error code. Use `reason` for transport-neutral handling. */\n\tcode: string;\n\t/** A transport-neutral reason shared by all Core API clients. */\n\treadonly reason: ObjectErrorReason;\n\t/** The requested object ID, when the lookup identifies one. */\n\treadonly objectId?: string;\n\n\tconstructor(code: string, message: string, options?: ObjectErrorOptions) {\n\t\tsuper(message, { cause: options?.cause });\n\t\tthis.code = code;\n\t\tthis.reason = options?.reason ?? 'unknown';\n\t\tthis.objectId = options?.objectId;\n\t}\n}\n\nexport type TransactionErrorReason = 'notFound';\n\nconst TRANSACTION_ERROR_MESSAGES: Record<TransactionErrorReason, (digest: string) => string> = {\n\tnotFound: (digest) => `Transaction ${digest} not found`,\n};\n\n/** An error returned by a transaction lookup. */\nexport class TransactionError extends SuiClientError {\n\t/** A transport-neutral reason shared by all Core API clients. */\n\treadonly reason: TransactionErrorReason;\n\t/** The requested transaction digest. */\n\treadonly digest: string;\n\n\tconstructor(reason: TransactionErrorReason, digest: string, options?: { cause?: unknown }) {\n\t\tsuper(TRANSACTION_ERROR_MESSAGES[reason](digest), options);\n\t\tthis.reason = reason;\n\t\tthis.digest = digest;\n\t}\n}\n"],"mappings":";AAKA,IAAa,iBAAb,cAAoC,MAAM;AAE1C,IAAa,kBAAb,cAAqC,eAAe;CAGnD,YACC,SACA,SACC;AACD,QAAM,SAAS,EAAE,OAAO,SAAS,OAAO,CAAC;AACzC,OAAK,iBAAiB,SAAS;;;;AAgBjC,IAAa,cAAb,cAAiC,eAAe;CAQ/C,YAAY,MAAc,SAAiB,SAA8B;AACxE,QAAM,SAAS,EAAE,OAAO,SAAS,OAAO,CAAC;AACzC,OAAK,OAAO;AACZ,OAAK,SAAS,SAAS,UAAU;AACjC,OAAK,WAAW,SAAS;;;AAM3B,MAAM,6BAAyF,EAC9F,WAAW,WAAW,eAAe,OAAO,aAC5C;;AAGD,IAAa,mBAAb,cAAsC,eAAe;CAMpD,YAAY,QAAgC,QAAgB,SAA+B;AAC1F,QAAM,2BAA2B,QAAQ,OAAO,EAAE,QAAQ;AAC1D,OAAK,SAAS;AACd,OAAK,SAAS"}

package/dist/client/index.d.mts

@@ -3,6 +3,6 @@ import { ClientWithExtensions, SuiClientRegistration, SuiClientTypes } from "./t
 import { ClientWithCoreApi, CoreClient, CoreClientOptions } from "./core.mjs";
 import { BaseClient } from "./client.mjs";
 import { extractStatusFromEffectsBcs, formatMoveAbortMessage, parseTransactionBcs, parseTransactionEffectsBcs } from "./utils.mjs";
-import { SimulationError } from "./errors.mjs";
+import { ObjectError, ObjectErrorOptions, ObjectErrorReason, SimulationError, SuiClientError, TransactionError, TransactionErrorReason } from "./errors.mjs";
 import { NamedPackagesOverrides } from "./mvr.mjs";
-export { BaseClient, ClientCache, type ClientCacheOptions, type ClientWithCoreApi, type ClientWithExtensions, CoreClient, type CoreClientOptions, type NamedPackagesOverrides, SimulationError, type SuiClientRegistration, type SuiClientTypes, extractStatusFromEffectsBcs, formatMoveAbortMessage, parseTransactionBcs, parseTransactionEffectsBcs };
+export { BaseClient, ClientCache, type ClientCacheOptions, type ClientWithCoreApi, type ClientWithExtensions, CoreClient, type CoreClientOptions, type NamedPackagesOverrides, ObjectError, type ObjectErrorOptions, type ObjectErrorReason, SimulationError, SuiClientError, type SuiClientRegistration, type SuiClientTypes, TransactionError, type TransactionErrorReason, extractStatusFromEffectsBcs, formatMoveAbortMessage, parseTransactionBcs, parseTransactionEffectsBcs };

package/dist/client/index.mjs

@@ -2,6 +2,6 @@ import { ClientCache } from "./cache.mjs";
 import { BaseClient } from "./client.mjs";
 import { CoreClient } from "./core.mjs";
 import { extractStatusFromEffectsBcs, formatMoveAbortMessage, parseTransactionBcs, parseTransactionEffectsBcs } from "./utils.mjs";
-import { SimulationError } from "./errors.mjs";
+import { ObjectError, SimulationError, SuiClientError, TransactionError } from "./errors.mjs";
 
-export { BaseClient, ClientCache, CoreClient, SimulationError, extractStatusFromEffectsBcs, formatMoveAbortMessage, parseTransactionBcs, parseTransactionEffectsBcs };
+export { BaseClient, ClientCache, CoreClient, ObjectError, SimulationError, SuiClientError, TransactionError, extractStatusFromEffectsBcs, formatMoveAbortMessage, parseTransactionBcs, parseTransactionEffectsBcs };

package/dist/graphql/core.d.mts.map

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

package/dist/graphql/core.mjs

@@ -3,7 +3,7 @@ import { raceSignal } from "../client/mvr.mjs";
 import { CoreClient } from "../client/core.mjs";
 import { TransactionDataBuilder } from "../transactions/TransactionData.mjs";
 import { formatMoveAbortMessage, parseTransactionEffectsBcs, transactionBytesHaveEmptyGasPayment } from "../client/utils.mjs";
-import { ObjectError, SimulationError } from "../client/errors.mjs";
+import { ObjectError, SimulationError, TransactionError } from "../client/errors.mjs";
 import { SUI_TYPE_ARG } from "../utils/constants.mjs";
 import { DefaultSuinsNameDocument, ExecuteTransactionDocument, ExecutionStatus, GetAllBalancesDocument, GetBalanceDocument, GetChainIdentifierDocument, GetCoinMetadataDocument, GetCoinsDocument, GetCurrentSystemStateDocument, GetMoveFunctionDocument, GetOwnedObjectsDocument, GetProtocolConfigDocument, GetReferenceGasPriceDocument, GetTransactionBlockDocument, ListEventsDocument, ListTransactionsDocument, MultiGetObjectsDocument, ResolveNameServiceAddressDocument, ResolveTransactionDocument, SimulateTransactionDocument, VerifyZkLoginSignatureDocument, ZkLoginIntentScope } from "./generated/queries.mjs";
 import { Transaction } from "../grpc/proto/sui/rpc/v2/transaction.mjs";
@@ -25,11 +25,11 @@ var GraphQLCoreClient = class extends CoreClient {
 		});
 		this.#graphqlClient = graphqlClient;
 	}
-	async #graphqlQuery(options, getData) {
+	async #graphqlQuery(options, getData, createMissingDataError) {
 		const { data, errors } = await this.#graphqlClient.query(options);
 		handleGraphQLErrors(errors);
 		const extractedData = data && (getData ? getData(data) : data);
-		if (extractedData == null) throw new Error("Missing response data");
+		if (extractedData == null) throw createMissingDataError?.() ?? /* @__PURE__ */ new Error("Missing response data");
 		return extractedData;
 	}
 	async getObjects(options) {
@@ -48,7 +48,13 @@ var GraphQLCoreClient = class extends CoreClient {
 					includeDisplay: options.include?.display ?? false
 				}
 			}, (result) => result.multiGetObjects);
-			results.push(...batch.map((id) => normalizeSuiAddress(id)).map((id) => page.find((obj) => obj?.address === id) ?? new ObjectError("notFound", `Object ${id} not found`)).map((obj) => {
+			results.push(...batch.map((objectId) => ({
+				objectId,
+				normalized: normalizeSuiAddress(objectId)
+			})).map(({ objectId, normalized }) => page.find((obj) => obj?.address === normalized) ?? new ObjectError("notFound", `Object ${normalized} not found`, {
+				reason: "notFound",
+				objectId
+			})).map((obj) => {
 				if (obj instanceof ObjectError) return obj;
 				const bcsContent = obj.asMoveObject?.contents?.bcs ? fromBase64(obj.asMoveObject.contents.bcs) : void 0;
 				const objectBcs = obj.objectBcs ? fromBase64(obj.objectBcs) : void 0;
@@ -219,7 +225,7 @@ var GraphQLCoreClient = class extends CoreClient {
 				includeObjectTypes: options.include?.objectTypes ?? false,
 				includeBcs: options.include?.bcs ?? false
 			}
-		}, (result) => result.transaction), options.include);
+		}, (result) => result.transaction, () => new TransactionError("notFound", options.digest)), options.include);
 	}
 	async executeTransaction(options) {
 		return parseTransaction((await this.#graphqlQuery({