@matterlabs/zksync-js 0.0.1 → 0.0.3

package/dist/chunk-XRE7H466.js

@@ -0,0 +1,157 @@
+import { REVERT_TO_READINESS } from './chunk-NCAIVYBR.js';
+import { IL1Nullifier_default, IERC20_default, L1NativeTokenVault_default, L2NativeTokenVault_default, Mailbox_default, isZKsyncError, createError, shapeCause } from './chunk-M5J2MM2U.js';
+import { Interface } from 'ethers';
+
+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
+        };
+      }
+    } catch {
+    }
+  }
+  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/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) });
+}
+function resolveMessage(op, msg) {
+  if (!msg) return `Error during ${op}.`;
+  return typeof msg === "function" ? msg() : msg;
+}
+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 wrap(operation, fn, opts) {
+    return run("INTERNAL", operation, fn, opts);
+  }
+  function wrapAs(kind, operation, fn, opts) {
+    return run(kind, operation, fn, opts);
+  }
+  async function toResult(operation, fn, opts) {
+    try {
+      const value = await wrap(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 };
+    }
+  }
+  return { wrap, wrapAs, toResult };
+}
+
+export { classifyReadinessFromRevert, createErrorHandlers, decodeRevert, registerErrorAbi, toZKsyncError };

package/dist/{chunk-BD2LUO5T.js → chunk-YUK547UF.js}

@@ -1,6 +1,6 @@
-import { createZksRpc, makeTransportFromViem } from './chunk-4HLJJKIY.js';
-import { IBridgehub_default, IL1AssetRouter_default, IL1Nullifier_default, IBaseToken_default, L2NativeTokenVault_default, IL2AssetRouter_default, L1NativeTokenVault_default } from './chunk-Y75OMFK6.js';
-import { L2_ASSET_ROUTER_ADDRESS, L2_NATIVE_TOKEN_VAULT_ADDRESS, L2_BASE_TOKEN_ADDRESS } from './chunk-6GCT6TLS.js';
+import { createZksRpc, makeTransportFromViem } from './chunk-6K6VJQAL.js';
+import { IBridgehub_default, IL1AssetRouter_default, IL1Nullifier_default, IBaseToken_default, L2NativeTokenVault_default, IL2AssetRouter_default, L1NativeTokenVault_default } from './chunk-M5J2MM2U.js';
+import { L2_ASSET_ROUTER_ADDRESS, L2_NATIVE_TOKEN_VAULT_ADDRESS, L2_BASE_TOKEN_ADDRESS } from './chunk-F2ENUV3A.js';
 import { getContract, createWalletClient } from 'viem';
 
 // src/adapters/viem/rpc.ts

package/dist/core/abi.d.ts

@@ -0,0 +1,9 @@
+export { default as IBridgehubABI } from './internal/abis/IBridgehub';
+export { default as IL1AssetRouterABI } from './internal/abis/IL1AssetRouter';
+export { default as IL1NullifierABI } from './internal/abis/IL1Nullifier';
+export { default as IL2AssetRouterABI } from './internal/abis/IL2AssetRouter';
+export { default as L1NativeTokenVaultABI } from './internal/abis/L1NativeTokenVault';
+export { default as L2NativeTokenVaultABI } from './internal/abis/L2NativeTokenVault';
+export { default as IBaseTokenABI } from './internal/abis/IBaseToken';
+export { default as IERC20ABI } from './internal/abis/IERC20';
+export { default as MailboxABI } from './internal/abis/Mailbox';

package/dist/core/adapters/interfaces.d.ts

@@ -0,0 +1,25 @@
+import type { Address } from '../types/primitives';
+export interface CoreTransactionRequest {
+    to: Address;
+    from?: Address;
+    data?: string;
+    value?: bigint;
+    gasLimit?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+}
+export interface GasEstimator {
+    estimateGas(tx: CoreTransactionRequest, stateOverrides?: Record<string, unknown>): Promise<bigint>;
+    estimateFeesPerGas(): Promise<{
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+        gasPrice?: bigint;
+    }>;
+    getGasPrice(): Promise<bigint>;
+    call(tx: {
+        to: Address;
+        data?: string;
+        value?: bigint;
+        from?: Address;
+    }): Promise<string>;
+}

package/dist/core/codec/ntv.d.ts

