Complete the Anvil-to-Tevm test migration

.env.example

@@ -1,14 +1,11 @@
-VITE_ANVIL_FORK_URL=
-VITE_ANVIL_FORK_URL_SEPOLIA=
-VITE_ANVIL_FORK_URL_OPTIMISM=
-VITE_ANVIL_FORK_URL_OPTIMISM_SEPOLIA=
-VITE_ANVIL_FORK_URL_GOERLI=
-VITE_ANVIL_FORK_URL_ZKSYNC=
+VITE_TEVM_FORK_URL=
+VITE_TEVM_FORK_URL_OPTIMISM=
+VITE_TEVM_FORK_URL_SEPOLIA=
+VITE_TEVM_FORK_URL_ZKSYNC=
 VITE_BATCH_JSON_RPC=false
 VITE_BATCH_MULTICALL=true
-VITE_NETWORK_TRANSPORT_MODE=http
 
 VITE_TEMPO_ENV=localnet                     # node environment. values: localnet|devnet|testnet
 VITE_TEMPO_LOG=false                        # whether to enable logs, if VITE_TEMPO_ENV=localnet. values: true|debug|error|trace|warn|info
 VITE_TEMPO_TAG=latest                       # docker image tag, if VITE_TEMPO_ENV=localnet.
-VITE_TEMPO_HTTP_LOG=false                   # whether to enable logs on HTTP RPC requests. values: true|false
+VITE_TEMPO_HTTP_LOG=false                   # whether to enable logs on HTTP RPC requests. values: true|false

.github/CONTRIBUTING.md

