viem 2.7.22 → 2.8.1

package/chains/definitions/plumeTestnet.ts

@@ -0,0 +1,28 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+const sourceId = 11_155_111 // sepolia
+
+export const plumeTestnet = /*#__PURE__*/ defineChain({
+  id: 161_221_135,
+  name: 'Plume Testnet',
+  nativeCurrency: {
+    name: 'Plume Sepolia Ether',
+    symbol: 'ETH',
+    decimals: 18,
+  },
+  rpcUrls: {
+    default: {
+      http: ['https://plume-testnet.rpc.caldera.xyz/http'],
+      webSocket: ['wss://plume-testnet.rpc.caldera.xyz/ws'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Blockscout',
+      url: 'https://plume-testnet.explorer.caldera.xyz',
+      apiUrl: 'https://plume-testnet.explorer.caldera.xyz/api',
+    },
+  },
+  testnet: true,
+  sourceId,
+})

package/chains/definitions/rss3.ts

@@ -0,0 +1,47 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+import { chainConfig } from '../opStack/chainConfig.js'
+
+const sourceId = 1 // mainnet
+
+export const rss3 = /*#__PURE__*/ defineChain({
+  ...chainConfig,
+  id: 12_553,
+  name: 'RSS3 VSL Mainnet',
+  nativeCurrency: { name: 'RSS3', symbol: 'RSS3', decimals: 18 },
+  rpcUrls: {
+    default: {
+      http: ['https://rpc.rss3.io'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'RSS3 VSL Mainnet Scan',
+      url: 'https://scan.rss3.io',
+      apiUrl: 'https://scan.rss3.io/api',
+    },
+  },
+  contracts: {
+    ...chainConfig.contracts,
+    l2OutputOracle: {
+      [sourceId]: {
+        address: '0xE6f24d2C32B3109B18ed33cF08eFb490b1e09C10',
+      },
+    },
+    multicall3: {
+      address: '0xca11bde05977b3631167028862be2a173976ca11',
+      blockCreated: 14193,
+    },
+    portal: {
+      [sourceId]: {
+        address: '0x6A12432491bbbE8d3babf75F759766774C778Db4',
+        blockCreated: 19387057,
+      },
+    },
+    l1StandardBridge: {
+      [sourceId]: {
+        address: '0x4cbab69108Aa72151EDa5A3c164eA86845f18438',
+      },
+    },
+  },
+  sourceId,
+})

package/chains/definitions/rss3Sepolia.ts

@@ -0,0 +1,48 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+import { chainConfig } from '../opStack/chainConfig.js'
+
+const sourceId = 11_155_111 // sepolia
+
+export const rss3Sepolia = /*#__PURE__*/ defineChain({
+  ...chainConfig,
+  id: 2_331,
+  name: 'RSS3 VSL Sepolia Testnet',
+  nativeCurrency: { name: 'RSS3', symbol: 'RSS3', decimals: 18 },
+  rpcUrls: {
+    default: {
+      http: ['https://rpc.testnet.rss3.io'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'RSS3 VSL Sepolia Testnet Scan',
+      url: 'https://scan.testnet.rss3.io',
+      apiUrl: 'https://scan.testnet.rss3.io/api',
+    },
+  },
+  contracts: {
+    ...chainConfig.contracts,
+    l2OutputOracle: {
+      [sourceId]: {
+        address: '0xDb5c46C3Eaa6Ed6aE8b2379785DF7dd029C0dC81',
+      },
+    },
+    multicall3: {
+      address: '0xca11bde05977b3631167028862be2a173976ca11',
+      blockCreated: 55697,
+    },
+    portal: {
+      [sourceId]: {
+        address: '0xcBD77E8E1E7F06B25baDe67142cdE82652Da7b57',
+        blockCreated: 5345035,
+      },
+    },
+    l1StandardBridge: {
+      [sourceId]: {
+        address: '0xdDD29bb63B0839FB1cE0eE439Ff027738595D07B',
+      },
+    },
+  },
+  testnet: true,
+  sourceId,
+})

package/chains/index.ts

@@ -150,6 +150,7 @@ export { pgn } from './definitions/pgn.js'
 export { pgnTestnet } from './definitions/pgnTestnet.js'
 export { phoenix } from './definitions/phoenix.js'
 export { plinga } from './definitions/plinga.js'
+export { plumeTestnet } from './definitions/plumeTestnet.js'
 export { polygon } from './definitions/polygon.js'
 export { polygonAmoy } from './definitions/polygonAmoy.js'
 export { polygonMumbai } from './definitions/polygonMumbai.js'
@@ -163,6 +164,8 @@ export { rollux } from './definitions/rollux.js'
 export { rolluxTestnet } from './definitions/rolluxTestnet.js'
 export { ronin } from './definitions/ronin.js'
 export { rootstock } from './definitions/rootstock.js'
+export { rss3 } from './definitions/rss3.js'
+export { rss3Sepolia } from './definitions/rss3Sepolia.js'
 export { saigon } from './definitions/saigon.js'
 export { sapphire } from './definitions/sapphire.js'
 export { sapphireTestnet } from './definitions/sapphireTestnet.js'
@@ -245,7 +248,6 @@ export type {
   CeloTransactionRequest,
   CeloTransactionType,
   CeloTransactionSerializable,
-  CeloTransactionSerializableBase,
   CeloTransactionSerialized,
   RpcTransactionCIP42,
   RpcTransactionCIP64,

package/chains/opStack/actions/estimateL1Fee.ts

@@ -1,6 +1,5 @@
 import type { Address } from 'abitype'
 
-import { getChainId } from '../../../actions/public/getChainId.js'
 import {
   type ReadContractErrorType,
   readContract,
@@ -15,12 +14,16 @@ import type { Transport } from '../../../clients/transports/createTransport.js'
 import type { ErrorType } from '../../../errors/utils.js'
 import type { Account, GetAccountParameter } from '../../../types/account.js'
 import { type Chain, type GetChainParameter } from '../../../types/chain.js'
-import type { TransactionRequestEIP1559 } from '../../../types/transaction.js'
+import type {
+  TransactionRequestEIP1559,
+  TransactionSerializable,
+} from '../../../types/transaction.js'
 import type { RequestErrorType } from '../../../utils/buildRequest.js'
 import { getChainContractAddress } from '../../../utils/chain/getChainContractAddress.js'
 import { type HexToNumberErrorType } from '../../../utils/encoding/fromHex.js'
 import {
   type AssertRequestErrorType,
+  type AssertRequestParameters,
   assertRequest,
 } from '../../../utils/transaction/assertRequest.js'
 import {
@@ -98,29 +101,22 @@ export async function estimateL1Fee<
   })()
 
   // Populate transaction with required fields to accurately estimate gas.
-  const [request, chainId] = await Promise.all([
-    prepareTransactionRequest(
-      client,
-      args as PrepareTransactionRequestParameters,
-    ),
-    (async () => {
-      if (chain) return chain.id
-      return getChainId(client)
-    })(),
-  ])
+  const request = await prepareTransactionRequest(
+    client,
+    args as PrepareTransactionRequestParameters,
+  )
 
-  assertRequest(request)
+  assertRequest(request as AssertRequestParameters)
 
   const transaction = serializeTransaction({
     ...request,
-    chainId,
     type: 'eip1559',
-  })
+  } as TransactionSerializable)
 
   return readContract(client, {
     abi: gasPriceOracleAbi,
     address: gasPriceOracleAddress,
     functionName: 'getL1Fee',
-    args: [transaction],
+    args: [transaction as any],
   })
 }

package/chains/opStack/actions/estimateL1Gas.ts

@@ -1,6 +1,5 @@
 import type { Address } from 'abitype'
 
-import { getChainId } from '../../../actions/public/getChainId.js'
 import {
   type ReadContractErrorType,
   readContract,
@@ -15,12 +14,16 @@ import type { Transport } from '../../../clients/transports/createTransport.js'
 import type { ErrorType } from '../../../errors/utils.js'
 import type { Account, GetAccountParameter } from '../../../types/account.js'
 import { type Chain, type GetChainParameter } from '../../../types/chain.js'
-import type { TransactionRequestEIP1559 } from '../../../types/transaction.js'
+import type {
+  TransactionRequestEIP1559,
+  TransactionSerializable,
+} from '../../../types/transaction.js'
 import type { RequestErrorType } from '../../../utils/buildRequest.js'
 import { getChainContractAddress } from '../../../utils/chain/getChainContractAddress.js'
 import { type HexToNumberErrorType } from '../../../utils/encoding/fromHex.js'
 import {
   type AssertRequestErrorType,
+  type AssertRequestParameters,
   assertRequest,
 } from '../../../utils/transaction/assertRequest.js'
 import {
@@ -98,29 +101,22 @@ export async function estimateL1Gas<
   })()
 
   // Populate transaction with required fields to accurately estimate gas.
-  const [request, chainId] = await Promise.all([
-    prepareTransactionRequest(
-      client,
-      args as PrepareTransactionRequestParameters,
-    ),
-    (async () => {
-      if (chain) return chain.id
-      return getChainId(client)
-    })(),
-  ])
+  const request = await prepareTransactionRequest(
+    client,
+    args as PrepareTransactionRequestParameters,
+  )
 
-  assertRequest(request)
+  assertRequest(request as AssertRequestParameters)
 
   const transaction = serializeTransaction({
     ...request,
-    chainId,
     type: 'eip1559',
-  })
+  } as TransactionSerializable)
 
   return readContract(client, {
     abi: gasPriceOracleAbi,
     address: gasPriceOracleAddress,
     functionName: 'getL1GasUsed',
-    args: [transaction],
+    args: [transaction as any],
   })
 }

