@matterlabs/zksync-js 0.0.1 → 0.0.3

package/dist/{chunk-CGO27P7F.js → chunk-5YWP4CZP.js}

@@ -1,8 +1,8 @@
-import { assertNoLegacyGas, assertPriorityFeeBounds, REVERT_TO_READINESS } from './chunk-263G6636.js';
-import { findL1MessageSentLog, messengerLogIndex, isAddressEq, isHash66, pickDepositRoute, isETH, normalizeAddrEq, pickWithdrawRoute } from './chunk-DI2CJDPZ.js';
-import { IL1Nullifier_default, IERC20_default, L1NativeTokenVault_default, L2NativeTokenVault_default, Mailbox_default, IBridgehub_default, IL2AssetRouter_default, IBaseToken_default } from './chunk-Y75OMFK6.js';
-import { isZKsyncError, createError, shapeCause, OP_WITHDRAWALS, OP_DEPOSITS, isReceiptNotFound } from './chunk-B77GWPO5.js';
-import { ETH_ADDRESS, L2_NATIVE_TOKEN_VAULT_ADDRESS, L1_FEE_ESTIMATION_COEF_NUMERATOR, L1_FEE_ESTIMATION_COEF_DENOMINATOR, L1_MESSENGER_ADDRESS, L2_ASSET_ROUTER_ADDRESS, FORMAL_ETH_ADDRESS, L2_BASE_TOKEN_ADDRESS, TOPIC_CANONICAL_ASSIGNED, TOPIC_CANONICAL_SUCCESS } from './chunk-6GCT6TLS.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 { createErrorHandlers, toZKsyncError, classifyReadinessFromRevert } from './chunk-XRE7H466.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 { Interface, AbiCoder, ethers, Contract, NonceManager } from 'ethers';
 
 var I_BRIDGEHUB = new Interface([
@@ -68,105 +68,67 @@ async function waitForL2ExecutionFromL1Tx(l1, l2, l1TxHash) {
   }
   return { l2Receipt, l2TxHash };
 }
-function supportsGetGasPrice(provider) {
-  return typeof provider === "object" && provider !== null && typeof provider.getGasPrice === "function";
-}
-function encodeNativeTokenVaultAssetId(chainId, address) {
-  const abi = new AbiCoder();
-  const hex = abi.encode(
-    ["uint256", "address", "address"],
-    [chainId, L2_NATIVE_TOKEN_VAULT_ADDRESS, address]
-  );
-  return ethers.keccak256(hex);
+
+// src/adapters/ethers/resources/deposits/context.ts
+async function commonCtx(p, client, tokens, contracts) {
+  const { bridgehub, l1AssetRouter } = await contracts.addresses();
+  const { chainId } = await client.l2.getNetwork();
+  const sender = await client.signer.getAddress();
+  const gasPerPubdata = p.gasPerPubdata ?? 800n;
+  const operatorTip = p.operatorTip ?? 0n;
+  const refundRecipient = p.refundRecipient ?? sender;
+  const resolvedToken = await tokens.resolve(p.token, { chain: "l1" });
+  const baseTokenAssetId = resolvedToken.baseTokenAssetId;
+  const baseTokenL1 = await tokens.l1TokenFromAssetId(baseTokenAssetId);
+  const baseIsEth = resolvedToken.isChainEthBased;
+  const route = (() => {
+    if (resolvedToken.kind === "eth") {
+      return baseIsEth ? "eth-base" : "eth-nonbase";
+    }
+    if (resolvedToken.kind === "base") {
+      return baseIsEth ? "eth-base" : "erc20-base";
+    }
+    return "erc20-nonbase";
+  })();
+  return {
+    client,
+    tokens,
+    contracts,
+    resolvedToken,
+    baseTokenAssetId,
+    baseTokenL1,
+    baseIsEth,
+    l1AssetRouter,
+    route,
+    bridgehub,
+    chainIdL2: BigInt(chainId),
+    sender,
+    gasOverrides: p.l1TxOverrides,
+    l2GasLimit: p.l2GasLimit,
+    gasPerPubdata,
+    operatorTip,
+    refundRecipient
+  };
 }
 function encodeNativeTokenVaultTransferData(amount, receiver, token) {
   return new AbiCoder().encode(["uint256", "address", "address"], [amount, receiver, token]);
 }
 function encodeSecondBridgeDataV1(assetId, transferData) {
-  const abi = new AbiCoder();
-  const data = abi.encode(["bytes32", "bytes"], [assetId, transferData]);
+  const abi2 = new AbiCoder();
+  const data = abi2.encode(["bytes32", "bytes"], [assetId, transferData]);
   return ethers.concat(["0x01", data]);
 }
-function encodeNTVAssetId(chainId, address) {
-  const abi = new AbiCoder();
-  const hex = abi.encode(
-    ["uint256", "address", "address"],
-    [chainId, L2_NATIVE_TOKEN_VAULT_ADDRESS, address]
+function encodeSecondBridgeArgs(token, amount, l2Receiver) {
+  return AbiCoder.defaultAbiCoder().encode(
+    ["address", "uint256", "address"],
+    [token, amount, l2Receiver]
   );
-  return ethers.keccak256(hex);
-}
-function encodeNTVTransferData(amount, receiver, token) {
-  return new AbiCoder().encode(["uint256", "address", "address"], [amount, receiver, token]);
 }
-function scaleGasLimit(gasLimit) {
-  return gasLimit * BigInt(L1_FEE_ESTIMATION_COEF_NUMERATOR) / BigInt(L1_FEE_ESTIMATION_COEF_DENOMINATOR);
-}
-async function checkBaseCost(baseCost, value) {
-  const resolvedValue = await value;
-  if (baseCost > resolvedValue) {
-    throw new Error(
-      `The base cost of performing the priority operation is higher than the provided value parameter for the transaction: baseCost: ${String(baseCost)}, provided value: ${String(resolvedValue)}!`
-    );
-  }
-}
-async function getFeeOverrides(client, overrides) {
-  assertNoLegacyGas(overrides);
-  const fd = await client.l1.getFeeData();
-  const maxFeeFromProvider = fd.maxFeePerGas ?? void 0;
-  const maxPriorityFromProvider = fd.maxPriorityFeePerGas ?? void 0;
-  const gasPriceFallback = fd.gasPrice ?? void 0;
-  const maxFeePerGas = overrides?.maxFeePerGas ?? maxFeeFromProvider ?? gasPriceFallback;
-  if (maxFeePerGas == null) throw new Error("provider returned no gas price data");
-  const maxPriorityFeePerGas = overrides?.maxPriorityFeePerGas ?? maxPriorityFromProvider ?? maxFeePerGas;
-  assertPriorityFeeBounds({ maxFeePerGas, maxPriorityFeePerGas });
-  const gasPriceForBaseCost = overrides?.maxFeePerGas ?? maxFeeFromProvider ?? gasPriceFallback ?? maxFeePerGas;
-  return {
-    gasLimit: overrides?.gasLimit,
-    maxFeePerGas,
-    maxPriorityFeePerGas,
-    gasPriceForBaseCost
-  };
-}
-async function getL2FeeOverrides(client, overrides) {
-  assertNoLegacyGas(overrides);
-  let maxFeeFromProvider;
-  let maxPriorityFromProvider;
-  let gasPriceFallback;
-  try {
-    const fd = await client.l2.getFeeData();
-    if (fd?.maxFeePerGas != null) maxFeeFromProvider = fd.maxFeePerGas;
-    if (fd?.maxPriorityFeePerGas != null) {
-      maxPriorityFromProvider = fd.maxPriorityFeePerGas;
-    }
-    if (fd?.gasPrice != null) gasPriceFallback = fd.gasPrice;
-  } catch {
-  }
-  if (gasPriceFallback == null) {
-    try {
-      if (supportsGetGasPrice(client.l2)) {
-        const gp = await client.l2.getGasPrice();
-        gasPriceFallback = typeof gp === "bigint" ? gp : BigInt(gp.toString());
-      }
-    } catch {
-    }
-  }
-  const maxFeePerGas = overrides?.maxFeePerGas ?? maxFeeFromProvider ?? gasPriceFallback;
-  if (maxFeePerGas == null) {
-    throw new Error("L2 provider returned no gas price data");
-  }
-  const maxPriorityFeePerGas = overrides?.maxPriorityFeePerGas ?? maxPriorityFromProvider ?? maxFeePerGas;
-  assertPriorityFeeBounds({ maxFeePerGas, maxPriorityFeePerGas });
-  return {
-    gasLimit: overrides?.gasLimit,
-    maxFeePerGas,
-    maxPriorityFeePerGas
-  };
+function encodeSecondBridgeErc20Args(token, amount, l2Receiver) {
+  return encodeSecondBridgeArgs(token, amount, l2Receiver);
 }
-async function getGasPriceWei(client) {
-  const fd = await client.l1.getFeeData();
-  if (fd.gasPrice != null) return fd.gasPrice;
-  if (fd.maxFeePerGas != null) return fd.maxFeePerGas;
-  throw new Error("provider returned no gas price data");
+function encodeSecondBridgeEthArgs(amount, l2Receiver, ethToken = ETH_ADDRESS) {
+  return encodeSecondBridgeArgs(ethToken, amount, l2Receiver);
 }
 function buildDirectRequestStruct(args) {
   return {
@@ -181,352 +143,310 @@ function buildDirectRequestStruct(args) {
     refundRecipient: args.refundRecipient
   };
 }
-function encodeSecondBridgeArgs(token, amount, l2Receiver) {
-  return AbiCoder.defaultAbiCoder().encode(
-    ["address", "uint256", "address"],
-    [token, amount, l2Receiver]
-  );
-}
-function encodeSecondBridgeErc20Args(token, amount, l2Receiver) {
-  return encodeSecondBridgeArgs(token, amount, l2Receiver);
-}
-function encodeSecondBridgeEthArgs(amount, l2Receiver, ethToken = ETH_ADDRESS) {
-  return encodeSecondBridgeArgs(ethToken, amount, l2Receiver);
-}
 
-// src/adapters/ethers/resources/deposits/context.ts
-async function commonCtx(p, client) {
-  const { bridgehub, l1AssetRouter } = await client.ensureAddresses();
-  const { chainId } = await client.l2.getNetwork();
-  const sender = await client.signer.getAddress();
-  const fee = await getFeeOverrides(client, p.l1TxOverrides);
-  const l2GasLimit = p.l2GasLimit ?? 300000n;
-  const gasPerPubdata = p.gasPerPubdata ?? 800n;
-  const operatorTip = p.operatorTip ?? 0n;
-  const refundRecipient = p.refundRecipient ?? sender;
-  const route = await pickDepositRoute(client, BigInt(chainId), p.token);
+// src/adapters/ethers/estimator.ts
+function toCoreTx(tx) {
   return {
-    client,
-    l1AssetRouter,
-    route,
-    bridgehub,
-    chainIdL2: BigInt(chainId),
-    sender,
-    fee,
-    l2GasLimit,
-    gasPerPubdata,
-    operatorTip,
-    refundRecipient
+    to: tx.to,
+    from: tx.from,
+    data: tx.data,
+    value: tx.value ? BigInt(tx.value) : void 0,
+    gasLimit: tx.gasLimit ? BigInt(tx.gasLimit) : void 0,
+    maxFeePerGas: tx.maxFeePerGas ? BigInt(tx.maxFeePerGas) : void 0,
+    maxPriorityFeePerGas: tx.maxPriorityFeePerGas ? BigInt(tx.maxPriorityFeePerGas) : void 0
   };
 }
-var ERROR_IFACES = [];
-var IFACE_ERROR_STRING = new Interface(["error Error(string)"]);
-var IFACE_PANIC = new Interface(["error Panic(uint256)"]);
-(function bootstrapDefaultIfaces() {
-  try {
-    ERROR_IFACES.push({
-      name: "IL1Nullifier",
-      iface: new Interface(IL1Nullifier_default)
-    });
-  } catch {
-  }
-  try {
-    ERROR_IFACES.push({ name: "IERC20", iface: new Interface(IERC20_default) });
-  } catch {
-  }
-  try {
-    ERROR_IFACES.push({
-      name: "IL1NativeTokenVault",
-      iface: new Interface(L1NativeTokenVault_default)
-    });
-  } catch {
-  }
-  try {
-    ERROR_IFACES.push({
-      name: "IL2NativeTokenVault",
-      iface: new Interface(L2NativeTokenVault_default)
-    });
-  } catch {
-  }
-  try {
-    ERROR_IFACES.push({ name: "Mailbox", iface: new Interface(Mailbox_default) });
-  } catch {
-  }
-})();
-function registerErrorAbi(name, abi) {
-  const existing = ERROR_IFACES.findIndex((x) => x.name === name);
-  const entry = { name, iface: new Interface(abi) };
-  if (existing >= 0) ERROR_IFACES[existing] = entry;
-  else ERROR_IFACES.push(entry);
-}
-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
-        };
+function ethersToGasEstimator(provider) {
+  return {
+    async estimateGas(tx, stateOverrides) {
+      const ethTx = {
+        to: tx.to,
+        from: tx.from,
+        data: tx.data,
+        value: tx.value,
+        gasLimit: tx.gasLimit,
+        maxFeePerGas: tx.maxFeePerGas,
+        maxPriorityFeePerGas: tx.maxPriorityFeePerGas
+      };
+      if (stateOverrides && "send" in provider) {
+        try {
+          const jsonRpcProvider = provider;
+          const result = await jsonRpcProvider.send("eth_estimateGas", [
+            ethTx,
+            "latest",
+            stateOverrides
+          ]);
+          return BigInt(result);
+        } catch (error) {
+          console.warn(
+            "Failed to estimate gas with state overrides, falling back to standard estimation:",
+            error
+          );
+        }
+      } else if (stateOverrides) {
+        console.warn('Provider does not support "send", skipping state overrides estimation.');
       }
-    } catch {
+      return await provider.estimateGas(ethTx);
+    },
+    async estimateFeesPerGas() {
+      const fd = await provider.getFeeData();
+      return {
+        maxFeePerGas: fd.maxFeePerGas != null ? BigInt(fd.maxFeePerGas) : void 0,
+        maxPriorityFeePerGas: fd.maxPriorityFeePerGas != null ? BigInt(fd.maxPriorityFeePerGas) : void 0,
+        gasPrice: fd.gasPrice != null ? BigInt(fd.gasPrice) : void 0
+      };
+    },
+    async getGasPrice() {
+      const fd = await provider.getFeeData();
+      if (fd.gasPrice != null) return BigInt(fd.gasPrice);
+      throw new Error("Could not fetch gas price");
+    },
+    async call(tx) {
+      const ethTx = {
+        to: tx.to,
+        data: tx.data,
+        value: tx.value,
+        from: tx.from
+      };
+      return await provider.call(ethTx);
     }
-  }
-  return { selector };
+  };
 }
-function classifyReadinessFromRevert(e) {
-  const r = decodeRevert(e);
-  const name = r?.name;
-  if (name && REVERT_TO_READINESS[name]) return REVERT_TO_READINESS[name];
-  const msg = (() => {
-    if (typeof e !== "object" || e === null) return "";
-    const obj = e;
-    const maybeMsg = obj["shortMessage"] ?? obj["message"];
-    return typeof maybeMsg === "string" ? maybeMsg : "";
-  })();
-  const lower = String(msg).toLowerCase();
-  if (lower.includes("paused")) return { kind: "NOT_READY", reason: "paused" };
-  if (name || r?.selector) {
-    return { kind: "UNFINALIZABLE", reason: "unsupported", detail: name ?? r?.selector };
-  }
-  return { kind: "NOT_READY", reason: "unknown", detail: lower || void 0 };
+
+// src/adapters/ethers/resources/deposits/services/fee.ts
+var { wrapAs } = createErrorHandlers("deposits");
+var encode = (abi2, fn, args) => {
+  return new Interface(abi2).encodeFunctionData(fn, args);
+};
+async function quoteL2BaseCost2(input) {
+  const { ctx, l2GasLimit } = input;
+  const estimator = ethersToGasEstimator(ctx.client.l1);
+  return wrapAs(
+    "RPC",
+    "deposits.fees.l2BaseCost",
+    () => quoteL2BaseCost({
+      estimator,
+      encode,
+      bridgehub: ctx.bridgehub,
+      chainIdL2: ctx.chainIdL2,
+      l2GasLimit,
+      gasPerPubdata: ctx.gasPerPubdata
+    }),
+    { ctx: { chainIdL2: ctx.chainIdL2 } }
+  );
 }
 
-// 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) });
+// src/adapters/ethers/resources/deposits/services/gas.ts
+async function quoteL1Gas2(input) {
+  const { ctx, tx, overrides, fallbackGasLimit } = input;
+  const estimator = ethersToGasEstimator(ctx.client.l1);
+  return quoteL1Gas({
+    estimator,
+    tx: toCoreTx(tx),
+    overrides,
+    fallbackGasLimit
+  });
 }
-function resolveMessage(op, msg) {
-  if (!msg) return `Error during ${op}.`;
-  return typeof msg === "function" ? msg() : msg;
+async function quoteL2Gas3(input) {
+  const { ctx, route, l2TxForModeling, overrideGasLimit } = input;
+  const estimator = ethersToGasEstimator(ctx.client.l2);
+  return quoteL2Gas({
+    estimator,
+    route,
+    tx: l2TxForModeling ? toCoreTx(l2TxForModeling) : void 0,
+    gasPerPubdata: ctx.gasPerPubdata,
+    l2GasLimit: ctx.l2GasLimit,
+    overrideGasLimit,
+    stateOverrides: input.stateOverrides
+  });
 }
-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 wrapAs9(kind, operation, fn, opts) {
-    return run(kind, operation, fn, opts);
+async function determineErc20L2Gas(input) {
+  const { ctx, l1Token } = input;
+  const DEFAULT_SAFE_L2_GAS_LIMIT = 3000000n;
+  if (ctx.l2GasLimit != null) {
+    return quoteL2Gas3({
+      ctx,
+      route: "erc20-nonbase",
+      overrideGasLimit: ctx.l2GasLimit
+    });
   }
-  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 };
+  try {
+    const l2TokenAddress = ctx.tokens ? await ctx.tokens.toL2Address(l1Token) : await (await ctx.contracts.l2NativeTokenVault()).l2TokenAddress(l1Token);
+    if (l2TokenAddress === "0x0000000000000000000000000000000000000000") {
+      return quoteL2Gas3({
+        ctx,
+        route: "erc20-nonbase",
+        overrideGasLimit: DEFAULT_SAFE_L2_GAS_LIMIT
+      });
     }
+    const modelTx = {
+      to: input.modelTx?.to ?? ctx.sender,
+      from: input.modelTx?.from ?? ctx.sender,
+      data: input.modelTx?.data ?? "0x",
+      value: input.modelTx?.value ?? 0n
+    };
+    const gas = await quoteL2Gas3({
+      ctx,
+      route: "erc20-nonbase",
+      l2TxForModeling: modelTx
+    });
+    if (!gas) {
+      return quoteL2Gas3({
+        ctx,
+        route: "erc20-nonbase",
+        overrideGasLimit: DEFAULT_SAFE_L2_GAS_LIMIT
+      });
+    }
+    return gas;
+  } catch (err) {
+    console.warn("Failed to determine ERC20 L2 gas; defaulting to safe gas limit.", err);
+    return quoteL2Gas3({
+      ctx,
+      route: "erc20-nonbase",
+      overrideGasLimit: DEFAULT_SAFE_L2_GAS_LIMIT
+    });
   }
-  return { wrap: wrap2, wrapAs: wrapAs9, toResult: toResult2 };
 }
 
 // src/adapters/ethers/resources/deposits/routes/eth.ts
-var { wrapAs } = createErrorHandlers("deposits");
 function routeEthDirect() {
   return {
     async build(p, ctx) {
-      const bh = new Contract(ctx.bridgehub, IBridgehub_default, ctx.client.l1);
-      const { gasPriceForBaseCost, gasLimit: overrideGasLimit, ...txFeeOverrides } = ctx.fee;
-      const rawBaseCost = await wrapAs(
-        "CONTRACT",
-        OP_DEPOSITS.eth.baseCost,
-        () => bh.l2TransactionBaseCost(
-          ctx.chainIdL2,
-          gasPriceForBaseCost,
-          ctx.l2GasLimit,
-          ctx.gasPerPubdata
-        ),
-        {
-          ctx: { where: "l2TransactionBaseCost", chainIdL2: ctx.chainIdL2 },
-          message: "Could not fetch L2 base cost from Bridgehub."
+      const bh = await ctx.contracts.bridgehub();
+      const l2TxModel = {
+        to: p.to ?? ctx.sender,
+        from: ctx.sender,
+        data: "0x",
+        value: 0n
+      };
+      const l2GasParams = await quoteL2Gas3({
+        ctx,
+        route: "eth-base",
+        l2TxForModeling: l2TxModel,
+        overrideGasLimit: ctx.l2GasLimit,
+        stateOverrides: {
+          [ctx.sender]: {
+            balance: "0xffffffffffffffffffff"
+          }
         }
-      );
-      const baseCost = BigInt(rawBaseCost);
-      const l2Contract = p.to ?? ctx.sender;
-      const l2Value = p.amount;
-      const mintValue = baseCost + ctx.operatorTip + l2Value;
+      });
+      if (!l2GasParams) {
+        throw new Error("Failed to estimate L2 gas for deposit.");
+      }
+      const baseCost = await quoteL2BaseCost2({ ctx, l2GasLimit: l2GasParams.gasLimit });
+      const mintValue = baseCost + ctx.operatorTip + p.amount;
       const req = buildDirectRequestStruct({
         chainId: ctx.chainIdL2,
         mintValue,
-        l2GasLimit: ctx.l2GasLimit,
+        l2GasLimit: l2GasParams.gasLimit,
         gasPerPubdata: ctx.gasPerPubdata,
         refundRecipient: ctx.refundRecipient,
-        l2Contract,
-        l2Value
+        l2Contract: p.to ?? ctx.sender,
+        l2Value: p.amount
       });
       const data = bh.interface.encodeFunctionData("requestL2TransactionDirect", [req]);
-      let resolvedL1GasLimit = overrideGasLimit ?? ctx.l2GasLimit;
-      const tx = {
+      const l1TxCandidate = {
         to: ctx.bridgehub,
         data,
         value: mintValue,
         from: ctx.sender,
-        ...txFeeOverrides
+        ...ctx.gasOverrides
       };
-      if (overrideGasLimit != null) {
-        tx.gasLimit = overrideGasLimit;
-        resolvedL1GasLimit = overrideGasLimit;
-      } else {
-        try {
-          const est = await wrapAs(
-            "RPC",
-            OP_DEPOSITS.eth.estGas,
-            () => ctx.client.l1.estimateGas(tx),
-            {
-              ctx: { where: "l1.estimateGas", to: ctx.bridgehub },
-              message: "Failed to estimate gas for Bridgehub request."
-            }
-          );
-          const buffered = BigInt(est) * 115n / 100n;
-          tx.gasLimit = buffered;
-          resolvedL1GasLimit = buffered;
-        } catch {
-        }
+      const l1GasParams = await quoteL1Gas2({
+        ctx,
+        tx: l1TxCandidate,
+        overrides: ctx.gasOverrides
+      });
+      if (l1GasParams) {
+        l1TxCandidate.gasLimit = l1GasParams.gasLimit;
+        l1TxCandidate.maxFeePerGas = l1GasParams.maxFeePerGas;
+        l1TxCandidate.maxPriorityFeePerGas = l1GasParams.maxPriorityFeePerGas;
       }
       const steps = [
         {
           key: "bridgehub:direct",
           kind: "bridgehub:direct",
           description: "Bridge ETH via Bridgehub.requestL2TransactionDirect",
-          tx
+          tx: l1TxCandidate
         }
       ];
+      const fees = buildFeeBreakdown({
+        feeToken: ETH_ADDRESS,
+        l1Gas: l1GasParams,
+        l2Gas: l2GasParams,
+        l2BaseCost: baseCost,
+        operatorTip: ctx.operatorTip,
+        mintValue
+      });
       return {
         steps,
         approvals: [],
-        quoteExtras: { baseCost, mintValue, l1GasLimit: resolvedL1GasLimit }
+        fees
       };
     }
   };
 }
 var { wrapAs: wrapAs2 } = createErrorHandlers("deposits");
-var MIN_L2_GAS_FOR_ERC20 = 2500000n;
 function routeErc20NonBase() {
   return {
-    async preflight() {
-    },
-    async build(p, ctx) {
-      const bh = new Contract(ctx.bridgehub, IBridgehub_default, ctx.client.l1);
-      const assetRouter = ctx.l1AssetRouter;
-      const { gasPriceForBaseCost, gasLimit: overrideGasLimit, ...txFeeOverrides } = ctx.fee;
-      const txOverrides = overrideGasLimit != null ? { ...txFeeOverrides, gasLimit: overrideGasLimit } : txFeeOverrides;
-      let resolvedL1GasLimit = overrideGasLimit ?? ctx.l2GasLimit;
-      const baseToken = await wrapAs2(
-        "CONTRACT",
-        OP_DEPOSITS.nonbase.baseToken ?? "deposits.erc20-nonbase:baseToken",
-        () => bh.baseToken(ctx.chainIdL2),
-        {
-          ctx: { where: "bridgehub.baseToken", chainIdL2: ctx.chainIdL2 },
-          message: "Failed to read base token."
-        }
-      );
+    async preflight(p, ctx) {
+      const resolved = ctx.resolvedToken ?? (ctx.tokens ? await ctx.tokens.resolve(p.token, { chain: "l1" }) : void 0);
+      const baseToken = ctx.baseTokenL1 ?? await ctx.client.baseToken(ctx.chainIdL2);
       await wrapAs2(
         "VALIDATION",
         OP_DEPOSITS.nonbase.assertNonBaseToken,
         () => {
-          if (normalizeAddrEq(baseToken, p.token)) {
+          if (resolved?.kind === "base" || resolved?.kind === "eth") {
             throw new Error("erc20-nonbase route requires a non-base ERC-20 deposit token.");
           }
         },
         { ctx: { depositToken: p.token, baseToken } }
       );
-      const l2GasLimitUsed = ctx.l2GasLimit && ctx.l2GasLimit > 0n ? ctx.l2GasLimit < MIN_L2_GAS_FOR_ERC20 ? MIN_L2_GAS_FOR_ERC20 : ctx.l2GasLimit : MIN_L2_GAS_FOR_ERC20;
-      const rawBaseCost = await wrapAs2(
-        "RPC",
-        OP_DEPOSITS.nonbase.baseCost,
-        () => bh.l2TransactionBaseCost(
-          ctx.chainIdL2,
-          gasPriceForBaseCost,
-          l2GasLimitUsed,
-          ctx.gasPerPubdata
-        ),
-        {
-          ctx: { where: "l2TransactionBaseCost", chainIdL2: ctx.chainIdL2 },
-          message: "Could not fetch L2 base cost from Bridgehub."
+    },
+    async build(p, ctx) {
+      const l1Signer = ctx.client.getL1Signer();
+      const baseToken = ctx.baseTokenL1 ?? await ctx.client.baseToken(ctx.chainIdL2);
+      const baseIsEth = ctx.baseIsEth ?? isETH(baseToken);
+      const l2GasParams = await determineErc20L2Gas({
+        ctx,
+        l1Token: p.token,
+        modelTx: {
+          to: p.to ?? ctx.sender,
+          from: ctx.sender,
+          data: "0x",
+          value: 0n
         }
-      );
-      const baseCost = BigInt(rawBaseCost);
+      });
+      if (!l2GasParams) throw new Error("Failed to establish L2 gas parameters.");
+      const baseCost = await quoteL2BaseCost2({ ctx, l2GasLimit: l2GasParams.gasLimit });
       const mintValue = baseCost + ctx.operatorTip;
       const approvals = [];
       const steps = [];
-      const l1Signer = ctx.client.getL1Signer();
-      {
-        const erc20Deposit = new Contract(p.token, IERC20_default, l1Signer);
-        const allowanceToken = await wrapAs2(
-          "RPC",
-          OP_DEPOSITS.nonbase.allowanceToken,
-          () => erc20Deposit.allowance(ctx.sender, assetRouter),
-          {
-            ctx: { where: "erc20.allowance", token: p.token, spender: assetRouter },
-            message: "Failed to read deposit-token allowance."
-          }
-        );
-        if (allowanceToken < p.amount) {
-          approvals.push({ token: p.token, spender: assetRouter, amount: p.amount });
-          const data = erc20Deposit.interface.encodeFunctionData("approve", [
-            assetRouter,
-            p.amount
-          ]);
-          steps.push({
-            key: `approve:${p.token}:${assetRouter}`,
-            kind: "approve",
-            description: `Approve ${p.amount} for router (deposit token)`,
-            tx: { to: p.token, data, from: ctx.sender, ...txOverrides }
-          });
+      const assetRouter = ctx.l1AssetRouter;
+      const erc20Deposit = new Contract(p.token, IERC20_default, l1Signer);
+      const allowanceToken = await wrapAs2(
+        "RPC",
+        OP_DEPOSITS.nonbase.allowanceToken,
+        () => erc20Deposit.allowance(ctx.sender, assetRouter),
+        {
+          ctx: { where: "erc20.allowance", token: p.token, spender: assetRouter },
+          message: "Failed to read deposit-token allowance."
         }
+      );
+      if (allowanceToken < p.amount) {
+        approvals.push({ token: p.token, spender: assetRouter, amount: p.amount });
+        steps.push({
+          key: `approve:${p.token}:${assetRouter}`,
+          kind: "approve",
+          description: `Approve ${p.amount} for router (deposit token)`,
+          tx: {
+            to: p.token,
+            data: erc20Deposit.interface.encodeFunctionData("approve", [assetRouter, p.amount]),
+            from: ctx.sender,
+            ...ctx.gasOverrides
+          }
+        });
       }
-      const baseIsEth = isETH(baseToken);
       if (!baseIsEth) {
         const erc20Base = new Contract(baseToken, IERC20_default, l1Signer);
         const allowanceBase = await wrapAs2(
@@ -540,12 +460,16 @@ function routeErc20NonBase() {
         );
         if (allowanceBase < mintValue) {
           approvals.push({ token: baseToken, spender: assetRouter, amount: mintValue });
-          const data = erc20Base.interface.encodeFunctionData("approve", [assetRouter, mintValue]);
           steps.push({
             key: `approve:${baseToken}:${assetRouter}`,
             kind: "approve",
             description: `Approve base token for mintValue`,
-            tx: { to: baseToken, data, from: ctx.sender, ...txOverrides }
+            tx: {
+              to: baseToken,
+              data: erc20Base.interface.encodeFunctionData("approve", [assetRouter, mintValue]),
+              from: ctx.sender,
+              ...ctx.gasOverrides
+            }
           });
         }
       }
@@ -558,96 +482,86 @@ function routeErc20NonBase() {
           message: "Failed to encode bridging calldata."
         }
       );
-      const outer = {
+      const requestStruct = {
         chainId: ctx.chainIdL2,
         mintValue,
-        // fees (in ETH if base=ETH, else pulled as base ERC-20)
         l2Value: 0n,
-        l2GasLimit: l2GasLimitUsed,
+        l2GasLimit: l2GasParams.gasLimit,
         l2GasPerPubdataByteLimit: ctx.gasPerPubdata,
         refundRecipient: ctx.refundRecipient,
         secondBridgeAddress: assetRouter,
         secondBridgeValue: 0n,
         secondBridgeCalldata
       };
-      const dataTwo = bh.interface.encodeFunctionData("requestL2TransactionTwoBridges", [outer]);
-      const bridgeTx = {
+      const bh = await ctx.contracts.bridgehub();
+      const data = bh.interface.encodeFunctionData("requestL2TransactionTwoBridges", [
+        requestStruct
+      ]);
+      const txValue = baseIsEth ? mintValue : 0n;
+      const l1TxCandidate = {
         to: ctx.bridgehub,
-        data: dataTwo,
-        value: baseIsEth ? mintValue : 0n,
+        data,
+        value: txValue,
         from: ctx.sender,
-        ...txOverrides
+        ...ctx.gasOverrides
       };
-      if (overrideGasLimit != null) {
-        bridgeTx.gasLimit = overrideGasLimit;
-        resolvedL1GasLimit = overrideGasLimit;
-      } else {
-        try {
-          const est = await wrapAs2(
-            "RPC",
-            OP_DEPOSITS.nonbase.estGas,
-            () => ctx.client.l1.estimateGas(bridgeTx),
-            {
-              ctx: { where: "l1.estimateGas", to: ctx.bridgehub, baseIsEth },
-              message: "Failed to estimate gas for Bridgehub request."
-            }
-          );
-          const buffered = BigInt(est) * 125n / 100n;
-          bridgeTx.gasLimit = buffered;
-          resolvedL1GasLimit = buffered;
-        } catch {
-        }
+      const l1GasParams = await quoteL1Gas2({
+        ctx,
+        tx: l1TxCandidate,
+        overrides: ctx.gasOverrides,
+        fallbackGasLimit: SAFE_L1_BRIDGE_GAS
+      });
+      if (l1GasParams) {
+        l1TxCandidate.gasLimit = l1GasParams.gasLimit;
+        l1TxCandidate.maxFeePerGas = l1GasParams.maxFeePerGas;
+        l1TxCandidate.maxPriorityFeePerGas = l1GasParams.maxPriorityFeePerGas;
       }
       steps.push({
-        key: "bridgehub:two-bridges:nonbase",
+        key: "bridgehub:two-bridges",
         kind: "bridgehub:two-bridges",
-        description: baseIsEth ? "Bridge ERC-20 (fees in ETH) via Bridgehub.requestL2TransactionTwoBridges" : "Bridge ERC-20 (fees in base ERC-20) via Bridgehub.requestL2TransactionTwoBridges",
-        tx: bridgeTx
+        description: baseIsEth ? "Bridge ERC-20 (Fees paid in ETH)" : "Bridge ERC-20 (Fees paid in Base Token)",
+        tx: l1TxCandidate
+      });
+      const fees = buildFeeBreakdown({
+        feeToken: baseToken,
+        l1Gas: l1GasParams,
+        l2Gas: l2GasParams,
+        l2BaseCost: baseCost,
+        operatorTip: ctx.operatorTip,
+        mintValue
       });
       return {
         steps,
         approvals,
-        quoteExtras: { baseCost, mintValue, baseToken, baseIsEth, l1GasLimit: resolvedL1GasLimit }
+        fees
       };
     }
   };
 }
 var { wrapAs: wrapAs3 } = createErrorHandlers("deposits");
-var BASE_COST_BUFFER_BPS = 100n;
-var BPS = 10000n;
-var withBuffer = (x) => x * (BPS + BASE_COST_BUFFER_BPS) / BPS;
 function routeEthNonBase() {
   return {
     async preflight(p, ctx) {
+      const resolved = ctx.resolvedToken ?? (ctx.tokens ? await ctx.tokens.resolve(p.token, { chain: "l1" }) : void 0);
       await wrapAs3(
         "VALIDATION",
         OP_DEPOSITS.ethNonBase.assertEthAsset,
         () => {
-          if (!isETH(p.token)) {
+          if (resolved?.kind !== "eth" && !isETH(p.token)) {
             throw new Error("eth-nonbase route requires ETH as the deposit asset.");
           }
         },
         { ctx: { token: p.token } }
       );
-      const bh = new Contract(ctx.bridgehub, IBridgehub_default, ctx.client.l1);
-      const baseToken = await wrapAs3(
-        "CONTRACT",
-        OP_DEPOSITS.ethNonBase.baseToken,
-        () => bh.baseToken(ctx.chainIdL2),
-        {
-          ctx: { where: "bridgehub.baseToken", chainIdL2: ctx.chainIdL2 },
-          message: "Failed to read base token."
-        }
-      );
       await wrapAs3(
         "VALIDATION",
         OP_DEPOSITS.ethNonBase.assertNonEthBase,
         () => {
-          if (isETH(baseToken)) {
+          if (ctx.baseIsEth) {
             throw new Error("eth-nonbase route requires target chain base token \u2260 ETH.");
           }
         },
-        { ctx: { baseToken, chainIdL2: ctx.chainIdL2 } }
+        { ctx: { baseIsEth: ctx.baseIsEth, chainIdL2: ctx.chainIdL2 } }
       );
       const ethBal = await wrapAs3(
         "RPC",
@@ -671,61 +585,48 @@ function routeEthNonBase() {
       return;
     },
     async build(p, ctx) {
-      const bh = new Contract(ctx.bridgehub, IBridgehub_default, ctx.client.l1);
-      const { gasPriceForBaseCost, gasLimit: overrideGasLimit, ...txFeeOverrides } = ctx.fee;
-      const txOverrides = overrideGasLimit != null ? { ...txFeeOverrides, gasLimit: overrideGasLimit } : txFeeOverrides;
-      const baseToken = await wrapAs3(
-        "CONTRACT",
-        OP_DEPOSITS.ethNonBase.baseToken,
-        () => bh.baseToken(ctx.chainIdL2),
-        {
-          ctx: { where: "bridgehub.baseToken", chainIdL2: ctx.chainIdL2 },
-          message: "Failed to read base token."
-        }
-      );
-      const rawBaseCost = await wrapAs3(
+      const l1Signer = ctx.client.getL1Signer();
+      const baseToken = ctx.baseTokenL1;
+      const l2TxModel = {
+        to: p.to ?? ctx.sender,
+        from: ctx.sender,
+        data: "0x",
+        value: 0n
+      };
+      const l2GasParams = await quoteL2Gas3({
+        ctx,
+        route: "eth-nonbase",
+        l2TxForModeling: l2TxModel,
+        overrideGasLimit: ctx.l2GasLimit
+      });
+      if (!l2GasParams) throw new Error("Failed to estimate L2 gas parameters.");
+      const baseCost = await quoteL2BaseCost2({ ctx, l2GasLimit: l2GasParams.gasLimit });
+      const mintValue = baseCost + ctx.operatorTip;
+      const approvals = [];
+      const steps = [];
+      const erc20Base = new Contract(baseToken, IERC20_default, l1Signer);
+      const allowance = await wrapAs3(
         "RPC",
-        OP_DEPOSITS.ethNonBase.baseCost,
-        () => bh.l2TransactionBaseCost(
-          ctx.chainIdL2,
-          gasPriceForBaseCost,
-          ctx.l2GasLimit,
-          ctx.gasPerPubdata
-        ),
+        OP_DEPOSITS.ethNonBase.allowanceBase,
+        () => erc20Base.allowance(ctx.sender, ctx.l1AssetRouter),
         {
-          ctx: { where: "l2TransactionBaseCost", chainIdL2: ctx.chainIdL2 },
-          message: "Could not fetch L2 base cost."
+          ctx: { where: "erc20.allowance", token: baseToken, spender: ctx.l1AssetRouter },
+          message: "Failed to read base-token allowance."
         }
       );
-      const baseCost = BigInt(rawBaseCost);
-      const mintValueRaw = baseCost + ctx.operatorTip;
-      const mintValue = withBuffer(mintValueRaw);
-      const approvals = [];
-      const steps = [];
-      {
-        const erc20 = new Contract(baseToken, IERC20_default, ctx.client.getL1Signer());
-        const allowance = await wrapAs3(
-          "RPC",
-          OP_DEPOSITS.ethNonBase.allowanceBase,
-          () => erc20.allowance(ctx.sender, ctx.l1AssetRouter),
-          {
-            ctx: { where: "erc20.allowance", token: baseToken, spender: ctx.l1AssetRouter },
-            message: "Failed to read base-token allowance."
+      if (allowance < mintValue) {
+        approvals.push({ token: baseToken, spender: ctx.l1AssetRouter, amount: mintValue });
+        steps.push({
+          key: `approve:${baseToken}`,
+          kind: "approve",
+          description: `Approve base token for fees (mintValue)`,
+          tx: {
+            to: baseToken,
+            data: erc20Base.interface.encodeFunctionData("approve", [ctx.l1AssetRouter, mintValue]),
+            from: ctx.sender,
+            ...ctx.gasOverrides
           }
-        );
-        if (allowance < mintValue) {
-          approvals.push({ token: baseToken, spender: ctx.l1AssetRouter, amount: mintValue });
-          const data = erc20.interface.encodeFunctionData("approve", [
-            ctx.l1AssetRouter,
-            mintValue
-          ]);
-          steps.push({
-            key: `approve:${baseToken}:${ctx.l1AssetRouter}`,
-            kind: "approve",
-            description: `Approve base token for mintValue`,
-            tx: { to: baseToken, data, from: ctx.sender, ...txOverrides }
-          });
-        }
+        });
       }
       const secondBridgeCalldata = await wrapAs3(
         "INTERNAL",
@@ -739,92 +640,78 @@ function routeEthNonBase() {
           }
         }
       );
-      const outer = {
+      const requestStruct = {
         chainId: ctx.chainIdL2,
         mintValue,
-        l2Value: 0n,
-        l2GasLimit: ctx.l2GasLimit,
+        l2Value: p.amount,
+        l2GasLimit: l2GasParams.gasLimit,
         l2GasPerPubdataByteLimit: ctx.gasPerPubdata,
         refundRecipient: ctx.refundRecipient,
         secondBridgeAddress: ctx.l1AssetRouter,
         secondBridgeValue: p.amount,
         secondBridgeCalldata
       };
-      const dataTwo = new Contract(
-        ctx.bridgehub,
-        IBridgehub_default,
-        ctx.client.l1
-      ).interface.encodeFunctionData("requestL2TransactionTwoBridges", [outer]);
-      let resolvedL1GasLimit = overrideGasLimit ?? ctx.l2GasLimit;
-      const bridgeTx = {
+      const bridgehub = await ctx.contracts.bridgehub();
+      const data = bridgehub.interface.encodeFunctionData("requestL2TransactionTwoBridges", [
+        requestStruct
+      ]);
+      const l1TxCandidate = {
         to: ctx.bridgehub,
-        data: dataTwo,
+        data,
         value: p.amount,
         // base ≠ ETH ⇒ msg.value == secondBridgeValue
         from: ctx.sender,
-        ...txOverrides
+        ...ctx.gasOverrides
       };
-      if (overrideGasLimit != null) {
-        bridgeTx.gasLimit = overrideGasLimit;
-        resolvedL1GasLimit = overrideGasLimit;
-      } else {
-        try {
-          const est = await wrapAs3(
-            "RPC",
-            OP_DEPOSITS.ethNonBase.estGas,
-            () => ctx.client.l1.estimateGas(bridgeTx),
-            {
-              ctx: { where: "l1.estimateGas", to: ctx.bridgehub },
-              message: "Failed to estimate gas for Bridgehub request."
-            }
-          );
-          const buffered = BigInt(est) * 115n / 100n;
-          bridgeTx.gasLimit = buffered;
-          resolvedL1GasLimit = buffered;
-        } catch {
-        }
+      const l1GasParams = await quoteL1Gas2({
+        ctx,
+        tx: l1TxCandidate,
+        overrides: ctx.gasOverrides,
+        fallbackGasLimit: SAFE_L1_BRIDGE_GAS
+      });
+      if (l1GasParams) {
+        l1TxCandidate.gasLimit = l1GasParams.gasLimit;
+        l1TxCandidate.maxFeePerGas = l1GasParams.maxFeePerGas;
+        l1TxCandidate.maxPriorityFeePerGas = l1GasParams.maxPriorityFeePerGas;
       }
       steps.push({
         key: "bridgehub:two-bridges:eth-nonbase",
         kind: "bridgehub:two-bridges",
         description: "Bridge ETH (fees in base ERC-20) via Bridgehub.requestL2TransactionTwoBridges",
-        tx: bridgeTx
+        tx: l1TxCandidate
+      });
+      const fees = buildFeeBreakdown({
+        feeToken: baseToken,
+        l1Gas: l1GasParams,
+        l2Gas: l2GasParams,
+        l2BaseCost: baseCost,
+        operatorTip: ctx.operatorTip,
+        mintValue
       });
       return {
         steps,
         approvals,
-        quoteExtras: { baseCost, mintValue, l1GasLimit: resolvedL1GasLimit }
+        fees
       };
     }
   };
 }
 var { wrapAs: wrapAs4 } = createErrorHandlers("deposits");
-var BASE_COST_BUFFER_BPS2 = 100n;
-var BPS2 = 10000n;
-var withBuffer2 = (x) => x * (BPS2 + BASE_COST_BUFFER_BPS2) / BPS2;
 function routeErc20Base() {
   return {
     async preflight(p, ctx) {
+      const resolved = ctx.resolvedToken ?? (ctx.tokens ? await ctx.tokens.resolve(p.token, { chain: "l1" }) : void 0);
       await wrapAs4(
         "VALIDATION",
         OP_DEPOSITS.base.assertErc20Asset,
         () => {
-          if (isETH(p.token)) {
+          if (resolved?.kind === "eth" || isETH(p.token)) {
             throw new Error("erc20-base route requires an ERC-20 token (not ETH).");
           }
         },
         { ctx: { token: p.token } }
       );
-      const bh = new Contract(ctx.bridgehub, IBridgehub_default, ctx.client.l1);
-      const baseToken = await wrapAs4(
-        "CONTRACT",
-        OP_DEPOSITS.base.baseToken,
-        () => bh.baseToken(ctx.chainIdL2),
-        {
-          ctx: { where: "bridgehub.baseToken", chainIdL2: ctx.chainIdL2 },
-          message: "Failed to read base token."
-        }
-      );
+      const baseToken = ctx.baseTokenL1 ?? await ctx.client.baseToken(ctx.chainIdL2);
       await wrapAs4(
         "VALIDATION",
         OP_DEPOSITS.base.assertMatchesBase,
@@ -838,41 +725,27 @@ function routeErc20Base() {
       return;
     },
     async build(p, ctx) {
-      const bh = new Contract(ctx.bridgehub, IBridgehub_default, ctx.client.l1);
-      const { gasPriceForBaseCost, gasLimit: overrideGasLimit, ...txFeeOverrides } = ctx.fee;
-      const txOverrides = overrideGasLimit != null ? { ...txFeeOverrides, gasLimit: overrideGasLimit } : txFeeOverrides;
-      let resolvedL1GasLimit = overrideGasLimit ?? ctx.l2GasLimit;
-      const baseToken = await wrapAs4(
-        "CONTRACT",
-        OP_DEPOSITS.base.baseToken,
-        () => bh.baseToken(ctx.chainIdL2),
-        {
-          ctx: { where: "bridgehub.baseToken", chainIdL2: ctx.chainIdL2 },
-          message: "Failed to read base token."
-        }
-      );
-      const rawBaseCost = await wrapAs4(
-        "RPC",
-        OP_DEPOSITS.base.baseCost,
-        () => bh.l2TransactionBaseCost(
-          ctx.chainIdL2,
-          gasPriceForBaseCost,
-          ctx.l2GasLimit,
-          ctx.gasPerPubdata
-        ),
-        {
-          ctx: { where: "l2TransactionBaseCost", chainIdL2: ctx.chainIdL2 },
-          message: "Could not fetch L2 base cost from Bridgehub."
-        }
-      );
-      const baseCost = BigInt(rawBaseCost);
-      const l2Value = p.amount;
-      const rawMintValue = baseCost + ctx.operatorTip + l2Value;
-      const mintValue = withBuffer2(rawMintValue);
+      const l1Signer = ctx.client.getL1Signer();
+      const baseToken = ctx.baseTokenL1 ?? await ctx.client.baseToken(ctx.chainIdL2);
+      const l2TxModel = {
+        to: p.to ?? ctx.sender,
+        from: ctx.sender,
+        data: "0x",
+        value: 0n
+      };
+      const l2GasParams = await quoteL2Gas3({
+        ctx,
+        route: "erc20-base",
+        l2TxForModeling: l2TxModel,
+        overrideGasLimit: ctx.l2GasLimit
+      });
+      if (!l2GasParams) throw new Error("Failed to estimate L2 gas parameters.");
+      const baseCost = await quoteL2BaseCost2({ ctx, l2GasLimit: l2GasParams.gasLimit });
+      const mintValue = baseCost + ctx.operatorTip + p.amount;
       const approvals = [];
       const steps = [];
       {
-        const erc20 = new Contract(baseToken, IERC20_default, ctx.client.getL1Signer());
+        const erc20 = new Contract(baseToken, IERC20_default, l1Signer);
         const allowance = await wrapAs4(
           "RPC",
           OP_DEPOSITS.base.allowance,
@@ -884,74 +757,333 @@ function routeErc20Base() {
         );
         if (allowance < mintValue) {
           approvals.push({ token: baseToken, spender: ctx.l1AssetRouter, amount: mintValue });
-          const data2 = erc20.interface.encodeFunctionData("approve", [
-            ctx.l1AssetRouter,
-            mintValue
-          ]);
           steps.push({
             key: `approve:${baseToken}:${ctx.l1AssetRouter}`,
             kind: "approve",
             description: "Approve base token for mintValue",
-            tx: { to: baseToken, data: data2, from: ctx.sender, ...txOverrides }
+            tx: {
+              to: baseToken,
+              data: erc20.interface.encodeFunctionData("approve", [ctx.l1AssetRouter, mintValue]),
+              from: ctx.sender,
+              ...ctx.gasOverrides
+            }
           });
         }
       }
-      const req = buildDirectRequestStruct({
+      const requestStruct = buildDirectRequestStruct({
         chainId: ctx.chainIdL2,
         mintValue,
-        l2GasLimit: ctx.l2GasLimit,
+        l2GasLimit: l2GasParams.gasLimit,
         gasPerPubdata: ctx.gasPerPubdata,
         refundRecipient: ctx.refundRecipient,
         l2Contract: p.to ?? ctx.sender,
-        l2Value
+        l2Value: p.amount
       });
-      const data = new Contract(
-        ctx.bridgehub,
-        IBridgehub_default,
-        ctx.client.l1
-      ).interface.encodeFunctionData("requestL2TransactionDirect", [req]);
-      const tx = {
+      const bridgehub = await ctx.contracts.bridgehub();
+      const data = bridgehub.interface.encodeFunctionData("requestL2TransactionDirect", [
+        requestStruct
+      ]);
+      const l1TxCandidate = {
         to: ctx.bridgehub,
         data,
         value: 0n,
         // base token is ERC-20 ⇒ msg.value MUST be 0
         from: ctx.sender,
-        ...txOverrides
+        ...ctx.gasOverrides
       };
-      if (overrideGasLimit != null) {
-        tx.gasLimit = overrideGasLimit;
-        resolvedL1GasLimit = overrideGasLimit;
-      } else {
-        try {
-          const est = await wrapAs4(
-            "RPC",
-            OP_DEPOSITS.base.estGas,
-            () => ctx.client.l1.estimateGas(tx),
-            {
-              ctx: { where: "l1.estimateGas", to: ctx.bridgehub },
-              message: "Failed to estimate gas for Bridgehub request."
-            }
-          );
-          const buffered = BigInt(est) * 115n / 100n;
-          tx.gasLimit = buffered;
-          resolvedL1GasLimit = buffered;
-        } catch {
-        }
+      const l1GasParams = await quoteL1Gas2({
+        ctx,
+        tx: l1TxCandidate,
+        overrides: ctx.gasOverrides,
+        fallbackGasLimit: SAFE_L1_BRIDGE_GAS
+      });
+      if (l1GasParams) {
+        l1TxCandidate.gasLimit = l1GasParams.gasLimit;
+        l1TxCandidate.maxFeePerGas = l1GasParams.maxFeePerGas;
+        l1TxCandidate.maxPriorityFeePerGas = l1GasParams.maxPriorityFeePerGas;
       }
       steps.push({
         key: "bridgehub:direct:erc20-base",
         kind: "bridgehub:direct",
         description: "Bridge base ERC-20 via Bridgehub.requestL2TransactionDirect",
-        tx
+        tx: l1TxCandidate
+      });
+      const fees = buildFeeBreakdown({
+        feeToken: baseToken,
+        l1Gas: l1GasParams,
+        l2Gas: l2GasParams,
+        l2BaseCost: baseCost,
+        operatorTip: ctx.operatorTip,
+        mintValue
       });
       return {
         steps,
         approvals,
-        quoteExtras: { baseCost, mintValue, l1GasLimit: resolvedL1GasLimit }
+        fees
       };
     }
   };
 }
+var { wrapAs: wrapAs5 } = createErrorHandlers("tokens");
+var abi = AbiCoder.defaultAbiCoder();
+var ntvCodec = createNTVCodec({
+  encode: (types, values) => abi.encode(types, values),
+  keccak256: (data) => ethers.keccak256(data)
+});
+function createTokensResource(client) {
+  let l2NtvL1ChainIdPromise = null;
+  let baseTokenAssetIdPromise = null;
+  let wethL1Promise = null;
+  let wethL2Promise = null;
+  async function getL1ChainId() {
+    if (!l2NtvL1ChainIdPromise) {
+      l2NtvL1ChainIdPromise = wrapAs5("INTERNAL", "getL1ChainId", async () => {
+        const { l2NativeTokenVault } = await client.contracts();
+        const chainId = await l2NativeTokenVault.L1_CHAIN_ID();
+        return chainId;
+      });
+    }
+    return l2NtvL1ChainIdPromise;
+  }
+  async function getBaseTokenAssetId() {
+    if (!baseTokenAssetIdPromise) {
+      baseTokenAssetIdPromise = wrapAs5("INTERNAL", "baseTokenAssetId", async () => {
+        const { l2NativeTokenVault } = await client.contracts();
+        const assetId = await l2NativeTokenVault.BASE_TOKEN_ASSET_ID();
+        return assetId;
+      });
+    }
+    return baseTokenAssetIdPromise;
+  }
+  async function getWethL1() {
+    if (!wethL1Promise) {
+      wethL1Promise = wrapAs5("INTERNAL", "wethL1", async () => {
+        const { l1NativeTokenVault } = await client.contracts();
+        const weth = await l1NativeTokenVault.WETH_TOKEN();
+        return weth;
+      });
+    }
+    return wethL1Promise;
+  }
+  async function getWethL2() {
+    if (!wethL2Promise) {
+      wethL2Promise = wrapAs5("INTERNAL", "wethL2", async () => {
+        const { l2NativeTokenVault } = await client.contracts();
+        const weth = await l2NativeTokenVault.WETH_TOKEN();
+        return weth;
+      });
+    }
+    return wethL2Promise;
+  }
+  async function toL2Address(l1Token) {
+    return wrapAs5("CONTRACT", "tokens.toL2Address", async () => {
+      const normalized = normalizeL1Token(l1Token);
+      const { chainId } = await client.l2.getNetwork();
+      const baseToken = await client.baseToken(BigInt(chainId));
+      if (isAddressEq(normalized, baseToken)) {
+        return L2_BASE_TOKEN_ADDRESS;
+      }
+      const { l2NativeTokenVault } = await client.contracts();
+      const l2Token = await l2NativeTokenVault.l2TokenAddress(normalized);
+      return l2Token;
+    });
+  }
+  async function toL1Address(l2Token) {
+    return wrapAs5("CONTRACT", "tokens.toL1Address", async () => {
+      if (isAddressEq(l2Token, ETH_ADDRESS)) {
+        return ETH_ADDRESS;
+      }
+      if (isAddressEq(l2Token, L2_BASE_TOKEN_ADDRESS)) {
+        const { chainId } = await client.l2.getNetwork();
+        return await client.baseToken(BigInt(chainId));
+      }
+      const { l2AssetRouter } = await client.contracts();
+      const l1Token = await l2AssetRouter.l1TokenAddress(l2Token);
+      return l1Token;
+    });
+  }
+  async function assetIdOfL1(l1Token) {
+    return wrapAs5("CONTRACT", "tokens.assetIdOfL1", async () => {
+      const normalized = normalizeL1Token(l1Token);
+      const { l1NativeTokenVault } = await client.contracts();
+      const assetId = await l1NativeTokenVault.assetId(normalized);
+      return assetId;
+    });
+  }
+  async function assetIdOfL2(l2Token) {
+    return wrapAs5("CONTRACT", "tokens.assetIdOfL2", async () => {
+      const { l2NativeTokenVault } = await client.contracts();
+      const assetId = await l2NativeTokenVault.assetId(l2Token);
+      return assetId;
+    });
+  }
+  async function l2TokenFromAssetId(assetId) {
+    return wrapAs5("CONTRACT", "tokens.l2TokenFromAssetId", async () => {
+      const { l2NativeTokenVault } = await client.contracts();
+      const tokenAddr = await l2NativeTokenVault.tokenAddress(assetId);
+      return tokenAddr;
+    });
+  }
+  async function l1TokenFromAssetId(assetId) {
+    return wrapAs5("CONTRACT", "tokens.l1TokenFromAssetId", async () => {
+      const { l1NativeTokenVault } = await client.contracts();
+      const tokenAddr = await l1NativeTokenVault.tokenAddress(assetId);
+      return tokenAddr;
+    });
+  }
+  async function originChainId(assetId) {
+    return wrapAs5("CONTRACT", "tokens.originChainId", async () => {
+      const { l2NativeTokenVault } = await client.contracts();
+      const chainId = await l2NativeTokenVault.originChainId(assetId);
+      return chainId;
+    });
+  }
+  async function baseTokenAssetId() {
+    return getBaseTokenAssetId();
+  }
+  async function isChainEthBased() {
+    return wrapAs5("CONTRACT", "tokens.isChainEthBased", async () => {
+      const baseAssetId = await getBaseTokenAssetId();
+      const l1ChainId = await getL1ChainId();
+      const ethAssetId = ntvCodec.encodeAssetId(
+        l1ChainId,
+        L2_NATIVE_TOKEN_VAULT_ADDRESS,
+        ETH_ADDRESS
+      );
+      return hexEq(baseAssetId, ethAssetId);
+    });
+  }
+  async function wethL1() {
+    return getWethL1();
+  }
+  async function wethL2() {
+    return getWethL2();
+  }
+  async function computeL2BridgedAddress(args) {
+    return wrapAs5("CONTRACT", "tokens.computeL2BridgedAddress", async () => {
+      const normalized = normalizeL1Token(args.l1Token);
+      const { l2NativeTokenVault } = await client.contracts();
+      const predicted = await l2NativeTokenVault.calculateCreate2TokenAddress(
+        args.originChainId,
+        normalized
+      );
+      return predicted;
+    });
+  }
+  async function resolve(ref, opts) {
+    return wrapAs5("CONTRACT", "tokens.resolve", async () => {
+      let chain;
+      let address;
+      if (typeof ref === "string") {
+        chain = opts?.chain ?? "l1";
+        address = ref;
+      } else {
+        chain = ref.chain;
+        address = ref.address;
+      }
+      let l1;
+      let l2;
+      if (chain === "l1") {
+        l1 = normalizeL1Token(address);
+        l2 = await toL2Address(address);
+      } else {
+        l2 = address;
+        l1 = await toL1Address(address);
+      }
+      const assetId = await assetIdOfL1(l1);
+      const originChainIdVal = await originChainId(assetId);
+      const [baseAssetId, wethL1Addr, wethL2Addr, ethBased] = await Promise.all([
+        baseTokenAssetId(),
+        wethL1(),
+        wethL2(),
+        isChainEthBased()
+      ]);
+      let kind;
+      if (isAddressEq(l1, ETH_ADDRESS)) {
+        kind = "eth";
+      } else if (hexEq(assetId, baseAssetId)) {
+        kind = "base";
+      } else {
+        kind = "erc20";
+      }
+      return {
+        kind,
+        l1,
+        l2,
+        assetId,
+        originChainId: originChainIdVal,
+        isChainEthBased: ethBased,
+        baseTokenAssetId: baseAssetId,
+        wethL1: wethL1Addr,
+        wethL2: wethL2Addr
+      };
+    });
+  }
+  return {
+    resolve,
+    toL2Address,
+    toL1Address,
+    assetIdOfL1,
+    assetIdOfL2,
+    l2TokenFromAssetId,
+    l1TokenFromAssetId,
+    originChainId,
+    baseTokenAssetId,
+    isChainEthBased,
+    wethL1,
+    wethL2,
+    computeL2BridgedAddress
+  };
+}
+
+// src/adapters/ethers/resources/contracts/contracts.ts
+function createContractsResource(client) {
+  async function addresses() {
+    return client.ensureAddresses();
+  }
+  async function instances() {
+    return client.contracts();
+  }
+  async function bridgehub() {
+    const { bridgehub: bridgehub2 } = await instances();
+    return bridgehub2;
+  }
+  async function l1AssetRouter() {
+    const { l1AssetRouter: l1AssetRouter2 } = await instances();
+    return l1AssetRouter2;
+  }
+  async function l1NativeTokenVault() {
+    const { l1NativeTokenVault: l1NativeTokenVault2 } = await instances();
+    return l1NativeTokenVault2;
+  }
+  async function l1Nullifier() {
+    const { l1Nullifier: l1Nullifier2 } = await instances();
+    return l1Nullifier2;
+  }
+  async function l2AssetRouter() {
+    const { l2AssetRouter: l2AssetRouter2 } = await instances();
+    return l2AssetRouter2;
+  }
+  async function l2NativeTokenVault() {
+    const { l2NativeTokenVault: l2NativeTokenVault2 } = await instances();
+    return l2NativeTokenVault2;
+  }
+  async function l2BaseTokenSystem() {
+    const { l2BaseTokenSystem: l2BaseTokenSystem2 } = await instances();
+    return l2BaseTokenSystem2;
+  }
+  return {
+    addresses,
+    instances,
+    bridgehub,
+    l1AssetRouter,
+    l1NativeTokenVault,
+    l1Nullifier,
+    l2AssetRouter,
+    l2NativeTokenVault,
+    l2BaseTokenSystem
+  };
+}
 
 // src/adapters/ethers/resources/deposits/index.ts
 var { wrap, toResult } = createErrorHandlers("deposits");
@@ -961,42 +1093,26 @@ var ROUTES = {
   "erc20-nonbase": routeErc20NonBase(),
   "erc20-base": routeErc20Base()
 };
-function createDepositsResource(client) {
+function createDepositsResource(client, tokens, contracts) {
+  const tokensResource = tokens ?? createTokensResource(client);
+  const contractsResource = contracts ?? createContractsResource(client);
   async function buildPlan(p) {
-    const ctx = await commonCtx(p, client);
+    const ctx = await commonCtx(p, client, tokensResource, contractsResource);
     const route = ctx.route;
     await ROUTES[route].preflight?.(p, ctx);
-    const { steps, approvals, quoteExtras } = await ROUTES[route].build(p, ctx);
-    const { baseCost, mintValue } = quoteExtras;
-    const fallbackGasLimit = quoteExtras.l1GasLimit;
-    const resolveGasLimit = () => {
-      if (ctx.fee.gasLimit != null) return ctx.fee.gasLimit;
-      for (let i = steps.length - 1; i >= 0; i--) {
-        const candidate = steps[i].tx.gasLimit;
-        if (candidate == null) continue;
-        if (typeof candidate === "bigint") return candidate;
-        try {
-          return BigInt(candidate.toString());
-        } catch {
-        }
-      }
-      if (fallbackGasLimit != null) return fallbackGasLimit;
-      return ctx.l2GasLimit;
-    };
-    const gasLimit = resolveGasLimit();
+    const { steps, approvals, fees } = await ROUTES[route].build(p, ctx);
     return {
       route: ctx.route,
       summary: {
         route: ctx.route,
         approvalsNeeded: approvals,
-        baseCost,
-        mintValue,
-        gasPerPubdata: ctx.gasPerPubdata,
-        fees: {
-          gasLimit,
-          maxFeePerGas: ctx.fee.maxFeePerGas,
-          maxPriorityFeePerGas: ctx.fee.maxPriorityFeePerGas
-        }
+        amounts: {
+          transfer: { token: p.token, amount: p.amount }
+        },
+        fees,
+        // Legacy fields (maintained for backward compatibility)
+        baseCost: fees.l2?.baseCost,
+        mintValue: fees.mintValue
       },
       steps
     };
@@ -1065,7 +1181,7 @@ function createDepositsResource(client) {
             step.tx.maxPriorityFeePerGas = overrides.maxPriorityFeePerGas;
           }
         }
-        if (!step.tx.gasLimit) {
+        if (!p.l1TxOverrides?.gasLimit) {
           try {
             const est = await client.l1.estimateGas(step.tx);
             step.tx.gasLimit = BigInt(est) * 115n / 100n;
@@ -1246,25 +1362,9 @@ function createDepositsResource(client) {
   );
   return { quote, tryQuote, prepare, tryPrepare, create, tryCreate, status, wait, tryWait };
 }
-async function ntvBaseAssetId(l2, ntv) {
-  const c = new Contract(ntv, L2NativeTokenVault_default, l2);
-  return await c.BASE_TOKEN_ASSET_ID();
-}
-async function ntvL1ChainId(l2, ntv) {
-  const c = new Contract(ntv, L2NativeTokenVault_default, l2);
-  return await c.L1_CHAIN_ID();
-}
-async function isEthBasedChain(l2, ntv) {
-  const [baseAssetId, l1ChainId] = await Promise.all([
-    ntvBaseAssetId(l2, ntv),
-    ntvL1ChainId(l2, ntv)
-  ]);
-  const ethAssetId = encodeNativeTokenVaultAssetId(l1ChainId, ETH_ADDRESS);
-  return baseAssetId.toLowerCase() === ethAssetId.toLowerCase();
-}
 
 // src/adapters/ethers/resources/withdrawals/context.ts
-async function commonCtx2(p, client) {
+async function commonCtx2(p, client, tokens, contracts) {
   const sender = await client.signer.getAddress();
   const {
     bridgehub,
@@ -1273,16 +1373,21 @@ async function commonCtx2(p, client) {
     l2AssetRouter,
     l2NativeTokenVault,
     l2BaseTokenSystem
-  } = await client.ensureAddresses();
+  } = await contracts.addresses();
   const { chainId } = await client.l2.getNetwork();
   const chainIdL2 = BigInt(chainId);
-  const baseIsEth = await isEthBasedChain(client.l2, l2NativeTokenVault);
-  const fee = await getL2FeeOverrides(client, p.l2TxOverrides);
+  const resolvedToken = await tokens.resolve(p.token, { chain: "l2" });
+  const baseTokenAssetId = resolvedToken.baseTokenAssetId;
+  const baseTokenL1 = await tokens.l1TokenFromAssetId(baseTokenAssetId);
+  const baseIsEth = resolvedToken.isChainEthBased;
   const route = pickWithdrawRoute({ token: p.token, baseIsEth });
-  const l2GasLimit = p.l2GasLimit ?? 300000n;
-  const gasBufferPct = 15;
   return {
     client,
+    tokens,
+    contracts,
+    resolvedToken,
+    baseTokenAssetId,
+    baseTokenL1,
     bridgehub,
     chainIdL2,
     sender,
@@ -1293,29 +1398,50 @@ async function commonCtx2(p, client) {
     l2NativeTokenVault,
     l2BaseTokenSystem,
     baseIsEth,
-    l2GasLimit,
-    gasBufferPct,
-    fee
+    gasOverrides: p.l2TxOverrides
   };
 }
-var { wrapAs: wrapAs5 } = createErrorHandlers("withdrawals");
+
+// src/adapters/ethers/resources/withdrawals/services/gas.ts
+async function quoteL2Gas4(input) {
+  const { ctx, tx } = input;
+  const estimator = ethersToGasEstimator(ctx.client.l2);
+  return quoteL2Gas2({
+    estimator,
+    tx: toCoreTx(tx),
+    overrides: ctx.gasOverrides
+  });
+}
+
+// src/adapters/ethers/resources/withdrawals/services/fees.ts
+function buildFeeBreakdown2(p) {
+  const l2Total = p.l2Gas?.maxCost ?? 0n;
+  const l2 = {
+    total: l2Total,
+    gasLimit: p.l2Gas?.gasLimit ?? 0n,
+    maxFeePerGas: p.l2Gas?.maxFeePerGas ?? 0n,
+    maxPriorityFeePerGas: p.l2Gas?.maxPriorityFeePerGas
+  };
+  return {
+    token: p.feeToken,
+    maxTotal: l2Total,
+    l2
+  };
+}
+
+// src/adapters/ethers/resources/withdrawals/routes/eth.ts
+var { wrapAs: wrapAs6 } = createErrorHandlers("withdrawals");
 function routeEthBase() {
   return {
     async build(p, ctx) {
       const steps = [];
-      const { gasLimit: overrideGasLimit, maxFeePerGas, maxPriorityFeePerGas } = ctx.fee;
-      const base = new Contract(
-        L2_BASE_TOKEN_ADDRESS,
-        new Interface(IBaseToken_default),
-        ctx.client.l2
-      );
-      const toL1 = p.to ?? ctx.sender;
-      const data = await wrapAs5(
+      const base = await ctx.contracts.l2BaseTokenSystem();
+      const data = await wrapAs6(
         "INTERNAL",
         OP_WITHDRAWALS.eth.encodeWithdraw,
-        () => Promise.resolve(base.interface.encodeFunctionData("withdraw", [toL1])),
+        () => Promise.resolve(base.interface.encodeFunctionData("withdraw", [p.to ?? ctx.sender])),
         {
-          ctx: { where: "L2BaseToken.withdraw", to: toL1 },
+          ctx: { where: "L2BaseToken.withdraw", to: p.to ?? ctx.sender },
           message: "Failed to encode ETH withdraw calldata."
         }
       );
@@ -1323,38 +1449,29 @@ function routeEthBase() {
         to: L2_BASE_TOKEN_ADDRESS,
         data,
         from: ctx.sender,
-        value: p.amount,
-        maxFeePerGas,
-        maxPriorityFeePerGas
+        value: p.amount
       };
-      if (overrideGasLimit != null) {
-        tx.gasLimit = overrideGasLimit;
-      } else {
-        try {
-          const est = await wrapAs5(
-            "RPC",
-            OP_WITHDRAWALS.eth.estGas,
-            () => ctx.client.l2.estimateGas(tx),
-            {
-              ctx: { where: "l2.estimateGas", to: L2_BASE_TOKEN_ADDRESS },
-              message: "Failed to estimate gas for L2 ETH withdraw."
-            }
-          );
-          tx.gasLimit = BigInt(est) * 115n / 100n;
-        } catch {
-        }
+      const gas = await quoteL2Gas4({ ctx, tx });
+      if (gas) {
+        tx.gasLimit = gas.gasLimit;
+        tx.maxFeePerGas = gas.maxFeePerGas;
+        tx.maxPriorityFeePerGas = gas.maxPriorityFeePerGas;
       }
+      const fees = buildFeeBreakdown2({
+        feeToken: L2_BASE_TOKEN_ADDRESS,
+        l2Gas: gas
+      });
       steps.push({
         key: "l2-base-token:withdraw",
         kind: "l2-base-token:withdraw",
         description: "Withdraw ETH via L2 Base Token System",
         tx
       });
-      return { steps, approvals: [], quoteExtras: {} };
+      return { steps, approvals: [], fees };
     }
   };
 }
-var { wrapAs: wrapAs6 } = createErrorHandlers("withdrawals");
+var { wrapAs: wrapAs7 } = createErrorHandlers("withdrawals");
 var SIG = {
   withdraw: "withdraw(bytes32,bytes)"
 };
@@ -1363,10 +1480,8 @@ function routeErc20NonBase2() {
     async build(p, ctx) {
       const steps = [];
       const approvals = [];
-      const { gasLimit: overrideGasLimit, maxFeePerGas, maxPriorityFeePerGas } = ctx.fee;
-      const txOverrides = overrideGasLimit != null ? { maxFeePerGas, maxPriorityFeePerGas, gasLimit: overrideGasLimit } : { maxFeePerGas, maxPriorityFeePerGas };
       const erc20 = new Contract(p.token, IERC20_default, ctx.client.getL2Signer());
-      const current = await wrapAs6(
+      const current = await wrapAs7(
         "CONTRACT",
         OP_WITHDRAWALS.erc20.allowance,
         () => erc20.allowance(ctx.sender, ctx.l2NativeTokenVault),
@@ -1386,39 +1501,51 @@ function routeErc20NonBase2() {
           ctx.l2NativeTokenVault,
           p.amount
         ]);
+        const approveTx = {
+          to: p.token,
+          data,
+          from: ctx.sender
+        };
+        const approveGas = await quoteL2Gas4({ ctx, tx: approveTx });
+        if (approveGas) {
+          approveTx.gasLimit = approveGas.gasLimit;
+          approveTx.maxFeePerGas = approveGas.maxFeePerGas;
+          approveTx.maxPriorityFeePerGas = approveGas.maxPriorityFeePerGas;
+        }
         steps.push({
           key: `approve:l2:${p.token}:${ctx.l2NativeTokenVault}`,
           kind: "approve:l2",
           description: `Approve ${p.amount} to NativeTokenVault`,
-          tx: { to: p.token, data, from: ctx.sender, ...txOverrides }
+          tx: approveTx
         });
       }
-      const ntv = new Contract(ctx.l2NativeTokenVault, L2NativeTokenVault_default, ctx.client.l2);
-      const assetId = await wrapAs6(
+      const resolved = ctx.resolvedToken ?? (ctx.tokens ? await ctx.tokens.resolve(p.token, { chain: "l2" }) : void 0);
+      const assetId = resolved?.assetId ?? await wrapAs7(
         "CONTRACT",
         OP_WITHDRAWALS.erc20.ensureRegistered,
-        () => ntv.getFunction("ensureTokenIsRegistered").staticCall(p.token),
+        async () => {
+          const ntv = await ctx.contracts.l2NativeTokenVault();
+          const ensured = await ntv.getFunction("ensureTokenIsRegistered").staticCall(p.token);
+          return ensured;
+        },
         {
           ctx: { where: "L2NativeTokenVault.ensureTokenIsRegistered", token: p.token },
           message: "Failed to ensure token is registered in L2NativeTokenVault."
         }
       );
-      const assetData = await wrapAs6(
+      const assetData = await wrapAs7(
         "INTERNAL",
         OP_WITHDRAWALS.erc20.encodeAssetData,
         () => Promise.resolve(
-          AbiCoder.defaultAbiCoder().encode(
-            ["uint256", "address", "address"],
-            [p.amount, p.to ?? ctx.sender, p.token]
-          )
+          encodeNativeTokenVaultTransferData(p.amount, p.to ?? ctx.sender, p.token)
         ),
         {
           ctx: { where: "AbiCoder.encode", token: p.token, to: p.to ?? ctx.sender },
           message: "Failed to encode burn/withdraw asset data."
         }
       );
-      const l2ar = new Contract(ctx.l2AssetRouter, IL2AssetRouter_default, ctx.client.l2);
-      const dataWithdraw = await wrapAs6(
+      const l2ar = await ctx.contracts.l2AssetRouter();
+      const dataWithdraw = await wrapAs7(
         "INTERNAL",
         OP_WITHDRAWALS.erc20.encodeWithdraw,
         () => Promise.resolve(l2ar.interface.encodeFunctionData(SIG.withdraw, [assetId, assetData])),
@@ -1430,81 +1557,25 @@ function routeErc20NonBase2() {
       const withdrawTx = {
         to: ctx.l2AssetRouter,
         data: dataWithdraw,
-        from: ctx.sender,
-        ...txOverrides
+        from: ctx.sender
       };
+      const withdrawGas = await quoteL2Gas4({ ctx, tx: withdrawTx });
+      if (withdrawGas) {
+        withdrawTx.gasLimit = withdrawGas.gasLimit;
+        withdrawTx.maxFeePerGas = withdrawGas.maxFeePerGas;
+        withdrawTx.maxPriorityFeePerGas = withdrawGas.maxPriorityFeePerGas;
+      }
       steps.push({
         key: "l2-asset-router:withdraw",
         kind: "l2-asset-router:withdraw",
         description: "Burn on L2 & send L2\u2192L1 message",
         tx: withdrawTx
       });
-      return { steps, approvals, quoteExtras: {} };
-    }
-  };
-}
-var { wrapAs: wrapAs7 } = createErrorHandlers("withdrawals");
-function routeEthNonBase2() {
-  return {
-    async preflight(p, ctx) {
-      await wrapAs7(
-        "VALIDATION",
-        OP_WITHDRAWALS.ethNonBase.assertNonEthBase,
-        () => {
-          if (p.token.toLowerCase() !== L2_BASE_TOKEN_ADDRESS.toLowerCase()) {
-            throw new Error("eth-nonbase route requires the L2 base-token alias (0x\u2026800A).");
-          }
-          if (ctx.baseIsEth) {
-            throw new Error("eth-nonbase route requires chain base \u2260 ETH.");
-          }
-        },
-        { ctx: { token: p.token, baseIsEth: ctx.baseIsEth } }
-      );
-    },
-    async build(p, ctx) {
-      const steps = [];
-      const { gasLimit: overrideGasLimit, maxFeePerGas, maxPriorityFeePerGas } = ctx.fee;
-      const toL1 = p.to ?? ctx.sender;
-      const iface = new Interface(IBaseToken_default);
-      const data = await wrapAs7(
-        "INTERNAL",
-        OP_WITHDRAWALS.eth.encodeWithdraw,
-        // reuse label for base-token system call
-        () => Promise.resolve(iface.encodeFunctionData("withdraw", [toL1])),
-        { ctx: { where: "L2BaseToken.withdraw", to: toL1 } }
-      );
-      const tx = {
-        to: L2_BASE_TOKEN_ADDRESS,
-        data,
-        from: ctx.sender,
-        value: p.amount,
-        maxFeePerGas,
-        maxPriorityFeePerGas
-      };
-      if (overrideGasLimit != null) {
-        tx.gasLimit = overrideGasLimit;
-      } else {
-        try {
-          const est = await wrapAs7(
-            "RPC",
-            OP_WITHDRAWALS.eth.estGas,
-            () => ctx.client.l2.estimateGas(tx),
-            {
-              ctx: { where: "l2.estimateGas", to: L2_BASE_TOKEN_ADDRESS },
-              message: "Failed to estimate gas for L2 base-token withdraw."
-            }
-          );
-          tx.gasLimit = BigInt(est) * 115n / 100n;
-        } catch {
-        }
-      }
-      steps.push({
-        key: "l2-base-token:withdraw",
-        kind: "l2-base-token:withdraw",
-        description: "Withdraw base token via L2 Base Token System (base \u2260 ETH)",
-        tx
+      const fees = buildFeeBreakdown2({
+        feeToken: ctx.baseTokenL1 ?? await ctx.client.baseToken(ctx.chainIdL2),
+        l2Gas: withdrawGas
       });
-      return { steps, approvals: [], quoteExtras: {} };
+      return { steps, approvals, fees };
     }
   };
 }
@@ -1782,45 +1853,32 @@ function createFinalizationServices(client) {
 
 // src/adapters/ethers/resources/withdrawals/index.ts
 var ROUTES2 = {
-  "eth-base": routeEthBase(),
+  base: routeEthBase(),
   // BaseTokenSystem.withdraw, chain base = ETH
-  "eth-nonbase": routeEthNonBase2(),
-  // BaseTokenSystem.withdraw, chain base ≠ ETH
   "erc20-nonbase": routeErc20NonBase2()
   // AssetRouter.withdraw for non-base ERC-20s
 };
-function createWithdrawalsResource(client) {
+function createWithdrawalsResource(client, tokens, contracts) {
   const svc = createFinalizationServices(client);
   const { wrap: wrap2, toResult: toResult2 } = createErrorHandlers("withdrawals");
+  const tokensResource = tokens ?? createTokensResource(client);
+  const contractsResource = contracts ?? createContractsResource(client);
   async function buildPlan(p) {
-    const ctx = await commonCtx2(p, client);
+    const ctx = await commonCtx2(p, client, tokensResource, contractsResource);
     await ROUTES2[ctx.route].preflight?.(p, ctx);
-    const { steps, approvals } = await ROUTES2[ctx.route].build(p, ctx);
-    const resolveGasLimit = () => {
-      if (ctx.fee.gasLimit != null) return ctx.fee.gasLimit;
-      for (let i = steps.length - 1; i >= 0; i--) {
-        const candidate = steps[i].tx.gasLimit;
-        if (candidate == null) continue;
-        if (typeof candidate === "bigint") return candidate;
-        try {
-          return BigInt(candidate.toString());
-        } catch {
-        }
-      }
-      return void 0;
-    };
-    const gasLimit = resolveGasLimit();
-    const summary = {
+    const { steps, approvals, fees } = await ROUTES2[ctx.route].build(p, ctx);
+    return {
       route: ctx.route,
-      approvalsNeeded: approvals,
-      suggestedL2GasLimit: ctx.l2GasLimit,
-      fees: {
-        gasLimit,
-        maxFeePerGas: ctx.fee.maxFeePerGas,
-        maxPriorityFeePerGas: ctx.fee.maxPriorityFeePerGas
-      }
+      summary: {
+        route: ctx.route,
+        approvalsNeeded: approvals,
+        amounts: {
+          transfer: { token: p.token, amount: p.amount }
+        },
+        fees
+      },
+      steps
     };
-    return { route: ctx.route, summary, steps };
   }
   const finalizeCache = /* @__PURE__ */ new Map();
   const quote = (p) => wrap2(
@@ -2130,58 +2188,14 @@ function createWithdrawalsResource(client) {
 
 // src/adapters/ethers/sdk.ts
 function createEthersSdk(client) {
+  const tokens = createTokensResource(client);
+  const contracts = createContractsResource(client);
   return {
-    deposits: createDepositsResource(client),
-    withdrawals: createWithdrawalsResource(client),
-    // TODO: might update to create dedicated resources for these
-    helpers: {
-      addresses: () => client.ensureAddresses(),
-      contracts: () => client.contracts(),
-      async l1AssetRouter() {
-        const { l1AssetRouter } = await client.contracts();
-        return l1AssetRouter;
-      },
-      async l1NativeTokenVault() {
-        const { l1NativeTokenVault } = await client.contracts();
-        return l1NativeTokenVault;
-      },
-      async l1Nullifier() {
-        const { l1Nullifier } = await client.contracts();
-        return l1Nullifier;
-      },
-      async baseToken(chainId) {
-        const id = chainId ?? BigInt((await client.l2.getNetwork()).chainId);
-        return client.baseToken(id);
-      },
-      async l2TokenAddress(l1Token) {
-        if (isAddressEq(l1Token, FORMAL_ETH_ADDRESS)) {
-          return ETH_ADDRESS;
-        }
-        const { chainId } = await client.l2.getNetwork();
-        const base = await client.baseToken(BigInt(chainId));
-        if (isAddressEq(l1Token, base)) {
-          return L2_BASE_TOKEN_ADDRESS;
-        }
-        const { l2NativeTokenVault } = await client.contracts();
-        const addr = await l2NativeTokenVault.l2TokenAddress(l1Token);
-        return addr;
-      },
-      async l1TokenAddress(l2Token) {
-        if (isAddressEq(l2Token, ETH_ADDRESS)) {
-          return ETH_ADDRESS;
-        }
-        const { l2AssetRouter } = await client.contracts();
-        const addr = await l2AssetRouter.l1TokenAddress(l2Token);
-        return addr;
-      },
-      async assetId(l1Token) {
-        const norm = isAddressEq(l1Token, FORMAL_ETH_ADDRESS) ? ETH_ADDRESS : l1Token;
-        const { l1NativeTokenVault } = await client.contracts();
-        const id = await l1NativeTokenVault.assetId(norm);
-        return id;
-      }
-    }
+    deposits: createDepositsResource(client, tokens, contracts),
+    withdrawals: createWithdrawalsResource(client, tokens, contracts),
+    tokens,
+    contracts
   };
 }
 
-export { buildDirectRequestStruct, checkBaseCost, classifyReadinessFromRevert, createDepositsResource, createErrorHandlers, createEthersSdk, createFinalizationServices, createWithdrawalsResource, decodeRevert, encodeNTVAssetId, encodeNTVTransferData, encodeNativeTokenVaultAssetId, encodeNativeTokenVaultTransferData, encodeSecondBridgeArgs, encodeSecondBridgeDataV1, encodeSecondBridgeErc20Args, encodeSecondBridgeEthArgs, getFeeOverrides, getGasPriceWei, getL2FeeOverrides, registerErrorAbi, scaleGasLimit, toZKsyncError };
+export { buildDirectRequestStruct, createDepositsResource, createEthersSdk, createFinalizationServices, createTokensResource, createWithdrawalsResource, encodeNativeTokenVaultTransferData, encodeSecondBridgeArgs, encodeSecondBridgeDataV1, encodeSecondBridgeErc20Args, encodeSecondBridgeEthArgs };