v2: full revamping in golang

.claude/hooks/lint-after-build.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+# Runs golangci-lint after go build commands.
+
+INPUT=$(cat)
+
+COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')
+
+if echo "$COMMAND" | grep -q 'go build'; then
+  cd "$CLAUDE_PROJECT_DIR" || exit 0
+  OUTPUT=$(golangci-lint run ./... 2>&1)
+  EXIT_CODE=$?
+  if [ $EXIT_CODE -ne 0 ]; then
+    echo "golangci-lint found issues:" >&2
+    echo "$OUTPUT" >&2
+    exit 2
+  fi
+fi
+
+exit 0

.claude/settings.json

@@ -0,0 +1,17 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/lint-after-build.sh",
+            "timeout": 120,
+            "statusMessage": "Running golangci-lint..."
+          }
+        ]
+      }
+    ]
+  }
+}

.claude/skills/erigon-rpcdaemon-run/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: erigon-rpcdaemon-run
+description: Use to run standalone Erigon RpcDaemon on an existing datadir. Use when the user wants to exercise the `rpc-tests` binaries (`rpc_int`, `rpc_perf`) against real server.
+allowed-tools: Bash, Read, Glob
+---
+
+# Erigon RpcDaemon Run
+
+## Overview
+The `rpcdaemon` command runs standalone RpcDaemon on an existing Erigon datadir.
+
+## Command Syntax
+
+```bash
+cd <erigon_home> && ./build/bin/rpcdaemon --datadir=<path> --http.api admin,debug,eth,parity,erigon,trace,web3,txpool,ots,net --ws [other-flags]
+```
+
+## Required Flags
+
+- `--datadir`: Path to the Erigon datadir (required)
+
+## Usage Patterns
+
+### Change HTTP port
+```bash
+cd <erigon_home_path> && ./build/bin/rpcdaemon --datadir=<datadir_path> --http.port=8546
+```
+
+### WebSocket support
+```bash
+cd <erigon_home_path> && ./build/bin/rpcdaemon --datadir=<datadir_path> --ws
+```
+
+### GraphQL support
+```bash
+cd <erigon_home_path> && ./build/bin/rpcdaemon --datadir=<datadir_path> --graphql
+```
+
+## Important Considerations
+
+### Before Running
+1. **Ask for Erigon home**: Ask the user which Erigon home folder to use if not already provided
+2. **Stop Erigon and RpcDaemon**: Ensure Erigon and/or RpcDaemon are not running on the target datadir
+3. **Ensure RpcDaemon binary is built**: run `make rpcdaemon` to build it
+
+### After Running
+1. Wait until the HTTP port (value provided with --http.port or default 8545) is reachable
+
+
+## Workflow
+
+When the user wants to run Erigon RpcDaemon:
+
+1. **Confirm parameters**
+    - Ask for Erigon home path to use if not provided or know in context
+    - Ask for target datadir path
+
+2. **Safety checks**
+    - Verify Erigon home <erigon_home_path> exists
+    - Verify datadir <datadir_path> exists
+    - Check if Erigon and/or RpcDaemon are running (should not be)
+
+
+## Error Handling
+
+Common issues:
+- **"datadir not found"**: Verify the path is correct
+- **"database locked"**: Stop Erigon process first
+
+
+## Examples
+
+### Example 1: All API namespaces and WebSocket enabled
+```bash
+cd ../erigon_devel && ./build/bin/rpcdaemon --datadir=~/Library/erigon-eth-mainnet --http.api admin,debug,eth,parity,erigon,trace,web3,txpool,ots,net --ws
+```
+
+
+## Tips
+
+- If building from source, use `make rpcdaemon` within <erigon_home_path> to build the binary at `build/bin/rpcdaemon`

