viem 2.16.4 → 2.17.0

package/chains/definitions/seiTestnet.ts

@@ -0,0 +1,20 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const seiTestnet = /*#__PURE__*/ defineChain({
+  id: 1328,
+  name: 'Sei Testnet',
+  nativeCurrency: { name: 'Sei', symbol: 'SEI', decimals: 18 },
+  rpcUrls: {
+    default: {
+      http: ['https://evm-rpc-testnet.sei-apis.com'],
+      webSocket: ['wss://evm-ws-testnet.sei-apis.com'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Seitrace',
+      url: 'https://seitrace.com',
+    },
+  },
+  testnet: true,
+})

package/chains/definitions/shibariumTestnet.ts

@@ -0,0 +1,28 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const shibariumTestnet = /*#__PURE__*/ defineChain({
+  id: 157,
+  name: 'Puppynet Shibarium',
+  nativeCurrency: {
+    decimals: 18,
+    name: 'Bone',
+    symbol: 'BONE',
+  },
+  rpcUrls: {
+    default: { http: ['https://puppynet.shibrpc.com'] },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Blockscout',
+      url: 'https://puppyscan.shib.io',
+      apiUrl: 'https://puppyscan.shib.io/api',
+    },
+  },
+  contracts: {
+    multicall3: {
+      address: '0xA4029b74FBA366c926eDFA7Dd10B21C621170a4c',
+      blockCreated: 3035769,
+    },
+  },
+  testnet: true,
+})

package/chains/definitions/taikoHekla.ts

@@ -15,4 +15,5 @@ export const taikoHekla = /*#__PURE__*/ defineChain({
       url: 'https://hekla.taikoscan.network',
     },
   },
+  testnet: true,
 })

package/chains/definitions/xLayerTestnet.ts

