fix: restore testing contracts tutorial (#140)

Restores the original flow in the "how to test contracts with Hardhat"
tutorial, minor updates

Author: sarahschwartz

.github/workflows/playwright.yaml

@@ -77,8 +77,7 @@ jobs:
 
     # Setup Anvil for local testing
     - name: Run anvil-zksync
-      # temporarily running anvil-zksync node for how-to-test-contracts tutorial
-      if: matrix.tutorial.test-file-name != 'walletconnect' && matrix.tutorial.test-file-name != 'viem'
+      if: matrix.tutorial.test-file-name != 'how-to-test-contracts' && matrix.tutorial.test-file-name != 'walletconnect' && matrix.tutorial.test-file-name != 'viem'
       uses: dutterbutter/anvil-zksync-action@v1.3.0
       with:
         token: ${{ secrets.GITHUB_TOKEN }}

code/test-contracts/hardhat.config.ts

@@ -22,12 +22,6 @@ const config: HardhatUserConfig = {
     hardhat: {
       zksync: true,
     },
-    anvilZKsync: {
-      url: 'http://127.0.0.1:8011',
-      ethNetwork: 'http://localhost:8545',
-      zksync: true,
-      accounts: process.env.WALLET_PRIVATE_KEY ? [process.env.WALLET_PRIVATE_KEY] : [],
-    },
   },
   // ANCHOR_END: config
 };

content/tutorials/how-to-test-contracts/10.index.md

@@ -1,19 +1,24 @@
 ---
-title: How to test smart contracts with Hardhat
-description: Learn how to test your smart contracts locally using era-test-node and Hardhat
+title: How to test EraVM smart contracts with Hardhat
+description: Learn how to test your EraVM smart contracts locally using anvil-zksync and Hardhat
 ---
 
-
-This tutorial provides a step-by-step guide on testing smart contracts using the `hardhat-chai-matchers` plugin
+This tutorial provides a step-by-step guide on testing EraVM smart contracts using the `hardhat-chai-matchers` plugin
 in conjunction with the **Anvil ZKsync** node on your local machine.
 To facilitate this process of running tests on the **Anvil ZKsync** node, you'll also utilize the `hardhat-zksync` plugin.
 