@@ -0,0 +1,48 @@
+import type { Address, Hex } from '../types/primitives';
+/**
+ * Dependencies injected by the adapter (ethers or viem)
+ */
+export interface NTVCodecDeps {
+    /**
+     * ABI encoder: (types, values) => encoded hex string
+     * For ethers: AbiCoder.encode
+     * For viem: encodeAbiParameters
+     */
+    encode(types: string[], values: unknown[]): Hex;
+    /**
+     * Keccak-256 hash function: (data) => hash as hex string
+     * For ethers: ethers.keccak256
+     * For viem: keccak256
+     */
+    keccak256(data: Hex): Hex;
+}
+/**
+ * Factory to create NTV (Native Token Vault) codec utilities.
+ * This keeps core adapter-agnostic while enabling code reuse.
+ *
+ * @param deps - Adapter-specific encode and keccak256 implementations
+ * @returns Codec utilities for NTV assetId encoding
+ *
+ * @example
+ * ```typescript
+ * // Ethers adapter
+ * import { AbiCoder, ethers } from 'ethers';
+ * const codec = createNTVCodec({
+ *   encode: (types, values) => new AbiCoder().encode(types, values),
+ *   keccak256: ethers.keccak256
+ * });
+ *
+ * // Viem adapter
+ * import { encodeAbiParameters, keccak256 } from 'viem';
+ * const codec = createNTVCodec({
+ *   encode: (types, values) => encodeAbiParameters(
+ *     types.map((t, i) => ({ type: t, name: `arg${i}` })),
+ *     values
+ *   ),
+ *   keccak256
+ * });
+ * ```
+ */
+export declare function createNTVCodec(deps: NTVCodecDeps): {
+    encodeAssetId: (originChainId: bigint, ntvAddress: Address, tokenAddress: Address) => Hex;
+};

package/dist/core/constants.cjs

@@ -17,9 +17,18 @@ var TOPIC_L1_MESSAGE_SENT_NEW = k256hex("L1MessageSent(uint256,bytes32,bytes)");
 var TOPIC_L1_MESSAGE_SENT_LEG = k256hex("L1MessageSent(address,bytes32,bytes)");
 var TOPIC_CANONICAL_ASSIGNED = "0x779f441679936c5441b671969f37400b8c3ed0071cb47444431bf985754560df";
 var TOPIC_CANONICAL_SUCCESS = "0xe4def01b981193a97a9e81230d7b9f31812ceaf23f864a828a82c687911cb2df";
+var BUFFER = 20n;
+var TX_OVERHEAD_GAS = 10000n;
+var TX_MEMORY_OVERHEAD_GAS = 10n;
+var DEFAULT_PUBDATA_BYTES = 155n;
+var DEFAULT_ABI_BYTES = 400n;
+var SAFE_L1_BRIDGE_GAS = 600000n;
 var L1_FEE_ESTIMATION_COEF_NUMERATOR = 12;
 var L1_FEE_ESTIMATION_COEF_DENOMINATOR = 10;
 
+exports.BUFFER = BUFFER;
+exports.DEFAULT_ABI_BYTES = DEFAULT_ABI_BYTES;
+exports.DEFAULT_PUBDATA_BYTES = DEFAULT_PUBDATA_BYTES;
 exports.ETH_ADDRESS = ETH_ADDRESS;
 exports.FORMAL_ETH_ADDRESS = FORMAL_ETH_ADDRESS;
 exports.L1_FEE_ESTIMATION_COEF_DENOMINATOR = L1_FEE_ESTIMATION_COEF_DENOMINATOR;
@@ -29,11 +38,14 @@ exports.L1_SOPH_TOKEN_ADDRESS = L1_SOPH_TOKEN_ADDRESS;
 exports.L2_ASSET_ROUTER_ADDRESS = L2_ASSET_ROUTER_ADDRESS;
 exports.L2_BASE_TOKEN_ADDRESS = L2_BASE_TOKEN_ADDRESS;
 exports.L2_NATIVE_TOKEN_VAULT_ADDRESS = L2_NATIVE_TOKEN_VAULT_ADDRESS;
+exports.SAFE_L1_BRIDGE_GAS = SAFE_L1_BRIDGE_GAS;
 exports.TOPIC_CANONICAL_ASSIGNED = TOPIC_CANONICAL_ASSIGNED;
 exports.TOPIC_CANONICAL_SUCCESS = TOPIC_CANONICAL_SUCCESS;
 exports.TOPIC_L1_MESSAGE_SENT = TOPIC_L1_MESSAGE_SENT;
 exports.TOPIC_L1_MESSAGE_SENT_LEG = TOPIC_L1_MESSAGE_SENT_LEG;
 exports.TOPIC_L1_MESSAGE_SENT_NEW = TOPIC_L1_MESSAGE_SENT_NEW;
+exports.TX_MEMORY_OVERHEAD_GAS = TX_MEMORY_OVERHEAD_GAS;
+exports.TX_OVERHEAD_GAS = TX_OVERHEAD_GAS;
 exports.k256hex = k256hex;
 //# sourceMappingURL=constants.cjs.map
 //# sourceMappingURL=constants.cjs.map

