@matterlabs/zksync-js 0.0.13 → 0.0.14

package/dist/adapters/ethers/index.js

@@ -1,9 +1,10 @@
-export { createEthersClient as createClient, createEthersClient } from '../../chunk-R5WRFPK2.js';
-export { buildDirectRequestStruct, createDepositsResource, createEthersSdk, createFinalizationServices, createInteropFinalizationServices, createInteropResource, createTokensResource, createWithdrawalsResource, encodeNativeTokenVaultTransferData, encodeSecondBridgeArgs, encodeSecondBridgeDataV1, encodeSecondBridgeErc20Args, encodeSecondBridgeEthArgs, getL2TransactionHashFromLogs } from '../../chunk-JHO2UQ5F.js';
-export { classifyReadinessFromRevert, createErrorHandlers, decodeRevert, registerErrorAbi, toZKsyncError } from '../../chunk-UDBRUBEK.js';
-import '../../chunk-5L6EYUJB.js';
-import '../../chunk-E3KP7XCG.js';
-import '../../chunk-4S4XDA4N.js';
-import '../../chunk-53MC5BR2.js';
-import '../../chunk-RI73VJSH.js';
-import '../../chunk-QQ2OR434.js';
+export { createEthersClient as createClient, createEthersClient } from '../../chunk-7CAVFIMW.js';
+export { buildDirectRequestStruct, createDepositsResource, createEthersSdk, createFinalizationServices, createInteropFinalizationServices, createInteropResource, createTokensResource, createWithdrawalsResource, encodeNativeTokenVaultTransferData, encodeSecondBridgeArgs, encodeSecondBridgeDataV1, encodeSecondBridgeErc20Args, encodeSecondBridgeEthArgs, getL2TransactionHashFromLogs } from '../../chunk-XKRNLFET.js';
+export { classifyReadinessFromRevert, createErrorHandlers, decodeRevert, registerErrorAbi, toZKsyncError } from '../../chunk-5RRJDPAJ.js';
+import '../../chunk-EOBXYHTZ.js';
+import '../../chunk-3HHUZXSV.js';
+import '../../chunk-BWKWWLY4.js';
+import '../../chunk-HP3EWKJL.js';
+import '../../chunk-DYJKK5FW.js';
+import '../../chunk-JY62QO3W.js';
+import '../../chunk-MT4X5FEO.js';

package/dist/adapters/ethers/resources/deposits/routes/priority.d.ts

@@ -0,0 +1,12 @@
+import { type PriorityTxGasBreakdown } from '../../../../../core/resources/deposits/priority.ts';
+import type { Address } from '../../../../../core/types/primitives';
+export type CanonicalPriorityTxInput = {
+    sender: Address;
+    l2Contract: Address;
+    l2Value: bigint;
+    l2Calldata: `0x${string}`;
+    gasPerPubdata: bigint;
+    factoryDepsHashes?: bigint[];
+};
+export declare function getPriorityTxEncodedLength(input: CanonicalPriorityTxInput): bigint;
+export declare function getPriorityTxGasBreakdown(input: CanonicalPriorityTxInput): PriorityTxGasBreakdown;

package/dist/adapters/ethers/resources/deposits/services/gas.d.ts

@@ -34,8 +34,12 @@ export declare function determineErc20L2Gas(input: {
     ctx: BuildCtx;
     l1Token: Address;
     modelTx?: TransactionRequest;
+    priorityFloorGasLimit?: bigint;
+    undeployedGasLimit?: bigint;
 }): Promise<GasQuote | undefined>;
 export declare function determineEthNonBaseL2Gas(input: {
     ctx: BuildCtx;
     modelTx?: TransactionRequest;
+    priorityFloorGasLimit?: bigint;
+    undeployedGasLimit?: bigint;
 }): Promise<GasQuote | undefined>;

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

@@ -1,45 +1,45 @@
 import type { EthersClient } from '../../client';
 import type { AttributesResource } from '../../../../core/resources/interop/attributes/resource';
-import type { InteropRoute, InteropPlan, InteropQuote, InteropStatus, InteropFinalizationResult } from '../../../../core/types/flows/interop';
+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 } from './routes/types';
 import type { TransactionRequest } from 'ethers';
 import { createInteropFinalizationServices, type InteropFinalizationServices } from './services/finalization';
 import type { LogsQueryOptions } from './services/finalization/data-fetchers';
