@matterlabs/zksync-js 0.0.6 → 0.0.7

package/dist/adapters/viem/sdk.js

@@ -1,6 +1,6 @@
-export { createViemSdk } from '../../chunk-2MDK3GLO.js';
-import '../../chunk-LL3WKCFJ.js';
-import '../../chunk-NEC2ZKHI.js';
-import '../../chunk-NCAIVYBR.js';
-import '../../chunk-M5J2MM2U.js';
-import '../../chunk-F2ENUV3A.js';
+export { createViemSdk } from '../../chunk-KRIRXY74.js';
+import '../../chunk-NNFWIAVG.js';
+import '../../chunk-P5PIWVEO.js';
+import '../../chunk-KAMEGD6I.js';
+import '../../chunk-GIXLOHLK.js';
+import '../../chunk-NCR42O6O.js';

package/dist/{chunk-YUK547UF.js → chunk-7VP6742W.js}

@@ -1,6 +1,6 @@
-import { createZksRpc, makeTransportFromViem } from './chunk-6K6VJQAL.js';
-import { IBridgehub_default, IL1AssetRouter_default, IL1Nullifier_default, IBaseToken_default, L2NativeTokenVault_default, IL2AssetRouter_default, L1NativeTokenVault_default } from './chunk-M5J2MM2U.js';
-import { L2_ASSET_ROUTER_ADDRESS, L2_NATIVE_TOKEN_VAULT_ADDRESS, L2_BASE_TOKEN_ADDRESS } from './chunk-F2ENUV3A.js';
+import { createZksRpc, makeTransportFromViem } from './chunk-WY36Z6YB.js';
+import { IBridgehub_default, IL1AssetRouter_default, IL1Nullifier_default, IBaseToken_default, L2NativeTokenVault_default, IL2AssetRouter_default, L1NativeTokenVault_default } from './chunk-GIXLOHLK.js';
+import { L2_ASSET_ROUTER_ADDRESS, L2_NATIVE_TOKEN_VAULT_ADDRESS, L2_BASE_TOKEN_ADDRESS } from './chunk-NCR42O6O.js';
 import { getContract, createWalletClient } from 'viem';
 
 // src/adapters/viem/rpc.ts

package/dist/{chunk-WU2LOG2A.js → chunk-EWLA4NUE.js}

