[wip] chore: enable dumping the container logs of the forked environment

Author: gustavogama-cll

chain/evm/provider/ctf_anvil_provider.go

@@ -208,6 +208,8 @@ import (
 	"fmt"
 	"math/big"
 	"net/http"
+	"os"
+	"slices"
 	"strconv"
 	"strings"
 	"sync"
@@ -217,9 +219,11 @@ import (
 	"github.com/avast/retry-go/v4"
 	"github.com/ethereum/go-ethereum/accounts/abi/bind"
 	"github.com/ethereum/go-ethereum/crypto"
+	"github.com/rs/zerolog"
 	chainsel "github.com/smartcontractkit/chain-selectors"
 	"github.com/smartcontractkit/chainlink-testing-framework/framework"
 	"github.com/smartcontractkit/chainlink-testing-framework/framework/components/blockchain"
+	ctfdocker "github.com/smartcontractkit/chainlink-testing-framework/lib/docker"
 	"github.com/smartcontractkit/freeport"
 	"github.com/testcontainers/testcontainers-go"
 
@@ -516,6 +520,14 @@ func (p *CTFAnvilChainProvider) GetNodeHTTPURL() string {
 // Returns an error if the container termination fails.
 func (p *CTFAnvilChainProvider) Cleanup(ctx context.Context) error {
 	if p.container != nil {
+		if shouldSaveCtfContainerLogs() {
+			zlogger := zerolog.New(os.Stdout)
+			ctfdocker.WriteAllContainersLogs(zlogger, "logs")
+			wd, _ := os.Getwd()
+			zlogger.Info().Msgf("container logs saved to \"%s/logs\"", wd)
+		}
+
+		// if slices.Contains([]string{}, strconv.ToLower(os.GetEnv("CTF_CONTAINER_LOGS")) {
 		err := p.container.Terminate(ctx)
 		if err != nil {
 			return fmt.Errorf("failed to terminate Anvil container: %w", err)
@@ -714,3 +726,8 @@ func (p *CTFAnvilChainProvider) waitForAnvilReady(ctx context.Context, httpURL s
 		retry.DelayType(retry.FixedDelay),
 	)
 }
+
+func shouldSaveCtfContainerLogs() bool {
+	trueValues := []string{"1", "true", "on", "enabled"}
+	return slices.Contains(trueValues, strings.ToLower(os.Getenv("CTF_CONTAINER_LOGS")))
+}

engine/cld/environment/anvil.go

@@ -117,6 +117,7 @@ type RPCs struct {
 type ChainConfig struct {
 	ChainID  string // chain id as per EIP-155
 	HTTPRPCs []RPCs // http rpcs to connect to the chain
+	Provider *evmprov.CTFAnvilChainProvider
 }
 
 // AnvilChainsOutput represents the output of the newAnvilChains function.
@@ -287,6 +288,7 @@ func newAnvilChains(
 
 		chainConfigsBySelector[chainSelector] = ChainConfig{
 			ChainID: chainIDStr,
+			Provider: provider,
 			HTTPRPCs: []RPCs{
 				{
 					External: provider.GetNodeHTTPURL(),

engine/cld/legacy/cli/mcmsv2/mcms_v2.go

@@ -619,6 +619,13 @@ func buildExecuteForkCommand(lggr logger.Logger, domain cldf_domain.Domain, prop
 			if err != nil {
 				return fmt.Errorf("error creating config: %w", err)
 			}
+			defer func() {
+				for _, chainConfig := range cfg.forkedEnv.ChainConfigs {
+					if chainConfig.Provider != nil {
+						chainConfig.Provider.Cleanup(cmd.Context())
+					}
+				}
+			}()
 
 			// get the chain URL, chain ID and MCM contract address
 			url := cfg.forkedEnv.ChainConfigs[cfg.chainSelector].HTTPRPCs[0].External

go.mod

@@ -34,6 +34,7 @@ require (
 	github.com/smartcontractkit/chainlink-protos/job-distributor v0.12.0
 	github.com/smartcontractkit/chainlink-protos/op-catalog v0.0.4
 	github.com/smartcontractkit/chainlink-testing-framework/framework v0.10.30
+	github.com/smartcontractkit/chainlink-testing-framework/lib v1.54.6
 	github.com/smartcontractkit/chainlink-testing-framework/seth v1.51.2
 	github.com/smartcontractkit/chainlink-tron/relayer v0.0.11-0.20250815105909-75499abc4335
 	github.com/smartcontractkit/freeport v0.1.2
@@ -226,7 +227,7 @@ require (
 	github.com/rivo/uniseg v0.4.7 // indirect
 	github.com/rogpeppe/go-internal v1.13.1 // indirect
 	github.com/rs/cors v1.11.1 // indirect
-	github.com/rs/zerolog v1.33.0 // indirect
+	github.com/rs/zerolog v1.33.0
 	github.com/russross/blackfriday/v2 v2.1.0 // indirect
 	github.com/sagikazarmark/locafero v0.11.0 // indirect
 	github.com/samber/lo v1.49.1 // indirect
@@ -283,7 +284,6 @@ require (
 	go.opentelemetry.io/otel/sdk/metric v1.37.0 // indirect
 	go.opentelemetry.io/otel/trace v1.37.0 // indirect
 	go.opentelemetry.io/proto/otlp v1.5.0 // indirect
-	go.uber.org/atomic v1.11.0 // indirect
 	go.uber.org/multierr v1.11.0 // indirect
 	go.uber.org/ratelimit v0.3.1 // indirect
 	golang.org/x/net v0.43.0 // indirect

go.sum

@@ -696,6 +696,8 @@ github.com/smartcontractkit/chainlink-sui v0.0.0-20251013155034-5f85c5f450ab h1:
 github.com/smartcontractkit/chainlink-sui v0.0.0-20251013155034-5f85c5f450ab/go.mod h1:VlyZhVw+a93Sk8rVHOIH6tpiXrMzuWLZrjs1eTIExW8=
 github.com/smartcontractkit/chainlink-testing-framework/framework v0.10.30 h1:mDxJnEl5jKs3FLHKIjwtCFEP4ihKhFS6yuPDNcC0EDM=
 github.com/smartcontractkit/chainlink-testing-framework/framework v0.10.30/go.mod h1:SoCjdzeZHP500QtKAjJ9I6rHD03SkQmRL4dNkOoe6yk=
+github.com/smartcontractkit/chainlink-testing-framework/lib v1.54.6 h1:t1db5+sEbmw/26xQVDqyeY448V4RW8xtAl4eNGpd0uw=
+github.com/smartcontractkit/chainlink-testing-framework/lib v1.54.6/go.mod h1:dgwtcefGr+0i+C2S6V/Xgntzm7E5CPxXMyi2OnQvnHI=
 github.com/smartcontractkit/chainlink-testing-framework/seth v1.51.2 h1:ZJ/8Jx6Be5//TyjPi1pS1uotnmcYq5vVkSyISIymSj8=
 github.com/smartcontractkit/chainlink-testing-framework/seth v1.51.2/go.mod h1:kHYJnZUqiPF7/xN5273prV+srrLJkS77GbBXHLKQpx0=
 github.com/smartcontractkit/chainlink-tron/relayer v0.0.11-0.20250815105909-75499abc4335 h1:7bxYNrPpygn8PUSBiEKn8riMd7CXMi/4bjTy0fHhcrY=