@matterlabs/zksync-js 0.0.15 → 0.0.17

package/dist/adapters/viem/index.js

@@ -1,9 +1,9 @@
-export { buildDirectRequestStruct, createContractsResource, createDepositsResource, createFinalizationServices, createInteropFinalizationServices, createInteropResource, createTokensResource, createViemSdk, createWithdrawalsResource, encodeNativeTokenVaultTransferData, encodeSecondBridgeArgs, encodeSecondBridgeDataV1, encodeSecondBridgeErc20Args, encodeSecondBridgeEthArgs, getL2TransactionHashFromLogs } from '../../chunk-4PZCNTQ3.js';
-import '../../chunk-K2UVKMLN.js';
+export { buildDirectRequestStruct, createContractsResource, createDepositsResource, createFinalizationServices, createInteropFinalizationServices, createInteropResource, createTokensResource, createViemSdk, createWithdrawalsResource, encodeNativeTokenVaultTransferData, encodeSecondBridgeArgs, encodeSecondBridgeDataV1, encodeSecondBridgeErc20Args, encodeSecondBridgeEthArgs, getL2TransactionHashFromLogs } from '../../chunk-ONCNOWNC.js';
+import '../../chunk-6LYAENO6.js';
 import '../../chunk-3HHUZXSV.js';
-export { createViemClient as createClient, createViemClient } from '../../chunk-JHRYNLZG.js';
-export { classifyReadinessFromRevert, createErrorHandlers, decodeRevert, registerErrorAbi, toZKsyncError } from '../../chunk-YIWXIP2M.js';
+export { createViemClient as createClient, createViemClient } from '../../chunk-CK5UFAZK.js';
+export { classifyReadinessFromRevert, createErrorHandlers, decodeRevert, registerErrorAbi, toZKsyncError } from '../../chunk-SBGBYZJM.js';
 import '../../chunk-BWKWWLY4.js';
-import '../../chunk-MDPX5LNW.js';
-import '../../chunk-JXR5V5YK.js';
+import '../../chunk-JSBMIT4S.js';
+import '../../chunk-UEKFQAOS.js';
 import '../../chunk-MT4X5FEO.js';

package/dist/adapters/viem/resources/interop/index.d.ts

@@ -1,12 +1,14 @@
 import type { ViemClient } from '../../client';
+import type { Hex } from '../../../../core/types/primitives';
 import type { AttributesResource } from '../../../../core/resources/interop/attributes/resource';
 import type { InteropRoute, InteropPlan, InteropQuote, InteropStatus, InteropFinalizationResult, InteropParams, InteropHandle, InteropWaitable, InteropFinalizationInfo } from '../../../../core/types/flows/interop';
 import type { ContractsResource } from '../contracts';
 import type { TokensResource } from '../../../../core/types/flows/token';
 import type { InteropRouteStrategy, ViemTransactionRequest } from './routes/types';
 import { createInteropFinalizationServices, type InteropFinalizationServices } from './services/finalization';
-import type { LogsQueryOptions } from './services/finalization/data-fetchers';
+import { type LogsQueryOptions } from './services/finalization/data-fetchers';
 import type { ChainRef, InteropConfig } from './types';