@@ -1,8 +1,8 @@
-import { createErrorHandlers, toZKsyncError, classifyReadinessFromRevert } from './chunk-XRE7H466.js';
-import { createNTVCodec, buildFeeBreakdown, quoteL2Gas, quoteL2BaseCost, quoteL1Gas, quoteL2Gas2 } from './chunk-LL3WKCFJ.js';
-import { findL1MessageSentLog, messengerLogIndex, normalizeL1Token, isAddressEq, hexEq, isHash66, isETH, normalizeAddrEq, pickWithdrawRoute } from './chunk-NEC2ZKHI.js';
-import { OP_WITHDRAWALS, IL1Nullifier_default, createError, OP_DEPOSITS, IERC20_default, isZKsyncError, isReceiptNotFound } from './chunk-M5J2MM2U.js';
-import { ETH_ADDRESS, L1_MESSENGER_ADDRESS, L2_ASSET_ROUTER_ADDRESS, L2_BASE_TOKEN_ADDRESS, L2_NATIVE_TOKEN_VAULT_ADDRESS, TOPIC_CANONICAL_ASSIGNED, TOPIC_CANONICAL_SUCCESS, SAFE_L1_BRIDGE_GAS } from './chunk-F2ENUV3A.js';
+import { createErrorHandlers, toZKsyncError, classifyReadinessFromRevert } from './chunk-GNERKUWO.js';
+import { createNTVCodec, buildFeeBreakdown, quoteL2Gas, quoteL2BaseCost, quoteL1Gas, quoteL2Gas2 } from './chunk-NNFWIAVG.js';
+import { findL1MessageSentLog, messengerLogIndex, normalizeL1Token, isAddressEq, hexEq, isHash66, isETH, normalizeAddrEq, pickWithdrawRoute } from './chunk-P5PIWVEO.js';
+import { OP_WITHDRAWALS, IL1Nullifier_default, createError, OP_DEPOSITS, IERC20_default, isZKsyncError, isReceiptNotFound } from './chunk-GIXLOHLK.js';
+import { ETH_ADDRESS, L1_MESSENGER_ADDRESS, L2_ASSET_ROUTER_ADDRESS, L2_BASE_TOKEN_ADDRESS, L2_NATIVE_TOKEN_VAULT_ADDRESS, TOPIC_CANONICAL_ASSIGNED, TOPIC_CANONICAL_SUCCESS, SAFE_L1_BRIDGE_GAS } from './chunk-NCR42O6O.js';
 import { Interface, AbiCoder, ethers, Contract, NonceManager } from 'ethers';
 
 var I_BRIDGEHUB = new Interface([

package/dist/{chunk-M5J2MM2U.js → chunk-GIXLOHLK.js}

@@ -1,4 +1,4 @@
-import { __export } from './chunk-F2ENUV3A.js';
+import { __export } from './chunk-NCR42O6O.js';
 
 // src/core/internal/abis/IBridgehub.ts
 var IBridgehubABI = [

package/dist/{chunk-XRE7H466.js → chunk-GNERKUWO.js}

@@ -1,5 +1,5 @@
-import { REVERT_TO_READINESS } from './chunk-NCAIVYBR.js';
-import { IL1Nullifier_default, IERC20_default, L1NativeTokenVault_default, L2NativeTokenVault_default, Mailbox_default, isZKsyncError, createError, shapeCause } from './chunk-M5J2MM2U.js';
+import { createErrorOps, REVERT_TO_READINESS } from './chunk-KAMEGD6I.js';
+import { IL1Nullifier_default, IERC20_default, L1NativeTokenVault_default, L2NativeTokenVault_default, Mailbox_default } from './chunk-GIXLOHLK.js';
 import { Interface } from 'ethers';
 
 var ERROR_IFACES = [];
@@ -108,50 +108,6 @@ function classifyReadinessFromRevert(e) {
 }
 
 // src/adapters/ethers/errors/error-ops.ts
-function toZKsyncError(type, base, err) {
-  if (isZKsyncError(err)) return err;
-  const revert = decodeRevert(err);
-  return createError(type, { ...base, ...revert ? { revert } : {}, cause: shapeCause(err) });
-}
-function resolveMessage(op, msg) {
-  if (!msg) return `Error during ${op}.`;
-  return typeof msg === "function" ? msg() : msg;
-}
-function createErrorHandlers(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 toZKsyncError(kind, { resource, operation, context: opts?.ctx ?? {}, message }, e);
-    }
-  }
-  function wrap(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 wrap(operation, fn, opts);
-      return { ok: true, value };
-    } catch (e) {
-      const shaped = isZKsyncError(e) ? e : toZKsyncError(
-        "INTERNAL",
-        {
-          resource,
-          operation,
-          context: opts?.ctx ?? {},
-          message: resolveMessage(operation, opts?.message)
-        },
-        e
-      );
-      return { ok: false, error: shaped };
-    }
-  }
-  return { wrap, wrapAs, toResult };
-}
+var { toZKsyncError, createErrorHandlers } = createErrorOps(decodeRevert);
 
 export { classifyReadinessFromRevert, createErrorHandlers, decodeRevert, registerErrorAbi, toZKsyncError };

package/dist/chunk-KAMEGD6I.js

