@matterlabs/zksync-js 0.0.11 → 0.0.12

package/README.md

@@ -117,6 +117,19 @@ console.log('Deposit complete ✅');
 
 Bug reports, fixes, and new features are welcome! Please read the [contributing guide](.github/CONTRIBUTING.md) to get started.
 
+## 🤖 AI Instruction Map
+
+For AI-assisted contribution workflows:
+
+| Path | Purpose |
+|---|---|
+| [`AGENTS.md`](./AGENTS.md) | Repo-wide policy, boundaries, and required verification rules. |
+| [`llm/`](./llm/) | Canonical contributor contracts (architecture, API gate, testing, release, style). |
+| [`.codex/config.toml`](./.codex/config.toml) | Codex multi-agent registry and role wiring. |
+| [`.codex/agents/`](./.codex/agents/) | Canonical role behavior (`.toml`) for explorer/planner/implementer/reviewer/tester/docs/release/api-sentinel. |
+| [`agents/`](./agents/) | Human-readable role summaries that mirror `.codex/agents` behavior. |
+| [`.agents/skills/`](./.agents/skills/) | Repo-scoped reusable skills for focused workflows (for example API gate, adapter parity, contract interaction patterns). |
+
 ## 📜 License
 
 This project is licensed under the terms of the **MIT License** – see the [LICENSE](LICENSE) file for details.

package/dist/adapters/ethers/client.js

@@ -1,6 +1,6 @@
-export { createEthersClient } from '../../chunk-FXSFLZ6D.js';
-import '../../chunk-N4PR5SVB.js';
-import '../../chunk-USXSAFYA.js';
-import '../../chunk-H3BPVVMN.js';
-import '../../chunk-QFEYV4O3.js';
-import '../../chunk-C3AGOEHR.js';
+export { createEthersClient } from '../../chunk-LWA7LC3N.js';
+import '../../chunk-4PFO3J7W.js';
+import '../../chunk-NBQVHW2N.js';
+import '../../chunk-GMNLOTNG.js';
+import '../../chunk-6CLYCJMV.js';
+import '../../chunk-QQ2OR434.js';

package/dist/adapters/ethers/index.cjs

@@ -48,7 +48,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 = 700000n;
+var SAFE_L1_BRIDGE_GAS = 800000n;
 
 // src/core/utils/addr.ts
 function isAddress(x) {
@@ -7500,6 +7500,8 @@ async function quoteL2BaseCost2(input) {
 }
 
 // src/adapters/ethers/resources/deposits/services/gas.ts
+var DEFAULT_SAFE_NONBASE_L2_GAS_LIMIT = 3000000n;
+var ZERO_L2_TOKEN_ADDRESS = "0x0000000000000000000000000000000000000000";
 async function quoteL1Gas2(input) {
   const { ctx, tx, overrides, fallbackGasLimit } = input;
   const estimator = ethersToGasEstimator(ctx.client.l1);
@@ -7523,24 +7525,24 @@ async function quoteL2Gas2(input) {
     stateOverrides: input.stateOverrides
   });
 }