-import type { InteropParams, InteropHandle, InteropWaitable, InteropFinalizationInfo } from './types';
+import type { ChainRef, InteropConfig } from './types';
 export declare const ROUTES: Record<InteropRoute, InteropRouteStrategy>;
 export interface InteropResource {
-    quote(params: InteropParams): Promise<InteropQuote>;
-    tryQuote(params: InteropParams): Promise<{
+    quote(dstChain: ChainRef, params: InteropParams): Promise<InteropQuote>;
+    tryQuote(dstChain: ChainRef, params: InteropParams): Promise<{
         ok: true;
         value: InteropQuote;
     } | {
         ok: false;
         error: unknown;
     }>;
-    prepare(params: InteropParams): Promise<InteropPlan<TransactionRequest>>;
-    tryPrepare(params: InteropParams): Promise<{
+    prepare(dstChain: ChainRef, params: InteropParams): Promise<InteropPlan<TransactionRequest>>;
+    tryPrepare(dstChain: ChainRef, params: InteropParams): Promise<{
         ok: true;
         value: InteropPlan<TransactionRequest>;
     } | {
         ok: false;
         error: unknown;
     }>;
-    create(params: InteropParams): Promise<InteropHandle<TransactionRequest>>;
-    tryCreate(params: InteropParams): Promise<{
+    create(dstChain: ChainRef, params: InteropParams): Promise<InteropHandle<TransactionRequest>>;
+    tryCreate(dstChain: ChainRef, params: InteropParams): Promise<{
         ok: true;
         value: InteropHandle<TransactionRequest>;
     } | {
         ok: false;
         error: unknown;
     }>;
-    status(h: InteropWaitable, opts?: LogsQueryOptions): Promise<InteropStatus>;
-    wait(h: InteropWaitable, opts?: {
+    status(dstChain: ChainRef, h: InteropWaitable, opts?: LogsQueryOptions): Promise<InteropStatus>;
+    wait(dstChain: ChainRef, h: InteropWaitable, opts?: {
         pollMs?: number;
         timeoutMs?: number;
     }): Promise<InteropFinalizationInfo>;
-    tryWait(h: InteropWaitable, opts?: {
+    tryWait(dstChain: ChainRef, h: InteropWaitable, opts?: {
         pollMs?: number;
         timeoutMs?: number;
     }): Promise<{
@@ -49,8 +49,8 @@ export interface InteropResource {
         ok: false;
         error: unknown;
     }>;
-    finalize(h: InteropWaitable | InteropFinalizationInfo, opts?: LogsQueryOptions): Promise<InteropFinalizationResult>;
-    tryFinalize(h: InteropWaitable | InteropFinalizationInfo, opts?: LogsQueryOptions): Promise<{
+    finalize(dstChain: ChainRef, h: InteropWaitable | InteropFinalizationInfo, opts?: LogsQueryOptions): Promise<InteropFinalizationResult>;
+    tryFinalize(dstChain: ChainRef, h: InteropWaitable | InteropFinalizationInfo, opts?: LogsQueryOptions): Promise<{
         ok: true;
         value: InteropFinalizationResult;
     } | {
@@ -58,6 +58,6 @@ export interface InteropResource {
         error: unknown;
     }>;
 }
-export declare function createInteropResource(client: EthersClient, tokens?: TokensResource, contracts?: ContractsResource, attributes?: AttributesResource): InteropResource;
+export declare function createInteropResource(client: EthersClient, config?: InteropConfig, tokens?: TokensResource, contracts?: ContractsResource, attributes?: AttributesResource): InteropResource;
 export { createInteropFinalizationServices };
 export type { InteropFinalizationServices };

package/dist/adapters/ethers/resources/interop/resolvers.d.ts

@@ -1,9 +1,4 @@
 import { type AbstractProvider } from 'ethers';
-import type { InteropWaitable as InteropWaitableBase } from '../../../../core/types/flows/interop';
-import type { DstChain, InteropWaitable } from './types';
-/** Resolve a destination chain input (URL string or provider) into an AbstractProvider. */
-export declare function resolveDstProvider(dstChain: DstChain): AbstractProvider;
-export declare function resolveWaitableInput(waitableInput: InteropWaitable): {
-    dstProvider: AbstractProvider;
-    waitable: InteropWaitableBase;
-};
+import type { ChainRef } from './types';
+/** Resolve a chain ref (URL string or provider) into an AbstractProvider. */
+export declare function resolveChainRef(ref: ChainRef): AbstractProvider;

package/dist/adapters/ethers/resources/interop/routes/types.d.ts

@@ -2,12 +2,13 @@ import type { TransactionRequest } from 'ethers';
 import type { InteropParams } from '../../../../../core/types/flows/interop';
 import type { BuildCtx } from '../context';
 import type { PlanStep, ApprovalNeed } from '../../../../../core/types/flows/base';
-import type { QuoteExtras } from '../../../../../core/types/flows/interop';
+import type { QuoteExtras, InteropFee } from '../../../../../core/types/flows/interop';
 export interface InteropRouteStrategy {
     preflight(params: InteropParams, ctx: BuildCtx): Promise<void>;
     build(params: InteropParams, ctx: BuildCtx): Promise<{
         steps: Array<PlanStep<TransactionRequest>>;
         approvals: ApprovalNeed[];
         quoteExtras: QuoteExtras;
+        interopFee: InteropFee;
     }>;
 }

package/dist/adapters/ethers/resources/interop/services/erc20.d.ts

@@ -1,6 +1,7 @@
 import { type TransactionRequest } from 'ethers';
 import type { Address, Hex } from '../../../../../core/types/primitives';
 import type { InteropParams } from '../../../../../core/types/flows/interop';
+import type { ApprovalNeed } from '../../../../../core/types/flows/base';
 import type { BuildCtx } from '../context';
 /** Collect unique ERC-20 token addresses referenced by `sendErc20` actions. */
 export declare function getErc20Tokens(params: InteropParams): Address[];
@@ -11,5 +12,14 @@ export declare function buildEnsureTokenSteps(erc20Tokens: Address[], ctx: Build
     description: string;
     tx: TransactionRequest;
 }>;
+/**
+ * Check allowance for each approval and return approve steps only where needed.
+ */
+export declare function buildApproveSteps(approvals: ApprovalNeed[], ctx: BuildCtx): Promise<Array<{
+    key: string;
+    kind: string;
+    description: string;
+    tx: TransactionRequest;
+}>>;
 /** Resolve asset IDs for each ERC-20 token via a static-call to NTV. */
 export declare function resolveErc20AssetIds(erc20Tokens: Address[], ctx: BuildCtx): Promise<Map<string, Hex>>;

package/dist/adapters/ethers/resources/interop/services/fee.d.ts

@@ -0,0 +1,12 @@
+import type { InteropParams } from '../../../../../core/types/flows/interop';
+import type { BuildCtx } from '../context';
+import type { InteropFeeInfo } from '../../../../../core/resources/interop/plan';
+/**
+ * Resolve fee information for a bundle.
+ *
+ * - useFixed=false (default when fees is unset): reads interopProtocolFee and
+ *   returns the total as fee.value so the caller can add it to the sendBundle msg.value.
+ * - useFixed=true: reads ZK_INTEROP_FEE and zkToken address, returns an
+ *   ApprovalNeed for the ZK token. The route handles the allowance check.
+ */
+export declare function buildFeeInfo(params: InteropParams, ctx: BuildCtx, numStarters: number): Promise<InteropFeeInfo>;

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

@@ -4,7 +4,7 @@ import type { EthersClient } from '../../../../client';
 import type { LogsQueryOptions } from './data-fetchers';
 export interface InteropFinalizationServices {
     status(dstProvider: AbstractProvider, input: InteropWaitable, opts?: LogsQueryOptions): Promise<InteropStatus>;
-    wait(dstProvider: AbstractProvider, input: InteropWaitable, opts?: {
+    wait(dstProvider: AbstractProvider, gwProvider: AbstractProvider, input: InteropWaitable, opts?: {
         pollMs?: number;
         timeoutMs?: number;
     }): Promise<InteropFinalizationInfo>;

package/dist/adapters/ethers/resources/interop/services/finalization/polling.d.ts

@@ -1,7 +1,7 @@
 import type { AbstractProvider } from 'ethers';
 import type { InteropWaitable, InteropFinalizationInfo } from '../../../../../../core/types/flows/interop';
 import type { EthersClient } from '../../../../client';
-export declare function waitForFinalization(client: EthersClient, dstProvider: AbstractProvider, input: InteropWaitable, opts?: {
+export declare function waitForFinalization(client: EthersClient, dstProvider: AbstractProvider, gwProvider: AbstractProvider, input: InteropWaitable, opts?: {
     pollMs?: number;
     timeoutMs?: number;
 }): Promise<InteropFinalizationInfo>;

package/dist/adapters/ethers/resources/interop/types.d.ts

@@ -1,16 +1,8 @@
 import type { AbstractProvider } from 'ethers';
-import type { InteropParams as InteropParamsBase, InteropHandle as InteropHandleBase, InteropWaitable as InteropWaitableBase, InteropFinalizationInfo as InteropFinalizationInfoBase } from '../../../../core/types/flows/interop';
-export type DstChain = string | AbstractProvider;
-export interface InteropParams extends InteropParamsBase {
-    dstChain: DstChain;
+/** String URL or live provider — used only in resource/SDK config. */
+export type ChainRef = string | AbstractProvider;
+/** One-time configuration for the interop resource. */
+export interface InteropConfig {
+    /** Gateway chain — used to fetch GW chain ID for interop root polling. */
+    gwChain: ChainRef;
 }
-export interface InteropHandle<Tx> extends InteropHandleBase<Tx> {
-    dstChain: DstChain;
-}
-export interface InteropFinalizationInfo extends InteropFinalizationInfoBase {
-    dstChain: DstChain;
-}
-export type InteropWaitable = InteropHandle<unknown> | {
-    dstChain: DstChain;
-    waitable: InteropWaitableBase;
-};