Anvil fork (#1366)

fork testing examples

Author: skudasov

book/src/SUMMARY.md

@@ -10,6 +10,7 @@
     - [NodeSet with Capabilities](./framework/nodeset_capabilities.md)
     - [NodeSet (Local Docker builds)](./framework/nodeset_docker_rebuild.md)
     - [NodeSet Compat Environment](./framework/nodeset_compatibility.md)
+    - [Fork Testing](./framework/fork.md)
     - [NodeSet with External Blockchain]()
     - [CLI](./framework/cli.md)
     - [Configuration](./framework/configuration.md)

book/src/framework/fork.md

@@ -0,0 +1,42 @@
+# Fork Testing
+
+We verify our on-chain and off-chain changes using forks of various networks.
+
+Go to example project [dir](https://github.com/smartcontractkit/chainlink-testing-framework/tree/main/framework/examples/myproject) to try the examples yourself.
+
+## On-chain Only
+In this [example](https://github.com/smartcontractkit/chainlink-testing-framework/blob/main/framework/examples/myproject/fork_test.go), we:
+
+- Create two `anvil` networks, each targeting the desired network (change [URLs](https://github.com/smartcontractkit/chainlink-testing-framework/blob/main/framework/examples/myproject/fork.toml) and `anvil` settings as required, see [full anvil](https://book.getfoundry.sh/reference/anvil/) reference).
+- Connect two clients to the respective networks.
+- Deploy two test contracts.
+- Interact with the deployed contracts.
+- Demonstrate interactions using the `anvil` RPC client (more client methods examples are [here](https://github.com/smartcontractkit/chainlink-testing-framework/blob/main/framework/rpc/rpc_test.go))
+
+Run it 
+```
+CTF_CONFIGS=fork.toml go test -v -run TestFork
+```
+
+## On-chain + Off-chain
+
+The chain setup remains the same as in the previous example, but now we have 5 `Chainlink` nodes [connected with 2 networks](https://github.com/smartcontractkit/chainlink-testing-framework/blob/main/framework/examples/myproject/fork_plus_offchain_test.go).
+
+Run it
+```
+CTF_CONFIGS=fork_plus_offchain.toml go test -v -run TestOffChainAndFork
+```
+
+<div class="warning">
+
+Be mindful of RPC rate limits, as your provider may enforce restrictions. Use `docker_cmd_params` field to configure appropriate rate limiting and retries with the following parameters:
+```
+--compute-units-per-second <CUPS>
+--fork-retry-backoff <BACKOFF>
+--retries <retries>
+--timeout <timeout>
+```
+If the network imposes limits, the container will panic, triggering messages indicating that the container health check has failed.
+
+</div>
+

framework/.changeset/v0.2.8.md

@@ -0,0 +1,3 @@
+- Fund nodes method added to `NodeSet`
+- Add on-chain fork test example
+- Add on-chain + off-chain fork test example

framework/cmd/observability/blockscout/services/backend.yml

@@ -2,7 +2,7 @@ version: '3.9'
 
 services:
   backend:
-    image: blockscout/${DOCKER_REPO:-blockscout}:${DOCKER_TAG:-latest}
+    image: blockscout/blockscout:6.9.0.commit.4100e959
     pull_policy: always
     restart: always
     stop_grace_period: 5m

framework/cmd/observability/blockscout/services/frontend.yml

@@ -2,7 +2,7 @@ version: '3.9'
 
 services:
   frontend:
-    image: ghcr.io/blockscout/frontend:${FRONTEND_DOCKER_TAG:-latest}
+    image: ghcr.io/blockscout/frontend:v1.36.2
     pull_policy: always
     platform: linux/amd64
     restart: always

framework/cmd/observability/blockscout/services/sig-provider.yml

@@ -2,7 +2,7 @@ version: '3.9'
 
 services:
   sig-provider:
-    image: ghcr.io/blockscout/sig-provider:${SIG_PROVIDER_DOCKER_TAG:-latest}
+    image: ghcr.io/blockscout/sig-provider:v1.1.1
     pull_policy: always
     platform: linux/amd64
     restart: always

framework/cmd/observability/blockscout/services/smart-contract-verifier.yml

@@ -2,7 +2,7 @@ version: '3.9'
 
 services:
   smart-contract-verifier:
-    image: ghcr.io/blockscout/smart-contract-verifier:${SMART_CONTRACT_VERIFIER_DOCKER_TAG:-latest}
+    image: ghcr.io/blockscout/smart-contract-verifier:v1.9.2
     pull_policy: always
     platform: linux/amd64
     restart: always

framework/cmd/observability/blockscout/services/stats.yml

@@ -35,7 +35,7 @@ services:
       start_period: 10s
 
   stats:
-    image: ghcr.io/blockscout/stats:${STATS_DOCKER_TAG:-latest}
+    image: ghcr.io/blockscout/stats:v2.2.3
     pull_policy: always
     platform: linux/amd64
     restart: always

framework/cmd/observability/blockscout/services/user-ops-indexer.yml

@@ -2,7 +2,7 @@ version: '3.9'
 
 services:
   user-ops-indexer:
-    image: ghcr.io/blockscout/user-ops-indexer:${USER_OPS_INDEXER_DOCKER_TAG:-latest}
+    image: ghcr.io/blockscout/user-ops-indexer:v1.3.0
     pull_policy: always
     platform: linux/amd64
     restart: always

framework/cmd/observability/blockscout/services/visualizer.yml

@@ -2,7 +2,7 @@ version: '3.9'
 
 services:
   visualizer:
-    image: ghcr.io/blockscout/visualizer:${VISUALIZER_DOCKER_TAG:-latest}
+    image: ghcr.io/blockscout/visualizer:v0.2.1
     pull_policy: always
     platform: linux/amd64
     restart: always