Add testnet to example templates (#223)

* move VersionCompatibilityChecker to package

* check if hardhat-tenderly version is outdated

* encapsulate compatibility version checks into functions

* add link-local-hardhat-tenderly command

* add testnet to example templates

* changeset version

.changeset/silver-windows-punch.md

@@ -0,0 +1,6 @@
+---
+"@tenderly/hardhat-integration": patch
+"@tenderly/hardhat-tenderly": patch
+---
+
+Added alerts if ethers and hardhat-tenderly versions are not compatible for each other (ethersv5 and [email protected], or ethersv6 and [email protected]. Also added alerts if there's a new hardhat-tenderly version available.

examples/contract-verification/ethers-v5/hardhat.config.ts

@@ -20,8 +20,9 @@ console.log("Using automatic verification?", automaticVerifications);
 const config: HardhatUserConfig = {
   solidity: "0.8.23",
   networks: {
-    tenderly: {
-      url: `${process.env.TENDERLY_FORK_RPC_URL ?? ""}`,
+    my_tenderly_testnet: {
+      // or any other custom network name
+      url: `${process.env.TENDERLY_TESTNET_RPC_URL ?? ""}`,
     },
     sepolia: {
       url: `${process.env.SEPOLIA_URL ?? ""}`,

examples/contract-verification/ethers-v5/tpl.env

@@ -1,7 +1,10 @@
-SEPOLIA_URL= # Provider URL for Sepolia test network
+SEPOLIA_URL= # Provider URL for Sepolia test network -> Available through Tenderly Node RPCs
 SEPOLIA_PRIVATE_KEY= # optional
 
-# https://dashboard.tenderly.co/{USERNAME}/{PROJECT}/fork/{FORK_ID}
-TENDERLY_FORK_RPC_URL=# The RPC_URL of a Tenderly Fork; Found on the fork UI info tab
-TENDERLY_PROJECT=# Project Slug; {PROJECT} in the URL
-TENDERLY_USERNAME=# Username; {USERNAME} in the URL
+TENDERLY_USERNAME=# Username
+TENDERLY_PROJECT=# Project Slug -> Available on the dashboard project dropdown
+
+TENDERLY_TESTNET_RPC_URL=# The RPC_URL of a Tenderly VirtualTestnet; Found on the Dashboard UI for Virtual Testnets
+
+# This will automatically populate the `etherscan` field in the hardhat-verify config with the data needed to verify PROXY contracts on Tenderly.
+TENDERLY_AUTOMATIC_POPULATE_HARDHAT_VERIFY_CONFIG=true

examples/contract-verification/ethers-v6/hardhat.config.ts

@@ -25,17 +25,9 @@ console.log(
 const config: HardhatUserConfig = {
   solidity: "0.8.23",
   networks: {
-    my_tenderly_fork_1: {
+    my_tenderly_testnet: {
       // or any other custom network name
-      url: `${process.env.TENDERLY_FORK_RPC_URL ?? ""}`,
-    },
-    my_tenderly_devnet_1: {
-      // or any other custom network name
-      url: `${process.env.TENDERLY_DEVNET_RPC_URL_1 ?? ""}`,
-    },
-    my_tenderly_devnet_2: {
-      // or any other custom network name
-      url: `${process.env.TENDERLY_DEVNET_RPC_URL_2 ?? ""}`,
+      url: `${process.env.TENDERLY_TESTNET_RPC_URL ?? ""}`,
     },
     sepolia: {
       url: `${process.env.SEPOLIA_URL ?? ""}`,

examples/contract-verification/ethers-v6/tpl.env

@@ -1,12 +1,10 @@
-SEPOLIA_URL= # Provider URL for Sepolia test network
+SEPOLIA_URL= # Provider URL for Sepolia test network -> Available through Tenderly Node RPCs
 SEPOLIA_PRIVATE_KEY= # optional
 
-# https://dashboard.tenderly.co/{USERNAME}/{PROJECT}/fork/{FORK_ID}
-TENDERLY_FORK_RPC_URL=# The RPC_URL of a Tenderly Fork; Found on the fork UI info tab
-TENDERLY_DEVNET_RPC_URL_1=# The RPC_URL of a Tenderly Devnet; Found on the devnet UI info tab
-TENDERLY_DEVNET_RPC_URL_2=# The RPC_URL of a Tenderly Devnet; Found on the devnet UI info tab
-TENDERLY_PROJECT=# Project Slug; {PROJECT} in the URL
-TENDERLY_USERNAME=# Username; {USERNAME} in the URL
+TENDERLY_USERNAME=# Username
+TENDERLY_PROJECT=# Project Slug -> Available on the dashboard project dropdown
+
+TENDERLY_TESTNET_RPC_URL=# The RPC_URL of a Tenderly VirtualTestnet; Found on the Dashboard UI for Virtual Testnets
 
 # This will automatically populate the `etherscan` field in the hardhat-verify config with the data needed to verify PROXY contracts on Tenderly.
 TENDERLY_AUTOMATIC_POPULATE_HARDHAT_VERIFY_CONFIG=true

examples/contract-verification/hardhat-ignition/hardhat.config.ts

@@ -11,9 +11,14 @@ tdly.setup();
 const config: HardhatUserConfig = {
   solidity: "0.8.24",
   networks: {
-    testnet: {
-      url: `${process.env.TENDERLY_TESTNET_RPC_URL ?? ""}`
-    }
+    my_tenderly_testnet: {
+      // or any other custom network name
+      url: `${process.env.TENDERLY_TESTNET_RPC_URL ?? ""}`,
+    },
+    sepolia: {
+      url: `${process.env.SEPOLIA_URL ?? ""}`,
+      accounts: [process.env.SEPOLIA_PRIVATE_KEY ?? ""],
+    },
   },
   tenderly: {
     project: process.env.TENDERLY_PROJECT ?? "",

examples/contract-verification/hardhat-ignition/tpl.env

@@ -1,12 +1,7 @@
-SEPOLIA_URL= # Provider URL for Sepolia test network
+SEPOLIA_URL= # Provider URL for Sepolia test network -> Available through Tenderly Node RPCs
 SEPOLIA_PRIVATE_KEY= # optional
 
-# https://dashboard.tenderly.co/{USERNAME}/{PROJECT}/fork/{FORK_ID}
-TENDERLY_FORK_RPC_URL=# The RPC_URL of a Tenderly Fork; Found on the fork UI info tab
-TENDERLY_DEVNET_RPC_URL_1=# The RPC_URL of a Tenderly Devnet; Found on the devnet UI info tab
-TENDERLY_DEVNET_RPC_URL_2=# The RPC_URL of a Tenderly Devnet; Found on the devnet UI info tab
-TENDERLY_PROJECT=# Project Slug; {PROJECT} in the URL
-TENDERLY_USERNAME=# Username; {USERNAME} in the URL
+TENDERLY_USERNAME=# Username
+TENDERLY_PROJECT=# Project Slug -> Available on the dashboard project dropdown
 
-# This will automatically populate the `etherscan` field in the hardhat-verify config with the data needed to verify PROXY contracts on Tenderly.
-TENDERLY_AUTOMATIC_POPULATE_HARDHAT_VERIFY_CONFIG=true
+TENDERLY_TESTNET_RPC_URL=# The RPC_URL of a Tenderly VirtualTestnet; Found on the Dashboard UI for Virtual Testnets