@matterlabs/zksync-js 0.0.2 → 0.0.5

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

@@ -7,6 +7,7 @@ export type { DepositsResource } from './resources/deposits';
 export { createWithdrawalsResource } from './resources/withdrawals';
 export { createFinalizationServices } from './resources/withdrawals';
 export type { WithdrawalsResource, FinalizationServices } from './resources/withdrawals';
+export { createTokensResource } from './resources/tokens';
 export * from './errors/error-ops';
 export * from './errors/revert';
 export type * from './typechain';

package/dist/adapters/ethers/index.js

@@ -1,8 +1,8 @@
 export { createEthersClient as createClient, createEthersClient } from '../../chunk-3MRGU4HV.js';
-export { buildDirectRequestStruct, createDepositsResource, createEthersSdk, createFinalizationServices, createWithdrawalsResource, encodeNTVAssetId, encodeNTVTransferData, encodeNativeTokenVaultAssetId, encodeNativeTokenVaultTransferData, encodeSecondBridgeArgs, encodeSecondBridgeDataV1, encodeSecondBridgeErc20Args, encodeSecondBridgeEthArgs } from '../../chunk-BCCKWWOX.js';
+export { buildDirectRequestStruct, createDepositsResource, createEthersSdk, createFinalizationServices, createTokensResource, createWithdrawalsResource, encodeNativeTokenVaultTransferData, encodeSecondBridgeArgs, encodeSecondBridgeDataV1, encodeSecondBridgeErc20Args, encodeSecondBridgeEthArgs } from '../../chunk-NBJEQAOE.js';
 export { classifyReadinessFromRevert, createErrorHandlers, decodeRevert, registerErrorAbi, toZKsyncError } from '../../chunk-XRE7H466.js';
-import '../../chunk-QJS6ETEE.js';
-import '../../chunk-HLUANWGN.js';
+import '../../chunk-LL3WKCFJ.js';
+import '../../chunk-NEC2ZKHI.js';
 import '../../chunk-NCAIVYBR.js';
 import '../../chunk-6K6VJQAL.js';
 import '../../chunk-M5J2MM2U.js';

package/dist/adapters/ethers/resources/contracts/contracts.d.ts

@@ -0,0 +1,9 @@
+import type { EthersClient } from '../../client';
+import type { ContractsResource } from './types';
+/**
+ * Creates a contracts resource for managing resolved addresses and contract instances.
+ *
+ * @param client - EthersClient instance
+ * @returns ContractsResource instance
+ */
+export declare function createContractsResource(client: EthersClient): ContractsResource;

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

@@ -0,0 +1,2 @@
+export { createContractsResource } from './contracts';
+export type { ContractsResource, ContractInstances } from './types';

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

@@ -0,0 +1,60 @@
+import type { Contract } from 'ethers';
+import type { ResolvedAddresses } from '../../client';
+/**
+ * Collection of typed ethers Contract instances for all bridge contracts.
+ */
+export interface ContractInstances {
+    bridgehub: Contract;
+    l1AssetRouter: Contract;
+    l1Nullifier: Contract;
+    l1NativeTokenVault: Contract;
+    l2AssetRouter: Contract;
+    l2NativeTokenVault: Contract;
+    l2BaseTokenSystem: Contract;
+}
+/**
+ * Contracts resource interface providing access to resolved addresses
+ * and contract instances.
+ */
+export interface ContractsResource {
+    /**
+     * Returns resolved addresses for all bridge contracts.
+     *
+     * @returns Resolved contract addresses
+     */
+    addresses(): Promise<ResolvedAddresses>;
+    /**
+     * Returns typed Contract instances for all bridge contracts (cached).
+     *
+     * @returns Contract instances
+     */
+    instances(): Promise<ContractInstances>;
+    /**
+     * Returns the Bridgehub contract instance.
+     */
+    bridgehub(): Promise<Contract>;
+    /**
+     * Returns the L1 Asset Router contract instance.
+     */
+    l1AssetRouter(): Promise<Contract>;
+    /**
+     * Returns the L1 Native Token Vault contract instance.
+     */
+    l1NativeTokenVault(): Promise<Contract>;
+    /**
+     * Returns the L1 Nullifier contract instance.
+     */
+    l1Nullifier(): Promise<Contract>;
+    /**
+     * Returns the L2 Asset Router contract instance.
+     */
+    l2AssetRouter(): Promise<Contract>;
+    /**
+     * Returns the L2 Native Token Vault contract instance.
+     */
+    l2NativeTokenVault(): Promise<Contract>;
+    /**
+     * Returns the L2 Base Token System contract instance.
+     */
+    l2BaseTokenSystem(): Promise<Contract>;
+}