.claude/skills/erigon-run/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: erigon-run
+description: Use to run Erigon on an existing datadir. Use when the user wants to exercise the `rpc-tests` binaries (`rpc_int`, `rpc_perf`) against real server.
+allowed-tools: Bash, Read, Glob
+---
+
+# Erigon Run
+
+## Overview
+The `erigon` command runs Erigon on an existing Erigon datadir.
+
+## Command Syntax
+
+```bash
+cd <erigon_home> && ./build/bin/erigon --datadir=<path> --http.api admin,debug,eth,parity,erigon,trace,web3,txpool,ots,net --ws [other-flags]
+```
+
+## Required Flags
+
+- `--datadir`: Path to the Erigon datadir (required)
+
+## Usage Patterns
+
+### Change HTTP port
+```bash
+cd <erigon_home_path> && ./build/bin/erigon --datadir=<datadir_path> --http.port=8546
+```
+
+### WebSocket support
+```bash
+cd <erigon_home_path> && ./build/bin/erigon --datadir=<datadir_path> --ws
+```
+
+### GraphQL support
+```bash
+cd <erigon_home_path> && ./build/bin/erigon --datadir=<datadir_path> --graphql
+```
+
+## Important Considerations
+
+### Before Running
+1. **Ask for Erigon home**: Ask the user which Erigon home folder to use if not already provided
+2. **Stop Erigon and RpcDaemon**: Ensure Erigon and/or RpcDaemon are not running on the target datadir
+3. **Ensure Erigon binary is built**: run `make erigon` to build it
+
+### After Running
+1. Wait until the HTTP port (value provided with --http.port or default 8545) is reachable
+
+
+## Workflow
+
+When the user wants to run Erigon:
+
+1. **Confirm parameters**
+    - Ask for Erigon home path to use if not provided or know in context
+    - Ask for target datadir path
+
+2. **Safety checks**
+    - Verify Erigon home <erigon_home_path> exists
+    - Verify datadir <datadir_path> exists
+    - Check if Erigon and/or RpcDaemon are running (should not be)
+
+
+## Error Handling
+
+Common issues:
+- **"datadir not found"**: Verify the path is correct
+- **"database locked"**: Stop Erigon process first
+
+
+## Examples
+
+### Example 1: All API namespaces and WebSocket enabled
+```bash
+cd ../erigon_devel && ./build/bin/erigon --datadir=~/Library/erigon-eth-mainnet --http.api admin,debug,eth,parity,erigon,trace,web3,txpool,ots,net --ws
+```
+
+
+## Tips
+
+- If building from source, use `make erigon` within <erigon_home_path> to build the binary at `build/bin/erigon`

.golangci.yml

@@ -0,0 +1,92 @@
+version: "2"
+
+linters:
+  default: none
+  enable:
+    # Bugs & correctness
+    - errcheck
+    - govet
+    - staticcheck
+    - ineffassign
+    - unused
+    - bodyclose
+    - durationcheck
+    - errorlint
+    - nilerr
+
+    # Code simplification
+    - intrange
+    - copyloopvar
+    - modernize
+
+    # Performance
+    - prealloc
+
+    # Style consistency
+    - misspell
+    - unconvert
+    - wastedassign
+
+  settings:
+    errcheck:
+      exclude-functions:
+        - fmt.Fprintf
+        - fmt.Fprintln
+        - fmt.Fprint
+        - fmt.Printf
+        - fmt.Println
+        - fmt.Print
+        - (io.Closer).Close
+        - (*os.File).Close
+        - (*bufio.Writer).Flush
+        - (*bufio.Writer).Write
+        - (net/http.ResponseWriter).Write
+        - (*encoding/json.Encoder).Encode
+    govet:
+      enable-all: true
+      disable:
+        - fieldalignment
+        - shadow  # Too noisy, many false positives with err shadowing
+    staticcheck:
+      checks:
+        - "all"
+        - "-QF*"    # Disable quickfix suggestions
+        - "-ST1003" # Naming conventions: renaming exports is a breaking change
+    errorlint:
+      asserts: false
+
+  exclusions:
+    presets:
+      - comments
+    rules:
+      # Test files: relax errcheck
+      - linters: [errcheck]
+        path: _test\.go
+      # defer Close/Flush: universally safe to ignore
+      - linters: [errcheck]
+        text: "Error return value of .*(Close|Flush).* is not checked"
+      # bodyclose false positives on websocket dial and raw HTTP handler
+      - path: internal/rpc/websocket\.go
+        linters: [bodyclose]
+      - path: internal/rpc/wsconn\.go
+        linters: [bodyclose]
+      - path: internal/rpc/http\.go
+        text: "response body must be closed"
+        linters: [bodyclose]
+
+formatters:
+  enable:
+    - gofmt
+    - goimports
+
+issues:
+  max-same-issues: 0
+  max-issues-per-linter: 0
+
+output:
+  sort-results: true
+  sort-order:
+    - file
+
+run:
+  timeout: 5m