@@ -0,0 +1,75 @@
+import { isZKsyncError, createError, shapeCause } from './chunk-GIXLOHLK.js';
+
+// src/core/errors/error-ops.ts
+function resolveMessage(op, msg) {
+  if (!msg) return `Error during ${op}.`;
+  return typeof msg === "function" ? msg() : msg;
+}
+function createErrorOps(decodeRevert) {
+  function toZKsyncError(type, base, err) {
+    if (isZKsyncError(err)) return err;
+    const revert = decodeRevert ? decodeRevert(err) : void 0;
+    return createError(type, { ...base, ...revert ? { revert } : {}, cause: shapeCause(err) });
+  }
+  function createErrorHandlers(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 toZKsyncError(kind, { resource, operation, context: opts?.ctx ?? {}, message }, e);
+      }
+    }
+    function wrap(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 wrap(operation, fn, opts);
+        return { ok: true, value };
+      } catch (e) {
+        const shaped = isZKsyncError(e) ? e : toZKsyncError(
+          "INTERNAL",
+          {
+            resource,
+            operation,
+            context: opts?.ctx ?? {},
+            message: resolveMessage(operation, opts?.message)
+          },
+          e
+        );
+        return { ok: false, error: shaped };
+      }
+    }
+    return { wrap, wrapAs, toResult };
+  }
+  return { toZKsyncError, createErrorHandlers };
+}
+
+// src/core/errors/withdrawal-revert-map.ts
+var REVERT_TO_READINESS = {
+  // Already done
+  WithdrawalAlreadyFinalized: { kind: "FINALIZED" },
+  // Temporary — try later
+  BatchNotExecuted: { kind: "NOT_READY", reason: "batch-not-executed" },
+  LocalRootIsZero: { kind: "NOT_READY", reason: "root-missing" },
+  // Permanent — won’t become ready for this tx
+  WrongL2Sender: { kind: "UNFINALIZABLE", reason: "message-invalid" },
+  InvalidSelector: { kind: "UNFINALIZABLE", reason: "message-invalid" },
+  L2WithdrawalMessageWrongLength: { kind: "UNFINALIZABLE", reason: "message-invalid" },
+  WrongMsgLength: { kind: "UNFINALIZABLE", reason: "message-invalid" },
+  TokenNotLegacy: { kind: "UNFINALIZABLE", reason: "message-invalid" },
+  TokenIsLegacy: { kind: "UNFINALIZABLE", reason: "message-invalid" },
+  InvalidProof: { kind: "UNFINALIZABLE", reason: "message-invalid" },
+  InvalidChainId: { kind: "UNFINALIZABLE", reason: "invalid-chain" },
+  NotSettlementLayer: { kind: "UNFINALIZABLE", reason: "settlement-layer" },
+  // Likely environment mismatch — treat as permanent for this tx
+  OnlyEraSupported: { kind: "UNFINALIZABLE", reason: "unsupported" },
+  LocalRootMustBeZero: { kind: "UNFINALIZABLE", reason: "unsupported" }
+};
+
+export { REVERT_TO_READINESS, createErrorOps };

package/dist/{chunk-2MDK3GLO.js → chunk-KRIRXY74.js}

