Merge branch 'main' into feature/more-prefunded-accounts

Author: maoueh

.github/CODEOWNERS

@@ -0,0 +1,2 @@
+# Default code owners for all files
+* @canercidam @ferranbt

.github/workflows/checks.yaml

@@ -8,9 +8,9 @@ on:
     branches: [main]
 
 jobs:
-  test:
+  e2e-test:
     name: E2E test (${{ matrix.flags }})
-    runs-on: ubuntu-latest
+    runs-on: warp-ubuntu-latest-x64-8x
     strategy:
       matrix:
         flags:
@@ -49,3 +49,54 @@ jobs:
           name: playground-logs-${{ matrix.flags }}
           path: /tmp/playground-logs
           retention-days: 5
+
+  unit-test:
+    name: Unit test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v2
+
+      - name: Set up Go
+        uses: actions/setup-go@v2
+        with:
+          go-version: 1.24
+
+      - name: Install docker compose
+        run: ./scripts/ci-setup-docker-compose.sh
+
+      - name: Run unit tests
+        run: go test -v ./playground/...
+
+  lint:
+    name: Lint
+    runs-on: warp-ubuntu-latest-x64-8x
+    steps:
+      - name: Check out code into the Go module directory
+        uses: actions/checkout@v5
+
+      - name: Set up Go
+        uses: actions/setup-go@v6
+        with:
+          go-version: ^1.24
+
+      - name: Download dependencies
+        run: go mod download
+
+      - name: Install gofumpt
+        run: go install mvdan.cc/gofumpt@v0.6.0
+
+      - name: Install staticcheck
+        run: go install honnef.co/go/tools/cmd/staticcheck@2025.1.1
+
+      - name: Install golangci-lint
+        run: go install github.com/golangci/golangci-lint/v2/cmd/golangci-lint@v2.1.2
+
+      - name: Lint
+        run: make lint
+
+      - name: Ensure go mod tidy runs without changes
+        run: |
+          go mod tidy
+          git update-index -q --really-refresh
+          git diff-index HEAD

.github/workflows/docker-utils-release.yaml

@@ -16,7 +16,7 @@ on:
 
 jobs:
   docker:
-    runs-on: ubuntu-latest
+    runs-on: warp-ubuntu-latest-x64-8x
     steps:
       - name: Checkout
         uses: actions/checkout@v4

.github/workflows/release.yaml

@@ -9,7 +9,7 @@ on:
 
 jobs:
   release:
-    runs-on: ubuntu-latest
+    runs-on: warp-ubuntu-latest-x64-8x
     steps:
       - name: Checkout
         uses: actions/checkout@v4

.gitignore

@@ -2,3 +2,4 @@ local-testnet
 output
 builder-playground
 **/.DS_Store
+e2e-test/

.golangci.yaml

@@ -0,0 +1,104 @@
+version: "2"
+linters:
+  enable-all: true
+  disable:
+    - cyclop
+    - forbidigo
+    - funlen
+    - gochecknoglobals
+    - gochecknoinits
+    - gocritic
+    - godot
+    - godox
+    - mnd
+    - lll
+    - nestif
+    - nilnil
+    - nlreturn
+    - noctx
+    - nonamedreturns
+    - paralleltest
+    - revive
+    - testpackage
+    - unparam
+    - varnamelen
+    - wrapcheck
+    - wsl
+    - exhaustruct
+    - depguard
+    - err113
+
+    #
+    # Disabled because of generics:
+    #
+    - contextcheck
+    - rowserrcheck
+    - sqlclosecheck
+    - wastedassign
+
+    #
+    # Disabled because deprecated:
+    #
+
+linters-settings:
+  #
+  # The G108 rule throws a false positive. We're not actually vulnerable. If
+  # you're not careful the profiling endpoint is automatically exposed on
+  # /debug/pprof if you import net/http/pprof. See this link:
+  #
+  #   https://mmcloughlin.com/posts/your-pprof-is-showing
+  #
+  gosec:
+    excludes:
+      - G108
+
+  tagliatelle:
+    case:
+      rules:
+        json: snake
+
+  gofumpt:
+    extra-rules: true
+
+  exhaustruct:
+    exclude:
+      #
+      # Because it's easier to read without the other fields.
+      #
+      - 'GetPayloadsFilters'
+
+      #
+      # Structures outside our control that have a ton of settings. It doesn't
+      # make sense to specify all of the fields.
+      #
+      - 'cobra.Command'
+      - 'database.*Entry'
+      - 'http.Server'
+      - 'logrus.*Formatter'
+      - 'Options' # redis
+
+      #
+      # Excluded because there are private fields (not capitalized) that are
+      # not initialized. If possible, I think these should be altered.
+      #
+      - 'Datastore'
+      - 'Housekeeper'
+      - 'MockBeaconClient'
+      - 'RelayAPI'
+      - 'Webserver'
+
+formatters:
+  enable:
+    - gci
+    - gofmt
+    - gofumpt
+    - goimports
+  settings:
+    gofumpt:
+      extra-rules: true
+  exclusions:
+    generated: lax
+    paths:
+      - third_party$
+      - builtin$
+      - examples$

Makefile

@@ -1,4 +1,56 @@
+# Heavily inspired by Lighthouse: https://github.com/sigp/lighthouse/blob/stable/Makefile
+# and Reth: https://github.com/paradigmxyz/reth/blob/main/Makefile
+.DEFAULT_GOAL := help
 
+VERSION := $(shell git describe --tags --always --dirty="-dev")
+
+##@ Help
+
+.PHONY: help
+help: ## Display this help.
+	@awk 'BEGIN {FS = ":.*##"; printf "Usage:\n  make \033[36m<target>\033[0m\n"} /^[a-zA-Z_0-9-]+:.*?##/ { printf "  \033[36m%-15s\033[0m %s\n", $$1, $$2 } /^##@/ { printf "\n\033[1m%s\033[0m\n", substr($$0, 5) } ' $(MAKEFILE_LIST)
+
+.PHONY: v
+v: ## Show the version
+	@echo "Version: ${VERSION}"
+
+##@ Build
+
+.PHONY: build
+build: ## Build the CLI
+	go build -ldflags "-X main.version=${VERSION}" -o ./builder-playground main.go
+	@echo "Binary built: ./builder-playground (version: ${VERSION})"
+
+##@ Test & Development
+
+.PHONY: test
+test: ## Run tests
+	go test -v -count=1 ./...
+
+
+.PHONY: lint
+lint: ## Run linters
+	gofmt -d -s .
+	gofumpt -d -extra .
+	go vet ./...
+	staticcheck ./... || true
+	# golangci-lint run || true
+
+.PHONY: fmt
+fmt: ## Format the code
+	gofmt -s -w .
+	gci write .
+	gofumpt -w -extra .
+	go mod tidy
+
+.PHONY: gofumpt
+gofumpt: ## Run gofumpt
+	gofumpt -l -w -extra .
+
+.PHONY: lt
+lt: lint test ## Run linters and tests
+
+.PHONY: ci-release
 ci-release:
 	docker run \
 		--rm \