package/chains/opStack/actions/finalizeWithdrawal.ts

@@ -1,6 +1,7 @@
 import type { Address } from 'abitype'
 import {
   type WriteContractErrorType,
+  type WriteContractParameters,
   writeContract,
 } from '../../../actions/wallet/writeContract.js'
 import type { Client } from '../../../clients/createClient.js'
@@ -116,7 +117,7 @@ export async function finalizeWithdrawal<
       : undefined
 
   return writeContract(client, {
-    account,
+    account: account!,
     abi: portalAbi,
     address: portalAddress,
     chain,
@@ -126,5 +127,5 @@ export async function finalizeWithdrawal<
     maxFeePerGas,
     maxPriorityFeePerGas,
     nonce,
-  })
+  } satisfies WriteContractParameters as any)
 }

package/chains/opStack/actions/proveWithdrawal.ts

@@ -1,6 +1,7 @@
 import type { Address } from 'abitype'
 import {
   type WriteContractErrorType,
+  type WriteContractParameters,
   writeContract,
 } from '../../../actions/wallet/writeContract.js'
 import type { Client } from '../../../clients/createClient.js'
@@ -137,7 +138,7 @@ export async function proveWithdrawal<
       : gas ?? undefined
 
   return writeContract(client, {
-    account,
+    account: account!,
     abi: portalAbi,
     address: portalAddress,
     chain,
@@ -147,5 +148,5 @@ export async function proveWithdrawal<
     maxFeePerGas,
     maxPriorityFeePerGas,
     nonce,
-  })
+  } satisfies WriteContractParameters as any)
 }

