viem 2.26.3 → 2.26.5

package/chains/definitions/lens.ts

@@ -0,0 +1,19 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const lens = /*#__PURE__*/ defineChain({
+  id: 232,
+  name: 'Lens',
+  nativeCurrency: { name: 'GHO', symbol: 'GHO', decimals: 18 },
+  rpcUrls: {
+    default: {
+      http: ['https://rpc.lens.xyz'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Lens Block Explorer',
+      url: 'https://explorer.lens.xyz',
+      apiUrl: 'https://explorer.lens.xyz/api',
+    },
+  },
+})

package/chains/index.ts

@@ -284,6 +284,7 @@ export { kromaSepolia } from './definitions/kromaSepolia.js'
 export { l3x } from './definitions/l3x.js'
 export { l3xTestnet } from './definitions/l3xTestnet.js'
 export { lavita } from './definitions/lavita.js'
+export { lens } from './definitions/lens.js'
 export { lensTestnet } from './definitions/lensTestnet.js'
 export { lightlinkPegasus } from './definitions/lightlinkPegasus.js'
 export { lightlinkPhoenix } from './definitions/lightlinkPhoenix.js'

package/errors/rpc.ts

@@ -68,6 +68,13 @@ export type ProviderRpcErrorCode =
   | 4900 // Disconnected
   | 4901 // Chain Disconnected
   | 4902 // Chain Not Recognized
+  | 5700 // Unsupported non-optional capability
+  | 5710 // Unsupported chain id
+  | 5720 // Duplicate ID
+  | 5730 // Unknown bundle id
+  | 5740 // Bundle too large
+  | 5750 // Atomic-ready wallet rejected upgrade
+  | 5760 // Atomicity not supported
 
 /**
  * Error subclass implementing Ethereum Provider errors per EIP-1193.
@@ -485,6 +492,158 @@ export class SwitchChainError extends ProviderRpcError {
   }
 }
 
+/**
+ * Subclass for an "Unsupported non-optional capability" EIP-5792 error.
+ *
+ * EIP https://eips.ethereum.org/EIPS/eip-5792#error-codes
+ */
+export type UnsupportedNonOptionalCapabilityErrorType =
+  UnsupportedNonOptionalCapabilityError & {
+    code: 5700
+    name: 'UnsupportedNonOptionalCapabilityError'
+  }
+export class UnsupportedNonOptionalCapabilityError extends ProviderRpcError {
+  static code = 5700 as const
+
+  constructor(cause: Error) {
+    super(cause, {
+      code: UnsupportedNonOptionalCapabilityError.code,
+      name: 'UnsupportedNonOptionalCapabilityError',
+      shortMessage:
+        'This Wallet does not support a capability that was not marked as optional.',
+    })
+  }
+}
+
+/**
+ * Subclass for an "Unsupported chain id" EIP-5792 error.
+ *
+ * EIP https://eips.ethereum.org/EIPS/eip-5792#error-codes
+ */
+export type UnsupportedChainIdErrorType = UnsupportedChainIdError & {
+  code: 5710
+  name: 'UnsupportedChainIdError'
+}
+export class UnsupportedChainIdError extends ProviderRpcError {
+  static code = 5710 as const
+
+  constructor(cause: Error) {
+    super(cause, {
+      code: UnsupportedChainIdError.code,
+      name: 'UnsupportedChainIdError',
+      shortMessage: 'This Wallet does not support the requested chain ID.',
+    })
+  }
+}
+
+/**
+ * Subclass for an "Duplicate ID" EIP-5792 error.
+ *
+ * EIP https://eips.ethereum.org/EIPS/eip-5792#error-codes
+ */
+export type DuplicateIdErrorType = DuplicateIdError & {
+  code: 5720
+  name: 'DuplicateIdError'
+}
+export class DuplicateIdError extends ProviderRpcError {
+  static code = 5720 as const
+
+  constructor(cause: Error) {
+    super(cause, {
+      code: DuplicateIdError.code,
+      name: 'DuplicateIdError',
+      shortMessage: 'There is already a bundle submitted with this ID.',
+    })
+  }
+}
+
+/**
+ * Subclass for an "Unknown bundle ID" EIP-5792 error.
+ *
+ * EIP https://eips.ethereum.org/EIPS/eip-5792#error-codes
+ */
+export type UnknownBundleIdErrorType = UnknownBundleIdError & {
+  code: 5730
+  name: 'UnknownBundleIdError'
+}
+export class UnknownBundleIdError extends ProviderRpcError {
+  static code = 5730 as const
+
+  constructor(cause: Error) {
+    super(cause, {
+      code: UnknownBundleIdError.code,
+      name: 'UnknownBundleIdError',
+      shortMessage: 'This bundle id is unknown / has not been submitted',
+    })
+  }
+}
+
+/**
+ * Subclass for an "Bundle too large" EIP-5792 error.
+ *
+ * EIP https://eips.ethereum.org/EIPS/eip-5792#error-codes
+ */
+export type BundleTooLargeErrorType = BundleTooLargeError & {
+  code: 5740
+  name: 'BundleTooLargeError'
+}
+export class BundleTooLargeError extends ProviderRpcError {
+  static code = 5740 as const
+
+  constructor(cause: Error) {
+    super(cause, {
+      code: BundleTooLargeError.code,
+      name: 'BundleTooLargeError',
+      shortMessage: 'The call bundle is too large for the Wallet to process.',
+    })
+  }
+}
+
+/**
+ * Subclass for an "Atomic-ready wallet rejected upgrade" EIP-5792 error.
+ *
+ * EIP https://eips.ethereum.org/EIPS/eip-5792#error-codes
+ */
+export type AtomicReadyWalletRejectedUpgradeErrorType =
+  AtomicReadyWalletRejectedUpgradeError & {
+    code: 5750
+    name: 'AtomicReadyWalletRejectedUpgradeError'
+  }
+export class AtomicReadyWalletRejectedUpgradeError extends ProviderRpcError {
+  static code = 5750 as const
+
+  constructor(cause: Error) {
+    super(cause, {
+      code: AtomicReadyWalletRejectedUpgradeError.code,
+      name: 'AtomicReadyWalletRejectedUpgradeError',
+      shortMessage:
+        'The Wallet can support atomicity after an upgrade, but the user rejected the upgrade.',
+    })
+  }
+}
+
+/**
+ * Subclass for an "Atomicity not supported" EIP-5792 error.
+ *
+ * EIP https://eips.ethereum.org/EIPS/eip-5792#error-codes
+ */
+export type AtomicityNotSupportedErrorType = AtomicityNotSupportedError & {
+  code: 5760
+  name: 'AtomicityNotSupportedError'
+}
+export class AtomicityNotSupportedError extends ProviderRpcError {
+  static code = 5760 as const
+
+  constructor(cause: Error) {
+    super(cause, {
+      code: AtomicityNotSupportedError.code,
+      name: 'AtomicityNotSupportedError',
+      shortMessage:
+        'The wallet does not support atomic execution but the request requires it.',
+    })
+  }
+}
+
 /**
  * Subclass for an unknown RPC error.
  */

package/errors/version.ts

@@ -1 +1 @@
-export const version = '2.26.3'
+export const version = '2.26.5'

package/experimental/index.ts

@@ -69,25 +69,25 @@ export {
   /** @deprecated This is no longer experimental – use `import { signAuthorization } from 'viem/actions'` instead. */
   signAuthorization,
 } from '../actions/wallet/signAuthorization.js'
-export {
+export type {
   /** @deprecated This is no longer experimental – use `import type { Authorization } from 'viem'` instead. */
-  type Authorization,
+  Authorization,
   /** @deprecated This is no longer experimental – use `import type { SignedAuthorization } from 'viem'` instead. */
-  type SignedAuthorization,
+  SignedAuthorization,
   /** @deprecated This is no longer experimental – use `import type { AuthorizationList } from 'viem'` instead. */
-  type AuthorizationList,
+  AuthorizationList,
   /** @deprecated This is no longer experimental – use `import type { SignedAuthorizationList } from 'viem'` instead. */
-  type SignedAuthorizationList,
+  SignedAuthorizationList,
   /** @deprecated This is no longer experimental – use `import type { SerializedAuthorization } from 'viem'` instead. */
-  type SerializedAuthorization,
+  SerializedAuthorization,
   /** @deprecated This is no longer experimental – use `import type { SerializedAuthorizationList } from 'viem'` instead. */
-  type SerializedAuthorizationList,
+  SerializedAuthorizationList,
 } from '../types/authorization.js'
-export {
+export type {
   /** @deprecated This is no longer experimental – use `import type { RpcAuthorizationList } from 'viem'` instead. */
-  type RpcAuthorizationList,
+  RpcAuthorizationList,
   /** @deprecated This is no longer experimental – use `import type { RpcAuthorization } from 'viem'` instead. */
-  type RpcAuthorization,
+  RpcAuthorization,
 } from '../types/rpc.js'
 export {
   /** @deprecated This is no longer experimental – use `import type { HashAuthorizationParameters } from 'viem/utils'` instead. */

package/index.ts

@@ -47,24 +47,24 @@ export {
   type GetContractParameters,
   type GetContractReturnType,
 } from './actions/getContract.js'
-export {
-  type GetContractEventsErrorType,
-  type GetContractEventsParameters,
-  type GetContractEventsReturnType,
+export type {
+  GetContractEventsErrorType,
+  GetContractEventsParameters,
+  GetContractEventsReturnType,
 } from './actions/public/getContractEvents.js'
-export {
-  type GetEip712DomainErrorType,
-  type GetEip712DomainParameters,
-  type GetEip712DomainReturnType,
+export type {
+  GetEip712DomainErrorType,
+  GetEip712DomainParameters,
+  GetEip712DomainReturnType,
 } from './actions/public/getEip712Domain.js'
-export {
-  type AddChainErrorType,
-  type AddChainParameters,
+export type {
+  AddChainErrorType,
+  AddChainParameters,
 } from './actions/wallet/addChain.js'
-export {
-  type CallErrorType,
-  type CallParameters,
-  type CallReturnType,
+export type {
+  CallErrorType,
+  CallParameters,
+  CallReturnType,
 } from './actions/public/call.js'
 export type {
   CreateAccessListParameters,
@@ -769,8 +769,16 @@ export {
   type MaxFeePerGasTooLowErrorType,
 } from './errors/fee.js'
 export {
+  AtomicReadyWalletRejectedUpgradeError,
+  type AtomicReadyWalletRejectedUpgradeErrorType,
+  AtomicityNotSupportedError,
+  type AtomicityNotSupportedErrorType,
+  BundleTooLargeError,
+  type BundleTooLargeErrorType,
   ChainDisconnectedError,
   type ChainDisconnectedErrorType,
+  DuplicateIdError,
+  type DuplicateIdErrorType,
   InternalRpcError,
   type InternalRpcErrorType,
   InvalidInputRpcError,
@@ -806,8 +814,14 @@ export {
   type TransactionRejectedRpcErrorType,
   UnauthorizedProviderError,
   type UnauthorizedProviderErrorType,
+  UnknownBundleIdError,
+  type UnknownBundleIdErrorType,
   UnknownRpcError,
   type UnknownRpcErrorType,
+  UnsupportedChainIdError,
+  type UnsupportedChainIdErrorType,
+  UnsupportedNonOptionalCapabilityError,
+  type UnsupportedNonOptionalCapabilityErrorType,
   UnsupportedProviderMethodError,
   type UnsupportedProviderMethodErrorType,
   UserRejectedRequestError,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "viem",
   "description": "TypeScript Interface for Ethereum",
-  "version": "2.26.3",
+  "version": "2.26.5",
   "main": "./_cjs/index.js",
   "module": "./_esm/index.js",
   "types": "./_types/index.d.ts",

package/types/block.ts

@@ -32,7 +32,7 @@ export type Block<
   hash: blockTag extends 'pending' ? null : Hash
   /** Logs bloom filter or `null` if pending */
   logsBloom: blockTag extends 'pending' ? null : Hex
-  /** Address that received this block’s mining rewards */
+  /** Address that received this block’s mining rewards, COINBASE address */
   miner: Address
   /** Unique identifier for the block. */
   mixHash: Hash
@@ -83,8 +83,27 @@ export type BlockIdentifier<quantity = bigint> = {
     }
 )
 
+/** Represents a block number in the blockchain. */
 export type BlockNumber<quantity = bigint> = quantity
 
+/**
+ * Specifies a particular block in the blockchain.
+ *
+ * - `"latest"`: the latest proposed block
+ * - `"earliest"`: the earliest/genesis block – lowest numbered block the client has available
+ * - `"pending"`: pending state/transactions – next block built by the client on top
+ *   of unsafe and containing the set of transactions usually taken from local mempool
+ * - `"safe"`: the latest safe head block – the most recent block that is safe from
+ *   re-orgs under honest majority and certain synchronicity assumptions
+ * - `"finalized"`: the latest finalized block – the most recent crypto-economically secure block;
+ *   cannot be re-orged outside of manual intervention driven by community coordination
+ *
+ * Using `pending`, while allowed, is not advised, as it may lead
+ * to internally inconsistent results. Use of `latest` is safe and will not
+ * lead to inconsistent results. Depending on the backing RPC networks caching system,
+ * the usage of `pending` may lead to inconsistencies as a result of an
+ * overly aggressive cache system. This may cause downstream errors/invalid states.
+ */
 export type BlockTag = 'latest' | 'earliest' | 'pending' | 'safe' | 'finalized'
 
 export type Uncle<

package/utils/buildRequest.ts

@@ -7,8 +7,16 @@ import {
   type WebSocketRequestErrorType,
 } from '../errors/request.js'
 import {
+  AtomicReadyWalletRejectedUpgradeError,
+  type AtomicReadyWalletRejectedUpgradeErrorType,
+  AtomicityNotSupportedError,
+  type AtomicityNotSupportedErrorType,
+  BundleTooLargeError,
+  type BundleTooLargeErrorType,
   ChainDisconnectedError,
   type ChainDisconnectedErrorType,
+  DuplicateIdError,
+  type DuplicateIdErrorType,
   InternalRpcError,
   type InternalRpcErrorType,
   InvalidInputRpcError,
@@ -43,8 +51,14 @@ import {
   type TransactionRejectedRpcErrorType,
   UnauthorizedProviderError,
   type UnauthorizedProviderErrorType,
+  UnknownBundleIdError,
+  type UnknownBundleIdErrorType,
   UnknownRpcError,
   type UnknownRpcErrorType,
+  UnsupportedChainIdError,
+  type UnsupportedChainIdErrorType,
+  UnsupportedNonOptionalCapabilityError,
+  type UnsupportedNonOptionalCapabilityErrorType,
   UnsupportedProviderMethodError,
   type UnsupportedProviderMethodErrorType,
   UserRejectedRequestError,
@@ -63,8 +77,12 @@ import type { GetSocketRpcClientErrorType } from './rpc/socket.js'
 import { stringify } from './stringify.js'
 
 export type RequestErrorType =
+  | AtomicityNotSupportedErrorType
+  | AtomicReadyWalletRejectedUpgradeErrorType
+  | BundleTooLargeErrorType
   | ChainDisconnectedErrorType
   | CreateBatchSchedulerErrorType
+  | DuplicateIdErrorType
   | HttpRequestErrorType
   | InternalRpcErrorType
   | InvalidInputRpcErrorType
@@ -85,7 +103,10 @@ export type RequestErrorType =
   | TimeoutErrorType
   | TransactionRejectedRpcErrorType
   | UnauthorizedProviderErrorType
+  | UnknownBundleIdErrorType
   | UnknownRpcErrorType
+  | UnsupportedChainIdErrorType
+  | UnsupportedNonOptionalCapabilityErrorType
   | UnsupportedProviderMethodErrorType
   | UserRejectedRequestErrorType
   | WebSocketRequestErrorType
@@ -170,6 +191,7 @@ export function buildRequest<request extends (args: any) => Promise<any>>(
                 // -32006
                 case JsonRpcVersionUnsupportedError.code:
                   throw new JsonRpcVersionUnsupportedError(err)
+
                 // 4001
                 case UserRejectedRequestError.code:
                   throw new UserRejectedRequestError(err)
@@ -188,10 +210,34 @@ export function buildRequest<request extends (args: any) => Promise<any>>(
                 // 4902
                 case SwitchChainError.code:
                   throw new SwitchChainError(err)
+
+                // 5700
+                case UnsupportedNonOptionalCapabilityError.code:
+                  throw new UnsupportedNonOptionalCapabilityError(err)
+                // 5710
+                case UnsupportedChainIdError.code:
+                  throw new UnsupportedChainIdError(err)
+                // 5720
+                case DuplicateIdError.code:
+                  throw new DuplicateIdError(err)
+                // 5730
+                case UnknownBundleIdError.code:
+                  throw new UnknownBundleIdError(err)
+                // 5740
+                case BundleTooLargeError.code:
+                  throw new BundleTooLargeError(err)
+                // 5750
+                case AtomicReadyWalletRejectedUpgradeError.code:
+                  throw new AtomicReadyWalletRejectedUpgradeError(err)
+                // 5760
+                case AtomicityNotSupportedError.code:
+                  throw new AtomicityNotSupportedError(err)
+
                 // CAIP-25: User Rejected Error
                 // https://docs.walletconnect.com/2.0/specs/clients/sign/error-codes#rejected-caip-25
                 case 5000:
                   throw new UserRejectedRequestError(err)
+
                 default:
                   if (err_ instanceof BaseError) throw err_
                   throw new UnknownRpcError(err as Error)