viem 2.7.2 → 2.7.3

package/package.json

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

package/types/eip1193.ts

@@ -2,6 +2,7 @@ import type { Address } from 'abitype'
 
 import type { BlockTag } from './block.js'
 import type { Hash, Hex, LogTopic } from './misc.js'
+import type { RpcStateOverride } from './rpc.js'
 import type {
   Quantity,
   RpcBlock as Block,
@@ -232,6 +233,11 @@ export type PublicRpcSchema = [
           transaction: Partial<TransactionRequest>,
           block: BlockNumber | BlockTag | BlockIdentifier,
         ]
+      | [
+          transaction: Partial<TransactionRequest>,
+          block: BlockNumber | BlockTag | BlockIdentifier,
+          stateOverrideSet: RpcStateOverride,
+        ]
     ReturnType: Hex
   },
   /**

package/types/rpc.ts

@@ -1,3 +1,4 @@
+import type { Address } from 'abitype'
 import type {
   Block,
   BlockIdentifier,
@@ -7,6 +8,7 @@ import type {
 } from './block.js'
 import type { FeeHistory, FeeValues } from './fee.js'
 import type { Log } from './log.js'
+import type { Hex } from './misc.js'
 import type { Proof } from './proof.js'
 import type {
   TransactionEIP1559,
@@ -103,3 +105,25 @@ export type RpcResponse<TResult = any, TError = any> = {
   | ErrorResult<TError>
   | Subscription<TResult, TError>
 )
+
+/** A key-value mapping of slot and storage values (supposedly 32 bytes each) */
+export type RpcStateMapping = {
+  [slots: Hex]: Hex
+}
+
+export type RpcAccountStateOverride = {
+  /** Fake balance to set for the account before executing the call. <32 bytes */
+  balance?: Hex
+  /** Fake nonce to set for the account before executing the call. <8 bytes */
+  nonce?: Hex
+  /** Fake EVM bytecode to inject into the account before executing the call. */
+  code?: Hex
+  /** Fake key-value mapping to override all slots in the account storage before executing the call. */
+  state?: RpcStateMapping
+  /** Fake key-value mapping to override individual slots in the account storage before executing the call. */
+  stateDiff?: RpcStateMapping
+}
+
+export type RpcStateOverride = {
+  [address: Address]: RpcAccountStateOverride
+}

package/types/stateOverride.ts

@@ -0,0 +1,26 @@
+import type { Address } from 'abitype'
+import type { Hex } from './misc.js'
+import type { OneOf } from './utils.js'
+
+export type StateMapping = Array<{
+  slot: Hex
+  value: Hex
+}>
+
+export type StateOverride = Array<
+  {
+    address: Address
+    balance?: bigint
+    nonce?: number
+    code?: Hex
+  } & OneOf<
+    | {
+        /** Fake key-value mapping to override all slots in the account storage before executing the call. */
+        state?: StateMapping
+      }
+    | {
+        /** Fake key-value mapping to override individual slots in the account storage before executing the call. */
+        stateDiff?: StateMapping
+      }
+  >
+>