package/dist/core/constants.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/constants.ts"],"names":["bytesToHex","keccak_256","utf8ToBytes"],"mappings":";;;;;;AAQO,IAAM,OAAA,GAAU,CAAC,CAAA,KACtB,CAAA,EAAA,EAAKA,gBAAA,CAAWC,eAAA,CAAWC,iBAAA,CAAY,CAAC,CAAC,CAAC,CAAC,CAAA,CAAA,CAAG,WAAA;AAOzC,IAAM,kBAAA,GAA8B;AAGpC,IAAM,WAAA,GAAuB;AAG7B,IAAM,uBAAA,GAAmC;AAGzC,IAAM,6BAAA,GAAyC;AAG/C,IAAM,oBAAA,GAAgC;AAGtC,IAAM,qBAAA,GAAiC;AAGvC,IAAM,qBAAA,GAAiC;AAOvC,IAAM,qBAAA,GACX;AAGK,IAAM,yBAAA,GAAiC,QAAQ,sCAAsC;AAGrF,IAAM,yBAAA,GAAiC,QAAQ,sCAAsC;AAGrF,IAAM,wBAAA,GACX;AAGK,IAAM,uBAAA,GACX;AAUK,IAAM,gCAAA,GAAmC;AAMzC,IAAM,kCAAA,GAAqC","file":"constants.cjs"}
+{"version":3,"sources":["../../src/core/constants.ts"],"names":["bytesToHex","keccak_256","utf8ToBytes"],"mappings":";;;;;;AAQO,IAAM,OAAA,GAAU,CAAC,CAAA,KACtB,CAAA,EAAA,EAAKA,gBAAA,CAAWC,eAAA,CAAWC,iBAAA,CAAY,CAAC,CAAC,CAAC,CAAC,CAAA,CAAA,CAAG,WAAA;AAOzC,IAAM,kBAAA,GAA8B;AAGpC,IAAM,WAAA,GAAuB;AAG7B,IAAM,uBAAA,GAAmC;AAGzC,IAAM,6BAAA,GAAyC;AAG/C,IAAM,oBAAA,GAAgC;AAGtC,IAAM,qBAAA,GAAiC;AAGvC,IAAM,qBAAA,GAAiC;AAOvC,IAAM,qBAAA,GACX;AAGK,IAAM,yBAAA,GAAiC,QAAQ,sCAAsC;AAGrF,IAAM,yBAAA,GAAiC,QAAQ,sCAAsC;AAGrF,IAAM,wBAAA,GACX;AAGK,IAAM,uBAAA,GACX;AASK,IAAM,MAAA,GAAS;AAEf,IAAM,eAAA,GAAkB;AAExB,IAAM,sBAAA,GAAyB;AAE/B,IAAM,qBAAA,GAAwB;AAE9B,IAAM,iBAAA,GAAoB;AAE1B,IAAM,kBAAA,GAAqB;AAM3B,IAAM,gCAAA,GAAmC;AAMzC,IAAM,kCAAA,GAAqC","file":"constants.cjs"}

package/dist/core/constants.d.ts

@@ -24,6 +24,12 @@ export declare const TOPIC_L1_MESSAGE_SENT_LEG: Hex;
 export declare const TOPIC_CANONICAL_ASSIGNED: Hex;
 /** Optional canonical success marker. */
 export declare const TOPIC_CANONICAL_SUCCESS: Hex;
+export declare const BUFFER = 20n;
+export declare const TX_OVERHEAD_GAS = 10000n;
+export declare const TX_MEMORY_OVERHEAD_GAS = 10n;
+export declare const DEFAULT_PUBDATA_BYTES = 155n;
+export declare const DEFAULT_ABI_BYTES = 400n;
+export declare const SAFE_L1_BRIDGE_GAS = 600000n;
 /**
  * Numerator used in scaling the gas limit to help ensure acceptance of L1->L2 txs.
  * Used with {@link L1_FEE_ESTIMATION_COEF_DENOMINATOR}.

package/dist/core/constants.js

@@ -1 +1 @@
-export { ETH_ADDRESS, FORMAL_ETH_ADDRESS, L1_FEE_ESTIMATION_COEF_DENOMINATOR, L1_FEE_ESTIMATION_COEF_NUMERATOR, L1_MESSENGER_ADDRESS, L1_SOPH_TOKEN_ADDRESS, L2_ASSET_ROUTER_ADDRESS, L2_BASE_TOKEN_ADDRESS, L2_NATIVE_TOKEN_VAULT_ADDRESS, TOPIC_CANONICAL_ASSIGNED, TOPIC_CANONICAL_SUCCESS, TOPIC_L1_MESSAGE_SENT, TOPIC_L1_MESSAGE_SENT_LEG, TOPIC_L1_MESSAGE_SENT_NEW, k256hex } from '../chunk-6GCT6TLS.js';
+export { BUFFER, DEFAULT_ABI_BYTES, DEFAULT_PUBDATA_BYTES, ETH_ADDRESS, FORMAL_ETH_ADDRESS, L1_FEE_ESTIMATION_COEF_DENOMINATOR, L1_FEE_ESTIMATION_COEF_NUMERATOR, L1_MESSENGER_ADDRESS, L1_SOPH_TOKEN_ADDRESS, L2_ASSET_ROUTER_ADDRESS, L2_BASE_TOKEN_ADDRESS, L2_NATIVE_TOKEN_VAULT_ADDRESS, SAFE_L1_BRIDGE_GAS, TOPIC_CANONICAL_ASSIGNED, TOPIC_CANONICAL_SUCCESS, TOPIC_L1_MESSAGE_SENT, TOPIC_L1_MESSAGE_SENT_LEG, TOPIC_L1_MESSAGE_SENT_NEW, TX_MEMORY_OVERHEAD_GAS, TX_OVERHEAD_GAS, k256hex } from '../chunk-F2ENUV3A.js';