viem 2.33.1 → 2.33.3

package/account-abstraction/index.ts

@@ -253,3 +253,4 @@ export {
   getUserOperationTypedData,
 } from './utils/userOperation/getUserOperationTypedData.js'
 export { toPackedUserOperation } from './utils/userOperation/toPackedUserOperation.js'
+export { toUserOperation } from './utils/userOperation/toUserOperation.js'

package/account-abstraction/utils/userOperation/toUserOperation.ts

@@ -0,0 +1,3 @@
+import * as UserOperation from 'ox/erc4337/UserOperation'
+
+export const toUserOperation = UserOperation.from

package/actions/wallet/waitForCallsStatus.ts

@@ -1,11 +1,16 @@
 import type { Client } from '../../clients/createClient.js'
 import type { Transport } from '../../clients/transports/createTransport.js'
 import { BaseError } from '../../errors/base.js'
+import { BundleFailedError } from '../../errors/calls.js'
 import type { ErrorType } from '../../errors/utils.js'
 import type { Chain } from '../../types/chain.js'
 import { type ObserveErrorType, observe } from '../../utils/observe.js'
 import { type PollErrorType, poll } from '../../utils/poll.js'
 import { withResolvers } from '../../utils/promise/withResolvers.js'
+import {
+  type WithRetryParameters,
+  withRetry,
+} from '../../utils/promise/withRetry.js'
 import { stringify } from '../../utils/stringify.js'
 import {
   type GetCallsStatusErrorType,
@@ -24,12 +29,28 @@ export type WaitForCallsStatusParameters = {
    * @default client.pollingInterval
    */
   pollingInterval?: number | undefined
+  /**
+   * Number of times to retry if the call bundle failed.
+   * @default 4 (exponential backoff)
+   */
+  retryCount?: WithRetryParameters['retryCount'] | undefined
+  /**
+   * Time to wait (in ms) between retries.
+   * @default `({ count }) => ~~(1 << count) * 200` (exponential backoff)
+   */
+  retryDelay?: WithRetryParameters['delay'] | undefined
   /**
    * The status range to wait for.
    *
    * @default (status) => status >= 200
    */
   status?: ((parameters: GetCallsStatusReturnType) => boolean) | undefined
+  /**
+   * Whether to throw an error if the call bundle fails.
+   *
+   * @default false
+   */
+  throwOnFailure?: boolean | undefined
   /**
    * Optional timeout (in milliseconds) to wait before stopping polling.
    *
@@ -76,8 +97,11 @@ export async function waitForCallsStatus<chain extends Chain | undefined>(
   const {
     id,
     pollingInterval = client.pollingInterval,
-    status = ({ statusCode }) => statusCode >= 200,
+    status = ({ statusCode }) => statusCode === 200 || statusCode >= 300,
+    retryCount = 4,
+    retryDelay = ({ count }) => ~~(1 << count) * 200, // exponential backoff
     timeout = 60_000,
+    throwOnFailure = false,
   } = parameters
   const observerId = stringify(['waitForCallsStatus', client.uid, id])
 
@@ -97,7 +121,18 @@ export async function waitForCallsStatus<chain extends Chain | undefined>(
         }
 
         try {
-          const result = await getCallsStatus(client, { id })
+          const result = await withRetry(
+            async () => {
+              const result = await getCallsStatus(client, { id })
+              if (throwOnFailure && result.status === 'failure')
+                throw new BundleFailedError(result)
+              return result
+            },
+            {
+              retryCount,
+              delay: retryDelay,
+            },
+          )
           if (!status(result)) return
           done(() => emit.resolve(result))
         } catch (error) {

package/chains/definitions/autheoTestnet.ts

@@ -0,0 +1,25 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const autheoTestnet = /*#__PURE__*/ defineChain({
+  id: 785,
+  name: 'Autheo Testnet',
+  nativeCurrency: {
+    decimals: 18,
+    name: 'Autheo',
+    symbol: 'THEO',
+  },
+  rpcUrls: {
+    default: {
+      http: [
+        'https://testnet-rpc1.autheo.com',
+        'https://testnet-rpc2.autheo.com',
+      ],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Autheo Testnet Block Explorer',
+      url: 'https://testnet-explorer.autheo.com/',
+    },
+  },
+})

package/chains/definitions/celoSepolia.ts

@@ -0,0 +1,53 @@
+import { chainConfig } from '../../celo/chainConfig.js'
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+const sourceId = 11_155_111 // sepolia
+// source https://storage.googleapis.com/cel2-rollup-files/celo-sepolia/deployment-l1.json
+export const celoSepolia = /*#__PURE__*/ defineChain({
+  ...chainConfig,
+  id: 11_142_220,
+  name: 'Celo Sepolia Testnet',
+  nativeCurrency: {
+    decimals: 18,
+    name: 'CELO',
+    symbol: 'S-CELO',
+  },
+  rpcUrls: {
+    default: {
+      http: ['https://forno.celo-sepolia.celo-testnet.org'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Celo Sepolia Explorer',
+      url: 'https://celo-sepolia.blockscout.com/',
+      apiUrl: 'https://celo-sepolia.blockscout.com/api',
+    },
+  },
+  contracts: {
+    ...chainConfig.contracts,
+    multicall3: {
+      address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+      blockCreated: 1,
+    },
+    portal: {
+      [sourceId]: {
+        address: '0x44ae3d41a335a7d05eb533029917aad35662dcc2',
+        blockCreated: 8825790,
+      },
+    },
+    disputeGameFactory: {
+      [sourceId]: {
+        address: '0x57c45d82d1a995f1e135b8d7edc0a6bb5211cfaa',
+        blockCreated: 8825790,
+      },
+    },
+    l1StandardBridge: {
+      [sourceId]: {
+        address: '0xec18a3c30131a0db4246e785355fbc16e2eaf408',
+        blockCreated: 8825790,
+      },
+    },
+  },
+  testnet: true,
+})

package/chains/definitions/humanityTestnet.ts

@@ -0,0 +1,24 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const humanityTestnet = /*#__PURE__*/ defineChain({
+  id: 7_080_969,
+  name: 'Humanity Testnet',
+  nativeCurrency: {
+    name: 'tHP',
+    symbol: 'tHP',
+    decimals: 18,
+  },
+  rpcUrls: {
+    default: {
+      http: ['https://rpc.testnet.humanity.org'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Humanity Testnet Explorer',
+      url: 'https://humanity-testnet.explorer.alchemy.com',
+      apiUrl: 'https://humanity-testnet.explorer.alchemy.com/api',
+    },
+  },
+  testnet: true,
+})

package/chains/definitions/pulsechain.ts

@@ -14,7 +14,7 @@ export const pulsechain = /*#__PURE__*/ defineChain({
   blockExplorers: {
     default: {
       name: 'PulseScan',
-      url: 'https://scan.pulsechain.com',
+      url: 'https://ipfs.scan.pulsechain.com',
       apiUrl: 'https://api.scan.pulsechain.com/api',
     },
   },

package/chains/index.ts

@@ -37,6 +37,7 @@ export { atletaOlympia } from './definitions/atletaOlympia.js'
 export { aurora } from './definitions/aurora.js'
 export { auroraTestnet } from './definitions/auroraTestnet.js'
 export { auroria } from './definitions/auroria.js'
+export { autheoTestnet } from './definitions/autheoTestnet.js'
 export { avalanche } from './definitions/avalanche.js'
 export { avalancheFuji } from './definitions/avalancheFuji.js'
 export { b3 } from './definitions/b3.js'
@@ -90,6 +91,7 @@ export { cannon } from './definitions/cannon.js'
 export { canto } from './definitions/canto.js'
 export { celo } from './definitions/celo.js'
 export { celoAlfajores } from './definitions/celoAlfajores.js'
+export { celoSepolia } from './definitions/celoSepolia.js'
 export { chang } from './definitions/chang.js'
 export { chiliz } from './definitions/chiliz.js'
 export { chips } from './definitions/chips.js'
@@ -240,6 +242,7 @@ export { hoodi } from './definitions/hoodi.js'
 export { hpb } from './definitions/hpb.js'
 export { huddle01Mainnet } from './definitions/huddle01Mainnet.js'
 export { huddle01Testnet } from './definitions/huddle01Testnet.js'
+export { humanityTestnet } from './definitions/humanityTestnet.js'
 export { humanode } from './definitions/humanode.js'
 export { humanodeTestnet5 } from './definitions/humanodeTestnet5.js'
 export { hychain } from './definitions/hychain.js'

package/errors/calls.ts

@@ -0,0 +1,17 @@
+import type { GetCallsStatusReturnType } from '../actions/wallet/getCallsStatus.js'
+import { BaseError } from './base.js'
+
+export type BundleFailedErrorType = BundleFailedError & {
+  name: 'BundleFailedError'
+}
+export class BundleFailedError extends BaseError {
+  result: GetCallsStatusReturnType
+
+  constructor(result: GetCallsStatusReturnType) {
+    super(`Call bundle failed with status: ${result.statusCode}`, {
+      name: 'BundleFailedError',
+    })
+
+    this.result = result
+  }
+}

package/errors/version.ts

@@ -1 +1 @@
-export const version = '2.33.1'
+export const version = '2.33.3'

package/index.ts

@@ -779,6 +779,10 @@ export {
   type UnsupportedPackedAbiTypeErrorType,
 } from './errors/abi.js'
 export { BaseError, type BaseErrorType, setErrorConfig } from './errors/base.js'
+export {
+  BundleFailedError,
+  type BundleFailedErrorType,
+} from './errors/calls.js'
 export {
   BlockNotFoundError,
   type BlockNotFoundErrorType,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "viem",
   "description": "TypeScript Interface for Ethereum",
-  "version": "2.33.1",
+  "version": "2.33.3",
   "main": "./_cjs/index.js",
   "module": "./_esm/index.js",
   "types": "./_types/index.d.ts",
@@ -196,7 +196,7 @@
     "@scure/bip39": "1.6.0",
     "abitype": "1.0.8",
     "isows": "1.0.7",
-    "ox": "0.8.1",
+    "ox": "0.8.6",
     "ws": "8.18.2"
   },
   "license": "MIT",

package/utils/transaction/parseTransaction.ts

@@ -581,8 +581,8 @@ function parseAuthorizationList(
 
     authorizationList.push({
       address,
-      chainId: hexToNumber(chainId),
-      nonce: hexToNumber(nonce),
+      chainId: chainId === '0x' ? 0 : hexToNumber(chainId),
+      nonce: nonce === '0x' ? 0 : hexToNumber(nonce),
       ...parseEIP155Signature([yParity, r, s]),
     })
   }

package/zksync/actions/estimateFee.ts

@@ -15,7 +15,7 @@ export type EstimateFeeParameters<
 > = SendTransactionParameters<chain, account, chainOverride>
 
 export type EstimateFeeReturnType = ZksyncFee
-
+/* @deprecated Use `eth_gasPrice` for `maxFeePerGas`, `eth_estimateGas` to get the `gasLimit`, set `maxPriorityFeePerGas` to `0`, and use `zks_gasPerPubdata` for `gasPerPubdataLimit` instead. */
 export async function estimateFee<
   chain extends ChainEIP712 | undefined,
   account extends Account | undefined,

package/zksync/actions/getAllBalances.ts

@@ -13,6 +13,7 @@ export type GetAllBalancesParameters<
 
 export type GetAllBalancesReturnType = { [key: Address]: bigint }
 
+/* @deprecated This method has been removed from the node API. */
 export async function getAllBalances<
   chain extends Chain | undefined,
   account extends Account | undefined,

package/zksync/actions/getBaseTokenL1Address.ts

@@ -7,6 +7,7 @@ import type { PublicZksyncRpcSchema } from '../types/eip1193.js'
 
 export type GetBaseTokenL1AddressReturnType = Address
 
+/* @deprecated Use `getBridgeHubContractAddress` and call `baseToken(chainId)` instead. */
 export async function getBaseTokenL1Address<
   chain extends Chain | undefined,
   account extends Account | undefined,

package/zksync/actions/getGasPerPubdata.ts

@@ -0,0 +1,26 @@
+import type { Client } from '../../clients/createClient.js'
+import type { Transport } from '../../clients/transports/createTransport.js'
+import type { Account } from '../../types/account.js'
+import { hexToBigInt } from '../../utils/encoding/fromHex.js'
+import type { ChainEIP712 } from '../types/chain.js'
+import type { PublicZksyncRpcSchema } from '../types/eip1193.js'
+
+export type GetGasPerPubdataReturnType = bigint
+
+export async function getGasPerPubdata<
+  chain extends ChainEIP712 | undefined,
+  account extends Account | undefined,
+>(
+  client: Client<Transport, chain, account, PublicZksyncRpcSchema>,
+): Promise<GetGasPerPubdataReturnType> {
+  const result = await client.request(
+    {
+      method: 'zks_gasPerPubdata',
+    },
+    {
+      dedupe: true,
+    },
+  )
+
+  return hexToBigInt(result)
+}

package/zksync/actions/getL1ChainId.ts

@@ -7,6 +7,7 @@ import type { PublicZksyncRpcSchema } from '../types/eip1193.js'
 
 export type GetL1ChainIdReturnType = Hex
 
+/* @deprecated Use the `L1_CHAIN_ID()` method on the `L2AssetRouter` contract (deployed on `0x0000000000000000000000000000000000010003` address) */
 export async function getL1ChainId<
   chain extends Chain | undefined,
   account extends Account | undefined,

package/zksync/actions/getMainContractAddress.ts

@@ -7,6 +7,7 @@ import type { PublicZksyncRpcSchema } from '../types/eip1193.js'
 
 export type GetMainContractAddressReturnType = Address
 
+/* @deprecated Use `getBridgeHubContractAddress` and call `getZKChain(chainId)` instead. */
 export async function getMainContractAddress<
   chain extends Chain | undefined,
   account extends Account | undefined,

package/zksync/actions/getRawBlockTransactions.ts

@@ -11,6 +11,7 @@ export type GetRawBlockTransactionsParameters = ZksyncNumberParameter
 
 export type GetRawBlockTransactionsReturnType = ZksyncRawBlockTransactions
 
+/* @deprecated Use `debug_getRawTransaction` and `debug_getRawTransactions` instead. */
 export async function getRawBlockTransactions<
   chain extends Chain | undefined,
   account extends Account | undefined,

package/zksync/actions/getTestnetPaymasterAddress.ts

@@ -7,6 +7,7 @@ import type { PublicZksyncRpcSchema } from '../types/eip1193.js'
 
 export type GetTestnetPaymasterAddressReturnType = Address | null
 
+/* @deprecated Check the corresponding ZKsync chain technical documentation to find the testnet paymaster address */
 export async function getTestnetPaymasterAddress<
   chain extends Chain | undefined,
   account extends Account | undefined,

package/zksync/decorators/publicL2.ts

@@ -34,6 +34,10 @@ import {
   type GetDefaultBridgeAddressesReturnType,
   getDefaultBridgeAddresses,
 } from '../actions/getDefaultBridgeAddresses.js'
+import {
+  type GetGasPerPubdataReturnType,
+  getGasPerPubdata,
+} from '../actions/getGasPerPubdata.js'
 import {
   type GetL1BatchBlockRangeParameters,
   type GetL1BatchBlockRangeReturnParameters,
@@ -169,6 +173,8 @@ export type PublicActionsL2<
   getMainContractAddress: () => Promise<GetMainContractAddressReturnType>
 
   /**
+   * @deprecated This method has been removed from the node API.
+   *
    * Returns all known balances for a given account.
    *
    * @returns The balances for a given account. {@link GetAllBalancesReturnType}
@@ -471,6 +477,25 @@ export type PublicActionsL2<
   getL1TokenAddress: (
     args: GetL1TokenAddressParameters,
   ) => Promise<GetL1TokenAddressReturnType>
+
+  /**
+   * Returns the scaled gas per pubdata limit for the currently open batch. Available since node version 28.7.0.
+   *
+   * @returns the scaled gas per pubdata limit for the currently open batch
+   *
+   * @example
+   * import { createPublicClient, http } from 'viem'
+   * import { zksyncLocalNode } from 'viem/chains'
+   * import { publicActionsL2 } from 'viem/zksync'
+   *
+   * const client = createPublicClient({
+   *   chain: zksyncLocalNode,
+   *   transport: http(),
+   * }).extend(publicActionsL2())
+   *
+   * const gasPerPubdata = await client.getGasPerPubdata();
+   */
+  getGasPerPubdata: () => Promise<GetGasPerPubdataReturnType>
 }
 
 export function publicActionsL2() {
@@ -500,6 +525,7 @@ export function publicActionsL2() {
       getBaseTokenL1Address: () => getBaseTokenL1Address(client),
       getL2TokenAddress: (args) => getL2TokenAddress(client, args),
       getL1TokenAddress: (args) => getL1TokenAddress(client, args),
+      getGasPerPubdata: () => getGasPerPubdata(client),
     }
   }
 }

package/zksync/index.ts

@@ -60,6 +60,10 @@ export {
   getDefaultBridgeAddresses,
 } from './actions/getDefaultBridgeAddresses.js'
 export { getBridgehubContractAddress } from './actions/getBridgehubContractAddress.js'
+export {
+  type GetGasPerPubdataReturnType,
+  getGasPerPubdata,
+} from './actions/getGasPerPubdata.js'
 export {
   type GetL1AllowanceErrorType,
   type GetL1AllowanceParameters,

package/zksync/types/eip1193.ts

@@ -160,4 +160,9 @@ export type PublicZksyncRpcSchema = [
     Parameters: undefined
     ReturnType: Address
   },
+  {
+    Method: 'zks_gasPerPubdata'
+    Parameters?: undefined
+    ReturnType: Hex
+  },
 ]