@matterlabs/zksync-js 0.0.8 → 0.0.9

package/dist/adapters/viem/client.cjs

@@ -3,6 +3,7 @@
 var viem = require('viem');
 var sha3 = require('@noble/hashes/sha3');
 var utils = require('@noble/hashes/utils');
+var ethers = require('ethers');
 
 // src/adapters/viem/client.ts
 
@@ -149,13 +150,16 @@ if (kInspect) {
     enumerable: false
   });
 }
-function isZKsyncError(e) {
+function isZKsyncError(e, opts) {
   if (!e || typeof e !== "object") return false;
   const maybe = e;
   if (!("envelope" in maybe)) return false;
   const envelope = maybe.envelope;
-  return typeof envelope?.type === "string" && typeof envelope?.message === "string";
+  if (typeof envelope?.type !== "string" || typeof envelope?.message !== "string") return false;
+  return true;
 }
+var OP_CLIENT = {
+  ensureAddresses: "client.ensureAddresses"};
 
 // src/core/errors/factory.ts
 function createError(type, input) {
@@ -4578,7 +4582,648 @@ var IBaseTokenABI = [
 ];
 var IBaseToken_default = IBaseTokenABI;
 
+// src/core/internal/abis/IERC20.ts
+var IERC20ABI = [
+  {
+    type: "constructor",
+    inputs: [
+      { name: "_name", type: "string", internalType: "string" },
+      { name: "_symbol", type: "string", internalType: "string" },
+      { name: "_decimals", type: "uint8", internalType: "uint8" }
+    ],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "allowance",
+    inputs: [
+      { name: "", type: "address", internalType: "address" },
+      { name: "", type: "address", internalType: "address" }
+    ],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "approve",
+    inputs: [
+      { name: "spender", type: "address", internalType: "address" },
+      { name: "amount", type: "uint256", internalType: "uint256" }
+    ],
+    outputs: [{ name: "", type: "bool", internalType: "bool" }],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "balanceOf",
+    inputs: [{ name: "", type: "address", internalType: "address" }],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "decimals",
+    inputs: [],
+    outputs: [{ name: "", type: "uint8", internalType: "uint8" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "mint",
+    inputs: [
+      { name: "to", type: "address", internalType: "address" },
+      { name: "amount", type: "uint256", internalType: "uint256" }
+    ],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "name",
+    inputs: [],
+    outputs: [{ name: "", type: "string", internalType: "string" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "owner",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "symbol",
+    inputs: [],
+    outputs: [{ name: "", type: "string", internalType: "string" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "totalSupply",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "transfer",
+    inputs: [
+      { name: "to", type: "address", internalType: "address" },
+      { name: "amount", type: "uint256", internalType: "uint256" }
+    ],
+    outputs: [{ name: "", type: "bool", internalType: "bool" }],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "transferFrom",
+    inputs: [
+      { name: "from", type: "address", internalType: "address" },
+      { name: "to", type: "address", internalType: "address" },
+      { name: "amount", type: "uint256", internalType: "uint256" }
+    ],
+    outputs: [{ name: "", type: "bool", internalType: "bool" }],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "event",
+    name: "Approval",
+    inputs: [
+      { name: "owner", type: "address", indexed: true, internalType: "address" },
+      { name: "spender", type: "address", indexed: true, internalType: "address" },
+      { name: "value", type: "uint256", indexed: false, internalType: "uint256" }
+    ],
+    anonymous: false
+  },
+  {
+    type: "event",
+    name: "Transfer",
+    inputs: [
+      { name: "from", type: "address", indexed: true, internalType: "address" },
+      { name: "to", type: "address", indexed: true, internalType: "address" },
+      { name: "value", type: "uint256", indexed: false, internalType: "uint256" }
+    ],
+    anonymous: false
+  },
+  { type: "error", name: "InsufficientAllowance", inputs: [] },
+  { type: "error", name: "InsufficientBalance", inputs: [] },
+  { type: "error", name: "NotOwner", inputs: [] }
+];
+var IERC20_default = IERC20ABI;
+
+// src/core/internal/abis/Mailbox.ts
+var MailboxABI = [
+  {
+    type: "constructor",
+    inputs: [
+      { name: "_eraChainId", type: "uint256", internalType: "uint256" },
+      { name: "_l1ChainId", type: "uint256", internalType: "uint256" }
+    ],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "bridgehubRequestL2Transaction",
+    inputs: [
+      {
+        name: "_request",
+        type: "tuple",
+        internalType: "struct BridgehubL2TransactionRequest",
+        components: [
+          { name: "sender", type: "address", internalType: "address" },
+          { name: "contractL2", type: "address", internalType: "address" },
+          { name: "mintValue", type: "uint256", internalType: "uint256" },
+          { name: "l2Value", type: "uint256", internalType: "uint256" },
+          { name: "l2Calldata", type: "bytes", internalType: "bytes" },
+          { name: "l2GasLimit", type: "uint256", internalType: "uint256" },
+          { name: "l2GasPerPubdataByteLimit", type: "uint256", internalType: "uint256" },
+          { name: "factoryDeps", type: "bytes[]", internalType: "bytes[]" },
+          { name: "refundRecipient", type: "address", internalType: "address" }
+        ]
+      }
+    ],
+    outputs: [{ name: "canonicalTxHash", type: "bytes32", internalType: "bytes32" }],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "bridgehubRequestL2TransactionOnGateway",
+    inputs: [
+      { name: "_canonicalTxHash", type: "bytes32", internalType: "bytes32" },
+      { name: "_expirationTimestamp", type: "uint64", internalType: "uint64" }
+    ],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "finalizeEthWithdrawal",
+    inputs: [
+      { name: "_l2BatchNumber", type: "uint256", internalType: "uint256" },
+      { name: "_l2MessageIndex", type: "uint256", internalType: "uint256" },
+      { name: "_l2TxNumberInBatch", type: "uint16", internalType: "uint16" },
+      { name: "_message", type: "bytes", internalType: "bytes" },
+      { name: "_merkleProof", type: "bytes32[]", internalType: "bytes32[]" }
+    ],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "getName",
+    inputs: [],
+    outputs: [{ name: "", type: "string", internalType: "string" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "l2TransactionBaseCost",
+    inputs: [
+      { name: "_gasPrice", type: "uint256", internalType: "uint256" },
+      { name: "_l2GasLimit", type: "uint256", internalType: "uint256" },
+      { name: "_l2GasPerPubdataByteLimit", type: "uint256", internalType: "uint256" }
+    ],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "proveL1ToL2TransactionStatus",
+    inputs: [
+      { name: "_l2TxHash", type: "bytes32", internalType: "bytes32" },
+      { name: "_l2BatchNumber", type: "uint256", internalType: "uint256" },
+      { name: "_l2MessageIndex", type: "uint256", internalType: "uint256" },
+      { name: "_l2TxNumberInBatch", type: "uint16", internalType: "uint16" },
+      { name: "_merkleProof", type: "bytes32[]", internalType: "bytes32[]" },
+      { name: "_status", type: "uint8", internalType: "enum TxStatus" }
+    ],
+    outputs: [{ name: "", type: "bool", internalType: "bool" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "proveL2LeafInclusion",
+    inputs: [
+      { name: "_batchNumber", type: "uint256", internalType: "uint256" },
+      { name: "_leafProofMask", type: "uint256", internalType: "uint256" },
+      { name: "_leaf", type: "bytes32", internalType: "bytes32" },
+      { name: "_proof", type: "bytes32[]", internalType: "bytes32[]" }
+    ],
+    outputs: [{ name: "", type: "bool", internalType: "bool" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "proveL2LeafInclusionShared",
+    inputs: [
+      { name: "_chainId", type: "uint256", internalType: "uint256" },
+      { name: "_blockOrBatchNumber", type: "uint256", internalType: "uint256" },
+      { name: "_leafProofMask", type: "uint256", internalType: "uint256" },
+      { name: "_leaf", type: "bytes32", internalType: "bytes32" },
+      { name: "_proof", type: "bytes32[]", internalType: "bytes32[]" }
+    ],
+    outputs: [{ name: "", type: "bool", internalType: "bool" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "proveL2LogInclusion",
+    inputs: [
+      { name: "_batchNumber", type: "uint256", internalType: "uint256" },
+      { name: "_index", type: "uint256", internalType: "uint256" },
+      {
+        name: "_log",
+        type: "tuple",
+        internalType: "struct L2Log",
+        components: [
+          { name: "l2ShardId", type: "uint8", internalType: "uint8" },
+          { name: "isService", type: "bool", internalType: "bool" },
+          { name: "txNumberInBatch", type: "uint16", internalType: "uint16" },
+          { name: "sender", type: "address", internalType: "address" },
+          { name: "key", type: "bytes32", internalType: "bytes32" },
+          { name: "value", type: "bytes32", internalType: "bytes32" }
+        ]
+      },
+      { name: "_proof", type: "bytes32[]", internalType: "bytes32[]" }
+    ],
+    outputs: [{ name: "", type: "bool", internalType: "bool" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "proveL2LogInclusionShared",
+    inputs: [
+      { name: "_chainId", type: "uint256", internalType: "uint256" },
+      { name: "_blockOrBatchNumber", type: "uint256", internalType: "uint256" },
+      { name: "_index", type: "uint256", internalType: "uint256" },
+      {
+        name: "_log",
+        type: "tuple",
+        internalType: "struct L2Log",
+        components: [
+          { name: "l2ShardId", type: "uint8", internalType: "uint8" },
+          { name: "isService", type: "bool", internalType: "bool" },
+          { name: "txNumberInBatch", type: "uint16", internalType: "uint16" },
+          { name: "sender", type: "address", internalType: "address" },
+          { name: "key", type: "bytes32", internalType: "bytes32" },
+          { name: "value", type: "bytes32", internalType: "bytes32" }
+        ]
+      },
+      { name: "_proof", type: "bytes32[]", internalType: "bytes32[]" }
+    ],
+    outputs: [{ name: "", type: "bool", internalType: "bool" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "proveL2MessageInclusion",
+    inputs: [
+      { name: "_batchNumber", type: "uint256", internalType: "uint256" },
+      { name: "_index", type: "uint256", internalType: "uint256" },
+      {
+        name: "_message",
+        type: "tuple",
+        internalType: "struct L2Message",
+        components: [
+          { name: "txNumberInBatch", type: "uint16", internalType: "uint16" },
+          { name: "sender", type: "address", internalType: "address" },
+          { name: "data", type: "bytes", internalType: "bytes" }
+        ]
+      },
+      { name: "_proof", type: "bytes32[]", internalType: "bytes32[]" }
+    ],
+    outputs: [{ name: "", type: "bool", internalType: "bool" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "proveL2MessageInclusionShared",
+    inputs: [
+      { name: "_chainId", type: "uint256", internalType: "uint256" },
+      { name: "_blockOrBatchNumber", type: "uint256", internalType: "uint256" },
+      { name: "_index", type: "uint256", internalType: "uint256" },
+      {
+        name: "_message",
+        type: "tuple",
+        internalType: "struct L2Message",
+        components: [
+          { name: "txNumberInBatch", type: "uint16", internalType: "uint16" },
+          { name: "sender", type: "address", internalType: "address" },
+          { name: "data", type: "bytes", internalType: "bytes" }
+        ]
+      },
+      { name: "_proof", type: "bytes32[]", internalType: "bytes32[]" }
+    ],
+    outputs: [{ name: "", type: "bool", internalType: "bool" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "requestL2ServiceTransaction",
+    inputs: [
+      { name: "_contractL2", type: "address", internalType: "address" },
+      { name: "_l2Calldata", type: "bytes", internalType: "bytes" }
+    ],
+    outputs: [{ name: "canonicalTxHash", type: "bytes32", internalType: "bytes32" }],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "requestL2Transaction",
+    inputs: [
+      { name: "_contractL2", type: "address", internalType: "address" },
+      { name: "_l2Value", type: "uint256", internalType: "uint256" },
+      { name: "_calldata", type: "bytes", internalType: "bytes" },
+      { name: "_l2GasLimit", type: "uint256", internalType: "uint256" },
+      { name: "_l2GasPerPubdataByteLimit", type: "uint256", internalType: "uint256" },
+      { name: "_factoryDeps", type: "bytes[]", internalType: "bytes[]" },
+      { name: "_refundRecipient", type: "address", internalType: "address" }
+    ],
+    outputs: [{ name: "canonicalTxHash", type: "bytes32", internalType: "bytes32" }],
+    stateMutability: "payable"
+  },
+  {
+    type: "function",
+    name: "requestL2TransactionToGatewayMailbox",
+    inputs: [
+      { name: "_chainId", type: "uint256", internalType: "uint256" },
+      { name: "_canonicalTxHash", type: "bytes32", internalType: "bytes32" },
+      { name: "_expirationTimestamp", type: "uint64", internalType: "uint64" }
+    ],
+    outputs: [{ name: "canonicalTxHash", type: "bytes32", internalType: "bytes32" }],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "event",
+    name: "NewPriorityRequest",
+    inputs: [
+      { name: "txId", type: "uint256", indexed: false, internalType: "uint256" },
+      { name: "txHash", type: "bytes32", indexed: false, internalType: "bytes32" },
+      {
+        name: "expirationTimestamp",
+        type: "uint64",
+        indexed: false,
+        internalType: "uint64"
+      },
+      {
+        name: "transaction",
+        type: "tuple",
+        indexed: false,
+        internalType: "struct L2CanonicalTransaction",
+        components: [
+          { name: "txType", type: "uint256", internalType: "uint256" },
+          { name: "from", type: "uint256", internalType: "uint256" },
+          { name: "to", type: "uint256", internalType: "uint256" },
+          { name: "gasLimit", type: "uint256", internalType: "uint256" },
+          { name: "gasPerPubdataByteLimit", type: "uint256", internalType: "uint256" },
+          { name: "maxFeePerGas", type: "uint256", internalType: "uint256" },
+          { name: "maxPriorityFeePerGas", type: "uint256", internalType: "uint256" },
+          { name: "paymaster", type: "uint256", internalType: "uint256" },
+          { name: "nonce", type: "uint256", internalType: "uint256" },
+          { name: "value", type: "uint256", internalType: "uint256" },
+          { name: "reserved", type: "uint256[4]", internalType: "uint256[4]" },
+          { name: "data", type: "bytes", internalType: "bytes" },
+          { name: "signature", type: "bytes", internalType: "bytes" },
+          { name: "factoryDeps", type: "uint256[]", internalType: "uint256[]" },
+          { name: "paymasterInput", type: "bytes", internalType: "bytes" },
+          { name: "reservedDynamic", type: "bytes", internalType: "bytes" }
+        ]
+      },
+      { name: "factoryDeps", type: "bytes[]", indexed: false, internalType: "bytes[]" }
+    ],
+    anonymous: false
+  },
+  {
+    type: "event",
+    name: "NewPriorityRequestId",
+    inputs: [
+      { name: "txId", type: "uint256", indexed: true, internalType: "uint256" },
+      { name: "txHash", type: "bytes32", indexed: true, internalType: "bytes32" }
+    ],
+    anonymous: false
+  },
+  {
+    type: "event",
+    name: "NewRelayedPriorityTransaction",
+    inputs: [
+      { name: "txId", type: "uint256", indexed: false, internalType: "uint256" },
+      { name: "txHash", type: "bytes32", indexed: false, internalType: "bytes32" },
+      {
+        name: "expirationTimestamp",
+        type: "uint64",
+        indexed: false,
+        internalType: "uint64"
+      }
+    ],
+    anonymous: false
+  },
+  { type: "error", name: "BaseTokenGasPriceDenominatorNotSet", inputs: [] },
+  {
+    type: "error",
+    name: "BatchNotExecuted",
+    inputs: [{ name: "batchNumber", type: "uint256", internalType: "uint256" }]
+  },
+  { type: "error", name: "GasPerPubdataMismatch", inputs: [] },
+  { type: "error", name: "HashedLogIsDefault", inputs: [] },
+  { type: "error", name: "InvalidChainId", inputs: [] },
+  { type: "error", name: "InvalidProofLengthForFinalNode", inputs: [] },
+  {
+    type: "error",
+    name: "LengthIsNotDivisibleBy32",
+    inputs: [{ name: "length", type: "uint256", internalType: "uint256" }]
+  },
+  { type: "error", name: "LocalRootIsZero", inputs: [] },
+  { type: "error", name: "LocalRootMustBeZero", inputs: [] },
+  {
+    type: "error",
+    name: "MalformedBytecode",
+    inputs: [{ name: "", type: "uint8", internalType: "enum BytecodeError" }]
+  },
+  { type: "error", name: "MerkleIndexOutOfBounds", inputs: [] },
+  { type: "error", name: "MerklePathEmpty", inputs: [] },
+  { type: "error", name: "MerklePathOutOfBounds", inputs: [] },
+  {
+    type: "error",
+    name: "MsgValueTooLow",
+    inputs: [
+      { name: "required", type: "uint256", internalType: "uint256" },
+      { name: "provided", type: "uint256", internalType: "uint256" }
+    ]
+  },
+  { type: "error", name: "NotHyperchain", inputs: [] },
+  { type: "error", name: "NotInitializedReentrancyGuard", inputs: [] },
+  {
+    type: "error",
+    name: "NotL1",
+    inputs: [{ name: "blockChainId", type: "uint256", internalType: "uint256" }]
+  },
+  { type: "error", name: "NotSettlementLayer", inputs: [] },
+  { type: "error", name: "OnlyEraSupported", inputs: [] },
+  {
+    type: "error",
+    name: "PubdataGreaterThanLimit",
+    inputs: [
+      { name: "limit", type: "uint256", internalType: "uint256" },
+      { name: "length", type: "uint256", internalType: "uint256" }
+    ]
+  },
+  { type: "error", name: "Reentrancy", inputs: [] },
+  { type: "error", name: "TooManyFactoryDeps", inputs: [] },
+  { type: "error", name: "TooMuchGas", inputs: [] },
+  { type: "error", name: "TransactionNotAllowed", inputs: [] },
+  { type: "error", name: "TxnBodyGasLimitNotEnoughGas", inputs: [] },
+  {
+    type: "error",
+    name: "Unauthorized",
+    inputs: [{ name: "caller", type: "address", internalType: "address" }]
+  },
+  {
+    type: "error",
+    name: "UnsupportedProofMetadataVersion",
+    inputs: [{ name: "metadataVersion", type: "uint256", internalType: "uint256" }]
+  },
+  { type: "error", name: "ValidateTxnNotEnoughGas", inputs: [] },
+  { type: "error", name: "ZeroGasPriceL1TxZKSyncOS", inputs: [] }
+];
+var Mailbox_default = MailboxABI;
+
+// src/core/errors/error-ops.ts
+function resolveMessage(op, msg) {
+  if (!msg) return `Error during ${op}.`;
+  return typeof msg === "function" ? msg() : msg;
+}
+function createErrorOps(decodeRevert2) {
+  function toZKsyncError2(type, base, err) {
+    if (isZKsyncError(err)) return err;
+    const revert = decodeRevert2 ? decodeRevert2(err) : void 0;
+    return createError(type, { ...base, ...revert ? { revert } : {}, cause: shapeCause(err) });
+  }
+  function createErrorHandlers2(resource) {
+    async function run(kind, operation, fn, opts) {
+      try {
+        return await fn();
+      } catch (e) {
+        if (isZKsyncError(e)) throw e;
+        const message = resolveMessage(operation, opts?.message);
+        throw toZKsyncError2(kind, { resource, operation, context: opts?.ctx ?? {}, message }, e);
+      }
+    }
+    function wrap2(operation, fn, opts) {
+      return run("INTERNAL", operation, fn, opts);
+    }
+    function wrapAs(kind, operation, fn, opts) {
+      return run(kind, operation, fn, opts);
+    }
+    async function toResult(operation, fn, opts) {
+      try {
+        const value = await wrap2(operation, fn, opts);
+        return { ok: true, value };
+      } catch (e) {
+        const shaped = isZKsyncError(e) ? e : toZKsyncError2(
+          "INTERNAL",
+          {
+            resource,
+            operation,
+            context: opts?.ctx ?? {},
+            message: resolveMessage(operation, opts?.message)
+          },
+          e
+        );
+        return { ok: false, error: shaped };
+      }
+    }
+    return { wrap: wrap2, wrapAs, toResult };
+  }
+  return { toZKsyncError: toZKsyncError2, createErrorHandlers: createErrorHandlers2 };
+}
+var ERROR_IFACES = [];
+var IFACE_ERROR_STRING = new ethers.Interface(["error Error(string)"]);
+var IFACE_PANIC = new ethers.Interface(["error Panic(uint256)"]);
+(function bootstrapDefaultIfaces() {
+  try {
+    ERROR_IFACES.push({
+      name: "IL1Nullifier",
+      iface: new ethers.Interface(IL1Nullifier_default)
+    });
+  } catch {
+  }
+  try {
+    ERROR_IFACES.push({ name: "IERC20", iface: new ethers.Interface(IERC20_default) });
+  } catch {
+  }
+  try {
+    ERROR_IFACES.push({
+      name: "IL1NativeTokenVault",
+      iface: new ethers.Interface(L1NativeTokenVault_default)
+    });
+  } catch {
+  }
+  try {
+    ERROR_IFACES.push({
+      name: "IL2NativeTokenVault",
+      iface: new ethers.Interface(L2NativeTokenVault_default)
+    });
+  } catch {
+  }
+  try {
+    ERROR_IFACES.push({ name: "Mailbox", iface: new ethers.Interface(Mailbox_default) });
+  } catch {
+  }
+})();
+function extractRevertData(e) {
+  const maybe = (
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+    e?.data?.data ?? e?.error?.data ?? e?.data ?? e?.error?.error?.data ?? e?.info?.error?.data
+  );
+  if (typeof maybe === "string" && maybe.startsWith("0x") && maybe.length >= 10) {
+    return maybe;
+  }
+  return void 0;
+}
+function decodeRevert(e) {
+  const data = extractRevertData(e);
+  if (!data) return;
+  const selector = `0x${data.slice(2, 10)}`;
+  try {
+    const parsed = IFACE_ERROR_STRING.parseError(data);
+    if (parsed?.name === "Error") {
+      const args = parsed.args ? Array.from(parsed.args) : void 0;
+      return { selector, name: "Error", args };
+    }
+  } catch {
+  }
+  try {
+    const parsed = IFACE_PANIC.parseError(data);
+    if (parsed?.name === "Panic") {
+      const args = parsed.args ? Array.from(parsed.args) : void 0;
+      return { selector, name: "Panic", args };
+    }
+  } catch {
+  }
+  for (const { name, iface } of ERROR_IFACES) {
+    try {
+      const parsed = iface.parseError(data);
+      if (parsed) {
+        const args = parsed.args ? Array.from(parsed.args) : void 0;
+        return {
+          selector,
+          name: parsed.name,
+          args,
+          contract: name
+        };
+      }
+    } catch {
+    }
+  }
+  return { selector };
+}
+
+// src/adapters/ethers/errors/error-ops.ts
+var { createErrorHandlers } = createErrorOps(decodeRevert);
+
 // src/adapters/viem/client.ts
+var { wrap } = createErrorHandlers("client");
 function createViemClient(args) {
   const { l1, l2, l1Wallet, l2Wallet } = args;
   if (!l1Wallet.account) {
@@ -4590,35 +5235,44 @@ function createViemClient(args) {
   let cCache;
   async function ensureAddresses() {
     if (addrCache) return addrCache;
-    const bridgehub = args.overrides?.bridgehub ?? await zks.getBridgehubAddress();
-    const l1AssetRouter = args.overrides?.l1AssetRouter ?? await l1.readContract({
-      address: bridgehub,
-      abi: IBridgehub_default,
-      functionName: "assetRouter"
-    });
-    const l1Nullifier = args.overrides?.l1Nullifier ?? await l1.readContract({
-      address: l1AssetRouter,
-      abi: IL1AssetRouter_default,
-      functionName: "L1_NULLIFIER"
-    });
-    const l1NativeTokenVault = args.overrides?.l1NativeTokenVault ?? await l1.readContract({
-      address: l1Nullifier,
-      abi: IL1Nullifier_default,
-      functionName: "l1NativeTokenVault"
-    });
-    const l2AssetRouter = args.overrides?.l2AssetRouter ?? L2_ASSET_ROUTER_ADDRESS;
-    const l2NativeTokenVault = args.overrides?.l2NativeTokenVault ?? L2_NATIVE_TOKEN_VAULT_ADDRESS;
-    const l2BaseTokenSystem = args.overrides?.l2BaseTokenSystem ?? L2_BASE_TOKEN_ADDRESS;
-    addrCache = {
-      bridgehub,
-      l1AssetRouter,
-      l1Nullifier,
-      l1NativeTokenVault,
-      l2AssetRouter,
-      l2NativeTokenVault,
-      l2BaseTokenSystem
-    };
-    return addrCache;
+    return await wrap(
+      OP_CLIENT.ensureAddresses,
+      async () => {
+        const bridgehub = args.overrides?.bridgehub ?? await zks.getBridgehubAddress();
+        const l1AssetRouter = args.overrides?.l1AssetRouter ?? await l1.readContract({
+          address: bridgehub,
+          abi: IBridgehub_default,
+          functionName: "assetRouter"
+        });
+        const l1Nullifier = args.overrides?.l1Nullifier ?? await l1.readContract({
+          address: l1AssetRouter,
+          abi: IL1AssetRouter_default,
+          functionName: "L1_NULLIFIER"
+        });
+        const l1NativeTokenVault = args.overrides?.l1NativeTokenVault ?? await l1.readContract({
+          address: l1Nullifier,
+          abi: IL1Nullifier_default,
+          functionName: "l1NativeTokenVault"
+        });
+        const l2AssetRouter = args.overrides?.l2AssetRouter ?? L2_ASSET_ROUTER_ADDRESS;
+        const l2NativeTokenVault = args.overrides?.l2NativeTokenVault ?? L2_NATIVE_TOKEN_VAULT_ADDRESS;
+        const l2BaseTokenSystem = args.overrides?.l2BaseTokenSystem ?? L2_BASE_TOKEN_ADDRESS;
+        addrCache = {
+          bridgehub,
+          l1AssetRouter,
+          l1Nullifier,
+          l1NativeTokenVault,
+          l2AssetRouter,
+          l2NativeTokenVault,
+          l2BaseTokenSystem
+        };
+        return addrCache;
+      },
+      {
+        ctx: { where: "ensureAddresses" },
+        message: "Failed to ensure contract addresses."
+      }
+    );
   }
   async function contracts() {
     if (cCache) return cCache;