feat(hardhat): add snapshot system for state persistence

[mpaya5]

What

• Blockchain State Persistence

  • Added snapshot and restore scripts to save/load the complete blockchain state.
  • Snapshots include:
    • Account balances
    • Nonces
    • Block numbers
    • Deployed contracts
  • Dynamically tracks all interacting accounts (predefined + created at runtime).
  • Introduced a background service to auto-snapshot every 5 seconds.
  • Validates snapshot integrity before restoring state (e.g., balances, contracts).
  • Snapshots stored in a shared local volume for portability.

• Hardhat Container Flexibility

  • Made the Hardhat container optional via the COMPOSE_PROFILES env var.
  • Updated Docker configuration and .env handling to support toggling.

• Custom Network Configuration

  • Introduced genlayer_network configuration with custom chainId: 61999.
  • Fixed nonce-related issues during transaction submission.
  • Corrected JSON-RPC calls by removing invalid chainId parameters.
  • Implemented contract encoding and raw transaction submission directly to the node.
  • Updated Dockerfile and Hardhat scripts to use the new network config.
  • Set proper gas limits and block settings to align with expected GenLayer behaviors.

Why

• Enable fast, reproducible dev/testing workflows by snapshotting blockchain state.
• Allow restoring exact environments across reboots or simulations.
• Improve transaction integrity by fixing nonce and chainId issues.
• Provide flexibility to use external nodes or disable Hardhat when needed.

Testing done

• ✅ Verified snapshot creation and restoration (accounts, balances, blocks).
• ✅ Confirmed auto-snapshot writes every 5 seconds as expected.
• ✅ Manually tested deployments and raw transaction flows on custom network.
• ✅ Checked Docker logs for network consistency and no chainId mismatch.
• ✅ Tested COMPOSE_PROFILES variations to include/exclude Hardhat.
• ✅ Confirmed contract bytecode availability and proper gas behavior.

Decisions made

• Default chainId: 61999 ensures compatibility with GenLayer consensus logic.
• Auto-snapshot interval of 5s balances performance and persistence.
• Stored state includes all active accounts, improving reliability during simulation and indexing.

Reviewing tips

• Review the snapshot logic and account tracking for completeness.
• Check the updated Hardhat and network configs (chainId, gas, block limits).
• Confirm Docker service isolation and profile toggling behavior.
• Validate that contract deployment and submission work on both test and persistent networks.

User facing release notes

• New Feature: Blockchain state is now automatically snapshotted every 5 seconds.
• Network Configuration: Added genlayer_network with custom chainId: 61999.
• Improved Flexibility: Optionally disable Hardhat using COMPOSE_PROFILES.
• More Reliable Testing: Contract state, accounts, and blocks now persist across sessions.
• Improved Infrastructure: Accurate gas, nonce, and chainId handling ensures compatibility with GenLayer.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 14.81%. Comparing base (5f6f8bc) to head (015c335).
Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #1031   +/-   ##
=======================================
  Coverage   14.81%   14.81%           
=======================================
  Files         123      123           
  Lines        7364     7364           
  Branches      254      254           
=======================================
  Hits         1091     1091           
  Misses       6194     6194           
  Partials       79       79           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[sonarqubecloud]

Quality Gate failed

Failed conditions
1.2% Coverage on New Code (required ≥ 80%)
4.1% Duplication on New Code (required ≤ 3%)

See analysis details on SonarQube Cloud

[github-actions]

🎉 This PR is included in version 0.47.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