@@ -1,9 +1,9 @@
-import { createNTVCodec, buildFeeBreakdown, quoteL2Gas, quoteL1Gas, quoteL2Gas2 } from './chunk-LL3WKCFJ.js';
-import { findL1MessageSentLog, messengerLogIndex, normalizeL1Token, isAddressEq, hexEq, isHash66, isETH, normalizeAddrEq, pickWithdrawRoute } from './chunk-NEC2ZKHI.js';
-import { REVERT_TO_READINESS } from './chunk-NCAIVYBR.js';
-import { IL1Nullifier_default, IERC20_default, L1NativeTokenVault_default, L2NativeTokenVault_default, Mailbox_default, isZKsyncError, createError, shapeCause, OP_WITHDRAWALS, OP_DEPOSITS, isReceiptNotFound, IBridgehub_default, IL2AssetRouter_default, IBaseToken_default } from './chunk-M5J2MM2U.js';
-import { ETH_ADDRESS, L1_MESSENGER_ADDRESS, L2_ASSET_ROUTER_ADDRESS, L2_BASE_TOKEN_ADDRESS, L2_NATIVE_TOKEN_VAULT_ADDRESS, TOPIC_CANONICAL_ASSIGNED, TOPIC_CANONICAL_SUCCESS, SAFE_L1_BRIDGE_GAS } from './chunk-F2ENUV3A.js';
-import { keccak256, encodeAbiParameters, concat, decodeErrorResult, decodeAbiParameters, decodeEventLog, encodeFunctionData, zeroAddress } from 'viem';
+import { createNTVCodec, buildFeeBreakdown, quoteL2Gas, quoteL1Gas, quoteL2Gas2 } from './chunk-NNFWIAVG.js';
+import { findL1MessageSentLog, messengerLogIndex, normalizeL1Token, isAddressEq, hexEq, isHash66, isETH, normalizeAddrEq, pickWithdrawRoute } from './chunk-P5PIWVEO.js';
+import { createErrorOps, REVERT_TO_READINESS } from './chunk-KAMEGD6I.js';
+import { IL1Nullifier_default, IERC20_default, L1NativeTokenVault_default, L2NativeTokenVault_default, Mailbox_default, OP_WITHDRAWALS, createError, OP_DEPOSITS, isZKsyncError, isReceiptNotFound, IBridgehub_default, IL2AssetRouter_default, IBaseToken_default } from './chunk-GIXLOHLK.js';
+import { ETH_ADDRESS, L1_MESSENGER_ADDRESS, L2_ASSET_ROUTER_ADDRESS, L2_BASE_TOKEN_ADDRESS, L2_NATIVE_TOKEN_VAULT_ADDRESS, TOPIC_CANONICAL_ASSIGNED, TOPIC_CANONICAL_SUCCESS, SAFE_L1_BRIDGE_GAS } from './chunk-NCR42O6O.js';
+import { keccak256, encodeAbiParameters, decodeErrorResult, concat, decodeAbiParameters, decodeEventLog, encodeFunctionData, zeroAddress } from 'viem';
 
 // src/adapters/viem/resources/deposits/context.ts
 async function commonCtx(p, client, tokens, contracts) {
@@ -201,51 +201,7 @@ function classifyReadinessFromRevert(e) {
 }
 
 // src/adapters/viem/errors/error-ops.ts
-function toZKsyncError(type, base, err) {
-  if (isZKsyncError(err)) return err;
-  const revert = decodeRevert(err);
-  return createError(type, { ...base, ...revert ? { revert } : {}, cause: shapeCause(err) });
-}
-function resolveMessage(op, msg) {
-  if (!msg) return `Error during ${op}.`;
-  return typeof msg === "function" ? msg() : msg;
-}
-function createErrorHandlers(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 toZKsyncError(kind, { resource, operation, context: opts?.ctx ?? {}, message }, e);
-    }
-  }
-  function wrap2(operation, fn, opts) {
-    return run("INTERNAL", operation, fn, opts);
-  }
-  function wrapAs10(kind, operation, fn, opts) {
-    return run(kind, operation, fn, opts);
-  }
-  async function toResult2(operation, fn, opts) {
-    try {
-      const value = await wrap2(operation, fn, opts);
-      return { ok: true, value };
-    } catch (e) {
-      const shaped = isZKsyncError(e) ? e : toZKsyncError(
-        "INTERNAL",
-        {
-          resource,
-          operation,
-          context: opts?.ctx ?? {},
-          message: resolveMessage(operation, opts?.message)
-        },
-        e
-      );
-      return { ok: false, error: shaped };
-    }
-  }
-  return { wrap: wrap2, wrapAs: wrapAs10, toResult: toResult2 };
-}
+var { toZKsyncError, createErrorHandlers } = createErrorOps(decodeRevert);
 
 // src/adapters/viem/estimator.ts
 function toCoreTx(tx) {

package/dist/{chunk-F2ENUV3A.js → chunk-NCR42O6O.js}

@@ -50,7 +50,7 @@ var TX_OVERHEAD_GAS = 10000n;
 var TX_MEMORY_OVERHEAD_GAS = 10n;
 var DEFAULT_PUBDATA_BYTES = 155n;
 var DEFAULT_ABI_BYTES = 400n;
-var SAFE_L1_BRIDGE_GAS = 600000n;
+var SAFE_L1_BRIDGE_GAS = 700000n;
 var L1_FEE_ESTIMATION_COEF_NUMERATOR = 12;
 var L1_FEE_ESTIMATION_COEF_DENOMINATOR = 10;
 

package/dist/{chunk-3MRGU4HV.js → chunk-NGXRO2ZX.js}

@@ -1,7 +1,7 @@
-import { createErrorHandlers } from './chunk-XRE7H466.js';
-import { createZksRpc, makeTransportFromEthers } from './chunk-6K6VJQAL.js';
-import { createError, IBridgehub_default, IL1AssetRouter_default, IL1Nullifier_default, IBaseToken_default, L2NativeTokenVault_default, IL2AssetRouter_default, L1NativeTokenVault_default, OP_DEPOSITS } from './chunk-M5J2MM2U.js';
-import { L2_ASSET_ROUTER_ADDRESS, L2_NATIVE_TOKEN_VAULT_ADDRESS, L2_BASE_TOKEN_ADDRESS } from './chunk-F2ENUV3A.js';
+import { createErrorHandlers } from './chunk-GNERKUWO.js';
+import { createZksRpc, makeTransportFromEthers } from './chunk-WY36Z6YB.js';
+import { createError, IBridgehub_default, IL1AssetRouter_default, IL1Nullifier_default, IBaseToken_default, L2NativeTokenVault_default, IL2AssetRouter_default, L1NativeTokenVault_default, OP_DEPOSITS } from './chunk-GIXLOHLK.js';
+import { L2_ASSET_ROUTER_ADDRESS, L2_NATIVE_TOKEN_VAULT_ADDRESS, L2_BASE_TOKEN_ADDRESS } from './chunk-NCR42O6O.js';
 import { BrowserProvider, Interface, Contract } from 'ethers';
 
 // src/adapters/ethers/rpc.ts

package/dist/{chunk-LL3WKCFJ.js → chunk-NNFWIAVG.js}

@@ -1,5 +1,5 @@
-import { IBridgehub_default } from './chunk-M5J2MM2U.js';
-import { BUFFER, DEFAULT_ABI_BYTES, DEFAULT_PUBDATA_BYTES, TX_MEMORY_OVERHEAD_GAS, TX_OVERHEAD_GAS } from './chunk-F2ENUV3A.js';
+import { IBridgehub_default } from './chunk-GIXLOHLK.js';
+import { BUFFER, DEFAULT_ABI_BYTES, DEFAULT_PUBDATA_BYTES, TX_MEMORY_OVERHEAD_GAS, TX_OVERHEAD_GAS } from './chunk-NCR42O6O.js';
 
 // src/core/codec/ntv.ts
 function createNTVCodec(deps) {

package/dist/{chunk-NEC2ZKHI.js → chunk-P5PIWVEO.js}

@@ -1,4 +1,4 @@
-import { ETH_ADDRESS, FORMAL_ETH_ADDRESS, L2_BASE_TOKEN_ADDRESS, L2_ASSET_ROUTER_ADDRESS, L1_MESSENGER_ADDRESS, TOPIC_L1_MESSAGE_SENT_NEW, TOPIC_L1_MESSAGE_SENT_LEG } from './chunk-F2ENUV3A.js';
+import { ETH_ADDRESS, FORMAL_ETH_ADDRESS, L2_BASE_TOKEN_ADDRESS, L2_ASSET_ROUTER_ADDRESS, L1_MESSENGER_ADDRESS, TOPIC_L1_MESSAGE_SENT_NEW, TOPIC_L1_MESSAGE_SENT_LEG } from './chunk-NCR42O6O.js';
 
 // src/core/utils/addr.ts
 var isHash66 = (x) => !!x && x.startsWith("0x") && x.length === 66;

package/dist/{chunk-NTEIA5KA.js → chunk-VRL6Y4YJ.js}

@@ -1,4 +1,4 @@
-import { isETH, normalizeAddrEq } from './chunk-NEC2ZKHI.js';
+import { isETH, normalizeAddrEq } from './chunk-P5PIWVEO.js';
 
 // src/core/resources/deposits/route.ts
 async function pickDepositRoute(client, chainIdL2, token) {

package/dist/{chunk-6K6VJQAL.js → chunk-WY36Z6YB.js}

@@ -1,10 +1,11 @@
-import { createError, isZKsyncError, shapeCause } from './chunk-M5J2MM2U.js';
-import { __export } from './chunk-F2ENUV3A.js';
+import { createError, isZKsyncError, shapeCause } from './chunk-GIXLOHLK.js';
+import { __export } from './chunk-NCR42O6O.js';
 
 // src/core/rpc/zks.ts
 var zks_exports = {};
 __export(zks_exports, {
   createZksRpc: () => createZksRpc,
+  normalizeBlockMetadata: () => normalizeBlockMetadata,
   normalizeGenesis: () => normalizeGenesis,
   normalizeProof: () => normalizeProof
 });
@@ -30,6 +31,8 @@ var METHODS = {
   getBridgehub: "zks_getBridgehubContract",
   getL2ToL1LogProof: "zks_getL2ToL1LogProof",
   getReceipt: "eth_getTransactionReceipt",
+  getBytecodeSupplier: "zks_getBytecodeSupplierContract",
+  getBlockMetadataByNumber: "zks_getBlockMetadataByNumber",
   getGenesis: "zks_getGenesis"
 };
 function toHexArray(arr) {
@@ -82,7 +85,9 @@ function ensureHex(value, field, context) {
     context: { field, valueType: typeof value, ...context }
   });
 }
-function ensureNumber(value, field) {
+function ensureNumber(value, field, opts) {
+  const operation = opts?.operation ?? "zksrpc.normalizeGenesis";
+  const messagePrefix = opts?.messagePrefix ?? "Malformed genesis response";
   if (typeof value === "number" && Number.isFinite(value)) return value;
   if (typeof value === "bigint") return Number(value);
   if (typeof value === "string" && value.trim() !== "") {
@@ -91,8 +96,36 @@ function ensureNumber(value, field) {
   }
   throw createError("RPC", {
     resource: "zksrpc",
-    operation: "zksrpc.normalizeGenesis",
-    message: "Malformed genesis response: expected numeric value.",
+    operation,
+    message: `${messagePrefix}: expected numeric value.`,
+    context: { field, valueType: typeof value }
+  });
+}
+function ensureBigInt(value, field, opts) {
+  const operation = opts?.operation ?? "zksrpc.normalizeBlockMetadata";
+  const messagePrefix = opts?.messagePrefix ?? "Malformed block metadata response";
+  if (typeof value === "bigint") return value;
+  if (typeof value === "number" && Number.isFinite(value)) {
+    if (!Number.isInteger(value)) {
+      throw createError("RPC", {
+        resource: "zksrpc",
+        operation,
+        message: `${messagePrefix}: expected integer value.`,
+        context: { field, valueType: typeof value }
+      });
+    }
+    return BigInt(value);
+  }
+  if (typeof value === "string" && value.trim() !== "") {
+    try {
+      return BigInt(value);
+    } catch {
+    }
+  }
+  throw createError("RPC", {
+    resource: "zksrpc",
+    operation,
+    message: `${messagePrefix}: expected bigint-compatible value.`,
     context: { field, valueType: typeof value }
   });
 }
@@ -178,6 +211,57 @@ function normalizeGenesis(raw) {
     });
   }
 }
+function normalizeBlockMetadata(raw) {
+  try {
+    if (!raw || typeof raw !== "object") {
+      throw createError("RPC", {
+        resource: "zksrpc",
+        operation: "zksrpc.normalizeBlockMetadata",
+        message: "Malformed block metadata response: expected object.",
+        context: { receivedType: typeof raw }
+      });
+    }
+    const record = raw;
+    const pubdataPricePerByte = ensureBigInt(
+      record["pubdata_price_per_byte"] ?? record["pubdataPricePerByte"],
+      "pubdata_price_per_byte",
+      {
+        operation: "zksrpc.normalizeBlockMetadata",
+        messagePrefix: "Malformed block metadata response"
+      }
+    );
+    const nativePrice = ensureBigInt(
+      record["native_price"] ?? record["nativePrice"],
+      "native_price",
+      {
+        operation: "zksrpc.normalizeBlockMetadata",
+        messagePrefix: "Malformed block metadata response"
+      }
+    );
+    const executionVersion = ensureNumber(
+      record["execution_version"] ?? record["executionVersion"],
+      "execution_version",
+      {
+        operation: "zksrpc.normalizeBlockMetadata",
+        messagePrefix: "Malformed block metadata response"
+      }
+    );
+    return {
+      pubdataPricePerByte,
+      nativePrice,
+      executionVersion
+    };
+  } catch (e) {
+    if (isZKsyncError(e)) throw e;
+    throw createError("RPC", {
+      resource: "zksrpc",
+      operation: "zksrpc.normalizeBlockMetadata",
+      message: "Failed to normalize block metadata response.",
+      context: { receivedType: typeof raw },
+      cause: shapeCause(e)
+    });
+  }
+}
 function createZksRpc(transport) {
   return {
     // Fetches the Bridgehub contract address.
@@ -200,6 +284,26 @@ function createZksRpc(transport) {
         }
       );
     },
+    // Fetches the Bytecode Supplier contract address.
+    async getBytecodeSupplierAddress() {
+      return withRpcOp(
+        "zksrpc.getBytecodeSupplierAddress",
+        "Failed to fetch Bytecode Supplier address.",
+        {},
+        async () => {
+          const addrRaw = await transport(METHODS.getBytecodeSupplier, []);
+          if (typeof addrRaw !== "string" || !addrRaw.startsWith("0x")) {
+            throw createError("RPC", {
+              resource: "zksrpc",
+              operation: "zksrpc.getBytecodeSupplierAddress",
+              message: "Unexpected Bytecode Supplier address response.",
+              context: { valueType: typeof addrRaw }
+            });
+          }
+          return addrRaw;
+        }
+      );
+    },
     // Fetches a proof for an L2→L1 log emitted in the given transaction.
     async getL2ToL1LogProof(txHash, index) {
       return withRpcOp(
@@ -236,6 +340,19 @@ function createZksRpc(transport) {
         }
       );
     },
+    // Fetches block metadata for the given block number.
+    async getBlockMetadataByNumber(blockNumber) {
+      return withRpcOp(
+        "zksrpc.getBlockMetadataByNumber",
+        "Failed to fetch block metadata.",
+        { blockNumber },
+        async () => {
+          const raw = await transport(METHODS.getBlockMetadataByNumber, [blockNumber]);
+          if (raw == null) return null;
+          return normalizeBlockMetadata(raw);
+        }
+      );
+    },
     // Fetches the genesis configuration returned by `zks_getGenesis`.
     async getGenesis() {
       return withRpcOp(

package/dist/core/constants.cjs

@@ -22,7 +22,7 @@ var TX_OVERHEAD_GAS = 10000n;
 var TX_MEMORY_OVERHEAD_GAS = 10n;
 var DEFAULT_PUBDATA_BYTES = 155n;
 var DEFAULT_ABI_BYTES = 400n;
-var SAFE_L1_BRIDGE_GAS = 600000n;
+var SAFE_L1_BRIDGE_GAS = 700000n;
 var L1_FEE_ESTIMATION_COEF_NUMERATOR = 12;
 var L1_FEE_ESTIMATION_COEF_DENOMINATOR = 10;
 

package/dist/core/constants.d.ts

@@ -29,7 +29,7 @@ export declare const TX_OVERHEAD_GAS = 10000n;
 export declare const TX_MEMORY_OVERHEAD_GAS = 10n;
 export declare const DEFAULT_PUBDATA_BYTES = 155n;
 export declare const DEFAULT_ABI_BYTES = 400n;
-export declare const SAFE_L1_BRIDGE_GAS = 600000n;
+export declare const SAFE_L1_BRIDGE_GAS = 700000n;
 /**
  * Numerator used in scaling the gas limit to help ensure acceptance of L1->L2 txs.
  * Used with {@link L1_FEE_ESTIMATION_COEF_DENOMINATOR}.

package/dist/core/constants.js

@@ -1 +1 @@
-export { BUFFER, DEFAULT_ABI_BYTES, DEFAULT_PUBDATA_BYTES, ETH_ADDRESS, FORMAL_ETH_ADDRESS, L1_FEE_ESTIMATION_COEF_DENOMINATOR, L1_FEE_ESTIMATION_COEF_NUMERATOR, L1_MESSENGER_ADDRESS, L1_SOPH_TOKEN_ADDRESS, L2_ASSET_ROUTER_ADDRESS, L2_BASE_TOKEN_ADDRESS, L2_NATIVE_TOKEN_VAULT_ADDRESS, SAFE_L1_BRIDGE_GAS, TOPIC_CANONICAL_ASSIGNED, TOPIC_CANONICAL_SUCCESS, TOPIC_L1_MESSAGE_SENT, TOPIC_L1_MESSAGE_SENT_LEG, TOPIC_L1_MESSAGE_SENT_NEW, TX_MEMORY_OVERHEAD_GAS, TX_OVERHEAD_GAS, k256hex } from '../chunk-F2ENUV3A.js';
+export { BUFFER, DEFAULT_ABI_BYTES, DEFAULT_PUBDATA_BYTES, ETH_ADDRESS, FORMAL_ETH_ADDRESS, L1_FEE_ESTIMATION_COEF_DENOMINATOR, L1_FEE_ESTIMATION_COEF_NUMERATOR, L1_MESSENGER_ADDRESS, L1_SOPH_TOKEN_ADDRESS, L2_ASSET_ROUTER_ADDRESS, L2_BASE_TOKEN_ADDRESS, L2_NATIVE_TOKEN_VAULT_ADDRESS, SAFE_L1_BRIDGE_GAS, TOPIC_CANONICAL_ASSIGNED, TOPIC_CANONICAL_SUCCESS, TOPIC_L1_MESSAGE_SENT, TOPIC_L1_MESSAGE_SENT_LEG, TOPIC_L1_MESSAGE_SENT_NEW, TX_MEMORY_OVERHEAD_GAS, TX_OVERHEAD_GAS, k256hex } from '../chunk-NCR42O6O.js';

package/dist/core/errors/error-ops.d.ts

@@ -0,0 +1,18 @@
+import { type TryResult, type ErrorEnvelope, type ErrorType, type Resource } from '../types/errors';
+type Ctx = Record<string, unknown>;
+export type DecodeRevert = (err: unknown) => ErrorEnvelope['revert'] | undefined;
+type WrapOptions<TCtx extends Ctx = Ctx> = {
+    /** Optional contextual data for debugging */
+    ctx?: TCtx;
+    /** Optional error message */
+    message?: string | (() => string);
+};
+export declare function createErrorOps(decodeRevert?: DecodeRevert): {
+    toZKsyncError: (type: ErrorType, base: Omit<ErrorEnvelope, "type" | "revert" | "cause">, err: unknown) => import("..").ZKsyncError;
+    createErrorHandlers: (resource: Resource) => {
+        wrap: <T, TCtx extends Ctx = Ctx>(operation: string, fn: () => T | Promise<T>, opts?: WrapOptions<TCtx>) => Promise<T>;
+        wrapAs: <T, TCtx extends Ctx = Ctx>(kind: ErrorType, operation: string, fn: () => T | Promise<T>, opts?: WrapOptions<TCtx>) => Promise<T>;
+        toResult: <T, TCtx extends Ctx = Ctx>(operation: string, fn: () => T | Promise<T>, opts?: WrapOptions<TCtx>) => Promise<TryResult<T>>;
+    };
+};
+export {};