Merge branch 'main' into minhd-vu/witness

Author: minhd-vu

.github/workflows/ci.yml

@@ -22,7 +22,7 @@ jobs:
     name: Lint
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: actions/setup-go@v5
         with:
           go-version: ${{ env.GO_VERSION }}
@@ -32,12 +32,19 @@ jobs:
         run: go install golang.org/x/tools/go/analysis/passes/shadow/cmd/shadow@latest
       - name: Run all the linter tools against code
         run: make lint
+  
+  typos:
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - uses: actions/checkout@v5
+      - uses: crate-ci/typos@a4c3e43aea0a9e9b9e6578d2731ebd9a27e8f6cd # v1.35.5
 
   gen-doc:
     name: Check gen-doc generated files
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: gen-doc
         run: make gen-doc
@@ -58,7 +65,7 @@ jobs:
     name: Check gen-proto generated files
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: gen-proto
         run: make gen-proto
@@ -79,7 +86,7 @@ jobs:
     name: Check gen-go-bindings generated files
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: gen-go-bindings
         run: make gen-go-bindings
@@ -100,7 +107,7 @@ jobs:
     name: Check gen-load-test-modes generated files
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: gen-load-test-modes
         run: make gen-load-test-modes
@@ -121,7 +128,7 @@ jobs:
     name: Check gen-json-rpc-types generated files
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: gen-json-rpc-types
         run: make gen-json-rpc-types
@@ -142,7 +149,7 @@ jobs:
     name: Test
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: actions/setup-go@v5
         with:
           go-version: ${{ env.GO_VERSION }}
@@ -156,7 +163,7 @@ jobs:
       matrix:
         tool: [geth, anvil]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: actions/setup-go@v5
         with:
           go-version: ${{ env.GO_VERSION }}
@@ -183,7 +190,7 @@ jobs:
     name: Install go package
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: actions/setup-go@v5
         with:
           go-version: ${{ env.GO_VERSION }}

.github/workflows/release.yml

@@ -17,7 +17,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout sources
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Install go
         uses: actions/setup-go@v5
@@ -40,7 +40,7 @@ jobs:
         run: echo "tag=$(git describe --tags --exact-match HEAD)" >> $GITHUB_ENV
 
       - name: Publish binaries
-        uses: svenstaro/upload-release-action@ebd922b779f285dafcac6410a0710daee9c12b82 # 2.10.0
+        uses: svenstaro/upload-release-action@81c65b7cd4de9b2570615ce3aad67a41de5b1a13 # 2.11.2
         with:
           repo_token: ${{ secrets.GITHUB_TOKEN }}
           tag: ${{ env.tag }}

CLAUDE.md

@@ -0,0 +1,126 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+polygon-cli is a Swiss Army knife of blockchain tools for building, testing, and running blockchain applications. It's a collection of utilities primarily focused on Polygon/Ethereum ecosystems.
+
+## Architecture Overview
+
+The project follows a command-based architecture using Cobra framework:
+
+- **Main Entry**: `main.go` simply calls `cmd.Execute()`
+- **Command Structure**: Each command is organized in its own package under `cmd/` (e.g., `cmd/loadtest/`, `cmd/monitor/`)
+- **Bindings**: Go bindings for smart contracts are in `bindings/` (generated from Solidity contracts in `contracts/`)
+- **Utilities**: Common utilities are in `util/` package
+
+Key architectural patterns:
+- Commands are self-contained with their own usage documentation (`.md` files)
+- Heavy use of code generation for documentation, protobuf, contract bindings, and RPC types
+- Docker-based generation workflows to ensure consistency
+
+## Common Development Commands
+
+### Building and Installation
+```bash
+# Build the binary
+make build
+
+# Install to ~/go/bin/
+make install
+
+# Cross-compile for different platforms
+make cross        # With CGO
+make simplecross  # Without CGO
+```
+
+### Testing
+```bash
+# Run all tests with coverage
+make test
+
+# Run specific test
+go test -v ./cmd/loadtest/...
+
+# Run load test against local node
+make geth          # Start local geth node
+make geth-loadtest # Fund account and run load test
+```
+
+### Code Quality
+```bash
+# Run all linters (includes tidy, vet, golangci-lint)
+make lint
+
+# Individual linter commands
+make tidy          # Clean up go.mod
+make fmt           # Format code
+make vet           # Run go vet and shadow
+make golangci-lint # Run golangci-lint
+```
+
+### Code Generation
+```bash
+# Generate everything (docs, proto, bindings, etc.)
+make gen
+
+# Individual generation commands
+make gen-doc              # Generate CLI documentation
+make gen-proto            # Generate protobuf stubs
+make gen-go-bindings      # Generate contract bindings
+make gen-load-test-modes  # Generate loadtest mode strings
+make gen-json-rpc-types   # Generate JSON RPC types
+```
+
+### Contract Development
+```bash
+# Work with smart contracts
+cd contracts/
+make build            # Build contracts with Foundry
+make gen-go-bindings  # Generate Go bindings
+```
+
+## Adding New Features
+
+When adding a new command:
+1. Create a new package under `cmd/your-command/`
+2. Add the command to `cmd/root.go` in the `NewPolycliCommand()` function
+3. Create a usage documentation file (e.g., `yourCommandUsage.md`)
+4. Run `make gen-doc` to update the main documentation
+5. If adding a new loadtest mode, run `make gen-load-test-modes` after using stringer
+
+## CI/CD Considerations
+
+The CI pipeline (`/.github/workflows/ci.yml`) runs:
+- Linting (golangci-lint, shadow)
+- Tests
+- Generation checks (ensures all generated files are up-to-date)
+- Load tests against both geth and anvil
+
+Always run `make gen` before committing if you've changed anything that affects code generation.
+
+## Key Dependencies
+
+- Go 1.23+ required
+- Foundry (for smart contract compilation)
+- Docker (for generation tasks)
+- Additional tools: jq, bc, protoc (for development)
+
+## Environment Configuration
+
+The tool supports configuration via:
+- CLI flags (highest priority)
+- Environment variables
+- Config file (`~/.polygon-cli.yaml`)
+- Viper is used for configuration management
+
+## Logging
+
+- Use zerolog for structured, performant logging throughout the project
+
+## Development Guidelines
+- Use conventional commit messages
+
+## Development Memories
+- Use `make build` to build polycli

README.md

@@ -43,6 +43,8 @@ Note: Do not modify this section! It is auto-generated by `cobra` using `make ge
 
 - [polycli cdk](doc/polycli_cdk.md) - Utilities for interacting with CDK networks
 
+- [polycli contract](doc/polycli_contract.md) - Interact with smart contracts and fetch contract information from the blockchain
+
 - [polycli dbbench](doc/polycli_dbbench.md) - Perform a level/pebble db benchmark
 
 - [polycli dockerlogger](doc/polycli_dockerlogger.md) - Monitor and filter Docker container logs
@@ -71,6 +73,8 @@ Note: Do not modify this section! It is auto-generated by `cobra` using `make ge
 
 - [polycli monitor](doc/polycli_monitor.md) - Monitor blocks using a JSON-RPC endpoint.
 
+- [polycli monitorv2](doc/polycli_monitorv2.md) - Monitor v2 command stub
+
 - [polycli nodekey](doc/polycli_nodekey.md) - Generate node keys for different blockchain clients and protocols.
 
 - [polycli p2p](doc/polycli_p2p.md) - Set of commands related to devp2p.