@@ -19,12 +19,11 @@ This guide is intended to help you get started with contributing. By following t
 
 1. [Cloning the repository](#cloning-the-repository)
 2. [Installing Node.js and pnpm](#installing-nodejs-and-pnpm)
-3. [Installing Foundry](#installing-foundry)
-4. [Installing dependencies](#installing-dependencies)
-5. [Running the test suite](#running-the-test-suite)
-6. [Writing documentation](#writing-documentation)
-7. [Submitting a pull request](#submitting-a-pull-request)
-8. [Versioning](#versioning)
+3. [Installing dependencies](#installing-dependencies)
+4. [Running the test suite](#running-the-test-suite)
+5. [Writing documentation](#writing-documentation)
+6. [Submitting a pull request](#submitting-a-pull-request)
+7. [Versioning](#versioning)
 
 ---
 
@@ -70,22 +69,6 @@ If the versions are not correct or you don't have Node.js or pnpm installed, dow
 
 ---
 
-### Installing Foundry
-
-Viem uses [Foundry](https://book.getfoundry.sh/) for testing. We run a local [Anvil](https://github.com/foundry-rs/foundry/tree/master/anvil) instance against a forked Ethereum node, where we can also use tools like [Forge](https://book.getfoundry.sh/forge/) to deploy test contracts to it.
-
-Install Foundry using the following command:
-
-```bash
-curl -L https://foundry.paradigm.xyz | bash
-```
-
-<div align="right">
-  <a href="#basic-guide">&uarr; back to top</a></b>
-</div>
-
----
-
 ### Installing dependencies
 
 Once in the project's root directory, run the following command to install the project's dependencies:
@@ -107,23 +90,32 @@ After the install completes, pnpm links packages across the project for developm
 First, add the following to your environment (recommended to use [`direnv`](https://github.com/direnv/direnv)):
 
 ```bash
-VITE_ANVIL_FORK_URL=
-VITE_ANVIL_FORK_URL_OPTIMISM=
-VITE_ANVIL_FORK_URL_OPTIMISM_SEPOLIA=
-VITE_ANVIL_FORK_URL_SEPOLIA=
-VITE_ANVIL_FORK_URL_ZKSYNC=
+VITE_TEVM_FORK_URL=
 VITE_BATCH_MULTICALL=false
-VITE_NETWORK_TRANSPORT_MODE=http
 ```
 
-`VITE_ANVIL_FORK_URL` can be for any RPC service provider (e.g. Alchemy or Infura) for the mainnet. Now you are ready to run the tests!
+`VITE_TEVM_FORK_URL` can be any archive-capable mainnet RPC service (for
+example, Alchemy or Infura). Tevm forks the pinned test block into each Vitest
+worker and runs the EVM in-process. Tests that fork other networks use the
+optional `VITE_TEVM_FORK_URL_OPTIMISM`, `VITE_TEVM_FORK_URL_SEPOLIA`, and
+`VITE_TEVM_FORK_URL_ZKSYNC` variables. Their endpoints must also retain the
+historical state at the fixture's pinned block.
 
 - `pnpm test` — runs tests in watch mode
 
 Sometimes there may be some tests which fail unexpectedly – you can press `f` to rerun them and they should pass.
 
 When adding new features or fixing bugs, it's important to add test cases to cover the new/updated behavior.
 
+All core tests use the in-process Tevm harness. See
+[`test/README.md`](../test/README.md) for the fixture API, matcher catalog, and
+the WebSocket/IPC blocker that is intentionally excluded from CI until Tevm
+provides those servers.
+
+Foundry is not needed for the default build or test suite. Install it only to
+run the explicitly opt-in WebSocket/IPC blocker project documented in the test
+README.
+
 <div align="right">
   <a href="#basic-guide">&uarr; back to top</a></b>
 </div>

.github/actions/install-dependencies/action.yml

@@ -4,11 +4,6 @@ description: "Prepare repository and all dependencies"
 runs:
   using: "composite"
   steps:
-    - name: Set up foundry
-      uses: foundry-rs/foundry-toolchain@v1
-      with:
-        version: nightly-a3d78b09bd0b7f5170368e6c0db794f2431dadae
-
     - name: Set up pnpm
       uses: wevm/actions/.github/actions/pnpm@main
       with:

.github/workflows/verify.yml

@@ -80,18 +80,14 @@ jobs:
 
       - run: pnpm i -d -w typescript@${{ matrix.version }}
 
-      - name: Build contracts
-        shell: bash
-        run: pnpm contracts:build
-
       - name: Check types
         run: pnpm check:types
 
       - name: Bench types
         run: pnpm bench:types
 
   test:
-    name: 'Test Local (transport: ${{ matrix.transport-mode }}, multicall: ${{ matrix.multicall }}, ${{ matrix.shard }}/${{ matrix.total-shards }})'
+    name: 'Test Local (Tevm, multicall: ${{ matrix.multicall }}, ${{ matrix.shard }}/${{ matrix.total-shards }})'
     runs-on: ubuntu-latest
     timeout-minutes: 20
     permissions:
@@ -100,7 +96,6 @@ jobs:
       max-parallel: 3
       matrix:
         multicall: ['true', 'false']
-        transport-mode: ['http', 'webSocket']
         shard: [1, 2, 3]
         total-shards: [3]
     steps:
@@ -112,10 +107,6 @@ jobs:
       - name: Install dependencies
         uses: ./.github/actions/install-dependencies
 
-      - name: Build contracts
-        shell: bash
-        run: pnpm contracts:build
-
       - name: Test Local
         uses: nick-fields/retry@v3
         with:
@@ -124,13 +115,8 @@ jobs:
           command: pnpm test --bail=1 --shard=${{ matrix.shard }}/${{ matrix.total-shards }}
         env:
           CI: true
-          VITE_ANVIL_FORK_URL: ${{ secrets.VITE_ANVIL_FORK_URL }}
-          VITE_ANVIL_FORK_URL_OPTIMISM: ${{ secrets.VITE_ANVIL_FORK_URL_OPTIMISM }}
-          VITE_ANVIL_FORK_URL_OPTIMISM_SEPOLIA: ${{ secrets.VITE_ANVIL_FORK_URL_OPTIMISM_SEPOLIA }}
-          VITE_ANVIL_FORK_URL_SEPOLIA: ${{ secrets.VITE_ANVIL_FORK_URL_SEPOLIA }}
-          VITE_ANVIL_FORK_URL_ZKSYNC: ${{ secrets.VITE_ANVIL_FORK_URL_ZKSYNC }}
+          VITE_TEVM_FORK_URL: ${{ secrets.VITE_TEVM_FORK_URL }}
           VITE_BATCH_MULTICALL: ${{ matrix.multicall }}
-          VITE_NETWORK_TRANSPORT_MODE: ${{ matrix.transport-mode }}
           VITE_SHARD_ID: ${{ matrix.shard }}
           VITE_TEMPO_ENV: localnet
           VITE_TEMPO_TAG: https://rpc.testnet.tempo.xyz
@@ -200,9 +186,6 @@ jobs:
         with: 
           submodules: 'recursive'
 
-      - name: Set up foundry
-        uses: foundry-rs/foundry-toolchain@v1
-
       - name: Set up pnpm
         uses: wevm/actions/.github/actions/pnpm@main
 

.gitignore

@@ -16,6 +16,8 @@ src/node/trustedSetups_esm.ts
 **/trusted-setups/**/*.txt
 .idea
 .pnpm-store
+.smithers/
+smithers.db*
 
 # local env files
 .env
@@ -26,7 +28,6 @@ src/node/trustedSetups_esm.ts
 .envrc
 
 # tests
-generated.ts
 vectors/**/*.json
 
 # docs