Wagmi (e604566)

[Dargon789]

Motivation

Solution

PR Checklist

• Added Tests
• Added Documentation
• Breaking changes

Summary by Sourcery

Introduce a new AST-based linting framework with simplified keccak256 gas linting, harden filesystem and npm publishing paths, add Cancun beacon block root handling to execution traces, refine documentation and UX output, and extend CI/CD and example project scaffolding.

New Features:

• Add a generic linter infrastructure with AST-based early lint passes for Solidity, including a keccak256 gas-optimization lint.
• Support processing and storing beacon block roots in the tracing executor and wire it into cast run for Cancun-era blocks.
• Add a minimal example counter Foundry project with script, tests, and CI workflow.

Bug Fixes:

• Harden file copying in script test utilities and benchmark cleanup to avoid symlink traversal and unsafe paths.
• Validate npm tool/platform/arch inputs, package directories, and registry URLs to prevent unsafe paths, insecure schemes, and localhost/loopback registries.
• Fix invariant executor interval checks to use modulo arithmetic compatible with stable Rust and avoid reliance on nightly-only helpers.
• Avoid panics from total_cmp on non-finite values by switching suggestion ranking and contract scoring to safe partial_cmp fallbacks.
• Ensure Vyper compiler settings are cloned correctly when building Etherscan standard JSON inputs.
• Stabilize gas estimation output by always reporting required amount in ETH and adjusting the corresponding JSON payload.

Enhancements:

• Simplify the ASM keccak256 lint to operate directly on AST call expressions and emit diagnostics via the new lint context.
• Improve Solidity doc generation by adjusting function headings, handling @dev comments as italics, filtering enum @variant comments, and refining enum variant tables and inheritdoc merging.
• Add a conversion from Vec<Comment> to Comments to streamline documentation comment handling.
• Relax flake development shell configuration by removing dprint and nix hardening overrides.
• Adjust CLI suggestion sorting to degrade gracefully when similarity comparisons are not totally ordered.

Build:

• Add and duplicate multiple Docker build workflows and a Foundry build-and-test deploy workflow for GitHub Actions.
• Introduce several CircleCI configurations for Rust builds, cargo formatting/tests, and placeholder web3 game workflows.

CI:

• Add CodeQL, Snyk container, and APIsec scanning workflows for security analysis.
• Augment npm publishing workflow with input validation, directory sanity checks, and package.json presence checks.
• Add a CI workflow for the example counter project running Forge fmt, build, and tests.

Deployment:

• Add a Google Cloud GKE build-and-deploy workflow and Docker image publishing workflows targeting Docker Hub.

Documentation:

• Update issue templates for bugs and feature requests and add a README for the counter example project.
• Refine generated Solidity documentation formatting, particularly for function signatures, @dev sections, and enum documentation tables.

Tests:

• Add a new cast CLI test covering beacon block root tracing on Cancun blocks.
• Include Remix Assert and Accounts helper contracts and a Counter Foundry project test suite.

[mergify]

⚠️ The sha of the head commit of this PR conflicts with #412. Mergify cannot evaluate rules on this PR. Once #412 is merged or closed, Mergify will resume processing this PR. ⚠️

[mergify]

⚠️ The sha of the head commit of this PR conflicts with #412. Mergify cannot evaluate rules on this PR. Once #412 is merged or closed, Mergify will resume processing this PR. ⚠️