@@ -9,12 +9,12 @@ export const xLayerTestnet = /*#__PURE__*/ defineChain({
     symbol: 'OKB',
   },
   rpcUrls: {
-    default: { http: ['https://x1testrpc.okx.com'] },
+    default: { http: ['https://xlayertestrpc.okx.com'] },
   },
   blockExplorers: {
     default: {
       name: 'OKLink',
-      url: 'https://www.oklink.com/x1-test',
+      url: 'https://www.oklink.com/xlayer-test',
     },
   },
   contracts: {

package/chains/definitions/xrSepolia.ts

@@ -0,0 +1,21 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const xrSepolia = /*#__PURE__*/ defineChain({
+  id: 2730,
+  name: 'XR Sepolia',
+  nativeCurrency: {
+    decimals: 18,
+    name: 'tXR',
+    symbol: 'tXR',
+  },
+  rpcUrls: {
+    default: { http: ['https://xr-sepolia-testnet.rpc.caldera.xyz/http'] },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Blockscout',
+      url: 'https://xr-sepolia-testnet.explorer.caldera.xyz',
+    },
+  },
+  testnet: true,
+})

package/chains/index.ts

@@ -229,6 +229,7 @@ export { scroll } from './definitions/scroll.js'
 export { scrollSepolia } from './definitions/scrollSepolia.js'
 export { sei } from './definitions/sei.js'
 export { seiDevnet } from './definitions/seiDevnet.js'
+export { seiTestnet } from './definitions/seiTestnet.js'
 export { sepolia } from './definitions/sepolia.js'
 export { shimmer } from './definitions/shimmer.js'
 export { shimmerTestnet } from './definitions/shimmerTestnet.js'
@@ -251,6 +252,7 @@ export { songbirdTestnet } from './definitions/songbirdTestnet.js'
 export { spicy } from './definitions/spicy.js'
 export { shardeumSphinx } from './definitions/shardeumSphinx.js'
 export { shibarium } from './definitions/shibarium.js'
+export { shibariumTestnet } from './definitions/shibariumTestnet.js'
 export { stratis } from './definitions/stratis.js'
 export { syscoin } from './definitions/syscoin.js'
 export { syscoinTestnet } from './definitions/syscoinTestnet.js'
@@ -283,6 +285,7 @@ export { xai } from './definitions/xai.js'
 export { xaiTestnet } from './definitions/xaiTestnet.js'
 export { xdc } from './definitions/xdc.js'
 export { xdcTestnet } from './definitions/xdcTestnet.js'
+export { xrSepolia } from './definitions/xrSepolia.js'
 export { yooldoVerse } from './definitions/yooldoVerse.js'
 export { yooldoVerseTestnet } from './definitions/yooldoVerseTestnet.js'
 export { zetachain } from './definitions/zetachain.js'
@@ -314,9 +317,7 @@ export type {
 } from '../types/utils.js'
 export type {
   CeloBlock,
-  CeloBlockOverrides,
   CeloRpcBlock,
-  CeloRpcBlockOverrides,
   CeloRpcTransaction,
   CeloRpcTransactionRequest,
   CeloTransaction,
@@ -366,9 +367,7 @@ export type {
 } from '../op-stack/types/transaction.js'
 export type {
   ZkSyncBlock,
-  ZkSyncBlockOverrides,
   ZkSyncRpcBlock,
-  ZkSyncRpcBlockOverrides,
 } from '../zksync/types/block.js'
 export type { ChainEIP712 } from '../zksync/types/chain.js'
 export type { ZkSyncEip712Meta } from '../zksync/types/eip712.js'

package/errors/version.ts

@@ -1 +1 @@
-export const version = '2.16.4'
+export const version = '2.17.0'

package/index.ts

@@ -1215,7 +1215,7 @@ export {
 } from './utils/transaction/getSerializedTransactionType.js'
 export {
   type GetTransactionType,
-  type GetTransationTypeErrorType,
+  type GetTransactionTypeErrorType,
   getTransactionType,
 } from './utils/transaction/getTransactionType.js'
 export {

package/op-stack/formatters.ts

@@ -1,5 +1,4 @@
 import type { ChainFormatters } from '../types/chain.js'
-import type { Hash } from '../types/misc.js'
 import type { RpcTransaction } from '../types/rpc.js'
 import { hexToBigInt } from '../utils/encoding/fromHex.js'
 import { defineBlock } from '../utils/formatters/block.js'
@@ -8,26 +7,17 @@ import {
   formatTransaction,
 } from '../utils/formatters/transaction.js'
 import { defineTransactionReceipt } from '../utils/formatters/transactionReceipt.js'
-import type {
-  OpStackBlockOverrides,
-  OpStackRpcBlockOverrides,
-} from './types/block.js'
+import type { OpStackBlock, OpStackRpcBlock } from './types/block.js'
 import type {
   OpStackRpcTransaction,
-  OpStackRpcTransactionReceiptOverrides,
+  OpStackRpcTransactionReceipt,
   OpStackTransaction,
-  OpStackTransactionReceiptOverrides,
+  OpStackTransactionReceipt,
 } from './types/transaction.js'
 
 export const formatters = {
   block: /*#__PURE__*/ defineBlock({
-    format(
-      args: OpStackRpcBlockOverrides & {
-        transactions: Hash[] | OpStackRpcTransaction[]
-      },
-    ): OpStackBlockOverrides & {
-      transactions: Hash[] | OpStackTransaction[]
-    } {
+    format(args: OpStackRpcBlock): OpStackBlock {
       const transactions = args.transactions?.map((transaction) => {
         if (typeof transaction === 'string') return transaction
         const formatted = formatTransaction(
@@ -42,11 +32,11 @@ export const formatters = {
           formatted.type = 'deposit'
         }
         return formatted
-      }) as Hash[] | OpStackTransaction[]
+      })
       return {
         transactions,
         stateRoot: args.stateRoot,
-      }
+      } as OpStackBlock
     },
   }),
   transaction: /*#__PURE__*/ defineTransaction({
@@ -62,15 +52,13 @@ export const formatters = {
     },
   }),
   transactionReceipt: /*#__PURE__*/ defineTransactionReceipt({
-    format(
-      args: OpStackRpcTransactionReceiptOverrides,
-    ): OpStackTransactionReceiptOverrides {
+    format(args: OpStackRpcTransactionReceipt): OpStackTransactionReceipt {
       return {
         l1GasPrice: args.l1GasPrice ? hexToBigInt(args.l1GasPrice) : null,
         l1GasUsed: args.l1GasUsed ? hexToBigInt(args.l1GasUsed) : null,
         l1Fee: args.l1Fee ? hexToBigInt(args.l1Fee) : null,
         l1FeeScalar: args.l1FeeScalar ? Number(args.l1FeeScalar) : null,
-      }
+      } as OpStackTransactionReceipt
     },
   }),
 } as const satisfies ChainFormatters

package/op-stack/types/transaction.ts

@@ -32,9 +32,9 @@ export type OpStackRpcDepositTransaction<TPending extends boolean = boolean> =
       sourceHash: Hex
       type: '0x7e'
     }
-export type OpStackRpcTransaction<TPending extends boolean = boolean> =
-  | RpcTransaction<TPending>
-  | OpStackRpcDepositTransaction<TPending>
+export type OpStackRpcTransaction<TPending extends boolean = boolean> = OneOf<
+  RpcTransaction<TPending> | OpStackRpcDepositTransaction<TPending>
+>
 
 export type OpStackRpcTransactionReceiptOverrides = {
   l1GasPrice: Hex | null

package/package.json

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

package/types/utils.ts

@@ -139,17 +139,6 @@ type Assign_<T, U> = {
     : K]: K extends keyof U ? U[K] : T[K]
 }
 
-/**
- * @description Make properties K of type T never.
- *
- * @example
- * NeverBy<{ a: string, b: boolean, c: number }, 'a' | 'c'>
- * => { a: never, b: boolean, c: never }
- */
-export type NeverBy<T, K extends keyof T> = {
-  [U in keyof T]: U extends K ? never : T[U]
-}
-
 // TODO: Remove when peer dep `typescript@>=4.5` (NoInfer is native)
 export type NoInfer<type> = [type][type extends any ? 0 : never]
 

package/utils/formatters/formatter.ts

@@ -1,5 +1,5 @@
 import type { ErrorType } from '../../errors/utils.js'
-import type { Assign, Prettify } from '../../types/utils.js'
+import type { Prettify } from '../../types/utils.js'
 
 export type DefineFormatterErrorType = ErrorType
 
@@ -20,7 +20,7 @@ export function defineFormatter<TType extends string, TParameters, TReturnType>(
   }) => {
     return {
       exclude,
-      format: (args: Assign<TParameters, TOverrideParameters>) => {
+      format: (args: TOverrideParameters) => {
         const formatted = format(args as any)
         if (exclude) {
           for (const key of exclude) {
@@ -30,7 +30,7 @@ export function defineFormatter<TType extends string, TParameters, TReturnType>(
         return {
           ...formatted,
           ...overrides(args),
-        } as Prettify<Assign<TReturnType, TOverrideReturnType>> & {
+        } as Prettify<TOverrideReturnType> & {
           [_key in TExclude[number]]: never
         }
       },

package/utils/index.ts

@@ -475,7 +475,7 @@ export {
   getSerializedTransactionType,
 } from './transaction/getSerializedTransactionType.js'
 export {
-  type GetTransationTypeErrorType,
+  type GetTransactionTypeErrorType,
   type GetTransactionType,
   getTransactionType,
 } from './transaction/getTransactionType.js'

package/utils/transaction/getTransactionType.ts

@@ -109,7 +109,7 @@ export type GetTransactionType<
     | (transaction['type'] extends string ? transaction['type'] : never),
 > = IsNever<result> extends false ? result : string
 
-export type GetTransationTypeErrorType =
+export type GetTransactionTypeErrorType =
   | InvalidSerializableTransactionErrorType
   | ErrorType
 

package/utils/transaction/serializeTransaction.ts

@@ -57,7 +57,7 @@ import {
 } from './assertTransaction.js'
 import {
   type GetTransactionType,
-  type GetTransationTypeErrorType,
+  type GetTransactionTypeErrorType,
   getTransactionType,
 } from './getTransactionType.js'
 import {
@@ -81,7 +81,7 @@ export type SerializeTransactionFn<
 >
 
 export type SerializeTransactionErrorType =
-  | GetTransationTypeErrorType
+  | GetTransactionTypeErrorType
   | SerializeTransactionEIP1559ErrorType
   | SerializeTransactionEIP2930ErrorType
   | SerializeTransactionEIP4844ErrorType

package/zksync/actions/signEip712Transaction.ts

@@ -54,7 +54,7 @@ export type SignEip712TransactionErrorType = SignTransactionErrorType
  * Signs an EIP712 transaction.
  *
  * @param args - {@link SignTransactionParameters}
- * @returns The signed serialized tranasction. {@link SignTransactionReturnType}
+ * @returns The signed serialized transaction. {@link SignTransactionReturnType}
  *
  * @example
  * import { createWalletClient, custom } from 'viem'

package/zksync/actions/signTransaction.ts

@@ -48,7 +48,7 @@ export type SignTransactionErrorType = SignTransactionErrorType_
  * - Docs: https://viem.sh/docs/zksync/actions/signTransaction
  *
  * @param args - {@link SignTransactionParameters}
- * @returns The signed serialized tranasction. {@link SignTransactionReturnType}
+ * @returns The signed serialized transaction. {@link SignTransactionReturnType}
  *
  * @example
  * import { createWalletClient, custom } from 'viem'

package/zksync/decorators/eip712.ts

@@ -86,7 +86,7 @@ export type Eip712WalletActions<
    *   - Local Accounts: Signs locally. No JSON-RPC request.
    *
    * @param args - {@link SignTransactionParameters}
-   * @returns The signed serialized tranasction. {@link SignTransactionReturnType}
+   * @returns The signed serialized transaction. {@link SignTransactionReturnType}
    *
    * @example
    * import { createWalletClient, custom } from 'viem'

package/zksync/decorators/publicL1.ts

@@ -74,7 +74,7 @@ export type PublicActionsL1<
    *
    * @param client - Client to use
    * @param parameters - {@link GetL1TokenBalanceParameters}
-   * @returns The amount of the ERC20 token the client has on specific addresse. {@link GetL1TokenBalanceReturnType}
+   * @returns The amount of the ERC20 token the client has on specific address. {@link GetL1TokenBalanceReturnType}
    *
    * @example
    * import { createPublicClient, custom, parseEther } from 'viem'

package/zksync/errors/token-is-eth.ts

@@ -8,7 +8,7 @@ export class TokenIsEthError extends BaseError {
 
   constructor() {
     super(
-      ['Token is an ETH token.', '', 'ETH token cannot be retrived.'].join(
+      ['Token is an ETH token.', '', 'ETH token cannot be retrieved.'].join(
         '\n',
       ),
     )

package/zksync/formatters.ts

@@ -1,5 +1,4 @@
 import type { ChainFormatters } from '../types/chain.js'
-import type { Hash } from '../types/misc.js'
 import { hexToBigInt, hexToNumber } from '../utils/encoding/fromHex.js'
 import { hexToBytes } from '../utils/encoding/toBytes.js'
 import { toHex } from '../utils/encoding/toHex.js'
@@ -9,14 +8,11 @@ import { defineTransaction } from '../utils/formatters/transaction.js'
 import { defineTransactionReceipt } from '../utils/formatters/transactionReceipt.js'
 import { defineTransactionRequest } from '../utils/formatters/transactionRequest.js'
 import { gasPerPubdataDefault } from './constants/number.js'
-import type {
-  ZkSyncBlockOverrides,
-  ZkSyncRpcBlockOverrides,
-} from './types/block.js'
+import type { ZkSyncBlock, ZkSyncRpcBlock } from './types/block.js'
 import type { ZkSyncL2ToL1Log, ZkSyncLog } from './types/log.js'
 import type {
   ZkSyncRpcTransaction,
-  ZkSyncRpcTransactionReceiptOverrides,
+  ZkSyncRpcTransactionReceipt,
   ZkSyncRpcTransactionRequest,
   ZkSyncTransaction,
   ZkSyncTransactionReceipt,
@@ -25,13 +21,7 @@ import type {
 
 export const formatters = {
   block: /*#__PURE__*/ defineBlock({
-    format(
-      args: ZkSyncRpcBlockOverrides & {
-        transactions: Hash[] | ZkSyncRpcTransaction[]
-      },
-    ): ZkSyncBlockOverrides & {
-      transactions: Hash[] | ZkSyncTransaction[]
-    } {
+    format(args: ZkSyncRpcBlock): ZkSyncBlock {
       const transactions = args.transactions?.map((transaction) => {
         if (typeof transaction === 'string') return transaction
         const formatted = formatters.transaction?.format(
@@ -40,7 +30,7 @@ export const formatters = {
         if (formatted.typeHex === '0x71') formatted.type = 'eip712'
         else if (formatted.typeHex === '0xff') formatted.type = 'priority'
         return formatted
-      }) as Hash[] | ZkSyncTransaction[]
+      })
       return {
         l1BatchNumber: args.l1BatchNumber
           ? hexToBigInt(args.l1BatchNumber)
@@ -49,7 +39,7 @@ export const formatters = {
           ? hexToBigInt(args.l1BatchTimestamp)
           : null,
         transactions,
-      }
+      } as ZkSyncBlock
     },
   }),
   transaction: /*#__PURE__*/ defineTransaction({
@@ -69,9 +59,7 @@ export const formatters = {
     },
   }),
   transactionReceipt: /*#__PURE__*/ defineTransactionReceipt({
-    format(
-      args: ZkSyncRpcTransactionReceiptOverrides,
-    ): ZkSyncTransactionReceipt {
+    format(args: ZkSyncRpcTransactionReceipt): ZkSyncTransactionReceipt {
       return {
         l1BatchNumber: args.l1BatchNumber
           ? hexToBigInt(args.l1BatchNumber)

package/zksync/index.ts

@@ -124,9 +124,7 @@ export { serializeTransaction } from './serializers.js'
 
 export type {
   ZkSyncBlock,
-  ZkSyncBlockOverrides,
   ZkSyncRpcBlock,
-  ZkSyncRpcBlockOverrides,
 } from './types/block.js'
 export type { ChainEIP712 } from './types/chain.js'
 export type {

package/zksync/types/block.ts

@@ -2,6 +2,7 @@ import type { Address } from 'abitype'
 import type { Block, BlockTag } from '../../types/block.js'
 import type { Hash, Hex } from '../../types/misc.js'
 import type { RpcBlock } from '../../types/rpc.js'
+import type { Assign } from '../../types/utils.js'
 import type { ZkSyncRpcTransaction, ZkSyncTransaction } from './transaction.js'
 
 export type ZkSyncBatchDetails = Omit<
@@ -12,21 +13,21 @@ export type ZkSyncBatchDetails = Omit<
   l2FairGasPrice: number
 }
 
-export type ZkSyncBlockOverrides = {
-  l1BatchNumber: bigint | null
-  l1BatchTimestamp: bigint | null
-}
-
 export type ZkSyncBlock<
   TIncludeTransactions extends boolean = boolean,
   TBlockTag extends BlockTag = BlockTag,
-> = Block<
-  bigint,
-  TIncludeTransactions,
-  TBlockTag,
-  ZkSyncTransaction<TBlockTag extends 'pending' ? true : false>
-> &
-  ZkSyncBlockOverrides
+> = Assign<
+  Block<
+    bigint,
+    TIncludeTransactions,
+    TBlockTag,
+    ZkSyncTransaction<TBlockTag extends 'pending' ? true : false>
+  >,
+  {
+    l1BatchNumber: bigint | null
+    l1BatchTimestamp: bigint | null
+  }
+>
 
 export type ZkSyncBlockDetails = {
   number: number
@@ -50,20 +51,20 @@ export type ZkSyncBlockDetails = {
   protocolVersion?: string
 }
 
-export type ZkSyncRpcBlockOverrides = {
-  l1BatchNumber: Hex | null
-  l1BatchTimestamp: Hex | null
-}
-
 export type ZkSyncRpcBlock<
   TBlockTag extends BlockTag = BlockTag,
   TIncludeTransactions extends boolean = boolean,
-> = RpcBlock<
-  TBlockTag,
-  TIncludeTransactions,
-  ZkSyncRpcTransaction<TBlockTag extends 'pending' ? true : false>
-> &
-  ZkSyncRpcBlockOverrides
+> = Assign<
+  RpcBlock<
+    TBlockTag,
+    TIncludeTransactions,
+    ZkSyncRpcTransaction<TBlockTag extends 'pending' ? true : false>
+  >,
+  {
+    l1BatchNumber: Hex | null
+    l1BatchTimestamp: Hex | null
+  }
+>
 
 export type ZkSyncNumberParameter = {
   number: number

package/zksync/types/log.ts

@@ -23,7 +23,7 @@ export type ZkSyncLog<
 
 export type ZkSyncRpcLog = RpcLog_ & {
   l1BatchNumber: Hex | null
-  // These are returned but doesn't apear in Log structure neither is mentioned in https://era.zksync.io/docs/api/js/types
+  // These are returned but doesn't appear in Log structure neither is mentioned in https://era.zksync.io/docs/api/js/types
   transactionLogIndex: Hex
   logType: Hex | null
 }

package/zksync/types/transaction.ts

@@ -4,6 +4,7 @@ import type { Hash, Hex } from '../../types/misc.js'
 import type {
   Index,
   Quantity,
+  RpcTransactionReceipt,
   RpcTransactionRequest as RpcTransactionRequest_,
 } from '../../types/rpc.js'
 import type {
@@ -174,6 +175,9 @@ export type ZkSyncRpcTransactionReceiptOverrides = {
   root: Hex
 }
 
+export type ZkSyncRpcTransactionReceipt = Omit<RpcTransactionReceipt, 'logs'> &
+  ZkSyncRpcTransactionReceiptOverrides
+
 export type ZkSyncTransactionReceiptOverrides = {
   l1BatchNumber: bigint | null
   l1BatchTxIndex: bigint | null