+import type { TxGasOverrides } from '../../../../core/types/fees';
 export declare const ROUTES: Record<InteropRoute, InteropRouteStrategy>;
 export interface InteropResource {
     quote(dstChain: ChainRef, params: InteropParams): Promise<InteropQuote>;
@@ -48,14 +50,16 @@ export interface InteropResource {
         ok: false;
         error: unknown;
     }>;
-    finalize(dstChain: ChainRef, h: InteropWaitable | InteropFinalizationInfo, opts?: LogsQueryOptions): Promise<InteropFinalizationResult>;
-    tryFinalize(dstChain: ChainRef, h: InteropWaitable | InteropFinalizationInfo, opts?: LogsQueryOptions): Promise<{
+    finalize(dstChain: ChainRef, h: InteropWaitable | InteropFinalizationInfo, opts?: LogsQueryOptions, txOverrides?: TxGasOverrides): Promise<InteropFinalizationResult>;
+    tryFinalize(dstChain: ChainRef, h: InteropWaitable | InteropFinalizationInfo, opts?: LogsQueryOptions, txOverrides?: TxGasOverrides): Promise<{
         ok: true;
         value: InteropFinalizationResult;
     } | {
         ok: false;
         error: unknown;
     }>;
+    getInteropRoot(dstChain: ChainRef, rootChainId: bigint, batchNumber: bigint): Promise<Hex>;
+    verifyBundle(dstChain: ChainRef, h: InteropWaitable | InteropFinalizationInfo): Promise<InteropFinalizationResult>;
 }
 export declare function createInteropResource(client: ViemClient, config?: InteropConfig, tokens?: TokensResource, contracts?: ContractsResource, attributes?: AttributesResource): InteropResource;
 export { createInteropFinalizationServices };

package/dist/adapters/viem/resources/interop/services/finalization/bundle.d.ts

@@ -1,6 +1,7 @@
 import { type PublicClient, type TransactionReceipt } from 'viem';
 import type { Hex } from '../../../../../../core/types/primitives';
 import type { InteropFinalizationInfo } from '../../../../../../core/types/flows/interop';
+import type { TxGasOverrides } from '../../../../../../core/types/fees';
 import type { ViemClient } from '../../../../client';
 import type { InteropPhase } from '../../../../../../core/types/flows/interop';
 import type { InteropTopics } from '../../../../../../core/resources/interop/events';
@@ -9,7 +10,11 @@ export declare function getBundleStatus(client: ViemClient, dstProvider: PublicC
     phase: InteropPhase;
     dstExecTxHash?: Hex;
 }>;
-export declare function executeBundle(client: ViemClient, dstProvider: PublicClient, info: InteropFinalizationInfo, opts?: LogsQueryOptions): Promise<{
+export declare function executeBundle(client: ViemClient, dstProvider: PublicClient, info: InteropFinalizationInfo, opts?: LogsQueryOptions, txOverrides?: TxGasOverrides): Promise<{
+    hash: Hex;
+    wait: () => Promise<TransactionReceipt>;
+}>;
+export declare function verifyBundle(client: ViemClient, dstProvider: PublicClient, info: InteropFinalizationInfo): Promise<{
     hash: Hex;
     wait: () => Promise<TransactionReceipt>;
 }>;

package/dist/adapters/viem/resources/interop/services/finalization/index.d.ts

@@ -2,12 +2,13 @@ import type { PublicClient } from 'viem';
 import type { InteropStatus, InteropWaitable, InteropFinalizationInfo, InteropFinalizationResult } from '../../../../../../core/types/flows/interop';
 import type { ViemClient } from '../../../../client';
 import type { LogsQueryOptions } from './data-fetchers';
+import type { TxGasOverrides } from '../../../../../../core/types/fees';
 export interface InteropFinalizationServices {
     status(dstProvider: PublicClient, input: InteropWaitable, opts?: LogsQueryOptions): Promise<InteropStatus>;
     wait(dstProvider: PublicClient, gwProvider: PublicClient, input: InteropWaitable, opts?: {
         pollMs?: number;
         timeoutMs?: number;
     }): Promise<InteropFinalizationInfo>;
-    finalize(dstProvider: PublicClient, info: InteropFinalizationInfo, opts?: LogsQueryOptions): Promise<InteropFinalizationResult>;
+    finalize(dstProvider: PublicClient, info: InteropFinalizationInfo, opts?: LogsQueryOptions, txOverrides?: TxGasOverrides): Promise<InteropFinalizationResult>;
 }
 export declare function createInteropFinalizationServices(client: ViemClient): InteropFinalizationServices;

package/dist/adapters/viem/sdk.cjs

@@ -5915,6 +5915,7 @@ var OP_INTEROP = {
   tryWait: "interop.tryWait",
   finalize: "interop.finalize",
   tryFinalize: "interop.tryFinalize",
+  verify: "interop.verify",
   context: {
     chainTypeManager: "interop.chainTypeManager",
     protocolVersion: "interop.protocolVersion"
@@ -6532,8 +6533,8 @@ function buildFeeBreakdown(p) {
 
 // src/core/resources/deposits/priority.ts
 var PRIORITY_TX_ENCODING_STEP_BYTES = 544n;
-var DEFAULT_PRIORITY_BODY_GAS_ESTIMATE_MULTIPLIER = 6n;
-var ERAVM_PRIORITY_L2_GAS_BUFFER = 30n;
+var DEFAULT_PRIORITY_BODY_GAS_ESTIMATE_MULTIPLIER = 7n;
+var PRIORITY_L2_GAS_BUFFER = 40n;
 var maxBigInt2 = (a, b) => a > b ? a : b;
 var ceilDiv = (a, b) => (a + b - 1n) / b;
 function derivePriorityTxGasBreakdown(input) {
@@ -6561,10 +6562,7 @@ function derivePriorityBodyGasEstimateCap(input) {
   return input.minBodyGas * (input.multiplier ?? DEFAULT_PRIORITY_BODY_GAS_ESTIMATE_MULTIPLIER);
 }
 function applyPriorityL2GasLimitBuffer(input) {
-  if (!isEraVmChain(input.chainIdL2)) {
-    return input.gasLimit;
-  }
-  return input.gasLimit * (100n + ERAVM_PRIORITY_L2_GAS_BUFFER) / 100n;
+  return input.gasLimit * (100n + PRIORITY_L2_GAS_BUFFER) / 100n;
 }
 var EMPTY_BYTES = "0x";
 var ZERO_RESERVED_WORDS = [0n, 0n, 0n, 0n];
@@ -7220,7 +7218,7 @@ function routeEthNonBase() {
       const requestStruct = {
         chainId: ctx.chainIdL2,
         mintValue,
-        l2Value: p.amount,
+        l2Value: 0n,
         l2GasLimit: l2Gas.gasLimit,
         l2GasPerPubdataByteLimit: ctx.gasPerPubdata,
         refundRecipient: ctx.refundRecipient,
@@ -7228,6 +7226,7 @@ function routeEthNonBase() {
         secondBridgeValue: p.amount,
         secondBridgeCalldata
       };
+      const bridgehubValue = p.amount;
       let bridgeTx;
       let calldata;
       if (needsApprove) {
@@ -7236,8 +7235,7 @@ function routeEthNonBase() {
           abi: IBridgehub_default,
           functionName: "requestL2TransactionTwoBridges",
           args: [requestStruct],
-          value: p.amount,
-          // base ≠ ETH ⇒ msg.value == secondBridgeValue
+          value: bridgehubValue,
           account: ctx.client.account
         };
         calldata = viem.encodeFunctionData({
@@ -7254,7 +7252,7 @@ function routeEthNonBase() {
             abi: IBridgehub_default,
             functionName: "requestL2TransactionTwoBridges",
             args: [requestStruct],
-            value: p.amount,
+            value: bridgehubValue,
             account: ctx.client.account
           }),
           {
@@ -7272,7 +7270,7 @@ function routeEthNonBase() {
       const l1TxCandidate = {
         to: ctx.bridgehub,
         data: calldata,
-        value: p.amount,
+        value: bridgehubValue,
         from: ctx.sender,
         ...ctx.gasOverrides
       };
@@ -9708,13 +9706,23 @@ function routeIndirect() {
 }
 function routeDirect() {
   return {
-    // eslint-disable-next-line @typescript-eslint/require-await
     async preflight(params, ctx) {
       preflightDirect(params, {
         dstChainId: ctx.dstChainId,
         baseTokens: ctx.baseTokens,
         l2AssetRouter: ctx.l2AssetRouter,
         l2NativeTokenVault: ctx.l2NativeTokenVault});
+      for (const action of params.actions) {
+        const bytecode = await ctx.dstPublicClient.getCode({ address: action.to });
+        if (!bytecode || bytecode === "0x") {
+          throw createError("VALIDATION", {
+            resource: "interop",
+            operation: OP_INTEROP.routes.direct.preflight,
+            message: `Destination address ${action.to} is not a contract on the destination chain. The receiver must be a contract that implements the IERC7786Recipient interface (receiveMessage).`,
+            context: { to: action.to, action: action.type }
+          });
+        }
+      }
     },
     async build(params, ctx) {
       const steps = [];
@@ -9974,7 +9982,7 @@ async function getBundleStatus(client, dstProvider, topics, bundleHash, opts) {
   }
   return { phase: "SENT" };
 }
-async function executeBundle(client, dstProvider, info, opts) {
+async function executeBundle(client, dstProvider, info, opts, txOverrides) {
   const { topics } = getTopics();
   const { bundleHash, encodedData, proof } = info;
   const dstStatus = await getBundleStatus(client, dstProvider, topics, bundleHash, opts);
@@ -10003,7 +10011,10 @@ async function executeBundle(client, dstProvider, info, opts) {
       functionName: "executeBundle",
       args: [encodedData, proof],
       account: client.account,
-      chain: dstProvider.chain ?? null
+      chain: dstProvider.chain ?? null,
+      gas: txOverrides?.gasLimit,
+      maxFeePerGas: txOverrides?.maxFeePerGas,
+      maxPriorityFeePerGas: txOverrides?.maxPriorityFeePerGas
     });
     return {
       hash,
@@ -10046,6 +10057,68 @@ async function executeBundle(client, dstProvider, info, opts) {
     );
   }
 }
+async function verifyBundle(client, dstProvider, info) {
+  const { interopHandler } = await client.ensureAddresses();
+  const dstWallet = await wrap4(
+    OP_INTEROP.verify,
+    () => viem.createWalletClient({
+      account: client.account,
+      transport: viem.custom(dstProvider.transport),
+      chain: dstProvider.chain
+    }),
+    { message: "Failed to create destination wallet client for verifyBundle." }
+  );
+  try {
+    const hash = await dstWallet.writeContract({
+      address: interopHandler,
+      abi: IInteropHandler_default,
+      functionName: "verifyBundle",
+      args: [info.encodedData, info.proof],
+      account: client.account,
+      chain: dstProvider.chain ?? null
+    });
+    return {
+      hash,
+      wait: async () => {
+        try {
+          const receipt = await dstProvider.waitForTransactionReceipt({ hash });
+          if (receipt.status === "reverted") {
+            throw createError("EXECUTION", {
+              resource: "interop",
+              operation: OP_INTEROP.verify,
+              message: "Interop bundle verification reverted on destination.",
+              context: { txHash: hash }
+            });
+          }
+          return receipt;
+        } catch (e) {
+          if (isZKsyncError(e)) throw e;
+          throw toZKsyncError(
+            "EXECUTION",
+            {
+              resource: "interop",
+              operation: OP_INTEROP.verify,
+              message: "Failed while waiting for verifyBundle transaction on destination.",
+              context: { txHash: hash }
+            },
+            e
+          );
+        }
+      }
+    };
+  } catch (e) {
+    if (isZKsyncError(e)) throw e;
+    throw toZKsyncError(
+      "EXECUTION",
+      {
+        resource: "interop",
+        operation: OP_INTEROP.verify,
+        message: "Failed to send verifyBundle transaction on destination chain."
+      },
+      e
+    );
+  }
+}
 
 // src/core/resources/interop/finalization.ts
 var DEFAULT_POLL_MS = 1e3;
@@ -10398,8 +10471,8 @@ function createInteropFinalizationServices(client) {
     wait(dstProvider, gwProvider, input, opts) {
       return waitForFinalization(client, dstProvider, gwProvider, input, opts);
     },
-    async finalize(dstProvider, info, opts) {
-      const execResult = await executeBundle(client, dstProvider, info, opts);
+    async finalize(dstProvider, info, opts, txOverrides) {
+      const execResult = await executeBundle(client, dstProvider, info, opts, txOverrides);
       await execResult.wait();
       return {
         bundleHash: info.bundleHash,
@@ -10627,22 +10700,47 @@ function createInteropResource(client, config, tokens, contracts, attributes) {
     ctx: { where: "interop.wait" }
   });
   const tryWait = (dstChain, h, opts) => toResult2(OP_INTEROP.tryWait, () => wait(dstChain, h, opts));
-  const finalize = (dstChain, h, opts) => wrap6(
+  const finalize = (dstChain, h, opts, txOverrides) => wrap6(
     OP_INTEROP.finalize,
     async () => {
       const dstProvider = resolveChainRef(dstChain);
       if (isInteropFinalizationInfo(h)) {
-        return svc.finalize(dstProvider, h, opts);
+        return svc.finalize(dstProvider, h, opts, txOverrides);
       }
       const info = await svc.wait(dstProvider, getGwProvider(), h);
-      return svc.finalize(dstProvider, info, opts);
+      return svc.finalize(dstProvider, info, opts, txOverrides);
     },
     {
       message: "Failed to finalize/execute interop bundle on destination.",
       ctx: { where: "interop.finalize" }
     }
   );
-  const tryFinalize = (dstChain, h, opts) => toResult2(OP_INTEROP.tryFinalize, () => finalize(dstChain, h, opts));
+  const tryFinalize = (dstChain, h, opts, txOverrides) => toResult2(
+    OP_INTEROP.tryFinalize,
+    () => finalize(dstChain, h, opts, txOverrides)
+  );
+  const interopGetRoot = (dstChain, rootChainId, batchNumber) => wrap6(
+    OP_INTEROP.svc.status.getRoot,
+    () => getInteropRoot(resolveChainRef(dstChain), rootChainId, batchNumber),
+    {
+      message: "Failed to get interop root from the destination chain.",
+      ctx: { where: "interop.getInteropRoot" }
+    }
+  );
+  const verifyBundle2 = (dstChain, h) => wrap6(
+    OP_INTEROP.verify,
+    async () => {
+      const dstProvider = resolveChainRef(dstChain);
+      const info = isInteropFinalizationInfo(h) ? h : await svc.wait(dstProvider, getGwProvider(), h);
+      const result = await verifyBundle(client, dstProvider, info);
+      await result.wait();
+      return { bundleHash: info.bundleHash, dstExecTxHash: result.hash };
+    },
+    {
+      message: "Failed to verify interop bundle on destination.",
+      ctx: { where: "interop.verifyBundle" }
+    }
+  );
   return {
     quote,
     tryQuote,
@@ -10654,7 +10752,9 @@ function createInteropResource(client, config, tokens, contracts, attributes) {
     wait,
     tryWait,
     finalize,
-    tryFinalize
+    tryFinalize,
+    getInteropRoot: interopGetRoot,
+    verifyBundle: verifyBundle2
   };
 }