Merge branch 'main' into tt-1806-labelling-readme

Author: Tofel

book/src/SUMMARY.md

@@ -33,8 +33,7 @@
     - [Blockscout](framework/observability/blockscout.md)
     - [Components](framework/components/overview.md)
         - [Blockchains](framework/components/blockchains/overview.md)
-            - [Anvil](framework/components/blockchains/anvil.md)
-            - [Geth]()
+            - [EVM](framework/components/blockchains/evm.md)
             - [Optimism Stack]()
             - [Arbitrum Stack]()
         - [Chainlink](framework/components/chainlink.md)

book/src/developing.md

@@ -5,4 +5,4 @@ Here we describe good practices for developing components for our framework.
 Rules for components are simple:
 - Component should declare some `Input` and an optional `Output` (we use that so we can skip or cache any component results)
 - Components should be isolated, they should not return anything except basic types like `int`, `string`, `maps` or `structs`
-- Component **must** have documentation under [Components](./framework/components/overview.md), here is an [example](./framework/components/blockchains/anvil.md)
+- Component **must** have documentation under [Components](./framework/components/overview.md), here is an [example](./framework/components/chainlink/node.md)

…ramework/components/blockchains/anvil.md …/framework/components/blockchains/evm.mdbook/src/framework/components/blockchains/anvil.md renamed to book/src/framework/components/blockchains/evm.md book/src/framework/components/blockchains/anvil.md renamed to book/src/framework/components/blockchains/evm.md

@@ -1,27 +1,33 @@
-# Anvil
-[Anvil](https://book.getfoundry.sh/anvil/) is a Foundry local EVM blockchain simulator
+# EVM Blockchain Clients
+
+We support 3 EVM clients at the moment: [Geth](https://geth.ethereum.org/docs/fundamentals/command-line-options), [Anvil](https://book.getfoundry.sh/anvil/) and [Besu](https://besu.hyperledger.org/)
 
 ## Configuration
 ```toml
 [blockchain_a]
-  # Blockchain node type, can be "anvil" or "geth"
+  # Blockchain node type, can be "anvil", "geth" or "besu
   type = "anvil"
   # Chain ID
-  chain_id = "31337"
+  chain_id = "1337"
   # Anvil command line params, ex.: docker_cmd_params = ['--block-time=1', '...']
   docker_cmd_params = []
   # Docker image and tag
   image = "f4hrenh9it/foundry:latest"
-  # External port to expose
+  # External port to expose (HTTP API)
   port = "8545"
+  # External port to expose (WS API)
+  port_ws = "8546"
   # Pulls the image every time if set to 'true', used like that in CI. Can be set to 'false' to speed up local runs
   pull_image = false
 
   # Outputs are the results of deploying a component that can be used by another component
   [blockchain_a.out]
-    chain_id = "31337"
     # If 'use_cache' equals 'true' we skip component setup when we run the test and return the outputs
     use_cache = true
+    # Chain ID
+    chain_id = "1337"
+    # Chain family, "evm", "solana", "cosmos", "op", "arb"
+    family = "evm"
 
     [[blockchain_a.out.nodes]]
       # URLs to access the node(s) inside docker network, used by other components
@@ -58,3 +64,13 @@ func TestDON(t *testing.T) {
 }
 ```
 
+## Test Private Keys
+
+For `Geth` and `Anvil` we use the same key
+```
+Public: 0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266
+Private: ac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80
+```
+
+Test keys for `Besu` can be found [here](https://besu.hyperledger.org/23.4.1/private-networks/reference/accounts-for-testing)
+

book/src/framework/components/chainlink/nodeset.md

@@ -14,7 +14,7 @@ This component requires some Blockchain to be deployed, add this to config
   # Blockchain node type, can be "anvil" or "geth"
   type = "anvil"
   # Chain ID
-  chain_id = "31337"
+  chain_id = "1337"
   # Anvil command line params, ex.: docker_cmd_params = ['--block-time=1', '...']
   docker_cmd_params = []
   # Docker image and tag
@@ -26,7 +26,7 @@ This component requires some Blockchain to be deployed, add this to config
 
   # Outputs are the results of deploying a component that can be used by another component
   [blockchain_a.out]
-    chain_id = "31337"
+    chain_id = "1337"
     # If 'use_cache' equals 'true' we skip component setup when we run the test and return the outputs
     use_cache = true
 

book/src/framework/components/configuration.md

@@ -34,7 +34,7 @@ func TestDON(t *testing.T) {
 In `TOML`:
 ```
 [blockchain_a]
-chain_id = "31337"
+chain_id = "1337"
 image = "f4hrenh9it/foundry:latest"
 port = "8500"
 type = "anvil"

book/src/framework/components/external.md

@@ -12,7 +12,7 @@ For example, to integrate with remote `k8s` environment you can use `CTF_CONFIGS
 [blockchain_a]
 
   [blockchain_a.out]
-    chain_id = "31337"
+    chain_id = "1337"
     use_cache = true
 
     [[blockchain_a.out.nodes]]

book/src/framework/connecting_chainlink_node.md

@@ -5,13 +5,9 @@ Now let's have an example of Chainlink node connected to some local blockchain.
 Create your configuration in `smoke.toml`
 ```toml
 [blockchain_a]
-  chain_id = "31337"
-  image = "f4hrenh9it/foundry:latest"
-  port = "8545"
   type = "anvil"
   docker_cmd_params = ["-b", "1"]
 
-
 [cl_node]
 
   [cl_node.db]

book/src/framework/first_test.md

@@ -7,11 +7,8 @@ Let's spin up a simple component.
 Create your configuration in `smoke.toml`
 ```toml
 [blockchain_a]
-  chain_id = "31337"
-  image = "f4hrenh9it/foundry:latest"
-  port = "8545"
+  # choose between "anvil", "geth" or "besu"
   type = "anvil"
-  docker_cmd_params = ["-b", "1"]
 ```
 
 Create your test in `smoke_test.go`
@@ -58,4 +55,4 @@ Summary:
 
 Now let's connect the [Chainlink](./connecting_chainlink_node.md) node!
 
-Learn more about [anvil](./components/blockchains/anvil.md) component.
+Learn more about [EVM Client](./components/blockchains/evm.md) component.

book/src/framework/nodeset_capabilities.md

@@ -17,9 +17,6 @@ go get github.com/smartcontractkit/capabilities/kvstore && go install github.com
 Create a configuration file `smoke.toml`
 ```toml
 [blockchain_a]
-  chain_id = "31337"
-  image = "f4hrenh9it/foundry:latest"
-  port = "8545"
   type = "anvil"
   docker_cmd_params = ["-b", "1"]
 

book/src/framework/nodeset_compatibility.md

@@ -5,9 +5,6 @@ The difference between this and [basic node set configuration](nodeset_environme
 Create a configuration file `smoke.toml`
 ```toml
 [blockchain_a]
-  chain_id = "31337"
-  image = "f4hrenh9it/foundry:latest"
-  port = "8545"
   type = "anvil"
   docker_cmd_params = ["-b", "1"]