Tevm Architecture Overview

import { createMemoryClient, http } from 'tevm'
 
// Create a client with all actions pre-attached
const client = createMemoryClient({
  fork: {
    transport: http('https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY')
  }
})
 
// Use standard viem actions
const code = await client.getContractCode({ 
  address: '0x1234567890123456789012345678901234567890'
}) 
 
// Use Tevm-specific actions (prefixed with 'tevm')
const state = await client.tevmDumpState() 
const balance = await client.getBalance({  
  address: '0x1234567890123456789012345678901234567890'
}) 

import { createClient, http } from 'viem'
import { createTevmTransport } from 'tevm/transport'
import { getBlock, getBlockNumber } from 'viem/actions'
import { tevmSetAccount, tevmMine } from 'tevm/actions'
 
// Create a client with just the transport
const client = createClient({
  transport: createTevmTransport({
    fork: {
      transport: http('https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY')
    }
  })
})
 
// Import and use only the specific actions you need
const blockNumber = await getBlockNumber(client) 
const block = await getBlock(client) 
 
// Tevm-specific actions
await tevmSetAccount(client, {  
  address: '0x1234...',  
  balance: 1000000000000000000n
}) 
await tevmMine(client, { blocks: 1 }) 

import { createMemoryClient } from 'tevm'
 
const client = createMemoryClient()
 
// Standard viem actions
const balance = await client.getBalance({ address: '0x123...' }) 
const blockNumber = await client.getBlockNumber() 
 
// Tevm-specific actions
await client.tevmSetAccount({  
  address: '0x123...',  
  balance: 1000000000000000000n
})  
await client.tevmMine()

import { createTevmNode } from 'tevm'
import { requestEip1193 } from 'tevm/decorators'
 
const node = createTevmNode().extend(requestEip1193())
 
// Standard Ethereum JSON-RPC methods
const balance = await node.request({ 
  method: 'eth_getBalance', 
  params: ['0x123...', 'latest'] 
}) 
 
// Anvil-compatible methods
await node.request({ 
  method: 'anvil_setBalance', 
  params: ['0x123...', '0x10000000000000000'] 
}) 
 
// Tevm-specific methods
const state = await node.request({ 
  method: 'tevm_dumpState', 
  params: [] 
}) 

import { createTevmNode } from 'tevm'
import { createAddress } from 'tevm/address'
 
const node = createTevmNode()
const vm = await node.getVm()
 
// Direct EVM access
vm.evm.events.on('step', (data, next) => { 
  // Inspect execution at each EVM step 
  console.log(data.opcode.name, data.stack) 
  next?.() 
}) 
 
// Direct state management
await vm.stateManager.putAccount( 
  createAddress('0x123...'), 
  { 
    nonce: 0n, 
    balance: 10000000000000000000n, 
    storageRoot: '0x...', 
    codeHash: '0x...'
  } 
) 
 
// Direct blockchain control
const block = await vm.blockchain.getBlockByNumber(1n)