@matterlabs/zksync-js 0.0.2 → 0.0.5

package/dist/adapters/ethers/sdk.cjs

@@ -40,6 +40,8 @@ function normalizeAddrEq(a, b) {
   };
   return normalize(a) === normalize(b);
 }
+var hexEq = (a, b) => a.toLowerCase() === b.toLowerCase();
+var normalizeL1Token = (token) => isAddressEq(token, FORMAL_ETH_ADDRESS) ? ETH_ADDRESS : token;
 
 // src/core/errors/formatter.ts
 function elideMiddle(s, max = 96) {
@@ -3556,27 +3558,35 @@ var MailboxABI = [
 ];
 var Mailbox_default = MailboxABI;
 
-// src/core/resources/deposits/route.ts
-async function pickDepositRoute(client, chainIdL2, token) {
-  if (isETH(token)) {
-    const base2 = await client.baseToken(chainIdL2);
-    return isETH(base2) ? "eth-base" : "eth-nonbase";
-  }
-  const base = await client.baseToken(chainIdL2);
-  return normalizeAddrEq(token, base) ? "erc20-base" : "erc20-nonbase";
-}
-
 // src/adapters/ethers/resources/deposits/context.ts
-async function commonCtx(p, client) {
-  const { bridgehub, l1AssetRouter } = await client.ensureAddresses();
+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 route = await pickDepositRoute(client, BigInt(chainId), p.token);
+  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,
@@ -3589,14 +3599,6 @@ async function commonCtx(p, client) {
     refundRecipient
   };
 }
-function encodeNativeTokenVaultAssetId(chainId, address) {
-  const abi = new ethers.AbiCoder();
-  const hex = abi.encode(
-    ["uint256", "address", "address"],
-    [chainId, L2_NATIVE_TOKEN_VAULT_ADDRESS, address]
-  );
-  return ethers.ethers.keccak256(hex);
-}
 function encodeNativeTokenVaultTransferData(amount, receiver, token) {
   return new ethers.AbiCoder().encode(["uint256", "address", "address"], [amount, receiver, token]);
 }
@@ -3964,7 +3966,7 @@ function createErrorHandlers(resource) {
   function wrap2(operation, fn, opts) {
     return run("INTERNAL", operation, fn, opts);
   }
-  function wrapAs8(kind, operation, fn, opts) {
+  function wrapAs9(kind, operation, fn, opts) {
     return run(kind, operation, fn, opts);
   }
   async function toResult2(operation, fn, opts) {
@@ -3985,13 +3987,13 @@ function createErrorHandlers(resource) {
       return { ok: false, error: shaped };
     }
   }
-  return { wrap: wrap2, wrapAs: wrapAs8, toResult: toResult2 };
+  return { wrap: wrap2, wrapAs: wrapAs9, toResult: toResult2 };
 }
 
 // src/adapters/ethers/resources/deposits/services/fee.ts
 var { wrapAs } = createErrorHandlers("deposits");
-var encode = (abi, fn, args) => {
-  return new ethers.Interface(abi).encodeFunctionData(fn, args);
+var encode = (abi2, fn, args) => {
+  return new ethers.Interface(abi2).encodeFunctionData(fn, args);
 };
 async function quoteL2BaseCost2(input) {
   const { ctx, l2GasLimit } = input;
@@ -4046,8 +4048,7 @@ async function determineErc20L2Gas(input) {
     });
   }
   try {
-    const { l2NativeTokenVault } = await ctx.client.contracts();
-    const l2TokenAddress = await l2NativeTokenVault.l2TokenAddress(l1Token);
+    const l2TokenAddress = ctx.tokens ? await ctx.tokens.toL2Address(l1Token) : await (await ctx.contracts.l2NativeTokenVault()).l2TokenAddress(l1Token);
     if (l2TokenAddress === "0x0000000000000000000000000000000000000000") {
       return quoteL2Gas2({
         ctx,
@@ -4116,7 +4117,7 @@ function buildFeeBreakdown(p) {
 function routeEthDirect() {
   return {
     async build(p, ctx) {
-      const bh = new ethers.Contract(ctx.bridgehub, IBridgehub_default, ctx.client.l1);
+      const bh = await ctx.contracts.bridgehub();
       const l2TxModel = {
         to: p.to ?? ctx.sender,
         from: ctx.sender,
@@ -4193,14 +4194,14 @@ function routeEthDirect() {
 var { wrapAs: wrapAs2 } = createErrorHandlers("deposits");
 function routeErc20NonBase() {
   return {
-    // TODO: do we even need these validations?
     async preflight(p, ctx) {
-      const baseToken = await ctx.client.baseToken(ctx.chainIdL2);
+      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.");
           }
         },
@@ -4209,8 +4210,8 @@ function routeErc20NonBase() {
     },
     async build(p, ctx) {
       const l1Signer = ctx.client.getL1Signer();
-      const baseToken = await ctx.client.baseToken(ctx.chainIdL2);
-      const baseIsEth = isETH(baseToken);
+      const baseToken = ctx.baseTokenL1 ?? await ctx.client.baseToken(ctx.chainIdL2);
+      const baseIsEth = ctx.baseIsEth ?? isETH(baseToken);
       const l2GasParams = await determineErc20L2Gas({
         ctx,
         l1Token: p.token,
@@ -4297,7 +4298,7 @@ function routeErc20NonBase() {
         secondBridgeValue: 0n,
         secondBridgeCalldata
       };
-      const bh = (await ctx.client.contracts()).bridgehub;
+      const bh = await ctx.contracts.bridgehub();
       const data = bh.interface.encodeFunctionData("requestL2TransactionTwoBridges", [
         requestStruct
       ]);
@@ -4346,26 +4347,26 @@ var { wrapAs: wrapAs3 } = createErrorHandlers("deposits");
 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 baseToken = await ctx.client.baseToken(ctx.chainIdL2);
       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",
@@ -4390,7 +4391,7 @@ function routeEthNonBase() {
     },
     async build(p, ctx) {
       const l1Signer = ctx.client.getL1Signer();
-      const baseToken = await ctx.client.baseToken(ctx.chainIdL2);
+      const baseToken = ctx.baseTokenL1;
       const l2TxModel = {
         to: p.to ?? ctx.sender,
         from: ctx.sender,
@@ -4455,11 +4456,10 @@ function routeEthNonBase() {
         secondBridgeValue: p.amount,
         secondBridgeCalldata
       };
-      const data = new ethers.Contract(
-        ctx.bridgehub,
-        IBridgehub_default,
-        ctx.client.l1
-      ).interface.encodeFunctionData("requestL2TransactionTwoBridges", [requestStruct]);
+      const bridgehub = await ctx.contracts.bridgehub();
+      const data = bridgehub.interface.encodeFunctionData("requestL2TransactionTwoBridges", [
+        requestStruct
+      ]);
       const l1TxCandidate = {
         to: ctx.bridgehub,
         data,
@@ -4505,17 +4505,18 @@ var { wrapAs: wrapAs4 } = createErrorHandlers("deposits");
 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 baseToken = await ctx.client.baseToken(ctx.chainIdL2);
+      const baseToken = ctx.baseTokenL1 ?? await ctx.client.baseToken(ctx.chainIdL2);
       await wrapAs4(
         "VALIDATION",
         OP_DEPOSITS.base.assertMatchesBase,
@@ -4530,7 +4531,7 @@ function routeErc20Base() {
     },
     async build(p, ctx) {
       const l1Signer = ctx.client.getL1Signer();
-      const baseToken = await ctx.client.baseToken(ctx.chainIdL2);
+      const baseToken = ctx.baseTokenL1 ?? await ctx.client.baseToken(ctx.chainIdL2);
       const l2TxModel = {
         to: p.to ?? ctx.sender,
         from: ctx.sender,
@@ -4583,11 +4584,10 @@ function routeErc20Base() {
         l2Contract: p.to ?? ctx.sender,
         l2Value: p.amount
       });
-      const data = new ethers.Contract(
-        ctx.bridgehub,
-        IBridgehub_default,
-        ctx.client.l1
-      ).interface.encodeFunctionData("requestL2TransactionDirect", [requestStruct]);
+      const bridgehub = await ctx.contracts.bridgehub();
+      const data = bridgehub.interface.encodeFunctionData("requestL2TransactionDirect", [
+        requestStruct
+      ]);
       const l1TxCandidate = {
         to: ctx.bridgehub,
         data,
@@ -4630,6 +4630,282 @@ function routeErc20Base() {
   };
 }
 
+// src/core/codec/ntv.ts
+function createNTVCodec(deps) {
+  function encodeAssetId(originChainId, ntvAddress, tokenAddress) {
+    const encoded = deps.encode(
+      ["uint256", "address", "address"],
+      [originChainId, ntvAddress, tokenAddress]
+    );
+    return deps.keccak256(encoded);
+  }
+  return {
+    encodeAssetId
+  };
+}
+
+// src/adapters/ethers/resources/tokens/tokens.ts
+var { wrapAs: wrapAs5 } = createErrorHandlers("tokens");
+var abi = ethers.AbiCoder.defaultAbiCoder();
+var ntvCodec = createNTVCodec({
+  encode: (types, values) => abi.encode(types, values),
+  keccak256: (data) => ethers.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");
 var ROUTES = {
@@ -4638,9 +4914,11 @@ 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, fees } = await ROUTES[route].build(p, ctx);
@@ -4918,25 +5196,9 @@ function pickWithdrawRoute(args) {
   if (isL2BaseAlias) return "base";
   return "erc20-nonbase";
 }
-async function ntvBaseAssetId(l2, ntv) {
-  const c = new ethers.Contract(ntv, L2NativeTokenVault_default, l2);
-  return await c.BASE_TOKEN_ASSET_ID();
-}
-async function ntvL1ChainId(l2, ntv) {
-  const c = new ethers.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,
@@ -4945,13 +5207,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 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});
   return {
     client,
+    tokens,
+    contracts,
+    resolvedToken,
+    baseTokenAssetId,
+    baseTokenL1,
     bridgehub,
     chainIdL2,
     sender,
@@ -5055,13 +5325,13 @@ function buildFeeBreakdown2(p) {
 }
 
 // src/adapters/ethers/resources/withdrawals/routes/eth.ts
-var { wrapAs: wrapAs5 } = createErrorHandlers("withdrawals");
+var { wrapAs: wrapAs6 } = createErrorHandlers("withdrawals");
 function routeEthBase() {
   return {
     async build(p, ctx) {
       const steps = [];
-      const base = (await ctx.client.contracts()).l2BaseTokenSystem;
-      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", [p.to ?? ctx.sender])),
@@ -5096,7 +5366,7 @@ function routeEthBase() {
     }
   };
 }
-var { wrapAs: wrapAs6 } = createErrorHandlers("withdrawals");
+var { wrapAs: wrapAs7 } = createErrorHandlers("withdrawals");
 var SIG = {
   withdraw: "withdraw(bytes32,bytes)"
 };
@@ -5106,7 +5376,7 @@ function routeErc20NonBase2() {
       const steps = [];
       const approvals = [];
       const erc20 = new ethers.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),
@@ -5144,17 +5414,21 @@ function routeErc20NonBase2() {
           tx: approveTx
         });
       }
-      const ntv = (await ctx.client.contracts()).l2NativeTokenVault;
-      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(
@@ -5165,8 +5439,8 @@ function routeErc20NonBase2() {
           message: "Failed to encode burn/withdraw asset data."
         }
       );
-      const l2ar = (await ctx.client.contracts()).l2AssetRouter;
-      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])),
@@ -5193,7 +5467,7 @@ function routeErc20NonBase2() {
         tx: withdrawTx
       });
       const fees = buildFeeBreakdown2({
-        feeToken: await ctx.client.baseToken(ctx.chainIdL2),
+        feeToken: ctx.baseTokenL1 ?? await ctx.client.baseToken(ctx.chainIdL2),
         l2Gas: withdrawGas
       });
       return { steps, approvals, fees };
@@ -5234,7 +5508,7 @@ function messengerLogIndex(raw, opts) {
 }
 
 // src/adapters/ethers/resources/withdrawals/services/finalization.ts
-var { wrapAs: wrapAs7 } = createErrorHandlers("withdrawals");
+var { wrapAs: wrapAs8 } = createErrorHandlers("withdrawals");
 var IL1NullifierMini = [
   "function isWithdrawalFinalized(uint256,uint256,uint256) view returns (bool)"
 ];
@@ -5242,7 +5516,7 @@ function createFinalizationServices(client) {
   const { l1, l2, signer } = client;
   return {
     async fetchFinalizeDepositParams(l2TxHash) {
-      const parsed = await wrapAs7(
+      const parsed = await wrapAs8(
         "RPC",
         OP_WITHDRAWALS.finalize.fetchParams.receipt,
         () => client.zks.getReceiptWithL2ToL1(l2TxHash),
@@ -5259,7 +5533,7 @@ function createFinalizationServices(client) {
           context: { l2TxHash }
         });
       }
-      const ev = await wrapAs7(
+      const ev = await wrapAs8(
         "INTERNAL",
         OP_WITHDRAWALS.finalize.fetchParams.findMessage,
         // eslint-disable-next-line @typescript-eslint/no-unsafe-argument, @typescript-eslint/no-explicit-any
@@ -5269,7 +5543,7 @@ function createFinalizationServices(client) {
           message: "Failed to locate L1MessageSent event in L2 receipt."
         }
       );
-      const message = await wrapAs7(
+      const message = await wrapAs8(
         "INTERNAL",
         OP_WITHDRAWALS.finalize.fetchParams.decodeMessage,
         () => Promise.resolve(ethers.AbiCoder.defaultAbiCoder().decode(["bytes"], ev.data)[0]),
@@ -5278,7 +5552,7 @@ function createFinalizationServices(client) {
           message: "Failed to decode withdrawal message."
         }
       );
-      const raw = await wrapAs7(
+      const raw = await wrapAs8(
         "RPC",
         OP_WITHDRAWALS.finalize.fetchParams.rawReceipt,
         () => client.zks.getReceiptWithL2ToL1(l2TxHash),
@@ -5295,7 +5569,7 @@ function createFinalizationServices(client) {
           context: { l2TxHash }
         });
       }
-      const idx = await wrapAs7(
+      const idx = await wrapAs8(
         "INTERNAL",
         OP_WITHDRAWALS.finalize.fetchParams.messengerIndex,
         () => Promise.resolve(messengerLogIndex(raw, { index: 0, messenger: L1_MESSENGER_ADDRESS })),
@@ -5304,7 +5578,7 @@ function createFinalizationServices(client) {
           message: "Failed to derive messenger log index."
         }
       );
-      const proof = await wrapAs7(
+      const proof = await wrapAs8(
         "RPC",
         OP_WITHDRAWALS.finalize.fetchParams.proof,
         () => client.zks.getL2ToL1LogProof(l2TxHash, idx),
@@ -5313,7 +5587,7 @@ function createFinalizationServices(client) {
           message: "Failed to fetch L2\u2192L1 log proof."
         }
       );
-      const { chainId } = await wrapAs7(
+      const { chainId } = await wrapAs8(
         "RPC",
         OP_WITHDRAWALS.finalize.fetchParams.network,
         () => l2.getNetwork(),
@@ -5332,7 +5606,7 @@ function createFinalizationServices(client) {
         message,
         merkleProof: proof.proof
       };
-      const { l1Nullifier } = await wrapAs7(
+      const { l1Nullifier } = await wrapAs8(
         "INTERNAL",
         OP_WITHDRAWALS.finalize.fetchParams.ensureAddresses,
         () => client.ensureAddresses(),
@@ -5344,7 +5618,7 @@ function createFinalizationServices(client) {
       return { params, nullifier: l1Nullifier };
     },
     async simulateFinalizeReadiness(params) {
-      const { l1Nullifier } = await wrapAs7(
+      const { l1Nullifier } = await wrapAs8(
         "INTERNAL",
         OP_WITHDRAWALS.finalize.readiness.ensureAddresses,
         () => client.ensureAddresses(),
@@ -5356,7 +5630,7 @@ function createFinalizationServices(client) {
       const done = await (async () => {
         try {
           const cMini = new ethers.Contract(l1Nullifier, IL1NullifierMini, l1);
-          const isFinalized = await wrapAs7(
+          const isFinalized = await wrapAs8(
             "RPC",
             OP_WITHDRAWALS.finalize.readiness.isFinalized,
             () => cMini.isWithdrawalFinalized(
@@ -5384,7 +5658,7 @@ function createFinalizationServices(client) {
       }
     },
     async isWithdrawalFinalized(key) {
-      const { l1Nullifier } = await wrapAs7(
+      const { l1Nullifier } = await wrapAs8(
         "INTERNAL",
         OP_WITHDRAWALS.finalize.fetchParams.ensureAddresses,
         () => client.ensureAddresses(),
@@ -5394,7 +5668,7 @@ function createFinalizationServices(client) {
         }
       );
       const c = new ethers.Contract(l1Nullifier, IL1NullifierMini, l1);
-      return await wrapAs7(
+      return await wrapAs8(
         "RPC",
         OP_WITHDRAWALS.finalize.isFinalized,
         () => c.isWithdrawalFinalized(key.chainIdL2, key.l2BatchNumber, key.l2MessageIndex),
@@ -5405,7 +5679,7 @@ function createFinalizationServices(client) {
       );
     },
     async estimateFinalization(params) {
-      const { l1Nullifier } = await wrapAs7(
+      const { l1Nullifier } = await wrapAs8(
         "INTERNAL",
         OP_WITHDRAWALS.finalize.estimate,
         () => client.ensureAddresses(),
@@ -5416,7 +5690,7 @@ function createFinalizationServices(client) {
       );
       const signer2 = client.getL1Signer();
       const c = new ethers.Contract(l1Nullifier, IL1Nullifier_default, signer2);
-      const gasLimit = await wrapAs7(
+      const gasLimit = await wrapAs8(
         "RPC",
         OP_WITHDRAWALS.finalize.estimate,
         () => c.finalizeDeposit.estimateGas(params),
@@ -5431,7 +5705,7 @@ function createFinalizationServices(client) {
           message: "Failed to estimate gas for finalizeDeposit."
         }
       );
-      const feeData = await wrapAs7("RPC", OP_WITHDRAWALS.finalize.estimate, () => l1.getFeeData(), {
+      const feeData = await wrapAs8("RPC", OP_WITHDRAWALS.finalize.estimate, () => l1.getFeeData(), {
         ctx: { where: "l1.getFeeData" },
         message: "Failed to estimate fee data for finalizeDeposit."
       });
@@ -5452,7 +5726,7 @@ function createFinalizationServices(client) {
       };
     },
     async finalizeDeposit(params) {
-      const { l1Nullifier } = await wrapAs7(
+      const { l1Nullifier } = await wrapAs8(
         "INTERNAL",
         OP_WITHDRAWALS.finalize.fetchParams.ensureAddresses,
         () => client.ensureAddresses(),
@@ -5513,11 +5787,13 @@ var ROUTES2 = {
   "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, fees } = await ROUTES2[ctx.route].build(p, ctx);
     return {
@@ -5841,57 +6117,13 @@ 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
   };
 }