Merge branch 'main' into hardhat-edr-merge

Author: fvictorio

.changeset/friendly-moles-explode.md

@@ -20,5 +20,10 @@ jobs:
       - name: Install typescript v4 in all packages
         run: |
           sed -i 's/"typescript": "~5.0.0"/"typescript": "^4.0.0"/' package.json packages/*/package.json && yarn
+      # hardhat-viem is the only package that requires TypeScript v5
+      - name: Remove hardhat-viem directory
+        run: rm -fr packages/hardhat-viem
+      - name: Remove hardhat-viem from the build script
+        run: sed -i 's/packages\/hardhat-viem packages\/hardhat-toolbox-viem//' package.json
       - name: Build
         run: yarn build

.changeset/orange-paws-promise.md

@@ -0,0 +1,81 @@
+name: hardhat-viem CI
+
+on:
+  push:
+    branches: main
+    paths:
+      - "packages/hardhat-viem/**"
+      - "packages/hardhat-core/**"
+      - "packages/hardhat-common/**"
+      - "config/**"
+  pull_request:
+    branches:
+      - "**"
+    paths:
+      - "packages/hardhat-viem/**"
+      - "packages/hardhat-core/**"
+      - "packages/hardhat-common/**"
+      - "config/**"
+  workflow_dispatch:
+
+defaults:
+  run:
+    working-directory: packages/hardhat-viem
+
+concurrency:
+  group: ${{github.workflow}}-${{github.ref}}
+  cancel-in-progress: true
+
+jobs:
+  test_on_windows:
+    name: Test hardhat-viem on Windows with Node 16
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-node@v2
+        with:
+          node-version: 16
+          cache: yarn
+      - name: Install
+        run: yarn --frozen-lockfile
+      - name: Build
+        run: yarn build
+      - name: Run tests
+        run: yarn test
+
+  test_on_macos:
+    name: Test hardhat-viem on MacOS with Node 16
+    runs-on: macos-latest
+    # disable until actions/virtual-environments#4896 is fixed
+    if: ${{ false }}
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-node@v2
+        with:
+          node-version: 16
+          cache: yarn
+      - name: Install
+        run: yarn --frozen-lockfile
+      - name: Build
+        run: yarn build
+      - name: Run tests
+        run: yarn test
+
+  test_on_linux:
+    name: Test hardhat-viem on Ubuntu with Node ${{ matrix.node }}
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node: [16, 18, 20]
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-node@v2
+        with:
+          node-version: ${{ matrix.node }}
+          cache: yarn
+      - name: Install
+        run: yarn --frozen-lockfile
+      - name: Build
+        run: yarn build
+      - name: Run tests
+        run: yarn test

.github/workflows/compile-with-typescript-v4.yml

@@ -113,6 +113,8 @@ docs/.env.example
 # EDR remote node cache
 edr-cache/
 
-# Brew package manager. 
+# Brew package manager.
 # Lock file is not recommended to be commited: https://github.com/Homebrew/homebrew-bundle#versions-and-lockfiles
 Brewfile.lock.json
+
+*.code-workspace

.github/workflows/hardhat-viem-ci.yml

@@ -16,5 +16,7 @@ module.exports.slowImportsCommonIgnoredModules = [
   "hardhat/builtin-tasks/task-names",
   "hardhat/internal/core/errors",
   "hardhat/internal/core/providers/util",
+  "hardhat/internal/util/fs-utils",
   "hardhat/utils/contract-names",
+  "hardhat/utils/source-names",
 ];

.gitignore

@@ -51,6 +51,11 @@ const customRedirects = [
     destination: "https://discord.gg/TETZs2KK4k",
     permanent: false,
   },
+  {
+    source: "/ignition-discord",
+    destination: "https://discord.gg/7jBkZQXB25",
+    permanent: false,
+  },
   {
     source: "/hre",
     destination: "/advanced/hardhat-runtime-environment",

config/eslint/constants.js

@@ -13,7 +13,7 @@ export const Pre = () => (
   <CodeBlocks.Pre className="">
     <code>
       {`
-    $ npx hardhat
+    $ npx hardhat init
     888    888                      888 888               888
     888    888                      888 888               888
     888    888                      888 888               888

docs/redirects.config.js

@@ -12,3 +12,4 @@ order:
   - href: /vscode-tests
     title: Running tests in VS Code
   - /using-esm
+  - /using-viem

docs/src/components/mdxComponents/CodeBlocks.stories.tsx

@@ -325,3 +325,28 @@ subtask("print", "Prints a message")
     console.log(taskArgs.message);
   });
 ```
+
+### Scoped tasks
+
+You can group tasks under a _scope_. This is useful when you have several tasks that are related to each other in some way.
+
+```js
+const myScope = scope("my-scope", "Scope description");
+
+myScope.task("my-task", "Do something")
+  .setAction(async () => { ... });
+
+myScope.task("my-other-task", "Do something else")
+  .setAction(async () => { ... });
+```
+
+In this case, you can run these tasks with `npx hardhat my-scope my-task` and `npx hardhat my-scope my-other-task`.
+
+Scoped tasks can also be run programmatically:
+
+```js
+await hre.run({
+  scope: "my-scope",
+  task: "my-task",
+});
+```

docs/src/content/hardhat-runner/docs/advanced/_dirinfo.yaml

@@ -108,7 +108,7 @@ yarn add --dev hardhat @nomicfoundation/hardhat-foundry
 
 ::::
 
-After that, initialize a Hardhat project with `npx hardhat`. Choose the "Create an empty hardhat.config.js" option, and then import the plugin in `hardhat.config.js`:
+After that, initialize a Hardhat project with `npx hardhat init`. Choose the "Create an empty hardhat.config.js" option, and then import the plugin in `hardhat.config.js`:
 
 ```javascript
 require("@nomicfoundation/hardhat-foundry");

docs/src/content/hardhat-runner/docs/advanced/create-task.md

@@ -24,7 +24,7 @@ const hre = require("hardhat");
 
 You can get access to all your tasks and plugins. To run these scripts you simply go through node: `node script.js`.
 
-To try this out, let's look at [a fresh Hardhat project](../guides/project-setup.md). Run `npx hardhat` and go through the steps to create a JavaScript project. When you're done, your project directory should look like this:
+To try this out, let's look at [a fresh Hardhat project](../guides/project-setup.md). Run `npx hardhat init` and go through the steps to create a JavaScript project. When you're done, your project directory should look like this:
 
 ```
 $ ls -l

docs/src/content/hardhat-runner/docs/advanced/hardhat-and-foundry.md

@@ -80,7 +80,7 @@ yarn add --dev hardhat
 
 ::::
 
-and run `npx hardhat` to create a Hardhat project:
+and run `npx hardhat init` to create a Hardhat project:
 
 ```
 888    888                      888 888               888