package/chains/opStack/serializers.ts

@@ -1,7 +1,7 @@
 import { InvalidAddressError } from '../../errors/address.js'
 import type { ErrorType } from '../../errors/utils.js'
 import type { ChainSerializers } from '../../types/chain.js'
-import type { Hex } from '../../types/misc.js'
+import type { Hex, Signature } from '../../types/misc.js'
 import type { TransactionSerializable } from '../../types/transaction.js'
 import type { RequiredBy } from '../../types/utils.js'
 import { isAddress } from '../../utils/address/isAddress.js'
@@ -10,7 +10,6 @@ import { toHex } from '../../utils/encoding/toHex.js'
 import { toRlp } from '../../utils/encoding/toRlp.js'
 import {
   type SerializeTransactionErrorType as SerializeTransactionErrorType_,
-  type SerializeTransactionFn,
   serializeTransaction as serializeTransaction_,
 } from '../../utils/transaction/serializeTransaction.js'
 import type {
@@ -27,9 +26,10 @@ export type SerializeTransactionErrorType =
   | SerializeTransactionErrorType_
   | ErrorType
 
-export const serializeTransaction: SerializeTransactionFn<
-  OpStackTransactionSerializable
-> = (transaction, signature) => {
+export function serializeTransaction(
+  transaction: OpStackTransactionSerializable,
+  signature?: Signature,
+) {
   if (isDeposit(transaction)) return serializeTransactionDeposit(transaction)
   return serializeTransaction_(
     transaction as TransactionSerializable,

package/chains/opStack/types/transaction.ts

@@ -15,7 +15,7 @@ import type {
   TransactionSerialized,
   TransactionType,
 } from '../../../types/transaction.js'
-import type { RequiredBy } from '../../../types/utils.js'
+import type { OneOf } from '../../../types/utils.js'
 
 type RpcTransaction<TPending extends boolean = boolean> =
   RpcTransaction_<TPending> & {
@@ -77,17 +77,15 @@ export type OpStackTransactionReceiptOverrides = {
 export type OpStackTransactionReceipt = TransactionReceipt &
   OpStackTransactionReceiptOverrides
 
-export type OpStackTransactionSerializable =
-  | RequiredBy<TransactionSerializableDeposit, 'type'>
-  | (TransactionSerializable & {
-      isSystemTx?: undefined
-      mint?: undefined
-      sourceHash?: undefined
-    })
+export type OpStackTransactionSerializable = OneOf<
+  TransactionSerializableDeposit | TransactionSerializable
+>
 
 export type OpStackTransactionSerialized<
-  TType extends OpStackTransactionType = 'legacy',
-> = TransactionSerialized<TType> | TransactionSerializedDeposit
+  TType extends OpStackTransactionType = OpStackTransactionType,
+> = TType extends 'deposit'
+  ? TransactionSerializedDeposit
+  : TransactionSerialized<TType>
 
 export type OpStackTransactionType = TransactionType | 'deposit'
 
@@ -102,7 +100,7 @@ export type TransactionSerializableDeposit<
   isSystemTx?: boolean
   mint?: bigint
   sourceHash: Hex
-  type?: 'deposit'
+  type: 'deposit'
 }
 
 export type TransactionSerializedDeposit = `0x7e${string}`

package/chains/zksync/actions/sendTransaction.ts

@@ -73,6 +73,7 @@ export async function sendTransaction<
   client: Client<Transport, TChain, TAccount>,
   args: SendTransactionParameters<TChain, TAccount, TChainOverride>,
 ): Promise<SendTransactionReturnType> {
-  if (isEIP712Transaction(args)) return sendEip712Transaction(client, args)
+  if (isEIP712Transaction(args as any))
+    return sendEip712Transaction(client, args)
   return sendTransaction_(client, args)
 }

package/chains/zksync/actions/signEip712Transaction.ts

@@ -143,8 +143,8 @@ export async function signEip712Transaction<
       chainId,
       ...transaction,
       customSignature,
-      type: 'eip712',
+      type: 'eip712' as any,
     },
     { r: '0x0', s: '0x0', v: 0n },
-  )
+  ) as SignEip712TransactionReturnType
 }