package/dist/adapters/ethers/resources/deposits/context.d.ts

@@ -1,10 +1,18 @@
 import type { EthersClient } from '../../client';
-import type { Address } from '../../../../core/types/primitives';
+import type { Address, Hex } from '../../../../core/types/primitives';
 import type { DepositParams, DepositRoute } from '../../../../core/types/flows/deposits';
 import type { CommonCtx } from '../../../../core/types/flows/base';
 import type { TxOverrides } from '../../../../core/types/fees';
+import type { ResolvedToken, TokensResource } from '../../../../core/types/flows/token';
+import type { ContractsResource } from '../contracts';
 export interface BuildCtx extends CommonCtx {
     client: EthersClient;
+    tokens: TokensResource;
+    contracts: ContractsResource;
+    resolvedToken: ResolvedToken;
+    baseTokenAssetId: Hex;
+    baseTokenL1: Address;
+    baseIsEth: boolean;
     l1AssetRouter: Address;
     gasOverrides?: TxOverrides;
     l2GasLimit?: bigint;
@@ -12,8 +20,14 @@ export interface BuildCtx extends CommonCtx {
     operatorTip: bigint;
     refundRecipient: Address;
 }
-export declare function commonCtx(p: DepositParams, client: EthersClient): Promise<{
+export declare function commonCtx(p: DepositParams, client: EthersClient, tokens: TokensResource, contracts: ContractsResource): Promise<{
     client: EthersClient;
+    tokens: TokensResource;
+    contracts: ContractsResource;
+    resolvedToken: ResolvedToken;
+    baseTokenAssetId: `0x${string}`;
+    baseTokenL1: `0x${string}`;
+    baseIsEth: boolean;
     l1AssetRouter: `0x${string}`;
     route: DepositRoute;
     bridgehub: `0x${string}`;

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

@@ -3,6 +3,8 @@ import type { DepositParams, DepositQuote, DepositHandle, DepositWaitable, Depos
 import type { Hex } from '../../../../core/types/primitives.ts';
 import { type TransactionRequest, type TransactionReceipt } from 'ethers';
 import type { DepositRouteStrategy } from './routes/types.ts';
+import type { TokensResource } from '../../../../core/types/flows/token';
+import type { ContractsResource } from '../contracts';
 export declare const ROUTES: Record<DepositRoute, DepositRouteStrategy>;
 export interface DepositsResource {
     quote(p: DepositParams): Promise<DepositQuote>;
@@ -43,4 +45,4 @@ export interface DepositsResource {
         error: unknown;
     }>;
 }
-export declare function createDepositsResource(client: EthersClient): DepositsResource;
+export declare function createDepositsResource(client: EthersClient, tokens?: TokensResource, contracts?: ContractsResource): DepositsResource;

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

@@ -2,6 +2,7 @@ import type { TransactionRequest } from 'ethers';
 import type { BuildCtx } from '../context';
 import type { DepositRoute } from '../../../../../core/types/flows/deposits';
 import type { TxOverrides } from '../../../../../core/types/fees';
+import type { Address } from '../../../../../core/types/primitives';
 import { type GasQuote } from '../../../../../core/resources/deposits/gas';
 export type { GasQuote };
 export type QuoteL1GasInput = {
@@ -19,7 +20,7 @@ export type QuoteL2GasInput = {
 };
 export type ResolveErc20L2GasLimitInput = {
     ctx: BuildCtx;
-    l1Token: string;
+    l1Token: Address;
 };
 /**
  * Quote L1 gas for a deposit transaction.
@@ -35,6 +36,6 @@ export declare function quoteL2Gas(input: QuoteL2GasInput): Promise<GasQuote | u
  */
 export declare function determineErc20L2Gas(input: {
     ctx: BuildCtx;
-    l1Token: string;
+    l1Token: Address;
     modelTx?: TransactionRequest;
 }): Promise<GasQuote | undefined>;

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

@@ -0,0 +1 @@
+export { createTokensResource } from './tokens';

package/dist/adapters/ethers/resources/tokens/tokens.d.ts

@@ -0,0 +1,10 @@
+import type { EthersClient } from '../../client';
+import type { TokensResource } from '../../../../core/types/flows/token';
+/**
+ * Creates a tokens resource for managing token identity, L1/L2 mappings,
+ * and bridge assetId primitives.
+ *
+ * @param client - EthersClient instance
+ * @returns TokensResource instance
+ */
+export declare function createTokensResource(client: EthersClient): TokensResource;

package/dist/adapters/ethers/resources/utils.d.ts

@@ -1,9 +1,6 @@
 import type { Address } from '../../../core/types';
-export declare function encodeNativeTokenVaultAssetId(chainId: bigint, address: string): string;
 export declare function encodeNativeTokenVaultTransferData(amount: bigint, receiver: Address, token: Address): string;
 export declare function encodeSecondBridgeDataV1(assetId: string, transferData: string): string;
-export declare function encodeNTVAssetId(chainId: bigint, address: string): string;
-export declare const encodeNTVTransferData: typeof encodeNativeTokenVaultTransferData;
 export declare function encodeSecondBridgeArgs(token: Address, amount: bigint, l2Receiver: Address): `0x${string}`;
 export declare function encodeSecondBridgeErc20Args(token: Address, amount: bigint, l2Receiver: Address): `0x${string}`;
 export declare function encodeSecondBridgeEthArgs(amount: bigint, l2Receiver: Address, ethToken?: Address): `0x${string}`;

package/dist/adapters/ethers/resources/withdrawals/context.d.ts

@@ -1,19 +1,27 @@
 import type { EthersClient } from '../../client';
 import type { Address } from '../../../../core/types/primitives';
-import type { WithdrawParams, WithdrawRoute } from '../../../../core/types/flows/withdrawals';
+import { type WithdrawParams, type WithdrawRoute } from '../../../../core/types/flows/withdrawals';
 import type { CommonCtx } from '../../../../core/types/flows/base';
 import type { TxOverrides } from '../../../../core/types/fees';
+import type { Hex } from '../../../../core/types/primitives';
+import type { ResolvedToken, TokensResource } from '../../../../core/types/flows/token';
+import type { ContractsResource } from '../contracts';
 export interface BuildCtx extends CommonCtx {
     client: EthersClient;
+    tokens: TokensResource;
+    contracts: ContractsResource;
+    resolvedToken: ResolvedToken;
+    baseTokenAssetId: Hex;
+    baseTokenL1: Address;
+    baseIsEth: boolean;
     bridgehub: Address;
     l1AssetRouter: Address;
     l1Nullifier: Address;
     l2AssetRouter: Address;
     l2NativeTokenVault: Address;
     l2BaseTokenSystem: Address;
-    baseIsEth: boolean;
     gasOverrides?: TxOverrides;
 }
-export declare function commonCtx(p: WithdrawParams, client: EthersClient): Promise<BuildCtx & {
+export declare function commonCtx(p: WithdrawParams, client: EthersClient, tokens: TokensResource, contracts: ContractsResource): Promise<BuildCtx & {
     route: WithdrawRoute;
 }>;

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

@@ -4,6 +4,8 @@ import type { WithdrawParams, WithdrawQuote, WithdrawPlan, WithdrawHandle, Withd
 import type { Hex } from '../../../../core/types/primitives';
 import type { WithdrawRouteStrategy, TransactionReceiptZKsyncOS } from './routes/types';
 import { createFinalizationServices, type FinalizationServices } from './services/finalization';
+import type { TokensResource } from '../../../../core/types/flows/token';
+import type { ContractsResource } from '../contracts';
 export declare const ROUTES: Record<WithdrawRoute, WithdrawRouteStrategy>;
 export interface WithdrawalsResource {
     quote(p: WithdrawParams): Promise<WithdrawQuote>;
@@ -51,6 +53,6 @@ export interface WithdrawalsResource {
         error: unknown;
     }>;
 }
-export declare function createWithdrawalsResource(client: EthersClient): WithdrawalsResource;
+export declare function createWithdrawalsResource(client: EthersClient, tokens?: TokensResource, contracts?: ContractsResource): WithdrawalsResource;
 export { createFinalizationServices };
 export type { FinalizationServices };