-async function determineErc20L2Gas(input) {
-  const { ctx, l1Token } = input;
-  const DEFAULT_SAFE_L2_GAS_LIMIT = 3000000n;
+async function determineNonBaseL2Gas(input) {
+  const { ctx, l1Token, route } = input;
+  const fallbackQuote = () => quoteL2Gas2({
+    ctx,
+    route,
+    overrideGasLimit: DEFAULT_SAFE_NONBASE_L2_GAS_LIMIT
+  });
   if (ctx.l2GasLimit != null) {
     return quoteL2Gas2({
       ctx,
-      route: "erc20-nonbase",
+      route,
       overrideGasLimit: ctx.l2GasLimit
     });
   }
   try {
-    const l2TokenAddress = ctx.tokens ? await ctx.tokens.toL2Address(l1Token) : await (await ctx.contracts.l2NativeTokenVault()).l2TokenAddress(l1Token);
-    if (l2TokenAddress === "0x0000000000000000000000000000000000000000") {
-      return quoteL2Gas2({
-        ctx,
-        route: "erc20-nonbase",
-        overrideGasLimit: DEFAULT_SAFE_L2_GAS_LIMIT
-      });
+    const l2TokenAddress = input.knownL2Token ?? (ctx.tokens ? await ctx.tokens.toL2Address(l1Token) : await (await ctx.contracts.l2NativeTokenVault()).l2TokenAddress(l1Token));
+    if (l2TokenAddress === ZERO_L2_TOKEN_ADDRESS) {
+      return fallbackQuote();
     }
     const modelTx = {
       to: input.modelTx?.to ?? ctx.sender,
@@ -7550,26 +7552,34 @@ async function determineErc20L2Gas(input) {
     };
     const gas = await quoteL2Gas2({
       ctx,
-      route: "erc20-nonbase",
+      route,
       l2TxForModeling: modelTx
     });
-    if (!gas) {
-      return quoteL2Gas2({
-        ctx,
-        route: "erc20-nonbase",
-        overrideGasLimit: DEFAULT_SAFE_L2_GAS_LIMIT
-      });
+    if (!gas || gas.gasLimit === 0n) {
+      return fallbackQuote();
     }
     return gas;
   } catch (err) {
-    console.warn("Failed to determine ERC20 L2 gas; defaulting to safe gas limit.", err);
-    return quoteL2Gas2({
-      ctx,
-      route: "erc20-nonbase",
-      overrideGasLimit: DEFAULT_SAFE_L2_GAS_LIMIT
-    });
+    console.warn("Failed to determine non-base deposit L2 gas; defaulting to safe gas limit.", err);
+    return fallbackQuote();
   }
 }
+async function determineErc20L2Gas(input) {
+  return determineNonBaseL2Gas({
+    ...input,
+    route: "erc20-nonbase",
+    knownL2Token: input.ctx.resolvedToken?.l2
+  });
+}
+async function determineEthNonBaseL2Gas(input) {
+  return determineNonBaseL2Gas({
+    ctx: input.ctx,
+    route: "eth-nonbase",
+    l1Token: input.ctx.resolvedToken?.l1 ?? FORMAL_ETH_ADDRESS,
+    knownL2Token: input.ctx.resolvedToken?.l2,
+    modelTx: input.modelTx
+  });
+}
 
 // src/core/resources/deposits/fee.ts
 function buildFeeBreakdown(p) {
@@ -7884,11 +7894,9 @@ function routeEthNonBase() {
         data: "0x",
         value: 0n
       };
-      const l2GasParams = await quoteL2Gas2({
+      const l2GasParams = await determineEthNonBaseL2Gas({
         ctx,
-        route: "eth-nonbase",
-        l2TxForModeling: l2TxModel,
-        overrideGasLimit: ctx.l2GasLimit
+        modelTx: l2TxModel
       });
       if (!l2GasParams) throw new Error("Failed to estimate L2 gas parameters.");
       const baseCost = await quoteL2BaseCost2({ ctx, l2GasLimit: l2GasParams.gasLimit });
@@ -7908,7 +7916,7 @@ function routeEthNonBase() {
       if (allowance < mintValue) {
         approvals.push({ token: baseToken, spender: ctx.l1AssetRouter, amount: mintValue });
         steps.push({
-          key: `approve:${baseToken}`,
+          key: `approve:${baseToken}:${ctx.l1AssetRouter}`,
           kind: "approve",
           description: `Approve base token for fees (mintValue)`,
           tx: {
@@ -9115,7 +9123,7 @@ function createFinalizationServices(client) {
         chainId: BigInt(chainId),
         l2BatchNumber: proof.batchNumber,
         l2MessageIndex: proof.id,
-        l2Sender: L2_ASSET_ROUTER_ADDRESS,
+        l2Sender: parsed.to,
         l2TxNumberInBatch: txIndex,
         message,
         merkleProof: proof.proof