+Note that for EVM contracts,
+the standard method of [testing with Hardhat](https://hardhat.org/hardhat-runner/docs/guides/test-contracts) works out-of-the-box.
+To learn more about how EVM is supported,
+you can read about ZKsync's
+[EVM Interpreter](https://docs.zksync.io/zksync-era/unique-features/evm-interpreter/evm-interpreter) in the docs.
+
 ## Prerequisites
 
 - Node.js installed (version 14.x or later)
-- Either yarn or npm installed
+- Either `yarn`, `npm`, `pnpm`, or `bun` installed
 
-## Era-test-node plugin
+## Anvil ZKsync plugin
 
 In this tutorial, the contract functionality is tested using [Anvil ZKsync](https://docs.zksync.io/build/test-and-debug/in-memory-node).
 To start local node we use the `hardhat-zksync` plugin to integrate this functionality within the Hardhat project.
@@ -68,14 +73,10 @@ Once installed, add the plugin at the top of your `hardhat.config.ts` file.
 
 You can now run the **Anvil ZKsync node** with the following command:
 
-```bash
-npx zksync-cli dev start
-```
+:test-action{actionId="run-hh-node"}
 
-<!-- :test-action{actionId="run-hh-node"} -->
+::code-group
 
-<!-- ::code-group -->
-<!-- 
 ```bash [npx]
 npx hardhat node-zksync
 ```
@@ -90,17 +91,17 @@ pnpm hardhat node-zksync
 
 ```bash [bun]
 bun hardhat node-zksync
-``` -->
+```
 
-<!-- :: -->
+::
 
-<!-- :test-action{actionId="wait-for-hh-node"} -->
-<!-- :test-action{actionId="test-hh-node"} -->
+:test-action{actionId="wait-for-hh-node"}
+:test-action{actionId="test-hh-node"}
 
-<!-- ::callout{icon="i-heroicons-exclamation-circle"} -->
-<!-- We'll want to verify the correctness of our installations and test if we can run a **Anvil ZKsync node**,
-without further use of this command in the tutorial. -->
-<!-- :: -->
+::callout{icon="i-heroicons-exclamation-circle"}
+We'll want to verify the correctness of our installations and test if we can run a **Anvil ZKsync node**,
+without further use of this command in the tutorial.
+::
 
 You should see the node endpoint logged in the console:
 
@@ -110,9 +111,8 @@ You should see the node endpoint logged in the console:
 ========================================
 ```
 
-<!-- 
 Since we've confirmed that the **Anvil ZKsync node** is functioning properly with the help of the `hardhat-zksync` plugin,
-we can shut it down and continue with the tutorial. -->
+we can shut it down and continue with the tutorial.
 
 ### Integration with Hardhat
 
@@ -140,19 +140,19 @@ In the root directory of your project, execute this command:
 ::code-group
 
 ```bash [npm]
-npm i -D @nomicfoundation/hardhat-chai-matchers chai@4.3.6
+npm i -D @nomicfoundation/hardhat-chai-matchers
 ```
 
 ```bash [yarn]
-yarn add -D  @nomicfoundation/hardhat-chai-matchers chai@4.3.6
+yarn add -D  @nomicfoundation/hardhat-chai-matchers
 ```
 
 ```bash [pnpm]
-pnpm add -D  @nomicfoundation/hardhat-chai-matchers chai@4.3.6
+pnpm add -D  @nomicfoundation/hardhat-chai-matchers
 ```
 
 ```bash [bun]
-bun add -D  @nomicfoundation/hardhat-chai-matchers chai@4.3.6
+bun add -D  @nomicfoundation/hardhat-chai-matchers
 ```
 
 ::
@@ -220,19 +220,19 @@ Execute the following command in your terminal to run the tests:
 ::code-group
 
 ```bash [npx]
-npx hardhat test --network anvilZKsync
+npx hardhat test
 ```
 
 ```bash [yarn]
-yarn hardhat test --network anvilZKsync
+yarn hardhat test
 ```
 
 ```bash [pnpm]
-pnpm hardhat test --network anvilZKsync
+pnpm hardhat test
 ```
 
 ```bash [bun]
-bun hardhat test --network anvilZKsync
+bun hardhat test
 ```
 
 ::

content/tutorials/how-to-test-contracts/_dir.yml

@@ -1,4 +1,4 @@
-title: How to test contracts with Hardhat
+title: How to test EraVM contracts with Hardhat
 authors:
   - name: Matter Labs
     url: https://matter-labs.io
@@ -9,14 +9,14 @@ tags:
   - how-to
   - testing
   - hardhat
-summary: Learn how to test smart contracts with Hardhat
-description: This how-to guide explains how to test smart contracts on ZKsync using Hardhat.
+summary: Learn how to test EraVM smart contracts with Hardhat
+description: This how-to guide explains how to test EraVM smart contracts on ZKsync using Hardhat.
 what_you_will_learn:
-  - How to install era-test-node.
-  - How to write local tests for smart contracts.
-updated: 2025-07-09
+  - How to write local tests for smart contracts
+  - How to test with anvil-zksync
+updated: 2025-07-14
 tools:
   - zksync-ethers
   - hardhat-zksync-deploy
   - hardhat-chai-matchers
-  - era-test-node
+  - anvil-zksync

tests/configs/how-to-test-contracts.ts

@@ -70,10 +70,10 @@ const steps: IStepConfig = {
     action: 'writeToFile',
     filepath: 'tests-output/hardhat-project/test/test.ts',
   },
-  // 'run-test': {
-  //   action: 'runCommand',
-  //   commandFolder: 'tests-output/hardhat-project',
-  // },
+  'run-test': {
+    action: 'runCommand',
+    commandFolder: 'tests-output/hardhat-project',
+  },
 };
 
 export default steps;