package/chains/zksync/serializers.ts

@@ -1,12 +1,10 @@
+import type { Signature } from '../../index.js'
 import type { ChainSerializers } from '../../types/chain.js'
 import type { TransactionSerializable } from '../../types/transaction.js'
 import { concatHex } from '../../utils/data/concat.js'
 import { toHex } from '../../utils/encoding/toHex.js'
 import { toRlp } from '../../utils/encoding/toRlp.js'
-import {
-  type SerializeTransactionFn,
-  serializeTransaction as serializeTransaction_,
-} from '../../utils/transaction/serializeTransaction.js'
+import { serializeTransaction as serializeTransaction_ } from '../../utils/transaction/serializeTransaction.js'
 import type {
   ZkSyncTransactionSerializable,
   ZkSyncTransactionSerializableEIP712,
@@ -15,12 +13,18 @@ import type {
 import { assertEip712Transaction } from './utils/assertEip712Transaction.js'
 import { isEIP712Transaction } from './utils/isEip712Transaction.js'
 
-export const serializeTransaction: SerializeTransactionFn<
-  ZkSyncTransactionSerializable
-> = (tx, signature) => {
-  if (isEIP712Transaction(tx))
-    return serializeTransactionEIP712(tx as ZkSyncTransactionSerializableEIP712)
-  return serializeTransaction_(tx as TransactionSerializable, signature)
+export function serializeTransaction(
+  transaction: ZkSyncTransactionSerializable,
+  signature?: Signature,
+) {
+  if (isEIP712Transaction(transaction))
+    return serializeTransactionEIP712(
+      transaction as ZkSyncTransactionSerializableEIP712,
+    )
+  return serializeTransaction_(
+    transaction as TransactionSerializable,
+    signature,
+  )
 }
 
 export const serializers = {

package/chains/zksync/types/chain.ts

@@ -1,10 +1,7 @@
 import type { ChainFormatters } from '../../../types/chain.js'
 import type { Chain, ChainFormatter } from '../../../types/chain.js'
-import type {
-  TransactionSerializable,
-  TransactionSerializableGeneric,
-} from '../../../types/transaction.js'
 import type { EIP712DomainFn } from './eip712.js'
+import type { ZkSyncTransactionSerializable } from './transaction.js'
 
 export type ChainEIP712<
   formatters extends ChainFormatters | undefined = ChainFormatters | undefined,
@@ -17,10 +14,10 @@ export type ChainEIP712<
       | EIP712DomainFn<
           formatters extends ChainFormatters
             ? formatters['transactionRequest'] extends ChainFormatter
-              ? TransactionSerializableGeneric &
+              ? ZkSyncTransactionSerializable &
                   Parameters<formatters['transactionRequest']['format']>[0]
-              : TransactionSerializable
-            : TransactionSerializable,
+              : ZkSyncTransactionSerializable
+            : ZkSyncTransactionSerializable,
           TransactionSignable
         >
       | undefined

package/chains/zksync/types/eip712.ts

@@ -1,6 +1,6 @@
 import type { Address, TypedDataDomain } from 'abitype'
 import type { Hex } from '../../../types/misc.js'
-import type { TransactionSerializable } from '../../../types/transaction.js'
+import type { ZkSyncTransactionSerializable } from './transaction.js'
 
 type PaymasterParams = {
   paymaster: Address
@@ -26,6 +26,6 @@ export type EIP712Domain<TransactionSignable> = {
 
 export type EIP712DomainFn<
   TTransactionSerializable extends
-    TransactionSerializable = TransactionSerializable,
+    ZkSyncTransactionSerializable = ZkSyncTransactionSerializable,
   TransactionSignable = {},
 > = (transaction: TTransactionSerializable) => EIP712Domain<TransactionSignable>

package/clients/decorators/public.ts

@@ -217,8 +217,8 @@ import {
   watchPendingTransactions,
 } from '../../actions/public/watchPendingTransactions.js'
 import {
-  type PrepareTransactionRequestParameterType,
   type PrepareTransactionRequestParameters,
+  type PrepareTransactionRequestRequest,
   type PrepareTransactionRequestReturnType,
   prepareTransactionRequest,
 } from '../../actions/wallet/prepareTransactionRequest.js'
@@ -1335,7 +1335,10 @@ export type PublicActions<
    * })
    */
   prepareTransactionRequest: <
-    TParameterType extends PrepareTransactionRequestParameterType,
+    const TRequest extends PrepareTransactionRequestRequest<
+      TChain,
+      TChainOverride
+    >,
     TChainOverride extends Chain | undefined = undefined,
     TAccountOverride extends Account | Address | undefined = undefined,
   >(
@@ -1344,7 +1347,7 @@ export type PublicActions<
       TAccount,
       TChainOverride,
       TAccountOverride,
-      TParameterType
+      TRequest
     >,
   ) => Promise<
     PrepareTransactionRequestReturnType<
@@ -1352,7 +1355,8 @@ export type PublicActions<
       TAccount,
       TChainOverride,
       TAccountOverride,
-      TParameterType
+      // @ts-expect-error
+      TRequest
     >
   >
   /**

package/clients/decorators/wallet.ts

@@ -23,8 +23,8 @@ import {
   getPermissions,
 } from '../../actions/wallet/getPermissions.js'
 import {
-  type PrepareTransactionRequestParameterType,
   type PrepareTransactionRequestParameters,
+  type PrepareTransactionRequestRequest,
   type PrepareTransactionRequestReturnType,
   prepareTransactionRequest,
 } from '../../actions/wallet/prepareTransactionRequest.js'
@@ -44,6 +44,7 @@ import {
 } from '../../actions/wallet/sendRawTransaction.js'
 import {
   type SendTransactionParameters,
+  type SendTransactionRequest,
   type SendTransactionReturnType,
   sendTransaction,
 } from '../../actions/wallet/sendTransaction.js'
@@ -234,7 +235,10 @@ export type WalletActions<
    * })
    */
   prepareTransactionRequest: <
-    TParameterType extends PrepareTransactionRequestParameterType,
+    const TRequest extends PrepareTransactionRequestRequest<
+      TChain,
+      TChainOverride
+    >,
     TChainOverride extends Chain | undefined = undefined,
     TAccountOverride extends Account | Address | undefined = undefined,
   >(
@@ -243,7 +247,7 @@ export type WalletActions<
       TAccount,
       TChainOverride,
       TAccountOverride,
-      TParameterType
+      TRequest
     >,
   ) => Promise<
     PrepareTransactionRequestReturnType<
@@ -251,7 +255,8 @@ export type WalletActions<
       TAccount,
       TChainOverride,
       TAccountOverride,
-      TParameterType
+      // @ts-expect-error
+      TRequest
     >
   >
   /**
@@ -370,8 +375,11 @@ export type WalletActions<
    *   value: 1000000000000000000n,
    * })
    */
-  sendTransaction: <TChainOverride extends Chain | undefined = undefined>(
-    args: SendTransactionParameters<TChain, TAccount, TChainOverride>,
+  sendTransaction: <
+    const TRequest extends SendTransactionRequest<TChain, TChainOverride>,
+    TChainOverride extends Chain | undefined = undefined,
+  >(
+    args: SendTransactionParameters<TChain, TAccount, TChainOverride, TRequest>,
   ) => Promise<SendTransactionReturnType>
   /**
    * Calculates an Ethereum-specific signature in [EIP-191 format](https://eips.ethereum.org/EIPS/eip-191): `keccak256("\x19Ethereum Signed Message:\n" + len(message) + message))`.

package/constants/blob.ts

@@ -0,0 +1,21 @@
+// https://github.com/ethereum/EIPs/blob/master/EIPS/eip-4844.md#parameters
+
+/** Blob limit per transaction. */
+export const blobsPerTransaction = 2
+
+/** The number of bytes in a BLS scalar field element. */
+export const bytesPerFieldElement = 32
+
+/** The number of field elements in a blob. */
+export const fieldElementsPerBlob = 4096
+
+/** The number of bytes in a blob. */
+export const bytesPerBlob = bytesPerFieldElement * fieldElementsPerBlob
+
+/** Blob bytes limit per transaction. */
+export const maxBytesPerTransaction =
+  bytesPerBlob * blobsPerTransaction -
+  // terminator byte (0x80).
+  1 -
+  // zero byte (0x00) appended to each field element.
+  1 * fieldElementsPerBlob * blobsPerTransaction

package/constants/kzg.ts

@@ -0,0 +1,9 @@
+// https://github.com/ethereum/EIPs/blob/master/EIPS/eip-4844.md#parameters
+
+/** The number of bytes in a KZG commitment. */
+export const bytesPerCommitment = 48
+
+/** The number of bytes in a KZG proof. */
+export const bytesPerProof = 48
+
+export const versionedHashVersionKzg = 1