@tevm/memory-client

npm install @tevm/memory-client

interface MemoryClientOptions<TCommon, TAccountOrAddress, TRpcSchema> {
  common?: TCommon
  fork?: {
    transport: Transport
    blockTag?: string | number
  }
  name?: string
  account?: TAccountOrAddress
  pollingInterval?: number
  cacheTime?: number
}

import { createMemoryClient, http, PREFUNDED_ACCOUNTS } from 'tevm'
import { optimism } from 'tevm/common'
 
const rpcUrl = process.env.OPTIMISM_RPC_URL
if (!rpcUrl) {
  throw new Error('OPTIMISM_RPC_URL is required for fork mode')
}
 
const client = createMemoryClient({
  fork: {
    transport: http(rpcUrl)({}),
    blockTag: 'latest',
  },
  common: optimism,
})
 
const manualMining = createMemoryClient({
  miningConfig: { type: 'manual' },
  account: PREFUNDED_ACCOUNTS[0],
})
await manualMining.mine({ blocks: 1 })
 
await client.setAccount({
  address: '0x1234567890123456789012345678901234567890',
  balance: 100n,
  nonce: 1n,
  state: {
    '0x0000000000000000000000000000000000000000000000000000000000000000':
      '0x0000000000000000000000000000000000000000000000000000000000000001',
  },
})
const account = await client.getAccount({
  address: '0x1234567890123456789012345678901234567890',
  returnStorage: true,
})
 
const deployResult = await client.tevmDeploy({
  abi: contractAbi,
  bytecode: contractBytecode,
  args: ['Constructor', 'Args'],
})
 
const callResult = await client.tevmCall({
  to: contractAddress,
  data: encodeFunctionData(/* ... */),
})
 
const contractResult = await client.tevmContract({
  contract: myContract,
  method: 'myMethod',
  args: [arg1, arg2],
})
 
const hash = await client.writeContract({
  address: contractAddress,
  abi: contractAbi,
  functionName: 'myFunction',
  args: [arg1, arg2],
})
const receipt = await client.waitForTransactionReceipt({ hash })

import { createMemoryClient, createSyncPersister } from '@tevm/memory-client'
 
const client = createMemoryClient({
  persister: createSyncPersister({ storage: localStorage }),
})

import { createServer } from '@tevm/server'
import { createMemoryClient } from '@tevm/memory-client'
 
const server = createServer({ request: createMemoryClient().request })
server.listen(8545)