Merge branch 'main' into DX-379

Author: erikburt

book/src/SUMMARY.md

@@ -25,6 +25,7 @@
   - [Components Cleanup](framework/components/cleanup.md)
   - [Components Caching](framework/components/caching.md)
   - [Components Resources](framework/components/resources.md)
+  - [Containers Network Isolation](framework/components/network_isolation.md)
   - [Mocking Services](framework/components/mocking.md)
   - [Copying Files](framework/copying_files.md)
   - [External Environment](framework/components/external.md)

book/src/framework/components/blockchains/tron.md

@@ -4,7 +4,7 @@
 ```toml
 [blockchain_a]
   type = "tron"
-  # image = "tronbox/tre" is default image
+  # image = "tronbox/tre:1.0.3" is default image
 ```
 Default port is `9090`
 

book/src/framework/components/network_isolation.md

@@ -0,0 +1,12 @@
+# Containers Network Isolation
+
+Some components can be isolated from internet. Since some of them doesn't have `iptables` and must be accessible from local host for debugging we isolate network on DNS level.
+
+JobDistributor is isolated from internet by default to prevent applying manifest changes when run in tests.
+
+NodeSet DNS isolation can be controlled with a flag
+```
+[[nodesets]]
+  # NodeSet DNS can be isolated if needed
+  no_dns = true
+```

book/src/framework/components/troubleshooting.md

@@ -1,5 +1,18 @@
 # Troubleshooting
 
+## Can't start `ctf obs u`
+```
+Error response from daemon: error while creating mount source path '/host_mnt/Users/fsldkfs/Downloads/compose/conf/provisioning/dashboards/cadvisor/cadvisor.json': mkdir /host_mnt/Users/sdfjskj/Downloads/compose/conf/provisioning: operation not permitted
+exit status 1
+```
+
+#### Solution
+Enable Docker to access your directory
+```
+Docker Desktop -> Settings -> Resources -> File Sharing
+```
+
+
 ## Can't run `anvil`, issue with `Rosetta`
 ```
 2024/11/27 15:20:27 ⏳ Waiting for container id 79f8a68c07cc image: f4hrenh9it/foundry:latest. Waiting for: &{Port:8546 timeout:0x14000901278 PollInterval:100ms skipInternalCheck:false}

framework/.changeset/v0.7.5.md

@@ -0,0 +1,3 @@
+- Add chain type to output
+- Expose constants for types and families
+- Pin tronbox/tre image, recent changes do not work on amd64

framework/.changeset/v0.7.6.md

@@ -0,0 +1,2 @@
+- Add troubleshooting for observability stack and file access
+- Add DNS isolation for CL node and JD + test

framework/.changeset/v0.7.7.md

@@ -0,0 +1 @@
+- JD with a real DB dump

framework/components/blockchain/aptos.go

@@ -127,7 +127,8 @@ func newAptos(in *Input) (*Output, error) {
 	}
 	return &Output{
 		UseCache:      true,
-		Family:        "aptos",
+		Type:          in.Type,
+		Family:        FamilyAptos,
 		ContainerName: containerName,
 		Nodes: []*Node{
 			{

framework/components/blockchain/blockchain.go

@@ -8,6 +8,27 @@ import (
 	"github.com/smartcontractkit/chainlink-testing-framework/framework"
 )
 
+// Blockchain node type
+const (
+	TypeAnvil       = "anvil"
+	TypeAnvilZKSync = "anvil-zksync"
+	TypeGeth        = "geth"
+	TypeBesu        = "besu"
+	TypeSolana      = "solana"
+	TypeAptos       = "aptos"
+	TypeSui         = "sui"
+	TypeTron        = "tron"
+)
+
+// Blockchain node family
+const (
+	FamilyEVM    = "evm"
+	FamilySolana = "solana"
+	FamilyAptos  = "aptos"
+	FamilySui    = "sui"
+	FamilyTron   = "tron"
+)
+
 // Input is a blockchain network configuration params
 type Input struct {
 	// Common EVM fields
@@ -36,6 +57,7 @@ type Input struct {
 // Output is a blockchain network output, ChainID and one or more nodes that forms the network
 type Output struct {
 	UseCache            bool                     `toml:"use_cache"`
+	Type                string                   `toml:"type"`
 	Family              string                   `toml:"family"`
 	ContainerName       string                   `toml:"container_name"`
 	NetworkSpecificData *NetworkSpecificData     `toml:"network_specific_data"`
@@ -61,21 +83,21 @@ func NewBlockchainNetwork(in *Input) (*Output, error) {
 	var out *Output
 	var err error
 	switch in.Type {
-	case "anvil":
+	case TypeAnvil:
 		out, err = newAnvil(in)
-	case "geth":
+	case TypeGeth:
 		out, err = newGeth(in)
-	case "besu":
+	case TypeBesu:
 		out, err = newBesu(in)
-	case "solana":
+	case TypeSolana:
 		out, err = newSolana(in)
-	case "aptos":
+	case TypeAptos:
 		out, err = newAptos(in)
-	case "sui":
+	case TypeSui:
 		out, err = newSui(in)
-	case "tron":
+	case TypeTron:
 		out, err = newTron(in)
-	case "anvil-zksync":
+	case TypeAnvilZKSync:
 		out, err = newAnvilZksync(in)
 	default:
 		return nil, fmt.Errorf("blockchain type is not supported or empty, must be 'anvil' or 'geth'")

framework/components/blockchain/containers.go

@@ -69,7 +69,8 @@ func createGenericEvmContainer(in *Input, req testcontainers.ContainerRequest, u
 
 	output := Output{
 		UseCache:      true,
-		Family:        "evm",
+		Type:          in.Type,
+		Family:        FamilyEVM,
 		ChainID:       in.ChainID,
 		ContainerName: containerName,
 		Container:     c,