BaseClientOptions

BaseClientOptions<TChain>: StateOptions & object

Options for creating an Tevm MemoryClient instance

Type declaration

allowUnlimitedContractSize?

optional readonly allowUnlimitedContractSize: boolean

Enable/disable unlimited contract size. Defaults to false.

chainCommon?

optional readonly chainCommon: TevmChainCommon<TChain>

The chain of the blockchain. Defaults to tevmDevnet. Required for some APIs such as getEnsAddress to work. Highly recomended you always set this in fork mode as it will speed up client creation via not having to fetch the chain info

Example

import { optimism } from 'tevm/chains'
import { createMemoryClient } from 'tevm'}

const client = createMemoryClient({ chain: optimism })

`

customCrypto?

optional readonly customCrypto: CustomCrypto

Custom crypto functionality provided to the EVM. For 4844 support, kzg must be passed.

customPrecompiles?

optional readonly customPrecompiles: CustomPrecompile[]

Custom precompiles allow you to run arbitrary JavaScript code in the EVM. See the Precompile guide documentation for a deeper dive An ever growing standard library of precompiles is provided at tevm/precompiles

Notice

Not implemented yet Implementation pr

Below example shows how to make a precompile so you can call fs.writeFile and fs.readFile in your contracts. Note: this specific precompile is also provided in the standard library

For security precompiles can only be added statically when the vm is created.

Example

import { createMemoryClient, defineCall, definePrecompile } from 'tevm'
import { createScript } from '@tevm/contract'
import fs from 'fs/promises'

const Fs = createScript({
  name: 'Fs',
  humanReadableAbi: [
    'function readFile(string path) returns (string)',
    'function writeFile(string path, string data) returns (bool)',
  ]
})

const fsPrecompile = definePrecompile({
  contract: Fs,
  address: '0xf2f2f2f2f2f2f2f2f2f2f2f2f2f2f2f2f2f2f2f2',
  call: defineCall(Fs.abi, {
    readFile: async ({ args }) => {
      return {
        returnValue: await fs.readFile(...args, 'utf8'),
        executionGasUsed: 0n,
      }
    },
    writeFile: async ({ args }) => {
      await fs.writeFile(...args)
      return { returnValue: true, executionGasUsed: 0n }
    },
  }),
})

const tevm = createMemoryClient({ customPrecompiles: [fsPrecompile] })

### customPredeploys?

> `optional` `readonly` **customPredeploys**: `ReadonlyArray`\<[`CustomPredeploy`](/reference/tevm/predeploys/type-aliases/custompredeploy/)\<`any`, `any`\>\>

Custom predeploys allow you to deploy arbitrary EVM bytecode to an address.
This is a convenience method and equivalent to calling tevm.setAccount() manually
to set the contract code.
```typescript
const tevm = createMemoryClient({
  customPredeploys: [
    // can pass a `tevm Script` here as well
    {
       address: '0x420420...',
       abi: [...],
       deployedBytecode: '0x420420...',
    }
  ],
})

eips?

optional readonly eips: ReadonlyArray<number>

Eips to enable. Defaults to [1559, 4895]

hardfork?

optional readonly hardfork: Hardfork

Hardfork to use. Defaults to shanghai

loggingLevel?

optional readonly loggingLevel: LogOptions["level"]

Configure logging options for the client

miningConfig?

optional readonly miningConfig: MiningConfig

The configuration for mining. Defaults to ‘auto'

• 'auto’ will mine a block on every transaction
• ’interval’ will mine a block every interval milliseconds
• ’manual’ will not mine a block automatically and requires a manual call to mineBlock

persister?

optional readonly persister: SyncStoragePersister

The memory client can optionally initialize and persist it’s state to an external source like local storage using createSyncPersister

Example

import { createMemoryClient, createSyncPersister } from 'tevm'

const persister = createSyncPersister({
  storage: {
    getItem: (key: string) => localStorage.getItem(key),
    setItem: (key: string, value: string) => localStorage.setItem(key, value),
  }
})

const memoryClient = createMemoryClient({ persister })

profiler?

optional readonly profiler: boolean

Enable profiler. Defaults to false.

Type parameters

• TChain extends ViemChain = ViemChain

Source

BaseClientOptions.ts:14