viem 2.44.4 → 2.45.0

package/actions/wallet/sendCalls.ts

@@ -97,7 +97,6 @@ export async function sendCalls<
 ): Promise<SendCallsReturnType> {
   const {
     account: account_ = client.account,
-    capabilities,
     chain = client.chain,
     experimental_fallback,
     experimental_fallbackDelay = 32,
@@ -108,6 +107,24 @@ export async function sendCalls<
 
   const account = account_ ? parseAccount(account_) : null
 
+  let capabilities = parameters.capabilities
+
+  if (client.dataSuffix && !parameters.capabilities?.dataSuffix) {
+    if (typeof client.dataSuffix === 'string')
+      capabilities = {
+        ...parameters.capabilities,
+        dataSuffix: { value: client.dataSuffix, optional: true },
+      }
+    else
+      capabilities = {
+        ...parameters.capabilities,
+        dataSuffix: {
+          value: client.dataSuffix.value,
+          ...(client.dataSuffix.required ? {} : { optional: true }),
+        },
+      }
+  }
+
   const calls = parameters.calls.map((call_: unknown) => {
     const call = call_ as Call
 

package/actions/wallet/sendTransaction.ts

@@ -23,7 +23,7 @@ import type {
   GetChainParameter,
 } from '../../types/chain.js'
 import type { GetTransactionRequestKzgParameter } from '../../types/kzg.js'
-import type { Hash } from '../../types/misc.js'
+import type { Hash, Hex } from '../../types/misc.js'
 import type { TransactionRequest } from '../../types/transaction.js'
 import type { UnionOmit } from '../../types/utils.js'
 import {
@@ -35,6 +35,7 @@ import {
   type AssertCurrentChainErrorType,
   assertCurrentChain,
 } from '../../utils/chain/assertCurrentChain.js'
+import { concat } from '../../utils/data/concat.js'
 import {
   type GetTransactionErrorReturnType,
   getTransactionError,
@@ -86,6 +87,8 @@ export type SendTransactionParameters<
   GetTransactionRequestKzgParameter<request> & {
     /** Whether to assert that the client chain is on the correct chain. @default true */
     assertChainId?: boolean | undefined
+    /** Data to append to the end of the calldata. Takes precedence over `client.dataSuffix`. */
+    dataSuffix?: Hex | undefined
   }
 
 export type SendTransactionReturnType = Hash
@@ -168,6 +171,9 @@ export async function sendTransaction<
     authorizationList,
     blobs,
     data,
+    dataSuffix = typeof client.dataSuffix === 'string'
+      ? client.dataSuffix
+      : client.dataSuffix?.value,
     gas,
     gasPrice,
     maxFeePerBlobGas,
@@ -233,7 +239,7 @@ export async function sendTransaction<
           authorizationList,
           blobs,
           chainId,
-          data,
+          data: data ? concat([data, dataSuffix ?? '0x']) : data,
           gas,
           gasPrice,
           maxFeePerBlobGas,
@@ -314,7 +320,7 @@ export async function sendTransaction<
         authorizationList,
         blobs,
         chain,
-        data,
+        data: data ? concat([data, dataSuffix ?? '0x']) : data,
         gas,
         gasPrice,
         maxFeePerBlobGas,

package/actions/wallet/sendTransactionSync.ts

@@ -27,7 +27,7 @@ import type {
   GetChainParameter,
 } from '../../types/chain.js'
 import type { GetTransactionRequestKzgParameter } from '../../types/kzg.js'
-import type { Hash } from '../../types/misc.js'
+import type { Hash, Hex } from '../../types/misc.js'
 import type { TransactionRequest } from '../../types/transaction.js'
 import type { UnionOmit } from '../../types/utils.js'
 import {
@@ -39,6 +39,7 @@ import {
   type AssertCurrentChainErrorType,
   assertCurrentChain,
 } from '../../utils/chain/assertCurrentChain.js'
+import { concat } from '../../utils/data/concat.js'
 import {
   type GetTransactionErrorReturnType,
   getTransactionError,
@@ -95,6 +96,8 @@ export type SendTransactionSyncParameters<
   GetTransactionRequestKzgParameter<request> & {
     /** Whether to assert that the client chain is on the correct chain. @default true */
     assertChainId?: boolean | undefined
+    /** Data to append to the end of the calldata. Takes precedence over `client.dataSuffix`. */
+    dataSuffix?: Hex | undefined
     /** Polling interval (ms) to poll for the transaction receipt. @default client.pollingInterval */
     pollingInterval?: number | undefined
     /** Whether to throw an error if the transaction was detected as reverted. @default true */
@@ -187,6 +190,9 @@ export async function sendTransactionSync<
     authorizationList,
     blobs,
     data,
+    dataSuffix = typeof client.dataSuffix === 'string'
+      ? client.dataSuffix
+      : client.dataSuffix?.value,
     gas,
     gasPrice,
     maxFeePerBlobGas,
@@ -256,7 +262,7 @@ export async function sendTransactionSync<
           authorizationList,
           blobs,
           chainId,
-          data,
+          data: data ? concat([data, dataSuffix ?? '0x']) : data,
           gas,
           gasPrice,
           maxFeePerBlobGas,
@@ -353,7 +359,7 @@ export async function sendTransactionSync<
         authorizationList,
         blobs,
         chain,
-        data,
+        data: data ? concat([data, dataSuffix ?? '0x']) : data,
         gas,
         gasPrice,
         maxFeePerBlobGas,

package/actions/wallet/writeContract.ts

@@ -210,7 +210,6 @@ export namespace writeContract {
       account: account_ = client.account,
       address,
       args,
-      dataSuffix,
       functionName,
       ...request
     } = parameters as WriteContractParameters
@@ -233,7 +232,7 @@ export namespace writeContract {
         actionFn as never,
         name,
       )({
-        data: `${data}${dataSuffix ? dataSuffix.replace('0x', '') : ''}`,
+        data,
         to: address,
         account,
         ...request,

package/chains/definitions/megaeth.ts

@@ -0,0 +1,30 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const megaeth = /*#__PURE__*/ defineChain({
+  id: 4326,
+  blockTime: 1_000,
+  name: 'MegaETH',
+  nativeCurrency: {
+    name: 'Ether',
+    symbol: 'ETH',
+    decimals: 18,
+  },
+  rpcUrls: {
+    default: {
+      http: ['https://mainnet.megaeth.com/rpc'],
+      webSocket: ['wss://mainnet.megaeth.com/ws'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Blockscout',
+      url: 'https://megaeth.blockscout.com',
+      apiUrl: 'https://megaeth.blockscout.com/api',
+    },
+  },
+  contracts: {
+    multicall3: {
+      address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+    },
+  },
+})

package/chains/definitions/megaethTestnet.ts

@@ -1,7 +1,7 @@
 import { defineChain } from '../../utils/chain/defineChain.js'
 
 export const megaethTestnet = /*#__PURE__*/ defineChain({
-  id: 6342,
+  id: 6343,
   blockTime: 1_000,
   name: 'MegaETH Testnet',
   nativeCurrency: {
@@ -20,6 +20,11 @@ export const megaethTestnet = /*#__PURE__*/ defineChain({
       name: 'MegaETH Testnet Explorer',
       url: 'https://www.megaexplorer.xyz/',
     },
+    blockscout: {
+      name: 'Blockscout',
+      url: 'https://megaeth-testnet-v2.blockscout.com',
+      apiUrl: 'https://megaeth-testnet-v2.blockscout.com/api',
+    },
   },
   contracts: {
     multicall3: {

package/chains/definitions/rise.ts

@@ -0,0 +1,25 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const rise = /*#__PURE__*/ defineChain({
+  id: 4153,
+  name: 'RISE',
+  nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
+  rpcUrls: {
+    default: {
+      http: ['https://rpc.risechain.com'],
+      webSocket: ['wss://rpc.risechain.com/ws'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Blockscout',
+      url: 'https://explorer.risechain.com',
+      apiUrl: 'https://explorer.risechain.com/api',
+    },
+  },
+  contracts: {
+    multicall3: {
+      address: '0xca11bde05977b3631167028862be2a173976ca11',
+    },
+  },
+})

package/chains/definitions/stable.ts

@@ -0,0 +1,32 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const stable = /*#__PURE__*/ defineChain({
+  id: 988,
+  name: 'Stable Mainnet',
+  blockTime: 700,
+  nativeCurrency: {
+    name: 'gUSDT',
+    symbol: 'gUSDT',
+    decimals: 18,
+  },
+  rpcUrls: {
+    default: {
+      http: ['https://rpc.stable.xyz'],
+      webSocket: ['wss://rpc.stable.xyz'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Stablescan',
+      url: 'https://stablescan.xyz',
+      apiUrl: 'https://api.etherscan.io/v2/api?chainid=988',
+    },
+  },
+  contracts: {
+    multicall3: {
+      address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+      blockCreated: 2423647,
+    },
+  },
+  testnet: false,
+})

package/chains/definitions/stableTestnet.ts

@@ -3,10 +3,11 @@ import { defineChain } from '../../utils/chain/defineChain.js'
 export const stableTestnet = /*#__PURE__*/ defineChain({
   id: 2201,
   name: 'Stable Testnet',
+  blockTime: 700,
   nativeCurrency: {
+    name: 'USDT0',
+    symbol: 'USDT0',
     decimals: 18,
-    name: 'gUSDT',
-    symbol: 'gUSDT',
   },
   rpcUrls: {
     default: {
@@ -18,7 +19,13 @@ export const stableTestnet = /*#__PURE__*/ defineChain({
     default: {
       name: 'Stablescan',
       url: 'https://testnet.stablescan.xyz',
-      apiUrl: 'https://testnet.stablescan.xyz/api',
+      apiUrl: 'https://api.etherscan.io/v2/api?chainid=2201',
+    },
+  },
+  contracts: {
+    multicall3: {
+      address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+      blockCreated: 22364430,
     },
   },
   testnet: true,

package/chains/index.ts

@@ -379,6 +379,7 @@ export { mapProtocol } from './definitions/mapProtocol.js'
 export { matchain } from './definitions/matchain.js'
 export { matchainTestnet } from './definitions/matchainTestnet.js'
 export { mchVerse } from './definitions/mchVerse.js'
+export { megaeth } from './definitions/megaeth.js'
 export { megaethTestnet } from './definitions/megaethTestnet.js'
 export { mekong } from './definitions/mekong.js'
 export { meld } from './definitions/meld.js'
@@ -498,6 +499,7 @@ export { reddioSepolia } from './definitions/reddioSepolia.js'
 export { redstone } from './definitions/redstone.js'
 export { rei } from './definitions/rei.js'
 export { reyaNetwork } from './definitions/reyaNetwork.js'
+export { rise } from './definitions/rise.js'
 export { riseTestnet } from './definitions/riseTestnet.js'
 export { rivalz } from './definitions/rivalz.js'
 export { rollux } from './definitions/rollux.js'
@@ -575,6 +577,7 @@ export { sophonTestnet } from './definitions/sophonTestnet.js'
 export { sova } from './definitions/sova.js'
 export { sovaSepolia } from './definitions/sovaSepolia.js'
 export { spicy } from './definitions/spicy.js'
+export { stable } from './definitions/stable.js'
 export { stableTestnet } from './definitions/stableTestnet.js'
 export {
   statusSepolia,

package/clients/createClient.ts

@@ -9,6 +9,7 @@ import type { ErrorType } from '../errors/utils.js'
 import type { Account } from '../types/account.js'
 import type { BlockTag } from '../types/block.js'
 import type { Chain } from '../types/chain.js'
+import type { DataSuffix } from '../types/dataSuffix.js'
 import type {
   EIP1193RequestFn,
   EIP1474Methods,
@@ -74,6 +75,8 @@ export type ClientConfig<
     | undefined
   /** Chain for the client. */
   chain?: Chain | undefined | chain
+  /** Data suffix to append to transaction data. */
+  dataSuffix?: DataSuffix | undefined
   /** A key for the client. */
   key?: string | undefined
   /** A name for the client. */
@@ -171,6 +174,8 @@ type Client_Base<
   ccipRead?: ClientConfig['ccipRead'] | undefined
   /** Chain for the client. */
   chain: chain
+  /** Data suffix to append to transaction data. */
+  dataSuffix?: DataSuffix | undefined
   /** Default block tag to use for RPC requests. */
   experimental_blockTag?: BlockTag | undefined
   /** A key for the client. */
@@ -232,6 +237,7 @@ export function createClient(parameters: ClientConfig): Client {
     batch,
     chain,
     ccipRead,
+    dataSuffix,
     key = 'base',
     name = 'Base Client',
     type = 'base',
@@ -267,6 +273,7 @@ export function createClient(parameters: ClientConfig): Client {
     cacheTime,
     ccipRead,
     chain,
+    dataSuffix,
     key,
     name,
     pollingInterval,

package/clients/createWalletClient.ts

@@ -30,6 +30,7 @@ export type WalletClientConfig<
     | 'cacheTime'
     | 'ccipRead'
     | 'chain'
+    | 'dataSuffix'
     | 'key'
     | 'name'
     | 'pollingInterval'

package/errors/version.ts

@@ -1 +1 @@
-export const version = '2.44.4'
+export const version = '2.45.0'

package/index.ts

@@ -539,6 +539,7 @@ export type {
 export type {
   SignTransactionErrorType,
   SignTransactionParameters,
+  SignTransactionRequest,
   SignTransactionReturnType,
 } from './actions/wallet/signTransaction.js'
 export type {
@@ -1119,6 +1120,7 @@ export type {
   UnionWiden,
   Widen,
 } from './types/contract.js'
+export type { DataSuffix } from './types/dataSuffix.js'
 export type {
   AddEthereumChainParameter,
   BundlerRpcSchema,

package/op-stack/index.ts

@@ -47,6 +47,24 @@ export {
   type EstimateContractTotalGasReturnType,
   estimateContractTotalGas,
 } from './actions/estimateContractTotalGas.js'
+export {
+  type EstimateDepositTransactionGasErrorType,
+  type EstimateDepositTransactionGasParameters,
+  type EstimateDepositTransactionGasReturnType,
+  estimateDepositTransactionGas,
+} from './actions/estimateDepositTransactionGas.js'
+export {
+  type EstimateFinalizeWithdrawalGasErrorType,
+  type EstimateFinalizeWithdrawalGasParameters,
+  type EstimateFinalizeWithdrawalGasReturnType,
+  estimateFinalizeWithdrawalGas,
+} from './actions/estimateFinalizeWithdrawalGas.js'
+export {
+  type EstimateInitiateWithdrawalGasErrorType,
+  type EstimateInitiateWithdrawalGasParameters,
+  type EstimateInitiateWithdrawalGasReturnType,
+  estimateInitiateWithdrawalGas,
+} from './actions/estimateInitiateWithdrawalGas.js'
 export {
   type EstimateL1FeeErrorType,
   type EstimateL1FeeParameters,
@@ -65,6 +83,12 @@ export {
   type EstimateOperatorFeeReturnType,
   estimateOperatorFee,
 } from './actions/estimateOperatorFee.js'
+export {
+  type EstimateProveWithdrawalGasErrorType,
+  type EstimateProveWithdrawalGasParameters,
+  type EstimateProveWithdrawalGasReturnType,
+  estimateProveWithdrawalGas,
+} from './actions/estimateProveWithdrawalGas.js'
 export {
   type EstimateTotalFeeErrorType,
   type EstimateTotalFeeParameters,

package/package.json

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

package/types/dataSuffix.ts

@@ -0,0 +1,18 @@
+import type { Hex } from './misc.js'
+
+/**
+ * Data suffix configuration for transaction attribution.
+ *
+ * Can be specified in two forms:
+ * - Simple hex string: `"0x1234"` - Appended to transaction data, not required
+ * - Object form: `{ value: "0x1234", required: true }` - Explicit required flag
+ *
+ * When `required` is `true`, transactions will fail if the suffix cannot be appended.
+ * When `required` is `false` (default), the suffix is best-effort.
+ */
+export type DataSuffix =
+  | Hex
+  | {
+      value: Hex
+      required?: boolean | undefined
+    }