[ { "path": ".cargo/config.toml", "content": "[alias]\ncheats = \"test -p foundry-cheatcodes-spec --features schema tests::\"\ntest-debugger = \"test -p forge --test cli manual_debug_setup -- --include-ignored --nocapture\"\nbless-lints = \"test -p forge --test ui -- --bless\"\n\n# Increase the stack size to 10MB for Windows targets, which is in line with Linux\n# (whereas default for Windows is 1MB).\n[target.x86_64-pc-windows-msvc]\nrustflags = [\"-Clink-arg=/STACK:10000000\"]\n\n[target.i686-pc-windows-msvc]\nrustflags = [\"-Clink-arg=/STACK:10000000\"]\n" }, { "path": ".config/nextest.toml", "content": "[test-groups]\n\n[profile.default]\nretries = { backoff = \"exponential\", count = 2, delay = \"5s\", jitter = true }\nslow-timeout = { period = \"30s\", terminate-after = 3 }\n# Exclude flaky tests from regular CI runs - they run in nightly test-flaky workflow\ndefault-filter = \"not test(/flaky_/)\"\n\n[[profile.default.overrides]]\nfilter = \"test(/ext_integration/)\"\nslow-timeout = { period = \"5m\", terminate-after = 4 }\n\n# Do not re-run so that `cargo cheats` is ran locally.\n[[profile.default.overrides]]\nfilter = \"package(foundry-cheatcodes-spec)\"\nretries = 0\n\n# Profile for running flaky tests (used by nightly CI and for local debugging)\n# Run with: cargo nextest run --profile flaky\n[profile.flaky]\ndefault-filter = \"test(/flaky_/)\"\nretries = { backoff = \"exponential\", count = 5, delay = \"10s\", jitter = true }\nslow-timeout = { period = \"60s\", terminate-after = 3 }\n" }, { "path": ".devcontainer/Dockerfile.dev", "content": "FROM ubuntu:22.04\n\nARG USERNAME=foundry\nARG USER_UID=1000\nARG USER_GID=$USER_UID\nARG PYTHON_VERSION=3.14\nARG NODE_MAJOR=20\nARG VYPER_VERSION=0.4.3\n\nENV DEBIAN_FRONTEND=noninteractive\nENV CARGO_TERM_COLOR=always \\\n RUST_BACKTRACE=full\n\nWORKDIR /workspace\n\nRUN apt-get update && apt-get install -y --no-install-recommends \\\n # Build tools\n build-essential \\\n clang \\\n lld \\\n pkg-config \\\n # Network/SSL\n curl \\\n ca-certificates \\\n gnupg \\\n libssl-dev \\\n # Version control & utils\n git \\\n sudo \\\n unzip \\\n # Python\n python${PYTHON_VERSION} \\\n python3-pip \\\n python${PYTHON_VERSION}-venv \\\n # Add Node.js repo\n && mkdir -p /etc/apt/keyrings \\\n && curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg \\\n && echo \"deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_${NODE_MAJOR}.x nodistro main\" | tee /etc/apt/sources.list.d/nodesource.list \\\n # Update again after adding repo and install Node.js\n && apt-get update && apt-get install -y --no-install-recommends \\\n nodejs \\\n # Clean up apt cache\n && apt-get clean && rm -rf /var/lib/apt/lists/*\n\n# Ensure python points to the installed python version\nRUN ln -sf /usr/bin/python${PYTHON_VERSION} /usr/bin/python && \\\n ln -sf /usr/bin/python${PYTHON_VERSION} /usr/bin/python3\n\n# Create non-root user with sudo privileges\nRUN groupadd --gid $USER_GID $USERNAME \\\n && useradd --uid $USER_UID --gid $USER_GID -m $USERNAME -s /bin/bash \\\n # Setup sudo without password prompt\n && echo \"$USERNAME ALL=(ALL) NOPASSWD:ALL\" > /etc/sudoers.d/$USERNAME \\\n && chmod 0440 /etc/sudoers.d/$USERNAME \\\n # Add user to the sudo group (standard practice)\n && usermod -aG sudo $USERNAME\n\n# Switch to the non-root user\nUSER $USERNAME\nWORKDIR /home/$USERNAME\n\n# --- User-specific installations ---\n\n# Install Bun\nENV BUN_INSTALL=\"/home/$USERNAME/.bun\"\nENV PATH=\"$BUN_INSTALL/bin:$PATH\"\nRUN curl -fsSL https://bun.sh/install | bash\n\n# Install Rust & cargo-nextest\nENV CARGO_HOME=\"/home/$USERNAME/.cargo\"\nENV RUSTUP_HOME=\"/home/$USERNAME/.rustup\"\nENV PATH=\"$CARGO_HOME/bin:$PATH\"\nRUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y \\\n && cargo install cargo-nextest --locked\n\n# Install Vyper using pip\n# Ensure pip user install directory is in PATH\nENV PYTHONUSERBASE=\"/home/$USERNAME/.local\"\nENV PATH=\"$PYTHONUSERBASE/bin:$PATH\"\nRUN pip3 install --user vyper==${VYPER_VERSION}\n\n# Switch back to the main workspace directory\nWORKDIR /workspace\n\n" }, { "path": ".devcontainer/devcontainer.json", "content": "// For format details, see https://aka.ms/devcontainer.json.\n{\n \"name\": \"Foundry Development\",\n \"build\": {\n \"context\": \"..\",\n \"dockerfile\": \"Dockerfile.dev\"\n },\n\n \"features\": {\n \"ghcr.io/devcontainers/features/common-utils:2\": {\n \"installZsh\": true,\n \"configureZshAsDefaultShell\": true,\n \"installOhMyZsh\": true,\n \"upgradePackages\": true\n }\n },\n\n \"forwardPorts\": [],\n\n \"postCreateCommand\": \"rustup default stable && rustup update\",\n\n \"customizations\": {\n \"vscode\": {\n \"extensions\": [\n \"rust-lang.rust-analyzer\",\n \"serayuzgur.crates\",\n \"tamasfe.even-better-toml\",\n \"ms-python.python\",\n \"dbaeumer.vscode-eslint\",\n \"oven.bun-vscode\"\n ],\n \"settings\": {\n \"rust-analyzer.checkOnSave\": true,\n \"rust-analyzer.cargo.features\": \"all\"\n }\n }\n },\n\n \"remoteUser\": \"foundry\",\n\n \"workspaceMount\": \"source=${localWorkspaceFolder},target=/workspace,type=bind,consistency=cached\",\n\n \"workspaceFolder\": \"/workspace\",\n\n \"mounts\": [\n \"source=${localEnv:HOME}/.cargo/registry,target=/home/foundry/.cargo/registry,type=bind,consistency=cached\",\n \"source=${localEnv:HOME}/.cargo/git,target=/home/foundry/.cargo/git,type=bind,consistency=cached\"\n ]\n}\n" }, { "path": ".dockerignore", "content": "target\n.github\n" }, { "path": ".git-blame-ignore-revs", "content": "# Since version 2.23 (released in August 2019), git-blame has a feature\n# to ignore or bypass certain commits.\n#\n# This file contains a list of commits that are not likely what you\n# are looking for in a blame, such as mass reformatting or renaming.\n# You can set this file as a default ignore file for blame by running\n# the following command.\n#\n# $ git config blame.ignoreRevsFile .git-blame-ignore-revs\n\n# fmt: all (#3398)\n860d083183b51a6f8d865408ef1a44aa694d6862\n\n# chore: bump to rust edition 2024 (#10802)\n710a1584aae8e0f8ca8d5ba552632dc72381091e\n" }, { "path": ".gitattributes", "content": "crates/cheatcodes/assets/*.json linguist-generated\ntestdata/cheats/Vm.sol linguist-generated\nbun.lock linguist-generated\n\n# See \n*.rs diff=rust\ncrates/lint/testdata/* text eol=lf\ntestdata/fixtures/**/* eol=lf\n\ndprint.json linguist-language=JSON-with-Comments\n.devcontainer/devcontainer.json linguist-language=JSON-with-Comments\n\n.env.example linguist-language=Dotenv" }, { "path": ".github/CODEOWNERS", "content": "* @danipopes @mattsse @grandizzy @yash-atreya @zerosnacks @onbjerg @0xrusowsky\n" }, { "path": ".github/FLAKY_TEST_FAILURE_TEMPLATE.md", "content": "---\ntitle: \"bug: flaky tests workflow failed\"\nlabels: P-normal, T-bug\n---\n\nThe nightly flaky tests workflow has failed. This indicates external API rate limiting, RPC reliability issues, or other intermittent failures that may affect users.\n\nCheck the [flaky tests workflow page]({{ env.WORKFLOW_URL }}) for details.\n\nThis issue was raised by the workflow at `.github/workflows/test-flaky.yml`.\n" }, { "path": ".github/FLAKY_TEST_ISOLATE_FAILURE_TEMPLATE.md", "content": "---\ntitle: \"bug: flaky tests workflow failed (isolate)\"\nlabels: P-normal, T-bug\n---\n\nThe nightly flaky tests workflow (with isolation mode enabled) has failed. This indicates external API rate limiting, RPC reliability issues, or other intermittent failures that may affect users.\n\nCheck the [flaky tests workflow page]({{ env.WORKFLOW_URL }}) for details.\n\nThis issue was raised by the workflow at `.github/workflows/test-isolate.yml`.\n" }, { "path": ".github/INTEGRATION_FAILURE.md", "content": "---\ntitle: \"bug: long-running integration tests failed\"\nlabels: P-high, T-bug\n---\n\nThe heavy (long-running) integration tests have failed. This indicates a regression in Foundry.\n\nCheck the [heavy integration tests workflow page]({{ env.WORKFLOW_URL }}) for details.\n\nThis issue was raised by the workflow at `.github/workflows/heavy-integration.yml`.\n" }, { "path": ".github/ISSUE_TEMPLATE/BUG-FORM.yml", "content": "name: Bug report\ndescription: File a bug report\ntype: Bug\nlabels: [\"T-bug\", \"T-needs-triage\"]\nbody:\n - type: markdown\n attributes:\n value: |\n Please ensure that the bug has not already been filed in the issue tracker.\n\n Thanks for taking the time to report this bug!\n - type: dropdown\n id: component\n attributes:\n label: Component\n description: What component is the bug in?\n multiple: true\n options:\n - Forge\n - Cast\n - Anvil\n - Foundryup\n - Chisel\n - Other (please describe)\n validations:\n required: true\n - type: checkboxes\n attributes:\n label: Have you ensured that all of these are up to date?\n options:\n - label: Foundry\n - label: Foundryup\n - type: input\n attributes:\n label: What version of Foundry are you on?\n placeholder: \"Run forge --version and paste the output here\"\n - type: input\n attributes:\n label: What version of Foundryup are you on?\n placeholder: \"Run foundryup --version and paste the output here\"\n - type: input\n attributes:\n label: What command(s) is the bug in?\n description: Leave empty if not relevant\n placeholder: \"For example: forge test\"\n - type: dropdown\n attributes:\n label: Operating System\n description: What operating system are you on?\n options:\n - Windows\n - macOS (Intel)\n - macOS (Apple Silicon)\n - Linux\n - type: textarea\n id: description\n attributes:\n label: Describe the bug\n description: Please include relevant Solidity snippets as well if relevant.\n validations:\n required: true\n" }, { "path": ".github/ISSUE_TEMPLATE/FEATURE-FORM.yml", "content": "name: Feature request\ndescription: Suggest a feature\ntype: Feature\nlabels: [\"T-feature\", \"T-needs-triage\"]\nbody:\n - type: markdown\n attributes:\n value: |\n Please ensure that the feature has not already been requested in the issue tracker.\n\n Thanks for helping us improve Foundry!\n - type: dropdown\n id: component\n attributes:\n label: Component\n description: What component is the feature for?\n multiple: true\n options:\n - Forge\n - Cast\n - Anvil\n - Foundryup\n - Chisel\n - Other (please describe)\n validations:\n required: true\n - type: textarea\n id: description\n attributes:\n label: Describe the feature you would like\n description: Please also describe what the feature is aiming to solve, if relevant.\n validations:\n required: true\n - type: textarea\n attributes:\n label: Additional context\n description: Add any other context to the feature (like screenshots, resources)\n" }, { "path": ".github/ISSUE_TEMPLATE/config.yml", "content": "blank_issues_enabled: true\ncontact_links:\n - name: Support\n url: https://t.me/foundry_support\n about: This issue tracker is only for bugs and feature requests. Support is available on Telegram!\n" }, { "path": ".github/PULL_REQUEST_TEMPLATE.md", "content": "\n\n\n\n## Motivation\n\n\n\n## Solution\n\n\n\n## PR Checklist\n\n- [ ] Added Tests\n- [ ] Added Documentation\n- [ ] Breaking changes\n" }, { "path": ".github/RELEASE_FAILURE_ISSUE_TEMPLATE.md", "content": "---\ntitle: \"bug: release workflow failed\"\nlabels: P-high, T-bug\n---\n\nThe release workflow has failed. Some or all binaries might have not been published correctly.\n\nCheck the [release workflow page]({{ env.WORKFLOW_URL }}) for details.\n\nThis issue was raised by the workflow at `.github/workflows/release.yml`.\n" }, { "path": ".github/TEST_ISOLATE_FAILURE_TEMPLATE.md", "content": "---\ntitle: \"bug: test-isolate workflow failed\"\nlabels: P-high, T-bug\n---\n\nThe daily test-isolate workflow (tests with isolation mode enabled) has failed. This indicates a regression in Foundry's test isolation behavior.\n\nCheck the [test-isolate workflow page]({{ env.WORKFLOW_URL }}) for details.\n\nThis issue was raised by the workflow at `.github/workflows/test-isolate.yml`.\n" }, { "path": ".github/changelog.json", "content": "{\n \"categories\": [\n {\n \"title\": \"## Breaking changes\",\n \"labels\": [\"T-likely-breaking \"]\n },\n {\n \"title\": \"## Anvil Features\",\n \"labels\": [\"C-anvil\", \"T-feature\"],\n \"exhaustive\": true,\n \"exhaustive_rules\": false\n },\n {\n \"title\": \"## Anvil Fixes\",\n \"labels\": [\"C-anvil\", \"T-bug\"],\n \"exhaustive\": true,\n \"exhaustive_rules\": false\n },\n {\n \"title\": \"## Cast Features\",\n \"labels\": [\"C-cast\", \"T-feature\"],\n \"exhaustive\": true,\n \"exhaustive_rules\": false\n },\n {\n \"title\": \"## Cast Fixes\",\n \"labels\": [\"C-cast\", \"T-bug\"],\n \"exhaustive\": true,\n \"exhaustive_rules\": false\n },\n {\n \"title\": \"## Chisel Features\",\n \"labels\": [\"C-chisel\", \"T-feature\"],\n \"exhaustive\": true,\n \"exhaustive_rules\": false\n },\n {\n \"title\": \"## Chisel Fixes\",\n \"labels\": [\"C-chisel\", \"T-bug\"],\n \"exhaustive\": true,\n \"exhaustive_rules\": false\n },\n {\n \"title\": \"## Forge Features\",\n \"labels\": [\"C-forge\", \"T-feature\"],\n \"exhaustive\": true,\n \"exhaustive_rules\": false\n },\n {\n \"title\": \"## Forge Fixes\",\n \"labels\": [\"C-forge\", \"T-bug\"],\n \"exhaustive\": true,\n \"exhaustive_rules\": false\n },\n {\n \"title\": \"## Performance improvements\",\n \"labels\": [\"T-perf\"]\n }\n ],\n \"ignore_labels\": [\"L-ignore\"],\n \"template\": \"${{CHANGELOG}}\\n## Other\\n\\n${{UNCATEGORIZED}}\\n## Full Changelog:\\n ${{RELEASE_DIFF}}\",\n \"pr_template\": \"- ${{TITLE}} (#${{NUMBER}}) by @${{AUTHOR}}\",\n \"empty_template\": \"- No changes\",\n \"max_pull_requests\": 500,\n \"max_back_track_time_days\": 120\n}\n" }, { "path": ".github/dependabot.yml", "content": "version: 2\nupdates:\n - package-ecosystem: \"github-actions\"\n directory: \"/\"\n schedule:\n interval: \"weekly\"\n ignore:\n - dependency-name: \"softprops/action-gh-release\"\n" }, { "path": ".github/scripts/combine-benchmarks.sh", "content": "#!/bin/bash\nset -euo pipefail\n\n# Script to combine individual benchmark results into LATEST.md\n# Usage: ./combine-benchmarks.sh \n\nOUTPUT_DIR=\"${1:-benches}\"\n\n# Create output directory if it doesn't exist\nmkdir -p \"$OUTPUT_DIR\"\n\n# Define the benchmark files and their section names\ndeclare -A BENCHMARK_FILES=(\n [\"forge_test_bench.md\"]=\"Forge Test\"\n [\"forge_isolate_test_bench.md\"]=\"Forge Test (Isolated)\"\n [\"forge_build_bench.md\"]=\"Forge Build\"\n [\"forge_coverage_bench.md\"]=\"Forge Coverage\"\n)\n\n# Function to extract a specific section from a benchmark file\nextract_section() {\n local file=$1\n local section=$2\n local in_section=0\n\n while IFS= read -r line; do\n if [[ \"$line\" =~ ^##[[:space:]]+\"$section\" ]]; then\n in_section=1\n echo \"$line\"\n elif [[ $in_section -eq 1 && \"$line\" =~ ^##[[:space:]] && ! \"$line\" =~ ^##[[:space:]]+\"$section\" ]]; then\n break\n elif [[ $in_section -eq 1 ]]; then\n echo \"$line\"\n fi\n done < \"$file\"\n}\n\n# Function to extract summary info (repos and versions) from a file\nextract_summary_info() {\n local file=$1\n local in_summary=0\n local in_repos=0\n local in_versions=0\n\n while IFS= read -r line; do\n # Check for Summary section\n if [[ \"$line\" =~ ^##[[:space:]]+Summary ]]; then\n in_summary=1\n continue\n fi\n\n # Check for Repositories Tested subsection\n if [[ $in_summary -eq 1 && \"$line\" =~ ^###[[:space:]]+Repositories[[:space:]]+Tested ]]; then\n in_repos=1\n echo \"### Repositories Tested\"\n echo\n continue\n fi\n\n # Check for Foundry Versions subsection\n if [[ $in_summary -eq 1 && \"$line\" =~ ^###[[:space:]]+Foundry[[:space:]]+Versions ]]; then\n in_repos=0\n in_versions=1\n echo \"### Foundry Versions\"\n echo\n continue\n fi\n\n # End of summary section\n if [[ $in_summary -eq 1 && \"$line\" =~ ^##[[:space:]] && ! \"$line\" =~ ^##[[:space:]]+Summary ]]; then\n break\n fi\n\n # Output repo or version lines\n if [[ ($in_repos -eq 1 || $in_versions -eq 1) && -n \"$line\" ]]; then\n echo \"$line\"\n fi\n done < \"$file\"\n}\n\n# Function to extract benchmark table from a section\nextract_benchmark_table() {\n local file=$1\n local section=$2\n local in_section=0\n local found_table=0\n\n while IFS= read -r line; do\n if [[ \"$line\" =~ ^##[[:space:]]+\"$section\" ]]; then\n in_section=1\n continue\n elif [[ $in_section -eq 1 && \"$line\" =~ ^##[[:space:]] && ! \"$line\" =~ ^##[[:space:]]+\"$section\" ]]; then\n break\n elif [[ $in_section -eq 1 ]]; then\n # Skip empty lines before table\n if [[ -z \"$line\" && $found_table -eq 0 ]]; then\n continue\n fi\n # Detect table start\n if [[ \"$line\" =~ ^\\|[[:space:]]*Repository ]]; then\n found_table=1\n fi\n # Output table lines\n if [[ $found_table -eq 1 && -n \"$line\" ]]; then\n echo \"$line\"\n fi\n fi\n done < \"$file\"\n}\n\n# Function to extract system information\nextract_system_info() {\n local file=$1\n awk '/^## System Information/ { found=1; next } found { print }' \"$file\"\n}\n\n# Start building LATEST.md\ncat > \"$OUTPUT_DIR/LATEST.md\" << EOF\n# šŸ“Š Foundry Benchmark Results\n\n**Generated at**: $(date -u '+%Y-%m-%d %H:%M:%S UTC')\n\nEOF\n\n# Process each benchmark file\nFIRST_FILE=1\nSYSTEM_INFO=\"\"\n\nfor bench_file in \"forge_test_bench.md\" \"forge_isolate_test_bench.md\" \"forge_build_bench.md\" \"forge_coverage_bench.md\"; do\n if [ -f \"$OUTPUT_DIR/$bench_file\" ]; then\n echo \"Processing $bench_file...\"\n\n SECTION_NAME=\"${BENCHMARK_FILES[$bench_file]:-$bench_file}\"\n\n # Grouped output for ShellCheck SC2129\n {\n # Add section header\n echo \"## $SECTION_NAME\"\n echo\n\n # Add summary info\n extract_summary_info \"$OUTPUT_DIR/$bench_file\"\n echo\n\n # Handle benchmark tables\n if [[ \"$bench_file\" == \"forge_test_bench.md\" ]]; then\n extract_benchmark_table \"$OUTPUT_DIR/$bench_file\" \"Forge Test\"\n echo\n if grep -q \"^## Forge Fuzz Test\" \"$OUTPUT_DIR/$bench_file\"; then\n echo \"## Forge Fuzz Test\"\n echo\n extract_benchmark_table \"$OUTPUT_DIR/$bench_file\" \"Forge Fuzz Test\"\n fi\n elif [[ \"$bench_file\" == \"forge_build_bench.md\" ]]; then\n echo \"### No Cache\"\n echo\n extract_benchmark_table \"$OUTPUT_DIR/$bench_file\" \"Forge Build (No Cache)\"\n echo\n echo \"### With Cache\"\n echo\n extract_benchmark_table \"$OUTPUT_DIR/$bench_file\" \"Forge Build (With Cache)\"\n else\n extract_benchmark_table \"$OUTPUT_DIR/$bench_file\" \"$SECTION_NAME\"\n fi\n echo\n } >> \"$OUTPUT_DIR/LATEST.md\"\n\n # Extract system info from first file only\n if [[ $FIRST_FILE -eq 1 ]]; then\n SYSTEM_INFO=$(extract_system_info \"$OUTPUT_DIR/$bench_file\")\n FIRST_FILE=0\n fi\n else\n echo \"Warning: $bench_file not found, skipping...\"\n fi\ndone\n\n# Add system information at the end\nif [[ -n \"$SYSTEM_INFO\" ]]; then\n {\n echo \"## System Information\"\n echo\n echo \"$SYSTEM_INFO\"\n } >> \"$OUTPUT_DIR/LATEST.md\"\nfi\n\necho \"Successfully combined benchmark results into $OUTPUT_DIR/LATEST.md\"\n" }, { "path": ".github/scripts/commit-and-read-benchmarks.sh", "content": "#!/bin/bash\nset -euo pipefail\n\n# Script to commit benchmark results and read them for GitHub Actions output\n# Usage: ./commit-and-read-benchmarks.sh \n\nOUTPUT_DIR=\"${1:-benches}\"\nGITHUB_EVENT_NAME=\"${2:-pull_request}\"\nGITHUB_REPOSITORY=\"${3:-}\"\n\n# Global variable for branch name\nBRANCH_NAME=\"\"\n\n# Function to commit benchmark results\ncommit_results() {\n echo \"Configuring git...\"\n git config --local user.email \"action@github.com\"\n git config --local user.name \"GitHub Action\"\n\n # For PR runs, fetch and checkout the PR branch to ensure we're up to date\n if [ \"$GITHUB_EVENT_NAME\" = \"pull_request\" ] && [ -n \"${GITHUB_HEAD_REF:-}\" ]; then\n echo \"Fetching latest changes for PR branch: $GITHUB_HEAD_REF\"\n git fetch origin \"$GITHUB_HEAD_REF\"\n git checkout -B \"$GITHUB_HEAD_REF\" \"origin/$GITHUB_HEAD_REF\"\n fi\n\n echo \"Adding benchmark file...\"\n git add \"$OUTPUT_DIR/LATEST.md\"\n\n if git diff --staged --quiet; then\n echo \"No changes to commit\"\n else\n echo \"Committing benchmark results...\"\n git commit -m \"chore(\\`benches\\`): update benchmark results\n\nšŸ¤– Generated with [Foundry Benchmarks](https://github.com/${GITHUB_REPOSITORY}/actions)\n\nCo-Authored-By: github-actions \"\n \n echo \"Pushing to repository...\"\n if [ \"$GITHUB_EVENT_NAME\" = \"workflow_dispatch\" ]; then\n # For manual runs, we're on a new branch\n git push origin \"$BRANCH_NAME\"\n elif [ \"$GITHUB_EVENT_NAME\" = \"pull_request\" ]; then\n # For PR runs, push to the PR branch\n if [ -n \"${GITHUB_HEAD_REF:-}\" ]; then\n echo \"Pushing to PR branch: $GITHUB_HEAD_REF\"\n git push origin \"$GITHUB_HEAD_REF\"\n else\n echo \"Error: GITHUB_HEAD_REF not set for pull_request event\"\n exit 1\n fi\n else\n # This workflow should only run on workflow_dispatch or pull_request\n echo \"Error: Unexpected event type: $GITHUB_EVENT_NAME\"\n echo \"This workflow only supports 'workflow_dispatch' and 'pull_request' events\"\n exit 1\n fi\n echo \"Successfully pushed benchmark results\"\n fi\n}\n\n# Function to read benchmark results and output for GitHub Actions\nread_results() {\n if [ -f \"$OUTPUT_DIR/LATEST.md\" ]; then\n echo \"Reading benchmark results...\"\n \n # Output full results\n {\n echo 'results<> \"$GITHUB_OUTPUT\"\n \n # Format results for PR comment\n echo \"Formatting results for PR comment...\"\n FORMATTED_COMMENT=$(\"$(dirname \"$0\")/format-pr-comment.sh\" \"$OUTPUT_DIR/LATEST.md\")\n \n {\n echo 'pr_comment<> \"$GITHUB_OUTPUT\"\n \n echo \"Successfully read and formatted benchmark results\"\n else\n echo 'results=No benchmark results found.' >> \"$GITHUB_OUTPUT\"\n echo 'pr_comment=No benchmark results found.' >> \"$GITHUB_OUTPUT\"\n echo \"Warning: No benchmark results found at $OUTPUT_DIR/LATEST.md\"\n fi\n}\n\n# Main execution\necho \"Starting benchmark results processing...\"\n\n# Create new branch for manual runs\nif [ \"$GITHUB_EVENT_NAME\" = \"workflow_dispatch\" ]; then\n echo \"Manual workflow run detected, creating new branch...\"\n BRANCH_NAME=\"benchmarks/results-$(date +%Y%m%d-%H%M%S)\"\n git checkout -b \"$BRANCH_NAME\"\n echo \"Created branch: $BRANCH_NAME\"\n \n # Output branch name for later use\n echo \"branch_name=$BRANCH_NAME\" >> \"$GITHUB_OUTPUT\"\nfi\n\n# Always commit benchmark results\necho \"Committing benchmark results...\"\ncommit_results\n\n# Always read results for output\nread_results\n\necho \"Benchmark results processing complete\"" }, { "path": ".github/scripts/create-tag.js", "content": "module.exports = async ({ github, context }, tagName) => {\n try {\n await github.rest.git.createRef({\n owner: context.repo.owner,\n repo: context.repo.repo,\n ref: `refs/tags/${tagName}`,\n sha: context.sha,\n force: true,\n });\n } catch (err) {\n console.error(`Failed to create tag: ${tagName}`);\n console.error(err);\n }\n};\n" }, { "path": ".github/scripts/format-pr-comment.sh", "content": "#!/bin/bash\nset -euo pipefail\n\n# Script to format benchmark results for PR comment\n# Usage: ./format-pr-comment.sh \n\nRESULTS_FILE=\"${1:-}\"\n\nif [ -z \"$RESULTS_FILE\" ] || [ ! -f \"$RESULTS_FILE\" ]; then\n echo \"Error: Benchmark results file not provided or does not exist\"\n exit 1\nfi\n\n# Read the file content\nCONTENT=$(cat \"$RESULTS_FILE\")\n\n# Find where \"## Forge Build\" starts and split the content\n# Extract everything before \"## Forge Build\"\nBEFORE_FORGE_BUILD=$(echo \"$CONTENT\" | awk '/^## Forge Build$/ {exit} {print}')\n\n# Extract everything from \"## Forge Build\" onwards\nFROM_FORGE_BUILD=$(echo \"$CONTENT\" | awk '/^## Forge Build$/ {found=1} found {print}')\n\n# Output the formatted comment with dropdown\ncat << EOF\n${BEFORE_FORGE_BUILD}\n\n
\nšŸ“ˆ View all benchmark results\n\n${FROM_FORGE_BUILD}\n\n
\nEOF" }, { "path": ".github/scripts/format.sh", "content": "#!/usr/bin/env bash\nset -eo pipefail\n\n# We have to ignore at shell level because testdata/ is not a valid Foundry project,\n# so running `forge fmt` with `--root testdata` won't actually check anything\nsol_files=()\nwhile IFS= read -r -d '' file; do\n sol_files+=(\"$file\")\ndone < <(find testdata -name '*.sol' ! -name Vm.sol ! -name console.sol -print0)\n\n# Run forge fmt on all found files\ncargo run --bin forge -- fmt \"$@\" \"${sol_files[@]}\"\n" }, { "path": ".github/scripts/matrices.py", "content": "#!/usr/bin/env python3\n\nimport json\nimport os\n\n\n# A runner target\nclass Target:\n # GHA runner\n runner_label: str\n # Rust target triple\n target: str\n # SVM Solc target\n svm_target_platform: str\n\n def __init__(self, runner_label: str, target: str, svm_target_platform: str):\n self.runner_label = runner_label\n self.target = target\n self.svm_target_platform = svm_target_platform\n\n\n# A single test suite to run.\nclass Case:\n # Name of the test suite.\n name: str\n # Nextest filter expression.\n filter: str\n # Number of partitions to split the test suite into.\n n_partitions: int\n # Whether to run on non-Linux platforms for PRs. All platforms and tests are run on pushes.\n pr_cross_platform: bool\n\n def __init__(\n self, name: str, filter: str, n_partitions: int, pr_cross_platform: bool\n ):\n self.name = name\n self.filter = filter\n self.n_partitions = n_partitions\n self.pr_cross_platform = pr_cross_platform\n\n\n# GHA matrix entry\nclass Expanded:\n name: str\n runner_label: str\n target: str\n svm_target_platform: str\n flags: str\n partition: int\n\n def __init__(\n self,\n name: str,\n runner_label: str,\n target: str,\n svm_target_platform: str,\n flags: str,\n partition: int,\n ):\n self.name = name\n self.runner_label = runner_label\n self.target = target\n self.svm_target_platform = svm_target_platform\n self.flags = flags\n self.partition = partition\n\n\nprofile = os.environ.get(\"PROFILE\")\nis_pr = os.environ.get(\"EVENT_NAME\") == \"pull_request\"\nt_linux_x86 = Target(\n \"depot-ubuntu-latest-16\", \"x86_64-unknown-linux-gnu\", \"linux-amd64\"\n)\nt_linux_arm = Target(\n \"depot-ubuntu-latest-arm-16\", \"aarch64-unknown-linux-gnu\", \"linux-aarch64\"\n)\nt_macos = Target(\"depot-macos-latest\", \"aarch64-apple-darwin\", \"macosx-aarch64\")\nt_windows = Target(\"depot-windows-latest-16\", \"x86_64-pc-windows-msvc\", \"windows-amd64\")\ntargets = [t_linux_x86] if is_pr else [t_linux_x86, t_linux_arm, t_macos, t_windows]\n\nconfig = [\n Case(\n name=\"all\",\n filter=\"!test(/\\\\bext_integration/)\",\n n_partitions=1,\n pr_cross_platform=True,\n ),\n Case(\n name=\"external\",\n filter=\"package(=forge) & test(/\\\\bext_integration/)\",\n n_partitions=1,\n pr_cross_platform=False,\n ),\n]\n\n\ndef main():\n expanded = []\n for target in targets:\n for case in config:\n if is_pr and (not case.pr_cross_platform and target != t_linux_x86):\n continue\n\n for partition in range(1, case.n_partitions + 1):\n os_str = \"\"\n if len(targets) > 1:\n os_str = f\" ({target.target})\"\n\n name = case.name\n flags = f\"-E '{case.filter}'\"\n if case.n_partitions > 1:\n s = f\"{partition}/{case.n_partitions}\"\n name += f\" ({s})\"\n flags += f\" --partition count:{s}\"\n\n if profile == \"isolate\":\n flags += \" --features=isolate-by-default\"\n name += os_str\n\n flags += \" --no-fail-fast\"\n\n obj = Expanded(\n name=name,\n runner_label=target.runner_label,\n target=target.target,\n svm_target_platform=target.svm_target_platform,\n flags=flags,\n partition=partition,\n )\n expanded.append(vars(obj))\n\n print_json({\"include\": expanded})\n\n\ndef print_json(obj):\n print(json.dumps(obj), end=\"\", flush=True)\n\n\nif __name__ == \"__main__\":\n main()\n" }, { "path": ".github/scripts/move-tag.js", "content": "module.exports = async ({ github, context }, tagName) => {\n try {\n await github.rest.git.updateRef({\n owner: context.repo.owner,\n repo: context.repo.repo,\n ref: `tags/${tagName}`,\n sha: context.sha,\n force: true,\n });\n } catch (err) {\n console.error(`Failed to move nightly tag.`);\n console.error(`This should only happen the first time.`);\n console.error(err);\n }\n};\n" }, { "path": ".github/scripts/prune-prereleases.js", "content": "// In case node 21 is not used.\nfunction groupBy(array, keyOrIterator) {\n var iterator;\n\n // use the function passed in, or create one\n if(typeof keyOrIterator !== 'function') {\n const key = String(keyOrIterator);\n iterator = function (item) { return item[key]; };\n } else {\n iterator = keyOrIterator;\n }\n\n return array.reduce(function (memo, item) {\n const key = iterator(item);\n memo[key] = memo[key] || [];\n memo[key].push(item);\n return memo;\n }, {});\n}\n\nmodule.exports = async ({ github, context }) => {\n console.log(\"Pruning old prereleases\");\n\n // doc: https://docs.github.com/en/rest/releases/releases\n const { data: releases } = await github.rest.repos.listReleases({\n owner: context.repo.owner,\n repo: context.repo.repo,\n });\n\n let nightlies = releases.filter(\n release =>\n // Only consider releases tagged `nightly-${SHA}` for deletion\n release.tag_name.includes(\"nightly\") &&\n release.tag_name !== \"nightly\"\n );\n\n // Pruning rules:\n // 1. only keep the earliest (by created_at) release of the month\n // 2. to keep the newest 30 nightlies (to make sure nightlies are kept until the next monthly release)\n // Notes:\n // - This addresses https://github.com/foundry-rs/foundry/issues/6732\n // - Name of the release may deviate from created_at due to the usage of different timezones.\n\n // Group releases by months.\n // Per doc:\n // > The latest release is the most recent non-prerelease, non-draft release, sorted by the created_at attribute.\n const groups = groupBy(nightlies, i => i.created_at.slice(0, 7));\n const nightliesToPrune = Object.values(groups)\n .reduce((acc, cur) => acc.concat(cur.slice(0, -1)), []) // rule 1\n .slice(30); // rule 2\n\n for (const nightly of nightliesToPrune) {\n console.log(`Deleting nightly: ${nightly.tag_name}`);\n await github.rest.repos.deleteRelease({\n owner: context.repo.owner,\n repo: context.repo.repo,\n release_id: nightly.id,\n });\n console.log(`Deleting nightly tag: ${nightly.tag_name}`);\n await github.rest.git.deleteRef({\n owner: context.repo.owner,\n repo: context.repo.repo,\n ref: `tags/${nightly.tag_name}`,\n });\n }\n\n console.log(\"Done.\");\n};\n" }, { "path": ".github/scripts/setup-foundryup.sh", "content": "#!/bin/bash\nset -euo pipefail\n\n# Script to setup foundryup in CI environment\n# This ensures foundryup is available in PATH for the benchmark binary\n\necho \"Setting up foundryup...\"\n\n# Check if foundryup script exists in the repo\nif [ ! -f \"foundryup/foundryup\" ]; then\n echo \"Error: foundryup/foundryup script not found in repository\"\n exit 1\nfi\n\n# Copy foundryup to a location in PATH\necho \"Copying foundryup to /usr/local/bin...\"\nsudo cp foundryup/foundryup /usr/local/bin/foundryup\nsudo chmod +x /usr/local/bin/foundryup\n\n# Verify foundryup is accessible\nif ! command -v foundryup &> /dev/null; then\n echo \"Error: foundryup not found in PATH after installation\"\n exit 1\nfi\n\necho \"foundryup is now available at: $(which foundryup)\"\n\n# Create foundry directories\necho \"Creating foundry directories...\"\n\n# Use FOUNDRY_DIR if set, otherwise default to $HOME/.foundry\nFOUNDRY_DIR=\"${FOUNDRY_DIR:-$HOME/.foundry}\"\necho \"Using FOUNDRY_DIR: $FOUNDRY_DIR\"\n\n# Create all necessary directories\nmkdir -p \"$FOUNDRY_DIR/bin\"\nmkdir -p \"$FOUNDRY_DIR/versions\"\nmkdir -p \"$FOUNDRY_DIR/share/man/man1\"\n\n# Export PATH for current session\nexport PATH=\"$FOUNDRY_DIR/bin:$PATH\"\n\n# Run foundryup to install default version\necho \"Installing default foundry version...\"\nfoundryup\n\n# Verify installation\nif command -v forge &> /dev/null; then\n echo \"Forge installed successfully: $(forge --version)\"\nelse\n echo \"Warning: forge not found in PATH after installation\"\nfi\n\necho \"Foundry setup complete!\"" }, { "path": ".github/scripts/shellcheck.sh", "content": "#!/usr/bin/env bash\n\n# runs shellcheck and prints GitHub Actions annotations for each warning and error\n# https://github.com/koalaman/shellcheck\n\nIGNORE_DIRS=(\n \"./.git/*\"\n \"./target/*\"\n)\n\nignore_args=()\nfor dir in \"${IGNORE_DIRS[@]}\"; do\n ignore_args+=(-not -path \"$dir\")\ndone\n\nfind . -name \"*.sh\" \"${ignore_args[@]}\" -exec shellcheck -f gcc {} + | \\\n while IFS=: read -r file line col severity msg; do\n level=\"warning\"\n [[ \"$severity\" == *error* ]] && level=\"error\"\n file=\"${file#./}\"\n echo \"::${level} file=${file},line=${line},col=${col}::${file}:${line}:${col}:${msg}\"\n done\n\nexit \"${PIPESTATUS[0]}\"\n" }, { "path": ".github/workflows/benchmarks.yml", "content": "name: Foundry Benchmarks\n\npermissions: {}\n\non:\n workflow_dispatch:\n inputs:\n pr_number:\n description: \"PR number to comment on (optional)\"\n required: false\n type: string\n versions:\n description: \"Comma-separated list of Foundry versions to benchmark (e.g., stable,nightly,v1.0.0)\"\n required: false\n type: string\n default: \"stable,nightly\"\n repos:\n description: \"Comma-separated list of repos to benchmark (e.g., ithacaxyz/account:main,Vectorized/solady)\"\n required: false\n type: string\n default: \"ithacaxyz/account:v0.3.2,Vectorized/solady:v0.1.22\"\n\nenv:\n ITHACAXYZ_ACCOUNT: \"ithacaxyz/account:v0.3.2\"\n VECTORIZED_SOLADY: \"Vectorized/solady:v0.1.22\"\n DEFAULT_REPOS: \"ithacaxyz/account:v0.3.2,Vectorized/solady:v0.1.22\"\n RUSTC_WRAPPER: \"sccache\"\n\njobs:\n run-benchmarks:\n name: Run All Benchmarks\n runs-on: depot-ubuntu-24.04-32\n permissions:\n contents: write\n steps:\n - name: Checkout repository\n uses: actions/checkout@v6\n with:\n persist-credentials: false\n\n - name: Install build dependencies\n run: |\n sudo apt-get update\n sudo apt-get install -y build-essential pkg-config\n\n - name: Setup Rust toolchain\n uses: dtolnay/rust-toolchain@e97e2d8cc328f1b50210efc529dca0028893a2d9 # master\n with:\n toolchain: stable\n\n - uses: rui314/setup-mold@725a8794d15fc7563f59595bd9556495c0564878 # v1\n\n - uses: mozilla-actions/sccache-action@7d986dd989559c6ecdb630a3fd2557667be217ad # v0.0.9\n\n - name: Setup Foundry\n env:\n FOUNDRY_DIR: ${{ github.workspace }}/.foundry\n GITHUB_WORKSPACE: ${{ github.workspace }}\n run: |\n ./.github/scripts/setup-foundryup.sh\n printf '%s\\n' \"$GITHUB_WORKSPACE/.foundry/bin\" >> \"$GITHUB_PATH\"\n\n - name: Build benchmark binary\n run: cargo build --release --bin foundry-bench\n\n - name: Setup Node.js\n uses: actions/setup-node@v6\n with:\n node-version: \"24\"\n\n - name: Install hyperfine\n run: |\n curl -L https://github.com/sharkdp/hyperfine/releases/download/v1.19.0/hyperfine-v1.19.0-x86_64-unknown-linux-gnu.tar.gz | tar xz\n sudo mv hyperfine-v1.19.0-x86_64-unknown-linux-gnu/hyperfine /usr/local/bin/\n rm -rf hyperfine-v1.19.0-x86_64-unknown-linux-gnu\n\n - name: Run forge test benchmarks\n env:\n FOUNDRY_DIR: ${{ github.workspace }}/.foundry\n run: |\n VERSIONS=\"${{ github.event.inputs.versions || 'stable,nightly' }}\"\n REPOS=\"${{ github.event.inputs.repos || env.DEFAULT_REPOS }}\"\n\n ./target/release/foundry-bench --output-dir ./benches --force-install \\\n --versions $VERSIONS \\\n --repos $REPOS \\\n --benchmarks forge_test,forge_fuzz_test \\\n --output-file forge_test_bench.md\n\n - name: Run forge isolate test benchmarks\n env:\n FOUNDRY_DIR: ${{ github.workspace }}/.foundry\n run: |\n VERSIONS=\"${{ github.event.inputs.versions || 'stable,nightly' }}\"\n # Isolate tests default to Vectorized/solady but can be overridden\n REPOS=\"${{ github.event.inputs.repos || env.VECTORIZED_SOLADY }}\"\n\n ./target/release/foundry-bench --output-dir ./benches --force-install \\\n --versions $VERSIONS \\\n --repos $REPOS \\\n --benchmarks forge_isolate_test \\\n --output-file forge_isolate_test_bench.md\n\n - name: Run forge build benchmarks\n env:\n FOUNDRY_DIR: ${{ github.workspace }}/.foundry\n run: |\n VERSIONS=\"${{ github.event.inputs.versions || 'stable,nightly' }}\"\n REPOS=\"${{ github.event.inputs.repos || env.DEFAULT_REPOS }}\"\n\n ./target/release/foundry-bench --output-dir ./benches --force-install \\\n --versions $VERSIONS \\\n --repos $REPOS \\\n --benchmarks forge_build_no_cache,forge_build_with_cache \\\n --output-file forge_build_bench.md\n\n - name: Run forge coverage benchmarks\n env:\n FOUNDRY_DIR: ${{ github.workspace }}/.foundry\n run: |\n VERSIONS=\"${{ github.event.inputs.versions || 'stable,nightly' }}\"\n # Coverage only runs on ithacaxyz/account:v0.3.2\n\n ./target/release/foundry-bench --output-dir ./benches --force-install \\\n --versions $VERSIONS \\\n --repos ${{ env.ITHACAXYZ_ACCOUNT }} \\\n --benchmarks forge_coverage \\\n --output-file forge_coverage_bench.md\n\n - name: Combine benchmark results\n run: ./.github/scripts/combine-benchmarks.sh benches\n\n - name: Commit and read benchmark results\n id: benchmark_results\n env:\n GITHUB_HEAD_REF: ${{ github.head_ref }}\n run: ./.github/scripts/commit-and-read-benchmarks.sh benches \"${{ github.event_name }}\" \"${{ github.repository }}\"\n\n - name: Upload benchmark results as artifacts\n uses: actions/upload-artifact@v7\n with:\n name: benchmark-results\n path: |\n benches/forge_test_bench.md\n benches/forge_isolate_test_bench.md\n benches/forge_build_bench.md\n benches/forge_coverage_bench.md\n benches/LATEST.md\n\n outputs:\n branch_name: ${{ steps.benchmark_results.outputs.branch_name }}\n pr_comment: ${{ steps.benchmark_results.outputs.pr_comment }}\n\n publish-results:\n name: Publish Results\n needs: run-benchmarks\n runs-on: ubuntu-latest\n permissions:\n contents: write\n pull-requests: write\n steps:\n - name: Checkout repository\n uses: actions/checkout@v6\n with:\n persist-credentials: false\n\n - name: Download benchmark results\n uses: actions/download-artifact@v8\n with:\n name: benchmark-results\n path: benches/\n\n - name: Push branch for manual runs\n if: github.event_name == 'workflow_dispatch'\n run: |\n git push origin \"${{ needs.run-benchmarks.outputs.branch_name }}\"\n echo \"Pushed branch: ${{ needs.run-benchmarks.outputs.branch_name }}\"\n\n - name: Create PR for manual runs\n if: github.event_name == 'workflow_dispatch'\n uses: actions/github-script@v8\n with:\n script: |\n const branchName = '${{ needs.run-benchmarks.outputs.branch_name }}';\n const prComment = `${{ needs.run-benchmarks.outputs.pr_comment }}`;\n\n // Create the pull request\n const { data: pr } = await github.rest.pulls.create({\n owner: context.repo.owner,\n repo: context.repo.repo,\n title: 'chore(bench): update benchmark results',\n head: branchName,\n base: 'master',\n body: `## Benchmark Results Update\n\n This PR contains the latest benchmark results from a manual workflow run.\n\n ${prComment}\n\n ---\n\n šŸ¤– This PR was automatically generated by the [Foundry Benchmarks workflow](https://github.com/${{ github.repository }}/actions).`\n });\n\n console.log(`Created PR #${pr.number}: ${pr.html_url}`);\n\n - name: Comment on PR\n if: github.event.inputs.pr_number != '' || github.event_name == 'pull_request'\n uses: actions/github-script@v8\n with:\n script: |\n const prNumber = ${{ github.event.inputs.pr_number || github.event.pull_request.number }};\n const prComment = `${{ needs.run-benchmarks.outputs.pr_comment }}`;\n\n const comment = `${prComment}\n\n ---\n\n šŸ¤– This comment was automatically generated by the [Foundry Benchmarks workflow](https://github.com/${{ github.repository }}/actions).\n\n To run benchmarks manually: Go to [Actions](https://github.com/${{ github.repository }}/actions/workflows/benchmarks.yml) ā†’ \"Run workflow\"`;\n\n github.rest.issues.createComment({\n issue_number: prNumber,\n owner: context.repo.owner,\n repo: context.repo.repo,\n body: comment\n });\n" }, { "path": ".github/workflows/bump-forge-std.yml", "content": "# Daily CI job to update forge-std version used for tests if new release has been published\n\nname: bump-forge-std\n\npermissions: {}\n\non:\n schedule:\n - cron: \"0 0 * * *\" # Run daily at midnight UTC\n workflow_dispatch: # Needed so we can run it manually\n\njobs:\n update-tag:\n name: update forge-std tag\n runs-on: ubuntu-latest\n permissions:\n contents: write\n pull-requests: write\n steps:\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n - name: Fetch and update forge-std tag\n run: curl 'https://api.github.com/repos/foundry-rs/forge-std/tags' | jq '.[0].commit.sha' -jr > testdata/forge-std-rev\n - name: Create pull request\n uses: peter-evans/create-pull-request@c0f553fe549906ede9cf27b5156039d195d2ece0 # v7\n with:\n commit-message: \"chore: bump forge-std version used for tests\"\n title: \"chore(tests): bump forge-std version\"\n body: |\n New release of forge-std has been published, bump forge-std version used in tests. Likely some fixtures need to be updated.\n branch: chore/bump-forge-std\n" }, { "path": ".github/workflows/ci.yml", "content": "name: CI\n\npermissions: {}\n\non:\n push:\n branches: [master]\n pull_request:\n\nconcurrency:\n group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}\n cancel-in-progress: true\n\nenv:\n CARGO_TERM_COLOR: always\n RUST_BACKTRACE: full\n RUSTC_WRAPPER: \"sccache\"\n\njobs:\n test:\n uses: ./.github/workflows/test.yml\n permissions:\n contents: read\n with:\n profile: default\n secrets: inherit\n\n docs:\n uses: ./.github/workflows/docs.yml\n permissions:\n contents: read\n pages: write\n id-token: write\n secrets: inherit\n\n doctest:\n runs-on: depot-ubuntu-latest\n timeout-minutes: 30\n permissions:\n contents: read\n steps:\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n - uses: dtolnay/rust-toolchain@e97e2d8cc328f1b50210efc529dca0028893a2d9 # master\n with:\n toolchain: stable\n - uses: rui314/setup-mold@725a8794d15fc7563f59595bd9556495c0564878 # v1\n - uses: mozilla-actions/sccache-action@7d986dd989559c6ecdb630a3fd2557667be217ad # v0.0.9\n - uses: Swatinem/rust-cache@c19371144df3bb44fab255c43d04cbc2ab54d1c4 # v2\n - run: cargo test --workspace --doc\n\n typos:\n runs-on: depot-ubuntu-latest\n timeout-minutes: 30\n permissions:\n contents: read\n steps:\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n - uses: crate-ci/typos@631208b7aac2daa8b707f55e7331f9112b0e062d # v1\n\n shellcheck:\n runs-on: depot-ubuntu-latest\n timeout-minutes: 5\n permissions:\n contents: read\n steps:\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n - name: Shellcheck\n shell: bash\n run: ./.github/scripts/shellcheck.sh\n\n clippy:\n runs-on: depot-ubuntu-latest\n timeout-minutes: 30\n permissions:\n contents: read\n steps:\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n - uses: dtolnay/rust-toolchain@e97e2d8cc328f1b50210efc529dca0028893a2d9 # master\n with:\n toolchain: nightly\n components: clippy\n - uses: rui314/setup-mold@725a8794d15fc7563f59595bd9556495c0564878 # v1\n - uses: mozilla-actions/sccache-action@7d986dd989559c6ecdb630a3fd2557667be217ad # v0.0.9\n - uses: Swatinem/rust-cache@c19371144df3bb44fab255c43d04cbc2ab54d1c4 # v2\n - run: cargo clippy --workspace --all-targets --all-features\n env:\n RUSTFLAGS: -Dwarnings\n\n rustfmt:\n runs-on: depot-ubuntu-latest\n timeout-minutes: 30\n permissions:\n contents: read\n steps:\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n - uses: dtolnay/rust-toolchain@e97e2d8cc328f1b50210efc529dca0028893a2d9 # master\n with:\n toolchain: nightly\n components: rustfmt\n - run: cargo fmt --all --check\n\n forge-fmt:\n runs-on: depot-ubuntu-latest\n timeout-minutes: 30\n permissions:\n contents: read\n steps:\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n - uses: dtolnay/rust-toolchain@e97e2d8cc328f1b50210efc529dca0028893a2d9 # master\n with:\n toolchain: stable\n - uses: rui314/setup-mold@725a8794d15fc7563f59595bd9556495c0564878 # v1\n - uses: mozilla-actions/sccache-action@7d986dd989559c6ecdb630a3fd2557667be217ad # v0.0.9\n - uses: Swatinem/rust-cache@c19371144df3bb44fab255c43d04cbc2ab54d1c4 # v2\n - name: forge fmt\n shell: bash\n run: ./.github/scripts/format.sh --check\n\n crate-checks:\n runs-on: depot-ubuntu-latest\n timeout-minutes: 30\n permissions:\n contents: read\n steps:\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n - uses: dtolnay/rust-toolchain@e97e2d8cc328f1b50210efc529dca0028893a2d9 # master\n with:\n toolchain: stable\n - uses: rui314/setup-mold@725a8794d15fc7563f59595bd9556495c0564878 # v1\n - uses: taiki-e/install-action@94a7388bec5d4c8dd93e3ebf09e0ff448f3f6f4d # v2\n with:\n tool: cargo-hack\n - uses: mozilla-actions/sccache-action@7d986dd989559c6ecdb630a3fd2557667be217ad # v0.0.9\n - uses: Swatinem/rust-cache@c19371144df3bb44fab255c43d04cbc2ab54d1c4 # v2\n - run: cargo hack check\n\n deny:\n uses: tempoxyz/ci/.github/workflows/deny.yml@268b3ce142717ff86c58fbbcc3abc3f109f0fb8d # main\n permissions:\n contents: read\n\n codeql:\n name: analyze (${{ matrix.language }})\n runs-on: ubuntu-latest\n permissions:\n security-events: write\n actions: read\n contents: read\n strategy:\n fail-fast: false\n matrix:\n include:\n - language: actions\n build-mode: none\n steps:\n - name: Checkout repository\n uses: actions/checkout@v6\n with:\n persist-credentials: false\n - name: Initialize CodeQL\n uses: github/codeql-action/init@v4\n with:\n languages: ${{ matrix.language }}\n build-mode: ${{ matrix.build-mode }}\n - name: Perform CodeQL Analysis\n uses: github/codeql-action/analyze@v4\n with:\n category: \"/language:${{matrix.language}}\"\n\n ci-success:\n runs-on: ubuntu-latest\n if: always()\n permissions: {}\n needs:\n - test\n - docs\n - doctest\n - typos\n - clippy\n - rustfmt\n - forge-fmt\n - crate-checks\n - deny\n - codeql\n timeout-minutes: 30\n steps:\n - name: Decide whether the needed jobs succeeded or failed\n uses: re-actors/alls-green@05ac9388f0aebcb5727afa17fcccfecd6f8ec5fe # release/v1\n with:\n jobs: ${{ toJSON(needs) }}\n" }, { "path": ".github/workflows/dependencies.yml", "content": "# Runs `cargo update` periodically.\n\nname: dependencies\n\npermissions: {}\n\non:\n schedule:\n - cron: \"0 0 * * SUN\" # Run weekly on Sundays at midnight UTC\n workflow_dispatch: # Needed so we can run it manually\n\njobs:\n update:\n uses: tempoxyz/ci/.github/workflows/cargo-update-pr.yml@268b3ce142717ff86c58fbbcc3abc3f109f0fb8d # main\n permissions:\n contents: write\n pull-requests: write\n secrets:\n token: ${{ secrets.GITHUB_TOKEN }}\n" }, { "path": ".github/workflows/docker-publish.yml", "content": "name: docker\n\npermissions: {}\n\non:\n workflow_dispatch:\n inputs:\n tag_name:\n default: nightly\n description: The tag we're building for\n type: string\n workflow_call:\n inputs:\n tag_name:\n required: true\n type: string\n\nconcurrency:\n group: docker-${{ github.head_ref }}\n cancel-in-progress: ${{ github.event_name == 'pull_request' }}\n\nenv:\n REGISTRY: ghcr.io\n IMAGE_NAME: ${{ github.repository }}\n\n # Keep in sync with `release.yml`.\n RUST_PROFILE: dist\n RUST_FEATURES: aws-kms,gcp-kms,turnkey,cli,asm-keccak,js-tracer\n\njobs:\n build:\n name: build and push\n runs-on: depot-ubuntu-latest\n permissions:\n contents: read\n id-token: write\n packages: write\n timeout-minutes: 60\n steps:\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n\n # Login against a Docker registry except on PR\n # https://github.com/docker/login-action\n - name: Login into registry ${{ env.REGISTRY }}\n uses: docker/login-action@b45d80f862d83dbcd57f89517bcf500b2ab88fb2 # v4.0.0\n with:\n registry: ${{ env.REGISTRY }}\n username: ${{ github.actor }}\n password: ${{ secrets.GITHUB_TOKEN }}\n\n # Extract metadata (tags, labels) for Docker\n # https://github.com/docker/metadata-action\n - name: Extract Docker metadata\n id: meta\n uses: docker/metadata-action@030e881283bb7a6894de51c315a6bfe6a94e05cf # v6.0.0\n with:\n images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}\n\n # Creates an additional 'latest' or 'nightly' tag\n # If the job is triggered via cron schedule, tag nightly and nightly-{SHA}\n # If the job is triggered via workflow dispatch and on a master branch, tag branch and latest\n # Otherwise, just tag as the branch name\n - name: Finalize Docker Metadata\n id: docker_tagging\n run: |\n TAG=\"${{ inputs.tag_name }}\"\n REGISTRY=\"${{ env.REGISTRY }}\"\n IMAGE=\"${{ env.IMAGE_NAME }}\"\n\n if [[ \"${{ github.event_name }}\" == \"schedule\" ]]; then\n printf \"cron trigger, assigning nightly tag\\n\"\n printf \"docker_tags=%s/%s:nightly,%s/%s:nightly-%s\\n\" \"$REGISTRY\" \"$IMAGE\" \"$REGISTRY\" \"$IMAGE\" \"$GITHUB_SHA\" >> \"$GITHUB_OUTPUT\"\n elif [[ \"${GITHUB_REF##*/}\" == \"main\" ]] || [[ \"${GITHUB_REF##*/}\" == \"master\" ]]; then\n printf \"manual trigger from master/main branch, assigning latest tag\\n\"\n printf \"docker_tags=%s/%s:%s,%s/%s:latest\\n\" \"$REGISTRY\" \"$IMAGE\" \"${GITHUB_REF##*/}\" \"$REGISTRY\" \"$IMAGE\" >> \"$GITHUB_OUTPUT\"\n elif [[ \"$TAG\" =~ ^v([0-9]+)\\.([0-9]+)\\.([0-9]+)$ ]]; then\n MAJOR=\"v${BASH_REMATCH[1]}\"\n MINOR=\"v${BASH_REMATCH[1]}.${BASH_REMATCH[2]}\"\n printf \"version tag release, assigning %s, %s, and %s tags\\n\" \"$TAG\" \"$MINOR\" \"$MAJOR\"\n printf \"docker_tags=%s/%s:%s,%s/%s:%s,%s/%s:%s\\n\" \"$REGISTRY\" \"$IMAGE\" \"$TAG\" \"$REGISTRY\" \"$IMAGE\" \"$MINOR\" \"$REGISTRY\" \"$IMAGE\" \"$MAJOR\" >> \"$GITHUB_OUTPUT\"\n else\n printf \"Neither scheduled nor manual release from main branch. Just tagging as branch name\\n\"\n printf \"docker_tags=%s/%s:%s\\n\" \"$REGISTRY\" \"$IMAGE\" \"${GITHUB_REF##*/}\" >> \"$GITHUB_OUTPUT\"\n fi\n\n # Log docker metadata to explicitly know what is being pushed\n - name: Inspect Docker Metadata\n run: |\n printf \"TAGS -> %s\\n\" \"${{ steps.docker_tagging.outputs.docker_tags }}\"\n printf \"LABELS -> %s\\n\" \"${{ steps.meta.outputs.labels }}\"\n\n - name: Set up Depot CLI\n uses: depot/setup-action@15c09a5f77a0840ad4bce955686522a257853461 # v1\n\n - name: Build and push Foundry image\n uses: depot/build-push-action@5f3b3c2e5a00f0093de47f657aeaefcedff27d18 # v1\n with:\n build-args: |\n RUST_PROFILE=${{ env.RUST_PROFILE }}\n RUST_FEATURES=${{ env.RUST_FEATURES }}\n TAG_NAME=${{ inputs.tag_name }}\n VERGEN_GIT_SHA=${{ github.sha }}\n project: 8gkbxxjrpw\n context: .\n tags: ${{ steps.docker_tagging.outputs.docker_tags }}\n labels: ${{ steps.meta.outputs.labels }}\n platforms: linux/amd64,linux/arm64\n push: true\n" }, { "path": ".github/workflows/docs.yml", "content": "name: docs\n\npermissions: {}\n\non:\n push:\n branches:\n - master\n workflow_call:\n\nconcurrency:\n group: docs-${{ github.workflow }}-${{ github.head_ref || github.run_id }}\n cancel-in-progress: true\n\nenv:\n CARGO_TERM_COLOR: always\n RUST_BACKTRACE: full\n RUSTC_WRAPPER: \"sccache\"\n\njobs:\n docs:\n runs-on: depot-ubuntu-latest\n timeout-minutes: 30\n permissions:\n contents: read\n steps:\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n - uses: dtolnay/rust-toolchain@e97e2d8cc328f1b50210efc529dca0028893a2d9 # master\n with:\n toolchain: nightly\n - uses: rui314/setup-mold@725a8794d15fc7563f59595bd9556495c0564878 # v1\n - uses: mozilla-actions/sccache-action@7d986dd989559c6ecdb630a3fd2557667be217ad # v0.0.9\n - uses: Swatinem/rust-cache@c19371144df3bb44fab255c43d04cbc2ab54d1c4 # v2\n - name: Build documentation\n run: cargo doc --workspace --all-features --no-deps --document-private-items\n env:\n RUSTDOCFLAGS: --cfg docsrs -D warnings --show-type-layout --generate-link-to-definition --enable-index-page -Zunstable-options\n - name: Setup Pages\n if: github.ref_name == 'master' && github.event_name == 'push'\n uses: actions/configure-pages@v5\n - name: Upload artifact\n if: github.ref_name == 'master' && github.event_name == 'push'\n uses: actions/upload-pages-artifact@v4\n with:\n path: ./target/doc\n\n deploy-docs:\n if: github.ref_name == 'master' && github.event_name == 'push'\n needs: [docs]\n runs-on: depot-ubuntu-latest\n timeout-minutes: 30\n permissions:\n pages: write\n id-token: write\n environment:\n name: github-pages\n url: ${{ steps.deployment.outputs.page_url }}\n steps:\n - name: Deploy to GitHub Pages\n id: deployment\n uses: actions/deploy-pages@v4\n" }, { "path": ".github/workflows/nix.yml", "content": "name: nix\n\npermissions: {}\n\non:\n schedule:\n - cron: \"0 0 * * SUN\" # Run weekly on Sundays at midnight UTC\n workflow_dispatch: # Needed so we can run it manually\n\nconcurrency:\n group: ${{ github.workflow }}-${{ github.ref }}\n cancel-in-progress: true\n\njobs:\n # Opens a PR with an updated flake.lock file\n update:\n runs-on: ubuntu-latest\n permissions:\n contents: write\n pull-requests: write\n steps:\n - uses: DeterminateSystems/determinate-nix-action@131015bad844610e5e6300f8a143bf625d3e74f4 # v3\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n - uses: DeterminateSystems/update-flake-lock@e80a657d7603606be0c69b117cfdc240f1e6af88 # main\n with:\n pr-title: \"Update flake.lock\"\n pr-labels: |\n L-ignore\n A-dependencies\n\n build:\n strategy:\n matrix:\n runs-on: [ubuntu-latest, macos-latest]\n runs-on: ${{ matrix.runs-on }}\n permissions:\n contents: read\n steps:\n - uses: DeterminateSystems/determinate-nix-action@131015bad844610e5e6300f8a143bf625d3e74f4 # v3\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n\n - name: Update flake.lock\n run: nix flake update\n\n - name: Activate nix env\n run: nix develop -c echo Ok\n\n - name: Check that we can compile all crates\n run: nix develop -c cargo check --all-targets\n" }, { "path": ".github/workflows/npm.yml", "content": "name: npm\n\npermissions: {}\n\non:\n workflow_dispatch:\n inputs:\n run_id:\n type: string\n required: false\n description: The run id of the release to publish\n workflow_run:\n types: [completed]\n workflows: [release]\n\nconcurrency:\n group: ${{ github.workflow }}-${{ github.ref }}\n cancel-in-progress: true\n\ndefaults:\n run:\n shell: bash\n\nenv:\n NPM_CONFIG_PROVENANCE: true\n NPM_REGISTRY_URL: \"https://registry.npmjs.org\"\n\njobs:\n publish-arch:\n permissions:\n contents: read\n actions: read\n id-token: write\n name: ${{ matrix.tool }}-${{ matrix.os }}-${{ matrix.arch }}\n runs-on: ubuntu-latest\n strategy:\n max-parallel: 3\n fail-fast: false\n matrix:\n include:\n - tool: forge\n os: linux\n arch: amd64\n - tool: forge\n os: linux\n arch: arm64\n - tool: forge\n os: darwin\n arch: amd64\n - tool: forge\n os: darwin\n arch: arm64\n - tool: forge\n os: win32\n arch: amd64\n - tool: cast\n os: linux\n arch: amd64\n - tool: cast\n os: linux\n arch: arm64\n - tool: cast\n os: darwin\n arch: amd64\n - tool: cast\n os: darwin\n arch: arm64\n - tool: cast\n os: win32\n arch: amd64\n - tool: anvil\n os: linux\n arch: amd64\n - tool: anvil\n os: linux\n arch: arm64\n - tool: anvil\n os: darwin\n arch: amd64\n - tool: anvil\n os: darwin\n arch: arm64\n - tool: anvil\n os: win32\n arch: amd64\n - tool: chisel\n os: linux\n arch: amd64\n - tool: chisel\n os: linux\n arch: arm64\n - tool: chisel\n os: darwin\n arch: amd64\n - tool: chisel\n os: darwin\n arch: arm64\n - tool: chisel\n os: win32\n arch: amd64\n # Run automatically after a successful 'release' workflow, or manually if a run_id is provided\n if: >-\n ${{\n (github.event_name == 'workflow_run' && github.event.workflow_run.conclusion == 'success') ||\n (github.event_name == 'workflow_dispatch' && inputs.run_id != '')\n }}\n outputs:\n RELEASE_VERSION: ${{ steps.release-version.outputs.RELEASE_VERSION }}\n steps:\n - name: Checkout\n uses: actions/checkout@v6\n with:\n persist-credentials: false\n\n - name: Set Isolated Artifact Directory\n id: paths\n run: |\n set -euo pipefail\n printf 'artifact_dir=%s\\n' \"$RUNNER_TEMP/foundry_artifacts\" >> \"$GITHUB_OUTPUT\"\n\n - name: Prepare Isolated Artifact Directory\n env:\n ARTIFACT_DIR: ${{ steps.paths.outputs.artifact_dir }}\n run: |\n mkdir -p \"$ARTIFACT_DIR\"\n ls -la \"$ARTIFACT_DIR\" || true\n\n - name: Download Release Assets\n uses: actions/download-artifact@v8\n with:\n merge-multiple: true\n # Download all foundry artifacts from the triggering release run\n pattern: \"foundry_*\"\n # Extract artifacts into an isolated temp directory, not the workspace\n path: ${{ steps.paths.outputs.artifact_dir }}\n github-token: ${{ secrets.GITHUB_TOKEN }}\n run-id: ${{ github.event.workflow_run.id || inputs.run_id }}\n\n - name: Setup Bun\n uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6 # v2\n with:\n bun-version: latest\n\n - name: Setup Node (for npm publish auth)\n uses: actions/setup-node@v6\n with:\n node-version: \"24\"\n registry-url: \"https://registry.npmjs.org\"\n\n - name: Derive RELEASE_VERSION\n id: release-version\n working-directory: ./npm\n env:\n PROVENANCE: true\n NPM_TOKEN: ${{ secrets.NPM_TOKEN }}\n NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}\n NPM_REGISTRY_URL: ${{ env.NPM_REGISTRY_URL }}\n ARTIFACT_DIR: ${{ steps.paths.outputs.artifact_dir }}\n run: |\n set -euo pipefail\n\n echo \"Artifacts in $ARTIFACT_DIR:\"\n ls -la \"$ARTIFACT_DIR\" || true\n\n # Derive RELEASE_VERSION from any foundry artifact we downloaded\n # Expected names: foundry___.{tar.gz,zip}\n first_file=$(ls \"$ARTIFACT_DIR\"/foundry_* 2>/dev/null | head -n1 || true)\n if [[ -z \"${first_file}\" ]]; then\n echo \"No foundry artifacts found to publish\" >&2\n exit 1\n fi\n version_part=$(basename \"$first_file\")\n version_part=${version_part#foundry_}\n export RELEASE_VERSION=${version_part%%_*}\n echo \"Detected RELEASE_VERSION=$RELEASE_VERSION\"\n\n printf 'RELEASE_VERSION=%s\\n' \"$RELEASE_VERSION\" >>\"$GITHUB_OUTPUT\"\n\n - name: Stage Binary Into Package\n working-directory: ./npm\n env:\n RELEASE_VERSION: ${{ steps.release-version.outputs.RELEASE_VERSION }}\n ARTIFACT_DIR: ${{ steps.paths.outputs.artifact_dir }}\n run: |\n set -euo pipefail\n\n bun ./scripts/stage-from-artifact.mjs \\\n --tool '${{ matrix.tool }}' \\\n --platform '${{ matrix.os }}' \\\n --arch '${{ matrix.arch }}' \\\n --release-version \"$RELEASE_VERSION\" \\\n --artifact-dir \"$ARTIFACT_DIR\"\n\n - name: Sanity Check Binary\n working-directory: ./npm\n run: |\n set -euo pipefail\n TOOL='${{ matrix.tool }}'\n PLATFORM='${{ matrix.os }}'\n ARCH='${{ matrix.arch }}'\n\n PKG_DIR=\"./@foundry-rs/${TOOL}-${PLATFORM}-${ARCH}\"\n BIN=\"$PKG_DIR/bin/${TOOL}\"\n if [[ \"$PLATFORM\" == \"win32\" ]]; then\n BIN=\"$PKG_DIR/bin/${TOOL}.exe\"\n fi\n echo \"Verifying binary at: $BIN\"\n ls -la \"$BIN\"\n if [[ ! -f \"$BIN\" ]]; then\n echo \"ERROR: Binary not found at $BIN\" >&2\n exit 1\n fi\n\n if [[ \"${{ matrix.os }}\" != \"win32\" ]]; then\n if [[ ! -x \"$BIN\" ]]; then\n echo \"ERROR: Binary not marked executable\" >&2\n exit 1\n fi\n fi\n\n - name: Publish ${{ matrix.os }}-${{ matrix.arch }} Binary\n working-directory: ./npm\n env:\n PROVENANCE: true\n VERSION_NAME: ${{ steps.release-version.outputs.RELEASE_VERSION }}\n RELEASE_VERSION: ${{ steps.release-version.outputs.RELEASE_VERSION }}\n NPM_TOKEN: ${{ secrets.NPM_TOKEN }}\n NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}\n run: |\n set -euo pipefail\n\n TOOL='${{ matrix.tool }}'\n PLATFORM='${{ matrix.os }}'\n ARCH='${{ matrix.arch }}'\n\n PACKAGE_DIR=\"./@foundry-rs/${TOOL}-${PLATFORM}-${ARCH}\"\n ls -la \"$PACKAGE_DIR\"\n\n bun ./scripts/publish.mjs \"$PACKAGE_DIR\"\n\n echo \"Published @foundry-rs/${TOOL}-${PLATFORM}-${ARCH}\"\n\n publish-meta:\n permissions:\n contents: read\n actions: read\n id-token: write\n needs: publish-arch\n name: Publish Meta Package\n runs-on: ubuntu-latest\n env:\n NPM_TOKEN: ${{ secrets.NPM_TOKEN }}\n NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}\n RELEASE_VERSION: ${{ needs.publish-arch.outputs.RELEASE_VERSION }}\n steps:\n - name: Checkout\n uses: actions/checkout@v6\n with:\n persist-credentials: false\n\n - name: Setup Bun\n uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6 # v2\n with:\n bun-version: latest\n\n - name: Setup Node (for npm publish auth)\n uses: actions/setup-node@v6\n with:\n node-version: \"24\"\n registry-url: \"https://registry.npmjs.org\"\n\n - name: Install Dependencies\n working-directory: ./npm\n run: bun install --frozen-lockfile\n\n - name: Typecheck\n working-directory: ./npm\n run: bun tsc --project tsconfig.json --noEmit\n\n - name: Publish Meta Packages\n working-directory: ./npm\n run: |\n set -euo pipefail\n bun ./scripts/publish-meta.mjs --release-version \"$RELEASE_VERSION\"\n env:\n PROVENANCE: true\n VERSION_NAME: ${{ env.RELEASE_VERSION }}\n RELEASE_VERSION: ${{ env.RELEASE_VERSION }}\n NPM_TOKEN: ${{ env.NPM_TOKEN }}\n NODE_AUTH_TOKEN: ${{ env.NODE_AUTH_TOKEN }}\n NPM_REGISTRY_URL: ${{ env.NPM_REGISTRY_URL }}\n" }, { "path": ".github/workflows/release.yml", "content": "name: release\n\npermissions: {}\n\non:\n push:\n tags:\n - \"stable\"\n - \"rc\"\n - \"rc-*\"\n - \"v*.*.*\"\n schedule:\n - cron: \"0 6 * * *\"\n workflow_dispatch:\n\nenv:\n CARGO_TERM_COLOR: always\n IS_NIGHTLY: ${{ github.event_name == 'schedule' || github.event_name == 'workflow_dispatch' }}\n\n # Keep in sync with `docker-publish.yml`.\n RUST_PROFILE: dist\n RUST_FEATURES: aws-kms,gcp-kms,turnkey,cli,asm-keccak,js-tracer\n\n LAST_STABLE_VERSION: \"v1.5.1\"\n\njobs:\n prepare:\n name: Prepare release\n runs-on: ubuntu-latest\n timeout-minutes: 30\n permissions:\n contents: write\n pull-requests: read\n outputs:\n tag_name: ${{ steps.release_info.outputs.tag_name }}\n release_name: ${{ steps.release_info.outputs.release_name }}\n changelog: ${{ steps.build_changelog.outputs.changelog }}\n steps:\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n fetch-depth: 0\n\n - name: Compute release name and tag\n id: release_info\n run: |\n if [[ ${IS_NIGHTLY} == 'true' ]]; then\n printf 'tag_name=%s\\n' \"nightly-${GITHUB_SHA}\" >> \"$GITHUB_OUTPUT\"\n printf 'release_name=%s\\n' \"Nightly ($(date '+%Y-%m-%d'))\" >> \"$GITHUB_OUTPUT\"\n else\n printf 'tag_name=%s\\n' \"$GITHUB_REF_NAME\" >> \"$GITHUB_OUTPUT\"\n printf 'release_name=%s\\n' \"$GITHUB_REF_NAME\" >> \"$GITHUB_OUTPUT\"\n fi\n\n # Creates a `nightly-SHA` tag for this specific nightly\n # This tag is used for this specific nightly version's release\n # which allows users to roll back. It is also used to build\n # the changelog.\n - name: Create build-specific nightly tag\n if: ${{ env.IS_NIGHTLY == 'true' }}\n uses: actions/github-script@v8\n env:\n TAG_NAME: ${{ steps.release_info.outputs.tag_name }}\n with:\n script: |\n const createTag = require('./.github/scripts/create-tag.js')\n await createTag({ github, context }, process.env.TAG_NAME)\n\n - name: Build changelog\n id: build_changelog\n uses: mikepenz/release-changelog-builder-action@a34a8009a9588bb86b02a873cf592440e96a5da8 # v6\n with:\n configuration: \"./.github/changelog.json\"\n fromTag: ${{ env.IS_NIGHTLY == 'true' && 'nightly' || env.STABLE_VERSION }}\n toTag: ${{ steps.release_info.outputs.tag_name }}\n env:\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n\n release-docker:\n name: Release Docker\n needs: prepare\n uses: ./.github/workflows/docker-publish.yml\n permissions:\n contents: read\n id-token: write\n packages: write\n with:\n tag_name: ${{ needs.prepare.outputs.tag_name }}\n\n release:\n permissions:\n id-token: write\n contents: write\n attestations: write\n name: release ${{ matrix.target }} (${{ matrix.runner }})\n runs-on: ${{ matrix.runner }}\n timeout-minutes: 240\n needs: prepare\n strategy:\n fail-fast: false\n matrix:\n include:\n # `runner`: GHA runner label\n # `target`: Rust build target triple\n # `platform` and `arch`: Used in tarball names\n # `svm`: target platform to use for the Solc binary: https://github.com/roynalnaruto/svm-rs/blob/84cbe0ac705becabdc13168bae28a45ad2299749/svm-builds/build.rs#L4-L24\n # These are pinned to the oldest runner versions to support old libc/SDK versions.\n - runner: depot-ubuntu-22.04-16\n target: x86_64-unknown-linux-gnu\n svm_target_platform: linux-amd64\n platform: linux\n arch: amd64\n - runner: depot-ubuntu-22.04-16\n target: x86_64-unknown-linux-musl\n svm_target_platform: linux-amd64\n platform: alpine\n arch: amd64\n - runner: depot-ubuntu-22.04-arm-16\n target: aarch64-unknown-linux-gnu\n svm_target_platform: linux-aarch64\n platform: linux\n arch: arm64\n - runner: depot-ubuntu-22.04-16\n target: aarch64-unknown-linux-musl\n svm_target_platform: linux-aarch64\n platform: alpine\n arch: arm64\n - runner: macos-14-large\n target: x86_64-apple-darwin\n svm_target_platform: macosx-amd64\n platform: darwin\n arch: amd64\n - runner: macos-latest-large\n target: aarch64-apple-darwin\n svm_target_platform: macosx-aarch64\n platform: darwin\n arch: arm64\n - runner: depot-windows-latest-16\n target: x86_64-pc-windows-msvc\n svm_target_platform: windows-amd64\n platform: win32\n arch: amd64\n steps:\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n - uses: dtolnay/rust-toolchain@e97e2d8cc328f1b50210efc529dca0028893a2d9 # master\n with:\n toolchain: stable\n targets: ${{ matrix.target }}\n - uses: rui314/setup-mold@725a8794d15fc7563f59595bd9556495c0564878 # v1\n\n - uses: mozilla-actions/sccache-action@7d986dd989559c6ecdb630a3fd2557667be217ad # v0.0.9\n if: ${{ contains(matrix.runner, 'depot') }}\n - run: printf 'RUSTC_WRAPPER=sccache\\n' >> \"$GITHUB_ENV\"\n if: ${{ contains(matrix.runner, 'depot') }}\n\n - name: Apple M1 setup\n if: matrix.target == 'aarch64-apple-darwin'\n run: |\n printf 'SDKROOT=%s\\n' \"$(xcrun -sdk macosx --show-sdk-path)\" >> \"$GITHUB_ENV\"\n printf 'MACOSX_DEPLOYMENT_TARGET=%s\\n' \"$(xcrun -sdk macosx --show-sdk-platform-version)\" >> \"$GITHUB_ENV\"\n\n - name: cross setup\n if: contains(matrix.target, 'musl')\n uses: taiki-e/cache-cargo-install-action@59027ebf20a9617c4e819eb53ccd2673cb162b89 # v2\n with:\n git: https://github.com/cross-rs/cross\n rev: baf457efc2555225af47963475bd70e8d2f5993f\n tool: cross\n\n - name: Build binaries\n env:\n TAG_NAME: ${{ (env.IS_NIGHTLY == 'true' && 'nightly') || needs.prepare.outputs.tag_name }}\n SVM_TARGET_PLATFORM: ${{ matrix.svm_target_platform }}\n PLATFORM_NAME: ${{ matrix.platform }}\n TARGET: ${{ matrix.target }}\n OUT_DIR: target/${{ matrix.target }}/${{ env.RUST_PROFILE }}\n shell: bash\n run: |\n set -eo pipefail\n flags=(--target $TARGET --profile $RUST_PROFILE --bins\n --no-default-features --features \"$RUST_FEATURES\")\n\n # `jemalloc` is not fully supported on MSVC or aarch64 Linux.\n if [[ \"$TARGET\" != *msvc* && \"$TARGET\" != \"aarch64-unknown-linux-gnu\" ]]; then\n flags+=(--features jemalloc)\n fi\n\n [[ \"$TARGET\" == *windows* ]] && ext=\".exe\"\n\n if [[ \"$TARGET\" == *-musl ]]; then\n cross build \"${flags[@]}\"\n else\n cargo build \"${flags[@]}\"\n fi\n\n bins=(anvil cast chisel forge)\n for name in \"${bins[@]}\"; do\n bin=\"$OUT_DIR/$name$ext\"\n printf '\\n'\n file \"$bin\" || true\n du -h \"$bin\" || true\n ldd \"$bin\" || true\n $bin --version || true\n printf '%s_bin_path=%s\\n' \"$name\" \"$bin\" >> \"$GITHUB_ENV\"\n done\n\n - name: Archive binaries\n id: artifacts\n env:\n PLATFORM_NAME: ${{ matrix.platform }}\n OUT_DIR: target/${{ matrix.target }}/${{ env.RUST_PROFILE }}\n VERSION_NAME: ${{ (env.IS_NIGHTLY == 'true' && 'nightly') || needs.prepare.outputs.tag_name }}\n ARCH: ${{ matrix.arch }}\n shell: bash\n run: |\n if [[ \"$PLATFORM_NAME\" == \"linux\" || \"$PLATFORM_NAME\" == \"alpine\" ]]; then\n tar -czvf \"foundry_${VERSION_NAME}_${PLATFORM_NAME}_${ARCH}.tar.gz\" -C \"$OUT_DIR\" forge cast anvil chisel\n printf \"file_name=%s\\n\" \"foundry_${VERSION_NAME}_${PLATFORM_NAME}_${ARCH}.tar.gz\" >> \"$GITHUB_OUTPUT\"\n elif [ \"$PLATFORM_NAME\" == \"darwin\" ]; then\n # We need to use gtar here otherwise the archive is corrupt.\n # See: https://github.com/actions/virtual-environments/issues/2619\n gtar -czvf \"foundry_${VERSION_NAME}_${PLATFORM_NAME}_${ARCH}.tar.gz\" -C \"$OUT_DIR\" forge cast anvil chisel\n printf \"file_name=%s\\n\" \"foundry_${VERSION_NAME}_${PLATFORM_NAME}_${ARCH}.tar.gz\" >> \"$GITHUB_OUTPUT\"\n else\n cd \"$OUT_DIR\"\n 7z a -tzip \"foundry_${VERSION_NAME}_${PLATFORM_NAME}_${ARCH}.zip\" forge.exe cast.exe anvil.exe chisel.exe\n mv \"foundry_${VERSION_NAME}_${PLATFORM_NAME}_${ARCH}.zip\" ../../../\n printf \"file_name=%s\\n\" \"foundry_${VERSION_NAME}_${PLATFORM_NAME}_${ARCH}.zip\" >> \"$GITHUB_OUTPUT\"\n fi\n printf \"foundry_attestation=%s\\n\" \"foundry_${VERSION_NAME}_${PLATFORM_NAME}_${ARCH}.attestation.txt\" >> \"$GITHUB_OUTPUT\"\n\n - name: Upload build artifacts\n uses: actions/upload-artifact@v7\n with:\n retention-days: 1\n name: ${{ steps.artifacts.outputs.file_name }}\n path: ${{ steps.artifacts.outputs.file_name }}\n\n - name: Build man page\n id: man\n if: matrix.target == 'x86_64-unknown-linux-gnu'\n env:\n OUT_DIR: target/${{ matrix.target }}/${{ env.RUST_PROFILE }}\n VERSION_NAME: ${{ (env.IS_NIGHTLY == 'true' && 'nightly') || needs.prepare.outputs.tag_name }}\n shell: bash\n run: |\n sudo apt-get -y install help2man\n help2man -N $OUT_DIR/forge > forge.1\n help2man -N $OUT_DIR/cast > cast.1\n help2man -N $OUT_DIR/anvil > anvil.1\n help2man -N $OUT_DIR/chisel > chisel.1\n gzip forge.1\n gzip cast.1\n gzip anvil.1\n gzip chisel.1\n tar -czvf \"foundry_man_${VERSION_NAME}.tar.gz\" forge.1.gz cast.1.gz anvil.1.gz chisel.1.gz\n printf 'foundry_man=%s\\n' \"foundry_man_${VERSION_NAME}.tar.gz\" >> \"$GITHUB_OUTPUT\"\n\n - name: Binaries attestation\n id: attestation\n uses: actions/attest-build-provenance@v4\n with:\n subject-path: |\n ${{ env.anvil_bin_path }}\n ${{ env.cast_bin_path }}\n ${{ env.chisel_bin_path }}\n ${{ env.forge_bin_path }}\n\n - name: Record attestation URL\n env:\n ATTESTATION_URL: ${{ steps.attestation.outputs.attestation-url }}\n FOUNDRY_ATTESTATION: ${{ steps.artifacts.outputs.foundry_attestation }}\n shell: bash\n run: |\n set -euo pipefail\n printf '%s\\n' \"$ATTESTATION_URL\" > \"$FOUNDRY_ATTESTATION\"\n\n # Creates the release for this specific version\n - name: Create release\n uses: softprops/action-gh-release@5be0e66d93ac7ed76da52eca8bb058f665c3a5fe # v2.4.2\n with:\n name: ${{ needs.prepare.outputs.release_name }}\n tag_name: ${{ needs.prepare.outputs.tag_name }}\n prerelease: ${{ env.IS_NIGHTLY == 'true' }}\n body: ${{ needs.prepare.outputs.changelog }}\n files: |\n ${{ steps.artifacts.outputs.file_name }}\n ${{ steps.artifacts.outputs.foundry_attestation }}\n ${{ steps.man.outputs.foundry_man }}\n\n # If this is a nightly release, it also updates the release\n # tagged `nightly` for compatibility with `foundryup`\n - name: Update nightly release\n if: ${{ env.IS_NIGHTLY == 'true' }}\n uses: softprops/action-gh-release@5be0e66d93ac7ed76da52eca8bb058f665c3a5fe # v2.4.2\n with:\n name: \"Nightly\"\n tag_name: \"nightly\"\n prerelease: true\n body: ${{ needs.prepare.outputs.changelog }}\n files: |\n ${{ steps.artifacts.outputs.file_name }}\n ${{ steps.artifacts.outputs.foundry_attestation }}\n ${{ steps.man.outputs.foundry_man }}\n\n cleanup:\n name: Release cleanup\n runs-on: ubuntu-latest\n timeout-minutes: 30\n permissions:\n contents: write\n needs: release\n if: always()\n steps:\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n\n # Moves the `nightly` tag to `HEAD`\n - name: Move nightly tag\n if: ${{ env.IS_NIGHTLY == 'true' }}\n uses: actions/github-script@v8\n with:\n script: |\n const moveTag = require('./.github/scripts/move-tag.js')\n await moveTag({ github, context }, 'nightly')\n\n - name: Delete old nightlies\n uses: actions/github-script@v8\n with:\n script: |\n const prunePrereleases = require('./.github/scripts/prune-prereleases.js')\n await prunePrereleases({github, context})\n\n # If any of the jobs fail, this will create a high-priority issue to signal so.\n issue:\n name: Open an issue\n runs-on: ubuntu-latest\n needs: [prepare, release-docker, release, cleanup]\n if: failure()\n permissions:\n contents: read\n issues: write\n steps:\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n - uses: JasonEtco/create-an-issue@1b14a70e4d8dc185e5cc76d3bec9eab20257b2c5 # v2\n env:\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n WORKFLOW_URL: |\n ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}\n with:\n update_existing: true\n filename: .github/RELEASE_FAILURE_ISSUE_TEMPLATE.md\n" }, { "path": ".github/workflows/test-flaky.yml", "content": "# Daily CI job to run flaky tests that are excluded from regular CI via nextest default-filter\n\nname: test-flaky\n\npermissions: {}\n\non:\n schedule:\n - cron: \"0 1 * * *\" # Run daily at 1 AM UTC (offset from test-isolate)\n workflow_dispatch: # Needed so we can run it manually\n\nconcurrency:\n group: tests-${{ github.workflow }}-${{ github.head_ref || github.run_id }}\n cancel-in-progress: true\n\nenv:\n CARGO_TERM_COLOR: always\n RUST_BACKTRACE: full\n RUSTC_WRAPPER: \"sccache\"\n\njobs:\n test:\n name: flaky tests\n runs-on: depot-ubuntu-latest-16\n timeout-minutes: 60\n permissions:\n contents: read\n steps:\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n - uses: dtolnay/rust-toolchain@e97e2d8cc328f1b50210efc529dca0028893a2d9 # master\n with:\n toolchain: stable\n - uses: rui314/setup-mold@725a8794d15fc7563f59595bd9556495c0564878 # v1\n - uses: taiki-e/install-action@94a7388bec5d4c8dd93e3ebf09e0ff448f3f6f4d # v2\n with:\n tool: nextest\n - uses: mozilla-actions/sccache-action@7d986dd989559c6ecdb630a3fd2557667be217ad # v0.0.9\n - uses: Swatinem/rust-cache@c19371144df3bb44fab255c43d04cbc2ab54d1c4 # v2\n - name: Test flaky tests\n env:\n SVM_TARGET_PLATFORM: linux-amd64\n HTTP_ARCHIVE_URLS: ${{ secrets.HTTP_ARCHIVE_URLS }}\n ETHERSCAN_KEY: ${{ secrets.ETHERSCAN_API_KEY }}\n run: cargo nextest run --profile flaky --no-fail-fast\n\n # If any of the jobs fail, this will create a normal-priority issue to signal so.\n issue:\n name: Open an issue\n runs-on: ubuntu-latest\n needs: [test]\n if: failure()\n permissions:\n contents: read\n issues: write\n steps:\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n - uses: JasonEtco/create-an-issue@1b14a70e4d8dc185e5cc76d3bec9eab20257b2c5 # v2\n env:\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n WORKFLOW_URL: |\n ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}\n with:\n update_existing: true\n filename: .github/FLAKY_TEST_FAILURE_TEMPLATE.md\n" }, { "path": ".github/workflows/test-isolate.yml", "content": "# Daily CI job to run tests with isolation mode enabled by default\n\nname: test-isolate\n\npermissions: {}\n\non:\n schedule:\n - cron: \"0 0 * * *\" # Run daily at midnight UTC\n workflow_dispatch: # Needed so we can run it manually\n\nenv:\n CARGO_TERM_COLOR: always\n RUST_BACKTRACE: full\n RUSTC_WRAPPER: \"sccache\"\n\njobs:\n nextest:\n uses: ./.github/workflows/test.yml\n permissions:\n contents: read\n with:\n profile: isolate\n\n # Run flaky tests with isolation enabled\n flaky:\n name: flaky tests (isolate)\n runs-on: depot-ubuntu-latest-16\n timeout-minutes: 60\n permissions:\n contents: read\n steps:\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n - uses: dtolnay/rust-toolchain@e97e2d8cc328f1b50210efc529dca0028893a2d9 # master\n with:\n toolchain: stable\n - uses: rui314/setup-mold@725a8794d15fc7563f59595bd9556495c0564878 # v1\n - uses: taiki-e/install-action@94a7388bec5d4c8dd93e3ebf09e0ff448f3f6f4d # v2\n with:\n tool: nextest\n - uses: mozilla-actions/sccache-action@7d986dd989559c6ecdb630a3fd2557667be217ad # v0.0.9\n - uses: Swatinem/rust-cache@c19371144df3bb44fab255c43d04cbc2ab54d1c4 # v2\n - name: Test flaky tests with isolation\n env:\n SVM_TARGET_PLATFORM: linux-amd64\n HTTP_ARCHIVE_URLS: ${{ secrets.HTTP_ARCHIVE_URLS }}\n ETHERSCAN_KEY: ${{ secrets.ETHERSCAN_API_KEY }}\n run: cargo nextest run --profile flaky --features=isolate-by-default --no-fail-fast\n\n # If nextest fails, create a high-priority issue for isolation failures.\n issue-isolate:\n name: Open isolation issue\n runs-on: ubuntu-latest\n needs: [nextest]\n if: failure()\n permissions:\n contents: read\n issues: write\n steps:\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n - uses: JasonEtco/create-an-issue@1b14a70e4d8dc185e5cc76d3bec9eab20257b2c5 # v2\n env:\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n WORKFLOW_URL: |\n ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}\n with:\n update_existing: true\n filename: .github/TEST_ISOLATE_FAILURE_TEMPLATE.md\n\n # If flaky tests fail, create a normal-priority issue for flaky failures.\n issue-flaky:\n name: Open flaky issue\n runs-on: ubuntu-latest\n needs: [flaky]\n if: failure()\n permissions:\n contents: read\n issues: write\n steps:\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n - uses: JasonEtco/create-an-issue@1b14a70e4d8dc185e5cc76d3bec9eab20257b2c5 # v2\n env:\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n WORKFLOW_URL: |\n ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}\n with:\n update_existing: true\n filename: .github/FLAKY_TEST_ISOLATE_FAILURE_TEMPLATE.md\n" }, { "path": ".github/workflows/test.yml", "content": "# Reusable workflow for running tests via `cargo nextest`\n\nname: test\n\npermissions: {}\n\non:\n workflow_call:\n inputs:\n profile:\n required: true\n type: string\n\nconcurrency:\n group: tests-${{ github.workflow }}-${{ github.head_ref || github.run_id }}\n cancel-in-progress: true\n\nenv:\n CARGO_TERM_COLOR: always\n RUST_BACKTRACE: full\n RUSTC_WRAPPER: \"sccache\"\n RUST_MIN_STACK: 4194304 # 2 * the default (2 * 1024 * 1024)\n\njobs:\n matrices:\n name: build matrices\n runs-on: ubuntu-latest\n permissions:\n contents: read\n outputs:\n test-matrix: ${{ steps.gen.outputs.test-matrix }}\n steps:\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n - uses: actions/setup-python@v6\n with:\n python-version: \"3.14\"\n - name: Generate matrices\n id: gen\n env:\n EVENT_NAME: ${{ github.event_name }}\n PROFILE: ${{ inputs.profile }}\n shell: bash\n run: |\n output=$(python3 .github/scripts/matrices.py)\n printf '::debug::test-matrix=%s\\n' \"$output\"\n printf 'test-matrix=%s\\n' \"$output\" >> \"$GITHUB_OUTPUT\"\n\n test:\n name: test ${{ matrix.name }}\n runs-on: ${{ matrix.runner_label }}\n timeout-minutes: 60\n permissions:\n contents: read\n needs: matrices\n strategy:\n fail-fast: false\n matrix: ${{ fromJson(needs.matrices.outputs.test-matrix) }}\n steps:\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n - uses: dtolnay/rust-toolchain@e97e2d8cc328f1b50210efc529dca0028893a2d9 # master\n with:\n toolchain: stable\n target: ${{ matrix.target }}\n - uses: rui314/setup-mold@725a8794d15fc7563f59595bd9556495c0564878 # v1\n - uses: taiki-e/install-action@94a7388bec5d4c8dd93e3ebf09e0ff448f3f6f4d # v2\n with:\n tool: nextest\n\n # External tests dependencies\n - name: Setup Node.js\n if: contains(matrix.name, 'external')\n uses: actions/setup-node@v6\n with:\n node-version: 24\n - name: Install Bun\n if: contains(matrix.name, 'external')\n uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6 # v2\n with:\n bun-version: latest\n - name: Setup Python\n uses: actions/setup-python@v6\n with:\n python-version: \"3.14\"\n - name: Install Vyper\n # Also update vyper version in .devcontainer/Dockerfile.dev\n run: pip --version && pip install vyper==0.4.3\n\n - name: Foundry test cache\n uses: actions/cache@v5\n with:\n path: |\n ~/.foundry/cache\n ~/.config/.foundry/cache\n testdata/cache\n testdata/out\n # Use a unique key for each run to always update the cache.\n key: ${{ runner.os }}-foundry-${{ matrix.name }}-${{ github.run_id }}\n restore-keys: |\n ${{ runner.os }}-foundry-${{ matrix.name }}-\n - uses: mozilla-actions/sccache-action@7d986dd989559c6ecdb630a3fd2557667be217ad # v0.0.9\n - uses: Swatinem/rust-cache@c19371144df3bb44fab255c43d04cbc2ab54d1c4 # v2\n - name: Setup Git config\n run: |\n git config --global user.name \"GitHub Actions Bot\"\n git config --global user.email \"<>\"\n git config --global url.\"https://github.com/\".insteadOf \"git@github.com:\"\n - name: Test\n env:\n SVM_TARGET_PLATFORM: ${{ matrix.svm_target_platform }}\n HTTP_ARCHIVE_URLS: ${{ secrets.HTTP_ARCHIVE_URLS }}\n WS_ARCHIVE_URLS: ${{ secrets.WS_ARCHIVE_URLS }}\n ETHERSCAN_KEY: ${{ secrets.ETHERSCAN_API_KEY }}\n ARBITRUM_RPC: ${{ secrets.ARBITRUM_RPC }}\n ETH_SEPOLIA_RPC: ${{ secrets.ETH_SEPOLIA_RPC }}\n run: cargo nextest run ${{ matrix.flags }}\n" }, { "path": ".gitignore", "content": ".DS_STORE\n/target*\n/*.sol\nCLAUDE.md\n\n# Foundry artifacts\nout/\nsnapshots/\n\n# IDEs and extensions\n.idea\n.vscode\n.claude\n.zed\n\n# NPM\n.env\nnode_modules\nnpm/dist\nnpm/bin\n_\n*.tgz\n.vercel\n.vite\n.wrangler\n*.zip\n" }, { "path": "CONTRIBUTING.md", "content": "## Contributing to Foundry\n\nThanks for your interest in improving Foundry!\n\nThere are multiple opportunities to contribute at any level. It doesn't matter if you are just getting started with Rust or are the most weathered expert, we can use your help.\n\nThis document will help you get started. **Do not let the document intimidate you**.\nIt should be considered as a guide to help you navigate the process.\n\nThe [dev Telegram][dev-tg] is available for any concerns you may have that are not covered in this guide.\n\n### Code of Conduct\n\nThe Foundry project adheres to the [Rust Code of Conduct][rust-coc]. This code of conduct describes the _minimum_ behavior expected from all contributors.\n\nInstances of violations of the Code of Conduct can be reported by contacting the team at [me@gakonst.com](mailto:me@gakonst.com).\n\n### Ways to contribute\n\nThere are fundamentally four ways an individual can contribute:\n\n1. **By opening an issue:** For example, if you believe that you have uncovered a bug\n in Foundry, creating a new issue in the issue tracker is the way to report it.\n2. **By adding context:** Providing additional context to existing issues,\n such as screenshots and code snippets, which help resolve issues.\n3. **By resolving issues:** Typically this is done in the form of either\n demonstrating that the issue reported is not a problem after all, or more often,\n by opening a pull request that fixes the underlying problem, in a concrete and\n reviewable manner.\n\n**Anybody can participate in any stage of contribution**. We urge you to participate in the discussion\naround bugs and participate in reviewing PRs.\n\n### Contributions Related to Spelling and Grammar\n\nAt this time, we will not be accepting contributions that only fix spelling or grammatical errors in documentation, code or elsewhere.\n\n### Contributions Assisted by AI\n\nIf you are using any kind of AI assistance while contributing to Foundry,\n**this must be disclosed in the pull request**, along with the extent to\nwhich AI assistance was used (e.g. docs only vs. code generation).\n\nIf PR responses are being generated by an AI, disclose that as well.\n\nAs a small exception, trivial tab-completion doesn't need to be disclosed,\nso long as it is limited to single keywords or short phrases.\n\nAn example disclosure:\n\n> This PR was written primarily by Claude Code.\n\nOr a more detailed disclosure:\n\n> I consulted ChatGPT to understand the codebase but the solution\n> was fully authored manually by myself.\n\nFailure to disclose this makes it difficult to determine how much scrutiny to apply to the contribution as it is unclear how much the contributor themselves understands the code they propose to merge.\n\nIf you do not disclose your use of AI assistance and reviewers suspect your contribution to be AI generated, it will likely be refused on those grounds.\n\n### Asking for help\n\nIf you have reviewed existing documentation and still have questions, or you are having problems, you can get help in the following ways:\n\n- **Asking in the support Telegram:** The [Foundry Support Telegram][support-tg] is a fast and easy way to ask questions.\n- **Opening a discussion:** This repository comes with a discussions board where you can also ask for help. Click the \"Discussions\" tab at the top.\n\nAs Foundry is still in heavy development, the documentation can be a bit scattered.\nThe [Foundry Book][foundry-book] is our current best-effort attempt at keeping up-to-date information.\n\n### Submitting a bug report\n\nWhen filing a new bug report in the issue tracker, you will be presented with a basic form to fill out.\n\nIf you believe that you have uncovered a bug, please fill out the form to the best of your ability. Do not worry if you cannot answer every detail; just fill in what you can. Contributors will ask follow-up questions if something is unclear.\n\nThe most important pieces of information we need in a bug report are:\n\n- The Foundry version you are on (and that it is up to date)\n- The platform you are on (Windows, macOS or Linux)\n- Code snippets if this is happening in relation to testing or building code\n- Concrete steps to reproduce the bug\n\nIn order to rule out the possibility of the bug being in your project, the code snippets should be as minimal\nas possible. It is better if you can reproduce the bug with a small snippet as opposed to an entire project!\n\nSee [this guide][mcve] on how to create a minimal, complete, and verifiable example.\n\n### Submitting a feature request\n\nWhen adding a feature request in the issue tracker, you will be presented with a basic form to fill out.\n\nPlease include as detailed of an explanation as possible of the feature you would like, adding additional context if necessary.\n\nIf you have examples of other tools that have the feature you are requesting, please include them as well.\n\n### Resolving an issue\n\nPull requests are the way concrete changes are made to the code, documentation, and dependencies of Foundry.\n\nEven minor pull requests, such as those fixing wording, are greatly appreciated. Before making a large change, it is usually\na good idea to first open an issue describing the change to solicit feedback and guidance. This will increase\nthe likelihood of the PR getting merged.\n\nPlease also make sure that the following commands pass if you have changed the code:\n\n```sh\ncargo check --all\ncargo test --all --all-features\ncargo +nightly fmt -- --check\ncargo +nightly clippy --workspace --all-targets --all-features -- -D warnings\n```\n\nor alternatively:\n\n```sh\nmake build\nmake pr\n```\n\nIf you are working in VSCode, we recommend you install the [rust-analyzer](https://rust-analyzer.github.io/) extension, and use the following VSCode user settings:\n\n```json\n\"editor.formatOnSave\": true,\n\"rust-analyzer.rustfmt.extraArgs\": [\"+nightly\"],\n\"[rust]\": {\n \"editor.defaultFormatter\": \"rust-lang.rust-analyzer\"\n}\n```\n\nIf you are working on a larger feature, we encourage you to open up a draft pull request, to make sure that other contributors are not duplicating work.\n\nIf you would like to test the binaries built from your change, see [foundryup](https://github.com/foundry-rs/foundry/tree/HEAD/foundryup).\n\nIf you would like to use a debugger with breakpoints to debug a patch you might be working on, keep in mind we currently strip debug info for faster builds, which is _not_ the default. Therefore, to use a debugger, you need to enable it on the workspace [`Cargo.toml`'s `dev` profile](https://github.com/foundry-rs/foundry/tree/HEAD/Cargo.toml#L15-L18).\n\n#### Adding tests\n\nIf the change being proposed alters code, it is either adding new functionality to Foundry, or fixing existing, broken functionality.\nIn both of these cases, the pull request should include one or more tests to ensure that Foundry does not regress\nin the future.\n\nTypes of tests include:\n\n- **Unit tests**: Functions which have very specific tasks should be unit tested.\n- **Integration tests**: For general purpose, far reaching functionality, integration tests should be added.\n The best way to add a new integration test is to look at existing ones and follow the style.\n\nTests that use forking must contain \"fork\" in their name.\n\n#### Commits\n\nIt is a recommended best practice to keep your changes as logically grouped as possible within individual commits. There is no limit to the number of commits any single pull request may have, and many contributors find it easier to review changes that are split across multiple commits.\n\nThat said, if you have a number of commits that are \"checkpoints\" and don't represent a single logical change, please squash those together.\n\n#### Opening the pull request\n\nFrom within GitHub, opening a new pull request will present you with a template that should be filled out. Please try your best at filling out the details, but feel free to skip parts if you're not sure what to put.\n\n#### Discuss and update\n\nYou will probably get feedback or requests for changes to your pull request.\nThis is a big part of the submission process, so don't be discouraged! Some contributors may sign off on the pull request right away, others may have more detailed comments or feedback.\nThis is a necessary part of the process in order to evaluate whether the changes are correct and necessary.\n\n**Any community member can review a PR, so you might get conflicting feedback**.\nKeep an eye out for comments from code owners to provide guidance on conflicting feedback.\n\n#### Reviewing pull requests\n\n**Any Foundry community member is welcome to review any pull request**.\n\nAll contributors who choose to review and provide feedback on pull requests have a responsibility to both the project and individual making the contribution. Reviews and feedback must be helpful, insightful, and geared towards improving the contribution as opposed to simply blocking it. If there are reasons why you feel the PR should not be merged, explain what those are. Do not expect to be able to block a PR from advancing simply because you say \"no\" without giving an explanation. Be open to having your mind changed. Be open to working _with_ the contributor to make the pull request better.\n\nReviews that are dismissive or disrespectful of the contributor or any other reviewers are strictly counter to the Code of Conduct.\n\nWhen reviewing a pull request, the primary goals are for the codebase to improve and for the person submitting the request to succeed. **Even if a pull request is not merged, the submitter should come away from the experience feeling like their effort was not unappreciated**. Every PR from a new contributor is an opportunity to grow the community.\n\n##### Review a bit at a time\n\nDo not overwhelm new contributors.\n\nIt is tempting to micro-optimize and make everything about relative performance, perfect grammar, or exact style matches. Do not succumb to that temptation..\n\nFocus first on the most significant aspects of the change:\n\n1. Does this change make sense for Foundry?\n2. Does this change make Foundry better, even if only incrementally?\n3. Are there clear bugs or larger scale issues that need attending?\n4. Are the commit messages readable and correct? If it contains a breaking change, is it clear enough?\n\nNote that only **incremental** improvement is needed to land a PR. This means that the PR does not need to be perfect, only better than the status quo. Follow-up PRs may be opened to continue iterating.\n\nWhen changes are necessary, _request_ them, do not _demand_ them, and **do not assume that the submitter already knows how to add a test or run a benchmark**.\n\nSpecific performance optimization techniques, coding styles and conventions change over time. The first impression you give to a new contributor never does.\n\nNits (requests for small changes that are not essential) are fine, but try to avoid stalling the pull request. Most nits can typically be fixed by the Foundry maintainers merging the pull request, but they can also be an opportunity for the contributor to learn a bit more about the project.\n\nIt is always good to clearly indicate nits when you comment, e.g.: `Nit: change foo() to bar(). But this is not blocking`.\n\nIf your comments were addressed but were not folded after new commits, or if they proved to be mistaken, please, [hide them][hiding-a-comment] with the appropriate reason to keep the conversation flow concise and relevant.\n\n##### Be aware of the person behind the code\n\nBe aware that _how_ you communicate requests and reviews in your feedback can have a significant impact on the success of the pull request. Yes, we may merge a particular change that makes Foundry better, but the individual might just not want to have anything to do with Foundry ever again. The goal is not just having good code.\n\n##### Abandoned or stale pull requests\n\nIf a pull request appears to be abandoned or stalled, it is polite to first check with the contributor to see if they intend to continue the work before checking if they would mind if you took it over (especially if it just has nits left). When doing so, it is courteous to give the original contributor credit for the work they started, either by preserving their name and e-mail address in the commit log, or by using the `Author:` or `Co-authored-by:` metadata tag in the commits.\n\n_Adapted from the [ethers-rs contributing guide](https://github.com/gakonst/ethers-rs/blob/master/CONTRIBUTING.md)_.\n\n### Releasing\n\nReleases are automatically done by the release workflow when a tag is pushed, however, these steps still need to be taken:\n\n1. Ensure that the versions in the relevant `Cargo.toml` files are up-to-date.\n2. Update documentation links\n3. Perform a final audit for breaking changes.\n\n[rust-coc]: https://www.rust-lang.org/policies/code-of-conduct\n[dev-tg]: https://t.me/foundry_rs\n[foundry-book]: https://github.com/foundry-rs/foundry-book\n[support-tg]: https://t.me/foundry_support\n[mcve]: https://stackoverflow.com/help/mcve\n[hiding-a-comment]: https://docs.github.com/en/communities/moderating-comments-and-conversations/managing-disruptive-comments\n" }, { "path": "Cargo.toml", "content": "[workspace]\nmembers = [\n \"benches/\",\n \"crates/anvil/\",\n \"crates/anvil/core/\",\n \"crates/anvil/rpc/\",\n \"crates/anvil/server/\",\n \"crates/cast/\",\n \"crates/cheatcodes/\",\n \"crates/cheatcodes/spec/\",\n \"crates/chisel/\",\n \"crates/cli/\",\n \"crates/common/\",\n \"crates/config/\",\n \"crates/debugger/\",\n \"crates/doc/\",\n \"crates/evm/core/\",\n \"crates/evm/coverage/\",\n \"crates/evm/evm/\",\n \"crates/evm/fuzz/\",\n \"crates/evm/traces/\",\n \"crates/fmt/\",\n \"crates/forge/\",\n \"crates/lint/\",\n \"crates/macros/\",\n \"crates/primitives/\",\n \"crates/script-sequence/\",\n \"crates/test-utils/\",\n \"crates/cli-markdown/\",\n]\nresolver = \"2\"\n\n[workspace.package]\nversion = \"1.6.0\"\nedition = \"2024\"\nrust-version = \"1.89\"\nauthors = [\"Foundry Contributors\"]\nlicense = \"MIT OR Apache-2.0\"\nhomepage = \"https://getfoundry.sh\"\nrepository = \"https://github.com/foundry-rs/foundry\"\nexclude = [\"benches/\", \"tests/\", \"test-data/\", \"testdata/\"]\n\n[workspace.lints.clippy]\nborrow_as_ptr = \"warn\"\nbranches_sharing_code = \"warn\"\nclear_with_drain = \"warn\"\ncloned_instead_of_copied = \"warn\"\ncollection_is_never_read = \"warn\"\ndbg-macro = \"warn\"\nexplicit_iter_loop = \"warn\"\nmanual-string-new = \"warn\"\nuninlined-format-args = \"warn\"\nuse-self = \"warn\"\nredundant-clone = \"warn\"\noctal-escapes = \"allow\"\n# until is fixed\nliteral-string-with-formatting-args = \"allow\"\nresult_large_err = \"allow\"\n\n[workspace.lints.rust]\nredundant_imports = \"warn\"\nredundant-lifetimes = \"warn\"\nrust-2018-idioms = \"warn\"\nunused-must-use = \"warn\"\n# unreachable-pub = \"warn\"\n\n[workspace.lints.rustdoc]\nall = \"warn\"\n\n# Speed up compilation time for dev builds by reducing emitted debug info.\n# NOTE: Debuggers may provide less useful information with this setting.\n# Uncomment this section if you're using a debugger.\n[profile.dev]\n# https://davidlattimore.github.io/posts/2024/02/04/speeding-up-the-rust-edit-build-run-cycle.html\ndebug = \"line-tables-only\"\nsplit-debuginfo = \"unpacked\"\n\n[profile.release]\nopt-level = 3\nlto = \"thin\"\ndebug = \"none\"\nstrip = \"debuginfo\"\npanic = \"abort\"\ncodegen-units = 16\n\n# Use the `--profile profiling` flag to show symbols in release mode.\n# e.g. `cargo build --profile profiling`\n[profile.profiling]\ninherits = \"release\"\ndebug = \"full\"\nstrip = \"none\"\n\n[profile.bench]\ninherits = \"profiling\"\n\n[profile.dist]\ninherits = \"release\"\nlto = \"fat\"\ncodegen-units = 1\n\n# Speed up tests and dev build.\n[profile.dev.package]\n# Solc and artifacts.\nfoundry-compilers-artifacts-solc.opt-level = 3\nfoundry-compilers-core.opt-level = 3\nfoundry-compilers.opt-level = 3\nserde_json.opt-level = 3\nserde.opt-level = 3\n\nfoundry-solang-parser.opt-level = 3\nlalrpop-util.opt-level = 3\n\nsolar-compiler.opt-level = 3\nsolar-ast.opt-level = 3\nsolar-data-structures.opt-level = 3\nsolar-interface.opt-level = 3\nsolar-parse.opt-level = 3\nsolar-sema.opt-level = 3\n\n# CLI.\nclap.opt-level = 3\nclap_builder.opt-level = 3\nclap_lex.opt-level = 3\n\n# EVM.\nalloy-dyn-abi.opt-level = 3\nalloy-json-abi.opt-level = 3\nalloy-primitives.opt-level = 3\nalloy-sol-type-parser.opt-level = 3\nalloy-sol-types.opt-level = 3\nalloy-evm.opt-level = 3\n\nbitvec.opt-level = 3\nrevm.opt-level = 3\nrevm-bytecode.opt-level = 3\nrevm-context.opt-level = 3\nrevm-context-interface.opt-level = 3\nrevm-database.opt-level = 3\nrevm-database-interface.opt-level = 3\nrevm-handler.opt-level = 3\nrevm-inspector.opt-level = 3\nrevm-interpreter.opt-level = 3\nrevm-precompile.opt-level = 3\nrevm-primitives.opt-level = 3\nrevm-state.opt-level = 3\n\nrevm-inspectors.opt-level = 3\n\nruint.opt-level = 3\n\nsha2.opt-level = 3\nsha3.opt-level = 3\nkeccak.opt-level = 3\n\n# Fuzzing.\nproptest.opt-level = 3\nfoundry-evm-fuzz.opt-level = 3\nrand.opt-level = 3\nrand_chacha.opt-level = 3\nppv-lite86.opt-level = 3\n\n# Backtraces.\naddr2line.opt-level = 3\nbacktrace.opt-level = 3\ngimli.opt-level = 3\n\n# Forking.\naxum.opt-level = 3\n\n# Keystores.\nscrypt.opt-level = 3\n\n# Misc.\nhashbrown.opt-level = 3\nfoldhash.opt-level = 3\nrayon.opt-level = 3\nrayon-core.opt-level = 3\nregex.opt-level = 3\nregex-syntax.opt-level = 3\nregex-automata.opt-level = 3\nwalkdir.opt-level = 3\n\n# Override packages which aren't perf-sensitive for faster compilation speed and smaller binary size.\n[profile.release.package]\nalloy-sol-macro-expander.opt-level = \"s\"\nfigment2.opt-level = \"s\"\nfoundry-compilers-artifacts-solc.opt-level = \"s\"\nfoundry-config.opt-level = \"s\"\nhtml5ever.opt-level = \"s\"\nmdbook-driver.opt-level = \"s\"\nprettyplease.opt-level = \"s\"\nprotobuf.opt-level = \"s\"\npulldown-cmark.opt-level = \"s\"\nsyn-solidity.opt-level = \"s\"\nsyn.opt-level = \"s\"\ntrezor-client.opt-level = \"s\"\n\n# Networking stack (not perf-critical for CLI tools).\nreqwest.opt-level = \"s\"\nhyper.opt-level = \"s\"\nhyper-util.opt-level = \"s\"\nh2.opt-level = \"s\"\nrustls.opt-level = \"s\"\ntower.opt-level = \"s\"\ntower-http.opt-level = \"s\"\n\n# Doc generation / templating.\nmdbook-core.opt-level = \"s\"\nmdbook-html.opt-level = \"s\"\nfont-awesome-as-a-crate.opt-level = \"s\"\nhandlebars.opt-level = \"s\"\n\n# Watch mode.\nwatchexec.opt-level = \"s\"\nwatchexec-events.opt-level = \"s\"\nwatchexec-signals.opt-level = \"s\"\nwatchexec-supervisor.opt-level = \"s\"\n\n# Soldeer package manager.\nsoldeer-commands.opt-level = \"s\"\nsoldeer-core.opt-level = \"s\"\n\n# Parsing / editing (not perf-sensitive in CLI).\ntoml_edit.opt-level = \"s\"\ntoml.opt-level = \"s\"\n\n# Block explorers / verification.\nfoundry-block-explorers.opt-level = \"s\"\n\n# Misc CLI dependencies.\nclap_builder.opt-level = \"s\"\nclap_complete.opt-level = \"s\"\ncomfy-table.opt-level = \"s\"\nindicatif.opt-level = \"s\"\ndialoguer.opt-level = \"s\"\nratatui.opt-level = \"s\"\ncrossterm.opt-level = \"s\"\n\n# Alloy JSON (parsing, not hot path).\nalloy-json-abi.opt-level = \"s\"\n\n[workspace.dependencies]\nanvil = { path = \"crates/anvil\" }\ncast = { path = \"crates/cast\" }\nchisel = { path = \"crates/chisel\" }\nforge = { path = \"crates/forge\" }\n\nforge-doc = { path = \"crates/doc\" }\nforge-fmt = { path = \"crates/fmt\" }\nforge-lint = { path = \"crates/lint\" }\nforge-verify = { path = \"crates/verify\" }\nforge-script = { path = \"crates/script\" }\nforge-sol-macro-gen = { path = \"crates/sol-macro-gen\" }\nforge-script-sequence = { path = \"crates/script-sequence\" }\nfoundry-cheatcodes = { path = \"crates/cheatcodes\" }\nfoundry-cheatcodes-spec = { path = \"crates/cheatcodes/spec\" }\nfoundry-cli = { path = \"crates/cli\" }\nfoundry-cli-markdown = { path = \"crates/cli-markdown\" }\nfoundry-common = { path = \"crates/common\" }\nfoundry-common-fmt = { path = \"crates/common/fmt\" }\nfoundry-config = { path = \"crates/config\" }\nfoundry-debugger = { path = \"crates/debugger\" }\nfoundry-evm = { path = \"crates/evm/evm\" }\nfoundry-evm-abi = { path = \"crates/evm/abi\" }\nfoundry-evm-core = { path = \"crates/evm/core\" }\nfoundry-evm-coverage = { path = \"crates/evm/coverage\" }\nfoundry-evm-networks = { path = \"crates/evm/networks\" }\nfoundry-evm-fuzz = { path = \"crates/evm/fuzz\" }\nfoundry-evm-traces = { path = \"crates/evm/traces\" }\nfoundry-macros = { path = \"crates/macros\" }\nfoundry-test-utils = { path = \"crates/test-utils\" }\nfoundry-wallets = { path = \"crates/wallets\" }\nfoundry-linking = { path = \"crates/linking\" }\nfoundry-primitives = { path = \"crates/primitives\" }\n\n# solc & compilation utilities\nfoundry-block-explorers = { version = \"0.22.0\", default-features = false }\nfoundry-compilers = { version = \"0.19.14\", default-features = false, features = [\n \"rustls\",\n \"svm-solc\",\n] }\nfoundry-fork-db = \"0.23\"\nsolang-parser = { version = \"=0.3.9\", package = \"foundry-solang-parser\" }\nsolar = { package = \"solar-compiler\", version = \"=0.1.8\", default-features = false }\nsvm = { package = \"svm-rs\", version = \"0.5\", default-features = false, features = [\n \"rustls\",\n] }\n\n## alloy\nalloy-consensus = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-contract = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-eips = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-eip5792 = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-ens = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-genesis = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-json-rpc = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-network = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-provider = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-pubsub = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-rpc-client = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-rpc-types = { version = \"2.0.0-rc.0\", default-features = true }\nalloy-rpc-types-beacon = { version = \"2.0.0-rc.0\", default-features = true }\nalloy-rpc-types-eth = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-serde = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-signer = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-signer-aws = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-signer-gcp = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-signer-ledger = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-signer-local = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-signer-trezor = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-signer-turnkey = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-transport = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-transport-http = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-transport-ipc = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-transport-ws = { version = \"2.0.0-rc.0\", default-features = false }\nalloy-hardforks = { version = \"0.4.7\", default-features = false }\nalloy-op-hardforks = { version = \"0.4.7\", default-features = false }\n\n## alloy-core\nalloy-dyn-abi = \"1.5.2\"\nalloy-json-abi = \"1.5.2\"\nalloy-primitives = { version = \"1.5.2\", features = [\n \"getrandom\",\n \"rand\",\n \"map-fxhash\",\n \"map-foldhash\",\n] }\nalloy-sol-macro-expander = \"1.5.2\"\nalloy-sol-macro-input = \"1.5.2\"\nalloy-sol-types = \"1.5.2\"\n\nalloy-chains = \"0.2\"\nalloy-rlp = \"0.3\"\nalloy-trie = \"0.9\"\n\n## op-alloy\nop-alloy-consensus = \"0.24.0\"\nop-alloy-network = \"0.24.0\"\nop-alloy-rpc-types = \"0.24.0\"\nop-alloy-flz = \"0.13.1\"\n\n## alloy-evm\nalloy-evm = \"0.28.1\"\nalloy-op-evm = \"0.26.3\"\n\n# revm\nrevm = { version = \"34.0.0\", default-features = false }\nrevm-inspectors = { version = \"0.36.0\", features = [\"serde\"] }\nop-revm = { version = \"15.0.0\", default-features = false }\n\n## cli\nanstream = \"0.6\"\nanstyle = \"1.0\"\ndialoguer = { version = \"0.12\", default-features = false, features = [\n \"password\",\n] }\nclap_complete = \"4\"\nclap_complete_nushell = \"4\"\n\n# macros\nproc-macro2 = \"1.0\"\nquote = \"1.0\"\nsyn = \"2.0\"\nasync-trait = \"0.1\"\nderive_more = { version = \"2.1\", features = [\"full\"] }\nthiserror = \"2\"\n\n# allocators\nmimalloc = \"0.1\"\ntikv-jemallocator = \"0.6\"\n\n# misc\nauto_impl = \"1\"\nbytes = \"1.11\"\nwalkdir = \"2\"\nprettyplease = \"0.2\"\nbase64 = \"0.22\"\nchrono = { version = \"0.4\", default-features = false, features = [\n \"clock\",\n \"std\",\n] }\naxum = \"0.8\"\nciborium = \"0.2\"\ncolor-eyre = \"0.6\"\ncomfy-table = \"7\"\ndirs = \"6\"\ndunce = \"1\"\nevm-disassembler = \"0.6\"\nevmole = \"0.8\"\neyre = \"0.6\"\nfigment = { package = \"figment2\", version = \"0.11\" }\nfutures = { version = \"0.3\", default-features = false }\nhyper = \"1.8\"\nindicatif = \"0.18\"\nitertools = \"0.14\"\njsonpath_lib = \"0.3\"\nk256 = \"0.13\"\nmesc = \"0.3\"\nmemchr = \"2.7\"\nnum-format = \"0.4\"\nparking_lot = \"0.12\"\nproptest = \"1.9.0\"\nrand = \"0.9\"\nrand_08 = { package = \"rand\", version = \"0.8\" }\nrayon = \"1\"\nregex = { version = \"1\", default-features = false }\nreqwest = { version = \"0.13\", default-features = false, features = [\"rustls\"] }\nrustls = \"0.23\"\nsemver = \"1\"\nserde = { version = \"1.0\", features = [\"derive\"] }\nserde_json = { version = \"1.0\", features = [\"arbitrary_precision\"] }\nsimilar-asserts = \"1.7\"\nsoldeer-commands = \"=0.10.0\"\nsoldeer-core = { version = \"=0.10.0\", features = [\"serde\"] }\nstrum = \"0.27\"\ntempfile = \"3.23\"\ntokio = \"1\"\ntoml = \"0.9\"\ntoml_edit = \"0.24\"\ntower = \"0.5\"\ntower-http = \"0.6\"\ntracing = \"0.1\"\ntracing-subscriber = \"0.3\"\nurl = \"2\"\nvergen = { package = \"vergen-gitcl\", version = \"10.0.0-beta.5\", default-features = false, features = [\n \"build\",\n \"cargo\",\n] }\nyansi = { version = \"1.0\", features = [\"detect-tty\", \"detect-env\"] }\npath-slash = \"0.2\"\njiff = { version = \"0.2\", default-features = false, features = [\n \"std\",\n \"perf-inline\",\n] }\nheck = \"0.5\"\nuuid = \"1.19.0\"\nflate2 = \"1.1\"\nethereum_ssz = \"0.10\"\n\n# Tempo\ntempo-primitives = { git = \"https://github.com/tempoxyz/tempo\", branch = \"alloy-2.0\", default-features = false, features = [\"serde\"] }\ntempo-alloy = { git = \"https://github.com/tempoxyz/tempo\", branch = \"alloy-2.0\", default-features = false }\n\n## Pinned dependencies. Enabled for the workspace in crates/test-utils.\n\n# testing\nsnapbox = { version = \"0.6\", features = [\"json\", \"regex\", \"term-svg\"] }\n\n# Use unicode-rs which has a smaller binary size than the default ICU4X as the IDNA backend, used\n# by the `url` crate.\n# See the `idna_adapter` README.md for more details: https://docs.rs/crate/idna_adapter/latest\nidna_adapter = \"=1.1.0\"\n\n[patch.crates-io]\n# https://github.com/rust-cli/rexpect/pull/106\nrexpect = { git = \"https://github.com/rust-cli/rexpect\", rev = \"2ed0b1898d7edaf6a85bedbae71a01cc578958fc\" }\n\n## alloy-core\n# alloy-dyn-abi = { path = \"../../alloy-rs/core/crates/dyn-abi\" }\n# alloy-json-abi = { path = \"../../alloy-rs/core/crates/json-abi\" }\n# alloy-primitives = { path = \"../../alloy-rs/core/crates/primitives\" }\n# alloy-sol-macro = { path = \"../../alloy-rs/core/crates/sol-macro\" }\n# alloy-sol-macro-expander = { path = \"../../alloy-rs/core/crates/sol-macro-expander\" }\n# alloy-sol-macro-input = { path = \"../../alloy-rs/core/crates/sol-macro-input\" }\n# alloy-sol-type-parser = { path = \"../../alloy-rs/core/crates/sol-type-parser\" }\n# alloy-sol-types = { path = \"../../alloy-rs/core/crates/sol-types\" }\n# syn-solidity = { path = \"../../alloy-rs/core/crates/syn-solidity\" }\n\n## alloy\nalloy-consensus = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-contract = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-eips = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-eip5792 = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-ens = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-genesis = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-json-rpc = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-network = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-network-primitives = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-provider = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-pubsub = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-rpc-client = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-rpc-types = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-rpc-types-beacon = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-rpc-types-eth = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-rpc-types-trace = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-rpc-types-engine = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-serde = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-signer = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-signer-aws = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-signer-gcp = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-signer-ledger = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-signer-local = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-signer-trezor = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-signer-turnkey = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-transport = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-transport-http = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-transport-ipc = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\nalloy-transport-ws = { git = \"https://github.com/alloy-rs/alloy\", rev = \"100a3325ac4d624f3eb0bd404125750e76edf8ca\" }\n\n## alloy-evm\nalloy-evm = { git = \"https://github.com/alloy-rs/evm.git\", branch = \"alloy-2.0\" }\n\n## op-alloy / alloy-op-evm\nop-alloy-consensus = { git = \"https://github.com/foundry-rs/optimism\", branch = \"alloy-2.0\" }\nop-alloy-network = { git = \"https://github.com/foundry-rs/optimism\", branch = \"alloy-2.0\" }\nop-alloy-rpc-types = { git = \"https://github.com/foundry-rs/optimism\", branch = \"alloy-2.0\" }\nop-alloy = { git = \"https://github.com/foundry-rs/optimism\", branch = \"alloy-2.0\" }\nalloy-op-evm = { git = \"https://github.com/foundry-rs/optimism\", branch = \"alloy-2.0\" }\nalloy-op-hardforks = { git = \"https://github.com/foundry-rs/optimism\", branch = \"alloy-2.0\" }\n\n## revm\n# revm = { git = \"https://github.com/bluealloy/revm.git\", rev = \"7e59936\" }\n# op-revm = { git = \"https://github.com/bluealloy/revm.git\", rev = \"7e59936\" }\nrevm-inspectors = { git = \"https://github.com/paradigmxyz/revm-inspectors.git\", branch = \"alloy-2.0\" }\n\n## foundry\nfoundry-fork-db = { git = \"https://github.com/foundry-rs/foundry-fork-db\", branch = \"alloy-2.0\" }\n\n# solar\nsolar = { package = \"solar-compiler\", git = \"https://github.com/paradigmxyz/solar\", rev = \"530f129\" }\nsolar-interface = { package = \"solar-interface\", git = \"https://github.com/paradigmxyz/solar\", rev = \"530f129\" }\nsolar-ast = { package = \"solar-ast\", git = \"https://github.com/paradigmxyz/solar\", rev = \"530f129\" }\nsolar-sema = { package = \"solar-sema\", git = \"https://github.com/paradigmxyz/solar\", rev = \"530f129\" }" }, { "path": "Dockerfile", "content": "# syntax=docker/dockerfile:1\n\nFROM rust:1-bookworm AS chef\nWORKDIR /app\n\nRUN apt update && apt install -y build-essential libssl-dev git pkg-config curl perl\nRUN curl -L --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/cargo-bins/cargo-binstall/main/install-from-binstall-release.sh | sh\nRUN cargo binstall cargo-chef sccache\n\n# Prepare the cargo-chef recipe.\nFROM chef AS planner\nCOPY . .\nRUN cargo chef prepare --recipe-path recipe.json\n\n# Build the project.\nFROM chef AS builder\nCOPY --from=planner /app/recipe.json recipe.json\n\nARG RUST_PROFILE\nARG RUST_FEATURES\n\nENV CARGO_INCREMENTAL=0 \\\n RUSTC_WRAPPER=sccache \\\n SCCACHE_DIR=/sccache\n\n# Build dependencies.\nRUN --mount=type=cache,target=/usr/local/cargo/registry,sharing=shared \\\n --mount=type=cache,target=/usr/local/cargo/git,sharing=shared \\\n --mount=type=cache,target=$SCCACHE_DIR,sharing=shared \\\n cargo chef cook --recipe-path recipe.json --profile ${RUST_PROFILE} --no-default-features --features \"${RUST_FEATURES}\"\n\nARG TAG_NAME=\"dev\"\nENV TAG_NAME=$TAG_NAME\nARG VERGEN_GIT_SHA=\"ffffffffffffffffffffffffffffffffffffffff\"\nENV VERGEN_GIT_SHA=$VERGEN_GIT_SHA\n\n# Build the project.\nCOPY . .\nRUN --mount=type=cache,target=/usr/local/cargo/registry,sharing=shared \\\n --mount=type=cache,target=/usr/local/cargo/git,sharing=shared \\\n --mount=type=cache,target=$SCCACHE_DIR,sharing=shared \\\n cargo build --profile ${RUST_PROFILE} --no-default-features --features \"${RUST_FEATURES}\" \\\n && sccache --show-stats || true\n\n# `dev` profile outputs to the `target/debug` directory.\nRUN ln -s /app/target/debug /app/target/dev \\\n && mkdir -p /app/output \\\n && mv \\\n /app/target/${RUST_PROFILE}/forge \\\n /app/target/${RUST_PROFILE}/cast \\\n /app/target/${RUST_PROFILE}/anvil \\\n /app/target/${RUST_PROFILE}/chisel \\\n /app/output/\n\nFROM ubuntu:22.04 AS runtime\n\n# Install runtime dependencies.\nRUN apt update && apt install -y git\n\nCOPY --from=builder /app/output/* /usr/local/bin/\n\nRUN groupadd -g 1000 foundry && \\\n useradd -m -u 1000 -g foundry foundry\nUSER foundry\n\nENTRYPOINT [\"/bin/sh\", \"-c\"]\n\nLABEL org.label-schema.build-date=$BUILD_DATE \\\n org.label-schema.name=\"Foundry\" \\\n org.label-schema.description=\"Foundry\" \\\n org.label-schema.url=\"https://getfoundry.sh\" \\\n org.label-schema.vcs-ref=$VCS_REF \\\n org.label-schema.vcs-url=\"https://github.com/foundry-rs/foundry.git\" \\\n org.label-schema.vendor=\"Foundry-rs\" \\\n org.label-schema.version=$VERSION \\\n org.label-schema.schema-version=\"1.0\"\n" }, { "path": "FUNDING.json", "content": "{\n \"drips\": {\n \"ethereum\": {\n \"ownedBy\": \"0x86308c59a6005d012C51Eef104bBc21786aC5D2E\"\n }\n },\n \"opRetro\": {\n \"projectId\": \"0x4562c0630907577f433cad78c7e2cc03349d918b6c14ef982f11a2678f5999ad\"\n }\n}\n" }, { "path": "LICENSE-APACHE", "content": " Apache License\n Version 2.0, January 2004\n http://www.apache.org/licenses/\n\n TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION\n\n 1. Definitions.\n\n \"License\" shall mean the terms and conditions for use, reproduction,\n and distribution as defined by Sections 1 through 9 of this document.\n\n \"Licensor\" shall mean the copyright owner or entity authorized by\n the copyright owner that is granting the License.\n\n \"Legal Entity\" shall mean the union of the acting entity and all\n other entities that control, are controlled by, or are under common\n control with that entity. For the purposes of this definition,\n \"control\" means (i) the power, direct or indirect, to cause the\n direction or management of such entity, whether by contract or\n otherwise, or (ii) ownership of fifty percent (50%) or more of the\n outstanding shares, or (iii) beneficial ownership of such entity.\n\n \"You\" (or \"Your\") shall mean an individual or Legal Entity\n exercising permissions granted by this License.\n\n \"Source\" form shall mean the preferred form for making modifications,\n including but not limited to software source code, documentation\n source, and configuration files.\n\n \"Object\" form shall mean any form resulting from mechanical\n transformation or translation of a Source form, including but\n not limited to compiled object code, generated documentation,\n and conversions to other media types.\n\n \"Work\" shall mean the work of authorship, whether in Source or\n Object form, made available under the License, as indicated by a\n copyright notice that is included in or attached to the work\n (an example is provided in the Appendix below).\n\n \"Derivative Works\" shall mean any work, whether in Source or Object\n form, that is based on (or derived from) the Work and for which the\n editorial revisions, annotations, elaborations, or other modifications\n represent, as a whole, an original work of authorship. For the purposes\n of this License, Derivative Works shall not include works that remain\n separable from, or merely link (or bind by name) to the interfaces of,\n the Work and Derivative Works thereof.\n\n \"Contribution\" shall mean any work of authorship, including\n the original version of the Work and any modifications or additions\n to that Work or Derivative Works thereof, that is intentionally\n submitted to Licensor for inclusion in the Work by the copyright owner\n or by an individual or Legal Entity authorized to submit on behalf of\n the copyright owner. For the purposes of this definition, \"submitted\"\n means any form of electronic, verbal, or written communication sent\n to the Licensor or its representatives, including but not limited to\n communication on electronic mailing lists, source code control systems,\n and issue tracking systems that are managed by, or on behalf of, the\n Licensor for the purpose of discussing and improving the Work, but\n excluding communication that is conspicuously marked or otherwise\n designated in writing by the copyright owner as \"Not a Contribution.\"\n\n \"Contributor\" shall mean Licensor and any individual or Legal Entity\n on behalf of whom a Contribution has been received by Licensor and\n subsequently incorporated within the Work.\n\n 2. Grant of Copyright License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n copyright license to reproduce, prepare Derivative Works of,\n publicly display, publicly perform, sublicense, and distribute the\n Work and such Derivative Works in Source or Object form.\n\n 3. Grant of Patent License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n (except as stated in this section) patent license to make, have made,\n use, offer to sell, sell, import, and otherwise transfer the Work,\n where such license applies only to those patent claims licensable\n by such Contributor that are necessarily infringed by their\n Contribution(s) alone or by combination of their Contribution(s)\n with the Work to which such Contribution(s) was submitted. If You\n institute patent litigation against any entity (including a\n cross-claim or counterclaim in a lawsuit) alleging that the Work\n or a Contribution incorporated within the Work constitutes direct\n or contributory patent infringement, then any patent licenses\n granted to You under this License for that Work shall terminate\n as of the date such litigation is filed.\n\n 4. Redistribution. You may reproduce and distribute copies of the\n Work or Derivative Works thereof in any medium, with or without\n modifications, and in Source or Object form, provided that You\n meet the following conditions:\n\n (a) You must give any other recipients of the Work or\n Derivative Works a copy of this License; and\n\n (b) You must cause any modified files to carry prominent notices\n stating that You changed the files; and\n\n (c) You must retain, in the Source form of any Derivative Works\n that You distribute, all copyright, patent, trademark, and\n attribution notices from the Source form of the Work,\n excluding those notices that do not pertain to any part of\n the Derivative Works; and\n\n (d) If the Work includes a \"NOTICE\" text file as part of its\n distribution, then any Derivative Works that You distribute must\n include a readable copy of the attribution notices contained\n within such NOTICE file, excluding those notices that do not\n pertain to any part of the Derivative Works, in at least one\n of the following places: within a NOTICE text file distributed\n as part of the Derivative Works; within the Source form or\n documentation, if provided along with the Derivative Works; or,\n within a display generated by the Derivative Works, if and\n wherever such third-party notices normally appear. The contents\n of the NOTICE file are for informational purposes only and\n do not modify the License. You may add Your own attribution\n notices within Derivative Works that You distribute, alongside\n or as an addendum to the NOTICE text from the Work, provided\n that such additional attribution notices cannot be construed\n as modifying the License.\n\n You may add Your own copyright statement to Your modifications and\n may provide additional or different license terms and conditions\n for use, reproduction, or distribution of Your modifications, or\n for any such Derivative Works as a whole, provided Your use,\n reproduction, and distribution of the Work otherwise complies with\n the conditions stated in this License.\n\n 5. Submission of Contributions. Unless You explicitly state otherwise,\n any Contribution intentionally submitted for inclusion in the Work\n by You to the Licensor shall be under the terms and conditions of\n this License, without any additional terms or conditions.\n Notwithstanding the above, nothing herein shall supersede or modify\n the terms of any separate license agreement you may have executed\n with Licensor regarding such Contributions.\n\n 6. Trademarks. This License does not grant permission to use the trade\n names, trademarks, service marks, or product names of the Licensor,\n except as required for reasonable and customary use in describing the\n origin of the Work and reproducing the content of the NOTICE file.\n\n 7. Disclaimer of Warranty. Unless required by applicable law or\n agreed to in writing, Licensor provides the Work (and each\n Contributor provides its Contributions) on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or\n implied, including, without limitation, any warranties or conditions\n of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A\n PARTICULAR PURPOSE. You are solely responsible for determining the\n appropriateness of using or redistributing the Work and assume any\n risks associated with Your exercise of permissions under this License.\n\n 8. Limitation of Liability. In no event and under no legal theory,\n whether in tort (including negligence), contract, or otherwise,\n unless required by applicable law (such as deliberate and grossly\n negligent acts) or agreed to in writing, shall any Contributor be\n liable to You for damages, including any direct, indirect, special,\n incidental, or consequential damages of any character arising as a\n result of this License or out of the use or inability to use the\n Work (including but not limited to damages for loss of goodwill,\n work stoppage, computer failure or malfunction, or any and all\n other commercial damages or losses), even if such Contributor\n has been advised of the possibility of such damages.\n\n 9. Accepting Warranty or Additional Liability. While redistributing\n the Work or Derivative Works thereof, You may choose to offer,\n and charge a fee for, acceptance of support, warranty, indemnity,\n or other liability obligations and/or rights consistent with this\n License. However, in accepting such obligations, You may act only\n on Your own behalf and on Your sole responsibility, not on behalf\n of any other Contributor, and only if You agree to indemnify,\n defend, and hold each Contributor harmless for any liability\n incurred by, or claims asserted against, such Contributor by reason\n of your accepting any such warranty or additional liability.\n\n END OF TERMS AND CONDITIONS\n\n APPENDIX: How to apply the Apache License to your work.\n\n To apply the Apache License to your work, attach the following\n boilerplate notice, with the fields enclosed by brackets \"[]\"\n replaced with your own identifying information. (Don't include\n the brackets!) The text should be enclosed in the appropriate\n comment syntax for the file format. We also recommend that a\n file or class name and description of purpose be included on the\n same \"printed page\" as the copyright notice for easier\n identification within third-party archives." }, { "path": "LICENSE-MIT", "content": "Copyright (c) 2021 Georgios Konstantopoulos\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE." }, { "path": "Makefile", "content": "# Heavily inspired by:\n# - Lighthouse: https://github.com/sigp/lighthouse/blob/693886b94176faa4cb450f024696cb69cda2fe58/Makefile\n# - Reth: https://github.com/paradigmxyz/reth/blob/1f642353ca083b374851ab355b5d80207b36445c/Makefile\n.DEFAULT_GOAL := help\n\n# Cargo profile for builds.\nPROFILE ?= dev\n\n# The docker image name\nDOCKER_IMAGE_NAME ?= ghcr.io/foundry-rs/foundry:latest\n\nBIN_DIR = dist/bin\nCARGO_TARGET_DIR ?= target\n\n# List of features to use when building. Can be overridden via the environment.\n# No jemalloc on Windows\nifeq ($(OS),Windows_NT)\n FEATURES ?= aws-kms gcp-kms turnkey cli asm-keccak\nelse\n FEATURES ?= jemalloc aws-kms gcp-kms turnkey cli asm-keccak\nendif\n\n##@ Help\n\n.PHONY: help\nhelp: ## Display this help.\n\t@awk 'BEGIN {FS = \":.*##\"; printf \"Usage:\\n make \\033[36m\\033[0m\\n\"} /^[a-zA-Z_0-9-]+:.*?##/ { printf \" \\033[36m%-20s\\033[0m %s\\n\", $$1, $$2 } /^##@/ { printf \"\\n\\033[1m%s\\033[0m\\n\", substr($$0, 5) } ' $(MAKEFILE_LIST)\n\n##@ Build\n\n.PHONY: build\nbuild: ## Build the project.\n\tcargo build --features \"$(FEATURES)\" --profile \"$(PROFILE)\"\n\n.PHONY: build-docker\nbuild-docker: ## Build the docker image.\n\tdocker build . -t \"$(DOCKER_IMAGE_NAME)\" \\\n\t--build-arg \"RUST_PROFILE=$(PROFILE)\" \\\n\t--build-arg \"RUST_FEATURES=$(FEATURES)\" \\\n\t--build-arg \"TAG_NAME=dev\" \\\n\t--build-arg \"VERGEN_GIT_SHA=$(shell git rev-parse HEAD)\"\n\n##@ Test\n\n## Run unit/doc tests and generate html coverage report in `target/llvm-cov/html` folder.\n## Notice that `llvm-cov` supports doc tests only in nightly builds because the `--doc` flag\n## is unstable (https://github.com/taiki-e/cargo-llvm-cov/issues/2).\n.PHONY: test-coverage\ntest-coverage:\n\tcargo +nightly llvm-cov --no-report nextest -E 'kind(test) & !test(/\\b(issue|ext_integration|flaky_)/)' && \\\n\tcargo +nightly llvm-cov --no-report --doc && \\\n\tcargo +nightly llvm-cov report --doctests --open\n\n.PHONY: test-unit\ntest-unit: ## Run unit tests.\n\tcargo nextest run -E 'kind(test) & !test(/\\b(issue|ext_integration|flaky_)/)'\n\n.PHONY: test-doc\ntest-doc: ## Run doc tests.\n\tcargo test --doc --workspace\n\n.PHONY: test\ntest: ## Run all tests.\n\t$(MAKE) test-unit && \\\n\t$(MAKE) test-doc\n\n##@ Linting\n\n.PHONY: fmt\nfmt: ## Run all formatters.\n\tcargo +nightly fmt\n\t./.github/scripts/format.sh --check\n\n.PHONY: lint-clippy\nlint-clippy: ## Run clippy on the codebase.\n\tcargo +nightly clippy \\\n\t--workspace \\\n\t--all-targets \\\n\t--all-features \\\n\t-- -D warnings\n\n.PHONY: lint-clippy-fix\nlint-clippy-fix: ## Run clippy on the codebase and fix warnings.\n\tcargo +nightly clippy \\\n\t--workspace \\\n\t--all-targets \\\n\t--all-features \\\n\t--fix \\\n\t--allow-dirty \\\n\t--allow-staged \\\n\t-- -D warnings\n\n.PHONY: lint-typos\nlint-typos: ## Run typos on the codebase.\n\t@command -v typos >/dev/null || { \\\n\t\techo \"typos not found. Please install it by running the command `cargo install typos-cli` or refer to the following link for more information: https://github.com/crate-ci/typos\"; \\\n\t\texit 1; \\\n\t}\n\ttypos\n\n.PHONY: lint\nlint: ## Run all linters.\n\t$(MAKE) fmt && \\\n\t$(MAKE) lint-clippy && \\\n\t$(MAKE) lint-typos\n\n##@ Other\n\n.PHONY: clean\nclean: ## Clean the project.\n\tcargo clean\n\n.PHONY: deny\ndeny: ## Perform a `cargo` deny check.\n\tcargo deny --all-features check all\n\n.PHONY: pr\npr: ## Run all checks and tests.\n\t$(MAKE) deny && \\\n\t$(MAKE) lint && \\\n\t$(MAKE) test\n\n# dprint formatting commands\n.PHONY: dprint-fmt\ndprint-fmt: ## Format code with dprint\n\t@if ! command -v dprint > /dev/null; then \\\n\t\techo \"Installing dprint...\"; \\\n\t\tcargo install dprint; \\\n\tfi\n\tdprint fmt\n\n.PHONY: dprint-check\ndprint-check: ## Check formatting with dprint\n\t@if ! command -v dprint > /dev/null; then \\\n\t\techo \"Installing dprint...\"; \\\n\t\tcargo install dprint; \\\n\tfi\n\tdprint check\n" }, { "path": "README.md", "content": "
\n \"Foundry\n\n \n\n[![Github Actions][gha-badge]][gha-url] [![Telegram Chat][tg-badge]][tg-url] [![Telegram Support][tg-support-badge]][tg-support-url]\n\n[gha-badge]: https://img.shields.io/github/actions/workflow/status/foundry-rs/foundry/test.yml?branch=master&style=flat-square\n[gha-url]: https://github.com/foundry-rs/foundry/actions\n[tg-badge]: https://img.shields.io/endpoint?color=neon&logo=telegram&label=chat&style=flat-square&url=https%3A%2F%2Ftg.sumanjay.workers.dev%2Ffoundry_rs\n[tg-url]: https://t.me/foundry_rs\n[tg-support-badge]: https://img.shields.io/endpoint?color=neon&logo=telegram&label=support&style=flat-square&url=https%3A%2F%2Ftg.sumanjay.workers.dev%2Ffoundry_support\n[tg-support-url]: https://t.me/foundry_support\n\n**[Install](https://getfoundry.sh/getting-started/installation)**\n| [Docs][foundry-docs]\n| [Benchmarks](https://www.getfoundry.sh/benchmarks)\n| [Developer Guidelines](./docs/dev/README.md)\n| [Contributing](./CONTRIBUTING.md)\n| [Crate Docs](https://foundry-rs.github.io/foundry)\n\n
\n\n---\n\nBlazing fast, portable and modular toolkit for Ethereum application development, written in Rust.\n\n- [**Forge**](https://getfoundry.sh/forge) ā€” Build, test, fuzz, debug and deploy Solidity contracts.\n- [**Cast**](https://getfoundry.sh/cast) ā€” Swiss Army knife for interacting with EVM smart contracts, sending transactions and getting chain data.\n- [**Anvil**](https://getfoundry.sh/anvil) ā€” Fast local Ethereum development node.\n- [**Chisel**](https://getfoundry.sh/chisel) ā€” Fast, utilitarian and verbose Solidity REPL.\n\n![Demo](.github/assets/demo.gif)\n\n## Installation\n\n```sh\ncurl -L https://foundry.paradigm.xyz | bash\nfoundryup\n```\n\nSee the [installation guide](https://getfoundry.sh/getting-started/installation) for more details.\n\n## Getting Started\n\nInitialize a new project, build and test:\n\n```sh\nforge init counter && cd counter\nforge build\nforge test\n```\n\nInteract with a live network:\n\n```sh\ncast block-number --rpc-url https://eth.merkle.io\ncast balance vitalik.eth --ether --rpc-url https://eth.merkle.io\n```\n\nFork mainnet locally:\n\n```sh\nanvil --fork-url https://eth.merkle.io\n```\n\nRead the [Foundry Docs][foundry-docs] to learn more.\n\n## Contributing\n\nContributions are welcome and highly appreciated. To get started, check out the [contributing guidelines](./CONTRIBUTING.md).\n\nJoin our [Telegram][tg-url] to chat about the development of Foundry.\n\n## Support\n\nHaving trouble? Check the [Foundry Docs][foundry-docs], join the [support Telegram][tg-support-url], or [open an issue](https://github.com/foundry-rs/foundry/issues/new).\n\n#### License\n\n\nLicensed under either of Apache License, Version\n2.0 or MIT license at your option.\n\n\n
\n\n\nUnless you explicitly state otherwise, any contribution intentionally submitted\nfor inclusion in these crates by you, as defined in the Apache-2.0 license,\nshall be dual licensed as above, without any additional terms or conditions.\n\n\n[foundry-docs]: https://getfoundry.sh\n" }, { "path": "SECURITY.md", "content": "# Security Policy\n\n## Reporting a Vulnerability\n\nContact [security@ithaca.xyz](mailto:security@ithaca.xyz).\n" }, { "path": "benches/Cargo.toml", "content": "[package]\nname = \"foundry-bench\"\ndescription = \"Foundry benchmark runner\"\n\nversion.workspace = true\nedition.workspace = true\nrust-version.workspace = true\nauthors.workspace = true\nlicense.workspace = true\nhomepage.workspace = true\nrepository.workspace = true\n\n[lints]\nworkspace = true\n\n[[bin]]\nname = \"foundry-bench\"\npath = \"src/main.rs\"\n\n[dependencies]\nfoundry-test-utils.workspace = true\nfoundry-common.workspace = true\nfoundry-compilers = { workspace = true, features = [\"project-util\"] }\neyre.workspace = true\ncolor-eyre.workspace = true\nserde.workspace = true\nserde_json.workspace = true\nchrono = { version = \"0.4\", features = [\"serde\"] }\nrayon.workspace = true\nclap = { version = \"4\", features = [\"derive\"] }\nonce_cell = \"1.21\"\n" }, { "path": "benches/LATEST.md", "content": "# Foundry Benchmark Results\n\n**Date**: 2025-10-02 12:14:23\n\n## Repositories Tested\n\n1. [ithacaxyz/account](https://github.com/ithacaxyz/account)\n2. [Vectorized/solady](https://github.com/Vectorized/solady)\n3. [Uniswap/v4-core](https://github.com/Uniswap/v4-core)\n4. [sparkdotfi/spark-psm](https://github.com/sparkdotfi/spark-psm)\n\n## Foundry Versions\n\n- **v1.3.6**: forge Version: 1.3.6-v1.3.6 (d241588 2025-09-16)\n- **v1.4.0-rc1**: forge Version: 1.4.0-v1.4.0-rc1 (bd0e4a7 2025-10-01)\n\n## Forge Test\n\n| Repository | v1.3.6 | v1.4.0-rc1 |\n| -------------------- | ------- | ---------- |\n| ithacaxyz-account | 3.17 s | 2.94 s |\n| solady | 2.28 s | 2.10 s |\n| Uniswap-v4-core | 7.27 s | 6.13 s |\n| sparkdotfi-spark-psm | 43.04 s | 44.08 s |\n\n## Forge Fuzz Test\n\n| Repository | v1.3.6 | v1.4.0-rc1 |\n| -------------------- | ------ | ---------- |\n| ithacaxyz-account | 3.18 s | 3.02 s |\n| solady | 2.39 s | 2.24 s |\n| Uniswap-v4-core | 6.84 s | 6.20 s |\n| sparkdotfi-spark-psm | 3.07 s | 2.72 s |\n\n## Forge Test (Isolated)\n\n| Repository | v1.3.6 | v1.4.0-rc1 |\n| -------------------- | ------- | ---------- |\n| solady | 2.26 s | 2.41 s |\n| Uniswap-v4-core | 7.22 s | 7.71 s |\n| sparkdotfi-spark-psm | 45.53 s | 50.49 s |\n\n## Forge Build (No Cache)\n\n| Repository | v1.3.6 | v1.4.0-rc1 |\n| -------------------- | ------- | ---------- |\n| ithacaxyz-account | 9.16 s | 9.08 s |\n| solady | 14.62 s | 14.69 s |\n| Uniswap-v4-core | 2m 3.8s | 2m 5.3s |\n| sparkdotfi-spark-psm | 13.17 s | 13.14 s |\n\n## Forge Build (With Cache)\n\n| Repository | v1.3.6 | v1.4.0-rc1 |\n| -------------------- | ------- | ---------- |\n| ithacaxyz-account | 0.156 s | 0.113 s |\n| solady | 0.089 s | 0.094 s |\n| Uniswap-v4-core | 0.133 s | 0.127 s |\n| sparkdotfi-spark-psm | 0.173 s | 0.131 s |\n\n## Forge Coverage\n\n| Repository | v1.3.6 | v1.4.0-rc1 |\n| -------------------- | -------- | ---------- |\n| ithacaxyz-account | 14.91 s | 13.34 s |\n| Uniswap-v4-core | 1m 34.8s | 1m 30.3s |\n| sparkdotfi-spark-psm | 3m 49.3s | 3m 40.2s |\n\n## System Information\n\n- **OS**: macos\n- **CPU**: 8\n- **Rustc**: rustc 1.90.0-nightly (3014e79f9 2025-07-15)\n" }, { "path": "benches/README.md", "content": "# Foundry Benchmarks\n\nThis directory contains performance benchmarks for Foundry commands across multiple repositories and Foundry versions.\n\n## Prerequisites\n\nBefore running the benchmarks, ensure you have the following installed:\n\n1. **Rust and Cargo** - Required for building the benchmark binary\n\n ```bash\n curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh\n ```\n\n2. **Foundryup** - The Foundry toolchain installer\n\n ```bash\n curl -L https://foundry.paradigm.xyz | bash\n foundryup\n ```\n\n3. **Git** - For cloning benchmark repositories\n\n4. [**Hyperfine**](https://github.com/sharkdp/hyperfine/blob/master/README.md) - The benchmarking tool used by foundry-bench\n\n5. **Node.js and npm** - Some repositories require npm dependencies\n\n## Running Benchmarks\n\nBuild and install the benchmark runner:\n\n```bash\ncargo build --release --bin foundry-bench\n```\n\nTo install `foundry-bench` to your PATH:\n\n```bash\ncd benches && cargo install --path . --bin foundry-bench\n```\n\n#### Run with default settings\n\n```bash\n# Run all benchmarks on default repos with stable and nightly versions\nfoundry-bench --versions stable,nightly\n```\n\n#### Run with custom configurations\n\n```bash\n# Bench specific versions\nfoundry-bench --versions stable,nightly,v1.0.0\n\n# Run on specific repositories. Default rev for the repo is \"main\"\nfoundry-bench --repos ithacaxyz/account,Vectorized/solady\n\n# Test specific repository with custom revision\nfoundry-bench --repos ithacaxyz/account:main,Vectorized/solady:v0.0.123\n\n# Run only specific benchmarks\nfoundry-bench --benchmarks forge_build_with_cache,forge_test\n\n# Run only fuzz tests\nfoundry-bench --benchmarks forge_fuzz_test\n\n# Run coverage benchmark\nfoundry-bench --benchmarks forge_coverage\n\n# Combine options\nfoundry-bench \\\n --versions stable,nightly \\\n --repos ithacaxyz/account \\\n --benchmarks forge_build_with_cache\n\n# Force install Foundry versions\nfoundry-bench --force-install\n\n# Verbose output to see hyperfine logs\nfoundry-bench --verbose\n\n# Output to specific directory\nfoundry-bench --output-dir ./results --output-file LATEST_RESULTS.md\n```\n\n#### Command-line Options\n\n- `--versions ` - Comma-separated list of Foundry versions (default: stable,nightly)\n- `--repos ` - Comma-separated list of repos in org/repo[:rev] format (default: ithacaxyz/account:v0.3.2,Vectorized/solady:v0.1.22)\n- `--benchmarks ` - Comma-separated list of benchmarks to run\n- `--force-install` - Force installation of Foundry versions\n- `--verbose` - Show detailed benchmark output\n- `--output-dir ` - Directory for output files (default: benches)\n- `--output-file ` - Name of the output file (default: LATEST.md)\n\n## Benchmark Structure\n\n- `forge_test` - Benchmarks `forge test` command across repos\n- `forge_build_no_cache` - Benchmarks `forge build` with clean cache\n- `forge_build_with_cache` - Benchmarks `forge build` with existing cache\n- `forge_fuzz_test` - Benchmarks `forge test` with only fuzz tests (tests with parameters)\n- `forge_coverage` - Benchmarks `forge coverage --ir-minimum` command across repos\n\n## Configuration\n\nThe benchmark binary uses command-line arguments to configure which repositories and versions to test. The default repositories are:\n\n- `ithacaxyz/account:v0.3.2`\n- `Vectorized/solady:v0.1.22`\n\nYou can override these using the `--repos` flag with the format `org/repo[:rev]`.\n\n## Results\n\nBenchmark results are saved to `benches/LATEST.md` (or custom output file specified with `--output-file`). The report includes:\n\n- Summary of versions and repositories tested\n- Performance comparison tables for each benchmark type showing:\n - Mean execution time\n - Min/Max times\n - Standard deviation\n - Relative performance comparison between versions\n- System information (OS, CPU cores)\n- Detailed hyperfine benchmark results in JSON format\n\n## Troubleshooting\n\n1. **Foundry version not found**: Use `--force-install` flag or manually install with `foundryup --install `\n2. **Repository clone fails**: Check network connectivity and repository access\n3. **Build failures**: Some repositories may have specific dependencies - check their README files\n4. **Hyperfine not found**: Install hyperfine using the instructions in Prerequisites\n5. **npm/Node.js errors**: Ensure Node.js and npm are installed for repositories that require them\n" }, { "path": "benches/src/lib.rs", "content": "//! Foundry benchmark runner.\n\nuse crate::results::{HyperfineOutput, HyperfineResult};\nuse eyre::{Result, WrapErr};\nuse foundry_common::{sh_eprintln, sh_println};\nuse foundry_compilers::project_util::TempProject;\nuse foundry_test_utils::util::clone_remote;\nuse once_cell::sync::Lazy;\nuse std::{\n path::{Path, PathBuf},\n process::Command,\n str::FromStr,\n};\n\npub mod results;\n\n/// Default number of runs for benchmarks\npub const RUNS: u32 = 5;\n\n/// Configuration for repositories to benchmark\n#[derive(Debug, Clone)]\npub struct RepoConfig {\n pub name: String,\n pub org: String,\n pub repo: String,\n pub rev: String,\n}\n\nimpl FromStr for RepoConfig {\n type Err = eyre::Error;\n\n fn from_str(spec: &str) -> Result {\n // Split by ':' first to separate repo path from optional rev\n let parts: Vec<&str> = spec.splitn(2, ':').collect();\n let repo_path = parts[0];\n let custom_rev = parts.get(1).copied();\n\n // Now split the repo path by '/'\n let path_parts: Vec<&str> = repo_path.split('/').collect();\n if path_parts.len() != 2 {\n eyre::bail!(\"Invalid repo format '{}'. Expected 'org/repo' or 'org/repo:rev'\", spec);\n }\n\n let org = path_parts[0];\n let repo = path_parts[1];\n\n // Try to find this repo in BENCHMARK_REPOS to get the full config\n let existing_config = BENCHMARK_REPOS.iter().find(|r| r.org == org && r.repo == repo);\n\n let config = if let Some(existing) = existing_config {\n // Use existing config but allow custom rev to override\n let mut config = existing.clone();\n if let Some(rev) = custom_rev {\n config.rev = rev.to_string();\n }\n config\n } else {\n // Create new config with custom rev or default\n // Name should follow the format: org-repo (with hyphen)\n Self {\n name: format!(\"{org}-{repo}\"),\n org: org.to_string(),\n repo: repo.to_string(),\n rev: custom_rev.unwrap_or(\"main\").to_string(),\n }\n };\n\n let _ = sh_println!(\"Parsed repo spec '{spec}' -> {config:?}\");\n Ok(config)\n }\n}\n\n/// Available repositories for benchmarking\npub fn default_benchmark_repos() -> Vec {\n vec![\n RepoConfig {\n name: \"ithacaxyz-account\".to_string(),\n org: \"ithacaxyz\".to_string(),\n repo: \"account\".to_string(),\n rev: \"main\".to_string(),\n },\n RepoConfig {\n name: \"solady\".to_string(),\n org: \"Vectorized\".to_string(),\n repo: \"solady\".to_string(),\n rev: \"main\".to_string(),\n },\n ]\n}\n\n// Keep a lazy static for compatibility\npub static BENCHMARK_REPOS: Lazy> = Lazy::new(default_benchmark_repos);\n\n/// Foundry versions to benchmark\n///\n/// To add more versions for comparison, install them first:\n/// ```bash\n/// foundryup --install stable\n/// foundryup --install nightly\n/// foundryup --install v0.2.0 # Example specific version\n/// ```\n///\n/// Then add the version strings to this array. Supported formats:\n/// - \"stable\" - Latest stable release\n/// - \"nightly\" - Latest nightly build\n/// - \"v0.2.0\" - Specific version tag\n/// - \"commit-hash\" - Specific commit hash\n/// - \"nightly-rev\" - Nightly build with specific revision\npub static FOUNDRY_VERSIONS: &[&str] = &[\"stable\", \"nightly\"];\n\n/// A benchmark project that represents a cloned repository ready for testing\npub struct BenchmarkProject {\n pub name: String,\n pub temp_project: TempProject,\n pub root_path: PathBuf,\n}\n\nimpl BenchmarkProject {\n /// Set up a benchmark project by cloning the repository\n #[allow(unused_must_use)]\n pub fn setup(config: &RepoConfig) -> Result {\n let temp_project =\n TempProject::dapptools().wrap_err(\"Failed to create temporary project\")?;\n\n // Get root path before clearing\n let root_path = temp_project.root().to_path_buf();\n let root = root_path.to_str().unwrap();\n\n // Remove all files in the directory\n for entry in std::fs::read_dir(&root_path)? {\n let entry = entry?;\n let path = entry.path();\n if path.is_dir() {\n std::fs::remove_dir_all(&path).ok();\n } else {\n std::fs::remove_file(&path).ok();\n }\n }\n\n // Clone the repository\n let repo_url = format!(\"https://github.com/{}/{}.git\", config.org, config.repo);\n clone_remote(&repo_url, root, true);\n\n // Checkout specific revision if provided\n if !config.rev.is_empty() && config.rev != \"main\" && config.rev != \"master\" {\n let status = Command::new(\"git\")\n .current_dir(root)\n .args([\"checkout\", &config.rev])\n .status()\n .wrap_err(\"Failed to checkout revision\")?;\n\n if !status.success() {\n eyre::bail!(\"Git checkout failed for {}\", config.name);\n }\n }\n\n // Git submodules are already cloned via --recursive flag\n // But npm dependencies still need to be installed\n Self::install_npm_dependencies(&root_path)?;\n\n sh_println!(\" āœ… Project {} setup complete at {}\", config.name, root);\n Ok(Self { name: config.name.to_string(), root_path, temp_project })\n }\n\n /// Install npm dependencies if package.json exists\n #[allow(unused_must_use)]\n fn install_npm_dependencies(root: &Path) -> Result<()> {\n if root.join(\"package.json\").exists() {\n sh_println!(\" šŸ“¦ Running npm install...\");\n let status = Command::new(\"npm\")\n .current_dir(root)\n .args([\"install\"])\n .stdout(std::process::Stdio::inherit())\n .stderr(std::process::Stdio::inherit())\n .status()\n .wrap_err(\"Failed to run npm install\")?;\n\n if !status.success() {\n sh_println!(\n \" āš ļø Warning: npm install failed with exit code: {:?}\",\n status.code()\n );\n } else {\n sh_println!(\" āœ… npm install completed successfully\");\n }\n }\n Ok(())\n }\n\n /// Run a command with hyperfine and return the results\n ///\n /// # Arguments\n /// * `benchmark_name` - Name of the benchmark for organizing output\n /// * `version` - Foundry version being benchmarked\n /// * `command` - The command to benchmark\n /// * `runs` - Number of runs to perform\n /// * `setup` - Optional setup command to run before the benchmark series (e.g., \"forge build\")\n /// * `prepare` - Optional prepare command to run before each timing run (e.g., \"forge clean\")\n /// * `conclude` - Optional conclude command to run after each timing run (e.g., cleanup)\n /// * `verbose` - Whether to show command output\n ///\n /// # Hyperfine flags used:\n /// * `--runs` - Number of timing runs\n /// * `--setup` - Execute before the benchmark series (not before each run)\n /// * `--prepare` - Execute before each timing run\n /// * `--conclude` - Execute after each timing run\n /// * `--export-json` - Export results to JSON for parsing\n /// * `--shell=bash` - Use bash for shell command execution\n /// * `--show-output` - Show command output (when verbose)\n #[allow(clippy::too_many_arguments)]\n fn hyperfine(\n &self,\n benchmark_name: &str,\n version: &str,\n command: &str,\n runs: u32,\n setup: Option<&str>,\n prepare: Option<&str>,\n conclude: Option<&str>,\n verbose: bool,\n ) -> Result {\n // Create structured temp directory for JSON output\n // Format: ////.json\n let temp_dir = std::env::temp_dir();\n let json_dir =\n temp_dir.join(\"foundry-bench\").join(benchmark_name).join(version).join(&self.name);\n std::fs::create_dir_all(&json_dir)?;\n\n let json_path = json_dir.join(format!(\"{benchmark_name}.json\"));\n\n // Build hyperfine command\n let mut hyperfine_cmd = Command::new(\"hyperfine\");\n hyperfine_cmd\n .current_dir(&self.root_path)\n .arg(\"--runs\")\n .arg(runs.to_string())\n .arg(\"--export-json\")\n .arg(&json_path)\n .arg(\"--shell=bash\");\n\n // Add optional setup command\n if let Some(setup_cmd) = setup {\n hyperfine_cmd.arg(\"--setup\").arg(setup_cmd);\n }\n\n // Add optional prepare command\n if let Some(prepare_cmd) = prepare {\n hyperfine_cmd.arg(\"--prepare\").arg(prepare_cmd);\n }\n\n // Add optional conclude command\n if let Some(conclude_cmd) = conclude {\n hyperfine_cmd.arg(\"--conclude\").arg(conclude_cmd);\n }\n\n if verbose {\n hyperfine_cmd.arg(\"--show-output\");\n hyperfine_cmd.stderr(std::process::Stdio::inherit());\n hyperfine_cmd.stdout(std::process::Stdio::inherit());\n }\n\n // Add the benchmark command last\n hyperfine_cmd.arg(command);\n\n let status = hyperfine_cmd.status().wrap_err(\"Failed to run hyperfine\")?;\n if !status.success() {\n eyre::bail!(\"Hyperfine failed for command: {}\", command);\n }\n\n // Read and parse the JSON output\n let json_content = std::fs::read_to_string(json_path)?;\n let output: HyperfineOutput = serde_json::from_str(&json_content)?;\n\n // Extract the first result (we only run one command at a time)\n output.results.into_iter().next().ok_or_else(|| eyre::eyre!(\"No results from hyperfine\"))\n }\n\n /// Benchmark forge test\n pub fn bench_forge_test(\n &self,\n version: &str,\n runs: u32,\n verbose: bool,\n ) -> Result {\n // Build before running tests\n self.hyperfine(\n \"forge_test\",\n version,\n \"forge test\",\n runs,\n Some(\"forge build\"),\n None,\n None,\n verbose,\n )\n }\n\n /// Benchmark forge build with cache\n pub fn bench_forge_build_with_cache(\n &self,\n version: &str,\n runs: u32,\n verbose: bool,\n ) -> Result {\n self.hyperfine(\n \"forge_build_with_cache\",\n version,\n \"FOUNDRY_LINT_LINT_ON_BUILD=false forge build\",\n runs,\n None,\n Some(\"forge build\"),\n None,\n verbose,\n )\n }\n\n /// Benchmark forge build without cache\n pub fn bench_forge_build_no_cache(\n &self,\n version: &str,\n runs: u32,\n verbose: bool,\n ) -> Result {\n // Clean before each timing run\n self.hyperfine(\n \"forge_build_no_cache\",\n version,\n \"FOUNDRY_LINT_LINT_ON_BUILD=false forge build\",\n runs,\n Some(\"forge clean\"),\n None,\n Some(\"forge clean\"),\n verbose,\n )\n }\n\n /// Benchmark forge fuzz tests\n pub fn bench_forge_fuzz_test(\n &self,\n version: &str,\n runs: u32,\n verbose: bool,\n ) -> Result {\n // Build before running fuzz tests\n self.hyperfine(\n \"forge_fuzz_test\",\n version,\n r#\"forge test --match-test \"test[^(]*\\([^)]+\\)\"\"#,\n runs,\n Some(\"forge build\"),\n None,\n None,\n verbose,\n )\n }\n\n /// Benchmark forge coverage\n pub fn bench_forge_coverage(\n &self,\n version: &str,\n runs: u32,\n verbose: bool,\n ) -> Result {\n // No setup needed, forge coverage builds internally\n // Use --ir-minimum to avoid \"Stack too deep\" errors\n self.hyperfine(\n \"forge_coverage\",\n version,\n \"forge coverage --ir-minimum\",\n runs,\n None,\n None,\n None,\n verbose,\n )\n }\n\n /// Benchmark forge test with --isolate flag\n pub fn bench_forge_isolate_test(\n &self,\n version: &str,\n runs: u32,\n verbose: bool,\n ) -> Result {\n // Build before running tests\n self.hyperfine(\n \"forge_isolate_test\",\n version,\n \"forge test --isolate\",\n runs,\n Some(\"forge build\"),\n None,\n None,\n verbose,\n )\n }\n\n /// Get the root path of the project\n pub fn root(&self) -> &Path {\n &self.root_path\n }\n\n /// Run a specific benchmark by name\n pub fn run(\n &self,\n benchmark: &str,\n version: &str,\n runs: u32,\n verbose: bool,\n ) -> Result {\n match benchmark {\n \"forge_test\" => self.bench_forge_test(version, runs, verbose),\n \"forge_build_no_cache\" => self.bench_forge_build_no_cache(version, runs, verbose),\n \"forge_build_with_cache\" => self.bench_forge_build_with_cache(version, runs, verbose),\n \"forge_fuzz_test\" => self.bench_forge_fuzz_test(version, runs, verbose),\n \"forge_coverage\" => self.bench_forge_coverage(version, runs, verbose),\n \"forge_isolate_test\" => self.bench_forge_isolate_test(version, runs, verbose),\n _ => eyre::bail!(\"Unknown benchmark: {}\", benchmark),\n }\n }\n}\n\n/// Switch to a specific foundry version\n#[allow(unused_must_use)]\npub fn switch_foundry_version(version: &str) -> Result<()> {\n let output = Command::new(\"foundryup\")\n .args([\"--use\", version])\n .output()\n .wrap_err(\"Failed to run foundryup\")?;\n\n // Check if the error is about forge --version failing\n let stderr = String::from_utf8_lossy(&output.stderr);\n if stderr.contains(\"command failed\") && stderr.contains(\"forge --version\") {\n eyre::bail!(\n \"Foundry binaries maybe corrupted. Please reinstall by running `foundryup --install `\"\n );\n }\n\n if !output.status.success() {\n sh_eprintln!(\"foundryup stderr: {stderr}\");\n eyre::bail!(\"Failed to switch to foundry version: {}\", version);\n }\n\n sh_println!(\" Successfully switched to version: {version}\");\n Ok(())\n}\n\n/// Get the current forge version\npub fn get_forge_version() -> Result {\n let output = Command::new(\"forge\")\n .args([\"--version\"])\n .output()\n .wrap_err(\"Failed to get forge version\")?;\n\n if !output.status.success() {\n eyre::bail!(\"forge --version failed\");\n }\n\n let version =\n String::from_utf8(output.stdout).wrap_err(\"Invalid UTF-8 in forge version output\")?;\n\n Ok(version.lines().next().unwrap_or(\"unknown\").to_string())\n}\n\n/// Get the full forge version details including commit hash and date\npub fn get_forge_version_details() -> Result {\n let output = Command::new(\"forge\")\n .args([\"--version\"])\n .output()\n .wrap_err(\"Failed to get forge version\")?;\n\n if !output.status.success() {\n eyre::bail!(\"forge --version failed\");\n }\n\n let full_output =\n String::from_utf8(output.stdout).wrap_err(\"Invalid UTF-8 in forge version output\")?;\n\n // Extract relevant lines and format them\n let lines: Vec<&str> = full_output.lines().collect();\n if lines.len() >= 3 {\n // Extract version, commit, and timestamp\n let version = lines[0].trim();\n let commit = lines[1].trim().replace(\"Commit SHA: \", \"\");\n let timestamp = lines[2].trim().replace(\"Build Timestamp: \", \"\");\n\n // Format as: \"forge 1.2.3-nightly (51650ea 2025-06-27)\"\n let short_commit = &commit[..7]; // First 7 chars of commit hash\n let date = timestamp.split('T').next().unwrap_or(×tamp);\n\n Ok(format!(\"{version} ({short_commit} {date})\"))\n } else {\n // Fallback to just the first line if format is unexpected\n Ok(lines.first().unwrap_or(&\"unknown\").to_string())\n }\n}\n" }, { "path": "benches/src/main.rs", "content": "use clap::Parser;\nuse eyre::{Result, WrapErr};\nuse foundry_bench::{\n BENCHMARK_REPOS, BenchmarkProject, FOUNDRY_VERSIONS, RUNS, RepoConfig, get_forge_version,\n get_forge_version_details,\n results::{BenchmarkResults, HyperfineResult},\n switch_foundry_version,\n};\nuse foundry_common::sh_println;\nuse rayon::prelude::*;\nuse std::{fs, path::PathBuf, process::Command, sync::Mutex};\n\nconst ALL_BENCHMARKS: [&str; 6] = [\n \"forge_test\",\n \"forge_build_no_cache\",\n \"forge_build_with_cache\",\n \"forge_fuzz_test\",\n \"forge_coverage\",\n \"forge_isolate_test\",\n];\n\n/// Foundry Benchmark Runner\n#[derive(Parser, Debug)]\n#[clap(name = \"foundry-bench\", about = \"Run Foundry benchmarks across multiple versions\")]\nstruct Cli {\n /// Comma-separated list of Foundry versions to test (e.g., stable,nightly,v1.2.0)\n #[clap(long, value_delimiter = ',')]\n versions: Option>,\n\n /// Force install Foundry versions\n #[clap(long)]\n force_install: bool,\n\n /// Show verbose output\n #[clap(long)]\n verbose: bool,\n\n /// Directory where the aggregated benchmark results will be written.\n #[clap(long, default_value = \".\")]\n output_dir: PathBuf,\n\n /// Name of the output file (default: LATEST.md)\n #[clap(long, default_value = \"LATEST.md\")]\n output_file: String,\n\n /// Run only specific benchmarks (comma-separated:\n /// forge_test,forge_build_no_cache,forge_build_with_cache,forge_fuzz_test,forge_coverage)\n #[clap(long, value_delimiter = ',')]\n benchmarks: Option>,\n\n /// Run only on specific repositories (comma-separated in org/repo[:rev] format:\n /// ithacaxyz/account,Vectorized/solady:main,foundry-rs/foundry:v1.0.0)\n #[clap(long, value_delimiter = ',')]\n repos: Option>,\n}\n\n/// Mutex to prevent concurrent foundryup calls\nstatic FOUNDRY_LOCK: Mutex<()> = Mutex::new(());\nfn switch_version_safe(version: &str) -> Result<()> {\n let _lock = FOUNDRY_LOCK.lock().unwrap();\n switch_foundry_version(version)\n}\n\n#[allow(unused_must_use)]\nfn main() -> Result<()> {\n color_eyre::install()?;\n let cli = Cli::parse();\n\n // Check if hyperfine is installed\n let hyperfine_check = Command::new(\"hyperfine\").arg(\"--version\").output();\n if hyperfine_check.is_err() || !hyperfine_check.unwrap().status.success() {\n eyre::bail!(\n \"hyperfine is not installed. Please install it first: https://github.com/sharkdp/hyperfine\"\n );\n }\n\n // Determine versions to test\n let versions = if let Some(v) = cli.versions {\n v\n } else {\n FOUNDRY_VERSIONS.iter().map(|&s| s.to_string()).collect()\n };\n\n // Get repo configurations\n let repos = if let Some(repo_specs) = cli.repos.clone() {\n repo_specs.iter().map(|spec| spec.parse::()).collect::>>()?\n } else {\n BENCHMARK_REPOS.clone()\n };\n\n sh_println!(\"šŸš€ Foundry Benchmark Runner\");\n sh_println!(\"Running with versions: {}\", versions.join(\", \"));\n sh_println!(\n \"Running on repos: {}\",\n repos.iter().map(|r| format!(\"{}/{}\", r.org, r.repo)).collect::>().join(\", \")\n );\n\n // Install versions if requested\n if cli.force_install {\n install_foundry_versions(&versions)?;\n }\n\n // Determine benchmarks to run\n let benchmarks = if let Some(b) = cli.benchmarks {\n b.into_iter().filter(|b| ALL_BENCHMARKS.contains(&b.as_str())).collect()\n } else {\n // Default: run all benchmarks except fuzz tests and coverage (which can be slow)\n vec![\"forge_test\", \"forge_build_no_cache\", \"forge_build_with_cache\"]\n .into_iter()\n .map(String::from)\n .collect::>()\n };\n\n sh_println!(\"Running benchmarks: {}\", benchmarks.join(\", \"));\n\n let mut results = BenchmarkResults::new();\n // Set the first version as baseline\n if let Some(first_version) = versions.first() {\n results.set_baseline_version(first_version.clone());\n }\n\n // Setup all projects upfront before version loop\n sh_println!(\"šŸ“¦ Setting up projects to benchmark\");\n let projects: Vec<(RepoConfig, BenchmarkProject)> = repos\n .par_iter()\n .map(|repo_config| -> Result<(RepoConfig, BenchmarkProject)> {\n sh_println!(\"Setting up {}/{}\", repo_config.org, repo_config.repo);\n let project = BenchmarkProject::setup(repo_config).wrap_err(format!(\n \"Failed to setup project for {}/{}\",\n repo_config.org, repo_config.repo\n ))?;\n Ok((repo_config.clone(), project))\n })\n .collect::>>()?;\n\n sh_println!(\"āœ… All projects setup complete\");\n\n // Create a list of all benchmark tasks (same for all versions)\n let benchmark_tasks: Vec<_> = projects\n .iter()\n .flat_map(|(repo_config, project)| {\n benchmarks\n .iter()\n .map(move |benchmark| (repo_config.clone(), project, benchmark.clone()))\n })\n .collect();\n\n sh_println!(\"Will run {} benchmark tasks per version\", benchmark_tasks.len());\n\n // Run benchmarks for each version\n for version in &versions {\n sh_println!(\"šŸ”§ Switching to Foundry version: {version}\");\n switch_version_safe(version)?;\n\n // Verify the switch and capture full version details\n let current = get_forge_version()?;\n sh_println!(\"Current version: {}\", current.trim());\n\n // Get and store the full version details with commit hash and date\n let version_details = get_forge_version_details()?;\n results.add_version_details(version, version_details);\n\n sh_println!(\"Running benchmark tasks for version {version}...\");\n\n // Run all benchmarks sequentially\n let version_results = benchmark_tasks\n .iter()\n .map(|(repo_config, project, benchmark)| -> Result<(String, String, HyperfineResult)> {\n sh_println!(\"Running {} on {}/{}\", benchmark, repo_config.org, repo_config.repo);\n\n // Determine runs based on benchmark type\n let runs = match benchmark.as_str() {\n \"forge_coverage\" => 1, // Coverage runs only once as an exception\n _ => RUNS, // Use default RUNS constant for all other benchmarks\n };\n\n // Run the appropriate benchmark\n let result = project.run(benchmark, version, runs, cli.verbose);\n\n match result {\n Ok(hyperfine_result) => {\n sh_println!(\n \" {} on {}/{}: {:.3}s Ā± {:.3}s\",\n benchmark,\n repo_config.org,\n repo_config.repo,\n hyperfine_result.mean,\n hyperfine_result.stddev.unwrap_or(0.0)\n );\n Ok((repo_config.name.clone(), benchmark.clone(), hyperfine_result))\n }\n Err(e) => {\n eyre::bail!(\n \"Benchmark {} failed for {}/{}: {}\",\n benchmark,\n repo_config.org,\n repo_config.repo,\n e\n );\n }\n }\n })\n .collect::>>()?;\n\n // Add all collected results to the main results structure\n for (repo_name, benchmark, hyperfine_result) in version_results {\n results.add_result(&benchmark, version, &repo_name, hyperfine_result);\n }\n }\n\n // Generate markdown report\n sh_println!(\"šŸ“ Generating report...\");\n let markdown = results.generate_markdown(&versions, &repos);\n let output_path = cli.output_dir.join(cli.output_file);\n fs::write(&output_path, markdown).wrap_err(\"Failed to write output file\")?;\n sh_println!(\"āœ… Report written to: {}\", output_path.display());\n\n Ok(())\n}\n\n#[allow(unused_must_use)]\nfn install_foundry_versions(versions: &[String]) -> Result<()> {\n sh_println!(\"Installing Foundry versions...\");\n\n for version in versions {\n sh_println!(\"Installing {version}...\");\n\n let status = Command::new(\"foundryup\")\n .args([\"--install\", version, \"--force\"])\n .status()\n .wrap_err(\"Failed to run foundryup\")?;\n\n if !status.success() {\n eyre::bail!(\"Failed to install Foundry version: {}\", version);\n }\n }\n\n sh_println!(\"āœ… All versions installed successfully\");\n Ok(())\n}\n" }, { "path": "benches/src/results.rs", "content": "use crate::RepoConfig;\nuse eyre::Result;\nuse serde::{Deserialize, Serialize};\nuse std::{collections::HashMap, process::Command, thread};\n\n/// Hyperfine benchmark result\n#[derive(Debug, Deserialize, Serialize)]\npub struct HyperfineResult {\n pub command: String,\n pub mean: f64,\n pub stddev: Option,\n pub median: f64,\n pub user: f64,\n pub system: f64,\n pub min: f64,\n pub max: f64,\n pub times: Vec,\n #[serde(skip_serializing_if = \"Option::is_none\")]\n pub exit_codes: Option>,\n #[serde(skip_serializing_if = \"Option::is_none\")]\n pub parameters: Option>,\n}\n\n/// Hyperfine JSON output format\n#[derive(Debug, Deserialize, Serialize)]\npub struct HyperfineOutput {\n pub results: Vec,\n}\n\n/// Aggregated benchmark results\n#[derive(Debug, Default)]\npub struct BenchmarkResults {\n /// Map of benchmark_name -> version -> repo -> result\n pub data: HashMap>>,\n /// Track the baseline version for comparison\n pub baseline_version: Option,\n /// Map of version name -> full version details\n pub version_details: HashMap,\n}\n\nimpl BenchmarkResults {\n pub fn new() -> Self {\n Self::default()\n }\n\n pub fn set_baseline_version(&mut self, version: String) {\n self.baseline_version = Some(version);\n }\n\n pub fn add_result(\n &mut self,\n benchmark: &str,\n version: &str,\n repo: &str,\n result: HyperfineResult,\n ) {\n self.data\n .entry(benchmark.to_string())\n .or_default()\n .entry(version.to_string())\n .or_default()\n .insert(repo.to_string(), result);\n }\n\n pub fn add_version_details(&mut self, version: &str, details: String) {\n self.version_details.insert(version.to_string(), details);\n }\n\n pub fn generate_markdown(&self, versions: &[String], repos: &[RepoConfig]) -> String {\n let mut output = String::new();\n\n // Header\n output.push_str(\"# Foundry Benchmark Results\\n\\n\");\n output.push_str(&format!(\n \"**Date**: {}\\n\\n\",\n chrono::Local::now().format(\"%Y-%m-%d %H:%M:%S\")\n ));\n\n // Summary\n output.push_str(\"## Summary\\n\\n\");\n // Count actual repos that have results\n let mut repos_with_results = std::collections::HashSet::new();\n for version_data in self.data.values() {\n for repo_data in version_data.values() {\n for repo_name in repo_data.keys() {\n repos_with_results.insert(repo_name.clone());\n }\n }\n }\n output.push_str(&format!(\n \"Benchmarked {} Foundry versions across {} repositories.\\n\\n\",\n versions.len(),\n repos_with_results.len()\n ));\n\n // Repositories tested\n output.push_str(\"### Repositories Tested\\n\\n\");\n for (i, repo) in repos.iter().enumerate() {\n output.push_str(&format!(\n \"{}. [{}/{}](https://github.com/{}/{})\\n\",\n i + 1,\n repo.org,\n repo.repo,\n repo.org,\n repo.repo\n ));\n }\n output.push('\\n');\n\n // Versions tested\n output.push_str(\"### Foundry Versions\\n\\n\");\n for version in versions {\n if let Some(details) = self.version_details.get(version) {\n output.push_str(&format!(\"- **{version}**: {}\\n\", details.trim()));\n } else {\n output.push_str(&format!(\"- {version}\\n\"));\n }\n }\n output.push('\\n');\n\n // Results for each benchmark type\n for (benchmark_name, version_data) in &self.data {\n output.push_str(&self.generate_benchmark_table(\n benchmark_name,\n version_data,\n versions,\n repos,\n ));\n }\n\n // System info\n output.push_str(\"## System Information\\n\\n\");\n output.push_str(&format!(\"- **OS**: {}\\n\", std::env::consts::OS));\n output.push_str(&format!(\n \"- **CPU**: {}\\n\",\n thread::available_parallelism().map_or(1, |n| n.get())\n ));\n output.push_str(&format!(\n \"- **Rustc**: {}\\n\",\n get_rustc_version().unwrap_or_else(|_| \"unknown\".to_string())\n ));\n\n output\n }\n\n /// Generate a complete markdown table for a single benchmark type\n ///\n /// This includes the section header, table header, separator, and all rows\n fn generate_benchmark_table(\n &self,\n benchmark_name: &str,\n version_data: &HashMap>,\n versions: &[String],\n repos: &[RepoConfig],\n ) -> String {\n let mut output = String::new();\n\n // Section header\n output.push_str(&format!(\"## {}\\n\\n\", format_benchmark_name(benchmark_name)));\n\n // Create table header\n output.push_str(\"| Repository |\");\n for version in versions {\n output.push_str(&format!(\" {version} |\"));\n }\n output.push('\\n');\n\n // Table separator\n output.push_str(\"|------------|\");\n for _ in versions {\n output.push_str(\"----------|\");\n }\n output.push('\\n');\n\n // Table rows\n output.push_str(&generate_table_rows(version_data, versions, repos));\n output.push('\\n');\n\n output\n }\n}\n\n/// Generate table rows for benchmark results\n///\n/// This function creates the markdown table rows for each repository,\n/// showing the benchmark results for each version.\nfn generate_table_rows(\n version_data: &HashMap>,\n versions: &[String],\n repos: &[RepoConfig],\n) -> String {\n let mut output = String::new();\n\n for repo in repos {\n output.push_str(&format!(\"| {} |\", repo.name));\n\n for version in versions {\n let cell_content = get_benchmark_cell_content(version_data, version, &repo.name);\n output.push_str(&format!(\" {cell_content} |\"));\n }\n\n output.push('\\n');\n }\n\n output\n}\n\n/// Get the content for a single benchmark table cell\n///\n/// Returns the formatted duration or \"N/A\" if no data is available.\n/// The nested if-let statements handle the following cases:\n/// 1. Check if version data exists\n/// 2. Check if repository data exists for this version\nfn get_benchmark_cell_content(\n version_data: &HashMap>,\n version: &str,\n repo_name: &str,\n) -> String {\n // Check if we have data for this version\n if let Some(repo_data) = version_data.get(version) &&\n // Check if we have data for this repository\n let Some(result) = repo_data.get(repo_name)\n {\n return format_duration_seconds(result.mean);\n }\n\n \"N/A\".to_string()\n}\n\npub fn format_benchmark_name(name: &str) -> String {\n match name {\n \"forge_test\" => \"Forge Test\",\n \"forge_build_no_cache\" => \"Forge Build (No Cache)\",\n \"forge_build_with_cache\" => \"Forge Build (With Cache)\",\n \"forge_fuzz_test\" => \"Forge Fuzz Test\",\n \"forge_coverage\" => \"Forge Coverage\",\n \"forge_isolate_test\" => \"Forge Test (Isolated)\",\n _ => name,\n }\n .to_string()\n}\n\npub fn format_duration_seconds(seconds: f64) -> String {\n if seconds < 0.001 {\n format!(\"{:.2} ms\", seconds * 1000.0)\n } else if seconds < 1.0 {\n format!(\"{seconds:.3} s\")\n } else if seconds < 60.0 {\n format!(\"{seconds:.2} s\")\n } else {\n let minutes = (seconds / 60.0).floor();\n let remaining_seconds = seconds % 60.0;\n format!(\"{minutes:.0}m {remaining_seconds:.1}s\")\n }\n}\n\npub fn get_rustc_version() -> Result {\n let output = Command::new(\"rustc\").arg(\"--version\").output()?;\n\n Ok(String::from_utf8_lossy(&output.stdout).trim().to_string())\n}\n" }, { "path": "benchmark.sh", "content": "#!/bin/bash\n\nversions=\"v1.3.6,v1.4.0-rc1\"\n\n# Repositories\nexport ITHACA_ACCOUNT=\"ithacaxyz/account:v0.3.2\"\nexport SOLADY_REPO=\"Vectorized/solady:v0.1.22\"\nexport UNISWAP_V4_CORE=\"Uniswap/v4-core:59d3ecf\"\nexport SPARK_PSM=\"sparkdotfi/spark-psm:v1.0.0\"\n\n# Benches\necho \"===========FORGE TEST AND BUILD BENCHMARKS===========\"\n\nfoundry-bench --versions $versions \\\n --repos $ITHACA_ACCOUNT,$SOLADY_REPO,$UNISWAP_V4_CORE,$SPARK_PSM \\\n --benchmarks forge_test,forge_fuzz_test,forge_build_no_cache,forge_build_with_cache \\\n --output-dir ./benches/results \\\n --output-file TEST_BUILD.md\n\necho \"===========FORGE COVERAGE BENCHMARKS===========\"\n\nfoundry-bench --versions $versions \\\n --repos $ITHACA_ACCOUNT,$UNISWAP_V4_CORE,$SPARK_PSM \\\n --benchmarks forge_coverage \\\n --output-dir ./benches/results \\\n --output-file COVERAGE.md\n\necho \"===========FORGE ISOLATE TEST BENCHMARKS===========\"\n\nfoundry-bench --versions $versions \\\n --repos $SOLADY_REPO,$UNISWAP_V4_CORE,$SPARK_PSM \\\n --benchmarks forge_isolate_test \\\n --output-dir ./benches/results \\\n --output-file ISOLATE_TEST.md\n\necho \"===========BENCHMARKS COMPLETED===========\"\n" }, { "path": "clippy.toml", "content": "# `bytes::Bytes` is included by default and `alloy_primitives::Bytes` is a wrapper around it,\n# so it is safe to ignore it as well.\nignore-interior-mutability = [\"bytes::Bytes\", \"alloy_primitives::Bytes\"]\n\ndisallowed-macros = [\n # See `foundry_common::shell`.\n { path = \"std::print\", reason = \"use `sh_print` or similar macros instead\" },\n { path = \"std::eprint\", reason = \"use `sh_eprint` or similar macros instead\" },\n { path = \"std::println\", reason = \"use `sh_println` or similar macros instead\" },\n { path = \"std::eprintln\", reason = \"use `sh_eprintln` or similar macros instead\" },\n]\n" }, { "path": "crates/anvil/Cargo.toml", "content": "[package]\nname = \"anvil\"\ndescription = \"Local ethereum node\"\n\nversion.workspace = true\nedition.workspace = true\nrust-version.workspace = true\nauthors.workspace = true\nlicense.workspace = true\nhomepage.workspace = true\nrepository.workspace = true\n\n[lints]\nworkspace = true\n\n[[bin]]\nname = \"anvil\"\npath = \"bin/main.rs\"\nrequired-features = [\"cli\"]\n\n[dependencies]\n# foundry internal\nanvil-core = { path = \"core\" }\nanvil-rpc = { path = \"rpc\" }\nanvil-server = { path = \"server\" }\nfoundry-cli.workspace = true\nfoundry-common.workspace = true\nfoundry-config.workspace = true\nfoundry-evm.workspace = true\nfoundry-evm-networks.workspace = true\nfoundry-primitives.workspace = true\ntempo-primitives.workspace = true\n\n# alloy\nalloy-evm = { workspace = true, features = [\"call-util\"] }\nalloy-op-evm.workspace = true\nalloy-primitives = { workspace = true, features = [\"serde\"] }\nalloy-consensus = { workspace = true, features = [\"k256\", \"kzg\"] }\nalloy-contract = { workspace = true, features = [\"pubsub\"] }\nalloy-network.workspace = true\nalloy-eips.workspace = true\nalloy-rlp.workspace = true\nalloy-signer = { workspace = true, features = [\"eip712\"] }\nalloy-signer-local = { workspace = true, features = [\"mnemonic\"] }\nalloy-sol-types = { workspace = true, features = [\"std\"] }\nalloy-dyn-abi = { workspace = true, features = [\"std\", \"eip712\"] }\nalloy-rpc-types = { workspace = true, features = [\"anvil\", \"trace\", \"txpool\"] }\nalloy-rpc-types-beacon.workspace = true\nalloy-rpc-types-eth.workspace = true\nalloy-serde.workspace = true\nalloy-provider = { workspace = true, features = [\n \"reqwest\",\n \"ws\",\n \"ipc\",\n \"debug-api\",\n \"trace-api\",\n] }\nalloy-transport.workspace = true\nalloy-chains.workspace = true\nalloy-genesis.workspace = true\nalloy-trie.workspace = true\nop-alloy-consensus = { workspace = true, features = [\"serde\"] }\n\n# revm\nrevm = { workspace = true, features = [\n \"std\",\n \"serde\",\n \"memory_limit\",\n \"c-kzg\",\n] }\nrevm-inspectors.workspace = true\nop-revm.workspace = true\n\n# axum related\naxum.workspace = true\nhyper.workspace = true\n\n# tracing\ntracing.workspace = true\ntracing-subscriber = { workspace = true, features = [\"env-filter\"] }\n\n# async\ntokio = { workspace = true, features = [\"time\"] }\nparking_lot.workspace = true\nfutures.workspace = true\nasync-trait.workspace = true\n\n# misc\nflate2.workspace = true\nserde_json.workspace = true\nserde.workspace = true\nthiserror.workspace = true\nyansi.workspace = true\ntempfile.workspace = true\nitertools.workspace = true\nrand_08.workspace = true\neyre.workspace = true\nethereum_ssz.workspace = true\n\n# cli\nclap = { version = \"4\", features = [\n \"derive\",\n \"env\",\n \"wrap_help\",\n], optional = true }\nclap_complete = { workspace = true, optional = true }\nchrono.workspace = true\nctrlc = { version = \"3\", optional = true }\nfdlimit = { version = \"0.3\", optional = true }\n\n[dev-dependencies]\nalloy-provider = { workspace = true, features = [\"txpool-api\"] }\nalloy-pubsub.workspace = true\nrand.workspace = true\nreqwest.workspace = true\nfoundry-test-utils.workspace = true\ntokio = { workspace = true, features = [\"full\"] }\n\nop-alloy-rpc-types.workspace = true\n\n[features]\ndefault = [\"cli\", \"jemalloc\"]\nasm-keccak = [\"alloy-primitives/asm-keccak\"]\njemalloc = [\"foundry-cli/jemalloc\"]\nmimalloc = [\"foundry-cli/mimalloc\"]\ntracy-allocator = [\"foundry-cli/tracy-allocator\"]\ncli = [\"tokio/full\", \"cmd\"]\ncmd = [\n \"clap\",\n \"clap_complete\",\n \"dep:fdlimit\",\n \"dep:ctrlc\",\n \"anvil-server/clap\",\n \"tokio/signal\",\n]\njs-tracer = [\"revm-inspectors/js-tracer\"]\n" }, { "path": "crates/anvil/bin/main.rs", "content": "//! The `anvil` CLI: a fast local Ethereum development node, akin to Hardhat Network, Tenderly.\n\nuse anvil::args::run;\n\n#[global_allocator]\nstatic ALLOC: foundry_cli::utils::Allocator = foundry_cli::utils::new_allocator();\n\nfn main() {\n if let Err(err) = run() {\n let _ = foundry_common::sh_err!(\"{err:?}\");\n std::process::exit(1);\n }\n}\n" }, { "path": "crates/anvil/core/Cargo.toml", "content": "[package]\nname = \"anvil-core\"\n\nversion.workspace = true\nedition.workspace = true\nrust-version.workspace = true\nauthors.workspace = true\nlicense.workspace = true\nhomepage.workspace = true\nrepository.workspace = true\n\n[lints]\nworkspace = true\n\n[dependencies]\nfoundry-common.workspace = true\nfoundry-evm.workspace = true\nfoundry-primitives.workspace = true\nrevm = { workspace = true, default-features = false, features = [\n \"std\",\n \"serde\",\n \"memory_limit\",\n \"c-kzg\",\n] }\n\nalloy-primitives = { workspace = true, features = [\"serde\", \"rlp\"] }\nalloy-rpc-types = { workspace = true, features = [\"anvil\", \"trace\"] }\nalloy-serde.workspace = true\nalloy-rlp.workspace = true\nalloy-eips.workspace = true\nalloy-eip5792.workspace = true\nalloy-consensus = { workspace = true, features = [\"k256\", \"kzg\"] }\nalloy-network.workspace = true\nalloy-dyn-abi = { workspace = true, features = [\"std\", \"eip712\"] }\nserde.workspace = true\nserde_json.workspace = true\nbytes.workspace = true\n\n# misc\nrand.workspace = true\nthiserror.workspace = true\n" }, { "path": "crates/anvil/core/src/eth/block.rs", "content": "use super::transaction::TransactionInfo;\nuse alloy_consensus::{\n BlockBody, EMPTY_OMMER_ROOT_HASH, Header, proofs::calculate_transaction_root,\n};\nuse alloy_eips::eip2718::Encodable2718;\nuse alloy_network::Network;\nuse foundry_primitives::{FoundryNetwork, FoundryTxEnvelope};\nuse std::fmt::Debug;\n\nuse crate::eth::transaction::MaybeImpersonatedTransaction;\n\n/// Type alias for Ethereum Block with Anvil's transaction type, generic over the transaction\n/// envelope with a default of [`FoundryTxEnvelope`].\npub type Block = alloy_consensus::Block>;\n\n/// Anvil's concrete block info type.\npub type BlockInfo = TypedBlockInfo;\n\n/// Container type that gathers all block data, generic over a [`Network`].\n#[derive(Clone, Debug)]\npub struct TypedBlockInfo {\n pub block: alloy_consensus::Block>,\n pub transactions: Vec,\n pub receipts: Vec,\n}\n\n/// Helper function to create a new block with Header and Anvil transactions, generic over the\n/// transaction envelope with a default of [`FoundryTxEnvelope`].\n///\n/// Note: if the `impersonate-tx` feature is enabled this will also accept\n/// `MaybeImpersonatedTransaction`.\npub fn create_block(\n mut header: Header,\n transactions: impl IntoIterator,\n) -> Block\nwhere\n Tx: Encodable2718,\n T: Into>,\n{\n let transactions: Vec<_> = transactions.into_iter().map(Into::into).collect();\n let transactions_root = calculate_transaction_root(&transactions);\n\n header.transactions_root = transactions_root;\n header.ommers_hash = EMPTY_OMMER_ROOT_HASH;\n\n let body = BlockBody { transactions, ommers: Vec::new(), withdrawals: None };\n Block::new(header, body)\n}\n\n/// Generic helper function to create a block with any transaction type that supports encoding.\npub fn create_typed_block(\n mut header: Header,\n transactions: impl IntoIterator,\n) -> alloy_consensus::Block\nwhere\n T: Encodable2718,\n{\n let transactions: Vec<_> = transactions.into_iter().collect();\n let transactions_root = calculate_transaction_root(&transactions);\n\n header.transactions_root = transactions_root;\n header.ommers_hash = EMPTY_OMMER_ROOT_HASH;\n\n let body = BlockBody { transactions, ommers: Vec::new(), withdrawals: None };\n alloy_consensus::Block::new(header, body)\n}\n\n#[cfg(test)]\nmod tests {\n use alloy_primitives::{\n Address, B64, B256, Bloom, U256, b256,\n hex::{self, FromHex},\n };\n use alloy_rlp::Decodable;\n\n use super::*;\n use std::str::FromStr;\n\n #[test]\n fn header_rlp_roundtrip() {\n let mut header = Header {\n parent_hash: Default::default(),\n ommers_hash: Default::default(),\n beneficiary: Default::default(),\n state_root: Default::default(),\n transactions_root: Default::default(),\n receipts_root: Default::default(),\n logs_bloom: Default::default(),\n difficulty: Default::default(),\n number: 124u64,\n gas_limit: Default::default(),\n gas_used: 1337u64,\n timestamp: 0,\n extra_data: Default::default(),\n mix_hash: Default::default(),\n nonce: B64::with_last_byte(99),\n withdrawals_root: Default::default(),\n blob_gas_used: Default::default(),\n excess_blob_gas: Default::default(),\n parent_beacon_block_root: Default::default(),\n base_fee_per_gas: None,\n requests_hash: None,\n };\n\n let encoded = alloy_rlp::encode(&header);\n let decoded: Header = Header::decode(&mut encoded.as_ref()).unwrap();\n assert_eq!(header, decoded);\n\n header.base_fee_per_gas = Some(12345u64);\n\n let encoded = alloy_rlp::encode(&header);\n let decoded: Header = Header::decode(&mut encoded.as_ref()).unwrap();\n assert_eq!(header, decoded);\n }\n\n #[test]\n fn test_encode_block_header() {\n use alloy_rlp::Encodable;\n\n let expected = hex::decode(\"f901f9a00000000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000940000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000b90100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008208ae820d0582115c8215b3821a0a827788a00000000000000000000000000000000000000000000000000000000000000000880000000000000000\").unwrap();\n let mut data = vec![];\n let header = Header {\n parent_hash: B256::from_str(\"0000000000000000000000000000000000000000000000000000000000000000\").unwrap(),\n ommers_hash: B256::from_str(\"0000000000000000000000000000000000000000000000000000000000000000\").unwrap(),\n beneficiary: Address::from_str(\"0000000000000000000000000000000000000000\").unwrap(),\n state_root: B256::from_str(\"0000000000000000000000000000000000000000000000000000000000000000\").unwrap(),\n transactions_root: B256::from_str(\"0000000000000000000000000000000000000000000000000000000000000000\").unwrap(),\n receipts_root: B256::from_str(\"0000000000000000000000000000000000000000000000000000000000000000\").unwrap(),\n logs_bloom: Bloom::from_hex(\"00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\").unwrap(),\n difficulty: U256::from(2222),\n number: 0xd05u64,\n gas_limit: 0x115cu64,\n gas_used: 0x15b3u64,\n timestamp: 0x1a0au64,\n extra_data: hex::decode(\"7788\").unwrap().into(),\n mix_hash: B256::from_str(\"0000000000000000000000000000000000000000000000000000000000000000\").unwrap(),\n withdrawals_root: None,\n blob_gas_used: None,\n excess_blob_gas: None,\n parent_beacon_block_root: None,\n nonce: B64::ZERO,\n base_fee_per_gas: None,\n requests_hash: None,\n };\n\n header.encode(&mut data);\n assert_eq!(hex::encode(&data), hex::encode(expected));\n assert_eq!(header.length(), data.len());\n }\n\n #[test]\n // Test vector from: https://eips.ethereum.org/EIPS/eip-2481\n fn test_decode_block_header() {\n let data = hex::decode(\"f901f9a00000000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000940000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000b90100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008208ae820d0582115c8215b3821a0a827788a00000000000000000000000000000000000000000000000000000000000000000880000000000000000\").unwrap();\n let expected = Header {\n parent_hash: B256::from_str(\"0000000000000000000000000000000000000000000000000000000000000000\").unwrap(),\n ommers_hash: B256::from_str(\"0000000000000000000000000000000000000000000000000000000000000000\").unwrap(),\n beneficiary: Address::from_str(\"0000000000000000000000000000000000000000\").unwrap(),\n state_root: B256::from_str(\"0000000000000000000000000000000000000000000000000000000000000000\").unwrap(),\n transactions_root: B256::from_str(\"0000000000000000000000000000000000000000000000000000000000000000\").unwrap(),\n receipts_root: B256::from_str(\"0000000000000000000000000000000000000000000000000000000000000000\").unwrap(),\n logs_bloom: <[u8; 256]>::from_hex(\"00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\").unwrap().into(),\n difficulty: U256::from(2222),\n number: 0xd05u64,\n gas_limit: 0x115cu64,\n gas_used: 0x15b3u64,\n timestamp: 0x1a0au64,\n extra_data: hex::decode(\"7788\").unwrap().into(),\n mix_hash: B256::from_str(\"0000000000000000000000000000000000000000000000000000000000000000\").unwrap(),\n nonce: B64::ZERO,\n withdrawals_root: None,\n blob_gas_used: None,\n excess_blob_gas: None,\n parent_beacon_block_root: None,\n base_fee_per_gas: None,\n requests_hash: None,\n };\n let header = Header::decode(&mut data.as_slice()).unwrap();\n assert_eq!(header, expected);\n }\n\n #[test]\n // Test vector from: https://github.com/ethereum/tests/blob/f47bbef4da376a49c8fc3166f09ab8a6d182f765/BlockchainTests/ValidBlocks/bcEIP1559/baseFee.json#L15-L36\n fn test_eip1559_block_header_hash() {\n let expected_hash =\n b256!(\"0x6a251c7c3c5dca7b42407a3752ff48f3bbca1fab7f9868371d9918daf1988d1f\");\n let header = Header {\n parent_hash: B256::from_str(\"e0a94a7a3c9617401586b1a27025d2d9671332d22d540e0af72b069170380f2a\").unwrap(),\n ommers_hash: B256::from_str(\"1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\").unwrap(),\n beneficiary: Address::from_str(\"ba5e000000000000000000000000000000000000\").unwrap(),\n state_root: B256::from_str(\"ec3c94b18b8a1cff7d60f8d258ec723312932928626b4c9355eb4ab3568ec7f7\").unwrap(),\n transactions_root: B256::from_str(\"50f738580ed699f0469702c7ccc63ed2e51bc034be9479b7bff4e68dee84accf\").unwrap(),\n receipts_root: B256::from_str(\"29b0562f7140574dd0d50dee8a271b22e1a0a7b78fca58f7c60370d8317ba2a9\").unwrap(),\n logs_bloom: Bloom::from_hex(\"00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\").unwrap(),\n difficulty: U256::from(0x020000),\n number: 1u64,\n gas_limit: U256::from(0x016345785d8a0000u128).to::(),\n gas_used: U256::from(0x015534).to::(),\n timestamp: 0x079e,\n extra_data: hex::decode(\"42\").unwrap().into(),\n mix_hash: B256::from_str(\"0000000000000000000000000000000000000000000000000000000000000000\").unwrap(),\n nonce: B64::ZERO,\n base_fee_per_gas: Some(875),\n withdrawals_root: None,\n blob_gas_used: None,\n excess_blob_gas: None,\n parent_beacon_block_root: None,\n requests_hash: None,\n };\n assert_eq!(header.hash_slow(), expected_hash);\n }\n\n #[test]\n // Test vector from network\n fn block_network_roundtrip() {\n use alloy_rlp::Encodable;\n\n let data = hex::decode(\"f9034df90348a0fbdbd8d2d0ac5f14bd5fa90e547fe6f1d15019c724f8e7b60972d381cd5d9cf8a01dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d4934794c9577e7945db22e38fc060909f2278c7746b0f9ba05017cfa3b0247e35197215ae8d610265ffebc8edca8ea66d6567eb0adecda867a056e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421a056e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421b9010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000018355bb7b871fffffffffffff808462bd0e1ab9014bf90148a00000000000000000000000000000000000000000000000000000000000000000f85494319fa8f1bc4e53410e92d10d918659b16540e60a945a573efb304d04c1224cd012313e827eca5dce5d94a9c831c5a268031176ebf5f3de5051e8cba0dbfe94c9577e7945db22e38fc060909f2278c7746b0f9b808400000000f8c9b841a6946f2d16f68338cbcbd8b117374ab421128ce422467088456bceba9d70c34106128e6d4564659cf6776c08a4186063c0a05f7cffd695c10cf26a6f301b67f800b8412b782100c18c35102dc0a37ece1a152544f04ad7dc1868d18a9570f744ace60870f822f53d35e89a2ea9709ccbf1f4a25ee5003944faa845d02dde0a41d5704601b841d53caebd6c8a82456e85c2806a9e08381f959a31fb94a77e58f00e38ad97b2e0355b8519ab2122662cbe022f2a4ef7ff16adc0b2d5dcd123181ec79705116db300a063746963616c2062797a616e74696e65206661756c7420746f6c6572616e6365880000000000000000c0c0\").unwrap();\n\n let block = ::decode(&mut data.as_slice()).unwrap();\n\n // encode and check that it matches the original data\n let mut encoded = Vec::new();\n block.encode(&mut encoded);\n assert_eq!(data, encoded);\n\n // check that length of encoding is the same as the output of `length`\n assert_eq!(block.length(), encoded.len());\n }\n}\n" }, { "path": "crates/anvil/core/src/eth/mod.rs", "content": "use crate::{eth::subscription::SubscriptionId, types::ReorgOptions};\nuse alloy_primitives::{Address, B64, B256, Bytes, TxHash, U256, map::HashSet};\nuse alloy_rpc_types::{\n BlockId, BlockNumberOrTag as BlockNumber, BlockOverrides, Filter, Index,\n anvil::{Forking, MineOptions},\n pubsub::{Params as SubscriptionParams, SubscriptionKind},\n request::TransactionRequest,\n simulate::SimulatePayload,\n state::StateOverride,\n trace::{\n filter::TraceFilter,\n geth::{GethDebugTracingCallOptions, GethDebugTracingOptions},\n parity::TraceType,\n },\n};\nuse alloy_serde::WithOtherFields;\nuse foundry_common::serde_helpers::{\n deserialize_number, deserialize_number_opt, deserialize_number_seq,\n};\n\npub mod block;\npub mod subscription;\npub mod transaction;\npub mod wallet;\n\npub mod serde_helpers;\nuse self::serde_helpers::*;\n\n/// Wrapper type that ensures the type is named `params`\n#[derive(Clone, Debug, PartialEq, Eq, serde::Deserialize)]\npub struct Params {\n #[serde(default)]\n pub params: T,\n}\n\n/// Represents ethereum JSON-RPC API\n#[derive(Clone, Debug, serde::Deserialize)]\n#[serde(tag = \"method\", content = \"params\")]\n#[allow(clippy::large_enum_variant)]\npub enum EthRequest {\n #[serde(rename = \"web3_clientVersion\", with = \"empty_params\")]\n Web3ClientVersion(()),\n\n #[serde(rename = \"web3_sha3\", with = \"sequence\")]\n Web3Sha3(Bytes),\n\n /// Returns the current Ethereum protocol version.\n #[serde(rename = \"eth_protocolVersion\", with = \"empty_params\")]\n EthProtocolVersion(()),\n\n #[serde(rename = \"eth_chainId\", with = \"empty_params\")]\n EthChainId(()),\n\n #[serde(rename = \"eth_networkId\", alias = \"net_version\", with = \"empty_params\")]\n EthNetworkId(()),\n\n #[serde(rename = \"net_listening\", with = \"empty_params\")]\n NetListening(()),\n\n /// Returns the number of hashes per second with which the node is mining.\n #[serde(rename = \"eth_hashrate\", with = \"empty_params\")]\n EthHashrate(()),\n\n #[serde(rename = \"eth_gasPrice\", with = \"empty_params\")]\n EthGasPrice(()),\n\n #[serde(rename = \"eth_maxPriorityFeePerGas\", with = \"empty_params\")]\n EthMaxPriorityFeePerGas(()),\n\n #[serde(rename = \"eth_blobBaseFee\", with = \"empty_params\")]\n EthBlobBaseFee(()),\n\n #[serde(rename = \"eth_accounts\", alias = \"eth_requestAccounts\", with = \"empty_params\")]\n EthAccounts(()),\n\n #[serde(rename = \"eth_blockNumber\", with = \"empty_params\")]\n EthBlockNumber(()),\n\n /// Returns the client coinbase address.\n #[serde(rename = \"eth_coinbase\", with = \"empty_params\")]\n EthCoinbase(()),\n\n #[serde(rename = \"eth_getBalance\")]\n EthGetBalance(Address, Option),\n\n #[serde(rename = \"eth_getAccount\")]\n EthGetAccount(Address, Option),\n\n #[serde(rename = \"eth_getAccountInfo\")]\n EthGetAccountInfo(Address, Option),\n\n #[serde(rename = \"eth_getStorageAt\")]\n EthGetStorageAt(Address, U256, Option),\n\n #[serde(rename = \"eth_getBlockByHash\")]\n EthGetBlockByHash(B256, bool),\n\n #[serde(rename = \"eth_getBlockByNumber\")]\n EthGetBlockByNumber(\n #[serde(deserialize_with = \"lenient_block_number::lenient_block_number\")] BlockNumber,\n bool,\n ),\n\n #[serde(rename = \"eth_getTransactionCount\")]\n EthGetTransactionCount(Address, Option),\n\n #[serde(rename = \"eth_getBlockTransactionCountByHash\", with = \"sequence\")]\n EthGetTransactionCountByHash(B256),\n\n #[serde(\n rename = \"eth_getBlockTransactionCountByNumber\",\n deserialize_with = \"lenient_block_number::lenient_block_number_seq\"\n )]\n EthGetTransactionCountByNumber(BlockNumber),\n\n #[serde(rename = \"eth_getUncleCountByBlockHash\", with = \"sequence\")]\n EthGetUnclesCountByHash(B256),\n\n #[serde(\n rename = \"eth_getUncleCountByBlockNumber\",\n deserialize_with = \"lenient_block_number::lenient_block_number_seq\"\n )]\n EthGetUnclesCountByNumber(BlockNumber),\n\n #[serde(rename = \"eth_getCode\")]\n EthGetCodeAt(Address, Option),\n\n /// Returns the account and storage values of the specified account including the Merkle-proof.\n /// This call can be used to verify that the data you are pulling from is not tampered with.\n #[serde(rename = \"eth_getProof\")]\n EthGetProof(Address, Vec, Option),\n\n /// The sign method calculates an Ethereum specific signature with:\n #[serde(rename = \"eth_sign\")]\n EthSign(Address, Bytes),\n\n /// The sign method calculates an Ethereum specific signature, equivalent to eth_sign:\n /// \n #[serde(rename = \"personal_sign\")]\n PersonalSign(Bytes, Address),\n\n #[serde(rename = \"eth_signTransaction\", with = \"sequence\")]\n EthSignTransaction(Box>),\n\n /// Signs data via [EIP-712](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-712.md).\n #[serde(rename = \"eth_signTypedData\")]\n EthSignTypedData(Address, serde_json::Value),\n\n /// Signs data via [EIP-712](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-712.md).\n #[serde(rename = \"eth_signTypedData_v3\")]\n EthSignTypedDataV3(Address, serde_json::Value),\n\n /// Signs data via [EIP-712](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-712.md), and includes full support of arrays and recursive data structures.\n #[serde(rename = \"eth_signTypedData_v4\")]\n EthSignTypedDataV4(Address, alloy_dyn_abi::TypedData),\n\n #[serde(rename = \"eth_sendTransaction\", with = \"sequence\")]\n EthSendTransaction(Box>),\n\n #[serde(rename = \"eth_sendTransactionSync\", with = \"sequence\")]\n EthSendTransactionSync(Box>),\n\n #[serde(rename = \"eth_sendRawTransaction\", with = \"sequence\")]\n EthSendRawTransaction(Bytes),\n\n #[serde(rename = \"eth_sendRawTransactionSync\", with = \"sequence\")]\n EthSendRawTransactionSync(Bytes),\n\n #[serde(rename = \"eth_call\")]\n EthCall(\n WithOtherFields,\n #[serde(default)] Option,\n #[serde(default)] Option,\n #[serde(default)] Option>,\n ),\n\n #[serde(rename = \"eth_simulateV1\")]\n EthSimulateV1(SimulatePayload, #[serde(default)] Option),\n\n #[serde(rename = \"eth_createAccessList\")]\n EthCreateAccessList(WithOtherFields, #[serde(default)] Option),\n\n #[serde(rename = \"eth_estimateGas\")]\n EthEstimateGas(\n WithOtherFields,\n #[serde(default)] Option,\n #[serde(default)] Option,\n #[serde(default)] Option>,\n ),\n\n #[serde(rename = \"eth_fillTransaction\", with = \"sequence\")]\n EthFillTransaction(WithOtherFields),\n\n #[serde(rename = \"eth_getTransactionByHash\", with = \"sequence\")]\n EthGetTransactionByHash(TxHash),\n\n /// Returns the blob for a given blob versioned hash.\n #[serde(rename = \"anvil_getBlobByHash\", with = \"sequence\")]\n GetBlobByHash(B256),\n\n /// Returns the blobs for a given transaction hash.\n #[serde(rename = \"anvil_getBlobsByTransactionHash\", with = \"sequence\")]\n GetBlobByTransactionHash(TxHash),\n\n /// Returns the genesis time for the chain\n #[serde(rename = \"anvil_getGenesisTime\", with = \"empty_params\")]\n GetGenesisTime(()),\n\n #[serde(rename = \"eth_getTransactionByBlockHashAndIndex\")]\n EthGetTransactionByBlockHashAndIndex(B256, Index),\n\n #[serde(rename = \"eth_getTransactionByBlockNumberAndIndex\")]\n EthGetTransactionByBlockNumberAndIndex(BlockNumber, Index),\n\n #[serde(rename = \"eth_getRawTransactionByHash\", with = \"sequence\")]\n EthGetRawTransactionByHash(TxHash),\n\n #[serde(rename = \"eth_getRawTransactionByBlockHashAndIndex\")]\n EthGetRawTransactionByBlockHashAndIndex(B256, Index),\n\n #[serde(rename = \"eth_getRawTransactionByBlockNumberAndIndex\")]\n EthGetRawTransactionByBlockNumberAndIndex(BlockNumber, Index),\n\n #[serde(rename = \"eth_getTransactionReceipt\", with = \"sequence\")]\n EthGetTransactionReceipt(B256),\n\n #[serde(rename = \"eth_getBlockReceipts\", with = \"sequence\")]\n EthGetBlockReceipts(BlockId),\n\n #[serde(rename = \"eth_getUncleByBlockHashAndIndex\")]\n EthGetUncleByBlockHashAndIndex(B256, Index),\n\n #[serde(rename = \"eth_getUncleByBlockNumberAndIndex\")]\n EthGetUncleByBlockNumberAndIndex(\n #[serde(deserialize_with = \"lenient_block_number::lenient_block_number\")] BlockNumber,\n Index,\n ),\n\n #[serde(rename = \"eth_getLogs\", with = \"sequence\")]\n EthGetLogs(Filter),\n\n /// Creates a filter object, based on filter options, to notify when the state changes (logs).\n #[serde(rename = \"eth_newFilter\", with = \"sequence\")]\n EthNewFilter(Filter),\n\n /// Polling method for a filter, which returns an array of logs which occurred since last poll.\n #[serde(rename = \"eth_getFilterChanges\", with = \"sequence\")]\n EthGetFilterChanges(String),\n\n /// Creates a filter in the node, to notify when a new block arrives.\n /// To check if the state has changed, call `eth_getFilterChanges`.\n #[serde(rename = \"eth_newBlockFilter\", with = \"empty_params\")]\n EthNewBlockFilter(()),\n\n /// Creates a filter in the node, to notify when new pending transactions arrive.\n /// To check if the state has changed, call `eth_getFilterChanges`.\n #[serde(rename = \"eth_newPendingTransactionFilter\", with = \"empty_params\")]\n EthNewPendingTransactionFilter(()),\n\n /// Returns an array of all logs matching filter with given id.\n #[serde(rename = \"eth_getFilterLogs\", with = \"sequence\")]\n EthGetFilterLogs(String),\n\n /// Removes the filter, returns true if the filter was installed\n #[serde(rename = \"eth_uninstallFilter\", with = \"sequence\")]\n EthUninstallFilter(String),\n\n #[serde(rename = \"eth_getWork\", with = \"empty_params\")]\n EthGetWork(()),\n\n #[serde(rename = \"eth_submitWork\")]\n EthSubmitWork(B64, B256, B256),\n\n #[serde(rename = \"eth_submitHashrate\")]\n EthSubmitHashRate(U256, B256),\n\n #[serde(rename = \"eth_feeHistory\")]\n EthFeeHistory(\n #[serde(deserialize_with = \"deserialize_number\")] U256,\n BlockNumber,\n #[serde(default)] Vec,\n ),\n\n #[serde(rename = \"eth_syncing\", with = \"empty_params\")]\n EthSyncing(()),\n\n #[serde(rename = \"eth_config\", with = \"empty_params\")]\n EthConfig(()),\n\n /// geth's `debug_getRawTransaction` endpoint\n #[serde(rename = \"debug_getRawTransaction\", with = \"sequence\")]\n DebugGetRawTransaction(TxHash),\n\n /// geth's `debug_traceTransaction` endpoint\n #[serde(rename = \"debug_traceTransaction\")]\n DebugTraceTransaction(B256, #[serde(default)] GethDebugTracingOptions),\n\n /// geth's `debug_traceCall` endpoint\n #[serde(rename = \"debug_traceCall\")]\n DebugTraceCall(\n WithOtherFields,\n #[serde(default)] Option,\n #[serde(default)] GethDebugTracingCallOptions,\n ),\n\n /// reth's `debug_codeByHash` endpoint\n #[serde(rename = \"debug_codeByHash\")]\n DebugCodeByHash(B256, #[serde(default)] Option),\n\n /// reth's `debug_dbGet` endpoint\n #[serde(rename = \"debug_dbGet\")]\n DebugDbGet(String),\n\n /// Trace transaction endpoint for parity's `trace_transaction`\n #[serde(rename = \"trace_transaction\", with = \"sequence\")]\n TraceTransaction(B256),\n\n /// Trace transaction endpoint for parity's `trace_block`\n #[serde(\n rename = \"trace_block\",\n deserialize_with = \"lenient_block_number::lenient_block_number_seq\"\n )]\n TraceBlock(BlockNumber),\n\n // Return filtered traces over blocks\n #[serde(rename = \"trace_filter\", with = \"sequence\")]\n TraceFilter(TraceFilter),\n\n /// Trace transaction endpoint for parity's `trace_replayBlockTransactions`\n #[serde(rename = \"trace_replayBlockTransactions\")]\n TraceReplayBlockTransactions(\n #[serde(deserialize_with = \"lenient_block_number::lenient_block_number\")] BlockNumber,\n HashSet,\n ),\n\n // Custom endpoints, they're not extracted to a separate type out of serde convenience\n /// send transactions impersonating specific account and contract addresses.\n #[serde(\n rename = \"anvil_impersonateAccount\",\n alias = \"hardhat_impersonateAccount\",\n with = \"sequence\"\n )]\n ImpersonateAccount(Address),\n /// Stops impersonating an account if previously set with `anvil_impersonateAccount`\n #[serde(\n rename = \"anvil_stopImpersonatingAccount\",\n alias = \"hardhat_stopImpersonatingAccount\",\n with = \"sequence\"\n )]\n StopImpersonatingAccount(Address),\n /// Will make every account impersonated\n #[serde(\n rename = \"anvil_autoImpersonateAccount\",\n alias = \"hardhat_autoImpersonateAccount\",\n with = \"sequence\"\n )]\n AutoImpersonateAccount(bool),\n\n /// Registers a signature/address pair for faking `ecrecover` results\n #[serde(rename = \"anvil_impersonateSignature\", with = \"sequence\")]\n ImpersonateSignature(Bytes, Address),\n\n /// Returns true if automatic mining is enabled, and false.\n #[serde(rename = \"anvil_getAutomine\", alias = \"hardhat_getAutomine\", with = \"empty_params\")]\n GetAutoMine(()),\n /// Mines a series of blocks\n #[serde(rename = \"anvil_mine\", alias = \"hardhat_mine\")]\n Mine(\n /// Number of blocks to mine, if not set `1` block is mined\n #[serde(default, deserialize_with = \"deserialize_number_opt\")]\n Option,\n /// The time interval between each block in seconds, defaults to `1` seconds\n /// The interval is applied only to blocks mined in the given method invocation, not to\n /// blocks mined afterwards. Set this to `0` to instantly mine _all_ blocks\n #[serde(default, deserialize_with = \"deserialize_number_opt\")]\n Option,\n ),\n\n /// Enables or disables, based on the single boolean argument, the automatic mining of new\n /// blocks with each new transaction submitted to the network.\n #[serde(rename = \"anvil_setAutomine\", alias = \"evm_setAutomine\", with = \"sequence\")]\n SetAutomine(bool),\n\n /// Sets the mining behavior to interval with the given interval (seconds)\n #[serde(rename = \"anvil_setIntervalMining\", alias = \"evm_setIntervalMining\", with = \"sequence\")]\n SetIntervalMining(u64),\n\n /// Gets the current mining behavior\n #[serde(rename = \"anvil_getIntervalMining\", with = \"empty_params\")]\n GetIntervalMining(()),\n\n /// Removes transactions from the pool\n #[serde(rename = \"anvil_dropTransaction\", alias = \"hardhat_dropTransaction\", with = \"sequence\")]\n DropTransaction(B256),\n\n /// Removes transactions from the pool\n #[serde(\n rename = \"anvil_dropAllTransactions\",\n alias = \"hardhat_dropAllTransactions\",\n with = \"empty_params\"\n )]\n DropAllTransactions(),\n\n /// Reset the fork to a fresh forked state, and optionally update the fork config\n #[serde(rename = \"anvil_reset\", alias = \"hardhat_reset\")]\n Reset(#[serde(default)] Option>>),\n\n /// Sets the backend rpc url\n #[serde(rename = \"anvil_setRpcUrl\", with = \"sequence\")]\n SetRpcUrl(String),\n\n /// Modifies the balance of an account.\n #[serde(\n rename = \"anvil_setBalance\",\n alias = \"hardhat_setBalance\",\n alias = \"tenderly_setBalance\"\n )]\n SetBalance(Address, #[serde(deserialize_with = \"deserialize_number\")] U256),\n\n /// Increases the balance of an account.\n #[serde(\n rename = \"anvil_addBalance\",\n alias = \"hardhat_addBalance\",\n alias = \"tenderly_addBalance\"\n )]\n AddBalance(Address, #[serde(deserialize_with = \"deserialize_number\")] U256),\n\n /// Modifies the ERC20 balance of an account.\n #[serde(\n rename = \"anvil_dealERC20\",\n alias = \"hardhat_dealERC20\",\n alias = \"anvil_setERC20Balance\"\n )]\n DealERC20(Address, Address, #[serde(deserialize_with = \"deserialize_number\")] U256),\n\n /// Sets the ERC20 allowance for a spender\n #[serde(rename = \"anvil_setERC20Allowance\")]\n SetERC20Allowance(\n Address,\n Address,\n Address,\n #[serde(deserialize_with = \"deserialize_number\")] U256,\n ),\n\n /// Sets the code of a contract\n #[serde(rename = \"anvil_setCode\", alias = \"hardhat_setCode\")]\n SetCode(Address, Bytes),\n\n /// Sets the nonce of an address\n #[serde(rename = \"anvil_setNonce\", alias = \"hardhat_setNonce\", alias = \"evm_setAccountNonce\")]\n SetNonce(Address, #[serde(deserialize_with = \"deserialize_number\")] U256),\n\n /// Writes a single slot of the account's storage\n #[serde(rename = \"anvil_setStorageAt\", alias = \"hardhat_setStorageAt\")]\n SetStorageAt(\n Address,\n /// slot\n U256,\n /// value\n B256,\n ),\n\n /// Sets the coinbase address\n #[serde(rename = \"anvil_setCoinbase\", alias = \"hardhat_setCoinbase\", with = \"sequence\")]\n SetCoinbase(Address),\n\n /// Sets the chain id\n #[serde(rename = \"anvil_setChainId\", with = \"sequence\")]\n SetChainId(u64),\n\n /// Enable or disable logging\n #[serde(\n rename = \"anvil_setLoggingEnabled\",\n alias = \"hardhat_setLoggingEnabled\",\n with = \"sequence\"\n )]\n SetLogging(bool),\n\n /// Set the minimum gas price for the node\n #[serde(\n rename = \"anvil_setMinGasPrice\",\n alias = \"hardhat_setMinGasPrice\",\n deserialize_with = \"deserialize_number_seq\"\n )]\n SetMinGasPrice(U256),\n\n /// Sets the base fee of the next block\n #[serde(\n rename = \"anvil_setNextBlockBaseFeePerGas\",\n alias = \"hardhat_setNextBlockBaseFeePerGas\",\n deserialize_with = \"deserialize_number_seq\"\n )]\n SetNextBlockBaseFeePerGas(U256),\n\n /// Sets the specific timestamp\n /// Accepts timestamp (Unix epoch) with millisecond precision and returns the number of seconds\n /// between the given timestamp and the current time.\n #[serde(\n rename = \"anvil_setTime\",\n alias = \"evm_setTime\",\n deserialize_with = \"deserialize_number_seq\"\n )]\n EvmSetTime(U256),\n\n /// Serializes the current state (including contracts code, contract's storage, accounts\n /// properties, etc.) into a saveable data blob\n #[serde(rename = \"anvil_dumpState\", alias = \"hardhat_dumpState\")]\n DumpState(#[serde(default)] Option>>),\n\n /// Adds state previously dumped with `DumpState` to the current chain\n #[serde(rename = \"anvil_loadState\", alias = \"hardhat_loadState\", with = \"sequence\")]\n LoadState(Bytes),\n\n /// Retrieves the Anvil node configuration params\n #[serde(rename = \"anvil_nodeInfo\", with = \"empty_params\")]\n NodeInfo(()),\n\n /// Retrieves the Anvil node metadata.\n #[serde(rename = \"anvil_metadata\", alias = \"hardhat_metadata\", with = \"empty_params\")]\n AnvilMetadata(()),\n\n // Ganache compatible calls\n /// Snapshot the state of the blockchain at the current block.\n ///\n /// Ref \n #[serde(rename = \"anvil_snapshot\", alias = \"evm_snapshot\", with = \"empty_params\")]\n EvmSnapshot(()),\n\n /// Revert the state of the blockchain to a previous snapshot.\n /// Takes a single parameter, which is the snapshot id to revert to.\n ///\n /// Ref \n #[serde(\n rename = \"anvil_revert\",\n alias = \"evm_revert\",\n deserialize_with = \"deserialize_number_seq\"\n )]\n EvmRevert(U256),\n\n /// Jump forward in time by the given amount of time, in seconds.\n #[serde(\n rename = \"anvil_increaseTime\",\n alias = \"evm_increaseTime\",\n deserialize_with = \"deserialize_number_seq\"\n )]\n EvmIncreaseTime(U256),\n\n /// Similar to `evm_increaseTime` but takes the exact timestamp that you want in the next block\n #[serde(\n rename = \"anvil_setNextBlockTimestamp\",\n alias = \"evm_setNextBlockTimestamp\",\n deserialize_with = \"deserialize_number_seq\"\n )]\n EvmSetNextBlockTimeStamp(U256),\n\n /// Set the exact gas limit that you want in the next block\n #[serde(\n rename = \"anvil_setBlockGasLimit\",\n alias = \"evm_setBlockGasLimit\",\n deserialize_with = \"deserialize_number_seq\"\n )]\n EvmSetBlockGasLimit(U256),\n\n /// Similar to `evm_increaseTime` but takes sets a block timestamp `interval`.\n ///\n /// The timestamp of the next block will be computed as `lastBlock_timestamp + interval`.\n #[serde(rename = \"anvil_setBlockTimestampInterval\", with = \"sequence\")]\n EvmSetBlockTimeStampInterval(u64),\n\n /// Removes a `anvil_setBlockTimestampInterval` if it exists\n #[serde(rename = \"anvil_removeBlockTimestampInterval\", with = \"empty_params\")]\n EvmRemoveBlockTimeStampInterval(()),\n\n /// Mine a single block\n #[serde(rename = \"evm_mine\")]\n EvmMine(#[serde(default)] Option>>),\n\n /// Mine a single block and return detailed data\n ///\n /// This behaves exactly as `EvmMine` but returns different output, for compatibility reasons\n /// this is a separate call since `evm_mine` is not an anvil original.\n #[serde(rename = \"anvil_mine_detailed\", alias = \"evm_mine_detailed\")]\n EvmMineDetailed(#[serde(default)] Option>>),\n\n /// Execute a transaction regardless of signature status\n #[serde(rename = \"eth_sendUnsignedTransaction\", with = \"sequence\")]\n EthSendUnsignedTransaction(Box>),\n\n /// Returns the number of transactions currently pending for inclusion in the next block(s), as\n /// well as the ones that are being scheduled for future execution only.\n /// Ref: \n #[serde(rename = \"txpool_status\", with = \"empty_params\")]\n TxPoolStatus(()),\n\n /// Returns a summary of all the transactions currently pending for inclusion in the next\n /// block(s), as well as the ones that are being scheduled for future execution only.\n /// Ref: \n #[serde(rename = \"txpool_inspect\", with = \"empty_params\")]\n TxPoolInspect(()),\n\n /// Returns the details of all transactions currently pending for inclusion in the next\n /// block(s), as well as the ones that are being scheduled for future execution only.\n /// Ref: \n #[serde(rename = \"txpool_content\", with = \"empty_params\")]\n TxPoolContent(()),\n\n /// Otterscan's `ots_getApiLevel` endpoint\n /// Otterscan currently requires this endpoint, even though it's not part of the ots_*\n /// \n /// Related upstream issue: \n #[serde(rename = \"erigon_getHeaderByNumber\")]\n ErigonGetHeaderByNumber(\n #[serde(deserialize_with = \"lenient_block_number::lenient_block_number_seq\")] BlockNumber,\n ),\n\n /// Otterscan's `ots_getApiLevel` endpoint\n /// Used as a simple API versioning scheme for the ots_* namespace\n #[serde(rename = \"ots_getApiLevel\", with = \"empty_params\")]\n OtsGetApiLevel(()),\n\n /// Otterscan's `ots_getInternalOperations` endpoint\n /// Traces internal ETH transfers, contracts creation (CREATE/CREATE2) and self-destructs for a\n /// certain transaction.\n #[serde(rename = \"ots_getInternalOperations\", with = \"sequence\")]\n OtsGetInternalOperations(B256),\n\n /// Otterscan's `ots_hasCode` endpoint\n /// Check if an ETH address contains code at a certain block number.\n #[serde(rename = \"ots_hasCode\")]\n OtsHasCode(\n Address,\n #[serde(deserialize_with = \"lenient_block_number::lenient_block_number\", default)]\n BlockNumber,\n ),\n\n /// Otterscan's `ots_traceTransaction` endpoint\n /// Trace a transaction and generate a trace call tree.\n #[serde(rename = \"ots_traceTransaction\", with = \"sequence\")]\n OtsTraceTransaction(B256),\n\n /// Otterscan's `ots_getTransactionError` endpoint\n /// Given a transaction hash, returns its raw revert reason.\n #[serde(rename = \"ots_getTransactionError\", with = \"sequence\")]\n OtsGetTransactionError(B256),\n\n /// Otterscan's `ots_getBlockDetails` endpoint\n /// Given a block number, return its data. Similar to the standard eth_getBlockByNumber/Hash\n /// method, but can be optimized by excluding unnecessary data such as transactions and\n /// logBloom\n #[serde(rename = \"ots_getBlockDetails\")]\n OtsGetBlockDetails(\n #[serde(deserialize_with = \"lenient_block_number::lenient_block_number_seq\", default)]\n BlockNumber,\n ),\n\n /// Otterscan's `ots_getBlockDetails` endpoint\n /// Same as `ots_getBlockDetails`, but receiving a block hash instead of number\n #[serde(rename = \"ots_getBlockDetailsByHash\", with = \"sequence\")]\n OtsGetBlockDetailsByHash(B256),\n\n /// Otterscan's `ots_getBlockTransactions` endpoint\n /// Gets paginated transaction data for a certain block. Return data is similar to\n /// eth_getBlockBy* + eth_getTransactionReceipt.\n #[serde(rename = \"ots_getBlockTransactions\")]\n OtsGetBlockTransactions(u64, usize, usize),\n\n /// Otterscan's `ots_searchTransactionsBefore` endpoint\n /// Address history navigation. searches backwards from certain point in time.\n #[serde(rename = \"ots_searchTransactionsBefore\")]\n OtsSearchTransactionsBefore(Address, u64, usize),\n\n /// Otterscan's `ots_searchTransactionsAfter` endpoint\n /// Address history navigation. searches forward from certain point in time.\n #[serde(rename = \"ots_searchTransactionsAfter\")]\n OtsSearchTransactionsAfter(Address, u64, usize),\n\n /// Otterscan's `ots_getTransactionBySenderAndNonce` endpoint\n /// Given a sender address and a nonce, returns the tx hash or null if not found. It returns\n /// only the tx hash on success, you can use the standard eth_getTransactionByHash after that\n /// to get the full transaction data.\n #[serde(rename = \"ots_getTransactionBySenderAndNonce\")]\n OtsGetTransactionBySenderAndNonce(\n Address,\n #[serde(deserialize_with = \"deserialize_number\")] U256,\n ),\n\n /// Returns the transaction by sender and nonce\n /// Returns the full transaction data.\n #[serde(rename = \"eth_getTransactionBySenderAndNonce\")]\n EthGetTransactionBySenderAndNonce(\n Address,\n #[serde(deserialize_with = \"deserialize_number\")] U256,\n ),\n\n /// Otterscan's `ots_getTransactionBySenderAndNonce` endpoint\n /// Given an ETH contract address, returns the tx hash and the direct address who created the\n /// contract.\n #[serde(rename = \"ots_getContractCreator\", with = \"sequence\")]\n OtsGetContractCreator(Address),\n\n /// Removes transactions from the pool by sender origin.\n #[serde(rename = \"anvil_removePoolTransactions\", with = \"sequence\")]\n RemovePoolTransactions(Address),\n\n /// Reorg the chain\n #[serde(rename = \"anvil_reorg\")]\n Reorg(ReorgOptions),\n\n /// Rollback the chain\n #[serde(rename = \"anvil_rollback\", with = \"sequence\")]\n Rollback(Option),\n}\n\n/// Represents ethereum JSON-RPC API\n#[derive(Clone, Debug, PartialEq, Eq, serde::Deserialize)]\n#[serde(tag = \"method\", content = \"params\")]\npub enum EthPubSub {\n /// Subscribe to an eth subscription\n #[serde(rename = \"eth_subscribe\")]\n EthSubscribe(SubscriptionKind, #[serde(default)] Box),\n\n /// Unsubscribe from an eth subscription\n #[serde(rename = \"eth_unsubscribe\", with = \"sequence\")]\n EthUnSubscribe(SubscriptionId),\n}\n\n/// Container type for either a request or a pub sub\n#[derive(Clone, Debug, serde::Deserialize)]\n#[serde(untagged)]\npub enum EthRpcCall {\n Request(Box),\n PubSub(EthPubSub),\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n\n #[test]\n fn test_web3_client_version() {\n let s = r#\"{\"method\": \"web3_clientVersion\", \"params\":[]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_web3_sha3() {\n let s = r#\"{\"method\": \"web3_sha3\", \"params\":[\"0x68656c6c6f20776f726c64\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_eth_accounts() {\n let s = r#\"{\"method\": \"eth_accounts\", \"params\":[]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_eth_network_id() {\n let s = r#\"{\"method\": \"eth_networkId\", \"params\":[]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_eth_get_proof() {\n let s = r#\"{\"method\":\"eth_getProof\",\"params\":[\"0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842\",[\"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\"],\"latest\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_eth_chain_id() {\n let s = r#\"{\"method\": \"eth_chainId\", \"params\":[]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_net_listening() {\n let s = r#\"{\"method\": \"net_listening\", \"params\":[]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_eth_block_number() {\n let s = r#\"{\"method\": \"eth_blockNumber\", \"params\":[]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_eth_max_priority_fee() {\n let s = r#\"{\"method\": \"eth_maxPriorityFeePerGas\", \"params\":[]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_eth_syncing() {\n let s = r#\"{\"method\": \"eth_syncing\", \"params\":[]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_custom_impersonate_account() {\n let s = r#\"{\"method\": \"anvil_impersonateAccount\", \"params\":\n[\"0xd84de507f3fada7df80908082d3239466db55a71\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_custom_stop_impersonate_account() {\n let s = r#\"{\"method\": \"anvil_stopImpersonatingAccount\", \"params\":\n[\"0x364d6D0333432C3Ac016Ca832fb8594A8cE43Ca6\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_custom_auto_impersonate_account() {\n let s = r#\"{\"method\": \"anvil_autoImpersonateAccount\", \"params\": [true]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_custom_get_automine() {\n let s = r#\"{\"method\": \"anvil_getAutomine\", \"params\": []}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_custom_mine() {\n let s = r#\"{\"method\": \"anvil_mine\", \"params\": []}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let req = serde_json::from_value::(value).unwrap();\n match req {\n EthRequest::Mine(num, time) => {\n assert!(num.is_none());\n assert!(time.is_none());\n }\n _ => unreachable!(),\n }\n let s = r#\"{\"method\": \"anvil_mine\", \"params\":\n[\"0xd84de507f3fada7df80908082d3239466db55a71\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let req = serde_json::from_value::(value).unwrap();\n match req {\n EthRequest::Mine(num, time) => {\n assert!(num.is_some());\n assert!(time.is_none());\n }\n _ => unreachable!(),\n }\n let s = r#\"{\"method\": \"anvil_mine\", \"params\": [\"0xd84de507f3fada7df80908082d3239466db55a71\", \"0xd84de507f3fada7df80908082d3239466db55a71\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let req = serde_json::from_value::(value).unwrap();\n match req {\n EthRequest::Mine(num, time) => {\n assert!(num.is_some());\n assert!(time.is_some());\n }\n _ => unreachable!(),\n }\n }\n\n #[test]\n fn test_custom_auto_mine() {\n let s = r#\"{\"method\": \"anvil_setAutomine\", \"params\": [false]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n let s = r#\"{\"method\": \"evm_setAutomine\", \"params\": [false]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_custom_interval_mining() {\n let s = r#\"{\"method\": \"anvil_setIntervalMining\", \"params\": [100]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n let s = r#\"{\"method\": \"evm_setIntervalMining\", \"params\": [100]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_custom_drop_tx() {\n let s = r#\"{\"method\": \"anvil_dropTransaction\", \"params\":\n[\"0x4a3b0fce2cb9707b0baa68640cf2fe858c8bb4121b2a8cb904ff369d38a560ff\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_custom_reset() {\n let s = r#\"{\"method\": \"anvil_reset\", \"params\": [{\"forking\": {\"jsonRpcUrl\": \"https://ethereumpublicnode.com\",\n \"blockNumber\": \"18441649\"\n }\n }]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let req = serde_json::from_value::(value).unwrap();\n match req {\n EthRequest::Reset(forking) => {\n let forking = forking.and_then(|f| f.params);\n assert_eq!(\n forking,\n Some(Forking {\n json_rpc_url: Some(\"https://ethereumpublicnode.com\".into()),\n block_number: Some(18441649)\n })\n )\n }\n _ => unreachable!(),\n }\n\n let s = r#\"{\"method\": \"anvil_reset\", \"params\": [ { \"forking\": {\n \"jsonRpcUrl\": \"https://eth-mainnet.alchemyapi.io/v2/\",\n \"blockNumber\": 11095000\n }}]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let req = serde_json::from_value::(value).unwrap();\n match req {\n EthRequest::Reset(forking) => {\n let forking = forking.and_then(|f| f.params);\n assert_eq!(\n forking,\n Some(Forking {\n json_rpc_url: Some(\n \"https://eth-mainnet.alchemyapi.io/v2/\".to_string()\n ),\n block_number: Some(11095000)\n })\n )\n }\n _ => unreachable!(),\n }\n\n let s = r#\"{\"method\": \"anvil_reset\", \"params\": [ { \"forking\": {\n \"jsonRpcUrl\": \"https://eth-mainnet.alchemyapi.io/v2/\"\n }}]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let req = serde_json::from_value::(value).unwrap();\n match req {\n EthRequest::Reset(forking) => {\n let forking = forking.and_then(|f| f.params);\n assert_eq!(\n forking,\n Some(Forking {\n json_rpc_url: Some(\n \"https://eth-mainnet.alchemyapi.io/v2/\".to_string()\n ),\n block_number: None\n })\n )\n }\n _ => unreachable!(),\n }\n\n let s = r#\"{\"method\":\"anvil_reset\",\"params\":[{\"jsonRpcUrl\": \"http://localhost:8545\", \"blockNumber\": 14000000}]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let req = serde_json::from_value::(value).unwrap();\n match req {\n EthRequest::Reset(forking) => {\n let forking = forking.and_then(|f| f.params);\n assert_eq!(\n forking,\n Some(Forking {\n json_rpc_url: Some(\"http://localhost:8545\".to_string()),\n block_number: Some(14000000)\n })\n )\n }\n _ => unreachable!(),\n }\n\n let s = r#\"{\"method\":\"anvil_reset\",\"params\":[{ \"blockNumber\": 14000000}]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let req = serde_json::from_value::(value).unwrap();\n match req {\n EthRequest::Reset(forking) => {\n let forking = forking.and_then(|f| f.params);\n assert_eq!(\n forking,\n Some(Forking { json_rpc_url: None, block_number: Some(14000000) })\n )\n }\n _ => unreachable!(),\n }\n\n let s = r#\"{\"method\":\"anvil_reset\",\"params\":[{ \"blockNumber\": \"14000000\"}]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let req = serde_json::from_value::(value).unwrap();\n match req {\n EthRequest::Reset(forking) => {\n let forking = forking.and_then(|f| f.params);\n assert_eq!(\n forking,\n Some(Forking { json_rpc_url: None, block_number: Some(14000000) })\n )\n }\n _ => unreachable!(),\n }\n\n let s = r#\"{\"method\":\"anvil_reset\",\"params\":[{\"jsonRpcUrl\": \"http://localhost:8545\"}]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let req = serde_json::from_value::(value).unwrap();\n match req {\n EthRequest::Reset(forking) => {\n let forking = forking.and_then(|f| f.params);\n assert_eq!(\n forking,\n Some(Forking {\n json_rpc_url: Some(\"http://localhost:8545\".to_string()),\n block_number: None\n })\n )\n }\n _ => unreachable!(),\n }\n\n let s = r#\"{\"method\": \"anvil_reset\"}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let req = serde_json::from_value::(value).unwrap();\n match req {\n EthRequest::Reset(forking) => {\n assert!(forking.is_none())\n }\n _ => unreachable!(),\n }\n }\n\n #[test]\n fn test_custom_set_balance() {\n let s = r#\"{\"method\": \"anvil_setBalance\", \"params\":\n[\"0xd84de507f3fada7df80908082d3239466db55a71\", \"0x0\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"method\": \"anvil_setBalance\", \"params\":\n[\"0xd84de507f3fada7df80908082d3239466db55a71\", 1337]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_custom_set_code() {\n let s = r#\"{\"method\": \"anvil_setCode\", \"params\":\n[\"0xd84de507f3fada7df80908082d3239466db55a71\", \"0x0123456789abcdef\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"method\": \"anvil_setCode\", \"params\":\n[\"0xd84de507f3fada7df80908082d3239466db55a71\", \"0x\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"method\": \"anvil_setCode\", \"params\":\n[\"0xd84de507f3fada7df80908082d3239466db55a71\", \"\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_custom_set_nonce() {\n let s = r#\"{\"method\": \"anvil_setNonce\", \"params\":\n[\"0xd84de507f3fada7df80908082d3239466db55a71\", \"0x0\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n let s = r#\"{\"method\":\n\"hardhat_setNonce\", \"params\": [\"0xd84de507f3fada7df80908082d3239466db55a71\", \"0x0\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n let s = r#\"{\"method\": \"evm_setAccountNonce\", \"params\":\n[\"0xd84de507f3fada7df80908082d3239466db55a71\", \"0x0\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_custom_set_storage_at() {\n let s = r#\"{\"method\": \"anvil_setStorageAt\", \"params\":\n[\"0x295a70b2de5e3953354a6a8344e616ed314d7251\", \"0x0\",\n\"0x0000000000000000000000000000000000000000000000000000000000003039\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"method\": \"hardhat_setStorageAt\", \"params\":\n[\"0xe9e7CEA3DedcA5984780Bafc599bD69ADd087D56\",\n\"0xa6eef7e35abe7026729641147f7915573c7e97b47efa546f5f6e3230263bcb49\",\n\"0x0000000000000000000000000000000000000000000000000000000000003039\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_custom_coinbase() {\n let s = r#\"{\"method\": \"anvil_setCoinbase\", \"params\":\n[\"0x295a70b2de5e3953354a6a8344e616ed314d7251\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_custom_logging() {\n let s = r#\"{\"method\": \"anvil_setLoggingEnabled\", \"params\": [false]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_custom_min_gas_price() {\n let s = r#\"{\"method\": \"anvil_setMinGasPrice\", \"params\": [\"0x0\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_custom_next_block_base_fee() {\n let s = r#\"{\"method\": \"anvil_setNextBlockBaseFeePerGas\", \"params\": [\"0x0\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_set_time() {\n let s = r#\"{\"method\": \"anvil_setTime\", \"params\": [\"0x0\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"method\": \"anvil_increaseTime\", \"params\": 1}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_custom_dump_state() {\n let s = r#\"{\"method\": \"anvil_dumpState\", \"params\": [true]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"method\": \"anvil_dumpState\"}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let req = serde_json::from_value::(value).unwrap();\n match req {\n EthRequest::DumpState(param) => {\n assert!(param.is_none());\n }\n _ => unreachable!(),\n }\n }\n\n #[test]\n fn test_serde_custom_load_state() {\n let s = r#\"{\"method\": \"anvil_loadState\", \"params\": [\"0x0001\"] }\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_custom_snapshot() {\n let s = r#\"{\"method\": \"anvil_snapshot\", \"params\": [] }\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"method\": \"evm_snapshot\", \"params\": [] }\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_custom_revert() {\n let s = r#\"{\"method\": \"anvil_revert\", \"params\": [\"0x0\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_custom_increase_time() {\n let s = r#\"{\"method\": \"anvil_increaseTime\", \"params\": [\"0x0\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"method\": \"anvil_increaseTime\", \"params\": [1]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"method\": \"anvil_increaseTime\", \"params\": 1}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"method\": \"evm_increaseTime\", \"params\": [\"0x0\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"method\": \"evm_increaseTime\", \"params\": [1]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"method\": \"evm_increaseTime\", \"params\": 1}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_custom_next_timestamp() {\n let s = r#\"{\"method\": \"anvil_setNextBlockTimestamp\", \"params\": [100]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n let s = r#\"{\"method\": \"evm_setNextBlockTimestamp\", \"params\": [100]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n let s = r#\"{\"method\": \"evm_setNextBlockTimestamp\", \"params\": [\"0x64e0f308\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_custom_timestamp_interval() {\n let s = r#\"{\"method\": \"anvil_setBlockTimestampInterval\", \"params\": [100]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_custom_remove_timestamp_interval() {\n let s = r#\"{\"method\": \"anvil_removeBlockTimestampInterval\", \"params\": []}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_custom_evm_mine() {\n let s = r#\"{\"method\": \"evm_mine\", \"params\": [100]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n let s = r#\"{\"method\": \"evm_mine\", \"params\": [{\n \"timestamp\": 100,\n \"blocks\": 100\n }]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let req = serde_json::from_value::(value).unwrap();\n match req {\n EthRequest::EvmMine(params) => {\n assert_eq!(\n params.unwrap().params.unwrap_or_default(),\n MineOptions::Options { timestamp: Some(100), blocks: Some(100) }\n )\n }\n _ => unreachable!(),\n }\n\n let s = r#\"{\"method\": \"evm_mine\"}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let req = serde_json::from_value::(value).unwrap();\n\n match req {\n EthRequest::EvmMine(params) => {\n assert!(params.is_none())\n }\n _ => unreachable!(),\n }\n\n let s = r#\"{\"method\": \"evm_mine\", \"params\": []}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_custom_evm_mine_detailed() {\n let s = r#\"{\"method\": \"anvil_mine_detailed\", \"params\": [100]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n let s = r#\"{\"method\": \"anvil_mine_detailed\", \"params\": [{\n \"timestamp\": 100,\n \"blocks\": 100\n }]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let req = serde_json::from_value::(value).unwrap();\n match req {\n EthRequest::EvmMineDetailed(params) => {\n assert_eq!(\n params.unwrap().params.unwrap_or_default(),\n MineOptions::Options { timestamp: Some(100), blocks: Some(100) }\n )\n }\n _ => unreachable!(),\n }\n\n let s = r#\"{\"method\": \"evm_mine_detailed\"}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let req = serde_json::from_value::(value).unwrap();\n\n match req {\n EthRequest::EvmMineDetailed(params) => {\n assert!(params.is_none())\n }\n _ => unreachable!(),\n }\n\n let s = r#\"{\"method\": \"anvil_mine_detailed\", \"params\": []}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_custom_evm_mine_hex() {\n let s = r#\"{\"method\": \"evm_mine\", \"params\": [\"0x63b6ff08\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let req = serde_json::from_value::(value).unwrap();\n match req {\n EthRequest::EvmMine(params) => {\n assert_eq!(\n params.unwrap().params.unwrap_or_default(),\n MineOptions::Timestamp(Some(1672937224))\n )\n }\n _ => unreachable!(),\n }\n\n let s = r#\"{\"method\": \"evm_mine\", \"params\": [{\"timestamp\": \"0x63b6ff08\"}]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let req = serde_json::from_value::(value).unwrap();\n match req {\n EthRequest::EvmMine(params) => {\n assert_eq!(\n params.unwrap().params.unwrap_or_default(),\n MineOptions::Options { timestamp: Some(1672937224), blocks: None }\n )\n }\n _ => unreachable!(),\n }\n }\n\n #[test]\n fn test_eth_uncle_count_by_block_hash() {\n let s = r#\"{\"jsonrpc\":\"2.0\",\"method\":\"eth_getUncleCountByBlockHash\",\"params\":[\"0x4a3b0fce2cb9707b0baa68640cf2fe858c8bb4121b2a8cb904ff369d38a560ff\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_eth_block_tx_count_by_block_hash() {\n let s = r#\"{\"jsonrpc\":\"2.0\",\"method\":\"eth_getBlockTransactionCountByHash\",\"params\":[\"0x4a3b0fce2cb9707b0baa68640cf2fe858c8bb4121b2a8cb904ff369d38a560ff\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_eth_get_logs() {\n let s = r#\"{\"jsonrpc\":\"2.0\",\"method\":\"eth_getLogs\",\"params\":[{\"topics\":[\"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b\"]}],\"id\":74}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_eth_new_filter() {\n let s = r#\"{\"method\": \"eth_newFilter\", \"params\": [{\"topics\":[\"0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b\"]}],\"id\":73}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_eth_unsubscribe() {\n let s = r#\"{\"id\": 1, \"method\": \"eth_unsubscribe\", \"params\":\n[\"0x9cef478923ff08bf67fde6c64013158d\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_eth_subscribe() {\n let s = r#\"{\"id\": 1, \"method\": \"eth_subscribe\", \"params\": [\"newHeads\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"id\": 1, \"method\": \"eth_subscribe\", \"params\": [\"logs\", {\"address\":\n\"0x8320fe7702b96808f7bbc0d4a888ed1468216cfd\", \"topics\":\n[\"0xd78a0cb8bb633d06981248b816e7bd33c2a35a6089241d099fa519e361cab902\"]}]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"id\": 1, \"method\": \"eth_subscribe\", \"params\": [\"newPendingTransactions\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"id\": 1, \"method\": \"eth_subscribe\", \"params\": [\"syncing\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_debug_raw_transaction() {\n let s = r#\"{\"jsonrpc\":\"2.0\",\"method\":\"debug_getRawTransaction\",\"params\":[\"0x3ed3a89bc10115a321aee238c02de214009f8532a65368e5df5eaf732ee7167c\"],\"id\":1}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"jsonrpc\":\"2.0\",\"method\":\"eth_getRawTransactionByHash\",\"params\":[\"0x3ed3a89bc10115a321aee238c02de214009f8532a65368e5df5eaf732ee7167c\"],\"id\":1}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"jsonrpc\":\"2.0\",\"method\":\"eth_getRawTransactionByBlockHashAndIndex\",\"params\":[\"0x3ed3a89bc10115a321aee238c02de214009f8532a65368e5df5eaf732ee7167c\",1],\"id\":1}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"jsonrpc\":\"2.0\",\"method\":\"eth_getRawTransactionByBlockNumberAndIndex\",\"params\":[\"0x3ed3a89b\",0],\"id\":1}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_debug_trace_transaction() {\n let s = r#\"{\"method\": \"debug_traceTransaction\", \"params\":\n[\"0x4a3b0fce2cb9707b0baa68640cf2fe858c8bb4121b2a8cb904ff369d38a560ff\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"method\": \"debug_traceTransaction\", \"params\":\n[\"0x4a3b0fce2cb9707b0baa68640cf2fe858c8bb4121b2a8cb904ff369d38a560ff\", {}]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"method\": \"debug_traceTransaction\", \"params\":\n[\"0x4a3b0fce2cb9707b0baa68640cf2fe858c8bb4121b2a8cb904ff369d38a560ff\", {\"disableStorage\":\ntrue}]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_debug_trace_call() {\n let s = r#\"{\"method\": \"debug_traceCall\", \"params\": [{\"data\":\"0xcfae3217\",\"from\":\"0xd84de507f3fada7df80908082d3239466db55a71\",\"to\":\"0xcbe828fdc46e3b1c351ec90b1a5e7d9742c0398d\"}]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"method\": \"debug_traceCall\", \"params\": [{\"data\":\"0xcfae3217\",\"from\":\"0xd84de507f3fada7df80908082d3239466db55a71\",\"to\":\"0xcbe828fdc46e3b1c351ec90b1a5e7d9742c0398d\"}, { \"blockNumber\": \"latest\" }]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"method\": \"debug_traceCall\", \"params\": [{\"data\":\"0xcfae3217\",\"from\":\"0xd84de507f3fada7df80908082d3239466db55a71\",\"to\":\"0xcbe828fdc46e3b1c351ec90b1a5e7d9742c0398d\"}, { \"blockNumber\": \"0x0\" }]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"method\": \"debug_traceCall\", \"params\": [{\"data\":\"0xcfae3217\",\"from\":\"0xd84de507f3fada7df80908082d3239466db55a71\",\"to\":\"0xcbe828fdc46e3b1c351ec90b1a5e7d9742c0398d\"}, { \"blockHash\": \"0xd4e56740f876aef8c010b86a40d5f56745a118d0906a34e69aec8c0db1cb8fa3\" }]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n let s = r#\"{\"method\": \"debug_traceCall\", \"params\": [{\"data\":\"0xcfae3217\",\"from\":\"0xd84de507f3fada7df80908082d3239466db55a71\",\"to\":\"0xcbe828fdc46e3b1c351ec90b1a5e7d9742c0398d\"}, { \"blockNumber\": \"0x0\" }, {\"disableStorage\": true}]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_eth_storage() {\n let s = r#\"{\"method\": \"eth_getStorageAt\", \"params\":\n[\"0x295a70b2de5e3953354a6a8344e616ed314d7251\", \"0x0\", \"latest\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_eth_call() {\n let req = r#\"{\"data\":\"0xcfae3217\",\"from\":\"0xd84de507f3fada7df80908082d3239466db55a71\",\"to\":\"0xcbe828fdc46e3b1c351ec90b1a5e7d9742c0398d\"}\"#;\n let _req = serde_json::from_str::(req).unwrap();\n\n let s = r#\"{\"method\": \"eth_call\", \"params\":[{\"data\":\"0xcfae3217\",\"from\":\"0xd84de507f3fada7df80908082d3239466db55a71\",\"to\":\"0xcbe828fdc46e3b1c351ec90b1a5e7d9742c0398d\"},\"latest\"]}\"#;\n let _req = serde_json::from_str::(s).unwrap();\n\n let s = r#\"{\"method\": \"eth_call\", \"params\":[{\"data\":\"0xcfae3217\",\"from\":\"0xd84de507f3fada7df80908082d3239466db55a71\",\"to\":\"0xcbe828fdc46e3b1c351ec90b1a5e7d9742c0398d\"}]}\"#;\n let _req = serde_json::from_str::(s).unwrap();\n\n let s = r#\"{\"method\": \"eth_call\", \"params\":[{\"data\":\"0xcfae3217\",\"from\":\"0xd84de507f3fada7df80908082d3239466db55a71\",\"to\":\"0xcbe828fdc46e3b1c351ec90b1a5e7d9742c0398d\"}, { \"blockNumber\": \"latest\" }]}\"#;\n let _req = serde_json::from_str::(s).unwrap();\n\n let s = r#\"{\"method\": \"eth_call\", \"params\":[{\"data\":\"0xcfae3217\",\"from\":\"0xd84de507f3fada7df80908082d3239466db55a71\",\"to\":\"0xcbe828fdc46e3b1c351ec90b1a5e7d9742c0398d\"}, { \"blockNumber\": \"0x0\" }]}\"#;\n let _req = serde_json::from_str::(s).unwrap();\n\n let s = r#\"{\"method\": \"eth_call\", \"params\":[{\"data\":\"0xcfae3217\",\"from\":\"0xd84de507f3fada7df80908082d3239466db55a71\",\"to\":\"0xcbe828fdc46e3b1c351ec90b1a5e7d9742c0398d\"}, { \"blockHash\":\"0xd4e56740f876aef8c010b86a40d5f56745a118d0906a34e69aec8c0db1cb8fa3\" }]}\"#;\n let _req = serde_json::from_str::(s).unwrap();\n }\n\n #[test]\n fn test_serde_eth_balance() {\n let s = r#\"{\"method\": \"eth_getBalance\", \"params\":\n[\"0x295a70b2de5e3953354a6a8344e616ed314d7251\", \"latest\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_eth_block_by_number() {\n let s = r#\"{\"method\": \"eth_getBlockByNumber\", \"params\": [\"0x0\", true]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n let s = r#\"{\"method\": \"eth_getBlockByNumber\", \"params\": [\"latest\", true]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n let s = r#\"{\"method\": \"eth_getBlockByNumber\", \"params\": [\"earliest\", true]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n let s = r#\"{\"method\": \"eth_getBlockByNumber\", \"params\": [\"pending\", true]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n\n // this case deviates from the spec, but we're supporting this for legacy reasons: \n let s = r#\"{\"method\": \"eth_getBlockByNumber\", \"params\": [0, true]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_eth_sign() {\n let s = r#\"{\"method\": \"eth_sign\", \"params\":\n[\"0xd84de507f3fada7df80908082d3239466db55a71\", \"0x00\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n let s = r#\"{\"method\": \"personal_sign\", \"params\":\n[\"0x00\", \"0xd84de507f3fada7df80908082d3239466db55a71\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_eth_sign_typed_data() {\n let s = r#\"{\"method\":\"eth_signTypedData_v4\",\"params\":[\"0xCD2a3d9F938E13CD947Ec05AbC7FE734Df8DD826\", {\"types\":{\"EIP712Domain\":[{\"name\":\"name\",\"type\":\"string\"},{\"name\":\"version\",\"type\":\"string\"},{\"name\":\"chainId\",\"type\":\"uint256\"},{\"name\":\"verifyingContract\",\"type\":\"address\"}],\"Person\":[{\"name\":\"name\",\"type\":\"string\"},{\"name\":\"wallet\",\"type\":\"address\"}],\"Mail\":[{\"name\":\"from\",\"type\":\"Person\"},{\"name\":\"to\",\"type\":\"Person\"},{\"name\":\"contents\",\"type\":\"string\"}]},\"primaryType\":\"Mail\",\"domain\":{\"name\":\"Ether Mail\",\"version\":\"1\",\"chainId\":1,\"verifyingContract\":\"0xCcCCccccCCCCcCCCCCCcCcCccCcCCCcCcccccccC\"},\"message\":{\"from\":{\"name\":\"Cow\",\"wallet\":\"0xCD2a3d9F938E13CD947Ec05AbC7FE734Df8DD826\"},\"to\":{\"name\":\"Bob\",\"wallet\":\"0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB\"},\"contents\":\"Hello, Bob!\"}}]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_remove_pool_transactions() {\n let s = r#\"{\"method\": \"anvil_removePoolTransactions\", \"params\":[\"0x364d6D0333432C3Ac016Ca832fb8594A8cE43Ca6\"]}\"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n\n #[test]\n fn test_serde_anvil_reorg() {\n // TransactionData::JSON\n let s = r#\"\n {\n \"method\": \"anvil_reorg\",\n \"params\": [\n 5,\n [\n [\n {\n \"from\": \"0x976EA74026E726554dB657fA54763abd0C3a0aa9\",\n \"to\": \"0x1199bc69f16FDD6690DC40339EC445FaE1b6DD11\",\n \"value\": 100\n },\n 1\n ],\n [\n {\n \"from\": \"0x976EA74026E726554dB657fA54763abd0C3a0aa9\",\n \"to\": \"0x1199bc69f16FDD6690DC40339EC445FaE1b6DD11\",\n \"value\": 200\n },\n 2\n ]\n ]\n ]\n }\n \"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n // TransactionData::Raw\n let s = r#\"\n {\n \"method\": \"anvil_reorg\",\n \"params\": [\n 5,\n [\n [\n \"0x19d55c67e1ba8f1bbdfed75f8ad524ebf087e4ecb848a2d19881d7a5e3d2c54e1732cb1b462da3b3fdb05bdf4c4d3c8e3c9fcebdc2ab5fa5d59a3f752888f27e1b\",\n 1\n ]\n ]\n ]\n }\n \"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n // TransactionData::Raw and TransactionData::JSON\n let s = r#\"\n {\n \"method\": \"anvil_reorg\",\n \"params\": [\n 5,\n [\n [\n \"0x19d55c67e1ba8f1bbdfed75f8ad524ebf087e4ecb848a2d19881d7a5e3d2c54e1732cb1b462da3b3fdb05bdf4c4d3c8e3c9fcebdc2ab5fa5d59a3f752888f27e1b\",\n 1\n ],\n [\n {\n \"from\": \"0x976EA74026E726554dB657fA54763abd0C3a0aa9\",\n \"to\": \"0x1199bc69f16FDD6690DC40339EC445FaE1b6DD11\",\n \"value\": 200\n },\n 2\n ]\n ]\n ]\n }\n \"#;\n let value: serde_json::Value = serde_json::from_str(s).unwrap();\n let _req = serde_json::from_value::(value).unwrap();\n }\n}\n" }, { "path": "crates/anvil/core/src/eth/serde_helpers.rs", "content": "//! custom serde helper functions\n\npub mod sequence {\n use serde::{\n Deserialize, Deserializer, Serialize, Serializer, de::DeserializeOwned, ser::SerializeSeq,\n };\n\n pub fn serialize(val: &T, s: S) -> Result\n where\n S: Serializer,\n T: Serialize,\n {\n let mut seq = s.serialize_seq(Some(1))?;\n seq.serialize_element(val)?;\n seq.end()\n }\n\n pub fn deserialize<'de, T, D>(d: D) -> Result\n where\n D: Deserializer<'de>,\n T: DeserializeOwned,\n {\n let mut seq = Vec::::deserialize(d)?;\n if seq.len() != 1 {\n return Err(serde::de::Error::custom(format!(\n \"expected params sequence with length 1 but got {}\",\n seq.len()\n )));\n }\n Ok(seq.remove(0))\n }\n}\n\n/// A module that deserializes `[]` optionally\npub mod empty_params {\n use serde::{Deserialize, Deserializer};\n\n pub fn deserialize<'de, D>(d: D) -> Result<(), D::Error>\n where\n D: Deserializer<'de>,\n {\n let seq = Option::>::deserialize(d)?.unwrap_or_default();\n if !seq.is_empty() {\n return Err(serde::de::Error::custom(format!(\n \"expected params sequence with length 0 but got {}\",\n seq.len()\n )));\n }\n Ok(())\n }\n}\n\n/// A module that deserializes either a BlockNumberOrTag, or a simple number.\npub mod lenient_block_number {\n pub use alloy_eips::eip1898::LenientBlockNumberOrTag;\n use alloy_rpc_types::BlockNumberOrTag;\n use serde::{Deserialize, Deserializer};\n\n /// deserializes either a BlockNumberOrTag, or a simple number.\n pub use alloy_eips::eip1898::lenient_block_number_or_tag::deserialize as lenient_block_number;\n\n /// Same as `lenient_block_number` but requires to be `[num; 1]`\n pub fn lenient_block_number_seq<'de, D>(deserializer: D) -> Result\n where\n D: Deserializer<'de>,\n {\n let num = <[LenientBlockNumberOrTag; 1]>::deserialize(deserializer)?[0].into();\n Ok(num)\n }\n}\n" }, { "path": "crates/anvil/core/src/eth/subscription.rs", "content": "//! Subscription types\nuse alloy_primitives::hex;\nuse rand::{Rng, distr::Alphanumeric, rng};\nuse std::fmt;\n\n/// Unique subscription id\n#[derive(Clone, PartialEq, Eq, Hash, serde::Deserialize, serde::Serialize)]\n#[serde(untagged)]\npub enum SubscriptionId {\n /// numerical sub id\n Number(u64),\n /// string sub id, a hash for example\n String(String),\n}\n\nimpl SubscriptionId {\n /// Generates a new random hex identifier\n pub fn random_hex() -> Self {\n Self::String(hex_id())\n }\n}\n\nimpl fmt::Display for SubscriptionId {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n match self {\n Self::Number(num) => num.fmt(f),\n Self::String(s) => s.fmt(f),\n }\n }\n}\n\nimpl fmt::Debug for SubscriptionId {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n match self {\n Self::Number(num) => num.fmt(f),\n Self::String(s) => s.fmt(f),\n }\n }\n}\n\n/// Provides random hex identifier with a certain length\n#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]\npub struct HexIdProvider {\n len: usize,\n}\n\nimpl HexIdProvider {\n /// Generates a random hex encoded Id\n pub fn generate(&self) -> String {\n let id: String =\n (&mut rng()).sample_iter(Alphanumeric).map(char::from).take(self.len).collect();\n let out = hex::encode(id);\n format!(\"0x{out}\")\n }\n}\n\nimpl Default for HexIdProvider {\n fn default() -> Self {\n Self { len: 16 }\n }\n}\n\n/// Returns a new random hex identifier\npub fn hex_id() -> String {\n HexIdProvider::default().generate()\n}\n" }, { "path": "crates/anvil/core/src/eth/transaction/mod.rs", "content": "//! Transaction related types\nuse alloy_consensus::{\n Transaction, Typed2718,\n crypto::RecoveryError,\n transaction::{SignerRecoverable, TxHashRef},\n};\n\nuse alloy_eips::eip2718::Encodable2718;\nuse alloy_primitives::{Address, B256, Bytes, TxHash};\nuse alloy_rlp::{Decodable, Encodable};\nuse bytes::BufMut;\nuse foundry_evm::traces::CallTraceNode;\nuse foundry_primitives::FoundryTxEnvelope;\nuse revm::interpreter::InstructionResult;\nuse serde::{Deserialize, Serialize};\nuse std::ops::Deref;\n\n/// A wrapper for a transaction envelope that allows impersonating accounts.\n///\n/// This is a helper that carries the `impersonated` sender so that the right hash\n/// can be created.\n#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]\npub struct MaybeImpersonatedTransaction {\n transaction: T,\n impersonated_sender: Option
,\n}\n\nimpl Typed2718 for MaybeImpersonatedTransaction {\n fn ty(&self) -> u8 {\n self.transaction.ty()\n }\n}\n\nimpl MaybeImpersonatedTransaction {\n /// Creates a new wrapper for the given transaction\n pub fn new(transaction: T) -> Self {\n Self { transaction, impersonated_sender: None }\n }\n\n /// Creates a new impersonated transaction wrapper using the given sender\n pub fn impersonated(transaction: T, impersonated_sender: Address) -> Self {\n Self { transaction, impersonated_sender: Some(impersonated_sender) }\n }\n\n /// Returns whether the transaction is impersonated\n pub fn is_impersonated(&self) -> bool {\n self.impersonated_sender.is_some()\n }\n\n /// Returns the inner transaction.\n pub fn into_inner(self) -> T {\n self.transaction\n }\n}\n\nimpl MaybeImpersonatedTransaction {\n /// Recovers the Ethereum address which was used to sign the transaction.\n pub fn recover(&self) -> Result {\n if let Some(sender) = self.impersonated_sender {\n return Ok(sender);\n }\n self.transaction.recover_signer()\n }\n\n /// Returns the hash of the transaction.\n ///\n /// If the transaction is impersonated, returns a unique hash derived by appending the\n /// impersonated sender address to the encoded transaction before hashing.\n pub fn hash(&self) -> B256 {\n if let Some(sender) = self.impersonated_sender {\n let mut buffer = Vec::new();\n self.transaction.encode(&mut buffer);\n buffer.extend_from_slice(sender.as_ref());\n return B256::from_slice(alloy_primitives::utils::keccak256(&buffer).as_slice());\n }\n *self.transaction.tx_hash()\n }\n}\n\nimpl Encodable2718 for MaybeImpersonatedTransaction {\n fn encode_2718_len(&self) -> usize {\n self.transaction.encode_2718_len()\n }\n\n fn encode_2718(&self, out: &mut dyn BufMut) {\n self.transaction.encode_2718(out)\n }\n}\n\nimpl Encodable for MaybeImpersonatedTransaction {\n fn encode(&self, out: &mut dyn bytes::BufMut) {\n self.transaction.encode(out)\n }\n}\n\nimpl From> for FoundryTxEnvelope {\n fn from(value: MaybeImpersonatedTransaction) -> Self {\n value.transaction\n }\n}\n\nimpl From for MaybeImpersonatedTransaction {\n fn from(value: FoundryTxEnvelope) -> Self {\n Self::new(value)\n }\n}\n\nimpl Decodable for MaybeImpersonatedTransaction {\n fn decode(buf: &mut &[u8]) -> alloy_rlp::Result {\n T::decode(buf).map(Self::new)\n }\n}\n\nimpl AsRef for MaybeImpersonatedTransaction {\n fn as_ref(&self) -> &T {\n &self.transaction\n }\n}\n\nimpl Deref for MaybeImpersonatedTransaction {\n type Target = T;\n\n fn deref(&self) -> &Self::Target {\n &self.transaction\n }\n}\n\n/// Queued transaction\n#[derive(Clone, Debug, PartialEq, Eq)]\npub struct PendingTransaction {\n /// The actual transaction\n pub transaction: MaybeImpersonatedTransaction,\n /// the recovered sender of this transaction\n sender: Address,\n /// hash of `transaction`, so it can easily be reused with encoding and hashing again\n hash: TxHash,\n}\n\nimpl PendingTransaction {\n pub fn hash(&self) -> &TxHash {\n &self.hash\n }\n\n pub fn sender(&self) -> &Address {\n &self.sender\n }\n}\n\nimpl PendingTransaction {\n pub fn new(transaction: T) -> Result {\n let transaction = MaybeImpersonatedTransaction::new(transaction);\n let sender = transaction.recover()?;\n let hash = transaction.hash();\n Ok(Self { transaction, sender, hash })\n }\n\n pub fn with_impersonated(transaction: T, sender: Address) -> Self {\n let transaction = MaybeImpersonatedTransaction::impersonated(transaction, sender);\n let hash = transaction.hash();\n Self { transaction, sender, hash }\n }\n\n /// Converts a [`MaybeImpersonatedTransaction`] into a [`PendingTransaction`].\n pub fn from_maybe_impersonated(\n transaction: MaybeImpersonatedTransaction,\n ) -> Result {\n if let Some(impersonated) = transaction.impersonated_sender {\n Ok(Self::with_impersonated(transaction.transaction, impersonated))\n } else {\n Self::new(transaction.transaction)\n }\n }\n}\n\nimpl PendingTransaction {\n pub fn nonce(&self) -> u64 {\n self.transaction.nonce()\n }\n}\n\n/// Represents all relevant information of an executed transaction\n#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]\npub struct TransactionInfo {\n pub transaction_hash: B256,\n pub transaction_index: u64,\n pub from: Address,\n pub to: Option
,\n pub contract_address: Option
,\n pub traces: Vec,\n pub exit: InstructionResult,\n pub out: Option,\n pub nonce: u64,\n pub gas_used: u64,\n}\n" }, { "path": "crates/anvil/core/src/eth/wallet.rs", "content": "pub use alloy_eip5792::*;\n\n#[derive(Debug, thiserror::Error)]\npub enum WalletError {\n /// The transaction value is not 0.\n ///\n /// The value should be 0 to prevent draining the sequencer.\n #[error(\"transaction value must be zero for delegated transactions\")]\n ValueNotZero,\n /// The from field is set on the transaction.\n ///\n /// Requests with the from field are rejected, since it is implied that it will always be the\n /// sequencer.\n #[error(\"transaction 'from' field should not be set for delegated transactions\")]\n FromSet,\n /// The nonce field is set on the transaction.\n ///\n /// Requests with the nonce field set are rejected, as this is managed by the sequencer.\n #[error(\"transaction nonce should not be set for delegated transactions\")]\n NonceSet,\n /// An authorization item was invalid.\n ///\n /// The item is invalid if it tries to delegate an account to a contract that is not\n /// whitelisted.\n #[error(\"invalid authorization address: contract is not whitelisted for delegation\")]\n InvalidAuthorization,\n /// The to field of the transaction was invalid.\n ///\n /// The destination is invalid if:\n ///\n /// - There is no bytecode at the destination, or\n /// - The bytecode is not an EIP-7702 delegation designator, or\n /// - The delegation designator points to a contract that is not whitelisted\n #[error(\"transaction destination is not a valid delegated account\")]\n IllegalDestination,\n /// The transaction request was invalid.\n ///\n /// This is likely an internal error, as most of the request is built by the sequencer.\n #[error(\"invalid transaction request format\")]\n InvalidTransactionRequest,\n /// An internal error occurred.\n #[error(\"internal server error occurred\")]\n InternalError,\n}\n" }, { "path": "crates/anvil/core/src/lib.rs", "content": "//! # anvil-core\n//!\n//! Core Ethereum types for Anvil.\n\n#![cfg_attr(not(test), warn(unused_crate_dependencies))]\n#![cfg_attr(docsrs, feature(doc_cfg))]\n\n/// Various Ethereum types\npub mod eth;\n\n/// Additional useful types\npub mod types;\n" }, { "path": "crates/anvil/core/src/types.rs", "content": "use alloy_primitives::Bytes;\nuse alloy_rpc_types::TransactionRequest;\nuse serde::Deserialize;\n\n/// Represents the options used in `anvil_reorg`\n#[derive(Debug, Clone, Deserialize)]\npub struct ReorgOptions {\n // The depth of the reorg\n pub depth: u64,\n // List of transaction requests and blocks pairs to be mined into the new chain\n pub tx_block_pairs: Vec<(TransactionData, u64)>,\n}\n\n#[derive(Debug, Clone, Deserialize)]\n#[serde(untagged)]\n#[expect(clippy::large_enum_variant)]\npub enum TransactionData {\n JSON(TransactionRequest),\n Raw(Bytes),\n}\n" }, { "path": "crates/anvil/rpc/Cargo.toml", "content": "[package]\nname = \"anvil-rpc\"\n\nversion.workspace = true\nedition.workspace = true\nrust-version.workspace = true\nauthors.workspace = true\nlicense.workspace = true\nhomepage.workspace = true\nrepository.workspace = true\n\n[lints]\nworkspace = true\n\n[dependencies]\nserde.workspace = true\nserde_json.workspace = true\n" }, { "path": "crates/anvil/rpc/src/error.rs", "content": "//! JSON-RPC error bindings\nuse serde::{Deserialize, Deserializer, Serialize, Serializer};\nuse std::{borrow::Cow, fmt};\n\n/// Represents a JSON-RPC error\n#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]\n#[serde(deny_unknown_fields)]\npub struct RpcError {\n pub code: ErrorCode,\n /// error message\n pub message: Cow<'static, str>,\n #[serde(skip_serializing_if = \"Option::is_none\")]\n pub data: Option,\n}\n\nimpl RpcError {\n /// New [`RpcError`] with the given [`ErrorCode`].\n pub const fn new(code: ErrorCode) -> Self {\n Self { message: Cow::Borrowed(code.message()), code, data: None }\n }\n\n /// Creates a new `ParseError` error.\n pub const fn parse_error() -> Self {\n Self::new(ErrorCode::ParseError)\n }\n\n /// Creates a new `MethodNotFound` error.\n pub const fn method_not_found() -> Self {\n Self::new(ErrorCode::MethodNotFound)\n }\n\n /// Creates a new `InvalidRequest` error.\n pub const fn invalid_request() -> Self {\n Self::new(ErrorCode::InvalidRequest)\n }\n\n /// Creates a new `InternalError` error.\n pub const fn internal_error() -> Self {\n Self::new(ErrorCode::InternalError)\n }\n\n /// Creates a new `InvalidParams` error.\n pub fn invalid_params(message: M) -> Self\n where\n M: Into,\n {\n Self { code: ErrorCode::InvalidParams, message: message.into().into(), data: None }\n }\n\n /// Creates a new `InternalError` error with a message.\n pub fn internal_error_with(message: M) -> Self\n where\n M: Into,\n {\n Self { code: ErrorCode::InternalError, message: message.into().into(), data: None }\n }\n\n /// Creates a new RPC error for when a transaction was rejected.\n pub fn transaction_rejected(message: M) -> Self\n where\n M: Into,\n {\n Self { code: ErrorCode::TransactionRejected, message: message.into().into(), data: None }\n }\n}\n\nimpl fmt::Display for RpcError {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n write!(f, \"{}: {}\", self.code.message(), self.message)\n }\n}\n\n/// List of JSON-RPC error codes\n#[derive(Clone, Copy, Debug, PartialEq, Eq)]\npub enum ErrorCode {\n /// Server received Invalid JSON.\n /// server side error while parsing JSON\n ParseError,\n /// send invalid request object.\n InvalidRequest,\n /// method does not exist or valid\n MethodNotFound,\n /// invalid method parameter.\n InvalidParams,\n /// internal call error\n InternalError,\n /// Failed to send transaction, See also \n TransactionRejected,\n /// Custom geth error code, \n ExecutionError,\n /// Used for server specific errors.\n ServerError(i64),\n}\n\nimpl ErrorCode {\n /// Returns the error code as `i64`\n pub fn code(&self) -> i64 {\n match *self {\n Self::ParseError => -32700,\n Self::InvalidRequest => -32600,\n Self::MethodNotFound => -32601,\n Self::InvalidParams => -32602,\n Self::InternalError => -32603,\n Self::TransactionRejected => -32003,\n Self::ExecutionError => 3,\n Self::ServerError(c) => c,\n }\n }\n\n /// Returns the message associated with the error\n pub const fn message(&self) -> &'static str {\n match *self {\n Self::ParseError => \"Parse error\",\n Self::InvalidRequest => \"Invalid request\",\n Self::MethodNotFound => \"Method not found\",\n Self::InvalidParams => \"Invalid params\",\n Self::InternalError => \"Internal error\",\n Self::TransactionRejected => \"Transaction rejected\",\n Self::ServerError(_) => \"Server error\",\n Self::ExecutionError => \"Execution error\",\n }\n }\n}\n\nimpl Serialize for ErrorCode {\n fn serialize(&self, serializer: S) -> Result\n where\n S: Serializer,\n {\n serializer.serialize_i64(self.code())\n }\n}\n\nimpl<'a> Deserialize<'a> for ErrorCode {\n fn deserialize(deserializer: D) -> Result\n where\n D: Deserializer<'a>,\n {\n i64::deserialize(deserializer).map(Into::into)\n }\n}\n\nimpl From for ErrorCode {\n fn from(code: i64) -> Self {\n match code {\n -32700 => Self::ParseError,\n -32600 => Self::InvalidRequest,\n -32601 => Self::MethodNotFound,\n -32602 => Self::InvalidParams,\n -32603 => Self::InternalError,\n -32003 => Self::TransactionRejected,\n 3 => Self::ExecutionError,\n _ => Self::ServerError(code),\n }\n }\n}\n" }, { "path": "crates/anvil/rpc/src/lib.rs", "content": "//! # anvil-rpc\n//!\n//! JSON-RPC types.\n\n#![cfg_attr(not(test), warn(unused_crate_dependencies))]\n#![cfg_attr(docsrs, feature(doc_cfg))]\n\n/// JSON-RPC request bindings\npub mod request;\n\n/// JSON-RPC response bindings\npub mod response;\n\n/// JSON-RPC error bindings\npub mod error;\n" }, { "path": "crates/anvil/rpc/src/request.rs", "content": "use serde::{Deserialize, Serialize};\nuse std::fmt;\n\n/// A JSON-RPC request object, a method call\n#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]\n#[serde(deny_unknown_fields)]\npub struct RpcMethodCall {\n /// The version of the protocol\n pub jsonrpc: Version,\n /// The name of the method to execute\n pub method: String,\n /// An array or object containing the parameters to be passed to the function.\n #[serde(default = \"no_params\")]\n pub params: RequestParams,\n /// The identifier for this request issued by the client,\n /// An [Id] must be a String, null or a number.\n /// If missing it's considered a notification in [Version::V2]\n pub id: Id,\n}\n\nimpl RpcMethodCall {\n pub fn id(&self) -> Id {\n self.id.clone()\n }\n}\n\n/// Represents a JSON-RPC request which is considered a notification (missing [Id] optional\n/// [Version])\n#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]\n#[serde(deny_unknown_fields)]\npub struct RpcNotification {\n pub jsonrpc: Option,\n pub method: String,\n #[serde(default = \"no_params\")]\n pub params: RequestParams,\n}\n\n/// Representation of a single JSON-RPC call\n#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]\n#[serde(untagged)]\npub enum RpcCall {\n /// the RPC method to invoke\n MethodCall(RpcMethodCall),\n /// A notification (no [Id] provided)\n Notification(RpcNotification),\n /// Invalid call\n Invalid {\n /// id or [Id::Null]\n #[serde(default = \"null_id\")]\n id: Id,\n },\n}\n\n/// Represents a JSON-RPC request.\n#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]\n#[serde(deny_unknown_fields)]\n#[serde(untagged)]\npub enum Request {\n /// single json rpc request [RpcCall]\n Single(RpcCall),\n /// batch of several requests\n Batch(Vec),\n}\n\n/// Request parameters\n#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]\n#[serde(untagged, deny_unknown_fields)]\npub enum RequestParams {\n /// no parameters provided\n None,\n /// An array of JSON values\n Array(Vec),\n /// a map of JSON values\n Object(serde_json::Map),\n}\n\nimpl From for serde_json::Value {\n fn from(params: RequestParams) -> Self {\n match params {\n RequestParams::None => Self::Null,\n RequestParams::Array(arr) => arr.into(),\n RequestParams::Object(obj) => obj.into(),\n }\n }\n}\n\nfn no_params() -> RequestParams {\n RequestParams::None\n}\n\n/// Represents the version of the RPC protocol\n#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]\npub enum Version {\n #[serde(rename = \"2.0\")]\n V2,\n}\n\n#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]\n#[serde(untagged)]\npub enum Id {\n String(String),\n Number(i64),\n Null,\n}\n\nimpl fmt::Display for Id {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n match self {\n Self::String(s) => s.fmt(f),\n Self::Number(n) => n.fmt(f),\n Self::Null => f.write_str(\"null\"),\n }\n }\n}\n\nfn null_id() -> Id {\n Id::Null\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n\n #[test]\n fn can_serialize_batch() {\n let batch = Request::Batch(vec![\n RpcCall::MethodCall(RpcMethodCall {\n jsonrpc: Version::V2,\n method: \"eth_method\".to_owned(),\n params: RequestParams::Array(vec![\n serde_json::Value::from(999),\n serde_json::Value::from(1337),\n ]),\n id: Id::Number(1),\n }),\n RpcCall::Notification(RpcNotification {\n jsonrpc: Some(Version::V2),\n method: \"eth_method\".to_owned(),\n params: RequestParams::Array(vec![serde_json::Value::from(999)]),\n }),\n ]);\n\n let obj = serde_json::to_string(&batch).unwrap();\n assert_eq!(\n obj,\n r#\"[{\"jsonrpc\":\"2.0\",\"method\":\"eth_method\",\"params\":[999,1337],\"id\":1},{\"jsonrpc\":\"2.0\",\"method\":\"eth_method\",\"params\":[999]}]\"#\n );\n }\n\n #[test]\n fn can_deserialize_batch() {\n let s = r#\"[{}, {\"jsonrpc\": \"2.0\", \"method\": \"eth_call\", \"params\": [1337,420], \"id\": 1},{\"jsonrpc\": \"2.0\", \"method\": \"notify\", \"params\": [999]}]\"#;\n let obj: Request = serde_json::from_str(s).unwrap();\n assert_eq!(\n obj,\n Request::Batch(vec![\n RpcCall::Invalid { id: Id::Null },\n RpcCall::MethodCall(RpcMethodCall {\n jsonrpc: Version::V2,\n method: \"eth_call\".to_owned(),\n params: RequestParams::Array(vec![\n serde_json::Value::from(1337),\n serde_json::Value::from(420)\n ]),\n id: Id::Number(1)\n }),\n RpcCall::Notification(RpcNotification {\n jsonrpc: Some(Version::V2),\n method: \"notify\".to_owned(),\n params: RequestParams::Array(vec![serde_json::Value::from(999)])\n })\n ])\n )\n }\n\n #[test]\n fn can_serialize_method() {\n let m = RpcMethodCall {\n jsonrpc: Version::V2,\n method: \"eth_method\".to_owned(),\n params: RequestParams::Array(vec![\n serde_json::Value::from(999),\n serde_json::Value::from(1337),\n ]),\n id: Id::Number(1),\n };\n\n let obj = serde_json::to_string(&m).unwrap();\n assert_eq!(obj, r#\"{\"jsonrpc\":\"2.0\",\"method\":\"eth_method\",\"params\":[999,1337],\"id\":1}\"#);\n }\n\n #[test]\n fn can_serialize_call_notification() {\n let n = RpcCall::Notification(RpcNotification {\n jsonrpc: Some(Version::V2),\n method: \"eth_method\".to_owned(),\n params: RequestParams::Array(vec![serde_json::Value::from(999)]),\n });\n let obj = serde_json::to_string(&n).unwrap();\n assert_eq!(obj, r#\"{\"jsonrpc\":\"2.0\",\"method\":\"eth_method\",\"params\":[999]}\"#);\n }\n\n #[test]\n fn can_serialize_notification() {\n let n = RpcNotification {\n jsonrpc: Some(Version::V2),\n method: \"eth_method\".to_owned(),\n params: RequestParams::Array(vec![\n serde_json::Value::from(999),\n serde_json::Value::from(1337),\n ]),\n };\n let obj = serde_json::to_string(&n).unwrap();\n assert_eq!(obj, r#\"{\"jsonrpc\":\"2.0\",\"method\":\"eth_method\",\"params\":[999,1337]}\"#);\n }\n\n #[test]\n fn can_deserialize_notification() {\n let s = r#\"{\"jsonrpc\": \"2.0\", \"method\": \"eth_method\", \"params\": [999,1337]}\"#;\n let obj: RpcNotification = serde_json::from_str(s).unwrap();\n\n assert_eq!(\n obj,\n RpcNotification {\n jsonrpc: Some(Version::V2),\n method: \"eth_method\".to_owned(),\n params: RequestParams::Array(vec![\n serde_json::Value::from(999),\n serde_json::Value::from(1337)\n ])\n }\n );\n let s = r#\"{\"jsonrpc\": \"2.0\", \"method\": \"foobar\"}\"#;\n let obj: RpcNotification = serde_json::from_str(s).unwrap();\n assert_eq!(\n obj,\n RpcNotification {\n jsonrpc: Some(Version::V2),\n method: \"foobar\".to_owned(),\n params: RequestParams::None,\n }\n );\n let s = r#\"{\"jsonrpc\": \"2.0\", \"method\": \"eth_method\", \"params\": [999,1337], \"id\": 1}\"#;\n let obj: Result = serde_json::from_str(s);\n assert!(obj.is_err());\n }\n\n #[test]\n fn can_deserialize_call() {\n let s = r#\"{\"jsonrpc\": \"2.0\", \"method\": \"eth_method\", \"params\": [999]}\"#;\n let obj: RpcCall = serde_json::from_str(s).unwrap();\n assert_eq!(\n obj,\n RpcCall::Notification(RpcNotification {\n jsonrpc: Some(Version::V2),\n method: \"eth_method\".to_owned(),\n params: RequestParams::Array(vec![serde_json::Value::from(999)])\n })\n );\n\n let s = r#\"{\"jsonrpc\": \"2.0\", \"method\": \"eth_method\", \"params\": [999], \"id\": 1}\"#;\n let obj: RpcCall = serde_json::from_str(s).unwrap();\n assert_eq!(\n obj,\n RpcCall::MethodCall(RpcMethodCall {\n jsonrpc: Version::V2,\n method: \"eth_method\".to_owned(),\n params: RequestParams::Array(vec![serde_json::Value::from(999)]),\n id: Id::Number(1)\n })\n );\n\n let s = r#\"{\"jsonrpc\": \"2.0\", \"method\": \"eth_method\", \"params\": [], \"id\": 1}\"#;\n let obj: RpcCall = serde_json::from_str(s).unwrap();\n assert_eq!(\n obj,\n RpcCall::MethodCall(RpcMethodCall {\n jsonrpc: Version::V2,\n method: \"eth_method\".to_owned(),\n params: RequestParams::Array(vec![]),\n id: Id::Number(1)\n })\n );\n\n let s = r#\"{\"jsonrpc\": \"2.0\", \"method\": \"eth_method\", \"params\": null, \"id\": 1}\"#;\n let obj: RpcCall = serde_json::from_str(s).unwrap();\n assert_eq!(\n obj,\n RpcCall::MethodCall(RpcMethodCall {\n jsonrpc: Version::V2,\n method: \"eth_method\".to_owned(),\n params: RequestParams::None,\n id: Id::Number(1)\n })\n );\n\n let s = r#\"{\"jsonrpc\": \"2.0\", \"method\": \"eth_method\", \"id\": 1}\"#;\n let obj: RpcCall = serde_json::from_str(s).unwrap();\n assert_eq!(\n obj,\n RpcCall::MethodCall(RpcMethodCall {\n jsonrpc: Version::V2,\n method: \"eth_method\".to_owned(),\n params: RequestParams::None,\n id: Id::Number(1)\n })\n );\n }\n}\n" }, { "path": "crates/anvil/rpc/src/response.rs", "content": "use crate::{\n error::RpcError,\n request::{Id, Version},\n};\nuse serde::{Deserialize, Serialize};\n\n/// Response of a _single_ rpc call\n#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]\n#[serde(deny_unknown_fields)]\npub struct RpcResponse {\n // JSON RPC version\n jsonrpc: Version,\n id: Id,\n #[serde(flatten)]\n result: ResponseResult,\n}\n\nimpl From for RpcResponse {\n fn from(e: RpcError) -> Self {\n Self { jsonrpc: Version::V2, id: Id::Null, result: ResponseResult::Error(e) }\n }\n}\n\nimpl RpcResponse {\n pub fn new(id: Id, content: impl Into) -> Self {\n Self { jsonrpc: Version::V2, id, result: content.into() }\n }\n\n pub fn invalid_request(id: Id) -> Self {\n Self::new(id, RpcError::invalid_request())\n }\n}\n\n/// Represents the result of a call either success or error\n#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]\n#[serde(deny_unknown_fields)]\npub enum ResponseResult {\n #[serde(rename = \"result\")]\n Success(serde_json::Value),\n #[serde(rename = \"error\")]\n Error(RpcError),\n}\n\nimpl ResponseResult {\n pub fn success(content: S) -> Self\n where\n S: Serialize + 'static,\n {\n Self::Success(serde_json::to_value(&content).unwrap())\n }\n\n pub fn error(error: RpcError) -> Self {\n Self::Error(error)\n }\n}\n\nimpl From for ResponseResult {\n fn from(err: RpcError) -> Self {\n Self::error(err)\n }\n}\n/// Synchronous response\n#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]\n#[serde(deny_unknown_fields)]\n#[serde(untagged)]\npub enum Response {\n /// single json rpc response\n Single(RpcResponse),\n /// batch of several responses\n Batch(Vec),\n}\n\nimpl Response {\n /// Creates new [`Response`] with the given [`RpcError`].\n pub fn error(error: RpcError) -> Self {\n RpcResponse::new(Id::Null, ResponseResult::Error(error)).into()\n }\n}\n\nimpl From for Response {\n fn from(err: RpcError) -> Self {\n Self::error(err)\n }\n}\n\nimpl From for Response {\n fn from(resp: RpcResponse) -> Self {\n Self::Single(resp)\n }\n}\n" }, { "path": "crates/anvil/server/Cargo.toml", "content": "[package]\nname = \"anvil-server\"\ndescription = \"Customizable RPC server\"\n\nversion.workspace = true\nedition.workspace = true\nrust-version.workspace = true\nauthors.workspace = true\nlicense.workspace = true\nhomepage.workspace = true\nrepository.workspace = true\n\n[lints]\nworkspace = true\n\n[dependencies]\nanvil-rpc = { path = \"../rpc\" }\n\n# axum related\naxum = { workspace = true, features = [\"ws\"] }\ntower-http = { workspace = true, features = [\"trace\", \"cors\"] }\n\n# tracing\ntracing.workspace = true\n\n# async\nparking_lot.workspace = true\nfutures.workspace = true\n\n# ipc\ninterprocess = { version = \"2\", optional = true, features = [\"tokio\"] }\nbytes = { workspace = true, optional = true }\ntokio-util = { version = \"0.7\", features = [\"codec\"], optional = true }\n\n# misc\nserde_json.workspace = true\nserde.workspace = true\nasync-trait.workspace = true\nthiserror.workspace = true\n\nclap = { version = \"4\", features = [\"derive\", \"env\"], optional = true }\npin-project = \"1\"\n\n[features]\ndefault = [\"ipc\"]\nipc = [\"dep:interprocess\", \"dep:bytes\", \"dep:tokio-util\"]\n" }, { "path": "crates/anvil/server/src/config.rs", "content": "use crate::HeaderValue;\nuse serde::{Deserialize, Deserializer, Serialize, Serializer};\nuse std::str::FromStr;\n\n/// Additional server options.\n#[derive(Clone, Debug, Serialize, Deserialize)]\n#[cfg_attr(feature = \"clap\", derive(clap::Parser), command(next_help_heading = \"Server options\"))]\npub struct ServerConfig {\n /// The cors `allow_origin` header\n #[cfg_attr(feature = \"clap\", arg(long, default_value = \"*\"))]\n pub allow_origin: HeaderValueWrapper,\n\n /// Disable CORS.\n #[cfg_attr(feature = \"clap\", arg(long, conflicts_with = \"allow_origin\"))]\n pub no_cors: bool,\n\n /// Disable the default request body size limit. At time of writing the default limit is 2MB.\n #[cfg_attr(feature = \"clap\", arg(long))]\n pub no_request_size_limit: bool,\n}\n\nimpl ServerConfig {\n /// Sets the \"allow origin\" header for CORS.\n pub fn with_allow_origin(mut self, allow_origin: impl Into) -> Self {\n self.allow_origin = allow_origin.into();\n self\n }\n\n /// Whether to enable CORS.\n pub fn set_cors(mut self, cors: bool) -> Self {\n self.no_cors = !cors;\n self\n }\n}\n\nimpl Default for ServerConfig {\n fn default() -> Self {\n Self {\n allow_origin: \"*\".parse::().unwrap().into(),\n no_cors: false,\n no_request_size_limit: false,\n }\n }\n}\n\n#[derive(Clone, Debug)]\npub struct HeaderValueWrapper(pub HeaderValue);\n\nimpl FromStr for HeaderValueWrapper {\n type Err = ::Err;\n\n fn from_str(s: &str) -> Result {\n Ok(Self(s.parse()?))\n }\n}\n\nimpl Serialize for HeaderValueWrapper {\n fn serialize(&self, serializer: S) -> Result\n where\n S: Serializer,\n {\n serializer.serialize_str(self.0.to_str().map_err(serde::ser::Error::custom)?)\n }\n}\n\nimpl<'de> Deserialize<'de> for HeaderValueWrapper {\n fn deserialize(deserializer: D) -> Result\n where\n D: Deserializer<'de>,\n {\n let s = String::deserialize(deserializer)?;\n Ok(Self(s.parse().map_err(serde::de::Error::custom)?))\n }\n}\n\nimpl std::ops::Deref for HeaderValueWrapper {\n type Target = HeaderValue;\n\n fn deref(&self) -> &Self::Target {\n &self.0\n }\n}\n\nimpl From for HeaderValue {\n fn from(wrapper: HeaderValueWrapper) -> Self {\n wrapper.0\n }\n}\n\nimpl From for HeaderValueWrapper {\n fn from(header: HeaderValue) -> Self {\n Self(header)\n }\n}\n" }, { "path": "crates/anvil/server/src/error.rs", "content": "//! Error variants used to unify different connection streams\n\n/// An error that can occur when reading an incoming request\n#[derive(Debug, thiserror::Error)]\npub enum RequestError {\n #[error(transparent)]\n Axum(#[from] axum::Error),\n #[error(transparent)]\n Serde(#[from] serde_json::Error),\n #[error(transparent)]\n Io(#[from] std::io::Error),\n #[error(\"Disconnect\")]\n Disconnect,\n}\n" }, { "path": "crates/anvil/server/src/handler.rs", "content": "use crate::RpcHandler;\nuse anvil_rpc::{\n error::RpcError,\n request::{Request, RpcCall},\n response::{Response, RpcResponse},\n};\nuse axum::{\n Json,\n extract::{State, rejection::JsonRejection},\n};\nuse futures::{FutureExt, future};\n\n/// Handles incoming JSON-RPC Request.\n// NOTE: `handler` must come first because the `request` extractor consumes the request body.\npub async fn handle(\n State((handler, _)): State<(Http, Ws)>,\n request: Result, JsonRejection>,\n) -> Json {\n Json(match request {\n Ok(Json(req)) => handle_request(req, handler)\n .await\n .unwrap_or_else(|| Response::error(RpcError::invalid_request())),\n Err(err) => {\n warn!(target: \"rpc\", ?err, \"invalid request\");\n Response::error(RpcError::invalid_request())\n }\n })\n}\n\n/// Handle the JSON-RPC [Request]\n///\n/// This will try to deserialize the payload into the request type of the handler and if successful\n/// invoke the handler\npub async fn handle_request(\n req: Request,\n handler: Handler,\n) -> Option {\n /// processes batch calls\n fn responses_as_batch(outs: Vec>) -> Option {\n let batch: Vec<_> = outs.into_iter().flatten().collect();\n (!batch.is_empty()).then_some(Response::Batch(batch))\n }\n\n match req {\n Request::Single(call) => handle_call(call, handler).await.map(Response::Single),\n Request::Batch(calls) => {\n future::join_all(calls.into_iter().map(move |call| handle_call(call, handler.clone())))\n .map(responses_as_batch)\n .await\n }\n }\n}\n\n/// handle a single RPC method call\nasync fn handle_call(call: RpcCall, handler: Handler) -> Option {\n match call {\n RpcCall::MethodCall(call) => {\n trace!(target: \"rpc\", id = ?call.id , method = ?call.method, \"handling call\");\n Some(handler.on_call(call).await)\n }\n RpcCall::Notification(notification) => {\n trace!(target: \"rpc\", method = ?notification.method, \"received rpc notification\");\n None\n }\n RpcCall::Invalid { id } => {\n warn!(target: \"rpc\", ?id, \"invalid rpc call\");\n Some(RpcResponse::invalid_request(id))\n }\n }\n}\n" }, { "path": "crates/anvil/server/src/ipc.rs", "content": "//! IPC handling\n\nuse crate::{PubSubRpcHandler, error::RequestError, pubsub::PubSubConnection};\nuse anvil_rpc::request::Request;\nuse bytes::{BufMut, BytesMut};\nuse futures::{Sink, Stream, StreamExt, ready};\nuse interprocess::local_socket::{self as ls, tokio::prelude::*};\nuse std::{\n io,\n pin::Pin,\n task::{Context, Poll},\n};\n\n/// An IPC connection for anvil\n///\n/// A Future that listens for incoming connections and spawns new connections\npub struct IpcEndpoint {\n /// the handler for the websocket connection\n handler: Handler,\n /// The path to the socket\n path: String,\n}\n\nimpl IpcEndpoint {\n /// Creates a new endpoint with the given handler\n pub fn new(handler: Handler, path: String) -> Self {\n Self { handler, path }\n }\n\n /// Returns a stream of incoming connection handlers.\n ///\n /// This establishes the IPC endpoint, converts the incoming connections into handled\n /// connections.\n #[instrument(target = \"ipc\", skip_all)]\n pub fn incoming(self) -> io::Result>> {\n let Self { handler, path } = self;\n\n trace!(%path, \"starting IPC server\");\n\n if cfg!(unix) {\n // ensure the file does not exist\n if std::fs::remove_file(&path).is_ok() {\n warn!(%path, \"removed existing file\");\n }\n }\n\n let name = to_name(path.as_ref())?;\n let listener = ls::ListenerOptions::new().name(name).create_tokio()?;\n let connections = futures::stream::unfold(listener, |listener| async move {\n let conn = listener.accept().await;\n Some((conn, listener))\n });\n\n trace!(\"established connection listener\");\n\n Ok(connections.filter_map(move |stream| {\n let handler = handler.clone();\n async move {\n match stream {\n Ok(stream) => {\n trace!(\"successful incoming IPC connection\");\n let framed = tokio_util::codec::Decoder::framed(JsonRpcCodec, stream);\n Some(PubSubConnection::new(IpcConn(framed), handler))\n }\n Err(err) => {\n trace!(%err, \"unsuccessful incoming IPC connection\");\n None\n }\n }\n }\n }))\n }\n}\n\n#[pin_project::pin_project]\nstruct IpcConn(#[pin] T);\n\nimpl Stream for IpcConn\nwhere\n T: Stream>,\n{\n type Item = Result, RequestError>;\n\n fn poll_next(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll> {\n fn on_request(msg: io::Result) -> Result, RequestError> {\n let text = msg?;\n Ok(Some(serde_json::from_str(&text)?))\n }\n match ready!(self.project().0.poll_next(cx)) {\n Some(req) => Poll::Ready(Some(on_request(req))),\n _ => Poll::Ready(None),\n }\n }\n}\n\nimpl Sink for IpcConn\nwhere\n T: Sink,\n{\n type Error = io::Error;\n\n fn poll_ready(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll> {\n // NOTE: we always flush here this prevents any backpressure buffer in the underlying\n // `Framed` impl that would cause stalled requests\n self.project().0.poll_flush(cx)\n }\n\n fn start_send(self: Pin<&mut Self>, item: String) -> Result<(), Self::Error> {\n self.project().0.start_send(item)\n }\n\n fn poll_flush(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll> {\n self.project().0.poll_flush(cx)\n }\n\n fn poll_close(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll> {\n self.project().0.poll_close(cx)\n }\n}\n\nstruct JsonRpcCodec;\n\n// Adapted from \nimpl tokio_util::codec::Decoder for JsonRpcCodec {\n type Item = String;\n type Error = io::Error;\n\n fn decode(&mut self, buf: &mut BytesMut) -> io::Result> {\n const fn is_whitespace(byte: u8) -> bool {\n matches!(byte, 0x0D | 0x0A | 0x20 | 0x09)\n }\n\n let mut depth = 0;\n let mut in_str = false;\n let mut is_escaped = false;\n let mut start_idx = 0;\n let mut whitespaces = 0;\n\n for idx in 0..buf.as_ref().len() {\n let byte = buf.as_ref()[idx];\n\n if (byte == b'{' || byte == b'[') && !in_str {\n if depth == 0 {\n start_idx = idx;\n }\n depth += 1;\n } else if (byte == b'}' || byte == b']') && !in_str {\n depth -= 1;\n } else if byte == b'\"' && !is_escaped {\n in_str = !in_str;\n } else if is_whitespace(byte) {\n whitespaces += 1;\n }\n is_escaped = byte == b'\\\\' && !is_escaped && in_str;\n\n if depth == 0 && idx != start_idx && idx - start_idx + 1 > whitespaces {\n let bts = buf.split_to(idx + 1);\n return match String::from_utf8(bts.as_ref().to_vec()) {\n Ok(val) => Ok(Some(val)),\n Err(_) => Ok(None),\n };\n }\n }\n Ok(None)\n }\n}\n\nimpl tokio_util::codec::Encoder for JsonRpcCodec {\n type Error = io::Error;\n\n fn encode(&mut self, msg: String, buf: &mut BytesMut) -> io::Result<()> {\n buf.extend_from_slice(msg.as_bytes());\n // Add newline character\n buf.put_u8(b'\\n');\n Ok(())\n }\n}\n\nfn to_name(path: &std::ffi::OsStr) -> io::Result> {\n if cfg!(windows) && !path.as_encoded_bytes().starts_with(br\"\\\\.\\pipe\\\") {\n ls::ToNsName::to_ns_name::(path)\n } else {\n ls::ToFsName::to_fs_name::(path)\n }\n}\n" }, { "path": "crates/anvil/server/src/lib.rs", "content": "//! Bootstrap [axum] RPC servers.\n\n#![cfg_attr(not(test), warn(unused_crate_dependencies))]\n#![cfg_attr(docsrs, feature(doc_cfg))]\n\n#[macro_use]\nextern crate tracing;\n\nuse anvil_rpc::{\n error::RpcError,\n request::RpcMethodCall,\n response::{ResponseResult, RpcResponse},\n};\nuse axum::{\n Router,\n extract::DefaultBodyLimit,\n http::{HeaderValue, Method, header},\n routing::{MethodRouter, post},\n};\nuse serde::de::DeserializeOwned;\nuse std::fmt;\nuse tower_http::{cors::CorsLayer, trace::TraceLayer};\n\nmod config;\npub use config::ServerConfig;\n\nmod error;\nmod handler;\n\nmod pubsub;\npub use pubsub::{PubSubContext, PubSubRpcHandler};\n\nmod ws;\n\n#[cfg(feature = \"ipc\")]\npub mod ipc;\n\n/// Configures an [`axum::Router`] that handles JSON-RPC calls via both HTTP and WS.\npub fn http_ws_router(config: ServerConfig, http: Http, ws: Ws) -> Router\nwhere\n Http: RpcHandler,\n Ws: PubSubRpcHandler,\n{\n router_inner(config, post(handler::handle).get(ws::handle_ws), (http, ws))\n}\n\n/// Configures an [`axum::Router`] that handles JSON-RPC calls via HTTP.\npub fn http_router(config: ServerConfig, http: Http) -> Router\nwhere\n Http: RpcHandler,\n{\n router_inner(config, post(handler::handle), (http, ()))\n}\n\nfn router_inner(\n config: ServerConfig,\n root_method_router: MethodRouter,\n state: S,\n) -> Router {\n let ServerConfig { allow_origin, no_cors, no_request_size_limit } = config;\n\n let mut router = Router::new()\n .route(\"/\", root_method_router)\n .with_state(state)\n .layer(TraceLayer::new_for_http());\n if !no_cors {\n // See [`tower_http::cors`](https://docs.rs/tower-http/latest/tower_http/cors/index.html)\n // for more details.\n router = router.layer(\n CorsLayer::new()\n .allow_origin(allow_origin.0)\n .allow_headers([header::CONTENT_TYPE])\n .allow_methods([Method::GET, Method::POST]),\n );\n }\n if no_request_size_limit {\n router = router.layer(DefaultBodyLimit::disable());\n }\n router\n}\n\n/// Helper trait that is used to execute ethereum rpc calls\n#[async_trait::async_trait]\npub trait RpcHandler: Clone + Send + Sync + 'static {\n /// The request type to expect\n type Request: DeserializeOwned + Send + Sync + fmt::Debug;\n\n /// Invoked when the request was received\n async fn on_request(&self, request: Self::Request) -> ResponseResult;\n\n /// Invoked for every incoming `RpcMethodCall`\n ///\n /// This will attempt to deserialize a `{ \"method\" : \"\", \"params\": \"\" }` message\n /// into the `Request` type of this handler. If a `Request` instance was deserialized\n /// successfully, [`Self::on_request`] will be invoked.\n ///\n /// **Note**: override this function if the expected `Request` deviates from `{ \"method\" :\n /// \"\", \"params\": \"\" }`\n async fn on_call(&self, call: RpcMethodCall) -> RpcResponse {\n trace!(target: \"rpc\", id = ?call.id , method = ?call.method, params = ?call.params, \"received method call\");\n let RpcMethodCall { method, params, id, .. } = call;\n\n let params: serde_json::Value = params.into();\n let call = serde_json::json!({\n \"method\": &method,\n \"params\": params\n });\n\n match serde_json::from_value::(call) {\n Ok(req) => {\n let result = self.on_request(req).await;\n RpcResponse::new(id, result)\n }\n Err(err) => {\n let err = err.to_string();\n if err.contains(\"unknown variant\") {\n error!(target: \"rpc\", ?method, \"failed to deserialize method due to unknown variant\");\n RpcResponse::new(id, RpcError::method_not_found())\n } else {\n error!(target: \"rpc\", ?method, ?err, \"failed to deserialize method\");\n RpcResponse::new(id, RpcError::invalid_params(err))\n }\n }\n }\n }\n}\n" }, { "path": "crates/anvil/server/src/pubsub.rs", "content": "use crate::{RpcHandler, error::RequestError, handler::handle_request};\nuse anvil_rpc::{\n error::RpcError,\n request::Request,\n response::{Response, ResponseResult},\n};\n\nuse futures::{FutureExt, Sink, SinkExt, Stream, StreamExt};\nuse parking_lot::Mutex;\nuse serde::de::DeserializeOwned;\nuse std::{\n collections::VecDeque,\n fmt,\n hash::Hash,\n pin::Pin,\n sync::Arc,\n task::{Context, Poll},\n};\n\n/// The general purpose trait for handling RPC requests and subscriptions\n#[async_trait::async_trait]\npub trait PubSubRpcHandler: Clone + Send + Sync + Unpin + 'static {\n /// The request type to expect\n type Request: DeserializeOwned + Send + Sync + fmt::Debug;\n /// The identifier to use for subscriptions\n type SubscriptionId: Hash + PartialEq + Eq + Send + Sync + fmt::Debug;\n /// The subscription type this handle may create\n type Subscription: Stream + Send + Sync + Unpin;\n\n /// Invoked when the request was received\n async fn on_request(&self, request: Self::Request, cx: PubSubContext) -> ResponseResult;\n}\n\ntype Subscriptions = Arc>>;\n\n/// Contains additional context and tracks subscriptions\npub struct PubSubContext {\n /// all active subscriptions `id -> Stream`\n subscriptions: Subscriptions,\n}\n\nimpl PubSubContext {\n /// Adds new active subscription\n ///\n /// Returns the previous subscription, if any\n pub fn add_subscription(\n &self,\n id: Handler::SubscriptionId,\n subscription: Handler::Subscription,\n ) -> Option {\n let mut subscriptions = self.subscriptions.lock();\n let mut removed = None;\n if let Some(idx) = subscriptions.iter().position(|(i, _)| id == *i) {\n trace!(target: \"rpc\", ?id, \"removed subscription\");\n removed = Some(subscriptions.swap_remove(idx).1);\n }\n trace!(target: \"rpc\", ?id, \"added subscription\");\n subscriptions.push((id, subscription));\n removed\n }\n\n /// Removes an existing subscription\n pub fn remove_subscription(\n &self,\n id: &Handler::SubscriptionId,\n ) -> Option {\n let mut subscriptions = self.subscriptions.lock();\n if let Some(idx) = subscriptions.iter().position(|(i, _)| id == i) {\n trace!(target: \"rpc\", ?id, \"removed subscription\");\n return Some(subscriptions.swap_remove(idx).1);\n }\n None\n }\n}\n\nimpl Clone for PubSubContext {\n fn clone(&self) -> Self {\n Self { subscriptions: Arc::clone(&self.subscriptions) }\n }\n}\n\nimpl Default for PubSubContext {\n fn default() -> Self {\n Self { subscriptions: Arc::new(Mutex::new(Vec::new())) }\n }\n}\n\n/// A compatibility helper type to use common `RpcHandler` functions\nstruct ContextAwareHandler {\n handler: Handler,\n context: PubSubContext,\n}\n\nimpl Clone for ContextAwareHandler {\n fn clone(&self) -> Self {\n Self { handler: self.handler.clone(), context: self.context.clone() }\n }\n}\n\n#[async_trait::async_trait]\nimpl RpcHandler for ContextAwareHandler {\n type Request = Handler::Request;\n\n async fn on_request(&self, request: Self::Request) -> ResponseResult {\n self.handler.on_request(request, self.context.clone()).await\n }\n}\n\n/// Represents a connection to a client via websocket\n///\n/// Contains the state for the entire connection\npub struct PubSubConnection {\n /// the handler for the websocket connection\n handler: Handler,\n /// contains all the subscription related context\n context: PubSubContext,\n /// The established connection\n connection: Connection,\n /// currently in progress requests\n processing: Vec + Send>>>,\n /// pending messages to send\n pending: VecDeque,\n}\n\nimpl PubSubConnection {\n pub fn new(connection: Connection, handler: Handler) -> Self {\n Self {\n connection,\n handler,\n context: Default::default(),\n pending: Default::default(),\n processing: Default::default(),\n }\n }\n\n /// Returns a compatibility `RpcHandler`\n fn compat_helper(&self) -> ContextAwareHandler {\n ContextAwareHandler { handler: self.handler.clone(), context: self.context.clone() }\n }\n\n fn process_request(&mut self, req: serde_json::Result) {\n let handler = self.compat_helper();\n self.processing.push(Box::pin(async move {\n match req {\n Ok(req) => handle_request(req, handler)\n .await\n .unwrap_or_else(|| Response::error(RpcError::invalid_request())),\n Err(err) => {\n error!(target: \"rpc\", ?err, \"invalid request\");\n Response::error(RpcError::invalid_request())\n }\n }\n }));\n }\n}\n\nimpl Future for PubSubConnection\nwhere\n Handler: PubSubRpcHandler,\n Connection: Sink + Stream, RequestError>> + Unpin,\n >::Error: fmt::Debug,\n{\n type Output = ();\n\n fn poll(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll {\n let pin = self.get_mut();\n loop {\n // drive the websocket\n while matches!(pin.connection.poll_ready_unpin(cx), Poll::Ready(Ok(()))) {\n // only start sending if socket is ready\n if let Some(msg) = pin.pending.pop_front() {\n if let Err(err) = pin.connection.start_send_unpin(msg) {\n error!(target: \"rpc\", ?err, \"Failed to send message\");\n }\n } else {\n break;\n }\n }\n\n // Ensure any pending messages are flushed\n // this needs to be called manually for tungsenite websocket: \n if let Poll::Ready(Err(err)) = pin.connection.poll_flush_unpin(cx) {\n trace!(target: \"rpc\", ?err, \"websocket err\");\n // close the connection\n return Poll::Ready(());\n }\n\n loop {\n match pin.connection.poll_next_unpin(cx) {\n Poll::Ready(Some(req)) => match req {\n Ok(Some(req)) => {\n pin.process_request(Ok(req));\n }\n Err(err) => match err {\n RequestError::Axum(err) => {\n trace!(target: \"rpc\", ?err, \"client disconnected\");\n return Poll::Ready(());\n }\n RequestError::Io(err) => {\n trace!(target: \"rpc\", ?err, \"client disconnected\");\n return Poll::Ready(());\n }\n RequestError::Serde(err) => {\n pin.process_request(Err(err));\n }\n RequestError::Disconnect => {\n trace!(target: \"rpc\", \"client disconnected\");\n return Poll::Ready(());\n }\n },\n _ => {}\n },\n Poll::Ready(None) => {\n trace!(target: \"rpc\", \"socket connection finished\");\n return Poll::Ready(());\n }\n Poll::Pending => break,\n }\n }\n\n let mut progress = false;\n for n in (0..pin.processing.len()).rev() {\n let mut req = pin.processing.swap_remove(n);\n #[allow(clippy::collapsible_match)]\n match req.poll_unpin(cx) {\n Poll::Ready(resp) => {\n if let Ok(text) = serde_json::to_string(&resp) {\n pin.pending.push_back(text);\n progress = true;\n }\n }\n Poll::Pending => pin.processing.push(req),\n }\n }\n\n {\n // process subscription events\n let mut subscriptions = pin.context.subscriptions.lock();\n 'outer: for n in (0..subscriptions.len()).rev() {\n let (id, mut sub) = subscriptions.swap_remove(n);\n 'inner: loop {\n #[allow(clippy::collapsible_match)]\n match sub.poll_next_unpin(cx) {\n Poll::Ready(Some(res)) => {\n if let Ok(text) = serde_json::to_string(&res) {\n pin.pending.push_back(text);\n progress = true;\n }\n }\n Poll::Ready(None) => continue 'outer,\n Poll::Pending => break 'inner,\n }\n }\n\n subscriptions.push((id, sub));\n }\n }\n\n if !progress {\n return Poll::Pending;\n }\n }\n }\n}\n" }, { "path": "crates/anvil/server/src/ws.rs", "content": "use crate::{PubSubRpcHandler, error::RequestError, pubsub::PubSubConnection};\nuse anvil_rpc::request::Request;\nuse axum::{\n extract::{\n State, WebSocketUpgrade,\n ws::{Message, WebSocket},\n },\n response::Response,\n};\nuse futures::{Sink, Stream, ready};\nuse std::{\n pin::Pin,\n task::{Context, Poll},\n};\n\n/// Handles incoming Websocket upgrade\n///\n/// This is the entrypoint invoked by the axum server for a websocket request\npub async fn handle_ws(\n ws: WebSocketUpgrade,\n State((_, handler)): State<(Http, Ws)>,\n) -> Response {\n ws.on_upgrade(|socket| PubSubConnection::new(SocketConn(socket), handler))\n}\n\n#[pin_project::pin_project]\nstruct SocketConn(#[pin] WebSocket);\n\nimpl Stream for SocketConn {\n type Item = Result, RequestError>;\n\n fn poll_next(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll> {\n match ready!(self.project().0.poll_next(cx)) {\n Some(msg) => Poll::Ready(Some(on_message(msg))),\n _ => Poll::Ready(None),\n }\n }\n}\n\nimpl Sink for SocketConn {\n type Error = axum::Error;\n\n fn poll_ready(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll> {\n self.project().0.poll_ready(cx)\n }\n\n fn start_send(self: Pin<&mut Self>, item: String) -> Result<(), Self::Error> {\n self.project().0.start_send(Message::Text(item.into()))\n }\n\n fn poll_flush(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll> {\n self.project().0.poll_flush(cx)\n }\n\n fn poll_close(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll> {\n self.project().0.poll_close(cx)\n }\n}\n\nfn on_message(msg: Result) -> Result, RequestError> {\n match msg? {\n Message::Text(text) => Ok(Some(serde_json::from_str(&text)?)),\n Message::Binary(data) => {\n // the binary payload type is the request as-is but as bytes, if this is a valid\n // `Request` then we can deserialize the Json from the data Vec\n Ok(Some(serde_json::from_slice(&data)?))\n }\n Message::Close(_) => {\n trace!(target: \"rpc::ws\", \"ws client disconnected\");\n Err(RequestError::Disconnect)\n }\n _ => Ok(None),\n }\n}\n" }, { "path": "crates/anvil/src/args.rs", "content": "use crate::opts::{Anvil, AnvilSubcommand};\nuse clap::{CommandFactory, Parser};\nuse eyre::Result;\nuse foundry_cli::utils;\n\n/// Run the `anvil` command line interface.\npub fn run() -> Result<()> {\n setup()?;\n\n foundry_cli::opts::GlobalArgs::check_markdown_help::();\n\n let mut args = Anvil::parse();\n args.global.init()?;\n args.node.evm.resolve_rpc_alias();\n\n run_command(args)\n}\n\n/// Setup the exception handler and other utilities.\npub fn setup() -> Result<()> {\n utils::common_setup();\n\n Ok(())\n}\n\n/// Run the subcommand.\npub fn run_command(args: Anvil) -> Result<()> {\n if let Some(cmd) = &args.cmd {\n match cmd {\n AnvilSubcommand::Completions { shell } => {\n clap_complete::generate(\n *shell,\n &mut Anvil::command(),\n \"anvil\",\n &mut std::io::stdout(),\n );\n }\n }\n return Ok(());\n }\n\n let _ = fdlimit::raise_fd_limit();\n args.global.tokio_runtime().block_on(args.node.run())\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n\n #[test]\n fn verify_cli() {\n Anvil::command().debug_assert();\n }\n\n #[test]\n fn can_parse_help() {\n let _: Anvil = Anvil::parse_from([\"anvil\", \"--help\"]);\n }\n\n #[test]\n fn can_parse_short_version() {\n let _: Anvil = Anvil::parse_from([\"anvil\", \"-V\"]);\n }\n\n #[test]\n fn can_parse_long_version() {\n let _: Anvil = Anvil::parse_from([\"anvil\", \"--version\"]);\n }\n\n #[test]\n fn can_parse_completions() {\n let args: Anvil = Anvil::parse_from([\"anvil\", \"completions\", \"bash\"]);\n assert!(matches!(\n args.cmd,\n Some(AnvilSubcommand::Completions {\n shell: foundry_cli::clap::Shell::ClapCompleteShell(clap_complete::Shell::Bash)\n })\n ));\n }\n}\n" }, { "path": "crates/anvil/src/cmd.rs", "content": "use crate::{\n AccountGenerator, CHAIN_ID, NodeConfig,\n config::{DEFAULT_MNEMONIC, ForkChoice},\n eth::{EthApi, backend::db::SerializableState, pool::transactions::TransactionOrder},\n};\nuse alloy_genesis::Genesis;\nuse alloy_primitives::{B256, U256, utils::Unit};\nuse alloy_signer_local::coins_bip39::{English, Mnemonic};\nuse anvil_server::ServerConfig;\nuse clap::Parser;\nuse core::fmt;\nuse foundry_common::shell;\nuse foundry_config::{Chain, Config, FigmentProviders};\nuse foundry_evm::hardfork::{EthereumHardfork, OpHardfork};\nuse foundry_evm_networks::NetworkConfigs;\nuse foundry_primitives::FoundryNetwork;\nuse futures::FutureExt;\nuse rand_08::{SeedableRng, rngs::StdRng};\nuse std::{\n net::IpAddr,\n path::{Path, PathBuf},\n pin::Pin,\n str::FromStr,\n sync::{\n Arc,\n atomic::{AtomicUsize, Ordering},\n },\n task::{Context, Poll},\n time::Duration,\n};\nuse tokio::time::{Instant, Interval};\n\n#[derive(Clone, Debug, Parser)]\npub struct NodeArgs {\n /// Port number to listen on.\n #[arg(long, short, default_value = \"8545\", value_name = \"NUM\")]\n pub port: u16,\n\n /// Number of dev accounts to generate and configure.\n #[arg(long, short, default_value = \"10\", value_name = \"NUM\")]\n pub accounts: u64,\n\n /// The balance of every dev account in Ether.\n #[arg(long, default_value = \"10000\", value_name = \"NUM\")]\n pub balance: u64,\n\n /// The timestamp of the genesis block.\n #[arg(long, value_name = \"NUM\")]\n pub timestamp: Option,\n\n /// The number of the genesis block.\n #[arg(long, value_name = \"NUM\")]\n pub number: Option,\n\n /// BIP39 mnemonic phrase used for generating accounts.\n /// Cannot be used if `mnemonic_random` or `mnemonic_seed` are used.\n #[arg(long, short, conflicts_with_all = &[\"mnemonic_seed\", \"mnemonic_random\"])]\n pub mnemonic: Option,\n\n /// Automatically generates a BIP39 mnemonic phrase, and derives accounts from it.\n /// Cannot be used with other `mnemonic` options.\n /// You can specify the number of words you want in the mnemonic.\n /// [default: 12]\n #[arg(long, conflicts_with_all = &[\"mnemonic\", \"mnemonic_seed\"], default_missing_value = \"12\", num_args(0..=1))]\n pub mnemonic_random: Option,\n\n /// Generates a BIP39 mnemonic phrase from a given seed\n /// Cannot be used with other `mnemonic` options.\n ///\n /// CAREFUL: This is NOT SAFE and should only be used for testing.\n /// Never use the private keys generated in production.\n #[arg(long = \"mnemonic-seed-unsafe\", conflicts_with_all = &[\"mnemonic\", \"mnemonic_random\"])]\n pub mnemonic_seed: Option,\n\n /// Sets the derivation path of the child key to be derived.\n ///\n /// [default: m/44'/60'/0'/0/]\n #[arg(long)]\n pub derivation_path: Option,\n\n /// The EVM hardfork to use.\n ///\n /// Choose the hardfork by name, e.g. `prague`, `cancun`, `shanghai`, `paris`, `london`, etc...\n /// [default: latest]\n #[arg(long)]\n pub hardfork: Option,\n\n /// Block time in seconds for interval mining.\n #[arg(short, long, visible_alias = \"blockTime\", value_name = \"SECONDS\", value_parser = duration_from_secs_f64)]\n pub block_time: Option,\n\n /// Slots in an epoch\n #[arg(long, value_name = \"SLOTS_IN_AN_EPOCH\", default_value_t = 32)]\n pub slots_in_an_epoch: u64,\n\n /// Writes output of `anvil` as json to user-specified file.\n #[arg(long, value_name = \"FILE\", value_hint = clap::ValueHint::FilePath)]\n pub config_out: Option,\n\n /// Disable auto and interval mining, and mine on demand instead.\n #[arg(long, visible_alias = \"no-mine\", conflicts_with = \"block_time\")]\n pub no_mining: bool,\n\n #[arg(long, requires = \"block_time\")]\n pub mixed_mining: bool,\n\n /// The hosts the server will listen on.\n #[arg(\n long,\n value_name = \"IP_ADDR\",\n env = \"ANVIL_IP_ADDR\",\n default_value = \"127.0.0.1\",\n help_heading = \"Server options\",\n value_delimiter = ','\n )]\n pub host: Vec,\n\n /// How transactions are sorted in the mempool.\n #[arg(long, default_value = \"fees\")]\n pub order: TransactionOrder,\n\n /// Initialize the genesis block with the given `genesis.json` file.\n #[arg(long, value_name = \"PATH\", value_parser= read_genesis_file)]\n pub init: Option,\n\n /// This is an alias for both --load-state and --dump-state.\n ///\n /// It initializes the chain with the state and block environment stored at the file, if it\n /// exists, and dumps the chain's state on exit.\n #[arg(\n long,\n value_name = \"PATH\",\n value_parser = StateFile::parse,\n conflicts_with_all = &[\n \"init\",\n \"dump_state\",\n \"load_state\"\n ]\n )]\n pub state: Option,\n\n /// Interval in seconds at which the state and block environment is to be dumped to disk.\n ///\n /// See --state and --dump-state\n #[arg(short, long, value_name = \"SECONDS\")]\n pub state_interval: Option,\n\n /// Dump the state and block environment of chain on exit to the given file.\n ///\n /// If the value is a directory, the state will be written to `/state.json`.\n #[arg(long, value_name = \"PATH\", conflicts_with = \"init\")]\n pub dump_state: Option,\n\n /// Preserve historical state snapshots when dumping the state.\n ///\n /// This will save the in-memory states of the chain at particular block hashes.\n ///\n /// These historical states will be loaded into the memory when `--load-state` / `--state`, and\n /// aids in RPC calls beyond the block at which state was dumped.\n #[arg(long, conflicts_with = \"init\", default_value = \"false\")]\n pub preserve_historical_states: bool,\n\n /// Initialize the chain from a previously saved state snapshot.\n #[arg(\n long,\n value_name = \"PATH\",\n value_parser = SerializableState::parse,\n conflicts_with = \"init\"\n )]\n pub load_state: Option,\n\n #[arg(long, help = IPC_HELP, value_name = \"PATH\", visible_alias = \"ipcpath\")]\n pub ipc: Option>,\n\n /// Don't keep full chain history.\n /// If a number argument is specified, at most this number of states is kept in memory.\n ///\n /// If enabled, no state will be persisted on disk, so `max_persisted_states` will be 0.\n #[arg(long)]\n pub prune_history: Option>,\n\n /// Max number of states to persist on disk.\n ///\n /// Note that `prune_history` will overwrite `max_persisted_states` to 0.\n #[arg(long, conflicts_with = \"prune_history\")]\n pub max_persisted_states: Option,\n\n /// Number of blocks with transactions to keep in memory.\n #[arg(long)]\n pub transaction_block_keeper: Option,\n\n /// Maximum number of transactions in a block.\n #[arg(long)]\n pub max_transactions: Option,\n\n #[command(flatten)]\n pub evm: AnvilEvmArgs,\n\n #[command(flatten)]\n pub server_config: ServerConfig,\n\n /// Path to the cache directory where persisted states are stored (see\n /// `--max-persisted-states`).\n ///\n /// Note: This does not affect the fork RPC cache location (`storage.json`), which is stored in\n /// `~/.foundry/cache/rpc///`.\n #[arg(long, value_name = \"PATH\")]\n pub cache_path: Option,\n}\n\n#[cfg(windows)]\nconst IPC_HELP: &str =\n \"Launch an ipc server at the given path or default path = `\\\\.\\\\pipe\\\\anvil.ipc`\";\n\n/// The default IPC endpoint\n#[cfg(not(windows))]\nconst IPC_HELP: &str = \"Launch an ipc server at the given path or default path = `/tmp/anvil.ipc`\";\n\n/// Default interval for periodically dumping the state.\nconst DEFAULT_DUMP_INTERVAL: Duration = Duration::from_secs(60);\n\nimpl NodeArgs {\n pub fn into_node_config(self) -> eyre::Result {\n let genesis_balance = Unit::ETHER.wei().saturating_mul(U256::from(self.balance));\n let compute_units_per_second =\n if self.evm.no_rate_limit { Some(u64::MAX) } else { self.evm.compute_units_per_second };\n\n let hardfork = match &self.hardfork {\n Some(hf) => {\n if self.evm.networks.is_optimism() {\n Some(OpHardfork::from_str(hf)?.into())\n } else {\n Some(EthereumHardfork::from_str(hf)?.into())\n }\n }\n None => None,\n };\n\n Ok(NodeConfig::default()\n .with_gas_limit(self.evm.gas_limit)\n .disable_block_gas_limit(self.evm.disable_block_gas_limit)\n .enable_tx_gas_limit(self.evm.enable_tx_gas_limit)\n .with_gas_price(self.evm.gas_price)\n .with_hardfork(hardfork)\n .with_blocktime(self.block_time)\n .with_no_mining(self.no_mining)\n .with_mixed_mining(self.mixed_mining, self.block_time)\n .with_account_generator(self.account_generator())?\n .with_genesis_balance(genesis_balance)\n .with_genesis_timestamp(self.timestamp)\n .with_genesis_block_number(self.number)\n .with_port(self.port)\n .with_fork_choice(match (self.evm.fork_block_number, self.evm.fork_transaction_hash) {\n (Some(block), None) => Some(ForkChoice::Block(block)),\n (None, Some(hash)) => Some(ForkChoice::Transaction(hash)),\n _ => self\n .evm\n .fork_url\n .as_ref()\n .and_then(|f| f.block)\n .map(|num| ForkChoice::Block(num as i128)),\n })\n .with_fork_headers(self.evm.fork_headers)\n .with_fork_chain_id(self.evm.fork_chain_id.map(u64::from).map(U256::from))\n .fork_request_timeout(self.evm.fork_request_timeout.map(Duration::from_millis))\n .fork_request_retries(self.evm.fork_request_retries)\n .fork_retry_backoff(self.evm.fork_retry_backoff.map(Duration::from_millis))\n .fork_compute_units_per_second(compute_units_per_second)\n .with_eth_rpc_url(self.evm.fork_url.map(|fork| fork.url))\n .with_base_fee(self.evm.block_base_fee_per_gas)\n .disable_min_priority_fee(self.evm.disable_min_priority_fee)\n .with_no_storage_caching(self.evm.no_storage_caching)\n .with_server_config(self.server_config)\n .with_host(self.host)\n .set_silent(shell::is_quiet())\n .set_config_out(self.config_out)\n .with_chain_id(self.evm.chain_id)\n .with_transaction_order(self.order)\n .with_genesis(self.init)\n .with_steps_tracing(self.evm.steps_tracing)\n .with_print_logs(!self.evm.disable_console_log)\n .with_print_traces(self.evm.print_traces)\n .with_auto_impersonate(self.evm.auto_impersonate)\n .with_ipc(self.ipc)\n .with_code_size_limit(self.evm.code_size_limit)\n .disable_code_size_limit(self.evm.disable_code_size_limit)\n .set_pruned_history(self.prune_history)\n .with_init_state(self.load_state.or_else(|| self.state.and_then(|s| s.state)))\n .with_transaction_block_keeper(self.transaction_block_keeper)\n .with_max_transactions(self.max_transactions)\n .with_max_persisted_states(self.max_persisted_states)\n .with_networks(self.evm.networks)\n .with_disable_default_create2_deployer(self.evm.disable_default_create2_deployer)\n .with_disable_pool_balance_checks(self.evm.disable_pool_balance_checks)\n .with_slots_in_an_epoch(self.slots_in_an_epoch)\n .with_memory_limit(self.evm.memory_limit)\n .with_cache_path(self.cache_path))\n }\n\n fn account_generator(&self) -> AccountGenerator {\n let mut generator = AccountGenerator::new(self.accounts as usize)\n .phrase(DEFAULT_MNEMONIC)\n .chain_id(self.evm.chain_id.unwrap_or(CHAIN_ID.into()));\n if let Some(ref mnemonic) = self.mnemonic {\n generator = generator.phrase(mnemonic);\n } else if let Some(count) = self.mnemonic_random {\n let mut rng = rand_08::thread_rng();\n let mnemonic = match Mnemonic::::new_with_count(&mut rng, count) {\n Ok(mnemonic) => mnemonic.to_phrase(),\n Err(err) => {\n warn!(target: \"node\", ?count, %err, \"failed to generate mnemonic, falling back to 12-word random mnemonic\");\n // Fallback: generate a valid 12-word random mnemonic instead of using\n // DEFAULT_MNEMONIC\n Mnemonic::::new_with_count(&mut rng, 12)\n .expect(\"valid default word count\")\n .to_phrase()\n }\n };\n generator = generator.phrase(mnemonic);\n } else if let Some(seed) = self.mnemonic_seed {\n let mut seed = StdRng::seed_from_u64(seed);\n let mnemonic = Mnemonic::::new(&mut seed).to_phrase();\n generator = generator.phrase(mnemonic);\n }\n if let Some(ref derivation) = self.derivation_path {\n generator = generator.derivation_path(derivation);\n }\n generator\n }\n\n /// Returns the location where to dump the state to.\n fn dump_state_path(&self) -> Option {\n self.dump_state.as_ref().or_else(|| self.state.as_ref().map(|s| &s.path)).cloned()\n }\n\n /// Starts the node\n ///\n /// See also [crate::spawn()]\n pub async fn run(self) -> eyre::Result<()> {\n let dump_state = self.dump_state_path();\n let dump_interval =\n self.state_interval.map(Duration::from_secs).unwrap_or(DEFAULT_DUMP_INTERVAL);\n let preserve_historical_states = self.preserve_historical_states;\n\n let (api, mut handle) = crate::try_spawn(self.into_node_config()?).await?;\n\n // sets the signal handler to gracefully shutdown.\n let mut fork = api.get_fork();\n let running = Arc::new(AtomicUsize::new(0));\n\n // handle for the currently running rt, this must be obtained before setting the crtlc\n // handler, See [Handle::current]\n let mut signal = handle.shutdown_signal_mut().take();\n\n let task_manager = handle.task_manager();\n let mut on_shutdown = task_manager.on_shutdown();\n\n let mut state_dumper =\n PeriodicStateDumper::new(api, dump_state, dump_interval, preserve_historical_states);\n\n task_manager.spawn(async move {\n // wait for the SIGTERM signal on unix systems\n #[cfg(unix)]\n let mut sigterm = Box::pin(async {\n if let Ok(mut stream) =\n tokio::signal::unix::signal(tokio::signal::unix::SignalKind::terminate())\n {\n stream.recv().await;\n } else {\n futures::future::pending::<()>().await;\n }\n });\n\n // On windows, this will never fire.\n #[cfg(not(unix))]\n let mut sigterm = Box::pin(futures::future::pending::<()>());\n\n // await shutdown signal but also periodically flush state\n tokio::select! {\n _ = &mut sigterm => {\n trace!(\"received sigterm signal, shutting down\");\n }\n _ = &mut on_shutdown => {}\n _ = &mut state_dumper => {}\n }\n\n // shutdown received\n state_dumper.dump().await;\n\n // cleaning up and shutting down\n // this will make sure that the fork RPC cache is flushed if caching is configured\n if let Some(fork) = fork.take() {\n trace!(\"flushing cache on shutdown\");\n fork.database\n .read()\n .await\n .maybe_flush_cache()\n .expect(\"Could not flush cache on fork DB\");\n // cleaning up and shutting down\n // this will make sure that the fork RPC cache is flushed if caching is configured\n }\n std::process::exit(0);\n });\n\n ctrlc::set_handler(move || {\n let prev = running.fetch_add(1, Ordering::SeqCst);\n if prev == 0 {\n trace!(\"received shutdown signal, shutting down\");\n let _ = signal.take();\n }\n })\n .expect(\"Error setting Ctrl-C handler\");\n\n Ok(handle.await??)\n }\n}\n\n/// Anvil's EVM related arguments.\n#[derive(Clone, Debug, Parser)]\n#[command(next_help_heading = \"EVM options\")]\npub struct AnvilEvmArgs {\n /// Fetch state over a remote endpoint instead of starting from an empty state.\n ///\n /// If you want to fetch state from a specific block number, add a block number like `http://localhost:8545@1400000` or use the `--fork-block-number` argument.\n #[arg(\n long,\n short,\n visible_alias = \"rpc-url\",\n value_name = \"URL\",\n help_heading = \"Fork config\"\n )]\n pub fork_url: Option,\n\n /// Headers to use for the rpc client, e.g. \"User-Agent: test-agent\"\n ///\n /// See --fork-url.\n #[arg(\n long = \"fork-header\",\n value_name = \"HEADERS\",\n help_heading = \"Fork config\",\n requires = \"fork_url\"\n )]\n pub fork_headers: Vec,\n\n /// Timeout in ms for requests sent to remote JSON-RPC server in forking mode.\n ///\n /// Default value 45000\n #[arg(id = \"timeout\", long = \"timeout\", help_heading = \"Fork config\", requires = \"fork_url\")]\n pub fork_request_timeout: Option,\n\n /// Number of retry requests for spurious networks (timed out requests)\n ///\n /// Default value 5\n #[arg(id = \"retries\", long = \"retries\", help_heading = \"Fork config\", requires = \"fork_url\")]\n pub fork_request_retries: Option,\n\n /// Fetch state from a specific block number over a remote endpoint.\n ///\n /// If negative, the given value is subtracted from the `latest` block number.\n ///\n /// See --fork-url.\n #[arg(\n long,\n requires = \"fork_url\",\n value_name = \"BLOCK\",\n help_heading = \"Fork config\",\n allow_hyphen_values = true\n )]\n pub fork_block_number: Option,\n\n /// Fetch state from after a specific transaction hash has been applied over a remote endpoint.\n ///\n /// See --fork-url.\n #[arg(\n long,\n requires = \"fork_url\",\n value_name = \"TRANSACTION\",\n help_heading = \"Fork config\",\n conflicts_with = \"fork_block_number\"\n )]\n pub fork_transaction_hash: Option,\n\n /// Initial retry backoff on encountering errors.\n ///\n /// See --fork-url.\n #[arg(long, requires = \"fork_url\", value_name = \"BACKOFF\", help_heading = \"Fork config\")]\n pub fork_retry_backoff: Option,\n\n /// Specify chain id to skip fetching it from remote endpoint. This enables offline-start mode.\n ///\n /// You still must pass both `--fork-url` and `--fork-block-number`, and already have your\n /// required state cached on disk, anything missing locally would be fetched from the\n /// remote.\n #[arg(\n long,\n help_heading = \"Fork config\",\n value_name = \"CHAIN\",\n requires = \"fork_block_number\"\n )]\n pub fork_chain_id: Option,\n\n /// Sets the number of assumed available compute units per second for this provider\n ///\n /// default value: 330\n ///\n /// See also --fork-url and \n #[arg(\n long,\n requires = \"fork_url\",\n alias = \"cups\",\n value_name = \"CUPS\",\n help_heading = \"Fork config\"\n )]\n pub compute_units_per_second: Option,\n\n /// Disables rate limiting for this node's provider.\n ///\n /// default value: false\n ///\n /// See also --fork-url and \n #[arg(\n long,\n requires = \"fork_url\",\n value_name = \"NO_RATE_LIMITS\",\n help_heading = \"Fork config\",\n visible_alias = \"no-rpc-rate-limit\"\n )]\n pub no_rate_limit: bool,\n\n /// Explicitly disables the use of RPC caching.\n ///\n /// All storage slots are read entirely from the endpoint.\n ///\n /// This flag overrides the project's configuration file.\n ///\n /// See --fork-url.\n #[arg(long, requires = \"fork_url\", help_heading = \"Fork config\")]\n pub no_storage_caching: bool,\n\n /// The block gas limit.\n #[arg(long, alias = \"block-gas-limit\", help_heading = \"Environment config\")]\n pub gas_limit: Option,\n\n /// Disable the `call.gas_limit <= block.gas_limit` constraint.\n #[arg(\n long,\n value_name = \"DISABLE_GAS_LIMIT\",\n help_heading = \"Environment config\",\n alias = \"disable-gas-limit\",\n conflicts_with = \"gas_limit\"\n )]\n pub disable_block_gas_limit: bool,\n\n /// Enable the transaction gas limit check as imposed by EIP-7825 (Osaka hardfork).\n #[arg(long, visible_alias = \"tx-gas-limit\", help_heading = \"Environment config\")]\n pub enable_tx_gas_limit: bool,\n\n /// EIP-170: Contract code size limit in bytes. Useful to increase this because of tests. To\n /// disable entirely, use `--disable-code-size-limit`. By default, it is 0x6000 (~25kb).\n #[arg(long, value_name = \"CODE_SIZE\", help_heading = \"Environment config\")]\n pub code_size_limit: Option,\n\n /// Disable EIP-170: Contract code size limit.\n #[arg(\n long,\n value_name = \"DISABLE_CODE_SIZE_LIMIT\",\n conflicts_with = \"code_size_limit\",\n help_heading = \"Environment config\"\n )]\n pub disable_code_size_limit: bool,\n\n /// The gas price.\n #[arg(long, help_heading = \"Environment config\")]\n pub gas_price: Option,\n\n /// The base fee in a block.\n #[arg(\n long,\n visible_alias = \"base-fee\",\n value_name = \"FEE\",\n help_heading = \"Environment config\"\n )]\n pub block_base_fee_per_gas: Option,\n\n /// Disable the enforcement of a minimum suggested priority fee.\n #[arg(long, visible_alias = \"no-priority-fee\", help_heading = \"Environment config\")]\n pub disable_min_priority_fee: bool,\n\n /// The chain ID.\n #[arg(long, alias = \"chain\", help_heading = \"Environment config\")]\n pub chain_id: Option,\n\n /// Enable steps tracing used for debug calls returning geth-style traces\n #[arg(long, visible_alias = \"tracing\")]\n pub steps_tracing: bool,\n\n /// Disable printing of `console.log` invocations to stdout.\n #[arg(long, visible_alias = \"no-console-log\")]\n pub disable_console_log: bool,\n\n /// Enable printing of traces for executed transactions and `eth_call` to stdout.\n #[arg(long, visible_alias = \"enable-trace-printing\")]\n pub print_traces: bool,\n\n /// Enables automatic impersonation on startup. This allows any transaction sender to be\n /// simulated as different accounts, which is useful for testing contract behavior.\n #[arg(long, visible_alias = \"auto-unlock\")]\n pub auto_impersonate: bool,\n\n /// Disable the default create2 deployer\n #[arg(long, visible_alias = \"no-create2\")]\n pub disable_default_create2_deployer: bool,\n\n /// Disable pool balance checks\n #[arg(long)]\n pub disable_pool_balance_checks: bool,\n\n /// The memory limit per EVM execution in bytes.\n #[arg(long)]\n pub memory_limit: Option,\n\n #[command(flatten)]\n pub networks: NetworkConfigs,\n}\n\n/// Resolves an alias passed as fork-url to the matching url defined in the rpc_endpoints section\n/// of the project configuration file.\n/// Does nothing if the fork-url is not a configured alias.\nimpl AnvilEvmArgs {\n pub fn resolve_rpc_alias(&mut self) {\n if let Some(fork_url) = &self.fork_url\n && let Ok(config) = Config::load_with_providers(FigmentProviders::Anvil)\n && let Some(Ok(url)) = config.get_rpc_url_with_alias(&fork_url.url)\n {\n self.fork_url = Some(ForkUrl { url: url.to_string(), block: fork_url.block });\n }\n }\n}\n\n/// Helper type to periodically dump the state of the chain to disk\nstruct PeriodicStateDumper {\n in_progress_dump: Option + Send + Sync + 'static>>>,\n api: EthApi,\n dump_state: Option,\n preserve_historical_states: bool,\n interval: Interval,\n}\n\nimpl PeriodicStateDumper {\n fn new(\n api: EthApi,\n dump_state: Option,\n interval: Duration,\n preserve_historical_states: bool,\n ) -> Self {\n let dump_state = dump_state.map(|mut dump_state| {\n if dump_state.is_dir() {\n dump_state = dump_state.join(\"state.json\");\n }\n dump_state\n });\n\n // periodically flush the state\n let interval = tokio::time::interval_at(Instant::now() + interval, interval);\n Self { in_progress_dump: None, api, dump_state, preserve_historical_states, interval }\n }\n\n async fn dump(&self) {\n if let Some(state) = self.dump_state.clone() {\n Self::dump_state(self.api.clone(), state, self.preserve_historical_states).await\n }\n }\n\n /// Infallible state dump\n async fn dump_state(\n api: EthApi,\n dump_state: PathBuf,\n preserve_historical_states: bool,\n ) {\n trace!(path=?dump_state, \"Dumping state on shutdown\");\n match api.serialized_state(preserve_historical_states).await {\n Ok(state) => {\n if let Err(err) = foundry_common::fs::write_json_file(&dump_state, &state) {\n error!(?err, \"Failed to dump state\");\n } else {\n trace!(path=?dump_state, \"Dumped state on shutdown\");\n }\n }\n Err(err) => {\n error!(?err, \"Failed to extract state\");\n }\n }\n }\n}\n\n// An endless future that periodically dumps the state to disk if configured.\nimpl Future for PeriodicStateDumper {\n type Output = ();\n\n fn poll(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll {\n let this = self.get_mut();\n if this.dump_state.is_none() {\n return Poll::Pending;\n }\n\n loop {\n if let Some(mut flush) = this.in_progress_dump.take() {\n match flush.poll_unpin(cx) {\n Poll::Ready(_) => {\n this.interval.reset();\n }\n Poll::Pending => {\n this.in_progress_dump = Some(flush);\n return Poll::Pending;\n }\n }\n }\n\n if this.interval.poll_tick(cx).is_ready() {\n let api = this.api.clone();\n let path = this.dump_state.clone().expect(\"exists; see above\");\n this.in_progress_dump =\n Some(Box::pin(Self::dump_state(api, path, this.preserve_historical_states)));\n } else {\n break;\n }\n }\n\n Poll::Pending\n }\n}\n\n/// Represents the --state flag and where to load from, or dump the state to\n#[derive(Clone, Debug)]\npub struct StateFile {\n pub path: PathBuf,\n pub state: Option,\n}\n\nimpl StateFile {\n /// This is used as the clap `value_parser` implementation to parse from file but only if it\n /// exists\n fn parse(path: &str) -> Result {\n Self::parse_path(path)\n }\n\n /// Parse from file but only if it exists\n pub fn parse_path(path: impl AsRef) -> Result {\n let mut path = path.as_ref().to_path_buf();\n if path.is_dir() {\n path = path.join(\"state.json\");\n }\n let mut state = Self { path, state: None };\n if !state.path.exists() {\n return Ok(state);\n }\n\n state.state = Some(SerializableState::load(&state.path).map_err(|err| err.to_string())?);\n\n Ok(state)\n }\n}\n\n/// Represents the input URL for a fork with an optional trailing block number:\n/// `http://localhost:8545@1000000`\n#[derive(Clone, Debug, PartialEq, Eq)]\npub struct ForkUrl {\n /// The endpoint url\n pub url: String,\n /// Optional trailing block\n pub block: Option,\n}\n\nimpl fmt::Display for ForkUrl {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n self.url.fmt(f)?;\n if let Some(block) = self.block {\n write!(f, \"@{block}\")?;\n }\n Ok(())\n }\n}\n\nimpl FromStr for ForkUrl {\n type Err = String;\n\n fn from_str(s: &str) -> Result {\n if let Some((url, block)) = s.rsplit_once('@') {\n if block == \"latest\" {\n return Ok(Self { url: url.to_string(), block: None });\n }\n // this will prevent false positives for auths `user:password@example.com`\n if !block.is_empty() && !block.contains(':') && !block.contains('.') {\n let block: u64 = block\n .parse()\n .map_err(|_| format!(\"Failed to parse block number: `{block}`\"))?;\n return Ok(Self { url: url.to_string(), block: Some(block) });\n }\n }\n Ok(Self { url: s.to_string(), block: None })\n }\n}\n\n/// Clap's value parser for genesis. Loads a genesis.json file.\nfn read_genesis_file(path: &str) -> Result {\n foundry_common::fs::read_json_file(path.as_ref()).map_err(|err| err.to_string())\n}\n\nfn duration_from_secs_f64(s: &str) -> Result {\n let s = s.parse::().map_err(|e| e.to_string())?;\n if s == 0.0 {\n return Err(\"Duration must be greater than 0\".to_string());\n }\n Duration::try_from_secs_f64(s).map_err(|e| e.to_string())\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n use std::{env, net::Ipv4Addr};\n\n #[test]\n fn test_parse_fork_url() {\n let fork: ForkUrl = \"http://localhost:8545@1000000\".parse().unwrap();\n assert_eq!(\n fork,\n ForkUrl { url: \"http://localhost:8545\".to_string(), block: Some(1000000) }\n );\n\n let fork: ForkUrl = \"http://localhost:8545\".parse().unwrap();\n assert_eq!(fork, ForkUrl { url: \"http://localhost:8545\".to_string(), block: None });\n\n let fork: ForkUrl = \"wss://user:password@example.com/\".parse().unwrap();\n assert_eq!(\n fork,\n ForkUrl { url: \"wss://user:password@example.com/\".to_string(), block: None }\n );\n\n let fork: ForkUrl = \"wss://user:password@example.com/@latest\".parse().unwrap();\n assert_eq!(\n fork,\n ForkUrl { url: \"wss://user:password@example.com/\".to_string(), block: None }\n );\n\n let fork: ForkUrl = \"wss://user:password@example.com/@100000\".parse().unwrap();\n assert_eq!(\n fork,\n ForkUrl { url: \"wss://user:password@example.com/\".to_string(), block: Some(100000) }\n );\n }\n\n #[test]\n fn can_parse_ethereum_hardfork() {\n let args: NodeArgs = NodeArgs::parse_from([\"anvil\", \"--hardfork\", \"berlin\"]);\n let config = args.into_node_config().unwrap();\n assert_eq!(config.hardfork, Some(EthereumHardfork::Berlin.into()));\n }\n\n #[test]\n fn can_parse_optimism_hardfork() {\n let args: NodeArgs =\n NodeArgs::parse_from([\"anvil\", \"--optimism\", \"--hardfork\", \"Regolith\"]);\n let config = args.into_node_config().unwrap();\n assert_eq!(config.hardfork, Some(OpHardfork::Regolith.into()));\n }\n\n #[test]\n fn cant_parse_invalid_hardfork() {\n let args: NodeArgs = NodeArgs::parse_from([\"anvil\", \"--hardfork\", \"Regolith\"]);\n let config = args.into_node_config();\n assert!(config.is_err());\n }\n\n #[test]\n fn can_parse_fork_headers() {\n let args: NodeArgs = NodeArgs::parse_from([\n \"anvil\",\n \"--fork-url\",\n \"http,://localhost:8545\",\n \"--fork-header\",\n \"User-Agent: test-agent\",\n \"--fork-header\",\n \"Referrer: example.com\",\n ]);\n assert_eq!(args.evm.fork_headers, vec![\"User-Agent: test-agent\", \"Referrer: example.com\"]);\n }\n\n #[test]\n fn can_parse_prune_config() {\n let args: NodeArgs = NodeArgs::parse_from([\"anvil\", \"--prune-history\"]);\n assert!(args.prune_history.is_some());\n\n let args: NodeArgs = NodeArgs::parse_from([\"anvil\", \"--prune-history\", \"100\"]);\n assert_eq!(args.prune_history, Some(Some(100)));\n }\n\n #[test]\n fn can_parse_max_persisted_states_config() {\n let args: NodeArgs = NodeArgs::parse_from([\"anvil\", \"--max-persisted-states\", \"500\"]);\n assert_eq!(args.max_persisted_states, (Some(500)));\n }\n\n #[test]\n fn can_parse_disable_block_gas_limit() {\n let args: NodeArgs = NodeArgs::parse_from([\"anvil\", \"--disable-block-gas-limit\"]);\n assert!(args.evm.disable_block_gas_limit);\n\n let args =\n NodeArgs::try_parse_from([\"anvil\", \"--disable-block-gas-limit\", \"--gas-limit\", \"100\"]);\n assert!(args.is_err());\n }\n\n #[test]\n fn can_parse_enable_tx_gas_limit() {\n let args: NodeArgs = NodeArgs::parse_from([\"anvil\", \"--enable-tx-gas-limit\"]);\n assert!(args.evm.enable_tx_gas_limit);\n\n // Also test the alias\n let args: NodeArgs = NodeArgs::parse_from([\"anvil\", \"--tx-gas-limit\"]);\n assert!(args.evm.enable_tx_gas_limit);\n }\n\n #[test]\n fn can_parse_disable_code_size_limit() {\n let args: NodeArgs = NodeArgs::parse_from([\"anvil\", \"--disable-code-size-limit\"]);\n assert!(args.evm.disable_code_size_limit);\n\n let args = NodeArgs::try_parse_from([\n \"anvil\",\n \"--disable-code-size-limit\",\n \"--code-size-limit\",\n \"100\",\n ]);\n // can't be used together\n assert!(args.is_err());\n }\n\n #[test]\n fn can_parse_host() {\n let args = NodeArgs::parse_from([\"anvil\"]);\n assert_eq!(args.host, vec![IpAddr::V4(Ipv4Addr::LOCALHOST)]);\n\n let args = NodeArgs::parse_from([\n \"anvil\", \"--host\", \"::1\", \"--host\", \"1.1.1.1\", \"--host\", \"2.2.2.2\",\n ]);\n assert_eq!(\n args.host,\n [\"::1\", \"1.1.1.1\", \"2.2.2.2\"].map(|ip| ip.parse::().unwrap()).to_vec()\n );\n\n let args = NodeArgs::parse_from([\"anvil\", \"--host\", \"::1,1.1.1.1,2.2.2.2\"]);\n assert_eq!(\n args.host,\n [\"::1\", \"1.1.1.1\", \"2.2.2.2\"].map(|ip| ip.parse::().unwrap()).to_vec()\n );\n\n unsafe { env::set_var(\"ANVIL_IP_ADDR\", \"1.1.1.1\") };\n let args = NodeArgs::parse_from([\"anvil\"]);\n assert_eq!(args.host, vec![\"1.1.1.1\".parse::().unwrap()]);\n\n unsafe { env::set_var(\"ANVIL_IP_ADDR\", \"::1,1.1.1.1,2.2.2.2\") };\n let args = NodeArgs::parse_from([\"anvil\"]);\n assert_eq!(\n args.host,\n [\"::1\", \"1.1.1.1\", \"2.2.2.2\"].map(|ip| ip.parse::().unwrap()).to_vec()\n );\n }\n}\n" }, { "path": "crates/anvil/src/config.rs", "content": "use crate::{\n EthereumHardfork, FeeManager, PrecompileFactory,\n eth::{\n backend::{\n db::{Db, SerializableState},\n env::Env,\n fork::{ClientFork, ClientForkConfig},\n genesis::GenesisConfig,\n mem::fork_db::ForkedDatabase,\n time::duration_since_unix_epoch,\n },\n fees::{INITIAL_BASE_FEE, INITIAL_GAS_PRICE},\n pool::transactions::{PoolTransaction, TransactionOrder},\n },\n mem::{self, in_memory_db::MemDb},\n};\nuse alloy_consensus::BlockHeader;\nuse alloy_eips::{eip1559::BaseFeeParams, eip7840::BlobParams};\nuse alloy_evm::EvmEnv;\nuse alloy_genesis::Genesis;\nuse alloy_network::{AnyNetwork, BlockResponse, TransactionResponse};\nuse alloy_primitives::{BlockNumber, TxHash, U256, hex, map::HashMap, utils::Unit};\nuse alloy_provider::Provider;\nuse alloy_rpc_types::BlockNumberOrTag;\nuse alloy_signer::Signer;\nuse alloy_signer_local::{\n MnemonicBuilder, PrivateKeySigner,\n coins_bip39::{English, Mnemonic},\n};\nuse alloy_transport::TransportError;\nuse anvil_server::ServerConfig;\nuse eyre::{Context, Result};\nuse foundry_common::{\n ALCHEMY_FREE_TIER_CUPS, NON_ARCHIVE_NODE_WARNING, REQUEST_TIMEOUT,\n provider::{ProviderBuilder, RetryProvider},\n};\nuse foundry_config::Config;\nuse foundry_evm::{\n backend::{BlockchainDb, BlockchainDbMeta, SharedBackend},\n constants::DEFAULT_CREATE2_DEPLOYER,\n hardfork::{\n FoundryHardfork, OpHardfork, ethereum_hardfork_from_block_tag,\n spec_id_from_ethereum_hardfork,\n },\n utils::{\n apply_chain_and_block_specific_env_changes, block_env_from_header,\n get_blob_base_fee_update_fraction,\n },\n};\nuse foundry_primitives::FoundryTxEnvelope;\nuse itertools::Itertools;\nuse op_revm::OpTransaction;\nuse parking_lot::RwLock;\nuse rand_08::thread_rng;\nuse revm::{\n context::{BlockEnv, CfgEnv, TxEnv},\n context_interface::block::BlobExcessGasAndPrice,\n primitives::hardfork::SpecId,\n};\nuse serde_json::{Value, json};\nuse std::{\n fmt::Write as FmtWrite,\n net::{IpAddr, Ipv4Addr},\n path::PathBuf,\n sync::Arc,\n time::Duration,\n};\nuse tokio::sync::RwLock as TokioRwLock;\nuse yansi::Paint;\n\npub use foundry_common::version::SHORT_VERSION as VERSION_MESSAGE;\nuse foundry_evm::{\n traces::{CallTraceDecoderBuilder, identifier::SignaturesIdentifier},\n utils::get_blob_params,\n};\nuse foundry_evm_networks::NetworkConfigs;\n\n/// Default port the rpc will open\npub const NODE_PORT: u16 = 8545;\n/// Default chain id of the node\npub const CHAIN_ID: u64 = 31337;\n/// The default gas limit for all transactions\npub const DEFAULT_GAS_LIMIT: u64 = 30_000_000;\n/// Default mnemonic for dev accounts\npub const DEFAULT_MNEMONIC: &str = \"test test test test test test test test test test test junk\";\n\n/// The default IPC endpoint\npub const DEFAULT_IPC_ENDPOINT: &str =\n if cfg!(unix) { \"/tmp/anvil.ipc\" } else { r\"\\\\.\\pipe\\anvil.ipc\" };\n\nconst BANNER: &str = r\"\n _ _\n (_) | |\n __ _ _ __ __ __ _ | |\n / _` | | '_ \\ \\ \\ / / | | | |\n | (_| | | | | | \\ V / | | | |\n \\__,_| |_| |_| \\_/ |_| |_|\n\";\n\n/// Configurations of the EVM node\n#[derive(Clone, Debug)]\npub struct NodeConfig {\n /// Chain ID of the EVM chain\n pub chain_id: Option,\n /// Default gas limit for all txs\n pub gas_limit: Option,\n /// If set to `true`, disables the block gas limit\n pub disable_block_gas_limit: bool,\n /// If set to `true`, enables the tx gas limit as imposed by Osaka (EIP-7825)\n pub enable_tx_gas_limit: bool,\n /// Default gas price for all txs\n pub gas_price: Option,\n /// Default base fee\n pub base_fee: Option,\n /// If set to `true`, disables the enforcement of a minimum suggested priority fee\n pub disable_min_priority_fee: bool,\n /// Default blob excess gas and price\n pub blob_excess_gas_and_price: Option,\n /// The hardfork to use\n pub hardfork: Option,\n /// Signer accounts that will be initialised with `genesis_balance` in the genesis block\n pub genesis_accounts: Vec,\n /// Native token balance of every genesis account in the genesis block\n pub genesis_balance: U256,\n /// Genesis block timestamp\n pub genesis_timestamp: Option,\n /// Genesis block number\n pub genesis_block_number: Option,\n /// Signer accounts that can sign messages/transactions from the EVM node\n pub signer_accounts: Vec,\n /// Configured block time for the EVM chain. Use `None` to mine a new block for every tx\n pub block_time: Option,\n /// Disable auto, interval mining mode uns use `MiningMode::None` instead\n pub no_mining: bool,\n /// Enables auto and interval mining mode\n pub mixed_mining: bool,\n /// port to use for the server\n pub port: u16,\n /// maximum number of transactions in a block\n pub max_transactions: usize,\n /// url of the rpc server that should be used for any rpc calls\n pub eth_rpc_url: Option,\n /// pins the block number or transaction hash for the state fork\n pub fork_choice: Option,\n /// headers to use with `eth_rpc_url`\n pub fork_headers: Vec,\n /// specifies chain id for cache to skip fetching from remote in offline-start mode\n pub fork_chain_id: Option,\n /// The generator used to generate the dev accounts\n pub account_generator: Option,\n /// whether to enable tracing\n pub enable_tracing: bool,\n /// Explicitly disables the use of RPC caching.\n pub no_storage_caching: bool,\n /// How to configure the server\n pub server_config: ServerConfig,\n /// The host the server will listen on\n pub host: Vec,\n /// How transactions are sorted in the mempool\n pub transaction_order: TransactionOrder,\n /// Filename to write anvil output as json\n pub config_out: Option,\n /// The genesis to use to initialize the node\n pub genesis: Option,\n /// Timeout in for requests sent to remote JSON-RPC server in forking mode\n pub fork_request_timeout: Duration,\n /// Number of request retries for spurious networks\n pub fork_request_retries: u32,\n /// The initial retry backoff\n pub fork_retry_backoff: Duration,\n /// available CUPS\n pub compute_units_per_second: u64,\n /// The ipc path\n pub ipc_path: Option>,\n /// Enable transaction/call steps tracing for debug calls returning geth-style traces\n pub enable_steps_tracing: bool,\n /// Enable printing of `console.log` invocations.\n pub print_logs: bool,\n /// Enable printing of traces.\n pub print_traces: bool,\n /// Enable auto impersonation of accounts on startup\n pub enable_auto_impersonate: bool,\n /// Configure the code size limit\n pub code_size_limit: Option,\n /// Configures how to remove historic state.\n ///\n /// If set to `Some(num)` keep latest num state in memory only.\n pub prune_history: PruneStateHistoryConfig,\n /// Max number of states cached on disk.\n pub max_persisted_states: Option,\n /// The file where to load the state from\n pub init_state: Option,\n /// max number of blocks with transactions in memory\n pub transaction_block_keeper: Option,\n /// Disable the default CREATE2 deployer\n pub disable_default_create2_deployer: bool,\n /// Disable pool balance checks\n pub disable_pool_balance_checks: bool,\n /// Slots in an epoch\n pub slots_in_an_epoch: u64,\n /// The memory limit per EVM execution in bytes.\n pub memory_limit: Option,\n /// Factory used by `anvil` to extend the EVM's precompiles.\n pub precompile_factory: Option>,\n /// Networks to enable features for.\n pub networks: NetworkConfigs,\n /// Do not print log messages.\n pub silent: bool,\n /// The path where persisted states are cached (used with `max_persisted_states`).\n /// This does not affect the fork RPC cache location.\n pub cache_path: Option,\n}\n\nimpl NodeConfig {\n fn as_string(&self, fork: Option<&ClientFork>) -> String {\n let mut s: String = String::new();\n let _ = write!(s, \"\\n{}\", BANNER.green());\n let _ = write!(s, \"\\n {VERSION_MESSAGE}\");\n let _ = write!(s, \"\\n {}\", \"https://github.com/foundry-rs/foundry\".green());\n\n let _ = write!(\n s,\n r#\"\n\nAvailable Accounts\n==================\n\"#\n );\n let balance = alloy_primitives::utils::format_ether(self.genesis_balance);\n for (idx, wallet) in self.genesis_accounts.iter().enumerate() {\n write!(s, \"\\n({idx}) {} ({balance} ETH)\", wallet.address()).unwrap();\n }\n\n let _ = write!(\n s,\n r#\"\n\nPrivate Keys\n==================\n\"#\n );\n\n for (idx, wallet) in self.genesis_accounts.iter().enumerate() {\n let hex = hex::encode(wallet.credential().to_bytes());\n let _ = write!(s, \"\\n({idx}) 0x{hex}\");\n }\n\n if let Some(generator) = &self.account_generator {\n let _ = write!(\n s,\n r#\"\n\nWallet\n==================\nMnemonic: {}\nDerivation path: {}\n\"#,\n generator.phrase,\n generator.get_derivation_path()\n );\n }\n\n if let Some(fork) = fork {\n let _ = write!(\n s,\n r#\"\n\nFork\n==================\nEndpoint: {}\nBlock number: {}\nBlock hash: {:?}\nChain ID: {}\n\"#,\n fork.eth_rpc_url(),\n fork.block_number(),\n fork.block_hash(),\n fork.chain_id()\n );\n\n if let Some(tx_hash) = fork.transaction_hash() {\n let _ = writeln!(s, \"Transaction hash: {tx_hash}\");\n }\n } else {\n let _ = write!(\n s,\n r#\"\n\nChain ID\n==================\n\n{}\n\"#,\n self.get_chain_id().green()\n );\n }\n\n if (SpecId::from(self.get_hardfork()) as u8) < (SpecId::LONDON as u8) {\n let _ = write!(\n s,\n r#\"\nGas Price\n==================\n\n{}\n\"#,\n self.get_gas_price().green()\n );\n } else {\n let _ = write!(\n s,\n r#\"\nBase Fee\n==================\n\n{}\n\"#,\n self.get_base_fee().green()\n );\n }\n\n let _ = write!(\n s,\n r#\"\nGas Limit\n==================\n\n{}\n\"#,\n {\n if self.disable_block_gas_limit {\n \"Disabled\".to_string()\n } else {\n self.gas_limit.map(|l| l.to_string()).unwrap_or_else(|| {\n if self.fork_choice.is_some() {\n \"Forked\".to_string()\n } else {\n DEFAULT_GAS_LIMIT.to_string()\n }\n })\n }\n }\n .green()\n );\n\n let _ = write!(\n s,\n r#\"\nGenesis Timestamp\n==================\n\n{}\n\"#,\n self.get_genesis_timestamp().green()\n );\n\n let _ = write!(\n s,\n r#\"\nGenesis Number\n==================\n\n{}\n\"#,\n self.get_genesis_number().green()\n );\n\n s\n }\n\n fn as_json(&self, fork: Option<&ClientFork>) -> Value {\n let mut wallet_description = HashMap::new();\n let mut available_accounts = Vec::with_capacity(self.genesis_accounts.len());\n let mut private_keys = Vec::with_capacity(self.genesis_accounts.len());\n\n for wallet in &self.genesis_accounts {\n available_accounts.push(format!(\"{:?}\", wallet.address()));\n private_keys.push(format!(\"0x{}\", hex::encode(wallet.credential().to_bytes())));\n }\n\n if let Some(generator) = &self.account_generator {\n let phrase = generator.get_phrase().to_string();\n let derivation_path = generator.get_derivation_path().to_string();\n\n wallet_description.insert(\"derivation_path\".to_string(), derivation_path);\n wallet_description.insert(\"mnemonic\".to_string(), phrase);\n };\n\n let gas_limit = match self.gas_limit {\n // if we have a disabled flag we should max out the limit\n Some(_) | None if self.disable_block_gas_limit => Some(u64::MAX.to_string()),\n Some(limit) => Some(limit.to_string()),\n _ => None,\n };\n\n if let Some(fork) = fork {\n json!({\n \"available_accounts\": available_accounts,\n \"private_keys\": private_keys,\n \"endpoint\": fork.eth_rpc_url(),\n \"block_number\": fork.block_number(),\n \"block_hash\": fork.block_hash(),\n \"chain_id\": fork.chain_id(),\n \"wallet\": wallet_description,\n \"base_fee\": format!(\"{}\", self.get_base_fee()),\n \"gas_price\": format!(\"{}\", self.get_gas_price()),\n \"gas_limit\": gas_limit,\n })\n } else {\n json!({\n \"available_accounts\": available_accounts,\n \"private_keys\": private_keys,\n \"wallet\": wallet_description,\n \"base_fee\": format!(\"{}\", self.get_base_fee()),\n \"gas_price\": format!(\"{}\", self.get_gas_price()),\n \"gas_limit\": gas_limit,\n \"genesis_timestamp\": format!(\"{}\", self.get_genesis_timestamp()),\n })\n }\n }\n}\n\nimpl NodeConfig {\n /// Returns a new config intended to be used in tests, which does not print and binds to a\n /// random, free port by setting it to `0`\n #[doc(hidden)]\n pub fn test() -> Self {\n Self { enable_tracing: true, port: 0, silent: true, ..Default::default() }\n }\n\n /// Returns a new config which does not initialize any accounts on node startup.\n pub fn empty_state() -> Self {\n Self {\n genesis_accounts: vec![],\n signer_accounts: vec![],\n disable_default_create2_deployer: true,\n ..Default::default()\n }\n }\n}\n\nimpl Default for NodeConfig {\n fn default() -> Self {\n // generate some random wallets\n let genesis_accounts = AccountGenerator::new(10)\n .phrase(DEFAULT_MNEMONIC)\n .generate()\n .expect(\"Invalid mnemonic.\");\n Self {\n chain_id: None,\n gas_limit: None,\n disable_block_gas_limit: false,\n enable_tx_gas_limit: false,\n gas_price: None,\n hardfork: None,\n signer_accounts: genesis_accounts.clone(),\n genesis_timestamp: None,\n genesis_block_number: None,\n genesis_accounts,\n // 100ETH default balance\n genesis_balance: Unit::ETHER.wei().saturating_mul(U256::from(100u64)),\n block_time: None,\n no_mining: false,\n mixed_mining: false,\n port: NODE_PORT,\n max_transactions: 1_000,\n eth_rpc_url: None,\n fork_choice: None,\n account_generator: None,\n base_fee: None,\n disable_min_priority_fee: false,\n blob_excess_gas_and_price: None,\n enable_tracing: true,\n enable_steps_tracing: false,\n print_logs: true,\n print_traces: false,\n enable_auto_impersonate: false,\n no_storage_caching: false,\n server_config: Default::default(),\n host: vec![IpAddr::V4(Ipv4Addr::LOCALHOST)],\n transaction_order: Default::default(),\n config_out: None,\n genesis: None,\n fork_request_timeout: REQUEST_TIMEOUT,\n fork_headers: vec![],\n fork_request_retries: 5,\n fork_retry_backoff: Duration::from_millis(1_000),\n fork_chain_id: None,\n // alchemy max cpus \n compute_units_per_second: ALCHEMY_FREE_TIER_CUPS,\n ipc_path: None,\n code_size_limit: None,\n prune_history: Default::default(),\n max_persisted_states: None,\n init_state: None,\n transaction_block_keeper: None,\n disable_default_create2_deployer: false,\n disable_pool_balance_checks: false,\n slots_in_an_epoch: 32,\n memory_limit: None,\n precompile_factory: None,\n networks: Default::default(),\n silent: false,\n cache_path: None,\n }\n }\n}\n\nimpl NodeConfig {\n /// Returns the memory limit of the node\n #[must_use]\n pub fn with_memory_limit(mut self, mems_value: Option) -> Self {\n self.memory_limit = mems_value;\n self\n }\n /// Returns the base fee to use\n pub fn get_base_fee(&self) -> u64 {\n self.base_fee\n .or_else(|| self.genesis.as_ref().and_then(|g| g.base_fee_per_gas.map(|g| g as u64)))\n .unwrap_or(INITIAL_BASE_FEE)\n }\n\n /// Returns the base fee to use\n pub fn get_gas_price(&self) -> u128 {\n self.gas_price.unwrap_or(INITIAL_GAS_PRICE)\n }\n\n pub fn get_blob_excess_gas_and_price(&self) -> BlobExcessGasAndPrice {\n if let Some(value) = self.blob_excess_gas_and_price {\n value\n } else {\n let excess_blob_gas =\n self.genesis.as_ref().and_then(|g| g.excess_blob_gas).unwrap_or(0);\n BlobExcessGasAndPrice::new(\n excess_blob_gas,\n get_blob_base_fee_update_fraction(\n self.get_chain_id(),\n self.get_genesis_timestamp(),\n ),\n )\n }\n }\n\n /// Returns the [`BlobParams`] that should be used.\n pub fn get_blob_params(&self) -> BlobParams {\n get_blob_params(self.get_chain_id(), self.get_genesis_timestamp())\n }\n\n /// Returns the hardfork to use\n pub fn get_hardfork(&self) -> FoundryHardfork {\n if let Some(hardfork) = self.hardfork {\n return hardfork;\n }\n if self.networks.is_optimism() {\n return OpHardfork::default().into();\n }\n EthereumHardfork::default().into()\n }\n\n /// Sets a custom code size limit\n #[must_use]\n pub fn with_code_size_limit(mut self, code_size_limit: Option) -> Self {\n self.code_size_limit = code_size_limit;\n self\n }\n /// Disables code size limit\n #[must_use]\n pub fn disable_code_size_limit(mut self, disable_code_size_limit: bool) -> Self {\n if disable_code_size_limit {\n self.code_size_limit = Some(usize::MAX);\n }\n self\n }\n\n /// Sets the init state if any\n #[must_use]\n pub fn with_init_state(mut self, init_state: Option) -> Self {\n self.init_state = init_state;\n self\n }\n\n /// Loads the init state from a file if it exists\n #[must_use]\n #[cfg(feature = \"cmd\")]\n pub fn with_init_state_path(mut self, path: impl AsRef) -> Self {\n self.init_state = crate::cmd::StateFile::parse_path(path).ok().and_then(|file| file.state);\n self\n }\n\n /// Sets the chain ID\n #[must_use]\n pub fn with_chain_id>(mut self, chain_id: Option) -> Self {\n self.set_chain_id(chain_id);\n self\n }\n\n /// Returns the chain ID to use\n pub fn get_chain_id(&self) -> u64 {\n self.chain_id\n .or_else(|| self.genesis.as_ref().map(|g| g.config.chain_id))\n .unwrap_or(CHAIN_ID)\n }\n\n /// Sets the chain id and updates all wallets\n pub fn set_chain_id(&mut self, chain_id: Option>) {\n self.chain_id = chain_id.map(Into::into);\n let chain_id = self.get_chain_id();\n self.networks.with_chain_id(chain_id);\n self.genesis_accounts.iter_mut().for_each(|wallet| {\n *wallet = wallet.clone().with_chain_id(Some(chain_id));\n });\n self.signer_accounts.iter_mut().for_each(|wallet| {\n *wallet = wallet.clone().with_chain_id(Some(chain_id));\n })\n }\n\n /// Sets the gas limit\n #[must_use]\n pub fn with_gas_limit(mut self, gas_limit: Option) -> Self {\n self.gas_limit = gas_limit;\n self\n }\n\n /// Disable block gas limit check\n ///\n /// If set to `true` block gas limit will not be enforced\n #[must_use]\n pub fn disable_block_gas_limit(mut self, disable_block_gas_limit: bool) -> Self {\n self.disable_block_gas_limit = disable_block_gas_limit;\n self\n }\n\n /// Enable tx gas limit check\n ///\n /// If set to `true`, enables the tx gas limit as imposed by Osaka (EIP-7825)\n #[must_use]\n pub fn enable_tx_gas_limit(mut self, enable_tx_gas_limit: bool) -> Self {\n self.enable_tx_gas_limit = enable_tx_gas_limit;\n self\n }\n\n /// Sets the gas price\n #[must_use]\n pub fn with_gas_price(mut self, gas_price: Option) -> Self {\n self.gas_price = gas_price;\n self\n }\n\n /// Sets prune history status.\n #[must_use]\n pub fn set_pruned_history(mut self, prune_history: Option>) -> Self {\n self.prune_history = PruneStateHistoryConfig::from_args(prune_history);\n self\n }\n\n /// Sets max number of states to cache on disk.\n #[must_use]\n pub fn with_max_persisted_states>(\n mut self,\n max_persisted_states: Option,\n ) -> Self {\n self.max_persisted_states = max_persisted_states.map(Into::into);\n self\n }\n\n /// Sets the max number of transactions in a block\n #[must_use]\n pub fn with_max_transactions(mut self, max_transactions: Option) -> Self {\n if let Some(max_transactions) = max_transactions {\n self.max_transactions = max_transactions;\n }\n self\n }\n\n /// Sets max number of blocks with transactions to keep in memory\n #[must_use]\n pub fn with_transaction_block_keeper>(\n mut self,\n transaction_block_keeper: Option,\n ) -> Self {\n self.transaction_block_keeper = transaction_block_keeper.map(Into::into);\n self\n }\n\n /// Sets the base fee\n #[must_use]\n pub fn with_base_fee(mut self, base_fee: Option) -> Self {\n self.base_fee = base_fee;\n self\n }\n\n /// Disable the enforcement of a minimum suggested priority fee\n #[must_use]\n pub fn disable_min_priority_fee(mut self, disable_min_priority_fee: bool) -> Self {\n self.disable_min_priority_fee = disable_min_priority_fee;\n self\n }\n\n /// Sets the init genesis (genesis.json)\n #[must_use]\n pub fn with_genesis(mut self, genesis: Option) -> Self {\n self.genesis = genesis;\n self\n }\n\n /// Returns the genesis timestamp to use\n pub fn get_genesis_timestamp(&self) -> u64 {\n self.genesis_timestamp\n .or_else(|| self.genesis.as_ref().map(|g| g.timestamp))\n .unwrap_or_else(|| duration_since_unix_epoch().as_secs())\n }\n\n /// Sets the genesis timestamp\n #[must_use]\n pub fn with_genesis_timestamp>(mut self, timestamp: Option) -> Self {\n if let Some(timestamp) = timestamp {\n self.genesis_timestamp = Some(timestamp.into());\n }\n self\n }\n\n /// Sets the genesis number\n #[must_use]\n pub fn with_genesis_block_number>(mut self, number: Option) -> Self {\n if let Some(number) = number {\n self.genesis_block_number = Some(number.into());\n }\n self\n }\n\n /// Returns the genesis number\n pub fn get_genesis_number(&self) -> u64 {\n self.genesis_block_number\n .or_else(|| self.genesis.as_ref().and_then(|g| g.number))\n .unwrap_or(0)\n }\n\n /// Sets the hardfork\n #[must_use]\n pub fn with_hardfork(mut self, hardfork: Option) -> Self {\n self.hardfork = hardfork;\n self\n }\n\n /// Sets the genesis accounts\n #[must_use]\n pub fn with_genesis_accounts(mut self, accounts: Vec) -> Self {\n self.genesis_accounts = accounts;\n self\n }\n\n /// Sets the signer accounts\n #[must_use]\n pub fn with_signer_accounts(mut self, accounts: Vec) -> Self {\n self.signer_accounts = accounts;\n self\n }\n\n /// Sets both the genesis accounts and the signer accounts\n /// so that `genesis_accounts == accounts`\n pub fn with_account_generator(mut self, generator: AccountGenerator) -> eyre::Result {\n let accounts = generator.generate()?;\n self.account_generator = Some(generator);\n Ok(self.with_signer_accounts(accounts.clone()).with_genesis_accounts(accounts))\n }\n\n /// Sets the balance of the genesis accounts in the genesis block\n #[must_use]\n pub fn with_genesis_balance>(mut self, balance: U) -> Self {\n self.genesis_balance = balance.into();\n self\n }\n\n /// Sets the block time to automine blocks\n #[must_use]\n pub fn with_blocktime>(mut self, block_time: Option) -> Self {\n self.block_time = block_time.map(Into::into);\n self\n }\n\n #[must_use]\n pub fn with_mixed_mining>(\n mut self,\n mixed_mining: bool,\n block_time: Option,\n ) -> Self {\n self.block_time = block_time.map(Into::into);\n self.mixed_mining = mixed_mining;\n self\n }\n\n /// If set to `true` auto mining will be disabled\n #[must_use]\n pub fn with_no_mining(mut self, no_mining: bool) -> Self {\n self.no_mining = no_mining;\n self\n }\n\n /// Sets the slots in an epoch\n #[must_use]\n pub fn with_slots_in_an_epoch(mut self, slots_in_an_epoch: u64) -> Self {\n self.slots_in_an_epoch = slots_in_an_epoch;\n self\n }\n\n /// Sets the port to use\n #[must_use]\n pub fn with_port(mut self, port: u16) -> Self {\n self.port = port;\n self\n }\n\n /// Sets the ipc path to use\n ///\n /// Note: this is a double Option for\n /// - `None` -> no ipc\n /// - `Some(None)` -> use default path\n /// - `Some(Some(path))` -> use custom path\n #[must_use]\n pub fn with_ipc(mut self, ipc_path: Option>) -> Self {\n self.ipc_path = ipc_path;\n self\n }\n\n /// Sets the file path to write the Anvil node's config info to.\n #[must_use]\n pub fn set_config_out(mut self, config_out: Option) -> Self {\n self.config_out = config_out;\n self\n }\n\n #[must_use]\n pub fn with_no_storage_caching(mut self, no_storage_caching: bool) -> Self {\n self.no_storage_caching = no_storage_caching;\n self\n }\n\n /// Sets the `eth_rpc_url` to use when forking\n #[must_use]\n pub fn with_eth_rpc_url>(mut self, eth_rpc_url: Option) -> Self {\n self.eth_rpc_url = eth_rpc_url.map(Into::into);\n self\n }\n\n /// Sets the `fork_choice` to use to fork off from based on a block number\n #[must_use]\n pub fn with_fork_block_number>(self, fork_block_number: Option) -> Self {\n self.with_fork_choice(fork_block_number.map(Into::into))\n }\n\n /// Sets the `fork_choice` to use to fork off from based on a transaction hash\n #[must_use]\n pub fn with_fork_transaction_hash>(\n self,\n fork_transaction_hash: Option,\n ) -> Self {\n self.with_fork_choice(fork_transaction_hash.map(Into::into))\n }\n\n /// Sets the `fork_choice` to use to fork off from\n #[must_use]\n pub fn with_fork_choice>(mut self, fork_choice: Option) -> Self {\n self.fork_choice = fork_choice.map(Into::into);\n self\n }\n\n /// Sets the `fork_chain_id` to use to fork off local cache from\n #[must_use]\n pub fn with_fork_chain_id(mut self, fork_chain_id: Option) -> Self {\n self.fork_chain_id = fork_chain_id;\n self\n }\n\n /// Sets the `fork_headers` to use with `eth_rpc_url`\n #[must_use]\n pub fn with_fork_headers(mut self, headers: Vec) -> Self {\n self.fork_headers = headers;\n self\n }\n\n /// Sets the `fork_request_timeout` to use for requests\n #[must_use]\n pub fn fork_request_timeout(mut self, fork_request_timeout: Option) -> Self {\n if let Some(fork_request_timeout) = fork_request_timeout {\n self.fork_request_timeout = fork_request_timeout;\n }\n self\n }\n\n /// Sets the `fork_request_retries` to use for spurious networks\n #[must_use]\n pub fn fork_request_retries(mut self, fork_request_retries: Option) -> Self {\n if let Some(fork_request_retries) = fork_request_retries {\n self.fork_request_retries = fork_request_retries;\n }\n self\n }\n\n /// Sets the initial `fork_retry_backoff` for rate limits\n #[must_use]\n pub fn fork_retry_backoff(mut self, fork_retry_backoff: Option) -> Self {\n if let Some(fork_retry_backoff) = fork_retry_backoff {\n self.fork_retry_backoff = fork_retry_backoff;\n }\n self\n }\n\n /// Sets the number of assumed available compute units per second\n ///\n /// See also, \n #[must_use]\n pub fn fork_compute_units_per_second(mut self, compute_units_per_second: Option) -> Self {\n if let Some(compute_units_per_second) = compute_units_per_second {\n self.compute_units_per_second = compute_units_per_second;\n }\n self\n }\n\n /// Sets whether to enable tracing\n #[must_use]\n pub fn with_tracing(mut self, enable_tracing: bool) -> Self {\n self.enable_tracing = enable_tracing;\n self\n }\n\n /// Sets whether to enable steps tracing\n #[must_use]\n pub fn with_steps_tracing(mut self, enable_steps_tracing: bool) -> Self {\n self.enable_steps_tracing = enable_steps_tracing;\n self\n }\n\n /// Sets whether to print `console.log` invocations to stdout.\n #[must_use]\n pub fn with_print_logs(mut self, print_logs: bool) -> Self {\n self.print_logs = print_logs;\n self\n }\n\n /// Sets whether to print traces to stdout.\n #[must_use]\n pub fn with_print_traces(mut self, print_traces: bool) -> Self {\n self.print_traces = print_traces;\n self\n }\n\n /// Sets whether to enable autoImpersonate\n #[must_use]\n pub fn with_auto_impersonate(mut self, enable_auto_impersonate: bool) -> Self {\n self.enable_auto_impersonate = enable_auto_impersonate;\n self\n }\n\n #[must_use]\n pub fn with_server_config(mut self, config: ServerConfig) -> Self {\n self.server_config = config;\n self\n }\n\n /// Sets the host the server will listen on\n #[must_use]\n pub fn with_host(mut self, host: Vec) -> Self {\n self.host = if host.is_empty() { vec![IpAddr::V4(Ipv4Addr::LOCALHOST)] } else { host };\n self\n }\n\n #[must_use]\n pub fn with_transaction_order(mut self, transaction_order: TransactionOrder) -> Self {\n self.transaction_order = transaction_order;\n self\n }\n\n /// Returns the ipc path for the ipc endpoint if any\n pub fn get_ipc_path(&self) -> Option {\n match &self.ipc_path {\n Some(path) => path.clone().or_else(|| Some(DEFAULT_IPC_ENDPOINT.to_string())),\n None => None,\n }\n }\n\n /// Prints the config info\n pub fn print(&self, fork: Option<&ClientFork>) -> Result<()> {\n if let Some(path) = &self.config_out {\n let value = self.as_json(fork);\n foundry_common::fs::write_json_file(path, &value).wrap_err(\"failed writing JSON\")?;\n }\n if !self.silent {\n sh_println!(\"{}\", self.as_string(fork))?;\n }\n Ok(())\n }\n\n /// Returns the path where the cache file should be stored\n ///\n /// See also [ Config::foundry_block_cache_file()]\n pub fn block_cache_path(&self, block: u64) -> Option {\n if self.no_storage_caching || self.eth_rpc_url.is_none() {\n return None;\n }\n let chain_id = self.get_chain_id();\n\n Config::foundry_block_cache_file(chain_id, block)\n }\n\n /// Sets whether to disable the default create2 deployer\n #[must_use]\n pub fn with_disable_default_create2_deployer(mut self, yes: bool) -> Self {\n self.disable_default_create2_deployer = yes;\n self\n }\n\n /// Sets whether to disable pool balance checks\n #[must_use]\n pub fn with_disable_pool_balance_checks(mut self, yes: bool) -> Self {\n self.disable_pool_balance_checks = yes;\n self\n }\n\n /// Injects precompiles to `anvil`'s EVM.\n #[must_use]\n pub fn with_precompile_factory(mut self, factory: impl PrecompileFactory + 'static) -> Self {\n self.precompile_factory = Some(Arc::new(factory));\n self\n }\n\n /// Enable features for provided networks.\n #[must_use]\n pub fn with_networks(mut self, networks: NetworkConfigs) -> Self {\n self.networks = networks;\n self\n }\n\n /// Makes the node silent to not emit anything on stdout\n #[must_use]\n pub fn silent(self) -> Self {\n self.set_silent(true)\n }\n\n #[must_use]\n pub fn set_silent(mut self, silent: bool) -> Self {\n self.silent = silent;\n self\n }\n\n /// Sets the path where persisted states are cached (used with `max_persisted_states`).\n ///\n /// Note: This does not control the fork RPC cache location (`storage.json`), which uses\n /// `~/.foundry/cache/rpc///` via [`Config::foundry_block_cache_file`].\n #[must_use]\n pub fn with_cache_path(mut self, cache_path: Option) -> Self {\n self.cache_path = cache_path;\n self\n }\n\n /// Configures everything related to env, backend and database and returns the\n /// [Backend](mem::Backend)\n ///\n /// *Note*: only memory based backend for now\n pub(crate) async fn setup(&mut self) -> Result>\n where\n N: alloy_network::Network<\n TxEnvelope = foundry_primitives::FoundryTxEnvelope,\n ReceiptEnvelope = foundry_primitives::FoundryReceiptEnvelope,\n >,\n {\n // configure the revm environment\n\n let mut cfg = CfgEnv::default();\n cfg.spec = self.get_hardfork().into();\n\n cfg.chain_id = self.get_chain_id();\n cfg.limit_contract_code_size = self.code_size_limit;\n // EIP-3607 rejects transactions from senders with deployed code.\n // If EIP-3607 is enabled it can cause issues during fuzz/invariant tests if the\n // caller is a contract. So we disable the check by default.\n cfg.disable_eip3607 = true;\n cfg.disable_block_gas_limit = self.disable_block_gas_limit;\n\n if !self.enable_tx_gas_limit {\n cfg.tx_gas_limit_cap = Some(u64::MAX);\n }\n\n if let Some(value) = self.memory_limit {\n cfg.memory_limit = value;\n }\n\n let spec_id = cfg.spec;\n let mut env = Env::new(\n EvmEnv::new(\n cfg,\n BlockEnv {\n gas_limit: self.gas_limit(),\n basefee: self.get_base_fee(),\n ..Default::default()\n },\n ),\n OpTransaction {\n base: TxEnv { chain_id: Some(self.get_chain_id()), ..Default::default() },\n ..Default::default()\n },\n self.networks,\n );\n\n let base_fee_params: BaseFeeParams =\n self.networks.base_fee_params(self.get_genesis_timestamp());\n\n let fees = FeeManager::new(\n spec_id,\n self.get_base_fee(),\n !self.disable_min_priority_fee,\n self.get_gas_price(),\n self.get_blob_excess_gas_and_price(),\n self.get_blob_params(),\n base_fee_params,\n );\n\n let (db, fork): (Arc>>, Option) =\n if let Some(eth_rpc_url) = self.eth_rpc_url.clone() {\n self.setup_fork_db(eth_rpc_url, &mut env, &fees).await?\n } else {\n (Arc::new(TokioRwLock::new(Box::::default())), None)\n };\n\n // if provided use all settings of `genesis.json`\n if let Some(ref genesis) = self.genesis {\n // --chain-id flag gets precedence over the genesis.json chain id\n // \n if self.chain_id.is_none() {\n env.evm_env.cfg_env.chain_id = genesis.config.chain_id;\n }\n env.evm_env.block_env.timestamp = U256::from(genesis.timestamp);\n if let Some(base_fee) = genesis.base_fee_per_gas {\n env.evm_env.block_env.basefee = base_fee.try_into()?;\n }\n if let Some(number) = genesis.number {\n env.evm_env.block_env.number = U256::from(number);\n }\n env.evm_env.block_env.beneficiary = genesis.coinbase;\n }\n\n let genesis = GenesisConfig {\n number: self.get_genesis_number(),\n timestamp: self.get_genesis_timestamp(),\n balance: self.genesis_balance,\n accounts: self.genesis_accounts.iter().map(|acc| acc.address()).collect(),\n genesis_init: self.genesis.clone(),\n };\n\n let mut decoder_builder = CallTraceDecoderBuilder::new();\n if self.print_traces {\n // if traces should get printed we configure the decoder with the signatures cache\n if let Ok(identifier) = SignaturesIdentifier::new(false) {\n debug!(target: \"node\", \"using signature identifier\");\n decoder_builder = decoder_builder.with_signature_identifier(identifier);\n }\n }\n\n // only memory based backend for now\n let backend = mem::Backend::with_genesis(\n db,\n Arc::new(RwLock::new(env)),\n genesis,\n fees,\n Arc::new(RwLock::new(fork)),\n self.enable_steps_tracing,\n self.print_logs,\n self.print_traces,\n Arc::new(decoder_builder.build()),\n self.prune_history,\n self.max_persisted_states,\n self.transaction_block_keeper,\n self.block_time,\n self.cache_path.clone(),\n Arc::new(TokioRwLock::new(self.clone())),\n )\n .await?;\n\n // Writes the default create2 deployer to the backend,\n // if the option is not disabled and we are not forking.\n if !self.disable_default_create2_deployer && self.eth_rpc_url.is_none() {\n backend\n .set_create2_deployer(DEFAULT_CREATE2_DEPLOYER)\n .await\n .wrap_err(\"failed to create default create2 deployer\")?;\n }\n\n Ok(backend)\n }\n\n /// Configures everything related to forking based on the passed `eth_rpc_url`:\n /// - returning a tuple of a [ForkedDatabase] wrapped in an [Arc] [RwLock](TokioRwLock) and\n /// [ClientFork] wrapped in an [Option] which can be used in a [Backend](mem::Backend) to\n /// fork from.\n /// - modifying some parameters of the passed `env`\n /// - mutating some members of `self`\n pub async fn setup_fork_db(\n &mut self,\n eth_rpc_url: String,\n env: &mut Env,\n fees: &FeeManager,\n ) -> Result<(Arc>>, Option)> {\n let (db, config) = self.setup_fork_db_config(eth_rpc_url, env, fees).await?;\n let db: Arc>> = Arc::new(TokioRwLock::new(Box::new(db)));\n let fork = ClientFork::new(config, Arc::clone(&db));\n Ok((db, Some(fork)))\n }\n\n /// Configures everything related to forking based on the passed `eth_rpc_url`:\n /// - returning a tuple of a [ForkedDatabase] and [ClientForkConfig] which can be used to build\n /// a [ClientFork] to fork from.\n /// - modifying some parameters of the passed `env`\n /// - mutating some members of `self`\n pub async fn setup_fork_db_config(\n &mut self,\n eth_rpc_url: String,\n env: &mut Env,\n fees: &FeeManager,\n ) -> Result<(ForkedDatabase, ClientForkConfig)> {\n debug!(target: \"node\", ?eth_rpc_url, \"setting up fork db\");\n let provider = Arc::new(\n ProviderBuilder::new(ð_rpc_url)\n .timeout(self.fork_request_timeout)\n .initial_backoff(self.fork_retry_backoff.as_millis() as u64)\n .compute_units_per_second(self.compute_units_per_second)\n .max_retry(self.fork_request_retries)\n .headers(self.fork_headers.clone())\n .build()\n .wrap_err(\"failed to establish provider to fork url\")?,\n );\n\n let (fork_block_number, fork_chain_id, force_transactions) = if let Some(fork_choice) =\n &self.fork_choice\n {\n let (fork_block_number, force_transactions) =\n derive_block_and_transactions(fork_choice, &provider).await.wrap_err(\n \"failed to derive fork block number and force transactions from fork choice\",\n )?;\n let chain_id = if let Some(chain_id) = self.fork_chain_id {\n Some(chain_id)\n } else if self.hardfork.is_none() {\n // Auto-adjust hardfork if not specified, but only if we're forking mainnet.\n let chain_id =\n provider.get_chain_id().await.wrap_err(\"failed to fetch network chain ID\")?;\n if alloy_chains::NamedChain::Mainnet == chain_id {\n let hardfork: EthereumHardfork =\n ethereum_hardfork_from_block_tag(fork_block_number);\n\n env.evm_env.cfg_env.spec = spec_id_from_ethereum_hardfork(hardfork);\n self.hardfork = Some(FoundryHardfork::Ethereum(hardfork));\n }\n Some(U256::from(chain_id))\n } else {\n None\n };\n\n (fork_block_number, chain_id, force_transactions)\n } else {\n // pick the last block number but also ensure it's not pending anymore\n let bn = find_latest_fork_block(&provider)\n .await\n .wrap_err(\"failed to get fork block number\")?;\n (bn, None, None)\n };\n\n let block = provider\n .get_block(BlockNumberOrTag::Number(fork_block_number).into())\n .await\n .wrap_err(\"failed to get fork block\")?;\n\n let block = if let Some(block) = block {\n block\n } else {\n if let Ok(latest_block) = provider.get_block_number().await {\n let mut message = format!(\n \"Failed to get block for block number: {fork_block_number}\\n\\\nlatest block number: {latest_block}\"\n );\n // If the `eth_getBlockByNumber` call succeeds, but returns null instead of\n // the block, and the block number is less than equal the latest block, then\n // the user is forking from a non-archive node with an older block number.\n if fork_block_number <= latest_block {\n message.push_str(&format!(\"\\n{NON_ARCHIVE_NODE_WARNING}\"));\n }\n eyre::bail!(\"{message}\");\n }\n eyre::bail!(\"failed to get block for block number: {fork_block_number}\")\n };\n\n let gas_limit = self.fork_gas_limit(&block);\n self.gas_limit = Some(gas_limit);\n\n env.evm_env.block_env = BlockEnv {\n gas_limit,\n // Keep previous `coinbase` and `basefee` value\n beneficiary: env.evm_env.block_env.beneficiary,\n basefee: env.evm_env.block_env.basefee,\n ..block_env_from_header(&block.header)\n };\n\n // Determine chain_id early so we can use it consistently\n let chain_id = if let Some(chain_id) = self.chain_id {\n chain_id\n } else {\n let chain_id = if let Some(fork_chain_id) = fork_chain_id {\n fork_chain_id.to()\n } else {\n provider.get_chain_id().await.wrap_err(\"failed to fetch network chain ID\")?\n };\n\n // need to update the dev signers and env with the chain id\n self.set_chain_id(Some(chain_id));\n env.evm_env.cfg_env.chain_id = chain_id;\n env.tx.base.chain_id = chain_id.into();\n chain_id\n };\n\n // if not set explicitly we use the base fee of the latest block\n if self.base_fee.is_none()\n && let Some(base_fee) = block.header.base_fee_per_gas()\n {\n self.base_fee = Some(base_fee);\n env.evm_env.block_env.basefee = base_fee;\n // this is the base fee of the current block, but we need the base fee of\n // the next block\n let next_block_base_fee = fees.get_next_block_base_fee_per_gas(\n block.header.gas_used(),\n gas_limit,\n block.header.base_fee_per_gas().unwrap_or_default(),\n );\n\n // update next base fee\n fees.set_base_fee(next_block_base_fee);\n }\n\n if let (Some(blob_excess_gas), Some(blob_gas_used)) =\n (block.header.excess_blob_gas(), block.header.blob_gas_used())\n {\n // Derive blob params using the fork block timestamp regardless of explicit base fee.\n let blob_params = get_blob_params(chain_id, block.header.timestamp());\n\n env.evm_env.block_env.blob_excess_gas_and_price = Some(BlobExcessGasAndPrice::new(\n blob_excess_gas,\n blob_params.update_fraction as u64,\n ));\n\n fees.set_blob_params(blob_params);\n\n let next_block_blob_excess_gas =\n fees.get_next_block_blob_excess_gas(blob_excess_gas, blob_gas_used);\n fees.set_blob_excess_gas_and_price(BlobExcessGasAndPrice::new(\n next_block_blob_excess_gas,\n blob_params.update_fraction as u64,\n ));\n }\n\n // use remote gas price\n if self.gas_price.is_none()\n && let Ok(gas_price) = provider.get_gas_price().await\n {\n self.gas_price = Some(gas_price);\n fees.set_gas_price(gas_price);\n }\n\n let block_hash = block.header.hash;\n\n let override_chain_id = self.chain_id;\n // apply changes such as difficulty -> prevrandao and chain specifics for current chain id\n apply_chain_and_block_specific_env_changes::(\n &mut env.evm_env,\n &block,\n self.networks,\n );\n\n let meta = BlockchainDbMeta::new(env.evm_env.block_env.clone(), eth_rpc_url.clone());\n let block_chain_db = if self.fork_chain_id.is_some() {\n BlockchainDb::new_skip_check(meta, self.block_cache_path(fork_block_number))\n } else {\n BlockchainDb::new(meta, self.block_cache_path(fork_block_number))\n };\n\n // This will spawn the background thread that will use the provider to fetch\n // blockchain data from the other client\n let backend = SharedBackend::spawn_backend(\n Arc::clone(&provider),\n block_chain_db.clone(),\n Some(fork_block_number.into()),\n )\n .await;\n\n let config = ClientForkConfig {\n eth_rpc_url,\n block_number: fork_block_number,\n block_hash,\n transaction_hash: self.fork_choice.and_then(|fc| fc.transaction_hash()),\n provider,\n chain_id,\n override_chain_id,\n timestamp: block.header.timestamp(),\n base_fee: block.header.base_fee_per_gas().map(|g| g as u128),\n timeout: self.fork_request_timeout,\n retries: self.fork_request_retries,\n backoff: self.fork_retry_backoff,\n compute_units_per_second: self.compute_units_per_second,\n total_difficulty: block.header.total_difficulty.unwrap_or_default(),\n blob_gas_used: block.header.blob_gas_used().map(|g| g as u128),\n blob_excess_gas_and_price: env.evm_env.block_env.blob_excess_gas_and_price,\n force_transactions,\n };\n\n debug!(target: \"node\", fork_number=config.block_number, fork_hash=%config.block_hash, \"set up fork db\");\n\n let mut db = ForkedDatabase::new(backend, block_chain_db);\n\n // need to insert the forked block's hash\n db.insert_block_hash(U256::from(config.block_number), config.block_hash);\n\n Ok((db, config))\n }\n\n /// we only use the gas limit value of the block if it is non-zero and the block gas\n /// limit is enabled, since there are networks where this is not used and is always\n /// `0x0` which would inevitably result in `OutOfGas` errors as soon as the evm is about to record gas, See also \n pub(crate) fn fork_gas_limit>(&self, block: &B) -> u64 {\n if !self.disable_block_gas_limit {\n if let Some(gas_limit) = self.gas_limit {\n return gas_limit;\n } else if block.header().gas_limit() > 0 {\n return block.header().gas_limit();\n }\n }\n\n u64::MAX\n }\n\n /// Returns the gas limit for a non forked anvil instance\n ///\n /// Checks the config for the `disable_block_gas_limit` flag\n pub(crate) fn gas_limit(&self) -> u64 {\n if self.disable_block_gas_limit {\n return u64::MAX;\n }\n\n self.gas_limit.unwrap_or(DEFAULT_GAS_LIMIT)\n }\n}\n\n/// If the fork choice is a block number, simply return it with an empty list of transactions.\n/// If the fork choice is a transaction hash, determine the block that the transaction was mined in,\n/// and return the block number before the fork block along with all transactions in the fork block\n/// that are before (and including) the fork transaction.\nasync fn derive_block_and_transactions(\n fork_choice: &ForkChoice,\n provider: &Arc,\n) -> eyre::Result<(BlockNumber, Option>>)> {\n match fork_choice {\n ForkChoice::Block(block_number) => {\n let block_number = *block_number;\n if block_number >= 0 {\n return Ok((block_number as u64, None));\n }\n // subtract from latest block number\n let latest = provider.get_block_number().await?;\n\n Ok((block_number.saturating_add(latest as i128) as u64, None))\n }\n ForkChoice::Transaction(transaction_hash) => {\n // Determine the block that this transaction was mined in\n let transaction = provider\n .get_transaction_by_hash(transaction_hash.0.into())\n .await?\n .ok_or_else(|| eyre::eyre!(\"failed to get fork transaction by hash\"))?;\n let transaction_block_number = transaction.block_number().ok_or_else(|| {\n eyre::eyre!(\"fork transaction is not mined yet (no block number)\")\n })?;\n\n // Get the block pertaining to the fork transaction\n let transaction_block = provider\n .get_block_by_number(transaction_block_number.into())\n .full()\n .await?\n .ok_or_else(|| eyre::eyre!(\"failed to get fork block by number\"))?;\n\n // Filter out transactions that are after the fork transaction\n let filtered_transactions = transaction_block\n .transactions\n .as_transactions()\n .ok_or_else(|| eyre::eyre!(\"failed to get transactions from full fork block\"))?\n .iter()\n .take_while_inclusive(|&transaction| transaction.tx_hash() != transaction_hash.0)\n .collect::>();\n\n // Convert the transactions to PoolTransactions\n let force_transactions = filtered_transactions\n .iter()\n .map(|&transaction| PoolTransaction::try_from(transaction.clone()))\n .collect::, _>>()\n .map_err(|e| eyre::eyre!(\"Err converting to pool transactions {e}\"))?;\n Ok((transaction_block_number.saturating_sub(1), Some(force_transactions)))\n }\n }\n}\n\n/// Fork delimiter used to specify which block or transaction to fork from.\n#[derive(Clone, Copy, Debug, PartialEq, Eq)]\npub enum ForkChoice {\n /// Block number to fork from.\n ///\n /// If negative, the given value is subtracted from the `latest` block number.\n Block(i128),\n /// Transaction hash to fork from.\n Transaction(TxHash),\n}\n\nimpl ForkChoice {\n /// Returns the block number to fork from\n pub fn block_number(&self) -> Option {\n match self {\n Self::Block(block_number) => Some(*block_number),\n Self::Transaction(_) => None,\n }\n }\n\n /// Returns the transaction hash to fork from\n pub fn transaction_hash(&self) -> Option {\n match self {\n Self::Block(_) => None,\n Self::Transaction(transaction_hash) => Some(*transaction_hash),\n }\n }\n}\n\n/// Convert a transaction hash into a ForkChoice\nimpl From for ForkChoice {\n fn from(tx_hash: TxHash) -> Self {\n Self::Transaction(tx_hash)\n }\n}\n\n/// Convert a decimal block number into a ForkChoice\nimpl From for ForkChoice {\n fn from(block: u64) -> Self {\n Self::Block(block as i128)\n }\n}\n\n#[derive(Clone, Copy, Debug, Default, PartialEq, Eq)]\npub struct PruneStateHistoryConfig {\n pub enabled: bool,\n pub max_memory_history: Option,\n}\n\nimpl PruneStateHistoryConfig {\n /// Returns `true` if writing state history is supported\n pub fn is_state_history_supported(&self) -> bool {\n !self.enabled || self.max_memory_history.is_some()\n }\n\n /// Returns true if this setting was enabled.\n pub fn is_config_enabled(&self) -> bool {\n self.enabled\n }\n\n pub fn from_args(val: Option>) -> Self {\n val.map(|max_memory_history| Self { enabled: true, max_memory_history }).unwrap_or_default()\n }\n}\n\n/// Can create dev accounts\n#[derive(Clone, Debug)]\npub struct AccountGenerator {\n chain_id: u64,\n amount: usize,\n phrase: String,\n derivation_path: Option,\n}\n\nimpl AccountGenerator {\n pub fn new(amount: usize) -> Self {\n Self {\n chain_id: CHAIN_ID,\n amount,\n phrase: Mnemonic::::new(&mut thread_rng()).to_phrase(),\n derivation_path: None,\n }\n }\n\n #[must_use]\n pub fn phrase(mut self, phrase: impl Into) -> Self {\n self.phrase = phrase.into();\n self\n }\n\n fn get_phrase(&self) -> &str {\n &self.phrase\n }\n\n #[must_use]\n pub fn chain_id(mut self, chain_id: impl Into) -> Self {\n self.chain_id = chain_id.into();\n self\n }\n\n #[must_use]\n pub fn derivation_path(mut self, derivation_path: impl Into) -> Self {\n let mut derivation_path = derivation_path.into();\n if !derivation_path.ends_with('/') {\n derivation_path.push('/');\n }\n self.derivation_path = Some(derivation_path);\n self\n }\n\n fn get_derivation_path(&self) -> &str {\n self.derivation_path.as_deref().unwrap_or(\"m/44'/60'/0'/0/\")\n }\n}\n\nimpl AccountGenerator {\n pub fn generate(&self) -> eyre::Result> {\n let builder = MnemonicBuilder::::default().phrase(self.phrase.as_str());\n\n // use the derivation path\n let derivation_path = self.get_derivation_path();\n\n let mut wallets = Vec::with_capacity(self.amount);\n for idx in 0..self.amount {\n let builder =\n builder.clone().derivation_path(format!(\"{derivation_path}{idx}\")).unwrap();\n let wallet = builder.build()?.with_chain_id(Some(self.chain_id));\n wallets.push(wallet)\n }\n Ok(wallets)\n }\n}\n\n/// Returns the path to anvil dir `~/.foundry/anvil`\npub fn anvil_dir() -> Option {\n Config::foundry_dir().map(|p| p.join(\"anvil\"))\n}\n\n/// Returns the root path to anvil's temporary storage `~/.foundry/anvil/`\npub fn anvil_tmp_dir() -> Option {\n anvil_dir().map(|p| p.join(\"tmp\"))\n}\n\n/// Finds the latest appropriate block to fork\n///\n/// This fetches the \"latest\" block and checks whether the `Block` is fully populated (`hash` field\n/// is present). This prevents edge cases where anvil forks the \"latest\" block but `eth_getBlockByNumber` still returns a pending block, \nasync fn find_latest_fork_block>(\n provider: P,\n) -> Result {\n let mut num = provider.get_block_number().await?;\n\n // walk back from the head of the chain, but at most 2 blocks, which should be more than enough\n // leeway\n for _ in 0..2 {\n if let Some(block) = provider.get_block(num.into()).await?\n && !block.header.hash.is_zero()\n {\n break;\n }\n // block not actually finalized, so we try the block before\n num = num.saturating_sub(1)\n }\n\n Ok(num)\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n\n #[test]\n fn test_prune_history() {\n let config = PruneStateHistoryConfig::default();\n assert!(config.is_state_history_supported());\n let config = PruneStateHistoryConfig::from_args(Some(None));\n assert!(!config.is_state_history_supported());\n let config = PruneStateHistoryConfig::from_args(Some(Some(10)));\n assert!(config.is_state_history_supported());\n }\n}\n" }, { "path": "crates/anvil/src/error.rs", "content": "/// Result alias\npub type NodeResult = Result;\n\n/// An error that can occur when launching a anvil instance\n#[derive(Debug, thiserror::Error)]\npub enum NodeError {\n #[error(transparent)]\n Hyper(#[from] hyper::Error),\n #[error(transparent)]\n Io(#[from] std::io::Error),\n}\n" }, { "path": "crates/anvil/src/eth/api.rs", "content": "use super::{\n backend::mem::{BlockRequest, DatabaseRef, State},\n sign::build_impersonated,\n};\nuse crate::{\n ClientFork, LoggingManager, Miner, MiningMode, StorageInfo,\n eth::{\n backend::{\n self,\n db::SerializableState,\n mem::{MIN_CREATE_GAS, MIN_TRANSACTION_GAS},\n notifications::NewBlockNotifications,\n validate::TransactionValidator,\n },\n error::{\n BlockchainError, FeeHistoryError, InvalidTransactionError, Result, ToRpcResponseResult,\n },\n fees::{FeeDetails, FeeHistoryCache, MIN_SUGGESTED_PRIORITY_FEE},\n macros::node_info,\n miner::FixedBlockTimeMiner,\n pool::{\n Pool,\n transactions::{\n PoolTransaction, TransactionOrder, TransactionPriority, TxMarker, to_marker,\n },\n },\n sign::{self, Signer},\n },\n filter::{EthFilter, Filters, LogsFilter},\n mem::transaction_build,\n};\nuse alloy_consensus::{\n Blob, BlockHeader, Transaction, TrieAccount, TxEip4844Variant, transaction::Recovered,\n};\nuse alloy_dyn_abi::TypedData;\nuse alloy_eips::{\n eip2718::Encodable2718,\n eip7910::{EthConfig, EthForkConfig},\n};\nuse alloy_evm::overrides::{OverrideBlockHashes, apply_state_overrides};\nuse alloy_network::{\n AnyRpcBlock, AnyRpcTransaction, BlockResponse, Network, ReceiptResponse, TransactionBuilder,\n TransactionBuilder4844, TransactionResponse, eip2718::Decodable2718,\n};\nuse alloy_primitives::{\n Address, B64, B256, Bytes, TxHash, TxKind, U64, U256,\n map::{HashMap, HashSet},\n};\nuse alloy_rpc_types::{\n AccessList, AccessListResult, BlockId, BlockNumberOrTag as BlockNumber, BlockTransactions,\n EIP1186AccountProofResponse, FeeHistory, Filter, FilteredParams, Index, Log, Work,\n anvil::{\n ForkedNetwork, Forking, Metadata, MineOptions, NodeEnvironment, NodeForkConfig, NodeInfo,\n },\n request::TransactionRequest,\n simulate::{SimulatePayload, SimulatedBlock},\n state::{AccountOverride, EvmOverrides, StateOverridesBuilder},\n trace::{\n filter::TraceFilter,\n geth::{GethDebugTracingCallOptions, GethDebugTracingOptions, GethTrace},\n parity::{LocalizedTransactionTrace, TraceResultsWithTransactionHash, TraceType},\n },\n txpool::{TxpoolContent, TxpoolInspect, TxpoolInspectSummary, TxpoolStatus},\n};\nuse alloy_rpc_types_eth::FillTransaction;\nuse alloy_serde::WithOtherFields;\nuse alloy_sol_types::{SolCall, SolValue, sol};\nuse alloy_transport::TransportErrorKind;\nuse anvil_core::{\n eth::{\n EthRequest,\n block::BlockInfo,\n transaction::{MaybeImpersonatedTransaction, PendingTransaction},\n },\n types::{ReorgOptions, TransactionData},\n};\nuse anvil_rpc::{error::RpcError, response::ResponseResult};\nuse foundry_common::provider::ProviderBuilder;\nuse foundry_evm::decode::RevertDecoder;\nuse foundry_primitives::{\n FoundryNetwork, FoundryTransactionRequest, FoundryTxEnvelope, FoundryTxReceipt, FoundryTxType,\n FoundryTypedTx,\n};\nuse futures::{\n StreamExt, TryFutureExt,\n channel::{mpsc::Receiver, oneshot},\n};\nuse parking_lot::RwLock;\nuse revm::{\n context::BlockEnv,\n context_interface::{block::BlobExcessGasAndPrice, result::Output},\n database::CacheDB,\n interpreter::{InstructionResult, return_ok, return_revert},\n primitives::eip7702::PER_EMPTY_ACCOUNT_COST,\n};\nuse std::{sync::Arc, time::Duration};\nuse tokio::{\n sync::mpsc::{UnboundedReceiver, unbounded_channel},\n try_join,\n};\n\n/// The client version: `anvil/v{major}.{minor}.{patch}`\npub const CLIENT_VERSION: &str = concat!(\"anvil/v\", env!(\"CARGO_PKG_VERSION\"));\n\n/// The entry point for executing eth api RPC call - The Eth RPC interface.\n///\n/// This type is cheap to clone and can be used concurrently\npub struct EthApi {\n /// The transaction pool\n pool: Arc>,\n /// Holds all blockchain related data\n /// In-Memory only for now\n pub backend: Arc>,\n /// Whether this node is mining\n is_mining: bool,\n /// available signers\n signers: Arc>>>,\n /// data required for `eth_feeHistory`\n fee_history_cache: FeeHistoryCache,\n /// max number of items kept in fee cache\n fee_history_limit: u64,\n /// access to the actual miner\n ///\n /// This access is required in order to adjust miner settings based on requests received from\n /// custom RPC endpoints\n miner: Miner,\n /// allows to enabled/disable logging\n logger: LoggingManager,\n /// Tracks all active filters\n filters: Filters,\n /// How transactions are ordered in the pool\n transaction_order: Arc>,\n /// Whether we're listening for RPC calls\n net_listening: bool,\n /// The instance ID. Changes on every reset.\n instance_id: Arc>,\n}\n\nimpl Clone for EthApi {\n fn clone(&self) -> Self {\n Self {\n pool: self.pool.clone(),\n backend: self.backend.clone(),\n is_mining: self.is_mining,\n signers: self.signers.clone(),\n fee_history_cache: self.fee_history_cache.clone(),\n fee_history_limit: self.fee_history_limit,\n miner: self.miner.clone(),\n logger: self.logger.clone(),\n filters: self.filters.clone(),\n transaction_order: self.transaction_order.clone(),\n net_listening: self.net_listening,\n instance_id: self.instance_id.clone(),\n }\n }\n}\n\n// == impl EthApi generic methods ==\n\nimpl EthApi {\n /// Creates a new instance\n #[expect(clippy::too_many_arguments)]\n pub fn new(\n pool: Arc>,\n backend: Arc>,\n signers: Arc>>>,\n fee_history_cache: FeeHistoryCache,\n fee_history_limit: u64,\n miner: Miner,\n logger: LoggingManager,\n filters: Filters,\n transactions_order: TransactionOrder,\n ) -> Self {\n Self {\n pool,\n backend,\n is_mining: true,\n signers,\n fee_history_cache,\n fee_history_limit,\n miner,\n logger,\n filters,\n net_listening: true,\n transaction_order: Arc::new(RwLock::new(transactions_order)),\n instance_id: Arc::new(RwLock::new(B256::random())),\n }\n }\n\n /// Returns the current gas price\n pub fn gas_price(&self) -> u128 {\n if self.backend.is_eip1559() {\n if self.backend.is_min_priority_fee_enforced() {\n (self.backend.base_fee() as u128).saturating_add(self.lowest_suggestion_tip())\n } else {\n self.backend.base_fee() as u128\n }\n } else {\n self.backend.fees().raw_gas_price()\n }\n }\n\n /// Returns the suggested fee cap.\n ///\n /// Returns at least [MIN_SUGGESTED_PRIORITY_FEE]\n fn lowest_suggestion_tip(&self) -> u128 {\n let block_number = self.backend.best_number();\n let latest_cached_block = self.fee_history_cache.lock().get(&block_number).cloned();\n\n match latest_cached_block {\n Some(block) => block.rewards.iter().copied().min(),\n None => self.fee_history_cache.lock().values().flat_map(|b| b.rewards.clone()).min(),\n }\n .map(|fee| fee.max(MIN_SUGGESTED_PRIORITY_FEE))\n .unwrap_or(MIN_SUGGESTED_PRIORITY_FEE)\n }\n\n /// Returns true if auto mining is enabled, and false.\n ///\n /// Handler for ETH RPC call: `anvil_getAutomine`\n pub fn anvil_get_auto_mine(&self) -> Result {\n node_info!(\"anvil_getAutomine\");\n Ok(self.miner.is_auto_mine())\n }\n\n /// Returns the value of mining interval, if set.\n ///\n /// Handler for ETH RPC call: `anvil_getIntervalMining`.\n pub fn anvil_get_interval_mining(&self) -> Result> {\n node_info!(\"anvil_getIntervalMining\");\n Ok(self.miner.get_interval())\n }\n\n /// Enables or disables, based on the single boolean argument, the automatic mining of new\n /// blocks with each new transaction submitted to the network.\n ///\n /// Handler for ETH RPC call: `evm_setAutomine`\n pub async fn anvil_set_auto_mine(&self, enable_automine: bool) -> Result<()> {\n node_info!(\"evm_setAutomine\");\n if self.miner.is_auto_mine() {\n if enable_automine {\n return Ok(());\n }\n self.miner.set_mining_mode(MiningMode::None);\n } else if enable_automine {\n let listener = self.pool.add_ready_listener();\n let mode = MiningMode::instant(1_000, listener);\n self.miner.set_mining_mode(mode);\n }\n Ok(())\n }\n\n /// Sets the mining behavior to interval with the given interval (seconds)\n ///\n /// Handler for ETH RPC call: `evm_setIntervalMining`\n pub fn anvil_set_interval_mining(&self, secs: u64) -> Result<()> {\n node_info!(\"evm_setIntervalMining\");\n let mining_mode = if secs == 0 {\n MiningMode::None\n } else {\n let block_time = Duration::from_secs(secs);\n\n // This ensures that memory limits are stricter in interval-mine mode\n self.backend.update_interval_mine_block_time(block_time);\n\n MiningMode::FixedBlockTime(FixedBlockTimeMiner::new(block_time))\n };\n self.miner.set_mining_mode(mining_mode);\n Ok(())\n }\n\n /// Removes transactions from the pool\n ///\n /// Handler for RPC call: `anvil_dropTransaction`\n pub async fn anvil_drop_transaction(&self, tx_hash: B256) -> Result> {\n node_info!(\"anvil_dropTransaction\");\n Ok(self.pool.drop_transaction(tx_hash).map(|tx| tx.hash()))\n }\n\n /// Removes all transactions from the pool\n ///\n /// Handler for RPC call: `anvil_dropAllTransactions`\n pub async fn anvil_drop_all_transactions(&self) -> Result<()> {\n node_info!(\"anvil_dropAllTransactions\");\n self.pool.clear();\n Ok(())\n }\n\n pub async fn anvil_set_chain_id(&self, chain_id: u64) -> Result<()> {\n node_info!(\"anvil_setChainId\");\n self.backend.set_chain_id(chain_id);\n Ok(())\n }\n\n /// Modifies the balance of an account.\n ///\n /// Handler for RPC call: `anvil_setBalance`\n pub async fn anvil_set_balance(&self, address: Address, balance: U256) -> Result<()> {\n node_info!(\"anvil_setBalance\");\n self.backend.set_balance(address, balance).await?;\n Ok(())\n }\n\n /// Sets the code of a contract.\n ///\n /// Handler for RPC call: `anvil_setCode`\n pub async fn anvil_set_code(&self, address: Address, code: Bytes) -> Result<()> {\n node_info!(\"anvil_setCode\");\n self.backend.set_code(address, code).await?;\n Ok(())\n }\n\n /// Sets the nonce of an address.\n ///\n /// Handler for RPC call: `anvil_setNonce`\n pub async fn anvil_set_nonce(&self, address: Address, nonce: U256) -> Result<()> {\n node_info!(\"anvil_setNonce\");\n self.backend.set_nonce(address, nonce).await?;\n Ok(())\n }\n\n /// Writes a single slot of the account's storage.\n ///\n /// Handler for RPC call: `anvil_setStorageAt`\n pub async fn anvil_set_storage_at(\n &self,\n address: Address,\n slot: U256,\n val: B256,\n ) -> Result {\n node_info!(\"anvil_setStorageAt\");\n self.backend.set_storage_at(address, slot, val).await?;\n Ok(true)\n }\n\n /// Enable or disable logging.\n ///\n /// Handler for RPC call: `anvil_setLoggingEnabled`\n pub async fn anvil_set_logging(&self, enable: bool) -> Result<()> {\n node_info!(\"anvil_setLoggingEnabled\");\n self.logger.set_enabled(enable);\n Ok(())\n }\n\n /// Set the minimum gas price for the node.\n ///\n /// Handler for RPC call: `anvil_setMinGasPrice`\n pub async fn anvil_set_min_gas_price(&self, gas: U256) -> Result<()> {\n node_info!(\"anvil_setMinGasPrice\");\n if self.backend.is_eip1559() {\n return Err(RpcError::invalid_params(\n \"anvil_setMinGasPrice is not supported when EIP-1559 is active\",\n )\n .into());\n }\n self.backend.set_gas_price(gas.to());\n Ok(())\n }\n\n /// Sets the base fee of the next block.\n ///\n /// Handler for RPC call: `anvil_setNextBlockBaseFeePerGas`\n pub async fn anvil_set_next_block_base_fee_per_gas(&self, basefee: U256) -> Result<()> {\n node_info!(\"anvil_setNextBlockBaseFeePerGas\");\n if !self.backend.is_eip1559() {\n return Err(RpcError::invalid_params(\n \"anvil_setNextBlockBaseFeePerGas is only supported when EIP-1559 is active\",\n )\n .into());\n }\n self.backend.set_base_fee(basefee.to());\n Ok(())\n }\n\n /// Sets the coinbase address.\n ///\n /// Handler for RPC call: `anvil_setCoinbase`\n pub async fn anvil_set_coinbase(&self, address: Address) -> Result<()> {\n node_info!(\"anvil_setCoinbase\");\n self.backend.set_coinbase(address);\n Ok(())\n }\n\n /// Retrieves the Anvil node configuration params.\n ///\n /// Handler for RPC call: `anvil_nodeInfo`\n pub async fn anvil_node_info(&self) -> Result {\n node_info!(\"anvil_nodeInfo\");\n\n let env = self.backend.env().read();\n let fork_config = self.backend.get_fork();\n let tx_order = self.transaction_order.read();\n let hard_fork: &str = env.evm_env.cfg_env.spec.into();\n\n Ok(NodeInfo {\n current_block_number: self.backend.best_number(),\n current_block_timestamp: env.evm_env.block_env.timestamp.saturating_to(),\n current_block_hash: self.backend.best_hash(),\n hard_fork: hard_fork.to_string(),\n transaction_order: match *tx_order {\n TransactionOrder::Fifo => \"fifo\".to_string(),\n TransactionOrder::Fees => \"fees\".to_string(),\n },\n environment: NodeEnvironment {\n base_fee: self.backend.base_fee() as u128,\n chain_id: self.backend.chain_id().to::(),\n gas_limit: self.backend.gas_limit(),\n gas_price: self.gas_price(),\n },\n fork_config: fork_config\n .map(|fork| {\n let config = fork.config.read();\n\n NodeForkConfig {\n fork_url: Some(config.eth_rpc_url.clone()),\n fork_block_number: Some(config.block_number),\n fork_retry_backoff: Some(config.backoff.as_millis()),\n }\n })\n .unwrap_or_default(),\n })\n }\n\n /// Retrieves metadata about the Anvil instance.\n ///\n /// Handler for RPC call: `anvil_metadata`\n pub async fn anvil_metadata(&self) -> Result {\n node_info!(\"anvil_metadata\");\n let fork_config = self.backend.get_fork();\n\n Ok(Metadata {\n client_version: CLIENT_VERSION.to_string(),\n chain_id: self.backend.chain_id().to::(),\n latest_block_hash: self.backend.best_hash(),\n latest_block_number: self.backend.best_number(),\n instance_id: *self.instance_id.read(),\n forked_network: fork_config.map(|cfg| ForkedNetwork {\n chain_id: cfg.chain_id(),\n fork_block_number: cfg.block_number(),\n fork_block_hash: cfg.block_hash(),\n }),\n snapshots: self.backend.list_state_snapshots(),\n })\n }\n\n pub async fn anvil_remove_pool_transactions(&self, address: Address) -> Result<()> {\n node_info!(\"anvil_removePoolTransactions\");\n self.pool.remove_transactions_by_address(address);\n Ok(())\n }\n\n /// Snapshot the state of the blockchain at the current block.\n ///\n /// Handler for RPC call: `evm_snapshot`\n pub async fn evm_snapshot(&self) -> Result {\n node_info!(\"evm_snapshot\");\n Ok(self.backend.create_state_snapshot().await)\n }\n\n /// Jump forward in time by the given amount of time, in seconds.\n ///\n /// Handler for RPC call: `evm_increaseTime`\n pub async fn evm_increase_time(&self, seconds: U256) -> Result {\n node_info!(\"evm_increaseTime\");\n Ok(self.backend.time().increase_time(seconds.try_into().unwrap_or(u64::MAX)) as i64)\n }\n\n /// Similar to `evm_increaseTime` but takes the exact timestamp that you want in the next block\n ///\n /// Handler for RPC call: `evm_setNextBlockTimestamp`\n pub fn evm_set_next_block_timestamp(&self, seconds: u64) -> Result<()> {\n node_info!(\"evm_setNextBlockTimestamp\");\n self.backend.time().set_next_block_timestamp(seconds)\n }\n\n /// Sets the specific timestamp and returns the number of seconds between the given timestamp\n /// and the current time.\n ///\n /// Handler for RPC call: `evm_setTime`\n pub fn evm_set_time(&self, timestamp: u64) -> Result {\n node_info!(\"evm_setTime\");\n let now = self.backend.time().current_call_timestamp();\n self.backend.time().reset(timestamp);\n\n // number of seconds between the given timestamp and the current time.\n let offset = timestamp.saturating_sub(now);\n Ok(Duration::from_millis(offset).as_secs())\n }\n\n /// Set the next block gas limit\n ///\n /// Handler for RPC call: `evm_setBlockGasLimit`\n pub fn evm_set_block_gas_limit(&self, gas_limit: U256) -> Result {\n node_info!(\"evm_setBlockGasLimit\");\n self.backend.set_gas_limit(gas_limit.to());\n Ok(true)\n }\n\n /// Sets an interval for the block timestamp\n ///\n /// Handler for RPC call: `anvil_setBlockTimestampInterval`\n pub fn evm_set_block_timestamp_interval(&self, seconds: u64) -> Result<()> {\n node_info!(\"anvil_setBlockTimestampInterval\");\n self.backend.time().set_block_timestamp_interval(seconds);\n Ok(())\n }\n\n /// Sets an interval for the block timestamp\n ///\n /// Handler for RPC call: `anvil_removeBlockTimestampInterval`\n pub fn evm_remove_block_timestamp_interval(&self) -> Result {\n node_info!(\"anvil_removeBlockTimestampInterval\");\n Ok(self.backend.time().remove_block_timestamp_interval())\n }\n\n /// Sets the backend rpc url\n ///\n /// Handler for ETH RPC call: `anvil_setRpcUrl`\n pub fn anvil_set_rpc_url(&self, url: String) -> Result<()> {\n node_info!(\"anvil_setRpcUrl\");\n if let Some(fork) = self.backend.get_fork() {\n let mut config = fork.config.write();\n // let interval = config.provider.get_interval();\n let new_provider = Arc::new(\n ProviderBuilder::new(&url).max_retry(10).initial_backoff(1000).build().map_err(\n |_| {\n TransportErrorKind::custom_str(\n format!(\"Failed to parse invalid url {url}\").as_str(),\n )\n },\n // TODO: Add interval\n )?, // .interval(interval),\n );\n config.provider = new_provider;\n trace!(target: \"backend\", \"Updated fork rpc from \\\"{}\\\" to \\\"{}\\\"\", config.eth_rpc_url, url);\n config.eth_rpc_url = url;\n }\n Ok(())\n }\n\n /// Returns the number of transactions currently pending for inclusion in the next block(s), as\n /// well as the ones that are being scheduled for future execution only.\n /// Ref: [Here](https://geth.ethereum.org/docs/rpc/ns-txpool#txpool_status)\n ///\n /// Handler for ETH RPC call: `txpool_status`\n pub async fn txpool_status(&self) -> Result {\n node_info!(\"txpool_status\");\n Ok(self.pool.txpool_status())\n }\n\n /// Executes the future on a new blocking task.\n async fn on_blocking_task(&self, c: C) -> Result\n where\n C: FnOnce(Self) -> F,\n F: Future> + Send + 'static,\n R: Send + 'static,\n {\n let (tx, rx) = oneshot::channel();\n let this = self.clone();\n let f = c(this);\n tokio::task::spawn_blocking(move || {\n tokio::runtime::Handle::current().block_on(async move {\n let res = f.await;\n let _ = tx.send(res);\n })\n });\n rx.await.map_err(|_| BlockchainError::Internal(\"blocking task panicked\".to_string()))?\n }\n\n /// Updates the `TransactionOrder`\n pub fn set_transaction_order(&self, order: TransactionOrder) {\n *self.transaction_order.write() = order;\n }\n\n /// Returns the chain ID used for transaction\n pub fn chain_id(&self) -> u64 {\n self.backend.chain_id().to::()\n }\n\n /// Returns the configured fork, if any.\n pub fn get_fork(&self) -> Option {\n self.backend.get_fork()\n }\n\n /// Returns the current instance's ID.\n pub fn instance_id(&self) -> B256 {\n *self.instance_id.read()\n }\n\n /// Resets the instance ID.\n pub fn reset_instance_id(&self) {\n *self.instance_id.write() = B256::random();\n }\n\n /// Returns the first signer that can sign for the given address\n #[expect(clippy::borrowed_box)]\n pub fn get_signer(&self, address: Address) -> Option<&Box>> {\n self.signers.iter().find(|signer| signer.is_signer_for(address))\n }\n\n /// Returns a new listeners for ready transactions\n pub fn new_ready_transactions(&self) -> Receiver {\n self.pool.add_ready_listener()\n }\n\n /// Returns true if forked\n pub fn is_fork(&self) -> bool {\n self.backend.is_fork()\n }\n\n /// Returns the current state root\n pub async fn state_root(&self) -> Option {\n self.backend.get_db().read().await.maybe_state_root()\n }\n\n /// Returns true if the `addr` is currently impersonated\n pub fn is_impersonated(&self, addr: Address) -> bool {\n self.backend.cheats().is_impersonated(addr)\n }\n\n /// Returns a new accessor for certain storage elements\n pub fn storage_info(&self) -> StorageInfo {\n StorageInfo::new(Arc::clone(&self.backend))\n }\n}\n\n// == impl EthApi anvil endpoints ==\n\nimpl EthApi {\n /// Reset the fork to a fresh forked state, and optionally update the fork config.\n ///\n /// If `forking` is `None` then this will disable forking entirely.\n ///\n /// Handler for RPC call: `anvil_reset`\n pub async fn anvil_reset(&self, forking: Option) -> Result<()> {\n self.reset_instance_id();\n node_info!(\"anvil_reset\");\n if let Some(forking) = forking {\n // if we're resetting the fork we need to reset the instance id\n self.backend.reset_fork(forking).await?;\n } else {\n // Reset to a fresh in-memory state\n self.backend.reset_to_in_mem().await?;\n }\n // Clear pending transactions since they reference the old chain state.\n self.pool.clear();\n Ok(())\n }\n\n /// Create a buffer that represents all state on the chain, which can be loaded to separate\n /// process by calling `anvil_loadState`\n ///\n /// Handler for RPC call: `anvil_dumpState`\n pub async fn anvil_dump_state(\n &self,\n preserve_historical_states: Option,\n ) -> Result {\n node_info!(\"anvil_dumpState\");\n self.backend.dump_state(preserve_historical_states.unwrap_or(false)).await\n }\n\n /// Returns the current state\n pub async fn serialized_state(\n &self,\n preserve_historical_states: bool,\n ) -> Result {\n self.backend.serialized_state(preserve_historical_states).await\n }\n\n /// Append chain state buffer to current chain. Will overwrite any conflicting addresses or\n /// storage.\n ///\n /// Handler for RPC call: `anvil_loadState`\n pub async fn anvil_load_state(&self, buf: Bytes) -> Result {\n node_info!(\"anvil_loadState\");\n self.backend.load_state_bytes(buf).await\n }\n\n /// Revert the state of the blockchain to a previous snapshot.\n /// Takes a single parameter, which is the snapshot id to revert to.\n ///\n /// Handler for RPC call: `evm_revert`\n pub async fn evm_revert(&self, id: U256) -> Result {\n node_info!(\"evm_revert\");\n self.backend.revert_state_snapshot(id).await\n }\n\n async fn block_request(\n &self,\n block_number: Option,\n ) -> Result> {\n let block_request = match block_number {\n Some(BlockId::Number(BlockNumber::Pending)) => {\n let pending_txs = self.pool.ready_transactions().collect();\n BlockRequest::Pending(pending_txs)\n }\n _ => {\n let number = self.backend.ensure_block_number(block_number).await?;\n BlockRequest::Number(number)\n }\n };\n Ok(block_request)\n }\n\n /// Increases the balance of an account.\n ///\n /// Handler for RPC call: `anvil_addBalance`\n pub async fn anvil_add_balance(&self, address: Address, balance: U256) -> Result<()> {\n node_info!(\"anvil_addBalance\");\n let current_balance = self.backend.get_balance(address, None).await?;\n self.backend.set_balance(address, current_balance.saturating_add(balance)).await?;\n Ok(())\n }\n\n /// Rollback the chain to a specific depth.\n ///\n /// e.g depth = 3\n /// A -> B -> C -> D -> E\n /// A -> B\n ///\n /// Depth specifies the height to rollback the chain back to. Depth must not exceed the current\n /// chain height, i.e. can't rollback past the genesis block.\n ///\n /// Handler for RPC call: `anvil_rollback`\n pub async fn anvil_rollback(&self, depth: Option) -> Result<()> {\n node_info!(\"anvil_rollback\");\n let depth = depth.unwrap_or(1);\n\n // Check reorg depth doesn't exceed current chain height\n let current_height = self.backend.best_number();\n let common_height = current_height.checked_sub(depth).ok_or(BlockchainError::RpcError(\n RpcError::invalid_params(format!(\n \"Rollback depth must not exceed current chain height: current height {current_height}, depth {depth}\"\n )),\n ))?;\n\n // Get the common ancestor block\n let common_block =\n self.backend.get_block(common_height).ok_or(BlockchainError::BlockNotFound)?;\n\n self.backend.rollback(common_block).await?;\n Ok(())\n }\n\n /// Estimates the gas usage of the `request` with the state.\n ///\n /// This will execute the transaction request and find the best gas limit via binary search.\n fn do_estimate_gas_with_state(\n &self,\n mut request: WithOtherFields,\n state: &dyn DatabaseRef,\n block_env: BlockEnv,\n ) -> Result {\n // If the request is a simple native token transfer we can optimize\n // We assume it's a transfer if we have no input data.\n let to = request.to.as_ref().and_then(TxKind::to);\n\n // check certain fields to see if the request could be a simple transfer\n let maybe_transfer = (request.input.input().is_none()\n || request.input.input().is_some_and(|data| data.is_empty()))\n && request.authorization_list.is_none()\n && request.access_list.is_none()\n && request.blob_versioned_hashes.is_none();\n\n if maybe_transfer\n && let Some(to) = to\n && let Ok(target_code) = self.backend.get_code_with_state(&state, *to)\n && target_code.as_ref().is_empty()\n {\n return Ok(MIN_TRANSACTION_GAS);\n }\n\n let fees = FeeDetails::new(\n request.gas_price,\n request.max_fee_per_gas,\n request.max_priority_fee_per_gas,\n request.max_fee_per_blob_gas,\n )?\n .or_zero_fees();\n\n // get the highest possible gas limit, either the request's set value or the currently\n // configured gas limit\n let mut highest_gas_limit = request.gas.map_or(block_env.gas_limit.into(), |g| g as u128);\n\n let gas_price = fees.gas_price.unwrap_or_default();\n // If we have non-zero gas price, cap gas limit by sender balance\n if gas_price > 0\n && let Some(from) = request.from\n {\n let mut available_funds = self.backend.get_balance_with_state(state, from)?;\n if let Some(value) = request.value {\n if value > available_funds {\n return Err(InvalidTransactionError::InsufficientFunds.into());\n }\n // safe: value < available_funds\n available_funds -= value;\n }\n // amount of gas the sender can afford with the `gas_price`\n let allowance = available_funds.checked_div(U256::from(gas_price)).unwrap_or_default();\n highest_gas_limit = std::cmp::min(highest_gas_limit, allowance.saturating_to());\n }\n\n let mut call_to_estimate = request.clone();\n call_to_estimate.gas = Some(highest_gas_limit as u64);\n\n // execute the call without writing to db\n let ethres =\n self.backend.call_with_state(&state, call_to_estimate, fees.clone(), block_env.clone());\n\n let gas_used = match ethres.try_into()? {\n GasEstimationCallResult::Success(gas) => Ok(gas),\n GasEstimationCallResult::OutOfGas => {\n Err(InvalidTransactionError::BasicOutOfGas(highest_gas_limit).into())\n }\n GasEstimationCallResult::Revert(output) => {\n Err(InvalidTransactionError::Revert(output).into())\n }\n GasEstimationCallResult::EvmError(err) => {\n warn!(target: \"node\", \"estimation failed due to {:?}\", err);\n Err(BlockchainError::EvmError(err))\n }\n }?;\n\n // at this point we know the call succeeded but want to find the _best_ (lowest) gas the\n // transaction succeeds with. we find this by doing a binary search over the\n // possible range NOTE: this is the gas the transaction used, which is less than the\n // transaction requires to succeed\n\n // Get the starting lowest gas needed depending on the transaction kind.\n let mut lowest_gas_limit = determine_base_gas_by_kind(&request);\n\n // pick a point that's close to the estimated gas\n let mut mid_gas_limit =\n std::cmp::min(gas_used * 3, (highest_gas_limit + lowest_gas_limit) / 2);\n\n // Binary search for the ideal gas limit\n while (highest_gas_limit - lowest_gas_limit) > 1 {\n request.gas = Some(mid_gas_limit as u64);\n let ethres = self.backend.call_with_state(\n &state,\n request.clone(),\n fees.clone(),\n block_env.clone(),\n );\n\n match ethres.try_into()? {\n GasEstimationCallResult::Success(_) => {\n // If the transaction succeeded, we can set a ceiling for the highest gas limit\n // at the current midpoint, as spending any more gas would\n // make no sense (as the TX would still succeed).\n highest_gas_limit = mid_gas_limit;\n }\n GasEstimationCallResult::OutOfGas\n | GasEstimationCallResult::Revert(_)\n | GasEstimationCallResult::EvmError(_) => {\n // If the transaction failed, we can set a floor for the lowest gas limit at the\n // current midpoint, as spending any less gas would make no\n // sense (as the TX would still revert due to lack of gas).\n //\n // We don't care about the reason here, as we known that transaction is correct\n // as it succeeded earlier\n lowest_gas_limit = mid_gas_limit;\n }\n };\n // new midpoint\n mid_gas_limit = (highest_gas_limit + lowest_gas_limit) / 2;\n }\n\n trace!(target : \"node\", \"Estimated Gas for call {:?}\", highest_gas_limit);\n\n Ok(highest_gas_limit)\n }\n\n /// Returns a new block event stream that yields Notifications when a new block was added\n pub fn new_block_notifications(&self) -> NewBlockNotifications {\n self.backend.new_block_notifications()\n }\n\n /// Executes the [EthRequest] and returns an RPC [ResponseResult].\n pub async fn execute(&self, request: EthRequest) -> ResponseResult {\n trace!(target: \"rpc::api\", \"executing eth request\");\n let response = match request.clone() {\n EthRequest::EthProtocolVersion(()) => self.protocol_version().to_rpc_result(),\n EthRequest::Web3ClientVersion(()) => self.client_version().to_rpc_result(),\n EthRequest::Web3Sha3(content) => self.sha3(content).to_rpc_result(),\n EthRequest::EthGetAccount(addr, block) => {\n self.get_account(addr, block).await.to_rpc_result()\n }\n EthRequest::EthGetAccountInfo(addr, block) => {\n self.get_account_info(addr, block).await.to_rpc_result()\n }\n EthRequest::EthGetBalance(addr, block) => {\n self.balance(addr, block).await.to_rpc_result()\n }\n EthRequest::EthGetTransactionByHash(hash) => {\n self.transaction_by_hash(hash).await.to_rpc_result()\n }\n EthRequest::EthSendTransaction(request) => {\n self.send_transaction(*request).await.to_rpc_result()\n }\n EthRequest::EthSendTransactionSync(request) => {\n self.send_transaction_sync(*request).await.to_rpc_result()\n }\n EthRequest::EthChainId(_) => self.eth_chain_id().to_rpc_result(),\n EthRequest::EthNetworkId(_) => self.network_id().to_rpc_result(),\n EthRequest::NetListening(_) => self.net_listening().to_rpc_result(),\n EthRequest::EthHashrate(()) => self.hashrate().to_rpc_result(),\n EthRequest::EthGasPrice(_) => self.eth_gas_price().to_rpc_result(),\n EthRequest::EthMaxPriorityFeePerGas(_) => {\n self.gas_max_priority_fee_per_gas().to_rpc_result()\n }\n EthRequest::EthBlobBaseFee(_) => self.blob_base_fee().to_rpc_result(),\n EthRequest::EthAccounts(_) => self.accounts().to_rpc_result(),\n EthRequest::EthBlockNumber(_) => self.block_number().to_rpc_result(),\n EthRequest::EthCoinbase(()) => self.author().to_rpc_result(),\n EthRequest::EthGetStorageAt(addr, slot, block) => {\n self.storage_at(addr, slot, block).await.to_rpc_result()\n }\n EthRequest::EthGetBlockByHash(hash, full) => {\n if full {\n self.block_by_hash_full(hash).await.to_rpc_result()\n } else {\n self.block_by_hash(hash).await.to_rpc_result()\n }\n }\n EthRequest::EthGetBlockByNumber(num, full) => {\n if full {\n self.block_by_number_full(num).await.to_rpc_result()\n } else {\n self.block_by_number(num).await.to_rpc_result()\n }\n }\n EthRequest::EthGetTransactionCount(addr, block) => {\n self.transaction_count(addr, block).await.to_rpc_result()\n }\n EthRequest::EthGetTransactionCountByHash(hash) => {\n self.block_transaction_count_by_hash(hash).await.to_rpc_result()\n }\n EthRequest::EthGetTransactionCountByNumber(num) => {\n self.block_transaction_count_by_number(num).await.to_rpc_result()\n }\n EthRequest::EthGetUnclesCountByHash(hash) => {\n self.block_uncles_count_by_hash(hash).await.to_rpc_result()\n }\n EthRequest::EthGetUnclesCountByNumber(num) => {\n self.block_uncles_count_by_number(num).await.to_rpc_result()\n }\n EthRequest::EthGetCodeAt(addr, block) => {\n self.get_code(addr, block).await.to_rpc_result()\n }\n EthRequest::EthGetProof(addr, keys, block) => {\n self.get_proof(addr, keys, block).await.to_rpc_result()\n }\n EthRequest::EthSign(addr, content) => self.sign(addr, content).await.to_rpc_result(),\n EthRequest::PersonalSign(content, addr) => {\n self.sign(addr, content).await.to_rpc_result()\n }\n EthRequest::EthSignTransaction(request) => {\n self.sign_transaction(*request).await.to_rpc_result()\n }\n EthRequest::EthSignTypedData(addr, data) => {\n self.sign_typed_data(addr, data).await.to_rpc_result()\n }\n EthRequest::EthSignTypedDataV3(addr, data) => {\n self.sign_typed_data_v3(addr, data).await.to_rpc_result()\n }\n EthRequest::EthSignTypedDataV4(addr, data) => {\n self.sign_typed_data_v4(addr, &data).await.to_rpc_result()\n }\n EthRequest::EthSendRawTransaction(tx) => {\n self.send_raw_transaction(tx).await.to_rpc_result()\n }\n EthRequest::EthSendRawTransactionSync(tx) => {\n self.send_raw_transaction_sync(tx).await.to_rpc_result()\n }\n EthRequest::EthCall(call, block, state_override, block_overrides) => self\n .call(call, block, EvmOverrides::new(state_override, block_overrides))\n .await\n .to_rpc_result(),\n EthRequest::EthSimulateV1(simulation, block) => {\n self.simulate_v1(simulation, block).await.to_rpc_result()\n }\n EthRequest::EthCreateAccessList(call, block) => {\n self.create_access_list(call, block).await.to_rpc_result()\n }\n EthRequest::EthEstimateGas(call, block, state_override, block_overrides) => self\n .estimate_gas(call, block, EvmOverrides::new(state_override, block_overrides))\n .await\n .to_rpc_result(),\n EthRequest::EthFillTransaction(request) => {\n self.fill_transaction(request).await.to_rpc_result()\n }\n EthRequest::EthGetRawTransactionByHash(hash) => {\n self.raw_transaction(hash).await.to_rpc_result()\n }\n EthRequest::GetBlobByHash(hash) => {\n self.anvil_get_blob_by_versioned_hash(hash).to_rpc_result()\n }\n EthRequest::GetBlobByTransactionHash(hash) => {\n self.anvil_get_blob_by_tx_hash(hash).to_rpc_result()\n }\n EthRequest::GetGenesisTime(()) => self.anvil_get_genesis_time().to_rpc_result(),\n EthRequest::EthGetRawTransactionByBlockHashAndIndex(hash, index) => {\n self.raw_transaction_by_block_hash_and_index(hash, index).await.to_rpc_result()\n }\n EthRequest::EthGetRawTransactionByBlockNumberAndIndex(num, index) => {\n self.raw_transaction_by_block_number_and_index(num, index).await.to_rpc_result()\n }\n EthRequest::EthGetTransactionByBlockHashAndIndex(hash, index) => {\n self.transaction_by_block_hash_and_index(hash, index).await.to_rpc_result()\n }\n EthRequest::EthGetTransactionByBlockNumberAndIndex(num, index) => {\n self.transaction_by_block_number_and_index(num, index).await.to_rpc_result()\n }\n EthRequest::EthGetTransactionReceipt(tx) => {\n self.transaction_receipt(tx).await.to_rpc_result()\n }\n EthRequest::EthGetBlockReceipts(number) => {\n self.block_receipts(number).await.to_rpc_result()\n }\n EthRequest::EthGetUncleByBlockHashAndIndex(hash, index) => {\n self.uncle_by_block_hash_and_index(hash, index).await.to_rpc_result()\n }\n EthRequest::EthGetUncleByBlockNumberAndIndex(num, index) => {\n self.uncle_by_block_number_and_index(num, index).await.to_rpc_result()\n }\n EthRequest::EthGetLogs(filter) => self.logs(filter).await.to_rpc_result(),\n EthRequest::EthGetWork(_) => self.work().to_rpc_result(),\n EthRequest::EthSyncing(_) => self.syncing().to_rpc_result(),\n EthRequest::EthConfig(_) => self.config().to_rpc_result(),\n EthRequest::EthSubmitWork(nonce, pow, digest) => {\n self.submit_work(nonce, pow, digest).to_rpc_result()\n }\n EthRequest::EthSubmitHashRate(rate, id) => {\n self.submit_hashrate(rate, id).to_rpc_result()\n }\n EthRequest::EthFeeHistory(count, newest, reward_percentiles) => {\n self.fee_history(count, newest, reward_percentiles).await.to_rpc_result()\n }\n // non eth-standard rpc calls\n EthRequest::DebugGetRawTransaction(hash) => {\n self.raw_transaction(hash).await.to_rpc_result()\n }\n // non eth-standard rpc calls\n EthRequest::DebugTraceTransaction(tx, opts) => {\n self.debug_trace_transaction(tx, opts).await.to_rpc_result()\n }\n // non eth-standard rpc calls\n EthRequest::DebugTraceCall(tx, block, opts) => {\n self.debug_trace_call(tx, block, opts).await.to_rpc_result()\n }\n EthRequest::DebugCodeByHash(hash, block) => {\n self.debug_code_by_hash(hash, block).await.to_rpc_result()\n }\n EthRequest::DebugDbGet(key) => self.debug_db_get(key).await.to_rpc_result(),\n EthRequest::TraceTransaction(tx) => self.trace_transaction(tx).await.to_rpc_result(),\n EthRequest::TraceBlock(block) => self.trace_block(block).await.to_rpc_result(),\n EthRequest::TraceFilter(filter) => self.trace_filter(filter).await.to_rpc_result(),\n EthRequest::TraceReplayBlockTransactions(block, trace_types) => {\n self.trace_replay_block_transactions(block, trace_types).await.to_rpc_result()\n }\n EthRequest::ImpersonateAccount(addr) => {\n self.anvil_impersonate_account(addr).await.to_rpc_result()\n }\n EthRequest::StopImpersonatingAccount(addr) => {\n self.anvil_stop_impersonating_account(addr).await.to_rpc_result()\n }\n EthRequest::AutoImpersonateAccount(enable) => {\n self.anvil_auto_impersonate_account(enable).await.to_rpc_result()\n }\n EthRequest::ImpersonateSignature(signature, address) => {\n self.anvil_impersonate_signature(signature, address).await.to_rpc_result()\n }\n EthRequest::GetAutoMine(()) => self.anvil_get_auto_mine().to_rpc_result(),\n EthRequest::Mine(blocks, interval) => {\n self.anvil_mine(blocks, interval).await.to_rpc_result()\n }\n EthRequest::SetAutomine(enabled) => {\n self.anvil_set_auto_mine(enabled).await.to_rpc_result()\n }\n EthRequest::SetIntervalMining(interval) => {\n self.anvil_set_interval_mining(interval).to_rpc_result()\n }\n EthRequest::GetIntervalMining(()) => self.anvil_get_interval_mining().to_rpc_result(),\n EthRequest::DropTransaction(tx) => {\n self.anvil_drop_transaction(tx).await.to_rpc_result()\n }\n EthRequest::DropAllTransactions() => {\n self.anvil_drop_all_transactions().await.to_rpc_result()\n }\n EthRequest::Reset(fork) => {\n self.anvil_reset(fork.and_then(|p| p.params)).await.to_rpc_result()\n }\n EthRequest::SetBalance(addr, val) => {\n self.anvil_set_balance(addr, val).await.to_rpc_result()\n }\n EthRequest::AddBalance(addr, val) => {\n self.anvil_add_balance(addr, val).await.to_rpc_result()\n }\n EthRequest::DealERC20(addr, token_addr, val) => {\n self.anvil_deal_erc20(addr, token_addr, val).await.to_rpc_result()\n }\n EthRequest::SetERC20Allowance(owner, spender, token_addr, val) => self\n .anvil_set_erc20_allowance(owner, spender, token_addr, val)\n .await\n .to_rpc_result(),\n EthRequest::SetCode(addr, code) => {\n self.anvil_set_code(addr, code).await.to_rpc_result()\n }\n EthRequest::SetNonce(addr, nonce) => {\n self.anvil_set_nonce(addr, nonce).await.to_rpc_result()\n }\n EthRequest::SetStorageAt(addr, slot, val) => {\n self.anvil_set_storage_at(addr, slot, val).await.to_rpc_result()\n }\n EthRequest::SetCoinbase(addr) => self.anvil_set_coinbase(addr).await.to_rpc_result(),\n EthRequest::SetChainId(id) => self.anvil_set_chain_id(id).await.to_rpc_result(),\n EthRequest::SetLogging(log) => self.anvil_set_logging(log).await.to_rpc_result(),\n EthRequest::SetMinGasPrice(gas) => {\n self.anvil_set_min_gas_price(gas).await.to_rpc_result()\n }\n EthRequest::SetNextBlockBaseFeePerGas(gas) => {\n self.anvil_set_next_block_base_fee_per_gas(gas).await.to_rpc_result()\n }\n EthRequest::DumpState(preserve_historical_states) => self\n .anvil_dump_state(preserve_historical_states.and_then(|s| s.params))\n .await\n .to_rpc_result(),\n EthRequest::LoadState(buf) => self.anvil_load_state(buf).await.to_rpc_result(),\n EthRequest::NodeInfo(_) => self.anvil_node_info().await.to_rpc_result(),\n EthRequest::AnvilMetadata(_) => self.anvil_metadata().await.to_rpc_result(),\n EthRequest::EvmSnapshot(_) => self.evm_snapshot().await.to_rpc_result(),\n EthRequest::EvmRevert(id) => self.evm_revert(id).await.to_rpc_result(),\n EthRequest::EvmIncreaseTime(time) => self.evm_increase_time(time).await.to_rpc_result(),\n EthRequest::EvmSetNextBlockTimeStamp(time) => {\n if time >= U256::from(u64::MAX) {\n return ResponseResult::Error(RpcError::invalid_params(\n \"The timestamp is too big\",\n ));\n }\n let time = time.to::();\n self.evm_set_next_block_timestamp(time).to_rpc_result()\n }\n EthRequest::EvmSetTime(timestamp) => {\n if timestamp >= U256::from(u64::MAX) {\n return ResponseResult::Error(RpcError::invalid_params(\n \"The timestamp is too big\",\n ));\n }\n let time = timestamp.to::();\n self.evm_set_time(time).to_rpc_result()\n }\n EthRequest::EvmSetBlockGasLimit(gas_limit) => {\n self.evm_set_block_gas_limit(gas_limit).to_rpc_result()\n }\n EthRequest::EvmSetBlockTimeStampInterval(time) => {\n self.evm_set_block_timestamp_interval(time).to_rpc_result()\n }\n EthRequest::EvmRemoveBlockTimeStampInterval(()) => {\n self.evm_remove_block_timestamp_interval().to_rpc_result()\n }\n EthRequest::EvmMine(mine) => {\n self.evm_mine(mine.and_then(|p| p.params)).await.to_rpc_result()\n }\n EthRequest::EvmMineDetailed(mine) => {\n self.evm_mine_detailed(mine.and_then(|p| p.params)).await.to_rpc_result()\n }\n EthRequest::SetRpcUrl(url) => self.anvil_set_rpc_url(url).to_rpc_result(),\n EthRequest::EthSendUnsignedTransaction(tx) => {\n self.eth_send_unsigned_transaction(*tx).await.to_rpc_result()\n }\n EthRequest::EthNewFilter(filter) => self.new_filter(filter).await.to_rpc_result(),\n EthRequest::EthGetFilterChanges(id) => self.get_filter_changes(&id).await,\n EthRequest::EthNewBlockFilter(_) => self.new_block_filter().await.to_rpc_result(),\n EthRequest::EthNewPendingTransactionFilter(_) => {\n self.new_pending_transaction_filter().await.to_rpc_result()\n }\n EthRequest::EthGetFilterLogs(id) => self.get_filter_logs(&id).await.to_rpc_result(),\n EthRequest::EthUninstallFilter(id) => self.uninstall_filter(&id).await.to_rpc_result(),\n EthRequest::TxPoolStatus(_) => self.txpool_status().await.to_rpc_result(),\n EthRequest::TxPoolInspect(_) => self.txpool_inspect().await.to_rpc_result(),\n EthRequest::TxPoolContent(_) => self.txpool_content().await.to_rpc_result(),\n EthRequest::ErigonGetHeaderByNumber(num) => {\n self.erigon_get_header_by_number(num).await.to_rpc_result()\n }\n EthRequest::OtsGetApiLevel(_) => self.ots_get_api_level().await.to_rpc_result(),\n EthRequest::OtsGetInternalOperations(hash) => {\n self.ots_get_internal_operations(hash).await.to_rpc_result()\n }\n EthRequest::OtsHasCode(addr, num) => self.ots_has_code(addr, num).await.to_rpc_result(),\n EthRequest::OtsTraceTransaction(hash) => {\n self.ots_trace_transaction(hash).await.to_rpc_result()\n }\n EthRequest::OtsGetTransactionError(hash) => {\n self.ots_get_transaction_error(hash).await.to_rpc_result()\n }\n EthRequest::OtsGetBlockDetails(num) => {\n self.ots_get_block_details(num).await.to_rpc_result()\n }\n EthRequest::OtsGetBlockDetailsByHash(hash) => {\n self.ots_get_block_details_by_hash(hash).await.to_rpc_result()\n }\n EthRequest::OtsGetBlockTransactions(num, page, page_size) => {\n self.ots_get_block_transactions(num, page, page_size).await.to_rpc_result()\n }\n EthRequest::OtsSearchTransactionsBefore(address, num, page_size) => {\n self.ots_search_transactions_before(address, num, page_size).await.to_rpc_result()\n }\n EthRequest::OtsSearchTransactionsAfter(address, num, page_size) => {\n self.ots_search_transactions_after(address, num, page_size).await.to_rpc_result()\n }\n EthRequest::OtsGetTransactionBySenderAndNonce(address, nonce) => {\n self.ots_get_transaction_by_sender_and_nonce(address, nonce).await.to_rpc_result()\n }\n EthRequest::EthGetTransactionBySenderAndNonce(sender, nonce) => {\n self.transaction_by_sender_and_nonce(sender, nonce).await.to_rpc_result()\n }\n EthRequest::OtsGetContractCreator(address) => {\n self.ots_get_contract_creator(address).await.to_rpc_result()\n }\n EthRequest::RemovePoolTransactions(address) => {\n self.anvil_remove_pool_transactions(address).await.to_rpc_result()\n }\n EthRequest::Reorg(reorg_options) => {\n self.anvil_reorg(reorg_options).await.to_rpc_result()\n }\n EthRequest::Rollback(depth) => self.anvil_rollback(depth).await.to_rpc_result(),\n };\n\n if let ResponseResult::Error(err) = &response {\n node_info!(\"\\nRPC request failed:\");\n node_info!(\" Request: {:?}\", request);\n node_info!(\" Error: {}\\n\", err);\n }\n\n response\n }\n\n fn sign_request(&self, from: &Address, typed_tx: FoundryTypedTx) -> Result {\n match typed_tx {\n FoundryTypedTx::Deposit(_) => return Ok(build_impersonated(typed_tx)),\n _ => {\n for signer in self.signers.iter() {\n if signer.accounts().contains(from) {\n return signer.sign_transaction_from(from, typed_tx);\n }\n }\n }\n }\n Err(BlockchainError::NoSignerAvailable)\n }\n\n async fn inner_raw_transaction(&self, hash: B256) -> Result> {\n match self.pool.get_transaction(hash) {\n Some(tx) => Ok(Some(tx.transaction.encoded_2718().into())),\n None => match self.backend.transaction_by_hash(hash).await? {\n Some(tx) => Ok(Some(tx.as_ref().encoded_2718().into())),\n None => Ok(None),\n },\n }\n }\n\n /// Returns the current client version.\n ///\n /// Handler for ETH RPC call: `web3_clientVersion`\n pub fn client_version(&self) -> Result {\n node_info!(\"web3_clientVersion\");\n Ok(CLIENT_VERSION.to_string())\n }\n\n /// Returns Keccak-256 (not the standardized SHA3-256) of the given data.\n ///\n /// Handler for ETH RPC call: `web3_sha3`\n pub fn sha3(&self, bytes: Bytes) -> Result {\n node_info!(\"web3_sha3\");\n let hash = alloy_primitives::keccak256(bytes.as_ref());\n Ok(alloy_primitives::hex::encode_prefixed(&hash[..]))\n }\n\n /// Returns protocol version encoded as a string (quotes are necessary).\n ///\n /// Handler for ETH RPC call: `eth_protocolVersion`\n pub fn protocol_version(&self) -> Result {\n node_info!(\"eth_protocolVersion\");\n Ok(1)\n }\n\n /// Returns the number of hashes per second that the node is mining with.\n ///\n /// Handler for ETH RPC call: `eth_hashrate`\n pub fn hashrate(&self) -> Result {\n node_info!(\"eth_hashrate\");\n Ok(U256::ZERO)\n }\n\n /// Returns the client coinbase address.\n ///\n /// Handler for ETH RPC call: `eth_coinbase`\n pub fn author(&self) -> Result
{\n node_info!(\"eth_coinbase\");\n Ok(self.backend.coinbase())\n }\n\n /// Returns true if client is actively mining new blocks.\n ///\n /// Handler for ETH RPC call: `eth_mining`\n pub fn is_mining(&self) -> Result {\n node_info!(\"eth_mining\");\n Ok(self.is_mining)\n }\n\n /// Returns the chain ID used for transaction signing at the\n /// current best block. None is returned if not\n /// available.\n ///\n /// Handler for ETH RPC call: `eth_chainId`\n pub fn eth_chain_id(&self) -> Result> {\n node_info!(\"eth_chainId\");\n Ok(Some(self.backend.chain_id().to::()))\n }\n\n /// Returns the same as `chain_id`\n ///\n /// Handler for ETH RPC call: `eth_networkId`\n pub fn network_id(&self) -> Result> {\n node_info!(\"eth_networkId\");\n let chain_id = self.backend.chain_id().to::();\n Ok(Some(format!(\"{chain_id}\")))\n }\n\n /// Returns true if client is actively listening for network connections.\n ///\n /// Handler for ETH RPC call: `net_listening`\n pub fn net_listening(&self) -> Result {\n node_info!(\"net_listening\");\n Ok(self.net_listening)\n }\n\n /// Returns the current gas price\n fn eth_gas_price(&self) -> Result {\n node_info!(\"eth_gasPrice\");\n Ok(U256::from(self.gas_price()))\n }\n\n /// Returns the excess blob gas and current blob gas price\n pub fn excess_blob_gas_and_price(&self) -> Result> {\n Ok(self.backend.excess_blob_gas_and_price())\n }\n\n /// Returns a fee per gas that is an estimate of how much you can pay as a priority fee, or\n /// 'tip', to get a transaction included in the current block.\n ///\n /// Handler for ETH RPC call: `eth_maxPriorityFeePerGas`\n pub fn gas_max_priority_fee_per_gas(&self) -> Result {\n self.max_priority_fee_per_gas()\n }\n\n /// Returns the base fee per blob required to send a EIP-4844 tx.\n ///\n /// Handler for ETH RPC call: `eth_blobBaseFee`\n pub fn blob_base_fee(&self) -> Result {\n Ok(U256::from(self.backend.fees().base_fee_per_blob_gas()))\n }\n\n /// Returns the block gas limit\n pub fn gas_limit(&self) -> U256 {\n U256::from(self.backend.gas_limit())\n }\n\n /// Returns the accounts list\n ///\n /// Handler for ETH RPC call: `eth_accounts`\n pub fn accounts(&self) -> Result> {\n node_info!(\"eth_accounts\");\n let mut unique = HashSet::new();\n let mut accounts: Vec
= Vec::new();\n for signer in self.signers.iter() {\n accounts.extend(signer.accounts().into_iter().filter(|acc| unique.insert(*acc)));\n }\n accounts.extend(\n self.backend\n .cheats()\n .impersonated_accounts()\n .into_iter()\n .filter(|acc| unique.insert(*acc)),\n );\n Ok(accounts.into_iter().collect())\n }\n\n /// Returns the number of most recent block.\n ///\n /// Handler for ETH RPC call: `eth_blockNumber`\n pub fn block_number(&self) -> Result {\n node_info!(\"eth_blockNumber\");\n Ok(U256::from(self.backend.best_number()))\n }\n\n /// Returns balance of the given account.\n ///\n /// Handler for ETH RPC call: `eth_getBalance`\n pub async fn balance(&self, address: Address, block_number: Option) -> Result {\n node_info!(\"eth_getBalance\");\n let block_request = self.block_request(block_number).await?;\n\n // check if the number predates the fork, if in fork mode\n if let BlockRequest::Number(number) = block_request\n && let Some(fork) = self.get_fork()\n && fork.predates_fork(number)\n {\n return Ok(fork.get_balance(address, number).await?);\n }\n\n self.backend.get_balance(address, Some(block_request)).await\n }\n\n /// Returns the ethereum account.\n ///\n /// Handler for ETH RPC call: `eth_getAccount`\n pub async fn get_account(\n &self,\n address: Address,\n block_number: Option,\n ) -> Result {\n node_info!(\"eth_getAccount\");\n let block_request = self.block_request(block_number).await?;\n\n // check if the number predates the fork, if in fork mode\n if let BlockRequest::Number(number) = block_request\n && let Some(fork) = self.get_fork()\n && fork.predates_fork(number)\n {\n return Ok(fork.get_account(address, number).await?);\n }\n\n self.backend.get_account_at_block(address, Some(block_request)).await\n }\n\n /// Returns the account information including balance, nonce, code and storage\n ///\n /// Note: This isn't support by all providers\n pub async fn get_account_info(\n &self,\n address: Address,\n block_number: Option,\n ) -> Result {\n node_info!(\"eth_getAccountInfo\");\n\n if let Some(fork) = self.get_fork() {\n let block_request = self.block_request(block_number).await?;\n // check if the number predates the fork, if in fork mode\n if let BlockRequest::Number(number) = block_request {\n trace!(target: \"node\", \"get_account_info: fork block {}, requested block {number}\", fork.block_number());\n return if fork.predates_fork(number) {\n // if this predates the fork we need to fetch balance, nonce, code individually\n // because the provider might not support this endpoint\n let balance = fork.get_balance(address, number).map_err(BlockchainError::from);\n let code = fork.get_code(address, number).map_err(BlockchainError::from);\n let nonce = self.get_transaction_count(address, Some(number.into()));\n let (balance, code, nonce) = try_join!(balance, code, nonce)?;\n\n Ok(alloy_rpc_types::eth::AccountInfo { balance, nonce, code })\n } else {\n // Anvil node is at the same block or higher than the fork block,\n // return account info from backend to reflect current state.\n let account_info = self.backend.get_account(address).await?;\n let code = self.backend.get_code(address, Some(block_request)).await?;\n Ok(alloy_rpc_types::eth::AccountInfo {\n balance: account_info.balance,\n nonce: account_info.nonce,\n code,\n })\n };\n }\n }\n\n let account = self.get_account(address, block_number);\n let code = self.get_code(address, block_number);\n let (account, code) = try_join!(account, code)?;\n Ok(alloy_rpc_types::eth::AccountInfo {\n balance: account.balance,\n nonce: account.nonce,\n code,\n })\n }\n /// Returns content of the storage at given address.\n ///\n /// Handler for ETH RPC call: `eth_getStorageAt`\n pub async fn storage_at(\n &self,\n address: Address,\n index: U256,\n block_number: Option,\n ) -> Result {\n node_info!(\"eth_getStorageAt\");\n let block_request = self.block_request(block_number).await?;\n\n // check if the number predates the fork, if in fork mode\n if let BlockRequest::Number(number) = block_request\n && let Some(fork) = self.get_fork()\n && fork.predates_fork(number)\n {\n return Ok(B256::from(\n fork.storage_at(address, index, Some(BlockNumber::Number(number))).await?,\n ));\n }\n\n self.backend.storage_at(address, index, Some(block_request)).await\n }\n\n /// Returns block with given hash.\n ///\n /// Handler for ETH RPC call: `eth_getBlockByHash`\n pub async fn block_by_hash(&self, hash: B256) -> Result> {\n node_info!(\"eth_getBlockByHash\");\n self.backend.block_by_hash(hash).await\n }\n\n /// Returns a _full_ block with given hash.\n ///\n /// Handler for ETH RPC call: `eth_getBlockByHash`\n pub async fn block_by_hash_full(&self, hash: B256) -> Result> {\n node_info!(\"eth_getBlockByHash\");\n self.backend.block_by_hash_full(hash).await\n }\n\n /// Returns block with given number.\n ///\n /// Handler for ETH RPC call: `eth_getBlockByNumber`\n pub async fn block_by_number(&self, number: BlockNumber) -> Result> {\n node_info!(\"eth_getBlockByNumber\");\n if number == BlockNumber::Pending {\n return Ok(Some(self.pending_block().await));\n }\n\n self.backend.block_by_number(number).await\n }\n\n /// Returns a _full_ block with given number\n ///\n /// Handler for ETH RPC call: `eth_getBlockByNumber`\n pub async fn block_by_number_full(&self, number: BlockNumber) -> Result> {\n node_info!(\"eth_getBlockByNumber\");\n if number == BlockNumber::Pending {\n return Ok(self.pending_block_full().await);\n }\n self.backend.block_by_number_full(number).await\n }\n\n /// Returns the number of transactions sent from given address at given time (block number).\n ///\n /// Also checks the pending transactions if `block_number` is\n /// `BlockId::Number(BlockNumber::Pending)`\n ///\n /// Handler for ETH RPC call: `eth_getTransactionCount`\n pub async fn transaction_count(\n &self,\n address: Address,\n block_number: Option,\n ) -> Result {\n node_info!(\"eth_getTransactionCount\");\n self.get_transaction_count(address, block_number).await.map(U256::from)\n }\n\n /// Returns the number of transactions in a block with given hash.\n ///\n /// Handler for ETH RPC call: `eth_getBlockTransactionCountByHash`\n pub async fn block_transaction_count_by_hash(&self, hash: B256) -> Result> {\n node_info!(\"eth_getBlockTransactionCountByHash\");\n let block = self.backend.block_by_hash(hash).await?;\n let txs = block.map(|b| match b.transactions() {\n BlockTransactions::Full(txs) => U256::from(txs.len()),\n BlockTransactions::Hashes(txs) => U256::from(txs.len()),\n BlockTransactions::Uncle => U256::from(0),\n });\n Ok(txs)\n }\n\n /// Returns the number of transactions in a block with given block number.\n ///\n /// Handler for ETH RPC call: `eth_getBlockTransactionCountByNumber`\n pub async fn block_transaction_count_by_number(\n &self,\n block_number: BlockNumber,\n ) -> Result> {\n node_info!(\"eth_getBlockTransactionCountByNumber\");\n let block_request = self.block_request(Some(block_number.into())).await?;\n if let BlockRequest::Pending(txs) = block_request {\n let block = self.backend.pending_block(txs).await;\n return Ok(Some(U256::from(block.block.body.transactions.len())));\n }\n let block = self.backend.block_by_number(block_number).await?;\n let txs = block.map(|b| match b.transactions() {\n BlockTransactions::Full(txs) => U256::from(txs.len()),\n BlockTransactions::Hashes(txs) => U256::from(txs.len()),\n BlockTransactions::Uncle => U256::from(0),\n });\n Ok(txs)\n }\n\n /// Returns the number of uncles in a block with given hash.\n ///\n /// Handler for ETH RPC call: `eth_getUncleCountByBlockHash`\n pub async fn block_uncles_count_by_hash(&self, hash: B256) -> Result {\n node_info!(\"eth_getUncleCountByBlockHash\");\n let block =\n self.backend.block_by_hash(hash).await?.ok_or(BlockchainError::BlockNotFound)?;\n Ok(U256::from(block.uncles.len()))\n }\n\n /// Returns the number of uncles in a block with given block number.\n ///\n /// Handler for ETH RPC call: `eth_getUncleCountByBlockNumber`\n pub async fn block_uncles_count_by_number(&self, block_number: BlockNumber) -> Result {\n node_info!(\"eth_getUncleCountByBlockNumber\");\n let block = self\n .backend\n .block_by_number(block_number)\n .await?\n .ok_or(BlockchainError::BlockNotFound)?;\n Ok(U256::from(block.uncles.len()))\n }\n\n /// Returns the code at given address at given time (block number).\n ///\n /// Handler for ETH RPC call: `eth_getCode`\n pub async fn get_code(&self, address: Address, block_number: Option) -> Result {\n node_info!(\"eth_getCode\");\n let block_request = self.block_request(block_number).await?;\n // check if the number predates the fork, if in fork mode\n if let BlockRequest::Number(number) = block_request\n && let Some(fork) = self.get_fork()\n && fork.predates_fork(number)\n {\n return Ok(fork.get_code(address, number).await?);\n }\n self.backend.get_code(address, Some(block_request)).await\n }\n\n /// Returns the account and storage values of the specified account including the Merkle-proof.\n /// This call can be used to verify that the data you are pulling from is not tampered with.\n ///\n /// Handler for ETH RPC call: `eth_getProof`\n pub async fn get_proof(\n &self,\n address: Address,\n keys: Vec,\n block_number: Option,\n ) -> Result {\n node_info!(\"eth_getProof\");\n let block_request = self.block_request(block_number).await?;\n\n // If we're in forking mode, or still on the forked block (no blocks mined yet) then we can\n // delegate the call.\n if let BlockRequest::Number(number) = block_request\n && let Some(fork) = self.get_fork()\n && fork.predates_fork_inclusive(number)\n {\n return Ok(fork.get_proof(address, keys, Some(number.into())).await?);\n }\n\n let proof = self.backend.prove_account_at(address, keys, Some(block_request)).await?;\n Ok(proof)\n }\n\n /// Signs data via [EIP-712](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-712.md).\n ///\n /// Handler for ETH RPC call: `eth_signTypedData`\n pub async fn sign_typed_data(\n &self,\n _address: Address,\n _data: serde_json::Value,\n ) -> Result {\n node_info!(\"eth_signTypedData\");\n Err(BlockchainError::RpcUnimplemented)\n }\n\n /// Signs data via [EIP-712](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-712.md).\n ///\n /// Handler for ETH RPC call: `eth_signTypedData_v3`\n pub async fn sign_typed_data_v3(\n &self,\n _address: Address,\n _data: serde_json::Value,\n ) -> Result {\n node_info!(\"eth_signTypedData_v3\");\n Err(BlockchainError::RpcUnimplemented)\n }\n\n /// Signs data via [EIP-712](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-712.md), and includes full support of arrays and recursive data structures.\n ///\n /// Handler for ETH RPC call: `eth_signTypedData_v4`\n pub async fn sign_typed_data_v4(&self, address: Address, data: &TypedData) -> Result {\n node_info!(\"eth_signTypedData_v4\");\n let signer = self.get_signer(address).ok_or(BlockchainError::NoSignerAvailable)?;\n let signature = signer.sign_typed_data(address, data).await?;\n let signature = alloy_primitives::hex::encode(signature.as_bytes());\n Ok(format!(\"0x{signature}\"))\n }\n\n /// The sign method calculates an Ethereum specific signature\n ///\n /// Handler for ETH RPC call: `eth_sign`\n pub async fn sign(&self, address: Address, content: impl AsRef<[u8]>) -> Result {\n node_info!(\"eth_sign\");\n let signer = self.get_signer(address).ok_or(BlockchainError::NoSignerAvailable)?;\n let signature =\n alloy_primitives::hex::encode(signer.sign(address, content.as_ref()).await?.as_bytes());\n Ok(format!(\"0x{signature}\"))\n }\n\n /// Signs a transaction\n ///\n /// Handler for ETH RPC call: `eth_signTransaction`\n pub async fn sign_transaction(\n &self,\n request: WithOtherFields,\n ) -> Result {\n node_info!(\"eth_signTransaction\");\n\n let from = request.from.map(Ok).unwrap_or_else(|| {\n self.accounts()?.first().copied().ok_or(BlockchainError::NoSignerAvailable)\n })?;\n\n let (nonce, _) = self.request_nonce(&request, from).await?;\n\n let request = self.build_tx_request(request, nonce).await?;\n\n let signed_transaction = self.sign_request(&from, request)?.encoded_2718();\n Ok(alloy_primitives::hex::encode_prefixed(signed_transaction))\n }\n\n /// Sends a transaction\n ///\n /// Handler for ETH RPC call: `eth_sendTransaction`\n pub async fn send_transaction(\n &self,\n request: WithOtherFields,\n ) -> Result {\n node_info!(\"eth_sendTransaction\");\n\n let from = request.from.map(Ok).unwrap_or_else(|| {\n self.accounts()?.first().copied().ok_or(BlockchainError::NoSignerAvailable)\n })?;\n let (nonce, on_chain_nonce) = self.request_nonce(&request, from).await?;\n\n let typed_tx = self.build_tx_request(request, nonce).await?;\n\n // if the sender is currently impersonated we need to \"bypass\" signing\n let pending_transaction = if self.is_impersonated(from) {\n let transaction = sign::build_impersonated(typed_tx);\n self.ensure_typed_transaction_supported(&transaction)?;\n trace!(target : \"node\", ?from, \"eth_sendTransaction: impersonating\");\n PendingTransaction::with_impersonated(transaction, from)\n } else {\n let transaction = self.sign_request(&from, typed_tx)?;\n self.ensure_typed_transaction_supported(&transaction)?;\n PendingTransaction::new(transaction)?\n };\n // pre-validate\n self.backend.validate_pool_transaction(&pending_transaction).await?;\n\n let requires = required_marker(nonce, on_chain_nonce, from);\n let provides = vec![to_marker(nonce, from)];\n debug_assert!(requires != provides);\n\n self.add_pending_transaction(pending_transaction, requires, provides)\n }\n\n /// Waits for a transaction to be included in a block and returns its receipt (no timeout).\n async fn await_transaction_inclusion(&self, hash: TxHash) -> Result {\n let mut stream = self.new_block_notifications();\n // Check if the transaction is already included before listening for new blocks.\n if let Some(receipt) = self.backend.transaction_receipt(hash).await? {\n return Ok(receipt);\n }\n while let Some(notification) = stream.next().await {\n if let Some(block) = self.backend.get_block_by_hash(notification.hash)\n && block.body.transactions.iter().any(|tx| tx.hash() == hash)\n && let Some(receipt) = self.backend.transaction_receipt(hash).await?\n {\n return Ok(receipt);\n }\n }\n\n Err(BlockchainError::Message(\"Failed to await transaction inclusion\".to_string()))\n }\n\n /// Waits for a transaction to be included in a block and returns its receipt, with timeout.\n async fn check_transaction_inclusion(&self, hash: TxHash) -> Result {\n const TIMEOUT_DURATION: Duration = Duration::from_secs(30);\n tokio::time::timeout(TIMEOUT_DURATION, self.await_transaction_inclusion(hash))\n .await\n .unwrap_or_else(|_elapsed| {\n Err(BlockchainError::TransactionConfirmationTimeout {\n hash,\n duration: TIMEOUT_DURATION,\n })\n })\n }\n\n /// Sends a transaction and waits for receipt\n ///\n /// Handler for ETH RPC call: `eth_sendTransactionSync`\n pub async fn send_transaction_sync(\n &self,\n request: WithOtherFields,\n ) -> Result {\n node_info!(\"eth_sendTransactionSync\");\n let hash = self.send_transaction(request).await?;\n\n let receipt = self.check_transaction_inclusion(hash).await?;\n\n Ok(receipt)\n }\n\n /// Sends signed transaction, returning its hash.\n ///\n /// Handler for ETH RPC call: `eth_sendRawTransaction`\n pub async fn send_raw_transaction(&self, tx: Bytes) -> Result {\n node_info!(\"eth_sendRawTransaction\");\n let mut data = tx.as_ref();\n if data.is_empty() {\n return Err(BlockchainError::EmptyRawTransactionData);\n }\n\n let transaction = FoundryTxEnvelope::decode_2718(&mut data)\n .map_err(|_| BlockchainError::FailedToDecodeSignedTransaction)?;\n\n self.ensure_typed_transaction_supported(&transaction)?;\n\n let pending_transaction = PendingTransaction::new(transaction)?;\n\n // pre-validate\n self.backend.validate_pool_transaction(&pending_transaction).await?;\n\n let on_chain_nonce = self.backend.current_nonce(*pending_transaction.sender()).await?;\n let from = *pending_transaction.sender();\n let nonce = pending_transaction.transaction.nonce();\n let requires = required_marker(nonce, on_chain_nonce, from);\n\n let priority = self.transaction_priority(&pending_transaction.transaction);\n let pool_transaction = PoolTransaction {\n requires,\n provides: vec![to_marker(nonce, *pending_transaction.sender())],\n pending_transaction,\n priority,\n };\n\n let tx = self.pool.add_transaction(pool_transaction)?;\n trace!(target: \"node\", \"Added transaction: [{:?}] sender={:?}\", tx.hash(), from);\n Ok(*tx.hash())\n }\n\n /// Sends signed transaction, returning its receipt.\n ///\n /// Handler for ETH RPC call: `eth_sendRawTransactionSync`\n pub async fn send_raw_transaction_sync(&self, tx: Bytes) -> Result {\n node_info!(\"eth_sendRawTransactionSync\");\n\n let hash = self.send_raw_transaction(tx).await?;\n let receipt = self.check_transaction_inclusion(hash).await?;\n\n Ok(receipt)\n }\n\n /// Call contract, returning the output data.\n ///\n /// Handler for ETH RPC call: `eth_call`\n pub async fn call(\n &self,\n request: WithOtherFields,\n block_number: Option,\n overrides: EvmOverrides,\n ) -> Result {\n node_info!(\"eth_call\");\n let block_request = self.block_request(block_number).await?;\n // check if the number predates the fork, if in fork mode\n if let BlockRequest::Number(number) = block_request\n && let Some(fork) = self.get_fork()\n && fork.predates_fork(number)\n {\n if overrides.has_state() || overrides.has_block() {\n return Err(BlockchainError::EvmOverrideError(\n \"not available on past forked blocks\".to_string(),\n ));\n }\n return Ok(fork.call(&request, Some(number.into())).await?);\n }\n\n let fees = FeeDetails::new(\n request.gas_price,\n request.max_fee_per_gas,\n request.max_priority_fee_per_gas,\n request.max_fee_per_blob_gas,\n )?\n .or_zero_fees();\n // this can be blocking for a bit, especially in forking mode\n // \n self.on_blocking_task(|this| async move {\n let (exit, out, gas, _) =\n this.backend.call(request, fees, Some(block_request), overrides).await?;\n trace!(target : \"node\", \"Call status {:?}, gas {}\", exit, gas);\n\n ensure_return_ok(exit, &out)\n })\n .await\n }\n\n pub async fn simulate_v1(\n &self,\n request: SimulatePayload,\n block_number: Option,\n ) -> Result>> {\n node_info!(\"eth_simulateV1\");\n let block_request = self.block_request(block_number).await?;\n // check if the number predates the fork, if in fork mode\n if let BlockRequest::Number(number) = block_request\n && let Some(fork) = self.get_fork()\n && fork.predates_fork(number)\n {\n return Ok(fork.simulate_v1(&request, Some(number.into())).await?);\n }\n\n // this can be blocking for a bit, especially in forking mode\n // \n self.on_blocking_task(|this| async move {\n let simulated_blocks = this.backend.simulate(request, Some(block_request)).await?;\n trace!(target : \"node\", \"Simulate status {:?}\", simulated_blocks);\n\n Ok(simulated_blocks)\n })\n .await\n }\n\n /// This method creates an EIP2930 type accessList based on a given Transaction. The accessList\n /// contains all storage slots and addresses read and written by the transaction, except for the\n /// sender account and the precompiles.\n ///\n /// It returns list of addresses and storage keys used by the transaction, plus the gas\n /// consumed when the access list is added. That is, it gives you the list of addresses and\n /// storage keys that will be used by that transaction, plus the gas consumed if the access\n /// list is included. Like eth_estimateGas, this is an estimation; the list could change\n /// when the transaction is actually mined. Adding an accessList to your transaction does\n /// not necessary result in lower gas usage compared to a transaction without an access\n /// list.\n ///\n /// Handler for ETH RPC call: `eth_createAccessList`\n pub async fn create_access_list(\n &self,\n mut request: WithOtherFields,\n block_number: Option,\n ) -> Result {\n node_info!(\"eth_createAccessList\");\n let block_request = self.block_request(block_number).await?;\n // check if the number predates the fork, if in fork mode\n if let BlockRequest::Number(number) = block_request\n && let Some(fork) = self.get_fork()\n && fork.predates_fork(number)\n {\n return Ok(fork.create_access_list(&request, Some(number.into())).await?);\n }\n\n self.backend\n .with_database_at(Some(block_request), |state, block_env| {\n let (exit, out, _, access_list) = self.backend.build_access_list_with_state(\n &state,\n request.clone(),\n FeeDetails::zero(),\n block_env.clone(),\n )?;\n ensure_return_ok(exit, &out)?;\n\n // execute again but with access list set\n request.access_list = Some(access_list.clone());\n\n let (exit, out, gas_used, _) = self.backend.call_with_state(\n &state,\n request.clone(),\n FeeDetails::zero(),\n block_env,\n )?;\n ensure_return_ok(exit, &out)?;\n\n Ok(AccessListResult {\n access_list: AccessList(access_list.0),\n gas_used: U256::from(gas_used),\n error: None,\n })\n })\n .await?\n }\n\n /// Estimate gas needed for execution of given contract.\n /// If no block parameter is given, it will use the pending block by default\n ///\n /// Handler for ETH RPC call: `eth_estimateGas`\n pub async fn estimate_gas(\n &self,\n request: WithOtherFields,\n block_number: Option,\n overrides: EvmOverrides,\n ) -> Result {\n node_info!(\"eth_estimateGas\");\n self.do_estimate_gas(\n request,\n block_number.or_else(|| Some(BlockNumber::Pending.into())),\n overrides,\n )\n .await\n .map(U256::from)\n }\n\n /// Fills a transaction request with default values for missing fields.\n ///\n /// This method populates missing transaction fields like nonce, gas limit,\n /// chain ID, and fee parameters with appropriate defaults.\n ///\n /// Handler for ETH RPC call: `eth_fillTransaction`\n pub async fn fill_transaction(\n &self,\n mut request: WithOtherFields,\n ) -> Result> {\n node_info!(\"eth_fillTransaction\");\n\n let from = match request.as_ref().from() {\n Some(from) => from,\n None => self.accounts()?.first().copied().ok_or(BlockchainError::NoSignerAvailable)?,\n };\n\n let nonce = if let Some(nonce) = request.as_ref().nonce() {\n nonce\n } else {\n self.request_nonce(&request, from).await?.0\n };\n\n // Prefill gas limit with estimated gas, bubble up the error if the gas estimation fails\n // This is a workaround to avoid the error being swallowed by the `build_tx_request`\n // function\n if request.as_ref().gas_limit().is_none() {\n let estimated_gas =\n self.estimate_gas(request.clone(), None, EvmOverrides::default()).await?;\n request.as_mut().set_gas_limit(estimated_gas.to());\n }\n\n let typed_tx = self.build_tx_request(request, nonce).await?;\n let tx = build_impersonated(typed_tx);\n\n let raw = tx.encoded_2718().to_vec().into();\n\n let mut tx =\n transaction_build(None, MaybeImpersonatedTransaction::new(tx), None, None, None);\n\n // Set the correct `from` address (overrides the recovered zero address from dummy\n // signature)\n tx.0.inner.inner = Recovered::new_unchecked(tx.0.inner.inner.into_inner(), from);\n\n Ok(FillTransaction { raw, tx })\n }\n\n /// Handler for RPC call: `anvil_getBlobByHash`\n pub fn anvil_get_blob_by_versioned_hash(\n &self,\n hash: B256,\n ) -> Result> {\n node_info!(\"anvil_getBlobByHash\");\n Ok(self.backend.get_blob_by_versioned_hash(hash)?)\n }\n\n /// Handler for RPC call: `anvil_getBlobsByTransactionHash`\n pub fn anvil_get_blob_by_tx_hash(&self, hash: B256) -> Result>> {\n node_info!(\"anvil_getBlobsByTransactionHash\");\n Ok(self.backend.get_blob_by_tx_hash(hash)?)\n }\n\n /// Handler for RPC call: `anvil_getBlobsByBlockId`\n pub fn anvil_get_blobs_by_block_id(\n &self,\n block_id: impl Into,\n versioned_hashes: Vec,\n ) -> Result>> {\n node_info!(\"anvil_getBlobsByBlockId\");\n Ok(self.backend.get_blobs_by_block_id(block_id, versioned_hashes)?)\n }\n\n /// Returns the genesis time for the Beacon chain\n ///\n /// Handler for Beacon API call: `GET /eth/v1/beacon/genesis`\n pub fn anvil_get_genesis_time(&self) -> Result {\n node_info!(\"anvil_getGenesisTime\");\n Ok(self.backend.genesis_time())\n }\n\n /// Get transaction by its hash.\n ///\n /// This will check the storage for a matching transaction, if no transaction exists in storage\n /// this will also scan the mempool for a matching pending transaction\n ///\n /// Handler for ETH RPC call: `eth_getTransactionByHash`\n pub async fn transaction_by_hash(&self, hash: B256) -> Result> {\n node_info!(\"eth_getTransactionByHash\");\n let mut tx = self.pool.get_transaction(hash).map(|pending| {\n let from = *pending.sender();\n let tx = transaction_build(\n Some(*pending.hash()),\n pending.transaction,\n None,\n None,\n Some(self.backend.base_fee()),\n );\n\n let WithOtherFields { inner: mut tx, other } = tx.0;\n // we set the from field here explicitly to the set sender of the pending transaction,\n // in case the transaction is impersonated.\n tx.inner = Recovered::new_unchecked(tx.inner.into_inner(), from);\n\n AnyRpcTransaction(WithOtherFields { inner: tx, other })\n });\n if tx.is_none() {\n tx = self.backend.transaction_by_hash(hash).await?\n }\n\n Ok(tx)\n }\n\n /// Returns transaction at given block hash and index.\n ///\n /// Handler for ETH RPC call: `eth_getTransactionByBlockHashAndIndex`\n pub async fn transaction_by_block_hash_and_index(\n &self,\n hash: B256,\n index: Index,\n ) -> Result> {\n node_info!(\"eth_getTransactionByBlockHashAndIndex\");\n self.backend.transaction_by_block_hash_and_index(hash, index).await\n }\n\n /// Returns transaction by given block number and index.\n ///\n /// Handler for ETH RPC call: `eth_getTransactionByBlockNumberAndIndex`\n pub async fn transaction_by_block_number_and_index(\n &self,\n block: BlockNumber,\n idx: Index,\n ) -> Result> {\n node_info!(\"eth_getTransactionByBlockNumberAndIndex\");\n self.backend.transaction_by_block_number_and_index(block, idx).await\n }\n\n /// Returns the transaction by sender and nonce.\n ///\n /// This will check the mempool for pending transactions first, then perform a binary search\n /// over mined blocks to find the transaction.\n ///\n /// Handler for ETH RPC call: `eth_getTransactionBySenderAndNonce`\n pub async fn transaction_by_sender_and_nonce(\n &self,\n sender: Address,\n nonce: U256,\n ) -> Result> {\n node_info!(\"eth_getTransactionBySenderAndNonce\");\n\n // check pending txs first\n for pending_tx in self.pool.ready_transactions().chain(self.pool.pending_transactions()) {\n if U256::from(pending_tx.pending_transaction.nonce()) == nonce\n && *pending_tx.pending_transaction.sender() == sender\n {\n let tx = transaction_build(\n Some(*pending_tx.pending_transaction.hash()),\n pending_tx.pending_transaction.transaction.clone(),\n None,\n None,\n Some(self.backend.base_fee()),\n );\n\n let WithOtherFields { inner: mut tx, other } = tx.0;\n // we set the from field here explicitly to the set sender of the pending\n // transaction, in case the transaction is impersonated.\n let from = *pending_tx.pending_transaction.sender();\n tx.inner = Recovered::new_unchecked(tx.inner.into_inner(), from);\n\n return Ok(Some(AnyRpcTransaction(WithOtherFields { inner: tx, other })));\n }\n }\n\n let highest_nonce = self.transaction_count(sender, None).await?.saturating_to::();\n let target_nonce = nonce.saturating_to::();\n\n // if the nonce is higher or equal to the highest nonce, the transaction doesn't exist\n if target_nonce >= highest_nonce {\n return Ok(None);\n }\n\n // no mined blocks yet\n let latest_block = self.backend.best_number();\n if latest_block == 0 {\n return Ok(None);\n }\n\n // binary search for the block containing the transaction\n let mut low = 1u64;\n let mut high = latest_block;\n\n while low <= high {\n let mid = low + (high - low) / 2;\n let mid_nonce =\n self.transaction_count(sender, Some(mid.into())).await?.saturating_to::();\n\n if mid_nonce > target_nonce {\n high = mid - 1;\n } else {\n low = mid + 1;\n }\n }\n\n // search in the target block\n let target_block = low;\n if target_block <= latest_block\n && let Some(txs) =\n self.backend.mined_transactions_by_block_number(target_block.into()).await\n {\n for tx in txs {\n if tx.from() == sender && tx.nonce() == target_nonce {\n return Ok(Some(tx));\n }\n }\n }\n\n Ok(None)\n }\n\n /// Returns transaction receipt by transaction hash.\n ///\n /// Handler for ETH RPC call: `eth_getTransactionReceipt`\n pub async fn transaction_receipt(&self, hash: B256) -> Result> {\n node_info!(\"eth_getTransactionReceipt\");\n self.backend.transaction_receipt(hash).await\n }\n\n /// Returns block receipts by block number.\n ///\n /// Handler for ETH RPC call: `eth_getBlockReceipts`\n pub async fn block_receipts(&self, number: BlockId) -> Result>> {\n node_info!(\"eth_getBlockReceipts\");\n self.backend.block_receipts(number).await\n }\n\n /// Returns an uncles at given block and index.\n ///\n /// Handler for ETH RPC call: `eth_getUncleByBlockHashAndIndex`\n pub async fn uncle_by_block_hash_and_index(\n &self,\n block_hash: B256,\n idx: Index,\n ) -> Result> {\n node_info!(\"eth_getUncleByBlockHashAndIndex\");\n let number =\n self.backend.ensure_block_number(Some(BlockId::Hash(block_hash.into()))).await?;\n if let Some(fork) = self.get_fork()\n && fork.predates_fork_inclusive(number)\n {\n return Ok(fork.uncle_by_block_hash_and_index(block_hash, idx.into()).await?);\n }\n // It's impossible to have uncles outside of fork mode\n Ok(None)\n }\n\n /// Returns an uncles at given block and index.\n ///\n /// Handler for ETH RPC call: `eth_getUncleByBlockNumberAndIndex`\n pub async fn uncle_by_block_number_and_index(\n &self,\n block_number: BlockNumber,\n idx: Index,\n ) -> Result> {\n node_info!(\"eth_getUncleByBlockNumberAndIndex\");\n let number = self.backend.ensure_block_number(Some(BlockId::Number(block_number))).await?;\n if let Some(fork) = self.get_fork()\n && fork.predates_fork_inclusive(number)\n {\n return Ok(fork.uncle_by_block_number_and_index(number, idx.into()).await?);\n }\n // It's impossible to have uncles outside of fork mode\n Ok(None)\n }\n\n /// Returns logs matching given filter object.\n ///\n /// Handler for ETH RPC call: `eth_getLogs`\n pub async fn logs(&self, filter: Filter) -> Result> {\n node_info!(\"eth_getLogs\");\n self.backend.logs(filter).await\n }\n\n /// Returns the hash of the current block, the seedHash, and the boundary condition to be met.\n ///\n /// Handler for ETH RPC call: `eth_getWork`\n pub fn work(&self) -> Result {\n node_info!(\"eth_getWork\");\n Err(BlockchainError::RpcUnimplemented)\n }\n\n /// Returns the sync status, always be fails.\n ///\n /// Handler for ETH RPC call: `eth_syncing`\n pub fn syncing(&self) -> Result {\n node_info!(\"eth_syncing\");\n Ok(false)\n }\n\n /// Returns the current configuration of the chain.\n /// This is useful for finding out what precompiles and system contracts are available.\n ///\n /// Note: the activation timestamp is always 0 as the configuration is set at genesis.\n /// Note: the `fork_id` is always `0x00000000` as this node does not participate in any forking\n /// on the network.\n /// Note: the `next` and `last` fields are always `null` as this node does not participate in\n /// any forking on the network.\n ///\n /// Handler for ETH RPC call: `eth_config`\n pub fn config(&self) -> Result {\n node_info!(\"eth_config\");\n Ok(EthConfig {\n current: EthForkConfig {\n activation_time: 0,\n blob_schedule: self.backend.blob_params(),\n chain_id: self.backend.env().read().evm_env.cfg_env.chain_id,\n fork_id: Bytes::from_static(&[0; 4]),\n precompiles: self.backend.precompiles(),\n system_contracts: self.backend.system_contracts(),\n },\n next: None,\n last: None,\n })\n }\n\n /// Used for submitting a proof-of-work solution.\n ///\n /// Handler for ETH RPC call: `eth_submitWork`\n pub fn submit_work(&self, _: B64, _: B256, _: B256) -> Result {\n node_info!(\"eth_submitWork\");\n Err(BlockchainError::RpcUnimplemented)\n }\n\n /// Used for submitting mining hashrate.\n ///\n /// Handler for ETH RPC call: `eth_submitHashrate`\n pub fn submit_hashrate(&self, _: U256, _: B256) -> Result {\n node_info!(\"eth_submitHashrate\");\n Err(BlockchainError::RpcUnimplemented)\n }\n\n /// Introduced in EIP-1559 for getting information on the appropriate priority fee to use.\n ///\n /// Handler for ETH RPC call: `eth_feeHistory`\n pub async fn fee_history(\n &self,\n block_count: U256,\n newest_block: BlockNumber,\n reward_percentiles: Vec,\n ) -> Result {\n node_info!(\"eth_feeHistory\");\n // max number of blocks in the requested range\n\n let current = self.backend.best_number();\n let slots_in_an_epoch = 32u64;\n\n let number = match newest_block {\n BlockNumber::Latest | BlockNumber::Pending => current,\n BlockNumber::Earliest => 0,\n BlockNumber::Number(n) => n,\n BlockNumber::Safe => current.saturating_sub(slots_in_an_epoch),\n BlockNumber::Finalized => current.saturating_sub(slots_in_an_epoch * 2),\n };\n\n // check if the number predates the fork, if in fork mode\n if let Some(fork) = self.get_fork() {\n // if we're still at the forked block we don't have any history and can't compute it\n // efficiently, instead we fetch it from the fork\n if fork.predates_fork_inclusive(number) {\n return fork\n .fee_history(block_count.to(), BlockNumber::Number(number), &reward_percentiles)\n .await\n .map_err(BlockchainError::AlloyForkProvider);\n }\n }\n\n const MAX_BLOCK_COUNT: u64 = 1024u64;\n let block_count = block_count.to::().min(MAX_BLOCK_COUNT);\n\n // highest and lowest block num in the requested range\n let highest = number;\n let lowest = highest.saturating_sub(block_count.saturating_sub(1));\n\n // only support ranges that are in cache range\n if lowest < self.backend.best_number().saturating_sub(self.fee_history_limit) {\n return Err(FeeHistoryError::InvalidBlockRange.into());\n }\n\n let mut response = FeeHistory {\n oldest_block: lowest,\n base_fee_per_gas: Vec::new(),\n gas_used_ratio: Vec::new(),\n reward: Some(Default::default()),\n base_fee_per_blob_gas: Default::default(),\n blob_gas_used_ratio: Default::default(),\n };\n let mut rewards = Vec::new();\n\n {\n let fee_history = self.fee_history_cache.lock();\n\n // iter over the requested block range\n for n in lowest..=highest {\n // \n if let Some(block) = fee_history.get(&n) {\n response.base_fee_per_gas.push(block.base_fee);\n response.base_fee_per_blob_gas.push(block.base_fee_per_blob_gas.unwrap_or(0));\n response.blob_gas_used_ratio.push(block.blob_gas_used_ratio);\n response.gas_used_ratio.push(block.gas_used_ratio);\n\n // requested percentiles\n if !reward_percentiles.is_empty() {\n let mut block_rewards = Vec::new();\n let resolution_per_percentile: f64 = 2.0;\n for p in &reward_percentiles {\n let p = p.clamp(0.0, 100.0);\n let index = ((p.round() / 2f64) * 2f64) * resolution_per_percentile;\n let reward = block.rewards.get(index as usize).map_or(0, |r| *r);\n block_rewards.push(reward);\n }\n rewards.push(block_rewards);\n }\n }\n }\n }\n\n response.reward = Some(rewards);\n\n // add the next block's base fee to the response\n // The spec states that `base_fee_per_gas` \"[..] includes the next block after the\n // newest of the returned range, because this value can be derived from the\n // newest block\"\n response.base_fee_per_gas.push(self.backend.fees().base_fee() as u128);\n\n // Same goes for the `base_fee_per_blob_gas`:\n // > [..] includes the next block after the newest of the returned range, because this\n // > value can be derived from the newest block.\n response.base_fee_per_blob_gas.push(self.backend.fees().base_fee_per_blob_gas());\n\n Ok(response)\n }\n\n /// Introduced in EIP-1159, a Geth-specific and simplified priority fee oracle.\n /// Leverages the already existing fee history cache.\n ///\n /// Returns a suggestion for a gas tip cap for dynamic fee transactions.\n ///\n /// Handler for ETH RPC call: `eth_maxPriorityFeePerGas`\n pub fn max_priority_fee_per_gas(&self) -> Result {\n node_info!(\"eth_maxPriorityFeePerGas\");\n Ok(U256::from(self.lowest_suggestion_tip()))\n }\n\n /// Creates a filter object, based on filter options, to notify when the state changes (logs).\n ///\n /// Handler for ETH RPC call: `eth_newFilter`\n pub async fn new_filter(&self, filter: Filter) -> Result {\n node_info!(\"eth_newFilter\");\n // all logs that are already available that match the filter if the filter's block range is\n // in the past\n let historic = if filter.block_option.get_from_block().is_some() {\n self.backend.logs(filter.clone()).await?\n } else {\n vec![]\n };\n let filter = EthFilter::Logs(Box::new(LogsFilter {\n blocks: self.new_block_notifications(),\n storage: self.storage_info(),\n filter: FilteredParams::new(Some(filter)),\n historic: Some(historic),\n }));\n Ok(self.filters.add_filter(filter).await)\n }\n\n /// Creates a filter in the node, to notify when a new block arrives.\n ///\n /// Handler for ETH RPC call: `eth_newBlockFilter`\n pub async fn new_block_filter(&self) -> Result {\n node_info!(\"eth_newBlockFilter\");\n let filter = EthFilter::Blocks(self.new_block_notifications());\n Ok(self.filters.add_filter(filter).await)\n }\n\n /// Creates a filter in the node, to notify when new pending transactions arrive.\n ///\n /// Handler for ETH RPC call: `eth_newPendingTransactionFilter`\n pub async fn new_pending_transaction_filter(&self) -> Result {\n node_info!(\"eth_newPendingTransactionFilter\");\n let filter = EthFilter::PendingTransactions(self.new_ready_transactions());\n Ok(self.filters.add_filter(filter).await)\n }\n\n /// Polling method for a filter, which returns an array of logs which occurred since last poll.\n ///\n /// Handler for ETH RPC call: `eth_getFilterChanges`\n pub async fn get_filter_changes(&self, id: &str) -> ResponseResult {\n node_info!(\"eth_getFilterChanges\");\n self.filters.get_filter_changes(id).await\n }\n\n /// Returns an array of all logs matching filter with given id.\n ///\n /// Handler for ETH RPC call: `eth_getFilterLogs`\n pub async fn get_filter_logs(&self, id: &str) -> Result> {\n node_info!(\"eth_getFilterLogs\");\n if let Some(filter) = self.filters.get_log_filter(id).await {\n self.backend.logs(filter).await\n } else {\n Err(BlockchainError::FilterNotFound)\n }\n }\n\n /// Handler for ETH RPC call: `eth_uninstallFilter`\n pub async fn uninstall_filter(&self, id: &str) -> Result {\n node_info!(\"eth_uninstallFilter\");\n Ok(self.filters.uninstall_filter(id).await.is_some())\n }\n\n /// Returns EIP-2718 encoded raw transaction\n ///\n /// Handler for RPC call: `debug_getRawTransaction`\n pub async fn raw_transaction(&self, hash: B256) -> Result> {\n node_info!(\"debug_getRawTransaction\");\n self.inner_raw_transaction(hash).await\n }\n\n /// Returns EIP-2718 encoded raw transaction by block hash and index\n ///\n /// Handler for RPC call: `eth_getRawTransactionByBlockHashAndIndex`\n pub async fn raw_transaction_by_block_hash_and_index(\n &self,\n block_hash: B256,\n index: Index,\n ) -> Result> {\n node_info!(\"eth_getRawTransactionByBlockHashAndIndex\");\n match self.backend.transaction_by_block_hash_and_index(block_hash, index).await? {\n Some(tx) => self.inner_raw_transaction(tx.tx_hash()).await,\n None => Ok(None),\n }\n }\n\n /// Returns EIP-2718 encoded raw transaction by block number and index\n ///\n /// Handler for RPC call: `eth_getRawTransactionByBlockNumberAndIndex`\n pub async fn raw_transaction_by_block_number_and_index(\n &self,\n block_number: BlockNumber,\n index: Index,\n ) -> Result> {\n node_info!(\"eth_getRawTransactionByBlockNumberAndIndex\");\n match self.backend.transaction_by_block_number_and_index(block_number, index).await? {\n Some(tx) => self.inner_raw_transaction(tx.tx_hash()).await,\n None => Ok(None),\n }\n }\n\n /// Returns traces for the transaction hash for geth's tracing endpoint\n ///\n /// Handler for RPC call: `debug_traceTransaction`\n pub async fn debug_trace_transaction(\n &self,\n tx_hash: B256,\n opts: GethDebugTracingOptions,\n ) -> Result {\n node_info!(\"debug_traceTransaction\");\n self.backend.debug_trace_transaction(tx_hash, opts).await\n }\n\n /// Returns traces for the transaction for geth's tracing endpoint\n ///\n /// Handler for RPC call: `debug_traceCall`\n pub async fn debug_trace_call(\n &self,\n request: WithOtherFields,\n block_number: Option,\n opts: GethDebugTracingCallOptions,\n ) -> Result {\n node_info!(\"debug_traceCall\");\n let block_request = self.block_request(block_number).await?;\n let fees = FeeDetails::new(\n request.gas_price,\n request.max_fee_per_gas,\n request.max_priority_fee_per_gas,\n request.max_fee_per_blob_gas,\n )?\n .or_zero_fees();\n\n let result: std::result::Result =\n self.backend.call_with_tracing(request, fees, Some(block_request), opts).await;\n result\n }\n\n /// Returns code by its hash\n ///\n /// Handler for RPC call: `debug_codeByHash`\n pub async fn debug_code_by_hash(\n &self,\n hash: B256,\n block_id: Option,\n ) -> Result> {\n node_info!(\"debug_codeByHash\");\n self.backend.debug_code_by_hash(hash, block_id).await\n }\n\n /// Returns the value associated with a key from the database\n /// Only supports bytecode lookups.\n ///\n /// Handler for RPC call: `debug_dbGet`\n pub async fn debug_db_get(&self, key: String) -> Result> {\n node_info!(\"debug_dbGet\");\n self.backend.debug_db_get(key).await\n }\n\n /// Returns traces for the transaction hash via parity's tracing endpoint\n ///\n /// Handler for RPC call: `trace_transaction`\n pub async fn trace_transaction(&self, tx_hash: B256) -> Result> {\n node_info!(\"trace_transaction\");\n self.backend.trace_transaction(tx_hash).await\n }\n\n /// Returns traces for the transaction hash via parity's tracing endpoint\n ///\n /// Handler for RPC call: `trace_block`\n pub async fn trace_block(&self, block: BlockNumber) -> Result> {\n node_info!(\"trace_block\");\n self.backend.trace_block(block).await\n }\n\n /// Returns filtered traces over blocks\n ///\n /// Handler for RPC call: `trace_filter`\n pub async fn trace_filter(\n &self,\n filter: TraceFilter,\n ) -> Result> {\n node_info!(\"trace_filter\");\n self.backend.trace_filter(filter).await\n }\n\n /// Replays all transactions in a block returning the requested traces for each transaction\n ///\n /// Handler for RPC call: `trace_replayBlockTransactions`\n pub async fn trace_replay_block_transactions(\n &self,\n block: BlockNumber,\n trace_types: HashSet,\n ) -> Result> {\n node_info!(\"trace_replayBlockTransactions\");\n self.backend.trace_replay_block_transactions(block, trace_types).await\n }\n}\n\n// == impl EthApi anvil endpoints ==\n\nimpl EthApi {\n /// Send transactions impersonating specific account and contract addresses.\n ///\n /// Handler for ETH RPC call: `anvil_impersonateAccount`\n pub async fn anvil_impersonate_account(&self, address: Address) -> Result<()> {\n node_info!(\"anvil_impersonateAccount\");\n self.backend.impersonate(address);\n Ok(())\n }\n\n /// Stops impersonating an account if previously set with `anvil_impersonateAccount`.\n ///\n /// Handler for ETH RPC call: `anvil_stopImpersonatingAccount`\n pub async fn anvil_stop_impersonating_account(&self, address: Address) -> Result<()> {\n node_info!(\"anvil_stopImpersonatingAccount\");\n self.backend.stop_impersonating(address);\n Ok(())\n }\n\n /// If set to true will make every account impersonated\n ///\n /// Handler for ETH RPC call: `anvil_autoImpersonateAccount`\n pub async fn anvil_auto_impersonate_account(&self, enabled: bool) -> Result<()> {\n node_info!(\"anvil_autoImpersonateAccount\");\n self.backend.auto_impersonate_account(enabled);\n Ok(())\n }\n\n /// Registers a new address and signature pair to impersonate.\n pub async fn anvil_impersonate_signature(\n &self,\n signature: Bytes,\n address: Address,\n ) -> Result<()> {\n node_info!(\"anvil_impersonateSignature\");\n self.backend.impersonate_signature(signature, address).await\n }\n\n /// Mines a series of blocks.\n ///\n /// Handler for ETH RPC call: `anvil_mine`\n pub async fn anvil_mine(&self, num_blocks: Option, interval: Option) -> Result<()> {\n node_info!(\"anvil_mine\");\n let interval = interval.map(|i| i.to::());\n let blocks = num_blocks.unwrap_or(U256::from(1));\n if blocks.is_zero() {\n return Ok(());\n }\n\n self.on_blocking_task(|this| async move {\n // mine all the blocks\n for _ in 0..blocks.to::() {\n // If we have an interval, jump forwards in time to the \"next\" timestamp\n if let Some(interval) = interval {\n this.backend.time().increase_time(interval);\n }\n this.mine_one().await;\n }\n Ok(())\n })\n .await?;\n\n Ok(())\n }\n\n /// Helper function to find the storage slot for an ERC20 function call by testing slots\n /// from an access list until one produces the expected result.\n ///\n /// Rather than trying to reverse-engineer the storage layout, this function uses a\n /// \"trial and error\" approach: try overriding each slot that the function accesses,\n /// and see which one actually affects the function's return value.\n ///\n /// ## Parameters\n /// - `token_address`: The ERC20 token contract address\n /// - `calldata`: The encoded function call (e.g., `balanceOf(user)` or `allowance(owner,\n /// spender)`)\n /// - `expected_value`: The value we want to set (balance or allowance amount)\n ///\n /// ## Returns\n /// The storage slot (B256) that contains the target ERC20 data, or an error if no slot is\n /// found.\n async fn find_erc20_storage_slot(\n &self,\n token_address: Address,\n calldata: Bytes,\n expected_value: U256,\n ) -> Result {\n let tx = TransactionRequest::default().with_to(token_address).with_input(calldata.clone());\n\n // first collect all the slots that are used by the function call\n let access_list_result =\n self.create_access_list(WithOtherFields::new(tx.clone()), None).await?;\n let access_list = access_list_result.access_list;\n\n // iterate over all the accessed slots and try to find the one that contains the\n // target value by overriding the slot and checking the function call result\n for item in access_list.0 {\n if item.address != token_address {\n continue;\n };\n for slot in &item.storage_keys {\n let account_override = AccountOverride::default().with_state_diff(std::iter::once(\n (*slot, B256::from(expected_value.to_be_bytes())),\n ));\n\n let state_override = StateOverridesBuilder::default()\n .append(token_address, account_override)\n .build();\n\n let evm_override = EvmOverrides::state(Some(state_override));\n\n let Ok(result) =\n self.call(WithOtherFields::new(tx.clone()), None, evm_override).await\n else {\n // overriding this slot failed\n continue;\n };\n\n let Ok(result_value) = U256::abi_decode(&result) else {\n // response returned something other than a U256\n continue;\n };\n\n if result_value == expected_value {\n return Ok(*slot);\n }\n }\n }\n\n Err(BlockchainError::Message(\"Unable to find storage slot\".to_string()))\n }\n\n /// Deals ERC20 tokens to a address\n ///\n /// Handler for RPC call: `anvil_dealERC20`\n pub async fn anvil_deal_erc20(\n &self,\n address: Address,\n token_address: Address,\n balance: U256,\n ) -> Result<()> {\n node_info!(\"anvil_dealERC20\");\n\n sol! {\n #[sol(rpc)]\n contract IERC20 {\n function balanceOf(address target) external view returns (uint256);\n }\n }\n\n let calldata = IERC20::balanceOfCall { target: address }.abi_encode().into();\n\n // Find the storage slot that contains the balance\n let slot =\n self.find_erc20_storage_slot(token_address, calldata, balance).await.map_err(|_| {\n BlockchainError::Message(\"Unable to set ERC20 balance, no slot found\".to_string())\n })?;\n\n // Set the storage slot to the desired balance\n self.anvil_set_storage_at(\n token_address,\n U256::from_be_bytes(slot.0),\n B256::from(balance.to_be_bytes()),\n )\n .await?;\n\n Ok(())\n }\n\n /// Sets the ERC20 allowance for a spender\n ///\n /// Handler for RPC call: `anvil_set_erc20_allowance`\n pub async fn anvil_set_erc20_allowance(\n &self,\n owner: Address,\n spender: Address,\n token_address: Address,\n amount: U256,\n ) -> Result<()> {\n node_info!(\"anvil_setERC20Allowance\");\n\n sol! {\n #[sol(rpc)]\n contract IERC20 {\n function allowance(address owner, address spender) external view returns (uint256);\n }\n }\n\n let calldata = IERC20::allowanceCall { owner, spender }.abi_encode().into();\n\n // Find the storage slot that contains the allowance\n let slot =\n self.find_erc20_storage_slot(token_address, calldata, amount).await.map_err(|_| {\n BlockchainError::Message(\"Unable to set ERC20 allowance, no slot found\".to_string())\n })?;\n\n // Set the storage slot to the desired allowance\n self.anvil_set_storage_at(\n token_address,\n U256::from_be_bytes(slot.0),\n B256::from(amount.to_be_bytes()),\n )\n .await?;\n\n Ok(())\n }\n\n /// Reorg the chain to a specific depth and mine new blocks back to the canonical height.\n ///\n /// e.g depth = 3\n /// A -> B -> C -> D -> E\n /// A -> B -> C' -> D' -> E'\n ///\n /// Depth specifies the height to reorg the chain back to. Depth must not exceed the current\n /// chain height, i.e. can't reorg past the genesis block.\n ///\n /// Optionally supply a list of transaction and block pairs that will populate the reorged\n /// blocks. The maximum block number of the pairs must not exceed the specified depth.\n ///\n /// Handler for RPC call: `anvil_reorg`\n pub async fn anvil_reorg(&self, options: ReorgOptions) -> Result<()> {\n node_info!(\"anvil_reorg\");\n let depth = options.depth;\n let tx_block_pairs = options.tx_block_pairs;\n\n // Check reorg depth doesn't exceed current chain height\n let current_height = self.backend.best_number();\n let common_height = current_height.checked_sub(depth).ok_or(BlockchainError::RpcError(\n RpcError::invalid_params(format!(\n \"Reorg depth must not exceed current chain height: current height {current_height}, depth {depth}\"\n )),\n ))?;\n\n // Get the common ancestor block\n let common_block =\n self.backend.get_block(common_height).ok_or(BlockchainError::BlockNotFound)?;\n\n // Convert the transaction requests to pool transactions if they exist, otherwise use empty\n // hashmap\n let block_pool_txs = if tx_block_pairs.is_empty() {\n HashMap::default()\n } else {\n let mut pairs = tx_block_pairs;\n\n // Check the maximum block supplied number will not exceed the reorged chain height\n if let Some((_, num)) = pairs.iter().find(|(_, num)| *num >= depth) {\n return Err(BlockchainError::RpcError(RpcError::invalid_params(format!(\n \"Block number for reorg tx will exceed the reorged chain height. Block number {num} must not exceed (depth-1) {}\",\n depth - 1\n ))));\n }\n\n // Sort by block number to make it easier to manage new nonces\n pairs.sort_by_key(|a| a.1);\n\n // Manage nonces for each signer\n // address -> cumulative nonce\n let mut nonces: HashMap = HashMap::default();\n\n let mut txs: HashMap>>> =\n HashMap::default();\n for pair in pairs {\n let (tx_data, block_index) = pair;\n\n let pending = match tx_data {\n TransactionData::Raw(bytes) => {\n let mut data = bytes.as_ref();\n let decoded = FoundryTxEnvelope::decode_2718(&mut data)\n .map_err(|_| BlockchainError::FailedToDecodeSignedTransaction)?;\n PendingTransaction::new(decoded)?\n }\n\n TransactionData::JSON(request) => {\n let from = request.from.map(Ok).unwrap_or_else(|| {\n self.accounts()?\n .first()\n .copied()\n .ok_or(BlockchainError::NoSignerAvailable)\n })?;\n\n // Get the nonce at the common block\n let curr_nonce = nonces.entry(from).or_insert(\n self.get_transaction_count(\n from,\n Some(common_block.header.number().into()),\n )\n .await?,\n );\n\n // Build typed transaction request\n let typed_tx = self.build_tx_request(request.into(), *curr_nonce).await?;\n\n // Increment nonce\n *curr_nonce += 1;\n\n // Handle signer and convert to pending transaction\n if self.is_impersonated(from) {\n let transaction = sign::build_impersonated(typed_tx);\n self.ensure_typed_transaction_supported(&transaction)?;\n PendingTransaction::with_impersonated(transaction, from)\n } else {\n let transaction = self.sign_request(&from, typed_tx)?;\n self.ensure_typed_transaction_supported(&transaction)?;\n PendingTransaction::new(transaction)?\n }\n }\n };\n\n let pooled = PoolTransaction::new(pending);\n txs.entry(block_index).or_default().push(Arc::new(pooled));\n }\n\n txs\n };\n\n self.backend.reorg(depth, block_pool_txs, common_block).await?;\n Ok(())\n }\n\n /// Mine blocks, instantly.\n ///\n /// Handler for RPC call: `evm_mine`\n ///\n /// This will mine the blocks regardless of the configured mining mode.\n /// **Note**: ganache returns `0x0` here as placeholder for additional meta-data in the future.\n pub async fn evm_mine(&self, opts: Option) -> Result {\n node_info!(\"evm_mine\");\n\n self.do_evm_mine(opts).await?;\n\n Ok(\"0x0\".to_string())\n }\n\n /// Mine blocks, instantly and return the mined blocks.\n ///\n /// Handler for RPC call: `evm_mine_detailed`\n ///\n /// This will mine the blocks regardless of the configured mining mode.\n ///\n /// **Note**: This behaves exactly as [Self::evm_mine] but returns different output, for\n /// compatibility reasons, this is a separate call since `evm_mine` is not an anvil original.\n /// and `ganache` may change the `0x0` placeholder.\n pub async fn evm_mine_detailed(&self, opts: Option) -> Result> {\n node_info!(\"evm_mine_detailed\");\n\n let mined_blocks = self.do_evm_mine(opts).await?;\n\n let mut blocks = Vec::with_capacity(mined_blocks as usize);\n\n let latest = self.backend.best_number();\n for offset in (0..mined_blocks).rev() {\n let block_num = latest - offset;\n if let Some(mut block) =\n self.backend.block_by_number_full(BlockNumber::Number(block_num)).await?\n {\n let block_txs = match block.transactions_mut() {\n BlockTransactions::Full(txs) => txs,\n BlockTransactions::Hashes(_) | BlockTransactions::Uncle => unreachable!(),\n };\n for tx in block_txs.iter_mut() {\n if let Some(receipt) = self.backend.mined_transaction_receipt(tx.tx_hash())\n && let Some(output) = receipt.out\n {\n // insert revert reason if failure\n if !receipt.inner.as_ref().status()\n && let Some(reason) = RevertDecoder::new().maybe_decode(&output, None)\n {\n tx.other.insert(\n \"revertReason\".to_string(),\n serde_json::to_value(reason).expect(\"Infallible\"),\n );\n }\n tx.other.insert(\n \"output\".to_string(),\n serde_json::to_value(output).expect(\"Infallible\"),\n );\n }\n }\n block.transactions = BlockTransactions::Full(block_txs.to_vec());\n blocks.push(block);\n }\n }\n\n Ok(blocks)\n }\n\n /// Execute a transaction regardless of signature status\n ///\n /// Handler for ETH RPC call: `eth_sendUnsignedTransaction`\n pub async fn eth_send_unsigned_transaction(\n &self,\n request: WithOtherFields,\n ) -> Result {\n node_info!(\"eth_sendUnsignedTransaction\");\n // either use the impersonated account of the request's `from` field\n let from = request.from.ok_or(BlockchainError::NoSignerAvailable)?;\n\n let (nonce, on_chain_nonce) = self.request_nonce(&request, from).await?;\n\n let typed_tx = self.build_tx_request(request, nonce).await?;\n\n let transaction = sign::build_impersonated(typed_tx);\n\n self.ensure_typed_transaction_supported(&transaction)?;\n\n let pending_transaction = PendingTransaction::with_impersonated(transaction, from);\n\n // pre-validate\n self.backend.validate_pool_transaction(&pending_transaction).await?;\n\n let requires = required_marker(nonce, on_chain_nonce, from);\n let provides = vec![to_marker(nonce, from)];\n\n self.add_pending_transaction(pending_transaction, requires, provides)\n }\n\n /// Returns a summary of all the transactions currently pending for inclusion in the next\n /// block(s), as well as the ones that are being scheduled for future execution only.\n ///\n /// See [here](https://geth.ethereum.org/docs/rpc/ns-txpool#txpool_inspect) for more details\n ///\n /// Handler for ETH RPC call: `txpool_inspect`\n pub async fn txpool_inspect(&self) -> Result {\n node_info!(\"txpool_inspect\");\n let mut inspect = TxpoolInspect::default();\n\n fn convert(tx: Arc>) -> TxpoolInspectSummary {\n let tx = &tx.pending_transaction.transaction;\n let to = tx.to();\n let gas_price = tx.max_fee_per_gas();\n let value = tx.value();\n let gas = tx.gas_limit();\n TxpoolInspectSummary { to, value, gas, gas_price }\n }\n\n // Note: naming differs geth vs anvil:\n //\n // _Pending transactions_ are transactions that are ready to be processed and included in\n // the block. _Queued transactions_ are transactions where the transaction nonce is\n // not in sequence. The transaction nonce is an incrementing number for each transaction\n // with the same From address.\n for pending in self.pool.ready_transactions() {\n let entry = inspect.pending.entry(*pending.pending_transaction.sender()).or_default();\n let key = pending.pending_transaction.nonce().to_string();\n entry.insert(key, convert(pending));\n }\n for queued in self.pool.pending_transactions() {\n let entry = inspect.pending.entry(*queued.pending_transaction.sender()).or_default();\n let key = queued.pending_transaction.nonce().to_string();\n entry.insert(key, convert(queued));\n }\n Ok(inspect)\n }\n\n /// Returns the details of all transactions currently pending for inclusion in the next\n /// block(s), as well as the ones that are being scheduled for future execution only.\n ///\n /// See [here](https://geth.ethereum.org/docs/rpc/ns-txpool#txpool_content) for more details\n ///\n /// Handler for ETH RPC call: `txpool_inspect`\n pub async fn txpool_content(&self) -> Result> {\n node_info!(\"txpool_content\");\n let mut content = TxpoolContent::::default();\n fn convert(tx: Arc>) -> Result {\n let from = *tx.pending_transaction.sender();\n let tx = transaction_build(\n Some(tx.hash()),\n tx.pending_transaction.transaction.clone(),\n None,\n None,\n None,\n );\n\n let WithOtherFields { inner: mut tx, other } = tx.0;\n\n // we set the from field here explicitly to the set sender of the pending transaction,\n // in case the transaction is impersonated.\n tx.inner = Recovered::new_unchecked(tx.inner.into_inner(), from);\n\n let tx = AnyRpcTransaction(WithOtherFields { inner: tx, other });\n\n Ok(tx)\n }\n\n for pending in self.pool.ready_transactions() {\n let entry = content.pending.entry(*pending.pending_transaction.sender()).or_default();\n let key = pending.pending_transaction.nonce().to_string();\n entry.insert(key, convert(pending)?);\n }\n for queued in self.pool.pending_transactions() {\n let entry = content.pending.entry(*queued.pending_transaction.sender()).or_default();\n let key = queued.pending_transaction.nonce().to_string();\n entry.insert(key, convert(queued)?);\n }\n\n Ok(content)\n }\n}\n\nimpl EthApi {\n /// Executes the `evm_mine` and returns the number of blocks mined\n async fn do_evm_mine(&self, opts: Option) -> Result {\n let mut blocks_to_mine = 1u64;\n\n if let Some(opts) = opts {\n let timestamp = match opts {\n MineOptions::Timestamp(timestamp) => timestamp,\n MineOptions::Options { timestamp, blocks } => {\n if let Some(blocks) = blocks {\n blocks_to_mine = blocks;\n }\n timestamp\n }\n };\n if let Some(timestamp) = timestamp {\n // timestamp was explicitly provided to be the next timestamp\n self.evm_set_next_block_timestamp(timestamp)?;\n }\n }\n\n // this can be blocking for a bit, especially in forking mode\n // \n self.on_blocking_task(|this| async move {\n // mine all the blocks\n for _ in 0..blocks_to_mine {\n this.mine_one().await;\n }\n Ok(())\n })\n .await?;\n\n Ok(blocks_to_mine)\n }\n\n async fn do_estimate_gas(\n &self,\n request: WithOtherFields,\n block_number: Option,\n overrides: EvmOverrides,\n ) -> Result {\n let block_request = self.block_request(block_number).await?;\n // check if the number predates the fork, if in fork mode\n if let BlockRequest::Number(number) = block_request\n && let Some(fork) = self.get_fork()\n && fork.predates_fork(number)\n {\n if overrides.has_state() || overrides.has_block() {\n return Err(BlockchainError::EvmOverrideError(\n \"not available on past forked blocks\".to_string(),\n ));\n }\n return Ok(fork.estimate_gas(&request, Some(number.into())).await?);\n }\n\n // this can be blocking for a bit, especially in forking mode\n // \n self.on_blocking_task(|this| async move {\n this.backend\n .with_database_at(Some(block_request), |state, mut block| {\n let mut cache_db = CacheDB::new(state);\n if let Some(state_overrides) = overrides.state {\n apply_state_overrides(\n state_overrides.into_iter().collect(),\n &mut cache_db,\n )?;\n }\n if let Some(block_overrides) = overrides.block {\n cache_db.apply_block_overrides(*block_overrides, &mut block);\n }\n this.do_estimate_gas_with_state(request, &cache_db, block)\n })\n .await?\n })\n .await\n }\n\n /// Returns the priority of the transaction based on the current `TransactionOrder`\n fn transaction_priority(&self, tx: &FoundryTxEnvelope) -> TransactionPriority {\n self.transaction_order.read().priority(tx)\n }\n\n /// Returns a listener for pending transactions, yielding full transactions\n pub fn full_pending_transactions(&self) -> UnboundedReceiver {\n let (tx, rx) = unbounded_channel();\n let mut hashes = self.new_ready_transactions();\n\n let this = self.clone();\n\n tokio::spawn(async move {\n while let Some(hash) = hashes.next().await {\n if let Ok(Some(txn)) = this.transaction_by_hash(hash).await\n && tx.send(txn).is_err()\n {\n break;\n }\n }\n });\n\n rx\n }\n\n /// Mines exactly one block\n pub async fn mine_one(&self) {\n let transactions = self.pool.ready_transactions().collect::>();\n let outcome = self.backend.mine_block(transactions).await;\n\n trace!(target: \"node\", blocknumber = ?outcome.block_number, \"mined block\");\n self.pool.on_mined_block(outcome);\n }\n\n /// Returns the pending block with tx hashes\n async fn pending_block(&self) -> AnyRpcBlock {\n let transactions = self.pool.ready_transactions().collect::>();\n let info = self.backend.pending_block(transactions).await;\n self.backend.convert_block(info.block)\n }\n\n /// Returns the full pending block with `Transaction` objects\n async fn pending_block_full(&self) -> Option {\n let transactions = self.pool.ready_transactions().collect::>();\n let BlockInfo { block, transactions, receipts: _ } =\n self.backend.pending_block(transactions).await;\n\n let mut partial_block = self.backend.convert_block(block.clone());\n\n let mut block_transactions = Vec::with_capacity(block.body.transactions.len());\n let base_fee = self.backend.base_fee();\n\n for info in transactions {\n let tx = block.body.transactions.get(info.transaction_index as usize)?.clone();\n\n let tx = transaction_build(\n Some(info.transaction_hash),\n tx,\n Some(&block),\n Some(info),\n Some(base_fee),\n );\n block_transactions.push(tx);\n }\n\n partial_block.transactions = BlockTransactions::from(block_transactions);\n\n Some(partial_block)\n }\n\n /// Prepares transaction request by filling missing fields using Anvil's API, then attempts\n /// to build a [`FoundryTypedTx`].\n async fn build_tx_request(\n &self,\n request: WithOtherFields,\n nonce: u64,\n ) -> Result {\n let mut request = Into::::into(request);\n let from = request.from().or(self.accounts()?.first().copied());\n\n // Fill common fields for all tx types\n request.chain_id().is_none().then(|| request.set_chain_id(self.chain_id()));\n request.nonce().is_none().then(|| request.set_nonce(nonce));\n request.kind().is_none().then(|| request.set_kind(TxKind::default()));\n if request.gas_limit().is_none() {\n request.set_gas_limit(\n self.do_estimate_gas(\n request.as_ref().clone().into(),\n None,\n EvmOverrides::default(),\n )\n .await\n .map(|v| v as u64)\n .unwrap_or(self.backend.gas_limit()),\n );\n }\n\n // Fill missing tx type specific fields\n if let Err((tx_type, _)) = request.missing_keys() {\n if matches!(tx_type, FoundryTxType::Legacy | FoundryTxType::Eip2930) {\n request.gas_price().is_none().then(|| request.set_gas_price(self.gas_price()));\n }\n if tx_type == FoundryTxType::Eip2930 {\n request\n .access_list()\n .is_none()\n .then(|| request.set_access_list(Default::default()));\n }\n if matches!(\n tx_type,\n FoundryTxType::Eip1559 | FoundryTxType::Eip4844 | FoundryTxType::Eip7702\n ) {\n request\n .max_fee_per_gas()\n .is_none()\n .then(|| request.set_max_fee_per_gas(self.gas_price()));\n request\n .max_priority_fee_per_gas()\n .is_none()\n .then(|| request.set_max_priority_fee_per_gas(MIN_SUGGESTED_PRIORITY_FEE));\n }\n if tx_type == FoundryTxType::Eip4844 {\n request.as_ref().max_fee_per_blob_gas().is_none().then(|| {\n request.as_mut().set_max_fee_per_blob_gas(\n self.backend.fees().get_next_block_blob_base_fee_per_gas(),\n )\n });\n }\n }\n\n match request\n .build_unsigned()\n .map_err(|e| BlockchainError::InvalidTransactionRequest(e.to_string()))?\n {\n FoundryTypedTx::Eip4844(TxEip4844Variant::TxEip4844(_))\n if !self.backend.skip_blob_validation(from) =>\n {\n // If blob validation is not skipped, reject TxEip4844 variant without sidecar.\n Err(BlockchainError::FailedToDecodeTransaction)\n }\n res => Ok(res),\n }\n }\n\n /// Returns the nonce of the `address` depending on the `block_number`\n async fn get_transaction_count(\n &self,\n address: Address,\n block_number: Option,\n ) -> Result {\n let block_request = self.block_request(block_number).await?;\n\n if let BlockRequest::Number(number) = block_request\n && let Some(fork) = self.get_fork()\n && fork.predates_fork(number)\n {\n return Ok(fork.get_nonce(address, number).await?);\n }\n\n self.backend.get_nonce(address, block_request).await\n }\n\n /// Returns the nonce for this request\n ///\n /// This returns a tuple of `(request nonce, highest nonce)`\n /// If the nonce field of the `request` is `None` then the tuple will be `(highest nonce,\n /// highest nonce)`.\n ///\n /// This will also check the tx pool for pending transactions from the sender.\n async fn request_nonce(\n &self,\n request: &TransactionRequest,\n from: Address,\n ) -> Result<(u64, u64)> {\n let highest_nonce =\n self.get_transaction_count(from, Some(BlockId::Number(BlockNumber::Pending))).await?;\n let nonce = request.nonce.unwrap_or(highest_nonce);\n\n Ok((nonce, highest_nonce))\n }\n\n /// Adds the given transaction to the pool\n fn add_pending_transaction(\n &self,\n pending_transaction: PendingTransaction,\n requires: Vec,\n provides: Vec,\n ) -> Result {\n let from = *pending_transaction.sender();\n let priority = self.transaction_priority(&pending_transaction.transaction);\n let pool_transaction =\n PoolTransaction { requires, provides, pending_transaction, priority };\n let tx = self.pool.add_transaction(pool_transaction)?;\n trace!(target: \"node\", \"Added transaction: [{:?}] sender={:?}\", tx.hash(), from);\n Ok(*tx.hash())\n }\n\n /// additional validation against hardfork\n fn ensure_typed_transaction_supported(&self, tx: &FoundryTxEnvelope) -> Result<()> {\n match &tx {\n FoundryTxEnvelope::Eip2930(_) => self.backend.ensure_eip2930_active(),\n FoundryTxEnvelope::Eip1559(_) => self.backend.ensure_eip1559_active(),\n FoundryTxEnvelope::Eip4844(_) => self.backend.ensure_eip4844_active(),\n FoundryTxEnvelope::Eip7702(_) => self.backend.ensure_eip7702_active(),\n FoundryTxEnvelope::Deposit(_) => self.backend.ensure_op_deposits_active(),\n FoundryTxEnvelope::Legacy(_) => Ok(()),\n // TODO(onbjerg): we should impl support for Tempo transactions\n FoundryTxEnvelope::Tempo(_) => todo!(),\n }\n }\n}\n\nfn required_marker(provided_nonce: u64, on_chain_nonce: u64, from: Address) -> Vec {\n if provided_nonce == on_chain_nonce {\n return Vec::new();\n }\n let prev_nonce = provided_nonce.saturating_sub(1);\n if on_chain_nonce <= prev_nonce { vec![to_marker(prev_nonce, from)] } else { Vec::new() }\n}\n\nfn convert_transact_out(out: &Option) -> Bytes {\n match out {\n None => Default::default(),\n Some(Output::Call(out)) => out.to_vec().into(),\n Some(Output::Create(out, _)) => out.to_vec().into(),\n }\n}\n\n/// Returns an error if the `exit` code is _not_ ok\nfn ensure_return_ok(exit: InstructionResult, out: &Option) -> Result {\n let out = convert_transact_out(out);\n match exit {\n return_ok!() => Ok(out),\n return_revert!() => Err(InvalidTransactionError::Revert(Some(out)).into()),\n reason => Err(BlockchainError::EvmError(reason)),\n }\n}\n\n/// Determines the minimum gas needed for a transaction depending on the transaction kind.\nfn determine_base_gas_by_kind(request: &WithOtherFields) -> u128 {\n match request.kind() {\n Some(TxKind::Call(_)) => {\n MIN_TRANSACTION_GAS\n + request.inner().authorization_list.as_ref().map_or(0, |auths_list| {\n auths_list.len() as u128 * PER_EMPTY_ACCOUNT_COST as u128\n })\n }\n Some(TxKind::Create) => MIN_CREATE_GAS,\n // Tighten the gas limit upwards if we don't know the tx kind to avoid deployments failing.\n None => MIN_CREATE_GAS,\n }\n}\n\n/// Keeps result of a call to revm EVM used for gas estimation\nenum GasEstimationCallResult {\n Success(u128),\n OutOfGas,\n Revert(Option),\n EvmError(InstructionResult),\n}\n\n/// Converts the result of a call to revm EVM into a [`GasEstimationCallResult`].\n///\n/// Expected to stay up to date with: \nimpl TryFrom, u128, State)>> for GasEstimationCallResult {\n type Error = BlockchainError;\n\n fn try_from(res: Result<(InstructionResult, Option, u128, State)>) -> Result {\n match res {\n // Exceptional case: init used too much gas, treated as out of gas error\n Err(BlockchainError::InvalidTransaction(InvalidTransactionError::GasTooHigh(_))) => {\n Ok(Self::OutOfGas)\n }\n Err(err) => Err(err),\n Ok((exit, output, gas, _)) => match exit {\n return_ok!() => Ok(Self::Success(gas)),\n\n // Revert opcodes:\n InstructionResult::Revert => Ok(Self::Revert(output.map(|o| o.into_data()))),\n InstructionResult::CallTooDeep\n | InstructionResult::OutOfFunds\n | InstructionResult::CreateInitCodeStartingEF00\n | InstructionResult::InvalidEOFInitCode\n | InstructionResult::InvalidExtDelegateCallTarget => Ok(Self::EvmError(exit)),\n\n // Out of gas errors:\n InstructionResult::OutOfGas\n | InstructionResult::MemoryOOG\n | InstructionResult::MemoryLimitOOG\n | InstructionResult::PrecompileOOG\n | InstructionResult::InvalidOperandOOG\n | InstructionResult::ReentrancySentryOOG => Ok(Self::OutOfGas),\n\n // Other errors:\n InstructionResult::OpcodeNotFound\n | InstructionResult::CallNotAllowedInsideStatic\n | InstructionResult::StateChangeDuringStaticCall\n | InstructionResult::InvalidFEOpcode\n | InstructionResult::InvalidJump\n | InstructionResult::NotActivated\n | InstructionResult::StackUnderflow\n | InstructionResult::StackOverflow\n | InstructionResult::OutOfOffset\n | InstructionResult::CreateCollision\n | InstructionResult::OverflowPayment\n | InstructionResult::PrecompileError\n | InstructionResult::NonceOverflow\n | InstructionResult::CreateContractSizeLimit\n | InstructionResult::CreateContractStartingWithEF\n | InstructionResult::CreateInitCodeSizeLimit\n | InstructionResult::FatalExternalError => Ok(Self::EvmError(exit)),\n },\n }\n }\n}\n" }, { "path": "crates/anvil/src/eth/backend/cheats.rs", "content": "//! Support for \"cheat codes\" / bypass functions\n\nuse alloy_evm::precompiles::{Precompile, PrecompileInput};\nuse alloy_primitives::{\n Address, Bytes,\n map::{AddressHashSet, foldhash::HashMap},\n};\nuse parking_lot::RwLock;\nuse revm::precompile::{\n PrecompileError, PrecompileId, PrecompileOutput, PrecompileResult, secp256k1::ec_recover_run,\n utilities::right_pad,\n};\nuse std::{borrow::Cow, sync::Arc};\n\n/// ID for the [`CheatEcrecover::precompile_id`] precompile.\nstatic PRECOMPILE_ID_CHEAT_ECRECOVER: PrecompileId =\n PrecompileId::Custom(Cow::Borrowed(\"cheat_ecrecover\"));\n\n/// Manages user modifications that may affect the node's behavior\n///\n/// Contains the state of executed, non-eth standard cheat code RPC\n#[derive(Clone, Debug, Default)]\npub struct CheatsManager {\n /// shareable state\n state: Arc>,\n}\n\nimpl CheatsManager {\n /// Sets the account to impersonate\n ///\n /// Returns `true` if the account is already impersonated\n pub fn impersonate(&self, addr: Address) -> bool {\n trace!(target: \"cheats\", %addr, \"start impersonating\");\n // When somebody **explicitly** impersonates an account we need to store it so we are able\n // to return it from `eth_accounts`. That's why we do not simply call `is_impersonated()`\n // which does not check that list when auto impersonation is enabled.\n !self.state.write().impersonated_accounts.insert(addr)\n }\n\n /// Removes the account that from the impersonated set\n pub fn stop_impersonating(&self, addr: &Address) {\n trace!(target: \"cheats\", %addr, \"stop impersonating\");\n self.state.write().impersonated_accounts.remove(addr);\n }\n\n /// Returns true if the `addr` is currently impersonated\n pub fn is_impersonated(&self, addr: Address) -> bool {\n if self.auto_impersonate_accounts() {\n true\n } else {\n self.state.read().impersonated_accounts.contains(&addr)\n }\n }\n\n /// Returns true is auto impersonation is enabled\n pub fn auto_impersonate_accounts(&self) -> bool {\n self.state.read().auto_impersonate_accounts\n }\n\n /// Sets the auto impersonation flag which if set to true will make the `is_impersonated`\n /// function always return true\n pub fn set_auto_impersonate_account(&self, enabled: bool) {\n trace!(target: \"cheats\", \"Auto impersonation set to {:?}\", enabled);\n self.state.write().auto_impersonate_accounts = enabled\n }\n\n /// Returns all accounts that are currently being impersonated.\n pub fn impersonated_accounts(&self) -> AddressHashSet {\n self.state.read().impersonated_accounts.clone()\n }\n\n /// Registers an override so that `ecrecover(signature)` returns `addr`.\n pub fn add_recover_override(&self, sig: Bytes, addr: Address) {\n self.state.write().signature_overrides.insert(sig, addr);\n }\n\n /// If an override exists for `sig`, returns the address; otherwise `None`.\n pub fn get_recover_override(&self, sig: &Bytes) -> Option
{\n self.state.read().signature_overrides.get(sig).copied()\n }\n\n /// Returns true if any ecrecover overrides have been registered.\n pub fn has_recover_overrides(&self) -> bool {\n !self.state.read().signature_overrides.is_empty()\n }\n}\n\n/// Container type for all the state variables\n#[derive(Clone, Debug, Default)]\npub struct CheatsState {\n /// All accounts that are currently impersonated\n pub impersonated_accounts: AddressHashSet,\n /// If set to true will make the `is_impersonated` function always return true\n pub auto_impersonate_accounts: bool,\n /// Overrides for ecrecover: Signature => Address\n pub signature_overrides: HashMap,\n}\n\nimpl CheatEcrecover {\n pub fn new(cheats: Arc) -> Self {\n Self { cheats }\n }\n}\n\nimpl Precompile for CheatEcrecover {\n fn call(&self, input: PrecompileInput<'_>) -> PrecompileResult {\n if !self.cheats.has_recover_overrides() {\n return ec_recover_run(input.data, input.gas);\n }\n\n const ECRECOVER_BASE: u64 = 3_000;\n if input.gas < ECRECOVER_BASE {\n return Err(PrecompileError::OutOfGas);\n }\n let padded = right_pad::<128>(input.data);\n let v = padded[63];\n let mut sig_bytes = [0u8; 65];\n sig_bytes[..64].copy_from_slice(&padded[64..128]);\n sig_bytes[64] = v;\n let sig_bytes_wrapped = Bytes::copy_from_slice(&sig_bytes);\n if let Some(addr) = self.cheats.get_recover_override(&sig_bytes_wrapped) {\n let mut out = [0u8; 32];\n out[12..].copy_from_slice(addr.as_slice());\n return Ok(PrecompileOutput::new(ECRECOVER_BASE, Bytes::copy_from_slice(&out)));\n }\n ec_recover_run(input.data, input.gas)\n }\n\n fn precompile_id(&self) -> &PrecompileId {\n &PRECOMPILE_ID_CHEAT_ECRECOVER\n }\n\n fn supports_caching(&self) -> bool {\n false\n }\n}\n\n/// A custom ecrecover precompile that supports cheat-based signature overrides.\n#[derive(Clone, Debug)]\npub struct CheatEcrecover {\n cheats: Arc,\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n\n #[test]\n fn impersonate_returns_false_then_true() {\n let mgr = CheatsManager::default();\n let addr = Address::from([1u8; 20]);\n assert!(!mgr.impersonate(addr));\n assert!(mgr.impersonate(addr));\n }\n}\n" }, { "path": "crates/anvil/src/eth/backend/db.rs", "content": "//! Helper types for working with [revm](foundry_evm::revm)\n\nuse std::{\n collections::BTreeMap,\n fmt::{self, Debug},\n path::Path,\n};\n\nuse alloy_consensus::{BlockBody, Header};\nuse alloy_eips::eip4895::Withdrawals;\nuse alloy_evm::block::StateDB;\nuse alloy_primitives::{\n Address, B256, Bytes, U256, keccak256,\n map::{AddressMap, HashMap},\n};\nuse alloy_rpc_types::BlockId;\nuse anvil_core::eth::{\n block::Block,\n transaction::{MaybeImpersonatedTransaction, TransactionInfo},\n};\nuse foundry_common::errors::FsPathError;\nuse foundry_evm::backend::{\n BlockchainDb, DatabaseError, DatabaseResult, MemDb, RevertStateSnapshotAction, StateSnapshot,\n};\nuse foundry_primitives::{FoundryNetwork, FoundryReceiptEnvelope, FoundryTxEnvelope};\nuse revm::{\n Database, DatabaseCommit,\n bytecode::Bytecode,\n context::BlockEnv,\n context_interface::block::BlobExcessGasAndPrice,\n database::{CacheDB, DatabaseRef, DbAccount},\n primitives::{KECCAK_EMPTY, eip4844::BLOB_BASE_FEE_UPDATE_FRACTION_PRAGUE},\n state::AccountInfo,\n};\nuse serde::{\n Deserialize, Deserializer, Serialize,\n de::{Error as DeError, MapAccess, Visitor},\n};\nuse serde_json::Value;\n\nuse crate::mem::storage::MinedTransaction;\n\n/// Helper trait get access to the full state data of the database\npub trait MaybeFullDatabase: DatabaseRef + Debug {\n fn maybe_as_full_db(&self) -> Option<&AddressMap> {\n None\n }\n\n /// Clear the state and move it into a new `StateSnapshot`.\n fn clear_into_state_snapshot(&mut self) -> StateSnapshot;\n\n /// Read the state snapshot.\n ///\n /// This clones all the states and returns a new `StateSnapshot`.\n fn read_as_state_snapshot(&self) -> StateSnapshot;\n\n /// Clears the entire database\n fn clear(&mut self);\n\n /// Reverses `clear_into_snapshot` by initializing the db's state with the state snapshot.\n fn init_from_state_snapshot(&mut self, state_snapshot: StateSnapshot);\n}\n\nimpl<'a, T: 'a + MaybeFullDatabase + ?Sized> MaybeFullDatabase for &'a T\nwhere\n &'a T: DatabaseRef,\n{\n fn maybe_as_full_db(&self) -> Option<&AddressMap> {\n T::maybe_as_full_db(self)\n }\n\n fn clear_into_state_snapshot(&mut self) -> StateSnapshot {\n unreachable!(\"never called for DatabaseRef\")\n }\n\n fn read_as_state_snapshot(&self) -> StateSnapshot {\n unreachable!(\"never called for DatabaseRef\")\n }\n\n fn clear(&mut self) {}\n\n fn init_from_state_snapshot(&mut self, _state_snapshot: StateSnapshot) {}\n}\n\n/// Helper trait to reset the DB if it's forked\npub trait MaybeForkedDatabase {\n fn maybe_reset(&mut self, _url: Option, block_number: BlockId) -> Result<(), String>;\n\n fn maybe_flush_cache(&self) -> Result<(), String>;\n\n fn maybe_inner(&self) -> Result<&BlockchainDb, String>;\n}\n\n/// `dyn Db` satisfies all `alloy_evm::Database` requirements via its supertraits, but the\n/// blanket impl has an implicit `Sized` bound. Provide an explicit impl.\nimpl alloy_evm::Database for dyn Db {}\n\nimpl StateDB for dyn Db {\n fn set_state_clear_flag(&mut self, _has_state_clear: bool) {\n // Anvil does not use the revm State wrapper, so this is a no-op.\n }\n}\n\n/// A wrapper around [`CacheDB`] that implements [`StateDB`].\n///\n/// `StateDB` is a foreign trait with an orphan-rule constraint, so we cannot\n/// implement it directly for `CacheDB`. This newtype sidesteps the orphan\n/// rule while delegating all [`Database`], [`DatabaseCommit`] and\n/// [`DatabaseRef`] calls to the inner `CacheDB`.\n#[derive(Debug)]\npub struct AnvilCacheDB(pub CacheDB);\n\nimpl> AnvilCacheDB {\n pub fn new(inner: T) -> Self {\n Self(CacheDB::new(inner))\n }\n}\n\nimpl> std::ops::Deref for AnvilCacheDB {\n type Target = CacheDB;\n fn deref(&self) -> &Self::Target {\n &self.0\n }\n}\n\nimpl> std::ops::DerefMut for AnvilCacheDB {\n fn deref_mut(&mut self) -> &mut Self::Target {\n &mut self.0\n }\n}\n\nimpl + fmt::Debug> Database for AnvilCacheDB {\n type Error = DatabaseError;\n\n fn basic(&mut self, address: Address) -> Result, Self::Error> {\n self.0.basic(address)\n }\n\n fn code_by_hash(&mut self, code_hash: B256) -> Result {\n self.0.code_by_hash(code_hash)\n }\n\n fn storage(&mut self, address: Address, index: U256) -> Result {\n self.0.storage(address, index)\n }\n\n fn block_hash(&mut self, number: u64) -> Result {\n self.0.block_hash(number)\n }\n}\n\nimpl> DatabaseRef for AnvilCacheDB {\n type Error = DatabaseError;\n\n fn basic_ref(&self, address: Address) -> Result, Self::Error> {\n self.0.basic_ref(address)\n }\n\n fn code_by_hash_ref(&self, code_hash: B256) -> Result {\n self.0.code_by_hash_ref(code_hash)\n }\n\n fn storage_ref(&self, address: Address, index: U256) -> Result {\n self.0.storage_ref(address, index)\n }\n\n fn block_hash_ref(&self, number: u64) -> Result {\n self.0.block_hash_ref(number)\n }\n}\n\nimpl + fmt::Debug> DatabaseCommit for AnvilCacheDB {\n fn commit(&mut self, changes: revm::state::EvmState) {\n self.0.commit(changes)\n }\n}\n\nimpl + fmt::Debug> StateDB for AnvilCacheDB {\n fn set_state_clear_flag(&mut self, _has_state_clear: bool) {\n // Anvil does not use the revm State wrapper, so this is a no-op.\n }\n}\n\n/// This bundles all required revm traits\npub trait Db:\n DatabaseRef\n + Database\n + DatabaseCommit\n + MaybeFullDatabase\n + MaybeForkedDatabase\n + fmt::Debug\n + Send\n + Sync\n{\n /// Inserts an account\n fn insert_account(&mut self, address: Address, account: AccountInfo);\n\n /// Sets the nonce of the given address\n fn set_nonce(&mut self, address: Address, nonce: u64) -> DatabaseResult<()> {\n let mut info = self.basic(address)?.unwrap_or_default();\n info.nonce = nonce;\n self.insert_account(address, info);\n Ok(())\n }\n\n /// Sets the balance of the given address\n fn set_balance(&mut self, address: Address, balance: U256) -> DatabaseResult<()> {\n let mut info = self.basic(address)?.unwrap_or_default();\n info.balance = balance;\n self.insert_account(address, info);\n Ok(())\n }\n\n /// Sets the code of the given address\n fn set_code(&mut self, address: Address, code: Bytes) -> DatabaseResult<()> {\n let mut info = self.basic(address)?.unwrap_or_default();\n let code_hash = if code.as_ref().is_empty() {\n KECCAK_EMPTY\n } else {\n B256::from_slice(&keccak256(code.as_ref())[..])\n };\n info.code_hash = code_hash;\n info.code = Some(Bytecode::new_raw(alloy_primitives::Bytes(code.0)));\n self.insert_account(address, info);\n Ok(())\n }\n\n /// Sets the storage value at the given slot for the address\n fn set_storage_at(&mut self, address: Address, slot: B256, val: B256) -> DatabaseResult<()>;\n\n /// inserts a blockhash for the given number\n fn insert_block_hash(&mut self, number: U256, hash: B256);\n\n /// Write all chain data to serialized bytes buffer\n fn dump_state(\n &self,\n at: BlockEnv,\n best_number: u64,\n blocks: Vec,\n transactions: Vec,\n historical_states: Option,\n ) -> DatabaseResult>;\n\n /// Deserialize and add all chain data to the backend storage\n fn load_state(&mut self, state: SerializableState) -> DatabaseResult {\n for (addr, account) in state.accounts.into_iter() {\n let old_account_nonce = DatabaseRef::basic_ref(self, addr)\n .ok()\n .and_then(|acc| acc.map(|acc| acc.nonce))\n .unwrap_or_default();\n // use max nonce in case account is imported multiple times with difference\n // nonces to prevent collisions\n let nonce = std::cmp::max(old_account_nonce, account.nonce);\n\n self.insert_account(\n addr,\n AccountInfo {\n balance: account.balance,\n code_hash: KECCAK_EMPTY, // will be set automatically\n code: if account.code.0.is_empty() {\n None\n } else {\n Some(Bytecode::new_raw(alloy_primitives::Bytes(account.code.0)))\n },\n nonce,\n account_id: None,\n },\n );\n\n for (k, v) in account.storage.into_iter() {\n self.set_storage_at(addr, k, v)?;\n }\n }\n Ok(true)\n }\n\n /// Creates a new state snapshot.\n fn snapshot_state(&mut self) -> U256;\n\n /// Reverts a state snapshot.\n ///\n /// Returns `true` if the state snapshot was reverted.\n fn revert_state(&mut self, state_snapshot: U256, action: RevertStateSnapshotAction) -> bool;\n\n /// Returns the state root if possible to compute\n fn maybe_state_root(&self) -> Option {\n None\n }\n\n /// Returns the current, standalone state of the Db\n fn current_state(&self) -> StateDb;\n}\n\n/// Convenience impl only used to use any `Db` on the fly as the db layer for revm's CacheDB\n/// This is useful to create blocks without actually writing to the `Db`, but rather in the cache of\n/// the `CacheDB` see also\n/// [Backend::pending_block()](crate::eth::backend::mem::Backend::pending_block())\nimpl + Send + Sync + Clone + fmt::Debug> Db for CacheDB {\n fn insert_account(&mut self, address: Address, account: AccountInfo) {\n self.insert_account_info(address, account)\n }\n\n fn set_storage_at(&mut self, address: Address, slot: B256, val: B256) -> DatabaseResult<()> {\n self.insert_account_storage(address, slot.into(), val.into())\n }\n\n fn insert_block_hash(&mut self, number: U256, hash: B256) {\n self.cache.block_hashes.insert(number, hash);\n }\n\n fn dump_state(\n &self,\n _at: BlockEnv,\n _best_number: u64,\n _blocks: Vec,\n _transaction: Vec,\n _historical_states: Option,\n ) -> DatabaseResult> {\n Ok(None)\n }\n\n fn snapshot_state(&mut self) -> U256 {\n U256::ZERO\n }\n\n fn revert_state(&mut self, _state_snapshot: U256, _action: RevertStateSnapshotAction) -> bool {\n false\n }\n\n fn current_state(&self) -> StateDb {\n StateDb::new(MemDb::default())\n }\n}\n\nimpl + Debug> MaybeFullDatabase for CacheDB {\n fn maybe_as_full_db(&self) -> Option<&AddressMap> {\n Some(&self.cache.accounts)\n }\n\n fn clear_into_state_snapshot(&mut self) -> StateSnapshot {\n let db_accounts = std::mem::take(&mut self.cache.accounts);\n let mut accounts = HashMap::default();\n let mut account_storage = HashMap::default();\n\n for (addr, mut acc) in db_accounts {\n account_storage.insert(addr, std::mem::take(&mut acc.storage));\n let mut info = acc.info;\n info.code = self.cache.contracts.remove(&info.code_hash);\n accounts.insert(addr, info);\n }\n let block_hashes = std::mem::take(&mut self.cache.block_hashes);\n StateSnapshot { accounts, storage: account_storage, block_hashes }\n }\n\n fn read_as_state_snapshot(&self) -> StateSnapshot {\n let mut accounts = HashMap::default();\n let mut account_storage = HashMap::default();\n\n for (addr, acc) in &self.cache.accounts {\n account_storage.insert(*addr, acc.storage.clone());\n let mut info = acc.info.clone();\n info.code = self.cache.contracts.get(&info.code_hash).cloned();\n accounts.insert(*addr, info);\n }\n\n let block_hashes = self.cache.block_hashes.clone();\n StateSnapshot { accounts, storage: account_storage, block_hashes }\n }\n\n fn clear(&mut self) {\n self.clear_into_state_snapshot();\n }\n\n fn init_from_state_snapshot(&mut self, state_snapshot: StateSnapshot) {\n let StateSnapshot { accounts, mut storage, block_hashes } = state_snapshot;\n\n for (addr, mut acc) in accounts {\n if let Some(code) = acc.code.take() {\n self.cache.contracts.insert(acc.code_hash, code);\n }\n self.cache.accounts.insert(\n addr,\n DbAccount {\n info: acc,\n storage: storage.remove(&addr).unwrap_or_default(),\n ..Default::default()\n },\n );\n }\n self.cache.block_hashes = block_hashes;\n }\n}\n\nimpl> MaybeForkedDatabase for CacheDB {\n fn maybe_reset(&mut self, _url: Option, _block_number: BlockId) -> Result<(), String> {\n Err(\"not supported\".to_string())\n }\n\n fn maybe_flush_cache(&self) -> Result<(), String> {\n Err(\"not supported\".to_string())\n }\n\n fn maybe_inner(&self) -> Result<&BlockchainDb, String> {\n Err(\"not supported\".to_string())\n }\n}\n\n/// Represents a state at certain point\n#[derive(Debug)]\npub struct StateDb(pub(crate) Box);\n\nimpl StateDb {\n pub fn new(db: impl MaybeFullDatabase + Send + Sync + 'static) -> Self {\n Self(Box::new(db))\n }\n\n pub fn serialize_state(&mut self) -> StateSnapshot {\n // Using read_as_snapshot makes sures we don't clear the historical state from the current\n // instance.\n self.read_as_state_snapshot()\n }\n}\n\nimpl DatabaseRef for StateDb {\n type Error = DatabaseError;\n fn basic_ref(&self, address: Address) -> DatabaseResult> {\n self.0.basic_ref(address)\n }\n\n fn code_by_hash_ref(&self, code_hash: B256) -> DatabaseResult {\n self.0.code_by_hash_ref(code_hash)\n }\n\n fn storage_ref(&self, address: Address, index: U256) -> DatabaseResult {\n self.0.storage_ref(address, index)\n }\n\n fn block_hash_ref(&self, number: u64) -> DatabaseResult {\n self.0.block_hash_ref(number)\n }\n}\n\nimpl MaybeFullDatabase for StateDb {\n fn maybe_as_full_db(&self) -> Option<&AddressMap> {\n self.0.maybe_as_full_db()\n }\n\n fn clear_into_state_snapshot(&mut self) -> StateSnapshot {\n self.0.clear_into_state_snapshot()\n }\n\n fn read_as_state_snapshot(&self) -> StateSnapshot {\n self.0.read_as_state_snapshot()\n }\n\n fn clear(&mut self) {\n self.0.clear()\n }\n\n fn init_from_state_snapshot(&mut self, state_snapshot: StateSnapshot) {\n self.0.init_from_state_snapshot(state_snapshot)\n }\n}\n\n/// Legacy block environment from before v1.3.\n#[derive(Debug, Deserialize)]\n#[serde(rename_all = \"snake_case\")]\npub struct LegacyBlockEnv {\n pub number: Option,\n #[serde(alias = \"coinbase\")]\n pub beneficiary: Option
,\n pub timestamp: Option,\n pub gas_limit: Option,\n pub basefee: Option,\n pub difficulty: Option,\n pub prevrandao: Option,\n pub blob_excess_gas_and_price: Option,\n}\n\n/// Legacy blob excess gas and price structure from before v1.3.\n#[derive(Debug, Deserialize)]\npub struct LegacyBlobExcessGasAndPrice {\n pub excess_blob_gas: u64,\n pub blob_gasprice: u64,\n}\n\n/// Legacy string or u64 type from before v1.3.\n#[derive(Debug, Deserialize)]\n#[serde(untagged)]\npub enum StringOrU64 {\n Hex(String),\n Dec(u64),\n}\n\nimpl StringOrU64 {\n pub fn to_u64(&self) -> Option {\n match self {\n Self::Dec(n) => Some(*n),\n Self::Hex(s) => s.strip_prefix(\"0x\").and_then(|s| u64::from_str_radix(s, 16).ok()),\n }\n }\n\n pub fn to_u256(&self) -> Option {\n match self {\n Self::Dec(n) => Some(U256::from(*n)),\n Self::Hex(s) => s.strip_prefix(\"0x\").and_then(|s| U256::from_str_radix(s, 16).ok()),\n }\n }\n}\n\n/// Converts a `LegacyBlockEnv` to a `BlockEnv`, handling the conversion of legacy fields.\nimpl TryFrom for BlockEnv {\n type Error = &'static str;\n\n fn try_from(legacy: LegacyBlockEnv) -> Result {\n Ok(Self {\n number: legacy.number.and_then(|v| v.to_u256()).unwrap_or(U256::ZERO),\n beneficiary: legacy.beneficiary.unwrap_or(Address::ZERO),\n timestamp: legacy.timestamp.and_then(|v| v.to_u256()).unwrap_or(U256::ONE),\n gas_limit: legacy.gas_limit.and_then(|v| v.to_u64()).unwrap_or(u64::MAX),\n basefee: legacy.basefee.and_then(|v| v.to_u64()).unwrap_or(0),\n difficulty: legacy.difficulty.and_then(|v| v.to_u256()).unwrap_or(U256::ZERO),\n prevrandao: legacy.prevrandao.or(Some(B256::ZERO)),\n blob_excess_gas_and_price: legacy\n .blob_excess_gas_and_price\n .map(|v| BlobExcessGasAndPrice::new(v.excess_blob_gas, v.blob_gasprice))\n .or_else(|| {\n Some(BlobExcessGasAndPrice::new(0, BLOB_BASE_FEE_UPDATE_FRACTION_PRAGUE))\n }),\n })\n }\n}\n\n/// Custom deserializer for `BlockEnv` that handles both v1.2 and v1.3+ formats.\nfn deserialize_block_env_compat<'de, D>(deserializer: D) -> Result, D::Error>\nwhere\n D: Deserializer<'de>,\n{\n let value: Option = Option::deserialize(deserializer)?;\n let Some(value) = value else {\n return Ok(None);\n };\n\n if let Ok(env) = BlockEnv::deserialize(&value) {\n return Ok(Some(env));\n }\n\n let legacy: LegacyBlockEnv = serde_json::from_value(value).map_err(|e| {\n D::Error::custom(format!(\"Legacy deserialization of `BlockEnv` failed: {e}\"))\n })?;\n\n Ok(Some(BlockEnv::try_from(legacy).map_err(D::Error::custom)?))\n}\n\n/// Custom deserializer for `best_block_number` that handles both v1.2 and v1.3+ formats.\nfn deserialize_best_block_number_compat<'de, D>(deserializer: D) -> Result, D::Error>\nwhere\n D: Deserializer<'de>,\n{\n let value: Option = Option::deserialize(deserializer)?;\n let Some(value) = value else {\n return Ok(None);\n };\n\n let number = match value {\n Value::Number(n) => n.as_u64(),\n Value::String(s) => {\n if let Some(s) = s.strip_prefix(\"0x\") {\n u64::from_str_radix(s, 16).ok()\n } else {\n s.parse().ok()\n }\n }\n _ => None,\n };\n\n Ok(number)\n}\n\n#[derive(Clone, Debug, Default, Serialize, Deserialize)]\npub struct SerializableState {\n /// The block number of the state\n ///\n /// Note: This is an Option for backwards compatibility: \n #[serde(deserialize_with = \"deserialize_block_env_compat\")]\n pub block: Option,\n pub accounts: BTreeMap,\n /// The best block number of the state, can be different from block number (Arbitrum chain).\n #[serde(deserialize_with = \"deserialize_best_block_number_compat\")]\n pub best_block_number: Option,\n #[serde(default)]\n pub blocks: Vec,\n #[serde(default)]\n pub transactions: Vec,\n /// Historical states of accounts and storage at particular block hashes.\n ///\n /// Note: This is an Option for backwards compatibility.\n #[serde(default)]\n pub historical_states: Option,\n}\n\nimpl SerializableState {\n /// Loads the `Genesis` object from the given json file path\n pub fn load(path: impl AsRef) -> Result {\n let path = path.as_ref();\n if path.is_dir() {\n foundry_common::fs::read_json_file(&path.join(\"state.json\"))\n } else {\n foundry_common::fs::read_json_file(path)\n }\n }\n\n /// This is used as the clap `value_parser` implementation\n #[cfg(feature = \"cmd\")]\n pub(crate) fn parse(path: &str) -> Result {\n Self::load(path).map_err(|err| err.to_string())\n }\n}\n\n#[derive(Clone, Debug, Serialize, Deserialize)]\npub struct SerializableAccountRecord {\n pub nonce: u64,\n pub balance: U256,\n pub code: Bytes,\n\n #[serde(deserialize_with = \"deserialize_btree\")]\n pub storage: BTreeMap,\n}\n\nfn deserialize_btree<'de, D>(deserializer: D) -> Result, D::Error>\nwhere\n D: Deserializer<'de>,\n{\n struct BTreeVisitor;\n\n impl<'de> Visitor<'de> for BTreeVisitor {\n type Value = BTreeMap;\n\n fn expecting(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {\n formatter.write_str(\"a mapping of hex encoded storage slots to hex encoded state data\")\n }\n\n fn visit_map(self, mut mapping: M) -> Result, M::Error>\n where\n M: MapAccess<'de>,\n {\n let mut btree = BTreeMap::new();\n while let Some((key, value)) = mapping.next_entry::()? {\n btree.insert(B256::from(key), B256::from(value));\n }\n\n Ok(btree)\n }\n }\n\n deserializer.deserialize_map(BTreeVisitor)\n}\n\n/// Defines a backwards-compatible enum for transactions.\n/// This is essential for maintaining compatibility with state dumps\n/// created before the changes introduced in PR #8411.\n///\n/// The enum can represent either a `TypedTransaction` or a `MaybeImpersonatedTransaction`,\n/// depending on the data being deserialized. This flexibility ensures that older state\n/// dumps can still be loaded correctly, even after the changes in #8411.\n#[derive(Clone, Debug, Serialize, Deserialize)]\n#[serde(untagged)]\npub enum SerializableTransactionType {\n TypedTransaction(FoundryTxEnvelope),\n MaybeImpersonatedTransaction(MaybeImpersonatedTransaction),\n}\n\n#[derive(Clone, Debug, Serialize, Deserialize)]\npub struct SerializableBlock {\n pub header: Header,\n pub transactions: Vec,\n pub ommers: Vec
,\n #[serde(default)]\n pub withdrawals: Option,\n}\n\nimpl From for SerializableBlock {\n fn from(block: Block) -> Self {\n Self {\n header: block.header,\n transactions: block.body.transactions.into_iter().map(Into::into).collect(),\n ommers: block.body.ommers.into_iter().collect(),\n withdrawals: block.body.withdrawals,\n }\n }\n}\n\nimpl From for Block {\n fn from(block: SerializableBlock) -> Self {\n let transactions = block.transactions.into_iter().map(Into::into).collect();\n let ommers = block.ommers;\n let body = BlockBody { transactions, ommers, withdrawals: block.withdrawals };\n Self::new(block.header, body)\n }\n}\n\nimpl From> for SerializableTransactionType {\n fn from(transaction: MaybeImpersonatedTransaction) -> Self {\n Self::MaybeImpersonatedTransaction(transaction)\n }\n}\n\nimpl From for MaybeImpersonatedTransaction {\n fn from(transaction: SerializableTransactionType) -> Self {\n match transaction {\n SerializableTransactionType::TypedTransaction(tx) => Self::new(tx),\n SerializableTransactionType::MaybeImpersonatedTransaction(tx) => tx,\n }\n }\n}\n\n#[derive(Clone, Debug, Serialize, Deserialize)]\npub struct SerializableTransaction {\n pub info: TransactionInfo,\n pub receipt: FoundryReceiptEnvelope,\n pub block_hash: B256,\n pub block_number: u64,\n}\n\nimpl From> for SerializableTransaction {\n fn from(transaction: MinedTransaction) -> Self {\n Self {\n info: transaction.info,\n receipt: transaction.receipt,\n block_hash: transaction.block_hash,\n block_number: transaction.block_number,\n }\n }\n}\n\nimpl From for MinedTransaction {\n fn from(transaction: SerializableTransaction) -> Self {\n Self {\n info: transaction.info,\n receipt: transaction.receipt,\n block_hash: transaction.block_hash,\n block_number: transaction.block_number,\n }\n }\n}\n\n#[derive(Clone, Debug, Serialize, Deserialize, Default)]\npub struct SerializableHistoricalStates(Vec<(B256, StateSnapshot)>);\n\nimpl SerializableHistoricalStates {\n pub const fn new(states: Vec<(B256, StateSnapshot)>) -> Self {\n Self(states)\n }\n}\n\nimpl IntoIterator for SerializableHistoricalStates {\n type Item = (B256, StateSnapshot);\n type IntoIter = std::vec::IntoIter;\n\n fn into_iter(self) -> Self::IntoIter {\n self.0.into_iter()\n }\n}\n\n#[cfg(test)]\nmod test {\n use super::*;\n\n #[test]\n fn test_deser_block() {\n let block = r#\"{\n \"header\": {\n \"parentHash\": \"0xceb0fe420d6f14a8eeec4319515b89acbb0bb4861cad9983d529ab4b1e4af929\",\n \"sha3Uncles\": \"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\n \"miner\": \"0x0000000000000000000000000000000000000000\",\n \"stateRoot\": \"0xe1423fd180478ab4fd05a7103277d64496b15eb914ecafe71eeec871b552efd1\",\n \"transactionsRoot\": \"0x2b5598ef261e5f88e4303bb2b3986b3d5c0ebf4cd9977daebccae82a6469b988\",\n \"receiptsRoot\": \"0xf78dfb743fbd92ade140711c8bbc542b5e307f0ab7984eff35d751969fe57efa\",\n \"logsBloom\": \"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\n \"difficulty\": \"0x0\",\n \"number\": \"0x2\",\n \"gasLimit\": \"0x1c9c380\",\n \"gasUsed\": \"0x5208\",\n \"timestamp\": \"0x66cdc823\",\n \"mixHash\": \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"nonce\": \"0x0000000000000000\",\n \"baseFeePerGas\": \"0x342a1c58\",\n \"blobGasUsed\": \"0x0\",\n \"excessBlobGas\": \"0x0\",\n \"extraData\": \"0x\"\n },\n \"transactions\": [\n {\n \"type\": \"0x2\",\n \"chainId\": \"0x7a69\",\n \"nonce\": \"0x0\",\n \"gas\": \"0x5209\",\n \"maxFeePerGas\": \"0x77359401\",\n \"maxPriorityFeePerGas\": \"0x1\",\n \"to\": \"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\",\n \"value\": \"0x0\",\n \"accessList\": [],\n \"input\": \"0x\",\n \"r\": \"0x85c2794a580da137e24ccc823b45ae5cea99371ae23ee13860fcc6935f8305b0\",\n \"s\": \"0x41de7fa4121dab284af4453d30928241208bafa90cdb701fe9bc7054759fe3cd\",\n \"yParity\": \"0x0\",\n \"hash\": \"0x8c9b68e8947ace33028dba167354fde369ed7bbe34911b772d09b3c64b861515\"\n }\n ],\n \"ommers\": []\n }\n \"#;\n\n let _block: SerializableBlock = serde_json::from_str(block).unwrap();\n }\n\n #[test]\n fn test_block_withdrawals_preserved() {\n use alloy_eips::eip4895::Withdrawal;\n\n // create a block with withdrawals (like post-Shanghai blocks)\n let withdrawal = Withdrawal {\n index: 42,\n validator_index: 123,\n address: Address::repeat_byte(1),\n amount: 1000,\n };\n\n let header = Header::default();\n let body = BlockBody {\n transactions: vec![],\n ommers: vec![],\n withdrawals: Some(vec![withdrawal].into()),\n };\n let block = Block::new(header, body);\n\n // convert to SerializableBlock and back\n let serializable = SerializableBlock::from(block);\n let restored = Block::from(serializable);\n\n // withdrawals should be preserved\n assert!(restored.body.withdrawals.is_some());\n let withdrawals = restored.body.withdrawals.unwrap();\n assert_eq!(withdrawals.len(), 1);\n assert_eq!(withdrawals[0].index, 42);\n assert_eq!(withdrawals[0].validator_index, 123);\n }\n}\n" }, { "path": "crates/anvil/src/eth/backend/env.rs", "content": "use alloy_evm::EvmEnv;\nuse foundry_evm_networks::NetworkConfigs;\nuse op_revm::OpTransaction;\nuse revm::context::TxEnv;\n\n/// Helper container type for [`EvmEnv`] and [`OpTransaction`].\n#[derive(Clone, Debug, Default)]\npub struct Env {\n pub evm_env: EvmEnv,\n pub tx: OpTransaction,\n pub networks: NetworkConfigs,\n}\n\n/// Helper container type for [`EvmEnv`] and [`OpTransaction`].\nimpl Env {\n pub fn new(evm_env: EvmEnv, tx: OpTransaction, networks: NetworkConfigs) -> Self {\n Self { evm_env, tx, networks }\n }\n}\n" }, { "path": "crates/anvil/src/eth/backend/executor.rs", "content": "use crate::{\n eth::backend::{cheats::CheatsManager, env::Env},\n mem::inspector::AnvilInspector,\n};\nuse alloy_consensus::{Eip658Value, Transaction, TransactionEnvelope, transaction::Either};\nuse alloy_eips::{\n Encodable2718, eip2935, eip4788,\n eip7702::{RecoveredAuthority, RecoveredAuthorization},\n};\nuse alloy_evm::{\n EthEvmFactory, Evm, EvmEnv, EvmFactory, FromRecoveredTx, FromTxWithEncoded, RecoveredTx,\n block::{\n BlockExecutionError, BlockExecutionResult, BlockExecutor, BlockValidationError,\n ExecutableTx, OnStateHook, StateChangeSource, StateDB, TxResult,\n },\n eth::{\n EthEvmContext, EthTxResult,\n receipt_builder::{ReceiptBuilder, ReceiptBuilderCtx},\n },\n precompiles::PrecompilesMap,\n};\nuse alloy_op_evm::OpEvmFactory;\nuse alloy_primitives::{Address, B256, Bytes};\nuse anvil_core::eth::transaction::PendingTransaction;\nuse foundry_evm::{backend::DatabaseError, core::either_evm::EitherEvm};\nuse foundry_evm_networks::NetworkConfigs;\nuse foundry_primitives::{FoundryReceiptEnvelope, FoundryTxEnvelope, FoundryTxType};\nuse op_revm::{OpContext, OpTransaction};\nuse revm::{\n Database, DatabaseCommit, Inspector,\n context::{Block as RevmBlock, TxEnv},\n context_interface::result::ResultAndState,\n};\nuse std::{fmt, fmt::Debug};\n\n/// Receipt builder for Foundry/Anvil that handles all transaction types\n#[derive(Debug, Default, Clone, Copy)]\n#[non_exhaustive]\npub struct FoundryReceiptBuilder;\n\nimpl ReceiptBuilder for FoundryReceiptBuilder {\n type Transaction = FoundryTxEnvelope;\n type Receipt = FoundryReceiptEnvelope;\n\n fn build_receipt(\n &self,\n ctx: ReceiptBuilderCtx<'_, FoundryTxType, E>,\n ) -> FoundryReceiptEnvelope {\n let receipt = alloy_consensus::Receipt {\n status: Eip658Value::Eip658(ctx.result.is_success()),\n cumulative_gas_used: ctx.cumulative_gas_used,\n logs: ctx.result.into_logs(),\n }\n .with_bloom();\n\n match ctx.tx_type {\n FoundryTxType::Legacy => FoundryReceiptEnvelope::Legacy(receipt),\n FoundryTxType::Eip2930 => FoundryReceiptEnvelope::Eip2930(receipt),\n FoundryTxType::Eip1559 => FoundryReceiptEnvelope::Eip1559(receipt),\n FoundryTxType::Eip4844 => FoundryReceiptEnvelope::Eip4844(receipt),\n FoundryTxType::Eip7702 => FoundryReceiptEnvelope::Eip7702(receipt),\n FoundryTxType::Deposit => {\n unreachable!(\"deposit receipts are built in commit_transaction\")\n }\n FoundryTxType::Tempo => FoundryReceiptEnvelope::Tempo(receipt),\n }\n }\n}\n\n/// Result of executing a transaction in [`AnvilBlockExecutor`].\n///\n/// Wraps [`EthTxResult`] with the sender address, needed for deposit nonce resolution.\n#[derive(Debug)]\npub struct AnvilTxResult {\n pub inner: EthTxResult,\n pub sender: Address,\n}\n\nimpl TxResult for AnvilTxResult {\n type HaltReason = H;\n\n fn result(&self) -> &ResultAndState {\n self.inner.result()\n }\n}\n\n/// Execution context for [`AnvilBlockExecutor`], providing block-level data\n/// needed for pre/post execution system calls.\n#[derive(Debug, Clone)]\npub struct AnvilExecutionCtx {\n /// Parent block hash ā€” needed for EIP-2935 system call.\n pub parent_hash: B256,\n /// Whether Prague hardfork is active.\n pub is_prague: bool,\n /// Whether Cancun hardfork is active.\n pub is_cancun: bool,\n}\n\n/// Block executor for Anvil that implements [`BlockExecutor`].\n///\n/// Wraps an EVM instance and produces [`FoundryReceiptEnvelope`] receipts.\n/// Validation (gas limits, blob gas, transaction validity) is handled by the\n/// caller before transactions are fed to this executor.\npub struct AnvilBlockExecutor {\n /// The EVM instance used for execution.\n evm: E,\n /// Execution context.\n ctx: AnvilExecutionCtx,\n /// Receipt builder.\n receipt_builder: FoundryReceiptBuilder,\n /// Receipts of executed transactions.\n receipts: Vec,\n /// Total gas used by transactions in this block.\n gas_used: u64,\n /// Blob gas used by the block.\n blob_gas_used: u64,\n /// Optional state change hook.\n state_hook: Option>,\n}\n\nimpl fmt::Debug for AnvilBlockExecutor {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n f.debug_struct(\"AnvilBlockExecutor\")\n .field(\"evm\", &self.evm)\n .field(\"ctx\", &self.ctx)\n .field(\"gas_used\", &self.gas_used)\n .field(\"blob_gas_used\", &self.blob_gas_used)\n .field(\"receipts\", &self.receipts.len())\n .finish_non_exhaustive()\n }\n}\n\nimpl AnvilBlockExecutor {\n /// Creates a new [`AnvilBlockExecutor`].\n pub fn new(evm: E, ctx: AnvilExecutionCtx) -> Self {\n Self {\n evm,\n ctx,\n receipt_builder: FoundryReceiptBuilder,\n receipts: Vec::new(),\n gas_used: 0,\n blob_gas_used: 0,\n state_hook: None,\n }\n }\n}\n\nimpl BlockExecutor for AnvilBlockExecutor\nwhere\n E: Evm<\n DB: StateDB,\n Tx: FromRecoveredTx + FromTxWithEncoded,\n >,\n{\n type Transaction = FoundryTxEnvelope;\n type Receipt = FoundryReceiptEnvelope;\n type Evm = E;\n type Result = AnvilTxResult;\n\n fn apply_pre_execution_changes(&mut self) -> Result<(), BlockExecutionError> {\n // EIP-2935: store parent block hash in history storage contract.\n if self.ctx.is_prague {\n let result = self\n .evm\n .transact_system_call(\n eip4788::SYSTEM_ADDRESS,\n eip2935::HISTORY_STORAGE_ADDRESS,\n Bytes::copy_from_slice(self.ctx.parent_hash.as_slice()),\n )\n .map_err(BlockExecutionError::other)?;\n\n if let Some(hook) = &mut self.state_hook {\n hook.on_state(\n StateChangeSource::PreBlock(\n alloy_evm::block::StateChangePreBlockSource::BlockHashesContract,\n ),\n &result.state,\n );\n }\n self.evm.db_mut().commit(result.state);\n }\n Ok(())\n }\n\n fn execute_transaction_without_commit(\n &mut self,\n tx: impl ExecutableTx,\n ) -> Result {\n let (tx_env, tx) = tx.into_parts();\n\n let block_available_gas = self.evm.block().gas_limit() - self.gas_used;\n if tx.tx().gas_limit() > block_available_gas {\n return Err(BlockValidationError::TransactionGasLimitMoreThanAvailableBlockGas {\n transaction_gas_limit: tx.tx().gas_limit(),\n block_available_gas,\n }\n .into());\n }\n\n let sender = *tx.signer();\n\n let result = self.evm.transact(tx_env).map_err(|err| {\n let hash = tx.tx().trie_hash();\n BlockExecutionError::evm(err, hash)\n })?;\n\n Ok(AnvilTxResult {\n inner: EthTxResult {\n result,\n blob_gas_used: tx.tx().blob_gas_used().unwrap_or_default(),\n tx_type: tx.tx().tx_type(),\n },\n sender,\n })\n }\n\n fn commit_transaction(&mut self, output: Self::Result) -> Result {\n let AnvilTxResult {\n inner: EthTxResult { result: ResultAndState { result, state }, blob_gas_used, tx_type },\n sender,\n } = output;\n\n if let Some(hook) = &mut self.state_hook {\n hook.on_state(StateChangeSource::Transaction(self.receipts.len()), &state);\n }\n\n let gas_used = result.gas_used();\n self.gas_used += gas_used;\n\n if self.ctx.is_cancun {\n self.blob_gas_used = self.blob_gas_used.saturating_add(blob_gas_used);\n }\n\n let receipt = if tx_type == FoundryTxType::Deposit {\n let deposit_nonce = state.get(&sender).map(|acc| acc.info.nonce);\n let receipt = alloy_consensus::Receipt {\n status: Eip658Value::Eip658(result.is_success()),\n cumulative_gas_used: self.gas_used,\n logs: result.into_logs(),\n }\n .with_bloom();\n FoundryReceiptEnvelope::Deposit(op_alloy_consensus::OpDepositReceiptWithBloom {\n receipt: op_alloy_consensus::OpDepositReceipt {\n inner: receipt.receipt,\n deposit_nonce,\n deposit_receipt_version: deposit_nonce.map(|_| 1),\n },\n logs_bloom: receipt.logs_bloom,\n })\n } else {\n self.receipt_builder.build_receipt(ReceiptBuilderCtx {\n tx_type,\n evm: &self.evm,\n result,\n state: &state,\n cumulative_gas_used: self.gas_used,\n })\n };\n\n self.receipts.push(receipt);\n self.evm.db_mut().commit(state);\n\n Ok(gas_used)\n }\n\n fn finish(\n self,\n ) -> Result<(Self::Evm, BlockExecutionResult), BlockExecutionError>\n {\n Ok((\n self.evm,\n BlockExecutionResult {\n receipts: self.receipts,\n requests: Default::default(),\n gas_used: self.gas_used,\n blob_gas_used: self.blob_gas_used,\n },\n ))\n }\n\n fn set_state_hook(&mut self, hook: Option>) {\n self.state_hook = hook;\n }\n\n fn evm_mut(&mut self) -> &mut Self::Evm {\n &mut self.evm\n }\n\n fn evm(&self) -> &Self::Evm {\n &self.evm\n }\n\n fn receipts(&self) -> &[FoundryReceiptEnvelope] {\n &self.receipts\n }\n}\n\npub struct AnvilBlockExecutorFactory;\n\nimpl AnvilBlockExecutorFactory {\n pub fn create_executor(\n evm: EitherEvm,\n ctx: AnvilExecutionCtx,\n ) -> AnvilBlockExecutor>\n where\n DB: StateDB,\n {\n AnvilBlockExecutor::new(evm, ctx)\n }\n}\n\n/// Builds the per-tx `OpTransaction` from a pending transaction, replicating the logic\n/// from `TransactionExecutor::env_for`.\npub fn build_tx_env_for_pending(\n tx: &PendingTransaction,\n cheats: &CheatsManager,\n networks: NetworkConfigs,\n _evm_env: &EvmEnv,\n) -> OpTransaction {\n let mut tx_env: OpTransaction =\n FromRecoveredTx::from_recovered_tx(tx.transaction.as_ref(), *tx.sender());\n\n if let FoundryTxEnvelope::Eip7702(tx_7702) = tx.transaction.as_ref()\n && cheats.has_recover_overrides()\n {\n let cheated_auths = tx_7702\n .tx()\n .authorization_list\n .iter()\n .zip(tx_env.base.authorization_list)\n .map(|(signed_auth, either_auth)| {\n either_auth.right_and_then(|recovered_auth| {\n if recovered_auth.authority().is_none()\n && let Ok(signature) = signed_auth.signature()\n && let Some(override_addr) =\n cheats.get_recover_override(&signature.as_bytes().into())\n {\n Either::Right(RecoveredAuthorization::new_unchecked(\n recovered_auth.into_parts().0,\n RecoveredAuthority::Valid(override_addr),\n ))\n } else {\n Either::Right(recovered_auth)\n }\n })\n })\n .collect();\n tx_env.base.authorization_list = cheated_auths;\n }\n\n if networks.is_optimism() {\n tx_env.enveloped_tx = Some(tx.transaction.encoded_2718().into());\n }\n\n tx_env\n}\n\n/// Creates a database with given database and inspector.\npub fn new_eth_evm_with_inspector(\n db: DB,\n env: &Env,\n inspector: I,\n) -> EitherEvm\nwhere\n DB: Database + Debug,\n I: Inspector> + Inspector>,\n{\n if env.networks.is_optimism() {\n let evm_env = EvmEnv::new(\n env.evm_env\n .cfg_env\n .clone()\n .with_spec_and_mainnet_gas_params(op_revm::OpSpecId::ISTHMUS),\n env.evm_env.block_env.clone(),\n );\n EitherEvm::Op(OpEvmFactory::default().create_evm_with_inspector(db, evm_env, inspector))\n } else {\n EitherEvm::Eth(EthEvmFactory::default().create_evm_with_inspector(\n db,\n env.evm_env.clone(),\n inspector,\n ))\n }\n}\n" }, { "path": "crates/anvil/src/eth/backend/fork.rs", "content": "//! Support for forking off another client\n\nuse crate::eth::{backend::db::Db, error::BlockchainError, pool::transactions::PoolTransaction};\nuse alloy_consensus::{BlockHeader, TrieAccount};\nuse alloy_eips::eip2930::AccessListResult;\nuse alloy_network::{\n AnyNetwork, AnyRpcBlock, BlockResponse, Network, TransactionResponse,\n primitives::HeaderResponse,\n};\nuse alloy_primitives::{\n Address, B256, Bytes, StorageValue, U256,\n map::{FbHashMap, HashMap, HashSet},\n};\nuse alloy_provider::{\n Provider,\n ext::{DebugApi, TraceApi},\n};\nuse alloy_rpc_types::{\n BlockId, BlockNumberOrTag as BlockNumber, BlockTransactions, EIP1186AccountProofResponse,\n FeeHistory, Filter, Log,\n simulate::{SimulatePayload, SimulatedBlock},\n trace::{\n geth::{GethDebugTracingOptions, GethTrace},\n parity::{LocalizedTransactionTrace as Trace, TraceResultsWithTransactionHash, TraceType},\n },\n};\nuse alloy_transport::TransportError;\nuse foundry_common::provider::{ProviderBuilder, RetryProvider};\nuse foundry_primitives::{FoundryTxEnvelope, FoundryTxReceipt};\nuse parking_lot::{\n RawRwLock, RwLock,\n lock_api::{RwLockReadGuard, RwLockWriteGuard},\n};\nuse revm::context_interface::block::BlobExcessGasAndPrice;\nuse std::{sync::Arc, time::Duration};\nuse tokio::sync::RwLock as AsyncRwLock;\n\n/// Represents a fork of a remote client\n///\n/// This type contains a subset of the [`EthApi`](crate::eth::EthApi) functions but will exclusively\n/// fetch the requested data from the remote client, if it wasn't already fetched.\n#[derive(Clone, Debug)]\npub struct ClientFork {\n /// Contains the cached data\n pub storage: Arc>>,\n /// contains the info how the fork is configured\n // Wrapping this in a lock, ensures we can update this on the fly via additional custom RPC\n // endpoints\n pub config: Arc>>,\n /// This also holds a handle to the underlying database\n pub database: Arc>>,\n}\n\nimpl ClientFork {\n /// Creates a new instance of the fork\n pub fn new(config: ClientForkConfig, database: Arc>>) -> Self {\n Self { storage: Default::default(), config: Arc::new(RwLock::new(config)), database }\n }\n\n /// Removes all data cached from previous responses\n pub fn clear_cached_storage(&self) {\n self.storage.write().clear()\n }\n\n /// Returns true whether the block predates the fork\n pub fn predates_fork(&self, block: u64) -> bool {\n block < self.block_number()\n }\n\n /// Returns true whether the block predates the fork _or_ is the same block as the fork\n pub fn predates_fork_inclusive(&self, block: u64) -> bool {\n block <= self.block_number()\n }\n\n pub fn timestamp(&self) -> u64 {\n self.config.read().timestamp\n }\n\n pub fn block_number(&self) -> u64 {\n self.config.read().block_number\n }\n\n /// Returns the transaction hash we forked off of, if any.\n pub fn transaction_hash(&self) -> Option {\n self.config.read().transaction_hash\n }\n\n pub fn total_difficulty(&self) -> U256 {\n self.config.read().total_difficulty\n }\n\n pub fn base_fee(&self) -> Option {\n self.config.read().base_fee\n }\n\n pub fn block_hash(&self) -> B256 {\n self.config.read().block_hash\n }\n\n pub fn eth_rpc_url(&self) -> String {\n self.config.read().eth_rpc_url.clone()\n }\n\n pub fn chain_id(&self) -> u64 {\n self.config.read().chain_id\n }\n\n fn provider(&self) -> Arc> {\n self.config.read().provider.clone()\n }\n\n fn storage_read(&self) -> RwLockReadGuard<'_, RawRwLock, ForkedStorage> {\n self.storage.read()\n }\n\n fn storage_write(&self) -> RwLockWriteGuard<'_, RawRwLock, ForkedStorage> {\n self.storage.write()\n }\n\n /// Returns the fee history `eth_feeHistory`\n pub async fn fee_history(\n &self,\n block_count: u64,\n newest_block: BlockNumber,\n reward_percentiles: &[f64],\n ) -> Result {\n self.provider().get_fee_history(block_count, newest_block, reward_percentiles).await\n }\n\n /// Sends `eth_getProof`\n pub async fn get_proof(\n &self,\n address: Address,\n keys: Vec,\n block_number: Option,\n ) -> Result {\n self.provider().get_proof(address, keys).block_id(block_number.unwrap_or_default()).await\n }\n\n pub async fn storage_at(\n &self,\n address: Address,\n index: U256,\n number: Option,\n ) -> Result {\n self.provider()\n .get_storage_at(address, index)\n .block_id(number.unwrap_or_default().into())\n .await\n }\n\n pub async fn logs(&self, filter: &Filter) -> Result, TransportError> {\n if let Some(logs) = self.storage_read().logs.get(filter).cloned() {\n return Ok(logs);\n }\n\n let logs = self.provider().get_logs(filter).await?;\n\n let mut storage = self.storage_write();\n storage.logs.insert(filter.clone(), logs.clone());\n Ok(logs)\n }\n\n pub async fn get_code(\n &self,\n address: Address,\n blocknumber: u64,\n ) -> Result {\n trace!(target: \"backend::fork\", \"get_code={:?}\", address);\n if let Some(code) = self.storage_read().code_at.get(&(address, blocknumber)).cloned() {\n return Ok(code);\n }\n\n let block_id = BlockId::number(blocknumber);\n\n let code = self.provider().get_code_at(address).block_id(block_id).await?;\n\n let mut storage = self.storage_write();\n storage.code_at.insert((address, blocknumber), code.clone());\n\n Ok(code)\n }\n\n pub async fn get_balance(\n &self,\n address: Address,\n blocknumber: u64,\n ) -> Result {\n trace!(target: \"backend::fork\", \"get_balance={:?}\", address);\n self.provider().get_balance(address).block_id(blocknumber.into()).await\n }\n\n pub async fn get_nonce(&self, address: Address, block: u64) -> Result {\n trace!(target: \"backend::fork\", \"get_nonce={:?}\", address);\n self.provider().get_transaction_count(address).block_id(block.into()).await\n }\n\n pub async fn get_account(\n &self,\n address: Address,\n blocknumber: u64,\n ) -> Result {\n trace!(target: \"backend::fork\", \"get_account={:?}\", address);\n self.provider().get_account(address).block_id(blocknumber.into()).await\n }\n\n pub async fn trace_transaction(&self, hash: B256) -> Result, TransportError> {\n if let Some(traces) = self.storage_read().transaction_traces.get(&hash).cloned() {\n return Ok(traces);\n }\n\n let traces = self.provider().trace_transaction(hash).await?.into_iter().collect::>();\n\n let mut storage = self.storage_write();\n storage.transaction_traces.insert(hash, traces.clone());\n\n Ok(traces)\n }\n\n pub async fn debug_trace_transaction(\n &self,\n hash: B256,\n opts: GethDebugTracingOptions,\n ) -> Result {\n if let Some(traces) = self.storage_read().geth_transaction_traces.get(&hash).cloned() {\n return Ok(traces);\n }\n\n let trace = self.provider().debug_trace_transaction(hash, opts).await?;\n\n let mut storage = self.storage_write();\n storage.geth_transaction_traces.insert(hash, trace.clone());\n\n Ok(trace)\n }\n\n pub async fn debug_code_by_hash(\n &self,\n code_hash: B256,\n block_id: Option,\n ) -> Result, TransportError> {\n self.provider().debug_code_by_hash(code_hash, block_id).await\n }\n\n pub async fn trace_block(&self, number: u64) -> Result, TransportError> {\n if let Some(traces) = self.storage_read().block_traces.get(&number).cloned() {\n return Ok(traces);\n }\n\n let traces =\n self.provider().trace_block(number.into()).await?.into_iter().collect::>();\n\n let mut storage = self.storage_write();\n storage.block_traces.insert(number, traces.clone());\n\n Ok(traces)\n }\n\n pub async fn trace_replay_block_transactions(\n &self,\n number: u64,\n trace_types: HashSet,\n ) -> Result, TransportError> {\n // Forward to upstream provider for historical blocks\n let params = (number, trace_types.iter().map(|t| format!(\"{t:?}\")).collect::>());\n self.provider().raw_request(\"trace_replayBlockTransactions\".into(), params).await\n }\n\n /// Reset the fork to a fresh forked state, and optionally update the fork config\n pub async fn reset(\n &self,\n url: Option,\n block_number: impl Into,\n ) -> Result<(), BlockchainError> {\n let block_number = block_number.into();\n {\n self.database\n .write()\n .await\n .maybe_reset(url.clone(), block_number)\n .map_err(BlockchainError::Internal)?;\n }\n\n if let Some(url) = url {\n self.config.write().update_url(url)?;\n let override_chain_id = self.config.read().override_chain_id;\n let chain_id = if let Some(chain_id) = override_chain_id {\n chain_id\n } else {\n self.provider().get_chain_id().await?\n };\n self.config.write().chain_id = chain_id;\n }\n\n let provider = self.provider();\n let block =\n provider.get_block(block_number).await?.ok_or(BlockchainError::BlockNotFound)?;\n let block_hash = block.header().hash();\n let timestamp = block.header().timestamp();\n let base_fee = block.header().base_fee_per_gas();\n let total_difficulty = block.header().difficulty();\n\n let number = block.header().number();\n self.config.write().update_block(\n number,\n block_hash,\n timestamp,\n base_fee.map(|g| g as u128),\n total_difficulty,\n );\n\n self.clear_cached_storage();\n\n self.database.write().await.insert_block_hash(U256::from(number), block_hash);\n\n Ok(())\n }\n\n /// Sends `eth_call`\n pub async fn call(\n &self,\n request: &N::TransactionRequest,\n block: Option,\n ) -> Result {\n let block = block.unwrap_or(BlockNumber::Latest);\n let res = self.provider().call(request.clone()).block(block.into()).await?;\n\n Ok(res)\n }\n\n /// Sends `eth_simulateV1`\n pub async fn simulate_v1(\n &self,\n request: &SimulatePayload,\n block: Option,\n ) -> Result>, TransportError> {\n let mut simulate_call = self.provider().simulate(request);\n if let Some(n) = block {\n simulate_call = simulate_call.number(n.as_number().unwrap());\n }\n\n let res = simulate_call.await?;\n\n Ok(res)\n }\n\n /// Sends `eth_estimateGas`\n pub async fn estimate_gas(\n &self,\n request: &N::TransactionRequest,\n block: Option,\n ) -> Result {\n let block = block.unwrap_or_default();\n let res = self.provider().estimate_gas(request.clone()).block(block.into()).await?;\n\n Ok(res as u128)\n }\n\n /// Sends `eth_createAccessList`\n pub async fn create_access_list(\n &self,\n request: &N::TransactionRequest,\n block: Option,\n ) -> Result {\n self.provider().create_access_list(request).block_id(block.unwrap_or_default().into()).await\n }\n\n pub async fn transaction_by_block_number_and_index(\n &self,\n number: u64,\n index: usize,\n ) -> Result, TransportError> {\n if let Some(block) = self.block_by_number(number).await? {\n #[allow(clippy::collapsible_match)]\n match block.transactions() {\n BlockTransactions::Full(txs) => {\n if let Some(tx) = txs.get(index) {\n return Ok(Some(tx.clone()));\n }\n }\n BlockTransactions::Hashes(hashes) => {\n if let Some(tx_hash) = hashes.get(index) {\n return self.transaction_by_hash(*tx_hash).await;\n }\n }\n // TODO(evalir): Is it possible to reach this case? Should we support it\n BlockTransactions::Uncle => panic!(\"Uncles not supported\"),\n }\n }\n Ok(None)\n }\n\n pub async fn transaction_by_block_hash_and_index(\n &self,\n hash: B256,\n index: usize,\n ) -> Result, TransportError> {\n if let Some(block) = self.block_by_hash(hash).await? {\n #[allow(clippy::collapsible_match)]\n match block.transactions() {\n BlockTransactions::Full(txs) => {\n if let Some(tx) = txs.get(index) {\n return Ok(Some(tx.clone()));\n }\n }\n BlockTransactions::Hashes(hashes) => {\n if let Some(tx_hash) = hashes.get(index) {\n return self.transaction_by_hash(*tx_hash).await;\n }\n }\n // TODO(evalir): Is it possible to reach this case? Should we support it\n BlockTransactions::Uncle => panic!(\"Uncles not supported\"),\n }\n }\n Ok(None)\n }\n\n pub async fn transaction_by_hash(\n &self,\n hash: B256,\n ) -> Result, TransportError> {\n trace!(target: \"backend::fork\", \"transaction_by_hash={:?}\", hash);\n if let tx @ Some(_) = self.storage_read().transactions.get(&hash).cloned() {\n return Ok(tx);\n }\n\n let tx = self.provider().get_transaction_by_hash(hash).await?;\n if let Some(tx) = tx.clone() {\n let mut storage = self.storage_write();\n storage.transactions.insert(hash, tx);\n }\n Ok(tx)\n }\n\n pub async fn block_by_hash(\n &self,\n hash: B256,\n ) -> Result, TransportError> {\n if let Some(mut block) = self.storage_read().blocks.get(&hash).cloned() {\n block.transactions_mut().convert_to_hashes();\n return Ok(Some(block));\n }\n\n Ok(self.fetch_full_block(hash).await?.map(|mut b| {\n b.transactions_mut().convert_to_hashes();\n b\n }))\n }\n\n pub async fn block_by_hash_full(\n &self,\n hash: B256,\n ) -> Result, TransportError> {\n if let Some(block) = self.storage_read().blocks.get(&hash).cloned() {\n return Ok(Some(self.convert_to_full_block(block)));\n }\n self.fetch_full_block(hash).await\n }\n\n pub async fn block_by_number(\n &self,\n block_number: u64,\n ) -> Result, TransportError> {\n if let Some(mut block) = self\n .storage_read()\n .hashes\n .get(&block_number)\n .and_then(|hash| self.storage_read().blocks.get(hash).cloned())\n {\n block.transactions_mut().convert_to_hashes();\n return Ok(Some(block));\n }\n\n let mut block = self.fetch_full_block(block_number).await?;\n if let Some(block) = &mut block {\n block.transactions_mut().convert_to_hashes();\n }\n Ok(block)\n }\n\n pub async fn block_by_number_full(\n &self,\n block_number: u64,\n ) -> Result, TransportError> {\n if let Some(block) = self\n .storage_read()\n .hashes\n .get(&block_number)\n .copied()\n .and_then(|hash| self.storage_read().blocks.get(&hash).cloned())\n {\n return Ok(Some(self.convert_to_full_block(block)));\n }\n\n self.fetch_full_block(block_number).await\n }\n\n async fn fetch_full_block(\n &self,\n block_id: impl Into,\n ) -> Result, TransportError> {\n if let Some(block) = self.provider().get_block(block_id.into()).full().await? {\n let hash = block.header().hash();\n let block_number = block.header().number();\n let mut storage = self.storage_write();\n // also insert all transactions\n let block_txs = match block.transactions() {\n BlockTransactions::Full(txs) => txs.to_owned(),\n _ => vec![],\n };\n storage.transactions.extend(block_txs.iter().map(|tx| (tx.tx_hash(), tx.clone())));\n storage.hashes.insert(block_number, hash);\n storage.blocks.insert(hash, block.clone());\n return Ok(Some(block));\n }\n\n Ok(None)\n }\n\n /// Converts a block of hashes into a full block\n fn convert_to_full_block(&self, mut block: N::BlockResponse) -> N::BlockResponse {\n let storage = self.storage.read();\n let transactions = block\n .transactions()\n .hashes()\n .filter_map(|hash| storage.transactions.get(&hash).cloned())\n .collect();\n *block.transactions_mut() = BlockTransactions::Full(transactions);\n block\n }\n}\n\nimpl ClientFork {\n pub async fn transaction_receipt(\n &self,\n hash: B256,\n ) -> Result, BlockchainError> {\n if let Some(receipt) = self.storage_read().transaction_receipts.get(&hash).cloned() {\n return Ok(Some(receipt));\n }\n\n if let Some(receipt) = self.provider().get_transaction_receipt(hash).await? {\n let receipt = FoundryTxReceipt::try_from(receipt)\n .map_err(|_| BlockchainError::FailedToDecodeReceipt)?;\n let mut storage = self.storage_write();\n storage.transaction_receipts.insert(hash, receipt.clone());\n return Ok(Some(receipt));\n }\n\n Ok(None)\n }\n\n pub async fn block_receipts(\n &self,\n number: u64,\n ) -> Result>, BlockchainError> {\n if let receipts @ Some(_) = self.storage_read().block_receipts.get(&number).cloned() {\n return Ok(receipts);\n }\n\n // TODO Needs to be removed.\n // Since alloy doesn't indicate in the result whether the block exists,\n // this is being temporarily implemented in anvil.\n if self.predates_fork_inclusive(number) {\n let receipts = self.provider().get_block_receipts(BlockId::from(number)).await?;\n let receipts = receipts\n .map(|r| {\n r.into_iter()\n .map(|r| {\n FoundryTxReceipt::try_from(r)\n .map_err(|_| BlockchainError::FailedToDecodeReceipt)\n })\n .collect::, _>>()\n })\n .transpose()?;\n\n if let Some(receipts) = receipts.clone() {\n let mut storage = self.storage_write();\n storage.block_receipts.insert(number, receipts);\n }\n\n return Ok(receipts);\n }\n\n Ok(None)\n }\n\n pub async fn uncle_by_block_hash_and_index(\n &self,\n hash: B256,\n index: usize,\n ) -> Result, TransportError> {\n if let Some(block) = self.block_by_hash(hash).await? {\n return self.uncles_by_block_and_index(block, index).await;\n }\n Ok(None)\n }\n\n pub async fn uncle_by_block_number_and_index(\n &self,\n number: u64,\n index: usize,\n ) -> Result, TransportError> {\n if let Some(block) = self.block_by_number(number).await? {\n return self.uncles_by_block_and_index(block, index).await;\n }\n Ok(None)\n }\n\n async fn uncles_by_block_and_index(\n &self,\n block: AnyRpcBlock,\n index: usize,\n ) -> Result, TransportError> {\n let block_hash = block.header().hash();\n let block_number = block.header().number();\n if let Some(uncles) = self.storage_read().uncles.get(&block_hash) {\n return Ok(uncles.get(index).cloned());\n }\n\n let mut uncles = Vec::with_capacity(block.uncles.len());\n for (uncle_idx, _) in block.uncles.iter().enumerate() {\n let uncle =\n match self.provider().get_uncle(block_number.into(), uncle_idx as u64).await? {\n Some(u) => u,\n None => return Ok(None),\n };\n uncles.push(uncle);\n }\n self.storage_write().uncles.insert(block_hash, uncles.clone());\n Ok(uncles.get(index).cloned())\n }\n}\n\n/// Contains all fork metadata\n#[derive(Clone, Debug)]\npub struct ClientForkConfig {\n pub eth_rpc_url: String,\n /// The block number of the forked block\n pub block_number: u64,\n /// The hash of the forked block\n pub block_hash: B256,\n /// The transaction hash we forked off of, if any.\n pub transaction_hash: Option,\n pub provider: Arc>,\n pub chain_id: u64,\n pub override_chain_id: Option,\n /// The timestamp for the forked block\n pub timestamp: u64,\n /// The basefee of the forked block\n pub base_fee: Option,\n /// Blob gas used of the forked block\n pub blob_gas_used: Option,\n /// Blob excess gas and price of the forked block\n pub blob_excess_gas_and_price: Option,\n /// request timeout\n pub timeout: Duration,\n /// request retries for spurious networks\n pub retries: u32,\n /// request retries for spurious networks\n pub backoff: Duration,\n /// available CUPS\n pub compute_units_per_second: u64,\n /// total difficulty of the chain until this block\n pub total_difficulty: U256,\n /// Transactions to force include in the forked chain\n pub force_transactions: Option>>,\n}\n\nimpl ClientForkConfig {\n /// Updates the provider URL\n ///\n /// # Errors\n ///\n /// This will fail if no new provider could be established (erroneous URL)\n fn update_url(&mut self, url: String) -> Result<(), BlockchainError> {\n // let interval = self.provider.get_interval();\n self.provider = Arc::new(\n ProviderBuilder::::new(url.as_str())\n .timeout(self.timeout)\n // .timeout_retry(self.retries)\n .max_retry(self.retries)\n .initial_backoff(self.backoff.as_millis() as u64)\n .compute_units_per_second(self.compute_units_per_second)\n .build()\n .map_err(|e| BlockchainError::InvalidUrl(format!(\"{url}: {e}\")))?, /* .interval(interval), */\n );\n trace!(target: \"fork\", \"Updated rpc url {}\", url);\n self.eth_rpc_url = url;\n Ok(())\n }\n /// Updates the block forked off `(block number, block hash, timestamp)`\n pub fn update_block(\n &mut self,\n block_number: u64,\n block_hash: B256,\n timestamp: u64,\n base_fee: Option,\n total_difficulty: U256,\n ) {\n self.block_number = block_number;\n self.block_hash = block_hash;\n self.timestamp = timestamp;\n self.base_fee = base_fee;\n self.total_difficulty = total_difficulty;\n trace!(target: \"fork\", \"Updated block number={} hash={:?}\", block_number, block_hash);\n }\n}\n\n/// Contains cached state fetched to serve EthApi requests\n///\n/// This is used as a cache so repeated requests to the same data are not sent to the remote client\n#[derive(Clone, Debug)]\npub struct ForkedStorage {\n pub uncles: FbHashMap<32, Vec>,\n pub blocks: FbHashMap<32, N::BlockResponse>,\n pub hashes: HashMap,\n pub transactions: FbHashMap<32, N::TransactionResponse>,\n pub transaction_receipts: FbHashMap<32, FoundryTxReceipt>,\n pub transaction_traces: FbHashMap<32, Vec>,\n pub logs: HashMap>,\n pub geth_transaction_traces: FbHashMap<32, GethTrace>,\n pub block_traces: HashMap>,\n pub block_receipts: HashMap>,\n pub code_at: HashMap<(Address, u64), Bytes>,\n}\n\nimpl Default for ForkedStorage {\n fn default() -> Self {\n Self {\n uncles: Default::default(),\n blocks: Default::default(),\n hashes: Default::default(),\n transactions: Default::default(),\n transaction_receipts: Default::default(),\n transaction_traces: Default::default(),\n logs: Default::default(),\n geth_transaction_traces: Default::default(),\n block_traces: Default::default(),\n block_receipts: Default::default(),\n code_at: Default::default(),\n }\n }\n}\n\nimpl ForkedStorage {\n /// Clears all data\n pub fn clear(&mut self) {\n // simply replace with a completely new, empty instance\n *self = Self::default()\n }\n}\n" }, { "path": "crates/anvil/src/eth/backend/genesis.rs", "content": "//! Genesis settings\n\nuse crate::eth::backend::db::Db;\nuse alloy_genesis::{Genesis, GenesisAccount};\nuse alloy_primitives::{Address, U256};\nuse foundry_evm::backend::DatabaseResult;\nuse revm::{bytecode::Bytecode, primitives::KECCAK_EMPTY, state::AccountInfo};\nuse tokio::sync::RwLockWriteGuard;\n\n/// Genesis settings\n#[derive(Clone, Debug, Default)]\npub struct GenesisConfig {\n /// The initial number for the genesis block\n pub number: u64,\n /// The initial timestamp for the genesis block\n pub timestamp: u64,\n /// Balance for genesis accounts\n pub balance: U256,\n /// All accounts that should be initialised at genesis\n pub accounts: Vec
,\n /// The `genesis.json` if provided\n pub genesis_init: Option,\n}\n\nimpl GenesisConfig {\n /// Returns fresh `AccountInfo`s for the configured `accounts`\n pub fn account_infos(&self) -> impl Iterator + '_ {\n self.accounts.iter().copied().map(|address| {\n let info = AccountInfo {\n balance: self.balance,\n code_hash: KECCAK_EMPTY,\n // we set this to empty so `Database::code_by_hash` doesn't get called\n code: Some(Default::default()),\n nonce: 0,\n account_id: None,\n };\n (address, info)\n })\n }\n\n /// If an initial `genesis.json` was provided, this applies the account alloc to the db\n pub fn apply_genesis_json_alloc(\n &self,\n mut db: RwLockWriteGuard<'_, Box>,\n ) -> DatabaseResult<()> {\n if let Some(ref genesis) = self.genesis_init {\n for (addr, mut acc) in genesis.alloc.clone() {\n let storage = std::mem::take(&mut acc.storage);\n // insert all accounts\n db.insert_account(addr, self.genesis_to_account_info(&acc));\n // insert all storage values\n for (k, v) in &storage.unwrap_or_default() {\n db.set_storage_at(addr, *k, *v)?;\n }\n }\n }\n Ok(())\n }\n\n /// Converts a [`GenesisAccount`] to an [`AccountInfo`]\n fn genesis_to_account_info(&self, acc: &GenesisAccount) -> AccountInfo {\n let GenesisAccount { code, balance, nonce, .. } = acc.clone();\n let code = code.map(Bytecode::new_raw);\n AccountInfo {\n balance,\n nonce: nonce.unwrap_or_default(),\n code_hash: code.as_ref().map(|code| code.hash_slow()).unwrap_or(KECCAK_EMPTY),\n code,\n account_id: None,\n }\n }\n}\n" }, { "path": "crates/anvil/src/eth/backend/info.rs", "content": "//! Handler that can get current storage related data\n\nuse crate::mem::Backend;\nuse alloy_consensus::TxReceipt;\nuse alloy_network::{AnyRpcBlock, Network};\nuse alloy_primitives::B256;\nuse anvil_core::eth::block::Block;\nuse std::{fmt, sync::Arc};\n\n/// A type that can fetch data related to the ethereum storage.\n///\n/// This is simply a wrapper type for the [`Backend`] but exposes a limited set of functions to\n/// fetch ethereum storage related data\n// TODO(mattsee): once we have multiple Backend types, this should be turned into a trait\n#[derive(Clone)]\npub struct StorageInfo {\n backend: Arc>,\n}\n\nimpl StorageInfo {\n pub(crate) fn new(backend: Arc>) -> Self {\n Self { backend }\n }\n\n /// Returns the current block\n pub fn current_block(&self) -> Option {\n self.backend.get_block(self.backend.best_number())\n }\n\n /// Returns the block with the given hash\n pub fn block(&self, hash: B256) -> Option {\n self.backend.get_block_by_hash(hash)\n }\n\n /// Returns the block with the given hash in the format of the ethereum API\n pub fn eth_block(&self, hash: B256) -> Option {\n let block = self.block(hash)?;\n Some(self.backend.convert_block(block))\n }\n}\n\nimpl StorageInfo\nwhere\n N::ReceiptEnvelope: TxReceipt + Clone,\n{\n /// Returns the receipts of the current block\n pub fn current_receipts(&self) -> Option> {\n self.backend.mined_receipts(self.backend.best_hash())\n }\n\n /// Returns the receipts of the block with the given hash\n pub fn receipts(&self, hash: B256) -> Option> {\n self.backend.mined_receipts(hash)\n }\n}\n\nimpl fmt::Debug for StorageInfo {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n f.debug_struct(\"StorageInfo\").finish_non_exhaustive()\n }\n}\n" }, { "path": "crates/anvil/src/eth/backend/mem/cache.rs", "content": "use crate::config::anvil_tmp_dir;\nuse alloy_primitives::B256;\nuse foundry_evm::backend::StateSnapshot;\nuse std::{\n io,\n path::{Path, PathBuf},\n};\nuse tempfile::TempDir;\n\n/// On disk state cache\n///\n/// A basic tempdir which stores states on disk\npub struct DiskStateCache {\n /// The path where to create the tempdir in\n pub(crate) temp_path: Option,\n /// Holds the temp dir object.\n pub(crate) temp_dir: Option,\n}\n\nimpl DiskStateCache {\n /// Specify the path where to create the tempdir in\n pub fn with_path(self, temp_path: PathBuf) -> Self {\n Self { temp_path: Some(temp_path), temp_dir: None }\n }\n /// Returns the cache file for the given hash\n fn with_cache_file(&mut self, hash: B256, f: F) -> Option\n where\n F: FnOnce(PathBuf) -> R,\n {\n if self.temp_dir.is_none() {\n let tmp_dir = self\n .temp_path\n .as_ref()\n .map(|p| -> io::Result {\n std::fs::create_dir_all(p)?;\n build_tmp_dir(Some(p))\n })\n .unwrap_or_else(|| build_tmp_dir(None));\n\n match tmp_dir {\n Ok(temp_dir) => {\n trace!(target: \"backend\", path=?temp_dir.path(), \"created disk state cache dir\");\n self.temp_dir = Some(temp_dir);\n }\n Err(err) => {\n error!(target: \"backend\", %err, \"failed to create disk state cache dir\");\n }\n }\n }\n if let Some(temp_dir) = &self.temp_dir {\n let path = temp_dir.path().join(format!(\"{hash:?}.json\"));\n Some(f(path))\n } else {\n None\n }\n }\n\n /// Stores the snapshot for the given hash synchronously.\n ///\n /// Returns `true` if the write was successful, `false` otherwise.\n pub fn write(&mut self, hash: B256, state: &StateSnapshot) -> bool {\n self.with_cache_file(hash, |file| match foundry_common::fs::write_json_file(&file, state) {\n Ok(_) => {\n trace!(target: \"backend\", ?hash, \"wrote state json file\");\n true\n }\n Err(err) => {\n error!(target: \"backend\", %err, ?hash, \"Failed to write state snapshot\");\n false\n }\n })\n .unwrap_or(false)\n }\n\n /// Loads the snapshot file for the given hash\n ///\n /// Returns None if it doesn't exist or deserialization failed\n pub fn read(&mut self, hash: B256) -> Option {\n self.with_cache_file(hash, |file| {\n match foundry_common::fs::read_json_file::(&file) {\n Ok(state) => {\n trace!(target: \"backend\", ?hash,\"loaded cached state\");\n Some(state)\n }\n Err(err) => {\n error!(target: \"backend\", %err, ?hash, \"Failed to load state snapshot\");\n None\n }\n }\n })\n .flatten()\n }\n\n /// Removes the cache file for the given hash, if it exists\n pub fn remove(&mut self, hash: B256) {\n self.with_cache_file(hash, |file| {\n foundry_common::fs::remove_file(file).map_err(|err| {\n error!(target: \"backend\", %err, %hash, \"Failed to remove state snapshot\");\n })\n });\n }\n}\n\nimpl Default for DiskStateCache {\n fn default() -> Self {\n Self { temp_path: anvil_tmp_dir(), temp_dir: None }\n }\n}\n\n/// Returns the temporary dir for the cached state\n///\n/// This will create a prefixed temp dir with `anvil-state-06-11-2022-12-50`\nfn build_tmp_dir(p: Option<&Path>) -> io::Result {\n let mut builder = tempfile::Builder::new();\n let now = chrono::offset::Utc::now();\n let prefix = now.format(\"anvil-state-%d-%m-%Y-%H-%M\").to_string();\n builder.prefix(&prefix);\n\n if let Some(p) = p { builder.tempdir_in(p) } else { builder.tempdir() }\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n use tempfile::tempdir;\n\n #[test]\n fn can_build_temp_dir() {\n let dir = tempdir().unwrap();\n let p = dir.path();\n let cache_dir = build_tmp_dir(Some(p)).unwrap();\n assert!(\n cache_dir.path().file_name().unwrap().to_str().unwrap().starts_with(\"anvil-state-\")\n );\n let cache_dir = build_tmp_dir(None).unwrap();\n assert!(\n cache_dir.path().file_name().unwrap().to_str().unwrap().starts_with(\"anvil-state-\")\n );\n }\n}\n" }, { "path": "crates/anvil/src/eth/backend/mem/fork_db.rs", "content": "use crate::eth::backend::db::{\n Db, MaybeForkedDatabase, MaybeFullDatabase, SerializableAccountRecord, SerializableBlock,\n SerializableHistoricalStates, SerializableState, SerializableTransaction, StateDb,\n};\nuse alloy_network::Network;\nuse alloy_primitives::{Address, B256, U256, map::AddressMap};\nuse alloy_rpc_types::BlockId;\nuse foundry_evm::{\n backend::{BlockchainDb, DatabaseResult, RevertStateSnapshotAction, StateSnapshot},\n fork::database::ForkDbStateSnapshot,\n};\nuse revm::{\n context::BlockEnv,\n database::{Database, DbAccount},\n state::AccountInfo,\n};\n\npub use foundry_evm::fork::database::ForkedDatabase;\n\nimpl Db for ForkedDatabase {\n fn insert_account(&mut self, address: Address, account: AccountInfo) {\n self.database_mut().insert_account(address, account)\n }\n\n fn set_storage_at(&mut self, address: Address, slot: B256, val: B256) -> DatabaseResult<()> {\n // this ensures the account is loaded first\n let _ = Database::basic(self, address)?;\n self.database_mut().set_storage_at(address, slot, val)\n }\n\n fn insert_block_hash(&mut self, number: U256, hash: B256) {\n self.inner().block_hashes().write().insert(number, hash);\n }\n\n fn dump_state(\n &self,\n at: BlockEnv,\n best_number: u64,\n blocks: Vec,\n transactions: Vec,\n historical_states: Option,\n ) -> DatabaseResult> {\n let mut db = self.database().clone();\n let accounts = self\n .database()\n .cache\n .accounts\n .clone()\n .into_iter()\n .map(|(k, v)| -> DatabaseResult<_> {\n let code = if let Some(code) = v.info.code {\n code\n } else {\n db.code_by_hash(v.info.code_hash)?\n };\n Ok((\n k,\n SerializableAccountRecord {\n nonce: v.info.nonce,\n balance: v.info.balance,\n code: code.original_bytes(),\n storage: v.storage.into_iter().map(|(k, v)| (k.into(), v.into())).collect(),\n },\n ))\n })\n .collect::>()?;\n Ok(Some(SerializableState {\n block: Some(at),\n accounts,\n best_block_number: Some(best_number),\n blocks,\n transactions,\n historical_states,\n }))\n }\n\n fn snapshot_state(&mut self) -> U256 {\n self.insert_state_snapshot()\n }\n\n fn revert_state(&mut self, id: U256, action: RevertStateSnapshotAction) -> bool {\n self.revert_state_snapshot(id, action)\n }\n\n fn current_state(&self) -> StateDb {\n StateDb::new(self.create_state_snapshot())\n }\n}\n\nimpl MaybeFullDatabase for ForkedDatabase {\n fn maybe_as_full_db(&self) -> Option<&AddressMap> {\n Some(&self.database().cache.accounts)\n }\n\n fn clear_into_state_snapshot(&mut self) -> StateSnapshot {\n let db = self.inner().db();\n let accounts = std::mem::take(&mut *db.accounts.write());\n let storage = std::mem::take(&mut *db.storage.write());\n let block_hashes = std::mem::take(&mut *db.block_hashes.write());\n StateSnapshot { accounts, storage, block_hashes }\n }\n\n fn read_as_state_snapshot(&self) -> StateSnapshot {\n let db = self.inner().db();\n let accounts = db.accounts.read().clone();\n let storage = db.storage.read().clone();\n let block_hashes = db.block_hashes.read().clone();\n StateSnapshot { accounts, storage, block_hashes }\n }\n\n fn clear(&mut self) {\n self.flush_cache();\n self.clear_into_state_snapshot();\n }\n\n fn init_from_state_snapshot(&mut self, state_snapshot: StateSnapshot) {\n let db = self.inner().db();\n let StateSnapshot { accounts, storage, block_hashes } = state_snapshot;\n *db.accounts.write() = accounts;\n *db.storage.write() = storage;\n *db.block_hashes.write() = block_hashes;\n }\n}\n\nimpl MaybeFullDatabase for ForkDbStateSnapshot {\n fn maybe_as_full_db(&self) -> Option<&AddressMap> {\n Some(&self.local.cache.accounts)\n }\n\n fn clear_into_state_snapshot(&mut self) -> StateSnapshot {\n let mut state_snapshot = std::mem::take(&mut self.state_snapshot);\n let local_state_snapshot = self.local.clear_into_state_snapshot();\n state_snapshot.accounts.extend(local_state_snapshot.accounts);\n state_snapshot.storage.extend(local_state_snapshot.storage);\n state_snapshot.block_hashes.extend(local_state_snapshot.block_hashes);\n state_snapshot\n }\n\n fn read_as_state_snapshot(&self) -> StateSnapshot {\n let mut state_snapshot = self.state_snapshot.clone();\n let local_state_snapshot = self.local.read_as_state_snapshot();\n state_snapshot.accounts.extend(local_state_snapshot.accounts);\n state_snapshot.storage.extend(local_state_snapshot.storage);\n state_snapshot.block_hashes.extend(local_state_snapshot.block_hashes);\n state_snapshot\n }\n\n fn clear(&mut self) {\n std::mem::take(&mut self.state_snapshot);\n self.local.clear()\n }\n\n fn init_from_state_snapshot(&mut self, state_snapshot: StateSnapshot) {\n self.state_snapshot = state_snapshot;\n }\n}\n\nimpl MaybeForkedDatabase for ForkedDatabase {\n fn maybe_reset(&mut self, url: Option, block_number: BlockId) -> Result<(), String> {\n self.reset(url, block_number)\n }\n\n fn maybe_flush_cache(&self) -> Result<(), String> {\n self.flush_cache();\n Ok(())\n }\n\n fn maybe_inner(&self) -> Result<&BlockchainDb, String> {\n Ok(self.inner())\n }\n}\n" }, { "path": "crates/anvil/src/eth/backend/mem/in_memory_db.rs", "content": "//! The in memory DB\n\nuse crate::{\n eth::backend::db::{\n Db, MaybeForkedDatabase, MaybeFullDatabase, SerializableAccountRecord, SerializableBlock,\n SerializableHistoricalStates, SerializableState, SerializableTransaction, StateDb,\n },\n mem::state::state_root,\n};\nuse alloy_primitives::{Address, B256, U256, map::AddressMap};\nuse alloy_rpc_types::BlockId;\nuse foundry_evm::backend::{BlockchainDb, DatabaseResult, StateSnapshot};\nuse revm::{\n context::BlockEnv,\n database::{DatabaseRef, DbAccount},\n state::AccountInfo,\n};\n\n// reexport for convenience\npub use foundry_evm::backend::MemDb;\nuse foundry_evm::backend::RevertStateSnapshotAction;\n\nimpl Db for MemDb {\n fn insert_account(&mut self, address: Address, account: AccountInfo) {\n self.inner.insert_account_info(address, account)\n }\n\n fn set_storage_at(&mut self, address: Address, slot: B256, val: B256) -> DatabaseResult<()> {\n self.inner.insert_account_storage(address, slot.into(), val.into())\n }\n\n fn insert_block_hash(&mut self, number: U256, hash: B256) {\n self.inner.cache.block_hashes.insert(number, hash);\n }\n\n fn dump_state(\n &self,\n at: BlockEnv,\n best_number: u64,\n blocks: Vec,\n transactions: Vec,\n historical_states: Option,\n ) -> DatabaseResult> {\n let accounts = self\n .inner\n .cache\n .accounts\n .clone()\n .into_iter()\n .map(|(k, v)| -> DatabaseResult<_> {\n let code = if let Some(code) = v.info.code {\n code\n } else {\n self.inner.code_by_hash_ref(v.info.code_hash)?\n };\n Ok((\n k,\n SerializableAccountRecord {\n nonce: v.info.nonce,\n balance: v.info.balance,\n code: code.original_bytes(),\n storage: v.storage.into_iter().map(|(k, v)| (k.into(), v.into())).collect(),\n },\n ))\n })\n .collect::>()?;\n\n Ok(Some(SerializableState {\n block: Some(at),\n accounts,\n best_block_number: Some(best_number),\n blocks,\n transactions,\n historical_states,\n }))\n }\n\n /// Creates a new snapshot\n fn snapshot_state(&mut self) -> U256 {\n let id = self.state_snapshots.insert(self.inner.clone());\n trace!(target: \"backend::memdb\", \"Created new state snapshot {}\", id);\n id\n }\n\n fn revert_state(&mut self, id: U256, action: RevertStateSnapshotAction) -> bool {\n if let Some(state_snapshot) = self.state_snapshots.remove(id) {\n if action.is_keep() {\n self.state_snapshots.insert_at(state_snapshot.clone(), id);\n }\n self.inner = state_snapshot;\n trace!(target: \"backend::memdb\", \"Reverted state snapshot {}\", id);\n true\n } else {\n warn!(target: \"backend::memdb\", \"No state snapshot to revert for {}\", id);\n false\n }\n }\n\n fn maybe_state_root(&self) -> Option {\n Some(state_root(&self.inner.cache.accounts))\n }\n\n fn current_state(&self) -> StateDb {\n StateDb::new(Self { inner: self.inner.clone(), ..Default::default() })\n }\n}\n\nimpl MaybeFullDatabase for MemDb {\n fn maybe_as_full_db(&self) -> Option<&AddressMap> {\n Some(&self.inner.cache.accounts)\n }\n\n fn clear_into_state_snapshot(&mut self) -> StateSnapshot {\n self.inner.clear_into_state_snapshot()\n }\n\n fn read_as_state_snapshot(&self) -> StateSnapshot {\n self.inner.read_as_state_snapshot()\n }\n\n fn clear(&mut self) {\n self.inner.clear();\n }\n\n fn init_from_state_snapshot(&mut self, snapshot: StateSnapshot) {\n self.inner.init_from_state_snapshot(snapshot)\n }\n}\n\nimpl MaybeForkedDatabase for MemDb {\n fn maybe_reset(&mut self, _url: Option, _block_number: BlockId) -> Result<(), String> {\n Err(\"not supported\".to_string())\n }\n\n fn maybe_flush_cache(&self) -> Result<(), String> {\n Err(\"not supported\".to_string())\n }\n\n fn maybe_inner(&self) -> Result<&BlockchainDb, String> {\n Err(\"not supported\".to_string())\n }\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n use alloy_primitives::{Bytes, address};\n use revm::{bytecode::Bytecode, primitives::KECCAK_EMPTY};\n use std::collections::BTreeMap;\n\n // verifies that all substantial aspects of a loaded account remain the same after an account\n // is dumped and reloaded\n #[test]\n fn test_dump_reload_cycle() {\n let test_addr: Address = address!(\"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\");\n\n let mut dump_db = MemDb::default();\n\n let contract_code = Bytecode::new_raw(Bytes::from(\"fake contract code\"));\n dump_db.insert_account(\n test_addr,\n AccountInfo {\n balance: U256::from(123456),\n code_hash: KECCAK_EMPTY,\n code: Some(contract_code.clone()),\n nonce: 1234,\n account_id: None,\n },\n );\n dump_db\n .set_storage_at(test_addr, U256::from(1234567).into(), U256::from(1).into())\n .unwrap();\n\n // blocks dumping/loading tested in storage.rs\n let state = dump_db\n .dump_state(Default::default(), 0, Vec::new(), Vec::new(), Default::default())\n .unwrap()\n .unwrap();\n\n let mut load_db = MemDb::default();\n\n load_db.load_state(state).unwrap();\n\n let loaded_account = load_db.basic_ref(test_addr).unwrap().unwrap();\n\n assert_eq!(loaded_account.balance, U256::from(123456));\n assert_eq!(load_db.code_by_hash_ref(loaded_account.code_hash).unwrap(), contract_code);\n assert_eq!(loaded_account.nonce, 1234);\n assert_eq!(load_db.storage_ref(test_addr, U256::from(1234567)).unwrap(), U256::from(1));\n }\n\n // verifies that multiple accounts can be loaded at a time, and storage is merged within those\n // accounts as well.\n #[test]\n fn test_load_state_merge() {\n let test_addr: Address = address!(\"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\");\n let test_addr2: Address = address!(\"0x70997970c51812dc3a010c7d01b50e0d17dc79c8\");\n\n let contract_code = Bytecode::new_raw(Bytes::from(\"fake contract code\"));\n\n let mut db = MemDb::default();\n\n db.insert_account(\n test_addr,\n AccountInfo {\n balance: U256::from(123456),\n code_hash: KECCAK_EMPTY,\n code: Some(contract_code.clone()),\n nonce: 1234,\n account_id: None,\n },\n );\n\n db.set_storage_at(test_addr, U256::from(1234567).into(), U256::from(1).into()).unwrap();\n db.set_storage_at(test_addr, U256::from(1234568).into(), U256::from(2).into()).unwrap();\n\n let mut new_state = SerializableState::default();\n\n new_state.accounts.insert(\n test_addr2,\n SerializableAccountRecord {\n balance: Default::default(),\n code: Default::default(),\n nonce: 1,\n storage: Default::default(),\n },\n );\n\n let mut new_storage = BTreeMap::default();\n new_storage.insert(U256::from(1234568).into(), U256::from(5).into());\n\n new_state.accounts.insert(\n test_addr,\n SerializableAccountRecord {\n balance: U256::from(100100),\n code: contract_code.bytes()[..contract_code.len()].to_vec().into(),\n nonce: 100,\n storage: new_storage,\n },\n );\n\n db.load_state(new_state).unwrap();\n\n let loaded_account = db.basic_ref(test_addr).unwrap().unwrap();\n let loaded_account2 = db.basic_ref(test_addr2).unwrap().unwrap();\n\n assert_eq!(loaded_account2.nonce, 1);\n\n assert_eq!(loaded_account.balance, U256::from(100100));\n assert_eq!(db.code_by_hash_ref(loaded_account.code_hash).unwrap(), contract_code);\n assert_eq!(loaded_account.nonce, 1234);\n assert_eq!(db.storage_ref(test_addr, U256::from(1234567)).unwrap(), U256::from(1));\n assert_eq!(db.storage_ref(test_addr, U256::from(1234568)).unwrap(), U256::from(5));\n }\n}\n" }, { "path": "crates/anvil/src/eth/backend/mem/inspector.rs", "content": "//! Anvil specific [`revm::Inspector`] implementation\n\nuse crate::eth::macros::node_info;\nuse alloy_primitives::{Address, Log, U256};\nuse foundry_evm::{\n call_inspectors,\n decode::decode_console_logs,\n inspectors::{LogCollector, TracingInspector},\n traces::{\n CallTraceDecoder, SparsedTraceArena, TracingInspectorConfig, render_trace_arena_inner,\n },\n};\nuse revm::{\n Inspector,\n context::ContextTr,\n inspector::JournalExt,\n interpreter::{\n CallInputs, CallOutcome, CreateInputs, CreateOutcome, Interpreter,\n interpreter::EthInterpreter,\n },\n};\nuse revm_inspectors::transfer::TransferInspector;\nuse std::sync::Arc;\n\n/// The [`revm::Inspector`] used when transacting in the evm\n#[derive(Clone, Debug, Default)]\npub struct AnvilInspector {\n /// Collects all traces\n pub tracer: Option,\n /// Collects all `console.sol` logs\n pub log_collector: Option,\n /// Collects all internal ETH transfers as ERC20 transfer events.\n pub transfer: Option,\n}\n\nimpl AnvilInspector {\n /// Called after the inspecting the evm\n ///\n /// This will log all `console.sol` logs\n pub fn print_logs(&self) {\n if let Some(LogCollector::Capture { logs }) = &self.log_collector {\n print_logs(logs);\n }\n }\n\n /// Consumes the type and prints the traces.\n pub fn into_print_traces(mut self, decoder: Arc) {\n if let Some(a) = self.tracer.take() {\n print_traces(a, decoder);\n }\n }\n\n /// Called after the inspecting the evm\n /// This will log all traces\n pub fn print_traces(&self, decoder: Arc) {\n if let Some(a) = self.tracer.clone() {\n print_traces(a, decoder);\n }\n }\n\n /// Configures the `Tracer` [`revm::Inspector`]\n pub fn with_tracing(mut self) -> Self {\n self.tracer = Some(TracingInspector::new(TracingInspectorConfig::all().set_steps(false)));\n self\n }\n\n /// Configures the `TracingInspector` [`revm::Inspector`]\n pub fn with_tracing_config(mut self, config: TracingInspectorConfig) -> Self {\n self.tracer = Some(TracingInspector::new(config));\n self\n }\n\n /// Enables steps recording for `Tracer`.\n pub fn with_steps_tracing(mut self) -> Self {\n self.tracer = Some(TracingInspector::new(TracingInspectorConfig::all().with_state_diffs()));\n self\n }\n\n /// Configures the `Tracer` [`revm::Inspector`] with a log collector\n pub fn with_log_collector(mut self) -> Self {\n self.log_collector = Some(LogCollector::Capture { logs: Vec::new() });\n self\n }\n\n /// Configures the `Tracer` [`revm::Inspector`] with a transfer event collector\n pub fn with_transfers(mut self) -> Self {\n self.transfer = Some(TransferInspector::new(false).with_logs(true));\n self\n }\n\n /// Configures the `Tracer` [`revm::Inspector`] with a trace printer\n pub fn with_trace_printer(mut self) -> Self {\n self.tracer = Some(TracingInspector::new(TracingInspectorConfig::all().with_state_diffs()));\n self\n }\n}\n\n/// Prints the traces for the inspector\n///\n/// Caution: This blocks on call trace decoding\n///\n/// # Panics\n///\n/// If called outside tokio runtime\nfn print_traces(tracer: TracingInspector, decoder: Arc) {\n let arena = tokio::task::block_in_place(move || {\n tokio::runtime::Handle::current().block_on(async move {\n let mut arena = tracer.into_traces();\n decoder.populate_traces(arena.nodes_mut()).await;\n arena\n })\n });\n\n let traces = SparsedTraceArena { arena, ignored: Default::default() };\n let trace = render_trace_arena_inner(&traces, false, true);\n node_info!(Traces = %format!(\"\\n{}\", trace));\n}\n\nimpl Inspector for AnvilInspector\nwhere\n CTX: ContextTr,\n{\n fn initialize_interp(&mut self, interp: &mut Interpreter, ecx: &mut CTX) {\n call_inspectors!([&mut self.tracer], |inspector| {\n inspector.initialize_interp(interp, ecx);\n });\n }\n\n fn step(&mut self, interp: &mut Interpreter, ecx: &mut CTX) {\n call_inspectors!([&mut self.tracer], |inspector| {\n inspector.step(interp, ecx);\n });\n }\n\n fn step_end(&mut self, interp: &mut Interpreter, ecx: &mut CTX) {\n call_inspectors!([&mut self.tracer], |inspector| {\n inspector.step_end(interp, ecx);\n });\n }\n\n #[allow(clippy::redundant_clone)]\n fn log(&mut self, ecx: &mut CTX, log: Log) {\n call_inspectors!([&mut self.tracer, &mut self.log_collector], |inspector| {\n inspector.log(ecx, log.clone());\n });\n }\n\n #[allow(clippy::redundant_clone)]\n fn log_full(&mut self, interp: &mut Interpreter, ecx: &mut CTX, log: Log) {\n call_inspectors!([&mut self.tracer, &mut self.log_collector], |inspector| {\n inspector.log_full(interp, ecx, log.clone());\n });\n }\n\n fn call(&mut self, ecx: &mut CTX, inputs: &mut CallInputs) -> Option {\n call_inspectors!(\n #[ret]\n [&mut self.tracer, &mut self.log_collector, &mut self.transfer],\n |inspector| inspector.call(ecx, inputs).map(Some),\n );\n None\n }\n\n fn call_end(&mut self, ecx: &mut CTX, inputs: &CallInputs, outcome: &mut CallOutcome) {\n if let Some(tracer) = &mut self.tracer {\n tracer.call_end(ecx, inputs, outcome);\n }\n }\n\n fn create(&mut self, ecx: &mut CTX, inputs: &mut CreateInputs) -> Option {\n call_inspectors!(\n #[ret]\n [&mut self.tracer, &mut self.transfer],\n |inspector| inspector.create(ecx, inputs).map(Some),\n );\n None\n }\n\n fn create_end(&mut self, ecx: &mut CTX, inputs: &CreateInputs, outcome: &mut CreateOutcome) {\n if let Some(tracer) = &mut self.tracer {\n tracer.create_end(ecx, inputs, outcome);\n }\n }\n\n fn selfdestruct(&mut self, contract: Address, target: Address, value: U256) {\n call_inspectors!([&mut self.tracer, &mut self.transfer], |inspector| {\n Inspector::::selfdestruct(inspector, contract, target, value)\n });\n }\n}\n\n/// Prints all the logs\npub fn print_logs(logs: &[Log]) {\n for log in decode_console_logs(logs) {\n tracing::info!(target: crate::logging::EVM_CONSOLE_LOG_TARGET, \"{}\", log);\n }\n}\n" }, { "path": "crates/anvil/src/eth/backend/mem/mod.rs", "content": "//! In-memory blockchain backend.\nuse self::state::trie_storage;\nuse super::executor::new_eth_evm_with_inspector;\nuse crate::{\n ForkChoice, NodeConfig, PrecompileFactory,\n config::PruneStateHistoryConfig,\n eth::{\n backend::{\n cheats::{CheatEcrecover, CheatsManager},\n db::{AnvilCacheDB, Db, MaybeFullDatabase, SerializableState, StateDb},\n env::Env,\n executor::{AnvilBlockExecutorFactory, AnvilExecutionCtx, build_tx_env_for_pending},\n fork::ClientFork,\n genesis::GenesisConfig,\n mem::{\n state::{storage_root, trie_accounts},\n storage::MinedTransactionReceipt,\n },\n notifications::{NewBlockNotification, NewBlockNotifications},\n time::{TimeManager, utc_from_secs},\n validate::TransactionValidator,\n },\n error::{BlockchainError, ErrDetail, InvalidTransactionError},\n fees::{FeeDetails, FeeManager, MIN_SUGGESTED_PRIORITY_FEE},\n macros::node_info,\n pool::transactions::PoolTransaction,\n sign::build_impersonated,\n },\n mem::{\n inspector::AnvilInspector,\n storage::{BlockchainStorage, InMemoryBlockStates, MinedBlockOutcome},\n },\n};\nuse alloy_chains::NamedChain;\nuse alloy_consensus::{\n Blob, BlockHeader, EnvKzgSettings, Header, Signed, Transaction as TransactionTrait,\n TrieAccount, TxEnvelope, TxReceipt, Typed2718,\n constants::EMPTY_WITHDRAWALS,\n proofs::{calculate_receipt_root, calculate_transaction_root},\n transaction::Recovered,\n};\nuse alloy_eips::{\n BlockNumHash, Encodable2718, eip2935, eip4844::kzg_to_versioned_hash,\n eip7685::EMPTY_REQUESTS_HASH, eip7840::BlobParams, eip7910::SystemContract,\n};\nuse alloy_evm::{\n Database, Evm, FromRecoveredTx,\n block::BlockExecutor,\n eth::EthEvmContext,\n overrides::{OverrideBlockHashes, apply_state_overrides},\n precompiles::{DynPrecompile, Precompile, PrecompilesMap},\n};\nuse alloy_network::{\n AnyHeader, AnyRpcBlock, AnyRpcHeader, AnyRpcTransaction, AnyTxEnvelope, AnyTxType, Network,\n ReceiptResponse, TransactionBuilder, UnknownTxEnvelope, UnknownTypedTransaction,\n};\nuse alloy_primitives::{\n Address, B256, Bloom, BloomInput, Bytes, TxHash, TxKind, U64, U256, hex, keccak256, logs_bloom,\n map::{AddressMap, HashMap, HashSet},\n};\nuse alloy_rpc_types::{\n AccessList, Block as AlloyBlock, BlockId, BlockNumberOrTag as BlockNumber, BlockTransactions,\n EIP1186AccountProofResponse as AccountProof, EIP1186StorageProof as StorageProof, Filter,\n Header as AlloyHeader, Index, Log, Transaction, TransactionReceipt,\n anvil::Forking,\n request::TransactionRequest,\n serde_helpers::JsonStorageKey,\n simulate::{SimBlock, SimCallResult, SimulatePayload, SimulatedBlock},\n state::EvmOverrides,\n trace::{\n filter::TraceFilter,\n geth::{\n FourByteFrame, GethDebugBuiltInTracerType, GethDebugTracerType,\n GethDebugTracingCallOptions, GethDebugTracingOptions, GethTrace, NoopFrame,\n },\n parity::{LocalizedTransactionTrace, TraceResultsWithTransactionHash, TraceType},\n },\n};\nuse alloy_serde::{OtherFields, WithOtherFields};\nuse alloy_trie::{HashBuilder, Nibbles, proof::ProofRetainer};\nuse anvil_core::eth::{\n block::{Block, BlockInfo, TypedBlockInfo, create_block},\n transaction::{MaybeImpersonatedTransaction, PendingTransaction, TransactionInfo},\n};\nuse anvil_rpc::error::RpcError;\nuse chrono::Datelike;\nuse eyre::{Context, Result};\nuse flate2::{Compression, read::GzDecoder, write::GzEncoder};\nuse foundry_evm::{\n backend::{DatabaseError, DatabaseResult, RevertStateSnapshotAction},\n constants::DEFAULT_CREATE2_DEPLOYER_RUNTIME_CODE,\n core::{either_evm::EitherEvm, precompiles::EC_RECOVER},\n decode::RevertDecoder,\n inspectors::AccessListInspector,\n traces::{\n CallTraceDecoder, FourByteInspector, GethTraceBuilder, TracingInspector,\n TracingInspectorConfig,\n },\n utils::{\n block_env_from_header, get_blob_base_fee_update_fraction,\n get_blob_base_fee_update_fraction_by_spec_id,\n },\n};\nuse foundry_primitives::{\n FoundryNetwork, FoundryReceiptEnvelope, FoundryTransactionRequest, FoundryTxEnvelope,\n FoundryTxReceipt, get_deposit_tx_parts,\n};\nuse futures::channel::mpsc::{UnboundedSender, unbounded};\nuse op_alloy_consensus::DEPOSIT_TX_TYPE_ID;\nuse op_revm::{OpContext, OpHaltReason, OpTransaction};\nuse parking_lot::{Mutex, RwLock, RwLockUpgradableReadGuard};\nuse revm::{\n Database as RevmDatabase, DatabaseCommit, Inspector,\n context::{Block as RevmBlock, BlockEnv, Cfg, TxEnv},\n context_interface::{\n block::BlobExcessGasAndPrice,\n result::{ExecutionResult, Output, ResultAndState},\n },\n database::{CacheDB, DbAccount, WrapDatabaseRef},\n interpreter::InstructionResult,\n precompile::{PrecompileSpecId, Precompiles},\n primitives::{KECCAK_EMPTY, hardfork::SpecId},\n state::AccountInfo,\n};\nuse std::{\n collections::BTreeMap,\n fmt::{self, Debug},\n io::{Read, Write},\n ops::{Mul, Not},\n path::PathBuf,\n sync::Arc,\n time::Duration,\n};\nuse storage::{Blockchain, DEFAULT_HISTORY_LIMIT, MinedTransaction};\nuse tokio::sync::RwLock as AsyncRwLock;\n\npub mod cache;\npub mod fork_db;\npub mod in_memory_db;\npub mod inspector;\npub mod state;\npub mod storage;\n\n/// Helper trait that combines revm::DatabaseRef with Debug.\n/// This is needed because alloy-evm requires Debug on Database implementations.\n/// With trait upcasting now stable, we can now upcast from this trait to revm::DatabaseRef.\npub trait DatabaseRef: revm::DatabaseRef + Debug {}\nimpl DatabaseRef for T where T: revm::DatabaseRef + Debug {}\nimpl DatabaseRef for dyn crate::eth::backend::db::Db {}\n\n// Gas per transaction not creating a contract.\npub const MIN_TRANSACTION_GAS: u128 = 21000;\n// Gas per transaction creating a contract.\npub const MIN_CREATE_GAS: u128 = 53000;\n\npub type State = foundry_evm::utils::StateChangeset;\n\n/// A block request, which includes the Pool Transactions if it's Pending\npub enum BlockRequest {\n Pending(Vec>>),\n Number(u64),\n}\n\nimpl fmt::Debug for BlockRequest {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n match self {\n Self::Pending(txs) => f.debug_tuple(\"Pending\").field(&txs.len()).finish(),\n Self::Number(n) => f.debug_tuple(\"Number\").field(n).finish(),\n }\n }\n}\n\nimpl BlockRequest {\n pub fn block_number(&self) -> BlockNumber {\n match *self {\n Self::Pending(_) => BlockNumber::Pending,\n Self::Number(n) => BlockNumber::Number(n),\n }\n }\n}\n\n/// Gives access to the [revm::Database]\npub struct Backend {\n /// Access to [`revm::Database`] abstraction.\n ///\n /// This will be used in combination with [`alloy_evm::Evm`] and is responsible for feeding\n /// data to the evm during its execution.\n ///\n /// At time of writing, there are two different types of `Db`:\n /// - [`MemDb`](crate::mem::in_memory_db::MemDb): everything is stored in memory\n /// - [`ForkDb`](crate::mem::fork_db::ForkedDatabase): forks off a remote client, missing\n /// data is retrieved via RPC-calls\n ///\n /// In order to commit changes to the [`revm::Database`], the [`alloy_evm::Evm`] requires\n /// mutable access, which requires a write-lock from this `db`. In forking mode, the time\n /// during which the write-lock is active depends on whether the `ForkDb` can provide all\n /// requested data from memory or whether it has to retrieve it via RPC calls first. This\n /// means that it potentially blocks for some time, even taking into account the rate\n /// limits of RPC endpoints. Therefore the `Db` is guarded by a `tokio::sync::RwLock` here\n /// so calls that need to read from it, while it's currently written to, don't block. E.g.\n /// a new block is currently mined and a new [`Self::set_storage_at()`] request is being\n /// executed.\n db: Arc>>,\n /// stores all block related data in memory.\n blockchain: Blockchain,\n /// Historic states of previous blocks.\n states: Arc>,\n /// Env data of the chain\n env: Arc>,\n /// This is set if this is currently forked off another client.\n fork: Arc>>,\n /// Provides time related info, like timestamp.\n time: TimeManager,\n /// Contains state of custom overrides.\n cheats: CheatsManager,\n /// Contains fee data.\n fees: FeeManager,\n /// Initialised genesis.\n genesis: GenesisConfig,\n /// Listeners for new blocks that get notified when a new block was imported.\n new_block_listeners: Arc>>>,\n /// Keeps track of active state snapshots at a specific block.\n active_state_snapshots: Arc>>,\n enable_steps_tracing: bool,\n print_logs: bool,\n print_traces: bool,\n /// Recorder used for decoding traces, used together with print_traces\n call_trace_decoder: Arc,\n /// How to keep history state\n prune_state_history_config: PruneStateHistoryConfig,\n /// max number of blocks with transactions in memory\n transaction_block_keeper: Option,\n node_config: Arc>,\n /// Slots in an epoch\n slots_in_an_epoch: u64,\n /// Precompiles to inject to the EVM.\n precompile_factory: Option>,\n /// Prevent race conditions during mining\n mining: Arc>,\n /// Disable pool balance checks\n disable_pool_balance_checks: bool,\n}\n\nimpl Clone for Backend {\n fn clone(&self) -> Self {\n Self {\n db: self.db.clone(),\n blockchain: self.blockchain.clone(),\n states: self.states.clone(),\n env: self.env.clone(),\n fork: self.fork.clone(),\n time: self.time.clone(),\n cheats: self.cheats.clone(),\n fees: self.fees.clone(),\n genesis: self.genesis.clone(),\n new_block_listeners: self.new_block_listeners.clone(),\n active_state_snapshots: self.active_state_snapshots.clone(),\n enable_steps_tracing: self.enable_steps_tracing,\n print_logs: self.print_logs,\n print_traces: self.print_traces,\n call_trace_decoder: self.call_trace_decoder.clone(),\n prune_state_history_config: self.prune_state_history_config,\n transaction_block_keeper: self.transaction_block_keeper,\n node_config: self.node_config.clone(),\n slots_in_an_epoch: self.slots_in_an_epoch,\n precompile_factory: self.precompile_factory.clone(),\n mining: self.mining.clone(),\n disable_pool_balance_checks: self.disable_pool_balance_checks,\n }\n }\n}\n\nimpl fmt::Debug for Backend {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n f.debug_struct(\"Backend\").finish_non_exhaustive()\n }\n}\n\n// Methods that are generic over any Network.\nimpl Backend {\n /// Sets the account to impersonate\n ///\n /// Returns `true` if the account is already impersonated\n pub fn impersonate(&self, addr: Address) -> bool {\n if self.cheats.impersonated_accounts().contains(&addr) {\n return true;\n }\n // Ensure EIP-3607 is disabled\n let mut env = self.env.write();\n env.evm_env.cfg_env.disable_eip3607 = true;\n self.cheats.impersonate(addr)\n }\n\n /// Removes the account that from the impersonated set\n ///\n /// If the impersonated `addr` is a contract then we also reset the code here\n pub fn stop_impersonating(&self, addr: Address) {\n self.cheats.stop_impersonating(&addr);\n }\n\n /// If set to true will make every account impersonated\n pub fn auto_impersonate_account(&self, enabled: bool) {\n self.cheats.set_auto_impersonate_account(enabled);\n }\n\n /// Returns the configured fork, if any\n pub fn get_fork(&self) -> Option {\n self.fork.read().clone()\n }\n\n /// Returns the database\n pub fn get_db(&self) -> &Arc>> {\n &self.db\n }\n\n /// Returns the `AccountInfo` from the database\n pub async fn get_account(&self, address: Address) -> DatabaseResult {\n Ok(self.db.read().await.basic_ref(address)?.unwrap_or_default())\n }\n\n /// Whether we're forked off some remote client\n pub fn is_fork(&self) -> bool {\n self.fork.read().is_some()\n }\n\n /// Writes the CREATE2 deployer code directly to the database at the address provided.\n pub async fn set_create2_deployer(&self, address: Address) -> DatabaseResult<()> {\n self.set_code(address, Bytes::from_static(DEFAULT_CREATE2_DEPLOYER_RUNTIME_CODE)).await?;\n Ok(())\n }\n\n /// Updates memory limits that should be more strict when auto-mine is enabled\n pub(crate) fn update_interval_mine_block_time(&self, block_time: Duration) {\n self.states.write().update_interval_mine_block_time(block_time)\n }\n\n /// Returns the `TimeManager` responsible for timestamps\n pub fn time(&self) -> &TimeManager {\n &self.time\n }\n\n /// Returns the `CheatsManager` responsible for executing cheatcodes\n pub fn cheats(&self) -> &CheatsManager {\n &self.cheats\n }\n\n /// Whether to skip blob validation\n pub fn skip_blob_validation(&self, impersonator: Option
) -> bool {\n self.cheats().auto_impersonate_accounts()\n || impersonator\n .is_some_and(|addr| self.cheats().impersonated_accounts().contains(&addr))\n }\n\n /// Returns the `FeeManager` that manages fee/pricings\n pub fn fees(&self) -> &FeeManager {\n &self.fees\n }\n\n /// The env data of the blockchain\n pub fn env(&self) -> &Arc> {\n &self.env\n }\n\n /// Returns the current best hash of the chain\n pub fn best_hash(&self) -> B256 {\n self.blockchain.storage.read().best_hash\n }\n\n /// Returns the current best number of the chain\n pub fn best_number(&self) -> u64 {\n self.blockchain.storage.read().best_number\n }\n\n /// Sets the block number\n pub fn set_block_number(&self, number: u64) {\n let mut env = self.env.write();\n env.evm_env.block_env.number = U256::from(number);\n }\n\n /// Returns the client coinbase address.\n pub fn coinbase(&self) -> Address {\n self.env.read().evm_env.block_env.beneficiary\n }\n\n /// Returns the client coinbase address.\n pub fn chain_id(&self) -> U256 {\n U256::from(self.env.read().evm_env.cfg_env.chain_id)\n }\n\n pub fn set_chain_id(&self, chain_id: u64) {\n self.env.write().evm_env.cfg_env.chain_id = chain_id;\n }\n\n /// Returns the genesis data for the Beacon API.\n pub fn genesis_time(&self) -> u64 {\n self.genesis.timestamp\n }\n\n /// Returns balance of the given account.\n pub async fn current_balance(&self, address: Address) -> DatabaseResult {\n Ok(self.get_account(address).await?.balance)\n }\n\n /// Returns balance of the given account.\n pub async fn current_nonce(&self, address: Address) -> DatabaseResult {\n Ok(self.get_account(address).await?.nonce)\n }\n\n /// Sets the coinbase address\n pub fn set_coinbase(&self, address: Address) {\n self.env.write().evm_env.block_env.beneficiary = address;\n }\n\n /// Sets the nonce of the given address\n pub async fn set_nonce(&self, address: Address, nonce: U256) -> DatabaseResult<()> {\n self.db.write().await.set_nonce(address, nonce.try_into().unwrap_or(u64::MAX))\n }\n\n /// Sets the balance of the given address\n pub async fn set_balance(&self, address: Address, balance: U256) -> DatabaseResult<()> {\n self.db.write().await.set_balance(address, balance)\n }\n\n /// Sets the code of the given address\n pub async fn set_code(&self, address: Address, code: Bytes) -> DatabaseResult<()> {\n self.db.write().await.set_code(address, code)\n }\n\n /// Sets the value for the given slot of the given address\n pub async fn set_storage_at(\n &self,\n address: Address,\n slot: U256,\n val: B256,\n ) -> DatabaseResult<()> {\n self.db.write().await.set_storage_at(address, slot.into(), val)\n }\n\n /// Returns the configured specid\n pub fn spec_id(&self) -> SpecId {\n self.env.read().evm_env.cfg_env.spec\n }\n\n /// Returns true for post London\n pub fn is_eip1559(&self) -> bool {\n (self.spec_id() as u8) >= (SpecId::LONDON as u8)\n }\n\n /// Returns true for post Merge\n pub fn is_eip3675(&self) -> bool {\n (self.spec_id() as u8) >= (SpecId::MERGE as u8)\n }\n\n /// Returns true for post Berlin\n pub fn is_eip2930(&self) -> bool {\n (self.spec_id() as u8) >= (SpecId::BERLIN as u8)\n }\n\n /// Returns true for post Cancun\n pub fn is_eip4844(&self) -> bool {\n (self.spec_id() as u8) >= (SpecId::CANCUN as u8)\n }\n\n /// Returns true for post Prague\n pub fn is_eip7702(&self) -> bool {\n (self.spec_id() as u8) >= (SpecId::PRAGUE as u8)\n }\n\n /// Returns true if op-stack deposits are active\n pub fn is_optimism(&self) -> bool {\n self.env.read().networks.is_optimism()\n }\n\n /// Returns the precompiles for the current spec.\n pub fn precompiles(&self) -> BTreeMap {\n let spec_id = self.env.read().evm_env.cfg_env.spec;\n let precompiles = Precompiles::new(PrecompileSpecId::from_spec_id(spec_id));\n\n let mut precompiles_map = BTreeMap::::default();\n for (address, precompile) in precompiles.inner() {\n precompiles_map.insert(precompile.id().name().to_string(), *address);\n }\n\n // Extend with configured network precompiles.\n precompiles_map.extend(self.env.read().networks.precompiles());\n\n if let Some(factory) = &self.precompile_factory {\n for (address, precompile) in factory.precompiles() {\n precompiles_map.insert(precompile.precompile_id().to_string(), address);\n }\n }\n\n precompiles_map\n }\n\n /// Returns the system contracts for the current spec.\n pub fn system_contracts(&self) -> BTreeMap {\n let mut system_contracts = BTreeMap::::default();\n\n let spec_id = self.env.read().evm_env.cfg_env.spec;\n\n if spec_id >= SpecId::CANCUN {\n system_contracts.extend(SystemContract::cancun());\n }\n\n if spec_id >= SpecId::PRAGUE {\n system_contracts.extend(SystemContract::prague(None));\n }\n\n system_contracts\n }\n\n /// Returns [`BlobParams`] corresponding to the current spec.\n pub fn blob_params(&self) -> BlobParams {\n let spec_id = self.env.read().evm_env.cfg_env.spec;\n\n if spec_id >= SpecId::OSAKA {\n return BlobParams::osaka();\n }\n\n if spec_id >= SpecId::PRAGUE {\n return BlobParams::prague();\n }\n\n BlobParams::cancun()\n }\n\n /// Returns an error if EIP1559 is not active (pre Berlin)\n pub fn ensure_eip1559_active(&self) -> Result<(), BlockchainError> {\n if self.is_eip1559() {\n return Ok(());\n }\n Err(BlockchainError::EIP1559TransactionUnsupportedAtHardfork)\n }\n\n /// Returns an error if EIP1559 is not active (pre muirGlacier)\n pub fn ensure_eip2930_active(&self) -> Result<(), BlockchainError> {\n if self.is_eip2930() {\n return Ok(());\n }\n Err(BlockchainError::EIP2930TransactionUnsupportedAtHardfork)\n }\n\n pub fn ensure_eip4844_active(&self) -> Result<(), BlockchainError> {\n if self.is_eip4844() {\n return Ok(());\n }\n Err(BlockchainError::EIP4844TransactionUnsupportedAtHardfork)\n }\n\n pub fn ensure_eip7702_active(&self) -> Result<(), BlockchainError> {\n if self.is_eip7702() {\n return Ok(());\n }\n Err(BlockchainError::EIP7702TransactionUnsupportedAtHardfork)\n }\n\n /// Returns an error if op-stack deposits are not active\n pub fn ensure_op_deposits_active(&self) -> Result<(), BlockchainError> {\n if self.is_optimism() {\n return Ok(());\n }\n Err(BlockchainError::DepositTransactionUnsupported)\n }\n\n /// Returns the block gas limit\n pub fn gas_limit(&self) -> u64 {\n self.env.read().evm_env.block_env.gas_limit\n }\n\n /// Sets the block gas limit\n pub fn set_gas_limit(&self, gas_limit: u64) {\n self.env.write().evm_env.block_env.gas_limit = gas_limit;\n }\n\n /// Returns the current base fee\n pub fn base_fee(&self) -> u64 {\n self.fees.base_fee()\n }\n\n /// Returns whether the minimum suggested priority fee is enforced\n pub fn is_min_priority_fee_enforced(&self) -> bool {\n self.fees.is_min_priority_fee_enforced()\n }\n\n pub fn excess_blob_gas_and_price(&self) -> Option {\n self.fees.excess_blob_gas_and_price()\n }\n\n /// Sets the current basefee\n pub fn set_base_fee(&self, basefee: u64) {\n self.fees.set_base_fee(basefee)\n }\n\n /// Sets the gas price\n pub fn set_gas_price(&self, price: u128) {\n self.fees.set_gas_price(price)\n }\n\n pub fn elasticity(&self) -> f64 {\n self.fees.elasticity()\n }\n\n /// Returns the total difficulty of the chain until this block\n ///\n /// Note: this will always be `0` in memory mode\n /// In forking mode this will always be the total difficulty of the forked block\n pub fn total_difficulty(&self) -> U256 {\n self.blockchain.storage.read().total_difficulty\n }\n\n /// Creates a new `evm_snapshot` at the current height.\n ///\n /// Returns the id of the snapshot created.\n pub async fn create_state_snapshot(&self) -> U256 {\n let num = self.best_number();\n let hash = self.best_hash();\n let id = self.db.write().await.snapshot_state();\n trace!(target: \"backend\", \"creating snapshot {} at {}\", id, num);\n self.active_state_snapshots.lock().insert(id, (num, hash));\n id\n }\n\n pub fn list_state_snapshots(&self) -> BTreeMap {\n self.active_state_snapshots.lock().clone().into_iter().collect()\n }\n\n /// Returns the environment for the next block\n fn next_env(&self) -> Env {\n let mut env = self.env.read().clone();\n // increase block number for this block\n env.evm_env.block_env.number = env.evm_env.block_env.number.saturating_add(U256::from(1));\n env.evm_env.block_env.basefee = self.base_fee();\n env.evm_env.block_env.blob_excess_gas_and_price = self.excess_blob_gas_and_price();\n env.evm_env.block_env.timestamp = U256::from(self.time.current_call_timestamp());\n env\n }\n\n /// Builds [`Inspector`] with the configured options.\n fn build_inspector(&self) -> AnvilInspector {\n let mut inspector = AnvilInspector::default();\n\n if self.print_logs {\n inspector = inspector.with_log_collector();\n }\n if self.print_traces {\n inspector = inspector.with_trace_printer();\n }\n\n inspector\n }\n\n /// Returns a new block event stream that yields Notifications when a new block was added\n pub fn new_block_notifications(&self) -> NewBlockNotifications {\n let (tx, rx) = unbounded();\n self.new_block_listeners.lock().push(tx);\n trace!(target: \"backed\", \"added new block listener\");\n rx\n }\n\n /// Notifies all `new_block_listeners` about the new block\n fn notify_on_new_block(&self, header: Header, hash: B256) {\n // cleanup closed notification streams first, if the channel is closed we can remove the\n // sender half for the set\n self.new_block_listeners.lock().retain(|tx| !tx.is_closed());\n\n let notification = NewBlockNotification { hash, header: Arc::new(header) };\n\n self.new_block_listeners\n .lock()\n .retain(|tx| tx.unbounded_send(notification.clone()).is_ok());\n }\n\n /// Returns the block number for the given block id\n pub fn convert_block_number(&self, block: Option) -> u64 {\n let current = self.best_number();\n match block.unwrap_or(BlockNumber::Latest) {\n BlockNumber::Latest | BlockNumber::Pending => current,\n BlockNumber::Earliest => 0,\n BlockNumber::Number(num) => num,\n BlockNumber::Safe => current.saturating_sub(self.slots_in_an_epoch),\n BlockNumber::Finalized => current.saturating_sub(self.slots_in_an_epoch * 2),\n }\n }\n\n /// Returns the block and its hash for the given id\n fn get_block_with_hash(&self, id: impl Into) -> Option<(Block, B256)> {\n let hash = match id.into() {\n BlockId::Hash(hash) => hash.block_hash,\n BlockId::Number(number) => {\n let storage = self.blockchain.storage.read();\n let slots_in_an_epoch = self.slots_in_an_epoch;\n match number {\n BlockNumber::Latest => storage.best_hash,\n BlockNumber::Earliest => storage.genesis_hash,\n BlockNumber::Pending => return None,\n BlockNumber::Number(num) => *storage.hashes.get(&num)?,\n BlockNumber::Safe => {\n if storage.best_number > (slots_in_an_epoch) {\n *storage.hashes.get(&(storage.best_number - (slots_in_an_epoch)))?\n } else {\n storage.genesis_hash // treat the genesis block as safe \"by definition\"\n }\n }\n BlockNumber::Finalized => {\n if storage.best_number > (slots_in_an_epoch * 2) {\n *storage.hashes.get(&(storage.best_number - (slots_in_an_epoch * 2)))?\n } else {\n storage.genesis_hash\n }\n }\n }\n }\n };\n let block = self.get_block_by_hash(hash)?;\n Some((block, hash))\n }\n\n pub fn get_block(&self, id: impl Into) -> Option {\n self.get_block_with_hash(id).map(|(block, _)| block)\n }\n\n pub fn get_block_by_hash(&self, hash: B256) -> Option {\n self.blockchain.get_block_by_hash(&hash)\n }\n\n /// Returns the traces for the given transaction\n pub(crate) fn mined_parity_trace_transaction(\n &self,\n hash: B256,\n ) -> Option> {\n self.blockchain.storage.read().transactions.get(&hash).map(|tx| tx.parity_traces())\n }\n\n /// Returns the traces for the given block\n pub(crate) fn mined_parity_trace_block(\n &self,\n block: u64,\n ) -> Option> {\n let block = self.get_block(block)?;\n let mut traces = vec![];\n let storage = self.blockchain.storage.read();\n for tx in block.body.transactions {\n traces.extend(storage.transactions.get(&tx.hash())?.parity_traces());\n }\n Some(traces)\n }\n\n /// Returns the mined transaction for the given hash\n pub(crate) fn mined_transaction(&self, hash: B256) -> Option> {\n self.blockchain.storage.read().transactions.get(&hash).cloned()\n }\n\n /// Overrides the given signature to impersonate the specified address during ecrecover.\n pub async fn impersonate_signature(\n &self,\n signature: Bytes,\n address: Address,\n ) -> Result<(), BlockchainError> {\n self.cheats.add_recover_override(signature, address);\n Ok(())\n }\n\n /// Returns code by its hash\n pub async fn debug_code_by_hash(\n &self,\n code_hash: B256,\n block_id: Option,\n ) -> Result, BlockchainError> {\n if let Ok(code) = self.db.read().await.code_by_hash_ref(code_hash) {\n return Ok(Some(code.original_bytes()));\n }\n if let Some(fork) = self.get_fork() {\n return Ok(fork.debug_code_by_hash(code_hash, block_id).await?);\n }\n\n Ok(None)\n }\n\n /// Returns the value associated with a key from the database\n /// Currently only supports bytecode lookups.\n ///\n /// Based on Reth implementation: \n ///\n /// Key should be: 0x63 (1-byte prefix) + 32 bytes (code_hash)\n /// Total key length must be 33 bytes.\n pub async fn debug_db_get(&self, key: String) -> Result, BlockchainError> {\n let key_bytes = if key.starts_with(\"0x\") {\n hex::decode(&key)\n .map_err(|_| BlockchainError::Message(\"Invalid hex key\".to_string()))?\n } else {\n key.into_bytes()\n };\n\n // Validate key length: must be 33 bytes (1 byte prefix + 32 bytes code hash)\n if key_bytes.len() != 33 {\n return Err(BlockchainError::Message(format!(\n \"Invalid key length: expected 33 bytes, got {}\",\n key_bytes.len()\n )));\n }\n\n // Check for bytecode prefix (0x63 = 'c' in ASCII)\n if key_bytes[0] != 0x63 {\n return Err(BlockchainError::Message(\n \"Key prefix must be 0x63 for code hash lookups\".to_string(),\n ));\n }\n\n let code_hash = B256::from_slice(&key_bytes[1..33]);\n\n // Use the existing debug_code_by_hash method to retrieve the bytecode\n self.debug_code_by_hash(code_hash, None).await\n }\n\n fn mined_block_by_hash(&self, hash: B256) -> Option {\n let block = self.blockchain.get_block_by_hash(&hash)?;\n Some(self.convert_block_with_hash(block, Some(hash)))\n }\n\n pub(crate) async fn mined_transactions_by_block_number(\n &self,\n number: BlockNumber,\n ) -> Option> {\n if let Some(block) = self.get_block(number) {\n return self.mined_transactions_in_block(&block);\n }\n None\n }\n\n /// Returns all transactions given a block\n pub(crate) fn mined_transactions_in_block(\n &self,\n block: &Block,\n ) -> Option> {\n let mut transactions = Vec::with_capacity(block.body.transactions.len());\n let base_fee = block.header.base_fee_per_gas();\n let storage = self.blockchain.storage.read();\n for hash in block.body.transactions.iter().map(|tx| tx.hash()) {\n let info = storage.transactions.get(&hash)?.info.clone();\n let tx = block.body.transactions.get(info.transaction_index as usize)?.clone();\n\n let tx = transaction_build(Some(hash), tx, Some(block), Some(info), base_fee);\n transactions.push(tx);\n }\n Some(transactions)\n }\n\n pub fn mined_block_by_number(&self, number: BlockNumber) -> Option {\n let (block, hash) = self.get_block_with_hash(number)?;\n let mut block = self.convert_block_with_hash(block, Some(hash));\n block.transactions.convert_to_hashes();\n Some(block)\n }\n\n pub fn get_full_block(&self, id: impl Into) -> Option {\n let (block, hash) = self.get_block_with_hash(id)?;\n let transactions = self.mined_transactions_in_block(&block)?;\n let mut block = self.convert_block_with_hash(block, Some(hash));\n block.inner.transactions = BlockTransactions::Full(transactions);\n Some(block)\n }\n\n /// Takes a block as it's stored internally and returns the eth api conform block format.\n pub fn convert_block(&self, block: Block) -> AnyRpcBlock {\n self.convert_block_with_hash(block, None)\n }\n\n /// Takes a block as it's stored internally and returns the eth api conform block format.\n /// If `known_hash` is provided, it will be used instead of computing `hash_slow()`.\n pub fn convert_block_with_hash(&self, block: Block, known_hash: Option) -> AnyRpcBlock {\n let size = U256::from(alloy_rlp::encode(&block).len() as u32);\n\n let header = block.header.clone();\n let transactions = block.body.transactions;\n\n let hash = known_hash.unwrap_or_else(|| header.hash_slow());\n let Header { number, withdrawals_root, .. } = header;\n\n let block = AlloyBlock {\n header: AlloyHeader {\n inner: AnyHeader::from(header),\n hash,\n total_difficulty: Some(self.total_difficulty()),\n size: Some(size),\n },\n transactions: alloy_rpc_types::BlockTransactions::Hashes(\n transactions.into_iter().map(|tx| tx.hash()).collect(),\n ),\n uncles: vec![],\n withdrawals: withdrawals_root.map(|_| Default::default()),\n };\n\n let mut block = WithOtherFields::new(block);\n\n // If Arbitrum, apply chain specifics to converted block.\n if is_arbitrum(self.env.read().evm_env.cfg_env.chain_id) {\n // Set `l1BlockNumber` field.\n block.other.insert(\"l1BlockNumber\".to_string(), number.into());\n }\n\n AnyRpcBlock::from(block)\n }\n\n pub async fn block_by_hash(&self, hash: B256) -> Result, BlockchainError> {\n trace!(target: \"backend\", \"get block by hash {:?}\", hash);\n if let tx @ Some(_) = self.mined_block_by_hash(hash) {\n return Ok(tx);\n }\n\n if let Some(fork) = self.get_fork() {\n return Ok(fork.block_by_hash(hash).await?);\n }\n\n Ok(None)\n }\n\n pub async fn block_by_hash_full(\n &self,\n hash: B256,\n ) -> Result, BlockchainError> {\n trace!(target: \"backend\", \"get block by hash {:?}\", hash);\n if let tx @ Some(_) = self.get_full_block(hash) {\n return Ok(tx);\n }\n\n if let Some(fork) = self.get_fork() {\n return Ok(fork.block_by_hash_full(hash).await?);\n }\n\n Ok(None)\n }\n\n pub async fn block_by_number(\n &self,\n number: BlockNumber,\n ) -> Result, BlockchainError> {\n trace!(target: \"backend\", \"get block by number {:?}\", number);\n if let tx @ Some(_) = self.mined_block_by_number(number) {\n return Ok(tx);\n }\n\n if let Some(fork) = self.get_fork() {\n let number = self.convert_block_number(Some(number));\n if fork.predates_fork_inclusive(number) {\n return Ok(fork.block_by_number(number).await?);\n }\n }\n\n Ok(None)\n }\n\n pub async fn block_by_number_full(\n &self,\n number: BlockNumber,\n ) -> Result, BlockchainError> {\n trace!(target: \"backend\", \"get block by number {:?}\", number);\n if let tx @ Some(_) = self.get_full_block(number) {\n return Ok(tx);\n }\n\n if let Some(fork) = self.get_fork() {\n let number = self.convert_block_number(Some(number));\n if fork.predates_fork_inclusive(number) {\n return Ok(fork.block_by_number_full(number).await?);\n }\n }\n\n Ok(None)\n }\n\n /// Converts the `BlockNumber` into a numeric value\n ///\n /// # Errors\n ///\n /// returns an error if the requested number is larger than the current height\n pub async fn ensure_block_number>(\n &self,\n block_id: Option,\n ) -> Result {\n let current = self.best_number();\n let requested =\n match block_id.map(Into::into).unwrap_or(BlockId::Number(BlockNumber::Latest)) {\n BlockId::Hash(hash) => {\n self.block_by_hash(hash.block_hash)\n .await?\n .ok_or(BlockchainError::BlockNotFound)?\n .header\n .number\n }\n BlockId::Number(num) => match num {\n BlockNumber::Latest | BlockNumber::Pending => current,\n BlockNumber::Earliest => U64::ZERO.to::(),\n BlockNumber::Number(num) => num,\n BlockNumber::Safe => current.saturating_sub(self.slots_in_an_epoch),\n BlockNumber::Finalized => current.saturating_sub(self.slots_in_an_epoch * 2),\n },\n };\n\n if requested > current {\n Err(BlockchainError::BlockOutOfRange(current, requested))\n } else {\n Ok(requested)\n }\n }\n\n /// Creates an EVM instance with optionally injected precompiles.\n fn new_eth_evm_with_inspector_ref<'db, I, DB>(\n &self,\n db: &'db DB,\n env: &Env,\n inspector: &'db mut I,\n ) -> EitherEvm, &'db mut I, PrecompilesMap>\n where\n DB: DatabaseRef + ?Sized,\n I: Inspector>>\n + Inspector>>,\n WrapDatabaseRef<&'db DB>: Database,\n {\n let mut evm = new_eth_evm_with_inspector(WrapDatabaseRef(db), env, inspector);\n self.env.read().networks.inject_precompiles(evm.precompiles_mut());\n\n if let Some(factory) = &self.precompile_factory {\n evm.precompiles_mut().extend_precompiles(factory.precompiles());\n }\n\n let cheats = Arc::new(self.cheats.clone());\n if cheats.has_recover_overrides() {\n let cheat_ecrecover = CheatEcrecover::new(Arc::clone(&cheats));\n evm.precompiles_mut().apply_precompile(&EC_RECOVER, move |_| {\n Some(DynPrecompile::new_stateful(\n cheat_ecrecover.precompile_id().clone(),\n move |input| cheat_ecrecover.call(input),\n ))\n });\n }\n\n evm\n }\n\n /// ## EVM settings\n ///\n /// This modifies certain EVM settings to mirror geth's `SkipAccountChecks` when transacting requests, see also: :\n ///\n /// - `disable_eip3607` is set to `true`\n /// - `disable_base_fee` is set to `true`\n /// - `tx_gas_limit_cap` is set to `Some(u64::MAX)` indicating no gas limit cap\n /// - `nonce` check is skipped\n fn build_call_env(\n &self,\n request: WithOtherFields,\n fee_details: FeeDetails,\n block_env: BlockEnv,\n ) -> Env {\n let tx_type = request.minimal_tx_type() as u8;\n\n let WithOtherFields:: {\n inner:\n TransactionRequest {\n from,\n to,\n gas,\n value,\n input,\n access_list,\n blob_versioned_hashes,\n authorization_list,\n nonce,\n sidecar: _,\n chain_id,\n .. // Rest of the gas fees related fields are taken from `fee_details`\n },\n other,\n } = request;\n\n let FeeDetails {\n gas_price,\n max_fee_per_gas,\n max_priority_fee_per_gas,\n max_fee_per_blob_gas,\n } = fee_details;\n\n let gas_limit = gas.unwrap_or(block_env.gas_limit);\n let mut env = self.env.read().clone();\n env.evm_env.block_env = block_env;\n // we want to disable this in eth_call, since this is common practice used by other node\n // impls and providers \n env.evm_env.cfg_env.disable_block_gas_limit = true;\n env.evm_env.cfg_env.tx_gas_limit_cap = Some(u64::MAX);\n\n // The basefee should be ignored for calls against state for\n // - eth_call\n // - eth_estimateGas\n // - eth_createAccessList\n // - tracing\n env.evm_env.cfg_env.disable_base_fee = true;\n\n // Disable nonce check in revm\n env.evm_env.cfg_env.disable_nonce_check = true;\n\n let gas_price = gas_price.or(max_fee_per_gas).unwrap_or_else(|| {\n self.fees().raw_gas_price().saturating_add(MIN_SUGGESTED_PRIORITY_FEE)\n });\n let caller = from.unwrap_or_default();\n let to = to.as_ref().and_then(TxKind::to);\n let blob_hashes = blob_versioned_hashes.unwrap_or_default();\n let mut base = TxEnv {\n caller,\n gas_limit,\n gas_price,\n gas_priority_fee: max_priority_fee_per_gas,\n max_fee_per_blob_gas: max_fee_per_blob_gas\n .or_else(|| {\n if !blob_hashes.is_empty() {\n env.evm_env.block_env.blob_gasprice()\n } else {\n Some(0)\n }\n })\n .unwrap_or_default(),\n kind: match to {\n Some(addr) => TxKind::Call(*addr),\n None => TxKind::Create,\n },\n tx_type,\n value: value.unwrap_or_default(),\n data: input.into_input().unwrap_or_default(),\n chain_id: Some(chain_id.unwrap_or(self.env.read().evm_env.cfg_env.chain_id)),\n access_list: access_list.unwrap_or_default(),\n blob_hashes,\n ..Default::default()\n };\n base.set_signed_authorization(authorization_list.unwrap_or_default());\n env.tx = OpTransaction { base, ..Default::default() };\n\n if let Some(nonce) = nonce {\n env.tx.base.nonce = nonce;\n }\n\n if env.evm_env.block_env.basefee == 0 {\n // this is an edge case because the evm fails if `tx.effective_gas_price < base_fee`\n // 0 is only possible if it's manually set\n env.evm_env.cfg_env.disable_base_fee = true;\n }\n\n // Deposit transaction?\n if let Ok(deposit) = get_deposit_tx_parts(&other) {\n env.tx.deposit = deposit;\n }\n\n env\n }\n\n pub fn call_with_state(\n &self,\n state: &dyn DatabaseRef,\n request: WithOtherFields,\n fee_details: FeeDetails,\n block_env: BlockEnv,\n ) -> Result<(InstructionResult, Option, u128, State), BlockchainError> {\n let mut inspector = self.build_inspector();\n\n let env = self.build_call_env(request, fee_details, block_env);\n let mut evm = self.new_eth_evm_with_inspector_ref(state, &env, &mut inspector);\n let ResultAndState { result, state } = evm.transact(env.tx)?;\n let (exit_reason, gas_used, out) = match result {\n ExecutionResult::Success { reason, gas_used, output, .. } => {\n (reason.into(), gas_used, Some(output))\n }\n ExecutionResult::Revert { gas_used, output } => {\n (InstructionResult::Revert, gas_used, Some(Output::Call(output)))\n }\n ExecutionResult::Halt { reason, gas_used } => {\n (op_haltreason_to_instruction_result(reason), gas_used, None)\n }\n };\n drop(evm);\n inspector.print_logs();\n\n if self.print_traces {\n inspector.into_print_traces(self.call_trace_decoder.clone());\n }\n\n Ok((exit_reason, out, gas_used as u128, state))\n }\n\n pub fn build_access_list_with_state(\n &self,\n state: &dyn DatabaseRef,\n request: WithOtherFields,\n fee_details: FeeDetails,\n block_env: BlockEnv,\n ) -> Result<(InstructionResult, Option, u64, AccessList), BlockchainError> {\n let mut inspector =\n AccessListInspector::new(request.access_list.clone().unwrap_or_default());\n\n let env = self.build_call_env(request, fee_details, block_env);\n let mut evm = self.new_eth_evm_with_inspector_ref(state, &env, &mut inspector);\n let ResultAndState { result, state: _ } = evm.transact(env.tx)?;\n let (exit_reason, gas_used, out) = match result {\n ExecutionResult::Success { reason, gas_used, output, .. } => {\n (reason.into(), gas_used, Some(output))\n }\n ExecutionResult::Revert { gas_used, output } => {\n (InstructionResult::Revert, gas_used, Some(Output::Call(output)))\n }\n ExecutionResult::Halt { reason, gas_used } => {\n (op_haltreason_to_instruction_result(reason), gas_used, None)\n }\n };\n drop(evm);\n let access_list = inspector.access_list();\n Ok((exit_reason, out, gas_used, access_list))\n }\n\n pub fn get_code_with_state(\n &self,\n state: &dyn DatabaseRef,\n address: Address,\n ) -> Result {\n trace!(target: \"backend\", \"get code for {:?}\", address);\n let account = state.basic_ref(address)?.unwrap_or_default();\n if account.code_hash == KECCAK_EMPTY {\n // if the code hash is `KECCAK_EMPTY`, we check no further\n return Ok(Default::default());\n }\n let code = if let Some(code) = account.code {\n code\n } else {\n state.code_by_hash_ref(account.code_hash)?\n };\n Ok(code.bytes()[..code.len()].to_vec().into())\n }\n\n pub fn get_balance_with_state(\n &self,\n state: D,\n address: Address,\n ) -> Result\n where\n D: DatabaseRef,\n {\n trace!(target: \"backend\", \"get balance for {:?}\", address);\n Ok(state.basic_ref(address)?.unwrap_or_default().balance)\n }\n\n pub async fn transaction_by_block_number_and_index(\n &self,\n number: BlockNumber,\n index: Index,\n ) -> Result, BlockchainError> {\n if let Some(block) = self.mined_block_by_number(number) {\n return Ok(self.mined_transaction_by_block_hash_and_index(block.header.hash, index));\n }\n\n if let Some(fork) = self.get_fork() {\n let number = self.convert_block_number(Some(number));\n if fork.predates_fork(number) {\n return Ok(fork\n .transaction_by_block_number_and_index(number, index.into())\n .await?);\n }\n }\n\n Ok(None)\n }\n\n pub async fn transaction_by_block_hash_and_index(\n &self,\n hash: B256,\n index: Index,\n ) -> Result, BlockchainError> {\n if let tx @ Some(_) = self.mined_transaction_by_block_hash_and_index(hash, index) {\n return Ok(tx);\n }\n\n if let Some(fork) = self.get_fork() {\n return Ok(fork.transaction_by_block_hash_and_index(hash, index.into()).await?);\n }\n\n Ok(None)\n }\n\n pub fn mined_transaction_by_block_hash_and_index(\n &self,\n block_hash: B256,\n index: Index,\n ) -> Option {\n let (info, block, tx) = {\n let storage = self.blockchain.storage.read();\n let block = storage.blocks.get(&block_hash).cloned()?;\n let index: usize = index.into();\n let tx = block.body.transactions.get(index)?.clone();\n let info = storage.transactions.get(&tx.hash())?.info.clone();\n (info, block, tx)\n };\n\n Some(transaction_build(\n Some(info.transaction_hash),\n tx,\n Some(&block),\n Some(info),\n block.header.base_fee_per_gas(),\n ))\n }\n\n pub async fn transaction_by_hash(\n &self,\n hash: B256,\n ) -> Result, BlockchainError> {\n trace!(target: \"backend\", \"transaction_by_hash={:?}\", hash);\n if let tx @ Some(_) = self.mined_transaction_by_hash(hash) {\n return Ok(tx);\n }\n\n if let Some(fork) = self.get_fork() {\n return fork\n .transaction_by_hash(hash)\n .await\n .map_err(BlockchainError::AlloyForkProvider);\n }\n\n Ok(None)\n }\n\n pub fn mined_transaction_by_hash(&self, hash: B256) -> Option {\n let (info, block) = {\n let storage = self.blockchain.storage.read();\n let MinedTransaction { info, block_hash, .. } =\n storage.transactions.get(&hash)?.clone();\n let block = storage.blocks.get(&block_hash).cloned()?;\n (info, block)\n };\n let tx = block.body.transactions.get(info.transaction_index as usize)?.clone();\n\n Some(transaction_build(\n Some(info.transaction_hash),\n tx,\n Some(&block),\n Some(info),\n block.header.base_fee_per_gas(),\n ))\n }\n\n /// Returns the traces for the given transaction\n pub async fn trace_transaction(\n &self,\n hash: B256,\n ) -> Result, BlockchainError> {\n if let Some(traces) = self.mined_parity_trace_transaction(hash) {\n return Ok(traces);\n }\n\n if let Some(fork) = self.get_fork() {\n return Ok(fork.trace_transaction(hash).await?);\n }\n\n Ok(vec![])\n }\n\n /// Returns the traces for the given block\n pub async fn trace_block(\n &self,\n block: BlockNumber,\n ) -> Result, BlockchainError> {\n let number = self.convert_block_number(Some(block));\n if let Some(traces) = self.mined_parity_trace_block(number) {\n return Ok(traces);\n }\n\n if let Some(fork) = self.get_fork()\n && fork.predates_fork(number)\n {\n return Ok(fork.trace_block(number).await?);\n }\n\n Ok(vec![])\n }\n\n /// Replays all transactions in a block and returns the requested traces for each transaction\n pub async fn trace_replay_block_transactions(\n &self,\n block: BlockNumber,\n trace_types: HashSet,\n ) -> Result, BlockchainError> {\n let block_number = self.convert_block_number(Some(block));\n\n // Try mined blocks first\n if let Some(results) =\n self.mined_parity_trace_replay_block_transactions(block_number, &trace_types)\n {\n return Ok(results);\n }\n\n // Fallback to fork if block predates fork\n if let Some(fork) = self.get_fork()\n && fork.predates_fork(block_number)\n {\n return Ok(fork.trace_replay_block_transactions(block_number, trace_types).await?);\n }\n\n Ok(vec![])\n }\n\n /// Returns the trace results for all transactions in a mined block by replaying them\n fn mined_parity_trace_replay_block_transactions(\n &self,\n block_number: u64,\n trace_types: &HashSet,\n ) -> Option> {\n let block = self.get_block(block_number)?;\n\n // Execute this in the context of the parent state\n let parent_hash = block.header.parent_hash;\n let trace_config = TracingInspectorConfig::from_parity_config(trace_types);\n\n let read_guard = self.states.upgradable_read();\n if let Some(state) = read_guard.get_state(&parent_hash) {\n self.replay_block_transactions_with_inspector(&block, state, trace_config, trace_types)\n } else {\n let mut write_guard = RwLockUpgradableReadGuard::upgrade(read_guard);\n let state = write_guard.get_on_disk_state(&parent_hash)?;\n self.replay_block_transactions_with_inspector(&block, state, trace_config, trace_types)\n }\n }\n\n /// Replays all transactions in a block with the tracing inspector to generate TraceResults\n fn replay_block_transactions_with_inspector(\n &self,\n block: &Block,\n parent_state: &StateDb,\n trace_config: TracingInspectorConfig,\n trace_types: &HashSet,\n ) -> Option> {\n let mut cache_db = CacheDB::new(Box::new(parent_state));\n let mut results = Vec::new();\n\n // Configure the block environment\n let mut env = self.env.read().clone();\n env.evm_env.block_env = block_env_from_header(&block.header);\n\n // Execute each transaction in the block with tracing\n for tx_envelope in &block.body.transactions {\n let tx_hash = tx_envelope.hash();\n\n // Create a fresh inspector for this transaction\n let mut inspector = TracingInspector::new(trace_config);\n\n // Prepare transaction environment\n let pending_tx =\n PendingTransaction::from_maybe_impersonated(tx_envelope.clone()).ok()?;\n let mut tx_env: OpTransaction = FromRecoveredTx::from_recovered_tx(\n pending_tx.transaction.as_ref(),\n *pending_tx.sender(),\n );\n if env.networks.is_optimism() {\n tx_env.enveloped_tx = Some(pending_tx.transaction.encoded_2718().into());\n }\n\n // Execute the transaction with the inspector\n let mut evm = self.new_eth_evm_with_inspector_ref(&cache_db, &env, &mut inspector);\n let result = evm.transact(tx_env.clone()).ok()?;\n\n // Build TraceResults from the inspector and execution result\n let full_trace = inspector\n .into_parity_builder()\n .into_trace_results_with_state(&result, trace_types, &cache_db)\n .ok()?;\n\n results.push(TraceResultsWithTransactionHash { transaction_hash: tx_hash, full_trace });\n\n // Commit the state changes for the next transaction\n cache_db.commit(result.state);\n }\n\n Some(results)\n }\n\n // Returns the traces matching a given filter\n pub async fn trace_filter(\n &self,\n filter: TraceFilter,\n ) -> Result, BlockchainError> {\n let matcher = filter.matcher();\n let start = filter.from_block.unwrap_or(0);\n let end = filter.to_block.unwrap_or_else(|| self.best_number());\n\n if start > end {\n return Err(BlockchainError::RpcError(RpcError::invalid_params(\n \"invalid block range, ensure that to block is greater than from block\".to_string(),\n )));\n }\n\n let dist = end - start;\n if dist > 300 {\n return Err(BlockchainError::RpcError(RpcError::invalid_params(\n \"block range too large, currently limited to 300\".to_string(),\n )));\n }\n\n // Accumulate tasks for block range\n let mut trace_tasks = vec![];\n for num in start..=end {\n trace_tasks.push(self.trace_block(num.into()));\n }\n\n // Execute tasks and filter traces\n let traces = futures::future::try_join_all(trace_tasks).await?;\n let filtered_traces =\n traces.into_iter().flatten().filter(|trace| matcher.matches(&trace.trace));\n\n // Apply after and count\n let filtered_traces: Vec<_> = if let Some(after) = filter.after {\n filtered_traces.skip(after as usize).collect()\n } else {\n filtered_traces.collect()\n };\n\n let filtered_traces: Vec<_> = if let Some(count) = filter.count {\n filtered_traces.into_iter().take(count as usize).collect()\n } else {\n filtered_traces\n };\n\n Ok(filtered_traces)\n }\n\n pub fn get_blobs_by_block_id(\n &self,\n id: impl Into,\n versioned_hashes: Vec,\n ) -> Result>> {\n Ok(self.get_block(id).map(|block| {\n block\n .body\n .transactions\n .iter()\n .filter_map(|tx| tx.as_ref().sidecar())\n .flat_map(|sidecar| {\n sidecar.sidecar.blobs().iter().zip(sidecar.sidecar.commitments().iter())\n })\n .filter(|(_, commitment)| {\n // Filter blobs by versioned_hashes if provided\n versioned_hashes.is_empty()\n || versioned_hashes.contains(&kzg_to_versioned_hash(commitment.as_slice()))\n })\n .map(|(blob, _)| *blob)\n .collect()\n }))\n }\n\n pub fn get_blob_by_versioned_hash(&self, hash: B256) -> Result> {\n let storage = self.blockchain.storage.read();\n for block in storage.blocks.values() {\n for tx in &block.body.transactions {\n let typed_tx = tx.as_ref();\n if let Some(sidecar) = typed_tx.sidecar() {\n for versioned_hash in sidecar.sidecar.versioned_hashes() {\n if versioned_hash == hash\n && let Some(index) =\n sidecar.sidecar.commitments().iter().position(|commitment| {\n kzg_to_versioned_hash(commitment.as_slice()) == *hash\n })\n && let Some(blob) = sidecar.sidecar.blobs().get(index)\n {\n return Ok(Some(*blob));\n }\n }\n }\n }\n }\n Ok(None)\n }\n\n /// Initialises the balance of the given accounts\n #[expect(clippy::too_many_arguments)]\n pub async fn with_genesis(\n db: Arc>>,\n env: Arc>,\n genesis: GenesisConfig,\n fees: FeeManager,\n fork: Arc>>,\n enable_steps_tracing: bool,\n print_logs: bool,\n print_traces: bool,\n call_trace_decoder: Arc,\n prune_state_history_config: PruneStateHistoryConfig,\n max_persisted_states: Option,\n transaction_block_keeper: Option,\n automine_block_time: Option,\n cache_path: Option,\n node_config: Arc>,\n ) -> Result {\n // if this is a fork then adjust the blockchain storage\n let blockchain = if let Some(fork) = fork.read().as_ref() {\n trace!(target: \"backend\", \"using forked blockchain at {}\", fork.block_number());\n Blockchain::forked(fork.block_number(), fork.block_hash(), fork.total_difficulty())\n } else {\n let env = env.read();\n Blockchain::new(\n &env,\n env.evm_env.cfg_env.spec,\n fees.is_eip1559().then(|| fees.base_fee()),\n genesis.timestamp,\n genesis.number,\n )\n };\n\n // Sync EVM block.number with genesis for non-fork mode.\n // Fork mode syncs in setup_fork_db_config() instead.\n if fork.read().is_none() {\n let mut write_env = env.write();\n write_env.evm_env.block_env.number = U256::from(genesis.number);\n }\n\n let start_timestamp = if let Some(fork) = fork.read().as_ref() {\n fork.timestamp()\n } else {\n genesis.timestamp\n };\n\n let mut states = if prune_state_history_config.is_config_enabled() {\n // if prune state history is enabled, configure the state cache only for memory\n prune_state_history_config\n .max_memory_history\n .map(|limit| InMemoryBlockStates::new(limit, 0))\n .unwrap_or_default()\n .memory_only()\n } else if max_persisted_states.is_some() {\n max_persisted_states\n .map(|limit| InMemoryBlockStates::new(DEFAULT_HISTORY_LIMIT, limit))\n .unwrap_or_default()\n } else {\n Default::default()\n };\n\n if let Some(cache_path) = cache_path {\n states = states.disk_path(cache_path);\n }\n\n let (slots_in_an_epoch, precompile_factory, disable_pool_balance_checks) = {\n let cfg = node_config.read().await;\n (cfg.slots_in_an_epoch, cfg.precompile_factory.clone(), cfg.disable_pool_balance_checks)\n };\n\n let backend = Self {\n db,\n blockchain,\n states: Arc::new(RwLock::new(states)),\n env,\n fork,\n time: TimeManager::new(start_timestamp),\n cheats: Default::default(),\n new_block_listeners: Default::default(),\n fees,\n genesis,\n active_state_snapshots: Arc::new(Mutex::new(Default::default())),\n enable_steps_tracing,\n print_logs,\n print_traces,\n call_trace_decoder,\n prune_state_history_config,\n transaction_block_keeper,\n node_config,\n slots_in_an_epoch,\n precompile_factory,\n mining: Arc::new(tokio::sync::Mutex::new(())),\n disable_pool_balance_checks,\n };\n\n if let Some(interval_block_time) = automine_block_time {\n backend.update_interval_mine_block_time(interval_block_time);\n }\n\n // Note: this can only fail in forking mode, in which case we can't recover\n backend.apply_genesis().await.wrap_err(\"failed to create genesis\")?;\n Ok(backend)\n }\n\n /// Applies the configured genesis settings\n ///\n /// This will fund, create the genesis accounts\n async fn apply_genesis(&self) -> Result<(), DatabaseError> {\n trace!(target: \"backend\", \"setting genesis balances\");\n\n if self.fork.read().is_some() {\n // fetch all account first\n let mut genesis_accounts_futures = Vec::with_capacity(self.genesis.accounts.len());\n for address in self.genesis.accounts.iter().copied() {\n let db = Arc::clone(&self.db);\n\n // The forking Database backend can handle concurrent requests, we can fetch all dev\n // accounts concurrently by spawning the job to a new task\n genesis_accounts_futures.push(tokio::task::spawn(async move {\n let db = db.read().await;\n let info = db.basic_ref(address)?.unwrap_or_default();\n Ok::<_, DatabaseError>((address, info))\n }));\n }\n\n let genesis_accounts = futures::future::join_all(genesis_accounts_futures).await;\n\n let mut db = self.db.write().await;\n\n for res in genesis_accounts {\n let (address, mut info) = res.unwrap()?;\n info.balance = self.genesis.balance;\n db.insert_account(address, info.clone());\n }\n } else {\n let mut db = self.db.write().await;\n for (account, info) in self.genesis.account_infos() {\n db.insert_account(account, info);\n }\n\n // insert the new genesis hash to the database so it's available for the next block in\n // the evm\n db.insert_block_hash(U256::from(self.best_number()), self.best_hash());\n\n // Deploy EIP-2935 blockhash history storage contract if Prague is active.\n if self.spec_id() >= SpecId::PRAGUE {\n db.set_code(\n eip2935::HISTORY_STORAGE_ADDRESS,\n eip2935::HISTORY_STORAGE_CODE.clone(),\n )?;\n }\n }\n\n let db = self.db.write().await;\n // apply the genesis.json alloc\n self.genesis.apply_genesis_json_alloc(db)?;\n\n trace!(target: \"backend\", \"set genesis balances\");\n\n Ok(())\n }\n\n /// Resets the fork to a fresh state\n pub async fn reset_fork(&self, forking: Forking) -> Result<(), BlockchainError> {\n if !self.is_fork() {\n if let Some(eth_rpc_url) = forking.json_rpc_url.clone() {\n let mut env = self.env.read().clone();\n\n let (db, config) = {\n let mut node_config = self.node_config.write().await;\n\n // we want to force the correct base fee for the next block during\n // `setup_fork_db_config`\n node_config.base_fee.take();\n\n node_config.setup_fork_db_config(eth_rpc_url, &mut env, &self.fees).await?\n };\n\n *self.db.write().await = Box::new(db);\n\n let fork = ClientFork::new(config, Arc::clone(&self.db));\n\n *self.env.write() = env;\n *self.fork.write() = Some(fork);\n } else {\n return Err(RpcError::invalid_params(\n \"Forking not enabled and RPC URL not provided to start forking\",\n )\n .into());\n }\n }\n\n if let Some(fork) = self.get_fork() {\n let block_number =\n forking.block_number.map(BlockNumber::from).unwrap_or(BlockNumber::Latest);\n // reset the fork entirely and reapply the genesis config\n fork.reset(forking.json_rpc_url.clone(), block_number).await?;\n let fork_block_number = fork.block_number();\n let fork_block = fork\n .block_by_number(fork_block_number)\n .await?\n .ok_or(BlockchainError::BlockNotFound)?;\n // update all settings related to the forked block\n {\n if let Some(fork_url) = forking.json_rpc_url {\n self.reset_block_number(fork_url, fork_block_number).await?;\n } else {\n // If rpc url is unspecified, then update the fork with the new block number and\n // existing rpc url, this updates the cache path\n {\n let maybe_fork_url = { self.node_config.read().await.eth_rpc_url.clone() };\n if let Some(fork_url) = maybe_fork_url {\n self.reset_block_number(fork_url, fork_block_number).await?;\n }\n }\n\n let gas_limit = self.node_config.read().await.fork_gas_limit(&fork_block);\n let mut env = self.env.write();\n\n env.evm_env.cfg_env.chain_id = fork.chain_id();\n env.evm_env.block_env = BlockEnv {\n number: U256::from(fork_block_number),\n timestamp: U256::from(fork_block.header.timestamp()),\n gas_limit,\n difficulty: fork_block.header.difficulty(),\n prevrandao: Some(fork_block.header.mix_hash().unwrap_or_default()),\n // Keep previous `beneficiary` and `basefee` value\n beneficiary: env.evm_env.block_env.beneficiary,\n basefee: env.evm_env.block_env.basefee,\n ..env.evm_env.block_env.clone()\n };\n\n // this is the base fee of the current block, but we need the base fee of\n // the next block\n let next_block_base_fee = self.fees.get_next_block_base_fee_per_gas(\n fork_block.header.gas_used(),\n gas_limit,\n fork_block.header.base_fee_per_gas().unwrap_or_default(),\n );\n\n self.fees.set_base_fee(next_block_base_fee);\n }\n\n // reset the time to the timestamp of the forked block\n self.time.reset(fork_block.header.timestamp());\n\n // also reset the total difficulty\n self.blockchain.storage.write().total_difficulty = fork.total_difficulty();\n }\n // reset storage\n *self.blockchain.storage.write() = BlockchainStorage::forked(\n fork.block_number(),\n fork.block_hash(),\n fork.total_difficulty(),\n );\n self.states.write().clear();\n self.db.write().await.clear();\n\n self.apply_genesis().await?;\n\n trace!(target: \"backend\", \"reset fork\");\n\n Ok(())\n } else {\n Err(RpcError::invalid_params(\"Forking not enabled\").into())\n }\n }\n\n /// Resets the backend to a fresh in-memory state, clearing all existing data\n pub async fn reset_to_in_mem(&self) -> Result<(), BlockchainError> {\n // Clear the fork if any exists\n *self.fork.write() = None;\n\n // Get environment and genesis config\n let env = self.env.read().clone();\n let genesis_timestamp = self.genesis.timestamp;\n let genesis_number = self.genesis.number;\n let spec_id = self.spec_id();\n\n // Reset environment to genesis state\n {\n let mut env = self.env.write();\n env.evm_env.block_env.number = U256::from(genesis_number);\n env.evm_env.block_env.timestamp = U256::from(genesis_timestamp);\n // Reset other block env fields to their defaults\n env.evm_env.block_env.basefee = self.fees.base_fee();\n env.evm_env.block_env.prevrandao = Some(B256::ZERO);\n }\n\n // Clear all storage and reinitialize with genesis\n let base_fee = if self.fees.is_eip1559() { Some(self.fees.base_fee()) } else { None };\n *self.blockchain.storage.write() =\n BlockchainStorage::new(&env, spec_id, base_fee, genesis_timestamp, genesis_number);\n self.states.write().clear();\n\n // Clear the database\n self.db.write().await.clear();\n\n // Reset time manager\n self.time.reset(genesis_timestamp);\n\n // Reset fees to initial state\n if self.fees.is_eip1559() {\n self.fees.set_base_fee(crate::eth::fees::INITIAL_BASE_FEE);\n }\n\n self.fees.set_gas_price(crate::eth::fees::INITIAL_GAS_PRICE);\n\n // Reapply genesis configuration\n self.apply_genesis().await?;\n\n trace!(target: \"backend\", \"reset to fresh in-memory state\");\n\n Ok(())\n }\n\n async fn reset_block_number(\n &self,\n fork_url: String,\n fork_block_number: u64,\n ) -> Result<(), BlockchainError> {\n let mut node_config = self.node_config.write().await;\n node_config.fork_choice = Some(ForkChoice::Block(fork_block_number as i128));\n\n let mut env = self.env.read().clone();\n let (forked_db, client_fork_config) =\n node_config.setup_fork_db_config(fork_url, &mut env, &self.fees).await?;\n\n *self.db.write().await = Box::new(forked_db);\n let fork = ClientFork::new(client_fork_config, Arc::clone(&self.db));\n *self.fork.write() = Some(fork);\n *self.env.write() = env;\n\n Ok(())\n }\n\n /// Reverts the state to the state snapshot identified by the given `id`.\n pub async fn revert_state_snapshot(&self, id: U256) -> Result {\n let block = { self.active_state_snapshots.lock().remove(&id) };\n if let Some((num, hash)) = block {\n let best_block_hash = {\n // revert the storage that's newer than the snapshot\n let current_height = self.best_number();\n let mut storage = self.blockchain.storage.write();\n\n for n in ((num + 1)..=current_height).rev() {\n trace!(target: \"backend\", \"reverting block {}\", n);\n if let Some(hash) = storage.hashes.remove(&n)\n && let Some(block) = storage.blocks.remove(&hash)\n {\n for tx in block.body.transactions {\n let _ = storage.transactions.remove(&tx.hash());\n }\n }\n }\n\n storage.best_number = num;\n storage.best_hash = hash;\n hash\n };\n let block =\n self.block_by_hash(best_block_hash).await?.ok_or(BlockchainError::BlockNotFound)?;\n\n let reset_time = block.header.timestamp();\n self.time.reset(reset_time);\n\n let mut env = self.env.write();\n env.evm_env.block_env = BlockEnv {\n number: U256::from(num),\n timestamp: U256::from(block.header.timestamp()),\n difficulty: block.header.difficulty(),\n // ensures prevrandao is set\n prevrandao: Some(block.header.mix_hash().unwrap_or_default()),\n gas_limit: block.header.gas_limit(),\n // Keep previous `beneficiary` and `basefee` value\n beneficiary: env.evm_env.block_env.beneficiary,\n basefee: env.evm_env.block_env.basefee,\n ..Default::default()\n }\n }\n Ok(self.db.write().await.revert_state(id, RevertStateSnapshotAction::RevertRemove))\n }\n\n /// executes the transactions without writing to the underlying database\n pub async fn inspect_tx(\n &self,\n tx: Arc>,\n ) -> Result<\n (InstructionResult, Option, u64, State, Vec),\n BlockchainError,\n > {\n let mut env = self.next_env();\n env.tx = FromRecoveredTx::from_recovered_tx(\n tx.pending_transaction.transaction.as_ref(),\n *tx.pending_transaction.sender(),\n );\n\n if env.networks.is_optimism() {\n env.tx.enveloped_tx = Some(tx.pending_transaction.transaction.encoded_2718().into());\n }\n\n let db = self.db.read().await;\n let mut inspector = self.build_inspector();\n let mut evm = self.new_eth_evm_with_inspector_ref(&**db, &env, &mut inspector);\n let ResultAndState { result, state } = evm.transact(env.tx)?;\n let (exit_reason, gas_used, out, logs) = match result {\n ExecutionResult::Success { reason, gas_used, logs, output, .. } => {\n (reason.into(), gas_used, Some(output), Some(logs))\n }\n ExecutionResult::Revert { gas_used, output } => {\n (InstructionResult::Revert, gas_used, Some(Output::Call(output)), None)\n }\n ExecutionResult::Halt { reason, gas_used } => {\n let eth_reason = op_haltreason_to_instruction_result(reason);\n (eth_reason, gas_used, None, None)\n }\n };\n\n drop(evm);\n inspector.print_logs();\n\n if self.print_traces {\n inspector.print_traces(self.call_trace_decoder.clone());\n }\n\n Ok((exit_reason, out, gas_used, state, logs.unwrap_or_default()))\n }\n}\n\nimpl Backend\nwhere\n N::ReceiptEnvelope: alloy_consensus::TxReceipt + Clone,\n{\n /// Returns all `Log`s mined by the node that were emitted in the `block` and match the `Filter`\n fn mined_logs_for_block(&self, filter: Filter, block: Block, block_hash: B256) -> Vec {\n let mut all_logs = Vec::new();\n let mut block_log_index = 0u32;\n\n let storage = self.blockchain.storage.read();\n\n for tx in block.body.transactions {\n let Some(tx) = storage.transactions.get(&tx.hash()) else {\n continue;\n };\n\n let logs = tx.receipt.logs();\n let transaction_hash = tx.info.transaction_hash;\n\n for log in logs {\n if filter.matches(log) {\n all_logs.push(Log {\n inner: log.clone(),\n block_hash: Some(block_hash),\n block_number: Some(block.header.number()),\n block_timestamp: Some(block.header.timestamp()),\n transaction_hash: Some(transaction_hash),\n transaction_index: Some(tx.info.transaction_index),\n log_index: Some(block_log_index as u64),\n removed: false,\n });\n }\n block_log_index += 1;\n }\n }\n all_logs\n }\n\n /// Returns the logs of the block that match the filter\n async fn logs_for_block(\n &self,\n filter: Filter,\n hash: B256,\n ) -> Result, BlockchainError> {\n if let Some(block) = self.blockchain.get_block_by_hash(&hash) {\n return Ok(self.mined_logs_for_block(filter, block, hash));\n }\n\n if let Some(fork) = self.get_fork() {\n return Ok(fork.logs(&filter).await?);\n }\n\n Ok(Vec::new())\n }\n\n /// Returns the logs that match the filter in the given range of blocks\n async fn logs_for_range(\n &self,\n filter: &Filter,\n mut from: u64,\n to: u64,\n ) -> Result, BlockchainError> {\n let mut all_logs = Vec::new();\n\n // get the range that predates the fork if any\n if let Some(fork) = self.get_fork() {\n let mut to_on_fork = to;\n\n if !fork.predates_fork(to) {\n // adjust the ranges\n to_on_fork = fork.block_number();\n }\n\n if fork.predates_fork_inclusive(from) {\n // this data is only available on the forked client\n let filter = filter.clone().from_block(from).to_block(to_on_fork);\n all_logs = fork.logs(&filter).await?;\n\n // update the range\n from = fork.block_number() + 1;\n }\n }\n\n for number in from..=to {\n if let Some((block, hash)) = self.get_block_with_hash(number) {\n all_logs.extend(self.mined_logs_for_block(filter.clone(), block, hash));\n }\n }\n\n Ok(all_logs)\n }\n\n /// Returns the logs according to the filter\n pub async fn logs(&self, filter: Filter) -> Result, BlockchainError> {\n trace!(target: \"backend\", \"get logs [{:?}]\", filter);\n if let Some(hash) = filter.get_block_hash() {\n self.logs_for_block(filter, hash).await\n } else {\n let best = self.best_number();\n let to_block =\n self.convert_block_number(filter.block_option.get_to_block().copied()).min(best);\n let from_block =\n self.convert_block_number(filter.block_option.get_from_block().copied());\n if from_block > best {\n return Err(BlockchainError::BlockOutOfRange(best, from_block));\n }\n\n self.logs_for_range(&filter, from_block, to_block).await\n }\n }\n\n /// Returns all receipts of the block\n pub fn mined_receipts(&self, hash: B256) -> Option> {\n let block = self.mined_block_by_hash(hash)?;\n let mut receipts = Vec::new();\n let storage = self.blockchain.storage.read();\n for tx in block.transactions.hashes() {\n let receipt = storage.transactions.get(&tx)?.receipt.clone();\n receipts.push(receipt);\n }\n Some(receipts)\n }\n}\n\n// Mining methods ā€” generic over N: Network, with Foundry-associated-type bounds for now.\nimpl Backend\nwhere\n Self: TransactionValidator,\n N: Network,\n{\n /// Mines a new block and stores it.\n ///\n /// this will execute all transaction in the order they come in and return all the markers they\n /// provide.\n pub async fn mine_block(\n &self,\n pool_transactions: Vec>>,\n ) -> MinedBlockOutcome {\n self.do_mine_block(pool_transactions).await\n }\n\n async fn do_mine_block(\n &self,\n pool_transactions: Vec>>,\n ) -> MinedBlockOutcome {\n let _mining_guard = self.mining.lock().await;\n trace!(target: \"backend\", \"creating new block with {} transactions\", pool_transactions.len());\n\n let (outcome, header, block_hash) = {\n let current_base_fee = self.base_fee();\n let current_excess_blob_gas_and_price = self.excess_blob_gas_and_price();\n\n let mut env = self.env.read().clone();\n\n if env.evm_env.block_env.basefee == 0 {\n // this is an edge case because the evm fails if `tx.effective_gas_price < base_fee`\n // 0 is only possible if it's manually set\n env.evm_env.cfg_env.disable_base_fee = true;\n }\n\n let block_number = self.blockchain.storage.read().best_number.saturating_add(1);\n\n // increase block number for this block\n if is_arbitrum(env.evm_env.cfg_env.chain_id) {\n // Temporary set `env.block.number` to `block_number` for Arbitrum chains.\n env.evm_env.block_env.number = U256::from(block_number);\n } else {\n env.evm_env.block_env.number =\n env.evm_env.block_env.number.saturating_add(U256::from(1));\n }\n\n env.evm_env.block_env.basefee = current_base_fee;\n env.evm_env.block_env.blob_excess_gas_and_price = current_excess_blob_gas_and_price;\n\n let best_hash = self.blockchain.storage.read().best_hash;\n\n let mut input = Vec::with_capacity(40);\n input.extend_from_slice(best_hash.as_slice());\n input.extend_from_slice(&block_number.to_le_bytes());\n env.evm_env.block_env.prevrandao = Some(keccak256(&input));\n\n if self.prune_state_history_config.is_state_history_supported() {\n let db = self.db.read().await.current_state();\n // store current state before executing all transactions\n self.states.write().insert(best_hash, db);\n }\n\n let (block_info, included, invalid, block_hash) = {\n let mut db = self.db.write().await;\n\n // finally set the next block timestamp, this is done just before execution, because\n // there can be concurrent requests that can delay acquiring the db lock and we want\n // to ensure the timestamp is as close as possible to the actual execution.\n env.evm_env.block_env.timestamp = U256::from(self.time.next_timestamp());\n\n let spec_id = *env.evm_env.spec_id();\n let is_shanghai = spec_id >= SpecId::SHANGHAI;\n let is_cancun = spec_id >= SpecId::CANCUN;\n let is_prague = spec_id >= SpecId::PRAGUE;\n let gas_limit = env.evm_env.block_env.gas_limit;\n let difficulty = env.evm_env.block_env.difficulty;\n let mix_hash = env.evm_env.block_env.prevrandao;\n let beneficiary = env.evm_env.block_env.beneficiary;\n let timestamp = env.evm_env.block_env.timestamp;\n let base_fee = if spec_id >= SpecId::LONDON {\n Some(env.evm_env.block_env.basefee)\n } else {\n None\n };\n let excess_blob_gas =\n if is_cancun { env.evm_env.block_env.blob_excess_gas() } else { None };\n\n // 1. Build inspector (per-block, NOT per-tx)\n let mut inspector = AnvilInspector::default().with_tracing();\n if self.enable_steps_tracing {\n inspector = inspector.with_steps_tracing();\n }\n if self.print_logs {\n inspector = inspector.with_log_collector();\n }\n if self.print_traces {\n inspector = inspector.with_trace_printer();\n }\n\n // 2. Create EVM\n let env_struct = Env::new(env.evm_env.clone(), Default::default(), env.networks);\n let mut evm = new_eth_evm_with_inspector(&mut **db, &env_struct, inspector);\n\n // 3. Inject precompiles (once, before the tx loop)\n env.networks.inject_precompiles(evm.precompiles_mut());\n if let Some(factory) = &self.precompile_factory {\n evm.precompiles_mut().extend_precompiles(factory.precompiles());\n }\n let cheats = self.cheats().clone();\n if cheats.has_recover_overrides() {\n let cheats_arc = Arc::new(cheats.clone());\n let cheat_ecrecover = CheatEcrecover::new(Arc::clone(&cheats_arc));\n evm.precompiles_mut().apply_precompile(&EC_RECOVER, move |_| {\n Some(DynPrecompile::new_stateful(\n cheat_ecrecover.precompile_id().clone(),\n move |input| cheat_ecrecover.call(input),\n ))\n });\n }\n\n // 4. Create executor via AnvilBlockExecutorFactory\n let exec_ctx = AnvilExecutionCtx { parent_hash: best_hash, is_prague, is_cancun };\n let mut executor = AnvilBlockExecutorFactory::create_executor(evm, exec_ctx);\n executor.apply_pre_execution_changes().expect(\"pre-execution changes failed\");\n\n // 5. Per-tx loop\n let mut included: Vec>> = Vec::new();\n let mut invalid: Vec>> = Vec::new();\n let mut transaction_infos: Vec = Vec::new();\n let mut transactions = Vec::new();\n let mut bloom = Bloom::default();\n\n let blob_params = self.blob_params();\n let networks = env.networks;\n let mut cumulative_blob_gas_used = if is_cancun { Some(0u64) } else { None };\n\n for pool_tx in pool_transactions {\n let pending = &pool_tx.pending_transaction;\n let sender = *pending.sender();\n\n let account = match executor\n .evm_mut()\n .db_mut()\n .basic(sender)\n .map(|a| a.unwrap_or_default())\n {\n Ok(acc) => acc,\n Err(err) => {\n trace!(target: \"backend\", ?err, \"db error for tx {:?}, skipping\", pool_tx.hash());\n continue;\n }\n };\n\n // Build the per-tx env\n let tx_env = build_tx_env_for_pending(pending, &cheats, networks, &env.evm_env);\n let full_env = Env::new(env.evm_env.clone(), tx_env.clone(), networks);\n\n // Gas limit checks (same logic as TransactionExecutor::next)\n let cumulative_gas =\n executor.receipts().last().map(|r| r.cumulative_gas_used()).unwrap_or(0);\n let max_block_gas =\n cumulative_gas.saturating_add(pending.transaction.gas_limit());\n if !env.evm_env.cfg_env.disable_block_gas_limit && max_block_gas > gas_limit {\n trace!(target: \"backend\", tx_gas_limit = %pending.transaction.gas_limit(), ?pool_tx, \"block gas limit exhausting, skipping transaction\");\n continue;\n }\n\n // Osaka EIP-7825 tx gas limit cap check\n if env.evm_env.cfg_env.tx_gas_limit_cap.is_none()\n && pending.transaction.gas_limit() > env.evm_env.cfg_env.tx_gas_limit_cap()\n {\n trace!(target: \"backend\", tx_gas_limit = %pending.transaction.gas_limit(), ?pool_tx, \"transaction gas limit exhausting, skipping transaction\");\n continue;\n }\n\n // Blob gas check\n let tx_blob_gas = pending.transaction.blob_gas_used().unwrap_or(0);\n let current_blob_gas = cumulative_blob_gas_used.unwrap_or(0);\n if current_blob_gas.saturating_add(tx_blob_gas)\n > blob_params.max_blob_gas_per_block()\n {\n trace!(target: \"backend\", blob_gas = %tx_blob_gas, ?pool_tx, \"block blob gas limit exhausting, skipping transaction\");\n continue;\n }\n\n // Validate\n if let Err(err) =\n self.validate_pool_transaction_for(pending, &account, &full_env)\n {\n warn!(target: \"backend\", \"Skipping invalid tx execution [{:?}] {}\", pool_tx.hash(), err);\n invalid.push(pool_tx.clone());\n continue;\n }\n\n let nonce = account.nonce;\n\n // Execute via block executor\n let recovered =\n Recovered::new_unchecked(pending.transaction.as_ref().clone(), sender);\n trace!(target: \"backend\", \"[{:?}] executing\", pool_tx.hash());\n match executor.execute_transaction_without_commit((tx_env, recovered)) {\n Ok(result) => {\n let exec_result = result.inner.result.result.clone();\n let gas_used = result.inner.result.result.gas_used();\n\n executor.commit_transaction(result).expect(\"commit failed\");\n\n // Drain per-tx traces from inspector\n let insp = executor.evm_mut().inspector_mut();\n\n // Print before draining so the tracer is still populated.\n if self.print_traces {\n insp.print_traces(self.call_trace_decoder.clone());\n }\n insp.print_logs();\n\n let traces = insp\n .tracer\n .take()\n .map(|t| t.into_traces().into_nodes())\n .unwrap_or_default();\n\n // Reinstall tracer for next tx\n if self.enable_steps_tracing {\n insp.tracer = Some(TracingInspector::new(\n TracingInspectorConfig::all().with_state_diffs(),\n ));\n } else {\n insp.tracer = Some(TracingInspector::new(\n TracingInspectorConfig::all().set_steps(false),\n ));\n }\n // Reset log collector for next tx\n if self.print_logs {\n insp.log_collector =\n Some(foundry_evm::inspectors::LogCollector::Capture {\n logs: Vec::new(),\n });\n }\n\n // Track blob gas\n if is_cancun {\n cumulative_blob_gas_used = Some(\n cumulative_blob_gas_used\n .unwrap_or(0)\n .saturating_add(tx_blob_gas),\n );\n }\n\n let (exit_reason, out, logs) = match exec_result {\n ExecutionResult::Success {\n reason,\n gas_used: _,\n logs,\n output,\n ..\n } => (reason.into(), Some(output), logs),\n ExecutionResult::Revert { gas_used: _, output } => (\n InstructionResult::Revert,\n Some(Output::Call(output)),\n Vec::new(),\n ),\n ExecutionResult::Halt { reason, gas_used: _ } => {\n (op_haltreason_to_instruction_result(reason), None, Vec::new())\n }\n };\n\n if exit_reason == InstructionResult::OutOfGas {\n warn!(target: \"backend\", \"[{:?}] executed with out of gas\", pool_tx.hash());\n }\n\n trace!(target: \"backend\", ?exit_reason, ?gas_used, \"[{:?}] executed with out={:?}\", pool_tx.hash(), out);\n trace!(target: \"backend::executor\", \"transacted [{:?}], result: {:?} gas {}\", pool_tx.hash(), exit_reason, gas_used);\n\n // Build bloom from logs\n for log in &logs {\n bloom.accrue(BloomInput::Raw(&log.address[..]));\n for topic in log.topics() {\n bloom.accrue(BloomInput::Raw(&topic[..]));\n }\n }\n\n // Contract address for creation txs\n let contract_address = if pending.transaction.to().is_none() {\n let addr = sender.create(nonce);\n trace!(target: \"backend\", \"Contract creation tx: computed address {:?}\", addr);\n Some(addr)\n } else {\n None\n };\n\n let transaction_index = transaction_infos.len() as u64;\n let info = TransactionInfo {\n transaction_hash: pool_tx.hash(),\n transaction_index,\n from: sender,\n to: pending.transaction.to(),\n contract_address,\n traces,\n exit: exit_reason,\n out: out.map(Output::into_data),\n nonce,\n gas_used,\n };\n\n included.push(pool_tx.clone());\n transaction_infos.push(info);\n transactions.push(pending.transaction.clone());\n }\n Err(err) => {\n trace!(target: \"backend\", ?err, \"tx execution error, skipping {:?}\", pool_tx.hash());\n }\n }\n }\n\n // 6. Finish ā€” drop EVM BEFORE accessing db again\n let (evm, block_result) = executor.finish().expect(\"executor finish failed\");\n drop(evm);\n\n let state_root = db.maybe_state_root().unwrap_or_default();\n\n // 7. Build block header\n let receipts_root = calculate_receipt_root(&block_result.receipts);\n\n let cumulative_gas_used = block_result.gas_used;\n\n let header = Header {\n parent_hash: best_hash,\n ommers_hash: Default::default(),\n beneficiary,\n state_root,\n transactions_root: Default::default(),\n receipts_root,\n logs_bloom: bloom,\n difficulty,\n number: block_number,\n gas_limit,\n gas_used: cumulative_gas_used,\n timestamp: timestamp.saturating_to(),\n extra_data: Default::default(),\n mix_hash: mix_hash.unwrap_or_default(),\n nonce: Default::default(),\n base_fee_per_gas: base_fee,\n parent_beacon_block_root: is_cancun.then_some(Default::default()),\n blob_gas_used: cumulative_blob_gas_used,\n excess_blob_gas,\n withdrawals_root: is_shanghai.then_some(EMPTY_WITHDRAWALS),\n requests_hash: is_prague.then_some(EMPTY_REQUESTS_HASH),\n };\n\n let block = create_block(header, transactions);\n let block_info = TypedBlockInfo {\n block,\n transactions: transaction_infos,\n receipts: block_result.receipts,\n };\n\n // update the new blockhash in the db itself\n let block_hash = block_info.block.header.hash_slow();\n db.insert_block_hash(U256::from(block_info.block.header.number()), block_hash);\n\n (block_info, included, invalid, block_hash)\n };\n\n // create the new block with the current timestamp\n let BlockInfo { block, transactions, receipts } = block_info;\n\n let header = block.header.clone();\n\n trace!(\n target: \"backend\",\n \"Mined block {} with {} tx {:?}\",\n block_number,\n transactions.len(),\n transactions.iter().map(|tx| tx.transaction_hash).collect::>()\n );\n let mut storage = self.blockchain.storage.write();\n // update block metadata\n storage.best_number = block_number;\n storage.best_hash = block_hash;\n // Difficulty is removed and not used after Paris (aka TheMerge). Value is replaced with\n // prevrandao. https://github.com/bluealloy/revm/blob/1839b3fce8eaeebb85025576f2519b80615aca1e/crates/interpreter/src/instructions/host_env.rs#L27\n if !self.is_eip3675() {\n storage.total_difficulty =\n storage.total_difficulty.saturating_add(header.difficulty);\n }\n\n storage.blocks.insert(block_hash, block);\n storage.hashes.insert(block_number, block_hash);\n\n node_info!(\"\");\n // insert all transactions\n for (info, receipt) in transactions.into_iter().zip(receipts) {\n // log some tx info\n node_info!(\" Transaction: {:?}\", info.transaction_hash);\n if let Some(contract) = &info.contract_address {\n node_info!(\" Contract created: {contract}\");\n }\n node_info!(\" Gas used: {}\", receipt.cumulative_gas_used());\n if !info.exit.is_ok() {\n let r = RevertDecoder::new().decode(\n info.out.as_ref().map(|b| &b[..]).unwrap_or_default(),\n Some(info.exit),\n );\n node_info!(\" Error: reverted with: {r}\");\n }\n node_info!(\"\");\n\n let mined_tx = MinedTransaction { info, receipt, block_hash, block_number };\n storage.transactions.insert(mined_tx.info.transaction_hash, mined_tx);\n }\n\n // remove old transactions that exceed the transaction block keeper\n if let Some(transaction_block_keeper) = self.transaction_block_keeper\n && storage.blocks.len() > transaction_block_keeper\n {\n let to_clear = block_number\n .saturating_sub(transaction_block_keeper.try_into().unwrap_or(u64::MAX));\n storage.remove_block_transactions_by_number(to_clear)\n }\n\n // we intentionally set the difficulty to `0` for newer blocks\n env.evm_env.block_env.difficulty = U256::from(0);\n\n // update env with new values\n *self.env.write() = env;\n\n let timestamp = utc_from_secs(header.timestamp);\n\n node_info!(\" Block Number: {}\", block_number);\n node_info!(\" Block Hash: {:?}\", block_hash);\n if timestamp.year() > 9999 {\n // rf2822 panics with more than 4 digits\n node_info!(\" Block Time: {:?}\\n\", timestamp.to_rfc3339());\n } else {\n node_info!(\" Block Time: {:?}\\n\", timestamp.to_rfc2822());\n }\n\n let outcome = MinedBlockOutcome { block_number, included, invalid };\n\n (outcome, header, block_hash)\n };\n let next_block_base_fee = self.fees.get_next_block_base_fee_per_gas(\n header.gas_used,\n header.gas_limit,\n header.base_fee_per_gas.unwrap_or_default(),\n );\n let next_block_excess_blob_gas = self.fees.get_next_block_blob_excess_gas(\n header.excess_blob_gas.unwrap_or_default(),\n header.blob_gas_used.unwrap_or_default(),\n );\n\n // update next base fee\n self.fees.set_base_fee(next_block_base_fee);\n\n self.fees.set_blob_excess_gas_and_price(BlobExcessGasAndPrice::new(\n next_block_excess_blob_gas,\n get_blob_base_fee_update_fraction_by_spec_id(*self.env.read().evm_env.spec_id()),\n ));\n\n // notify all listeners\n self.notify_on_new_block(header, block_hash);\n\n outcome\n }\n\n /// Reorg the chain to a common height and execute blocks to build new chain.\n ///\n /// The state of the chain is rewound using `rewind` to the common block, including the db,\n /// storage, and env.\n ///\n /// Finally, `do_mine_block` is called to create the new chain.\n pub async fn reorg(\n &self,\n depth: u64,\n tx_pairs: HashMap>>>,\n common_block: Block,\n ) -> Result<(), BlockchainError> {\n self.rollback(common_block).await?;\n // Create the new reorged chain, filling the blocks with transactions if supplied\n for i in 0..depth {\n let to_be_mined = tx_pairs.get(&i).cloned().unwrap_or_else(Vec::new);\n let outcome = self.do_mine_block(to_be_mined).await;\n node_info!(\n \" Mined reorg block number {}. With {} valid txs and with invalid {} txs\",\n outcome.block_number,\n outcome.included.len(),\n outcome.invalid.len()\n );\n }\n\n Ok(())\n }\n\n /// Creates the pending block\n ///\n /// This will execute all transaction in the order they come but will not mine the block\n pub async fn pending_block(\n &self,\n pool_transactions: Vec>>,\n ) -> BlockInfo {\n self.with_pending_block(pool_transactions, |_, block| block).await\n }\n\n /// Creates the pending block\n ///\n /// This will execute all transaction in the order they come but will not mine the block\n pub async fn with_pending_block(\n &self,\n pool_transactions: Vec>>,\n f: F,\n ) -> T\n where\n F: FnOnce(Box, BlockInfo) -> T,\n {\n let db = self.db.read().await;\n let env = self.next_env();\n\n let mut cache_db = AnvilCacheDB::new(&*db);\n\n let parent_hash = self.blockchain.storage.read().best_hash;\n\n let spec_id = *env.evm_env.spec_id();\n let is_shanghai = spec_id >= SpecId::SHANGHAI;\n let is_cancun = spec_id >= SpecId::CANCUN;\n let is_prague = spec_id >= SpecId::PRAGUE;\n let gas_limit = env.evm_env.block_env.gas_limit;\n let difficulty = env.evm_env.block_env.difficulty;\n let mix_hash = env.evm_env.block_env.prevrandao;\n let beneficiary = env.evm_env.block_env.beneficiary;\n let timestamp = env.evm_env.block_env.timestamp;\n let base_fee =\n if spec_id >= SpecId::LONDON { Some(env.evm_env.block_env.basefee) } else { None };\n let excess_blob_gas =\n if is_cancun { env.evm_env.block_env.blob_excess_gas() } else { None };\n\n let mut inspector = AnvilInspector::default().with_tracing();\n if self.enable_steps_tracing {\n inspector = inspector.with_steps_tracing();\n }\n if self.print_logs {\n inspector = inspector.with_log_collector();\n }\n if self.print_traces {\n inspector = inspector.with_trace_printer();\n }\n\n let env_struct = Env::new(env.evm_env.clone(), Default::default(), env.networks);\n let mut evm = new_eth_evm_with_inspector(&mut cache_db, &env_struct, inspector);\n\n env.networks.inject_precompiles(evm.precompiles_mut());\n if let Some(factory) = &self.precompile_factory {\n evm.precompiles_mut().extend_precompiles(factory.precompiles());\n }\n let cheats = self.cheats().clone();\n if cheats.has_recover_overrides() {\n let cheats_arc = Arc::new(cheats.clone());\n let cheat_ecrecover = CheatEcrecover::new(Arc::clone(&cheats_arc));\n evm.precompiles_mut().apply_precompile(&EC_RECOVER, move |_| {\n Some(DynPrecompile::new_stateful(\n cheat_ecrecover.precompile_id().clone(),\n move |input| cheat_ecrecover.call(input),\n ))\n });\n }\n\n let exec_ctx = AnvilExecutionCtx { parent_hash, is_prague, is_cancun };\n let mut executor = AnvilBlockExecutorFactory::create_executor(evm, exec_ctx);\n executor.apply_pre_execution_changes().expect(\"pre-execution changes failed\");\n\n let mut transaction_infos: Vec = Vec::new();\n let mut transactions = Vec::new();\n let mut bloom = Bloom::default();\n\n let blob_params = self.blob_params();\n let networks = env.networks;\n let mut cumulative_blob_gas_used = if is_cancun { Some(0u64) } else { None };\n\n for pool_tx in pool_transactions {\n let pending = &pool_tx.pending_transaction;\n let sender = *pending.sender();\n\n let account = match executor\n .evm_mut()\n .db_mut()\n .basic(sender)\n .map(|a| a.unwrap_or_default())\n {\n Ok(acc) => acc,\n Err(err) => {\n trace!(target: \"backend\", ?err, \"db error for tx {:?}, skipping\", pool_tx.hash());\n continue;\n }\n };\n\n let tx_env = build_tx_env_for_pending(pending, &cheats, networks, &env.evm_env);\n let full_env = Env::new(env.evm_env.clone(), tx_env.clone(), networks);\n\n let cumulative_gas =\n executor.receipts().last().map(|r| r.cumulative_gas_used()).unwrap_or(0);\n let max_block_gas = cumulative_gas.saturating_add(pending.transaction.gas_limit());\n if !env.evm_env.cfg_env.disable_block_gas_limit && max_block_gas > gas_limit {\n trace!(target: \"backend\", tx_gas_limit = %pending.transaction.gas_limit(), ?pool_tx, \"block gas limit exhausting, skipping transaction\");\n continue;\n }\n\n if env.evm_env.cfg_env.tx_gas_limit_cap.is_none()\n && pending.transaction.gas_limit() > env.evm_env.cfg_env.tx_gas_limit_cap()\n {\n trace!(target: \"backend\", tx_gas_limit = %pending.transaction.gas_limit(), ?pool_tx, \"transaction gas limit exhausting, skipping transaction\");\n continue;\n }\n\n let tx_blob_gas = pending.transaction.blob_gas_used().unwrap_or(0);\n let current_blob_gas = cumulative_blob_gas_used.unwrap_or(0);\n if current_blob_gas.saturating_add(tx_blob_gas) > blob_params.max_blob_gas_per_block() {\n trace!(target: \"backend\", blob_gas = %tx_blob_gas, ?pool_tx, \"block blob gas limit exhausting, skipping transaction\");\n continue;\n }\n\n if let Err(err) = self.validate_pool_transaction_for(pending, &account, &full_env) {\n warn!(target: \"backend\", \"Skipping invalid tx execution [{:?}] {}\", pool_tx.hash(), err);\n continue;\n }\n\n let nonce = account.nonce;\n\n let recovered = Recovered::new_unchecked(pending.transaction.as_ref().clone(), sender);\n trace!(target: \"backend\", \"[{:?}] executing\", pool_tx.hash());\n match executor.execute_transaction_without_commit((tx_env, recovered)) {\n Ok(result) => {\n let exec_result = result.inner.result.result.clone();\n let gas_used = result.inner.result.result.gas_used();\n\n executor.commit_transaction(result).expect(\"commit failed\");\n\n let insp = executor.evm_mut().inspector_mut();\n\n if self.print_traces {\n insp.print_traces(self.call_trace_decoder.clone());\n }\n insp.print_logs();\n\n let traces = insp\n .tracer\n .take()\n .map(|t| t.into_traces().into_nodes())\n .unwrap_or_default();\n\n if self.enable_steps_tracing {\n insp.tracer = Some(TracingInspector::new(\n TracingInspectorConfig::all().with_state_diffs(),\n ));\n } else {\n insp.tracer = Some(TracingInspector::new(\n TracingInspectorConfig::all().set_steps(false),\n ));\n }\n if self.print_logs {\n insp.log_collector = Some(foundry_evm::inspectors::LogCollector::Capture {\n logs: Vec::new(),\n });\n }\n\n if is_cancun {\n cumulative_blob_gas_used =\n Some(cumulative_blob_gas_used.unwrap_or(0).saturating_add(tx_blob_gas));\n }\n\n let (exit_reason, out, logs) = match exec_result {\n ExecutionResult::Success { reason, gas_used: _, logs, output, .. } => {\n (reason.into(), Some(output), logs)\n }\n ExecutionResult::Revert { gas_used: _, output } => {\n (InstructionResult::Revert, Some(Output::Call(output)), Vec::new())\n }\n ExecutionResult::Halt { reason, gas_used: _ } => {\n (op_haltreason_to_instruction_result(reason), None, Vec::new())\n }\n };\n\n for log in &logs {\n bloom.accrue(BloomInput::Raw(&log.address[..]));\n for topic in log.topics() {\n bloom.accrue(BloomInput::Raw(&topic[..]));\n }\n }\n\n let contract_address = if pending.transaction.to().is_none() {\n let addr = sender.create(nonce);\n Some(addr)\n } else {\n None\n };\n\n let transaction_index = transaction_infos.len() as u64;\n let info = TransactionInfo {\n transaction_hash: pool_tx.hash(),\n transaction_index,\n from: sender,\n to: pending.transaction.to(),\n contract_address,\n traces,\n exit: exit_reason,\n out: out.map(Output::into_data),\n nonce,\n gas_used,\n };\n\n transaction_infos.push(info);\n transactions.push(pending.transaction.clone());\n }\n Err(err) => {\n trace!(target: \"backend\", ?err, \"tx execution error, skipping {:?}\", pool_tx.hash());\n }\n }\n }\n\n let (evm, block_result) = executor.finish().expect(\"executor finish failed\");\n drop(evm);\n\n // Extract inner CacheDB (which implements MaybeFullDatabase)\n let cache_db = cache_db.0;\n\n let state_root = cache_db.maybe_state_root().unwrap_or_default();\n let receipts_root = calculate_receipt_root(&block_result.receipts);\n let cumulative_gas_used = block_result.gas_used;\n\n let header = Header {\n parent_hash,\n ommers_hash: Default::default(),\n beneficiary,\n state_root,\n transactions_root: Default::default(),\n receipts_root,\n logs_bloom: bloom,\n difficulty,\n number: env.evm_env.block_env.number.saturating_to(),\n gas_limit,\n gas_used: cumulative_gas_used,\n timestamp: timestamp.saturating_to(),\n extra_data: Default::default(),\n mix_hash: mix_hash.unwrap_or_default(),\n nonce: Default::default(),\n base_fee_per_gas: base_fee,\n parent_beacon_block_root: is_cancun.then_some(Default::default()),\n blob_gas_used: cumulative_blob_gas_used,\n excess_blob_gas,\n withdrawals_root: is_shanghai.then_some(EMPTY_WITHDRAWALS),\n requests_hash: is_prague.then_some(EMPTY_REQUESTS_HASH),\n };\n\n let block = create_block(header, transactions);\n let block_info = TypedBlockInfo {\n block,\n transactions: transaction_infos,\n receipts: block_result.receipts,\n };\n\n f(Box::new(cache_db), block_info)\n }\n\n /// Executes the [TransactionRequest] without writing to the DB\n ///\n /// # Errors\n ///\n /// Returns an error if the `block_number` is greater than the current height\n pub async fn call(\n &self,\n request: WithOtherFields,\n fee_details: FeeDetails,\n block_request: Option>,\n overrides: EvmOverrides,\n ) -> Result<(InstructionResult, Option, u128, State), BlockchainError> {\n self.with_database_at(block_request, |state, mut block| {\n let block_number = block.number;\n let (exit, out, gas, state) = {\n let mut cache_db = CacheDB::new(state);\n if let Some(state_overrides) = overrides.state {\n apply_state_overrides(state_overrides.into_iter().collect(), &mut cache_db)?;\n }\n if let Some(block_overrides) = overrides.block {\n cache_db.apply_block_overrides(*block_overrides, &mut block);\n }\n self.call_with_state(&cache_db, request, fee_details, block)\n }?;\n trace!(target: \"backend\", \"call return {:?} out: {:?} gas {} on block {}\", exit, out, gas, block_number);\n Ok((exit, out, gas, state))\n }).await?\n }\n\n pub async fn call_with_tracing(\n &self,\n request: WithOtherFields,\n fee_details: FeeDetails,\n block_request: Option>,\n opts: GethDebugTracingCallOptions,\n ) -> Result {\n let GethDebugTracingCallOptions {\n tracing_options, block_overrides, state_overrides, ..\n } = opts;\n let GethDebugTracingOptions { config, tracer, tracer_config, .. } = tracing_options;\n\n self.with_database_at(block_request, |state, mut block| {\n let block_number = block.number;\n\n let mut cache_db = CacheDB::new(state);\n if let Some(state_overrides) = state_overrides {\n apply_state_overrides(state_overrides, &mut cache_db)?;\n }\n if let Some(block_overrides) = block_overrides {\n cache_db.apply_block_overrides(block_overrides, &mut block);\n }\n\n if let Some(tracer) = tracer {\n return match tracer {\n GethDebugTracerType::BuiltInTracer(tracer) => match tracer {\n GethDebugBuiltInTracerType::CallTracer => {\n let call_config = tracer_config\n .into_call_config()\n .map_err(|e| RpcError::invalid_params(e.to_string()))?;\n\n let mut inspector = self.build_inspector().with_tracing_config(\n TracingInspectorConfig::from_geth_call_config(&call_config),\n );\n\n let env = self.build_call_env(request, fee_details, block);\n let mut evm = self.new_eth_evm_with_inspector_ref(\n &cache_db,\n &env,\n &mut inspector,\n );\n let ResultAndState { result, state: _ } = evm.transact(env.tx)?;\n\n drop(evm);\n\n inspector.print_logs();\n if self.print_traces {\n inspector.print_traces(self.call_trace_decoder.clone());\n }\n\n let tracing_inspector = inspector.tracer.expect(\"tracer disappeared\");\n\n Ok(tracing_inspector\n .into_geth_builder()\n .geth_call_traces(call_config, result.gas_used())\n .into())\n }\n GethDebugBuiltInTracerType::PreStateTracer => {\n let pre_state_config = tracer_config\n .into_pre_state_config()\n .map_err(|e| RpcError::invalid_params(e.to_string()))?;\n\n let mut inspector = TracingInspector::new(\n TracingInspectorConfig::from_geth_prestate_config(\n &pre_state_config,\n ),\n );\n\n let env = self.build_call_env(request, fee_details, block);\n let mut evm = self.new_eth_evm_with_inspector_ref(\n &cache_db,\n &env,\n &mut inspector,\n );\n let result = evm.transact(env.tx)?;\n\n drop(evm);\n\n Ok(inspector\n .into_geth_builder()\n .geth_prestate_traces(&result, &pre_state_config, cache_db)?\n .into())\n }\n GethDebugBuiltInTracerType::NoopTracer => Ok(NoopFrame::default().into()),\n GethDebugBuiltInTracerType::FourByteTracer\n | GethDebugBuiltInTracerType::MuxTracer\n | GethDebugBuiltInTracerType::FlatCallTracer\n | GethDebugBuiltInTracerType::Erc7562Tracer => {\n Err(RpcError::invalid_params(\"unsupported tracer type\").into())\n }\n },\n #[cfg(not(feature = \"js-tracer\"))]\n GethDebugTracerType::JsTracer(_) => {\n Err(RpcError::invalid_params(\"unsupported tracer type\").into())\n }\n #[cfg(feature = \"js-tracer\")]\n GethDebugTracerType::JsTracer(code) => {\n use alloy_evm::IntoTxEnv;\n let config = tracer_config.into_json();\n let mut inspector =\n revm_inspectors::tracing::js::JsInspector::new(code, config)\n .map_err(|err| BlockchainError::Message(err.to_string()))?;\n\n let env = self.build_call_env(request, fee_details, block.clone());\n let mut evm =\n self.new_eth_evm_with_inspector_ref(&cache_db, &env, &mut inspector);\n let result = evm.transact(env.tx.clone())?;\n let res = evm\n .inspector_mut()\n .json_result(result, &env.tx.into_tx_env(), &block, &cache_db)\n .map_err(|err| BlockchainError::Message(err.to_string()))?;\n\n Ok(GethTrace::JS(res))\n }\n };\n }\n\n // defaults to StructLog tracer used since no tracer is specified\n let mut inspector = self\n .build_inspector()\n .with_tracing_config(TracingInspectorConfig::from_geth_config(&config));\n\n let env = self.build_call_env(request, fee_details, block);\n let mut evm = self.new_eth_evm_with_inspector_ref(&cache_db, &env, &mut inspector);\n let ResultAndState { result, state: _ } = evm.transact(env.tx)?;\n\n let (exit_reason, gas_used, out) = match result {\n ExecutionResult::Success { reason, gas_used, output, .. } => {\n (reason.into(), gas_used, Some(output))\n }\n ExecutionResult::Revert { gas_used, output } => {\n (InstructionResult::Revert, gas_used, Some(Output::Call(output)))\n }\n ExecutionResult::Halt { reason, gas_used } => {\n (op_haltreason_to_instruction_result(reason), gas_used, None)\n }\n };\n\n drop(evm);\n let tracing_inspector = inspector.tracer.expect(\"tracer disappeared\");\n let return_value = out.as_ref().map(|o| o.data()).cloned().unwrap_or_default();\n\n trace!(target: \"backend\", ?exit_reason, ?out, %gas_used, %block_number, \"trace call\");\n\n let res = tracing_inspector\n .into_geth_builder()\n .geth_traces(gas_used, return_value, config)\n .into();\n\n Ok(res)\n })\n .await?\n }\n\n /// Helper function to execute a closure with the database at a specific block\n pub async fn with_database_at(\n &self,\n block_request: Option>,\n f: F,\n ) -> Result\n where\n F: FnOnce(Box, BlockEnv) -> T,\n {\n let block_number = match block_request {\n Some(BlockRequest::Pending(pool_transactions)) => {\n let result = self\n .with_pending_block(pool_transactions, |state, block| {\n let block = block.block;\n f(state, block_env_from_header(&block.header))\n })\n .await;\n return Ok(result);\n }\n Some(BlockRequest::Number(bn)) => Some(BlockNumber::Number(bn)),\n None => None,\n };\n let block_number = self.convert_block_number(block_number);\n let current_number = self.best_number();\n\n // Reject requests for future blocks that don't exist yet\n if block_number > current_number {\n return Err(BlockchainError::BlockOutOfRange(current_number, block_number));\n }\n\n if block_number < current_number {\n if let Some((block_hash, block)) = self\n .block_by_number(BlockNumber::Number(block_number))\n .await?\n .map(|block| (block.header.hash, block))\n {\n let read_guard = self.states.upgradable_read();\n if let Some(state_db) = read_guard.get_state(&block_hash) {\n return Ok(f(Box::new(state_db), block_env_from_header(&block.header)));\n } else {\n let mut write_guard = RwLockUpgradableReadGuard::upgrade(read_guard);\n if let Some(state) = write_guard.get_on_disk_state(&block_hash) {\n return Ok(f(Box::new(state), block_env_from_header(&block.header)));\n }\n }\n }\n\n warn!(target: \"backend\", \"Not historic state found for block={}\", block_number);\n return Err(BlockchainError::BlockOutOfRange(current_number, block_number));\n }\n\n let db = self.db.read().await;\n let block = self.env.read().evm_env.block_env.clone();\n Ok(f(Box::new(&**db), block))\n }\n\n pub async fn storage_at(\n &self,\n address: Address,\n index: U256,\n block_request: Option>,\n ) -> Result {\n self.with_database_at(block_request, |db, _| {\n trace!(target: \"backend\", \"get storage for {:?} at {:?}\", address, index);\n let val = db.storage_ref(address, index)?;\n Ok(val.into())\n })\n .await?\n }\n\n /// Returns the code of the address\n ///\n /// If the code is not present and fork mode is enabled then this will try to fetch it from the\n /// forked client\n pub async fn get_code(\n &self,\n address: Address,\n block_request: Option>,\n ) -> Result {\n self.with_database_at(block_request, |db, _| self.get_code_with_state(&db, address)).await?\n }\n\n /// Returns the balance of the address\n ///\n /// If the requested number predates the fork then this will fetch it from the endpoint\n pub async fn get_balance(\n &self,\n address: Address,\n block_request: Option>,\n ) -> Result {\n self.with_database_at(block_request, |db, _| self.get_balance_with_state(db, address))\n .await?\n }\n\n pub async fn get_account_at_block(\n &self,\n address: Address,\n block_request: Option>,\n ) -> Result {\n self.with_database_at(block_request, |block_db, _| {\n let db = block_db.maybe_as_full_db().ok_or(BlockchainError::DataUnavailable)?;\n let account = db.get(&address).cloned().unwrap_or_default();\n let storage_root = storage_root(&account.storage);\n let code_hash = account.info.code_hash;\n let balance = account.info.balance;\n let nonce = account.info.nonce;\n Ok(TrieAccount { balance, nonce, code_hash, storage_root })\n })\n .await?\n }\n\n /// Returns the nonce of the address\n ///\n /// If the requested number predates the fork then this will fetch it from the endpoint\n pub async fn get_nonce(\n &self,\n address: Address,\n block_request: BlockRequest,\n ) -> Result {\n if let BlockRequest::Pending(pool_transactions) = &block_request\n && let Some(value) = get_pool_transactions_nonce(pool_transactions, address)\n {\n return Ok(value);\n }\n let final_block_request = match block_request {\n BlockRequest::Pending(_) => BlockRequest::Number(self.best_number()),\n BlockRequest::Number(bn) => BlockRequest::Number(bn),\n };\n\n self.with_database_at(Some(final_block_request), |db, _| {\n trace!(target: \"backend\", \"get nonce for {:?}\", address);\n Ok(db.basic_ref(address)?.unwrap_or_default().nonce)\n })\n .await?\n }\n\n fn replay_tx_with_inspector(\n &self,\n hash: B256,\n mut inspector: I,\n f: F,\n ) -> Result\n where\n for<'a> I: Inspector>>>>\n + Inspector>>>>\n + 'a,\n for<'a> F:\n FnOnce(ResultAndState, CacheDB>, I, TxEnv, Env) -> T,\n {\n let block = {\n let storage = self.blockchain.storage.read();\n let MinedTransaction { block_hash, .. } = storage\n .transactions\n .get(&hash)\n .cloned()\n .ok_or(BlockchainError::TransactionNotFound)?;\n\n storage.blocks.get(&block_hash).cloned().ok_or(BlockchainError::BlockNotFound)?\n };\n\n let index = block\n .body\n .transactions\n .iter()\n .position(|tx| tx.hash() == hash)\n .expect(\"transaction not found in block\");\n\n let pool_txs: Vec>> = block.body.transactions\n [..index]\n .iter()\n .map(|tx| {\n let pending_tx =\n PendingTransaction::from_maybe_impersonated(tx.clone()).expect(\"is valid\");\n Arc::new(PoolTransaction {\n pending_transaction: pending_tx,\n requires: vec![],\n provides: vec![],\n priority: crate::eth::pool::transactions::TransactionPriority(0),\n })\n })\n .collect();\n\n let trace = |parent_state: &StateDb| -> Result {\n let mut cache_db = AnvilCacheDB::new(Box::new(parent_state));\n\n // configure the blockenv for the block of the transaction\n let mut env = self.env.read().clone();\n\n env.evm_env.block_env = block_env_from_header(&block.header);\n\n let spec_id = *env.evm_env.spec_id();\n let is_cancun = spec_id >= SpecId::CANCUN;\n let is_prague = spec_id >= SpecId::PRAGUE;\n let gas_limit = env.evm_env.block_env.gas_limit;\n\n let mut inspector_replay = AnvilInspector::default().with_tracing();\n if self.enable_steps_tracing {\n inspector_replay = inspector_replay.with_steps_tracing();\n }\n if self.print_logs {\n inspector_replay = inspector_replay.with_log_collector();\n }\n if self.print_traces {\n inspector_replay = inspector_replay.with_trace_printer();\n }\n\n let env_struct = Env::new(env.evm_env.clone(), Default::default(), env.networks);\n let mut evm_replay =\n new_eth_evm_with_inspector(&mut cache_db, &env_struct, inspector_replay);\n\n env.networks.inject_precompiles(evm_replay.precompiles_mut());\n if let Some(factory) = &self.precompile_factory {\n evm_replay.precompiles_mut().extend_precompiles(factory.precompiles());\n }\n let cheats = self.cheats().clone();\n if cheats.has_recover_overrides() {\n let cheats_arc = Arc::new(cheats.clone());\n let cheat_ecrecover = CheatEcrecover::new(Arc::clone(&cheats_arc));\n evm_replay.precompiles_mut().apply_precompile(&EC_RECOVER, move |_| {\n Some(DynPrecompile::new_stateful(\n cheat_ecrecover.precompile_id().clone(),\n move |input| cheat_ecrecover.call(input),\n ))\n });\n }\n\n let exec_ctx =\n AnvilExecutionCtx { parent_hash: block.header.parent_hash, is_prague, is_cancun };\n let mut replay_executor =\n AnvilBlockExecutorFactory::create_executor(evm_replay, exec_ctx);\n replay_executor.apply_pre_execution_changes().expect(\"pre-execution changes failed\");\n\n let blob_params = self.blob_params();\n let networks = env.networks;\n let mut cumulative_blob_gas_used = if is_cancun { Some(0u64) } else { None };\n\n for pool_tx in pool_txs {\n let pending = &pool_tx.pending_transaction;\n let sender = *pending.sender();\n\n let account = match replay_executor\n .evm_mut()\n .db_mut()\n .basic(sender)\n .map(|a| a.unwrap_or_default())\n {\n Ok(acc) => acc,\n Err(_) => continue,\n };\n\n let tx_env = build_tx_env_for_pending(pending, &cheats, networks, &env.evm_env);\n let full_env = Env::new(env.evm_env.clone(), tx_env.clone(), networks);\n\n let cumulative_gas =\n replay_executor.receipts().last().map(|r| r.cumulative_gas_used()).unwrap_or(0);\n let max_block_gas = cumulative_gas.saturating_add(pending.transaction.gas_limit());\n if !env.evm_env.cfg_env.disable_block_gas_limit && max_block_gas > gas_limit {\n continue;\n }\n\n if env.evm_env.cfg_env.tx_gas_limit_cap.is_none()\n && pending.transaction.gas_limit() > env.evm_env.cfg_env.tx_gas_limit_cap()\n {\n continue;\n }\n\n let tx_blob_gas = pending.transaction.blob_gas_used().unwrap_or(0);\n let current_blob_gas = cumulative_blob_gas_used.unwrap_or(0);\n if current_blob_gas.saturating_add(tx_blob_gas)\n > blob_params.max_blob_gas_per_block()\n {\n continue;\n }\n\n if self.validate_pool_transaction_for(pending, &account, &full_env).is_err() {\n continue;\n }\n\n let recovered =\n Recovered::new_unchecked(pending.transaction.as_ref().clone(), sender);\n if let Ok(result) =\n replay_executor.execute_transaction_without_commit((tx_env, recovered))\n {\n replay_executor.commit_transaction(result).expect(\"commit failed\");\n\n let insp = replay_executor.evm_mut().inspector_mut();\n insp.print_logs();\n if self.print_traces {\n insp.print_traces(self.call_trace_decoder.clone());\n }\n insp.tracer.take();\n if self.enable_steps_tracing {\n insp.tracer = Some(TracingInspector::new(\n TracingInspectorConfig::all().with_state_diffs(),\n ));\n } else {\n insp.tracer = Some(TracingInspector::new(\n TracingInspectorConfig::all().set_steps(false),\n ));\n }\n if self.print_logs {\n insp.log_collector = Some(foundry_evm::inspectors::LogCollector::Capture {\n logs: Vec::new(),\n });\n }\n\n if is_cancun {\n cumulative_blob_gas_used =\n Some(cumulative_blob_gas_used.unwrap_or(0).saturating_add(tx_blob_gas));\n }\n }\n }\n\n let (evm_done, _) = replay_executor.finish().expect(\"executor finish failed\");\n drop(evm_done);\n\n // Extract inner CacheDB to match the expected types for the target tx execution\n let cache_db = cache_db.0;\n\n let target_tx = block.body.transactions[index].clone();\n let target_tx = PendingTransaction::from_maybe_impersonated(target_tx)?;\n let mut tx_env: OpTransaction = FromRecoveredTx::from_recovered_tx(\n target_tx.transaction.as_ref(),\n *target_tx.sender(),\n );\n if env.networks.is_optimism() {\n tx_env.enveloped_tx = Some(target_tx.transaction.encoded_2718().into());\n }\n\n let mut evm = self.new_eth_evm_with_inspector_ref(&cache_db, &env, &mut inspector);\n\n let result = evm\n .transact(tx_env.clone())\n .map_err(|err| BlockchainError::Message(err.to_string()))?;\n\n Ok(f(result, cache_db, inspector, tx_env.base, env))\n };\n\n let read_guard = self.states.upgradable_read();\n if let Some(state) = read_guard.get_state(&block.header.parent_hash) {\n trace(state)\n } else {\n let mut write_guard = RwLockUpgradableReadGuard::upgrade(read_guard);\n let state = write_guard\n .get_on_disk_state(&block.header.parent_hash)\n .ok_or(BlockchainError::BlockNotFound)?;\n trace(state)\n }\n }\n\n /// Traces the transaction with the js tracer\n #[cfg(feature = \"js-tracer\")]\n pub async fn trace_tx_with_js_tracer(\n &self,\n hash: B256,\n code: String,\n opts: GethDebugTracingOptions,\n ) -> Result {\n let GethDebugTracingOptions { tracer_config, .. } = opts;\n let config = tracer_config.into_json();\n let inspector = revm_inspectors::tracing::js::JsInspector::new(code, config)\n .map_err(|err| BlockchainError::Message(err.to_string()))?;\n let trace = self.replay_tx_with_inspector(\n hash,\n inspector,\n |result, cache_db, mut inspector, tx_env, env| {\n inspector\n .json_result(\n result,\n &alloy_evm::IntoTxEnv::into_tx_env(tx_env),\n &env.evm_env.block_env,\n &cache_db,\n )\n .map_err(|e| BlockchainError::Message(e.to_string()))\n },\n )??;\n Ok(GethTrace::JS(trace))\n }\n\n /// Prove an account's existence or nonexistence in the state trie.\n ///\n /// Returns a merkle proof of the account's trie node, `account_key` == keccak(address)\n pub async fn prove_account_at(\n &self,\n address: Address,\n keys: Vec,\n block_request: Option>,\n ) -> Result {\n let block_number = block_request.as_ref().map(|r| r.block_number());\n\n self.with_database_at(block_request, |block_db, _| {\n trace!(target: \"backend\", \"get proof for {:?} at {:?}\", address, block_number);\n let db = block_db.maybe_as_full_db().ok_or(BlockchainError::DataUnavailable)?;\n let account = db.get(&address).cloned().unwrap_or_default();\n\n let mut builder = HashBuilder::default()\n .with_proof_retainer(ProofRetainer::new(vec![Nibbles::unpack(keccak256(address))]));\n\n for (key, account) in trie_accounts(db) {\n builder.add_leaf(key, &account);\n }\n\n let _ = builder.root();\n\n let proof = builder\n .take_proof_nodes()\n .into_nodes_sorted()\n .into_iter()\n .map(|(_, v)| v)\n .collect();\n let (storage_hash, storage_proofs) = prove_storage(&account.storage, &keys);\n\n let account_proof = AccountProof {\n address,\n balance: account.info.balance,\n nonce: account.info.nonce,\n code_hash: account.info.code_hash,\n storage_hash,\n account_proof: proof,\n storage_proof: keys\n .into_iter()\n .zip(storage_proofs)\n .map(|(key, proof)| {\n let storage_key: U256 = key.into();\n let value = account.storage.get(&storage_key).copied().unwrap_or_default();\n StorageProof { key: JsonStorageKey::Hash(key), value, proof }\n })\n .collect(),\n };\n\n Ok(account_proof)\n })\n .await?\n }\n\n /// Rollback the chain to a common height.\n ///\n /// The state of the chain is rewound using `rewind` to the common block, including the db,\n /// storage, and env.\n pub async fn rollback(&self, common_block: Block) -> Result<(), BlockchainError> {\n let hash = common_block.header.hash_slow();\n\n // Get the database at the common block\n let common_state = {\n let return_state_or_throw_err =\n |db: Option<&StateDb>| -> Result, BlockchainError> {\n let state_db = db.ok_or(BlockchainError::DataUnavailable)?;\n let db_full =\n state_db.maybe_as_full_db().ok_or(BlockchainError::DataUnavailable)?;\n Ok(db_full.clone())\n };\n\n let read_guard = self.states.upgradable_read();\n if let Some(db) = read_guard.get_state(&hash) {\n return_state_or_throw_err(Some(db))?\n } else {\n let mut write_guard = RwLockUpgradableReadGuard::upgrade(read_guard);\n return_state_or_throw_err(write_guard.get_on_disk_state(&hash))?\n }\n };\n\n {\n // Unwind the storage back to the common ancestor first\n self.blockchain.storage.write().unwind_to(common_block.header.number(), hash);\n\n // Set environment back to common block\n let mut env = self.env.write();\n env.evm_env.block_env.number = U256::from(common_block.header.number());\n env.evm_env.block_env.timestamp = U256::from(common_block.header.timestamp());\n env.evm_env.block_env.gas_limit = common_block.header.gas_limit();\n env.evm_env.block_env.difficulty = common_block.header.difficulty();\n env.evm_env.block_env.prevrandao = common_block.header.mix_hash();\n\n self.time.reset(env.evm_env.block_env.timestamp.saturating_to());\n }\n\n {\n // Collect block hashes before acquiring db lock to avoid holding blockchain storage\n // lock across await. Only collect the last 256 blocks since that's all BLOCKHASH can\n // access.\n let block_hashes: Vec<_> = {\n let storage = self.blockchain.storage.read();\n let min_block = common_block.header.number().saturating_sub(256);\n storage\n .hashes\n .iter()\n .filter(|(num, _)| **num >= min_block)\n .map(|(&num, &hash)| (num, hash))\n .collect()\n };\n\n // Acquire db lock once for the entire restore operation to reduce lock churn.\n let mut db = self.db.write().await;\n db.clear();\n\n // Insert account info before storage to prevent fork-mode RPC fetches after clear.\n for (address, acc) in common_state {\n db.insert_account(address, acc.info);\n for (key, value) in acc.storage {\n db.set_storage_at(address, key.into(), value.into())?;\n }\n }\n\n // Restore block hashes from blockchain storage (now unwound, contains only valid\n // blocks).\n for (block_num, hash) in block_hashes {\n db.insert_block_hash(U256::from(block_num), hash);\n }\n }\n\n Ok(())\n }\n}\n\nimpl Backend {\n /// Get the current state.\n pub async fn serialized_state(\n &self,\n preserve_historical_states: bool,\n ) -> Result {\n let at = self.env.read().evm_env.block_env.clone();\n let best_number = self.blockchain.storage.read().best_number;\n let blocks = self.blockchain.storage.read().serialized_blocks();\n let transactions = self.blockchain.storage.read().serialized_transactions();\n let historical_states = if preserve_historical_states {\n Some(self.states.write().serialized_states())\n } else {\n None\n };\n\n let state = self.db.read().await.dump_state(\n at,\n best_number,\n blocks,\n transactions,\n historical_states,\n )?;\n state.ok_or_else(|| {\n RpcError::invalid_params(\"Dumping state not supported with the current configuration\")\n .into()\n })\n }\n\n /// Write all chain data to serialized bytes buffer\n pub async fn dump_state(\n &self,\n preserve_historical_states: bool,\n ) -> Result {\n let state = self.serialized_state(preserve_historical_states).await?;\n let mut encoder = GzEncoder::new(Vec::new(), Compression::default());\n encoder\n .write_all(&serde_json::to_vec(&state).unwrap_or_default())\n .map_err(|_| BlockchainError::DataUnavailable)?;\n Ok(encoder.finish().unwrap_or_default().into())\n }\n\n /// Apply [SerializableState] data to the backend storage.\n pub async fn load_state(&self, state: SerializableState) -> Result {\n // load the blocks and transactions into the storage\n self.blockchain.storage.write().load_blocks(state.blocks.clone());\n self.blockchain.storage.write().load_transactions(state.transactions.clone());\n // reset the block env\n if let Some(block) = state.block.clone() {\n self.env.write().evm_env.block_env = block.clone();\n\n // Set the current best block number.\n // Defaults to block number for compatibility with existing state files.\n let fork_num_and_hash = self.get_fork().map(|f| (f.block_number(), f.block_hash()));\n\n let best_number = state.best_block_number.unwrap_or(block.number.saturating_to());\n if let Some((number, hash)) = fork_num_and_hash {\n trace!(target: \"backend\", state_block_number=?best_number, fork_block_number=?number);\n // If the state.block_number is greater than the fork block number, set best number\n // to the state block number.\n // Ref: https://github.com/foundry-rs/foundry/issues/9539\n if best_number > number {\n self.blockchain.storage.write().best_number = best_number;\n let best_hash =\n self.blockchain.storage.read().hash(best_number.into()).ok_or_else(\n || {\n BlockchainError::RpcError(RpcError::internal_error_with(format!(\n \"Best hash not found for best number {best_number}\",\n )))\n },\n )?;\n self.blockchain.storage.write().best_hash = best_hash;\n } else {\n // If loading state file on a fork, set best number to the fork block number.\n // Ref: https://github.com/foundry-rs/foundry/pull/9215#issue-2618681838\n self.blockchain.storage.write().best_number = number;\n self.blockchain.storage.write().best_hash = hash;\n }\n } else {\n self.blockchain.storage.write().best_number = best_number;\n\n // Set the current best block hash;\n let best_hash =\n self.blockchain.storage.read().hash(best_number.into()).ok_or_else(|| {\n BlockchainError::RpcError(RpcError::internal_error_with(format!(\n \"Best hash not found for best number {best_number}\",\n )))\n })?;\n\n self.blockchain.storage.write().best_hash = best_hash;\n }\n }\n\n if let Some(latest) = state.blocks.iter().max_by_key(|b| b.header.number()) {\n let header = &latest.header;\n let next_block_base_fee = self.fees.get_next_block_base_fee_per_gas(\n header.gas_used(),\n header.gas_limit(),\n header.base_fee_per_gas().unwrap_or_default(),\n );\n let next_block_excess_blob_gas = self.fees.get_next_block_blob_excess_gas(\n header.excess_blob_gas().unwrap_or_default(),\n header.blob_gas_used().unwrap_or_default(),\n );\n\n // update next base fee\n self.fees.set_base_fee(next_block_base_fee);\n\n self.fees.set_blob_excess_gas_and_price(BlobExcessGasAndPrice::new(\n next_block_excess_blob_gas,\n get_blob_base_fee_update_fraction(\n self.env.read().evm_env.cfg_env.chain_id,\n header.timestamp,\n ),\n ));\n }\n\n if !self.db.write().await.load_state(state.clone())? {\n return Err(RpcError::invalid_params(\n \"Loading state not supported with the current configuration\",\n )\n .into());\n }\n\n if let Some(historical_states) = state.historical_states {\n self.states.write().load_states(historical_states);\n }\n\n Ok(true)\n }\n\n /// Deserialize and add all chain data to the backend storage\n pub async fn load_state_bytes(&self, buf: Bytes) -> Result {\n let orig_buf = &buf.0[..];\n let mut decoder = GzDecoder::new(orig_buf);\n let mut decoded_data = Vec::new();\n\n let state: SerializableState = serde_json::from_slice(if decoder.header().is_some() {\n decoder\n .read_to_end(decoded_data.as_mut())\n .map_err(|_| BlockchainError::FailedToDecodeStateDump)?;\n &decoded_data\n } else {\n &buf.0\n })\n .map_err(|_| BlockchainError::FailedToDecodeStateDump)?;\n\n self.load_state(state).await\n }\n\n /// Simulates the payload by executing the calls in request.\n pub async fn simulate(\n &self,\n request: SimulatePayload,\n block_request: Option>,\n ) -> Result>, BlockchainError> {\n self.with_database_at(block_request, |state, mut block_env| {\n let SimulatePayload {\n block_state_calls,\n trace_transfers,\n validation,\n return_full_transactions,\n } = request;\n let mut cache_db = CacheDB::new(state);\n let mut block_res = Vec::with_capacity(block_state_calls.len());\n\n // execute the blocks\n for block in block_state_calls {\n let SimBlock { block_overrides, state_overrides, calls } = block;\n let mut call_res = Vec::with_capacity(calls.len());\n let mut log_index = 0;\n let mut gas_used = 0;\n let mut transactions = Vec::with_capacity(calls.len());\n let mut logs= Vec::new();\n\n // apply state overrides before executing the transactions\n if let Some(state_overrides) = state_overrides {\n apply_state_overrides(state_overrides, &mut cache_db)?;\n }\n if let Some(block_overrides) = block_overrides {\n cache_db.apply_block_overrides(block_overrides, &mut block_env);\n }\n\n // execute all calls in that block\n for (req_idx, request) in calls.into_iter().enumerate() {\n let fee_details = FeeDetails::new(\n request.gas_price,\n request.max_fee_per_gas,\n request.max_priority_fee_per_gas,\n request.max_fee_per_blob_gas,\n )?\n .or_zero_fees();\n\n let mut env = self.build_call_env(\n WithOtherFields::new(request.clone()),\n fee_details,\n block_env.clone(),\n );\n\n // Always disable EIP-3607\n env.evm_env.cfg_env.disable_eip3607 = true;\n\n if !validation {\n env.evm_env.cfg_env.disable_base_fee = !validation;\n env.evm_env.block_env.basefee = 0;\n }\n\n let mut inspector = self.build_inspector();\n\n // transact\n let ResultAndState { result, state } = if trace_transfers {\n // prepare inspector to capture transfer inside the evm so they are\n // recorded and included in logs\n inspector = inspector.with_transfers();\n let mut evm= self.new_eth_evm_with_inspector_ref(\n &cache_db,\n &env,\n &mut inspector,\n );\n\n trace!(target: \"backend\", env=?env.evm_env, spec=?env.evm_env.spec_id(),\"simulate evm env\");\n evm.transact(env.tx)?\n } else {\n let mut evm = self.new_eth_evm_with_inspector_ref(\n &cache_db,\n &env,\n &mut inspector,\n );\n trace!(target: \"backend\", env=?env.evm_env, spec=?env.evm_env.spec_id(),\"simulate evm env\");\n evm.transact(env.tx)?\n };\n trace!(target: \"backend\", ?result, ?request, \"simulate call\");\n\n inspector.print_logs();\n if self.print_traces {\n inspector.into_print_traces(self.call_trace_decoder.clone());\n }\n\n // commit the transaction\n cache_db.commit(state);\n gas_used += result.gas_used();\n\n // create the transaction from a request\n let from = request.from.unwrap_or_default();\n\n let mut request = Into::::into(WithOtherFields::new(request));\n request.prep_for_submission();\n\n let typed_tx = request.build_unsigned().map_err(|e| BlockchainError::InvalidTransactionRequest(e.to_string()))?;\n\n let tx = build_impersonated(typed_tx);\n let tx_hash = tx.hash();\n let rpc_tx = transaction_build(\n None,\n MaybeImpersonatedTransaction::impersonated(tx, from),\n None,\n None,\n Some(block_env.basefee),\n );\n transactions.push(rpc_tx);\n\n let return_data = result.output().cloned().unwrap_or_default();\n let sim_res = SimCallResult {\n return_data,\n gas_used: result.gas_used(),\n status: result.is_success(),\n error: result.is_success().not().then(|| {\n alloy_rpc_types::simulate::SimulateError {\n code: -3200,\n message: \"execution failed\".to_string(),\n data: None,\n }\n }),\n logs: result.clone()\n .into_logs()\n .into_iter()\n .enumerate()\n .map(|(idx, log)| Log {\n inner: log,\n block_number: Some(block_env.number.saturating_to()),\n block_timestamp: Some(block_env.timestamp.saturating_to()),\n transaction_index: Some(req_idx as u64),\n log_index: Some((idx + log_index) as u64),\n removed: false,\n\n block_hash: None,\n transaction_hash: Some(tx_hash),\n })\n .collect(),\n };\n logs.extend(sim_res.logs.iter().map(|log| log.inner.clone()));\n log_index += sim_res.logs.len();\n call_res.push(sim_res);\n }\n\n let transactions_envelopes: Vec = transactions\n .iter()\n .map(|tx| AnyTxEnvelope::from(tx.clone()))\n .collect();\n let header = Header {\n logs_bloom: logs_bloom(logs.iter()),\n transactions_root: calculate_transaction_root(&transactions_envelopes),\n receipts_root: calculate_receipt_root(&transactions_envelopes),\n parent_hash: Default::default(),\n beneficiary: block_env.beneficiary,\n state_root: Default::default(),\n difficulty: Default::default(),\n number: block_env.number.saturating_to(),\n gas_limit: block_env.gas_limit,\n gas_used,\n timestamp: block_env.timestamp.saturating_to(),\n extra_data: Default::default(),\n mix_hash: Default::default(),\n nonce: Default::default(),\n base_fee_per_gas: Some(block_env.basefee),\n withdrawals_root: None,\n blob_gas_used: None,\n excess_blob_gas: None,\n parent_beacon_block_root: None,\n requests_hash: None,\n ..Default::default()\n };\n let mut block = alloy_rpc_types::Block {\n header: AnyRpcHeader {\n hash: header.hash_slow(),\n inner: header.into(),\n total_difficulty: None,\n size: None,\n },\n uncles: vec![],\n transactions: BlockTransactions::Full(transactions),\n withdrawals: None,\n };\n\n if !return_full_transactions {\n block.transactions.convert_to_hashes();\n }\n\n for res in &mut call_res {\n res.logs.iter_mut().for_each(|log| {\n log.block_hash = Some(block.header.hash);\n });\n }\n\n let simulated_block = SimulatedBlock {\n inner: AnyRpcBlock::new(WithOtherFields::new(block)),\n calls: call_res,\n };\n\n // update block env\n block_env.number += U256::from(1);\n block_env.timestamp += U256::from(12);\n block_env.basefee = simulated_block\n .inner\n .header\n .next_block_base_fee(self.fees.base_fee_params())\n .unwrap_or_default();\n\n block_res.push(simulated_block);\n }\n\n Ok(block_res)\n })\n .await?\n }\n\n /// returns all receipts for the given transactions\n fn get_receipts(\n &self,\n tx_hashes: impl IntoIterator,\n ) -> Vec {\n let storage = self.blockchain.storage.read();\n let mut receipts = vec![];\n\n for hash in tx_hashes {\n if let Some(tx) = storage.transactions.get(&hash) {\n receipts.push(tx.receipt.clone());\n }\n }\n\n receipts\n }\n\n /// Returns the traces for the given transaction\n pub async fn debug_trace_transaction(\n &self,\n hash: B256,\n opts: GethDebugTracingOptions,\n ) -> Result {\n #[cfg(feature = \"js-tracer\")]\n if let Some(tracer_type) = opts.tracer.as_ref()\n && tracer_type.is_js()\n {\n return self\n .trace_tx_with_js_tracer(hash, tracer_type.as_str().to_string(), opts.clone())\n .await;\n }\n\n if let Some(trace) = self.mined_geth_trace_transaction(hash, opts.clone()).await {\n return trace;\n }\n\n if let Some(fork) = self.get_fork() {\n return Ok(fork.debug_trace_transaction(hash, opts).await?);\n }\n\n Ok(GethTrace::Default(Default::default()))\n }\n\n fn geth_trace(\n &self,\n tx: &MinedTransaction,\n opts: GethDebugTracingOptions,\n ) -> Result {\n let GethDebugTracingOptions { config, tracer, tracer_config, .. } = opts;\n\n if let Some(tracer) = tracer {\n match tracer {\n GethDebugTracerType::BuiltInTracer(tracer) => match tracer {\n GethDebugBuiltInTracerType::FourByteTracer => {\n let inspector = FourByteInspector::default();\n let res = self.replay_tx_with_inspector(\n tx.info.transaction_hash,\n inspector,\n |_, _, inspector, _, _| FourByteFrame::from(inspector).into(),\n )?;\n return Ok(res);\n }\n GethDebugBuiltInTracerType::CallTracer => {\n return match tracer_config.into_call_config() {\n Ok(call_config) => {\n let inspector = TracingInspector::new(\n TracingInspectorConfig::from_geth_call_config(&call_config),\n );\n let frame = self.replay_tx_with_inspector(\n tx.info.transaction_hash,\n inspector,\n |_, _, inspector, _, _| {\n inspector\n .geth_builder()\n .geth_call_traces(\n call_config,\n tx.receipt.cumulative_gas_used(),\n )\n .into()\n },\n )?;\n Ok(frame)\n }\n Err(e) => Err(RpcError::invalid_params(e.to_string()).into()),\n };\n }\n GethDebugBuiltInTracerType::PreStateTracer => {\n return match tracer_config.into_pre_state_config() {\n Ok(pre_state_config) => {\n let inspector = TracingInspector::new(\n TracingInspectorConfig::from_geth_prestate_config(\n &pre_state_config,\n ),\n );\n let frame = self.replay_tx_with_inspector(\n tx.info.transaction_hash,\n inspector,\n |state, db, inspector, _, _| {\n inspector.geth_builder().geth_prestate_traces(\n &state,\n &pre_state_config,\n db,\n )\n },\n )??;\n Ok(frame.into())\n }\n Err(e) => Err(RpcError::invalid_params(e.to_string()).into()),\n };\n }\n GethDebugBuiltInTracerType::NoopTracer\n | GethDebugBuiltInTracerType::MuxTracer\n | GethDebugBuiltInTracerType::Erc7562Tracer\n | GethDebugBuiltInTracerType::FlatCallTracer => {}\n },\n GethDebugTracerType::JsTracer(_code) => {}\n }\n\n return Ok(NoopFrame::default().into());\n }\n\n // default structlog tracer\n Ok(GethTraceBuilder::new(tx.info.traces.clone())\n .geth_traces(\n tx.receipt.cumulative_gas_used(),\n tx.info.out.clone().unwrap_or_default(),\n config,\n )\n .into())\n }\n\n async fn mined_geth_trace_transaction(\n &self,\n hash: B256,\n opts: GethDebugTracingOptions,\n ) -> Option> {\n self.blockchain.storage.read().transactions.get(&hash).map(|tx| self.geth_trace(tx, opts))\n }\n\n pub async fn transaction_receipt(\n &self,\n hash: B256,\n ) -> Result, BlockchainError> {\n if let Some(receipt) = self.mined_transaction_receipt(hash) {\n return Ok(Some(receipt.inner));\n }\n\n if let Some(fork) = self.get_fork() {\n let receipt = fork.transaction_receipt(hash).await?;\n let number = self.convert_block_number(\n receipt.clone().and_then(|r| r.block_number()).map(BlockNumber::from),\n );\n\n if fork.predates_fork_inclusive(number) {\n return Ok(receipt);\n }\n }\n\n Ok(None)\n }\n\n /// Returns all transaction receipts of the block\n pub fn mined_block_receipts(&self, id: impl Into) -> Option> {\n let mut receipts = Vec::new();\n let block = self.get_block(id)?;\n\n for transaction in block.body.transactions {\n let receipt = self.mined_transaction_receipt(transaction.hash())?;\n receipts.push(receipt.inner);\n }\n\n Some(receipts)\n }\n\n /// Returns the transaction receipt for the given hash\n pub(crate) fn mined_transaction_receipt(\n &self,\n hash: B256,\n ) -> Option> {\n let MinedTransaction { info, receipt: tx_receipt, block_hash, .. } =\n self.blockchain.get_transaction_by_hash(&hash)?;\n\n let index = info.transaction_index as usize;\n let block = self.blockchain.get_block_by_hash(&block_hash)?;\n let transaction = block.body.transactions[index].clone();\n\n // Cancun specific\n let excess_blob_gas = block.header.excess_blob_gas();\n let blob_gas_price =\n alloy_eips::eip4844::calc_blob_gasprice(excess_blob_gas.unwrap_or_default());\n let blob_gas_used = transaction.blob_gas_used();\n\n let effective_gas_price = transaction.effective_gas_price(block.header.base_fee_per_gas());\n\n let receipts = self.get_receipts(block.body.transactions.iter().map(|tx| tx.hash()));\n let next_log_index = receipts[..index].iter().map(|r| r.logs().len()).sum::();\n\n let tx_receipt = tx_receipt.convert_logs_rpc(\n BlockNumHash::new(block.header.number(), block_hash),\n block.header.timestamp(),\n info.transaction_hash,\n info.transaction_index,\n next_log_index,\n );\n\n let receipt = TransactionReceipt {\n inner: tx_receipt,\n transaction_hash: info.transaction_hash,\n transaction_index: Some(info.transaction_index),\n block_number: Some(block.header.number()),\n gas_used: info.gas_used,\n contract_address: info.contract_address,\n effective_gas_price,\n block_hash: Some(block_hash),\n from: info.from,\n to: info.to,\n blob_gas_price: Some(blob_gas_price),\n blob_gas_used,\n };\n\n // Include timestamp in receipt to avoid extra block lookups (e.g., in Otterscan API)\n let inner = FoundryTxReceipt::with_timestamp(receipt, block.header.timestamp());\n Some(MinedTransactionReceipt { inner, out: info.out })\n }\n\n /// Returns the blocks receipts for the given number\n pub async fn block_receipts(\n &self,\n number: BlockId,\n ) -> Result>, BlockchainError> {\n if let Some(receipts) = self.mined_block_receipts(number) {\n return Ok(Some(receipts));\n }\n\n if let Some(fork) = self.get_fork() {\n let number = match self.ensure_block_number(Some(number)).await {\n Err(_) => return Ok(None),\n Ok(n) => n,\n };\n\n if fork.predates_fork_inclusive(number) {\n let receipts = fork.block_receipts(number).await?;\n\n return Ok(receipts);\n }\n }\n\n Ok(None)\n }\n\n pub fn get_blob_by_tx_hash(&self, hash: B256) -> Result>> {\n // Try to get the mined transaction by hash\n if let Some(tx) = self.mined_transaction_by_hash(hash)\n && let Ok(typed_tx) = FoundryTxEnvelope::try_from(tx)\n && let Some(sidecar) = typed_tx.sidecar()\n {\n return Ok(Some(sidecar.sidecar.blobs().to_vec()));\n }\n\n Ok(None)\n }\n}\n\n/// Get max nonce from transaction pool by address.\nfn get_pool_transactions_nonce(\n pool_transactions: &[Arc>],\n address: Address,\n) -> Option {\n if let Some(highest_nonce) = pool_transactions\n .iter()\n .filter(|tx| *tx.pending_transaction.sender() == address)\n .map(|tx| tx.pending_transaction.nonce())\n .max()\n {\n let tx_count = highest_nonce.saturating_add(1);\n return Some(tx_count);\n }\n None\n}\n\n#[async_trait::async_trait]\nimpl TransactionValidator for Backend {\n async fn validate_pool_transaction(\n &self,\n tx: &PendingTransaction,\n ) -> Result<(), BlockchainError> {\n let address = *tx.sender();\n let account = self.get_account(address).await?;\n let env = self.next_env();\n Ok(self.validate_pool_transaction_for(tx, &account, &env)?)\n }\n\n fn validate_pool_transaction_for(\n &self,\n pending: &PendingTransaction,\n account: &AccountInfo,\n env: &Env,\n ) -> Result<(), InvalidTransactionError> {\n let tx = &pending.transaction;\n\n if let Some(tx_chain_id) = tx.chain_id() {\n let chain_id = self.chain_id();\n if chain_id.to::() != tx_chain_id {\n if let FoundryTxEnvelope::Legacy(tx) = tx.as_ref() {\n // \n if env.evm_env.cfg_env.spec >= SpecId::SPURIOUS_DRAGON\n && tx.chain_id().is_none()\n {\n warn!(target: \"backend\", ?chain_id, ?tx_chain_id, \"incompatible EIP155-based V\");\n return Err(InvalidTransactionError::IncompatibleEIP155);\n }\n } else {\n warn!(target: \"backend\", ?chain_id, ?tx_chain_id, \"invalid chain id\");\n return Err(InvalidTransactionError::InvalidChainId);\n }\n }\n }\n\n // Nonce validation\n let is_deposit_tx = matches!(pending.transaction.as_ref(), FoundryTxEnvelope::Deposit(_));\n let nonce = tx.nonce();\n if nonce < account.nonce && !is_deposit_tx {\n warn!(target: \"backend\", \"[{:?}] nonce too low\", tx.hash());\n return Err(InvalidTransactionError::NonceTooLow);\n }\n\n // EIP-4844 structural validation\n if env.evm_env.cfg_env.spec >= SpecId::CANCUN && tx.is_eip4844() {\n // Heavy (blob validation) checks\n let blob_tx = match tx.as_ref() {\n FoundryTxEnvelope::Eip4844(tx) => tx.tx(),\n _ => unreachable!(),\n };\n\n let blob_count = blob_tx.tx().blob_versioned_hashes.len();\n\n // Ensure there are blob hashes.\n if blob_count == 0 {\n return Err(InvalidTransactionError::NoBlobHashes);\n }\n\n // Ensure the tx does not exceed the max blobs per transaction.\n let max_blobs_per_tx = self.blob_params().max_blobs_per_tx as usize;\n if blob_count > max_blobs_per_tx {\n return Err(InvalidTransactionError::TooManyBlobs(blob_count, max_blobs_per_tx));\n }\n\n // Check for any blob validation errors if not impersonating.\n if !self.skip_blob_validation(Some(*pending.sender()))\n && let Err(err) = blob_tx.validate(EnvKzgSettings::default().get())\n {\n return Err(InvalidTransactionError::BlobTransactionValidationError(err));\n }\n }\n\n // EIP-3860 initcode size validation, respects --code-size-limit / --disable-code-size-limit\n if env.evm_env.cfg_env.spec >= SpecId::SHANGHAI && tx.kind() == TxKind::Create {\n let max_initcode_size = env\n .evm_env\n .cfg_env\n .limit_contract_code_size\n .map(|limit| limit.saturating_mul(2))\n .unwrap_or(revm::primitives::eip3860::MAX_INITCODE_SIZE);\n if tx.input().len() > max_initcode_size {\n return Err(InvalidTransactionError::MaxInitCodeSizeExceeded);\n }\n }\n\n // Balance and fee related checks\n if !self.disable_pool_balance_checks {\n // Gas limit validation\n if tx.gas_limit() < MIN_TRANSACTION_GAS as u64 {\n warn!(target: \"backend\", \"[{:?}] gas too low\", tx.hash());\n return Err(InvalidTransactionError::GasTooLow);\n }\n\n // Check tx gas limit against block gas limit, if block gas limit is set.\n if !env.evm_env.cfg_env.disable_block_gas_limit\n && tx.gas_limit() > env.evm_env.block_env.gas_limit\n {\n warn!(target: \"backend\", \"[{:?}] gas too high\", tx.hash());\n return Err(InvalidTransactionError::GasTooHigh(ErrDetail {\n detail: String::from(\"tx.gas_limit > env.block.gas_limit\"),\n }));\n }\n\n // Check tx gas limit against tx gas limit cap (Osaka hard fork and later).\n if env.evm_env.cfg_env.tx_gas_limit_cap.is_none()\n && tx.gas_limit() > env.evm_env.cfg_env().tx_gas_limit_cap()\n {\n warn!(target: \"backend\", \"[{:?}] gas too high\", tx.hash());\n return Err(InvalidTransactionError::GasTooHigh(ErrDetail {\n detail: String::from(\"tx.gas_limit > env.cfg.tx_gas_limit_cap\"),\n }));\n }\n\n // EIP-1559 fee validation (London hard fork and later).\n if env.evm_env.cfg_env.spec >= SpecId::LONDON {\n if tx.max_fee_per_gas() < env.evm_env.block_env.basefee.into() && !is_deposit_tx {\n warn!(target: \"backend\", \"max fee per gas={}, too low, block basefee={}\", tx.max_fee_per_gas(), env.evm_env.block_env.basefee);\n return Err(InvalidTransactionError::FeeCapTooLow);\n }\n\n if let (Some(max_priority_fee_per_gas), max_fee_per_gas) =\n (tx.as_ref().max_priority_fee_per_gas(), tx.as_ref().max_fee_per_gas())\n && max_priority_fee_per_gas > max_fee_per_gas\n {\n warn!(target: \"backend\", \"max priority fee per gas={}, too high, max fee per gas={}\", max_priority_fee_per_gas, max_fee_per_gas);\n return Err(InvalidTransactionError::TipAboveFeeCap);\n }\n }\n\n // EIP-4844 blob fee validation\n if env.evm_env.cfg_env.spec >= SpecId::CANCUN\n && tx.is_eip4844()\n && let Some(max_fee_per_blob_gas) = tx.max_fee_per_blob_gas()\n && let Some(blob_gas_and_price) = &env.evm_env.block_env.blob_excess_gas_and_price\n && max_fee_per_blob_gas < blob_gas_and_price.blob_gasprice\n {\n warn!(target: \"backend\", \"max fee per blob gas={}, too low, block blob gas price={}\", max_fee_per_blob_gas, blob_gas_and_price.blob_gasprice);\n return Err(InvalidTransactionError::BlobFeeCapTooLow(\n max_fee_per_blob_gas,\n blob_gas_and_price.blob_gasprice,\n ));\n }\n\n let max_cost =\n (tx.gas_limit() as u128).saturating_mul(tx.max_fee_per_gas()).saturating_add(\n tx.blob_gas_used()\n .map(|g| g as u128)\n .unwrap_or(0)\n .mul(tx.max_fee_per_blob_gas().unwrap_or(0)),\n );\n let value = tx.value();\n match tx.as_ref() {\n FoundryTxEnvelope::Deposit(deposit_tx) => {\n // Deposit transactions\n // https://specs.optimism.io/protocol/deposits.html#execution\n // 1. no gas cost check required since already have prepaid gas from L1\n // 2. increment account balance by deposited amount before checking for\n // sufficient funds `tx.value <= existing account value + deposited value`\n if value > account.balance + U256::from(deposit_tx.mint) {\n warn!(target: \"backend\", \"[{:?}] insufficient balance={}, required={} account={:?}\", tx.hash(), account.balance + U256::from(deposit_tx.mint), value, *pending.sender());\n return Err(InvalidTransactionError::InsufficientFunds);\n }\n }\n _ => {\n // check sufficient funds: `gas * price + value`\n let req_funds =\n max_cost.checked_add(value.saturating_to()).ok_or_else(|| {\n warn!(target: \"backend\", \"[{:?}] cost too high\", tx.hash());\n InvalidTransactionError::InsufficientFunds\n })?;\n if account.balance < U256::from(req_funds) {\n warn!(target: \"backend\", \"[{:?}] insufficient balance={}, required={} account={:?}\", tx.hash(), account.balance, req_funds, *pending.sender());\n return Err(InvalidTransactionError::InsufficientFunds);\n }\n }\n }\n }\n Ok(())\n }\n\n fn validate_for(\n &self,\n tx: &PendingTransaction,\n account: &AccountInfo,\n env: &Env,\n ) -> Result<(), InvalidTransactionError> {\n self.validate_pool_transaction_for(tx, account, env)?;\n if tx.nonce() > account.nonce {\n return Err(InvalidTransactionError::NonceTooHigh);\n }\n Ok(())\n }\n}\n\n/// Creates a `AnyRpcTransaction` as it's expected for the `eth` RPC api from storage data\npub fn transaction_build(\n tx_hash: Option,\n eth_transaction: MaybeImpersonatedTransaction,\n block: Option<&Block>,\n info: Option,\n base_fee: Option,\n) -> AnyRpcTransaction {\n if let FoundryTxEnvelope::Deposit(deposit_tx) = eth_transaction.as_ref() {\n let dep_tx = deposit_tx;\n\n let ser = serde_json::to_value(dep_tx).expect(\"could not serialize TxDeposit\");\n let maybe_deposit_fields = OtherFields::try_from(ser);\n\n match maybe_deposit_fields {\n Ok(mut fields) => {\n // Add zeroed signature fields for backwards compatibility\n // https://specs.optimism.io/protocol/deposits.html#the-deposited-transaction-type\n fields.insert(\"v\".to_string(), serde_json::to_value(\"0x0\").unwrap());\n fields.insert(\"r\".to_string(), serde_json::to_value(B256::ZERO).unwrap());\n fields.insert(String::from(\"s\"), serde_json::to_value(B256::ZERO).unwrap());\n fields.insert(String::from(\"nonce\"), serde_json::to_value(\"0x0\").unwrap());\n\n let inner = UnknownTypedTransaction {\n ty: AnyTxType(DEPOSIT_TX_TYPE_ID),\n fields,\n memo: Default::default(),\n };\n\n let envelope = AnyTxEnvelope::Unknown(UnknownTxEnvelope {\n hash: eth_transaction.hash(),\n inner,\n });\n\n let tx = Transaction {\n inner: Recovered::new_unchecked(envelope, deposit_tx.from),\n block_hash: block\n .as_ref()\n .map(|block| B256::from(keccak256(alloy_rlp::encode(&block.header)))),\n block_number: block.as_ref().map(|block| block.header.number()),\n transaction_index: info.as_ref().map(|info| info.transaction_index),\n effective_gas_price: None,\n block_timestamp: block.as_ref().map(|block| block.header.timestamp()),\n };\n\n return AnyRpcTransaction::from(WithOtherFields::new(tx));\n }\n Err(_) => {\n error!(target: \"backend\", \"failed to serialize deposit transaction\");\n }\n }\n }\n\n let from = eth_transaction.recover().unwrap_or_default();\n let effective_gas_price = eth_transaction.effective_gas_price(base_fee);\n\n // if a specific hash was provided we update the transaction's hash\n // This is important for impersonated transactions since they all use the\n // `BYPASS_SIGNATURE` which would result in different hashes\n // Note: for impersonated transactions this only concerns pending transactions because\n // there's no `info` yet.\n let hash = tx_hash.unwrap_or_else(|| eth_transaction.hash());\n\n // TODO: this panics for non-standard tx types (e.g. Tempo) that aren't handled above\n // (pre-existing issue from the original `into_rpc_transaction`).\n let eth_envelope = FoundryTxEnvelope::from(eth_transaction)\n .try_into_eth()\n .expect(\"deposit transactions are handled above\");\n\n let envelope = match eth_envelope {\n TxEnvelope::Legacy(signed_tx) => {\n let (t, sig, _) = signed_tx.into_parts();\n let new_signed = Signed::new_unchecked(t, sig, hash);\n AnyTxEnvelope::Ethereum(TxEnvelope::Legacy(new_signed))\n }\n TxEnvelope::Eip1559(signed_tx) => {\n let (t, sig, _) = signed_tx.into_parts();\n let new_signed = Signed::new_unchecked(t, sig, hash);\n AnyTxEnvelope::Ethereum(TxEnvelope::Eip1559(new_signed))\n }\n TxEnvelope::Eip2930(signed_tx) => {\n let (t, sig, _) = signed_tx.into_parts();\n let new_signed = Signed::new_unchecked(t, sig, hash);\n AnyTxEnvelope::Ethereum(TxEnvelope::Eip2930(new_signed))\n }\n TxEnvelope::Eip4844(signed_tx) => {\n let (t, sig, _) = signed_tx.into_parts();\n let new_signed = Signed::new_unchecked(t, sig, hash);\n AnyTxEnvelope::Ethereum(TxEnvelope::Eip4844(new_signed))\n }\n TxEnvelope::Eip7702(signed_tx) => {\n let (t, sig, _) = signed_tx.into_parts();\n let new_signed = Signed::new_unchecked(t, sig, hash);\n AnyTxEnvelope::Ethereum(TxEnvelope::Eip7702(new_signed))\n }\n };\n\n let tx = Transaction {\n inner: Recovered::new_unchecked(envelope, from),\n block_hash: block.as_ref().map(|block| block.header.hash_slow()),\n block_number: block.as_ref().map(|block| block.header.number()),\n transaction_index: info.as_ref().map(|info| info.transaction_index),\n // deprecated\n effective_gas_price: Some(effective_gas_price),\n block_timestamp: block.as_ref().map(|block| block.header.timestamp()),\n };\n AnyRpcTransaction::from(WithOtherFields::new(tx))\n}\n\n/// Prove a storage key's existence or nonexistence in the account's storage trie.\n///\n/// `storage_key` is the hash of the desired storage key, meaning\n/// this will only work correctly under a secure trie.\n/// `storage_key` == keccak(key)\npub fn prove_storage(storage: &HashMap, keys: &[B256]) -> (B256, Vec>) {\n let keys: Vec<_> = keys.iter().map(|key| Nibbles::unpack(keccak256(key))).collect();\n\n let mut builder = HashBuilder::default().with_proof_retainer(ProofRetainer::new(keys.clone()));\n\n for (key, value) in trie_storage(storage) {\n builder.add_leaf(key, &value);\n }\n\n let root = builder.root();\n\n let mut proofs = Vec::new();\n let all_proof_nodes = builder.take_proof_nodes();\n\n for proof_key in keys {\n // Iterate over all proof nodes and find the matching ones.\n // The filtered results are guaranteed to be in order.\n let matching_proof_nodes =\n all_proof_nodes.matching_nodes_sorted(&proof_key).into_iter().map(|(_, node)| node);\n proofs.push(matching_proof_nodes.collect());\n }\n\n (root, proofs)\n}\n\npub fn is_arbitrum(chain_id: u64) -> bool {\n if let Ok(chain) = NamedChain::try_from(chain_id) {\n return chain.is_arbitrum();\n }\n false\n}\n\npub fn op_haltreason_to_instruction_result(op_reason: OpHaltReason) -> InstructionResult {\n match op_reason {\n OpHaltReason::Base(eth_h) => eth_h.into(),\n OpHaltReason::FailedDeposit => InstructionResult::Stop,\n }\n}\n\n#[cfg(test)]\nmod tests {\n use crate::{NodeConfig, spawn};\n\n #[tokio::test]\n async fn test_deterministic_block_mining() {\n // Test that mine_block produces deterministic block hashes with same initial conditions\n let genesis_timestamp = 1743944919u64;\n\n // Create two identical backends\n let config_a = NodeConfig::test().with_genesis_timestamp(genesis_timestamp.into());\n let config_b = NodeConfig::test().with_genesis_timestamp(genesis_timestamp.into());\n\n let (api_a, _handle_a) = spawn(config_a).await;\n let (api_b, _handle_b) = spawn(config_b).await;\n\n // Mine empty blocks (no transactions) on both backends\n let outcome_a_1 = api_a.backend.mine_block(vec![]).await;\n let outcome_b_1 = api_b.backend.mine_block(vec![]).await;\n\n // Both should mine the same block number\n assert_eq!(outcome_a_1.block_number, outcome_b_1.block_number);\n\n // Get the actual blocks to compare hashes\n let block_a_1 =\n api_a.block_by_number(outcome_a_1.block_number.into()).await.unwrap().unwrap();\n let block_b_1 =\n api_b.block_by_number(outcome_b_1.block_number.into()).await.unwrap().unwrap();\n\n // The block hashes should be identical\n assert_eq!(\n block_a_1.header.hash, block_b_1.header.hash,\n \"Block hashes should be deterministic. Got {} vs {}\",\n block_a_1.header.hash, block_b_1.header.hash\n );\n\n // Mine another block to ensure it remains deterministic\n let outcome_a_2 = api_a.backend.mine_block(vec![]).await;\n let outcome_b_2 = api_b.backend.mine_block(vec![]).await;\n\n let block_a_2 =\n api_a.block_by_number(outcome_a_2.block_number.into()).await.unwrap().unwrap();\n let block_b_2 =\n api_b.block_by_number(outcome_b_2.block_number.into()).await.unwrap().unwrap();\n\n assert_eq!(\n block_a_2.header.hash, block_b_2.header.hash,\n \"Second block hashes should also be deterministic. Got {} vs {}\",\n block_a_2.header.hash, block_b_2.header.hash\n );\n\n // Ensure the blocks are different (sanity check)\n assert_ne!(\n block_a_1.header.hash, block_a_2.header.hash,\n \"Different blocks should have different hashes\"\n );\n }\n}\n" }, { "path": "crates/anvil/src/eth/backend/mem/state.rs", "content": "//! Support for generating the state root for memdb storage\n\nuse alloy_primitives::{\n B256, U256, keccak256,\n map::{AddressMap, HashMap},\n};\nuse alloy_rlp::Encodable;\nuse alloy_trie::{HashBuilder, Nibbles};\nuse revm::{database::DbAccount, state::AccountInfo};\n\npub fn build_root(values: impl IntoIterator)>) -> B256 {\n let mut builder = HashBuilder::default();\n for (key, value) in values {\n builder.add_leaf(key, value.as_ref());\n }\n builder.root()\n}\n\n/// Builds state root from the given accounts\npub fn state_root(accounts: &AddressMap) -> B256 {\n build_root(trie_accounts(accounts))\n}\n\n/// Builds storage root from the given storage\npub fn storage_root(storage: &HashMap) -> B256 {\n build_root(trie_storage(storage))\n}\n\n/// Builds iterator over stored key-value pairs ready for storage trie root calculation.\npub fn trie_storage(storage: &HashMap) -> Vec<(Nibbles, Vec)> {\n let mut storage = storage\n .iter()\n .map(|(key, value)| {\n let data = alloy_rlp::encode(value);\n (Nibbles::unpack(keccak256(key.to_be_bytes::<32>())), data)\n })\n .collect::>();\n storage.sort_by_key(|(key, _)| *key);\n\n storage\n}\n\n/// Builds iterator over stored key-value pairs ready for account trie root calculation.\npub fn trie_accounts(accounts: &AddressMap) -> Vec<(Nibbles, Vec)> {\n let mut accounts: Vec<(Nibbles, Vec)> = accounts\n .iter()\n .map(|(address, account)| {\n let data = trie_account_rlp(&account.info, &account.storage);\n (Nibbles::unpack(keccak256(*address)), data)\n })\n .collect();\n accounts.sort_by_key(|(key, _)| *key);\n\n accounts\n}\n\n/// Returns the RLP for this account.\npub fn trie_account_rlp(info: &AccountInfo, storage: &HashMap) -> Vec {\n let mut out: Vec = Vec::new();\n let list: [&dyn Encodable; 4] =\n [&info.nonce, &info.balance, &storage_root(storage), &info.code_hash];\n\n alloy_rlp::encode_list::<_, dyn Encodable>(&list, &mut out);\n\n out\n}\n" }, { "path": "crates/anvil/src/eth/backend/mem/storage.rs", "content": "//! In-memory blockchain storage\nuse crate::eth::{\n backend::{\n db::{\n MaybeFullDatabase, SerializableBlock, SerializableHistoricalStates,\n SerializableTransaction, StateDb,\n },\n env::Env,\n mem::cache::DiskStateCache,\n },\n pool::transactions::PoolTransaction,\n};\nuse alloy_consensus::{BlockHeader, Header, constants::EMPTY_WITHDRAWALS};\nuse alloy_eips::eip7685::EMPTY_REQUESTS_HASH;\nuse alloy_network::Network;\nuse alloy_primitives::{\n B256, Bytes, U256,\n map::{B256HashMap, HashMap},\n};\nuse alloy_rpc_types::{\n BlockId, BlockNumberOrTag, TransactionInfo as RethTransactionInfo,\n trace::{\n otterscan::{InternalOperation, OperationType},\n parity::LocalizedTransactionTrace,\n },\n};\nuse anvil_core::eth::{\n block::{Block, create_block},\n transaction::{MaybeImpersonatedTransaction, TransactionInfo},\n};\nuse foundry_evm::{\n backend::MemDb,\n traces::{CallKind, ParityTraceBuilder, TracingInspectorConfig},\n};\nuse foundry_primitives::{FoundryNetwork, FoundryTxEnvelope};\nuse parking_lot::RwLock;\nuse revm::{context::Block as RevmBlock, primitives::hardfork::SpecId};\nuse std::{collections::VecDeque, fmt, path::PathBuf, sync::Arc, time::Duration};\n// use yansi::Paint;\n\n// === various limits in number of blocks ===\n\npub const DEFAULT_HISTORY_LIMIT: usize = 500;\nconst MIN_HISTORY_LIMIT: usize = 10;\n// 1hr of up-time at lowest 1s interval\nconst MAX_ON_DISK_HISTORY_LIMIT: usize = 3_600;\n\n/// Represents the complete state of single block\npub struct InMemoryBlockStates {\n /// The states at a certain block\n states: B256HashMap,\n /// states which data is moved to disk\n on_disk_states: B256HashMap,\n /// How many states to store at most\n in_memory_limit: usize,\n /// minimum amount of states we keep in memory\n min_in_memory_limit: usize,\n /// maximum amount of states we keep on disk\n ///\n /// Limiting the states will prevent disk blow up, especially in interval mining mode\n max_on_disk_limit: usize,\n /// the oldest states written to disk\n oldest_on_disk: VecDeque,\n /// all states present, used to enforce `in_memory_limit`\n present: VecDeque,\n /// Stores old states on disk\n disk_cache: DiskStateCache,\n}\n\nimpl InMemoryBlockStates {\n /// Creates a new instance with limited slots\n pub fn new(in_memory_limit: usize, on_disk_limit: usize) -> Self {\n Self {\n states: Default::default(),\n on_disk_states: Default::default(),\n in_memory_limit,\n min_in_memory_limit: in_memory_limit.min(MIN_HISTORY_LIMIT),\n max_on_disk_limit: on_disk_limit,\n oldest_on_disk: Default::default(),\n present: Default::default(),\n disk_cache: Default::default(),\n }\n }\n\n /// Configures no disk caching\n pub fn memory_only(mut self) -> Self {\n self.max_on_disk_limit = 0;\n self\n }\n\n /// Configures the path on disk where the states will cached.\n pub fn disk_path(mut self, path: PathBuf) -> Self {\n self.disk_cache = self.disk_cache.with_path(path);\n self\n }\n\n /// This modifies the `limit` what to keep stored in memory.\n ///\n /// This will ensure the new limit adjusts based on the block time.\n /// The lowest blocktime is 1s which should increase the limit slightly\n pub fn update_interval_mine_block_time(&mut self, block_time: Duration) {\n let block_time = block_time.as_secs();\n // for block times lower than 2s we increase the mem limit since we're mining _small_ blocks\n // very fast\n // this will gradually be decreased once the max limit was reached\n if block_time <= 2 {\n self.in_memory_limit = DEFAULT_HISTORY_LIMIT * 3;\n self.enforce_limits();\n }\n }\n\n /// Returns true if only memory caching is supported.\n fn is_memory_only(&self) -> bool {\n self.max_on_disk_limit == 0\n }\n\n /// Inserts a new (hash -> state) pair\n ///\n /// When the configured limit for the number of states that can be stored in memory is reached,\n /// the oldest state is removed.\n ///\n /// Since we keep a snapshot of the entire state as history, the size of the state will increase\n /// with the transactions processed. To counter this, we gradually decrease the cache limit with\n /// the number of states/blocks until we reached the `min_limit`.\n ///\n /// When a state that was previously written to disk is requested, it is simply read from disk.\n pub fn insert(&mut self, hash: B256, state: StateDb) {\n if !self.is_memory_only() && self.present.len() >= self.in_memory_limit {\n // once we hit the max limit we gradually decrease it\n self.in_memory_limit =\n self.in_memory_limit.saturating_sub(1).max(self.min_in_memory_limit);\n }\n\n self.enforce_limits();\n\n self.states.insert(hash, state);\n self.present.push_back(hash);\n }\n\n /// Enforces configured limits\n fn enforce_limits(&mut self) {\n // enforce memory limits\n while self.present.len() >= self.in_memory_limit {\n // evict the oldest block\n if let Some((hash, mut state)) = self\n .present\n .pop_front()\n .and_then(|hash| self.states.remove(&hash).map(|state| (hash, state)))\n {\n // only write to disk if supported\n if !self.is_memory_only() {\n let state_snapshot = state.0.clear_into_state_snapshot();\n if self.disk_cache.write(hash, &state_snapshot) {\n // Write succeeded, move state to on-disk tracking\n self.on_disk_states.insert(hash, state);\n self.oldest_on_disk.push_back(hash);\n } else {\n // Write failed, restore state to memory to avoid data loss\n state.init_from_state_snapshot(state_snapshot);\n self.states.insert(hash, state);\n self.present.push_front(hash);\n // Increase limit temporarily to prevent infinite retry loop\n self.in_memory_limit = self.in_memory_limit.saturating_add(1);\n break;\n }\n }\n }\n }\n\n // enforce on disk limit and purge the oldest state cached on disk\n while !self.is_memory_only() && self.oldest_on_disk.len() >= self.max_on_disk_limit {\n // evict the oldest block\n if let Some(hash) = self.oldest_on_disk.pop_front() {\n self.on_disk_states.remove(&hash);\n self.disk_cache.remove(hash);\n }\n }\n }\n\n /// Returns the in-memory state for the given `hash` if present\n pub fn get_state(&self, hash: &B256) -> Option<&StateDb> {\n self.states.get(hash)\n }\n\n /// Returns on-disk state for the given `hash` if present\n pub fn get_on_disk_state(&mut self, hash: &B256) -> Option<&StateDb> {\n if let Some(state) = self.on_disk_states.get_mut(hash)\n && let Some(cached) = self.disk_cache.read(*hash)\n {\n state.init_from_state_snapshot(cached);\n return Some(state);\n }\n\n None\n }\n\n /// Sets the maximum number of stats we keep in memory\n pub fn set_cache_limit(&mut self, limit: usize) {\n self.in_memory_limit = limit;\n }\n\n /// Clears all entries\n pub fn clear(&mut self) {\n self.states.clear();\n self.on_disk_states.clear();\n self.present.clear();\n for on_disk in std::mem::take(&mut self.oldest_on_disk) {\n self.disk_cache.remove(on_disk)\n }\n }\n\n /// Serialize all states to a list of serializable historical states\n pub fn serialized_states(&mut self) -> SerializableHistoricalStates {\n // Get in-memory states\n let mut states = self\n .states\n .iter_mut()\n .map(|(hash, state)| (*hash, state.serialize_state()))\n .collect::>();\n\n // Get on-disk state snapshots\n self.on_disk_states.iter().for_each(|(hash, _)| {\n if let Some(state_snapshot) = self.disk_cache.read(*hash) {\n states.push((*hash, state_snapshot));\n }\n });\n\n SerializableHistoricalStates::new(states)\n }\n\n /// Load states from serialized data\n pub fn load_states(&mut self, states: SerializableHistoricalStates) {\n for (hash, state_snapshot) in states {\n let mut state_db = StateDb::new(MemDb::default());\n state_db.init_from_state_snapshot(state_snapshot);\n self.insert(hash, state_db);\n }\n }\n}\n\nimpl fmt::Debug for InMemoryBlockStates {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n f.debug_struct(\"InMemoryBlockStates\")\n .field(\"in_memory_limit\", &self.in_memory_limit)\n .field(\"min_in_memory_limit\", &self.min_in_memory_limit)\n .field(\"max_on_disk_limit\", &self.max_on_disk_limit)\n .field(\"oldest_on_disk\", &self.oldest_on_disk)\n .field(\"present\", &self.present)\n .finish_non_exhaustive()\n }\n}\n\nimpl Default for InMemoryBlockStates {\n fn default() -> Self {\n // enough in memory to store `DEFAULT_HISTORY_LIMIT` blocks in memory\n Self::new(DEFAULT_HISTORY_LIMIT, MAX_ON_DISK_HISTORY_LIMIT)\n }\n}\n\n/// Stores the blockchain data (blocks, transactions)\n#[derive(Clone, Debug)]\npub struct BlockchainStorage {\n /// all stored blocks (block hash -> block)\n pub blocks: B256HashMap,\n /// mapping from block number -> block hash\n pub hashes: HashMap,\n /// The current best hash\n pub best_hash: B256,\n /// The current best block number\n pub best_number: u64,\n /// genesis hash of the chain\n pub genesis_hash: B256,\n /// Mapping from the transaction hash to a tuple containing the transaction as well as the\n /// transaction receipt\n pub transactions: B256HashMap>,\n /// The total difficulty of the chain until this block\n pub total_difficulty: U256,\n}\n\nimpl BlockchainStorage {\n /// Creates a new storage with a genesis block\n pub fn new(\n env: &Env,\n spec_id: SpecId,\n base_fee: Option,\n timestamp: u64,\n genesis_number: u64,\n ) -> Self {\n let is_shanghai = spec_id >= SpecId::SHANGHAI;\n let is_cancun = spec_id >= SpecId::CANCUN;\n let is_prague = spec_id >= SpecId::PRAGUE;\n\n // create a dummy genesis block\n let header = Header {\n timestamp,\n base_fee_per_gas: base_fee,\n gas_limit: env.evm_env.block_env.gas_limit,\n beneficiary: env.evm_env.block_env.beneficiary,\n difficulty: env.evm_env.block_env.difficulty,\n blob_gas_used: env.evm_env.block_env.blob_excess_gas_and_price.as_ref().map(|_| 0),\n excess_blob_gas: env.evm_env.block_env.blob_excess_gas(),\n number: genesis_number,\n parent_beacon_block_root: is_cancun.then_some(Default::default()),\n withdrawals_root: is_shanghai.then_some(EMPTY_WITHDRAWALS),\n requests_hash: is_prague.then_some(EMPTY_REQUESTS_HASH),\n ..Default::default()\n };\n let block =\n create_block(header, Vec::>::new());\n let genesis_hash = block.header.hash_slow();\n let best_hash = genesis_hash;\n let best_number = genesis_number;\n\n let mut blocks = B256HashMap::default();\n blocks.insert(genesis_hash, block);\n\n let mut hashes = HashMap::default();\n hashes.insert(best_number, genesis_hash);\n Self {\n blocks,\n hashes,\n best_hash,\n best_number,\n genesis_hash,\n transactions: Default::default(),\n total_difficulty: Default::default(),\n }\n }\n\n pub fn forked(block_number: u64, block_hash: B256, total_difficulty: U256) -> Self {\n let mut hashes = HashMap::default();\n hashes.insert(block_number, block_hash);\n\n Self {\n blocks: B256HashMap::default(),\n hashes,\n best_hash: block_hash,\n best_number: block_number,\n genesis_hash: Default::default(),\n transactions: Default::default(),\n total_difficulty,\n }\n }\n\n /// Unwind the chain state back to the given block in storage.\n ///\n /// The block identified by `block_number` and `block_hash` is __non-inclusive__, i.e. it will\n /// remain in the state.\n pub fn unwind_to(&mut self, block_number: u64, block_hash: B256) -> Vec {\n let mut removed = vec![];\n let best_num: u64 = self.best_number;\n for i in (block_number + 1)..=best_num {\n if let Some(hash) = self.hashes.get(&i).copied() {\n // First remove the block's transactions while the mappings still exist\n self.remove_block_transactions_by_number(i);\n\n // Now remove the block from storage (may already be empty of txs) and drop mapping\n if let Some(block) = self.blocks.remove(&hash) {\n removed.push(block);\n }\n self.hashes.remove(&i);\n }\n }\n self.best_hash = block_hash;\n self.best_number = block_number;\n removed\n }\n\n pub fn empty() -> Self {\n Self {\n blocks: Default::default(),\n hashes: Default::default(),\n best_hash: Default::default(),\n best_number: Default::default(),\n genesis_hash: Default::default(),\n transactions: Default::default(),\n total_difficulty: Default::default(),\n }\n }\n\n /// Removes all stored transactions for the given block number\n pub fn remove_block_transactions_by_number(&mut self, num: u64) {\n if let Some(hash) = self.hashes.get(&num).copied() {\n self.remove_block_transactions(hash);\n }\n }\n\n /// Removes all stored transactions for the given block hash\n pub fn remove_block_transactions(&mut self, block_hash: B256) {\n if let Some(block) = self.blocks.get_mut(&block_hash) {\n for tx in &block.body.transactions {\n self.transactions.remove(&tx.hash());\n }\n block.body.transactions.clear();\n }\n }\n\n /// Serialize all blocks in storage\n pub fn serialized_blocks(&self) -> Vec {\n self.blocks.values().map(|block| block.clone().into()).collect()\n }\n\n /// Deserialize and add all blocks data to the backend storage\n pub fn load_blocks(&mut self, serializable_blocks: Vec) {\n for serializable_block in &serializable_blocks {\n let block: Block = serializable_block.clone().into();\n let block_hash = block.header.hash_slow();\n let block_number = block.header.number();\n self.blocks.insert(block_hash, block);\n self.hashes.insert(block_number, block_hash);\n\n // Update genesis_hash if we are loading block 0, so that Finalized/Safe/Earliest\n // block tag lookups return the correct hash.\n // See: https://github.com/foundry-rs/foundry/issues/12645\n if block_number == 0 {\n self.genesis_hash = block_hash;\n }\n }\n }\n\n /// Returns the hash for [BlockNumberOrTag]\n pub fn hash(&self, number: BlockNumberOrTag) -> Option {\n let slots_in_an_epoch = 32;\n match number {\n BlockNumberOrTag::Latest => Some(self.best_hash),\n BlockNumberOrTag::Earliest => Some(self.genesis_hash),\n BlockNumberOrTag::Pending => None,\n BlockNumberOrTag::Number(num) => self.hashes.get(&num).copied(),\n BlockNumberOrTag::Safe => {\n if self.best_number > (slots_in_an_epoch) {\n self.hashes.get(&(self.best_number - (slots_in_an_epoch))).copied()\n } else {\n Some(self.genesis_hash) // treat the genesis block as safe \"by definition\"\n }\n }\n BlockNumberOrTag::Finalized => {\n if self.best_number > (slots_in_an_epoch * 2) {\n self.hashes.get(&(self.best_number - (slots_in_an_epoch * 2))).copied()\n } else {\n Some(self.genesis_hash)\n }\n }\n }\n }\n}\n\nimpl BlockchainStorage {\n pub fn serialized_transactions(&self) -> Vec {\n self.transactions\n .values()\n .map(|tx: &MinedTransaction| tx.clone().into())\n .collect()\n }\n\n /// Deserialize and add all transactions data to the backend storage\n pub fn load_transactions(&mut self, serializable_transactions: Vec) {\n for serializable_transaction in &serializable_transactions {\n let transaction: MinedTransaction =\n serializable_transaction.clone().into();\n self.transactions.insert(transaction.info.transaction_hash, transaction);\n }\n }\n}\n\n/// A simple in-memory blockchain\n#[derive(Clone, Debug)]\npub struct Blockchain {\n /// underlying storage that supports concurrent reads\n pub storage: Arc>>,\n}\n\nimpl Blockchain {\n /// Creates a new storage with a genesis block\n pub fn new(\n env: &Env,\n spec_id: SpecId,\n base_fee: Option,\n timestamp: u64,\n genesis_number: u64,\n ) -> Self {\n Self {\n storage: Arc::new(RwLock::new(BlockchainStorage::new(\n env,\n spec_id,\n base_fee,\n timestamp,\n genesis_number,\n ))),\n }\n }\n\n pub fn forked(block_number: u64, block_hash: B256, total_difficulty: U256) -> Self {\n Self {\n storage: Arc::new(RwLock::new(BlockchainStorage::forked(\n block_number,\n block_hash,\n total_difficulty,\n ))),\n }\n }\n\n /// returns the header hash of given block\n pub fn hash(&self, id: BlockId) -> Option {\n match id {\n BlockId::Hash(h) => Some(h.block_hash),\n BlockId::Number(num) => self.storage.read().hash(num),\n }\n }\n\n pub fn get_block_by_hash(&self, hash: &B256) -> Option {\n self.storage.read().blocks.get(hash).cloned()\n }\n\n pub fn get_transaction_by_hash(&self, hash: &B256) -> Option> {\n self.storage.read().transactions.get(hash).cloned()\n }\n\n /// Returns the total number of blocks\n pub fn blocks_count(&self) -> usize {\n self.storage.read().blocks.len()\n }\n}\n\n/// Represents the outcome of mining a new block\npub struct MinedBlockOutcome {\n /// The block that was mined\n pub block_number: u64,\n /// All transactions included in the block\n pub included: Vec>>,\n /// All transactions that were attempted to be included but were invalid at the time of\n /// execution\n pub invalid: Vec>>,\n}\n\nimpl Clone for MinedBlockOutcome {\n fn clone(&self) -> Self {\n Self {\n block_number: self.block_number,\n included: self.included.clone(),\n invalid: self.invalid.clone(),\n }\n }\n}\n\nimpl fmt::Debug for MinedBlockOutcome {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n f.debug_struct(\"MinedBlockOutcome\")\n .field(\"block_number\", &self.block_number)\n .field(\"included\", &self.included.len())\n .field(\"invalid\", &self.invalid.len())\n .finish()\n }\n}\n\n/// Container type for a mined transaction\n#[derive(Clone, Debug)]\npub struct MinedTransaction {\n pub info: TransactionInfo,\n pub receipt: N::ReceiptEnvelope,\n pub block_hash: B256,\n pub block_number: u64,\n}\n\nimpl MinedTransaction {\n /// Returns the traces of the transaction for `trace_transaction`\n pub fn parity_traces(&self) -> Vec {\n ParityTraceBuilder::new(\n self.info.traces.clone(),\n None,\n TracingInspectorConfig::default_parity(),\n )\n .into_localized_transaction_traces(RethTransactionInfo {\n hash: Some(self.info.transaction_hash),\n index: Some(self.info.transaction_index),\n block_hash: Some(self.block_hash),\n block_number: Some(self.block_number),\n base_fee: None,\n block_timestamp: None,\n })\n }\n\n pub fn ots_internal_operations(&self) -> Vec {\n self.info\n .traces\n .iter()\n .filter_map(|node| {\n let r#type = match node.trace.kind {\n _ if node.is_selfdestruct() => OperationType::OpSelfDestruct,\n CallKind::Call if !node.trace.value.is_zero() => OperationType::OpTransfer,\n CallKind::Create => OperationType::OpCreate,\n CallKind::Create2 => OperationType::OpCreate2,\n _ => return None,\n };\n let mut from = node.trace.caller;\n let mut to = node.trace.address;\n let mut value = node.trace.value;\n if node.is_selfdestruct() {\n from = node.trace.address;\n to = node.trace.selfdestruct_refund_target.unwrap_or_default();\n value = node.trace.selfdestruct_transferred_value.unwrap_or_default();\n }\n Some(InternalOperation { r#type, from, to, value })\n })\n .collect()\n }\n}\n\n/// Intermediary Anvil representation of a receipt\n#[derive(Clone, Debug)]\npub struct MinedTransactionReceipt {\n /// The actual json rpc receipt object\n pub inner: N::ReceiptResponse,\n /// Output data for the transaction\n pub out: Option,\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n use crate::eth::backend::db::Db;\n use alloy_primitives::{Address, hex};\n use alloy_rlp::Decodable;\n use revm::{database::DatabaseRef, state::AccountInfo};\n\n #[test]\n fn test_interval_update() {\n let mut storage = InMemoryBlockStates::default();\n storage.update_interval_mine_block_time(Duration::from_secs(1));\n assert_eq!(storage.in_memory_limit, DEFAULT_HISTORY_LIMIT * 3);\n }\n\n #[test]\n fn test_init_state_limits() {\n let mut storage = InMemoryBlockStates::default();\n assert_eq!(storage.in_memory_limit, DEFAULT_HISTORY_LIMIT);\n assert_eq!(storage.min_in_memory_limit, MIN_HISTORY_LIMIT);\n assert_eq!(storage.max_on_disk_limit, MAX_ON_DISK_HISTORY_LIMIT);\n\n storage = storage.memory_only();\n assert!(storage.is_memory_only());\n\n storage = InMemoryBlockStates::new(1, 0);\n assert!(storage.is_memory_only());\n assert_eq!(storage.in_memory_limit, 1);\n assert_eq!(storage.min_in_memory_limit, 1);\n assert_eq!(storage.max_on_disk_limit, 0);\n\n storage = InMemoryBlockStates::new(1, 2);\n assert!(!storage.is_memory_only());\n assert_eq!(storage.in_memory_limit, 1);\n assert_eq!(storage.min_in_memory_limit, 1);\n assert_eq!(storage.max_on_disk_limit, 2);\n }\n\n #[tokio::test(flavor = \"multi_thread\")]\n async fn can_read_write_cached_state() {\n let mut storage = InMemoryBlockStates::new(1, MAX_ON_DISK_HISTORY_LIMIT);\n let one = B256::from(U256::from(1));\n let two = B256::from(U256::from(2));\n\n let mut state = MemDb::default();\n let addr = Address::random();\n let info = AccountInfo::from_balance(U256::from(1337));\n state.insert_account(addr, info);\n storage.insert(one, StateDb::new(state));\n storage.insert(two, StateDb::new(MemDb::default()));\n\n // wait for files to be flushed\n tokio::time::sleep(std::time::Duration::from_secs(1)).await;\n\n assert_eq!(storage.on_disk_states.len(), 1);\n assert!(storage.on_disk_states.contains_key(&one));\n\n let loaded = storage.get_on_disk_state(&one).unwrap();\n\n let acc = loaded.basic_ref(addr).unwrap().unwrap();\n assert_eq!(acc.balance, U256::from(1337u64));\n }\n\n #[tokio::test(flavor = \"multi_thread\")]\n async fn can_decrease_state_cache_size() {\n let limit = 15;\n let mut storage = InMemoryBlockStates::new(limit, MAX_ON_DISK_HISTORY_LIMIT);\n\n let num_states = 30;\n for idx in 0..num_states {\n let mut state = MemDb::default();\n let hash = B256::from(U256::from(idx));\n let addr = Address::from_word(hash);\n let balance = (idx * 2) as u64;\n let info = AccountInfo::from_balance(U256::from(balance));\n state.insert_account(addr, info);\n storage.insert(hash, StateDb::new(state));\n }\n\n // wait for files to be flushed\n tokio::time::sleep(std::time::Duration::from_secs(1)).await;\n\n let on_disk_states_len = num_states - storage.min_in_memory_limit;\n\n assert_eq!(storage.on_disk_states.len(), on_disk_states_len);\n assert_eq!(storage.present.len(), storage.min_in_memory_limit);\n\n for idx in 0..num_states {\n let hash = B256::from(U256::from(idx));\n let addr = Address::from_word(hash);\n\n let loaded = if idx < on_disk_states_len {\n storage.get_on_disk_state(&hash).unwrap()\n } else {\n storage.get_state(&hash).unwrap()\n };\n\n let acc = loaded.basic_ref(addr).unwrap().unwrap();\n let balance = (idx * 2) as u64;\n assert_eq!(acc.balance, U256::from(balance));\n }\n }\n\n // verifies that blocks and transactions in BlockchainStorage remain the same when dumped and\n // reloaded\n #[test]\n fn test_storage_dump_reload_cycle() {\n let mut dump_storage = BlockchainStorage::::empty();\n\n let header = Header { gas_limit: 123456, ..Default::default() };\n let bytes_first = &mut &hex::decode(\"f86b02843b9aca00830186a094d3e8763675e4c425df46cc3b5c0f6cbdac39604687038d7ea4c68000802ba00eb96ca19e8a77102767a41fc85a36afd5c61ccb09911cec5d3e86e193d9c5aea03a456401896b1b6055311536bf00a718568c744d8c1f9df59879e8350220ca18\").unwrap()[..];\n let tx: MaybeImpersonatedTransaction =\n FoundryTxEnvelope::decode(&mut &bytes_first[..]).unwrap().into();\n let block = create_block(header.clone(), vec![tx.clone()]);\n let block_hash = block.header.hash_slow();\n dump_storage.blocks.insert(block_hash, block);\n\n let serialized_blocks = dump_storage.serialized_blocks();\n let serialized_transactions = dump_storage.serialized_transactions();\n\n let mut load_storage = BlockchainStorage::::empty();\n\n load_storage.load_blocks(serialized_blocks);\n load_storage.load_transactions(serialized_transactions);\n\n let loaded_block = load_storage.blocks.get(&block_hash).unwrap();\n assert_eq!(loaded_block.header.gas_limit(), header.gas_limit());\n let loaded_tx = loaded_block.body.transactions.first().unwrap();\n assert_eq!(loaded_tx, &tx);\n }\n}\n" }, { "path": "crates/anvil/src/eth/backend/mod.rs", "content": "//! blockchain Backend\n\n/// [revm](foundry_evm::revm) related types\npub mod db;\n/// In-memory Backend\npub mod mem;\n\npub mod cheats;\npub mod time;\n\npub mod env;\npub mod executor;\npub mod fork;\npub mod genesis;\npub mod info;\npub mod notifications;\npub mod validate;\n" }, { "path": "crates/anvil/src/eth/backend/notifications.rs", "content": "//! Notifications emitted from the backed\n\nuse alloy_consensus::Header;\nuse alloy_primitives::B256;\nuse futures::channel::mpsc::UnboundedReceiver;\nuse std::sync::Arc;\n\n/// A notification that's emitted when a new block was imported\n#[derive(Clone, Debug)]\npub struct NewBlockNotification {\n /// Hash of the imported block\n pub hash: B256,\n /// block header\n pub header: Arc
,\n}\n\n/// Type alias for a receiver that receives [NewBlockNotification]\npub type NewBlockNotifications = UnboundedReceiver;\n" }, { "path": "crates/anvil/src/eth/backend/time.rs", "content": "//! Manages the block time\n\nuse crate::eth::error::BlockchainError;\nuse chrono::{DateTime, Utc};\nuse parking_lot::RwLock;\nuse std::{sync::Arc, time::Duration};\n\n/// Returns the `Utc` datetime for the given seconds since unix epoch\npub fn utc_from_secs(secs: u64) -> DateTime {\n DateTime::from_timestamp(secs as i64, 0).unwrap_or(DateTime::::MAX_UTC)\n}\n\n/// Manages block time\n#[derive(Clone, Debug)]\npub struct TimeManager {\n /// tracks the overall applied timestamp offset\n offset: Arc>,\n /// The timestamp of the last block header\n last_timestamp: Arc>,\n /// Contains the next timestamp to use\n /// if this is set then the next time `[TimeManager::current_timestamp()]` is called this value\n /// will be taken and returned. After which the `offset` will be updated accordingly\n next_exact_timestamp: Arc>>,\n /// The interval to use when determining the next block's timestamp\n interval: Arc>>,\n}\n\nimpl TimeManager {\n pub fn new(start_timestamp: u64) -> Self {\n let time_manager = Self {\n last_timestamp: Default::default(),\n offset: Default::default(),\n next_exact_timestamp: Default::default(),\n interval: Default::default(),\n };\n time_manager.reset(start_timestamp);\n time_manager\n }\n\n /// Resets the current time manager to the given timestamp, resetting the offsets and\n /// next block timestamp option\n pub fn reset(&self, start_timestamp: u64) {\n let current = duration_since_unix_epoch().as_secs() as i128;\n *self.last_timestamp.write() = start_timestamp;\n *self.offset.write() = (start_timestamp as i128) - current;\n self.next_exact_timestamp.write().take();\n }\n\n pub fn offset(&self) -> i128 {\n *self.offset.read()\n }\n\n /// Adds the given `offset` to the already tracked offset and returns the result\n fn add_offset(&self, offset: i128) -> i128 {\n let mut current = self.offset.write();\n let next = current.saturating_add(offset);\n trace!(target: \"time\", \"adding timestamp offset={}, total={}\", offset, next);\n *current = next;\n next\n }\n\n /// Jumps forward in time by the given seconds\n ///\n /// This will apply a permanent offset to the natural UNIX Epoch timestamp\n pub fn increase_time(&self, seconds: u64) -> i128 {\n self.add_offset(seconds as i128)\n }\n\n /// Sets the exact timestamp to use in the next block\n /// Fails if it's before (or at the same time) the last timestamp\n pub fn set_next_block_timestamp(&self, timestamp: u64) -> Result<(), BlockchainError> {\n trace!(target: \"time\", \"override next timestamp {}\", timestamp);\n if timestamp < *self.last_timestamp.read() {\n return Err(BlockchainError::TimestampError(format!(\n \"{timestamp} is lower than previous block's timestamp\"\n )));\n }\n self.next_exact_timestamp.write().replace(timestamp);\n Ok(())\n }\n\n /// Sets an interval to use when computing the next timestamp\n ///\n /// If an interval already exists, this will update the interval, otherwise a new interval will\n /// be set starting with the current timestamp.\n pub fn set_block_timestamp_interval(&self, interval: u64) {\n trace!(target: \"time\", \"set interval {}\", interval);\n self.interval.write().replace(interval);\n }\n\n /// Removes the interval if it exists\n pub fn remove_block_timestamp_interval(&self) -> bool {\n if self.interval.write().take().is_some() {\n trace!(target: \"time\", \"removed interval\");\n true\n } else {\n false\n }\n }\n\n /// Computes the next timestamp without updating internals\n fn compute_next_timestamp(&self) -> (u64, Option) {\n let current = duration_since_unix_epoch().as_secs() as i128;\n let last_timestamp = *self.last_timestamp.read();\n\n let (mut next_timestamp, update_offset) =\n if let Some(next) = *self.next_exact_timestamp.read() {\n (next, true)\n } else if let Some(interval) = *self.interval.read() {\n (last_timestamp.saturating_add(interval), false)\n } else {\n (current.saturating_add(self.offset()) as u64, false)\n };\n // Ensures that the timestamp is always increasing\n if next_timestamp < last_timestamp {\n next_timestamp = last_timestamp + 1;\n }\n let next_offset = update_offset.then_some((next_timestamp as i128) - current);\n (next_timestamp, next_offset)\n }\n\n /// Returns the current timestamp and updates the underlying offset and interval accordingly\n pub fn next_timestamp(&self) -> u64 {\n let (next_timestamp, next_offset) = self.compute_next_timestamp();\n // Make sure we reset the `next_exact_timestamp`\n self.next_exact_timestamp.write().take();\n if let Some(next_offset) = next_offset {\n *self.offset.write() = next_offset;\n }\n *self.last_timestamp.write() = next_timestamp;\n next_timestamp\n }\n\n /// Returns the current timestamp for a call that does _not_ update the value\n pub fn current_call_timestamp(&self) -> u64 {\n let (next_timestamp, _) = self.compute_next_timestamp();\n next_timestamp\n }\n}\n\n/// Returns the current duration since unix epoch.\npub fn duration_since_unix_epoch() -> Duration {\n use std::time::SystemTime;\n let now = SystemTime::now();\n now.duration_since(SystemTime::UNIX_EPOCH)\n .unwrap_or_else(|err| panic!(\"Current time {now:?} is invalid: {err:?}\"))\n}\n" }, { "path": "crates/anvil/src/eth/backend/validate.rs", "content": "//! Support for validating transactions at certain stages\n\nuse crate::eth::{\n backend::env::Env,\n error::{BlockchainError, InvalidTransactionError},\n};\nuse anvil_core::eth::transaction::PendingTransaction;\nuse revm::state::AccountInfo;\n\n/// A trait for validating transactions\n#[async_trait::async_trait]\npub trait TransactionValidator {\n /// Validates the transaction's validity when it comes to nonce, payment\n ///\n /// This is intended to be checked before the transaction makes it into the pool and whether it\n /// should rather be outright rejected if the sender has insufficient funds.\n async fn validate_pool_transaction(\n &self,\n tx: &PendingTransaction,\n ) -> Result<(), BlockchainError>;\n\n /// Validates the transaction against a specific account before entering the pool\n fn validate_pool_transaction_for(\n &self,\n tx: &PendingTransaction,\n account: &AccountInfo,\n env: &Env,\n ) -> Result<(), InvalidTransactionError>;\n\n /// Validates the transaction against a specific account\n ///\n /// This should succeed if the transaction is ready to be executed\n fn validate_for(\n &self,\n tx: &PendingTransaction,\n account: &AccountInfo,\n env: &Env,\n ) -> Result<(), InvalidTransactionError>;\n}\n" }, { "path": "crates/anvil/src/eth/error.rs", "content": "//! Aggregated error type for this module\n\nuse alloy_consensus::crypto::RecoveryError;\nuse alloy_evm::overrides::StateOverrideError;\nuse alloy_primitives::{B256, Bytes, SignatureError, TxHash};\nuse alloy_rpc_types::BlockNumberOrTag;\nuse alloy_signer::Error as SignerError;\nuse alloy_transport::TransportError;\nuse anvil_core::eth::wallet::WalletError;\nuse anvil_rpc::{\n error::{ErrorCode, RpcError},\n response::ResponseResult,\n};\nuse foundry_evm::{backend::DatabaseError, decode::RevertDecoder};\nuse op_revm::OpTransactionError;\nuse revm::{\n context_interface::result::{EVMError, InvalidHeader, InvalidTransaction},\n interpreter::InstructionResult,\n};\nuse serde::Serialize;\nuse tokio::time::Duration;\n\npub(crate) type Result = std::result::Result;\n\n#[derive(Debug, thiserror::Error)]\npub enum BlockchainError {\n #[error(transparent)]\n Pool(#[from] PoolError),\n #[error(\"No signer available\")]\n NoSignerAvailable,\n #[error(\"Chain Id not available\")]\n ChainIdNotAvailable,\n #[error(\"Invalid input: `max_priority_fee_per_gas` greater than `max_fee_per_gas`\")]\n InvalidFeeInput,\n #[error(\"Transaction data is empty\")]\n EmptyRawTransactionData,\n #[error(\"Failed to decode signed transaction\")]\n FailedToDecodeSignedTransaction,\n #[error(\"Failed to decode transaction\")]\n FailedToDecodeTransaction,\n #[error(\"Failed to decode receipt\")]\n FailedToDecodeReceipt,\n #[error(\"Failed to decode state\")]\n FailedToDecodeStateDump,\n #[error(\"Prevrandao not in the EVM's environment after merge\")]\n PrevrandaoNotSet,\n #[error(transparent)]\n SignatureError(#[from] SignatureError),\n #[error(transparent)]\n RecoveryError(#[from] RecoveryError),\n #[error(transparent)]\n SignerError(#[from] SignerError),\n #[error(\"Rpc Endpoint not implemented\")]\n RpcUnimplemented,\n #[error(\"Rpc error {0:?}\")]\n RpcError(RpcError),\n #[error(transparent)]\n InvalidTransaction(#[from] InvalidTransactionError),\n #[error(transparent)]\n FeeHistory(#[from] FeeHistoryError),\n #[error(transparent)]\n AlloyForkProvider(#[from] TransportError),\n #[error(\"EVM error {0:?}\")]\n EvmError(InstructionResult),\n #[error(\"Evm override error: {0}\")]\n EvmOverrideError(String),\n #[error(\"Invalid url {0:?}\")]\n InvalidUrl(String),\n #[error(\"Internal error: {0:?}\")]\n Internal(String),\n #[error(\"BlockOutOfRangeError: block height is {0} but requested was {1}\")]\n BlockOutOfRange(u64, u64),\n #[error(\"Resource not found\")]\n BlockNotFound,\n /// Thrown when a requested transaction is not found\n #[error(\"transaction not found\")]\n TransactionNotFound,\n #[error(\"Required data unavailable\")]\n DataUnavailable,\n #[error(\"Trie error: {0}\")]\n TrieError(String),\n #[error(\"{0}\")]\n UintConversion(&'static str),\n #[error(\"State override error: {0}\")]\n StateOverrideError(String),\n #[error(\"Timestamp error: {0}\")]\n TimestampError(String),\n #[error(transparent)]\n DatabaseError(#[from] DatabaseError),\n #[error(\n \"EIP-1559 style fee params (maxFeePerGas or maxPriorityFeePerGas) received but they are not supported by the current hardfork.\\n\\nYou can use them by running anvil with '--hardfork london' or later.\"\n )]\n EIP1559TransactionUnsupportedAtHardfork,\n #[error(\n \"Access list received but is not supported by the current hardfork.\\n\\nYou can use it by running anvil with '--hardfork berlin' or later.\"\n )]\n EIP2930TransactionUnsupportedAtHardfork,\n #[error(\n \"EIP-4844 fields received but is not supported by the current hardfork.\\n\\nYou can use it by running anvil with '--hardfork cancun' or later.\"\n )]\n EIP4844TransactionUnsupportedAtHardfork,\n #[error(\n \"EIP-7702 fields received but is not supported by the current hardfork.\\n\\nYou can use it by running anvil with '--hardfork prague' or later.\"\n )]\n EIP7702TransactionUnsupportedAtHardfork,\n #[error(\n \"op-stack deposit tx received but is not supported.\\n\\nYou can use it by running anvil with '--optimism'.\"\n )]\n DepositTransactionUnsupported,\n #[error(\"Unknown transaction type not supported\")]\n UnknownTransactionType,\n #[error(\"Excess blob gas not set.\")]\n ExcessBlobGasNotSet,\n #[error(\"{0}\")]\n Message(String),\n #[error(\"Transaction {hash} was added to the mempool but wasn't confirmed within {duration:?}\")]\n TransactionConfirmationTimeout {\n /// Hash of the transaction that timed out\n hash: B256,\n /// Duration that was waited before timing out\n duration: Duration,\n },\n #[error(\"Invalid transaction request: {0}\")]\n InvalidTransactionRequest(String),\n #[error(\"filter not found\")]\n FilterNotFound,\n}\n\nimpl From for BlockchainError {\n fn from(err: eyre::Report) -> Self {\n Self::Message(err.to_string())\n }\n}\n\nimpl From for BlockchainError {\n fn from(err: RpcError) -> Self {\n Self::RpcError(err)\n }\n}\n\nimpl From> for BlockchainError\nwhere\n T: Into,\n{\n fn from(err: EVMError) -> Self {\n match err {\n EVMError::Transaction(err) => InvalidTransactionError::from(err).into(),\n EVMError::Header(err) => match err {\n InvalidHeader::ExcessBlobGasNotSet => Self::ExcessBlobGasNotSet,\n InvalidHeader::PrevrandaoNotSet => Self::PrevrandaoNotSet,\n },\n EVMError::Database(err) => err.into(),\n EVMError::Custom(err) => Self::Message(err),\n }\n }\n}\n\nimpl From> for BlockchainError\nwhere\n T: Into,\n{\n fn from(err: EVMError) -> Self {\n match err {\n EVMError::Transaction(err) => match err {\n OpTransactionError::Base(err) => InvalidTransactionError::from(err).into(),\n OpTransactionError::DepositSystemTxPostRegolith => {\n Self::DepositTransactionUnsupported\n }\n OpTransactionError::HaltedDepositPostRegolith => {\n Self::DepositTransactionUnsupported\n }\n OpTransactionError::MissingEnvelopedTx => Self::InvalidTransaction(err.into()),\n },\n EVMError::Header(err) => match err {\n InvalidHeader::ExcessBlobGasNotSet => Self::ExcessBlobGasNotSet,\n InvalidHeader::PrevrandaoNotSet => Self::PrevrandaoNotSet,\n },\n EVMError::Database(err) => err.into(),\n EVMError::Custom(err) => Self::Message(err),\n }\n }\n}\n\nimpl From for BlockchainError {\n fn from(value: WalletError) -> Self {\n Self::Message(value.to_string())\n }\n}\n\nimpl From> for BlockchainError\nwhere\n E: Into,\n{\n fn from(value: StateOverrideError) -> Self {\n match value {\n StateOverrideError::InvalidBytecode(err) => Self::StateOverrideError(err.to_string()),\n StateOverrideError::BothStateAndStateDiff(addr) => Self::StateOverrideError(format!(\n \"state and state_diff can't be used together for account {addr}\",\n )),\n StateOverrideError::Database(err) => err.into(),\n }\n }\n}\n\n/// Errors that can occur in the transaction pool\n#[derive(Debug, thiserror::Error)]\npub enum PoolError {\n #[error(\"Transaction with cyclic dependent transactions\")]\n CyclicTransaction,\n /// Thrown if a replacement transaction's gas price is below the already imported transaction\n #[error(\"Tx: [{0:?}] insufficient gas price to replace existing transaction\")]\n ReplacementUnderpriced(TxHash),\n #[error(\"Tx: [{0:?}] already Imported\")]\n AlreadyImported(TxHash),\n}\n\n/// Errors that can occur with `eth_feeHistory`\n#[derive(Debug, thiserror::Error)]\npub enum FeeHistoryError {\n #[error(\"requested block range is out of bounds\")]\n InvalidBlockRange,\n #[error(\"could not find newest block number requested: {0}\")]\n BlockNotFound(BlockNumberOrTag),\n}\n\n#[derive(Debug)]\npub struct ErrDetail {\n pub detail: String,\n}\n\n/// An error due to invalid transaction\n#[derive(Debug, thiserror::Error)]\npub enum InvalidTransactionError {\n /// returned if the nonce of a transaction is lower than the one present in the local chain.\n #[error(\"nonce too low\")]\n NonceTooLow,\n /// returned if the nonce of a transaction is higher than the next one expected based on the\n /// local chain.\n #[error(\"Nonce too high\")]\n NonceTooHigh,\n /// Returned if the nonce of a transaction is too high\n /// Incrementing the nonce would lead to invalid state (overflow)\n #[error(\"nonce has max value\")]\n NonceMaxValue,\n /// thrown if the transaction sender doesn't have enough funds for a transfer\n #[error(\"insufficient funds for transfer\")]\n InsufficientFundsForTransfer,\n /// thrown if creation transaction provides the init code bigger than init code size limit.\n #[error(\"max initcode size exceeded\")]\n MaxInitCodeSizeExceeded,\n /// Represents the inability to cover max cost + value (account balance too low).\n #[error(\"Insufficient funds for gas * price + value\")]\n InsufficientFunds,\n /// Thrown when calculating gas usage\n #[error(\"gas uint64 overflow\")]\n GasUintOverflow,\n /// returned if the transaction is specified to use less gas than required to start the\n /// invocation.\n #[error(\"intrinsic gas too low\")]\n GasTooLow,\n /// returned if the transaction gas exceeds the limit\n #[error(\"intrinsic gas too high -- {}\",.0.detail)]\n GasTooHigh(ErrDetail),\n /// Thrown to ensure no one is able to specify a transaction with a tip higher than the total\n /// fee cap.\n #[error(\"max priority fee per gas higher than max fee per gas\")]\n TipAboveFeeCap,\n /// Thrown post London if the transaction's fee is less than the base fee of the block\n #[error(\"max fee per gas less than block base fee\")]\n FeeCapTooLow,\n /// Thrown during estimate if caller has insufficient funds to cover the tx.\n #[error(\"Out of gas: gas required exceeds allowance: {0:?}\")]\n BasicOutOfGas(u128),\n /// Thrown if executing a transaction failed during estimate/call\n #[error(\"execution reverted: {0:?}\")]\n Revert(Option),\n /// Thrown if the sender of a transaction is a contract.\n #[error(\"sender not an eoa\")]\n SenderNoEOA,\n /// Thrown when a tx was signed with a different chain_id\n #[error(\"invalid chain id for signer\")]\n InvalidChainId,\n /// Thrown when a legacy tx was signed for a different chain\n #[error(\"Incompatible EIP-155 transaction, signed for another chain\")]\n IncompatibleEIP155,\n /// Thrown when an access list is used before the berlin hard fork.\n #[error(\"Access lists are not supported before the Berlin hardfork\")]\n AccessListNotSupported,\n /// Thrown when the block's `blob_gas_price` is greater than tx-specified\n /// `max_fee_per_blob_gas` after Cancun.\n #[error(\"Block `blob_gas_price` is greater than tx-specified `max_fee_per_blob_gas`\")]\n BlobFeeCapTooLow(u128, u128),\n /// Thrown when we receive a tx with `blob_versioned_hashes` and we're not on the Cancun hard\n /// fork.\n #[error(\"Block `blob_versioned_hashes` is not supported before the Cancun hardfork\")]\n BlobVersionedHashesNotSupported,\n /// Thrown when `max_fee_per_blob_gas` is not supported for blocks before the Cancun hardfork.\n #[error(\"`max_fee_per_blob_gas` is not supported for blocks before the Cancun hardfork.\")]\n MaxFeePerBlobGasNotSupported,\n /// Thrown when there are no `blob_hashes` in the transaction, and it is an EIP-4844 tx.\n #[error(\"`blob_hashes` are required for EIP-4844 transactions\")]\n NoBlobHashes,\n #[error(\"too many blobs in one transaction, have: {0}, max: {1}\")]\n TooManyBlobs(usize, usize),\n /// Thrown when there's a blob validation error\n #[error(transparent)]\n BlobTransactionValidationError(#[from] alloy_consensus::BlobTransactionValidationError),\n /// Thrown when Blob transaction is a create transaction. `to` must be present.\n #[error(\"Blob transaction can't be a create transaction. `to` must be present.\")]\n BlobCreateTransaction,\n /// Thrown when Blob transaction contains a versioned hash with an incorrect version.\n #[error(\"Blob transaction contains a versioned hash with an incorrect version\")]\n BlobVersionNotSupported,\n /// Thrown when there are no `blob_hashes` in the transaction.\n #[error(\"There should be at least one blob in a Blob transaction.\")]\n EmptyBlobs,\n /// Thrown when an access list is used before the berlin hard fork.\n #[error(\"EIP-7702 authorization lists are not supported before the Prague hardfork\")]\n AuthorizationListNotSupported,\n #[error(\"Transaction gas limit is greater than the block gas limit, gas_limit: {0}, cap: {1}\")]\n TxGasLimitGreaterThanCap(u64, u64),\n /// Forwards error from the revm\n #[error(transparent)]\n Revm(revm::context_interface::result::InvalidTransaction),\n /// Deposit transaction error post regolith\n #[error(\"op-deposit failure post regolith\")]\n DepositTxErrorPostRegolith,\n /// Missing enveloped transaction\n #[error(\"missing enveloped transaction\")]\n MissingEnvelopedTx,\n}\n\nimpl From for InvalidTransactionError {\n fn from(err: InvalidTransaction) -> Self {\n match err {\n InvalidTransaction::InvalidChainId => Self::InvalidChainId,\n InvalidTransaction::PriorityFeeGreaterThanMaxFee => Self::TipAboveFeeCap,\n InvalidTransaction::GasPriceLessThanBasefee => Self::FeeCapTooLow,\n InvalidTransaction::CallerGasLimitMoreThanBlock => {\n Self::GasTooHigh(ErrDetail { detail: String::from(\"CallerGasLimitMoreThanBlock\") })\n }\n InvalidTransaction::CallGasCostMoreThanGasLimit { .. } => {\n Self::GasTooHigh(ErrDetail { detail: String::from(\"CallGasCostMoreThanGasLimit\") })\n }\n InvalidTransaction::GasFloorMoreThanGasLimit { .. } => {\n Self::GasTooHigh(ErrDetail { detail: String::from(\"GasFloorMoreThanGasLimit\") })\n }\n InvalidTransaction::RejectCallerWithCode => Self::SenderNoEOA,\n InvalidTransaction::LackOfFundForMaxFee { .. } => Self::InsufficientFunds,\n InvalidTransaction::OverflowPaymentInTransaction => Self::GasUintOverflow,\n InvalidTransaction::NonceOverflowInTransaction => Self::NonceMaxValue,\n InvalidTransaction::CreateInitCodeSizeLimit => Self::MaxInitCodeSizeExceeded,\n InvalidTransaction::NonceTooHigh { .. } => Self::NonceTooHigh,\n InvalidTransaction::NonceTooLow { .. } => Self::NonceTooLow,\n InvalidTransaction::AccessListNotSupported => Self::AccessListNotSupported,\n InvalidTransaction::BlobGasPriceGreaterThanMax {\n block_blob_gas_price,\n tx_max_fee_per_blob_gas,\n } => Self::BlobFeeCapTooLow(block_blob_gas_price, tx_max_fee_per_blob_gas),\n InvalidTransaction::BlobVersionedHashesNotSupported => {\n Self::BlobVersionedHashesNotSupported\n }\n InvalidTransaction::MaxFeePerBlobGasNotSupported => Self::MaxFeePerBlobGasNotSupported,\n InvalidTransaction::BlobCreateTransaction => Self::BlobCreateTransaction,\n InvalidTransaction::BlobVersionNotSupported => Self::BlobVersionNotSupported,\n InvalidTransaction::EmptyBlobs => Self::EmptyBlobs,\n InvalidTransaction::TooManyBlobs { have, max } => Self::TooManyBlobs(have, max),\n InvalidTransaction::AuthorizationListNotSupported => {\n Self::AuthorizationListNotSupported\n }\n InvalidTransaction::TxGasLimitGreaterThanCap { gas_limit, cap } => {\n Self::TxGasLimitGreaterThanCap(gas_limit, cap)\n }\n\n InvalidTransaction::AuthorizationListInvalidFields\n | InvalidTransaction::Eip1559NotSupported\n | InvalidTransaction::Eip2930NotSupported\n | InvalidTransaction::Eip4844NotSupported\n | InvalidTransaction::Eip7702NotSupported\n | InvalidTransaction::EmptyAuthorizationList\n | InvalidTransaction::Eip7873NotSupported\n | InvalidTransaction::Eip7873MissingTarget\n | InvalidTransaction::MissingChainId\n | InvalidTransaction::Str(_) => Self::Revm(err),\n }\n }\n}\n\nimpl From for InvalidTransactionError {\n fn from(value: OpTransactionError) -> Self {\n match value {\n OpTransactionError::Base(err) => err.into(),\n OpTransactionError::DepositSystemTxPostRegolith\n | OpTransactionError::HaltedDepositPostRegolith => Self::DepositTxErrorPostRegolith,\n OpTransactionError::MissingEnvelopedTx => Self::MissingEnvelopedTx,\n }\n }\n}\n/// Helper trait to easily convert results to rpc results\npub(crate) trait ToRpcResponseResult {\n fn to_rpc_result(self) -> ResponseResult;\n}\n\n/// Converts a serializable value into a `ResponseResult`\npub fn to_rpc_result(val: T) -> ResponseResult {\n match serde_json::to_value(val) {\n Ok(success) => ResponseResult::Success(success),\n Err(err) => {\n error!(%err, \"Failed serialize rpc response\");\n ResponseResult::error(RpcError::internal_error())\n }\n }\n}\n\nimpl ToRpcResponseResult for Result {\n fn to_rpc_result(self) -> ResponseResult {\n match self {\n Ok(val) => to_rpc_result(val),\n Err(err) => match err {\n BlockchainError::Pool(err) => {\n error!(%err, \"txpool error\");\n match err {\n PoolError::CyclicTransaction => {\n RpcError::transaction_rejected(\"Cyclic transaction detected\")\n }\n PoolError::ReplacementUnderpriced(_) => {\n RpcError::transaction_rejected(\"replacement transaction underpriced\")\n }\n PoolError::AlreadyImported(_) => {\n RpcError::transaction_rejected(\"transaction already imported\")\n }\n }\n }\n BlockchainError::NoSignerAvailable => {\n RpcError::invalid_params(\"No Signer available\")\n }\n BlockchainError::ChainIdNotAvailable => {\n RpcError::invalid_params(\"Chain Id not available\")\n }\n BlockchainError::TransactionConfirmationTimeout { .. } => {\n RpcError::internal_error_with(\"Transaction confirmation timeout\")\n }\n BlockchainError::InvalidTransaction(err) => match err {\n InvalidTransactionError::Revert(data) => {\n // this mimics geth revert error\n let mut msg = \"execution reverted\".to_string();\n if let Some(reason) = data\n .as_ref()\n .and_then(|data| RevertDecoder::new().maybe_decode(data, None))\n {\n msg = format!(\"{msg}: {reason}\");\n }\n RpcError {\n // geth returns this error code on reverts, See \n code: ErrorCode::ExecutionError,\n message: msg.into(),\n data: serde_json::to_value(data).ok(),\n }\n }\n InvalidTransactionError::GasTooLow => {\n // \n RpcError {\n code: ErrorCode::ServerError(-32000),\n message: err.to_string().into(),\n data: None,\n }\n }\n InvalidTransactionError::GasTooHigh(_) => {\n // \n RpcError {\n code: ErrorCode::ServerError(-32000),\n message: err.to_string().into(),\n data: None,\n }\n }\n _ => RpcError::transaction_rejected(err.to_string()),\n },\n BlockchainError::FeeHistory(err) => RpcError::invalid_params(err.to_string()),\n BlockchainError::EmptyRawTransactionData => {\n RpcError::invalid_params(\"Empty transaction data\")\n }\n BlockchainError::FailedToDecodeSignedTransaction => {\n RpcError::invalid_params(\"Failed to decode transaction\")\n }\n BlockchainError::FailedToDecodeTransaction => {\n RpcError::invalid_params(\"Failed to decode transaction\")\n }\n BlockchainError::FailedToDecodeReceipt => {\n RpcError::invalid_params(\"Failed to decode receipt\")\n }\n BlockchainError::FailedToDecodeStateDump => {\n RpcError::invalid_params(\"Failed to decode state dump\")\n }\n BlockchainError::SignerError(err) => RpcError::invalid_params(err.to_string()),\n BlockchainError::SignatureError(err) => RpcError::invalid_params(err.to_string()),\n BlockchainError::RpcUnimplemented => {\n RpcError::internal_error_with(\"Not implemented\")\n }\n BlockchainError::PrevrandaoNotSet => RpcError::internal_error_with(err.to_string()),\n BlockchainError::RpcError(err) => err,\n BlockchainError::InvalidFeeInput => RpcError::invalid_params(\n \"Invalid input: `max_priority_fee_per_gas` greater than `max_fee_per_gas`\",\n ),\n BlockchainError::AlloyForkProvider(err) => {\n error!(target: \"backend\", %err, \"fork provider error\");\n match err {\n TransportError::ErrorResp(err) => RpcError {\n code: ErrorCode::from(err.code),\n message: err.message,\n data: err.data.and_then(|data| serde_json::to_value(data).ok()),\n },\n err => RpcError::internal_error_with(format!(\"Fork Error: {err:?}\")),\n }\n }\n err @ BlockchainError::EvmError(_) => {\n RpcError::internal_error_with(err.to_string())\n }\n err @ BlockchainError::EvmOverrideError(_) => {\n RpcError::invalid_params(err.to_string())\n }\n err @ BlockchainError::InvalidUrl(_) => RpcError::invalid_params(err.to_string()),\n BlockchainError::Internal(err) => RpcError::internal_error_with(err),\n err @ BlockchainError::BlockOutOfRange(_, _) => {\n RpcError::invalid_params(err.to_string())\n }\n err @ BlockchainError::BlockNotFound => RpcError {\n // \n code: ErrorCode::ServerError(-32001),\n message: err.to_string().into(),\n data: None,\n },\n err @ BlockchainError::TransactionNotFound => RpcError {\n code: ErrorCode::ServerError(-32001),\n message: err.to_string().into(),\n data: None,\n },\n err @ BlockchainError::DataUnavailable => {\n RpcError::internal_error_with(err.to_string())\n }\n err @ BlockchainError::TrieError(_) => {\n RpcError::internal_error_with(err.to_string())\n }\n BlockchainError::UintConversion(err) => RpcError::invalid_params(err),\n err @ BlockchainError::StateOverrideError(_) => {\n RpcError::invalid_params(err.to_string())\n }\n err @ BlockchainError::TimestampError(_) => {\n RpcError::invalid_params(err.to_string())\n }\n BlockchainError::DatabaseError(err) => {\n RpcError::internal_error_with(err.to_string())\n }\n err @ BlockchainError::EIP1559TransactionUnsupportedAtHardfork => {\n RpcError::invalid_params(err.to_string())\n }\n err @ BlockchainError::EIP2930TransactionUnsupportedAtHardfork => {\n RpcError::invalid_params(err.to_string())\n }\n err @ BlockchainError::EIP4844TransactionUnsupportedAtHardfork => {\n RpcError::invalid_params(err.to_string())\n }\n err @ BlockchainError::EIP7702TransactionUnsupportedAtHardfork => {\n RpcError::invalid_params(err.to_string())\n }\n err @ BlockchainError::DepositTransactionUnsupported => {\n RpcError::invalid_params(err.to_string())\n }\n err @ BlockchainError::ExcessBlobGasNotSet => {\n RpcError::invalid_params(err.to_string())\n }\n err @ BlockchainError::Message(_) => RpcError::internal_error_with(err.to_string()),\n err @ BlockchainError::UnknownTransactionType => {\n RpcError::invalid_params(err.to_string())\n }\n err @ BlockchainError::InvalidTransactionRequest(_) => {\n RpcError::invalid_params(err.to_string())\n }\n err @ BlockchainError::RecoveryError(_) => {\n RpcError::invalid_params(err.to_string())\n }\n BlockchainError::FilterNotFound => RpcError {\n code: ErrorCode::ServerError(-32000),\n message: \"filter not found\".into(),\n data: None,\n },\n }\n .into(),\n }\n }\n}\n" }, { "path": "crates/anvil/src/eth/fees.rs", "content": "use std::{\n collections::BTreeMap,\n fmt,\n pin::Pin,\n sync::Arc,\n task::{Context, Poll},\n};\n\nuse alloy_consensus::{BlockHeader, Header, Transaction};\nuse alloy_eips::{calc_next_block_base_fee, eip1559::BaseFeeParams, eip7840::BlobParams};\nuse alloy_primitives::B256;\nuse futures::StreamExt;\nuse parking_lot::{Mutex, RwLock};\nuse revm::{context_interface::block::BlobExcessGasAndPrice, primitives::hardfork::SpecId};\n\nuse crate::eth::{\n backend::{info::StorageInfo, notifications::NewBlockNotifications},\n error::BlockchainError,\n};\nuse foundry_primitives::FoundryNetwork;\n\n/// Maximum number of entries in the fee history cache\npub const MAX_FEE_HISTORY_CACHE_SIZE: u64 = 2048u64;\n\n/// Initial base fee for EIP-1559 blocks.\npub const INITIAL_BASE_FEE: u64 = 1_000_000_000;\n\n/// Initial default gas price for the first block\npub const INITIAL_GAS_PRICE: u128 = 1_875_000_000;\n\n/// Bounds the amount the base fee can change between blocks.\npub const BASE_FEE_CHANGE_DENOMINATOR: u128 = 8;\n\n/// Minimum suggested priority fee\npub const MIN_SUGGESTED_PRIORITY_FEE: u128 = 1e9 as u128;\n\n/// Stores the fee related information\n#[derive(Clone, Debug)]\npub struct FeeManager {\n /// Hardfork identifier\n spec_id: SpecId,\n /// The blob params that determine blob fees\n blob_params: Arc>,\n /// Tracks the base fee for the next block post London\n ///\n /// This value will be updated after a new block was mined\n base_fee: Arc>,\n /// Whether the minimum suggested priority fee is enforced\n is_min_priority_fee_enforced: bool,\n /// Tracks the excess blob gas, and the base fee, for the next block post Cancun\n ///\n /// This value will be updated after a new block was mined\n blob_excess_gas_and_price: Arc>,\n /// The base price to use Pre London\n ///\n /// This will be constant value unless changed manually\n gas_price: Arc>,\n elasticity: Arc>,\n /// Network-specific base fee params for EIP-1559 calculations\n base_fee_params: BaseFeeParams,\n}\n\nimpl FeeManager {\n pub fn new(\n spec_id: SpecId,\n base_fee: u64,\n is_min_priority_fee_enforced: bool,\n gas_price: u128,\n blob_excess_gas_and_price: BlobExcessGasAndPrice,\n blob_params: BlobParams,\n base_fee_params: BaseFeeParams,\n ) -> Self {\n let elasticity = 1f64 / base_fee_params.elasticity_multiplier as f64;\n Self {\n spec_id,\n blob_params: Arc::new(RwLock::new(blob_params)),\n base_fee: Arc::new(RwLock::new(base_fee)),\n is_min_priority_fee_enforced,\n gas_price: Arc::new(RwLock::new(gas_price)),\n blob_excess_gas_and_price: Arc::new(RwLock::new(blob_excess_gas_and_price)),\n elasticity: Arc::new(RwLock::new(elasticity)),\n base_fee_params,\n }\n }\n\n /// Returns the base fee params used for EIP-1559 calculations\n pub fn base_fee_params(&self) -> BaseFeeParams {\n self.base_fee_params\n }\n\n pub fn elasticity(&self) -> f64 {\n *self.elasticity.read()\n }\n\n /// Returns true for post London\n pub fn is_eip1559(&self) -> bool {\n (self.spec_id as u8) >= (SpecId::LONDON as u8)\n }\n\n pub fn is_eip4844(&self) -> bool {\n (self.spec_id as u8) >= (SpecId::CANCUN as u8)\n }\n\n /// Calculates the current blob gas price\n pub fn blob_gas_price(&self) -> u128 {\n if self.is_eip4844() { self.base_fee_per_blob_gas() } else { 0 }\n }\n\n pub fn base_fee(&self) -> u64 {\n if self.is_eip1559() { *self.base_fee.read() } else { 0 }\n }\n\n pub fn is_min_priority_fee_enforced(&self) -> bool {\n self.is_min_priority_fee_enforced\n }\n\n /// Raw base gas price\n pub fn raw_gas_price(&self) -> u128 {\n *self.gas_price.read()\n }\n\n pub fn excess_blob_gas_and_price(&self) -> Option {\n if self.is_eip4844() { Some(*self.blob_excess_gas_and_price.read()) } else { None }\n }\n\n pub fn base_fee_per_blob_gas(&self) -> u128 {\n if self.is_eip4844() { self.blob_excess_gas_and_price.read().blob_gasprice } else { 0 }\n }\n\n /// Returns the current gas price\n pub fn set_gas_price(&self, price: u128) {\n let mut gas = self.gas_price.write();\n *gas = price;\n }\n\n /// Returns the current base fee\n pub fn set_base_fee(&self, fee: u64) {\n trace!(target: \"backend::fees\", \"updated base fee {:?}\", fee);\n let mut base = self.base_fee.write();\n *base = fee;\n }\n\n /// Sets the current blob excess gas and price\n pub fn set_blob_excess_gas_and_price(&self, blob_excess_gas_and_price: BlobExcessGasAndPrice) {\n trace!(target: \"backend::fees\", \"updated blob base fee {:?}\", blob_excess_gas_and_price);\n let mut base = self.blob_excess_gas_and_price.write();\n *base = blob_excess_gas_and_price;\n }\n\n /// Calculates the base fee for the next block\n pub fn get_next_block_base_fee_per_gas(\n &self,\n gas_used: u64,\n gas_limit: u64,\n last_fee_per_gas: u64,\n ) -> u64 {\n // It's naturally impossible for base fee to be 0;\n // It means it was set by the user deliberately and therefore we treat it as a constant.\n // Therefore, we skip the base fee calculation altogether and we return 0.\n if self.base_fee() == 0 {\n return 0;\n }\n calc_next_block_base_fee(gas_used, gas_limit, last_fee_per_gas, self.base_fee_params)\n }\n\n /// Calculates the next block blob base fee.\n pub fn get_next_block_blob_base_fee_per_gas(&self) -> u128 {\n self.blob_params().calc_blob_fee(self.blob_excess_gas_and_price.read().excess_blob_gas)\n }\n\n /// Calculates the next block blob excess gas, using the provided parent blob excess gas and\n /// parent blob gas used\n pub fn get_next_block_blob_excess_gas(&self, blob_excess_gas: u64, blob_gas_used: u64) -> u64 {\n self.blob_params().next_block_excess_blob_gas_osaka(\n blob_excess_gas,\n blob_gas_used,\n self.base_fee(),\n )\n }\n\n /// Configures the blob params\n pub fn set_blob_params(&self, blob_params: BlobParams) {\n *self.blob_params.write() = blob_params;\n }\n\n /// Returns the active [`BlobParams`]\n pub fn blob_params(&self) -> BlobParams {\n *self.blob_params.read()\n }\n}\n\n/// An async service that takes care of the `FeeHistory` cache\npub struct FeeHistoryService {\n /// blob parameters for the current spec\n blob_params: BlobParams,\n /// incoming notifications about new blocks\n new_blocks: NewBlockNotifications,\n /// contains all fee history related entries\n cache: FeeHistoryCache,\n /// number of items to consider\n fee_history_limit: u64,\n /// a type that can fetch ethereum-storage data\n storage_info: StorageInfo,\n}\n\nimpl FeeHistoryService {\n pub fn new(\n blob_params: BlobParams,\n new_blocks: NewBlockNotifications,\n cache: FeeHistoryCache,\n storage_info: StorageInfo,\n ) -> Self {\n Self {\n blob_params,\n new_blocks,\n cache,\n fee_history_limit: MAX_FEE_HISTORY_CACHE_SIZE,\n storage_info,\n }\n }\n\n /// Returns the configured history limit\n pub fn fee_history_limit(&self) -> u64 {\n self.fee_history_limit\n }\n\n /// Inserts a new cache entry for the given block\n pub(crate) fn insert_cache_entry_for_block(&self, hash: B256, header: &Header) {\n let (result, block_number) = self.create_cache_entry(hash, header);\n self.insert_cache_entry(result, block_number);\n }\n\n /// Create a new history entry for the block\n fn create_cache_entry(\n &self,\n hash: B256,\n header: &Header,\n ) -> (FeeHistoryCacheItem, Option) {\n // percentile list from 0.0 to 100.0 with a 0.5 resolution.\n // this will create 200 percentile points\n let reward_percentiles: Vec = {\n let mut percentile: f64 = 0.0;\n (0..=200)\n .map(|_| {\n let val = percentile;\n percentile += 0.5;\n val\n })\n .collect()\n };\n\n let mut block_number: Option = None;\n let base_fee = header.base_fee_per_gas.unwrap_or_default();\n let excess_blob_gas = header.excess_blob_gas.map(|g| g as u128);\n let blob_gas_used = header.blob_gas_used.map(|g| g as u128);\n let base_fee_per_blob_gas = header.blob_fee(self.blob_params);\n\n let mut item = FeeHistoryCacheItem {\n base_fee: base_fee as u128,\n gas_used_ratio: 0f64,\n blob_gas_used_ratio: 0f64,\n rewards: Vec::new(),\n excess_blob_gas,\n base_fee_per_blob_gas,\n blob_gas_used,\n };\n\n let current_block = self.storage_info.block(hash);\n let current_receipts = self.storage_info.receipts(hash);\n\n if let (Some(block), Some(receipts)) = (current_block, current_receipts) {\n block_number = Some(block.header.number());\n\n let gas_used = block.header.gas_used() as f64;\n let blob_gas_used = block.header.blob_gas_used().map(|g| g as f64);\n item.gas_used_ratio = gas_used / block.header.gas_limit() as f64;\n item.blob_gas_used_ratio = blob_gas_used\n .map(|g| {\n let max = self.blob_params.max_blob_gas_per_block() as f64;\n if max == 0.0 { 0.0 } else { g / max }\n })\n .unwrap_or(0.0);\n\n // extract useful tx info (gas_used, effective_reward)\n let mut transactions: Vec<(_, _)> = receipts\n .iter()\n .enumerate()\n .map(|(i, receipt)| {\n let cumulative = receipt.cumulative_gas_used();\n let prev_cumulative =\n if i > 0 { receipts[i - 1].cumulative_gas_used() } else { 0 };\n let gas_used = cumulative - prev_cumulative;\n let effective_reward = block\n .body\n .transactions\n .get(i)\n .map(|tx| tx.as_ref().effective_tip_per_gas(base_fee).unwrap_or(0))\n .unwrap_or(0);\n\n (gas_used, effective_reward)\n })\n .collect();\n\n // sort by effective reward asc\n transactions.sort_by_key(|(_, reward)| *reward);\n\n // calculate percentile rewards\n item.rewards = reward_percentiles\n .into_iter()\n .filter_map(|p| {\n let target_gas = (p * gas_used / 100f64) as u64;\n let mut sum_gas = 0;\n for (gas_used, effective_reward) in transactions.iter().copied() {\n sum_gas += gas_used;\n if target_gas <= sum_gas {\n return Some(effective_reward);\n }\n }\n None\n })\n .collect();\n } else {\n item.rewards = vec![0; reward_percentiles.len()];\n }\n (item, block_number)\n }\n\n fn insert_cache_entry(&self, item: FeeHistoryCacheItem, block_number: Option) {\n if let Some(block_number) = block_number {\n trace!(target: \"fees\", \"insert new history item={:?} for {}\", item, block_number);\n let mut cache = self.cache.lock();\n cache.insert(block_number, item);\n\n // adhere to cache limit\n let pop_next = block_number.saturating_sub(self.fee_history_limit);\n\n let num_remove = (cache.len() as u64).saturating_sub(self.fee_history_limit);\n for num in 0..num_remove {\n let key = pop_next - num;\n cache.remove(&key);\n }\n }\n }\n}\n\n// An endless future that listens for new blocks and updates the cache\nimpl Future for FeeHistoryService {\n type Output = ();\n\n fn poll(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll {\n let pin = self.get_mut();\n\n while let Poll::Ready(Some(notification)) = pin.new_blocks.poll_next_unpin(cx) {\n // add the imported block.\n pin.insert_cache_entry_for_block(notification.hash, notification.header.as_ref());\n }\n\n Poll::Pending\n }\n}\n\npub type FeeHistoryCache = Arc>>;\n\n/// A single item in the whole fee history cache\n#[derive(Clone, Debug)]\npub struct FeeHistoryCacheItem {\n pub base_fee: u128,\n pub gas_used_ratio: f64,\n pub base_fee_per_blob_gas: Option,\n pub blob_gas_used_ratio: f64,\n pub excess_blob_gas: Option,\n pub blob_gas_used: Option,\n pub rewards: Vec,\n}\n\n#[derive(Clone, Default)]\npub struct FeeDetails {\n pub gas_price: Option,\n pub max_fee_per_gas: Option,\n pub max_priority_fee_per_gas: Option,\n pub max_fee_per_blob_gas: Option,\n}\n\nimpl FeeDetails {\n /// All values zero\n pub fn zero() -> Self {\n Self {\n gas_price: Some(0),\n max_fee_per_gas: Some(0),\n max_priority_fee_per_gas: Some(0),\n max_fee_per_blob_gas: None,\n }\n }\n\n /// If neither `gas_price` nor `max_fee_per_gas` is `Some`, this will set both to `0`\n pub fn or_zero_fees(self) -> Self {\n let Self { gas_price, max_fee_per_gas, max_priority_fee_per_gas, max_fee_per_blob_gas } =\n self;\n\n let no_fees = gas_price.is_none() && max_fee_per_gas.is_none();\n let gas_price = if no_fees { Some(0) } else { gas_price };\n let max_fee_per_gas = if no_fees { Some(0) } else { max_fee_per_gas };\n let max_fee_per_blob_gas = if no_fees { None } else { max_fee_per_blob_gas };\n\n Self { gas_price, max_fee_per_gas, max_priority_fee_per_gas, max_fee_per_blob_gas }\n }\n\n /// Turns this type into a tuple\n pub fn split(self) -> (Option, Option, Option, Option) {\n let Self { gas_price, max_fee_per_gas, max_priority_fee_per_gas, max_fee_per_blob_gas } =\n self;\n (gas_price, max_fee_per_gas, max_priority_fee_per_gas, max_fee_per_blob_gas)\n }\n\n /// Creates a new instance from the request's gas related values\n pub fn new(\n request_gas_price: Option,\n request_max_fee: Option,\n request_priority: Option,\n max_fee_per_blob_gas: Option,\n ) -> Result {\n match (request_gas_price, request_max_fee, request_priority, max_fee_per_blob_gas) {\n (gas_price, None, None, None) => {\n // Legacy request, all default to gas price.\n Ok(Self {\n gas_price,\n max_fee_per_gas: gas_price,\n max_priority_fee_per_gas: gas_price,\n max_fee_per_blob_gas: None,\n })\n }\n (_, max_fee, max_priority, None) => {\n // eip-1559\n // Ensure `max_priority_fee_per_gas` is less or equal to `max_fee_per_gas`.\n if let Some(max_priority) = max_priority {\n let max_fee = max_fee.unwrap_or_default();\n if max_priority > max_fee {\n return Err(BlockchainError::InvalidFeeInput);\n }\n }\n Ok(Self {\n gas_price: max_fee,\n max_fee_per_gas: max_fee,\n max_priority_fee_per_gas: max_priority,\n max_fee_per_blob_gas: None,\n })\n }\n (_, max_fee, max_priority, max_fee_per_blob_gas) => {\n // eip-1559\n // Ensure `max_priority_fee_per_gas` is less or equal to `max_fee_per_gas`.\n if let Some(max_priority) = max_priority {\n let max_fee = max_fee.unwrap_or_default();\n if max_priority > max_fee {\n return Err(BlockchainError::InvalidFeeInput);\n }\n }\n Ok(Self {\n gas_price: max_fee,\n max_fee_per_gas: max_fee,\n max_priority_fee_per_gas: max_priority,\n max_fee_per_blob_gas,\n })\n }\n }\n }\n}\n\nimpl fmt::Debug for FeeDetails {\n fn fmt(&self, fmt: &mut fmt::Formatter<'_>) -> fmt::Result {\n write!(fmt, \"Fees {{ \")?;\n write!(fmt, \"gas_price: {:?}, \", self.gas_price)?;\n write!(fmt, \"max_fee_per_gas: {:?}, \", self.max_fee_per_gas)?;\n write!(fmt, \"max_priority_fee_per_gas: {:?}, \", self.max_priority_fee_per_gas)?;\n write!(fmt, \"}}\")?;\n Ok(())\n }\n}\n" }, { "path": "crates/anvil/src/eth/macros.rs", "content": "/// A `info!` helper macro that emits to the target, the node logger listens for\nmacro_rules! node_info {\n ($($arg:tt)*) => {\n tracing::info!(target: $crate::logging::NODE_USER_LOG_TARGET, $($arg)*);\n };\n}\n\npub(crate) use node_info;\n" }, { "path": "crates/anvil/src/eth/miner.rs", "content": "//! Mines transactions\n\nuse crate::eth::pool::{Pool, transactions::PoolTransaction};\nuse alloy_primitives::TxHash;\nuse futures::{\n channel::mpsc::Receiver,\n stream::{Fuse, StreamExt},\n task::AtomicWaker,\n};\nuse parking_lot::{RawRwLock, RwLock, lock_api::RwLockWriteGuard};\nuse std::{\n fmt,\n sync::Arc,\n task::{Context, Poll, ready},\n time::Duration,\n};\nuse tokio::time::{Interval, MissedTickBehavior};\n\npub struct Miner {\n /// The mode this miner currently operates in\n mode: Arc>,\n /// used for task wake up when the mining mode was forcefully changed\n ///\n /// This will register the task so we can manually wake it up if the mining mode was changed\n inner: Arc,\n /// Transactions included into the pool before any others are.\n /// Done once on startup.\n force_transactions: Option>>>,\n}\n\nimpl Clone for Miner {\n fn clone(&self) -> Self {\n Self {\n mode: self.mode.clone(),\n inner: self.inner.clone(),\n force_transactions: self.force_transactions.clone(),\n }\n }\n}\n\nimpl fmt::Debug for Miner {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n f.debug_struct(\"Miner\")\n .field(\"mode\", &self.mode)\n .field(\"force_transactions\", &self.force_transactions.as_ref().map(|txs| txs.len()))\n .finish_non_exhaustive()\n }\n}\n\nimpl Miner {\n /// Returns a new miner with that operates in the given `mode`.\n pub fn new(mode: MiningMode) -> Self {\n Self {\n mode: Arc::new(RwLock::new(mode)),\n inner: Default::default(),\n force_transactions: None,\n }\n }\n\n /// Provide transactions that will cause a block to be mined with transactions\n /// as soon as the miner is polled.\n /// Providing an empty list of transactions will cause the miner to mine an empty block assuming\n /// there are not other transactions in the pool.\n pub fn with_forced_transactions(\n mut self,\n force_transactions: Option>>,\n ) -> Self {\n self.force_transactions =\n force_transactions.map(|tx| tx.into_iter().map(Arc::new).collect());\n self\n }\n\n /// Returns the write lock of the mining mode\n pub fn mode_write(&self) -> RwLockWriteGuard<'_, RawRwLock, MiningMode> {\n self.mode.write()\n }\n\n /// Returns `true` if auto mining is enabled\n pub fn is_auto_mine(&self) -> bool {\n let mode = self.mode.read();\n matches!(*mode, MiningMode::Auto(_))\n }\n\n pub fn get_interval(&self) -> Option {\n let mode = self.mode.read();\n if let MiningMode::FixedBlockTime(ref mm) = *mode {\n return Some(mm.interval.period().as_secs());\n }\n None\n }\n\n /// Sets the mining mode to operate in\n pub fn set_mining_mode(&self, mode: MiningMode) {\n let new_mode = format!(\"{mode:?}\");\n let mode = std::mem::replace(&mut *self.mode_write(), mode);\n trace!(target: \"miner\", \"updated mining mode from {:?} to {}\", mode, new_mode);\n self.inner.wake();\n }\n\n /// polls the [Pool] and returns those transactions that should be put in a block according to\n /// the current mode.\n ///\n /// May return an empty list, if no transactions are ready.\n pub fn poll(\n &mut self,\n pool: &Arc>,\n cx: &mut Context<'_>,\n ) -> Poll>>> {\n self.inner.register(cx);\n let next = ready!(self.mode.write().poll(pool, cx));\n if let Some(mut transactions) = self.force_transactions.take() {\n transactions.extend(next);\n Poll::Ready(transactions)\n } else {\n Poll::Ready(next)\n }\n }\n}\n\n/// A Mining mode that does nothing\n#[derive(Debug)]\npub struct MinerInner {\n waker: AtomicWaker,\n}\n\nimpl MinerInner {\n /// Call the waker again\n fn wake(&self) {\n self.waker.wake();\n }\n\n fn register(&self, cx: &Context<'_>) {\n self.waker.register(cx.waker());\n }\n}\n\nimpl Default for MinerInner {\n fn default() -> Self {\n Self { waker: AtomicWaker::new() }\n }\n}\n\n/// Mode of operations for the `Miner`\n#[derive(Debug)]\npub enum MiningMode {\n /// A miner that does nothing\n None,\n /// A miner that listens for new transactions that are ready.\n ///\n /// Either one transaction will be mined per block, or any number of transactions will be\n /// allowed\n Auto(ReadyTransactionMiner),\n /// A miner that constructs a new block every `interval` tick\n FixedBlockTime(FixedBlockTimeMiner),\n\n /// A miner that uses both Auto and FixedBlockTime\n Mixed(ReadyTransactionMiner, FixedBlockTimeMiner),\n}\n\nimpl MiningMode {\n pub fn instant(max_transactions: usize, listener: Receiver) -> Self {\n Self::Auto(ReadyTransactionMiner {\n max_transactions,\n has_pending_txs: None,\n rx: listener.fuse(),\n })\n }\n\n pub fn interval(duration: Duration) -> Self {\n Self::FixedBlockTime(FixedBlockTimeMiner::new(duration))\n }\n\n pub fn mixed(max_transactions: usize, listener: Receiver, duration: Duration) -> Self {\n Self::Mixed(\n ReadyTransactionMiner { max_transactions, has_pending_txs: None, rx: listener.fuse() },\n FixedBlockTimeMiner::new(duration),\n )\n }\n\n /// polls the [Pool] and returns those transactions that should be put in a block, if any.\n pub fn poll(\n &mut self,\n pool: &Arc>,\n cx: &mut Context<'_>,\n ) -> Poll>>> {\n match self {\n Self::None => Poll::Pending,\n Self::Auto(miner) => miner.poll(pool, cx),\n Self::FixedBlockTime(miner) => miner.poll(pool, cx),\n Self::Mixed(auto, fixed) => {\n let auto_txs = auto.poll(pool, cx);\n let fixed_txs = fixed.poll(pool, cx);\n\n match (auto_txs, fixed_txs) {\n // Both auto and fixed transactions are ready, combine them\n (Poll::Ready(mut auto_txs), Poll::Ready(fixed_txs)) => {\n for tx in fixed_txs {\n // filter unique transactions\n if auto_txs.iter().any(|auto_tx| auto_tx.hash() == tx.hash()) {\n continue;\n }\n auto_txs.push(tx);\n }\n Poll::Ready(auto_txs)\n }\n // Only auto transactions are ready, return them\n (Poll::Ready(auto_txs), Poll::Pending) => Poll::Ready(auto_txs),\n // Only fixed transactions are ready or both are pending,\n // return fixed transactions or pending status\n (Poll::Pending, fixed_txs) => fixed_txs,\n }\n }\n }\n }\n}\n\n/// A miner that's supposed to create a new block every `interval`, mining all transactions that are\n/// ready at that time.\n///\n/// The default blocktime is set to 6 seconds\n#[derive(Debug)]\npub struct FixedBlockTimeMiner {\n /// The interval this fixed block time miner operates with\n interval: Interval,\n}\n\nimpl FixedBlockTimeMiner {\n /// Creates a new instance with an interval of `duration`\n pub fn new(duration: Duration) -> Self {\n let start = tokio::time::Instant::now() + duration;\n let mut interval = tokio::time::interval_at(start, duration);\n // we use delay here, to ensure ticks are not shortened and to tick at multiples of interval\n // from when tick was called rather than from start\n interval.set_missed_tick_behavior(MissedTickBehavior::Delay);\n Self { interval }\n }\n\n fn poll(\n &mut self,\n pool: &Arc>,\n cx: &mut Context<'_>,\n ) -> Poll>>> {\n if self.interval.poll_tick(cx).is_ready() {\n // drain the pool\n return Poll::Ready(pool.ready_transactions().collect());\n }\n Poll::Pending\n }\n}\n\nimpl Default for FixedBlockTimeMiner {\n fn default() -> Self {\n Self::new(Duration::from_secs(6))\n }\n}\n\n/// A miner that Listens for new ready transactions\npub struct ReadyTransactionMiner {\n /// how many transactions to mine per block\n max_transactions: usize,\n /// stores whether there are pending transactions (if known)\n has_pending_txs: Option,\n /// Receives hashes of transactions that are ready\n rx: Fuse>,\n}\n\nimpl ReadyTransactionMiner {\n fn poll(\n &mut self,\n pool: &Arc>,\n cx: &mut Context<'_>,\n ) -> Poll>>> {\n // always drain the notification stream so that we're woken up as soon as there's a new tx\n while let Poll::Ready(Some(_hash)) = self.rx.poll_next_unpin(cx) {\n self.has_pending_txs = Some(true);\n }\n\n if self.has_pending_txs == Some(false) {\n return Poll::Pending;\n }\n\n let transactions =\n pool.ready_transactions().take(self.max_transactions).collect::>();\n\n // there are pending transactions if we didn't drain the pool\n self.has_pending_txs = Some(transactions.len() >= self.max_transactions);\n\n if transactions.is_empty() {\n return Poll::Pending;\n }\n\n Poll::Ready(transactions)\n }\n}\n\nimpl fmt::Debug for ReadyTransactionMiner {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n f.debug_struct(\"ReadyTransactionMiner\")\n .field(\"max_transactions\", &self.max_transactions)\n .finish_non_exhaustive()\n }\n}\n" }, { "path": "crates/anvil/src/eth/mod.rs", "content": "pub mod api;\npub mod otterscan;\npub mod sign;\npub use api::EthApi;\n\npub mod backend;\n\npub mod error;\n\npub mod fees;\npub(crate) mod macros;\npub mod miner;\npub mod pool;\npub mod util;\n" }, { "path": "crates/anvil/src/eth/otterscan/api.rs", "content": "use crate::eth::{\n EthApi,\n error::{BlockchainError, Result},\n macros::node_info,\n};\nuse alloy_consensus::{BlockHeader, Transaction as TransactionTrait};\nuse alloy_network::{\n AnyHeader, AnyRpcBlock, AnyRpcHeader, AnyRpcTransaction, AnyTxEnvelope, BlockResponse,\n ReceiptResponse, TransactionResponse,\n};\nuse alloy_primitives::{Address, B256, Bytes, U256};\nuse alloy_rpc_types::{\n Block, BlockId, BlockNumberOrTag as BlockNumber, BlockTransactions,\n trace::{\n otterscan::{\n BlockDetails, ContractCreator, InternalOperation, OtsBlock, OtsBlockTransactions,\n OtsReceipt, OtsSlimBlock, OtsTransactionReceipt, TraceEntry, TransactionsWithReceipts,\n },\n parity::{Action, CreateAction, CreateOutput, TraceOutput},\n },\n};\nuse foundry_primitives::FoundryNetwork;\nuse futures::future::join_all;\nuse itertools::Itertools;\n\nimpl EthApi {\n /// Otterscan currently requires this endpoint, even though it's not part of the `ots_*`.\n /// Ref: \n ///\n /// As a faster alternative to `eth_getBlockByNumber` (by excluding uncle block\n /// information), which is not relevant in the context of an anvil node\n pub async fn erigon_get_header_by_number(\n &self,\n number: BlockNumber,\n ) -> Result> {\n node_info!(\"erigon_getHeaderByNumber\");\n\n self.backend.block_by_number(number).await\n }\n\n /// As per the latest Otterscan source code, at least version 8 is needed.\n /// Ref: \n pub async fn ots_get_api_level(&self) -> Result {\n node_info!(\"ots_getApiLevel\");\n\n // as required by current otterscan's source code\n Ok(8)\n }\n\n /// Trace internal ETH transfers, contracts creation (CREATE/CREATE2) and self-destructs for a\n /// certain transaction.\n pub async fn ots_get_internal_operations(&self, hash: B256) -> Result> {\n node_info!(\"ots_getInternalOperations\");\n\n self.backend\n .mined_transaction(hash)\n .map(|tx| tx.ots_internal_operations())\n .ok_or_else(|| BlockchainError::DataUnavailable)\n }\n\n /// Check if an ETH address contains code at a certain block number.\n pub async fn ots_has_code(&self, address: Address, block_number: BlockNumber) -> Result {\n node_info!(\"ots_hasCode\");\n let block_id = Some(BlockId::Number(block_number));\n Ok(!self.get_code(address, block_id).await?.is_empty())\n }\n\n /// Trace a transaction and generate a trace call tree.\n /// Converts the list of traces for a transaction into the expected Otterscan format.\n ///\n /// Follows format specified in the [`ots_traceTransaction`](https://docs.otterscan.io/api-docs/ots-api#ots_tracetransaction) spec.\n pub async fn ots_trace_transaction(&self, hash: B256) -> Result> {\n node_info!(\"ots_traceTransaction\");\n let traces = self\n .backend\n .trace_transaction(hash)\n .await?\n .into_iter()\n .filter_map(|trace| TraceEntry::from_transaction_trace(&trace.trace))\n .collect();\n Ok(traces)\n }\n\n /// Given a transaction hash, returns its raw revert reason.\n pub async fn ots_get_transaction_error(&self, hash: B256) -> Result {\n node_info!(\"ots_getTransactionError\");\n\n if let Some(receipt) = self.backend.mined_transaction_receipt(hash)\n && !receipt.inner.as_ref().status()\n {\n return Ok(receipt.out.unwrap_or_default());\n }\n\n Ok(Bytes::default())\n }\n\n /// For simplicity purposes, we return the entire block instead of emptying the values that\n /// Otterscan doesn't want. This is the original purpose of the endpoint (to save bandwidth),\n /// but it doesn't seem necessary in the context of an anvil node\n pub async fn ots_get_block_details(\n &self,\n number: BlockNumber,\n ) -> Result> {\n node_info!(\"ots_getBlockDetails\");\n\n if let Some(block) = self.backend.block_by_number(number).await? {\n let ots_block = self.build_ots_block_details(block).await?;\n Ok(ots_block)\n } else {\n Err(BlockchainError::BlockNotFound)\n }\n }\n\n /// For simplicity purposes, we return the entire block instead of emptying the values that\n /// Otterscan doesn't want. This is the original purpose of the endpoint (to save bandwidth),\n /// but it doesn't seem necessary in the context of an anvil node\n pub async fn ots_get_block_details_by_hash(\n &self,\n hash: B256,\n ) -> Result> {\n node_info!(\"ots_getBlockDetailsByHash\");\n\n if let Some(block) = self.backend.block_by_hash(hash).await? {\n let ots_block = self.build_ots_block_details(block).await?;\n Ok(ots_block)\n } else {\n Err(BlockchainError::BlockNotFound)\n }\n }\n\n /// Gets paginated transaction data for a certain block. Return data is similar to\n /// eth_getBlockBy* + eth_getTransactionReceipt.\n pub async fn ots_get_block_transactions(\n &self,\n number: u64,\n page: usize,\n page_size: usize,\n ) -> Result> {\n node_info!(\"ots_getBlockTransactions\");\n\n match self.backend.block_by_number_full(number.into()).await? {\n Some(block) => self.build_ots_block_tx(block, page, page_size).await,\n None => Err(BlockchainError::BlockNotFound),\n }\n }\n\n /// Address history navigation. searches backwards from certain point in time.\n pub async fn ots_search_transactions_before(\n &self,\n address: Address,\n block_number: u64,\n page_size: usize,\n ) -> Result>> {\n node_info!(\"ots_searchTransactionsBefore\");\n\n let best = self.backend.best_number();\n // we go from given block (defaulting to best) down to first block\n // considering only post-fork\n let from = if block_number == 0 { best } else { block_number - 1 };\n let to = self.get_fork().map(|f| f.block_number() + 1).unwrap_or(1);\n\n let first_page = from >= best;\n let mut last_page = false;\n\n let mut res: Vec<_> = vec![];\n\n for n in (to..=from).rev() {\n if let Some(traces) = self.backend.mined_parity_trace_block(n) {\n let hashes = traces\n .into_iter()\n .rev()\n .filter(|trace| trace.contains_address(address))\n .filter_map(|trace| trace.transaction_hash)\n .unique();\n\n if res.len() >= page_size {\n break;\n }\n\n res.extend(hashes);\n }\n\n if n == to {\n last_page = true;\n }\n }\n\n self.build_ots_search_transactions(res, first_page, last_page).await\n }\n\n /// Address history navigation. searches forward from certain point in time.\n pub async fn ots_search_transactions_after(\n &self,\n address: Address,\n block_number: u64,\n page_size: usize,\n ) -> Result>> {\n node_info!(\"ots_searchTransactionsAfter\");\n\n let best = self.backend.best_number();\n // we go from the first post-fork block, up to the tip\n let first_block = self.get_fork().map(|f| f.block_number() + 1).unwrap_or(1);\n let from = if block_number == 0 { first_block } else { block_number + 1 };\n let to = best;\n\n let mut first_page = from >= best;\n let mut last_page = false;\n\n let mut res: Vec<_> = vec![];\n\n for n in from..=to {\n if n == first_block {\n last_page = true;\n }\n\n if let Some(traces) = self.backend.mined_parity_trace_block(n) {\n let hashes = traces\n .into_iter()\n .rev()\n .filter(|trace| trace.contains_address(address))\n .filter_map(|trace| trace.transaction_hash)\n .unique();\n\n if res.len() >= page_size {\n break;\n }\n\n res.extend(hashes);\n }\n\n if n == to {\n first_page = true;\n }\n }\n\n // Results are always sent in reverse chronological order, according to the Otterscan spec\n res.reverse();\n self.build_ots_search_transactions(res, first_page, last_page).await\n }\n\n /// Given a sender address and a nonce, returns the tx hash or null if not found. It returns\n /// only the tx hash on success, you can use the standard eth_getTransactionByHash after that to\n /// get the full transaction data.\n pub async fn ots_get_transaction_by_sender_and_nonce(\n &self,\n address: Address,\n nonce: U256,\n ) -> Result> {\n node_info!(\"ots_getTransactionBySenderAndNonce\");\n\n let from = self.get_fork().map(|f| f.block_number() + 1).unwrap_or_default();\n let to = self.backend.best_number();\n\n for n in (from..=to).rev() {\n if let Some(txs) = self.backend.mined_transactions_by_block_number(n.into()).await {\n for tx in txs {\n if U256::from(tx.nonce()) == nonce && tx.from() == address {\n return Ok(Some(tx.tx_hash()));\n }\n }\n }\n }\n\n Ok(None)\n }\n\n /// Given an ETH contract address, returns the tx hash and the direct address who created the\n /// contract.\n pub async fn ots_get_contract_creator(&self, addr: Address) -> Result> {\n node_info!(\"ots_getContractCreator\");\n\n let from = self.get_fork().map(|f| f.block_number()).unwrap_or_default();\n let to = self.backend.best_number();\n\n // loop in reverse, since we want the latest deploy to the address\n for n in (from..=to).rev() {\n if let Some(traces) = self.backend.mined_parity_trace_block(n) {\n for trace in traces.into_iter().rev() {\n match (trace.trace.action, trace.trace.result) {\n (\n Action::Create(CreateAction { from, .. }),\n Some(TraceOutput::Create(CreateOutput { address, .. })),\n ) if address == addr => {\n return Ok(Some(ContractCreator {\n hash: trace.transaction_hash.unwrap(),\n creator: from,\n }));\n }\n _ => {}\n }\n }\n }\n }\n\n Ok(None)\n }\n /// The response for ots_getBlockDetails includes an `issuance` object that requires computing\n /// the total gas spent in a given block.\n ///\n /// The only way to do this with the existing API is to explicitly fetch all receipts, to get\n /// their `gas_used`. This would be extremely inefficient in a real blockchain RPC, but we can\n /// get away with that in this context.\n ///\n /// The [original spec](https://docs.otterscan.io/api-docs/ots-api#ots_getblockdetails)\n /// also mentions we can hardcode `transactions` and `logsBloom` to an empty array to save\n /// bandwidth, because fields weren't intended to be used in the Otterscan UI at this point.\n ///\n /// This has two problems though:\n /// - It makes the endpoint too specific to Otterscan's implementation\n /// - It breaks the abstraction built in `OtsBlock` which computes `transaction_count`\n /// based on the existing list.\n ///\n /// Therefore we keep it simple by keeping the data in the response\n pub async fn build_ots_block_details(\n &self,\n block: AnyRpcBlock,\n ) -> Result>> {\n if block.transactions.is_uncle() {\n return Err(BlockchainError::DataUnavailable);\n }\n let receipts_futs = block\n .transactions\n .hashes()\n .map(|hash| async move { self.transaction_receipt(hash).await });\n\n // fetch all receipts\n let receipts = join_all(receipts_futs)\n .await\n .into_iter()\n .map(|r| match r {\n Ok(Some(r)) => Ok(r),\n _ => Err(BlockchainError::DataUnavailable),\n })\n .collect::>>()?;\n\n let total_fees = receipts.iter().fold(0, |acc, receipt| {\n acc + (receipt.gas_used() as u128) * receipt.effective_gas_price()\n });\n\n let Block { header, uncles, transactions, withdrawals } = block.into_inner();\n\n let block =\n OtsSlimBlock { header, uncles, transaction_count: transactions.len(), withdrawals };\n\n Ok(BlockDetails {\n block,\n total_fees: U256::from(total_fees),\n // issuance has no meaningful value in anvil's backend. just default to 0\n issuance: Default::default(),\n })\n }\n\n /// Fetches all receipts for the blocks's transactions, as required by the\n /// [`ots_getBlockTransactions`] endpoint spec, and returns the final response object.\n ///\n /// [`ots_getBlockTransactions`]: https://docs.otterscan.io/api-docs/ots-api#ots_getblocktransactions\n pub async fn build_ots_block_tx(\n &self,\n mut block: AnyRpcBlock,\n page: usize,\n page_size: usize,\n ) -> Result> {\n if block.transactions.is_uncle() {\n return Err(BlockchainError::DataUnavailable);\n }\n\n block.transactions = match block.transactions() {\n BlockTransactions::Full(txs) => BlockTransactions::Full(\n txs.iter().skip(page * page_size).take(page_size).cloned().collect(),\n ),\n BlockTransactions::Hashes(txs) => BlockTransactions::Hashes(\n txs.iter().skip(page * page_size).take(page_size).copied().collect(),\n ),\n BlockTransactions::Uncle => unreachable!(),\n };\n\n let receipt_futs = block.transactions.hashes().map(|hash| self.transaction_receipt(hash));\n\n // Reuse timestamp from the block we already have\n let timestamp = block.header.timestamp();\n\n let receipts = join_all(receipt_futs.map(|r| async move {\n if let Ok(Some(r)) = r.await {\n let receipt = r.as_ref().inner.clone().map_inner(OtsReceipt::from);\n Ok(OtsTransactionReceipt { receipt, timestamp: Some(timestamp) })\n } else {\n Err(BlockchainError::BlockNotFound)\n }\n }))\n .await\n .into_iter()\n .collect::>>()?;\n\n let transaction_count = block.transactions().len();\n let fullblock = OtsBlock { block: block.inner.clone(), transaction_count };\n\n let ots_block_txs = OtsBlockTransactions { fullblock, receipts };\n\n Ok(ots_block_txs)\n }\n\n pub async fn build_ots_search_transactions(\n &self,\n hashes: Vec,\n first_page: bool,\n last_page: bool,\n ) -> Result>> {\n let txs_futs = hashes.iter().map(|hash| async { self.transaction_by_hash(*hash).await });\n\n let txs = join_all(txs_futs)\n .await\n .into_iter()\n .map(|t| match t {\n Ok(Some(t)) => Ok(t.into_inner()),\n _ => Err(BlockchainError::DataUnavailable),\n })\n .collect::>>()?;\n\n let receipt_futs = hashes.iter().map(|hash| self.transaction_receipt(*hash));\n\n let receipts = join_all(receipt_futs.map(|r| async {\n if let Ok(Some(r)) = r.await {\n // Try to get timestamp from receipt's other fields first (set by mined receipts),\n // fallback to block lookup for fork receipts that may not have it\n let timestamp = if let Some(ts) = r.block_timestamp() {\n ts\n } else {\n let block = self.block_by_number(r.block_number().unwrap().into()).await?;\n block.ok_or(BlockchainError::BlockNotFound)?.header.timestamp()\n };\n let receipt = r.as_ref().inner.clone().map_inner(OtsReceipt::from);\n Ok(OtsTransactionReceipt { receipt, timestamp: Some(timestamp) })\n } else {\n Err(BlockchainError::BlockNotFound)\n }\n }))\n .await\n .into_iter()\n .collect::>>()?;\n\n Ok(TransactionsWithReceipts { txs, receipts, first_page, last_page })\n }\n}\n" }, { "path": "crates/anvil/src/eth/otterscan/mod.rs", "content": "pub mod api;\n" }, { "path": "crates/anvil/src/eth/pool/mod.rs", "content": "//! # Transaction Pool implementation\n//!\n//! The transaction pool is responsible for managing a set of transactions that can be included in\n//! upcoming blocks.\n//!\n//! The main task of the pool is to prepare an ordered list of transactions that are ready to be\n//! included in a new block.\n//!\n//! Each imported block can affect the validity of transactions already in the pool.\n//! The miner expects the most up-to-date transactions when attempting to create a new block.\n//! After being included in a block, a transaction should be removed from the pool, this process is\n//! called _pruning_ and due to separation of concerns is triggered externally.\n//! The pool essentially performs following services:\n//! * import transactions\n//! * order transactions\n//! * provide ordered set of transactions that are ready for inclusion\n//! * prune transactions\n//!\n//! Each transaction in the pool contains markers that it _provides_ or _requires_. This property is\n//! used to determine whether it can be included in a block (transaction is ready) or whether it\n//! still _requires_ other transactions to be mined first (transaction is pending).\n//! A transaction is associated with the nonce of the account it's sent from. A unique identifying\n//! marker for a transaction is therefore the pair `(nonce + account)`. An incoming transaction with\n//! a `nonce > nonce on chain` will _require_ `(nonce -1, account)` first, before it is ready to be\n//! included in a block.\n//!\n//! This implementation is adapted from \n\nuse crate::{\n eth::{\n error::PoolError,\n pool::transactions::{\n PendingPoolTransaction, PendingTransactions, PoolTransaction, ReadyTransactions,\n TransactionsIterator, TxMarker,\n },\n },\n mem::storage::MinedBlockOutcome,\n};\nuse alloy_consensus::Transaction;\nuse alloy_primitives::{Address, TxHash};\nuse alloy_rpc_types::txpool::TxpoolStatus;\nuse anvil_core::eth::transaction::PendingTransaction;\nuse futures::channel::mpsc::{Receiver, Sender, channel};\nuse parking_lot::{Mutex, RwLock};\nuse std::{collections::VecDeque, fmt, sync::Arc};\n\npub mod transactions;\n\n/// Transaction pool that performs validation.\npub struct Pool {\n /// processes all pending transactions\n inner: RwLock>,\n /// listeners for new ready transactions\n transaction_listener: Mutex>>,\n}\n\nimpl Default for Pool {\n fn default() -> Self {\n Self { inner: RwLock::new(PoolInner::default()), transaction_listener: Default::default() }\n }\n}\n\n// == impl Pool ==\n\nimpl Pool {\n /// Returns an iterator that yields all transactions that are currently ready\n pub fn ready_transactions(&self) -> TransactionsIterator {\n self.inner.read().ready_transactions()\n }\n\n /// Returns all transactions that are not ready to be included in a block yet\n pub fn pending_transactions(&self) -> Vec>> {\n self.inner.read().pending_transactions.transactions().collect()\n }\n\n /// Returns the number of tx that are ready and queued for further execution\n pub fn txpool_status(&self) -> TxpoolStatus {\n // Note: naming differs here compared to geth's `TxpoolStatus`\n let pending: u64 = self.inner.read().ready_transactions.len().try_into().unwrap_or(0);\n let queued: u64 = self.inner.read().pending_transactions.len().try_into().unwrap_or(0);\n TxpoolStatus { pending, queued }\n }\n\n /// Adds a new transaction listener to the pool that gets notified about every new ready\n /// transaction\n pub fn add_ready_listener(&self) -> Receiver {\n const TX_LISTENER_BUFFER_SIZE: usize = 2048;\n let (tx, rx) = channel(TX_LISTENER_BUFFER_SIZE);\n self.transaction_listener.lock().push(tx);\n rx\n }\n\n /// Returns true if this pool already contains the transaction\n pub fn contains(&self, tx_hash: &TxHash) -> bool {\n self.inner.read().contains(tx_hash)\n }\n\n /// Removes all transactions from the pool\n pub fn clear(&self) {\n let mut pool = self.inner.write();\n pool.clear();\n }\n\n /// Remove the given transactions from the pool\n pub fn remove_invalid(&self, tx_hashes: Vec) -> Vec>> {\n self.inner.write().remove_invalid(tx_hashes)\n }\n\n /// Remove transactions by sender\n pub fn remove_transactions_by_address(&self, sender: Address) -> Vec>> {\n self.inner.write().remove_transactions_by_address(sender)\n }\n\n /// Removes a single transaction from the pool\n ///\n /// This is similar to `[Pool::remove_invalid()]` but for a single transaction.\n ///\n /// **Note**: this will also drop any transaction that depend on the `tx`\n pub fn drop_transaction(&self, tx: TxHash) -> Option>> {\n trace!(target: \"txpool\", \"Dropping transaction: [{:?}]\", tx);\n let removed = {\n let mut pool = self.inner.write();\n pool.ready_transactions.remove_with_markers(vec![tx], None)\n };\n trace!(target: \"txpool\", \"Dropped transactions: {:?}\", removed.iter().map(|tx| tx.hash()).collect::>());\n\n let mut dropped = None;\n if !removed.is_empty() {\n dropped = removed.into_iter().find(|t| *t.pending_transaction.hash() == tx);\n }\n dropped\n }\n\n /// Notifies listeners if the transaction was added to the ready queue.\n fn notify_ready(&self, tx: &AddedTransaction) {\n if let AddedTransaction::Ready(ready) = tx {\n self.notify_listener(ready.hash);\n for promoted in ready.promoted.iter().copied() {\n self.notify_listener(promoted);\n }\n }\n }\n\n /// notifies all listeners about the transaction\n fn notify_listener(&self, hash: TxHash) {\n let mut listener = self.transaction_listener.lock();\n // this is basically a retain but with mut reference\n for n in (0..listener.len()).rev() {\n let mut listener_tx = listener.swap_remove(n);\n let retain = match listener_tx.try_send(hash) {\n Ok(()) => true,\n Err(e) => {\n if e.is_full() {\n warn!(\n target: \"txpool\",\n \"[{:?}] Failed to send tx notification because channel is full\",\n hash,\n );\n true\n } else {\n false\n }\n }\n };\n if retain {\n listener.push(listener_tx)\n }\n }\n }\n}\n\nimpl Pool {\n /// Returns the _pending_ transaction for that `hash` if it exists in the mempool\n pub fn get_transaction(&self, hash: TxHash) -> Option> {\n self.inner.read().get_transaction(hash)\n }\n}\n\nimpl Pool {\n /// Invoked when a set of transactions ([Self::ready_transactions()]) was executed.\n ///\n /// This will remove the transactions from the pool.\n pub fn on_mined_block(&self, outcome: MinedBlockOutcome) -> PruneResult {\n let MinedBlockOutcome { block_number, included, invalid } = outcome;\n\n // remove invalid transactions from the pool\n self.remove_invalid(invalid.into_iter().map(|tx| tx.hash()).collect());\n\n // prune all the markers the mined transactions provide\n let res = self\n .prune_markers(block_number, included.into_iter().flat_map(|tx| tx.provides.clone()));\n trace!(target: \"txpool\", \"pruned transaction markers {:?}\", res);\n res\n }\n\n /// Removes ready transactions for the given iterator of identifying markers.\n ///\n /// For each marker we can remove transactions in the pool that either provide the marker\n /// directly or are a dependency of the transaction associated with that marker.\n pub fn prune_markers(\n &self,\n block_number: u64,\n markers: impl IntoIterator,\n ) -> PruneResult {\n debug!(target: \"txpool\", ?block_number, \"pruning transactions\");\n let res = self.inner.write().prune_markers(markers);\n for tx in &res.promoted {\n self.notify_ready(tx);\n }\n res\n }\n\n /// Adds a new transaction to the pool\n pub fn add_transaction(\n &self,\n tx: PoolTransaction,\n ) -> Result, PoolError> {\n let added = self.inner.write().add_transaction(tx)?;\n self.notify_ready(&added);\n Ok(added)\n }\n}\n\n/// A Transaction Pool\n///\n/// Contains all transactions that are ready to be executed\n#[derive(Debug)]\nstruct PoolInner {\n ready_transactions: ReadyTransactions,\n pending_transactions: PendingTransactions,\n}\n\nimpl Default for PoolInner {\n fn default() -> Self {\n Self { ready_transactions: Default::default(), pending_transactions: Default::default() }\n }\n}\n\n// == impl PoolInner ==\n\nimpl PoolInner {\n /// Returns an iterator over transactions that are ready.\n fn ready_transactions(&self) -> TransactionsIterator {\n self.ready_transactions.get_transactions()\n }\n\n /// Clears\n fn clear(&mut self) {\n self.ready_transactions.clear();\n self.pending_transactions.clear();\n }\n\n /// Returns an iterator over all transactions in the pool filtered by the sender\n pub fn transactions_by_sender(\n &self,\n sender: Address,\n ) -> impl Iterator>> + '_ {\n let pending_txs = self\n .pending_transactions\n .transactions()\n .filter(move |tx| tx.pending_transaction.sender().eq(&sender));\n\n let ready_txs = self\n .ready_transactions\n .get_transactions()\n .filter(move |tx| tx.pending_transaction.sender().eq(&sender));\n\n pending_txs.chain(ready_txs)\n }\n\n /// Returns true if this pool already contains the transaction\n fn contains(&self, tx_hash: &TxHash) -> bool {\n self.pending_transactions.contains(tx_hash) || self.ready_transactions.contains(tx_hash)\n }\n\n /// Remove the given transactions from the pool\n fn remove_invalid(&mut self, tx_hashes: Vec) -> Vec>> {\n // early exit in case there is no invalid transactions.\n if tx_hashes.is_empty() {\n return vec![];\n }\n trace!(target: \"txpool\", \"Removing invalid transactions: {:?}\", tx_hashes);\n\n let mut removed = self.ready_transactions.remove_with_markers(tx_hashes.clone(), None);\n removed.extend(self.pending_transactions.remove(tx_hashes));\n\n trace!(target: \"txpool\", \"Removed invalid transactions: {:?}\", removed.iter().map(|tx| tx.hash()).collect::>());\n\n removed\n }\n\n /// Remove transactions by sender address\n fn remove_transactions_by_address(&mut self, sender: Address) -> Vec>> {\n let tx_hashes =\n self.transactions_by_sender(sender).map(move |tx| tx.hash()).collect::>();\n\n if tx_hashes.is_empty() {\n return vec![];\n }\n\n trace!(target: \"txpool\", \"Removing transactions: {:?}\", tx_hashes);\n\n let mut removed = self.ready_transactions.remove_with_markers(tx_hashes.clone(), None);\n removed.extend(self.pending_transactions.remove(tx_hashes));\n\n trace!(target: \"txpool\", \"Removed transactions: {:?}\", removed.iter().map(|tx| tx.hash()).collect::>());\n\n removed\n }\n}\n\nimpl PoolInner {\n /// checks both pools for the matching transaction\n ///\n /// Returns `None` if the transaction does not exist in the pool\n fn get_transaction(&self, hash: TxHash) -> Option> {\n if let Some(pending) = self.pending_transactions.get(&hash) {\n return Some(pending.transaction.pending_transaction.clone());\n }\n Some(\n self.ready_transactions.get(&hash)?.transaction.transaction.pending_transaction.clone(),\n )\n }\n}\n\nimpl PoolInner {\n fn add_transaction(\n &mut self,\n tx: PoolTransaction,\n ) -> Result, PoolError> {\n if self.contains(&tx.hash()) {\n warn!(target: \"txpool\", \"[{:?}] Already imported\", tx.hash());\n return Err(PoolError::AlreadyImported(tx.hash()));\n }\n\n let tx = PendingPoolTransaction::new(tx, self.ready_transactions.provided_markers());\n trace!(target: \"txpool\", \"[{:?}] ready={}\", tx.transaction.hash(), tx.is_ready());\n\n // If all markers are not satisfied import to future\n if !tx.is_ready() {\n let hash = tx.transaction.hash();\n self.pending_transactions.add_transaction(tx)?;\n return Ok(AddedTransaction::Pending { hash });\n }\n self.add_ready_transaction(tx)\n }\n\n /// Adds the transaction to the ready queue\n fn add_ready_transaction(\n &mut self,\n tx: PendingPoolTransaction,\n ) -> Result, PoolError> {\n let hash = tx.transaction.hash();\n trace!(target: \"txpool\", \"adding ready transaction [{:?}]\", hash);\n let mut ready = ReadyTransaction::new(hash);\n\n let mut tx_queue = VecDeque::from([tx]);\n // tracks whether we're processing the given `tx`\n let mut is_new_tx = true;\n\n // take first transaction from the list\n while let Some(current_tx) = tx_queue.pop_front() {\n // also add the transaction that the current transaction unlocks\n tx_queue.extend(\n self.pending_transactions.mark_and_unlock(¤t_tx.transaction.provides),\n );\n\n let current_hash = current_tx.transaction.hash();\n // try to add the transaction to the ready pool\n match self.ready_transactions.add_transaction(current_tx) {\n Ok(replaced_transactions) => {\n if !is_new_tx {\n ready.promoted.push(current_hash);\n }\n // tx removed from ready pool\n ready.removed.extend(replaced_transactions);\n }\n Err(err) => {\n // failed to add transaction\n if is_new_tx {\n debug!(target: \"txpool\", \"[{:?}] Failed to add tx: {:?}\", current_hash,\n err);\n return Err(err);\n } else {\n ready.discarded.push(current_hash);\n }\n }\n }\n is_new_tx = false;\n }\n\n // check for a cycle where importing a transaction resulted in pending transactions to be\n // added while removing current transaction. in which case we move this transaction back to\n // the pending queue\n if ready.removed.iter().any(|tx| *tx.hash() == hash) {\n self.ready_transactions.clear_transactions(&ready.promoted);\n return Err(PoolError::CyclicTransaction);\n }\n\n Ok(AddedTransaction::Ready(ready))\n }\n\n /// Prunes the transactions that provide the given markers\n ///\n /// This will effectively remove those transactions that satisfy the markers and transactions\n /// from the pending queue might get promoted to if the markers unlock them.\n pub fn prune_markers(&mut self, markers: impl IntoIterator) -> PruneResult {\n let mut imports = vec![];\n let mut pruned = vec![];\n\n for marker in markers {\n // mark as satisfied and store the transactions that got unlocked\n imports.extend(self.pending_transactions.mark_and_unlock(Some(&marker)));\n // prune transactions\n pruned.extend(self.ready_transactions.prune_tags(marker.clone()));\n }\n\n let mut promoted = vec![];\n let mut failed = vec![];\n for tx in imports {\n let hash = tx.transaction.hash();\n match self.add_ready_transaction(tx) {\n Ok(res) => promoted.push(res),\n Err(e) => {\n warn!(target: \"txpool\", \"Failed to promote tx [{:?}] : {:?}\", hash, e);\n failed.push(hash)\n }\n }\n }\n\n PruneResult { pruned, failed, promoted }\n }\n}\n\n/// Represents the outcome of a prune\npub struct PruneResult {\n /// a list of added transactions that a pruned marker satisfied\n pub promoted: Vec>,\n /// all transactions that failed to be promoted and now are discarded\n pub failed: Vec,\n /// all transactions that were pruned from the ready pool\n pub pruned: Vec>>,\n}\n\nimpl fmt::Debug for PruneResult {\n fn fmt(&self, fmt: &mut fmt::Formatter<'_>) -> fmt::Result {\n write!(fmt, \"PruneResult {{ \")?;\n write!(\n fmt,\n \"promoted: {:?}, \",\n self.promoted.iter().map(|tx| *tx.hash()).collect::>()\n )?;\n write!(fmt, \"failed: {:?}, \", self.failed)?;\n write!(\n fmt,\n \"pruned: {:?}, \",\n self.pruned.iter().map(|tx| *tx.pending_transaction.hash()).collect::>()\n )?;\n write!(fmt, \"}}\")?;\n Ok(())\n }\n}\n\n#[derive(Clone, Debug)]\npub struct ReadyTransaction {\n /// the hash of the submitted transaction\n hash: TxHash,\n /// transactions promoted to the ready queue\n promoted: Vec,\n /// transaction that failed and became discarded\n discarded: Vec,\n /// Transactions removed from the Ready pool\n removed: Vec>>,\n}\n\nimpl ReadyTransaction {\n pub fn new(hash: TxHash) -> Self {\n Self {\n hash,\n promoted: Default::default(),\n discarded: Default::default(),\n removed: Default::default(),\n }\n }\n}\n\n#[derive(Clone, Debug)]\npub enum AddedTransaction {\n /// transaction was successfully added and being processed\n Ready(ReadyTransaction),\n /// Transaction was successfully added but not yet queued for processing\n Pending {\n /// the hash of the submitted transaction\n hash: TxHash,\n },\n}\n\nimpl AddedTransaction {\n pub fn hash(&self) -> &TxHash {\n match self {\n Self::Ready(tx) => &tx.hash,\n Self::Pending { hash } => hash,\n }\n }\n}\n" }, { "path": "crates/anvil/src/eth/pool/transactions.rs", "content": "use crate::eth::{error::PoolError, util::hex_fmt_many};\nuse alloy_consensus::{Transaction, Typed2718};\nuse alloy_network::AnyRpcTransaction;\nuse alloy_primitives::{\n Address, TxHash,\n map::{HashMap, HashSet},\n};\nuse anvil_core::eth::transaction::PendingTransaction;\nuse foundry_primitives::FoundryTxEnvelope;\nuse parking_lot::RwLock;\nuse std::{cmp::Ordering, collections::BTreeSet, fmt, str::FromStr, sync::Arc, time::Instant};\n\n/// A unique identifying marker for a transaction\npub type TxMarker = Vec;\n\n/// Result type for replaced transactions: the replaced pool transactions and the hashes they\n/// unlock.\ntype ReplacedTransactions = (Vec>>, Vec);\n\n/// creates an unique identifier for aan (`nonce` + `Address`) combo\npub fn to_marker(nonce: u64, from: Address) -> TxMarker {\n let mut data = [0u8; 28];\n data[..8].copy_from_slice(&nonce.to_le_bytes()[..]);\n data[8..].copy_from_slice(&from.0[..]);\n data.to_vec()\n}\n\n/// Modes that determine the transaction ordering of the mempool\n///\n/// This type controls the transaction order via the priority metric of a transaction\n#[derive(Clone, Copy, Debug, Default, PartialEq, Eq, serde::Serialize, serde::Deserialize)]\npub enum TransactionOrder {\n /// Keep the pool transaction transactions sorted in the order they arrive.\n ///\n /// This will essentially assign every transaction the exact priority so the order is\n /// determined by their internal id\n Fifo,\n /// This means that it prioritizes transactions based on the fees paid to the miner.\n #[default]\n Fees,\n}\n\nimpl TransactionOrder {\n /// Returns the priority of the transactions\n pub fn priority(&self, tx: &T) -> TransactionPriority {\n match self {\n Self::Fifo => TransactionPriority::default(),\n Self::Fees => TransactionPriority(tx.max_fee_per_gas()),\n }\n }\n}\n\nimpl FromStr for TransactionOrder {\n type Err = String;\n\n fn from_str(s: &str) -> Result {\n let s = s.to_lowercase();\n let order = match s.as_str() {\n \"fees\" => Self::Fees,\n \"fifo\" => Self::Fifo,\n _ => return Err(format!(\"Unknown TransactionOrder: `{s}`\")),\n };\n Ok(order)\n }\n}\n\n/// Metric value for the priority of a transaction.\n///\n/// The `TransactionPriority` determines the ordering of two transactions that have all their\n/// markers satisfied.\n#[derive(Clone, Copy, Debug, Default, PartialEq, Eq, PartialOrd, Ord)]\npub struct TransactionPriority(pub u128);\n\n/// Internal Transaction type\n#[derive(Clone, PartialEq, Eq)]\npub struct PoolTransaction {\n /// the pending eth transaction\n pub pending_transaction: PendingTransaction,\n /// Markers required by the transaction\n pub requires: Vec,\n /// Markers that this transaction provides\n pub provides: Vec,\n /// priority of the transaction\n pub priority: TransactionPriority,\n}\n\n// == impl PoolTransaction ==\n\nimpl PoolTransaction {\n pub fn new(transaction: PendingTransaction) -> Self {\n Self {\n pending_transaction: transaction,\n requires: vec![],\n provides: vec![],\n priority: TransactionPriority(0),\n }\n }\n\n /// Returns the hash of this transaction\n pub fn hash(&self) -> TxHash {\n *self.pending_transaction.hash()\n }\n}\n\nimpl PoolTransaction {\n /// Returns the max fee per gas of this transaction\n pub fn max_fee_per_gas(&self) -> u128 {\n self.pending_transaction.transaction.max_fee_per_gas()\n }\n}\n\nimpl PoolTransaction {\n /// Returns the type of the transaction\n pub fn tx_type(&self) -> u8 {\n self.pending_transaction.transaction.ty()\n }\n}\n\nimpl fmt::Debug for PoolTransaction {\n fn fmt(&self, fmt: &mut fmt::Formatter<'_>) -> fmt::Result {\n write!(fmt, \"Transaction {{ \")?;\n write!(fmt, \"hash: {:?}, \", &self.pending_transaction.hash())?;\n write!(fmt, \"requires: [{}], \", hex_fmt_many(self.requires.iter()))?;\n write!(fmt, \"provides: [{}], \", hex_fmt_many(self.provides.iter()))?;\n write!(fmt, \"raw tx: {:?}\", &self.pending_transaction)?;\n write!(fmt, \"}}\")?;\n Ok(())\n }\n}\n\nimpl TryFrom for PoolTransaction {\n type Error = eyre::Error;\n fn try_from(value: AnyRpcTransaction) -> Result {\n let typed_transaction = FoundryTxEnvelope::try_from(value)?;\n let pending_transaction = PendingTransaction::new(typed_transaction)?;\n Ok(Self {\n pending_transaction,\n requires: vec![],\n provides: vec![],\n priority: TransactionPriority(0),\n })\n }\n}\n\n/// A waiting pool of transaction that are pending, but not yet ready to be included in a new block.\n///\n/// Keeps a set of transactions that are waiting for other transactions\n#[derive(Clone, Debug)]\npub struct PendingTransactions {\n /// markers that aren't yet provided by any transaction\n required_markers: HashMap>,\n /// mapping of the markers of a transaction to the hash of the transaction\n waiting_markers: HashMap, TxHash>,\n /// the transactions that are not ready yet are waiting for another tx to finish\n waiting_queue: HashMap>,\n}\n\nimpl Default for PendingTransactions {\n fn default() -> Self {\n Self {\n required_markers: Default::default(),\n waiting_markers: Default::default(),\n waiting_queue: Default::default(),\n }\n }\n}\n\nimpl PendingTransactions {\n /// Returns the number of transactions that are currently waiting\n pub fn len(&self) -> usize {\n self.waiting_queue.len()\n }\n\n pub fn is_empty(&self) -> bool {\n self.waiting_queue.is_empty()\n }\n\n /// Clears internal state\n pub fn clear(&mut self) {\n self.required_markers.clear();\n self.waiting_markers.clear();\n self.waiting_queue.clear();\n }\n\n /// Returns an iterator over all transactions in the waiting pool\n pub fn transactions(&self) -> impl Iterator>> + '_ {\n self.waiting_queue.values().map(|tx| tx.transaction.clone())\n }\n\n /// Returns true if given transaction is part of the queue\n pub fn contains(&self, hash: &TxHash) -> bool {\n self.waiting_queue.contains_key(hash)\n }\n\n /// Returns the transaction for the hash if it's pending\n pub fn get(&self, hash: &TxHash) -> Option<&PendingPoolTransaction> {\n self.waiting_queue.get(hash)\n }\n\n /// This will check off the markers of pending transactions.\n ///\n /// Returns the those transactions that become unlocked (all markers checked) and can be moved\n /// to the ready queue.\n pub fn mark_and_unlock(\n &mut self,\n markers: impl IntoIterator>,\n ) -> Vec> {\n let mut unlocked_ready = Vec::new();\n for mark in markers {\n let mark = mark.as_ref();\n if let Some(tx_hashes) = self.required_markers.remove(mark) {\n for hash in tx_hashes {\n let tx = self.waiting_queue.get_mut(&hash).expect(\"tx is included;\");\n tx.mark(mark);\n\n if tx.is_ready() {\n let tx = self.waiting_queue.remove(&hash).expect(\"tx is included;\");\n self.waiting_markers.remove(&tx.transaction.provides);\n\n unlocked_ready.push(tx);\n }\n }\n }\n }\n\n unlocked_ready\n }\n\n /// Removes the transactions associated with the given hashes\n ///\n /// Returns all removed transactions.\n pub fn remove(&mut self, hashes: Vec) -> Vec>> {\n let mut removed = vec![];\n for hash in hashes {\n if let Some(waiting_tx) = self.waiting_queue.remove(&hash) {\n self.waiting_markers.remove(&waiting_tx.transaction.provides);\n for marker in waiting_tx.missing_markers {\n let remove = if let Some(required) = self.required_markers.get_mut(&marker) {\n required.remove(&hash);\n required.is_empty()\n } else {\n false\n };\n if remove {\n self.required_markers.remove(&marker);\n }\n }\n removed.push(waiting_tx.transaction)\n }\n }\n removed\n }\n}\n\nimpl PendingTransactions {\n /// Adds a transaction to Pending queue of transactions\n pub fn add_transaction(&mut self, tx: PendingPoolTransaction) -> Result<(), PoolError> {\n assert!(!tx.is_ready(), \"transaction must not be ready\");\n assert!(\n !self.waiting_queue.contains_key(&tx.transaction.hash()),\n \"transaction is already added\"\n );\n\n if let Some(replace) = self\n .waiting_markers\n .get(&tx.transaction.provides)\n .and_then(|hash| self.waiting_queue.get(hash))\n {\n // check if underpriced\n if tx.transaction.max_fee_per_gas() < replace.transaction.max_fee_per_gas() {\n warn!(target: \"txpool\", \"pending replacement transaction underpriced [{:?}]\", tx.transaction.hash());\n return Err(PoolError::ReplacementUnderpriced(tx.transaction.hash()));\n }\n }\n\n // add all missing markers\n for marker in &tx.missing_markers {\n self.required_markers.entry(marker.clone()).or_default().insert(tx.transaction.hash());\n }\n\n // also track identifying markers\n self.waiting_markers.insert(tx.transaction.provides.clone(), tx.transaction.hash());\n // add tx to the queue\n self.waiting_queue.insert(tx.transaction.hash(), tx);\n\n Ok(())\n }\n}\n\n/// A transaction in the pool\n#[derive(Clone)]\npub struct PendingPoolTransaction {\n pub transaction: Arc>,\n /// markers required and have not been satisfied yet by other transactions in the pool\n pub missing_markers: HashSet,\n /// timestamp when the tx was added\n pub added_at: Instant,\n}\n\nimpl PendingPoolTransaction {\n /// Creates a new `PendingPoolTransaction`.\n ///\n /// Determines the markers that are still missing before this transaction can be moved to the\n /// ready queue.\n pub fn new(transaction: PoolTransaction, provided: &HashMap) -> Self {\n let missing_markers = transaction\n .requires\n .iter()\n .filter(|marker| {\n // is true if the marker is already satisfied either via transaction in the pool\n !provided.contains_key(&**marker)\n })\n .cloned()\n .collect();\n\n Self { transaction: Arc::new(transaction), missing_markers, added_at: Instant::now() }\n }\n\n /// Removes the required marker\n pub fn mark(&mut self, marker: &TxMarker) {\n self.missing_markers.remove(marker);\n }\n\n /// Returns true if transaction has all requirements satisfied.\n pub fn is_ready(&self) -> bool {\n self.missing_markers.is_empty()\n }\n}\n\nimpl fmt::Debug for PendingPoolTransaction {\n fn fmt(&self, fmt: &mut fmt::Formatter<'_>) -> fmt::Result {\n write!(fmt, \"PendingTransaction {{ \")?;\n write!(fmt, \"added_at: {:?}, \", self.added_at)?;\n write!(fmt, \"tx: {:?}, \", self.transaction)?;\n write!(fmt, \"missing_markers: {{{}}}\", hex_fmt_many(self.missing_markers.iter()))?;\n write!(fmt, \"}}\")\n }\n}\n\npub struct TransactionsIterator {\n all: HashMap>,\n awaiting: HashMap)>,\n independent: BTreeSet>,\n _invalid: HashSet,\n}\n\nimpl TransactionsIterator {\n /// Depending on number of satisfied requirements insert given ref\n /// either to awaiting set or to best set.\n fn independent_or_awaiting(&mut self, satisfied: usize, tx_ref: PoolTransactionRef) {\n if satisfied >= tx_ref.transaction.requires.len() {\n // If we have satisfied all deps insert to best\n self.independent.insert(tx_ref);\n } else {\n // otherwise we're still awaiting for some deps\n self.awaiting.insert(tx_ref.transaction.hash(), (satisfied, tx_ref));\n }\n }\n}\n\nimpl Iterator for TransactionsIterator {\n type Item = Arc>;\n\n fn next(&mut self) -> Option {\n loop {\n let best = self.independent.iter().next_back()?.clone();\n let best = self.independent.take(&best)?;\n let hash = best.transaction.hash();\n\n let ready =\n if let Some(ready) = self.all.get(&hash).cloned() { ready } else { continue };\n\n // Insert transactions that just got unlocked.\n for hash in &ready.unlocks {\n // first check local awaiting transactions\n let res = if let Some((mut satisfied, tx_ref)) = self.awaiting.remove(hash) {\n satisfied += 1;\n Some((satisfied, tx_ref))\n // then get from the pool\n } else {\n self.all\n .get(hash)\n .map(|next| (next.requires_offset + 1, next.transaction.clone()))\n };\n if let Some((satisfied, tx_ref)) = res {\n self.independent_or_awaiting(satisfied, tx_ref)\n }\n }\n\n return Some(best.transaction);\n }\n }\n}\n\n/// transactions that are ready to be included in a block.\n#[derive(Clone, Debug)]\npub struct ReadyTransactions {\n /// keeps track of transactions inserted in the pool\n ///\n /// this way we can determine when transactions where submitted to the pool\n id: u64,\n /// markers that are provided by `ReadyTransaction`s\n provided_markers: HashMap,\n /// transactions that are ready\n ready_tx: Arc>>>,\n /// independent transactions that can be included directly and don't require other transactions\n /// Sorted by their id\n independent_transactions: BTreeSet>,\n}\n\nimpl Default for ReadyTransactions {\n fn default() -> Self {\n Self {\n id: 0,\n provided_markers: Default::default(),\n ready_tx: Default::default(),\n independent_transactions: Default::default(),\n }\n }\n}\n\nimpl ReadyTransactions {\n /// Returns an iterator over all transactions\n pub fn get_transactions(&self) -> TransactionsIterator {\n TransactionsIterator {\n all: self.ready_tx.read().clone(),\n independent: self.independent_transactions.clone(),\n awaiting: Default::default(),\n _invalid: Default::default(),\n }\n }\n\n /// Clears the internal state\n pub fn clear(&mut self) {\n self.provided_markers.clear();\n self.ready_tx.write().clear();\n self.independent_transactions.clear();\n }\n\n /// Returns true if the transaction is part of the queue.\n pub fn contains(&self, hash: &TxHash) -> bool {\n self.ready_tx.read().contains_key(hash)\n }\n\n /// Returns the number of ready transactions without cloning the snapshot\n pub fn len(&self) -> usize {\n self.ready_tx.read().len()\n }\n\n /// Returns true if there are no ready transactions\n pub fn is_empty(&self) -> bool {\n self.ready_tx.read().is_empty()\n }\n\n /// Returns the transaction for the hash if it's in the ready pool but not yet mined\n pub fn get(&self, hash: &TxHash) -> Option> {\n self.ready_tx.read().get(hash).cloned()\n }\n\n pub fn provided_markers(&self) -> &HashMap {\n &self.provided_markers\n }\n\n fn next_id(&mut self) -> u64 {\n let id = self.id;\n self.id = self.id.wrapping_add(1);\n id\n }\n\n /// Removes the transactions from the ready queue and returns the removed transactions.\n /// This will also remove all transactions that depend on those.\n pub fn clear_transactions(&mut self, tx_hashes: &[TxHash]) -> Vec>> {\n self.remove_with_markers(tx_hashes.to_vec(), None)\n }\n\n /// Removes the transactions that provide the marker\n ///\n /// This will also remove all transactions that lead to the transaction that provides the\n /// marker.\n pub fn prune_tags(&mut self, marker: TxMarker) -> Vec>> {\n let mut removed_tx = vec![];\n\n // the markers to remove\n let mut remove = vec![marker];\n\n while let Some(marker) = remove.pop() {\n let res = self\n .provided_markers\n .remove(&marker)\n .and_then(|hash| self.ready_tx.write().remove(&hash));\n\n if let Some(tx) = res {\n let unlocks = tx.unlocks;\n self.independent_transactions.remove(&tx.transaction);\n let tx = tx.transaction.transaction;\n\n // also prune previous transactions\n {\n let hash = tx.hash();\n let mut ready = self.ready_tx.write();\n\n let mut previous_markers = |marker| -> Option> {\n let prev_hash = self.provided_markers.get(marker)?;\n let tx2 = ready.get_mut(prev_hash)?;\n // remove hash\n if let Some(idx) = tx2.unlocks.iter().position(|i| i == &hash) {\n tx2.unlocks.swap_remove(idx);\n }\n if tx2.unlocks.is_empty() {\n Some(tx2.transaction.transaction.provides.clone())\n } else {\n None\n }\n };\n\n // find previous transactions\n for marker in &tx.requires {\n if let Some(mut tags_to_remove) = previous_markers(marker) {\n remove.append(&mut tags_to_remove);\n }\n }\n }\n\n // add the transactions that just got unlocked to independent set\n for hash in unlocks {\n if let Some(tx) = self.ready_tx.write().get_mut(&hash) {\n tx.requires_offset += 1;\n if tx.requires_offset == tx.transaction.transaction.requires.len() {\n self.independent_transactions.insert(tx.transaction.clone());\n }\n }\n }\n // finally, remove the markers that this transaction provides\n let current_marker = ▮\n for marker in &tx.provides {\n let removed = self.provided_markers.remove(marker);\n assert_eq!(\n removed,\n if current_marker == marker { None } else { Some(tx.hash()) },\n \"The pool contains exactly one transaction providing given tag; the removed transaction\n\t\t\t\t\t\tclaims to provide that tag, so it has to be mapped to it's hash; qed\"\n );\n }\n removed_tx.push(tx);\n }\n }\n\n removed_tx\n }\n\n /// Removes transactions and those that depend on them and satisfy at least one marker in the\n /// given filter set.\n pub fn remove_with_markers(\n &mut self,\n mut tx_hashes: Vec,\n marker_filter: Option>,\n ) -> Vec>> {\n let mut removed = Vec::new();\n let mut ready = self.ready_tx.write();\n\n while let Some(hash) = tx_hashes.pop() {\n if let Some(mut tx) = ready.remove(&hash) {\n let invalidated = tx.transaction.transaction.provides.iter().filter(|mark| {\n marker_filter.as_ref().map(|filter| !filter.contains(&**mark)).unwrap_or(true)\n });\n\n let mut removed_some_marks = false;\n // remove entries from provided_markers\n for mark in invalidated {\n removed_some_marks = true;\n self.provided_markers.remove(mark);\n }\n\n // remove from unlocks\n for mark in &tx.transaction.transaction.requires {\n if let Some(provider_hash) = self.provided_markers.get(mark)\n && let Some(provider_tx) = ready.get_mut(provider_hash)\n && let Some(idx) = provider_tx.unlocks.iter().position(|i| i == &hash)\n {\n provider_tx.unlocks.swap_remove(idx);\n }\n }\n\n // remove from the independent set\n self.independent_transactions.remove(&tx.transaction);\n\n if removed_some_marks {\n // remove all transactions that the current one unlocks\n tx_hashes.append(&mut tx.unlocks);\n }\n\n // remove transaction\n removed.push(tx.transaction.transaction);\n }\n }\n\n removed\n }\n}\n\nimpl ReadyTransactions {\n /// Adds a new transactions to the ready queue.\n ///\n /// # Panics\n ///\n /// If the pending transaction is not ready ([`PendingPoolTransaction::is_ready`])\n /// or the transaction is already included.\n pub fn add_transaction(\n &mut self,\n tx: PendingPoolTransaction,\n ) -> Result>>, PoolError> {\n assert!(tx.is_ready(), \"transaction must be ready\",);\n assert!(\n !self.ready_tx.read().contains_key(&tx.transaction.hash()),\n \"transaction already included\"\n );\n\n let (replaced_tx, unlocks) = self.replaced_transactions(&tx.transaction)?;\n\n let id = self.next_id();\n let hash = tx.transaction.hash();\n\n let mut independent = true;\n let mut requires_offset = 0;\n let mut ready = self.ready_tx.write();\n // Add links to transactions that unlock the current one\n for mark in &tx.transaction.requires {\n // Check if the transaction that satisfies the mark is still in the queue.\n if let Some(other) = self.provided_markers.get(mark) {\n let tx = ready.get_mut(other).expect(\"hash included;\");\n tx.unlocks.push(hash);\n // tx still depends on other tx\n independent = false;\n } else {\n requires_offset += 1;\n }\n }\n\n // update markers\n for mark in tx.transaction.provides.iter().cloned() {\n self.provided_markers.insert(mark, hash);\n }\n\n let transaction = PoolTransactionRef { id, transaction: tx.transaction };\n\n // add to the independent set\n if independent {\n self.independent_transactions.insert(transaction.clone());\n }\n\n // insert to ready queue\n ready.insert(hash, ReadyTransaction { transaction, unlocks, requires_offset });\n\n Ok(replaced_tx)\n }\n\n /// Removes and returns those transactions that got replaced by the `tx`\n fn replaced_transactions(\n &mut self,\n tx: &PoolTransaction,\n ) -> Result, PoolError> {\n // check if we are replacing transactions\n let remove_hashes: HashSet<_> =\n tx.provides.iter().filter_map(|mark| self.provided_markers.get(mark)).collect();\n\n // early exit if we are not replacing anything.\n if remove_hashes.is_empty() {\n return Ok((Vec::new(), Vec::new()));\n }\n\n // check if we're replacing the same transaction and if it can be replaced\n let mut unlocked_tx = Vec::new();\n {\n // construct a list of unlocked transactions\n // also check for transactions that shouldn't be replaced because underpriced\n let ready = self.ready_tx.read();\n for to_remove in remove_hashes.iter().filter_map(|hash| ready.get(*hash)) {\n // if we're attempting to replace a transaction that provides the exact same markers\n // (addr + nonce) then we check for gas price\n if to_remove.provides() == tx.provides {\n // check if underpriced\n if tx.pending_transaction.transaction.max_fee_per_gas()\n <= to_remove.max_fee_per_gas()\n {\n warn!(target: \"txpool\", \"ready replacement transaction underpriced [{:?}]\", tx.hash());\n return Err(PoolError::ReplacementUnderpriced(tx.hash()));\n } else {\n trace!(target: \"txpool\", \"replacing ready transaction [{:?}] with higher gas price [{:?}]\", to_remove.transaction.transaction.hash(), tx.hash());\n }\n }\n\n unlocked_tx.extend(to_remove.unlocks.iter().copied())\n }\n }\n\n let remove_hashes = remove_hashes.into_iter().copied().collect::>();\n\n let new_provides = tx.provides.iter().cloned().collect::>();\n let removed_tx = self.remove_with_markers(remove_hashes, Some(new_provides));\n\n Ok((removed_tx, unlocked_tx))\n }\n}\n\n/// A reference to a transaction in the pool\n#[derive(Debug)]\npub struct PoolTransactionRef {\n /// actual transaction\n pub transaction: Arc>,\n /// identifier used to internally compare the transaction in the pool\n pub id: u64,\n}\n\nimpl Clone for PoolTransactionRef {\n fn clone(&self) -> Self {\n Self { transaction: Arc::clone(&self.transaction), id: self.id }\n }\n}\n\nimpl Eq for PoolTransactionRef {}\n\nimpl PartialEq for PoolTransactionRef {\n fn eq(&self, other: &Self) -> bool {\n self.cmp(other) == Ordering::Equal\n }\n}\n\nimpl PartialOrd for PoolTransactionRef {\n fn partial_cmp(&self, other: &Self) -> Option {\n Some(self.cmp(other))\n }\n}\n\nimpl Ord for PoolTransactionRef {\n fn cmp(&self, other: &Self) -> Ordering {\n self.transaction\n .priority\n .cmp(&other.transaction.priority)\n .then_with(|| other.id.cmp(&self.id))\n }\n}\n\n#[derive(Debug)]\npub struct ReadyTransaction {\n /// ref to the actual transaction\n pub transaction: PoolTransactionRef,\n /// tracks the transactions that get unlocked by this transaction\n pub unlocks: Vec,\n /// amount of required markers that are inherently provided\n pub requires_offset: usize,\n}\n\nimpl Clone for ReadyTransaction {\n fn clone(&self) -> Self {\n Self {\n transaction: self.transaction.clone(),\n unlocks: self.unlocks.clone(),\n requires_offset: self.requires_offset,\n }\n }\n}\n\nimpl ReadyTransaction {\n pub fn provides(&self) -> &[TxMarker] {\n &self.transaction.transaction.provides\n }\n}\n\nimpl ReadyTransaction {\n pub fn max_fee_per_gas(&self) -> u128 {\n self.transaction.transaction.max_fee_per_gas()\n }\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n\n #[test]\n fn can_id_txs() {\n let addr = Address::random();\n assert_eq!(to_marker(1, addr), to_marker(1, addr));\n assert_ne!(to_marker(2, addr), to_marker(1, addr));\n }\n}\n" }, { "path": "crates/anvil/src/eth/sign.rs", "content": "use crate::eth::error::BlockchainError;\nuse alloy_consensus::{Sealed, SignableTransaction};\nuse alloy_dyn_abi::TypedData;\nuse alloy_network::{Network, TxSignerSync};\nuse alloy_primitives::{Address, B256, Signature, map::AddressHashMap};\nuse alloy_signer::Signer as AlloySigner;\nuse alloy_signer_local::PrivateKeySigner;\nuse foundry_primitives::{FoundryTxEnvelope, FoundryTypedTx};\nuse tempo_primitives::TempoSignature;\n\n/// Network-agnostic signing: messages, typed data, and hashes.\n#[async_trait::async_trait]\npub trait MessageSigner: Send + Sync {\n /// returns the available accounts for this signer\n fn accounts(&self) -> Vec
;\n\n /// Returns `true` whether this signer can sign for this address\n fn is_signer_for(&self, addr: Address) -> bool {\n self.accounts().contains(&addr)\n }\n\n /// Returns the signature\n async fn sign(&self, address: Address, message: &[u8]) -> Result;\n\n /// Encodes and signs the typed data according EIP-712. Payload must conform to the EIP-712\n /// standard.\n async fn sign_typed_data(\n &self,\n address: Address,\n payload: &TypedData,\n ) -> Result;\n\n /// Signs the given hash.\n async fn sign_hash(&self, address: Address, hash: B256) -> Result;\n}\n\n/// A transaction signer, generic over the network.\n///\n/// Modelled after alloy's `NetworkWallet`: the\n/// [`sign_transaction_from`](Signer::sign_transaction_from) method takes an\n/// unsigned transaction and returns the fully-signed envelope in one step.\npub trait Signer: MessageSigner {\n /// Signs an unsigned transaction and returns the signed envelope.\n ///\n /// Mirrors `NetworkWallet::sign_transaction_from`.\n fn sign_transaction_from(\n &self,\n sender: &Address,\n tx: N::UnsignedTx,\n ) -> Result;\n}\n\n/// Maintains developer keys\npub struct DevSigner {\n addresses: Vec
,\n accounts: AddressHashMap,\n}\n\nimpl DevSigner {\n pub fn new(accounts: Vec) -> Self {\n let addresses = accounts.iter().map(|wallet| wallet.address()).collect::>();\n let accounts = addresses.iter().copied().zip(accounts).collect();\n Self { addresses, accounts }\n }\n}\n\n#[async_trait::async_trait]\nimpl MessageSigner for DevSigner {\n fn accounts(&self) -> Vec
{\n self.addresses.clone()\n }\n\n fn is_signer_for(&self, addr: Address) -> bool {\n self.accounts.contains_key(&addr)\n }\n\n async fn sign(&self, address: Address, message: &[u8]) -> Result {\n let signer = self.accounts.get(&address).ok_or(BlockchainError::NoSignerAvailable)?;\n\n Ok(signer.sign_message(message).await?)\n }\n\n async fn sign_typed_data(\n &self,\n address: Address,\n payload: &TypedData,\n ) -> Result {\n let mut signer =\n self.accounts.get(&address).ok_or(BlockchainError::NoSignerAvailable)?.to_owned();\n\n // Explicitly set chainID as none, to avoid any EIP-155 application to `v` when signing\n // typed data.\n signer.set_chain_id(None);\n\n Ok(signer.sign_dynamic_typed_data(payload).await?)\n }\n\n async fn sign_hash(&self, address: Address, hash: B256) -> Result {\n let signer = self.accounts.get(&address).ok_or(BlockchainError::NoSignerAvailable)?;\n\n Ok(signer.sign_hash(&hash).await?)\n }\n}\n\nimpl Signer for DevSigner {\n fn sign_transaction_from(\n &self,\n sender: &Address,\n tx: FoundryTypedTx,\n ) -> Result {\n let signer = self.accounts.get(sender).ok_or(BlockchainError::NoSignerAvailable)?;\n let envelope = match tx {\n FoundryTypedTx::Legacy(mut t) => {\n let sig = signer.sign_transaction_sync(&mut t)?;\n FoundryTxEnvelope::Legacy(t.into_signed(sig))\n }\n FoundryTypedTx::Eip2930(mut t) => {\n let sig = signer.sign_transaction_sync(&mut t)?;\n FoundryTxEnvelope::Eip2930(t.into_signed(sig))\n }\n FoundryTypedTx::Eip1559(mut t) => {\n let sig = signer.sign_transaction_sync(&mut t)?;\n FoundryTxEnvelope::Eip1559(t.into_signed(sig))\n }\n FoundryTypedTx::Eip7702(mut t) => {\n let sig = signer.sign_transaction_sync(&mut t)?;\n FoundryTxEnvelope::Eip7702(t.into_signed(sig))\n }\n FoundryTypedTx::Eip4844(mut t) => {\n let sig = signer.sign_transaction_sync(&mut t)?;\n FoundryTxEnvelope::Eip4844(t.into_signed(sig))\n }\n FoundryTypedTx::Deposit(_) => {\n unreachable!(\"op deposit txs should not be signed\")\n }\n FoundryTypedTx::Tempo(mut t) => {\n let sig = signer.sign_transaction_sync(&mut t)?;\n FoundryTxEnvelope::Tempo(t.into_signed(sig.into()))\n }\n };\n Ok(envelope)\n }\n}\n\n/// Builds a TxEnvelope from UnsignedTx with a zeroed signature.\n///\n/// Used for impersonated accounts, where transactions are accepted without a valid signature.\npub fn build_impersonated(typed_tx: FoundryTypedTx) -> FoundryTxEnvelope {\n let signature = Signature::new(Default::default(), Default::default(), false);\n match typed_tx {\n FoundryTypedTx::Legacy(tx) => FoundryTxEnvelope::Legacy(tx.into_signed(signature)),\n FoundryTypedTx::Eip2930(tx) => FoundryTxEnvelope::Eip2930(tx.into_signed(signature)),\n FoundryTypedTx::Eip1559(tx) => FoundryTxEnvelope::Eip1559(tx.into_signed(signature)),\n FoundryTypedTx::Eip7702(tx) => FoundryTxEnvelope::Eip7702(tx.into_signed(signature)),\n FoundryTypedTx::Eip4844(tx) => FoundryTxEnvelope::Eip4844(tx.into_signed(signature)),\n FoundryTypedTx::Deposit(tx) => FoundryTxEnvelope::Deposit(Sealed::new(tx)),\n FoundryTypedTx::Tempo(tx) => {\n let tempo_sig: TempoSignature = signature.into();\n FoundryTxEnvelope::Tempo(tx.into_signed(tempo_sig))\n }\n }\n}\n" }, { "path": "crates/anvil/src/eth/util.rs", "content": "use alloy_primitives::hex;\nuse itertools::Itertools;\n\n/// Formats values as hex strings, separated by commas.\npub fn hex_fmt_many(i: I) -> String\nwhere\n I: IntoIterator,\n T: AsRef<[u8]>,\n{\n let items = i.into_iter().map(|item| hex::encode(item.as_ref())).format(\", \");\n format!(\"{items}\")\n}\n" }, { "path": "crates/anvil/src/evm.rs", "content": "use alloy_evm::precompiles::DynPrecompile;\nuse alloy_primitives::Address;\nuse std::fmt::Debug;\n\n/// Object-safe trait that enables injecting extra precompiles when using\n/// `anvil` as a library.\npub trait PrecompileFactory: Send + Sync + Unpin + Debug {\n /// Returns a set of precompiles to extend the EVM with.\n fn precompiles(&self) -> Vec<(Address, DynPrecompile)>;\n}\n\n#[cfg(test)]\nmod tests {\n use std::convert::Infallible;\n\n use crate::PrecompileFactory;\n use alloy_evm::{\n EthEvm, Evm,\n eth::EthEvmContext,\n precompiles::{DynPrecompile, PrecompilesMap},\n };\n use alloy_op_evm::OpEvm;\n use alloy_primitives::{Address, Bytes, TxKind, U256, address};\n use foundry_evm::core::either_evm::EitherEvm;\n use itertools::Itertools;\n use op_revm::{L1BlockInfo, OpContext, OpSpecId, OpTransaction, precompiles::OpPrecompiles};\n use revm::{\n Journal,\n context::{BlockEnv, CfgEnv, Evm as RevmEvm, JournalTr, LocalContext, TxEnv},\n database::{EmptyDB, EmptyDBTyped},\n handler::{EthPrecompiles, instructions::EthInstructions},\n inspector::NoOpInspector,\n interpreter::interpreter::EthInterpreter,\n precompile::{PrecompileOutput, PrecompileSpecId, Precompiles},\n primitives::hardfork::SpecId,\n };\n\n // A precompile activated in the `Prague` spec (BLS12-381 G2 map).\n const ETH_PRAGUE_PRECOMPILE: Address = address!(\"0x0000000000000000000000000000000000000011\");\n\n // A precompile activated in the `Osaka` spec (EIP-7951).\n const ETH_OSAKA_PRECOMPILE: Address = address!(\"0x0000000000000000000000000000000000000100\");\n\n // A precompile activated in the `Isthmus` spec.\n const OP_ISTHMUS_PRECOMPILE: Address = address!(\"0x0000000000000000000000000000000000000100\");\n\n // A custom precompile address and payload for testing.\n const PRECOMPILE_ADDR: Address = address!(\"0x0000000000000000000000000000000000000071\");\n const PAYLOAD: &[u8] = &[0xde, 0xad, 0xbe, 0xef];\n\n #[derive(Debug)]\n struct CustomPrecompileFactory;\n\n impl PrecompileFactory for CustomPrecompileFactory {\n fn precompiles(&self) -> Vec<(Address, DynPrecompile)> {\n use alloy_evm::precompiles::PrecompileInput;\n vec![(\n PRECOMPILE_ADDR,\n DynPrecompile::from(|input: PrecompileInput<'_>| {\n Ok(PrecompileOutput {\n bytes: Bytes::copy_from_slice(input.data),\n gas_used: 0,\n gas_refunded: 0,\n reverted: false,\n })\n }),\n )]\n }\n }\n\n /// Creates a new EVM instance with the custom precompile factory.\n fn create_eth_evm(\n spec: SpecId,\n ) -> (TxEnv, EitherEvm, NoOpInspector, PrecompilesMap>) {\n let tx_env = TxEnv {\n kind: TxKind::Call(PRECOMPILE_ADDR),\n data: PAYLOAD.into(),\n ..Default::default()\n };\n\n let eth_evm_context = EthEvmContext {\n journaled_state: Journal::new(EmptyDB::default()),\n block: BlockEnv::default(),\n cfg: CfgEnv::new_with_spec(spec),\n tx: tx_env.clone(),\n chain: (),\n local: LocalContext::default(),\n error: Ok(()),\n };\n\n let eth_precompiles = EthPrecompiles {\n precompiles: Precompiles::new(PrecompileSpecId::from_spec_id(spec)),\n spec,\n }\n .precompiles;\n let eth_evm = EitherEvm::Eth(EthEvm::new(\n RevmEvm::new_with_inspector(\n eth_evm_context,\n NoOpInspector,\n EthInstructions::>::default(),\n PrecompilesMap::from_static(eth_precompiles),\n ),\n true,\n ));\n\n (tx_env, eth_evm)\n }\n\n /// Creates a new OP EVM instance with the custom precompile factory.\n fn create_op_evm(\n spec: SpecId,\n op_spec: OpSpecId,\n ) -> (OpTransaction, EitherEvm, NoOpInspector, PrecompilesMap>)\n {\n let tx = OpTransaction:: {\n base: TxEnv {\n kind: TxKind::Call(PRECOMPILE_ADDR),\n data: PAYLOAD.into(),\n ..Default::default()\n },\n ..Default::default()\n };\n\n let mut chain = L1BlockInfo::default();\n\n if op_spec == OpSpecId::ISTHMUS {\n chain.operator_fee_constant = Some(U256::from(0));\n chain.operator_fee_scalar = Some(U256::from(0));\n }\n\n let op_cfg: CfgEnv = CfgEnv::new_with_spec(op_spec);\n let op_evm_context = OpContext {\n journaled_state: {\n let mut journal = Journal::new(EmptyDB::default());\n // Converting SpecId into OpSpecId\n journal.set_spec_id(spec);\n journal\n },\n block: BlockEnv::default(),\n cfg: op_cfg.clone(),\n tx: tx.clone(),\n chain,\n local: LocalContext::default(),\n error: Ok(()),\n };\n\n let op_precompiles = OpPrecompiles::new_with_spec(op_cfg.spec).precompiles();\n let op_evm = EitherEvm::Op(OpEvm::new(\n op_revm::OpEvm(RevmEvm::new_with_inspector(\n op_evm_context,\n NoOpInspector,\n EthInstructions::>::default(),\n PrecompilesMap::from_static(op_precompiles),\n )),\n true,\n ));\n\n (tx, op_evm)\n }\n\n #[test]\n fn build_eth_evm_with_extra_precompiles_osaka_spec() {\n let (tx_env, mut evm) = create_eth_evm(SpecId::OSAKA);\n\n // Check that the Osaka precompile IS present when using the Osaka spec.\n assert!(evm.precompiles().addresses().contains(Ð_OSAKA_PRECOMPILE));\n\n // Check that the Prague precompile IS present when using the Osaka spec.\n assert!(evm.precompiles().addresses().contains(Ð_PRAGUE_PRECOMPILE));\n\n assert!(!evm.precompiles().addresses().contains(&PRECOMPILE_ADDR));\n\n evm.precompiles_mut().extend_precompiles(CustomPrecompileFactory.precompiles());\n\n assert!(evm.precompiles().addresses().contains(&PRECOMPILE_ADDR));\n\n let result = match &mut evm {\n EitherEvm::Eth(eth_evm) => eth_evm.transact(tx_env).unwrap(),\n _ => unreachable!(),\n };\n\n assert!(result.result.is_success());\n assert_eq!(result.result.output(), Some(&PAYLOAD.into()));\n }\n\n #[test]\n fn build_eth_evm_with_extra_precompiles_london_spec() {\n let (tx_env, mut evm) = create_eth_evm(SpecId::LONDON);\n\n // Check that the Osaka precompile IS NOT present when using the London spec.\n assert!(!evm.precompiles().addresses().contains(Ð_OSAKA_PRECOMPILE));\n\n // Check that the Prague precompile IS NOT present when using the London spec.\n assert!(!evm.precompiles().addresses().contains(Ð_PRAGUE_PRECOMPILE));\n\n assert!(!evm.precompiles().addresses().contains(&PRECOMPILE_ADDR));\n\n evm.precompiles_mut().extend_precompiles(CustomPrecompileFactory.precompiles());\n\n assert!(evm.precompiles().addresses().contains(&PRECOMPILE_ADDR));\n\n let result = match &mut evm {\n EitherEvm::Eth(eth_evm) => eth_evm.transact(tx_env).unwrap(),\n _ => unreachable!(),\n };\n\n assert!(result.result.is_success());\n assert_eq!(result.result.output(), Some(&PAYLOAD.into()));\n }\n\n #[test]\n fn build_eth_evm_with_extra_precompiles_prague_spec() {\n let (tx_env, mut evm) = create_eth_evm(SpecId::PRAGUE);\n\n // Check that the Osaka precompile IS NOT present when using the Prague spec.\n assert!(!evm.precompiles().addresses().contains(Ð_OSAKA_PRECOMPILE));\n\n // Check that the Prague precompile IS present when using the Prague spec.\n assert!(evm.precompiles().addresses().contains(Ð_PRAGUE_PRECOMPILE));\n\n assert!(!evm.precompiles().addresses().contains(&PRECOMPILE_ADDR));\n\n evm.precompiles_mut().extend_precompiles(CustomPrecompileFactory.precompiles());\n\n assert!(evm.precompiles().addresses().contains(&PRECOMPILE_ADDR));\n\n let result = match &mut evm {\n EitherEvm::Eth(eth_evm) => eth_evm.transact(tx_env).unwrap(),\n _ => unreachable!(),\n };\n\n assert!(result.result.is_success());\n assert_eq!(result.result.output(), Some(&PAYLOAD.into()));\n }\n\n #[test]\n fn build_op_evm_with_extra_precompiles_isthmus_spec() {\n let (tx, mut evm) = create_op_evm(SpecId::OSAKA, OpSpecId::ISTHMUS);\n\n // Check that the Isthmus precompile IS present when using the Isthmus spec.\n assert!(evm.precompiles().addresses().contains(&OP_ISTHMUS_PRECOMPILE));\n\n // Check that the Prague precompile IS present when using the Isthmus spec.\n assert!(evm.precompiles().addresses().contains(Ð_PRAGUE_PRECOMPILE));\n\n assert!(!evm.precompiles().addresses().contains(&PRECOMPILE_ADDR));\n\n evm.precompiles_mut().extend_precompiles(CustomPrecompileFactory.precompiles());\n\n assert!(evm.precompiles().addresses().contains(&PRECOMPILE_ADDR));\n\n let result = match &mut evm {\n EitherEvm::Op(op_evm) => op_evm.transact(tx).unwrap(),\n _ => unreachable!(),\n };\n\n assert!(result.result.is_success());\n assert_eq!(result.result.output(), Some(&PAYLOAD.into()));\n }\n\n #[test]\n fn build_op_evm_with_extra_precompiles_bedrock_spec() {\n let (tx, mut evm) = create_op_evm(SpecId::OSAKA, OpSpecId::BEDROCK);\n\n // Check that the Isthmus precompile IS NOT present when using the `OpSpecId::BEDROCK` spec.\n assert!(!evm.precompiles().addresses().contains(&OP_ISTHMUS_PRECOMPILE));\n\n // Check that the Prague precompile IS NOT present when using the `OpSpecId::BEDROCK` spec.\n assert!(!evm.precompiles().addresses().contains(Ð_PRAGUE_PRECOMPILE));\n\n assert!(!evm.precompiles().addresses().contains(&PRECOMPILE_ADDR));\n\n evm.precompiles_mut().extend_precompiles(CustomPrecompileFactory.precompiles());\n\n assert!(evm.precompiles().addresses().contains(&PRECOMPILE_ADDR));\n\n let result = match &mut evm {\n EitherEvm::Op(op_evm) => op_evm.transact(tx).unwrap(),\n _ => unreachable!(),\n };\n\n assert!(result.result.is_success());\n assert_eq!(result.result.output(), Some(&PAYLOAD.into()));\n }\n}\n" }, { "path": "crates/anvil/src/filter.rs", "content": "//! Support for polling based filters\nuse crate::{\n StorageInfo,\n eth::{backend::notifications::NewBlockNotifications, error::ToRpcResponseResult},\n pubsub::filter_logs,\n};\nuse alloy_consensus::TxReceipt;\nuse alloy_network::Network;\nuse alloy_primitives::{TxHash, map::HashMap};\nuse alloy_rpc_types::{Filter, FilteredParams, Log};\nuse anvil_core::eth::subscription::SubscriptionId;\nuse anvil_rpc::{\n error::{ErrorCode, RpcError},\n response::ResponseResult,\n};\nuse futures::{Stream, StreamExt, channel::mpsc::Receiver};\nuse std::{\n pin::Pin,\n sync::Arc,\n task::{Context, Poll},\n time::{Duration, Instant},\n};\nuse tokio::sync::Mutex;\n\n/// Type alias for filters identified by their id and their expiration timestamp\ntype FilterMap = Arc, Instant)>>>;\n\n/// timeout after which to remove an active filter if it wasn't polled since then\npub const ACTIVE_FILTER_TIMEOUT_SECS: u64 = 60 * 5;\n\n/// Contains all registered filters\npub struct Filters {\n /// all currently active filters\n active_filters: FilterMap,\n /// How long we keep a live the filter after the last poll\n keepalive: Duration,\n}\n\nimpl Clone for Filters {\n fn clone(&self) -> Self {\n Self { active_filters: self.active_filters.clone(), keepalive: self.keepalive }\n }\n}\n\nimpl std::fmt::Debug for Filters {\n fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {\n f.debug_struct(\"Filters\").field(\"keepalive\", &self.keepalive).finish_non_exhaustive()\n }\n}\n\nimpl Filters {\n /// Adds a new `EthFilter` to the set\n pub async fn add_filter(&self, filter: EthFilter) -> String {\n let id = new_id();\n trace!(target: \"node::filter\", \"Adding new filter id {}\", id);\n let mut filters = self.active_filters.lock().await;\n filters.insert(id.clone(), (filter, self.next_deadline()));\n id\n }\n\n /// Returns the original `Filter` of an `eth_newFilter`\n pub async fn get_log_filter(&self, id: &str) -> Option {\n let filters = self.active_filters.lock().await;\n if let Some((EthFilter::Logs(log), _)) = filters.get(id) {\n return log.filter.filter.clone();\n }\n None\n }\n\n /// Removes the filter identified with the `id`\n pub async fn uninstall_filter(&self, id: &str) -> Option> {\n trace!(target: \"node::filter\", \"Uninstalling filter id {}\", id);\n self.active_filters.lock().await.remove(id).map(|(f, _)| f)\n }\n\n /// The duration how long to keep alive stale filters\n pub fn keep_alive(&self) -> Duration {\n self.keepalive\n }\n\n /// Returns the timestamp after which a filter should expire\n fn next_deadline(&self) -> Instant {\n Instant::now() + self.keep_alive()\n }\n\n /// Evict all filters that weren't updated and reached there deadline\n pub async fn evict(&self) {\n trace!(target: \"node::filter\", \"Evicting stale filters\");\n let now = Instant::now();\n let mut active_filters = self.active_filters.lock().await;\n active_filters.retain(|id, (_, deadline)| {\n if now > *deadline {\n trace!(target: \"node::filter\",?id, \"Evicting stale filter\");\n return false;\n }\n true\n });\n }\n}\n\nimpl Filters\nwhere\n N::ReceiptEnvelope: TxReceipt + Clone,\n{\n pub async fn get_filter_changes(&self, id: &str) -> ResponseResult {\n {\n let mut filters = self.active_filters.lock().await;\n if let Some((filter, deadline)) = filters.get_mut(id) {\n let resp = filter\n .next()\n .await\n .unwrap_or_else(|| ResponseResult::success(Vec::<()>::new()));\n *deadline = self.next_deadline();\n return resp;\n }\n }\n warn!(target: \"node::filter\", \"No filter found for {}\", id);\n ResponseResult::error(RpcError {\n code: ErrorCode::ServerError(-32000),\n message: \"filter not found\".into(),\n data: None,\n })\n }\n}\n\nimpl Default for Filters {\n fn default() -> Self {\n Self {\n active_filters: Arc::new(Default::default()),\n keepalive: Duration::from_secs(ACTIVE_FILTER_TIMEOUT_SECS),\n }\n }\n}\n\n/// returns a new random hex id\nfn new_id() -> String {\n SubscriptionId::random_hex().to_string()\n}\n\n/// Represents a poll based filter\npub enum EthFilter {\n Logs(Box>),\n Blocks(NewBlockNotifications),\n PendingTransactions(Receiver),\n}\n\nimpl std::fmt::Debug for EthFilter {\n fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {\n match self {\n Self::Logs(_) => f.debug_tuple(\"Logs\").finish(),\n Self::Blocks(_) => f.debug_tuple(\"Blocks\").finish(),\n Self::PendingTransactions(_) => f.debug_tuple(\"PendingTransactions\").finish(),\n }\n }\n}\n\nimpl Stream for EthFilter\nwhere\n N::ReceiptEnvelope: TxReceipt + Clone,\n{\n type Item = ResponseResult;\n\n fn poll_next(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll> {\n let pin = self.get_mut();\n match pin {\n Self::Logs(logs) => Poll::Ready(Some(Ok(logs.poll(cx)).to_rpc_result())),\n Self::Blocks(blocks) => {\n let mut new_blocks = Vec::new();\n while let Poll::Ready(Some(block)) = blocks.poll_next_unpin(cx) {\n new_blocks.push(block.hash);\n }\n Poll::Ready(Some(Ok(new_blocks).to_rpc_result()))\n }\n Self::PendingTransactions(tx) => {\n let mut new_txs = Vec::new();\n while let Poll::Ready(Some(tx_hash)) = tx.poll_next_unpin(cx) {\n new_txs.push(tx_hash);\n }\n Poll::Ready(Some(Ok(new_txs).to_rpc_result()))\n }\n }\n }\n}\n\n/// Listens for new blocks and matching logs emitted in that block\npub struct LogsFilter {\n /// listener for new blocks\n pub blocks: NewBlockNotifications,\n /// accessor for block storage\n pub storage: StorageInfo,\n /// matcher with all provided filter params\n pub filter: FilteredParams,\n /// existing logs that matched the filter when the listener was installed\n ///\n /// They'll be returned on the first poll\n pub historic: Option>,\n}\n\nimpl std::fmt::Debug for LogsFilter {\n fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {\n f.debug_struct(\"LogsFilter\").field(\"filter\", &self.filter).finish_non_exhaustive()\n }\n}\n\nimpl LogsFilter\nwhere\n N::ReceiptEnvelope: TxReceipt + Clone,\n{\n /// Returns all the logs since the last time this filter was polled\n pub fn poll(&mut self, cx: &mut Context<'_>) -> Vec {\n let mut logs = self.historic.take().unwrap_or_default();\n while let Poll::Ready(Some(block)) = self.blocks.poll_next_unpin(cx) {\n let b = self.storage.block(block.hash);\n let receipts = self.storage.receipts(block.hash);\n if let (Some(receipts), Some(block)) = (receipts, b) {\n logs.extend(filter_logs(block, receipts, &self.filter))\n }\n }\n logs\n }\n}\n" }, { "path": "crates/anvil/src/lib.rs", "content": "//! Anvil is a fast local Ethereum development node.\n\n#![cfg_attr(not(test), warn(unused_crate_dependencies))]\n#![cfg_attr(docsrs, feature(doc_cfg))]\n\nuse crate::{\n error::{NodeError, NodeResult},\n eth::{\n EthApi,\n backend::{info::StorageInfo, mem},\n fees::{FeeHistoryService, FeeManager},\n miner::{Miner, MiningMode},\n pool::Pool,\n sign::{DevSigner, Signer as EthSigner},\n },\n filter::Filters,\n logging::{LoggingManager, NodeLogLayer},\n service::NodeService,\n shutdown::Signal,\n tasks::TaskManager,\n};\nuse alloy_eips::eip7840::BlobParams;\nuse alloy_primitives::{Address, U256};\nuse alloy_signer_local::PrivateKeySigner;\nuse eth::backend::fork::ClientFork;\nuse eyre::{Result, WrapErr};\nuse foundry_common::provider::{ProviderBuilder, RetryProvider};\npub use foundry_evm::hardfork::EthereumHardfork;\nuse foundry_primitives::FoundryNetwork;\nuse futures::{FutureExt, TryFutureExt};\nuse parking_lot::Mutex;\nuse revm::primitives::hardfork::SpecId;\nuse server::try_spawn_ipc;\nuse std::{\n net::SocketAddr,\n pin::Pin,\n sync::Arc,\n task::{Context, Poll},\n};\nuse tokio::{\n runtime::Handle,\n task::{JoinError, JoinHandle},\n};\nuse tracing_subscriber::EnvFilter;\n\n/// contains the background service that drives the node\nmod service;\n\nmod config;\npub use config::{\n AccountGenerator, CHAIN_ID, DEFAULT_GAS_LIMIT, ForkChoice, NodeConfig, VERSION_MESSAGE,\n};\n\nmod error;\n/// ethereum related implementations\npub mod eth;\n/// Evm related abstractions\nmod evm;\npub use evm::PrecompileFactory;\n\n/// support for polling filters\npub mod filter;\n/// commandline output\npub mod logging;\n/// types for subscriptions\npub mod pubsub;\n/// axum RPC server implementations\npub mod server;\n/// Futures for shutdown signal\nmod shutdown;\n/// additional task management\nmod tasks;\n\n/// contains cli command\n#[cfg(feature = \"cmd\")]\npub mod cmd;\n\n#[cfg(feature = \"cmd\")]\npub mod args;\n\n#[cfg(feature = \"cmd\")]\npub mod opts;\n\n#[macro_use]\nextern crate foundry_common;\n\n#[macro_use]\nextern crate tracing;\n\n/// Creates the node and runs the server.\n///\n/// Returns the [EthApi] that can be used to interact with the node and the [JoinHandle] of the\n/// task.\n///\n/// # Panics\n///\n/// Panics if any error occurs. For a non-panicking version, use [`try_spawn`].\n///\n///\n/// # Examples\n///\n/// ```no_run\n/// # use anvil::NodeConfig;\n/// # async fn spawn() -> eyre::Result<()> {\n/// let config = NodeConfig::default();\n/// let (api, handle) = anvil::spawn(config).await;\n///\n/// // use api\n///\n/// // wait forever\n/// handle.await.unwrap().unwrap();\n/// # Ok(())\n/// # }\n/// ```\npub async fn spawn(config: NodeConfig) -> (EthApi, NodeHandle) {\n try_spawn(config).await.expect(\"failed to spawn node\")\n}\n\n/// Creates the node and runs the server\n///\n/// Returns the [EthApi] that can be used to interact with the node and the [JoinHandle] of the\n/// task.\n///\n/// # Examples\n///\n/// ```no_run\n/// # use anvil::NodeConfig;\n/// # async fn spawn() -> eyre::Result<()> {\n/// let config = NodeConfig::default();\n/// let (api, handle) = anvil::try_spawn(config).await?;\n///\n/// // use api\n///\n/// // wait forever\n/// handle.await??;\n/// # Ok(())\n/// # }\n/// ```\npub async fn try_spawn(mut config: NodeConfig) -> Result<(EthApi, NodeHandle)> {\n let logger = if config.enable_tracing { init_tracing() } else { Default::default() };\n logger.set_enabled(!config.silent);\n\n let backend = config.setup::().await?;\n\n if let Some(state) = config.init_state.clone() {\n backend.load_state(state).await.wrap_err(\"failed to load init state\")?;\n }\n\n let backend = Arc::new(backend);\n\n if config.enable_auto_impersonate {\n backend.auto_impersonate_account(true);\n }\n\n let fork = backend.get_fork();\n\n let NodeConfig {\n signer_accounts,\n block_time,\n port,\n max_transactions,\n server_config,\n no_mining,\n transaction_order,\n genesis,\n mixed_mining,\n ..\n } = config.clone();\n\n let pool = Arc::new(Pool::default());\n\n let mode = if let Some(block_time) = block_time {\n if mixed_mining {\n let listener = pool.add_ready_listener();\n MiningMode::mixed(max_transactions, listener, block_time)\n } else {\n MiningMode::interval(block_time)\n }\n } else if no_mining {\n MiningMode::None\n } else {\n // get a listener for ready transactions\n let listener = pool.add_ready_listener();\n MiningMode::instant(max_transactions, listener)\n };\n\n let miner = match &fork {\n Some(fork) => {\n Miner::new(mode).with_forced_transactions(fork.config.read().force_transactions.clone())\n }\n _ => Miner::new(mode),\n };\n\n let dev_signer: Box> =\n Box::new(DevSigner::new(signer_accounts));\n let mut signers = vec![dev_signer];\n if let Some(genesis) = genesis {\n let genesis_signers = genesis\n .alloc\n .values()\n .filter_map(|acc| acc.private_key)\n .flat_map(|k| PrivateKeySigner::from_bytes(&k))\n .collect::>();\n if !genesis_signers.is_empty() {\n signers.push(Box::new(DevSigner::new(genesis_signers)));\n }\n }\n\n let fee_history_cache = Arc::new(Mutex::new(Default::default()));\n let fee_history_service = FeeHistoryService::new(\n match backend.spec_id() {\n SpecId::OSAKA => BlobParams::osaka(),\n SpecId::PRAGUE => BlobParams::prague(),\n _ => BlobParams::cancun(),\n },\n backend.new_block_notifications(),\n Arc::clone(&fee_history_cache),\n StorageInfo::new(Arc::clone(&backend)),\n );\n // create an entry for the best block\n if let Some(header) = backend.get_block(backend.best_number()).map(|block| block.header) {\n fee_history_service.insert_cache_entry_for_block(header.hash_slow(), &header);\n }\n\n let filters = Filters::default();\n\n // create the cloneable api wrapper\n let api = EthApi::new(\n Arc::clone(&pool),\n Arc::clone(&backend),\n Arc::new(signers),\n fee_history_cache,\n fee_history_service.fee_history_limit(),\n miner.clone(),\n logger,\n filters.clone(),\n transaction_order,\n );\n\n // spawn the node service\n let node_service =\n tokio::task::spawn(NodeService::new(pool, backend, miner, fee_history_service, filters));\n\n let mut servers = Vec::with_capacity(config.host.len());\n let mut addresses = Vec::with_capacity(config.host.len());\n\n for addr in &config.host {\n let sock_addr = SocketAddr::new(*addr, port);\n\n // Create a TCP listener.\n let tcp_listener = tokio::net::TcpListener::bind(sock_addr).await?;\n addresses.push(tcp_listener.local_addr()?);\n\n // Spawn the server future on a new task.\n let srv = server::serve_on(tcp_listener, api.clone(), server_config.clone());\n servers.push(tokio::task::spawn(srv.map_err(Into::into)));\n }\n\n let tokio_handle = Handle::current();\n let (signal, on_shutdown) = shutdown::signal();\n let task_manager = TaskManager::new(tokio_handle, on_shutdown);\n\n let ipc_task =\n config.get_ipc_path().map(|path| try_spawn_ipc(api.clone(), path)).transpose()?;\n\n let handle = NodeHandle {\n config,\n node_service,\n servers,\n ipc_task,\n addresses,\n _signal: Some(signal),\n task_manager,\n };\n\n handle.print(fork.as_ref())?;\n\n Ok((api, handle))\n}\n\ntype IpcTask = JoinHandle<()>;\n\n/// A handle to the spawned node and server tasks.\n///\n/// This future will resolve if either the node or server task resolve/fail.\npub struct NodeHandle {\n config: NodeConfig,\n /// The address of the running rpc server.\n addresses: Vec,\n /// Join handle for the Node Service.\n pub node_service: JoinHandle>,\n /// Join handles (one per socket) for the Anvil server.\n pub servers: Vec>>,\n /// The future that joins the ipc server, if any.\n ipc_task: Option,\n /// A signal that fires the shutdown, fired on drop.\n _signal: Option,\n /// A task manager that can be used to spawn additional tasks.\n task_manager: TaskManager,\n}\n\nimpl Drop for NodeHandle {\n fn drop(&mut self) {\n // Fire shutdown signal to make sure anvil instance is terminated.\n if let Some(signal) = self._signal.take() {\n let _ = signal.fire();\n }\n }\n}\n\nimpl NodeHandle {\n /// The [NodeConfig] the node was launched with.\n pub fn config(&self) -> &NodeConfig {\n &self.config\n }\n\n /// Prints the launch info.\n pub(crate) fn print(&self, fork: Option<&ClientFork>) -> Result<()> {\n self.config.print(fork)?;\n if !self.config.silent {\n if let Some(ipc_path) = self.ipc_path() {\n sh_println!(\"IPC path: {ipc_path}\")?;\n }\n sh_println!(\n \"Listening on {}\",\n self.addresses\n .iter()\n .map(|addr| { addr.to_string() })\n .collect::>()\n .join(\", \")\n )?;\n }\n Ok(())\n }\n\n /// The address of the launched server.\n ///\n /// **N.B.** this may not necessarily be the same `host + port` as configured in the\n /// `NodeConfig`, if port was set to 0, then the OS auto picks an available port.\n pub fn socket_address(&self) -> &SocketAddr {\n &self.addresses[0]\n }\n\n /// Returns the http endpoint.\n pub fn http_endpoint(&self) -> String {\n format!(\"http://{}\", self.socket_address())\n }\n\n /// Returns the websocket endpoint.\n pub fn ws_endpoint(&self) -> String {\n format!(\"ws://{}\", self.socket_address())\n }\n\n /// Returns the path of the launched ipc server, if any.\n pub fn ipc_path(&self) -> Option {\n self.config.get_ipc_path()\n }\n\n /// Constructs a [`RetryProvider`] for this handle's HTTP endpoint.\n pub fn http_provider(&self) -> RetryProvider {\n ProviderBuilder::new(&self.http_endpoint()).build().expect(\"failed to build HTTP provider\")\n }\n\n /// Constructs a [`RetryProvider`] for this handle's WS endpoint.\n pub fn ws_provider(&self) -> RetryProvider {\n ProviderBuilder::new(&self.ws_endpoint()).build().expect(\"failed to build WS provider\")\n }\n\n /// Constructs a [`RetryProvider`] for this handle's IPC endpoint, if any.\n pub fn ipc_provider(&self) -> Option {\n ProviderBuilder::new(&self.config.get_ipc_path()?).build().ok()\n }\n\n /// Signer accounts that can sign messages/transactions from the EVM node.\n pub fn dev_accounts(&self) -> impl Iterator + '_ {\n self.config.signer_accounts.iter().map(|wallet| wallet.address())\n }\n\n /// Signer accounts that can sign messages/transactions from the EVM node.\n pub fn dev_wallets(&self) -> impl Iterator + '_ {\n self.config.signer_accounts.iter().cloned()\n }\n\n /// Accounts that will be initialised with `genesis_balance` in the genesis block.\n pub fn genesis_accounts(&self) -> impl Iterator + '_ {\n self.config.genesis_accounts.iter().map(|w| w.address())\n }\n\n /// Native token balance of every genesis account in the genesis block.\n pub fn genesis_balance(&self) -> U256 {\n self.config.genesis_balance\n }\n\n /// Default gas price for all txs.\n pub fn gas_price(&self) -> u128 {\n self.config.get_gas_price()\n }\n\n /// Returns the shutdown signal.\n pub fn shutdown_signal(&self) -> &Option {\n &self._signal\n }\n\n /// Returns mutable access to the shutdown signal.\n ///\n /// This can be used to extract the Signal.\n pub fn shutdown_signal_mut(&mut self) -> &mut Option {\n &mut self._signal\n }\n\n /// Returns the task manager that can be used to spawn new tasks.\n ///\n /// ```\n /// use anvil::NodeHandle;\n /// # fn t(handle: NodeHandle) {\n /// let task_manager = handle.task_manager();\n /// let on_shutdown = task_manager.on_shutdown();\n ///\n /// task_manager.spawn(async move {\n /// on_shutdown.await;\n /// // do something\n /// });\n ///\n /// # }\n /// ```\n pub fn task_manager(&self) -> &TaskManager {\n &self.task_manager\n }\n}\n\nimpl Future for NodeHandle {\n type Output = Result, JoinError>;\n\n fn poll(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll {\n let pin = self.get_mut();\n\n // poll the ipc task\n if let Some(mut ipc) = pin.ipc_task.take() {\n if let Poll::Ready(res) = ipc.poll_unpin(cx) {\n return Poll::Ready(res.map(|()| Ok(())));\n } else {\n pin.ipc_task = Some(ipc);\n }\n }\n\n // poll the node service task\n if let Poll::Ready(res) = pin.node_service.poll_unpin(cx) {\n return Poll::Ready(res);\n }\n\n // poll the axum server handles\n for server in &mut pin.servers {\n if let Poll::Ready(res) = server.poll_unpin(cx) {\n return Poll::Ready(res);\n }\n }\n\n Poll::Pending\n }\n}\n\n#[doc(hidden)]\npub fn init_tracing() -> LoggingManager {\n use tracing_subscriber::prelude::*;\n\n let manager = LoggingManager::default();\n\n let _ = if let Ok(rust_log_val) = std::env::var(\"RUST_LOG\")\n && !rust_log_val.contains(\"=\")\n {\n // Mutate the given filter to include `node` logs if it is not already present.\n // This prevents the unexpected behaviour of not seeing any node logs if a RUST_LOG\n // is already present that doesn't set it.\n let rust_log_val = if !rust_log_val.contains(\"node\") {\n format!(\"{rust_log_val},node=info\")\n } else {\n rust_log_val\n };\n\n let env_filter: EnvFilter =\n rust_log_val.parse().expect(\"failed to parse modified RUST_LOG\");\n tracing_subscriber::registry()\n .with(env_filter)\n .with(tracing_subscriber::fmt::layer())\n .try_init()\n } else {\n tracing_subscriber::Registry::default()\n .with(NodeLogLayer::new(manager.clone()))\n .with(\n tracing_subscriber::fmt::layer()\n .without_time()\n .with_target(false)\n .with_level(false),\n )\n .try_init()\n };\n\n manager\n}\n" }, { "path": "crates/anvil/src/logging.rs", "content": "//! User facing Logger\n\nuse parking_lot::RwLock;\nuse std::sync::Arc;\nuse tracing::{Metadata, subscriber::Interest};\nuse tracing_subscriber::{Layer, layer::Context};\n\n/// The target that identifies the events intended to be logged to stdout\npub(crate) const NODE_USER_LOG_TARGET: &str = \"node::user\";\n\n/// The target that identifies the events coming from the `console.log` invocations.\npub(crate) const EVM_CONSOLE_LOG_TARGET: &str = \"node::console\";\n\n/// A logger that listens for node related events and displays them.\n///\n/// This layer is intended to be used as filter for `NODE_USER_LOG_TARGET` events that will\n/// eventually be logged to stdout\n#[derive(Clone, Debug, Default)]\npub struct NodeLogLayer {\n state: LoggingManager,\n}\n\nimpl NodeLogLayer {\n /// Returns a new instance of this layer\n pub fn new(state: LoggingManager) -> Self {\n Self { state }\n }\n}\n\n// use `Layer`'s filter function to globally enable/disable `NODE_USER_LOG_TARGET` events\nimpl Layer for NodeLogLayer\nwhere\n S: tracing::Subscriber,\n{\n fn register_callsite(&self, metadata: &'static Metadata<'static>) -> Interest {\n if metadata.target() == NODE_USER_LOG_TARGET || metadata.target() == EVM_CONSOLE_LOG_TARGET\n {\n Interest::sometimes()\n } else {\n Interest::never()\n }\n }\n\n fn enabled(&self, metadata: &Metadata<'_>, _ctx: Context<'_, S>) -> bool {\n self.state.is_enabled()\n && (metadata.target() == NODE_USER_LOG_TARGET\n || metadata.target() == EVM_CONSOLE_LOG_TARGET)\n }\n}\n\n/// Contains the configuration of the logger\n#[derive(Clone, Debug)]\npub struct LoggingManager {\n /// Whether the logger is currently enabled\n pub enabled: Arc>,\n}\n\nimpl LoggingManager {\n /// Returns true if logging is currently enabled\n pub fn is_enabled(&self) -> bool {\n *self.enabled.read()\n }\n\n /// Updates the `enabled` state\n pub fn set_enabled(&self, enabled: bool) {\n let mut current = self.enabled.write();\n *current = enabled;\n }\n}\n\nimpl Default for LoggingManager {\n fn default() -> Self {\n Self { enabled: Arc::new(RwLock::new(true)) }\n }\n}\n" }, { "path": "crates/anvil/src/opts.rs", "content": "use crate::cmd::NodeArgs;\nuse clap::{Parser, Subcommand};\nuse foundry_cli::opts::GlobalArgs;\nuse foundry_common::version::{LONG_VERSION, SHORT_VERSION};\n\n/// A fast local Ethereum development node.\n#[derive(Parser)]\n#[command(name = \"anvil\", version = SHORT_VERSION, long_version = LONG_VERSION, next_display_order = None)]\npub struct Anvil {\n /// Include the global arguments.\n #[command(flatten)]\n pub global: GlobalArgs,\n\n #[command(flatten)]\n pub node: NodeArgs,\n\n #[command(subcommand)]\n pub cmd: Option,\n}\n\n#[derive(Subcommand)]\npub enum AnvilSubcommand {\n /// Generate shell completions script.\n #[command(visible_alias = \"com\")]\n Completions {\n #[arg(value_enum)]\n shell: foundry_cli::clap::Shell,\n },\n}\n" }, { "path": "crates/anvil/src/pubsub.rs", "content": "use crate::{\n StorageInfo,\n eth::{backend::notifications::NewBlockNotifications, error::to_rpc_result},\n};\nuse alloy_consensus::{BlockHeader, TxReceipt};\nuse alloy_network::{AnyRpcTransaction, Network};\nuse alloy_primitives::{B256, TxHash};\nuse alloy_rpc_types::{FilteredParams, Log, Transaction, pubsub::SubscriptionResult};\nuse anvil_core::eth::{block::Block, subscription::SubscriptionId};\nuse anvil_rpc::{request::Version, response::ResponseResult};\nuse futures::{Stream, StreamExt, channel::mpsc::Receiver, ready};\nuse serde::Serialize;\nuse std::{\n collections::VecDeque,\n pin::Pin,\n task::{Context, Poll},\n};\nuse tokio::sync::mpsc::UnboundedReceiver;\n\n/// Listens for new blocks and matching logs emitted in that block\npub struct LogsSubscription {\n pub blocks: NewBlockNotifications,\n pub storage: StorageInfo,\n pub filter: FilteredParams,\n pub queued: VecDeque,\n pub id: SubscriptionId,\n}\n\nimpl std::fmt::Debug for LogsSubscription {\n fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {\n f.debug_struct(\"LogsSubscription\")\n .field(\"filter\", &self.filter)\n .field(\"id\", &self.id)\n .finish_non_exhaustive()\n }\n}\n\nimpl LogsSubscription\nwhere\n N::ReceiptEnvelope: TxReceipt + Clone,\n{\n fn poll(&mut self, cx: &mut Context<'_>) -> Poll> {\n loop {\n if let Some(log) = self.queued.pop_front() {\n let params = EthSubscriptionParams {\n subscription: self.id.clone(),\n result: to_rpc_result(log),\n };\n return Poll::Ready(Some(EthSubscriptionResponse::new(params)));\n }\n\n if let Some(block) = ready!(self.blocks.poll_next_unpin(cx)) {\n let b = self.storage.block(block.hash);\n let receipts = self.storage.receipts(block.hash);\n if let (Some(receipts), Some(block)) = (receipts, b) {\n let logs = filter_logs(block, receipts, &self.filter);\n if logs.is_empty() {\n // this ensures we poll the receiver until it is pending, in which case the\n // underlying `UnboundedReceiver` will register the new waker, see\n // [`futures::channel::mpsc::UnboundedReceiver::poll_next()`]\n continue;\n }\n self.queued.extend(logs)\n }\n } else {\n return Poll::Ready(None);\n }\n\n if self.queued.is_empty() {\n return Poll::Pending;\n }\n }\n }\n}\n\n#[derive(Clone, Debug, PartialEq, Eq, Serialize)]\npub struct EthSubscriptionResponse {\n jsonrpc: Version,\n method: &'static str,\n params: EthSubscriptionParams,\n}\n\nimpl EthSubscriptionResponse {\n pub fn new(params: EthSubscriptionParams) -> Self {\n Self { jsonrpc: Version::V2, method: \"eth_subscription\", params }\n }\n}\n\n/// Represents the `params` field of an `eth_subscription` event\n#[derive(Clone, Debug, PartialEq, Eq, Serialize)]\npub struct EthSubscriptionParams {\n subscription: SubscriptionId,\n #[serde(flatten)]\n result: ResponseResult,\n}\n\n/// Represents an ethereum Websocket subscription\npub enum EthSubscription {\n Logs(Box>),\n Header(NewBlockNotifications, StorageInfo, SubscriptionId),\n PendingTransactions(Receiver, SubscriptionId),\n FullPendingTransactions(UnboundedReceiver, SubscriptionId),\n}\n\nimpl std::fmt::Debug for EthSubscription {\n fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {\n match self {\n Self::Logs(_) => f.debug_tuple(\"Logs\").finish(),\n Self::Header(..) => f.debug_tuple(\"Header\").finish(),\n Self::PendingTransactions(..) => f.debug_tuple(\"PendingTransactions\").finish(),\n Self::FullPendingTransactions(..) => f.debug_tuple(\"FullPendingTransactions\").finish(),\n }\n }\n}\n\nimpl EthSubscription\nwhere\n N::ReceiptEnvelope: TxReceipt + Clone,\n{\n fn poll_response(&mut self, cx: &mut Context<'_>) -> Poll> {\n match self {\n Self::Logs(listener) => listener.poll(cx),\n Self::Header(blocks, storage, id) => {\n // this loop ensures we poll the receiver until it is pending, in which case the\n // underlying `UnboundedReceiver` will register the new waker, see\n // [`futures::channel::mpsc::UnboundedReceiver::poll_next()`]\n loop {\n if let Some(block) = ready!(blocks.poll_next_unpin(cx)) {\n if let Some(block) = storage.eth_block(block.hash) {\n let params = EthSubscriptionParams {\n subscription: id.clone(),\n result: to_rpc_result(block),\n };\n return Poll::Ready(Some(EthSubscriptionResponse::new(params)));\n }\n } else {\n return Poll::Ready(None);\n }\n }\n }\n Self::PendingTransactions(tx, id) => {\n let res = ready!(tx.poll_next_unpin(cx))\n .map(SubscriptionResult::::TransactionHash)\n .map(to_rpc_result)\n .map(|result| {\n let params = EthSubscriptionParams { subscription: id.clone(), result };\n EthSubscriptionResponse::new(params)\n });\n Poll::Ready(res)\n }\n Self::FullPendingTransactions(tx, id) => {\n let res = ready!(tx.poll_recv(cx)).map(to_rpc_result).map(|result| {\n let params = EthSubscriptionParams { subscription: id.clone(), result };\n EthSubscriptionResponse::new(params)\n });\n Poll::Ready(res)\n }\n }\n }\n}\n\nimpl Stream for EthSubscription\nwhere\n N::ReceiptEnvelope: TxReceipt + Clone,\n{\n type Item = serde_json::Value;\n\n fn poll_next(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll> {\n let pin = self.get_mut();\n match ready!(pin.poll_response(cx)) {\n None => Poll::Ready(None),\n Some(res) => Poll::Ready(Some(serde_json::to_value(res).expect(\"can't fail;\"))),\n }\n }\n}\n\n/// Returns all the logs that match the given filter\npub fn filter_logs(block: Block, receipts: Vec, filter: &FilteredParams) -> Vec\nwhere\n R: TxReceipt,\n{\n /// Determines whether to add this log\n fn add_log(\n block_hash: B256,\n l: &alloy_primitives::Log,\n block: &Block,\n params: &FilteredParams,\n ) -> bool {\n if params.filter.is_some() {\n let block_number = block.header.number();\n if !params.filter_block_range(block_number)\n || !params.filter_block_hash(block_hash)\n || !params.filter_address(&l.address)\n || !params.filter_topics(l.topics())\n {\n return false;\n }\n }\n true\n }\n\n let block_hash = block.header.hash_slow();\n let mut logs = vec![];\n let mut log_index: u32 = 0;\n for (receipt_index, receipt) in receipts.into_iter().enumerate() {\n let transaction_hash = block.body.transactions[receipt_index].hash();\n for log in receipt.logs() {\n if add_log(block_hash, log, &block, filter) {\n logs.push(Log {\n inner: log.clone(),\n block_hash: Some(block_hash),\n block_number: Some(block.header.number()),\n transaction_hash: Some(transaction_hash),\n transaction_index: Some(receipt_index as u64),\n log_index: Some(log_index as u64),\n removed: false,\n block_timestamp: Some(block.header.timestamp()),\n });\n }\n log_index += 1;\n }\n }\n logs\n}\n" }, { "path": "crates/anvil/src/server/beacon/error.rs", "content": "//! Beacon API error types\n\nuse axum::{\n Json,\n http::StatusCode,\n response::{IntoResponse, Response},\n};\nuse serde::{Deserialize, Serialize};\nuse std::{\n borrow::Cow,\n fmt::{self, Display},\n};\n\n/// Represents a Beacon API error response\n#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]\npub struct BeaconError {\n /// HTTP status code\n #[serde(skip)]\n pub status_code: u16,\n /// Error code\n pub code: BeaconErrorCode,\n /// Error message\n pub message: Cow<'static, str>,\n}\n\nimpl BeaconError {\n /// Creates a new beacon error with the given code\n pub fn new(code: BeaconErrorCode, message: impl Into>) -> Self {\n let status_code = code.status_code();\n Self { status_code, code, message: message.into() }\n }\n\n /// Helper function to create a 400 Bad Request error for invalid block ID\n pub fn invalid_block_id(block_id: impl Display) -> Self {\n Self::new(BeaconErrorCode::BadRequest, format!(\"Invalid block ID: {block_id}\"))\n }\n\n /// Helper function to create a 404 Not Found error for block not found\n pub fn block_not_found() -> Self {\n Self::new(BeaconErrorCode::NotFound, \"Block not found\")\n }\n\n /// Helper function to create a 500 Internal Server Error\n pub fn internal_error() -> Self {\n Self::new(BeaconErrorCode::InternalError, \"Internal server error\")\n }\n\n /// Helper function to create a 410 Gone error for deprecated endpoints\n pub fn deprecated_endpoint_with_hint(hint: impl Display) -> Self {\n Self::new(BeaconErrorCode::Gone, format!(\"This endpoint is deprecated. {hint}\"))\n }\n\n /// Converts to an Axum response\n pub fn into_response(self) -> Response {\n let status =\n StatusCode::from_u16(self.status_code).unwrap_or(StatusCode::INTERNAL_SERVER_ERROR);\n\n (\n status,\n Json(serde_json::json!({\n \"code\": self.code as u16,\n \"message\": self.message,\n })),\n )\n .into_response()\n }\n}\n\nimpl fmt::Display for BeaconError {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n write!(f, \"{}: {}\", self.code.as_str(), self.message)\n }\n}\n\nimpl std::error::Error for BeaconError {}\n\nimpl IntoResponse for BeaconError {\n fn into_response(self) -> Response {\n Self::into_response(self)\n }\n}\n\n/// Beacon API error codes following the beacon chain specification\n#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)]\n#[repr(u16)]\npub enum BeaconErrorCode {\n BadRequest = 400,\n NotFound = 404,\n Gone = 410,\n InternalError = 500,\n}\n\nimpl BeaconErrorCode {\n /// Returns the HTTP status code for this error\n pub const fn status_code(&self) -> u16 {\n *self as u16\n }\n\n /// Returns a string representation of the error code\n pub const fn as_str(&self) -> &'static str {\n match self {\n Self::BadRequest => \"Bad Request\",\n Self::NotFound => \"Not Found\",\n Self::Gone => \"Gone\",\n Self::InternalError => \"Internal Server Error\",\n }\n }\n}\n\nimpl fmt::Display for BeaconErrorCode {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n write!(f, \"{}\", self.as_str())\n }\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n\n #[test]\n fn test_beacon_error_codes() {\n assert_eq!(BeaconErrorCode::BadRequest.status_code(), 400);\n assert_eq!(BeaconErrorCode::NotFound.status_code(), 404);\n assert_eq!(BeaconErrorCode::InternalError.status_code(), 500);\n }\n\n #[test]\n fn test_beacon_error_display() {\n let err = BeaconError::invalid_block_id(\"current\");\n assert_eq!(err.to_string(), \"Bad Request: Invalid block ID: current\");\n }\n}\n" }, { "path": "crates/anvil/src/server/beacon/handlers.rs", "content": "use super::{error::BeaconError, utils::must_be_ssz};\nuse crate::eth::EthApi;\nuse alloy_eips::BlockId;\nuse alloy_primitives::{B256, aliases::B32};\nuse alloy_rpc_types_beacon::{\n genesis::{GenesisData, GenesisResponse},\n sidecar::GetBlobsResponse,\n};\nuse axum::{\n Json,\n extract::{Path, Query, State},\n http::HeaderMap,\n response::{IntoResponse, Response},\n};\nuse foundry_primitives::FoundryNetwork;\nuse ssz::Encode;\nuse std::{collections::HashMap, str::FromStr as _};\n\n/// Handles incoming Beacon API requests for blob sidecars\n///\n/// This endpoint is deprecated. Use `GET /eth/v1/beacon/blobs/{block_id}` instead.\n///\n/// GET /eth/v1/beacon/blob_sidecars/{block_id}\npub async fn handle_get_blob_sidecars(\n State(_api): State>,\n Path(_block_id): Path,\n Query(_params): Query>,\n) -> Response {\n BeaconError::deprecated_endpoint_with_hint(\"Use `GET /eth/v1/beacon/blobs/{block_id}` instead.\")\n .into_response()\n}\n\n/// Handles incoming Beacon API requests for blobs\n///\n/// GET /eth/v1/beacon/blobs/{block_id}\npub async fn handle_get_blobs(\n headers: HeaderMap,\n State(api): State>,\n Path(block_id): Path,\n Query(versioned_hashes): Query>,\n) -> Response {\n // Parse block_id from path parameter\n let Ok(block_id) = BlockId::from_str(&block_id) else {\n return BeaconError::invalid_block_id(block_id).into_response();\n };\n\n // Parse versioned hashes from query parameters\n // Supports comma-separated format: ?versioned_hashes=0x...,0x...\n let versioned_hashes: Vec = match versioned_hashes.get(\"versioned_hashes\") {\n Some(s) => {\n let mut hashes = Vec::new();\n for hash in s.split(',') {\n let hash = hash.trim();\n if hash.is_empty() {\n continue;\n }\n match B256::from_str(hash) {\n Ok(h) => hashes.push(h),\n Err(_) => {\n return BeaconError::new(\n super::error::BeaconErrorCode::BadRequest,\n format!(\"Invalid versioned hash: {hash}\"),\n )\n .into_response();\n }\n }\n }\n hashes\n }\n None => Vec::new(),\n };\n\n // Get the blob sidecars using existing EthApi logic\n match api.anvil_get_blobs_by_block_id(block_id, versioned_hashes) {\n Ok(Some(blobs)) => {\n if must_be_ssz(&headers) {\n blobs.as_ssz_bytes().into_response()\n } else {\n Json(GetBlobsResponse {\n execution_optimistic: false,\n finalized: false,\n data: blobs,\n })\n .into_response()\n }\n }\n Ok(None) => BeaconError::block_not_found().into_response(),\n Err(_) => BeaconError::internal_error().into_response(),\n }\n}\n\n/// Handles incoming Beacon API requests for genesis details\n///\n/// Only returns the `genesis_time`, other fields are set to zero.\n///\n/// GET /eth/v1/beacon/genesis\npub async fn handle_get_genesis(State(api): State>) -> Response {\n match api.anvil_get_genesis_time() {\n Ok(genesis_time) => Json(GenesisResponse {\n data: GenesisData {\n genesis_time,\n genesis_validators_root: B256::ZERO,\n genesis_fork_version: B32::ZERO,\n },\n })\n .into_response(),\n Err(_) => BeaconError::internal_error().into_response(),\n }\n}\n#[cfg(test)]\nmod tests {\n use super::*;\n use axum::http::HeaderValue;\n\n fn header_map_with_accept(accept: &str) -> HeaderMap {\n let mut headers = HeaderMap::new();\n headers.insert(axum::http::header::ACCEPT, HeaderValue::from_str(accept).unwrap());\n headers\n }\n\n #[test]\n fn test_must_be_ssz() {\n let test_cases = vec![\n (None, false, \"no Accept header\"),\n (Some(\"application/json\"), false, \"JSON only\"),\n (Some(\"application/octet-stream\"), true, \"octet-stream only\"),\n (Some(\"application/octet-stream;q=1.0,application/json;q=0.9\"), true, \"SSZ preferred\"),\n (\n Some(\"application/json;q=1.0,application/octet-stream;q=0.9\"),\n false,\n \"JSON preferred\",\n ),\n (Some(\"application/octet-stream;q=0.5,application/json;q=0.5\"), false, \"equal quality\"),\n (\n Some(\"text/html;q=0.9, application/octet-stream;q=1.0, application/json;q=0.8\"),\n true,\n \"multiple types\",\n ),\n (\n Some(\"application/octet-stream ; q=1.0 , application/json ; q=0.9\"),\n true,\n \"whitespace handling\",\n ),\n (Some(\"application/octet-stream, application/json;q=0.9\"), true, \"default quality\"),\n ];\n\n for (accept_header, expected, description) in test_cases {\n let headers = match accept_header {\n None => HeaderMap::new(),\n Some(header) => header_map_with_accept(header),\n };\n assert_eq!(\n must_be_ssz(&headers),\n expected,\n \"Test case '{}' failed: expected {}, got {}\",\n description,\n expected,\n !expected\n );\n }\n }\n}\n" }, { "path": "crates/anvil/src/server/beacon/mod.rs", "content": "//! Beacon Node REST API implementation for Anvil.\n\nuse axum::{Router, routing::get};\n\nuse crate::eth::EthApi;\nuse foundry_primitives::FoundryNetwork;\n\nmod error;\nmod handlers;\nmod utils;\n\n/// Configures an [`axum::Router`] that handles Beacon REST API calls.\npub fn router(api: EthApi) -> Router {\n Router::new()\n .route(\"/eth/v1/beacon/blob_sidecars/{block_id}\", get(handlers::handle_get_blob_sidecars))\n .route(\"/eth/v1/beacon/blobs/{block_id}\", get(handlers::handle_get_blobs))\n .route(\"/eth/v1/beacon/genesis\", get(handlers::handle_get_genesis))\n .with_state(api)\n}\n" }, { "path": "crates/anvil/src/server/beacon/utils.rs", "content": "use hyper::HeaderMap;\n\n/// Helper function to determine if the Accept header indicates a preference for SSZ (octet-stream)\n/// over JSON.\npub fn must_be_ssz(headers: &HeaderMap) -> bool {\n headers\n .get(axum::http::header::ACCEPT)\n .and_then(|v| v.to_str().ok())\n .map(|accept_str| {\n let mut octet_stream_q = 0.0;\n let mut json_q = 0.0;\n\n // Parse each media type in the Accept header\n for media_type in accept_str.split(',') {\n let media_type = media_type.trim();\n let quality = media_type\n .split(';')\n .find_map(|param| {\n let param = param.trim();\n if let Some(q) = param.strip_prefix(\"q=\") {\n q.parse::().ok()\n } else {\n None\n }\n })\n .unwrap_or(1.0); // Default quality factor is 1.0\n\n if media_type.starts_with(\"application/octet-stream\") {\n octet_stream_q = quality;\n } else if media_type.starts_with(\"application/json\") {\n json_q = quality;\n }\n }\n\n // Prefer octet-stream if it has higher quality factor\n octet_stream_q > json_q\n })\n .unwrap_or(false)\n}\n" }, { "path": "crates/anvil/src/server/mod.rs", "content": "//! This module provides the infrastructure to launch an Ethereum JSON-RPC server\n//! (via HTTP, WebSocket, and IPC) and Beacon Node REST API.\n\nuse crate::{EthApi, IpcTask};\nuse anvil_server::{ServerConfig, ipc::IpcEndpoint};\nuse axum::Router;\nuse foundry_primitives::FoundryNetwork;\nuse futures::StreamExt;\nuse rpc_handlers::{HttpEthRpcHandler, PubSubEthRpcHandler};\nuse std::{io, net::SocketAddr, pin::pin};\nuse tokio::net::TcpListener;\n\nmod beacon;\nmod rpc_handlers;\n\n/// Configures a server that handles [`EthApi`] related JSON-RPC calls via HTTP and WS.\n///\n/// The returned future creates a new server, binding it to the given address, which returns another\n/// future that runs it.\npub async fn serve(\n addr: SocketAddr,\n api: EthApi,\n config: ServerConfig,\n) -> io::Result>> {\n let tcp_listener = TcpListener::bind(addr).await?;\n Ok(serve_on(tcp_listener, api, config))\n}\n\n/// Configures a server that handles [`EthApi`] related JSON-RPC calls via HTTP and WS.\npub async fn serve_on(\n tcp_listener: TcpListener,\n api: EthApi,\n config: ServerConfig,\n) -> io::Result<()> {\n axum::serve(tcp_listener, router(api, config).into_make_service()).await\n}\n\n/// Configures an [`axum::Router`] that handles [`EthApi`] related JSON-RPC calls via HTTP and WS,\n/// and Beacon REST API calls.\npub fn router(api: EthApi, config: ServerConfig) -> Router {\n let http = HttpEthRpcHandler::new(api.clone());\n let ws = PubSubEthRpcHandler::new(api.clone());\n\n // JSON-RPC router\n let rpc_router = anvil_server::http_ws_router(config, http, ws);\n\n // Beacon REST API router\n let beacon_router = beacon::router(api);\n\n // Merge the routers\n rpc_router.merge(beacon_router)\n}\n\n/// Launches an ipc server at the given path in a new task\n///\n/// # Panics\n///\n/// Panics if setting up the IPC connection was unsuccessful.\n#[track_caller]\npub fn spawn_ipc(api: EthApi, path: String) -> IpcTask {\n try_spawn_ipc(api, path).expect(\"failed to establish ipc connection\")\n}\n\n/// Launches an ipc server at the given path in a new task.\npub fn try_spawn_ipc(api: EthApi, path: String) -> io::Result {\n let handler = PubSubEthRpcHandler::new(api);\n let ipc = IpcEndpoint::new(handler, path);\n let incoming = ipc.incoming()?;\n\n let task = tokio::task::spawn(async move {\n let mut incoming = pin!(incoming);\n while let Some(stream) = incoming.next().await {\n trace!(target: \"ipc\", \"new ipc connection\");\n tokio::task::spawn(stream);\n }\n });\n\n Ok(task)\n}\n" }, { "path": "crates/anvil/src/server/rpc_handlers.rs", "content": "//! Contains RPC handlers\nuse crate::{\n EthApi,\n eth::error::to_rpc_result,\n pubsub::{EthSubscription, LogsSubscription},\n};\nuse alloy_rpc_types::{\n FilteredParams,\n pubsub::{Params, SubscriptionKind},\n};\nuse anvil_core::eth::{EthPubSub, EthRequest, EthRpcCall, subscription::SubscriptionId};\nuse anvil_rpc::{error::RpcError, response::ResponseResult};\nuse anvil_server::{PubSubContext, PubSubRpcHandler, RpcHandler};\nuse foundry_primitives::FoundryNetwork;\n\n/// A `RpcHandler` that expects `EthRequest` rpc calls via http\n#[derive(Clone)]\npub struct HttpEthRpcHandler {\n /// Access to the node\n api: EthApi,\n}\n\nimpl HttpEthRpcHandler {\n /// Creates a new instance of the handler using the given `EthApi`\n pub fn new(api: EthApi) -> Self {\n Self { api }\n }\n}\n\n#[async_trait::async_trait]\nimpl RpcHandler for HttpEthRpcHandler {\n type Request = EthRequest;\n\n async fn on_request(&self, request: Self::Request) -> ResponseResult {\n self.api.execute(request).await\n }\n}\n\n/// A `RpcHandler` that expects `EthRequest` rpc calls and `EthPubSub` via pubsub connection\n#[derive(Clone)]\npub struct PubSubEthRpcHandler {\n /// Access to the node\n api: EthApi,\n}\n\nimpl PubSubEthRpcHandler {\n /// Creates a new instance of the handler using the given `EthApi`\n pub fn new(api: EthApi) -> Self {\n Self { api }\n }\n\n /// Invoked for an ethereum pubsub rpc call\n async fn on_pub_sub(&self, pubsub: EthPubSub, cx: PubSubContext) -> ResponseResult {\n let id = SubscriptionId::random_hex();\n trace!(target: \"rpc::ws\", \"received pubsub request {:?}\", pubsub);\n match pubsub {\n EthPubSub::EthUnSubscribe(id) => {\n trace!(target: \"rpc::ws\", \"canceling subscription {:?}\", id);\n let canceled = cx.remove_subscription(&id).is_some();\n ResponseResult::Success(canceled.into())\n }\n EthPubSub::EthSubscribe(kind, raw_params) => {\n let filter = match &*raw_params {\n Params::None => None,\n Params::Logs(filter) => Some(filter.clone()),\n Params::Bool(_) => None,\n };\n let params = FilteredParams::new(filter.map(|b| *b));\n\n let subscription = match kind {\n SubscriptionKind::Logs => {\n if raw_params.is_bool() {\n return ResponseResult::Error(RpcError::invalid_params(\n \"Expected params for logs subscription\",\n ));\n }\n\n trace!(target: \"rpc::ws\", \"received logs subscription {:?}\", params);\n let blocks = self.api.new_block_notifications();\n let storage = self.api.storage_info();\n EthSubscription::Logs(Box::new(LogsSubscription {\n blocks,\n storage,\n filter: params,\n queued: Default::default(),\n id: id.clone(),\n }))\n }\n SubscriptionKind::NewHeads => {\n trace!(target: \"rpc::ws\", \"received header subscription\");\n let blocks = self.api.new_block_notifications();\n let storage = self.api.storage_info();\n EthSubscription::Header(blocks, storage, id.clone())\n }\n SubscriptionKind::NewPendingTransactions => {\n trace!(target: \"rpc::ws\", \"received pending transactions subscription\");\n match *raw_params {\n Params::Bool(true) => EthSubscription::FullPendingTransactions(\n self.api.full_pending_transactions(),\n id.clone(),\n ),\n Params::Bool(false) | Params::None => {\n EthSubscription::PendingTransactions(\n self.api.new_ready_transactions(),\n id.clone(),\n )\n }\n _ => {\n return ResponseResult::Error(RpcError::invalid_params(\n \"Expected boolean parameter for newPendingTransactions\",\n ));\n }\n }\n }\n SubscriptionKind::Syncing => {\n return RpcError::internal_error_with(\"Not implemented\").into();\n }\n };\n\n cx.add_subscription(id.clone(), subscription);\n\n trace!(target: \"rpc::ws\", \"created new subscription: {:?}\", id);\n to_rpc_result(id)\n }\n }\n }\n}\n\n#[async_trait::async_trait]\nimpl PubSubRpcHandler for PubSubEthRpcHandler {\n type Request = EthRpcCall;\n type SubscriptionId = SubscriptionId;\n type Subscription = EthSubscription;\n\n async fn on_request(&self, request: Self::Request, cx: PubSubContext) -> ResponseResult {\n trace!(target: \"rpc\", \"received pubsub request {:?}\", request);\n match request {\n EthRpcCall::Request(request) => self.api.execute(*request).await,\n EthRpcCall::PubSub(pubsub) => self.on_pub_sub(pubsub, cx).await,\n }\n }\n}\n" }, { "path": "crates/anvil/src/service.rs", "content": "//! background service\n\nuse crate::{\n NodeResult,\n eth::{\n backend::validate::TransactionValidator,\n fees::FeeHistoryService,\n miner::Miner,\n pool::{Pool, transactions::PoolTransaction},\n },\n filter::Filters,\n mem::{Backend, storage::MinedBlockOutcome},\n};\nuse alloy_network::Network;\nuse foundry_primitives::{FoundryReceiptEnvelope, FoundryTxEnvelope};\nuse futures::{FutureExt, Stream, StreamExt};\nuse std::{\n collections::VecDeque,\n pin::Pin,\n sync::Arc,\n task::{Context, Poll},\n};\nuse tokio::{task::JoinHandle, time::Interval};\n\n/// The type that drives the blockchain's state\n///\n/// This service is basically an endless future that continuously polls the miner which returns\n/// transactions for the next block, then those transactions are handed off to the backend to\n/// construct a new block, if all transactions were successfully included in a new block they get\n/// purged from the `Pool`.\npub struct NodeService {\n /// The pool that holds all transactions.\n pool: Arc>,\n /// Creates new blocks.\n block_producer: BlockProducer,\n /// The miner responsible to select transactions from the `pool`.\n miner: Miner,\n /// Maintenance task for fee history related tasks.\n fee_history: FeeHistoryService,\n /// Tracks all active filters\n filters: Filters,\n /// The interval at which to check for filters that need to be evicted\n filter_eviction_interval: Interval,\n}\n\nimpl NodeService\nwhere\n Backend: TransactionValidator,\n N: Network,\n{\n pub fn new(\n pool: Arc>,\n backend: Arc>,\n miner: Miner,\n fee_history: FeeHistoryService,\n filters: Filters,\n ) -> Self {\n let start = tokio::time::Instant::now() + filters.keep_alive();\n let filter_eviction_interval = tokio::time::interval_at(start, filters.keep_alive());\n Self {\n pool,\n block_producer: BlockProducer::new(backend),\n miner,\n fee_history,\n filter_eviction_interval,\n filters,\n }\n }\n}\n\nimpl Future for NodeService\nwhere\n Backend: TransactionValidator,\n N: Network,\n{\n type Output = NodeResult<()>;\n\n fn poll(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll {\n let pin = self.get_mut();\n\n // this drives block production and feeds new sets of ready transactions to the block\n // producer\n loop {\n // advance block production until pending\n while let Poll::Ready(Some(outcome)) = pin.block_producer.poll_next_unpin(cx) {\n trace!(target: \"node\", \"mined block {}\", outcome.block_number);\n // prune the transactions from the pool\n pin.pool.on_mined_block(outcome);\n }\n\n if let Poll::Ready(transactions) = pin.miner.poll(&pin.pool, cx) {\n // miner returned a set of transaction that we feed to the producer\n pin.block_producer.queued.push_back(transactions);\n } else {\n // no progress made\n break;\n }\n }\n\n // poll the fee history task\n let _ = pin.fee_history.poll_unpin(cx);\n\n if pin.filter_eviction_interval.poll_tick(cx).is_ready() {\n let filters = pin.filters.clone();\n\n // evict filters that timed out\n tokio::task::spawn(async move { filters.evict().await });\n }\n\n Poll::Pending\n }\n}\n\ntype MiningResult = (MinedBlockOutcome<::TxEnvelope>, Arc>);\n\n/// A type that exclusively mines one block at a time\n#[must_use = \"streams do nothing unless polled\"]\nstruct BlockProducer {\n /// Holds the backend if no block is being mined\n idle_backend: Option>>,\n /// Single active future that mines a new block\n block_mining: Option>>,\n /// backlog of sets of transactions ready to be mined\n queued: VecDeque>>>,\n}\n\nimpl BlockProducer\nwhere\n Backend: TransactionValidator,\n N: Network,\n{\n fn new(backend: Arc>) -> Self {\n Self { idle_backend: Some(backend), block_mining: None, queued: Default::default() }\n }\n}\n\nimpl Stream for BlockProducer\nwhere\n Backend: TransactionValidator + Send + Sync + 'static,\n N: Network + 'static,\n{\n type Item = MinedBlockOutcome;\n\n fn poll_next(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll> {\n let pin = self.get_mut();\n\n if !pin.queued.is_empty() {\n // only spawn a building task if there's none in progress already\n if let Some(backend) = pin.idle_backend.take() {\n let transactions = pin.queued.pop_front().expect(\"not empty; qed\");\n\n // we spawn this on as blocking task because this can be blocking for a while in\n // forking mode, because of all the rpc calls to fetch the required state\n let handle = tokio::runtime::Handle::current();\n let mining = tokio::task::spawn_blocking(move || {\n handle.block_on(async move {\n trace!(target: \"miner\", \"creating new block\");\n let block = backend.mine_block(transactions).await;\n trace!(target: \"miner\", \"created new block: {}\", block.block_number);\n (block, backend)\n })\n });\n pin.block_mining = Some(mining);\n }\n }\n\n if let Some(mut mining) = pin.block_mining.take() {\n if let Poll::Ready(res) = mining.poll_unpin(cx) {\n return match res {\n Ok((outcome, backend)) => {\n pin.idle_backend = Some(backend);\n Poll::Ready(Some(outcome))\n }\n Err(err) => {\n panic!(\"miner task failed: {err}\");\n }\n };\n } else {\n pin.block_mining = Some(mining)\n }\n }\n\n Poll::Pending\n }\n}\n" }, { "path": "crates/anvil/src/shutdown.rs", "content": "//! Helper for shutdown signals\n\nuse futures::{\n FutureExt,\n channel::oneshot,\n future::{FusedFuture, Shared},\n};\nuse std::{\n pin::Pin,\n task::{Context, Poll},\n};\n\n/// Future that resolves when the shutdown event has fired\n#[derive(Clone)]\npub struct Shutdown(Shared>);\n\nimpl Future for Shutdown {\n type Output = ();\n\n fn poll(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll {\n let pin = self.get_mut();\n if pin.0.is_terminated() || pin.0.poll_unpin(cx).is_ready() {\n Poll::Ready(())\n } else {\n Poll::Pending\n }\n }\n}\n\n/// Shutdown signal that fires either manually or on drop by closing the channel\npub struct Signal(oneshot::Sender<()>);\n\nimpl Signal {\n /// Fire the signal manually.\n pub fn fire(self) -> Result<(), ()> {\n self.0.send(())\n }\n}\n\n/// Create a channel pair that's used to propagate shutdown event\npub fn signal() -> (Signal, Shutdown) {\n let (sender, receiver) = oneshot::channel();\n (Signal(sender), Shutdown(receiver.shared()))\n}\n" }, { "path": "crates/anvil/src/tasks/block_listener.rs", "content": "//! A task that listens for new blocks\n\nuse crate::shutdown::Shutdown;\nuse futures::{FutureExt, Stream, StreamExt};\nuse std::{\n pin::Pin,\n task::{Context, Poll},\n};\n\n/// A Future that will execute a given `task` for each new block that arrives on the stream.\npub struct BlockListener {\n stream: St,\n task_factory: F,\n task: Option>>,\n on_shutdown: Shutdown,\n}\n\nimpl BlockListener\nwhere\n St: Stream,\n F: Fn(::Item) -> Fut,\n{\n pub fn new(on_shutdown: Shutdown, block_stream: St, task_factory: F) -> Self {\n Self { stream: block_stream, task_factory, task: None, on_shutdown }\n }\n}\n\nimpl Future for BlockListener\nwhere\n St: Stream + Unpin,\n F: Fn(::Item) -> Fut + Unpin + Send + Sync + 'static,\n Fut: Future + Send,\n{\n type Output = ();\n\n fn poll(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll {\n let pin = self.get_mut();\n\n if pin.on_shutdown.poll_unpin(cx).is_ready() {\n return Poll::Ready(());\n }\n\n let mut block = None;\n // drain the stream\n while let Poll::Ready(maybe_block) = pin.stream.poll_next_unpin(cx) {\n if maybe_block.is_none() {\n // stream complete\n return Poll::Ready(());\n }\n block = maybe_block;\n }\n\n if let Some(block) = block {\n pin.task = Some(Box::pin((pin.task_factory)(block)));\n }\n\n if let Some(mut task) = pin.task.take()\n && task.poll_unpin(cx).is_pending()\n {\n pin.task = Some(task);\n }\n Poll::Pending\n }\n}\n" }, { "path": "crates/anvil/src/tasks/mod.rs", "content": "//! Task management support\n\n#![allow(rustdoc::private_doc_tests)]\n\nuse crate::{EthApi, shutdown::Shutdown, tasks::block_listener::BlockListener};\nuse alloy_consensus::BlockHeader;\nuse alloy_network::{BlockResponse, Network};\nuse alloy_primitives::B256;\nuse alloy_provider::Provider;\nuse alloy_rpc_types::anvil::Forking;\nuse foundry_primitives::FoundryNetwork;\nuse futures::StreamExt;\nuse std::fmt;\nuse tokio::{runtime::Handle, task::JoinHandle};\n\npub mod block_listener;\n\n/// A helper struct for managing additional tokio tasks.\n#[derive(Clone)]\npub struct TaskManager {\n /// Tokio runtime handle that's used to spawn futures, See [tokio::runtime::Handle].\n tokio_handle: Handle,\n /// A receiver for the shutdown signal\n on_shutdown: Shutdown,\n}\n\nimpl TaskManager {\n /// Creates a new instance of the task manager\n pub fn new(tokio_handle: Handle, on_shutdown: Shutdown) -> Self {\n Self { tokio_handle, on_shutdown }\n }\n\n /// Returns a receiver for the shutdown event\n pub fn on_shutdown(&self) -> Shutdown {\n self.on_shutdown.clone()\n }\n\n /// Spawns the given task.\n pub fn spawn(&self, task: impl Future + Send + 'static) -> JoinHandle<()> {\n self.tokio_handle.spawn(task)\n }\n\n /// Spawns the blocking task and returns a handle to it.\n ///\n /// Returning the `JoinHandle` allows callers to cancel the task or await its completion.\n pub fn spawn_blocking(\n &self,\n task: impl Future + Send + 'static,\n ) -> JoinHandle<()> {\n let handle = self.tokio_handle.clone();\n self.tokio_handle.spawn_blocking(move || {\n handle.block_on(task);\n })\n }\n\n /// Spawns a new task that listens for new blocks and resets the forked provider for every new\n /// block\n ///\n /// ```\n /// use alloy_network::Ethereum;\n /// use alloy_provider::RootProvider;\n /// use anvil::{NodeConfig, spawn};\n ///\n /// # async fn t() {\n /// let endpoint = \"http://....\";\n /// let (api, handle) = spawn(NodeConfig::default().with_eth_rpc_url(Some(endpoint))).await;\n ///\n /// let provider = RootProvider::connect(endpoint).await.unwrap();\n ///\n /// handle.task_manager().spawn_reset_on_new_polled_blocks::(provider, api);\n /// # }\n /// ```\n pub fn spawn_reset_on_new_polled_blocks(&self, provider: P, api: EthApi)\n where\n N: Network,\n P: Provider + Clone + Unpin + 'static,\n {\n self.spawn_block_poll_listener(provider.clone(), move |hash| {\n let provider = provider.clone();\n let api = api.clone();\n async move {\n if let Ok(Some(block)) = provider.get_block(hash.into()).await {\n let _ = api\n .anvil_reset(Some(Forking {\n json_rpc_url: None,\n block_number: Some(block.header().number()),\n }))\n .await;\n }\n }\n })\n }\n\n /// Spawns a new [`BlockListener`] task that listens for new blocks (poll-based) See also\n /// [`Provider::watch_blocks`] and executes the future the `task_factory` returns for the new\n /// block hash\n pub fn spawn_block_poll_listener(&self, provider: P, task_factory: F)\n where\n N: Network,\n P: Provider + 'static,\n F: Fn(B256) -> Fut + Unpin + Send + Sync + 'static,\n Fut: Future + Send,\n {\n let shutdown = self.on_shutdown.clone();\n self.spawn(async move {\n let blocks = provider\n .watch_blocks()\n .await\n .unwrap()\n .into_stream()\n .flat_map(futures::stream::iter);\n BlockListener::new(shutdown, blocks, task_factory).await;\n });\n }\n\n /// Spawns a new task that listens for new blocks and resets the forked provider for every new\n /// block\n ///\n /// ```\n /// use alloy_network::Ethereum;\n /// use alloy_provider::RootProvider;\n /// use anvil::{NodeConfig, spawn};\n ///\n /// # async fn t() {\n /// let (api, handle) = spawn(NodeConfig::default().with_eth_rpc_url(Some(\"http://....\"))).await;\n ///\n /// let provider = RootProvider::connect(\"ws://...\").await.unwrap();\n ///\n /// handle.task_manager().spawn_reset_on_subscribed_blocks::(provider, api);\n ///\n /// # }\n /// ```\n pub fn spawn_reset_on_subscribed_blocks(&self, provider: P, api: EthApi)\n where\n N: Network,\n P: Provider + 'static,\n {\n self.spawn_block_subscription(provider, move |header: N::HeaderResponse| {\n let api = api.clone();\n async move {\n let _ = api\n .anvil_reset(Some(Forking {\n json_rpc_url: None,\n block_number: Some(header.number()),\n }))\n .await;\n }\n })\n }\n\n /// Spawns a new [`BlockListener`] task that listens for new blocks (via subscription) See also\n /// [`Provider::subscribe_blocks()`] and executes the future the `task_factory` returns for the\n /// new block hash\n pub fn spawn_block_subscription(&self, provider: P, task_factory: F)\n where\n N: Network,\n P: Provider + 'static,\n F: Fn(N::HeaderResponse) -> Fut + Unpin + Send + Sync + 'static,\n Fut: Future + Send,\n {\n let shutdown = self.on_shutdown.clone();\n self.spawn(async move {\n let blocks = provider.subscribe_blocks().await.unwrap().into_stream();\n BlockListener::new(shutdown, blocks, task_factory).await;\n });\n }\n}\n\nimpl fmt::Debug for TaskManager {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n f.debug_struct(\"TaskManager\").finish_non_exhaustive()\n }\n}\n" }, { "path": "crates/anvil/test-data/SimpleStorage.json", "content": "{\"abi\":[{\"inputs\":[{\"internalType\":\"string\",\"name\":\"value\",\"type\":\"string\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"author\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"oldAuthor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"string\",\"name\":\"oldValue\",\"type\":\"string\"},{\"indexed\":false,\"internalType\":\"string\",\"name\":\"newValue\",\"type\":\"string\"}],\"name\":\"ValueChanged\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"_hashPuzzle\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"getValue\",\"outputs\":[{\"internalType\":\"string\",\"name\":\"\",\"type\":\"string\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"lastSender\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"string\",\"name\":\"value\",\"type\":\"string\"}],\"name\":\"setValue\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"string\",\"name\":\"value\",\"type\":\"string\"},{\"internalType\":\"string\",\"name\":\"value2\",\"type\":\"string\"}],\"name\":\"setValues\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}],\"bin\":\"60806040523480156200001157600080fd5b5060405162000d6a38038062000d6a83398181016040528101906200003791906200030f565b600073ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff167f999b6d464c4e3383c341bdd3a22b02dda8a7e1d69c069d252e35cb2ee2f4a3c36001846040516200009a929190620004c3565b60405180910390a38060019080519060200190620000ba929190620000c2565b5050620004fe565b828054620000d0906200038f565b90600052602060002090601f016020900481019282620000f4576000855562000140565b82601f106200010f57805160ff191683800117855562000140565b8280016001018555821562000140579182015b828111156200013f57825182559160200191906001019062000122565b5b5090506200014f919062000153565b5090565b5b808211156200016e57600081600090555060010162000154565b5090565b6000604051905090565b600080fd5b600080fd5b600080fd5b600080fd5b6000601f19601f8301169050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b620001db8262000190565b810181811067ffffffffffffffff82111715620001fd57620001fc620001a1565b5b80604052505050565b60006200021262000172565b9050620002208282620001d0565b919050565b600067ffffffffffffffff821115620002435762000242620001a1565b5b6200024e8262000190565b9050602081019050919050565b60005b838110156200027b5780820151818401526020810190506200025e565b838111156200028b576000848401525b50505050565b6000620002a8620002a28462000225565b62000206565b905082815260208101848484011115620002c757620002c66200018b565b5b620002d48482856200025b565b509392505050565b600082601f830112620002f457620002f362000186565b5b81516200030684826020860162000291565b91505092915050565b6000602082840312156200032857620003276200017c565b5b600082015167ffffffffffffffff81111562000349576200034862000181565b5b6200035784828501620002dc565b91505092915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b60006002820490506001821680620003a857607f821691505b60208210811415620003bf57620003be62000360565b5b50919050565b600082825260208201905092915050565b60008190508160005260206000209050919050565b60008154620003fa816200038f565b620004068186620003c5565b9450600182166000811462000424576001811462000437576200046e565b60ff19831686526020860193506200046e565b6200044285620003d6565b60005b83811015620004665781548189015260018201915060208101905062000445565b808801955050505b50505092915050565b600081519050919050565b60006200048f8262000477565b6200049b8185620003c5565b9350620004ad8185602086016200025b565b620004b88162000190565b840191505092915050565b60006040820190508181036000830152620004df8185620003eb565b90508181036020830152620004f5818462000482565b90509392505050565b61085c806200050e6000396000f3fe608060405234801561001057600080fd5b50600436106100575760003560e01c8063018ba9911461005c578063209652551461007a578063256fec88146100985780637ffaa4b6146100b657806393a09352146100d2575b600080fd5b6100646100ee565b60405161007191906103bd565b60405180910390f35b6100826100f7565b60405161008f9190610471565b60405180910390f35b6100a0610189565b6040516100ad91906104d4565b60405180910390f35b6100d060048036038101906100cb9190610638565b6101ad565b005b6100ec60048036038101906100e791906106b0565b61021f565b005b60006064905090565b60606001805461010690610728565b80601f016020809104026020016040519081016040528092919081815260200182805461013290610728565b801561017f5780601f106101545761010080835404028352916020019161017f565b820191906000526020600020905b81548152906001019060200180831161016257829003601f168201915b5050505050905090565b60008054906101000a900473ffffffffffffffffffffffffffffffffffffffff1681565b81600190805190602001906101c3929190610301565b5080600290805190602001906101da929190610301565b50336000806101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055505050565b60008054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff167f999b6d464c4e3383c341bdd3a22b02dda8a7e1d69c069d252e35cb2ee2f4a3c360018460405161029f9291906107ef565b60405180910390a380600190805190602001906102bd929190610301565b50336000806101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555050565b82805461030d90610728565b90600052602060002090601f01602090048101928261032f5760008555610376565b82601f1061034857805160ff1916838001178555610376565b82800160010185558215610376579182015b8281111561037557825182559160200191906001019061035a565b5b5090506103839190610387565b5090565b5b808211156103a0576000816000905550600101610388565b5090565b6000819050919050565b6103b7816103a4565b82525050565b60006020820190506103d260008301846103ae565b92915050565b600081519050919050565b600082825260208201905092915050565b60005b838110156104125780820151818401526020810190506103f7565b83811115610421576000848401525b50505050565b6000601f19601f8301169050919050565b6000610443826103d8565b61044d81856103e3565b935061045d8185602086016103f4565b61046681610427565b840191505092915050565b6000602082019050818103600083015261048b8184610438565b905092915050565b600073ffffffffffffffffffffffffffffffffffffffff82169050919050565b60006104be82610493565b9050919050565b6104ce816104b3565b82525050565b60006020820190506104e960008301846104c5565b92915050565b6000604051905090565b600080fd5b600080fd5b600080fd5b600080fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b61054582610427565b810181811067ffffffffffffffff821117156105645761056361050d565b5b80604052505050565b60006105776104ef565b9050610583828261053c565b919050565b600067ffffffffffffffff8211156105a3576105a261050d565b5b6105ac82610427565b9050602081019050919050565b82818337600083830152505050565b60006105db6105d684610588565b61056d565b9050828152602081018484840111156105f7576105f6610508565b5b6106028482856105b9565b509392505050565b600082601f83011261061f5761061e610503565b5b813561062f8482602086016105c8565b91505092915050565b6000806040838503121561064f5761064e6104f9565b5b600083013567ffffffffffffffff81111561066d5761066c6104fe565b5b6106798582860161060a565b925050602083013567ffffffffffffffff81111561069a576106996104fe565b5b6106a68582860161060a565b9150509250929050565b6000602082840312156106c6576106c56104f9565b5b600082013567ffffffffffffffff8111156106e4576106e36104fe565b5b6106f08482850161060a565b91505092915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b6000600282049050600182168061074057607f821691505b60208210811415610754576107536106f9565b5b50919050565b60008190508160005260206000209050919050565b6000815461077c81610728565b61078681866103e3565b945060018216600081146107a157600181146107b3576107e6565b60ff19831686526020860193506107e6565b6107bc8561075a565b60005b838110156107de578154818901526001820191506020810190506107bf565b808801955050505b50505092915050565b60006040820190508181036000830152610809818561076f565b9050818103602083015261081d8184610438565b9050939250505056fea2646970667358221220e37ed4b56859ad0b3a3773f57ff7b4e7a99406933fc4ff9f8ae053c52cdf3e3264736f6c63430008090033\"}" }, { "path": "crates/anvil/test-data/SimpleStorage.sol", "content": "pragma solidity >=0.4.24;\n\ncontract SimpleStorage {\n\n event ValueChanged(address indexed author, address indexed oldAuthor, string oldValue, string newValue);\n\n address public lastSender;\n string _value;\n string _otherValue;\n\n constructor(string memory value) public {\n emit ValueChanged(msg.sender, address(0), _value, value);\n _value = value;\n }\n\n function getValue() view public returns (string memory) {\n return _value;\n }\n\n function setValue(string memory value) public {\n emit ValueChanged(msg.sender, lastSender, _value, value);\n _value = value;\n lastSender = msg.sender;\n }\n\n function setValues(string memory value, string memory value2) public {\n _value = value;\n _otherValue = value2;\n lastSender = msg.sender;\n }\n\n function _hashPuzzle() public view returns (uint256) {\n return 100;\n }\n}\n" }, { "path": "crates/anvil/test-data/emit_logs.json", "content": "{\"abi\":[{\"inputs\":[{\"internalType\":\"string\",\"name\":\"value\",\"type\":\"string\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"author\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"string\",\"name\":\"oldValue\",\"type\":\"string\"},{\"indexed\":false,\"internalType\":\"string\",\"name\":\"newValue\",\"type\":\"string\"}],\"name\":\"ValueChanged\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"getValue\",\"outputs\":[{\"internalType\":\"string\",\"name\":\"\",\"type\":\"string\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"string\",\"name\":\"value\",\"type\":\"string\"}],\"name\":\"setValue\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}],\"bin\":\"608060405234801561001057600080fd5b506040516105a63803806105a68339818101604052602081101561003357600080fd5b810190808051604051939291908464010000000082111561005357600080fd5b90830190602082018581111561006857600080fd5b825164010000000081118282018810171561008257600080fd5b82525081516020918201929091019080838360005b838110156100af578181015183820152602001610097565b50505050905090810190601f1680156100dc5780820380516001836020036101000a031916815260200191505b50604052505081516100f6915060009060208401906100fd565b505061019e565b828054600181600116156101000203166002900490600052602060002090601f0160209004810192826101335760008555610179565b82601f1061014c57805160ff1916838001178555610179565b82800160010185558215610179579182015b8281111561017957825182559160200191906001019061015e565b50610185929150610189565b5090565b5b80821115610185576000815560010161018a565b6103f9806101ad6000396000f3fe608060405234801561001057600080fd5b50600436106100365760003560e01c8063209652551461003b57806393a09352146100b8575b600080fd5b610043610160565b6040805160208082528351818301528351919283929083019185019080838360005b8381101561007d578181015183820152602001610065565b50505050905090810190601f1680156100aa5780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b61015e600480360360208110156100ce57600080fd5b8101906020810181356401000000008111156100e957600080fd5b8201836020820111156100fb57600080fd5b8035906020019184600183028401116401000000008311171561011d57600080fd5b91908080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152509295506101f6945050505050565b005b60008054604080516020601f60026000196101006001881615020190951694909404938401819004810282018101909252828152606093909290918301828280156101ec5780601f106101c1576101008083540402835291602001916101ec565b820191906000526020600020905b8154815290600101906020018083116101cf57829003601f168201915b5050505050905090565b60408051818152600080546002600019610100600184161502019091160492820183905233927fe826f71647b8486f2bae59832124c70792fba044036720a54ec8dacdd5df4fcb9285918190602082019060608301908690801561029b5780601f106102705761010080835404028352916020019161029b565b820191906000526020600020905b81548152906001019060200180831161027e57829003601f168201915b5050838103825284518152845160209182019186019080838360005b838110156102cf5781810151838201526020016102b7565b50505050905090810190601f1680156102fc5780820380516001836020036101000a031916815260200191505b5094505050505060405180910390a2805161031e906000906020840190610322565b5050565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282610358576000855561039e565b82601f1061037157805160ff191683800117855561039e565b8280016001018555821561039e579182015b8281111561039e578251825591602001919060010190610383565b506103aa9291506103ae565b5090565b5b808211156103aa57600081556001016103af56fea2646970667358221220c1367a0db85dfe60814cdfc5141a8fe8b95c9d051a6824343085c3ba9697244a64736f6c63430007060033\"}" }, { "path": "crates/anvil/test-data/emit_logs.sol", "content": "pragma solidity >=0.4.24;\n\ncontract SimpleStorage {\n\n event ValueChanged(address indexed author, string oldValue, string newValue);\n\n string _value;\n\n constructor(string memory value) public {\n _value = value;\n }\n\n function getValue() view public returns (string memory) {\n return _value;\n }\n\n function setValue(string memory value) public {\n emit ValueChanged(msg.sender, _value, value);\n _value = value;\n }\n}\n" }, { "path": "crates/anvil/test-data/greeter.json", "content": "{\"bytecode\":{\"object\":\"608060405234801561001057600080fd5b506040516104913803806104918339818101604052602081101561003357600080fd5b810190808051604051939291908464010000000082111561005357600080fd5b90830190602082018581111561006857600080fd5b825164010000000081118282018810171561008257600080fd5b82525081516020918201929091019080838360005b838110156100af578181015183820152602001610097565b50505050905090810190601f1680156100dc5780820380516001836020036101000a031916815260200191505b50604052505081516100f6915060009060208401906100fd565b505061019e565b828054600181600116156101000203166002900490600052602060002090601f0160209004810192826101335760008555610179565b82601f1061014c57805160ff1916838001178555610179565b82800160010185558215610179579182015b8281111561017957825182559160200191906001019061015e565b50610185929150610189565b5090565b5b80821115610185576000815560010161018a565b6102e4806101ad6000396000f3fe608060405234801561001057600080fd5b50600436106100365760003560e01c8063a41368621461003b578063cfae3217146100e3575b600080fd5b6100e16004803603602081101561005157600080fd5b81019060208101813564010000000081111561006c57600080fd5b82018360208201111561007e57600080fd5b803590602001918460018302840111640100000000831117156100a057600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250929550610160945050505050565b005b6100eb610177565b6040805160208082528351818301528351919283929083019185019080838360005b8381101561012557818101518382015260200161010d565b50505050905090810190601f1680156101525780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b805161017390600090602084019061020d565b5050565b60008054604080516020601f60026000196101006001881615020190951694909404938401819004810282018101909252828152606093909290918301828280156102035780601f106101d857610100808354040283529160200191610203565b820191906000526020600020905b8154815290600101906020018083116101e657829003601f168201915b5050505050905090565b828054600181600116156101000203166002900490600052602060002090601f0160209004810192826102435760008555610289565b82601f1061025c57805160ff1916838001178555610289565b82800160010185558215610289579182015b8281111561028957825182559160200191906001019061026e565b50610295929150610299565b5090565b5b80821115610295576000815560010161029a56fea26469706673582212208b9161dfd195d53618942a72a3b481d61a7b142de919925a0b34f9c986e5707e64736f6c63430007060033\"},\"abi\":[{\"inputs\":[{\"internalType\":\"string\",\"name\":\"_greeting\",\"type\":\"string\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[],\"name\":\"greet\",\"outputs\":[{\"internalType\":\"string\",\"name\":\"\",\"type\":\"string\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"string\",\"name\":\"_greeting\",\"type\":\"string\"}],\"name\":\"setGreeting\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}]}" }, { "path": "crates/anvil/test-data/multicall.json", "content": "{\"abi\":[{\"inputs\":[{\"components\":[{\"internalType\":\"address\",\"name\":\"target\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"callData\",\"type\":\"bytes\"}],\"internalType\":\"struct Multicall.Call[]\",\"name\":\"calls\",\"type\":\"tuple[]\"}],\"name\":\"aggregate\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"blockNumber\",\"type\":\"uint256\"},{\"internalType\":\"bytes[]\",\"name\":\"returnData\",\"type\":\"bytes[]\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"blockNumber\",\"type\":\"uint256\"}],\"name\":\"getBlockHash\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"blockHash\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"getCurrentBlockCoinbase\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"coinbase\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"getCurrentBlockDifficulty\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"difficulty\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"getCurrentBlockGasLimit\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"gaslimit\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"getCurrentBlockTimestamp\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"timestamp\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"addr\",\"type\":\"address\"}],\"name\":\"getEthBalance\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"balance\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"getLastBlockHash\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"blockHash\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"}],\"bin\":\"608060405234801561001057600080fd5b50610abb806100206000396000f3fe608060405234801561001057600080fd5b50600436106100885760003560e01c806372425d9d1161005b57806372425d9d1461012a57806386d516e814610148578063a8b0574e14610166578063ee82ac5e1461018457610088565b80630f28c97d1461008d578063252dba42146100ab57806327e86d6e146100dc5780634d2301cc146100fa575b600080fd5b6100956101b4565b6040516100a29190610381565b60405180910390f35b6100c560048036038101906100c091906106b0565b6101bc565b6040516100d3929190610843565b60405180910390f35b6100e461030f565b6040516100f1919061088c565b60405180910390f35b610114600480360381019061010f91906108a7565b610324565b6040516101219190610381565b60405180910390f35b610132610345565b60405161013f9190610381565b60405180910390f35b61015061034d565b60405161015d9190610381565b60405180910390f35b61016e610355565b60405161017b91906108e3565b60405180910390f35b61019e6004803603810190610199919061092a565b61035d565b6040516101ab919061088c565b60405180910390f35b600042905090565b60006060439150825167ffffffffffffffff8111156101de576101dd6103c6565b5b60405190808252806020026020018201604052801561021157816020015b60608152602001906001900390816101fc5790505b50905060005b83518110156103095760008085838151811061023657610235610957565b5b60200260200101516000015173ffffffffffffffffffffffffffffffffffffffff1686848151811061026b5761026a610957565b5b60200260200101516020015160405161028491906109c2565b6000604051808303816000865af19150503d80600081146102c1576040519150601f19603f3d011682016040523d82523d6000602084013e6102c6565b606091505b5091509150816102d557600080fd5b808484815181106102e9576102e8610957565b5b60200260200101819052505050808061030190610a08565b915050610217565b50915091565b600060014361031e9190610a51565b40905090565b60008173ffffffffffffffffffffffffffffffffffffffff16319050919050565b600044905090565b600045905090565b600041905090565b600081409050919050565b6000819050919050565b61037b81610368565b82525050565b60006020820190506103966000830184610372565b92915050565b6000604051905090565b600080fd5b600080fd5b600080fd5b6000601f19601f8301169050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b6103fe826103b5565b810181811067ffffffffffffffff8211171561041d5761041c6103c6565b5b80604052505050565b600061043061039c565b905061043c82826103f5565b919050565b600067ffffffffffffffff82111561045c5761045b6103c6565b5b602082029050602081019050919050565b600080fd5b600080fd5b600080fd5b600073ffffffffffffffffffffffffffffffffffffffff82169050919050565b60006104a78261047c565b9050919050565b6104b78161049c565b81146104c257600080fd5b50565b6000813590506104d4816104ae565b92915050565b600080fd5b600067ffffffffffffffff8211156104fa576104f96103c6565b5b610503826103b5565b9050602081019050919050565b82818337600083830152505050565b600061053261052d846104df565b610426565b90508281526020810184848401111561054e5761054d6104da565b5b610559848285610510565b509392505050565b600082601f830112610576576105756103b0565b5b813561058684826020860161051f565b91505092915050565b6000604082840312156105a5576105a4610472565b5b6105af6040610426565b905060006105bf848285016104c5565b600083015250602082013567ffffffffffffffff8111156105e3576105e2610477565b5b6105ef84828501610561565b60208301525092915050565b600061060e61060984610441565b610426565b905080838252602082019050602084028301858111156106315761063061046d565b5b835b8181101561067857803567ffffffffffffffff811115610656576106556103b0565b5b808601610663898261058f565b85526020850194505050602081019050610633565b5050509392505050565b600082601f830112610697576106966103b0565b5b81356106a78482602086016105fb565b91505092915050565b6000602082840312156106c6576106c56103a6565b5b600082013567ffffffffffffffff8111156106e4576106e36103ab565b5b6106f084828501610682565b91505092915050565b600081519050919050565b600082825260208201905092915050565b6000819050602082019050919050565b600081519050919050565b600082825260208201905092915050565b60005b8381101561075f578082015181840152602081019050610744565b8381111561076e576000848401525b50505050565b600061077f82610725565b6107898185610730565b9350610799818560208601610741565b6107a2816103b5565b840191505092915050565b60006107b98383610774565b905092915050565b6000602082019050919050565b60006107d9826106f9565b6107e38185610704565b9350836020820285016107f585610715565b8060005b85811015610831578484038952815161081285826107ad565b945061081d836107c1565b925060208a019950506001810190506107f9565b50829750879550505050505092915050565b60006040820190506108586000830185610372565b818103602083015261086a81846107ce565b90509392505050565b6000819050919050565b61088681610873565b82525050565b60006020820190506108a1600083018461087d565b92915050565b6000602082840312156108bd576108bc6103a6565b5b60006108cb848285016104c5565b91505092915050565b6108dd8161049c565b82525050565b60006020820190506108f860008301846108d4565b92915050565b61090781610368565b811461091257600080fd5b50565b600081359050610924816108fe565b92915050565b6000602082840312156109405761093f6103a6565b5b600061094e84828501610915565b91505092915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052603260045260246000fd5b600081905092915050565b600061099c82610725565b6109a68185610986565b93506109b6818560208601610741565b80840191505092915050565b60006109ce8284610991565b915081905092915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b6000610a1382610368565b91507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff821415610a4657610a456109d9565b5b600182019050919050565b6000610a5c82610368565b9150610a6783610368565b925082821015610a7a57610a796109d9565b5b82820390509291505056fea2646970667358221220e5023d90063e0939116a41565414721ba1350cd3e98b12e7b65983a039644df964736f6c634300080a0033\"}" }, { "path": "crates/anvil/test-data/multicall.sol", "content": "/**\n *Submitted for verification at Etherscan.io on 2019-06-10\n*/\n\npragma solidity >=0.5.0;\npragma experimental ABIEncoderV2;\n\n/// @title Multicall - Aggregate results from multiple read-only function calls\n/// @author Michael Elliot \n/// @author Joshua Levine \n/// @author Nick Johnson \n\ncontract Multicall {\n struct Call {\n address target;\n bytes callData;\n }\n function aggregate(Call[] memory calls) public returns (uint256 blockNumber, bytes[] memory returnData) {\n blockNumber = block.number;\n returnData = new bytes[](calls.length);\n for(uint256 i = 0; i < calls.length; i++) {\n (bool success, bytes memory ret) = calls[i].target.call(calls[i].callData);\n require(success);\n returnData[i] = ret;\n }\n }\n // Helper functions\n function getEthBalance(address addr) public view returns (uint256 balance) {\n balance = addr.balance;\n }\n function getBlockHash(uint256 blockNumber) public view returns (bytes32 blockHash) {\n blockHash = blockhash(blockNumber);\n }\n function getLastBlockHash() public view returns (bytes32 blockHash) {\n blockHash = blockhash(block.number - 1);\n }\n function getCurrentBlockTimestamp() public view returns (uint256 timestamp) {\n timestamp = block.timestamp;\n }\n function getCurrentBlockDifficulty() public view returns (uint256 difficulty) {\n difficulty = block.difficulty;\n }\n function getCurrentBlockGasLimit() public view returns (uint256 gaslimit) {\n gaslimit = block.gaslimit;\n }\n function getCurrentBlockCoinbase() public view returns (address coinbase) {\n coinbase = block.coinbase;\n }\n}" }, { "path": "crates/anvil/test-data/state-dump-legacy-stress.json", "content": "{\"block\":{\"number\":5,\"beneficiary\":\"0x0000000000000000000000000000000000000000\",\"timestamp\":1722941643,\"gas_limit\":30000000,\"basefee\":316710010,\"difficulty\":\"0x0\",\"prevrandao\":\"0xe7ef87fc7c2090741a6749a087e4ca8092cb4d07136008799e4ebeac3b69e34a\",\"blob_excess_gas_and_price\":{\"excess_blob_gas\":0,\"blob_gasprice\":1}},\"accounts\":{\"0x0000000000000000000000000000000000000000\":{\"nonce\":0,\"balance\":\"0x1088aa62285a00\",\"code\":\"0x\",\"storage\":{}},\"0x108f53faf774d7c4c56f5bce9ca6e605ce8aeadd\":{\"nonce\":1,\"balance\":\"0x0\",\"code\":\"0x6080604052600080357fffffffff0000000000000000000000000000000000000000000000000000000016905060008160e01c610251565b60006379ba509782101561015e5781631627540c811461009857632a952b2d81146100b457633659cfe681146100d0576350c946fe81146100ec576353a47bb781146101085763625ca21c81146101245763718fe928811461014057610158565b7347d08dad17ccb558b3ea74b1a0e73a9cc804a9dc9150610158565b738138ef7cf908021d117e542120b7a390650161079150610158565b7347d08dad17ccb558b3ea74b1a0e73a9cc804a9dc9150610158565b738138ef7cf908021d117e542120b7a390650161079150610158565b7347d08dad17ccb558b3ea74b1a0e73a9cc804a9dc9150610158565b738138ef7cf908021d117e542120b7a390650161079150610158565b7347d08dad17ccb558b3ea74b1a0e73a9cc804a9dc91505b5061024c565b816379ba509781146101a657638da5cb5b81146101c25763aaf10f4281146101de5763c7f62cda81146101fa5763daa250be81146102165763deba1b9881146102325761024a565b7347d08dad17ccb558b3ea74b1a0e73a9cc804a9dc915061024a565b7347d08dad17ccb558b3ea74b1a0e73a9cc804a9dc915061024a565b7347d08dad17ccb558b3ea74b1a0e73a9cc804a9dc915061024a565b7347d08dad17ccb558b3ea74b1a0e73a9cc804a9dc915061024a565b738138ef7cf908021d117e542120b7a39065016107915061024a565b738138ef7cf908021d117e542120b7a3906501610791505b505b919050565b61025a81610037565b915050600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff16036102ce57816040517fc2a825f50000000000000000000000000000000000000000000000000000000081526004016102c5919061032f565b60405180910390fd5b3660008037600080366000845af43d6000803e80600081146102ef573d6000f35b3d6000fd5b60007fffffffff0000000000000000000000000000000000000000000000000000000082169050919050565b610329816102f4565b82525050565b60006020820190506103446000830184610320565b9291505056fea264697066735822122017a4b7fdaaab3897a7b47abaed8d2ee92d558883d3bb2a8454f9601b2ab2c3db64736f6c63430008150033\",\"storage\":{}},\"0x14dc79964da2c08b23698b3d3cc7ca32193d9955\":{\"nonce\":0,\"balance\":\"0x21e19e0c9bab2400000\",\"code\":\"0x\",\"storage\":{}},\"0x15d34aaf54267db7d7c367839aaf71a00a2c6a65\":{\"nonce\":0,\"balance\":\"0x21e19e0c9bab2400000\",\"code\":\"0x\",\"storage\":{}},\"0x19ba1fac55eea44d12a01372a8eb0c2ebbf9ca21\":{\"nonce\":1,\"balance\":\"0x21e19df7c2963f0ac6b\",\"code\":\"0x\",\"storage\":{}},\"0x19c6ab860dbe2bc433574193a4409770a8748bf6\":{\"nonce\":1,\"balance\":\"0x21e19df8da6b7bdc410\",\"code\":\"0x\",\"storage\":{}},\"0x23618e81e3f5cdf7f54c3d65f7fbc0abf5b21e8f\":{\"nonce\":0,\"balance\":\"0x21e19e0c9bab2400000\",\"code\":\"0x\",\"storage\":{}},\"0x3c44cdddb6a900fa2b585dd299e03d12fa4293bc\":{\"nonce\":0,\"balance\":\"0x21e19e0c9bab2400000\",\"code\":\"0x\",\"storage\":{}},\"0x40567ec443c1d1872af5155755ac3803cc3fe61e\":{\"nonce\":1,\"balance\":\"0x21e19da82562f921b40\",\"code\":\"0x\",\"storage\":{}},\"0x47d08dad17ccb558b3ea74b1a0e73a9cc804a9dc\":{\"nonce\":1,\"balance\":\"0x0\",\"code\":\"0x608060405234801561001057600080fd5b50600436106100885760003560e01c806379ba50971161005b57806379ba5097146100ed5780638da5cb5b146100f7578063aaf10f4214610115578063c7f62cda1461013357610088565b80631627540c1461008d5780633659cfe6146100a957806353a47bb7146100c5578063718fe928146100e3575b600080fd5b6100a760048036038101906100a29190610d25565b61014f565b005b6100c360048036038101906100be9190610d25565b6102d0565b005b6100cd6102e4565b6040516100da9190610d61565b60405180910390f35b6100eb610317565b005b6100f56103fe565b005b6100ff61058b565b60405161010c9190610d61565b60405180910390f35b61011d6105be565b60405161012a9190610d61565b60405180910390f35b61014d60048036038101906101489190610d25565b6105f1565b005b61015761084c565b600061016161081b565b9050600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff16036101c9576040517fd92e233d00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b8060010160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603610252576040517fa88ee57700000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b818160010160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055507f906a1c6bd7e3091ea86693dd029a831c19049ce77f1dce2ce0bab1cacbabce22826040516102c49190610d61565b60405180910390a15050565b6102d861084c565b6102e1816108c5565b50565b60006102ee61081b565b60010160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905090565b600061032161081b565b90503373ffffffffffffffffffffffffffffffffffffffff168160010160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16146103b757336040517fa0e5a0d70000000000000000000000000000000000000000000000000000000081526004016103ae9190610d61565b60405180910390fd5b60008160010160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555050565b600061040861081b565b905060008160010160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1690508073ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16146104a357336040517fa0e5a0d700000000000000000000000000000000000000000000000000000000815260040161049a9190610d61565b60405180910390fd5b7fb532073b38c83145e3e5135377a08bf9aab55bc0fd7c1179cd4fb995d2a5159c8260000160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16826040516104f8929190610d7c565b60405180910390a1808260000160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555060008260010160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055505050565b600061059561081b565b60000160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905090565b60006105c8610b05565b60000160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905090565b60006105fb610b05565b905060018160000160146101000a81548160ff02191690831515021790555060008160000160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050828260000160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555060008373ffffffffffffffffffffffffffffffffffffffff163073ffffffffffffffffffffffffffffffffffffffff16633659cfe6846040516024016106cc9190610d61565b604051602081830303815290604052915060e01b6020820180517bffffffffffffffffffffffffffffffffffffffffffffffffffffffff838183161783525050505060405161071b9190610e16565b600060405180830381855af49150503d8060008114610756576040519150601f19603f3d011682016040523d82523d6000602084013e61075b565b606091505b505090508015806107c357508173ffffffffffffffffffffffffffffffffffffffff16610786610b05565b60000160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1614155b156107fa576040517fa1cfa5a800000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b60008360000160146101000a81548160ff0219169083151502179055600080fd5b60008060405160200161082d90610eb0565b6040516020818303038152906040528051906020012090508091505090565b610854610b36565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16146108c357336040517f8e4a23d60000000000000000000000000000000000000000000000000000000081526004016108ba9190610d61565b60405180910390fd5b565b600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff160361092b576040517fd92e233d00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b61093481610b69565b61097557806040517f8a8b41ec00000000000000000000000000000000000000000000000000000000815260040161096c9190610d61565b60405180910390fd5b600061097f610b05565b90508060000160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603610a0a576040517fa88ee57700000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b8060000160149054906101000a900460ff16158015610a2e5750610a2d82610b7c565b5b15610a7057816040517f15504301000000000000000000000000000000000000000000000000000000008152600401610a679190610d61565b60405180910390fd5b818160000160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055503073ffffffffffffffffffffffffffffffffffffffff167f5d611f318680d00598bb735d61bacf0c514c6b50e1e5ad30040a4df2b12791c783604051610af99190610d61565b60405180910390a25050565b600080604051602001610b1790610f42565b6040516020818303038152906040528051906020012090508091505090565b6000610b4061081b565b60000160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905090565b600080823b905060008111915050919050565b60008060003073ffffffffffffffffffffffffffffffffffffffff163073ffffffffffffffffffffffffffffffffffffffff1663c7f62cda86604051602401610bc59190610d61565b604051602081830303815290604052915060e01b6020820180517bffffffffffffffffffffffffffffffffffffffffffffffffffffffff8381831617835250505050604051610c149190610e16565b600060405180830381855af49150503d8060008114610c4f576040519150601f19603f3d011682016040523d82523d6000602084013e610c54565b606091505b509150915081158015610cb9575063a1cfa5a860e01b604051602001610c7a9190610faf565b6040516020818303038152906040528051906020012081604051602001610ca19190610e16565b60405160208183030381529060405280519060200120145b92505050919050565b600080fd5b600073ffffffffffffffffffffffffffffffffffffffff82169050919050565b6000610cf282610cc7565b9050919050565b610d0281610ce7565b8114610d0d57600080fd5b50565b600081359050610d1f81610cf9565b92915050565b600060208284031215610d3b57610d3a610cc2565b5b6000610d4984828501610d10565b91505092915050565b610d5b81610ce7565b82525050565b6000602082019050610d766000830184610d52565b92915050565b6000604082019050610d916000830185610d52565b610d9e6020830184610d52565b9392505050565b600081519050919050565b600081905092915050565b60005b83811015610dd9578082015181840152602081019050610dbe565b60008484015250505050565b6000610df082610da5565b610dfa8185610db0565b9350610e0a818560208601610dbb565b80840191505092915050565b6000610e228284610de5565b915081905092915050565b600082825260208201905092915050565b7f696f2e73796e7468657469782e636f72652d636f6e7472616374732e4f776e6160008201527f626c650000000000000000000000000000000000000000000000000000000000602082015250565b6000610e9a602383610e2d565b9150610ea582610e3e565b604082019050919050565b60006020820190508181036000830152610ec981610e8d565b9050919050565b7f696f2e73796e7468657469782e636f72652d636f6e7472616374732e50726f7860008201527f7900000000000000000000000000000000000000000000000000000000000000602082015250565b6000610f2c602183610e2d565b9150610f3782610ed0565b604082019050919050565b60006020820190508181036000830152610f5b81610f1f565b9050919050565b60007fffffffff0000000000000000000000000000000000000000000000000000000082169050919050565b6000819050919050565b610fa9610fa482610f62565b610f8e565b82525050565b6000610fbb8284610f98565b6004820191508190509291505056fea264697066735822122023a7c33d7b91dce35ffbcf8837693364ab22a3905d0fc00016833e5fac45ca2f64736f6c63430008110033\",\"storage\":{\"0x5c7865864a2a990d80b5bb5c40e7b73a029960dc711fbb56120dfab976e92ea3\":\"0x0\"}},\"0x4e59b44847b379578588920ca78fbf26c0b4956c\":{\"nonce\":2,\"balance\":\"0x0\",\"code\":\"0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe03601600081602082378035828234f58015156039578182fd5b8082525050506014600cf3\",\"storage\":{}},\"0x70997970c51812dc3a010c7d01b50e0d17dc79c8\":{\"nonce\":0,\"balance\":\"0x21e19e0c9bab2400000\",\"code\":\"0x\",\"storage\":{}},\"0x8138ef7cf908021d117e542120b7a39065016107\":{\"nonce\":1,\"balance\":\"0x0\",\"code\":\"0x608060405234801561001057600080fd5b50600436106100575760003560e01c80632a952b2d1461005c57806350c946fe14610085578063625ca21c146100a5578063daa250be146100c6578063deba1b98146100d9575b600080fd5b61006f61006a366004613a63565b6100ec565b60405161007c9190613a7c565b60405180910390f35b610098610093366004613a63565b61011c565b60405161007c9190613b21565b6100b86100b3366004613c92565b610276565b60405190815260200161007c565b61006f6100d4366004613d5f565b6102bb565b6100b86100e7366004613c92565b6102d6565b6100f46139e4565b6040805160008082526020820190815281830190925261011691849190610310565b92915050565b6101416040805160608101909152806000815260200160608152602001606081525090565b61014a82610ab6565b60408051606081019091528154909190829060ff16600981111561017057610170613aa7565b600981111561018157610181613aa7565b815260200160018201805461019590613dc2565b80601f01602080910402602001604051908101604052809291908181526020018280546101c190613dc2565b801561020e5780601f106101e35761010080835404028352916020019161020e565b820191906000526020600020905b8154815290600101906020018083116101f157829003601f168201915b505050505081526020016002820180548060200260200160405190810160405280929190818152602001828054801561026657602002820191906000526020600020905b815481526020019060010190808311610252575b5050505050815250509050919050565b600080604051806060016040528086600981111561029657610296613aa7565b81526020018581526020018481525090506102b081610ac1565b9150505b9392505050565b6102c36139e4565b6102ce848484610310565b949350505050565b60008060405180606001604052808660098111156102f6576102f6613aa7565b81526020018581526020018481525090506102b081610acc565b6103186139e4565b81518351146103a05760408051634bab873760e11b81526004810191909152600d60448201526c72756e74696d6556616c75657360981b606482015260806024820152602260848201527f6d7573742062652073616d65206c656e6774682061732072756e74696d654b6560a482015261797360f01b60c482015260e4015b60405180910390fd5b60006103ab85610c26565b805490915060ff1660018160098111156103c7576103c7613aa7565b036104755761046c6103da838787610c84565b8360010180546103e990613dc2565b80601f016020809104026020016040519081016040528092919081815260200182805461041590613dc2565b80156104625780601f1061043757610100808354040283529160200191610462565b820191906000526020600020905b81548152906001019060200180831161044557829003601f168201915b5050505050610d46565b925050506102b4565b600281600981111561048957610489613aa7565b036105305761046c61049c838787610c84565b8360010180546104ab90613dc2565b80601f01602080910402602001604051908101604052809291908181526020018280546104d790613dc2565b80156105245780601f106104f957610100808354040283529160200191610524565b820191906000526020600020905b81548152906001019060200180831161050757829003601f168201915b50505050508787610ebb565b600381600981111561054457610544613aa7565b036105de5761046c82600101805461055b90613dc2565b80601f016020809104026020016040519081016040528092919081815260200182805461058790613dc2565b80156105d45780601f106105a9576101008083540402835291602001916105d4565b820191906000526020600020905b8154815290600101906020018083116105b757829003601f168201915b5050505050610f59565b60048160098111156105f2576105f2613aa7565b0361068c5761046c82600101805461060990613dc2565b80601f016020809104026020016040519081016040528092919081815260200182805461063590613dc2565b80156106825780601f1061065757610100808354040283529160200191610682565b820191906000526020600020905b81548152906001019060200180831161066557829003601f168201915b5050505050611087565b60058160098111156106a0576106a0613aa7565b0361073a5761046c8260010180546106b790613dc2565b80601f01602080910402602001604051908101604052809291908181526020018280546106e390613dc2565b80156107305780601f1061070557610100808354040283529160200191610730565b820191906000526020600020905b81548152906001019060200180831161071357829003601f168201915b505050505061131e565b600981600981111561074e5761074e613aa7565b036107ea5761046c82600101805461076590613dc2565b80601f016020809104026020016040519081016040528092919081815260200182805461079190613dc2565b80156107de5780601f106107b3576101008083540402835291602001916107de565b820191906000526020600020905b8154815290600101906020018083116107c157829003601f168201915b505050505086866114b5565b60068160098111156107fe576107fe613aa7565b036108a35761046c610811838787610c84565b83600101805461082090613dc2565b80601f016020809104026020016040519081016040528092919081815260200182805461084c90613dc2565b80156108995780601f1061086e57610100808354040283529160200191610899565b820191906000526020600020905b81548152906001019060200180831161087c57829003601f168201915b50505050506115c7565b60078160098111156108b7576108b7613aa7565b036109ec576040805160608101909152825461046c91908490829060ff1660098111156108e6576108e6613aa7565b60098111156108f7576108f7613aa7565b815260200160018201805461090b90613dc2565b80601f016020809104026020016040519081016040528092919081815260200182805461093790613dc2565b80156109845780601f1061095957610100808354040283529160200191610984565b820191906000526020600020905b81548152906001019060200180831161096757829003601f168201915b50505050508152602001600282018054806020026020016040519081016040528092919081815260200182805480156109dc57602002820191906000526020600020905b8154815260200190600101908083116109c8575b5050505050815250508686611728565b6008816009811115610a0057610a00613aa7565b03610a9a5761046c826001018054610a1790613dc2565b80601f0160208091040260200160405190810160405280929190818152602001828054610a4390613dc2565b8015610a905780601f10610a6557610100808354040283529160200191610a90565b820191906000526020600020905b815481529060010190602001808311610a7357829003601f168201915b50505050506118a5565b6040516323a9bbc960e01b815260048101879052602401610397565b600061011682610c26565b6000610116826118ea565b6000610ad782610ac1565b9050610ae28161192a565b15610b35577fcb64985827770858ec421ad26da7e558c757541643036ce44d6b4eb9e8e5dc5e81836000015184602001518560400151604051610b289493929190613e32565b60405180910390a1919050565b610b3e82611a8c565b610b5d578160405163382bbbc960e11b81526004016103979190613b21565b60005b826040015151811015610bd957610b9383604001518281518110610b8657610b86613e6a565b602002602001015161192a565b610bd15782604001518181518110610bad57610bad613e6a565b6020026020010151604051632f19f96160e11b815260040161039791815260200190565b600101610b60565b50610be382611c31565b8351602085015160408087015190519395507fcb64985827770858ec421ad26da7e558c757541643036ce44d6b4eb9e8e5dc5e9450610b28938693929190613e32565b604080516020808201839052606082018190527f696f2e73796e7468657469782e6f7261636c652d6d616e616765722e4e6f6465608080840191909152828401949094528251808303909401845260a0909101909152815191012090565b600283015460609067ffffffffffffffff811115610ca457610ca4613b9a565b604051908082528060200260200182016040528015610cdd57816020015b610cca6139e4565b815260200190600190039081610cc25790505b50905060005b6002850154811015610d3e57610d19856002018281548110610d0757610d07613e6a565b90600052602060002001548585610310565b828281518110610d2b57610d2b613e6a565b6020908102919091010152600101610ce3565b509392505050565b610d4e6139e4565b600082806020019051810190610d649190613e80565b90506000816008811115610d7a57610d7a613aa7565b03610d9057610d8884611ca5565b915050610116565b6001816008811115610da457610da4613aa7565b03610db257610d8884611d0d565b6002816008811115610dc657610dc6613aa7565b03610dd457610d8884611d90565b6003816008811115610de857610de8613aa7565b03610df657610d8884611e13565b6004816008811115610e0a57610e0a613aa7565b03610e1857610d8884611ec9565b6005816008811115610e2c57610e2c613aa7565b03610e3a57610d8884612009565b6006816008811115610e4e57610e4e613aa7565b03610e5c57610d88846120e4565b6007816008811115610e7057610e70613aa7565b03610e7e57610d888461220c565b6008816008811115610e9257610e92613aa7565b03610ea057610d88846122ce565b80604051631be413d360e11b81526004016103979190613ea1565b610ec36139e4565b600084806020019051810190610ed99190613ed3565b604051631ecba7c360e31b81529091506001600160a01b0382169063f65d3e1890610f0e908990899089908990600401613ef0565b608060405180830381865afa158015610f2b573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f4f9190613f91565b9695505050505050565b610f616139e4565b600080600084806020019051810190610f7a9190613fe8565b92509250925060008390506000806000836001600160a01b031663feaf968c6040518163ffffffff1660e01b815260040160a060405180830381865afa158015610fc8573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610fec9190614041565b509350509250925060008660001461100f5761100a8585858a6123c7565b611011565b825b905060128660ff161161103b5761103661102f60ff881660126140a7565b82906124c2565b611053565b61105361104c601260ff89166140a7565b82906124dc565b9050604051806080016040528082815260200183815260200160008152602001600081525098505050505050505050919050565b61108f6139e4565b600080600080600080878060200190518101906110ac91906140ba565b604080516002808252606082018352979d50959b50939950919750955093506000929060208301908036833701905050905081816000815181106110f2576110f2613e6a565b602002602001019063ffffffff16908163ffffffff168152505060008160018151811061112157611121613e6a565b63ffffffff9092166020928302919091019091015260405163883bdbfd60e01b81526000906001600160a01b0385169063883bdbfd90611165908590600401614143565b600060405180830381865afa158015611182573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526111aa91908101906141f5565b5090506000816000815181106111c2576111c2613e6a565b6020026020010151826001815181106111dd576111dd613e6a565b60200260200101516111ef91906142c1565b9050600061121761120563ffffffff87166124f6565b61120f9084614304565b60060b61252d565b905060008260060b12801561124c575061123b63ffffffff8616612569565b612569565b8260060b6112499190614342565b15155b1561125f578061125b81614356565b9150505b600061126d6012600a61445d565b9050600061128061123684848f8f612593565b905060006112908a60ff16612569565b61129c8c60ff16612569565b6112a6919061446c565b905060008082136112d1576112cc6112c56112c084614493565b612686565b84906124dc565b6112e4565b6112e46112dd83612686565b84906124c2565b905060405180608001604052808281526020014281526020016000815260200160008152509e505050505050505050505050505050919050565b6113266139e4565b60008060008480602001905181019061133f91906144bf565b91945092509050826000826113bc576040516396834ad360e01b8152600481018590526001600160a01b038316906396834ad390602401608060405180830381865afa158015611393573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906113b791906144f5565b611425565b604051639474f45b60e01b8152600481018590526001600160a01b03831690639474f45b90602401608060405180830381865afa158015611401573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061142591906144f5565b90506000816040015160030b601261143d919061456f565b90506000808213611467576114626114576112c084614493565b845160070b906124dc565b61147e565b61147e61147383612686565b845160070b906124c2565b9050604051806080016040528082815260200184606001518152602001600081526020016000815250975050505050505050919050565b6114bd6139e4565b6000806000868060200190518101906114d69190614597565b92509250925060005b8651811015611545578681815181106114fa576114fa613e6a565b6020026020010151717374616c656e657373546f6c6572616e636560701b0361153d5785818151811061152f5761152f613e6a565b602002602001015160001c91505b6001016114df565b5060408051600180825281830190925260009160208083019080368337019050509050828160008151811061157c5761157c613e6a565b602002602001018181525050836001838360405160200161159f939291906145ce565b60408051601f198184030181529082905263cf2cabdf60e01b82526103979291600401614603565b6115cf6139e4565b6000828060200190518101906115e59190614627565b90506000846000815181106115fc576115fc613e6a565b602002602001015160000151905060008560018151811061161f5761161f613e6a565b6020026020010151600001519050808214611702576000611653601261164d611648858761446c565b6126a9565b906124c2565b905082158061167b5750611666836126a9565b6116709082614640565b61167985612569565b125b15611700576002875111156116b0578660028151811061169d5761169d613e6a565b6020026020010151945050505050610116565b826000036116d15760405163014cc07160e01b815260040160405180910390fd5b6116da836126a9565b6116e49082614640565b60405163dcac091960e01b815260040161039791815260200190565b505b8560008151811061171557611715613e6a565b6020026020010151935050505092915050565b6117306139e4565b6000846020015180602001905181019061174a9190614627565b905060005b84518110156117bc5784818151811061176a5761176a613e6a565b6020026020010151717374616c656e657373546f6c6572616e636560701b036117b4576117ad8482815181106117a2576117a2613e6a565b602002602001015190565b91506117bc565b60010161174f565b50600085604001516000815181106117d6576117d6613e6a565b6020026020010151905060006117ed828787610310565b60208101519091506117ff84426140a7565b1161180e5792506102b4915050565b86604001515160010361187157866040015160008151811061183257611832613e6a565b602002602001015181600001518260200151604051631808066560e21b8152600401610397939291909283526020830191909152604082015260600190565b61189a876040015160018151811061188b5761188b613e6a565b60200260200101518787610310565b979650505050505050565b6118ad6139e4565b6040518060800160405280838060200190518101906118cc9190614627565b81526020014281526020016000815260200160008152509050919050565b600081600001518260200151836040015160405160200161190d9392919061466e565b604051602081830303815290604052805190602001209050919050565b60008061193683610c26565b60408051606081019091528154909190829060ff16600981111561195c5761195c613aa7565b600981111561196d5761196d613aa7565b815260200160018201805461198190613dc2565b80601f01602080910402602001604051908101604052809291908181526020018280546119ad90613dc2565b80156119fa5780601f106119cf576101008083540402835291602001916119fa565b820191906000526020600020905b8154815290600101906020018083116119dd57829003601f168201915b5050505050815260200160028201805480602002602001604051908101604052809291908181526020018280548015611a5257602002820191906000526020600020905b815481526020019060010190808311611a3e575b505050505081525050905060006009811115611a7057611a70613aa7565b81516009811115611a8357611a83613aa7565b14159392505050565b6000600182516009811115611aa357611aa3613aa7565b1480611ac15750600682516009811115611abf57611abf613aa7565b145b80611ade5750600782516009811115611adc57611adc613aa7565b145b15611aee57611aec826126c1565b505b600182516009811115611b0357611b03613aa7565b03611b11576101168261284a565b600282516009811115611b2657611b26613aa7565b03611b3457610116826128a5565b600382516009811115611b4957611b49613aa7565b03611b575761011682612973565b600482516009811115611b6c57611b6c613aa7565b03611b7a5761011682612aae565b600582516009811115611b8f57611b8f613aa7565b03611b9d5761011682612e92565b600982516009811115611bb257611bb2613aa7565b03611bc05761011682612fcb565b600682516009811115611bd557611bd5613aa7565b03611be3576101168261300e565b600782516009811115611bf857611bf8613aa7565b03611c065761011682613052565b600882516009811115611c1b57611c1b613aa7565b03611c295761011682613078565b506000919050565b600080611c3d836118ea565b9050611c4881610c26565b8351815491935090839060ff19166001836009811115611c6a57611c6a613aa7565b021790555060208301516001830190611c8390826146ed565b5060408301518051611c9f916002850191602090910190613a0c565b50915091565b611cad6139e4565b60005b8251811015611d07578160200151838281518110611cd057611cd0613e6a565b6020026020010151602001511115611cff57828181518110611cf457611cf4613e6a565b602002602001015191505b600101611cb0565b50919050565b611d156139e4565b81600081518110611d2857611d28613e6a565b602002602001015190506000600190505b8251811015611d07578160000151838281518110611d5957611d59613e6a565b6020026020010151600001511215611d8857828181518110611d7d57611d7d613e6a565b602002602001015191505b600101611d39565b611d986139e4565b81600081518110611dab57611dab613e6a565b602002602001015190506000600190505b8251811015611d07578160000151838281518110611ddc57611ddc613e6a565b6020026020010151600001511315611e0b57828181518110611e0057611e00613e6a565b602002602001015191505b600101611dbc565b611e1b6139e4565b60005b8251811015611e9557828181518110611e3957611e39613e6a565b60200260200101516000015182600001818151611e56919061456f565b9052508251839082908110611e6d57611e6d613e6a565b60200260200101516020015182602001818151611e8a91906147ad565b905250600101611e1e565b50611ea08251612569565b8151611eac9190614640565b815281516020820151611ebf91906147c0565b6020820152919050565b611ed16139e4565b611eed826000611ee86001865161123691906140a7565b6130a4565b60028251611efb91906147d4565b600003611fd65760408051600280825260608201909252600091816020015b611f226139e4565b815260200190600190039081611f1a57905050905082600160028551611f4891906147c0565b611f5291906140a7565b81518110611f6257611f62613e6a565b602002602001015181600081518110611f7d57611f7d613e6a565b60200260200101819052508260028451611f9791906147c0565b81518110611fa757611fa7613e6a565b602002602001015181600181518110611fc257611fc2613e6a565b60200260200101819052506102b481611e13565b8160028351611fe591906147c0565b81518110611ff557611ff5613e6a565b60200260200101519050919050565b919050565b6120116139e4565b8160008151811061202457612024613e6a565b60209081029190910101515181528151829060009061204557612045613e6a565b6020908102919091018101518101519082015260015b82518110156120d25782818151811061207657612076613e6a565b6020026020010151600001518260000181815161209391906147e8565b90525082518390829081106120aa576120aa613e6a565b602002602001015160200151826020018181516120c791906147ad565b90525060010161205b565b5081518160200151611ebf91906147c0565b6120ec6139e4565b816000815181106120ff576120ff613e6a565b60209081029190910101515181528151829060009061212057612120613e6a565b6020908102919091018101518101519082015260015b82518110156120d25782818151811061215157612151613e6a565b60200260200101516000015160000361219e5782818151811061217657612176613e6a565b6020026020010151600001516040516338ee04a760e01b815260040161039791815260200190565b8281815181106121b0576121b0613e6a565b602002602001015160000151826000018181516121cd9190614640565b90525082518390829081106121e4576121e4613e6a565b6020026020010151602001518260200181815161220191906147ad565b905250600101612136565b6122146139e4565b8160008151811061222757612227613e6a565b60209081029190910101515181528151829060009061224857612248613e6a565b6020908102919091018101518101519082015260015b82518110156120d25761229083828151811061227c5761227c613e6a565b602090810291909101015151835190613264565b825282518390829081106122a6576122a6613e6a565b602002602001015160200151826020018181516122c391906147ad565b90525060010161225e565b6122d66139e4565b816000815181106122e9576122e9613e6a565b60209081029190910101515181528151829060009061230a5761230a613e6a565b6020908102919091018101518101519082015260015b82518110156120d25782818151811061233b5761233b613e6a565b6020026020010151600001516000036123605782818151811061217657612176613e6a565b61238983828151811061237557612375613e6a565b602090810291909101015151835190613283565b8252825183908290811061239f5761239f613e6a565b602002602001015160200151826020018181516123bc91906147ad565b905250600101612320565b6000826001826123d785426140a7565b90505b69ffffffffffffffffffff8716156124a3576001600160a01b038816639a6fc8f561240489614818565b6040516001600160e01b031960e084901b16815269ffffffffffffffffffff8216600482015290995060240160a060405180830381865afa925050508015612469575060408051601f3d908101601f1916820190925261246691810190614041565b60015b156124a357858210156124805750505050506124a3565b61248a848961456f565b97508661249681614834565b97505050505050506123da565b6124ac82612569565b6124b69084614640565b98975050505050505050565b60006124d261123683600a61484d565b6102b490846147e8565b60006124ec61123683600a61484d565b6102b49084614640565b6000667fffffffffffff66ffffffffffffff83161115612529576040516329d2678160e21b815260040160405180910390fd5b5090565b6000627fffff19600683900b128061254b5750627fffff600683900b135b1561252957604051630d962f7960e21b815260040160405180910390fd5b60006001600160ff1b038211156125295760405163677c430560e11b815260040160405180910390fd5b60008061259f86613298565b90506fffffffffffffffffffffffffffffffff6001600160a01b0382161161261c5760006125d66001600160a01b03831680614859565b9050836001600160a01b0316856001600160a01b03161061260557612600600160c01b87836136cd565b612614565b6126148187600160c01b6136cd565b92505061267d565b600061263b6001600160a01b03831680680100000000000000006136cd565b9050836001600160a01b0316856001600160a01b03161061266a57612665600160801b87836136cd565b612679565b6126798187600160801b6136cd565b9250505b50949350505050565b6000808212156125295760405163029f024d60e31b815260040160405180910390fd5b600080821215612529576126bc82614493565b610116565b6000805b8260400151518110156128415760006126fa846040015183815181106126ed576126ed613e6a565b6020026020010151610ab6565b60408051606081019091528154909190829060ff16600981111561272057612720613aa7565b600981111561273157612731613aa7565b815260200160018201805461274590613dc2565b80601f016020809104026020016040519081016040528092919081815260200182805461277190613dc2565b80156127be5780601f10612793576101008083540402835291602001916127be565b820191906000526020600020905b8154815290600101906020018083116127a157829003601f168201915b505050505081526020016002820180548060200260200160405190810160405280929190818152602001828054801561281657602002820191906000526020600020905b815481526020019060010190808311612802575b505050505081525050905061282a81611a8c565b612838575060009392505050565b506001016126c5565b50600192915050565b60006002826040015151101561286257506000919050565b81602001515160201461287757506000919050565b600082602001518060200190518101906128919190614627565b905060088111156128415750600092915050565b6000602082602001515110156128bd57506000919050565b600082602001518060200190518101906128d79190613ed3565b90506128ea816306e7ea3960e21b6138e2565b6128f75750600092915050565b604051633b70a5bf60e21b81526001600160a01b0382169063edc296fc90612923908690600401613b21565b6020604051808303816000875af1158015612942573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906129669190614870565b6128415750600092915050565b6040810151516000901561298957506000919050565b81602001515160601461299e57506000919050565b60008083602001518060200190518101906129b99190613fe8565b92505091506000829050806001600160a01b031663feaf968c6040518163ffffffff1660e01b815260040160a060405180830381865afa158015612a01573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612a259190614041565b5050505050806001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa158015612a68573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612a8c919061488b565b60ff168260ff1614612aa357506000949350505050565b506001949350505050565b60408101515160009015612ac457506000919050565b81602001515160c014612ad957506000919050565b6000806000806000808760200151806020019051810190612afa91906140ba565b9550955095509550955095508360ff16866001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa158015612b48573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612b6c919061488b565b60ff1614612b8257506000979650505050505050565b8260ff16856001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa158015612bc4573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612be8919061488b565b60ff1614612bfe57506000979650505050505050565b6000826001600160a01b0316630dfe16816040518163ffffffff1660e01b8152600401602060405180830381865afa158015612c3e573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612c629190613ed3565b90506000836001600160a01b031663d21220a76040518163ffffffff1660e01b8152600401602060405180830381865afa158015612ca4573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612cc89190613ed3565b9050876001600160a01b0316826001600160a01b0316148015612cfc5750866001600160a01b0316816001600160a01b0316145b158015612d385750866001600160a01b0316826001600160a01b0316148015612d365750876001600160a01b0316816001600160a01b0316145b155b15612d4d575060009998505050505050505050565b60128660ff161180612d62575060128560ff16115b15612d77575060009998505050505050505050565b8263ffffffff16600003612d95575060009998505050505050505050565b6040805160028082526060820183526000926020830190803683370190505090508381600081518110612dca57612dca613e6a565b602002602001019063ffffffff16908163ffffffff1681525050600081600181518110612df957612df9613e6a565b63ffffffff9092166020928302919091019091015260405163883bdbfd60e01b81526001600160a01b0386169063883bdbfd90612e3a908490600401614143565b600060405180830381865afa158015612e57573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052612e7f91908101906141f5565b5060019c9b505050505050505050505050565b60408101515160009015612ea857506000919050565b816020015151606014612ebd57506000919050565b60008060008460200151806020019051810190612eda91906144bf565b919450925090508281612f55576040516396834ad360e01b8152600481018490526001600160a01b038216906396834ad390602401608060405180830381865afa158015612f2c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612f5091906144f5565b612fbe565b604051639474f45b60e01b8152600481018490526001600160a01b03821690639474f45b90602401608060405180830381865afa158015612f9a573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612fbe91906144f5565b5060019695505050505050565b60408101515160009015612fe157506000919050565b816020015151606014612ff657506000919050565b8160200151806020019051810190612aa39190614597565b60008160400151516002148061302957508160400151516003145b61303557506000919050565b81602001515160201461304a57506000919050565b506001919050565b600081604001515160011480613029575081604001515160021461303557506000919050565b6040810151516000901561308e57506000919050565b6020826020015151101561304a57506000919050565b81818082036130b4575050505050565b6000856130da60026130c6888861446c565b6130d09190614640565b6112c0908861456f565b815181106130ea576130ea613e6a565b60200260200101516000015190505b818313613236575b808661310c85612686565b8151811061311c5761311c613e6a565b60200260200101516000015112156131405782613138816148a6565b935050613101565b8561314a83612686565b8151811061315a5761315a613e6a565b60200260200101516000015181121561317f5781613177816148be565b925050613140565b818313613231578561319083612686565b815181106131a0576131a0613e6a565b6020026020010151866131b285612686565b815181106131c2576131c2613e6a565b6020026020010151876131d486612686565b815181106131e4576131e4613e6a565b60200260200101886131f586612686565b8151811061320557613205613e6a565b602002602001018290528290525050828061321f906148a6565b935050818061322d906148be565b9250505b6130f9565b81851215613249576132498686846130a4565b8383121561325c5761325c8684866130a4565b505050505050565b6000670de0b6b3a764000061327983856147e8565b6102b49190614640565b600081613279670de0b6b3a7640000856147e8565b60008060008360020b126132b8576132b3600284900b612686565b6132c8565b6132c86112c0600285900b614493565b90506132e36112c06132dd620d89e7196148db565b60020b90565b8111156133165760405162461bcd60e51b81526020600482015260016024820152601560fa1b6044820152606401610397565b60008160011660000361332d57600160801b61333f565b6ffffcb933bd6fad37aa2d162d1a5940015b70ffffffffffffffffffffffffffffffffff169050600282161561337e576080613379826ffff97272373d413259a46990580e213a614859565b901c90505b60048216156133a85760806133a3826ffff2e50f5f656932ef12357cf3c7fdcc614859565b901c90505b60088216156133d25760806133cd826fffe5caca7e10e4e61c3624eaa0941cd0614859565b901c90505b60108216156133fc5760806133f7826fffcb9843d60f6159c9db58835c926644614859565b901c90505b6020821615613426576080613421826fff973b41fa98c081472e6896dfb254c0614859565b901c90505b604082161561345057608061344b826fff2ea16466c96a3843ec78b326b52861614859565b901c90505b608082161561347a576080613475826ffe5dee046a99a2a811c461f1969c3053614859565b901c90505b6101008216156134a55760806134a0826ffcbe86c7900a88aedcffc83b479aa3a4614859565b901c90505b6102008216156134d05760806134cb826ff987a7253ac413176f2b074cf7815e54614859565b901c90505b6104008216156134fb5760806134f6826ff3392b0822b70005940c7a398e4b70f3614859565b901c90505b610800821615613526576080613521826fe7159475a2c29b7443b29c7fa6e889d9614859565b901c90505b61100082161561355157608061354c826fd097f3bdfd2022b8845ad8f792aa5825614859565b901c90505b61200082161561357c576080613577826fa9f746462d870fdf8a65dc1f90e061e5614859565b901c90505b6140008216156135a75760806135a2826f70d869a156d2a1b890bb3df62baf32f7614859565b901c90505b6180008216156135d25760806135cd826f31be135f97d08fd981231505542fcfa6614859565b901c90505b620100008216156135fe5760806135f9826f09aa508b5b7a84e1c677de54f3e99bc9614859565b901c90505b62020000821615613629576080613624826e5d6af8dedb81196699c329225ee604614859565b901c90505b6204000082161561365357608061364e826d2216e584f5fa1ea926041bedfe98614859565b901c90505b6208000082161561367b576080613676826b048a170391f7dc42444e8fa2614859565b901c90505b60008460020b131561369657613693816000196147c0565b90505b6102ce6136a8640100000000836147d4565b156136b45760016136b7565b60005b6136c89060ff16602084901c6147ad565b6139ba565b6000808060001985870985870292508281108382030391505080600003613749576000841161373e5760405162461bcd60e51b815260206004820152601960248201527f48616e646c65206e6f6e2d6f766572666c6f77206361736573000000000000006044820152606401610397565b5082900490506102b4565b8084116137985760405162461bcd60e51b815260206004820152601960248201527f70726576656e74732064656e6f6d696e61746f72203d3d2030000000000000006044820152606401610397565b60008486880980840393811190920391905060006137d06137b887612569565b6137c188612569565b6137ca90614493565b16612686565b9586900495938490049360008190030460010190506137ef8184614859565b909317926000613800876003614859565b600218905061380f8188614859565b61381a9060026140a7565b6138249082614859565b90506138308188614859565b61383b9060026140a7565b6138459082614859565b90506138518188614859565b61385c9060026140a7565b6138669082614859565b90506138728188614859565b61387d9060026140a7565b6138879082614859565b90506138938188614859565b61389e9060026140a7565b6138a89082614859565b90506138b48188614859565b6138bf9060026140a7565b6138c99082614859565b90506138d58186614859565b9998505050505050505050565b604080516001600160e01b0319831660248083019190915282518083039091018152604490910182526020810180516001600160e01b03166301ffc9a760e01b1790529051600091829182916001600160a01b0387169161394391906148fd565b6000604051808303816000865af19150503d8060008114613980576040519150601f19603f3d011682016040523d82523d6000602084013e613985565b606091505b50915091508161399a57600092505050610116565b80516000036139ae57600092505050610116565b60200151949350505050565b60006001600160a01b038211156125295760405163dccde8ed60e01b815260040160405180910390fd5b6040518060800160405280600081526020016000815260200160008152602001600081525090565b828054828255906000526020600020908101928215613a47579160200282015b82811115613a47578251825591602001919060010190613a2c565b506125299291505b808211156125295760008155600101613a4f565b600060208284031215613a7557600080fd5b5035919050565b8151815260208083015190820152604080830151908201526060808301519082015260808101610116565b634e487b7160e01b600052602160045260246000fd5b600a8110613acd57613acd613aa7565b9052565b60005b83811015613aec578181015183820152602001613ad4565b50506000910152565b60008151808452613b0d816020860160208601613ad1565b601f01601f19169290920160200192915050565b60006020808352613b358184018551613abd565b8084015160606040850152613b4d6080850182613af5565b6040860151858203601f19016060870152805180835290840192506000918401905b80831015613b8f5783518252928401926001929092019190840190613b6f565b509695505050505050565b634e487b7160e01b600052604160045260246000fd5b6040516080810167ffffffffffffffff81118282101715613bd357613bd3613b9a565b60405290565b604051601f8201601f1916810167ffffffffffffffff81118282101715613c0257613c02613b9a565b604052919050565b600067ffffffffffffffff821115613c2457613c24613b9a565b5060051b60200190565b600082601f830112613c3f57600080fd5b81356020613c54613c4f83613c0a565b613bd9565b8083825260208201915060208460051b870101935086841115613c7657600080fd5b602086015b84811015613b8f5780358352918301918301613c7b565b600080600060608486031215613ca757600080fd5b8335600a8110613cb657600080fd5b925060208481013567ffffffffffffffff80821115613cd457600080fd5b818701915087601f830112613ce857600080fd5b813581811115613cfa57613cfa613b9a565b613d0c601f8201601f19168501613bd9565b8181528985838601011115613d2057600080fd5b818585018683013760009181019094015291935060408601359180831115613d4757600080fd5b5050613d5586828701613c2e565b9150509250925092565b600080600060608486031215613d7457600080fd5b83359250602084013567ffffffffffffffff80821115613d9357600080fd5b613d9f87838801613c2e565b93506040860135915080821115613db557600080fd5b50613d5586828701613c2e565b600181811c90821680613dd657607f821691505b602082108103611d0757634e487b7160e01b600052602260045260246000fd5b60008151808452602080850194506020840160005b83811015613e2757815187529582019590820190600101613e0b565b509495945050505050565b848152613e426020820185613abd565b608060408201526000613e586080830185613af5565b828103606084015261189a8185613df6565b634e487b7160e01b600052603260045260246000fd5b600060208284031215613e9257600080fd5b8151600981106102b457600080fd5b6020810160098310613eb557613eb5613aa7565b91905290565b6001600160a01b0381168114613ed057600080fd5b50565b600060208284031215613ee557600080fd5b81516102b481613ebb565b608080825285518282018190526000919060209060a0850190828a01855b82811015613f5257613f42848351805182526020810151602083015260408101516040830152606081015160608301525050565b9285019290840190600101613f0e565b5050508481036020860152613f678189613af5565b925050508281036040840152613f7d8186613df6565b9050828103606084015261189a8185613df6565b600060808284031215613fa357600080fd5b613fab613bb0565b825181526020830151602082015260408301516040820152606083015160608201528091505092915050565b805160ff8116811461200457600080fd5b600080600060608486031215613ffd57600080fd5b835161400881613ebb565b6020850151909350915061401e60408501613fd7565b90509250925092565b805169ffffffffffffffffffff8116811461200457600080fd5b600080600080600060a0868803121561405957600080fd5b61406286614027565b945060208601519350604086015192506060860151915061408560808701614027565b90509295509295909350565b634e487b7160e01b600052601160045260246000fd5b8181038181111561011657610116614091565b60008060008060008060c087890312156140d357600080fd5b86516140de81613ebb565b60208801519096506140ef81613ebb565b94506140fd60408801613fd7565b935061410b60608801613fd7565b9250608087015161411b81613ebb565b60a088015190925063ffffffff8116811461413557600080fd5b809150509295509295509295565b6020808252825182820181905260009190848201906040850190845b8181101561418157835163ffffffff168352928401929184019160010161415f565b50909695505050505050565b600082601f83011261419e57600080fd5b815160206141ae613c4f83613c0a565b8083825260208201915060208460051b8701019350868411156141d057600080fd5b602086015b84811015613b8f5780516141e881613ebb565b83529183019183016141d5565b6000806040838503121561420857600080fd5b825167ffffffffffffffff8082111561422057600080fd5b818501915085601f83011261423457600080fd5b81516020614244613c4f83613c0a565b82815260059290921b8401810191818101908984111561426357600080fd5b948201945b838610156142915785518060060b81146142825760008081fd5b82529482019490820190614268565b918801519196509093505050808211156142aa57600080fd5b506142b78582860161418d565b9150509250929050565b600682810b9082900b03667fffffffffffff198112667fffffffffffff8213171561011657610116614091565b634e487b7160e01b600052601260045260246000fd5b60008160060b8360060b8061431b5761431b6142ee565b667fffffffffffff1982146000198214161561433957614339614091565b90059392505050565b600082614351576143516142ee565b500790565b60008160020b627fffff19810361436f5761436f614091565b6000190192915050565b600181815b808511156143b457816000190482111561439a5761439a614091565b808516156143a757918102915b93841c939080029061437e565b509250929050565b6000826143cb57506001610116565b816143d857506000610116565b81600181146143ee57600281146143f857614414565b6001915050610116565b60ff84111561440957614409614091565b50506001821b610116565b5060208310610133831016604e8410600b8410161715614437575081810a610116565b6144418383614379565b806000190482111561445557614455614091565b029392505050565b60006102b460ff8416836143bc565b818103600083128015838313168383128216171561448c5761448c614091565b5092915050565b6000600160ff1b82016144a8576144a8614091565b5060000390565b8051801515811461200457600080fd5b6000806000606084860312156144d457600080fd5b83516144df81613ebb565b6020850151909350915061401e604085016144af565b60006080828403121561450757600080fd5b61450f613bb0565b82518060070b811461452057600080fd5b8152602083015167ffffffffffffffff8116811461453d57600080fd5b60208201526040830151600381900b811461455757600080fd5b60408201526060928301519281019290925250919050565b808201828112600083128015821682158216171561458f5761458f614091565b505092915050565b6000806000606084860312156145ac57600080fd5b83516145b781613ebb565b602085015160409095015190969495509392505050565b60ff8416815267ffffffffffffffff831660208201526060604082015260006145fa6060830184613df6565b95945050505050565b6001600160a01b03831681526040602082018190526000906102ce90830184613af5565b60006020828403121561463957600080fd5b5051919050565b60008261464f5761464f6142ee565b600160ff1b82146000198414161561466957614669614091565b500590565b6146788185613abd565b60606020820152600061468e6060830185613af5565b8281036040840152610f4f8185613df6565b601f8211156146e8576000816000526020600020601f850160051c810160208610156146c95750805b601f850160051c820191505b8181101561325c578281556001016146d5565b505050565b815167ffffffffffffffff81111561470757614707613b9a565b61471b816147158454613dc2565b846146a0565b602080601f83116001811461475057600084156147385750858301515b600019600386901b1c1916600185901b17855561325c565b600085815260208120601f198616915b8281101561477f57888601518255948401946001909101908401614760565b508582101561479d5787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b8082018082111561011657610116614091565b6000826147cf576147cf6142ee565b500490565b6000826147e3576147e36142ee565b500690565b80820260008212600160ff1b8414161561480457614804614091565b818105831482151761011657610116614091565b600069ffffffffffffffffffff82168061436f5761436f614091565b60006001820161484657614846614091565b5060010190565b60006102b483836143bc565b808202811582820484141761011657610116614091565b60006020828403121561488257600080fd5b6102b4826144af565b60006020828403121561489d57600080fd5b6102b482613fd7565b60006001600160ff1b01820161484657614846614091565b6000600160ff1b82016148d3576148d3614091565b506000190190565b60008160020b627fffff1981036148f4576148f4614091565b60000392915050565b6000825161490f818460208701613ad1565b919091019291505056fea264697066735822122074f32fef384fdc296b0859f1c1f941c8e736c6cb972aa9e2b894956ebd6a80b364736f6c63430008160033\",\"storage\":{}},\"0x83a0444b93927c3afcbe46e522280390f748e171\":{\"nonce\":1,\"balance\":\"0x0\",\"code\":\"0x6080604052366100135761001161001d565b005b61001b61001d565b005b6000610027610093565b90503660008037600080366000845af43d6000803e806000811461004a573d6000f35b3d6000fd5b600080823b905060008111915050919050565b6000806040516020016100749061017a565b6040516020818303038152906040528051906020012090508091505090565b600061009d6100c6565b60000160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905090565b6000806040516020016100d89061020c565b6040516020818303038152906040528051906020012090508091505090565b600082825260208201905092915050565b7f696f2e73796e7468657469782e636f72652d636f6e7472616374732e4f776e6160008201527f626c650000000000000000000000000000000000000000000000000000000000602082015250565b60006101646023836100f7565b915061016f82610108565b604082019050919050565b6000602082019050818103600083015261019381610157565b9050919050565b7f696f2e73796e7468657469782e636f72652d636f6e7472616374732e50726f7860008201527f7900000000000000000000000000000000000000000000000000000000000000602082015250565b60006101f66021836100f7565b91506102018261019a565b604082019050919050565b60006020820190508181036000830152610225816101e9565b905091905056fea2646970667358221220800da1f73cebd5e4afa07496d9bca6b6c4f526bdd3f4014ec15c70fe3a1c441364736f6c63430008110033\",\"storage\":{\"0x5a648c35a2f5512218b4683cf10e03f5b7c9dc7346e1bf77d304ae97f60f592b\":\"0x108f53faf774d7c4c56f5bce9ca6e605ce8aeadd\",\"0x5c7865864a2a990d80b5bb5c40e7b73a029960dc711fbb56120dfab976e92ea3\":\"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\"}},\"0x90f79bf6eb2c4f870365e785982e1f101e93b906\":{\"nonce\":0,\"balance\":\"0x21e19e0c9bab2400000\",\"code\":\"0x\",\"storage\":{}},\"0x976ea74026e726554db657fa54763abd0c3a0aa9\":{\"nonce\":0,\"balance\":\"0x21e19e0c9bab2400000\",\"code\":\"0x\",\"storage\":{}},\"0x9965507d1a55bcc2695c58ba16fb37d819b0a4dc\":{\"nonce\":0,\"balance\":\"0x21e19e0c9bab2400000\",\"code\":\"0x\",\"storage\":{}},\"0xa0ee7a142d267c1f36714e4a8f75612f20a79720\":{\"nonce\":0,\"balance\":\"0x21e19e0c9bab2400000\",\"code\":\"0x\",\"storage\":{}},\"0xc67e2bd3108604cf0168c0e5ef9cd6d78b9bb14b\":{\"nonce\":1,\"balance\":\"0x21e19c6edb7e2445f20\",\"code\":\"0x\",\"storage\":{}},\"0xeb045d78d273107348b0300c01d29b7552d622ab\":{\"nonce\":0,\"balance\":\"0x21e19e0c9bab2400000\",\"code\":\"0x\",\"storage\":{}},\"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\":{\"nonce\":1,\"balance\":\"0x21e19e08b86820a43ea\",\"code\":\"0x\",\"storage\":{}}},\"best_block_number\":5,\"blocks\":[{\"header\":{\"parentHash\":\"0x08abe6e453727534d8dd708843a7522b7d500338bdfe2402ca105dcdb05eebe9\",\"sha3Uncles\":\"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\"miner\":\"0x0000000000000000000000000000000000000000\",\"stateRoot\":\"0xcd346446ed010523161f40a5f2b512def549bfb79e165b4354488738416481f2\",\"transactionsRoot\":\"0xb3a4689832e0b599260ae70362ffcf224b60571b35ff8836904a3d81e2675d66\",\"receiptsRoot\":\"0x2d13fdc120ab90536fed583939de7fb68b64926a306c1f629593ca9c2c93b198\",\"logsBloom\":\"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\"difficulty\":\"0x0\",\"number\":\"0x1\",\"gasLimit\":\"0x1c9c380\",\"gasUsed\":\"0x3ea90d\",\"timestamp\":\"0x66b200ca\",\"mixHash\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"nonce\":\"0x0000000000000000\",\"baseFeePerGas\":\"0x2e0b6260\",\"blobGasUsed\":\"0x0\",\"excessBlobGas\":\"0x0\",\"extraData\":\"0x\"},\"transactions\":[{\"chainId\":\"0x343a\",\"nonce\":\"0x0\",\"gas\":\"0x3ea90d\",\"maxFeePerGas\":\"0x83215600\",\"maxPriorityFeePerGas\":\"0x3b9aca00\",\"value\":\"0x0\",\"accessList\":[],\"input\":\"0x608060405234801561001057600080fd5b5061494f806100206000396000f3fe608060405234801561001057600080fd5b50600436106100575760003560e01c80632a952b2d1461005c57806350c946fe14610085578063625ca21c146100a5578063daa250be146100c6578063deba1b98146100d9575b600080fd5b61006f61006a366004613a63565b6100ec565b60405161007c9190613a7c565b60405180910390f35b610098610093366004613a63565b61011c565b60405161007c9190613b21565b6100b86100b3366004613c92565b610276565b60405190815260200161007c565b61006f6100d4366004613d5f565b6102bb565b6100b86100e7366004613c92565b6102d6565b6100f46139e4565b6040805160008082526020820190815281830190925261011691849190610310565b92915050565b6101416040805160608101909152806000815260200160608152602001606081525090565b61014a82610ab6565b60408051606081019091528154909190829060ff16600981111561017057610170613aa7565b600981111561018157610181613aa7565b815260200160018201805461019590613dc2565b80601f01602080910402602001604051908101604052809291908181526020018280546101c190613dc2565b801561020e5780601f106101e35761010080835404028352916020019161020e565b820191906000526020600020905b8154815290600101906020018083116101f157829003601f168201915b505050505081526020016002820180548060200260200160405190810160405280929190818152602001828054801561026657602002820191906000526020600020905b815481526020019060010190808311610252575b5050505050815250509050919050565b600080604051806060016040528086600981111561029657610296613aa7565b81526020018581526020018481525090506102b081610ac1565b9150505b9392505050565b6102c36139e4565b6102ce848484610310565b949350505050565b60008060405180606001604052808660098111156102f6576102f6613aa7565b81526020018581526020018481525090506102b081610acc565b6103186139e4565b81518351146103a05760408051634bab873760e11b81526004810191909152600d60448201526c72756e74696d6556616c75657360981b606482015260806024820152602260848201527f6d7573742062652073616d65206c656e6774682061732072756e74696d654b6560a482015261797360f01b60c482015260e4015b60405180910390fd5b60006103ab85610c26565b805490915060ff1660018160098111156103c7576103c7613aa7565b036104755761046c6103da838787610c84565b8360010180546103e990613dc2565b80601f016020809104026020016040519081016040528092919081815260200182805461041590613dc2565b80156104625780601f1061043757610100808354040283529160200191610462565b820191906000526020600020905b81548152906001019060200180831161044557829003601f168201915b5050505050610d46565b925050506102b4565b600281600981111561048957610489613aa7565b036105305761046c61049c838787610c84565b8360010180546104ab90613dc2565b80601f01602080910402602001604051908101604052809291908181526020018280546104d790613dc2565b80156105245780601f106104f957610100808354040283529160200191610524565b820191906000526020600020905b81548152906001019060200180831161050757829003601f168201915b50505050508787610ebb565b600381600981111561054457610544613aa7565b036105de5761046c82600101805461055b90613dc2565b80601f016020809104026020016040519081016040528092919081815260200182805461058790613dc2565b80156105d45780601f106105a9576101008083540402835291602001916105d4565b820191906000526020600020905b8154815290600101906020018083116105b757829003601f168201915b5050505050610f59565b60048160098111156105f2576105f2613aa7565b0361068c5761046c82600101805461060990613dc2565b80601f016020809104026020016040519081016040528092919081815260200182805461063590613dc2565b80156106825780601f1061065757610100808354040283529160200191610682565b820191906000526020600020905b81548152906001019060200180831161066557829003601f168201915b5050505050611087565b60058160098111156106a0576106a0613aa7565b0361073a5761046c8260010180546106b790613dc2565b80601f01602080910402602001604051908101604052809291908181526020018280546106e390613dc2565b80156107305780601f1061070557610100808354040283529160200191610730565b820191906000526020600020905b81548152906001019060200180831161071357829003601f168201915b505050505061131e565b600981600981111561074e5761074e613aa7565b036107ea5761046c82600101805461076590613dc2565b80601f016020809104026020016040519081016040528092919081815260200182805461079190613dc2565b80156107de5780601f106107b3576101008083540402835291602001916107de565b820191906000526020600020905b8154815290600101906020018083116107c157829003601f168201915b505050505086866114b5565b60068160098111156107fe576107fe613aa7565b036108a35761046c610811838787610c84565b83600101805461082090613dc2565b80601f016020809104026020016040519081016040528092919081815260200182805461084c90613dc2565b80156108995780601f1061086e57610100808354040283529160200191610899565b820191906000526020600020905b81548152906001019060200180831161087c57829003601f168201915b50505050506115c7565b60078160098111156108b7576108b7613aa7565b036109ec576040805160608101909152825461046c91908490829060ff1660098111156108e6576108e6613aa7565b60098111156108f7576108f7613aa7565b815260200160018201805461090b90613dc2565b80601f016020809104026020016040519081016040528092919081815260200182805461093790613dc2565b80156109845780601f1061095957610100808354040283529160200191610984565b820191906000526020600020905b81548152906001019060200180831161096757829003601f168201915b50505050508152602001600282018054806020026020016040519081016040528092919081815260200182805480156109dc57602002820191906000526020600020905b8154815260200190600101908083116109c8575b5050505050815250508686611728565b6008816009811115610a0057610a00613aa7565b03610a9a5761046c826001018054610a1790613dc2565b80601f0160208091040260200160405190810160405280929190818152602001828054610a4390613dc2565b8015610a905780601f10610a6557610100808354040283529160200191610a90565b820191906000526020600020905b815481529060010190602001808311610a7357829003601f168201915b50505050506118a5565b6040516323a9bbc960e01b815260048101879052602401610397565b600061011682610c26565b6000610116826118ea565b6000610ad782610ac1565b9050610ae28161192a565b15610b35577fcb64985827770858ec421ad26da7e558c757541643036ce44d6b4eb9e8e5dc5e81836000015184602001518560400151604051610b289493929190613e32565b60405180910390a1919050565b610b3e82611a8c565b610b5d578160405163382bbbc960e11b81526004016103979190613b21565b60005b826040015151811015610bd957610b9383604001518281518110610b8657610b86613e6a565b602002602001015161192a565b610bd15782604001518181518110610bad57610bad613e6a565b6020026020010151604051632f19f96160e11b815260040161039791815260200190565b600101610b60565b50610be382611c31565b8351602085015160408087015190519395507fcb64985827770858ec421ad26da7e558c757541643036ce44d6b4eb9e8e5dc5e9450610b28938693929190613e32565b604080516020808201839052606082018190527f696f2e73796e7468657469782e6f7261636c652d6d616e616765722e4e6f6465608080840191909152828401949094528251808303909401845260a0909101909152815191012090565b600283015460609067ffffffffffffffff811115610ca457610ca4613b9a565b604051908082528060200260200182016040528015610cdd57816020015b610cca6139e4565b815260200190600190039081610cc25790505b50905060005b6002850154811015610d3e57610d19856002018281548110610d0757610d07613e6a565b90600052602060002001548585610310565b828281518110610d2b57610d2b613e6a565b6020908102919091010152600101610ce3565b509392505050565b610d4e6139e4565b600082806020019051810190610d649190613e80565b90506000816008811115610d7a57610d7a613aa7565b03610d9057610d8884611ca5565b915050610116565b6001816008811115610da457610da4613aa7565b03610db257610d8884611d0d565b6002816008811115610dc657610dc6613aa7565b03610dd457610d8884611d90565b6003816008811115610de857610de8613aa7565b03610df657610d8884611e13565b6004816008811115610e0a57610e0a613aa7565b03610e1857610d8884611ec9565b6005816008811115610e2c57610e2c613aa7565b03610e3a57610d8884612009565b6006816008811115610e4e57610e4e613aa7565b03610e5c57610d88846120e4565b6007816008811115610e7057610e70613aa7565b03610e7e57610d888461220c565b6008816008811115610e9257610e92613aa7565b03610ea057610d88846122ce565b80604051631be413d360e11b81526004016103979190613ea1565b610ec36139e4565b600084806020019051810190610ed99190613ed3565b604051631ecba7c360e31b81529091506001600160a01b0382169063f65d3e1890610f0e908990899089908990600401613ef0565b608060405180830381865afa158015610f2b573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f4f9190613f91565b9695505050505050565b610f616139e4565b600080600084806020019051810190610f7a9190613fe8565b92509250925060008390506000806000836001600160a01b031663feaf968c6040518163ffffffff1660e01b815260040160a060405180830381865afa158015610fc8573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610fec9190614041565b509350509250925060008660001461100f5761100a8585858a6123c7565b611011565b825b905060128660ff161161103b5761103661102f60ff881660126140a7565b82906124c2565b611053565b61105361104c601260ff89166140a7565b82906124dc565b9050604051806080016040528082815260200183815260200160008152602001600081525098505050505050505050919050565b61108f6139e4565b600080600080600080878060200190518101906110ac91906140ba565b604080516002808252606082018352979d50959b50939950919750955093506000929060208301908036833701905050905081816000815181106110f2576110f2613e6a565b602002602001019063ffffffff16908163ffffffff168152505060008160018151811061112157611121613e6a565b63ffffffff9092166020928302919091019091015260405163883bdbfd60e01b81526000906001600160a01b0385169063883bdbfd90611165908590600401614143565b600060405180830381865afa158015611182573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526111aa91908101906141f5565b5090506000816000815181106111c2576111c2613e6a565b6020026020010151826001815181106111dd576111dd613e6a565b60200260200101516111ef91906142c1565b9050600061121761120563ffffffff87166124f6565b61120f9084614304565b60060b61252d565b905060008260060b12801561124c575061123b63ffffffff8616612569565b612569565b8260060b6112499190614342565b15155b1561125f578061125b81614356565b9150505b600061126d6012600a61445d565b9050600061128061123684848f8f612593565b905060006112908a60ff16612569565b61129c8c60ff16612569565b6112a6919061446c565b905060008082136112d1576112cc6112c56112c084614493565b612686565b84906124dc565b6112e4565b6112e46112dd83612686565b84906124c2565b905060405180608001604052808281526020014281526020016000815260200160008152509e505050505050505050505050505050919050565b6113266139e4565b60008060008480602001905181019061133f91906144bf565b91945092509050826000826113bc576040516396834ad360e01b8152600481018590526001600160a01b038316906396834ad390602401608060405180830381865afa158015611393573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906113b791906144f5565b611425565b604051639474f45b60e01b8152600481018590526001600160a01b03831690639474f45b90602401608060405180830381865afa158015611401573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061142591906144f5565b90506000816040015160030b601261143d919061456f565b90506000808213611467576114626114576112c084614493565b845160070b906124dc565b61147e565b61147e61147383612686565b845160070b906124c2565b9050604051806080016040528082815260200184606001518152602001600081526020016000815250975050505050505050919050565b6114bd6139e4565b6000806000868060200190518101906114d69190614597565b92509250925060005b8651811015611545578681815181106114fa576114fa613e6a565b6020026020010151717374616c656e657373546f6c6572616e636560701b0361153d5785818151811061152f5761152f613e6a565b602002602001015160001c91505b6001016114df565b5060408051600180825281830190925260009160208083019080368337019050509050828160008151811061157c5761157c613e6a565b602002602001018181525050836001838360405160200161159f939291906145ce565b60408051601f198184030181529082905263cf2cabdf60e01b82526103979291600401614603565b6115cf6139e4565b6000828060200190518101906115e59190614627565b90506000846000815181106115fc576115fc613e6a565b602002602001015160000151905060008560018151811061161f5761161f613e6a565b6020026020010151600001519050808214611702576000611653601261164d611648858761446c565b6126a9565b906124c2565b905082158061167b5750611666836126a9565b6116709082614640565b61167985612569565b125b15611700576002875111156116b0578660028151811061169d5761169d613e6a565b6020026020010151945050505050610116565b826000036116d15760405163014cc07160e01b815260040160405180910390fd5b6116da836126a9565b6116e49082614640565b60405163dcac091960e01b815260040161039791815260200190565b505b8560008151811061171557611715613e6a565b6020026020010151935050505092915050565b6117306139e4565b6000846020015180602001905181019061174a9190614627565b905060005b84518110156117bc5784818151811061176a5761176a613e6a565b6020026020010151717374616c656e657373546f6c6572616e636560701b036117b4576117ad8482815181106117a2576117a2613e6a565b602002602001015190565b91506117bc565b60010161174f565b50600085604001516000815181106117d6576117d6613e6a565b6020026020010151905060006117ed828787610310565b60208101519091506117ff84426140a7565b1161180e5792506102b4915050565b86604001515160010361187157866040015160008151811061183257611832613e6a565b602002602001015181600001518260200151604051631808066560e21b8152600401610397939291909283526020830191909152604082015260600190565b61189a876040015160018151811061188b5761188b613e6a565b60200260200101518787610310565b979650505050505050565b6118ad6139e4565b6040518060800160405280838060200190518101906118cc9190614627565b81526020014281526020016000815260200160008152509050919050565b600081600001518260200151836040015160405160200161190d9392919061466e565b604051602081830303815290604052805190602001209050919050565b60008061193683610c26565b60408051606081019091528154909190829060ff16600981111561195c5761195c613aa7565b600981111561196d5761196d613aa7565b815260200160018201805461198190613dc2565b80601f01602080910402602001604051908101604052809291908181526020018280546119ad90613dc2565b80156119fa5780601f106119cf576101008083540402835291602001916119fa565b820191906000526020600020905b8154815290600101906020018083116119dd57829003601f168201915b5050505050815260200160028201805480602002602001604051908101604052809291908181526020018280548015611a5257602002820191906000526020600020905b815481526020019060010190808311611a3e575b505050505081525050905060006009811115611a7057611a70613aa7565b81516009811115611a8357611a83613aa7565b14159392505050565b6000600182516009811115611aa357611aa3613aa7565b1480611ac15750600682516009811115611abf57611abf613aa7565b145b80611ade5750600782516009811115611adc57611adc613aa7565b145b15611aee57611aec826126c1565b505b600182516009811115611b0357611b03613aa7565b03611b11576101168261284a565b600282516009811115611b2657611b26613aa7565b03611b3457610116826128a5565b600382516009811115611b4957611b49613aa7565b03611b575761011682612973565b600482516009811115611b6c57611b6c613aa7565b03611b7a5761011682612aae565b600582516009811115611b8f57611b8f613aa7565b03611b9d5761011682612e92565b600982516009811115611bb257611bb2613aa7565b03611bc05761011682612fcb565b600682516009811115611bd557611bd5613aa7565b03611be3576101168261300e565b600782516009811115611bf857611bf8613aa7565b03611c065761011682613052565b600882516009811115611c1b57611c1b613aa7565b03611c295761011682613078565b506000919050565b600080611c3d836118ea565b9050611c4881610c26565b8351815491935090839060ff19166001836009811115611c6a57611c6a613aa7565b021790555060208301516001830190611c8390826146ed565b5060408301518051611c9f916002850191602090910190613a0c565b50915091565b611cad6139e4565b60005b8251811015611d07578160200151838281518110611cd057611cd0613e6a565b6020026020010151602001511115611cff57828181518110611cf457611cf4613e6a565b602002602001015191505b600101611cb0565b50919050565b611d156139e4565b81600081518110611d2857611d28613e6a565b602002602001015190506000600190505b8251811015611d07578160000151838281518110611d5957611d59613e6a565b6020026020010151600001511215611d8857828181518110611d7d57611d7d613e6a565b602002602001015191505b600101611d39565b611d986139e4565b81600081518110611dab57611dab613e6a565b602002602001015190506000600190505b8251811015611d07578160000151838281518110611ddc57611ddc613e6a565b6020026020010151600001511315611e0b57828181518110611e0057611e00613e6a565b602002602001015191505b600101611dbc565b611e1b6139e4565b60005b8251811015611e9557828181518110611e3957611e39613e6a565b60200260200101516000015182600001818151611e56919061456f565b9052508251839082908110611e6d57611e6d613e6a565b60200260200101516020015182602001818151611e8a91906147ad565b905250600101611e1e565b50611ea08251612569565b8151611eac9190614640565b815281516020820151611ebf91906147c0565b6020820152919050565b611ed16139e4565b611eed826000611ee86001865161123691906140a7565b6130a4565b60028251611efb91906147d4565b600003611fd65760408051600280825260608201909252600091816020015b611f226139e4565b815260200190600190039081611f1a57905050905082600160028551611f4891906147c0565b611f5291906140a7565b81518110611f6257611f62613e6a565b602002602001015181600081518110611f7d57611f7d613e6a565b60200260200101819052508260028451611f9791906147c0565b81518110611fa757611fa7613e6a565b602002602001015181600181518110611fc257611fc2613e6a565b60200260200101819052506102b481611e13565b8160028351611fe591906147c0565b81518110611ff557611ff5613e6a565b60200260200101519050919050565b919050565b6120116139e4565b8160008151811061202457612024613e6a565b60209081029190910101515181528151829060009061204557612045613e6a565b6020908102919091018101518101519082015260015b82518110156120d25782818151811061207657612076613e6a565b6020026020010151600001518260000181815161209391906147e8565b90525082518390829081106120aa576120aa613e6a565b602002602001015160200151826020018181516120c791906147ad565b90525060010161205b565b5081518160200151611ebf91906147c0565b6120ec6139e4565b816000815181106120ff576120ff613e6a565b60209081029190910101515181528151829060009061212057612120613e6a565b6020908102919091018101518101519082015260015b82518110156120d25782818151811061215157612151613e6a565b60200260200101516000015160000361219e5782818151811061217657612176613e6a565b6020026020010151600001516040516338ee04a760e01b815260040161039791815260200190565b8281815181106121b0576121b0613e6a565b602002602001015160000151826000018181516121cd9190614640565b90525082518390829081106121e4576121e4613e6a565b6020026020010151602001518260200181815161220191906147ad565b905250600101612136565b6122146139e4565b8160008151811061222757612227613e6a565b60209081029190910101515181528151829060009061224857612248613e6a565b6020908102919091018101518101519082015260015b82518110156120d25761229083828151811061227c5761227c613e6a565b602090810291909101015151835190613264565b825282518390829081106122a6576122a6613e6a565b602002602001015160200151826020018181516122c391906147ad565b90525060010161225e565b6122d66139e4565b816000815181106122e9576122e9613e6a565b60209081029190910101515181528151829060009061230a5761230a613e6a565b6020908102919091018101518101519082015260015b82518110156120d25782818151811061233b5761233b613e6a565b6020026020010151600001516000036123605782818151811061217657612176613e6a565b61238983828151811061237557612375613e6a565b602090810291909101015151835190613283565b8252825183908290811061239f5761239f613e6a565b602002602001015160200151826020018181516123bc91906147ad565b905250600101612320565b6000826001826123d785426140a7565b90505b69ffffffffffffffffffff8716156124a3576001600160a01b038816639a6fc8f561240489614818565b6040516001600160e01b031960e084901b16815269ffffffffffffffffffff8216600482015290995060240160a060405180830381865afa925050508015612469575060408051601f3d908101601f1916820190925261246691810190614041565b60015b156124a357858210156124805750505050506124a3565b61248a848961456f565b97508661249681614834565b97505050505050506123da565b6124ac82612569565b6124b69084614640565b98975050505050505050565b60006124d261123683600a61484d565b6102b490846147e8565b60006124ec61123683600a61484d565b6102b49084614640565b6000667fffffffffffff66ffffffffffffff83161115612529576040516329d2678160e21b815260040160405180910390fd5b5090565b6000627fffff19600683900b128061254b5750627fffff600683900b135b1561252957604051630d962f7960e21b815260040160405180910390fd5b60006001600160ff1b038211156125295760405163677c430560e11b815260040160405180910390fd5b60008061259f86613298565b90506fffffffffffffffffffffffffffffffff6001600160a01b0382161161261c5760006125d66001600160a01b03831680614859565b9050836001600160a01b0316856001600160a01b03161061260557612600600160c01b87836136cd565b612614565b6126148187600160c01b6136cd565b92505061267d565b600061263b6001600160a01b03831680680100000000000000006136cd565b9050836001600160a01b0316856001600160a01b03161061266a57612665600160801b87836136cd565b612679565b6126798187600160801b6136cd565b9250505b50949350505050565b6000808212156125295760405163029f024d60e31b815260040160405180910390fd5b600080821215612529576126bc82614493565b610116565b6000805b8260400151518110156128415760006126fa846040015183815181106126ed576126ed613e6a565b6020026020010151610ab6565b60408051606081019091528154909190829060ff16600981111561272057612720613aa7565b600981111561273157612731613aa7565b815260200160018201805461274590613dc2565b80601f016020809104026020016040519081016040528092919081815260200182805461277190613dc2565b80156127be5780601f10612793576101008083540402835291602001916127be565b820191906000526020600020905b8154815290600101906020018083116127a157829003601f168201915b505050505081526020016002820180548060200260200160405190810160405280929190818152602001828054801561281657602002820191906000526020600020905b815481526020019060010190808311612802575b505050505081525050905061282a81611a8c565b612838575060009392505050565b506001016126c5565b50600192915050565b60006002826040015151101561286257506000919050565b81602001515160201461287757506000919050565b600082602001518060200190518101906128919190614627565b905060088111156128415750600092915050565b6000602082602001515110156128bd57506000919050565b600082602001518060200190518101906128d79190613ed3565b90506128ea816306e7ea3960e21b6138e2565b6128f75750600092915050565b604051633b70a5bf60e21b81526001600160a01b0382169063edc296fc90612923908690600401613b21565b6020604051808303816000875af1158015612942573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906129669190614870565b6128415750600092915050565b6040810151516000901561298957506000919050565b81602001515160601461299e57506000919050565b60008083602001518060200190518101906129b99190613fe8565b92505091506000829050806001600160a01b031663feaf968c6040518163ffffffff1660e01b815260040160a060405180830381865afa158015612a01573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612a259190614041565b5050505050806001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa158015612a68573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612a8c919061488b565b60ff168260ff1614612aa357506000949350505050565b506001949350505050565b60408101515160009015612ac457506000919050565b81602001515160c014612ad957506000919050565b6000806000806000808760200151806020019051810190612afa91906140ba565b9550955095509550955095508360ff16866001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa158015612b48573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612b6c919061488b565b60ff1614612b8257506000979650505050505050565b8260ff16856001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa158015612bc4573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612be8919061488b565b60ff1614612bfe57506000979650505050505050565b6000826001600160a01b0316630dfe16816040518163ffffffff1660e01b8152600401602060405180830381865afa158015612c3e573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612c629190613ed3565b90506000836001600160a01b031663d21220a76040518163ffffffff1660e01b8152600401602060405180830381865afa158015612ca4573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612cc89190613ed3565b9050876001600160a01b0316826001600160a01b0316148015612cfc5750866001600160a01b0316816001600160a01b0316145b158015612d385750866001600160a01b0316826001600160a01b0316148015612d365750876001600160a01b0316816001600160a01b0316145b155b15612d4d575060009998505050505050505050565b60128660ff161180612d62575060128560ff16115b15612d77575060009998505050505050505050565b8263ffffffff16600003612d95575060009998505050505050505050565b6040805160028082526060820183526000926020830190803683370190505090508381600081518110612dca57612dca613e6a565b602002602001019063ffffffff16908163ffffffff1681525050600081600181518110612df957612df9613e6a565b63ffffffff9092166020928302919091019091015260405163883bdbfd60e01b81526001600160a01b0386169063883bdbfd90612e3a908490600401614143565b600060405180830381865afa158015612e57573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052612e7f91908101906141f5565b5060019c9b505050505050505050505050565b60408101515160009015612ea857506000919050565b816020015151606014612ebd57506000919050565b60008060008460200151806020019051810190612eda91906144bf565b919450925090508281612f55576040516396834ad360e01b8152600481018490526001600160a01b038216906396834ad390602401608060405180830381865afa158015612f2c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612f5091906144f5565b612fbe565b604051639474f45b60e01b8152600481018490526001600160a01b03821690639474f45b90602401608060405180830381865afa158015612f9a573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612fbe91906144f5565b5060019695505050505050565b60408101515160009015612fe157506000919050565b816020015151606014612ff657506000919050565b8160200151806020019051810190612aa39190614597565b60008160400151516002148061302957508160400151516003145b61303557506000919050565b81602001515160201461304a57506000919050565b506001919050565b600081604001515160011480613029575081604001515160021461303557506000919050565b6040810151516000901561308e57506000919050565b6020826020015151101561304a57506000919050565b81818082036130b4575050505050565b6000856130da60026130c6888861446c565b6130d09190614640565b6112c0908861456f565b815181106130ea576130ea613e6a565b60200260200101516000015190505b818313613236575b808661310c85612686565b8151811061311c5761311c613e6a565b60200260200101516000015112156131405782613138816148a6565b935050613101565b8561314a83612686565b8151811061315a5761315a613e6a565b60200260200101516000015181121561317f5781613177816148be565b925050613140565b818313613231578561319083612686565b815181106131a0576131a0613e6a565b6020026020010151866131b285612686565b815181106131c2576131c2613e6a565b6020026020010151876131d486612686565b815181106131e4576131e4613e6a565b60200260200101886131f586612686565b8151811061320557613205613e6a565b602002602001018290528290525050828061321f906148a6565b935050818061322d906148be565b9250505b6130f9565b81851215613249576132498686846130a4565b8383121561325c5761325c8684866130a4565b505050505050565b6000670de0b6b3a764000061327983856147e8565b6102b49190614640565b600081613279670de0b6b3a7640000856147e8565b60008060008360020b126132b8576132b3600284900b612686565b6132c8565b6132c86112c0600285900b614493565b90506132e36112c06132dd620d89e7196148db565b60020b90565b8111156133165760405162461bcd60e51b81526020600482015260016024820152601560fa1b6044820152606401610397565b60008160011660000361332d57600160801b61333f565b6ffffcb933bd6fad37aa2d162d1a5940015b70ffffffffffffffffffffffffffffffffff169050600282161561337e576080613379826ffff97272373d413259a46990580e213a614859565b901c90505b60048216156133a85760806133a3826ffff2e50f5f656932ef12357cf3c7fdcc614859565b901c90505b60088216156133d25760806133cd826fffe5caca7e10e4e61c3624eaa0941cd0614859565b901c90505b60108216156133fc5760806133f7826fffcb9843d60f6159c9db58835c926644614859565b901c90505b6020821615613426576080613421826fff973b41fa98c081472e6896dfb254c0614859565b901c90505b604082161561345057608061344b826fff2ea16466c96a3843ec78b326b52861614859565b901c90505b608082161561347a576080613475826ffe5dee046a99a2a811c461f1969c3053614859565b901c90505b6101008216156134a55760806134a0826ffcbe86c7900a88aedcffc83b479aa3a4614859565b901c90505b6102008216156134d05760806134cb826ff987a7253ac413176f2b074cf7815e54614859565b901c90505b6104008216156134fb5760806134f6826ff3392b0822b70005940c7a398e4b70f3614859565b901c90505b610800821615613526576080613521826fe7159475a2c29b7443b29c7fa6e889d9614859565b901c90505b61100082161561355157608061354c826fd097f3bdfd2022b8845ad8f792aa5825614859565b901c90505b61200082161561357c576080613577826fa9f746462d870fdf8a65dc1f90e061e5614859565b901c90505b6140008216156135a75760806135a2826f70d869a156d2a1b890bb3df62baf32f7614859565b901c90505b6180008216156135d25760806135cd826f31be135f97d08fd981231505542fcfa6614859565b901c90505b620100008216156135fe5760806135f9826f09aa508b5b7a84e1c677de54f3e99bc9614859565b901c90505b62020000821615613629576080613624826e5d6af8dedb81196699c329225ee604614859565b901c90505b6204000082161561365357608061364e826d2216e584f5fa1ea926041bedfe98614859565b901c90505b6208000082161561367b576080613676826b048a170391f7dc42444e8fa2614859565b901c90505b60008460020b131561369657613693816000196147c0565b90505b6102ce6136a8640100000000836147d4565b156136b45760016136b7565b60005b6136c89060ff16602084901c6147ad565b6139ba565b6000808060001985870985870292508281108382030391505080600003613749576000841161373e5760405162461bcd60e51b815260206004820152601960248201527f48616e646c65206e6f6e2d6f766572666c6f77206361736573000000000000006044820152606401610397565b5082900490506102b4565b8084116137985760405162461bcd60e51b815260206004820152601960248201527f70726576656e74732064656e6f6d696e61746f72203d3d2030000000000000006044820152606401610397565b60008486880980840393811190920391905060006137d06137b887612569565b6137c188612569565b6137ca90614493565b16612686565b9586900495938490049360008190030460010190506137ef8184614859565b909317926000613800876003614859565b600218905061380f8188614859565b61381a9060026140a7565b6138249082614859565b90506138308188614859565b61383b9060026140a7565b6138459082614859565b90506138518188614859565b61385c9060026140a7565b6138669082614859565b90506138728188614859565b61387d9060026140a7565b6138879082614859565b90506138938188614859565b61389e9060026140a7565b6138a89082614859565b90506138b48188614859565b6138bf9060026140a7565b6138c99082614859565b90506138d58186614859565b9998505050505050505050565b604080516001600160e01b0319831660248083019190915282518083039091018152604490910182526020810180516001600160e01b03166301ffc9a760e01b1790529051600091829182916001600160a01b0387169161394391906148fd565b6000604051808303816000865af19150503d8060008114613980576040519150601f19603f3d011682016040523d82523d6000602084013e613985565b606091505b50915091508161399a57600092505050610116565b80516000036139ae57600092505050610116565b60200151949350505050565b60006001600160a01b038211156125295760405163dccde8ed60e01b815260040160405180910390fd5b6040518060800160405280600081526020016000815260200160008152602001600081525090565b828054828255906000526020600020908101928215613a47579160200282015b82811115613a47578251825591602001919060010190613a2c565b506125299291505b808211156125295760008155600101613a4f565b600060208284031215613a7557600080fd5b5035919050565b8151815260208083015190820152604080830151908201526060808301519082015260808101610116565b634e487b7160e01b600052602160045260246000fd5b600a8110613acd57613acd613aa7565b9052565b60005b83811015613aec578181015183820152602001613ad4565b50506000910152565b60008151808452613b0d816020860160208601613ad1565b601f01601f19169290920160200192915050565b60006020808352613b358184018551613abd565b8084015160606040850152613b4d6080850182613af5565b6040860151858203601f19016060870152805180835290840192506000918401905b80831015613b8f5783518252928401926001929092019190840190613b6f565b509695505050505050565b634e487b7160e01b600052604160045260246000fd5b6040516080810167ffffffffffffffff81118282101715613bd357613bd3613b9a565b60405290565b604051601f8201601f1916810167ffffffffffffffff81118282101715613c0257613c02613b9a565b604052919050565b600067ffffffffffffffff821115613c2457613c24613b9a565b5060051b60200190565b600082601f830112613c3f57600080fd5b81356020613c54613c4f83613c0a565b613bd9565b8083825260208201915060208460051b870101935086841115613c7657600080fd5b602086015b84811015613b8f5780358352918301918301613c7b565b600080600060608486031215613ca757600080fd5b8335600a8110613cb657600080fd5b925060208481013567ffffffffffffffff80821115613cd457600080fd5b818701915087601f830112613ce857600080fd5b813581811115613cfa57613cfa613b9a565b613d0c601f8201601f19168501613bd9565b8181528985838601011115613d2057600080fd5b818585018683013760009181019094015291935060408601359180831115613d4757600080fd5b5050613d5586828701613c2e565b9150509250925092565b600080600060608486031215613d7457600080fd5b83359250602084013567ffffffffffffffff80821115613d9357600080fd5b613d9f87838801613c2e565b93506040860135915080821115613db557600080fd5b50613d5586828701613c2e565b600181811c90821680613dd657607f821691505b602082108103611d0757634e487b7160e01b600052602260045260246000fd5b60008151808452602080850194506020840160005b83811015613e2757815187529582019590820190600101613e0b565b509495945050505050565b848152613e426020820185613abd565b608060408201526000613e586080830185613af5565b828103606084015261189a8185613df6565b634e487b7160e01b600052603260045260246000fd5b600060208284031215613e9257600080fd5b8151600981106102b457600080fd5b6020810160098310613eb557613eb5613aa7565b91905290565b6001600160a01b0381168114613ed057600080fd5b50565b600060208284031215613ee557600080fd5b81516102b481613ebb565b608080825285518282018190526000919060209060a0850190828a01855b82811015613f5257613f42848351805182526020810151602083015260408101516040830152606081015160608301525050565b9285019290840190600101613f0e565b5050508481036020860152613f678189613af5565b925050508281036040840152613f7d8186613df6565b9050828103606084015261189a8185613df6565b600060808284031215613fa357600080fd5b613fab613bb0565b825181526020830151602082015260408301516040820152606083015160608201528091505092915050565b805160ff8116811461200457600080fd5b600080600060608486031215613ffd57600080fd5b835161400881613ebb565b6020850151909350915061401e60408501613fd7565b90509250925092565b805169ffffffffffffffffffff8116811461200457600080fd5b600080600080600060a0868803121561405957600080fd5b61406286614027565b945060208601519350604086015192506060860151915061408560808701614027565b90509295509295909350565b634e487b7160e01b600052601160045260246000fd5b8181038181111561011657610116614091565b60008060008060008060c087890312156140d357600080fd5b86516140de81613ebb565b60208801519096506140ef81613ebb565b94506140fd60408801613fd7565b935061410b60608801613fd7565b9250608087015161411b81613ebb565b60a088015190925063ffffffff8116811461413557600080fd5b809150509295509295509295565b6020808252825182820181905260009190848201906040850190845b8181101561418157835163ffffffff168352928401929184019160010161415f565b50909695505050505050565b600082601f83011261419e57600080fd5b815160206141ae613c4f83613c0a565b8083825260208201915060208460051b8701019350868411156141d057600080fd5b602086015b84811015613b8f5780516141e881613ebb565b83529183019183016141d5565b6000806040838503121561420857600080fd5b825167ffffffffffffffff8082111561422057600080fd5b818501915085601f83011261423457600080fd5b81516020614244613c4f83613c0a565b82815260059290921b8401810191818101908984111561426357600080fd5b948201945b838610156142915785518060060b81146142825760008081fd5b82529482019490820190614268565b918801519196509093505050808211156142aa57600080fd5b506142b78582860161418d565b9150509250929050565b600682810b9082900b03667fffffffffffff198112667fffffffffffff8213171561011657610116614091565b634e487b7160e01b600052601260045260246000fd5b60008160060b8360060b8061431b5761431b6142ee565b667fffffffffffff1982146000198214161561433957614339614091565b90059392505050565b600082614351576143516142ee565b500790565b60008160020b627fffff19810361436f5761436f614091565b6000190192915050565b600181815b808511156143b457816000190482111561439a5761439a614091565b808516156143a757918102915b93841c939080029061437e565b509250929050565b6000826143cb57506001610116565b816143d857506000610116565b81600181146143ee57600281146143f857614414565b6001915050610116565b60ff84111561440957614409614091565b50506001821b610116565b5060208310610133831016604e8410600b8410161715614437575081810a610116565b6144418383614379565b806000190482111561445557614455614091565b029392505050565b60006102b460ff8416836143bc565b818103600083128015838313168383128216171561448c5761448c614091565b5092915050565b6000600160ff1b82016144a8576144a8614091565b5060000390565b8051801515811461200457600080fd5b6000806000606084860312156144d457600080fd5b83516144df81613ebb565b6020850151909350915061401e604085016144af565b60006080828403121561450757600080fd5b61450f613bb0565b82518060070b811461452057600080fd5b8152602083015167ffffffffffffffff8116811461453d57600080fd5b60208201526040830151600381900b811461455757600080fd5b60408201526060928301519281019290925250919050565b808201828112600083128015821682158216171561458f5761458f614091565b505092915050565b6000806000606084860312156145ac57600080fd5b83516145b781613ebb565b602085015160409095015190969495509392505050565b60ff8416815267ffffffffffffffff831660208201526060604082015260006145fa6060830184613df6565b95945050505050565b6001600160a01b03831681526040602082018190526000906102ce90830184613af5565b60006020828403121561463957600080fd5b5051919050565b60008261464f5761464f6142ee565b600160ff1b82146000198414161561466957614669614091565b500590565b6146788185613abd565b60606020820152600061468e6060830185613af5565b8281036040840152610f4f8185613df6565b601f8211156146e8576000816000526020600020601f850160051c810160208610156146c95750805b601f850160051c820191505b8181101561325c578281556001016146d5565b505050565b815167ffffffffffffffff81111561470757614707613b9a565b61471b816147158454613dc2565b846146a0565b602080601f83116001811461475057600084156147385750858301515b600019600386901b1c1916600185901b17855561325c565b600085815260208120601f198616915b8281101561477f57888601518255948401946001909101908401614760565b508582101561479d5787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b8082018082111561011657610116614091565b6000826147cf576147cf6142ee565b500490565b6000826147e3576147e36142ee565b500690565b80820260008212600160ff1b8414161561480457614804614091565b818105831482151761011657610116614091565b600069ffffffffffffffffffff82168061436f5761436f614091565b60006001820161484657614846614091565b5060010190565b60006102b483836143bc565b808202811582820484141761011657610116614091565b60006020828403121561488257600080fd5b6102b4826144af565b60006020828403121561489d57600080fd5b6102b482613fd7565b60006001600160ff1b01820161484657614846614091565b6000600160ff1b82016148d3576148d3614091565b506000190190565b60008160020b627fffff1981036148f4576148f4614091565b60000392915050565b6000825161490f818460208701613ad1565b919091019291505056fea264697066735822122074f32fef384fdc296b0859f1c1f941c8e736c6cb972aa9e2b894956ebd6a80b364736f6c63430008160033\",\"r\":\"0x1\",\"s\":\"0x1\",\"yParity\":\"0x0\",\"hash\":\"0xbc73db80bf4b8784ba10a8910a0b7ef85f6846d102b41dd990969ea205335354\",\"type\":\"0x2\"}],\"ommers\":[]},{\"header\":{\"parentHash\":\"0x026ae0c6ae91f186a9befa1ac8be30eea35e30e77de51a731085221e5cd39209\",\"sha3Uncles\":\"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\"miner\":\"0x0000000000000000000000000000000000000000\",\"stateRoot\":\"0xb6003e7ba07a15a9e35f63daa484728ec4ceeded0c4d10ac1b04e9552d412b3c\",\"transactionsRoot\":\"0x6e4969a136061ca7a390d12830d47a151585325a8d396819fb2b958ff85e9f8f\",\"receiptsRoot\":\"0xc3e81df67d3e2a6c8345a954ef250cfcc41abcc2292a5aa263071124533fc9ad\",\"logsBloom\":\"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\"difficulty\":\"0x0\",\"number\":\"0x3\",\"gasLimit\":\"0x1c9c380\",\"gasUsed\":\"0x3c0f6\",\"timestamp\":\"0x66b200ce\",\"mixHash\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"nonce\":\"0x0000000000000000\",\"baseFeePerGas\":\"0x18993a68\",\"blobGasUsed\":\"0x0\",\"excessBlobGas\":\"0x0\",\"extraData\":\"0x\"},\"transactions\":[{\"chainId\":\"0x343a\",\"nonce\":\"0x0\",\"gas\":\"0x3c0f6\",\"maxFeePerGas\":\"0x5d4285cd\",\"maxPriorityFeePerGas\":\"0x3b9aca00\",\"value\":\"0x0\",\"accessList\":[],\"input\":\"0x608060405234801561001057600080fd5b50610380806100206000396000f3fe6080604052600080357fffffffff0000000000000000000000000000000000000000000000000000000016905060008160e01c610251565b60006379ba509782101561015e5781631627540c811461009857632a952b2d81146100b457633659cfe681146100d0576350c946fe81146100ec576353a47bb781146101085763625ca21c81146101245763718fe928811461014057610158565b7347d08dad17ccb558b3ea74b1a0e73a9cc804a9dc9150610158565b738138ef7cf908021d117e542120b7a390650161079150610158565b7347d08dad17ccb558b3ea74b1a0e73a9cc804a9dc9150610158565b738138ef7cf908021d117e542120b7a390650161079150610158565b7347d08dad17ccb558b3ea74b1a0e73a9cc804a9dc9150610158565b738138ef7cf908021d117e542120b7a390650161079150610158565b7347d08dad17ccb558b3ea74b1a0e73a9cc804a9dc91505b5061024c565b816379ba509781146101a657638da5cb5b81146101c25763aaf10f4281146101de5763c7f62cda81146101fa5763daa250be81146102165763deba1b9881146102325761024a565b7347d08dad17ccb558b3ea74b1a0e73a9cc804a9dc915061024a565b7347d08dad17ccb558b3ea74b1a0e73a9cc804a9dc915061024a565b7347d08dad17ccb558b3ea74b1a0e73a9cc804a9dc915061024a565b7347d08dad17ccb558b3ea74b1a0e73a9cc804a9dc915061024a565b738138ef7cf908021d117e542120b7a39065016107915061024a565b738138ef7cf908021d117e542120b7a3906501610791505b505b919050565b61025a81610037565b915050600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff16036102ce57816040517fc2a825f50000000000000000000000000000000000000000000000000000000081526004016102c5919061032f565b60405180910390fd5b3660008037600080366000845af43d6000803e80600081146102ef573d6000f35b3d6000fd5b60007fffffffff0000000000000000000000000000000000000000000000000000000082169050919050565b610329816102f4565b82525050565b60006020820190506103446000830184610320565b9291505056fea264697066735822122017a4b7fdaaab3897a7b47abaed8d2ee92d558883d3bb2a8454f9601b2ab2c3db64736f6c63430008150033\",\"r\":\"0x1\",\"s\":\"0x1\",\"yParity\":\"0x0\",\"hash\":\"0x2476e039803622aeb040f924f04c493f559aed3d6c9372ab405cb33c8c695328\",\"type\":\"0x2\"}],\"ommers\":[]},{\"header\":{\"parentHash\":\"0x3d22100ac0ee8d5cde334f7f926191a861b0648971ebc179547df28a0224c6d0\",\"sha3Uncles\":\"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\"miner\":\"0x0000000000000000000000000000000000000000\",\"stateRoot\":\"0x9511d4711e5c30a72b0bff38a261daa75dcc5ba8b772d970a5c742244b4c861b\",\"transactionsRoot\":\"0xba5fff578d3d6c2cd63acbe9bca353eaa6fe22a5c408956eff49106e0a96c507\",\"receiptsRoot\":\"0xbae111f01cb07677e3a8c5031546138407c01bc964d3493d732dc4edf47d36d3\",\"logsBloom\":\"0x00000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000020000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000001000000000000000000000400000001000010000000000000000000000000000000000000000000000000000000000000000000000000\",\"difficulty\":\"0x0\",\"number\":\"0x5\",\"gasLimit\":\"0x1c9c380\",\"gasUsed\":\"0xcae7\",\"timestamp\":\"0x66b200cb\",\"mixHash\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"nonce\":\"0x0000000000000000\",\"baseFeePerGas\":\"0x12e09c7a\",\"blobGasUsed\":\"0x0\",\"excessBlobGas\":\"0x0\",\"extraData\":\"0x\"},\"transactions\":[{\"chainId\":\"0x343a\",\"nonce\":\"0x0\",\"gas\":\"0xcc4d\",\"maxFeePerGas\":\"0x557e5ec4\",\"maxPriorityFeePerGas\":\"0x3b9aca00\",\"to\":\"0x83a0444b93927c3afcbe46e522280390f748e171\",\"value\":\"0x0\",\"accessList\":[],\"input\":\"0x3659cfe6000000000000000000000000108f53faf774d7c4c56f5bce9ca6e605ce8aeadd\",\"r\":\"0x1\",\"s\":\"0x1\",\"yParity\":\"0x0\",\"hash\":\"0xf88e7b19ee347145c257e0cf7ac4ecc2bae83ca79d7edaa231e71d3213aeb151\",\"type\":\"0x2\"}],\"ommers\":[]},{\"header\":{\"parentHash\":\"0x08abe6e453727534d8dd708843a7522b7d500338bdfe2402ca105dcdb05eebe9\",\"sha3Uncles\":\"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\"miner\":\"0x0000000000000000000000000000000000000000\",\"stateRoot\":\"0x9c8eaf493f8b4edce2ba1647343eadcc0989cf461e712c0a6253ff2ca1842bb7\",\"transactionsRoot\":\"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\"receiptsRoot\":\"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\"logsBloom\":\"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\"difficulty\":\"0x0\",\"number\":\"0x1\",\"gasLimit\":\"0x1c9c380\",\"gasUsed\":\"0x0\",\"timestamp\":\"0x66b200ca\",\"mixHash\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"nonce\":\"0x0000000000000000\",\"baseFeePerGas\":\"0x3b9aca00\",\"blobGasUsed\":\"0x0\",\"excessBlobGas\":\"0x0\",\"extraData\":\"0x\"},\"transactions\":[],\"ommers\":[]},{\"header\":{\"parentHash\":\"0xdd07c07470e1deff3749831f0f1ad8d4b6e35505e83b3c6ea14181716197cd8a\",\"sha3Uncles\":\"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\"miner\":\"0x0000000000000000000000000000000000000000\",\"stateRoot\":\"0x29aa352e71b139e83b397bdd3dcf9b65d74770edaf3a9624d0dbc4f96f868680\",\"transactionsRoot\":\"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\"receiptsRoot\":\"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\"logsBloom\":\"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\"difficulty\":\"0x0\",\"number\":\"0x2\",\"gasLimit\":\"0x1c9c380\",\"gasUsed\":\"0x0\",\"timestamp\":\"0x66b200cb\",\"mixHash\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"nonce\":\"0x0000000000000000\",\"baseFeePerGas\":\"0x24a1ab52\",\"blobGasUsed\":\"0x0\",\"excessBlobGas\":\"0x0\",\"extraData\":\"0x\"},\"transactions\":[],\"ommers\":[]},{\"header\":{\"parentHash\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"sha3Uncles\":\"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\"miner\":\"0x0000000000000000000000000000000000000000\",\"stateRoot\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"transactionsRoot\":\"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\"receiptsRoot\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"logsBloom\":\"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\"difficulty\":\"0x0\",\"number\":\"0x0\",\"gasLimit\":\"0x1c9c380\",\"gasUsed\":\"0x0\",\"timestamp\":\"0x66b200c9\",\"mixHash\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"nonce\":\"0x0000000000000000\",\"baseFeePerGas\":\"0x3b9aca00\",\"blobGasUsed\":\"0x0\",\"excessBlobGas\":\"0x0\",\"extraData\":\"0x\"},\"transactions\":[],\"ommers\":[]},{\"header\":{\"parentHash\":\"0xf6930be4847cac5017bbcbec2756eed19f36b4196526a98a88e311c296e3a9be\",\"sha3Uncles\":\"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\"miner\":\"0x0000000000000000000000000000000000000000\",\"stateRoot\":\"0x29aa352e71b139e83b397bdd3dcf9b65d74770edaf3a9624d0dbc4f96f868680\",\"transactionsRoot\":\"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\"receiptsRoot\":\"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\"logsBloom\":\"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\"difficulty\":\"0x0\",\"number\":\"0x1\",\"gasLimit\":\"0x1c9c380\",\"gasUsed\":\"0x0\",\"timestamp\":\"0x66b200cc\",\"mixHash\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"nonce\":\"0x0000000000000000\",\"baseFeePerGas\":\"0x200d75e8\",\"blobGasUsed\":\"0x0\",\"excessBlobGas\":\"0x0\",\"extraData\":\"0x\"},\"transactions\":[],\"ommers\":[]},{\"header\":{\"parentHash\":\"0x08abe6e453727534d8dd708843a7522b7d500338bdfe2402ca105dcdb05eebe9\",\"sha3Uncles\":\"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\"miner\":\"0x0000000000000000000000000000000000000000\",\"stateRoot\":\"0xb6003e7ba07a15a9e35f63daa484728ec4ceeded0c4d10ac1b04e9552d412b3c\",\"transactionsRoot\":\"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\"receiptsRoot\":\"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\"logsBloom\":\"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\"difficulty\":\"0x0\",\"number\":\"0x4\",\"gasLimit\":\"0x1c9c380\",\"gasUsed\":\"0x0\",\"timestamp\":\"0x66b200ca\",\"mixHash\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"nonce\":\"0x0000000000000000\",\"baseFeePerGas\":\"0x1592fbf9\",\"blobGasUsed\":\"0x0\",\"excessBlobGas\":\"0x0\",\"extraData\":\"0x\"},\"transactions\":[],\"ommers\":[]},{\"header\":{\"parentHash\":\"0x149d41e3b89d8324cef3feff98ef308e97bafe8745cc8461c60172bc7d4c44ba\",\"sha3Uncles\":\"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\"miner\":\"0x0000000000000000000000000000000000000000\",\"stateRoot\":\"0x510f2275449c013534a25ad0b13c867caf720947b68bcbcd4863f7b172a5d023\",\"transactionsRoot\":\"0x0b44110186e52ff0ceb6b0776ca2992c94144a4ed712eef65ea038260ef0fcc7\",\"receiptsRoot\":\"0xc2823b8eb4730d9f2657137cc2ddc2c4f22ab68e0ab826236cf6a1551ca2b3a5\",\"logsBloom\":\"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\"difficulty\":\"0x0\",\"number\":\"0x2\",\"gasLimit\":\"0x1c9c380\",\"gasUsed\":\"0xe61f9\",\"timestamp\":\"0x66b200cb\",\"mixHash\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"nonce\":\"0x0000000000000000\",\"baseFeePerGas\":\"0x342770c0\",\"blobGasUsed\":\"0x0\",\"excessBlobGas\":\"0x0\",\"extraData\":\"0x\"},\"transactions\":[{\"chainId\":\"0x343a\",\"nonce\":\"0x0\",\"gas\":\"0xe94d1\",\"maxFeePerGas\":\"0x83215600\",\"maxPriorityFeePerGas\":\"0x3b9aca00\",\"to\":\"0x4e59b44847b379578588920ca78fbf26c0b4956c\",\"value\":\"0x0\",\"accessList\":[],\"input\":\"0x4786e4342646b3ba97c1790b6cf5a55087a36240b22570f5d3a5d6bcc929d93b608060405234801561001057600080fd5b5060008061002661006d60201b61081b1760201c565b60000160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555050610141565b60008060405160200161007f90610121565b6040516020818303038152906040528051906020012090508091505090565b600082825260208201905092915050565b7f696f2e73796e7468657469782e636f72652d636f6e7472616374732e4f776e6160008201527f626c650000000000000000000000000000000000000000000000000000000000602082015250565b600061010b60238361009e565b9150610116826100af565b604082019050919050565b6000602082019050818103600083015261013a816100fe565b9050919050565b611000806101506000396000f3fe608060405234801561001057600080fd5b50600436106100885760003560e01c806379ba50971161005b57806379ba5097146100ed5780638da5cb5b146100f7578063aaf10f4214610115578063c7f62cda1461013357610088565b80631627540c1461008d5780633659cfe6146100a957806353a47bb7146100c5578063718fe928146100e3575b600080fd5b6100a760048036038101906100a29190610d25565b61014f565b005b6100c360048036038101906100be9190610d25565b6102d0565b005b6100cd6102e4565b6040516100da9190610d61565b60405180910390f35b6100eb610317565b005b6100f56103fe565b005b6100ff61058b565b60405161010c9190610d61565b60405180910390f35b61011d6105be565b60405161012a9190610d61565b60405180910390f35b61014d60048036038101906101489190610d25565b6105f1565b005b61015761084c565b600061016161081b565b9050600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff16036101c9576040517fd92e233d00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b8060010160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603610252576040517fa88ee57700000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b818160010160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055507f906a1c6bd7e3091ea86693dd029a831c19049ce77f1dce2ce0bab1cacbabce22826040516102c49190610d61565b60405180910390a15050565b6102d861084c565b6102e1816108c5565b50565b60006102ee61081b565b60010160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905090565b600061032161081b565b90503373ffffffffffffffffffffffffffffffffffffffff168160010160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16146103b757336040517fa0e5a0d70000000000000000000000000000000000000000000000000000000081526004016103ae9190610d61565b60405180910390fd5b60008160010160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555050565b600061040861081b565b905060008160010160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1690508073ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16146104a357336040517fa0e5a0d700000000000000000000000000000000000000000000000000000000815260040161049a9190610d61565b60405180910390fd5b7fb532073b38c83145e3e5135377a08bf9aab55bc0fd7c1179cd4fb995d2a5159c8260000160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16826040516104f8929190610d7c565b60405180910390a1808260000160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555060008260010160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055505050565b600061059561081b565b60000160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905090565b60006105c8610b05565b60000160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905090565b60006105fb610b05565b905060018160000160146101000a81548160ff02191690831515021790555060008160000160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050828260000160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555060008373ffffffffffffffffffffffffffffffffffffffff163073ffffffffffffffffffffffffffffffffffffffff16633659cfe6846040516024016106cc9190610d61565b604051602081830303815290604052915060e01b6020820180517bffffffffffffffffffffffffffffffffffffffffffffffffffffffff838183161783525050505060405161071b9190610e16565b600060405180830381855af49150503d8060008114610756576040519150601f19603f3d011682016040523d82523d6000602084013e61075b565b606091505b505090508015806107c357508173ffffffffffffffffffffffffffffffffffffffff16610786610b05565b60000160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1614155b156107fa576040517fa1cfa5a800000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b60008360000160146101000a81548160ff0219169083151502179055600080fd5b60008060405160200161082d90610eb0565b6040516020818303038152906040528051906020012090508091505090565b610854610b36565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16146108c357336040517f8e4a23d60000000000000000000000000000000000000000000000000000000081526004016108ba9190610d61565b60405180910390fd5b565b600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff160361092b576040517fd92e233d00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b61093481610b69565b61097557806040517f8a8b41ec00000000000000000000000000000000000000000000000000000000815260040161096c9190610d61565b60405180910390fd5b600061097f610b05565b90508060000160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603610a0a576040517fa88ee57700000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b8060000160149054906101000a900460ff16158015610a2e5750610a2d82610b7c565b5b15610a7057816040517f15504301000000000000000000000000000000000000000000000000000000008152600401610a679190610d61565b60405180910390fd5b818160000160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055503073ffffffffffffffffffffffffffffffffffffffff167f5d611f318680d00598bb735d61bacf0c514c6b50e1e5ad30040a4df2b12791c783604051610af99190610d61565b60405180910390a25050565b600080604051602001610b1790610f42565b6040516020818303038152906040528051906020012090508091505090565b6000610b4061081b565b60000160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905090565b600080823b905060008111915050919050565b60008060003073ffffffffffffffffffffffffffffffffffffffff163073ffffffffffffffffffffffffffffffffffffffff1663c7f62cda86604051602401610bc59190610d61565b604051602081830303815290604052915060e01b6020820180517bffffffffffffffffffffffffffffffffffffffffffffffffffffffff8381831617835250505050604051610c149190610e16565b600060405180830381855af49150503d8060008114610c4f576040519150601f19603f3d011682016040523d82523d6000602084013e610c54565b606091505b509150915081158015610cb9575063a1cfa5a860e01b604051602001610c7a9190610faf565b6040516020818303038152906040528051906020012081604051602001610ca19190610e16565b60405160208183030381529060405280519060200120145b92505050919050565b600080fd5b600073ffffffffffffffffffffffffffffffffffffffff82169050919050565b6000610cf282610cc7565b9050919050565b610d0281610ce7565b8114610d0d57600080fd5b50565b600081359050610d1f81610cf9565b92915050565b600060208284031215610d3b57610d3a610cc2565b5b6000610d4984828501610d10565b91505092915050565b610d5b81610ce7565b82525050565b6000602082019050610d766000830184610d52565b92915050565b6000604082019050610d916000830185610d52565b610d9e6020830184610d52565b9392505050565b600081519050919050565b600081905092915050565b60005b83811015610dd9578082015181840152602081019050610dbe565b60008484015250505050565b6000610df082610da5565b610dfa8185610db0565b9350610e0a818560208601610dbb565b80840191505092915050565b6000610e228284610de5565b915081905092915050565b600082825260208201905092915050565b7f696f2e73796e7468657469782e636f72652d636f6e7472616374732e4f776e6160008201527f626c650000000000000000000000000000000000000000000000000000000000602082015250565b6000610e9a602383610e2d565b9150610ea582610e3e565b604082019050919050565b60006020820190508181036000830152610ec981610e8d565b9050919050565b7f696f2e73796e7468657469782e636f72652d636f6e7472616374732e50726f7860008201527f7900000000000000000000000000000000000000000000000000000000000000602082015250565b6000610f2c602183610e2d565b9150610f3782610ed0565b604082019050919050565b60006020820190508181036000830152610f5b81610f1f565b9050919050565b60007fffffffff0000000000000000000000000000000000000000000000000000000082169050919050565b6000819050919050565b610fa9610fa482610f62565b610f8e565b82525050565b6000610fbb8284610f98565b6004820191508190509291505056fea264697066735822122023a7c33d7b91dce35ffbcf8837693364ab22a3905d0fc00016833e5fac45ca2f64736f6c63430008110033\",\"r\":\"0x1\",\"s\":\"0x1\",\"yParity\":\"0x0\",\"hash\":\"0x4feae6769d748b4f0f7c9bf21d782236c88f13906789a3ec602961296e4c3e43\",\"type\":\"0x2\"}],\"ommers\":[]},{\"header\":{\"parentHash\":\"0xb3535af5103fd1c2bbd6dc7ff23f0799037a6542c231ebcb85abd776560fa512\",\"sha3Uncles\":\"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\"miner\":\"0x0000000000000000000000000000000000000000\",\"stateRoot\":\"0x23d74fb99ff6e42cbb5c33f92b078e37be6af2b6092459b103ff7059a6517ebc\",\"transactionsRoot\":\"0x9eab45eca206fe11c107ea985c7d02fcfa442836aea3e04ba11dc4df587d5aa6\",\"receiptsRoot\":\"0xe25abcfa973db8c55f73292137c626430de130a382ad4466337fefb0f7c8fde0\",\"logsBloom\":\"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\"difficulty\":\"0x0\",\"number\":\"0x2\",\"gasLimit\":\"0x1c9c380\",\"gasUsed\":\"0x3ce3f\",\"timestamp\":\"0x66b200cd\",\"mixHash\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"nonce\":\"0x0000000000000000\",\"baseFeePerGas\":\"0x1c0bc72b\",\"blobGasUsed\":\"0x0\",\"excessBlobGas\":\"0x0\",\"extraData\":\"0x\"},\"transactions\":[{\"chainId\":\"0x343a\",\"nonce\":\"0x0\",\"gas\":\"0x3d8a8\",\"maxFeePerGas\":\"0x6211577c\",\"maxPriorityFeePerGas\":\"0x3b9aca00\",\"to\":\"0x4e59b44847b379578588920ca78fbf26c0b4956c\",\"value\":\"0x0\",\"accessList\":[],\"input\":\"0x4786e4342646b3ba97c1790b6cf5a55087a36240b22570f5d3a5d6bcc929d93b608060405234801561001057600080fd5b5060405161068538038061068583398181016040528101906100329190610275565b818181600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff160361009b576040517fd92e233d00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6100ae8161019d60201b61004f1760201c565b6100ef57806040517f8a8b41ec0000000000000000000000000000000000000000000000000000000081526004016100e691906102c4565b60405180910390fd5b806100fe6101b060201b60201c565b60000160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555050806101536101e160201b6100621760201c565b60000160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555050505050610414565b600080823b905060008111915050919050565b6000806040516020016101c290610362565b6040516020818303038152906040528051906020012090508091505090565b6000806040516020016101f3906103f4565b6040516020818303038152906040528051906020012090508091505090565b600080fd5b600073ffffffffffffffffffffffffffffffffffffffff82169050919050565b600061024282610217565b9050919050565b61025281610237565b811461025d57600080fd5b50565b60008151905061026f81610249565b92915050565b6000806040838503121561028c5761028b610212565b5b600061029a85828601610260565b92505060206102ab85828601610260565b9150509250929050565b6102be81610237565b82525050565b60006020820190506102d960008301846102b5565b92915050565b600082825260208201905092915050565b7f696f2e73796e7468657469782e636f72652d636f6e7472616374732e50726f7860008201527f7900000000000000000000000000000000000000000000000000000000000000602082015250565b600061034c6021836102df565b9150610357826102f0565b604082019050919050565b6000602082019050818103600083015261037b8161033f565b9050919050565b7f696f2e73796e7468657469782e636f72652d636f6e7472616374732e4f776e6160008201527f626c650000000000000000000000000000000000000000000000000000000000602082015250565b60006103de6023836102df565b91506103e982610382565b604082019050919050565b6000602082019050818103600083015261040d816103d1565b9050919050565b610262806104236000396000f3fe6080604052366100135761001161001d565b005b61001b61001d565b005b6000610027610093565b90503660008037600080366000845af43d6000803e806000811461004a573d6000f35b3d6000fd5b600080823b905060008111915050919050565b6000806040516020016100749061017a565b6040516020818303038152906040528051906020012090508091505090565b600061009d6100c6565b60000160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905090565b6000806040516020016100d89061020c565b6040516020818303038152906040528051906020012090508091505090565b600082825260208201905092915050565b7f696f2e73796e7468657469782e636f72652d636f6e7472616374732e4f776e6160008201527f626c650000000000000000000000000000000000000000000000000000000000602082015250565b60006101646023836100f7565b915061016f82610108565b604082019050919050565b6000602082019050818103600083015261019381610157565b9050919050565b7f696f2e73796e7468657469782e636f72652d636f6e7472616374732e50726f7860008201527f7900000000000000000000000000000000000000000000000000000000000000602082015250565b60006101f66021836100f7565b91506102018261019a565b604082019050919050565b60006020820190508181036000830152610225816101e9565b905091905056fea2646970667358221220800da1f73cebd5e4afa07496d9bca6b6c4f526bdd3f4014ec15c70fe3a1c441364736f6c6343000811003300000000000000000000000047d08dad17ccb558b3ea74b1a0e73a9cc804a9dc000000000000000000000000f39fd6e51aad88f6f4ce6ab8827279cfffb92266\",\"r\":\"0x1\",\"s\":\"0x1\",\"yParity\":\"0x0\",\"hash\":\"0xb6794d5c7abed6f91d447e8efb72ef2580595a6d7c8dee57ba1dbb330970146a\",\"type\":\"0x2\"}],\"ommers\":[]},{\"header\":{\"parentHash\":\"0x08abe6e453727534d8dd708843a7522b7d500338bdfe2402ca105dcdb05eebe9\",\"sha3Uncles\":\"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\"miner\":\"0x0000000000000000000000000000000000000000\",\"stateRoot\":\"0x510f2275449c013534a25ad0b13c867caf720947b68bcbcd4863f7b172a5d023\",\"transactionsRoot\":\"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\"receiptsRoot\":\"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\"logsBloom\":\"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\"difficulty\":\"0x0\",\"number\":\"0x3\",\"gasLimit\":\"0x1c9c380\",\"gasUsed\":\"0x0\",\"timestamp\":\"0x66b200ca\",\"mixHash\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"nonce\":\"0x0000000000000000\",\"baseFeePerGas\":\"0x29dd5614\",\"blobGasUsed\":\"0x0\",\"excessBlobGas\":\"0x0\",\"extraData\":\"0x\"},\"transactions\":[],\"ommers\":[]}]}" }, { "path": "crates/anvil/test-data/state-dump-legacy.json", "content": "{\"block\":{\"number\":2,\"beneficiary\":\"0x0000000000000000000000000000000000000000\",\"timestamp\":1724762147,\"gas_limit\":30000000,\"basefee\":875175000,\"difficulty\":\"0x0\",\"prevrandao\":\"0xb92480171c0235f8c6710a4047d7ee14a3be58c630839fb4422826ff3a013e44\",\"blob_excess_gas_and_price\":{\"excess_blob_gas\":0,\"blob_gasprice\":1}},\"accounts\":{\"0x0000000000000000000000000000000000000000\":{\"nonce\":0,\"balance\":\"0xa410\",\"code\":\"0x\",\"storage\":{}},\"0x14dc79964da2c08b23698b3d3cc7ca32193d9955\":{\"nonce\":0,\"balance\":\"0x21e19e0c9bab2400000\",\"code\":\"0x\",\"storage\":{}},\"0x15d34aaf54267db7d7c367839aaf71a00a2c6a65\":{\"nonce\":0,\"balance\":\"0x21e19e0c9bab2400000\",\"code\":\"0x\",\"storage\":{}},\"0x23618e81e3f5cdf7f54c3d65f7fbc0abf5b21e8f\":{\"nonce\":0,\"balance\":\"0x21e19e0c9bab2400000\",\"code\":\"0x\",\"storage\":{}},\"0x3c44cdddb6a900fa2b585dd299e03d12fa4293bc\":{\"nonce\":0,\"balance\":\"0x21e19e0c9bab2400000\",\"code\":\"0x\",\"storage\":{}},\"0x4e59b44847b379578588920ca78fbf26c0b4956c\":{\"nonce\":0,\"balance\":\"0x0\",\"code\":\"0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe03601600081602082378035828234f58015156039578182fd5b8082525050506014600cf3\",\"storage\":{}},\"0x70997970c51812dc3a010c7d01b50e0d17dc79c8\":{\"nonce\":1,\"balance\":\"0x21e19e0b90393da9b38\",\"code\":\"0x\",\"storage\":{}},\"0x90f79bf6eb2c4f870365e785982e1f101e93b906\":{\"nonce\":0,\"balance\":\"0x21e19e0c9bab2400000\",\"code\":\"0x\",\"storage\":{}},\"0x976ea74026e726554db657fa54763abd0c3a0aa9\":{\"nonce\":0,\"balance\":\"0x21e19e0c9bab2400000\",\"code\":\"0x\",\"storage\":{}},\"0x9965507d1a55bcc2695c58ba16fb37d819b0a4dc\":{\"nonce\":0,\"balance\":\"0x21e19e0c9bab2400000\",\"code\":\"0x\",\"storage\":{}},\"0xa0ee7a142d267c1f36714e4a8f75612f20a79720\":{\"nonce\":0,\"balance\":\"0x21e19e0c9bab2400000\",\"code\":\"0x\",\"storage\":{}},\"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\":{\"nonce\":1,\"balance\":\"0x21e19e0b6a140b55df8\",\"code\":\"0x\",\"storage\":{}}},\"best_block_number\":2,\"blocks\":[{\"header\":{\"parentHash\":\"0xceb0fe420d6f14a8eeec4319515b89acbb0bb4861cad9983d529ab4b1e4af929\",\"sha3Uncles\":\"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\"miner\":\"0x0000000000000000000000000000000000000000\",\"stateRoot\":\"0xe1423fd180478ab4fd05a7103277d64496b15eb914ecafe71eeec871b552efd1\",\"transactionsRoot\":\"0x2b5598ef261e5f88e4303bb2b3986b3d5c0ebf4cd9977daebccae82a6469b988\",\"receiptsRoot\":\"0xf78dfb743fbd92ade140711c8bbc542b5e307f0ab7984eff35d751969fe57efa\",\"logsBloom\":\"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\"difficulty\":\"0x0\",\"number\":\"0x2\",\"gasLimit\":\"0x1c9c380\",\"gasUsed\":\"0x5208\",\"timestamp\":\"0x66cdc823\",\"mixHash\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"nonce\":\"0x0000000000000000\",\"baseFeePerGas\":\"0x342a1c58\",\"blobGasUsed\":\"0x0\",\"excessBlobGas\":\"0x0\",\"extraData\":\"0x\"},\"transactions\":[{\"chainId\":\"0x7a69\",\"nonce\":\"0x0\",\"gas\":\"0x5209\",\"maxFeePerGas\":\"0x77359401\",\"maxPriorityFeePerGas\":\"0x1\",\"to\":\"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\",\"value\":\"0x0\",\"accessList\":[],\"input\":\"0x\",\"r\":\"0x85c2794a580da137e24ccc823b45ae5cea99371ae23ee13860fcc6935f8305b0\",\"s\":\"0x41de7fa4121dab284af4453d30928241208bafa90cdb701fe9bc7054759fe3cd\",\"yParity\":\"0x0\",\"hash\":\"0x8c9b68e8947ace33028dba167354fde369ed7bbe34911b772d09b3c64b861515\",\"type\":\"0x2\"}],\"ommers\":[]},{\"header\":{\"parentHash\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"sha3Uncles\":\"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\"miner\":\"0x0000000000000000000000000000000000000000\",\"stateRoot\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"transactionsRoot\":\"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\"receiptsRoot\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"logsBloom\":\"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\"difficulty\":\"0x0\",\"number\":\"0x0\",\"gasLimit\":\"0x1c9c380\",\"gasUsed\":\"0x0\",\"timestamp\":\"0x66cdc80e\",\"mixHash\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"nonce\":\"0x0000000000000000\",\"baseFeePerGas\":\"0x3b9aca00\",\"blobGasUsed\":\"0x0\",\"excessBlobGas\":\"0x0\",\"extraData\":\"0x\"},\"transactions\":[],\"ommers\":[]},{\"header\":{\"parentHash\":\"0xa00dc0c9ee9a888e67ea32d8772f8cc28eff62448c9ec985ee941fcbc921ba59\",\"sha3Uncles\":\"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\"miner\":\"0x0000000000000000000000000000000000000000\",\"stateRoot\":\"0x6e5f60b37eeaece7dedfc42cc394731a0ae3ed3d3be93c402780b2e23e141175\",\"transactionsRoot\":\"0x9ceaeb1b16b924afbf4bf4df4c2c49dc9cfbe23ac7a40bf26a704158ea2d352f\",\"receiptsRoot\":\"0xf78dfb743fbd92ade140711c8bbc542b5e307f0ab7984eff35d751969fe57efa\",\"logsBloom\":\"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\"difficulty\":\"0x0\",\"number\":\"0x1\",\"gasLimit\":\"0x1c9c380\",\"gasUsed\":\"0x5208\",\"timestamp\":\"0x66cdc814\",\"mixHash\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"nonce\":\"0x0000000000000000\",\"baseFeePerGas\":\"0x3b9aca00\",\"blobGasUsed\":\"0x0\",\"excessBlobGas\":\"0x0\",\"extraData\":\"0x\"},\"transactions\":[{\"chainId\":\"0x7a69\",\"nonce\":\"0x0\",\"gas\":\"0x5209\",\"maxFeePerGas\":\"0x77359401\",\"maxPriorityFeePerGas\":\"0x1\",\"to\":\"0x70997970c51812dc3a010c7d01b50e0d17dc79c8\",\"value\":\"0x0\",\"accessList\":[],\"input\":\"0x\",\"r\":\"0x703a4b4d6dbff2fa2345df73263df2098faa7214863b5ec82c4c07162d87b853\",\"s\":\"0x17dea762c4ce600ad1d9d2c9ae6dd35b9e526d03c875f868ad0792fd4fad72e0\",\"yParity\":\"0x0\",\"hash\":\"0xf8d5fb22350f52ae8c30cd7f6969eb73de849c8dc010f4215d4c5c24824fe2b3\",\"type\":\"0x2\"}],\"ommers\":[]}]}" }, { "path": "crates/anvil/test-data/state-dump.json", "content": "{\n \"block\": {\n \"number\": 2,\n \"beneficiary\": \"0x0000000000000000000000000000000000000000\",\n \"timestamp\": 1724763179,\n \"gas_limit\": 30000000,\n \"basefee\": 875175000,\n \"difficulty\": \"0x0\",\n \"prevrandao\": \"0xdb639d7f8af4f0ff2aa9cc49861820e72f5f8bfeeed677d1e3569f6b1625df4a\",\n \"blob_excess_gas_and_price\": {\n \"excess_blob_gas\": 0,\n \"blob_gasprice\": 1\n }\n },\n \"accounts\": {\n \"0x0000000000000000000000000000000000000000\": {\n \"nonce\": 0,\n \"balance\": \"0xa410\",\n \"code\": \"0x\",\n \"storage\": {}\n },\n \"0x14dc79964da2c08b23698b3d3cc7ca32193d9955\": {\n \"nonce\": 0,\n \"balance\": \"0x21e19e0c9bab2400000\",\n \"code\": \"0x\",\n \"storage\": {}\n },\n \"0x15d34aaf54267db7d7c367839aaf71a00a2c6a65\": {\n \"nonce\": 0,\n \"balance\": \"0x21e19e0c9bab2400000\",\n \"code\": \"0x\",\n \"storage\": {}\n },\n \"0x23618e81e3f5cdf7f54c3d65f7fbc0abf5b21e8f\": {\n \"nonce\": 0,\n \"balance\": \"0x21e19e0c9bab2400000\",\n \"code\": \"0x\",\n \"storage\": {}\n },\n \"0x3c44cdddb6a900fa2b585dd299e03d12fa4293bc\": {\n \"nonce\": 0,\n \"balance\": \"0x21e19e0c9bab2400000\",\n \"code\": \"0x\",\n \"storage\": {}\n },\n \"0x4e59b44847b379578588920ca78fbf26c0b4956c\": {\n \"nonce\": 0,\n \"balance\": \"0x0\",\n \"code\": \"0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe03601600081602082378035828234f58015156039578182fd5b8082525050506014600cf3\",\n \"storage\": {}\n },\n \"0x70997970c51812dc3a010c7d01b50e0d17dc79c8\": {\n \"nonce\": 1,\n \"balance\": \"0x21e19e0b90393da9b38\",\n \"code\": \"0x\",\n \"storage\": {}\n },\n \"0x90f79bf6eb2c4f870365e785982e1f101e93b906\": {\n \"nonce\": 0,\n \"balance\": \"0x21e19e0c9bab2400000\",\n \"code\": \"0x\",\n \"storage\": {}\n },\n \"0x976ea74026e726554db657fa54763abd0c3a0aa9\": {\n \"nonce\": 0,\n \"balance\": \"0x21e19e0c9bab2400000\",\n \"code\": \"0x\",\n \"storage\": {}\n },\n \"0x9965507d1a55bcc2695c58ba16fb37d819b0a4dc\": {\n \"nonce\": 0,\n \"balance\": \"0x21e19e0c9bab2400000\",\n \"code\": \"0x\",\n \"storage\": {}\n },\n \"0xa0ee7a142d267c1f36714e4a8f75612f20a79720\": {\n \"nonce\": 0,\n \"balance\": \"0x21e19e0c9bab2400000\",\n \"code\": \"0x\",\n \"storage\": {}\n },\n \"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\": {\n \"nonce\": 1,\n \"balance\": \"0x21e19e0b6a140b55df8\",\n \"code\": \"0x\",\n \"storage\": {}\n }\n },\n \"best_block_number\": 2,\n \"blocks\": [\n {\n \"header\": {\n \"parentHash\": \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"sha3Uncles\": \"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\n \"miner\": \"0x0000000000000000000000000000000000000000\",\n \"stateRoot\": \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"transactionsRoot\": \"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\n \"receiptsRoot\": \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"logsBloom\": \"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\n \"difficulty\": \"0x0\",\n \"number\": \"0x0\",\n \"gasLimit\": \"0x1c9c380\",\n \"gasUsed\": \"0x0\",\n \"timestamp\": \"0x66cdcc25\",\n \"mixHash\": \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"nonce\": \"0x0000000000000000\",\n \"baseFeePerGas\": \"0x3b9aca00\",\n \"blobGasUsed\": \"0x0\",\n \"excessBlobGas\": \"0x0\",\n \"extraData\": \"0x\"\n },\n \"transactions\": [],\n \"ommers\": []\n },\n {\n \"header\": {\n \"parentHash\": \"0x3a52101c98a4319c419681131d3585d70a6cf13a9af25136be20d451eed5480a\",\n \"sha3Uncles\": \"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\n \"miner\": \"0x0000000000000000000000000000000000000000\",\n \"stateRoot\": \"0x6e5f60b37eeaece7dedfc42cc394731a0ae3ed3d3be93c402780b2e23e141175\",\n \"transactionsRoot\": \"0x9ceaeb1b16b924afbf4bf4df4c2c49dc9cfbe23ac7a40bf26a704158ea2d352f\",\n \"receiptsRoot\": \"0xf78dfb743fbd92ade140711c8bbc542b5e307f0ab7984eff35d751969fe57efa\",\n \"logsBloom\": \"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\n \"difficulty\": \"0x0\",\n \"number\": \"0x1\",\n \"gasLimit\": \"0x1c9c380\",\n \"gasUsed\": \"0x5208\",\n \"timestamp\": \"0x66cdcc29\",\n \"mixHash\": \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"nonce\": \"0x0000000000000000\",\n \"baseFeePerGas\": \"0x3b9aca00\",\n \"blobGasUsed\": \"0x0\",\n \"excessBlobGas\": \"0x0\",\n \"extraData\": \"0x\"\n },\n \"transactions\": [\n {\n \"transaction\": {\n \"chainId\": \"0x7a69\",\n \"nonce\": \"0x0\",\n \"gas\": \"0x5209\",\n \"maxFeePerGas\": \"0x77359401\",\n \"maxPriorityFeePerGas\": \"0x1\",\n \"to\": \"0x70997970c51812dc3a010c7d01b50e0d17dc79c8\",\n \"value\": \"0x0\",\n \"accessList\": [],\n \"input\": \"0x\",\n \"r\": \"0x703a4b4d6dbff2fa2345df73263df2098faa7214863b5ec82c4c07162d87b853\",\n \"s\": \"0x17dea762c4ce600ad1d9d2c9ae6dd35b9e526d03c875f868ad0792fd4fad72e0\",\n \"yParity\": \"0x0\",\n \"hash\": \"0xf8d5fb22350f52ae8c30cd7f6969eb73de849c8dc010f4215d4c5c24824fe2b3\",\n \"type\": \"0x2\"\n },\n \"impersonated_sender\": null\n }\n ],\n \"ommers\": []\n },\n {\n \"header\": {\n \"parentHash\": \"0x0d575f9ca968cd483549172245483a12343afc3cabef80f0fa39855b10b98c70\",\n \"sha3Uncles\": \"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\n \"miner\": \"0x0000000000000000000000000000000000000000\",\n \"stateRoot\": \"0xe1423fd180478ab4fd05a7103277d64496b15eb914ecafe71eeec871b552efd1\",\n \"transactionsRoot\": \"0x2b5598ef261e5f88e4303bb2b3986b3d5c0ebf4cd9977daebccae82a6469b988\",\n \"receiptsRoot\": \"0xf78dfb743fbd92ade140711c8bbc542b5e307f0ab7984eff35d751969fe57efa\",\n \"logsBloom\": \"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\n \"difficulty\": \"0x0\",\n \"number\": \"0x2\",\n \"gasLimit\": \"0x1c9c380\",\n \"gasUsed\": \"0x5208\",\n \"timestamp\": \"0x66cdcc2b\",\n \"mixHash\": \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"nonce\": \"0x0000000000000000\",\n \"baseFeePerGas\": \"0x342a1c58\",\n \"blobGasUsed\": \"0x0\",\n \"excessBlobGas\": \"0x0\",\n \"extraData\": \"0x\"\n },\n \"transactions\": [\n {\n \"transaction\": {\n \"chainId\": \"0x7a69\",\n \"nonce\": \"0x0\",\n \"gas\": \"0x5209\",\n \"maxFeePerGas\": \"0x77359401\",\n \"maxPriorityFeePerGas\": \"0x1\",\n \"to\": \"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\",\n \"value\": \"0x0\",\n \"accessList\": [],\n \"input\": \"0x\",\n \"r\": \"0x85c2794a580da137e24ccc823b45ae5cea99371ae23ee13860fcc6935f8305b0\",\n \"s\": \"0x41de7fa4121dab284af4453d30928241208bafa90cdb701fe9bc7054759fe3cd\",\n \"yParity\": \"0x0\",\n \"hash\": \"0x8c9b68e8947ace33028dba167354fde369ed7bbe34911b772d09b3c64b861515\",\n \"type\": \"0x2\"\n },\n \"impersonated_sender\": null\n }\n ],\n \"ommers\": []\n }\n ],\n \"transactions\": [\n {\n \"info\": {\n \"transaction_hash\": \"0xf8d5fb22350f52ae8c30cd7f6969eb73de849c8dc010f4215d4c5c24824fe2b3\",\n \"transaction_index\": 0,\n \"from\": \"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\",\n \"to\": \"0x70997970c51812dc3a010c7d01b50e0d17dc79c8\",\n \"contract_address\": null,\n \"traces\": [\n {\n \"parent\": null,\n \"children\": [],\n \"idx\": 0,\n \"trace\": {\n \"depth\": 0,\n \"success\": true,\n \"caller\": \"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\",\n \"address\": \"0x70997970c51812dc3a010c7d01b50e0d17dc79c8\",\n \"maybe_precompile\": null,\n \"selfdestruct_refund_target\": null,\n \"selfdestruct_transferred_value\": null,\n \"kind\": \"CALL\",\n \"value\": \"0x0\",\n \"data\": \"0x\",\n \"output\": \"0x\",\n \"gas_used\": 0,\n \"gas_limit\": 1,\n \"status\": \"Stop\",\n \"steps\": [],\n \"decoded\": {\n \"label\": null,\n \"return_data\": null,\n \"call_data\": null\n },\n \"gas_refund_counter\": 0\n },\n \"logs\": [],\n \"ordering\": []\n }\n ],\n \"exit\": \"Stop\",\n \"out\": \"0x\",\n \"nonce\": 0,\n \"gas_used\": 21000\n },\n \"receipt\": {\n \"type\": \"0x2\",\n \"status\": \"0x1\",\n \"cumulativeGasUsed\": \"0x5208\",\n \"logs\": [],\n \"logsBloom\": \"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\"\n },\n \"block_hash\": \"0x0d575f9ca968cd483549172245483a12343afc3cabef80f0fa39855b10b98c70\",\n \"block_number\": 1\n },\n {\n \"info\": {\n \"transaction_hash\": \"0x8c9b68e8947ace33028dba167354fde369ed7bbe34911b772d09b3c64b861515\",\n \"transaction_index\": 0,\n \"from\": \"0x70997970c51812dc3a010c7d01b50e0d17dc79c8\",\n \"to\": \"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\",\n \"contract_address\": null,\n \"traces\": [\n {\n \"parent\": null,\n \"children\": [],\n \"idx\": 0,\n \"trace\": {\n \"depth\": 0,\n \"success\": true,\n \"caller\": \"0x70997970c51812dc3a010c7d01b50e0d17dc79c8\",\n \"address\": \"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\",\n \"maybe_precompile\": null,\n \"selfdestruct_refund_target\": null,\n \"selfdestruct_transferred_value\": null,\n \"kind\": \"CALL\",\n \"value\": \"0x0\",\n \"data\": \"0x\",\n \"output\": \"0x\",\n \"gas_used\": 0,\n \"gas_limit\": 1,\n \"status\": \"Stop\",\n \"steps\": [],\n \"decoded\": {\n \"label\": null,\n \"return_data\": null,\n \"call_data\": null\n },\n \"gas_refund_counter\": 0\n },\n \"logs\": [],\n \"ordering\": []\n }\n ],\n \"exit\": \"Stop\",\n \"out\": \"0x\",\n \"nonce\": 0,\n \"gas_used\": 21000\n },\n \"receipt\": {\n \"type\": \"0x2\",\n \"status\": \"0x1\",\n \"cumulativeGasUsed\": \"0x5208\",\n \"logs\": [],\n \"logsBloom\": \"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\"\n },\n \"block_hash\": \"0x1f435a603c1bf6d544a90156b572b96d7a1730028422d800839bae78bb3506d0\",\n \"block_number\": 2\n }\n ]\n}\n" }, { "path": "crates/anvil/test-data/storage_sample.json", "content": "{\"0x0000000000000000000000000000000000000000000000000000000000000022\":\"0xf5a5fd42d16a20302798ef6ed309979b43003d2320d9f0e8ea9831a92759fb4b\",\"0x0000000000000000000000000000000000000000000000000000000000000023\":\"0xdb56114e00fdd4c1f85c892bf35ac9a89289aaecb1ebd0a96cde606a748b5d71\",\"0x0000000000000000000000000000000000000000000000000000000000000024\":\"0xc78009fdf07fc56a11f122370658a353aaa542ed63e44c4bc15ff4cd105ab33c\",\"0x0000000000000000000000000000000000000000000000000000000000000025\":\"0x536d98837f2dd165a55d5eeae91485954472d56f246df256bf3cae19352a123c\",\"0x0000000000000000000000000000000000000000000000000000000000000026\":\"0x9efde052aa15429fae05bad4d0b1d7c64da64d03d7a1854a588c2cb8430c0d30\",\"0x0000000000000000000000000000000000000000000000000000000000000027\":\"0xd88ddfeed400a8755596b21942c1497e114c302e6118290f91e6772976041fa1\",\"0x0000000000000000000000000000000000000000000000000000000000000028\":\"0x87eb0ddba57e35f6d286673802a4af5975e22506c7cf4c64bb6be5ee11527f2c\",\"0x0000000000000000000000000000000000000000000000000000000000000029\":\"0x26846476fd5fc54a5d43385167c95144f2643f533cc85bb9d16b782f8d7db193\",\"0x000000000000000000000000000000000000000000000000000000000000002a\":\"0x506d86582d252405b840018792cad2bf1259f1ef5aa5f887e13cb2f0094f51e1\",\"0x000000000000000000000000000000000000000000000000000000000000002b\":\"0xffff0ad7e659772f9534c195c815efc4014ef1e1daed4404c06385d11192e92b\",\"0x000000000000000000000000000000000000000000000000000000000000002c\":\"0x6cf04127db05441cd833107a52be852868890e4317e6a02ab47683aa75964220\",\"0x000000000000000000000000000000000000000000000000000000000000002d\":\"0xb7d05f875f140027ef5118a2247bbb84ce8f2f0f1123623085daf7960c329f5f\",\"0x000000000000000000000000000000000000000000000000000000000000002e\":\"0xdf6af5f5bbdb6be9ef8aa618e4bf8073960867171e29676f8b284dea6a08a85e\",\"0x000000000000000000000000000000000000000000000000000000000000002f\":\"0xb58d900f5e182e3c50ef74969ea16c7726c549757cc23523c369587da7293784\",\"0x0000000000000000000000000000000000000000000000000000000000000030\":\"0xd49a7502ffcfb0340b1d7885688500ca308161a7f96b62df9d083b71fcc8f2bb\",\"0x0000000000000000000000000000000000000000000000000000000000000031\":\"0x8fe6b1689256c0d385f42f5bbe2027a22c1996e110ba97c171d3e5948de92beb\",\"0x0000000000000000000000000000000000000000000000000000000000000032\":\"0x8d0d63c39ebade8509e0ae3c9c3876fb5fa112be18f905ecacfecb92057603ab\",\"0x0000000000000000000000000000000000000000000000000000000000000033\":\"0x95eec8b2e541cad4e91de38385f2e046619f54496c2382cb6cacd5b98c26f5a4\",\"0x0000000000000000000000000000000000000000000000000000000000000034\":\"0xf893e908917775b62bff23294dbbe3a1cd8e6cc1c35b4801887b646a6f81f17f\",\"0x0000000000000000000000000000000000000000000000000000000000000035\":\"0xcddba7b592e3133393c16194fac7431abf2f5485ed711db282183c819e08ebaa\",\"0x0000000000000000000000000000000000000000000000000000000000000036\":\"0x8a8d7fe3af8caa085a7639a832001457dfb9128a8061142ad0335629ff23ff9c\",\"0x0000000000000000000000000000000000000000000000000000000000000037\":\"0xfeb3c337d7a51a6fbf00b9e34c52e1c9195c969bd4e7a0bfd51d5c5bed9c1167\",\"0x0000000000000000000000000000000000000000000000000000000000000038\":\"0xe71f0aa83cc32edfbefa9f4d3e0174ca85182eec9f3a09f6a6c0df6377a510d7\",\"0x0000000000000000000000000000000000000000000000000000000000000039\":\"0x31206fa80a50bb6abe29085058f16212212a60eec8f049fecb92d8c8e0a84bc0\",\"0x000000000000000000000000000000000000000000000000000000000000003a\":\"0x21352bfecbeddde993839f614c3dac0a3ee37543f9b412b16199dc158e23b544\",\"0x000000000000000000000000000000000000000000000000000000000000003b\":\"0x619e312724bb6d7c3153ed9de791d764a366b389af13c58bf8a8d90481a46765\",\"0x000000000000000000000000000000000000000000000000000000000000003c\":\"0x7cdd2986268250628d0c10e385c58c6191e6fbe05191bcc04f133f2cea72c1c4\",\"0x000000000000000000000000000000000000000000000000000000000000003d\":\"0x848930bd7ba8cac54661072113fb278869e07bb8587f91392933374d017bcbe1\",\"0x000000000000000000000000000000000000000000000000000000000000003e\":\"0x8869ff2c22b28cc10510d9853292803328be4fb0e80495e8bb8d271f5b889636\",\"0x000000000000000000000000000000000000000000000000000000000000003f\":\"0xb5fe28e79f1b850f8658246ce9b6a1e7b49fc06db7143e8fe0b4f2b0c5523a5c\",\"0x0000000000000000000000000000000000000000000000000000000000000040\":\"0x985e929f70af28d0bdd1a90a808f977f597c7c778c489e98d3bd8910d31ac0f7\"}" }, { "path": "crates/anvil/tests/it/abi.rs", "content": "//! commonly used sol generated types\nuse alloy_sol_types::sol;\n\nsol!(\n #[sol(rpc)]\n Greeter,\n \"test-data/greeter.json\"\n);\n\nsol!(\n #[derive(Debug)]\n #[sol(rpc)]\n SimpleStorage,\n \"test-data/SimpleStorage.json\"\n);\n\nsol!(\n #[sol(rpc)]\n Multicall,\n \"test-data/multicall.json\"\n);\n\nsol!(\n #[sol(rpc)]\n contract BUSD {\n function balanceOf(address) external view returns (uint256);\n }\n);\n\nsol!(\n #[sol(rpc)]\n interface ERC721 {\n function balanceOf(address owner) public view virtual returns (uint256);\n function ownerOf(uint256 tokenId) public view virtual returns (address);\n function name() public view virtual returns (string memory);\n function symbol() public view virtual returns (string memory);\n function tokenURI(uint256 tokenId) public view virtual returns (string memory);\n function getApproved(uint256 tokenId) public view virtual returns (address);\n function setApprovalForAll(address operator, bool approved) public virtual;\n function isApprovedForAll(address owner, address operator) public view virtual returns (bool);\n function transferFrom(address from, address to, uint256 tokenId) public virtual;\n function safeTransferFrom(address from, address to, uint256 tokenId) public;\n function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory data) public virtual;\n function _mint(address to, uint256 tokenId) internal;\n function _safeMint(address to, uint256 tokenId, bytes memory data) internal virtual;\n function _burn(uint256 tokenId) internal;\n function _transfer(address from, address to, uint256 tokenId) internal;\n function _approve(address to, uint256 tokenId, address auth) internal;\n }\n);\n\n// https://docs.soliditylang.org/en/latest/control-structures.html#revert\nsol!(\n// SPDX-License-Identifier: GPL-3.0\npragma solidity ^0.8.4;\n\n#[sol(rpc, bytecode = \"6080806040523460155761011e908161001a8239f35b5f80fdfe60808060405260043610156011575f80fd5b5f3560e01c9081633ccfd60b146094575063d96a094a14602f575f80fd5b6020366003190112609057671bc16d674ec80000340460043511604e57005b60405162461bcd60e51b815260206004820152601a6024820152792737ba1032b737bab3b41022ba3432b910383937bb34b232b21760311b6044820152606490fd5b5f80fd5b346090575f3660031901126090575f546001600160a01b0316330360da575f8080804781811560d2575b3390f11560c757005b6040513d5f823e3d90fd5b506108fc60be565b6282b42960e81b8152600490fdfea2646970667358221220c143fcbf0da5cee61ae3fcc385d9f7c4d6a7fb2ea42530d70d6049478db0b8a964736f6c63430008190033\")]\ncontract VendingMachine {\n address owner;\n error Unauthorized();\n #[derive(Debug)]\n function buy(uint amount) public payable {\n if (amount > msg.value / 2 ether)\n revert(\"Not enough Ether provided.\");\n // Alternative way to do it:\n require(\n amount <= msg.value / 2 ether,\n \"Not enough Ether provided.\"\n );\n // Perform the purchase.\n }\n function withdraw() public {\n if (msg.sender != owner)\n revert Unauthorized();\n\n payable(msg.sender).transfer(address(this).balance);\n }\n}\n);\n" }, { "path": "crates/anvil/tests/it/anvil.rs", "content": "//! tests for anvil specific logic\n\nuse alloy_consensus::EMPTY_ROOT_HASH;\nuse alloy_eips::BlockNumberOrTag;\nuse alloy_network::{ReceiptResponse, TransactionBuilder};\nuse alloy_primitives::{Address, B256, U256, bytes, hex};\nuse alloy_provider::Provider;\nuse alloy_rpc_types::TransactionRequest;\nuse alloy_sol_types::SolCall;\nuse anvil::{NodeConfig, spawn};\nuse foundry_evm::hardfork::EthereumHardfork;\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_can_change_mining_mode() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n assert!(api.anvil_get_auto_mine().unwrap());\n assert!(api.anvil_get_interval_mining().unwrap().is_none());\n\n let num = provider.get_block_number().await.unwrap();\n assert_eq!(num, 0);\n\n api.anvil_set_interval_mining(1).unwrap();\n assert!(!api.anvil_get_auto_mine().unwrap());\n assert!(matches!(api.anvil_get_interval_mining().unwrap(), Some(1)));\n // changing the mining mode will instantly mine a new block\n tokio::time::sleep(std::time::Duration::from_millis(500)).await;\n let num = provider.get_block_number().await.unwrap();\n assert_eq!(num, 0);\n\n tokio::time::sleep(std::time::Duration::from_millis(700)).await;\n let num = provider.get_block_number().await.unwrap();\n assert_eq!(num, 1);\n\n // assert that no block is mined when the interval is set to 0\n api.anvil_set_interval_mining(0).unwrap();\n assert!(!api.anvil_get_auto_mine().unwrap());\n assert!(api.anvil_get_interval_mining().unwrap().is_none());\n tokio::time::sleep(std::time::Duration::from_millis(1000)).await;\n let num = provider.get_block_number().await.unwrap();\n assert_eq!(num, 1);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_get_default_dev_keys() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let dev_accounts = handle.dev_accounts().collect::>();\n let accounts = provider.get_accounts().await.unwrap();\n\n assert_eq!(dev_accounts, accounts);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_set_empty_code() {\n let (api, _handle) = spawn(NodeConfig::test()).await;\n let addr = Address::random();\n api.anvil_set_code(addr, Vec::new().into()).await.unwrap();\n let code = api.get_code(addr, None).await.unwrap();\n assert!(code.as_ref().is_empty());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_can_set_genesis_timestamp() {\n let genesis_timestamp = 1000u64;\n let (_api, handle) =\n spawn(NodeConfig::test().with_genesis_timestamp(genesis_timestamp.into())).await;\n let provider = handle.http_provider();\n\n assert_eq!(\n genesis_timestamp,\n provider.get_block(0.into()).await.unwrap().unwrap().header.timestamp\n );\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_can_use_default_genesis_timestamp() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n assert_ne!(0u64, provider.get_block(0.into()).await.unwrap().unwrap().header.timestamp);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_can_handle_large_timestamp() {\n let (api, _handle) = spawn(NodeConfig::test()).await;\n let num = 317071597274;\n api.evm_set_next_block_timestamp(num).unwrap();\n api.mine_one().await;\n\n let block = api.block_by_number(BlockNumberOrTag::Latest).await.unwrap().unwrap();\n assert_eq!(block.header.timestamp, num);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_shanghai_fields() {\n let (api, _handle) =\n spawn(NodeConfig::test().with_hardfork(Some(EthereumHardfork::Shanghai.into()))).await;\n api.mine_one().await;\n\n let block = api.block_by_number(BlockNumberOrTag::Latest).await.unwrap().unwrap();\n assert_eq!(block.header.withdrawals_root, Some(EMPTY_ROOT_HASH));\n assert_eq!(block.withdrawals, Some(Default::default()));\n assert!(block.header.blob_gas_used.is_none());\n assert!(block.header.excess_blob_gas.is_none());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_cancun_fields() {\n let (api, _handle) =\n spawn(NodeConfig::test().with_hardfork(Some(EthereumHardfork::Cancun.into()))).await;\n api.mine_one().await;\n\n let block = api.block_by_number(BlockNumberOrTag::Latest).await.unwrap().unwrap();\n assert_eq!(block.header.withdrawals_root, Some(EMPTY_ROOT_HASH));\n assert_eq!(block.withdrawals, Some(Default::default()));\n assert!(block.header.blob_gas_used.is_some());\n assert!(block.header.excess_blob_gas.is_some());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_can_set_genesis_block_number() {\n let (_api, handle) = spawn(NodeConfig::test().with_genesis_block_number(Some(1337u64))).await;\n let provider = handle.http_provider();\n\n let block_number = provider.get_block_number().await.unwrap();\n assert_eq!(block_number, 1337u64);\n\n assert_eq!(1337, provider.get_block(1337.into()).await.unwrap().unwrap().header.number);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_can_use_default_genesis_block_number() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n assert_eq!(0, provider.get_block(0.into()).await.unwrap().unwrap().header.number);\n}\n\n/// Verify that genesis block number affects both RPC and EVM execution layer.\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_number_opcode_reflects_genesis_block_number() {\n let genesis_number: u64 = 4242;\n let (api, handle) =\n spawn(NodeConfig::test().with_genesis_block_number(Some(genesis_number))).await;\n let provider = handle.http_provider();\n\n // RPC layer should return configured genesis number\n let bn = provider.get_block_number().await.unwrap();\n assert_eq!(bn, genesis_number);\n\n // Deploy bytecode that returns block.number\n // 0x43 (NUMBER) 0x5f (PUSH0) 0x52 (MSTORE) 0x60 0x20 (PUSH1 0x20) 0x5f (PUSH0) 0xf3 (RETURN)\n let target = Address::random();\n api.anvil_set_code(target, bytes!(\"435f5260205ff3\")).await.unwrap();\n\n // EVM execution should reflect genesis number (+ 1 for pending block)\n let tx = alloy_rpc_types::TransactionRequest::default().with_to(target);\n let out = provider.call(tx.into()).await.unwrap();\n let returned = U256::from_be_slice(out.as_ref());\n assert_eq!(returned, U256::from(genesis_number + 1));\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_anvil_recover_signature() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n alloy_sol_types::sol! {\n #[sol(rpc)]\n contract TestRecover {\n function testRecover(bytes32 hash, uint8 v, bytes32 r, bytes32 s, address expected) external pure {\n address recovered = ecrecover(hash, v, r, s);\n require(recovered == expected, \"ecrecover failed: address mismatch\");\n }\n }\n }\n let bytecode = hex::decode(\n \"0x60808060405234601557610125908161001a8239f35b5f80fdfe60808060405260043610156011575f80fd5b5f3560e01c63bff0b743146023575f80fd5b3460eb5760a036600319011260eb5760243560ff811680910360eb576084356001600160a01b038116929083900360eb5760805f916020936004358252848201526044356040820152606435606082015282805260015afa1560e0575f516001600160a01b031603609057005b60405162461bcd60e51b815260206004820152602260248201527f65637265636f766572206661696c65643a2061646472657373206d69736d61746044820152610c6d60f31b6064820152608490fd5b6040513d5f823e3d90fd5b5f80fdfea264697066735822122006368b42bca31c97f2c409a1cc5186dc899d4255ecc28db7bbb0ad285dc82ae464736f6c634300081c0033\",\n ).unwrap();\n\n let tx = TransactionRequest::default().with_deploy_code(bytecode);\n let receipt = provider.send_transaction(tx.into()).await.unwrap().get_receipt().await.unwrap();\n let contract_address = receipt.contract_address().unwrap();\n let contract = TestRecover::new(contract_address, &provider);\n\n let sig = alloy_primitives::hex::decode(\"11\".repeat(65)).unwrap();\n let r = B256::from_slice(&sig[0..32]);\n let s = B256::from_slice(&sig[32..64]);\n let v = sig[64];\n let fake_hash = B256::random();\n let expected = alloy_primitives::address!(\"0x1234567890123456789012345678901234567890\");\n api.anvil_impersonate_signature(sig.clone().into(), expected).await.unwrap();\n let result = contract.testRecover(fake_hash, v, r, s, expected).call().await;\n assert!(result.is_ok(), \"ecrecover failed: {:?}\", result.err());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fake_signature_transaction() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n alloy_sol_types::sol! {\n #[sol(rpc)]\n contract TestRecover {\n function testRecover(bytes32 hash, uint8 v, bytes32 r, bytes32 s, address expected) external pure {\n address recovered = ecrecover(hash, v, r, s);\n require(recovered == expected, \"ecrecover failed: address mismatch\");\n }\n }\n }\n let bytecode = hex::decode(\n \"0x60808060405234601557610125908161001a8239f35b5f80fdfe60808060405260043610156011575f80fd5b5f3560e01c63bff0b743146023575f80fd5b3460eb5760a036600319011260eb5760243560ff811680910360eb576084356001600160a01b038116929083900360eb5760805f916020936004358252848201526044356040820152606435606082015282805260015afa1560e0575f516001600160a01b031603609057005b60405162461bcd60e51b815260206004820152602260248201527f65637265636f766572206661696c65643a2061646472657373206d69736d61746044820152610c6d60f31b6064820152608490fd5b6040513d5f823e3d90fd5b5f80fdfea264697066735822122006368b42bca31c97f2c409a1cc5186dc899d4255ecc28db7bbb0ad285dc82ae464736f6c634300081c0033\",\n ).unwrap();\n\n let tx = TransactionRequest::default().with_deploy_code(bytecode);\n let _receipt = provider.send_transaction(tx.into()).await.unwrap().get_receipt().await.unwrap();\n\n let sig = alloy_primitives::hex::decode(\"11\".repeat(65)).unwrap();\n let r = B256::from_slice(&sig[0..32]);\n let s = B256::from_slice(&sig[32..64]);\n let v = sig[64];\n let fake_hash = B256::random();\n let expected = alloy_primitives::address!(\"0x1234567890123456789012345678901234567890\");\n api.anvil_impersonate_signature(sig.clone().into(), expected).await.unwrap();\n let calldata = TestRecover::testRecoverCall { hash: fake_hash, v, r, s, expected }.abi_encode();\n let tx = TransactionRequest::default().with_input(calldata);\n let pending = provider.send_transaction(tx.into()).await.unwrap();\n let result = pending.get_receipt().await;\n\n assert!(result.is_ok(), \"ecrecover failed: {:?}\", result.err());\n}\n" }, { "path": "crates/anvil/tests/it/anvil_api.rs", "content": "//! tests for custom anvil endpoints\n\nuse crate::{\n abi::{self, BUSD, Greeter, Multicall},\n fork::fork_config,\n utils::http_provider_with_signer,\n};\nuse alloy_consensus::{SignableTransaction, TxEip1559};\nuse alloy_network::{EthereumWallet, TransactionBuilder, TxSignerSync};\nuse alloy_primitives::{Address, Bytes, TxKind, U256, address, fixed_bytes};\nuse alloy_provider::{Provider, ext::TxPoolApi};\nuse alloy_rpc_types::{\n BlockId, BlockNumberOrTag, TransactionRequest,\n anvil::{\n ForkedNetwork, Forking, Metadata, MineOptions, NodeEnvironment, NodeForkConfig, NodeInfo,\n },\n};\nuse alloy_serde::WithOtherFields;\nuse anvil::{NodeConfig, eth::api::CLIENT_VERSION, spawn};\nuse anvil_core::{\n eth::EthRequest,\n types::{ReorgOptions, TransactionData},\n};\nuse foundry_evm::hardfork::EthereumHardfork;\n\nuse revm::primitives::hardfork::SpecId;\nuse std::{\n str::FromStr,\n time::{Duration, SystemTime},\n};\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_set_gas_price() {\n let (api, handle) =\n spawn(NodeConfig::test().with_hardfork(Some(EthereumHardfork::Berlin.into()))).await;\n let provider = handle.http_provider();\n\n let gas_price = U256::from(1337);\n api.anvil_set_min_gas_price(gas_price).await.unwrap();\n assert_eq!(gas_price.to::(), provider.get_gas_price().await.unwrap());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_set_block_gas_limit() {\n let (api, _) =\n spawn(NodeConfig::test().with_hardfork(Some(EthereumHardfork::Berlin.into()))).await;\n\n let block_gas_limit = U256::from(1337);\n assert!(api.evm_set_block_gas_limit(block_gas_limit).unwrap());\n // Mine a new block, and check the new block gas limit\n api.mine_one().await;\n let latest_block = api.block_by_number(BlockNumberOrTag::Latest).await.unwrap().unwrap();\n assert_eq!(block_gas_limit.to::(), latest_block.header.gas_limit);\n}\n\n// Ref \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_set_storage() {\n let (api, _handle) = spawn(NodeConfig::test()).await;\n let s = r#\"{\"jsonrpc\": \"2.0\", \"method\": \"hardhat_setStorageAt\", \"id\": 1, \"params\": [\"0xe9e7CEA3DedcA5984780Bafc599bD69ADd087D56\", \"0xa6eef7e35abe7026729641147f7915573c7e97b47efa546f5f6e3230263bcb49\", \"0x0000000000000000000000000000000000000000000000000000000000003039\"]}\"#;\n let req = serde_json::from_str::(s).unwrap();\n let (addr, slot, val) = match req.clone() {\n EthRequest::SetStorageAt(addr, slot, val) => (addr, slot, val),\n _ => unreachable!(),\n };\n\n api.execute(req).await;\n\n let storage_value = api.storage_at(addr, slot, None).await.unwrap();\n assert_eq!(val, storage_value);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_impersonate_account() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n let provider = handle.http_provider();\n\n let impersonate = Address::random();\n let to = Address::random();\n let val = U256::from(1337);\n let funding = U256::from(1e18 as u64);\n // fund the impersonated account\n api.anvil_set_balance(impersonate, funding).await.unwrap();\n\n let balance = api.balance(impersonate, None).await.unwrap();\n assert_eq!(balance, funding);\n\n let tx = TransactionRequest::default().with_from(impersonate).with_to(to).with_value(val);\n let tx = WithOtherFields::new(tx);\n\n let res = provider.send_transaction(tx.clone()).await;\n res.unwrap_err();\n\n api.anvil_impersonate_account(impersonate).await.unwrap();\n assert!(api.accounts().unwrap().contains(&impersonate));\n\n let res = provider.send_transaction(tx.clone()).await.unwrap().get_receipt().await.unwrap();\n assert_eq!(res.from, impersonate);\n\n let nonce = provider.get_transaction_count(impersonate).await.unwrap();\n assert_eq!(nonce, 1);\n\n let balance = provider.get_balance(to).await.unwrap();\n assert_eq!(balance, val);\n\n api.anvil_stop_impersonating_account(impersonate).await.unwrap();\n let res = provider.send_transaction(tx).await;\n res.unwrap_err();\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_auto_impersonate_account() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n let provider = handle.http_provider();\n\n let impersonate = Address::random();\n let to = Address::random();\n let val = U256::from(1337);\n let funding = U256::from(1e18 as u64);\n // fund the impersonated account\n api.anvil_set_balance(impersonate, funding).await.unwrap();\n\n let balance = api.balance(impersonate, None).await.unwrap();\n assert_eq!(balance, funding);\n\n let tx = TransactionRequest::default().with_from(impersonate).with_to(to).with_value(val);\n let tx = WithOtherFields::new(tx);\n\n let res = provider.send_transaction(tx.clone()).await;\n res.unwrap_err();\n\n api.anvil_auto_impersonate_account(true).await.unwrap();\n\n let res = provider.send_transaction(tx.clone()).await.unwrap().get_receipt().await.unwrap();\n assert_eq!(res.from, impersonate);\n\n let nonce = provider.get_transaction_count(impersonate).await.unwrap();\n assert_eq!(nonce, 1);\n\n let balance = provider.get_balance(to).await.unwrap();\n assert_eq!(balance, val);\n\n api.anvil_auto_impersonate_account(false).await.unwrap();\n let res = provider.send_transaction(tx).await;\n res.unwrap_err();\n\n // explicitly impersonated accounts get returned by `eth_accounts`\n api.anvil_impersonate_account(impersonate).await.unwrap();\n assert!(api.accounts().unwrap().contains(&impersonate));\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_impersonate_contract() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n let provider = handle.http_provider();\n\n let greeter_contract = Greeter::deploy(&provider, \"Hello World!\".to_string()).await.unwrap();\n let impersonate = greeter_contract.address().to_owned();\n\n let to = Address::random();\n let val = U256::from(1337);\n\n // // fund the impersonated account\n api.anvil_set_balance(impersonate, U256::from(1e18 as u64)).await.unwrap();\n\n let tx = TransactionRequest::default().with_from(impersonate).to(to).with_value(val);\n let tx = WithOtherFields::new(tx);\n\n let res = provider.send_transaction(tx.clone()).await;\n res.unwrap_err();\n\n let greeting = greeter_contract.greet().call().await.unwrap();\n assert_eq!(\"Hello World!\", greeting);\n\n api.anvil_impersonate_account(impersonate).await.unwrap();\n\n let res = provider.send_transaction(tx.clone()).await.unwrap().get_receipt().await.unwrap();\n assert_eq!(res.from, impersonate);\n\n let balance = provider.get_balance(to).await.unwrap();\n assert_eq!(balance, val);\n\n api.anvil_stop_impersonating_account(impersonate).await.unwrap();\n let res = provider.send_transaction(tx).await;\n res.unwrap_err();\n\n let greeting = greeter_contract.greet().call().await.unwrap();\n assert_eq!(\"Hello World!\", greeting);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_impersonate_gnosis_safe() {\n let (api, handle) = spawn(fork_config()).await;\n let provider = handle.http_provider();\n\n // \n let safe = address!(\"0xA063Cb7CFd8E57c30c788A0572CBbf2129ae56B6\");\n\n let code = provider.get_code_at(safe).await.unwrap();\n assert!(!code.is_empty());\n\n api.anvil_impersonate_account(safe).await.unwrap();\n\n let code = provider.get_code_at(safe).await.unwrap();\n assert!(!code.is_empty());\n\n let balance = U256::from(1e18 as u64);\n // fund the impersonated account\n api.anvil_set_balance(safe, balance).await.unwrap();\n\n let on_chain_balance = provider.get_balance(safe).await.unwrap();\n assert_eq!(on_chain_balance, balance);\n\n api.anvil_stop_impersonating_account(safe).await.unwrap();\n\n let code = provider.get_code_at(safe).await.unwrap();\n // code is added back after stop impersonating\n assert!(!code.is_empty());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_impersonate_multiple_accounts() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let impersonate0 = Address::random();\n let impersonate1 = Address::random();\n let to = Address::random();\n\n let val = U256::from(1337);\n let funding = U256::from(1e18 as u64);\n // fund the impersonated accounts\n api.anvil_set_balance(impersonate0, funding).await.unwrap();\n api.anvil_set_balance(impersonate1, funding).await.unwrap();\n\n let tx = TransactionRequest::default().with_from(impersonate0).to(to).with_value(val);\n let tx = WithOtherFields::new(tx);\n\n api.anvil_impersonate_account(impersonate0).await.unwrap();\n api.anvil_impersonate_account(impersonate1).await.unwrap();\n\n let res0 = provider.send_transaction(tx.clone()).await.unwrap().get_receipt().await.unwrap();\n assert_eq!(res0.from, impersonate0);\n\n let nonce = provider.get_transaction_count(impersonate0).await.unwrap();\n assert_eq!(nonce, 1);\n\n let receipt = provider.get_transaction_receipt(res0.transaction_hash).await.unwrap().unwrap();\n assert_eq!(res0.inner, receipt.inner);\n\n let res1 = provider\n .send_transaction(tx.with_from(impersonate1))\n .await\n .unwrap()\n .get_receipt()\n .await\n .unwrap();\n\n assert_eq!(res1.from, impersonate1);\n\n let nonce = provider.get_transaction_count(impersonate1).await.unwrap();\n assert_eq!(nonce, 1);\n\n let receipt = provider.get_transaction_receipt(res1.transaction_hash).await.unwrap().unwrap();\n assert_eq!(res1.inner, receipt.inner);\n\n assert_ne!(res0.inner, res1.inner);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_mine_manually() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let start_num = provider.get_block_number().await.unwrap();\n\n for (idx, _) in std::iter::repeat_n((), 10).enumerate() {\n api.evm_mine(None).await.unwrap();\n let num = provider.get_block_number().await.unwrap();\n assert_eq!(num, start_num + idx as u64 + 1);\n }\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_set_next_timestamp() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let now = SystemTime::now().duration_since(SystemTime::UNIX_EPOCH).unwrap();\n\n let next_timestamp = now + Duration::from_secs(60);\n\n // mock timestamp\n api.evm_set_next_block_timestamp(next_timestamp.as_secs()).unwrap();\n\n api.evm_mine(None).await.unwrap();\n\n let block = provider.get_block(BlockId::default()).await.unwrap().unwrap();\n\n assert_eq!(block.header.number, 1);\n assert_eq!(block.header.timestamp, next_timestamp.as_secs());\n\n api.evm_mine(None).await.unwrap();\n\n let next = provider.get_block(BlockId::default()).await.unwrap().unwrap();\n assert_eq!(next.header.number, 2);\n\n assert!(next.header.timestamp >= block.header.timestamp);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_evm_set_time() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let now = SystemTime::now().duration_since(SystemTime::UNIX_EPOCH).unwrap();\n\n let timestamp = now + Duration::from_secs(120);\n\n // mock timestamp\n api.evm_set_time(timestamp.as_secs()).unwrap();\n\n // mine a block\n api.evm_mine(None).await.unwrap();\n let block = provider.get_block(BlockId::default()).await.unwrap().unwrap();\n\n assert!(block.header.timestamp >= timestamp.as_secs());\n\n api.evm_mine(None).await.unwrap();\n let next = provider.get_block(BlockId::default()).await.unwrap().unwrap();\n\n assert!(next.header.timestamp >= block.header.timestamp);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_evm_set_time_in_past() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let now = SystemTime::now().duration_since(SystemTime::UNIX_EPOCH).unwrap();\n\n let timestamp = now - Duration::from_secs(120);\n\n // mock timestamp\n api.evm_set_time(timestamp.as_secs()).unwrap();\n\n // mine a block\n api.evm_mine(None).await.unwrap();\n let block = provider.get_block(BlockId::default()).await.unwrap().unwrap();\n\n assert!(block.header.timestamp >= timestamp.as_secs());\n assert!(block.header.timestamp < now.as_secs());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_timestamp_interval() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n api.evm_mine(None).await.unwrap();\n let interval = 10;\n\n for _ in 0..5 {\n let block = provider.get_block(BlockId::default()).await.unwrap().unwrap();\n\n // mock timestamp\n api.evm_set_block_timestamp_interval(interval).unwrap();\n api.evm_mine(None).await.unwrap();\n\n let new_block = provider.get_block(BlockId::default()).await.unwrap().unwrap();\n\n assert_eq!(new_block.header.timestamp, block.header.timestamp + interval);\n }\n\n let block = provider.get_block(BlockId::default()).await.unwrap().unwrap();\n\n let next_timestamp = block.header.timestamp + 50;\n api.evm_set_next_block_timestamp(next_timestamp).unwrap();\n\n api.evm_mine(None).await.unwrap();\n let block = provider.get_block(BlockId::default()).await.unwrap().unwrap();\n assert_eq!(block.header.timestamp, next_timestamp);\n\n api.evm_mine(None).await.unwrap();\n\n let block = provider.get_block(BlockId::default()).await.unwrap().unwrap();\n // interval also works after setting the next timestamp manually\n assert_eq!(block.header.timestamp, next_timestamp + interval);\n\n assert!(api.evm_remove_block_timestamp_interval().unwrap());\n\n api.evm_mine(None).await.unwrap();\n let new_block = provider.get_block(BlockId::default()).await.unwrap().unwrap();\n\n // offset is applied correctly after resetting the interval\n assert!(new_block.header.timestamp > block.header.timestamp);\n\n api.evm_mine(None).await.unwrap();\n let another_block = provider.get_block(BlockId::default()).await.unwrap().unwrap();\n // check interval is disabled\n assert!(another_block.header.timestamp - new_block.header.timestamp < interval);\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_can_set_storage_bsc_fork() {\n let (api, handle) =\n spawn(NodeConfig::test().with_eth_rpc_url(Some(\"https://bsc-dataseed.binance.org/\"))).await;\n let provider = handle.http_provider();\n\n let busd_addr = address!(\"0xe9e7CEA3DedcA5984780Bafc599bD69ADd087D56\");\n let idx = U256::from_str(\"0xa6eef7e35abe7026729641147f7915573c7e97b47efa546f5f6e3230263bcb49\")\n .unwrap();\n let value = fixed_bytes!(\"0000000000000000000000000000000000000000000000000000000000003039\");\n\n api.anvil_set_storage_at(busd_addr, idx, value).await.unwrap();\n let storage = api.storage_at(busd_addr, idx, None).await.unwrap();\n assert_eq!(storage, value);\n\n let busd_contract = BUSD::new(busd_addr, &provider);\n\n let balance = busd_contract\n .balanceOf(address!(\"0x0000000000000000000000000000000000000000\"))\n .call()\n .await\n .unwrap();\n assert_eq!(balance, U256::from(12345u64));\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_get_node_info() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n let node_info = api.anvil_node_info().await.unwrap();\n\n let provider = handle.http_provider();\n\n let block_number = provider.get_block_number().await.unwrap();\n let block = provider.get_block(BlockId::from(block_number)).await.unwrap().unwrap();\n let hard_fork: &str = SpecId::OSAKA.into();\n\n let expected_node_info = NodeInfo {\n current_block_number: 0_u64,\n current_block_timestamp: 1,\n current_block_hash: block.header.hash,\n hard_fork: hard_fork.to_string(),\n transaction_order: \"fees\".to_owned(),\n environment: NodeEnvironment {\n base_fee: U256::from_str(\"0x3b9aca00\").unwrap().to(),\n chain_id: 0x7a69,\n gas_limit: U256::from_str(\"0x1c9c380\").unwrap().to(),\n gas_price: U256::from_str(\"0x77359400\").unwrap().to(),\n },\n fork_config: NodeForkConfig {\n fork_url: None,\n fork_block_number: None,\n fork_retry_backoff: None,\n },\n };\n\n assert_eq!(node_info, expected_node_info);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_get_metadata() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n let metadata = api.anvil_metadata().await.unwrap();\n\n let provider = handle.http_provider();\n\n let block_number = provider.get_block_number().await.unwrap();\n let chain_id = provider.get_chain_id().await.unwrap();\n let block = provider.get_block(BlockId::from(block_number)).await.unwrap().unwrap();\n\n let expected_metadata = Metadata {\n latest_block_hash: block.header.hash,\n latest_block_number: block_number,\n chain_id,\n client_version: CLIENT_VERSION.to_string(),\n instance_id: api.instance_id(),\n forked_network: None,\n snapshots: Default::default(),\n };\n\n assert_eq!(metadata, expected_metadata);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_get_metadata_on_fork() {\n let (api, handle) =\n spawn(NodeConfig::test().with_eth_rpc_url(Some(\"https://bsc-dataseed.binance.org/\"))).await;\n let provider = handle.http_provider();\n\n let metadata = api.anvil_metadata().await.unwrap();\n\n let block_number = provider.get_block_number().await.unwrap();\n let chain_id = provider.get_chain_id().await.unwrap();\n let block = provider.get_block(BlockId::from(block_number)).await.unwrap().unwrap();\n\n let expected_metadata = Metadata {\n latest_block_hash: block.header.hash,\n latest_block_number: block_number,\n chain_id,\n client_version: CLIENT_VERSION.to_string(),\n instance_id: api.instance_id(),\n forked_network: Some(ForkedNetwork {\n chain_id,\n fork_block_number: block_number,\n fork_block_hash: block.header.hash,\n }),\n snapshots: Default::default(),\n };\n\n assert_eq!(metadata, expected_metadata);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn metadata_changes_on_reset() {\n let (api, _) =\n spawn(NodeConfig::test().with_eth_rpc_url(Some(\"https://bsc-dataseed.binance.org/\"))).await;\n\n let metadata = api.anvil_metadata().await.unwrap();\n let instance_id = metadata.instance_id;\n\n api.anvil_reset(Some(Forking { json_rpc_url: None, block_number: None })).await.unwrap();\n\n let new_metadata = api.anvil_metadata().await.unwrap();\n let new_instance_id = new_metadata.instance_id;\n\n assert_ne!(instance_id, new_instance_id);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_get_transaction_receipt() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n // set the base fee\n let new_base_fee = U256::from(1000);\n api.anvil_set_next_block_base_fee_per_gas(new_base_fee).await.unwrap();\n\n // send a EIP-1559 transaction\n let to = Address::random();\n let val = U256::from(1337);\n let tx = TransactionRequest::default().with_to(to).with_value(val);\n let tx = WithOtherFields::new(tx);\n\n let receipt = provider.send_transaction(tx.clone()).await.unwrap().get_receipt().await.unwrap();\n\n // the block should have the new base fee\n let block = provider.get_block(BlockId::default()).await.unwrap().unwrap();\n assert_eq!(block.header.base_fee_per_gas.unwrap(), new_base_fee.to::());\n\n // mine blocks\n api.evm_mine(None).await.unwrap();\n\n // the transaction receipt should have the original effective gas price\n let new_receipt = provider.get_transaction_receipt(receipt.transaction_hash).await.unwrap();\n assert_eq!(receipt.effective_gas_price, new_receipt.unwrap().effective_gas_price);\n}\n\n// test can set chain id\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_set_chain_id() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n let chain_id = provider.get_chain_id().await.unwrap();\n assert_eq!(chain_id, 31337);\n\n let chain_id = 1234;\n api.anvil_set_chain_id(chain_id).await.unwrap();\n\n let chain_id = provider.get_chain_id().await.unwrap();\n assert_eq!(chain_id, 1234);\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_revert_next_block_timestamp() {\n let (api, _handle) = spawn(fork_config()).await;\n\n // Mine a new block, and check the new block gas limit\n api.mine_one().await;\n let latest_block = api.block_by_number(BlockNumberOrTag::Latest).await.unwrap().unwrap();\n\n let state_snapshot = api.evm_snapshot().await.unwrap();\n api.mine_one().await;\n api.evm_revert(state_snapshot).await.unwrap();\n let block = api.block_by_number(BlockNumberOrTag::Latest).await.unwrap().unwrap();\n assert_eq!(block, latest_block);\n\n api.mine_one().await;\n let block = api.block_by_number(BlockNumberOrTag::Latest).await.unwrap().unwrap();\n assert!(block.header.timestamp >= latest_block.header.timestamp);\n}\n\n// test that after a snapshot revert, the env block is reset\n// to its correct value (block number, etc.)\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_revert_call_latest_block_timestamp() {\n let (api, handle) = spawn(fork_config()).await;\n let provider = handle.http_provider();\n\n // Mine a new block, and check the new block gas limit\n api.mine_one().await;\n let latest_block = api.block_by_number(BlockNumberOrTag::Latest).await.unwrap().unwrap();\n\n let state_snapshot = api.evm_snapshot().await.unwrap();\n api.mine_one().await;\n api.evm_revert(state_snapshot).await.unwrap();\n\n let multicall_contract =\n Multicall::new(address!(\"0xeefba1e63905ef1d7acba5a8513c70307c1ce441\"), &provider);\n\n let timestamp = multicall_contract.getCurrentBlockTimestamp().call().await.unwrap();\n assert_eq!(timestamp, U256::from(latest_block.header.timestamp));\n\n let difficulty = multicall_contract.getCurrentBlockDifficulty().call().await.unwrap();\n assert_eq!(difficulty, U256::from(latest_block.header.difficulty));\n\n let gaslimit = multicall_contract.getCurrentBlockGasLimit().call().await.unwrap();\n assert_eq!(gaslimit, U256::from(latest_block.header.gas_limit));\n\n let coinbase = multicall_contract.getCurrentBlockCoinbase().call().await.unwrap();\n assert_eq!(coinbase, latest_block.header.beneficiary);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_remove_pool_transactions() {\n let (api, handle) =\n spawn(NodeConfig::test().with_blocktime(Some(Duration::from_secs(5)))).await;\n\n let wallet = handle.dev_wallets().next().unwrap();\n let signer: EthereumWallet = wallet.clone().into();\n let from = wallet.address();\n\n let provider = http_provider_with_signer(&handle.http_endpoint(), signer);\n\n let sender = Address::random();\n let to = Address::random();\n let val = U256::from(1337);\n let tx = TransactionRequest::default().with_from(sender).with_to(to).with_value(val);\n let tx = WithOtherFields::new(tx);\n\n provider.send_transaction(tx.with_from(from)).await.unwrap().register().await.unwrap();\n\n let initial_txs = provider.txpool_inspect().await.unwrap();\n assert_eq!(initial_txs.pending.len(), 1);\n\n api.anvil_remove_pool_transactions(wallet.address()).await.unwrap();\n\n let final_txs = provider.txpool_inspect().await.unwrap();\n assert_eq!(final_txs.pending.len(), 0);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn flaky_test_reorg() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let accounts = handle.dev_wallets().collect::>();\n\n // Test calls\n // Populate chain\n for i in 0..10 {\n let tx = TransactionRequest::default()\n .to(accounts[0].address())\n .value(U256::from(i))\n .from(accounts[1].address());\n let tx = WithOtherFields::new(tx);\n api.send_transaction(tx).await.unwrap();\n\n let tx = TransactionRequest::default()\n .to(accounts[1].address())\n .value(U256::from(i))\n .from(accounts[2].address());\n let tx = WithOtherFields::new(tx);\n api.send_transaction(tx).await.unwrap();\n }\n\n // Define transactions\n let mut txs = vec![];\n for i in 0..3 {\n let from = accounts[i].address();\n let to = accounts[i + 1].address();\n for j in 0..5 {\n let tx = TransactionRequest::default().from(from).to(to).value(U256::from(j));\n txs.push((TransactionData::JSON(tx), i as u64));\n }\n }\n\n let prev_height = provider.get_block_number().await.unwrap();\n api.anvil_reorg(ReorgOptions { depth: 7, tx_block_pairs: txs }).await.unwrap();\n\n let reorged_height = provider.get_block_number().await.unwrap();\n assert_eq!(reorged_height, prev_height);\n\n // The first 3 reorged blocks should have 5 transactions each\n for num in 14..17 {\n let block = provider.get_block_by_number(num.into()).full().await.unwrap();\n let block = block.unwrap();\n assert_eq!(block.transactions.len(), 5);\n }\n\n // Verify that historic blocks are still accessible\n for num in (0..14).rev() {\n let block = provider.get_block_by_number(num.into()).full().await.unwrap();\n assert!(block.is_some(), \"Historic block {num} should be accessible after reorg\");\n }\n\n // Send a few more transaction to verify the chain can still progress\n for i in 0..3 {\n let tx = TransactionRequest::default()\n .to(accounts[0].address())\n .value(U256::from(i))\n .from(accounts[1].address());\n let tx = WithOtherFields::new(tx);\n api.send_transaction(tx).await.unwrap();\n }\n\n // Test reverting code\n let greeter = abi::Greeter::deploy(provider.clone(), \"Reorg\".to_string()).await.unwrap();\n api.anvil_reorg(ReorgOptions { depth: 5, tx_block_pairs: vec![] }).await.unwrap();\n let code = api.get_code(*greeter.address(), Some(BlockId::latest())).await.unwrap();\n assert_eq!(code, Bytes::default());\n\n // Test reverting contract storage\n let storage =\n abi::SimpleStorage::deploy(provider.clone(), \"initial value\".to_string()).await.unwrap();\n api.evm_mine(Some(MineOptions::Options { timestamp: None, blocks: Some(5) })).await.unwrap();\n let _ = storage\n .setValue(\"ReorgMe\".to_string())\n .from(accounts[0].address())\n .send()\n .await\n .unwrap()\n .get_receipt()\n .await\n .unwrap();\n api.anvil_reorg(ReorgOptions { depth: 3, tx_block_pairs: vec![] }).await.unwrap();\n let value = storage.getValue().call().await.unwrap();\n assert_eq!(\"initial value\".to_string(), value);\n\n api.mine_one().await;\n api.mine_one().await;\n\n // Test raw transaction data\n let mut tx = TxEip1559 {\n chain_id: api.chain_id(),\n to: TxKind::Call(accounts[1].address()),\n value: U256::from(100),\n max_priority_fee_per_gas: 1000000000000,\n max_fee_per_gas: 10000000000000,\n gas_limit: 21000,\n ..Default::default()\n };\n let signature = accounts[5].sign_transaction_sync(&mut tx).unwrap();\n let tx = tx.into_signed(signature);\n let mut encoded = vec![];\n tx.eip2718_encode(&mut encoded);\n\n let pre_bal = provider.get_balance(accounts[5].address()).await.unwrap();\n api.anvil_reorg(ReorgOptions {\n depth: 1,\n tx_block_pairs: vec![(TransactionData::Raw(encoded.into()), 0)],\n })\n .await\n .unwrap();\n let post_bal = provider.get_balance(accounts[5].address()).await.unwrap();\n assert_ne!(pre_bal, post_bal);\n\n // Test reorg depth exceeding current height\n let res = api.anvil_reorg(ReorgOptions { depth: 100, tx_block_pairs: vec![] }).await;\n assert!(res.is_err());\n\n // Test reorg tx pairs exceeds chain length\n let res = api\n .anvil_reorg(ReorgOptions {\n depth: 1,\n tx_block_pairs: vec![(TransactionData::JSON(TransactionRequest::default()), 10)],\n })\n .await;\n assert!(res.is_err());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_reorg_blockhash_opcode_consistency() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let multicall = Multicall::deploy(&provider).await.unwrap();\n\n api.evm_mine(Some(MineOptions::Options { timestamp: None, blocks: Some(200) })).await.unwrap();\n\n let tip_before_reorg = api.block_number().unwrap().to::();\n\n let mut cached_hashes: Vec<(u64, alloy_primitives::B256, alloy_primitives::B256)> = Vec::new();\n for i in 1..=10 {\n let block_num = tip_before_reorg - i;\n let rpc_hash =\n provider.get_block_by_number(block_num.into()).await.unwrap().unwrap().header.hash;\n let opcode_hash = multicall.getBlockHash(U256::from(block_num)).call().await.unwrap();\n assert_eq!(rpc_hash, opcode_hash, \"RPC and BLOCKHASH opcode should match before reorg\");\n cached_hashes.push((block_num, rpc_hash, opcode_hash));\n }\n\n let tx = TransactionRequest::default();\n api.anvil_reorg(ReorgOptions {\n depth: 5,\n tx_block_pairs: vec![(TransactionData::JSON(tx), 0)],\n })\n .await\n .unwrap();\n\n api.mine_one().await;\n\n for (block_num, rpc_before, opcode_before) in &cached_hashes {\n let rpc_after =\n provider.get_block_by_number((*block_num).into()).await.unwrap().unwrap().header.hash;\n let opcode_after = multicall.getBlockHash(U256::from(*block_num)).call().await.unwrap();\n if *block_num <= tip_before_reorg.saturating_sub(5) {\n assert_eq!(\n rpc_after, *rpc_before,\n \"Block {block_num}: hash should not change for non-reorged blocks\"\n );\n assert_eq!(\n opcode_after, *opcode_before,\n \"Block {block_num}: BLOCKHASH should not change for non-reorged blocks\"\n );\n }\n assert_eq!(\n rpc_after, opcode_after,\n \"Block {block_num}: RPC ({rpc_after}) and BLOCKHASH opcode ({opcode_after}) should match after reorg\"\n );\n }\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_reorg_deep_blockhash_consistency() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let multicall = Multicall::deploy(&provider).await.unwrap();\n\n // Mine 300 blocks (more than BLOCKHASH limit of 256)\n api.evm_mine(Some(MineOptions::Options { timestamp: None, blocks: Some(300) })).await.unwrap();\n\n let tip_before_reorg = api.block_number().unwrap().to::();\n assert!(tip_before_reorg > 256, \"Need more than 256 blocks for this test\");\n\n // Check blocks within the 256 window before reorg\n let mut cached_hashes: Vec<(u64, alloy_primitives::B256)> = Vec::new();\n for i in [1, 10, 100, 200, 255] {\n let block_num = tip_before_reorg - i;\n let rpc_hash =\n provider.get_block_by_number(block_num.into()).await.unwrap().unwrap().header.hash;\n let opcode_hash = multicall.getBlockHash(U256::from(block_num)).call().await.unwrap();\n assert_eq!(rpc_hash, opcode_hash, \"RPC and BLOCKHASH opcode should match before reorg\");\n cached_hashes.push((block_num, rpc_hash));\n }\n\n // Perform a deep reorg (50 blocks)\n let tx = TransactionRequest::default();\n api.anvil_reorg(ReorgOptions {\n depth: 50,\n tx_block_pairs: vec![(TransactionData::JSON(tx), 0)],\n })\n .await\n .unwrap();\n\n api.mine_one().await;\n\n let tip_after_reorg = api.block_number().unwrap().to::();\n\n // Verify blocks still in the 256 window have consistent hashes\n for (block_num, rpc_before) in &cached_hashes {\n // Skip blocks that were reorged\n if *block_num > tip_after_reorg - 50 {\n continue;\n }\n let rpc_after =\n provider.get_block_by_number((*block_num).into()).await.unwrap().unwrap().header.hash;\n let opcode_after = multicall.getBlockHash(U256::from(*block_num)).call().await.unwrap();\n assert_eq!(\n rpc_after, *rpc_before,\n \"Block {block_num}: hash should not change for non-reorged blocks\"\n );\n assert_eq!(\n rpc_after, opcode_after,\n \"Block {block_num}: RPC and BLOCKHASH should match after deep reorg\"\n );\n }\n\n // Verify BLOCKHASH returns 0 for blocks outside the 256 window\n let old_block = tip_after_reorg.saturating_sub(257);\n if old_block > 0 {\n let opcode_hash = multicall.getBlockHash(U256::from(old_block)).call().await.unwrap();\n assert_eq!(\n opcode_hash,\n alloy_primitives::B256::ZERO,\n \"BLOCKHASH should return 0 for blocks outside 256 window\"\n );\n }\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_rollback() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n // Mine 5 blocks\n for _ in 0..5 {\n api.mine_one().await;\n }\n\n // Get block 4 for later comparison\n let block4 = provider.get_block(4.into()).await.unwrap().unwrap();\n\n // Rollback with None should rollback 1 block\n api.anvil_rollback(None).await.unwrap();\n\n // Assert we're at block 4 and the block contents are kept the same\n let head = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n assert_eq!(head, block4);\n\n // Get block 1 for comparison\n let block1 = provider.get_block(1.into()).await.unwrap().unwrap();\n\n // Rollback to block 1\n let depth = 3; // from block 4 to block 1\n api.anvil_rollback(Some(depth)).await.unwrap();\n\n // Assert we're at block 1 and the block contents are kept the same\n let head = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n assert_eq!(head, block1);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_arb_get_block() {\n let (api, _handle) = spawn(NodeConfig::test().with_chain_id(Some(421611u64))).await;\n\n // Mine two blocks\n api.mine_one().await;\n api.mine_one().await;\n\n let best_number = api.block_number().unwrap().to::();\n\n assert_eq!(best_number, 2);\n\n let block = api.block_by_number(1.into()).await.unwrap().unwrap();\n\n assert_eq!(block.header.number, 1);\n}\n\n// Set next_block_timestamp same as previous block\n// api.evm_set_next_block_timestamp(0).unwrap();\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_mine_blk_with_prev_timestamp() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let init_blk = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n\n let init_number = init_blk.header.number;\n let init_timestamp = init_blk.header.timestamp;\n\n // mock timestamp\n api.evm_set_next_block_timestamp(init_timestamp).unwrap();\n\n api.mine_one().await;\n\n let block = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n\n let next_blk_num = block.header.number;\n let next_blk_timestamp = block.header.timestamp;\n\n assert_eq!(next_blk_num, init_number + 1);\n assert_eq!(next_blk_timestamp, init_timestamp);\n\n // Sleep for 1 second\n tokio::time::sleep(Duration::from_secs(1)).await;\n\n // Subsequent block should have a greater timestamp than previous block\n api.mine_one().await;\n\n let block = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n\n let third_blk_num = block.header.number;\n let third_blk_timestamp = block.header.timestamp;\n\n assert_eq!(third_blk_num, init_number + 2);\n assert_ne!(third_blk_timestamp, next_blk_timestamp);\n assert!(third_blk_timestamp > next_blk_timestamp);\n}\n\n// increase time by 0 seconds i.e next_block_timestamp = prev_block_timestamp\n// api.evm_increase_time(0).unwrap();\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_increase_time_by_zero() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let init_blk = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n\n let init_number = init_blk.header.number;\n let init_timestamp = init_blk.header.timestamp;\n\n let _ = api.evm_increase_time(U256::ZERO).await;\n\n api.mine_one().await;\n\n let block = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n\n let next_blk_num = block.header.number;\n let next_blk_timestamp = block.header.timestamp;\n\n assert_eq!(next_blk_num, init_number + 1);\n assert_eq!(next_blk_timestamp, init_timestamp);\n}\n\n// evm_mine(MineOptions::Timestamp(prev_block_timestamp))\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn evm_mine_blk_with_same_timestamp() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let init_blk = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n\n let init_number = init_blk.header.number;\n let init_timestamp = init_blk.header.timestamp;\n\n api.evm_mine(Some(MineOptions::Timestamp(Some(init_timestamp)))).await.unwrap();\n\n let block = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n\n let next_blk_num = block.header.number;\n let next_blk_timestamp = block.header.timestamp;\n\n assert_eq!(next_blk_num, init_number + 1);\n assert_eq!(next_blk_timestamp, init_timestamp);\n}\n\n// mine 4 blocks instantly.\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_mine_blk_with_same_timestamp() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let init_blk = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n\n let init_number = init_blk.header.number;\n let init_timestamp = init_blk.header.timestamp;\n\n // Mine 4 blocks instantly\n let _ = api.anvil_mine(Some(U256::from(4)), None).await;\n\n let latest_blk_num = api.block_number().unwrap().to::();\n\n assert_eq!(latest_blk_num, init_number + 4);\n\n let mut blk_futs = vec![];\n for i in 1..=4 {\n blk_futs.push(provider.get_block(i.into()).into_future());\n }\n\n let timestamps = futures::future::join_all(blk_futs)\n .await\n .into_iter()\n .map(|blk| blk.unwrap().unwrap().header.timestamp)\n .collect::>();\n\n // All timestamps should be equal. Allow for 1 second difference.\n assert!(timestamps.windows(2).all(|w| w[0] == w[1]), \"{timestamps:#?}\");\n assert!(\n timestamps[0] == init_timestamp || timestamps[0] == init_timestamp + 1,\n \"{timestamps:#?} != {init_timestamp}\"\n );\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_mine_first_block_with_interval() {\n let (api, _) = spawn(NodeConfig::test()).await;\n\n let init_block = api.block_by_number(0.into()).await.unwrap().unwrap();\n let init_timestamp = init_block.header.timestamp;\n\n // Mine 2 blocks with interval of 60.\n let _ = api.anvil_mine(Some(U256::from(2)), Some(U256::from(60))).await;\n\n let first_block = api.block_by_number(1.into()).await.unwrap().unwrap();\n assert_eq!(first_block.header.timestamp, init_timestamp + 60);\n\n let second_block = api.block_by_number(2.into()).await.unwrap().unwrap();\n assert_eq!(second_block.header.timestamp, init_timestamp + 120);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_anvil_reset_non_fork() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n // Get initial state\n let init_block = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n let init_accounts = api.accounts().unwrap();\n let init_balance = provider.get_balance(init_accounts[0]).await.unwrap();\n\n // Store the instance id before reset\n let instance_id_before = api.instance_id();\n\n // Mine some blocks and make transactions\n for _ in 0..5 {\n api.mine_one().await;\n }\n\n // Send a transaction\n let to = Address::random();\n let val = U256::from(1337);\n let tx = TransactionRequest::default().with_from(init_accounts[0]).with_to(to).with_value(val);\n let tx = WithOtherFields::new(tx);\n\n let _ = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n // Check state has changed\n let block_before_reset = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n assert!(block_before_reset.header.number > init_block.header.number);\n\n let balance_before_reset = provider.get_balance(init_accounts[0]).await.unwrap();\n assert!(balance_before_reset < init_balance);\n\n let to_balance_before_reset = provider.get_balance(to).await.unwrap();\n assert_eq!(to_balance_before_reset, val);\n\n // Reset to fresh in-memory state (non-fork)\n api.anvil_reset(None).await.unwrap();\n\n // Check instance id has changed\n let instance_id_after = api.instance_id();\n assert_ne!(instance_id_before, instance_id_after);\n\n // Check we're back at genesis\n let block_after_reset = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n assert_eq!(block_after_reset.header.number, 0);\n\n // Check accounts are restored to initial state\n let balance_after_reset = provider.get_balance(init_accounts[0]).await.unwrap();\n assert_eq!(balance_after_reset, init_balance);\n\n // Check the recipient's balance is zero\n let to_balance_after_reset = provider.get_balance(to).await.unwrap();\n assert_eq!(to_balance_after_reset, U256::ZERO);\n\n // Test we can continue mining after reset\n api.mine_one().await;\n let new_block = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n assert_eq!(new_block.header.number, 1);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_anvil_reset_fork_to_non_fork() {\n let (api, handle) = spawn(fork_config()).await;\n let provider = handle.http_provider();\n\n // Verify we're in fork mode\n let metadata = api.anvil_metadata().await.unwrap();\n assert!(metadata.forked_network.is_some());\n\n // Mine some blocks\n for _ in 0..3 {\n api.mine_one().await;\n }\n\n // Reset to non-fork mode\n api.anvil_reset(None).await.unwrap();\n\n // Verify we're no longer in fork mode\n let metadata_after = api.anvil_metadata().await.unwrap();\n assert!(metadata_after.forked_network.is_none());\n\n // Check we're at block 0\n let block = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n assert_eq!(block.header.number, 0);\n\n // Verify we can still mine blocks\n api.mine_one().await;\n let new_block = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n assert_eq!(new_block.header.number, 1);\n}\n" }, { "path": "crates/anvil/tests/it/api.rs", "content": "//! general eth api tests\n\nuse crate::{\n abi::{Multicall, SimpleStorage, VendingMachine},\n utils::{connect_pubsub_with_wallet, http_provider, http_provider_with_signer},\n};\nuse alloy_consensus::{\n BlobTransactionSidecar, SidecarBuilder, SignableTransaction, SimpleCoder, Transaction,\n TxEip1559,\n};\nuse alloy_network::{\n EthereumWallet, ReceiptResponse, TransactionBuilder, TransactionBuilder4844, TxSignerSync,\n};\nuse alloy_primitives::{\n Address, B256, ChainId, U256, b256, bytes,\n map::{AddressHashMap, B256HashMap, HashMap},\n};\nuse alloy_provider::Provider;\nuse alloy_rpc_types::{\n BlockId, BlockNumberOrTag, BlockTransactions, request::TransactionRequest,\n state::AccountOverride,\n};\nuse alloy_serde::WithOtherFields;\nuse alloy_sol_types::SolCall;\nuse anvil::{CHAIN_ID, EthereumHardfork, NodeConfig, eth::api::CLIENT_VERSION, spawn};\nuse foundry_test_utils::rpc;\nuse futures::join;\nuse std::time::Duration;\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_get_block_number() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n let block_num = api.block_number().unwrap();\n assert_eq!(block_num, U256::from(0));\n\n let provider = handle.http_provider();\n\n let num = provider.get_block_number().await.unwrap();\n assert_eq!(num, block_num.to::());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_dev_get_balance() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let genesis_balance = handle.genesis_balance();\n for acc in handle.genesis_accounts() {\n let balance = provider.get_balance(acc).await.unwrap();\n assert_eq!(balance, genesis_balance);\n }\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_get_price() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let gas_price = provider.get_gas_price().await.unwrap();\n assert!(gas_price > 0);\n assert_eq!(gas_price, api.gas_price());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_get_accounts() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let accounts = provider.get_accounts().await.unwrap();\n let dev_accounts: Vec<_> = handle.dev_accounts().collect();\n assert_eq!(accounts.len(), dev_accounts.len());\n for account in dev_accounts {\n assert!(accounts.contains(&account), \"Missing dev account {account}\");\n }\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_get_client_version() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let version = provider.get_client_version().await.unwrap();\n assert_eq!(CLIENT_VERSION, version);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_get_chain_id() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let chain_id = provider.get_chain_id().await.unwrap();\n assert_eq!(chain_id, CHAIN_ID);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_modify_chain_id() {\n let (_api, handle) =\n spawn(NodeConfig::test().with_chain_id(Some(ChainId::from(777_u64)))).await;\n let provider = handle.http_provider();\n\n let chain_id = provider.get_chain_id().await.unwrap();\n assert_eq!(chain_id, 777);\n\n let chain_id = provider.get_net_version().await.unwrap();\n assert_eq!(chain_id, 777);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_get_network_id() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let network_id = api.network_id().unwrap().unwrap();\n assert_eq!(network_id, CHAIN_ID.to_string());\n\n let provider_network_id = provider.get_net_version().await.unwrap();\n assert_eq!(provider_network_id, CHAIN_ID);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_get_block_by_number() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n\n let accounts: Vec<_> = handle.dev_wallets().collect();\n let signer: EthereumWallet = accounts[0].clone().into();\n let from = accounts[0].address();\n let to = accounts[1].address();\n\n let provider = http_provider_with_signer(&handle.http_endpoint(), signer);\n\n let val = handle.genesis_balance().checked_div(U256::from(2)).unwrap();\n\n // send a dummy transaction\n let tx = TransactionRequest::default().with_from(from).with_to(to).with_value(val);\n let tx = WithOtherFields::new(tx);\n\n provider.send_transaction(tx.clone()).await.unwrap().get_receipt().await.unwrap();\n\n let block = provider.get_block(BlockId::number(1)).full().await.unwrap().unwrap();\n assert_eq!(block.transactions.len(), 1);\n\n let block = provider.get_block(BlockId::hash(block.header.hash)).full().await.unwrap().unwrap();\n assert_eq!(block.transactions.len(), 1);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_get_pending_block() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n let accounts: Vec<_> = handle.dev_wallets().collect();\n let signer: EthereumWallet = accounts[0].clone().into();\n let from = accounts[0].address();\n let to = accounts[1].address();\n\n let provider = connect_pubsub_with_wallet(&handle.http_endpoint(), signer).await;\n\n let block = provider.get_block(BlockId::pending()).await.unwrap().unwrap();\n assert_eq!(block.header.number, 1);\n\n let num = provider.get_block_number().await.unwrap();\n assert_eq!(num, 0);\n\n api.anvil_set_auto_mine(false).await.unwrap();\n\n let tx = TransactionRequest::default().with_from(from).with_to(to).with_value(U256::from(100));\n\n let pending = provider.send_transaction(tx.clone()).await.unwrap().register().await.unwrap();\n\n let num = provider.get_block_number().await.unwrap();\n assert_eq!(num, 0);\n\n let block = provider.get_block(BlockId::pending()).await.unwrap().unwrap();\n assert_eq!(block.header.number, 1);\n assert_eq!(block.transactions.len(), 1);\n assert_eq!(block.transactions, BlockTransactions::Hashes(vec![*pending.tx_hash()]));\n\n let block = provider.get_block(BlockId::pending()).full().await.unwrap().unwrap();\n assert_eq!(block.header.number, 1);\n assert_eq!(block.transactions.len(), 1);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_estimate_gas_with_undersized_max_fee_per_gas() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let wallet = handle.dev_wallets().next().unwrap();\n let signer: EthereumWallet = wallet.clone().into();\n\n let provider = http_provider_with_signer(&handle.http_endpoint(), signer);\n\n api.anvil_set_auto_mine(true).await.unwrap();\n\n let init_value = \"toto\".to_string();\n\n let simple_storage_contract =\n SimpleStorage::deploy(&provider, init_value.clone()).await.unwrap();\n\n let undersized_max_fee_per_gas = 1;\n\n let latest_block = api.block_by_number(BlockNumberOrTag::Latest).await.unwrap().unwrap();\n let latest_block_base_fee_per_gas = latest_block.header.base_fee_per_gas.unwrap();\n\n assert!(undersized_max_fee_per_gas < latest_block_base_fee_per_gas);\n\n let estimated_gas = simple_storage_contract\n .setValue(\"new_value\".to_string())\n .max_fee_per_gas(undersized_max_fee_per_gas.into())\n .from(wallet.address())\n .estimate_gas()\n .await\n .unwrap();\n\n assert!(estimated_gas > 0);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_call_on_pending_block() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n let wallet = handle.dev_wallets().next().unwrap();\n let signer: EthereumWallet = wallet.clone().into();\n let sender = wallet.address();\n\n let provider = http_provider_with_signer(&handle.http_endpoint(), signer);\n\n let num = provider.get_block_number().await.unwrap();\n assert_eq!(num, 0);\n\n api.anvil_set_auto_mine(false).await.unwrap();\n\n let _contract_pending = Multicall::deploy_builder(&provider)\n .from(wallet.address())\n .send()\n .await\n .unwrap()\n .register()\n .await\n .unwrap();\n let contract_address = sender.create(0);\n let contract = Multicall::new(contract_address, &provider);\n\n let num = provider.get_block_number().await.unwrap();\n assert_eq!(num, 0);\n\n // Ensure that we can get the block_number from the pending contract\n let Multicall::aggregateReturn { blockNumber: ret_block_number, .. } =\n contract.aggregate(vec![]).block(BlockId::pending()).call().await.unwrap();\n assert_eq!(ret_block_number, U256::from(1));\n\n let accounts: Vec
= handle.dev_wallets().map(|w| w.address()).collect();\n\n for i in 1..10 {\n api.anvil_set_coinbase(accounts[i % accounts.len()]).await.unwrap();\n api.evm_set_block_gas_limit(U256::from(30_000_000 + i)).unwrap();\n\n api.anvil_mine(Some(U256::from(1)), None).await.unwrap();\n tokio::time::sleep(Duration::from_millis(100)).await;\n }\n\n // Ensure that the right header values are set when calling a past block\n for anvil_block_number in 1..(api.block_number().unwrap().to::() + 1) {\n let block_number = BlockNumberOrTag::Number(anvil_block_number as u64);\n let block = api.block_by_number(block_number).await.unwrap().unwrap();\n\n let ret_timestamp = contract\n .getCurrentBlockTimestamp()\n .block(BlockId::number(anvil_block_number as u64))\n .call()\n .await\n .unwrap();\n assert_eq!(block.header.timestamp, ret_timestamp.to::());\n\n let ret_gas_limit = contract\n .getCurrentBlockGasLimit()\n .block(BlockId::number(anvil_block_number as u64))\n .call()\n .await\n .unwrap();\n assert_eq!(block.header.gas_limit, ret_gas_limit.to::());\n\n let ret_coinbase = contract\n .getCurrentBlockCoinbase()\n .block(BlockId::number(anvil_block_number as u64))\n .call()\n .await\n .unwrap();\n assert_eq!(block.header.beneficiary, ret_coinbase);\n }\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_call_with_undersized_max_fee_per_gas() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let wallet = handle.dev_wallets().next().unwrap();\n let signer: EthereumWallet = wallet.clone().into();\n\n let provider = http_provider_with_signer(&handle.http_endpoint(), signer);\n\n api.anvil_set_auto_mine(true).await.unwrap();\n\n let init_value = \"toto\".to_string();\n\n let simple_storage_contract =\n SimpleStorage::deploy(&provider, init_value.clone()).await.unwrap();\n\n let latest_block = api.block_by_number(BlockNumberOrTag::Latest).await.unwrap().unwrap();\n let latest_block_base_fee_per_gas = latest_block.header.base_fee_per_gas.unwrap();\n let undersized_max_fee_per_gas = 1;\n\n assert!(undersized_max_fee_per_gas < latest_block_base_fee_per_gas);\n\n let last_sender = simple_storage_contract\n .lastSender()\n .max_fee_per_gas(undersized_max_fee_per_gas.into())\n .from(wallet.address())\n .call()\n .await\n .unwrap();\n assert_eq!(last_sender, Address::ZERO);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_call_with_state_override() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let wallet = handle.dev_wallets().next().unwrap();\n let signer: EthereumWallet = wallet.clone().into();\n let account = wallet.address();\n\n let provider = http_provider_with_signer(&handle.http_endpoint(), signer);\n\n api.anvil_set_auto_mine(true).await.unwrap();\n\n let multicall_contract = Multicall::deploy(&provider).await.unwrap();\n\n let init_value = \"toto\".to_string();\n\n let simple_storage_contract =\n SimpleStorage::deploy(&provider, init_value.clone()).await.unwrap();\n\n // Test the `balance` account override\n let balance = U256::from(42u64);\n let mut overrides = AddressHashMap::default();\n overrides.insert(account, AccountOverride { balance: Some(balance), ..Default::default() });\n let result = multicall_contract.getEthBalance(account).state(overrides).call().await.unwrap();\n assert_eq!(result, balance);\n\n // Test the `state_diff` account override\n let mut state_diff = B256HashMap::default();\n state_diff.insert(B256::ZERO, account.into_word());\n let mut overrides = AddressHashMap::default();\n overrides.insert(\n *simple_storage_contract.address(),\n AccountOverride {\n // The `lastSender` is in the first storage slot\n state_diff: Some(state_diff),\n ..Default::default()\n },\n );\n\n let last_sender =\n simple_storage_contract.lastSender().state(HashMap::default()).call().await.unwrap();\n // No `sender` set without override\n assert_eq!(last_sender, Address::ZERO);\n\n let last_sender =\n simple_storage_contract.lastSender().state(overrides.clone()).call().await.unwrap();\n // `sender` *is* set with override\n assert_eq!(last_sender, account);\n\n let value = simple_storage_contract.getValue().state(overrides).call().await.unwrap();\n // `value` *is not* changed with state-diff\n assert_eq!(value, init_value);\n\n // Test the `state` account override\n let mut state = B256HashMap::default();\n state.insert(B256::ZERO, account.into_word());\n let mut overrides = AddressHashMap::default();\n overrides.insert(\n *simple_storage_contract.address(),\n AccountOverride {\n // The `lastSender` is in the first storage slot\n state: Some(state),\n ..Default::default()\n },\n );\n\n let last_sender =\n simple_storage_contract.lastSender().state(overrides.clone()).call().await.unwrap();\n // `sender` *is* set with override\n assert_eq!(last_sender, account);\n\n let value = simple_storage_contract.getValue().state(overrides).call().await.unwrap();\n // `value` *is* changed with state\n assert_eq!(value, \"\");\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_mine_while_mining() {\n let (api, _) = spawn(NodeConfig::test()).await;\n\n let total_blocks = 200;\n\n let block_number =\n api.block_by_number(BlockNumberOrTag::Latest).await.unwrap().unwrap().header.number;\n assert_eq!(block_number, 0);\n\n let block = api.block_by_number(BlockNumberOrTag::Number(block_number)).await.unwrap().unwrap();\n assert_eq!(block.header.number, 0);\n\n let result = join!(\n api.anvil_mine(Some(U256::from(total_blocks / 2)), None),\n api.anvil_mine(Some(U256::from(total_blocks / 2)), None)\n );\n result.0.unwrap();\n result.1.unwrap();\n tokio::time::sleep(Duration::from_millis(100)).await;\n\n let block_number =\n api.block_by_number(BlockNumberOrTag::Latest).await.unwrap().unwrap().header.number;\n assert_eq!(block_number, total_blocks);\n\n let block = api.block_by_number(BlockNumberOrTag::Number(block_number)).await.unwrap().unwrap();\n assert_eq!(block.header.number, total_blocks);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_send_raw_tx_sync() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Prague.into()));\n let (api, handle) = spawn(node_config).await;\n let provider = http_provider(&handle.http_endpoint());\n\n let wallets = handle.dev_wallets().collect::>();\n let eip1559_est = provider.estimate_eip1559_fees().await.unwrap();\n\n let from = wallets[0].address();\n let mut tx = TxEip1559 {\n max_fee_per_gas: eip1559_est.max_fee_per_gas,\n max_priority_fee_per_gas: eip1559_est.max_priority_fee_per_gas,\n gas_limit: 100000,\n chain_id: 31337,\n to: alloy_primitives::TxKind::Call(from),\n input: bytes!(\"11112222\"),\n ..Default::default()\n };\n let signature = wallets[1].sign_transaction_sync(&mut tx).unwrap();\n\n let tx = tx.into_signed(signature);\n let mut encoded = Vec::new();\n tx.eip2718_encode(&mut encoded);\n\n let receipt = api.send_raw_transaction_sync(encoded.into()).await.unwrap();\n assert_eq!(receipt.from(), wallets[1].address());\n assert_eq!(receipt.to(), tx.to());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_send_tx_sync() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Prague.into()));\n let (api, handle) = spawn(node_config).await;\n\n let wallets = handle.dev_wallets().collect::>();\n let logger_bytecode = bytes!(\"66365f5f37365fa05f5260076019f3\");\n\n let from = wallets[0].address();\n let tx = TransactionRequest::default()\n .with_from(from)\n .into_create()\n .with_nonce(0)\n .with_input(logger_bytecode);\n\n let receipt = api.send_transaction_sync(WithOtherFields::new(tx)).await.unwrap();\n assert_eq!(receipt.from(), wallets[0].address());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\n#[ignore = \"no debug_\"]\nasync fn can_get_code_by_hash() {\n let (api, _) =\n spawn(NodeConfig::test().with_eth_rpc_url(Some(rpc::next_http_archive_rpc_url()))).await;\n\n // The code hash for DEFAULT_CREATE2_DEPLOYER_RUNTIME_CODE\n let code_hash = b256!(\"2fa86add0aed31f33a762c9d88e807c475bd51d0f52bd0955754b2608f7e4989\");\n\n let code = api.debug_code_by_hash(code_hash, None).await.unwrap();\n assert_eq!(&code.unwrap(), foundry_evm::constants::DEFAULT_CREATE2_DEPLOYER_RUNTIME_CODE);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fill_transaction_fills_chain_id() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let wallet = handle.dev_wallets().next().unwrap();\n let from = wallet.address();\n\n let tx_req = TransactionRequest::default()\n .with_from(from)\n .with_to(Address::random())\n .with_gas_limit(21_000);\n\n let filled = api.fill_transaction(WithOtherFields::new(tx_req)).await.unwrap();\n\n // Should fill with the chain id from provider\n assert!(filled.tx.chain_id().is_some());\n assert_eq!(filled.tx.chain_id().unwrap(), CHAIN_ID);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fill_transaction_fills_nonce() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n let accounts: Vec<_> = handle.dev_wallets().collect();\n let signer: EthereumWallet = accounts[0].clone().into();\n let from = accounts[0].address();\n let to = accounts[1].address();\n\n let provider = http_provider_with_signer(&handle.http_endpoint(), signer);\n\n // Send a transaction to increment nonce\n let tx = TransactionRequest::default().with_from(from).with_to(to).with_value(U256::from(100));\n let tx = WithOtherFields::new(tx);\n provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n // Now the account should have nonce 1\n let tx_req = TransactionRequest::default()\n .with_from(from)\n .with_to(to)\n .with_value(U256::from(1000))\n .with_gas_limit(21_000);\n\n let filled = api.fill_transaction(WithOtherFields::new(tx_req)).await.unwrap();\n\n assert_eq!(filled.tx.nonce(), 1);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fill_transaction_preserves_provided_fields() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let wallet = handle.dev_wallets().next().unwrap();\n let from = wallet.address();\n\n let provided_nonce = 100u64;\n let provided_gas_limit = 50_000u64;\n\n let tx_req = TransactionRequest::default()\n .with_from(from)\n .with_to(Address::random())\n .with_value(U256::from(1000))\n .with_nonce(provided_nonce)\n .with_gas_limit(provided_gas_limit);\n\n let filled = api.fill_transaction(WithOtherFields::new(tx_req)).await.unwrap();\n\n // Should preserve the provided nonce and gas limit\n assert_eq!(filled.tx.nonce(), provided_nonce);\n assert_eq!(filled.tx.gas_limit(), provided_gas_limit);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fill_transaction_fills_all_missing_fields() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let wallet = handle.dev_wallets().next().unwrap();\n let from = wallet.address();\n\n // Create a simple transfer transaction with minimal fields\n let tx_req = TransactionRequest::default().with_from(from).with_to(Address::random());\n\n let filled = api.fill_transaction(WithOtherFields::new(tx_req)).await.unwrap();\n\n // Should fill all required fields and be EIP-1559\n assert!(filled.tx.is_eip1559());\n assert!(filled.tx.gas_limit() > 0);\n assert!(filled.tx.max_fee_per_gas() > 0);\n assert!(filled.tx.max_priority_fee_per_gas().is_some());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fill_transaction_eip4844_blob_fee() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Cancun.into()));\n let (api, handle) = spawn(node_config).await;\n let wallet = handle.dev_wallets().next().unwrap();\n let from = wallet.address();\n\n let mut builder = SidecarBuilder::::new();\n builder.ingest(b\"dummy blob\");\n let sidecar: BlobTransactionSidecar = builder.build().unwrap();\n\n // EIP-4844 blob transaction with sidecar but no blob fee\n let mut tx_req = TransactionRequest::default().with_from(from).with_to(Address::random());\n tx_req.sidecar = Some(sidecar.into());\n tx_req.transaction_type = Some(3); // EIP-4844\n\n let filled = api.fill_transaction(WithOtherFields::new(tx_req)).await.unwrap();\n\n // Blob transaction should have max_fee_per_blob_gas filled\n assert!(\n filled.tx.max_fee_per_blob_gas().is_some(),\n \"max_fee_per_blob_gas should be filled for blob tx\"\n );\n assert!(filled.tx.blob_versioned_hashes().is_some(), \"blob_versioned_hashes should be present\");\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fill_transaction_eip4844_preserves_blob_fee() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Cancun.into()));\n let (api, handle) = spawn(node_config).await;\n let wallet = handle.dev_wallets().next().unwrap();\n let from = wallet.address();\n\n let provided_blob_fee = 5_000_000u128;\n\n let mut builder = SidecarBuilder::::new();\n builder.ingest(b\"dummy blob\");\n let sidecar: BlobTransactionSidecar = builder.build().unwrap();\n\n // EIP-4844 blob transaction with blob fee already set\n let mut tx_req = TransactionRequest::default()\n .with_from(from)\n .with_to(Address::random())\n .with_max_fee_per_blob_gas(provided_blob_fee);\n tx_req.sidecar = Some(sidecar.into());\n tx_req.transaction_type = Some(3); // EIP-4844\n\n let filled = api.fill_transaction(WithOtherFields::new(tx_req)).await.unwrap();\n\n // Should preserve the provided blob fee\n assert_eq!(\n filled.tx.max_fee_per_blob_gas(),\n Some(provided_blob_fee),\n \"should preserve provided max_fee_per_blob_gas\"\n );\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fill_transaction_non_blob_tx_no_blob_fee() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let wallet = handle.dev_wallets().next().unwrap();\n let from = wallet.address();\n\n // EIP-1559 transaction without blob fields\n let mut tx_req = TransactionRequest::default().with_from(from).with_to(Address::random());\n tx_req.transaction_type = Some(2); // EIP-1559\n\n let filled = api.fill_transaction(WithOtherFields::new(tx_req)).await.unwrap();\n\n // Non-blob transaction should NOT have blob fee filled\n assert!(\n filled.tx.max_fee_per_blob_gas().is_none(),\n \"max_fee_per_blob_gas should not be set for non-blob tx\"\n );\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fill_transaction_reverts_on_gas_estimation_failure() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n let accounts: Vec<_> = handle.dev_wallets().collect();\n let signer: EthereumWallet = accounts[0].clone().into();\n let from = accounts[0].address();\n\n let provider = http_provider_with_signer(&handle.http_endpoint(), signer);\n\n // Deploy VendingMachine contract\n let contract = VendingMachine::deploy(&provider).await.unwrap();\n let contract_address = *contract.address();\n\n // Call buy function with insufficient ether\n let tx_req = TransactionRequest::default()\n .with_from(from)\n .with_to(contract_address)\n .with_input(VendingMachine::buyCall { amount: U256::from(10) }.abi_encode());\n\n // fill_transaction should fail because gas estimation fails due to revert\n let result = api.fill_transaction(WithOtherFields::new(tx_req)).await;\n\n assert!(result.is_err(), \"fill_transaction should return an error when gas estimation fails\");\n let error_message = result.unwrap_err().to_string();\n assert!(\n error_message.contains(\"execution reverted\"),\n \"Error should indicate a revert, got: {error_message}\"\n );\n}\n" }, { "path": "crates/anvil/tests/it/beacon_api.rs", "content": "use crate::utils::http_provider;\nuse alloy_consensus::{Blob, BlobTransactionSidecar, SidecarBuilder, SimpleCoder, Transaction};\nuse alloy_network::{TransactionBuilder, TransactionBuilder4844};\nuse alloy_primitives::{B256, FixedBytes, U256, b256};\nuse alloy_provider::Provider;\nuse alloy_rpc_types::TransactionRequest;\nuse alloy_rpc_types_beacon::{genesis::GenesisResponse, sidecar::GetBlobsResponse};\nuse alloy_serde::WithOtherFields;\nuse anvil::{NodeConfig, spawn};\nuse foundry_evm::hardfork::EthereumHardfork;\nuse ssz::Decode;\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_beacon_api_get_blob_sidecars() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Cancun.into()));\n let (_api, handle) = spawn(node_config).await;\n\n // Test Beacon API endpoint using HTTP client\n let client = reqwest::Client::new();\n let url = format!(\"{}/eth/v1/beacon/blob_sidecars/latest\", handle.http_endpoint());\n\n // This endpoint is deprecated, so we expect a 410 Gone response\n let response = client.get(&url).send().await.unwrap();\n assert_eq!(\n response.text().await.unwrap(),\n r#\"{\"code\":410,\"message\":\"This endpoint is deprecated. Use `GET /eth/v1/beacon/blobs/{block_id}` instead.\"}\"#,\n \"Expected deprecation message for blob_sidecars endpoint\"\n );\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_beacon_api_get_blobs() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Cancun.into()));\n let (api, handle) = spawn(node_config).await;\n\n // Disable auto-mining so we can include multiple transactions in the same block\n api.anvil_set_auto_mine(false).await.unwrap();\n\n let wallets = handle.dev_wallets().collect::>();\n let from = wallets[0].address();\n let to = wallets[1].address();\n\n let provider = http_provider(&handle.http_endpoint());\n\n let eip1559_est = provider.estimate_eip1559_fees().await.unwrap();\n let gas_price = provider.get_gas_price().await.unwrap();\n\n // Create multiple blob transactions to be included in the same block\n let blob_data =\n [b\"Hello Beacon API - Blob 1\", b\"Hello Beacon API - Blob 2\", b\"Hello Beacon API - Blob 3\"];\n\n let mut pending_txs = Vec::new();\n\n // Send all transactions without waiting for receipts\n for (i, data) in blob_data.iter().enumerate() {\n let sidecar: SidecarBuilder = SidecarBuilder::from_slice(data.as_slice());\n let sidecar = sidecar.build::().unwrap();\n\n let tx = TransactionRequest::default()\n .with_from(from)\n .with_to(to)\n .with_nonce(i as u64)\n .with_max_fee_per_blob_gas(gas_price + 1)\n .with_max_fee_per_gas(eip1559_est.max_fee_per_gas)\n .with_max_priority_fee_per_gas(eip1559_est.max_priority_fee_per_gas)\n .with_blob_sidecar_4844(sidecar)\n .value(U256::from(100));\n\n let tx = WithOtherFields::new(tx);\n\n let pending = provider.send_transaction(tx).await.unwrap();\n pending_txs.push(pending);\n }\n\n // Mine a block to include all transactions\n api.evm_mine(None).await.unwrap();\n\n // Get receipts for all transactions\n let mut receipts = Vec::new();\n for pending in pending_txs {\n let receipt = pending.get_receipt().await.unwrap();\n receipts.push(receipt);\n }\n\n // Verify all transactions were included in the same block\n let block_number = receipts[0].block_number.unwrap();\n for (i, receipt) in receipts.iter().enumerate() {\n assert_eq!(\n receipt.block_number.unwrap(),\n block_number,\n \"Transaction {i} was not included in block {block_number}\"\n );\n }\n\n // Extract the actual versioned hashes from the mined transactions\n let mut actual_versioned_hashes = Vec::new();\n for receipt in &receipts {\n let tx = provider.get_transaction_by_hash(receipt.transaction_hash).await.unwrap().unwrap();\n if let Some(blob_versioned_hashes) = tx.blob_versioned_hashes() {\n actual_versioned_hashes.extend(blob_versioned_hashes.iter().copied());\n }\n }\n\n // Test Beacon API endpoint using HTTP client\n let client = reqwest::Client::new();\n let url = format!(\"{}/eth/v1/beacon/blobs/{}\", handle.http_endpoint(), block_number);\n\n let response = client.get(&url).send().await.unwrap();\n assert_eq!(response.status(), reqwest::StatusCode::OK);\n assert_eq!(\n response.headers().get(\"content-type\").and_then(|h| h.to_str().ok()),\n Some(\"application/json\"),\n \"Expected application/json content-type header\"\n );\n\n let blobs_response: GetBlobsResponse = response.json().await.unwrap();\n // Verify response structure\n assert!(!blobs_response.execution_optimistic);\n assert!(!blobs_response.finalized);\n\n // Verify we have blob data from all transactions\n assert_eq!(blobs_response.data.len(), 3, \"Expected 3 blobs from 3 transactions\");\n\n // Test response with SSZ encoding\n let url = format!(\"{}/eth/v1/beacon/blobs/{}\", handle.http_endpoint(), block_number);\n let response = client\n .get(&url)\n .header(axum::http::header::ACCEPT, \"application/octet-stream\")\n .send()\n .await\n .unwrap();\n assert_eq!(response.status(), reqwest::StatusCode::OK);\n assert_eq!(\n response.headers().get(\"content-type\").and_then(|h| h.to_str().ok()),\n Some(\"application/octet-stream\"),\n \"Expected application/octet-stream content-type header\"\n );\n\n let body_bytes = response.bytes().await.unwrap();\n\n // Decode the SSZ-encoded blobs in a spawned thread with larger stack to handle recursion\n let decoded_blobs = std::thread::Builder::new()\n .stack_size(8 * 1024 * 1024) // 8MB stack for SSZ decoding of large blobs\n .spawn(move || Vec::::from_ssz_bytes(&body_bytes))\n .expect(\"Failed to spawn decode thread\")\n .join()\n .expect(\"Decode thread panicked\")\n .expect(\"Failed to decode SSZ-encoded blobs\");\n\n // Verify we got exactly 3 blobs\n assert_eq!(\n decoded_blobs.len(),\n 3,\n \"Expected 3 blobs from SSZ-encoded response, got {}\",\n decoded_blobs.len()\n );\n\n // Verify the decoded blobs match the JSON response blobs\n for (i, (decoded, json)) in decoded_blobs.iter().zip(blobs_response.data.iter()).enumerate() {\n assert_eq!(decoded, json, \"Blob {i} mismatch between SSZ and JSON responses\");\n }\n\n // Test filtering with versioned_hashes query parameter - single hash\n let url = format!(\n \"{}/eth/v1/beacon/blobs/{}?versioned_hashes={}\",\n handle.http_endpoint(),\n block_number,\n actual_versioned_hashes[1]\n );\n let response = client.get(&url).send().await.unwrap();\n let status = response.status();\n if status != reqwest::StatusCode::OK {\n let error_body = response.text().await.unwrap();\n panic!(\"Expected OK status, got {status}: {error_body}\");\n }\n let blobs_response: GetBlobsResponse = response.json().await.unwrap();\n assert_eq!(\n blobs_response.data.len(),\n 1,\n \"Expected 1 blob when filtering by single versioned_hash\"\n );\n\n // Test filtering with versioned_hashes query parameter - multiple versioned_hashes\n // (comma-separated)\n let url = format!(\n \"{}/eth/v1/beacon/blobs/{}?versioned_hashes={},{}\",\n handle.http_endpoint(),\n block_number,\n actual_versioned_hashes[0],\n actual_versioned_hashes[2]\n );\n let response = client.get(&url).send().await.unwrap();\n assert_eq!(response.status(), reqwest::StatusCode::OK);\n let blobs_response: GetBlobsResponse = response.json().await.unwrap();\n assert_eq!(\n blobs_response.data.len(),\n 2,\n \"Expected 2 blobs when filtering by two versioned_hashes\"\n );\n\n // Test filtering with non-existent versioned_hash\n let non_existent_hash =\n b256!(\"0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef\");\n let url = format!(\n \"{}/eth/v1/beacon/blobs/{}?versioned_hashes={}\",\n handle.http_endpoint(),\n block_number,\n non_existent_hash\n );\n let response = client.get(&url).send().await.unwrap();\n assert_eq!(response.status(), reqwest::StatusCode::OK);\n let blobs_response: GetBlobsResponse = response.json().await.unwrap();\n assert_eq!(\n blobs_response.data.len(),\n 0,\n \"Expected 0 blobs when filtering by non-existent versioned_hash\"\n );\n\n // Test with special block identifiers\n let test_ids = vec![\"latest\", \"finalized\", \"safe\", \"earliest\"];\n for block_id in test_ids {\n let url = format!(\"{}/eth/v1/beacon/blobs/{}\", handle.http_endpoint(), block_id);\n assert_eq!(client.get(&url).send().await.unwrap().status(), reqwest::StatusCode::OK);\n }\n let url = format!(\"{}/eth/v1/beacon/blobs/pending\", handle.http_endpoint());\n assert_eq!(client.get(&url).send().await.unwrap().status(), reqwest::StatusCode::NOT_FOUND);\n\n // Test with hex block number\n let url = format!(\"{}/eth/v1/beacon/blobs/0x{block_number:x}\", handle.http_endpoint());\n let response = client.get(&url).send().await.unwrap();\n assert_eq!(response.status(), reqwest::StatusCode::OK);\n\n // Test with non-existent block\n let url = format!(\"{}/eth/v1/beacon/blobs/999999\", handle.http_endpoint());\n let response = client.get(&url).send().await.unwrap();\n assert_eq!(response.status(), reqwest::StatusCode::NOT_FOUND);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_beacon_api_get_genesis() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Cancun.into()));\n let (_api, handle) = spawn(node_config).await;\n\n // Test Beacon API genesis endpoint using HTTP client\n let client = reqwest::Client::new();\n let url = format!(\"{}/eth/v1/beacon/genesis\", handle.http_endpoint());\n\n let response = client.get(&url).send().await.unwrap();\n assert_eq!(response.status(), reqwest::StatusCode::OK);\n\n let genesis_response: GenesisResponse = response.json().await.unwrap();\n\n assert!(genesis_response.data.genesis_time > 0);\n assert_eq!(genesis_response.data.genesis_validators_root, B256::ZERO);\n assert_eq!(\n genesis_response.data.genesis_fork_version,\n FixedBytes::from([0x00, 0x00, 0x00, 0x00])\n );\n}\n" }, { "path": "crates/anvil/tests/it/eip2935.rs", "content": "use crate::utils::http_provider;\nuse alloy_eips::{BlockNumberOrTag, eip2935::HISTORY_STORAGE_ADDRESS};\nuse alloy_network::TransactionBuilder;\nuse alloy_primitives::U256;\nuse alloy_provider::Provider;\nuse alloy_rpc_types::TransactionRequest;\nuse anvil::{NodeConfig, spawn};\nuse foundry_evm::hardfork::EthereumHardfork;\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn eip2935_contract_deployed_at_genesis() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Prague.into()));\n let (_api, handle) = spawn(node_config).await;\n let provider = http_provider(&handle.http_endpoint());\n\n let code = provider.get_code_at(HISTORY_STORAGE_ADDRESS).await.unwrap();\n assert!(!code.is_empty(), \"EIP-2935 history storage contract should be deployed at genesis\");\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn eip2935_stores_parent_block_hash() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Prague.into()));\n let (api, handle) = spawn(node_config).await;\n let provider = http_provider(&handle.http_endpoint());\n\n // Mine a few blocks so there are parent hashes to store\n api.mine_one().await;\n api.mine_one().await;\n api.mine_one().await;\n\n // Block 1's hash should be stored when block 2 was mined\n let block1 = provider\n .get_block_by_number(BlockNumberOrTag::from(1))\n .await\n .unwrap()\n .expect(\"block 1 should exist\");\n let block1_hash = block1.header.hash;\n\n // Query the history storage contract for block 1's hash.\n // The EIP-2935 contract uses raw calldata (not ABI-encoded): pass the block number\n // as a 32-byte big-endian word directly.\n let call_data: [u8; 32] = U256::from(1).to_be_bytes();\n let tx = TransactionRequest::default().with_to(HISTORY_STORAGE_ADDRESS).with_input(call_data);\n let result = provider.call(tx.into()).await.unwrap();\n\n let stored_hash = alloy_primitives::B256::from_slice(&result);\n assert_eq!(stored_hash, block1_hash, \"EIP-2935 contract should store parent block hash\");\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn eip2935_no_system_call_on_genesis() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Prague.into()));\n let (_api, handle) = spawn(node_config).await;\n let provider = http_provider(&handle.http_endpoint());\n\n // At genesis (block 0), the contract should exist but no system call should have\n // written any parent hash into its storage. Check raw storage slot 0 directly.\n let slot = provider.get_storage_at(HISTORY_STORAGE_ADDRESS, U256::from(0)).await.unwrap();\n assert_eq!(slot, U256::ZERO, \"No hash should be stored in the contract at genesis\");\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn eip2935_not_deployed_before_prague() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Cancun.into()));\n let (_api, handle) = spawn(node_config).await;\n let provider = http_provider(&handle.http_endpoint());\n\n let code = provider.get_code_at(HISTORY_STORAGE_ADDRESS).await.unwrap();\n assert!(code.is_empty(), \"EIP-2935 contract should NOT be deployed before Prague\");\n}\n" }, { "path": "crates/anvil/tests/it/eip4844.rs", "content": "use crate::utils::{http_provider, http_provider_with_signer};\nuse alloy_consensus::{BlobTransactionSidecar, SidecarBuilder, SimpleCoder, Transaction};\nuse alloy_eips::{\n Typed2718,\n eip4844::{BLOB_TX_MIN_BLOB_GASPRICE, DATA_GAS_PER_BLOB, MAX_DATA_GAS_PER_BLOCK_DENCUN},\n};\nuse alloy_network::{EthereumWallet, ReceiptResponse, TransactionBuilder, TransactionBuilder4844};\nuse alloy_primitives::{Address, U256, b256};\nuse alloy_provider::{Provider, ProviderBuilder};\nuse alloy_rpc_types::{BlockId, TransactionRequest};\nuse alloy_serde::WithOtherFields;\nuse anvil::{NodeConfig, spawn};\nuse foundry_evm::hardfork::EthereumHardfork;\nuse foundry_test_utils::rpc;\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_send_eip4844_transaction() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Cancun.into()));\n let (_api, handle) = spawn(node_config).await;\n\n let wallets = handle.dev_wallets().collect::>();\n let from = wallets[0].address();\n let to = wallets[1].address();\n let provider = http_provider(&handle.http_endpoint());\n\n let eip1559_est = provider.estimate_eip1559_fees().await.unwrap();\n let gas_price = provider.get_gas_price().await.unwrap();\n\n let sidecar: SidecarBuilder = SidecarBuilder::from_slice(b\"Hello World\");\n\n let sidecar = sidecar.build().unwrap();\n let tx = TransactionRequest::default()\n .with_from(from)\n .with_to(to)\n .with_nonce(0)\n .with_max_fee_per_blob_gas(gas_price + 1)\n .with_max_fee_per_gas(eip1559_est.max_fee_per_gas)\n .with_max_priority_fee_per_gas(eip1559_est.max_priority_fee_per_gas)\n .with_blob_sidecar_4844(sidecar)\n .value(U256::from(5));\n\n let tx = WithOtherFields::new(tx);\n\n let receipt = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n assert_eq!(receipt.blob_gas_used, Some(131072));\n assert_eq!(receipt.blob_gas_price, Some(0x1)); // 1 wei\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_send_eip4844_transaction_fork() {\n let node_config = NodeConfig::test()\n .with_eth_rpc_url(Some(rpc::next_http_archive_rpc_url()))\n .with_fork_block_number(Some(23432306u64))\n .with_hardfork(Some(EthereumHardfork::Cancun.into()));\n let (api, handle) = spawn(node_config).await;\n let provider = handle.http_provider();\n let accounts = provider.get_accounts().await.unwrap();\n let alice = accounts[0];\n let bob = accounts[1];\n\n let sidecar: SidecarBuilder = SidecarBuilder::from_slice(b\"Blobs are fun!\");\n let sidecar: BlobTransactionSidecar = sidecar.build().unwrap();\n\n let tx = TransactionRequest::default()\n .with_from(alice)\n .with_to(bob)\n .with_blob_sidecar_4844(sidecar.clone());\n\n let pending_tx = provider.send_transaction(tx.into()).await.unwrap();\n let receipt = pending_tx.get_receipt().await.unwrap();\n let tx_hash = receipt.transaction_hash;\n\n let _blobs = api.anvil_get_blob_by_tx_hash(tx_hash).unwrap().unwrap();\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_send_eip4844_transaction_eth_send_transaction() {\n let node_config = NodeConfig::test()\n .with_eth_rpc_url(Some(rpc::next_http_archive_rpc_url()))\n .with_fork_block_number(Some(23552208u64))\n .with_hardfork(Some(EthereumHardfork::Cancun.into()));\n let (api, handle) = spawn(node_config).await;\n let provider = ProviderBuilder::new().connect(handle.http_endpoint().as_str()).await.unwrap();\n let accounts = provider.get_accounts().await.unwrap();\n let alice = accounts[0];\n let bob = accounts[1];\n\n let sidecar: SidecarBuilder = SidecarBuilder::from_slice(b\"Blobs are fun!\");\n let sidecar: BlobTransactionSidecar = sidecar.build().unwrap();\n\n let tx = TransactionRequest::default()\n .with_from(alice)\n .with_to(bob)\n .with_blob_sidecar_4844(sidecar.clone());\n\n let pending_tx = provider.send_transaction(tx).await.unwrap();\n let receipt = pending_tx.get_receipt().await.unwrap();\n let tx_hash = receipt.transaction_hash;\n\n let _blobs = api.anvil_get_blob_by_tx_hash(tx_hash).unwrap().unwrap();\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_send_eip4844_transaction_with_eip7594_sidecar_format() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Osaka.into()));\n let (api, handle) = spawn(node_config).await;\n let provider = ProviderBuilder::new().connect(handle.http_endpoint().as_str()).await.unwrap();\n let accounts = provider.get_accounts().await.unwrap();\n let alice = accounts[0];\n let bob = accounts[1];\n\n let sidecar: SidecarBuilder = SidecarBuilder::from_slice(b\"Blobs are fun!\");\n let sidecar = sidecar.build_7594().unwrap();\n\n let tx =\n TransactionRequest::default().with_from(alice).with_to(bob).with_blob_sidecar_7594(sidecar);\n\n let pending_tx = provider.send_transaction(tx).await.unwrap();\n let receipt = pending_tx.get_receipt().await.unwrap();\n let tx_hash = receipt.transaction_hash;\n\n let _blobs = api.anvil_get_blob_by_tx_hash(tx_hash).unwrap().unwrap();\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_send_multiple_blobs_in_one_tx() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Cancun.into()));\n let (_api, handle) = spawn(node_config).await;\n\n let wallets = handle.dev_wallets().collect::>();\n\n let from = wallets[0].address();\n let to = wallets[1].address();\n\n let provider = http_provider(&handle.http_endpoint());\n\n let eip1559_est = provider.estimate_eip1559_fees().await.unwrap();\n let gas_price = provider.get_gas_price().await.unwrap();\n\n let large_data = vec![1u8; DATA_GAS_PER_BLOB as usize * 5]; // 131072 is DATA_GAS_PER_BLOB and also BYTE_PER_BLOB\n let sidecar: SidecarBuilder = SidecarBuilder::from_slice(&large_data);\n\n let sidecar = sidecar.build().unwrap();\n\n let tx = TransactionRequest::default()\n .with_from(from)\n .with_to(to)\n .with_nonce(0)\n .with_max_fee_per_blob_gas(gas_price + 1)\n .with_max_fee_per_gas(eip1559_est.max_fee_per_gas)\n .with_max_priority_fee_per_gas(eip1559_est.max_priority_fee_per_gas)\n .with_blob_sidecar_4844(sidecar);\n let tx = WithOtherFields::new(tx);\n\n let receipt = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n assert_eq!(receipt.blob_gas_used, Some(MAX_DATA_GAS_PER_BLOCK_DENCUN));\n assert_eq!(receipt.blob_gas_price, Some(0x1)); // 1 wei\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn cannot_exceed_six_blobs() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Cancun.into()));\n let (_api, handle) = spawn(node_config).await;\n\n let wallets = handle.dev_wallets().collect::>();\n\n let from = wallets[0].address();\n let to = wallets[1].address();\n\n let provider = http_provider(&handle.http_endpoint());\n\n let eip1559_est = provider.estimate_eip1559_fees().await.unwrap();\n let gas_price = provider.get_gas_price().await.unwrap();\n\n let large_data = vec![1u8; DATA_GAS_PER_BLOB as usize * 6]; // 131072 is DATA_GAS_PER_BLOB and also BYTE_PER_BLOB\n let sidecar: SidecarBuilder = SidecarBuilder::from_slice(&large_data);\n\n let sidecar = sidecar.build().unwrap();\n\n let tx = TransactionRequest::default()\n .with_from(from)\n .with_to(to)\n .with_nonce(0)\n .with_max_fee_per_blob_gas(gas_price + 1)\n .with_max_fee_per_gas(eip1559_est.max_fee_per_gas)\n .with_max_priority_fee_per_gas(eip1559_est.max_priority_fee_per_gas)\n .with_blob_sidecar_4844(sidecar);\n let tx = WithOtherFields::new(tx);\n\n let err = provider.send_transaction(tx).await.unwrap_err();\n\n assert!(err.to_string().contains(\"too many blobs\"));\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_mine_blobs_when_exceeds_max_blobs() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Cancun.into()));\n let (api, handle) = spawn(node_config).await;\n api.anvil_set_auto_mine(false).await.unwrap();\n\n let wallets = handle.dev_wallets().collect::>();\n\n let from = wallets[0].address();\n let to = wallets[1].address();\n\n let provider = http_provider(&handle.http_endpoint());\n\n let eip1559_est = provider.estimate_eip1559_fees().await.unwrap();\n let gas_price = provider.get_gas_price().await.unwrap();\n\n let first_batch = vec![1u8; DATA_GAS_PER_BLOB as usize * 3];\n let sidecar: SidecarBuilder = SidecarBuilder::from_slice(&first_batch);\n\n let num_blobs_first = sidecar.clone().take().len() as u64;\n\n let sidecar = sidecar.build().unwrap();\n\n let tx = TransactionRequest::default()\n .with_from(from)\n .with_to(to)\n .with_nonce(0)\n .with_max_fee_per_blob_gas(gas_price + 1)\n .with_max_fee_per_gas(eip1559_est.max_fee_per_gas)\n .with_max_priority_fee_per_gas(eip1559_est.max_priority_fee_per_gas)\n .with_blob_sidecar_4844(sidecar);\n let mut tx = WithOtherFields::new(tx);\n\n let first_tx = provider.send_transaction(tx.clone()).await.unwrap();\n\n let second_batch = vec![1u8; DATA_GAS_PER_BLOB as usize * 2];\n\n let sidecar: SidecarBuilder = SidecarBuilder::from_slice(&second_batch);\n\n let num_blobs_second = sidecar.clone().take().len() as u64;\n\n let sidecar = sidecar.build().unwrap();\n tx.set_blob_sidecar_4844(sidecar);\n tx.set_nonce(1);\n let second_tx = provider.send_transaction(tx).await.unwrap();\n\n api.mine_one().await;\n\n let first_receipt = first_tx.get_receipt().await.unwrap();\n\n api.mine_one().await;\n let second_receipt = second_tx.get_receipt().await.unwrap();\n\n let (first_block, second_block) = tokio::join!(\n provider.get_block_by_number(first_receipt.block_number.unwrap().into()),\n provider.get_block_by_number(second_receipt.block_number.unwrap().into())\n );\n assert_eq!(\n first_block.unwrap().unwrap().header.blob_gas_used,\n Some(DATA_GAS_PER_BLOB * num_blobs_first)\n );\n\n assert_eq!(\n second_block.unwrap().unwrap().header.blob_gas_used,\n Some(DATA_GAS_PER_BLOB * num_blobs_second)\n );\n // Mined in two different blocks\n assert_eq!(first_receipt.block_number.unwrap() + 1, second_receipt.block_number.unwrap());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_check_blob_fields_on_genesis() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Cancun.into()));\n let (_api, handle) = spawn(node_config).await;\n\n let provider = http_provider(&handle.http_endpoint());\n\n let block = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n\n assert_eq!(block.header.blob_gas_used, Some(0));\n assert_eq!(block.header.excess_blob_gas, Some(0));\n}\n\n#[expect(clippy::disallowed_macros)]\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_correctly_estimate_blob_gas_with_recommended_fillers() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Cancun.into()));\n let (_api, handle) = spawn(node_config).await;\n\n let provider = http_provider(&handle.http_endpoint());\n\n let accounts = provider.get_accounts().await.unwrap();\n let alice = accounts[0];\n let bob = accounts[1];\n\n let sidecar: SidecarBuilder = SidecarBuilder::from_slice(b\"Blobs are fun!\");\n let sidecar = sidecar.build().unwrap();\n\n let tx = TransactionRequest::default().with_to(bob).with_blob_sidecar_4844(sidecar);\n let tx = WithOtherFields::new(tx);\n\n // Send the transaction and wait for the broadcast.\n let pending_tx = provider.send_transaction(tx).await.unwrap();\n\n println!(\"Pending transaction... {}\", pending_tx.tx_hash());\n\n // Wait for the transaction to be included and get the receipt.\n let receipt = pending_tx.get_receipt().await.unwrap();\n\n // Grab the processed transaction.\n let tx = provider.get_transaction_by_hash(receipt.transaction_hash).await.unwrap().unwrap();\n\n println!(\n \"Transaction included in block {}\",\n receipt.block_number.expect(\"Failed to get block number\")\n );\n\n assert!(tx.max_fee_per_blob_gas().unwrap() >= BLOB_TX_MIN_BLOB_GASPRICE);\n assert_eq!(receipt.from, alice);\n assert_eq!(receipt.to, Some(bob));\n assert_eq!(\n receipt.blob_gas_used.expect(\"Expected to be EIP-4844 transaction\"),\n DATA_GAS_PER_BLOB\n );\n}\n\n#[expect(clippy::disallowed_macros)]\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_correctly_estimate_blob_gas_with_recommended_fillers_with_signer() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Cancun.into()));\n let (_api, handle) = spawn(node_config).await;\n\n let signer = handle.dev_wallets().next().unwrap();\n let wallet: EthereumWallet = signer.clone().into();\n\n let provider = http_provider_with_signer(&handle.http_endpoint(), wallet);\n\n let accounts = provider.get_accounts().await.unwrap();\n let alice = accounts[0];\n let bob = accounts[1];\n\n let sidecar: SidecarBuilder = SidecarBuilder::from_slice(b\"Blobs are fun!\");\n let sidecar = sidecar.build().unwrap();\n\n let tx = TransactionRequest::default().with_to(bob).with_blob_sidecar_4844(sidecar);\n let tx = WithOtherFields::new(tx);\n\n // Send the transaction and wait for the broadcast.\n let pending_tx = provider.send_transaction(tx).await.unwrap();\n\n println!(\"Pending transaction... {}\", pending_tx.tx_hash());\n\n // Wait for the transaction to be included and get the receipt.\n let receipt = pending_tx.get_receipt().await.unwrap();\n\n // Grab the processed transaction.\n let tx = provider.get_transaction_by_hash(receipt.transaction_hash).await.unwrap().unwrap();\n\n println!(\n \"Transaction included in block {}\",\n receipt.block_number.expect(\"Failed to get block number\")\n );\n\n assert!(tx.max_fee_per_blob_gas().unwrap() >= BLOB_TX_MIN_BLOB_GASPRICE);\n assert_eq!(receipt.from, alice);\n assert_eq!(receipt.to, Some(bob));\n assert_eq!(\n receipt.blob_gas_used.expect(\"Expected to be EIP-4844 transaction\"),\n DATA_GAS_PER_BLOB\n );\n}\n\n// \n#[tokio::test]\nasync fn can_bypass_sidecar_requirement() {\n crate::init_tracing();\n let node_config = NodeConfig::test()\n .with_hardfork(Some(EthereumHardfork::Cancun.into()))\n .with_auto_impersonate(true);\n let (api, handle) = spawn(node_config).await;\n let provider = http_provider(&handle.http_endpoint());\n\n let eip1559_est = provider.estimate_eip1559_fees().await.unwrap();\n let gas_price = provider.get_gas_price().await.unwrap();\n\n let from = Address::random();\n let to = Address::random();\n\n api.anvil_set_balance(from, U256::from(60262144030131080_u128)).await.unwrap();\n\n let tx = TransactionRequest {\n from: Some(from),\n to: Some(alloy_primitives::TxKind::Call(to)),\n nonce: Some(0),\n value: Some(U256::from(0)),\n max_fee_per_blob_gas: Some(gas_price + 1),\n max_fee_per_gas: Some(eip1559_est.max_fee_per_gas),\n max_priority_fee_per_gas: Some(eip1559_est.max_priority_fee_per_gas),\n blob_versioned_hashes: Some(vec![b256!(\n \"0x01d5446006b21888d0267829344ab8624fdf1b425445a8ae1ca831bf1b8fbcd4\"\n )]),\n sidecar: None,\n transaction_type: Some(3),\n ..Default::default()\n };\n\n let receipt = provider\n .send_transaction(WithOtherFields::new(tx))\n .await\n .unwrap()\n .get_receipt()\n .await\n .unwrap();\n\n assert!(receipt.status());\n\n let tx = provider.get_transaction_by_hash(receipt.transaction_hash).await.unwrap().unwrap();\n\n assert_eq!(tx.inner.ty(), 3);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_get_blobs_by_versioned_hash() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Prague.into()));\n let (api, handle) = spawn(node_config).await;\n\n let wallets = handle.dev_wallets().collect::>();\n let from = wallets[0].address();\n let to = wallets[1].address();\n let provider = http_provider(&handle.http_endpoint());\n\n let eip1559_est = provider.estimate_eip1559_fees().await.unwrap();\n let gas_price = provider.get_gas_price().await.unwrap();\n\n let sidecar: SidecarBuilder = SidecarBuilder::from_slice(b\"Hello World\");\n\n let sidecar: BlobTransactionSidecar = sidecar.build().unwrap();\n let tx = TransactionRequest::default()\n .with_from(from)\n .with_to(to)\n .with_nonce(0)\n .with_max_fee_per_blob_gas(gas_price + 1)\n .with_max_fee_per_gas(eip1559_est.max_fee_per_gas)\n .with_max_priority_fee_per_gas(eip1559_est.max_priority_fee_per_gas)\n .with_blob_sidecar_4844(sidecar.clone())\n .value(U256::from(5));\n\n let tx = WithOtherFields::new(tx);\n\n let _receipt = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n let hash = sidecar.versioned_hash_for_blob(0).unwrap();\n // api.anvil_set_auto_mine(true).await.unwrap();\n let blob = api.anvil_get_blob_by_versioned_hash(hash).unwrap().unwrap();\n assert_eq!(blob, sidecar.blobs[0]);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_get_blobs_by_tx_hash() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Prague.into()));\n let (api, handle) = spawn(node_config).await;\n\n let wallets = handle.dev_wallets().collect::>();\n let from = wallets[0].address();\n let to = wallets[1].address();\n let provider = http_provider(&handle.http_endpoint());\n\n let eip1559_est = provider.estimate_eip1559_fees().await.unwrap();\n let gas_price = provider.get_gas_price().await.unwrap();\n\n let sidecar: SidecarBuilder = SidecarBuilder::from_slice(b\"Hello World\");\n\n let sidecar: BlobTransactionSidecar = sidecar.build().unwrap();\n let tx = TransactionRequest::default()\n .with_from(from)\n .with_to(to)\n .with_nonce(0)\n .with_max_fee_per_blob_gas(gas_price + 1)\n .with_max_fee_per_gas(eip1559_est.max_fee_per_gas)\n .with_max_priority_fee_per_gas(eip1559_est.max_priority_fee_per_gas)\n .with_blob_sidecar_4844(sidecar.clone())\n .value(U256::from(5));\n\n let tx = WithOtherFields::new(tx);\n let receipt = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n let hash = receipt.transaction_hash;\n api.anvil_set_auto_mine(true).await.unwrap();\n let blobs = api.anvil_get_blob_by_tx_hash(hash).unwrap().unwrap();\n assert_eq!(blobs, sidecar.blobs);\n}\n" }, { "path": "crates/anvil/tests/it/eip7702.rs", "content": "use crate::utils::http_provider;\nuse alloy_consensus::{SignableTransaction, transaction::TxEip7702};\nuse alloy_network::{ReceiptResponse, TransactionBuilder, TxSignerSync};\nuse alloy_primitives::{U256, bytes};\nuse alloy_provider::{PendingTransactionConfig, Provider};\nuse alloy_rpc_types::{Authorization, TransactionRequest};\nuse alloy_serde::WithOtherFields;\nuse alloy_signer::{Signature, SignerSync};\nuse anvil::{NodeConfig, spawn};\nuse foundry_evm::hardfork::EthereumHardfork;\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_send_eip7702_tx() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Prague.into()));\n let (_api, handle) = spawn(node_config).await;\n let provider = http_provider(&handle.http_endpoint());\n\n let wallets = handle.dev_wallets().collect::>();\n\n // deploy simple contract forwarding calldata to LOG0\n // PUSH7(CALLDATASIZE PUSH0 PUSH0 CALLDATACOPY CALLDATASIZE PUSH0 LOG0) PUSH0 MSTORE PUSH1(7)\n // PUSH1(25) RETURN\n let logger_bytecode = bytes!(\"66365f5f37365fa05f5260076019f3\");\n\n let eip1559_est = provider.estimate_eip1559_fees().await.unwrap();\n\n let from = wallets[0].address();\n let tx = TransactionRequest::default()\n .with_from(from)\n .into_create()\n .with_nonce(0)\n .with_max_fee_per_gas(eip1559_est.max_fee_per_gas)\n .with_max_priority_fee_per_gas(eip1559_est.max_priority_fee_per_gas)\n .with_input(logger_bytecode);\n\n let receipt = provider\n .send_transaction(WithOtherFields::new(tx))\n .await\n .unwrap()\n .get_receipt()\n .await\n .unwrap();\n\n assert!(receipt.status());\n\n let contract = receipt.contract_address.unwrap();\n let authorization = Authorization {\n chain_id: U256::from(31337u64),\n address: contract,\n nonce: provider.get_transaction_count(from).await.unwrap(),\n };\n let signature = wallets[0].sign_hash_sync(&authorization.signature_hash()).unwrap();\n let authorization = authorization.into_signed(signature);\n\n let log_data = bytes!(\"11112222\");\n let mut tx = TxEip7702 {\n max_fee_per_gas: eip1559_est.max_fee_per_gas,\n max_priority_fee_per_gas: eip1559_est.max_priority_fee_per_gas,\n gas_limit: 100000,\n chain_id: 31337,\n to: from,\n input: bytes!(\"11112222\"),\n authorization_list: vec![authorization],\n ..Default::default()\n };\n let signature = wallets[1].sign_transaction_sync(&mut tx).unwrap();\n\n let tx = tx.into_signed(signature);\n let mut encoded = Vec::new();\n tx.eip2718_encode(&mut encoded);\n\n let receipt =\n provider.send_raw_transaction(&encoded).await.unwrap().get_receipt().await.unwrap();\n let log = &receipt.inner.inner.logs()[0];\n // assert that log was from EOA which signed authorization\n assert_eq!(log.address(), from);\n assert_eq!(log.topics().len(), 0);\n assert_eq!(log.data().data, log_data);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_send_eip7702_request() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Prague.into()));\n let (api, handle) = spawn(node_config).await;\n let provider = http_provider(&handle.http_endpoint());\n\n let wallets = handle.dev_wallets().collect::>();\n\n // deploy simple contract forwarding calldata to LOG0\n // PUSH7(CALLDATASIZE PUSH0 PUSH0 CALLDATACOPY CALLDATASIZE PUSH0 LOG0) PUSH0 MSTORE PUSH1(7)\n // PUSH1(25) RETURN\n let logger_bytecode = bytes!(\"66365f5f37365fa05f5260076019f3\");\n\n let eip1559_est = provider.estimate_eip1559_fees().await.unwrap();\n\n let from = wallets[0].address();\n let tx = TransactionRequest::default()\n .with_from(from)\n .into_create()\n .with_nonce(0)\n .with_max_fee_per_gas(eip1559_est.max_fee_per_gas)\n .with_max_priority_fee_per_gas(eip1559_est.max_priority_fee_per_gas)\n .with_input(logger_bytecode);\n\n let receipt = provider\n .send_transaction(WithOtherFields::new(tx))\n .await\n .unwrap()\n .get_receipt()\n .await\n .unwrap();\n\n assert!(receipt.status());\n\n let contract = receipt.contract_address.unwrap();\n let authorization = Authorization {\n chain_id: U256::from(31337u64),\n address: contract,\n nonce: provider.get_transaction_count(from).await.unwrap(),\n };\n let signature = wallets[0].sign_hash_sync(&authorization.signature_hash()).unwrap();\n let authorization = authorization.into_signed(signature);\n\n let log_data = bytes!(\"11112222\");\n let tx = TxEip7702 {\n max_fee_per_gas: eip1559_est.max_fee_per_gas,\n max_priority_fee_per_gas: eip1559_est.max_priority_fee_per_gas,\n gas_limit: 100000,\n chain_id: 31337,\n to: from,\n input: bytes!(\"11112222\"),\n authorization_list: vec![authorization],\n ..Default::default()\n };\n\n let sender = wallets[1].address();\n let request = TransactionRequest::from_transaction(tx).with_from(sender);\n\n api.anvil_impersonate_account(sender).await.unwrap();\n let txhash = api.send_transaction(WithOtherFields::new(request)).await.unwrap();\n\n let txhash = provider\n .watch_pending_transaction(PendingTransactionConfig::new(txhash))\n .await\n .unwrap()\n .await\n .unwrap();\n\n let receipt = provider.get_transaction_receipt(txhash).await.unwrap().unwrap();\n let log = &receipt.inner.inner.logs()[0];\n // assert that log was from EOA which signed authorization\n assert_eq!(log.address(), from);\n assert_eq!(log.topics().len(), 0);\n assert_eq!(log.data().data, log_data);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn eip7702_authorization_bypass() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Prague.into()));\n let (api, handle) = spawn(node_config).await;\n let provider = http_provider(&handle.http_endpoint());\n\n let wallets = handle.dev_wallets().collect::>();\n\n // deploy simple contract forwarding calldata to LOG0\n // PUSH7(CALLDATASIZE PUSH0 PUSH0 CALLDATACOPY CALLDATASIZE PUSH0 LOG0) PUSH0 MSTORE PUSH1(7)\n // PUSH1(25) RETURN\n let logger_bytecode = bytes!(\"66365f5f37365fa05f5260076019f3\");\n\n let eip1559_est = provider.estimate_eip1559_fees().await.unwrap();\n\n let from = wallets[0].address();\n let tx = TransactionRequest::default()\n .with_from(from)\n .into_create()\n .with_nonce(0)\n .with_max_fee_per_gas(eip1559_est.max_fee_per_gas)\n .with_max_priority_fee_per_gas(eip1559_est.max_priority_fee_per_gas)\n .with_input(logger_bytecode);\n\n let receipt = provider\n .send_transaction(WithOtherFields::new(tx))\n .await\n .unwrap()\n .get_receipt()\n .await\n .unwrap();\n\n assert!(receipt.status());\n\n let contract = receipt.contract_address.unwrap();\n let authorization = Authorization {\n chain_id: U256::from(31337u64),\n address: contract,\n nonce: provider.get_transaction_count(from).await.unwrap(),\n };\n let fake_auth_sig = Signature::new(U256::ZERO, U256::ZERO, true);\n api.anvil_impersonate_signature(fake_auth_sig.as_bytes().into(), from).await.unwrap();\n let authorization = authorization.into_signed(fake_auth_sig);\n\n let log_data = bytes!(\"11112222\");\n let mut tx = TxEip7702 {\n max_fee_per_gas: eip1559_est.max_fee_per_gas,\n max_priority_fee_per_gas: eip1559_est.max_priority_fee_per_gas,\n gas_limit: 100000,\n chain_id: 31337,\n to: from,\n input: bytes!(\"11112222\"),\n authorization_list: vec![authorization],\n ..Default::default()\n };\n let signature = wallets[1].sign_transaction_sync(&mut tx).unwrap();\n\n let tx = tx.into_signed(signature);\n let mut encoded = Vec::new();\n tx.eip2718_encode(&mut encoded);\n\n let receipt =\n provider.send_raw_transaction(&encoded).await.unwrap().get_receipt().await.unwrap();\n let log = &receipt.inner.inner.logs()[0];\n // assert that log was from EOA which signed authorization\n assert_eq!(log.address(), from);\n assert_eq!(log.topics().len(), 0);\n assert_eq!(log.data().data, log_data);\n}\n" }, { "path": "crates/anvil/tests/it/fork.rs", "content": "//! various fork related test\n\nuse crate::{\n abi::{ERC721, Greeter},\n utils::{http_provider, http_provider_with_signer},\n};\nuse alloy_chains::NamedChain;\nuse alloy_eips::{\n eip7840::BlobParams,\n eip7910::{EthConfig, SystemContract},\n};\nuse alloy_network::{EthereumWallet, ReceiptResponse, TransactionBuilder, TransactionResponse};\nuse alloy_primitives::{Address, Bytes, TxHash, TxKind, U64, U256, address, b256, bytes, uint};\nuse alloy_provider::Provider;\nuse alloy_rpc_types::{\n AccountInfo, BlockId, BlockNumberOrTag,\n anvil::Forking,\n request::{TransactionInput, TransactionRequest},\n state::EvmOverrides,\n};\nuse alloy_serde::WithOtherFields;\nuse alloy_signer_local::PrivateKeySigner;\nuse anvil::{EthereumHardfork, NodeConfig, NodeHandle, PrecompileFactory, eth::EthApi, spawn};\nuse foundry_common::provider::get_http_provider;\nuse foundry_config::Config;\nuse foundry_evm_networks::NetworkConfigs;\nuse foundry_primitives::FoundryNetwork;\nuse foundry_test_utils::rpc::{self, next_http_rpc_endpoint, next_rpc_endpoint};\nuse futures::StreamExt;\nuse std::{\n collections::{BTreeMap, BTreeSet},\n sync::Arc,\n thread::sleep,\n time::Duration,\n};\n\nconst BLOCK_NUMBER: u64 = 14_608_400u64;\nconst DEAD_BALANCE_AT_BLOCK_NUMBER: u128 = 12_556_069_338_441_120_059_867u128;\n\nconst BLOCK_TIMESTAMP: u64 = 1_650_274_250u64;\n\n/// Represents an anvil fork of an anvil node\n#[expect(unused)]\npub struct LocalFork {\n origin_api: EthApi,\n origin_handle: NodeHandle,\n fork_api: EthApi,\n fork_handle: NodeHandle,\n}\n\n#[expect(dead_code)]\nimpl LocalFork {\n /// Spawns two nodes with the test config\n pub async fn new() -> Self {\n Self::setup(NodeConfig::test(), NodeConfig::test()).await\n }\n\n /// Spawns two nodes where one is a fork of the other\n pub async fn setup(origin: NodeConfig, fork: NodeConfig) -> Self {\n let (origin_api, origin_handle) = spawn(origin).await;\n\n let (fork_api, fork_handle) =\n spawn(fork.with_eth_rpc_url(Some(origin_handle.http_endpoint()))).await;\n Self { origin_api, origin_handle, fork_api, fork_handle }\n }\n}\n\npub fn fork_config() -> NodeConfig {\n NodeConfig::test()\n .with_eth_rpc_url(Some(rpc::next_http_archive_rpc_url()))\n .with_fork_block_number(Some(BLOCK_NUMBER))\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_gas_limit_applied_from_config() {\n let (api, _handle) = spawn(fork_config().with_gas_limit(Some(10_000_000))).await;\n\n assert_eq!(api.gas_limit(), uint!(10_000_000_U256));\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_gas_limit_disabled_from_config() {\n let (api, handle) = spawn(fork_config().disable_block_gas_limit(true)).await;\n\n // see https://github.com/foundry-rs/foundry/pull/8933\n assert_eq!(api.gas_limit(), U256::from(U64::MAX));\n\n // try to mine a couple blocks\n let provider = handle.http_provider();\n let tx = TransactionRequest::default()\n .to(Address::random())\n .value(U256::from(1337u64))\n .from(handle.dev_wallets().next().unwrap().address());\n let tx = WithOtherFields::new(tx);\n let _ = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n let tx = TransactionRequest::default()\n .to(Address::random())\n .value(U256::from(1337u64))\n .from(handle.dev_wallets().next().unwrap().address());\n let tx = WithOtherFields::new(tx);\n let _ = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_spawn_fork() {\n let (api, _handle) = spawn(fork_config()).await;\n assert!(api.is_fork());\n\n let head = api.block_number().unwrap();\n assert_eq!(head, U256::from(BLOCK_NUMBER))\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_eth_get_balance() {\n let (api, handle) = spawn(fork_config()).await;\n let provider = handle.http_provider();\n for _ in 0..10 {\n let addr = Address::random();\n let balance = api.balance(addr, None).await.unwrap();\n let provider_balance = provider.get_balance(addr).await.unwrap();\n assert_eq!(balance, provider_balance)\n }\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_eth_get_balance_after_mine() {\n let (api, handle) = spawn(fork_config()).await;\n let provider = handle.http_provider();\n let info = api.anvil_node_info().await.unwrap();\n let number = info.fork_config.fork_block_number.unwrap();\n assert_eq!(number, BLOCK_NUMBER);\n\n let address = Address::random();\n\n let _balance = provider.get_balance(address).await.unwrap();\n\n api.evm_mine(None).await.unwrap();\n\n let _balance = provider.get_balance(address).await.unwrap();\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_eth_get_code_after_mine() {\n let (api, handle) = spawn(fork_config()).await;\n let provider = handle.http_provider();\n let info = api.anvil_node_info().await.unwrap();\n let number = info.fork_config.fork_block_number.unwrap();\n assert_eq!(number, BLOCK_NUMBER);\n\n let address = Address::random();\n\n let _code = provider.get_code_at(address).block_id(BlockId::number(1)).await.unwrap();\n\n api.evm_mine(None).await.unwrap();\n\n let _code = provider.get_code_at(address).block_id(BlockId::number(1)).await.unwrap();\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_eth_get_code() {\n let (api, handle) = spawn(fork_config()).await;\n let provider = handle.http_provider();\n for _ in 0..10 {\n let addr = Address::random();\n let code = api.get_code(addr, None).await.unwrap();\n let provider_code = provider.get_code_at(addr).await.unwrap();\n assert_eq!(code, provider_code)\n }\n\n let addresses: Vec
= vec![\n \"0x6b175474e89094c44da98b954eedeac495271d0f\".parse().unwrap(),\n \"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48\".parse().unwrap(),\n \"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2\".parse().unwrap(),\n \"0x1F98431c8aD98523631AE4a59f267346ea31F984\".parse().unwrap(),\n \"0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45\".parse().unwrap(),\n ];\n for address in addresses {\n let prev_code = api\n .get_code(address, Some(BlockNumberOrTag::Number(BLOCK_NUMBER - 10).into()))\n .await\n .unwrap();\n let code = api.get_code(address, None).await.unwrap();\n let provider_code = provider.get_code_at(address).await.unwrap();\n assert_eq!(code, prev_code);\n assert_eq!(code, provider_code);\n assert!(!code.as_ref().is_empty());\n }\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_eth_get_nonce() {\n let (api, handle) = spawn(fork_config()).await;\n let provider = handle.http_provider();\n\n for _ in 0..10 {\n let addr = Address::random();\n let api_nonce = api.transaction_count(addr, None).await.unwrap().to::();\n let provider_nonce = provider.get_transaction_count(addr).await.unwrap();\n assert_eq!(api_nonce, provider_nonce);\n }\n\n let addr = Config::DEFAULT_SENDER;\n let api_nonce = api.transaction_count(addr, None).await.unwrap().to::();\n let provider_nonce = provider.get_transaction_count(addr).await.unwrap();\n assert_eq!(api_nonce, provider_nonce);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_optimism_with_transaction_hash() {\n use std::str::FromStr;\n\n // Fork to a block with a specific transaction\n let fork_tx_hash =\n TxHash::from_str(\"fcb864b5a50f0f0b111dbbf9e9167b2cb6179dfd6270e1ad53aac6049c0ec038\")\n .unwrap();\n let (api, _handle) = spawn(\n NodeConfig::test()\n .with_eth_rpc_url(Some(rpc::next_rpc_endpoint(NamedChain::Optimism)))\n .with_fork_transaction_hash(Some(fork_tx_hash)),\n )\n .await;\n\n // Make sure the fork starts from previous block\n let block_number = api.block_number().unwrap().to::();\n assert_eq!(block_number, 125777954 - 1);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_eth_fee_history() {\n let (api, handle) = spawn(fork_config()).await;\n let provider = handle.http_provider();\n\n let count = 10u64;\n let _history =\n api.fee_history(U256::from(count), BlockNumberOrTag::Latest, vec![]).await.unwrap();\n let _provider_history =\n provider.get_fee_history(count, BlockNumberOrTag::Latest, &[]).await.unwrap();\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_reset() {\n let (api, handle) = spawn(fork_config()).await;\n let provider = handle.http_provider();\n\n let accounts: Vec<_> = handle.dev_wallets().collect();\n let from = accounts[0].address();\n let to = accounts[1].address();\n let block_number = provider.get_block_number().await.unwrap();\n let balance_before = provider.get_balance(to).await.unwrap();\n let amount = handle.genesis_balance().checked_div(U256::from(2u64)).unwrap();\n\n let initial_nonce = provider.get_transaction_count(from).await.unwrap();\n\n let tx = TransactionRequest::default().to(to).value(amount).from(from);\n let tx = WithOtherFields::new(tx);\n let tx = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n assert_eq!(tx.transaction_index, Some(0));\n\n let nonce = provider.get_transaction_count(from).await.unwrap();\n\n assert_eq!(nonce, initial_nonce + 1);\n let to_balance = provider.get_balance(to).await.unwrap();\n assert_eq!(balance_before.saturating_add(amount), to_balance);\n api.anvil_reset(Some(Forking { json_rpc_url: None, block_number: Some(block_number) }))\n .await\n .unwrap();\n\n // reset block number\n assert_eq!(block_number, provider.get_block_number().await.unwrap());\n\n let nonce = provider.get_transaction_count(from).await.unwrap();\n assert_eq!(nonce, initial_nonce);\n let balance = provider.get_balance(from).await.unwrap();\n assert_eq!(balance, handle.genesis_balance());\n let balance = provider.get_balance(to).await.unwrap();\n assert_eq!(balance, handle.genesis_balance());\n\n // reset to latest\n api.anvil_reset(Some(Forking::default())).await.unwrap();\n\n let new_block_num = provider.get_block_number().await.unwrap();\n assert!(new_block_num > block_number);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_reset_setup() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let dead_addr: Address = \"000000000000000000000000000000000000dEaD\".parse().unwrap();\n\n let block_number = provider.get_block_number().await.unwrap();\n assert_eq!(block_number, 0);\n\n let local_balance = provider.get_balance(dead_addr).await.unwrap();\n assert_eq!(local_balance, U256::ZERO);\n\n api.anvil_reset(Some(Forking {\n json_rpc_url: Some(rpc::next_http_archive_rpc_url()),\n block_number: Some(BLOCK_NUMBER),\n }))\n .await\n .unwrap();\n\n let block_number = provider.get_block_number().await.unwrap();\n assert_eq!(block_number, BLOCK_NUMBER);\n\n let remote_balance = provider.get_balance(dead_addr).await.unwrap();\n assert_eq!(remote_balance, U256::from(DEAD_BALANCE_AT_BLOCK_NUMBER));\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_state_snapshotting() {\n let (api, handle) = spawn(fork_config()).await;\n let provider = handle.http_provider();\n let state_snapshot = api.evm_snapshot().await.unwrap();\n\n let accounts: Vec<_> = handle.dev_wallets().collect();\n let from = accounts[0].address();\n let to = accounts[1].address();\n let block_number = provider.get_block_number().await.unwrap();\n\n let initial_nonce = provider.get_transaction_count(from).await.unwrap();\n let balance_before = provider.get_balance(to).await.unwrap();\n let amount = handle.genesis_balance().checked_div(U256::from(2u64)).unwrap();\n\n let provider = handle.http_provider();\n let tx = TransactionRequest::default().to(to).value(amount).from(from);\n let tx = WithOtherFields::new(tx);\n\n let _ = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n let provider = handle.http_provider();\n\n let nonce = provider.get_transaction_count(from).await.unwrap();\n assert_eq!(nonce, initial_nonce + 1);\n let to_balance = provider.get_balance(to).await.unwrap();\n assert_eq!(balance_before.saturating_add(amount), to_balance);\n\n assert!(api.evm_revert(state_snapshot).await.unwrap());\n\n let nonce = provider.get_transaction_count(from).await.unwrap();\n assert_eq!(nonce, initial_nonce);\n let balance = provider.get_balance(from).await.unwrap();\n assert_eq!(balance, handle.genesis_balance());\n let balance = provider.get_balance(to).await.unwrap();\n assert_eq!(balance, handle.genesis_balance());\n assert_eq!(block_number, provider.get_block_number().await.unwrap());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_state_snapshotting_repeated() {\n let (api, handle) = spawn(fork_config()).await;\n let provider = handle.http_provider();\n\n let state_snapshot = api.evm_snapshot().await.unwrap();\n\n let accounts: Vec<_> = handle.dev_wallets().collect();\n let from = accounts[0].address();\n let to = accounts[1].address();\n let block_number = provider.get_block_number().await.unwrap();\n\n let initial_nonce = provider.get_transaction_count(from).await.unwrap();\n let balance_before = provider.get_balance(to).await.unwrap();\n let amount = handle.genesis_balance().checked_div(U256::from(92u64)).unwrap();\n\n let tx = TransactionRequest::default().to(to).value(amount).from(from);\n let tx = WithOtherFields::new(tx);\n let tx_provider = handle.http_provider();\n let _ = tx_provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n let nonce = provider.get_transaction_count(from).await.unwrap();\n assert_eq!(nonce, initial_nonce + 1);\n let to_balance = provider.get_balance(to).await.unwrap();\n assert_eq!(balance_before.saturating_add(amount), to_balance);\n\n let _second_state_snapshot = api.evm_snapshot().await.unwrap();\n\n assert!(api.evm_revert(state_snapshot).await.unwrap());\n\n let nonce = provider.get_transaction_count(from).await.unwrap();\n assert_eq!(nonce, initial_nonce);\n let balance = provider.get_balance(from).await.unwrap();\n assert_eq!(balance, handle.genesis_balance());\n let balance = provider.get_balance(to).await.unwrap();\n assert_eq!(balance, handle.genesis_balance());\n assert_eq!(block_number, provider.get_block_number().await.unwrap());\n\n // invalidated\n // TODO enable after \n // assert!(!api.evm_revert(second_snapshot).await.unwrap());\n\n // nothing is reverted, snapshot gone\n assert!(!api.evm_revert(state_snapshot).await.unwrap());\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_state_snapshotting_blocks() {\n let (api, handle) = spawn(fork_config()).await;\n let provider = handle.http_provider();\n\n let state_snapshot = api.evm_snapshot().await.unwrap();\n\n let accounts: Vec<_> = handle.dev_wallets().collect();\n let from = accounts[0].address();\n let to = accounts[1].address();\n let block_number = provider.get_block_number().await.unwrap();\n\n let initial_nonce = provider.get_transaction_count(from).await.unwrap();\n let balance_before = provider.get_balance(to).await.unwrap();\n let amount = handle.genesis_balance().checked_div(U256::from(2u64)).unwrap();\n\n // send the transaction\n let tx = TransactionRequest::default().to(to).value(amount).from(from);\n let tx = WithOtherFields::new(tx);\n let _ = provider.send_transaction(tx.clone()).await.unwrap().get_receipt().await.unwrap();\n\n let block_number_after = provider.get_block_number().await.unwrap();\n assert_eq!(block_number_after, block_number + 1);\n\n let nonce = provider.get_transaction_count(from).await.unwrap();\n assert_eq!(nonce, initial_nonce + 1);\n let to_balance = provider.get_balance(to).await.unwrap();\n assert_eq!(balance_before.saturating_add(amount), to_balance);\n\n assert!(api.evm_revert(state_snapshot).await.unwrap());\n\n assert_eq!(initial_nonce, provider.get_transaction_count(from).await.unwrap());\n let block_number_after = provider.get_block_number().await.unwrap();\n assert_eq!(block_number_after, block_number);\n\n // repeat transaction\n let _ = provider.send_transaction(tx.clone()).await.unwrap().get_receipt().await.unwrap();\n let nonce = provider.get_transaction_count(from).await.unwrap();\n assert_eq!(nonce, initial_nonce + 1);\n\n // revert again: nothing to revert since state snapshot gone\n assert!(!api.evm_revert(state_snapshot).await.unwrap());\n let nonce = provider.get_transaction_count(from).await.unwrap();\n assert_eq!(nonce, initial_nonce + 1);\n let block_number_after = provider.get_block_number().await.unwrap();\n assert_eq!(block_number_after, block_number + 1);\n}\n\n/// tests that the remote state and local state are kept separate.\n/// changes don't make into the read only Database that holds the remote state, which is flushed to\n/// a cache file.\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_separate_states() {\n let (api, handle) = spawn(fork_config().with_fork_block_number(Some(14723772u64))).await;\n let provider = handle.http_provider();\n\n let addr: Address = \"000000000000000000000000000000000000dEaD\".parse().unwrap();\n\n let remote_balance = provider.get_balance(addr).await.unwrap();\n assert_eq!(remote_balance, U256::from(12556104082473169733500u128));\n\n api.anvil_set_balance(addr, U256::from(1337u64)).await.unwrap();\n let balance = provider.get_balance(addr).await.unwrap();\n assert_eq!(balance, U256::from(1337u64));\n\n let fork = api.get_fork().unwrap();\n let fork_db = fork.database.read().await;\n let acc = fork_db\n .maybe_inner()\n .expect(\"could not get fork db inner\")\n .db()\n .accounts\n .read()\n .get(&addr)\n .cloned()\n .unwrap();\n\n assert_eq!(acc.balance, remote_balance);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_deploy_greeter_on_fork() {\n let (_api, handle) = spawn(fork_config().with_fork_block_number(Some(14723772u64))).await;\n\n let wallet = handle.dev_wallets().next().unwrap();\n let signer: EthereumWallet = wallet.into();\n\n let provider = http_provider_with_signer(&handle.http_endpoint(), signer);\n\n let greeter_contract = Greeter::deploy(&provider, \"Hello World!\".to_string()).await.unwrap();\n\n let greeting = greeter_contract.greet().call().await.unwrap();\n assert_eq!(\"Hello World!\", greeting);\n\n let greeter_contract = Greeter::deploy(&provider, \"Hello World!\".to_string()).await.unwrap();\n\n let greeting = greeter_contract.greet().call().await.unwrap();\n assert_eq!(\"Hello World!\", greeting);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_reset_properly() {\n let (origin_api, origin_handle) = spawn(NodeConfig::test()).await;\n let account = origin_handle.dev_accounts().next().unwrap();\n let origin_provider = origin_handle.http_provider();\n let origin_nonce = 1u64;\n origin_api.anvil_set_nonce(account, U256::from(origin_nonce)).await.unwrap();\n\n assert_eq!(origin_nonce, origin_provider.get_transaction_count(account).await.unwrap());\n\n let (fork_api, fork_handle) =\n spawn(NodeConfig::test().with_eth_rpc_url(Some(origin_handle.http_endpoint()))).await;\n\n let fork_provider = fork_handle.http_provider();\n let fork_tx_provider = http_provider(&fork_handle.http_endpoint());\n assert_eq!(origin_nonce, fork_provider.get_transaction_count(account).await.unwrap());\n\n let to = Address::random();\n let to_balance = fork_provider.get_balance(to).await.unwrap();\n let tx = TransactionRequest::default().from(account).to(to).value(U256::from(1337u64));\n let tx = WithOtherFields::new(tx);\n let tx = fork_tx_provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n // nonce incremented by 1\n assert_eq!(origin_nonce + 1, fork_provider.get_transaction_count(account).await.unwrap());\n\n // resetting to origin state\n fork_api.anvil_reset(Some(Forking::default())).await.unwrap();\n\n // nonce reset to origin\n assert_eq!(origin_nonce, fork_provider.get_transaction_count(account).await.unwrap());\n\n // balance is reset\n assert_eq!(to_balance, fork_provider.get_balance(to).await.unwrap());\n\n // tx does not exist anymore\n assert!(fork_tx_provider.get_transaction_by_hash(tx.transaction_hash).await.unwrap().is_none())\n}\n\n// Ref: \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_reset_fork_to_new_fork() {\n let eth_rpc_url = next_rpc_endpoint(NamedChain::Mainnet);\n let (api, handle) = spawn(NodeConfig::test().with_eth_rpc_url(Some(eth_rpc_url))).await;\n let provider = handle.http_provider();\n\n let op = address!(\"0xC0d3c0d3c0D3c0D3C0d3C0D3C0D3c0d3c0d30007\"); // L2CrossDomainMessenger - Dead on mainnet.\n\n let tx = TransactionRequest::default().with_to(op).with_input(\"0x54fd4d50\");\n\n let tx = WithOtherFields::new(tx);\n\n let mainnet_call_output = provider.call(tx).await.unwrap();\n\n assert_eq!(mainnet_call_output, Bytes::new()); // 0x\n\n let optimism = next_rpc_endpoint(NamedChain::Optimism);\n\n api.anvil_reset(Some(Forking {\n json_rpc_url: Some(optimism.to_string()),\n block_number: Some(124659890),\n }))\n .await\n .unwrap();\n\n let code = provider.get_code_at(op).await.unwrap();\n\n assert_ne!(code, Bytes::new());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_timestamp() {\n let start = std::time::Instant::now();\n\n let (api, handle) = spawn(fork_config()).await;\n let provider = handle.http_provider();\n\n let block = provider.get_block(BlockId::Number(BLOCK_NUMBER.into())).await.unwrap().unwrap();\n assert_eq!(block.header.timestamp, BLOCK_TIMESTAMP);\n\n let accounts: Vec<_> = handle.dev_wallets().collect();\n let from = accounts[0].address();\n\n let tx =\n TransactionRequest::default().to(Address::random()).value(U256::from(1337u64)).from(from);\n let tx = WithOtherFields::new(tx);\n let tx = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n let status = tx.inner.inner.inner.receipt.status.coerce_status();\n assert!(status);\n\n let block = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n\n let elapsed = start.elapsed().as_secs() + 1;\n\n // ensure the diff between the new mined block and the original block is within the elapsed time\n let diff = block.header.timestamp - BLOCK_TIMESTAMP;\n assert!(diff <= elapsed, \"diff={diff}, elapsed={elapsed}\");\n\n let start = std::time::Instant::now();\n // reset to check timestamp works after resetting\n api.anvil_reset(Some(Forking { json_rpc_url: None, block_number: Some(BLOCK_NUMBER) }))\n .await\n .unwrap();\n let block = provider.get_block(BlockId::Number(BLOCK_NUMBER.into())).await.unwrap().unwrap();\n assert_eq!(block.header.timestamp, BLOCK_TIMESTAMP);\n\n let tx =\n TransactionRequest::default().to(Address::random()).value(U256::from(1337u64)).from(from);\n let tx = WithOtherFields::new(tx);\n let _ = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap(); // FIXME: Awaits endlessly here.\n\n let block = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n let elapsed = start.elapsed().as_secs() + 1;\n let diff = block.header.timestamp - BLOCK_TIMESTAMP;\n assert!(diff <= elapsed);\n\n // ensure that after setting a timestamp manually, then next block time is correct\n let start = std::time::Instant::now();\n api.anvil_reset(Some(Forking { json_rpc_url: None, block_number: Some(BLOCK_NUMBER) }))\n .await\n .unwrap();\n api.evm_set_next_block_timestamp(BLOCK_TIMESTAMP + 1).unwrap();\n let tx =\n TransactionRequest::default().to(Address::random()).value(U256::from(1337u64)).from(from);\n let tx = WithOtherFields::new(tx);\n let _tx = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n let block = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n assert_eq!(block.header.timestamp, BLOCK_TIMESTAMP + 1);\n\n let tx =\n TransactionRequest::default().to(Address::random()).value(U256::from(1337u64)).from(from);\n let tx = WithOtherFields::new(tx);\n let _ = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n let block = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n let elapsed = start.elapsed().as_secs() + 1;\n let diff = block.header.timestamp - (BLOCK_TIMESTAMP + 1);\n assert!(diff <= elapsed);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_set_empty_code() {\n let (api, _handle) = spawn(fork_config()).await;\n let addr = \"0x1f9840a85d5af5bf1d1762f925bdaddc4201f984\".parse().unwrap();\n let code = api.get_code(addr, None).await.unwrap();\n assert!(!code.as_ref().is_empty());\n api.anvil_set_code(addr, Vec::new().into()).await.unwrap();\n let code = api.get_code(addr, None).await.unwrap();\n assert!(code.as_ref().is_empty());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_can_send_tx() {\n let (api, handle) =\n spawn(fork_config().with_blocktime(Some(std::time::Duration::from_millis(800)))).await;\n\n let wallet = PrivateKeySigner::random();\n let signer = wallet.address();\n let provider = handle.http_provider();\n // let provider = SignerMiddleware::new(provider, wallet);\n\n api.anvil_set_balance(signer, U256::MAX).await.unwrap();\n api.anvil_impersonate_account(signer).await.unwrap(); // Added until WalletFiller for alloy-provider is fixed.\n let balance = provider.get_balance(signer).await.unwrap();\n assert_eq!(balance, U256::MAX);\n\n let addr = Address::random();\n let val = U256::from(1337u64);\n let tx = TransactionRequest::default().to(addr).value(val).from(signer);\n let tx = WithOtherFields::new(tx);\n // broadcast it via the eth_sendTransaction API\n let _ = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n let balance = provider.get_balance(addr).await.unwrap();\n assert_eq!(balance, val);\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_nft_set_approve_all() {\n let (api, handle) = spawn(\n fork_config()\n .with_fork_block_number(Some(14812197u64))\n .with_blocktime(Some(Duration::from_secs(5)))\n .with_chain_id(1u64.into()),\n )\n .await;\n\n // create and fund a random wallet\n let wallet = PrivateKeySigner::random();\n let signer = wallet.address();\n api.anvil_set_balance(signer, U256::from(1000e18)).await.unwrap();\n\n let provider = handle.http_provider();\n\n // pick a random nft \n let nouns_addr: Address = \"0x9c8ff314c9bc7f6e59a9d9225fb22946427edc03\".parse().unwrap();\n\n let owner: Address = \"0x052564eb0fd8b340803df55def89c25c432f43f4\".parse().unwrap();\n let token_id: U256 = U256::from(154u64);\n\n let nouns = ERC721::new(nouns_addr, provider.clone());\n\n let real_owner = nouns.ownerOf(token_id).call().await.unwrap();\n assert_eq!(real_owner, owner);\n let approval = nouns.setApprovalForAll(nouns_addr, true);\n let tx = TransactionRequest::default()\n .from(owner)\n .to(nouns_addr)\n .with_input(approval.calldata().to_owned());\n let tx = WithOtherFields::new(tx);\n api.anvil_impersonate_account(owner).await.unwrap();\n let tx = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n let status = tx.inner.inner.inner.receipt.status.coerce_status();\n assert!(status);\n\n // transfer: impersonate real owner and transfer nft\n api.anvil_impersonate_account(real_owner).await.unwrap();\n\n api.anvil_set_balance(real_owner, U256::from(10000e18 as u64)).await.unwrap();\n\n let call = nouns.transferFrom(real_owner, signer, token_id);\n let tx = TransactionRequest::default()\n .from(real_owner)\n .to(nouns_addr)\n .with_input(call.calldata().to_owned());\n let tx = WithOtherFields::new(tx);\n let tx = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n let status = tx.inner.inner.inner.receipt.status.coerce_status();\n assert!(status);\n\n let real_owner = nouns.ownerOf(token_id).call().await.unwrap();\n assert_eq!(real_owner, wallet.address());\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_with_custom_chain_id() {\n // spawn a forked node with some random chainId\n let (api, handle) = spawn(\n fork_config()\n .with_fork_block_number(Some(14812197u64))\n .with_blocktime(Some(Duration::from_secs(5)))\n .with_chain_id(3145u64.into()),\n )\n .await;\n\n // get the eth chainId and the txn chainId\n let eth_chain_id = api.eth_chain_id();\n let txn_chain_id = api.chain_id();\n\n // get the chainId in the config\n let config_chain_id = handle.config().chain_id;\n\n // check that the chainIds are the same\n assert_eq!(eth_chain_id.unwrap().unwrap().to::(), 3145u64);\n assert_eq!(txn_chain_id, 3145u64);\n assert_eq!(config_chain_id, Some(3145u64));\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_can_send_opensea_tx() {\n let (api, handle) = spawn(\n fork_config()\n .with_fork_block_number(Some(14983338u64))\n .with_blocktime(Some(Duration::from_millis(5000))),\n )\n .await;\n\n let sender: Address = \"0x8fdbae54b6d9f3fc2c649e3dd4602961967fd42f\".parse().unwrap();\n\n // transfer: impersonate real sender\n api.anvil_impersonate_account(sender).await.unwrap();\n\n let provider = handle.http_provider();\n\n let input: Bytes = \"0xfb0f3ee1000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003ff2e795f5000000000000000000000000000023f28ae3e9756ba982a6290f9081b6a84900b758000000000000000000000000004c00500000ad104d7dbd00e3ae0a5c00560c0000000000000000000000000003235b597a78eabcb08ffcb4d97411073211dbcb0000000000000000000000000000000000000000000000000000000000000e72000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000062ad47c20000000000000000000000000000000000000000000000000000000062d43104000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000df44e65d2a2cf40000007b02230091a7ed01230072f7006a004d60a8d4e71d599b8104250f00000000007b02230091a7ed01230072f7006a004d60a8d4e71d599b8104250f00000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000024000000000000000000000000000000000000000000000000000000000000002e000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000001c6bf526340000000000000000000000000008de9c5a032463c561423387a9648c5c7bcc5bc900000000000000000000000000000000000000000000000000005543df729c0000000000000000000000000006eb234847a9e3a546539aac57a071c01dc3f398600000000000000000000000000000000000000000000000000000000000000416d39b5352353a22cf2d44faa696c2089b03137a13b5acfee0366306f2678fede043bc8c7e422f6f13a3453295a4a063dac7ee6216ab7bade299690afc77397a51c00000000000000000000000000000000000000000000000000000000000000\".parse().unwrap();\n let to: Address = \"0x00000000006c3852cbef3e08e8df289169ede581\".parse().unwrap();\n let tx = TransactionRequest::default()\n .from(sender)\n .to(to)\n .value(U256::from(20000000000000000u64))\n .with_input(input)\n .with_gas_price(22180711707u128)\n .with_gas_limit(150_000);\n let tx = WithOtherFields::new(tx);\n\n let tx = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n let status = tx.inner.inner.inner.receipt.status.coerce_status();\n assert!(status);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_base_fee() {\n let (api, handle) = spawn(fork_config()).await;\n\n let accounts: Vec<_> = handle.dev_wallets().collect();\n let from = accounts[0].address();\n\n let provider = handle.http_provider();\n\n api.anvil_set_next_block_base_fee_per_gas(U256::ZERO).await.unwrap();\n\n let addr = Address::random();\n let val = U256::from(1337u64);\n let tx = TransactionRequest::default().from(from).to(addr).value(val);\n let tx = WithOtherFields::new(tx);\n let _res = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_init_base_fee() {\n let (api, handle) = spawn(fork_config().with_fork_block_number(Some(13184859u64))).await;\n\n let provider = handle.http_provider();\n\n let block = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n // \n assert_eq!(block.header.number, 13184859u64);\n let init_base_fee = block.header.base_fee_per_gas.unwrap();\n assert_eq!(init_base_fee, 63739886069);\n\n api.mine_one().await;\n\n let block = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n\n let next_base_fee = block.header.base_fee_per_gas.unwrap();\n assert!(next_base_fee < init_base_fee);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_init_blob_base_fee_with_explicit_base_fee() {\n let fork_rpc_url = rpc::next_http_archive_rpc_url();\n let fork_block_number = 24_127_158u64;\n let (default_api, _) = spawn(\n NodeConfig::test()\n .with_eth_rpc_url(Some(fork_rpc_url.clone()))\n .with_fork_block_number(Some(fork_block_number)),\n )\n .await;\n let explicit_base_fee = default_api\n .block_by_number(BlockNumberOrTag::Latest)\n .await\n .unwrap()\n .unwrap()\n .header\n .base_fee_per_gas\n .unwrap();\n let (explicit_api, _) = spawn(\n NodeConfig::test()\n .with_eth_rpc_url(Some(fork_rpc_url))\n .with_fork_block_number(Some(fork_block_number))\n .with_base_fee(Some(explicit_base_fee)),\n )\n .await;\n\n let default_blob_base_fee = default_api.blob_base_fee().unwrap();\n let explicit_blob_base_fee = explicit_api.blob_base_fee().unwrap();\n\n assert!(default_blob_base_fee > U256::from(1));\n assert_eq!(explicit_blob_base_fee, default_blob_base_fee);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn flaky_test_reset_fork_on_new_blocks() {\n let (api, handle) =\n spawn(NodeConfig::test().with_eth_rpc_url(Some(rpc::next_http_archive_rpc_url()))).await;\n\n let anvil_provider = handle.http_provider();\n let endpoint = next_http_rpc_endpoint();\n let provider = Arc::new(get_http_provider(&endpoint));\n\n let current_block = anvil_provider.get_block_number().await.unwrap();\n\n handle\n .task_manager()\n .spawn_reset_on_new_polled_blocks::(provider.clone(), api);\n\n let mut stream = provider\n .watch_blocks()\n .await\n .unwrap()\n .with_poll_interval(Duration::from_secs(2))\n .into_stream()\n .flat_map(futures::stream::iter);\n // the http watcher may fetch multiple blocks at once, so we set a timeout here to offset edge\n // cases where the stream immediately returns a block\n tokio::time::sleep(Duration::from_secs(12)).await;\n stream.next().await.unwrap();\n stream.next().await.unwrap();\n\n let next_block = anvil_provider.get_block_number().await.unwrap();\n\n assert!(next_block > current_block, \"nextblock={next_block} currentblock={current_block}\")\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_call() {\n let input: Bytes = \"0x77c7b8fc\".parse().unwrap();\n let to: Address = \"0x99d1Fa417f94dcD62BfE781a1213c092a47041Bc\".parse().unwrap();\n let block_number = 14746300u64;\n\n let provider = http_provider(rpc::next_http_archive_rpc_url().as_str());\n let tx = TransactionRequest::default().to(to).with_input(input.clone());\n let tx = WithOtherFields::new(tx);\n let res0 = provider.call(tx).block(BlockId::Number(block_number.into())).await.unwrap();\n\n let (api, _) = spawn(fork_config().with_fork_block_number(Some(block_number))).await;\n\n let res1 = api\n .call(\n WithOtherFields::new(TransactionRequest {\n to: Some(TxKind::from(to)),\n input: input.into(),\n ..Default::default()\n }),\n None,\n EvmOverrides::default(),\n )\n .await\n .unwrap();\n\n assert_eq!(res0, res1);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_block_timestamp() {\n let (api, _) = spawn(fork_config()).await;\n\n let initial_block = api.block_by_number(BlockNumberOrTag::Latest).await.unwrap().unwrap();\n api.anvil_mine(Some(U256::from(1)), None).await.unwrap();\n let latest_block = api.block_by_number(BlockNumberOrTag::Latest).await.unwrap().unwrap();\n\n assert!(initial_block.header.timestamp <= latest_block.header.timestamp);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_snapshot_block_timestamp() {\n let (api, _) = spawn(fork_config()).await;\n\n let snapshot_id = api.evm_snapshot().await.unwrap();\n api.anvil_mine(Some(U256::from(1)), None).await.unwrap();\n let initial_block = api.block_by_number(BlockNumberOrTag::Latest).await.unwrap().unwrap();\n api.evm_revert(snapshot_id).await.unwrap();\n api.evm_set_next_block_timestamp(initial_block.header.timestamp).unwrap();\n api.anvil_mine(Some(U256::from(1)), None).await.unwrap();\n let latest_block = api.block_by_number(BlockNumberOrTag::Latest).await.unwrap().unwrap();\n\n assert_eq!(initial_block.header.timestamp, latest_block.header.timestamp);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_uncles_fetch() {\n let (api, handle) = spawn(fork_config()).await;\n let provider = handle.http_provider();\n\n // Block on ETH mainnet with 2 uncles\n let block_with_uncles = 190u64;\n\n let block =\n api.block_by_number(BlockNumberOrTag::Number(block_with_uncles)).await.unwrap().unwrap();\n\n assert_eq!(block.uncles.len(), 2);\n\n let count = provider.get_uncle_count(block_with_uncles.into()).await.unwrap();\n assert_eq!(count as usize, block.uncles.len());\n\n let hash = BlockId::hash(block.header.hash);\n let count = provider.get_uncle_count(hash).await.unwrap();\n assert_eq!(count as usize, block.uncles.len());\n\n for (uncle_idx, uncle_hash) in block.uncles.iter().enumerate() {\n // Try with block number\n let uncle = provider\n .get_uncle(BlockId::number(block_with_uncles), uncle_idx as u64)\n .await\n .unwrap()\n .unwrap();\n assert_eq!(*uncle_hash, uncle.header.hash);\n\n // Try with block hash\n let uncle = provider\n .get_uncle(BlockId::hash(block.header.hash), uncle_idx as u64)\n .await\n .unwrap()\n .unwrap();\n assert_eq!(*uncle_hash, uncle.header.hash);\n }\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_block_transaction_count() {\n let (api, handle) = spawn(fork_config()).await;\n let provider = handle.http_provider();\n\n let accounts: Vec<_> = handle.dev_wallets().collect();\n let sender = accounts[0].address();\n\n // disable automine (so there are pending transactions)\n api.anvil_set_auto_mine(false).await.unwrap();\n // transfer: impersonate real sender\n api.anvil_impersonate_account(sender).await.unwrap();\n\n let tx =\n TransactionRequest::default().from(sender).value(U256::from(42u64)).with_gas_limit(100_000);\n let tx = WithOtherFields::new(tx);\n let _ = provider.send_transaction(tx).await.unwrap();\n\n let pending_txs =\n api.block_transaction_count_by_number(BlockNumberOrTag::Pending).await.unwrap().unwrap();\n assert_eq!(pending_txs.to::(), 1);\n\n // mine a new block\n api.anvil_mine(None, None).await.unwrap();\n\n let pending_txs =\n api.block_transaction_count_by_number(BlockNumberOrTag::Pending).await.unwrap().unwrap();\n assert_eq!(pending_txs.to::(), 0);\n let latest_txs =\n api.block_transaction_count_by_number(BlockNumberOrTag::Latest).await.unwrap().unwrap();\n assert_eq!(latest_txs.to::(), 1);\n let latest_block = api.block_by_number(BlockNumberOrTag::Latest).await.unwrap().unwrap();\n let latest_txs =\n api.block_transaction_count_by_hash(latest_block.header.hash).await.unwrap().unwrap();\n assert_eq!(latest_txs.to::(), 1);\n\n // check txs count on an older block: 420000 has 3 txs on mainnet\n let count_txs = api\n .block_transaction_count_by_number(BlockNumberOrTag::Number(420000))\n .await\n .unwrap()\n .unwrap();\n assert_eq!(count_txs.to::(), 3);\n let count_txs = api\n .block_transaction_count_by_hash(\n \"0xb3b0e3e0c64e23fb7f1ccfd29245ae423d2f6f1b269b63b70ff882a983ce317c\".parse().unwrap(),\n )\n .await\n .unwrap()\n .unwrap();\n assert_eq!(count_txs.to::(), 3);\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_impersonate_in_fork() {\n let (api, handle) = spawn(fork_config().with_fork_block_number(Some(15347924u64))).await;\n let provider = handle.http_provider();\n\n let token_holder: Address = \"0x2f0b23f53734252bda2277357e97e1517d6b042a\".parse().unwrap();\n let to = Address::random();\n let val = U256::from(1337u64);\n\n // fund the impersonated account\n api.anvil_set_balance(token_holder, U256::from(1e18)).await.unwrap();\n\n let tx = TransactionRequest::default().from(token_holder).to(to).value(val);\n let tx = WithOtherFields::new(tx);\n let res = provider.send_transaction(tx.clone()).await;\n res.unwrap_err();\n\n api.anvil_impersonate_account(token_holder).await.unwrap();\n\n let res = provider.send_transaction(tx.clone()).await.unwrap().get_receipt().await.unwrap();\n assert_eq!(res.from, token_holder);\n let status = res.inner.inner.inner.receipt.status.coerce_status();\n assert!(status);\n\n let balance = provider.get_balance(to).await.unwrap();\n assert_eq!(balance, val);\n\n api.anvil_stop_impersonating_account(token_holder).await.unwrap();\n let res = provider.send_transaction(tx).await;\n res.unwrap_err();\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\n#[ignore]\nasync fn test_total_difficulty_fork() {\n let (api, handle) = spawn(fork_config()).await;\n\n let total_difficulty = U256::from(46_673_965_560_973_856_260_636u128);\n let difficulty = U256::from(13_680_435_288_526_144u128);\n\n let provider = handle.http_provider();\n let block = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n assert_eq!(block.header.total_difficulty, Some(total_difficulty));\n assert_eq!(block.header.difficulty, difficulty);\n\n api.mine_one().await;\n api.mine_one().await;\n\n let next_total_difficulty = total_difficulty + difficulty;\n\n let block = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n assert_eq!(block.header.total_difficulty, Some(next_total_difficulty));\n assert_eq!(block.header.difficulty, U256::ZERO);\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_transaction_receipt() {\n let (api, _) = spawn(fork_config()).await;\n\n // A transaction from the forked block (14608400)\n let receipt = api\n .transaction_receipt(\n \"0xce495d665e9091613fd962351a5cbca27a992b919d6a87d542af97e2723ec1e4\".parse().unwrap(),\n )\n .await\n .unwrap();\n assert!(receipt.is_some());\n\n // A transaction from a block in the future (14608401)\n let receipt = api\n .transaction_receipt(\n \"0x1a15472088a4a97f29f2f9159511dbf89954b58d9816e58a32b8dc17171dc0e8\".parse().unwrap(),\n )\n .await\n .unwrap();\n assert!(receipt.is_none());\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_block_receipts() {\n let (api, _) = spawn(fork_config()).await;\n\n // Receipts from the forked block (14608400)\n let receipts = api.block_receipts(BlockNumberOrTag::Number(BLOCK_NUMBER).into()).await.unwrap();\n assert!(receipts.is_some());\n\n // Receipts from a block in the future (14608401)\n let receipts =\n api.block_receipts(BlockNumberOrTag::Number(BLOCK_NUMBER + 1).into()).await.unwrap();\n assert!(receipts.is_none());\n\n // Receipts from a block hash (14608400)\n let hash = b256!(\"0x4c1c76f89cfe4eb503b09a0993346dd82865cac9d76034efc37d878c66453f0a\");\n let receipts = api.block_receipts(BlockId::Hash(hash.into())).await.unwrap();\n assert!(receipts.is_some());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_override_fork_chain_id() {\n let chain_id_override = 5u64;\n let (_api, handle) = spawn(\n fork_config()\n .with_fork_block_number(Some(16506610u64))\n .with_chain_id(Some(chain_id_override)),\n )\n .await;\n\n let wallet = handle.dev_wallets().next().unwrap();\n let signer: EthereumWallet = wallet.into();\n let provider = http_provider_with_signer(&handle.http_endpoint(), signer);\n\n let greeter_contract =\n Greeter::deploy(provider.clone(), \"Hello World!\".to_string()).await.unwrap();\n let greeting = greeter_contract.greet().call().await.unwrap();\n\n assert_eq!(\"Hello World!\", greeting);\n let greeter_contract =\n Greeter::deploy(provider.clone(), \"Hello World!\".to_string()).await.unwrap();\n let greeting = greeter_contract.greet().call().await.unwrap();\n assert_eq!(\"Hello World!\", greeting);\n\n let provider = handle.http_provider();\n let chain_id = provider.get_chain_id().await.unwrap();\n assert_eq!(chain_id, chain_id_override);\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_reset_moonbeam() {\n crate::init_tracing();\n let (api, handle) = spawn(\n fork_config()\n .with_eth_rpc_url(Some(\"https://rpc.api.moonbeam.network\".to_string()))\n .with_fork_block_number(None::),\n )\n .await;\n let provider = handle.http_provider();\n\n let accounts: Vec<_> = handle.dev_wallets().collect();\n let from = accounts[0].address();\n\n let tx =\n TransactionRequest::default().to(Address::random()).value(U256::from(1337u64)).from(from);\n let tx = WithOtherFields::new(tx);\n api.anvil_impersonate_account(from).await.unwrap();\n let tx = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n let status = tx.inner.inner.inner.receipt.status.coerce_status();\n assert!(status);\n\n // reset to check timestamp works after resetting\n api.anvil_reset(Some(Forking {\n json_rpc_url: Some(\"https://rpc.api.moonbeam.network\".to_string()),\n block_number: None,\n }))\n .await\n .unwrap();\n\n let tx =\n TransactionRequest::default().to(Address::random()).value(U256::from(1337u64)).from(from);\n let tx = WithOtherFields::new(tx);\n let tx = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n let status = tx.inner.inner.inner.receipt.status.coerce_status();\n assert!(status);\n}\n\n// \n let (api, _handle) = spawn(fork_config().with_fork_block_number(Some(18835000u64))).await;\n\n api.mine_one().await;\n let latest = api.block_by_number(BlockNumberOrTag::Latest).await.unwrap().unwrap();\n\n // basefee of +1 block: \n assert_eq!(latest.header.base_fee_per_gas.unwrap(), 59455969592u64);\n\n // now reset to block 18835000 -1\n api.anvil_reset(Some(Forking { json_rpc_url: None, block_number: Some(18835000u64 - 1) }))\n .await\n .unwrap();\n\n api.mine_one().await;\n let latest = api.block_by_number(BlockNumberOrTag::Latest).await.unwrap().unwrap();\n\n // basefee of the forked block: \n assert_eq!(latest.header.base_fee_per_gas.unwrap(), 59017001138);\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn flaky_test_arbitrum_fork_dev_balance() {\n let (api, handle) = spawn(\n fork_config()\n .with_fork_block_number(None::)\n .with_eth_rpc_url(Some(next_rpc_endpoint(NamedChain::Arbitrum))),\n )\n .await;\n\n let accounts: Vec<_> = handle.dev_wallets().collect();\n for acc in accounts {\n let balance = api.balance(acc.address(), Some(Default::default())).await.unwrap();\n assert_eq!(balance, U256::from(100000000000000000000u128));\n }\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_arb_fork_mining() {\n let fork_block_number = 394274860u64;\n let fork_rpc = next_rpc_endpoint(NamedChain::Arbitrum);\n let (api, _handle) = spawn(\n fork_config()\n .with_fork_block_number(Some(fork_block_number))\n .with_eth_rpc_url(Some(fork_rpc)),\n )\n .await;\n\n let init_blk_num = api.block_number().unwrap().to::();\n\n // Mine one\n api.mine_one().await;\n let mined_blk_num = api.block_number().unwrap().to::();\n\n assert_eq!(mined_blk_num, init_blk_num + 1);\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn flaky_test_arbitrum_fork_block_number() {\n // fork to get initial block for test\n let (_, handle) = spawn(\n fork_config()\n .with_fork_block_number(None::)\n .with_eth_rpc_url(Some(next_rpc_endpoint(NamedChain::Arbitrum))),\n )\n .await;\n let provider = handle.http_provider();\n let initial_block_number = provider.get_block_number().await.unwrap();\n\n // fork again at block number returned by `eth_blockNumber`\n // if wrong block number returned (e.g. L1) then fork will fail with error code -32000: missing\n // trie node\n let (api, _) = spawn(\n fork_config()\n .with_fork_block_number(Some(initial_block_number))\n .with_eth_rpc_url(Some(next_rpc_endpoint(NamedChain::Arbitrum))),\n )\n .await;\n let block_number = api.block_number().unwrap().to::();\n assert_eq!(block_number, initial_block_number);\n\n // take snapshot at initial block number\n let snapshot_state = api.evm_snapshot().await.unwrap();\n\n // mine new block and check block number returned by `eth_blockNumber`\n api.mine_one().await;\n let block_number = api.block_number().unwrap().to::();\n assert_eq!(block_number, initial_block_number + 1);\n\n // test block by number API call returns proper block number and `l1BlockNumber` is set\n let block_by_number = api.block_by_number(BlockNumberOrTag::Latest).await.unwrap().unwrap();\n assert_eq!(block_by_number.header.number, initial_block_number + 1);\n assert!(block_by_number.other.get(\"l1BlockNumber\").is_some());\n\n // revert to recorded snapshot and check block number\n assert!(api.evm_revert(snapshot_state).await.unwrap());\n let block_number = api.block_number().unwrap().to::();\n assert_eq!(block_number, initial_block_number);\n\n // reset fork to different block number and compare with block returned by `eth_blockNumber`\n api.anvil_reset(Some(Forking {\n json_rpc_url: Some(next_rpc_endpoint(NamedChain::Arbitrum)),\n block_number: Some(initial_block_number - 2),\n }))\n .await\n .unwrap();\n let block_number = api.block_number().unwrap().to::();\n assert_eq!(block_number, initial_block_number - 2);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_base_fork_gas_limit() {\n // fork to get initial block for test\n let (api, handle) = spawn(\n fork_config()\n .with_fork_block_number(None::)\n .with_eth_rpc_url(Some(next_rpc_endpoint(NamedChain::Base))),\n )\n .await;\n\n let provider = handle.http_provider();\n let block =\n provider.get_block(BlockId::Number(BlockNumberOrTag::Latest)).await.unwrap().unwrap();\n\n assert!(api.gas_limit() >= uint!(96_000_000_U256));\n assert!(block.header.gas_limit >= 96_000_000_u64);\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_execution_reverted() {\n let target = 16681681u64;\n let (api, _handle) = spawn(fork_config().with_fork_block_number(Some(target + 1))).await;\n\n let resp = api\n .call(\n WithOtherFields::new(TransactionRequest {\n to: Some(TxKind::from(address!(\"0xFd6CC4F251eaE6d02f9F7B41D1e80464D3d2F377\"))),\n input: TransactionInput::new(bytes!(\"8f283b3c\")),\n ..Default::default()\n }),\n Some(target.into()),\n EvmOverrides::default(),\n )\n .await;\n\n assert!(resp.is_err());\n let err = resp.unwrap_err();\n assert!(err.to_string().contains(\"execution reverted\"));\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\n#[ignore]\nasync fn test_immutable_fork_transaction_hash() {\n use std::str::FromStr;\n\n // Fork to a block with a specific transaction\n // \n let fork_tx_hash =\n TxHash::from_str(\"2ac736ce725d628ef20569a1bb501726b42b33f9d171f60b92b69de3ce705845\")\n .unwrap();\n let (api, _) = spawn(\n fork_config()\n .with_blocktime(Some(Duration::from_millis(500)))\n .with_fork_transaction_hash(Some(fork_tx_hash))\n .with_eth_rpc_url(Some(\"https://immutable-zkevm.drpc.org\".to_string())),\n )\n .await;\n\n let fork_block_number = 21824325;\n\n // Make sure the fork starts from previous block\n let mut block_number = api.block_number().unwrap().to::();\n assert_eq!(block_number, fork_block_number - 1);\n\n // Wait for fork to pass the target block\n while block_number < fork_block_number {\n sleep(Duration::from_millis(250));\n block_number = api.block_number().unwrap().to::();\n }\n\n let block = api\n .block_by_number(BlockNumberOrTag::Number(fork_block_number - 1))\n .await\n .unwrap()\n .unwrap();\n assert_eq!(block.transactions.len(), 6);\n let block = api\n .block_by_number_full(BlockNumberOrTag::Number(fork_block_number))\n .await\n .unwrap()\n .unwrap();\n assert!(!block.transactions.is_empty());\n\n // Validate the transactions preceding the target transaction exist\n let expected_transactions = [\n TxHash::from_str(\"c900784c993221ba192c53a3ff9996f6af83a951100ceb93e750f7ef86bd43d5\")\n .unwrap(),\n TxHash::from_str(\"f86f001bbdf69f8f64ff8a4a5fc3e684cf3a7706f204eba8439752f6f67cd2c4\")\n .unwrap(),\n fork_tx_hash,\n ];\n for expected in [\n (expected_transactions[0], address!(\"0x0a02a416f87a13626dda0ad386859497565222aa\")),\n (expected_transactions[1], address!(\"0x0a02a416f87a13626dda0ad386859497565222aa\")),\n (expected_transactions[2], address!(\"0x4f07d669d76ed9a17799fc4c04c4005196240940\")),\n ] {\n let tx = api.backend.mined_transaction_by_hash(expected.0).unwrap();\n assert_eq!(tx.inner.inner.signer(), expected.1);\n }\n\n // Validate the order of transactions in the new block\n for expected in [\n (expected_transactions[0], 0),\n (expected_transactions[1], 1),\n (expected_transactions[2], 2),\n ] {\n let tx = api\n .backend\n .mined_block_by_number(BlockNumberOrTag::Number(fork_block_number))\n .map(|b| b.header.hash)\n .and_then(|hash| {\n api.backend.mined_transaction_by_block_hash_and_index(hash, expected.1.into())\n })\n .unwrap();\n assert_eq!(tx.tx_hash().to_string(), expected.0.to_string());\n }\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_query_at_fork_block() {\n let (api, handle) = spawn(fork_config()).await;\n let provider = handle.http_provider();\n let info = api.anvil_node_info().await.unwrap();\n let number = info.fork_config.fork_block_number.unwrap();\n assert_eq!(number, BLOCK_NUMBER);\n\n let address = Address::random();\n\n let balance = provider.get_balance(address).await.unwrap();\n api.evm_mine(None).await.unwrap();\n api.anvil_set_balance(address, balance + U256::from(1)).await.unwrap();\n\n let balance_before =\n provider.get_balance(address).block_id(BlockId::number(number)).await.unwrap();\n\n assert_eq!(balance_before, balance);\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_reset_dev_account_nonce() {\n let config: NodeConfig = fork_config();\n let address = config.genesis_accounts[0].address();\n let (api, handle) = spawn(config).await;\n let provider = handle.http_provider();\n let info = api.anvil_node_info().await.unwrap();\n let number = info.fork_config.fork_block_number.unwrap();\n assert_eq!(number, BLOCK_NUMBER);\n\n let nonce_before = provider.get_transaction_count(address).await.unwrap();\n\n // Reset to older block with other nonce\n api.anvil_reset(Some(Forking {\n json_rpc_url: None,\n block_number: Some(BLOCK_NUMBER - 1_000_000),\n }))\n .await\n .unwrap();\n\n let nonce_after = provider.get_transaction_count(address).await.unwrap();\n\n assert!(nonce_before > nonce_after);\n\n let receipt = provider\n .send_transaction(WithOtherFields::new(\n TransactionRequest::default()\n .from(address)\n .to(address)\n .nonce(nonce_after)\n .gas_limit(21000),\n ))\n .await\n .unwrap()\n .get_receipt()\n .await\n .unwrap();\n\n assert!(receipt.status());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_set_erc20_balance() {\n let config: NodeConfig = fork_config();\n let address = config.genesis_accounts[0].address();\n let (api, handle) = spawn(config).await;\n\n let provider = handle.http_provider();\n\n alloy_sol_types::sol! {\n #[sol(rpc)]\n contract ERC20 {\n function balanceOf(address owner) public view returns (uint256);\n }\n }\n let dai = address!(\"0x6B175474E89094C44Da98b954EedeAC495271d0F\");\n let erc20 = ERC20::new(dai, provider);\n let value = U256::from(500);\n\n api.anvil_deal_erc20(address, dai, value).await.unwrap();\n\n let new_balance = erc20.balanceOf(address).call().await.unwrap();\n\n assert_eq!(new_balance, value);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_set_erc20_allowance() {\n let config: NodeConfig = fork_config();\n let owner = config.genesis_accounts[0].address();\n let spender = config.genesis_accounts[1].address();\n let (api, handle) = spawn(config).await;\n\n let provider = handle.http_provider();\n\n alloy_sol_types::sol! {\n #[sol(rpc)]\n contract ERC20 {\n function allowance(address owner, address spender) external view returns (uint256);\n }\n }\n let dai = address!(\"0x6B175474E89094C44Da98b954EedeAC495271d0F\");\n let erc20 = ERC20::new(dai, provider);\n let value = U256::from(500);\n\n api.anvil_set_erc20_allowance(owner, spender, dai, value).await.unwrap();\n\n let allowance = erc20.allowance(owner, spender).call().await.unwrap();\n assert_eq!(allowance, value);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_add_balance() {\n let config: NodeConfig = fork_config();\n let address = config.genesis_accounts[0].address();\n let (api, _handle) = spawn(config).await;\n\n let start_balance = U256::from(100_000_u64);\n api.anvil_set_balance(address, start_balance).await.unwrap();\n\n let balance_increase = U256::from(50_000_u64);\n api.anvil_add_balance(address, balance_increase).await.unwrap();\n\n let new_balance = api.balance(address, None).await.unwrap();\n assert_eq!(new_balance, start_balance + balance_increase);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_reset_updates_cache_path_when_rpc_url_not_provided() {\n let config: NodeConfig = fork_config();\n\n let (mut api, _handle) = spawn(config).await;\n let info = api.anvil_node_info().await.unwrap();\n let number = info.fork_config.fork_block_number.unwrap();\n assert_eq!(number, BLOCK_NUMBER);\n\n async fn get_block_from_cache_path(api: &mut EthApi) -> u64 {\n let db = api.backend.get_db().read().await;\n let cache_path = db.maybe_inner().unwrap().cache().cache_path().unwrap();\n cache_path\n .parent()\n .expect(\"must have filename\")\n .file_name()\n .expect(\"must have block number as dir name\")\n .to_str()\n .expect(\"must be valid string\")\n .parse::()\n .expect(\"must be valid number\")\n }\n\n assert_eq!(BLOCK_NUMBER, get_block_from_cache_path(&mut api).await);\n\n // Reset to older block without specifying a new rpc url\n api.anvil_reset(Some(Forking {\n json_rpc_url: None,\n block_number: Some(BLOCK_NUMBER - 1_000_000),\n }))\n .await\n .unwrap();\n\n assert_eq!(BLOCK_NUMBER - 1_000_000, get_block_from_cache_path(&mut api).await);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_get_account() {\n let (_api, handle) = spawn(fork_config()).await;\n let provider = handle.http_provider();\n\n let accounts = handle.dev_accounts().collect::>();\n\n let alice = accounts[0];\n let bob = accounts[1];\n\n let init_block = provider.get_block_number().await.unwrap();\n let alice_bal = provider.get_balance(alice).await.unwrap();\n let alice_nonce = provider.get_transaction_count(alice).await.unwrap();\n let alice_acc_init = provider.get_account(alice).await.unwrap();\n\n assert_eq!(alice_acc_init.balance, alice_bal);\n assert_eq!(alice_acc_init.nonce, alice_nonce);\n\n let tx = TransactionRequest::default().from(alice).to(bob).value(U256::from(142));\n\n let tx = WithOtherFields::new(tx);\n let receipt = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n assert!(receipt.status());\n assert_eq!(init_block + 1, receipt.block_number.unwrap());\n\n let alice_acc = provider.get_account(alice).await.unwrap();\n\n assert_eq!(\n alice_acc.balance,\n alice_bal\n - (U256::from(142)\n + U256::from(receipt.gas_used as u128 * receipt.effective_gas_price)),\n );\n assert_eq!(alice_acc.nonce, alice_nonce + 1);\n\n let alice_acc_prev_block = provider.get_account(alice).number(init_block).await.unwrap();\n\n assert_eq!(alice_acc_init, alice_acc_prev_block);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_get_account_info() {\n let (api, handle) = spawn(fork_config()).await;\n let provider = handle.http_provider();\n\n let info = provider\n .get_account_info(address!(\"0x19e53a7397bE5AA7908fE9eA991B03710bdC74Fd\"))\n // predates fork\n .number(BLOCK_NUMBER - 1)\n .await\n .unwrap();\n assert_eq!(\n info,\n AccountInfo {\n balance: U256::from(14353753764795095694u64),\n nonce: 6689,\n code: Default::default(),\n }\n );\n\n // Check account info at block number, see https://github.com/foundry-rs/foundry/issues/12072\n let info = provider\n .get_account_info(address!(\"0x19e53a7397bE5AA7908fE9eA991B03710bdC74Fd\"))\n // predates fork\n .number(BLOCK_NUMBER)\n .await\n .unwrap();\n assert_eq!(\n info,\n AccountInfo {\n balance: U256::from(14352720829244098514u64),\n nonce: 6690,\n code: Default::default(),\n }\n );\n\n // Mine and check account info at new block number, see https://github.com/foundry-rs/foundry/issues/12148\n api.evm_mine(None).await.unwrap();\n let info = provider\n .get_account_info(address!(\"0x19e53a7397bE5AA7908fE9eA991B03710bdC74Fd\"))\n // predates fork\n .number(BLOCK_NUMBER + 1)\n .await\n .unwrap();\n assert_eq!(\n info,\n AccountInfo {\n balance: U256::from(14352720829244098514u64),\n nonce: 6690,\n code: Default::default(),\n }\n );\n}\n\nfn assert_hardfork_config(\n config: &EthConfig,\n expected_blob_params: &BlobParams,\n expected_precompiles: &[Address],\n expected_system_contracts: &BTreeMap,\n) {\n assert!(config.next.is_none());\n assert!(config.last.is_none());\n\n let current = &config.current;\n\n assert_eq!(current.activation_time, 0);\n assert_eq!(current.chain_id, 31337);\n assert_eq!(current.fork_id, Bytes::from(vec![0, 0, 0, 0]));\n\n assert_eq!(¤t.blob_schedule, expected_blob_params);\n\n assert_eq!(\n current.precompiles.values().copied().collect::>(),\n expected_precompiles.iter().copied().collect::>(),\n );\n\n assert_eq!(current.system_contracts, *expected_system_contracts);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_config_with_cancun_hardfork() {\n let (api, _handle) =\n spawn(NodeConfig::test().with_hardfork(Some(EthereumHardfork::Cancun.into()))).await;\n\n let config = api.config().unwrap();\n\n let expected_blob_params = BlobParams {\n target_blob_count: 3,\n max_blob_count: 6,\n update_fraction: 3338477,\n min_blob_fee: 1,\n max_blobs_per_tx: 6,\n blob_base_cost: 0,\n };\n\n // <= Cancun precompiles\n let expected_precompiles = [\n address!(\"0000000000000000000000000000000000000001\"),\n address!(\"0000000000000000000000000000000000000002\"),\n address!(\"0000000000000000000000000000000000000003\"),\n address!(\"0000000000000000000000000000000000000004\"),\n address!(\"0000000000000000000000000000000000000005\"),\n address!(\"0000000000000000000000000000000000000006\"),\n address!(\"0000000000000000000000000000000000000007\"),\n address!(\"0000000000000000000000000000000000000008\"),\n address!(\"0000000000000000000000000000000000000009\"),\n address!(\"000000000000000000000000000000000000000a\"),\n ];\n\n let expected_system_contracts = BTreeMap::from([(\n SystemContract::BeaconRoots,\n address!(\"000f3df6d732807ef1319fb7b8bb8522d0beac02\"),\n )]);\n\n assert_hardfork_config(\n &config,\n &expected_blob_params,\n &expected_precompiles,\n &expected_system_contracts,\n );\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_config_with_prague_hardfork_with_celo() {\n let (api, _handle) = spawn(\n NodeConfig::test()\n .with_hardfork(Some(EthereumHardfork::Prague.into()))\n .with_networks(NetworkConfigs::with_celo()),\n )\n .await;\n\n let config = api.config().unwrap();\n\n let expected_blob_params = BlobParams {\n target_blob_count: 6,\n max_blob_count: 9,\n update_fraction: 5007716,\n min_blob_fee: 1,\n max_blobs_per_tx: 9,\n blob_base_cost: 0,\n };\n\n // <= Prague + Celo precompiles\n let expected_precompiles = [\n address!(\"0000000000000000000000000000000000000001\"),\n address!(\"0000000000000000000000000000000000000002\"),\n address!(\"0000000000000000000000000000000000000003\"),\n address!(\"0000000000000000000000000000000000000004\"),\n address!(\"0000000000000000000000000000000000000005\"),\n address!(\"0000000000000000000000000000000000000006\"),\n address!(\"0000000000000000000000000000000000000007\"),\n address!(\"0000000000000000000000000000000000000008\"),\n address!(\"0000000000000000000000000000000000000009\"),\n address!(\"000000000000000000000000000000000000000a\"),\n address!(\"000000000000000000000000000000000000000b\"),\n address!(\"000000000000000000000000000000000000000c\"),\n address!(\"000000000000000000000000000000000000000d\"),\n address!(\"000000000000000000000000000000000000000e\"),\n address!(\"000000000000000000000000000000000000000f\"),\n address!(\"0000000000000000000000000000000000000010\"),\n address!(\"0000000000000000000000000000000000000011\"),\n address!(\"00000000000000000000000000000000000000fd\"), // `celo transfer`\n ];\n\n let expected_system_contracts = BTreeMap::from([\n (SystemContract::BeaconRoots, address!(\"000f3df6d732807ef1319fb7b8bb8522d0beac02\")),\n (\n SystemContract::ConsolidationRequestPredeploy,\n address!(\"0000bbddc7ce488642fb579f8b00f3a590007251\"),\n ),\n (SystemContract::DepositContract, address!(\"00000000219ab540356cbb839cbe05303d7705fa\")),\n (SystemContract::HistoryStorage, address!(\"0000f90827f1c53a10cb7a02335b175320002935\")),\n (\n SystemContract::WithdrawalRequestPredeploy,\n address!(\"00000961ef480eb55e80d19ad83579a64c007002\"),\n ),\n ]);\n\n assert_hardfork_config(\n &config,\n &expected_blob_params,\n &expected_precompiles,\n &expected_system_contracts,\n );\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_config_with_osaka_hardfork() {\n let (api, _handle) =\n spawn(NodeConfig::test().with_hardfork(Some(EthereumHardfork::Osaka.into()))).await;\n\n let config = api.config().unwrap();\n\n let expected_blob_params = BlobParams {\n target_blob_count: 6,\n max_blob_count: 9,\n update_fraction: 5007716,\n min_blob_fee: 1,\n max_blobs_per_tx: 6,\n blob_base_cost: 8192,\n };\n\n // <= Osaka precompiles\n let expected_precompiles = [\n address!(\"0000000000000000000000000000000000000001\"),\n address!(\"0000000000000000000000000000000000000002\"),\n address!(\"0000000000000000000000000000000000000003\"),\n address!(\"0000000000000000000000000000000000000004\"),\n address!(\"0000000000000000000000000000000000000005\"),\n address!(\"0000000000000000000000000000000000000006\"),\n address!(\"0000000000000000000000000000000000000007\"),\n address!(\"0000000000000000000000000000000000000008\"),\n address!(\"0000000000000000000000000000000000000009\"),\n address!(\"000000000000000000000000000000000000000a\"),\n address!(\"000000000000000000000000000000000000000b\"),\n address!(\"000000000000000000000000000000000000000c\"),\n address!(\"000000000000000000000000000000000000000d\"),\n address!(\"000000000000000000000000000000000000000e\"),\n address!(\"000000000000000000000000000000000000000f\"),\n address!(\"0000000000000000000000000000000000000010\"),\n address!(\"0000000000000000000000000000000000000011\"),\n address!(\"0000000000000000000000000000000000000100\"),\n ];\n\n let expected_system_contracts = BTreeMap::from([\n (SystemContract::BeaconRoots, address!(\"000f3df6d732807ef1319fb7b8bb8522d0beac02\")),\n (\n SystemContract::ConsolidationRequestPredeploy,\n address!(\"0000bbddc7ce488642fb579f8b00f3a590007251\"),\n ),\n (SystemContract::DepositContract, address!(\"00000000219ab540356cbb839cbe05303d7705fa\")),\n (SystemContract::HistoryStorage, address!(\"0000f90827f1c53a10cb7a02335b175320002935\")),\n (\n SystemContract::WithdrawalRequestPredeploy,\n address!(\"00000961ef480eb55e80d19ad83579a64c007002\"),\n ),\n ]);\n\n assert_hardfork_config(\n &config,\n &expected_blob_params,\n &expected_precompiles,\n &expected_system_contracts,\n );\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_config_with_osaka_hardfork_with_precompile_factory() {\n #[derive(Debug)]\n struct CustomPrecompileFactory;\n\n impl PrecompileFactory for CustomPrecompileFactory {\n fn precompiles(&self) -> Vec<(Address, alloy_evm::precompiles::DynPrecompile)> {\n vec![(\n address!(\"0x0000000000000000000000000000000000000071\"),\n alloy_evm::precompiles::DynPrecompile::from(\n |input: alloy_evm::precompiles::PrecompileInput<'_>| {\n Ok(revm::precompile::PrecompileOutput {\n bytes: Bytes::copy_from_slice(input.data),\n gas_used: 0,\n gas_refunded: 0,\n reverted: false,\n })\n },\n ),\n )]\n }\n }\n\n let (api, _handle) = spawn(\n NodeConfig::test()\n .with_hardfork(Some(EthereumHardfork::Osaka.into()))\n .with_precompile_factory(CustomPrecompileFactory),\n )\n .await;\n\n let config = api.config().unwrap();\n\n let expected_blob_params = BlobParams {\n target_blob_count: 6,\n max_blob_count: 9,\n update_fraction: 5007716,\n min_blob_fee: 1,\n max_blobs_per_tx: 6,\n blob_base_cost: 8192,\n };\n\n // <= Osaka precompiles + custom precompile\n let expected_precompiles = [\n address!(\"0000000000000000000000000000000000000001\"),\n address!(\"0000000000000000000000000000000000000002\"),\n address!(\"0000000000000000000000000000000000000003\"),\n address!(\"0000000000000000000000000000000000000004\"),\n address!(\"0000000000000000000000000000000000000005\"),\n address!(\"0000000000000000000000000000000000000006\"),\n address!(\"0000000000000000000000000000000000000007\"),\n address!(\"0000000000000000000000000000000000000008\"),\n address!(\"0000000000000000000000000000000000000009\"),\n address!(\"000000000000000000000000000000000000000a\"),\n address!(\"000000000000000000000000000000000000000b\"),\n address!(\"000000000000000000000000000000000000000c\"),\n address!(\"000000000000000000000000000000000000000d\"),\n address!(\"000000000000000000000000000000000000000e\"),\n address!(\"000000000000000000000000000000000000000f\"),\n address!(\"0000000000000000000000000000000000000010\"),\n address!(\"0000000000000000000000000000000000000011\"),\n address!(\"0000000000000000000000000000000000000071\"), // `custom_echo`\n address!(\"0000000000000000000000000000000000000100\"),\n ];\n let expected_system_contracts = BTreeMap::from([\n (SystemContract::BeaconRoots, address!(\"000f3df6d732807ef1319fb7b8bb8522d0beac02\")),\n (\n SystemContract::ConsolidationRequestPredeploy,\n address!(\"0000bbddc7ce488642fb579f8b00f3a590007251\"),\n ),\n (SystemContract::DepositContract, address!(\"00000000219ab540356cbb839cbe05303d7705fa\")),\n (SystemContract::HistoryStorage, address!(\"0000f90827f1c53a10cb7a02335b175320002935\")),\n (\n SystemContract::WithdrawalRequestPredeploy,\n address!(\"00000961ef480eb55e80d19ad83579a64c007002\"),\n ),\n ]);\n\n assert_hardfork_config(\n &config,\n &expected_blob_params,\n &expected_precompiles,\n &expected_system_contracts,\n );\n}\n" }, { "path": "crates/anvil/tests/it/gas.rs", "content": "//! Gas related tests\n\nuse crate::utils::http_provider_with_signer;\nuse alloy_network::{EthereumWallet, TransactionBuilder};\nuse alloy_primitives::{Address, U64, U256, uint};\nuse alloy_provider::Provider;\nuse alloy_rpc_types::{BlockId, TransactionRequest};\nuse alloy_serde::WithOtherFields;\nuse anvil::{NodeConfig, eth::fees::INITIAL_BASE_FEE, spawn};\n\nconst GAS_TRANSFER: u64 = 21_000;\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_gas_limit_applied_from_config() {\n let (api, _handle) = spawn(NodeConfig::test().with_gas_limit(Some(10_000_000))).await;\n\n assert_eq!(api.gas_limit(), uint!(10_000_000_U256));\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_gas_limit_disabled_from_config() {\n let (api, _handle) = spawn(NodeConfig::test().disable_block_gas_limit(true)).await;\n\n // see https://github.com/foundry-rs/foundry/pull/8933\n assert_eq!(api.gas_limit(), U256::from(U64::MAX));\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_basefee_full_block() {\n let (_api, handle) = spawn(\n NodeConfig::test().with_base_fee(Some(INITIAL_BASE_FEE)).with_gas_limit(Some(GAS_TRANSFER)),\n )\n .await;\n\n let wallet = handle.dev_wallets().next().unwrap();\n let signer: EthereumWallet = wallet.clone().into();\n\n let provider = http_provider_with_signer(&handle.http_endpoint(), signer);\n\n let tx = TransactionRequest::default().to(Address::random()).with_value(U256::from(1337));\n let tx = WithOtherFields::new(tx);\n\n provider.send_transaction(tx.clone()).await.unwrap().get_receipt().await.unwrap();\n\n let base_fee = provider\n .get_block(BlockId::latest())\n .await\n .unwrap()\n .unwrap()\n .header\n .base_fee_per_gas\n .unwrap();\n\n provider.send_transaction(tx.clone()).await.unwrap().get_receipt().await.unwrap();\n\n let next_base_fee = provider\n .get_block(BlockId::latest())\n .await\n .unwrap()\n .unwrap()\n .header\n .base_fee_per_gas\n .unwrap();\n\n assert!(next_base_fee > base_fee);\n\n // max increase, full block\n assert_eq!(next_base_fee, INITIAL_BASE_FEE + 125_000_000);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_basefee_half_block() {\n let (_api, handle) = spawn(\n NodeConfig::test()\n .with_base_fee(Some(INITIAL_BASE_FEE))\n .with_gas_limit(Some(GAS_TRANSFER * 2)),\n )\n .await;\n\n let wallet = handle.dev_wallets().next().unwrap();\n let signer: EthereumWallet = wallet.clone().into();\n\n let provider = http_provider_with_signer(&handle.http_endpoint(), signer);\n\n let tx = TransactionRequest::default().to(Address::random()).with_value(U256::from(1337));\n let tx = WithOtherFields::new(tx);\n\n provider.send_transaction(tx.clone()).await.unwrap().get_receipt().await.unwrap();\n\n let tx = TransactionRequest::default().to(Address::random()).with_value(U256::from(1337));\n let tx = WithOtherFields::new(tx);\n\n provider.send_transaction(tx.clone()).await.unwrap().get_receipt().await.unwrap();\n\n let next_base_fee = provider\n .get_block(BlockId::latest())\n .await\n .unwrap()\n .unwrap()\n .header\n .base_fee_per_gas\n .unwrap();\n\n // unchanged, half block\n assert_eq!(next_base_fee, { INITIAL_BASE_FEE });\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_basefee_empty_block() {\n let (api, handle) = spawn(NodeConfig::test().with_base_fee(Some(INITIAL_BASE_FEE))).await;\n\n let wallet = handle.dev_wallets().next().unwrap();\n let signer: EthereumWallet = wallet.clone().into();\n\n let provider = http_provider_with_signer(&handle.http_endpoint(), signer);\n\n let tx = TransactionRequest::default().with_to(Address::random()).with_value(U256::from(1337));\n let tx = WithOtherFields::new(tx);\n\n provider.send_transaction(tx.clone()).await.unwrap().get_receipt().await.unwrap();\n\n let base_fee = provider\n .get_block(BlockId::latest())\n .await\n .unwrap()\n .unwrap()\n .header\n .base_fee_per_gas\n .unwrap();\n\n // mine empty block\n api.mine_one().await;\n\n let next_base_fee = provider\n .get_block(BlockId::latest())\n .await\n .unwrap()\n .unwrap()\n .header\n .base_fee_per_gas\n .unwrap();\n\n // empty block, decreased base fee\n assert!(next_base_fee < base_fee);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_respect_base_fee() {\n let base_fee = 50u128;\n let (_api, handle) = spawn(NodeConfig::test().with_base_fee(Some(base_fee as u64))).await;\n\n let provider = handle.http_provider();\n\n let tx = TransactionRequest::default().with_to(Address::random()).with_value(U256::from(100));\n let mut tx = WithOtherFields::new(tx);\n\n let mut underpriced = tx.clone();\n underpriced.set_gas_price(base_fee - 1);\n\n let res = provider.send_transaction(underpriced).await;\n assert!(res.is_err());\n assert!(res.unwrap_err().to_string().contains(\"max fee per gas less than block base fee\"));\n\n tx.set_gas_price(base_fee);\n provider.send_transaction(tx.clone()).await.unwrap().get_receipt().await.unwrap();\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_tip_above_fee_cap() {\n let base_fee = 50u128;\n let (_api, handle) = spawn(NodeConfig::test().with_base_fee(Some(base_fee as u64))).await;\n\n let provider = handle.http_provider();\n\n let tx = TransactionRequest::default()\n .max_fee_per_gas(base_fee)\n .max_priority_fee_per_gas(base_fee + 1)\n .with_to(Address::random())\n .with_value(U256::from(100));\n let tx = WithOtherFields::new(tx);\n\n let res = provider.send_transaction(tx.clone()).await;\n assert!(res.is_err());\n assert!(\n res.unwrap_err()\n .to_string()\n .contains(\"max priority fee per gas higher than max fee per gas\")\n );\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_can_use_fee_history() {\n let base_fee = 50u128;\n let (_api, handle) = spawn(NodeConfig::test().with_base_fee(Some(base_fee as u64))).await;\n let provider = handle.http_provider();\n\n for _ in 0..10 {\n let fee_history = provider.get_fee_history(1, Default::default(), &[]).await.unwrap();\n let next_base_fee = *fee_history.base_fee_per_gas.last().unwrap();\n\n let tx = TransactionRequest::default()\n .with_to(Address::random())\n .with_value(U256::from(100))\n .with_gas_price(next_base_fee);\n let tx = WithOtherFields::new(tx);\n\n let receipt =\n provider.send_transaction(tx.clone()).await.unwrap().get_receipt().await.unwrap();\n assert!(receipt.inner.inner.is_success());\n\n let fee_history_after = provider.get_fee_history(1, Default::default(), &[]).await.unwrap();\n let latest_fee_history_fee = *fee_history_after.base_fee_per_gas.first().unwrap() as u64;\n let latest_block = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n\n assert_eq!(latest_block.header.base_fee_per_gas.unwrap(), latest_fee_history_fee);\n assert_eq!(latest_fee_history_fee, next_base_fee as u64);\n }\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_estimate_gas_empty_data() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let accounts = handle.dev_accounts().collect::>();\n let from = accounts[0];\n let to = accounts[1];\n\n let tx_without_data =\n TransactionRequest::default().with_from(from).with_to(to).with_value(U256::from(1));\n\n let gas_without_data = api\n .estimate_gas(WithOtherFields::new(tx_without_data), None, Default::default())\n .await\n .unwrap();\n\n let tx_with_empty_data = TransactionRequest::default()\n .with_from(from)\n .with_to(to)\n .with_value(U256::from(1))\n .with_input(vec![]);\n\n let gas_with_empty_data = api\n .estimate_gas(WithOtherFields::new(tx_with_empty_data), None, Default::default())\n .await\n .unwrap();\n\n let tx_with_data = TransactionRequest::default()\n .with_from(from)\n .with_to(to)\n .with_value(U256::from(1))\n .with_input(vec![0x12, 0x34]);\n\n let gas_with_data = api\n .estimate_gas(WithOtherFields::new(tx_with_data), None, Default::default())\n .await\n .unwrap();\n\n assert_eq!(gas_without_data, U256::from(GAS_TRANSFER));\n assert_eq!(gas_with_empty_data, U256::from(GAS_TRANSFER));\n assert!(gas_with_data > U256::from(GAS_TRANSFER));\n assert_eq!(gas_without_data, gas_with_empty_data);\n}\n" }, { "path": "crates/anvil/tests/it/genesis.rs", "content": "//! genesis.json tests\n\nuse crate::fork::fork_config;\nuse alloy_genesis::Genesis;\nuse alloy_primitives::{Address, U256};\nuse alloy_provider::Provider;\nuse anvil::{NodeConfig, spawn};\nuse std::str::FromStr;\n\nconst GENESIS: &str = r#\"{\n \"config\": {\n \"chainId\": 19763,\n \"homesteadBlock\": 0,\n \"eip150Block\": 0,\n \"eip155Block\": 0,\n \"eip158Block\": 0,\n \"byzantiumBlock\": 0,\n \"ethash\": {}\n },\n \"nonce\": \"0xdeadbeefdeadbeef\",\n \"timestamp\": \"0x0\",\n \"extraData\": \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"gasLimit\": \"0x80000000\",\n \"difficulty\": \"0x20000\",\n \"mixHash\": \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"coinbase\": \"0x0000000000000000000000000000000000000000\",\n \"alloc\": {\n \"71562b71999873db5b286df957af199ec94617f7\": {\n \"balance\": \"0xffffffffffffffffffffffffff\"\n }\n },\n \"number\": 73,\n \"gasUsed\": \"0x0\",\n \"parentHash\": \"0x0000000000000000000000000000000000000000000000000000000000000000\"\n}\n\"#;\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_apply_genesis() {\n let genesis: Genesis = serde_json::from_str(GENESIS).unwrap();\n let (_api, handle) = spawn(NodeConfig::test().with_genesis(Some(genesis))).await;\n\n let provider = handle.http_provider();\n\n assert_eq!(provider.get_chain_id().await.unwrap(), 19763u64);\n\n let addr: Address = Address::from_str(\"71562b71999873db5b286df957af199ec94617f7\").unwrap();\n let balance = provider.get_balance(addr).await.unwrap();\n\n let expected: U256 = U256::from_str_radix(\"ffffffffffffffffffffffffff\", 16).unwrap();\n assert_eq!(balance, expected);\n\n let block_number = provider.get_block_number().await.unwrap();\n assert_eq!(block_number, 73u64);\n}\n\n// \n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn chain_id_precedence() {\n // Order: --chain-id > fork-chain-id > Genesis > default.\n\n // --chain-id > Genesis.\n let genesis: Genesis = serde_json::from_str(GENESIS).unwrap();\n let (_api, handle) =\n spawn(NodeConfig::test().with_genesis(Some(genesis.clone())).with_chain_id(Some(300u64)))\n .await;\n let provider = handle.http_provider();\n let chain_id = provider.get_chain_id().await.unwrap();\n assert_eq!(chain_id, 300u64);\n\n // fork > Genesis.\n let (_api, handle) = spawn(fork_config().with_genesis(Some(genesis.clone()))).await;\n let provider = handle.http_provider();\n let chain_id = provider.get_chain_id().await.unwrap();\n assert_eq!(chain_id, 1);\n\n // --chain-id > fork.\n let (_api, handle) = spawn(fork_config().with_chain_id(Some(300u64))).await;\n let provider = handle.http_provider();\n let chain_id = provider.get_chain_id().await.unwrap();\n assert_eq!(chain_id, 300u64);\n\n // fork\n let (_api, handle) = spawn(fork_config()).await;\n let provider = handle.http_provider();\n let chain_id = provider.get_chain_id().await.unwrap();\n assert_eq!(chain_id, 1);\n\n // Genesis\n let (_api, handle) = spawn(NodeConfig::test().with_genesis(Some(genesis))).await;\n let provider = handle.http_provider();\n let chain_id = provider.get_chain_id().await.unwrap();\n assert_eq!(chain_id, 19763u64);\n\n // default\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n let chain_id = provider.get_chain_id().await.unwrap();\n assert_eq!(chain_id, 31337);\n}\n" }, { "path": "crates/anvil/tests/it/ipc.rs", "content": "//! IPC tests\n\nuse crate::{init_tracing, utils::connect_pubsub};\nuse alloy_primitives::U256;\nuse alloy_provider::Provider;\nuse anvil::{NodeConfig, spawn};\nuse futures::StreamExt;\nuse tempfile::TempDir;\n\nfn ipc_config() -> (Option, NodeConfig) {\n let path;\n let dir;\n if cfg!(unix) {\n let tmp = tempfile::tempdir().unwrap();\n path = tmp.path().join(\"anvil.ipc\").to_string_lossy().into_owned();\n dir = Some(tmp);\n } else {\n dir = None;\n path = format!(r\"\\\\.\\pipe\\anvil_test_{}.ipc\", rand::random::());\n }\n let config = NodeConfig::test().with_ipc(Some(Some(path)));\n (dir, config)\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_get_block_number_ipc() {\n init_tracing();\n\n let (_dir, config) = ipc_config();\n let (api, handle) = spawn(config).await;\n\n let block_num = api.block_number().unwrap();\n assert_eq!(block_num, U256::ZERO);\n\n let provider = handle.ipc_provider().unwrap();\n\n let num = provider.get_block_number().await.unwrap();\n assert_eq!(num, block_num.to::());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_sub_new_heads_ipc() {\n init_tracing();\n\n let (_dir, config) = ipc_config();\n let (api, handle) = spawn(config).await;\n\n let provider = connect_pubsub(handle.ipc_path().unwrap().as_str()).await;\n // mine a block every 1 seconds\n api.anvil_set_interval_mining(1).unwrap();\n\n let blocks = provider.subscribe_blocks().await.unwrap().into_stream();\n\n let blocks = blocks.take(3).collect::>().await;\n let block_numbers = blocks.into_iter().map(|b| b.number).collect::>();\n\n assert_eq!(block_numbers, vec![1, 2, 3]);\n}\n" }, { "path": "crates/anvil/tests/it/logs.rs", "content": "//! log/event related tests\n\nuse crate::{\n abi::SimpleStorage::{self},\n utils::{http_provider_with_signer, ws_provider_with_signer},\n};\nuse alloy_network::EthereumWallet;\nuse alloy_primitives::{B256, map::B256HashSet};\nuse alloy_provider::Provider;\nuse alloy_rpc_types::{BlockNumberOrTag, Filter};\nuse anvil::{NodeConfig, spawn};\nuse futures::StreamExt;\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn get_past_events() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n\n let wallet = handle.dev_wallets().next().unwrap();\n let account = wallet.address();\n let signer: EthereumWallet = wallet.into();\n\n let provider = http_provider_with_signer(&handle.http_endpoint(), signer);\n\n let contract =\n SimpleStorage::deploy(provider.clone(), \"initial value\".to_string()).await.unwrap();\n let _ = contract\n .setValue(\"hi\".to_string())\n .from(account)\n .send()\n .await\n .unwrap()\n .get_receipt()\n .await\n .unwrap();\n let simple_storage_address = *contract.address();\n\n let filter = Filter::new()\n .address(simple_storage_address)\n .topic1(B256::from(account.into_word()))\n .from_block(BlockNumberOrTag::from(0));\n\n let logs = provider\n .get_logs(&filter)\n .await\n .unwrap()\n .into_iter()\n .map(|log| log.log_decode::().unwrap())\n .collect::>();\n\n // 2 events, 1 in constructor, 1 in call\n assert_eq!(logs[0].inner.newValue, \"initial value\");\n assert_eq!(logs[1].inner.newValue, \"hi\");\n assert_eq!(logs.len(), 2);\n\n // and we can fetch the events at a block hash\n // let hash = provider.get_block(1).await.unwrap().unwrap().hash.unwrap();\n let hash =\n provider.get_block_by_number(BlockNumberOrTag::from(1)).await.unwrap().unwrap().header.hash;\n\n let filter = Filter::new()\n .address(simple_storage_address)\n .topic1(B256::from(account.into_word()))\n .at_block_hash(hash);\n\n let logs = provider\n .get_logs(&filter)\n .await\n .unwrap()\n .into_iter()\n .map(|log| log.log_decode::().unwrap())\n .collect::>();\n\n assert_eq!(logs[0].inner.newValue, \"initial value\");\n assert_eq!(logs.len(), 1);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn get_all_events() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n let wallet = handle.dev_wallets().next().unwrap();\n let account = wallet.address();\n let signer: EthereumWallet = wallet.into();\n\n let provider = http_provider_with_signer(&handle.http_endpoint(), signer);\n\n let contract =\n SimpleStorage::deploy(provider.clone(), \"initial value\".to_string()).await.unwrap();\n\n api.anvil_set_auto_mine(false).await.unwrap();\n\n let pre_logs =\n provider.get_logs(&Filter::new().from_block(BlockNumberOrTag::Earliest)).await.unwrap();\n assert_eq!(pre_logs.len(), 1);\n\n let pre_logs =\n provider.get_logs(&Filter::new().from_block(BlockNumberOrTag::Number(0))).await.unwrap();\n assert_eq!(pre_logs.len(), 1);\n\n // spread logs across several blocks\n let num_tx = 10;\n let tx = contract.setValue(\"hi\".to_string()).from(account);\n for _ in 0..num_tx {\n let tx = tx.send().await.unwrap();\n api.mine_one().await;\n tx.get_receipt().await.unwrap();\n }\n\n let logs =\n provider.get_logs(&Filter::new().from_block(BlockNumberOrTag::Earliest)).await.unwrap();\n\n let num_logs = num_tx + pre_logs.len();\n assert_eq!(logs.len(), num_logs);\n\n // test that logs returned from get_logs and get_transaction_receipt have\n // the same log_index, block_number, and transaction_hash\n let mut tasks = vec![];\n let mut seen_tx_hashes = B256HashSet::default();\n for log in &logs {\n if seen_tx_hashes.contains(&log.transaction_hash.unwrap()) {\n continue;\n }\n tasks.push(provider.get_transaction_receipt(log.transaction_hash.unwrap()));\n seen_tx_hashes.insert(log.transaction_hash.unwrap());\n }\n\n let receipt_logs = futures::future::join_all(tasks)\n .await\n .into_iter()\n .collect::, _>>()\n .unwrap()\n .into_iter()\n .flat_map(|receipt| receipt.unwrap().inner.inner.inner.receipt.logs)\n .collect::>();\n\n assert_eq!(receipt_logs.len(), logs.len());\n for (receipt_log, log) in receipt_logs.iter().zip(logs.iter()) {\n assert_eq!(receipt_log.transaction_hash, log.transaction_hash);\n assert_eq!(receipt_log.block_number, log.block_number);\n assert_eq!(receipt_log.log_index, log.log_index);\n }\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn watch_events() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n\n let wallet = handle.dev_wallets().next().unwrap();\n let account = wallet.address();\n let signer: EthereumWallet = wallet.into();\n\n let provider = http_provider_with_signer(&handle.http_endpoint(), signer.clone());\n\n let contract1 =\n SimpleStorage::deploy(provider.clone(), \"initial value\".to_string()).await.unwrap();\n\n // Spawn the event listener.\n let event1 = contract1.event_filter::();\n let mut stream1 = event1.watch().await.unwrap().into_stream();\n\n // Also set up a subscription for the same thing.\n let ws = ws_provider_with_signer(&handle.ws_endpoint(), signer.clone());\n let contract2 = SimpleStorage::new(*contract1.address(), ws);\n let event2 = contract2.event_filter::();\n let mut stream2 = event2.watch().await.unwrap().into_stream();\n\n let num_tx = 3;\n\n let starting_block_number = provider.get_block_number().await.unwrap();\n for i in 0..num_tx {\n contract1\n .setValue(i.to_string())\n .from(account)\n .send()\n .await\n .unwrap()\n .get_receipt()\n .await\n .unwrap();\n\n let log = stream1.next().await.unwrap().unwrap();\n let log2 = stream2.next().await.unwrap().unwrap();\n\n assert_eq!(log.0.newValue, log2.0.newValue);\n assert_eq!(log.0.newValue, i.to_string());\n assert_eq!(log.1.block_number.unwrap(), starting_block_number + i + 1);\n\n let hash = provider\n .get_block_by_number(BlockNumberOrTag::from(starting_block_number + i + 1))\n .await\n .unwrap()\n .unwrap()\n .header\n .hash;\n assert_eq!(log.1.block_hash.unwrap(), hash);\n }\n}\n" }, { "path": "crates/anvil/tests/it/main.rs", "content": "mod abi;\nmod anvil;\nmod anvil_api;\nmod api;\nmod beacon_api;\nmod eip2935;\nmod eip4844;\nmod eip7702;\nmod fork;\nmod gas;\nmod genesis;\nmod ipc;\nmod logs;\nmod optimism;\nmod otterscan;\nmod proof;\nmod pubsub;\nmod revert;\nmod sign;\nmod simulate;\nmod state;\nmod traces;\nmod transaction;\nmod txpool;\npub mod utils;\nmod wsapi;\n\npub use foundry_test_utils::init_tracing;\n" }, { "path": "crates/anvil/tests/it/optimism.rs", "content": "//! Tests for OP chain support.\n\nuse crate::utils::{http_provider, http_provider_with_signer};\nuse alloy_eips::eip2718::Encodable2718;\nuse alloy_network::{EthereumWallet, TransactionBuilder};\nuse alloy_primitives::{Address, Bloom, TxHash, TxKind, U256, b256};\nuse alloy_provider::Provider;\nuse alloy_rpc_types::{BlockId, TransactionRequest};\nuse alloy_serde::WithOtherFields;\nuse anvil::{NodeConfig, eth::fees::INITIAL_BASE_FEE, spawn};\nuse foundry_evm_networks::NetworkConfigs;\nuse op_alloy_consensus::TxDeposit;\nuse op_alloy_rpc_types::OpTransactionFields;\nuse serde_json::{Value, json};\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_deposits_not_supported_if_optimism_disabled() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let accounts: Vec<_> = handle.dev_wallets().collect();\n let from = accounts[0].address();\n let to = accounts[1].address();\n\n let tx = TransactionRequest::default()\n .with_from(from)\n .with_to(to)\n .with_value(U256::from(1234))\n .with_gas_limit(21000);\n\n let op_fields = OpTransactionFields {\n source_hash: Some(b256!(\n \"0x0000000000000000000000000000000000000000000000000000000000000000\"\n )),\n mint: Some(0),\n is_system_tx: Some(true),\n deposit_receipt_version: None,\n };\n\n let other = serde_json::to_value(op_fields).unwrap().try_into().unwrap();\n\n let tx = WithOtherFields { inner: tx, other };\n\n let err = provider.send_transaction(tx).await.unwrap_err();\n let s = err.to_string();\n assert!(s.contains(\"op-stack deposit tx received but is not supported\"), \"{s:?}\");\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_send_value_deposit_transaction() {\n // enable the Optimism flag\n let (api, handle) =\n spawn(NodeConfig::test().with_networks(NetworkConfigs::with_optimism())).await;\n\n let accounts: Vec<_> = handle.dev_wallets().collect();\n let signer: EthereumWallet = accounts[0].clone().into();\n let from = accounts[0].address();\n let to = accounts[1].address();\n\n let provider = http_provider_with_signer(&handle.http_endpoint(), signer);\n\n let send_value = U256::from(1234);\n let before_balance_to = provider.get_balance(to).await.unwrap();\n\n let op_fields = OpTransactionFields {\n source_hash: Some(b256!(\n \"0x0000000000000000000000000000000000000000000000000000000000000000\"\n )),\n mint: Some(0),\n is_system_tx: Some(true),\n deposit_receipt_version: None,\n };\n\n let other = serde_json::to_value(op_fields).unwrap().try_into().unwrap();\n let tx = TransactionRequest::default()\n .with_from(from)\n .with_to(to)\n .with_value(send_value)\n .with_gas_limit(21000);\n let tx: WithOtherFields = WithOtherFields { inner: tx, other };\n\n let pending = provider.send_transaction(tx).await.unwrap().register().await.unwrap();\n\n // mine block\n api.evm_mine(None).await.unwrap();\n\n let receipt =\n provider.get_transaction_receipt(pending.tx_hash().to_owned()).await.unwrap().unwrap();\n assert_eq!(receipt.from, from);\n assert_eq!(receipt.to, Some(to));\n\n // the recipient should have received the value\n let after_balance_to = provider.get_balance(to).await.unwrap();\n assert_eq!(after_balance_to, before_balance_to + send_value);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_send_value_raw_deposit_transaction() {\n // enable the Optimism flag\n let (api, handle) =\n spawn(NodeConfig::test().with_networks(NetworkConfigs::with_optimism())).await;\n\n let accounts: Vec<_> = handle.dev_wallets().collect();\n let signer: EthereumWallet = accounts[0].clone().into();\n let from = accounts[0].address();\n let to = accounts[1].address();\n\n let provider = http_provider_with_signer(&handle.http_endpoint(), signer.clone());\n\n let send_value = U256::from(1234);\n let before_balance_to = provider.get_balance(to).await.unwrap();\n\n let tx = TransactionRequest::default()\n .with_chain_id(31337)\n .with_nonce(0)\n .with_from(from)\n .with_to(to)\n .with_value(send_value)\n .with_gas_limit(21_000)\n .with_max_fee_per_gas(20_000_000_000)\n .with_max_priority_fee_per_gas(1_000_000_000);\n\n let op_fields = OpTransactionFields {\n source_hash: Some(b256!(\n \"0x0000000000000000000000000000000000000000000000000000000000000000\"\n )),\n mint: Some(0),\n is_system_tx: Some(true),\n deposit_receipt_version: None,\n };\n let other = serde_json::to_value(op_fields).unwrap().try_into().unwrap();\n let tx = WithOtherFields { inner: tx, other };\n let tx_envelope = tx.build(&signer).await.unwrap();\n let mut tx_buffer = Vec::with_capacity(tx_envelope.encode_2718_len());\n tx_envelope.encode_2718(&mut tx_buffer);\n let tx_encoded = tx_buffer.as_slice();\n\n let pending =\n provider.send_raw_transaction(tx_encoded).await.unwrap().register().await.unwrap();\n\n // mine block\n api.evm_mine(None).await.unwrap();\n\n let receipt =\n provider.get_transaction_receipt(pending.tx_hash().to_owned()).await.unwrap().unwrap();\n assert_eq!(receipt.from, from);\n assert_eq!(receipt.to, Some(to));\n\n // the recipient should have received the value\n let after_balance_to = provider.get_balance(to).await.unwrap();\n assert_eq!(after_balance_to, before_balance_to + send_value);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_deposit_transaction_hash_matches_sepolia() {\n // enable the Optimism flag\n let (_api, handle) =\n spawn(NodeConfig::test().with_networks(NetworkConfigs::with_optimism())).await;\n\n let accounts: Vec<_> = handle.dev_wallets().collect();\n let signer: EthereumWallet = accounts[0].clone().into();\n // https://sepolia-optimism.etherscan.io/tx/0xbf8b5f08c43e4b860715cd64fc0849bbce0d0ea20a76b269e7bc8886d112fca7\n let tx_hash: TxHash = \"0xbf8b5f08c43e4b860715cd64fc0849bbce0d0ea20a76b269e7bc8886d112fca7\"\n .parse::()\n .unwrap();\n\n // https://sepolia-optimism.etherscan.io/getRawTx?tx=0xbf8b5f08c43e4b860715cd64fc0849bbce0d0ea20a76b269e7bc8886d112fca7\n let raw_deposit_tx = alloy_primitives::hex::decode(\n \"7ef861a0dfd7ae78bf3c414cfaa77f13c0205c82eb9365e217b2daa3448c3156b69b27ac94778f2146f48179643473b82931c4cd7b8f153efd94778f2146f48179643473b82931c4cd7b8f153efd872386f26fc10000872386f26fc10000830186a08080\",\n )\n .unwrap();\n\n let provider = http_provider_with_signer(&handle.http_endpoint(), signer.clone());\n\n let receipt = provider\n .send_raw_transaction(raw_deposit_tx.as_slice())\n .await\n .unwrap()\n .get_receipt()\n .await\n .unwrap();\n\n assert_eq!(receipt.transaction_hash, tx_hash);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_deposit_tx_checks_sufficient_funds_after_applying_deposited_value() {\n // enable the Optimism flag\n let (_api, handle) =\n spawn(NodeConfig::test().with_networks(NetworkConfigs::with_optimism())).await;\n\n let provider = http_provider(&handle.http_endpoint());\n\n let sender = Address::random();\n let recipient = Address::random();\n let send_value = 1_000_000_000_u128;\n\n let sender_prev_balance = provider.get_balance(sender).await.unwrap();\n assert_eq!(sender_prev_balance, U256::from(0));\n\n let recipient_prev_balance = provider.get_balance(recipient).await.unwrap();\n assert_eq!(recipient_prev_balance, U256::from(0));\n\n let deposit_tx = TxDeposit {\n source_hash: b256!(\"0x0000000000000000000000000000000000000000000000000000000000000000\"),\n from: sender,\n to: TxKind::Call(recipient),\n mint: send_value,\n value: U256::from(send_value),\n gas_limit: 21_000,\n is_system_transaction: false,\n input: Vec::new().into(),\n };\n\n let mut tx_buffer = Vec::new();\n deposit_tx.encode_2718(&mut tx_buffer);\n\n provider.send_raw_transaction(&tx_buffer).await.unwrap().get_receipt().await.unwrap();\n\n let sender_new_balance = provider.get_balance(sender).await.unwrap();\n // sender should've sent the entire deposited value to recipient\n assert_eq!(sender_new_balance, U256::from(0));\n\n let recipient_new_balance = provider.get_balance(recipient).await.unwrap();\n // recipient should've received the entire deposited value\n assert_eq!(recipient_new_balance, U256::from(send_value));\n}\n\n#[test]\nfn preserves_op_fields_in_convert_to_anvil_receipt() {\n let receipt_json = json!({\n \"status\": \"0x1\",\n \"cumulativeGasUsed\": \"0x74e483\",\n \"logs\": [],\n \"logsBloom\": Bloom::default(),\n \"type\": \"0x2\",\n \"transactionHash\": \"0x91181b0dca3b29aa136eeb2f536be5ce7b0aebc949be1c44b5509093c516097d\",\n \"transactionIndex\": \"0x10\",\n \"blockHash\": \"0x54bafb12e8cea9bb355fbf03a4ac49e42a2a1a80fa6cf4364b342e2de6432b5d\",\n \"blockNumber\": \"0x7b1ab93\",\n \"gasUsed\": \"0xc222\",\n \"effectiveGasPrice\": \"0x18961\",\n \"from\": \"0x2d815240a61731c75fa01b2793e1d3ed09f289d0\",\n \"to\": \"0x4200000000000000000000000000000000000000\",\n \"contractAddress\": Value::Null,\n \"l1BaseFeeScalar\": \"0x146b\",\n \"l1BlobBaseFee\": \"0x6a83078\",\n \"l1BlobBaseFeeScalar\": \"0xf79c5\",\n \"l1Fee\": \"0x51a9af7fd3\",\n \"l1GasPrice\": \"0x972fe4acc\",\n \"l1GasUsed\": \"0x640\",\n });\n\n let receipt: alloy_network::AnyTransactionReceipt =\n serde_json::from_value(receipt_json).expect(\"valid receipt json\");\n\n let converted =\n foundry_primitives::FoundryTxReceipt::try_from(receipt).expect(\"conversion should succeed\");\n let converted_json = serde_json::to_value(&converted).expect(\"serialize to json\");\n\n for (key, expected) in [\n (\"l1Fee\", \"0x51a9af7fd3\"),\n (\"l1GasPrice\", \"0x972fe4acc\"),\n (\"l1GasUsed\", \"0x640\"),\n (\"l1BaseFeeScalar\", \"0x146b\"),\n (\"l1BlobBaseFee\", \"0x6a83078\"),\n (\"l1BlobBaseFeeScalar\", \"0xf79c5\"),\n ] {\n let got = converted_json.get(key).and_then(Value::as_str);\n assert_eq!(got, Some(expected), \"field `{key}` mismatch\");\n }\n}\n\nconst GAS_TRANSFER: u64 = 21_000;\n\n/// Test that Optimism uses Canyon base fee params instead of Ethereum params.\n///\n/// Optimism Canyon uses different EIP-1559 parameters:\n/// - elasticity_multiplier: 6 (vs Ethereum's 2)\n/// - base_fee_max_change_denominator: 250 (vs Ethereum's 8)\n///\n/// This means with a full block:\n/// - Ethereum: base_fee increases by base_fee * 1 / 8 = 12.5%\n/// - Optimism: base_fee increases by base_fee * 5 / 250 = 2%\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_optimism_base_fee_params() {\n // Spawn an Optimism node with a gas limit equal to one transfer (full block scenario)\n let (_api, handle) = spawn(\n NodeConfig::test()\n .with_networks(NetworkConfigs::with_optimism())\n .with_base_fee(Some(INITIAL_BASE_FEE))\n .with_gas_limit(Some(GAS_TRANSFER)),\n )\n .await;\n\n let wallet = handle.dev_wallets().next().unwrap();\n let signer: EthereumWallet = wallet.clone().into();\n\n let provider = http_provider_with_signer(&handle.http_endpoint(), signer);\n\n let tx = TransactionRequest::default().to(Address::random()).with_value(U256::from(1337));\n let tx = WithOtherFields::new(tx);\n\n // Send first transaction to fill the block\n provider.send_transaction(tx.clone()).await.unwrap().get_receipt().await.unwrap();\n\n let base_fee = provider\n .get_block(BlockId::latest())\n .await\n .unwrap()\n .unwrap()\n .header\n .base_fee_per_gas\n .unwrap();\n\n // Send second transaction to fill the next block\n provider.send_transaction(tx.clone()).await.unwrap().get_receipt().await.unwrap();\n\n let next_base_fee = provider\n .get_block(BlockId::latest())\n .await\n .unwrap()\n .unwrap()\n .header\n .base_fee_per_gas\n .unwrap();\n\n assert!(next_base_fee > base_fee, \"base fee should increase with full block\");\n\n // Optimism Canyon formula: base_fee * (elasticity - 1) / denominator = base_fee * 5 / 250\n // = INITIAL_BASE_FEE * 5 / 250 = 1_000_000_000 * 5 / 250 = 20_000_000\n //\n // Note: Ethereum would be INITIAL_BASE_FEE + 125_000_000 (12.5% increase)\n let expected_op_increase = INITIAL_BASE_FEE * 5 / 250; // 2% increase = 20_000_000\n assert_eq!(\n next_base_fee,\n INITIAL_BASE_FEE + expected_op_increase,\n \"Optimism should use Canyon base fee params (2% max increase), not Ethereum's (12.5%)\"\n );\n\n // Explicitly verify it's NOT using Ethereum params (which would give 12.5% increase)\n let ethereum_increase = INITIAL_BASE_FEE / 8; // 125_000_000\n assert_ne!(\n next_base_fee,\n INITIAL_BASE_FEE + ethereum_increase,\n \"Should not be using Ethereum base fee params\"\n );\n}\n" }, { "path": "crates/anvil/tests/it/otterscan.rs", "content": "//! Tests for otterscan endpoints.\n\nuse crate::abi::Multicall;\nuse alloy_network::TransactionResponse;\nuse alloy_primitives::{Address, Bytes, U256, address};\nuse alloy_provider::Provider;\nuse alloy_rpc_types::{\n BlockNumberOrTag, TransactionRequest,\n trace::otterscan::{InternalOperation, OperationType, TraceEntry},\n};\nuse alloy_serde::WithOtherFields;\nuse alloy_sol_types::{SolCall, SolError, SolValue, sol};\nuse anvil::{NodeConfig, spawn};\nuse foundry_evm::hardfork::EthereumHardfork;\nuse std::collections::VecDeque;\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn erigon_get_header_by_number() {\n let (api, _handle) = spawn(NodeConfig::test()).await;\n api.mine_one().await;\n\n let res0 = api.erigon_get_header_by_number(0.into()).await.unwrap().unwrap();\n assert_eq!(res0.header.number, 0);\n\n let res1 = api.erigon_get_header_by_number(1.into()).await.unwrap().unwrap();\n assert_eq!(res1.header.number, 1);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn ots_get_api_level() {\n let (api, _handle) = spawn(NodeConfig::test()).await;\n\n assert_eq!(api.ots_get_api_level().await.unwrap(), 8);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn ots_get_internal_operations_contract_deploy() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n let sender = handle.dev_accounts().next().unwrap();\n\n let contract_receipt =\n Multicall::deploy_builder(&provider).send().await.unwrap().get_receipt().await.unwrap();\n\n let res = api.ots_get_internal_operations(contract_receipt.transaction_hash).await.unwrap();\n assert_eq!(\n res,\n [InternalOperation {\n r#type: OperationType::OpCreate,\n from: sender,\n to: contract_receipt.contract_address.unwrap(),\n value: U256::from(0)\n }],\n );\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn ots_get_internal_operations_contract_transfer() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let accounts: Vec<_> = handle.dev_wallets().collect();\n let from = accounts[0].address();\n let to = accounts[1].address();\n\n let amount = handle.genesis_balance().checked_div(U256::from(2u64)).unwrap();\n\n let tx = TransactionRequest::default().to(to).value(amount).from(from);\n let tx = WithOtherFields::new(tx);\n\n let receipt = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n let res = api.ots_get_internal_operations(receipt.transaction_hash).await.unwrap();\n assert_eq!(\n res,\n [InternalOperation { r#type: OperationType::OpTransfer, from, to, value: amount }],\n );\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn ots_get_internal_operations_contract_create2() {\n sol!(\n #[sol(rpc, bytecode = \"60808060405234601557610147908161001a8239f35b5f80fdfe6080600436101561000e575f80fd5b5f3560e01c636cd5c39b14610021575f80fd5b346100d0575f3660031901126100d0575f602082810191825282526001600160401b03916040810191838311828410176100d4578261008960405f959486958252606081019486865281518091608084015e81018660808201520360208101845201826100ee565b519082734e59b44847b379578588920ca78fbf26c0b4956c5af1903d156100e8573d9081116100d4576040516100c991601f01601f1916602001906100ee565b156100d057005b5f80fd5b634e487b7160e01b5f52604160045260245ffd5b506100c9565b601f909101601f19168101906001600160401b038211908210176100d45760405256fea2646970667358221220f76968e121fc002b537029df51a2aecca0793282491baf84b872ffbfbfb1c9d764736f6c63430008190033\")]\n contract Contract {\n address constant CREATE2_DEPLOYER = 0x4e59b44847b379578588920cA78FbF26c0B4956C;\n\n function deployContract() public {\n uint256 salt = 0;\n uint256 code = 0;\n bytes memory creationCode = abi.encodePacked(code);\n (bool success,) = address(CREATE2_DEPLOYER).call(abi.encodePacked(salt, creationCode));\n require(success);\n }\n }\n );\n\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let contract = Contract::deploy(&provider).await.unwrap();\n\n let receipt = contract.deployContract().send().await.unwrap().get_receipt().await.unwrap();\n\n let res = api.ots_get_internal_operations(receipt.transaction_hash).await.unwrap();\n assert_eq!(\n res,\n [InternalOperation {\n r#type: OperationType::OpCreate2,\n from: address!(\"0x4e59b44847b379578588920cA78FbF26c0B4956C\"),\n to: address!(\"0x347bcdad821abc09b8c275881b368de36476b62c\"),\n value: U256::from(0),\n }],\n );\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn ots_get_internal_operations_contract_selfdestruct_london() {\n ots_get_internal_operations_contract_selfdestruct(EthereumHardfork::London).await;\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn ots_get_internal_operations_contract_selfdestruct_cancun() {\n ots_get_internal_operations_contract_selfdestruct(EthereumHardfork::Cancun).await;\n}\n\nasync fn ots_get_internal_operations_contract_selfdestruct(hardfork: EthereumHardfork) {\n sol!(\n #[sol(rpc, bytecode = \"608080604052607f908160108239f3fe6004361015600c57600080fd5b6000803560e01c6375fc8e3c14602157600080fd5b346046578060031936011260465773dcdd539da22bffaa499dbea4d37d086dde196e75ff5b80fdfea264697066735822122080a9ad005cc408b2d4e30ca11216d8e310700fbcdf58a629d6edbb91531f9c6164736f6c63430008190033\")]\n contract Contract {\n constructor() payable {}\n function goodbye() public {\n selfdestruct(payable(0xDcDD539DA22bfFAa499dBEa4d37d086Dde196E75));\n }\n }\n );\n\n let (api, handle) = spawn(NodeConfig::test().with_hardfork(Some(hardfork.into()))).await;\n let provider = handle.http_provider();\n\n let sender = handle.dev_accounts().next().unwrap();\n let value = U256::from(69);\n\n let contract_address =\n Contract::deploy_builder(&provider).from(sender).value(value).deploy().await.unwrap();\n let contract = Contract::new(contract_address, &provider);\n\n let receipt = contract.goodbye().send().await.unwrap().get_receipt().await.unwrap();\n\n let expected_to = address!(\"0xDcDD539DA22bfFAa499dBEa4d37d086Dde196E75\");\n let expected_value = value;\n\n let res = api.ots_get_internal_operations(receipt.transaction_hash).await.unwrap();\n assert_eq!(\n res,\n [InternalOperation {\n r#type: OperationType::OpSelfDestruct,\n from: contract_address,\n to: expected_to,\n value: expected_value,\n }],\n );\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn ots_has_code() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n let sender = handle.dev_accounts().next().unwrap();\n\n api.mine_one().await;\n\n let contract_address = sender.create(0);\n\n // no code in the address before deploying\n assert!(!api.ots_has_code(contract_address, BlockNumberOrTag::Number(1)).await.unwrap());\n\n let contract_builder = Multicall::deploy_builder(&provider);\n let contract_receipt = contract_builder.send().await.unwrap().get_receipt().await.unwrap();\n\n let num = provider.get_block_number().await.unwrap();\n assert_eq!(num, contract_receipt.block_number.unwrap());\n\n // code is detected after deploying\n assert!(api.ots_has_code(contract_address, BlockNumberOrTag::Number(num)).await.unwrap());\n\n // code is not detected for the previous block\n assert!(!api.ots_has_code(contract_address, BlockNumberOrTag::Number(num - 1)).await.unwrap());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_call_ots_trace_transaction() {\n sol!(\n #[sol(rpc, bytecode = \"608080604052346026575f80546001600160a01b0319163317905561025e908161002b8239f35b5f80fdfe6080604081815260049081361015610015575f80fd5b5f925f3560e01c9081636a6758fe1461019a5750806396385e3914610123578063a1325397146101115763c04062261461004d575f80fd5b5f3660031901126100d5578051633533ac7f60e11b81526020818481305afa80156100cb576100d9575b50303b156100d55780516396385e3960e01b8152915f83828183305af180156100cb576100a2578380f35b919250906001600160401b0383116100b8575052005b604190634e487b7160e01b5f525260245ffd5b82513d5f823e3d90fd5b5f80fd5b6020813d602011610109575b816100f2602093836101b3565b810103126100d55751801515036100d5575f610077565b3d91506100e5565b346100d5575f3660031901126100d557005b5090346100d5575f3660031901126100d5575f805481908190819047906001600160a01b03165af1506101546101ea565b50815163a132539760e01b6020820190815282825292909182820191906001600160401b038311848410176100b8575f8086868686525190305af4506101986101ea565b005b346100d5575f3660031901126100d55780600160209252f35b601f909101601f19168101906001600160401b038211908210176101d657604052565b634e487b7160e01b5f52604160045260245ffd5b3d15610223573d906001600160401b0382116101d65760405191610218601f8201601f1916602001846101b3565b82523d5f602084013e565b60609056fea264697066735822122099817ea378044f1f6434272aeb1f3f01a734645e599e69b4caf2ba7a4fb65f9d64736f6c63430008190033\")]\n contract Contract {\n address private owner;\n\n constructor() {\n owner = msg.sender;\n }\n\n function run() payable public {\n this.do_staticcall();\n this.do_call();\n }\n\n function do_staticcall() external view returns (bool) {\n return true;\n }\n\n function do_call() external {\n owner.call{value: address(this).balance}(\"\");\n address(this).delegatecall(abi.encodeWithSignature(\"do_delegatecall()\"));\n }\n\n function do_delegatecall() external {}\n }\n );\n\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n let wallets = handle.dev_wallets().collect::>();\n let sender = wallets[0].address();\n\n let contract_address = Contract::deploy_builder(&provider).from(sender).deploy().await.unwrap();\n let contract = Contract::new(contract_address, &provider);\n\n let receipt =\n contract.run().value(U256::from(1337)).send().await.unwrap().get_receipt().await.unwrap();\n\n let res = api.ots_trace_transaction(receipt.transaction_hash).await.unwrap();\n let expected = vec![\n TraceEntry {\n r#type: \"CALL\".to_string(),\n depth: 0,\n from: sender,\n to: contract_address,\n value: Some(U256::from(1337)),\n input: Contract::runCall::SELECTOR.into(),\n output: Bytes::new(),\n },\n TraceEntry {\n r#type: \"STATICCALL\".to_string(),\n depth: 1,\n from: contract_address,\n to: contract_address,\n value: Some(U256::ZERO),\n input: Contract::do_staticcallCall::SELECTOR.into(),\n output: true.abi_encode().into(),\n },\n TraceEntry {\n r#type: \"CALL\".to_string(),\n depth: 1,\n from: contract_address,\n to: contract_address,\n value: Some(U256::ZERO),\n input: Contract::do_callCall::SELECTOR.into(),\n output: Bytes::new(),\n },\n TraceEntry {\n r#type: \"CALL\".to_string(),\n depth: 2,\n from: contract_address,\n to: sender,\n value: Some(U256::from(1337)),\n input: Bytes::new(),\n output: Bytes::new(),\n },\n TraceEntry {\n r#type: \"DELEGATECALL\".to_string(),\n depth: 2,\n from: contract_address,\n to: contract_address,\n value: Some(U256::ZERO),\n input: Contract::do_delegatecallCall::SELECTOR.into(),\n output: Bytes::new(),\n },\n ];\n assert_eq!(res, expected);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn ots_get_transaction_error() {\n sol!(\n #[sol(rpc, bytecode = \"6080806040523460135760a3908160188239f35b5f80fdfe60808060405260043610156011575f80fd5b5f3560e01c63f67f4650146023575f80fd5b346069575f3660031901126069576346b7545f60e11b81526020600482015260126024820152712932bb32b93a29ba3934b733a337b7a130b960711b6044820152606490fd5b5f80fdfea264697066735822122069222918090d4d3ddc6a9c8b6ef282464076c71f923a0e8618ed25489b87f12b64736f6c63430008190033\")]\n contract Contract {\n error CustomError(string msg);\n\n function trigger_revert() public {\n revert CustomError(\"RevertStringFooBar\");\n }\n }\n );\n\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let contract = Contract::deploy(&provider).await.unwrap();\n\n let receipt = contract.trigger_revert().send().await.unwrap().get_receipt().await.unwrap();\n\n let err = api.ots_get_transaction_error(receipt.transaction_hash).await.unwrap();\n let expected = Contract::CustomError { msg: String::from(\"RevertStringFooBar\") }.abi_encode();\n assert_eq!(err, Bytes::from(expected));\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn ots_get_transaction_error_no_error() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n // Send a successful transaction\n let tx = TransactionRequest::default().to(Address::random()).value(U256::from(100));\n let tx = WithOtherFields::new(tx);\n let receipt = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n let res = api.ots_get_transaction_error(receipt.transaction_hash).await.unwrap();\n assert!(res.is_empty(), \"{res}\");\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn ots_get_block_details() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let tx = TransactionRequest::default().to(Address::random()).value(U256::from(100));\n let tx = WithOtherFields::new(tx);\n provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n let result = api.ots_get_block_details(1.into()).await.unwrap();\n\n assert_eq!(result.block.transaction_count, 1);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn ots_get_block_details_by_hash() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let tx = TransactionRequest::default().to(Address::random()).value(U256::from(100));\n let tx = WithOtherFields::new(tx);\n let receipt = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n let block_hash = receipt.block_hash.unwrap();\n let result = api.ots_get_block_details_by_hash(block_hash).await.unwrap();\n\n assert_eq!(result.block.transaction_count, 1);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn ots_get_block_transactions() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n // disable automine\n api.anvil_set_auto_mine(false).await.unwrap();\n\n let mut hashes = VecDeque::new();\n for i in 0..10 {\n let tx =\n TransactionRequest::default().to(Address::random()).value(U256::from(100)).nonce(i);\n let tx = WithOtherFields::new(tx);\n let pending_receipt =\n provider.send_transaction(tx).await.unwrap().register().await.unwrap();\n hashes.push_back(*pending_receipt.tx_hash());\n }\n\n api.mine_one().await;\n\n let page_size = 3;\n for page in 0..4 {\n let result = api.ots_get_block_transactions(1, page, page_size).await.unwrap();\n\n assert!(result.receipts.len() <= page_size);\n let len = result.receipts.len();\n assert!(len <= page_size);\n assert!(result.fullblock.transaction_count == result.receipts.len());\n\n result.receipts.iter().enumerate().for_each(|(i, receipt)| {\n let expected = hashes.pop_front();\n assert_eq!(expected, Some(receipt.receipt.transaction_hash));\n assert_eq!(expected, result.fullblock.block.transactions.hashes().nth(i));\n });\n }\n\n assert!(hashes.is_empty());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn ots_search_transactions_before() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n let sender = handle.dev_accounts().next().unwrap();\n\n let mut hashes = vec![];\n\n for i in 0..7 {\n let tx =\n TransactionRequest::default().to(Address::random()).value(U256::from(100)).nonce(i);\n let tx = WithOtherFields::new(tx);\n let receipt = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n hashes.push(receipt.transaction_hash);\n }\n\n let page_size = 2;\n let mut block = 0;\n for i in 0..4 {\n let result = api.ots_search_transactions_before(sender, block, page_size).await.unwrap();\n\n assert_eq!(result.first_page, i == 0);\n assert_eq!(result.last_page, i == 3);\n\n // check each individual hash\n result.txs.iter().for_each(|tx| {\n assert_eq!(hashes.pop(), Some(tx.tx_hash()));\n });\n\n block = result.txs.last().unwrap().block_number.unwrap();\n }\n\n assert!(hashes.is_empty());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn ots_search_transactions_after() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n let sender = handle.dev_accounts().next().unwrap();\n\n let mut hashes = VecDeque::new();\n\n for i in 0..7 {\n let tx =\n TransactionRequest::default().to(Address::random()).value(U256::from(100)).nonce(i);\n let tx = WithOtherFields::new(tx);\n let receipt = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n hashes.push_front(receipt.transaction_hash);\n }\n\n let page_size = 2;\n let mut block = 0;\n for i in 0..4 {\n let result = api.ots_search_transactions_after(sender, block, page_size).await.unwrap();\n\n assert_eq!(result.first_page, i == 3);\n assert_eq!(result.last_page, i == 0);\n\n // check each individual hash\n result.txs.iter().rev().for_each(|tx| {\n assert_eq!(hashes.pop_back(), Some(tx.tx_hash()));\n });\n\n block = result.txs.first().unwrap().block_number.unwrap();\n }\n\n assert!(hashes.is_empty());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn ots_get_transaction_by_sender_and_nonce() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n let sender = handle.dev_accounts().next().unwrap();\n\n let tx1 = WithOtherFields::new(\n TransactionRequest::default()\n .from(sender)\n .to(Address::random())\n .value(U256::from(100))\n .nonce(0),\n );\n let tx2 = WithOtherFields::new(\n TransactionRequest::default()\n .from(sender)\n .to(Address::random())\n .value(U256::from(100))\n .nonce(1),\n );\n\n let receipt1 = provider.send_transaction(tx1).await.unwrap().get_receipt().await.unwrap();\n let receipt2 = provider.send_transaction(tx2).await.unwrap().get_receipt().await.unwrap();\n\n let result1 =\n api.ots_get_transaction_by_sender_and_nonce(sender, U256::from(0)).await.unwrap().unwrap();\n let result2 =\n api.ots_get_transaction_by_sender_and_nonce(sender, U256::from(1)).await.unwrap().unwrap();\n\n assert_eq!(result1, receipt1.transaction_hash);\n assert_eq!(result2, receipt2.transaction_hash);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn ots_get_contract_creator() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n let sender = handle.dev_accounts().next().unwrap();\n\n let receipt =\n Multicall::deploy_builder(&provider).send().await.unwrap().get_receipt().await.unwrap();\n let contract_address = receipt.contract_address.unwrap();\n\n let creator = api.ots_get_contract_creator(contract_address).await.unwrap().unwrap();\n\n assert_eq!(creator.creator, sender);\n assert_eq!(creator.hash, receipt.transaction_hash);\n}\n" }, { "path": "crates/anvil/tests/it/proof.rs", "content": "//! tests for `eth_getProof`\n\nuse alloy_primitives::{Address, B256, Bytes, U256, address, fixed_bytes};\nuse anvil::{NodeConfig, eth::EthApi, spawn};\nuse foundry_primitives::FoundryNetwork;\nuse std::{collections::BTreeMap, str::FromStr};\n\nasync fn verify_account_proof(\n api: &EthApi,\n address: Address,\n proof: impl IntoIterator,\n) {\n let expected_proof =\n proof.into_iter().map(Bytes::from_str).collect::, _>>().unwrap();\n let proof = api.get_proof(address, Vec::new(), None).await.unwrap();\n\n assert_eq!(proof.account_proof, expected_proof);\n}\n\nasync fn verify_storage_proof(\n api: &EthApi,\n address: Address,\n slot: B256,\n proof: impl IntoIterator,\n) {\n let expected_proof =\n proof.into_iter().map(Bytes::from_str).collect::, _>>().unwrap();\n let proof = api.get_proof(address, vec![slot], None).await.unwrap();\n\n assert_eq!(proof.storage_proof[0].proof, expected_proof);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_account_proof() {\n let (api, _handle) = spawn(NodeConfig::empty_state()).await;\n\n api.anvil_set_balance(\n address!(\"0x2031f89b3ea8014eb51a78c316e42af3e0d7695f\"),\n U256::from(45000000000000000000_u128),\n )\n .await\n .unwrap();\n api.anvil_set_balance(address!(\"0x33f0fc440b8477fcfbe9d0bf8649e7dea9baedb2\"), U256::from(1))\n .await\n .unwrap();\n api.anvil_set_balance(\n address!(\"0x62b0dd4aab2b1a0a04e279e2b828791a10755528\"),\n U256::from(1100000000000000000_u128),\n )\n .await\n .unwrap();\n api.anvil_set_balance(\n address!(\"0x1ed9b1dd266b607ee278726d324b855a093394a6\"),\n U256::from(120000000000000000_u128),\n )\n .await\n .unwrap();\n\n // Note: proof values account for EIP-2935 history storage contract deployed at genesis.\n verify_account_proof(&api, address!(\"0x2031f89b3ea8014eb51a78c316e42af3e0d7695f\"), [\n \"0xf851808080808080a0347892f3eeb6af4d4574ad0b89706247951bbbece83ef27efc46eb96436598b5808080a07e35bed15a14b4072a0929310da6a26e34d7017a82cca3589d7d0badb53de2e3808080808080\",\n \"0xe217a040f916999be583c572cc4dd369ec53b0a99f7de95f13880cf203d98f935ed1b3\",\n \"0xf87180a04fb9bab4bb88c062f32452b7c94c8f64d07b5851d44a39f1e32ba4b1829fdbfb8080808080a0b61eeb2eb82808b73c4ad14140a2836689f4ab8445d69dd40554eaf1fce34bc080808080808080a0dea230ff2026e65de419288183a340125b04b8405cc61627b3b4137e2260a1e880\",\n \"0xf8719f31355ec1c8f7e26bb3ccbcb0b75d870d15846c0b98e5cc452db46c37faea40b84ff84d80890270801d946c940000a056e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421a0c5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470\",\n ]).await;\n\n verify_account_proof(&api, address!(\"0x33f0fc440b8477fcfbe9d0bf8649e7dea9baedb2\"), [\n \"0xf851808080808080a0347892f3eeb6af4d4574ad0b89706247951bbbece83ef27efc46eb96436598b5808080a07e35bed15a14b4072a0929310da6a26e34d7017a82cca3589d7d0badb53de2e3808080808080\",\n \"0xe217a040f916999be583c572cc4dd369ec53b0a99f7de95f13880cf203d98f935ed1b3\",\n \"0xf87180a04fb9bab4bb88c062f32452b7c94c8f64d07b5851d44a39f1e32ba4b1829fdbfb8080808080a0b61eeb2eb82808b73c4ad14140a2836689f4ab8445d69dd40554eaf1fce34bc080808080808080a0dea230ff2026e65de419288183a340125b04b8405cc61627b3b4137e2260a1e880\",\n \"0xe48200d3a0ef957210bca5b9b402d614eb8408c88cfbf4913eb6ab83ca233c8b8f0e626b54\",\n \"0xf851808080a02743a5addaf4cf9b8c0c073e1eaa555deaaf8c41cb2b41958e88624fa45c2d908080808080a0bfbf6937911dfb88113fecdaa6bde822e4e99dae62489fcf61a91cb2f36793d680808080808080\",\n \"0xf8679e207781e762f3577784bab7491fcc43e291ce5a356b9bc517ac52eed3a37ab846f8448001a056e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421a0c5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470\",\n ]).await;\n\n verify_account_proof(&api, address!(\"0x62b0dd4aab2b1a0a04e279e2b828791a10755528\"), [\n \"0xf851808080808080a0347892f3eeb6af4d4574ad0b89706247951bbbece83ef27efc46eb96436598b5808080a07e35bed15a14b4072a0929310da6a26e34d7017a82cca3589d7d0badb53de2e3808080808080\",\n \"0xe217a040f916999be583c572cc4dd369ec53b0a99f7de95f13880cf203d98f935ed1b3\",\n \"0xf87180a04fb9bab4bb88c062f32452b7c94c8f64d07b5851d44a39f1e32ba4b1829fdbfb8080808080a0b61eeb2eb82808b73c4ad14140a2836689f4ab8445d69dd40554eaf1fce34bc080808080808080a0dea230ff2026e65de419288183a340125b04b8405cc61627b3b4137e2260a1e880\",\n \"0xf8709f3936599f93b769acf90c7178fd2ddcac1b5b4bc9949ee5a04b7e0823c2446eb84ef84c80880f43fc2c04ee0000a056e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421a0c5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470\",\n ]).await;\n\n verify_account_proof(&api, address!(\"0x1ed9b1dd266b607ee278726d324b855a093394a6\"), [\n \"0xf851808080808080a0347892f3eeb6af4d4574ad0b89706247951bbbece83ef27efc46eb96436598b5808080a07e35bed15a14b4072a0929310da6a26e34d7017a82cca3589d7d0badb53de2e3808080808080\",\n \"0xe217a040f916999be583c572cc4dd369ec53b0a99f7de95f13880cf203d98f935ed1b3\",\n \"0xf87180a04fb9bab4bb88c062f32452b7c94c8f64d07b5851d44a39f1e32ba4b1829fdbfb8080808080a0b61eeb2eb82808b73c4ad14140a2836689f4ab8445d69dd40554eaf1fce34bc080808080808080a0dea230ff2026e65de419288183a340125b04b8405cc61627b3b4137e2260a1e880\",\n \"0xe48200d3a0ef957210bca5b9b402d614eb8408c88cfbf4913eb6ab83ca233c8b8f0e626b54\",\n \"0xf851808080a02743a5addaf4cf9b8c0c073e1eaa555deaaf8c41cb2b41958e88624fa45c2d908080808080a0bfbf6937911dfb88113fecdaa6bde822e4e99dae62489fcf61a91cb2f36793d680808080808080\",\n \"0xf86f9e207a32b8ab5eb4b043c65b1f00c93f517bc8883c5cd31baf8e8a279475e3b84ef84c808801aa535d3d0c0000a056e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421a0c5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470\",\n ]).await;\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_storage_proof() {\n let target = address!(\"0x1ed9b1dd266b607ee278726d324b855a093394a6\");\n\n let (api, _handle) = spawn(NodeConfig::empty_state()).await;\n let storage: BTreeMap =\n serde_json::from_str(include_str!(\"../../test-data/storage_sample.json\")).unwrap();\n\n for (key, value) in storage {\n api.anvil_set_storage_at(target, key, value).await.unwrap();\n }\n\n verify_storage_proof(&api, target, fixed_bytes!(\"0000000000000000000000000000000000000000000000000000000000000022\"), [\n \"0xf9019180a0aafd5b14a6edacd149e110ba6776a654f2dbffca340902be933d011113f2750380a0a502c93b1918c4c6534d4593ae03a5a23fa10ebc30ffb7080b297bff2446e42da02eb2bf45fd443bd1df8b6f9c09726a4c6252a0f7896a131a081e39a7f644b38980a0a9cf7f673a0bce76fd40332afe8601542910b48dea44e93933a3e5e930da5d19a0ddf79db0a36d0c8134ba143bcb541cd4795a9a2bae8aca0ba24b8d8963c2a77da0b973ec0f48f710bf79f63688485755cbe87f9d4c68326bb83c26af620802a80ea0f0855349af6bf84afc8bca2eda31c8ef8c5139be1929eeb3da4ba6b68a818cb0a0c271e189aeeb1db5d59d7fe87d7d6327bbe7cfa389619016459196497de3ccdea0e7503ba5799e77aa31bbe1310c312ca17b2c5bcc8fa38f266675e8f154c2516ba09278b846696d37213ab9d20a5eb42b03db3173ce490a2ef3b2f3b3600579fc63a0e9041059114f9c910adeca12dbba1fef79b2e2c8899f2d7213cd22dfe4310561a047c59da56bb2bf348c9dd2a2e8f5538a92b904b661cfe54a4298b85868bbe4858080\",\n \"0xf85180a0776aa456ba9c5008e03b82b841a9cf2fc1e8578cfacd5c9015804eae315f17fb80808080808080808080808080a072e3e284d47badbb0a5ca1421e1179d3ea90cc10785b26b74fb8a81f0f9e841880\",\n \"0xf843a020035b26e3e9eee00e0d72fd1ee8ddca6894550dca6916ea2ac6baa90d11e510a1a0f5a5fd42d16a20302798ef6ed309979b43003d2320d9f0e8ea9831a92759fb4b\"\n ]).await;\n\n verify_storage_proof(&api, target, fixed_bytes!(\"0000000000000000000000000000000000000000000000000000000000000023\"), [\n \"0xf9019180a0aafd5b14a6edacd149e110ba6776a654f2dbffca340902be933d011113f2750380a0a502c93b1918c4c6534d4593ae03a5a23fa10ebc30ffb7080b297bff2446e42da02eb2bf45fd443bd1df8b6f9c09726a4c6252a0f7896a131a081e39a7f644b38980a0a9cf7f673a0bce76fd40332afe8601542910b48dea44e93933a3e5e930da5d19a0ddf79db0a36d0c8134ba143bcb541cd4795a9a2bae8aca0ba24b8d8963c2a77da0b973ec0f48f710bf79f63688485755cbe87f9d4c68326bb83c26af620802a80ea0f0855349af6bf84afc8bca2eda31c8ef8c5139be1929eeb3da4ba6b68a818cb0a0c271e189aeeb1db5d59d7fe87d7d6327bbe7cfa389619016459196497de3ccdea0e7503ba5799e77aa31bbe1310c312ca17b2c5bcc8fa38f266675e8f154c2516ba09278b846696d37213ab9d20a5eb42b03db3173ce490a2ef3b2f3b3600579fc63a0e9041059114f9c910adeca12dbba1fef79b2e2c8899f2d7213cd22dfe4310561a047c59da56bb2bf348c9dd2a2e8f5538a92b904b661cfe54a4298b85868bbe4858080\",\n \"0xf8518080808080a0d546c4ca227a267d29796643032422374624ed109b3d94848c5dc06baceaee76808080808080a027c48e210ccc6e01686be2d4a199d35f0e1e8df624a8d3a17c163be8861acd6680808080\",\n \"0xf843a0207b2b5166478fd4318d2acc6cc2c704584312bdd8781b32d5d06abda57f4230a1a0db56114e00fdd4c1f85c892bf35ac9a89289aaecb1ebd0a96cde606a748b5d71\"\n ]).await;\n\n verify_storage_proof(&api, target, fixed_bytes!(\"0000000000000000000000000000000000000000000000000000000000000024\"), [\n \"0xf9019180a0aafd5b14a6edacd149e110ba6776a654f2dbffca340902be933d011113f2750380a0a502c93b1918c4c6534d4593ae03a5a23fa10ebc30ffb7080b297bff2446e42da02eb2bf45fd443bd1df8b6f9c09726a4c6252a0f7896a131a081e39a7f644b38980a0a9cf7f673a0bce76fd40332afe8601542910b48dea44e93933a3e5e930da5d19a0ddf79db0a36d0c8134ba143bcb541cd4795a9a2bae8aca0ba24b8d8963c2a77da0b973ec0f48f710bf79f63688485755cbe87f9d4c68326bb83c26af620802a80ea0f0855349af6bf84afc8bca2eda31c8ef8c5139be1929eeb3da4ba6b68a818cb0a0c271e189aeeb1db5d59d7fe87d7d6327bbe7cfa389619016459196497de3ccdea0e7503ba5799e77aa31bbe1310c312ca17b2c5bcc8fa38f266675e8f154c2516ba09278b846696d37213ab9d20a5eb42b03db3173ce490a2ef3b2f3b3600579fc63a0e9041059114f9c910adeca12dbba1fef79b2e2c8899f2d7213cd22dfe4310561a047c59da56bb2bf348c9dd2a2e8f5538a92b904b661cfe54a4298b85868bbe4858080\",\n \"0xf85180808080a030263404acfee103d0b1019053ff3240fce433c69b709831673285fa5887ce4c80808080808080a0f8f1fbb1f7b482d9860480feebb83ff54a8b6ec1ead61cc7d2f25d7c01659f9c80808080\",\n \"0xf843a020d332d19b93bcabe3cce7ca0c18a052f57e5fd03b4758a09f30f5ddc4b22ec4a1a0c78009fdf07fc56a11f122370658a353aaa542ed63e44c4bc15ff4cd105ab33c\",\n ]).await;\n\n verify_storage_proof(&api, target, fixed_bytes!(\"0000000000000000000000000000000000000000000000000000000000000100\"), [\n \"0xf9019180a0aafd5b14a6edacd149e110ba6776a654f2dbffca340902be933d011113f2750380a0a502c93b1918c4c6534d4593ae03a5a23fa10ebc30ffb7080b297bff2446e42da02eb2bf45fd443bd1df8b6f9c09726a4c6252a0f7896a131a081e39a7f644b38980a0a9cf7f673a0bce76fd40332afe8601542910b48dea44e93933a3e5e930da5d19a0ddf79db0a36d0c8134ba143bcb541cd4795a9a2bae8aca0ba24b8d8963c2a77da0b973ec0f48f710bf79f63688485755cbe87f9d4c68326bb83c26af620802a80ea0f0855349af6bf84afc8bca2eda31c8ef8c5139be1929eeb3da4ba6b68a818cb0a0c271e189aeeb1db5d59d7fe87d7d6327bbe7cfa389619016459196497de3ccdea0e7503ba5799e77aa31bbe1310c312ca17b2c5bcc8fa38f266675e8f154c2516ba09278b846696d37213ab9d20a5eb42b03db3173ce490a2ef3b2f3b3600579fc63a0e9041059114f9c910adeca12dbba1fef79b2e2c8899f2d7213cd22dfe4310561a047c59da56bb2bf348c9dd2a2e8f5538a92b904b661cfe54a4298b85868bbe4858080\",\n \"0xf891a090bacef44b189ddffdc5f22edc70fe298c58e5e523e6e1dfdf7dbc6d657f7d1b80a026eed68746028bc369eb456b7d3ee475aa16f34e5eaa0c98fdedb9c59ebc53b0808080a09ce86197173e14e0633db84ce8eea32c5454eebe954779255644b45b717e8841808080a0328c7afb2c58ef3f8c4117a8ebd336f1a61d24591067ed9c5aae94796cac987d808080808080\",\n ]).await;\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_get_random_account_proofs() {\n let (api, _handle) = spawn(NodeConfig::test()).await;\n\n for acc in std::iter::repeat_with(Address::random).take(10) {\n let _ = api\n .get_proof(acc, Vec::new(), None)\n .await\n .unwrap_or_else(|_| panic!(\"Failed to get proof for {acc:?}\"));\n }\n}\n" }, { "path": "crates/anvil/tests/it/pubsub.rs", "content": "//! tests for subscriptions\n\nuse crate::utils::{connect_pubsub, connect_pubsub_with_wallet};\nuse alloy_network::{EthereumWallet, TransactionBuilder};\nuse alloy_primitives::{Address, U256};\nuse alloy_provider::Provider;\nuse alloy_pubsub::Subscription;\nuse alloy_rpc_types::{Block as AlloyBlock, Filter, TransactionRequest};\nuse alloy_serde::WithOtherFields;\nuse alloy_sol_types::sol;\nuse anvil::{NodeConfig, spawn};\nuse futures::StreamExt;\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_sub_new_heads() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n let provider = connect_pubsub(&handle.ws_endpoint()).await;\n\n let blocks = provider.subscribe_blocks().await.unwrap();\n\n // mine a block every 1 seconds\n api.anvil_set_interval_mining(1).unwrap();\n\n let blocks = blocks.into_stream().take(3).collect::>().await;\n let block_numbers = blocks.into_iter().map(|b| b.number).collect::>();\n\n assert_eq!(block_numbers, vec![1, 2, 3]);\n}\n\nsol!(\n #[sol(rpc)]\n EmitLogs,\n \"test-data/emit_logs.json\"\n);\n// FIXME: Use .legacy() in tx when implemented in alloy\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_sub_logs_legacy() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let wallet = handle.dev_wallets().next().unwrap();\n let provider = connect_pubsub(&handle.ws_endpoint()).await;\n\n let msg = \"First Message\".to_string();\n let contract_addr = EmitLogs::deploy_builder(provider.clone(), msg.clone())\n .from(wallet.address())\n .deploy()\n .await\n .unwrap();\n let contract = EmitLogs::new(contract_addr, provider.clone());\n\n let val = contract.getValue().call().await.unwrap();\n assert_eq!(val, msg);\n\n // subscribe to events from the contract\n let filter = Filter::new().address(contract.address().to_owned());\n let logs_sub = provider.subscribe_logs(&filter).await.unwrap();\n\n // send a tx triggering an event\n // FIXME: Use .legacy() in tx\n let receipt = contract\n .setValue(\"Next Message\".to_string())\n .send()\n .await\n .unwrap()\n .get_receipt()\n .await\n .unwrap();\n\n let mut logs_sub = logs_sub.into_stream();\n // get the emitted event\n let log = logs_sub.next().await.unwrap();\n\n // ensure the log in the receipt is the same as received via subscription stream\n assert_eq!(receipt.inner.logs()[0], log);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_sub_logs() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let wallet = handle.dev_wallets().next().unwrap();\n let provider = connect_pubsub(&handle.ws_endpoint()).await;\n\n let msg = \"First Message\".to_string();\n let contract_addr = EmitLogs::deploy_builder(provider.clone(), msg.clone())\n .from(wallet.address())\n .deploy()\n .await\n .unwrap();\n let contract = EmitLogs::new(contract_addr, provider.clone());\n\n let val = contract.getValue().call().await.unwrap();\n assert_eq!(val, msg);\n\n // subscribe to events from the contract\n let filter = Filter::new().address(contract.address().to_owned());\n let logs_sub = provider.subscribe_logs(&filter).await.unwrap();\n\n // send a tx triggering an event\n let receipt = contract\n .setValue(\"Next Message\".to_string())\n .send()\n .await\n .unwrap()\n .get_receipt()\n .await\n .unwrap();\n\n let mut logs_sub = logs_sub.into_stream();\n // get the emitted event\n let log = logs_sub.next().await.unwrap();\n\n // ensure the log in the receipt is the same as received via subscription stream\n assert_eq!(receipt.inner.logs()[0], log);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_sub_logs_impersonated() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let wallet = handle.dev_wallets().next().unwrap();\n let provider =\n connect_pubsub_with_wallet(&handle.ws_endpoint(), EthereumWallet::from(wallet.clone()))\n .await;\n\n // impersonate account\n let impersonate = Address::random();\n let funding = U256::from(1e18 as u64);\n api.anvil_set_balance(impersonate, funding).await.unwrap();\n api.anvil_impersonate_account(impersonate).await.unwrap();\n\n let msg = \"First Message\".to_string();\n let contract = EmitLogs::deploy(provider.clone(), msg.clone()).await.unwrap();\n\n let _val = contract.getValue().call().await.unwrap();\n\n // subscribe to events from the impersonated account\n let filter = Filter::new().address(contract.address().to_owned());\n let logs_sub = provider.subscribe_logs(&filter).await.unwrap();\n\n // send a tx triggering an event\n let data = contract.setValue(\"Next Message\".to_string());\n let data = data.calldata().clone();\n\n let tx =\n TransactionRequest::default().from(impersonate).to(*contract.address()).with_input(data);\n\n let tx = WithOtherFields::new(tx);\n let provider = handle.http_provider();\n\n let receipt = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n let mut logs_sub = logs_sub.into_stream();\n // get the emitted event\n let log = logs_sub.next().await.unwrap();\n // ensure the log in the receipt is the same as received via subscription stream\n assert_eq!(receipt.inner.inner.logs()[0], log);\n}\n\n// FIXME: Use legacy() in tx when implemented in alloy\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_filters_legacy() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let wallet = handle.dev_wallets().next().unwrap();\n let provider =\n connect_pubsub_with_wallet(&handle.ws_endpoint(), EthereumWallet::from(wallet.clone()))\n .await;\n\n let from = wallet.address();\n\n let msg = \"First Message\".to_string();\n\n // FIXME: Use legacy() in tx when implemented in alloy\n let contract = EmitLogs::deploy(provider.clone(), msg.clone()).await.unwrap();\n\n let stream = contract.ValueChanged_filter().subscribe().await.unwrap();\n\n // send a tx triggering an event\n // FIXME: Use legacy() in tx when implemented in alloy\n let _receipt = contract\n .setValue(\"Next Message\".to_string())\n .send()\n .await\n .unwrap()\n .get_receipt()\n .await\n .unwrap();\n\n let mut log = stream.into_stream();\n // get the emitted event\n let (value_changed, _log) = log.next().await.unwrap().unwrap();\n\n assert_eq!(value_changed.author, from);\n assert_eq!(value_changed.oldValue, \"First Message\".to_string());\n assert_eq!(value_changed.newValue, \"Next Message\".to_string());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_filters() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let wallet = handle.dev_wallets().next().unwrap();\n let provider =\n connect_pubsub_with_wallet(&handle.ws_endpoint(), EthereumWallet::from(wallet.clone()))\n .await;\n\n let from = wallet.address();\n\n let msg = \"First Message\".to_string();\n\n let contract = EmitLogs::deploy(provider.clone(), msg.clone()).await.unwrap();\n\n let stream = contract.ValueChanged_filter().subscribe().await.unwrap();\n\n // send a tx triggering an event\n let _receipt = contract\n .setValue(\"Next Message\".to_string())\n .send()\n .await\n .unwrap()\n .get_receipt()\n .await\n .unwrap();\n\n let mut log = stream.into_stream();\n // get the emitted event\n let (value_changed, _log) = log.next().await.unwrap().unwrap();\n\n assert_eq!(value_changed.author, from);\n assert_eq!(value_changed.oldValue, \"First Message\".to_string());\n assert_eq!(value_changed.newValue, \"Next Message\".to_string());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_subscriptions() {\n let (_api, handle) =\n spawn(NodeConfig::test().with_blocktime(Some(std::time::Duration::from_secs(1)))).await;\n let provider = connect_pubsub(&handle.ws_endpoint()).await;\n let sub_id = provider.raw_request(\"eth_subscribe\".into(), [\"newHeads\"]).await.unwrap();\n let stream: Subscription = provider.get_subscription(sub_id).await.unwrap();\n let blocks = stream\n .into_stream()\n .take(3)\n .collect::>()\n .await\n .into_iter()\n .map(|b| b.header.number)\n .collect::>();\n\n assert_eq!(blocks, vec![1, 2, 3])\n}\n\n#[expect(clippy::disallowed_macros)]\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_sub_new_heads_fast() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n let provider = connect_pubsub(&handle.ws_endpoint()).await;\n\n let blocks = provider.subscribe_blocks().await.unwrap();\n let mut blocks = blocks.into_stream();\n\n let num = 1000u64;\n\n let mut block_numbers = Vec::new();\n for _ in 0..num {\n api.mine_one().await;\n let block_number = blocks.next().await.unwrap().number;\n block_numbers.push(block_number);\n }\n\n println!(\"Collected {} blocks\", block_numbers.len());\n\n let numbers = (1..=num).collect::>();\n assert_eq!(block_numbers, numbers);\n}\n" }, { "path": "crates/anvil/tests/it/revert.rs", "content": "use crate::abi::VendingMachine;\nuse alloy_network::TransactionBuilder;\nuse alloy_primitives::{U256, bytes};\nuse alloy_provider::Provider;\nuse alloy_rpc_types::TransactionRequest;\nuse alloy_serde::WithOtherFields;\nuse alloy_sol_types::sol;\nuse anvil::{NodeConfig, spawn};\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_deploy_reverting() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n let sender = handle.dev_accounts().next().unwrap();\n\n let code = bytes!(\"5f5ffd\"); // PUSH0 PUSH0 REVERT\n let tx = TransactionRequest::default().from(sender).with_deploy_code(code);\n let tx = WithOtherFields::new(tx);\n\n // Calling/estimating gas fails early.\n let err = provider.call(tx.clone()).await.unwrap_err();\n let s = err.to_string();\n assert!(s.contains(\"execution reverted\"), \"{s:?}\");\n\n // Sending the transaction is successful but reverts on chain.\n let tx = provider.send_transaction(tx).await.unwrap();\n let receipt = tx.get_receipt().await.unwrap();\n assert!(!receipt.inner.inner.status());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_revert_messages() {\n sol!(\n #[sol(rpc, bytecode = \"608080604052346025575f80546001600160a01b031916600117905560b69081602a8239f35b5f80fdfe60808060405260043610156011575f80fd5b5f3560e01c635b9fdc30146023575f80fd5b34607c575f366003190112607c575f546001600160a01b03163303604c576020604051607b8152f35b62461bcd60e51b815260206004820152600b60248201526a08585d5d1a1bdc9a5e995960aa1b6044820152606490fd5b5f80fdfea2646970667358221220f593e5ccd46935f623185de62a72d9f1492d8d15075a111b0fa4d7e16acf4a7064736f6c63430008190033\")]\n contract Contract {\n address private owner;\n\n constructor() {\n owner = address(1);\n }\n\n modifier onlyOwner() {\n require(msg.sender == owner, \"!authorized\");\n _;\n }\n\n #[derive(Debug)]\n function getSecret() public onlyOwner view returns(uint256 secret) {\n return 123;\n }\n }\n );\n\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let contract = Contract::deploy(&provider).await.unwrap();\n\n let err = contract.getSecret().call().await.unwrap_err();\n let s = err.to_string();\n assert!(s.contains(\"!authorized\"), \"{s:?}\");\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_solc_revert_example() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let sender = handle.dev_accounts().next().unwrap();\n let provider = handle.http_provider();\n\n let contract = VendingMachine::deploy(&provider).await.unwrap();\n\n let err =\n contract.buy(U256::from(100)).value(U256::from(1)).from(sender).call().await.unwrap_err();\n let s = err.to_string();\n assert!(s.contains(\"Not enough Ether provided.\"), \"{s:?}\");\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_another_revert_message() {\n sol!(\n #[sol(rpc, bytecode = \"6080806040523460135760d7908160188239f35b5f80fdfe60808060405260043610156011575f80fd5b5f3560e01c9081633fb5c1cb14604d5750638381f58a14602f575f80fd5b346049575f36600319011260495760205f54604051908152f35b5f80fd5b346049576020366003190112604957600435908115606a57505f55005b62461bcd60e51b81526020600482015260126024820152712932bb32b93a29ba3934b733a337b7a130b960711b6044820152606490fdfea2646970667358221220314bf8261cc467619137c071584f8d3bd8d9d97bf2846c138c0567040cf9828a64736f6c63430008190033\")]\n contract Contract {\n uint256 public number;\n\n #[derive(Debug)]\n function setNumber(uint256 num) public {\n require(num != 0, \"RevertStringFooBar\");\n number = num;\n }\n }\n );\n\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let contract = Contract::deploy(&provider).await.unwrap();\n\n let err = contract.setNumber(U256::from(0)).call().await.unwrap_err();\n let s = err.to_string();\n assert!(s.contains(\"RevertStringFooBar\"), \"{s:?}\");\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_solc_revert_custom_errors() {\n sol!(\n #[sol(rpc, bytecode = \"608080604052346013576081908160188239f35b5f80fdfe60808060405260043610156011575f80fd5b5f3560e01c63e57207e6146023575f80fd5b346047575f3660031901126047576373ea2a7f60e01b815260016004820152602490fd5b5f80fdfea26469706673582212202a8d69545801394af36c56ca229b52ae0b22d7b8f938b107dca8ebbf655464f764736f6c63430008190033\")]\n contract Contract {\n error AddressRevert(address);\n\n #[derive(Debug)]\n function revertAddress() public {\n revert AddressRevert(address(1));\n }\n }\n );\n\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let contract = Contract::deploy(&provider).await.unwrap();\n\n let err = contract.revertAddress().call().await.unwrap_err();\n let s = err.to_string();\n assert!(s.contains(\"execution reverted\"), \"{s:?}\");\n}\n" }, { "path": "crates/anvil/tests/it/sign.rs", "content": "use crate::utils::http_provider_with_signer;\nuse alloy_dyn_abi::TypedData;\nuse alloy_network::EthereumWallet;\nuse alloy_primitives::{Address, U256};\nuse alloy_provider::Provider;\nuse alloy_rpc_types::TransactionRequest;\nuse alloy_serde::WithOtherFields;\nuse alloy_signer::Signer;\nuse anvil::{NodeConfig, spawn};\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_sign_typed_data() {\n let (api, _handle) = spawn(NodeConfig::test()).await;\n\n let json = serde_json::json!(\n {\n \"types\": {\n \"EIP712Domain\": [\n {\n \"name\": \"name\",\n \"type\": \"string\"\n },\n {\n \"name\": \"version\",\n \"type\": \"string\"\n },\n {\n \"name\": \"chainId\",\n \"type\": \"uint256\"\n },\n {\n \"name\": \"verifyingContract\",\n \"type\": \"address\"\n }\n ],\n \"Person\": [\n {\n \"name\": \"name\",\n \"type\": \"string\"\n },\n {\n \"name\": \"wallet\",\n \"type\": \"address\"\n }\n ],\n \"Mail\": [\n {\n \"name\": \"from\",\n \"type\": \"Person\"\n },\n {\n \"name\": \"to\",\n \"type\": \"Person\"\n },\n {\n \"name\": \"contents\",\n \"type\": \"string\"\n }\n ]\n },\n \"primaryType\": \"Mail\",\n \"domain\": {\n \"name\": \"Ether Mail\",\n \"version\": \"1\",\n \"chainId\": 1,\n \"verifyingContract\": \"0xCcCCccccCCCCcCCCCCCcCcCccCcCCCcCcccccccC\"\n },\n \"message\": {\n \"from\": {\n \"name\": \"Cow\",\n \"wallet\": \"0xCD2a3d9F938E13CD947Ec05AbC7FE734Df8DD826\"\n },\n \"to\": {\n \"name\": \"Bob\",\n \"wallet\": \"0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB\"\n },\n \"contents\": \"Hello, Bob!\"\n }\n });\n\n let typed_data: TypedData = serde_json::from_value(json).unwrap();\n\n // `curl -X POST -H \"Content-Type: application/json\" -d '{\"jsonrpc\":\"2.0\",\"method\": \"eth_signTypedData_v4\", \"params\": [\"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\", {\"types\":{\"EIP712Domain\":[{\"name\":\"name\",\"type\":\"string\"},{\"name\":\"version\",\"type\":\"string\"},{\"name\":\"chainId\",\"type\":\"uint256\"},{\"name\":\"verifyingContract\",\"type\":\"address\"}],\"Person\":[{\"name\":\"name\",\"type\":\"string\"},{\"name\":\"wallet\",\"type\":\"address\"}],\"Mail\":[{\"name\":\"from\",\"type\":\"Person\"},{\"name\":\"to\",\"type\":\"Person\"},{\"name\":\"contents\",\"type\":\"string\"}]},\"primaryType\":\"Mail\",\"domain\":{\"name\":\"Ether Mail\",\"version\":\"1\",\"chainId\":1,\"verifyingContract\":\"0xCcCCccccCCCCcCCCCCCcCcCccCcCCCcCcccccccC\"},\"message\":{\"from\":{\"name\":\"Cow\",\"wallet\":\"0xCD2a3d9F938E13CD947Ec05AbC7FE734Df8DD826\"},\"to\":{\"name\":\"Bob\",\"wallet\":\"0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB\"},\"contents\":\"Hello, Bob!\"}}],\"id\":67}' http://localhost:8545`\n\n let signature = api\n .sign_typed_data_v4(\n \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\".parse().unwrap(),\n &typed_data,\n )\n .await\n .unwrap();\n assert_eq!(\n signature,\n \"0x6ea8bb309a3401225701f3565e32519f94a0ea91a5910ce9229fe488e773584c0390416a2190d9560219dab757ecca2029e63fa9d1c2aebf676cc25b9f03126a1b\".to_string()\n );\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_sign_typed_data_os() {\n let (api, _handle) = spawn(NodeConfig::test()).await;\n\n let json = serde_json::json!(\n {\n \"types\": {\n \"EIP712Domain\": [\n {\n \"name\": \"name\",\n \"type\": \"string\"\n },\n {\n \"name\": \"version\",\n \"type\": \"string\"\n },\n {\n \"name\": \"chainId\",\n \"type\": \"uint256\"\n },\n {\n \"name\": \"verifyingContract\",\n \"type\": \"address\"\n }\n ],\n \"OrderComponents\": [\n {\n \"name\": \"offerer\",\n \"type\": \"address\"\n },\n {\n \"name\": \"zone\",\n \"type\": \"address\"\n },\n {\n \"name\": \"offer\",\n \"type\": \"OfferItem[]\"\n },\n {\n \"name\": \"consideration\",\n \"type\": \"ConsiderationItem[]\"\n },\n {\n \"name\": \"orderType\",\n \"type\": \"uint8\"\n },\n {\n \"name\": \"startTime\",\n \"type\": \"uint256\"\n },\n {\n \"name\": \"endTime\",\n \"type\": \"uint256\"\n },\n {\n \"name\": \"zoneHash\",\n \"type\": \"bytes32\"\n },\n {\n \"name\": \"salt\",\n \"type\": \"uint256\"\n },\n {\n \"name\": \"conduitKey\",\n \"type\": \"bytes32\"\n },\n {\n \"name\": \"counter\",\n \"type\": \"uint256\"\n }\n ],\n \"OfferItem\": [\n {\n \"name\": \"itemType\",\n \"type\": \"uint8\"\n },\n {\n \"name\": \"token\",\n \"type\": \"address\"\n },\n {\n \"name\": \"identifierOrCriteria\",\n \"type\": \"uint256\"\n },\n {\n \"name\": \"startAmount\",\n \"type\": \"uint256\"\n },\n {\n \"name\": \"endAmount\",\n \"type\": \"uint256\"\n }\n ],\n \"ConsiderationItem\": [\n {\n \"name\": \"itemType\",\n \"type\": \"uint8\"\n },\n {\n \"name\": \"token\",\n \"type\": \"address\"\n },\n {\n \"name\": \"identifierOrCriteria\",\n \"type\": \"uint256\"\n },\n {\n \"name\": \"startAmount\",\n \"type\": \"uint256\"\n },\n {\n \"name\": \"endAmount\",\n \"type\": \"uint256\"\n },\n {\n \"name\": \"recipient\",\n \"type\": \"address\"\n }\n ]\n },\n \"primaryType\": \"OrderComponents\",\n \"domain\": {\n \"name\": \"Seaport\",\n \"version\": \"1.1\",\n \"chainId\": \"1\",\n \"verifyingContract\": \"0x00000000006c3852cbEf3e08E8dF289169EdE581\"\n },\n \"message\": {\n \"offerer\": \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\",\n \"offer\": [\n {\n \"itemType\": \"3\",\n \"token\": \"0xA604060890923Ff400e8c6f5290461A83AEDACec\",\n \"identifierOrCriteria\": \"110194434039389003190498847789203126033799499726478230611233094448886344768909\",\n \"startAmount\": \"1\",\n \"endAmount\": \"1\"\n }\n ],\n \"consideration\": [\n {\n \"itemType\": \"0\",\n \"token\": \"0x0000000000000000000000000000000000000000\",\n \"identifierOrCriteria\": \"0\",\n \"startAmount\": \"487500000000000000\",\n \"endAmount\": \"487500000000000000\",\n \"recipient\": \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\"\n },\n {\n \"itemType\": \"0\",\n \"token\": \"0x0000000000000000000000000000000000000000\",\n \"identifierOrCriteria\": \"0\",\n \"startAmount\": \"12500000000000000\",\n \"endAmount\": \"12500000000000000\",\n \"recipient\": \"0x8De9C5A032463C561423387a9648c5C7BCC5BC90\"\n }\n ],\n \"startTime\": \"1658645591\",\n \"endTime\": \"1659250386\",\n \"orderType\": \"3\",\n \"zone\": \"0x004C00500000aD104D7DBd00e3ae0A5C00560C00\",\n \"zoneHash\": \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"salt\": \"16178208897136618\",\n \"conduitKey\": \"0x0000007b02230091a7ed01230072f7006a004d60a8d4e71d599b8104250f0000\",\n \"totalOriginalConsiderationItems\": \"2\",\n \"counter\": \"0\"\n }\n }\n );\n\n let typed_data: TypedData = serde_json::from_value(json).unwrap();\n\n // `curl -X POST http://localhost:8545 -d '{\"jsonrpc\": \"2.0\", \"method\": \"eth_signTypedData_v4\", \"params\": [\"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\", {\"types\":{\"EIP712Domain\":[{\"name\":\"name\",\"type\":\"string\"},{\"name\":\"version\",\"type\":\"string\"},{\"name\":\"chainId\",\"type\":\"uint256\"},{\"name\":\"verifyingContract\",\"type\":\"address\"}],\"OrderComponents\":[{\"name\":\"offerer\",\"type\":\"address\"},{\"name\":\"zone\",\"type\":\"address\"},{\"name\":\"offer\",\"type\":\"OfferItem[]\"},{\"name\":\"consideration\",\"type\":\"ConsiderationItem[]\"},{\"name\":\"orderType\",\"type\":\"uint8\"},{\"name\":\"startTime\",\"type\":\"uint256\"},{\"name\":\"endTime\",\"type\":\"uint256\"},{\"name\":\"zoneHash\",\"type\":\"bytes32\"},{\"name\":\"salt\",\"type\":\"uint256\"},{\"name\":\"conduitKey\",\"type\":\"bytes32\"},{\"name\":\"counter\",\"type\":\"uint256\"}],\"OfferItem\":[{\"name\":\"itemType\",\"type\":\"uint8\"},{\"name\":\"token\",\"type\":\"address\"},{\"name\":\"identifierOrCriteria\",\"type\":\"uint256\"},{\"name\":\"startAmount\",\"type\":\"uint256\"},{\"name\":\"endAmount\",\"type\":\"uint256\"}],\"ConsiderationItem\":[{\"name\":\"itemType\",\"type\":\"uint8\"},{\"name\":\"token\",\"type\":\"address\"},{\"name\":\"identifierOrCriteria\",\"type\":\"uint256\"},{\"name\":\"startAmount\",\"type\":\"uint256\"},{\"name\":\"endAmount\",\"type\":\"uint256\"},{\"name\":\"recipient\",\"type\":\"address\"}]},\"primaryType\":\"OrderComponents\",\"domain\":{\"name\":\"Seaport\",\"version\":\"1.1\",\"chainId\":\"1\",\"verifyingContract\":\"0x00000000006c3852cbEf3e08E8dF289169EdE581\"},\"message\":{\"offerer\":\"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\",\"offer\":[{\"itemType\":\"3\",\"token\":\"0xA604060890923Ff400e8c6f5290461A83AEDACec\",\"identifierOrCriteria\":\"110194434039389003190498847789203126033799499726478230611233094448886344768909\",\"startAmount\":\"1\",\"endAmount\":\"1\"}],\"consideration\":[{\"itemType\":\"0\",\"token\":\"0x0000000000000000000000000000000000000000\",\"identifierOrCriteria\":\"0\",\"startAmount\":\"487500000000000000\",\"endAmount\":\"487500000000000000\",\"recipient\":\"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\"},{\"itemType\":\"0\",\"token\":\"0x0000000000000000000000000000000000000000\",\"identifierOrCriteria\":\"0\",\"startAmount\":\"12500000000000000\",\"endAmount\":\"12500000000000000\",\"recipient\":\"0x8De9C5A032463C561423387a9648c5C7BCC5BC90\"}],\"startTime\":\"1658645591\",\"endTime\":\"1659250386\",\"orderType\":\"3\",\"zone\":\"0x004C00500000aD104D7DBd00e3ae0A5C00560C00\",\"zoneHash\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"salt\":\"16178208897136618\",\"conduitKey\":\"0x0000007b02230091a7ed01230072f7006a004d60a8d4e71d599b8104250f0000\",\"totalOriginalConsiderationItems\":\"2\",\"counter\":\"0\"}}], \"id\": \"1\"}' -H \"Content-Type: application/json\"`\n\n let signature = api\n .sign_typed_data_v4(\n \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\".parse().unwrap(),\n &typed_data,\n )\n .await\n .unwrap();\n\n assert_eq!(\n signature,\n \"0xedb0fa55ac67e3ca52b6bd6ee3576b193731adc2aff42151f67826932fa9f6191261ebdecc2c650204ff7625752b033293fb67ef5cfca78e16de359200040b761b\".to_string()\n );\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_sign_transaction() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n let accounts = handle.dev_wallets().collect::>();\n let from = accounts[0].address();\n let to = accounts[1].address();\n\n // craft the tx\n // specify the `from` field so that the client knows which account to use\n let tx = TransactionRequest::default()\n .nonce(10)\n .max_fee_per_gas(100)\n .max_priority_fee_per_gas(101)\n .to(to)\n .value(U256::from(1001u64))\n .from(from);\n let tx = WithOtherFields::new(tx);\n // sign it via the eth_signTransaction API\n let signed_tx = api.sign_transaction(tx).await.unwrap();\n\n assert_eq!(\n signed_tx,\n \"0x02f866827a690a65648252089470997970c51812dc3a010c7d01b50e0d17dc79c88203e980c001a0e4de88aefcf87ccb04466e60de66a83192e46aa26177d5ea35efbfd43fd0ecdca00e3148e0e8e0b9a6f9b329efd6e30c4a461920f3a27497be3dbefaba996601da\"\n );\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn rejects_different_chain_id() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let wallet = handle.dev_wallets().next().unwrap().with_chain_id(Some(1));\n let provider = http_provider_with_signer(&handle.http_endpoint(), EthereumWallet::from(wallet));\n\n let tx = TransactionRequest::default().to(Address::random()).value(U256::from(100));\n let tx = WithOtherFields::new(tx);\n let res = provider.send_transaction(tx).await;\n let err = res.unwrap_err();\n assert!(err.to_string().contains(\"does not match the signer's\"), \"{}\", err.to_string());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn rejects_invalid_chain_id() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let wallet = handle.dev_wallets().next().unwrap();\n let wallet = wallet.with_chain_id(Some(99u64));\n let provider = http_provider_with_signer(&handle.http_endpoint(), EthereumWallet::from(wallet));\n let tx = TransactionRequest::default().to(Address::random()).value(U256::from(100u64));\n let tx = WithOtherFields::new(tx);\n let res = provider.send_transaction(tx).await;\n let _err = res.unwrap_err();\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_sign_typed_seaport_data() {\n let (api, _handle) = spawn(NodeConfig::test()).await;\n\n let json = serde_json::json!(\n {\n \"types\": {\n \"EIP712Domain\": [\n {\n \"name\": \"name\",\n \"type\": \"string\"\n },\n {\n \"name\": \"version\",\n \"type\": \"string\"\n },\n {\n \"name\": \"chainId\",\n \"type\": \"uint256\"\n },\n {\n \"name\": \"verifyingContract\",\n \"type\": \"address\"\n }\n ],\n \"OrderComponents\": [\n {\n \"name\": \"offerer\",\n \"type\": \"address\"\n },\n {\n \"name\": \"zone\",\n \"type\": \"address\"\n },\n {\n \"name\": \"offer\",\n \"type\": \"OfferItem[]\"\n },\n {\n \"name\": \"consideration\",\n \"type\": \"ConsiderationItem[]\"\n },\n {\n \"name\": \"orderType\",\n \"type\": \"uint8\"\n },\n {\n \"name\": \"startTime\",\n \"type\": \"uint256\"\n },\n {\n \"name\": \"endTime\",\n \"type\": \"uint256\"\n },\n {\n \"name\": \"zoneHash\",\n \"type\": \"bytes32\"\n },\n {\n \"name\": \"salt\",\n \"type\": \"uint256\"\n },\n {\n \"name\": \"conduitKey\",\n \"type\": \"bytes32\"\n },\n {\n \"name\": \"counter\",\n \"type\": \"uint256\"\n }\n ],\n \"OfferItem\": [\n {\n \"name\": \"itemType\",\n \"type\": \"uint8\"\n },\n {\n \"name\": \"token\",\n \"type\": \"address\"\n },\n {\n \"name\": \"identifierOrCriteria\",\n \"type\": \"uint256\"\n },\n {\n \"name\": \"startAmount\",\n \"type\": \"uint256\"\n },\n {\n \"name\": \"endAmount\",\n \"type\": \"uint256\"\n }\n ],\n \"ConsiderationItem\": [\n {\n \"name\": \"itemType\",\n \"type\": \"uint8\"\n },\n {\n \"name\": \"token\",\n \"type\": \"address\"\n },\n {\n \"name\": \"identifierOrCriteria\",\n \"type\": \"uint256\"\n },\n {\n \"name\": \"startAmount\",\n \"type\": \"uint256\"\n },\n {\n \"name\": \"endAmount\",\n \"type\": \"uint256\"\n },\n {\n \"name\": \"recipient\",\n \"type\": \"address\"\n }\n ]\n },\n \"primaryType\": \"OrderComponents\",\n \"domain\": {\n \"name\": \"Seaport\",\n \"version\": \"1.1\",\n \"chainId\": \"137\",\n \"verifyingContract\": \"0x00000000006c3852cbEf3e08E8dF289169EdE581\"\n },\n \"message\": {\n \"offerer\": \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\",\n \"offer\": [\n {\n \"itemType\": \"3\",\n \"token\": \"0xA604060890923Ff400e8c6f5290461A83AEDACec\",\n \"identifierOrCriteria\": \"110194434039389003190498847789203126033799499726478230611233094448886344768909\",\n \"startAmount\": \"1\",\n \"endAmount\": \"1\"\n }\n ],\n \"consideration\": [\n {\n \"itemType\": \"0\",\n \"token\": \"0x0000000000000000000000000000000000000000\",\n \"identifierOrCriteria\": \"0\",\n \"startAmount\": \"487500000000000000\",\n \"endAmount\": \"487500000000000000\",\n \"recipient\": \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\"\n },\n {\n \"itemType\": \"0\",\n \"token\": \"0x0000000000000000000000000000000000000000\",\n \"identifierOrCriteria\": \"0\",\n \"startAmount\": \"12500000000000000\",\n \"endAmount\": \"12500000000000000\",\n \"recipient\": \"0x8De9C5A032463C561423387a9648c5C7BCC5BC90\"\n }\n ],\n \"startTime\": \"1658645591\",\n \"endTime\": \"1659250386\",\n \"orderType\": \"3\",\n \"zone\": \"0x004C00500000aD104D7DBd00e3ae0A5C00560C00\",\n \"zoneHash\": \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"salt\": \"16178208897136618\",\n \"conduitKey\": \"0x0000007b02230091a7ed01230072f7006a004d60a8d4e71d599b8104250f0000\",\n \"totalOriginalConsiderationItems\": \"2\",\n \"counter\": \"0\"\n }\n }\n );\n\n let typed_data: TypedData = serde_json::from_value(json).unwrap();\n\n // `curl -X POST http://localhost:8545 -d '{\"jsonrpc\": \"2.0\", \"method\": \"eth_signTypedData_v4\", \"params\": [\"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\", \"{\\\"types\\\":{\\\"EIP712Domain\\\":[{\\\"name\\\":\\\"name\\\",\\\"type\\\":\\\"string\\\"},{\\\"name\\\":\\\"version\\\",\\\"type\\\":\\\"string\\\"},{\\\"name\\\":\\\"chainId\\\",\\\"type\\\":\\\"uint256\\\"},{\\\"name\\\":\\\"verifyingContract\\\",\\\"type\\\":\\\"address\\\"}],\\\"OrderComponents\\\":[{\\\"name\\\":\\\"offerer\\\",\\\"type\\\":\\\"address\\\"},{\\\"name\\\":\\\"zone\\\",\\\"type\\\":\\\"address\\\"},{\\\"name\\\":\\\"offer\\\",\\\"type\\\":\\\"OfferItem[]\\\"},{\\\"name\\\":\\\"consideration\\\",\\\"type\\\":\\\"ConsiderationItem[]\\\"},{\\\"name\\\":\\\"orderType\\\",\\\"type\\\":\\\"uint8\\\"},{\\\"name\\\":\\\"startTime\\\",\\\"type\\\":\\\"uint256\\\"},{\\\"name\\\":\\\"endTime\\\",\\\"type\\\":\\\"uint256\\\"},{\\\"name\\\":\\\"zoneHash\\\",\\\"type\\\":\\\"bytes32\\\"},{\\\"name\\\":\\\"salt\\\",\\\"type\\\":\\\"uint256\\\"},{\\\"name\\\":\\\"conduitKey\\\",\\\"type\\\":\\\"bytes32\\\"},{\\\"name\\\":\\\"counter\\\",\\\"type\\\":\\\"uint256\\\"}],\\\"OfferItem\\\":[{\\\"name\\\":\\\"itemType\\\",\\\"type\\\":\\\"uint8\\\"},{\\\"name\\\":\\\"token\\\",\\\"type\\\":\\\"address\\\"},{\\\"name\\\":\\\"identifierOrCriteria\\\",\\\"type\\\":\\\"uint256\\\"},{\\\"name\\\":\\\"startAmount\\\",\\\"type\\\":\\\"uint256\\\"},{\\\"name\\\":\\\"endAmount\\\",\\\"type\\\":\\\"uint256\\\"}],\\\"ConsiderationItem\\\":[{\\\"name\\\":\\\"itemType\\\",\\\"type\\\":\\\"uint8\\\"},{\\\"name\\\":\\\"token\\\",\\\"type\\\":\\\"address\\\"},{\\\"name\\\":\\\"identifierOrCriteria\\\",\\\"type\\\":\\\"uint256\\\"},{\\\"name\\\":\\\"startAmount\\\",\\\"type\\\":\\\"uint256\\\"},{\\\"name\\\":\\\"endAmount\\\",\\\"type\\\":\\\"uint256\\\"},{\\\"name\\\":\\\"recipient\\\",\\\"type\\\":\\\"address\\\"}]},\\\"primaryType\\\":\\\"OrderComponents\\\",\\\"domain\\\":{\\\"name\\\":\\\"Seaport\\\",\\\"version\\\":\\\"1.1\\\",\\\"chainId\\\":\\\"137\\\",\\\"verifyingContract\\\":\\\"0x00000000006c3852cbEf3e08E8dF289169EdE581\\\"},\\\"message\\\":{\\\"offerer\\\":\\\"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\\\",\\\"offer\\\":[{\\\"itemType\\\":\\\"3\\\",\\\"token\\\":\\\"0xA604060890923Ff400e8c6f5290461A83AEDACec\\\",\\\"identifierOrCriteria\\\":\\\"110194434039389003190498847789203126033799499726478230611233094448886344768909\\\",\\\"startAmount\\\":\\\"1\\\",\\\"endAmount\\\":\\\"1\\\"}],\\\"consideration\\\":[{\\\"itemType\\\":\\\"0\\\",\\\"token\\\":\\\"0x0000000000000000000000000000000000000000\\\",\\\"identifierOrCriteria\\\":\\\"0\\\",\\\"startAmount\\\":\\\"487500000000000000\\\",\\\"endAmount\\\":\\\"487500000000000000\\\",\\\"recipient\\\":\\\"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\\\"},{\\\"itemType\\\":\\\"0\\\",\\\"token\\\":\\\"0x0000000000000000000000000000000000000000\\\",\\\"identifierOrCriteria\\\":\\\"0\\\",\\\"startAmount\\\":\\\"12500000000000000\\\",\\\"endAmount\\\":\\\"12500000000000000\\\",\\\"recipient\\\":\\\"0x8De9C5A032463C561423387a9648c5C7BCC5BC90\\\"}],\\\"startTime\\\":\\\"1658645591\\\",\\\"endTime\\\":\\\"1659250386\\\",\\\"orderType\\\":\\\"3\\\",\\\"zone\\\":\\\"0x004C00500000aD104D7DBd00e3ae0A5C00560C00\\\",\\\"zoneHash\\\":\\\"0x0000000000000000000000000000000000000000000000000000000000000000\\\",\\\"salt\\\":\\\"16178208897136618\\\",\\\"conduitKey\\\":\\\"0x0000007b02230091a7ed01230072f7006a004d60a8d4e71d599b8104250f0000\\\",\\\"totalOriginalConsiderationItems\\\":\\\"2\\\",\\\"counter\\\":\\\"0\\\"}}\"], \"id\": \"1\"}' -H \"Content-Type: application/json\"`\n\n let signature = api\n .sign_typed_data_v4(\n \"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\".parse().unwrap(),\n &typed_data,\n )\n .await\n .unwrap();\n\n assert_eq!(\n signature,\n \"0xed9afe7f377155ee3a42b25b696d79b55d441aeac7790b97a51b54ad0569b9665ea30bf8e8df12d6ee801c4dcb85ecfb8b23a6f7ae166d5af9acac9befb905451c\".to_string()\n );\n}\n" }, { "path": "crates/anvil/tests/it/simulate.rs", "content": "//! general eth api tests\n\nuse alloy_primitives::{TxKind, U256, address};\nuse alloy_rpc_types::{\n BlockOverrides,\n request::TransactionRequest,\n simulate::{SimBlock, SimulatePayload},\n state::{AccountOverride, StateOverridesBuilder},\n};\nuse anvil::{NodeConfig, spawn};\nuse foundry_test_utils::rpc;\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_simulate_v1() {\n crate::init_tracing();\n let (api, _) =\n spawn(NodeConfig::test().with_eth_rpc_url(Some(rpc::next_http_archive_rpc_url()))).await;\n let block_overrides =\n Some(BlockOverrides { base_fee: Some(U256::from(9)), ..Default::default() });\n let account_override =\n AccountOverride { balance: Some(U256::from(999999999999u64)), ..Default::default() };\n let state_overrides = Some(\n StateOverridesBuilder::with_capacity(1)\n .append(address!(\"0xc000000000000000000000000000000000000001\"), account_override)\n .build(),\n );\n let tx_request = TransactionRequest {\n from: Some(address!(\"0xc000000000000000000000000000000000000001\")),\n to: Some(TxKind::from(address!(\"0xc000000000000000000000000000000000000001\"))),\n value: Some(U256::from(1)),\n ..Default::default()\n };\n let payload = SimulatePayload {\n block_state_calls: vec![SimBlock {\n block_overrides,\n state_overrides,\n calls: vec![tx_request],\n }],\n trace_transfers: true,\n validation: false,\n return_full_transactions: true,\n };\n let _res = api.simulate_v1(payload, None).await.unwrap();\n}\n" }, { "path": "crates/anvil/tests/it/state.rs", "content": "//! general eth api tests\n\nuse crate::abi::Greeter;\nuse alloy_network::{ReceiptResponse, TransactionBuilder};\nuse alloy_primitives::{Bytes, U256, Uint, address, b256, utils::Unit};\nuse alloy_provider::Provider;\nuse alloy_rpc_types::{BlockId, TransactionRequest};\nuse alloy_serde::WithOtherFields;\nuse anvil::{NodeConfig, eth::backend::db::SerializableState, spawn};\nuse foundry_test_utils::rpc::next_http_archive_rpc_url;\nuse revm::{\n context_interface::block::BlobExcessGasAndPrice,\n primitives::eip4844::BLOB_BASE_FEE_UPDATE_FRACTION_PRAGUE,\n};\nuse serde_json::json;\nuse std::str::FromStr;\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_load_state() {\n let tmp = tempfile::tempdir().unwrap();\n let state_file = tmp.path().join(\"state.json\");\n\n let (api, _handle) = spawn(NodeConfig::test()).await;\n\n api.mine_one().await;\n api.mine_one().await;\n\n let num = api.block_number().unwrap();\n\n let state = api.serialized_state(false).await.unwrap();\n foundry_common::fs::write_json_file(&state_file, &state).unwrap();\n\n let (api, _handle) = spawn(NodeConfig::test().with_init_state_path(state_file)).await;\n\n let num2 = api.block_number().unwrap();\n\n // Ref: https://github.com/foundry-rs/foundry/issues/9017\n // Check responses of eth_blockNumber and eth_getBlockByNumber don't deviate after loading state\n let num_from_tag = api\n .block_by_number(alloy_eips::BlockNumberOrTag::Latest)\n .await\n .unwrap()\n .unwrap()\n .header\n .number;\n assert_eq!(num, num2);\n\n assert_eq!(num, U256::from(num_from_tag));\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn finalized_block_hash_consistent_after_load_state() {\n use alloy_eips::BlockNumberOrTag;\n\n let tmp = tempfile::tempdir().unwrap();\n let state_file = tmp.path().join(\"state.json\");\n\n let (api, _handle) = spawn(NodeConfig::test()).await;\n\n api.mine_one().await;\n\n // Get the original genesis block hash\n let original_genesis = api.block_by_number(BlockNumberOrTag::Number(0)).await.unwrap().unwrap();\n let original_genesis_hash = original_genesis.header.hash;\n\n let state = api.serialized_state(false).await.unwrap();\n foundry_common::fs::write_json_file(&state_file, &state).unwrap();\n\n // Load state with a different genesis timestamp.\n // The new instance will create its own genesis block with a different timestamp,\n // but then load_state should overwrite it. The bug is that genesis_hash field isn't updated.\n let (api, _handle) = spawn(\n NodeConfig::test()\n .with_genesis_timestamp(Some(original_genesis.header.timestamp + 1000))\n .with_init_state_path(state_file),\n )\n .await;\n\n // Query finalized block - should return genesis (block 0) since best_number is small\n let finalized_block = api.block_by_number(BlockNumberOrTag::Finalized).await.unwrap().unwrap();\n let finalized_hash = finalized_block.header.hash;\n let finalized_number = finalized_block.header.number;\n\n // Query block by the finalized block's number directly\n let block_by_number =\n api.block_by_number(BlockNumberOrTag::Number(finalized_number)).await.unwrap().unwrap();\n let block_by_number_hash = block_by_number.header.hash;\n\n // Verify the loaded genesis matches the original\n assert_eq!(\n block_by_number_hash, original_genesis_hash,\n \"Loaded genesis should match original genesis hash\"\n );\n\n // Both finalized and block 0 should return the same hash\n assert_eq!(\n finalized_hash, block_by_number_hash,\n \"Finalized block hash should match block queried by number\"\n );\n\n // Also verify Earliest block tag returns consistent hash\n let earliest_block = api.block_by_number(BlockNumberOrTag::Earliest).await.unwrap().unwrap();\n assert_eq!(\n earliest_block.header.hash, original_genesis_hash,\n \"Earliest block hash should match original genesis hash\"\n );\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_load_existing_state_legacy() {\n let state_file = \"test-data/state-dump-legacy.json\";\n\n let (api, _handle) = spawn(NodeConfig::test().with_init_state_path(state_file)).await;\n\n let block_number = api.block_number().unwrap();\n assert_eq!(block_number, Uint::from(2));\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_load_existing_state_legacy_stress() {\n let state_file = \"test-data/state-dump-legacy-stress.json\";\n\n let (api, _handle) = spawn(NodeConfig::test().with_init_state_path(state_file)).await;\n\n let block_number = api.block_number().unwrap();\n assert_eq!(block_number, Uint::from(5));\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_load_existing_state() {\n let state_file = \"test-data/state-dump.json\";\n\n let (api, _handle) = spawn(NodeConfig::test().with_init_state_path(state_file)).await;\n\n let block_number = api.block_number().unwrap();\n assert_eq!(block_number, Uint::from(2));\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_make_sure_historical_state_is_not_cleared_on_dump() {\n let tmp = tempfile::tempdir().unwrap();\n let state_file = tmp.path().join(\"state.json\");\n\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n let provider = handle.http_provider();\n\n let greeter = Greeter::deploy(&provider, \"Hello\".to_string()).await.unwrap();\n\n let address = greeter.address();\n\n let _tx = greeter\n .setGreeting(\"World!\".to_string())\n .send()\n .await\n .unwrap()\n .get_receipt()\n .await\n .unwrap();\n\n api.mine_one().await;\n\n let ser_state = api.serialized_state(true).await.unwrap();\n foundry_common::fs::write_json_file(&state_file, &ser_state).unwrap();\n\n let block_number = api.block_number().unwrap();\n assert_eq!(block_number, Uint::from(3));\n\n // Makes sure historical states of the new instance are not cleared.\n let code = provider.get_code_at(*address).block_id(BlockId::number(2)).await.unwrap();\n\n assert_ne!(code, Bytes::new());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_preserve_historical_states_between_dump_and_load() {\n let tmp = tempfile::tempdir().unwrap();\n let state_file = tmp.path().join(\"state.json\");\n\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n let provider = handle.http_provider();\n\n let greeter = Greeter::deploy(&provider, \"Hello\".to_string()).await.unwrap();\n\n let address = greeter.address();\n\n let deploy_blk_num = provider.get_block_number().await.unwrap();\n\n let tx = greeter\n .setGreeting(\"World!\".to_string())\n .send()\n .await\n .unwrap()\n .get_receipt()\n .await\n .unwrap();\n\n let change_greeting_blk_num = tx.block_number.unwrap();\n\n api.mine_one().await;\n\n let ser_state = api.serialized_state(true).await.unwrap();\n foundry_common::fs::write_json_file(&state_file, &ser_state).unwrap();\n\n let (api, handle) = spawn(NodeConfig::test().with_init_state_path(state_file)).await;\n\n let block_number = api.block_number().unwrap();\n assert_eq!(block_number, Uint::from(3));\n\n let provider = handle.http_provider();\n\n let greeter = Greeter::new(*address, provider);\n\n let greeting_at_init =\n greeter.greet().block(BlockId::number(deploy_blk_num)).call().await.unwrap();\n\n assert_eq!(greeting_at_init, \"Hello\");\n\n let greeting_after_change =\n greeter.greet().block(BlockId::number(change_greeting_blk_num)).call().await.unwrap();\n\n assert_eq!(greeting_after_change, \"World!\");\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_load_state() {\n let (api, handle) = spawn(\n NodeConfig::test()\n .with_eth_rpc_url(Some(next_http_archive_rpc_url()))\n .with_fork_block_number(Some(21070682u64)),\n )\n .await;\n\n let bob = address!(\"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\");\n let alice = address!(\"0x9276449EaC5b4f7Bc17cFC6700f7BeeB86F9bCd0\");\n\n let provider = handle.http_provider();\n\n let init_nonce_bob = provider.get_transaction_count(bob).await.unwrap();\n\n let init_balance_alice = provider.get_balance(alice).await.unwrap();\n\n let value = Unit::ETHER.wei().saturating_mul(U256::from(1)); // 1 ether\n let tx = TransactionRequest::default().with_to(alice).with_value(value).with_from(bob);\n let tx = WithOtherFields::new(tx);\n\n let receipt = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n assert!(receipt.status());\n\n let serialized_state = api.serialized_state(false).await.unwrap();\n\n let state_dump_block = api.block_number().unwrap();\n\n let (api, handle) = spawn(\n NodeConfig::test()\n .with_eth_rpc_url(Some(next_http_archive_rpc_url()))\n .with_fork_block_number(Some(21070686u64)) // Forked chain has moved forward\n .with_init_state(Some(serialized_state)),\n )\n .await;\n\n // Ensure the initial block number is the fork_block_number and not the state_dump_block\n let block_number = api.block_number().unwrap();\n assert_eq!(block_number, U256::from(21070686u64));\n assert_ne!(block_number, state_dump_block);\n\n let provider = handle.http_provider();\n\n let restart_nonce_bob = provider.get_transaction_count(bob).await.unwrap();\n\n let restart_balance_alice = provider.get_balance(alice).await.unwrap();\n\n assert_eq!(init_nonce_bob + 1, restart_nonce_bob);\n\n assert_eq!(init_balance_alice + value, restart_balance_alice);\n\n // Send another tx to check if the state is preserved\n\n let tx = TransactionRequest::default().with_to(alice).with_value(value).with_from(bob);\n let tx = WithOtherFields::new(tx);\n\n let receipt = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n assert!(receipt.status());\n\n let nonce_bob = provider.get_transaction_count(bob).await.unwrap();\n\n let balance_alice = provider.get_balance(alice).await.unwrap();\n\n let tx = TransactionRequest::default()\n .with_to(alice)\n .with_value(value)\n .with_from(bob)\n .with_nonce(nonce_bob);\n let tx = WithOtherFields::new(tx);\n\n let receipt = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n assert!(receipt.status());\n\n let latest_nonce_bob = provider.get_transaction_count(bob).await.unwrap();\n\n let latest_balance_alice = provider.get_balance(alice).await.unwrap();\n\n assert_eq!(nonce_bob + 1, latest_nonce_bob);\n\n assert_eq!(balance_alice + value, latest_balance_alice);\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_fork_load_state_with_greater_state_block() {\n let (api, _handle) = spawn(\n NodeConfig::test()\n .with_eth_rpc_url(Some(next_http_archive_rpc_url()))\n .with_fork_block_number(Some(21070682u64)),\n )\n .await;\n\n api.mine_one().await;\n\n let block_number = api.block_number().unwrap();\n\n let serialized_state = api.serialized_state(false).await.unwrap();\n\n assert_eq!(serialized_state.best_block_number, Some(block_number.to::()));\n\n let (api, _handle) = spawn(\n NodeConfig::test()\n .with_eth_rpc_url(Some(next_http_archive_rpc_url()))\n .with_fork_block_number(Some(21070682u64)) // Forked chain has moved forward\n .with_init_state(Some(serialized_state)),\n )\n .await;\n\n let new_block_number = api.block_number().unwrap();\n\n assert_eq!(new_block_number, block_number);\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn computes_next_base_fee_after_loading_state() {\n let tmp = tempfile::tempdir().unwrap();\n let state_file = tmp.path().join(\"state.json\");\n\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n let bob = address!(\"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\");\n let alice = address!(\"0x9276449EaC5b4f7Bc17cFC6700f7BeeB86F9bCd0\");\n\n let provider = handle.http_provider();\n\n let base_fee_empty_chain = api.backend.fees().base_fee();\n\n let value = Unit::ETHER.wei().saturating_mul(U256::from(1)); // 1 ether\n let tx = TransactionRequest::default().with_to(alice).with_value(value).with_from(bob);\n let tx = WithOtherFields::new(tx);\n\n let _receipt = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n let base_fee_after_one_tx = api.backend.fees().base_fee();\n // the test is meaningless if this does not hold\n assert_ne!(base_fee_empty_chain, base_fee_after_one_tx);\n\n let ser_state = api.serialized_state(true).await.unwrap();\n foundry_common::fs::write_json_file(&state_file, &ser_state).unwrap();\n\n let (api, _handle) = spawn(NodeConfig::test().with_init_state_path(state_file)).await;\n let base_fee_after_reload = api.backend.fees().base_fee();\n assert_eq!(base_fee_after_reload, base_fee_after_one_tx);\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_backward_compatibility_deserialization_v1_2() {\n let old_format = r#\"{\n \"block\": {\n \"number\": \"0x5\",\n \"coinbase\": \"0x1234567890123456789012345678901234567890\",\n \"timestamp\": \"0x688c83b5\",\n \"gas_limit\": \"0x1c9c380\",\n \"basefee\": \"0x3b9aca00\", \n \"difficulty\": \"0x0\",\n \"prevrandao\": \"0xecc5f0af8ff6b65c14bfdac55ba9db870d89482eb2b87200c6d7e7cd3a3a5ad5\",\n \"blob_excess_gas_and_price\": {\n \"excess_blob_gas\": 0,\n \"blob_gasprice\": 1\n }\n },\n \"accounts\": {},\n \"best_block_number\": \"0x5\",\n \"blocks\": [],\n \"transactions\": []\n }\"#;\n\n let state: SerializableState = serde_json::from_str(old_format).unwrap();\n assert!(state.block.is_some());\n let block_env = state.block.unwrap();\n assert_eq!(block_env.number, U256::from(5));\n // Verify coinbase was converted to beneficiary\n assert_eq!(block_env.beneficiary, address!(\"0x1234567890123456789012345678901234567890\"));\n\n // New format with beneficiary and numeric values\n let new_format = r#\"{\n \"block\": {\n \"number\": 6,\n \"beneficiary\": \"0x1234567890123456789012345678901234567891\",\n \"timestamp\": 1751619509,\n \"gas_limit\": 30000000,\n \"basefee\": 1000000000,\n \"difficulty\": \"0x0\",\n \"prevrandao\": \"0xecc5f0af8ff6b65c14bfdac55ba9db870d89482eb2b87200c6d7e7cd3a3a5ad5\",\n \"blob_excess_gas_and_price\": {\n \"excess_blob_gas\": 0,\n \"blob_gasprice\": 1\n }\n },\n \"accounts\": {},\n \"best_block_number\": 6,\n \"blocks\": [],\n \"transactions\": []\n }\"#;\n\n let state: SerializableState = serde_json::from_str(new_format).unwrap();\n assert!(state.block.is_some());\n let block_env = state.block.unwrap();\n assert_eq!(block_env.number, U256::from(6));\n assert_eq!(block_env.beneficiary, address!(\"0x1234567890123456789012345678901234567891\"));\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_backward_compatibility_mixed_formats_deserialization_v1_2() {\n let mixed_format = json!({\n \"block\": {\n \"number\": \"0x3\",\n \"coinbase\": \"0x1111111111111111111111111111111111111111\",\n \"timestamp\": 1751619509,\n \"gas_limit\": \"0x1c9c380\",\n \"basefee\": 1000000000,\n \"difficulty\": \"0x0\",\n \"prevrandao\": \"0xecc5f0af8ff6b65c14bfdac55ba9db870d89482eb2b87200c6d7e7cd3a3a5ad5\",\n \"blob_excess_gas_and_price\": {\n \"excess_blob_gas\": 0,\n \"blob_gasprice\": 1\n }\n },\n \"accounts\": {},\n \"best_block_number\": 3,\n \"blocks\": [],\n \"transactions\": []\n });\n\n let state: SerializableState = serde_json::from_str(&mixed_format.to_string()).unwrap();\n let block_env = state.block.unwrap();\n\n assert_eq!(block_env.number, U256::from(3));\n assert_eq!(block_env.beneficiary, address!(\"0x1111111111111111111111111111111111111111\"));\n assert_eq!(block_env.timestamp, U256::from(1751619509));\n assert_eq!(block_env.gas_limit, 0x1c9c380);\n assert_eq!(block_env.basefee, 1_000_000_000);\n assert_eq!(block_env.difficulty, U256::ZERO);\n assert_eq!(\n block_env.prevrandao.unwrap(),\n b256!(\"ecc5f0af8ff6b65c14bfdac55ba9db870d89482eb2b87200c6d7e7cd3a3a5ad5\")\n );\n\n let blob = block_env.blob_excess_gas_and_price.unwrap();\n assert_eq!(blob.excess_blob_gas, 0);\n assert_eq!(blob.blob_gasprice, 1);\n\n assert_eq!(state.best_block_number, Some(3));\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_backward_compatibility_optional_fields_deserialization_v1_2() {\n let partial_old_format = json!({\n \"block\": {\n \"number\": \"0x1\",\n \"coinbase\": \"0x0000000000000000000000000000000000000000\",\n \"timestamp\": \"0x688c83b5\",\n \"gas_limit\": \"0x1c9c380\",\n \"basefee\": \"0x3b9aca00\",\n \"difficulty\": \"0x0\",\n \"prevrandao\": \"0xecc5f0af8ff6b65c14bfdac55ba9db870d89482eb2b87200c6d7e7cd3a3a5ad5\"\n // Missing blob_excess_gas_and_price - should be None\n },\n \"accounts\": {},\n \"best_block_number\": \"0x1\"\n // Missing blocks and transactions arrays - should default to empty\n });\n\n let state: SerializableState = serde_json::from_str(&partial_old_format.to_string()).unwrap();\n\n let block_env = state.block.unwrap();\n assert_eq!(block_env.number, U256::from(1));\n assert_eq!(block_env.beneficiary, address!(\"0x0000000000000000000000000000000000000000\"));\n assert_eq!(block_env.timestamp, U256::from(0x688c83b5));\n assert_eq!(block_env.gas_limit, 0x1c9c380);\n assert_eq!(block_env.basefee, 0x3b9aca00);\n assert_eq!(block_env.difficulty, U256::ZERO);\n assert_eq!(\n block_env.prevrandao.unwrap(),\n b256!(\"ecc5f0af8ff6b65c14bfdac55ba9db870d89482eb2b87200c6d7e7cd3a3a5ad5\")\n );\n assert_eq!(\n block_env.blob_excess_gas_and_price,\n Some(BlobExcessGasAndPrice::new(0, BLOB_BASE_FEE_UPDATE_FRACTION_PRAGUE))\n );\n\n assert_eq!(state.best_block_number, Some(1));\n assert!(state.blocks.is_empty());\n assert!(state.transactions.is_empty());\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_backward_compatibility_state_dump_deserialization_v1_2() {\n let tmp = tempfile::tempdir().unwrap();\n let old_state_file = tmp.path().join(\"old_state.json\");\n\n // A simple state dump with a single block containing one transaction of a Counter contract\n // deployment.\n let old_state_json = json!({\n \"block\": {\n \"number\": \"0x1\",\n \"coinbase\": \"0x0000000000000000000000000000000000000001\",\n \"timestamp\": \"0x688c83b5\",\n \"gas_limit\": \"0x1c9c380\",\n \"basefee\": \"0x3b9aca00\",\n \"difficulty\": \"0x0\",\n \"prevrandao\": \"0xecc5f0af8ff6b65c14bfdac55ba9db870d89482eb2b87200c6d7e7cd3a3a5ad5\",\n \"blob_excess_gas_and_price\": {\n \"excess_blob_gas\": 0,\n \"blob_gasprice\": 1\n }\n },\n \"accounts\": {\n \"0x0000000000000000000000000000000000000000\": {\n \"nonce\": 0,\n \"balance\": \"0x26481\",\n \"code\": \"0x\",\n \"storage\": {}\n },\n \"0x14dc79964da2c08b23698b3d3cc7ca32193d9955\": {\n \"nonce\": 0,\n \"balance\": \"0x21e19e0c9bab2400000\",\n \"code\": \"0x\",\n \"storage\": {}\n },\n \"0x15d34aaf54267db7d7c367839aaf71a00a2c6a65\": {\n \"nonce\": 0,\n \"balance\": \"0x21e19e0c9bab2400000\",\n \"code\": \"0x\",\n \"storage\": {}\n },\n \"0x23618e81e3f5cdf7f54c3d65f7fbc0abf5b21e8f\": {\n \"nonce\": 0,\n \"balance\": \"0x21e19e0c9bab2400000\",\n \"code\": \"0x\",\n \"storage\": {}\n },\n \"0x3c44cdddb6a900fa2b585dd299e03d12fa4293bc\": {\n \"nonce\": 0,\n \"balance\": \"0x21e19e0c9bab2400000\",\n \"code\": \"0x\",\n \"storage\": {}\n },\n \"0x4e59b44847b379578588920ca78fbf26c0b4956c\": {\n \"nonce\": 0,\n \"balance\": \"0x0\",\n \"code\": \"0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe03601600081602082378035828234f58015156039578182fd5b8082525050506014600cf3\",\n \"storage\": {}\n },\n \"0x5fbdb2315678afecb367f032d93f642f64180aa3\": {\n \"nonce\": 1,\n \"balance\": \"0x0\",\n \"code\": \"0x608060405234801561000f575f5ffd5b506004361061003f575f3560e01c80633fb5c1cb146100435780638381f58a1461005f578063d09de08a1461007d575b5f5ffd5b61005d600480360381019061005891906100e4565b610087565b005b610067610090565b604051610074919061011e565b60405180910390f35b610085610095565b005b805f8190555050565b5f5481565b5f5f8154809291906100a690610164565b9190505550565b5f5ffd5b5f819050919050565b6100c3816100b1565b81146100cd575f5ffd5b50565b5f813590506100de816100ba565b92915050565b5f602082840312156100f9576100f86100ad565b5b5f610106848285016100d0565b91505092915050565b610118816100b1565b82525050565b5f6020820190506101315f83018461010f565b92915050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601160045260245ffd5b5f61016e826100b1565b91507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff82036101a05761019f610137565b5b60018201905091905056fea264697066735822122040b6a3cd3ec8f890002f39a8719ebee029ba9bac3d7fa9d581d4712cfe9ffec264736f6c634300081e0033\",\n \"storage\": {}\n },\n \"0x70997970c51812dc3a010c7d01b50e0d17dc79c8\": {\n \"nonce\": 0,\n \"balance\": \"0x21e19e0c9bab2400000\",\n \"code\": \"0x\",\n \"storage\": {}\n },\n \"0x90f79bf6eb2c4f870365e785982e1f101e93b906\": {\n \"nonce\": 0,\n \"balance\": \"0x21e19e0c9bab2400000\",\n \"code\": \"0x\",\n \"storage\": {}\n },\n \"0x976ea74026e726554db657fa54763abd0c3a0aa9\": {\n \"nonce\": 0,\n \"balance\": \"0x21e19e0c9bab2400000\",\n \"code\": \"0x\",\n \"storage\": {}\n },\n \"0x9965507d1a55bcc2695c58ba16fb37d819b0a4dc\": {\n \"nonce\": 0,\n \"balance\": \"0x21e19e0c9bab2400000\",\n \"code\": \"0x\",\n \"storage\": {}\n },\n \"0xa0ee7a142d267c1f36714e4a8f75612f20a79720\": {\n \"nonce\": 0,\n \"balance\": \"0x21e19e0c9bab2400000\",\n \"code\": \"0x\",\n \"storage\": {}\n },\n \"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\": {\n \"nonce\": 1,\n \"balance\": \"0x21e19e03b1e9e55d17f\",\n \"code\": \"0x\",\n \"storage\": {}\n }\n },\n \"best_block_number\": \"0x1\",\n \"blocks\": [\n {\n \"header\": {\n \"parentHash\": \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"sha3Uncles\": \"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\n \"miner\": \"0x0000000000000000000000000000000000000000\",\n \"stateRoot\": \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"transactionsRoot\": \"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\n \"receiptsRoot\": \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"logsBloom\": \"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\n \"difficulty\": \"0x0\",\n \"number\": \"0x0\",\n \"gasLimit\": \"0x1c9c380\",\n \"gasUsed\": \"0x0\",\n \"timestamp\": \"0x688c83b0\",\n \"extraData\": \"0x\",\n \"mixHash\": \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"nonce\": \"0x0000000000000000\",\n \"baseFeePerGas\": \"0x3b9aca00\",\n \"withdrawalsRoot\": \"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\n \"blobGasUsed\": \"0x0\",\n \"excessBlobGas\": \"0x0\",\n \"parentBeaconBlockRoot\": \"0x0000000000000000000000000000000000000000000000000000000000000000\"\n },\n \"transactions\": [],\n \"ommers\": []\n },\n {\n \"header\": {\n \"parentHash\": \"0x25097583380d90c4ac42b454ed7d2f59450ed3a16fdcf7f7bd93295aa126a901\",\n \"sha3Uncles\": \"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\n \"miner\": \"0x0000000000000000000000000000000000000000\",\n \"stateRoot\": \"0x6e005b459ac9acefa5f47fd2d7ff8ca81a91794fdc5f7fbc3e2faeeaefe5d516\",\n \"transactionsRoot\": \"0x59f0457ec18e2181c186f49d9ac911b33b5f4f55db5c494022147346bcfc9837\",\n \"receiptsRoot\": \"0x88ac48b910f796aab7407814203b3a15a04a812f387e92efeccc92a2ecf809da\",\n \"logsBloom\": \"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\n \"difficulty\": \"0x0\",\n \"number\": \"0x1\",\n \"gasLimit\": \"0x1c9c380\",\n \"gasUsed\": \"0x26481\",\n \"timestamp\": \"0x688c83b5\",\n \"extraData\": \"0x\",\n \"mixHash\": \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"nonce\": \"0x0000000000000000\",\n \"baseFeePerGas\": \"0x3b9aca00\",\n \"withdrawalsRoot\": \"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\n \"blobGasUsed\": \"0x0\",\n \"excessBlobGas\": \"0x0\",\n \"parentBeaconBlockRoot\": \"0x0000000000000000000000000000000000000000000000000000000000000000\"\n },\n \"transactions\": [\n {\n \"transaction\": {\n \"type\": \"0x2\",\n \"chainId\": \"0x7a69\",\n \"nonce\": \"0x0\",\n \"gas\": \"0x31c41\",\n \"maxFeePerGas\": \"0x77359401\",\n \"maxPriorityFeePerGas\": \"0x1\",\n \"to\": null,\n \"value\": \"0x0\",\n \"accessList\": [],\n \"input\": \"0x6080604052348015600e575f5ffd5b506101e18061001c5f395ff3fe608060405234801561000f575f5ffd5b506004361061003f575f3560e01c80633fb5c1cb146100435780638381f58a1461005f578063d09de08a1461007d575b5f5ffd5b61005d600480360381019061005891906100e4565b610087565b005b610067610090565b604051610074919061011e565b60405180910390f35b610085610095565b005b805f8190555050565b5f5481565b5f5f8154809291906100a690610164565b9190505550565b5f5ffd5b5f819050919050565b6100c3816100b1565b81146100cd575f5ffd5b50565b5f813590506100de816100ba565b92915050565b5f602082840312156100f9576100f86100ad565b5b5f610106848285016100d0565b91505092915050565b610118816100b1565b82525050565b5f6020820190506101315f83018461010f565b92915050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601160045260245ffd5b5f61016e826100b1565b91507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff82036101a05761019f610137565b5b60018201905091905056fea264697066735822122040b6a3cd3ec8f890002f39a8719ebee029ba9bac3d7fa9d581d4712cfe9ffec264736f6c634300081e0033\",\n \"r\": \"0xa7398e28ca9a56b423cab87aeb3612378bac9c5684aaf778a78943f2637fd731\",\n \"s\": \"0x583511da658f564253c8c0f9ee1820ef370f23556be504b304ac1292f869d9a0\",\n \"yParity\": \"0x0\",\n \"v\": \"0x0\",\n \"hash\": \"0x9e4846328caa09cbe8086d11b7e115adf70390e79ff203d8e5f37785c2a890be\"\n },\n \"impersonated_sender\": null\n }\n ],\n \"ommers\": []\n }\n ],\n \"transactions\": [\n {\n \"info\": {\n \"transaction_hash\": \"0x9e4846328caa09cbe8086d11b7e115adf70390e79ff203d8e5f37785c2a890be\",\n \"transaction_index\": 0,\n \"from\": \"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\",\n \"to\": null,\n \"contract_address\": \"0x5fbdb2315678afecb367f032d93f642f64180aa3\",\n \"traces\": [\n {\n \"parent\": null,\n \"children\": [],\n \"idx\": 0,\n \"trace\": {\n \"depth\": 0,\n \"success\": true,\n \"caller\": \"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\",\n \"address\": \"0x5fbdb2315678afecb367f032d93f642f64180aa3\",\n \"maybe_precompile\": false,\n \"selfdestruct_address\": null,\n \"selfdestruct_refund_target\": null,\n \"selfdestruct_transferred_value\": null,\n \"kind\": \"CREATE\",\n \"value\": \"0x0\",\n \"data\": \"0x6080604052348015600e575f5ffd5b506101e18061001c5f395ff3fe608060405234801561000f575f5ffd5b506004361061003f575f3560e01c80633fb5c1cb146100435780638381f58a1461005f578063d09de08a1461007d575b5f5ffd5b61005d600480360381019061005891906100e4565b610087565b005b610067610090565b604051610074919061011e565b60405180910390f35b610085610095565b005b805f8190555050565b5f5481565b5f5f8154809291906100a690610164565b9190505550565b5f5ffd5b5f819050919050565b6100c3816100b1565b81146100cd575f5ffd5b50565b5f813590506100de816100ba565b92915050565b5f602082840312156100f9576100f86100ad565b5b5f610106848285016100d0565b91505092915050565b610118816100b1565b82525050565b5f6020820190506101315f83018461010f565b92915050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601160045260245ffd5b5f61016e826100b1565b91507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff82036101a05761019f610137565b5b60018201905091905056fea264697066735822122040b6a3cd3ec8f890002f39a8719ebee029ba9bac3d7fa9d581d4712cfe9ffec264736f6c634300081e0033\",\n \"output\": \"0x608060405234801561000f575f5ffd5b506004361061003f575f3560e01c80633fb5c1cb146100435780638381f58a1461005f578063d09de08a1461007d575b5f5ffd5b61005d600480360381019061005891906100e4565b610087565b005b610067610090565b604051610074919061011e565b60405180910390f35b610085610095565b005b805f8190555050565b5f5481565b5f5f8154809291906100a690610164565b9190505550565b5f5ffd5b5f819050919050565b6100c3816100b1565b81146100cd575f5ffd5b50565b5f813590506100de816100ba565b92915050565b5f602082840312156100f9576100f86100ad565b5b5f610106848285016100d0565b91505092915050565b610118816100b1565b82525050565b5f6020820190506101315f83018461010f565b92915050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601160045260245ffd5b5f61016e826100b1565b91507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff82036101a05761019f610137565b5b60018201905091905056fea264697066735822122040b6a3cd3ec8f890002f39a8719ebee029ba9bac3d7fa9d581d4712cfe9ffec264736f6c634300081e0033\",\n \"gas_used\": 96345,\n \"gas_limit\": 143385,\n \"gas_refund_counter\": 0,\n \"status\": \"Return\",\n \"steps\": [],\n \"decoded\": null\n },\n \"logs\": [],\n \"ordering\": []\n }\n ],\n \"exit\": \"Return\",\n \"out\": \"0x608060405234801561000f575f5ffd5b506004361061003f575f3560e01c80633fb5c1cb146100435780638381f58a1461005f578063d09de08a1461007d575b5f5ffd5b61005d600480360381019061005891906100e4565b610087565b005b610067610090565b604051610074919061011e565b60405180910390f35b610085610095565b005b805f8190555050565b5f5481565b5f5f8154809291906100a690610164565b9190505550565b5f5ffd5b5f819050919050565b6100c3816100b1565b81146100cd575f5ffd5b50565b5f813590506100de816100ba565b92915050565b5f602082840312156100f9576100f86100ad565b5b5f610106848285016100d0565b91505092915050565b610118816100b1565b82525050565b5f6020820190506101315f83018461010f565b92915050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601160045260245ffd5b5f61016e826100b1565b91507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff82036101a05761019f610137565b5b60018201905091905056fea264697066735822122040b6a3cd3ec8f890002f39a8719ebee029ba9bac3d7fa9d581d4712cfe9ffec264736f6c634300081e0033\",\n \"nonce\": 0,\n \"gas_used\": 156801\n },\n \"receipt\": {\n \"type\": \"0x2\",\n \"status\": \"0x1\",\n \"cumulativeGasUsed\": \"0x26481\",\n \"logs\": [],\n \"logsBloom\": \"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\"\n },\n \"block_hash\": \"0x313ea0d32d662434a55a20d7c58544e6baaea421b6eccf4b68392dec2a76d771\",\n \"block_number\": 1\n }\n ],\n \"historical_states\": null\n });\n\n // Write the old state to file.\n foundry_common::fs::write_json_file(&old_state_file, &old_state_json).unwrap();\n\n // Test deserializing the old state dump directly.\n let deserialized_state: SerializableState = serde_json::from_value(old_state_json).unwrap();\n\n // Verify the old state was loaded correctly with `coinbase` to `beneficiary` conversion.\n let block_env = deserialized_state.block.unwrap();\n assert_eq!(block_env.number, U256::from(1));\n assert_eq!(block_env.beneficiary, address!(\"0000000000000000000000000000000000000001\"));\n assert_eq!(block_env.gas_limit, 0x1c9c380);\n assert_eq!(block_env.basefee, 0x3b9aca00);\n\n // Verify best_block_number hex string parsing.\n assert_eq!(deserialized_state.best_block_number, Some(1));\n\n // Verify account data was preserved.\n assert_eq!(deserialized_state.accounts.len(), 13);\n\n // Test specific accounts from the old dump.\n let deployer_addr = \"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\".parse().unwrap();\n let deployer_account = deserialized_state.accounts.get(&deployer_addr).unwrap();\n assert_eq!(deployer_account.nonce, 1);\n assert_eq!(deployer_account.balance, U256::from_str(\"0x21e19e03b1e9e55d17f\").unwrap());\n\n // Test contract account.\n let contract_addr = \"0x5fbdb2315678afecb367f032d93f642f64180aa3\".parse().unwrap();\n let contract_account = deserialized_state.accounts.get(&contract_addr).unwrap();\n assert_eq!(contract_account.nonce, 1);\n assert_eq!(contract_account.balance, U256::ZERO);\n assert!(!contract_account.code.is_empty());\n\n // Verify blocks and transactions are preserved.\n assert_eq!(deserialized_state.blocks.len(), 2);\n assert_eq!(deserialized_state.transactions.len(), 1);\n\n // Test that Anvil can load this old state dump.\n let (api, _handle) = spawn(NodeConfig::test().with_init_state_path(&old_state_file)).await;\n\n // Verify the state was loaded correctly.\n let block_number = api.block_number().unwrap();\n assert_eq!(block_number, U256::from(1));\n\n // Verify account balances are preserved.\n let provider = _handle.http_provider();\n let deployer_balance = provider.get_balance(deployer_addr).await.unwrap();\n assert_eq!(deployer_balance, U256::from_str(\"0x21e19e03b1e9e55d17f\").unwrap());\n let contract_balance = provider.get_balance(contract_addr).await.unwrap();\n assert_eq!(contract_balance, U256::ZERO);\n\n // Verify contract code is preserved.\n let contract_code = provider.get_code_at(contract_addr).await.unwrap();\n assert!(!contract_code.is_empty());\n}\n" }, { "path": "crates/anvil/tests/it/traces.rs", "content": "use std::collections::HashMap;\n\nuse crate::{\n abi::{Multicall, SimpleStorage},\n fork::fork_config,\n utils::http_provider_with_signer,\n};\nuse alloy_eips::BlockId;\nuse alloy_network::{EthereumWallet, TransactionBuilder};\nuse alloy_primitives::{\n Address, Bytes, U256,\n hex::{self, FromHex},\n};\nuse alloy_provider::{\n Provider,\n ext::{DebugApi, TraceApi},\n};\nuse alloy_rpc_types::{\n TransactionRequest,\n state::StateOverride,\n trace::{\n filter::{TraceFilter, TraceFilterMode},\n geth::{\n AccountState, CallConfig, GethDebugBuiltInTracerType, GethDebugTracerType,\n GethDebugTracingCallOptions, GethDebugTracingOptions, GethTrace, PreStateConfig,\n PreStateFrame,\n },\n parity::{Action, ChangedType, LocalizedTransactionTrace, TraceType},\n },\n};\nuse alloy_serde::WithOtherFields;\nuse alloy_sol_types::sol;\nuse anvil::{NodeConfig, spawn};\nuse foundry_evm::hardfork::EthereumHardfork;\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_get_transfer_parity_traces() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.ws_provider();\n\n let accounts = handle.dev_wallets().collect::>();\n let from = accounts[0].address();\n let to = accounts[1].address();\n let amount = handle.genesis_balance().checked_div(U256::from(2u64)).unwrap();\n // specify the `from` field so that the client knows which account to use\n let tx = TransactionRequest::default().to(to).value(amount).from(from);\n let tx = WithOtherFields::new(tx);\n\n // broadcast it via the eth_sendTransaction API\n let tx = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n let traces = provider.trace_transaction(tx.transaction_hash).await.unwrap();\n assert!(!traces.is_empty());\n\n match traces[0].trace.action {\n Action::Call(ref call) => {\n assert_eq!(call.from, from);\n assert_eq!(call.to, to);\n assert_eq!(call.value, amount);\n }\n _ => unreachable!(\"unexpected action\"),\n }\n\n let num = provider.get_block_number().await.unwrap();\n let block_traces = provider.trace_block(num.into()).await.unwrap();\n assert!(!block_traces.is_empty());\n\n assert_eq!(traces, block_traces);\n}\n\nsol!(\n #[sol(rpc, bytecode = \"0x6080604052348015600f57600080fd5b50336000806101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555060a48061005e6000396000f3fe6080604052348015600f57600080fd5b506004361060285760003560e01c806375fc8e3c14602d575b600080fd5b60336035565b005b60008054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16fffea26469706673582212205006867290df97c54f2df1cb94fc081197ab670e2adf5353071d2ecce1d694b864736f6c634300080d0033\")]\n contract SuicideContract {\n address payable private owner;\n constructor() public {\n owner = payable(msg.sender);\n }\n function goodbye() public {\n selfdestruct(owner);\n }\n }\n);\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_parity_suicide_trace() {\n let (_api, handle) =\n spawn(NodeConfig::test().with_hardfork(Some(EthereumHardfork::Shanghai.into()))).await;\n let provider = handle.ws_provider();\n let wallets = handle.dev_wallets().collect::>();\n let owner = wallets[0].address();\n let destructor = wallets[1].address();\n\n let contract_addr =\n SuicideContract::deploy_builder(provider.clone()).from(owner).deploy().await.unwrap();\n let contract = SuicideContract::new(contract_addr, provider.clone());\n let call = contract.goodbye().from(destructor);\n let call = call.send().await.unwrap();\n let tx = call.get_receipt().await.unwrap();\n\n let traces = handle.http_provider().trace_transaction(tx.transaction_hash).await.unwrap();\n assert!(!traces.is_empty());\n assert!(traces[1].trace.action.is_selfdestruct());\n}\n\nsol!(\n #[sol(rpc, bytecode = \"0x6080604052348015600f57600080fd5b50336000806101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555060a48061005e6000396000f3fe6080604052348015600f57600080fd5b506004361060285760003560e01c806375fc8e3c14602d575b600080fd5b60336035565b005b60008054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16fffea26469706673582212205006867290df97c54f2df1cb94fc081197ab670e2adf5353071d2ecce1d694b864736f6c634300080d0033\")]\n contract DebugTraceContract {\n address payable private owner;\n constructor() public {\n owner = payable(msg.sender);\n }\n function goodbye() public {\n selfdestruct(owner);\n }\n }\n);\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_transfer_debug_trace_call() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let wallets = handle.dev_wallets().collect::>();\n let deployer: EthereumWallet = wallets[0].clone().into();\n let provider = http_provider_with_signer(&handle.http_endpoint(), deployer);\n\n let contract_addr = DebugTraceContract::deploy_builder(provider.clone())\n .from(wallets[0].clone().address())\n .deploy()\n .await\n .unwrap();\n\n let caller: EthereumWallet = wallets[1].clone().into();\n let caller_provider = http_provider_with_signer(&handle.http_endpoint(), caller);\n let contract = DebugTraceContract::new(contract_addr, caller_provider);\n\n let call = contract.goodbye().from(wallets[1].address());\n let calldata = call.calldata().to_owned();\n\n let tx = TransactionRequest::default()\n .from(wallets[1].address())\n .to(*contract.address())\n .with_input(calldata);\n\n let traces = handle\n .http_provider()\n .debug_trace_call(\n WithOtherFields::new(tx),\n BlockId::latest(),\n GethDebugTracingCallOptions::default(),\n )\n .await\n .unwrap();\n\n match traces {\n GethTrace::Default(default_frame) => {\n assert!(!default_frame.failed);\n }\n _ => {\n unreachable!()\n }\n }\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_call_tracer_debug_trace_call() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let wallets = handle.dev_wallets().collect::>();\n let deployer: EthereumWallet = wallets[0].clone().into();\n let provider = http_provider_with_signer(&handle.http_endpoint(), deployer);\n\n let multicall_contract = Multicall::deploy(&provider).await.unwrap();\n\n let simple_storage_contract =\n SimpleStorage::deploy(&provider, \"init value\".to_string()).await.unwrap();\n\n let set_value = simple_storage_contract.setValue(\"bar\".to_string());\n let set_value_calldata = set_value.calldata();\n\n let internal_call_tx_builder = multicall_contract.aggregate(vec![Multicall::Call {\n target: *simple_storage_contract.address(),\n callData: set_value_calldata.to_owned(),\n }]);\n\n let internal_call_tx_calldata = internal_call_tx_builder.calldata().to_owned();\n\n // calling SimpleStorage contract through Multicall should result in an internal call\n let internal_call_tx = TransactionRequest::default()\n .from(wallets[1].address())\n .to(*multicall_contract.address())\n .with_input(internal_call_tx_calldata);\n\n let internal_call_tx_traces = handle\n .http_provider()\n .debug_trace_call(\n WithOtherFields::new(internal_call_tx.clone()),\n BlockId::latest(),\n GethDebugTracingCallOptions::default().with_tracing_options(\n GethDebugTracingOptions::default()\n .with_tracer(GethDebugTracerType::from(GethDebugBuiltInTracerType::CallTracer))\n .with_call_config(CallConfig::default().with_log()),\n ),\n )\n .await\n .unwrap();\n\n match internal_call_tx_traces {\n GethTrace::CallTracer(call_frame) => {\n assert!(call_frame.calls.len() == 1);\n assert!(\n call_frame.calls.first().unwrap().to.unwrap() == *simple_storage_contract.address()\n );\n assert!(call_frame.calls.first().unwrap().logs.len() == 1);\n }\n _ => {\n unreachable!()\n }\n }\n\n // only_top_call option - should not return any internal calls\n let internal_call_only_top_call_tx_traces = handle\n .http_provider()\n .debug_trace_call(\n WithOtherFields::new(internal_call_tx.clone()),\n BlockId::latest(),\n GethDebugTracingCallOptions::default().with_tracing_options(\n GethDebugTracingOptions::default()\n .with_tracer(GethDebugTracerType::from(GethDebugBuiltInTracerType::CallTracer))\n .with_call_config(CallConfig::default().with_log().only_top_call()),\n ),\n )\n .await\n .unwrap();\n\n match internal_call_only_top_call_tx_traces {\n GethTrace::CallTracer(call_frame) => {\n assert!(call_frame.calls.is_empty());\n }\n _ => {\n unreachable!()\n }\n }\n\n // directly calling the SimpleStorage contract should not result in any internal calls\n let direct_call_tx = TransactionRequest::default()\n .from(wallets[1].address())\n .to(*simple_storage_contract.address())\n .with_input(set_value_calldata.to_owned());\n\n let direct_call_tx_traces = handle\n .http_provider()\n .debug_trace_call(\n WithOtherFields::new(direct_call_tx),\n BlockId::latest(),\n GethDebugTracingCallOptions::default().with_tracing_options(\n GethDebugTracingOptions::default()\n .with_tracer(GethDebugTracerType::from(GethDebugBuiltInTracerType::CallTracer))\n .with_call_config(CallConfig::default().with_log()),\n ),\n )\n .await\n .unwrap();\n\n match direct_call_tx_traces {\n GethTrace::CallTracer(call_frame) => {\n assert!(call_frame.calls.is_empty());\n assert!(call_frame.to.unwrap() == *simple_storage_contract.address());\n assert!(call_frame.logs.len() == 1);\n }\n _ => {\n unreachable!()\n }\n }\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_debug_trace_call_state_override() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let wallets = handle.dev_wallets().collect::>();\n\n let tx = TransactionRequest::default()\n .from(wallets[1].address())\n .to(\"0x1234567890123456789012345678901234567890\".parse().unwrap());\n\n let override_json = r#\"{\n \"0x1234567890123456789012345678901234567890\": {\n \"balance\": \"0x01\",\n \"code\": \"0x30315f5260205ff3\"\n }\n }\"#;\n\n let state_override: StateOverride = serde_json::from_str(override_json).unwrap();\n\n let tx_traces = handle\n .http_provider()\n .debug_trace_call(\n WithOtherFields::new(tx.clone()),\n BlockId::latest(),\n GethDebugTracingCallOptions::default()\n .with_tracing_options(GethDebugTracingOptions::default())\n .with_state_overrides(state_override),\n )\n .await\n .unwrap();\n\n match tx_traces {\n GethTrace::Default(trace_res) => {\n assert_eq!(\n trace_res.return_value,\n Bytes::from_hex(\"0000000000000000000000000000000000000000000000000000000000000001\")\n .unwrap()\n );\n }\n _ => {\n unreachable!()\n }\n }\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_trace_address_fork() {\n let (api, handle) = spawn(fork_config().with_fork_block_number(Some(15291050u64))).await;\n let provider = handle.http_provider();\n\n let input = hex::decode(\"43bcfab60000000000000000000000006b175474e89094c44da98b954eedeac495271d0f0000000000000000000000000000000000000000000000e0bd811c8769a824b00000000000000000000000000000000000000000000000e0ae9925047d8440b60000000000000000000000002e4777139254ff76db957e284b186a4507ff8c67\").unwrap();\n\n let from: Address = \"0x2e4777139254ff76db957e284b186a4507ff8c67\".parse().unwrap();\n let to: Address = \"0xe2f2a5c287993345a840db3b0845fbc70f5935a5\".parse().unwrap();\n let tx = TransactionRequest::default()\n .to(to)\n .from(from)\n .with_input::(input.into())\n .with_gas_limit(300_000);\n\n let tx = WithOtherFields::new(tx);\n api.anvil_impersonate_account(from).await.unwrap();\n\n let tx = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n let traces = provider.trace_transaction(tx.transaction_hash).await.unwrap();\n assert!(!traces.is_empty());\n match traces[0].trace.action {\n Action::Call(ref call) => {\n assert_eq!(call.from, from);\n assert_eq!(call.to, to);\n }\n _ => unreachable!(\"unexpected action\"),\n }\n\n let json = serde_json::json!([\n {\n \"action\": {\n \"callType\": \"call\",\n \"from\": \"0x2e4777139254ff76db957e284b186a4507ff8c67\",\n \"gas\": \"0x262b3\",\n \"input\": \"0x43bcfab60000000000000000000000006b175474e89094c44da98b954eedeac495271d0f0000000000000000000000000000000000000000000000e0bd811c8769a824b00000000000000000000000000000000000000000000000e0ae9925047d8440b60000000000000000000000002e4777139254ff76db957e284b186a4507ff8c67\",\n \"to\": \"0xe2f2a5c287993345a840db3b0845fbc70f5935a5\",\n \"value\": \"0x0\"\n },\n \"blockHash\": \"0xa47c8f1d8c284cb614e9c8e10d260b33eae16b1957a83141191bc335838d7e29\",\n \"blockNumber\": 15291051,\n \"result\": {\n \"gasUsed\": \"0x2131b\",\n \"output\": \"0x0000000000000000000000000000000000000000000000e0e82ca52ec6e6a4d3\"\n },\n \"subtraces\": 1,\n \"traceAddress\": [],\n \"transactionHash\": \"0x3255cce7312e9c4470e1a1883be13718e971f6faafb96199b8bd75e5b7c39e3a\",\n \"transactionPosition\": 19,\n \"type\": \"call\"\n },\n {\n \"action\": {\n \"callType\": \"delegatecall\",\n \"from\": \"0xe2f2a5c287993345a840db3b0845fbc70f5935a5\",\n \"gas\": \"0x23d88\",\n \"input\": \"0x43bcfab60000000000000000000000006b175474e89094c44da98b954eedeac495271d0f0000000000000000000000000000000000000000000000e0bd811c8769a824b00000000000000000000000000000000000000000000000e0ae9925047d8440b60000000000000000000000002e4777139254ff76db957e284b186a4507ff8c67\",\n \"to\": \"0x15b2838cd28cc353afbe59385db3f366d8945aee\",\n \"value\": \"0x0\"\n },\n \"blockHash\": \"0xa47c8f1d8c284cb614e9c8e10d260b33eae16b1957a83141191bc335838d7e29\",\n \"blockNumber\": 15291051,\n \"result\": {\n \"gasUsed\": \"0x1f6e1\",\n \"output\": \"0x0000000000000000000000000000000000000000000000e0e82ca52ec6e6a4d3\"\n },\n \"subtraces\": 2,\n \"traceAddress\": [0],\n \"transactionHash\": \"0x3255cce7312e9c4470e1a1883be13718e971f6faafb96199b8bd75e5b7c39e3a\",\n \"transactionPosition\": 19,\n \"type\": \"call\"\n },\n {\n \"action\": {\n \"callType\": \"staticcall\",\n \"from\": \"0xe2f2a5c287993345a840db3b0845fbc70f5935a5\",\n \"gas\": \"0x192ed\",\n \"input\": \"0x50494dc000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000e0b1ff65617f654b2f00000000000000000000000000000000000000000000000000000000000061a800000000000000000000000000000000000000000000000000b1a2bc2ec5000000000000000000000000000000000000000000000000000006f05b59d3b2000000000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000005f5e1000000000000000000000000000000000000000000000414ec22973db48fd3a3370000000000000000000000000000000000000000000000056bc75e2d6310000000000000000000000000000000000000000000000000000000000a7314a9ba5c0000000000000000000000000000000000000000000000000000000005f5e100000000000000000000000000000000000000000000095f783edc5a5dabcb4ba70000000000000000000000000000000000000000000000056bc75e2d6310000000000000000000000000000000000000000000000000000000000a3f42df4dab\",\n \"to\": \"0xca480d596e6717c95a62a4dc1bd4fbd7b7e7d705\",\n \"value\": \"0x0\"\n },\n \"blockHash\": \"0xa47c8f1d8c284cb614e9c8e10d260b33eae16b1957a83141191bc335838d7e29\",\n \"blockNumber\": 15291051,\n \"result\": {\n \"gasUsed\": \"0x661a\",\n \"output\": \"0x0000000000000000000000000000000000000000000000e0e82ca52ec6e6a4d3\"\n },\n \"subtraces\": 0,\n \"traceAddress\": [0, 0],\n \"transactionHash\": \"0x3255cce7312e9c4470e1a1883be13718e971f6faafb96199b8bd75e5b7c39e3a\",\n \"transactionPosition\": 19,\n \"type\": \"call\"\n },\n {\n \"action\": {\n \"callType\": \"delegatecall\",\n \"from\": \"0xe2f2a5c287993345a840db3b0845fbc70f5935a5\",\n \"gas\": \"0xd2dc\",\n \"input\": \"0x4e331a540000000000000000000000000000000000000000000000e0e82ca52ec6e6a4d30000000000000000000000006b175474e89094c44da98b954eedeac495271d0f000000000000000000000000a2a3cae63476891ab2d640d9a5a800755ee79d6e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000005f5e100000000000000000000000000000000000000000000095f783edc5a5dabcb4ba70000000000000000000000002e4777139254ff76db957e284b186a4507ff8c6700000000000000000000000000000000000000000000f7be2b91f8a2e2df496e\",\n \"to\": \"0x1e91f826fa8aa4fa4d3f595898af3a64dd188848\",\n \"value\": \"0x0\"\n },\n \"blockHash\": \"0xa47c8f1d8c284cb614e9c8e10d260b33eae16b1957a83141191bc335838d7e29\",\n \"blockNumber\": 15291051,\n \"result\": {\n \"gasUsed\": \"0x7617\",\n \"output\": \"0x\"\n },\n \"subtraces\": 2,\n \"traceAddress\": [0, 1],\n \"transactionHash\": \"0x3255cce7312e9c4470e1a1883be13718e971f6faafb96199b8bd75e5b7c39e3a\",\n \"transactionPosition\": 19,\n \"type\": \"call\"\n },\n {\n \"action\": {\n \"callType\": \"staticcall\",\n \"from\": \"0xe2f2a5c287993345a840db3b0845fbc70f5935a5\",\n \"gas\": \"0xbf50\",\n \"input\": \"0x70a08231000000000000000000000000a2a3cae63476891ab2d640d9a5a800755ee79d6e\",\n \"to\": \"0x6b175474e89094c44da98b954eedeac495271d0f\",\n \"value\": \"0x0\"\n },\n \"blockHash\": \"0xa47c8f1d8c284cb614e9c8e10d260b33eae16b1957a83141191bc335838d7e29\",\n \"blockNumber\": 15291051,\n \"result\": {\n \"gasUsed\": \"0xa2a\",\n \"output\": \"0x0000000000000000000000000000000000000000000020fe99f8898600d94750\"\n },\n \"subtraces\": 0,\n \"traceAddress\": [0, 1, 0],\n \"transactionHash\": \"0x3255cce7312e9c4470e1a1883be13718e971f6faafb96199b8bd75e5b7c39e3a\",\n \"transactionPosition\": 19,\n \"type\": \"call\"\n },\n {\n \"action\": {\n \"callType\": \"call\",\n \"from\": \"0xe2f2a5c287993345a840db3b0845fbc70f5935a5\",\n \"gas\": \"0xa92a\",\n \"input\": \"0xa4e285950000000000000000000000002e4777139254ff76db957e284b186a4507ff8c670000000000000000000000006b175474e89094c44da98b954eedeac495271d0f0000000000000000000000000000000000000000000000e0e82ca52ec6e6a4d3\",\n \"to\": \"0xa2a3cae63476891ab2d640d9a5a800755ee79d6e\",\n \"value\": \"0x0\"\n },\n \"blockHash\": \"0xa47c8f1d8c284cb614e9c8e10d260b33eae16b1957a83141191bc335838d7e29\",\n \"blockNumber\": 15291051,\n \"result\": {\n \"gasUsed\": \"0x4ed3\",\n \"output\": \"0x\"\n },\n \"subtraces\": 1,\n \"traceAddress\": [0, 1, 1],\n \"transactionHash\": \"0x3255cce7312e9c4470e1a1883be13718e971f6faafb96199b8bd75e5b7c39e3a\",\n \"transactionPosition\": 19,\n \"type\": \"call\"\n },\n {\n \"action\": {\n \"callType\": \"call\",\n \"from\": \"0xa2a3cae63476891ab2d640d9a5a800755ee79d6e\",\n \"gas\": \"0x8c90\",\n \"input\": \"0xa9059cbb0000000000000000000000002e4777139254ff76db957e284b186a4507ff8c670000000000000000000000000000000000000000000000e0e82ca52ec6e6a4d3\",\n \"to\": \"0x6b175474e89094c44da98b954eedeac495271d0f\",\n \"value\": \"0x0\"\n },\n \"blockHash\": \"0xa47c8f1d8c284cb614e9c8e10d260b33eae16b1957a83141191bc335838d7e29\",\n \"blockNumber\": 15291051,\n \"result\": {\n \"gasUsed\": \"0x2b42\",\n \"output\": \"0x0000000000000000000000000000000000000000000000000000000000000001\"\n },\n \"subtraces\": 0,\n \"traceAddress\": [0, 1, 1, 0],\n \"transactionHash\": \"0x3255cce7312e9c4470e1a1883be13718e971f6faafb96199b8bd75e5b7c39e3a\",\n \"transactionPosition\": 19,\n \"type\": \"call\"\n }\n ]);\n\n let expected_traces: Vec = serde_json::from_value(json).unwrap();\n\n // test matching traceAddress\n traces.into_iter().zip(expected_traces).for_each(|(a, b)| {\n assert_eq!(a.trace.trace_address, b.trace.trace_address);\n assert_eq!(a.trace.subtraces, b.trace.subtraces);\n match (a.trace.action, b.trace.action) {\n (Action::Call(a), Action::Call(b)) => {\n assert_eq!(a.from, b.from);\n assert_eq!(a.to, b.to);\n }\n _ => unreachable!(\"unexpected action\"),\n }\n })\n}\n\n// \n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_trace_address_fork2() {\n let (api, handle) = spawn(fork_config().with_fork_block_number(Some(15314401u64))).await;\n let provider = handle.http_provider();\n\n let input = hex::decode(\"30000003000000000000000000000000adda1059a6c6c102b0fa562b9bb2cb9a0de5b1f4000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000a300000004fffffffffffffffffffffffffffffffffffffffffffff679dc91ecfe150fb980c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2f4d2888d29d722226fafa5d9b24f9164c092421e000bb8000000000000004319b52bf08b65295d49117e790000000000000000000000000000000000000000000000008b6d9e8818d6141f000000000000000000000000000000000000000000000000000000086a23af210000000000000000000000000000000000000000000000000000000000\").unwrap();\n\n let from: Address = \"0xa009fa1ac416ec02f6f902a3a4a584b092ae6123\".parse().unwrap();\n let to: Address = \"0x99999999d116ffa7d76590de2f427d8e15aeb0b8\".parse().unwrap();\n let tx = TransactionRequest::default()\n .to(to)\n .from(from)\n .with_input::(input.into())\n .with_gas_limit(350_000);\n\n let tx = WithOtherFields::new(tx);\n api.anvil_impersonate_account(from).await.unwrap();\n\n let tx = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n let status = tx.inner.inner.inner.receipt.status.coerce_status();\n assert!(status);\n\n let traces = provider.trace_transaction(tx.transaction_hash).await.unwrap();\n\n assert!(!traces.is_empty());\n match traces[0].trace.action {\n Action::Call(ref call) => {\n assert_eq!(call.from, from);\n assert_eq!(call.to, to);\n }\n _ => unreachable!(\"unexpected action\"),\n }\n\n let json = serde_json::json!([\n {\n \"action\": {\n \"from\": \"0xa009fa1ac416ec02f6f902a3a4a584b092ae6123\",\n \"callType\": \"call\",\n \"gas\": \"0x4fabc\",\n \"input\": \"0x30000003000000000000000000000000adda1059a6c6c102b0fa562b9bb2cb9a0de5b1f4000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000a300000004fffffffffffffffffffffffffffffffffffffffffffff679dc91ecfe150fb980c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2f4d2888d29d722226fafa5d9b24f9164c092421e000bb8000000000000004319b52bf08b65295d49117e790000000000000000000000000000000000000000000000008b6d9e8818d6141f000000000000000000000000000000000000000000000000000000086a23af210000000000000000000000000000000000000000000000000000000000\",\n \"to\": \"0x99999999d116ffa7d76590de2f427d8e15aeb0b8\",\n \"value\": \"0x0\"\n },\n \"blockHash\": \"0xf689ba7749648b8c5c8f5eedd73001033f0aed7ea50b7c81048ad1533b8d3d73\",\n \"blockNumber\": 15314402,\n \"result\": {\n \"gasUsed\": \"0x1d51b\",\n \"output\": \"0x\"\n },\n \"subtraces\": 1,\n \"traceAddress\": [],\n \"transactionHash\": \"0x2d951c5c95d374263ca99ad9c20c9797fc714330a8037429a3aa4c83d456f845\",\n \"transactionPosition\": 289,\n \"type\": \"call\"\n },\n {\n \"action\": {\n \"from\": \"0x99999999d116ffa7d76590de2f427d8e15aeb0b8\",\n \"callType\": \"delegatecall\",\n \"gas\": \"0x4d594\",\n \"input\": \"0x00000004fffffffffffffffffffffffffffffffffffffffffffff679dc91ecfe150fb980c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2f4d2888d29d722226fafa5d9b24f9164c092421e000bb8000000000000004319b52bf08b65295d49117e790000000000000000000000000000000000000000000000008b6d9e8818d6141f000000000000000000000000000000000000000000000000000000086a23af21\",\n \"to\": \"0xadda1059a6c6c102b0fa562b9bb2cb9a0de5b1f4\",\n \"value\": \"0x0\"\n },\n \"blockHash\": \"0xf689ba7749648b8c5c8f5eedd73001033f0aed7ea50b7c81048ad1533b8d3d73\",\n \"blockNumber\": 15314402,\n \"result\": {\n \"gasUsed\": \"0x1c35f\",\n \"output\": \"0x\"\n },\n \"subtraces\": 3,\n \"traceAddress\": [0],\n \"transactionHash\": \"0x2d951c5c95d374263ca99ad9c20c9797fc714330a8037429a3aa4c83d456f845\",\n \"transactionPosition\": 289,\n \"type\": \"call\"\n },\n {\n \"action\": {\n \"from\": \"0x99999999d116ffa7d76590de2f427d8e15aeb0b8\",\n \"callType\": \"call\",\n \"gas\": \"0x4b6d6\",\n \"input\": \"0x16b2da82000000000000000000000000000000000000000000000000000000086a23af21\",\n \"to\": \"0xd1663cfb8ceaf22039ebb98914a8c98264643710\",\n \"value\": \"0x0\"\n },\n \"blockHash\": \"0xf689ba7749648b8c5c8f5eedd73001033f0aed7ea50b7c81048ad1533b8d3d73\",\n \"blockNumber\": 15314402,\n \"result\": {\n \"gasUsed\": \"0xd6d\",\n \"output\": \"0x0000000000000000000000000000000000000000000000000000000000000000\"\n },\n \"subtraces\": 0,\n \"traceAddress\": [0, 0],\n \"transactionHash\": \"0x2d951c5c95d374263ca99ad9c20c9797fc714330a8037429a3aa4c83d456f845\",\n \"transactionPosition\": 289,\n \"type\": \"call\"\n },\n {\n \"action\": {\n \"from\": \"0x99999999d116ffa7d76590de2f427d8e15aeb0b8\",\n \"callType\": \"staticcall\",\n \"gas\": \"0x49c35\",\n \"input\": \"0x3850c7bd\",\n \"to\": \"0x4b5ab61593a2401b1075b90c04cbcdd3f87ce011\",\n \"value\": \"0x0\"\n },\n \"blockHash\": \"0xf689ba7749648b8c5c8f5eedd73001033f0aed7ea50b7c81048ad1533b8d3d73\",\n \"blockNumber\": 15314402,\n \"result\": {\n \"gasUsed\": \"0xa88\",\n \"output\": \"0x000000000000000000000000000000000000004319b52bf08b65295d49117e7900000000000000000000000000000000000000000000000000000000000148a0000000000000000000000000000000000000000000000000000000000000010e000000000000000000000000000000000000000000000000000000000000012c000000000000000000000000000000000000000000000000000000000000012c00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001\"\n },\n \"subtraces\": 0,\n \"traceAddress\": [0, 1],\n \"transactionHash\": \"0x2d951c5c95d374263ca99ad9c20c9797fc714330a8037429a3aa4c83d456f845\",\n \"transactionPosition\": 289,\n \"type\": \"call\"\n },\n {\n \"action\": {\n \"from\": \"0x99999999d116ffa7d76590de2f427d8e15aeb0b8\",\n \"callType\": \"call\",\n \"gas\": \"0x48d01\",\n \"input\": \"0x128acb0800000000000000000000000099999999d116ffa7d76590de2f427d8e15aeb0b80000000000000000000000000000000000000000000000000000000000000001fffffffffffffffffffffffffffffffffffffffffffff679dc91ecfe150fb98000000000000000000000000000000000000000000000000000000001000276a400000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000002bc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2f4d2888d29d722226fafa5d9b24f9164c092421e000bb8000000000000000000000000000000000000000000\",\n \"to\": \"0x4b5ab61593a2401b1075b90c04cbcdd3f87ce011\",\n \"value\": \"0x0\"\n },\n \"blockHash\": \"0xf689ba7749648b8c5c8f5eedd73001033f0aed7ea50b7c81048ad1533b8d3d73\",\n \"blockNumber\": 15314402,\n \"result\": {\n \"gasUsed\": \"0x18c20\",\n \"output\": \"0x0000000000000000000000000000000000000000000000008b5116525f9edc3efffffffffffffffffffffffffffffffffffffffffffff679dc91ecfe150fb980\"\n },\n \"subtraces\": 4,\n \"traceAddress\": [0, 2],\n \"transactionHash\": \"0x2d951c5c95d374263ca99ad9c20c9797fc714330a8037429a3aa4c83d456f845\",\n \"transactionPosition\": 289,\n \"type\": \"call\"\n },\n {\n \"action\": {\n \"from\": \"0x4b5ab61593a2401b1075b90c04cbcdd3f87ce011\",\n \"callType\": \"call\",\n \"gas\": \"0x3802a\",\n \"input\": \"0xa9059cbb00000000000000000000000099999999d116ffa7d76590de2f427d8e15aeb0b8000000000000000000000000000000000000000000000986236e1301eaf04680\",\n \"to\": \"0xf4d2888d29d722226fafa5d9b24f9164c092421e\",\n \"value\": \"0x0\"\n },\n \"blockHash\": \"0xf689ba7749648b8c5c8f5eedd73001033f0aed7ea50b7c81048ad1533b8d3d73\",\n \"blockNumber\": 15314402,\n \"result\": {\n \"gasUsed\": \"0x31b6\",\n \"output\": \"0x0000000000000000000000000000000000000000000000000000000000000001\"\n },\n \"subtraces\": 0,\n \"traceAddress\": [0, 2, 0],\n \"transactionHash\": \"0x2d951c5c95d374263ca99ad9c20c9797fc714330a8037429a3aa4c83d456f845\",\n \"transactionPosition\": 289,\n \"type\": \"call\"\n },\n {\n \"action\": {\n \"from\": \"0x4b5ab61593a2401b1075b90c04cbcdd3f87ce011\",\n \"callType\": \"staticcall\",\n \"gas\": \"0x34237\",\n \"input\": \"0x70a082310000000000000000000000004b5ab61593a2401b1075b90c04cbcdd3f87ce011\",\n \"to\": \"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2\",\n \"value\": \"0x0\"\n },\n \"blockHash\": \"0xf689ba7749648b8c5c8f5eedd73001033f0aed7ea50b7c81048ad1533b8d3d73\",\n \"blockNumber\": 15314402,\n \"result\": {\n \"gasUsed\": \"0x9e6\",\n \"output\": \"0x000000000000000000000000000000000000000000000091cda6c1ce33e53b89\"\n },\n \"subtraces\": 0,\n \"traceAddress\": [0, 2, 1],\n \"transactionHash\": \"0x2d951c5c95d374263ca99ad9c20c9797fc714330a8037429a3aa4c83d456f845\",\n \"transactionPosition\": 289,\n \"type\": \"call\"\n },\n {\n \"action\": {\n \"from\": \"0x4b5ab61593a2401b1075b90c04cbcdd3f87ce011\",\n \"callType\": \"call\",\n \"gas\": \"0x3357e\",\n \"input\": \"0xfa461e330000000000000000000000000000000000000000000000008b5116525f9edc3efffffffffffffffffffffffffffffffffffffffffffff679dc91ecfe150fb9800000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000002bc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2f4d2888d29d722226fafa5d9b24f9164c092421e000bb8000000000000000000000000000000000000000000\",\n \"to\": \"0x99999999d116ffa7d76590de2f427d8e15aeb0b8\",\n \"value\": \"0x0\"\n },\n \"blockHash\": \"0xf689ba7749648b8c5c8f5eedd73001033f0aed7ea50b7c81048ad1533b8d3d73\",\n \"blockNumber\": 15314402,\n \"result\": {\n \"gasUsed\": \"0x2e8b\",\n \"output\": \"0x\"\n },\n \"subtraces\": 1,\n \"traceAddress\": [0, 2, 2],\n \"transactionHash\": \"0x2d951c5c95d374263ca99ad9c20c9797fc714330a8037429a3aa4c83d456f845\",\n \"transactionPosition\": 289,\n \"type\": \"call\"\n },\n {\n \"action\": {\n \"from\": \"0x99999999d116ffa7d76590de2f427d8e15aeb0b8\",\n \"callType\": \"call\",\n \"gas\": \"0x324db\",\n \"input\": \"0xa9059cbb0000000000000000000000004b5ab61593a2401b1075b90c04cbcdd3f87ce0110000000000000000000000000000000000000000000000008b5116525f9edc3e\",\n \"to\": \"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2\",\n \"value\": \"0x0\"\n },\n \"blockHash\": \"0xf689ba7749648b8c5c8f5eedd73001033f0aed7ea50b7c81048ad1533b8d3d73\",\n \"blockNumber\": 15314402,\n \"result\": {\n \"gasUsed\": \"0x2a6e\",\n \"output\": \"0x0000000000000000000000000000000000000000000000000000000000000001\"\n },\n \"subtraces\": 0,\n \"traceAddress\": [0, 2, 2, 0],\n \"transactionHash\": \"0x2d951c5c95d374263ca99ad9c20c9797fc714330a8037429a3aa4c83d456f845\",\n \"transactionPosition\": 289,\n \"type\": \"call\"\n },\n {\n \"action\": {\n \"from\": \"0x4b5ab61593a2401b1075b90c04cbcdd3f87ce011\",\n \"callType\": \"staticcall\",\n \"gas\": \"0x30535\",\n \"input\": \"0x70a082310000000000000000000000004b5ab61593a2401b1075b90c04cbcdd3f87ce011\",\n \"to\": \"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2\",\n \"value\": \"0x0\"\n },\n \"blockHash\": \"0xf689ba7749648b8c5c8f5eedd73001033f0aed7ea50b7c81048ad1533b8d3d73\",\n \"blockNumber\": 15314402,\n \"result\": {\n \"gasUsed\": \"0x216\",\n \"output\": \"0x00000000000000000000000000000000000000000000009258f7d820938417c7\"\n },\n \"subtraces\": 0,\n \"traceAddress\": [0, 2, 3],\n \"transactionHash\": \"0x2d951c5c95d374263ca99ad9c20c9797fc714330a8037429a3aa4c83d456f845\",\n \"transactionPosition\": 289,\n \"type\": \"call\"\n }\n ]);\n\n let expected_traces: Vec = serde_json::from_value(json).unwrap();\n\n // test matching traceAddress\n traces.into_iter().zip(expected_traces).for_each(|(a, b)| {\n assert_eq!(a.trace.trace_address, b.trace.trace_address);\n assert_eq!(a.trace.subtraces, b.trace.subtraces);\n match (a.trace.action, b.trace.action) {\n (Action::Call(a), Action::Call(b)) => {\n assert_eq!(a.from, b.from);\n assert_eq!(a.to, b.to);\n }\n _ => unreachable!(\"unexpected action\"),\n }\n })\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_trace_filter() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.ws_provider();\n\n let accounts = handle.dev_wallets().collect::>();\n let from = accounts[0].address();\n let to = accounts[1].address();\n let from_two = accounts[2].address();\n let to_two = accounts[3].address();\n\n // Test default block ranges.\n // From will be earliest, to will be best/latest\n let tracer = TraceFilter {\n from_block: None,\n to_block: None,\n from_address: vec![],\n to_address: vec![],\n mode: TraceFilterMode::Intersection,\n after: None,\n count: None,\n };\n\n for i in 0..=5 {\n let tx = TransactionRequest::default().to(to).value(U256::from(i)).from(from);\n let tx = WithOtherFields::new(tx);\n provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n }\n\n let traces = api.trace_filter(tracer).await.unwrap();\n assert_eq!(traces.len(), 6);\n\n // Test filtering by address\n let tracer = TraceFilter {\n from_block: Some(provider.get_block_number().await.unwrap()),\n to_block: None,\n from_address: vec![from_two],\n to_address: vec![to_two],\n mode: TraceFilterMode::Intersection,\n after: None,\n count: None,\n };\n\n for i in 0..=5 {\n let tx = TransactionRequest::default().to(to).value(U256::from(i)).from(from);\n let tx = WithOtherFields::new(tx);\n provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n let tx = TransactionRequest::default().to(to_two).value(U256::from(i)).from(from_two);\n let tx = WithOtherFields::new(tx);\n provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n }\n\n let traces = api.trace_filter(tracer).await.unwrap();\n assert_eq!(traces.len(), 6);\n\n // Test for the following actions:\n // Create (deploy the contract)\n // Call (goodbye function)\n // SelfDestruct (side-effect of goodbye)\n let contract_addr =\n SuicideContract::deploy_builder(provider.clone()).from(from).deploy().await.unwrap();\n let contract = SuicideContract::new(contract_addr, provider.clone());\n\n // Test TraceActions\n let tracer = TraceFilter {\n from_block: Some(provider.get_block_number().await.unwrap()),\n to_block: None,\n from_address: vec![from, contract_addr],\n to_address: vec![], // Leave as 0 address\n mode: TraceFilterMode::Union,\n after: None,\n count: None,\n };\n\n // Execute call\n let call = contract.goodbye().from(from);\n let call = call.send().await.unwrap();\n call.get_receipt().await.unwrap();\n\n // Mine transactions to filter against\n for i in 0..=5 {\n let tx = TransactionRequest::default().to(to_two).value(U256::from(i)).from(from_two);\n let tx = WithOtherFields::new(tx);\n provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n }\n\n let traces = api.trace_filter(tracer).await.unwrap();\n assert_eq!(traces.len(), 3);\n\n // Test Range Error\n let latest = provider.get_block_number().await.unwrap();\n let tracer = TraceFilter {\n from_block: Some(latest),\n to_block: Some(latest + 301),\n from_address: vec![],\n to_address: vec![],\n mode: TraceFilterMode::Union,\n after: None,\n count: None,\n };\n\n let traces = api.trace_filter(tracer).await;\n assert!(traces.is_err());\n\n // Test same from and to block is valid\n let latest = provider.get_block_number().await.unwrap();\n let tracer = TraceFilter {\n from_block: Some(latest),\n to_block: Some(latest),\n from_address: vec![],\n to_address: vec![],\n mode: TraceFilterMode::Union,\n after: None,\n count: None,\n };\n\n let traces = api.trace_filter(tracer).await;\n assert!(traces.is_ok());\n\n // Test invalid block range\n let latest = provider.get_block_number().await.unwrap();\n let tracer = TraceFilter {\n from_block: Some(latest + 10),\n to_block: Some(latest),\n from_address: vec![],\n to_address: vec![],\n mode: TraceFilterMode::Union,\n after: None,\n count: None,\n };\n\n let traces = api.trace_filter(tracer).await;\n assert!(traces.is_err());\n\n // Test after and count\n let tracer = TraceFilter {\n from_block: Some(provider.get_block_number().await.unwrap()),\n to_block: None,\n from_address: vec![],\n to_address: vec![],\n mode: TraceFilterMode::Union,\n after: Some(3),\n count: Some(5),\n };\n\n for i in 0..=10 {\n let tx = TransactionRequest::default().to(to).value(U256::from(i)).from(from);\n let tx = WithOtherFields::new(tx);\n provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n }\n\n let traces = api.trace_filter(tracer).await.unwrap();\n assert_eq!(traces.len(), 5);\n}\n\n#[cfg(feature = \"js-tracer\")]\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_call_tracer_debug_trace_call_js_tracer() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let wallets = handle.dev_wallets().collect::>();\n let deployer: EthereumWallet = wallets[0].clone().into();\n let provider = http_provider_with_signer(&handle.http_endpoint(), deployer);\n\n let multicall_contract = Multicall::deploy(&provider).await.unwrap();\n let simple_storage_contract =\n SimpleStorage::deploy(&provider, \"init value\".to_string()).await.unwrap();\n\n let set_value = simple_storage_contract.setValue(\"bar\".to_string());\n let set_value_calldata = set_value.calldata();\n\n let internal_call_tx_builder = multicall_contract.aggregate(vec![Multicall::Call {\n target: *simple_storage_contract.address(),\n callData: set_value_calldata.to_owned(),\n }]);\n\n let internal_call_tx_calldata = internal_call_tx_builder.calldata().to_owned();\n\n let internal_call_tx = TransactionRequest::default()\n .from(wallets[1].address())\n .to(*multicall_contract.address())\n .with_input(internal_call_tx_calldata);\n\n let js_tracer_code = r#\"\n{\ndata: [],\nstep: function(log) {\n var op = log.op.toString();\n if (op === \"SLOAD\") {\n this.data.push(log.getPC() + \": SLOAD \" + log.contract.getAddress() + \":\" + log.stack.peek(0));\n this.data.push(\" Result: \" + log.stack.peek(0));\n } else if (op === \"SSTORE\") {\n this.data.push(log.getPC() + \": SSTORE \" + log.contract.getAddress() + \":\" + log.stack.peek(1) + \" <- \" + log.stack.peek(0));\n }\n},\nresult: function() {\n return this.data;\n},\nfault: function(log) {}\n}\n\"#;\n\n let result = api\n .debug_trace_call(\n WithOtherFields::new(internal_call_tx),\n Some(BlockId::latest()),\n GethDebugTracingCallOptions::default()\n .with_tracing_options(GethDebugTracingOptions::js_tracer(js_tracer_code)),\n )\n .await\n .unwrap();\n\n let expected = vec![\n \"547: SLOAD 231,241,114,94,119,52,206,40,143,131,103,225,187,20,62,144,187,63,5,18:0\",\n \" Result: 0\",\n \"1907: SLOAD 231,241,114,94,119,52,206,40,143,131,103,225,187,20,62,144,187,63,5,18:1\",\n \" Result: 1\",\n \"772: SLOAD 231,241,114,94,119,52,206,40,143,131,103,225,187,20,62,144,187,63,5,18:1\",\n \" Result: 1\",\n \"835: SSTORE 231,241,114,94,119,52,206,40,143,131,103,225,187,20,62,144,187,63,5,18:44498830125527143464827115118378702402016761369235290884359940707316142178310 <- 1\",\n \"919: SSTORE 231,241,114,94,119,52,206,40,143,131,103,225,187,20,62,144,187,63,5,18:0 <- 80084422859880547211683076133703299733277748156566366325829078699459944778998\",\n \"712: SLOAD 231,241,114,94,119,52,206,40,143,131,103,225,187,20,62,144,187,63,5,18:0\",\n \" Result: 0\",\n \"765: SSTORE 231,241,114,94,119,52,206,40,143,131,103,225,187,20,62,144,187,63,5,18:546584486846459126461364135121053344201067465379 <- 0\",\n ];\n\n let actual: Vec = result\n .try_into_json_value()\n .ok()\n .and_then(|val| val.as_array().cloned())\n .map(|arr| arr.into_iter().filter_map(|v| v.as_str().map(|s| s.to_string())).collect())\n .unwrap_or_default();\n\n assert_eq!(actual, expected);\n}\n\n#[cfg(feature = \"js-tracer\")]\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_debug_trace_transaction_js_tracer() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Prague.into()));\n let (api, handle) = spawn(node_config).await;\n let provider = crate::utils::http_provider(&handle.http_endpoint());\n\n let wallets = handle.dev_wallets().collect::>();\n let from = wallets[0].address();\n api.anvil_add_balance(from, U256::MAX).await.unwrap();\n api.anvil_add_balance(wallets[1].address(), U256::MAX).await.unwrap();\n\n let multicall_contract = Multicall::deploy(&provider).await.unwrap();\n let simple_storage_contract =\n SimpleStorage::deploy(&provider, \"init value\".to_string()).await.unwrap();\n\n let set_value = simple_storage_contract.setValue(\"bar\".to_string());\n let set_value_calldata = set_value.calldata();\n\n let internal_call_tx_builder = multicall_contract.aggregate(vec![Multicall::Call {\n target: *simple_storage_contract.address(),\n callData: set_value_calldata.to_owned(),\n }]);\n\n let internal_call_tx_calldata = internal_call_tx_builder.calldata().to_owned();\n\n let internal_call_tx = TransactionRequest::default()\n .from(wallets[1].address())\n .to(*multicall_contract.address())\n .with_input(internal_call_tx_calldata)\n .with_gas_limit(1_000_000)\n .with_max_fee_per_gas(100_000_000_000)\n .with_max_priority_fee_per_gas(100_000_000_000);\n\n let receipt = provider\n .send_transaction(internal_call_tx.into())\n .await\n .unwrap()\n .get_receipt()\n .await\n .unwrap();\n let js_tracer_code = r#\"\n{\ndata: [],\nstep: function(log) {\n var op = log.op.toString();\n var pc = log.getPC();\n var addr = log.contract.getAddress();\n\n if (op === \"SLOAD\") {\n this.data.push(pc + \": SLOAD \" + addr + \":\" + log.stack.peek(0));\n this.data.push(\" Result: \" + log.stack.peek(0));\n } else if (op === \"SSTORE\") {\n this.data.push(pc + \": SSTORE \" + addr + \":\" + log.stack.peek(1) + \" <- \" + log.stack.peek(0));\n } \n},\nresult: function() {\n return this.data;\n},\nfault: function(log) {}\n}\n\"#;\n\n let expected = vec![\n \"547: SLOAD 231,241,114,94,119,52,206,40,143,131,103,225,187,20,62,144,187,63,5,18:0\",\n \" Result: 0\",\n \"1907: SLOAD 231,241,114,94,119,52,206,40,143,131,103,225,187,20,62,144,187,63,5,18:1\",\n \" Result: 1\",\n \"772: SLOAD 231,241,114,94,119,52,206,40,143,131,103,225,187,20,62,144,187,63,5,18:1\",\n \" Result: 1\",\n \"835: SSTORE 231,241,114,94,119,52,206,40,143,131,103,225,187,20,62,144,187,63,5,18:44498830125527143464827115118378702402016761369235290884359940707316142178310 <- 1\",\n \"919: SSTORE 231,241,114,94,119,52,206,40,143,131,103,225,187,20,62,144,187,63,5,18:0 <- 80084422859880547211683076133703299733277748156566366325829078699459944778998\",\n \"712: SLOAD 231,241,114,94,119,52,206,40,143,131,103,225,187,20,62,144,187,63,5,18:0\",\n \" Result: 0\",\n \"765: SSTORE 231,241,114,94,119,52,206,40,143,131,103,225,187,20,62,144,187,63,5,18:546584486846459126461364135121053344201067465379 <- 0\",\n ];\n let result = api\n .debug_trace_transaction(\n receipt.transaction_hash,\n GethDebugTracingOptions::js_tracer(js_tracer_code),\n )\n .await\n .unwrap();\n\n let actual: Vec = result\n .try_into_json_value()\n .ok()\n .and_then(|val| val.as_array().cloned())\n .map(|arr| arr.into_iter().filter_map(|v| v.as_str().map(|s| s.to_string())).collect())\n .unwrap_or_default();\n\n assert_eq!(actual, expected);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_call_tracer_debug_trace_call_pre_state_tracer() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let wallets = handle.dev_wallets().collect::>();\n let deployer: EthereumWallet = wallets[0].clone().into();\n let provider = http_provider_with_signer(&handle.http_endpoint(), deployer);\n\n let multicall_contract = Multicall::deploy(&provider).await.unwrap();\n let simple_storage_contract =\n SimpleStorage::deploy(&provider, \"init value\".to_string()).await.unwrap();\n\n let set_value = simple_storage_contract.setValue(\"bar\".to_string());\n let set_value_calldata = set_value.calldata();\n\n let internal_call_tx_builder = multicall_contract.aggregate(vec![Multicall::Call {\n target: *simple_storage_contract.address(),\n callData: set_value_calldata.to_owned(),\n }]);\n\n let internal_call_tx_calldata = internal_call_tx_builder.calldata().to_owned();\n\n let internal_call_tx = TransactionRequest::default()\n .from(wallets[1].address())\n .to(*multicall_contract.address())\n .with_input(internal_call_tx_calldata);\n\n let result = api\n .debug_trace_call(\n WithOtherFields::new(internal_call_tx),\n Some(BlockId::latest()),\n GethDebugTracingCallOptions::default().with_tracing_options(\n GethDebugTracingOptions::prestate_tracer(PreStateConfig::default()),\n ),\n )\n .await\n .unwrap();\n\n let expected = r#\"\n{\n \"0x0000000000000000000000000000000000000000\": {\n \"balance\": \"0x12670f\"\n },\n \"0x5fbdb2315678afecb367f032d93f642f64180aa3\": {\n \"balance\": \"0x0\",\n \"nonce\": 1\n },\n \"0x70997970c51812dc3a010c7d01b50e0d17dc79c8\": {\n \"balance\": \"0x56bc75e2d63100000\"\n },\n \"0xe7f1725e7734ce288f8367e1bb143e90bb3f0512\": {\n \"balance\": \"0x0\",\n \"nonce\": 1,\n \"storage\": {\n \"0x0000000000000000000000000000000000000000000000000000000000000000\": \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"0x0000000000000000000000000000000000000000000000000000000000000001\": \"0x696e69742076616c756500000000000000000000000000000000000000000014\",\n \"0xb10e2d527612073b26eecdfd717e6a320cf44b4afac2b0732d9fcbe2b7fa0cf6\": \"0x0000000000000000000000000000000000000000000000000000000000000000\"\n }\n }\n}\n \"#;\n let expected: HashMap = serde_json::from_str(expected).unwrap();\n\n match result {\n GethTrace::PreStateTracer(PreStateFrame::Default(pre_state_mode)) => {\n for (addr, acc) in pre_state_mode.0 {\n let expected_acc = expected.get(&addr).unwrap();\n assert_eq!(acc.balance, expected_acc.balance);\n assert_eq!(acc.nonce, expected_acc.nonce);\n let expected_storage = &expected_acc.storage;\n for (slot, value) in acc.storage {\n assert_eq!(value, *expected_storage.get(&slot).unwrap())\n }\n }\n }\n _ => unreachable!(),\n }\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_debug_trace_transaction_pre_state_tracer() {\n let node_config = NodeConfig::test().with_hardfork(Some(EthereumHardfork::Prague.into()));\n let (api, handle) = spawn(node_config).await;\n let provider = crate::utils::http_provider(&handle.http_endpoint());\n\n let wallets = handle.dev_wallets().collect::>();\n let from = wallets[0].address();\n api.anvil_add_balance(from, U256::MAX).await.unwrap();\n api.anvil_add_balance(wallets[1].address(), U256::MAX).await.unwrap();\n\n let multicall_contract = Multicall::deploy(&provider).await.unwrap();\n let simple_storage_contract =\n SimpleStorage::deploy(&provider, \"init value\".to_string()).await.unwrap();\n\n let set_value = simple_storage_contract.setValue(\"bar\".to_string());\n let set_value_calldata = set_value.calldata();\n\n let internal_call_tx_builder = multicall_contract.aggregate(vec![Multicall::Call {\n target: *simple_storage_contract.address(),\n callData: set_value_calldata.to_owned(),\n }]);\n\n let internal_call_tx_calldata = internal_call_tx_builder.calldata().to_owned();\n\n let internal_call_tx = TransactionRequest::default()\n .from(wallets[1].address())\n .to(*multicall_contract.address())\n .with_input(internal_call_tx_calldata)\n .with_gas_limit(1_000_000)\n .with_max_fee_per_gas(100_000_000_000)\n .with_max_priority_fee_per_gas(100_000_000_000);\n\n let receipt = provider\n .send_transaction(internal_call_tx.into())\n .await\n .unwrap()\n .get_receipt()\n .await\n .unwrap();\n\n let result = api\n .debug_trace_transaction(\n receipt.transaction_hash,\n GethDebugTracingOptions::prestate_tracer(PreStateConfig::default()),\n )\n .await\n .unwrap();\n\n let expected = r#\"\n{\n \"0x0000000000000000000000000000000000000000\": {\n \"balance\": \"1206031000000000\"\n },\n \"0x5fbdb2315678afecb367f032d93f642f64180aa3\": {\n \"balance\": \"0x0\",\n \"nonce\": 1\n },\n \"0x70997970c51812dc3a010c7d01b50e0d17dc79c8\": {\n \"balance\": \"0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff\"\n },\n \"0xe7f1725e7734ce288f8367e1bb143e90bb3f0512\": {\n \"balance\": \"0x0\",\n \"nonce\": 1,\n \"storage\": {\n \"0x0000000000000000000000000000000000000000000000000000000000000000\": \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"0x0000000000000000000000000000000000000000000000000000000000000001\": \"0x696e69742076616c756500000000000000000000000000000000000000000014\",\n \"0xb10e2d527612073b26eecdfd717e6a320cf44b4afac2b0732d9fcbe2b7fa0cf6\": \"0x0000000000000000000000000000000000000000000000000000000000000000\"\n }\n }\n}\n \"#;\n let expected: HashMap = serde_json::from_str(expected).unwrap();\n\n match result {\n GethTrace::PreStateTracer(PreStateFrame::Default(pre_state_mode)) => {\n for (addr, acc) in pre_state_mode.0 {\n let expected_acc = expected.get(&addr).unwrap();\n assert_eq!(acc.balance, expected_acc.balance);\n assert_eq!(acc.nonce, expected_acc.nonce);\n let expected_storage = &expected_acc.storage;\n for (slot, value) in acc.storage {\n assert_eq!(value, *expected_storage.get(&slot).unwrap())\n }\n }\n }\n _ => unreachable!(),\n }\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_trace_replay_block_transactions_local() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n api.anvil_set_auto_mine(false).await.unwrap();\n\n let accounts = handle.dev_wallets().collect::>();\n let from = accounts[0].address();\n let to = accounts[1].address();\n let amount = U256::from(1000000u64);\n\n // Send first transaction\n let tx1 = TransactionRequest::default().to(to).value(amount).from(from);\n let tx1 = WithOtherFields::new(tx1);\n let pending_tx1 = provider.send_transaction(tx1).await.unwrap();\n\n // Send second transaction with different value\n let tx2 = TransactionRequest::default().to(to).value(amount).from(from);\n let tx2 = WithOtherFields::new(tx2);\n let pending_tx2 = provider.send_transaction(tx2).await.unwrap();\n\n api.mine_one().await;\n let receipt1 = pending_tx1.get_receipt().await.unwrap();\n let receipt2 = pending_tx2.get_receipt().await.unwrap();\n\n let block_number = receipt2.block_number.unwrap();\n\n // Replay the block transactions with call trace type\n // Pass block number as hex string as per Ethereum RPC spec\n let results = api\n .trace_replay_block_transactions(\n block_number.into(),\n vec![TraceType::Trace, TraceType::VmTrace, TraceType::StateDiff].into_iter().collect(),\n )\n .await\n .unwrap();\n\n // Verify we have traces for both transactions\n assert_eq!(results.len(), 2, \"Should have traces for 2 transactions\");\n\n // Verify first transaction hash matches\n assert_eq!(results[0].transaction_hash, receipt1.transaction_hash);\n\n // Verify second transaction hash matches\n assert_eq!(results[1].transaction_hash, receipt2.transaction_hash);\n\n // Verify trace types are present and accurate\n for result in results {\n let full_trace = &result.full_trace;\n\n // Verify Trace (call trace) is present and accurate\n assert!(!full_trace.trace.is_empty(), \"Trace should not be empty\");\n let first_trace = &full_trace.trace[0];\n match &first_trace.action {\n Action::Call(call) => {\n assert_eq!(call.from, from, \"Call from address should match\");\n assert_eq!(call.to, to, \"Call to address should match\");\n }\n _ => panic!(\"Expected Call action, got {:?}\", first_trace.action),\n }\n\n // Verify VmTrace is present\n assert!(full_trace.vm_trace.is_some(), \"VmTrace should be present when requested\");\n\n // Verify StateDiff is present\n assert!(full_trace.state_diff.is_some(), \"StateDiff should be present when requested\");\n // Verify balance change is correct in state diff\n let ChangedType:: { from, to } =\n full_trace.state_diff.as_ref().unwrap().get(&to).unwrap().balance.as_changed().unwrap();\n assert_eq!(\n to.checked_sub(*from).unwrap(),\n amount,\n \"Incorrect balance change in state diff\"\n );\n }\n}\n" }, { "path": "crates/anvil/tests/it/transaction.rs", "content": "use crate::{\n abi::{Greeter, Multicall, SimpleStorage},\n utils::{connect_pubsub, http_provider_with_signer},\n};\nuse alloy_consensus::Transaction;\nuse alloy_network::{EthereumWallet, ReceiptResponse, TransactionBuilder, TransactionResponse};\nuse alloy_primitives::{Address, Bytes, FixedBytes, U256, address, hex, map::B256HashSet};\nuse alloy_provider::{Provider, WsConnect};\nuse alloy_rpc_types::{\n AccessList, AccessListItem, BlockId, BlockNumberOrTag, BlockOverrides, BlockTransactions,\n TransactionRequest,\n state::{AccountOverride, EvmOverrides, StateOverride, StateOverridesBuilder},\n};\nuse alloy_serde::WithOtherFields;\nuse alloy_sol_types::SolValue;\nuse anvil::{NodeConfig, spawn};\nuse eyre::Ok;\nuse foundry_evm::hardfork::EthereumHardfork;\nuse futures::{FutureExt, StreamExt, future::join_all};\nuse revm::primitives::eip7825::TX_GAS_LIMIT_CAP;\nuse std::{str::FromStr, time::Duration};\nuse tokio::time::timeout;\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_transfer_eth() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let accounts = handle.dev_wallets().collect::>();\n let from = accounts[0].address();\n let to = accounts[1].address();\n\n let nonce = provider.get_transaction_count(from).await.unwrap();\n assert!(nonce == 0);\n\n let balance_before = provider.get_balance(to).await.unwrap();\n\n let amount = handle.genesis_balance().checked_div(U256::from(2u64)).unwrap();\n\n // craft the tx\n // specify the `from` field so that the client knows which account to use\n let tx = TransactionRequest::default().to(to).value(amount).from(from);\n let tx = WithOtherFields::new(tx);\n // broadcast it via the eth_sendTransaction API\n let tx = provider.send_transaction(tx).await.unwrap();\n\n let tx = tx.get_receipt().await.unwrap();\n\n assert_eq!(tx.block_number, Some(1));\n assert_eq!(tx.transaction_index, Some(0));\n\n let nonce = provider.get_transaction_count(from).await.unwrap();\n\n assert_eq!(nonce, 1);\n\n let to_balance = provider.get_balance(to).await.unwrap();\n\n assert_eq!(balance_before.saturating_add(amount), to_balance);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_order_transactions() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n // disable automine\n api.anvil_set_auto_mine(false).await.unwrap();\n\n let accounts = handle.dev_wallets().collect::>();\n let from = accounts[0].address();\n let to = accounts[1].address();\n\n let amount = handle.genesis_balance().checked_div(U256::from(2u64)).unwrap();\n\n let gas_price = provider.get_gas_price().await.unwrap();\n\n // craft the tx with lower price\n let mut tx = TransactionRequest::default().to(to).from(from).value(amount);\n\n tx.set_gas_price(gas_price);\n let tx = WithOtherFields::new(tx);\n let tx_lower = provider.send_transaction(tx).await.unwrap();\n\n // craft the tx with higher price\n let mut tx = TransactionRequest::default().to(from).from(to).value(amount);\n\n tx.set_gas_price(gas_price + 1);\n let tx = WithOtherFields::new(tx);\n let tx_higher = provider.send_transaction(tx).await.unwrap();\n\n // manually mine the block with the transactions\n api.mine_one().await;\n\n let higher_price = tx_higher.get_receipt().await.unwrap().transaction_hash;\n let lower_price = tx_lower.get_receipt().await.unwrap().transaction_hash;\n\n // get the block, await receipts\n let block = provider.get_block(BlockId::latest()).await.unwrap().unwrap();\n\n assert_eq!(block.transactions, BlockTransactions::Hashes(vec![higher_price, lower_price]))\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_respect_nonces() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let accounts = handle.dev_wallets().collect::>();\n let from = accounts[0].address();\n let to = accounts[1].address();\n\n let nonce = provider.get_transaction_count(from).await.unwrap();\n let amount = handle.genesis_balance().checked_div(U256::from(3u64)).unwrap();\n\n let tx = TransactionRequest::default().to(to).value(amount).from(from).nonce(nonce + 1);\n\n let tx = WithOtherFields::new(tx);\n\n // send the transaction with higher nonce than on chain\n let higher_pending_tx = provider.send_transaction(tx).await.unwrap();\n\n // ensure the listener for ready transactions times out\n let mut listener = api.new_ready_transactions();\n let res = timeout(Duration::from_millis(1500), listener.next()).await;\n res.unwrap_err();\n\n let tx = TransactionRequest::default().to(to).value(amount).from(from).nonce(nonce);\n\n let tx = WithOtherFields::new(tx);\n // send with the actual nonce which is mined immediately\n let tx = provider.send_transaction(tx).await.unwrap();\n\n let tx = tx.get_receipt().await.unwrap();\n // this will unblock the currently pending tx\n let higher_tx = higher_pending_tx.get_receipt().await.unwrap(); // Awaits endlessly here due to alloy/#389\n\n let block = provider.get_block(1.into()).await.unwrap().unwrap();\n assert_eq!(2, block.transactions.len());\n assert_eq!(\n BlockTransactions::Hashes(vec![tx.transaction_hash, higher_tx.transaction_hash]),\n block.transactions\n );\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_replace_transaction() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n // disable auto mining\n api.anvil_set_auto_mine(false).await.unwrap();\n\n let provider = handle.http_provider();\n\n let accounts = handle.dev_wallets().collect::>();\n let from = accounts[0].address();\n let to = accounts[1].address();\n\n let nonce = provider.get_transaction_count(from).await.unwrap();\n let gas_price = provider.get_gas_price().await.unwrap();\n let amount = handle.genesis_balance().checked_div(U256::from(3u64)).unwrap();\n\n let tx = TransactionRequest::default().to(to).value(amount).from(from).nonce(nonce);\n\n let mut tx = WithOtherFields::new(tx);\n\n tx.set_gas_price(gas_price);\n // send transaction with lower gas price\n let _lower_priced_pending_tx = provider.send_transaction(tx.clone()).await.unwrap();\n\n tx.set_gas_price(gas_price + 1);\n // send the same transaction with higher gas price\n let higher_priced_pending_tx = provider.send_transaction(tx).await.unwrap();\n\n let higher_tx_hash = *higher_priced_pending_tx.tx_hash();\n // mine exactly one block\n api.mine_one().await;\n\n let block = provider.get_block(1.into()).await.unwrap().unwrap();\n\n assert_eq!(block.transactions.len(), 1);\n assert_eq!(BlockTransactions::Hashes(vec![higher_tx_hash]), block.transactions);\n\n // verify the higher priced transaction was included\n let higher_priced_receipt = higher_priced_pending_tx.get_receipt().await.unwrap();\n assert_eq!(higher_priced_receipt.transaction_hash, higher_tx_hash);\n\n // verify only one transaction was included in the block (lower priced was replaced)\n assert_eq!(1, block.transactions.len());\n assert_eq!(\n BlockTransactions::Hashes(vec![higher_priced_receipt.transaction_hash]),\n block.transactions\n );\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_reject_too_high_gas_limits() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let accounts = handle.dev_wallets().collect::>();\n let from = accounts[0].address();\n let to = accounts[1].address();\n\n let gas_limit = api.gas_limit().to::();\n let amount = handle.genesis_balance().checked_div(U256::from(3u64)).unwrap();\n\n let tx =\n TransactionRequest::default().to(to).value(amount).from(from).with_gas_limit(gas_limit);\n\n let mut tx = WithOtherFields::new(tx);\n\n // send transaction with the exact gas limit\n let pending = provider.send_transaction(tx.clone()).await.unwrap();\n\n let pending_receipt = pending.get_receipt().await;\n assert!(pending_receipt.is_ok());\n\n tx.set_gas_limit(gas_limit + 1);\n\n // send transaction with higher gas limit\n let pending = provider.send_transaction(tx.clone()).await;\n\n assert!(pending.is_err());\n let err = pending.unwrap_err();\n assert!(err.to_string().contains(\"gas too high\"));\n\n api.anvil_set_balance(from, U256::MAX).await.unwrap();\n\n tx.set_gas_limit(gas_limit);\n let pending = provider.send_transaction(tx).await;\n let _ = pending.unwrap();\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_mine_large_gas_limit() {\n let (_, handle) = spawn(NodeConfig::test().disable_block_gas_limit(true)).await;\n let provider = handle.http_provider();\n\n let accounts = handle.dev_wallets().collect::>();\n let from = accounts[0].address();\n let to = accounts[1].address();\n\n let gas_limit = anvil::DEFAULT_GAS_LIMIT;\n let amount = handle.genesis_balance().checked_div(U256::from(3u64)).unwrap();\n\n let tx =\n TransactionRequest::default().to(to).value(amount).from(from).with_gas_limit(gas_limit);\n\n // send transaction with higher gas limit\n let pending = provider.send_transaction(WithOtherFields::new(tx)).await.unwrap();\n\n let _resp = pending.get_receipt().await.unwrap();\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_reject_underpriced_replacement() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n // disable auto mining\n api.anvil_set_auto_mine(false).await.unwrap();\n\n let provider = handle.http_provider();\n\n let accounts = handle.dev_wallets().collect::>();\n let from = accounts[0].address();\n let to = accounts[1].address();\n\n let nonce = provider.get_transaction_count(from).await.unwrap();\n let gas_price = provider.get_gas_price().await.unwrap();\n let amount = handle.genesis_balance().checked_div(U256::from(3u64)).unwrap();\n\n let tx = TransactionRequest::default().to(to).value(amount).from(from).nonce(nonce);\n\n let mut tx = WithOtherFields::new(tx);\n\n tx.set_gas_price(gas_price + 1);\n // send transaction with higher gas price\n let higher_priced_pending_tx = provider.send_transaction(tx.clone()).await.unwrap();\n\n tx.set_gas_price(gas_price);\n // send the same transaction with lower gas price\n let lower_priced_pending_tx = provider.send_transaction(tx).await;\n\n let replacement_err = lower_priced_pending_tx.unwrap_err();\n assert!(replacement_err.to_string().contains(\"replacement transaction underpriced\"));\n\n // mine exactly one block\n api.mine_one().await;\n let higher_priced_receipt = higher_priced_pending_tx.get_receipt().await.unwrap();\n\n // ensure that only the higher priced tx was mined\n let block = provider.get_block(1.into()).await.unwrap().unwrap();\n assert_eq!(1, block.transactions.len());\n assert_eq!(\n BlockTransactions::Hashes(vec![higher_priced_receipt.transaction_hash]),\n block.transactions\n );\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_deploy_greeter_http() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let wallet = handle.dev_wallets().next().unwrap();\n\n let signer: EthereumWallet = wallet.clone().into();\n\n let alloy_provider = http_provider_with_signer(&handle.http_endpoint(), signer);\n\n let alloy_greeter_addr =\n Greeter::deploy_builder(alloy_provider.clone(), \"Hello World!\".to_string())\n // .legacy() unimplemented! in alloy\n .deploy()\n .await\n .unwrap();\n\n let alloy_greeter = Greeter::new(alloy_greeter_addr, alloy_provider);\n\n let greeting = alloy_greeter.greet().call().await.unwrap();\n\n assert_eq!(\"Hello World!\", greeting);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_deploy_and_mine_manually() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n // can mine in auto-mine mode\n api.evm_mine(None).await.unwrap();\n // disable auto mine\n api.anvil_set_auto_mine(false).await.unwrap();\n // can mine in manual mode\n api.evm_mine(None).await.unwrap();\n\n let provider = handle.http_provider();\n\n let wallet = handle.dev_wallets().next().unwrap();\n let from = wallet.address();\n\n let greeter_builder =\n Greeter::deploy_builder(provider.clone(), \"Hello World!\".to_string()).from(from);\n let greeter_calldata = greeter_builder.calldata();\n\n let tx = TransactionRequest::default().from(from).with_input(greeter_calldata.to_owned());\n\n let tx = WithOtherFields::new(tx);\n\n let tx = provider.send_transaction(tx).await.unwrap();\n\n // mine block with tx manually\n api.evm_mine(None).await.unwrap();\n\n let receipt = tx.get_receipt().await.unwrap();\n\n let address = receipt.contract_address.unwrap();\n let greeter_contract = Greeter::new(address, provider);\n let greeting = greeter_contract.greet().call().await.unwrap();\n assert_eq!(\"Hello World!\", greeting);\n\n let set_greeting = greeter_contract.setGreeting(\"Another Message\".to_string());\n let tx = set_greeting.send().await.unwrap();\n\n // mine block manually\n api.evm_mine(None).await.unwrap();\n\n let _tx = tx.get_receipt().await.unwrap();\n let greeting = greeter_contract.greet().call().await.unwrap();\n assert_eq!(\"Another Message\", greeting);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_mine_automatically() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n // disable auto mine\n api.anvil_set_auto_mine(false).await.unwrap();\n\n let wallet = handle.dev_wallets().next().unwrap();\n\n let greeter_builder = Greeter::deploy_builder(provider.clone(), \"Hello World!\".to_string())\n .from(wallet.address());\n\n let greeter_calldata = greeter_builder.calldata();\n\n let tx = TransactionRequest::default()\n .from(wallet.address())\n .with_input(greeter_calldata.to_owned());\n\n let tx = WithOtherFields::new(tx);\n\n let sent_tx = provider.send_transaction(tx).await.unwrap();\n\n // re-enable auto mine\n api.anvil_set_auto_mine(true).await.unwrap();\n\n let receipt = sent_tx.get_receipt().await.unwrap();\n assert_eq!(receipt.block_number, Some(1));\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_call_greeter_historic() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let wallet = handle.dev_wallets().next().unwrap();\n\n let greeter_addr = Greeter::deploy_builder(provider.clone(), \"Hello World!\".to_string())\n .from(wallet.address())\n .deploy()\n .await\n .unwrap();\n\n let greeter_contract = Greeter::new(greeter_addr, provider.clone());\n\n let greeting = greeter_contract.greet().call().await.unwrap();\n assert_eq!(\"Hello World!\", greeting);\n\n let block_number = provider.get_block_number().await.unwrap();\n\n let _receipt = greeter_contract\n .setGreeting(\"Another Message\".to_string())\n .send()\n .await\n .unwrap()\n .get_receipt()\n .await\n .unwrap();\n\n let greeting = greeter_contract.greet().call().await.unwrap();\n assert_eq!(\"Another Message\", greeting);\n\n // min\n api.mine_one().await;\n\n // returns previous state\n let greeting =\n greeter_contract.greet().block(BlockId::Number(block_number.into())).call().await.unwrap();\n assert_eq!(\"Hello World!\", greeting);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_deploy_greeter_ws() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.ws_provider();\n\n let wallet = handle.dev_wallets().next().unwrap();\n\n let greeter_addr = Greeter::deploy_builder(provider.clone(), \"Hello World!\".to_string())\n .from(wallet.address())\n // .legacy() unimplemented! in alloy\n .deploy()\n .await\n .unwrap();\n\n let greeter_contract = Greeter::new(greeter_addr, provider.clone());\n\n let greeting = greeter_contract.greet().call().await.unwrap();\n assert_eq!(\"Hello World!\", greeting);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_deploy_get_code() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.ws_provider();\n\n let wallet = handle.dev_wallets().next().unwrap();\n\n let greeter_addr = Greeter::deploy_builder(provider.clone(), \"Hello World!\".to_string())\n .from(wallet.address())\n .deploy()\n .await\n .unwrap();\n\n let code = provider.get_code_at(greeter_addr).await.unwrap();\n assert!(!code.as_ref().is_empty());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn get_blocktimestamp_works() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let contract = Multicall::deploy(provider.clone()).await.unwrap();\n\n let timestamp = contract.getCurrentBlockTimestamp().call().await.unwrap();\n\n assert!(timestamp > U256::from(1));\n\n let latest_block =\n api.block_by_number(alloy_rpc_types::BlockNumberOrTag::Latest).await.unwrap().unwrap();\n\n let timestamp = contract.getCurrentBlockTimestamp().call().await.unwrap();\n assert_eq!(timestamp.to::(), latest_block.header.timestamp);\n\n // repeat call same result\n let timestamp = contract.getCurrentBlockTimestamp().call().await.unwrap();\n assert_eq!(timestamp.to::(), latest_block.header.timestamp);\n\n // mock timestamp\n let next_timestamp = timestamp.to::() + 1337;\n api.evm_set_next_block_timestamp(next_timestamp).unwrap();\n\n let timestamp =\n contract.getCurrentBlockTimestamp().block(BlockId::pending()).call().await.unwrap();\n assert_eq!(timestamp, U256::from(next_timestamp));\n\n // repeat call same result\n let timestamp =\n contract.getCurrentBlockTimestamp().block(BlockId::pending()).call().await.unwrap();\n assert_eq!(timestamp, U256::from(next_timestamp));\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn call_past_state() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let wallet = handle.dev_wallets().next().unwrap();\n let contract_addr =\n SimpleStorage::deploy_builder(provider.clone(), \"initial value\".to_string())\n .from(wallet.address())\n .deploy()\n .await\n .unwrap();\n\n let contract = SimpleStorage::new(contract_addr, provider.clone());\n\n let deployed_block = provider.get_block_number().await.unwrap();\n\n let value = contract.getValue().call().await.unwrap();\n assert_eq!(value, \"initial value\");\n\n let gas_price = api.gas_price();\n let set_tx = contract.setValue(\"hi\".to_string()).gas_price(gas_price + 1);\n\n let _receipt = set_tx.send().await.unwrap().get_receipt().await.unwrap();\n\n // assert new value\n let value = contract.getValue().call().await.unwrap();\n assert_eq!(value, \"hi\");\n\n // assert previous value\n let value =\n contract.getValue().block(BlockId::Number(deployed_block.into())).call().await.unwrap();\n assert_eq!(value, \"initial value\");\n\n let hash = provider.get_block(BlockId::Number(1.into())).await.unwrap().unwrap().header.hash;\n let value = contract.getValue().block(BlockId::Hash(hash.into())).call().await.unwrap();\n assert_eq!(value, \"initial value\");\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_handle_multiple_concurrent_transfers_with_same_nonce() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n\n let provider = handle.ws_provider();\n\n let accounts = handle.dev_wallets().collect::>();\n let from = accounts[0].address();\n let to = accounts[1].address();\n\n let nonce = provider.get_transaction_count(from).await.unwrap();\n\n // explicitly set the nonce\n let tx = TransactionRequest::default()\n .to(to)\n .value(U256::from(100))\n .from(from)\n .nonce(nonce)\n .with_gas_limit(21000);\n\n let tx = WithOtherFields::new(tx);\n\n let mut tasks = Vec::new();\n for _ in 0..10 {\n let tx = tx.clone();\n let provider = provider.clone();\n let task = tokio::task::spawn(async move {\n provider.send_transaction(tx).await.unwrap().get_receipt().await\n });\n tasks.push(task);\n }\n\n // only one succeeded\n let successful_tx =\n join_all(tasks).await.into_iter().filter(|res| res.as_ref().is_ok()).count();\n assert_eq!(successful_tx, 1);\n\n assert_eq!(provider.get_transaction_count(from).await.unwrap(), 1u64);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_handle_multiple_concurrent_deploys_with_same_nonce() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.ws_provider();\n\n let wallet = handle.dev_wallets().next().unwrap();\n let from = wallet.address();\n let nonce = provider.get_transaction_count(from).await.unwrap();\n\n let mut tasks = Vec::new();\n\n let greeter = Greeter::deploy_builder(provider.clone(), \"Hello World!\".to_string());\n\n let greeter_calldata = greeter.calldata();\n\n let tx = TransactionRequest::default()\n .from(from)\n .with_input(greeter_calldata.to_owned())\n .nonce(nonce)\n .with_gas_limit(300_000);\n\n let tx = WithOtherFields::new(tx);\n\n for _ in 0..10 {\n let provider = provider.clone();\n let tx = tx.clone();\n let task = tokio::task::spawn(async move {\n Ok(provider.send_transaction(tx).await?.get_receipt().await.unwrap())\n });\n tasks.push(task);\n }\n\n // only one succeeded\n let successful_tx =\n join_all(tasks).await.into_iter().filter(|res| res.as_ref().unwrap().is_ok()).count();\n assert_eq!(successful_tx, 1);\n assert_eq!(provider.get_transaction_count(from).await.unwrap(), 1u64);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_handle_multiple_concurrent_transactions_with_same_nonce() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.ws_provider();\n\n let wallet = handle.dev_wallets().next().unwrap();\n let from = wallet.address();\n\n let greeter_contract =\n Greeter::deploy(provider.clone(), \"Hello World!\".to_string()).await.unwrap();\n\n let nonce = provider.get_transaction_count(from).await.unwrap();\n\n let mut tasks = Vec::new();\n\n let deploy = Greeter::deploy_builder(provider.clone(), \"Hello World!\".to_string());\n let deploy_calldata = deploy.calldata();\n let deploy_tx = TransactionRequest::default()\n .from(from)\n .with_input(deploy_calldata.to_owned())\n .nonce(nonce)\n .with_gas_limit(300_000);\n let deploy_tx = WithOtherFields::new(deploy_tx);\n\n let set_greeting = greeter_contract.setGreeting(\"Hello\".to_string());\n let set_greeting_calldata = set_greeting.calldata();\n\n let set_greeting_tx = TransactionRequest::default()\n .from(from)\n .with_input(set_greeting_calldata.to_owned())\n .nonce(nonce)\n .with_gas_limit(300_000);\n let set_greeting_tx = WithOtherFields::new(set_greeting_tx);\n\n for idx in 0..10 {\n let provider = provider.clone();\n let task = if idx % 2 == 0 {\n let tx = deploy_tx.clone();\n tokio::task::spawn(async move {\n Ok(provider.send_transaction(tx).await?.get_receipt().await.unwrap())\n })\n } else {\n let tx = set_greeting_tx.clone();\n tokio::task::spawn(async move {\n Ok(provider.send_transaction(tx).await?.get_receipt().await.unwrap())\n })\n };\n\n tasks.push(task);\n }\n\n // only one succeeded\n let successful_tx =\n join_all(tasks).await.into_iter().filter(|res| res.as_ref().unwrap().is_ok()).count();\n assert_eq!(successful_tx, 1);\n assert_eq!(provider.get_transaction_count(from).await.unwrap(), nonce + 1);\n}\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_get_pending_transaction() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n // disable auto mining so we can check if we can return pending tx from the mempool\n api.anvil_set_auto_mine(false).await.unwrap();\n\n let provider = handle.http_provider();\n\n let from = handle.dev_wallets().next().unwrap().address();\n let tx = TransactionRequest::default().from(from).value(U256::from(1337)).to(Address::random());\n let tx = WithOtherFields::new(tx);\n let tx = provider.send_transaction(tx).await.unwrap();\n\n let pending = provider.get_transaction_by_hash(*tx.tx_hash()).await;\n assert!(pending.is_ok());\n\n api.mine_one().await;\n let mined = provider.get_transaction_by_hash(*tx.tx_hash()).await.unwrap().unwrap();\n\n assert_eq!(mined.tx_hash(), pending.unwrap().unwrap().tx_hash());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_listen_full_pending_transaction() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n // Disable auto-mining so transactions remain pending\n api.anvil_set_auto_mine(false).await.unwrap();\n\n let provider = alloy_provider::ProviderBuilder::new()\n .connect_ws(WsConnect::new(handle.ws_endpoint()))\n .await\n .unwrap();\n\n // Subscribe to full pending transactions\n let sub = provider.subscribe_full_pending_transactions().await;\n tokio::time::sleep(Duration::from_millis(1000)).await;\n let mut stream = sub.expect(\"Failed to subscribe to pending tx\").into_stream().take(5);\n\n let from = handle.dev_wallets().next().unwrap().address();\n let tx = TransactionRequest::default().from(from).value(U256::from(1337)).to(Address::random());\n\n let tx = provider.send_transaction(tx).await.unwrap();\n\n // Wait for the subscription to yield a transaction\n let received = stream.next().await.expect(\"Failed to receive pending tx\");\n\n assert_eq!(received.tx_hash(), *tx.tx_hash());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_get_raw_transaction() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n // first test the pending tx, disable auto mine\n api.anvil_set_auto_mine(false).await.unwrap();\n\n let provider = handle.http_provider();\n\n let from = handle.dev_wallets().next().unwrap().address();\n let tx = TransactionRequest::default().from(from).value(U256::from(1488)).to(Address::random());\n let tx = WithOtherFields::new(tx);\n let tx = provider.send_transaction(tx).await.unwrap();\n\n let res1 = api.raw_transaction(*tx.tx_hash()).await;\n assert!(res1.is_ok());\n\n api.mine_one().await;\n let res2 = api.raw_transaction(*tx.tx_hash()).await;\n\n assert_eq!(res1.unwrap(), res2.unwrap());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_first_nonce_is_zero() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n api.anvil_set_auto_mine(false).await.unwrap();\n\n let provider = handle.http_provider();\n let from = handle.dev_wallets().next().unwrap().address();\n\n let nonce = provider.get_transaction_count(from).block_id(BlockId::pending()).await.unwrap();\n\n assert_eq!(nonce, 0);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_handle_different_sender_nonce_calculation() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n api.anvil_set_auto_mine(false).await.unwrap();\n\n let provider = handle.http_provider();\n let accounts = handle.dev_wallets().collect::>();\n let from_first = accounts[0].address();\n let from_second = accounts[1].address();\n\n let tx_count = 10u64;\n\n // send a bunch of tx to the mempool and check nonce is returned correctly\n for idx in 1..=tx_count {\n let tx_from_first = TransactionRequest::default()\n .from(from_first)\n .value(U256::from(1337u64))\n .to(Address::random());\n let tx_from_first = WithOtherFields::new(tx_from_first);\n let _tx = provider.send_transaction(tx_from_first).await.unwrap();\n let nonce_from_first =\n provider.get_transaction_count(from_first).block_id(BlockId::pending()).await.unwrap();\n assert_eq!(nonce_from_first, idx);\n\n let tx_from_second = TransactionRequest::default()\n .from(from_second)\n .value(U256::from(1337u64))\n .to(Address::random());\n let tx_from_second = WithOtherFields::new(tx_from_second);\n let _tx = provider.send_transaction(tx_from_second).await.unwrap();\n let nonce_from_second =\n provider.get_transaction_count(from_second).block_id(BlockId::pending()).await.unwrap();\n assert_eq!(nonce_from_second, idx);\n }\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn includes_pending_tx_for_transaction_count() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n api.anvil_set_auto_mine(false).await.unwrap();\n\n let provider = handle.http_provider();\n let from = handle.dev_wallets().next().unwrap().address();\n\n let tx_count = 10u64;\n\n // send a bunch of tx to the mempool and check nonce is returned correctly\n for idx in 1..=tx_count {\n let tx =\n TransactionRequest::default().from(from).value(U256::from(1337)).to(Address::random());\n let tx = WithOtherFields::new(tx);\n let _tx = provider.send_transaction(tx).await.unwrap();\n let nonce =\n provider.get_transaction_count(from).block_id(BlockId::pending()).await.unwrap();\n assert_eq!(nonce, idx);\n }\n\n api.mine_one().await;\n let nonce = provider.get_transaction_count(from).block_id(BlockId::pending()).await.unwrap();\n assert_eq!(nonce, tx_count);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_get_historic_info() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let accounts = handle.dev_wallets().collect::>();\n let from = accounts[0].address();\n let to = accounts[1].address();\n\n let amount = handle.genesis_balance().checked_div(U256::from(2u64)).unwrap();\n let tx = TransactionRequest::default().to(to).value(amount).from(from);\n let tx = WithOtherFields::new(tx);\n let tx = provider.send_transaction(tx).await.unwrap();\n let _ = tx.get_receipt().await.unwrap();\n\n let nonce_pre =\n provider.get_transaction_count(from).block_id(BlockId::number(0)).await.unwrap();\n\n let nonce_post = provider.get_transaction_count(from).await.unwrap();\n\n assert!(nonce_pre < nonce_post);\n\n let balance_pre = provider.get_balance(from).block_id(BlockId::number(0)).await.unwrap();\n\n let balance_post = provider.get_balance(from).await.unwrap();\n\n assert!(balance_post < balance_pre);\n\n let to_balance = provider.get_balance(to).await.unwrap();\n assert_eq!(balance_pre.saturating_add(amount), to_balance);\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_tx_receipt() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n\n let wallet = handle.dev_wallets().next().unwrap();\n let provider = handle.http_provider();\n\n let tx = TransactionRequest::default().to(Address::random()).value(U256::from(1337));\n\n let tx = WithOtherFields::new(tx);\n let tx = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n assert!(tx.to.is_some());\n\n let greeter_deploy = Greeter::deploy_builder(provider.clone(), \"Hello World!\".to_string());\n let greeter_calldata = greeter_deploy.calldata();\n\n let tx = TransactionRequest::default()\n .from(wallet.address())\n .with_input(greeter_calldata.to_owned());\n\n let tx = WithOtherFields::new(tx);\n let tx = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n // `to` field is none if it's a contract creation transaction: https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_gettransactionreceipt\n assert!(tx.to.is_none());\n assert!(tx.contract_address.is_some());\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_reverted_contract_creation_has_contract_address() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n\n let provider = handle.http_provider();\n let wallet = handle.dev_wallets().next().unwrap();\n\n // Init code that immediately reverts: PUSH1 0x00 PUSH1 0x00 REVERT (0x60006000fd)\n let reverting_init_code = hex!(\"60006000fd\");\n\n let tx = TransactionRequest::default()\n .from(wallet.address())\n .with_input(reverting_init_code.to_vec());\n\n let tx = WithOtherFields::new(tx);\n let receipt = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n // Transaction should have reverted\n assert!(!receipt.status());\n\n // `to` field should be none (contract creation)\n assert!(receipt.to.is_none());\n\n // `contractAddress` should still be set even though the transaction reverted\n // This matches geth's behavior: https://github.com/ethereum/go-ethereum/issues/27937\n assert!(\n receipt.contract_address.is_some(),\n \"contractAddress should be set for reverted contract creation\"\n );\n\n // Verify the computed address is correct (sender.create(nonce))\n let expected_addr = wallet.address().create(0);\n assert_eq!(receipt.contract_address, Some(expected_addr));\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_stream_pending_transactions() {\n let (_api, handle) =\n spawn(NodeConfig::test().with_blocktime(Some(Duration::from_secs(2)))).await;\n let num_txs = 5;\n\n let provider = handle.http_provider();\n let ws_provider = connect_pubsub(&handle.ws_endpoint()).await;\n\n let accounts = provider.get_accounts().await.unwrap();\n let tx =\n TransactionRequest::default().from(accounts[0]).to(accounts[0]).value(U256::from(1e18));\n\n let mut sending = futures::future::join_all(\n std::iter::repeat_n(tx.clone(), num_txs)\n .enumerate()\n .map(|(nonce, tx)| tx.nonce(nonce as u64))\n .map(|tx| async {\n let tx = WithOtherFields::new(tx);\n provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap()\n }),\n )\n .fuse();\n\n let mut watch_tx_stream = provider\n .watch_pending_transactions()\n .await\n .unwrap()\n .into_stream()\n .flat_map(futures::stream::iter)\n .take(num_txs)\n .fuse();\n\n let mut sub_tx_stream = ws_provider\n .subscribe_pending_transactions()\n .await\n .unwrap()\n .into_stream()\n .take(num_txs)\n .fuse();\n\n let mut sent = None;\n let mut watch_received = Vec::with_capacity(num_txs);\n let mut sub_received = Vec::with_capacity(num_txs);\n\n loop {\n futures::select! {\n txs = sending => {\n sent = Some(txs)\n },\n tx = watch_tx_stream.next() => {\n if let Some(tx) = tx {\n watch_received.push(tx);\n }\n },\n tx = sub_tx_stream.next() => {\n if let Some(tx) = tx {\n sub_received.push(tx);\n }\n },\n complete => unreachable!(),\n };\n\n if watch_received.len() == num_txs\n && sub_received.len() == num_txs\n && let Some(sent) = &sent\n {\n assert_eq!(sent.len(), watch_received.len());\n let sent_txs = sent.iter().map(|tx| tx.transaction_hash).collect::();\n assert_eq!(sent_txs, watch_received.iter().copied().collect());\n assert_eq!(sent_txs, sub_received.iter().copied().collect());\n break;\n }\n }\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_tx_access_list() {\n /// returns a String representation of the AccessList, with sorted\n /// keys (address) and storage slots\n fn access_list_to_sorted_string(a: AccessList) -> String {\n let mut a = a.0;\n a.sort_by_key(|v| v.address);\n\n let a = a\n .iter_mut()\n .map(|v| {\n v.storage_keys.sort();\n (v.address, std::mem::take(&mut v.storage_keys))\n })\n .collect::>();\n\n format!(\"{a:?}\")\n }\n\n /// asserts that the two access lists are equal, by comparing their sorted\n /// string representation\n fn assert_access_list_eq(a: AccessList, b: AccessList) {\n assert_eq!(access_list_to_sorted_string(a), access_list_to_sorted_string(b))\n }\n\n // We want to test a couple of things:\n // - When calling a contract with no storage read/write, it shouldn't be in the AL\n // - When a contract calls a contract, the latter one should be in the AL\n // - No precompiles should be in the AL\n // - The sender shouldn't be in the AL\n let (_api, handle) = spawn(NodeConfig::test()).await;\n\n let provider = handle.http_provider();\n\n let sender = Address::random();\n let other_acc = Address::random();\n let multicall = Multicall::deploy(provider.clone()).await.unwrap();\n let simple_storage = SimpleStorage::deploy(provider.clone(), \"foo\".to_string()).await.unwrap();\n\n // when calling `setValue` on SimpleStorage, both the `lastSender` and `_value` storages are\n // modified The `_value` is a `string`, so the storage slots here (small string) are `0x1`\n // and `keccak(0x1)`\n let set_value = simple_storage.setValue(\"bar\".to_string());\n let set_value_calldata = set_value.calldata();\n let set_value_tx = TransactionRequest::default()\n .from(sender)\n .to(*simple_storage.address())\n .with_input(set_value_calldata.to_owned());\n let set_value_tx = WithOtherFields::new(set_value_tx);\n let access_list = provider.create_access_list(&set_value_tx).await.unwrap();\n // let set_value_tx = simple_storage.set_value(\"bar\".to_string()).from(sender).tx;\n // let access_list = client.create_access_list(&set_value_tx, None).await.unwrap();\n assert_access_list_eq(\n access_list.access_list,\n AccessList::from(vec![AccessListItem {\n address: *simple_storage.address(),\n storage_keys: vec![\n FixedBytes::ZERO,\n FixedBytes::with_last_byte(1),\n FixedBytes::from_str(\n \"0xb10e2d527612073b26eecdfd717e6a320cf44b4afac2b0732d9fcbe2b7fa0cf6\",\n )\n .unwrap(),\n ],\n }]),\n );\n\n // With a subcall that fetches the balances of an account (`other_acc`), only the address\n // of this account should be in the Access List\n let call_tx = multicall.getEthBalance(other_acc);\n let call_tx_data = call_tx.calldata();\n let call_tx = TransactionRequest::default()\n .from(sender)\n .to(*multicall.address())\n .with_input(call_tx_data.to_owned());\n let call_tx = WithOtherFields::new(call_tx);\n let access_list = provider.create_access_list(&call_tx).await.unwrap();\n assert_access_list_eq(\n access_list.access_list,\n AccessList::from(vec![AccessListItem { address: other_acc, storage_keys: vec![] }]),\n );\n\n // With a subcall to another contract, the AccessList should be the same as when calling the\n // subcontract directly (given that the proxy contract doesn't read/write any state)\n let subcall_tx = multicall.aggregate(vec![Multicall::Call {\n target: *simple_storage.address(),\n callData: set_value_calldata.to_owned(),\n }]);\n\n let subcall_tx_calldata = subcall_tx.calldata();\n\n let subcall_tx = TransactionRequest::default()\n .from(sender)\n .to(*multicall.address())\n .with_input(subcall_tx_calldata.to_owned());\n let subcall_tx = WithOtherFields::new(subcall_tx);\n let access_list = provider.create_access_list(&subcall_tx).await.unwrap();\n assert_access_list_eq(\n access_list.access_list,\n // H256::from_uint(&(1u64.into())),\n AccessList::from(vec![AccessListItem {\n address: *simple_storage.address(),\n storage_keys: vec![\n FixedBytes::ZERO,\n FixedBytes::with_last_byte(1),\n FixedBytes::from_str(\n \"0xb10e2d527612073b26eecdfd717e6a320cf44b4afac2b0732d9fcbe2b7fa0cf6\",\n )\n .unwrap(),\n ],\n }]),\n );\n}\n\n// ensures that the gas estimate is running on pending block by default\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn estimates_gas_on_pending_by_default() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n // disable auto mine\n api.anvil_set_auto_mine(false).await.unwrap();\n\n let provider = handle.http_provider();\n\n let wallet = handle.dev_wallets().next().unwrap();\n let sender = wallet.address();\n let recipient = Address::random();\n\n let tx = TransactionRequest::default().from(sender).to(recipient).value(U256::from(1e18));\n let tx = WithOtherFields::new(tx);\n\n let _pending = provider.send_transaction(tx).await.unwrap();\n\n let tx = TransactionRequest::default()\n .from(recipient)\n .to(sender)\n .value(U256::from(1e10))\n .input(Bytes::from(vec![0x42]).into());\n api.estimate_gas(WithOtherFields::new(tx), None, EvmOverrides::default()).await.unwrap();\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_estimate_gas() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n let wallet = handle.dev_wallets().next().unwrap();\n let sender = wallet.address();\n let recipient = Address::random();\n\n let tx = TransactionRequest::default()\n .from(recipient)\n .to(sender)\n .value(U256::from(1e10))\n .input(Bytes::from(vec![0x42]).into());\n // Expect the gas estimation to fail due to insufficient funds.\n let error_result =\n api.estimate_gas(WithOtherFields::new(tx.clone()), None, EvmOverrides::default()).await;\n\n assert!(error_result.is_err(), \"Expected an error due to insufficient funds\");\n let error_message = error_result.unwrap_err().to_string();\n assert!(\n error_message.contains(\"Insufficient funds for gas * price + value\"),\n \"Error message did not match expected: {error_message}\"\n );\n\n // Setup state override to simulate sufficient funds for the recipient.\n let addr = recipient;\n let account_override =\n AccountOverride { balance: Some(alloy_primitives::U256::from(1e18)), ..Default::default() };\n let mut state_override = StateOverride::default();\n state_override.insert(addr, account_override);\n\n // Estimate gas with state override implying sufficient funds.\n let gas_estimate = api\n .estimate_gas(WithOtherFields::new(tx), None, EvmOverrides::new(Some(state_override), None))\n .await\n .expect(\"Failed to estimate gas with state override\");\n\n // Assert the gas estimate meets the expected minimum.\n assert!(gas_estimate >= U256::from(21000), \"Gas estimate is lower than expected minimum\");\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_block_override() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n\n let wallet = handle.dev_wallets().next().unwrap();\n let sender = wallet.address();\n let recipient = Address::random();\n\n let tx = TransactionRequest::default()\n .from(sender)\n .to(recipient)\n .input(Bytes::from(hex!(\"42cbb15c\").to_vec()).into());\n\n // function getBlockNumber() external view returns (uint256) {\n // return block.number;\n // }\n let code = hex!(\n \"6080604052348015600e575f5ffd5b50600436106026575f3560e01c806342cbb15c14602a575b5f5ffd5b60306044565b604051603b91906061565b60405180910390f35b5f43905090565b5f819050919050565b605b81604b565b82525050565b5f60208201905060725f8301846054565b9291505056fea26469706673582212207741266d8151c5e7d1a96fc1697f8fc94e60e730b3f2861d398339c74a2180d464736f6c634300081e0033\"\n );\n\n let account_override =\n AccountOverride { balance: Some(U256::from(1e18)), ..Default::default() };\n let state_override = StateOverridesBuilder::default()\n .append(sender, account_override)\n .append(recipient, AccountOverride::default().with_code(code.to_vec()))\n .build();\n\n let block_override = BlockOverrides { number: Some(U256::from(99)), ..Default::default() };\n\n let output = api\n .call(\n WithOtherFields::new(tx),\n None,\n EvmOverrides::new(Some(state_override), Some(Box::new(block_override))),\n )\n .await\n .expect(\"Failed to estimate gas with state override\");\n\n assert_eq!(output, U256::from(99).abi_encode());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_reject_gas_too_low() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let account = handle.dev_accounts().next().unwrap();\n\n let gas = 21_000u64 - 1;\n let tx = TransactionRequest::default()\n .to(Address::random())\n .value(U256::from(1337u64))\n .from(account)\n .with_gas_limit(gas);\n let tx = WithOtherFields::new(tx);\n\n let resp = provider.send_transaction(tx).await;\n\n let err = resp.unwrap_err().to_string();\n assert!(err.contains(\"intrinsic gas too low\"));\n}\n\n// \n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_call_with_high_gas_limit() {\n let (_api, handle) = spawn(NodeConfig::test().with_gas_limit(Some(100_000_000))).await;\n let provider = handle.http_provider();\n\n let greeter_contract = Greeter::deploy(provider, \"Hello World!\".to_string()).await.unwrap();\n\n let greeting = greeter_contract.greet().gas(60_000_000).call().await.unwrap();\n assert_eq!(\"Hello World!\", greeting);\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn test_reject_eip1559_pre_london() {\n let (api, handle) =\n spawn(NodeConfig::test().with_hardfork(Some(EthereumHardfork::Berlin.into()))).await;\n let provider = handle.http_provider();\n\n let gas_limit = api.gas_limit().to::();\n let gas_price = api.gas_price();\n\n let unsupported_call_builder =\n Greeter::deploy_builder(provider.clone(), \"Hello World!\".to_string());\n let unsupported_calldata = unsupported_call_builder.calldata();\n\n let unsup_tx = TransactionRequest::default()\n .from(handle.dev_accounts().next().unwrap())\n .with_input(unsupported_calldata.to_owned())\n .with_gas_limit(gas_limit)\n .with_max_fee_per_gas(gas_price)\n .with_max_priority_fee_per_gas(gas_price);\n\n let unsup_tx = WithOtherFields::new(unsup_tx);\n\n let unsupported = provider.send_transaction(unsup_tx).await.unwrap_err().to_string();\n assert!(unsupported.contains(\"not supported by the current hardfork\"), \"{unsupported}\");\n\n let greeter_contract_addr =\n Greeter::deploy_builder(provider.clone(), \"Hello World!\".to_string())\n .gas(gas_limit)\n .gas_price(gas_price)\n .deploy()\n .await\n .unwrap();\n\n let greeter_contract = Greeter::new(greeter_contract_addr, provider);\n\n let greeting = greeter_contract.greet().call().await.unwrap();\n assert_eq!(\"Hello World!\", greeting);\n}\n\n// https://github.com/foundry-rs/foundry/issues/6931\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_mine_multiple_in_block() {\n let (api, _handle) = spawn(NodeConfig::test()).await;\n\n // disable auto mine\n api.anvil_set_auto_mine(false).await.unwrap();\n\n let tx = TransactionRequest {\n from: Some(\"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\".parse().unwrap()),\n ..Default::default()\n };\n\n // broadcast it via the eth_sendTransaction API\n let first = api.send_transaction(WithOtherFields::new(tx.clone())).await.unwrap();\n let second = api.send_transaction(WithOtherFields::new(tx.clone())).await.unwrap();\n\n api.anvil_mine(Some(U256::from(1)), Some(U256::ZERO)).await.unwrap();\n\n let block = api.block_by_number(BlockNumberOrTag::Latest).await.unwrap().unwrap();\n\n let txs = block.transactions.hashes().collect::>();\n assert_eq!(txs, vec![first, second]);\n}\n\n// ensures that the gas estimate is running on pending block by default\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_estimate_gas_prague() {\n let (api, _handle) =\n spawn(NodeConfig::test().with_hardfork(Some(EthereumHardfork::Prague.into()))).await;\n\n // {\"data\":\"0xcafebabe\",\"from\":\"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\",\"to\":\"\n // 0x70997970c51812dc3a010c7d01b50e0d17dc79c8\"}\n let req = TransactionRequest::default()\n .with_input(hex!(\"0xcafebabe\"))\n .with_from(address!(\"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\"))\n .with_to(address!(\"0x70997970c51812dc3a010c7d01b50e0d17dc79c8\"));\n api.estimate_gas(WithOtherFields::new(req), None, EvmOverrides::default()).await.unwrap();\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_send_tx_osaka_valid_with_limit_enabled() {\n let (_api, handle) = spawn(\n NodeConfig::test()\n .enable_tx_gas_limit(true)\n .with_hardfork(Some(EthereumHardfork::Osaka.into())),\n )\n .await;\n let provider = handle.http_provider();\n let wallet = handle.dev_wallets().next().unwrap();\n let sender = wallet.address();\n let recipient = Address::random();\n\n let base_tx = TransactionRequest::default().from(sender).to(recipient).value(U256::from(1e18));\n\n // gas limit below the cap is accepted\n let tx = base_tx.clone().gas_limit(TX_GAS_LIMIT_CAP - 1);\n let tx = WithOtherFields::new(tx);\n let pending_tx = provider.send_transaction(tx).await.unwrap();\n let tx_receipt = pending_tx.get_receipt().await.unwrap();\n assert!(tx_receipt.inner.inner.is_success());\n\n // gas limit at the cap is accepted\n let tx = base_tx.clone().gas_limit(TX_GAS_LIMIT_CAP);\n let tx = WithOtherFields::new(tx);\n let pending_tx = provider.send_transaction(tx).await.unwrap();\n let tx_receipt = pending_tx.get_receipt().await.unwrap();\n assert!(tx_receipt.inner.inner.is_success());\n\n // gas limit above the cap is rejected\n let tx = base_tx.clone().gas_limit(TX_GAS_LIMIT_CAP + 1);\n let tx = WithOtherFields::new(tx);\n let err = provider.send_transaction(tx).await.unwrap_err().to_string();\n assert!(\n err.contains(\"intrinsic gas too high -- tx.gas_limit > env.cfg.tx_gas_limit_cap\"),\n \"{err}\"\n );\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_send_tx_osaka_valid_with_limit_disabled() {\n let (_api, handle) =\n spawn(NodeConfig::test().with_hardfork(Some(EthereumHardfork::Osaka.into()))).await;\n let provider = handle.http_provider();\n let wallet = handle.dev_wallets().next().unwrap();\n let sender = wallet.address();\n let recipient = Address::random();\n\n let base_tx = TransactionRequest::default().from(sender).to(recipient).value(U256::from(1e18));\n\n // gas limit below the cap is accepted\n let tx = base_tx.clone().gas_limit(TX_GAS_LIMIT_CAP - 1);\n let tx = WithOtherFields::new(tx);\n let pending_tx = provider.send_transaction(tx).await.unwrap();\n let tx_receipt = pending_tx.get_receipt().await.unwrap();\n assert!(tx_receipt.inner.inner.is_success());\n\n // gas limit at the cap is accepted\n let tx = base_tx.clone().gas_limit(TX_GAS_LIMIT_CAP);\n let tx = WithOtherFields::new(tx);\n let pending_tx = provider.send_transaction(tx).await.unwrap();\n let tx_receipt = pending_tx.get_receipt().await.unwrap();\n assert!(tx_receipt.inner.inner.is_success());\n\n // gas limit above the cap is accepted when the limit is disabled\n let tx = base_tx.clone().gas_limit(TX_GAS_LIMIT_CAP + 1);\n let tx = WithOtherFields::new(tx);\n let pending_tx = provider.send_transaction(tx).await.unwrap();\n let tx_receipt = pending_tx.get_receipt().await.unwrap();\n assert!(tx_receipt.inner.inner.is_success());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_get_tx_by_sender_and_nonce() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n let accounts = handle.dev_wallets().collect::>();\n let sender = accounts[0].address();\n let recipient = accounts[1].address();\n\n api.anvil_set_auto_mine(false).await.unwrap();\n\n let mut tx_hashes = std::collections::BTreeMap::new();\n\n // send 4 transactions from the same sender with consecutive nonces\n for i in 0..4 {\n let tx_request = TransactionRequest::default()\n .to(recipient)\n .value(U256::from(1000 + i))\n .from(sender)\n .nonce(i as u64);\n\n let tx = WithOtherFields::new(tx_request);\n let pending_tx = provider.send_transaction(tx).await.unwrap();\n tx_hashes.insert(i as u64, *pending_tx.tx_hash());\n }\n\n // mine all transactions\n api.mine_one().await;\n\n for nonce in 0..4 {\n let result: Option = provider\n .client()\n .request(\"eth_getTransactionBySenderAndNonce\", (sender, U256::from(nonce)))\n .await\n .unwrap();\n\n assert!(result.is_some());\n let found_tx = result.unwrap();\n\n assert_eq!(found_tx.inner.nonce(), nonce);\n assert_eq!(found_tx.from(), sender);\n assert_eq!(found_tx.inner.to(), Some(recipient));\n assert_eq!(found_tx.inner.value(), U256::from(1000 + nonce));\n assert_eq!(found_tx.inner.tx_hash(), tx_hashes[&nonce]);\n }\n\n let result: Option = provider\n .client()\n .request(\"eth_getTransactionBySenderAndNonce\", (sender, U256::from(999)))\n .await\n .unwrap();\n assert!(result.is_none());\n\n let different_sender = accounts[2].address();\n let result: Option = provider\n .client()\n .request(\"eth_getTransactionBySenderAndNonce\", (different_sender, U256::from(0)))\n .await\n .unwrap();\n assert!(result.is_none());\n\n // send a pending transaction with explicit nonce 4\n let pending_tx_request =\n TransactionRequest::default().to(recipient).value(U256::from(5000)).from(sender).nonce(4);\n\n let tx = WithOtherFields::new(pending_tx_request);\n let pending_tx = provider.send_transaction(tx).await.unwrap();\n\n // find the pending transaction with nonce 4\n let result: Option = provider\n .client()\n .request(\"eth_getTransactionBySenderAndNonce\", (sender, U256::from(4)))\n .await\n .unwrap();\n\n assert!(result.is_some());\n let found_tx = result.unwrap();\n assert_eq!(found_tx.inner.nonce(), 4);\n assert_eq!(found_tx.inner.tx_hash(), *pending_tx.tx_hash());\n\n api.mine_one().await;\n\n let result: Option = provider\n .client()\n .request(\"eth_getTransactionBySenderAndNonce\", (sender, U256::from(4)))\n .await\n .unwrap();\n\n assert!(result.is_some());\n let found_tx = result.unwrap();\n assert_eq!(found_tx.inner.nonce(), 4);\n}\n" }, { "path": "crates/anvil/tests/it/txpool.rs", "content": "//! txpool related tests\n\nuse alloy_network::{ReceiptResponse, TransactionBuilder};\nuse alloy_primitives::U256;\nuse alloy_provider::{Provider, ext::TxPoolApi};\nuse alloy_rpc_types::TransactionRequest;\nuse alloy_serde::WithOtherFields;\nuse anvil::{NodeConfig, spawn};\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn geth_txpool() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.http_provider();\n\n api.anvil_set_auto_mine(false).await.unwrap();\n\n let account = provider.get_accounts().await.unwrap().remove(0);\n let value = U256::from(42);\n let gas_price = 221435145689u128;\n\n let tx = TransactionRequest::default()\n .with_to(account)\n .with_from(account)\n .with_value(value)\n .with_gas_price(gas_price);\n let tx = WithOtherFields::new(tx);\n\n // send a few transactions\n for _ in 0..10 {\n let _ = provider.send_transaction(tx.clone()).await.unwrap();\n }\n\n // we gave a 20s block time, should be plenty for us to get the txpool's content\n let status = provider.txpool_status().await.unwrap();\n assert_eq!(status.pending, 10);\n assert_eq!(status.queued, 0);\n\n let inspect = provider.txpool_inspect().await.unwrap();\n assert!(inspect.queued.is_empty());\n let summary = inspect.pending.get(&account).unwrap();\n for i in 0..10 {\n let tx_summary = summary.get(&i.to_string()).unwrap();\n assert_eq!(tx_summary.gas_price, gas_price);\n assert_eq!(tx_summary.value, value);\n assert_eq!(tx_summary.gas, 21000);\n assert_eq!(tx_summary.to.unwrap(), account);\n }\n\n let content = provider.txpool_content().await.unwrap();\n assert!(content.queued.is_empty());\n let content = content.pending.get(&account).unwrap();\n\n for nonce in 0..10 {\n assert!(content.contains_key(&nonce.to_string()));\n }\n}\n\n// Cf. https://github.com/foundry-rs/foundry/issues/11239\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn accepts_spend_after_funding_when_pool_checks_disabled() {\n // Spawn with pool balance checks disabled\n let (api, handle) = spawn(NodeConfig::test().with_disable_pool_balance_checks(true)).await;\n let provider = handle.http_provider();\n\n // Work with pending pool (no automine)\n api.anvil_set_auto_mine(false).await.unwrap();\n\n // Funder is a dev account controlled by the node\n let funder = provider.get_accounts().await.unwrap().remove(0);\n\n // Recipient/spender is a random address with zero balance that we'll impersonate\n let spender = alloy_primitives::Address::random();\n api.anvil_set_balance(spender, U256::from(0u64)).await.unwrap();\n api.anvil_impersonate_account(spender).await.unwrap();\n\n // Ensure tx1 (funding) has higher gas price so it's mined before tx2 within the same block\n let gas_price_fund = 2_000_000_000_000u128; // 2_000 gwei\n let gas_price_spend = 1_000_000_000u128; // 1 gwei\n\n let fund_value = U256::from(1_000_000_000_000_000_000u128); // 1 ether\n\n // tx1: fund spender from funder\n let tx1 = TransactionRequest::default()\n .with_from(funder)\n .with_to(spender)\n .with_value(fund_value)\n .with_gas_price(gas_price_fund);\n let tx1 = WithOtherFields::new(tx1);\n\n // tx2: spender attempts to send value greater than their pre-funding balance (0),\n // which would normally be rejected by pool balance checks, but should be accepted when disabled\n let spend_value = fund_value - U256::from(21_000u64) * U256::from(gas_price_spend);\n let tx2 = TransactionRequest::default()\n .with_from(spender)\n .with_to(funder)\n .with_value(spend_value)\n .with_gas_price(gas_price_spend);\n let tx2 = WithOtherFields::new(tx2);\n\n // Publish both transactions (funding first, then spend-before-funding-is-mined)\n let sent1 = provider.send_transaction(tx1).await.unwrap();\n let sent2 = provider.send_transaction(tx2).await.unwrap();\n\n // Both should be accepted into the pool (pending)\n let status = provider.txpool_status().await.unwrap();\n assert_eq!(status.pending, 2);\n assert_eq!(status.queued, 0);\n\n // Mine a block and ensure both succeed\n api.evm_mine(None).await.unwrap();\n\n let receipt1 = sent1.get_receipt().await.unwrap();\n let receipt2 = sent2.get_receipt().await.unwrap();\n assert!(receipt1.status());\n assert!(receipt2.status());\n}\n" }, { "path": "crates/anvil/tests/it/utils.rs", "content": "use alloy_network::{Ethereum, EthereumWallet};\nuse alloy_provider::{\n Identity, RootProvider,\n fillers::{ChainIdFiller, FillProvider, GasFiller, JoinFill, NonceFiller, WalletFiller},\n};\nuse foundry_common::provider::{\n ProviderBuilder, RetryProvider, RetryProviderWithSigner, get_http_provider,\n};\n\npub fn http_provider(http_endpoint: &str) -> RetryProvider {\n get_http_provider(http_endpoint)\n}\n\npub fn http_provider_with_signer(\n http_endpoint: &str,\n signer: EthereumWallet,\n) -> RetryProviderWithSigner {\n ProviderBuilder::new(http_endpoint)\n .build_with_wallet(signer)\n .expect(\"failed to build Alloy HTTP provider with signer\")\n}\n\npub fn ws_provider_with_signer(\n ws_endpoint: &str,\n signer: EthereumWallet,\n) -> RetryProviderWithSigner {\n ProviderBuilder::new(ws_endpoint)\n .build_with_wallet(signer)\n .expect(\"failed to build Alloy WS provider with signer\")\n}\n\n/// Currently required to get around \npub async fn connect_pubsub(conn_str: &str) -> RootProvider {\n alloy_provider::ProviderBuilder::default().connect(conn_str).await.unwrap()\n}\n\ntype PubsubSigner = FillProvider<\n JoinFill<\n JoinFill<\n Identity,\n JoinFill<\n GasFiller,\n JoinFill<\n alloy_provider::fillers::BlobGasFiller,\n JoinFill,\n >,\n >,\n >,\n WalletFiller,\n >,\n RootProvider,\n Ethereum,\n>;\n\npub async fn connect_pubsub_with_wallet(conn_str: &str, wallet: EthereumWallet) -> PubsubSigner {\n alloy_provider::ProviderBuilder::new().wallet(wallet).connect(conn_str).await.unwrap()\n}\n\npub async fn ipc_provider_with_wallet(\n ipc_endpoint: &str,\n wallet: EthereumWallet,\n) -> RetryProviderWithSigner {\n ProviderBuilder::new(ipc_endpoint)\n .build_with_wallet(wallet)\n .expect(\"failed to build Alloy IPC provider with signer\")\n}\n" }, { "path": "crates/anvil/tests/it/wsapi.rs", "content": "//! general eth api tests with websocket provider\n\nuse alloy_primitives::U256;\nuse alloy_provider::Provider;\nuse anvil::{NodeConfig, spawn};\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_get_block_number_ws() {\n let (api, handle) = spawn(NodeConfig::test()).await;\n let block_num = api.block_number().unwrap();\n assert_eq!(block_num, U256::ZERO);\n\n let provider = handle.ws_provider();\n\n let num = provider.get_block_number().await.unwrap();\n assert_eq!(num, block_num.to::());\n}\n\n#[tokio::test(flavor = \"multi_thread\")]\nasync fn can_dev_get_balance_ws() {\n let (_api, handle) = spawn(NodeConfig::test()).await;\n let provider = handle.ws_provider();\n\n let genesis_balance = handle.genesis_balance();\n for acc in handle.genesis_accounts() {\n let balance = provider.get_balance(acc).await.unwrap();\n assert_eq!(balance, genesis_balance);\n }\n}\n" }, { "path": "crates/cast/Cargo.toml", "content": "[package]\nname = \"cast\"\ndescription = \"Command-line tool for performing Ethereum RPC calls\"\n\nversion.workspace = true\nedition.workspace = true\nrust-version.workspace = true\nauthors.workspace = true\nlicense.workspace = true\nhomepage.workspace = true\nrepository.workspace = true\n\n[lints]\nworkspace = true\n\n[lib]\nname = \"cast\"\n\n[[bin]]\nname = \"cast\"\npath = \"bin/main.rs\"\n\n[dependencies]\n# lib\nfoundry-block-explorers.workspace = true\nfoundry-common.workspace = true\nfoundry-compilers.workspace = true\nfoundry-config.workspace = true\nfoundry-debugger.workspace = true\nfoundry-evm.workspace = true\nfoundry-wallets.workspace = true\nforge-fmt.workspace = true\nfoundry-primitives.workspace = true\n\nalloy-chains.workspace = true\nalloy-consensus = { workspace = true, features = [\"serde\", \"kzg\"] }\nalloy-contract.workspace = true\nalloy-dyn-abi.workspace = true\nalloy-json-abi.workspace = true\nalloy-json-rpc.workspace = true\nalloy-network.workspace = true\nalloy-primitives.workspace = true\nalloy-provider = { workspace = true, features = [\n \"reqwest\",\n \"ws\",\n \"ipc\",\n \"trace-api\",\n \"txpool-api\",\n] }\nalloy-rlp.workspace = true\nalloy-rpc-types = { workspace = true, features = [\"eth\", \"trace\"] }\nalloy-rpc-types-beacon.workspace = true\nalloy-signer-local = { workspace = true, features = [\"mnemonic\", \"keystore\"] }\nalloy-signer.workspace = true\nalloy-sol-types.workspace = true\nalloy-transport.workspace = true\nalloy-ens = { workspace = true, features = [\"provider\"] }\nalloy-eips.workspace = true\ntempo-alloy.workspace = true\nalloy-evm.workspace = true\n\nop-alloy-flz.workspace = true\nop-alloy-network.workspace = true\n\nchrono.workspace = true\neyre.workspace = true\nfutures.workspace = true\nrevm = { workspace = true, features = [\"optional_balance_check\"] }\nrand.workspace = true\nrand_08.workspace = true\nrayon.workspace = true\nserde_json.workspace = true\nserde.workspace = true\n\n# bin\nfoundry-cli.workspace = true\n\nclap = { version = \"4\", features = [\"derive\", \"env\", \"unicode\", \"wrap_help\"] }\nclap_complete.workspace = true\ncomfy-table.workspace = true\ndunce.workspace = true\nitertools.workspace = true\nregex = { workspace = true, default-features = false }\nrpassword = \"7\"\nsemver.workspace = true\ntempfile.workspace = true\ntokio = { workspace = true, features = [\"macros\", \"signal\"] }\ntracing.workspace = true\nyansi.workspace = true\nevmole.workspace = true\n\n[dev-dependencies]\nalloy-hardforks.workspace = true\nalloy-serde.workspace = true\ndirs.workspace = true\nanvil.workspace = true\nfoundry-test-utils.workspace = true\n\n[features]\ndefault = [\"jemalloc\"]\nasm-keccak = [\"alloy-primitives/asm-keccak\"]\njemalloc = [\"foundry-cli/jemalloc\"]\nmimalloc = [\"foundry-cli/mimalloc\"]\ntracy-allocator = [\"foundry-cli/tracy-allocator\"]\naws-kms = [\"foundry-wallets/aws-kms\"]\ngcp-kms = [\"foundry-wallets/gcp-kms\"]\nturnkey = [\"foundry-wallets/turnkey\"]\nisolate-by-default = [\"foundry-config/isolate-by-default\"]\n" }, { "path": "crates/cast/bin/main.rs", "content": "//! The `cast` CLI: a Swiss Army knife for interacting with EVM smart contracts, sending\n//! transactions and getting chain data.\n\nuse cast::args::run;\n\n#[global_allocator]\nstatic ALLOC: foundry_cli::utils::Allocator = foundry_cli::utils::new_allocator();\n\nfn main() {\n if let Err(err) = run() {\n let _ = foundry_common::sh_err!(\"{err:?}\");\n std::process::exit(1);\n }\n}\n" }, { "path": "crates/cast/src/args.rs", "content": "use crate::{\n Cast, SimpleCast,\n cmd::erc20::IERC20,\n opts::{Cast as CastArgs, CastSubcommand, ToBaseArgs},\n traces::identifier::SignaturesIdentifier,\n tx::CastTxSender,\n};\nuse alloy_consensus::transaction::Recovered;\nuse alloy_dyn_abi::{DynSolValue, ErrorExt, EventExt};\nuse alloy_eips::eip7702::SignedAuthorization;\nuse alloy_ens::{ProviderEnsExt, namehash};\nuse alloy_network::Ethereum;\nuse alloy_primitives::{Address, B256, eip191_hash_message, hex, keccak256};\nuse alloy_provider::Provider;\nuse alloy_rpc_types::{BlockId, BlockNumberOrTag::Latest};\nuse clap::{CommandFactory, Parser};\nuse clap_complete::generate;\nuse eyre::Result;\nuse foundry_cli::{\n opts::NetworkVariant,\n utils::{self, LoadConfig},\n};\nuse foundry_common::{\n abi::{get_error, get_event},\n fmt::{format_tokens, format_uint_exp, serialize_value_as_json},\n fs,\n provider::ProviderBuilder,\n selectors::{\n ParsedSignatures, SelectorImportData, SelectorKind, decode_calldata, decode_event_topic,\n decode_function_selector, decode_selectors, import_selectors, parse_signatures,\n pretty_calldata,\n },\n shell, stdin,\n};\nuse op_alloy_network::Optimism;\nuse std::time::Instant;\nuse tempo_alloy::TempoNetwork;\n\n/// Run the `cast` command-line interface.\npub fn run() -> Result<()> {\n setup()?;\n\n foundry_cli::opts::GlobalArgs::check_markdown_help::();\n\n let args = CastArgs::parse();\n args.global.init()?;\n args.global.tokio_runtime().block_on(run_command(args))\n}\n\n/// Setup the global logger and other utilities.\npub fn setup() -> Result<()> {\n utils::common_setup();\n utils::subscriber();\n\n Ok(())\n}\n\n/// Run the subcommand.\npub async fn run_command(args: CastArgs) -> Result<()> {\n match args.cmd {\n // Constants\n CastSubcommand::MaxInt { r#type } => {\n sh_println!(\"{}\", SimpleCast::max_int(&r#type)?)?;\n }\n CastSubcommand::MinInt { r#type } => {\n sh_println!(\"{}\", SimpleCast::min_int(&r#type)?)?;\n }\n CastSubcommand::MaxUint { r#type } => {\n sh_println!(\"{}\", SimpleCast::max_int(&r#type)?)?;\n }\n CastSubcommand::AddressZero => {\n sh_println!(\"{:?}\", Address::ZERO)?;\n }\n CastSubcommand::HashZero => {\n sh_println!(\"{:?}\", B256::ZERO)?;\n }\n\n // Conversions & transformations\n CastSubcommand::FromUtf8 { text } => {\n let value = stdin::unwrap(text, false)?;\n sh_println!(\"{}\", SimpleCast::from_utf8(&value))?\n }\n CastSubcommand::ToAscii { hexdata } => {\n let value = stdin::unwrap(hexdata, false)?;\n sh_println!(\"{}\", SimpleCast::to_ascii(value.trim())?)?\n }\n CastSubcommand::ToUtf8 { hexdata } => {\n let value = stdin::unwrap(hexdata, false)?;\n sh_println!(\"{}\", SimpleCast::to_utf8(&value)?)?\n }\n CastSubcommand::FromFixedPoint { value, decimals } => {\n let (value, decimals) = stdin::unwrap2(value, decimals)?;\n sh_println!(\"{}\", SimpleCast::from_fixed_point(&value, &decimals)?)?\n }\n CastSubcommand::ToFixedPoint { value, decimals } => {\n let (value, decimals) = stdin::unwrap2(value, decimals)?;\n sh_println!(\"{}\", SimpleCast::to_fixed_point(&value, &decimals)?)?\n }\n CastSubcommand::ConcatHex { data } => {\n if data.is_empty() {\n let s = stdin::read(true)?;\n sh_println!(\"{}\", SimpleCast::concat_hex(s.split_whitespace()))?\n } else {\n sh_println!(\"{}\", SimpleCast::concat_hex(data))?\n }\n }\n CastSubcommand::FromBin => {\n let hex = stdin::read_bytes(false)?;\n sh_println!(\"{}\", hex::encode_prefixed(hex))?\n }\n CastSubcommand::ToHexdata { input } => {\n let value = stdin::unwrap_line(input)?;\n let output = match value {\n s if s.starts_with('@') => hex::encode(std::env::var(&s[1..])?),\n s if s.starts_with('/') => hex::encode(fs::read(s)?),\n s => s.split(':').map(|s| s.trim_start_matches(\"0x\").to_lowercase()).collect(),\n };\n sh_println!(\"0x{output}\")?\n }\n CastSubcommand::ToCheckSumAddress { address, chain_id } => {\n let value = stdin::unwrap_line(address)?;\n sh_println!(\"{}\", value.to_checksum(chain_id))?\n }\n CastSubcommand::ToUint256 { value } => {\n let value = stdin::unwrap_line(value)?;\n sh_println!(\"{}\", SimpleCast::to_uint256(&value)?)?\n }\n CastSubcommand::ToInt256 { value } => {\n let value = stdin::unwrap_line(value)?;\n sh_println!(\"{}\", SimpleCast::to_int256(&value)?)?\n }\n CastSubcommand::ToUnit { value, unit } => {\n let value = stdin::unwrap_line(value)?;\n sh_println!(\"{}\", SimpleCast::to_unit(&value, &unit)?)?\n }\n CastSubcommand::ParseUnits { value, unit } => {\n let value = stdin::unwrap_line(value)?;\n sh_println!(\"{}\", SimpleCast::parse_units(&value, unit)?)?;\n }\n CastSubcommand::FormatUnits { value, unit } => {\n let value = stdin::unwrap_line(value)?;\n sh_println!(\"{}\", SimpleCast::format_units(&value, unit)?)?;\n }\n CastSubcommand::FromWei { value, unit } => {\n let value = stdin::unwrap_line(value)?;\n sh_println!(\"{}\", SimpleCast::from_wei(&value, &unit)?)?\n }\n CastSubcommand::ToWei { value, unit } => {\n let value = stdin::unwrap_line(value)?;\n sh_println!(\"{}\", SimpleCast::to_wei(&value, &unit)?)?\n }\n CastSubcommand::FromRlp { value, as_int } => {\n let value = stdin::unwrap_line(value)?;\n sh_println!(\"{}\", SimpleCast::from_rlp(value, as_int)?)?\n }\n CastSubcommand::ToRlp { value } => {\n let value = stdin::unwrap_line(value)?;\n sh_println!(\"{}\", SimpleCast::to_rlp(&value)?)?\n }\n CastSubcommand::ToHex(ToBaseArgs { value, base_in }) => {\n let value = stdin::unwrap_line(value)?;\n sh_println!(\"{}\", SimpleCast::to_base(&value, base_in.as_deref(), \"hex\")?)?\n }\n CastSubcommand::ToDec(ToBaseArgs { value, base_in }) => {\n let value = stdin::unwrap_line(value)?;\n sh_println!(\"{}\", SimpleCast::to_base(&value, base_in.as_deref(), \"dec\")?)?\n }\n CastSubcommand::ToBase { base: ToBaseArgs { value, base_in }, base_out } => {\n let (value, base_out) = stdin::unwrap2(value, base_out)?;\n sh_println!(\"{}\", SimpleCast::to_base(&value, base_in.as_deref(), &base_out)?)?\n }\n CastSubcommand::ToBytes32 { bytes } => {\n let value = stdin::unwrap_line(bytes)?;\n sh_println!(\"{}\", SimpleCast::to_bytes32(&value)?)?\n }\n CastSubcommand::Pad { data, right, left: _, len } => {\n let value = stdin::unwrap_line(data)?;\n sh_println!(\"{}\", SimpleCast::pad(&value, right, len)?)?\n }\n CastSubcommand::FormatBytes32String { string } => {\n let value = stdin::unwrap_line(string)?;\n sh_println!(\"{}\", SimpleCast::format_bytes32_string(&value)?)?\n }\n CastSubcommand::ParseBytes32String { bytes } => {\n let value = stdin::unwrap_line(bytes)?;\n sh_println!(\"{}\", SimpleCast::parse_bytes32_string(&value)?)?\n }\n CastSubcommand::ParseBytes32Address { bytes } => {\n let value = stdin::unwrap_line(bytes)?;\n sh_println!(\"{}\", SimpleCast::parse_bytes32_address(&value)?)?\n }\n\n // ABI encoding & decoding\n CastSubcommand::DecodeAbi { sig, calldata, input } => {\n let tokens = SimpleCast::abi_decode(&sig, &calldata, input)?;\n print_tokens(&tokens);\n }\n CastSubcommand::AbiEncode { sig, packed, args } => {\n if !packed {\n sh_println!(\"{}\", SimpleCast::abi_encode(&sig, &args)?)?\n } else {\n sh_println!(\"{}\", SimpleCast::abi_encode_packed(&sig, &args)?)?\n }\n }\n CastSubcommand::AbiEncodeEvent { sig, args } => {\n let log_data = SimpleCast::abi_encode_event(&sig, &args)?;\n for (i, topic) in log_data.topics().iter().enumerate() {\n sh_println!(\"[topic{}]: {}\", i, topic)?;\n }\n if !log_data.data.is_empty() {\n sh_println!(\"[data]: {}\", hex::encode_prefixed(log_data.data))?;\n }\n }\n CastSubcommand::DecodeCalldata { sig, calldata, file } => {\n let raw_hex = if let Some(file_path) = file {\n let contents = fs::read_to_string(&file_path)?;\n contents.trim().to_string()\n } else {\n calldata.unwrap()\n };\n\n let tokens = SimpleCast::calldata_decode(&sig, &raw_hex, true)?;\n print_tokens(&tokens);\n }\n CastSubcommand::CalldataEncode { sig, args, file } => {\n let final_args = if let Some(file_path) = file {\n let contents = fs::read_to_string(file_path)?;\n contents\n .lines()\n .map(str::trim)\n .filter(|line| !line.is_empty())\n .map(String::from)\n .collect()\n } else {\n args\n };\n sh_println!(\"{}\", SimpleCast::calldata_encode(sig, &final_args)?)?;\n }\n CastSubcommand::DecodeString { data } => {\n let tokens = SimpleCast::calldata_decode(\"Any(string)\", &data, true)?;\n print_tokens(&tokens);\n }\n CastSubcommand::DecodeEvent { sig, data } => {\n let decoded_event = if let Some(event_sig) = sig {\n let event = get_event(event_sig.as_str())?;\n event.decode_log_parts(core::iter::once(event.selector()), &hex::decode(data)?)?\n } else {\n let data = crate::strip_0x(&data);\n let selector = data.get(..64).unwrap_or_default();\n let selector = selector.parse()?;\n let identified_event =\n SignaturesIdentifier::new(false)?.identify_event(selector).await;\n if let Some(event) = identified_event {\n let _ = sh_println!(\"{}\", event.signature());\n let data = data.get(64..).unwrap_or_default();\n get_event(event.signature().as_str())?\n .decode_log_parts(core::iter::once(selector), &hex::decode(data)?)?\n } else {\n eyre::bail!(\"No matching event signature found for selector `{selector}`\")\n }\n };\n print_tokens(&decoded_event.body);\n }\n CastSubcommand::DecodeError { sig, data } => {\n let error = if let Some(err_sig) = sig {\n get_error(err_sig.as_str())?\n } else {\n let data = crate::strip_0x(&data);\n let selector = data.get(..8).unwrap_or_default();\n let identified_error =\n SignaturesIdentifier::new(false)?.identify_error(selector.parse()?).await;\n if let Some(error) = identified_error {\n let _ = sh_println!(\"{}\", error.signature());\n error\n } else {\n eyre::bail!(\"No matching error signature found for selector `{selector}`\")\n }\n };\n let decoded_error = error.decode_error(&hex::decode(data)?)?;\n print_tokens(&decoded_error.body);\n }\n CastSubcommand::Interface(cmd) => cmd.run().await?,\n CastSubcommand::CreationCode(cmd) => cmd.run().await?,\n CastSubcommand::ConstructorArgs(cmd) => cmd.run().await?,\n CastSubcommand::Artifact(cmd) => cmd.run().await?,\n CastSubcommand::Bind(cmd) => cmd.run().await?,\n CastSubcommand::B2EPayload(cmd) => cmd.run().await?,\n CastSubcommand::PrettyCalldata { calldata, offline } => {\n let calldata = stdin::unwrap_line(calldata)?;\n sh_println!(\"{}\", pretty_calldata(&calldata, offline).await?)?;\n }\n CastSubcommand::Sig { sig, optimize } => {\n let sig = stdin::unwrap_line(sig)?;\n match optimize {\n Some(opt) => {\n sh_println!(\"Starting to optimize signature...\")?;\n let start_time = Instant::now();\n let (selector, signature) = SimpleCast::get_selector(&sig, opt)?;\n sh_println!(\"Successfully generated in {:?}\", start_time.elapsed())?;\n sh_println!(\"Selector: {selector}\")?;\n sh_println!(\"Optimized signature: {signature}\")?;\n }\n None => sh_println!(\"{}\", SimpleCast::get_selector(&sig, 0)?.0)?,\n }\n }\n\n // Blockchain & RPC queries\n CastSubcommand::AccessList(cmd) => cmd.run().await?,\n CastSubcommand::Age { block, rpc } => {\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n sh_println!(\n \"{} UTC\",\n Cast::new(provider).age(block.unwrap_or(BlockId::Number(Latest))).await?\n )?\n }\n CastSubcommand::Balance { block, who, ether, rpc, erc20 } => {\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n let account_addr = who.resolve(&provider).await?;\n\n match erc20 {\n Some(token) => {\n let balance = IERC20::new(token, &provider)\n .balanceOf(account_addr)\n .block(block.unwrap_or_default())\n .call()\n .await?;\n\n sh_warn!(\"--erc20 flag is deprecated, use `cast erc20 balance` instead\")?;\n sh_println!(\"{}\", format_uint_exp(balance))?\n }\n None => {\n let value = Cast::new(&provider).balance(account_addr, block).await?;\n if ether {\n sh_println!(\"{}\", SimpleCast::from_wei(&value.to_string(), \"eth\")?)?\n } else {\n sh_println!(\"{value}\")?\n }\n }\n }\n }\n CastSubcommand::BaseFee { block, rpc } => {\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n sh_println!(\n \"{}\",\n Cast::new(provider).base_fee(block.unwrap_or(BlockId::Number(Latest))).await?\n )?\n }\n CastSubcommand::Block { block, full, fields, raw, rpc, network } => {\n let config = rpc.load_config()?;\n // Can use either --raw or specify raw as a field\n let output = if raw || fields.contains(&\"raw\".into()) {\n match network {\n Some(NetworkVariant::Optimism) => {\n let provider =\n ProviderBuilder::::from_config(&config)?.build()?;\n\n Cast::new(&provider)\n .block_raw(block.unwrap_or(BlockId::Number(Latest)), full)\n .await?\n }\n Some(NetworkVariant::Tempo) => {\n let provider =\n ProviderBuilder::::from_config(&config)?.build()?;\n Cast::new(&provider)\n .block_raw(block.unwrap_or(BlockId::Number(Latest)), full)\n .await?\n }\n // Ethereum (default) or no --raw flag\n _ => {\n let provider =\n ProviderBuilder::::from_config(&config)?.build()?;\n Cast::new(&provider)\n .block_raw(block.unwrap_or(BlockId::Number(Latest)), full)\n .await?\n }\n }\n } else {\n let provider = utils::get_provider(&config)?;\n Cast::new(provider)\n .block(block.unwrap_or(BlockId::Number(Latest)), full, fields)\n .await?\n };\n sh_println!(\"{}\", output)?\n }\n CastSubcommand::BlockNumber { rpc, block } => {\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n let number = match block {\n Some(id) => {\n provider\n .get_block(id)\n .await?\n .ok_or_else(|| eyre::eyre!(\"block {id:?} not found\"))?\n .header\n .number\n }\n None => Cast::new(provider).block_number().await?,\n };\n sh_println!(\"{number}\")?\n }\n CastSubcommand::Chain { rpc } => {\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n sh_println!(\"{}\", Cast::new(provider).chain().await?)?\n }\n CastSubcommand::ChainId { rpc } => {\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n sh_println!(\"{}\", Cast::new(provider).chain_id().await?)?\n }\n CastSubcommand::Client { rpc } => {\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n sh_println!(\"{}\", provider.get_client_version().await?)?\n }\n CastSubcommand::Code { block, who, disassemble, rpc } => {\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n let who = who.resolve(&provider).await?;\n sh_println!(\"{}\", Cast::new(provider).code(who, block, disassemble).await?)?\n }\n CastSubcommand::Codesize { block, who, rpc } => {\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n let who = who.resolve(&provider).await?;\n sh_println!(\"{}\", Cast::new(provider).codesize(who, block).await?)?\n }\n CastSubcommand::ComputeAddress { address, nonce, salt, init_code, init_code_hash, rpc } => {\n let address = stdin::unwrap_line(address)?;\n let computed = {\n // For CREATE2, init_code_hash is needed to compute the address\n if let Some(init_code_hash) = init_code_hash {\n address.create2(salt.unwrap_or(B256::ZERO), init_code_hash)\n } else if let Some(init_code) = init_code {\n address.create2(salt.unwrap_or(B256::ZERO), keccak256(hex::decode(init_code)?))\n } else {\n // For CREATE, rpc is needed to compute the address\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n Cast::new(provider).compute_address(address, nonce).await?\n }\n };\n sh_println!(\"Computed Address: {}\", computed.to_checksum(None))?\n }\n CastSubcommand::Disassemble { bytecode } => {\n let bytecode = stdin::unwrap_line(bytecode)?;\n sh_println!(\"{}\", SimpleCast::disassemble(&hex::decode(bytecode)?)?)?\n }\n CastSubcommand::Selectors { bytecode, resolve } => {\n let bytecode = stdin::unwrap_line(bytecode)?;\n let functions = SimpleCast::extract_functions(&bytecode)?;\n let max_args_len = functions.iter().map(|r| r.1.len()).max().unwrap_or(0);\n let max_mutability_len = functions.iter().map(|r| r.2.len()).max().unwrap_or(0);\n\n let resolve_results = if resolve {\n let selectors = functions\n .iter()\n .map(|&(selector, ..)| SelectorKind::Function(selector))\n .collect::>();\n let ds = decode_selectors(&selectors).await?;\n ds.into_iter().map(|v| v.join(\"|\")).collect()\n } else {\n vec![]\n };\n for (pos, (selector, arguments, state_mutability)) in functions.into_iter().enumerate()\n {\n if resolve {\n let resolved = &resolve_results[pos];\n sh_println!(\n \"{selector}\\t{arguments:max_args_len$}\\t{state_mutability:max_mutability_len$}\\t{resolved}\"\n )?\n } else {\n sh_println!(\"{selector}\\t{arguments:max_args_len$}\\t{state_mutability}\")?\n }\n }\n }\n CastSubcommand::FindBlock(cmd) => cmd.run().await?,\n CastSubcommand::GasPrice { rpc } => {\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n sh_println!(\"{}\", Cast::new(provider).gas_price().await?)?;\n }\n CastSubcommand::Index { key_type, key, slot_number } => {\n sh_println!(\"{}\", SimpleCast::index(&key_type, &key, &slot_number)?)?;\n }\n CastSubcommand::IndexErc7201 { id, formula_id } => {\n eyre::ensure!(formula_id == \"erc7201\", \"unsupported formula ID: {formula_id}\");\n let id = stdin::unwrap_line(id)?;\n sh_println!(\"{}\", foundry_common::erc7201(&id))?;\n }\n CastSubcommand::Implementation { block, beacon, who, rpc } => {\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n let who = who.resolve(&provider).await?;\n sh_println!(\"{}\", Cast::new(provider).implementation(who, beacon, block).await?)?;\n }\n CastSubcommand::Admin { block, who, rpc } => {\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n let who = who.resolve(&provider).await?;\n sh_println!(\"{}\", Cast::new(provider).admin(who, block).await?)?;\n }\n CastSubcommand::Nonce { block, who, rpc } => {\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n let who = who.resolve(&provider).await?;\n sh_println!(\"{}\", Cast::new(provider).nonce(who, block).await?)?;\n }\n CastSubcommand::Codehash { block, who, slots, rpc } => {\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n let who = who.resolve(&provider).await?;\n sh_println!(\"{}\", Cast::new(provider).codehash(who, slots, block).await?)?;\n }\n CastSubcommand::StorageRoot { block, who, slots, rpc } => {\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n let who = who.resolve(&provider).await?;\n sh_println!(\"{}\", Cast::new(provider).storage_root(who, slots, block).await?)?;\n }\n CastSubcommand::Proof { address, slots, rpc, block } => {\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n let address = address.resolve(&provider).await?;\n let value = provider\n .get_proof(address, slots.into_iter().collect())\n .block_id(block.unwrap_or_default())\n .await?;\n sh_println!(\"{}\", serde_json::to_string(&value)?)?;\n }\n CastSubcommand::Rpc(cmd) => cmd.run().await?,\n CastSubcommand::Storage(cmd) => cmd.run().await?,\n\n // Calls & transactions\n CastSubcommand::Call(cmd) => cmd.run().await?,\n CastSubcommand::Estimate(cmd) => cmd.run().await?,\n CastSubcommand::MakeTx(cmd) => cmd.run().await?,\n CastSubcommand::PublishTx { raw_tx, cast_async, rpc } => {\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n let cast = Cast::new(&provider);\n let pending_tx = cast.publish(raw_tx).await?;\n let tx_hash = pending_tx.inner().tx_hash();\n\n if cast_async {\n sh_println!(\"{tx_hash:#x}\")?;\n } else {\n let receipt = pending_tx.get_receipt().await?;\n sh_println!(\"{}\", serde_json::json!(receipt))?;\n }\n }\n CastSubcommand::Receipt { tx_hash, field, cast_async, confirmations, rpc } => {\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n sh_println!(\n \"{}\",\n CastTxSender::new(provider)\n .receipt(tx_hash, field, confirmations, None, cast_async)\n .await?\n )?\n }\n CastSubcommand::Run(cmd) => cmd.run().await?,\n CastSubcommand::SendTx(cmd) => cmd.run().await?,\n CastSubcommand::Tx { tx_hash, from, nonce, field, raw, rpc, to_request, network } => {\n let config = rpc.load_config()?;\n // Can use either --raw or specify raw as a field\n let is_raw = raw || field.as_ref().is_some_and(|f| f == \"raw\");\n let output = match network {\n Some(NetworkVariant::Optimism) => {\n let provider = ProviderBuilder::::from_config(&config)?.build()?;\n\n Cast::new(&provider)\n .transaction(tx_hash, from, nonce, field, is_raw, to_request)\n .await?\n }\n Some(NetworkVariant::Tempo) => {\n let provider =\n ProviderBuilder::::from_config(&config)?.build()?;\n Cast::new(&provider)\n .transaction(tx_hash, from, nonce, field, is_raw, to_request)\n .await?\n }\n // Ethereum (default) or no --raw flag\n _ => {\n let provider = utils::get_provider(&config)?;\n Cast::new(&provider)\n .transaction(tx_hash, from, nonce, field, is_raw, to_request)\n .await?\n }\n };\n sh_println!(\"{}\", output)?\n }\n\n // 4Byte\n CastSubcommand::FourByte { selector } => {\n let selector = stdin::unwrap_line(selector)?;\n let sigs = decode_function_selector(selector).await?;\n if sigs.is_empty() {\n eyre::bail!(\"No matching function signatures found for selector `{selector}`\");\n }\n for sig in sigs {\n sh_println!(\"{sig}\")?\n }\n }\n\n CastSubcommand::FourByteCalldata { calldata } => {\n let calldata = stdin::unwrap_line(calldata)?;\n\n if calldata.len() == 10 {\n let sigs = decode_function_selector(calldata.parse()?).await?;\n if sigs.is_empty() {\n eyre::bail!(\"No matching function signatures found for calldata `{calldata}`\");\n }\n for sig in sigs {\n sh_println!(\"{sig}\")?\n }\n return Ok(());\n }\n\n let sigs = decode_calldata(&calldata).await?;\n sigs.iter().enumerate().for_each(|(i, sig)| {\n let _ = sh_println!(\"{}) \\\"{sig}\\\"\", i + 1);\n });\n\n let sig = match sigs.len() {\n 0 => eyre::bail!(\"No signatures found\"),\n 1 => sigs.first().unwrap(),\n _ => {\n let i: usize = prompt!(\"Select a function signature by number: \")?;\n sigs.get(i - 1).ok_or_else(|| eyre::eyre!(\"Invalid signature index\"))?\n }\n };\n\n let tokens = SimpleCast::calldata_decode(sig, &calldata, true)?;\n print_tokens(&tokens);\n }\n\n CastSubcommand::FourByteEvent { topic } => {\n let topic = stdin::unwrap_line(topic)?;\n let sigs = decode_event_topic(topic).await?;\n if sigs.is_empty() {\n eyre::bail!(\"No matching event signatures found for topic `{topic}`\");\n }\n for sig in sigs {\n sh_println!(\"{sig}\")?\n }\n }\n CastSubcommand::UploadSignature { signatures } => {\n let signatures = stdin::unwrap_vec(signatures)?;\n let ParsedSignatures { signatures, abis } = parse_signatures(signatures);\n if !abis.is_empty() {\n import_selectors(SelectorImportData::Abi(abis)).await?.describe();\n }\n if !signatures.is_empty() {\n import_selectors(SelectorImportData::Raw(signatures)).await?.describe();\n }\n }\n\n // ENS\n CastSubcommand::Namehash { name } => {\n let name = stdin::unwrap_line(name)?;\n sh_println!(\"{}\", namehash(&name))?\n }\n CastSubcommand::LookupAddress { who, rpc, verify } => {\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n\n let who = stdin::unwrap_line(who)?;\n let name = provider.lookup_address(&who).await?;\n if verify {\n let address = provider.resolve_name(&name).await?;\n eyre::ensure!(\n address == who,\n \"Reverse lookup verification failed: got `{address}`, expected `{who}`\"\n );\n }\n sh_println!(\"{name}\")?\n }\n CastSubcommand::ResolveName { who, rpc, verify } => {\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n\n let who = stdin::unwrap_line(who)?;\n let address = provider.resolve_name(&who).await?;\n if verify {\n let name = provider.lookup_address(&address).await?;\n eyre::ensure!(\n name == who,\n \"Forward lookup verification failed: got `{name}`, expected `{who}`\"\n );\n }\n sh_println!(\"{address}\")?\n }\n\n // Misc\n CastSubcommand::Keccak { data } => {\n let bytes = match data {\n Some(data) => data.into_bytes(),\n None => stdin::read_bytes(false)?,\n };\n match String::from_utf8(bytes) {\n Ok(s) => {\n let s = SimpleCast::keccak(&s)?;\n sh_println!(\"{s}\")?\n }\n Err(e) => {\n let hash = keccak256(e.as_bytes());\n let s = hex::encode(hash);\n sh_println!(\"0x{s}\")?\n }\n };\n }\n CastSubcommand::HashMessage { message } => {\n let message = stdin::unwrap(message, false)?;\n sh_println!(\"{}\", eip191_hash_message(message))?\n }\n CastSubcommand::SigEvent { event_string } => {\n let event_string = stdin::unwrap_line(event_string)?;\n let parsed_event = get_event(&event_string)?;\n sh_println!(\"{:?}\", parsed_event.selector())?\n }\n CastSubcommand::LeftShift { value, bits, base_in, base_out } => sh_println!(\n \"{}\",\n SimpleCast::left_shift(&value, &bits, base_in.as_deref(), &base_out)?\n )?,\n CastSubcommand::RightShift { value, bits, base_in, base_out } => sh_println!(\n \"{}\",\n SimpleCast::right_shift(&value, &bits, base_in.as_deref(), &base_out)?\n )?,\n CastSubcommand::Source {\n address,\n directory,\n explorer_api_url,\n explorer_url,\n etherscan,\n flatten,\n } => {\n let config = etherscan.load_config()?;\n let chain = config.chain.unwrap_or_default();\n let api_key = config.get_etherscan_api_key(Some(chain));\n match (directory, flatten) {\n (Some(dir), false) => {\n SimpleCast::expand_etherscan_source_to_directory(\n chain,\n address,\n api_key,\n dir,\n explorer_api_url,\n explorer_url,\n )\n .await?\n }\n (None, false) => sh_println!(\n \"{}\",\n SimpleCast::etherscan_source(\n chain,\n address,\n api_key,\n explorer_api_url,\n explorer_url\n )\n .await?\n )?,\n (dir, true) => {\n SimpleCast::etherscan_source_flatten(\n chain,\n address,\n api_key,\n dir,\n explorer_api_url,\n explorer_url,\n )\n .await?;\n }\n }\n }\n CastSubcommand::Create2(cmd) => {\n cmd.run()?;\n }\n CastSubcommand::Wallet { command } => command.run().await?,\n CastSubcommand::Completions { shell } => {\n generate(shell, &mut CastArgs::command(), \"cast\", &mut std::io::stdout())\n }\n CastSubcommand::Logs(cmd) => cmd.run().await?,\n CastSubcommand::DecodeTransaction { tx } => {\n let tx = stdin::unwrap_line(tx)?;\n let tx = SimpleCast::decode_raw_transaction(&tx)?;\n\n if let Ok(signer) = tx.recover() {\n let recovered = Recovered::new_unchecked(tx, signer);\n sh_println!(\"{}\", serde_json::to_string_pretty(&recovered)?)?;\n } else {\n sh_println!(\"{}\", serde_json::to_string_pretty(&tx)?)?;\n }\n }\n CastSubcommand::RecoverAuthority { auth } => {\n let auth: SignedAuthorization = serde_json::from_str(&auth)?;\n sh_println!(\"{}\", auth.recover_authority()?)?;\n }\n CastSubcommand::TxPool { command } => command.run().await?,\n CastSubcommand::Erc20Token { command } => command.run().await?,\n CastSubcommand::DAEstimate(cmd) => {\n cmd.run().await?;\n }\n CastSubcommand::Trace(cmd) => cmd.run().await?,\n };\n\n /// Prints slice of tokens using [`format_tokens`] or [`serialize_value_as_json`] depending\n /// whether the shell is in JSON mode.\n ///\n /// This is included here to avoid a cyclic dependency between `fmt` and `common`.\n fn print_tokens(tokens: &[DynSolValue]) {\n if shell::is_json() {\n let tokens: Vec = tokens\n .iter()\n .cloned()\n .map(|t| serialize_value_as_json(t, None))\n .collect::>>()\n .unwrap();\n let _ = sh_println!(\"{}\", serde_json::to_string_pretty(&tokens).unwrap());\n } else {\n let tokens = format_tokens(tokens);\n tokens.for_each(|t| {\n let _ = sh_println!(\"{t}\");\n });\n }\n }\n\n Ok(())\n}\n" }, { "path": "crates/cast/src/base.rs", "content": "use alloy_primitives::{I256, Sign, U256, utils::ParseUnits};\nuse eyre::Result;\nuse std::{\n convert::Infallible,\n fmt::{Binary, Debug, Display, Formatter, LowerHex, Octal, Result as FmtResult, UpperHex},\n num::IntErrorKind,\n str::FromStr,\n};\n\n/* -------------------------------------------- Base -------------------------------------------- */\n\n/// Represents a number's [radix] or base. Currently it supports the same bases that [std::fmt]\n/// supports.\n///\n/// [radix]: https://en.wikipedia.org/wiki/Radix\n#[repr(u32)]\n#[derive(Clone, Copy, Debug, Default, PartialEq, Eq, PartialOrd, Ord)]\npub enum Base {\n Binary = 2,\n Octal = 8,\n #[default]\n Decimal = 10,\n Hexadecimal = 16,\n}\n\nimpl Display for Base {\n fn fmt(&self, f: &mut Formatter<'_>) -> FmtResult {\n Display::fmt(&(*self as u32), f)\n }\n}\n\nimpl FromStr for Base {\n type Err = eyre::Report;\n\n fn from_str(s: &str) -> Result {\n match s.to_lowercase().as_str() {\n \"2\" | \"b\" | \"bin\" | \"binary\" => Ok(Self::Binary),\n \"8\" | \"o\" | \"oct\" | \"octal\" => Ok(Self::Octal),\n \"10\" | \"d\" | \"dec\" | \"decimal\" => Ok(Self::Decimal),\n \"16\" | \"h\" | \"hex\" | \"hexadecimal\" => Ok(Self::Hexadecimal),\n s => Err(eyre::eyre!(\n \"\\\nInvalid base \\\"{s}\\\". Possible values:\n 2, b, bin, binary\n 8, o, oct, octal\n10, d, dec, decimal\n16, h, hex, hexadecimal\"\n )),\n }\n }\n}\n\nimpl TryFrom for Base {\n type Error = eyre::Report;\n\n fn try_from(s: String) -> Result {\n Self::from_str(&s)\n }\n}\n\nimpl TryFrom for Base {\n type Error = eyre::Report;\n\n fn try_from(n: u32) -> Result {\n match n {\n 2 => Ok(Self::Binary),\n 8 => Ok(Self::Octal),\n 10 => Ok(Self::Decimal),\n 16 => Ok(Self::Hexadecimal),\n n => Err(eyre::eyre!(\"Invalid base \\\"{}\\\". Possible values: 2, 8, 10, 16\", n)),\n }\n }\n}\n\nimpl TryFrom for Base {\n type Error = eyre::Report;\n\n fn try_from(n: I256) -> Result {\n Self::try_from(n.low_u32())\n }\n}\n\nimpl TryFrom for Base {\n type Error = eyre::Report;\n\n fn try_from(n: U256) -> Result {\n Self::try_from(n.saturating_to::())\n }\n}\n\nimpl From for u32 {\n fn from(b: Base) -> Self {\n b as Self\n }\n}\n\nimpl From for String {\n fn from(b: Base) -> Self {\n b.to_string()\n }\n}\n\nimpl Base {\n pub fn unwrap_or_detect(base: Option<&str>, s: impl AsRef) -> Result {\n match base {\n Some(base) => base.parse(),\n None => Self::detect(s),\n }\n }\n\n /// Try parsing a number's base from a string.\n pub fn detect(s: impl AsRef) -> Result {\n let s = s.as_ref();\n match s {\n // Ignore sign\n _ if s.starts_with(['+', '-']) => Self::detect(&s[1..]),\n // Verify binary and octal values with u128::from_str_radix as U256 does not support\n // them;\n // assume overflows are within u128::MAX and U256::MAX, we're not using the parsed value\n // anyway;\n // strip prefix when using u128::from_str_radix because it does not recognize it as\n // valid.\n _ if s.starts_with(\"0b\") => match u64::from_str_radix(&s[2..], 2) {\n Ok(_) => Ok(Self::Binary),\n Err(e) => match e.kind() {\n IntErrorKind::PosOverflow => Ok(Self::Binary),\n _ => Err(eyre::eyre!(\"could not parse binary value: {}\", e)),\n },\n },\n _ if s.starts_with(\"0o\") => match u64::from_str_radix(&s[2..], 8) {\n Ok(_) => Ok(Self::Octal),\n Err(e) => match e.kind() {\n IntErrorKind::PosOverflow => Ok(Self::Octal),\n _ => Err(eyre::eyre!(\"could not parse octal value: {e}\")),\n },\n },\n _ if s.starts_with(\"0x\") => match u64::from_str_radix(&s[2..], 16) {\n Ok(_) => Ok(Self::Hexadecimal),\n Err(e) => match e.kind() {\n IntErrorKind::PosOverflow => Ok(Self::Hexadecimal),\n _ => Err(eyre::eyre!(\"could not parse hexadecimal value: {e}\")),\n },\n },\n // No prefix => first try parsing as decimal\n _ => match U256::from_str_radix(s, 10) {\n // Can be both, ambiguous but default to Decimal\n Ok(_) => Ok(Self::Decimal),\n Err(_) => match U256::from_str_radix(s, 16) {\n Ok(_) => Ok(Self::Hexadecimal),\n Err(e) => Err(eyre::eyre!(\n \"could not autodetect base as neither decimal or hexadecimal: {e}\"\n )),\n },\n },\n }\n }\n\n /// Returns the Rust standard prefix for a base\n pub const fn prefix(&self) -> &str {\n match self {\n Self::Binary => \"0b\",\n Self::Octal => \"0o\",\n Self::Decimal => \"\",\n Self::Hexadecimal => \"0x\",\n }\n }\n}\n\n/* --------------------------------------- NumberWithBase --------------------------------------- */\n\n/// Utility struct for parsing numbers and formatting them into different [bases][Base].\n///\n/// # Example\n///\n/// ```\n/// use cast::base::NumberWithBase;\n/// use alloy_primitives::U256;\n///\n/// let number: NumberWithBase = U256::from(12345).into();\n/// assert_eq!(number.format(), \"12345\");\n///\n/// // Debug uses number.base() to determine which base to format to, which defaults to Base::Decimal\n/// assert_eq!(format!(\"{:?}\", number), \"12345\");\n///\n/// // Display uses Base::Decimal\n/// assert_eq!(format!(\"{}\", number), \"12345\");\n///\n/// // The alternate formatter (\"#\") prepends the base's prefix\n/// assert_eq!(format!(\"{:x}\", number), \"3039\");\n/// assert_eq!(format!(\"{:#x}\", number), \"0x3039\");\n///\n/// assert_eq!(format!(\"{:b}\", number), \"11000000111001\");\n/// assert_eq!(format!(\"{:#b}\", number), \"0b11000000111001\");\n///\n/// assert_eq!(format!(\"{:o}\", number), \"30071\");\n/// assert_eq!(format!(\"{:#o}\", number), \"0o30071\");\n/// ```\n#[derive(Clone, Copy)]\npub struct NumberWithBase {\n /// The number.\n number: U256,\n /// Whether the number is positive or zero.\n is_nonnegative: bool,\n /// The base to format to.\n base: Base,\n}\n\nimpl std::ops::Deref for NumberWithBase {\n type Target = U256;\n\n fn deref(&self) -> &Self::Target {\n &self.number\n }\n}\n\n// Format using self.base\nimpl Debug for NumberWithBase {\n fn fmt(&self, f: &mut Formatter<'_>) -> FmtResult {\n let prefix = self.base.prefix();\n if self.number.is_zero() {\n f.pad_integral(true, prefix, \"0\")\n } else {\n // Add sign only for decimal\n let is_nonnegative = match self.base {\n Base::Decimal => self.is_nonnegative,\n _ => true,\n };\n f.pad_integral(is_nonnegative, prefix, &self.format())\n }\n }\n}\n\nimpl Binary for NumberWithBase {\n fn fmt(&self, f: &mut Formatter<'_>) -> FmtResult {\n Debug::fmt(&self.with_base(Base::Binary), f)\n }\n}\n\nimpl Octal for NumberWithBase {\n fn fmt(&self, f: &mut Formatter<'_>) -> FmtResult {\n Debug::fmt(&self.with_base(Base::Octal), f)\n }\n}\n\nimpl Display for NumberWithBase {\n fn fmt(&self, f: &mut Formatter<'_>) -> FmtResult {\n Debug::fmt(&self.with_base(Base::Decimal), f)\n }\n}\n\nimpl LowerHex for NumberWithBase {\n fn fmt(&self, f: &mut Formatter<'_>) -> FmtResult {\n Debug::fmt(&self.with_base(Base::Hexadecimal), f)\n }\n}\n\nimpl UpperHex for NumberWithBase {\n fn fmt(&self, f: &mut Formatter<'_>) -> FmtResult {\n let n = format!(\"{self:x}\").to_uppercase();\n f.pad_integral(true, Base::Hexadecimal.prefix(), &n)\n }\n}\n\nimpl FromStr for NumberWithBase {\n type Err = eyre::Report;\n\n fn from_str(s: &str) -> Result {\n Self::parse_int(s, None)\n }\n}\n\nimpl From for NumberWithBase {\n fn from(number: I256) -> Self {\n // both is_positive and is_negative return false for 0\n Self::new(number.into_raw(), !number.is_negative(), Base::default())\n }\n}\n\nimpl From for NumberWithBase {\n fn from(value: ParseUnits) -> Self {\n match value {\n ParseUnits::U256(val) => val.into(),\n ParseUnits::I256(val) => val.into(),\n }\n }\n}\n\nimpl From for NumberWithBase {\n fn from(number: U256) -> Self {\n Self::new(number, true, Base::default())\n }\n}\n\nimpl From for I256 {\n fn from(n: NumberWithBase) -> Self {\n Self::from_raw(n.number)\n }\n}\n\nimpl From for U256 {\n fn from(n: NumberWithBase) -> Self {\n n.number\n }\n}\n\nimpl From for String {\n /// Formats the number into the specified base. See [NumberWithBase::format].\n ///\n /// [NumberWithBase::format]: NumberWithBase\n fn from(n: NumberWithBase) -> Self {\n n.format()\n }\n}\n\nimpl NumberWithBase {\n pub fn new(number: impl Into, is_nonnegative: bool, base: Base) -> Self {\n Self { number: number.into(), is_nonnegative, base }\n }\n\n /// Creates a copy of the number with the provided base.\n pub fn with_base(&self, base: Base) -> Self {\n Self { number: self.number, is_nonnegative: self.is_nonnegative, base }\n }\n\n /// Parses a string slice into a signed integer. If base is None then it tries to determine base\n /// from the prefix, otherwise defaults to Decimal.\n pub fn parse_int(s: &str, base: Option<&str>) -> Result {\n let base = Base::unwrap_or_detect(base, s)?;\n let (number, is_nonnegative) = Self::_parse_int(s, base)?;\n Ok(Self { number, is_nonnegative, base })\n }\n\n /// Parses a string slice into an unsigned integer. If base is None then it tries to determine\n /// base from the prefix, otherwise defaults to Decimal.\n pub fn parse_uint(s: &str, base: Option<&str>) -> Result {\n let base = Base::unwrap_or_detect(base, s)?;\n let number = Self::_parse_uint(s, base)?;\n Ok(Self { number, is_nonnegative: true, base })\n }\n\n /// Returns a copy of the underlying number as an unsigned integer. If the value is negative\n /// then the two's complement of its absolute value will be returned.\n pub fn number(&self) -> U256 {\n self.number\n }\n\n /// Returns whether the underlying number is positive or zero.\n pub fn is_nonnegative(&self) -> bool {\n self.is_nonnegative\n }\n\n /// Returns the underlying base. Defaults to [Decimal][Base].\n pub fn base(&self) -> Base {\n self.base\n }\n\n /// Returns the Rust standard prefix for the base.\n pub const fn prefix(&self) -> &str {\n self.base.prefix()\n }\n\n /// Sets the number's base to format to.\n pub fn set_base(&mut self, base: Base) -> &mut Self {\n self.base = base;\n self\n }\n\n /// Formats the number into the specified base.\n ///\n /// **Note**: this method only formats the number into the base, without adding any prefixes,\n /// signs or padding. Refer to the [std::fmt] module documentation on how to format this\n /// number with the aforementioned properties.\n pub fn format(&self) -> String {\n let s = match self.base {\n Base::Binary => format!(\"{:b}\", self.number),\n Base::Octal => format!(\"{:o}\", self.number),\n Base::Decimal => {\n if self.is_nonnegative {\n self.number.to_string()\n } else {\n let s = I256::from_raw(self.number).to_string();\n s.strip_prefix('-').unwrap_or(&s).to_string()\n }\n }\n Base::Hexadecimal => format!(\"{:x}\", self.number),\n };\n if s.starts_with('0') { s.trim_start_matches('0').to_string() } else { s }\n }\n\n fn _parse_int(s: &str, base: Base) -> Result<(U256, bool)> {\n let (s, sign) = get_sign(s);\n let mut n = Self::_parse_uint(s, base)?;\n\n let is_neg = matches!(sign, Sign::Negative);\n if is_neg {\n n = (!n).overflowing_add(U256::from(1)).0;\n }\n\n Ok((n, !is_neg))\n }\n\n fn _parse_uint(s: &str, base: Base) -> Result {\n let s = match s.get(0..2) {\n Some(\"0x\" | \"0X\" | \"0o\" | \"0O\" | \"0b\" | \"0B\") => &s[2..],\n _ => s,\n };\n U256::from_str_radix(s, base as u64).map_err(Into::into)\n }\n}\n\n/* ------------------------------------------- ToBase ------------------------------------------- */\n\n/// Facilitates formatting an integer into a [Base].\npub trait ToBase {\n type Err;\n\n /// Formats self into a base, specifying whether to add the base prefix or not.\n ///\n /// Tries converting `self` into a [NumberWithBase] and then formats into the provided base by\n /// using the [Debug] implementation.\n ///\n /// # Example\n ///\n /// ```\n /// use alloy_primitives::U256;\n /// use cast::base::{Base, ToBase};\n ///\n /// // Any type that implements ToBase\n /// let number = U256::from(12345);\n /// assert_eq!(number.to_base(Base::Decimal, false).unwrap(), \"12345\");\n /// assert_eq!(number.to_base(Base::Hexadecimal, false).unwrap(), \"3039\");\n /// assert_eq!(number.to_base(Base::Hexadecimal, true).unwrap(), \"0x3039\");\n /// assert_eq!(number.to_base(Base::Binary, true).unwrap(), \"0b11000000111001\");\n /// assert_eq!(number.to_base(Base::Octal, true).unwrap(), \"0o30071\");\n /// ```\n fn to_base(&self, base: Base, add_prefix: bool) -> Result;\n}\n\nimpl ToBase for NumberWithBase {\n type Err = Infallible;\n\n fn to_base(&self, base: Base, add_prefix: bool) -> Result {\n let n = self.with_base(base);\n if add_prefix { Ok(format!(\"{n:#?}\")) } else { Ok(format!(\"{n:?}\")) }\n }\n}\n\nimpl ToBase for I256 {\n type Err = Infallible;\n\n fn to_base(&self, base: Base, add_prefix: bool) -> Result {\n let n = NumberWithBase::from(*self).with_base(base);\n if add_prefix { Ok(format!(\"{n:#?}\")) } else { Ok(format!(\"{n:?}\")) }\n }\n}\n\nimpl ToBase for U256 {\n type Err = Infallible;\n\n fn to_base(&self, base: Base, add_prefix: bool) -> Result {\n let n = NumberWithBase::from(*self).with_base(base);\n if add_prefix { Ok(format!(\"{n:#?}\")) } else { Ok(format!(\"{n:?}\")) }\n }\n}\n\nimpl ToBase for String {\n type Err = eyre::Report;\n\n fn to_base(&self, base: Base, add_prefix: bool) -> Result {\n str::to_base(self, base, add_prefix)\n }\n}\n\nimpl ToBase for str {\n type Err = eyre::Report;\n\n fn to_base(&self, base: Base, add_prefix: bool) -> Result {\n let n = NumberWithBase::from_str(self)?.with_base(base);\n if add_prefix { Ok(format!(\"{n:#?}\")) } else { Ok(format!(\"{n:?}\")) }\n }\n}\n\nfn get_sign(s: &str) -> (&str, Sign) {\n match s.as_bytes().first() {\n Some(b'+') => (&s[1..], Sign::Positive),\n Some(b'-') => (&s[1..], Sign::Negative),\n _ => (s, Sign::Positive),\n }\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n use Base::*;\n\n const POS_NUM: [i128; 44] = [\n 1,\n 2,\n 3,\n 5,\n 7,\n 8,\n 10,\n 11,\n 13,\n 16,\n 17,\n 19,\n 23,\n 29,\n 31,\n 32,\n 37,\n 41,\n 43,\n 47,\n 53,\n 59,\n 61,\n 64,\n 67,\n 71,\n 73,\n 79,\n 83,\n 89,\n 97,\n 100,\n 128,\n 200,\n 333,\n 500,\n 666,\n 1000,\n 6666,\n 10000,\n i16::MAX as i128,\n i32::MAX as i128,\n i64::MAX as i128,\n i128::MAX,\n ];\n\n const NEG_NUM: [i128; 44] = [\n -1,\n -2,\n -3,\n -5,\n -7,\n -8,\n -10,\n -11,\n -13,\n -16,\n -17,\n -19,\n -23,\n -29,\n -31,\n -32,\n -37,\n -41,\n -43,\n -47,\n -53,\n -59,\n -61,\n -64,\n -67,\n -71,\n -73,\n -79,\n -83,\n -89,\n -97,\n -100,\n -128,\n -200,\n -333,\n -500,\n -666,\n -1000,\n -6666,\n -10000,\n i16::MIN as i128,\n i32::MIN as i128,\n i64::MIN as i128,\n i128::MIN,\n ];\n\n #[test]\n fn test_defaults() {\n let def: Base = Default::default();\n assert!(matches!(def, Decimal));\n\n let n: NumberWithBase = U256::ZERO.into();\n assert!(matches!(n.base, Decimal));\n let n: NumberWithBase = I256::ZERO.into();\n assert!(matches!(n.base, Decimal));\n }\n\n #[test]\n fn can_parse_base() {\n assert_eq!(\"2\".parse::().unwrap(), Binary);\n assert_eq!(\"b\".parse::().unwrap(), Binary);\n assert_eq!(\"bin\".parse::().unwrap(), Binary);\n assert_eq!(\"binary\".parse::().unwrap(), Binary);\n\n assert_eq!(\"8\".parse::().unwrap(), Octal);\n assert_eq!(\"o\".parse::().unwrap(), Octal);\n assert_eq!(\"oct\".parse::().unwrap(), Octal);\n assert_eq!(\"octal\".parse::().unwrap(), Octal);\n\n assert_eq!(\"10\".parse::().unwrap(), Decimal);\n assert_eq!(\"d\".parse::().unwrap(), Decimal);\n assert_eq!(\"dec\".parse::().unwrap(), Decimal);\n assert_eq!(\"decimal\".parse::().unwrap(), Decimal);\n\n assert_eq!(\"16\".parse::().unwrap(), Hexadecimal);\n assert_eq!(\"h\".parse::().unwrap(), Hexadecimal);\n assert_eq!(\"hex\".parse::().unwrap(), Hexadecimal);\n assert_eq!(\"hexadecimal\".parse::().unwrap(), Hexadecimal);\n }\n\n #[test]\n fn can_detect_base() {\n assert_eq!(Base::detect(\"0b100\").unwrap(), Binary);\n assert_eq!(Base::detect(\"0o100\").unwrap(), Octal);\n assert_eq!(Base::detect(\"100\").unwrap(), Decimal);\n assert_eq!(Base::detect(\"0x100\").unwrap(), Hexadecimal);\n\n assert_eq!(Base::detect(\"0123456789abcdef\").unwrap(), Hexadecimal);\n\n let _ = Base::detect(\"0b234abc\").unwrap_err();\n let _ = Base::detect(\"0o89cba\").unwrap_err();\n let _ = Base::detect(\"0123456789abcdefg\").unwrap_err();\n let _ = Base::detect(\"0x123abclpmk\").unwrap_err();\n let _ = Base::detect(\"hello world\").unwrap_err();\n }\n\n #[test]\n fn test_format_pos() {\n let expected_2: Vec<_> = POS_NUM.iter().map(|n| format!(\"{n:b}\")).collect();\n let expected_8: Vec<_> = POS_NUM.iter().map(|n| format!(\"{n:o}\")).collect();\n let expected_10: Vec<_> = POS_NUM.iter().map(|n| format!(\"{n:}\")).collect();\n let expected_l16: Vec<_> = POS_NUM.iter().map(|n| format!(\"{n:x}\")).collect();\n let expected_u16: Vec<_> = POS_NUM.iter().map(|n| format!(\"{n:X}\")).collect();\n\n for (i, n) in POS_NUM.into_iter().enumerate() {\n let mut num: NumberWithBase = I256::try_from(n).unwrap().into();\n\n assert_eq!(num.set_base(Binary).format(), expected_2[i]);\n assert_eq!(num.set_base(Octal).format(), expected_8[i]);\n assert_eq!(num.set_base(Decimal).format(), expected_10[i]);\n assert_eq!(num.set_base(Hexadecimal).format(), expected_l16[i]);\n assert_eq!(num.set_base(Hexadecimal).format().to_uppercase(), expected_u16[i]);\n }\n }\n\n #[test]\n fn test_format_neg() {\n // underlying is 256 bits so we have to pad left manually\n\n let expected_2: Vec<_> = NEG_NUM.iter().map(|n| format!(\"{n:1>256b}\")).collect();\n let expected_8: Vec<_> = NEG_NUM\n .iter()\n .map(|n| {\n let i = I256::try_from(*n).unwrap();\n let mut u = NumberWithBase::from(i);\n u.set_base(Octal);\n u.format()\n })\n .collect();\n // Sign not included, see NumberWithBase::format\n let expected_10: Vec<_> =\n NEG_NUM.iter().map(|n| format!(\"{n:}\").trim_matches('-').to_string()).collect();\n let expected_l16: Vec<_> = NEG_NUM.iter().map(|n| format!(\"{n:f>64x}\")).collect();\n let expected_u16: Vec<_> = NEG_NUM.iter().map(|n| format!(\"{n:F>64X}\")).collect();\n\n for (i, n) in NEG_NUM.into_iter().enumerate() {\n let mut num: NumberWithBase = I256::try_from(n).unwrap().into();\n\n assert_eq!(num.set_base(Binary).format(), expected_2[i]);\n assert_eq!(num.set_base(Octal).format(), expected_8[i]);\n assert_eq!(num.set_base(Decimal).format(), expected_10[i]);\n assert_eq!(num.set_base(Hexadecimal).format(), expected_l16[i]);\n assert_eq!(num.set_base(Hexadecimal).format().to_uppercase(), expected_u16[i]);\n }\n }\n\n #[test]\n fn test_fmt_macro() {\n let nums: Vec<_> =\n POS_NUM.into_iter().map(|n| NumberWithBase::from(I256::try_from(n).unwrap())).collect();\n\n let actual_2: Vec<_> = nums.iter().map(|n| format!(\"{n:b}\")).collect();\n let actual_2_alt: Vec<_> = nums.iter().map(|n| format!(\"{n:#b}\")).collect();\n let actual_8: Vec<_> = nums.iter().map(|n| format!(\"{n:o}\")).collect();\n let actual_8_alt: Vec<_> = nums.iter().map(|n| format!(\"{n:#o}\")).collect();\n let actual_10: Vec<_> = nums.iter().map(|n| format!(\"{n:}\")).collect();\n let actual_10_alt: Vec<_> = nums.iter().map(|n| format!(\"{n:#}\")).collect();\n let actual_l16: Vec<_> = nums.iter().map(|n| format!(\"{n:x}\")).collect();\n let actual_l16_alt: Vec<_> = nums.iter().map(|n| format!(\"{n:#x}\")).collect();\n let actual_u16: Vec<_> = nums.iter().map(|n| format!(\"{n:X}\")).collect();\n let actual_u16_alt: Vec<_> = nums.iter().map(|n| format!(\"{n:#X}\")).collect();\n\n let expected_2: Vec<_> = POS_NUM.iter().map(|n| format!(\"{n:b}\")).collect();\n let expected_2_alt: Vec<_> = POS_NUM.iter().map(|n| format!(\"{n:#b}\")).collect();\n let expected_8: Vec<_> = POS_NUM.iter().map(|n| format!(\"{n:o}\")).collect();\n let expected_8_alt: Vec<_> = POS_NUM.iter().map(|n| format!(\"{n:#o}\")).collect();\n let expected_10: Vec<_> = POS_NUM.iter().map(|n| format!(\"{n:}\")).collect();\n let expected_10_alt: Vec<_> = POS_NUM.iter().map(|n| format!(\"{n:#}\")).collect();\n let expected_l16: Vec<_> = POS_NUM.iter().map(|n| format!(\"{n:x}\")).collect();\n let expected_l16_alt: Vec<_> = POS_NUM.iter().map(|n| format!(\"{n:#x}\")).collect();\n let expected_u16: Vec<_> = POS_NUM.iter().map(|n| format!(\"{n:X}\")).collect();\n let expected_u16_alt: Vec<_> = POS_NUM.iter().map(|n| format!(\"{n:#X}\")).collect();\n\n for (i, _) in POS_NUM.iter().enumerate() {\n assert_eq!(actual_2[i], expected_2[i]);\n assert_eq!(actual_2_alt[i], expected_2_alt[i]);\n\n assert_eq!(actual_8[i], expected_8[i]);\n assert_eq!(actual_8_alt[i], expected_8_alt[i]);\n\n assert_eq!(actual_10[i], expected_10[i]);\n assert_eq!(actual_10_alt[i], expected_10_alt[i]);\n\n assert_eq!(actual_l16[i], expected_l16[i]);\n assert_eq!(actual_l16_alt[i], expected_l16_alt[i]);\n\n assert_eq!(actual_u16[i], expected_u16[i]);\n assert_eq!(actual_u16_alt[i], expected_u16_alt[i]);\n }\n }\n}\n" }, { "path": "crates/cast/src/cmd/access_list.rs", "content": "use crate::{\n Cast,\n tx::{CastTxBuilder, SenderKind},\n};\nuse alloy_ens::NameOrAddress;\nuse alloy_network::{AnyNetwork, Network};\nuse alloy_rpc_types::BlockId;\nuse clap::Parser;\nuse eyre::Result;\nuse foundry_cli::{\n opts::{RpcOpts, TransactionOpts},\n utils::LoadConfig,\n};\nuse foundry_common::provider::ProviderBuilder;\nuse foundry_primitives::FoundryTransactionBuilder;\nuse foundry_wallets::WalletOpts;\nuse std::str::FromStr;\nuse tempo_alloy::TempoNetwork;\n\n/// CLI arguments for `cast access-list`.\n#[derive(Debug, Parser)]\npub struct AccessListArgs {\n /// The destination of the transaction.\n #[arg(\n value_name = \"TO\",\n value_parser = NameOrAddress::from_str\n )]\n to: Option,\n\n /// The signature of the function to call.\n #[arg(value_name = \"SIG\")]\n sig: Option,\n\n /// The arguments of the function to call.\n #[arg(value_name = \"ARGS\", allow_negative_numbers = true)]\n args: Vec,\n\n /// Raw hex-encoded data for the transaction. Used instead of \\[SIG\\] and \\[ARGS\\].\n #[arg(\n long,\n conflicts_with_all = &[\"sig\", \"args\"]\n )]\n data: Option,\n\n /// The block height to query at.\n ///\n /// Can also be the tags earliest, finalized, safe, latest, or pending.\n #[arg(long, short = 'B')]\n block: Option,\n\n #[command(flatten)]\n tx: TransactionOpts,\n\n #[command(flatten)]\n rpc: RpcOpts,\n\n #[command(flatten)]\n wallet: WalletOpts,\n}\n\nimpl AccessListArgs {\n pub async fn run(self) -> Result<()> {\n if self.tx.tempo.is_tempo() {\n self.run_with_network::().await\n } else {\n self.run_with_network::().await\n }\n }\n\n pub async fn run_with_network(self) -> Result<()>\n where\n N::TransactionRequest: FoundryTransactionBuilder,\n {\n let Self { to, mut sig, args, data, tx, rpc, wallet, block } = self;\n\n if let Some(data) = data {\n sig = Some(data);\n }\n\n let config = rpc.load_config()?;\n let provider = ProviderBuilder::::from_config(&config)?.build()?;\n let sender = SenderKind::from_wallet_opts(wallet).await?;\n\n let (tx, _) = CastTxBuilder::new(&provider, tx, &config)\n .await?\n .with_to(to)\n .await?\n .with_code_sig_and_args(None, sig, args)\n .await?\n .raw()\n .build(sender)\n .await?;\n\n let access_list: String = Cast::new(&provider).access_list(&tx, block).await?;\n\n sh_println!(\"{access_list}\")?;\n\n Ok(())\n }\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n use alloy_primitives::hex;\n use clap::error::ErrorKind;\n\n #[test]\n fn can_parse_access_list_data() {\n let data = hex::encode(\"hello\");\n let args = AccessListArgs::parse_from([\"foundry-cli\", \"--data\", data.as_str()]);\n assert_eq!(args.data, Some(data));\n\n let data = hex::encode_prefixed(\"hello\");\n let args = AccessListArgs::parse_from([\"foundry-cli\", \"--data\", data.as_str()]);\n assert_eq!(args.data, Some(data));\n }\n\n #[test]\n fn data_conflicts_with_sig_and_args() {\n let err = AccessListArgs::try_parse_from([\n \"foundry-cli\",\n \"0x0000000000000000000000000000000000000001\",\n \"transfer(address,uint256)\",\n \"0x0000000000000000000000000000000000000002\",\n \"1\",\n \"--data\",\n \"0x1234\",\n ])\n .unwrap_err();\n\n assert_eq!(err.kind(), ErrorKind::ArgumentConflict);\n }\n}\n" }, { "path": "crates/cast/src/cmd/artifact.rs", "content": "use super::{\n creation_code::{fetch_creation_code_from_etherscan, parse_code_output},\n interface::load_abi_from_file,\n};\nuse alloy_primitives::Address;\nuse alloy_provider::Provider;\nuse clap::Parser;\nuse eyre::Result;\nuse foundry_cli::{\n opts::{EtherscanOpts, RpcOpts},\n utils::{self, LoadConfig, fetch_abi_from_etherscan},\n};\nuse foundry_common::fs;\nuse serde_json::json;\nuse std::path::PathBuf;\n\nfoundry_config::impl_figment_convert!(ArtifactArgs, etherscan, rpc);\n\n/// CLI arguments for `cast artifact`.\n#[derive(Parser)]\npub struct ArtifactArgs {\n /// An Ethereum address, for which the artifact will be produced.\n contract: Address,\n\n /// Path to file containing the contract's JSON ABI. It's necessary if the target contract is\n /// not verified on Etherscan.\n #[arg(long)]\n abi_path: Option,\n\n /// The path to the output file.\n ///\n /// If not specified, the artifact will be output to stdout.\n #[arg(\n short,\n long,\n value_hint = clap::ValueHint::FilePath,\n value_name = \"PATH\",\n )]\n output: Option,\n\n #[command(flatten)]\n etherscan: EtherscanOpts,\n\n #[command(flatten)]\n rpc: RpcOpts,\n}\n\nimpl ArtifactArgs {\n pub async fn run(self) -> Result<()> {\n let mut config = self.load_config()?;\n\n let Self { contract, output: output_location, abi_path, etherscan: _, rpc: _ } = self;\n\n let provider = utils::get_provider(&config)?;\n let chain = provider.get_chain_id().await?;\n config.chain = Some(chain.into());\n\n let abi = if let Some(ref abi_path) = abi_path {\n load_abi_from_file(abi_path, None)?\n } else {\n fetch_abi_from_etherscan(contract, &config).await?\n };\n\n let (abi, _) = abi.first().ok_or_else(|| eyre::eyre!(\"No ABI found\"))?;\n\n let bytecode = fetch_creation_code_from_etherscan(contract, &config, provider).await?;\n let bytecode =\n parse_code_output(bytecode, contract, &config, abi_path.as_deref(), true, false)\n .await?;\n\n let artifact = json!({\n \"abi\": abi,\n \"bytecode\": {\n \"object\": bytecode\n }\n });\n\n let artifact = serde_json::to_string_pretty(&artifact)?;\n\n if let Some(loc) = output_location {\n if let Some(parent) = loc.parent() {\n fs::create_dir_all(parent)?;\n }\n fs::write(&loc, artifact)?;\n sh_println!(\"Saved artifact at {}\", loc.display())?;\n } else {\n sh_println!(\"{artifact}\")?;\n }\n\n Ok(())\n }\n}\n" }, { "path": "crates/cast/src/cmd/b2e_payload.rs", "content": "//! Command Line handler to convert Beacon block's execution payload to Execution format.\n\nuse std::path::PathBuf;\n\nuse alloy_rpc_types_beacon::payload::BeaconBlockData;\nuse clap::{Parser, builder::ValueParser};\nuse eyre::{Result, eyre};\nuse foundry_common::{fs, sh_print};\n\n/// CLI arguments for `cast b2e-payload`, convert Beacon block's execution payload to Execution\n/// format.\n#[derive(Parser)]\npub struct B2EPayloadArgs {\n /// Input data, it can be either a file path to JSON file or raw JSON string containing the\n /// beacon block\n #[arg(value_name = \"INPUT\", value_parser=ValueParser::new(parse_input_source), help = \"File path to JSON file or raw JSON string containing the beacon block\")]\n pub input: InputSource,\n}\n\nimpl B2EPayloadArgs {\n pub async fn run(self) -> Result<()> {\n let beacon_block_json = match self.input {\n InputSource::Json(json) => json,\n InputSource::File(path) => fs::read_to_string(&path)\n .map_err(|e| eyre!(\"Failed to read JSON file '{}': {}\", path.display(), e))?,\n };\n\n let beacon_block_data: BeaconBlockData = serde_json::from_str(&beacon_block_json)\n .map_err(|e| eyre!(\"Failed to parse beacon block JSON: {}\", e))?;\n\n let execution_payload = beacon_block_data.execution_payload();\n\n // Output raw execution payload\n let output = serde_json::to_string(&execution_payload)\n .map_err(|e| eyre!(\"Failed to serialize execution payload: {}\", e))?;\n sh_print!(\"{}\", output)?;\n\n Ok(())\n }\n}\n\n/// Represents the different input sources for beacon block data\n#[derive(Debug, Clone)]\npub enum InputSource {\n /// Path to a JSON file containing beacon block data\n File(PathBuf),\n /// Raw JSON string containing beacon block data\n Json(String),\n}\n\nfn parse_input_source(s: &str) -> Result {\n // Try parsing as JSON first\n if serde_json::from_str::(s).is_ok() {\n return Ok(InputSource::Json(s.to_string()));\n }\n\n // Otherwise treat as file path\n Ok(InputSource::File(PathBuf::from(s)))\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n\n #[test]\n fn test_parse_input_source_json_object() {\n let json_input = r#\"{\"execution_payload\": {\"block_hash\": \"0x123\"}}\"#;\n let result = parse_input_source(json_input).unwrap();\n\n match result {\n InputSource::Json(json) => assert_eq!(json, json_input),\n InputSource::File(_) => panic!(\"Expected JSON input, got File\"),\n }\n }\n\n #[test]\n fn test_parse_input_source_json_array() {\n let json_input = r#\"[{\"block\": \"data\"}]\"#;\n let result = parse_input_source(json_input).unwrap();\n\n match result {\n InputSource::Json(json) => assert_eq!(json, json_input),\n InputSource::File(_) => panic!(\"Expected JSON input, got File\"),\n }\n }\n\n #[test]\n fn test_parse_input_source_file_path() {\n let file_path =\n \"block-12225729-6ceadbf2a6adbbd64cbec33fdebbc582f25171cd30ac43f641cbe76ac7313ddf.json\";\n let result = parse_input_source(file_path).unwrap();\n\n match result {\n InputSource::File(path) => assert_eq!(path, PathBuf::from(file_path)),\n InputSource::Json(_) => panic!(\"Expected File input, got JSON\"),\n }\n }\n\n #[test]\n fn test_parse_input_source_malformed_but_not_json() {\n let malformed = \"not-json-{\";\n let result = parse_input_source(malformed).unwrap();\n\n // Should be treated as file path since it's not valid JSON\n match result {\n InputSource::File(path) => assert_eq!(path, PathBuf::from(malformed)),\n InputSource::Json(_) => panic!(\"Expected File input, got File\"),\n }\n }\n}\n" }, { "path": "crates/cast/src/cmd/bind.rs", "content": "use clap::{Parser, ValueHint};\nuse eyre::Result;\nuse foundry_cli::opts::EtherscanOpts;\nuse std::path::PathBuf;\n\nconst DEFAULT_CRATE_NAME: &str = \"foundry-contracts\";\nconst DEFAULT_CRATE_VERSION: &str = \"0.0.1\";\n\n/// CLI arguments for `cast bind`.\n#[derive(Clone, Debug, Parser)]\npub struct BindArgs {\n /// The contract address, or the path to an ABI Directory\n ///\n /// If an address is specified, then the ABI is fetched from Etherscan.\n path_or_address: String,\n\n /// Path to where bindings will be stored\n #[arg(\n short,\n long,\n value_hint = ValueHint::DirPath,\n value_name = \"PATH\"\n )]\n pub output_dir: Option,\n\n /// The name of the Rust crate to generate.\n ///\n /// This should be a valid crates.io crate name. However, this is currently not validated by\n /// this command.\n #[arg(\n long,\n default_value = DEFAULT_CRATE_NAME,\n value_name = \"NAME\"\n )]\n crate_name: String,\n\n /// The version of the Rust crate to generate.\n ///\n /// This should be a standard semver version string. However, it is not currently validated by\n /// this command.\n #[arg(\n long,\n default_value = DEFAULT_CRATE_VERSION,\n value_name = \"VERSION\"\n )]\n crate_version: String,\n\n /// Generate bindings as separate files.\n #[arg(long)]\n separate_files: bool,\n\n #[command(flatten)]\n etherscan: EtherscanOpts,\n}\n\nimpl BindArgs {\n pub async fn run(self) -> Result<()> {\n Err(eyre::eyre!(\n \"`cast bind` has been removed.\\n\\\n Please use `cast source` to create a Forge project from a block explorer source\\n\\\n and `forge bind` to generate the bindings to it instead.\"\n ))\n }\n}\n" }, { "path": "crates/cast/src/cmd/call.rs", "content": "use super::run::fetch_contracts_bytecode_from_trace;\nuse crate::{\n Cast,\n debug::handle_traces,\n traces::TraceKind,\n tx::{CastTxBuilder, SenderKind},\n};\nuse alloy_ens::NameOrAddress;\nuse alloy_network::{AnyNetwork, Network, TransactionBuilder};\nuse alloy_primitives::{Address, B256, Bytes, TxKind, U256, hex, map::HashMap};\nuse alloy_provider::Provider;\nuse alloy_rpc_types::{\n BlockId, BlockNumberOrTag, BlockOverrides,\n state::{StateOverride, StateOverridesBuilder},\n};\nuse clap::Parser;\nuse eyre::Result;\nuse foundry_cli::{\n opts::{ChainValueParser, RpcOpts, TransactionOpts},\n utils::{LoadConfig, TraceResult, parse_ether_value},\n};\nuse foundry_common::{\n abi::{encode_function_args, get_func},\n provider::{ProviderBuilder, curl_transport::generate_curl_command},\n sh_println, shell,\n};\nuse foundry_compilers::artifacts::EvmVersion;\nuse foundry_config::{\n Chain, Config,\n figment::{\n self, Metadata, Profile,\n value::{Dict, Map},\n },\n};\nuse foundry_evm::{\n executors::TracingExecutor,\n opts::EvmOpts,\n traces::{InternalTraceMode, TraceMode},\n};\nuse foundry_primitives::FoundryTransactionBuilder;\nuse foundry_wallets::WalletOpts;\nuse itertools::Either;\nuse regex::Regex;\nuse revm::context::TransactionType;\nuse std::{str::FromStr, sync::LazyLock};\nuse tempo_alloy::TempoNetwork;\n\n// matches override pattern
::\n// e.g. 0x123:0x1:0x1234\nstatic OVERRIDE_PATTERN: LazyLock =\n LazyLock::new(|| Regex::new(r\"^([^:]+):([^:]+):([^:]+)$\").unwrap());\n\n/// CLI arguments for `cast call`.\n///\n/// ## State Override Flags\n///\n/// The following flags can be used to override the state for the call:\n///\n/// * `--override-balance
:` - Override the balance of an account\n/// * `--override-nonce
:` - Override the nonce of an account\n/// * `--override-code
:` - Override the code of an account\n/// * `--override-state
::` - Override a storage slot of an account\n///\n/// Multiple overrides can be specified for the same account. For example:\n///\n/// ```bash\n/// cast call 0x... \"transfer(address,uint256)\" 0x... 100 \\\n/// --override-balance 0x123:0x1234 \\\n/// --override-nonce 0x123:1 \\\n/// --override-code 0x123:0x1234 \\\n/// --override-state 0x123:0x1:0x1234\n/// --override-state-diff 0x123:0x1:0x1234\n/// ```\n#[derive(Debug, Parser)]\npub struct CallArgs {\n /// The destination of the transaction.\n #[arg(value_parser = NameOrAddress::from_str)]\n to: Option,\n\n /// The signature of the function to call.\n sig: Option,\n\n /// The arguments of the function to call.\n #[arg(allow_negative_numbers = true)]\n args: Vec,\n\n /// Raw hex-encoded data for the transaction. Used instead of \\[SIG\\] and \\[ARGS\\].\n #[arg(\n long,\n conflicts_with_all = &[\"sig\", \"args\"]\n )]\n data: Option,\n\n /// Forks the remote rpc, executes the transaction locally and prints a trace\n #[arg(long, default_value_t = false)]\n trace: bool,\n\n /// Disables the labels in the traces.\n /// Can only be set with `--trace`.\n #[arg(long, default_value_t = false, requires = \"trace\")]\n disable_labels: bool,\n\n /// Opens an interactive debugger.\n /// Can only be used with `--trace`.\n #[arg(long, requires = \"trace\")]\n debug: bool,\n\n /// Identify internal functions in traces.\n ///\n /// This will trace internal functions and decode stack parameters.\n ///\n /// Parameters stored in memory (such as bytes or arrays) are currently decoded only when a\n /// single function is matched, similarly to `--debug`, for performance reasons.\n #[arg(long, requires = \"trace\")]\n decode_internal: bool,\n\n /// Labels to apply to the traces; format: `address:label`.\n /// Can only be used with `--trace`.\n #[arg(long, requires = \"trace\")]\n labels: Vec,\n\n /// The EVM Version to use.\n /// Can only be used with `--trace`.\n #[arg(long, requires = \"trace\")]\n evm_version: Option,\n\n /// The block height to query at.\n ///\n /// Can also be the tags earliest, finalized, safe, latest, or pending.\n #[arg(long, short)]\n block: Option,\n\n #[command(subcommand)]\n command: Option,\n\n #[command(flatten)]\n tx: TransactionOpts,\n\n #[command(flatten)]\n rpc: RpcOpts,\n\n #[command(flatten)]\n wallet: WalletOpts,\n\n #[arg(\n short,\n long,\n alias = \"chain-id\",\n env = \"CHAIN\",\n value_parser = ChainValueParser::default(),\n )]\n pub chain: Option,\n\n /// Use current project artifacts for trace decoding.\n #[arg(long, visible_alias = \"la\")]\n pub with_local_artifacts: bool,\n\n /// Override the accounts balance.\n /// Format: \"address:balance,address:balance\"\n #[arg(long = \"override-balance\", value_name = \"ADDRESS:BALANCE\", value_delimiter = ',')]\n pub balance_overrides: Option>,\n\n /// Override the accounts nonce.\n /// Format: \"address:nonce,address:nonce\"\n #[arg(long = \"override-nonce\", value_name = \"ADDRESS:NONCE\", value_delimiter = ',')]\n pub nonce_overrides: Option>,\n\n /// Override the accounts code.\n /// Format: \"address:code,address:code\"\n #[arg(long = \"override-code\", value_name = \"ADDRESS:CODE\", value_delimiter = ',')]\n pub code_overrides: Option>,\n\n /// Override the accounts state and replace the current state entirely with the new one.\n /// Format: \"address:slot:value,address:slot:value\"\n #[arg(long = \"override-state\", value_name = \"ADDRESS:SLOT:VALUE\", value_delimiter = ',')]\n pub state_overrides: Option>,\n\n /// Override the accounts state specific slots and preserve the rest of the state.\n /// Format: \"address:slot:value,address:slot:value\"\n #[arg(long = \"override-state-diff\", value_name = \"ADDRESS:SLOT:VALUE\", value_delimiter = ',')]\n pub state_diff_overrides: Option>,\n\n /// Override the block timestamp.\n #[arg(long = \"block.time\", value_name = \"TIME\")]\n pub block_time: Option,\n\n /// Override the block number.\n #[arg(long = \"block.number\", value_name = \"NUMBER\")]\n pub block_number: Option,\n}\n\n#[derive(Debug, Parser)]\npub enum CallSubcommands {\n /// ignores the address field and simulates creating a contract\n #[command(name = \"--create\")]\n Create {\n /// Bytecode of contract.\n code: String,\n\n /// The signature of the constructor.\n sig: Option,\n\n /// The arguments of the constructor.\n #[arg(allow_negative_numbers = true)]\n args: Vec,\n\n /// Ether to send in the transaction.\n ///\n /// Either specified in wei, or as a string with a unit type.\n ///\n /// Examples: 1ether, 10gwei, 0.01ether\n #[arg(long, value_parser = parse_ether_value)]\n value: Option,\n },\n}\n\nimpl CallArgs {\n pub async fn run(self) -> Result<()> {\n // Handle --curl mode early, before any provider interaction\n if self.rpc.curl {\n return self.run_curl().await;\n }\n if self.tx.tempo.is_tempo() {\n self.run_with_network::().await\n } else {\n self.run_with_network::().await\n }\n }\n\n pub async fn run_with_network(self) -> Result<()>\n where\n N::TransactionRequest: FoundryTransactionBuilder,\n {\n let figment = self.rpc.clone().into_figment(self.with_local_artifacts).merge(&self);\n let evm_opts = figment.extract::()?;\n let mut config = Config::from_provider(figment)?.sanitized();\n let state_overrides = self.get_state_overrides()?;\n let block_overrides = self.get_block_overrides()?;\n\n let Self {\n to,\n mut sig,\n mut args,\n mut tx,\n command,\n block,\n trace,\n evm_version,\n debug,\n decode_internal,\n labels,\n data,\n with_local_artifacts,\n disable_labels,\n wallet,\n ..\n } = self;\n\n if let Some(data) = data {\n sig = Some(data);\n }\n\n let provider = ProviderBuilder::::from_config(&config)?.build()?;\n let sender = SenderKind::from_wallet_opts(wallet).await?;\n let from = sender.address();\n\n let code = if let Some(CallSubcommands::Create {\n code,\n sig: create_sig,\n args: create_args,\n value,\n }) = command\n {\n sig = create_sig;\n args = create_args;\n if let Some(value) = value {\n tx.value = Some(value);\n }\n Some(code)\n } else {\n None\n };\n\n let (tx, func) = CastTxBuilder::new(&provider, tx, &config)\n .await?\n .with_to(to)\n .await?\n .with_code_sig_and_args(code, sig, args)\n .await?\n .raw()\n .build(sender)\n .await?;\n\n if trace {\n if let Some(BlockId::Number(BlockNumberOrTag::Number(block_number))) = self.block {\n // Override Config `fork_block_number` (if set) with CLI value.\n config.fork_block_number = Some(block_number);\n }\n\n let create2_deployer = evm_opts.create2_deployer;\n let (mut evm_env, tx_env, fork, chain, networks) =\n TracingExecutor::get_fork_material(&mut config, evm_opts).await?;\n\n // modify settings that usually set in eth_call\n evm_env.cfg_env.disable_block_gas_limit = true;\n evm_env.cfg_env.tx_gas_limit_cap = Some(u64::MAX);\n evm_env.block_env.gas_limit = u64::MAX;\n\n // Apply the block overrides.\n if let Some(block_overrides) = block_overrides {\n if let Some(number) = block_overrides.number {\n evm_env.block_env.number = number.to();\n }\n if let Some(time) = block_overrides.time {\n evm_env.block_env.timestamp = U256::from(time);\n }\n }\n\n let trace_mode = TraceMode::Call\n .with_debug(debug)\n .with_decode_internal(if decode_internal {\n InternalTraceMode::Full\n } else {\n InternalTraceMode::None\n })\n .with_state_changes(shell::verbosity() > 4);\n let mut executor = TracingExecutor::new(\n (evm_env, tx_env),\n fork,\n evm_version,\n trace_mode,\n networks,\n create2_deployer,\n state_overrides,\n )?;\n\n let value = tx.value().unwrap_or_default();\n let input = tx.input().cloned().unwrap_or_default();\n let tx_kind = tx.kind().expect(\"set by builder\");\n let env_tx = executor.tx_env_mut();\n\n // Set transaction options with --trace\n if let Some(gas_limit) = tx.gas_limit() {\n env_tx.gas_limit = gas_limit;\n }\n\n if let Some(gas_price) = tx.gas_price() {\n env_tx.gas_price = gas_price;\n }\n\n if let Some(max_fee_per_gas) = tx.max_fee_per_gas() {\n env_tx.gas_price = max_fee_per_gas;\n }\n\n if let Some(max_priority_fee_per_gas) = tx.max_priority_fee_per_gas() {\n env_tx.gas_priority_fee = Some(max_priority_fee_per_gas);\n }\n\n if let Some(max_fee_per_blob_gas) = tx.max_fee_per_blob_gas() {\n env_tx.max_fee_per_blob_gas = max_fee_per_blob_gas;\n }\n\n if let Some(nonce) = tx.nonce() {\n env_tx.nonce = nonce;\n }\n\n env_tx.tx_type = tx.output_tx_type().into();\n\n if let Some(access_list) = tx.access_list().cloned() {\n env_tx.access_list = access_list;\n\n if env_tx.tx_type == TransactionType::Legacy as u8 {\n env_tx.tx_type = TransactionType::Eip2930 as u8;\n }\n }\n\n if let Some(auth) = tx.authorization_list().cloned() {\n env_tx.authorization_list = auth.into_iter().map(Either::Left).collect();\n\n env_tx.tx_type = TransactionType::Eip7702 as u8;\n }\n\n let trace = match tx_kind {\n TxKind::Create => {\n let deploy_result = executor.deploy(from, input, value, None);\n TraceResult::try_from(deploy_result)?\n }\n TxKind::Call(to) => TraceResult::from_raw(\n executor.transact_raw(from, to, input, value)?,\n TraceKind::Execution,\n ),\n };\n\n let contracts_bytecode = fetch_contracts_bytecode_from_trace(&executor, &trace)?;\n handle_traces(\n trace,\n &config,\n chain,\n &contracts_bytecode,\n labels,\n with_local_artifacts,\n debug,\n decode_internal,\n disable_labels,\n None,\n )\n .await?;\n\n return Ok(());\n }\n\n let response = Cast::new(&provider)\n .call(&tx, func.as_ref(), block, state_overrides, block_overrides)\n .await?;\n\n if response == \"0x\"\n && let Some(contract_address) = tx.to()\n {\n let code = provider.get_code_at(contract_address).await?;\n if code.is_empty() {\n sh_warn!(\"Contract code is empty\")?;\n }\n }\n sh_println!(\"{}\", response)?;\n\n Ok(())\n }\n\n /// Handle --curl mode by generating curl command without any RPC interaction.\n async fn run_curl(self) -> Result<()> {\n let config = self.rpc.load_config()?;\n let url = config.get_rpc_url_or_localhost_http()?;\n let jwt = config.get_rpc_jwt_secret()?;\n\n // Get call data - either from --data or from sig + args\n let data = if let Some(data) = &self.data {\n hex::decode(data)?\n } else if let Some(sig) = &self.sig {\n // If sig is already hex data, use it directly\n if let Ok(data) = hex::decode(sig) {\n data\n } else {\n // Parse function signature and encode args\n let func = get_func(sig)?;\n encode_function_args(&func, &self.args)?\n }\n } else {\n Vec::new()\n };\n\n // Resolve the destination address (must be a raw address for curl mode)\n let to = self.to.as_ref().map(|n| match n {\n NameOrAddress::Address(addr) => Ok(*addr),\n NameOrAddress::Name(name) => {\n eyre::bail!(\"ENS names are not supported with --curl. Please use a raw address instead of '{}'\", name)\n }\n }).transpose()?;\n\n // Build eth_call params\n let call_object = serde_json::json!({\n \"to\": to,\n \"data\": format!(\"0x{}\", hex::encode(&data)),\n });\n\n let block_param = self\n .block\n .map(|b| serde_json::to_value(b).unwrap_or(serde_json::json!(\"latest\")))\n .unwrap_or(serde_json::json!(\"latest\"));\n\n let params = serde_json::json!([call_object, block_param]);\n\n let curl_cmd = generate_curl_command(\n url.as_ref(),\n \"eth_call\",\n params,\n config.eth_rpc_headers.as_deref(),\n jwt.as_deref(),\n );\n\n sh_println!(\"{}\", curl_cmd)?;\n Ok(())\n }\n\n /// Parse state overrides from command line arguments.\n pub fn get_state_overrides(&self) -> eyre::Result> {\n // Early return if no override set - \n if [\n self.balance_overrides.as_ref(),\n self.nonce_overrides.as_ref(),\n self.code_overrides.as_ref(),\n self.state_overrides.as_ref(),\n self.state_diff_overrides.as_ref(),\n ]\n .iter()\n .all(Option::is_none)\n {\n return Ok(None);\n }\n\n let mut state_overrides_builder = StateOverridesBuilder::default();\n\n // Parse balance overrides\n for override_str in self.balance_overrides.iter().flatten() {\n let (addr, balance) = address_value_override(override_str)?;\n state_overrides_builder =\n state_overrides_builder.with_balance(addr.parse()?, balance.parse()?);\n }\n\n // Parse nonce overrides\n for override_str in self.nonce_overrides.iter().flatten() {\n let (addr, nonce) = address_value_override(override_str)?;\n state_overrides_builder =\n state_overrides_builder.with_nonce(addr.parse()?, nonce.parse()?);\n }\n\n // Parse code overrides\n for override_str in self.code_overrides.iter().flatten() {\n let (addr, code_str) = address_value_override(override_str)?;\n state_overrides_builder =\n state_overrides_builder.with_code(addr.parse()?, Bytes::from_str(code_str)?);\n }\n\n type StateOverrides = HashMap>;\n let parse_state_overrides =\n |overrides: &Option>| -> Result {\n let mut state_overrides: StateOverrides = StateOverrides::default();\n\n overrides.iter().flatten().try_for_each(|s| -> Result<(), eyre::Report> {\n let (addr, slot, value) = address_slot_value_override(s)?;\n state_overrides.entry(addr).or_default().insert(slot.into(), value.into());\n Ok(())\n })?;\n\n Ok(state_overrides)\n };\n\n // Parse and apply state overrides\n for (addr, entries) in parse_state_overrides(&self.state_overrides)? {\n state_overrides_builder = state_overrides_builder.with_state(addr, entries);\n }\n\n // Parse and apply state diff overrides\n for (addr, entries) in parse_state_overrides(&self.state_diff_overrides)? {\n state_overrides_builder = state_overrides_builder.with_state_diff(addr, entries)\n }\n\n Ok(Some(state_overrides_builder.build()))\n }\n\n /// Parse block overrides from command line arguments.\n pub fn get_block_overrides(&self) -> eyre::Result> {\n let mut overrides = BlockOverrides::default();\n if let Some(number) = self.block_number {\n overrides = overrides.with_number(U256::from(number));\n }\n if let Some(time) = self.block_time {\n overrides = overrides.with_time(time);\n }\n if overrides.is_empty() { Ok(None) } else { Ok(Some(overrides)) }\n }\n}\n\nimpl figment::Provider for CallArgs {\n fn metadata(&self) -> Metadata {\n Metadata::named(\"CallArgs\")\n }\n\n fn data(&self) -> Result, figment::Error> {\n let mut map = Map::new();\n\n if let Some(evm_version) = self.evm_version {\n map.insert(\"evm_version\".into(), figment::value::Value::serialize(evm_version)?);\n }\n\n Ok(Map::from([(Config::selected_profile(), map)]))\n }\n}\n\n/// Parse an override string in the format address:value.\nfn address_value_override(address_override: &str) -> Result<(&str, &str)> {\n address_override.split_once(':').ok_or_else(|| {\n eyre::eyre!(\"Invalid override {address_override}. Expected
:\")\n })\n}\n\n/// Parse an override string in the format address:slot:value.\nfn address_slot_value_override(address_override: &str) -> Result<(Address, U256, U256)> {\n let captures = OVERRIDE_PATTERN.captures(address_override).ok_or_else(|| {\n eyre::eyre!(\"Invalid override {address_override}. Expected
::\")\n })?;\n\n Ok((\n captures[1].parse()?, // Address\n captures[2].parse()?, // Slot (U256)\n captures[3].parse()?, // Value (U256)\n ))\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n use alloy_primitives::{U64, address, b256, fixed_bytes};\n\n #[test]\n fn test_get_state_overrides() {\n let call_args = CallArgs::parse_from([\n \"foundry-cli\",\n \"--override-balance\",\n \"0x0000000000000000000000000000000000000001:2\",\n \"--override-nonce\",\n \"0x0000000000000000000000000000000000000001:3\",\n \"--override-code\",\n \"0x0000000000000000000000000000000000000001:0x04\",\n \"--override-state\",\n \"0x0000000000000000000000000000000000000001:5:6\",\n \"--override-state-diff\",\n \"0x0000000000000000000000000000000000000001:7:8\",\n ]);\n let overrides = call_args.get_state_overrides().unwrap().unwrap();\n let address = address!(\"0x0000000000000000000000000000000000000001\");\n if let Some(account_override) = overrides.get(&address) {\n if let Some(balance) = account_override.balance {\n assert_eq!(balance, U256::from(2));\n }\n if let Some(nonce) = account_override.nonce {\n assert_eq!(nonce, 3);\n }\n if let Some(code) = &account_override.code {\n assert_eq!(*code, Bytes::from([0x04]));\n }\n if let Some(state) = &account_override.state\n && let Some(value) = state.get(&b256!(\n \"0x0000000000000000000000000000000000000000000000000000000000000005\"\n ))\n {\n assert_eq!(\n *value,\n b256!(\"0x0000000000000000000000000000000000000000000000000000000000000006\")\n );\n }\n if let Some(state_diff) = &account_override.state_diff\n && let Some(value) = state_diff.get(&b256!(\n \"0x0000000000000000000000000000000000000000000000000000000000000007\"\n ))\n {\n assert_eq!(\n *value,\n b256!(\"0x0000000000000000000000000000000000000000000000000000000000000008\")\n );\n }\n }\n }\n\n #[test]\n fn test_get_state_overrides_empty() {\n let call_args = CallArgs::parse_from([\"\"]);\n let overrides = call_args.get_state_overrides().unwrap();\n assert_eq!(overrides, None);\n }\n\n #[test]\n fn test_get_block_overrides() {\n let mut call_args = CallArgs::parse_from([\"\"]);\n call_args.block_number = Some(1);\n call_args.block_time = Some(2);\n let overrides = call_args.get_block_overrides().unwrap().unwrap();\n assert_eq!(overrides.number, Some(U256::from(1)));\n assert_eq!(overrides.time, Some(2));\n }\n\n #[test]\n fn test_get_block_overrides_empty() {\n let call_args = CallArgs::parse_from([\"\"]);\n let overrides = call_args.get_block_overrides().unwrap();\n assert_eq!(overrides, None);\n }\n\n #[test]\n fn test_address_value_override_success() {\n let text = \"0x0000000000000000000000000000000000000001:2\";\n let (address, value) = address_value_override(text).unwrap();\n assert_eq!(address, \"0x0000000000000000000000000000000000000001\");\n assert_eq!(value, \"2\");\n }\n\n #[test]\n fn test_address_value_override_error() {\n let text = \"invalid_value\";\n let error = address_value_override(text).unwrap_err();\n assert_eq!(error.to_string(), \"Invalid override invalid_value. Expected
:\");\n }\n\n #[test]\n fn test_address_slot_value_override_success() {\n let text = \"0x0000000000000000000000000000000000000001:2:3\";\n let (address, slot, value) = address_slot_value_override(text).unwrap();\n assert_eq!(*address, fixed_bytes!(\"0x0000000000000000000000000000000000000001\"));\n assert_eq!(slot, U256::from(2));\n assert_eq!(value, U256::from(3));\n }\n\n #[test]\n fn test_address_slot_value_override_error() {\n let text = \"invalid_value\";\n let error = address_slot_value_override(text).unwrap_err();\n assert_eq!(\n error.to_string(),\n \"Invalid override invalid_value. Expected
::\"\n );\n }\n\n #[test]\n fn can_parse_call_data() {\n let data = hex::encode(\"hello\");\n let args = CallArgs::parse_from([\"foundry-cli\", \"--data\", data.as_str()]);\n assert_eq!(args.data, Some(data));\n\n let data = hex::encode_prefixed(\"hello\");\n let args = CallArgs::parse_from([\"foundry-cli\", \"--data\", data.as_str()]);\n assert_eq!(args.data, Some(data));\n }\n\n #[test]\n fn can_parse_state_overrides() {\n let args = CallArgs::parse_from([\n \"foundry-cli\",\n \"--override-balance\",\n \"0x123:0x1234\",\n \"--override-nonce\",\n \"0x123:1\",\n \"--override-code\",\n \"0x123:0x1234\",\n \"--override-state\",\n \"0x123:0x1:0x1234\",\n ]);\n\n assert_eq!(args.balance_overrides, Some(vec![\"0x123:0x1234\".to_string()]));\n assert_eq!(args.nonce_overrides, Some(vec![\"0x123:1\".to_string()]));\n assert_eq!(args.code_overrides, Some(vec![\"0x123:0x1234\".to_string()]));\n assert_eq!(args.state_overrides, Some(vec![\"0x123:0x1:0x1234\".to_string()]));\n }\n\n #[test]\n fn can_parse_multiple_state_overrides() {\n let args = CallArgs::parse_from([\n \"foundry-cli\",\n \"--override-balance\",\n \"0x123:0x1234\",\n \"--override-balance\",\n \"0x456:0x5678\",\n \"--override-nonce\",\n \"0x123:1\",\n \"--override-nonce\",\n \"0x456:2\",\n \"--override-code\",\n \"0x123:0x1234\",\n \"--override-code\",\n \"0x456:0x5678\",\n \"--override-state\",\n \"0x123:0x1:0x1234\",\n \"--override-state\",\n \"0x456:0x2:0x5678\",\n ]);\n\n assert_eq!(\n args.balance_overrides,\n Some(vec![\"0x123:0x1234\".to_string(), \"0x456:0x5678\".to_string()])\n );\n assert_eq!(args.nonce_overrides, Some(vec![\"0x123:1\".to_string(), \"0x456:2\".to_string()]));\n assert_eq!(\n args.code_overrides,\n Some(vec![\"0x123:0x1234\".to_string(), \"0x456:0x5678\".to_string()])\n );\n assert_eq!(\n args.state_overrides,\n Some(vec![\"0x123:0x1:0x1234\".to_string(), \"0x456:0x2:0x5678\".to_string()])\n );\n }\n\n #[test]\n fn test_negative_args_with_flags() {\n // Test that negative args work with flags\n let args = CallArgs::parse_from([\n \"foundry-cli\",\n \"--trace\",\n \"0xDeaDBeeFcAfEbAbEfAcEfEeDcBaDbEeFcAfEbAbE\",\n \"process(int256)\",\n \"-999999\",\n \"--debug\",\n ]);\n\n assert!(args.trace);\n assert!(args.debug);\n assert_eq!(args.args, vec![\"-999999\"]);\n }\n\n #[test]\n fn test_transaction_opts_with_trace() {\n // Test that transaction options are correctly parsed when using --trace\n let args = CallArgs::parse_from([\n \"foundry-cli\",\n \"--trace\",\n \"--gas-limit\",\n \"1000000\",\n \"--gas-price\",\n \"20000000000\",\n \"--priority-gas-price\",\n \"2000000000\",\n \"--nonce\",\n \"42\",\n \"--value\",\n \"1000000000000000000\", // 1 ETH\n \"--blob-gas-price\",\n \"10000000000\",\n \"0xDeaDBeeFcAfEbAbEfAcEfEeDcBaDbEeFcAfEbAbE\",\n \"balanceOf(address)\",\n \"0x123456789abcdef123456789abcdef123456789a\",\n ]);\n\n assert!(args.trace);\n assert_eq!(args.tx.gas_limit, Some(U256::from(1000000u32)));\n assert_eq!(args.tx.gas_price, Some(U256::from(20000000000u64)));\n assert_eq!(args.tx.priority_gas_price, Some(U256::from(2000000000u64)));\n assert_eq!(args.tx.nonce, Some(U64::from(42)));\n assert_eq!(args.tx.value, Some(U256::from(1000000000000000000u64)));\n assert_eq!(args.tx.blob_gas_price, Some(U256::from(10000000000u64)));\n }\n}\n" }, { "path": "crates/cast/src/cmd/constructor_args.rs", "content": "use super::{creation_code::fetch_creation_code_from_etherscan, interface::load_abi_from_file};\nuse alloy_dyn_abi::DynSolType;\nuse alloy_primitives::{Address, Bytes};\nuse alloy_provider::Provider;\nuse clap::Parser;\nuse eyre::{OptionExt, Result, eyre};\nuse foundry_cli::{\n opts::{EtherscanOpts, RpcOpts},\n utils::{self, LoadConfig, fetch_abi_from_etherscan},\n};\nuse foundry_config::Config;\n\nfoundry_config::impl_figment_convert!(ConstructorArgsArgs, etherscan, rpc);\n\n/// CLI arguments for `cast creation-args`.\n#[derive(Parser)]\npub struct ConstructorArgsArgs {\n /// An Ethereum address, for which the bytecode will be fetched.\n contract: Address,\n\n /// Path to file containing the contract's JSON ABI. It's necessary if the target contract is\n /// not verified on Etherscan\n #[arg(long)]\n abi_path: Option,\n\n #[command(flatten)]\n etherscan: EtherscanOpts,\n\n #[command(flatten)]\n rpc: RpcOpts,\n}\n\nimpl ConstructorArgsArgs {\n pub async fn run(self) -> Result<()> {\n let mut config = self.load_config()?;\n\n let Self { contract, abi_path, etherscan: _, rpc: _ } = self;\n\n let provider = utils::get_provider(&config)?;\n config.chain = Some(provider.get_chain_id().await?.into());\n\n let bytecode = fetch_creation_code_from_etherscan(contract, &config, provider).await?;\n\n let args_arr = parse_constructor_args(bytecode, contract, &config, abi_path).await?;\n for arg in args_arr {\n let _ = sh_println!(\"{arg}\");\n }\n\n Ok(())\n }\n}\n\n/// Fetches the constructor arguments values and types from the creation bytecode and ABI.\nasync fn parse_constructor_args(\n bytecode: Bytes,\n contract: Address,\n config: &Config,\n abi_path: Option,\n) -> Result> {\n let abi = if let Some(abi_path) = abi_path {\n load_abi_from_file(&abi_path, None)?\n } else {\n fetch_abi_from_etherscan(contract, config).await?\n };\n\n let abi = abi.into_iter().next().ok_or_eyre(\"No ABI found.\")?;\n let (abi, _) = abi;\n\n let constructor = abi.constructor.ok_or_else(|| eyre!(\"No constructor found.\"))?;\n\n if constructor.inputs.is_empty() {\n return Err(eyre!(\"No constructor arguments found.\"));\n }\n\n let args_size = constructor.inputs.len() * 32;\n if bytecode.len() < args_size {\n return Err(eyre!(\n \"Invalid creation bytecode length: have {} bytes, need at least {} for {} constructor inputs\",\n bytecode.len(),\n args_size,\n constructor.inputs.len()\n ));\n }\n let args_bytes = Bytes::from(bytecode[bytecode.len() - args_size..].to_vec());\n\n let display_args: Vec = args_bytes\n .chunks(32)\n .enumerate()\n .map(|(i, arg)| format_arg(&constructor.inputs[i].ty, arg))\n .collect::>>()?;\n\n Ok(display_args)\n}\n\nfn format_arg(ty: &str, arg: &[u8]) -> Result {\n let arg_type: DynSolType = ty.parse()?;\n let decoded = arg_type.abi_decode(arg)?;\n let bytes = Bytes::from(arg.to_vec());\n\n Ok(format!(\"{bytes} ā†’ {decoded:?}\"))\n}\n" }, { "path": "crates/cast/src/cmd/create2.rs", "content": "use alloy_primitives::{Address, B256, U256, hex, keccak256};\nuse clap::Parser;\nuse eyre::{Result, WrapErr};\nuse rand::{RngCore, SeedableRng, rngs::StdRng};\nuse regex::RegexSetBuilder;\nuse std::{\n sync::{\n Arc,\n atomic::{AtomicBool, Ordering},\n },\n time::Instant,\n};\n\n// https://etherscan.io/address/0x4e59b44847b379578588920ca78fbf26c0b4956c#code\nconst DEPLOYER: &str = \"0x4e59b44847b379578588920ca78fbf26c0b4956c\";\n\n/// CLI arguments for `cast create2`.\n#[derive(Clone, Debug, Parser)]\npub struct Create2Args {\n /// Prefix for the contract address.\n #[arg(\n long,\n short,\n required_unless_present_any = &[\"ends_with\", \"matching\", \"salt\"],\n value_name = \"HEX\"\n )]\n starts_with: Option,\n\n /// Suffix for the contract address.\n #[arg(long, short, value_name = \"HEX\")]\n ends_with: Option,\n\n /// Sequence that the address has to match.\n #[arg(long, short, value_name = \"HEX\")]\n matching: Option,\n\n /// Case sensitive matching.\n #[arg(short, long)]\n case_sensitive: bool,\n\n /// Address of the contract deployer.\n #[arg(\n short,\n long,\n default_value = DEPLOYER,\n value_name = \"ADDRESS\"\n )]\n deployer: Address,\n\n /// Salt to be used for the contract deployment. This option separate from the default salt\n /// mining with filters.\n #[arg(\n long,\n conflicts_with_all = [\n \"starts_with\",\n \"ends_with\",\n \"matching\",\n \"case_sensitive\",\n \"caller\",\n \"seed\",\n \"no_random\"\n ],\n value_name = \"HEX\"\n )]\n salt: Option,\n\n /// Init code of the contract to be deployed.\n #[arg(short, long, value_name = \"HEX\")]\n init_code: Option,\n\n /// Init code hash of the contract to be deployed.\n #[arg(alias = \"ch\", long, value_name = \"HASH\", required_unless_present = \"init_code\")]\n init_code_hash: Option,\n\n /// Number of threads to use. Specifying 0 defaults to the number of logical cores.\n #[arg(global = true, long, short = 'j', visible_alias = \"jobs\")]\n threads: Option,\n\n /// Address of the caller. Used for the first 20 bytes of the salt.\n #[arg(long, value_name = \"ADDRESS\")]\n caller: Option
,\n\n /// The random number generator's seed, used to initialize the salt.\n #[arg(long, value_name = \"HEX\")]\n seed: Option,\n\n /// Don't initialize the salt with a random value, and instead use the default value of 0.\n #[arg(long, conflicts_with = \"seed\")]\n no_random: bool,\n}\n\npub struct Create2Output {\n pub address: Address,\n pub salt: B256,\n}\n\nimpl Create2Args {\n pub fn run(self) -> Result {\n let Self {\n starts_with,\n ends_with,\n matching,\n case_sensitive,\n deployer,\n salt,\n init_code,\n init_code_hash,\n threads,\n caller,\n seed,\n no_random,\n } = self;\n\n let init_code_hash = if let Some(init_code_hash) = init_code_hash {\n hex::FromHex::from_hex(init_code_hash)\n } else if let Some(init_code) = init_code {\n hex::decode(init_code).map(keccak256)\n } else {\n unreachable!();\n }?;\n\n if let Some(salt) = salt {\n let salt = hex::FromHex::from_hex(salt)?;\n let address = deployer.create2(salt, init_code_hash);\n sh_println!(\"{address}\")?;\n return Ok(Create2Output { address, salt });\n }\n\n let mut regexs = vec![];\n\n if let Some(matches) = matching {\n if starts_with.is_some() || ends_with.is_some() {\n eyre::bail!(\"Either use --matching or --starts/ends-with\");\n }\n\n let matches = matches.trim_start_matches(\"0x\");\n\n if matches.len() != 40 {\n eyre::bail!(\"Please provide a 40 characters long sequence for matching\");\n }\n\n hex::decode(matches.replace('X', \"0\")).wrap_err(\"invalid matching hex provided\")?;\n // replacing X placeholders by . to match any character at these positions\n\n regexs.push(matches.replace('X', \".\"));\n }\n\n if let Some(prefix) = starts_with {\n regexs.push(format!(\n r\"^{}\",\n get_regex_hex_string(prefix).wrap_err(\"invalid prefix hex provided\")?\n ));\n }\n if let Some(suffix) = ends_with {\n regexs.push(format!(\n r\"{}$\",\n get_regex_hex_string(suffix).wrap_err(\"invalid suffix hex provided\")?\n ))\n }\n\n debug_assert!(\n regexs.iter().map(|p| p.len() - 1).sum::() <= 40,\n \"vanity patterns length exceeded. cannot be more than 40 characters\",\n );\n\n let regex = RegexSetBuilder::new(regexs).case_insensitive(!case_sensitive).build()?;\n\n let mut n_threads = threads.unwrap_or(0);\n if n_threads == 0 {\n n_threads = std::thread::available_parallelism().map_or(1, |n| n.get());\n }\n if cfg!(test) {\n n_threads = n_threads.min(2);\n }\n\n let mut salt = B256::ZERO;\n let remaining = if let Some(caller_address) = caller {\n salt[..20].copy_from_slice(&caller_address.into_array());\n &mut salt[20..]\n } else {\n &mut salt[..]\n };\n\n if !no_random {\n let mut rng = match seed {\n Some(seed) => StdRng::from_seed(seed.0),\n None => StdRng::from_os_rng(),\n };\n rng.fill_bytes(remaining);\n }\n\n sh_println!(\"Configuration:\")?;\n sh_println!(\"Init code hash: {init_code_hash}\")?;\n sh_println!(\"Regex patterns: {:?}\\n\", regex.patterns())?;\n sh_println!(\n \"Starting to generate deterministic contract address with {n_threads} threads...\"\n )?;\n let mut handles = Vec::with_capacity(n_threads);\n let found = Arc::new(AtomicBool::new(false));\n let timer = Instant::now();\n\n // Loops through all possible salts in parallel until a result is found.\n // Each thread iterates over `(i..).step_by(n_threads)`.\n for i in 0..n_threads {\n // Create local copies for the thread.\n let increment = n_threads;\n let regex = regex.clone();\n let regex_len = regex.patterns().len();\n let found = Arc::clone(&found);\n handles.push(std::thread::spawn(move || {\n // Read the first bytes of the salt as a usize to be able to increment it.\n struct B256Aligned(B256, [usize; 0]);\n let mut salt = B256Aligned(salt, []);\n // SAFETY: B256 is aligned to `usize`.\n let salt_word = unsafe {\n &mut *salt.0.as_mut_ptr().add(32 - usize::BITS as usize / 8).cast::()\n };\n // Important: add the thread index to the salt to avoid duplicate results.\n *salt_word = salt_word.wrapping_add(i);\n\n // Use checksum format only when case_sensitive is enabled.\n // This avoids an extra keccak256 call per iteration when not needed.\n let mut checksum_buf = [0u8; 42];\n let mut hex_buf = [0u8; 40];\n loop {\n // Stop if a result was found in another thread.\n if found.load(Ordering::Relaxed) {\n break None;\n }\n\n // Calculate the `CREATE2` address.\n #[expect(clippy::needless_borrows_for_generic_args)]\n let addr = deployer.create2(&salt.0, &init_code_hash);\n\n // Check if the regex matches the calculated address.\n // When case_sensitive is true, use EIP-55 checksum format (requires keccak256).\n // Otherwise, use lowercase hex to avoid the extra hash computation.\n let s = if case_sensitive {\n let _ = addr.to_checksum_raw(&mut checksum_buf, None);\n // SAFETY: stripping 2 ASCII bytes (\"0x\") off of an already valid UTF-8\n // string is safe.\n unsafe { std::str::from_utf8_unchecked(checksum_buf.get_unchecked(2..)) }\n } else {\n // SAFETY: hex::encode_to_slice always produces valid UTF-8 (hex digits).\n let _ = hex::encode_to_slice(addr.as_slice(), &mut hex_buf);\n unsafe { std::str::from_utf8_unchecked(&hex_buf) }\n };\n if regex.matches(s).into_iter().count() == regex_len {\n // Notify other threads that we found a result.\n found.store(true, Ordering::Relaxed);\n break Some((addr, salt.0));\n }\n\n // Increment the salt for the next iteration.\n *salt_word = salt_word.wrapping_add(increment);\n }\n }));\n }\n\n let results = handles.into_iter().filter_map(|h| h.join().unwrap()).collect::>();\n let (address, salt) = results.into_iter().next().unwrap();\n sh_println!(\"Successfully found contract address in {:?}\", timer.elapsed())?;\n sh_println!(\"Address: {address}\")?;\n sh_println!(\"Salt: {salt} ({})\", U256::from_be_bytes(salt.0))?;\n\n Ok(Create2Output { address, salt })\n }\n}\n\nfn get_regex_hex_string(s: String) -> Result {\n let s = s.strip_prefix(\"0x\").unwrap_or(&s);\n let pad_width = s.len() + s.len() % 2;\n hex::decode(format!(\"{s:0,\n\n /// Disassemble bytecodes into individual opcodes.\n #[arg(long)]\n disassemble: bool,\n\n /// Return creation bytecode without constructor arguments appended.\n #[arg(long, conflicts_with = \"only_args\")]\n without_args: bool,\n\n /// Return only constructor arguments.\n #[arg(long)]\n only_args: bool,\n\n #[command(flatten)]\n etherscan: EtherscanOpts,\n\n #[command(flatten)]\n rpc: RpcOpts,\n}\n\nimpl CreationCodeArgs {\n pub async fn run(self) -> Result<()> {\n let mut config = self.load_config()?;\n\n let Self { contract, disassemble, without_args, only_args, abi_path, etherscan: _, rpc: _ } =\n self;\n\n let provider = utils::get_provider(&config)?;\n let chain = provider.get_chain_id().await?;\n config.chain = Some(chain.into());\n\n let bytecode = fetch_creation_code_from_etherscan(contract, &config, provider).await?;\n\n let bytecode = parse_code_output(\n bytecode,\n contract,\n &config,\n abi_path.as_deref(),\n without_args,\n only_args,\n )\n .await?;\n\n if disassemble {\n let _ = sh_println!(\"{}\", SimpleCast::disassemble(&bytecode)?);\n } else {\n let _ = sh_println!(\"{bytecode}\");\n }\n\n Ok(())\n }\n}\n\n/// Parses the creation bytecode and returns one of the following:\n/// - The complete bytecode\n/// - The bytecode without constructor arguments\n/// - Only the constructor arguments\npub async fn parse_code_output(\n bytecode: Bytes,\n contract: Address,\n config: &Config,\n abi_path: Option<&str>,\n without_args: bool,\n only_args: bool,\n) -> Result {\n if !without_args && !only_args {\n return Ok(bytecode);\n }\n\n let abi = if let Some(abi_path) = abi_path {\n load_abi_from_file(abi_path, None)?\n } else {\n fetch_abi_from_etherscan(contract, config).await?\n };\n\n let abi = abi.into_iter().next().ok_or_eyre(\"No ABI found.\")?;\n let (abi, _) = abi;\n\n if abi.constructor.is_none() {\n if only_args {\n return Err(eyre!(\"No constructor found.\"));\n }\n return Ok(bytecode);\n }\n\n let constructor = abi.constructor.unwrap();\n if constructor.inputs.is_empty() {\n if only_args {\n return Err(eyre!(\"No constructor arguments found.\"));\n }\n return Ok(bytecode);\n }\n\n let args_size = constructor.inputs.len() * 32;\n\n let bytecode = if without_args {\n Bytes::from(bytecode[..bytecode.len() - args_size].to_vec())\n } else if only_args {\n Bytes::from(bytecode[bytecode.len() - args_size..].to_vec())\n } else {\n unreachable!();\n };\n\n Ok(bytecode)\n}\n\n/// Fetches the creation code of a contract from Etherscan and RPC.\npub async fn fetch_creation_code_from_etherscan(\n contract: Address,\n config: &Config,\n provider: RootProvider,\n) -> Result {\n let chain = config.chain.unwrap_or_default();\n let api_key = config.get_etherscan_api_key(Some(chain)).unwrap_or_default();\n let client = Client::new(chain, api_key)?;\n let creation_data = client.contract_creation_data(contract).await?;\n let creation_tx_hash = creation_data.transaction_hash;\n let tx_data = provider.get_transaction_by_hash(creation_tx_hash).await?;\n let tx_data = tx_data.ok_or_eyre(\"Could not find creation tx data.\")?;\n\n let bytecode = if tx_data.to().is_none() {\n // Contract was created using a standard transaction\n tx_data.input().clone()\n } else {\n // Contract was created using a factory pattern or create2\n // Extract creation code from tx traces\n let mut creation_bytecode = None;\n\n let traces = provider.trace_transaction(creation_tx_hash).await.map_err(|e| {\n eyre!(\"Could not fetch traces for transaction {}: {}\", creation_tx_hash, e)\n })?;\n\n for trace in traces {\n if let Some(TraceOutput::Create(CreateOutput { address, .. })) = trace.trace.result\n && address == contract\n {\n creation_bytecode = match trace.trace.action {\n Action::Create(CreateAction { init, .. }) => Some(init),\n _ => None,\n };\n }\n }\n\n creation_bytecode.ok_or_else(|| eyre!(\"Could not find contract creation trace.\"))?\n };\n\n Ok(bytecode)\n}\n" }, { "path": "crates/cast/src/cmd/da_estimate.rs", "content": "//! Estimates the data availability size of a block for opstack.\n\nuse alloy_consensus::BlockHeader;\nuse alloy_network::eip2718::Encodable2718;\nuse alloy_provider::Provider;\nuse alloy_rpc_types::BlockId;\nuse clap::Parser;\nuse foundry_cli::{\n opts::RpcOpts,\n utils::{self, LoadConfig},\n};\nuse foundry_primitives::FoundryTxEnvelope;\n\n/// CLI arguments for `cast da-estimate`.\n#[derive(Debug, Parser)]\npub struct DAEstimateArgs {\n /// The block to estimate the data availability size for.\n pub block: BlockId,\n #[command(flatten)]\n pub rpc: RpcOpts,\n}\n\nimpl DAEstimateArgs {\n /// Load the RPC URL from the config file.\n pub async fn run(self) -> eyre::Result<()> {\n let Self { block, rpc } = self;\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n let block = provider\n .get_block(block)\n .full()\n .await?\n .ok_or_else(|| eyre::eyre!(\"Block not found\"))?;\n\n let block_number = block.header.number();\n let tx_count = block.transactions.len();\n let mut da_estimate = 0;\n for tx in block.into_transactions_iter() {\n // convert into FoundryTxEnvelope to support all foundry tx types\n let tx = FoundryTxEnvelope::try_from(tx)?;\n da_estimate += op_alloy_flz::tx_estimated_size_fjord(&tx.encoded_2718());\n }\n\n sh_println!(\n \"Estimated data availability size for block {block_number} with {tx_count} transactions: {da_estimate}\"\n )?;\n\n Ok(())\n }\n}\n" }, { "path": "crates/cast/src/cmd/erc20.rs", "content": "use std::{str::FromStr, time::Duration};\n\nuse crate::{cmd::send::cast_send, format_uint_exp, tx::SendTxOpts};\nuse alloy_consensus::{SignableTransaction, Signed};\nuse alloy_eips::BlockId;\nuse alloy_ens::NameOrAddress;\nuse alloy_network::{AnyNetwork, EthereumWallet, Network, TransactionBuilder};\nuse alloy_primitives::{U64, U256};\nuse alloy_provider::{Provider, fillers::RecommendedFillers};\nuse alloy_signer::Signature;\nuse alloy_sol_types::sol;\nuse clap::{Args, Parser};\nuse foundry_cli::{\n opts::{RpcOpts, TempoOpts},\n utils::{LoadConfig, get_chain, get_provider},\n};\nuse foundry_common::{\n fmt::{UIfmt, UIfmtReceiptExt},\n provider::{ProviderBuilder, RetryProviderWithSigner},\n shell,\n};\n#[doc(hidden)]\npub use foundry_config::{Chain, utils::*};\nuse foundry_primitives::FoundryTransactionBuilder;\nuse tempo_alloy::TempoNetwork;\n\nsol! {\n #[sol(rpc)]\n interface IERC20 {\n #[derive(Debug)]\n function name() external view returns (string);\n function symbol() external view returns (string);\n function decimals() external view returns (uint8);\n function totalSupply() external view returns (uint256);\n function balanceOf(address owner) external view returns (uint256);\n function transfer(address to, uint256 amount) external returns (bool);\n function approve(address spender, uint256 amount) external returns (bool);\n function allowance(address owner, address spender) external view returns (uint256);\n function mint(address to, uint256 amount) external;\n function burn(uint256 amount) external;\n }\n}\n\n/// Transaction options for ERC20 operations.\n///\n/// This struct contains only the transaction options relevant to ERC20 token interactions\n#[derive(Debug, Clone, Args)]\npub struct Erc20TxOpts {\n /// Gas limit for the transaction.\n #[arg(long, env = \"ETH_GAS_LIMIT\")]\n pub gas_limit: Option,\n\n /// Gas price for legacy transactions, or max fee per gas for EIP1559 transactions.\n #[arg(long, env = \"ETH_GAS_PRICE\")]\n pub gas_price: Option,\n\n /// Max priority fee per gas for EIP1559 transactions.\n #[arg(long, env = \"ETH_PRIORITY_GAS_PRICE\")]\n pub priority_gas_price: Option,\n\n /// Nonce for the transaction.\n #[arg(long)]\n pub nonce: Option,\n\n #[command(flatten)]\n pub tempo: TempoOpts,\n}\n\n/// Creates a provider with wallet for signing transactions locally.\npub(crate) async fn get_provider_with_wallet(\n tx_opts: &SendTxOpts,\n) -> eyre::Result>\nwhere\n N::TxEnvelope: From>,\n N::UnsignedTx: SignableTransaction,\n{\n let config = tx_opts.eth.load_config()?;\n let signer = tx_opts.eth.wallet.signer().await?;\n let wallet = EthereumWallet::from(signer);\n let provider = ProviderBuilder::::from_config(&config)?.build_with_wallet(wallet)?;\n if let Some(interval) = tx_opts.poll_interval {\n provider.client().set_poll_interval(Duration::from_secs(interval))\n }\n Ok(provider)\n}\n\nimpl Erc20TxOpts {\n /// Applies gas, fee, nonce, and Tempo options to a transaction request.\n fn apply(&self, tx: &mut N::TransactionRequest, legacy: bool)\n where\n N::TransactionRequest: FoundryTransactionBuilder,\n {\n if let Some(gas_limit) = self.gas_limit {\n tx.set_gas_limit(gas_limit.to());\n }\n\n if let Some(gas_price) = self.gas_price {\n if legacy {\n tx.set_gas_price(gas_price.to());\n } else {\n tx.set_max_fee_per_gas(gas_price.to());\n }\n }\n\n if !legacy && let Some(priority_fee) = self.priority_gas_price {\n tx.set_max_priority_fee_per_gas(priority_fee.to());\n }\n\n self.tempo.apply::(tx, self.nonce.map(|n| n.to()));\n }\n}\n\n/// Interact with ERC20 tokens.\n#[derive(Debug, Parser, Clone)]\npub enum Erc20Subcommand {\n /// Query ERC20 token balance.\n #[command(visible_alias = \"b\")]\n Balance {\n /// The ERC20 token contract address.\n #[arg(value_parser = NameOrAddress::from_str)]\n token: NameOrAddress,\n\n /// The owner to query balance for.\n #[arg(value_parser = NameOrAddress::from_str)]\n owner: NameOrAddress,\n\n /// The block height to query at.\n #[arg(long, short = 'B')]\n block: Option,\n\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Transfer ERC20 tokens.\n #[command(visible_aliases = [\"t\", \"send\"])]\n Transfer {\n /// The ERC20 token contract address.\n #[arg(value_parser = NameOrAddress::from_str)]\n token: NameOrAddress,\n\n /// The recipient address.\n #[arg(value_parser = NameOrAddress::from_str)]\n to: NameOrAddress,\n\n /// The amount to transfer.\n amount: String,\n\n #[command(flatten)]\n send_tx: SendTxOpts,\n\n #[command(flatten)]\n tx: Erc20TxOpts,\n },\n\n /// Approve ERC20 token spending.\n #[command(visible_alias = \"a\")]\n Approve {\n /// The ERC20 token contract address.\n #[arg(value_parser = NameOrAddress::from_str)]\n token: NameOrAddress,\n\n /// The spender address.\n #[arg(value_parser = NameOrAddress::from_str)]\n spender: NameOrAddress,\n\n /// The amount to approve.\n amount: String,\n\n #[command(flatten)]\n send_tx: SendTxOpts,\n\n #[command(flatten)]\n tx: Erc20TxOpts,\n },\n\n /// Query ERC20 token allowance.\n #[command(visible_alias = \"al\")]\n Allowance {\n /// The ERC20 token contract address.\n #[arg(value_parser = NameOrAddress::from_str)]\n token: NameOrAddress,\n\n /// The owner address.\n #[arg(value_parser = NameOrAddress::from_str)]\n owner: NameOrAddress,\n\n /// The spender address.\n #[arg(value_parser = NameOrAddress::from_str)]\n spender: NameOrAddress,\n\n /// The block height to query at.\n #[arg(long, short = 'B')]\n block: Option,\n\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Query ERC20 token name.\n #[command(visible_alias = \"n\")]\n Name {\n /// The ERC20 token contract address.\n #[arg(value_parser = NameOrAddress::from_str)]\n token: NameOrAddress,\n\n /// The block height to query at.\n #[arg(long, short = 'B')]\n block: Option,\n\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Query ERC20 token symbol.\n #[command(visible_alias = \"s\")]\n Symbol {\n /// The ERC20 token contract address.\n #[arg(value_parser = NameOrAddress::from_str)]\n token: NameOrAddress,\n\n /// The block height to query at.\n #[arg(long, short = 'B')]\n block: Option,\n\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Query ERC20 token decimals.\n #[command(visible_alias = \"d\")]\n Decimals {\n /// The ERC20 token contract address.\n #[arg(value_parser = NameOrAddress::from_str)]\n token: NameOrAddress,\n\n /// The block height to query at.\n #[arg(long, short = 'B')]\n block: Option,\n\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Query ERC20 token total supply.\n #[command(visible_alias = \"ts\")]\n TotalSupply {\n /// The ERC20 token contract address.\n #[arg(value_parser = NameOrAddress::from_str)]\n token: NameOrAddress,\n\n /// The block height to query at.\n #[arg(long, short = 'B')]\n block: Option,\n\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Mint ERC20 tokens (if the token supports minting).\n #[command(visible_alias = \"m\")]\n Mint {\n /// The ERC20 token contract address.\n #[arg(value_parser = NameOrAddress::from_str)]\n token: NameOrAddress,\n\n /// The recipient address.\n #[arg(value_parser = NameOrAddress::from_str)]\n to: NameOrAddress,\n\n /// The amount to mint.\n amount: String,\n\n #[command(flatten)]\n send_tx: SendTxOpts,\n\n #[command(flatten)]\n tx: Erc20TxOpts,\n },\n\n /// Burn ERC20 tokens.\n #[command(visible_alias = \"bu\")]\n Burn {\n /// The ERC20 token contract address.\n #[arg(value_parser = NameOrAddress::from_str)]\n token: NameOrAddress,\n\n /// The amount to burn.\n amount: String,\n\n #[command(flatten)]\n send_tx: SendTxOpts,\n\n #[command(flatten)]\n tx: Erc20TxOpts,\n },\n}\n\nimpl Erc20Subcommand {\n fn rpc_opts(&self) -> &RpcOpts {\n match self {\n Self::Allowance { rpc, .. } => rpc,\n Self::Approve { send_tx, .. } => &send_tx.eth.rpc,\n Self::Balance { rpc, .. } => rpc,\n Self::Transfer { send_tx, .. } => &send_tx.eth.rpc,\n Self::Name { rpc, .. } => rpc,\n Self::Symbol { rpc, .. } => rpc,\n Self::Decimals { rpc, .. } => rpc,\n Self::TotalSupply { rpc, .. } => rpc,\n Self::Mint { send_tx, .. } => &send_tx.eth.rpc,\n Self::Burn { send_tx, .. } => &send_tx.eth.rpc,\n }\n }\n\n fn erc20_opts(&self) -> Option<&Erc20TxOpts> {\n match self {\n Self::Approve { tx, .. }\n | Self::Transfer { tx, .. }\n | Self::Mint { tx, .. }\n | Self::Burn { tx, .. } => Some(tx),\n Self::Allowance { .. }\n | Self::Balance { .. }\n | Self::Name { .. }\n | Self::Symbol { .. }\n | Self::Decimals { .. }\n | Self::TotalSupply { .. } => None,\n }\n }\n\n pub async fn run(self) -> eyre::Result<()> {\n if let Some(erc20) = self.erc20_opts()\n && erc20.tempo.is_tempo()\n {\n self.run_generic::().await\n } else {\n self.run_generic::().await\n }\n }\n\n pub async fn run_generic(self) -> eyre::Result<()>\n where\n N::TxEnvelope: From>,\n N::UnsignedTx: SignableTransaction,\n N::TransactionRequest: FoundryTransactionBuilder,\n N::ReceiptResponse: UIfmt + UIfmtReceiptExt,\n {\n let config = self.rpc_opts().load_config()?;\n\n match self {\n // Read-only\n Self::Allowance { token, owner, spender, block, .. } => {\n let provider = get_provider(&config)?;\n let token = token.resolve(&provider).await?;\n let owner = owner.resolve(&provider).await?;\n let spender = spender.resolve(&provider).await?;\n\n let allowance = IERC20::new(token, &provider)\n .allowance(owner, spender)\n .block(block.unwrap_or_default())\n .call()\n .await?;\n\n if shell::is_json() {\n sh_println!(\"{}\", serde_json::to_string(&allowance.to_string())?)?\n } else {\n sh_println!(\"{}\", format_uint_exp(allowance))?\n }\n }\n Self::Balance { token, owner, block, .. } => {\n let provider = get_provider(&config)?;\n let token = token.resolve(&provider).await?;\n let owner = owner.resolve(&provider).await?;\n\n let balance = IERC20::new(token, &provider)\n .balanceOf(owner)\n .block(block.unwrap_or_default())\n .call()\n .await?;\n\n if shell::is_json() {\n sh_println!(\"{}\", serde_json::to_string(&balance.to_string())?)?\n } else {\n sh_println!(\"{}\", format_uint_exp(balance))?\n }\n }\n Self::Name { token, block, .. } => {\n let provider = get_provider(&config)?;\n let token = token.resolve(&provider).await?;\n\n let name = IERC20::new(token, &provider)\n .name()\n .block(block.unwrap_or_default())\n .call()\n .await?;\n\n if shell::is_json() {\n sh_println!(\"{}\", serde_json::to_string(&name)?)?\n } else {\n sh_println!(\"{}\", name)?\n }\n }\n Self::Symbol { token, block, .. } => {\n let provider = get_provider(&config)?;\n let token = token.resolve(&provider).await?;\n\n let symbol = IERC20::new(token, &provider)\n .symbol()\n .block(block.unwrap_or_default())\n .call()\n .await?;\n\n if shell::is_json() {\n sh_println!(\"{}\", serde_json::to_string(&symbol)?)?\n } else {\n sh_println!(\"{}\", symbol)?\n }\n }\n Self::Decimals { token, block, .. } => {\n let provider = get_provider(&config)?;\n let token = token.resolve(&provider).await?;\n\n let decimals = IERC20::new(token, &provider)\n .decimals()\n .block(block.unwrap_or_default())\n .call()\n .await?;\n if shell::is_json() {\n sh_println!(\"{}\", serde_json::to_string(&decimals)?)?\n } else {\n sh_println!(\"{}\", decimals)?\n }\n }\n Self::TotalSupply { token, block, .. } => {\n let provider = get_provider(&config)?;\n let token = token.resolve(&provider).await?;\n\n let total_supply = IERC20::new(token, &provider)\n .totalSupply()\n .block(block.unwrap_or_default())\n .call()\n .await?;\n\n if shell::is_json() {\n sh_println!(\"{}\", serde_json::to_string(&total_supply.to_string())?)?\n } else {\n sh_println!(\"{}\", format_uint_exp(total_supply))?\n }\n }\n // State-changing\n Self::Transfer { token, to, amount, send_tx, tx: tx_opts, .. } => {\n let provider = get_provider_with_wallet::(&send_tx).await?;\n let mut tx = IERC20::new(token.resolve(&provider).await?, &provider)\n .transfer(to.resolve(&provider).await?, U256::from_str(&amount)?)\n .into_transaction_request();\n\n tx_opts.apply::(&mut tx, get_chain(config.chain, &provider).await?.is_legacy());\n\n cast_send(\n provider,\n tx,\n send_tx.cast_async,\n send_tx.sync,\n send_tx.confirmations,\n send_tx.timeout.unwrap_or(config.transaction_timeout),\n )\n .await?\n }\n Self::Approve { token, spender, amount, send_tx, tx: tx_opts, .. } => {\n let provider = get_provider_with_wallet::(&send_tx).await?;\n let mut tx = IERC20::new(token.resolve(&provider).await?, &provider)\n .approve(spender.resolve(&provider).await?, U256::from_str(&amount)?)\n .into_transaction_request();\n\n tx_opts.apply::(&mut tx, get_chain(config.chain, &provider).await?.is_legacy());\n\n cast_send(\n provider,\n tx,\n send_tx.cast_async,\n send_tx.sync,\n send_tx.confirmations,\n send_tx.timeout.unwrap_or(config.transaction_timeout),\n )\n .await?\n }\n Self::Mint { token, to, amount, send_tx, tx: tx_opts, .. } => {\n let provider = get_provider_with_wallet::(&send_tx).await?;\n let mut tx = IERC20::new(token.resolve(&provider).await?, &provider)\n .mint(to.resolve(&provider).await?, U256::from_str(&amount)?)\n .into_transaction_request();\n\n tx_opts.apply::(&mut tx, get_chain(config.chain, &provider).await?.is_legacy());\n\n cast_send(\n provider,\n tx,\n send_tx.cast_async,\n send_tx.sync,\n send_tx.confirmations,\n send_tx.timeout.unwrap_or(config.transaction_timeout),\n )\n .await?\n }\n Self::Burn { token, amount, send_tx, tx: tx_opts, .. } => {\n let provider = get_provider_with_wallet::(&send_tx).await?;\n let mut tx = IERC20::new(token.resolve(&provider).await?, &provider)\n .burn(U256::from_str(&amount)?)\n .into_transaction_request();\n\n tx_opts.apply::(&mut tx, get_chain(config.chain, &provider).await?.is_legacy());\n\n cast_send(\n provider,\n tx,\n send_tx.cast_async,\n send_tx.sync,\n send_tx.confirmations,\n send_tx.timeout.unwrap_or(config.transaction_timeout),\n )\n .await?\n }\n };\n Ok(())\n }\n}\n" }, { "path": "crates/cast/src/cmd/estimate.rs", "content": "use crate::tx::{CastTxBuilder, SenderKind};\nuse alloy_ens::NameOrAddress;\nuse alloy_network::{AnyNetwork, Network};\nuse alloy_primitives::U256;\nuse alloy_provider::Provider;\nuse alloy_rpc_types::BlockId;\nuse clap::Parser;\nuse eyre::Result;\nuse foundry_cli::{\n opts::{RpcOpts, TransactionOpts},\n utils::{LoadConfig, parse_ether_value},\n};\nuse foundry_common::provider::ProviderBuilder;\nuse foundry_primitives::FoundryTransactionBuilder;\nuse foundry_wallets::WalletOpts;\nuse std::str::FromStr;\nuse tempo_alloy::TempoNetwork;\n\n/// CLI arguments for `cast estimate`.\n#[derive(Debug, Parser)]\npub struct EstimateArgs {\n /// The destination of the transaction.\n #[arg(value_parser = NameOrAddress::from_str)]\n to: Option,\n\n /// The signature of the function to call.\n sig: Option,\n\n /// The arguments of the function to call.\n #[arg(allow_negative_numbers = true)]\n args: Vec,\n\n /// The block height to query at.\n ///\n /// Can also be the tags earliest, finalized, safe, latest, or pending.\n #[arg(long, short = 'B')]\n block: Option,\n\n /// Calculate the cost of a transaction using the network gas price.\n ///\n /// If not specified the amount of gas will be estimated.\n #[arg(long)]\n cost: bool,\n\n #[command(flatten)]\n wallet: WalletOpts,\n\n #[command(subcommand)]\n command: Option,\n\n #[command(flatten)]\n tx: TransactionOpts,\n\n #[command(flatten)]\n rpc: RpcOpts,\n}\n\n#[derive(Debug, Parser)]\npub enum EstimateSubcommands {\n /// Estimate gas cost to deploy a smart contract\n #[command(name = \"--create\")]\n Create {\n /// The bytecode of contract\n code: String,\n\n /// The signature of the constructor\n sig: Option,\n\n /// Constructor arguments\n #[arg(allow_negative_numbers = true)]\n args: Vec,\n\n /// Ether to send in the transaction\n ///\n /// Either specified in wei, or as a string with a unit type:\n ///\n /// Examples: 1ether, 10gwei, 0.01ether\n #[arg(long, value_parser = parse_ether_value)]\n value: Option,\n },\n}\n\nimpl EstimateArgs {\n pub async fn run(self) -> Result<()> {\n if self.tx.tempo.is_tempo() {\n self.run_with_network::().await\n } else {\n self.run_with_network::().await\n }\n }\n\n pub async fn run_with_network(self) -> Result<()>\n where\n N::TransactionRequest: FoundryTransactionBuilder,\n {\n let Self { to, mut sig, mut args, mut tx, block, cost, wallet, rpc, command } = self;\n\n let config = rpc.load_config()?;\n let provider = ProviderBuilder::::from_config(&config)?.build()?;\n let sender = SenderKind::from_wallet_opts(wallet).await?;\n\n let code = if let Some(EstimateSubcommands::Create {\n code,\n sig: create_sig,\n args: create_args,\n value,\n }) = command\n {\n sig = create_sig;\n args = create_args;\n if let Some(value) = value {\n tx.value = Some(value);\n }\n Some(code)\n } else {\n None\n };\n\n let (tx, _) = CastTxBuilder::new(&provider, tx, &config)\n .await?\n .with_to(to)\n .await?\n .with_code_sig_and_args(code, sig, args)\n .await?\n .raw()\n .build(sender)\n .await?;\n\n let gas = provider.estimate_gas(tx).block(block.unwrap_or_default()).await?;\n if cost {\n let gas_price_wei = provider.get_gas_price().await?;\n let cost = gas_price_wei * gas as u128;\n let cost_eth = cost as f64 / 1e18;\n sh_println!(\"{cost_eth}\")?;\n } else {\n sh_println!(\"{gas}\")?;\n }\n Ok(())\n }\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n\n #[test]\n fn parse_estimate_value() {\n let args: EstimateArgs = EstimateArgs::parse_from([\"foundry-cli\", \"--value\", \"100\"]);\n assert!(args.tx.value.is_some());\n }\n}\n" }, { "path": "crates/cast/src/cmd/find_block.rs", "content": "use crate::Cast;\nuse alloy_provider::Provider;\nuse clap::Parser;\nuse eyre::Result;\nuse foundry_cli::{\n opts::RpcOpts,\n utils::{self, LoadConfig},\n};\nuse futures::join;\n\n/// CLI arguments for `cast find-block`.\n#[derive(Clone, Debug, Parser)]\npub struct FindBlockArgs {\n /// The UNIX timestamp to search for, in seconds.\n timestamp: u64,\n\n #[command(flatten)]\n rpc: RpcOpts,\n}\n\nimpl FindBlockArgs {\n pub async fn run(self) -> Result<()> {\n let Self { timestamp, rpc } = self;\n\n let ts_target = timestamp;\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n\n let last_block_num = provider.get_block_number().await?;\n let cast_provider = Cast::new(provider);\n\n let res = join!(cast_provider.timestamp(last_block_num), cast_provider.timestamp(1));\n let ts_block_latest: u64 = res.0?.to();\n let ts_block_1: u64 = res.1?.to();\n\n let block_num = if ts_block_latest < ts_target {\n // If the most recent block's timestamp is below the target, return it\n last_block_num\n } else if ts_block_1 > ts_target {\n // If the target timestamp is below block 1's timestamp, return that\n 1\n } else {\n // Otherwise, find the block that is closest to the timestamp\n let mut low_block = 1_u64; // block 0 has a timestamp of 0: https://github.com/ethereum/go-ethereum/issues/17042#issuecomment-559414137\n let mut high_block = last_block_num;\n let mut matching_block = None;\n while high_block > low_block && matching_block.is_none() {\n // Get timestamp of middle block (this approach to avoids overflow)\n let high_minus_low_over_2 = high_block\n .checked_sub(low_block)\n .ok_or_else(|| eyre::eyre!(\"unexpected underflow\"))\n .unwrap()\n .checked_div(2_u64)\n .unwrap();\n let mid_block = high_block.checked_sub(high_minus_low_over_2).unwrap();\n let ts_mid_block = cast_provider.timestamp(mid_block).await?.to::();\n\n // Check if we've found a match or should keep searching\n if ts_mid_block == ts_target {\n matching_block = Some(mid_block)\n } else if high_block.checked_sub(low_block).unwrap() == 1_u64 {\n // The target timestamp is in between these blocks. This rounds to the\n // highest block if timestamp is equidistant between blocks\n let res = join!(\n cast_provider.timestamp(high_block),\n cast_provider.timestamp(low_block)\n );\n let ts_high: u64 = res.0.unwrap().to();\n let ts_low: u64 = res.1.unwrap().to();\n let high_diff = ts_high.checked_sub(ts_target).unwrap();\n let low_diff = ts_target.checked_sub(ts_low).unwrap();\n let is_low = low_diff < high_diff;\n matching_block = if is_low { Some(low_block) } else { Some(high_block) }\n } else if ts_mid_block < ts_target {\n low_block = mid_block;\n } else {\n high_block = mid_block;\n }\n }\n matching_block.unwrap_or(low_block)\n };\n sh_println!(\"{block_num}\")?;\n\n Ok(())\n }\n}\n" }, { "path": "crates/cast/src/cmd/interface.rs", "content": "use alloy_json_abi::{ContractObject, JsonAbi, ToSolConfig};\nuse alloy_primitives::Address;\nuse clap::Parser;\nuse eyre::{Context, Result};\nuse forge_fmt::FormatterConfig;\nuse foundry_cli::{\n opts::EtherscanOpts,\n utils::{LoadConfig, fetch_abi_from_etherscan},\n};\nuse foundry_common::{\n ContractsByArtifact,\n compile::{PathOrContractInfo, ProjectCompiler},\n find_target_path, fs, shell,\n};\nuse foundry_config::load_config;\nuse itertools::Itertools;\nuse serde_json::Value;\nuse std::{\n path::{Path, PathBuf},\n str::FromStr,\n};\n\n/// CLI arguments for `cast interface`.\n#[derive(Clone, Debug, Parser)]\npub struct InterfaceArgs {\n /// The target contract, which can be one of:\n /// - A file path to an ABI JSON file.\n /// - A contract identifier in the form `:` or just ``.\n /// - An Ethereum address, for which the ABI will be fetched from Etherscan.\n contract: String,\n\n /// The name to use for the generated interface.\n ///\n /// Only relevant when retrieving the ABI from a file.\n #[arg(long, short)]\n name: Option,\n\n /// Solidity pragma version.\n #[arg(long, short, default_value = \"^0.8.4\", value_name = \"VERSION\")]\n pragma: String,\n\n /// The path to the output file.\n ///\n /// If not specified, the interface will be output to stdout.\n #[arg(\n short,\n long,\n value_hint = clap::ValueHint::FilePath,\n value_name = \"PATH\",\n )]\n output: Option,\n\n /// If set, generate all types in a single interface, inlining any inherited or library types.\n ///\n /// This can fail if there are structs with the same name in different interfaces.\n #[arg(long)]\n flatten: bool,\n\n #[command(flatten)]\n etherscan: EtherscanOpts,\n}\n\nimpl InterfaceArgs {\n pub async fn run(self) -> Result<()> {\n let Self { contract, name, pragma, output: output_location, flatten, etherscan } = self;\n\n // Determine if the target contract is an ABI file, a local contract or an Ethereum address.\n let abis = if Path::new(&contract).is_file()\n && fs::read_to_string(&contract)\n .ok()\n .and_then(|content| serde_json::from_str::(&content).ok())\n .is_some()\n {\n load_abi_from_file(&contract, name)?\n } else {\n match Address::from_str(&contract) {\n Ok(address) => fetch_abi_from_etherscan(address, ðerscan.load_config()?).await?,\n Err(_) => load_abi_from_artifact(&contract)?,\n }\n };\n\n // Build config for to_sol conversion.\n let config = if flatten { Some(ToSolConfig::new().one_contract(true)) } else { None };\n\n // Retrieve interfaces from the array of ABIs.\n let interfaces = get_interfaces(abis, config)?;\n\n // Print result or write to file.\n let res = if shell::is_json() {\n // Format as JSON.\n interfaces.iter().map(|iface| &iface.json_abi).format(\"\\n\").to_string()\n } else {\n // Format as Solidity.\n format!(\n \"// SPDX-License-Identifier: UNLICENSED\\n\\\n pragma solidity {pragma};\\n\\n\\\n {}\",\n interfaces.iter().map(|iface| &iface.source).format(\"\\n\")\n )\n };\n\n if let Some(loc) = output_location {\n if let Some(parent) = loc.parent() {\n fs::create_dir_all(parent)?;\n }\n fs::write(&loc, res)?;\n sh_println!(\"Saved interface at {}\", loc.display())?;\n } else {\n sh_print!(\"{res}\")?;\n }\n\n Ok(())\n }\n}\n\nstruct InterfaceSource {\n json_abi: String,\n source: String,\n}\n\n/// Load the ABI from a file.\npub fn load_abi_from_file(path: &str, name: Option) -> Result> {\n let file = std::fs::read_to_string(path).wrap_err(\"unable to read abi file\")?;\n let obj: ContractObject = serde_json::from_str(&file)?;\n let abi = obj.abi.ok_or_else(|| eyre::eyre!(\"could not find ABI in file {path}\"))?;\n let name = name.unwrap_or_else(|| \"Interface\".to_owned());\n Ok(vec![(abi, name)])\n}\n\n/// Load the ABI from the artifact of a locally compiled contract.\nfn load_abi_from_artifact(path_or_contract: &str) -> Result> {\n let config = load_config()?;\n let project = config.project()?;\n let compiler = ProjectCompiler::new().quiet(true);\n\n let contract = PathOrContractInfo::from_str(path_or_contract)?;\n\n let target_path = find_target_path(&project, &contract)?;\n let output = compiler.files([target_path.clone()]).compile(&project)?;\n\n let contracts_by_artifact = ContractsByArtifact::from(output);\n\n let maybe_abi = contracts_by_artifact\n .find_abi_by_name_or_src_path(contract.name().unwrap_or(&target_path.to_string_lossy()));\n\n let (abi, name) =\n maybe_abi.as_ref().ok_or_else(|| eyre::eyre!(\"Failed to fetch lossless ABI\"))?;\n\n Ok(vec![(abi.clone(), contract.name().unwrap_or(name).to_string())])\n}\n\n/// Converts a vector of tuples containing the ABI and contract name into a vector of\n/// `InterfaceSource` objects.\nfn get_interfaces(\n abis: Vec<(JsonAbi, String)>,\n config: Option,\n) -> Result> {\n abis.into_iter()\n .map(|(contract_abi, name)| {\n let source = match forge_fmt::format(\n &contract_abi.to_sol(&name, config.clone()),\n FormatterConfig::default(),\n )\n .into_result()\n {\n Ok(generated_source) => generated_source,\n Err(e) => {\n sh_warn!(\"Failed to format interface for {name}: {e}\")?;\n contract_abi.to_sol(&name, config.clone())\n }\n };\n\n Ok(InterfaceSource { json_abi: serde_json::to_string_pretty(&contract_abi)?, source })\n })\n .collect()\n}\n" }, { "path": "crates/cast/src/cmd/logs.rs", "content": "use crate::Cast;\nuse alloy_dyn_abi::{DynSolType, DynSolValue, Specifier};\nuse alloy_ens::NameOrAddress;\nuse alloy_json_abi::Event;\nuse alloy_network::AnyNetwork;\nuse alloy_primitives::{Address, B256, hex::FromHex};\nuse alloy_rpc_types::{BlockId, BlockNumberOrTag, Filter, FilterBlockOption, FilterSet, Topic};\nuse clap::Parser;\nuse eyre::Result;\nuse foundry_cli::{\n opts::RpcOpts,\n utils::{self, LoadConfig},\n};\nuse itertools::Itertools;\nuse std::{io, str::FromStr};\n\n/// CLI arguments for `cast logs`.\n#[derive(Debug, Parser)]\npub struct LogsArgs {\n /// The block height to start query at.\n ///\n /// Can also be the tags earliest, finalized, safe, latest, or pending.\n #[arg(long)]\n from_block: Option,\n\n /// The block height to stop query at.\n ///\n /// Can also be the tags earliest, finalized, safe, latest, or pending.\n #[arg(long)]\n to_block: Option,\n\n /// The contract address to filter on.\n #[arg(long, value_parser = NameOrAddress::from_str)]\n address: Option>,\n\n /// The signature of the event to filter logs by which will be converted to the first topic or\n /// a topic to filter on.\n #[arg(value_name = \"SIG_OR_TOPIC\")]\n sig_or_topic: Option,\n\n /// If used with a signature, the indexed fields of the event to filter by. Otherwise, the\n /// remaining topics of the filter.\n #[arg(value_name = \"TOPICS_OR_ARGS\")]\n topics_or_args: Vec,\n\n /// If the RPC type and endpoints supports `eth_subscribe` stream logs instead of printing and\n /// exiting. Will continue until interrupted or TO_BLOCK is reached.\n #[arg(long)]\n subscribe: bool,\n\n /// Number of blocks to query in each chunk when the provider has range limits.\n /// Defaults to 10000 blocks per chunk.\n #[arg(long, default_value_t = 10000)]\n query_size: u64,\n\n #[command(flatten)]\n rpc: RpcOpts,\n}\n\nimpl LogsArgs {\n pub async fn run(self) -> Result<()> {\n let Self {\n from_block,\n to_block,\n address,\n sig_or_topic,\n topics_or_args,\n subscribe,\n query_size,\n rpc,\n } = self;\n\n let config = rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n\n let cast = Cast::new(&provider);\n let addresses = match address {\n Some(addresses) => Some(\n futures::future::try_join_all(addresses.into_iter().map(|address| {\n let provider = provider.clone();\n async move { address.resolve(&provider).await }\n }))\n .await?,\n ),\n None => None,\n };\n\n let from_block =\n cast.convert_block_number(Some(from_block.unwrap_or_else(BlockId::earliest))).await?;\n let to_block =\n cast.convert_block_number(Some(to_block.unwrap_or_else(BlockId::latest))).await?;\n\n let filter = build_filter(from_block, to_block, addresses, sig_or_topic, topics_or_args)?;\n\n if !subscribe {\n let logs = cast.filter_logs_chunked(filter, query_size).await?;\n sh_println!(\"{logs}\")?;\n return Ok(());\n }\n\n // FIXME: this is a hotfix for \n // currently the alloy `eth_subscribe` impl does not work with all transports, so we use\n // the builtin transport here for now\n let url = config.get_rpc_url_or_localhost_http()?;\n let provider = alloy_provider::ProviderBuilder::<_, _, AnyNetwork>::default()\n .connect(url.as_ref())\n .await?;\n let cast = Cast::new(&provider);\n let mut stdout = io::stdout();\n cast.subscribe(filter, &mut stdout).await?;\n\n Ok(())\n }\n}\n\n/// Builds a Filter by first trying to parse the `sig_or_topic` as an event signature. If\n/// successful, `topics_or_args` is parsed as indexed inputs and converted to topics. Otherwise,\n/// `sig_or_topic` is prepended to `topics_or_args` and used as raw topics.\nfn build_filter(\n from_block: Option,\n to_block: Option,\n address: Option>,\n sig_or_topic: Option,\n topics_or_args: Vec,\n) -> Result {\n let block_option = FilterBlockOption::Range { from_block, to_block };\n let filter = match sig_or_topic {\n // Try and parse the signature as an event signature\n Some(sig_or_topic) => match foundry_common::abi::get_event(sig_or_topic.as_str()) {\n Ok(event) => build_filter_event_sig(event, topics_or_args)?,\n Err(_) => {\n let topics = [vec![sig_or_topic], topics_or_args].concat();\n build_filter_topics(topics)?\n }\n },\n None => Filter::default(),\n };\n\n let mut filter = filter.select(block_option);\n\n if let Some(address) = address {\n filter = filter.address(address)\n }\n\n Ok(filter)\n}\n\n/// Creates a [Filter] from the given event signature and arguments.\nfn build_filter_event_sig(event: Event, args: Vec) -> Result {\n let args = args.iter().map(|arg| arg.as_str()).collect::>();\n\n // Match the args to indexed inputs. Enumerate so that the ordering can be restored\n // when merging the inputs with arguments and without arguments\n let (with_args, without_args): (Vec<_>, Vec<_>) = event\n .inputs\n .iter()\n .zip(args)\n .filter(|(input, _)| input.indexed)\n .map(|(input, arg)| {\n let kind = input.resolve()?;\n Ok((kind, arg))\n })\n .collect::>>()?\n .into_iter()\n .enumerate()\n .partition(|(_, (_, arg))| !arg.is_empty());\n\n // Only parse the inputs with arguments\n let indexed_tokens = with_args\n .iter()\n .map(|(_, (kind, arg))| kind.coerce_str(arg))\n .collect::, _>>()?;\n\n // Merge the inputs restoring the original ordering\n let mut topics = with_args\n .into_iter()\n .zip(indexed_tokens)\n .map(|((i, _), t)| (i, Some(t)))\n .chain(without_args.into_iter().map(|(i, _)| (i, None)))\n .sorted_by(|(i1, _), (i2, _)| i1.cmp(i2))\n .map(|(_, token)| {\n token\n .map(|token| Topic::from(B256::from_slice(token.abi_encode().as_slice())))\n .unwrap_or(Topic::default())\n })\n .collect::>();\n\n topics.resize(3, Topic::default());\n\n let filter = Filter::new()\n .event_signature(event.selector())\n .topic1(topics[0].clone())\n .topic2(topics[1].clone())\n .topic3(topics[2].clone());\n\n Ok(filter)\n}\n\n/// Creates a [Filter] from raw topic hashes.\nfn build_filter_topics(topics: Vec) -> Result {\n let mut topics = topics\n .into_iter()\n .map(|topic| {\n if topic.is_empty() {\n Ok(Topic::default())\n } else {\n Ok(Topic::from(B256::from_hex(topic.as_str())?))\n }\n })\n .collect::>>>()?;\n\n topics.resize(4, Topic::default());\n\n let filter = Filter::new()\n .event_signature(topics[0].clone())\n .topic1(topics[1].clone())\n .topic2(topics[2].clone())\n .topic3(topics[3].clone());\n\n Ok(filter)\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n use alloy_primitives::{U160, U256};\n use alloy_rpc_types::ValueOrArray;\n\n const ADDRESS: &str = \"0x4D1A2e2bB4F88F0250f26Ffff098B0b30B26BF38\";\n const TRANSFER_SIG: &str = \"Transfer(address indexed,address indexed,uint256)\";\n const TRANSFER_TOPIC: &str =\n \"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef\";\n\n #[test]\n fn test_build_filter_basic() {\n let from_block = Some(BlockNumberOrTag::from(1337));\n let to_block = Some(BlockNumberOrTag::Latest);\n let address = Address::from_str(ADDRESS).ok();\n let expected = Filter {\n block_option: FilterBlockOption::Range { from_block, to_block },\n address: ValueOrArray::Value(address.unwrap()).into(),\n topics: [vec![].into(), vec![].into(), vec![].into(), vec![].into()],\n };\n let filter =\n build_filter(from_block, to_block, address.map(|addr| vec![addr]), None, vec![])\n .unwrap();\n assert_eq!(filter, expected)\n }\n\n #[test]\n fn test_build_filter_sig() {\n let expected = Filter {\n block_option: FilterBlockOption::Range { from_block: None, to_block: None },\n address: vec![].into(),\n topics: [\n B256::from_str(TRANSFER_TOPIC).unwrap().into(),\n vec![].into(),\n vec![].into(),\n vec![].into(),\n ],\n };\n let filter =\n build_filter(None, None, None, Some(TRANSFER_SIG.to_string()), vec![]).unwrap();\n assert_eq!(filter, expected)\n }\n\n #[test]\n fn test_build_filter_mismatch() {\n let expected = Filter {\n block_option: FilterBlockOption::Range { from_block: None, to_block: None },\n address: vec![].into(),\n topics: [\n B256::from_str(TRANSFER_TOPIC).unwrap().into(),\n vec![].into(),\n vec![].into(),\n vec![].into(),\n ],\n };\n let filter = build_filter(\n None,\n None,\n None,\n Some(\"Swap(address indexed from, address indexed to, uint256 value)\".to_string()), // Change signature, should result in error\n vec![],\n )\n .unwrap();\n assert_ne!(filter, expected)\n }\n\n #[test]\n fn test_build_filter_sig_with_arguments() {\n let addr = Address::from_str(ADDRESS).unwrap();\n let addr = U256::from(U160::from_be_bytes(addr.0.0));\n let expected = Filter {\n block_option: FilterBlockOption::Range { from_block: None, to_block: None },\n address: vec![].into(),\n topics: [\n B256::from_str(TRANSFER_TOPIC).unwrap().into(),\n addr.into(),\n vec![].into(),\n vec![].into(),\n ],\n };\n let filter = build_filter(\n None,\n None,\n None,\n Some(TRANSFER_SIG.to_string()),\n vec![ADDRESS.to_string()],\n )\n .unwrap();\n assert_eq!(filter, expected)\n }\n\n #[test]\n fn test_build_filter_sig_with_skipped_arguments() {\n let addr = Address::from_str(ADDRESS).unwrap();\n let addr = U256::from(U160::from_be_bytes(addr.0.0));\n let expected = Filter {\n block_option: FilterBlockOption::Range { from_block: None, to_block: None },\n address: vec![].into(),\n topics: [\n vec![B256::from_str(TRANSFER_TOPIC).unwrap()].into(),\n vec![].into(),\n addr.into(),\n vec![].into(),\n ],\n };\n let filter = build_filter(\n None,\n None,\n None,\n Some(TRANSFER_SIG.to_string()),\n vec![String::new(), ADDRESS.to_string()],\n )\n .unwrap();\n assert_eq!(filter, expected)\n }\n\n #[test]\n fn test_build_filter_with_topics() {\n let expected = Filter {\n block_option: FilterBlockOption::Range { from_block: None, to_block: None },\n address: vec![].into(),\n topics: [\n vec![B256::from_str(TRANSFER_TOPIC).unwrap()].into(),\n vec![B256::from_str(TRANSFER_TOPIC).unwrap()].into(),\n vec![].into(),\n vec![].into(),\n ],\n };\n let filter = build_filter(\n None,\n None,\n None,\n Some(TRANSFER_TOPIC.to_string()),\n vec![TRANSFER_TOPIC.to_string()],\n )\n .unwrap();\n\n assert_eq!(filter, expected)\n }\n\n #[test]\n fn test_build_filter_with_skipped_topic() {\n let expected = Filter {\n block_option: FilterBlockOption::Range { from_block: None, to_block: None },\n address: vec![].into(),\n topics: [\n vec![B256::from_str(TRANSFER_TOPIC).unwrap()].into(),\n vec![].into(),\n vec![B256::from_str(TRANSFER_TOPIC).unwrap()].into(),\n vec![].into(),\n ],\n };\n let filter = build_filter(\n None,\n None,\n None,\n Some(TRANSFER_TOPIC.to_string()),\n vec![String::new(), TRANSFER_TOPIC.to_string()],\n )\n .unwrap();\n\n assert_eq!(filter, expected)\n }\n\n #[test]\n fn test_build_filter_with_multiple_addresses() {\n let expected = Filter {\n block_option: FilterBlockOption::Range { from_block: None, to_block: None },\n address: vec![Address::ZERO, ADDRESS.parse().unwrap()].into(),\n topics: [\n vec![TRANSFER_TOPIC.parse().unwrap()].into(),\n vec![].into(),\n vec![].into(),\n vec![].into(),\n ],\n };\n let filter = build_filter(\n None,\n None,\n Some(vec![Address::ZERO, ADDRESS.parse().unwrap()]),\n Some(TRANSFER_TOPIC.to_string()),\n vec![],\n )\n .unwrap();\n assert_eq!(filter, expected)\n }\n\n #[test]\n fn test_build_filter_sig_with_mismatched_argument() {\n let err = build_filter(\n None,\n None,\n None,\n Some(TRANSFER_SIG.to_string()),\n vec![\"1234\".to_string()],\n )\n .err()\n .unwrap()\n .to_string()\n .to_lowercase();\n\n assert_eq!(err, \"parser error:\\n1234\\n^\\ninvalid string length\");\n }\n\n #[test]\n fn test_build_filter_with_invalid_sig_or_topic() {\n let err = build_filter(None, None, None, Some(\"asdasdasd\".to_string()), vec![])\n .err()\n .unwrap()\n .to_string()\n .to_lowercase();\n\n assert_eq!(err, \"odd number of digits\");\n }\n\n #[test]\n fn test_build_filter_with_invalid_sig_or_topic_hex() {\n let err = build_filter(None, None, None, Some(ADDRESS.to_string()), vec![])\n .err()\n .unwrap()\n .to_string()\n .to_lowercase();\n\n assert_eq!(err, \"invalid string length\");\n }\n\n #[test]\n fn test_build_filter_with_invalid_topic() {\n let err = build_filter(\n None,\n None,\n None,\n Some(TRANSFER_TOPIC.to_string()),\n vec![\"1234\".to_string()],\n )\n .err()\n .unwrap()\n .to_string()\n .to_lowercase();\n\n assert_eq!(err, \"invalid string length\");\n }\n}\n" }, { "path": "crates/cast/src/cmd/mktx.rs", "content": "use crate::tx::{self, CastTxBuilder};\nuse alloy_consensus::{SignableTransaction, Signed};\nuse alloy_eips::Encodable2718;\nuse alloy_ens::NameOrAddress;\nuse alloy_network::{AnyNetwork, EthereumWallet, Network, TransactionBuilder};\nuse alloy_primitives::{Address, hex};\nuse alloy_provider::Provider;\nuse alloy_signer::{Signature, Signer};\nuse clap::Parser;\nuse eyre::Result;\nuse foundry_cli::{\n opts::{EthereumOpts, TransactionOpts},\n utils::LoadConfig,\n};\nuse foundry_common::provider::ProviderBuilder;\nuse foundry_primitives::FoundryTransactionBuilder;\nuse std::{path::PathBuf, str::FromStr};\nuse tempo_alloy::TempoNetwork;\n\n/// CLI arguments for `cast mktx`.\n#[derive(Debug, Parser)]\npub struct MakeTxArgs {\n /// The destination of the transaction.\n ///\n /// If not provided, you must use `cast mktx --create`.\n #[arg(value_parser = NameOrAddress::from_str)]\n to: Option,\n\n /// The signature of the function to call.\n sig: Option,\n\n /// The arguments of the function to call.\n #[arg(allow_negative_numbers = true)]\n args: Vec,\n\n #[command(subcommand)]\n command: Option,\n\n #[command(flatten)]\n tx: TransactionOpts,\n\n /// The path of blob data to be sent.\n #[arg(\n long,\n value_name = \"BLOB_DATA_PATH\",\n conflicts_with = \"legacy\",\n requires = \"blob\",\n help_heading = \"Transaction options\"\n )]\n path: Option,\n\n #[command(flatten)]\n eth: EthereumOpts,\n\n /// Generate a raw RLP-encoded unsigned transaction.\n ///\n /// Relaxes the wallet requirement.\n #[arg(long)]\n raw_unsigned: bool,\n\n /// Call `eth_signTransaction` using the `--from` argument or $ETH_FROM as sender\n #[arg(long, requires = \"from\", conflicts_with = \"raw_unsigned\")]\n ethsign: bool,\n}\n\n#[derive(Debug, Parser)]\npub enum MakeTxSubcommands {\n /// Use to deploy raw contract bytecode.\n #[command(name = \"--create\")]\n Create {\n /// The initialization bytecode of the contract to deploy.\n code: String,\n\n /// The signature of the constructor.\n sig: Option,\n\n /// The constructor arguments.\n #[arg(allow_negative_numbers = true)]\n args: Vec,\n },\n}\n\nimpl MakeTxArgs {\n pub async fn run(self) -> Result<()> {\n if self.tx.tempo.is_tempo() {\n self.run_generic::().await\n } else {\n self.run_generic::().await\n }\n }\n\n pub async fn run_generic(self) -> Result<()>\n where\n N::TxEnvelope: From>,\n N::UnsignedTx: SignableTransaction,\n N::TransactionRequest: FoundryTransactionBuilder,\n {\n let Self { to, mut sig, mut args, command, tx, path, eth, raw_unsigned, ethsign } = self;\n\n let print_sponsor_hash = tx.tempo.print_sponsor_hash;\n\n let blob_data = if let Some(path) = path { Some(std::fs::read(path)?) } else { None };\n\n let code = if let Some(MakeTxSubcommands::Create {\n code,\n sig: constructor_sig,\n args: constructor_args,\n }) = command\n {\n sig = constructor_sig;\n args = constructor_args;\n Some(code)\n } else {\n None\n };\n\n let config = eth.load_config()?;\n\n let provider = ProviderBuilder::::from_config(&config)?.build()?;\n\n let tx_builder = CastTxBuilder::new(&provider, tx.clone(), &config)\n .await?\n .with_to(to)\n .await?\n .with_code_sig_and_args(code, sig, args)\n .await?\n .with_blob_data(blob_data)?;\n\n // If --tempo.print-sponsor-hash was passed, build the tx, print the hash, and exit.\n if print_sponsor_hash {\n let from = eth.wallet.from.unwrap_or(Address::ZERO);\n let (tx, _) = tx_builder.build(from).await?;\n let hash = tx.compute_sponsor_hash(from).ok_or_else(|| {\n eyre::eyre!(\"This network does not support sponsored transactions\")\n })?;\n sh_println!(\"{hash:?}\")?;\n return Ok(());\n }\n\n if raw_unsigned {\n // Build unsigned raw tx\n // Check if nonce is provided when --from is not specified\n // See: \n if eth.wallet.from.is_none() && tx.nonce.is_none() {\n eyre::bail!(\n \"Missing required parameters for raw unsigned transaction. When --from is not provided, you must specify: --nonce\"\n );\n }\n\n // Use zero address as placeholder for unsigned transactions\n let from = eth.wallet.from.unwrap_or(Address::ZERO);\n\n let (tx, _) = tx_builder.build(from).await?;\n let raw_tx = hex::encode_prefixed(tx.build_unsigned()?.encoded_for_signing());\n\n sh_println!(\"{raw_tx}\")?;\n return Ok(());\n }\n\n if ethsign {\n // Use \"eth_signTransaction\" to sign the transaction only works if the node/RPC has\n // unlocked accounts.\n let (tx, _) = tx_builder.build(config.sender).await?;\n let signed_tx = provider.sign_transaction(tx).await?;\n\n sh_println!(\"{signed_tx}\")?;\n return Ok(());\n }\n\n // Default to using the local signer.\n // Get the signer from the wallet, and fail if it can't be constructed.\n let signer = eth.wallet.signer().await?;\n let from = signer.address();\n\n tx::validate_from_address(eth.wallet.from, from)?;\n\n let (tx, _) = tx_builder.build(&signer).await?;\n\n let tx = tx.build(&EthereumWallet::new(signer)).await?;\n\n let signed_tx = hex::encode(tx.encoded_2718());\n sh_println!(\"0x{signed_tx}\")?;\n\n Ok(())\n }\n}\n" }, { "path": "crates/cast/src/cmd/mod.rs", "content": "//! `cast` subcommands.\n//!\n//! All subcommands should respect the `foundry_config::Config`.\n//! If a subcommand accepts values that are supported by the `Config`, then the subcommand should\n//! implement `figment::Provider` which allows the subcommand to override the config's defaults, see\n//! [`foundry_config::Config`].\n\npub mod access_list;\npub mod artifact;\npub mod b2e_payload;\npub mod bind;\npub mod call;\npub mod constructor_args;\npub mod create2;\npub mod creation_code;\npub mod da_estimate;\npub mod erc20;\npub mod estimate;\npub mod find_block;\npub mod interface;\npub mod logs;\npub mod mktx;\npub mod rpc;\npub mod run;\npub mod send;\npub mod storage;\npub mod trace;\npub mod txpool;\npub mod wallet;\n" }, { "path": "crates/cast/src/cmd/rpc.rs", "content": "use crate::Cast;\nuse clap::Parser;\nuse eyre::Result;\nuse foundry_cli::{opts::RpcOpts, utils, utils::LoadConfig};\nuse foundry_common::shell;\nuse itertools::Itertools;\n\n/// CLI arguments for `cast rpc`.\n#[derive(Clone, Debug, Parser)]\npub struct RpcArgs {\n /// RPC method name\n method: String,\n\n /// RPC parameters\n ///\n /// Interpreted as JSON:\n ///\n /// cast rpc eth_getBlockByNumber 0x123 false\n /// => {\"method\": \"eth_getBlockByNumber\", \"params\": [\"0x123\", false] ... }\n params: Vec,\n\n /// Send raw JSON parameters\n ///\n /// The first param will be interpreted as a raw JSON array of params.\n /// If no params are given, stdin will be used. For example:\n ///\n /// cast rpc eth_getBlockByNumber '[\"0x123\", false]' --raw\n /// => {\"method\": \"eth_getBlockByNumber\", \"params\": [\"0x123\", false] ... }\n #[arg(long, short = 'w')]\n raw: bool,\n\n #[command(flatten)]\n rpc: RpcOpts,\n}\n\nimpl RpcArgs {\n pub async fn run(self) -> Result<()> {\n let Self { raw, method, params, rpc } = self;\n\n let config = rpc.load_config()?;\n\n let params = if raw {\n if params.is_empty() {\n serde_json::Deserializer::from_reader(std::io::stdin())\n .into_iter()\n .next()\n .transpose()?\n .ok_or_else(|| eyre::format_err!(\"Empty JSON parameters\"))?\n } else {\n value_or_string(params.into_iter().join(\" \"))\n }\n } else {\n serde_json::Value::Array(params.into_iter().map(value_or_string).collect())\n };\n\n let provider = utils::get_provider(&config)?;\n let result = Cast::new(provider).rpc(&method, params).await?;\n if shell::is_json() {\n let result: serde_json::Value = serde_json::from_str(&result)?;\n sh_println!(\"{}\", serde_json::to_string_pretty(&result)?)?;\n } else {\n sh_println!(\"{}\", result)?;\n }\n Ok(())\n }\n}\n\nfn value_or_string(value: String) -> serde_json::Value {\n serde_json::from_str(&value).unwrap_or(serde_json::Value::String(value))\n}\n" }, { "path": "crates/cast/src/cmd/run.rs", "content": "use crate::{\n debug::handle_traces,\n utils::{apply_chain_and_block_specific_env_changes, block_env_from_header},\n};\nuse alloy_consensus::{BlockHeader, Transaction};\nuse alloy_evm::FromRecoveredTx;\nuse alloy_network::{AnyNetwork, TransactionResponse};\nuse alloy_primitives::{\n Address, Bytes, U256,\n map::{AddressSet, HashMap},\n};\nuse alloy_provider::Provider;\nuse alloy_rpc_types::BlockTransactions;\nuse clap::Parser;\nuse eyre::{Result, WrapErr};\nuse foundry_cli::{\n opts::{EtherscanOpts, RpcOpts},\n utils::{TraceResult, init_progress},\n};\nuse foundry_common::{SYSTEM_TRANSACTION_TYPE, is_impersonated_tx, is_known_system_sender, shell};\nuse foundry_compilers::artifacts::EvmVersion;\nuse foundry_config::{\n Config,\n figment::{\n self, Metadata, Profile,\n value::{Dict, Map},\n },\n};\nuse foundry_evm::{\n executors::{EvmError, Executor, TracingExecutor},\n opts::EvmOpts,\n traces::{InternalTraceMode, TraceMode, Traces},\n};\nuse futures::TryFutureExt;\nuse revm::{DatabaseRef, context::TxEnv};\n\n/// CLI arguments for `cast run`.\n#[derive(Clone, Debug, Parser)]\npub struct RunArgs {\n /// The transaction hash.\n tx_hash: String,\n\n /// Opens the transaction in the debugger.\n #[arg(long, short)]\n debug: bool,\n\n /// Whether to identify internal functions in traces.\n #[arg(long)]\n decode_internal: bool,\n\n /// Defines the depth of a trace\n #[arg(long)]\n trace_depth: Option,\n\n /// Print out opcode traces.\n #[arg(long, short)]\n trace_printer: bool,\n\n /// Executes the transaction only with the state from the previous block.\n ///\n /// May result in different results than the live execution!\n #[arg(long)]\n quick: bool,\n\n /// Whether to replay system transactions.\n #[arg(long, alias = \"sys\")]\n replay_system_txes: bool,\n\n /// Disables the labels in the traces.\n #[arg(long, default_value_t = false)]\n disable_labels: bool,\n\n /// Label addresses in the trace.\n ///\n /// Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045:vitalik.eth\n #[arg(long, short)]\n label: Vec,\n\n #[command(flatten)]\n etherscan: EtherscanOpts,\n\n #[command(flatten)]\n rpc: RpcOpts,\n\n /// The EVM version to use.\n ///\n /// Overrides the version specified in the config.\n #[arg(long)]\n evm_version: Option,\n\n /// Sets the number of assumed available compute units per second for this provider\n ///\n /// default value: 330\n ///\n /// See also, \n #[arg(long, alias = \"cups\", value_name = \"CUPS\")]\n pub compute_units_per_second: Option,\n\n /// Disables rate limiting for this node's provider.\n ///\n /// default value: false\n ///\n /// See also, \n #[arg(long, value_name = \"NO_RATE_LIMITS\", visible_alias = \"no-rpc-rate-limit\")]\n pub no_rate_limit: bool,\n\n /// Use current project artifacts for trace decoding.\n #[arg(long, visible_alias = \"la\")]\n pub with_local_artifacts: bool,\n\n /// Disable block gas limit check.\n #[arg(long)]\n pub disable_block_gas_limit: bool,\n\n /// Enable the tx gas limit checks as imposed by Osaka (EIP-7825).\n #[arg(long)]\n pub enable_tx_gas_limit: bool,\n}\n\nimpl RunArgs {\n /// Executes the transaction by replaying it\n ///\n /// This replays the entire block the transaction was mined in unless `quick` is set to true\n ///\n /// Note: This executes the transaction(s) as is: Cheatcodes are disabled\n pub async fn run(self) -> Result<()> {\n let figment = self.rpc.clone().into_figment(self.with_local_artifacts).merge(&self);\n let evm_opts = figment.extract::()?;\n let mut config = Config::from_provider(figment)?.sanitized();\n\n let label = self.label;\n let with_local_artifacts = self.with_local_artifacts;\n let debug = self.debug;\n let decode_internal = self.decode_internal;\n let disable_labels = self.disable_labels;\n let compute_units_per_second =\n if self.no_rate_limit { Some(u64::MAX) } else { self.compute_units_per_second };\n\n let provider = foundry_cli::utils::get_provider_builder(&config)?\n .compute_units_per_second_opt(compute_units_per_second)\n .build()?;\n\n let tx_hash = self.tx_hash.parse().wrap_err(\"invalid tx hash\")?;\n let tx = provider\n .get_transaction_by_hash(tx_hash)\n .await\n .wrap_err_with(|| format!(\"tx not found: {tx_hash:?}\"))?\n .ok_or_else(|| eyre::eyre!(\"tx not found: {:?}\", tx_hash))?;\n\n // check if the tx is a system transaction\n if !self.replay_system_txes\n && (is_known_system_sender(tx.from())\n || tx.transaction_type() == Some(SYSTEM_TRANSACTION_TYPE))\n {\n return Err(eyre::eyre!(\n \"{:?} is a system transaction.\\nReplaying system transactions is currently not supported.\",\n tx.tx_hash()\n ));\n }\n\n let tx_block_number =\n tx.block_number.ok_or_else(|| eyre::eyre!(\"tx may still be pending: {:?}\", tx_hash))?;\n\n // we need to fork off the parent block\n config.fork_block_number = Some(tx_block_number - 1);\n\n let create2_deployer = evm_opts.create2_deployer;\n let (block, (mut evm_env, tx_env, fork, chain, networks)) = tokio::try_join!(\n // fetch the block the transaction was mined in\n provider.get_block(tx_block_number.into()).full().into_future().map_err(Into::into),\n TracingExecutor::get_fork_material(&mut config, evm_opts)\n )?;\n\n let mut evm_version = self.evm_version;\n\n evm_env.cfg_env.disable_block_gas_limit = self.disable_block_gas_limit;\n\n // By default do not enforce transaction gas limits imposed by Osaka (EIP-7825).\n // Users can opt-in to enable these limits by setting `enable_tx_gas_limit` to true.\n if !self.enable_tx_gas_limit {\n evm_env.cfg_env.tx_gas_limit_cap = Some(u64::MAX);\n }\n\n evm_env.cfg_env.limit_contract_code_size = None;\n evm_env.block_env.number = U256::from(tx_block_number);\n\n if let Some(block) = &block {\n evm_env.block_env = block_env_from_header(&block.header);\n\n // TODO: we need a smarter way to map the block to the corresponding evm_version for\n // commonly used chains\n if evm_version.is_none() {\n // if the block has the excess_blob_gas field, we assume it's a Cancun block\n if block.header.excess_blob_gas().is_some() {\n evm_version = Some(EvmVersion::Prague);\n }\n }\n apply_chain_and_block_specific_env_changes::(\n &mut evm_env,\n block,\n config.networks,\n );\n }\n\n let trace_mode = TraceMode::Call\n .with_debug(self.debug)\n .with_decode_internal(if self.decode_internal {\n InternalTraceMode::Full\n } else {\n InternalTraceMode::None\n })\n .with_state_changes(shell::verbosity() > 4);\n let mut executor = TracingExecutor::new(\n (evm_env.clone(), tx_env),\n fork,\n evm_version,\n trace_mode,\n networks,\n create2_deployer,\n None,\n )?;\n\n evm_env.cfg_env.set_spec(executor.spec_id());\n\n // Set the state to the moment right before the transaction\n if !self.quick {\n if !shell::is_json() {\n sh_println!(\"Executing previous transactions from the block.\")?;\n }\n\n if let Some(block) = block {\n let pb = init_progress(block.transactions.len() as u64, \"tx\");\n pb.set_position(0);\n\n let BlockTransactions::Full(ref txs) = block.transactions else {\n return Err(eyre::eyre!(\"Could not get block txs\"));\n };\n\n for (index, tx) in txs.iter().enumerate() {\n // Replay system transactions only if running with `sys` option.\n // System transactions such as on L2s don't contain any pricing info so it\n // could cause reverts.\n if !self.replay_system_txes\n && (is_known_system_sender(tx.from())\n || tx.transaction_type() == Some(SYSTEM_TRANSACTION_TYPE))\n {\n pb.set_position((index + 1) as u64);\n continue;\n }\n if tx.tx_hash() == tx_hash {\n break;\n }\n\n let tx_env = tx.as_envelope().map_or(Default::default(), |tx_envelope| {\n TxEnv::from_recovered_tx(tx_envelope, tx.from())\n });\n\n evm_env.cfg_env.disable_balance_check = true;\n\n if let Some(to) = Transaction::to(tx) {\n trace!(tx=?tx.tx_hash(),?to, \"executing previous call transaction\");\n executor.transact_with_env(evm_env.clone(), tx_env.clone()).wrap_err_with(\n || {\n format!(\n \"Failed to execute transaction: {:?} in block {}\",\n tx.tx_hash(),\n evm_env.block_env.number\n )\n },\n )?;\n } else {\n trace!(tx=?tx.tx_hash(), \"executing previous create transaction\");\n if let Err(error) =\n executor.deploy_with_env(evm_env.clone(), tx_env.clone(), None)\n {\n match error {\n // Reverted transactions should be skipped\n EvmError::Execution(_) => (),\n error => {\n return Err(error).wrap_err_with(|| {\n format!(\n \"Failed to deploy transaction: {:?} in block {}\",\n tx.tx_hash(),\n evm_env.block_env.number\n )\n });\n }\n }\n }\n }\n\n pb.set_position((index + 1) as u64);\n }\n }\n }\n\n // Execute our transaction\n let result = {\n executor.set_trace_printer(self.trace_printer);\n\n let tx_env = tx.as_envelope().map_or(Default::default(), |tx_envelope| {\n TxEnv::from_recovered_tx(tx_envelope, tx.from())\n });\n\n if is_impersonated_tx(tx.as_ref()) {\n evm_env.cfg_env.disable_balance_check = true;\n }\n\n if let Some(to) = Transaction::to(&tx) {\n trace!(tx=?tx.tx_hash(), to=?to, \"executing call transaction\");\n TraceResult::try_from(executor.transact_with_env(evm_env, tx_env))?\n } else {\n trace!(tx=?tx.tx_hash(), \"executing create transaction\");\n TraceResult::try_from(executor.deploy_with_env(evm_env, tx_env, None))?\n }\n };\n\n let contracts_bytecode = fetch_contracts_bytecode_from_trace(&executor, &result)?;\n handle_traces(\n result,\n &config,\n chain,\n &contracts_bytecode,\n label,\n with_local_artifacts,\n debug,\n decode_internal,\n disable_labels,\n self.trace_depth,\n )\n .await?;\n\n Ok(())\n }\n}\n\npub fn fetch_contracts_bytecode_from_trace(\n executor: &Executor,\n result: &TraceResult,\n) -> Result> {\n let mut contracts_bytecode = HashMap::default();\n if let Some(ref traces) = result.traces {\n contracts_bytecode.extend(gather_trace_addresses(traces).filter_map(|addr| {\n // All relevant bytecodes should already be cached in the executor.\n let code = executor\n .backend()\n .basic_ref(addr)\n .inspect_err(|e| _ = sh_warn!(\"Failed to fetch code for {addr}: {e}\"))\n .ok()??\n .code?\n .bytes();\n if code.is_empty() {\n return None;\n }\n Some((addr, code))\n }));\n }\n Ok(contracts_bytecode)\n}\n\nfn gather_trace_addresses(traces: &Traces) -> impl Iterator {\n let mut addresses = AddressSet::default();\n for (_, trace) in traces {\n for node in trace.arena.nodes() {\n if !node.trace.address.is_zero() {\n addresses.insert(node.trace.address);\n }\n if !node.trace.caller.is_zero() {\n addresses.insert(node.trace.caller);\n }\n }\n }\n addresses.into_iter()\n}\n\nimpl figment::Provider for RunArgs {\n fn metadata(&self) -> Metadata {\n Metadata::named(\"RunArgs\")\n }\n\n fn data(&self) -> Result, figment::Error> {\n let mut map = Map::new();\n\n if let Some(api_key) = &self.etherscan.key {\n map.insert(\"etherscan_api_key\".into(), api_key.as_str().into());\n }\n\n if let Some(evm_version) = self.evm_version {\n map.insert(\"evm_version\".into(), figment::value::Value::serialize(evm_version)?);\n }\n\n Ok(Map::from([(Config::selected_profile(), map)]))\n }\n}\n" }, { "path": "crates/cast/src/cmd/send.rs", "content": "use std::{path::PathBuf, str::FromStr, time::Duration};\n\nuse alloy_consensus::{SignableTransaction, Signed};\nuse alloy_ens::NameOrAddress;\nuse alloy_network::{AnyNetwork, EthereumWallet, Network};\nuse alloy_provider::{Provider, ProviderBuilder as AlloyProviderBuilder};\nuse alloy_signer::{Signature, Signer};\nuse clap::Parser;\nuse eyre::{Result, eyre};\nuse foundry_cli::{opts::TransactionOpts, utils::LoadConfig};\nuse foundry_common::{\n fmt::{UIfmt, UIfmtReceiptExt},\n provider::ProviderBuilder,\n};\nuse foundry_primitives::FoundryTransactionBuilder;\nuse tempo_alloy::TempoNetwork;\n\nuse crate::tx::{self, CastTxBuilder, CastTxSender, SendTxOpts};\n\n/// CLI arguments for `cast send`.\n#[derive(Debug, Parser)]\npub struct SendTxArgs {\n /// The destination of the transaction.\n ///\n /// If not provided, you must use cast send --create.\n #[arg(value_parser = NameOrAddress::from_str)]\n to: Option,\n\n /// The signature of the function to call.\n sig: Option,\n\n /// The arguments of the function to call.\n #[arg(allow_negative_numbers = true)]\n args: Vec,\n\n /// Raw hex-encoded data for the transaction. Used instead of \\[SIG\\] and \\[ARGS\\].\n #[arg(\n long,\n conflicts_with_all = &[\"sig\", \"args\"]\n )]\n data: Option,\n\n #[command(flatten)]\n send_tx: SendTxOpts,\n\n #[command(subcommand)]\n command: Option,\n\n /// Send via `eth_sendTransaction` using the `--from` argument or $ETH_FROM as sender\n #[arg(long, requires = \"from\")]\n unlocked: bool,\n\n #[command(flatten)]\n tx: TransactionOpts,\n\n /// The path of blob data to be sent.\n #[arg(\n long,\n value_name = \"BLOB_DATA_PATH\",\n conflicts_with = \"legacy\",\n requires = \"blob\",\n help_heading = \"Transaction options\"\n )]\n path: Option,\n}\n\n#[derive(Debug, Parser)]\npub enum SendTxSubcommands {\n /// Use to deploy raw contract bytecode.\n #[command(name = \"--create\")]\n Create {\n /// The bytecode of the contract to deploy.\n code: String,\n\n /// The signature of the function to call.\n sig: Option,\n\n /// The arguments of the function to call.\n #[arg(allow_negative_numbers = true)]\n args: Vec,\n },\n}\n\nimpl SendTxArgs {\n pub async fn run(self) -> Result<()> {\n if self.tx.tempo.is_tempo() {\n self.run_generic::().await\n } else {\n self.run_generic::().await\n }\n }\n\n pub async fn run_generic(self) -> Result<()>\n where\n N::TxEnvelope: From>,\n N::UnsignedTx: SignableTransaction,\n N::TransactionRequest: FoundryTransactionBuilder,\n N::ReceiptResponse: UIfmt + UIfmtReceiptExt,\n {\n let Self { to, mut sig, mut args, data, send_tx, tx, command, unlocked, path } = self;\n\n let print_sponsor_hash = tx.tempo.print_sponsor_hash;\n\n let blob_data = if let Some(path) = path { Some(std::fs::read(path)?) } else { None };\n\n if let Some(data) = data {\n sig = Some(data);\n }\n\n let code = if let Some(SendTxSubcommands::Create {\n code,\n sig: constructor_sig,\n args: constructor_args,\n }) = command\n {\n // ensure we don't violate settings for transactions that can't be CREATE: 7702 and 4844\n // which require mandatory target\n if to.is_none() && !tx.auth.is_empty() {\n return Err(eyre!(\n \"EIP-7702 transactions can't be CREATE transactions and require a destination address\"\n ));\n }\n // ensure we don't violate settings for transactions that can't be CREATE: 7702 and 4844\n // which require mandatory target\n if to.is_none() && blob_data.is_some() {\n return Err(eyre!(\n \"EIP-4844 transactions can't be CREATE transactions and require a destination address\"\n ));\n }\n\n sig = constructor_sig;\n args = constructor_args;\n Some(code)\n } else {\n None\n };\n\n let config = send_tx.eth.load_config()?;\n let provider = ProviderBuilder::::from_config(&config)?.build()?;\n\n if let Some(interval) = send_tx.poll_interval {\n provider.client().set_poll_interval(Duration::from_secs(interval))\n }\n\n let builder = CastTxBuilder::new(&provider, tx, &config)\n .await?\n .with_to(to)\n .await?\n .with_code_sig_and_args(code, sig, args)\n .await?\n .with_blob_data(blob_data)?;\n\n // If --tempo.print-sponsor-hash was passed, build the tx, print the hash, and exit.\n if print_sponsor_hash {\n let from = send_tx.eth.wallet.from.unwrap_or(config.sender);\n let (tx, _) = builder.build(from).await?;\n let hash = tx\n .compute_sponsor_hash(from)\n .ok_or_else(|| eyre!(\"This network does not support sponsored transactions\"))?;\n sh_println!(\"{hash:?}\")?;\n return Ok(());\n }\n\n let timeout = send_tx.timeout.unwrap_or(config.transaction_timeout);\n\n // Launch browser signer if `--browser` flag is set\n let browser = send_tx.browser.run::().await?;\n\n // Case 1:\n // Default to sending via eth_sendTransaction if the --unlocked flag is passed.\n // This should be the only way this RPC method is used as it requires a local node\n // or remote RPC with unlocked accounts.\n if unlocked && browser.is_none() {\n // only check current chain id if it was specified in the config\n if let Some(config_chain) = config.chain {\n let current_chain_id = provider.get_chain_id().await?;\n let config_chain_id = config_chain.id();\n // switch chain if current chain id is not the same as the one specified in the\n // config\n if config_chain_id != current_chain_id {\n sh_warn!(\"Switching to chain {}\", config_chain)?;\n provider\n .raw_request::<_, ()>(\n \"wallet_switchEthereumChain\".into(),\n [serde_json::json!({\n \"chainId\": format!(\"0x{:x}\", config_chain_id),\n })],\n )\n .await?;\n }\n }\n\n let (tx, _) = builder.build(config.sender).await?;\n\n cast_send(\n provider,\n tx,\n send_tx.cast_async,\n send_tx.sync,\n send_tx.confirmations,\n timeout,\n )\n .await\n // Case 2:\n // Browser wallet signs and sends the transaction in one step.\n } else if let Some(browser) = browser {\n let (tx_request, _) = builder.build(browser.address()).await?;\n let tx_hash = browser.send_transaction_via_browser(tx_request).await?;\n\n let cast = CastTxSender::new(&provider);\n cast.print_tx_result(tx_hash, send_tx.cast_async, send_tx.confirmations, timeout).await\n // Case 3:\n // An option to use a local signer was provided.\n // If we cannot successfully instantiate a local signer, then we will assume we don't have\n // enough information to sign and we must bail.\n } else {\n let signer = send_tx.eth.wallet.signer().await?;\n let from = signer.address();\n\n tx::validate_from_address(send_tx.eth.wallet.from, from)?;\n\n let (tx_request, _) = builder.build(&signer).await?;\n\n let wallet = EthereumWallet::from(signer);\n let provider = AlloyProviderBuilder::<_, _, N>::default()\n .wallet(wallet)\n .connect_provider(&provider);\n\n cast_send(\n provider,\n tx_request,\n send_tx.cast_async,\n send_tx.sync,\n send_tx.confirmations,\n timeout,\n )\n .await\n }\n }\n}\n\npub(crate) async fn cast_send>(\n provider: P,\n tx: N::TransactionRequest,\n cast_async: bool,\n sync: bool,\n confs: u64,\n timeout: u64,\n) -> Result<()>\nwhere\n N::TransactionRequest: FoundryTransactionBuilder,\n N::ReceiptResponse: UIfmt + UIfmtReceiptExt,\n{\n let cast = CastTxSender::new(provider);\n\n if sync {\n // Send transaction and wait for receipt synchronously\n let receipt = cast.send_sync(tx).await?;\n sh_println!(\"{receipt}\")?;\n } else {\n let pending_tx = cast.send(tx).await?;\n let tx_hash = *pending_tx.inner().tx_hash();\n cast.print_tx_result(tx_hash, cast_async, confs, timeout).await?;\n }\n\n Ok(())\n}\n" }, { "path": "crates/cast/src/cmd/storage.rs", "content": "use crate::{Cast, opts::parse_slot};\nuse alloy_ens::NameOrAddress;\nuse alloy_network::AnyNetwork;\nuse alloy_primitives::{Address, B256, U256};\nuse alloy_provider::Provider;\nuse alloy_rpc_types::BlockId;\nuse clap::Parser;\nuse comfy_table::{Cell, Table, modifiers::UTF8_ROUND_CORNERS, presets::ASCII_MARKDOWN};\nuse eyre::Result;\nuse foundry_block_explorers::Client;\nuse foundry_cli::{\n opts::{BuildOpts, EtherscanOpts, RpcOpts},\n utils,\n utils::LoadConfig,\n};\nuse foundry_common::{\n abi::find_source,\n compile::{ProjectCompiler, etherscan_project},\n shell,\n};\nuse foundry_compilers::{\n Artifact, Project,\n artifacts::{ConfigurableContractArtifact, Contract, StorageLayout},\n compilers::{\n Compiler,\n solc::{Solc, SolcCompiler},\n },\n};\nuse foundry_config::{\n Config,\n figment::{self, Metadata, Profile, value::Dict},\n impl_figment_convert_cast,\n};\nuse semver::Version;\nuse serde::{Deserialize, Serialize};\nuse std::str::FromStr;\n\n/// The minimum Solc version for outputting storage layouts.\n///\n/// \nconst MIN_SOLC: Version = Version::new(0, 6, 5);\n\n/// CLI arguments for `cast storage`.\n#[derive(Clone, Debug, Parser)]\npub struct StorageArgs {\n /// The contract address.\n #[arg(value_parser = NameOrAddress::from_str)]\n address: NameOrAddress,\n\n /// The storage slot number. If not provided, it gets the full storage layout.\n #[arg(value_parser = parse_slot)]\n base_slot: Option,\n\n /// The storage offset from the base slot. If not provided, it is assumed to be zero.\n #[arg(value_parser = str::parse::, default_value_t = U256::ZERO)]\n offset: U256,\n\n /// The known proxy address. If provided, the storage layout is retrieved from this address.\n #[arg(long,value_parser = NameOrAddress::from_str)]\n proxy: Option,\n\n /// The block height to query at.\n ///\n /// Can also be the tags earliest, finalized, safe, latest, or pending.\n #[arg(long, short)]\n block: Option,\n\n #[command(flatten)]\n rpc: RpcOpts,\n\n #[command(flatten)]\n etherscan: EtherscanOpts,\n\n #[command(flatten)]\n build: BuildOpts,\n\n /// Specify the solc version to compile with. Overrides detected version.\n #[arg(long, value_parser = Version::parse)]\n solc_version: Option,\n}\n\nimpl_figment_convert_cast!(StorageArgs);\n\nimpl figment::Provider for StorageArgs {\n fn metadata(&self) -> Metadata {\n Metadata::named(\"StorageArgs\")\n }\n\n fn data(&self) -> Result, figment::Error> {\n let mut map = self.build.data()?;\n let dict = map.get_mut(&Config::selected_profile()).unwrap();\n dict.extend(self.rpc.dict());\n dict.extend(self.etherscan.dict());\n Ok(map)\n }\n}\n\nimpl StorageArgs {\n pub async fn run(self) -> Result<()> {\n let config = self.load_config()?;\n\n let Self { address, base_slot, offset, block, build, .. } = self;\n let provider = utils::get_provider(&config)?;\n let address = address.resolve(&provider).await?;\n\n // Slot was provided, perform a simple RPC call\n if let Some(slot) = base_slot {\n let cast = Cast::new(provider);\n sh_println!(\n \"{}\",\n cast.storage(\n address,\n (Into::::into(slot).saturating_add(offset)).into(),\n block\n )\n .await?\n )?;\n return Ok(());\n }\n\n // No slot was provided\n // Get deployed bytecode at given address\n let address_code =\n provider.get_code_at(address).block_id(block.unwrap_or_default()).await?;\n if address_code.is_empty() {\n eyre::bail!(\"Provided address has no deployed code and thus no storage\");\n }\n\n // Check if we're in a forge project and if we can find the address' code\n let mut project = build.project()?;\n if project.paths.has_input_files() {\n // Find in artifacts and pretty print\n add_storage_layout_output(&mut project);\n let out = ProjectCompiler::new().quiet(shell::is_json()).compile(&project)?;\n let artifact = out.artifacts().find(|(_, artifact)| {\n artifact.get_deployed_bytecode_bytes().is_some_and(|b| *b == address_code)\n });\n if let Some((_, artifact)) = artifact {\n return fetch_and_print_storage(provider, address, block, artifact).await;\n }\n }\n\n let chain = utils::get_chain(config.chain, &provider).await?;\n let api_key = config.get_etherscan_api_key(Some(chain)).or_else(|| self.etherscan.key()).ok_or_else(|| {\n eyre::eyre!(\"You must provide an Etherscan API key if you're fetching a remote contract's storage.\")\n })?;\n let client = Client::new(chain, api_key)?;\n let source = if let Some(proxy) = self.proxy {\n find_source(client, proxy.resolve(&provider).await?).await?\n } else {\n find_source(client, address).await?\n };\n let metadata = source.items.first().unwrap();\n if metadata.is_vyper() {\n eyre::bail!(\"Contract at provided address is not a valid Solidity contract\")\n }\n\n // Create or reuse a persistent cache for Etherscan sources; fall back to a temp dir\n let mut temp_dir = None;\n let root_path = if let Some(cache_root) =\n foundry_config::Config::foundry_etherscan_chain_cache_dir(chain)\n {\n let sources_root = cache_root.join(\"sources\");\n let contract_root = sources_root.join(format!(\"{address}\"));\n if let Err(err) = std::fs::create_dir_all(&contract_root) {\n sh_warn!(\"Could not create etherscan cache dir, falling back to temp: {err}\")?;\n let tmp = tempfile::tempdir()?;\n let path = tmp.path().to_path_buf();\n temp_dir = Some(tmp);\n path\n } else {\n contract_root\n }\n } else {\n let tmp = tempfile::tempdir()?;\n let path = tmp.path().to_path_buf();\n temp_dir = Some(tmp);\n path\n };\n let mut project = etherscan_project(metadata, &root_path)?;\n add_storage_layout_output(&mut project);\n\n // Decide on compiler to use (user override -> metadata -> autodetect)\n let meta_version = metadata.compiler_version()?;\n let mut auto_detect = false;\n let desired = if let Some(user_version) = self.solc_version {\n if user_version < MIN_SOLC {\n sh_warn!(\n \"The provided --solc-version is {user_version} while the minimum version for \\\n storage layouts is {MIN_SOLC} and as a result the output may be empty.\"\n )?;\n }\n SolcCompiler::Specific(Solc::find_or_install(&user_version)?)\n } else if meta_version < MIN_SOLC {\n auto_detect = true;\n SolcCompiler::AutoDetect\n } else {\n SolcCompiler::Specific(Solc::find_or_install(&meta_version)?)\n };\n project.compiler.solc = Some(desired);\n\n // Compile\n let mut out = ProjectCompiler::new().quiet(true).compile(&project)?;\n let artifact = {\n let (_, mut artifact) = out\n .artifacts()\n .find(|(name, _)| name == &metadata.contract_name)\n .ok_or_else(|| eyre::eyre!(\"Could not find artifact\"))?;\n\n if auto_detect && is_storage_layout_empty(&artifact.storage_layout) {\n // try recompiling with the minimum version\n sh_warn!(\n \"The requested contract was compiled with {meta_version} while the minimum version \\\n for storage layouts is {MIN_SOLC} and as a result the output may be empty.\",\n )?;\n let solc = Solc::find_or_install(&MIN_SOLC)?;\n project.compiler.solc = Some(SolcCompiler::Specific(solc));\n if let Ok(output) = ProjectCompiler::new().quiet(true).compile(&project) {\n out = output;\n let (_, new_artifact) = out\n .artifacts()\n .find(|(name, _)| name == &metadata.contract_name)\n .ok_or_else(|| eyre::eyre!(\"Could not find artifact\"))?;\n artifact = new_artifact;\n }\n }\n\n artifact\n };\n\n drop(temp_dir);\n fetch_and_print_storage(provider, address, block, artifact).await\n }\n}\n\n/// Represents the value of a storage slot `eth_getStorageAt` call.\n#[derive(Clone, Debug, PartialEq, Eq)]\nstruct StorageValue {\n /// The slot number.\n slot: B256,\n /// The value as returned by `eth_getStorageAt`.\n raw_slot_value: B256,\n}\n\nimpl StorageValue {\n /// Returns the value of the storage slot, applying the offset if necessary.\n fn value(&self, offset: i64, number_of_bytes: Option) -> B256 {\n let offset = offset as usize;\n let mut end = 32;\n if let Some(number_of_bytes) = number_of_bytes {\n end = offset + number_of_bytes;\n if end > 32 {\n end = 32;\n }\n }\n\n // reverse range, because the value is stored in big endian\n let raw_sliced_value = &self.raw_slot_value.as_slice()[32 - end..32 - offset];\n\n // copy the raw sliced value as tail\n let mut value = [0u8; 32];\n value[32 - raw_sliced_value.len()..32].copy_from_slice(raw_sliced_value);\n B256::from(value)\n }\n}\n\n/// Represents the storage layout of a contract and its values.\n#[derive(Clone, Debug, Serialize, Deserialize)]\nstruct StorageReport {\n #[serde(flatten)]\n layout: StorageLayout,\n values: Vec,\n}\n\nasync fn fetch_and_print_storage>(\n provider: P,\n address: Address,\n block: Option,\n artifact: &ConfigurableContractArtifact,\n) -> Result<()> {\n if is_storage_layout_empty(&artifact.storage_layout) {\n sh_warn!(\"Storage layout is empty.\")?;\n Ok(())\n } else {\n let layout = artifact.storage_layout.as_ref().unwrap().clone();\n let values = fetch_storage_slots(provider, address, block, &layout).await?;\n print_storage(layout, values)\n }\n}\n\nasync fn fetch_storage_slots>(\n provider: P,\n address: Address,\n block: Option,\n layout: &StorageLayout,\n) -> Result> {\n let requests = layout.storage.iter().map(|storage_slot| async {\n let slot = B256::from(U256::from_str(&storage_slot.slot)?);\n let raw_slot_value = provider\n .get_storage_at(address, slot.into())\n .block_id(block.unwrap_or_default())\n .await?;\n\n let value = StorageValue { slot, raw_slot_value: raw_slot_value.into() };\n\n Ok(value)\n });\n\n futures::future::try_join_all(requests).await\n}\n\nfn print_storage(layout: StorageLayout, values: Vec) -> Result<()> {\n if shell::is_json() {\n let values: Vec<_> = layout\n .storage\n .iter()\n .zip(&values)\n .map(|(slot, storage_value)| {\n let storage_type = layout.types.get(&slot.storage_type);\n storage_value.value(\n slot.offset,\n storage_type.and_then(|t| t.number_of_bytes.parse::().ok()),\n )\n })\n .collect();\n sh_println!(\n \"{}\",\n serde_json::to_string_pretty(&serde_json::to_value(StorageReport { layout, values })?)?\n )?;\n return Ok(());\n }\n\n let mut table = Table::new();\n if shell::is_markdown() {\n table.load_preset(ASCII_MARKDOWN);\n } else {\n table.apply_modifier(UTF8_ROUND_CORNERS);\n }\n\n table.set_header(vec![\n Cell::new(\"Name\"),\n Cell::new(\"Type\"),\n Cell::new(\"Slot\"),\n Cell::new(\"Offset\"),\n Cell::new(\"Bytes\"),\n Cell::new(\"Value\"),\n Cell::new(\"Hex Value\"),\n Cell::new(\"Contract\"),\n ]);\n\n for (slot, storage_value) in layout.storage.into_iter().zip(values) {\n let storage_type = layout.types.get(&slot.storage_type);\n let value = storage_value\n .value(slot.offset, storage_type.and_then(|t| t.number_of_bytes.parse::().ok()));\n let converted_value = U256::from_be_bytes(value.0);\n\n table.add_row([\n slot.label.as_str(),\n storage_type.map_or(\"?\", |t| &t.label),\n &slot.slot,\n &slot.offset.to_string(),\n storage_type.map_or(\"?\", |t| &t.number_of_bytes),\n &converted_value.to_string(),\n &value.to_string(),\n &slot.contract,\n ]);\n }\n\n sh_println!(\"\\n{table}\\n\")?;\n\n Ok(())\n}\n\nfn add_storage_layout_output>(project: &mut Project) {\n project.artifacts.additional_values.storage_layout = true;\n project.update_output_selection(|selection| {\n selection.0.values_mut().for_each(|contract_selection| {\n contract_selection\n .values_mut()\n .for_each(|selection| selection.push(\"storageLayout\".to_string()))\n });\n })\n}\n\nfn is_storage_layout_empty(storage_layout: &Option) -> bool {\n if let Some(s) = storage_layout { s.storage.is_empty() } else { true }\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n\n #[test]\n fn parse_storage_etherscan_api_key() {\n let args =\n StorageArgs::parse_from([\"foundry-cli\", \"addr.eth\", \"--etherscan-api-key\", \"dummykey\"]);\n assert_eq!(args.etherscan.key(), Some(\"dummykey\".to_string()));\n\n unsafe {\n std::env::set_var(\"ETHERSCAN_API_KEY\", \"FXY\");\n }\n let config = args.load_config().unwrap();\n unsafe {\n std::env::remove_var(\"ETHERSCAN_API_KEY\");\n }\n assert_eq!(config.etherscan_api_key, Some(\"dummykey\".to_string()));\n\n let key = config.get_etherscan_api_key(None).unwrap();\n assert_eq!(key, \"dummykey\".to_string());\n }\n\n #[test]\n fn parse_solc_version_arg() {\n let args = StorageArgs::parse_from([\"foundry-cli\", \"addr.eth\", \"--solc-version\", \"0.8.10\"]);\n assert_eq!(args.solc_version, Some(Version::parse(\"0.8.10\").unwrap()));\n }\n}\n" }, { "path": "crates/cast/src/cmd/trace.rs", "content": "use alloy_eips::Encodable2718;\nuse alloy_network::AnyRpcTransaction;\nuse alloy_primitives::hex;\nuse alloy_provider::ext::TraceApi;\nuse clap::Parser;\nuse eyre::Result;\nuse foundry_cli::{\n opts::RpcOpts,\n utils::{self, LoadConfig},\n};\nuse foundry_common::stdin;\n\n/// CLI arguments for `cast trace`.\n#[derive(Debug, Parser)]\npub struct TraceArgs {\n /// Transaction hash (for trace_transaction) or raw tx hex/JSON (for trace_rawTransaction\n /// with --raw)\n tx: Option,\n\n /// Use trace_rawTransaction instead of trace_transaction.\n /// Required when passing raw transaction hex or JSON instead of a tx hash.\n #[arg(long)]\n raw: bool,\n\n /// Include the basic trace of the transaction.\n #[arg(long, requires = \"raw\")]\n trace: bool,\n\n /// Include the full trace of the virtual machine's state during transaction execution\n #[arg(long, requires = \"raw\")]\n vm_trace: bool,\n\n /// Include state changes caused by the transaction (requires --raw).\n #[arg(long, requires = \"raw\")]\n state_diff: bool,\n\n #[command(flatten)]\n rpc: RpcOpts,\n}\n\nimpl TraceArgs {\n pub async fn run(self) -> Result<()> {\n let config = self.rpc.load_config()?;\n let provider = utils::get_provider(&config)?;\n let input = stdin::unwrap_line(self.tx)?;\n\n let trimmed = input.trim();\n let is_json = trimmed.starts_with('{');\n let is_raw_hex = trimmed.starts_with(\"0x\") && trimmed.len() > 66;\n\n let result = if self.raw {\n // trace_rawTransaction: accepts raw hex OR JSON tx\n let raw_bytes = if is_raw_hex {\n hex::decode(trimmed.strip_prefix(\"0x\").unwrap_or(trimmed))?\n } else if is_json {\n let tx: AnyRpcTransaction = serde_json::from_str(trimmed)?;\n tx.as_ref().encoded_2718().to_vec()\n } else {\n hex::decode(trimmed)?\n };\n\n let mut trace_builder = provider.trace_raw_transaction(&raw_bytes);\n\n if self.trace {\n trace_builder = trace_builder.trace();\n }\n if self.vm_trace {\n trace_builder = trace_builder.vm_trace();\n }\n if self.state_diff {\n trace_builder = trace_builder.state_diff();\n }\n\n if trace_builder.get_trace_types().map(|t| t.is_empty()).unwrap_or(true) {\n eyre::bail!(\"No trace type specified. Use --trace, --vm-trace, or --state-diff\");\n }\n\n serde_json::to_string_pretty(&trace_builder.await?)?\n } else {\n // trace_transaction: use tx hash directly\n let hash = input.parse()?;\n let traces = provider.trace_transaction(hash).await?;\n serde_json::to_string_pretty(&traces)?\n };\n\n sh_println!(\"{}\", result)?;\n Ok(())\n }\n}\n" }, { "path": "crates/cast/src/cmd/txpool.rs", "content": "use alloy_primitives::Address;\nuse alloy_provider::ext::TxPoolApi;\nuse clap::Parser;\nuse foundry_cli::{\n opts::RpcOpts,\n utils::{self, LoadConfig},\n};\n\n/// CLI arguments for `cast tx-pool`.\n#[derive(Debug, Parser, Clone)]\npub enum TxPoolSubcommands {\n /// Fetches the content of the transaction pool.\n Content {\n #[command(flatten)]\n args: RpcOpts,\n },\n /// Fetches the content of the transaction pool filtered by a specific address.\n ContentFrom {\n /// The Signer to filter the transactions by.\n #[arg(short, long)]\n from: Address,\n #[command(flatten)]\n args: RpcOpts,\n },\n /// Fetches a textual summary of each transaction in the pool.\n Inspect {\n #[command(flatten)]\n args: RpcOpts,\n },\n /// Fetches the current status of the transaction pool.\n Status {\n #[command(flatten)]\n args: RpcOpts,\n },\n}\n\nimpl TxPoolSubcommands {\n pub async fn run(self) -> eyre::Result<()> {\n match self {\n Self::Content { args } => {\n let config = args.load_config()?;\n let provider = utils::get_provider(&config)?;\n let content = provider.txpool_content().await?;\n sh_println!(\"{}\", serde_json::to_string_pretty(&content)?)?;\n }\n Self::ContentFrom { from, args } => {\n let config = args.load_config()?;\n let provider = utils::get_provider(&config)?;\n let content = provider.txpool_content_from(from).await?;\n sh_println!(\"{}\", serde_json::to_string_pretty(&content)?)?;\n }\n Self::Inspect { args } => {\n let config = args.load_config()?;\n let provider = utils::get_provider(&config)?;\n let inspect = provider.txpool_inspect().await?;\n sh_println!(\"{}\", serde_json::to_string_pretty(&inspect)?)?;\n }\n Self::Status { args } => {\n let config = args.load_config()?;\n let provider = utils::get_provider(&config)?;\n let status = provider.txpool_status().await?;\n sh_println!(\"{}\", serde_json::to_string_pretty(&status)?)?;\n }\n };\n\n Ok(())\n }\n}\n" }, { "path": "crates/cast/src/cmd/wallet/list.rs", "content": "use clap::Parser;\nuse eyre::Result;\nuse std::env;\n\nuse foundry_common::{fs, sh_err, sh_println};\nuse foundry_config::Config;\nuse foundry_wallets::wallet_multi::MultiWalletOptsBuilder;\n\n/// CLI arguments for `cast wallet list`.\n#[derive(Clone, Debug, Parser)]\npub struct ListArgs {\n /// List all the accounts in the keystore directory.\n /// Default keystore directory is used if no path provided.\n #[arg(long, default_missing_value = \"\", num_args(0..=1))]\n dir: Option,\n\n /// List accounts from a Ledger hardware wallet.\n #[arg(long, short, group = \"hw-wallets\")]\n ledger: bool,\n\n /// List accounts from a Trezor hardware wallet.\n #[arg(long, short, group = \"hw-wallets\")]\n trezor: bool,\n\n /// List accounts from AWS KMS.\n ///\n /// Ensure either one of AWS_KMS_KEY_IDS (comma-separated) or AWS_KMS_KEY_ID environment\n /// variables are set.\n #[arg(long, hide = !cfg!(feature = \"aws-kms\"))]\n aws: bool,\n\n /// List accounts from Google Cloud KMS.\n ///\n /// Ensure the following environment variables are set: GCP_PROJECT_ID, GCP_LOCATION,\n /// GCP_KEY_RING, GCP_KEY_NAME, GCP_KEY_VERSION.\n ///\n /// See: \n #[arg(long, hide = !cfg!(feature = \"gcp-kms\"))]\n gcp: bool,\n\n /// List accounts from Turnkey.\n #[arg(long, hide = !cfg!(feature = \"turnkey\"))]\n turnkey: bool,\n\n /// List all configured accounts.\n #[arg(long, group = \"hw-wallets\")]\n all: bool,\n\n /// Max number of addresses to display from hardware wallets.\n #[arg(long, short, default_value = \"3\", requires = \"hw-wallets\")]\n max_senders: Option,\n}\n\nimpl ListArgs {\n pub async fn run(self) -> Result<()> {\n // list local accounts as files in keystore dir, no need to unlock / provide password\n if self.dir.is_some()\n || self.all\n || (!self.ledger && !self.trezor && !self.aws && !self.gcp)\n {\n match self.list_local_senders() {\n Ok(()) => {}\n Err(e) if !self.all => {\n sh_err!(\"{}\", e)?;\n }\n _ => {}\n }\n }\n\n // Create options for multi wallet - ledger, trezor and AWS\n let list_opts = MultiWalletOptsBuilder::default()\n .ledger(self.ledger || self.all)\n .mnemonic_indexes(Some(vec![0]))\n .trezor(self.trezor || self.all)\n .aws(self.aws || self.all)\n .gcp(self.gcp || (self.all && gcp_env_vars_set()))\n .turnkey(self.turnkey || self.all)\n .interactives(0)\n .interactive(false)\n .browser(Default::default())\n .build()\n .expect(\"build multi wallet\");\n\n // macro to print senders for a list of signers\n macro_rules! list_senders {\n ($signers:expr, $label:literal) => {\n match $signers.await {\n Ok(signers) => {\n for signer in signers.unwrap_or_default().iter() {\n signer\n .available_senders(self.max_senders.unwrap())\n .await?\n .iter()\n .for_each(|sender| {\n let _ = sh_println!(\"{} ({})\", sender, $label);\n })\n }\n }\n Err(e) if !self.all => {\n sh_err!(\"{}\", e)?;\n }\n _ => {}\n }\n };\n }\n\n list_senders!(list_opts.ledgers(), \"Ledger\");\n list_senders!(list_opts.trezors(), \"Trezor\");\n list_senders!(list_opts.aws_signers(), \"AWS\");\n list_senders!(list_opts.gcp_signers(), \"GCP\");\n\n Ok(())\n }\n\n fn list_local_senders(&self) -> Result<()> {\n let keystore_path = self.dir.as_deref().unwrap_or_default();\n let keystore_dir = if keystore_path.is_empty() {\n // Create the keystore default directory if it doesn't exist\n let default_dir = Config::foundry_keystores_dir().unwrap();\n fs::create_dir_all(&default_dir)?;\n default_dir\n } else {\n dunce::canonicalize(keystore_path)?\n };\n\n // List all files within the keystore directory.\n for entry in std::fs::read_dir(keystore_dir)? {\n let path = entry?.path();\n if path.is_file()\n && let Some(file_name) = path.file_name()\n && let Some(name) = file_name.to_str()\n {\n // Extract address from keystore filename format: UTC--{timestamp}--{address}\n if let Some(address) = name.split(\"--\").last() {\n sh_println!(\"0x{} (Local)\", address)?;\n }\n }\n }\n\n Ok(())\n }\n}\n\nfn gcp_env_vars_set() -> bool {\n let required_vars =\n [\"GCP_PROJECT_ID\", \"GCP_LOCATION\", \"GCP_KEY_RING\", \"GCP_KEY_NAME\", \"GCP_KEY_VERSION\"];\n\n required_vars.iter().all(|&var| env::var(var).is_ok())\n}\n" }, { "path": "crates/cast/src/cmd/wallet/mod.rs", "content": "use alloy_chains::Chain;\nuse alloy_dyn_abi::TypedData;\nuse alloy_primitives::{Address, B256, Signature, U256, hex};\nuse alloy_provider::Provider;\nuse alloy_rpc_types::Authorization;\nuse alloy_signer::Signer;\nuse alloy_signer_local::{\n MnemonicBuilder, PrivateKeySigner,\n coins_bip39::{English, Entropy, Mnemonic},\n};\nuse clap::Parser;\nuse eyre::{Context, Result};\nuse foundry_cli::{opts::RpcOpts, utils, utils::LoadConfig};\nuse foundry_common::{fs, sh_println, shell};\nuse foundry_config::Config;\nuse foundry_wallets::{RawWalletOpts, WalletOpts, WalletSigner};\nuse rand_08::thread_rng;\nuse serde_json::json;\nuse std::path::Path;\nuse yansi::Paint;\n\npub mod vanity;\nuse vanity::VanityArgs;\n\npub mod list;\nuse list::ListArgs;\n\n/// CLI arguments for `cast wallet`.\n#[derive(Debug, Parser)]\npub enum WalletSubcommands {\n /// Create a new random keypair.\n #[command(visible_alias = \"n\")]\n New {\n /// If provided, then keypair will be written to an encrypted JSON keystore.\n path: Option,\n\n /// Account name for the keystore file. If provided, the keystore file\n /// will be named using this account name.\n #[arg(value_name = \"ACCOUNT_NAME\")]\n account_name: Option,\n\n /// Triggers a hidden password prompt for the JSON keystore.\n ///\n /// Deprecated: prompting for a hidden password is now the default.\n #[arg(long, short, conflicts_with = \"unsafe_password\")]\n password: bool,\n\n /// Password for the JSON keystore in cleartext.\n ///\n /// This is UNSAFE to use and we recommend using the --password.\n #[arg(long, env = \"CAST_PASSWORD\", value_name = \"PASSWORD\")]\n unsafe_password: Option,\n\n /// Number of wallets to generate.\n #[arg(long, short, default_value = \"1\")]\n number: u32,\n\n /// Overwrite existing keystore files without prompting.\n #[arg(long)]\n force: bool,\n },\n\n /// Generates a random BIP39 mnemonic phrase\n #[command(visible_alias = \"nm\")]\n NewMnemonic {\n /// Number of words for the mnemonic\n #[arg(long, short, default_value = \"12\")]\n words: usize,\n\n /// Number of accounts to display\n #[arg(long, short, default_value = \"1\")]\n accounts: u8,\n\n /// Entropy to use for the mnemonic\n #[arg(long, short, conflicts_with = \"words\")]\n entropy: Option,\n },\n\n /// Generate a vanity address.\n #[command(visible_alias = \"va\")]\n Vanity(VanityArgs),\n\n /// Convert a private key to an address.\n #[command(visible_aliases = &[\"a\", \"addr\"])]\n Address {\n /// If provided, the address will be derived from the specified private key.\n #[arg(value_name = \"PRIVATE_KEY\")]\n private_key_override: Option,\n\n #[command(flatten)]\n wallet: WalletOpts,\n },\n\n /// Derive accounts from a mnemonic\n #[command(visible_alias = \"d\")]\n Derive {\n /// The accounts will be derived from the specified mnemonic phrase.\n #[arg(value_name = \"MNEMONIC\")]\n mnemonic: String,\n\n /// Number of accounts to display.\n #[arg(long, short, default_value = \"1\")]\n accounts: Option,\n\n /// Insecure mode: display private keys in the terminal.\n #[arg(long, default_value = \"false\")]\n insecure: bool,\n },\n\n /// Sign a message or typed data.\n #[command(visible_alias = \"s\")]\n Sign {\n /// The message, typed data, or hash to sign.\n ///\n /// Messages starting with 0x are expected to be hex encoded, which get decoded before\n /// being signed.\n ///\n /// The message will be prefixed with the Ethereum Signed Message header and hashed before\n /// signing, unless `--no-hash` is provided.\n ///\n /// Typed data can be provided as a json string or a file name.\n /// Use --data flag to denote the message is a string of typed data.\n /// Use --data --from-file to denote the message is a file name containing typed data.\n /// The data will be combined and hashed using the EIP712 specification before signing.\n /// The data should be formatted as JSON.\n message: String,\n\n /// Treat the message as JSON typed data.\n #[arg(long)]\n data: bool,\n\n /// Treat the message as a file containing JSON typed data. Requires `--data`.\n #[arg(long, requires = \"data\")]\n from_file: bool,\n\n /// Treat the message as a raw 32-byte hash and sign it directly without hashing it again.\n #[arg(long, conflicts_with = \"data\")]\n no_hash: bool,\n\n #[command(flatten)]\n wallet: WalletOpts,\n },\n\n /// EIP-7702 sign authorization.\n #[command(visible_alias = \"sa\")]\n SignAuth {\n /// Address to sign authorization for.\n address: Address,\n\n #[command(flatten)]\n rpc: RpcOpts,\n\n #[arg(long)]\n nonce: Option,\n\n #[arg(long)]\n chain: Option,\n\n /// If set, indicates the authorization will be broadcast by the signing account itself.\n /// This means the nonce used will be the current nonce + 1 (to account for the\n /// transaction that will include this authorization).\n #[arg(long, conflicts_with = \"nonce\")]\n self_broadcast: bool,\n\n #[command(flatten)]\n wallet: WalletOpts,\n },\n\n /// Verify the signature of a message.\n #[command(visible_alias = \"v\")]\n Verify {\n /// The original message.\n ///\n /// Treats 0x-prefixed strings as hex encoded bytes.\n /// Non 0x-prefixed strings are treated as raw input message.\n ///\n /// The message will be prefixed with the Ethereum Signed Message header and hashed before\n /// signing, unless `--no-hash` is provided.\n ///\n /// Typed data can be provided as a json string or a file name.\n /// Use --data flag to denote the message is a string of typed data.\n /// Use --data --from-file to denote the message is a file name containing typed data.\n /// The data will be combined and hashed using the EIP712 specification before signing.\n /// The data should be formatted as JSON.\n message: String,\n\n /// The signature to verify.\n signature: Signature,\n\n /// The address of the message signer.\n #[arg(long, short)]\n address: Address,\n\n /// Treat the message as JSON typed data.\n #[arg(long)]\n data: bool,\n\n /// Treat the message as a file containing JSON typed data. Requires `--data`.\n #[arg(long, requires = \"data\")]\n from_file: bool,\n\n /// Treat the message as a raw 32-byte hash and sign it directly without hashing it again.\n #[arg(long, conflicts_with = \"data\")]\n no_hash: bool,\n },\n\n /// Import a private key into an encrypted keystore.\n #[command(visible_alias = \"i\")]\n Import {\n /// The name for the account in the keystore.\n #[arg(value_name = \"ACCOUNT_NAME\")]\n account_name: String,\n /// If provided, keystore will be saved here instead of the default keystores directory\n /// (~/.foundry/keystores)\n #[arg(long, short)]\n keystore_dir: Option,\n /// Password for the JSON keystore in cleartext\n /// This is unsafe, we recommend using the default hidden password prompt\n #[arg(long, env = \"CAST_UNSAFE_PASSWORD\", value_name = \"PASSWORD\")]\n unsafe_password: Option,\n #[command(flatten)]\n raw_wallet_options: RawWalletOpts,\n },\n\n /// List all the accounts in the keystore default directory\n #[command(visible_alias = \"ls\")]\n List(ListArgs),\n\n /// Remove a wallet from the keystore.\n ///\n /// This command requires the wallet alias and will prompt for a password to ensure that only\n /// an authorized user can remove the wallet.\n #[command(visible_aliases = &[\"rm\"], override_usage = \"cast wallet remove --name \")]\n Remove {\n /// The alias (or name) of the wallet to remove.\n #[arg(long, required = true)]\n name: String,\n /// Optionally provide the keystore directory if not provided. default directory will be\n /// used (~/.foundry/keystores).\n #[arg(long)]\n dir: Option,\n /// Password for the JSON keystore in cleartext\n /// This is unsafe, we recommend using the default hidden password prompt\n #[arg(long, env = \"CAST_UNSAFE_PASSWORD\", value_name = \"PASSWORD\")]\n unsafe_password: Option,\n },\n\n /// Derives private key from mnemonic\n #[command(name = \"private-key\", visible_alias = \"pk\", aliases = &[\"derive-private-key\", \"--derive-private-key\"])]\n PrivateKey {\n /// If provided, the private key will be derived from the specified mnemonic phrase.\n #[arg(value_name = \"MNEMONIC\")]\n mnemonic_override: Option,\n\n /// If provided, the private key will be derived using the\n /// specified mnemonic index (if integer) or derivation path.\n #[arg(value_name = \"MNEMONIC_INDEX_OR_DERIVATION_PATH\")]\n mnemonic_index_or_derivation_path_override: Option,\n\n #[command(flatten)]\n wallet: WalletOpts,\n },\n /// Get the public key for the given private key.\n #[command(visible_aliases = &[\"pubkey\"])]\n PublicKey {\n /// If provided, the public key will be derived from the specified private key.\n #[arg(long = \"raw-private-key\", value_name = \"PRIVATE_KEY\")]\n private_key_override: Option,\n\n #[command(flatten)]\n wallet: WalletOpts,\n },\n /// Decrypt a keystore file to get the private key\n #[command(name = \"decrypt-keystore\", visible_alias = \"dk\")]\n DecryptKeystore {\n /// The name for the account in the keystore.\n #[arg(value_name = \"ACCOUNT_NAME\")]\n account_name: String,\n /// If not provided, keystore will try to be located at the default keystores directory\n /// (~/.foundry/keystores)\n #[arg(long, short)]\n keystore_dir: Option,\n /// Password for the JSON keystore in cleartext\n /// This is unsafe, we recommend using the default hidden password prompt\n #[arg(long, env = \"CAST_UNSAFE_PASSWORD\", value_name = \"PASSWORD\")]\n unsafe_password: Option,\n },\n\n /// Change the password of a keystore file\n #[command(name = \"change-password\", visible_alias = \"cp\")]\n ChangePassword {\n /// The name for the account in the keystore.\n #[arg(value_name = \"ACCOUNT_NAME\")]\n account_name: String,\n /// If not provided, keystore will try to be located at the default keystores directory\n /// (~/.foundry/keystores)\n #[arg(long, short)]\n keystore_dir: Option,\n /// Current password for the JSON keystore in cleartext\n /// This is unsafe, we recommend using the default hidden password prompt\n #[arg(long, env = \"CAST_UNSAFE_PASSWORD\", value_name = \"PASSWORD\")]\n unsafe_password: Option,\n /// New password for the JSON keystore in cleartext\n /// This is unsafe, we recommend using the default hidden password prompt\n #[arg(long, env = \"CAST_UNSAFE_NEW_PASSWORD\", value_name = \"NEW_PASSWORD\")]\n unsafe_new_password: Option,\n },\n}\n\nimpl WalletSubcommands {\n pub async fn run(self) -> Result<()> {\n match self {\n Self::New { path, account_name, unsafe_password, number, password, force } => {\n let mut rng = thread_rng();\n\n let mut json_values = if shell::is_json() { Some(vec![]) } else { None };\n\n let path = if let Some(path) = path {\n match dunce::canonicalize(&path) {\n Ok(path) => {\n if !path.is_dir() {\n // we require path to be an existing directory\n eyre::bail!(\"`{}` is not a directory\", path.display());\n }\n Some(path)\n }\n Err(e) => {\n eyre::bail!(\n \"If you specified a directory, please make sure it exists, or create it before running `cast wallet new `.\\n{path} is not a directory.\\nError: {}\",\n e\n );\n }\n }\n } else if unsafe_password.is_some() || password {\n let path = Config::foundry_keystores_dir().ok_or_else(|| {\n eyre::eyre!(\"Could not find the default keystore directory.\")\n })?;\n fs::create_dir_all(&path)?;\n Some(path)\n } else {\n None\n };\n\n match path {\n Some(path) => {\n let password = if let Some(password) = unsafe_password {\n password\n } else {\n // if no --unsafe-password was provided read via stdin\n rpassword::prompt_password(\"Enter secret: \")?\n };\n\n // Prevent accidental overwriting: check all target files upfront\n if !force && let Some(ref acc_name) = account_name {\n let mut existing_files = Vec::new();\n\n for i in 0..number {\n let name = match number {\n 1 => acc_name.to_string(),\n _ => format!(\"{}_{}\", acc_name, i + 1),\n };\n let file_path = path.join(&name);\n if file_path.exists() {\n existing_files.push(name);\n }\n }\n\n if !existing_files.is_empty() {\n use std::io::Write;\n\n sh_eprintln!(\"The following keystore file(s) already exist:\")?;\n for file in &existing_files {\n sh_eprintln!(\" - {file}\")?;\n }\n sh_print!(\n \"\\nDo you want to overwrite all {} file(s)? [y/N]: \",\n existing_files.len()\n )?;\n std::io::stdout().flush()?;\n\n let mut input = String::new();\n std::io::stdin().read_line(&mut input)?;\n\n if !input.trim().eq_ignore_ascii_case(\"y\") {\n eyre::bail!(\"Operation cancelled. No keystores were modified.\");\n }\n }\n }\n for i in 0..number {\n let account_name_ref =\n account_name.as_deref().map(|name| match number {\n 1 => name.to_string(),\n _ => format!(\"{}_{}\", name, i + 1),\n });\n\n let (wallet, uuid) = PrivateKeySigner::new_keystore(\n &path,\n &mut rng,\n password.clone(),\n account_name_ref.as_deref(),\n )?;\n let identifier = account_name_ref.as_deref().unwrap_or(&uuid);\n\n if let Some(json) = json_values.as_mut() {\n json.push(if shell::verbosity() > 0 {\n json!({\n \"address\": wallet.address().to_checksum(None),\n \"public_key\": format!(\"0x{}\", hex::encode(wallet.public_key())),\n \"path\": format!(\"{}\", path.join(identifier).display()),\n })\n } else {\n json!({\n \"address\": wallet.address().to_checksum(None),\n \"path\": format!(\"{}\", path.join(identifier).display()),\n })\n });\n } else {\n sh_println!(\n \"Created new encrypted keystore file: {}\",\n path.join(identifier).display()\n )?;\n sh_println!(\"Address: {}\", wallet.address().to_checksum(None))?;\n if shell::verbosity() > 0 {\n sh_println!(\n \"Public key: 0x{}\",\n hex::encode(wallet.public_key())\n )?;\n }\n }\n }\n }\n None => {\n for _ in 0..number {\n let wallet = PrivateKeySigner::random_with(&mut rng);\n\n if let Some(json) = json_values.as_mut() {\n json.push(if shell::verbosity() > 0 {\n json!({\n \"address\": wallet.address().to_checksum(None),\n \"public_key\": format!(\"0x{}\", hex::encode(wallet.public_key())),\n \"private_key\": format!(\"0x{}\", hex::encode(wallet.credential().to_bytes())),\n })\n } else {\n json!({\n \"address\": wallet.address().to_checksum(None),\n \"private_key\": format!(\"0x{}\", hex::encode(wallet.credential().to_bytes())),\n })\n });\n } else {\n sh_println!(\"Successfully created new keypair.\")?;\n sh_println!(\"Address: {}\", wallet.address().to_checksum(None))?;\n if shell::verbosity() > 0 {\n sh_println!(\n \"Public key: 0x{}\",\n hex::encode(wallet.public_key())\n )?;\n }\n sh_println!(\n \"Private key: 0x{}\",\n hex::encode(wallet.credential().to_bytes())\n )?;\n }\n }\n }\n }\n\n if let Some(json) = json_values.as_ref() {\n sh_println!(\"{}\", serde_json::to_string_pretty(json)?)?;\n }\n }\n Self::NewMnemonic { words, accounts, entropy } => {\n let phrase = if let Some(entropy) = entropy {\n let entropy = Entropy::from_slice(hex::decode(entropy)?)?;\n Mnemonic::::new_from_entropy(entropy).to_phrase()\n } else {\n let mut rng = thread_rng();\n Mnemonic::::new_with_count(&mut rng, words)?.to_phrase()\n };\n\n let format_json = shell::is_json();\n\n if !format_json {\n sh_println!(\"{}\", \"Generating mnemonic from provided entropy...\".yellow())?;\n }\n\n let builder = MnemonicBuilder::::default().phrase(phrase.as_str());\n let derivation_path = \"m/44'/60'/0'/0/\";\n let wallets = (0..accounts)\n .map(|i| builder.clone().derivation_path(format!(\"{derivation_path}{i}\")))\n .collect::, _>>()?;\n let wallets =\n wallets.into_iter().map(|b| b.build()).collect::, _>>()?;\n\n if !format_json {\n sh_println!(\"{}\", \"Successfully generated a new mnemonic.\".green())?;\n sh_println!(\"Phrase:\\n{phrase}\")?;\n sh_println!(\"\\nAccounts:\")?;\n }\n\n let mut accounts = json!([]);\n for (i, wallet) in wallets.iter().enumerate() {\n let public_key = hex::encode(wallet.public_key());\n let private_key = hex::encode(wallet.credential().to_bytes());\n if format_json {\n accounts.as_array_mut().unwrap().push(if shell::verbosity() > 0 {\n json!({\n \"address\": format!(\"{}\", wallet.address()),\n \"public_key\": format!(\"0x{}\", public_key),\n \"private_key\": format!(\"0x{}\", private_key),\n })\n } else {\n json!({\n \"address\": format!(\"{}\", wallet.address()),\n \"private_key\": format!(\"0x{}\", private_key),\n })\n });\n } else {\n sh_println!(\"- Account {i}:\")?;\n sh_println!(\"Address: {}\", wallet.address())?;\n if shell::verbosity() > 0 {\n sh_println!(\"Public key: 0x{}\", public_key)?;\n }\n sh_println!(\"Private key: 0x{}\\n\", private_key)?;\n }\n }\n\n if format_json {\n let obj = json!({\n \"mnemonic\": phrase,\n \"accounts\": accounts,\n });\n sh_println!(\"{}\", serde_json::to_string_pretty(&obj)?)?;\n }\n }\n Self::Vanity(cmd) => {\n cmd.run()?;\n }\n Self::Address { wallet, private_key_override } => {\n let wallet = private_key_override\n .map(|pk| WalletOpts {\n raw: RawWalletOpts { private_key: Some(pk), ..Default::default() },\n ..Default::default()\n })\n .unwrap_or(wallet)\n .signer()\n .await?;\n let addr = wallet.address();\n sh_println!(\"{}\", addr.to_checksum(None))?;\n }\n Self::Derive { mnemonic, accounts, insecure } => {\n let format_json = shell::is_json();\n let mut accounts_json = json!([]);\n for i in 0..accounts.unwrap_or(1) {\n let wallet = WalletOpts {\n raw: RawWalletOpts {\n mnemonic: Some(mnemonic.clone()),\n mnemonic_index: i as u32,\n ..Default::default()\n },\n ..Default::default()\n }\n .signer()\n .await?;\n\n match wallet {\n WalletSigner::Local(local_wallet) => {\n let address = local_wallet.address().to_checksum(None);\n let private_key = hex::encode(local_wallet.credential().to_bytes());\n if format_json {\n if insecure {\n accounts_json.as_array_mut().unwrap().push(json!({\n \"address\": format!(\"{}\", address),\n \"private_key\": format!(\"0x{}\", private_key),\n }));\n } else {\n accounts_json.as_array_mut().unwrap().push(json!({\n \"address\": format!(\"{}\", address)\n }));\n }\n } else {\n sh_println!(\"- Account {i}:\")?;\n if insecure {\n sh_println!(\"Address: {}\", address)?;\n sh_println!(\"Private key: 0x{}\\n\", private_key)?;\n } else {\n sh_println!(\"Address: {}\\n\", address)?;\n }\n }\n }\n _ => eyre::bail!(\"Only local wallets are supported by this command\"),\n }\n }\n\n if format_json {\n sh_println!(\"{}\", serde_json::to_string_pretty(&accounts_json)?)?;\n }\n }\n Self::PublicKey { wallet, private_key_override } => {\n let wallet = private_key_override\n .map(|pk| WalletOpts {\n raw: RawWalletOpts { private_key: Some(pk), ..Default::default() },\n ..Default::default()\n })\n .unwrap_or(wallet)\n .signer()\n .await?;\n\n let public_key = match wallet {\n WalletSigner::Local(wallet) => wallet.public_key(),\n _ => eyre::bail!(\"Only local wallets are supported by this command\"),\n };\n\n sh_println!(\"0x{}\", hex::encode(public_key))?;\n }\n Self::Sign { message, data, from_file, no_hash, wallet } => {\n let wallet = wallet.signer().await?;\n let sig = if data {\n let typed_data: TypedData = if from_file {\n // data is a file name, read json from file\n foundry_common::fs::read_json_file(message.as_ref())?\n } else {\n // data is a json string\n serde_json::from_str(&message)?\n };\n wallet.sign_dynamic_typed_data(&typed_data).await?\n } else if no_hash {\n wallet.sign_hash(&hex::decode(&message)?[..].try_into()?).await?\n } else {\n wallet.sign_message(&Self::hex_str_to_bytes(&message)?).await?\n };\n\n if shell::verbosity() > 0 {\n if shell::is_json() {\n sh_println!(\n \"{}\",\n serde_json::to_string_pretty(&json!({\n \"message\": message,\n \"address\": wallet.address(),\n \"signature\": hex::encode(sig.as_bytes()),\n }))?\n )?;\n } else {\n sh_println!(\n \"Successfully signed!\\n Message: {}\\n Address: {}\\n Signature: 0x{}\",\n message,\n wallet.address(),\n hex::encode(sig.as_bytes()),\n )?;\n }\n } else {\n // Pipe friendly output\n sh_println!(\"0x{}\", hex::encode(sig.as_bytes()))?;\n }\n }\n Self::SignAuth { rpc, nonce, chain, wallet, address, self_broadcast } => {\n let wallet = wallet.signer().await?;\n let provider = utils::get_provider(&rpc.load_config()?)?;\n let nonce = if let Some(nonce) = nonce {\n nonce\n } else {\n let current_nonce = provider.get_transaction_count(wallet.address()).await?;\n if self_broadcast {\n // When self-broadcasting, the authorization nonce needs to be +1\n // because the transaction itself will consume the current nonce\n current_nonce + 1\n } else {\n current_nonce\n }\n };\n let chain_id = if let Some(chain) = chain {\n chain.id()\n } else {\n provider.get_chain_id().await?\n };\n let auth = Authorization { chain_id: U256::from(chain_id), address, nonce };\n let signature = wallet.sign_hash(&auth.signature_hash()).await?;\n let auth = auth.into_signed(signature);\n\n if shell::verbosity() > 0 {\n if shell::is_json() {\n sh_println!(\n \"{}\",\n serde_json::to_string_pretty(&json!({\n \"nonce\": nonce,\n \"chain_id\": chain_id,\n \"address\": wallet.address(),\n \"signature\": hex::encode_prefixed(alloy_rlp::encode(&auth)),\n }))?\n )?;\n } else {\n sh_println!(\n \"Successfully signed!\\n Nonce: {}\\n Chain ID: {}\\n Address: {}\\n Signature: 0x{}\",\n nonce,\n chain_id,\n wallet.address(),\n hex::encode_prefixed(alloy_rlp::encode(&auth)),\n )?;\n }\n } else {\n // Pipe friendly output\n sh_println!(\"{}\", hex::encode_prefixed(alloy_rlp::encode(&auth)))?;\n }\n }\n Self::Verify { message, signature, address, data, from_file, no_hash } => {\n let recovered_address = if data {\n let typed_data: TypedData = if from_file {\n // data is a file name, read json from file\n foundry_common::fs::read_json_file(message.as_ref())?\n } else {\n // data is a json string\n serde_json::from_str(&message)?\n };\n Self::recover_address_from_typed_data(&typed_data, &signature)?\n } else if no_hash {\n Self::recover_address_from_message_no_hash(\n &hex::decode(&message)?[..].try_into()?,\n &signature,\n )?\n } else {\n Self::recover_address_from_message(&message, &signature)?\n };\n\n if address == recovered_address {\n sh_println!(\"Validation succeeded. Address {address} signed this message.\")?;\n } else {\n eyre::bail!(\"Validation failed. Address {address} did not sign this message.\");\n }\n }\n Self::Import { account_name, keystore_dir, unsafe_password, raw_wallet_options } => {\n // Set up keystore directory\n let dir = if let Some(path) = keystore_dir {\n Path::new(&path).to_path_buf()\n } else {\n Config::foundry_keystores_dir().ok_or_else(|| {\n eyre::eyre!(\"Could not find the default keystore directory.\")\n })?\n };\n\n fs::create_dir_all(&dir)?;\n\n // check if account exists already\n let keystore_path = Path::new(&dir).join(&account_name);\n if keystore_path.exists() {\n eyre::bail!(\"Keystore file already exists at {}\", keystore_path.display());\n }\n\n // get wallet\n let wallet = raw_wallet_options\n .signer()?\n .and_then(|s| match s {\n WalletSigner::Local(s) => Some(s),\n _ => None,\n })\n .ok_or_else(|| {\n eyre::eyre!(\n \"\\\nDid you set a private key or mnemonic?\nRun `cast wallet import --help` and use the corresponding CLI\nflag to set your key via:\n--private-key, --mnemonic-path or --interactive.\"\n )\n })?;\n\n let private_key = wallet.credential().to_bytes();\n let password = if let Some(password) = unsafe_password {\n password\n } else {\n // if no --unsafe-password was provided read via stdin\n rpassword::prompt_password(\"Enter password: \")?\n };\n\n let mut rng = thread_rng();\n let (wallet, _) = PrivateKeySigner::encrypt_keystore(\n dir,\n &mut rng,\n private_key,\n password,\n Some(&account_name),\n )?;\n let address = wallet.address();\n let success_message = format!(\n \"`{}` keystore was saved successfully. Address: {:?}\",\n &account_name, address,\n );\n sh_println!(\"{}\", success_message.green())?;\n }\n Self::List(cmd) => {\n cmd.run().await?;\n }\n Self::Remove { name, dir, unsafe_password } => {\n let dir = if let Some(path) = dir {\n Path::new(&path).to_path_buf()\n } else {\n Config::foundry_keystores_dir().ok_or_else(|| {\n eyre::eyre!(\"Could not find the default keystore directory.\")\n })?\n };\n\n let keystore_path = Path::new(&dir).join(&name);\n if !keystore_path.exists() {\n eyre::bail!(\"Keystore file does not exist at {}\", keystore_path.display());\n }\n\n let password = if let Some(pwd) = unsafe_password {\n pwd\n } else {\n rpassword::prompt_password(\"Enter password: \")?\n };\n\n if PrivateKeySigner::decrypt_keystore(&keystore_path, password).is_err() {\n eyre::bail!(\"Invalid password - wallet removal cancelled\");\n }\n\n std::fs::remove_file(&keystore_path).wrap_err_with(|| {\n format!(\"Failed to remove keystore file at {}\", keystore_path.display())\n })?;\n\n let success_message = format!(\"`{}` keystore was removed successfully.\", &name);\n sh_println!(\"{}\", success_message.green())?;\n }\n Self::PrivateKey {\n wallet,\n mnemonic_override,\n mnemonic_index_or_derivation_path_override,\n } => {\n let (index_override, derivation_path_override) =\n match mnemonic_index_or_derivation_path_override {\n Some(value) => match value.parse::() {\n Ok(index) => (Some(index), None),\n Err(_) => (None, Some(value)),\n },\n None => (None, None),\n };\n let wallet = WalletOpts {\n raw: RawWalletOpts {\n mnemonic: mnemonic_override.or(wallet.raw.mnemonic),\n mnemonic_index: index_override.unwrap_or(wallet.raw.mnemonic_index),\n hd_path: derivation_path_override.or(wallet.raw.hd_path),\n ..wallet.raw\n },\n ..wallet\n }\n .signer()\n .await?;\n match wallet {\n WalletSigner::Local(wallet) => {\n if shell::verbosity() > 0 {\n sh_println!(\"Address: {}\", wallet.address())?;\n sh_println!(\n \"Private key: 0x{}\",\n hex::encode(wallet.credential().to_bytes())\n )?;\n } else {\n sh_println!(\"0x{}\", hex::encode(wallet.credential().to_bytes()))?;\n }\n }\n _ => {\n eyre::bail!(\"Only local wallets are supported by this command.\");\n }\n }\n }\n Self::DecryptKeystore { account_name, keystore_dir, unsafe_password } => {\n // Set up keystore directory\n let dir = if let Some(path) = keystore_dir {\n Path::new(&path).to_path_buf()\n } else {\n Config::foundry_keystores_dir().ok_or_else(|| {\n eyre::eyre!(\"Could not find the default keystore directory.\")\n })?\n };\n\n let keypath = dir.join(&account_name);\n\n if !keypath.exists() {\n eyre::bail!(\"Keystore file does not exist at {}\", keypath.display());\n }\n\n let password = if let Some(password) = unsafe_password {\n password\n } else {\n // if no --unsafe-password was provided read via stdin\n rpassword::prompt_password(\"Enter password: \")?\n };\n\n let wallet = PrivateKeySigner::decrypt_keystore(keypath, password)?;\n\n let private_key = B256::from_slice(&wallet.credential().to_bytes());\n\n let success_message =\n format!(\"{}'s private key is: {}\", &account_name, private_key);\n\n sh_println!(\"{}\", success_message.green())?;\n }\n Self::ChangePassword {\n account_name,\n keystore_dir,\n unsafe_password,\n unsafe_new_password,\n } => {\n // Set up keystore directory\n let dir = if let Some(path) = keystore_dir {\n Path::new(&path).to_path_buf()\n } else {\n Config::foundry_keystores_dir().ok_or_else(|| {\n eyre::eyre!(\"Could not find the default keystore directory.\")\n })?\n };\n\n let keypath = dir.join(&account_name);\n\n if !keypath.exists() {\n eyre::bail!(\"Keystore file does not exist at {}\", keypath.display());\n }\n\n let current_password = if let Some(password) = unsafe_password {\n password\n } else {\n // if no --unsafe-password was provided read via stdin\n rpassword::prompt_password(\"Enter current password: \")?\n };\n\n // decrypt the keystore to verify the current password and get the private key\n let wallet = PrivateKeySigner::decrypt_keystore(&keypath, current_password.clone())\n .map_err(|_| eyre::eyre!(\"Invalid password - password change cancelled\"))?;\n\n let new_password = if let Some(password) = unsafe_new_password {\n password\n } else {\n // if no --unsafe-new-password was provided read via stdin\n rpassword::prompt_password(\"Enter new password: \")?\n };\n\n if current_password == new_password {\n eyre::bail!(\"New password cannot be the same as the current password\");\n }\n\n // Create a new keystore with the new password\n let private_key = wallet.credential().to_bytes();\n let mut rng = thread_rng();\n let (wallet, _) = PrivateKeySigner::encrypt_keystore(\n dir,\n &mut rng,\n private_key,\n new_password,\n Some(&account_name),\n )?;\n\n let success_message = format!(\n \"Password for keystore `{}` was changed successfully. Address: {:?}\",\n &account_name,\n wallet.address(),\n );\n sh_println!(\"{}\", success_message.green())?;\n }\n };\n\n Ok(())\n }\n\n /// Recovers an address from the specified message and signature.\n ///\n /// Note: This attempts to decode the message as hex if it starts with 0x.\n fn recover_address_from_message(message: &str, signature: &Signature) -> Result
{\n let message = Self::hex_str_to_bytes(message)?;\n Ok(signature.recover_address_from_msg(message)?)\n }\n\n /// Recovers an address from the specified message and signature.\n fn recover_address_from_message_no_hash(\n prehash: &B256,\n signature: &Signature,\n ) -> Result
{\n Ok(signature.recover_address_from_prehash(prehash)?)\n }\n\n /// Recovers an address from the specified EIP-712 typed data and signature.\n fn recover_address_from_typed_data(\n typed_data: &TypedData,\n signature: &Signature,\n ) -> Result
{\n Ok(signature.recover_address_from_prehash(&typed_data.eip712_signing_hash()?)?)\n }\n\n /// Strips the 0x prefix from a hex string and decodes it to bytes.\n ///\n /// Treats the string as raw bytes if it doesn't start with 0x.\n fn hex_str_to_bytes(s: &str) -> Result> {\n Ok(match s.strip_prefix(\"0x\") {\n Some(data) => hex::decode(data).wrap_err(\"Could not decode 0x-prefixed string.\")?,\n None => s.as_bytes().to_vec(),\n })\n }\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n use alloy_primitives::{address, keccak256};\n use std::str::FromStr;\n\n #[test]\n fn can_parse_wallet_sign_message() {\n let args = WalletSubcommands::parse_from([\"foundry-cli\", \"sign\", \"deadbeef\"]);\n match args {\n WalletSubcommands::Sign { message, data, from_file, .. } => {\n assert_eq!(message, \"deadbeef\".to_string());\n assert!(!data);\n assert!(!from_file);\n }\n _ => panic!(\"expected WalletSubcommands::Sign\"),\n }\n }\n\n #[test]\n fn can_parse_wallet_sign_hex_message() {\n let args = WalletSubcommands::parse_from([\"foundry-cli\", \"sign\", \"0xdeadbeef\"]);\n match args {\n WalletSubcommands::Sign { message, data, from_file, .. } => {\n assert_eq!(message, \"0xdeadbeef\".to_string());\n assert!(!data);\n assert!(!from_file);\n }\n _ => panic!(\"expected WalletSubcommands::Sign\"),\n }\n }\n\n #[test]\n fn can_verify_signed_hex_message() {\n let message = \"hello\";\n let signature = Signature::from_str(\"f2dd00eac33840c04b6fc8a5ec8c4a47eff63575c2bc7312ecb269383de0c668045309c423484c8d097df306e690c653f8e1ec92f7f6f45d1f517027771c3e801c\").unwrap();\n let address = address!(\"0x28A4F420a619974a2393365BCe5a7b560078Cc13\");\n let recovered_address =\n WalletSubcommands::recover_address_from_message(message, &signature);\n assert!(recovered_address.is_ok());\n assert_eq!(address, recovered_address.unwrap());\n }\n\n #[test]\n fn can_verify_signed_hex_message_no_hash() {\n let prehash = keccak256(\"hello\");\n let signature = Signature::from_str(\"433ec3d37e4f1253df15e2dea412fed8e915737730f74b3dfb1353268f932ef5557c9158e0b34bce39de28d11797b42e9b1acb2749230885fe075aedc3e491a41b\").unwrap();\n let address = address!(\"0x7E5F4552091A69125d5DfCb7b8C2659029395Bdf\"); // private key = 1\n let recovered_address =\n WalletSubcommands::recover_address_from_message_no_hash(&prehash, &signature);\n assert!(recovered_address.is_ok());\n assert_eq!(address, recovered_address.unwrap());\n }\n\n #[test]\n fn can_verify_signed_typed_data() {\n let typed_data: TypedData = serde_json::from_str(r#\"{\"domain\":{\"name\":\"Test\",\"version\":\"1\",\"chainId\":1,\"verifyingContract\":\"0xDeaDbeefdEAdbeefdEadbEEFdeadbeEFdEaDbeeF\"},\"message\":{\"value\":123},\"primaryType\":\"Data\",\"types\":{\"Data\":[{\"name\":\"value\",\"type\":\"uint256\"}]}}\"#).unwrap();\n let signature = Signature::from_str(\"0285ff83b93bd01c14e201943af7454fe2bc6c98be707a73888c397d6ae3b0b92f73ca559f81cbb19fe4e0f1dc4105bd7b647c6a84b033057977cf2ec982daf71b\").unwrap();\n let address = address!(\"0x7E5F4552091A69125d5DfCb7b8C2659029395Bdf\"); // private key = 1\n let recovered_address =\n WalletSubcommands::recover_address_from_typed_data(&typed_data, &signature);\n assert!(recovered_address.is_ok());\n assert_eq!(address, recovered_address.unwrap());\n }\n\n #[test]\n fn can_parse_wallet_sign_data() {\n let args = WalletSubcommands::parse_from([\"foundry-cli\", \"sign\", \"--data\", \"{ ... }\"]);\n match args {\n WalletSubcommands::Sign { message, data, from_file, .. } => {\n assert_eq!(message, \"{ ... }\".to_string());\n assert!(data);\n assert!(!from_file);\n }\n _ => panic!(\"expected WalletSubcommands::Sign\"),\n }\n }\n\n #[test]\n fn can_parse_wallet_sign_data_file() {\n let args = WalletSubcommands::parse_from([\n \"foundry-cli\",\n \"sign\",\n \"--data\",\n \"--from-file\",\n \"tests/data/typed_data.json\",\n ]);\n match args {\n WalletSubcommands::Sign { message, data, from_file, .. } => {\n assert_eq!(message, \"tests/data/typed_data.json\".to_string());\n assert!(data);\n assert!(from_file);\n }\n _ => panic!(\"expected WalletSubcommands::Sign\"),\n }\n }\n\n #[test]\n fn can_parse_wallet_change_password() {\n let args = WalletSubcommands::parse_from([\n \"foundry-cli\",\n \"change-password\",\n \"my_account\",\n \"--unsafe-password\",\n \"old_password\",\n \"--unsafe-new-password\",\n \"new_password\",\n ]);\n match args {\n WalletSubcommands::ChangePassword {\n account_name,\n keystore_dir,\n unsafe_password,\n unsafe_new_password,\n } => {\n assert_eq!(account_name, \"my_account\".to_string());\n assert_eq!(unsafe_password, Some(\"old_password\".to_string()));\n assert_eq!(unsafe_new_password, Some(\"new_password\".to_string()));\n assert!(keystore_dir.is_none());\n }\n _ => panic!(\"expected WalletSubcommands::ChangePassword\"),\n }\n }\n\n #[test]\n fn wallet_sign_auth_nonce_and_self_broadcast_conflict() {\n let result = WalletSubcommands::try_parse_from([\n \"foundry-cli\",\n \"sign-auth\",\n \"0xDeaDbeefdEAdbeefdEadbEEFdeadbeEFdEaDbeeF\",\n \"--nonce\",\n \"42\",\n \"--self-broadcast\",\n ]);\n assert!(\n result.is_err(),\n \"expected error when both --nonce and --self-broadcast are provided\"\n );\n }\n}\n" }, { "path": "crates/cast/src/cmd/wallet/vanity.rs", "content": "use alloy_primitives::{Address, hex};\nuse alloy_signer::{k256::ecdsa::SigningKey, utils::secret_key_to_address};\nuse alloy_signer_local::PrivateKeySigner;\nuse clap::Parser;\nuse eyre::Result;\nuse foundry_common::sh_println;\nuse itertools::Either;\nuse rayon::iter::{self, ParallelIterator};\nuse regex::Regex;\nuse serde::{Deserialize, Serialize};\nuse std::{\n fs,\n path::{Path, PathBuf},\n time::Instant,\n};\n\n/// Type alias for the result of [generate_wallet].\npub type GeneratedWallet = (SigningKey, Address);\n\n/// CLI arguments for `cast wallet vanity`.\n#[derive(Clone, Debug, Parser)]\npub struct VanityArgs {\n /// Prefix regex pattern or hex string.\n #[arg(long, value_name = \"PATTERN\", required_unless_present = \"ends_with\")]\n pub starts_with: Option,\n\n /// Suffix regex pattern or hex string.\n #[arg(long, value_name = \"PATTERN\")]\n pub ends_with: Option,\n\n // 2^64-1 is max possible nonce per [eip-2681](https://eips.ethereum.org/EIPS/eip-2681).\n /// Generate a vanity contract address created by the generated keypair with the specified\n /// nonce.\n #[arg(long)]\n pub nonce: Option,\n\n /// Path to save the generated vanity contract address to.\n ///\n /// If provided, the generated vanity addresses will appended to a JSON array in the specified\n /// file.\n #[arg(\n long,\n value_hint = clap::ValueHint::FilePath,\n value_name = \"PATH\",\n )]\n pub save_path: Option,\n}\n\n/// WalletData contains address and private_key information for a wallet.\n#[derive(Serialize, Deserialize)]\nstruct WalletData {\n address: String,\n private_key: String,\n}\n\n/// Wallets is a collection of WalletData.\n#[derive(Default, Serialize, Deserialize)]\nstruct Wallets {\n wallets: Vec,\n}\n\nimpl WalletData {\n pub fn new(wallet: &PrivateKeySigner) -> Self {\n Self {\n address: wallet.address().to_checksum(None),\n private_key: format!(\"0x{}\", hex::encode(wallet.credential().to_bytes())),\n }\n }\n}\n\nimpl VanityArgs {\n pub fn run(self) -> Result {\n let Self { starts_with, ends_with, nonce, save_path } = self;\n\n let mut left_exact_hex = None;\n let mut left_regex = None;\n if let Some(prefix) = starts_with {\n match parse_pattern(&prefix, true)? {\n Either::Left(left) => left_exact_hex = Some(left),\n Either::Right(re) => left_regex = Some(re),\n }\n }\n\n let mut right_exact_hex = None;\n let mut right_regex = None;\n if let Some(suffix) = ends_with {\n match parse_pattern(&suffix, false)? {\n Either::Left(right) => right_exact_hex = Some(right),\n Either::Right(re) => right_regex = Some(re),\n }\n }\n\n macro_rules! find_vanity {\n ($m:ident, $nonce:ident) => {\n if let Some(nonce) = $nonce {\n find_vanity_address_with_nonce($m, nonce)\n } else {\n find_vanity_address($m)\n }\n };\n }\n\n sh_println!(\"Starting to generate vanity address...\")?;\n let timer = Instant::now();\n\n let wallet = match (left_exact_hex, left_regex, right_exact_hex, right_regex) {\n (Some(left), _, Some(right), _) => {\n let matcher = HexMatcher { left, right };\n find_vanity!(matcher, nonce)\n }\n (Some(left), _, _, Some(right)) => {\n let matcher = LeftExactRightRegexMatcher { left, right };\n find_vanity!(matcher, nonce)\n }\n (_, Some(left), _, Some(right)) => {\n let matcher = RegexMatcher { left, right };\n find_vanity!(matcher, nonce)\n }\n (_, Some(left), Some(right), _) => {\n let matcher = LeftRegexRightExactMatcher { left, right };\n find_vanity!(matcher, nonce)\n }\n (Some(left), None, None, None) => {\n let matcher = LeftHexMatcher { left };\n find_vanity!(matcher, nonce)\n }\n (None, None, Some(right), None) => {\n let matcher = RightHexMatcher { right };\n find_vanity!(matcher, nonce)\n }\n (None, Some(re), None, None) => {\n let matcher = SingleRegexMatcher { re };\n find_vanity!(matcher, nonce)\n }\n (None, None, None, Some(re)) => {\n let matcher = SingleRegexMatcher { re };\n find_vanity!(matcher, nonce)\n }\n _ => unreachable!(),\n }\n .expect(\"failed to generate vanity wallet\");\n\n // If a save path is provided, save the generated vanity wallet to the specified path.\n if let Some(save_path) = save_path {\n save_wallet_to_file(&wallet, &save_path)?;\n }\n\n sh_println!(\n \"Successfully found vanity address in {:.3} seconds.{}{}\\nAddress: {}\\nPrivate Key: 0x{}\",\n timer.elapsed().as_secs_f64(),\n if nonce.is_some() { \"\\nContract address: \" } else { \"\" },\n if let Some(nonce_val) = nonce {\n wallet.address().create(nonce_val).to_checksum(None)\n } else {\n String::new()\n },\n wallet.address().to_checksum(None),\n hex::encode(wallet.credential().to_bytes()),\n )?;\n\n Ok(wallet)\n }\n}\n\n/// Saves the specified `wallet` to a 'vanity_addresses.json' file at the given `save_path`.\n/// If the file exists, the wallet data is appended to the existing content;\n/// otherwise, a new file is created.\nfn save_wallet_to_file(wallet: &PrivateKeySigner, path: &Path) -> Result<()> {\n let mut wallets = if path.exists() {\n let data = fs::read_to_string(path)?;\n serde_json::from_str::(&data).unwrap_or_default()\n } else {\n Wallets::default()\n };\n\n wallets.wallets.push(WalletData::new(wallet));\n\n fs::write(path, serde_json::to_string_pretty(&wallets)?)?;\n Ok(())\n}\n\n/// Generates random wallets until `matcher` matches the wallet address, returning the wallet.\npub fn find_vanity_address(matcher: T) -> Option {\n wallet_generator().find_any(create_matcher(matcher)).map(|(key, _)| key.into())\n}\n\n/// Generates random wallets until `matcher` matches the contract address created at `nonce`,\n/// returning the wallet.\npub fn find_vanity_address_with_nonce(\n matcher: T,\n nonce: u64,\n) -> Option {\n wallet_generator().find_any(create_nonce_matcher(matcher, nonce)).map(|(key, _)| key.into())\n}\n\n/// Creates a matcher function, which takes a reference to a [GeneratedWallet] and returns\n/// whether it found a match or not by using `matcher`.\n#[inline]\npub fn create_matcher(matcher: T) -> impl Fn(&GeneratedWallet) -> bool {\n move |(_, addr)| matcher.is_match(addr)\n}\n\n/// Creates a contract address matcher function that uses the specified nonce.\n/// The returned function takes a reference to a [GeneratedWallet] and returns\n/// whether the contract address created with the nonce matches using `matcher`.\n#[inline]\npub fn create_nonce_matcher(\n matcher: T,\n nonce: u64,\n) -> impl Fn(&GeneratedWallet) -> bool {\n move |(_, addr)| {\n let contract_addr = addr.create(nonce);\n matcher.is_match(&contract_addr)\n }\n}\n\n/// Returns an infinite parallel iterator which yields a [GeneratedWallet].\n#[inline]\npub fn wallet_generator() -> iter::Map, impl Fn(()) -> GeneratedWallet> {\n iter::repeat(()).map(|()| generate_wallet())\n}\n\n/// Generates a random K-256 signing key and derives its Ethereum address.\npub fn generate_wallet() -> GeneratedWallet {\n let key = SigningKey::random(&mut rand_08::thread_rng());\n let address = secret_key_to_address(&key);\n (key, address)\n}\n\n/// A trait to match vanity addresses.\npub trait VanityMatcher: Send + Sync {\n fn is_match(&self, addr: &Address) -> bool;\n}\n\n/// Matches start and end hex.\npub struct HexMatcher {\n pub left: Vec,\n pub right: Vec,\n}\n\nimpl VanityMatcher for HexMatcher {\n #[inline]\n fn is_match(&self, addr: &Address) -> bool {\n let bytes = addr.as_slice();\n bytes.starts_with(&self.left) && bytes.ends_with(&self.right)\n }\n}\n\n/// Matches only start hex.\npub struct LeftHexMatcher {\n pub left: Vec,\n}\n\nimpl VanityMatcher for LeftHexMatcher {\n #[inline]\n fn is_match(&self, addr: &Address) -> bool {\n let bytes = addr.as_slice();\n bytes.starts_with(&self.left)\n }\n}\n\n/// Matches only end hex.\npub struct RightHexMatcher {\n pub right: Vec,\n}\n\nimpl VanityMatcher for RightHexMatcher {\n #[inline]\n fn is_match(&self, addr: &Address) -> bool {\n let bytes = addr.as_slice();\n bytes.ends_with(&self.right)\n }\n}\n\n/// Matches start hex and end regex.\npub struct LeftExactRightRegexMatcher {\n pub left: Vec,\n pub right: Regex,\n}\n\nimpl VanityMatcher for LeftExactRightRegexMatcher {\n #[inline]\n fn is_match(&self, addr: &Address) -> bool {\n let bytes = addr.as_slice();\n bytes.starts_with(&self.left) && self.right.is_match(&hex::encode(bytes))\n }\n}\n\n/// Matches start regex and end hex.\npub struct LeftRegexRightExactMatcher {\n pub left: Regex,\n pub right: Vec,\n}\n\nimpl VanityMatcher for LeftRegexRightExactMatcher {\n #[inline]\n fn is_match(&self, addr: &Address) -> bool {\n let bytes = addr.as_slice();\n bytes.ends_with(&self.right) && self.left.is_match(&hex::encode(bytes))\n }\n}\n\n/// Matches a single regex.\npub struct SingleRegexMatcher {\n pub re: Regex,\n}\n\nimpl VanityMatcher for SingleRegexMatcher {\n #[inline]\n fn is_match(&self, addr: &Address) -> bool {\n let addr = hex::encode(addr);\n self.re.is_match(&addr)\n }\n}\n\n/// Matches start and end regex.\npub struct RegexMatcher {\n pub left: Regex,\n pub right: Regex,\n}\n\nimpl VanityMatcher for RegexMatcher {\n #[inline]\n fn is_match(&self, addr: &Address) -> bool {\n let addr = hex::encode(addr);\n self.left.is_match(&addr) && self.right.is_match(&addr)\n }\n}\n\nfn parse_pattern(pattern: &str, is_start: bool) -> Result, Regex>> {\n if let Ok(decoded) = hex::decode(pattern) {\n if decoded.len() > 20 {\n return Err(eyre::eyre!(\"Hex pattern must be less than 20 bytes\"));\n }\n Ok(Either::Left(decoded))\n } else {\n let (prefix, suffix) = if is_start { (\"^\", \"\") } else { (\"\", \"$\") };\n Ok(Either::Right(Regex::new(&format!(\"{prefix}{pattern}{suffix}\"))?))\n }\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n\n #[test]\n fn find_simple_vanity_start() {\n let args: VanityArgs = VanityArgs::parse_from([\"foundry-cli\", \"--starts-with\", \"00\"]);\n let wallet = args.run().unwrap();\n let addr = wallet.address();\n let addr = format!(\"{addr:x}\");\n assert!(addr.starts_with(\"00\"));\n }\n\n #[test]\n fn find_simple_vanity_start2() {\n let args: VanityArgs = VanityArgs::parse_from([\"foundry-cli\", \"--starts-with\", \"9\"]);\n let wallet = args.run().unwrap();\n let addr = wallet.address();\n let addr = format!(\"{addr:x}\");\n assert!(addr.starts_with('9'));\n }\n\n #[test]\n fn find_simple_vanity_end() {\n let args: VanityArgs = VanityArgs::parse_from([\"foundry-cli\", \"--ends-with\", \"00\"]);\n let wallet = args.run().unwrap();\n let addr = wallet.address();\n let addr = format!(\"{addr:x}\");\n assert!(addr.ends_with(\"00\"));\n }\n\n #[test]\n fn save_path() {\n let tmp = tempfile::NamedTempFile::new().unwrap();\n let args: VanityArgs = VanityArgs::parse_from([\n \"foundry-cli\",\n \"--starts-with\",\n \"00\",\n \"--save-path\",\n tmp.path().to_str().unwrap(),\n ]);\n args.run().unwrap();\n assert!(tmp.path().exists());\n let s = fs::read_to_string(tmp.path()).unwrap();\n let wallets: Wallets = serde_json::from_str(&s).unwrap();\n assert!(!wallets.wallets.is_empty());\n }\n}\n" }, { "path": "crates/cast/src/debug.rs", "content": "use std::str::FromStr;\n\nuse alloy_chains::Chain;\nuse alloy_primitives::{Address, Bytes, map::HashMap};\nuse foundry_cli::utils::{TraceResult, print_traces};\nuse foundry_common::{ContractsByArtifact, compile::ProjectCompiler, shell};\nuse foundry_config::Config;\nuse foundry_debugger::Debugger;\nuse foundry_evm::traces::{\n CallTraceDecoderBuilder, DebugTraceIdentifier,\n debug::ContractSources,\n identifier::{SignaturesIdentifier, TraceIdentifiers},\n};\n\n/// labels the traces, conditionally prints them or opens the debugger\n#[expect(clippy::too_many_arguments)]\npub(crate) async fn handle_traces(\n mut result: TraceResult,\n config: &Config,\n chain: Chain,\n contracts_bytecode: &HashMap,\n labels: Vec,\n with_local_artifacts: bool,\n debug: bool,\n decode_internal: bool,\n disable_label: bool,\n trace_depth: Option,\n) -> eyre::Result<()> {\n let (known_contracts, mut sources) = if with_local_artifacts {\n let _ = sh_println!(\"Compiling project to generate artifacts\");\n let project = config.project()?;\n let compiler = ProjectCompiler::new();\n let output = compiler.compile(&project)?;\n (\n Some(ContractsByArtifact::new(\n output.artifact_ids().map(|(id, artifact)| (id, artifact.clone().into())),\n )),\n ContractSources::from_project_output(&output, project.root(), None)?,\n )\n } else {\n (None, ContractSources::default())\n };\n\n let labels = labels.iter().filter_map(|label_str| {\n let mut iter = label_str.split(':');\n\n if let Some(addr) = iter.next()\n && let (Ok(address), Some(label)) = (Address::from_str(addr), iter.next())\n {\n return Some((address, label.to_string()));\n }\n None\n });\n let config_labels = config.labels.clone().into_iter();\n\n let mut builder = CallTraceDecoderBuilder::new()\n .with_labels(labels.chain(config_labels))\n .with_signature_identifier(SignaturesIdentifier::from_config(config)?)\n .with_label_disabled(disable_label);\n let mut identifier = TraceIdentifiers::new().with_external(config, Some(chain))?;\n if let Some(contracts) = &known_contracts {\n builder = builder.with_known_contracts(contracts);\n identifier = identifier.with_local_and_bytecodes(contracts, contracts_bytecode);\n }\n\n let mut decoder = builder.build();\n\n for (_, trace) in result.traces.as_deref_mut().unwrap_or_default() {\n decoder.identify(trace, &mut identifier);\n }\n\n if decode_internal || debug {\n if let Some(ref etherscan_identifier) = identifier.external {\n sources.merge(etherscan_identifier.get_compiled_contracts().await?);\n }\n\n if debug {\n let mut debugger = Debugger::builder()\n .traces(result.traces.expect(\"missing traces\"))\n .decoder(&decoder)\n .sources(sources)\n .build();\n debugger.try_run_tui()?;\n return Ok(());\n }\n\n decoder.debug_identifier = Some(DebugTraceIdentifier::new(sources));\n }\n\n print_traces(\n &mut result,\n &decoder,\n shell::verbosity() > 0,\n shell::verbosity() > 4,\n trace_depth,\n )\n .await?;\n\n Ok(())\n}\n" }, { "path": "crates/cast/src/errors.rs", "content": "//! Errors for this crate\n\nuse foundry_config::Chain;\nuse std::fmt;\n\n/// An error thrown when resolving a function via signature failed\n#[derive(Clone, Debug)]\npub enum FunctionSignatureError {\n MissingSignature,\n MissingEtherscan { sig: String },\n UnknownChain(Chain),\n MissingToAddress,\n}\n\nimpl fmt::Display for FunctionSignatureError {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n match self {\n Self::MissingSignature => {\n writeln!(f, \"Function signature must be set\")\n }\n Self::MissingEtherscan { sig } => {\n writeln!(f, \"Failed to determine function signature for `{sig}`\")?;\n writeln!(\n f,\n \"To lookup a function signature of a deployed contract by name, a valid ETHERSCAN_API_KEY must be set.\"\n )?;\n write!(f, \"\\tOr did you mean:\\t {sig}()\")\n }\n Self::UnknownChain(chain) => {\n write!(f, \"Resolving via etherscan requires a known chain. Unknown chain: {chain}\")\n }\n Self::MissingToAddress => f.write_str(\"Target address must be set\"),\n }\n }\n}\n\nimpl std::error::Error for FunctionSignatureError {}\n" }, { "path": "crates/cast/src/lib.rs", "content": "//! Cast is a Swiss Army knife for interacting with Ethereum applications from the command line.\n\n#![cfg_attr(not(test), warn(unused_crate_dependencies))]\n#![cfg_attr(docsrs, feature(doc_cfg))]\n\n#[macro_use]\nextern crate foundry_common;\n#[macro_use]\nextern crate tracing;\nuse alloy_consensus::BlockHeader;\nuse alloy_dyn_abi::{DynSolType, DynSolValue, FunctionExt};\nuse alloy_eips::Encodable2718;\nuse alloy_ens::NameOrAddress;\nuse alloy_json_abi::Function;\nuse alloy_network::{AnyNetwork, BlockResponse, Network, TransactionBuilder};\nuse alloy_primitives::{\n Address, B256, I256, Keccak256, LogData, Selector, TxHash, U64, U256, hex,\n utils::{ParseUnits, Unit, keccak256},\n};\nuse alloy_provider::{PendingTransactionBuilder, Provider, network::eip2718::Decodable2718};\nuse alloy_rlp::{Decodable, Encodable};\nuse alloy_rpc_types::{\n BlockId, BlockNumberOrTag, BlockOverrides, Filter, FilterBlockOption, Log, state::StateOverride,\n};\nuse base::{Base, NumberWithBase, ToBase};\nuse chrono::DateTime;\nuse eyre::{Context, ContextCompat, OptionExt, Result};\nuse foundry_block_explorers::Client;\nuse foundry_common::{\n abi::{coerce_value, encode_function_args, encode_function_args_packed, get_event, get_func},\n compile::etherscan_project,\n flatten,\n fmt::*,\n fs, shell,\n};\nuse foundry_config::Chain;\nuse foundry_evm::core::bytecode::InstIter;\nuse foundry_primitives::FoundryTxEnvelope;\nuse futures::{FutureExt, StreamExt, future::Either};\n\nuse rayon::prelude::*;\nuse serde::Serialize;\nuse std::{\n borrow::Cow,\n fmt::Write,\n io,\n marker::PhantomData,\n path::PathBuf,\n str::FromStr,\n sync::atomic::{AtomicBool, Ordering},\n};\nuse tokio::signal::ctrl_c;\n\npub use foundry_evm::*;\n\npub mod args;\npub mod cmd;\npub mod opts;\n\npub mod base;\npub(crate) mod debug;\npub mod errors;\nmod rlp_converter;\npub mod tx;\n\nuse rlp_converter::Item;\n\n// TODO: CastContract with common contract initializers? Same for CastProviders?\n\npub struct Cast {\n provider: P,\n _phantom: PhantomData,\n}\n\nimpl + Clone + Unpin, N: Network> Cast {\n /// Creates a new Cast instance from the provided client\n ///\n /// # Example\n ///\n /// ```\n /// use alloy_provider::{ProviderBuilder, RootProvider, network::AnyNetwork};\n /// use cast::Cast;\n ///\n /// # async fn foo() -> eyre::Result<()> {\n /// let provider =\n /// ProviderBuilder::<_, _, AnyNetwork>::default().connect(\"http://localhost:8545\").await?;\n /// let cast = Cast::new(provider);\n /// # Ok(())\n /// # }\n /// ```\n pub fn new(provider: P) -> Self {\n Self { provider, _phantom: PhantomData }\n }\n\n /// Makes a read-only call to the specified address\n ///\n /// # Example\n ///\n /// ```\n /// use alloy_primitives::{Address, U256, Bytes};\n /// use alloy_rpc_types::{TransactionRequest, BlockOverrides, state::{StateOverride, AccountOverride}};\n /// use alloy_serde::WithOtherFields;\n /// use cast::Cast;\n /// use alloy_provider::{RootProvider, ProviderBuilder, network::AnyNetwork};\n /// use std::{str::FromStr, collections::HashMap};\n /// use alloy_rpc_types::state::StateOverridesBuilder;\n /// use alloy_sol_types::{sol, SolCall};\n ///\n /// sol!(\n /// function greeting(uint256 i) public returns (string);\n /// );\n ///\n /// # async fn foo() -> eyre::Result<()> {\n /// let alloy_provider = ProviderBuilder::<_,_, AnyNetwork>::default().connect(\"http://localhost:8545\").await?;;\n /// let to = Address::from_str(\"0xB3C95ff08316fb2F2e3E52Ee82F8e7b605Aa1304\")?;\n /// let greeting = greetingCall { i: U256::from(5) }.abi_encode();\n /// let bytes = Bytes::from_iter(greeting.iter());\n /// let tx = TransactionRequest::default().to(to).input(bytes.into());\n /// let tx = WithOtherFields::new(tx);\n ///\n /// // Create state overrides\n /// let mut state_override = StateOverride::default();\n /// let mut account_override = AccountOverride::default();\n /// account_override.balance = Some(U256::from(1000));\n /// state_override.insert(to, account_override);\n /// let state_override_object = StateOverridesBuilder::default().build();\n /// let block_override_object = BlockOverrides::default();\n ///\n /// let cast = Cast::new(alloy_provider);\n /// let data = cast.call(&tx, None, None, Some(state_override_object), Some(block_override_object)).await?;\n /// println!(\"{}\", data);\n /// # Ok(())\n /// # }\n /// ```\n pub async fn call(\n &self,\n req: &N::TransactionRequest,\n func: Option<&Function>,\n block: Option,\n state_override: Option,\n block_override: Option,\n ) -> Result {\n let mut call = self\n .provider\n .call(req.clone())\n .block(block.unwrap_or_default())\n .with_block_overrides_opt(block_override);\n if let Some(state_override) = state_override {\n call = call.overrides(state_override)\n }\n\n let res = call.await?;\n let mut decoded = vec![];\n\n if let Some(func) = func {\n // decode args into tokens\n decoded = match func.abi_decode_output(res.as_ref()) {\n Ok(decoded) => decoded,\n Err(err) => {\n // ensure the address is a contract\n if res.is_empty() {\n // check that the recipient is a contract that can be called\n if let Some(addr) = req.to() {\n if let Ok(code) = self\n .provider\n .get_code_at(addr)\n .block_id(block.unwrap_or_default())\n .await\n && code.is_empty()\n {\n eyre::bail!(\"contract {addr:?} does not have any code\")\n }\n } else if req.to().is_none() {\n eyre::bail!(\"tx req is a contract deployment\");\n } else {\n eyre::bail!(\"recipient is None\");\n }\n }\n return Err(err).wrap_err(\n \"could not decode output; did you specify the wrong function return data type?\"\n );\n }\n };\n }\n\n // handle case when return type is not specified\n Ok(if decoded.is_empty() {\n res.to_string()\n } else if shell::is_json() {\n let tokens = decoded\n .into_iter()\n .map(|value| serialize_value_as_json(value, None))\n .collect::>>()?;\n serde_json::to_string_pretty(&tokens).unwrap()\n } else {\n // seth compatible user-friendly return type conversions\n decoded.iter().map(format_token).collect::>().join(\"\\n\")\n })\n }\n\n /// Generates an access list for the specified transaction\n ///\n /// # Example\n ///\n /// ```\n /// use cast::{Cast};\n /// use alloy_primitives::{Address, U256, Bytes};\n /// use alloy_rpc_types::{TransactionRequest};\n /// use alloy_serde::WithOtherFields;\n /// use alloy_provider::{RootProvider, ProviderBuilder, network::AnyNetwork};\n /// use std::str::FromStr;\n /// use alloy_sol_types::{sol, SolCall};\n ///\n /// sol!(\n /// function greeting(uint256 i) public returns (string);\n /// );\n ///\n /// # async fn foo() -> eyre::Result<()> {\n /// let provider = ProviderBuilder::<_,_, AnyNetwork>::default().connect(\"http://localhost:8545\").await?;;\n /// let to = Address::from_str(\"0xB3C95ff08316fb2F2e3E52Ee82F8e7b605Aa1304\")?;\n /// let greeting = greetingCall { i: U256::from(5) }.abi_encode();\n /// let bytes = Bytes::from_iter(greeting.iter());\n /// let tx = TransactionRequest::default().to(to).input(bytes.into());\n /// let tx = WithOtherFields::new(tx);\n /// let cast = Cast::new(&provider);\n /// let access_list = cast.access_list(&tx, None).await?;\n /// println!(\"{}\", access_list);\n /// # Ok(())\n /// # }\n /// ```\n pub async fn access_list(\n &self,\n req: &N::TransactionRequest,\n block: Option,\n ) -> Result {\n let access_list =\n self.provider.create_access_list(req).block_id(block.unwrap_or_default()).await?;\n let res = if shell::is_json() {\n serde_json::to_string(&access_list)?\n } else {\n let mut s =\n vec![format!(\"gas used: {}\", access_list.gas_used), \"access list:\".to_string()];\n for al in access_list.access_list.0 {\n s.push(format!(\"- address: {}\", &al.address.to_checksum(None)));\n if !al.storage_keys.is_empty() {\n s.push(\" keys:\".to_string());\n for key in al.storage_keys {\n s.push(format!(\" {key:?}\"));\n }\n }\n }\n s.join(\"\\n\")\n };\n\n Ok(res)\n }\n\n pub async fn balance(&self, who: Address, block: Option) -> Result {\n Ok(self.provider.get_balance(who).block_id(block.unwrap_or_default()).await?)\n }\n\n /// Publishes a raw transaction to the network\n ///\n /// # Example\n ///\n /// ```\n /// use alloy_provider::{ProviderBuilder, RootProvider, network::AnyNetwork};\n /// use cast::Cast;\n ///\n /// # async fn foo() -> eyre::Result<()> {\n /// let provider =\n /// ProviderBuilder::<_, _, AnyNetwork>::default().connect(\"http://localhost:8545\").await?;\n /// let cast = Cast::new(provider);\n /// let res = cast.publish(\"0x1234\".to_string()).await?;\n /// println!(\"{:?}\", res);\n /// # Ok(())\n /// # }\n /// ```\n pub async fn publish(&self, raw_tx: String) -> Result> {\n let tx = hex::decode(strip_0x(&raw_tx))?;\n let res = self.provider.send_raw_transaction(&tx).await?;\n\n Ok(res)\n }\n\n pub async fn chain_id(&self) -> Result {\n Ok(self.provider.get_chain_id().await?)\n }\n\n pub async fn block_number(&self) -> Result {\n Ok(self.provider.get_block_number().await?)\n }\n\n pub async fn gas_price(&self) -> Result {\n Ok(self.provider.get_gas_price().await?)\n }\n\n /// # Example\n ///\n /// ```\n /// use alloy_primitives::Address;\n /// use alloy_provider::{ProviderBuilder, RootProvider, network::AnyNetwork};\n /// use cast::Cast;\n /// use std::str::FromStr;\n ///\n /// # async fn foo() -> eyre::Result<()> {\n /// let provider =\n /// ProviderBuilder::<_, _, AnyNetwork>::default().connect(\"http://localhost:8545\").await?;\n /// let cast = Cast::new(provider);\n /// let addr = Address::from_str(\"0x7eD52863829AB99354F3a0503A622e82AcD5F7d3\")?;\n /// let nonce = cast.nonce(addr, None).await?;\n /// println!(\"{}\", nonce);\n /// # Ok(())\n /// # }\n /// ```\n pub async fn nonce(&self, who: Address, block: Option) -> Result {\n Ok(self.provider.get_transaction_count(who).block_id(block.unwrap_or_default()).await?)\n }\n\n /// #Example\n ///\n /// ```\n /// use alloy_primitives::{Address, FixedBytes};\n /// use alloy_provider::{network::AnyNetwork, ProviderBuilder, RootProvider};\n /// use cast::Cast;\n /// use std::str::FromStr;\n ///\n /// # async fn foo() -> eyre::Result<()> {\n /// let provider =\n /// ProviderBuilder::<_, _, AnyNetwork>::default().connect(\"http://localhost:8545\").await?;\n /// let cast = Cast::new(provider);\n /// let addr = Address::from_str(\"0x7eD52863829AB99354F3a0503A622e82AcD5F7d3\")?;\n /// let slots = vec![FixedBytes::from_str(\"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\")?];\n /// let codehash = cast.codehash(addr, slots, None).await?;\n /// println!(\"{}\", codehash);\n /// # Ok(())\n /// # }\n pub async fn codehash(\n &self,\n who: Address,\n slots: Vec,\n block: Option,\n ) -> Result {\n Ok(self\n .provider\n .get_proof(who, slots)\n .block_id(block.unwrap_or_default())\n .await?\n .code_hash\n .to_string())\n }\n\n /// #Example\n ///\n /// ```\n /// use alloy_primitives::{Address, FixedBytes};\n /// use alloy_provider::{network::AnyNetwork, ProviderBuilder, RootProvider};\n /// use cast::Cast;\n /// use std::str::FromStr;\n ///\n /// # async fn foo() -> eyre::Result<()> {\n /// let provider =\n /// ProviderBuilder::<_, _, AnyNetwork>::default().connect(\"http://localhost:8545\").await?;\n /// let cast = Cast::new(provider);\n /// let addr = Address::from_str(\"0x7eD52863829AB99354F3a0503A622e82AcD5F7d3\")?;\n /// let slots = vec![FixedBytes::from_str(\"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\")?];\n /// let storage_root = cast.storage_root(addr, slots, None).await?;\n /// println!(\"{}\", storage_root);\n /// # Ok(())\n /// # }\n pub async fn storage_root(\n &self,\n who: Address,\n slots: Vec,\n block: Option,\n ) -> Result {\n Ok(self\n .provider\n .get_proof(who, slots)\n .block_id(block.unwrap_or_default())\n .await?\n .storage_hash\n .to_string())\n }\n\n /// # Example\n ///\n /// ```\n /// use alloy_primitives::Address;\n /// use alloy_provider::{ProviderBuilder, RootProvider, network::AnyNetwork};\n /// use cast::Cast;\n /// use std::str::FromStr;\n ///\n /// # async fn foo() -> eyre::Result<()> {\n /// let provider =\n /// ProviderBuilder::<_, _, AnyNetwork>::default().connect(\"http://localhost:8545\").await?;\n /// let cast = Cast::new(provider);\n /// let addr = Address::from_str(\"0x7eD52863829AB99354F3a0503A622e82AcD5F7d3\")?;\n /// let implementation = cast.implementation(addr, false, None).await?;\n /// println!(\"{}\", implementation);\n /// # Ok(())\n /// # }\n /// ```\n pub async fn implementation(\n &self,\n who: Address,\n is_beacon: bool,\n block: Option,\n ) -> Result {\n let slot = match is_beacon {\n true => {\n // Use the beacon slot : bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)\n B256::from_str(\n \"0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50\",\n )?\n }\n false => {\n // Use the implementation slot :\n // bytes32(uint256(keccak256('eip1967.proxy.implementation')) - 1)\n B256::from_str(\n \"0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc\",\n )?\n }\n };\n\n let value = self\n .provider\n .get_storage_at(who, slot.into())\n .block_id(block.unwrap_or_default())\n .await?;\n let addr = Address::from_word(value.into());\n Ok(format!(\"{addr:?}\"))\n }\n\n /// # Example\n ///\n /// ```\n /// use alloy_primitives::Address;\n /// use alloy_provider::{ProviderBuilder, RootProvider, network::AnyNetwork};\n /// use cast::Cast;\n /// use std::str::FromStr;\n ///\n /// # async fn foo() -> eyre::Result<()> {\n /// let provider =\n /// ProviderBuilder::<_, _, AnyNetwork>::default().connect(\"http://localhost:8545\").await?;\n /// let cast = Cast::new(provider);\n /// let addr = Address::from_str(\"0x7eD52863829AB99354F3a0503A622e82AcD5F7d3\")?;\n /// let admin = cast.admin(addr, None).await?;\n /// println!(\"{}\", admin);\n /// # Ok(())\n /// # }\n /// ```\n pub async fn admin(&self, who: Address, block: Option) -> Result {\n let slot =\n B256::from_str(\"0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103\")?;\n let value = self\n .provider\n .get_storage_at(who, slot.into())\n .block_id(block.unwrap_or_default())\n .await?;\n let addr = Address::from_word(value.into());\n Ok(format!(\"{addr:?}\"))\n }\n\n /// # Example\n ///\n /// ```\n /// use alloy_primitives::{Address, U256};\n /// use alloy_provider::{ProviderBuilder, RootProvider, network::AnyNetwork};\n /// use cast::Cast;\n /// use std::str::FromStr;\n ///\n /// # async fn foo() -> eyre::Result<()> {\n /// let provider =\n /// ProviderBuilder::<_, _, AnyNetwork>::default().connect(\"http://localhost:8545\").await?;\n /// let cast = Cast::new(provider);\n /// let addr = Address::from_str(\"7eD52863829AB99354F3a0503A622e82AcD5F7d3\")?;\n /// let computed_address = cast.compute_address(addr, None).await?;\n /// println!(\"Computed address for address {addr}: {computed_address}\");\n /// # Ok(())\n /// # }\n /// ```\n pub async fn compute_address(&self, address: Address, nonce: Option) -> Result
{\n let unpacked = if let Some(n) = nonce { n } else { self.nonce(address, None).await? };\n Ok(address.create(unpacked))\n }\n\n /// # Example\n ///\n /// ```\n /// use alloy_primitives::Address;\n /// use alloy_provider::{ProviderBuilder, RootProvider, network::AnyNetwork};\n /// use cast::Cast;\n /// use std::str::FromStr;\n ///\n /// # async fn foo() -> eyre::Result<()> {\n /// let provider =\n /// ProviderBuilder::<_, _, AnyNetwork>::default().connect(\"http://localhost:8545\").await?;\n /// let cast = Cast::new(provider);\n /// let addr = Address::from_str(\"0x00000000219ab540356cbb839cbe05303d7705fa\")?;\n /// let code = cast.code(addr, None, false).await?;\n /// println!(\"{}\", code);\n /// # Ok(())\n /// # }\n /// ```\n pub async fn code(\n &self,\n who: Address,\n block: Option,\n disassemble: bool,\n ) -> Result {\n if disassemble {\n let code =\n self.provider.get_code_at(who).block_id(block.unwrap_or_default()).await?.to_vec();\n SimpleCast::disassemble(&code)\n } else {\n Ok(format!(\n \"{}\",\n self.provider.get_code_at(who).block_id(block.unwrap_or_default()).await?\n ))\n }\n }\n\n /// Example\n ///\n /// ```\n /// use alloy_primitives::Address;\n /// use alloy_provider::{ProviderBuilder, RootProvider, network::AnyNetwork};\n /// use cast::Cast;\n /// use std::str::FromStr;\n ///\n /// # async fn foo() -> eyre::Result<()> {\n /// let provider =\n /// ProviderBuilder::<_, _, AnyNetwork>::default().connect(\"http://localhost:8545\").await?;\n /// let cast = Cast::new(provider);\n /// let addr = Address::from_str(\"0x00000000219ab540356cbb839cbe05303d7705fa\")?;\n /// let codesize = cast.codesize(addr, None).await?;\n /// println!(\"{}\", codesize);\n /// # Ok(())\n /// # }\n /// ```\n pub async fn codesize(&self, who: Address, block: Option) -> Result {\n let code =\n self.provider.get_code_at(who).block_id(block.unwrap_or_default()).await?.to_vec();\n Ok(code.len().to_string())\n }\n\n /// Perform a raw JSON-RPC request\n ///\n /// # Example\n ///\n /// ```\n /// use alloy_provider::{ProviderBuilder, RootProvider, network::AnyNetwork};\n /// use cast::Cast;\n ///\n /// # async fn foo() -> eyre::Result<()> {\n /// let provider =\n /// ProviderBuilder::<_, _, AnyNetwork>::default().connect(\"http://localhost:8545\").await?;\n /// let cast = Cast::new(provider);\n /// let result = cast\n /// .rpc(\"eth_getBalance\", &[\"0xc94770007dda54cF92009BFF0dE90c06F603a09f\", \"latest\"])\n /// .await?;\n /// println!(\"{}\", result);\n /// # Ok(())\n /// # }\n /// ```\n pub async fn rpc(&self, method: &str, params: V) -> Result\n where\n V: alloy_json_rpc::RpcSend,\n {\n let res = self\n .provider\n .raw_request::(Cow::Owned(method.to_string()), params)\n .await?;\n Ok(serde_json::to_string(&res)?)\n }\n\n /// Returns the slot\n ///\n /// # Example\n ///\n /// ```\n /// use alloy_primitives::{Address, B256};\n /// use alloy_provider::{ProviderBuilder, RootProvider, network::AnyNetwork};\n /// use cast::Cast;\n /// use std::str::FromStr;\n ///\n /// # async fn foo() -> eyre::Result<()> {\n /// let provider =\n /// ProviderBuilder::<_, _, AnyNetwork>::default().connect(\"http://localhost:8545\").await?;\n /// let cast = Cast::new(provider);\n /// let addr = Address::from_str(\"0x00000000006c3852cbEf3e08E8dF289169EdE581\")?;\n /// let slot = B256::ZERO;\n /// let storage = cast.storage(addr, slot, None).await?;\n /// println!(\"{}\", storage);\n /// # Ok(())\n /// # }\n /// ```\n pub async fn storage(\n &self,\n from: Address,\n slot: B256,\n block: Option,\n ) -> Result {\n Ok(format!(\n \"{:?}\",\n B256::from(\n self.provider\n .get_storage_at(from, slot.into())\n .block_id(block.unwrap_or_default())\n .await?\n )\n ))\n }\n\n pub async fn filter_logs(&self, filter: Filter) -> Result {\n let logs = self.provider.get_logs(&filter).await?;\n Self::format_logs(logs)\n }\n\n /// Retrieves logs using chunked requests to handle large block ranges.\n ///\n /// Automatically divides large block ranges into smaller chunks to avoid provider limits\n /// and processes them with controlled concurrency to prevent rate limiting.\n pub async fn filter_logs_chunked(&self, filter: Filter, chunk_size: u64) -> Result {\n let logs = self.get_logs_chunked(&filter, chunk_size).await?;\n Self::format_logs(logs)\n }\n\n fn format_logs(logs: Vec) -> Result {\n let res = if shell::is_json() {\n serde_json::to_string(&logs)?\n } else {\n let mut s = vec![];\n for log in logs {\n let pretty = log\n .pretty()\n .replacen('\\n', \"- \", 1) // Remove empty first line\n .replace('\\n', \"\\n \"); // Indent\n s.push(pretty);\n }\n s.join(\"\\n\")\n };\n Ok(res)\n }\n\n fn extract_block_range(filter: &Filter) -> (Option, Option) {\n let FilterBlockOption::Range { from_block, to_block } = &filter.block_option else {\n return (None, None);\n };\n\n (from_block.and_then(|b| b.as_number()), to_block.and_then(|b| b.as_number()))\n }\n\n /// Retrieves logs with automatic chunking fallback.\n ///\n /// First tries to fetch logs for the entire range. If that fails,\n /// falls back to concurrent chunked requests with rate limiting.\n async fn get_logs_chunked(&self, filter: &Filter, chunk_size: u64) -> Result>\n where\n P: Clone + Unpin,\n {\n // Try the full range first\n if let Ok(logs) = self.provider.get_logs(filter).await {\n return Ok(logs);\n }\n\n // Fallback: use concurrent chunked approach\n self.get_logs_chunked_concurrent(filter, chunk_size).await\n }\n\n /// Retrieves logs using concurrent chunked requests with rate limiting.\n ///\n /// Divides the block range into chunks and processes them with a maximum of\n /// 5 concurrent requests. Falls back to single-block queries if chunks fail.\n async fn get_logs_chunked_concurrent(\n &self,\n filter: &Filter,\n chunk_size: u64,\n ) -> Result>\n where\n P: Clone + Unpin,\n {\n let (from_block, to_block) = Self::extract_block_range(filter);\n let (Some(from), Some(to)) = (from_block, to_block) else {\n return self.provider.get_logs(filter).await.map_err(Into::into);\n };\n\n if from >= to {\n return Ok(vec![]);\n }\n\n // Create chunk ranges using iterator\n let chunk_ranges: Vec<(u64, u64)> = (from..to)\n .step_by(chunk_size as usize)\n .map(|chunk_start| (chunk_start, (chunk_start + chunk_size).min(to)))\n .collect();\n\n // Process chunks with controlled concurrency using buffered stream\n let mut all_results: Vec<(u64, Vec)> = futures::stream::iter(chunk_ranges)\n .map(|(start_block, chunk_end)| {\n let chunk_filter = filter.clone().from_block(start_block).to_block(chunk_end - 1);\n let provider = self.provider.clone();\n\n async move {\n // Try direct chunk request with simplified fallback\n match provider.get_logs(&chunk_filter).await {\n Ok(logs) => (start_block, logs),\n Err(_) => {\n // Simple fallback: try individual blocks in this chunk\n let mut fallback_logs = Vec::new();\n for single_block in start_block..chunk_end {\n let single_filter = chunk_filter\n .clone()\n .from_block(single_block)\n .to_block(single_block);\n if let Ok(logs) = provider.get_logs(&single_filter).await {\n fallback_logs.extend(logs);\n }\n }\n (start_block, fallback_logs)\n }\n }\n }\n })\n .buffered(5) // Limit to 5 concurrent requests to avoid rate limits\n .collect()\n .await;\n\n // Sort once at the end by block number and flatten\n all_results.sort_by_key(|(block_num, _)| *block_num);\n\n let mut all_logs = Vec::new();\n for (_, logs) in all_results {\n all_logs.extend(logs);\n }\n\n Ok(all_logs)\n }\n\n /// Converts a block identifier into a block number.\n ///\n /// If the block identifier is a block number, then this function returns the block number. If\n /// the block identifier is a block hash, then this function returns the block number of\n /// that block hash. If the block identifier is `None`, then this function returns `None`.\n ///\n /// # Example\n ///\n /// ```\n /// use alloy_primitives::fixed_bytes;\n /// use alloy_provider::{ProviderBuilder, RootProvider, network::AnyNetwork};\n /// use alloy_rpc_types::{BlockId, BlockNumberOrTag};\n /// use cast::Cast;\n /// use std::{convert::TryFrom, str::FromStr};\n ///\n /// # async fn foo() -> eyre::Result<()> {\n /// let provider =\n /// ProviderBuilder::<_, _, AnyNetwork>::default().connect(\"http://localhost:8545\").await?;\n /// let cast = Cast::new(provider);\n ///\n /// let block_number = cast.convert_block_number(Some(BlockId::number(5))).await?;\n /// assert_eq!(block_number, Some(BlockNumberOrTag::Number(5)));\n ///\n /// let block_number = cast\n /// .convert_block_number(Some(BlockId::hash(fixed_bytes!(\n /// \"0000000000000000000000000000000000000000000000000000000000001234\"\n /// ))))\n /// .await?;\n /// assert_eq!(block_number, Some(BlockNumberOrTag::Number(4660)));\n ///\n /// let block_number = cast.convert_block_number(None).await?;\n /// assert_eq!(block_number, None);\n /// # Ok(())\n /// # }\n /// ```\n pub async fn convert_block_number(\n &self,\n block: Option,\n ) -> Result, eyre::Error> {\n match block {\n Some(block) => match block {\n BlockId::Number(block_number) => Ok(Some(block_number)),\n BlockId::Hash(hash) => {\n let block = self.provider.get_block_by_hash(hash.block_hash).await?;\n Ok(block.map(|block| block.header().number()).map(BlockNumberOrTag::from))\n }\n },\n None => Ok(None),\n }\n }\n\n /// Sets up a subscription to the given filter and writes the logs to the given output.\n ///\n /// # Example\n ///\n /// ```\n /// use alloy_primitives::Address;\n /// use alloy_provider::{ProviderBuilder, RootProvider, network::AnyNetwork};\n /// use alloy_rpc_types::Filter;\n /// use alloy_transport::BoxTransport;\n /// use cast::Cast;\n /// use std::{io, str::FromStr};\n ///\n /// # async fn foo() -> eyre::Result<()> {\n /// let provider =\n /// ProviderBuilder::<_, _, AnyNetwork>::default().connect(\"wss://localhost:8545\").await?;\n /// let cast = Cast::new(provider);\n ///\n /// let filter =\n /// Filter::new().address(Address::from_str(\"0x00000000006c3852cbEf3e08E8dF289169EdE581\")?);\n /// let mut output = io::stdout();\n /// cast.subscribe(filter, &mut output).await?;\n /// # Ok(())\n /// # }\n /// ```\n pub async fn subscribe(&self, filter: Filter, output: &mut dyn io::Write) -> Result<()> {\n // Initialize the subscription stream for logs\n let mut subscription = self.provider.subscribe_logs(&filter).await?.into_stream();\n\n // Check if a to_block is specified, if so, subscribe to blocks\n let mut block_subscription = if filter.get_to_block().is_some() {\n Some(self.provider.subscribe_blocks().await?.into_stream())\n } else {\n None\n };\n\n let format_json = shell::is_json();\n let to_block_number = filter.get_to_block();\n\n // If output should be JSON, start with an opening bracket\n if format_json {\n write!(output, \"[\")?;\n }\n\n let mut first = true;\n\n loop {\n tokio::select! {\n // If block subscription is present, listen to it to avoid blocking indefinitely past the desired to_block\n block = if let Some(bs) = &mut block_subscription {\n Either::Left(bs.next().fuse())\n } else {\n Either::Right(futures::future::pending())\n } => {\n if let (Some(block), Some(to_block)) = (block, to_block_number)\n && block.number() > to_block {\n break;\n }\n },\n // Process incoming log\n log = subscription.next() => {\n if format_json {\n if !first {\n write!(output, \",\")?;\n }\n first = false;\n let log_str = serde_json::to_string(&log).unwrap();\n write!(output, \"{log_str}\")?;\n } else {\n let log_str = log.pretty()\n .replacen('\\n', \"- \", 1) // Remove empty first line\n .replace('\\n', \"\\n \"); // Indent\n writeln!(output, \"{log_str}\")?;\n }\n },\n // Break on cancel signal, to allow for closing JSON bracket\n _ = ctrl_c() => {\n break;\n },\n else => break,\n }\n }\n\n // If output was JSON, end with a closing bracket\n if format_json {\n write!(output, \"]\")?;\n }\n\n Ok(())\n }\n}\n\nimpl, N: Network> Cast\nwhere\n N::HeaderResponse: UIfmtHeaderExt,\n N::BlockResponse: UIfmt,\n{\n /// # Example\n ///\n /// ```\n /// use alloy_provider::{ProviderBuilder, RootProvider, network::AnyNetwork};\n /// use cast::Cast;\n ///\n /// # async fn foo() -> eyre::Result<()> {\n /// let provider =\n /// ProviderBuilder::<_, _, AnyNetwork>::default().connect(\"http://localhost:8545\").await?;\n /// let cast = Cast::new(provider);\n /// let block = cast.block(5, true, vec![]).await?;\n /// println!(\"{}\", block);\n /// # Ok(())\n /// # }\n /// ```\n pub async fn block>(\n &self,\n block: B,\n full: bool,\n fields: Vec,\n ) -> Result {\n let block = block.into();\n if fields.contains(&\"transactions\".into()) && !full {\n eyre::bail!(\"use --full to view transactions\")\n }\n\n let block = self\n .provider\n .get_block(block)\n .kind(full.into())\n .await?\n .ok_or_else(|| eyre::eyre!(\"block {:?} not found\", block))?;\n\n Ok(if !fields.is_empty() {\n let mut result = String::new();\n for field in fields {\n result.push_str(\n &get_pretty_block_attr::(&block, &field)\n .unwrap_or_else(|| format!(\"{field} is not a valid block field\")),\n );\n\n result.push('\\n');\n }\n result.trim_end().to_string()\n } else if shell::is_json() {\n serde_json::to_value(&block).unwrap().to_string()\n } else {\n block.pretty()\n })\n }\n\n async fn block_field_as_num>(&self, block: B, field: String) -> Result {\n Self::block(\n self,\n block.into(),\n false,\n // Select only select field\n vec![field],\n )\n .await?\n .parse()\n .map_err(Into::into)\n }\n\n pub async fn base_fee>(&self, block: B) -> Result {\n Self::block_field_as_num(self, block, String::from(\"baseFeePerGas\")).await\n }\n\n pub async fn age>(&self, block: B) -> Result {\n let timestamp_str =\n Self::block_field_as_num(self, block, String::from(\"timestamp\")).await?.to_string();\n let datetime = DateTime::from_timestamp(timestamp_str.parse::().unwrap(), 0).unwrap();\n Ok(datetime.format(\"%a %b %e %H:%M:%S %Y\").to_string())\n }\n\n pub async fn timestamp>(&self, block: B) -> Result {\n Self::block_field_as_num(self, block, \"timestamp\".to_string()).await\n }\n\n pub async fn chain(&self) -> Result<&str> {\n let genesis_hash = Self::block(\n self,\n 0,\n false,\n // Select only block hash\n vec![String::from(\"hash\")],\n )\n .await?;\n\n Ok(match &genesis_hash[..] {\n \"0xd4e56740f876aef8c010b86a40d5f56745a118d0906a34e69aec8c0db1cb8fa3\" => {\n match &(Self::block(self, 1920000, false, vec![String::from(\"hash\")]).await?)[..] {\n \"0x94365e3a8c0b35089c1d1195081fe7489b528a84b22199c916180db8b28ade7f\" => {\n \"etclive\"\n }\n _ => \"ethlive\",\n }\n }\n \"0xa3c565fc15c7478862d50ccd6561e3c06b24cc509bf388941c25ea985ce32cb9\" => \"kovan\",\n \"0x41941023680923e0fe4d74a34bdac8141f2540e3ae90623718e47d66d1ca4a2d\" => \"ropsten\",\n \"0x7ca38a1916c42007829c55e69d3e9a73265554b586a499015373241b8a3fa48b\" => {\n \"optimism-mainnet\"\n }\n \"0xc1fc15cd51159b1f1e5cbc4b82e85c1447ddfa33c52cf1d98d14fba0d6354be1\" => {\n \"optimism-goerli\"\n }\n \"0x02adc9b449ff5f2467b8c674ece7ff9b21319d76c4ad62a67a70d552655927e5\" => {\n \"optimism-kovan\"\n }\n \"0x521982bd54239dc71269eefb58601762cc15cfb2978e0becb46af7962ed6bfaa\" => \"fraxtal\",\n \"0x910f5c4084b63fd860d0c2f9a04615115a5a991254700b39ba072290dbd77489\" => {\n \"fraxtal-testnet\"\n }\n \"0x7ee576b35482195fc49205cec9af72ce14f003b9ae69f6ba0faef4514be8b442\" => {\n \"arbitrum-mainnet\"\n }\n \"0x0cd786a2425d16f152c658316c423e6ce1181e15c3295826d7c9904cba9ce303\" => \"morden\",\n \"0x6341fd3daf94b748c72ced5a5b26028f2474f5f00d824504e4fa37a75767e177\" => \"rinkeby\",\n \"0xbf7e331f7f7c1dd2e05159666b3bf8bc7a8a3a9eb1d518969eab529dd9b88c1a\" => \"goerli\",\n \"0x14c2283285a88fe5fce9bf5c573ab03d6616695d717b12a127188bcacfc743c4\" => \"kotti\",\n \"0xa9c28ce2141b56c474f1dc504bee9b01eb1bd7d1a507580d5519d4437a97de1b\" => \"polygon-pos\",\n \"0x7202b2b53c5a0836e773e319d18922cc756dd67432f9a1f65352b61f4406c697\" => {\n \"polygon-pos-amoy-testnet\"\n }\n \"0x81005434635456a16f74ff7023fbe0bf423abbc8a8deb093ffff455c0ad3b741\" => \"polygon-zkevm\",\n \"0x676c1a76a6c5855a32bdf7c61977a0d1510088a4eeac1330466453b3d08b60b9\" => {\n \"polygon-zkevm-cardona-testnet\"\n }\n \"0x4f1dd23188aab3a76b463e4af801b52b1248ef073c648cbdc4c9333d3da79756\" => \"gnosis\",\n \"0xada44fd8d2ecab8b08f256af07ad3e777f17fb434f8f8e678b312f576212ba9a\" => \"chiado\",\n \"0x6d3c66c5357ec91d5c43af47e234a939b22557cbb552dc45bebbceeed90fbe34\" => \"bsctest\",\n \"0x0d21840abff46b96c84b2ac9e10e4f5cdaeb5693cb665db62a2f3b02d2d57b5b\" => \"bsc\",\n \"0x31ced5b9beb7f8782b014660da0cb18cc409f121f408186886e1ca3e8eeca96b\" => {\n match &(Self::block(self, 1, false, vec![String::from(\"hash\")]).await?)[..] {\n \"0x738639479dc82d199365626f90caa82f7eafcfe9ed354b456fb3d294597ceb53\" => {\n \"avalanche-fuji\"\n }\n _ => \"avalanche\",\n }\n }\n \"0x23a2658170ba70d014ba0d0d2709f8fbfe2fa660cd868c5f282f991eecbe38ee\" => \"ink\",\n \"0xe5fd5cf0be56af58ad5751b401410d6b7a09d830fa459789746a3d0dd1c79834\" => \"ink-sepolia\",\n _ => \"unknown\",\n })\n }\n}\n\nimpl, N: Network> Cast\nwhere\n N::Header: Encodable,\n{\n /// # Example\n ///\n /// ```\n /// use alloy_provider::{ProviderBuilder, RootProvider, network::Ethereum};\n /// use cast::Cast;\n ///\n /// # async fn foo() -> eyre::Result<()> {\n /// let provider =\n /// ProviderBuilder::<_, _, Ethereum>::default().connect(\"http://localhost:8545\").await?;\n /// let cast = Cast::new(provider);\n /// let block = cast.block_raw(5, true).await?;\n /// println!(\"{}\", block);\n /// # Ok(())\n /// # }\n /// ```\n pub async fn block_raw>(&self, block: B, full: bool) -> Result {\n let block_id = block.into();\n\n let block = self\n .provider\n .get_block(block_id)\n .kind(full.into())\n .await?\n .ok_or_else(|| eyre::eyre!(\"block {:?} not found\", block_id))?;\n\n let encoded = alloy_rlp::encode(block.header().as_ref());\n\n Ok(format!(\"0x{}\", hex::encode(encoded)))\n }\n}\n\nimpl, N: Network> Cast\nwhere\n N::TxEnvelope: Serialize + UIfmtSignatureExt,\n N::TransactionResponse: UIfmt,\n{\n /// # Example\n ///\n /// ```\n /// use alloy_provider::{ProviderBuilder, RootProvider, network::AnyNetwork};\n /// use cast::Cast;\n ///\n /// # async fn foo() -> eyre::Result<()> {\n /// let provider =\n /// ProviderBuilder::<_, _, AnyNetwork>::default().connect(\"http://localhost:8545\").await?;\n /// let cast = Cast::new(provider);\n /// let tx_hash = \"0xf8d1713ea15a81482958fb7ddf884baee8d3bcc478c5f2f604e008dc788ee4fc\";\n /// let tx = cast.transaction(Some(tx_hash.to_string()), None, None, None, false, false).await?;\n /// println!(\"{}\", tx);\n /// # Ok(())\n /// # }\n /// ```\n pub async fn transaction(\n &self,\n tx_hash: Option,\n from: Option,\n nonce: Option,\n field: Option,\n raw: bool,\n to_request: bool,\n ) -> Result {\n let tx = if let Some(tx_hash) = tx_hash {\n let tx_hash = TxHash::from_str(&tx_hash).wrap_err(\"invalid tx hash\")?;\n self.provider\n .get_transaction_by_hash(tx_hash)\n .await?\n .ok_or_else(|| eyre::eyre!(\"tx not found: {:?}\", tx_hash))?\n } else if let Some(from) = from {\n // If nonce is not provided, uses 0.\n let nonce = U64::from(nonce.unwrap_or_default());\n let from = from.resolve(self.provider.root()).await?;\n\n self.provider\n .raw_request::<_, Option>(\n \"eth_getTransactionBySenderAndNonce\".into(),\n (from, nonce),\n )\n .await?\n .ok_or_else(|| {\n eyre::eyre!(\"tx not found for sender {from} and nonce {:?}\", nonce.to::())\n })?\n } else {\n eyre::bail!(\"tx hash or from address is required\")\n };\n\n Ok(if raw {\n let encoded = tx.as_ref().encoded_2718();\n format!(\"0x{}\", hex::encode(encoded))\n } else if let Some(ref field) = field {\n get_pretty_tx_attr::(&tx, field.as_str())\n .ok_or_else(|| eyre::eyre!(\"invalid tx field: {}\", field.to_string()))?\n } else if shell::is_json() {\n // to_value first to sort json object keys\n serde_json::to_value(&tx)?.to_string()\n } else if to_request {\n serde_json::to_string_pretty(&Into::::into(tx))?\n } else {\n tx.pretty()\n })\n }\n}\n\npub struct SimpleCast;\n\nimpl SimpleCast {\n /// Returns the maximum value of the given integer type\n ///\n /// # Example\n ///\n /// ```\n /// use alloy_primitives::{I256, U256};\n /// use cast::SimpleCast;\n ///\n /// assert_eq!(SimpleCast::max_int(\"uint256\")?, U256::MAX.to_string());\n /// assert_eq!(SimpleCast::max_int(\"int256\")?, I256::MAX.to_string());\n /// assert_eq!(SimpleCast::max_int(\"int32\")?, i32::MAX.to_string());\n /// # Ok::<(), eyre::Report>(())\n /// ```\n pub fn max_int(s: &str) -> Result {\n Self::max_min_int::(s)\n }\n\n /// Returns the maximum value of the given integer type\n ///\n /// # Example\n ///\n /// ```\n /// use alloy_primitives::{I256, U256};\n /// use cast::SimpleCast;\n ///\n /// assert_eq!(SimpleCast::min_int(\"uint256\")?, \"0\");\n /// assert_eq!(SimpleCast::min_int(\"int256\")?, I256::MIN.to_string());\n /// assert_eq!(SimpleCast::min_int(\"int32\")?, i32::MIN.to_string());\n /// # Ok::<(), eyre::Report>(())\n /// ```\n pub fn min_int(s: &str) -> Result {\n Self::max_min_int::(s)\n }\n\n fn max_min_int(s: &str) -> Result {\n let ty = DynSolType::parse(s).wrap_err(\"Invalid type, expected `(u)int`\")?;\n match ty {\n DynSolType::Int(n) => {\n let mask = U256::from(1).wrapping_shl(n - 1);\n let max = (U256::MAX & mask).saturating_sub(U256::from(1));\n if MAX {\n Ok(max.to_string())\n } else {\n let min = I256::from_raw(max).wrapping_neg() + I256::MINUS_ONE;\n Ok(min.to_string())\n }\n }\n DynSolType::Uint(n) => {\n if MAX {\n let mut max = U256::MAX;\n if n < 256 {\n max &= U256::from(1).wrapping_shl(n).wrapping_sub(U256::from(1));\n }\n Ok(max.to_string())\n } else {\n Ok(\"0\".to_string())\n }\n }\n _ => Err(eyre::eyre!(\"Type is not int/uint: {s}\")),\n }\n }\n\n /// Converts UTF-8 text input to hex\n ///\n /// # Example\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n ///\n /// assert_eq!(Cast::from_utf8(\"yo\"), \"0x796f\");\n /// assert_eq!(Cast::from_utf8(\"Hello, World!\"), \"0x48656c6c6f2c20576f726c6421\");\n /// assert_eq!(Cast::from_utf8(\"TurboDappTools\"), \"0x547572626f44617070546f6f6c73\");\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn from_utf8(s: &str) -> String {\n hex::encode_prefixed(s)\n }\n\n /// Converts hex input to UTF-8 text\n ///\n /// # Example\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n ///\n /// assert_eq!(Cast::to_utf8(\"0x796f\")?, \"yo\");\n /// assert_eq!(Cast::to_utf8(\"0x48656c6c6f2c20576f726c6421\")?, \"Hello, World!\");\n /// assert_eq!(Cast::to_utf8(\"0x547572626f44617070546f6f6c73\")?, \"TurboDappTools\");\n /// assert_eq!(Cast::to_utf8(\"0xe4bda0e5a5bd\")?, \"你儽\");\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn to_utf8(s: &str) -> Result {\n let bytes = hex::decode(s)?;\n Ok(String::from_utf8_lossy(bytes.as_ref()).to_string())\n }\n\n /// Converts hex data into text data\n ///\n /// # Example\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n ///\n /// assert_eq!(Cast::to_ascii(\"0x796f\")?, \"yo\");\n /// assert_eq!(Cast::to_ascii(\"48656c6c6f2c20576f726c6421\")?, \"Hello, World!\");\n /// assert_eq!(Cast::to_ascii(\"0x547572626f44617070546f6f6c73\")?, \"TurboDappTools\");\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn to_ascii(hex: &str) -> Result {\n let bytes = hex::decode(hex)?;\n if !bytes.iter().all(u8::is_ascii) {\n return Err(eyre::eyre!(\"Invalid ASCII bytes\"));\n }\n Ok(String::from_utf8(bytes).unwrap())\n }\n\n /// Converts fixed point number into specified number of decimals\n /// ```\n /// use alloy_primitives::U256;\n /// use cast::SimpleCast as Cast;\n ///\n /// assert_eq!(Cast::from_fixed_point(\"10\", \"0\")?, \"10\");\n /// assert_eq!(Cast::from_fixed_point(\"1.0\", \"1\")?, \"10\");\n /// assert_eq!(Cast::from_fixed_point(\"0.10\", \"2\")?, \"10\");\n /// assert_eq!(Cast::from_fixed_point(\"0.010\", \"3\")?, \"10\");\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn from_fixed_point(value: &str, decimals: &str) -> Result {\n let units: Unit = Unit::from_str(decimals)?;\n let n = ParseUnits::parse_units(value, units)?;\n Ok(n.to_string())\n }\n\n /// Converts integers with specified decimals into fixed point numbers\n ///\n /// # Example\n ///\n /// ```\n /// use alloy_primitives::U256;\n /// use cast::SimpleCast as Cast;\n ///\n /// assert_eq!(Cast::to_fixed_point(\"10\", \"0\")?, \"10.\");\n /// assert_eq!(Cast::to_fixed_point(\"10\", \"1\")?, \"1.0\");\n /// assert_eq!(Cast::to_fixed_point(\"10\", \"2\")?, \"0.10\");\n /// assert_eq!(Cast::to_fixed_point(\"10\", \"3\")?, \"0.010\");\n ///\n /// assert_eq!(Cast::to_fixed_point(\"-10\", \"0\")?, \"-10.\");\n /// assert_eq!(Cast::to_fixed_point(\"-10\", \"1\")?, \"-1.0\");\n /// assert_eq!(Cast::to_fixed_point(\"-10\", \"2\")?, \"-0.10\");\n /// assert_eq!(Cast::to_fixed_point(\"-10\", \"3\")?, \"-0.010\");\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn to_fixed_point(value: &str, decimals: &str) -> Result {\n let (sign, mut value, value_len) = {\n let number = NumberWithBase::parse_int(value, None)?;\n let sign = if number.is_nonnegative() { \"\" } else { \"-\" };\n let value = format!(\"{number:#}\");\n let value_stripped = value.strip_prefix('-').unwrap_or(&value).to_string();\n let value_len = value_stripped.len();\n (sign, value_stripped, value_len)\n };\n let decimals = NumberWithBase::parse_uint(decimals, None)?.number().to::();\n\n let value = if decimals >= value_len {\n // Add \"0.\" and pad with 0s\n format!(\"0.{value:0>decimals$}\")\n } else {\n // Insert decimal at -idx (i.e 1 => decimal idx = -1)\n value.insert(value_len - decimals, '.');\n value\n };\n\n Ok(format!(\"{sign}{value}\"))\n }\n\n /// Concatencates hex strings\n ///\n /// # Example\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n ///\n /// assert_eq!(Cast::concat_hex([\"0x00\", \"0x01\"]), \"0x0001\");\n /// assert_eq!(Cast::concat_hex([\"1\", \"2\"]), \"0x12\");\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn concat_hex>(values: impl IntoIterator) -> String {\n let mut out = String::new();\n for s in values {\n let s = s.as_ref();\n out.push_str(strip_0x(s))\n }\n format!(\"0x{out}\")\n }\n\n /// Converts a number into uint256 hex string with 0x prefix\n ///\n /// # Example\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n ///\n /// assert_eq!(\n /// Cast::to_uint256(\"100\")?,\n /// \"0x0000000000000000000000000000000000000000000000000000000000000064\"\n /// );\n /// assert_eq!(\n /// Cast::to_uint256(\"192038293923\")?,\n /// \"0x0000000000000000000000000000000000000000000000000000002cb65fd1a3\"\n /// );\n /// assert_eq!(\n /// Cast::to_uint256(\n /// \"115792089237316195423570985008687907853269984665640564039457584007913129639935\"\n /// )?,\n /// \"0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff\"\n /// );\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn to_uint256(value: &str) -> Result {\n let n = NumberWithBase::parse_uint(value, None)?;\n Ok(format!(\"{n:#066x}\"))\n }\n\n /// Converts a number into int256 hex string with 0x prefix\n ///\n /// # Example\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n ///\n /// assert_eq!(\n /// Cast::to_int256(\"0\")?,\n /// \"0x0000000000000000000000000000000000000000000000000000000000000000\"\n /// );\n /// assert_eq!(\n /// Cast::to_int256(\"100\")?,\n /// \"0x0000000000000000000000000000000000000000000000000000000000000064\"\n /// );\n /// assert_eq!(\n /// Cast::to_int256(\"-100\")?,\n /// \"0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff9c\"\n /// );\n /// assert_eq!(\n /// Cast::to_int256(\"192038293923\")?,\n /// \"0x0000000000000000000000000000000000000000000000000000002cb65fd1a3\"\n /// );\n /// assert_eq!(\n /// Cast::to_int256(\"-192038293923\")?,\n /// \"0xffffffffffffffffffffffffffffffffffffffffffffffffffffffd349a02e5d\"\n /// );\n /// assert_eq!(\n /// Cast::to_int256(\n /// \"57896044618658097711785492504343953926634992332820282019728792003956564819967\"\n /// )?,\n /// \"0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff\"\n /// );\n /// assert_eq!(\n /// Cast::to_int256(\n /// \"-57896044618658097711785492504343953926634992332820282019728792003956564819968\"\n /// )?,\n /// \"0x8000000000000000000000000000000000000000000000000000000000000000\"\n /// );\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn to_int256(value: &str) -> Result {\n let n = NumberWithBase::parse_int(value, None)?;\n Ok(format!(\"{n:#066x}\"))\n }\n\n /// Converts an eth amount into a specified unit\n ///\n /// # Example\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n ///\n /// assert_eq!(Cast::to_unit(\"1 wei\", \"wei\")?, \"1\");\n /// assert_eq!(Cast::to_unit(\"1\", \"wei\")?, \"1\");\n /// assert_eq!(Cast::to_unit(\"1ether\", \"wei\")?, \"1000000000000000000\");\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn to_unit(value: &str, unit: &str) -> Result {\n let value = DynSolType::coerce_str(&DynSolType::Uint(256), value)?\n .as_uint()\n .wrap_err(\"Could not convert to uint\")?\n .0;\n let unit = unit.parse().wrap_err(\"could not parse units\")?;\n Ok(Self::format_unit_as_string(value, unit))\n }\n\n /// Convert a number into a uint with arbitrary decimals.\n ///\n /// # Example\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n ///\n /// # fn main() -> eyre::Result<()> {\n /// assert_eq!(Cast::parse_units(\"1.0\", 6)?, \"1000000\"); // USDC (6 decimals)\n /// assert_eq!(Cast::parse_units(\"2.5\", 6)?, \"2500000\");\n /// assert_eq!(Cast::parse_units(\"1.0\", 12)?, \"1000000000000\"); // 12 decimals\n /// assert_eq!(Cast::parse_units(\"1.23\", 3)?, \"1230\"); // 3 decimals\n ///\n /// # Ok(())\n /// # }\n /// ```\n pub fn parse_units(value: &str, unit: u8) -> Result {\n let unit = Unit::new(unit).ok_or_else(|| eyre::eyre!(\"invalid unit\"))?;\n\n Ok(ParseUnits::parse_units(value, unit)?.to_string())\n }\n\n /// Format a number from smallest unit to decimal with arbitrary decimals.\n ///\n /// # Example\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n ///\n /// # fn main() -> eyre::Result<()> {\n /// assert_eq!(Cast::format_units(\"1000000\", 6)?, \"1\"); // USDC (6 decimals)\n /// assert_eq!(Cast::format_units(\"2500000\", 6)?, \"2.500000\");\n /// assert_eq!(Cast::format_units(\"1000000000000\", 12)?, \"1\"); // 12 decimals\n /// assert_eq!(Cast::format_units(\"1230\", 3)?, \"1.230\"); // 3 decimals\n ///\n /// # Ok(())\n /// # }\n /// ```\n pub fn format_units(value: &str, unit: u8) -> Result {\n let value = NumberWithBase::parse_int(value, None)?.number();\n let unit = Unit::new(unit).ok_or_else(|| eyre::eyre!(\"invalid unit\"))?;\n Ok(Self::format_unit_as_string(value, unit))\n }\n\n // Helper function to format units as a string\n fn format_unit_as_string(value: U256, unit: Unit) -> String {\n let mut formatted = ParseUnits::U256(value).format_units(unit);\n // Trim empty fractional part.\n if let Some(dot) = formatted.find('.') {\n let fractional = &formatted[dot + 1..];\n if fractional.chars().all(|c: char| c == '0') {\n formatted = formatted[..dot].to_string();\n }\n }\n formatted\n }\n\n /// Converts wei into an eth amount\n ///\n /// # Example\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n ///\n /// assert_eq!(Cast::from_wei(\"1\", \"gwei\")?, \"0.000000001\");\n /// assert_eq!(Cast::from_wei(\"12340000005\", \"gwei\")?, \"12.340000005\");\n /// assert_eq!(Cast::from_wei(\"10\", \"ether\")?, \"0.000000000000000010\");\n /// assert_eq!(Cast::from_wei(\"100\", \"eth\")?, \"0.000000000000000100\");\n /// assert_eq!(Cast::from_wei(\"17\", \"ether\")?, \"0.000000000000000017\");\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn from_wei(value: &str, unit: &str) -> Result {\n let value = NumberWithBase::parse_int(value, None)?.number();\n Ok(ParseUnits::U256(value).format_units(unit.parse()?))\n }\n\n /// Converts an eth amount into wei\n ///\n /// # Example\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n ///\n /// assert_eq!(Cast::to_wei(\"100\", \"gwei\")?, \"100000000000\");\n /// assert_eq!(Cast::to_wei(\"100\", \"eth\")?, \"100000000000000000000\");\n /// assert_eq!(Cast::to_wei(\"1000\", \"ether\")?, \"1000000000000000000000\");\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn to_wei(value: &str, unit: &str) -> Result {\n let unit = unit.parse().wrap_err(\"could not parse units\")?;\n Ok(ParseUnits::parse_units(value, unit)?.to_string())\n }\n\n // Decodes RLP encoded data with validation for canonical integer representation\n ///\n /// # Examples\n /// ```\n /// use cast::SimpleCast as Cast;\n ///\n /// assert_eq!(Cast::from_rlp(\"0xc0\", false).unwrap(), \"[]\");\n /// assert_eq!(Cast::from_rlp(\"0x0f\", false).unwrap(), \"\\\"0x0f\\\"\");\n /// assert_eq!(Cast::from_rlp(\"0x33\", false).unwrap(), \"\\\"0x33\\\"\");\n /// assert_eq!(Cast::from_rlp(\"0xc161\", false).unwrap(), \"[\\\"0x61\\\"]\");\n /// assert_eq!(Cast::from_rlp(\"820002\", true).is_err(), true);\n /// assert_eq!(Cast::from_rlp(\"820002\", false).unwrap(), \"\\\"0x0002\\\"\");\n /// assert_eq!(Cast::from_rlp(\"00\", true).is_err(), true);\n /// assert_eq!(Cast::from_rlp(\"00\", false).unwrap(), \"\\\"0x00\\\"\");\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn from_rlp(value: impl AsRef, as_int: bool) -> Result {\n let bytes = hex::decode(value.as_ref()).wrap_err(\"Could not decode hex\")?;\n\n if as_int {\n return Ok(U256::decode(&mut &bytes[..])?.to_string());\n }\n\n let item = Item::decode(&mut &bytes[..]).wrap_err(\"Could not decode rlp\")?;\n\n Ok(item.to_string())\n }\n\n /// Encodes hex data or list of hex data to hexadecimal rlp\n ///\n /// # Example\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n ///\n /// assert_eq!(Cast::to_rlp(\"[]\").unwrap(), \"0xc0\".to_string());\n /// assert_eq!(Cast::to_rlp(\"0x22\").unwrap(), \"0x22\".to_string());\n /// assert_eq!(Cast::to_rlp(\"[\\\"0x61\\\"]\",).unwrap(), \"0xc161\".to_string());\n /// assert_eq!(Cast::to_rlp(\"[\\\"0xf1\\\", \\\"f2\\\"]\").unwrap(), \"0xc481f181f2\".to_string());\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn to_rlp(value: &str) -> Result {\n let val = serde_json::from_str(value)\n .unwrap_or_else(|_| serde_json::Value::String(value.to_string()));\n let item = Item::value_to_item(&val)?;\n Ok(format!(\"0x{}\", hex::encode(alloy_rlp::encode(item))))\n }\n\n /// Converts a number of one base to another\n ///\n /// # Example\n ///\n /// ```\n /// use alloy_primitives::I256;\n /// use cast::SimpleCast as Cast;\n ///\n /// assert_eq!(Cast::to_base(\"100\", Some(\"10\"), \"16\")?, \"0x64\");\n /// assert_eq!(Cast::to_base(\"100\", Some(\"10\"), \"oct\")?, \"0o144\");\n /// assert_eq!(Cast::to_base(\"100\", Some(\"10\"), \"binary\")?, \"0b1100100\");\n ///\n /// assert_eq!(Cast::to_base(\"0xffffffffffffffff\", None, \"10\")?, u64::MAX.to_string());\n /// assert_eq!(\n /// Cast::to_base(\"0xffffffffffffffffffffffffffffffff\", None, \"dec\")?,\n /// u128::MAX.to_string()\n /// );\n /// // U256::MAX overflows as internally it is being parsed as I256\n /// assert_eq!(\n /// Cast::to_base(\n /// \"0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff\",\n /// None,\n /// \"decimal\"\n /// )?,\n /// I256::MAX.to_string()\n /// );\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn to_base(value: &str, base_in: Option<&str>, base_out: &str) -> Result {\n let base_in = Base::unwrap_or_detect(base_in, value)?;\n let base_out: Base = base_out.parse()?;\n if base_in == base_out {\n return Ok(value.to_string());\n }\n\n let mut n = NumberWithBase::parse_int(value, Some(&base_in.to_string()))?;\n n.set_base(base_out);\n\n // Use Debug fmt\n Ok(format!(\"{n:#?}\"))\n }\n\n /// Converts hexdata into bytes32 value\n ///\n /// # Example\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n ///\n /// let bytes = Cast::to_bytes32(\"1234\")?;\n /// assert_eq!(bytes, \"0x1234000000000000000000000000000000000000000000000000000000000000\");\n ///\n /// let bytes = Cast::to_bytes32(\"0x1234\")?;\n /// assert_eq!(bytes, \"0x1234000000000000000000000000000000000000000000000000000000000000\");\n ///\n /// let err = Cast::to_bytes32(\"0x123400000000000000000000000000000000000000000000000000000000000011\").unwrap_err();\n /// assert_eq!(err.to_string(), \"string >32 bytes\");\n /// # Ok::<_, eyre::Report>(())\n pub fn to_bytes32(s: &str) -> Result {\n let s = strip_0x(s);\n if s.len() > 64 {\n eyre::bail!(\"string >32 bytes\");\n }\n\n let padded = format!(\"{s:0<64}\");\n Ok(padded.parse::()?.to_string())\n }\n\n /// Encodes string into bytes32 value\n pub fn format_bytes32_string(s: &str) -> Result {\n let str_bytes: &[u8] = s.as_bytes();\n eyre::ensure!(str_bytes.len() <= 32, \"bytes32 strings must not exceed 32 bytes in length\");\n\n let mut bytes32: [u8; 32] = [0u8; 32];\n bytes32[..str_bytes.len()].copy_from_slice(str_bytes);\n Ok(hex::encode_prefixed(bytes32))\n }\n\n /// Pads hex data to a specified length\n ///\n /// # Example\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n ///\n /// let padded = Cast::pad(\"abcd\", true, 20)?;\n /// assert_eq!(padded, \"0xabcd000000000000000000000000000000000000\");\n ///\n /// let padded = Cast::pad(\"abcd\", false, 20)?;\n /// assert_eq!(padded, \"0x000000000000000000000000000000000000abcd\");\n ///\n /// let padded = Cast::pad(\"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2\", true, 32)?;\n /// assert_eq!(padded, \"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2000000000000000000000000\");\n ///\n /// let padded = Cast::pad(\"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2\", false, 32)?;\n /// assert_eq!(padded, \"0x000000000000000000000000C02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2\");\n ///\n /// let err = Cast::pad(\"1234\", false, 1).unwrap_err();\n /// assert_eq!(err.to_string(), \"input length exceeds target length\");\n ///\n /// let err = Cast::pad(\"foobar\", false, 32).unwrap_err();\n /// assert_eq!(err.to_string(), \"input is not a valid hex\");\n ///\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn pad(s: &str, right: bool, len: usize) -> Result {\n let s = strip_0x(s);\n let hex_len = len * 2;\n\n // Validate input\n if s.len() > hex_len {\n eyre::bail!(\"input length exceeds target length\");\n }\n if !s.chars().all(|c| c.is_ascii_hexdigit()) {\n eyre::bail!(\"input is not a valid hex\");\n }\n\n Ok(if right { format!(\"0x{s:0hex_len$}\") })\n }\n\n /// Decodes string from bytes32 value\n pub fn parse_bytes32_string(s: &str) -> Result {\n let bytes = hex::decode(s)?;\n eyre::ensure!(bytes.len() == 32, \"expected 32 byte hex-string\");\n let len = bytes.iter().take_while(|x| **x != 0).count();\n Ok(std::str::from_utf8(&bytes[..len])?.into())\n }\n\n /// Decodes checksummed address from bytes32 value\n pub fn parse_bytes32_address(s: &str) -> Result {\n let s = strip_0x(s);\n if s.len() != 64 {\n eyre::bail!(\"expected 64 byte hex-string, got {s}\");\n }\n\n let s = if let Some(stripped) = s.strip_prefix(\"000000000000000000000000\") {\n stripped\n } else {\n return Err(eyre::eyre!(\"Not convertible to address, there are non-zero bytes\"));\n };\n\n let lowercase_address_string = format!(\"0x{s}\");\n let lowercase_address = Address::from_str(&lowercase_address_string)?;\n\n Ok(lowercase_address.to_checksum(None))\n }\n\n /// Decodes abi-encoded hex input or output\n ///\n /// When `input=true`, `calldata` string MUST not be prefixed with function selector\n ///\n /// # Example\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n /// use alloy_primitives::hex;\n ///\n /// // Passing `input = false` will decode the data as the output type.\n /// // The input data types and the full function sig are ignored, i.e.\n /// // you could also pass `balanceOf()(uint256)` and it'd still work.\n /// let data = \"0x0000000000000000000000000000000000000000000000000000000000000001\";\n /// let sig = \"balanceOf(address, uint256)(uint256)\";\n /// let decoded = Cast::abi_decode(sig, data, false)?[0].as_uint().unwrap().0.to_string();\n /// assert_eq!(decoded, \"1\");\n ///\n /// // Passing `input = true` will decode the data with the input function signature.\n /// // We exclude the \"prefixed\" function selector from the data field (the first 4 bytes).\n /// let data = \"0x0000000000000000000000008dbd1b711dc621e1404633da156fcc779e1c6f3e000000000000000000000000d9f3c9cc99548bf3b44a43e0a2d07399eb918adc000000000000000000000000000000000000000000000000000000000000002a000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000\";\n /// let sig = \"safeTransferFrom(address, address, uint256, uint256, bytes)\";\n /// let decoded = Cast::abi_decode(sig, data, true)?;\n /// let decoded = [\n /// decoded[0].as_address().unwrap().to_string().to_lowercase(),\n /// decoded[1].as_address().unwrap().to_string().to_lowercase(),\n /// decoded[2].as_uint().unwrap().0.to_string(),\n /// decoded[3].as_uint().unwrap().0.to_string(),\n /// hex::encode(decoded[4].as_bytes().unwrap())\n /// ]\n /// .into_iter()\n /// .collect::>();\n ///\n /// assert_eq!(\n /// decoded,\n /// vec![\"0x8dbd1b711dc621e1404633da156fcc779e1c6f3e\", \"0xd9f3c9cc99548bf3b44a43e0a2d07399eb918adc\", \"42\", \"1\", \"\"]\n /// );\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn abi_decode(sig: &str, calldata: &str, input: bool) -> Result> {\n foundry_common::abi::abi_decode_calldata(sig, calldata, input, false)\n }\n\n /// Decodes calldata-encoded hex input or output\n ///\n /// Similar to `abi_decode`, but `calldata` string MUST be prefixed with function selector\n ///\n /// # Example\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n /// use alloy_primitives::hex;\n ///\n /// // Passing `input = false` will decode the data as the output type.\n /// // The input data types and the full function sig are ignored, i.e.\n /// // you could also pass `balanceOf()(uint256)` and it'd still work.\n /// let data = \"0x0000000000000000000000000000000000000000000000000000000000000001\";\n /// let sig = \"balanceOf(address, uint256)(uint256)\";\n /// let decoded = Cast::calldata_decode(sig, data, false)?[0].as_uint().unwrap().0.to_string();\n /// assert_eq!(decoded, \"1\");\n ///\n /// // Passing `input = true` will decode the data with the input function signature.\n /// let data = \"0xf242432a0000000000000000000000008dbd1b711dc621e1404633da156fcc779e1c6f3e000000000000000000000000d9f3c9cc99548bf3b44a43e0a2d07399eb918adc000000000000000000000000000000000000000000000000000000000000002a000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000\";\n /// let sig = \"safeTransferFrom(address, address, uint256, uint256, bytes)\";\n /// let decoded = Cast::calldata_decode(sig, data, true)?;\n /// let decoded = [\n /// decoded[0].as_address().unwrap().to_string().to_lowercase(),\n /// decoded[1].as_address().unwrap().to_string().to_lowercase(),\n /// decoded[2].as_uint().unwrap().0.to_string(),\n /// decoded[3].as_uint().unwrap().0.to_string(),\n /// hex::encode(decoded[4].as_bytes().unwrap()),\n /// ]\n /// .into_iter()\n /// .collect::>();\n /// assert_eq!(\n /// decoded,\n /// vec![\"0x8dbd1b711dc621e1404633da156fcc779e1c6f3e\", \"0xd9f3c9cc99548bf3b44a43e0a2d07399eb918adc\", \"42\", \"1\", \"\"]\n /// );\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn calldata_decode(sig: &str, calldata: &str, input: bool) -> Result> {\n foundry_common::abi::abi_decode_calldata(sig, calldata, input, true)\n }\n\n /// Performs ABI encoding based off of the function signature. Does not include\n /// the function selector in the result.\n ///\n /// # Example\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n ///\n /// assert_eq!(\n /// \"0x0000000000000000000000000000000000000000000000000000000000000001\",\n /// Cast::abi_encode(\"f(uint a)\", &[\"1\"]).unwrap().as_str()\n /// );\n /// assert_eq!(\n /// \"0x0000000000000000000000000000000000000000000000000000000000000001\",\n /// Cast::abi_encode(\"constructor(uint a)\", &[\"1\"]).unwrap().as_str()\n /// );\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn abi_encode(sig: &str, args: &[impl AsRef]) -> Result {\n let func = get_func(sig)?;\n match encode_function_args(&func, args) {\n Ok(res) => Ok(hex::encode_prefixed(&res[4..])),\n Err(e) => eyre::bail!(\"Could not ABI encode the function and arguments: {e}\"),\n }\n }\n\n /// Performs packed ABI encoding based off of the function signature or tuple.\n ///\n /// # Examplez\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n ///\n /// assert_eq!(\n /// \"0x0000000000000000000000000000000000000000000000000000000000000064000000000000000000000000000000000000000000000000000000000000012c00000000000000c8\",\n /// Cast::abi_encode_packed(\"(uint128[] a, uint64 b)\", &[\"[100, 300]\", \"200\"]).unwrap().as_str()\n /// );\n ///\n /// assert_eq!(\n /// \"0x8dbd1b711dc621e1404633da156fcc779e1c6f3e68656c6c6f20776f726c64\",\n /// Cast::abi_encode_packed(\"foo(address a, string b)\", &[\"0x8dbd1b711dc621e1404633da156fcc779e1c6f3e\", \"hello world\"]).unwrap().as_str()\n /// );\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn abi_encode_packed(sig: &str, args: &[impl AsRef]) -> Result {\n // If the signature is a tuple, we need to prefix it to make it a function\n let sig =\n if sig.trim_start().starts_with('(') { format!(\"foo{sig}\") } else { sig.to_string() };\n\n let func = get_func(sig.as_str())?;\n let encoded = match encode_function_args_packed(&func, args) {\n Ok(res) => hex::encode(res),\n Err(e) => eyre::bail!(\"Could not ABI encode the function and arguments: {e}\"),\n };\n Ok(format!(\"0x{encoded}\"))\n }\n\n /// Performs ABI encoding of an event to produce the topics and data.\n ///\n /// # Example\n ///\n /// ```\n /// use alloy_primitives::hex;\n /// use cast::SimpleCast as Cast;\n ///\n /// let log_data = Cast::abi_encode_event(\n /// \"Transfer(address indexed from, address indexed to, uint256 value)\",\n /// &[\n /// \"0x1234567890123456789012345678901234567890\",\n /// \"0xabcdefabcdefabcdefabcdefabcdefabcdefabcd\",\n /// \"1000\",\n /// ],\n /// )\n /// .unwrap();\n ///\n /// // topic0 is the event selector\n /// assert_eq!(log_data.topics().len(), 3);\n /// assert_eq!(\n /// log_data.topics()[0].to_string(),\n /// \"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef\"\n /// );\n /// assert_eq!(\n /// log_data.topics()[1].to_string(),\n /// \"0x0000000000000000000000001234567890123456789012345678901234567890\"\n /// );\n /// assert_eq!(\n /// log_data.topics()[2].to_string(),\n /// \"0x000000000000000000000000abcdefabcdefabcdefabcdefabcdefabcdefabcd\"\n /// );\n /// assert_eq!(\n /// hex::encode_prefixed(log_data.data),\n /// \"0x00000000000000000000000000000000000000000000000000000000000003e8\"\n /// );\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn abi_encode_event(sig: &str, args: &[impl AsRef]) -> Result {\n let event = get_event(sig)?;\n let tokens = std::iter::zip(&event.inputs, args)\n .map(|(input, arg)| coerce_value(&input.ty, arg.as_ref()))\n .collect::>>()?;\n\n let mut topics = vec![event.selector()];\n let mut data_tokens: Vec = Vec::new();\n\n for (input, token) in event.inputs.iter().zip(tokens) {\n if input.indexed {\n let ty = DynSolType::parse(&input.ty)?;\n if matches!(\n ty,\n DynSolType::String\n | DynSolType::Bytes\n | DynSolType::Array(_)\n | DynSolType::Tuple(_)\n ) {\n // For dynamic types, hash the encoded value\n let encoded = token.abi_encode();\n let hash = keccak256(encoded);\n topics.push(hash);\n } else {\n // For fixed-size types, encode directly to 32 bytes\n let mut encoded = [0u8; 32];\n let token_encoded = token.abi_encode();\n if token_encoded.len() <= 32 {\n let start = 32 - token_encoded.len();\n encoded[start..].copy_from_slice(&token_encoded);\n }\n topics.push(B256::from(encoded));\n }\n } else {\n // Non-indexed parameters go into data\n data_tokens.extend_from_slice(&token.abi_encode());\n }\n }\n\n Ok(LogData::new_unchecked(topics, data_tokens.into()))\n }\n\n /// Performs ABI encoding to produce the hexadecimal calldata with the given arguments.\n ///\n /// # Example\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n ///\n /// assert_eq!(\n /// \"0xb3de648b0000000000000000000000000000000000000000000000000000000000000001\",\n /// Cast::calldata_encode(\"f(uint256 a)\", &[\"1\"]).unwrap().as_str()\n /// );\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn calldata_encode(sig: impl AsRef, args: &[impl AsRef]) -> Result {\n let func = get_func(sig.as_ref())?;\n let calldata = encode_function_args(&func, args)?;\n Ok(hex::encode_prefixed(calldata))\n }\n\n /// Returns the slot number for a given mapping key and slot.\n ///\n /// Given `mapping(k => v) m`, for a key `k` the slot number of its associated `v` is\n /// `keccak256(concat(h(k), p))`, where `h` is the padding function for `k`'s type, and `p`\n /// is slot number of the mapping `m`.\n ///\n /// See [the Solidity documentation](https://docs.soliditylang.org/en/latest/internals/layout_in_storage.html#mappings-and-dynamic-arrays)\n /// for more details.\n ///\n /// # Example\n ///\n /// ```\n /// # use cast::SimpleCast as Cast;\n ///\n /// // Value types.\n /// assert_eq!(\n /// Cast::index(\"address\", \"0xD0074F4E6490ae3f888d1d4f7E3E43326bD3f0f5\", \"2\").unwrap().as_str(),\n /// \"0x9525a448a9000053a4d151336329d6563b7e80b24f8e628e95527f218e8ab5fb\"\n /// );\n /// assert_eq!(\n /// Cast::index(\"uint256\", \"42\", \"6\").unwrap().as_str(),\n /// \"0xfc808b0f31a1e6b9cf25ff6289feae9b51017b392cc8e25620a94a38dcdafcc1\"\n /// );\n ///\n /// // Strings and byte arrays.\n /// assert_eq!(\n /// Cast::index(\"string\", \"hello\", \"1\").unwrap().as_str(),\n /// \"0x8404bb4d805e9ca2bd5dd5c43a107e935c8ec393caa7851b353b3192cd5379ae\"\n /// );\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn index(key_type: &str, key: &str, slot_number: &str) -> Result {\n let mut hasher = Keccak256::new();\n\n let k_ty = DynSolType::parse(key_type).wrap_err(\"Could not parse type\")?;\n let k = k_ty.coerce_str(key).wrap_err(\"Could not parse value\")?;\n match k_ty {\n // For value types, `h` pads the value to 32 bytes in the same way as when storing the\n // value in memory.\n DynSolType::Bool\n | DynSolType::Int(_)\n | DynSolType::Uint(_)\n | DynSolType::FixedBytes(_)\n | DynSolType::Address\n | DynSolType::Function => hasher.update(k.as_word().unwrap()),\n\n // For strings and byte arrays, `h(k)` is just the unpadded data.\n DynSolType::String | DynSolType::Bytes => hasher.update(k.as_packed_seq().unwrap()),\n\n DynSolType::Array(..)\n | DynSolType::FixedArray(..)\n | DynSolType::Tuple(..)\n | DynSolType::CustomStruct { .. } => {\n eyre::bail!(\"Type `{k_ty}` is not supported as a mapping key\")\n }\n }\n\n let p = DynSolType::Uint(256)\n .coerce_str(slot_number)\n .wrap_err(\"Could not parse slot number\")?;\n let p = p.as_word().unwrap();\n hasher.update(p);\n\n let location = hasher.finalize();\n Ok(location.to_string())\n }\n\n /// Keccak-256 hashes arbitrary data\n ///\n /// # Example\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n ///\n /// assert_eq!(\n /// Cast::keccak(\"foo\")?,\n /// \"0x41b1a0649752af1b28b3dc29a1556eee781e4a4c3a1f7f53f90fa834de098c4d\"\n /// );\n /// assert_eq!(\n /// Cast::keccak(\"123abc\")?,\n /// \"0xb1f1c74a1ba56f07a892ea1110a39349d40f66ca01d245e704621033cb7046a4\"\n /// );\n /// assert_eq!(\n /// Cast::keccak(\"0x12\")?,\n /// \"0x5fa2358263196dbbf23d1ca7a509451f7a2f64c15837bfbb81298b1e3e24e4fa\"\n /// );\n /// assert_eq!(\n /// Cast::keccak(\"12\")?,\n /// \"0x7f8b6b088b6d74c2852fc86c796dca07b44eed6fb3daf5e6b59f7c364db14528\"\n /// );\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn keccak(data: &str) -> Result {\n // Hex-decode if data starts with 0x.\n let hash = if data.starts_with(\"0x\") {\n keccak256(hex::decode(data.trim_end())?)\n } else {\n keccak256(data)\n };\n Ok(hash.to_string())\n }\n\n /// Performs the left shift operation (<<) on a number\n ///\n /// # Example\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n ///\n /// assert_eq!(Cast::left_shift(\"16\", \"10\", Some(\"10\"), \"hex\")?, \"0x4000\");\n /// assert_eq!(Cast::left_shift(\"255\", \"16\", Some(\"dec\"), \"hex\")?, \"0xff0000\");\n /// assert_eq!(Cast::left_shift(\"0xff\", \"16\", None, \"hex\")?, \"0xff0000\");\n /// # Ok::<_, eyre::Report>(())\n /// ```\n pub fn left_shift(\n value: &str,\n bits: &str,\n base_in: Option<&str>,\n base_out: &str,\n ) -> Result {\n let base_out: Base = base_out.parse()?;\n let value = NumberWithBase::parse_uint(value, base_in)?;\n let bits = NumberWithBase::parse_uint(bits, None)?;\n\n let res = value.number() << bits.number();\n\n Ok(res.to_base(base_out, true)?)\n }\n\n /// Performs the right shift operation (>>) on a number\n ///\n /// # Example\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n ///\n /// assert_eq!(Cast::right_shift(\"0x4000\", \"10\", None, \"dec\")?, \"16\");\n /// assert_eq!(Cast::right_shift(\"16711680\", \"16\", Some(\"10\"), \"hex\")?, \"0xff\");\n /// assert_eq!(Cast::right_shift(\"0xff0000\", \"16\", None, \"hex\")?, \"0xff\");\n /// # Ok::<(), eyre::Report>(())\n /// ```\n pub fn right_shift(\n value: &str,\n bits: &str,\n base_in: Option<&str>,\n base_out: &str,\n ) -> Result {\n let base_out: Base = base_out.parse()?;\n let value = NumberWithBase::parse_uint(value, base_in)?;\n let bits = NumberWithBase::parse_uint(bits, None)?;\n\n let res = value.number().wrapping_shr(bits.number().saturating_to());\n\n Ok(res.to_base(base_out, true)?)\n }\n\n /// Fetches source code of verified contracts from etherscan.\n ///\n /// # Example\n ///\n /// ```\n /// # use cast::SimpleCast as Cast;\n /// # use foundry_config::NamedChain;\n /// # async fn foo() -> eyre::Result<()> {\n /// assert_eq!(\n /// \"/*\n /// - Bytecode Verification performed was compared on second iteration -\n /// This file is part of the DAO.....\",\n /// Cast::etherscan_source(\n /// NamedChain::Mainnet.into(),\n /// \"0xBB9bc244D798123fDe783fCc1C72d3Bb8C189413\".to_string(),\n /// Some(\"\".to_string()),\n /// None,\n /// None\n /// )\n /// .await\n /// .unwrap()\n /// .as_str()\n /// );\n /// # Ok(())\n /// # }\n /// ```\n pub async fn etherscan_source(\n chain: Chain,\n contract_address: String,\n etherscan_api_key: Option,\n explorer_api_url: Option,\n explorer_url: Option,\n ) -> Result {\n let client = explorer_client(chain, etherscan_api_key, explorer_api_url, explorer_url)?;\n let metadata = client.contract_source_code(contract_address.parse()?).await?;\n Ok(metadata.source_code())\n }\n\n /// Fetches the source code of verified contracts from etherscan and expands the resulting\n /// files to a directory for easy perusal.\n ///\n /// # Example\n ///\n /// ```\n /// # use cast::SimpleCast as Cast;\n /// # use foundry_config::NamedChain;\n /// # use std::path::PathBuf;\n /// # async fn expand() -> eyre::Result<()> {\n /// Cast::expand_etherscan_source_to_directory(\n /// NamedChain::Mainnet.into(),\n /// \"0xBB9bc244D798123fDe783fCc1C72d3Bb8C189413\".to_string(),\n /// Some(\"\".to_string()),\n /// PathBuf::from(\"output_dir\"),\n /// None,\n /// None,\n /// )\n /// .await?;\n /// # Ok(())\n /// # }\n /// ```\n pub async fn expand_etherscan_source_to_directory(\n chain: Chain,\n contract_address: String,\n etherscan_api_key: Option,\n output_directory: PathBuf,\n explorer_api_url: Option,\n explorer_url: Option,\n ) -> eyre::Result<()> {\n let client = explorer_client(chain, etherscan_api_key, explorer_api_url, explorer_url)?;\n let meta = client.contract_source_code(contract_address.parse()?).await?;\n let source_tree = meta.source_tree();\n source_tree.write_to(&output_directory)?;\n Ok(())\n }\n\n /// Fetches the source code of verified contracts from etherscan, flattens it and writes it to\n /// the given path or stdout.\n pub async fn etherscan_source_flatten(\n chain: Chain,\n contract_address: String,\n etherscan_api_key: Option,\n output_path: Option,\n explorer_api_url: Option,\n explorer_url: Option,\n ) -> Result<()> {\n let client = explorer_client(chain, etherscan_api_key, explorer_api_url, explorer_url)?;\n let metadata = client.contract_source_code(contract_address.parse()?).await?;\n let Some(metadata) = metadata.items.first() else {\n eyre::bail!(\"Empty contract source code\")\n };\n\n let tmp = tempfile::tempdir()?;\n let project = etherscan_project(metadata, tmp.path())?;\n let target_path = project.find_contract_path(&metadata.contract_name)?;\n\n let flattened = flatten(project, &target_path)?;\n\n if let Some(path) = output_path {\n fs::create_dir_all(path.parent().unwrap())?;\n fs::write(&path, flattened)?;\n sh_println!(\"Flattened file written at {}\", path.display())?\n } else {\n sh_println!(\"{flattened}\")?\n }\n\n Ok(())\n }\n\n /// Disassembles hex encoded bytecode into individual / human readable opcodes\n ///\n /// # Example\n ///\n /// ```\n /// use alloy_primitives::hex;\n /// use cast::SimpleCast as Cast;\n ///\n /// # async fn foo() -> eyre::Result<()> {\n /// let bytecode = \"0x608060405260043610603f57600035\";\n /// let opcodes = Cast::disassemble(&hex::decode(bytecode)?)?;\n /// println!(\"{}\", opcodes);\n /// # Ok(())\n /// # }\n /// ```\n pub fn disassemble(code: &[u8]) -> Result {\n let mut output = String::new();\n for (pc, inst) in InstIter::new(code).with_pc() {\n writeln!(output, \"{pc:08x}: {inst}\")?;\n }\n Ok(output)\n }\n\n /// Gets the selector for a given function signature\n /// Optimizes if the `optimize` parameter is set to a number of leading zeroes\n ///\n /// # Example\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n ///\n /// assert_eq!(Cast::get_selector(\"foo(address,uint256)\", 0)?.0, String::from(\"0xbd0d639f\"));\n /// # Ok::<(), eyre::Error>(())\n /// ```\n pub fn get_selector(signature: &str, optimize: usize) -> Result<(String, String)> {\n if optimize > 4 {\n eyre::bail!(\"number of leading zeroes must not be greater than 4\");\n }\n if optimize == 0 {\n let selector = get_func(signature)?.selector();\n return Ok((selector.to_string(), String::from(signature)));\n }\n let Some((name, params)) = signature.split_once('(') else {\n eyre::bail!(\"invalid function signature\");\n };\n\n let num_threads = rayon::current_num_threads();\n let found = AtomicBool::new(false);\n\n let result: Option<(u32, String, String)> =\n (0..num_threads).into_par_iter().find_map_any(|i| {\n let nonce_start = i as u32;\n let nonce_step = num_threads as u32;\n\n let mut nonce = nonce_start;\n while nonce < u32::MAX && !found.load(Ordering::Relaxed) {\n let input = format!(\"{name}{nonce}({params}\");\n let hash = keccak256(input.as_bytes());\n let selector = &hash[..4];\n\n if selector.iter().take_while(|&&byte| byte == 0).count() == optimize {\n found.store(true, Ordering::Relaxed);\n return Some((nonce, hex::encode_prefixed(selector), input));\n }\n\n nonce += nonce_step;\n }\n None\n });\n\n match result {\n Some((_nonce, selector, signature)) => Ok((selector, signature)),\n None => eyre::bail!(\"No selector found\"),\n }\n }\n\n /// Extracts function selectors, arguments and state mutability from bytecode\n ///\n /// # Example\n ///\n /// ```\n /// use alloy_primitives::fixed_bytes;\n /// use cast::SimpleCast as Cast;\n ///\n /// let bytecode = \"6080604052348015600e575f80fd5b50600436106026575f3560e01c80632125b65b14602a575b5f80fd5b603a6035366004603c565b505050565b005b5f805f60608486031215604d575f80fd5b833563ffffffff81168114605f575f80fd5b925060208401356001600160a01b03811681146079575f80fd5b915060408401356001600160e01b03811681146093575f80fd5b80915050925092509256\";\n /// let functions = Cast::extract_functions(bytecode)?;\n /// assert_eq!(functions, vec![(fixed_bytes!(\"0x2125b65b\"), \"uint32,address,uint224\".to_string(), \"pure\")]);\n /// # Ok::<(), eyre::Report>(())\n /// ```\n pub fn extract_functions(bytecode: &str) -> Result> {\n let code = hex::decode(bytecode)?;\n let info = evmole::contract_info(\n evmole::ContractInfoArgs::new(&code)\n .with_selectors()\n .with_arguments()\n .with_state_mutability(),\n );\n Ok(info\n .functions\n .expect(\"functions extraction was requested\")\n .into_iter()\n .map(|f| {\n (\n f.selector.into(),\n f.arguments\n .expect(\"arguments extraction was requested\")\n .into_iter()\n .map(|t| t.sol_type_name().to_string())\n .collect::>()\n .join(\",\"),\n f.state_mutability\n .expect(\"state_mutability extraction was requested\")\n .as_json_str(),\n )\n })\n .collect())\n }\n\n /// Decodes a raw EIP2718 transaction payload\n /// Returns details about the typed transaction and ECSDA signature components\n ///\n /// # Example\n ///\n /// ```\n /// use cast::SimpleCast as Cast;\n ///\n /// let tx = \"0x02f8f582a86a82058d8459682f008508351050808303fd84948e42f2f4101563bf679975178e880fd87d3efd4e80b884659ac74b00000000000000000000000080f0c1c49891dcfdd40b6e0f960f84e6042bcb6f000000000000000000000000b97ef9ef8734c71904d8002f8b6bc66dd9c48a6e00000000000000000000000000000000000000000000000000000000007ff4e20000000000000000000000000000000000000000000000000000000000000064c001a05d429597befe2835396206781b199122f2e8297327ed4a05483339e7a8b2022aa04c23a7f70fb29dda1b4ee342fb10a625e9b8ddc6a603fb4e170d4f6f37700cb8\";\n /// let tx_envelope = Cast::decode_raw_transaction(&tx)?;\n /// # Ok::<(), eyre::Report>(())\n pub fn decode_raw_transaction(tx: &str) -> Result {\n let tx_hex = hex::decode(tx)?;\n let tx = Decodable2718::decode_2718(&mut tx_hex.as_slice())?;\n Ok(tx)\n }\n}\n\npub(crate) fn strip_0x(s: &str) -> &str {\n s.strip_prefix(\"0x\").unwrap_or(s)\n}\n\nfn explorer_client(\n chain: Chain,\n api_key: Option,\n api_url: Option,\n explorer_url: Option,\n) -> Result {\n let mut builder = Client::builder();\n\n let deduced = chain.etherscan_urls();\n\n let explorer_url = explorer_url\n .or(deduced.map(|d| d.1.to_string()))\n .ok_or_eyre(\"Please provide the explorer browser URL using `--explorer-url`\")?;\n builder = builder.with_url(explorer_url)?;\n\n let api_url = api_url\n .or(deduced.map(|d| d.0.to_string()))\n .ok_or_eyre(\"Please provide the explorer API URL using `--explorer-api-url`\")?;\n builder = builder.with_api_url(api_url)?;\n\n if let Some(api_key) = api_key {\n builder = builder.with_api_key(api_key);\n }\n\n builder.build().map_err(Into::into)\n}\n\n#[cfg(test)]\nmod tests {\n use super::{DynSolValue, SimpleCast as Cast, serialize_value_as_json};\n use alloy_primitives::hex;\n\n #[test]\n fn simple_selector() {\n assert_eq!(\"0xc2985578\", Cast::get_selector(\"foo()\", 0).unwrap().0.as_str())\n }\n\n #[test]\n fn selector_with_arg() {\n assert_eq!(\"0xbd0d639f\", Cast::get_selector(\"foo(address,uint256)\", 0).unwrap().0.as_str())\n }\n\n #[test]\n fn calldata_uint() {\n assert_eq!(\n \"0xb3de648b0000000000000000000000000000000000000000000000000000000000000001\",\n Cast::calldata_encode(\"f(uint256 a)\", &[\"1\"]).unwrap().as_str()\n );\n }\n\n // \n #[test]\n fn calldata_array() {\n assert_eq!(\n \"0xcde2baba0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000000\",\n Cast::calldata_encode(\"propose(string[])\", &[\"[\\\"\\\"]\"]).unwrap().as_str()\n );\n }\n\n #[test]\n fn calldata_bool() {\n assert_eq!(\n \"0x6fae94120000000000000000000000000000000000000000000000000000000000000000\",\n Cast::calldata_encode(\"bar(bool)\", &[\"false\"]).unwrap().as_str()\n );\n }\n\n #[test]\n fn abi_decode() {\n let data = \"0x0000000000000000000000000000000000000000000000000000000000000001\";\n let sig = \"balanceOf(address, uint256)(uint256)\";\n assert_eq!(\n \"1\",\n Cast::abi_decode(sig, data, false).unwrap()[0].as_uint().unwrap().0.to_string()\n );\n\n let data = \"0x0000000000000000000000008dbd1b711dc621e1404633da156fcc779e1c6f3e000000000000000000000000d9f3c9cc99548bf3b44a43e0a2d07399eb918adc000000000000000000000000000000000000000000000000000000000000002a000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000\";\n let sig = \"safeTransferFrom(address,address,uint256,uint256,bytes)\";\n let decoded = Cast::abi_decode(sig, data, true).unwrap();\n let decoded = [\n decoded[0]\n .as_address()\n .unwrap()\n .to_string()\n .strip_prefix(\"0x\")\n .unwrap()\n .to_owned()\n .to_lowercase(),\n decoded[1]\n .as_address()\n .unwrap()\n .to_string()\n .strip_prefix(\"0x\")\n .unwrap()\n .to_owned()\n .to_lowercase(),\n decoded[2].as_uint().unwrap().0.to_string(),\n decoded[3].as_uint().unwrap().0.to_string(),\n hex::encode(decoded[4].as_bytes().unwrap()),\n ]\n .to_vec();\n assert_eq!(\n decoded,\n vec![\n \"8dbd1b711dc621e1404633da156fcc779e1c6f3e\",\n \"d9f3c9cc99548bf3b44a43e0a2d07399eb918adc\",\n \"42\",\n \"1\",\n \"\"\n ]\n );\n }\n\n #[test]\n fn calldata_decode() {\n let data = \"0x0000000000000000000000000000000000000000000000000000000000000001\";\n let sig = \"balanceOf(address, uint256)(uint256)\";\n let decoded =\n Cast::calldata_decode(sig, data, false).unwrap()[0].as_uint().unwrap().0.to_string();\n assert_eq!(decoded, \"1\");\n\n // Passing `input = true` will decode the data with the input function signature.\n // We exclude the \"prefixed\" function selector from the data field (the first 4 bytes).\n let data = \"0xf242432a0000000000000000000000008dbd1b711dc621e1404633da156fcc779e1c6f3e000000000000000000000000d9f3c9cc99548bf3b44a43e0a2d07399eb918adc000000000000000000000000000000000000000000000000000000000000002a000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000\";\n let sig = \"safeTransferFrom(address, address, uint256, uint256, bytes)\";\n let decoded = Cast::calldata_decode(sig, data, true).unwrap();\n let decoded = [\n decoded[0].as_address().unwrap().to_string().to_lowercase(),\n decoded[1].as_address().unwrap().to_string().to_lowercase(),\n decoded[2].as_uint().unwrap().0.to_string(),\n decoded[3].as_uint().unwrap().0.to_string(),\n hex::encode(decoded[4].as_bytes().unwrap()),\n ]\n .into_iter()\n .collect::>();\n assert_eq!(\n decoded,\n vec![\n \"0x8dbd1b711dc621e1404633da156fcc779e1c6f3e\",\n \"0xd9f3c9cc99548bf3b44a43e0a2d07399eb918adc\",\n \"42\",\n \"1\",\n \"\"\n ]\n );\n }\n\n #[test]\n fn calldata_decode_nested_json() {\n let calldata = \"0xdb5b0ed700000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000006772bf190000000000000000000000000000000000000000000000000000000000020716000000000000000000000000af9d27ffe4d51ed54ac8eec78f2785d7e11e5ab100000000000000000000000000000000000000000000000000000000000002c0000000000000000000000000000000000000000000000000000000000000000404366a6dc4b2f348a85e0066e46f0cc206fca6512e0ed7f17ca7afb88e9a4c27000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000093922dee6e380c28a50c008ab167b7800bb24c2026cd1b22f1c6fb884ceed7400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000060f85e59ecad6c1a6be343a945abedb7d5b5bfad7817c4d8cc668da7d391faf700000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000093dfbf04395fbec1f1aed4ad0f9d3ba880ff58a60485df5d33f8f5e0fb73188600000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000aa334a426ea9e21d5f84eb2d4723ca56b92382b9260ab2b6769b7c23d437b6b512322a25cecc954127e60cf91ef056ac1da25f90b73be81c3ff1872fa48d10c7ef1ccb4087bbeedb54b1417a24abbb76f6cd57010a65bb03c7b6602b1eaf0e32c67c54168232d4edc0bfa1b815b2af2a2d0a5c109d675a4f2de684e51df9abb324ab1b19a81bac80f9ce3a45095f3df3a7cf69ef18fc08e94ac3cbc1c7effeacca68e3bfe5d81e26a659b5\";\n let sig = \"sequenceBatchesValidium((bytes32,bytes32,uint64,bytes32)[],uint64,uint64,address,bytes)\";\n let decoded = Cast::calldata_decode(sig, calldata, true).unwrap();\n let json_value = serialize_value_as_json(DynSolValue::Array(decoded), None).unwrap();\n let expected = serde_json::json!([\n [\n [\n \"0x04366a6dc4b2f348a85e0066e46f0cc206fca6512e0ed7f17ca7afb88e9a4c27\",\n \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n 0,\n \"0x0000000000000000000000000000000000000000000000000000000000000000\"\n ],\n [\n \"0x093922dee6e380c28a50c008ab167b7800bb24c2026cd1b22f1c6fb884ceed74\",\n \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n 0,\n \"0x0000000000000000000000000000000000000000000000000000000000000000\"\n ],\n [\n \"0x60f85e59ecad6c1a6be343a945abedb7d5b5bfad7817c4d8cc668da7d391faf7\",\n \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n 0,\n \"0x0000000000000000000000000000000000000000000000000000000000000000\"\n ],\n [\n \"0x93dfbf04395fbec1f1aed4ad0f9d3ba880ff58a60485df5d33f8f5e0fb731886\",\n \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n 0,\n \"0x0000000000000000000000000000000000000000000000000000000000000000\"\n ]\n ],\n 1735573273,\n 132886,\n \"0xAF9d27ffe4d51eD54AC8eEc78f2785D7E11E5ab1\",\n \"0x334a426ea9e21d5f84eb2d4723ca56b92382b9260ab2b6769b7c23d437b6b512322a25cecc954127e60cf91ef056ac1da25f90b73be81c3ff1872fa48d10c7ef1ccb4087bbeedb54b1417a24abbb76f6cd57010a65bb03c7b6602b1eaf0e32c67c54168232d4edc0bfa1b815b2af2a2d0a5c109d675a4f2de684e51df9abb324ab1b19a81bac80f9ce3a45095f3df3a7cf69ef18fc08e94ac3cbc1c7effeacca68e3bfe5d81e26a659b5\"\n ]);\n assert_eq!(json_value, expected);\n }\n\n #[test]\n fn concat_hex() {\n assert_eq!(Cast::concat_hex([\"0x00\", \"0x01\"]), \"0x0001\");\n assert_eq!(Cast::concat_hex([\"1\", \"2\"]), \"0x12\");\n }\n\n #[test]\n fn from_rlp() {\n let rlp = \"0xf8b1a02b5df5f0757397573e8ff34a8b987b21680357de1f6c8d10273aa528a851eaca8080a02838ac1d2d2721ba883169179b48480b2ba4f43d70fcf806956746bd9e83f90380a0e46fff283b0ab96a32a7cc375cecc3ed7b6303a43d64e0a12eceb0bc6bd8754980a01d818c1c414c665a9c9a0e0c0ef1ef87cacb380b8c1f6223cb2a68a4b2d023f5808080a0236e8f61ecde6abfebc6c529441f782f62469d8a2cc47b7aace2c136bd3b1ff08080808080\";\n let item = Cast::from_rlp(rlp, false).unwrap();\n assert_eq!(\n item,\n r#\"[\"0x2b5df5f0757397573e8ff34a8b987b21680357de1f6c8d10273aa528a851eaca\",\"0x\",\"0x\",\"0x2838ac1d2d2721ba883169179b48480b2ba4f43d70fcf806956746bd9e83f903\",\"0x\",\"0xe46fff283b0ab96a32a7cc375cecc3ed7b6303a43d64e0a12eceb0bc6bd87549\",\"0x\",\"0x1d818c1c414c665a9c9a0e0c0ef1ef87cacb380b8c1f6223cb2a68a4b2d023f5\",\"0x\",\"0x\",\"0x\",\"0x236e8f61ecde6abfebc6c529441f782f62469d8a2cc47b7aace2c136bd3b1ff0\",\"0x\",\"0x\",\"0x\",\"0x\",\"0x\"]\"#\n )\n }\n\n #[test]\n fn disassemble_incomplete_sequence() {\n let incomplete = &hex!(\"60\"); // PUSH1\n let disassembled = Cast::disassemble(incomplete).unwrap();\n assert_eq!(disassembled, \"00000000: PUSH1\\n\");\n\n let complete = &hex!(\"6000\"); // PUSH1 0x00\n let disassembled = Cast::disassemble(complete).unwrap();\n assert_eq!(disassembled, \"00000000: PUSH1 0x00\\n\");\n\n let incomplete = &hex!(\"7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff\"); // PUSH32 with 31 bytes\n let disassembled = Cast::disassemble(incomplete).unwrap();\n assert_eq!(disassembled, \"00000000: PUSH32\\n\");\n\n let complete = &hex!(\"7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff\"); // PUSH32 with 32 bytes\n let disassembled = Cast::disassemble(complete).unwrap();\n assert_eq!(\n disassembled,\n \"00000000: PUSH32 0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff\\n\"\n );\n }\n}\n" }, { "path": "crates/cast/src/opts.rs", "content": "use crate::cmd::{\n access_list::AccessListArgs, artifact::ArtifactArgs, b2e_payload::B2EPayloadArgs,\n bind::BindArgs, call::CallArgs, constructor_args::ConstructorArgsArgs, create2::Create2Args,\n creation_code::CreationCodeArgs, da_estimate::DAEstimateArgs, erc20::Erc20Subcommand,\n estimate::EstimateArgs, find_block::FindBlockArgs, interface::InterfaceArgs, logs::LogsArgs,\n mktx::MakeTxArgs, rpc::RpcArgs, run::RunArgs, send::SendTxArgs, storage::StorageArgs,\n trace::TraceArgs, txpool::TxPoolSubcommands, wallet::WalletSubcommands,\n};\nuse alloy_ens::NameOrAddress;\nuse alloy_primitives::{Address, B256, Selector, U256};\nuse alloy_rpc_types::BlockId;\nuse clap::{ArgAction, Parser, Subcommand, ValueHint};\nuse eyre::Result;\nuse foundry_cli::opts::{EtherscanOpts, GlobalArgs, NetworkVariant, RpcOpts};\nuse foundry_common::version::{LONG_VERSION, SHORT_VERSION};\nuse std::{path::PathBuf, str::FromStr};\n/// A Swiss Army knife for interacting with Ethereum applications from the command line.\n#[derive(Parser)]\n#[command(\n name = \"cast\",\n version = SHORT_VERSION,\n long_version = LONG_VERSION,\n after_help = \"Find more information in the book: https://getfoundry.sh/cast/overview\",\n next_display_order = None,\n)]\npub struct Cast {\n /// Include the global arguments.\n #[command(flatten)]\n pub global: GlobalArgs,\n\n #[command(subcommand)]\n pub cmd: CastSubcommand,\n}\n\n#[derive(Subcommand)]\npub enum CastSubcommand {\n /// Prints the maximum value of the given integer type.\n #[command(visible_aliases = &[\"--max-int\", \"maxi\"])]\n MaxInt {\n /// The integer type to get the maximum value of.\n #[arg(default_value = \"int256\")]\n r#type: String,\n },\n\n /// Prints the minimum value of the given integer type.\n #[command(visible_aliases = &[\"--min-int\", \"mini\"])]\n MinInt {\n /// The integer type to get the minimum value of.\n #[arg(default_value = \"int256\")]\n r#type: String,\n },\n\n /// Prints the maximum value of the given integer type.\n #[command(visible_aliases = &[\"--max-uint\", \"maxu\"])]\n MaxUint {\n /// The unsigned integer type to get the maximum value of.\n #[arg(default_value = \"uint256\")]\n r#type: String,\n },\n\n /// Prints the zero address.\n #[command(visible_aliases = &[\"--address-zero\", \"az\"])]\n AddressZero,\n\n /// Prints the zero hash.\n #[command(visible_aliases = &[\"--hash-zero\", \"hz\"])]\n HashZero,\n\n /// Convert UTF8 text to hex.\n #[command(\n visible_aliases = &[\n \"--from-ascii\",\n \"--from-utf8\",\n \"from-ascii\",\n \"fu\",\n \"fa\"]\n )]\n FromUtf8 {\n /// The text to convert.\n text: Option,\n },\n\n /// Concatenate hex strings.\n #[command(visible_aliases = &[\"--concat-hex\", \"ch\"])]\n ConcatHex {\n /// The data to concatenate.\n data: Vec,\n },\n\n /// Convert binary data into hex data.\n #[command(visible_aliases = &[\"--from-bin\", \"from-binx\", \"fb\"])]\n FromBin,\n\n /// Normalize the input to lowercase, 0x-prefixed hex.\n ///\n /// The input can be:\n /// - mixed case hex with or without 0x prefix\n /// - 0x prefixed hex, concatenated with a ':'\n /// - an absolute path to file\n /// - @tag, where the tag is defined in an environment variable\n #[command(visible_aliases = &[\"--to-hexdata\", \"thd\", \"2hd\"])]\n ToHexdata {\n /// The input to normalize.\n input: Option,\n },\n\n /// Convert an address to a checksummed format (EIP-55).\n #[command(\n visible_aliases = &[\"--to-checksum-address\",\n \"--to-checksum\",\n \"to-checksum\",\n \"ta\",\n \"2a\"]\n )]\n ToCheckSumAddress {\n /// The address to convert.\n address: Option
,\n /// EIP-155 chain ID to encode the address using EIP-1191.\n chain_id: Option,\n },\n\n /// Convert hex data to an ASCII string.\n #[command(visible_aliases = &[\"--to-ascii\", \"tas\", \"2as\"])]\n ToAscii {\n /// The hex data to convert.\n hexdata: Option,\n },\n\n /// Convert hex data to a utf-8 string.\n #[command(visible_aliases = &[\"--to-utf8\", \"tu8\", \"2u8\"])]\n ToUtf8 {\n /// The hex data to convert.\n hexdata: Option,\n },\n\n /// Convert a fixed point number into an integer.\n #[command(visible_aliases = &[\"--from-fix\", \"ff\"])]\n FromFixedPoint {\n /// The number of decimals to use.\n decimals: Option,\n\n /// The value to convert.\n #[arg(allow_hyphen_values = true)]\n value: Option,\n },\n\n /// Right-pads hex data to 32 bytes.\n #[command(visible_aliases = &[\"--to-bytes32\", \"tb\", \"2b\"])]\n ToBytes32 {\n /// The hex data to convert.\n bytes: Option,\n },\n\n /// Pads hex data to a specified length.\n #[command(visible_aliases = &[\"pd\"])]\n Pad {\n /// The hex data to pad.\n data: Option,\n\n /// Right-pad the data (instead of left-pad).\n #[arg(long)]\n right: bool,\n\n /// Left-pad the data (default).\n #[arg(long, conflicts_with = \"right\")]\n left: bool,\n\n /// Target length in bytes (default: 32).\n #[arg(long, default_value = \"32\")]\n len: usize,\n },\n\n /// Convert an integer into a fixed point number.\n #[command(visible_aliases = &[\"--to-fix\", \"tf\", \"2f\"])]\n ToFixedPoint {\n /// The number of decimals to use.\n decimals: Option,\n\n /// The value to convert.\n #[arg(allow_hyphen_values = true)]\n value: Option,\n },\n\n /// Convert a number to a hex-encoded uint256.\n #[command(name = \"to-uint256\", visible_aliases = &[\"--to-uint256\", \"tu\", \"2u\"])]\n ToUint256 {\n /// The value to convert.\n value: Option,\n },\n\n /// Convert a number to a hex-encoded int256.\n #[command(name = \"to-int256\", visible_aliases = &[\"--to-int256\", \"ti\", \"2i\"])]\n ToInt256 {\n /// The value to convert.\n value: Option,\n },\n\n /// Perform a left shifting operation\n #[command(name = \"shl\")]\n LeftShift {\n /// The value to shift.\n value: String,\n\n /// The number of bits to shift.\n bits: String,\n\n /// The input base.\n #[arg(long)]\n base_in: Option,\n\n /// The output base.\n #[arg(long, default_value = \"16\")]\n base_out: String,\n },\n\n /// Perform a right shifting operation\n #[command(name = \"shr\")]\n RightShift {\n /// The value to shift.\n value: String,\n\n /// The number of bits to shift.\n bits: String,\n\n /// The input base,\n #[arg(long)]\n base_in: Option,\n\n /// The output base,\n #[arg(long, default_value = \"16\")]\n base_out: String,\n },\n\n /// Convert an ETH amount into another unit (ether, gwei or wei).\n ///\n /// Examples:\n /// - 1ether wei\n /// - \"1 ether\" wei\n /// - 1ether\n /// - 1 gwei\n /// - 1gwei ether\n #[command(visible_aliases = &[\"--to-unit\", \"tun\", \"2un\"])]\n ToUnit {\n /// The value to convert.\n value: Option,\n\n /// The unit to convert to (ether, gwei, wei).\n #[arg(default_value = \"wei\")]\n unit: String,\n },\n\n /// Convert a number from decimal to smallest unit with arbitrary decimals.\n ///\n /// Examples:\n /// - 1.0 6 (for USDC, result: 1000000)\n /// - 2.5 12 (for 12 decimals token, result: 2500000000000)\n /// - 1.23 3 (for 3 decimals token, result: 1230)\n #[command(visible_aliases = &[\"--parse-units\", \"pun\"])]\n ParseUnits {\n /// The value to convert.\n value: Option,\n\n /// The unit to convert to.\n #[arg(default_value = \"18\")]\n unit: u8,\n },\n\n /// Format a number from smallest unit to decimal with arbitrary decimals.\n ///\n /// Examples:\n /// - 1000000 6 (for USDC, result: 1.0)\n /// - 2500000000000 12 (for 12 decimals, result: 2.5)\n /// - 1230 3 (for 3 decimals, result: 1.23)\n #[command(visible_aliases = &[\"--format-units\", \"fun\"])]\n FormatUnits {\n /// The value to format.\n value: Option,\n\n /// The unit to format to.\n #[arg(default_value = \"18\")]\n unit: u8,\n },\n\n /// Convert an ETH amount to wei.\n ///\n /// Consider using --to-unit.\n #[command(visible_aliases = &[\"--to-wei\", \"tw\", \"2w\"])]\n ToWei {\n /// The value to convert.\n #[arg(allow_hyphen_values = true)]\n value: Option,\n\n /// The unit to convert from (ether, gwei, wei).\n #[arg(default_value = \"eth\")]\n unit: String,\n },\n\n /// Convert wei into an ETH amount.\n ///\n /// Consider using --to-unit.\n #[command(visible_aliases = &[\"--from-wei\", \"fw\"])]\n FromWei {\n /// The value to convert.\n #[arg(allow_hyphen_values = true)]\n value: Option,\n\n /// The unit to convert from (ether, gwei, wei).\n #[arg(default_value = \"eth\")]\n unit: String,\n },\n\n /// RLP encodes hex data, or an array of hex data.\n ///\n /// Accepts a hex-encoded string, or an array of hex-encoded strings.\n /// Can be arbitrarily recursive.\n ///\n /// Examples:\n /// - `cast to-rlp \"[]\"` -> `0xc0`\n /// - `cast to-rlp \"0x22\"` -> `0x22`\n /// - `cast to-rlp \"[\\\"0x61\\\"]\"` -> `0xc161`\n /// - `cast to-rlp \"[\\\"0xf1\\\", \\\"f2\\\"]\"` -> `0xc481f181f2`\n #[command(visible_aliases = &[\"--to-rlp\"])]\n ToRlp {\n /// The value to convert.\n ///\n /// This is a hex-encoded string, or an array of hex-encoded strings.\n /// Can be arbitrarily recursive.\n value: Option,\n },\n\n /// Decodes RLP hex-encoded data.\n #[command(visible_aliases = &[\"--from-rlp\"])]\n FromRlp {\n /// The RLP hex-encoded data.\n value: Option,\n\n /// Decode the RLP data as int\n #[arg(long, alias = \"int\")]\n as_int: bool,\n },\n\n /// Converts a number of one base to another\n #[command(visible_aliases = &[\"--to-hex\", \"th\", \"2h\"])]\n ToHex(ToBaseArgs),\n\n /// Converts a number of one base to decimal\n #[command(visible_aliases = &[\"--to-dec\", \"td\", \"2d\"])]\n ToDec(ToBaseArgs),\n\n /// Converts a number of one base to another\n #[command(\n visible_aliases = &[\"--to-base\",\n \"--to-radix\",\n \"to-radix\",\n \"tr\",\n \"2r\"]\n )]\n ToBase {\n #[command(flatten)]\n base: ToBaseArgs,\n\n /// The output base.\n #[arg(value_name = \"BASE\")]\n base_out: Option,\n },\n /// Create an access list for a transaction.\n #[command(visible_aliases = &[\"ac\", \"acl\"])]\n AccessList(AccessListArgs),\n /// Get logs by signature or topic.\n #[command(visible_alias = \"l\")]\n Logs(LogsArgs),\n /// Get information about a block.\n #[command(visible_alias = \"bl\")]\n Block {\n /// The block height to query at.\n ///\n /// Can also be the tags earliest, finalized, safe, latest, or pending.\n block: Option,\n\n /// If specified, only get the given field of the block.\n #[arg(short, long = \"field\", aliases = [\"fields\"], num_args = 0.., action = ArgAction::Append, value_delimiter = ',')]\n fields: Vec,\n\n /// Print the raw RLP encoded block header.\n #[arg(long, conflicts_with = \"fields\")]\n raw: bool,\n\n #[arg(long, env = \"CAST_FULL_BLOCK\")]\n full: bool,\n\n #[command(flatten)]\n rpc: RpcOpts,\n\n /// Specify the Network for correct encoding.\n #[arg(long, short, num_args = 1, value_name = \"NETWORK\")]\n network: Option,\n },\n\n /// Get the latest block number.\n #[command(visible_alias = \"bn\")]\n BlockNumber {\n /// The hash or tag to query. If not specified, the latest number is returned.\n block: Option,\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Perform a call on an account without publishing a transaction.\n #[command(visible_alias = \"c\")]\n Call(CallArgs),\n\n /// ABI-encode a function with arguments.\n #[command(name = \"calldata\", visible_alias = \"cd\")]\n CalldataEncode {\n /// The function signature in the format `()()`\n sig: String,\n\n /// The arguments to encode.\n #[arg(allow_hyphen_values = true)]\n args: Vec,\n\n // Path to file containing arguments to encode.\n #[arg(long, value_name = \"PATH\")]\n file: Option,\n },\n\n /// Get the symbolic name of the current chain.\n Chain {\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Get the Ethereum chain ID.\n #[command(visible_aliases = &[\"ci\", \"cid\"])]\n ChainId {\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Get the current client version.\n #[command(visible_alias = \"cl\")]\n Client {\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Compute the contract address from a given nonce and deployer address.\n #[command(visible_alias = \"ca\")]\n ComputeAddress {\n /// The deployer address.\n address: Option
,\n\n /// The nonce of the deployer address.\n #[arg(\n long,\n conflicts_with = \"salt\",\n conflicts_with = \"init_code\",\n conflicts_with = \"init_code_hash\"\n )]\n nonce: Option,\n\n /// The salt for CREATE2 address computation.\n #[arg(long, conflicts_with = \"nonce\")]\n salt: Option,\n\n /// The init code for CREATE2 address computation.\n #[arg(\n long,\n requires = \"salt\",\n conflicts_with = \"init_code_hash\",\n conflicts_with = \"nonce\"\n )]\n init_code: Option,\n\n /// The init code hash for CREATE2 address computation.\n #[arg(long, requires = \"salt\", conflicts_with = \"init_code\", conflicts_with = \"nonce\")]\n init_code_hash: Option,\n\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Disassembles a hex-encoded bytecode into a human-readable representation.\n #[command(visible_alias = \"da\")]\n Disassemble {\n /// The hex-encoded bytecode.\n bytecode: Option,\n },\n\n /// Build and sign a transaction.\n #[command(name = \"mktx\", visible_alias = \"m\")]\n MakeTx(MakeTxArgs),\n\n /// Calculate the ENS namehash of a name.\n #[command(visible_aliases = &[\"na\", \"nh\"])]\n Namehash { name: Option },\n\n /// Get information about a transaction.\n #[command(visible_alias = \"t\")]\n Tx {\n /// The transaction hash.\n tx_hash: Option,\n\n /// The sender of the transaction.\n #[arg(long, value_parser = NameOrAddress::from_str)]\n from: Option,\n\n /// Nonce of the transaction.\n #[arg(long)]\n nonce: Option,\n\n /// If specified, only get the given field of the transaction. If \"raw\", the RLP encoded\n /// transaction will be printed.\n field: Option,\n\n /// Print the raw RLP encoded transaction.\n #[arg(long, conflicts_with = \"field\")]\n raw: bool,\n\n #[command(flatten)]\n rpc: RpcOpts,\n\n /// If specified, the transaction will be converted to a TransactionRequest JSON format.\n #[arg(long)]\n to_request: bool,\n\n /// Specify the Network for correct encoding.\n #[arg(long, short, num_args = 1, value_name = \"NETWORK\")]\n network: Option,\n },\n\n /// Get the transaction receipt for a transaction.\n #[command(visible_alias = \"re\")]\n Receipt {\n /// The transaction hash.\n tx_hash: String,\n\n /// If specified, only get the given field of the transaction.\n field: Option,\n\n /// The number of confirmations until the receipt is fetched\n #[arg(long, default_value = \"1\")]\n confirmations: u64,\n\n /// Exit immediately if the transaction was not found.\n #[arg(id = \"async\", long = \"async\", env = \"CAST_ASYNC\", alias = \"cast-async\")]\n cast_async: bool,\n\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Sign and publish a transaction.\n #[command(name = \"send\", visible_alias = \"s\")]\n SendTx(SendTxArgs),\n\n /// Publish a raw transaction to the network.\n #[command(name = \"publish\", visible_alias = \"p\")]\n PublishTx {\n /// The raw transaction\n raw_tx: String,\n\n /// Only print the transaction hash and exit immediately.\n #[arg(id = \"async\", long = \"async\", env = \"CAST_ASYNC\", alias = \"cast-async\")]\n cast_async: bool,\n\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Estimate the gas cost of a transaction.\n #[command(visible_alias = \"e\")]\n Estimate(EstimateArgs),\n\n /// Decode ABI-encoded input data.\n ///\n /// Similar to `abi-decode --input`, but function selector MUST be prefixed in `calldata`\n /// string\n #[command(visible_aliases = &[\"calldata-decode\", \"--calldata-decode\", \"cdd\"])]\n DecodeCalldata {\n /// The function signature in the format `()()`.\n sig: String,\n\n /// The ABI-encoded calldata.\n #[arg(required_unless_present = \"file\", index = 2)]\n calldata: Option,\n\n /// Load ABI-encoded calldata from a file instead.\n #[arg(long = \"file\", short = 'f', conflicts_with = \"calldata\")]\n file: Option,\n },\n\n /// Decode ABI-encoded string.\n ///\n /// Similar to `calldata-decode --input`, but the function argument is a `string`\n #[command(visible_aliases = &[\"string-decode\", \"--string-decode\", \"sd\"])]\n DecodeString {\n /// The ABI-encoded string.\n data: String,\n },\n\n /// Decode event data.\n #[command(visible_aliases = &[\"event-decode\", \"--event-decode\", \"ed\"])]\n DecodeEvent {\n /// The event signature. If none provided then tries to decode from local cache or .\n #[arg(long, visible_alias = \"event-sig\")]\n sig: Option,\n /// The event data to decode.\n data: String,\n },\n\n /// Decode custom error data.\n #[command(visible_aliases = &[\"error-decode\", \"--error-decode\", \"erd\"])]\n DecodeError {\n /// The error signature. If none provided then tries to decode from local cache or .\n #[arg(long, visible_alias = \"error-sig\")]\n sig: Option,\n /// The error data to decode.\n data: String,\n },\n\n /// Decode ABI-encoded input or output data.\n ///\n /// Defaults to decoding output data. To decode input data pass --input.\n ///\n /// When passing `--input`, function selector must NOT be prefixed in `calldata` string\n #[command(name = \"decode-abi\", visible_aliases = &[\"abi-decode\", \"--abi-decode\", \"ad\"])]\n DecodeAbi {\n /// The function signature in the format `()()`.\n sig: String,\n\n /// The ABI-encoded calldata.\n calldata: String,\n\n /// Whether to decode the input or output data.\n #[arg(long, short, help_heading = \"Decode input data instead of output data\")]\n input: bool,\n },\n\n /// ABI encode the given function argument, excluding the selector.\n #[command(visible_alias = \"ae\")]\n AbiEncode {\n /// The function signature.\n sig: String,\n\n /// Whether to use packed encoding.\n #[arg(long)]\n packed: bool,\n\n /// The arguments of the function.\n #[arg(allow_hyphen_values = true)]\n args: Vec,\n },\n\n /// ABI encode an event and its arguments to generate topics and data.\n #[command(visible_alias = \"aee\")]\n AbiEncodeEvent {\n /// The event signature.\n sig: String,\n\n /// The arguments of the event.\n #[arg(allow_hyphen_values = true)]\n args: Vec,\n },\n\n /// Compute the storage slot for an entry in a mapping.\n #[command(visible_alias = \"in\")]\n Index {\n /// The mapping key type.\n key_type: String,\n\n /// The mapping key.\n key: String,\n\n /// The storage slot of the mapping.\n slot_number: String,\n },\n\n /// Compute storage slots as specified by `ERC-7201: Namespaced Storage Layout`.\n #[command(name = \"index-erc7201\", alias = \"index-erc-7201\", visible_aliases = &[\"index7201\", \"in7201\"])]\n IndexErc7201 {\n /// The arbitrary identifier.\n id: Option,\n /// The formula ID. Currently the only supported formula is `erc7201`.\n #[arg(long, default_value = \"erc7201\")]\n formula_id: String,\n },\n\n /// Fetch the EIP-1967 implementation for a contract\n /// Can read from the implementation slot or the beacon slot.\n #[command(visible_alias = \"impl\")]\n Implementation {\n /// The block height to query at.\n ///\n /// Can also be the tags earliest, finalized, safe, latest, or pending.\n #[arg(long, short = 'B')]\n block: Option,\n\n /// Fetch the implementation from the beacon slot.\n ///\n /// If not specified, the implementation slot is used.\n #[arg(long)]\n beacon: bool,\n\n /// The address for which the implementation will be fetched.\n #[arg(value_parser = NameOrAddress::from_str)]\n who: NameOrAddress,\n\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Fetch the EIP-1967 admin account\n #[command(visible_alias = \"adm\")]\n Admin {\n /// The block height to query at.\n ///\n /// Can also be the tags earliest, finalized, safe, latest, or pending.\n #[arg(long, short = 'B')]\n block: Option,\n\n /// The address from which the admin account will be fetched.\n #[arg(value_parser = NameOrAddress::from_str)]\n who: NameOrAddress,\n\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Get the function signatures for the given selector from .\n #[command(name = \"4byte\", visible_aliases = &[\"4\", \"4b\"])]\n FourByte {\n /// The function selector.\n selector: Option,\n },\n\n /// Decode ABI-encoded calldata using .\n #[command(name = \"4byte-calldata\", aliases = &[\"4byte-decode\", \"4d\", \"4bd\"], visible_aliases = &[\"4c\", \"4bc\"])]\n FourByteCalldata {\n /// The ABI-encoded calldata.\n calldata: Option,\n },\n\n /// Get the event signature for a given topic 0 from .\n #[command(name = \"4byte-event\", visible_aliases = &[\"4e\", \"4be\", \"topic0-event\", \"t0e\"])]\n FourByteEvent {\n /// Topic 0\n #[arg(value_name = \"TOPIC_0\")]\n topic: Option,\n },\n\n /// Upload the given signatures to .\n ///\n /// Example inputs:\n /// - \"transfer(address,uint256)\"\n /// - \"function transfer(address,uint256)\"\n /// - \"function transfer(address,uint256)\" \"event Transfer(address,address,uint256)\"\n /// - \"./out/Contract.sol/Contract.json\"\n #[command(visible_aliases = &[\"ups\"])]\n UploadSignature {\n /// The signatures to upload.\n ///\n /// Prefix with 'function', 'event', or 'error'. Defaults to function if no prefix given.\n /// Can also take paths to contract artifact JSON.\n signatures: Vec,\n },\n\n /// Pretty print calldata.\n ///\n /// Tries to decode the calldata using unless --offline is passed.\n #[command(visible_alias = \"pc\")]\n PrettyCalldata {\n /// The calldata.\n calldata: Option,\n\n /// Skip the lookup.\n #[arg(long, short)]\n offline: bool,\n },\n\n /// Get the timestamp of a block.\n #[command(visible_alias = \"a\")]\n Age {\n /// The block height to query at.\n ///\n /// Can also be the tags earliest, finalized, safe, latest, or pending.\n block: Option,\n\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Get the balance of an account in wei.\n #[command(visible_alias = \"b\")]\n Balance {\n /// The block height to query at.\n ///\n /// Can also be the tags earliest, finalized, safe, latest, or pending.\n #[arg(long, short = 'B')]\n block: Option,\n\n /// The account to query.\n #[arg(value_parser = NameOrAddress::from_str)]\n who: NameOrAddress,\n\n /// Format the balance in ether.\n #[arg(long, short)]\n ether: bool,\n\n #[command(flatten)]\n rpc: RpcOpts,\n\n /// erc20 address to query, with the method `balanceOf(address) return (uint256)`, alias\n /// with '--erc721'\n #[arg(long, alias = \"erc721\")]\n erc20: Option
,\n },\n\n /// Get the basefee of a block.\n #[command(visible_aliases = &[\"ba\", \"fee\", \"basefee\"])]\n BaseFee {\n /// The block height to query at.\n ///\n /// Can also be the tags earliest, finalized, safe, latest, or pending.\n block: Option,\n\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Get the runtime bytecode of a contract.\n #[command(visible_alias = \"co\")]\n Code {\n /// The block height to query at.\n ///\n /// Can also be the tags earliest, finalized, safe, latest, or pending.\n #[arg(long, short = 'B')]\n block: Option,\n\n /// The contract address.\n #[arg(value_parser = NameOrAddress::from_str)]\n who: NameOrAddress,\n\n /// Disassemble bytecodes.\n #[arg(long, short)]\n disassemble: bool,\n\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Get the runtime bytecode size of a contract.\n #[command(visible_alias = \"cs\")]\n Codesize {\n /// The block height to query at.\n ///\n /// Can also be the tags earliest, finalized, safe, latest, or pending.\n #[arg(long, short = 'B')]\n block: Option,\n\n /// The contract address.\n #[arg(value_parser = NameOrAddress::from_str)]\n who: NameOrAddress,\n\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Get the current gas price.\n #[command(visible_alias = \"g\")]\n GasPrice {\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Generate event signatures from event string.\n #[command(visible_alias = \"se\")]\n SigEvent {\n /// The event string.\n event_string: Option,\n },\n\n /// Hash arbitrary data using Keccak-256.\n #[command(visible_aliases = &[\"k\", \"keccak256\"])]\n Keccak {\n /// The data to hash.\n data: Option,\n },\n\n /// Hash a message according to EIP-191.\n #[command(visible_aliases = &[\"--hash-message\", \"hm\"])]\n HashMessage {\n /// The message to hash.\n message: Option,\n },\n\n /// Perform an ENS lookup.\n #[command(visible_alias = \"rn\")]\n ResolveName {\n /// The name to lookup.\n who: Option,\n\n /// Perform a reverse lookup to verify that the name is correct.\n #[arg(long)]\n verify: bool,\n\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Perform an ENS reverse lookup.\n #[command(visible_alias = \"la\")]\n LookupAddress {\n /// The account to perform the lookup for.\n who: Option
,\n\n /// Perform a normal lookup to verify that the address is correct.\n #[arg(long)]\n verify: bool,\n\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Get the raw value of a contract's storage slot.\n #[command(visible_alias = \"st\")]\n Storage(StorageArgs),\n\n /// Generate a storage proof for a given storage slot.\n #[command(visible_alias = \"pr\")]\n Proof {\n /// The contract address.\n #[arg(value_parser = NameOrAddress::from_str)]\n address: NameOrAddress,\n\n /// The storage slot numbers (hex or decimal).\n #[arg(value_parser = parse_slot)]\n slots: Vec,\n\n /// The block height to query at.\n ///\n /// Can also be the tags earliest, finalized, safe, latest, or pending.\n #[arg(long, short = 'B')]\n block: Option,\n\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Get the nonce for an account.\n #[command(visible_alias = \"n\")]\n Nonce {\n /// The block height to query at.\n ///\n /// Can also be the tags earliest, finalized, safe, latest, or pending.\n #[arg(long, short = 'B')]\n block: Option,\n\n /// The address to get the nonce for.\n #[arg(value_parser = NameOrAddress::from_str)]\n who: NameOrAddress,\n\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Get the codehash for an account.\n #[command()]\n Codehash {\n /// The block height to query at.\n ///\n /// Can also be the tags earliest, finalized, safe, latest, or pending.\n #[arg(long, short = 'B')]\n block: Option,\n\n /// The address to get the codehash for.\n #[arg(value_parser = NameOrAddress::from_str)]\n who: NameOrAddress,\n\n /// The storage slot numbers (hex or decimal).\n #[arg(value_parser = parse_slot)]\n slots: Vec,\n\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Get the storage root for an account.\n #[command(visible_alias = \"sr\")]\n StorageRoot {\n /// The block height to query at.\n ///\n /// Can also be the tags earliest, finalized, safe, latest, or pending.\n #[arg(long, short = 'B')]\n block: Option,\n\n /// The address to get the storage root for.\n #[arg(value_parser = NameOrAddress::from_str)]\n who: NameOrAddress,\n\n /// The storage slot numbers (hex or decimal).\n #[arg(value_parser = parse_slot)]\n slots: Vec,\n\n #[command(flatten)]\n rpc: RpcOpts,\n },\n\n /// Get the source code of a contract from a block explorer.\n #[command(visible_aliases = &[\"et\", \"src\"])]\n Source {\n /// The contract's address.\n address: String,\n\n /// Whether to flatten the source code.\n #[arg(long, short)]\n flatten: bool,\n\n /// The output directory/file to expand source tree into.\n #[arg(short, value_hint = ValueHint::DirPath, alias = \"path\")]\n directory: Option,\n\n #[command(flatten)]\n etherscan: EtherscanOpts,\n\n /// Alternative explorer API URL to use that adheres to the Etherscan API. If not provided,\n /// defaults to Etherscan.\n #[arg(long, env = \"EXPLORER_API_URL\")]\n explorer_api_url: Option,\n\n /// Alternative explorer browser URL.\n #[arg(long, env = \"EXPLORER_URL\")]\n explorer_url: Option,\n },\n\n /// Wallet management utilities.\n #[command(visible_alias = \"w\")]\n Wallet {\n #[command(subcommand)]\n command: WalletSubcommands,\n },\n\n /// Download a contract creation code from Etherscan and RPC.\n #[command(visible_alias = \"cc\")]\n CreationCode(CreationCodeArgs),\n\n /// Generate an artifact file, that can be used to deploy a contract locally.\n #[command(visible_alias = \"ar\")]\n Artifact(ArtifactArgs),\n\n /// Display constructor arguments used for the contract initialization.\n #[command(visible_alias = \"cra\")]\n ConstructorArgs(ConstructorArgsArgs),\n\n /// Generate a Solidity interface from a given ABI.\n ///\n /// Currently does not support ABI encoder v2.\n #[command(visible_alias = \"i\")]\n Interface(InterfaceArgs),\n\n /// Generate a rust binding from a given ABI.\n #[command(visible_alias = \"bi\")]\n Bind(BindArgs),\n\n /// Convert Beacon payload to execution payload.\n #[command(visible_alias = \"b2e\")]\n B2EPayload(B2EPayloadArgs),\n\n /// Get the selector for a function.\n #[command(visible_alias = \"si\")]\n Sig {\n /// The function signature, e.g. transfer(address,uint256).\n sig: Option,\n\n /// Optimize signature to contain provided amount of leading zeroes in selector.\n optimize: Option,\n },\n\n /// Generate a deterministic contract address using CREATE2.\n #[command(visible_alias = \"c2\")]\n Create2(Create2Args),\n\n /// Get the block number closest to the provided timestamp.\n #[command(visible_alias = \"f\")]\n FindBlock(FindBlockArgs),\n\n /// Generate shell completions script.\n #[command(visible_alias = \"com\")]\n Completions {\n #[arg(value_enum)]\n shell: foundry_cli::clap::Shell,\n },\n\n /// Runs a published transaction in a local environment and prints the trace.\n #[command(visible_alias = \"r\")]\n Run(RunArgs),\n\n /// Perform a raw JSON-RPC request.\n #[command(visible_alias = \"rp\")]\n Rpc(RpcArgs),\n\n /// Formats a string into bytes32 encoding.\n #[command(name = \"format-bytes32-string\", visible_aliases = &[\"--format-bytes32-string\"])]\n FormatBytes32String {\n /// The string to format.\n string: Option,\n },\n\n /// Parses a string from bytes32 encoding.\n #[command(name = \"parse-bytes32-string\", visible_aliases = &[\"--parse-bytes32-string\"])]\n ParseBytes32String {\n /// The string to parse.\n bytes: Option,\n },\n #[command(name = \"parse-bytes32-address\", visible_aliases = &[\"--parse-bytes32-address\"])]\n #[command(about = \"Parses a checksummed address from bytes32 encoding.\")]\n ParseBytes32Address {\n #[arg(value_name = \"BYTES\")]\n bytes: Option,\n },\n\n /// Decodes a raw signed EIP 2718 typed transaction\n #[command(visible_aliases = &[\"dt\", \"decode-tx\"])]\n DecodeTransaction { tx: Option },\n\n /// Recovery an EIP-7702 authority from a Authorization JSON string.\n #[command(visible_aliases = &[\"decode-auth\"])]\n RecoverAuthority { auth: String },\n\n /// Extracts function selectors and arguments from bytecode\n #[command(visible_alias = \"sel\")]\n Selectors {\n /// The hex-encoded bytecode.\n bytecode: Option,\n\n /// Resolve the function signatures for the extracted selectors using \n #[arg(long, short)]\n resolve: bool,\n },\n\n /// Inspect the TxPool of a node.\n #[command(visible_alias = \"tp\")]\n TxPool {\n #[command(subcommand)]\n command: TxPoolSubcommands,\n },\n /// Estimates the data availability size of a given opstack block.\n #[command(name = \"da-estimate\")]\n DAEstimate(DAEstimateArgs),\n\n /// ERC20 token operations.\n #[command(visible_alias = \"erc20\")]\n Erc20Token {\n #[command(subcommand)]\n command: Erc20Subcommand,\n },\n #[command(name = \"trace\")]\n Trace(TraceArgs),\n}\n\n/// CLI arguments for `cast --to-base`.\n#[derive(Debug, Parser)]\npub struct ToBaseArgs {\n /// The value to convert.\n #[arg(allow_hyphen_values = true)]\n pub value: Option,\n\n /// The input base.\n #[arg(long, short = 'i')]\n pub base_in: Option,\n}\n\npub fn parse_slot(s: &str) -> Result {\n let slot = U256::from_str(s).map_err(|e| eyre::eyre!(\"Could not parse slot number: {e}\"))?;\n Ok(B256::from(slot))\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n use crate::SimpleCast;\n use alloy_rpc_types::{BlockNumberOrTag, RpcBlockHash};\n use clap::CommandFactory;\n\n #[test]\n fn verify_cli() {\n Cast::command().debug_assert();\n }\n\n #[test]\n fn parse_proof_slot() {\n let args: Cast = Cast::parse_from([\n \"foundry-cli\",\n \"proof\",\n \"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2\",\n \"0\",\n \"1\",\n \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"0x1\",\n \"0x01\",\n ]);\n match args.cmd {\n CastSubcommand::Proof { slots, .. } => {\n assert_eq!(\n slots,\n vec![\n B256::ZERO,\n U256::from(1).into(),\n B256::ZERO,\n U256::from(1).into(),\n U256::from(1).into()\n ]\n );\n }\n _ => unreachable!(),\n };\n }\n\n #[test]\n fn parse_call_data() {\n let args: Cast = Cast::parse_from([\n \"foundry-cli\",\n \"calldata\",\n \"f()\",\n \"5c9d55b78febcc2061715ba4f57ecf8ea2711f2c\",\n \"2\",\n ]);\n match args.cmd {\n CastSubcommand::CalldataEncode { args, .. } => {\n assert_eq!(\n args,\n vec![\"5c9d55b78febcc2061715ba4f57ecf8ea2711f2c\".to_string(), \"2\".to_string()]\n )\n }\n _ => unreachable!(),\n };\n }\n\n #[test]\n fn parse_call_data_with_file() {\n let args: Cast = Cast::parse_from([\"foundry-cli\", \"calldata\", \"f()\", \"--file\", \"test.txt\"]);\n match args.cmd {\n CastSubcommand::CalldataEncode { sig, file, args } => {\n assert_eq!(sig, \"f()\".to_string());\n assert_eq!(file, Some(PathBuf::from(\"test.txt\")));\n assert!(args.is_empty());\n }\n _ => unreachable!(),\n };\n }\n\n // \n #[test]\n fn parse_signature() {\n let args: Cast = Cast::parse_from([\n \"foundry-cli\",\n \"sig\",\n \"__$_$__$$$$$__$$_$$$_$$__$$___$$(address,address,uint256)\",\n ]);\n match args.cmd {\n CastSubcommand::Sig { sig, .. } => {\n let sig = sig.unwrap();\n assert_eq!(\n sig,\n \"__$_$__$$$$$__$$_$$$_$$__$$___$$(address,address,uint256)\".to_string()\n );\n\n let selector = SimpleCast::get_selector(&sig, 0).unwrap();\n assert_eq!(selector.0, \"0x23b872dd\".to_string());\n }\n _ => unreachable!(),\n };\n }\n\n #[test]\n fn parse_block_ids() {\n struct TestCase {\n input: String,\n expect: BlockId,\n }\n\n let test_cases = [\n TestCase {\n input: \"0\".to_string(),\n expect: BlockId::Number(BlockNumberOrTag::Number(0u64)),\n },\n TestCase {\n input: \"0x56462c47c03df160f66819f0a79ea07def1569f8aac0fe91bb3a081159b61b4a\"\n .to_string(),\n expect: BlockId::Hash(RpcBlockHash::from_hash(\n \"0x56462c47c03df160f66819f0a79ea07def1569f8aac0fe91bb3a081159b61b4a\"\n .parse()\n .unwrap(),\n None,\n )),\n },\n TestCase {\n input: \"latest\".to_string(),\n expect: BlockId::Number(BlockNumberOrTag::Latest),\n },\n TestCase {\n input: \"earliest\".to_string(),\n expect: BlockId::Number(BlockNumberOrTag::Earliest),\n },\n TestCase {\n input: \"pending\".to_string(),\n expect: BlockId::Number(BlockNumberOrTag::Pending),\n },\n TestCase { input: \"safe\".to_string(), expect: BlockId::Number(BlockNumberOrTag::Safe) },\n TestCase {\n input: \"finalized\".to_string(),\n expect: BlockId::Number(BlockNumberOrTag::Finalized),\n },\n ];\n\n for test in test_cases {\n let result: BlockId = test.input.parse().unwrap();\n assert_eq!(result, test.expect);\n }\n }\n}\n" }, { "path": "crates/cast/src/rlp_converter.rs", "content": "use alloy_primitives::{U256, hex};\nuse alloy_rlp::{Buf, Decodable, Encodable, Header};\nuse eyre::Context;\nuse serde_json::Value;\nuse std::fmt;\n\n/// Arbitrary nested data.\n///\n/// - `Item::Array(vec![])` is equivalent to `[]`.\n/// - `Item::Array(vec![Item::Data(vec![])])` is equivalent to `[\"\"]` or `[null]`.\n#[derive(Clone, Debug, PartialEq, Eq)]\npub enum Item {\n Data(Vec),\n Array(Vec),\n}\n\nimpl Encodable for Item {\n fn encode(&self, out: &mut dyn alloy_rlp::BufMut) {\n match self {\n Self::Array(arr) => arr.encode(out),\n Self::Data(data) => <[u8]>::encode(data, out),\n }\n }\n}\n\nimpl Decodable for Item {\n fn decode(buf: &mut &[u8]) -> alloy_rlp::Result {\n let h = Header::decode(buf)?;\n if buf.len() < h.payload_length {\n return Err(alloy_rlp::Error::InputTooShort);\n }\n let mut d = &buf[..h.payload_length];\n let r = if h.list {\n let view = &mut d;\n let mut v = Vec::new();\n while !view.is_empty() {\n v.push(Self::decode(view)?);\n }\n Ok(Self::Array(v))\n } else {\n Ok(Self::Data(d.to_vec()))\n };\n buf.advance(h.payload_length);\n r\n }\n}\n\nimpl Item {\n pub(crate) fn value_to_item(value: &Value) -> eyre::Result {\n match value {\n Value::Null => Ok(Self::Data(vec![])),\n Value::Bool(_) => {\n eyre::bail!(\"RLP input can not contain booleans\")\n }\n Value::Number(n) => {\n Ok(Self::Data(n.to_string().parse::()?.to_be_bytes_trimmed_vec()))\n }\n Value::String(s) => Ok(Self::Data(hex::decode(s).wrap_err(\"Could not decode hex\")?)),\n Value::Array(values) => values.iter().map(Self::value_to_item).collect(),\n Value::Object(_) => {\n eyre::bail!(\"RLP input can not contain objects\")\n }\n }\n }\n}\n\nimpl FromIterator for Item {\n fn from_iter>(iter: T) -> Self {\n Self::Array(Vec::from_iter(iter))\n }\n}\n\n// Display as hex values\nimpl fmt::Display for Item {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> std::fmt::Result {\n match self {\n Self::Data(dat) => {\n write!(f, \"\\\"0x{}\\\"\", hex::encode(dat))?;\n }\n Self::Array(items) => {\n f.write_str(\"[\")?;\n for (i, item) in items.iter().enumerate() {\n if i > 0 {\n f.write_str(\",\")?;\n }\n fmt::Display::fmt(item, f)?;\n }\n f.write_str(\"]\")?;\n }\n };\n Ok(())\n }\n}\n\n#[cfg(test)]\nmod test {\n use crate::rlp_converter::Item;\n use alloy_primitives::hex;\n use alloy_rlp::{Bytes, Decodable};\n use serde_json::Result as JsonResult;\n\n // https://en.wikipedia.org/wiki/Set-theoretic_definition_of_natural_numbers\n fn array_von_neuman() -> Item {\n Item::Array(vec![\n Item::Array(vec![]),\n Item::Array(vec![Item::Array(vec![])]),\n Item::Array(vec![Item::Array(vec![]), Item::Array(vec![Item::Array(vec![])])]),\n ])\n }\n\n #[test]\n #[expect(clippy::disallowed_macros)]\n fn encode_decode_test() -> alloy_rlp::Result<()> {\n let parameters = vec![\n (1, b\"\\xc0\".to_vec(), Item::Array(vec![])),\n (2, b\"\\xc1\\x80\".to_vec(), Item::Array(vec![Item::Data(vec![])])),\n (3, b\"\\xc4\\x83dog\".to_vec(), Item::Array(vec![Item::Data(vec![0x64, 0x6f, 0x67])])),\n (\n 4,\n b\"\\xc5\\xc4\\x83dog\".to_vec(),\n Item::Array(vec![Item::Array(vec![Item::Data(vec![0x64, 0x6f, 0x67])])]),\n ),\n (\n 5,\n b\"\\xc8\\x83dog\\x83cat\".to_vec(),\n Item::Array(vec![\n Item::Data(vec![0x64, 0x6f, 0x67]),\n Item::Data(vec![0x63, 0x61, 0x74]),\n ]),\n ),\n (6, b\"\\xc7\\xc0\\xc1\\xc0\\xc3\\xc0\\xc1\\xc0\".to_vec(), array_von_neuman()),\n (\n 7,\n b\"\\xcd\\x83\\x6c\\x6f\\x6c\\xc3\\xc2\\xc1\\xc0\\xc4\\x83\\x6f\\x6c\\x6f\".to_vec(),\n Item::Array(vec![\n Item::Data(vec![b'\\x6c', b'\\x6f', b'\\x6c']),\n Item::Array(vec![Item::Array(vec![Item::Array(vec![Item::Array(vec![])])])]),\n Item::Array(vec![Item::Data(vec![b'\\x6f', b'\\x6c', b'\\x6f'])]),\n ]),\n ),\n ];\n for params in parameters {\n let encoded = alloy_rlp::encode(¶ms.2);\n assert_eq!(Item::decode(&mut &encoded[..])?, params.2);\n let decoded = Item::decode(&mut ¶ms.1[..])?;\n assert_eq!(alloy_rlp::encode(&decoded), params.1);\n println!(\"case {} validated\", params.0)\n }\n\n Ok(())\n }\n\n #[test]\n #[expect(clippy::disallowed_macros)]\n fn deserialize_from_str_test_hex() -> JsonResult<()> {\n let parameters = vec![\n (1, \"[\\\"\\\"]\", Item::Array(vec![Item::Data(vec![])])),\n (2, \"[\\\"0x646f67\\\"]\", Item::Array(vec![Item::Data(vec![0x64, 0x6f, 0x67])])),\n (\n 3,\n \"[[\\\"646f67\\\"]]\",\n Item::Array(vec![Item::Array(vec![Item::Data(vec![0x64, 0x6f, 0x67])])]),\n ),\n (\n 4,\n \"[\\\"646f67\\\",\\\"0x636174\\\"]\",\n Item::Array(vec![\n Item::Data(vec![0x64, 0x6f, 0x67]),\n Item::Data(vec![0x63, 0x61, 0x74]),\n ]),\n ),\n (6, \"[[],[[]],[[],[[]]]]\", array_von_neuman()),\n ];\n for params in parameters {\n let val = serde_json::from_str(params.1)?;\n let item = Item::value_to_item(&val).unwrap();\n assert_eq!(item, params.2);\n println!(\"case {} validated\", params.0);\n }\n\n Ok(())\n }\n\n #[test]\n fn rlp_data() {\n // \n let hex_val_rlp = hex!(\"820002\");\n let item = Item::decode(&mut &hex_val_rlp[..]).unwrap();\n\n let data = hex!(\"0002\");\n let encoded = alloy_rlp::encode(&data[..]);\n let decoded: Bytes = alloy_rlp::decode_exact(&encoded[..]).unwrap();\n assert_eq!(Item::Data(decoded.to_vec()), item);\n\n let hex_val_rlp = hex!(\"00\");\n let item = Item::decode(&mut &hex_val_rlp[..]).unwrap();\n\n let data = hex!(\"00\");\n let encoded = alloy_rlp::encode(&data[..]);\n let decoded: Bytes = alloy_rlp::decode_exact(&encoded[..]).unwrap();\n assert_eq!(Item::Data(decoded.to_vec()), item);\n }\n}\n" }, { "path": "crates/cast/src/tx.rs", "content": "use crate::traces::identifier::SignaturesIdentifier;\nuse alloy_consensus::{SidecarBuilder, SimpleCoder};\nuse alloy_dyn_abi::ErrorExt;\nuse alloy_ens::NameOrAddress;\nuse alloy_json_abi::Function;\nuse alloy_network::{Network, TransactionBuilder};\nuse alloy_primitives::{Address, B256, Bytes, TxHash, TxKind, U256, hex};\nuse alloy_provider::{PendingTransactionBuilder, Provider};\nuse alloy_rpc_types::{AccessList, Authorization, TransactionInputKind};\nuse alloy_signer::Signer;\nuse alloy_transport::TransportError;\nuse clap::Args;\nuse eyre::{Result, WrapErr};\nuse foundry_cli::{\n opts::{CliAuthorizationList, EthereumOpts, TransactionOpts},\n utils::{self, parse_function_args},\n};\nuse foundry_common::{\n TransactionReceiptWithRevertReason, fmt::*, get_pretty_receipt_w_reason_attr, shell,\n};\nuse foundry_config::{Chain, Config};\nuse foundry_primitives::FoundryTransactionBuilder;\nuse foundry_wallets::{BrowserWalletOpts, WalletOpts, WalletSigner};\nuse itertools::Itertools;\nuse serde_json::value::RawValue;\nuse std::{fmt::Write, marker::PhantomData, str::FromStr, time::Duration};\n\n#[derive(Debug, Clone, Args)]\npub struct SendTxOpts {\n /// Only print the transaction hash and exit immediately.\n #[arg(id = \"async\", long = \"async\", alias = \"cast-async\", env = \"CAST_ASYNC\")]\n pub cast_async: bool,\n\n /// Wait for transaction receipt synchronously instead of polling.\n /// Note: uses `eth_sendTransactionSync` which may not be supported by all clients.\n #[arg(long, conflicts_with = \"async\")]\n pub sync: bool,\n\n /// The number of confirmations until the receipt is fetched.\n #[arg(long, default_value = \"1\")]\n pub confirmations: u64,\n\n /// Timeout for sending the transaction.\n #[arg(long, env = \"ETH_TIMEOUT\")]\n pub timeout: Option,\n\n /// Polling interval for transaction receipts (in seconds).\n #[arg(long, alias = \"poll-interval\", env = \"ETH_POLL_INTERVAL\")]\n pub poll_interval: Option,\n\n /// Ethereum options\n #[command(flatten)]\n pub eth: EthereumOpts,\n\n /// Browser wallet options\n #[command(flatten)]\n pub browser: BrowserWalletOpts,\n}\n\n/// Different sender kinds used by [`CastTxBuilder`].\npub enum SenderKind<'a> {\n /// An address without signer. Used for read-only calls and transactions sent through unlocked\n /// accounts.\n Address(Address),\n /// A reference to a signer.\n Signer(&'a WalletSigner),\n /// An owned signer.\n OwnedSigner(Box),\n}\n\nimpl SenderKind<'_> {\n /// Resolves the name to an Ethereum Address.\n pub fn address(&self) -> Address {\n match self {\n Self::Address(addr) => *addr,\n Self::Signer(signer) => signer.address(),\n Self::OwnedSigner(signer) => signer.address(),\n }\n }\n\n /// Resolves the sender from the wallet options.\n ///\n /// This function prefers the `from` field and may return a different address from the\n /// configured signer\n /// If from is specified, returns it\n /// If from is not specified, but there is a signer configured, returns the signer's address\n /// If from is not specified and there is no signer configured, returns zero address\n pub async fn from_wallet_opts(opts: WalletOpts) -> Result {\n if let Some(from) = opts.from {\n Ok(from.into())\n } else if let Ok(signer) = opts.signer().await {\n Ok(Self::OwnedSigner(Box::new(signer)))\n } else {\n Ok(Address::ZERO.into())\n }\n }\n\n /// Returns the signer if available.\n pub fn as_signer(&self) -> Option<&WalletSigner> {\n match self {\n Self::Signer(signer) => Some(signer),\n Self::OwnedSigner(signer) => Some(signer.as_ref()),\n _ => None,\n }\n }\n}\n\nimpl From
for SenderKind<'_> {\n fn from(addr: Address) -> Self {\n Self::Address(addr)\n }\n}\n\nimpl<'a> From<&'a WalletSigner> for SenderKind<'a> {\n fn from(signer: &'a WalletSigner) -> Self {\n Self::Signer(signer)\n }\n}\n\nimpl From for SenderKind<'_> {\n fn from(signer: WalletSigner) -> Self {\n Self::OwnedSigner(Box::new(signer))\n }\n}\n\n/// Prevents a misconfigured hwlib from sending a transaction that defies user-specified --from\npub fn validate_from_address(\n specified_from: Option
,\n signer_address: Address,\n) -> Result<()> {\n if let Some(specified_from) = specified_from\n && specified_from != signer_address\n {\n eyre::bail!(\n \"\\\nThe specified sender via CLI/env vars does not match the sender configured via\nthe hardware wallet's HD Path.\nPlease use the `--hd-path ` parameter to specify the BIP32 Path which\ncorresponds to the sender, or let foundry automatically detect it by not specifying any sender address.\"\n )\n }\n Ok(())\n}\n\n/// Initial state.\n#[derive(Debug)]\npub struct InitState;\n\n/// State with known [TxKind].\n#[derive(Debug)]\npub struct ToState {\n to: Option
,\n}\n\n/// State with known input for the transaction.\n#[derive(Debug)]\npub struct InputState {\n kind: TxKind,\n input: Vec,\n func: Option,\n}\n\npub struct CastTxSender {\n provider: P,\n _phantom: PhantomData,\n}\n\nimpl> CastTxSender\nwhere\n N::TransactionRequest: FoundryTransactionBuilder,\n N::ReceiptResponse: UIfmt + UIfmtReceiptExt,\n{\n /// Creates a new Cast instance responsible for sending transactions.\n pub fn new(provider: P) -> Self {\n Self { provider, _phantom: PhantomData }\n }\n\n /// Sends a transaction and waits for receipt synchronously\n pub async fn send_sync(&self, tx: N::TransactionRequest) -> Result {\n let mut receipt = TransactionReceiptWithRevertReason:: {\n receipt: self.provider.send_transaction_sync(tx).await?,\n revert_reason: None,\n };\n // Allow to fail silently\n let _ = receipt.update_revert_reason(&self.provider).await;\n\n self.format_receipt(receipt, None)\n }\n\n /// Sends a transaction to the specified address\n ///\n /// # Example\n ///\n /// ```\n /// use cast::tx::CastTxSender;\n /// use alloy_primitives::{Address, U256, Bytes};\n /// use alloy_serde::WithOtherFields;\n /// use alloy_rpc_types::{TransactionRequest};\n /// use alloy_provider::{RootProvider, ProviderBuilder, network::AnyNetwork};\n /// use std::str::FromStr;\n /// use alloy_sol_types::{sol, SolCall}; ///\n ///\n /// sol!(\n /// function greet(string greeting) public;\n /// );\n ///\n /// # async fn foo() -> eyre::Result<()> {\n /// let provider = ProviderBuilder::<_,_, AnyNetwork>::default().connect(\"http://localhost:8545\").await?;;\n /// let from = Address::from_str(\"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\")?;\n /// let to = Address::from_str(\"0xB3C95ff08316fb2F2e3E52Ee82F8e7b605Aa1304\")?;\n /// let greeting = greetCall { greeting: \"hello\".to_string() }.abi_encode();\n /// let bytes = Bytes::from_iter(greeting.iter());\n /// let gas = U256::from_str(\"200000\").unwrap();\n /// let value = U256::from_str(\"1\").unwrap();\n /// let nonce = U256::from_str(\"1\").unwrap();\n /// let tx = TransactionRequest::default().to(to).input(bytes.into()).from(from);\n /// let tx = WithOtherFields::new(tx);\n /// let cast = CastTxSender::new(provider);\n /// let data = cast.send(tx).await?;\n /// println!(\"{:#?}\", data);\n /// # Ok(())\n /// # }\n /// ```\n pub async fn send(&self, tx: N::TransactionRequest) -> Result> {\n let res = self.provider.send_transaction(tx).await?;\n\n Ok(res)\n }\n\n /// Sends a raw RLP-encoded transaction via `eth_sendRawTransaction`.\n ///\n /// Used for transaction types that the standard Alloy network stack doesn't understand\n /// (e.g., Tempo transactions).\n pub async fn send_raw(&self, raw_tx: &[u8]) -> Result> {\n let res = self.provider.send_raw_transaction(raw_tx).await?;\n Ok(res)\n }\n\n /// Prints the transaction hash (if async) or waits for the receipt and prints it.\n ///\n /// This is the shared \"output\" path used by both the normal send flow and the browser wallet\n /// flow (which sends the transaction out-of-band and only has a tx hash).\n pub async fn print_tx_result(\n &self,\n tx_hash: B256,\n cast_async: bool,\n confs: u64,\n timeout: u64,\n ) -> Result<()> {\n if cast_async {\n sh_println!(\"{tx_hash:#x}\")?;\n } else {\n let receipt =\n self.receipt(format!(\"{tx_hash:#x}\"), None, confs, Some(timeout), false).await?;\n sh_println!(\"{receipt}\")?;\n }\n Ok(())\n }\n\n /// # Example\n ///\n /// ```\n /// use alloy_provider::{ProviderBuilder, RootProvider, network::AnyNetwork};\n /// use cast::tx::CastTxSender;\n ///\n /// async fn foo() -> eyre::Result<()> {\n /// let provider =\n /// ProviderBuilder::<_, _, AnyNetwork>::default().connect(\"http://localhost:8545\").await?;\n /// let cast = CastTxSender::new(provider);\n /// let tx_hash = \"0xf8d1713ea15a81482958fb7ddf884baee8d3bcc478c5f2f604e008dc788ee4fc\";\n /// let receipt = cast.receipt(tx_hash.to_string(), None, 1, None, false).await?;\n /// println!(\"{}\", receipt);\n /// # Ok(())\n /// # }\n /// ```\n pub async fn receipt(\n &self,\n tx_hash: String,\n field: Option,\n confs: u64,\n timeout: Option,\n cast_async: bool,\n ) -> Result {\n let tx_hash = TxHash::from_str(&tx_hash).wrap_err(\"invalid tx hash\")?;\n\n let mut receipt = TransactionReceiptWithRevertReason:: {\n receipt: match self.provider.get_transaction_receipt(tx_hash).await? {\n Some(r) => r,\n None => {\n // if the async flag is provided, immediately exit if no tx is found, otherwise\n // try to poll for it\n if cast_async {\n eyre::bail!(\"tx not found: {:?}\", tx_hash)\n } else {\n PendingTransactionBuilder::::new(self.provider.root().clone(), tx_hash)\n .with_required_confirmations(confs)\n .with_timeout(timeout.map(Duration::from_secs))\n .get_receipt()\n .await?\n }\n }\n },\n revert_reason: None,\n };\n\n // Allow to fail silently\n let _ = receipt.update_revert_reason(&self.provider).await;\n\n self.format_receipt(receipt, field)\n }\n\n /// Helper method to format transaction receipts consistently\n fn format_receipt(\n &self,\n receipt: TransactionReceiptWithRevertReason,\n field: Option,\n ) -> Result {\n Ok(if let Some(ref field) = field {\n get_pretty_receipt_w_reason_attr(&receipt, field)\n .ok_or_else(|| eyre::eyre!(\"invalid receipt field: {}\", field))?\n } else if shell::is_json() {\n // to_value first to sort json object keys\n serde_json::to_value(&receipt)?.to_string()\n } else {\n receipt.pretty()\n })\n }\n}\n\n/// Builder type constructing generic TransactionRequest from cast send/mktx inputs.\n///\n/// It is implemented as a stateful builder with expected state transition of [InitState] ->\n/// [ToState] -> [InputState].\n#[derive(Debug)]\npub struct CastTxBuilder {\n provider: P,\n tx: N::TransactionRequest,\n /// Whether the transaction should be sent as a legacy transaction.\n legacy: bool,\n blob: bool,\n /// Whether the blob transaction should use EIP-4844 (legacy) format instead of EIP-7594.\n eip4844: bool,\n /// Whether to fill gas, fees and nonce. Set to `false` for read-only calls\n /// (eth_call, eth_estimateGas, eth_createAccessList).\n fill: bool,\n auth: Vec,\n chain: Chain,\n etherscan_api_key: Option,\n access_list: Option>,\n state: S,\n}\n\nimpl> CastTxBuilder\nwhere\n N::TransactionRequest: FoundryTransactionBuilder,\n{\n /// Creates a new instance of [CastTxBuilder] filling transaction with fields present in\n /// provided [TransactionOpts].\n pub async fn new(provider: P, tx_opts: TransactionOpts, config: &Config) -> Result {\n let mut tx = N::TransactionRequest::default();\n\n let chain = utils::get_chain(config.chain, &provider).await?;\n let etherscan_api_key = config.get_etherscan_api_key(Some(chain));\n // mark it as legacy if requested or the chain is legacy and no 7702 is provided.\n let legacy = tx_opts.legacy || (chain.is_legacy() && tx_opts.auth.is_empty());\n\n // Apply gas, value, fee, and network-specific options.\n tx_opts.apply::(&mut tx, legacy);\n\n Ok(Self {\n provider,\n tx,\n legacy,\n blob: tx_opts.blob,\n eip4844: tx_opts.eip4844,\n fill: true,\n chain,\n etherscan_api_key,\n auth: tx_opts.auth,\n access_list: tx_opts.access_list,\n state: InitState,\n })\n }\n\n /// Sets [TxKind] for this builder and changes state to [ToState].\n pub async fn with_to(self, to: Option) -> Result> {\n let to = if let Some(to) = to { Some(to.resolve(&self.provider).await?) } else { None };\n Ok(CastTxBuilder {\n provider: self.provider,\n tx: self.tx,\n legacy: self.legacy,\n blob: self.blob,\n eip4844: self.eip4844,\n fill: self.fill,\n chain: self.chain,\n etherscan_api_key: self.etherscan_api_key,\n auth: self.auth,\n access_list: self.access_list,\n state: ToState { to },\n })\n }\n}\n\nimpl> CastTxBuilder\nwhere\n N::TransactionRequest: FoundryTransactionBuilder,\n{\n /// Accepts user-provided code, sig and args params and constructs calldata for the transaction.\n /// If code is present, input will be set to code + encoded constructor arguments. If no code is\n /// present, input is set to just provided arguments.\n pub async fn with_code_sig_and_args(\n self,\n code: Option,\n sig: Option,\n args: Vec,\n ) -> Result> {\n let (mut args, func) = if let Some(sig) = sig {\n parse_function_args(\n &sig,\n args,\n self.state.to,\n self.chain,\n &self.provider,\n self.etherscan_api_key.as_deref(),\n )\n .await?\n } else {\n (Vec::new(), None)\n };\n\n let input = if let Some(code) = &code {\n let mut code = hex::decode(code)?;\n code.append(&mut args);\n code\n } else {\n args\n };\n\n if self.state.to.is_none() && code.is_none() {\n let has_value = self.tx.value().is_some_and(|v| !v.is_zero());\n let has_auth = !self.auth.is_empty();\n // We only allow user to omit the recipient address if transaction is an EIP-7702 tx\n // without a value.\n if !has_auth || has_value {\n eyre::bail!(\"Must specify a recipient address or contract code to deploy\");\n }\n }\n\n Ok(CastTxBuilder {\n provider: self.provider,\n tx: self.tx,\n legacy: self.legacy,\n blob: self.blob,\n eip4844: self.eip4844,\n fill: self.fill,\n chain: self.chain,\n etherscan_api_key: self.etherscan_api_key,\n auth: self.auth,\n access_list: self.access_list,\n state: InputState { kind: self.state.to.into(), input, func },\n })\n }\n}\n\nimpl> CastTxBuilder\nwhere\n N::TransactionRequest: FoundryTransactionBuilder,\n{\n /// Builds the TransactionRequest. Fills gas, fees and nonce unless [`raw`](Self::raw) was\n /// called.\n pub async fn build(\n self,\n sender: impl Into>,\n ) -> Result<(N::TransactionRequest, Option)> {\n let fill = self.fill;\n self._build(sender, fill).await\n }\n\n async fn _build(\n mut self,\n sender: impl Into>,\n fill: bool,\n ) -> Result<(N::TransactionRequest, Option)> {\n // prepare\n let sender = sender.into();\n self.prepare(&sender);\n\n // resolve\n let tx_nonce = self.resolve_nonce(sender.address(), fill).await?;\n self.resolve_auth(&sender, tx_nonce).await?;\n self.resolve_access_list().await?;\n\n // fill\n if fill {\n self.fill_fees().await?;\n }\n\n Ok((self.tx, self.state.func))\n }\n\n /// Sets the core transaction fields from the builder state: kind, input, from, and chain id.\n fn prepare(&mut self, sender: &SenderKind<'_>) {\n self.tx.set_kind(self.state.kind);\n // We set both fields to the same value because some nodes only accept the legacy\n // `data` field: https://github.com/foundry-rs/foundry/issues/7764#issuecomment-2210453249\n self.tx.set_input_kind(self.state.input.clone(), TransactionInputKind::Both);\n self.tx.set_from(sender.address());\n self.tx.set_chain_id(self.chain.id());\n }\n\n /// Resolves the transaction nonce. Returns the existing nonce or fetches one from the\n /// provider. Only sets it on the transaction when `fill` is true.\n async fn resolve_nonce(&mut self, from: Address, fill: bool) -> Result {\n if let Some(nonce) = self.tx.nonce() {\n Ok(nonce)\n } else {\n let nonce = self.provider.get_transaction_count(from).await?;\n if fill {\n self.tx.set_nonce(nonce);\n }\n Ok(nonce)\n }\n }\n\n /// Resolves the access list. Fetches from the provider if `--access-list` was passed without\n /// a value.\n async fn resolve_access_list(&mut self) -> Result<()> {\n if let Some(access_list) = match self.access_list.take() {\n None => None,\n Some(None) => Some(self.provider.create_access_list(&self.tx).await?.access_list),\n Some(Some(access_list)) => Some(access_list),\n } {\n self.tx.set_access_list(access_list);\n }\n Ok(())\n }\n\n /// Parses the passed --auth values and sets the authorization list on the transaction.\n ///\n /// If a signer is available in `sender`, address-based auths will be signed.\n /// If no signer is available, all auths must be pre-signed.\n async fn resolve_auth(&mut self, sender: &SenderKind<'_>, tx_nonce: u64) -> Result<()> {\n if self.auth.is_empty() {\n return Ok(());\n }\n\n let auths = std::mem::take(&mut self.auth);\n\n // Validate that at most one address-based auth is provided (multiple addresses are\n // almost always unintended).\n let address_auth_count =\n auths.iter().filter(|a| matches!(a, CliAuthorizationList::Address(_))).count();\n if address_auth_count > 1 {\n eyre::bail!(\n \"Multiple address-based authorizations provided. Only one address can be specified; \\\n use pre-signed authorizations (hex-encoded) for multiple authorizations.\"\n );\n }\n\n let mut signed_auths = Vec::with_capacity(auths.len());\n\n for auth in auths {\n let signed_auth = match auth {\n CliAuthorizationList::Address(address) => {\n let auth = Authorization {\n chain_id: U256::from(self.chain.id()),\n nonce: tx_nonce + 1,\n address,\n };\n\n let Some(signer) = sender.as_signer() else {\n eyre::bail!(\n \"No signer available to sign authorization. \\\n Provide a pre-signed authorization (hex-encoded) instead.\"\n );\n };\n let signature = signer.sign_hash(&auth.signature_hash()).await?;\n\n auth.into_signed(signature)\n }\n CliAuthorizationList::Signed(auth) => auth,\n };\n signed_auths.push(signed_auth);\n }\n\n self.tx.set_authorization_list(signed_auths);\n\n Ok(())\n }\n\n /// Fills gas price, EIP-1559 fees, blob fees, and gas limit from the provider.\n ///\n /// Only fills values that haven't been explicitly set by the user.\n async fn fill_fees(&mut self) -> Result<()> {\n if self.legacy && self.tx.gas_price().is_none() {\n self.tx.set_gas_price(self.provider.get_gas_price().await?);\n }\n\n if self.blob && self.tx.max_fee_per_blob_gas().is_none() {\n self.tx.set_max_fee_per_blob_gas(self.provider.get_blob_base_fee().await?)\n }\n\n if !self.legacy\n && (self.tx.max_fee_per_gas().is_none() || self.tx.max_priority_fee_per_gas().is_none())\n {\n let estimate = self.provider.estimate_eip1559_fees().await?;\n\n if self.tx.max_fee_per_gas().is_none() {\n self.tx.set_max_fee_per_gas(estimate.max_fee_per_gas);\n }\n\n if self.tx.max_priority_fee_per_gas().is_none() {\n self.tx.set_max_priority_fee_per_gas(estimate.max_priority_fee_per_gas);\n }\n }\n\n if self.tx.gas_limit().is_none() {\n self.estimate_gas().await?;\n }\n\n Ok(())\n }\n\n /// Estimate tx gas from provider call. Tries to decode custom error if execution reverted.\n async fn estimate_gas(&mut self) -> Result<()> {\n match self.provider.estimate_gas(self.tx.clone()).await {\n Ok(estimated) => {\n self.tx.set_gas_limit(estimated);\n Ok(())\n }\n Err(err) => {\n if let TransportError::ErrorResp(payload) = &err {\n // If execution reverted with code 3 during provider gas estimation then try\n // to decode custom errors and append it to the error message.\n if payload.code == 3\n && let Some(data) = &payload.data\n && let Ok(Some(decoded_error)) = decode_execution_revert(data).await\n {\n eyre::bail!(\"Failed to estimate gas: {}: {}\", err, decoded_error)\n }\n }\n eyre::bail!(\"Failed to estimate gas: {}\", err)\n }\n }\n }\n\n /// Populates the blob sidecar for the transaction if any blob data was provided.\n pub fn with_blob_data(mut self, blob_data: Option>) -> Result {\n let Some(blob_data) = blob_data else { return Ok(self) };\n\n let mut coder = SidecarBuilder::::default();\n coder.ingest(&blob_data);\n\n if self.eip4844 {\n let sidecar = coder.build_4844()?;\n self.tx.set_blob_sidecar_4844(sidecar);\n } else {\n let sidecar = coder.build_7594()?;\n self.tx.set_blob_sidecar_7594(sidecar);\n }\n\n Ok(self)\n }\n\n /// Skips gas, fee and nonce filling. Use for read-only calls\n /// (eth_call, eth_estimateGas, eth_createAccessList).\n pub fn raw(mut self) -> Self {\n self.fill = false;\n self\n }\n}\n\n/// Helper function that tries to decode custom error name and inputs from error payload data.\nasync fn decode_execution_revert(data: &RawValue) -> Result> {\n let err_data = serde_json::from_str::(data.get())?;\n let Some(selector) = err_data.get(..4) else { return Ok(None) };\n if let Some(known_error) =\n SignaturesIdentifier::new(false)?.identify_error(selector.try_into().unwrap()).await\n {\n let mut decoded_error = known_error.name.clone();\n if !known_error.inputs.is_empty()\n && let Ok(error) = known_error.decode_error(&err_data)\n {\n write!(decoded_error, \"({})\", format_tokens(&error.body).format(\", \"))?;\n }\n return Ok(Some(decoded_error));\n }\n Ok(None)\n}\n" }, { "path": "crates/cast/tests/cli/erc20.rs", "content": "//! Contains various tests for checking cast erc20 subcommands\n\nuse alloy_primitives::U256;\nuse anvil::NodeConfig;\nuse foundry_test_utils::util::OutputExt;\n\nmod anvil_const {\n /// First Anvil account\n pub const PK1: &str = \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\";\n pub const ADDR1: &str = \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\";\n\n /// Second Anvil account\n pub const _PK2: &str = \"0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d\";\n pub const ADDR2: &str = \"0x70997970C51812dc3A010C7d01b50e0d17dc79C8\";\n\n /// Contract address deploying from ADDR1 with nonce 0\n pub const TOKEN: &str = \"0x5FbDB2315678afecb367f032d93F642f64180aa3\";\n}\n\nfn get_u256_from_cmd(cmd: &mut foundry_test_utils::TestCommand, args: &[&str]) -> U256 {\n let output = cmd.cast_fuse().args(args).assert_success().get_output().stdout_lossy();\n\n // Parse balance from output (format: \"100000000000000000000 [1e20]\")\n output.split_whitespace().next().unwrap().parse().unwrap()\n}\n\nfn get_balance(\n cmd: &mut foundry_test_utils::TestCommand,\n token: &str,\n address: &str,\n rpc: &str,\n) -> U256 {\n get_u256_from_cmd(cmd, &[\"erc20\", \"balance\", token, address, \"--rpc-url\", rpc])\n}\n\nfn get_allowance(\n cmd: &mut foundry_test_utils::TestCommand,\n token: &str,\n owner: &str,\n spender: &str,\n rpc: &str,\n) -> U256 {\n get_u256_from_cmd(cmd, &[\"erc20\", \"allowance\", token, owner, spender, \"--rpc-url\", rpc])\n}\n\n/// Helper function to deploy TestToken contract\nfn deploy_test_token(\n cmd: &mut foundry_test_utils::TestCommand,\n rpc: &str,\n private_key: &str,\n) -> String {\n cmd.args([\n \"create\",\n \"--private-key\",\n private_key,\n \"--rpc-url\",\n rpc,\n \"--broadcast\",\n \"src/TestToken.sol:TestToken\",\n ])\n .assert_success();\n\n // Return the standard deployment address (nonce 0 from first account)\n anvil_const::TOKEN.to_string()\n}\n\n/// Helper to setup anvil node and deploy test token\nasync fn setup_token_test(\n prj: &foundry_test_utils::TestProject,\n cmd: &mut foundry_test_utils::TestCommand,\n) -> (String, String) {\n let (_, handle) = anvil::spawn(NodeConfig::test()).await;\n let rpc = handle.http_endpoint();\n\n // Deploy TestToken contract\n foundry_test_utils::util::initialize(prj.root());\n prj.add_source(\"TestToken.sol\", include_str!(\"../fixtures/TestToken.sol\"));\n let token = deploy_test_token(cmd, &rpc, anvil_const::PK1);\n\n (rpc, token)\n}\n\n// tests that `balance` and `transfer` commands works correctly\nforgetest_async!(erc20_transfer_approve_success, |prj, cmd| {\n let (rpc, token) = setup_token_test(&prj, &mut cmd).await;\n\n // Test constants\n let transfer_amount = U256::from(100_000_000_000_000_000_000u128); // 100 tokens (18 decimals)\n let initial_supply = U256::from(1_000_000_000_000_000_000_000u128); // 1000 tokens total supply\n\n // Verify initial balances\n let addr1_balance_before = get_balance(&mut cmd, &token, anvil_const::ADDR1, &rpc);\n let addr2_balance_before = get_balance(&mut cmd, &token, anvil_const::ADDR2, &rpc);\n assert_eq!(addr1_balance_before, initial_supply);\n assert_eq!(addr2_balance_before, U256::ZERO);\n\n // Test ERC20 transfer from ADDR1 to ADDR2\n cmd.cast_fuse()\n .args([\n \"erc20\",\n \"transfer\",\n &token,\n anvil_const::ADDR2,\n &transfer_amount.to_string(),\n \"--rpc-url\",\n &rpc,\n \"--private-key\",\n anvil_const::PK1,\n ])\n .assert_success();\n\n // Verify balance changes after transfer\n let addr1_balance_after = get_balance(&mut cmd, &token, anvil_const::ADDR1, &rpc);\n let addr2_balance_after = get_balance(&mut cmd, &token, anvil_const::ADDR2, &rpc);\n assert_eq!(addr1_balance_after, addr1_balance_before - transfer_amount);\n assert_eq!(addr2_balance_after, addr2_balance_before + transfer_amount);\n});\n\n// tests that `approve` and `allowance` commands works correctly\nforgetest_async!(erc20_approval_allowance, |prj, cmd| {\n let (rpc, token) = setup_token_test(&prj, &mut cmd).await;\n\n // ADDR1 approves ADDR2 to spend their tokens\n let approve_amount = U256::from(50_000_000_000_000_000_000u128); // 50 tokens\n cmd.cast_fuse()\n .args([\n \"erc20\",\n \"approve\",\n &token,\n anvil_const::ADDR2,\n &approve_amount.to_string(),\n \"--rpc-url\",\n &rpc,\n \"--private-key\",\n anvil_const::PK1,\n ])\n .assert_success();\n\n // Verify allowance was set\n let allowance = get_allowance(&mut cmd, &token, anvil_const::ADDR1, anvil_const::ADDR2, &rpc);\n assert_eq!(allowance, approve_amount);\n});\n\n// tests that `name`, `symbol`, `decimals`, and `totalSupply` commands work correctly\nforgetest_async!(erc20_metadata_success, |prj, cmd| {\n let (rpc, token) = setup_token_test(&prj, &mut cmd).await;\n\n // Test name\n let output = cmd\n .cast_fuse()\n .args([\"erc20\", \"name\", &token, \"--rpc-url\", &rpc])\n .assert_success()\n .get_output()\n .stdout_lossy();\n assert_eq!(output.trim(), \"Test Token\");\n\n // Test symbol\n let output = cmd\n .cast_fuse()\n .args([\"erc20\", \"symbol\", &token, \"--rpc-url\", &rpc])\n .assert_success()\n .get_output()\n .stdout_lossy();\n assert_eq!(output.trim(), \"TEST\");\n\n // Test decimals\n let output = cmd\n .cast_fuse()\n .args([\"erc20\", \"decimals\", &token, \"--rpc-url\", &rpc])\n .assert_success()\n .get_output()\n .stdout_lossy();\n assert_eq!(output.trim(), \"18\");\n\n // Test totalSupply\n let output = cmd\n .cast_fuse()\n .args([\"erc20\", \"total-supply\", &token, \"--rpc-url\", &rpc])\n .assert_success()\n .get_output()\n .stdout_lossy();\n let total_supply: U256 = output.split_whitespace().next().unwrap().parse().unwrap();\n assert_eq!(total_supply, U256::from(1_000_000_000_000_000_000_000u128));\n});\n\n// tests that `mint` command works correctly\nforgetest_async!(erc20_mint_success, |prj, cmd| {\n let (rpc, token) = setup_token_test(&prj, &mut cmd).await;\n\n let mint_amount = U256::from(500_000_000_000_000_000_000u128); // 500 tokens\n let initial_supply = U256::from(1_000_000_000_000_000_000_000u128); // 1000 tokens\n\n // Get initial balance and supply\n let addr2_balance_before = get_balance(&mut cmd, &token, anvil_const::ADDR2, &rpc);\n assert_eq!(addr2_balance_before, U256::ZERO);\n\n // Mint tokens to ADDR2 (only owner can mint)\n cmd.cast_fuse()\n .args([\n \"erc20\",\n \"mint\",\n &token,\n anvil_const::ADDR2,\n &mint_amount.to_string(),\n \"--rpc-url\",\n &rpc,\n \"--private-key\",\n anvil_const::PK1, // PK1 is the owner/deployer\n ])\n .assert_success();\n\n // Verify balance increased\n let addr2_balance_after = get_balance(&mut cmd, &token, anvil_const::ADDR2, &rpc);\n assert_eq!(addr2_balance_after, mint_amount);\n\n // Verify totalSupply increased\n let output = cmd\n .cast_fuse()\n .args([\"erc20\", \"total-supply\", &token, \"--rpc-url\", &rpc])\n .assert_success()\n .get_output()\n .stdout_lossy();\n let total_supply: U256 = output.split_whitespace().next().unwrap().parse().unwrap();\n assert_eq!(total_supply, initial_supply + mint_amount);\n});\n\n// tests that `burn` command works correctly\nforgetest_async!(erc20_burn_success, |prj, cmd| {\n let (rpc, token) = setup_token_test(&prj, &mut cmd).await;\n\n let burn_amount = U256::from(200_000_000_000_000_000_000u128); // 200 tokens\n let initial_supply = U256::from(1_000_000_000_000_000_000_000u128); // 1000 tokens\n\n // Get initial balance\n let addr1_balance_before = get_balance(&mut cmd, &token, anvil_const::ADDR1, &rpc);\n assert_eq!(addr1_balance_before, initial_supply);\n\n // Burn tokens from ADDR1\n cmd.cast_fuse()\n .args([\n \"erc20\",\n \"burn\",\n &token,\n &burn_amount.to_string(),\n \"--rpc-url\",\n &rpc,\n \"--private-key\",\n anvil_const::PK1,\n ])\n .assert_success();\n\n // Verify balance decreased\n let addr1_balance_after = get_balance(&mut cmd, &token, anvil_const::ADDR1, &rpc);\n assert_eq!(addr1_balance_after, addr1_balance_before - burn_amount);\n\n // Verify totalSupply decreased\n let output = cmd\n .cast_fuse()\n .args([\"erc20\", \"total-supply\", &token, \"--rpc-url\", &rpc])\n .assert_success()\n .get_output()\n .stdout_lossy();\n let total_supply: U256 = output.split_whitespace().next().unwrap().parse().unwrap();\n assert_eq!(total_supply, initial_supply - burn_amount);\n});\n\n// tests that `transfer` command works with gas options\nforgetest_async!(erc20_transfer_with_gas_opts, |prj, cmd| {\n let (rpc, token) = setup_token_test(&prj, &mut cmd).await;\n\n let transfer_amount = U256::from(100_000_000_000_000_000_000u128); // 100 tokens\n\n // Transfer with explicit gas limit and gas price\n cmd.cast_fuse()\n .args([\n \"erc20\",\n \"transfer\",\n &token,\n anvil_const::ADDR2,\n &transfer_amount.to_string(),\n \"--rpc-url\",\n &rpc,\n \"--private-key\",\n anvil_const::PK1,\n \"--gas-limit\",\n \"100000\",\n \"--gas-price\",\n \"2000000000\",\n ])\n .assert_success();\n\n // Verify transfer succeeded\n let balance = get_balance(&mut cmd, &token, anvil_const::ADDR2, &rpc);\n assert_eq!(balance, transfer_amount);\n});\n\n// tests that `transfer` command fails with insufficient gas limit\nforgetest_async!(erc20_transfer_insufficient_gas, |prj, cmd| {\n let (rpc, token) = setup_token_test(&prj, &mut cmd).await;\n\n let transfer_amount = U256::from(50_000_000_000_000_000_000u128); // 50 tokens\n\n // Transfer with insufficient gas limit (ERC20 transfer needs ~50k gas)\n cmd.cast_fuse()\n .args([\n \"erc20\",\n \"transfer\",\n &token,\n anvil_const::ADDR2,\n &transfer_amount.to_string(),\n \"--rpc-url\",\n &rpc,\n \"--private-key\",\n anvil_const::PK1,\n \"--gas-limit\",\n \"1000\", // Way too low for ERC20 transfer\n ])\n .assert_failure();\n\n // Verify transfer did NOT occur\n let balance = get_balance(&mut cmd, &token, anvil_const::ADDR2, &rpc);\n assert_eq!(balance, U256::ZERO);\n});\n\n// tests that `transfer` command fails with incorrect nonce\nforgetest_async!(erc20_transfer_incorrect_nonce, |prj, cmd| {\n let (rpc, token) = setup_token_test(&prj, &mut cmd).await;\n\n let transfer_amount = U256::from(50_000_000_000_000_000_000u128); // 50 tokens\n\n cmd.cast_fuse()\n .args([\n \"erc20\",\n \"transfer\",\n &token,\n anvil_const::ADDR2,\n &transfer_amount.to_string(),\n \"--rpc-url\",\n &rpc,\n \"--private-key\",\n anvil_const::PK1,\n ])\n .assert_success();\n\n // Transfer with nonce too low\n cmd.cast_fuse()\n .args([\n \"erc20\",\n \"transfer\",\n &token,\n anvil_const::ADDR2,\n &transfer_amount.to_string(),\n \"--rpc-url\",\n &rpc,\n \"--private-key\",\n anvil_const::PK1,\n \"--nonce\",\n \"0\", // Too low nonce\n ])\n .assert_failure();\n\n // Verify transfer did NOT occur\n let balance = get_balance(&mut cmd, &token, anvil_const::ADDR2, &rpc);\n assert_eq!(balance, transfer_amount); // 2nd transfer failed\n});\n\n// tests that the --curl flag outputs a valid curl command for cast erc20 balance\ncasttest!(curl_erc20_balance, |_prj, cmd| {\n let rpc = \"https://eth.example.com\";\n let token = \"0xdead000000000000000000000000000000000000\";\n let owner = \"0xbeef000000000000000000000000000000000000\";\n\n let output = cmd\n .args([\"erc20\", \"balance\", token, owner, \"--rpc-url\", rpc, \"--curl\"])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n // Verify curl command structure\n assert!(output.contains(\"curl -X POST\"));\n assert!(output.contains(\"eth_call\"));\n assert!(output.contains(rpc));\n});\n\n// tests that the --curl flag outputs a valid curl command for cast erc20 name\ncasttest!(curl_erc20_name, |_prj, cmd| {\n let rpc = \"https://eth.example.com\";\n let token = \"0xdead000000000000000000000000000000000000\";\n\n let output = cmd\n .args([\"erc20\", \"name\", token, \"--rpc-url\", rpc, \"--curl\"])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n // Verify curl command structure\n assert!(output.contains(\"curl -X POST\"));\n assert!(output.contains(\"eth_call\"));\n assert!(output.contains(rpc));\n});\n\n// tests that the --curl flag outputs a valid curl command for cast erc20 decimals\ncasttest!(curl_erc20_decimals, |_prj, cmd| {\n let rpc = \"https://eth.example.com\";\n let token = \"0xdead000000000000000000000000000000000000\";\n\n let output = cmd\n .args([\"erc20\", \"decimals\", token, \"--rpc-url\", rpc, \"--curl\"])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n // Verify curl command structure\n assert!(output.contains(\"curl -X POST\"));\n assert!(output.contains(\"eth_call\"));\n assert!(output.contains(rpc));\n});\n\n// tests that the --curl flag outputs a valid curl command for cast erc20 total-supply\ncasttest!(curl_erc20_total_supply, |_prj, cmd| {\n let rpc = \"https://eth.example.com\";\n let token = \"0xdead000000000000000000000000000000000000\";\n\n let output = cmd\n .args([\"erc20\", \"total-supply\", token, \"--rpc-url\", rpc, \"--curl\"])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n // Verify curl command structure\n assert!(output.contains(\"curl -X POST\"));\n assert!(output.contains(\"eth_call\"));\n assert!(output.contains(rpc));\n});\n\n// tests that the --curl flag outputs a valid curl command for erc20 balance\ncasttest!(erc20_curl_balance, |_prj, cmd| {\n let rpc = \"https://eth.example.com\";\n let token = \"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\"; // USDC\n let owner = \"0xdead000000000000000000000000000000000000\";\n\n let output = cmd\n .args([\"erc20\", \"balance\", token, owner, \"--rpc-url\", rpc, \"--curl\"])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n // Verify curl command structure\n assert!(output.contains(\"curl -X POST\"));\n assert!(output.contains(\"eth_call\"));\n assert!(output.contains(rpc));\n});\n\n// tests that the --curl flag outputs a valid curl command for erc20 name\ncasttest!(erc20_curl_name, |_prj, cmd| {\n let rpc = \"https://eth.example.com\";\n let token = \"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\"; // USDC\n\n let output = cmd\n .args([\"erc20\", \"name\", token, \"--rpc-url\", rpc, \"--curl\"])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n // Verify curl command structure\n assert!(output.contains(\"curl -X POST\"));\n assert!(output.contains(\"eth_call\"));\n assert!(output.contains(rpc));\n});\n\n// tests that the --curl flag outputs a valid curl command for erc20 decimals\ncasttest!(erc20_curl_decimals, |_prj, cmd| {\n let rpc = \"https://eth.example.com\";\n let token = \"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\"; // USDC\n\n let output = cmd\n .args([\"erc20\", \"decimals\", token, \"--rpc-url\", rpc, \"--curl\"])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n // Verify curl command structure\n assert!(output.contains(\"curl -X POST\"));\n assert!(output.contains(\"eth_call\"));\n assert!(output.contains(rpc));\n});\n\n// tests that the --curl flag outputs a valid curl command for erc20 total-supply\ncasttest!(erc20_curl_total_supply, |_prj, cmd| {\n let rpc = \"https://eth.example.com\";\n let token = \"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\"; // USDC\n\n let output = cmd\n .args([\"erc20\", \"total-supply\", token, \"--rpc-url\", rpc, \"--curl\"])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n // Verify curl command structure\n assert!(output.contains(\"curl -X POST\"));\n assert!(output.contains(\"eth_call\"));\n assert!(output.contains(rpc));\n});\n\n// tests that `balance` command works correctly with --json flag\nforgetest_async!(erc20_balance_json, |prj, cmd| {\n let (rpc, token) = setup_token_test(&prj, &mut cmd).await;\n\n let output = cmd\n .cast_fuse()\n .args([\"--json\", \"erc20\", \"balance\", &token, anvil_const::ADDR1, \"--rpc-url\", &rpc])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n let balance_str: String = serde_json::from_str(&output).expect(\"valid json string\");\n let balance: U256 = balance_str.parse().unwrap();\n assert_eq!(balance, U256::from(1_000_000_000_000_000_000_000u128));\n});\n\n// tests that `allowance` command works correctly with --json flag\nforgetest_async!(erc20_allowance_json, |prj, cmd| {\n let (rpc, token) = setup_token_test(&prj, &mut cmd).await;\n\n // First approve some tokens\n let approve_amount = U256::from(50_000_000_000_000_000_000u128);\n cmd.cast_fuse()\n .args([\n \"erc20\",\n \"approve\",\n &token,\n anvil_const::ADDR2,\n &approve_amount.to_string(),\n \"--rpc-url\",\n &rpc,\n \"--private-key\",\n anvil_const::PK1,\n ])\n .assert_success();\n\n // Check allowance with JSON flag\n let output = cmd\n .cast_fuse()\n .args([\n \"--json\",\n \"erc20\",\n \"allowance\",\n &token,\n anvil_const::ADDR1,\n anvil_const::ADDR2,\n \"--rpc-url\",\n &rpc,\n ])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n let allowance_str: String = serde_json::from_str(&output).expect(\"valid json string\");\n let allowance: U256 = allowance_str.parse().unwrap();\n assert_eq!(allowance, approve_amount);\n});\n\n// tests that `name`, `symbol`, `decimals`, and `totalSupply` commands work correctly with --json\n// flag\nforgetest_async!(erc20_metadata_json, |prj, cmd| {\n let (rpc, token) = setup_token_test(&prj, &mut cmd).await;\n\n // Test name with --json\n let output = cmd\n .cast_fuse()\n .args([\"--json\", \"erc20\", \"name\", &token, \"--rpc-url\", &rpc])\n .assert_success()\n .get_output()\n .stdout_lossy();\n let name: String = serde_json::from_str(&output).expect(\"valid json string\");\n assert_eq!(name, \"Test Token\");\n\n // Test symbol with --json\n let output = cmd\n .cast_fuse()\n .args([\"--json\", \"erc20\", \"symbol\", &token, \"--rpc-url\", &rpc])\n .assert_success()\n .get_output()\n .stdout_lossy();\n let symbol: String = serde_json::from_str(&output).expect(\"valid json string\");\n assert_eq!(symbol, \"TEST\");\n\n // Test decimals with --json\n let output = cmd\n .cast_fuse()\n .args([\"--json\", \"erc20\", \"decimals\", &token, \"--rpc-url\", &rpc])\n .assert_success()\n .get_output()\n .stdout_lossy();\n let decimals: u8 = output.trim().parse().expect(\"valid number\");\n assert_eq!(decimals, 18);\n\n // Test totalSupply with --json\n let output = cmd\n .cast_fuse()\n .args([\"--json\", \"erc20\", \"total-supply\", &token, \"--rpc-url\", &rpc])\n .assert_success()\n .get_output()\n .stdout_lossy();\n let total_supply_str: String = serde_json::from_str(&output).expect(\"valid json string\");\n let total_supply: U256 = total_supply_str.parse().unwrap();\n assert_eq!(total_supply, U256::from(1_000_000_000_000_000_000_000u128));\n});\n" }, { "path": "crates/cast/tests/cli/main.rs", "content": "//! Contains various tests for checking cast commands\n\nuse alloy_chains::NamedChain;\nuse alloy_hardforks::EthereumHardfork;\nuse alloy_network::{TransactionBuilder, TransactionResponse};\nuse alloy_primitives::{B256, Bytes, U256, address, b256, hex};\nuse alloy_provider::{Provider, ProviderBuilder};\nuse alloy_rpc_types::{Authorization, BlockNumberOrTag, Index, TransactionRequest};\nuse alloy_signer::Signer;\nuse alloy_signer_local::PrivateKeySigner;\nuse anvil::NodeConfig;\nuse foundry_test_utils::{\n rpc::{\n next_etherscan_api_key, next_http_archive_rpc_url, next_http_rpc_endpoint,\n next_rpc_endpoint, next_ws_rpc_endpoint,\n },\n snapbox::IntoData as _,\n str,\n util::OutputExt,\n};\nuse serde_json::json;\nuse std::{fs, path::Path, str::FromStr};\n\n#[macro_use]\nextern crate foundry_test_utils;\n\nmod erc20;\nmod selectors;\n\ncasttest!(print_short_version, |_prj, cmd| {\n cmd.arg(\"-V\").assert_success().stdout_eq(str![[r#\"\ncast [..]-[..] ([..] [..])\n\n\"#]]);\n});\n\ncasttest!(print_long_version, |_prj, cmd| {\n cmd.arg(\"--version\").assert_success().stdout_eq(str![[r#\"\ncast Version: [..]\nCommit SHA: [..]\nBuild Timestamp: [..]\nBuild Profile: [..]\n\n\"#]]);\n});\n\n// tests `--help` is printed to std out\ncasttest!(print_help, |_prj, cmd| {\n cmd.arg(\"--help\").assert_success().stdout_eq(str![[r#\"\nA Swiss Army knife for interacting with Ethereum applications from the command line\n\nUsage: cast[..] \n\nCommands:\n...\n\nOptions:\n -h, --help\n Print help (see a summary with '-h')\n\n -j, --threads \n Number of threads to use. Specifying 0 defaults to the number of logical cores\n...\n [aliases: --jobs]\n\n -V, --version\n Print version\n\nDisplay options:\n --color \n The color of the log messages\n\n Possible values:\n - auto: Intelligently guess whether to use color output (default)\n - always: Force color output\n - never: Force disable color output\n\n --json\n Format log messages as JSON\n\n --md\n Format log messages as Markdown\n\n -q, --quiet\n Do not print log messages\n\n -v, --verbosity...\n Verbosity level of the log messages.\n...\n Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv).\n...\n Depending on the context the verbosity levels have different meanings.\n...\n For example, the verbosity levels of the EVM are:\n - 2 (-vv): Print logs for all tests.\n - 3 (-vvv): Print execution traces for failing tests.\n - 4 (-vvvv): Print execution traces for all tests, and setup traces for failing tests.\n - 5 (-vvvvv): Print execution and setup traces for all tests, including storage changes\n and\n backtraces with line numbers.\n\nFind more information in the book: https://getfoundry.sh/cast/overview\n\n\"#]]);\n});\n\n// tests that the `cast block` command works correctly\ncasttest!(latest_block, |_prj, cmd| {\n let eth_rpc_url = next_http_rpc_endpoint();\n\n // Call `cast find-block`\n cmd.args([\"block\", \"latest\", \"--rpc-url\", eth_rpc_url.as_str()]);\n cmd.assert_success().stdout_eq(str![[r#\"\n\n\nbaseFeePerGas [..]\ndifficulty [..]\nextraData [..]\ngasLimit [..]\ngasUsed [..]\nhash [..]\nlogsBloom [..]\nminer [..]\nmixHash [..]\nnonce [..]\nnumber [..]\nparentHash [..]\nparentBeaconRoot [..]\ntransactionsRoot [..]\nreceiptsRoot [..]\nsha3Uncles [..]\nsize [..]\nstateRoot [..]\ntimestamp [..]\nwithdrawalsRoot [..]\ntotalDifficulty [..]\nblobGasUsed [..]\nexcessBlobGas [..]\nrequestsHash [..]\ntransactions: [\n...\n]\n\n\"#]]);\n\n // \n cmd.cast_fuse().args([\n \"block\",\n \"15007840\",\n \"-f\",\n \"hash,timestamp\",\n \"--rpc-url\",\n eth_rpc_url.as_str(),\n ]);\n cmd.assert_success().stdout_eq(str![[r#\"\n0x950091817a57e22b6c1f3b951a15f52d41ac89b299cc8f9c89bb6d185f80c415\n1655904485\n\n\"#]]);\n});\n\ncasttest!(block_raw, |_prj, cmd| {\n let eth_rpc_url = next_http_rpc_endpoint();\n\n let output = cmd\n .args([\"block\", \"22934900\", \"--rpc-url\", eth_rpc_url.as_str(), \"--raw\"])\n .assert_success()\n .get_output()\n .stdout_lossy()\n .trim()\n .to_string();\n\n // Hash the output with keccak256\n let hash = alloy_primitives::keccak256(hex::decode(output).unwrap());\n\n // Verify the Mainnet's block #22934900 header hash equals the expected value\n // obtained with go-ethereum's `block.Header().Hash()` method\n assert_eq!(\n hash.to_string(),\n \"0x49fd7f3b9ba5d67fa60197027f09454d4cac945e8f271edcc84c3fd5872446d3\"\n );\n});\n\ncasttest!(block_raw_tempo, |_prj, cmd| {\n // https://explore.tempo.xyz/block/8386710\n let output = cmd\n .args([\n \"block\",\n \"8386710\",\n \"--rpc-url\",\n \"https://rpc.moderato.tempo.xyz\",\n \"--raw\",\n \"-n\",\n \"tempo\",\n ])\n .assert_success()\n .get_output()\n .stdout_lossy()\n .trim()\n .to_string();\n\n let hash = alloy_primitives::keccak256(hex::decode(output).unwrap());\n\n assert_eq!(\n hash.to_string(),\n \"0xcd6170dc28b888bcb93ed1ad76a6bea4ad9977b678db5d462df83d35ec9b8d15\"\n );\n});\n\n// tests that the `cast find-block` command works correctly\ncasttest!(finds_block, |_prj, cmd| {\n // Construct args\n let timestamp = \"1647843609\".to_string();\n let eth_rpc_url = next_http_rpc_endpoint();\n\n // Call `cast find-block`\n // \n cmd.args([\"find-block\", \"--rpc-url\", eth_rpc_url.as_str(), ×tamp])\n .assert_success()\n .stdout_eq(str![[r#\"\n14428082\n\n\"#]]);\n});\n\n// tests that we can create a new wallet\ncasttest!(new_wallet, |_prj, cmd| {\n cmd.args([\"wallet\", \"new\"]).assert_success().stdout_eq(str![[r#\"\nSuccessfully created new keypair.\n[ADDRESS]\n[PRIVATE_KEY]\n\n\"#]]);\n});\n\n// tests that we can create a new wallet (verbose variant)\ncasttest!(new_wallet_verbose, |_prj, cmd| {\n cmd.args([\"wallet\", \"new\", \"-v\"]).assert_success().stdout_eq(str![[r#\"\nSuccessfully created new keypair.\n[ADDRESS]\n[PUBLIC_KEY]\n[PRIVATE_KEY]\n\n\"#]]);\n});\n\n// tests that we can create a new wallet with json output\ncasttest!(new_wallet_json, |_prj, cmd| {\n cmd.args([\"wallet\", \"new\", \"--json\"]).assert_success().stdout_eq(\n str![[r#\"\n[\n {\n \"address\": \"{...}\",\n \"private_key\": \"{...}\"\n }\n]\n\n\"#]]\n .is_json(),\n );\n});\n\n// tests that we can create a new wallet with json output (verbose variant)\ncasttest!(new_wallet_json_verbose, |_prj, cmd| {\n cmd.args([\"wallet\", \"new\", \"--json\", \"-v\"]).assert_success().stdout_eq(\n str![[r#\"\n[\n {\n \"address\": \"{...}\",\n \"public_key\": \"{...}\",\n \"private_key\": \"{...}\"\n }\n]\n\n\"#]]\n .is_json(),\n );\n});\n\n// tests that we can create a new wallet with keystore\ncasttest!(new_wallet_keystore_with_password, |_prj, cmd| {\n cmd.args([\"wallet\", \"new\", \".\", \"test-account\", \"--unsafe-password\", \"test\"])\n .assert_success()\n .stdout_eq(str![[r#\"\nCreated new encrypted keystore file: [..]\n[ADDRESS]\n\n\"#]]);\n});\n\n// tests that we can create a new wallet with keystore (verbose variant)\ncasttest!(new_wallet_keystore_with_password_verbose, |_prj, cmd| {\n cmd.args([\"wallet\", \"new\", \".\", \"test-account\", \"--unsafe-password\", \"test\", \"-v\"])\n .assert_success()\n .stdout_eq(str![[r#\"\nCreated new encrypted keystore file: [..]\n[ADDRESS]\n[PUBLIC_KEY]\n\n\"#]]);\n});\n\n// tests that `cast wallet new` prompts before overwriting an existing keystore file\ncasttest!(new_wallet_keystore_overwrite_protection, |prj, cmd| {\n // Create the initial keystore\n cmd.args([\"wallet\", \"new\", \".\", \"test-account\", \"--unsafe-password\", \"test\"]).assert_success();\n\n // Attempt to overwrite with stdin \"n\" ā€” should be cancelled\n cmd.cast_fuse()\n .current_dir(prj.root())\n .args([\"wallet\", \"new\", \".\", \"test-account\", \"--unsafe-password\", \"test\"])\n .stdin(\"n\\n\")\n .assert_failure()\n .stderr_eq(str![[r#\"\nThe following keystore file(s) already exist:\n - test-account\nError: Operation cancelled. No keystores were modified.\n\n\"#]]);\n});\n\n// tests that `cast wallet new --force` overwrites existing keystore files without prompting\ncasttest!(new_wallet_keystore_overwrite_force, |prj, cmd| {\n // Create the initial keystore\n cmd.args([\"wallet\", \"new\", \".\", \"test-account\", \"--unsafe-password\", \"test\"]).assert_success();\n\n // Overwrite with --force ā€” should succeed without prompting\n cmd.cast_fuse()\n .current_dir(prj.root())\n .args([\"wallet\", \"new\", \".\", \"test-account\", \"--unsafe-password\", \"test\", \"--force\"])\n .assert_success()\n .stdout_eq(str![[r#\"\nCreated new encrypted keystore file: [..]\n[ADDRESS]\n\n\"#]]);\n});\n\n// tests that `cast wallet new -n 2` prompts before overwriting existing keystore files\ncasttest!(new_wallet_keystore_overwrite_protection_multiple, |prj, cmd| {\n // Create 2 keystores: test-account_1 and test-account_2\n cmd.args([\"wallet\", \"new\", \".\", \"test-account\", \"--unsafe-password\", \"test\", \"-n\", \"2\"])\n .assert_success();\n\n // Attempt to overwrite with stdin \"n\" ā€” should list both and cancel\n cmd.cast_fuse()\n .current_dir(prj.root())\n .args([\"wallet\", \"new\", \".\", \"test-account\", \"--unsafe-password\", \"test\", \"-n\", \"2\"])\n .stdin(\"n\\n\")\n .assert_failure()\n .stderr_eq(str![[r#\"\nThe following keystore file(s) already exist:\n - test-account_1\n - test-account_2\nError: Operation cancelled. No keystores were modified.\n\n\"#]]);\n});\n\n// tests that we can create a new wallet with default keystore location\ncasttest!(new_wallet_default_keystore, |_prj, cmd| {\n cmd.args([\"wallet\", \"new\", \"--unsafe-password\", \"test\"]).assert_success().stdout_eq(str![[\n r#\"\nCreated new encrypted keystore file: [..]\n[ADDRESS]\n\n\"#\n ]]);\n\n // Verify the default keystore directory was created\n let keystore_path = dirs::home_dir().unwrap().join(\".foundry\").join(\"keystores\");\n assert!(keystore_path.exists());\n assert!(keystore_path.is_dir());\n});\n\n// tests that we can outputting multiple keys without a keystore path\ncasttest!(new_wallet_multiple_keys, |_prj, cmd| {\n cmd.args([\"wallet\", \"new\", \"-n\", \"2\"]).assert_success().stdout_eq(str![[r#\"\nSuccessfully created new keypair.\n[ADDRESS]\n[PRIVATE_KEY]\nSuccessfully created new keypair.\n[ADDRESS]\n[PRIVATE_KEY]\n\n\"#]]);\n});\n\n// tests that we can get the address of a keystore file\ncasttest!(wallet_address_keystore_with_password_file, |_prj, cmd| {\n let keystore_dir = Path::new(env!(\"CARGO_MANIFEST_DIR\")).join(\"tests/fixtures/keystore\");\n\n cmd.args([\n \"wallet\",\n \"address\",\n \"--keystore\",\n keystore_dir\n .join(\"UTC--2022-12-20T10-30-43.591916000Z--ec554aeafe75601aaab43bd4621a22284db566c2\")\n .to_str()\n .unwrap(),\n \"--password-file\",\n keystore_dir.join(\"password-ec554\").to_str().unwrap(),\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n0xeC554aeAFE75601AaAb43Bd4621A22284dB566C2\n\n\"#]]);\n});\n\n// tests that `cast wallet remove` can successfully remove a keystore file and validates password\ncasttest!(wallet_remove_keystore_with_unsafe_password, |prj, cmd| {\n let keystore_path = prj.root().join(\"keystore\");\n\n cmd.set_current_dir(prj.root());\n\n let account_name = \"testAccount\";\n\n // Default Anvil private key\n let test_private_key =\n b256!(\"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\");\n\n // import private key\n cmd.cast_fuse()\n .args([\n \"wallet\",\n \"import\",\n account_name,\n \"--private-key\",\n &test_private_key.to_string(),\n \"-k\",\n \"keystore\",\n \"--unsafe-password\",\n \"test\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n`testAccount` keystore was saved successfully. [ADDRESS]\n\n\"#]]);\n\n // check that the keystore file was created\n let keystore_file = keystore_path.join(account_name);\n\n assert!(keystore_file.exists());\n // Remove the wallet\n cmd.cast_fuse()\n .args([\n \"wallet\",\n \"remove\",\n \"--name\",\n account_name,\n \"--dir\",\n keystore_path.to_str().unwrap(),\n \"--unsafe-password\",\n \"test\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n`testAccount` keystore was removed successfully.\n\n\"#]]);\n\n assert!(!keystore_file.exists());\n});\n\n// tests that `cast wallet sign message` outputs the expected signature\ncasttest!(wallet_sign_message_utf8_data, |_prj, cmd| {\n let pk = \"0x0000000000000000000000000000000000000000000000000000000000000001\";\n let address = \"0x7E5F4552091A69125d5DfCb7b8C2659029395Bdf\";\n let msg = \"test\";\n let expected = \"0xfe28833983d6faa0715c7e8c3873c725ddab6fa5bf84d40e780676e463e6bea20fc6aea97dc273a98eb26b0914e224c8dd5c615ceaab69ddddcf9b0ae3de0e371c\";\n\n cmd.args([\"wallet\", \"sign\", \"--private-key\", pk, msg]).assert_success().stdout_eq(str![[r#\"\n0xfe28833983d6faa0715c7e8c3873c725ddab6fa5bf84d40e780676e463e6bea20fc6aea97dc273a98eb26b0914e224c8dd5c615ceaab69ddddcf9b0ae3de0e371c\n\n\"#]]);\n\n // Success.\n cmd.cast_fuse()\n .args([\"wallet\", \"verify\", \"-a\", address, msg, expected])\n .assert_success()\n .stdout_eq(str![[r#\"\nValidation succeeded. Address 0x7E5F4552091A69125d5DfCb7b8C2659029395Bdf signed this message.\n\n\"#]]);\n\n // Fail.\n cmd.cast_fuse()\n .args([\"wallet\", \"verify\", \"-a\", address, \"other msg\", expected])\n .assert_failure()\n .stderr_eq(str![[r#\"\nError: Validation failed. Address 0x7E5F4552091A69125d5DfCb7b8C2659029395Bdf did not sign this message.\n\n\"#]]);\n});\n\n// tests that `cast wallet sign message` outputs the expected signature, given a 0x-prefixed data\ncasttest!(wallet_sign_message_hex_data, |_prj, cmd| {\n cmd.args([\n \"wallet\",\n \"sign\",\n \"--private-key\",\n \"0x0000000000000000000000000000000000000000000000000000000000000001\",\n \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n ]).assert_success().stdout_eq(str![[r#\"\n0x23a42ca5616ee730ff3735890c32fc7b9491a9f633faca9434797f2c845f5abf4d9ba23bd7edb8577acebaa3644dc5a4995296db420522bb40060f1693c33c9b1c\n\n\"#]]);\n});\n\n// \n// tests that `cast wallet sign` and `cast wallet verify` work with the same message as input\ncasttest!(wallet_sign_and_verify_message_hex_data, |_prj, cmd| {\n // message=\"$1\"\n // mnemonic=\"test test test test test test test test test test test junk\"\n // key=$(cast wallet private-key --mnemonic \"$mnemonic\")\n // address=$(cast wallet address --mnemonic \"$mnemonic\")\n // signature=$(cast wallet sign --private-key \"$key\" \"$message\")\n // cast wallet verify --address \"$address\" \"$message\" \"$signature\"\n let mnemonic = \"test test test test test test test test test test test junk\";\n let key = \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\";\n let address = \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\";\n cmd.args([\"wallet\", \"private-key\", \"--mnemonic\", mnemonic]).assert_success().stdout_eq(str![[\n r#\"\n0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\n\n\"#\n ]]);\n cmd.cast_fuse().args([\"wallet\", \"address\", \"--mnemonic\", mnemonic]).assert_success().stdout_eq(\n str![[r#\"\n0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\n\n\"#]],\n );\n\n let msg_hex = \"0x0000000000000000000000000000000000000000000000000000000000000001\";\n let signature_hex = \"0xed769da87f78d0166b30aebf2767ceed5a3867da21b2fba8c6527af256bbcebe24a1e758ec8ad1ffc29cfefa540ea7ba7966c0edf6907af82348f894ba4f40fa1b\";\n cmd.cast_fuse().args([\n \"wallet\", \"sign\", \"--private-key\",key, msg_hex\n ]).assert_success().stdout_eq(str![[r#\"\n0xed769da87f78d0166b30aebf2767ceed5a3867da21b2fba8c6527af256bbcebe24a1e758ec8ad1ffc29cfefa540ea7ba7966c0edf6907af82348f894ba4f40fa1b\n\n\"#]]);\n\n cmd.cast_fuse()\n .args([\"wallet\", \"verify\", \"--address\", address, msg_hex, signature_hex])\n .assert_success()\n .stdout_eq(str![[r#\"\nValidation succeeded. Address 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266 signed this message.\n\n\"#]]);\n\n let msg_raw = \"0000000000000000000000000000000000000000000000000000000000000001\";\n let signature_raw = \"0x27a97b378477d9d004bd19cbd838d59bbb9847074ae4cc5b5975cc5566065eea76ee5b752fcdd483073e1baba548d82d9accc8603b3781bcc9abf195614cd3411c\";\n cmd.cast_fuse().args([\n \"wallet\", \"sign\", \"--private-key\",key, msg_raw\n ]).assert_success().stdout_eq(str![[r#\"\n0x27a97b378477d9d004bd19cbd838d59bbb9847074ae4cc5b5975cc5566065eea76ee5b752fcdd483073e1baba548d82d9accc8603b3781bcc9abf195614cd3411c\n\n\"#]]);\n\n cmd.cast_fuse()\n .args([\"wallet\", \"verify\", \"--address\", address, msg_raw, signature_raw])\n .assert_success()\n .stdout_eq(str![[r#\"\nValidation succeeded. Address 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266 signed this message.\n\n\"#]]);\n});\n\n// tests that `cast wallet sign typed-data` outputs the expected signature, given a JSON string\ncasttest!(wallet_sign_typed_data_string, |_prj, cmd| {\n cmd.args([\n \"wallet\",\n \"sign\",\n \"--private-key\",\n \"0x0000000000000000000000000000000000000000000000000000000000000001\",\n \"--data\",\n \"{\\\"types\\\": {\\\"EIP712Domain\\\": [{\\\"name\\\": \\\"name\\\",\\\"type\\\": \\\"string\\\"},{\\\"name\\\": \\\"version\\\",\\\"type\\\": \\\"string\\\"},{\\\"name\\\": \\\"chainId\\\",\\\"type\\\": \\\"uint256\\\"},{\\\"name\\\": \\\"verifyingContract\\\",\\\"type\\\": \\\"address\\\"}],\\\"Message\\\": [{\\\"name\\\": \\\"data\\\",\\\"type\\\": \\\"string\\\"}]},\\\"primaryType\\\": \\\"Message\\\",\\\"domain\\\": {\\\"name\\\": \\\"example.metamask.io\\\",\\\"version\\\": \\\"1\\\",\\\"chainId\\\": \\\"1\\\",\\\"verifyingContract\\\": \\\"0x0000000000000000000000000000000000000000\\\"},\\\"message\\\": {\\\"data\\\": \\\"Hello!\\\"}}\",\n ]).assert_success().stdout_eq(str![[r#\"\n0x06c18bdc8163219fddc9afaf5a0550e381326474bb757c86dc32317040cf384e07a2c72ce66c1a0626b6750ca9b6c035bf6f03e7ed67ae2d1134171e9085c0b51b\n\n\"#]]);\n});\n\n// tests that `cast wallet sign typed-data` outputs the expected signature, given a JSON file\ncasttest!(wallet_sign_typed_data_file, |_prj, cmd| {\n cmd.args([\n \"wallet\",\n \"sign\",\n \"--private-key\",\n \"0x0000000000000000000000000000000000000000000000000000000000000001\",\n \"--data\",\n \"--from-file\",\n Path::new(env!(\"CARGO_MANIFEST_DIR\"))\n .join(\"tests/fixtures/sign_typed_data.json\")\n .into_os_string()\n .into_string()\n .unwrap()\n .as_str(),\n ]).assert_success().stdout_eq(str![[r#\"\n0x06c18bdc8163219fddc9afaf5a0550e381326474bb757c86dc32317040cf384e07a2c72ce66c1a0626b6750ca9b6c035bf6f03e7ed67ae2d1134171e9085c0b51b\n\n\"#]]);\n});\n\n// tests that `cast wallet sign typed-data` passes with type names containing colons\n// \ncasttest!(wallet_sign_typed_data_with_colon_succeeds, |_prj, cmd| {\n let typed_data_with_colon = r#\"{\n \"types\": {\n \"EIP712Domain\": [\n {\"name\": \"name\", \"type\": \"string\"},\n {\"name\": \"version\", \"type\": \"string\"},\n {\"name\": \"chainId\", \"type\": \"uint256\"},\n {\"name\": \"verifyingContract\", \"type\": \"address\"}\n ],\n \"Test:Message\": [\n {\"name\": \"content\", \"type\": \"string\"}\n ]\n },\n \"primaryType\": \"Test:Message\",\n \"domain\": {\n \"name\": \"TestDomain\",\n \"version\": \"1\",\n \"chainId\": 1,\n \"verifyingContract\": \"0x0000000000000000000000000000000000000000\"\n },\n \"message\": {\n \"content\": \"Hello\"\n }\n }\"#;\n\n cmd.args([\n \"wallet\",\n \"sign\",\n \"--private-key\",\n \"0x0000000000000000000000000000000000000000000000000000000000000001\",\n \"--data\",\n typed_data_with_colon,\n ]).assert_success().stdout_eq(str![[r#\"\n0xf91c67e845a4d468d1f876f457ffa01e65468641fc121453705242d21de39b266c278592b085814ab1e9adc938cc26b1d64bb61f80b437df077777c4283612291b\n\n\"#]]);\n});\n\n// tests that the same data without colon works correctly\n// \ncasttest!(wallet_sign_typed_data_without_colon_works, |_prj, cmd| {\n let typed_data_without_colon = r#\"{\n \"types\": {\n \"EIP712Domain\": [\n {\"name\": \"name\", \"type\": \"string\"},\n {\"name\": \"version\", \"type\": \"string\"},\n {\"name\": \"chainId\", \"type\": \"uint256\"},\n {\"name\": \"verifyingContract\", \"type\": \"address\"}\n ],\n \"TestMessage\": [\n {\"name\": \"content\", \"type\": \"string\"}\n ]\n },\n \"primaryType\": \"TestMessage\",\n \"domain\": {\n \"name\": \"TestDomain\",\n \"version\": \"1\",\n \"chainId\": 1,\n \"verifyingContract\": \"0x0000000000000000000000000000000000000000\"\n },\n \"message\": {\n \"content\": \"Hello\"\n }\n }\"#;\n\n cmd.args([\n \"wallet\",\n \"sign\",\n \"--private-key\",\n \"0x0000000000000000000000000000000000000000000000000000000000000001\",\n \"--data\",\n typed_data_without_colon,\n ])\n .assert_success();\n});\n\n// tests that `cast wallet sign-auth message` outputs the expected signature\ncasttest!(wallet_sign_auth, |_prj, cmd| {\n cmd.args([\n \"wallet\",\n \"sign-auth\",\n \"--private-key\",\n \"0x0000000000000000000000000000000000000000000000000000000000000001\",\n \"--nonce\",\n \"100\",\n \"--chain\",\n \"1\",\n \"0x7E5F4552091A69125d5DfCb7b8C2659029395Bdf\"]).assert_success().stdout_eq(str![[r#\"\n0xf85a01947e5f4552091a69125d5dfcb7b8c2659029395bdf6401a0ad489ee0314497c3f06567f3080a46a63908edc1c7cdf2ac2d609ca911212086a065a6ba951c8748dd8634740fe498efb61770097d99ff5fdcb9a863b62ea899f6\n\n\"#]]);\n});\n\n// tests that `cast wallet sign-auth --self-broadcast` uses nonce + 1\ncasttest!(wallet_sign_auth_self_broadcast, async |_prj, cmd| {\n use alloy_rlp::Decodable;\n use alloy_signer_local::PrivateKeySigner;\n\n let (_, handle) =\n anvil::spawn(NodeConfig::test().with_hardfork(Some(EthereumHardfork::Prague.into()))).await;\n let endpoint = handle.http_endpoint();\n\n let private_key = \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\";\n let signer: PrivateKeySigner = private_key.parse().unwrap();\n let signer_address = signer.address();\n let delegate_address = address!(\"0x70997970C51812dc3A010C7d01b50e0d17dc79C8\");\n\n // Get the current nonce from the RPC\n let provider = ProviderBuilder::new().connect_http(endpoint.parse().unwrap());\n let current_nonce = provider.get_transaction_count(signer_address).await.unwrap();\n\n // First, get the auth without --self-broadcast (should use current nonce)\n let output_normal = cmd\n .args([\n \"wallet\",\n \"sign-auth\",\n \"--private-key\",\n private_key,\n \"--rpc-url\",\n &endpoint,\n &delegate_address.to_string(),\n ])\n .assert_success()\n .get_output()\n .stdout_lossy()\n .trim()\n .to_string();\n\n // Then, get the auth with --self-broadcast (should use current nonce + 1)\n let output_self_broadcast = cmd\n .cast_fuse()\n .args([\n \"wallet\",\n \"sign-auth\",\n \"--private-key\",\n private_key,\n \"--rpc-url\",\n &endpoint,\n \"--self-broadcast\",\n &delegate_address.to_string(),\n ])\n .assert_success()\n .get_output()\n .stdout_lossy()\n .trim()\n .to_string();\n\n // The outputs should be different due to different nonces\n assert_ne!(\n output_normal, output_self_broadcast,\n \"self-broadcast should produce different signature due to nonce + 1\"\n );\n\n // Decode the RLP to verify the nonces\n let normal_bytes = hex::decode(output_normal.strip_prefix(\"0x\").unwrap()).unwrap();\n let self_broadcast_bytes =\n hex::decode(output_self_broadcast.strip_prefix(\"0x\").unwrap()).unwrap();\n\n let normal_auth =\n alloy_eips::eip7702::SignedAuthorization::decode(&mut normal_bytes.as_slice()).unwrap();\n let self_broadcast_auth =\n alloy_eips::eip7702::SignedAuthorization::decode(&mut self_broadcast_bytes.as_slice())\n .unwrap();\n\n assert_eq!(normal_auth.nonce(), current_nonce, \"normal auth should have current nonce\");\n assert_eq!(\n self_broadcast_auth.nonce(),\n current_nonce + 1,\n \"self-broadcast auth should have current nonce + 1\"\n );\n});\n\n// tests that `cast wallet list` outputs the local accounts\ncasttest!(wallet_list_local_accounts, |prj, cmd| {\n let keystore_path = prj.root().join(\"keystore\");\n fs::create_dir_all(keystore_path).unwrap();\n cmd.set_current_dir(prj.root());\n\n // empty results\n cmd.cast_fuse()\n .args([\"wallet\", \"list\", \"--dir\", \"keystore\"])\n .assert_success()\n .stdout_eq(str![\"\"]);\n\n // create 10 wallets\n cmd.cast_fuse()\n .args([\"wallet\", \"new\", \"keystore\", \"-n\", \"10\", \"--unsafe-password\", \"test\"])\n .assert_success()\n .stdout_eq(str![[r#\"\nCreated new encrypted keystore file: [..]\n[ADDRESS]\nCreated new encrypted keystore file: [..]\n[ADDRESS]\nCreated new encrypted keystore file: [..]\n[ADDRESS]\nCreated new encrypted keystore file: [..]\n[ADDRESS]\nCreated new encrypted keystore file: [..]\n[ADDRESS]\nCreated new encrypted keystore file: [..]\n[ADDRESS]\nCreated new encrypted keystore file: [..]\n[ADDRESS]\nCreated new encrypted keystore file: [..]\n[ADDRESS]\nCreated new encrypted keystore file: [..]\n[ADDRESS]\nCreated new encrypted keystore file: [..]\n[ADDRESS]\n\n\"#]]);\n\n // test list new wallet\n cmd.cast_fuse().args([\"wallet\", \"list\", \"--dir\", \"keystore\"]).assert_success().stdout_eq(str![\n [r#\"\n[..] (Local)\n[..] (Local)\n[..] (Local)\n[..] (Local)\n[..] (Local)\n[..] (Local)\n[..] (Local)\n[..] (Local)\n[..] (Local)\n[..] (Local)\n\n\"#]\n ]);\n});\n\n// tests that `cast wallet new-mnemonic --entropy` outputs the expected mnemonic\ncasttest!(wallet_mnemonic_from_entropy, |_prj, cmd| {\n cmd.args([\n \"wallet\",\n \"new-mnemonic\",\n \"--accounts\",\n \"3\",\n \"--entropy\",\n \"0xdf9bf37e6fcdf9bf37e6fcdf9bf37e3c\",\n ])\n .assert_success()\n .stdout_eq(\n str![[r#\"\nGenerating mnemonic from provided entropy...\nSuccessfully generated a new mnemonic.\nPhrase:\ntest test test test test test test test test test test junk\n\nAccounts:\n- Account 0:\nAddress: 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\nPrivate key: 0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\n\n- Account 1:\nAddress: 0x70997970C51812dc3A010C7d01b50e0d17dc79C8\nPrivate key: 0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d\n\n- Account 2:\nAddress: 0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC\nPrivate key: 0x5de4111afa1a4b94908f83103eb1f1706367c2e68ca870fc3fb9a804cdab365a\n\n\n\"#]]\n .raw(),\n );\n});\n\n// tests that `cast wallet new-mnemonic --entropy` outputs the expected mnemonic (verbose variant)\ncasttest!(wallet_mnemonic_from_entropy_verbose, |_prj, cmd| {\n cmd.args([\n \"wallet\",\n \"new-mnemonic\",\n \"--accounts\",\n \"3\",\n \"--entropy\",\n \"0xdf9bf37e6fcdf9bf37e6fcdf9bf37e3c\",\n \"-v\",\n ])\n .assert_success()\n .stdout_eq(\n str![[r#\"\nGenerating mnemonic from provided entropy...\nSuccessfully generated a new mnemonic.\nPhrase:\ntest test test test test test test test test test test junk\n\nAccounts:\n- Account 0:\nAddress: 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\nPublic key: 0x8318535b54105d4a7aae60c08fc45f9687181b4fdfc625bd1a753fa7397fed753547f11ca8696646f2f3acb08e31016afac23e630c5d11f59f61fef57b0d2aa5\nPrivate key: 0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\n\n- Account 1:\nAddress: 0x70997970C51812dc3A010C7d01b50e0d17dc79C8\nPublic key: 0xba5734d8f7091719471e7f7ed6b9df170dc70cc661ca05e688601ad984f068b0d67351e5f06073092499336ab0839ef8a521afd334e53807205fa2f08eec74f4\nPrivate key: 0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d\n\n- Account 2:\nAddress: 0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC\nPublic key: 0x9d9031e97dd78ff8c15aa86939de9b1e791066a0224e331bc962a2099a7b1f0464b8bbafe1535f2301c72c2cb3535b172da30b02686ab0393d348614f157fbdb\nPrivate key: 0x5de4111afa1a4b94908f83103eb1f1706367c2e68ca870fc3fb9a804cdab365a\n\n\n\"#]]\n .raw(),\n );\n});\n\n// tests that `cast wallet new-mnemonic --json` outputs the expected mnemonic\ncasttest!(wallet_mnemonic_from_entropy_json, |_prj, cmd| {\n cmd.args([\n \"wallet\",\n \"new-mnemonic\",\n \"--accounts\",\n \"3\",\n \"--entropy\",\n \"0xdf9bf37e6fcdf9bf37e6fcdf9bf37e3c\",\n \"--json\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n{\n \"mnemonic\": \"test test test test test test test test test test test junk\",\n \"accounts\": [\n {\n \"address\": \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\",\n \"private_key\": \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\"\n },\n {\n \"address\": \"0x70997970C51812dc3A010C7d01b50e0d17dc79C8\",\n \"private_key\": \"0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d\"\n },\n {\n \"address\": \"0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC\",\n \"private_key\": \"0x5de4111afa1a4b94908f83103eb1f1706367c2e68ca870fc3fb9a804cdab365a\"\n }\n ]\n}\n\n\"#]]);\n});\n\n// tests that `cast wallet new-mnemonic --json` outputs the expected mnemonic (verbose variant)\ncasttest!(wallet_mnemonic_from_entropy_json_verbose, |_prj, cmd| {\n cmd.args([\n \"wallet\",\n \"new-mnemonic\",\n \"--accounts\",\n \"3\",\n \"--entropy\",\n \"0xdf9bf37e6fcdf9bf37e6fcdf9bf37e3c\",\n \"--json\",\n \"-v\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n{\n \"mnemonic\": \"test test test test test test test test test test test junk\",\n \"accounts\": [\n {\n \"address\": \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\",\n \"public_key\": \"0x8318535b54105d4a7aae60c08fc45f9687181b4fdfc625bd1a753fa7397fed753547f11ca8696646f2f3acb08e31016afac23e630c5d11f59f61fef57b0d2aa5\",\n \"private_key\": \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\"\n },\n {\n \"address\": \"0x70997970C51812dc3A010C7d01b50e0d17dc79C8\",\n \"public_key\": \"0xba5734d8f7091719471e7f7ed6b9df170dc70cc661ca05e688601ad984f068b0d67351e5f06073092499336ab0839ef8a521afd334e53807205fa2f08eec74f4\",\n \"private_key\": \"0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d\"\n },\n {\n \"address\": \"0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC\",\n \"public_key\": \"0x9d9031e97dd78ff8c15aa86939de9b1e791066a0224e331bc962a2099a7b1f0464b8bbafe1535f2301c72c2cb3535b172da30b02686ab0393d348614f157fbdb\",\n \"private_key\": \"0x5de4111afa1a4b94908f83103eb1f1706367c2e68ca870fc3fb9a804cdab365a\"\n }\n ]\n}\n\n\"#]]);\n});\n\n// tests that `cast wallet derive` outputs the addresses of the accounts derived from the mnemonic\ncasttest!(wallet_derive_mnemonic, |_prj, cmd| {\n cmd.args([\n \"wallet\",\n \"derive\",\n \"--accounts\",\n \"3\",\n \"test test test test test test test test test test test junk\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n- Account 0:\n[ADDRESS]\n\n- Account 1:\n[ADDRESS]\n\n- Account 2:\n[ADDRESS]\n\n\n\"#]]);\n});\n\n// tests that `cast wallet derive` with insecure flag outputs the addresses and private keys of the\n// accounts derived from the mnemonic\ncasttest!(wallet_derive_mnemonic_insecure, |_prj, cmd| {\n cmd.args([\n \"wallet\",\n \"derive\",\n \"--accounts\",\n \"3\",\n \"--insecure\",\n \"test test test test test test test test test test test junk\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n- Account 0:\n[ADDRESS]\n[PRIVATE_KEY]\n\n- Account 1:\n[ADDRESS]\n[PRIVATE_KEY]\n\n- Account 2:\n[ADDRESS]\n[PRIVATE_KEY]\n\n\n\"#]]);\n});\n\n// tests that `cast wallet derive` with json flag outputs the addresses of the accounts derived from\n// the mnemonic in JSON format\ncasttest!(wallet_derive_mnemonic_json, |_prj, cmd| {\n cmd.args([\n \"wallet\",\n \"derive\",\n \"--accounts\",\n \"3\",\n \"--json\",\n \"test test test test test test test test test test test junk\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n[\n {\n \"address\": \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\"\n },\n {\n \"address\": \"0x70997970C51812dc3A010C7d01b50e0d17dc79C8\"\n },\n {\n \"address\": \"0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC\"\n }\n]\n\n\"#]]);\n});\n\n// tests that `cast wallet derive` with insecure and json flag outputs the addresses and private\n// keys of the accounts derived from the mnemonic in JSON format\ncasttest!(wallet_derive_mnemonic_insecure_json, |_prj, cmd| {\n cmd.args([\n \"wallet\",\n \"derive\",\n \"--accounts\",\n \"3\",\n \"--insecure\",\n \"--json\",\n \"test test test test test test test test test test test junk\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n[\n {\n \"address\": \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\",\n \"private_key\": \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\"\n },\n {\n \"address\": \"0x70997970C51812dc3A010C7d01b50e0d17dc79C8\",\n \"private_key\": \"0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d\"\n },\n {\n \"address\": \"0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC\",\n \"private_key\": \"0x5de4111afa1a4b94908f83103eb1f1706367c2e68ca870fc3fb9a804cdab365a\"\n }\n]\n\n\"#]]);\n});\n\n// tests that `cast wallet private-key` with arguments outputs the private key\ncasttest!(wallet_private_key_from_mnemonic_arg, |_prj, cmd| {\n cmd.args([\n \"wallet\",\n \"private-key\",\n \"test test test test test test test test test test test junk\",\n \"1\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d\n\n\"#]]);\n});\n\n// tests that `cast wallet private-key` with options outputs the private key\ncasttest!(wallet_private_key_from_mnemonic_option, |_prj, cmd| {\n cmd.args([\n \"wallet\",\n \"private-key\",\n \"--mnemonic\",\n \"test test test test test test test test test test test junk\",\n \"--mnemonic-index\",\n \"1\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d\n\n\"#]]);\n});\n// tests that `cast wallet public-key` correctly derives and outputs the public key\ncasttest!(wallet_public_key_with_private_key, |_prj, cmd| {\n cmd.args([\n \"wallet\",\n \"public-key\",\n \"--raw-private-key\",\n \"0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d\"\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n0xba5734d8f7091719471e7f7ed6b9df170dc70cc661ca05e688601ad984f068b0d67351e5f06073092499336ab0839ef8a521afd334e53807205fa2f08eec74f4\n\n\"#]]);\n});\n// tests that `cast wallet private-key` with derivation path outputs the private key\ncasttest!(wallet_private_key_with_derivation_path, |_prj, cmd| {\n cmd.args([\n \"wallet\",\n \"private-key\",\n \"--mnemonic\",\n \"test test test test test test test test test test test junk\",\n \"--mnemonic-derivation-path\",\n \"m/44'/60'/0'/0/1\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d\n\n\"#]]);\n});\n\n// tests that `cast wallet import` creates a keystore for a private key and that `cast wallet\n// decrypt-keystore` can access it\ncasttest!(wallet_import_and_decrypt, |prj, cmd| {\n let keystore_path = prj.root().join(\"keystore\");\n\n cmd.set_current_dir(prj.root());\n\n let account_name = \"testAccount\";\n\n // Default Anvil private key\n let test_private_key =\n b256!(\"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\");\n\n // import private key\n cmd.cast_fuse()\n .args([\n \"wallet\",\n \"import\",\n account_name,\n \"--private-key\",\n &test_private_key.to_string(),\n \"-k\",\n \"keystore\",\n \"--unsafe-password\",\n \"test\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n`testAccount` keystore was saved successfully. [ADDRESS]\n\n\"#]]);\n\n // check that the keystore file was created\n let keystore_file = keystore_path.join(account_name);\n\n assert!(keystore_file.exists());\n\n // decrypt the keystore file\n let decrypt_output = cmd.cast_fuse().args([\n \"wallet\",\n \"decrypt-keystore\",\n account_name,\n \"-k\",\n \"keystore\",\n \"--unsafe-password\",\n \"test\",\n ]);\n\n // get the PK out of the output (last word in the output)\n let decrypt_output = decrypt_output.assert_success().get_output().stdout_lossy();\n let private_key_string = decrypt_output.split_whitespace().last().unwrap();\n // check that the decrypted private key matches the imported private key\n let decrypted_private_key = B256::from_str(private_key_string).unwrap();\n // the form\n assert_eq!(decrypted_private_key, test_private_key);\n});\n\n// tests that `cast wallet change-password` can successfully change the password of a keystore file\ncasttest!(wallet_change_password, |prj, cmd| {\n let keystore_path = prj.root().join(\"keystore\");\n\n cmd.set_current_dir(prj.root());\n\n let account_name = \"testAccount\";\n\n // Default Anvil private key\n let test_private_key =\n b256!(\"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\");\n\n // import private key with initial password\n cmd.cast_fuse()\n .args([\n \"wallet\",\n \"import\",\n account_name,\n \"--private-key\",\n &test_private_key.to_string(),\n \"-k\",\n \"keystore\",\n \"--unsafe-password\",\n \"old_password\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n`testAccount` keystore was saved successfully. [ADDRESS]\n\n\"#]]);\n\n // check that the keystore file was created\n let keystore_file = keystore_path.join(account_name);\n assert!(keystore_file.exists());\n\n // change the password\n cmd.cast_fuse()\n .args([\n \"wallet\",\n \"change-password\",\n account_name,\n \"--keystore-dir\",\n \"keystore\",\n \"--unsafe-password\",\n \"old_password\",\n \"--unsafe-new-password\",\n \"new_password\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\nPassword for keystore `testAccount` was changed successfully. [ADDRESS]\n\n\"#]]);\n\n // verify the old password no longer works\n cmd.cast_fuse()\n .args([\n \"wallet\",\n \"decrypt-keystore\",\n account_name,\n \"-k\",\n \"keystore\",\n \"--unsafe-password\",\n \"old_password\",\n ])\n .assert_failure();\n\n // verify the new password works\n let decrypt_output = cmd.cast_fuse().args([\n \"wallet\",\n \"decrypt-keystore\",\n account_name,\n \"-k\",\n \"keystore\",\n \"--unsafe-password\",\n \"new_password\",\n ]);\n\n // get the PK out of the output (last word in the output)\n let decrypt_output = decrypt_output.assert_success().get_output().stdout_lossy();\n let private_key_string = decrypt_output.split_whitespace().last().unwrap();\n\n // check that the decrypted private key matches the imported private key\n let decrypted_private_key = B256::from_str(private_key_string).unwrap();\n assert_eq!(decrypted_private_key, test_private_key);\n});\n\n// tests that `cast estimate` is working correctly.\ncasttest!(estimate_function_gas, |_prj, cmd| {\n let eth_rpc_url = next_http_rpc_endpoint();\n\n // ensure we get a positive non-error value for gas estimate\n let output: u32 = cmd\n .args([\n \"estimate\",\n \"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\", // vitalik.eth\n \"--value\",\n \"100\",\n \"deposit()\",\n \"--rpc-url\",\n eth_rpc_url.as_str(),\n ])\n .assert_success()\n .get_output()\n .stdout_lossy()\n .trim()\n .parse()\n .unwrap();\n assert!(output.ge(&0));\n});\n\n// tests that `cast estimate --cost` is working correctly.\ncasttest!(estimate_function_cost, |_prj, cmd| {\n let eth_rpc_url = next_http_rpc_endpoint();\n\n // ensure we get a positive non-error value for cost estimate\n let output: f64 = cmd\n .args([\n \"estimate\",\n \"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\", // vitalik.eth\n \"--value\",\n \"100\",\n \"deposit()\",\n \"--rpc-url\",\n eth_rpc_url.as_str(),\n \"--cost\",\n ])\n .assert_success()\n .get_output()\n .stdout_lossy()\n .trim()\n .parse()\n .unwrap();\n assert!(output > 0f64);\n});\n\n// tests that `cast estimate --create` is working correctly.\ncasttest!(estimate_contract_deploy_gas, |_prj, cmd| {\n let eth_rpc_url = next_http_rpc_endpoint();\n // sample contract code bytecode. Wouldn't run but is valid bytecode that the estimate method\n // accepts and could be deployed.\n let output = cmd\n .args([\n \"estimate\",\n \"--rpc-url\",\n eth_rpc_url.as_str(),\n \"--create\",\n \"0000\",\n \"ERC20(uint256,string,string)\",\n \"100\",\n \"Test\",\n \"TST\",\n ])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n // ensure we get a positive non-error value for gas estimate\n let output: u32 = output.trim().parse().unwrap();\n assert!(output > 0);\n});\n\n// tests that the `cast to-rlp` and `cast from-rlp` commands work correctly\ncasttest!(rlp, |_prj, cmd| {\n cmd.args([\"--to-rlp\", \"[\\\"0xaa\\\", [[\\\"bb\\\"]], \\\"0xcc\\\"]\"]).assert_success().stdout_eq(str![[\n r#\"\n0xc881aac3c281bb81cc\n\n\"#\n ]]);\n\n cmd.cast_fuse();\n cmd.args([\"--from-rlp\", \"0xcbc58455556666c0c0c2c1c0\"]).assert_success().stdout_eq(str![[r#\"\n[[\"0x55556666\"],[],[],[[[]]]]\n\n\"#]]);\n});\n\n// test that `cast impl` works correctly for both the implementation slot and the beacon slot\ncasttest!(impl_slot, |_prj, cmd| {\n let eth_rpc_url = next_http_archive_rpc_url();\n\n // Call `cast impl` for the implementation slot (AAVE Proxy)\n cmd.args([\n \"impl\",\n \"0x4965f6FA20fE9728deCf5165016fc338a5a85aBF\",\n \"--rpc-url\",\n eth_rpc_url.as_str(),\n \"--block\",\n \"21422087\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n0xb61306c8eb34a2104d9eb8d84f1bb1001067fa4b\n\n\"#]]);\n});\n\ncasttest!(impl_slot_beacon, |_prj, cmd| {\n let eth_rpc_url = next_http_archive_rpc_url();\n\n // Call `cast impl` for the beacon slot\n cmd.args([\n \"impl\",\n \"0xc63d9f0040d35f328274312fc8771a986fc4ba86\",\n \"--beacon\",\n \"--rpc-url\",\n eth_rpc_url.as_str(),\n \"--block\",\n \"21422087\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n0xa748ae65ba11606492a9c57effa0d4b7be551ec2\n\n\"#]]);\n});\n\n// test for cast_rpc without arguments\ncasttest!(rpc_no_args, |_prj, cmd| {\n let eth_rpc_url = next_http_rpc_endpoint();\n\n // Call `cast rpc eth_chainId`\n cmd.args([\"rpc\", \"--rpc-url\", eth_rpc_url.as_str(), \"eth_chainId\"]).assert_success().stdout_eq(\n str![[r#\"\n\"0x1\"\n\n\"#]],\n );\n});\n\n// test for cast_rpc without arguments using websocket\ncasttest!(ws_rpc_no_args, |_prj, cmd| {\n let eth_rpc_url = next_ws_rpc_endpoint();\n\n // Call `cast rpc eth_chainId`\n cmd.args([\"rpc\", \"--rpc-url\", eth_rpc_url.as_str(), \"eth_chainId\"]).assert_success().stdout_eq(\n str![[r#\"\n\"0x1\"\n\n\"#]],\n );\n});\n\n// test for cast_rpc with arguments\ncasttest!(rpc_with_args, |_prj, cmd| {\n let eth_rpc_url = next_http_rpc_endpoint();\n\n // Call `cast rpc eth_getBlockByNumber 0x123 false`\n cmd.args([\"rpc\", \"--rpc-url\", eth_rpc_url.as_str(), \"eth_getBlockByNumber\", \"0x123\", \"false\"])\n .assert_json_stdout(str![[r#\"\n{\"number\":\"0x123\",\"hash\":\"0xc5dab4e189004a1312e9db43a40abb2de91ad7dd25e75880bf36016d8e9df524\",\"transactions\":[],\"logsBloom\":\"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\"receiptsRoot\":\"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\"extraData\":\"0x476574682f4c5649562f76312e302e302f6c696e75782f676f312e342e32\",\"nonce\":\"0x29d6547c196e00e0\",\"miner\":\"0xbb7b8287f3f0a933474a79eae42cbca977791171\",\"difficulty\":\"0x494433b31\",\"gasLimit\":\"0x1388\",\"gasUsed\":\"0x0\",\"uncles\":[],\"sha3Uncles\":\"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\"size\":\"0x220\",\"transactionsRoot\":\"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\"stateRoot\":\"0x3fe6bd17aa85376c7d566df97d9f2e536f37f7a87abb3a6f9e2891cf9442f2e4\",\"mixHash\":\"0x943056aa305aa6d22a3c06110942980342d1f4d4b11c17711961436a0f963ea0\",\"parentHash\":\"0x7abfd11e862ccde76d6ea8ee20978aac26f4bcb55de1188cc0335be13e817017\",\"timestamp\":\"0x55ba4564\"}\n\n\"#]]);\n});\n\n// test for cast_rpc with arguments\ncasttest!(rpc_format_as_json, |_prj, cmd| {\n let eth_rpc_url = next_http_rpc_endpoint();\n\n // Call `cast rpc eth_getBlockByNumber 0x123 false`\n cmd.args([\"rpc\", \"--rpc-url\", eth_rpc_url.as_str(), \"eth_getBlockByNumber\", \"0x123\", \"false\", \"--json\"])\n .assert_json_stdout(str![[r#\"\n{\n \"hash\": \"0xc5dab4e189004a1312e9db43a40abb2de91ad7dd25e75880bf36016d8e9df524\",\n \"parentHash\": \"0x7abfd11e862ccde76d6ea8ee20978aac26f4bcb55de1188cc0335be13e817017\",\n \"sha3Uncles\": \"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\n \"miner\": \"0xbb7b8287f3f0a933474a79eae42cbca977791171\",\n \"stateRoot\": \"0x3fe6bd17aa85376c7d566df97d9f2e536f37f7a87abb3a6f9e2891cf9442f2e4\",\n \"transactionsRoot\": \"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\n \"receiptsRoot\": \"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\n \"logsBloom\": \"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\n \"difficulty\": \"0x494433b31\",\n \"number\": \"0x123\",\n \"gasLimit\": \"0x1388\",\n \"gasUsed\": \"0x0\",\n \"timestamp\": \"0x55ba4564\",\n \"extraData\": \"0x476574682f4c5649562f76312e302e302f6c696e75782f676f312e342e32\",\n \"mixHash\": \"0x943056aa305aa6d22a3c06110942980342d1f4d4b11c17711961436a0f963ea0\",\n \"nonce\": \"0x29d6547c196e00e0\",\n \"size\": \"0x220\",\n \"uncles\": [],\n \"transactions\": []\n}\n\n\"#]]);\n});\n\n// test for cast_rpc with raw params\ncasttest!(rpc_raw_params, |_prj, cmd| {\n let eth_rpc_url = next_http_rpc_endpoint();\n\n // Call `cast rpc eth_getBlockByNumber --raw '[\"0x123\", false]'`\n cmd.args([\n \"rpc\",\n \"--rpc-url\",\n eth_rpc_url.as_str(),\n \"eth_getBlockByNumber\",\n \"--raw\",\n r#\"[\"0x123\", false]\"#,\n ])\n .assert_json_stdout(str![[r#\"\n{\"number\":\"0x123\",\"hash\":\"0xc5dab4e189004a1312e9db43a40abb2de91ad7dd25e75880bf36016d8e9df524\",\"transactions\":[],\"logsBloom\":\"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\"receiptsRoot\":\"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\"extraData\":\"0x476574682f4c5649562f76312e302e302f6c696e75782f676f312e342e32\",\"nonce\":\"0x29d6547c196e00e0\",\"miner\":\"0xbb7b8287f3f0a933474a79eae42cbca977791171\",\"difficulty\":\"0x494433b31\",\"gasLimit\":\"0x1388\",\"gasUsed\":\"0x0\",\"uncles\":[],\"sha3Uncles\":\"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\"size\":\"0x220\",\"transactionsRoot\":\"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\"stateRoot\":\"0x3fe6bd17aa85376c7d566df97d9f2e536f37f7a87abb3a6f9e2891cf9442f2e4\",\"mixHash\":\"0x943056aa305aa6d22a3c06110942980342d1f4d4b11c17711961436a0f963ea0\",\"parentHash\":\"0x7abfd11e862ccde76d6ea8ee20978aac26f4bcb55de1188cc0335be13e817017\",\"timestamp\":\"0x55ba4564\"}\n\n\"#]]);\n});\n\n// test for cast_rpc with direct params\ncasttest!(rpc_raw_params_stdin, |_prj, cmd| {\n let eth_rpc_url = next_http_rpc_endpoint();\n\n // Call `echo \"\\n[\\n\\\"0x123\\\",\\nfalse\\n]\\n\" | cast rpc eth_getBlockByNumber --raw\n cmd.args([\"rpc\", \"--rpc-url\", eth_rpc_url.as_str(), \"eth_getBlockByNumber\", \"--raw\"]).stdin(\n b\"\\n[\\n\\\"0x123\\\",\\nfalse\\n]\\n\"\n )\n .assert_json_stdout(str![[r#\"\n{\"number\":\"0x123\",\"hash\":\"0xc5dab4e189004a1312e9db43a40abb2de91ad7dd25e75880bf36016d8e9df524\",\"transactions\":[],\"logsBloom\":\"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\"receiptsRoot\":\"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\"extraData\":\"0x476574682f4c5649562f76312e302e302f6c696e75782f676f312e342e32\",\"nonce\":\"0x29d6547c196e00e0\",\"miner\":\"0xbb7b8287f3f0a933474a79eae42cbca977791171\",\"difficulty\":\"0x494433b31\",\"gasLimit\":\"0x1388\",\"gasUsed\":\"0x0\",\"uncles\":[],\"sha3Uncles\":\"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\",\"size\":\"0x220\",\"transactionsRoot\":\"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421\",\"stateRoot\":\"0x3fe6bd17aa85376c7d566df97d9f2e536f37f7a87abb3a6f9e2891cf9442f2e4\",\"mixHash\":\"0x943056aa305aa6d22a3c06110942980342d1f4d4b11c17711961436a0f963ea0\",\"parentHash\":\"0x7abfd11e862ccde76d6ea8ee20978aac26f4bcb55de1188cc0335be13e817017\",\"timestamp\":\"0x55ba4564\"}\n\n\"#]]);\n});\n\n// checks `cast calldata` can handle arrays\ncasttest!(calldata_array, |_prj, cmd| {\n cmd.args([\"calldata\", \"propose(string[])\", \"[\\\"\\\"]\"]).assert_success().stdout_eq(str![[r#\"\n0xcde2baba0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000000\n\n\"#]]);\n});\n\n// \ncasttest!(run_succeeds, |_prj, cmd| {\n let rpc = next_http_archive_rpc_url();\n cmd.args([\n \"run\",\n \"-v\",\n \"0x2d951c5c95d374263ca99ad9c20c9797fc714330a8037429a3aa4c83d456f845\",\n \"--quick\",\n \"--rpc-url\",\n rpc.as_str(),\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n...\nTransaction successfully executed.\n[GAS]\n\n\"#]]);\n});\n\n// tests that `cast --to-base` commands are working correctly.\ncasttest!(to_base, |_prj, cmd| {\n let values = [\n \"1\",\n \"100\",\n \"100000\",\n \"115792089237316195423570985008687907853269984665640564039457584007913129639935\",\n \"0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff\",\n \"-1\",\n \"-100\",\n \"-100000\",\n \"-57896044618658097711785492504343953926634992332820282019728792003956564819968\",\n ];\n for value in values {\n for subcmd in [\"--to-base\", \"--to-hex\", \"--to-dec\"] {\n if subcmd == \"--to-base\" {\n for base in [\"bin\", \"oct\", \"dec\", \"hex\"] {\n cmd.cast_fuse().args([subcmd, value, base]);\n assert!(!cmd.assert_success().get_output().stdout_lossy().trim().is_empty());\n }\n } else {\n cmd.cast_fuse().args([subcmd, value]);\n assert!(!cmd.assert_success().get_output().stdout_lossy().trim().is_empty());\n }\n }\n }\n});\n\n// tests that revert reason is only present if transaction has reverted.\n\ncasttest!(receipt_revert_reason, |_prj, cmd| {\n let rpc = next_http_archive_rpc_url();\n\n // \n cmd.args([\n \"receipt\",\n \"0x44f2aaa351460c074f2cb1e5a9e28cbc7d83f33e425101d2de14331c7b7ec31e\",\n \"--rpc-url\",\n rpc.as_str(),\n ])\n .assert_success()\n .stdout_eq(format!(r#\"\nblockHash 0x2cfe65be49863676b6dbc04d58176a14f39b123f1e2f4fea0383a2d82c2c50d0\nblockNumber 16239315\ncontractAddress {}\ncumulativeGasUsed 10743428\neffectiveGasPrice 10539984136\nfrom 0x199D5ED7F45F4eE35960cF22EAde2076e95B253F\ngasUsed 21000\nlogs []\nlogsBloom 0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\nroot {}\nstatus 1 (success)\ntransactionHash 0x44f2aaa351460c074f2cb1e5a9e28cbc7d83f33e425101d2de14331c7b7ec31e\ntransactionIndex 116\ntype 0\nblobGasPrice {}\nblobGasUsed {}\nto 0x91da5bf3F8Eb72724E6f50Ec6C3D199C6355c59c\n\"#,\"\", \"\", \"\", \"\"));\n\n let rpc = next_http_archive_rpc_url();\n\n // \n cmd.cast_fuse()\n .args([\n \"receipt\",\n \"0x0e07d8b53ed3d91314c80e53cf25bcde02084939395845cbb625b029d568135c\",\n \"--rpc-url\",\n rpc.as_str(),\n ])\n .assert_success()\n .stdout_eq(format!(r#\"\nblockHash 0x883f974b17ca7b28cb970798d1c80f4d4bb427473dc6d39b2a7fe24edc02902d\nblockNumber 14839405\ncontractAddress {}\ncumulativeGasUsed 20273649\neffectiveGasPrice 21491736378\nfrom 0x3cF412d970474804623bb4e3a42dE13F9bCa5436\ngasUsed 24952\nlogs []\nlogsBloom 0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\nroot {}\nstatus 0 (failed)\ntransactionHash 0x0e07d8b53ed3d91314c80e53cf25bcde02084939395845cbb625b029d568135c\ntransactionIndex 173\ntype 2\nblobGasPrice {}\nblobGasUsed {}\nto 0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45\nrevertReason [..]Transaction too old, data: \"0x08c379a0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000135472616e73616374696f6e20746f6f206f6c6400000000000000000000000000\"\n\"#,\"\",\"\",\"\",\"\"));\n});\n// tests that the revert reason is loaded using the correct `from` address.\n// Flaky: Sepolia RPC may not return the revertReason field depending on provider\n// support for debug/trace APIs.\ncasttest!(flaky_revert_reason_from, |_prj, cmd| {\n let rpc = next_rpc_endpoint(NamedChain::Sepolia);\n // https://sepolia.etherscan.io/tx/0x10ee70cf9f5ced5c515e8d53bfab5ea9f5c72cd61b25fba455c8355ee286c4e4\n cmd.args([\n \"receipt\",\n \"0x10ee70cf9f5ced5c515e8d53bfab5ea9f5c72cd61b25fba455c8355ee286c4e4\",\n \"--rpc-url\",\n rpc.as_str(),\n ])\n .assert_success()\n .stdout_eq(format!(r#\"\nblockHash 0x32663d7730c9ea8e1de6d99854483e25fcc05bb56c91c0cc82f9f04944fbffc1\nblockNumber 7823353\ncontractAddress {}\ncumulativeGasUsed 7500797\neffectiveGasPrice 14296851013\nfrom 0x3583fF95f96b356d716881C871aF7Eb55ea34a93\ngasUsed 25815\nlogs []\nlogsBloom 0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\nroot {}\nstatus 0 (failed)\ntransactionHash 0x10ee70cf9f5ced5c515e8d53bfab5ea9f5c72cd61b25fba455c8355ee286c4e4\ntransactionIndex 96\ntype 0\nblobGasPrice {}\nblobGasUsed {}\nto 0x91b5d4111a4C038153b24e31F75ccdC47123595d\n...\n\"#, \"\", \"\", \"\", \"\"));\n});\n\n// tests that `cast --parse-bytes32-address` command is working correctly.\ncasttest!(parse_bytes32_address, |_prj, cmd| {\n cmd.args([\n \"--parse-bytes32-address\",\n \"0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\n\n\"#]]);\n});\n\ncasttest!(access_list, |_prj, cmd| {\n let rpc = next_http_rpc_endpoint();\n cmd.args([\n \"access-list\",\n \"0xbb2b8038a1640196fbe3e38816f3e67cba72d940\",\n \"skim(address)\",\n \"0xbb2b8038a1640196fbe3e38816f3e67cba72d940\",\n \"--rpc-url\",\n rpc.as_str(),\n \"--gas-limit\", // need to set this for alchemy.io to avoid \"intrinsic gas too low\" error\n \"100000\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n[GAS]\naccess list:\n- address: [..]\n keys:\n...\n- address: [..]\n keys:\n...\n- address: [..]\n keys:\n...\n\n\"#]]);\n});\n\ncasttest!(logs_topics, |_prj, cmd| {\n let rpc = next_http_archive_rpc_url();\n cmd.args([\n \"logs\",\n \"--rpc-url\",\n rpc.as_str(),\n \"--from-block\",\n \"12421181\",\n \"--to-block\",\n \"12421182\",\n \"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef\",\n \"0x000000000000000000000000ab5801a7d398351b8be11c439e05c5b3259aec9b\",\n ])\n .assert_success()\n .stdout_eq(file![\"../fixtures/cast_logs.stdout\"]);\n});\n\ncasttest!(logs_topic_2, |_prj, cmd| {\n let rpc = next_http_archive_rpc_url();\n cmd.args([\n \"logs\",\n \"--rpc-url\",\n rpc.as_str(),\n \"--from-block\",\n \"12421181\",\n \"--to-block\",\n \"12421182\",\n \"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef\",\n \"\",\n \"0x00000000000000000000000068a99f89e475a078645f4bac491360afe255dff1\", /* Filter on the\n * `to` address */\n ])\n .assert_success()\n .stdout_eq(file![\"../fixtures/cast_logs.stdout\"]);\n});\n\ncasttest!(logs_sig, |_prj, cmd| {\n let rpc = next_http_archive_rpc_url();\n cmd.args([\n \"logs\",\n \"--rpc-url\",\n rpc.as_str(),\n \"--from-block\",\n \"12421181\",\n \"--to-block\",\n \"12421182\",\n \"Transfer(address indexed from, address indexed to, uint256 value)\",\n \"0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B\",\n ])\n .assert_success()\n .stdout_eq(file![\"../fixtures/cast_logs.stdout\"]);\n});\n\ncasttest!(logs_sig_2, |_prj, cmd| {\n let rpc = next_http_archive_rpc_url();\n cmd.args([\n \"logs\",\n \"--rpc-url\",\n rpc.as_str(),\n \"--from-block\",\n \"12421181\",\n \"--to-block\",\n \"12421182\",\n \"Transfer(address indexed from, address indexed to, uint256 value)\",\n \"\",\n \"0x68A99f89E475a078645f4BAC491360aFe255Dff1\",\n ])\n .assert_success()\n .stdout_eq(file![\"../fixtures/cast_logs.stdout\"]);\n});\n\ncasttest!(logs_chunked_large_range, |_prj, cmd| {\n let rpc = next_http_archive_rpc_url();\n cmd.args([\n \"logs\",\n \"--rpc-url\",\n rpc.as_str(),\n \"--from-block\",\n \"18000000\",\n \"--to-block\",\n \"18050000\",\n \"--query-size\",\n \"1000\",\n \"Transfer(address indexed from, address indexed to, uint256 value)\",\n \"0xA0b86a33E6441d02dd8C6B2b7E5D1E3eD7F73b4b\",\n ])\n .assert_success();\n});\n\ncasttest!(mktx, |_prj, cmd| {\n cmd.args([\n \"mktx\",\n \"--private-key\",\n \"0x0000000000000000000000000000000000000000000000000000000000000001\",\n \"--chain\",\n \"1\",\n \"--nonce\",\n \"0\",\n \"--value\",\n \"100\",\n \"--gas-limit\",\n \"21000\",\n \"--gas-price\",\n \"10000000000\",\n \"--priority-gas-price\",\n \"1000000000\",\n \"0x0000000000000000000000000000000000000001\",\n ]).assert_success().stdout_eq(str![[r#\"\n0x02f86b0180843b9aca008502540be4008252089400000000000000000000000000000000000000016480c001a070d55e79ed3ac9fc8f51e78eb91fd054720d943d66633f2eb1bc960f0126b0eca052eda05a792680de3181e49bab4093541f75b49d1ecbe443077b3660c836016a\n\n\"#]]);\n});\n\n// ensure recipient or code is required\ncasttest!(mktx_requires_to, |_prj, cmd| {\n cmd.args([\n \"mktx\",\n \"--private-key\",\n \"0x0000000000000000000000000000000000000000000000000000000000000001\",\n \"--chain\",\n \"1\",\n ]);\n cmd.assert_failure().stderr_eq(str![[r#\"\nError: Must specify a recipient address or contract code to deploy\n\n\"#]]);\n});\n\ncasttest!(mktx_signer_from_mismatch, |_prj, cmd| {\n cmd.args([\n \"mktx\",\n \"--private-key\",\n \"0x0000000000000000000000000000000000000000000000000000000000000001\",\n \"--from\",\n \"0x0000000000000000000000000000000000000001\",\n \"--chain\",\n \"1\",\n \"0x0000000000000000000000000000000000000001\",\n ]);\n cmd.assert_failure().stderr_eq(str![[r#\"\nError: The specified sender via CLI/env vars does not match the sender configured via\nthe hardware wallet's HD Path.\nPlease use the `--hd-path ` parameter to specify the BIP32 Path which\ncorresponds to the sender, or let foundry automatically detect it by not specifying any sender address.\n\n\"#]]);\n});\n\ncasttest!(mktx_signer_from_match, |_prj, cmd| {\n cmd.args([\n \"mktx\",\n \"--private-key\",\n \"0x0000000000000000000000000000000000000000000000000000000000000001\",\n \"--from\",\n \"0x7E5F4552091A69125d5DfCb7b8C2659029395Bdf\",\n \"--chain\",\n \"1\",\n \"--nonce\",\n \"0\",\n \"--gas-limit\",\n \"21000\",\n \"--gas-price\",\n \"10000000000\",\n \"--priority-gas-price\",\n \"1000000000\",\n \"0x0000000000000000000000000000000000000001\",\n ]).assert_success().stdout_eq(str![[r#\"\n0x02f86b0180843b9aca008502540be4008252089400000000000000000000000000000000000000018080c001a0cce9a61187b5d18a89ecd27ec675e3b3f10d37f165627ef89a15a7fe76395ce8a07537f5bffb358ffbef22cda84b1c92f7211723f9e09ae037e81686805d3e5505\n\n\"#]]);\n});\n\ncasttest!(mktx_raw_unsigned, |_prj, cmd| {\n cmd.args([\n \"mktx\",\n \"--from\",\n \"0x7E5F4552091A69125d5DfCb7b8C2659029395Bdf\",\n \"--chain\",\n \"1\",\n \"--nonce\",\n \"0\",\n \"--gas-limit\",\n \"21000\",\n \"--gas-price\",\n \"10000000000\",\n \"--priority-gas-price\",\n \"1000000000\",\n \"0x0000000000000000000000000000000000000001\",\n \"--raw-unsigned\",\n ])\n .assert_success()\n .stdout_eq(str![[\n r#\"0x02e80180843b9aca008502540be4008252089400000000000000000000000000000000000000018080c0\n\n\"#\n ]]);\n});\n\ncasttest!(mktx_raw_unsigned_no_from_missing_chain, async |_prj, cmd| {\n // As chain is not provided, a query is made to the provider to get the chain id, before the\n // tx is built. Anvil is configured to use chain id 1 so that the produced tx will\n // be the same as in the `mktx_raw_unsigned` test.\n let (_, handle) = anvil::spawn(NodeConfig::test().with_chain_id(Some(1u64))).await;\n cmd.args([\n \"mktx\",\n \"--nonce\",\n \"0\",\n \"--gas-limit\",\n \"21000\",\n \"--gas-price\",\n \"10000000000\",\n \"--priority-gas-price\",\n \"1000000000\",\n \"0x0000000000000000000000000000000000000001\",\n \"--raw-unsigned\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n ])\n .assert_success()\n .stdout_eq(str![[\n r#\"0x02e80180843b9aca008502540be4008252089400000000000000000000000000000000000000018080c0\n\n\"#\n ]]);\n});\n\ncasttest!(mktx_raw_unsigned_no_from_missing_gas_pricing, async |_prj, cmd| {\n let (_, handle) = anvil::spawn(NodeConfig::test()).await;\n cmd.args([\n \"mktx\",\n \"--nonce\",\n \"0\",\n \"0x0000000000000000000000000000000000000001\",\n \"--raw-unsigned\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n ])\n .assert_success()\n .stdout_eq(str![[\n r#\"0x02e5827a69800184773594018252089400000000000000000000000000000000000000018080c0\n\n\"#\n ]]);\n});\n\ncasttest!(mktx_raw_unsigned_no_from_missing_nonce, |_prj, cmd| {\n cmd.args([\n \"mktx\",\n \"--chain\",\n \"1\",\n \"--gas-limit\",\n \"21000\",\n \"--gas-price\",\n \"20000000000\",\n \"0x742d35Cc6634C0532925a3b8D6Ac6F67C9c2b7FD\",\n \"--raw-unsigned\",\n ])\n .assert_failure()\n .stderr_eq(str![[\n r#\"Error: Missing required parameters for raw unsigned transaction. When --from is not provided, you must specify: --nonce\n\n\"#\n ]]);\n});\n\ncasttest!(mktx_ethsign, async |_prj, cmd| {\n let (_api, handle) = anvil::spawn(NodeConfig::test()).await;\n let rpc = handle.http_endpoint();\n cmd.args([\n \"mktx\",\n \"--from\",\n \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\",\n \"--chain\",\n \"31337\",\n \"--nonce\",\n \"0\",\n \"--gas-limit\",\n \"21000\",\n \"--gas-price\",\n \"10000000000\",\n \"--priority-gas-price\",\n \"1000000000\",\n \"0x0000000000000000000000000000000000000001\",\n \"--ethsign\",\n \"--rpc-url\",\n rpc.as_str(),\n ])\n .assert_success()\n .stdout_eq(str![[\n r#\"\n0x02f86d827a6980843b9aca008502540be4008252089400000000000000000000000000000000000000018080c001a0b8eeb1ded87b085859c510c5692bed231e3ee8b068ccf71142bbf28da0e95987a07813b676a248ae8055f28495021d78dee6695479d339a6ad9d260d9eaf20674c\n\n\"#\n ]]);\n});\n\n// tests that the raw encoded transaction is returned\ncasttest!(tx_raw, |_prj, cmd| {\n let rpc = next_http_rpc_endpoint();\n\n // \n cmd.args([\n \"tx\",\n \"0x44f2aaa351460c074f2cb1e5a9e28cbc7d83f33e425101d2de14331c7b7ec31e\",\n \"raw\",\n \"--rpc-url\",\n rpc.as_str(),\n ]).assert_success().stdout_eq(str![[r#\"\n0xf86d824c548502743b65088275309491da5bf3f8eb72724e6f50ec6c3d199c6355c59c87a0a73f33e9e4cc8025a0428518b1748a08bbeb2392ea055b418538944d30adfc2accbbfa8362a401d3a4a07d6093ab2580efd17c11b277de7664fce56e6953cae8e925bec3313399860470\n\n\"#]]);\n\n // \n cmd.cast_fuse().args([\n \"tx\",\n \"0x44f2aaa351460c074f2cb1e5a9e28cbc7d83f33e425101d2de14331c7b7ec31e\",\n \"--raw\",\n \"--rpc-url\",\n rpc.as_str(),\n ]).assert_success().stdout_eq(str![[r#\"\n0xf86d824c548502743b65088275309491da5bf3f8eb72724e6f50ec6c3d199c6355c59c87a0a73f33e9e4cc8025a0428518b1748a08bbeb2392ea055b418538944d30adfc2accbbfa8362a401d3a4a07d6093ab2580efd17c11b277de7664fce56e6953cae8e925bec3313399860470\n\n\"#]]);\n});\n\ncasttest!(tx_to_request_json, |_prj, cmd| {\n let rpc = next_http_rpc_endpoint();\n\n // \n cmd.args([\n \"tx\",\n \"0x44f2aaa351460c074f2cb1e5a9e28cbc7d83f33e425101d2de14331c7b7ec31e\",\n \"--to-request\",\n \"--rpc-url\",\n rpc.as_str(),\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n{\n \"from\": \"0x199d5ed7f45f4ee35960cf22eade2076e95b253f\",\n \"to\": \"0x91da5bf3f8eb72724e6f50ec6c3d199c6355c59c\",\n \"gasPrice\": \"0x2743b6508\",\n \"gas\": \"0x7530\",\n \"value\": \"0xa0a73f33e9e4cc\",\n \"input\": \"0x\",\n \"nonce\": \"0x4c54\",\n \"chainId\": \"0x1\",\n \"type\": \"0x0\"\n}\n\n\"#]]);\n});\n\ncasttest!(tx_using_sender_and_nonce, |_prj, cmd| {\n let rpc = next_http_archive_rpc_url();\n // \n let args = vec![\n \"tx\",\n \"--from\",\n \"0x4648451b5F87FF8F0F7D622bD40574bb97E25980\",\n \"--nonce\",\n \"113642\",\n \"--rpc-url\",\n rpc.as_str(),\n ];\n cmd.args(args).assert_success().stdout_eq(str![[r#\"\n\nblockHash 0x29518c1cea251b1bda5949a9b039722604ec1fb99bf9d8124cfe001c95a50bdc\nblockNumber 22287055\nfrom 0x4648451b5F87FF8F0F7D622bD40574bb97E25980\ntransactionIndex 230\neffectiveGasPrice 363392048\nhash 0x5bcd22734cca2385dc25b2d38a3d33a640c5961bd46d390dff184c894204b594\ntype 2\nchainId 1\nnonce 113642\ngasLimit 350000\nmaxFeePerGas 675979146\nmaxPriorityFeePerGas 1337\nto 0xdAC17F958D2ee523a2206206994597C13D831ec7\nvalue 0\naccessList []\ninput 0xa9059cbb000000000000000000000000568766d218d82333dd4dae933ddfcda5da26625000000000000000000000000000000000000000000000000000000000cc3ed109\nr 0x1e92d3e1ca69109a1743fc4b3cf9dff58630bc9f429cea3c3fe311506264e36c\ns 0x793947d4bbdce56a1a5b2b3525c46f01569414a22355f4883b5429668ab0f51a\nyParity 1\n...\n\"#]]);\n});\n\n// ensure receipt or code is required\ncasttest!(send_requires_to, |_prj, cmd| {\n cmd.args([\n \"send\",\n \"--private-key\",\n \"0x0000000000000000000000000000000000000000000000000000000000000001\",\n \"--chain\",\n \"1\",\n ]);\n cmd.assert_failure().stderr_eq(str![[r#\"\nError: Must specify a recipient address or contract code to deploy\n\n\"#]]);\n});\n\n// \ncasttest!(send_7702_conflicts_with_create, |_prj, cmd| {\n cmd.args([\n \"send\", \"--private-key\", \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\" ,\"--auth\", \"0xf85c827a6994f39fd6e51aad88f6f4ce6ab8827279cfffb922668001a03e1a66234e71242afcc7bc46c8950c3b2997b102db257774865f1232d2e7bf48a045e252dad189b27b2306792047745eba86bff0dd18aca813dbf3fba8c4e94576\", \"--create\", \"0x60806040523373ffffffffffffffffffffffffffffffffffffffff163273ffffffffffffffffffffffffffffffffffffffff1614610072576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610069906100e5565b60405180910390fd5b3373ffffffffffffffffffffffffffffffffffffffff16ff5b5f82825260208201905092915050565b7f74782e6f726967696e203d3d206d73672e73656e6465720000000000000000005f82015250565b5f6100cf60178361008b565b91506100da8261009b565b602082019050919050565b5f6020820190508181035f8301526100fc816100c3565b905091905056fe\"\n ]);\n cmd.assert_failure().stderr_eq(str![[r#\"\nError: EIP-7702 transactions can't be CREATE transactions and require a destination address\n\n\"#]]);\n});\n\ncasttest!(storage, |_prj, cmd| {\n let rpc = next_http_archive_rpc_url();\n cmd.args([\"storage\", \"vitalik.eth\", \"1\", \"--rpc-url\", &rpc]).assert_success().stdout_eq(str![\n [r#\"\n0x0000000000000000000000000000000000000000000000000000000000000000\n\n\"#]\n ]);\n\n let rpc = next_http_archive_rpc_url();\n cmd.cast_fuse()\n .args([\"storage\", \"vitalik.eth\", \"0x01\", \"--rpc-url\", &rpc])\n .assert_success()\n .stdout_eq(str![[r#\"\n0x0000000000000000000000000000000000000000000000000000000000000000\n\n\"#]]);\n\n let rpc = next_http_archive_rpc_url();\n let usdt = \"0xdac17f958d2ee523a2206206994597c13d831ec7\";\n let decimals_slot = \"0x09\";\n cmd.cast_fuse()\n .args([\"storage\", usdt, decimals_slot, \"--rpc-url\", &rpc])\n .assert_success()\n .stdout_eq(str![[r#\"\n0x0000000000000000000000000000000000000000000000000000000000000006\n\n\"#]]);\n\n let rpc = next_http_archive_rpc_url();\n let total_supply_slot = \"0x01\";\n let block_before = \"4634747\";\n let block_after = \"4634748\";\n cmd.cast_fuse()\n .args([\"storage\", usdt, total_supply_slot, \"--rpc-url\", &rpc, \"--block\", block_before])\n .assert_success()\n .stdout_eq(str![[r#\"\n0x0000000000000000000000000000000000000000000000000000000000000000\n\n\"#]]);\n\n let rpc = next_http_archive_rpc_url();\n cmd.cast_fuse()\n .args([\"storage\", usdt, total_supply_slot, \"--rpc-url\", &rpc, \"--block\", block_after])\n .assert_success()\n .stdout_eq(str![[r#\"\n0x000000000000000000000000000000000000000000000000000000174876e800\n\n\"#]]);\n\n let decimal_slot_offset_from_total_supply_slot = \"0x08\";\n let decimal_slot_offset_from_total_supply_slot_uint = \"8\";\n let rpc = next_http_archive_rpc_url();\n cmd.cast_fuse()\n .args([\n \"storage\",\n usdt,\n total_supply_slot,\n decimal_slot_offset_from_total_supply_slot,\n \"--rpc-url\",\n &rpc,\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n0x0000000000000000000000000000000000000000000000000000000000000006\n\n\"#]]);\n\n let rpc = next_http_archive_rpc_url();\n cmd.cast_fuse()\n .args([\n \"storage\",\n usdt,\n total_supply_slot,\n decimal_slot_offset_from_total_supply_slot_uint,\n \"--rpc-url\",\n &rpc,\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n0x0000000000000000000000000000000000000000000000000000000000000006\n\n\"#]]);\n});\n\ncasttest!(flaky_storage_with_valid_solc_version_1, |_prj, cmd| {\n cmd.args([\n \"storage\",\n \"0x13b0D85CcB8bf860b6b79AF3029fCA081AE9beF2\",\n \"--solc-version\",\n \"0.8.10\",\n \"--rpc-url\",\n next_http_archive_rpc_url().as_str(),\n \"--etherscan-api-key\",\n next_etherscan_api_key().as_str(),\n ])\n .assert_success();\n});\n\ncasttest!(flaky_storage_with_valid_solc_version_2, |_prj, cmd| {\n cmd.args([\n \"storage\",\n \"0x13b0D85CcB8bf860b6b79AF3029fCA081AE9beF2\",\n \"--solc-version\",\n \"0.8.23\",\n \"--rpc-url\",\n next_http_archive_rpc_url().as_str(),\n \"--etherscan-api-key\",\n next_etherscan_api_key().as_str(),\n ])\n .assert_success();\n});\n\ncasttest!(flaky_storage_with_invalid_solc_version_1, |_prj, cmd| {\n let output = cmd\n .args([\n \"storage\",\n \"0x13b0D85CcB8bf860b6b79AF3029fCA081AE9beF2\",\n \"--solc-version\",\n \"0.4.0\",\n \"--rpc-url\",\n next_http_archive_rpc_url().as_str(),\n \"--etherscan-api-key\",\n next_etherscan_api_key().as_str(),\n ])\n .assert_failure()\n .get_output()\n .stderr\n .clone();\n let stderr = String::from_utf8_lossy(&output);\n assert!(\n stderr.contains(\n \"Warning: The provided --solc-version is 0.4.0 while the minimum version for storage layouts is 0.6.5\"\n ),\n \"stderr did not contain expected warning. Full stderr:\\n{stderr}\"\n );\n});\n\ncasttest!(flaky_storage_with_invalid_solc_version_2, |_prj, cmd| {\n cmd.args([\n \"storage\",\n \"0x13b0D85CcB8bf860b6b79AF3029fCA081AE9beF2\",\n \"--solc-version\",\n \"0.8.2\",\n \"--rpc-url\",\n next_http_archive_rpc_url().as_str(),\n \"--etherscan-api-key\",\n next_etherscan_api_key().as_str(),\n ])\n .assert_failure()\n .stderr_eq(str![[r#\"\nError: Encountered invalid solc version in contracts/Create2Deployer.sol: No solc version exists that matches the version requirement: ^0.8.9\n\n\"#]]);\n});\n\n// \ncasttest!(flaky_storage_layout_simple, |_prj, cmd| {\n cmd.args([\n \"storage\",\n \"--rpc-url\",\n next_http_archive_rpc_url().as_str(),\n \"--block\",\n \"21034138\",\n \"--etherscan-api-key\",\n next_etherscan_api_key().as_str(),\n \"0x13b0D85CcB8bf860b6b79AF3029fCA081AE9beF2\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n\nā•­---------+---------+------+--------+-------+-------+--------------------------------------------------------------------+-----------------------------------------------ā•®\n| Name | Type | Slot | Offset | Bytes | Value | Hex Value | Contract |\n+========================================================================================================================================================================+\n| _owner | address | 0 | 0 | 20 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/Create2Deployer.sol:Create2Deployer |\n|---------+---------+------+--------+-------+-------+--------------------------------------------------------------------+-----------------------------------------------|\n| _paused | bool | 0 | 20 | 1 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/Create2Deployer.sol:Create2Deployer |\nā•°---------+---------+------+--------+-------+-------+--------------------------------------------------------------------+-----------------------------------------------ā•Æ\n\n\n\"#]]);\n});\n\n// \ncasttest!(flaky_storage_layout_simple_json, |_prj, cmd| {\n cmd.args([\n \"storage\",\n \"--rpc-url\",\n next_http_archive_rpc_url().as_str(),\n \"--block\",\n \"21034138\",\n \"--etherscan-api-key\",\n next_etherscan_api_key().as_str(),\n \"0x13b0D85CcB8bf860b6b79AF3029fCA081AE9beF2\",\n \"--json\",\n ])\n .assert_success()\n .stdout_eq(file![\"../fixtures/storage_layout_simple.json\": Json]);\n});\n\n// \ncasttest!(flaky_storage_layout_complex, |_prj, cmd| {\n cmd.args([\n \"storage\",\n \"--rpc-url\",\n next_http_archive_rpc_url().as_str(),\n \"--block\",\n \"21034138\",\n \"--etherscan-api-key\",\n next_etherscan_api_key().as_str(),\n \"0xBA12222222228d8Ba445958a75a0704d566BF2C8\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n\nā•­-------------------------------+--------------------------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+---------------------------------ā•®\n| Name | Type | Slot | Offset | Bytes | Value | Hex Value | Contract |\n+======================================================================================================================================================================================================================================================================================+\n| _status | uint256 | 0 | 0 | 32 | 1 | 0x0000000000000000000000000000000000000000000000000000000000000001 | contracts/vault/Vault.sol:Vault |\n|-------------------------------+--------------------------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+---------------------------------|\n| _generalPoolsBalances | mapping(bytes32 => struct EnumerableMap.IERC20ToBytes32Map) | 1 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/vault/Vault.sol:Vault |\n|-------------------------------+--------------------------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+---------------------------------|\n| _nextNonce | mapping(address => uint256) | 2 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/vault/Vault.sol:Vault |\n|-------------------------------+--------------------------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+---------------------------------|\n| _paused | bool | 3 | 0 | 1 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/vault/Vault.sol:Vault |\n|-------------------------------+--------------------------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+---------------------------------|\n| _authorizer | contract IAuthorizer | 3 | 1 | 20 | 549683469959765988649777481110995959958745616871 | 0x0000000000000000000000006048a8c631fb7e77eca533cf9c29784e482391e7 | contracts/vault/Vault.sol:Vault |\n|-------------------------------+--------------------------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+---------------------------------|\n| _approvedRelayers | mapping(address => mapping(address => bool)) | 4 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/vault/Vault.sol:Vault |\n|-------------------------------+--------------------------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+---------------------------------|\n| _isPoolRegistered | mapping(bytes32 => bool) | 5 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/vault/Vault.sol:Vault |\n|-------------------------------+--------------------------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+---------------------------------|\n| _nextPoolNonce | uint256 | 6 | 0 | 32 | 1760 | 0x00000000000000000000000000000000000000000000000000000000000006e0 | contracts/vault/Vault.sol:Vault |\n|-------------------------------+--------------------------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+---------------------------------|\n| _minimalSwapInfoPoolsBalances | mapping(bytes32 => mapping(contract IERC20 => bytes32)) | 7 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/vault/Vault.sol:Vault |\n|-------------------------------+--------------------------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+---------------------------------|\n| _minimalSwapInfoPoolsTokens | mapping(bytes32 => struct EnumerableSet.AddressSet) | 8 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/vault/Vault.sol:Vault |\n|-------------------------------+--------------------------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+---------------------------------|\n| _twoTokenPoolTokens | mapping(bytes32 => struct TwoTokenPoolsBalance.TwoTokenPoolTokens) | 9 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/vault/Vault.sol:Vault |\n|-------------------------------+--------------------------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+---------------------------------|\n| _poolAssetManagers | mapping(bytes32 => mapping(contract IERC20 => address)) | 10 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/vault/Vault.sol:Vault |\n|-------------------------------+--------------------------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+---------------------------------|\n| _internalTokenBalance | mapping(address => mapping(contract IERC20 => uint256)) | 11 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/vault/Vault.sol:Vault |\nā•°-------------------------------+--------------------------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+---------------------------------ā•Æ\n\n\n\"#]]);\n});\n\ncasttest!(flaky_storage_layout_complex_md, |_prj, cmd| {\n cmd.args([\n \"storage\",\n \"--rpc-url\",\n next_http_archive_rpc_url().as_str(),\n \"--block\",\n \"21034138\",\n \"--etherscan-api-key\",\n next_etherscan_api_key().as_str(),\n \"0xBA12222222228d8Ba445958a75a0704d566BF2C8\",\n \"--md\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n\n| Name | Type | Slot | Offset | Bytes | Value | Hex Value | Contract |\n|-------------------------------|--------------------------------------------------------------------|------|--------|-------|--------------------------------------------------|--------------------------------------------------------------------|---------------------------------|\n| _status | uint256 | 0 | 0 | 32 | 1 | 0x0000000000000000000000000000000000000000000000000000000000000001 | contracts/vault/Vault.sol:Vault |\n| _generalPoolsBalances | mapping(bytes32 => struct EnumerableMap.IERC20ToBytes32Map) | 1 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/vault/Vault.sol:Vault |\n| _nextNonce | mapping(address => uint256) | 2 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/vault/Vault.sol:Vault |\n| _paused | bool | 3 | 0 | 1 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/vault/Vault.sol:Vault |\n| _authorizer | contract IAuthorizer | 3 | 1 | 20 | 549683469959765988649777481110995959958745616871 | 0x0000000000000000000000006048a8c631fb7e77eca533cf9c29784e482391e7 | contracts/vault/Vault.sol:Vault |\n| _approvedRelayers | mapping(address => mapping(address => bool)) | 4 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/vault/Vault.sol:Vault |\n| _isPoolRegistered | mapping(bytes32 => bool) | 5 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/vault/Vault.sol:Vault |\n| _nextPoolNonce | uint256 | 6 | 0 | 32 | 1760 | 0x00000000000000000000000000000000000000000000000000000000000006e0 | contracts/vault/Vault.sol:Vault |\n| _minimalSwapInfoPoolsBalances | mapping(bytes32 => mapping(contract IERC20 => bytes32)) | 7 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/vault/Vault.sol:Vault |\n| _minimalSwapInfoPoolsTokens | mapping(bytes32 => struct EnumerableSet.AddressSet) | 8 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/vault/Vault.sol:Vault |\n| _twoTokenPoolTokens | mapping(bytes32 => struct TwoTokenPoolsBalance.TwoTokenPoolTokens) | 9 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/vault/Vault.sol:Vault |\n| _poolAssetManagers | mapping(bytes32 => mapping(contract IERC20 => address)) | 10 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/vault/Vault.sol:Vault |\n| _internalTokenBalance | mapping(address => mapping(contract IERC20 => uint256)) | 11 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/vault/Vault.sol:Vault |\n\n\n\"#]]);\n});\n\ncasttest!(flaky_storage_layout_complex_proxy, |_prj, cmd| {\n cmd.args([\n \"storage\",\n \"--rpc-url\",\n next_rpc_endpoint(NamedChain::Sepolia).as_str(),\n \"--block\",\n \"7857852\",\n \"--etherscan-api-key\",\n next_etherscan_api_key().as_str(),\n \"0xE2588A9CAb7Ea877206E35f615a39f84a64A7A3b\",\n \"--proxy\",\n \"0x29fcb43b46531bca003ddc8fcb67ffe91900c762\"\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n\nā•­----------------------------+-------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+-----------------------------ā•®\n| Name | Type | Slot | Offset | Bytes | Value | Hex Value | Contract |\n+============================================================================================================================================================================================================================================================+\n| singleton | address | 0 | 0 | 20 | 239704109775411986678417050956533140837380441954 | 0x00000000000000000000000029fcb43b46531bca003ddc8fcb67ffe91900c762 | contracts/SafeL2.sol:SafeL2 |\n|----------------------------+-------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+-----------------------------|\n| modules | mapping(address => address) | 1 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/SafeL2.sol:SafeL2 |\n|----------------------------+-------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+-----------------------------|\n| owners | mapping(address => address) | 2 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/SafeL2.sol:SafeL2 |\n|----------------------------+-------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+-----------------------------|\n| ownerCount | uint256 | 3 | 0 | 32 | 1 | 0x0000000000000000000000000000000000000000000000000000000000000001 | contracts/SafeL2.sol:SafeL2 |\n|----------------------------+-------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+-----------------------------|\n| threshold | uint256 | 4 | 0 | 32 | 1 | 0x0000000000000000000000000000000000000000000000000000000000000001 | contracts/SafeL2.sol:SafeL2 |\n|----------------------------+-------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+-----------------------------|\n| nonce | uint256 | 5 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/SafeL2.sol:SafeL2 |\n|----------------------------+-------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+-----------------------------|\n| _deprecatedDomainSeparator | bytes32 | 6 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/SafeL2.sol:SafeL2 |\n|----------------------------+-------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+-----------------------------|\n| signedMessages | mapping(bytes32 => uint256) | 7 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/SafeL2.sol:SafeL2 |\n|----------------------------+-------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+-----------------------------|\n| approvedHashes | mapping(address => mapping(bytes32 => uint256)) | 8 | 0 | 32 | 0 | 0x0000000000000000000000000000000000000000000000000000000000000000 | contracts/SafeL2.sol:SafeL2 |\nā•°----------------------------+-------------------------------------------------+------+--------+-------+--------------------------------------------------+--------------------------------------------------------------------+-----------------------------ā•Æ\n\n\n\"#]]);\n});\n\ncasttest!(flaky_storage_layout_complex_json, |_prj, cmd| {\n cmd.args([\n \"storage\",\n \"--rpc-url\",\n next_http_archive_rpc_url().as_str(),\n \"--block\",\n \"21034138\",\n \"--etherscan-api-key\",\n next_etherscan_api_key().as_str(),\n \"0xBA12222222228d8Ba445958a75a0704d566BF2C8\",\n \"--json\",\n ])\n .assert_success()\n .stdout_eq(file![\"../fixtures/storage_layout_complex.json\": Json]);\n});\n\ncasttest!(balance, |_prj, cmd| {\n let rpc = next_http_rpc_endpoint();\n let dai = \"0x6B175474E89094C44Da98b954EedeAC495271d0F\";\n\n let dai_result = cmd\n .args([\n \"balance\",\n \"0x0000000000000000000000000000000000000000\",\n \"--erc20\",\n dai,\n \"--rpc-url\",\n &rpc,\n ])\n .assert_success()\n .get_output()\n .stdout_lossy()\n .trim()\n .to_string();\n\n let alias_result = cmd\n .cast_fuse()\n .args([\n \"balance\",\n \"0x0000000000000000000000000000000000000000\",\n \"--erc721\",\n dai,\n \"--rpc-url\",\n &rpc,\n ])\n .assert_success()\n .get_output()\n .stdout_lossy()\n .trim()\n .to_string();\n\n assert_ne!(dai_result, \"0\");\n assert_eq!(alias_result, dai_result);\n});\n\n// tests that `cast interface` excludes the constructor\n// \ncasttest!(interface_no_constructor, |prj, cmd| {\n let interface = include_str!(\"../fixtures/interface.json\");\n\n let path = prj.root().join(\"interface.json\");\n fs::write(&path, interface).unwrap();\n // Call `cast find-block`\n cmd.arg(\"interface\").arg(&path).assert_success().stdout_eq(str![[\n r#\"// SPDX-License-Identifier: UNLICENSED\npragma solidity ^0.8.4;\n\nlibrary IIntegrationManager {\n type SpendAssetsHandleType is uint8;\n}\n\ninterface Interface {\n function getIntegrationManager() external view returns (address integrationManager_);\n function lend(address _vaultProxy, bytes memory, bytes memory _assetData) external;\n function parseAssetsForAction(address, bytes4 _selector, bytes memory _actionData)\n external\n view\n returns (\n IIntegrationManager.SpendAssetsHandleType spendAssetsHandleType_,\n address[] memory spendAssets_,\n uint256[] memory spendAssetAmounts_,\n address[] memory incomingAssets_,\n uint256[] memory minIncomingAssetAmounts_\n );\n function redeem(address _vaultProxy, bytes memory, bytes memory _assetData) external;\n}\n\n\"#\n ]]);\n});\n\n// tests that `cast interface --flatten` inlines inherited struct types into the interface\n// \ncasttest!(interface_flatten, |prj, cmd| {\n let interface = include_str!(\"../fixtures/interface_inherited_struct.json\");\n\n let path = prj.root().join(\"interface_inherited_struct.json\");\n fs::write(&path, interface).unwrap();\n\n // Without --flatten, a separate library is generated for the struct\n cmd.arg(\"interface\").arg(&path).assert_success().stdout_eq(str![[\n r#\"// SPDX-License-Identifier: UNLICENSED\npragma solidity ^0.8.4;\n\nlibrary IBase {\n struct TestStruct {\n address asset;\n }\n}\n\ninterface Interface {\n function test(IBase.TestStruct memory param) external;\n}\n\n\"#\n ]]);\n\n // With --flatten, the struct is inlined into the interface\n cmd.cast_fuse().arg(\"interface\").arg(\"--flatten\").arg(&path).assert_success().stdout_eq(str![\n [r#\"// SPDX-License-Identifier: UNLICENSED\npragma solidity ^0.8.4;\n\ninterface Interface {\n // Types from `IBase`\n struct TestStruct {\n address asset;\n }\n\n function test(TestStruct memory param) external;\n}\n\n\"#]\n ]);\n});\n\n// tests that fetches WETH interface from etherscan\n// \ncasttest!(flaky_fetch_weth_interface_from_etherscan, |_prj, cmd| {\n cmd.args([\n \"interface\",\n \"--etherscan-api-key\",\n &next_etherscan_api_key(),\n \"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n// SPDX-License-Identifier: UNLICENSED\npragma solidity ^0.8.4;\n\ninterface WETH9 {\n event Approval(address indexed src, address indexed guy, uint256 wad);\n event Deposit(address indexed dst, uint256 wad);\n event Transfer(address indexed src, address indexed dst, uint256 wad);\n event Withdrawal(address indexed src, uint256 wad);\n\n fallback() external payable;\n\n function allowance(address, address) external view returns (uint256);\n function approve(address guy, uint256 wad) external returns (bool);\n function balanceOf(address) external view returns (uint256);\n function decimals() external view returns (uint8);\n function deposit() external payable;\n function name() external view returns (string memory);\n function symbol() external view returns (string memory);\n function totalSupply() external view returns (uint256);\n function transfer(address dst, uint256 wad) external returns (bool);\n function transferFrom(address src, address dst, uint256 wad) external returns (bool);\n function withdraw(uint256 wad) external;\n}\n\n\"#]]);\n});\n\ncasttest!(ens_namehash, |_prj, cmd| {\n cmd.args([\"namehash\", \"emo.eth\"]).assert_success().stdout_eq(str![[r#\"\n0x0a21aaf2f6414aa664deb341d1114351fdb023cad07bf53b28e57c26db681910\n\n\"#]]);\n});\n\ncasttest!(ens_lookup, |_prj, cmd| {\n let eth_rpc_url = next_http_rpc_endpoint();\n cmd.args([\n \"lookup-address\",\n \"0x28679A1a632125fbBf7A68d850E50623194A709E\",\n \"--rpc-url\",\n ð_rpc_url,\n \"--verify\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\nemo.eth\n\n\"#]]);\n});\n\ncasttest!(ens_resolve, |_prj, cmd| {\n let eth_rpc_url = next_http_rpc_endpoint();\n cmd.args([\"resolve-name\", \"emo.eth\", \"--rpc-url\", ð_rpc_url, \"--verify\"])\n .assert_success()\n .stdout_eq(str![[r#\"\n0x28679A1a632125fbBf7A68d850E50623194A709E\n\n\"#]]);\n});\n\ncasttest!(ens_resolve_no_dot_eth, |_prj, cmd| {\n let eth_rpc_url = next_http_rpc_endpoint();\n cmd.args([\"resolve-name\", \"emo\", \"--rpc-url\", ð_rpc_url, \"--verify\"])\n .assert_failure()\n .stderr_eq(str![[r#\"\nError: ENS resolver not found for name \"emo\"\n\n\"#]]);\n});\n\ncasttest!(index7201, |_prj, cmd| {\n cmd.args([\"index-erc7201\", \"example.main\"]).assert_success().stdout_eq(str![[r#\"\n0x183a6125c38840424c4a85fa12bab2ab606c4b6d0e7cc73c0c06ba5300eab500\n\n\"#]]);\n});\n\ncasttest!(index7201_unknown_formula_id, |_prj, cmd| {\n cmd.args([\"index-erc7201\", \"test\", \"--formula-id\", \"unknown\"]).assert_failure().stderr_eq(\n str![[r#\"\nError: unsupported formula ID: unknown\n\n\"#]],\n );\n});\n\ncasttest!(block_number, |_prj, cmd| {\n let eth_rpc_url = next_http_rpc_endpoint();\n let s = cmd\n .args([\"block-number\", \"--rpc-url\", eth_rpc_url.as_str()])\n .assert_success()\n .get_output()\n .stdout_lossy();\n assert!(s.trim().parse::().unwrap() > 0, \"{s}\")\n});\n\ncasttest!(block_number_latest, |_prj, cmd| {\n let eth_rpc_url = next_http_rpc_endpoint();\n let s = cmd\n .args([\"block-number\", \"--rpc-url\", eth_rpc_url.as_str(), \"latest\"])\n .assert_success()\n .get_output()\n .stdout_lossy();\n assert!(s.trim().parse::().unwrap() > 0, \"{s}\")\n});\n\ncasttest!(block_number_hash, |_prj, cmd| {\n let eth_rpc_url = next_http_rpc_endpoint();\n let s = cmd\n .args([\n \"block-number\",\n \"--rpc-url\",\n eth_rpc_url.as_str(),\n \"0x88e96d4537bea4d9c05d12549907b32561d3bf31f45aae734cdc119f13406cb6\",\n ])\n .assert_success()\n .get_output()\n .stdout_lossy();\n assert_eq!(s.trim().parse::().unwrap(), 1, \"{s}\")\n});\n\n// Tests that `cast --disable-block-gas-limit` commands are working correctly for BSC\n// \n// Equivalent transaction on Binance Smart Chain Testnet:\n// \ncasttest!(run_disable_block_gas_limit_check, |_prj, cmd| {\n let bsc_testnet_rpc_url = next_rpc_endpoint(NamedChain::BinanceSmartChainTestnet);\n\n let latest_block_json: serde_json::Value = serde_json::from_str(\n &cmd.args([\"block\", \"--rpc-url\", bsc_testnet_rpc_url.as_str(), \"--json\"])\n .assert_success()\n .get_output()\n .stdout_lossy(),\n )\n .expect(\"Failed to parse latest block\");\n\n let latest_excessive_gas_limit_tx =\n latest_block_json[\"transactions\"].as_array().and_then(|txs| {\n txs.iter()\n .find(|tx| tx.get(\"gas\").and_then(|gas| gas.as_str()) == Some(\"0x7fffffffffffffff\"))\n });\n\n match latest_excessive_gas_limit_tx {\n Some(tx) => {\n let tx_hash =\n tx.get(\"hash\").and_then(|h| h.as_str()).expect(\"Transaction missing hash\");\n\n // If --disable-block-gas-limit is not provided, the transaction should fail as the gas\n // limit exceeds the block gas limit.\n cmd.cast_fuse()\n .args([\"run\", \"-v\", tx_hash, \"--quick\", \"--rpc-url\", bsc_testnet_rpc_url.as_str()])\n .assert_failure()\n .stderr_eq(str![[r#\"\nError: EVM error; transaction validation error: caller gas limit exceeds the block gas limit\n\n\"#]]);\n\n // If --disable-block-gas-limit is provided, the transaction should succeed\n // despite the gas limit exceeding the block gas limit.\n cmd.cast_fuse()\n .args([\n \"run\",\n \"-v\",\n tx_hash,\n \"--quick\",\n \"--rpc-url\",\n bsc_testnet_rpc_url.as_str(),\n \"--disable-block-gas-limit\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n...\nTransaction successfully executed.\n[GAS]\n\n\"#]]);\n }\n None => {\n eprintln!(\n \"Skipping test: No transaction with gas = 0x7fffffffffffffff found in the latest block.\"\n );\n }\n }\n});\n\ncasttest!(send_eip7702, async |_prj, cmd| {\n let (_api, handle) =\n anvil::spawn(NodeConfig::test().with_hardfork(Some(EthereumHardfork::Prague.into()))).await;\n let endpoint = handle.http_endpoint();\n\n cmd.args([\n \"send\",\n \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\",\n \"--auth\",\n \"0x70997970C51812dc3A010C7d01b50e0d17dc79C8\",\n \"--private-key\",\n \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\",\n \"--rpc-url\",\n &endpoint,\n ])\n .assert_success();\n\n cmd.cast_fuse()\n .args([\"code\", \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\", \"--rpc-url\", &endpoint])\n .assert_success()\n .stdout_eq(str![[r#\"\n0xef010070997970c51812dc3a010c7d01b50e0d17dc79c8\n\n\"#]]);\n});\n\ncasttest!(send_eip7702_multiple_auth, async |_prj, cmd| {\n let (_api, handle) =\n anvil::spawn(NodeConfig::test().with_hardfork(Some(EthereumHardfork::Prague.into()))).await;\n let endpoint = handle.http_endpoint();\n\n // Create a pre-signed authorization using a different signer (account index 1)\n let signer: PrivateKeySigner =\n \"0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d\".parse().unwrap();\n // Anvil default chain_id is 31337\n let auth = Authorization {\n chain_id: U256::from(31337),\n // Delegate to account index 2\n address: address!(\"0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC\"),\n nonce: 0,\n };\n let signature = signer.sign_hash(&auth.signature_hash()).await.unwrap();\n let signed_auth = auth.into_signed(signature);\n let encoded_auth = hex::encode_prefixed(alloy_rlp::encode(&signed_auth));\n\n // Send transaction with multiple --auth flags: one address and one pre-signed authorization\n let output = cmd\n .args([\n \"send\",\n \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\",\n \"--auth\",\n \"0x70997970C51812dc3A010C7d01b50e0d17dc79C8\",\n \"--auth\",\n &encoded_auth,\n \"--private-key\",\n \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\",\n \"--rpc-url\",\n &endpoint,\n \"--gas-limit\",\n \"100000\",\n \"--json\",\n ])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n // Extract transaction hash from JSON output\n let json: serde_json::Value = serde_json::from_str(&output).unwrap();\n let tx_hash = json[\"transactionHash\"].as_str().unwrap();\n\n // Use cast tx to verify multiple authorizations were included\n let tx_output = cmd\n .cast_fuse()\n .args([\"tx\", tx_hash, \"--rpc-url\", &endpoint, \"--json\"])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n let tx_json: serde_json::Value = serde_json::from_str(&tx_output).unwrap();\n let auth_list = tx_json[\"authorizationList\"].as_array().unwrap();\n\n // Verify we have 2 authorizations\n assert_eq!(auth_list.len(), 2, \"Expected 2 authorizations in the transaction\");\n});\n\n// Test that multiple address-based authorizations are rejected\ncasttest!(send_eip7702_multiple_address_auth_rejected, async |_prj, cmd| {\n let (_api, handle) =\n anvil::spawn(NodeConfig::test().with_hardfork(Some(EthereumHardfork::Prague.into()))).await;\n let endpoint = handle.http_endpoint();\n\n cmd.args([\n \"send\",\n \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\",\n \"--auth\",\n \"0x70997970C51812dc3A010C7d01b50e0d17dc79C8\",\n \"--auth\",\n \"0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC\",\n \"--private-key\",\n \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\",\n \"--rpc-url\",\n &endpoint,\n ]);\n cmd.assert_failure().stderr_eq(str![[r#\"\nError: Multiple address-based authorizations provided. Only one address can be specified; use pre-signed authorizations (hex-encoded) for multiple authorizations.\n\n\"#]]);\n});\n\ncasttest!(send_sync, async |_prj, cmd| {\n let (_api, handle) = anvil::spawn(NodeConfig::test()).await;\n let endpoint = handle.http_endpoint();\n\n let output = cmd\n .args([\n \"send\",\n \"0x70997970C51812dc3A010C7d01b50e0d17dc79C8\",\n \"--value\",\n \"1\",\n \"--private-key\",\n \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\",\n \"--rpc-url\",\n &endpoint,\n \"--sync\",\n ])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n assert!(output.contains(\"transactionHash\"));\n assert!(output.contains(\"blockNumber\"));\n assert!(output.contains(\"gasUsed\"));\n});\n\ncasttest!(hash_message, |_prj, cmd| {\n cmd.args([\"hash-message\", \"hello\"]).assert_success().stdout_eq(str![[r#\"\n0x50b2c43fd39106bafbba0da34fc430e1f91e3c96ea2acee2bc34119f92b37750\n\n\"#]]);\n\n cmd.cast_fuse().args([\"hash-message\", \"0x68656c6c6f\"]).assert_success().stdout_eq(str![[r#\"\n0x83a0870b6c63a71efdd3b2749ef700653d97454152c4b53fa9b102dc430c7c32\n\n\"#]]);\n});\n\ncasttest!(parse_units, |_prj, cmd| {\n cmd.args([\"parse-units\", \"1.5\", \"6\"]).assert_success().stdout_eq(str![[r#\"\n1500000\n\n\"#]]);\n\n cmd.cast_fuse().args([\"pun\", \"1.23\", \"18\"]).assert_success().stdout_eq(str![[r#\"\n1230000000000000000\n\n\"#]]);\n\n cmd.cast_fuse().args([\"--parse-units\", \"1.23\", \"3\"]).assert_success().stdout_eq(str![[r#\"\n1230\n\n\"#]]);\n});\n\ncasttest!(string_decode, |_prj, cmd| {\n cmd.args([\"string-decode\", \"0x88c379a0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000054753303235000000000000000000000000000000000000000000000000000000\"]).assert_success().stdout_eq(str![[r#\"\n\"GS025\"\n\n\"#]]);\n});\n\ncasttest!(format_units, |_prj, cmd| {\n cmd.args([\"format-units\", \"1000000\", \"6\"]).assert_success().stdout_eq(str![[r#\"\n1\n\n\"#]]);\n\n cmd.cast_fuse().args([\"--format-units\", \"2500000\", \"6\"]).assert_success().stdout_eq(str![[\n r#\"\n2.500000\n\n\"#\n ]]);\n\n cmd.cast_fuse().args([\"fun\", \"1230\", \"3\"]).assert_success().stdout_eq(str![[r#\"\n1.230\n\n\"#]]);\n});\n\n// tests that fetches a sample contract creation code\n// \ncasttest!(flaky_fetch_creation_code_from_etherscan, |_prj, cmd| {\n let eth_rpc_url = next_http_rpc_endpoint();\n cmd.args([\n \"creation-code\",\n \"--etherscan-api-key\",\n &next_etherscan_api_key(),\n \"0x0923cad07f06b2d0e5e49e63b8b35738d4156b95\",\n \"--rpc-url\",\n eth_rpc_url.as_str(),\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n0x60566050600b82828239805160001a6073146043577f4e487b7100000000000000000000000000000000000000000000000000000000600052600060045260246000fd5b30600052607381538281f3fe73000000000000000000000000000000000000000030146080604052600080fdfea264697066735822122074c61e8e4eefd410ca92eec26e8112ec6e831d0a4bf35718fdd78b45d68220d064736f6c63430008070033\n\n\"#]]);\n});\n\n// tests that fetches a sample contract creation args bytes\n// \ncasttest!(flaky_fetch_creation_code_only_args_from_etherscan, |_prj, cmd| {\n let eth_rpc_url = next_http_rpc_endpoint();\n cmd.args([\n \"creation-code\",\n \"--etherscan-api-key\",\n &next_etherscan_api_key(),\n \"0x6982508145454ce325ddbe47a25d4ec3d2311933\",\n \"--rpc-url\",\n eth_rpc_url.as_str(),\n \"--only-args\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n0x00000000000000000000000000000000000014bddab3e51a57cff87a50000000\n\n\"#]]);\n});\n\n// tests that displays a sample contract creation args\n// \ncasttest!(flaky_fetch_constructor_args_from_etherscan, |_prj, cmd| {\n let eth_rpc_url = next_http_rpc_endpoint();\n cmd.args([\n \"constructor-args\",\n \"--etherscan-api-key\",\n &next_etherscan_api_key(),\n \"0x6982508145454ce325ddbe47a25d4ec3d2311933\",\n \"--rpc-url\",\n eth_rpc_url.as_str(),\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n0x00000000000000000000000000000000000014bddab3e51a57cff87a50000000 ā†’ Uint(420690000000000000000000000000000, 256)\n\n\"#]]);\n});\n\n// \ncasttest!(flaky_test_non_mainnet_traces, |prj, cmd| {\n prj.clear();\n cmd.args([\n \"run\",\n \"0xa003e419e2d7502269eb5eda56947b580120e00abfd5b5460d08f8af44a0c24f\",\n \"--rpc-url\",\n next_rpc_endpoint(NamedChain::Optimism).as_str(),\n \"--etherscan-api-key\",\n next_etherscan_api_key().as_str(),\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\nExecuting previous transactions from the block.\nTraces:\n [33841] FiatTokenProxy::fallback(0x111111125421cA6dc452d289314280a0f8842A65, 164054805 [1.64e8])\n ā”œā”€ [26673] FiatTokenV2_2::approve(0x111111125421cA6dc452d289314280a0f8842A65, 164054805 [1.64e8]) [delegatecall]\n ā”‚ ā”œā”€ emit Approval(owner: 0x9a95Af47C51562acfb2107F44d7967DF253197df, spender: 0x111111125421cA6dc452d289314280a0f8842A65, value: 164054805 [1.64e8])\n ā”‚ ā””ā”€ ā† [Return] true\n ā””ā”€ ā† [Return] true\n...\n\n\"#]]);\n});\n\n// tests that displays a sample contract artifact\n// \ncasttest!(flaky_fetch_artifact_from_etherscan, |_prj, cmd| {\n let eth_rpc_url = next_http_rpc_endpoint();\n cmd.args([\n \"artifact\",\n \"--etherscan-api-key\",\n &next_etherscan_api_key(),\n \"0x0923cad07f06b2d0e5e49e63b8b35738d4156b95\",\n \"--rpc-url\",\n eth_rpc_url.as_str(),\n ])\n .assert_success()\n .stdout_eq(str![[r#\"{\n \"abi\": [],\n \"bytecode\": {\n \"object\": \"0x60566050600b82828239805160001a6073146043577f4e487b7100000000000000000000000000000000000000000000000000000000600052600060045260246000fd5b30600052607381538281f3fe73000000000000000000000000000000000000000030146080604052600080fdfea264697066735822122074c61e8e4eefd410ca92eec26e8112ec6e831d0a4bf35718fdd78b45d68220d064736f6c63430008070033\"\n }\n}\n\n\"#]]);\n});\n\n// tests cast can decode traces when using project artifacts\nforgetest_async!(decode_traces_with_project_artifacts, |prj, cmd| {\n let (api, handle) =\n anvil::spawn(NodeConfig::test().with_disable_default_create2_deployer(true)).await;\n\n foundry_test_utils::util::initialize(prj.root());\n prj.add_source(\n \"LocalProjectContract\",\n r#\"\ncontract LocalProjectContract {\n event LocalProjectContractCreated(address owner);\n\n constructor() {\n emit LocalProjectContractCreated(msg.sender);\n }\n}\n \"#,\n );\n prj.add_script(\n \"LocalProjectScript\",\n r#\"\nimport \"forge-std/Script.sol\";\nimport {LocalProjectContract} from \"../src/LocalProjectContract.sol\";\n\ncontract LocalProjectScript is Script {\n function run() public {\n vm.startBroadcast();\n new LocalProjectContract();\n vm.stopBroadcast();\n }\n}\n \"#,\n );\n\n cmd.args([\n \"script\",\n \"--private-key\",\n \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n \"--broadcast\",\n \"LocalProjectScript\",\n ]);\n\n cmd.assert_success();\n\n let tx_hash = api\n .transaction_by_block_number_and_index(BlockNumberOrTag::Latest, Index::from(0))\n .await\n .unwrap()\n .unwrap()\n .tx_hash();\n\n // Assert cast with local artifacts from outside the project.\n cmd.cast_fuse()\n .args([\"run\", \"--la\", format!(\"{tx_hash}\").as_str(), \"--rpc-url\", &handle.http_endpoint()])\n .assert_success()\n .stdout_eq(str![[r#\"\nExecuting previous transactions from the block.\nCompiling project to generate artifacts\nNothing to compile\n\n\"#]]);\n\n // Run cast from project dir.\n cmd.cast_fuse().set_current_dir(prj.root());\n\n // Assert cast without local artifacts cannot decode traces.\n cmd.cast_fuse()\n .args([\"run\", format!(\"{tx_hash}\").as_str(), \"--rpc-url\", &handle.http_endpoint()])\n .assert_success()\n .stdout_eq(str![[r#\"\nExecuting previous transactions from the block.\nTraces:\n [..] ā†’ new @0x5FbDB2315678afecb367f032d93F642f64180aa3\n ā”œā”€ emit topic 0: 0xa7263295d3a687d750d1fd377b5df47de69d7db8decc745aaa4bbee44dc1688d\n ā”‚ data: 0x000000000000000000000000f39fd6e51aad88f6f4ce6ab8827279cfffb92266\n ā””ā”€ ā† [Return] 62 bytes of code\n\n\nTransaction successfully executed.\n[GAS]\n\n\"#]]);\n\n // Assert cast with local artifacts can decode traces.\n cmd.cast_fuse()\n .args([\"run\", \"--la\", format!(\"{tx_hash}\").as_str(), \"--rpc-url\", &handle.http_endpoint()])\n .assert_success()\n .stdout_eq(str![[r#\"\nExecuting previous transactions from the block.\nCompiling project to generate artifacts\nNo files changed, compilation skipped\nTraces:\n [..] ā†’ new LocalProjectContract@0x5FbDB2315678afecb367f032d93F642f64180aa3\n ā”œā”€ emit LocalProjectContractCreated(owner: 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266)\n ā””ā”€ ā† [Return] 62 bytes of code\n\n\nTransaction successfully executed.\n[GAS]\n\n\"#]]);\n});\n\n// tests cast can decode traces when running with verbosity level > 4\nforgetest_async!(show_state_changes_in_traces, |prj, cmd| {\n let (api, handle) = anvil::spawn(NodeConfig::test()).await;\n\n foundry_test_utils::util::initialize(prj.root());\n prj.initialize_default_contracts();\n // Deploy counter contract.\n cmd.args([\n \"script\",\n \"--private-key\",\n \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n \"--broadcast\",\n \"CounterScript\",\n ])\n .assert_success();\n\n // Send tx to change counter storage value.\n cmd.cast_fuse()\n .args([\n \"send\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3\",\n \"setNumber(uint256)\",\n \"111\",\n \"--private-key\",\n \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n ])\n .assert_success();\n\n let tx_hash = api\n .transaction_by_block_number_and_index(BlockNumberOrTag::Latest, Index::from(0))\n .await\n .unwrap()\n .unwrap()\n .tx_hash();\n\n // Assert cast with verbosity displays storage changes.\n cmd.cast_fuse()\n .args([\n \"run\",\n format!(\"{tx_hash}\").as_str(),\n \"-vvvvv\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\nExecuting previous transactions from the block.\nTraces:\n [..] 0x5FbDB2315678afecb367f032d93F642f64180aa3::setNumber(111)\n ā”œā”€ storage changes:\n ā”‚ @ 0: 0 ā†’ 111\n ā””ā”€ ā† [Stop]\n\n\nTransaction successfully executed.\n[GAS]\n\n\"#]]);\n});\n\n// tests cast can decode external libraries traces with project cached selectors\nforgetest_async!(flaky_decode_external_libraries_with_cached_selectors, |prj, cmd| {\n let (api, handle) = anvil::spawn(NodeConfig::test()).await;\n\n foundry_test_utils::util::initialize(prj.root());\n prj.add_source(\n \"ExternalLib\",\n r#\"\nimport \"./CounterInExternalLib.sol\";\nlibrary ExternalLib {\n function updateCounterInExternalLib(CounterInExternalLib.Info storage counterInfo, uint256 counter) public {\n counterInfo.counter = counter + 1;\n }\n}\n \"#,\n );\n prj.add_source(\n \"CounterInExternalLib\",\n r#\"\nimport \"./ExternalLib.sol\";\ncontract CounterInExternalLib {\n struct Info {\n uint256 counter;\n }\n Info info;\n constructor() {\n ExternalLib.updateCounterInExternalLib(info, 100);\n }\n}\n \"#,\n );\n prj.add_script(\n \"CounterInExternalLibScript\",\n r#\"\nimport \"forge-std/Script.sol\";\nimport {CounterInExternalLib} from \"../src/CounterInExternalLib.sol\";\ncontract CounterInExternalLibScript is Script {\n function run() public {\n vm.startBroadcast();\n new CounterInExternalLib();\n vm.stopBroadcast();\n }\n}\n \"#,\n );\n\n cmd.args([\n \"script\",\n \"--private-key\",\n \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n \"--broadcast\",\n \"CounterInExternalLibScript\",\n ])\n .assert_success();\n\n let tx_hash = api\n .transaction_by_block_number_and_index(BlockNumberOrTag::Latest, Index::from(0))\n .await\n .unwrap()\n .unwrap()\n .tx_hash();\n\n // Build and cache project selectors.\n cmd.forge_fuse().args([\"build\"]).assert_success();\n cmd.forge_fuse().args([\"selectors\", \"cache\"]).assert_success();\n // Assert cast with local artifacts can decode external lib signature.\n cmd.cast_fuse()\n .args([\"run\", format!(\"{tx_hash}\").as_str(), \"--rpc-url\", &handle.http_endpoint()])\n .assert_success()\n .stdout_eq(str![[r#\"\n...\nTraces:\n [..] ā†’ new @0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512\n ā”œā”€ [..] [..]::updateCounterInExternalLib(0, 100) [delegatecall]\n ā”‚ ā””ā”€ ā† [Stop]\n ā””ā”€ ā† [Return] [..] bytes of code\n\n\nTransaction successfully executed.\n[GAS]\n\n\"#]]);\n});\n\n// https://github.com/foundry-rs/foundry/issues/9476\nforgetest_async!(cast_call_custom_chain_id, |_prj, cmd| {\n let chain_id = 55555u64;\n let (_api, handle) = anvil::spawn(NodeConfig::test().with_chain_id(Some(chain_id))).await;\n\n let http_endpoint = handle.http_endpoint();\n\n cmd.cast_fuse()\n .args([\n \"call\",\n \"5FbDB2315678afecb367f032d93F642f64180aa3\",\n \"--rpc-url\",\n &http_endpoint,\n \"--chain\",\n &chain_id.to_string(),\n ])\n .assert_success();\n});\n\n// https://github.com/foundry-rs/foundry/issues/10848\nforgetest_async!(cast_call_disable_labels, |prj, cmd| {\n let (_, handle) = anvil::spawn(NodeConfig::test()).await;\n\n foundry_test_utils::util::initialize(prj.root());\n prj.initialize_default_contracts();\n prj.add_source(\n \"Counter\",\n r#\"\ncontract Counter {\n uint256 public number;\n\n function getBalance(address target) public returns (uint256) {\n return target.balance;\n }\n}\n \"#,\n );\n\n // Deploy counter contract.\n cmd.args([\n \"script\",\n \"--private-key\",\n \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n \"--broadcast\",\n \"CounterScript\",\n ])\n .assert_success();\n\n // Override state, `number()` should return overridden value.\n cmd.cast_fuse()\n .args([\n \"call\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n \"--override-state\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3:0x0:0x1234\",\n \"number()(uint256)\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n4660\n\n\"#]]);\n\n // Override state, `number()` should return overridden value.\n cmd.cast_fuse()\n .args([\n \"call\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3\",\n \"--labels\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3:WETH\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n \"--override-state\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3:0x0:0x1234\",\n \"number()(uint256)\",\n \"--trace\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\nTraces:\n [2402] WETH::number()\n ā””ā”€ ā† [Return] 0x0000000000000000000000000000000000000000000000000000000000001234\n\n\nTransaction successfully executed.\n[GAS]\n\n\"#]]);\n\n // Override state, `number()` with `disable_labels`.\n cmd.cast_fuse()\n .args([\n \"call\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3\",\n \"--labels\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3:WETH\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n \"--override-state\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3:0x0:0x1234\",\n \"number()(uint256)\",\n \"--trace\",\n \"--disable-labels\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\nTraces:\n [2402] 0x5FbDB2315678afecb367f032d93F642f64180aa3::number()\n ā””ā”€ ā† [Return] 0x0000000000000000000000000000000000000000000000000000000000001234\n\n\nTransaction successfully executed.\n[GAS]\n\n\"#]]);\n});\n\n// https://github.com/foundry-rs/foundry/issues/10189\nforgetest_async!(cast_call_custom_override, |prj, cmd| {\n let (_, handle) = anvil::spawn(NodeConfig::test()).await;\n\n foundry_test_utils::util::initialize(prj.root());\n prj.initialize_default_contracts();\n prj.add_source(\n \"Counter\",\n r#\"\ncontract Counter {\n uint256 public number;\n\n function getBalance(address target) public returns (uint256) {\n return target.balance;\n }\n}\n \"#,\n );\n\n // Deploy counter contract.\n cmd.args([\n \"script\",\n \"--private-key\",\n \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n \"--broadcast\",\n \"CounterScript\",\n ])\n .assert_success();\n\n // Override state, `number()` should return overridden value.\n cmd.cast_fuse()\n .args([\n \"call\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n \"--override-state\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3:0x0:0x1234\",\n \"number()(uint256)\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n4660\n\n\"#]]);\n\n // Override state, `number()` should return overridden value.\n cmd.cast_fuse()\n .args([\n \"call\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n \"--override-state\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3:0x0:0x1234\",\n \"number()(uint256)\",\n \"--trace\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\nTraces:\n [2402] 0x5FbDB2315678afecb367f032d93F642f64180aa3::number()\n ā””ā”€ ā† [Return] 0x0000000000000000000000000000000000000000000000000000000000001234\n\n\nTransaction successfully executed.\n[GAS]\n\n\"#]]);\n\n // Override balance, `getBalance()` should return overridden value.\n cmd.cast_fuse()\n .args([\n \"call\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n \"--override-balance\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3:0x1111\",\n \"getBalance(address)(uint256)\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n4369\n\n\"#]]);\n\n // Override balance, `getBalance()` should return overridden value.\n cmd.cast_fuse()\n .args([\n \"call\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n \"--override-balance\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3:0x1111\",\n \"getBalance(address)(uint256)\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3\",\n \"--trace\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\nTraces:\n [747] 0x5FbDB2315678afecb367f032d93F642f64180aa3::getBalance(0x5FbDB2315678afecb367f032d93F642f64180aa3)\n ā””ā”€ ā† [Return] 0x0000000000000000000000000000000000000000000000000000000000001111\n\n\nTransaction successfully executed.\n[GAS]\n\n\"#]]);\n\n // Override code with\n // contract Counter {\n // uint256 public number1;\n // }\n // Calling `number()` should fail.\n cmd.cast_fuse()\n .args([\n \"call\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n \"--override-code\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3:0x6080604052348015600e575f5ffd5b50600436106026575f3560e01c8063c223a39e14602a575b5f5ffd5b60306044565b604051603b9190605f565b60405180910390f35b5f5481565b5f819050919050565b6059816049565b82525050565b5f60208201905060705f8301846052565b9291505056fea26469706673582212202a0acfb9083efed3e0e9f27177b090731d4392cf196d58e27e05088f59008d0964736f6c634300081d0033\",\n \"number()(uint256)\",\n ])\n .assert_failure()\n .stderr_eq(str![[r#\"\nError: server returned an error response: error code 3: execution reverted, data: \"0x\"\n\n\"#]]);\n\n // Override code with\n // contract Counter {\n // uint256 public number1;\n // }\n // Calling `number()` should revert.\n cmd.cast_fuse()\n .args([\n \"call\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n \"--override-code\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3:0x6080604052348015600e575f5ffd5b50600436106026575f3560e01c8063c223a39e14602a575b5f5ffd5b60306044565b604051603b9190605f565b60405180910390f35b5f5481565b5f819050919050565b6059816049565b82525050565b5f60208201905060705f8301846052565b9291505056fea26469706673582212202a0acfb9083efed3e0e9f27177b090731d4392cf196d58e27e05088f59008d0964736f6c634300081d0033\",\n \"number()(uint256)\",\n \"--trace\"\n ])\n .assert_success()\n .stderr_eq(str![[r#\"\nError: Transaction failed.\n\n\"#]]);\n\n // Calling `number1()` with overridden state should return new value.\n cmd.cast_fuse()\n .args([\n \"call\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n \"--override-code\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3:0x6080604052348015600e575f5ffd5b50600436106026575f3560e01c8063c223a39e14602a575b5f5ffd5b60306044565b604051603b9190605f565b60405180910390f35b5f5481565b5f819050919050565b6059816049565b82525050565b5f60208201905060705f8301846052565b9291505056fea26469706673582212202a0acfb9083efed3e0e9f27177b090731d4392cf196d58e27e05088f59008d0964736f6c634300081d0033\",\n \"--override-state\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3:0x0:0x2222\",\n \"number1()(uint256)\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n8738\n\n\"#]]);\n\n // Calling `number1()` with overridden state should return new value.\n cmd.cast_fuse()\n .args([\n \"call\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n \"--override-code\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3:0x6080604052348015600e575f5ffd5b50600436106026575f3560e01c8063c223a39e14602a575b5f5ffd5b60306044565b604051603b9190605f565b60405180910390f35b5f5481565b5f819050919050565b6059816049565b82525050565b5f60208201905060705f8301846052565b9291505056fea26469706673582212202a0acfb9083efed3e0e9f27177b090731d4392cf196d58e27e05088f59008d0964736f6c634300081d0033\",\n \"--override-state\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3:0x0:0x2222\",\n \"number1()(uint256)\",\n \"--trace\"\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\nTraces:\n [2402] 0x5FbDB2315678afecb367f032d93F642f64180aa3::number1()\n ā””ā”€ ā† [Return] 0x0000000000000000000000000000000000000000000000000000000000002222\n\n\nTransaction successfully executed.\n[GAS]\n\n\"#]]);\n\n // Calling `number1()` with overridden state should return new value.\n cmd.cast_fuse()\n .args([\n \"call\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n \"--override-code\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3:0x6080604052348015600e575f5ffd5b50600436106026575f3560e01c8063c223a39e14602a575b5f5ffd5b60306044565b604051603b9190605f565b60405180910390f35b5f5481565b5f819050919050565b6059816049565b82525050565b5f60208201905060705f8301846052565b9291505056fea26469706673582212202a0acfb9083efed3e0e9f27177b090731d4392cf196d58e27e05088f59008d0964736f6c634300081d0033\",\n \"--override-state-diff\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3:0x0:0x2222\",\n \"number1()(uint256)\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n8738\n\n\"#]]);\n\n // Calling `number1()` with overridden state should return new value.\n cmd.cast_fuse()\n .args([\n \"call\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n \"--override-code\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3:0x6080604052348015600e575f5ffd5b50600436106026575f3560e01c8063c223a39e14602a575b5f5ffd5b60306044565b604051603b9190605f565b60405180910390f35b5f5481565b5f819050919050565b6059816049565b82525050565b5f60208201905060705f8301846052565b9291505056fea26469706673582212202a0acfb9083efed3e0e9f27177b090731d4392cf196d58e27e05088f59008d0964736f6c634300081d0033\",\n \"--override-state-diff\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3:0x0:0x2222\",\n \"number1()(uint256)\",\n \"--trace\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\nTraces:\n [2402] 0x5FbDB2315678afecb367f032d93F642f64180aa3::number1()\n ā””ā”€ ā† [Return] 0x0000000000000000000000000000000000000000000000000000000000002222\n\n\nTransaction successfully executed.\n[GAS]\n\n\"#]]);\n});\n\n// https://github.com/foundry-rs/foundry/issues/9541\nforgetest_async!(flaky_cast_run_impersonated_tx, |_prj, cmd| {\n let (_api, handle) = anvil::spawn(\n NodeConfig::test()\n .with_auto_impersonate(true)\n .with_eth_rpc_url(Some(\"https://sepolia.base.org\")),\n )\n .await;\n\n let http_endpoint = handle.http_endpoint();\n\n let provider = ProviderBuilder::new().connect_http(http_endpoint.parse().unwrap());\n\n // send impersonated tx\n let tx = TransactionRequest::default()\n .with_from(address!(\"0x041563c07028Fc89106788185763Fc73028e8511\"))\n .with_to(address!(\"0xF38aA5909D89F5d98fCeA857e708F6a6033f6CF8\"))\n .with_input(\n Bytes::from_str(\n \"0x60fe47b1000000000000000000000000000000000000000000000000000000000000000c\",\n )\n .unwrap(),\n );\n\n let receipt = provider.send_transaction(tx).await.unwrap().get_receipt().await.unwrap();\n\n assert!(receipt.status());\n\n // run impersonated tx\n cmd.cast_fuse()\n .args([\"run\", &receipt.transaction_hash.to_string(), \"--rpc-url\", &http_endpoint])\n .assert_success();\n});\n\n// \ncasttest!(flaky_fetch_src_blockscout, |_prj, cmd| {\n let url = \"https://eth.blockscout.com/api\";\n\n let weth = address!(\"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2\");\n\n cmd.args([\n \"source\",\n &weth.to_string(),\n \"--chain-id\",\n \"1\",\n \"--explorer-api-url\",\n url,\n \"--flatten\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n...\ncontract WETH9 {\n string public name = \"Wrapped Ether\";\n string public symbol = \"WETH\";\n uint8 public decimals = 18;\n...\"#]]);\n});\n\ncasttest!(flaky_fetch_src_default, |_prj, cmd| {\n let weth = address!(\"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2\");\n let etherscan_api_key = next_etherscan_api_key();\n\n cmd.args([\"source\", &weth.to_string(), \"--flatten\", \"--etherscan-api-key\", ðerscan_api_key])\n .assert_success()\n .stdout_eq(str![[r#\"\n...\ncontract WETH9 {\n string public name = \"Wrapped Ether\";\n string public symbol = \"WETH\";\n uint8 public decimals = 18;\n...\"#]]);\n});\n\n// \n// \ncasttest!(flaky_osaka_can_run_p256_precompile, |_prj, cmd| {\n cmd.args([\n \"run\",\n \"0x17b2de59ebd7dfd2452a3638a16737b6b65ae816c1c5571631dc0d80b63c41de\",\n \"--rpc-url\",\n next_rpc_endpoint(NamedChain::Base).as_str(),\n \"--quick\",\n \"--evm-version\",\n \"osaka\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\nTraces:\n [91537] 0xc2FF493F28e894742b968A7DB5D3F21F0aD80C6c::execute(0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000a12384c5e52fd646e7bc7f6b3b33a605651f566e000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000170000000000000000000000000000000000000000000000000000000000000000000000000000000000000000833589fcd6edb6e08f4c7c32d4f71b54bda02913000000000000000000000000000000000000000000000000000000000000060f000000000000000000000000000000000000000000000000000000000000060f0000000000000000000000000000000000000000000000000000000000036cd000000000000000000000000000000000000000000000000000000000000003000000000000000000000000000000000000000000000000000000000000000320000000000000000000000000000000000000000000000000000000000000060f000000000000000000000000000000000000000000000000000000000000060f000000000000000000000000327a25ad5cfe5c4d4339c1a4267d4a83e8c93312000000000000000000000000000000000000000000000000000000000000034000000000000000000000000000000000000000000000000000000000000005a00000000000000000000000000b55b053230e4effb6609de652fca73fd1c2980400000000000000000000000000000000000000000000000000000000000000e00000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000221000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000001200000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000006cdd519280ec730727f07aa36550bde31a1d5f3097818f3425c2f083ed33a91f080fa2afac0071f6e1af9a0e9c09b851bf01e68bc8a1c1f89f686c48205762f92500000000000000000000000000000000000000000000000000000000000000244242424242424242424242424242424242424242424242424242424242424242010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000827b226368616c6c656e6765223a224b51704d51446e7841757a726f68522d483878472d5a536b625249702d76515f5f5f4a714259357a655038222c2263726f73734f726967696e223a66616c73652c226f726967696e223a2268747470732f2f6974686163612e78797a222c2274797065223a22776562617574686e2e676574227d0000000000000000000000000000000000000000000000000000000000001bde17b8de18819c9eb86cefc3920ddb5d3d4254de276e3d6e18dd2b399f732b00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000)\n ā”œā”€ [2241] 0xA12384c5E52fD646E7BC7F6B3b33A605651F566E::fallback(00) [staticcall]\n ā”‚ ā””ā”€ ā† [Return] 0x0000000000000000000000000b55b053230e4effb6609de652fca73fd1c29804\n ā”œā”€ [9750] 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913::balanceOf(0xA12384c5E52fD646E7BC7F6B3b33A605651F566E) [staticcall]\n ā”‚ ā”œā”€ [2553] 0x2Ce6311ddAE708829bc0784C967b7d77D19FD779::balanceOf(0xA12384c5E52fD646E7BC7F6B3b33A605651F566E) [delegatecall]\n ā”‚ ā”‚ ā””ā”€ ā† [Return] 0x000000000000000000000000000000000000000000000000000000000000f3b9\n ā”‚ ā””ā”€ ā† [Return] 0x000000000000000000000000000000000000000000000000000000000000f3b9\n ā”œā”€ [65442] 0xc2FF493F28e894742b968A7DB5D3F21F0aD80C6c::fulfillBasicOrder_efficient_6GL6yc()\n ā”‚ ā”œā”€ [25070] 0xA12384c5E52fD646E7BC7F6B3b33A605651F566E::unwrapAndValidateSignature(0x290a4c4039f102eceba2147e1fcc46f994a46d1229faf43ffff26a058e7378ff, 0x000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000001200000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000006cdd519280ec730727f07aa36550bde31a1d5f3097818f3425c2f083ed33a91f080fa2afac0071f6e1af9a0e9c09b851bf01e68bc8a1c1f89f686c48205762f92500000000000000000000000000000000000000000000000000000000000000244242424242424242424242424242424242424242424242424242424242424242010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000827b226368616c6c656e6765223a224b51704d51446e7841757a726f68522d483878472d5a536b625249702d76515f5f5f4a714259357a655038222c2263726f73734f726967696e223a66616c73652c226f726967696e223a2268747470732f2f6974686163612e78797a222c2274797065223a22776562617574686e2e676574227d0000000000000000000000000000000000000000000000000000000000001bde17b8de18819c9eb86cefc3920ddb5d3d4254de276e3d6e18dd2b399f732b00) [staticcall]\n ā”‚ ā”‚ ā”œā”€ [22067] 0x0B55b053230E4EFFb6609de652fCa73Fd1C29804::unwrapAndValidateSignature(0x290a4c4039f102eceba2147e1fcc46f994a46d1229faf43ffff26a058e7378ff, 0x000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000001200000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000006cdd519280ec730727f07aa36550bde31a1d5f3097818f3425c2f083ed33a91f080fa2afac0071f6e1af9a0e9c09b851bf01e68bc8a1c1f89f686c48205762f92500000000000000000000000000000000000000000000000000000000000000244242424242424242424242424242424242424242424242424242424242424242010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000827b226368616c6c656e6765223a224b51704d51446e7841757a726f68522d483878472d5a536b625249702d76515f5f5f4a714259357a655038222c2263726f73734f726967696e223a66616c73652c226f726967696e223a2268747470732f2f6974686163612e78797a222c2274797065223a22776562617574686e2e676574227d0000000000000000000000000000000000000000000000000000000000001bde17b8de18819c9eb86cefc3920ddb5d3d4254de276e3d6e18dd2b399f732b00) [delegatecall]\n ā”‚ ā”‚ ā”‚ ā”œā”€ [2369] 0xc2FF493F28e894742b968A7DB5D3F21F0aD80C6c::pauseFlag() [staticcall]\n ā”‚ ā”‚ ā”‚ ā”‚ ā””ā”€ ā† [Return] 0x0000000000000000000000000000000000000000000000000000000000000000\n ā”‚ ā”‚ ā”‚ ā”œā”€ [120] PRECOMPILES::sha256(0x7b226368616c6c656e6765223a224b51704d51446e7841757a726f68522d483878472d5a536b625249702d76515f5f5f4a714259357a655038222c2263726f73734f726967696e223a66616c73652c226f726967696e223a2268747470732f2f6974686163612e78797a222c2274797065223a22776562617574686e2e676574227d) [staticcall]\n ā”‚ ā”‚ ā”‚ ā”‚ ā””ā”€ ā† [Return] 0xc13089327d3c20c0ce35f2f058c423de29977e6950e406c095e366a8fabd463f\n ā”‚ ā”‚ ā”‚ ā”œā”€ [96] PRECOMPILES::sha256(0x424242424242424242424242424242424242424242424242424242424242424201000000c13089327d3c20c0ce35f2f058c423de29977e6950e406c095e366a8fabd463f) [staticcall]\n ā”‚ ā”‚ ā”‚ ā”‚ ā””ā”€ ā† [Return] 0xc544bd9a4ea526dda3a008f43c21b6f0be3031b1ff71832b9876915dc91deea0\n ā”‚ ā”‚ ā”‚ ā”œā”€ [6900] P256VERIFY::c544bd9a(4ea526dda3a008f43c21b6f0be3031b1ff71832b9876915dc91deea0dd519280ec730727f07aa36550bde31a1d5f3097818f3425c2f083ed33a91f080fa2afac0071f6e1af9a0e9c09b851bf01e68bc8a1c1f89f686c48205762f925bf54fa13f88658092efa36c51b1e3c4db31d3afb92812fb852dac7cf9614bc479bf5da7241d9c4ab1b431b57ec3369587b4c831d7a564438990da053708c3289) [staticcall]\n ā”‚ ā”‚ ā”‚ ā”‚ ā””ā”€ ā† [Return] 0x0000000000000000000000000000000000000000000000000000000000000001\n ā”‚ ā”‚ ā”‚ ā””ā”€ ā† [Return] 0x00000000000000000000000000000000000000000000000000000000000000011bde17b8de18819c9eb86cefc3920ddb5d3d4254de276e3d6e18dd2b399f732b\n ā”‚ ā”‚ ā””ā”€ ā† [Return] 0x00000000000000000000000000000000000000000000000000000000000000011bde17b8de18819c9eb86cefc3920ddb5d3d4254de276e3d6e18dd2b399f732b\n ā”‚ ā”œā”€ [5994] 0xA12384c5E52fD646E7BC7F6B3b33A605651F566E::checkAndIncrementNonce(23)\n ā”‚ ā”‚ ā”œā”€ [5608] 0x0B55b053230E4EFFb6609de652fCa73Fd1C29804::checkAndIncrementNonce(23) [delegatecall]\n ā”‚ ā”‚ ā”‚ ā””ā”€ ā† [Stop]\n ā”‚ ā”‚ ā””ā”€ ā† [Return]\n ā”‚ ā”œā”€ [3250] 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913::balanceOf(0x327a25aD5Cfe5c4D4339C1A4267D4a83E8c93312) [staticcall]\n ā”‚ ā”‚ ā”œā”€ [2553] 0x2Ce6311ddAE708829bc0784C967b7d77D19FD779::balanceOf(0x327a25aD5Cfe5c4D4339C1A4267D4a83E8c93312) [delegatecall]\n ā”‚ ā”‚ ā”‚ ā””ā”€ ā† [Return] 0x000000000000000000000000000000000000000000000000000000000000968b\n ā”‚ ā”‚ ā””ā”€ ā† [Return] 0x000000000000000000000000000000000000000000000000000000000000968b\n ā”‚ ā”œā”€ [16411] 0xA12384c5E52fD646E7BC7F6B3b33A605651F566E::pay(1551, 0x1bde17b8de18819c9eb86cefc3920ddb5d3d4254de276e3d6e18dd2b399f732b, 0x290a4c4039f102eceba2147e1fcc46f994a46d1229faf43ffff26a058e7378ff, 0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000a12384c5e52fd646e7bc7f6b3b33a605651f566e000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000170000000000000000000000000000000000000000000000000000000000000000000000000000000000000000833589fcd6edb6e08f4c7c32d4f71b54bda02913000000000000000000000000000000000000000000000000000000000000060f000000000000000000000000000000000000000000000000000000000000060f0000000000000000000000000000000000000000000000000000000000036cd000000000000000000000000000000000000000000000000000000000000003000000000000000000000000000000000000000000000000000000000000000320000000000000000000000000000000000000000000000000000000000000060f000000000000000000000000000000000000000000000000000000000000060f000000000000000000000000327a25ad5cfe5c4d4339c1a4267d4a83e8c93312000000000000000000000000000000000000000000000000000000000000034000000000000000000000000000000000000000000000000000000000000005a00000000000000000000000000b55b053230e4effb6609de652fca73fd1c2980400000000000000000000000000000000000000000000000000000000000000e00000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000221000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000001200000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000006cdd519280ec730727f07aa36550bde31a1d5f3097818f3425c2f083ed33a91f080fa2afac0071f6e1af9a0e9c09b851bf01e68bc8a1c1f89f686c48205762f92500000000000000000000000000000000000000000000000000000000000000244242424242424242424242424242424242424242424242424242424242424242010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000827b226368616c6c656e6765223a224b51704d51446e7841757a726f68522d483878472d5a536b625249702d76515f5f5f4a714259357a655038222c2263726f73734f726967696e223a66616c73652c226f726967696e223a2268747470732f2f6974686163612e78797a222c2274797065223a22776562617574686e2e676574227d0000000000000000000000000000000000000000000000000000000000001bde17b8de18819c9eb86cefc3920ddb5d3d4254de276e3d6e18dd2b399f732b000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000)\n ā”‚ ā”‚ ā”œā”€ [15711] 0x0B55b053230E4EFFb6609de652fCa73Fd1C29804::pay(1551, 0x1bde17b8de18819c9eb86cefc3920ddb5d3d4254de276e3d6e18dd2b399f732b, 0x290a4c4039f102eceba2147e1fcc46f994a46d1229faf43ffff26a058e7378ff, 0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000a12384c5e52fd646e7bc7f6b3b33a605651f566e000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000170000000000000000000000000000000000000000000000000000000000000000000000000000000000000000833589fcd6edb6e08f4c7c32d4f71b54bda02913000000000000000000000000000000000000000000000000000000000000060f000000000000000000000000000000000000000000000000000000000000060f0000000000000000000000000000000000000000000000000000000000036cd000000000000000000000000000000000000000000000000000000000000003000000000000000000000000000000000000000000000000000000000000000320000000000000000000000000000000000000000000000000000000000000060f000000000000000000000000000000000000000000000000000000000000060f000000000000000000000000327a25ad5cfe5c4d4339c1a4267d4a83e8c93312000000000000000000000000000000000000000000000000000000000000034000000000000000000000000000000000000000000000000000000000000005a00000000000000000000000000b55b053230e4effb6609de652fca73fd1c2980400000000000000000000000000000000000000000000000000000000000000e00000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000221000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000001200000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000006cdd519280ec730727f07aa36550bde31a1d5f3097818f3425c2f083ed33a91f080fa2afac0071f6e1af9a0e9c09b851bf01e68bc8a1c1f89f686c48205762f92500000000000000000000000000000000000000000000000000000000000000244242424242424242424242424242424242424242424242424242424242424242010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000827b226368616c6c656e6765223a224b51704d51446e7841757a726f68522d483878472d5a536b625249702d76515f5f5f4a714259357a655038222c2263726f73734f726967696e223a66616c73652c226f726967696e223a2268747470732f2f6974686163612e78797a222c2274797065223a22776562617574686e2e676574227d0000000000000000000000000000000000000000000000000000000000001bde17b8de18819c9eb86cefc3920ddb5d3d4254de276e3d6e18dd2b399f732b000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000) [delegatecall]\n ā”‚ ā”‚ ā”‚ ā”œā”€ [12963] 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913::transfer(0x327a25aD5Cfe5c4D4339C1A4267D4a83E8c93312, 1551)\n ā”‚ ā”‚ ā”‚ ā”‚ ā”œā”€ [12263] 0x2Ce6311ddAE708829bc0784C967b7d77D19FD779::transfer(0x327a25aD5Cfe5c4D4339C1A4267D4a83E8c93312, 1551) [delegatecall]\n ā”‚ ā”‚ ā”‚ ā”‚ ā”‚ ā”œā”€ emit Transfer(param0: 0xA12384c5E52fD646E7BC7F6B3b33A605651F566E, param1: 0x327a25aD5Cfe5c4D4339C1A4267D4a83E8c93312, param2: 1551)\n ā”‚ ā”‚ ā”‚ ā”‚ ā”‚ ā””ā”€ ā† [Return] 0x0000000000000000000000000000000000000000000000000000000000000001\n ā”‚ ā”‚ ā”‚ ā”‚ ā””ā”€ ā† [Return] 0x0000000000000000000000000000000000000000000000000000000000000001\n ā”‚ ā”‚ ā”‚ ā””ā”€ ā† [Stop]\n ā”‚ ā”‚ ā””ā”€ ā† [Return]\n ā”‚ ā”œā”€ [1250] 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913::balanceOf(0x327a25aD5Cfe5c4D4339C1A4267D4a83E8c93312) [staticcall]\n ā”‚ ā”‚ ā”œā”€ [553] 0x2Ce6311ddAE708829bc0784C967b7d77D19FD779::balanceOf(0x327a25aD5Cfe5c4D4339C1A4267D4a83E8c93312) [delegatecall]\n ā”‚ ā”‚ ā”‚ ā””ā”€ ā† [Return] 0x0000000000000000000000000000000000000000000000000000000000009c9a\n ā”‚ ā”‚ ā””ā”€ ā† [Return] 0x0000000000000000000000000000000000000000000000000000000000009c9a\n ā”‚ ā”œā”€ [5675] 0xc2FF493F28e894742b968A7DB5D3F21F0aD80C6c::multicallN2M_001Taw5z()\n ā”‚ ā”‚ ā”œā”€ [4148] 0xA12384c5E52fD646E7BC7F6B3b33A605651F566E::execute(0x0100000000007821000100000000000000000000000000000000000000000000, 0x0000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000201bde17b8de18819c9eb86cefc3920ddb5d3d4254de276e3d6e18dd2b399f732b)\n ā”‚ ā”‚ ā”‚ ā”œā”€ [3693] 0x0B55b053230E4EFFb6609de652fCa73Fd1C29804::execute(0x0100000000007821000100000000000000000000000000000000000000000000, 0x0000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000201bde17b8de18819c9eb86cefc3920ddb5d3d4254de276e3d6e18dd2b399f732b) [delegatecall]\n ā”‚ ā”‚ ā”‚ ā”‚ ā”œā”€ [435] 0xA12384c5E52fD646E7BC7F6B3b33A605651F566E::fallback()\n ā”‚ ā”‚ ā”‚ ā”‚ ā”‚ ā”œā”€ [55] 0x0B55b053230E4EFFb6609de652fCa73Fd1C29804::fallback() [delegatecall]\n ā”‚ ā”‚ ā”‚ ā”‚ ā”‚ ā”‚ ā””ā”€ ā† [Stop]\n ā”‚ ā”‚ ā”‚ ā”‚ ā”‚ ā””ā”€ ā† [Return]\n ā”‚ ā”‚ ā”‚ ā”‚ ā””ā”€ ā† [Stop]\n ā”‚ ā”‚ ā”‚ ā””ā”€ ā† [Return]\n ā”‚ ā”‚ ā””ā”€ ā† [Return] 0x0000000000000000000000000000000000000000000000000000000000000000\n ā”‚ ā””ā”€ ā† [Stop]\n ā”œā”€ emit topic 0: 0x31e2fdd22f7eeca688d70008a7bee8e41aa5640885c2bc592419ae8d09d889f1\n ā”‚ topic 1: 0x000000000000000000000000a12384c5e52fd646e7bc7f6b3b33a605651f566e\n ā”‚ topic 2: 0x0000000000000000000000000000000000000000000000000000000000000017\n ā”‚ data: 0x00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000\n ā””ā”€ ā† [Return] 0x0000000000000000000000000000000000000000000000000000000000000000\n\n\nTransaction successfully executed.\n[GAS]\n\n\"#]]);\n});\n\n// tests cast send gas estimate execution failure message contains decoded custom error\n// \nforgetest_async!(cast_send_estimate_gas_error, |prj, cmd| {\n let (_, handle) = anvil::spawn(NodeConfig::test()).await;\n\n foundry_test_utils::util::initialize(prj.root());\n prj.add_source(\n \"SimpleStorage\",\n r#\"\ncontract SimpleStorage {\n uint256 private storedValue;\n error AddressInsufficientBalance(address account, uint256 newValue);\n function setValue(uint256 _newValue) public {\n if (_newValue > 100) {\n revert AddressInsufficientBalance(msg.sender, _newValue);\n }\n storedValue = _newValue;\n }\n}\n \"#,\n );\n prj.add_script(\n \"SimpleStorageScript\",\n r#\"\nimport \"forge-std/Script.sol\";\nimport {SimpleStorage} from \"../src/SimpleStorage.sol\";\ncontract SimpleStorageScript is Script {\n function run() public {\n vm.startBroadcast();\n new SimpleStorage();\n vm.stopBroadcast();\n }\n}\n \"#,\n );\n\n cmd.args([\n \"script\",\n \"--private-key\",\n \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n \"--broadcast\",\n \"SimpleStorageScript\",\n ])\n .assert_success();\n\n // Cache project selectors.\n cmd.forge_fuse().set_current_dir(prj.root());\n cmd.forge_fuse().args([\"selectors\", \"cache\"]).assert_success();\n\n // Assert cast send can decode custom error on estimate gas execution failure.\n cmd.cast_fuse()\n .args([\n \"send\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3\",\n \"setValue(uint256)\",\n \"1000\",\n \"--private-key\",\n \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n ])\n .assert_failure().stderr_eq(str![[r#\"\nError: Failed to estimate gas: server returned an error response: error code 3: execution reverted: custom error 0x6786ad34: 000000000000000000000000f39fd6e51aad88f6f4ce6ab8827279cfffb9226600000000000000000000000000000000000000000000000000000000000003e8, data: \"0x6786ad34000000000000000000000000f39fd6e51aad88f6f4ce6ab8827279cfffb9226600000000000000000000000000000000000000000000000000000000000003e8\"[..]\n\n\"#]]);\n});\n\n// \ncasttest!(estimate_base_da, |_prj, cmd| {\n cmd.args([\"da-estimate\", \"30558838\", \"-r\", \"https://mainnet.base.org/\"])\n .assert_success()\n .stdout_eq(str![[r#\"\nEstimated data availability size for block 30558838 with 225 transactions: 52916546100\n\n\"#]]);\n});\n\n// \ncasttest!(cast_call_return_array_of_tuples, |_prj, cmd| {\n cmd.args([\n \"call\",\n \"0x198FC70Dfe05E755C81e54bd67Bff3F729344B9b\",\n \"facets() returns ((address,bytes4[])[])\",\n \"--rpc-url\",\n \"https://rpc.viction.xyz\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n[[..]]\n\n\"#]]);\n});\n\n// \ncasttest!(cast_call_on_contract_with_no_code_prints_warning, |_prj, cmd| {\n let eth_rpc_url = next_http_rpc_endpoint();\n cmd.args([\n \"call\",\n \"0x0000000000000000000000000000000000000000\",\n \"--rpc-url\",\n eth_rpc_url.as_str(),\n ])\n .assert_success()\n .stderr_eq(str![[r#\"\nWarning: Contract code is empty\n\n\"#]])\n .stdout_eq(str![[r#\"\n0x\n\n\"#]]);\n});\n\n// \ncasttest!(tx_raw_opstack_deposit, |_prj, cmd| {\n cmd.args([\n \"tx\",\n \"0xf403cba612d1c01c027455c0d97427ccd5f7f99aac30017e065f81d1e30244ea\",\n \"--raw\",\n \"-n\",\n \"optimism\",\n \"--rpc-url\",\n \"https://sepolia.base.org\",\n ]).assert_success()\n .stdout_eq(str![[r#\"\n0x7ef90207a0cbde10ec697aff886f95d2514bab434e455620627b9bb8ba33baaaa4d537d62794d45955f4de64f1840e5686e64278da901e263031944200000000000000000000000000000000000007872386f26fc10000872386f26fc1000083096c4980b901a4d764ad0b0001000000000000000000000000000000000000000000000000000000065132000000000000000000000000fd0bf71f60660e2f608ed56e1659c450eb1131200000000000000000000000004200000000000000000000000000000000000010000000000000000000000000000000000000000000000000002386f26fc1000000000000000000000000000000000000000000000000000000000000000493e000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000000a41635f5fd000000000000000000000000ca11bde05977b3631167028862be2a173976ca110000000000000000000000005703b26fe5a7be820db1bf34c901a79da1a46ba4000000000000000000000000000000000000000000000000002386f26fc100000000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\n\n\"#]]);\n});\n\ncasttest!(tx_raw_tempo, |_prj, cmd| {\n cmd.args([\n \"tx\",\n \"0xa24c6bbeea629a80be79e970a9749d0cbc6ee31625a0b75f585c173ab15a18ec\",\n \"--raw\",\n \"-n\",\n \"tempo\",\n \"--rpc-url\",\n \"https://rpc.moderato.tempo.xyz\",\n ]).assert_success()\n .stdout_eq(str![[r#\"\n0x76f8cf82a5bf1485059682f018830494e5f85ef85c9420c0000000000000000000007d9cc57068833ea780b84440c10f190000000000000000000000008a871f4189067637cfc4cc1500abd6244bf1df740000000000000000000000000000000000000000000000000000000005f5e100c08082057e80809420c000000000000000000000000000000000000080c0b841eb100c4cbd96903bf9e97968c0982670bb90fc191ee4544c7ff32d44e901dbea3f6fbdd58255051135c2fe1aa81583a270d96009cbe375f4605ef15971273a4f1b\n\n\"#]]);\n});\n\n// Test that cast send --create works correctly with constructor arguments\n// \nforgetest_async!(cast_send_create_with_constructor_args, |prj, cmd| {\n let (_api, handle) = anvil::spawn(NodeConfig::test()).await;\n let endpoint = handle.http_endpoint();\n\n // Deploy a simple contract with constructor arguments\n // Contract source that takes constructor args\n prj.add_source(\n \"ConstructorContract\",\n r#\"\ncontract ConstructorContract {\n uint256 public value;\n string public name;\n\n constructor(uint256 _value, string memory _name) {\n value = _value;\n name = _name;\n }\n\n function getValue() public view returns (uint256) {\n return value;\n }\n}\n\"#,\n );\n\n // Compile to get bytecode\n cmd.forge_fuse().args([\"build\"]).assert_success();\n\n // Get the compiled bytecode\n let bytecode_path = prj.root().join(\"out/ConstructorContract.sol/ConstructorContract.json\");\n let contract_json = std::fs::read_to_string(bytecode_path).unwrap();\n let contract_data: serde_json::Value = serde_json::from_str(&contract_json).unwrap();\n let bytecode = contract_data[\"bytecode\"][\"object\"].as_str().unwrap();\n\n // Use cast send --create with constructor arguments\n let output = cmd\n .cast_fuse()\n .args([\n \"send\",\n \"--private-key\",\n \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\",\n \"--rpc-url\",\n &endpoint,\n \"--create\",\n bytecode,\n \"constructor(uint256,string)\",\n \"42\",\n \"TestContract\",\n ])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n // Extract the deployed contract address from output\n let lines: Vec<&str> = output.lines().collect();\n let mut address = None;\n for line in lines {\n if line.contains(\"contractAddress\") {\n let parts: Vec<&str> = line.split_whitespace().collect();\n address = Some(parts[1]);\n break;\n }\n }\n let address = address.expect(\"Contract address not found in output\");\n\n // Verify the contract was deployed correctly by calling getValue()\n let value_output = cmd\n .cast_fuse()\n .args([\"call\", address, \"getValue()\", \"--rpc-url\", &endpoint])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n // The value should be 42 (0x2a in hex)\n assert!(\n value_output.contains(\"0x000000000000000000000000000000000000000000000000000000000000002a\")\n );\n});\n\n// Test that cast estimate --create works correctly with constructor arguments\n// \ncasttest!(cast_estimate_create_with_constructor_args, |prj, cmd| {\n let eth_rpc_url = next_http_rpc_endpoint();\n\n // Add a simple contract with constructor arguments\n prj.add_source(\n \"EstimateContract\",\n r#\"\ncontract EstimateContract {\n uint256 public value;\n string public name;\n\n constructor(uint256 _value, string memory _name) {\n value = _value;\n name = _name;\n }\n}\n\"#,\n );\n\n // Compile to get bytecode\n cmd.forge_fuse().args([\"build\"]).assert_success();\n\n // Get the compiled bytecode\n let bytecode_path = prj.root().join(\"out/EstimateContract.sol/EstimateContract.json\");\n let contract_json = std::fs::read_to_string(bytecode_path).unwrap();\n let contract_data: serde_json::Value = serde_json::from_str(&contract_json).unwrap();\n let bytecode = contract_data[\"bytecode\"][\"object\"].as_str().unwrap();\n\n let output = cmd\n .cast_fuse()\n .args([\n \"estimate\",\n \"--rpc-url\",\n eth_rpc_url.as_str(),\n \"--create\",\n bytecode,\n \"constructor(uint256,string)\",\n \"100\",\n \"TestContract\",\n ])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n // Parse the gas estimate\n let gas_estimate = output.trim().parse::().expect(\"Failed to parse gas estimate\");\n\n // Gas estimate should be positive and reasonable for contract deployment\n assert!(gas_estimate > 50000, \"Gas estimate too low for contract deployment\");\n assert!(gas_estimate < 5000000, \"Gas estimate unreasonably high\");\n});\n\n// Test edge case: empty constructor arguments\n// \nforgetest_async!(cast_send_create_empty_constructor, |prj, cmd| {\n let (_api, handle) = anvil::spawn(NodeConfig::test()).await;\n let endpoint = handle.http_endpoint();\n\n // Simple contract with no constructor arguments\n prj.add_source(\n \"SimpleContract\",\n r#\"\ncontract SimpleContract {\n uint256 public constant VALUE = 42;\n}\n\"#,\n );\n\n // Compile\n cmd.forge_fuse().args([\"build\"]).assert_success();\n\n // Get bytecode\n let bytecode_path = prj.root().join(\"out/SimpleContract.sol/SimpleContract.json\");\n let contract_json = std::fs::read_to_string(bytecode_path).unwrap();\n let contract_data: serde_json::Value = serde_json::from_str(&contract_json).unwrap();\n let bytecode = contract_data[\"bytecode\"][\"object\"].as_str().unwrap();\n\n // Deploy with empty constructor\n let output = cmd\n .cast_fuse()\n .args([\n \"send\",\n \"--private-key\",\n \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\",\n \"--rpc-url\",\n &endpoint,\n \"--create\",\n bytecode,\n \"constructor()\",\n ])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n // Verify deployment succeeded\n assert!(output.contains(\"contractAddress\"));\n});\n\n// Test complex constructor arguments (multiple types)\n// \nforgetest_async!(cast_send_create_complex_constructor, |prj, cmd| {\n let (_api, handle) = anvil::spawn(NodeConfig::test()).await;\n let endpoint = handle.http_endpoint();\n\n // Contract with complex constructor\n prj.add_source(\n \"ComplexContract\",\n r#\"\ncontract ComplexContract {\n address public owner;\n uint256[] public values;\n bool public active;\n\n constructor(address _owner, uint256[] memory _values, bool _active) {\n owner = _owner;\n values = _values;\n active = _active;\n }\n\n function getValuesLength() public view returns (uint256) {\n return values.length;\n }\n}\n\"#,\n );\n\n // Compile\n cmd.forge_fuse().args([\"build\"]).assert_success();\n\n // Get bytecode\n let bytecode_path = prj.root().join(\"out/ComplexContract.sol/ComplexContract.json\");\n let contract_json = std::fs::read_to_string(bytecode_path).unwrap();\n let contract_data: serde_json::Value = serde_json::from_str(&contract_json).unwrap();\n let bytecode = contract_data[\"bytecode\"][\"object\"].as_str().unwrap();\n\n // Deploy with complex arguments\n let output = cmd\n .cast_fuse()\n .args([\n \"send\",\n \"--private-key\",\n \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\",\n \"--rpc-url\",\n &endpoint,\n \"--create\",\n bytecode,\n \"constructor(address,uint256[],bool)\",\n \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\",\n \"[1,2,3,4,5]\",\n \"true\",\n ])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n // Extract deployed address\n let lines: Vec<&str> = output.lines().collect();\n let mut address = None;\n for line in lines {\n if line.contains(\"contractAddress\") {\n let parts: Vec<&str> = line.split_whitespace().collect();\n if parts.len() >= 2 {\n address = Some(parts[1]);\n break;\n }\n }\n }\n let address = address.expect(\"Contract address not found in output\");\n\n // Verify the array length was set correctly\n let length_output = cmd\n .cast_fuse()\n .args([\"call\", address, \"getValuesLength()\", \"--rpc-url\", &endpoint])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n // Should return 5 (0x5 in hex)\n assert!(\n length_output\n .contains(\"0x0000000000000000000000000000000000000000000000000000000000000005\")\n );\n});\n\ncasttest!(recover_authority, |_prj, cmd| {\n let auth = r#\"{\n \"chainId\": \"0x1\",\n \"address\": \"0xb684710e6d5914ad6e64493de2a3c424cc43e970\",\n \"nonce\": \"0x3dc1\",\n \"yParity\": \"0x1\",\n \"r\": \"0x2f15ba55009fcd3682cd0f9c9645dd94e616f9a969ba3f1a5a2d871f9fe0f2b4\",\n \"s\": \"0x53c332a83312d0b17dd4c16eeb15b1ff5223398b14e0a55c70762e8f3972b7a5\"\n }\"#;\n cmd.args([\"recover-authority\", auth]).assert_success().stdout_eq(str![[r#\"\n0x17816E9A858b161c3E37016D139cf618056CaCD4\n\n\"#]]);\n});\n\n// \n// tests `cast code --disassemble`\ncasttest!(can_disassemble_contract_code, |_prj, cmd| {\n let rpc = next_rpc_endpoint(NamedChain::Mainnet);\n cmd.args([\n \"code\",\n \"--disassemble\",\n \"--rpc-url\",\n rpc.as_str(),\n \"0x1F573D6Fb3F13d689FF844B4cE37794d79a7FF1C\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n00000000: PUSH1 0x60\n00000002: PUSH1 0x40\n00000004: MSTORE\n00000005: CALLDATASIZE\n00000006: ISZERO\n00000007: PUSH2 0x010f\n0000000a: JUMPI\n0000000b: PUSH4 0xffffffff\n00000010: PUSH29 0x0100000000000000000000000000000000000000000000000000000000\n0000002e: PUSH1 0x00\n...\n\"#]]);\n});\n\n// tests that cast call properly applies state diff override\n// \ncasttest!(cast_call_can_override_state_diff, |_prj, cmd| {\n let rpc = next_rpc_endpoint(NamedChain::Sepolia);\n cmd.args([\n \"call\",\n \"--rpc-url\",\n rpc.as_str(),\n \"--data\",\n \"0x\",\n \"0x1EA77b250eF79e917A5A637D5BB82D0980653F1B\",\n \"--override-state-diff\",\n \"0x1EA77b250eF79e917A5A637D5BB82D0980653F1B:1:1\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n0x1337\n\n\"#]]);\n cmd.args([\"--trace\"]).assert_success().stdout_eq(str![[r#\"\nTraces:\n [7281] 0x1EA77b250eF79e917A5A637D5BB82D0980653F1B::fallback()\n ā”œā”€ [2275] 0xe537cb8a46Bd179c0C36aB7E3Fdecd759C8B80fc::fallback() [delegatecall]\n ā”‚ ā””ā”€ ā† [Return] 0x1337\n ā””ā”€ ā† [Return] 0x1337\n\n\nTransaction successfully executed.\n[GAS]\n\n\"#]]);\n});\n\n// Tests for negative number argument parsing\n// Ensures that negative numbers in function arguments are properly parsed\n// instead of being treated as command flags\n\n// Test that cast call accepts negative numbers as function arguments\ncasttest!(cast_call_negative_numbers, |_prj, cmd| {\n let rpc = next_rpc_endpoint(NamedChain::Sepolia);\n // Test with negative int parameter - should not treat -456789 as a flag\n cmd.args([\n \"call\",\n \"0xAbCdEf1234567890aBcDeF1234567890aBcDeF12\",\n \"processValue(int128)\",\n \"-456789\",\n \"--rpc-url\",\n rpc.as_str(),\n ])\n .assert_success();\n});\n\n// Test negative numbers with multiple parameters\ncasttest!(cast_call_multiple_negative_numbers, |_prj, cmd| {\n let rpc = next_rpc_endpoint(NamedChain::Sepolia);\n cmd.args([\n \"call\",\n \"--rpc-url\",\n rpc.as_str(),\n \"0xDeaDBeeFcAfEbAbEfAcEfEeDcBaDbEeFcAfEbAbE\",\n \"calculateDelta(int64,int32,uint16)\",\n \"-987654321\",\n \"-42\",\n \"65535\",\n ])\n .assert_success();\n});\n\n// Test negative numbers mixed with flags\ncasttest!(cast_call_negative_with_flags, |_prj, cmd| {\n let rpc = next_rpc_endpoint(NamedChain::Sepolia);\n cmd.args([\n \"call\",\n \"--trace\", // flag before\n \"0x9876543210FeDcBa9876543210FeDcBa98765432\",\n \"updateBalance(int256)\",\n \"-777888\",\n \"--rpc-url\",\n rpc.as_str(), // flag after\n ])\n .assert_success();\n});\n\n// Test that actual invalid flags are still caught\ncasttest!(cast_call_invalid_flag_still_caught, |_prj, cmd| {\n cmd.args([\n \"call\",\n \"--invalid-flag\", // This should be caught as invalid\n \"0x5555555555555555555555555555555555555555\",\n ])\n .assert_failure()\n .stderr_eq(str![[r#\"\nerror: unexpected argument '--invalid-flag' found\n\n tip: to pass '--invalid-flag' as a value, use '-- --invalid-flag'\n\nUsage: cast[..] call [OPTIONS] [TO] [SIG] [ARGS]... [COMMAND]\n\nFor more information, try '--help'.\n\n\"#]]);\n});\n\n// Test cast estimate with negative numbers\ncasttest!(cast_estimate_negative_numbers, |_prj, cmd| {\n let rpc = next_rpc_endpoint(NamedChain::Sepolia);\n cmd.args([\n \"estimate\",\n \"0xBbBbBbBbBbBbBbBbBbBbBbBbBbBbBbBbBbBbBbBb\",\n \"rebalance(int64)\",\n \"-8888\",\n \"--rpc-url\",\n rpc.as_str(),\n ])\n .assert_success();\n});\n\n// Test cast mktx with negative numbers\ncasttest!(cast_mktx_negative_numbers, |_prj, cmd| {\n let rpc = next_rpc_endpoint(NamedChain::Sepolia);\n cmd.args([\n \"mktx\",\n \"0x1111111111111111111111111111111111111111\",\n \"settleDebt(int256)\",\n \"-15000\",\n \"--private-key\",\n \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\", // anvil wallet #0\n \"--rpc-url\",\n rpc.as_str(),\n \"--gas-limit\",\n \"100000\",\n ])\n .assert_success();\n});\n\n// Test cast mktx with EIP-4844 blob transaction (legacy format)\ncasttest!(cast_mktx_eip4844_blob, |prj, cmd| {\n // Create a temporary blob data file\n let blob_data = b\"dummy blob data for testing\";\n let blob_path = prj.root().join(\"blob_data.bin\");\n fs::write(&blob_path, blob_data).unwrap();\n\n cmd.args([\n \"mktx\",\n \"--private-key\",\n \"0x0000000000000000000000000000000000000000000000000000000000000001\",\n \"--chain\",\n \"1\",\n \"--nonce\",\n \"0\",\n \"--gas-limit\",\n \"100000\",\n \"--gas-price\",\n \"10000000000\",\n \"--priority-gas-price\",\n \"1000000000\",\n \"--blob\",\n \"--eip4844\",\n \"--blob-gas-price\",\n \"1000000\",\n \"--path\",\n blob_path.to_str().unwrap(),\n \"0x0000000000000000000000000000000000000001\",\n ])\n .assert_success();\n});\n\n// Test cast mktx with EIP-7594 blob transaction (default format)\ncasttest!(cast_mktx_eip7594_blob, |prj, cmd| {\n // Create a temporary blob data file\n let blob_data = b\"dummy peerdas blob data for testing\";\n let blob_path = prj.root().join(\"peerdas_blob_data.bin\");\n fs::write(&blob_path, blob_data).unwrap();\n\n cmd.args([\n \"mktx\",\n \"--private-key\",\n \"0x0000000000000000000000000000000000000000000000000000000000000001\",\n \"--chain\",\n \"1\",\n \"--nonce\",\n \"0\",\n \"--gas-limit\",\n \"100000\",\n \"--gas-price\",\n \"10000000000\",\n \"--priority-gas-price\",\n \"1000000000\",\n \"--blob\",\n \"--blob-gas-price\",\n \"1000000\",\n \"--path\",\n blob_path.to_str().unwrap(),\n \"0x0000000000000000000000000000000000000001\",\n ])\n .assert_success();\n});\n\n// Test cast access-list with negative numbers\ncasttest!(cast_access_list_negative_numbers, |_prj, cmd| {\n let rpc = next_rpc_endpoint(NamedChain::Sepolia);\n cmd.args([\n \"access-list\",\n \"0x9999999999999999999999999999999999999999\",\n \"adjustPosition(int128)\",\n \"-33333\",\n \"--gas-limit\",\n \"1000000\",\n \"--rpc-url\",\n rpc.as_str(),\n ])\n .assert_success();\n});\n\n// tests that cast call properly applies multiple state diff overrides\n// \ncasttest!(cast_call_can_override_several_state_diff, |_prj, cmd| {\n let rpc = next_http_archive_rpc_url();\n cmd.args([\n \"call\",\n \"--trace\",\n \"--from\",\n \"0xf6F444fD3B0088c1375671c05A7513661beFa4e6\",\n \"0x5EA1d9A6dDC3A0329378a327746D71A2019eC332\",\n \"--rpc-url\",\n rpc.as_str(),\n \"--block\",\n \"23290753\",\n \"--data\",\n \"0xe75235b8\",\n \"--override-state-diff\",\n \"0x5EA1d9A6dDC3A0329378a327746D71A2019eC332:0xf0af0268363540b847b4c07f2f9a0401c607c1b11ebca511724a71755dfd4137:1,0x5EA1d9A6dDC3A0329378a327746D71A2019eC332:4:1,0x5EA1d9A6dDC3A0329378a327746D71A2019eC332:0x4a204f620c8c5ccdca3fd54d003badd85ba500436a431f0cbda4f558c93c34c8:0,0x5EA1d9A6dDC3A0329378a327746D71A2019eC332:0xb104e0b93118902c651344349b610029d694cfdec91c589c91ebafbcd0289947:0\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n...\n [..] 0x5EA1d9A6dDC3A0329378a327746D71A2019eC332::getThreshold()\n...\n\n\"#]]);\n\n cmd.cast_fuse().args([\n \"call\",\n \"--trace\",\n \"--from\",\n \"0x2066901073a33ba2500274704aB04763875cF210\",\n \"0x5EA1d9A6dDC3A0329378a327746D71A2019eC332\",\n \"--rpc-url\",\n rpc.as_str(),\n \"--block\",\n \"23290753\",\n \"--data\",\n \"0x2f54bf6e0000000000000000000000002066901073a33ba2500274704ab04763875cf210\",\n \"--override-state-diff\",\n \"0x5EA1d9A6dDC3A0329378a327746D71A2019eC332:0xf0af0268363540b847b4c07f2f9a0401c607c1b11ebca511724a71755dfd4137:1,0x5EA1d9A6dDC3A0329378a327746D71A2019eC332:4:1,0x5EA1d9A6dDC3A0329378a327746D71A2019eC332:0x4a204f620c8c5ccdca3fd54d003badd85ba500436a431f0cbda4f558c93c34c8:0,0x5EA1d9A6dDC3A0329378a327746D71A2019eC332:0xb104e0b93118902c651344349b610029d694cfdec91c589c91ebafbcd0289947:0\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n...\n [..] 0x5EA1d9A6dDC3A0329378a327746D71A2019eC332::isOwner(0x2066901073a33ba2500274704aB04763875cF210)\n...\n\"#]]);\n});\n\ncasttest!(correct_json_serialization, |_prj, cmd| {\n let rpc = next_http_archive_rpc_url();\n // cast calldata \"decimals()\"\n let calldata = \"0x313ce567\";\n let tokens = [\n \"0xdac17f958d2ee523a2206206994597c13d831ec7\", // USDT\n \"0x6b175474e89094c44da98b954eedeac495271d0f\", // DAI\n \"0x6b175474e89094c44da98b954eedeac495271d0f\", // WETH\n ];\n let calldata_args = format!(\n \"[{}]\",\n tokens\n .iter()\n .map(|token| format!(\"({token},false,{calldata})\"))\n .collect::>()\n .join(\",\")\n );\n let args = vec![\n \"call\",\n \"--json\",\n \"--rpc-url\",\n rpc.as_str(),\n \"0xcA11bde05977b3631167028862bE2a173976CA11\",\n \"aggregate3((address,bool,bytes)[])((bool,bytes)[])\",\n &calldata_args,\n ];\n let expected_output = json!([[\n [true, \"0x0000000000000000000000000000000000000000000000000000000000000006\"],\n [true, \"0x0000000000000000000000000000000000000000000000000000000000000012\"],\n [true, \"0x0000000000000000000000000000000000000000000000000000000000000012\"]\n ]]);\n let decoded: serde_json::Value =\n serde_json::from_slice(&cmd.args(args).assert_success().get_output().stdout)\n .expect(\"not valid json\");\n assert_eq!(decoded, expected_output);\n});\n\n// Test cast abi-encode-event with indexed parameters\ncasttest!(abi_encode_event_indexed, |_prj, cmd| {\n cmd.args([\n \"abi-encode-event\",\n \"Transfer(address indexed from, address indexed to, uint256 value)\",\n \"0x1234567890123456789012345678901234567890\",\n \"0xabcdefabcdefabcdefabcdefabcdefabcdefabcd\",\n \"1000\",\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n[topic0]: 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef\n[topic1]: 0x0000000000000000000000001234567890123456789012345678901234567890\n[topic2]: 0x000000000000000000000000abcdefabcdefabcdefabcdefabcdefabcdefabcd\n[data]: 0x00000000000000000000000000000000000000000000000000000000000003e8\n\n\"#]]);\n});\n\n// Test cast abi-encode-event with no indexed parameters\ncasttest!(abi_encode_event_no_indexed, |_prj, cmd| {\n cmd.args([\n \"abi-encode-event\",\n \"Approval(address owner, address spender, uint256 value)\",\n \"0x1234567890123456789012345678901234567890\",\n \"0xabcdefabcdefabcdefabcdefabcdefabcdefabcd\",\n \"2000\"\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\n[topic0]: 0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925\n[data]: 0x0000000000000000000000001234567890123456789012345678901234567890000000000000000000000000abcdefabcdefabcdefabcdefabcdefabcdefabcd00000000000000000000000000000000000000000000000000000000000007d0\n\n\"#]]);\n});\n\n// Test cast abi-encode-event with dynamic indexed parameter (string)\ncasttest!(abi_encode_event_dynamic_indexed, |_prj, cmd| {\n cmd.args([\"abi-encode-event\", \"Log(string indexed message, uint256 data)\", \"hello\", \"42\"])\n .assert_success()\n .stdout_eq(str![[r#\"\n[topic0]: 0xdd970dd9b5bfe707922155b058a407655cb18288b807e2216442bca8ad83d6b5\n[topic1]: 0x984002fcc0ca639f96622add24c2edd2fe72c65e71ca3faa243e091e0bc7cdab\n[data]: 0x000000000000000000000000000000000000000000000000000000000000002a\n\n\"#]]);\n});\n\n// Test cast run Celo transfer with precompiles.\ncasttest!(\n #[ignore = \"requires debug_traceTransaction, which most free Celo RPC endpoints no longer support\"]\n flaky_run_celo_with_precompiles,\n |_prj, cmd| {\n let rpc = next_rpc_endpoint(NamedChain::Celo);\n cmd.args([\n \"run\",\n \"0xa652b9f41bb1a617ea6b2835b3316e79f0f21b8264e7bcd20e57c4092a70a0f6\",\n \"--quick\",\n \"--rpc-url\",\n rpc.as_str(),\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\nTraces:\n [17776] 0x471EcE3750Da237f93B8E339c536989b8978a438::transfer(0xD2eB2d37d238Caeff39CFA36A013299C6DbAC56A, 138000000000000000 [1.38e17])\n ā”œā”€ [12370] 0xFeA1B35f1D5f2A58532a70e7A32e6F2D3Bc4F7B1::transfer(0xD2eB2d37d238Caeff39CFA36A013299C6DbAC56A, 138000000000000000 [1.38e17]) [delegatecall]\n ā”‚ ā”œā”€ [9000] CELO_TRANSFER_PRECOMPILE::00000000(00000000000000008106680ba7095cfd8f4351a8b7041da3060afb83000000000000000000000000d2eb2d37d238caeff39cfa36a013299c6dbac56a00000000000000000000000000000000000000000000000001ea4644d3010000)\n ā”‚ ā”‚ ā””ā”€ ā† [Return]\n ā”‚ ā”œā”€ emit Transfer(param0: 0x8106680Ba7095CfD8F4351a8B7041da3060Afb83, param1: 0xD2eB2d37d238Caeff39CFA36A013299C6DbAC56A, param2: 138000000000000000 [1.38e17])\n ā”‚ ā””ā”€ ā† [Return] 0x0000000000000000000000000000000000000000000000000000000000000001\n ā””ā”€ ā† [Return] 0x0000000000000000000000000000000000000000000000000000000000000001\n\n\nTransaction successfully executed.\n[GAS]\n\n\"#]]);\n }\n);\ncasttest!(keccak_stdin_bytes, |_prj, cmd| {\n cmd.args([\"keccak\"]).stdin(\"0x12\").assert_success().stdout_eq(str![[r#\"\n0x5fa2358263196dbbf23d1ca7a509451f7a2f64c15837bfbb81298b1e3e24e4fa\n\n\"#]]);\n});\n\ncasttest!(keccak_stdin_bytes_with_newline, |_prj, cmd| {\n cmd.args([\"keccak\"]).stdin(\"0x12\\n\").assert_success().stdout_eq(str![[r#\"\n0x5fa2358263196dbbf23d1ca7a509451f7a2f64c15837bfbb81298b1e3e24e4fa\n\n\"#]]);\n});\n\n// Test cast send with raw --data flag using encoded calldata\nforgetest_async!(cast_send_with_data, |prj, cmd| {\n let (api, handle) = anvil::spawn(NodeConfig::test()).await;\n\n foundry_test_utils::util::initialize(prj.root());\n prj.initialize_default_contracts();\n\n // Deploy counter contract\n cmd.args([\n \"script\",\n \"--private-key\",\n \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n \"--broadcast\",\n \"CounterScript\",\n ])\n .assert_success();\n\n // setNumber(111) encoded: selector 0x3fb5c1cb + uint256(111)\n let calldata = \"0x3fb5c1cb000000000000000000000000000000000000000000000000000000000000006f\";\n\n // Send tx using --data instead of sig+args\n cmd.cast_fuse()\n .args([\n \"send\",\n \"0x5FbDB2315678afecb367f032d93F642f64180aa3\",\n \"--data\",\n calldata,\n \"--private-key\",\n \"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n ])\n .assert_success();\n\n // Verify via trace that setNumber(111) was called\n let tx_hash = api\n .transaction_by_block_number_and_index(BlockNumberOrTag::Latest, Index::from(0))\n .await\n .unwrap()\n .unwrap()\n .tx_hash();\n\n cmd.cast_fuse()\n .args([\n \"run\",\n format!(\"{tx_hash}\").as_str(),\n \"-vvvvv\",\n \"--rpc-url\",\n &handle.http_endpoint(),\n ])\n .assert_success()\n .stdout_eq(str![[r#\"\nExecuting previous transactions from the block.\nTraces:\n [..] 0x5FbDB2315678afecb367f032d93F642f64180aa3::setNumber(111)\n ā”œā”€ storage changes:\n ā”‚ @ 0: 0 ā†’ 111\n ā””ā”€ ā† [Stop]\n\n\nTransaction successfully executed.\n[GAS]\n\n\"#]]);\n});\n\n// tests that the --curl flag outputs a valid curl command for cast rpc\ncasttest!(curl_rpc, |_prj, cmd| {\n let rpc = \"https://eth.example.com\";\n\n let output = cmd\n .args([\"rpc\", \"eth_blockNumber\", \"--rpc-url\", rpc, \"--curl\"])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n // Verify curl command structure\n assert!(output.contains(\"curl -X POST\"));\n assert!(output.contains(\"-H 'Content-Type: application/json'\"));\n assert!(output.contains(\"eth_blockNumber\"));\n assert!(output.contains(\"jsonrpc\"));\n assert!(output.contains(rpc));\n});\n\n// tests that the --curl flag outputs a valid curl command for cast block-number\ncasttest!(curl_block_number, |_prj, cmd| {\n let rpc = \"https://eth.example.com\";\n\n let output = cmd\n .args([\"block-number\", \"--rpc-url\", rpc, \"--curl\"])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n // Verify curl command structure\n assert!(output.contains(\"curl -X POST\"));\n assert!(output.contains(\"eth_blockNumber\"));\n assert!(output.contains(rpc));\n});\n\n// tests that the --curl flag outputs a valid curl command for cast chain-id\ncasttest!(curl_chain_id, |_prj, cmd| {\n let rpc = \"https://eth.example.com\";\n\n let output = cmd\n .args([\"chain-id\", \"--rpc-url\", rpc, \"--curl\"])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n // Verify curl command structure\n assert!(output.contains(\"curl -X POST\"));\n assert!(output.contains(\"eth_chainId\"));\n assert!(output.contains(rpc));\n});\n\n// tests that the --curl flag outputs a valid curl command for cast gas-price\ncasttest!(curl_gas_price, |_prj, cmd| {\n let rpc = \"https://eth.example.com\";\n\n let output = cmd\n .args([\"gas-price\", \"--rpc-url\", rpc, \"--curl\"])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n // Verify curl command structure\n assert!(output.contains(\"curl -X POST\"));\n assert!(output.contains(\"eth_gasPrice\"));\n assert!(output.contains(rpc));\n});\n\n// tests that the --curl flag outputs a valid curl command for cast call\ncasttest!(curl_call, |_prj, cmd| {\n let rpc = \"https://eth.example.com\";\n let to = \"0xdead000000000000000000000000000000000000\";\n\n let output = cmd\n .args([\"call\", to, \"balanceOf(address)(uint256)\", to, \"--rpc-url\", rpc, \"--curl\"])\n .assert_success()\n .get_output()\n .stdout_lossy();\n\n // Verify curl command structure\n assert!(output.contains(\"curl -X POST\"));\n assert!(output.contains(\"eth_call\"));\n assert!(output.contains(rpc));\n});\n\n// https://github.com/foundry-rs/foundry/issues/11584\n// Tests that invalid hex calldata (odd length) produces a clear error message\ncasttest!(cast_call_invalid_hex_calldata_error, |_prj, cmd| {\n let rpc = next_rpc_endpoint(NamedChain::Mainnet);\n cmd.args([\n \"call\",\n \"0xdead000000000000000000000000000000000000\",\n \"--data\",\n \"0x0\", // Invalid: odd length hex\n \"--rpc-url\",\n rpc.as_str(),\n ])\n .assert_failure()\n .stderr_eq(str![[r#\"\nError: Invalid hex calldata '0x0': odd number of digits\n\n\"#]]);\n});\n\n// https://github.com/foundry-rs/foundry/issues/11584\n// Tests that valid hex calldata works correctly\ncasttest!(cast_call_valid_hex_calldata, |_prj, cmd| {\n let rpc = next_rpc_endpoint(NamedChain::Mainnet);\n cmd.args([\n \"call\",\n \"0xdead000000000000000000000000000000000000\",\n \"--data\",\n \"0x00\", // Valid: even length hex\n \"--rpc-url\",\n rpc.as_str(),\n ])\n .assert_success();\n});\n\n// https://github.com/foundry-rs/foundry/issues/11584\n// Tests that invalid hex with uppercase 0X prefix also produces clear error\ncasttest!(cast_call_invalid_hex_uppercase_prefix, |_prj, cmd| {\n let rpc = next_rpc_endpoint(NamedChain::Mainnet);\n cmd.args([\n \"call\",\n \"0xdead000000000000000000000000000000000000\",\n \"--data\",\n \"0X1\", // Invalid: odd length hex with uppercase prefix\n \"--rpc-url\",\n rpc.as_str(),\n ])\n .assert_failure()\n .stderr_eq(str![[r#\"\nError: Invalid hex calldata '0X1': odd number of digits\n\n\"#]]);\n});\n" }, { "path": "crates/cast/tests/cli/selectors.rs", "content": "use foundry_test_utils::util::OutputExt;\nuse std::path::Path;\n\ncasttest!(flaky_error_decode_with_openchain, |prj, cmd| {\n prj.clear_cache();\n cmd.args([\"decode-error\", \"0x7a0e198500000000000000000000000000000000000000000000000000000000000000650000000000000000000000000000000000000000000000000000000000000064\"]).assert_success().stdout_eq(str![[r#\"\nValueTooHigh(uint256,uint256)\n101\n100\n\n\"#]]);\n});\n\ncasttest!(flaky_fourbyte, |_prj, cmd| {\n cmd.args([\"4byte\", \"0xa9059cbb\"]).assert_success().stdout_eq(str![[r#\"\ntransfer(address,uint256)\n\n\"#]]);\n});\n\ncasttest!(fourbyte_invalid, |_prj, cmd| {\n cmd.args([\"4byte\", \"0xa9059c\"]).assert_failure().stderr_eq(str![[r#\"\nerror: invalid value '0xa9059c' for '[SELECTOR]': invalid string length\n\nFor more information, try '--help'.\n\n\"#]]);\n});\n\ncasttest!(flaky_fourbyte_calldata, |_prj, cmd| {\n cmd.args([\"4byte-calldata\", \"0xa9059cbb0000000000000000000000000a2ac0c368dc8ec680a0c98c907656bd970675950000000000000000000000000000000000000000000000000000000767954a79\"]).assert_success().stdout_eq(str![[r#\"\n1) \"transfer(address,uint256)\"\n0x0A2AC0c368Dc8eC680a0c98C907656BD97067595\n31802608249 [3.18e10]\n\n\"#]]);\n});\n\ncasttest!(flaky_fourbyte_calldata_only_selector, |_prj, cmd| {\n cmd.args([\"4byte-calldata\", \"0xa9059cbb\"]).assert_success().stdout_eq(str![[r#\"\ntransfer(address,uint256)\n\n\"#]]);\n});\n\ncasttest!(flaky_fourbyte_calldata_alias, |_prj, cmd| {\n cmd.args([\"4byte-decode\", \"0xa9059cbb0000000000000000000000000a2ac0c368dc8ec680a0c98c907656bd970675950000000000000000000000000000000000000000000000000000000767954a79\"]).assert_success().stdout_eq(str![[r#\"\n1) \"transfer(address,uint256)\"\n0x0A2AC0c368Dc8eC680a0c98C907656BD97067595\n31802608249 [3.18e10]\n\n\"#]]);\n});\n\ncasttest!(flaky_fourbyte_event, |_prj, cmd| {\n cmd.args([\"4byte-event\", \"0x7e1db2a1cd12f0506ecd806dba508035b290666b84b096a87af2fd2a1516ede6\"])\n .assert_success()\n .stdout_eq(str![[r#\"\nupdateAuthority(address,uint8)\n\n\"#]]);\n});\n\ncasttest!(flaky_fourbyte_event_2, |_prj, cmd| {\n cmd.args([\"4byte-event\", \"0xb7009613e63fb13fd59a2fa4c206a992c1f090a44e5d530be255aa17fed0b3dd\"])\n .assert_success()\n .stdout_eq(str![[r#\"\ncanCall(address,address,bytes4)\n\n\"#]]);\n});\n\ncasttest!(flaky_upload_signatures, |_prj, cmd| {\n // test no prefix is accepted as function\n let output = cmd\n .args([\"upload-signature\", \"transfer(address,uint256)\"])\n .assert_success()\n .get_output()\n .stdout_lossy();\n assert!(output.contains(\"Function transfer(address,uint256): 0xa9059cbb\"), \"{}\", output);\n\n // test event prefix\n cmd.args([\"upload-signature\", \"event Transfer(address,uint256)\"]);\n let output = cmd.assert_success().get_output().stdout_lossy();\n assert!(output.contains(\"Event Transfer(address,uint256): 0x69ca02dd4edd7bf0a4abb9ed3b7af3f14778db5d61921c7dc7cd545266326de2\"), \"{}\", output);\n\n // test error prefix\n cmd.args([\"upload-signature\", \"error ERC20InsufficientBalance(address,uint256,uint256)\"]);\n let output = cmd.assert_success().get_output().stdout_lossy();\n assert!(\n output.contains(\"Function ERC20InsufficientBalance(address,uint256,uint256): 0xe450d38c\"),\n \"{}\",\n output\n ); // Custom error is interpreted as function\n\n // test multiple sigs\n cmd.args([\n \"upload-signature\",\n \"event Transfer(address,uint256)\",\n \"transfer(address,uint256)\",\n \"approve(address,uint256)\",\n ]);\n let output = cmd.assert_success().get_output().stdout_lossy();\n assert!(output.contains(\"Event Transfer(address,uint256): 0x69ca02dd4edd7bf0a4abb9ed3b7af3f14778db5d61921c7dc7cd545266326de2\"), \"{}\", output);\n assert!(output.contains(\"Function transfer(address,uint256): 0xa9059cbb\"), \"{}\", output);\n assert!(output.contains(\"Function approve(address,uint256): 0x095ea7b3\"), \"{}\", output);\n\n // test abi\n cmd.args([\n \"upload-signature\",\n \"event Transfer(address,uint256)\",\n \"transfer(address,uint256)\",\n \"error ERC20InsufficientBalance(address,uint256,uint256)\",\n Path::new(env!(\"CARGO_MANIFEST_DIR\"))\n .join(\"tests/fixtures/ERC20Artifact.json\")\n .as_os_str()\n .to_str()\n .unwrap(),\n ]);\n let output = cmd.assert_success().get_output().stdout_lossy();\n assert!(output.contains(\"Event Transfer(address,uint256): 0x69ca02dd4edd7bf0a4abb9ed3b7af3f14778db5d61921c7dc7cd545266326de2\"), \"{}\", output);\n assert!(output.contains(\"Function transfer(address,uint256): 0xa9059cbb\"), \"{}\", output);\n assert!(output.contains(\"Function approve(address,uint256): 0x095ea7b3\"), \"{}\", output);\n assert!(output.contains(\"Function decimals(): 0x313ce567\"), \"{}\", output);\n assert!(output.contains(\"Function allowance(address,address): 0xdd62ed3e\"), \"{}\", output);\n assert!(\n output.contains(\"Function ERC20InsufficientBalance(address,uint256,uint256): 0xe450d38c\"),\n \"{}\",\n output\n );\n});\n\n// tests cast can decode event with provided signature\ncasttest!(event_decode_with_sig, |_prj, cmd| {\n cmd.args([\"decode-event\", \"--sig\", \"MyEvent(uint256,address)\", \"0x000000000000000000000000000000000000000000000000000000000000004e0000000000000000000000000000000000000000000000000000000000d0004f\"]).assert_success().stdout_eq(str![[r#\"\n78\n0x0000000000000000000000000000000000D0004F\n\n\"#]]);\n\n cmd.args([\"--json\"]).assert_success().stdout_eq(str![[r#\"\n[\n 78,\n \"0x0000000000000000000000000000000000D0004F\"\n]\n\n\"#]]);\n});\n\n// tests cast can decode event with Openchain API\ncasttest!(flaky_event_decode_with_openchain, |prj, cmd| {\n prj.clear_cache();\n cmd.args([\"decode-event\", \"0xe27c4c1372396a3d15a9922f74f9dfc7c72b1ad6d63868470787249c356454c1000000000000000000000000000000000000000000000000000000000000004e00000000000000000000000000000000000000000000000000000dd00000004e\"]).assert_success().stdout_eq(str![[r#\"\nBaseCurrencySet(address,uint256)\n0x000000000000000000000000000000000000004e\n15187004358734 [1.518e13]\n\n\"#]]);\n});\n\n// tests cast can decode error with provided signature\ncasttest!(error_decode_with_sig, |_prj, cmd| {\n cmd.args([\"decode-error\", \"--sig\", \"AnotherValueTooHigh(uint256,address)\", \"0x7191bc6200000000000000000000000000000000000000000000000000000000000000650000000000000000000000000000000000000000000000000000000000D0004F\"]).assert_success().stdout_eq(str![[r#\"\n101\n0x0000000000000000000000000000000000D0004F\n\n\"#]]);\n\n cmd.args([\"--json\"]).assert_success().stdout_eq(str![[r#\"\n[\n 101,\n \"0x0000000000000000000000000000000000D0004F\"\n]\n\n\"#]]);\n});\n\n// tests cast can decode error and event when using local sig identifiers cache\nforgetest_init!(flaky_error_event_decode_with_cache, |prj, cmd| {\n prj.add_source(\n \"LocalProjectContract\",\n r#\"\ncontract ContractWithCustomError {\n error AnotherValueTooHigh(uint256, address);\n event MyUniqueEventWithinLocalProject(uint256 a, address b);\n}\n \"#,\n );\n // Build and cache project selectors.\n cmd.forge_fuse().args([\"build\"]).assert_success();\n cmd.forge_fuse().args([\"selectors\", \"cache\"]).assert_success();\n\n // Assert cast can decode custom error with local cache.\n cmd.cast_fuse()\n .args([\"decode-error\", \"0x7191bc6200000000000000000000000000000000000000000000000000000000000000650000000000000000000000000000000000000000000000000000000000D0004F\"])\n .assert_success()\n .stdout_eq(str![[r#\"\nAnotherValueTooHigh(uint256,address)\n101\n0x0000000000000000000000000000000000D0004F\n\n\"#]]);\n // Assert cast can decode event with local cache.\n cmd.cast_fuse()\n .args([\"decode-event\", \"0xbd3699995dcc867b64dbb607be2c33be38df9134bef1178df13bfb9446e73104000000000000000000000000000000000000000000000000000000000000004e00000000000000000000000000000000000000000000000000000dd00000004e\"])\n .assert_success()\n .stdout_eq(str![[r#\"\nMyUniqueEventWithinLocalProject(uint256,address)\n78\n0x00000000000000000000000000000DD00000004e\n\n\"#]]);\n});\n\nforgetest!(flaky_cache_selectors_from_extra_abis, |prj, cmd| {\n // Create folder with ABI JSON files containing a unique error\n let abis_dir = prj.root().join(\"external_abis\");\n std::fs::create_dir(&abis_dir).unwrap();\n std::fs::write(\n abis_dir.join(\"test.json\"),\n r#\"[{\n \"type\": \"error\",\n \"name\": \"MyUniqueExtraAbiError\",\n \"inputs\": [\n {\"name\": \"value\", \"type\": \"uint256\"},\n {\"name\": \"flag\", \"type\": \"bool\"}\n ]\n }]\"#,\n )\n .unwrap();\n\n cmd.forge_fuse()\n .args([\"selectors\", \"cache\", \"--extra-abis-path\", abis_dir.to_str().unwrap()])\n .assert_success();\n\n // Verify with cast decode-error (uses local cache via SignaturesIdentifier)\n // Selector for MyUniqueExtraAbiError(uint256,bool) is 0x7819b107\n // Encoded: selector + uint256(42) + bool(true)\n cmd.cast_fuse()\n .args([\"decode-error\", \"0x7819b107000000000000000000000000000000000000000000000000000000000000002a0000000000000000000000000000000000000000000000000000000000000001\"])\n .assert_success()\n .stdout_eq(str![[r#\"\nMyUniqueExtraAbiError(uint256,bool)\n42\ntrue\n\n\"#]]);\n});\n" }, { "path": "crates/cast/tests/fixtures/ERC20Artifact.json", "content": "{\"abi\":[{\"inputs\":[{\"internalType\":\"string\",\"name\":\"name\",\"type\":\"string\"},{\"internalType\":\"string\",\"name\":\"symbol\",\"type\":\"string\"},{\"internalType\":\"uint8\",\"name\":\"decimals\",\"type\":\"uint8\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"owner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"spender\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"Approval\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"from\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"Transfer\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"DOMAIN_SEPARATOR\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"allowance\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"spender\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"approve\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"balanceOf\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"decimals\",\"outputs\":[{\"internalType\":\"uint8\",\"name\":\"\",\"type\":\"uint8\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"mint\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"name\",\"outputs\":[{\"internalType\":\"string\",\"name\":\"\",\"type\":\"string\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"nonces\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"owner\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"spender\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"value\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"deadline\",\"type\":\"uint256\"},{\"internalType\":\"uint8\",\"name\":\"v\",\"type\":\"uint8\"},{\"internalType\":\"bytes32\",\"name\":\"r\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"s\",\"type\":\"bytes32\"}],\"name\":\"permit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"symbol\",\"outputs\":[{\"internalType\":\"string\",\"name\":\"\",\"type\":\"string\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"totalSupply\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"transfer\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"from\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"transferFrom\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}],\"bytecode\":{\"object\":\"0x60e06040523480156200001157600080fd5b5060405162000f7738038062000f7783398101604081905262000034916200029a565b82828282600090805190602001906200004f92919062000127565b5081516200006590600190602085019062000127565b5060ff81166080524660a0526200007b6200008b565b60c0525062000400945050505050565b60007f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f6000604051620000bf91906200035c565b6040805191829003822060208301939093528101919091527fc89efdaa54c0f20c7adf612882df0950f5a951637e0307cdcb4c672f298b8bc660608201524660808201523060a082015260c00160405160208183030381529060405280519060200120905090565b82805462000135906200031f565b90600052602060002090601f016020900481019282620001595760008555620001a4565b82601f106200017457805160ff1916838001178555620001a4565b82800160010185558215620001a4579182015b82811115620001a457825182559160200191906001019062000187565b50620001b2929150620001b6565b5090565b5b80821115620001b25760008155600101620001b7565b634e487b7160e01b600052604160045260246000fd5b600082601f830112620001f557600080fd5b81516001600160401b0380821115620002125762000212620001cd565b604051601f8301601f19908116603f011681019082821181831017156200023d576200023d620001cd565b816040528381526020925086838588010111156200025a57600080fd5b600091505b838210156200027e57858201830151818301840152908201906200025f565b83821115620002905760008385830101525b9695505050505050565b600080600060608486031215620002b057600080fd5b83516001600160401b0380821115620002c857600080fd5b620002d687838801620001e3565b94506020860151915080821115620002ed57600080fd5b50620002fc86828701620001e3565b925050604084015160ff811681146200031457600080fd5b809150509250925092565b600181811c908216806200033457607f821691505b602082108114156200035657634e487b7160e01b600052602260045260246000fd5b50919050565b600080835481600182811c9150808316806200037957607f831692505b60208084108214156200039a57634e487b7160e01b86526022600452602486fd5b818015620003b15760018114620003c357620003f2565b60ff19861689528489019650620003f2565b60008a81526020902060005b86811015620003ea5781548b820152908501908301620003cf565b505084890196505b509498975050505050505050565b60805160a05160c051610b476200043060003960006104530152600061041e015260006101440152610b476000f3fe608060405234801561001057600080fd5b50600436106100cf5760003560e01c806340c10f191161008c57806395d89b411161006657806395d89b41146101d5578063a9059cbb146101dd578063d505accf146101f0578063dd62ed3e1461020357600080fd5b806340c10f191461018057806370a08231146101955780637ecebe00146101b557600080fd5b806306fdde03146100d4578063095ea7b3146100f257806318160ddd1461011557806323b872dd1461012c578063313ce5671461013f5780633644e51514610178575b600080fd5b6100dc61022e565b6040516100e99190610856565b60405180910390f35b6101056101003660046108c7565b6102bc565b60405190151581526020016100e9565b61011e60025481565b6040519081526020016100e9565b61010561013a3660046108f1565b610328565b6101667f000000000000000000000000000000000000000000000000000000000000000081565b60405160ff90911681526020016100e9565b61011e61041a565b61019361018e3660046108c7565b610475565b005b61011e6101a336600461092d565b60036020526000908152604090205481565b61011e6101c336600461092d565b60056020526000908152604090205481565b6100dc610483565b6101056101eb3660046108c7565b610490565b6101936101fe36600461094f565b610508565b61011e6102113660046109c2565b600460209081526000928352604080842090915290825290205481565b6000805461023b906109f5565b80601f0160208091040260200160405190810160405280929190818152602001828054610267906109f5565b80156102b45780601f10610289576101008083540402835291602001916102b4565b820191906000526020600020905b81548152906001019060200180831161029757829003601f168201915b505050505081565b3360008181526004602090815260408083206001600160a01b038716808552925280832085905551919290917f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925906103179086815260200190565b60405180910390a350600192915050565b6001600160a01b038316600090815260046020908152604080832033845290915281205460001981146103845761035f8382610a46565b6001600160a01b03861660009081526004602090815260408083203384529091529020555b6001600160a01b038516600090815260036020526040812080548592906103ac908490610a46565b90915550506001600160a01b03808516600081815260036020526040908190208054870190555190918716907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef906104079087815260200190565b60405180910390a3506001949350505050565b60007f000000000000000000000000000000000000000000000000000000000000000046146104505761044b610751565b905090565b507f000000000000000000000000000000000000000000000000000000000000000090565b61047f82826107eb565b5050565b6001805461023b906109f5565b336000908152600360205260408120805483919083906104b1908490610a46565b90915550506001600160a01b038316600081815260036020526040908190208054850190555133907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef906103179086815260200190565b4284101561055d5760405162461bcd60e51b815260206004820152601760248201527f5045524d49545f444541444c494e455f4558504952454400000000000000000060448201526064015b60405180910390fd5b6000600161056961041a565b6001600160a01b038a811660008181526005602090815260409182902080546001810190915582517f6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c98184015280840194909452938d166060840152608083018c905260a083019390935260c08083018b90528151808403909101815260e08301909152805192019190912061190160f01b6101008301526101028201929092526101228101919091526101420160408051601f198184030181528282528051602091820120600084529083018083525260ff871690820152606081018590526080810184905260a0016020604051602081039080840390855afa158015610675573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b038116158015906106ab5750876001600160a01b0316816001600160a01b0316145b6106e85760405162461bcd60e51b815260206004820152600e60248201526d24a72b20a624a22fa9a4a3a722a960911b6044820152606401610554565b6001600160a01b0390811660009081526004602090815260408083208a8516808552908352928190208990555188815291928a16917f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925910160405180910390a350505050505050565b60007f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f60006040516107839190610a5d565b6040805191829003822060208301939093528101919091527fc89efdaa54c0f20c7adf612882df0950f5a951637e0307cdcb4c672f298b8bc660608201524660808201523060a082015260c00160405160208183030381529060405280519060200120905090565b80600260008282546107fd9190610af9565b90915550506001600160a01b0382166000818152600360209081526040808320805486019055518481527fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef910160405180910390a35050565b600060208083528351808285015260005b8181101561088357858101830151858201604001528201610867565b81811115610895576000604083870101525b50601f01601f1916929092016040019392505050565b80356001600160a01b03811681146108c257600080fd5b919050565b600080604083850312156108da57600080fd5b6108e3836108ab565b946020939093013593505050565b60008060006060848603121561090657600080fd5b61090f846108ab565b925061091d602085016108ab565b9150604084013590509250925092565b60006020828403121561093f57600080fd5b610948826108ab565b9392505050565b600080600080600080600060e0888a03121561096a57600080fd5b610973886108ab565b9650610981602089016108ab565b95506040880135945060608801359350608088013560ff811681146109a557600080fd5b9699959850939692959460a0840135945060c09093013592915050565b600080604083850312156109d557600080fd5b6109de836108ab565b91506109ec602084016108ab565b90509250929050565b600181811c90821680610a0957607f821691505b60208210811415610a2a57634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b600082821015610a5857610a58610a30565b500390565b600080835481600182811c915080831680610a7957607f831692505b6020808410821415610a9957634e487b7160e01b86526022600452602486fd5b818015610aad5760018114610abe57610aeb565b60ff19861689528489019650610aeb565b60008a81526020902060005b86811015610ae35781548b820152908501908301610aca565b505084890196505b509498975050505050505050565b60008219821115610b0c57610b0c610a30565b50019056fea26469706673582212209ca55739676d094f8ef4b3b5cfcc08f600b805843c4c3027beb2b4159a02f63664736f6c634300080a0033\",\"sourceMap\":\"113:230:22:-:0;;;148:102;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;224:4;230:6;238:8;2098:5:10;2091:4;:12;;;;;;;;;;;;:::i;:::-;-1:-1:-1;2113:16:10;;;;:6;;:16;;;;;:::i;:::-;-1:-1:-1;2139:20:10;;;;;2189:13;2170:32;;2239:24;:22;:24::i;:::-;2212:51;;-1:-1:-1;113:230:22;;-1:-1:-1;;;;;113:230:22;5507:446:10;5572:7;5669:95;5802:4;5786:22;;;;;;:::i;:::-;;;;;;;;;;5637:295;;;3635:25:23;;;;3676:18;;3669:34;;;;5830:14:10;3719:18:23;;;3712:34;5866:13:10;3762:18:23;;;3755:34;5909:4:10;3805:19:23;;;3798:61;3607:19;;5637:295:10;;;;;;;;;;;;5610:336;;;;;;5591:355;;5507:446;:::o;113:230:22:-;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;113:230:22;;;-1:-1:-1;113:230:22;:::i;:::-;;;:::o;:::-;;;;;;;;;;;;;;;14:127:23;75:10;70:3;66:20;63:1;56:31;106:4;103:1;96:15;130:4;127:1;120:15;146:885;200:5;253:3;246:4;238:6;234:17;230:27;220:55;;271:1;268;261:12;220:55;294:13;;-1:-1:-1;;;;;356:10:23;;;353:36;;;369:18;;:::i;:::-;444:2;438:9;412:2;498:13;;-1:-1:-1;;494:22:23;;;518:2;490:31;486:40;474:53;;;542:18;;;562:22;;;539:46;536:72;;;588:18;;:::i;:::-;628:10;624:2;617:22;663:2;655:6;648:18;685:4;675:14;;730:3;725:2;720;712:6;708:15;704:24;701:33;698:53;;;747:1;744;737:12;698:53;769:1;760:10;;779:133;793:2;790:1;787:9;779:133;;;881:14;;;877:23;;871:30;850:14;;;846:23;;839:63;804:10;;;;779:133;;;930:2;927:1;924:9;921:80;;;989:1;984:2;979;971:6;967:15;963:24;956:35;921:80;1019:6;146:885;-1:-1:-1;;;;;;146:885:23:o;1036:712::-;1142:6;1150;1158;1211:2;1199:9;1190:7;1186:23;1182:32;1179:52;;;1227:1;1224;1217:12;1179:52;1254:16;;-1:-1:-1;;;;;1319:14:23;;;1316:34;;;1346:1;1343;1336:12;1316:34;1369:61;1422:7;1413:6;1402:9;1398:22;1369:61;:::i;:::-;1359:71;;1476:2;1465:9;1461:18;1455:25;1439:41;;1505:2;1495:8;1492:16;1489:36;;;1521:1;1518;1511:12;1489:36;;1544:63;1599:7;1588:8;1577:9;1573:24;1544:63;:::i;:::-;1534:73;;;1650:2;1639:9;1635:18;1629:25;1694:4;1687:5;1683:16;1676:5;1673:27;1663:55;;1714:1;1711;1704:12;1663:55;1737:5;1727:15;;;1036:712;;;;;:::o;1753:380::-;1832:1;1828:12;;;;1875;;;1896:61;;1950:4;1942:6;1938:17;1928:27;;1896:61;2003:2;1995:6;1992:14;1972:18;1969:38;1966:161;;;2049:10;2044:3;2040:20;2037:1;2030:31;2084:4;2081:1;2074:15;2112:4;2109:1;2102:15;1966:161;;1753:380;;;:::o;2267:1104::-;2397:3;2426:1;2459:6;2453:13;2489:3;2511:1;2539:9;2535:2;2531:18;2521:28;;2599:2;2588:9;2584:18;2621;2611:61;;2665:4;2657:6;2653:17;2643:27;;2611:61;2691:2;2739;2731:6;2728:14;2708:18;2705:38;2702:165;;;-1:-1:-1;;;2766:33:23;;2822:4;2819:1;2812:15;2852:4;2773:3;2840:17;2702:165;2883:18;2910:104;;;;3028:1;3023:323;;;;2876:470;;2910:104;-1:-1:-1;;2943:24:23;;2931:37;;2988:16;;;;-1:-1:-1;2910:104:23;;3023:323;2214:1;2207:14;;;2251:4;2238:18;;3121:1;3135:165;3149:6;3146:1;3143:13;3135:165;;;3227:14;;3214:11;;;3207:35;3270:16;;;;3164:10;;3135:165;;;3139:3;;3329:6;3324:3;3320:16;3313:23;;2876:470;-1:-1:-1;3362:3:23;;2267:1104;-1:-1:-1;;;;;;;;2267:1104:23:o;3376:489::-;113:230:22;;;;;;;;;;;;;;;;;;;;;;;;\",\"linkReferences\":{}},\"deployedBytecode\":{\"object\":\"0x608060405234801561001057600080fd5b50600436106100cf5760003560e01c806340c10f191161008c57806395d89b411161006657806395d89b41146101d5578063a9059cbb146101dd578063d505accf146101f0578063dd62ed3e1461020357600080fd5b806340c10f191461018057806370a08231146101955780637ecebe00146101b557600080fd5b806306fdde03146100d4578063095ea7b3146100f257806318160ddd1461011557806323b872dd1461012c578063313ce5671461013f5780633644e51514610178575b600080fd5b6100dc61022e565b6040516100e99190610856565b60405180910390f35b6101056101003660046108c7565b6102bc565b60405190151581526020016100e9565b61011e60025481565b6040519081526020016100e9565b61010561013a3660046108f1565b610328565b6101667f000000000000000000000000000000000000000000000000000000000000000081565b60405160ff90911681526020016100e9565b61011e61041a565b61019361018e3660046108c7565b610475565b005b61011e6101a336600461092d565b60036020526000908152604090205481565b61011e6101c336600461092d565b60056020526000908152604090205481565b6100dc610483565b6101056101eb3660046108c7565b610490565b6101936101fe36600461094f565b610508565b61011e6102113660046109c2565b600460209081526000928352604080842090915290825290205481565b6000805461023b906109f5565b80601f0160208091040260200160405190810160405280929190818152602001828054610267906109f5565b80156102b45780601f10610289576101008083540402835291602001916102b4565b820191906000526020600020905b81548152906001019060200180831161029757829003601f168201915b505050505081565b3360008181526004602090815260408083206001600160a01b038716808552925280832085905551919290917f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925906103179086815260200190565b60405180910390a350600192915050565b6001600160a01b038316600090815260046020908152604080832033845290915281205460001981146103845761035f8382610a46565b6001600160a01b03861660009081526004602090815260408083203384529091529020555b6001600160a01b038516600090815260036020526040812080548592906103ac908490610a46565b90915550506001600160a01b03808516600081815260036020526040908190208054870190555190918716907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef906104079087815260200190565b60405180910390a3506001949350505050565b60007f000000000000000000000000000000000000000000000000000000000000000046146104505761044b610751565b905090565b507f000000000000000000000000000000000000000000000000000000000000000090565b61047f82826107eb565b5050565b6001805461023b906109f5565b336000908152600360205260408120805483919083906104b1908490610a46565b90915550506001600160a01b038316600081815260036020526040908190208054850190555133907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef906103179086815260200190565b4284101561055d5760405162461bcd60e51b815260206004820152601760248201527f5045524d49545f444541444c494e455f4558504952454400000000000000000060448201526064015b60405180910390fd5b6000600161056961041a565b6001600160a01b038a811660008181526005602090815260409182902080546001810190915582517f6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c98184015280840194909452938d166060840152608083018c905260a083019390935260c08083018b90528151808403909101815260e08301909152805192019190912061190160f01b6101008301526101028201929092526101228101919091526101420160408051601f198184030181528282528051602091820120600084529083018083525260ff871690820152606081018590526080810184905260a0016020604051602081039080840390855afa158015610675573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b038116158015906106ab5750876001600160a01b0316816001600160a01b0316145b6106e85760405162461bcd60e51b815260206004820152600e60248201526d24a72b20a624a22fa9a4a3a722a960911b6044820152606401610554565b6001600160a01b0390811660009081526004602090815260408083208a8516808552908352928190208990555188815291928a16917f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925910160405180910390a350505050505050565b60007f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f60006040516107839190610a5d565b6040805191829003822060208301939093528101919091527fc89efdaa54c0f20c7adf612882df0950f5a951637e0307cdcb4c672f298b8bc660608201524660808201523060a082015260c00160405160208183030381529060405280519060200120905090565b80600260008282546107fd9190610af9565b90915550506001600160a01b0382166000818152600360209081526040808320805486019055518481527fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef910160405180910390a35050565b600060208083528351808285015260005b8181101561088357858101830151858201604001528201610867565b81811115610895576000604083870101525b50601f01601f1916929092016040019392505050565b80356001600160a01b03811681146108c257600080fd5b919050565b600080604083850312156108da57600080fd5b6108e3836108ab565b946020939093013593505050565b60008060006060848603121561090657600080fd5b61090f846108ab565b925061091d602085016108ab565b9150604084013590509250925092565b60006020828403121561093f57600080fd5b610948826108ab565b9392505050565b600080600080600080600060e0888a03121561096a57600080fd5b610973886108ab565b9650610981602089016108ab565b95506040880135945060608801359350608088013560ff811681146109a557600080fd5b9699959850939692959460a0840135945060c09093013592915050565b600080604083850312156109d557600080fd5b6109de836108ab565b91506109ec602084016108ab565b90509250929050565b600181811c90821680610a0957607f821691505b60208210811415610a2a57634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b600082821015610a5857610a58610a30565b500390565b600080835481600182811c915080831680610a7957607f831692505b6020808410821415610a9957634e487b7160e01b86526022600452602486fd5b818015610aad5760018114610abe57610aeb565b60ff19861689528489019650610aeb565b60008a81526020902060005b86811015610ae35781548b820152908501908301610aca565b505084890196505b509498975050505050505050565b60008219821115610b0c57610b0c610a30565b50019056fea26469706673582212209ca55739676d094f8ef4b3b5cfcc08f600b805843c4c3027beb2b4159a02f63664736f6c634300080a0033\",\"sourceMap\":\"113:230:22:-:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;1028:18:10;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;2458:211;;;;;;:::i;:::-;;:::i;:::-;;;1218:14:23;;1211:22;1193:41;;1181:2;1166:18;2458:211:10;1053:187:23;1301:26:10;;;;;;;;;1391:25:23;;;1379:2;1364:18;1301:26:10;1245:177:23;3054:592:10;;;;;;:::i;:::-;;:::i;1080:31::-;;;;;;;;1932:4:23;1920:17;;;1902:36;;1890:2;1875:18;1080:31:10;1760:184:23;5324:177:10;;;:::i;256:85:22:-;;;;;;:::i;:::-;;:::i;:::-;;1334:44:10;;;;;;:::i;:::-;;;;;;;;;;;;;;1748:41;;;;;;:::i;:::-;;;;;;;;;;;;;;1053:20;;;:::i;2675:373::-;;;;;;:::i;:::-;;:::i;3835:1483::-;;;;;;:::i;:::-;;:::i;1385:64::-;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;1028:18;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::o;2458:211::-;2558:10;2532:4;2548:21;;;:9;:21;;;;;;;;-1:-1:-1;;;;;2548:30:10;;;;;;;;;;:39;;;2603:37;2532:4;;2548:30;;2603:37;;;;2581:6;1391:25:23;;1379:2;1364:18;;1245:177;2603:37:10;;;;;;;;-1:-1:-1;2658:4:10;2458:211;;;;:::o;3054:592::-;-1:-1:-1;;;;;3206:15:10;;3172:4;3206:15;;;:9;:15;;;;;;;;3222:10;3206:27;;;;;;;;-1:-1:-1;;3284:28:10;;3280:80;;3344:16;3354:6;3344:7;:16;:::i;:::-;-1:-1:-1;;;;;3314:15:10;;;;;;:9;:15;;;;;;;;3330:10;3314:27;;;;;;;:46;3280:80;-1:-1:-1;;;;;3371:15:10;;;;;;:9;:15;;;;;:25;;3390:6;;3371:15;:25;;3390:6;;3371:25;:::i;:::-;;;;-1:-1:-1;;;;;;;3542:13:10;;;;;;;:9;:13;;;;;;;:23;;;;;;3591:26;3542:13;;3591:26;;;;;;;3559:6;1391:25:23;;1379:2;1364:18;;1245:177;3591:26:10;;;;;;;;-1:-1:-1;3635:4:10;;3054:592;-1:-1:-1;;;;3054:592:10:o;5324:177::-;5381:7;5424:16;5407:13;:33;:87;;5470:24;:22;:24::i;:::-;5400:94;;5324:177;:::o;5407:87::-;-1:-1:-1;5443:24:10;;5324:177::o;256:85:22:-;317:17;323:2;327:6;317:5;:17::i;:::-;256:85;;:::o;1053:20:10:-;;;;;;;:::i;2675:373::-;2771:10;2745:4;2761:21;;;:9;:21;;;;;:31;;2786:6;;2761:21;2745:4;;2761:31;;2786:6;;2761:31;:::i;:::-;;;;-1:-1:-1;;;;;;;2938:13:10;;;;;;:9;:13;;;;;;;:23;;;;;;2987:32;2996:10;;2987:32;;;;2955:6;1391:25:23;;1379:2;1364:18;;1245:177;3835:1483:10;4054:15;4042:8;:27;;4034:63;;;;-1:-1:-1;;;4034:63:10;;4134:2:23;4034:63:10;;;4116:21:23;4173:2;4153:18;;;4146:30;4212:25;4192:18;;;4185:53;4255:18;;4034:63:10;;;;;;;;;4262:24;4289:805;4425:18;:16;:18::i;:::-;-1:-1:-1;;;;;4870:13:10;;;;;;;:6;:13;;;;;;;;;:15;;;;;;;;4508:449;;4552:165;4508:449;;;4571:25:23;4650:18;;;4643:43;;;;4722:15;;;4702:18;;;4695:43;4754:18;;;4747:34;;;4797:19;;;4790:35;;;;4841:19;;;;4834:35;;;4508:449:10;;;;;;;;;;4543:19:23;;;4508:449:10;;;4469:514;;;;;;;;-1:-1:-1;;;4347:658:10;;;5138:27:23;5181:11;;;5174:27;;;;5217:12;;;5210:28;;;;5254:12;;4347:658:10;;;-1:-1:-1;;4347:658:10;;;;;;;;;4316:707;;4347:658;4316:707;;;;4289:805;;;;;;;;;5504:25:23;5577:4;5565:17;;5545:18;;;5538:45;5599:18;;;5592:34;;;5642:18;;;5635:34;;;5476:19;;4289:805:10;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;;4289:805:10;;-1:-1:-1;;4289:805:10;;;-1:-1:-1;;;;;;;5117:30:10;;;;;;:59;;;5171:5;-1:-1:-1;;;;;5151:25:10;:16;-1:-1:-1;;;;;5151:25:10;;5117:59;5109:86;;;;-1:-1:-1;;;5109:86:10;;5882:2:23;5109:86:10;;;5864:21:23;5921:2;5901:18;;;5894:30;-1:-1:-1;;;5940:18:23;;;5933:44;5994:18;;5109:86:10;5680:338:23;5109:86:10;-1:-1:-1;;;;;5210:27:10;;;;;;;:9;:27;;;;;;;;:36;;;;;;;;;;;;;:44;;;5280:31;1391:25:23;;;5210:36:10;;5280:31;;;;;1364:18:23;5280:31:10;;;;;;;3835:1483;;;;;;;:::o;5507:446::-;5572:7;5669:95;5802:4;5786:22;;;;;;:::i;:::-;;;;;;;;;;5637:295;;;7520:25:23;;;;7561:18;;7554:34;;;;5830:14:10;7604:18:23;;;7597:34;5866:13:10;7647:18:23;;;7640:34;5909:4:10;7690:19:23;;;7683:61;7492:19;;5637:295:10;;;;;;;;;;;;5610:336;;;;;;5591:355;;5507:446;:::o;6147:325::-;6232:6;6217:11;;:21;;;;;;;:::i;:::-;;;;-1:-1:-1;;;;;;;6384:13:10;;;;;;:9;:13;;;;;;;;:23;;;;;;6433:32;1391:25:23;;;6433:32:10;;1364:18:23;6433:32:10;;;;;;;6147:325;;:::o;14:597:23:-;126:4;155:2;184;173:9;166:21;216:6;210:13;259:6;254:2;243:9;239:18;232:34;284:1;294:140;308:6;305:1;302:13;294:140;;;403:14;;;399:23;;393:30;369:17;;;388:2;365:26;358:66;323:10;;294:140;;;452:6;449:1;446:13;443:91;;;522:1;517:2;508:6;497:9;493:22;489:31;482:42;443:91;-1:-1:-1;595:2:23;574:15;-1:-1:-1;;570:29:23;555:45;;;;602:2;551:54;;14:597;-1:-1:-1;;;14:597:23:o;616:173::-;684:20;;-1:-1:-1;;;;;733:31:23;;723:42;;713:70;;779:1;776;769:12;713:70;616:173;;;:::o;794:254::-;862:6;870;923:2;911:9;902:7;898:23;894:32;891:52;;;939:1;936;929:12;891:52;962:29;981:9;962:29;:::i;:::-;952:39;1038:2;1023:18;;;;1010:32;;-1:-1:-1;;;794:254:23:o;1427:328::-;1504:6;1512;1520;1573:2;1561:9;1552:7;1548:23;1544:32;1541:52;;;1589:1;1586;1579:12;1541:52;1612:29;1631:9;1612:29;:::i;:::-;1602:39;;1660:38;1694:2;1683:9;1679:18;1660:38;:::i;:::-;1650:48;;1745:2;1734:9;1730:18;1717:32;1707:42;;1427:328;;;;;:::o;2131:186::-;2190:6;2243:2;2231:9;2222:7;2218:23;2214:32;2211:52;;;2259:1;2256;2249:12;2211:52;2282:29;2301:9;2282:29;:::i;:::-;2272:39;2131:186;-1:-1:-1;;;2131:186:23:o;2322:693::-;2433:6;2441;2449;2457;2465;2473;2481;2534:3;2522:9;2513:7;2509:23;2505:33;2502:53;;;2551:1;2548;2541:12;2502:53;2574:29;2593:9;2574:29;:::i;:::-;2564:39;;2622:38;2656:2;2645:9;2641:18;2622:38;:::i;:::-;2612:48;;2707:2;2696:9;2692:18;2679:32;2669:42;;2758:2;2747:9;2743:18;2730:32;2720:42;;2812:3;2801:9;2797:19;2784:33;2857:4;2850:5;2846:16;2839:5;2836:27;2826:55;;2877:1;2874;2867:12;2826:55;2322:693;;;;-1:-1:-1;2322:693:23;;;;2900:5;2952:3;2937:19;;2924:33;;-1:-1:-1;3004:3:23;2989:19;;;2976:33;;2322:693;-1:-1:-1;;2322:693:23:o;3020:260::-;3088:6;3096;3149:2;3137:9;3128:7;3124:23;3120:32;3117:52;;;3165:1;3162;3155:12;3117:52;3188:29;3207:9;3188:29;:::i;:::-;3178:39;;3236:38;3270:2;3259:9;3255:18;3236:38;:::i;:::-;3226:48;;3020:260;;;;;:::o;3285:380::-;3364:1;3360:12;;;;3407;;;3428:61;;3482:4;3474:6;3470:17;3460:27;;3428:61;3535:2;3527:6;3524:14;3504:18;3501:38;3498:161;;;3581:10;3576:3;3572:20;3569:1;3562:31;3616:4;3613:1;3606:15;3644:4;3641:1;3634:15;3498:161;;3285:380;;;:::o;3670:127::-;3731:10;3726:3;3722:20;3719:1;3712:31;3762:4;3759:1;3752:15;3786:4;3783:1;3776:15;3802:125;3842:4;3870:1;3867;3864:8;3861:34;;;3875:18;;:::i;:::-;-1:-1:-1;3912:9:23;;3802:125::o;6152:1104::-;6282:3;6311:1;6344:6;6338:13;6374:3;6396:1;6424:9;6420:2;6416:18;6406:28;;6484:2;6473:9;6469:18;6506;6496:61;;6550:4;6542:6;6538:17;6528:27;;6496:61;6576:2;6624;6616:6;6613:14;6593:18;6590:38;6587:165;;;-1:-1:-1;;;6651:33:23;;6707:4;6704:1;6697:15;6737:4;6658:3;6725:17;6587:165;6768:18;6795:104;;;;6913:1;6908:323;;;;6761:470;;6795:104;-1:-1:-1;;6828:24:23;;6816:37;;6873:16;;;;-1:-1:-1;6795:104:23;;6908:323;6099:1;6092:14;;;6136:4;6123:18;;7006:1;7020:165;7034:6;7031:1;7028:13;7020:165;;;7112:14;;7099:11;;;7092:35;7155:16;;;;7049:10;;7020:165;;;7024:3;;7214:6;7209:3;7205:16;7198:23;;6761:470;-1:-1:-1;7247:3:23;;6152:1104;-1:-1:-1;;;;;;;;6152:1104:23:o;7755:128::-;7795:3;7826:1;7822:6;7819:1;7816:13;7813:39;;;7832:18;;:::i;:::-;-1:-1:-1;7868:9:23;;7755:128::o\",\"linkReferences\":{},\"immutableReferences\":{\"3499\":[{\"start\":324,\"length\":32}],\"3513\":[{\"start\":1054,\"length\":32}],\"3515\":[{\"start\":1107,\"length\":32}]}},\"methodIdentifiers\":{\"DOMAIN_SEPARATOR()\":\"3644e515\",\"allowance(address,address)\":\"dd62ed3e\",\"approve(address,uint256)\":\"095ea7b3\",\"balanceOf(address)\":\"70a08231\",\"decimals()\":\"313ce567\",\"mint(address,uint256)\":\"40c10f19\",\"name()\":\"06fdde03\",\"nonces(address)\":\"7ecebe00\",\"permit(address,address,uint256,uint256,uint8,bytes32,bytes32)\":\"d505accf\",\"symbol()\":\"95d89b41\",\"totalSupply()\":\"18160ddd\",\"transfer(address,uint256)\":\"a9059cbb\",\"transferFrom(address,address,uint256)\":\"23b872dd\"}}" }, { "path": "crates/cast/tests/fixtures/TestToken.sol", "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ncontract TestToken {\n string public name = \"Test Token\";\n string public symbol = \"TEST\";\n uint8 public decimals = 18;\n uint256 public totalSupply;\n\n mapping(address => uint256) public balanceOf;\n mapping(address => mapping(address => uint256)) public allowance;\n\n event Transfer(address indexed from, address indexed to, uint256 value);\n event Approval(address indexed owner, address indexed spender, uint256 value);\n\n constructor() {\n totalSupply = 1000 * 10**decimals;\n balanceOf[msg.sender] = totalSupply;\n emit Transfer(address(0), msg.sender, totalSupply);\n }\n\n function transfer(address to, uint256 amount) external returns (bool) {\n require(balanceOf[msg.sender] >= amount, \"Insufficient balance\");\n balanceOf[msg.sender] -= amount;\n balanceOf[to] += amount;\n emit Transfer(msg.sender, to, amount);\n return true;\n }\n\n function approve(address spender, uint256 amount) external returns (bool) {\n allowance[msg.sender][spender] = amount;\n emit Approval(msg.sender, spender, amount);\n return true;\n }\n\n function transferFrom(address from, address to, uint256 amount) external returns (bool) {\n require(balanceOf[from] >= amount, \"Insufficient balance\");\n require(allowance[from][msg.sender] >= amount, \"Insufficient allowance\");\n\n balanceOf[from] -= amount;\n balanceOf[to] += amount;\n allowance[from][msg.sender] -= amount;\n\n emit Transfer(from, to, amount);\n return true;\n }\n\n function mint(address to, uint256 amount) external {\n totalSupply += amount;\n balanceOf[to] += amount;\n emit Transfer(address(0), to, amount);\n }\n\n function burn(uint256 amount) external {\n uint256 balance = balanceOf[msg.sender];\n amount = (amount > balance) ? balance : amount;\n\n totalSupply -= amount;\n balanceOf[msg.sender] -= amount;\n emit Transfer(msg.sender, address(0), amount);\n }\n}\n" }, { "path": "crates/cast/tests/fixtures/cast_logs.stdout", "content": "- address: 0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE\n blockHash: 0x439b61565dacbc09a6d54378dff60d9b0400496d7a5a060cfdfdd899262f466c\n blockNumber: 12421182\n data: 0x000000000000000000000000000000000000027fd7b375dda5ef932dac18d302\n logIndex: 15\n removed: false\n topics: [\n \t0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef\n \t0x000000000000000000000000ab5801a7d398351b8be11c439e05c5b3259aec9b\n \t0x00000000000000000000000068a99f89e475a078645f4bac491360afe255dff1\n ]\n transactionHash: 0xb65bcbb85c1633b0ab4e4886c3cd8eeaeb63edbb39cacdb9223fdcf4454fd2c7\n transactionIndex: 8\n" }, { "path": "crates/cast/tests/fixtures/interface.json", "content": "[{\"type\":\"constructor\",\"inputs\":[{\"name\":\"_integrationManager\",\"type\":\"address\",\"internalType\":\"address\"},{\"name\":\"_addressListRegistry\",\"type\":\"address\",\"internalType\":\"address\"},{\"name\":\"_aTokenListId\",\"type\":\"uint256\",\"internalType\":\"uint256\"},{\"name\":\"_pool\",\"type\":\"address\",\"internalType\":\"address\"},{\"name\":\"_referralCode\",\"type\":\"uint16\",\"internalType\":\"uint16\"}],\"stateMutability\":\"nonpayable\"},{\"type\":\"function\",\"name\":\"getIntegrationManager\",\"inputs\":[],\"outputs\":[{\"name\":\"integrationManager_\",\"type\":\"address\",\"internalType\":\"address\"}],\"stateMutability\":\"view\"},{\"type\":\"function\",\"name\":\"lend\",\"inputs\":[{\"name\":\"_vaultProxy\",\"type\":\"address\",\"internalType\":\"address\"},{\"name\":\"\",\"type\":\"bytes\",\"internalType\":\"bytes\"},{\"name\":\"_assetData\",\"type\":\"bytes\",\"internalType\":\"bytes\"}],\"outputs\":[],\"stateMutability\":\"nonpayable\"},{\"type\":\"function\",\"name\":\"parseAssetsForAction\",\"inputs\":[{\"name\":\"\",\"type\":\"address\",\"internalType\":\"address\"},{\"name\":\"_selector\",\"type\":\"bytes4\",\"internalType\":\"bytes4\"},{\"name\":\"_actionData\",\"type\":\"bytes\",\"internalType\":\"bytes\"}],\"outputs\":[{\"name\":\"spendAssetsHandleType_\",\"type\":\"uint8\",\"internalType\":\"enum IIntegrationManager.SpendAssetsHandleType\"},{\"name\":\"spendAssets_\",\"type\":\"address[]\",\"internalType\":\"address[]\"},{\"name\":\"spendAssetAmounts_\",\"type\":\"uint256[]\",\"internalType\":\"uint256[]\"},{\"name\":\"incomingAssets_\",\"type\":\"address[]\",\"internalType\":\"address[]\"},{\"name\":\"minIncomingAssetAmounts_\",\"type\":\"uint256[]\",\"internalType\":\"uint256[]\"}],\"stateMutability\":\"view\"},{\"type\":\"function\",\"name\":\"redeem\",\"inputs\":[{\"name\":\"_vaultProxy\",\"type\":\"address\",\"internalType\":\"address\"},{\"name\":\"\",\"type\":\"bytes\",\"internalType\":\"bytes\"},{\"name\":\"_assetData\",\"type\":\"bytes\",\"internalType\":\"bytes\"}],\"outputs\":[],\"stateMutability\":\"nonpayable\"}]" }, { "path": "crates/cast/tests/fixtures/interface_inherited_struct.json", "content": "[{\"type\":\"function\",\"name\":\"test\",\"inputs\":[{\"name\":\"param\",\"type\":\"tuple\",\"internalType\":\"struct IBase.TestStruct\",\"components\":[{\"name\":\"asset\",\"type\":\"address\",\"internalType\":\"address\"}]}],\"outputs\":[],\"stateMutability\":\"nonpayable\"}]\n" }, { "path": "crates/cast/tests/fixtures/keystore/UTC--2022-10-30T06-51-20.130356000Z--560d246fcddc9ea98a8b032c9a2f474efb493c28", "content": "{\"address\":\"560d246fcddc9ea98a8b032c9a2f474efb493c28\",\"crypto\":{\"cipher\":\"aes-128-ctr\",\"ciphertext\":\"0b0012edfc7a1b22c7c616a78562807c363482490359ae23858c49d6a369b2ff\",\"cipherparams\":{\"iv\":\"9d72960fe04dd987300e91c101c890b8\"},\"kdf\":\"scrypt\",\"kdfparams\":{\"dklen\":32,\"n\":262144,\"p\":1,\"r\":8,\"salt\":\"f7d24eae5e746700a1fdc0e0886801b0e7aff7e298f9409f74355a5387827181\"},\"mac\":\"981cae42a43ce975b9ff13d19a99ae755ad3f6125c94a4da517c50067ca87f07\"},\"id\":\"852dbcfc-726a-416e-9321-29f9b5d7e2de\",\"version\":3}" }, { "path": "crates/cast/tests/fixtures/keystore/UTC--2022-12-20T10-30-43.591916000Z--ec554aeafe75601aaab43bd4621a22284db566c2", "content": "{\"address\":\"ec554aeafe75601aaab43bd4621a22284db566c2\",\"crypto\":{\"cipher\":\"aes-128-ctr\",\"ciphertext\":\"f4e11a2667d97f42ad820f2aa735cd557ff608f47e2738d763a834b889611e18\",\"cipherparams\":{\"iv\":\"99c3e2f1c98ccac50cb19f0a148e02ee\"},\"kdf\":\"scrypt\",\"kdfparams\":{\"dklen\":32,\"n\":262144,\"p\":1,\"r\":8,\"salt\":\"81f3033ffcc9fec9939eaec246a4037d9bc0c47cfb33247c98132b7d477b7e64\"},\"mac\":\"13bb4eac9a8d8f72905bca0c6f947c440d990baa649b0697b2083f3ab57d2cc5\"},\"id\":\"279ce8c3-dd94-43a8-aa46-15c3a45adbd1\",\"version\":3}" }, { "path": "crates/cast/tests/fixtures/keystore/password", "content": "this is keystore password\n" }, { "path": "crates/cast/tests/fixtures/keystore/password-ec554", "content": "keystorepassword" }, { "path": "crates/cast/tests/fixtures/sign_typed_data.json", "content": "{\"types\":{\"EIP712Domain\":[{\"name\":\"name\",\"type\":\"string\"},{\"name\":\"version\",\"type\":\"string\"},{\"name\":\"chainId\",\"type\":\"uint256\"},{\"name\":\"verifyingContract\",\"type\":\"address\"}],\"Message\":[{\"name\":\"data\",\"type\":\"string\"}]},\"primaryType\":\"Message\",\"domain\":{\"name\":\"example.metamask.io\",\"version\":\"1\",\"chainId\":\"1\",\"verifyingContract\":\"0x0000000000000000000000000000000000000000\"},\"message\":{\"data\":\"Hello!\"}}" }, { "path": "crates/cast/tests/fixtures/storage_layout_complex.json", "content": "{\n \"storage\": [\n {\n \"astId\": 3805,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"_status\",\n \"offset\": 0,\n \"slot\": \"0\",\n \"type\": \"t_uint256\"\n },\n {\n \"astId\": 9499,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"_generalPoolsBalances\",\n \"offset\": 0,\n \"slot\": \"1\",\n \"type\": \"t_mapping(t_bytes32,t_struct(IERC20ToBytes32Map)3177_storage)\"\n },\n {\n \"astId\": 716,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"_nextNonce\",\n \"offset\": 0,\n \"slot\": \"2\",\n \"type\": \"t_mapping(t_address,t_uint256)\"\n },\n {\n \"astId\": 967,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"_paused\",\n \"offset\": 0,\n \"slot\": \"3\",\n \"type\": \"t_bool\"\n },\n {\n \"astId\": 8639,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"_authorizer\",\n \"offset\": 1,\n \"slot\": \"3\",\n \"type\": \"t_contract(IAuthorizer)11086\"\n },\n {\n \"astId\": 8645,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"_approvedRelayers\",\n \"offset\": 0,\n \"slot\": \"4\",\n \"type\": \"t_mapping(t_address,t_mapping(t_address,t_bool))\"\n },\n {\n \"astId\": 5769,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"_isPoolRegistered\",\n \"offset\": 0,\n \"slot\": \"5\",\n \"type\": \"t_mapping(t_bytes32,t_bool)\"\n },\n {\n \"astId\": 5771,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"_nextPoolNonce\",\n \"offset\": 0,\n \"slot\": \"6\",\n \"type\": \"t_uint256\"\n },\n {\n \"astId\": 9915,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"_minimalSwapInfoPoolsBalances\",\n \"offset\": 0,\n \"slot\": \"7\",\n \"type\": \"t_mapping(t_bytes32,t_mapping(t_contract(IERC20)3793,t_bytes32))\"\n },\n {\n \"astId\": 9919,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"_minimalSwapInfoPoolsTokens\",\n \"offset\": 0,\n \"slot\": \"8\",\n \"type\": \"t_mapping(t_bytes32,t_struct(AddressSet)3520_storage)\"\n },\n {\n \"astId\": 10373,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"_twoTokenPoolTokens\",\n \"offset\": 0,\n \"slot\": \"9\",\n \"type\": \"t_mapping(t_bytes32,t_struct(TwoTokenPoolTokens)10369_storage)\"\n },\n {\n \"astId\": 4007,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"_poolAssetManagers\",\n \"offset\": 0,\n \"slot\": \"10\",\n \"type\": \"t_mapping(t_bytes32,t_mapping(t_contract(IERC20)3793,t_address))\"\n },\n {\n \"astId\": 8019,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"_internalTokenBalance\",\n \"offset\": 0,\n \"slot\": \"11\",\n \"type\": \"t_mapping(t_address,t_mapping(t_contract(IERC20)3793,t_uint256))\"\n }\n ],\n \"types\": {\n \"t_address\": {\n \"encoding\": \"inplace\",\n \"label\": \"address\",\n \"numberOfBytes\": \"20\"\n },\n \"t_array(t_address)dyn_storage\": {\n \"encoding\": \"dynamic_array\",\n \"label\": \"address[]\",\n \"numberOfBytes\": \"32\",\n \"base\": \"t_address\"\n },\n \"t_bool\": {\n \"encoding\": \"inplace\",\n \"label\": \"bool\",\n \"numberOfBytes\": \"1\"\n },\n \"t_bytes32\": {\n \"encoding\": \"inplace\",\n \"label\": \"bytes32\",\n \"numberOfBytes\": \"32\"\n },\n \"t_contract(IAuthorizer)11086\": {\n \"encoding\": \"inplace\",\n \"label\": \"contract IAuthorizer\",\n \"numberOfBytes\": \"20\"\n },\n \"t_contract(IERC20)3793\": {\n \"encoding\": \"inplace\",\n \"label\": \"contract IERC20\",\n \"numberOfBytes\": \"20\"\n },\n \"t_mapping(t_address,t_bool)\": {\n \"encoding\": \"mapping\",\n \"key\": \"t_address\",\n \"label\": \"mapping(address => bool)\",\n \"numberOfBytes\": \"32\",\n \"value\": \"t_bool\"\n },\n \"t_mapping(t_address,t_mapping(t_address,t_bool))\": {\n \"encoding\": \"mapping\",\n \"key\": \"t_address\",\n \"label\": \"mapping(address => mapping(address => bool))\",\n \"numberOfBytes\": \"32\",\n \"value\": \"t_mapping(t_address,t_bool)\"\n },\n \"t_mapping(t_address,t_mapping(t_contract(IERC20)3793,t_uint256))\": {\n \"encoding\": \"mapping\",\n \"key\": \"t_address\",\n \"label\": \"mapping(address => mapping(contract IERC20 => uint256))\",\n \"numberOfBytes\": \"32\",\n \"value\": \"t_mapping(t_contract(IERC20)3793,t_uint256)\"\n },\n \"t_mapping(t_address,t_uint256)\": {\n \"encoding\": \"mapping\",\n \"key\": \"t_address\",\n \"label\": \"mapping(address => uint256)\",\n \"numberOfBytes\": \"32\",\n \"value\": \"t_uint256\"\n },\n \"t_mapping(t_bytes32,t_bool)\": {\n \"encoding\": \"mapping\",\n \"key\": \"t_bytes32\",\n \"label\": \"mapping(bytes32 => bool)\",\n \"numberOfBytes\": \"32\",\n \"value\": \"t_bool\"\n },\n \"t_mapping(t_bytes32,t_mapping(t_contract(IERC20)3793,t_address))\": {\n \"encoding\": \"mapping\",\n \"key\": \"t_bytes32\",\n \"label\": \"mapping(bytes32 => mapping(contract IERC20 => address))\",\n \"numberOfBytes\": \"32\",\n \"value\": \"t_mapping(t_contract(IERC20)3793,t_address)\"\n },\n \"t_mapping(t_bytes32,t_mapping(t_contract(IERC20)3793,t_bytes32))\": {\n \"encoding\": \"mapping\",\n \"key\": \"t_bytes32\",\n \"label\": \"mapping(bytes32 => mapping(contract IERC20 => bytes32))\",\n \"numberOfBytes\": \"32\",\n \"value\": \"t_mapping(t_contract(IERC20)3793,t_bytes32)\"\n },\n \"t_mapping(t_bytes32,t_struct(AddressSet)3520_storage)\": {\n \"encoding\": \"mapping\",\n \"key\": \"t_bytes32\",\n \"label\": \"mapping(bytes32 => struct EnumerableSet.AddressSet)\",\n \"numberOfBytes\": \"32\",\n \"value\": \"t_struct(AddressSet)3520_storage\"\n },\n \"t_mapping(t_bytes32,t_struct(IERC20ToBytes32Map)3177_storage)\": {\n \"encoding\": \"mapping\",\n \"key\": \"t_bytes32\",\n \"label\": \"mapping(bytes32 => struct EnumerableMap.IERC20ToBytes32Map)\",\n \"numberOfBytes\": \"32\",\n \"value\": \"t_struct(IERC20ToBytes32Map)3177_storage\"\n },\n \"t_mapping(t_bytes32,t_struct(TwoTokenPoolBalances)10360_storage)\": {\n \"encoding\": \"mapping\",\n \"key\": \"t_bytes32\",\n \"label\": \"mapping(bytes32 => struct TwoTokenPoolsBalance.TwoTokenPoolBalances)\",\n \"numberOfBytes\": \"32\",\n \"value\": \"t_struct(TwoTokenPoolBalances)10360_storage\"\n },\n \"t_mapping(t_bytes32,t_struct(TwoTokenPoolTokens)10369_storage)\": {\n \"encoding\": \"mapping\",\n \"key\": \"t_bytes32\",\n \"label\": \"mapping(bytes32 => struct TwoTokenPoolsBalance.TwoTokenPoolTokens)\",\n \"numberOfBytes\": \"32\",\n \"value\": \"t_struct(TwoTokenPoolTokens)10369_storage\"\n },\n \"t_mapping(t_contract(IERC20)3793,t_address)\": {\n \"encoding\": \"mapping\",\n \"key\": \"t_contract(IERC20)3793\",\n \"label\": \"mapping(contract IERC20 => address)\",\n \"numberOfBytes\": \"32\",\n \"value\": \"t_address\"\n },\n \"t_mapping(t_contract(IERC20)3793,t_bytes32)\": {\n \"encoding\": \"mapping\",\n \"key\": \"t_contract(IERC20)3793\",\n \"label\": \"mapping(contract IERC20 => bytes32)\",\n \"numberOfBytes\": \"32\",\n \"value\": \"t_bytes32\"\n },\n \"t_mapping(t_contract(IERC20)3793,t_uint256)\": {\n \"encoding\": \"mapping\",\n \"key\": \"t_contract(IERC20)3793\",\n \"label\": \"mapping(contract IERC20 => uint256)\",\n \"numberOfBytes\": \"32\",\n \"value\": \"t_uint256\"\n },\n \"t_mapping(t_uint256,t_struct(IERC20ToBytes32MapEntry)3166_storage)\": {\n \"encoding\": \"mapping\",\n \"key\": \"t_uint256\",\n \"label\": \"mapping(uint256 => struct EnumerableMap.IERC20ToBytes32MapEntry)\",\n \"numberOfBytes\": \"32\",\n \"value\": \"t_struct(IERC20ToBytes32MapEntry)3166_storage\"\n },\n \"t_struct(AddressSet)3520_storage\": {\n \"encoding\": \"inplace\",\n \"label\": \"struct EnumerableSet.AddressSet\",\n \"numberOfBytes\": \"64\",\n \"members\": [\n {\n \"astId\": 3515,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"_values\",\n \"offset\": 0,\n \"slot\": \"0\",\n \"type\": \"t_array(t_address)dyn_storage\"\n },\n {\n \"astId\": 3519,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"_indexes\",\n \"offset\": 0,\n \"slot\": \"1\",\n \"type\": \"t_mapping(t_address,t_uint256)\"\n }\n ]\n },\n \"t_struct(IERC20ToBytes32Map)3177_storage\": {\n \"encoding\": \"inplace\",\n \"label\": \"struct EnumerableMap.IERC20ToBytes32Map\",\n \"numberOfBytes\": \"96\",\n \"members\": [\n {\n \"astId\": 3168,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"_length\",\n \"offset\": 0,\n \"slot\": \"0\",\n \"type\": \"t_uint256\"\n },\n {\n \"astId\": 3172,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"_entries\",\n \"offset\": 0,\n \"slot\": \"1\",\n \"type\": \"t_mapping(t_uint256,t_struct(IERC20ToBytes32MapEntry)3166_storage)\"\n },\n {\n \"astId\": 3176,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"_indexes\",\n \"offset\": 0,\n \"slot\": \"2\",\n \"type\": \"t_mapping(t_contract(IERC20)3793,t_uint256)\"\n }\n ]\n },\n \"t_struct(IERC20ToBytes32MapEntry)3166_storage\": {\n \"encoding\": \"inplace\",\n \"label\": \"struct EnumerableMap.IERC20ToBytes32MapEntry\",\n \"numberOfBytes\": \"64\",\n \"members\": [\n {\n \"astId\": 3163,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"_key\",\n \"offset\": 0,\n \"slot\": \"0\",\n \"type\": \"t_contract(IERC20)3793\"\n },\n {\n \"astId\": 3165,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"_value\",\n \"offset\": 0,\n \"slot\": \"1\",\n \"type\": \"t_bytes32\"\n }\n ]\n },\n \"t_struct(TwoTokenPoolBalances)10360_storage\": {\n \"encoding\": \"inplace\",\n \"label\": \"struct TwoTokenPoolsBalance.TwoTokenPoolBalances\",\n \"numberOfBytes\": \"64\",\n \"members\": [\n {\n \"astId\": 10357,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"sharedCash\",\n \"offset\": 0,\n \"slot\": \"0\",\n \"type\": \"t_bytes32\"\n },\n {\n \"astId\": 10359,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"sharedManaged\",\n \"offset\": 0,\n \"slot\": \"1\",\n \"type\": \"t_bytes32\"\n }\n ]\n },\n \"t_struct(TwoTokenPoolTokens)10369_storage\": {\n \"encoding\": \"inplace\",\n \"label\": \"struct TwoTokenPoolsBalance.TwoTokenPoolTokens\",\n \"numberOfBytes\": \"96\",\n \"members\": [\n {\n \"astId\": 10362,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"tokenA\",\n \"offset\": 0,\n \"slot\": \"0\",\n \"type\": \"t_contract(IERC20)3793\"\n },\n {\n \"astId\": 10364,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"tokenB\",\n \"offset\": 0,\n \"slot\": \"1\",\n \"type\": \"t_contract(IERC20)3793\"\n },\n {\n \"astId\": 10368,\n \"contract\": \"contracts/vault/Vault.sol:Vault\",\n \"label\": \"balances\",\n \"offset\": 0,\n \"slot\": \"2\",\n \"type\": \"t_mapping(t_bytes32,t_struct(TwoTokenPoolBalances)10360_storage)\"\n }\n ]\n },\n \"t_uint256\": {\n \"encoding\": \"inplace\",\n \"label\": \"uint256\",\n \"numberOfBytes\": \"32\"\n }\n },\n \"values\": [\n \"0x0000000000000000000000000000000000000000000000000000000000000001\",\n \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"0x0000000000000000000000006048a8c631fb7e77eca533cf9c29784e482391e7\",\n \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"0x00000000000000000000000000000000000000000000000000000000000006e0\",\n \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"0x0000000000000000000000000000000000000000000000000000000000000000\"\n ]\n}" }, { "path": "crates/cast/tests/fixtures/storage_layout_simple.json", "content": "{\n \"storage\": [\n {\n \"astId\": 7,\n \"contract\": \"contracts/Create2Deployer.sol:Create2Deployer\",\n \"label\": \"_owner\",\n \"offset\": 0,\n \"slot\": \"0\",\n \"type\": \"t_address\"\n },\n {\n \"astId\": 122,\n \"contract\": \"contracts/Create2Deployer.sol:Create2Deployer\",\n \"label\": \"_paused\",\n \"offset\": 20,\n \"slot\": \"0\",\n \"type\": \"t_bool\"\n }\n ],\n \"types\": {\n \"t_address\": {\n \"encoding\": \"inplace\",\n \"label\": \"address\",\n \"numberOfBytes\": \"20\"\n },\n \"t_bool\": {\n \"encoding\": \"inplace\",\n \"label\": \"bool\",\n \"numberOfBytes\": \"1\"\n }\n },\n \"values\": [\n \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"0x0000000000000000000000000000000000000000000000000000000000000000\"\n ]\n}" }, { "path": "crates/cheatcodes/Cargo.toml", "content": "[package]\nname = \"foundry-cheatcodes\"\ndescription = \"Foundry cheatcodes definitions and implementations\"\n\nversion.workspace = true\nedition.workspace = true\nrust-version.workspace = true\nauthors.workspace = true\nlicense.workspace = true\nhomepage.workspace = true\nrepository.workspace = true\nexclude.workspace = true\n\n[lints]\nworkspace = true\n\n[dependencies]\nfoundry-cheatcodes-spec.workspace = true\nfoundry-common.workspace = true\nfoundry-compilers.workspace = true\nfoundry-config.workspace = true\nfoundry-evm-core.workspace = true\nfoundry-primitives.workspace = true\nfoundry-evm-fuzz.workspace = true\nfoundry-evm-traces.workspace = true\nfoundry-wallets.workspace = true\nforge-script-sequence.workspace = true\n\nsolar.workspace = true\n\nalloy-dyn-abi.workspace = true\nalloy-evm.workspace = true\nalloy-json-abi.workspace = true\nalloy-primitives.workspace = true\nalloy-genesis.workspace = true\nalloy-sol-types.workspace = true\nalloy-provider.workspace = true\nalloy-rpc-types = { workspace = true, features = [\"k256\"] }\nalloy-signer.workspace = true\nalloy-signer-local = { workspace = true, features = [\n \"mnemonic-all-languages\",\n \"keystore\",\n] }\nparking_lot.workspace = true\nalloy-consensus = { workspace = true, features = [\"k256\", \"kzg\"] }\nalloy-network.workspace = true\nalloy-rlp.workspace = true\nalloy-chains.workspace = true\nalloy-ens.workspace = true\n\nbase64.workspace = true\ndialoguer.workspace = true\neyre.workspace = true\nitertools.workspace = true\njsonpath_lib.workspace = true\nk256.workspace = true\nmemchr.workspace = true\np256 = \"0.13\"\ned25519-consensus = \"2.1\"\necdsa = \"0.16\"\nrand.workspace = true\nrevm.workspace = true\nrevm-inspectors.workspace = true\nsemver.workspace = true\nserde_json.workspace = true\nthiserror.workspace = true\ntoml = { workspace = true, features = [\"preserve_order\"] }\ntracing.workspace = true\nwalkdir.workspace = true\nproptest.workspace = true\nserde.workspace = true\n" }, { "path": "crates/cheatcodes/README.md", "content": "# foundry-cheatcodes\n\nFoundry cheatcodes definitions and implementations.\n\n## Structure\n\n- [`assets/`](./assets/): JSON interface and specification\n- [`spec/`](./spec/src/lib.rs): Defines common traits and structs\n- [`src/`](./src/lib.rs): Rust implementations of the cheatcodes\n\n## Overview\n\nAll cheatcodes are defined in a single [`sol!`] macro call in [`spec/src/vm.rs`].\n\nThis, combined with the use of an internal [`Cheatcode`](../../crates/cheatcodes/spec/src/cheatcode.rs) derive macro,\nallows us to generate both the Rust definitions and the JSON specification of the cheatcodes.\n\nCheatcodes are manually implemented through the `Cheatcode` trait, which is called in the\n`Cheatcodes` inspector implementation.\n\nSee the [cheatcodes dev documentation](../../docs/dev/cheatcodes.md#cheatcodes-implementation) for more details.\n\n### JSON interface\n\nThe JSON interface is guaranteed to be stable, and can be used by third-party tools to interact with\nthe Foundry cheatcodes externally.\n\nFor example, here are some tools that make use of the JSON interface:\n\n- Internally, this is used to generate [a simple Solidity interface](../../testdata/cheats/Vm.sol) for testing\n- Used by [`forge-std`](https://github.com/foundry-rs/forge-std) to generate [user-friendly Solidity interfaces](https://github.com/foundry-rs/forge-std/blob/master/src/Vm.sol)\n- (WIP) Used by [the Foundry book](https://github.com/foundry-rs/book) to generate [the cheatcodes reference](https://book.getfoundry.sh/cheatcodes)\n- ...\n\nIf you are making use of the JSON interface, please don't hesitate to open a PR to add your project to this list!\n\n### Adding a new cheatcode\n\nPlease see the [cheatcodes dev documentation](../../docs/dev/cheatcodes.md#adding-a-new-cheatcode) on how to add new cheatcodes.\n\n[`sol!`]: https://docs.rs/alloy-sol-macro/latest/alloy_sol_macro/macro.sol.html\n[`spec/src/vm.rs`]: ./spec/src/vm.rs\n" }, { "path": "crates/cheatcodes/assets/cheatcodes.json", "content": "{\n \"errors\": [\n {\n \"name\": \"CheatcodeError\",\n \"description\": \"Error thrown by cheatcodes.\",\n \"declaration\": \"error CheatcodeError(string message);\"\n }\n ],\n \"events\": [],\n \"enums\": [\n {\n \"name\": \"CallerMode\",\n \"description\": \"A modification applied to either `msg.sender` or `tx.origin`. Returned by `readCallers`.\",\n \"variants\": [\n {\n \"name\": \"None\",\n \"description\": \"No caller modification is currently active.\"\n },\n {\n \"name\": \"Broadcast\",\n \"description\": \"A one time broadcast triggered by a `vm.broadcast()` call is currently active.\"\n },\n {\n \"name\": \"RecurrentBroadcast\",\n \"description\": \"A recurrent broadcast triggered by a `vm.startBroadcast()` call is currently active.\"\n },\n {\n \"name\": \"Prank\",\n \"description\": \"A one time prank triggered by a `vm.prank()` call is currently active.\"\n },\n {\n \"name\": \"RecurrentPrank\",\n \"description\": \"A recurrent prank triggered by a `vm.startPrank()` call is currently active.\"\n }\n ]\n },\n {\n \"name\": \"AccountAccessKind\",\n \"description\": \"The kind of account access that occurred.\",\n \"variants\": [\n {\n \"name\": \"Call\",\n \"description\": \"The account was called.\"\n },\n {\n \"name\": \"DelegateCall\",\n \"description\": \"The account was called via delegatecall.\"\n },\n {\n \"name\": \"CallCode\",\n \"description\": \"The account was called via callcode.\"\n },\n {\n \"name\": \"StaticCall\",\n \"description\": \"The account was called via staticcall.\"\n },\n {\n \"name\": \"Create\",\n \"description\": \"The account was created.\"\n },\n {\n \"name\": \"SelfDestruct\",\n \"description\": \"The account was selfdestructed.\"\n },\n {\n \"name\": \"Resume\",\n \"description\": \"Synthetic access indicating the current context has resumed after a previous sub-context (AccountAccess).\"\n },\n {\n \"name\": \"Balance\",\n \"description\": \"The account's balance was read.\"\n },\n {\n \"name\": \"Extcodesize\",\n \"description\": \"The account's codesize was read.\"\n },\n {\n \"name\": \"Extcodehash\",\n \"description\": \"The account's codehash was read.\"\n },\n {\n \"name\": \"Extcodecopy\",\n \"description\": \"The account's code was copied.\"\n }\n ]\n },\n {\n \"name\": \"ForgeContext\",\n \"description\": \"Forge execution contexts.\",\n \"variants\": [\n {\n \"name\": \"TestGroup\",\n \"description\": \"Test group execution context (test, coverage or snapshot).\"\n },\n {\n \"name\": \"Test\",\n \"description\": \"`forge test` execution context.\"\n },\n {\n \"name\": \"Coverage\",\n \"description\": \"`forge coverage` execution context.\"\n },\n {\n \"name\": \"Snapshot\",\n \"description\": \"`forge snapshot` execution context.\"\n },\n {\n \"name\": \"ScriptGroup\",\n \"description\": \"Script group execution context (dry run, broadcast or resume).\"\n },\n {\n \"name\": \"ScriptDryRun\",\n \"description\": \"`forge script` execution context.\"\n },\n {\n \"name\": \"ScriptBroadcast\",\n \"description\": \"`forge script --broadcast` execution context.\"\n },\n {\n \"name\": \"ScriptResume\",\n \"description\": \"`forge script --resume` execution context.\"\n },\n {\n \"name\": \"Unknown\",\n \"description\": \"Unknown `forge` execution context.\"\n }\n ]\n },\n {\n \"name\": \"BroadcastTxType\",\n \"description\": \"The transaction type (`txType`) of the broadcast.\",\n \"variants\": [\n {\n \"name\": \"Call\",\n \"description\": \"Represents a CALL broadcast tx.\"\n },\n {\n \"name\": \"Create\",\n \"description\": \"Represents a CREATE broadcast tx.\"\n },\n {\n \"name\": \"Create2\",\n \"description\": \"Represents a CREATE2 broadcast tx.\"\n }\n ]\n }\n ],\n \"structs\": [\n {\n \"name\": \"Log\",\n \"description\": \"An Ethereum log. Returned by `getRecordedLogs`.\",\n \"fields\": [\n {\n \"name\": \"topics\",\n \"ty\": \"bytes32[]\",\n \"description\": \"The topics of the log, including the signature, if any.\"\n },\n {\n \"name\": \"data\",\n \"ty\": \"bytes\",\n \"description\": \"The raw data of the log.\"\n },\n {\n \"name\": \"emitter\",\n \"ty\": \"address\",\n \"description\": \"The address of the log's emitter.\"\n }\n ]\n },\n {\n \"name\": \"Rpc\",\n \"description\": \"An RPC URL and its alias. Returned by `rpcUrlStructs`.\",\n \"fields\": [\n {\n \"name\": \"key\",\n \"ty\": \"string\",\n \"description\": \"The alias of the RPC URL.\"\n },\n {\n \"name\": \"url\",\n \"ty\": \"string\",\n \"description\": \"The RPC URL.\"\n }\n ]\n },\n {\n \"name\": \"EthGetLogs\",\n \"description\": \"An RPC log object. Returned by `eth_getLogs`.\",\n \"fields\": [\n {\n \"name\": \"emitter\",\n \"ty\": \"address\",\n \"description\": \"The address of the log's emitter.\"\n },\n {\n \"name\": \"topics\",\n \"ty\": \"bytes32[]\",\n \"description\": \"The topics of the log, including the signature, if any.\"\n },\n {\n \"name\": \"data\",\n \"ty\": \"bytes\",\n \"description\": \"The raw data of the log.\"\n },\n {\n \"name\": \"blockHash\",\n \"ty\": \"bytes32\",\n \"description\": \"The block hash.\"\n },\n {\n \"name\": \"blockNumber\",\n \"ty\": \"uint64\",\n \"description\": \"The block number.\"\n },\n {\n \"name\": \"transactionHash\",\n \"ty\": \"bytes32\",\n \"description\": \"The transaction hash.\"\n },\n {\n \"name\": \"transactionIndex\",\n \"ty\": \"uint64\",\n \"description\": \"The transaction index in the block.\"\n },\n {\n \"name\": \"logIndex\",\n \"ty\": \"uint256\",\n \"description\": \"The log index.\"\n },\n {\n \"name\": \"removed\",\n \"ty\": \"bool\",\n \"description\": \"Whether the log was removed.\"\n }\n ]\n },\n {\n \"name\": \"DirEntry\",\n \"description\": \"A single entry in a directory listing. Returned by `readDir`.\",\n \"fields\": [\n {\n \"name\": \"errorMessage\",\n \"ty\": \"string\",\n \"description\": \"The error message, if any.\"\n },\n {\n \"name\": \"path\",\n \"ty\": \"string\",\n \"description\": \"The path of the entry.\"\n },\n {\n \"name\": \"depth\",\n \"ty\": \"uint64\",\n \"description\": \"The depth of the entry.\"\n },\n {\n \"name\": \"isDir\",\n \"ty\": \"bool\",\n \"description\": \"Whether the entry is a directory.\"\n },\n {\n \"name\": \"isSymlink\",\n \"ty\": \"bool\",\n \"description\": \"Whether the entry is a symlink.\"\n }\n ]\n },\n {\n \"name\": \"FsMetadata\",\n \"description\": \"Metadata information about a file.\\n This structure is returned from the `fsMetadata` function and represents known\\n metadata about a file such as its permissions, size, modification\\n times, etc.\",\n \"fields\": [\n {\n \"name\": \"isDir\",\n \"ty\": \"bool\",\n \"description\": \"True if this metadata is for a directory.\"\n },\n {\n \"name\": \"isSymlink\",\n \"ty\": \"bool\",\n \"description\": \"True if this metadata is for a symlink.\"\n },\n {\n \"name\": \"length\",\n \"ty\": \"uint256\",\n \"description\": \"The size of the file, in bytes, this metadata is for.\"\n },\n {\n \"name\": \"readOnly\",\n \"ty\": \"bool\",\n \"description\": \"True if this metadata is for a readonly (unwritable) file.\"\n },\n {\n \"name\": \"modified\",\n \"ty\": \"uint256\",\n \"description\": \"The last modification time listed in this metadata.\"\n },\n {\n \"name\": \"accessed\",\n \"ty\": \"uint256\",\n \"description\": \"The last access time of this metadata.\"\n },\n {\n \"name\": \"created\",\n \"ty\": \"uint256\",\n \"description\": \"The creation time listed in this metadata.\"\n }\n ]\n },\n {\n \"name\": \"Wallet\",\n \"description\": \"A wallet with a public and private key.\",\n \"fields\": [\n {\n \"name\": \"addr\",\n \"ty\": \"address\",\n \"description\": \"The wallet's address.\"\n },\n {\n \"name\": \"publicKeyX\",\n \"ty\": \"uint256\",\n \"description\": \"The wallet's public key `X`.\"\n },\n {\n \"name\": \"publicKeyY\",\n \"ty\": \"uint256\",\n \"description\": \"The wallet's public key `Y`.\"\n },\n {\n \"name\": \"privateKey\",\n \"ty\": \"uint256\",\n \"description\": \"The wallet's private key.\"\n }\n ]\n },\n {\n \"name\": \"FfiResult\",\n \"description\": \"The result of a `tryFfi` call.\",\n \"fields\": [\n {\n \"name\": \"exitCode\",\n \"ty\": \"int32\",\n \"description\": \"The exit code of the call.\"\n },\n {\n \"name\": \"stdout\",\n \"ty\": \"bytes\",\n \"description\": \"The optionally hex-decoded `stdout` data.\"\n },\n {\n \"name\": \"stderr\",\n \"ty\": \"bytes\",\n \"description\": \"The `stderr` data.\"\n }\n ]\n },\n {\n \"name\": \"ChainInfo\",\n \"description\": \"Information on the chain and fork.\",\n \"fields\": [\n {\n \"name\": \"forkId\",\n \"ty\": \"uint256\",\n \"description\": \"The fork identifier. Set to zero if no fork is active.\"\n },\n {\n \"name\": \"chainId\",\n \"ty\": \"uint256\",\n \"description\": \"The chain ID of the current fork.\"\n }\n ]\n },\n {\n \"name\": \"Chain\",\n \"description\": \"Information about a blockchain.\",\n \"fields\": [\n {\n \"name\": \"name\",\n \"ty\": \"string\",\n \"description\": \"The chain name.\"\n },\n {\n \"name\": \"chainId\",\n \"ty\": \"uint256\",\n \"description\": \"The chain's Chain ID.\"\n },\n {\n \"name\": \"chainAlias\",\n \"ty\": \"string\",\n \"description\": \"The chain's alias. (i.e. what gets specified in `foundry.toml`).\"\n },\n {\n \"name\": \"rpcUrl\",\n \"ty\": \"string\",\n \"description\": \"A default RPC endpoint for this chain.\"\n }\n ]\n },\n {\n \"name\": \"AccountAccess\",\n \"description\": \"The result of a `stopAndReturnStateDiff` call.\",\n \"fields\": [\n {\n \"name\": \"chainInfo\",\n \"ty\": \"ChainInfo\",\n \"description\": \"The chain and fork the access occurred.\"\n },\n {\n \"name\": \"kind\",\n \"ty\": \"AccountAccessKind\",\n \"description\": \"The kind of account access that determines what the account is.\\n If kind is Call, DelegateCall, StaticCall or CallCode, then the account is the callee.\\n If kind is Create, then the account is the newly created account.\\n If kind is SelfDestruct, then the account is the selfdestruct recipient.\\n If kind is a Resume, then account represents a account context that has resumed.\"\n },\n {\n \"name\": \"account\",\n \"ty\": \"address\",\n \"description\": \"The account that was accessed.\\n It's either the account created, callee or a selfdestruct recipient for CREATE, CALL or SELFDESTRUCT.\"\n },\n {\n \"name\": \"accessor\",\n \"ty\": \"address\",\n \"description\": \"What accessed the account.\"\n },\n {\n \"name\": \"initialized\",\n \"ty\": \"bool\",\n \"description\": \"If the account was initialized or empty prior to the access.\\n An account is considered initialized if it has code, a\\n non-zero nonce, or a non-zero balance.\"\n },\n {\n \"name\": \"oldBalance\",\n \"ty\": \"uint256\",\n \"description\": \"The previous balance of the accessed account.\"\n },\n {\n \"name\": \"newBalance\",\n \"ty\": \"uint256\",\n \"description\": \"The potential new balance of the accessed account.\\n That is, all balance changes are recorded here, even if reverts occurred.\"\n },\n {\n \"name\": \"deployedCode\",\n \"ty\": \"bytes\",\n \"description\": \"Code of the account deployed by CREATE.\"\n },\n {\n \"name\": \"value\",\n \"ty\": \"uint256\",\n \"description\": \"Value passed along with the account access\"\n },\n {\n \"name\": \"data\",\n \"ty\": \"bytes\",\n \"description\": \"Input data provided to the CREATE or CALL\"\n },\n {\n \"name\": \"reverted\",\n \"ty\": \"bool\",\n \"description\": \"If this access reverted in either the current or parent context.\"\n },\n {\n \"name\": \"storageAccesses\",\n \"ty\": \"StorageAccess[]\",\n \"description\": \"An ordered list of storage accesses made during an account access operation.\"\n },\n {\n \"name\": \"depth\",\n \"ty\": \"uint64\",\n \"description\": \"Call depth traversed during the recording of state differences\"\n },\n {\n \"name\": \"oldNonce\",\n \"ty\": \"uint64\",\n \"description\": \"The previous nonce of the accessed account.\"\n },\n {\n \"name\": \"newNonce\",\n \"ty\": \"uint64\",\n \"description\": \"The new nonce of the accessed account.\"\n }\n ]\n },\n {\n \"name\": \"StorageAccess\",\n \"description\": \"The storage accessed during an `AccountAccess`.\",\n \"fields\": [\n {\n \"name\": \"account\",\n \"ty\": \"address\",\n \"description\": \"The account whose storage was accessed.\"\n },\n {\n \"name\": \"slot\",\n \"ty\": \"bytes32\",\n \"description\": \"The slot that was accessed.\"\n },\n {\n \"name\": \"isWrite\",\n \"ty\": \"bool\",\n \"description\": \"If the access was a write.\"\n },\n {\n \"name\": \"previousValue\",\n \"ty\": \"bytes32\",\n \"description\": \"The previous value of the slot.\"\n },\n {\n \"name\": \"newValue\",\n \"ty\": \"bytes32\",\n \"description\": \"The new value of the slot.\"\n },\n {\n \"name\": \"reverted\",\n \"ty\": \"bool\",\n \"description\": \"If the access was reverted.\"\n }\n ]\n },\n {\n \"name\": \"Gas\",\n \"description\": \"Gas used. Returned by `lastCallGas`.\",\n \"fields\": [\n {\n \"name\": \"gasLimit\",\n \"ty\": \"uint64\",\n \"description\": \"The gas limit of the call.\"\n },\n {\n \"name\": \"gasTotalUsed\",\n \"ty\": \"uint64\",\n \"description\": \"The total gas used.\"\n },\n {\n \"name\": \"gasMemoryUsed\",\n \"ty\": \"uint64\",\n \"description\": \"DEPRECATED: The amount of gas used for memory expansion. Ref: \"\n },\n {\n \"name\": \"gasRefunded\",\n \"ty\": \"int64\",\n \"description\": \"The amount of gas refunded.\"\n },\n {\n \"name\": \"gasRemaining\",\n \"ty\": \"uint64\",\n \"description\": \"The amount of gas remaining.\"\n }\n ]\n },\n {\n \"name\": \"DebugStep\",\n \"description\": \"The result of the `stopDebugTraceRecording` call\",\n \"fields\": [\n {\n \"name\": \"stack\",\n \"ty\": \"uint256[]\",\n \"description\": \"The stack before executing the step of the run.\\n stack\\\\[0\\\\] represents the top of the stack.\\n and only stack data relevant to the opcode execution is contained.\"\n },\n {\n \"name\": \"memoryInput\",\n \"ty\": \"bytes\",\n \"description\": \"The memory input data before executing the step of the run.\\n only input data relevant to the opcode execution is contained.\\n e.g. for MLOAD, it will have memory\\\\[offset:offset+32\\\\] copied here.\\n the offset value can be get by the stack data.\"\n },\n {\n \"name\": \"opcode\",\n \"ty\": \"uint8\",\n \"description\": \"The opcode that was accessed.\"\n },\n {\n \"name\": \"depth\",\n \"ty\": \"uint64\",\n \"description\": \"The call depth of the step.\"\n },\n {\n \"name\": \"isOutOfGas\",\n \"ty\": \"bool\",\n \"description\": \"Whether the call end up with out of gas error.\"\n },\n {\n \"name\": \"contractAddr\",\n \"ty\": \"address\",\n \"description\": \"The contract address where the opcode is running\"\n }\n ]\n },\n {\n \"name\": \"BroadcastTxSummary\",\n \"description\": \"Represents a transaction's broadcast details.\",\n \"fields\": [\n {\n \"name\": \"txHash\",\n \"ty\": \"bytes32\",\n \"description\": \"The hash of the transaction that was broadcasted\"\n },\n {\n \"name\": \"txType\",\n \"ty\": \"BroadcastTxType\",\n \"description\": \"Represent the type of transaction among CALL, CREATE, CREATE2\"\n },\n {\n \"name\": \"contractAddress\",\n \"ty\": \"address\",\n \"description\": \"The address of the contract that was called or created.\\n This is address of the contract that is created if the txType is CREATE or CREATE2.\"\n },\n {\n \"name\": \"blockNumber\",\n \"ty\": \"uint64\",\n \"description\": \"The block number the transaction landed in.\"\n },\n {\n \"name\": \"success\",\n \"ty\": \"bool\",\n \"description\": \"Status of the transaction, retrieved from the transaction receipt.\"\n }\n ]\n },\n {\n \"name\": \"SignedDelegation\",\n \"description\": \"Holds a signed EIP-7702 authorization for an authority account to delegate to an implementation.\",\n \"fields\": [\n {\n \"name\": \"v\",\n \"ty\": \"uint8\",\n \"description\": \"The y-parity of the recovered secp256k1 signature (0 or 1).\"\n },\n {\n \"name\": \"r\",\n \"ty\": \"bytes32\",\n \"description\": \"First 32 bytes of the signature.\"\n },\n {\n \"name\": \"s\",\n \"ty\": \"bytes32\",\n \"description\": \"Second 32 bytes of the signature.\"\n },\n {\n \"name\": \"nonce\",\n \"ty\": \"uint64\",\n \"description\": \"The current nonce of the authority account at signing time.\\n Used to ensure signature can't be replayed after account nonce changes.\"\n },\n {\n \"name\": \"implementation\",\n \"ty\": \"address\",\n \"description\": \"Address of the contract implementation that will be delegated to.\\n Gets encoded into delegation code: 0xef0100 || implementation.\"\n }\n ]\n },\n {\n \"name\": \"PotentialRevert\",\n \"description\": \"Represents a \\\"potential\\\" revert reason from a single subsequent call when using `vm.assumeNoReverts`.\\n Reverts that match will result in a FOUNDRY::ASSUME rejection, whereas unmatched reverts will be surfaced\\n as normal.\",\n \"fields\": [\n {\n \"name\": \"reverter\",\n \"ty\": \"address\",\n \"description\": \"The allowed origin of the revert opcode; address(0) allows reverts from any address\"\n },\n {\n \"name\": \"partialMatch\",\n \"ty\": \"bool\",\n \"description\": \"When true, only matches on the beginning of the revert data, otherwise, matches on entire revert data\"\n },\n {\n \"name\": \"revertData\",\n \"ty\": \"bytes\",\n \"description\": \"The data to use to match encountered reverts\"\n }\n ]\n },\n {\n \"name\": \"AccessListItem\",\n \"description\": \"An EIP-2930 access list item.\",\n \"fields\": [\n {\n \"name\": \"target\",\n \"ty\": \"address\",\n \"description\": \"The address to be added in access list.\"\n },\n {\n \"name\": \"storageKeys\",\n \"ty\": \"bytes32[]\",\n \"description\": \"The storage keys to be added in access list.\"\n }\n ]\n }\n ],\n \"cheatcodes\": [\n {\n \"func\": {\n \"id\": \"_expectCheatcodeRevert_0\",\n \"description\": \"Expects an error on next cheatcode call with any revert data.\",\n \"declaration\": \"function _expectCheatcodeRevert() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"_expectCheatcodeRevert()\",\n \"selector\": \"0x79a4f48a\",\n \"selectorBytes\": [\n 121,\n 164,\n 244,\n 138\n ]\n },\n \"group\": \"testing\",\n \"status\": \"internal\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"_expectCheatcodeRevert_1\",\n \"description\": \"Expects an error on next cheatcode call that starts with the revert data.\",\n \"declaration\": \"function _expectCheatcodeRevert(bytes4 revertData) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"_expectCheatcodeRevert(bytes4)\",\n \"selector\": \"0x884cb0ae\",\n \"selectorBytes\": [\n 136,\n 76,\n 176,\n 174\n ]\n },\n \"group\": \"testing\",\n \"status\": \"internal\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"_expectCheatcodeRevert_2\",\n \"description\": \"Expects an error on next cheatcode call that exactly matches the revert data.\",\n \"declaration\": \"function _expectCheatcodeRevert(bytes calldata revertData) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"_expectCheatcodeRevert(bytes)\",\n \"selector\": \"0x7843b44d\",\n \"selectorBytes\": [\n 120,\n 67,\n 180,\n 77\n ]\n },\n \"group\": \"testing\",\n \"status\": \"internal\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"accessList\",\n \"description\": \"Utility cheatcode to set an EIP-2930 access list for all subsequent transactions.\",\n \"declaration\": \"function accessList(AccessListItem[] calldata access) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"accessList((address,bytes32[])[])\",\n \"selector\": \"0x743e4cb7\",\n \"selectorBytes\": [\n 116,\n 62,\n 76,\n 183\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"accesses\",\n \"description\": \"Gets all accessed reads and write slot from a `vm.record` session, for a given address.\",\n \"declaration\": \"function accesses(address target) external view returns (bytes32[] memory readSlots, bytes32[] memory writeSlots);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"accesses(address)\",\n \"selector\": \"0x65bc9481\",\n \"selectorBytes\": [\n 101,\n 188,\n 148,\n 129\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"activeFork\",\n \"description\": \"Returns the identifier of the currently active fork. Reverts if no fork is currently active.\",\n \"declaration\": \"function activeFork() external view returns (uint256 forkId);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"activeFork()\",\n \"selector\": \"0x2f103f22\",\n \"selectorBytes\": [\n 47,\n 16,\n 63,\n 34\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"addr\",\n \"description\": \"Gets the address for a given private key.\",\n \"declaration\": \"function addr(uint256 privateKey) external pure returns (address keyAddr);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"addr(uint256)\",\n \"selector\": \"0xffa18649\",\n \"selectorBytes\": [\n 255,\n 161,\n 134,\n 73\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"allowCheatcodes\",\n \"description\": \"In forking mode, explicitly grant the given address cheatcode access.\",\n \"declaration\": \"function allowCheatcodes(address account) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"allowCheatcodes(address)\",\n \"selector\": \"0xea060291\",\n \"selectorBytes\": [\n 234,\n 6,\n 2,\n 145\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"assertApproxEqAbsDecimal_0\",\n \"description\": \"Compares two `uint256` values. Expects difference to be less than or equal to `maxDelta`.\\nFormats values with decimals in failure message.\",\n \"declaration\": \"function assertApproxEqAbsDecimal(uint256 left, uint256 right, uint256 maxDelta, uint256 decimals) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertApproxEqAbsDecimal(uint256,uint256,uint256,uint256)\",\n \"selector\": \"0x045c55ce\",\n \"selectorBytes\": [\n 4,\n 92,\n 85,\n 206\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertApproxEqAbsDecimal_1\",\n \"description\": \"Compares two `uint256` values. Expects difference to be less than or equal to `maxDelta`.\\nFormats values with decimals in failure message. Includes error message into revert string on failure.\",\n \"declaration\": \"function assertApproxEqAbsDecimal(uint256 left, uint256 right, uint256 maxDelta, uint256 decimals, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertApproxEqAbsDecimal(uint256,uint256,uint256,uint256,string)\",\n \"selector\": \"0x60429eb2\",\n \"selectorBytes\": [\n 96,\n 66,\n 158,\n 178\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertApproxEqAbsDecimal_2\",\n \"description\": \"Compares two `int256` values. Expects difference to be less than or equal to `maxDelta`.\\nFormats values with decimals in failure message.\",\n \"declaration\": \"function assertApproxEqAbsDecimal(int256 left, int256 right, uint256 maxDelta, uint256 decimals) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertApproxEqAbsDecimal(int256,int256,uint256,uint256)\",\n \"selector\": \"0x3d5bc8bc\",\n \"selectorBytes\": [\n 61,\n 91,\n 200,\n 188\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertApproxEqAbsDecimal_3\",\n \"description\": \"Compares two `int256` values. Expects difference to be less than or equal to `maxDelta`.\\nFormats values with decimals in failure message. Includes error message into revert string on failure.\",\n \"declaration\": \"function assertApproxEqAbsDecimal(int256 left, int256 right, uint256 maxDelta, uint256 decimals, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertApproxEqAbsDecimal(int256,int256,uint256,uint256,string)\",\n \"selector\": \"0x6a5066d4\",\n \"selectorBytes\": [\n 106,\n 80,\n 102,\n 212\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertApproxEqAbs_0\",\n \"description\": \"Compares two `uint256` values. Expects difference to be less than or equal to `maxDelta`.\",\n \"declaration\": \"function assertApproxEqAbs(uint256 left, uint256 right, uint256 maxDelta) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertApproxEqAbs(uint256,uint256,uint256)\",\n \"selector\": \"0x16d207c6\",\n \"selectorBytes\": [\n 22,\n 210,\n 7,\n 198\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertApproxEqAbs_1\",\n \"description\": \"Compares two `uint256` values. Expects difference to be less than or equal to `maxDelta`.\\nIncludes error message into revert string on failure.\",\n \"declaration\": \"function assertApproxEqAbs(uint256 left, uint256 right, uint256 maxDelta, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertApproxEqAbs(uint256,uint256,uint256,string)\",\n \"selector\": \"0xf710b062\",\n \"selectorBytes\": [\n 247,\n 16,\n 176,\n 98\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertApproxEqAbs_2\",\n \"description\": \"Compares two `int256` values. Expects difference to be less than or equal to `maxDelta`.\",\n \"declaration\": \"function assertApproxEqAbs(int256 left, int256 right, uint256 maxDelta) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertApproxEqAbs(int256,int256,uint256)\",\n \"selector\": \"0x240f839d\",\n \"selectorBytes\": [\n 36,\n 15,\n 131,\n 157\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertApproxEqAbs_3\",\n \"description\": \"Compares two `int256` values. Expects difference to be less than or equal to `maxDelta`.\\nIncludes error message into revert string on failure.\",\n \"declaration\": \"function assertApproxEqAbs(int256 left, int256 right, uint256 maxDelta, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertApproxEqAbs(int256,int256,uint256,string)\",\n \"selector\": \"0x8289e621\",\n \"selectorBytes\": [\n 130,\n 137,\n 230,\n 33\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertApproxEqRelDecimal_0\",\n \"description\": \"Compares two `uint256` values. Expects relative difference in percents to be less than or equal to `maxPercentDelta`.\\n`maxPercentDelta` is an 18 decimal fixed point number, where 1e18 == 100%\\nFormats values with decimals in failure message.\",\n \"declaration\": \"function assertApproxEqRelDecimal(uint256 left, uint256 right, uint256 maxPercentDelta, uint256 decimals) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertApproxEqRelDecimal(uint256,uint256,uint256,uint256)\",\n \"selector\": \"0x21ed2977\",\n \"selectorBytes\": [\n 33,\n 237,\n 41,\n 119\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertApproxEqRelDecimal_1\",\n \"description\": \"Compares two `uint256` values. Expects relative difference in percents to be less than or equal to `maxPercentDelta`.\\n`maxPercentDelta` is an 18 decimal fixed point number, where 1e18 == 100%\\nFormats values with decimals in failure message. Includes error message into revert string on failure.\",\n \"declaration\": \"function assertApproxEqRelDecimal(uint256 left, uint256 right, uint256 maxPercentDelta, uint256 decimals, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertApproxEqRelDecimal(uint256,uint256,uint256,uint256,string)\",\n \"selector\": \"0x82d6c8fd\",\n \"selectorBytes\": [\n 130,\n 214,\n 200,\n 253\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertApproxEqRelDecimal_2\",\n \"description\": \"Compares two `int256` values. Expects relative difference in percents to be less than or equal to `maxPercentDelta`.\\n`maxPercentDelta` is an 18 decimal fixed point number, where 1e18 == 100%\\nFormats values with decimals in failure message.\",\n \"declaration\": \"function assertApproxEqRelDecimal(int256 left, int256 right, uint256 maxPercentDelta, uint256 decimals) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertApproxEqRelDecimal(int256,int256,uint256,uint256)\",\n \"selector\": \"0xabbf21cc\",\n \"selectorBytes\": [\n 171,\n 191,\n 33,\n 204\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertApproxEqRelDecimal_3\",\n \"description\": \"Compares two `int256` values. Expects relative difference in percents to be less than or equal to `maxPercentDelta`.\\n`maxPercentDelta` is an 18 decimal fixed point number, where 1e18 == 100%\\nFormats values with decimals in failure message. Includes error message into revert string on failure.\",\n \"declaration\": \"function assertApproxEqRelDecimal(int256 left, int256 right, uint256 maxPercentDelta, uint256 decimals, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertApproxEqRelDecimal(int256,int256,uint256,uint256,string)\",\n \"selector\": \"0xfccc11c4\",\n \"selectorBytes\": [\n 252,\n 204,\n 17,\n 196\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertApproxEqRel_0\",\n \"description\": \"Compares two `uint256` values. Expects relative difference in percents to be less than or equal to `maxPercentDelta`.\\n`maxPercentDelta` is an 18 decimal fixed point number, where 1e18 == 100%\",\n \"declaration\": \"function assertApproxEqRel(uint256 left, uint256 right, uint256 maxPercentDelta) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertApproxEqRel(uint256,uint256,uint256)\",\n \"selector\": \"0x8cf25ef4\",\n \"selectorBytes\": [\n 140,\n 242,\n 94,\n 244\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertApproxEqRel_1\",\n \"description\": \"Compares two `uint256` values. Expects relative difference in percents to be less than or equal to `maxPercentDelta`.\\n`maxPercentDelta` is an 18 decimal fixed point number, where 1e18 == 100%\\nIncludes error message into revert string on failure.\",\n \"declaration\": \"function assertApproxEqRel(uint256 left, uint256 right, uint256 maxPercentDelta, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertApproxEqRel(uint256,uint256,uint256,string)\",\n \"selector\": \"0x1ecb7d33\",\n \"selectorBytes\": [\n 30,\n 203,\n 125,\n 51\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertApproxEqRel_2\",\n \"description\": \"Compares two `int256` values. Expects relative difference in percents to be less than or equal to `maxPercentDelta`.\\n`maxPercentDelta` is an 18 decimal fixed point number, where 1e18 == 100%\",\n \"declaration\": \"function assertApproxEqRel(int256 left, int256 right, uint256 maxPercentDelta) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertApproxEqRel(int256,int256,uint256)\",\n \"selector\": \"0xfea2d14f\",\n \"selectorBytes\": [\n 254,\n 162,\n 209,\n 79\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertApproxEqRel_3\",\n \"description\": \"Compares two `int256` values. Expects relative difference in percents to be less than or equal to `maxPercentDelta`.\\n`maxPercentDelta` is an 18 decimal fixed point number, where 1e18 == 100%\\nIncludes error message into revert string on failure.\",\n \"declaration\": \"function assertApproxEqRel(int256 left, int256 right, uint256 maxPercentDelta, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertApproxEqRel(int256,int256,uint256,string)\",\n \"selector\": \"0xef277d72\",\n \"selectorBytes\": [\n 239,\n 39,\n 125,\n 114\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEqDecimal_0\",\n \"description\": \"Asserts that two `uint256` values are equal, formatting them with decimals in failure message.\",\n \"declaration\": \"function assertEqDecimal(uint256 left, uint256 right, uint256 decimals) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEqDecimal(uint256,uint256,uint256)\",\n \"selector\": \"0x27af7d9c\",\n \"selectorBytes\": [\n 39,\n 175,\n 125,\n 156\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEqDecimal_1\",\n \"description\": \"Asserts that two `uint256` values are equal, formatting them with decimals in failure message.\\nIncludes error message into revert string on failure.\",\n \"declaration\": \"function assertEqDecimal(uint256 left, uint256 right, uint256 decimals, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEqDecimal(uint256,uint256,uint256,string)\",\n \"selector\": \"0xd0cbbdef\",\n \"selectorBytes\": [\n 208,\n 203,\n 189,\n 239\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEqDecimal_2\",\n \"description\": \"Asserts that two `int256` values are equal, formatting them with decimals in failure message.\",\n \"declaration\": \"function assertEqDecimal(int256 left, int256 right, uint256 decimals) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEqDecimal(int256,int256,uint256)\",\n \"selector\": \"0x48016c04\",\n \"selectorBytes\": [\n 72,\n 1,\n 108,\n 4\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEqDecimal_3\",\n \"description\": \"Asserts that two `int256` values are equal, formatting them with decimals in failure message.\\nIncludes error message into revert string on failure.\",\n \"declaration\": \"function assertEqDecimal(int256 left, int256 right, uint256 decimals, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEqDecimal(int256,int256,uint256,string)\",\n \"selector\": \"0x7e77b0c5\",\n \"selectorBytes\": [\n 126,\n 119,\n 176,\n 197\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_0\",\n \"description\": \"Asserts that two `bool` values are equal.\",\n \"declaration\": \"function assertEq(bool left, bool right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(bool,bool)\",\n \"selector\": \"0xf7fe3477\",\n \"selectorBytes\": [\n 247,\n 254,\n 52,\n 119\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_1\",\n \"description\": \"Asserts that two `bool` values are equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertEq(bool left, bool right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(bool,bool,string)\",\n \"selector\": \"0x4db19e7e\",\n \"selectorBytes\": [\n 77,\n 177,\n 158,\n 126\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_10\",\n \"description\": \"Asserts that two `string` values are equal.\",\n \"declaration\": \"function assertEq(string calldata left, string calldata right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(string,string)\",\n \"selector\": \"0xf320d963\",\n \"selectorBytes\": [\n 243,\n 32,\n 217,\n 99\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_11\",\n \"description\": \"Asserts that two `string` values are equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertEq(string calldata left, string calldata right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(string,string,string)\",\n \"selector\": \"0x36f656d8\",\n \"selectorBytes\": [\n 54,\n 246,\n 86,\n 216\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_12\",\n \"description\": \"Asserts that two `bytes` values are equal.\",\n \"declaration\": \"function assertEq(bytes calldata left, bytes calldata right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(bytes,bytes)\",\n \"selector\": \"0x97624631\",\n \"selectorBytes\": [\n 151,\n 98,\n 70,\n 49\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_13\",\n \"description\": \"Asserts that two `bytes` values are equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertEq(bytes calldata left, bytes calldata right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(bytes,bytes,string)\",\n \"selector\": \"0xe24fed00\",\n \"selectorBytes\": [\n 226,\n 79,\n 237,\n 0\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_14\",\n \"description\": \"Asserts that two arrays of `bool` values are equal.\",\n \"declaration\": \"function assertEq(bool[] calldata left, bool[] calldata right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(bool[],bool[])\",\n \"selector\": \"0x707df785\",\n \"selectorBytes\": [\n 112,\n 125,\n 247,\n 133\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_15\",\n \"description\": \"Asserts that two arrays of `bool` values are equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertEq(bool[] calldata left, bool[] calldata right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(bool[],bool[],string)\",\n \"selector\": \"0xe48a8f8d\",\n \"selectorBytes\": [\n 228,\n 138,\n 143,\n 141\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_16\",\n \"description\": \"Asserts that two arrays of `uint256 values are equal.\",\n \"declaration\": \"function assertEq(uint256[] calldata left, uint256[] calldata right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(uint256[],uint256[])\",\n \"selector\": \"0x975d5a12\",\n \"selectorBytes\": [\n 151,\n 93,\n 90,\n 18\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_17\",\n \"description\": \"Asserts that two arrays of `uint256` values are equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertEq(uint256[] calldata left, uint256[] calldata right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(uint256[],uint256[],string)\",\n \"selector\": \"0x5d18c73a\",\n \"selectorBytes\": [\n 93,\n 24,\n 199,\n 58\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_18\",\n \"description\": \"Asserts that two arrays of `int256` values are equal.\",\n \"declaration\": \"function assertEq(int256[] calldata left, int256[] calldata right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(int256[],int256[])\",\n \"selector\": \"0x711043ac\",\n \"selectorBytes\": [\n 113,\n 16,\n 67,\n 172\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_19\",\n \"description\": \"Asserts that two arrays of `int256` values are equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertEq(int256[] calldata left, int256[] calldata right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(int256[],int256[],string)\",\n \"selector\": \"0x191f1b30\",\n \"selectorBytes\": [\n 25,\n 31,\n 27,\n 48\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_2\",\n \"description\": \"Asserts that two `uint256` values are equal.\",\n \"declaration\": \"function assertEq(uint256 left, uint256 right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(uint256,uint256)\",\n \"selector\": \"0x98296c54\",\n \"selectorBytes\": [\n 152,\n 41,\n 108,\n 84\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_20\",\n \"description\": \"Asserts that two arrays of `address` values are equal.\",\n \"declaration\": \"function assertEq(address[] calldata left, address[] calldata right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(address[],address[])\",\n \"selector\": \"0x3868ac34\",\n \"selectorBytes\": [\n 56,\n 104,\n 172,\n 52\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_21\",\n \"description\": \"Asserts that two arrays of `address` values are equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertEq(address[] calldata left, address[] calldata right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(address[],address[],string)\",\n \"selector\": \"0x3e9173c5\",\n \"selectorBytes\": [\n 62,\n 145,\n 115,\n 197\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_22\",\n \"description\": \"Asserts that two arrays of `bytes32` values are equal.\",\n \"declaration\": \"function assertEq(bytes32[] calldata left, bytes32[] calldata right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(bytes32[],bytes32[])\",\n \"selector\": \"0x0cc9ee84\",\n \"selectorBytes\": [\n 12,\n 201,\n 238,\n 132\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_23\",\n \"description\": \"Asserts that two arrays of `bytes32` values are equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertEq(bytes32[] calldata left, bytes32[] calldata right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(bytes32[],bytes32[],string)\",\n \"selector\": \"0xe03e9177\",\n \"selectorBytes\": [\n 224,\n 62,\n 145,\n 119\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_24\",\n \"description\": \"Asserts that two arrays of `string` values are equal.\",\n \"declaration\": \"function assertEq(string[] calldata left, string[] calldata right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(string[],string[])\",\n \"selector\": \"0xcf1c049c\",\n \"selectorBytes\": [\n 207,\n 28,\n 4,\n 156\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_25\",\n \"description\": \"Asserts that two arrays of `string` values are equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertEq(string[] calldata left, string[] calldata right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(string[],string[],string)\",\n \"selector\": \"0xeff6b27d\",\n \"selectorBytes\": [\n 239,\n 246,\n 178,\n 125\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_26\",\n \"description\": \"Asserts that two arrays of `bytes` values are equal.\",\n \"declaration\": \"function assertEq(bytes[] calldata left, bytes[] calldata right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(bytes[],bytes[])\",\n \"selector\": \"0xe5fb9b4a\",\n \"selectorBytes\": [\n 229,\n 251,\n 155,\n 74\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_27\",\n \"description\": \"Asserts that two arrays of `bytes` values are equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertEq(bytes[] calldata left, bytes[] calldata right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(bytes[],bytes[],string)\",\n \"selector\": \"0xf413f0b6\",\n \"selectorBytes\": [\n 244,\n 19,\n 240,\n 182\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_3\",\n \"description\": \"Asserts that two `uint256` values are equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertEq(uint256 left, uint256 right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(uint256,uint256,string)\",\n \"selector\": \"0x88b44c85\",\n \"selectorBytes\": [\n 136,\n 180,\n 76,\n 133\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_4\",\n \"description\": \"Asserts that two `int256` values are equal.\",\n \"declaration\": \"function assertEq(int256 left, int256 right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(int256,int256)\",\n \"selector\": \"0xfe74f05b\",\n \"selectorBytes\": [\n 254,\n 116,\n 240,\n 91\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_5\",\n \"description\": \"Asserts that two `int256` values are equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertEq(int256 left, int256 right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(int256,int256,string)\",\n \"selector\": \"0x714a2f13\",\n \"selectorBytes\": [\n 113,\n 74,\n 47,\n 19\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_6\",\n \"description\": \"Asserts that two `address` values are equal.\",\n \"declaration\": \"function assertEq(address left, address right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(address,address)\",\n \"selector\": \"0x515361f6\",\n \"selectorBytes\": [\n 81,\n 83,\n 97,\n 246\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_7\",\n \"description\": \"Asserts that two `address` values are equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertEq(address left, address right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(address,address,string)\",\n \"selector\": \"0x2f2769d1\",\n \"selectorBytes\": [\n 47,\n 39,\n 105,\n 209\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_8\",\n \"description\": \"Asserts that two `bytes32` values are equal.\",\n \"declaration\": \"function assertEq(bytes32 left, bytes32 right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(bytes32,bytes32)\",\n \"selector\": \"0x7c84c69b\",\n \"selectorBytes\": [\n 124,\n 132,\n 198,\n 155\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertEq_9\",\n \"description\": \"Asserts that two `bytes32` values are equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertEq(bytes32 left, bytes32 right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertEq(bytes32,bytes32,string)\",\n \"selector\": \"0xc1fa1ed0\",\n \"selectorBytes\": [\n 193,\n 250,\n 30,\n 208\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertFalse_0\",\n \"description\": \"Asserts that the given condition is false.\",\n \"declaration\": \"function assertFalse(bool condition) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertFalse(bool)\",\n \"selector\": \"0xa5982885\",\n \"selectorBytes\": [\n 165,\n 152,\n 40,\n 133\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertFalse_1\",\n \"description\": \"Asserts that the given condition is false and includes error message into revert string on failure.\",\n \"declaration\": \"function assertFalse(bool condition, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertFalse(bool,string)\",\n \"selector\": \"0x7ba04809\",\n \"selectorBytes\": [\n 123,\n 160,\n 72,\n 9\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertGeDecimal_0\",\n \"description\": \"Compares two `uint256` values. Expects first value to be greater than or equal to second.\\nFormats values with decimals in failure message.\",\n \"declaration\": \"function assertGeDecimal(uint256 left, uint256 right, uint256 decimals) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertGeDecimal(uint256,uint256,uint256)\",\n \"selector\": \"0x3d1fe08a\",\n \"selectorBytes\": [\n 61,\n 31,\n 224,\n 138\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertGeDecimal_1\",\n \"description\": \"Compares two `uint256` values. Expects first value to be greater than or equal to second.\\nFormats values with decimals in failure message. Includes error message into revert string on failure.\",\n \"declaration\": \"function assertGeDecimal(uint256 left, uint256 right, uint256 decimals, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertGeDecimal(uint256,uint256,uint256,string)\",\n \"selector\": \"0x8bff9133\",\n \"selectorBytes\": [\n 139,\n 255,\n 145,\n 51\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertGeDecimal_2\",\n \"description\": \"Compares two `int256` values. Expects first value to be greater than or equal to second.\\nFormats values with decimals in failure message.\",\n \"declaration\": \"function assertGeDecimal(int256 left, int256 right, uint256 decimals) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertGeDecimal(int256,int256,uint256)\",\n \"selector\": \"0xdc28c0f1\",\n \"selectorBytes\": [\n 220,\n 40,\n 192,\n 241\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertGeDecimal_3\",\n \"description\": \"Compares two `int256` values. Expects first value to be greater than or equal to second.\\nFormats values with decimals in failure message. Includes error message into revert string on failure.\",\n \"declaration\": \"function assertGeDecimal(int256 left, int256 right, uint256 decimals, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertGeDecimal(int256,int256,uint256,string)\",\n \"selector\": \"0x5df93c9b\",\n \"selectorBytes\": [\n 93,\n 249,\n 60,\n 155\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertGe_0\",\n \"description\": \"Compares two `uint256` values. Expects first value to be greater than or equal to second.\",\n \"declaration\": \"function assertGe(uint256 left, uint256 right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertGe(uint256,uint256)\",\n \"selector\": \"0xa8d4d1d9\",\n \"selectorBytes\": [\n 168,\n 212,\n 209,\n 217\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertGe_1\",\n \"description\": \"Compares two `uint256` values. Expects first value to be greater than or equal to second.\\nIncludes error message into revert string on failure.\",\n \"declaration\": \"function assertGe(uint256 left, uint256 right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertGe(uint256,uint256,string)\",\n \"selector\": \"0xe25242c0\",\n \"selectorBytes\": [\n 226,\n 82,\n 66,\n 192\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertGe_2\",\n \"description\": \"Compares two `int256` values. Expects first value to be greater than or equal to second.\",\n \"declaration\": \"function assertGe(int256 left, int256 right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertGe(int256,int256)\",\n \"selector\": \"0x0a30b771\",\n \"selectorBytes\": [\n 10,\n 48,\n 183,\n 113\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertGe_3\",\n \"description\": \"Compares two `int256` values. Expects first value to be greater than or equal to second.\\nIncludes error message into revert string on failure.\",\n \"declaration\": \"function assertGe(int256 left, int256 right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertGe(int256,int256,string)\",\n \"selector\": \"0xa84328dd\",\n \"selectorBytes\": [\n 168,\n 67,\n 40,\n 221\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertGtDecimal_0\",\n \"description\": \"Compares two `uint256` values. Expects first value to be greater than second.\\nFormats values with decimals in failure message.\",\n \"declaration\": \"function assertGtDecimal(uint256 left, uint256 right, uint256 decimals) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertGtDecimal(uint256,uint256,uint256)\",\n \"selector\": \"0xeccd2437\",\n \"selectorBytes\": [\n 236,\n 205,\n 36,\n 55\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertGtDecimal_1\",\n \"description\": \"Compares two `uint256` values. Expects first value to be greater than second.\\nFormats values with decimals in failure message. Includes error message into revert string on failure.\",\n \"declaration\": \"function assertGtDecimal(uint256 left, uint256 right, uint256 decimals, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertGtDecimal(uint256,uint256,uint256,string)\",\n \"selector\": \"0x64949a8d\",\n \"selectorBytes\": [\n 100,\n 148,\n 154,\n 141\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertGtDecimal_2\",\n \"description\": \"Compares two `int256` values. Expects first value to be greater than second.\\nFormats values with decimals in failure message.\",\n \"declaration\": \"function assertGtDecimal(int256 left, int256 right, uint256 decimals) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertGtDecimal(int256,int256,uint256)\",\n \"selector\": \"0x78611f0e\",\n \"selectorBytes\": [\n 120,\n 97,\n 31,\n 14\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertGtDecimal_3\",\n \"description\": \"Compares two `int256` values. Expects first value to be greater than second.\\nFormats values with decimals in failure message. Includes error message into revert string on failure.\",\n \"declaration\": \"function assertGtDecimal(int256 left, int256 right, uint256 decimals, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertGtDecimal(int256,int256,uint256,string)\",\n \"selector\": \"0x04a5c7ab\",\n \"selectorBytes\": [\n 4,\n 165,\n 199,\n 171\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertGt_0\",\n \"description\": \"Compares two `uint256` values. Expects first value to be greater than second.\",\n \"declaration\": \"function assertGt(uint256 left, uint256 right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertGt(uint256,uint256)\",\n \"selector\": \"0xdb07fcd2\",\n \"selectorBytes\": [\n 219,\n 7,\n 252,\n 210\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertGt_1\",\n \"description\": \"Compares two `uint256` values. Expects first value to be greater than second.\\nIncludes error message into revert string on failure.\",\n \"declaration\": \"function assertGt(uint256 left, uint256 right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertGt(uint256,uint256,string)\",\n \"selector\": \"0xd9a3c4d2\",\n \"selectorBytes\": [\n 217,\n 163,\n 196,\n 210\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertGt_2\",\n \"description\": \"Compares two `int256` values. Expects first value to be greater than second.\",\n \"declaration\": \"function assertGt(int256 left, int256 right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertGt(int256,int256)\",\n \"selector\": \"0x5a362d45\",\n \"selectorBytes\": [\n 90,\n 54,\n 45,\n 69\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertGt_3\",\n \"description\": \"Compares two `int256` values. Expects first value to be greater than second.\\nIncludes error message into revert string on failure.\",\n \"declaration\": \"function assertGt(int256 left, int256 right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertGt(int256,int256,string)\",\n \"selector\": \"0xf8d33b9b\",\n \"selectorBytes\": [\n 248,\n 211,\n 59,\n 155\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertLeDecimal_0\",\n \"description\": \"Compares two `uint256` values. Expects first value to be less than or equal to second.\\nFormats values with decimals in failure message.\",\n \"declaration\": \"function assertLeDecimal(uint256 left, uint256 right, uint256 decimals) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertLeDecimal(uint256,uint256,uint256)\",\n \"selector\": \"0xc304aab7\",\n \"selectorBytes\": [\n 195,\n 4,\n 170,\n 183\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertLeDecimal_1\",\n \"description\": \"Compares two `uint256` values. Expects first value to be less than or equal to second.\\nFormats values with decimals in failure message. Includes error message into revert string on failure.\",\n \"declaration\": \"function assertLeDecimal(uint256 left, uint256 right, uint256 decimals, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertLeDecimal(uint256,uint256,uint256,string)\",\n \"selector\": \"0x7fefbbe0\",\n \"selectorBytes\": [\n 127,\n 239,\n 187,\n 224\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertLeDecimal_2\",\n \"description\": \"Compares two `int256` values. Expects first value to be less than or equal to second.\\nFormats values with decimals in failure message.\",\n \"declaration\": \"function assertLeDecimal(int256 left, int256 right, uint256 decimals) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertLeDecimal(int256,int256,uint256)\",\n \"selector\": \"0x11d1364a\",\n \"selectorBytes\": [\n 17,\n 209,\n 54,\n 74\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertLeDecimal_3\",\n \"description\": \"Compares two `int256` values. Expects first value to be less than or equal to second.\\nFormats values with decimals in failure message. Includes error message into revert string on failure.\",\n \"declaration\": \"function assertLeDecimal(int256 left, int256 right, uint256 decimals, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertLeDecimal(int256,int256,uint256,string)\",\n \"selector\": \"0xaa5cf788\",\n \"selectorBytes\": [\n 170,\n 92,\n 247,\n 136\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertLe_0\",\n \"description\": \"Compares two `uint256` values. Expects first value to be less than or equal to second.\",\n \"declaration\": \"function assertLe(uint256 left, uint256 right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertLe(uint256,uint256)\",\n \"selector\": \"0x8466f415\",\n \"selectorBytes\": [\n 132,\n 102,\n 244,\n 21\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertLe_1\",\n \"description\": \"Compares two `uint256` values. Expects first value to be less than or equal to second.\\nIncludes error message into revert string on failure.\",\n \"declaration\": \"function assertLe(uint256 left, uint256 right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertLe(uint256,uint256,string)\",\n \"selector\": \"0xd17d4b0d\",\n \"selectorBytes\": [\n 209,\n 125,\n 75,\n 13\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertLe_2\",\n \"description\": \"Compares two `int256` values. Expects first value to be less than or equal to second.\",\n \"declaration\": \"function assertLe(int256 left, int256 right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertLe(int256,int256)\",\n \"selector\": \"0x95fd154e\",\n \"selectorBytes\": [\n 149,\n 253,\n 21,\n 78\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertLe_3\",\n \"description\": \"Compares two `int256` values. Expects first value to be less than or equal to second.\\nIncludes error message into revert string on failure.\",\n \"declaration\": \"function assertLe(int256 left, int256 right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertLe(int256,int256,string)\",\n \"selector\": \"0x4dfe692c\",\n \"selectorBytes\": [\n 77,\n 254,\n 105,\n 44\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertLtDecimal_0\",\n \"description\": \"Compares two `uint256` values. Expects first value to be less than second.\\nFormats values with decimals in failure message.\",\n \"declaration\": \"function assertLtDecimal(uint256 left, uint256 right, uint256 decimals) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertLtDecimal(uint256,uint256,uint256)\",\n \"selector\": \"0x2077337e\",\n \"selectorBytes\": [\n 32,\n 119,\n 51,\n 126\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertLtDecimal_1\",\n \"description\": \"Compares two `uint256` values. Expects first value to be less than second.\\nFormats values with decimals in failure message. Includes error message into revert string on failure.\",\n \"declaration\": \"function assertLtDecimal(uint256 left, uint256 right, uint256 decimals, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertLtDecimal(uint256,uint256,uint256,string)\",\n \"selector\": \"0xa972d037\",\n \"selectorBytes\": [\n 169,\n 114,\n 208,\n 55\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertLtDecimal_2\",\n \"description\": \"Compares two `int256` values. Expects first value to be less than second.\\nFormats values with decimals in failure message.\",\n \"declaration\": \"function assertLtDecimal(int256 left, int256 right, uint256 decimals) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertLtDecimal(int256,int256,uint256)\",\n \"selector\": \"0xdbe8d88b\",\n \"selectorBytes\": [\n 219,\n 232,\n 216,\n 139\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertLtDecimal_3\",\n \"description\": \"Compares two `int256` values. Expects first value to be less than second.\\nFormats values with decimals in failure message. Includes error message into revert string on failure.\",\n \"declaration\": \"function assertLtDecimal(int256 left, int256 right, uint256 decimals, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertLtDecimal(int256,int256,uint256,string)\",\n \"selector\": \"0x40f0b4e0\",\n \"selectorBytes\": [\n 64,\n 240,\n 180,\n 224\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertLt_0\",\n \"description\": \"Compares two `uint256` values. Expects first value to be less than second.\",\n \"declaration\": \"function assertLt(uint256 left, uint256 right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertLt(uint256,uint256)\",\n \"selector\": \"0xb12fc005\",\n \"selectorBytes\": [\n 177,\n 47,\n 192,\n 5\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertLt_1\",\n \"description\": \"Compares two `uint256` values. Expects first value to be less than second.\\nIncludes error message into revert string on failure.\",\n \"declaration\": \"function assertLt(uint256 left, uint256 right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertLt(uint256,uint256,string)\",\n \"selector\": \"0x65d5c135\",\n \"selectorBytes\": [\n 101,\n 213,\n 193,\n 53\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertLt_2\",\n \"description\": \"Compares two `int256` values. Expects first value to be less than second.\",\n \"declaration\": \"function assertLt(int256 left, int256 right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertLt(int256,int256)\",\n \"selector\": \"0x3e914080\",\n \"selectorBytes\": [\n 62,\n 145,\n 64,\n 128\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertLt_3\",\n \"description\": \"Compares two `int256` values. Expects first value to be less than second.\\nIncludes error message into revert string on failure.\",\n \"declaration\": \"function assertLt(int256 left, int256 right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertLt(int256,int256,string)\",\n \"selector\": \"0x9ff531e3\",\n \"selectorBytes\": [\n 159,\n 245,\n 49,\n 227\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEqDecimal_0\",\n \"description\": \"Asserts that two `uint256` values are not equal, formatting them with decimals in failure message.\",\n \"declaration\": \"function assertNotEqDecimal(uint256 left, uint256 right, uint256 decimals) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEqDecimal(uint256,uint256,uint256)\",\n \"selector\": \"0x669efca7\",\n \"selectorBytes\": [\n 102,\n 158,\n 252,\n 167\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEqDecimal_1\",\n \"description\": \"Asserts that two `uint256` values are not equal, formatting them with decimals in failure message.\\nIncludes error message into revert string on failure.\",\n \"declaration\": \"function assertNotEqDecimal(uint256 left, uint256 right, uint256 decimals, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEqDecimal(uint256,uint256,uint256,string)\",\n \"selector\": \"0xf5a55558\",\n \"selectorBytes\": [\n 245,\n 165,\n 85,\n 88\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEqDecimal_2\",\n \"description\": \"Asserts that two `int256` values are not equal, formatting them with decimals in failure message.\",\n \"declaration\": \"function assertNotEqDecimal(int256 left, int256 right, uint256 decimals) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEqDecimal(int256,int256,uint256)\",\n \"selector\": \"0x14e75680\",\n \"selectorBytes\": [\n 20,\n 231,\n 86,\n 128\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEqDecimal_3\",\n \"description\": \"Asserts that two `int256` values are not equal, formatting them with decimals in failure message.\\nIncludes error message into revert string on failure.\",\n \"declaration\": \"function assertNotEqDecimal(int256 left, int256 right, uint256 decimals, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEqDecimal(int256,int256,uint256,string)\",\n \"selector\": \"0x33949f0b\",\n \"selectorBytes\": [\n 51,\n 148,\n 159,\n 11\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_0\",\n \"description\": \"Asserts that two `bool` values are not equal.\",\n \"declaration\": \"function assertNotEq(bool left, bool right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(bool,bool)\",\n \"selector\": \"0x236e4d66\",\n \"selectorBytes\": [\n 35,\n 110,\n 77,\n 102\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_1\",\n \"description\": \"Asserts that two `bool` values are not equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertNotEq(bool left, bool right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(bool,bool,string)\",\n \"selector\": \"0x1091a261\",\n \"selectorBytes\": [\n 16,\n 145,\n 162,\n 97\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_10\",\n \"description\": \"Asserts that two `string` values are not equal.\",\n \"declaration\": \"function assertNotEq(string calldata left, string calldata right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(string,string)\",\n \"selector\": \"0x6a8237b3\",\n \"selectorBytes\": [\n 106,\n 130,\n 55,\n 179\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_11\",\n \"description\": \"Asserts that two `string` values are not equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertNotEq(string calldata left, string calldata right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(string,string,string)\",\n \"selector\": \"0x78bdcea7\",\n \"selectorBytes\": [\n 120,\n 189,\n 206,\n 167\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_12\",\n \"description\": \"Asserts that two `bytes` values are not equal.\",\n \"declaration\": \"function assertNotEq(bytes calldata left, bytes calldata right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(bytes,bytes)\",\n \"selector\": \"0x3cf78e28\",\n \"selectorBytes\": [\n 60,\n 247,\n 142,\n 40\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_13\",\n \"description\": \"Asserts that two `bytes` values are not equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertNotEq(bytes calldata left, bytes calldata right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(bytes,bytes,string)\",\n \"selector\": \"0x9507540e\",\n \"selectorBytes\": [\n 149,\n 7,\n 84,\n 14\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_14\",\n \"description\": \"Asserts that two arrays of `bool` values are not equal.\",\n \"declaration\": \"function assertNotEq(bool[] calldata left, bool[] calldata right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(bool[],bool[])\",\n \"selector\": \"0x286fafea\",\n \"selectorBytes\": [\n 40,\n 111,\n 175,\n 234\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_15\",\n \"description\": \"Asserts that two arrays of `bool` values are not equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertNotEq(bool[] calldata left, bool[] calldata right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(bool[],bool[],string)\",\n \"selector\": \"0x62c6f9fb\",\n \"selectorBytes\": [\n 98,\n 198,\n 249,\n 251\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_16\",\n \"description\": \"Asserts that two arrays of `uint256` values are not equal.\",\n \"declaration\": \"function assertNotEq(uint256[] calldata left, uint256[] calldata right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(uint256[],uint256[])\",\n \"selector\": \"0x56f29cba\",\n \"selectorBytes\": [\n 86,\n 242,\n 156,\n 186\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_17\",\n \"description\": \"Asserts that two arrays of `uint256` values are not equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertNotEq(uint256[] calldata left, uint256[] calldata right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(uint256[],uint256[],string)\",\n \"selector\": \"0x9a7fbd8f\",\n \"selectorBytes\": [\n 154,\n 127,\n 189,\n 143\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_18\",\n \"description\": \"Asserts that two arrays of `int256` values are not equal.\",\n \"declaration\": \"function assertNotEq(int256[] calldata left, int256[] calldata right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(int256[],int256[])\",\n \"selector\": \"0x0b72f4ef\",\n \"selectorBytes\": [\n 11,\n 114,\n 244,\n 239\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_19\",\n \"description\": \"Asserts that two arrays of `int256` values are not equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertNotEq(int256[] calldata left, int256[] calldata right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(int256[],int256[],string)\",\n \"selector\": \"0xd3977322\",\n \"selectorBytes\": [\n 211,\n 151,\n 115,\n 34\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_2\",\n \"description\": \"Asserts that two `uint256` values are not equal.\",\n \"declaration\": \"function assertNotEq(uint256 left, uint256 right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(uint256,uint256)\",\n \"selector\": \"0xb7909320\",\n \"selectorBytes\": [\n 183,\n 144,\n 147,\n 32\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_20\",\n \"description\": \"Asserts that two arrays of `address` values are not equal.\",\n \"declaration\": \"function assertNotEq(address[] calldata left, address[] calldata right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(address[],address[])\",\n \"selector\": \"0x46d0b252\",\n \"selectorBytes\": [\n 70,\n 208,\n 178,\n 82\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_21\",\n \"description\": \"Asserts that two arrays of `address` values are not equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertNotEq(address[] calldata left, address[] calldata right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(address[],address[],string)\",\n \"selector\": \"0x72c7e0b5\",\n \"selectorBytes\": [\n 114,\n 199,\n 224,\n 181\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_22\",\n \"description\": \"Asserts that two arrays of `bytes32` values are not equal.\",\n \"declaration\": \"function assertNotEq(bytes32[] calldata left, bytes32[] calldata right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(bytes32[],bytes32[])\",\n \"selector\": \"0x0603ea68\",\n \"selectorBytes\": [\n 6,\n 3,\n 234,\n 104\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_23\",\n \"description\": \"Asserts that two arrays of `bytes32` values are not equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertNotEq(bytes32[] calldata left, bytes32[] calldata right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(bytes32[],bytes32[],string)\",\n \"selector\": \"0xb873634c\",\n \"selectorBytes\": [\n 184,\n 115,\n 99,\n 76\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_24\",\n \"description\": \"Asserts that two arrays of `string` values are not equal.\",\n \"declaration\": \"function assertNotEq(string[] calldata left, string[] calldata right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(string[],string[])\",\n \"selector\": \"0xbdfacbe8\",\n \"selectorBytes\": [\n 189,\n 250,\n 203,\n 232\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_25\",\n \"description\": \"Asserts that two arrays of `string` values are not equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertNotEq(string[] calldata left, string[] calldata right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(string[],string[],string)\",\n \"selector\": \"0xb67187f3\",\n \"selectorBytes\": [\n 182,\n 113,\n 135,\n 243\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_26\",\n \"description\": \"Asserts that two arrays of `bytes` values are not equal.\",\n \"declaration\": \"function assertNotEq(bytes[] calldata left, bytes[] calldata right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(bytes[],bytes[])\",\n \"selector\": \"0xedecd035\",\n \"selectorBytes\": [\n 237,\n 236,\n 208,\n 53\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_27\",\n \"description\": \"Asserts that two arrays of `bytes` values are not equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertNotEq(bytes[] calldata left, bytes[] calldata right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(bytes[],bytes[],string)\",\n \"selector\": \"0x1dcd1f68\",\n \"selectorBytes\": [\n 29,\n 205,\n 31,\n 104\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_3\",\n \"description\": \"Asserts that two `uint256` values are not equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertNotEq(uint256 left, uint256 right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(uint256,uint256,string)\",\n \"selector\": \"0x98f9bdbd\",\n \"selectorBytes\": [\n 152,\n 249,\n 189,\n 189\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_4\",\n \"description\": \"Asserts that two `int256` values are not equal.\",\n \"declaration\": \"function assertNotEq(int256 left, int256 right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(int256,int256)\",\n \"selector\": \"0xf4c004e3\",\n \"selectorBytes\": [\n 244,\n 192,\n 4,\n 227\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_5\",\n \"description\": \"Asserts that two `int256` values are not equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertNotEq(int256 left, int256 right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(int256,int256,string)\",\n \"selector\": \"0x4724c5b9\",\n \"selectorBytes\": [\n 71,\n 36,\n 197,\n 185\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_6\",\n \"description\": \"Asserts that two `address` values are not equal.\",\n \"declaration\": \"function assertNotEq(address left, address right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(address,address)\",\n \"selector\": \"0xb12e1694\",\n \"selectorBytes\": [\n 177,\n 46,\n 22,\n 148\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_7\",\n \"description\": \"Asserts that two `address` values are not equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertNotEq(address left, address right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(address,address,string)\",\n \"selector\": \"0x8775a591\",\n \"selectorBytes\": [\n 135,\n 117,\n 165,\n 145\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_8\",\n \"description\": \"Asserts that two `bytes32` values are not equal.\",\n \"declaration\": \"function assertNotEq(bytes32 left, bytes32 right) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(bytes32,bytes32)\",\n \"selector\": \"0x898e83fc\",\n \"selectorBytes\": [\n 137,\n 142,\n 131,\n 252\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertNotEq_9\",\n \"description\": \"Asserts that two `bytes32` values are not equal and includes error message into revert string on failure.\",\n \"declaration\": \"function assertNotEq(bytes32 left, bytes32 right, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertNotEq(bytes32,bytes32,string)\",\n \"selector\": \"0xb2332f51\",\n \"selectorBytes\": [\n 178,\n 51,\n 47,\n 81\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertTrue_0\",\n \"description\": \"Asserts that the given condition is true.\",\n \"declaration\": \"function assertTrue(bool condition) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertTrue(bool)\",\n \"selector\": \"0x0c9fd581\",\n \"selectorBytes\": [\n 12,\n 159,\n 213,\n 129\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assertTrue_1\",\n \"description\": \"Asserts that the given condition is true and includes error message into revert string on failure.\",\n \"declaration\": \"function assertTrue(bool condition, string calldata error) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assertTrue(bool,string)\",\n \"selector\": \"0xa34edc03\",\n \"selectorBytes\": [\n 163,\n 78,\n 220,\n 3\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assume\",\n \"description\": \"If the condition is false, discard this run's fuzz inputs and generate new ones.\",\n \"declaration\": \"function assume(bool condition) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assume(bool)\",\n \"selector\": \"0x4c63e562\",\n \"selectorBytes\": [\n 76,\n 99,\n 229,\n 98\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assumeNoRevert_0\",\n \"description\": \"Discard this run's fuzz inputs and generate new ones if next call reverted.\",\n \"declaration\": \"function assumeNoRevert() external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assumeNoRevert()\",\n \"selector\": \"0x285b366a\",\n \"selectorBytes\": [\n 40,\n 91,\n 54,\n 106\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assumeNoRevert_1\",\n \"description\": \"Discard this run's fuzz inputs and generate new ones if next call reverts with the potential revert parameters.\",\n \"declaration\": \"function assumeNoRevert(PotentialRevert calldata potentialRevert) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assumeNoRevert((address,bool,bytes))\",\n \"selector\": \"0xd8591eeb\",\n \"selectorBytes\": [\n 216,\n 89,\n 30,\n 235\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"assumeNoRevert_2\",\n \"description\": \"Discard this run's fuzz inputs and generate new ones if next call reverts with the any of the potential revert parameters.\",\n \"declaration\": \"function assumeNoRevert(PotentialRevert[] calldata potentialReverts) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"assumeNoRevert((address,bool,bytes)[])\",\n \"selector\": \"0x8a4592cc\",\n \"selectorBytes\": [\n 138,\n 69,\n 146,\n 204\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"attachBlob\",\n \"description\": \"Attach an EIP-4844 blob to the next call\",\n \"declaration\": \"function attachBlob(bytes calldata blob) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"attachBlob(bytes)\",\n \"selector\": \"0x10cb385c\",\n \"selectorBytes\": [\n 16,\n 203,\n 56,\n 92\n ]\n },\n \"group\": \"scripting\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"attachDelegation_0\",\n \"description\": \"Designate the next call as an EIP-7702 transaction\",\n \"declaration\": \"function attachDelegation(SignedDelegation calldata signedDelegation) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"attachDelegation((uint8,bytes32,bytes32,uint64,address))\",\n \"selector\": \"0x14ae3519\",\n \"selectorBytes\": [\n 20,\n 174,\n 53,\n 25\n ]\n },\n \"group\": \"scripting\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"attachDelegation_1\",\n \"description\": \"Designate the next call as an EIP-7702 transaction, with optional cross-chain validity.\",\n \"declaration\": \"function attachDelegation(SignedDelegation calldata signedDelegation, bool crossChain) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"attachDelegation((uint8,bytes32,bytes32,uint64,address),bool)\",\n \"selector\": \"0xf4460d34\",\n \"selectorBytes\": [\n 244,\n 70,\n 13,\n 52\n ]\n },\n \"group\": \"scripting\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"blobBaseFee\",\n \"description\": \"Sets `block.blobbasefee`\",\n \"declaration\": \"function blobBaseFee(uint256 newBlobBaseFee) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"blobBaseFee(uint256)\",\n \"selector\": \"0x6d315d7e\",\n \"selectorBytes\": [\n 109,\n 49,\n 93,\n 126\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"blobhashes\",\n \"description\": \"Sets the blobhashes in the transaction.\\nNot available on EVM versions before Cancun.\\nIf used on unsupported EVM versions it will revert.\",\n \"declaration\": \"function blobhashes(bytes32[] calldata hashes) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"blobhashes(bytes32[])\",\n \"selector\": \"0x129de7eb\",\n \"selectorBytes\": [\n 18,\n 157,\n 231,\n 235\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"bound_0\",\n \"description\": \"Returns an uint256 value bounded in given range and different from the current one.\",\n \"declaration\": \"function bound(uint256 current, uint256 min, uint256 max) external view returns (uint256);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"bound(uint256,uint256,uint256)\",\n \"selector\": \"0x5a6c1eed\",\n \"selectorBytes\": [\n 90,\n 108,\n 30,\n 237\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"bound_1\",\n \"description\": \"Returns an int256 value bounded in given range and different from the current one.\",\n \"declaration\": \"function bound(int256 current, int256 min, int256 max) external view returns (int256);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"bound(int256,int256,int256)\",\n \"selector\": \"0x8f48fc07\",\n \"selectorBytes\": [\n 143,\n 72,\n 252,\n 7\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"breakpoint_0\",\n \"description\": \"Writes a breakpoint to jump to in the debugger.\",\n \"declaration\": \"function breakpoint(string calldata char) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"breakpoint(string)\",\n \"selector\": \"0xf0259e92\",\n \"selectorBytes\": [\n 240,\n 37,\n 158,\n 146\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"breakpoint_1\",\n \"description\": \"Writes a conditional breakpoint to jump to in the debugger.\",\n \"declaration\": \"function breakpoint(string calldata char, bool value) external pure;\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"breakpoint(string,bool)\",\n \"selector\": \"0xf7d39a8d\",\n \"selectorBytes\": [\n 247,\n 211,\n 154,\n 141\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"broadcastRawTransaction\",\n \"description\": \"Takes a signed transaction and broadcasts it to the network.\",\n \"declaration\": \"function broadcastRawTransaction(bytes calldata data) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"broadcastRawTransaction(bytes)\",\n \"selector\": \"0x8c0c72e0\",\n \"selectorBytes\": [\n 140,\n 12,\n 114,\n 224\n ]\n },\n \"group\": \"scripting\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"broadcast_0\",\n \"description\": \"Has the next call (at this call depth only) create transactions that can later be signed and sent onchain.\\nBroadcasting address is determined by checking the following in order:\\n1. If `--sender` argument was provided, that address is used.\\n2. If exactly one signer (e.g. private key, hw wallet, keystore) is set when `forge broadcast` is invoked, that signer is used.\\n3. Otherwise, default foundry sender (1804c8AB1F12E6bbf3894d4083f33e07309d1f38) is used.\",\n \"declaration\": \"function broadcast() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"broadcast()\",\n \"selector\": \"0xafc98040\",\n \"selectorBytes\": [\n 175,\n 201,\n 128,\n 64\n ]\n },\n \"group\": \"scripting\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"broadcast_1\",\n \"description\": \"Has the next call (at this call depth only) create a transaction with the address provided\\nas the sender that can later be signed and sent onchain.\",\n \"declaration\": \"function broadcast(address signer) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"broadcast(address)\",\n \"selector\": \"0xe6962cdb\",\n \"selectorBytes\": [\n 230,\n 150,\n 44,\n 219\n ]\n },\n \"group\": \"scripting\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"broadcast_2\",\n \"description\": \"Has the next call (at this call depth only) create a transaction with the private key\\nprovided as the sender that can later be signed and sent onchain.\",\n \"declaration\": \"function broadcast(uint256 privateKey) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"broadcast(uint256)\",\n \"selector\": \"0xf67a965b\",\n \"selectorBytes\": [\n 246,\n 122,\n 150,\n 91\n ]\n },\n \"group\": \"scripting\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"chainId\",\n \"description\": \"Sets `block.chainid`.\",\n \"declaration\": \"function chainId(uint256 newChainId) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"chainId(uint256)\",\n \"selector\": \"0x4049ddd2\",\n \"selectorBytes\": [\n 64,\n 73,\n 221,\n 210\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"clearMockedCalls\",\n \"description\": \"Clears all mocked calls.\",\n \"declaration\": \"function clearMockedCalls() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"clearMockedCalls()\",\n \"selector\": \"0x3fdf4e15\",\n \"selectorBytes\": [\n 63,\n 223,\n 78,\n 21\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"cloneAccount\",\n \"description\": \"Clones a source account code, state, balance and nonce to a target account and updates in-memory EVM state.\",\n \"declaration\": \"function cloneAccount(address source, address target) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"cloneAccount(address,address)\",\n \"selector\": \"0x533d61c9\",\n \"selectorBytes\": [\n 83,\n 61,\n 97,\n 201\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"closeFile\",\n \"description\": \"Closes file for reading, resetting the offset and allowing to read it from beginning with readLine.\\n`path` is relative to the project root.\",\n \"declaration\": \"function closeFile(string calldata path) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"closeFile(string)\",\n \"selector\": \"0x48c3241f\",\n \"selectorBytes\": [\n 72,\n 195,\n 36,\n 31\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"coinbase\",\n \"description\": \"Sets `block.coinbase`.\",\n \"declaration\": \"function coinbase(address newCoinbase) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"coinbase(address)\",\n \"selector\": \"0xff483c54\",\n \"selectorBytes\": [\n 255,\n 72,\n 60,\n 84\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"computeCreate2Address_0\",\n \"description\": \"Compute the address of a contract created with CREATE2 using the given CREATE2 deployer.\",\n \"declaration\": \"function computeCreate2Address(bytes32 salt, bytes32 initCodeHash, address deployer) external pure returns (address);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"computeCreate2Address(bytes32,bytes32,address)\",\n \"selector\": \"0xd323826a\",\n \"selectorBytes\": [\n 211,\n 35,\n 130,\n 106\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"computeCreate2Address_1\",\n \"description\": \"Compute the address of a contract created with CREATE2 using the default CREATE2 deployer.\",\n \"declaration\": \"function computeCreate2Address(bytes32 salt, bytes32 initCodeHash) external pure returns (address);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"computeCreate2Address(bytes32,bytes32)\",\n \"selector\": \"0x890c283b\",\n \"selectorBytes\": [\n 137,\n 12,\n 40,\n 59\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"computeCreateAddress\",\n \"description\": \"Compute the address a contract will be deployed at for a given deployer address and nonce.\",\n \"declaration\": \"function computeCreateAddress(address deployer, uint256 nonce) external pure returns (address);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"computeCreateAddress(address,uint256)\",\n \"selector\": \"0x74637a7a\",\n \"selectorBytes\": [\n 116,\n 99,\n 122,\n 122\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"contains\",\n \"description\": \"Returns true if `search` is found in `subject`, false otherwise.\",\n \"declaration\": \"function contains(string calldata subject, string calldata search) external pure returns (bool result);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"contains(string,string)\",\n \"selector\": \"0x3fb18aec\",\n \"selectorBytes\": [\n 63,\n 177,\n 138,\n 236\n ]\n },\n \"group\": \"string\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"cool\",\n \"description\": \"Marks the slots of an account and the account address as cold.\",\n \"declaration\": \"function cool(address target) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"cool(address)\",\n \"selector\": \"0x40ff9f21\",\n \"selectorBytes\": [\n 64,\n 255,\n 159,\n 33\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"coolSlot\",\n \"description\": \"Utility cheatcode to mark specific storage slot as cold, simulating no prior read.\",\n \"declaration\": \"function coolSlot(address target, bytes32 slot) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"coolSlot(address,bytes32)\",\n \"selector\": \"0x8c78e654\",\n \"selectorBytes\": [\n 140,\n 120,\n 230,\n 84\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"copyFile\",\n \"description\": \"Copies the contents of one file to another. This function will **overwrite** the contents of `to`.\\nOn success, the total number of bytes copied is returned and it is equal to the length of the `to` file as reported by `metadata`.\\nBoth `from` and `to` are relative to the project root.\",\n \"declaration\": \"function copyFile(string calldata from, string calldata to) external returns (uint64 copied);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"copyFile(string,string)\",\n \"selector\": \"0xa54a87d8\",\n \"selectorBytes\": [\n 165,\n 74,\n 135,\n 216\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"copyStorage\",\n \"description\": \"Utility cheatcode to copy storage of `from` contract to another `to` contract.\",\n \"declaration\": \"function copyStorage(address from, address to) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"copyStorage(address,address)\",\n \"selector\": \"0x203dac0d\",\n \"selectorBytes\": [\n 32,\n 61,\n 172,\n 13\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"createDir\",\n \"description\": \"Creates a new, empty directory at the provided path.\\nThis cheatcode will revert in the following situations, but is not limited to just these cases:\\n- User lacks permissions to modify `path`.\\n- A parent of the given path doesn't exist and `recursive` is false.\\n- `path` already exists and `recursive` is false.\\n`path` is relative to the project root.\",\n \"declaration\": \"function createDir(string calldata path, bool recursive) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"createDir(string,bool)\",\n \"selector\": \"0x168b64d3\",\n \"selectorBytes\": [\n 22,\n 139,\n 100,\n 211\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"createEd25519Key\",\n \"description\": \"Generates an Ed25519 key pair from a deterministic salt.\\nReturns (publicKey, privateKey) as 32-byte values.\",\n \"declaration\": \"function createEd25519Key(bytes32 salt) external pure returns (bytes32 publicKey, bytes32 privateKey);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"createEd25519Key(bytes32)\",\n \"selector\": \"0x1ef3f27a\",\n \"selectorBytes\": [\n 30,\n 243,\n 242,\n 122\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"createFork_0\",\n \"description\": \"Creates a new fork with the given endpoint and the _latest_ block and returns the identifier of the fork.\",\n \"declaration\": \"function createFork(string calldata urlOrAlias) external returns (uint256 forkId);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"createFork(string)\",\n \"selector\": \"0x31ba3498\",\n \"selectorBytes\": [\n 49,\n 186,\n 52,\n 152\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"createFork_1\",\n \"description\": \"Creates a new fork with the given endpoint and block and returns the identifier of the fork.\",\n \"declaration\": \"function createFork(string calldata urlOrAlias, uint256 blockNumber) external returns (uint256 forkId);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"createFork(string,uint256)\",\n \"selector\": \"0x6ba3ba2b\",\n \"selectorBytes\": [\n 107,\n 163,\n 186,\n 43\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"createFork_2\",\n \"description\": \"Creates a new fork with the given endpoint and at the block the given transaction was mined in,\\nreplays all transaction mined in the block before the transaction, and returns the identifier of the fork.\",\n \"declaration\": \"function createFork(string calldata urlOrAlias, bytes32 txHash) external returns (uint256 forkId);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"createFork(string,bytes32)\",\n \"selector\": \"0x7ca29682\",\n \"selectorBytes\": [\n 124,\n 162,\n 150,\n 130\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"createSelectFork_0\",\n \"description\": \"Creates and also selects a new fork with the given endpoint and the latest block and returns the identifier of the fork.\",\n \"declaration\": \"function createSelectFork(string calldata urlOrAlias) external returns (uint256 forkId);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"createSelectFork(string)\",\n \"selector\": \"0x98680034\",\n \"selectorBytes\": [\n 152,\n 104,\n 0,\n 52\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"createSelectFork_1\",\n \"description\": \"Creates and also selects a new fork with the given endpoint and block and returns the identifier of the fork.\",\n \"declaration\": \"function createSelectFork(string calldata urlOrAlias, uint256 blockNumber) external returns (uint256 forkId);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"createSelectFork(string,uint256)\",\n \"selector\": \"0x71ee464d\",\n \"selectorBytes\": [\n 113,\n 238,\n 70,\n 77\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"createSelectFork_2\",\n \"description\": \"Creates and also selects new fork with the given endpoint and at the block the given transaction was mined in,\\nreplays all transaction mined in the block before the transaction, returns the identifier of the fork.\",\n \"declaration\": \"function createSelectFork(string calldata urlOrAlias, bytes32 txHash) external returns (uint256 forkId);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"createSelectFork(string,bytes32)\",\n \"selector\": \"0x84d52b7a\",\n \"selectorBytes\": [\n 132,\n 213,\n 43,\n 122\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"createWallet_0\",\n \"description\": \"Derives a private key from the name, labels the account with that name, and returns the wallet.\",\n \"declaration\": \"function createWallet(string calldata walletLabel) external returns (Wallet memory wallet);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"createWallet(string)\",\n \"selector\": \"0x7404f1d2\",\n \"selectorBytes\": [\n 116,\n 4,\n 241,\n 210\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"createWallet_1\",\n \"description\": \"Generates a wallet from the private key and returns the wallet.\",\n \"declaration\": \"function createWallet(uint256 privateKey) external returns (Wallet memory wallet);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"createWallet(uint256)\",\n \"selector\": \"0x7a675bb6\",\n \"selectorBytes\": [\n 122,\n 103,\n 91,\n 182\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"createWallet_2\",\n \"description\": \"Generates a wallet from the private key, labels the account with that name, and returns the wallet.\",\n \"declaration\": \"function createWallet(uint256 privateKey, string calldata walletLabel) external returns (Wallet memory wallet);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"createWallet(uint256,string)\",\n \"selector\": \"0xed7c5462\",\n \"selectorBytes\": [\n 237,\n 124,\n 84,\n 98\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"currentFilePath\",\n \"description\": \"Get the source file path of the currently running test or script contract,\\nrelative to the project root.\",\n \"declaration\": \"function currentFilePath() external view returns (string memory path);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"currentFilePath()\",\n \"selector\": \"0x9b45555c\",\n \"selectorBytes\": [\n 155,\n 69,\n 85,\n 92\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"deal\",\n \"description\": \"Sets an address' balance.\",\n \"declaration\": \"function deal(address account, uint256 newBalance) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"deal(address,uint256)\",\n \"selector\": \"0xc88a5e6d\",\n \"selectorBytes\": [\n 200,\n 138,\n 94,\n 109\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"deleteSnapshot\",\n \"description\": \"`deleteSnapshot` is being deprecated in favor of `deleteStateSnapshot`. It will be removed in future versions.\",\n \"declaration\": \"function deleteSnapshot(uint256 snapshotId) external returns (bool success);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"deleteSnapshot(uint256)\",\n \"selector\": \"0xa6368557\",\n \"selectorBytes\": [\n 166,\n 54,\n 133,\n 87\n ]\n },\n \"group\": \"evm\",\n \"status\": {\n \"deprecated\": \"replaced by `deleteStateSnapshot`\"\n },\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"deleteSnapshots\",\n \"description\": \"`deleteSnapshots` is being deprecated in favor of `deleteStateSnapshots`. It will be removed in future versions.\",\n \"declaration\": \"function deleteSnapshots() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"deleteSnapshots()\",\n \"selector\": \"0x421ae469\",\n \"selectorBytes\": [\n 66,\n 26,\n 228,\n 105\n ]\n },\n \"group\": \"evm\",\n \"status\": {\n \"deprecated\": \"replaced by `deleteStateSnapshots`\"\n },\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"deleteStateSnapshot\",\n \"description\": \"Removes the snapshot with the given ID created by `snapshot`.\\nTakes the snapshot ID to delete.\\nReturns `true` if the snapshot was successfully deleted.\\nReturns `false` if the snapshot does not exist.\",\n \"declaration\": \"function deleteStateSnapshot(uint256 snapshotId) external returns (bool success);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"deleteStateSnapshot(uint256)\",\n \"selector\": \"0x08d6b37a\",\n \"selectorBytes\": [\n 8,\n 214,\n 179,\n 122\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"deleteStateSnapshots\",\n \"description\": \"Removes _all_ snapshots previously created by `snapshot`.\",\n \"declaration\": \"function deleteStateSnapshots() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"deleteStateSnapshots()\",\n \"selector\": \"0xe0933c74\",\n \"selectorBytes\": [\n 224,\n 147,\n 60,\n 116\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"deployCode_0\",\n \"description\": \"Deploys a contract from an artifact file. Takes in the relative path to the json file or the path to the\\nartifact in the form of :: where and parts are optional.\\nReverts if the target artifact contains unlinked library placeholders.\",\n \"declaration\": \"function deployCode(string calldata artifactPath) external returns (address deployedAddress);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"deployCode(string)\",\n \"selector\": \"0x9a8325a0\",\n \"selectorBytes\": [\n 154,\n 131,\n 37,\n 160\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"deployCode_1\",\n \"description\": \"Deploys a contract from an artifact file. Takes in the relative path to the json file or the path to the\\nartifact in the form of :: where and parts are optional.\\nReverts if the target artifact contains unlinked library placeholders.\\nAdditionally accepts abi-encoded constructor arguments.\",\n \"declaration\": \"function deployCode(string calldata artifactPath, bytes calldata constructorArgs) external returns (address deployedAddress);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"deployCode(string,bytes)\",\n \"selector\": \"0x29ce9dde\",\n \"selectorBytes\": [\n 41,\n 206,\n 157,\n 222\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"deployCode_2\",\n \"description\": \"Deploys a contract from an artifact file. Takes in the relative path to the json file or the path to the\\nartifact in the form of :: where and parts are optional.\\nReverts if the target artifact contains unlinked library placeholders.\\nAdditionally accepts `msg.value`.\",\n \"declaration\": \"function deployCode(string calldata artifactPath, uint256 value) external returns (address deployedAddress);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"deployCode(string,uint256)\",\n \"selector\": \"0x0af6a701\",\n \"selectorBytes\": [\n 10,\n 246,\n 167,\n 1\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"deployCode_3\",\n \"description\": \"Deploys a contract from an artifact file. Takes in the relative path to the json file or the path to the\\nartifact in the form of :: where and parts are optional.\\nReverts if the target artifact contains unlinked library placeholders.\\nAdditionally accepts abi-encoded constructor arguments and `msg.value`.\",\n \"declaration\": \"function deployCode(string calldata artifactPath, bytes calldata constructorArgs, uint256 value) external returns (address deployedAddress);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"deployCode(string,bytes,uint256)\",\n \"selector\": \"0xff5d64e4\",\n \"selectorBytes\": [\n 255,\n 93,\n 100,\n 228\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"deployCode_4\",\n \"description\": \"Deploys a contract from an artifact file, using the CREATE2 salt. Takes in the relative path to the json file or the path to the\\nartifact in the form of :: where and parts are optional.\\nReverts if the target artifact contains unlinked library placeholders.\",\n \"declaration\": \"function deployCode(string calldata artifactPath, bytes32 salt) external returns (address deployedAddress);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"deployCode(string,bytes32)\",\n \"selector\": \"0x17ab1d79\",\n \"selectorBytes\": [\n 23,\n 171,\n 29,\n 121\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"deployCode_5\",\n \"description\": \"Deploys a contract from an artifact file, using the CREATE2 salt. Takes in the relative path to the json file or the path to the\\nartifact in the form of :: where and parts are optional.\\nReverts if the target artifact contains unlinked library placeholders.\\nAdditionally accepts abi-encoded constructor arguments.\",\n \"declaration\": \"function deployCode(string calldata artifactPath, bytes calldata constructorArgs, bytes32 salt) external returns (address deployedAddress);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"deployCode(string,bytes,bytes32)\",\n \"selector\": \"0x016155bf\",\n \"selectorBytes\": [\n 1,\n 97,\n 85,\n 191\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"deployCode_6\",\n \"description\": \"Deploys a contract from an artifact file, using the CREATE2 salt. Takes in the relative path to the json file or the path to the\\nartifact in the form of :: where and parts are optional.\\nReverts if the target artifact contains unlinked library placeholders.\\nAdditionally accepts `msg.value`.\",\n \"declaration\": \"function deployCode(string calldata artifactPath, uint256 value, bytes32 salt) external returns (address deployedAddress);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"deployCode(string,uint256,bytes32)\",\n \"selector\": \"0x002cb687\",\n \"selectorBytes\": [\n 0,\n 44,\n 182,\n 135\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"deployCode_7\",\n \"description\": \"Deploys a contract from an artifact file, using the CREATE2 salt. Takes in the relative path to the json file or the path to the\\nartifact in the form of :: where and parts are optional.\\nReverts if the target artifact contains unlinked library placeholders.\\nAdditionally accepts abi-encoded constructor arguments and `msg.value`.\",\n \"declaration\": \"function deployCode(string calldata artifactPath, bytes calldata constructorArgs, uint256 value, bytes32 salt) external returns (address deployedAddress);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"deployCode(string,bytes,uint256,bytes32)\",\n \"selector\": \"0x3aa773ea\",\n \"selectorBytes\": [\n 58,\n 167,\n 115,\n 234\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"deriveKey_0\",\n \"description\": \"Derive a private key from a provided mnemonic string (or mnemonic file path)\\nat the derivation path `m/44'/60'/0'/0/{index}`.\",\n \"declaration\": \"function deriveKey(string calldata mnemonic, uint32 index) external pure returns (uint256 privateKey);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"deriveKey(string,uint32)\",\n \"selector\": \"0x6229498b\",\n \"selectorBytes\": [\n 98,\n 41,\n 73,\n 139\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"deriveKey_1\",\n \"description\": \"Derive a private key from a provided mnemonic string (or mnemonic file path)\\nat `{derivationPath}{index}`.\",\n \"declaration\": \"function deriveKey(string calldata mnemonic, string calldata derivationPath, uint32 index) external pure returns (uint256 privateKey);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"deriveKey(string,string,uint32)\",\n \"selector\": \"0x6bcb2c1b\",\n \"selectorBytes\": [\n 107,\n 203,\n 44,\n 27\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"deriveKey_2\",\n \"description\": \"Derive a private key from a provided mnemonic string (or mnemonic file path) in the specified language\\nat the derivation path `m/44'/60'/0'/0/{index}`.\",\n \"declaration\": \"function deriveKey(string calldata mnemonic, uint32 index, string calldata language) external pure returns (uint256 privateKey);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"deriveKey(string,uint32,string)\",\n \"selector\": \"0x32c8176d\",\n \"selectorBytes\": [\n 50,\n 200,\n 23,\n 109\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"deriveKey_3\",\n \"description\": \"Derive a private key from a provided mnemonic string (or mnemonic file path) in the specified language\\nat `{derivationPath}{index}`.\",\n \"declaration\": \"function deriveKey(string calldata mnemonic, string calldata derivationPath, uint32 index, string calldata language) external pure returns (uint256 privateKey);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"deriveKey(string,string,uint32,string)\",\n \"selector\": \"0x29233b1f\",\n \"selectorBytes\": [\n 41,\n 35,\n 59,\n 31\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"difficulty\",\n \"description\": \"Sets `block.difficulty`.\\nNot available on EVM versions from Paris onwards. Use `prevrandao` instead.\\nReverts if used on unsupported EVM versions.\",\n \"declaration\": \"function difficulty(uint256 newDifficulty) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"difficulty(uint256)\",\n \"selector\": \"0x46cc92d9\",\n \"selectorBytes\": [\n 70,\n 204,\n 146,\n 217\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"dumpState\",\n \"description\": \"Dump a genesis JSON file's `allocs` to disk.\",\n \"declaration\": \"function dumpState(string calldata pathToStateJson) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"dumpState(string)\",\n \"selector\": \"0x709ecd3f\",\n \"selectorBytes\": [\n 112,\n 158,\n 205,\n 63\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"eip712HashStruct_0\",\n \"description\": \"Generates the struct hash of the canonical EIP-712 type representation and its abi-encoded data.\\nSupports 2 different inputs:\\n 1. Name of the type (i.e. \\\"PermitSingle\\\"):\\n * requires previous binding generation with `forge bind-json`.\\n * bindings will be retrieved from the path configured in `foundry.toml`.\\n 2. String representation of the type (i.e. \\\"Foo(Bar bar) Bar(uint256 baz)\\\").\\n * Note: the cheatcode will use the canonical type even if the input is malformated\\n with the wrong order of elements or with extra whitespaces.\",\n \"declaration\": \"function eip712HashStruct(string calldata typeNameOrDefinition, bytes calldata abiEncodedData) external pure returns (bytes32 typeHash);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"eip712HashStruct(string,bytes)\",\n \"selector\": \"0xaedeaebc\",\n \"selectorBytes\": [\n 174,\n 222,\n 174,\n 188\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"eip712HashStruct_1\",\n \"description\": \"Generates the struct hash of the canonical EIP-712 type representation and its abi-encoded data.\\nRequires previous binding generation with `forge bind-json`.\\nParams:\\n * `bindingsPath`: path where the output of `forge bind-json` is stored.\\n * `typeName`: Name of the type (i.e. \\\"PermitSingle\\\").\\n * `abiEncodedData`: ABI-encoded data for the struct that is being hashed.\",\n \"declaration\": \"function eip712HashStruct(string calldata bindingsPath, string calldata typeName, bytes calldata abiEncodedData) external pure returns (bytes32 typeHash);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"eip712HashStruct(string,string,bytes)\",\n \"selector\": \"0x6d06c57c\",\n \"selectorBytes\": [\n 109,\n 6,\n 197,\n 124\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"eip712HashType_0\",\n \"description\": \"Generates the hash of the canonical EIP-712 type representation.\\nSupports 2 different inputs:\\n 1. Name of the type (i.e. \\\"Transaction\\\"):\\n * requires previous binding generation with `forge bind-json`.\\n * bindings will be retrieved from the path configured in `foundry.toml`.\\n 2. String representation of the type (i.e. \\\"Foo(Bar bar) Bar(uint256 baz)\\\").\\n * Note: the cheatcode will output the canonical type even if the input is malformated\\n with the wrong order of elements or with extra whitespaces.\",\n \"declaration\": \"function eip712HashType(string calldata typeNameOrDefinition) external pure returns (bytes32 typeHash);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"eip712HashType(string)\",\n \"selector\": \"0x6792e9e2\",\n \"selectorBytes\": [\n 103,\n 146,\n 233,\n 226\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"eip712HashType_1\",\n \"description\": \"Generates the hash of the canonical EIP-712 type representation.\\nRequires previous binding generation with `forge bind-json`.\\nParams:\\n * `bindingsPath`: path where the output of `forge bind-json` is stored.\\n * `typeName`: Name of the type (i.e. \\\"Transaction\\\").\",\n \"declaration\": \"function eip712HashType(string calldata bindingsPath, string calldata typeName) external pure returns (bytes32 typeHash);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"eip712HashType(string,string)\",\n \"selector\": \"0x18fb6406\",\n \"selectorBytes\": [\n 24,\n 251,\n 100,\n 6\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"eip712HashTypedData\",\n \"description\": \"Generates a ready-to-sign digest of human-readable typed data following the EIP-712 standard.\",\n \"declaration\": \"function eip712HashTypedData(string calldata jsonData) external pure returns (bytes32 digest);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"eip712HashTypedData(string)\",\n \"selector\": \"0xea25e615\",\n \"selectorBytes\": [\n 234,\n 37,\n 230,\n 21\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"ensNamehash\",\n \"description\": \"Returns ENS namehash for provided string.\",\n \"declaration\": \"function ensNamehash(string calldata name) external pure returns (bytes32);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"ensNamehash(string)\",\n \"selector\": \"0x8c374c65\",\n \"selectorBytes\": [\n 140,\n 55,\n 76,\n 101\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envAddress_0\",\n \"description\": \"Gets the environment variable `name` and parses it as `address`.\\nReverts if the variable was not found or could not be parsed.\",\n \"declaration\": \"function envAddress(string calldata name) external view returns (address value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envAddress(string)\",\n \"selector\": \"0x350d56bf\",\n \"selectorBytes\": [\n 53,\n 13,\n 86,\n 191\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envAddress_1\",\n \"description\": \"Gets the environment variable `name` and parses it as an array of `address`, delimited by `delim`.\\nReverts if the variable was not found or could not be parsed.\",\n \"declaration\": \"function envAddress(string calldata name, string calldata delim) external view returns (address[] memory value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envAddress(string,string)\",\n \"selector\": \"0xad31b9fa\",\n \"selectorBytes\": [\n 173,\n 49,\n 185,\n 250\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envBool_0\",\n \"description\": \"Gets the environment variable `name` and parses it as `bool`.\\nReverts if the variable was not found or could not be parsed.\",\n \"declaration\": \"function envBool(string calldata name) external view returns (bool value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envBool(string)\",\n \"selector\": \"0x7ed1ec7d\",\n \"selectorBytes\": [\n 126,\n 209,\n 236,\n 125\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envBool_1\",\n \"description\": \"Gets the environment variable `name` and parses it as an array of `bool`, delimited by `delim`.\\nReverts if the variable was not found or could not be parsed.\",\n \"declaration\": \"function envBool(string calldata name, string calldata delim) external view returns (bool[] memory value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envBool(string,string)\",\n \"selector\": \"0xaaaddeaf\",\n \"selectorBytes\": [\n 170,\n 173,\n 222,\n 175\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envBytes32_0\",\n \"description\": \"Gets the environment variable `name` and parses it as `bytes32`.\\nReverts if the variable was not found or could not be parsed.\",\n \"declaration\": \"function envBytes32(string calldata name) external view returns (bytes32 value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envBytes32(string)\",\n \"selector\": \"0x97949042\",\n \"selectorBytes\": [\n 151,\n 148,\n 144,\n 66\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envBytes32_1\",\n \"description\": \"Gets the environment variable `name` and parses it as an array of `bytes32`, delimited by `delim`.\\nReverts if the variable was not found or could not be parsed.\",\n \"declaration\": \"function envBytes32(string calldata name, string calldata delim) external view returns (bytes32[] memory value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envBytes32(string,string)\",\n \"selector\": \"0x5af231c1\",\n \"selectorBytes\": [\n 90,\n 242,\n 49,\n 193\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envBytes_0\",\n \"description\": \"Gets the environment variable `name` and parses it as `bytes`.\\nReverts if the variable was not found or could not be parsed.\",\n \"declaration\": \"function envBytes(string calldata name) external view returns (bytes memory value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envBytes(string)\",\n \"selector\": \"0x4d7baf06\",\n \"selectorBytes\": [\n 77,\n 123,\n 175,\n 6\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envBytes_1\",\n \"description\": \"Gets the environment variable `name` and parses it as an array of `bytes`, delimited by `delim`.\\nReverts if the variable was not found or could not be parsed.\",\n \"declaration\": \"function envBytes(string calldata name, string calldata delim) external view returns (bytes[] memory value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envBytes(string,string)\",\n \"selector\": \"0xddc2651b\",\n \"selectorBytes\": [\n 221,\n 194,\n 101,\n 27\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envExists\",\n \"description\": \"Gets the environment variable `name` and returns true if it exists, else returns false.\",\n \"declaration\": \"function envExists(string calldata name) external view returns (bool result);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envExists(string)\",\n \"selector\": \"0xce8365f9\",\n \"selectorBytes\": [\n 206,\n 131,\n 101,\n 249\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envInt_0\",\n \"description\": \"Gets the environment variable `name` and parses it as `int256`.\\nReverts if the variable was not found or could not be parsed.\",\n \"declaration\": \"function envInt(string calldata name) external view returns (int256 value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envInt(string)\",\n \"selector\": \"0x892a0c61\",\n \"selectorBytes\": [\n 137,\n 42,\n 12,\n 97\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envInt_1\",\n \"description\": \"Gets the environment variable `name` and parses it as an array of `int256`, delimited by `delim`.\\nReverts if the variable was not found or could not be parsed.\",\n \"declaration\": \"function envInt(string calldata name, string calldata delim) external view returns (int256[] memory value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envInt(string,string)\",\n \"selector\": \"0x42181150\",\n \"selectorBytes\": [\n 66,\n 24,\n 17,\n 80\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envOr_0\",\n \"description\": \"Gets the environment variable `name` and parses it as `bool`.\\nReverts if the variable could not be parsed.\\nReturns `defaultValue` if the variable was not found.\",\n \"declaration\": \"function envOr(string calldata name, bool defaultValue) external view returns (bool value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envOr(string,bool)\",\n \"selector\": \"0x4777f3cf\",\n \"selectorBytes\": [\n 71,\n 119,\n 243,\n 207\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envOr_1\",\n \"description\": \"Gets the environment variable `name` and parses it as `uint256`.\\nReverts if the variable could not be parsed.\\nReturns `defaultValue` if the variable was not found.\",\n \"declaration\": \"function envOr(string calldata name, uint256 defaultValue) external view returns (uint256 value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envOr(string,uint256)\",\n \"selector\": \"0x5e97348f\",\n \"selectorBytes\": [\n 94,\n 151,\n 52,\n 143\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envOr_10\",\n \"description\": \"Gets the environment variable `name` and parses it as an array of `address`, delimited by `delim`.\\nReverts if the variable could not be parsed.\\nReturns `defaultValue` if the variable was not found.\",\n \"declaration\": \"function envOr(string calldata name, string calldata delim, address[] calldata defaultValue) external view returns (address[] memory value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envOr(string,string,address[])\",\n \"selector\": \"0xc74e9deb\",\n \"selectorBytes\": [\n 199,\n 78,\n 157,\n 235\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envOr_11\",\n \"description\": \"Gets the environment variable `name` and parses it as an array of `bytes32`, delimited by `delim`.\\nReverts if the variable could not be parsed.\\nReturns `defaultValue` if the variable was not found.\",\n \"declaration\": \"function envOr(string calldata name, string calldata delim, bytes32[] calldata defaultValue) external view returns (bytes32[] memory value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envOr(string,string,bytes32[])\",\n \"selector\": \"0x2281f367\",\n \"selectorBytes\": [\n 34,\n 129,\n 243,\n 103\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envOr_12\",\n \"description\": \"Gets the environment variable `name` and parses it as an array of `string`, delimited by `delim`.\\nReverts if the variable could not be parsed.\\nReturns `defaultValue` if the variable was not found.\",\n \"declaration\": \"function envOr(string calldata name, string calldata delim, string[] calldata defaultValue) external view returns (string[] memory value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envOr(string,string,string[])\",\n \"selector\": \"0x859216bc\",\n \"selectorBytes\": [\n 133,\n 146,\n 22,\n 188\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envOr_13\",\n \"description\": \"Gets the environment variable `name` and parses it as an array of `bytes`, delimited by `delim`.\\nReverts if the variable could not be parsed.\\nReturns `defaultValue` if the variable was not found.\",\n \"declaration\": \"function envOr(string calldata name, string calldata delim, bytes[] calldata defaultValue) external view returns (bytes[] memory value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envOr(string,string,bytes[])\",\n \"selector\": \"0x64bc3e64\",\n \"selectorBytes\": [\n 100,\n 188,\n 62,\n 100\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envOr_2\",\n \"description\": \"Gets the environment variable `name` and parses it as `int256`.\\nReverts if the variable could not be parsed.\\nReturns `defaultValue` if the variable was not found.\",\n \"declaration\": \"function envOr(string calldata name, int256 defaultValue) external view returns (int256 value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envOr(string,int256)\",\n \"selector\": \"0xbbcb713e\",\n \"selectorBytes\": [\n 187,\n 203,\n 113,\n 62\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envOr_3\",\n \"description\": \"Gets the environment variable `name` and parses it as `address`.\\nReverts if the variable could not be parsed.\\nReturns `defaultValue` if the variable was not found.\",\n \"declaration\": \"function envOr(string calldata name, address defaultValue) external view returns (address value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envOr(string,address)\",\n \"selector\": \"0x561fe540\",\n \"selectorBytes\": [\n 86,\n 31,\n 229,\n 64\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envOr_4\",\n \"description\": \"Gets the environment variable `name` and parses it as `bytes32`.\\nReverts if the variable could not be parsed.\\nReturns `defaultValue` if the variable was not found.\",\n \"declaration\": \"function envOr(string calldata name, bytes32 defaultValue) external view returns (bytes32 value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envOr(string,bytes32)\",\n \"selector\": \"0xb4a85892\",\n \"selectorBytes\": [\n 180,\n 168,\n 88,\n 146\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envOr_5\",\n \"description\": \"Gets the environment variable `name` and parses it as `string`.\\nReverts if the variable could not be parsed.\\nReturns `defaultValue` if the variable was not found.\",\n \"declaration\": \"function envOr(string calldata name, string calldata defaultValue) external view returns (string memory value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envOr(string,string)\",\n \"selector\": \"0xd145736c\",\n \"selectorBytes\": [\n 209,\n 69,\n 115,\n 108\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envOr_6\",\n \"description\": \"Gets the environment variable `name` and parses it as `bytes`.\\nReverts if the variable could not be parsed.\\nReturns `defaultValue` if the variable was not found.\",\n \"declaration\": \"function envOr(string calldata name, bytes calldata defaultValue) external view returns (bytes memory value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envOr(string,bytes)\",\n \"selector\": \"0xb3e47705\",\n \"selectorBytes\": [\n 179,\n 228,\n 119,\n 5\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envOr_7\",\n \"description\": \"Gets the environment variable `name` and parses it as an array of `bool`, delimited by `delim`.\\nReverts if the variable could not be parsed.\\nReturns `defaultValue` if the variable was not found.\",\n \"declaration\": \"function envOr(string calldata name, string calldata delim, bool[] calldata defaultValue) external view returns (bool[] memory value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envOr(string,string,bool[])\",\n \"selector\": \"0xeb85e83b\",\n \"selectorBytes\": [\n 235,\n 133,\n 232,\n 59\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envOr_8\",\n \"description\": \"Gets the environment variable `name` and parses it as an array of `uint256`, delimited by `delim`.\\nReverts if the variable could not be parsed.\\nReturns `defaultValue` if the variable was not found.\",\n \"declaration\": \"function envOr(string calldata name, string calldata delim, uint256[] calldata defaultValue) external view returns (uint256[] memory value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envOr(string,string,uint256[])\",\n \"selector\": \"0x74318528\",\n \"selectorBytes\": [\n 116,\n 49,\n 133,\n 40\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envOr_9\",\n \"description\": \"Gets the environment variable `name` and parses it as an array of `int256`, delimited by `delim`.\\nReverts if the variable could not be parsed.\\nReturns `defaultValue` if the variable was not found.\",\n \"declaration\": \"function envOr(string calldata name, string calldata delim, int256[] calldata defaultValue) external view returns (int256[] memory value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envOr(string,string,int256[])\",\n \"selector\": \"0x4700d74b\",\n \"selectorBytes\": [\n 71,\n 0,\n 215,\n 75\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envString_0\",\n \"description\": \"Gets the environment variable `name` and parses it as `string`.\\nReverts if the variable was not found or could not be parsed.\",\n \"declaration\": \"function envString(string calldata name) external view returns (string memory value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envString(string)\",\n \"selector\": \"0xf877cb19\",\n \"selectorBytes\": [\n 248,\n 119,\n 203,\n 25\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envString_1\",\n \"description\": \"Gets the environment variable `name` and parses it as an array of `string`, delimited by `delim`.\\nReverts if the variable was not found or could not be parsed.\",\n \"declaration\": \"function envString(string calldata name, string calldata delim) external view returns (string[] memory value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envString(string,string)\",\n \"selector\": \"0x14b02bc9\",\n \"selectorBytes\": [\n 20,\n 176,\n 43,\n 201\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envUint_0\",\n \"description\": \"Gets the environment variable `name` and parses it as `uint256`.\\nReverts if the variable was not found or could not be parsed.\",\n \"declaration\": \"function envUint(string calldata name) external view returns (uint256 value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envUint(string)\",\n \"selector\": \"0xc1978d1f\",\n \"selectorBytes\": [\n 193,\n 151,\n 141,\n 31\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"envUint_1\",\n \"description\": \"Gets the environment variable `name` and parses it as an array of `uint256`, delimited by `delim`.\\nReverts if the variable was not found or could not be parsed.\",\n \"declaration\": \"function envUint(string calldata name, string calldata delim) external view returns (uint256[] memory value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"envUint(string,string)\",\n \"selector\": \"0xf3dec099\",\n \"selectorBytes\": [\n 243,\n 222,\n 192,\n 153\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"etch\",\n \"description\": \"Sets an address' code.\",\n \"declaration\": \"function etch(address target, bytes calldata newRuntimeBytecode) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"etch(address,bytes)\",\n \"selector\": \"0xb4d6c782\",\n \"selectorBytes\": [\n 180,\n 214,\n 199,\n 130\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"eth_getLogs\",\n \"description\": \"Gets all the logs according to specified filter.\",\n \"declaration\": \"function eth_getLogs(uint256 fromBlock, uint256 toBlock, address target, bytes32[] calldata topics) external view returns (EthGetLogs[] memory logs);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"eth_getLogs(uint256,uint256,address,bytes32[])\",\n \"selector\": \"0x35e1349b\",\n \"selectorBytes\": [\n 53,\n 225,\n 52,\n 155\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"executeTransaction\",\n \"description\": \"Executes an RLP-encoded signed transaction with full EVM semantics (like `--isolate` mode).\\nThe transaction is decoded from EIP-2718 format (type byte prefix + RLP payload) or legacy RLP.\\nReturns the execution output bytes.\\nThis cheatcode is not allowed in `forge script` contexts.\",\n \"declaration\": \"function executeTransaction(bytes calldata rawTx) external returns (bytes memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"executeTransaction(bytes)\",\n \"selector\": \"0x943d7209\",\n \"selectorBytes\": [\n 148,\n 61,\n 114,\n 9\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"exists\",\n \"description\": \"Returns true if the given path points to an existing entity, else returns false.\",\n \"declaration\": \"function exists(string calldata path) external view returns (bool result);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"exists(string)\",\n \"selector\": \"0x261a323e\",\n \"selectorBytes\": [\n 38,\n 26,\n 50,\n 62\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"expectCallMinGas_0\",\n \"description\": \"Expect a call to an address with the specified `msg.value` and calldata, and a *minimum* amount of gas.\",\n \"declaration\": \"function expectCallMinGas(address callee, uint256 msgValue, uint64 minGas, bytes calldata data) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectCallMinGas(address,uint256,uint64,bytes)\",\n \"selector\": \"0x08e4e116\",\n \"selectorBytes\": [\n 8,\n 228,\n 225,\n 22\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectCallMinGas_1\",\n \"description\": \"Expect given number of calls to an address with the specified `msg.value` and calldata, and a *minimum* amount of gas.\",\n \"declaration\": \"function expectCallMinGas(address callee, uint256 msgValue, uint64 minGas, bytes calldata data, uint64 count) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectCallMinGas(address,uint256,uint64,bytes,uint64)\",\n \"selector\": \"0xe13a1834\",\n \"selectorBytes\": [\n 225,\n 58,\n 24,\n 52\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectCall_0\",\n \"description\": \"Expects a call to an address with the specified calldata.\\nCalldata can either be a strict or a partial match.\",\n \"declaration\": \"function expectCall(address callee, bytes calldata data) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectCall(address,bytes)\",\n \"selector\": \"0xbd6af434\",\n \"selectorBytes\": [\n 189,\n 106,\n 244,\n 52\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectCall_1\",\n \"description\": \"Expects given number of calls to an address with the specified calldata.\",\n \"declaration\": \"function expectCall(address callee, bytes calldata data, uint64 count) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectCall(address,bytes,uint64)\",\n \"selector\": \"0xc1adbbff\",\n \"selectorBytes\": [\n 193,\n 173,\n 187,\n 255\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectCall_2\",\n \"description\": \"Expects a call to an address with the specified `msg.value` and calldata.\",\n \"declaration\": \"function expectCall(address callee, uint256 msgValue, bytes calldata data) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectCall(address,uint256,bytes)\",\n \"selector\": \"0xf30c7ba3\",\n \"selectorBytes\": [\n 243,\n 12,\n 123,\n 163\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectCall_3\",\n \"description\": \"Expects given number of calls to an address with the specified `msg.value` and calldata.\",\n \"declaration\": \"function expectCall(address callee, uint256 msgValue, bytes calldata data, uint64 count) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectCall(address,uint256,bytes,uint64)\",\n \"selector\": \"0xa2b1a1ae\",\n \"selectorBytes\": [\n 162,\n 177,\n 161,\n 174\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectCall_4\",\n \"description\": \"Expect a call to an address with the specified `msg.value`, gas, and calldata.\",\n \"declaration\": \"function expectCall(address callee, uint256 msgValue, uint64 gas, bytes calldata data) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectCall(address,uint256,uint64,bytes)\",\n \"selector\": \"0x23361207\",\n \"selectorBytes\": [\n 35,\n 54,\n 18,\n 7\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectCall_5\",\n \"description\": \"Expects given number of calls to an address with the specified `msg.value`, gas, and calldata.\",\n \"declaration\": \"function expectCall(address callee, uint256 msgValue, uint64 gas, bytes calldata data, uint64 count) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectCall(address,uint256,uint64,bytes,uint64)\",\n \"selector\": \"0x65b7b7cc\",\n \"selectorBytes\": [\n 101,\n 183,\n 183,\n 204\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectCreate\",\n \"description\": \"Expects the deployment of the specified bytecode by the specified address using the CREATE opcode\",\n \"declaration\": \"function expectCreate(bytes calldata bytecode, address deployer) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectCreate(bytes,address)\",\n \"selector\": \"0x73cdce36\",\n \"selectorBytes\": [\n 115,\n 205,\n 206,\n 54\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectCreate2\",\n \"description\": \"Expects the deployment of the specified bytecode by the specified address using the CREATE2 opcode\",\n \"declaration\": \"function expectCreate2(bytes calldata bytecode, address deployer) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectCreate2(bytes,address)\",\n \"selector\": \"0xea54a472\",\n \"selectorBytes\": [\n 234,\n 84,\n 164,\n 114\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectEmitAnonymous_0\",\n \"description\": \"Prepare an expected anonymous log with (bool checkTopic1, bool checkTopic2, bool checkTopic3, bool checkData.).\\nCall this function, then emit an anonymous event, then call a function. Internally after the call, we check if\\nlogs were emitted in the expected order with the expected topics and data (as specified by the booleans).\",\n \"declaration\": \"function expectEmitAnonymous(bool checkTopic0, bool checkTopic1, bool checkTopic2, bool checkTopic3, bool checkData) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectEmitAnonymous(bool,bool,bool,bool,bool)\",\n \"selector\": \"0xc948db5e\",\n \"selectorBytes\": [\n 201,\n 72,\n 219,\n 94\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectEmitAnonymous_1\",\n \"description\": \"Same as the previous method, but also checks supplied address against emitting contract.\",\n \"declaration\": \"function expectEmitAnonymous(bool checkTopic0, bool checkTopic1, bool checkTopic2, bool checkTopic3, bool checkData, address emitter) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectEmitAnonymous(bool,bool,bool,bool,bool,address)\",\n \"selector\": \"0x71c95899\",\n \"selectorBytes\": [\n 113,\n 201,\n 88,\n 153\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectEmitAnonymous_2\",\n \"description\": \"Prepare an expected anonymous log with all topic and data checks enabled.\\nCall this function, then emit an anonymous event, then call a function. Internally after the call, we check if\\nlogs were emitted in the expected order with the expected topics and data.\",\n \"declaration\": \"function expectEmitAnonymous() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectEmitAnonymous()\",\n \"selector\": \"0x2e5f270c\",\n \"selectorBytes\": [\n 46,\n 95,\n 39,\n 12\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectEmitAnonymous_3\",\n \"description\": \"Same as the previous method, but also checks supplied address against emitting contract.\",\n \"declaration\": \"function expectEmitAnonymous(address emitter) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectEmitAnonymous(address)\",\n \"selector\": \"0x6fc68705\",\n \"selectorBytes\": [\n 111,\n 198,\n 135,\n 5\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectEmit_0\",\n \"description\": \"Prepare an expected log with (bool checkTopic1, bool checkTopic2, bool checkTopic3, bool checkData.).\\nCall this function, then emit an event, then call a function. Internally after the call, we check if\\nlogs were emitted in the expected order with the expected topics and data (as specified by the booleans).\",\n \"declaration\": \"function expectEmit(bool checkTopic1, bool checkTopic2, bool checkTopic3, bool checkData) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectEmit(bool,bool,bool,bool)\",\n \"selector\": \"0x491cc7c2\",\n \"selectorBytes\": [\n 73,\n 28,\n 199,\n 194\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectEmit_1\",\n \"description\": \"Same as the previous method, but also checks supplied address against emitting contract.\",\n \"declaration\": \"function expectEmit(bool checkTopic1, bool checkTopic2, bool checkTopic3, bool checkData, address emitter) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectEmit(bool,bool,bool,bool,address)\",\n \"selector\": \"0x81bad6f3\",\n \"selectorBytes\": [\n 129,\n 186,\n 214,\n 243\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectEmit_2\",\n \"description\": \"Prepare an expected log with all topic and data checks enabled.\\nCall this function, then emit an event, then call a function. Internally after the call, we check if\\nlogs were emitted in the expected order with the expected topics and data.\",\n \"declaration\": \"function expectEmit() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectEmit()\",\n \"selector\": \"0x440ed10d\",\n \"selectorBytes\": [\n 68,\n 14,\n 209,\n 13\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectEmit_3\",\n \"description\": \"Same as the previous method, but also checks supplied address against emitting contract.\",\n \"declaration\": \"function expectEmit(address emitter) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectEmit(address)\",\n \"selector\": \"0x86b9620d\",\n \"selectorBytes\": [\n 134,\n 185,\n 98,\n 13\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectEmit_4\",\n \"description\": \"Expect a given number of logs with the provided topics.\",\n \"declaration\": \"function expectEmit(bool checkTopic1, bool checkTopic2, bool checkTopic3, bool checkData, uint64 count) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectEmit(bool,bool,bool,bool,uint64)\",\n \"selector\": \"0x5e1d1c33\",\n \"selectorBytes\": [\n 94,\n 29,\n 28,\n 51\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectEmit_5\",\n \"description\": \"Expect a given number of logs from a specific emitter with the provided topics.\",\n \"declaration\": \"function expectEmit(bool checkTopic1, bool checkTopic2, bool checkTopic3, bool checkData, address emitter, uint64 count) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectEmit(bool,bool,bool,bool,address,uint64)\",\n \"selector\": \"0xc339d02c\",\n \"selectorBytes\": [\n 195,\n 57,\n 208,\n 44\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectEmit_6\",\n \"description\": \"Expect a given number of logs with all topic and data checks enabled.\",\n \"declaration\": \"function expectEmit(uint64 count) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectEmit(uint64)\",\n \"selector\": \"0x4c74a335\",\n \"selectorBytes\": [\n 76,\n 116,\n 163,\n 53\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectEmit_7\",\n \"description\": \"Expect a given number of logs from a specific emitter with all topic and data checks enabled.\",\n \"declaration\": \"function expectEmit(address emitter, uint64 count) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectEmit(address,uint64)\",\n \"selector\": \"0xb43aece3\",\n \"selectorBytes\": [\n 180,\n 58,\n 236,\n 227\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectPartialRevert_0\",\n \"description\": \"Expects an error on next call that starts with the revert data.\",\n \"declaration\": \"function expectPartialRevert(bytes4 revertData) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectPartialRevert(bytes4)\",\n \"selector\": \"0x11fb5b9c\",\n \"selectorBytes\": [\n 17,\n 251,\n 91,\n 156\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectPartialRevert_1\",\n \"description\": \"Expects an error on next call to reverter address, that starts with the revert data.\",\n \"declaration\": \"function expectPartialRevert(bytes4 revertData, address reverter) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectPartialRevert(bytes4,address)\",\n \"selector\": \"0x51aa008a\",\n \"selectorBytes\": [\n 81,\n 170,\n 0,\n 138\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectRevert_0\",\n \"description\": \"Expects an error on next call with any revert data.\",\n \"declaration\": \"function expectRevert() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectRevert()\",\n \"selector\": \"0xf4844814\",\n \"selectorBytes\": [\n 244,\n 132,\n 72,\n 20\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectRevert_1\",\n \"description\": \"Expects an error on next call that exactly matches the revert data.\",\n \"declaration\": \"function expectRevert(bytes4 revertData) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectRevert(bytes4)\",\n \"selector\": \"0xc31eb0e0\",\n \"selectorBytes\": [\n 195,\n 30,\n 176,\n 224\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectRevert_10\",\n \"description\": \"Expects a `count` number of reverts from the upcoming calls from the reverter address that match the revert data.\",\n \"declaration\": \"function expectRevert(bytes4 revertData, address reverter, uint64 count) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectRevert(bytes4,address,uint64)\",\n \"selector\": \"0xb0762d73\",\n \"selectorBytes\": [\n 176,\n 118,\n 45,\n 115\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectRevert_11\",\n \"description\": \"Expects a `count` number of reverts from the upcoming calls from the reverter address that exactly match the revert data.\",\n \"declaration\": \"function expectRevert(bytes calldata revertData, address reverter, uint64 count) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectRevert(bytes,address,uint64)\",\n \"selector\": \"0xd345fb1f\",\n \"selectorBytes\": [\n 211,\n 69,\n 251,\n 31\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectRevert_2\",\n \"description\": \"Expects an error on next call that exactly matches the revert data.\",\n \"declaration\": \"function expectRevert(bytes calldata revertData) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectRevert(bytes)\",\n \"selector\": \"0xf28dceb3\",\n \"selectorBytes\": [\n 242,\n 141,\n 206,\n 179\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectRevert_3\",\n \"description\": \"Expects an error with any revert data on next call to reverter address.\",\n \"declaration\": \"function expectRevert(address reverter) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectRevert(address)\",\n \"selector\": \"0xd814f38a\",\n \"selectorBytes\": [\n 216,\n 20,\n 243,\n 138\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectRevert_4\",\n \"description\": \"Expects an error from reverter address on next call, with any revert data.\",\n \"declaration\": \"function expectRevert(bytes4 revertData, address reverter) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectRevert(bytes4,address)\",\n \"selector\": \"0x260bc5de\",\n \"selectorBytes\": [\n 38,\n 11,\n 197,\n 222\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectRevert_5\",\n \"description\": \"Expects an error from reverter address on next call, that exactly matches the revert data.\",\n \"declaration\": \"function expectRevert(bytes calldata revertData, address reverter) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectRevert(bytes,address)\",\n \"selector\": \"0x61ebcf12\",\n \"selectorBytes\": [\n 97,\n 235,\n 207,\n 18\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectRevert_6\",\n \"description\": \"Expects a `count` number of reverts from the upcoming calls with any revert data or reverter.\",\n \"declaration\": \"function expectRevert(uint64 count) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectRevert(uint64)\",\n \"selector\": \"0x4ee38244\",\n \"selectorBytes\": [\n 78,\n 227,\n 130,\n 68\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectRevert_7\",\n \"description\": \"Expects a `count` number of reverts from the upcoming calls that match the revert data.\",\n \"declaration\": \"function expectRevert(bytes4 revertData, uint64 count) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectRevert(bytes4,uint64)\",\n \"selector\": \"0xe45ca72d\",\n \"selectorBytes\": [\n 228,\n 92,\n 167,\n 45\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectRevert_8\",\n \"description\": \"Expects a `count` number of reverts from the upcoming calls that exactly match the revert data.\",\n \"declaration\": \"function expectRevert(bytes calldata revertData, uint64 count) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectRevert(bytes,uint64)\",\n \"selector\": \"0x4994c273\",\n \"selectorBytes\": [\n 73,\n 148,\n 194,\n 115\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectRevert_9\",\n \"description\": \"Expects a `count` number of reverts from the upcoming calls from the reverter address.\",\n \"declaration\": \"function expectRevert(address reverter, uint64 count) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectRevert(address,uint64)\",\n \"selector\": \"0x1ff5f952\",\n \"selectorBytes\": [\n 31,\n 245,\n 249,\n 82\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectSafeMemory\",\n \"description\": \"Only allows memory writes to offsets [0x00, 0x60) āˆŖ [min, max) in the current subcontext. If any other\\nmemory is written to, the test will fail. Can be called multiple times to add more ranges to the set.\",\n \"declaration\": \"function expectSafeMemory(uint64 min, uint64 max) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectSafeMemory(uint64,uint64)\",\n \"selector\": \"0x6d016688\",\n \"selectorBytes\": [\n 109,\n 1,\n 102,\n 136\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"expectSafeMemoryCall\",\n \"description\": \"Only allows memory writes to offsets [0x00, 0x60) āˆŖ [min, max) in the next created subcontext.\\nIf any other memory is written to, the test will fail. Can be called multiple times to add more ranges\\nto the set.\",\n \"declaration\": \"function expectSafeMemoryCall(uint64 min, uint64 max) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"expectSafeMemoryCall(uint64,uint64)\",\n \"selector\": \"0x05838bf4\",\n \"selectorBytes\": [\n 5,\n 131,\n 139,\n 244\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"fee\",\n \"description\": \"Sets `block.basefee`.\",\n \"declaration\": \"function fee(uint256 newBasefee) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"fee(uint256)\",\n \"selector\": \"0x39b37ab0\",\n \"selectorBytes\": [\n 57,\n 179,\n 122,\n 176\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"ffi\",\n \"description\": \"Performs a foreign function call via the terminal.\",\n \"declaration\": \"function ffi(string[] calldata commandInput) external returns (bytes memory result);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"ffi(string[])\",\n \"selector\": \"0x89160467\",\n \"selectorBytes\": [\n 137,\n 22,\n 4,\n 103\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"foundryVersionAtLeast\",\n \"description\": \"Returns true if the current Foundry version is greater than or equal to the given version.\\nThe given version string must be in the format `major.minor.patch`.\\nThis is equivalent to `foundryVersionCmp(version) >= 0`.\",\n \"declaration\": \"function foundryVersionAtLeast(string calldata version) external view returns (bool);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"foundryVersionAtLeast(string)\",\n \"selector\": \"0x6248be1f\",\n \"selectorBytes\": [\n 98,\n 72,\n 190,\n 31\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"foundryVersionCmp\",\n \"description\": \"Compares the current Foundry version with the given version string.\\nThe given version string must be in the format `major.minor.patch`.\\nReturns:\\n-1 if current Foundry version is less than the given version\\n0 if current Foundry version equals the given version\\n1 if current Foundry version is greater than the given version\\nThis result can then be used with a comparison operator against `0`.\\nFor example, to check if the current Foundry version is greater than or equal to `1.0.0`:\\n`if (foundryVersionCmp(\\\"1.0.0\\\") >= 0) { ... }`\",\n \"declaration\": \"function foundryVersionCmp(string calldata version) external view returns (int256);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"foundryVersionCmp(string)\",\n \"selector\": \"0xca7b0a09\",\n \"selectorBytes\": [\n 202,\n 123,\n 10,\n 9\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"fromRlp\",\n \"description\": \"RLP decodes an RLP payload into a list of bytes.\",\n \"declaration\": \"function fromRlp(bytes calldata rlp) external pure returns (bytes[] memory data);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"fromRlp(bytes)\",\n \"selector\": \"0x1e1d8b63\",\n \"selectorBytes\": [\n 30,\n 29,\n 139,\n 99\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"fsMetadata\",\n \"description\": \"Given a path, query the file system to get information about a file, directory, etc.\",\n \"declaration\": \"function fsMetadata(string calldata path) external view returns (FsMetadata memory metadata);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"fsMetadata(string)\",\n \"selector\": \"0xaf368a08\",\n \"selectorBytes\": [\n 175,\n 54,\n 138,\n 8\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getArtifactPathByCode\",\n \"description\": \"Gets the artifact path from code (aka. creation code).\",\n \"declaration\": \"function getArtifactPathByCode(bytes calldata code) external view returns (string memory path);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getArtifactPathByCode(bytes)\",\n \"selector\": \"0xeb74848c\",\n \"selectorBytes\": [\n 235,\n 116,\n 132,\n 140\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getArtifactPathByDeployedCode\",\n \"description\": \"Gets the artifact path from deployed code (aka. runtime code).\",\n \"declaration\": \"function getArtifactPathByDeployedCode(bytes calldata deployedCode) external view returns (string memory path);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getArtifactPathByDeployedCode(bytes)\",\n \"selector\": \"0x6d853ba5\",\n \"selectorBytes\": [\n 109,\n 133,\n 59,\n 165\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getBlobBaseFee\",\n \"description\": \"Gets the current `block.blobbasefee`.\\nYou should use this instead of `block.blobbasefee` if you use `vm.blobBaseFee`, as `block.blobbasefee` is assumed to be constant across a transaction,\\nand as a result will get optimized out by the compiler.\\nSee https://github.com/foundry-rs/foundry/issues/6180\",\n \"declaration\": \"function getBlobBaseFee() external view returns (uint256 blobBaseFee);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getBlobBaseFee()\",\n \"selector\": \"0x1f6d6ef7\",\n \"selectorBytes\": [\n 31,\n 109,\n 110,\n 247\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getBlobhashes\",\n \"description\": \"Gets the blockhashes from the current transaction.\\nNot available on EVM versions before Cancun.\\nIf used on unsupported EVM versions it will revert.\",\n \"declaration\": \"function getBlobhashes() external view returns (bytes32[] memory hashes);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getBlobhashes()\",\n \"selector\": \"0xf56ff18b\",\n \"selectorBytes\": [\n 245,\n 111,\n 241,\n 139\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"getBlockNumber\",\n \"description\": \"Gets the current `block.number`.\\nYou should use this instead of `block.number` if you use `vm.roll`, as `block.number` is assumed to be constant across a transaction,\\nand as a result will get optimized out by the compiler.\\nSee https://github.com/foundry-rs/foundry/issues/6180\",\n \"declaration\": \"function getBlockNumber() external view returns (uint256 height);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getBlockNumber()\",\n \"selector\": \"0x42cbb15c\",\n \"selectorBytes\": [\n 66,\n 203,\n 177,\n 92\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getBlockTimestamp\",\n \"description\": \"Gets the current `block.timestamp`.\\nYou should use this instead of `block.timestamp` if you use `vm.warp`, as `block.timestamp` is assumed to be constant across a transaction,\\nand as a result will get optimized out by the compiler.\\nSee https://github.com/foundry-rs/foundry/issues/6180\",\n \"declaration\": \"function getBlockTimestamp() external view returns (uint256 timestamp);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getBlockTimestamp()\",\n \"selector\": \"0x796b89b9\",\n \"selectorBytes\": [\n 121,\n 107,\n 137,\n 185\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getBroadcast\",\n \"description\": \"Returns the most recent broadcast for the given contract on `chainId` matching `txType`.\\nFor example:\\nThe most recent deployment can be fetched by passing `txType` as `CREATE` or `CREATE2`.\\nThe most recent call can be fetched by passing `txType` as `CALL`.\",\n \"declaration\": \"function getBroadcast(string calldata contractName, uint64 chainId, BroadcastTxType txType) external view returns (BroadcastTxSummary memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getBroadcast(string,uint64,uint8)\",\n \"selector\": \"0x3dc90cb3\",\n \"selectorBytes\": [\n 61,\n 201,\n 12,\n 179\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getBroadcasts_0\",\n \"description\": \"Returns all broadcasts for the given contract on `chainId` with the specified `txType`.\\nSorted such that the most recent broadcast is the first element, and the oldest is the last. i.e descending order of BroadcastTxSummary.blockNumber.\",\n \"declaration\": \"function getBroadcasts(string calldata contractName, uint64 chainId, BroadcastTxType txType) external view returns (BroadcastTxSummary[] memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getBroadcasts(string,uint64,uint8)\",\n \"selector\": \"0xf7afe919\",\n \"selectorBytes\": [\n 247,\n 175,\n 233,\n 25\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getBroadcasts_1\",\n \"description\": \"Returns all broadcasts for the given contract on `chainId`.\\nSorted such that the most recent broadcast is the first element, and the oldest is the last. i.e descending order of BroadcastTxSummary.blockNumber.\",\n \"declaration\": \"function getBroadcasts(string calldata contractName, uint64 chainId) external view returns (BroadcastTxSummary[] memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getBroadcasts(string,uint64)\",\n \"selector\": \"0xf2fa4a26\",\n \"selectorBytes\": [\n 242,\n 250,\n 74,\n 38\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getChainId\",\n \"description\": \"Gets the current `block.chainid` of the currently selected environment.\\nYou should use this instead of `block.chainid` if you use `vm.selectFork` or `vm.createSelectFork`, as `block.chainid` could be assumed\\nto be constant across a transaction, and as a result will get optimized out by the compiler.\\nSee https://github.com/foundry-rs/foundry/issues/6180\",\n \"declaration\": \"function getChainId() external view returns (uint256 blockChainId);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getChainId()\",\n \"selector\": \"0x3408e470\",\n \"selectorBytes\": [\n 52,\n 8,\n 228,\n 112\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getChain_0\",\n \"description\": \"Returns a Chain struct for specific alias\",\n \"declaration\": \"function getChain(string calldata chainAlias) external view returns (Chain memory chain);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getChain(string)\",\n \"selector\": \"0x4cc1c2bb\",\n \"selectorBytes\": [\n 76,\n 193,\n 194,\n 187\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getChain_1\",\n \"description\": \"Returns a Chain struct for specific chainId\",\n \"declaration\": \"function getChain(uint256 chainId) external view returns (Chain memory chain);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getChain(uint256)\",\n \"selector\": \"0xb6791ad4\",\n \"selectorBytes\": [\n 182,\n 121,\n 26,\n 212\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getCode\",\n \"description\": \"Gets the creation bytecode from an artifact file. Takes in the relative path to the json file or the path to the\\nartifact in the form of :: where and parts are optional.\",\n \"declaration\": \"function getCode(string calldata artifactPath) external view returns (bytes memory creationBytecode);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getCode(string)\",\n \"selector\": \"0x8d1cc925\",\n \"selectorBytes\": [\n 141,\n 28,\n 201,\n 37\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getDeployedCode\",\n \"description\": \"Gets the deployed bytecode from an artifact file. Takes in the relative path to the json file or the path to the\\nartifact in the form of :: where and parts are optional.\",\n \"declaration\": \"function getDeployedCode(string calldata artifactPath) external view returns (bytes memory runtimeBytecode);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getDeployedCode(string)\",\n \"selector\": \"0x3ebf73b4\",\n \"selectorBytes\": [\n 62,\n 191,\n 115,\n 180\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getDeployment_0\",\n \"description\": \"Returns the most recent deployment for the current `chainId`.\",\n \"declaration\": \"function getDeployment(string calldata contractName) external view returns (address deployedAddress);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getDeployment(string)\",\n \"selector\": \"0xa8091d97\",\n \"selectorBytes\": [\n 168,\n 9,\n 29,\n 151\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getDeployment_1\",\n \"description\": \"Returns the most recent deployment for the given contract on `chainId`\",\n \"declaration\": \"function getDeployment(string calldata contractName, uint64 chainId) external view returns (address deployedAddress);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getDeployment(string,uint64)\",\n \"selector\": \"0x0debd5d6\",\n \"selectorBytes\": [\n 13,\n 235,\n 213,\n 214\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getDeployments\",\n \"description\": \"Returns all deployments for the given contract on `chainId`\\nSorted in descending order of deployment time i.e descending order of BroadcastTxSummary.blockNumber.\\nThe most recent deployment is the first element, and the oldest is the last.\",\n \"declaration\": \"function getDeployments(string calldata contractName, uint64 chainId) external view returns (address[] memory deployedAddresses);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getDeployments(string,uint64)\",\n \"selector\": \"0x74e133dd\",\n \"selectorBytes\": [\n 116,\n 225,\n 51,\n 221\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getEvmVersion\",\n \"description\": \"Returns the test or script execution evm version.\\n**Note:** The execution evm version is not the same as the compilation one.\",\n \"declaration\": \"function getEvmVersion() external pure returns (string memory evm);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"getEvmVersion()\",\n \"selector\": \"0xaa2bb222\",\n \"selectorBytes\": [\n 170,\n 43,\n 178,\n 34\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getFoundryVersion\",\n \"description\": \"Returns the Foundry version.\\nFormat: -+..\\nSample output: 0.3.0-nightly+3cb96bde9b.1737036656.debug\\nNote: Build timestamps may vary slightly across platforms due to separate CI jobs.\\nFor reliable version comparisons, use UNIX format (e.g., >= 1700000000)\\nto compare timestamps while ignoring minor time differences.\",\n \"declaration\": \"function getFoundryVersion() external view returns (string memory version);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getFoundryVersion()\",\n \"selector\": \"0xea991bb5\",\n \"selectorBytes\": [\n 234,\n 153,\n 27,\n 181\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getLabel\",\n \"description\": \"Gets the label for the specified address.\",\n \"declaration\": \"function getLabel(address account) external view returns (string memory currentLabel);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getLabel(address)\",\n \"selector\": \"0x28a249b0\",\n \"selectorBytes\": [\n 40,\n 162,\n 73,\n 176\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getMappingKeyAndParentOf\",\n \"description\": \"Gets the map key and parent of a mapping at a given slot, for a given address.\",\n \"declaration\": \"function getMappingKeyAndParentOf(address target, bytes32 elementSlot) external view returns (bool found, bytes32 key, bytes32 parent);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getMappingKeyAndParentOf(address,bytes32)\",\n \"selector\": \"0x876e24e6\",\n \"selectorBytes\": [\n 135,\n 110,\n 36,\n 230\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getMappingLength\",\n \"description\": \"Gets the number of elements in the mapping at the given slot, for a given address.\",\n \"declaration\": \"function getMappingLength(address target, bytes32 mappingSlot) external view returns (uint256 length);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getMappingLength(address,bytes32)\",\n \"selector\": \"0x2f2fd63f\",\n \"selectorBytes\": [\n 47,\n 47,\n 214,\n 63\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getMappingSlotAt\",\n \"description\": \"Gets the elements at index idx of the mapping at the given slot, for a given address. The\\nindex must be less than the length of the mapping (i.e. the number of keys in the mapping).\",\n \"declaration\": \"function getMappingSlotAt(address target, bytes32 mappingSlot, uint256 idx) external view returns (bytes32 value);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getMappingSlotAt(address,bytes32,uint256)\",\n \"selector\": \"0xebc73ab4\",\n \"selectorBytes\": [\n 235,\n 199,\n 58,\n 180\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getNonce_0\",\n \"description\": \"Gets the nonce of an account.\",\n \"declaration\": \"function getNonce(address account) external view returns (uint64 nonce);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getNonce(address)\",\n \"selector\": \"0x2d0335ab\",\n \"selectorBytes\": [\n 45,\n 3,\n 53,\n 171\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getNonce_1\",\n \"description\": \"Get the nonce of a `Wallet`.\",\n \"declaration\": \"function getNonce(Wallet calldata wallet) external view returns (uint64 nonce);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getNonce((address,uint256,uint256,uint256))\",\n \"selector\": \"0xa5748aad\",\n \"selectorBytes\": [\n 165,\n 116,\n 138,\n 173\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getRawBlockHeader\",\n \"description\": \"Gets the RLP encoded block header for a given block number.\\nReturns the block header in the same format as `cast block --raw`.\",\n \"declaration\": \"function getRawBlockHeader(uint256 blockNumber) external view returns (bytes memory rlpHeader);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getRawBlockHeader(uint256)\",\n \"selector\": \"0x2c667606\",\n \"selectorBytes\": [\n 44,\n 102,\n 118,\n 6\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getRecordedLogs\",\n \"description\": \"Gets all the recorded logs.\",\n \"declaration\": \"function getRecordedLogs() external view returns (Log[] memory logs);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getRecordedLogs()\",\n \"selector\": \"0x191553a4\",\n \"selectorBytes\": [\n 25,\n 21,\n 83,\n 164\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getRecordedLogsJson\",\n \"description\": \"Gets all the recorded logs, in JSON format.\",\n \"declaration\": \"function getRecordedLogsJson() external view returns (string memory logsJson);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getRecordedLogsJson()\",\n \"selector\": \"0x3b171111\",\n \"selectorBytes\": [\n 59,\n 23,\n 17,\n 17\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getStateDiff\",\n \"description\": \"Returns state diffs from current `vm.startStateDiffRecording` session.\",\n \"declaration\": \"function getStateDiff() external view returns (string memory diff);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getStateDiff()\",\n \"selector\": \"0x80df01cc\",\n \"selectorBytes\": [\n 128,\n 223,\n 1,\n 204\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getStateDiffJson\",\n \"description\": \"Returns state diffs from current `vm.startStateDiffRecording` session, in json format.\",\n \"declaration\": \"function getStateDiffJson() external view returns (string memory diff);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getStateDiffJson()\",\n \"selector\": \"0xf54fe009\",\n \"selectorBytes\": [\n 245,\n 79,\n 224,\n 9\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getStorageAccesses\",\n \"description\": \"Returns an array of `StorageAccess` from current `vm.stateStateDiffRecording` session\",\n \"declaration\": \"function getStorageAccesses() external view returns (StorageAccess[] memory storageAccesses);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getStorageAccesses()\",\n \"selector\": \"0x2899b1d0\",\n \"selectorBytes\": [\n 40,\n 153,\n 177,\n 208\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getStorageSlots\",\n \"description\": \"Returns an array of storage slots occupied by the specified variable.\",\n \"declaration\": \"function getStorageSlots(address target, string calldata variableName) external view returns (uint256[] memory slots);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getStorageSlots(address,string)\",\n \"selector\": \"0xefa136d9\",\n \"selectorBytes\": [\n 239,\n 161,\n 54,\n 217\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"getWallets\",\n \"description\": \"Returns addresses of available unlocked wallets in the script environment.\",\n \"declaration\": \"function getWallets() external view returns (address[] memory wallets);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"getWallets()\",\n \"selector\": \"0xdb7a4605\",\n \"selectorBytes\": [\n 219,\n 122,\n 70,\n 5\n ]\n },\n \"group\": \"scripting\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"indexOf\",\n \"description\": \"Returns the index of the first occurrence of a `key` in an `input` string.\\nReturns `NOT_FOUND` (i.e. `type(uint256).max`) if the `key` is not found.\\nReturns 0 in case of an empty `key`.\",\n \"declaration\": \"function indexOf(string calldata input, string calldata key) external pure returns (uint256);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"indexOf(string,string)\",\n \"selector\": \"0x8a0807b7\",\n \"selectorBytes\": [\n 138,\n 8,\n 7,\n 183\n ]\n },\n \"group\": \"string\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"interceptInitcode\",\n \"description\": \"Causes the next contract creation (via new) to fail and return its initcode in the returndata buffer.\\nThis allows type-safe access to the initcode payload that would be used for contract creation.\\nExample usage:\\nvm.interceptInitcode();\\nbytes memory initcode;\\ntry new MyContract(param1, param2) { assert(false); }\\ncatch (bytes memory interceptedInitcode) { initcode = interceptedInitcode; }\",\n \"declaration\": \"function interceptInitcode() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"interceptInitcode()\",\n \"selector\": \"0x838653c7\",\n \"selectorBytes\": [\n 131,\n 134,\n 83,\n 199\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"isContext\",\n \"description\": \"Returns true if `forge` command was executed in given context.\",\n \"declaration\": \"function isContext(ForgeContext context) external view returns (bool result);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"isContext(uint8)\",\n \"selector\": \"0x64af255d\",\n \"selectorBytes\": [\n 100,\n 175,\n 37,\n 93\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"isDir\",\n \"description\": \"Returns true if the path exists on disk and is pointing at a directory, else returns false.\",\n \"declaration\": \"function isDir(string calldata path) external view returns (bool result);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"isDir(string)\",\n \"selector\": \"0x7d15d019\",\n \"selectorBytes\": [\n 125,\n 21,\n 208,\n 25\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"isFile\",\n \"description\": \"Returns true if the path exists on disk and is pointing at a regular file, else returns false.\",\n \"declaration\": \"function isFile(string calldata path) external view returns (bool result);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"isFile(string)\",\n \"selector\": \"0xe0eb04d4\",\n \"selectorBytes\": [\n 224,\n 235,\n 4,\n 212\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"isPersistent\",\n \"description\": \"Returns true if the account is marked as persistent.\",\n \"declaration\": \"function isPersistent(address account) external view returns (bool persistent);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"isPersistent(address)\",\n \"selector\": \"0xd92d8efd\",\n \"selectorBytes\": [\n 217,\n 45,\n 142,\n 253\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"keyExists\",\n \"description\": \"Checks if `key` exists in a JSON object\\n`keyExists` is being deprecated in favor of `keyExistsJson`. It will be removed in future versions.\",\n \"declaration\": \"function keyExists(string calldata json, string calldata key) external view returns (bool);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"keyExists(string,string)\",\n \"selector\": \"0x528a683c\",\n \"selectorBytes\": [\n 82,\n 138,\n 104,\n 60\n ]\n },\n \"group\": \"json\",\n \"status\": {\n \"deprecated\": \"replaced by `keyExistsJson`\"\n },\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"keyExistsJson\",\n \"description\": \"Checks if `key` exists in a JSON object.\",\n \"declaration\": \"function keyExistsJson(string calldata json, string calldata key) external view returns (bool);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"keyExistsJson(string,string)\",\n \"selector\": \"0xdb4235f6\",\n \"selectorBytes\": [\n 219,\n 66,\n 53,\n 246\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"keyExistsToml\",\n \"description\": \"Checks if `key` exists in a TOML table.\",\n \"declaration\": \"function keyExistsToml(string calldata toml, string calldata key) external view returns (bool);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"keyExistsToml(string,string)\",\n \"selector\": \"0x600903ad\",\n \"selectorBytes\": [\n 96,\n 9,\n 3,\n 173\n ]\n },\n \"group\": \"toml\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"label\",\n \"description\": \"Labels an address in call traces.\",\n \"declaration\": \"function label(address account, string calldata newLabel) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"label(address,string)\",\n \"selector\": \"0xc657c718\",\n \"selectorBytes\": [\n 198,\n 87,\n 199,\n 24\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"lastCallGas\",\n \"description\": \"Gets the gas used in the last call from the callee perspective.\",\n \"declaration\": \"function lastCallGas() external view returns (Gas memory gas);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"lastCallGas()\",\n \"selector\": \"0x2b589b28\",\n \"selectorBytes\": [\n 43,\n 88,\n 155,\n 40\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"load\",\n \"description\": \"Loads a storage slot from an address.\",\n \"declaration\": \"function load(address target, bytes32 slot) external view returns (bytes32 data);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"load(address,bytes32)\",\n \"selector\": \"0x667f9d70\",\n \"selectorBytes\": [\n 102,\n 127,\n 157,\n 112\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"loadAllocs\",\n \"description\": \"Load a genesis JSON file's `allocs` into the in-memory EVM state.\",\n \"declaration\": \"function loadAllocs(string calldata pathToAllocsJson) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"loadAllocs(string)\",\n \"selector\": \"0xb3a056d7\",\n \"selectorBytes\": [\n 179,\n 160,\n 86,\n 215\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"makePersistent_0\",\n \"description\": \"Marks that the account(s) should use persistent storage across fork swaps in a multifork setup\\nMeaning, changes made to the state of this account will be kept when switching forks.\",\n \"declaration\": \"function makePersistent(address account) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"makePersistent(address)\",\n \"selector\": \"0x57e22dde\",\n \"selectorBytes\": [\n 87,\n 226,\n 45,\n 222\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"makePersistent_1\",\n \"description\": \"See `makePersistent(address)`.\",\n \"declaration\": \"function makePersistent(address account0, address account1) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"makePersistent(address,address)\",\n \"selector\": \"0x4074e0a8\",\n \"selectorBytes\": [\n 64,\n 116,\n 224,\n 168\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"makePersistent_2\",\n \"description\": \"See `makePersistent(address)`.\",\n \"declaration\": \"function makePersistent(address account0, address account1, address account2) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"makePersistent(address,address,address)\",\n \"selector\": \"0xefb77a75\",\n \"selectorBytes\": [\n 239,\n 183,\n 122,\n 117\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"makePersistent_3\",\n \"description\": \"See `makePersistent(address)`.\",\n \"declaration\": \"function makePersistent(address[] calldata accounts) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"makePersistent(address[])\",\n \"selector\": \"0x1d9e269e\",\n \"selectorBytes\": [\n 29,\n 158,\n 38,\n 158\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"mockCallRevert_0\",\n \"description\": \"Reverts a call to an address with specified revert data.\",\n \"declaration\": \"function mockCallRevert(address callee, bytes calldata data, bytes calldata revertData) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"mockCallRevert(address,bytes,bytes)\",\n \"selector\": \"0xdbaad147\",\n \"selectorBytes\": [\n 219,\n 170,\n 209,\n 71\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"mockCallRevert_1\",\n \"description\": \"Reverts a call to an address with a specific `msg.value`, with specified revert data.\",\n \"declaration\": \"function mockCallRevert(address callee, uint256 msgValue, bytes calldata data, bytes calldata revertData) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"mockCallRevert(address,uint256,bytes,bytes)\",\n \"selector\": \"0xd23cd037\",\n \"selectorBytes\": [\n 210,\n 60,\n 208,\n 55\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"mockCallRevert_2\",\n \"description\": \"Reverts a call to an address with specified revert data.\\nOverload to pass the function selector directly `token.approve.selector` instead of `abi.encodeWithSelector(token.approve.selector)`.\",\n \"declaration\": \"function mockCallRevert(address callee, bytes4 data, bytes calldata revertData) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"mockCallRevert(address,bytes4,bytes)\",\n \"selector\": \"0x2dfba5df\",\n \"selectorBytes\": [\n 45,\n 251,\n 165,\n 223\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"mockCallRevert_3\",\n \"description\": \"Reverts a call to an address with a specific `msg.value`, with specified revert data.\\nOverload to pass the function selector directly `token.approve.selector` instead of `abi.encodeWithSelector(token.approve.selector)`.\",\n \"declaration\": \"function mockCallRevert(address callee, uint256 msgValue, bytes4 data, bytes calldata revertData) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"mockCallRevert(address,uint256,bytes4,bytes)\",\n \"selector\": \"0x596c8f04\",\n \"selectorBytes\": [\n 89,\n 108,\n 143,\n 4\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"mockCall_0\",\n \"description\": \"Mocks a call to an address, returning specified data.\\nCalldata can either be strict or a partial match, e.g. if you only\\npass a Solidity selector to the expected calldata, then the entire Solidity\\nfunction will be mocked.\",\n \"declaration\": \"function mockCall(address callee, bytes calldata data, bytes calldata returnData) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"mockCall(address,bytes,bytes)\",\n \"selector\": \"0xb96213e4\",\n \"selectorBytes\": [\n 185,\n 98,\n 19,\n 228\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"mockCall_1\",\n \"description\": \"Mocks a call to an address with a specific `msg.value`, returning specified data.\\nCalldata match takes precedence over `msg.value` in case of ambiguity.\",\n \"declaration\": \"function mockCall(address callee, uint256 msgValue, bytes calldata data, bytes calldata returnData) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"mockCall(address,uint256,bytes,bytes)\",\n \"selector\": \"0x81409b91\",\n \"selectorBytes\": [\n 129,\n 64,\n 155,\n 145\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"mockCall_2\",\n \"description\": \"Mocks a call to an address, returning specified data.\\nCalldata can either be strict or a partial match, e.g. if you only\\npass a Solidity selector to the expected calldata, then the entire Solidity\\nfunction will be mocked.\\nOverload to pass the function selector directly `token.approve.selector` instead of `abi.encodeWithSelector(token.approve.selector)`.\",\n \"declaration\": \"function mockCall(address callee, bytes4 data, bytes calldata returnData) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"mockCall(address,bytes4,bytes)\",\n \"selector\": \"0x08e0c537\",\n \"selectorBytes\": [\n 8,\n 224,\n 197,\n 55\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"mockCall_3\",\n \"description\": \"Mocks a call to an address with a specific `msg.value`, returning specified data.\\nCalldata match takes precedence over `msg.value` in case of ambiguity.\\nOverload to pass the function selector directly `token.approve.selector` instead of `abi.encodeWithSelector(token.approve.selector)`.\",\n \"declaration\": \"function mockCall(address callee, uint256 msgValue, bytes4 data, bytes calldata returnData) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"mockCall(address,uint256,bytes4,bytes)\",\n \"selector\": \"0xe7b36a3d\",\n \"selectorBytes\": [\n 231,\n 179,\n 106,\n 61\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"mockCalls_0\",\n \"description\": \"Mocks multiple calls to an address, returning specified data for each call.\",\n \"declaration\": \"function mockCalls(address callee, bytes calldata data, bytes[] calldata returnData) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"mockCalls(address,bytes,bytes[])\",\n \"selector\": \"0x5c5c3de9\",\n \"selectorBytes\": [\n 92,\n 92,\n 61,\n 233\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"mockCalls_1\",\n \"description\": \"Mocks multiple calls to an address with a specific `msg.value`, returning specified data for each call.\",\n \"declaration\": \"function mockCalls(address callee, uint256 msgValue, bytes calldata data, bytes[] calldata returnData) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"mockCalls(address,uint256,bytes,bytes[])\",\n \"selector\": \"0x08bcbae1\",\n \"selectorBytes\": [\n 8,\n 188,\n 186,\n 225\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"mockFunction\",\n \"description\": \"Whenever a call is made to `callee` with calldata `data`, this cheatcode instead calls\\n`target` with the same calldata. This functionality is similar to a delegate call made to\\n`target` contract from `callee`.\\nCan be used to substitute a call to a function with another implementation that captures\\nthe primary logic of the original function but is easier to reason about.\\nIf calldata is not a strict match then partial match by selector is attempted.\",\n \"declaration\": \"function mockFunction(address callee, address target, bytes calldata data) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"mockFunction(address,address,bytes)\",\n \"selector\": \"0xadf84d21\",\n \"selectorBytes\": [\n 173,\n 248,\n 77,\n 33\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"noAccessList\",\n \"description\": \"Utility cheatcode to remove any EIP-2930 access list set by `accessList` cheatcode.\",\n \"declaration\": \"function noAccessList() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"noAccessList()\",\n \"selector\": \"0x238ad778\",\n \"selectorBytes\": [\n 35,\n 138,\n 215,\n 120\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"parseAddress\",\n \"description\": \"Parses the given `string` into an `address`.\",\n \"declaration\": \"function parseAddress(string calldata stringifiedValue) external pure returns (address parsedValue);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseAddress(string)\",\n \"selector\": \"0xc6ce059d\",\n \"selectorBytes\": [\n 198,\n 206,\n 5,\n 157\n ]\n },\n \"group\": \"string\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseBool\",\n \"description\": \"Parses the given `string` into a `bool`.\",\n \"declaration\": \"function parseBool(string calldata stringifiedValue) external pure returns (bool parsedValue);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseBool(string)\",\n \"selector\": \"0x974ef924\",\n \"selectorBytes\": [\n 151,\n 78,\n 249,\n 36\n ]\n },\n \"group\": \"string\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseBytes\",\n \"description\": \"Parses the given `string` into `bytes`.\",\n \"declaration\": \"function parseBytes(string calldata stringifiedValue) external pure returns (bytes memory parsedValue);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseBytes(string)\",\n \"selector\": \"0x8f5d232d\",\n \"selectorBytes\": [\n 143,\n 93,\n 35,\n 45\n ]\n },\n \"group\": \"string\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseBytes32\",\n \"description\": \"Parses the given `string` into a `bytes32`.\",\n \"declaration\": \"function parseBytes32(string calldata stringifiedValue) external pure returns (bytes32 parsedValue);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseBytes32(string)\",\n \"selector\": \"0x087e6e81\",\n \"selectorBytes\": [\n 8,\n 126,\n 110,\n 129\n ]\n },\n \"group\": \"string\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseInt\",\n \"description\": \"Parses the given `string` into a `int256`.\",\n \"declaration\": \"function parseInt(string calldata stringifiedValue) external pure returns (int256 parsedValue);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseInt(string)\",\n \"selector\": \"0x42346c5e\",\n \"selectorBytes\": [\n 66,\n 52,\n 108,\n 94\n ]\n },\n \"group\": \"string\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseJsonAddress\",\n \"description\": \"Parses a string of JSON data at `key` and coerces it to `address`.\",\n \"declaration\": \"function parseJsonAddress(string calldata json, string calldata key) external pure returns (address);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseJsonAddress(string,string)\",\n \"selector\": \"0x1e19e657\",\n \"selectorBytes\": [\n 30,\n 25,\n 230,\n 87\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseJsonAddressArray\",\n \"description\": \"Parses a string of JSON data at `key` and coerces it to `address[]`.\",\n \"declaration\": \"function parseJsonAddressArray(string calldata json, string calldata key) external pure returns (address[] memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseJsonAddressArray(string,string)\",\n \"selector\": \"0x2fce7883\",\n \"selectorBytes\": [\n 47,\n 206,\n 120,\n 131\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseJsonBool\",\n \"description\": \"Parses a string of JSON data at `key` and coerces it to `bool`.\",\n \"declaration\": \"function parseJsonBool(string calldata json, string calldata key) external pure returns (bool);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseJsonBool(string,string)\",\n \"selector\": \"0x9f86dc91\",\n \"selectorBytes\": [\n 159,\n 134,\n 220,\n 145\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseJsonBoolArray\",\n \"description\": \"Parses a string of JSON data at `key` and coerces it to `bool[]`.\",\n \"declaration\": \"function parseJsonBoolArray(string calldata json, string calldata key) external pure returns (bool[] memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseJsonBoolArray(string,string)\",\n \"selector\": \"0x91f3b94f\",\n \"selectorBytes\": [\n 145,\n 243,\n 185,\n 79\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseJsonBytes\",\n \"description\": \"Parses a string of JSON data at `key` and coerces it to `bytes`.\",\n \"declaration\": \"function parseJsonBytes(string calldata json, string calldata key) external pure returns (bytes memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseJsonBytes(string,string)\",\n \"selector\": \"0xfd921be8\",\n \"selectorBytes\": [\n 253,\n 146,\n 27,\n 232\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseJsonBytes32\",\n \"description\": \"Parses a string of JSON data at `key` and coerces it to `bytes32`.\",\n \"declaration\": \"function parseJsonBytes32(string calldata json, string calldata key) external pure returns (bytes32);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseJsonBytes32(string,string)\",\n \"selector\": \"0x1777e59d\",\n \"selectorBytes\": [\n 23,\n 119,\n 229,\n 157\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseJsonBytes32Array\",\n \"description\": \"Parses a string of JSON data at `key` and coerces it to `bytes32[]`.\",\n \"declaration\": \"function parseJsonBytes32Array(string calldata json, string calldata key) external pure returns (bytes32[] memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseJsonBytes32Array(string,string)\",\n \"selector\": \"0x91c75bc3\",\n \"selectorBytes\": [\n 145,\n 199,\n 91,\n 195\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseJsonBytesArray\",\n \"description\": \"Parses a string of JSON data at `key` and coerces it to `bytes[]`.\",\n \"declaration\": \"function parseJsonBytesArray(string calldata json, string calldata key) external pure returns (bytes[] memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseJsonBytesArray(string,string)\",\n \"selector\": \"0x6631aa99\",\n \"selectorBytes\": [\n 102,\n 49,\n 170,\n 153\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseJsonInt\",\n \"description\": \"Parses a string of JSON data at `key` and coerces it to `int256`.\",\n \"declaration\": \"function parseJsonInt(string calldata json, string calldata key) external pure returns (int256);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseJsonInt(string,string)\",\n \"selector\": \"0x7b048ccd\",\n \"selectorBytes\": [\n 123,\n 4,\n 140,\n 205\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseJsonIntArray\",\n \"description\": \"Parses a string of JSON data at `key` and coerces it to `int256[]`.\",\n \"declaration\": \"function parseJsonIntArray(string calldata json, string calldata key) external pure returns (int256[] memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseJsonIntArray(string,string)\",\n \"selector\": \"0x9983c28a\",\n \"selectorBytes\": [\n 153,\n 131,\n 194,\n 138\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseJsonKeys\",\n \"description\": \"Returns an array of all the keys in a JSON object.\",\n \"declaration\": \"function parseJsonKeys(string calldata json, string calldata key) external pure returns (string[] memory keys);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseJsonKeys(string,string)\",\n \"selector\": \"0x213e4198\",\n \"selectorBytes\": [\n 33,\n 62,\n 65,\n 152\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseJsonString\",\n \"description\": \"Parses a string of JSON data at `key` and coerces it to `string`.\",\n \"declaration\": \"function parseJsonString(string calldata json, string calldata key) external pure returns (string memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseJsonString(string,string)\",\n \"selector\": \"0x49c4fac8\",\n \"selectorBytes\": [\n 73,\n 196,\n 250,\n 200\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseJsonStringArray\",\n \"description\": \"Parses a string of JSON data at `key` and coerces it to `string[]`.\",\n \"declaration\": \"function parseJsonStringArray(string calldata json, string calldata key) external pure returns (string[] memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseJsonStringArray(string,string)\",\n \"selector\": \"0x498fdcf4\",\n \"selectorBytes\": [\n 73,\n 143,\n 220,\n 244\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseJsonTypeArray\",\n \"description\": \"Parses a string of JSON data at `key` and coerces it to type array corresponding to `typeDescription`.\",\n \"declaration\": \"function parseJsonTypeArray(string calldata json, string calldata key, string calldata typeDescription) external pure returns (bytes memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseJsonTypeArray(string,string,string)\",\n \"selector\": \"0x0175d535\",\n \"selectorBytes\": [\n 1,\n 117,\n 213,\n 53\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseJsonType_0\",\n \"description\": \"Parses a string of JSON data and coerces it to type corresponding to `typeDescription`.\",\n \"declaration\": \"function parseJsonType(string calldata json, string calldata typeDescription) external pure returns (bytes memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseJsonType(string,string)\",\n \"selector\": \"0xa9da313b\",\n \"selectorBytes\": [\n 169,\n 218,\n 49,\n 59\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseJsonType_1\",\n \"description\": \"Parses a string of JSON data at `key` and coerces it to type corresponding to `typeDescription`.\",\n \"declaration\": \"function parseJsonType(string calldata json, string calldata key, string calldata typeDescription) external pure returns (bytes memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseJsonType(string,string,string)\",\n \"selector\": \"0xe3f5ae33\",\n \"selectorBytes\": [\n 227,\n 245,\n 174,\n 51\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseJsonUint\",\n \"description\": \"Parses a string of JSON data at `key` and coerces it to `uint256`.\",\n \"declaration\": \"function parseJsonUint(string calldata json, string calldata key) external pure returns (uint256);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseJsonUint(string,string)\",\n \"selector\": \"0xaddde2b6\",\n \"selectorBytes\": [\n 173,\n 221,\n 226,\n 182\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseJsonUintArray\",\n \"description\": \"Parses a string of JSON data at `key` and coerces it to `uint256[]`.\",\n \"declaration\": \"function parseJsonUintArray(string calldata json, string calldata key) external pure returns (uint256[] memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseJsonUintArray(string,string)\",\n \"selector\": \"0x522074ab\",\n \"selectorBytes\": [\n 82,\n 32,\n 116,\n 171\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseJson_0\",\n \"description\": \"ABI-encodes a JSON object.\",\n \"declaration\": \"function parseJson(string calldata json) external pure returns (bytes memory abiEncodedData);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseJson(string)\",\n \"selector\": \"0x6a82600a\",\n \"selectorBytes\": [\n 106,\n 130,\n 96,\n 10\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseJson_1\",\n \"description\": \"ABI-encodes a JSON object at `key`.\",\n \"declaration\": \"function parseJson(string calldata json, string calldata key) external pure returns (bytes memory abiEncodedData);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseJson(string,string)\",\n \"selector\": \"0x85940ef1\",\n \"selectorBytes\": [\n 133,\n 148,\n 14,\n 241\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseTomlAddress\",\n \"description\": \"Parses a string of TOML data at `key` and coerces it to `address`.\",\n \"declaration\": \"function parseTomlAddress(string calldata toml, string calldata key) external pure returns (address);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseTomlAddress(string,string)\",\n \"selector\": \"0x65e7c844\",\n \"selectorBytes\": [\n 101,\n 231,\n 200,\n 68\n ]\n },\n \"group\": \"toml\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseTomlAddressArray\",\n \"description\": \"Parses a string of TOML data at `key` and coerces it to `address[]`.\",\n \"declaration\": \"function parseTomlAddressArray(string calldata toml, string calldata key) external pure returns (address[] memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseTomlAddressArray(string,string)\",\n \"selector\": \"0x65c428e7\",\n \"selectorBytes\": [\n 101,\n 196,\n 40,\n 231\n ]\n },\n \"group\": \"toml\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseTomlBool\",\n \"description\": \"Parses a string of TOML data at `key` and coerces it to `bool`.\",\n \"declaration\": \"function parseTomlBool(string calldata toml, string calldata key) external pure returns (bool);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseTomlBool(string,string)\",\n \"selector\": \"0xd30dced6\",\n \"selectorBytes\": [\n 211,\n 13,\n 206,\n 214\n ]\n },\n \"group\": \"toml\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseTomlBoolArray\",\n \"description\": \"Parses a string of TOML data at `key` and coerces it to `bool[]`.\",\n \"declaration\": \"function parseTomlBoolArray(string calldata toml, string calldata key) external pure returns (bool[] memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseTomlBoolArray(string,string)\",\n \"selector\": \"0x127cfe9a\",\n \"selectorBytes\": [\n 18,\n 124,\n 254,\n 154\n ]\n },\n \"group\": \"toml\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseTomlBytes\",\n \"description\": \"Parses a string of TOML data at `key` and coerces it to `bytes`.\",\n \"declaration\": \"function parseTomlBytes(string calldata toml, string calldata key) external pure returns (bytes memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseTomlBytes(string,string)\",\n \"selector\": \"0xd77bfdb9\",\n \"selectorBytes\": [\n 215,\n 123,\n 253,\n 185\n ]\n },\n \"group\": \"toml\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseTomlBytes32\",\n \"description\": \"Parses a string of TOML data at `key` and coerces it to `bytes32`.\",\n \"declaration\": \"function parseTomlBytes32(string calldata toml, string calldata key) external pure returns (bytes32);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseTomlBytes32(string,string)\",\n \"selector\": \"0x8e214810\",\n \"selectorBytes\": [\n 142,\n 33,\n 72,\n 16\n ]\n },\n \"group\": \"toml\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseTomlBytes32Array\",\n \"description\": \"Parses a string of TOML data at `key` and coerces it to `bytes32[]`.\",\n \"declaration\": \"function parseTomlBytes32Array(string calldata toml, string calldata key) external pure returns (bytes32[] memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseTomlBytes32Array(string,string)\",\n \"selector\": \"0x3e716f81\",\n \"selectorBytes\": [\n 62,\n 113,\n 111,\n 129\n ]\n },\n \"group\": \"toml\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseTomlBytesArray\",\n \"description\": \"Parses a string of TOML data at `key` and coerces it to `bytes[]`.\",\n \"declaration\": \"function parseTomlBytesArray(string calldata toml, string calldata key) external pure returns (bytes[] memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseTomlBytesArray(string,string)\",\n \"selector\": \"0xb197c247\",\n \"selectorBytes\": [\n 177,\n 151,\n 194,\n 71\n ]\n },\n \"group\": \"toml\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseTomlInt\",\n \"description\": \"Parses a string of TOML data at `key` and coerces it to `int256`.\",\n \"declaration\": \"function parseTomlInt(string calldata toml, string calldata key) external pure returns (int256);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseTomlInt(string,string)\",\n \"selector\": \"0xc1350739\",\n \"selectorBytes\": [\n 193,\n 53,\n 7,\n 57\n ]\n },\n \"group\": \"toml\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseTomlIntArray\",\n \"description\": \"Parses a string of TOML data at `key` and coerces it to `int256[]`.\",\n \"declaration\": \"function parseTomlIntArray(string calldata toml, string calldata key) external pure returns (int256[] memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseTomlIntArray(string,string)\",\n \"selector\": \"0xd3522ae6\",\n \"selectorBytes\": [\n 211,\n 82,\n 42,\n 230\n ]\n },\n \"group\": \"toml\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseTomlKeys\",\n \"description\": \"Returns an array of all the keys in a TOML table.\",\n \"declaration\": \"function parseTomlKeys(string calldata toml, string calldata key) external pure returns (string[] memory keys);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseTomlKeys(string,string)\",\n \"selector\": \"0x812a44b2\",\n \"selectorBytes\": [\n 129,\n 42,\n 68,\n 178\n ]\n },\n \"group\": \"toml\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseTomlString\",\n \"description\": \"Parses a string of TOML data at `key` and coerces it to `string`.\",\n \"declaration\": \"function parseTomlString(string calldata toml, string calldata key) external pure returns (string memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseTomlString(string,string)\",\n \"selector\": \"0x8bb8dd43\",\n \"selectorBytes\": [\n 139,\n 184,\n 221,\n 67\n ]\n },\n \"group\": \"toml\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseTomlStringArray\",\n \"description\": \"Parses a string of TOML data at `key` and coerces it to `string[]`.\",\n \"declaration\": \"function parseTomlStringArray(string calldata toml, string calldata key) external pure returns (string[] memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseTomlStringArray(string,string)\",\n \"selector\": \"0x9f629281\",\n \"selectorBytes\": [\n 159,\n 98,\n 146,\n 129\n ]\n },\n \"group\": \"toml\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseTomlTypeArray\",\n \"description\": \"Parses a string of TOML data at `key` and coerces it to type array corresponding to `typeDescription`.\",\n \"declaration\": \"function parseTomlTypeArray(string calldata toml, string calldata key, string calldata typeDescription) external pure returns (bytes memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseTomlTypeArray(string,string,string)\",\n \"selector\": \"0x49be3743\",\n \"selectorBytes\": [\n 73,\n 190,\n 55,\n 67\n ]\n },\n \"group\": \"toml\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseTomlType_0\",\n \"description\": \"Parses a string of TOML data and coerces it to type corresponding to `typeDescription`.\",\n \"declaration\": \"function parseTomlType(string calldata toml, string calldata typeDescription) external pure returns (bytes memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseTomlType(string,string)\",\n \"selector\": \"0x47fa5e11\",\n \"selectorBytes\": [\n 71,\n 250,\n 94,\n 17\n ]\n },\n \"group\": \"toml\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseTomlType_1\",\n \"description\": \"Parses a string of TOML data at `key` and coerces it to type corresponding to `typeDescription`.\",\n \"declaration\": \"function parseTomlType(string calldata toml, string calldata key, string calldata typeDescription) external pure returns (bytes memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseTomlType(string,string,string)\",\n \"selector\": \"0xf9fa5cdb\",\n \"selectorBytes\": [\n 249,\n 250,\n 92,\n 219\n ]\n },\n \"group\": \"toml\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseTomlUint\",\n \"description\": \"Parses a string of TOML data at `key` and coerces it to `uint256`.\",\n \"declaration\": \"function parseTomlUint(string calldata toml, string calldata key) external pure returns (uint256);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseTomlUint(string,string)\",\n \"selector\": \"0xcc7b0487\",\n \"selectorBytes\": [\n 204,\n 123,\n 4,\n 135\n ]\n },\n \"group\": \"toml\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseTomlUintArray\",\n \"description\": \"Parses a string of TOML data at `key` and coerces it to `uint256[]`.\",\n \"declaration\": \"function parseTomlUintArray(string calldata toml, string calldata key) external pure returns (uint256[] memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseTomlUintArray(string,string)\",\n \"selector\": \"0xb5df27c8\",\n \"selectorBytes\": [\n 181,\n 223,\n 39,\n 200\n ]\n },\n \"group\": \"toml\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseToml_0\",\n \"description\": \"ABI-encodes a TOML table.\",\n \"declaration\": \"function parseToml(string calldata toml) external pure returns (bytes memory abiEncodedData);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseToml(string)\",\n \"selector\": \"0x592151f0\",\n \"selectorBytes\": [\n 89,\n 33,\n 81,\n 240\n ]\n },\n \"group\": \"toml\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseToml_1\",\n \"description\": \"ABI-encodes a TOML table at `key`.\",\n \"declaration\": \"function parseToml(string calldata toml, string calldata key) external pure returns (bytes memory abiEncodedData);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseToml(string,string)\",\n \"selector\": \"0x37736e08\",\n \"selectorBytes\": [\n 55,\n 115,\n 110,\n 8\n ]\n },\n \"group\": \"toml\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"parseUint\",\n \"description\": \"Parses the given `string` into a `uint256`.\",\n \"declaration\": \"function parseUint(string calldata stringifiedValue) external pure returns (uint256 parsedValue);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"parseUint(string)\",\n \"selector\": \"0xfa91454d\",\n \"selectorBytes\": [\n 250,\n 145,\n 69,\n 77\n ]\n },\n \"group\": \"string\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"pauseGasMetering\",\n \"description\": \"Pauses gas metering (i.e. gas usage is not counted). Noop if already paused.\",\n \"declaration\": \"function pauseGasMetering() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"pauseGasMetering()\",\n \"selector\": \"0xd1a5b36f\",\n \"selectorBytes\": [\n 209,\n 165,\n 179,\n 111\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"pauseTracing\",\n \"description\": \"Pauses collection of call traces. Useful in cases when you want to skip tracing of\\ncomplex calls which are not useful for debugging.\",\n \"declaration\": \"function pauseTracing() external view;\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"pauseTracing()\",\n \"selector\": \"0xc94d1f90\",\n \"selectorBytes\": [\n 201,\n 77,\n 31,\n 144\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"prank_0\",\n \"description\": \"Sets the *next* call's `msg.sender` to be the input address.\",\n \"declaration\": \"function prank(address msgSender) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"prank(address)\",\n \"selector\": \"0xca669fa7\",\n \"selectorBytes\": [\n 202,\n 102,\n 159,\n 167\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"prank_1\",\n \"description\": \"Sets the *next* call's `msg.sender` to be the input address, and the `tx.origin` to be the second input.\",\n \"declaration\": \"function prank(address msgSender, address txOrigin) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"prank(address,address)\",\n \"selector\": \"0x47e50cce\",\n \"selectorBytes\": [\n 71,\n 229,\n 12,\n 206\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"prank_2\",\n \"description\": \"Sets the *next* delegate call's `msg.sender` to be the input address.\",\n \"declaration\": \"function prank(address msgSender, bool delegateCall) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"prank(address,bool)\",\n \"selector\": \"0xa7f8bf5c\",\n \"selectorBytes\": [\n 167,\n 248,\n 191,\n 92\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"prank_3\",\n \"description\": \"Sets the *next* delegate call's `msg.sender` to be the input address, and the `tx.origin` to be the second input.\",\n \"declaration\": \"function prank(address msgSender, address txOrigin, bool delegateCall) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"prank(address,address,bool)\",\n \"selector\": \"0x7d73d042\",\n \"selectorBytes\": [\n 125,\n 115,\n 208,\n 66\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"prevrandao_0\",\n \"description\": \"Sets `block.prevrandao`.\\nNot available on EVM versions before Paris. Use `difficulty` instead.\\nIf used on unsupported EVM versions it will revert.\",\n \"declaration\": \"function prevrandao(bytes32 newPrevrandao) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"prevrandao(bytes32)\",\n \"selector\": \"0x3b925549\",\n \"selectorBytes\": [\n 59,\n 146,\n 85,\n 73\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"prevrandao_1\",\n \"description\": \"Sets `block.prevrandao`.\\nNot available on EVM versions before Paris. Use `difficulty` instead.\\nIf used on unsupported EVM versions it will revert.\",\n \"declaration\": \"function prevrandao(uint256 newPrevrandao) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"prevrandao(uint256)\",\n \"selector\": \"0x9cb1c0d4\",\n \"selectorBytes\": [\n 156,\n 177,\n 192,\n 212\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"projectRoot\",\n \"description\": \"Get the path of the current project root.\",\n \"declaration\": \"function projectRoot() external view returns (string memory path);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"projectRoot()\",\n \"selector\": \"0xd930a0e6\",\n \"selectorBytes\": [\n 217,\n 48,\n 160,\n 230\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"prompt\",\n \"description\": \"Prompts the user for a string value in the terminal.\",\n \"declaration\": \"function prompt(string calldata promptText) external returns (string memory input);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"prompt(string)\",\n \"selector\": \"0x47eaf474\",\n \"selectorBytes\": [\n 71,\n 234,\n 244,\n 116\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"promptAddress\",\n \"description\": \"Prompts the user for an address in the terminal.\",\n \"declaration\": \"function promptAddress(string calldata promptText) external returns (address);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"promptAddress(string)\",\n \"selector\": \"0x62ee05f4\",\n \"selectorBytes\": [\n 98,\n 238,\n 5,\n 244\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"promptSecret\",\n \"description\": \"Prompts the user for a hidden string value in the terminal.\",\n \"declaration\": \"function promptSecret(string calldata promptText) external returns (string memory input);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"promptSecret(string)\",\n \"selector\": \"0x1e279d41\",\n \"selectorBytes\": [\n 30,\n 39,\n 157,\n 65\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"promptSecretUint\",\n \"description\": \"Prompts the user for hidden uint256 in the terminal (usually pk).\",\n \"declaration\": \"function promptSecretUint(string calldata promptText) external returns (uint256);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"promptSecretUint(string)\",\n \"selector\": \"0x69ca02b7\",\n \"selectorBytes\": [\n 105,\n 202,\n 2,\n 183\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"promptUint\",\n \"description\": \"Prompts the user for uint256 in the terminal.\",\n \"declaration\": \"function promptUint(string calldata promptText) external returns (uint256);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"promptUint(string)\",\n \"selector\": \"0x652fd489\",\n \"selectorBytes\": [\n 101,\n 47,\n 212,\n 137\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"publicKeyEd25519\",\n \"description\": \"Derives the Ed25519 public key from a private key.\",\n \"declaration\": \"function publicKeyEd25519(bytes32 privateKey) external pure returns (bytes32 publicKey);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"publicKeyEd25519(bytes32)\",\n \"selector\": \"0x27f44236\",\n \"selectorBytes\": [\n 39,\n 244,\n 66,\n 54\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"publicKeyP256\",\n \"description\": \"Derives secp256r1 public key from the provided `privateKey`.\",\n \"declaration\": \"function publicKeyP256(uint256 privateKey) external pure returns (uint256 publicKeyX, uint256 publicKeyY);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"publicKeyP256(uint256)\",\n \"selector\": \"0xc453949e\",\n \"selectorBytes\": [\n 196,\n 83,\n 148,\n 158\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"randomAddress\",\n \"description\": \"Returns a random `address`.\",\n \"declaration\": \"function randomAddress() external view returns (address);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"randomAddress()\",\n \"selector\": \"0xd5bee9f5\",\n \"selectorBytes\": [\n 213,\n 190,\n 233,\n 245\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"randomBool\",\n \"description\": \"Returns a random `bool`.\",\n \"declaration\": \"function randomBool() external view returns (bool);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"randomBool()\",\n \"selector\": \"0xcdc126bd\",\n \"selectorBytes\": [\n 205,\n 193,\n 38,\n 189\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"randomBytes\",\n \"description\": \"Returns a random byte array value of the given length.\",\n \"declaration\": \"function randomBytes(uint256 len) external view returns (bytes memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"randomBytes(uint256)\",\n \"selector\": \"0x6c5d32a9\",\n \"selectorBytes\": [\n 108,\n 93,\n 50,\n 169\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"randomBytes4\",\n \"description\": \"Returns a random fixed-size byte array of length 4.\",\n \"declaration\": \"function randomBytes4() external view returns (bytes4);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"randomBytes4()\",\n \"selector\": \"0x9b7cd579\",\n \"selectorBytes\": [\n 155,\n 124,\n 213,\n 121\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"randomBytes8\",\n \"description\": \"Returns a random fixed-size byte array of length 8.\",\n \"declaration\": \"function randomBytes8() external view returns (bytes8);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"randomBytes8()\",\n \"selector\": \"0x0497b0a5\",\n \"selectorBytes\": [\n 4,\n 151,\n 176,\n 165\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"randomInt_0\",\n \"description\": \"Returns a random `int256` value.\",\n \"declaration\": \"function randomInt() external view returns (int256);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"randomInt()\",\n \"selector\": \"0x111f1202\",\n \"selectorBytes\": [\n 17,\n 31,\n 18,\n 2\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"randomInt_1\",\n \"description\": \"Returns a random `int256` value of given bits.\",\n \"declaration\": \"function randomInt(uint256 bits) external view returns (int256);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"randomInt(uint256)\",\n \"selector\": \"0x12845966\",\n \"selectorBytes\": [\n 18,\n 132,\n 89,\n 102\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"randomUint_0\",\n \"description\": \"Returns a random uint256 value.\",\n \"declaration\": \"function randomUint() external view returns (uint256);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"randomUint()\",\n \"selector\": \"0x25124730\",\n \"selectorBytes\": [\n 37,\n 18,\n 71,\n 48\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"randomUint_1\",\n \"description\": \"Returns random uint256 value between the provided range (=min..=max).\",\n \"declaration\": \"function randomUint(uint256 min, uint256 max) external view returns (uint256);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"randomUint(uint256,uint256)\",\n \"selector\": \"0xd61b051b\",\n \"selectorBytes\": [\n 214,\n 27,\n 5,\n 27\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"randomUint_2\",\n \"description\": \"Returns a random `uint256` value of given bits.\",\n \"declaration\": \"function randomUint(uint256 bits) external view returns (uint256);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"randomUint(uint256)\",\n \"selector\": \"0xcf81e69c\",\n \"selectorBytes\": [\n 207,\n 129,\n 230,\n 156\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"readCallers\",\n \"description\": \"Reads the current `msg.sender` and `tx.origin` from state and reports if there is any active caller modification.\",\n \"declaration\": \"function readCallers() external view returns (CallerMode callerMode, address msgSender, address txOrigin);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"readCallers()\",\n \"selector\": \"0x4ad0bac9\",\n \"selectorBytes\": [\n 74,\n 208,\n 186,\n 201\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"readDir_0\",\n \"description\": \"Reads the directory at the given path recursively, up to `maxDepth`.\\n`maxDepth` defaults to 1, meaning only the direct children of the given directory will be returned.\\nFollows symbolic links if `followLinks` is true.\",\n \"declaration\": \"function readDir(string calldata path) external view returns (DirEntry[] memory entries);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"readDir(string)\",\n \"selector\": \"0xc4bc59e0\",\n \"selectorBytes\": [\n 196,\n 188,\n 89,\n 224\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"readDir_1\",\n \"description\": \"See `readDir(string)`.\",\n \"declaration\": \"function readDir(string calldata path, uint64 maxDepth) external view returns (DirEntry[] memory entries);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"readDir(string,uint64)\",\n \"selector\": \"0x1497876c\",\n \"selectorBytes\": [\n 20,\n 151,\n 135,\n 108\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"readDir_2\",\n \"description\": \"See `readDir(string)`.\",\n \"declaration\": \"function readDir(string calldata path, uint64 maxDepth, bool followLinks) external view returns (DirEntry[] memory entries);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"readDir(string,uint64,bool)\",\n \"selector\": \"0x8102d70d\",\n \"selectorBytes\": [\n 129,\n 2,\n 215,\n 13\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"readFile\",\n \"description\": \"Reads the entire content of file to string. `path` is relative to the project root.\",\n \"declaration\": \"function readFile(string calldata path) external view returns (string memory data);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"readFile(string)\",\n \"selector\": \"0x60f9bb11\",\n \"selectorBytes\": [\n 96,\n 249,\n 187,\n 17\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"readFileBinary\",\n \"description\": \"Reads the entire content of file as binary. `path` is relative to the project root.\",\n \"declaration\": \"function readFileBinary(string calldata path) external view returns (bytes memory data);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"readFileBinary(string)\",\n \"selector\": \"0x16ed7bc4\",\n \"selectorBytes\": [\n 22,\n 237,\n 123,\n 196\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"readLine\",\n \"description\": \"Reads next line of file to string.\",\n \"declaration\": \"function readLine(string calldata path) external view returns (string memory line);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"readLine(string)\",\n \"selector\": \"0x70f55728\",\n \"selectorBytes\": [\n 112,\n 245,\n 87,\n 40\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"readLink\",\n \"description\": \"Reads a symbolic link, returning the path that the link points to.\\nThis cheatcode will revert in the following situations, but is not limited to just these cases:\\n- `path` is not a symbolic link.\\n- `path` does not exist.\",\n \"declaration\": \"function readLink(string calldata linkPath) external view returns (string memory targetPath);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"readLink(string)\",\n \"selector\": \"0x9f5684a2\",\n \"selectorBytes\": [\n 159,\n 86,\n 132,\n 162\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"record\",\n \"description\": \"Records all storage reads and writes. Use `accesses` to get the recorded data.\\nSubsequent calls to `record` will clear the previous data.\",\n \"declaration\": \"function record() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"record()\",\n \"selector\": \"0x266cf109\",\n \"selectorBytes\": [\n 38,\n 108,\n 241,\n 9\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"recordLogs\",\n \"description\": \"Record all the transaction logs.\",\n \"declaration\": \"function recordLogs() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"recordLogs()\",\n \"selector\": \"0x41af2f52\",\n \"selectorBytes\": [\n 65,\n 175,\n 47,\n 82\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"rememberKey\",\n \"description\": \"Adds a private key to the local forge wallet and returns the address.\",\n \"declaration\": \"function rememberKey(uint256 privateKey) external returns (address keyAddr);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"rememberKey(uint256)\",\n \"selector\": \"0x22100064\",\n \"selectorBytes\": [\n 34,\n 16,\n 0,\n 100\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"rememberKeys_0\",\n \"description\": \"Derive a set number of wallets from a mnemonic at the derivation path `m/44'/60'/0'/0/{0..count}`.\\nThe respective private keys are saved to the local forge wallet for later use and their addresses are returned.\",\n \"declaration\": \"function rememberKeys(string calldata mnemonic, string calldata derivationPath, uint32 count) external returns (address[] memory keyAddrs);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"rememberKeys(string,string,uint32)\",\n \"selector\": \"0x97cb9189\",\n \"selectorBytes\": [\n 151,\n 203,\n 145,\n 137\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"rememberKeys_1\",\n \"description\": \"Derive a set number of wallets from a mnemonic in the specified language at the derivation path `m/44'/60'/0'/0/{0..count}`.\\nThe respective private keys are saved to the local forge wallet for later use and their addresses are returned.\",\n \"declaration\": \"function rememberKeys(string calldata mnemonic, string calldata derivationPath, string calldata language, uint32 count) external returns (address[] memory keyAddrs);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"rememberKeys(string,string,string,uint32)\",\n \"selector\": \"0xf8d58eaf\",\n \"selectorBytes\": [\n 248,\n 213,\n 142,\n 175\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"removeDir\",\n \"description\": \"Removes a directory at the provided path.\\nThis cheatcode will revert in the following situations, but is not limited to just these cases:\\n- `path` doesn't exist.\\n- `path` isn't a directory.\\n- User lacks permissions to modify `path`.\\n- The directory is not empty and `recursive` is false.\\n`path` is relative to the project root.\",\n \"declaration\": \"function removeDir(string calldata path, bool recursive) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"removeDir(string,bool)\",\n \"selector\": \"0x45c62011\",\n \"selectorBytes\": [\n 69,\n 198,\n 32,\n 17\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"removeFile\",\n \"description\": \"Removes a file from the filesystem.\\nThis cheatcode will revert in the following situations, but is not limited to just these cases:\\n- `path` points to a directory.\\n- The file doesn't exist.\\n- The user lacks permissions to remove the file.\\n`path` is relative to the project root.\",\n \"declaration\": \"function removeFile(string calldata path) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"removeFile(string)\",\n \"selector\": \"0xf1afe04d\",\n \"selectorBytes\": [\n 241,\n 175,\n 224,\n 77\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"replace\",\n \"description\": \"Replaces occurrences of `from` in the given `string` with `to`.\",\n \"declaration\": \"function replace(string calldata input, string calldata from, string calldata to) external pure returns (string memory output);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"replace(string,string,string)\",\n \"selector\": \"0xe00ad03e\",\n \"selectorBytes\": [\n 224,\n 10,\n 208,\n 62\n ]\n },\n \"group\": \"string\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"resetGasMetering\",\n \"description\": \"Reset gas metering (i.e. gas usage is set to gas limit).\",\n \"declaration\": \"function resetGasMetering() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"resetGasMetering()\",\n \"selector\": \"0xbe367dd3\",\n \"selectorBytes\": [\n 190,\n 54,\n 125,\n 211\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"resetNonce\",\n \"description\": \"Resets the nonce of an account to 0 for EOAs and 1 for contract accounts.\",\n \"declaration\": \"function resetNonce(address account) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"resetNonce(address)\",\n \"selector\": \"0x1c72346d\",\n \"selectorBytes\": [\n 28,\n 114,\n 52,\n 109\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"resolveEnv\",\n \"description\": \"Resolves the env variable placeholders of a given input string.\",\n \"declaration\": \"function resolveEnv(string calldata input) external returns (string memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"resolveEnv(string)\",\n \"selector\": \"0xddd2128d\",\n \"selectorBytes\": [\n 221,\n 210,\n 18,\n 141\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"resumeGasMetering\",\n \"description\": \"Resumes gas metering (i.e. gas usage is counted again). Noop if already on.\",\n \"declaration\": \"function resumeGasMetering() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"resumeGasMetering()\",\n \"selector\": \"0x2bcd50e0\",\n \"selectorBytes\": [\n 43,\n 205,\n 80,\n 224\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"resumeTracing\",\n \"description\": \"Unpauses collection of call traces.\",\n \"declaration\": \"function resumeTracing() external view;\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"resumeTracing()\",\n \"selector\": \"0x72a09ccb\",\n \"selectorBytes\": [\n 114,\n 160,\n 156,\n 203\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"revertTo\",\n \"description\": \"`revertTo` is being deprecated in favor of `revertToState`. It will be removed in future versions.\",\n \"declaration\": \"function revertTo(uint256 snapshotId) external returns (bool success);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"revertTo(uint256)\",\n \"selector\": \"0x44d7f0a4\",\n \"selectorBytes\": [\n 68,\n 215,\n 240,\n 164\n ]\n },\n \"group\": \"evm\",\n \"status\": {\n \"deprecated\": \"replaced by `revertToState`\"\n },\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"revertToAndDelete\",\n \"description\": \"`revertToAndDelete` is being deprecated in favor of `revertToStateAndDelete`. It will be removed in future versions.\",\n \"declaration\": \"function revertToAndDelete(uint256 snapshotId) external returns (bool success);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"revertToAndDelete(uint256)\",\n \"selector\": \"0x03e0aca9\",\n \"selectorBytes\": [\n 3,\n 224,\n 172,\n 169\n ]\n },\n \"group\": \"evm\",\n \"status\": {\n \"deprecated\": \"replaced by `revertToStateAndDelete`\"\n },\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"revertToState\",\n \"description\": \"Revert the state of the EVM to a previous snapshot\\nTakes the snapshot ID to revert to.\\nReturns `true` if the snapshot was successfully reverted.\\nReturns `false` if the snapshot does not exist.\\n**Note:** This does not automatically delete the snapshot. To delete the snapshot use `deleteStateSnapshot`.\",\n \"declaration\": \"function revertToState(uint256 snapshotId) external returns (bool success);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"revertToState(uint256)\",\n \"selector\": \"0xc2527405\",\n \"selectorBytes\": [\n 194,\n 82,\n 116,\n 5\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"revertToStateAndDelete\",\n \"description\": \"Revert the state of the EVM to a previous snapshot and automatically deletes the snapshots\\nTakes the snapshot ID to revert to.\\nReturns `true` if the snapshot was successfully reverted and deleted.\\nReturns `false` if the snapshot does not exist.\",\n \"declaration\": \"function revertToStateAndDelete(uint256 snapshotId) external returns (bool success);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"revertToStateAndDelete(uint256)\",\n \"selector\": \"0x3a1985dc\",\n \"selectorBytes\": [\n 58,\n 25,\n 133,\n 220\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"revokePersistent_0\",\n \"description\": \"Revokes persistent status from the address, previously added via `makePersistent`.\",\n \"declaration\": \"function revokePersistent(address account) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"revokePersistent(address)\",\n \"selector\": \"0x997a0222\",\n \"selectorBytes\": [\n 153,\n 122,\n 2,\n 34\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"revokePersistent_1\",\n \"description\": \"See `revokePersistent(address)`.\",\n \"declaration\": \"function revokePersistent(address[] calldata accounts) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"revokePersistent(address[])\",\n \"selector\": \"0x3ce969e6\",\n \"selectorBytes\": [\n 60,\n 233,\n 105,\n 230\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"roll\",\n \"description\": \"Sets `block.height`.\",\n \"declaration\": \"function roll(uint256 newHeight) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"roll(uint256)\",\n \"selector\": \"0x1f7b4f30\",\n \"selectorBytes\": [\n 31,\n 123,\n 79,\n 48\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"rollFork_0\",\n \"description\": \"Updates the currently active fork to given block number\\nThis is similar to `roll` but for the currently active fork.\",\n \"declaration\": \"function rollFork(uint256 blockNumber) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"rollFork(uint256)\",\n \"selector\": \"0xd9bbf3a1\",\n \"selectorBytes\": [\n 217,\n 187,\n 243,\n 161\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"rollFork_1\",\n \"description\": \"Updates the currently active fork to given transaction. This will `rollFork` with the number\\nof the block the transaction was mined in and replays all transaction mined before it in the block.\",\n \"declaration\": \"function rollFork(bytes32 txHash) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"rollFork(bytes32)\",\n \"selector\": \"0x0f29772b\",\n \"selectorBytes\": [\n 15,\n 41,\n 119,\n 43\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"rollFork_2\",\n \"description\": \"Updates the given fork to given block number.\",\n \"declaration\": \"function rollFork(uint256 forkId, uint256 blockNumber) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"rollFork(uint256,uint256)\",\n \"selector\": \"0xd74c83a4\",\n \"selectorBytes\": [\n 215,\n 76,\n 131,\n 164\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"rollFork_3\",\n \"description\": \"Updates the given fork to block number of the given transaction and replays all transaction mined before it in the block.\",\n \"declaration\": \"function rollFork(uint256 forkId, bytes32 txHash) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"rollFork(uint256,bytes32)\",\n \"selector\": \"0xf2830f7b\",\n \"selectorBytes\": [\n 242,\n 131,\n 15,\n 123\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"rpcUrl\",\n \"description\": \"Returns the RPC url for the given alias.\",\n \"declaration\": \"function rpcUrl(string calldata rpcAlias) external view returns (string memory json);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"rpcUrl(string)\",\n \"selector\": \"0x975a6ce9\",\n \"selectorBytes\": [\n 151,\n 90,\n 108,\n 233\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"rpcUrlStructs\",\n \"description\": \"Returns all rpc urls and their aliases as structs.\",\n \"declaration\": \"function rpcUrlStructs() external view returns (Rpc[] memory urls);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"rpcUrlStructs()\",\n \"selector\": \"0x9d2ad72a\",\n \"selectorBytes\": [\n 157,\n 42,\n 215,\n 42\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"rpcUrls\",\n \"description\": \"Returns all rpc urls and their aliases `[alias, url][]`.\",\n \"declaration\": \"function rpcUrls() external view returns (string[2][] memory urls);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"rpcUrls()\",\n \"selector\": \"0xa85a8418\",\n \"selectorBytes\": [\n 168,\n 90,\n 132,\n 24\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"rpc_0\",\n \"description\": \"Performs an Ethereum JSON-RPC request to the current fork URL.\",\n \"declaration\": \"function rpc(string calldata method, string calldata params) external returns (bytes memory data);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"rpc(string,string)\",\n \"selector\": \"0x1206c8a8\",\n \"selectorBytes\": [\n 18,\n 6,\n 200,\n 168\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"rpc_1\",\n \"description\": \"Performs an Ethereum JSON-RPC request to the given endpoint.\",\n \"declaration\": \"function rpc(string calldata urlOrAlias, string calldata method, string calldata params) external returns (bytes memory data);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"rpc(string,string,string)\",\n \"selector\": \"0x0199a220\",\n \"selectorBytes\": [\n 1,\n 153,\n 162,\n 32\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"selectFork\",\n \"description\": \"Takes a fork identifier created by `createFork` and sets the corresponding forked state as active.\",\n \"declaration\": \"function selectFork(uint256 forkId) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"selectFork(uint256)\",\n \"selector\": \"0x9ebf6827\",\n \"selectorBytes\": [\n 158,\n 191,\n 104,\n 39\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"serializeAddress_0\",\n \"description\": \"See `serializeJson`.\",\n \"declaration\": \"function serializeAddress(string calldata objectKey, string calldata valueKey, address value) external returns (string memory json);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"serializeAddress(string,string,address)\",\n \"selector\": \"0x972c6062\",\n \"selectorBytes\": [\n 151,\n 44,\n 96,\n 98\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"serializeAddress_1\",\n \"description\": \"See `serializeJson`.\",\n \"declaration\": \"function serializeAddress(string calldata objectKey, string calldata valueKey, address[] calldata values) external returns (string memory json);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"serializeAddress(string,string,address[])\",\n \"selector\": \"0x1e356e1a\",\n \"selectorBytes\": [\n 30,\n 53,\n 110,\n 26\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"serializeBool_0\",\n \"description\": \"See `serializeJson`.\",\n \"declaration\": \"function serializeBool(string calldata objectKey, string calldata valueKey, bool value) external returns (string memory json);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"serializeBool(string,string,bool)\",\n \"selector\": \"0xac22e971\",\n \"selectorBytes\": [\n 172,\n 34,\n 233,\n 113\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"serializeBool_1\",\n \"description\": \"See `serializeJson`.\",\n \"declaration\": \"function serializeBool(string calldata objectKey, string calldata valueKey, bool[] calldata values) external returns (string memory json);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"serializeBool(string,string,bool[])\",\n \"selector\": \"0x92925aa1\",\n \"selectorBytes\": [\n 146,\n 146,\n 90,\n 161\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"serializeBytes32_0\",\n \"description\": \"See `serializeJson`.\",\n \"declaration\": \"function serializeBytes32(string calldata objectKey, string calldata valueKey, bytes32 value) external returns (string memory json);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"serializeBytes32(string,string,bytes32)\",\n \"selector\": \"0x2d812b44\",\n \"selectorBytes\": [\n 45,\n 129,\n 43,\n 68\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"serializeBytes32_1\",\n \"description\": \"See `serializeJson`.\",\n \"declaration\": \"function serializeBytes32(string calldata objectKey, string calldata valueKey, bytes32[] calldata values) external returns (string memory json);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"serializeBytes32(string,string,bytes32[])\",\n \"selector\": \"0x201e43e2\",\n \"selectorBytes\": [\n 32,\n 30,\n 67,\n 226\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"serializeBytes_0\",\n \"description\": \"See `serializeJson`.\",\n \"declaration\": \"function serializeBytes(string calldata objectKey, string calldata valueKey, bytes calldata value) external returns (string memory json);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"serializeBytes(string,string,bytes)\",\n \"selector\": \"0xf21d52c7\",\n \"selectorBytes\": [\n 242,\n 29,\n 82,\n 199\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"serializeBytes_1\",\n \"description\": \"See `serializeJson`.\",\n \"declaration\": \"function serializeBytes(string calldata objectKey, string calldata valueKey, bytes[] calldata values) external returns (string memory json);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"serializeBytes(string,string,bytes[])\",\n \"selector\": \"0x9884b232\",\n \"selectorBytes\": [\n 152,\n 132,\n 178,\n 50\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"serializeInt_0\",\n \"description\": \"See `serializeJson`.\",\n \"declaration\": \"function serializeInt(string calldata objectKey, string calldata valueKey, int256 value) external returns (string memory json);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"serializeInt(string,string,int256)\",\n \"selector\": \"0x3f33db60\",\n \"selectorBytes\": [\n 63,\n 51,\n 219,\n 96\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"serializeInt_1\",\n \"description\": \"See `serializeJson`.\",\n \"declaration\": \"function serializeInt(string calldata objectKey, string calldata valueKey, int256[] calldata values) external returns (string memory json);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"serializeInt(string,string,int256[])\",\n \"selector\": \"0x7676e127\",\n \"selectorBytes\": [\n 118,\n 118,\n 225,\n 39\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"serializeJson\",\n \"description\": \"Serializes a key and value to a JSON object stored in-memory that can be later written to a file.\\nReturns the stringified version of the specific JSON file up to that moment.\",\n \"declaration\": \"function serializeJson(string calldata objectKey, string calldata value) external returns (string memory json);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"serializeJson(string,string)\",\n \"selector\": \"0x9b3358b0\",\n \"selectorBytes\": [\n 155,\n 51,\n 88,\n 176\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"serializeJsonType_0\",\n \"description\": \"See `serializeJson`.\",\n \"declaration\": \"function serializeJsonType(string calldata typeDescription, bytes calldata value) external pure returns (string memory json);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"serializeJsonType(string,bytes)\",\n \"selector\": \"0x6d4f96a6\",\n \"selectorBytes\": [\n 109,\n 79,\n 150,\n 166\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"serializeJsonType_1\",\n \"description\": \"See `serializeJson`.\",\n \"declaration\": \"function serializeJsonType(string calldata objectKey, string calldata valueKey, string calldata typeDescription, bytes calldata value) external returns (string memory json);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"serializeJsonType(string,string,string,bytes)\",\n \"selector\": \"0x6f93bccb\",\n \"selectorBytes\": [\n 111,\n 147,\n 188,\n 203\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"serializeString_0\",\n \"description\": \"See `serializeJson`.\",\n \"declaration\": \"function serializeString(string calldata objectKey, string calldata valueKey, string calldata value) external returns (string memory json);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"serializeString(string,string,string)\",\n \"selector\": \"0x88da6d35\",\n \"selectorBytes\": [\n 136,\n 218,\n 109,\n 53\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"serializeString_1\",\n \"description\": \"See `serializeJson`.\",\n \"declaration\": \"function serializeString(string calldata objectKey, string calldata valueKey, string[] calldata values) external returns (string memory json);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"serializeString(string,string,string[])\",\n \"selector\": \"0x561cd6f3\",\n \"selectorBytes\": [\n 86,\n 28,\n 214,\n 243\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"serializeUintToHex\",\n \"description\": \"See `serializeJson`.\",\n \"declaration\": \"function serializeUintToHex(string calldata objectKey, string calldata valueKey, uint256 value) external returns (string memory json);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"serializeUintToHex(string,string,uint256)\",\n \"selector\": \"0xae5a2ae8\",\n \"selectorBytes\": [\n 174,\n 90,\n 42,\n 232\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"serializeUint_0\",\n \"description\": \"See `serializeJson`.\",\n \"declaration\": \"function serializeUint(string calldata objectKey, string calldata valueKey, uint256 value) external returns (string memory json);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"serializeUint(string,string,uint256)\",\n \"selector\": \"0x129e9002\",\n \"selectorBytes\": [\n 18,\n 158,\n 144,\n 2\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"serializeUint_1\",\n \"description\": \"See `serializeJson`.\",\n \"declaration\": \"function serializeUint(string calldata objectKey, string calldata valueKey, uint256[] calldata values) external returns (string memory json);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"serializeUint(string,string,uint256[])\",\n \"selector\": \"0xfee9a469\",\n \"selectorBytes\": [\n 254,\n 233,\n 164,\n 105\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"setArbitraryStorage_0\",\n \"description\": \"Utility cheatcode to set arbitrary storage for given target address.\",\n \"declaration\": \"function setArbitraryStorage(address target) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"setArbitraryStorage(address)\",\n \"selector\": \"0xe1631837\",\n \"selectorBytes\": [\n 225,\n 99,\n 24,\n 55\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"setArbitraryStorage_1\",\n \"description\": \"Utility cheatcode to set arbitrary storage for given target address and overwrite\\nany storage slots that have been previously set.\",\n \"declaration\": \"function setArbitraryStorage(address target, bool overwrite) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"setArbitraryStorage(address,bool)\",\n \"selector\": \"0xd3ec2a0b\",\n \"selectorBytes\": [\n 211,\n 236,\n 42,\n 11\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"setBlockhash\",\n \"description\": \"Set blockhash for the current block.\\nIt only sets the blockhash for blocks where `block.number - 256 <= number < block.number`.\",\n \"declaration\": \"function setBlockhash(uint256 blockNumber, bytes32 blockHash) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"setBlockhash(uint256,bytes32)\",\n \"selector\": \"0x5314b54a\",\n \"selectorBytes\": [\n 83,\n 20,\n 181,\n 74\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"setEnv\",\n \"description\": \"Sets environment variables.\",\n \"declaration\": \"function setEnv(string calldata name, string calldata value) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"setEnv(string,string)\",\n \"selector\": \"0x3d5923ee\",\n \"selectorBytes\": [\n 61,\n 89,\n 35,\n 238\n ]\n },\n \"group\": \"environment\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"setEvmVersion\",\n \"description\": \"Set the exact test or script execution evm version, e.g. `berlin`, `cancun`.\\n**Note:** The execution evm version is not the same as the compilation one.\",\n \"declaration\": \"function setEvmVersion(string calldata evm) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"setEvmVersion(string)\",\n \"selector\": \"0x43179f5a\",\n \"selectorBytes\": [\n 67,\n 23,\n 159,\n 90\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"setNonce\",\n \"description\": \"Sets the nonce of an account. Must be higher than the current nonce of the account.\",\n \"declaration\": \"function setNonce(address account, uint64 newNonce) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"setNonce(address,uint64)\",\n \"selector\": \"0xf8e18b57\",\n \"selectorBytes\": [\n 248,\n 225,\n 139,\n 87\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"setNonceUnsafe\",\n \"description\": \"Sets the nonce of an account to an arbitrary value.\",\n \"declaration\": \"function setNonceUnsafe(address account, uint64 newNonce) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"setNonceUnsafe(address,uint64)\",\n \"selector\": \"0x9b67b21c\",\n \"selectorBytes\": [\n 155,\n 103,\n 178,\n 28\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"setSeed\",\n \"description\": \"Set RNG seed.\",\n \"declaration\": \"function setSeed(uint256 seed) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"setSeed(uint256)\",\n \"selector\": \"0xc32a50f9\",\n \"selectorBytes\": [\n 195,\n 42,\n 80,\n 249\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"shuffle\",\n \"description\": \"Randomly shuffles an array.\",\n \"declaration\": \"function shuffle(uint256[] calldata array) external returns (uint256[] memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"shuffle(uint256[])\",\n \"selector\": \"0x54f1469c\",\n \"selectorBytes\": [\n 84,\n 241,\n 70,\n 156\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"signAndAttachDelegation_0\",\n \"description\": \"Sign an EIP-7702 authorization and designate the next call as an EIP-7702 transaction\",\n \"declaration\": \"function signAndAttachDelegation(address implementation, uint256 privateKey) external returns (SignedDelegation memory signedDelegation);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"signAndAttachDelegation(address,uint256)\",\n \"selector\": \"0xc7fa7288\",\n \"selectorBytes\": [\n 199,\n 250,\n 114,\n 136\n ]\n },\n \"group\": \"scripting\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"signAndAttachDelegation_1\",\n \"description\": \"Sign an EIP-7702 authorization and designate the next call as an EIP-7702 transaction for specific nonce\",\n \"declaration\": \"function signAndAttachDelegation(address implementation, uint256 privateKey, uint64 nonce) external returns (SignedDelegation memory signedDelegation);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"signAndAttachDelegation(address,uint256,uint64)\",\n \"selector\": \"0xcde3e5be\",\n \"selectorBytes\": [\n 205,\n 227,\n 229,\n 190\n ]\n },\n \"group\": \"scripting\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"signAndAttachDelegation_2\",\n \"description\": \"Sign an EIP-7702 authorization and designate the next call as an EIP-7702 transaction, with optional cross-chain validity.\",\n \"declaration\": \"function signAndAttachDelegation(address implementation, uint256 privateKey, bool crossChain) external returns (SignedDelegation memory signedDelegation);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"signAndAttachDelegation(address,uint256,bool)\",\n \"selector\": \"0xd936e146\",\n \"selectorBytes\": [\n 217,\n 54,\n 225,\n 70\n ]\n },\n \"group\": \"scripting\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"signCompact_0\",\n \"description\": \"Signs data with a `Wallet`.\\nReturns a compact signature (`r`, `vs`) as per EIP-2098, where `vs` encodes both the\\nsignature's `s` value, and the recovery id `v` in a single bytes32.\\nThis format reduces the signature size from 65 to 64 bytes.\",\n \"declaration\": \"function signCompact(Wallet calldata wallet, bytes32 digest) external pure returns (bytes32 r, bytes32 vs);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"signCompact((address,uint256,uint256,uint256),bytes32)\",\n \"selector\": \"0x3d0e292f\",\n \"selectorBytes\": [\n 61,\n 14,\n 41,\n 47\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"signCompact_1\",\n \"description\": \"Signs `digest` with `privateKey` using the secp256k1 curve.\\nReturns a compact signature (`r`, `vs`) as per EIP-2098, where `vs` encodes both the\\nsignature's `s` value, and the recovery id `v` in a single bytes32.\\nThis format reduces the signature size from 65 to 64 bytes.\",\n \"declaration\": \"function signCompact(uint256 privateKey, bytes32 digest) external pure returns (bytes32 r, bytes32 vs);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"signCompact(uint256,bytes32)\",\n \"selector\": \"0xcc2a781f\",\n \"selectorBytes\": [\n 204,\n 42,\n 120,\n 31\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"signCompact_2\",\n \"description\": \"Signs `digest` with signer provided to script using the secp256k1 curve.\\nReturns a compact signature (`r`, `vs`) as per EIP-2098, where `vs` encodes both the\\nsignature's `s` value, and the recovery id `v` in a single bytes32.\\nThis format reduces the signature size from 65 to 64 bytes.\\nIf `--sender` is provided, the signer with provided address is used, otherwise,\\nif exactly one signer is provided to the script, that signer is used.\\nRaises error if signer passed through `--sender` does not match any unlocked signers or\\nif `--sender` is not provided and not exactly one signer is passed to the script.\",\n \"declaration\": \"function signCompact(bytes32 digest) external pure returns (bytes32 r, bytes32 vs);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"signCompact(bytes32)\",\n \"selector\": \"0xa282dc4b\",\n \"selectorBytes\": [\n 162,\n 130,\n 220,\n 75\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"signCompact_3\",\n \"description\": \"Signs `digest` with signer provided to script using the secp256k1 curve.\\nReturns a compact signature (`r`, `vs`) as per EIP-2098, where `vs` encodes both the\\nsignature's `s` value, and the recovery id `v` in a single bytes32.\\nThis format reduces the signature size from 65 to 64 bytes.\\nRaises error if none of the signers passed into the script have provided address.\",\n \"declaration\": \"function signCompact(address signer, bytes32 digest) external pure returns (bytes32 r, bytes32 vs);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"signCompact(address,bytes32)\",\n \"selector\": \"0x8e2f97bf\",\n \"selectorBytes\": [\n 142,\n 47,\n 151,\n 191\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"signDelegation_0\",\n \"description\": \"Sign an EIP-7702 authorization for delegation\",\n \"declaration\": \"function signDelegation(address implementation, uint256 privateKey) external returns (SignedDelegation memory signedDelegation);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"signDelegation(address,uint256)\",\n \"selector\": \"0x5b593c7b\",\n \"selectorBytes\": [\n 91,\n 89,\n 60,\n 123\n ]\n },\n \"group\": \"scripting\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"signDelegation_1\",\n \"description\": \"Sign an EIP-7702 authorization for delegation for specific nonce\",\n \"declaration\": \"function signDelegation(address implementation, uint256 privateKey, uint64 nonce) external returns (SignedDelegation memory signedDelegation);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"signDelegation(address,uint256,uint64)\",\n \"selector\": \"0xceba2ec3\",\n \"selectorBytes\": [\n 206,\n 186,\n 46,\n 195\n ]\n },\n \"group\": \"scripting\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"signDelegation_2\",\n \"description\": \"Sign an EIP-7702 authorization for delegation, with optional cross-chain validity.\",\n \"declaration\": \"function signDelegation(address implementation, uint256 privateKey, bool crossChain) external returns (SignedDelegation memory signedDelegation);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"signDelegation(address,uint256,bool)\",\n \"selector\": \"0xcdd7563d\",\n \"selectorBytes\": [\n 205,\n 215,\n 86,\n 61\n ]\n },\n \"group\": \"scripting\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"signEd25519\",\n \"description\": \"Signs a message with namespace using Ed25519.\\nThe signature covers namespace || message for domain separation.\\nReturns a 64-byte Ed25519 signature.\",\n \"declaration\": \"function signEd25519(bytes calldata namespace, bytes calldata message, bytes32 privateKey) external pure returns (bytes memory signature);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"signEd25519(bytes,bytes,bytes32)\",\n \"selector\": \"0xef609c65\",\n \"selectorBytes\": [\n 239,\n 96,\n 156,\n 101\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"signP256\",\n \"description\": \"Signs `digest` with `privateKey` using the secp256r1 curve.\",\n \"declaration\": \"function signP256(uint256 privateKey, bytes32 digest) external pure returns (bytes32 r, bytes32 s);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"signP256(uint256,bytes32)\",\n \"selector\": \"0x83211b40\",\n \"selectorBytes\": [\n 131,\n 33,\n 27,\n 64\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"signWithNonceUnsafe\",\n \"description\": \"Signs `digest` with `privateKey` on the secp256k1 curve, using the given `nonce`\\nas the raw ephemeral k value in ECDSA (instead of deriving it deterministically).\",\n \"declaration\": \"function signWithNonceUnsafe(uint256 privateKey, bytes32 digest, uint256 nonce) external pure returns (uint8 v, bytes32 r, bytes32 s);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"signWithNonceUnsafe(uint256,bytes32,uint256)\",\n \"selector\": \"0x2012783a\",\n \"selectorBytes\": [\n 32,\n 18,\n 120,\n 58\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"sign_0\",\n \"description\": \"Signs data with a `Wallet`.\",\n \"declaration\": \"function sign(Wallet calldata wallet, bytes32 digest) external pure returns (uint8 v, bytes32 r, bytes32 s);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"sign((address,uint256,uint256,uint256),bytes32)\",\n \"selector\": \"0xb25c5a25\",\n \"selectorBytes\": [\n 178,\n 92,\n 90,\n 37\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"sign_1\",\n \"description\": \"Signs `digest` with `privateKey` using the secp256k1 curve.\",\n \"declaration\": \"function sign(uint256 privateKey, bytes32 digest) external pure returns (uint8 v, bytes32 r, bytes32 s);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"sign(uint256,bytes32)\",\n \"selector\": \"0xe341eaa4\",\n \"selectorBytes\": [\n 227,\n 65,\n 234,\n 164\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"sign_2\",\n \"description\": \"Signs `digest` with signer provided to script using the secp256k1 curve.\\nIf `--sender` is provided, the signer with provided address is used, otherwise,\\nif exactly one signer is provided to the script, that signer is used.\\nRaises error if signer passed through `--sender` does not match any unlocked signers or\\nif `--sender` is not provided and not exactly one signer is passed to the script.\",\n \"declaration\": \"function sign(bytes32 digest) external pure returns (uint8 v, bytes32 r, bytes32 s);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"sign(bytes32)\",\n \"selector\": \"0x799cd333\",\n \"selectorBytes\": [\n 121,\n 156,\n 211,\n 51\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"sign_3\",\n \"description\": \"Signs `digest` with signer provided to script using the secp256k1 curve.\\nRaises error if none of the signers passed into the script have provided address.\",\n \"declaration\": \"function sign(address signer, bytes32 digest) external pure returns (uint8 v, bytes32 r, bytes32 s);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"sign(address,bytes32)\",\n \"selector\": \"0x8c1aa205\",\n \"selectorBytes\": [\n 140,\n 26,\n 162,\n 5\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"skip_0\",\n \"description\": \"Marks a test as skipped. Must be called at the top level of a test.\",\n \"declaration\": \"function skip(bool skipTest) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"skip(bool)\",\n \"selector\": \"0xdd82d13e\",\n \"selectorBytes\": [\n 221,\n 130,\n 209,\n 62\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"skip_1\",\n \"description\": \"Marks a test as skipped with a reason. Must be called at the top level of a test.\",\n \"declaration\": \"function skip(bool skipTest, string calldata reason) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"skip(bool,string)\",\n \"selector\": \"0xc42a80a7\",\n \"selectorBytes\": [\n 196,\n 42,\n 128,\n 167\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"sleep\",\n \"description\": \"Suspends execution of the main thread for `duration` milliseconds.\",\n \"declaration\": \"function sleep(uint256 duration) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"sleep(uint256)\",\n \"selector\": \"0xfa9d8713\",\n \"selectorBytes\": [\n 250,\n 157,\n 135,\n 19\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"snapshot\",\n \"description\": \"`snapshot` is being deprecated in favor of `snapshotState`. It will be removed in future versions.\",\n \"declaration\": \"function snapshot() external returns (uint256 snapshotId);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"snapshot()\",\n \"selector\": \"0x9711715a\",\n \"selectorBytes\": [\n 151,\n 17,\n 113,\n 90\n ]\n },\n \"group\": \"evm\",\n \"status\": {\n \"deprecated\": \"replaced by `snapshotState`\"\n },\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"snapshotGasLastCall_0\",\n \"description\": \"Snapshot capture the gas usage of the last call by name from the callee perspective.\",\n \"declaration\": \"function snapshotGasLastCall(string calldata name) external returns (uint256 gasUsed);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"snapshotGasLastCall(string)\",\n \"selector\": \"0xdd9fca12\",\n \"selectorBytes\": [\n 221,\n 159,\n 202,\n 18\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"snapshotGasLastCall_1\",\n \"description\": \"Snapshot capture the gas usage of the last call by name in a group from the callee perspective.\",\n \"declaration\": \"function snapshotGasLastCall(string calldata group, string calldata name) external returns (uint256 gasUsed);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"snapshotGasLastCall(string,string)\",\n \"selector\": \"0x200c6772\",\n \"selectorBytes\": [\n 32,\n 12,\n 103,\n 114\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"snapshotState\",\n \"description\": \"Snapshot the current state of the evm.\\nReturns the ID of the snapshot that was created.\\nTo revert a snapshot use `revertToState`.\",\n \"declaration\": \"function snapshotState() external returns (uint256 snapshotId);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"snapshotState()\",\n \"selector\": \"0x9cd23835\",\n \"selectorBytes\": [\n 156,\n 210,\n 56,\n 53\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"snapshotValue_0\",\n \"description\": \"Snapshot capture an arbitrary numerical value by name.\\nThe group name is derived from the contract name.\",\n \"declaration\": \"function snapshotValue(string calldata name, uint256 value) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"snapshotValue(string,uint256)\",\n \"selector\": \"0x51db805a\",\n \"selectorBytes\": [\n 81,\n 219,\n 128,\n 90\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"snapshotValue_1\",\n \"description\": \"Snapshot capture an arbitrary numerical value by name in a group.\",\n \"declaration\": \"function snapshotValue(string calldata group, string calldata name, uint256 value) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"snapshotValue(string,string,uint256)\",\n \"selector\": \"0x6d2b27d8\",\n \"selectorBytes\": [\n 109,\n 43,\n 39,\n 216\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"sort\",\n \"description\": \"Sorts an array in ascending order.\",\n \"declaration\": \"function sort(uint256[] calldata array) external returns (uint256[] memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"sort(uint256[])\",\n \"selector\": \"0x9ec8b026\",\n \"selectorBytes\": [\n 158,\n 200,\n 176,\n 38\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"split\",\n \"description\": \"Splits the given `string` into an array of strings divided by the `delimiter`.\",\n \"declaration\": \"function split(string calldata input, string calldata delimiter) external pure returns (string[] memory outputs);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"split(string,string)\",\n \"selector\": \"0x8bb75533\",\n \"selectorBytes\": [\n 139,\n 183,\n 85,\n 51\n ]\n },\n \"group\": \"string\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"startBroadcast_0\",\n \"description\": \"Has all subsequent calls (at this call depth only) create transactions that can later be signed and sent onchain.\\nBroadcasting address is determined by checking the following in order:\\n1. If `--sender` argument was provided, that address is used.\\n2. If exactly one signer (e.g. private key, hw wallet, keystore) is set when `forge broadcast` is invoked, that signer is used.\\n3. Otherwise, default foundry sender (1804c8AB1F12E6bbf3894d4083f33e07309d1f38) is used.\",\n \"declaration\": \"function startBroadcast() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"startBroadcast()\",\n \"selector\": \"0x7fb5297f\",\n \"selectorBytes\": [\n 127,\n 181,\n 41,\n 127\n ]\n },\n \"group\": \"scripting\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"startBroadcast_1\",\n \"description\": \"Has all subsequent calls (at this call depth only) create transactions with the address\\nprovided that can later be signed and sent onchain.\",\n \"declaration\": \"function startBroadcast(address signer) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"startBroadcast(address)\",\n \"selector\": \"0x7fec2a8d\",\n \"selectorBytes\": [\n 127,\n 236,\n 42,\n 141\n ]\n },\n \"group\": \"scripting\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"startBroadcast_2\",\n \"description\": \"Has all subsequent calls (at this call depth only) create transactions with the private key\\nprovided that can later be signed and sent onchain.\",\n \"declaration\": \"function startBroadcast(uint256 privateKey) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"startBroadcast(uint256)\",\n \"selector\": \"0xce817d47\",\n \"selectorBytes\": [\n 206,\n 129,\n 125,\n 71\n ]\n },\n \"group\": \"scripting\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"startDebugTraceRecording\",\n \"description\": \"Records the debug trace during the run.\",\n \"declaration\": \"function startDebugTraceRecording() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"startDebugTraceRecording()\",\n \"selector\": \"0x419c8832\",\n \"selectorBytes\": [\n 65,\n 156,\n 136,\n 50\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"startMappingRecording\",\n \"description\": \"Starts recording all map SSTOREs for later retrieval.\",\n \"declaration\": \"function startMappingRecording() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"startMappingRecording()\",\n \"selector\": \"0x3e9705c0\",\n \"selectorBytes\": [\n 62,\n 151,\n 5,\n 192\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"startPrank_0\",\n \"description\": \"Sets all subsequent calls' `msg.sender` to be the input address until `stopPrank` is called.\",\n \"declaration\": \"function startPrank(address msgSender) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"startPrank(address)\",\n \"selector\": \"0x06447d56\",\n \"selectorBytes\": [\n 6,\n 68,\n 125,\n 86\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"startPrank_1\",\n \"description\": \"Sets all subsequent calls' `msg.sender` to be the input address until `stopPrank` is called, and the `tx.origin` to be the second input.\",\n \"declaration\": \"function startPrank(address msgSender, address txOrigin) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"startPrank(address,address)\",\n \"selector\": \"0x45b56078\",\n \"selectorBytes\": [\n 69,\n 181,\n 96,\n 120\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"startPrank_2\",\n \"description\": \"Sets all subsequent delegate calls' `msg.sender` to be the input address until `stopPrank` is called.\",\n \"declaration\": \"function startPrank(address msgSender, bool delegateCall) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"startPrank(address,bool)\",\n \"selector\": \"0x1cc0b435\",\n \"selectorBytes\": [\n 28,\n 192,\n 180,\n 53\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"startPrank_3\",\n \"description\": \"Sets all subsequent delegate calls' `msg.sender` to be the input address until `stopPrank` is called, and the `tx.origin` to be the second input.\",\n \"declaration\": \"function startPrank(address msgSender, address txOrigin, bool delegateCall) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"startPrank(address,address,bool)\",\n \"selector\": \"0x4eb859b5\",\n \"selectorBytes\": [\n 78,\n 184,\n 89,\n 181\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"startSnapshotGas_0\",\n \"description\": \"Start a snapshot capture of the current gas usage by name.\\nThe group name is derived from the contract name.\",\n \"declaration\": \"function startSnapshotGas(string calldata name) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"startSnapshotGas(string)\",\n \"selector\": \"0x3cad9d7b\",\n \"selectorBytes\": [\n 60,\n 173,\n 157,\n 123\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"startSnapshotGas_1\",\n \"description\": \"Start a snapshot capture of the current gas usage by name in a group.\",\n \"declaration\": \"function startSnapshotGas(string calldata group, string calldata name) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"startSnapshotGas(string,string)\",\n \"selector\": \"0x6cd0cc53\",\n \"selectorBytes\": [\n 108,\n 208,\n 204,\n 83\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"startStateDiffRecording\",\n \"description\": \"Record all account accesses as part of CREATE, CALL or SELFDESTRUCT opcodes in order,\\nalong with the context of the calls\",\n \"declaration\": \"function startStateDiffRecording() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"startStateDiffRecording()\",\n \"selector\": \"0xcf22e3c9\",\n \"selectorBytes\": [\n 207,\n 34,\n 227,\n 201\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"stopAndReturnDebugTraceRecording\",\n \"description\": \"Stop debug trace recording and returns the recorded debug trace.\",\n \"declaration\": \"function stopAndReturnDebugTraceRecording() external returns (DebugStep[] memory step);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"stopAndReturnDebugTraceRecording()\",\n \"selector\": \"0xced398a2\",\n \"selectorBytes\": [\n 206,\n 211,\n 152,\n 162\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"stopAndReturnStateDiff\",\n \"description\": \"Returns an ordered array of all account accesses from a `vm.startStateDiffRecording` session.\",\n \"declaration\": \"function stopAndReturnStateDiff() external returns (AccountAccess[] memory accountAccesses);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"stopAndReturnStateDiff()\",\n \"selector\": \"0xaa5cf90e\",\n \"selectorBytes\": [\n 170,\n 92,\n 249,\n 14\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"stopBroadcast\",\n \"description\": \"Stops collecting onchain transactions.\",\n \"declaration\": \"function stopBroadcast() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"stopBroadcast()\",\n \"selector\": \"0x76eadd36\",\n \"selectorBytes\": [\n 118,\n 234,\n 221,\n 54\n ]\n },\n \"group\": \"scripting\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"stopExpectSafeMemory\",\n \"description\": \"Stops all safe memory expectation in the current subcontext.\",\n \"declaration\": \"function stopExpectSafeMemory() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"stopExpectSafeMemory()\",\n \"selector\": \"0x0956441b\",\n \"selectorBytes\": [\n 9,\n 86,\n 68,\n 27\n ]\n },\n \"group\": \"testing\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"stopMappingRecording\",\n \"description\": \"Stops recording all map SSTOREs for later retrieval and clears the recorded data.\",\n \"declaration\": \"function stopMappingRecording() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"stopMappingRecording()\",\n \"selector\": \"0x0d4aae9b\",\n \"selectorBytes\": [\n 13,\n 74,\n 174,\n 155\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"stopPrank\",\n \"description\": \"Resets subsequent calls' `msg.sender` to be `address(this)`.\",\n \"declaration\": \"function stopPrank() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"stopPrank()\",\n \"selector\": \"0x90c5013b\",\n \"selectorBytes\": [\n 144,\n 197,\n 1,\n 59\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"stopRecord\",\n \"description\": \"Stops recording storage reads and writes.\",\n \"declaration\": \"function stopRecord() external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"stopRecord()\",\n \"selector\": \"0x996be76d\",\n \"selectorBytes\": [\n 153,\n 107,\n 231,\n 109\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"stopSnapshotGas_0\",\n \"description\": \"Stop the snapshot capture of the current gas by latest snapshot name, capturing the gas used since the start.\",\n \"declaration\": \"function stopSnapshotGas() external returns (uint256 gasUsed);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"stopSnapshotGas()\",\n \"selector\": \"0xf6402eda\",\n \"selectorBytes\": [\n 246,\n 64,\n 46,\n 218\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"stopSnapshotGas_1\",\n \"description\": \"Stop the snapshot capture of the current gas usage by name, capturing the gas used since the start.\\nThe group name is derived from the contract name.\",\n \"declaration\": \"function stopSnapshotGas(string calldata name) external returns (uint256 gasUsed);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"stopSnapshotGas(string)\",\n \"selector\": \"0x773b2805\",\n \"selectorBytes\": [\n 119,\n 59,\n 40,\n 5\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"stopSnapshotGas_2\",\n \"description\": \"Stop the snapshot capture of the current gas usage by name in a group, capturing the gas used since the start.\",\n \"declaration\": \"function stopSnapshotGas(string calldata group, string calldata name) external returns (uint256 gasUsed);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"stopSnapshotGas(string,string)\",\n \"selector\": \"0x0c9db707\",\n \"selectorBytes\": [\n 12,\n 157,\n 183,\n 7\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"store\",\n \"description\": \"Stores a value to an address' storage slot.\",\n \"declaration\": \"function store(address target, bytes32 slot, bytes32 value) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"store(address,bytes32,bytes32)\",\n \"selector\": \"0x70ca10bb\",\n \"selectorBytes\": [\n 112,\n 202,\n 16,\n 187\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"toBase64URL_0\",\n \"description\": \"Encodes a `bytes` value to a base64url string.\",\n \"declaration\": \"function toBase64URL(bytes calldata data) external pure returns (string memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"toBase64URL(bytes)\",\n \"selector\": \"0xc8bd0e4a\",\n \"selectorBytes\": [\n 200,\n 189,\n 14,\n 74\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"toBase64URL_1\",\n \"description\": \"Encodes a `string` value to a base64url string.\",\n \"declaration\": \"function toBase64URL(string calldata data) external pure returns (string memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"toBase64URL(string)\",\n \"selector\": \"0xae3165b3\",\n \"selectorBytes\": [\n 174,\n 49,\n 101,\n 179\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"toBase64_0\",\n \"description\": \"Encodes a `bytes` value to a base64 string.\",\n \"declaration\": \"function toBase64(bytes calldata data) external pure returns (string memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"toBase64(bytes)\",\n \"selector\": \"0xa5cbfe65\",\n \"selectorBytes\": [\n 165,\n 203,\n 254,\n 101\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"toBase64_1\",\n \"description\": \"Encodes a `string` value to a base64 string.\",\n \"declaration\": \"function toBase64(string calldata data) external pure returns (string memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"toBase64(string)\",\n \"selector\": \"0x3f8be2c8\",\n \"selectorBytes\": [\n 63,\n 139,\n 226,\n 200\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"toLowercase\",\n \"description\": \"Converts the given `string` value to Lowercase.\",\n \"declaration\": \"function toLowercase(string calldata input) external pure returns (string memory output);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"toLowercase(string)\",\n \"selector\": \"0x50bb0884\",\n \"selectorBytes\": [\n 80,\n 187,\n 8,\n 132\n ]\n },\n \"group\": \"string\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"toRlp\",\n \"description\": \"RLP encodes a list of bytes into an RLP payload.\",\n \"declaration\": \"function toRlp(bytes[] calldata data) external pure returns (bytes memory);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"toRlp(bytes[])\",\n \"selector\": \"0xa7ed3885\",\n \"selectorBytes\": [\n 167,\n 237,\n 56,\n 133\n ]\n },\n \"group\": \"utilities\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"toString_0\",\n \"description\": \"Converts the given value to a `string`.\",\n \"declaration\": \"function toString(address value) external pure returns (string memory stringifiedValue);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"toString(address)\",\n \"selector\": \"0x56ca623e\",\n \"selectorBytes\": [\n 86,\n 202,\n 98,\n 62\n ]\n },\n \"group\": \"string\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"toString_1\",\n \"description\": \"Converts the given value to a `string`.\",\n \"declaration\": \"function toString(bytes calldata value) external pure returns (string memory stringifiedValue);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"toString(bytes)\",\n \"selector\": \"0x71aad10d\",\n \"selectorBytes\": [\n 113,\n 170,\n 209,\n 13\n ]\n },\n \"group\": \"string\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"toString_2\",\n \"description\": \"Converts the given value to a `string`.\",\n \"declaration\": \"function toString(bytes32 value) external pure returns (string memory stringifiedValue);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"toString(bytes32)\",\n \"selector\": \"0xb11a19e8\",\n \"selectorBytes\": [\n 177,\n 26,\n 25,\n 232\n ]\n },\n \"group\": \"string\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"toString_3\",\n \"description\": \"Converts the given value to a `string`.\",\n \"declaration\": \"function toString(bool value) external pure returns (string memory stringifiedValue);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"toString(bool)\",\n \"selector\": \"0x71dce7da\",\n \"selectorBytes\": [\n 113,\n 220,\n 231,\n 218\n ]\n },\n \"group\": \"string\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"toString_4\",\n \"description\": \"Converts the given value to a `string`.\",\n \"declaration\": \"function toString(uint256 value) external pure returns (string memory stringifiedValue);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"toString(uint256)\",\n \"selector\": \"0x6900a3ae\",\n \"selectorBytes\": [\n 105,\n 0,\n 163,\n 174\n ]\n },\n \"group\": \"string\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"toString_5\",\n \"description\": \"Converts the given value to a `string`.\",\n \"declaration\": \"function toString(int256 value) external pure returns (string memory stringifiedValue);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"toString(int256)\",\n \"selector\": \"0xa322c40e\",\n \"selectorBytes\": [\n 163,\n 34,\n 196,\n 14\n ]\n },\n \"group\": \"string\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"toUppercase\",\n \"description\": \"Converts the given `string` value to Uppercase.\",\n \"declaration\": \"function toUppercase(string calldata input) external pure returns (string memory output);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"toUppercase(string)\",\n \"selector\": \"0x074ae3d7\",\n \"selectorBytes\": [\n 7,\n 74,\n 227,\n 215\n ]\n },\n \"group\": \"string\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"transact_0\",\n \"description\": \"Fetches the given transaction from the active fork and executes it on the current state.\",\n \"declaration\": \"function transact(bytes32 txHash) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"transact(bytes32)\",\n \"selector\": \"0xbe646da1\",\n \"selectorBytes\": [\n 190,\n 100,\n 109,\n 161\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"transact_1\",\n \"description\": \"Fetches the given transaction from the given fork and executes it on the current state.\",\n \"declaration\": \"function transact(uint256 forkId, bytes32 txHash) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"transact(uint256,bytes32)\",\n \"selector\": \"0x4d8abc4b\",\n \"selectorBytes\": [\n 77,\n 138,\n 188,\n 75\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"trim\",\n \"description\": \"Trims leading and trailing whitespace from the given `string` value.\",\n \"declaration\": \"function trim(string calldata input) external pure returns (string memory output);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"trim(string)\",\n \"selector\": \"0xb2dad155\",\n \"selectorBytes\": [\n 178,\n 218,\n 209,\n 85\n ]\n },\n \"group\": \"string\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"tryFfi\",\n \"description\": \"Performs a foreign function call via terminal and returns the exit code, stdout, and stderr.\",\n \"declaration\": \"function tryFfi(string[] calldata commandInput) external returns (FfiResult memory result);\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"tryFfi(string[])\",\n \"selector\": \"0xf45c1ce7\",\n \"selectorBytes\": [\n 244,\n 92,\n 28,\n 231\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"txGasPrice\",\n \"description\": \"Sets `tx.gasprice`.\",\n \"declaration\": \"function txGasPrice(uint256 newGasPrice) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"txGasPrice(uint256)\",\n \"selector\": \"0x48f50c0f\",\n \"selectorBytes\": [\n 72,\n 245,\n 12,\n 15\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"unixTime\",\n \"description\": \"Returns the time since unix epoch in milliseconds.\",\n \"declaration\": \"function unixTime() external view returns (uint256 milliseconds);\",\n \"visibility\": \"external\",\n \"mutability\": \"view\",\n \"signature\": \"unixTime()\",\n \"selector\": \"0x625387dc\",\n \"selectorBytes\": [\n 98,\n 83,\n 135,\n 220\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"verifyEd25519\",\n \"description\": \"Verifies an Ed25519 signature over namespace || message.\\nReturns true if signature is valid, false otherwise.\",\n \"declaration\": \"function verifyEd25519(bytes calldata signature, bytes calldata namespace, bytes calldata message, bytes32 publicKey) external pure returns (bool valid);\",\n \"visibility\": \"external\",\n \"mutability\": \"pure\",\n \"signature\": \"verifyEd25519(bytes,bytes,bytes,bytes32)\",\n \"selector\": \"0xd08c2888\",\n \"selectorBytes\": [\n 208,\n 140,\n 40,\n 136\n ]\n },\n \"group\": \"crypto\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"warmSlot\",\n \"description\": \"Utility cheatcode to mark specific storage slot as warm, simulating a prior read.\",\n \"declaration\": \"function warmSlot(address target, bytes32 slot) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"warmSlot(address,bytes32)\",\n \"selector\": \"0xb23184cf\",\n \"selectorBytes\": [\n 178,\n 49,\n 132,\n 207\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"warp\",\n \"description\": \"Sets `block.timestamp`.\",\n \"declaration\": \"function warp(uint256 newTimestamp) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"warp(uint256)\",\n \"selector\": \"0xe5d6bf02\",\n \"selectorBytes\": [\n 229,\n 214,\n 191,\n 2\n ]\n },\n \"group\": \"evm\",\n \"status\": \"stable\",\n \"safety\": \"unsafe\"\n },\n {\n \"func\": {\n \"id\": \"writeFile\",\n \"description\": \"Writes data to file, creating a file if it does not exist, and entirely replacing its contents if it does.\\n`path` is relative to the project root.\",\n \"declaration\": \"function writeFile(string calldata path, string calldata data) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"writeFile(string,string)\",\n \"selector\": \"0x897e0a97\",\n \"selectorBytes\": [\n 137,\n 126,\n 10,\n 151\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"writeFileBinary\",\n \"description\": \"Writes binary data to a file, creating a file if it does not exist, and entirely replacing its contents if it does.\\n`path` is relative to the project root.\",\n \"declaration\": \"function writeFileBinary(string calldata path, bytes calldata data) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"writeFileBinary(string,bytes)\",\n \"selector\": \"0x1f21fc80\",\n \"selectorBytes\": [\n 31,\n 33,\n 252,\n 128\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"writeJson_0\",\n \"description\": \"Write a serialized JSON object to a file. If the file exists, it will be overwritten.\",\n \"declaration\": \"function writeJson(string calldata json, string calldata path) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"writeJson(string,string)\",\n \"selector\": \"0xe23cd19f\",\n \"selectorBytes\": [\n 226,\n 60,\n 209,\n 159\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"writeJson_1\",\n \"description\": \"Write a serialized JSON object to an **existing** JSON file, replacing a value with key = \\nThis is useful to replace a specific value of a JSON file, without having to parse the entire thing.\\nThis cheatcode will create new keys if they didn't previously exist.\",\n \"declaration\": \"function writeJson(string calldata json, string calldata path, string calldata valueKey) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"writeJson(string,string,string)\",\n \"selector\": \"0x35d6ad46\",\n \"selectorBytes\": [\n 53,\n 214,\n 173,\n 70\n ]\n },\n \"group\": \"json\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"writeLine\",\n \"description\": \"Writes line to file, creating a file if it does not exist.\\n`path` is relative to the project root.\",\n \"declaration\": \"function writeLine(string calldata path, string calldata data) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"writeLine(string,string)\",\n \"selector\": \"0x619d897f\",\n \"selectorBytes\": [\n 97,\n 157,\n 137,\n 127\n ]\n },\n \"group\": \"filesystem\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"writeToml_0\",\n \"description\": \"Takes serialized JSON, converts to TOML and write a serialized TOML to a file.\",\n \"declaration\": \"function writeToml(string calldata json, string calldata path) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"writeToml(string,string)\",\n \"selector\": \"0xc0865ba7\",\n \"selectorBytes\": [\n 192,\n 134,\n 91,\n 167\n ]\n },\n \"group\": \"toml\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n },\n {\n \"func\": {\n \"id\": \"writeToml_1\",\n \"description\": \"Takes serialized JSON, converts to TOML and write a serialized TOML table to an **existing** TOML file, replacing a value with key = \\nThis is useful to replace a specific value of a TOML file, without having to parse the entire thing.\\nThis cheatcode will create new keys if they didn't previously exist.\",\n \"declaration\": \"function writeToml(string calldata json, string calldata path, string calldata valueKey) external;\",\n \"visibility\": \"external\",\n \"mutability\": \"\",\n \"signature\": \"writeToml(string,string,string)\",\n \"selector\": \"0x51ac6a33\",\n \"selectorBytes\": [\n 81,\n 172,\n 106,\n 51\n ]\n },\n \"group\": \"toml\",\n \"status\": \"stable\",\n \"safety\": \"safe\"\n }\n ]\n}" }, { "path": "crates/cheatcodes/assets/cheatcodes.schema.json", "content": "{\n \"$schema\": \"https://json-schema.org/draft/2020-12/schema\",\n \"title\": \"Cheatcodes\",\n \"description\": \"Foundry cheatcodes. Learn more: \",\n \"type\": \"object\",\n \"properties\": {\n \"cheatcodes\": {\n \"description\": \"All the cheatcodes.\",\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/$defs/Cheatcode\"\n }\n },\n \"enums\": {\n \"description\": \"Cheatcode enums.\",\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/$defs/Enum\"\n }\n },\n \"errors\": {\n \"description\": \"Cheatcode errors.\",\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/$defs/Error\"\n }\n },\n \"events\": {\n \"description\": \"Cheatcode events.\",\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/$defs/Event\"\n }\n },\n \"structs\": {\n \"description\": \"Cheatcode structs.\",\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/$defs/Struct\"\n }\n }\n },\n \"required\": [\n \"errors\",\n \"events\",\n \"enums\",\n \"structs\",\n \"cheatcodes\"\n ],\n \"$defs\": {\n \"Cheatcode\": {\n \"description\": \"Specification of a single cheatcode. Extends [`Function`] with additional metadata.\",\n \"type\": \"object\",\n \"properties\": {\n \"func\": {\n \"description\": \"The Solidity function declaration.\",\n \"$ref\": \"#/$defs/Function\"\n },\n \"group\": {\n \"description\": \"The group that the cheatcode belongs to.\",\n \"$ref\": \"#/$defs/Group\"\n },\n \"safety\": {\n \"description\": \"Whether the cheatcode is safe to use inside of scripts. E.g. it does not change state in an\\nunexpected way.\",\n \"$ref\": \"#/$defs/Safety\"\n },\n \"status\": {\n \"description\": \"The current status of the cheatcode. E.g. whether it is stable or experimental, etc.\",\n \"$ref\": \"#/$defs/Status\"\n }\n },\n \"additionalProperties\": false,\n \"required\": [\n \"func\",\n \"group\",\n \"status\",\n \"safety\"\n ]\n },\n \"Enum\": {\n \"description\": \"A Solidity enumeration.\",\n \"type\": \"object\",\n \"properties\": {\n \"description\": {\n \"description\": \"The description of the enum.\\nThis is a markdown string derived from the NatSpec documentation.\",\n \"type\": \"string\"\n },\n \"name\": {\n \"description\": \"The name of the enum.\",\n \"type\": \"string\"\n },\n \"variants\": {\n \"description\": \"The variants of the enum.\",\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/$defs/EnumVariant\"\n }\n }\n },\n \"required\": [\n \"name\",\n \"description\",\n \"variants\"\n ]\n },\n \"EnumVariant\": {\n \"description\": \"A variant of an [`Enum`].\",\n \"type\": \"object\",\n \"properties\": {\n \"description\": {\n \"description\": \"The description of the variant.\\nThis is a markdown string derived from the NatSpec documentation.\",\n \"type\": \"string\"\n },\n \"name\": {\n \"description\": \"The name of the variant.\",\n \"type\": \"string\"\n }\n },\n \"required\": [\n \"name\",\n \"description\"\n ]\n },\n \"Error\": {\n \"description\": \"A Solidity custom error.\",\n \"type\": \"object\",\n \"properties\": {\n \"declaration\": {\n \"description\": \"The Solidity error declaration, including full type, parameter names, etc.\",\n \"type\": \"string\"\n },\n \"description\": {\n \"description\": \"The description of the error.\\nThis is a markdown string derived from the NatSpec documentation.\",\n \"type\": \"string\"\n },\n \"name\": {\n \"description\": \"The name of the error.\",\n \"type\": \"string\"\n }\n },\n \"required\": [\n \"name\",\n \"description\",\n \"declaration\"\n ]\n },\n \"Event\": {\n \"description\": \"A Solidity event.\",\n \"type\": \"object\",\n \"properties\": {\n \"declaration\": {\n \"description\": \"The Solidity event declaration, including full type, parameter names, etc.\",\n \"type\": \"string\"\n },\n \"description\": {\n \"description\": \"The description of the event.\\nThis is a markdown string derived from the NatSpec documentation.\",\n \"type\": \"string\"\n },\n \"name\": {\n \"description\": \"The name of the event.\",\n \"type\": \"string\"\n }\n },\n \"required\": [\n \"name\",\n \"description\",\n \"declaration\"\n ]\n },\n \"Function\": {\n \"description\": \"Solidity function.\",\n \"type\": \"object\",\n \"properties\": {\n \"declaration\": {\n \"description\": \"The Solidity function declaration, including full type and parameter names, visibility,\\netc.\",\n \"type\": \"string\"\n },\n \"description\": {\n \"description\": \"The description of the function.\\nThis is a markdown string derived from the NatSpec documentation.\",\n \"type\": \"string\"\n },\n \"id\": {\n \"description\": \"The function's unique identifier. This is the function name, optionally appended with an\\nindex if it is overloaded.\",\n \"type\": \"string\"\n },\n \"mutability\": {\n \"description\": \"The Solidity function state mutability attribute.\",\n \"$ref\": \"#/$defs/Mutability\"\n },\n \"selector\": {\n \"description\": \"The hex-encoded, \\\"0x\\\"-prefixed 4-byte function selector,\\nwhich is the Keccak-256 hash of `signature`.\",\n \"type\": \"string\"\n },\n \"selectorBytes\": {\n \"description\": \"The 4-byte function selector as a byte array.\",\n \"type\": \"array\",\n \"items\": {\n \"type\": \"integer\",\n \"format\": \"uint8\",\n \"maximum\": 255,\n \"minimum\": 0\n },\n \"maxItems\": 4,\n \"minItems\": 4\n },\n \"signature\": {\n \"description\": \"The standard function signature used to calculate `selector`.\\nSee the [Solidity docs] for more information.\\n\\n[Solidity docs]: https://docs.soliditylang.org/en/latest/abi-spec.html#function-selector\",\n \"type\": \"string\"\n },\n \"visibility\": {\n \"description\": \"The Solidity function visibility attribute. This is currently always `external`, but this\\nmay change in the future.\",\n \"$ref\": \"#/$defs/Visibility\"\n }\n },\n \"required\": [\n \"id\",\n \"description\",\n \"declaration\",\n \"visibility\",\n \"mutability\",\n \"signature\",\n \"selector\",\n \"selectorBytes\"\n ]\n },\n \"Group\": {\n \"description\": \"Cheatcode groups.\\nInitially derived and modified from inline comments in [`forge-std`'s `Vm.sol`][vmsol].\\n\\n[vmsol]: https://github.com/foundry-rs/forge-std/blob/dcb0d52bc4399d37a6545848e3b8f9d03c77b98d/src/Vm.sol\",\n \"oneOf\": [\n {\n \"description\": \"Cheatcodes that read from, or write to the current EVM execution state.\\n\\nExamples: any of the `record` cheatcodes, `chainId`, `coinbase`.\\n\\nSafety: ambiguous, depends on whether the cheatcode is read-only or not.\",\n \"type\": \"string\",\n \"const\": \"evm\"\n },\n {\n \"description\": \"Cheatcodes that interact with how a test is run.\\n\\nExamples: `assume`, `skip`, `expectRevert`.\\n\\nSafety: ambiguous, depends on whether the cheatcode is read-only or not.\",\n \"type\": \"string\",\n \"const\": \"testing\"\n },\n {\n \"description\": \"Cheatcodes that interact with how a script is run.\\n\\nExamples: `broadcast`, `startBroadcast`, `stopBroadcast`.\\n\\nSafety: safe.\",\n \"type\": \"string\",\n \"const\": \"scripting\"\n },\n {\n \"description\": \"Cheatcodes that interact with the OS or filesystem.\\n\\nExamples: `ffi`, `projectRoot`, `writeFile`.\\n\\nSafety: safe.\",\n \"type\": \"string\",\n \"const\": \"filesystem\"\n },\n {\n \"description\": \"Cheatcodes that interact with the program's environment variables.\\n\\nExamples: `setEnv`, `envBool`, `envOr`.\\n\\nSafety: safe.\",\n \"type\": \"string\",\n \"const\": \"environment\"\n },\n {\n \"description\": \"Utility cheatcodes that deal with string parsing and manipulation.\\n\\nExamples: `toString`. `parseBytes`.\\n\\nSafety: safe.\",\n \"type\": \"string\",\n \"const\": \"string\"\n },\n {\n \"description\": \"Utility cheatcodes that deal with parsing values from and converting values to JSON.\\n\\nExamples: `serializeJson`, `parseJsonUint`, `writeJson`.\\n\\nSafety: safe.\",\n \"type\": \"string\",\n \"const\": \"json\"\n },\n {\n \"description\": \"Utility cheatcodes that deal with parsing values from and converting values to TOML.\\n\\nExamples: `parseToml`, `writeToml`.\\n\\nSafety: safe.\",\n \"type\": \"string\",\n \"const\": \"toml\"\n },\n {\n \"description\": \"Cryptography-related cheatcodes.\\n\\nExamples: `sign*`.\\n\\nSafety: safe.\",\n \"type\": \"string\",\n \"const\": \"crypto\"\n },\n {\n \"description\": \"Generic, uncategorized utilities.\\n\\nExamples: `toString`, `parse*`, `serialize*`.\\n\\nSafety: safe.\",\n \"type\": \"string\",\n \"const\": \"utilities\"\n }\n ]\n },\n \"Mutability\": {\n \"description\": \"Solidity function state mutability attribute. See the [Solidity docs] for more information.\\n\\n[Solidity docs]: https://docs.soliditylang.org/en/latest/contracts.html#state-mutability\",\n \"oneOf\": [\n {\n \"description\": \"Disallows modification or access of state.\",\n \"type\": \"string\",\n \"const\": \"pure\"\n },\n {\n \"description\": \"Disallows modification of state.\",\n \"type\": \"string\",\n \"const\": \"view\"\n },\n {\n \"description\": \"Allows modification of state.\",\n \"type\": \"string\",\n \"const\": \"\"\n }\n ]\n },\n \"Safety\": {\n \"description\": \"Cheatcode safety.\",\n \"oneOf\": [\n {\n \"description\": \"The cheatcode is not safe to use in scripts.\",\n \"type\": \"string\",\n \"const\": \"unsafe\"\n },\n {\n \"description\": \"The cheatcode is safe to use in scripts.\",\n \"type\": \"string\",\n \"const\": \"safe\"\n }\n ]\n },\n \"Status\": {\n \"description\": \"The status of a cheatcode.\",\n \"oneOf\": [\n {\n \"description\": \"The cheatcode and its API is currently stable.\",\n \"type\": \"string\",\n \"const\": \"stable\"\n },\n {\n \"description\": \"The cheatcode is unstable, meaning it may contain bugs and may break its API on any\\nrelease.\\n\\nUse of experimental cheatcodes will result in a warning.\",\n \"type\": \"string\",\n \"const\": \"experimental\"\n },\n {\n \"description\": \"The cheatcode has been deprecated, meaning it will be removed in a future release.\\n\\nContains the optional reason for deprecation.\\n\\nUse of deprecated cheatcodes is discouraged and will result in a warning.\",\n \"type\": \"object\",\n \"properties\": {\n \"deprecated\": {\n \"type\": [\n \"string\",\n \"null\"\n ]\n }\n },\n \"additionalProperties\": false,\n \"required\": [\n \"deprecated\"\n ]\n },\n {\n \"description\": \"The cheatcode has been removed and is no longer available for use.\\n\\nUse of removed cheatcodes will result in a hard error.\",\n \"type\": \"string\",\n \"const\": \"removed\"\n },\n {\n \"description\": \"The cheatcode is only used internally for foundry testing and may be changed or removed at\\nany time.\\n\\nUse of internal cheatcodes is discouraged and will result in a warning.\",\n \"type\": \"string\",\n \"const\": \"internal\"\n }\n ]\n },\n \"Struct\": {\n \"description\": \"A Solidity struct.\",\n \"type\": \"object\",\n \"properties\": {\n \"description\": {\n \"description\": \"The description of the struct.\\nThis is a markdown string derived from the NatSpec documentation.\",\n \"type\": \"string\"\n },\n \"fields\": {\n \"description\": \"The fields of the struct.\",\n \"type\": \"array\",\n \"items\": {\n \"$ref\": \"#/$defs/StructField\"\n }\n },\n \"name\": {\n \"description\": \"The name of the struct.\",\n \"type\": \"string\"\n }\n },\n \"required\": [\n \"name\",\n \"description\",\n \"fields\"\n ]\n },\n \"StructField\": {\n \"description\": \"A [`Struct`] field.\",\n \"type\": \"object\",\n \"properties\": {\n \"description\": {\n \"description\": \"The description of the field.\\nThis is a markdown string derived from the NatSpec documentation.\",\n \"type\": \"string\"\n },\n \"name\": {\n \"description\": \"The name of the field.\",\n \"type\": \"string\"\n },\n \"ty\": {\n \"description\": \"The type of the field.\",\n \"type\": \"string\"\n }\n },\n \"required\": [\n \"name\",\n \"ty\",\n \"description\"\n ]\n },\n \"Visibility\": {\n \"description\": \"Solidity function visibility attribute. See the [Solidity docs] for more information.\\n\\n[Solidity docs]: https://docs.soliditylang.org/en/latest/contracts.html#function-visibility\",\n \"oneOf\": [\n {\n \"description\": \"The function is only visible externally.\",\n \"type\": \"string\",\n \"const\": \"external\"\n },\n {\n \"description\": \"Visible externally and internally.\",\n \"type\": \"string\",\n \"const\": \"public\"\n },\n {\n \"description\": \"Only visible internally.\",\n \"type\": \"string\",\n \"const\": \"internal\"\n },\n {\n \"description\": \"Only visible in the current contract\",\n \"type\": \"string\",\n \"const\": \"private\"\n }\n ]\n }\n }\n}" }, { "path": "crates/cheatcodes/spec/Cargo.toml", "content": "[package]\nname = \"foundry-cheatcodes-spec\"\ndescription = \"Foundry cheatcodes specification\"\n\nversion.workspace = true\nedition.workspace = true\nrust-version.workspace = true\nauthors.workspace = true\nlicense.workspace = true\nhomepage.workspace = true\nrepository.workspace = true\nexclude.workspace = true\n\n[lints]\nworkspace = true\n\n[dependencies]\nfoundry-macros.workspace = true\nalloy-sol-types = { workspace = true, features = [\"json\"] }\nserde.workspace = true\n\n# schema\nschemars = { version = \"1.1\", optional = true }\n\n[dev-dependencies]\nserde_json.workspace = true\n\n[features]\nschema = [\"dep:schemars\"]\n" }, { "path": "crates/cheatcodes/spec/src/cheatcode.rs", "content": "use super::Function;\nuse alloy_sol_types::SolCall;\nuse serde::{Deserialize, Serialize};\n\n/// Cheatcode definition trait. Implemented by all [`Vm`](crate::Vm) functions.\npub trait CheatcodeDef: std::fmt::Debug + Clone + SolCall {\n /// The static cheatcode definition.\n const CHEATCODE: &'static Cheatcode<'static>;\n}\n\n/// Specification of a single cheatcode. Extends [`Function`] with additional metadata.\n#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Serialize, Deserialize)]\n#[cfg_attr(feature = \"schema\", derive(schemars::JsonSchema))]\n#[serde(deny_unknown_fields, rename_all = \"camelCase\")]\n#[non_exhaustive]\npub struct Cheatcode<'a> {\n // Automatically-generated fields.\n /// The Solidity function declaration.\n #[serde(borrow)]\n pub func: Function<'a>,\n\n // Manually-specified fields.\n /// The group that the cheatcode belongs to.\n pub group: Group,\n /// The current status of the cheatcode. E.g. whether it is stable or experimental, etc.\n pub status: Status<'a>,\n /// Whether the cheatcode is safe to use inside of scripts. E.g. it does not change state in an\n /// unexpected way.\n pub safety: Safety,\n}\n\n/// The status of a cheatcode.\n#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Serialize, Deserialize)]\n#[cfg_attr(feature = \"schema\", derive(schemars::JsonSchema))]\n#[serde(rename_all = \"camelCase\")]\n#[non_exhaustive]\npub enum Status<'a> {\n /// The cheatcode and its API is currently stable.\n Stable,\n /// The cheatcode is unstable, meaning it may contain bugs and may break its API on any\n /// release.\n ///\n /// Use of experimental cheatcodes will result in a warning.\n Experimental,\n /// The cheatcode has been deprecated, meaning it will be removed in a future release.\n ///\n /// Contains the optional reason for deprecation.\n ///\n /// Use of deprecated cheatcodes is discouraged and will result in a warning.\n Deprecated(Option<&'a str>),\n /// The cheatcode has been removed and is no longer available for use.\n ///\n /// Use of removed cheatcodes will result in a hard error.\n Removed,\n /// The cheatcode is only used internally for foundry testing and may be changed or removed at\n /// any time.\n ///\n /// Use of internal cheatcodes is discouraged and will result in a warning.\n Internal,\n}\n\n/// Cheatcode groups.\n/// Initially derived and modified from inline comments in [`forge-std`'s `Vm.sol`][vmsol].\n///\n/// [vmsol]: https://github.com/foundry-rs/forge-std/blob/dcb0d52bc4399d37a6545848e3b8f9d03c77b98d/src/Vm.sol\n#[derive(Clone, Copy, Debug, PartialEq, Eq, PartialOrd, Ord, Serialize, Deserialize)]\n#[cfg_attr(feature = \"schema\", derive(schemars::JsonSchema))]\n#[serde(rename_all = \"camelCase\")]\n#[non_exhaustive]\npub enum Group {\n /// Cheatcodes that read from, or write to the current EVM execution state.\n ///\n /// Examples: any of the `record` cheatcodes, `chainId`, `coinbase`.\n ///\n /// Safety: ambiguous, depends on whether the cheatcode is read-only or not.\n Evm,\n /// Cheatcodes that interact with how a test is run.\n ///\n /// Examples: `assume`, `skip`, `expectRevert`.\n ///\n /// Safety: ambiguous, depends on whether the cheatcode is read-only or not.\n Testing,\n /// Cheatcodes that interact with how a script is run.\n ///\n /// Examples: `broadcast`, `startBroadcast`, `stopBroadcast`.\n ///\n /// Safety: safe.\n Scripting,\n /// Cheatcodes that interact with the OS or filesystem.\n ///\n /// Examples: `ffi`, `projectRoot`, `writeFile`.\n ///\n /// Safety: safe.\n Filesystem,\n /// Cheatcodes that interact with the program's environment variables.\n ///\n /// Examples: `setEnv`, `envBool`, `envOr`.\n ///\n /// Safety: safe.\n Environment,\n /// Utility cheatcodes that deal with string parsing and manipulation.\n ///\n /// Examples: `toString`. `parseBytes`.\n ///\n /// Safety: safe.\n String,\n /// Utility cheatcodes that deal with parsing values from and converting values to JSON.\n ///\n /// Examples: `serializeJson`, `parseJsonUint`, `writeJson`.\n ///\n /// Safety: safe.\n Json,\n /// Utility cheatcodes that deal with parsing values from and converting values to TOML.\n ///\n /// Examples: `parseToml`, `writeToml`.\n ///\n /// Safety: safe.\n Toml,\n /// Cryptography-related cheatcodes.\n ///\n /// Examples: `sign*`.\n ///\n /// Safety: safe.\n Crypto,\n /// Generic, uncategorized utilities.\n ///\n /// Examples: `toString`, `parse*`, `serialize*`.\n ///\n /// Safety: safe.\n Utilities,\n}\n\nimpl Group {\n /// Returns the safety of this cheatcode group.\n ///\n /// Some groups are inherently safe or unsafe, while others are ambiguous and will return\n /// `None`.\n pub const fn safety(self) -> Option {\n match self {\n Self::Evm | Self::Testing => None,\n Self::Scripting\n | Self::Filesystem\n | Self::Environment\n | Self::String\n | Self::Json\n | Self::Toml\n | Self::Crypto\n | Self::Utilities => Some(Safety::Safe),\n }\n }\n\n /// Returns this value as a string.\n pub const fn as_str(self) -> &'static str {\n match self {\n Self::Evm => \"evm\",\n Self::Testing => \"testing\",\n Self::Scripting => \"scripting\",\n Self::Filesystem => \"filesystem\",\n Self::Environment => \"environment\",\n Self::String => \"string\",\n Self::Json => \"json\",\n Self::Toml => \"toml\",\n Self::Crypto => \"crypto\",\n Self::Utilities => \"utilities\",\n }\n }\n}\n\n// TODO: Find a better name for this\n/// Cheatcode safety.\n#[derive(Clone, Copy, Debug, Default, PartialEq, Eq, PartialOrd, Ord, Serialize, Deserialize)]\n#[cfg_attr(feature = \"schema\", derive(schemars::JsonSchema))]\n#[serde(rename_all = \"camelCase\")]\n#[non_exhaustive]\npub enum Safety {\n /// The cheatcode is not safe to use in scripts.\n Unsafe,\n /// The cheatcode is safe to use in scripts.\n #[default]\n Safe,\n}\n\nimpl Safety {\n /// Returns this value as a string.\n pub const fn as_str(self) -> &'static str {\n match self {\n Self::Safe => \"safe\",\n Self::Unsafe => \"unsafe\",\n }\n }\n\n /// Returns whether this value is safe.\n pub const fn is_safe(self) -> bool {\n matches!(self, Self::Safe)\n }\n}\n" }, { "path": "crates/cheatcodes/spec/src/function.rs", "content": "use serde::{Deserialize, Serialize};\nuse std::fmt;\n\n/// Solidity function.\n#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Serialize, Deserialize)]\n#[cfg_attr(feature = \"schema\", derive(schemars::JsonSchema))]\n#[serde(rename_all = \"camelCase\")]\n#[non_exhaustive]\npub struct Function<'a> {\n /// The function's unique identifier. This is the function name, optionally appended with an\n /// index if it is overloaded.\n pub id: &'a str,\n /// The description of the function.\n /// This is a markdown string derived from the NatSpec documentation.\n pub description: &'a str,\n /// The Solidity function declaration, including full type and parameter names, visibility,\n /// etc.\n pub declaration: &'a str,\n /// The Solidity function visibility attribute. This is currently always `external`, but this\n /// may change in the future.\n pub visibility: Visibility,\n /// The Solidity function state mutability attribute.\n pub mutability: Mutability,\n /// The standard function signature used to calculate `selector`.\n /// See the [Solidity docs] for more information.\n ///\n /// [Solidity docs]: https://docs.soliditylang.org/en/latest/abi-spec.html#function-selector\n pub signature: &'a str,\n /// The hex-encoded, \"0x\"-prefixed 4-byte function selector,\n /// which is the Keccak-256 hash of `signature`.\n pub selector: &'a str,\n /// The 4-byte function selector as a byte array.\n pub selector_bytes: [u8; 4],\n}\n\nimpl fmt::Display for Function<'_> {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n f.write_str(self.declaration)\n }\n}\n\n/// Solidity function visibility attribute. See the [Solidity docs] for more information.\n///\n/// [Solidity docs]: https://docs.soliditylang.org/en/latest/contracts.html#function-visibility\n#[derive(Clone, Copy, Debug, PartialEq, Eq, PartialOrd, Ord, Serialize, Deserialize)]\n#[cfg_attr(feature = \"schema\", derive(schemars::JsonSchema))]\n#[serde(rename_all = \"camelCase\")]\npub enum Visibility {\n /// The function is only visible externally.\n External,\n /// Visible externally and internally.\n Public,\n /// Only visible internally.\n Internal,\n /// Only visible in the current contract\n Private,\n}\n\nimpl fmt::Display for Visibility {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n f.write_str(self.as_str())\n }\n}\n\nimpl Visibility {\n /// Returns the string representation of the visibility.\n pub const fn as_str(self) -> &'static str {\n match self {\n Self::External => \"external\",\n Self::Public => \"public\",\n Self::Internal => \"internal\",\n Self::Private => \"private\",\n }\n }\n}\n\n/// Solidity function state mutability attribute. See the [Solidity docs] for more information.\n///\n/// [Solidity docs]: https://docs.soliditylang.org/en/latest/contracts.html#state-mutability\n#[derive(Clone, Copy, Debug, PartialEq, Eq, PartialOrd, Ord, Serialize, Deserialize)]\n#[cfg_attr(feature = \"schema\", derive(schemars::JsonSchema))]\n#[serde(rename_all = \"camelCase\")]\npub enum Mutability {\n /// Disallows modification or access of state.\n Pure,\n /// Disallows modification of state.\n View,\n /// Allows modification of state.\n #[serde(rename = \"\")]\n None,\n}\n\nimpl fmt::Display for Mutability {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n f.write_str(self.as_str())\n }\n}\n\nimpl Mutability {\n /// Returns the string representation of the mutability.\n pub const fn as_str(self) -> &'static str {\n match self {\n Self::Pure => \"pure\",\n Self::View => \"view\",\n Self::None => \"\",\n }\n }\n}\n" }, { "path": "crates/cheatcodes/spec/src/items.rs", "content": "use serde::{Deserialize, Serialize};\nuse std::{borrow::Cow, fmt};\n\n/// A Solidity custom error.\n#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Serialize, Deserialize)]\n#[cfg_attr(feature = \"schema\", derive(schemars::JsonSchema))]\n#[serde(rename_all = \"camelCase\")]\npub struct Error<'a> {\n /// The name of the error.\n pub name: &'a str,\n /// The description of the error.\n /// This is a markdown string derived from the NatSpec documentation.\n pub description: &'a str,\n /// The Solidity error declaration, including full type, parameter names, etc.\n pub declaration: &'a str,\n}\n\nimpl fmt::Display for Error<'_> {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n f.write_str(self.declaration)\n }\n}\n\n/// A Solidity event.\n#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Serialize, Deserialize)]\n#[cfg_attr(feature = \"schema\", derive(schemars::JsonSchema))]\n#[serde(rename_all = \"camelCase\")]\npub struct Event<'a> {\n /// The name of the event.\n pub name: &'a str,\n /// The description of the event.\n /// This is a markdown string derived from the NatSpec documentation.\n pub description: &'a str,\n /// The Solidity event declaration, including full type, parameter names, etc.\n pub declaration: &'a str,\n}\n\nimpl fmt::Display for Event<'_> {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n f.write_str(self.declaration)\n }\n}\n\n/// A Solidity enumeration.\n#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Serialize, Deserialize)]\n#[cfg_attr(feature = \"schema\", derive(schemars::JsonSchema))]\n#[serde(rename_all = \"camelCase\")]\npub struct Enum<'a> {\n /// The name of the enum.\n pub name: &'a str,\n /// The description of the enum.\n /// This is a markdown string derived from the NatSpec documentation.\n pub description: &'a str,\n /// The variants of the enum.\n #[serde(borrow)]\n pub variants: Cow<'a, [EnumVariant<'a>]>,\n}\n\nimpl fmt::Display for Enum<'_> {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n write!(f, \"enum {} {{ \", self.name)?;\n for (i, variant) in self.variants.iter().enumerate() {\n if i > 0 {\n f.write_str(\", \")?;\n }\n f.write_str(variant.name)?;\n }\n f.write_str(\" }\")\n }\n}\n\n/// A variant of an [`Enum`].\n#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Serialize, Deserialize)]\n#[cfg_attr(feature = \"schema\", derive(schemars::JsonSchema))]\n#[serde(rename_all = \"camelCase\")]\npub struct EnumVariant<'a> {\n /// The name of the variant.\n pub name: &'a str,\n /// The description of the variant.\n /// This is a markdown string derived from the NatSpec documentation.\n pub description: &'a str,\n}\n\n/// A Solidity struct.\n#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Serialize, Deserialize)]\n#[cfg_attr(feature = \"schema\", derive(schemars::JsonSchema))]\n#[serde(rename_all = \"camelCase\")]\npub struct Struct<'a> {\n /// The name of the struct.\n pub name: &'a str,\n /// The description of the struct.\n /// This is a markdown string derived from the NatSpec documentation.\n pub description: &'a str,\n /// The fields of the struct.\n #[serde(borrow)]\n pub fields: Cow<'a, [StructField<'a>]>,\n}\n\nimpl fmt::Display for Struct<'_> {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n write!(f, \"struct {} {{ \", self.name)?;\n for field in self.fields.iter() {\n write!(f, \"{} {}; \", field.ty, field.name)?;\n }\n f.write_str(\"}\")\n }\n}\n\n/// A [`Struct`] field.\n#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Serialize, Deserialize)]\n#[cfg_attr(feature = \"schema\", derive(schemars::JsonSchema))]\n#[serde(rename_all = \"camelCase\")]\npub struct StructField<'a> {\n /// The name of the field.\n pub name: &'a str,\n /// The type of the field.\n pub ty: &'a str,\n /// The description of the field.\n /// This is a markdown string derived from the NatSpec documentation.\n pub description: &'a str,\n}\n" }, { "path": "crates/cheatcodes/spec/src/lib.rs", "content": "//! Cheatcode specification for Foundry.\n\n#![cfg_attr(not(test), warn(unused_crate_dependencies))]\n#![cfg_attr(docsrs, feature(doc_cfg))]\n\nuse serde::{Deserialize, Serialize};\nuse std::{borrow::Cow, fmt};\n\nmod cheatcode;\npub use cheatcode::{Cheatcode, CheatcodeDef, Group, Safety, Status};\n\nmod function;\npub use function::{Function, Mutability, Visibility};\n\nmod items;\npub use items::{Enum, EnumVariant, Error, Event, Struct, StructField};\n\nmod vm;\npub use vm::Vm;\n\n// The `cheatcodes.json` schema.\n/// Foundry cheatcodes. Learn more: \n#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Serialize, Deserialize)]\n#[cfg_attr(feature = \"schema\", derive(schemars::JsonSchema))]\n#[serde(rename_all = \"camelCase\")]\npub struct Cheatcodes<'a> {\n /// Cheatcode errors.\n #[serde(borrow)]\n pub errors: Cow<'a, [Error<'a>]>,\n /// Cheatcode events.\n #[serde(borrow)]\n pub events: Cow<'a, [Event<'a>]>,\n /// Cheatcode enums.\n #[serde(borrow)]\n pub enums: Cow<'a, [Enum<'a>]>,\n /// Cheatcode structs.\n #[serde(borrow)]\n pub structs: Cow<'a, [Struct<'a>]>,\n /// All the cheatcodes.\n #[serde(borrow)]\n pub cheatcodes: Cow<'a, [Cheatcode<'a>]>,\n}\n\nimpl fmt::Display for Cheatcodes<'_> {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n for error in self.errors.iter() {\n writeln!(f, \"{error}\")?;\n }\n for event in self.events.iter() {\n writeln!(f, \"{event}\")?;\n }\n for enumm in self.enums.iter() {\n writeln!(f, \"{enumm}\")?;\n }\n for strukt in self.structs.iter() {\n writeln!(f, \"{strukt}\")?;\n }\n for cheatcode in self.cheatcodes.iter() {\n writeln!(f, \"{}\", cheatcode.func)?;\n }\n Ok(())\n }\n}\n\nimpl Default for Cheatcodes<'static> {\n fn default() -> Self {\n Self::new()\n }\n}\n\nimpl Cheatcodes<'static> {\n /// Returns the default cheatcodes.\n pub fn new() -> Self {\n Self {\n // unfortunately technology has not yet advanced to the point where we can get all\n // items of a certain type in a module, so we have to hardcode them here\n structs: Cow::Owned(vec![\n Vm::Log::STRUCT.clone(),\n Vm::Rpc::STRUCT.clone(),\n Vm::EthGetLogs::STRUCT.clone(),\n Vm::DirEntry::STRUCT.clone(),\n Vm::FsMetadata::STRUCT.clone(),\n Vm::Wallet::STRUCT.clone(),\n Vm::FfiResult::STRUCT.clone(),\n Vm::ChainInfo::STRUCT.clone(),\n Vm::Chain::STRUCT.clone(),\n Vm::AccountAccess::STRUCT.clone(),\n Vm::StorageAccess::STRUCT.clone(),\n Vm::Gas::STRUCT.clone(),\n Vm::DebugStep::STRUCT.clone(),\n Vm::BroadcastTxSummary::STRUCT.clone(),\n Vm::SignedDelegation::STRUCT.clone(),\n Vm::PotentialRevert::STRUCT.clone(),\n Vm::AccessListItem::STRUCT.clone(),\n ]),\n enums: Cow::Owned(vec![\n Vm::CallerMode::ENUM.clone(),\n Vm::AccountAccessKind::ENUM.clone(),\n Vm::ForgeContext::ENUM.clone(),\n Vm::BroadcastTxType::ENUM.clone(),\n ]),\n errors: Vm::VM_ERRORS.iter().copied().cloned().collect(),\n events: Cow::Borrowed(&[]),\n // events: Vm::VM_EVENTS.iter().copied().cloned().collect(),\n cheatcodes: Vm::CHEATCODES.iter().copied().cloned().collect(),\n }\n }\n}\n\n#[cfg(test)]\n#[expect(clippy::disallowed_macros)]\nmod tests {\n use super::*;\n use std::{fs, path::Path};\n\n const JSON_PATH: &str = concat!(env!(\"CARGO_MANIFEST_DIR\"), \"/../assets/cheatcodes.json\");\n #[cfg(feature = \"schema\")]\n const SCHEMA_PATH: &str =\n concat!(env!(\"CARGO_MANIFEST_DIR\"), \"/../assets/cheatcodes.schema.json\");\n const IFACE_PATH: &str = concat!(env!(\"CARGO_MANIFEST_DIR\"), \"/../../../testdata/utils/Vm.sol\");\n\n /// Generates the `cheatcodes.json` file contents.\n fn json_cheatcodes() -> String {\n serde_json::to_string_pretty(&Cheatcodes::new()).unwrap()\n }\n\n /// Generates the [cheatcodes](json_cheatcodes) JSON schema.\n #[cfg(feature = \"schema\")]\n fn json_schema() -> String {\n serde_json::to_string_pretty(&schemars::schema_for!(Cheatcodes<'_>)).unwrap()\n }\n\n fn sol_iface() -> String {\n let mut cheats = Cheatcodes::new();\n cheats.errors = Default::default(); // Skip errors to allow <0.8.4.\n let cheats = cheats.to_string().trim().replace('\\n', \"\\n \");\n format!(\n \"\\\n// Automatically generated from `foundry-cheatcodes` Vm definitions. Do not modify manually.\n// This interface is just for internal testing purposes. Use `forge-std` instead.\n\n// SPDX-License-Identifier: MIT OR Apache-2.0\npragma solidity >=0.6.2 <0.9.0;\npragma experimental ABIEncoderV2;\n\ninterface Vm {{\n {cheats}\n}}\n\"\n )\n }\n\n #[test]\n fn spec_up_to_date() {\n ensure_file_contents(Path::new(JSON_PATH), &json_cheatcodes());\n }\n\n #[test]\n #[cfg(feature = \"schema\")]\n fn schema_up_to_date() {\n ensure_file_contents(Path::new(SCHEMA_PATH), &json_schema());\n }\n\n #[test]\n fn iface_up_to_date() {\n ensure_file_contents(Path::new(IFACE_PATH), &sol_iface());\n }\n\n /// Checks that the `file` has the specified `contents`. If that is not the\n /// case, updates the file and then fails the test.\n fn ensure_file_contents(file: &Path, contents: &str) {\n if let Ok(old_contents) = fs::read_to_string(file)\n && normalize_newlines(&old_contents) == normalize_newlines(contents)\n {\n // File is already up to date.\n return;\n }\n\n eprintln!(\"\\n\\x1b[31;1merror\\x1b[0m: {} was not up-to-date, updating\\n\", file.display());\n if std::env::var(\"CI\").is_ok() {\n eprintln!(\" NOTE: run `cargo cheats` locally and commit the updated files\\n\");\n }\n if let Some(parent) = file.parent() {\n let _ = fs::create_dir_all(parent);\n }\n fs::write(file, contents).unwrap();\n panic!(\"some file was not up to date and has been updated, simply re-run the tests\");\n }\n\n fn normalize_newlines(s: &str) -> String {\n s.replace(\"\\r\\n\", \"\\n\")\n }\n}\n" }, { "path": "crates/cheatcodes/spec/src/vm.rs", "content": "// We don't document function parameters individually so we can't enable `missing_docs` for this\n// module. Instead, we emit custom diagnostics in `#[derive(Cheatcode)]`.\n#![allow(missing_docs)]\n\nuse super::*;\nuse crate::Vm::ForgeContext;\nuse alloy_sol_types::sol;\nuse foundry_macros::Cheatcode;\n\nsol! {\n// Cheatcodes are marked as view/pure/none using the following rules:\n// 0. A call's observable behaviour includes its return value, logs, reverts and state writes,\n// 1. If you can influence a later call's observable behaviour, you're neither `view` nor `pure`\n// (you are modifying some state be it the EVM, interpreter, filesystem, etc),\n// 2. Otherwise if you can be influenced by an earlier call, or if reading some state, you're `view`,\n// 3. Otherwise you're `pure`.\n\n/// Foundry cheatcodes interface.\n#[derive(Debug, Cheatcode)] // Keep this list small to avoid unnecessary bloat.\n#[sol(abi)]\ninterface Vm {\n // ======== Types ========\n\n /// Error thrown by cheatcodes.\n error CheatcodeError(string message);\n\n /// A modification applied to either `msg.sender` or `tx.origin`. Returned by `readCallers`.\n enum CallerMode {\n /// No caller modification is currently active.\n None,\n /// A one time broadcast triggered by a `vm.broadcast()` call is currently active.\n Broadcast,\n /// A recurrent broadcast triggered by a `vm.startBroadcast()` call is currently active.\n RecurrentBroadcast,\n /// A one time prank triggered by a `vm.prank()` call is currently active.\n Prank,\n /// A recurrent prank triggered by a `vm.startPrank()` call is currently active.\n RecurrentPrank,\n }\n\n /// The kind of account access that occurred.\n enum AccountAccessKind {\n /// The account was called.\n Call,\n /// The account was called via delegatecall.\n DelegateCall,\n /// The account was called via callcode.\n CallCode,\n /// The account was called via staticcall.\n StaticCall,\n /// The account was created.\n Create,\n /// The account was selfdestructed.\n SelfDestruct,\n /// Synthetic access indicating the current context has resumed after a previous sub-context (AccountAccess).\n Resume,\n /// The account's balance was read.\n Balance,\n /// The account's codesize was read.\n Extcodesize,\n /// The account's codehash was read.\n Extcodehash,\n /// The account's code was copied.\n Extcodecopy,\n }\n\n /// Forge execution contexts.\n enum ForgeContext {\n /// Test group execution context (test, coverage or snapshot).\n TestGroup,\n /// `forge test` execution context.\n Test,\n /// `forge coverage` execution context.\n Coverage,\n /// `forge snapshot` execution context.\n Snapshot,\n /// Script group execution context (dry run, broadcast or resume).\n ScriptGroup,\n /// `forge script` execution context.\n ScriptDryRun,\n /// `forge script --broadcast` execution context.\n ScriptBroadcast,\n /// `forge script --resume` execution context.\n ScriptResume,\n /// Unknown `forge` execution context.\n Unknown,\n }\n\n /// An Ethereum log. Returned by `getRecordedLogs`.\n struct Log {\n /// The topics of the log, including the signature, if any.\n bytes32[] topics;\n /// The raw data of the log.\n bytes data;\n /// The address of the log's emitter.\n address emitter;\n }\n\n /// Gas used. Returned by `lastCallGas`.\n struct Gas {\n /// The gas limit of the call.\n uint64 gasLimit;\n /// The total gas used.\n uint64 gasTotalUsed;\n /// DEPRECATED: The amount of gas used for memory expansion. Ref: \n uint64 gasMemoryUsed;\n /// The amount of gas refunded.\n int64 gasRefunded;\n /// The amount of gas remaining.\n uint64 gasRemaining;\n }\n\n /// An RPC URL and its alias. Returned by `rpcUrlStructs`.\n struct Rpc {\n /// The alias of the RPC URL.\n string key;\n /// The RPC URL.\n string url;\n }\n\n /// An RPC log object. Returned by `eth_getLogs`.\n struct EthGetLogs {\n /// The address of the log's emitter.\n address emitter;\n /// The topics of the log, including the signature, if any.\n bytes32[] topics;\n /// The raw data of the log.\n bytes data;\n /// The block hash.\n bytes32 blockHash;\n /// The block number.\n uint64 blockNumber;\n /// The transaction hash.\n bytes32 transactionHash;\n /// The transaction index in the block.\n uint64 transactionIndex;\n /// The log index.\n uint256 logIndex;\n /// Whether the log was removed.\n bool removed;\n }\n\n /// A single entry in a directory listing. Returned by `readDir`.\n struct DirEntry {\n /// The error message, if any.\n string errorMessage;\n /// The path of the entry.\n string path;\n /// The depth of the entry.\n uint64 depth;\n /// Whether the entry is a directory.\n bool isDir;\n /// Whether the entry is a symlink.\n bool isSymlink;\n }\n\n /// Metadata information about a file.\n ///\n /// This structure is returned from the `fsMetadata` function and represents known\n /// metadata about a file such as its permissions, size, modification\n /// times, etc.\n struct FsMetadata {\n /// True if this metadata is for a directory.\n bool isDir;\n /// True if this metadata is for a symlink.\n bool isSymlink;\n /// The size of the file, in bytes, this metadata is for.\n uint256 length;\n /// True if this metadata is for a readonly (unwritable) file.\n bool readOnly;\n /// The last modification time listed in this metadata.\n uint256 modified;\n /// The last access time of this metadata.\n uint256 accessed;\n /// The creation time listed in this metadata.\n uint256 created;\n }\n\n /// A wallet with a public and private key.\n struct Wallet {\n /// The wallet's address.\n address addr;\n /// The wallet's public key `X`.\n uint256 publicKeyX;\n /// The wallet's public key `Y`.\n uint256 publicKeyY;\n /// The wallet's private key.\n uint256 privateKey;\n }\n\n /// The result of a `tryFfi` call.\n struct FfiResult {\n /// The exit code of the call.\n int32 exitCode;\n /// The optionally hex-decoded `stdout` data.\n bytes stdout;\n /// The `stderr` data.\n bytes stderr;\n }\n\n /// Information on the chain and fork.\n struct ChainInfo {\n /// The fork identifier. Set to zero if no fork is active.\n uint256 forkId;\n /// The chain ID of the current fork.\n uint256 chainId;\n }\n\n /// Information about a blockchain.\n struct Chain {\n /// The chain name.\n string name;\n /// The chain's Chain ID.\n uint256 chainId;\n /// The chain's alias. (i.e. what gets specified in `foundry.toml`).\n string chainAlias;\n /// A default RPC endpoint for this chain.\n string rpcUrl;\n }\n\n /// The storage accessed during an `AccountAccess`.\n struct StorageAccess {\n /// The account whose storage was accessed.\n address account;\n /// The slot that was accessed.\n bytes32 slot;\n /// If the access was a write.\n bool isWrite;\n /// The previous value of the slot.\n bytes32 previousValue;\n /// The new value of the slot.\n bytes32 newValue;\n /// If the access was reverted.\n bool reverted;\n }\n\n /// An EIP-2930 access list item.\n struct AccessListItem {\n /// The address to be added in access list.\n address target;\n /// The storage keys to be added in access list.\n bytes32[] storageKeys;\n }\n\n /// The result of a `stopAndReturnStateDiff` call.\n struct AccountAccess {\n /// The chain and fork the access occurred.\n ChainInfo chainInfo;\n /// The kind of account access that determines what the account is.\n /// If kind is Call, DelegateCall, StaticCall or CallCode, then the account is the callee.\n /// If kind is Create, then the account is the newly created account.\n /// If kind is SelfDestruct, then the account is the selfdestruct recipient.\n /// If kind is a Resume, then account represents a account context that has resumed.\n AccountAccessKind kind;\n /// The account that was accessed.\n /// It's either the account created, callee or a selfdestruct recipient for CREATE, CALL or SELFDESTRUCT.\n address account;\n /// What accessed the account.\n address accessor;\n /// If the account was initialized or empty prior to the access.\n /// An account is considered initialized if it has code, a\n /// non-zero nonce, or a non-zero balance.\n bool initialized;\n /// The previous balance of the accessed account.\n uint256 oldBalance;\n /// The potential new balance of the accessed account.\n /// That is, all balance changes are recorded here, even if reverts occurred.\n uint256 newBalance;\n /// Code of the account deployed by CREATE.\n bytes deployedCode;\n /// Value passed along with the account access\n uint256 value;\n /// Input data provided to the CREATE or CALL\n bytes data;\n /// If this access reverted in either the current or parent context.\n bool reverted;\n /// An ordered list of storage accesses made during an account access operation.\n StorageAccess[] storageAccesses;\n /// Call depth traversed during the recording of state differences\n uint64 depth;\n /// The previous nonce of the accessed account.\n uint64 oldNonce;\n /// The new nonce of the accessed account.\n uint64 newNonce;\n }\n\n /// The result of the `stopDebugTraceRecording` call\n struct DebugStep {\n /// The stack before executing the step of the run.\n /// stack\\[0\\] represents the top of the stack.\n /// and only stack data relevant to the opcode execution is contained.\n uint256[] stack;\n /// The memory input data before executing the step of the run.\n /// only input data relevant to the opcode execution is contained.\n ///\n /// e.g. for MLOAD, it will have memory\\[offset:offset+32\\] copied here.\n /// the offset value can be get by the stack data.\n bytes memoryInput;\n /// The opcode that was accessed.\n uint8 opcode;\n /// The call depth of the step.\n uint64 depth;\n /// Whether the call end up with out of gas error.\n bool isOutOfGas;\n /// The contract address where the opcode is running\n address contractAddr;\n }\n\n /// The transaction type (`txType`) of the broadcast.\n enum BroadcastTxType {\n /// Represents a CALL broadcast tx.\n Call,\n /// Represents a CREATE broadcast tx.\n Create,\n /// Represents a CREATE2 broadcast tx.\n Create2\n }\n\n /// Represents a transaction's broadcast details.\n struct BroadcastTxSummary {\n /// The hash of the transaction that was broadcasted\n bytes32 txHash;\n /// Represent the type of transaction among CALL, CREATE, CREATE2\n BroadcastTxType txType;\n /// The address of the contract that was called or created.\n /// This is address of the contract that is created if the txType is CREATE or CREATE2.\n address contractAddress;\n /// The block number the transaction landed in.\n uint64 blockNumber;\n /// Status of the transaction, retrieved from the transaction receipt.\n bool success;\n }\n\n /// Holds a signed EIP-7702 authorization for an authority account to delegate to an implementation.\n struct SignedDelegation {\n /// The y-parity of the recovered secp256k1 signature (0 or 1).\n uint8 v;\n /// First 32 bytes of the signature.\n bytes32 r;\n /// Second 32 bytes of the signature.\n bytes32 s;\n /// The current nonce of the authority account at signing time.\n /// Used to ensure signature can't be replayed after account nonce changes.\n uint64 nonce;\n /// Address of the contract implementation that will be delegated to.\n /// Gets encoded into delegation code: 0xef0100 || implementation.\n address implementation;\n }\n\n /// Represents a \"potential\" revert reason from a single subsequent call when using `vm.assumeNoReverts`.\n /// Reverts that match will result in a FOUNDRY::ASSUME rejection, whereas unmatched reverts will be surfaced\n /// as normal.\n struct PotentialRevert {\n /// The allowed origin of the revert opcode; address(0) allows reverts from any address\n address reverter;\n /// When true, only matches on the beginning of the revert data, otherwise, matches on entire revert data\n bool partialMatch;\n /// The data to use to match encountered reverts\n bytes revertData;\n }\n\n // ======== EVM ========\n\n /// Gets the address for a given private key.\n #[cheatcode(group = Evm, safety = Safe)]\n function addr(uint256 privateKey) external pure returns (address keyAddr);\n\n /// Dump a genesis JSON file's `allocs` to disk.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function dumpState(string calldata pathToStateJson) external;\n\n /// Gets the nonce of an account.\n #[cheatcode(group = Evm, safety = Safe)]\n function getNonce(address account) external view returns (uint64 nonce);\n\n /// Get the nonce of a `Wallet`.\n #[cheatcode(group = Evm, safety = Safe)]\n function getNonce(Wallet calldata wallet) external view returns (uint64 nonce);\n\n /// Loads a storage slot from an address.\n #[cheatcode(group = Evm, safety = Safe)]\n function load(address target, bytes32 slot) external view returns (bytes32 data);\n\n /// Load a genesis JSON file's `allocs` into the in-memory EVM state.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function loadAllocs(string calldata pathToAllocsJson) external;\n\n // -------- Record Debug Traces --------\n\n /// Records the debug trace during the run.\n #[cheatcode(group = Evm, safety = Safe)]\n function startDebugTraceRecording() external;\n\n /// Stop debug trace recording and returns the recorded debug trace.\n #[cheatcode(group = Evm, safety = Safe)]\n function stopAndReturnDebugTraceRecording() external returns (DebugStep[] memory step);\n\n\n /// Clones a source account code, state, balance and nonce to a target account and updates in-memory EVM state.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function cloneAccount(address source, address target) external;\n\n // -------- Record Storage --------\n\n /// Records all storage reads and writes. Use `accesses` to get the recorded data.\n /// Subsequent calls to `record` will clear the previous data.\n #[cheatcode(group = Evm, safety = Safe)]\n function record() external;\n\n /// Stops recording storage reads and writes.\n #[cheatcode(group = Evm, safety = Safe)]\n function stopRecord() external;\n\n /// Gets all accessed reads and write slot from a `vm.record` session, for a given address.\n #[cheatcode(group = Evm, safety = Safe)]\n function accesses(address target) external view returns (bytes32[] memory readSlots, bytes32[] memory writeSlots);\n\n /// Record all account accesses as part of CREATE, CALL or SELFDESTRUCT opcodes in order,\n /// along with the context of the calls\n #[cheatcode(group = Evm, safety = Safe)]\n function startStateDiffRecording() external;\n\n /// Returns an ordered array of all account accesses from a `vm.startStateDiffRecording` session.\n #[cheatcode(group = Evm, safety = Safe)]\n function stopAndReturnStateDiff() external returns (AccountAccess[] memory accountAccesses);\n\n /// Returns state diffs from current `vm.startStateDiffRecording` session.\n #[cheatcode(group = Evm, safety = Safe)]\n function getStateDiff() external view returns (string memory diff);\n\n /// Returns state diffs from current `vm.startStateDiffRecording` session, in json format.\n #[cheatcode(group = Evm, safety = Safe)]\n function getStateDiffJson() external view returns (string memory diff);\n\n /// Returns an array of storage slots occupied by the specified variable.\n #[cheatcode(group = Evm, safety = Safe)]\n function getStorageSlots(address target, string calldata variableName) external view returns (uint256[] memory slots);\n\n /// Returns an array of `StorageAccess` from current `vm.stateStateDiffRecording` session\n #[cheatcode(group = Evm, safety = Safe)]\n function getStorageAccesses() external view returns (StorageAccess[] memory storageAccesses);\n\n // -------- Recording Map Writes --------\n\n /// Starts recording all map SSTOREs for later retrieval.\n #[cheatcode(group = Evm, safety = Safe)]\n function startMappingRecording() external;\n\n /// Stops recording all map SSTOREs for later retrieval and clears the recorded data.\n #[cheatcode(group = Evm, safety = Safe)]\n function stopMappingRecording() external;\n\n /// Gets the number of elements in the mapping at the given slot, for a given address.\n #[cheatcode(group = Evm, safety = Safe)]\n function getMappingLength(address target, bytes32 mappingSlot) external view returns (uint256 length);\n\n /// Gets the elements at index idx of the mapping at the given slot, for a given address. The\n /// index must be less than the length of the mapping (i.e. the number of keys in the mapping).\n #[cheatcode(group = Evm, safety = Safe)]\n function getMappingSlotAt(address target, bytes32 mappingSlot, uint256 idx) external view returns (bytes32 value);\n\n /// Gets the map key and parent of a mapping at a given slot, for a given address.\n #[cheatcode(group = Evm, safety = Safe)]\n function getMappingKeyAndParentOf(address target, bytes32 elementSlot)\n external\n view\n returns (bool found, bytes32 key, bytes32 parent);\n\n // -------- Block and Transaction Properties --------\n\n /// Gets the current `block.chainid` of the currently selected environment.\n /// You should use this instead of `block.chainid` if you use `vm.selectFork` or `vm.createSelectFork`, as `block.chainid` could be assumed\n /// to be constant across a transaction, and as a result will get optimized out by the compiler.\n /// See https://github.com/foundry-rs/foundry/issues/6180\n #[cheatcode(group = Evm, safety = Safe)]\n function getChainId() external view returns (uint256 blockChainId);\n\n /// Sets `block.chainid`.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function chainId(uint256 newChainId) external;\n\n /// Sets `block.coinbase`.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function coinbase(address newCoinbase) external;\n\n /// Sets `block.difficulty`.\n /// Not available on EVM versions from Paris onwards. Use `prevrandao` instead.\n /// Reverts if used on unsupported EVM versions.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function difficulty(uint256 newDifficulty) external;\n\n /// Sets `block.basefee`.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function fee(uint256 newBasefee) external;\n\n /// Sets `block.prevrandao`.\n /// Not available on EVM versions before Paris. Use `difficulty` instead.\n /// If used on unsupported EVM versions it will revert.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function prevrandao(bytes32 newPrevrandao) external;\n /// Sets `block.prevrandao`.\n /// Not available on EVM versions before Paris. Use `difficulty` instead.\n /// If used on unsupported EVM versions it will revert.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function prevrandao(uint256 newPrevrandao) external;\n\n /// Sets the blobhashes in the transaction.\n /// Not available on EVM versions before Cancun.\n /// If used on unsupported EVM versions it will revert.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function blobhashes(bytes32[] calldata hashes) external;\n\n /// Gets the blockhashes from the current transaction.\n /// Not available on EVM versions before Cancun.\n /// If used on unsupported EVM versions it will revert.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function getBlobhashes() external view returns (bytes32[] memory hashes);\n\n /// Sets `block.height`.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function roll(uint256 newHeight) external;\n\n /// Gets the current `block.number`.\n /// You should use this instead of `block.number` if you use `vm.roll`, as `block.number` is assumed to be constant across a transaction,\n /// and as a result will get optimized out by the compiler.\n /// See https://github.com/foundry-rs/foundry/issues/6180\n #[cheatcode(group = Evm, safety = Safe)]\n function getBlockNumber() external view returns (uint256 height);\n\n /// Sets `tx.gasprice`.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function txGasPrice(uint256 newGasPrice) external;\n\n /// Sets `block.timestamp`.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function warp(uint256 newTimestamp) external;\n\n /// Gets the current `block.timestamp`.\n /// You should use this instead of `block.timestamp` if you use `vm.warp`, as `block.timestamp` is assumed to be constant across a transaction,\n /// and as a result will get optimized out by the compiler.\n /// See https://github.com/foundry-rs/foundry/issues/6180\n #[cheatcode(group = Evm, safety = Safe)]\n function getBlockTimestamp() external view returns (uint256 timestamp);\n\n /// Gets the RLP encoded block header for a given block number.\n /// Returns the block header in the same format as `cast block --raw`.\n #[cheatcode(group = Evm, safety = Safe)]\n function getRawBlockHeader(uint256 blockNumber) external view returns (bytes memory rlpHeader);\n\n /// Sets `block.blobbasefee`\n #[cheatcode(group = Evm, safety = Unsafe)]\n function blobBaseFee(uint256 newBlobBaseFee) external;\n\n /// Gets the current `block.blobbasefee`.\n /// You should use this instead of `block.blobbasefee` if you use `vm.blobBaseFee`, as `block.blobbasefee` is assumed to be constant across a transaction,\n /// and as a result will get optimized out by the compiler.\n /// See https://github.com/foundry-rs/foundry/issues/6180\n #[cheatcode(group = Evm, safety = Safe)]\n function getBlobBaseFee() external view returns (uint256 blobBaseFee);\n\n /// Set blockhash for the current block.\n /// It only sets the blockhash for blocks where `block.number - 256 <= number < block.number`.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function setBlockhash(uint256 blockNumber, bytes32 blockHash) external;\n\n /// Executes an RLP-encoded signed transaction with full EVM semantics (like `--isolate` mode).\n /// The transaction is decoded from EIP-2718 format (type byte prefix + RLP payload) or legacy RLP.\n /// Returns the execution output bytes.\n ///\n /// This cheatcode is not allowed in `forge script` contexts.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function executeTransaction(bytes calldata rawTx) external returns (bytes memory);\n\n // -------- Account State --------\n\n /// Sets an address' balance.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function deal(address account, uint256 newBalance) external;\n\n /// Sets an address' code.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function etch(address target, bytes calldata newRuntimeBytecode) external;\n\n /// Resets the nonce of an account to 0 for EOAs and 1 for contract accounts.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function resetNonce(address account) external;\n\n /// Sets the nonce of an account. Must be higher than the current nonce of the account.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function setNonce(address account, uint64 newNonce) external;\n\n /// Sets the nonce of an account to an arbitrary value.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function setNonceUnsafe(address account, uint64 newNonce) external;\n\n /// Stores a value to an address' storage slot.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function store(address target, bytes32 slot, bytes32 value) external;\n\n /// Marks the slots of an account and the account address as cold.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function cool(address target) external;\n\n /// Utility cheatcode to set an EIP-2930 access list for all subsequent transactions.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function accessList(AccessListItem[] calldata access) external;\n\n /// Utility cheatcode to remove any EIP-2930 access list set by `accessList` cheatcode.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function noAccessList() external;\n\n /// Utility cheatcode to mark specific storage slot as warm, simulating a prior read.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function warmSlot(address target, bytes32 slot) external;\n\n /// Utility cheatcode to mark specific storage slot as cold, simulating no prior read.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function coolSlot(address target, bytes32 slot) external;\n\n /// Returns the test or script execution evm version.\n ///\n /// **Note:** The execution evm version is not the same as the compilation one.\n #[cheatcode(group = Evm, safety = Safe)]\n function getEvmVersion() external pure returns (string memory evm);\n\n /// Set the exact test or script execution evm version, e.g. `berlin`, `cancun`.\n ///\n /// **Note:** The execution evm version is not the same as the compilation one.\n #[cheatcode(group = Evm, safety = Safe)]\n function setEvmVersion(string calldata evm) external;\n\n // -------- Call Manipulation --------\n // --- Mocks ---\n\n /// Clears all mocked calls.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function clearMockedCalls() external;\n\n /// Mocks a call to an address, returning specified data.\n /// Calldata can either be strict or a partial match, e.g. if you only\n /// pass a Solidity selector to the expected calldata, then the entire Solidity\n /// function will be mocked.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function mockCall(address callee, bytes calldata data, bytes calldata returnData) external;\n\n /// Mocks a call to an address with a specific `msg.value`, returning specified data.\n /// Calldata match takes precedence over `msg.value` in case of ambiguity.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function mockCall(address callee, uint256 msgValue, bytes calldata data, bytes calldata returnData) external;\n\n /// Mocks a call to an address, returning specified data.\n /// Calldata can either be strict or a partial match, e.g. if you only\n /// pass a Solidity selector to the expected calldata, then the entire Solidity\n /// function will be mocked.\n ///\n /// Overload to pass the function selector directly `token.approve.selector` instead of `abi.encodeWithSelector(token.approve.selector)`.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function mockCall(address callee, bytes4 data, bytes calldata returnData) external;\n\n /// Mocks a call to an address with a specific `msg.value`, returning specified data.\n /// Calldata match takes precedence over `msg.value` in case of ambiguity.\n ///\n /// Overload to pass the function selector directly `token.approve.selector` instead of `abi.encodeWithSelector(token.approve.selector)`.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function mockCall(address callee, uint256 msgValue, bytes4 data, bytes calldata returnData) external;\n\n /// Mocks multiple calls to an address, returning specified data for each call.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function mockCalls(address callee, bytes calldata data, bytes[] calldata returnData) external;\n\n /// Mocks multiple calls to an address with a specific `msg.value`, returning specified data for each call.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function mockCalls(address callee, uint256 msgValue, bytes calldata data, bytes[] calldata returnData) external;\n\n /// Reverts a call to an address with specified revert data.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function mockCallRevert(address callee, bytes calldata data, bytes calldata revertData) external;\n\n /// Reverts a call to an address with a specific `msg.value`, with specified revert data.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function mockCallRevert(address callee, uint256 msgValue, bytes calldata data, bytes calldata revertData)\n external;\n\n /// Reverts a call to an address with specified revert data.\n ///\n /// Overload to pass the function selector directly `token.approve.selector` instead of `abi.encodeWithSelector(token.approve.selector)`.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function mockCallRevert(address callee, bytes4 data, bytes calldata revertData) external;\n\n /// Reverts a call to an address with a specific `msg.value`, with specified revert data.\n ///\n /// Overload to pass the function selector directly `token.approve.selector` instead of `abi.encodeWithSelector(token.approve.selector)`.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function mockCallRevert(address callee, uint256 msgValue, bytes4 data, bytes calldata revertData)\n external;\n\n /// Whenever a call is made to `callee` with calldata `data`, this cheatcode instead calls\n /// `target` with the same calldata. This functionality is similar to a delegate call made to\n /// `target` contract from `callee`.\n /// Can be used to substitute a call to a function with another implementation that captures\n /// the primary logic of the original function but is easier to reason about.\n /// If calldata is not a strict match then partial match by selector is attempted.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function mockFunction(address callee, address target, bytes calldata data) external;\n\n // --- Impersonation (pranks) ---\n\n /// Sets the *next* call's `msg.sender` to be the input address.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function prank(address msgSender) external;\n\n /// Sets all subsequent calls' `msg.sender` to be the input address until `stopPrank` is called.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function startPrank(address msgSender) external;\n\n /// Sets the *next* call's `msg.sender` to be the input address, and the `tx.origin` to be the second input.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function prank(address msgSender, address txOrigin) external;\n\n /// Sets all subsequent calls' `msg.sender` to be the input address until `stopPrank` is called, and the `tx.origin` to be the second input.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function startPrank(address msgSender, address txOrigin) external;\n\n /// Sets the *next* delegate call's `msg.sender` to be the input address.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function prank(address msgSender, bool delegateCall) external;\n\n /// Sets all subsequent delegate calls' `msg.sender` to be the input address until `stopPrank` is called.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function startPrank(address msgSender, bool delegateCall) external;\n\n /// Sets the *next* delegate call's `msg.sender` to be the input address, and the `tx.origin` to be the second input.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function prank(address msgSender, address txOrigin, bool delegateCall) external;\n\n /// Sets all subsequent delegate calls' `msg.sender` to be the input address until `stopPrank` is called, and the `tx.origin` to be the second input.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function startPrank(address msgSender, address txOrigin, bool delegateCall) external;\n\n /// Resets subsequent calls' `msg.sender` to be `address(this)`.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function stopPrank() external;\n\n /// Reads the current `msg.sender` and `tx.origin` from state and reports if there is any active caller modification.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function readCallers() external view returns (CallerMode callerMode, address msgSender, address txOrigin);\n\n // ----- Arbitrary Snapshots -----\n\n /// Snapshot capture an arbitrary numerical value by name.\n /// The group name is derived from the contract name.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function snapshotValue(string calldata name, uint256 value) external;\n\n /// Snapshot capture an arbitrary numerical value by name in a group.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function snapshotValue(string calldata group, string calldata name, uint256 value) external;\n\n // -------- Gas Snapshots --------\n\n /// Snapshot capture the gas usage of the last call by name from the callee perspective.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function snapshotGasLastCall(string calldata name) external returns (uint256 gasUsed);\n\n /// Snapshot capture the gas usage of the last call by name in a group from the callee perspective.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function snapshotGasLastCall(string calldata group, string calldata name) external returns (uint256 gasUsed);\n\n /// Start a snapshot capture of the current gas usage by name.\n /// The group name is derived from the contract name.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function startSnapshotGas(string calldata name) external;\n\n /// Start a snapshot capture of the current gas usage by name in a group.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function startSnapshotGas(string calldata group, string calldata name) external;\n\n /// Stop the snapshot capture of the current gas by latest snapshot name, capturing the gas used since the start.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function stopSnapshotGas() external returns (uint256 gasUsed);\n\n /// Stop the snapshot capture of the current gas usage by name, capturing the gas used since the start.\n /// The group name is derived from the contract name.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function stopSnapshotGas(string calldata name) external returns (uint256 gasUsed);\n\n /// Stop the snapshot capture of the current gas usage by name in a group, capturing the gas used since the start.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function stopSnapshotGas(string calldata group, string calldata name) external returns (uint256 gasUsed);\n\n // -------- State Snapshots --------\n\n /// `snapshot` is being deprecated in favor of `snapshotState`. It will be removed in future versions.\n #[cheatcode(group = Evm, safety = Unsafe, status = Deprecated(Some(\"replaced by `snapshotState`\")))]\n function snapshot() external returns (uint256 snapshotId);\n\n /// Snapshot the current state of the evm.\n /// Returns the ID of the snapshot that was created.\n /// To revert a snapshot use `revertToState`.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function snapshotState() external returns (uint256 snapshotId);\n\n /// `revertTo` is being deprecated in favor of `revertToState`. It will be removed in future versions.\n #[cheatcode(group = Evm, safety = Unsafe, status = Deprecated(Some(\"replaced by `revertToState`\")))]\n function revertTo(uint256 snapshotId) external returns (bool success);\n\n /// Revert the state of the EVM to a previous snapshot\n /// Takes the snapshot ID to revert to.\n ///\n /// Returns `true` if the snapshot was successfully reverted.\n /// Returns `false` if the snapshot does not exist.\n ///\n /// **Note:** This does not automatically delete the snapshot. To delete the snapshot use `deleteStateSnapshot`.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function revertToState(uint256 snapshotId) external returns (bool success);\n\n /// `revertToAndDelete` is being deprecated in favor of `revertToStateAndDelete`. It will be removed in future versions.\n #[cheatcode(group = Evm, safety = Unsafe, status = Deprecated(Some(\"replaced by `revertToStateAndDelete`\")))]\n function revertToAndDelete(uint256 snapshotId) external returns (bool success);\n\n /// Revert the state of the EVM to a previous snapshot and automatically deletes the snapshots\n /// Takes the snapshot ID to revert to.\n ///\n /// Returns `true` if the snapshot was successfully reverted and deleted.\n /// Returns `false` if the snapshot does not exist.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function revertToStateAndDelete(uint256 snapshotId) external returns (bool success);\n\n /// `deleteSnapshot` is being deprecated in favor of `deleteStateSnapshot`. It will be removed in future versions.\n #[cheatcode(group = Evm, safety = Unsafe, status = Deprecated(Some(\"replaced by `deleteStateSnapshot`\")))]\n function deleteSnapshot(uint256 snapshotId) external returns (bool success);\n\n /// Removes the snapshot with the given ID created by `snapshot`.\n /// Takes the snapshot ID to delete.\n ///\n /// Returns `true` if the snapshot was successfully deleted.\n /// Returns `false` if the snapshot does not exist.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function deleteStateSnapshot(uint256 snapshotId) external returns (bool success);\n\n /// `deleteSnapshots` is being deprecated in favor of `deleteStateSnapshots`. It will be removed in future versions.\n #[cheatcode(group = Evm, safety = Unsafe, status = Deprecated(Some(\"replaced by `deleteStateSnapshots`\")))]\n function deleteSnapshots() external;\n\n /// Removes _all_ snapshots previously created by `snapshot`.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function deleteStateSnapshots() external;\n\n // -------- Forking --------\n // --- Creation and Selection ---\n\n /// Returns the identifier of the currently active fork. Reverts if no fork is currently active.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function activeFork() external view returns (uint256 forkId);\n\n /// Creates a new fork with the given endpoint and the _latest_ block and returns the identifier of the fork.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function createFork(string calldata urlOrAlias) external returns (uint256 forkId);\n /// Creates a new fork with the given endpoint and block and returns the identifier of the fork.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function createFork(string calldata urlOrAlias, uint256 blockNumber) external returns (uint256 forkId);\n /// Creates a new fork with the given endpoint and at the block the given transaction was mined in,\n /// replays all transaction mined in the block before the transaction, and returns the identifier of the fork.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function createFork(string calldata urlOrAlias, bytes32 txHash) external returns (uint256 forkId);\n\n /// Creates and also selects a new fork with the given endpoint and the latest block and returns the identifier of the fork.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function createSelectFork(string calldata urlOrAlias) external returns (uint256 forkId);\n /// Creates and also selects a new fork with the given endpoint and block and returns the identifier of the fork.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function createSelectFork(string calldata urlOrAlias, uint256 blockNumber) external returns (uint256 forkId);\n /// Creates and also selects new fork with the given endpoint and at the block the given transaction was mined in,\n /// replays all transaction mined in the block before the transaction, returns the identifier of the fork.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function createSelectFork(string calldata urlOrAlias, bytes32 txHash) external returns (uint256 forkId);\n\n /// Updates the currently active fork to given block number\n /// This is similar to `roll` but for the currently active fork.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function rollFork(uint256 blockNumber) external;\n /// Updates the currently active fork to given transaction. This will `rollFork` with the number\n /// of the block the transaction was mined in and replays all transaction mined before it in the block.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function rollFork(bytes32 txHash) external;\n /// Updates the given fork to given block number.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function rollFork(uint256 forkId, uint256 blockNumber) external;\n /// Updates the given fork to block number of the given transaction and replays all transaction mined before it in the block.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function rollFork(uint256 forkId, bytes32 txHash) external;\n\n /// Takes a fork identifier created by `createFork` and sets the corresponding forked state as active.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function selectFork(uint256 forkId) external;\n\n /// Fetches the given transaction from the active fork and executes it on the current state.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function transact(bytes32 txHash) external;\n /// Fetches the given transaction from the given fork and executes it on the current state.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function transact(uint256 forkId, bytes32 txHash) external;\n\n /// Performs an Ethereum JSON-RPC request to the current fork URL.\n #[cheatcode(group = Evm, safety = Safe)]\n function rpc(string calldata method, string calldata params) external returns (bytes memory data);\n\n /// Performs an Ethereum JSON-RPC request to the given endpoint.\n #[cheatcode(group = Evm, safety = Safe)]\n function rpc(string calldata urlOrAlias, string calldata method, string calldata params)\n external\n returns (bytes memory data);\n\n /// Gets all the logs according to specified filter.\n #[cheatcode(group = Evm, safety = Safe)]\n function eth_getLogs(uint256 fromBlock, uint256 toBlock, address target, bytes32[] calldata topics)\n external\n view\n returns (EthGetLogs[] memory logs);\n\n // --- Behavior ---\n\n /// In forking mode, explicitly grant the given address cheatcode access.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function allowCheatcodes(address account) external;\n\n /// Marks that the account(s) should use persistent storage across fork swaps in a multifork setup\n /// Meaning, changes made to the state of this account will be kept when switching forks.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function makePersistent(address account) external;\n /// See `makePersistent(address)`.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function makePersistent(address account0, address account1) external;\n /// See `makePersistent(address)`.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function makePersistent(address account0, address account1, address account2) external;\n /// See `makePersistent(address)`.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function makePersistent(address[] calldata accounts) external;\n\n /// Revokes persistent status from the address, previously added via `makePersistent`.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function revokePersistent(address account) external;\n /// See `revokePersistent(address)`.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function revokePersistent(address[] calldata accounts) external;\n\n /// Returns true if the account is marked as persistent.\n #[cheatcode(group = Evm, safety = Unsafe)]\n function isPersistent(address account) external view returns (bool persistent);\n\n // -------- Record Logs --------\n\n /// Record all the transaction logs.\n #[cheatcode(group = Evm, safety = Safe)]\n function recordLogs() external;\n\n /// Gets all the recorded logs.\n #[cheatcode(group = Evm, safety = Safe)]\n function getRecordedLogs() external view returns (Log[] memory logs);\n\n /// Gets all the recorded logs, in JSON format.\n #[cheatcode(group = Evm, safety = Safe)]\n function getRecordedLogsJson() external view returns (string memory logsJson);\n\n // -------- Gas Metering --------\n\n // It's recommend to use the `noGasMetering` modifier included with forge-std, instead of\n // using these functions directly.\n\n /// Pauses gas metering (i.e. gas usage is not counted). Noop if already paused.\n #[cheatcode(group = Evm, safety = Safe)]\n function pauseGasMetering() external;\n\n /// Resumes gas metering (i.e. gas usage is counted again). Noop if already on.\n #[cheatcode(group = Evm, safety = Safe)]\n function resumeGasMetering() external;\n\n /// Reset gas metering (i.e. gas usage is set to gas limit).\n #[cheatcode(group = Evm, safety = Safe)]\n function resetGasMetering() external;\n\n // -------- Gas Measurement --------\n\n /// Gets the gas used in the last call from the callee perspective.\n #[cheatcode(group = Evm, safety = Safe)]\n function lastCallGas() external view returns (Gas memory gas);\n\n // ======== Test Assertions and Utilities ========\n\n /// If the condition is false, discard this run's fuzz inputs and generate new ones.\n #[cheatcode(group = Testing, safety = Safe)]\n function assume(bool condition) external pure;\n\n /// Discard this run's fuzz inputs and generate new ones if next call reverted.\n #[cheatcode(group = Testing, safety = Safe)]\n function assumeNoRevert() external pure;\n\n /// Discard this run's fuzz inputs and generate new ones if next call reverts with the potential revert parameters.\n #[cheatcode(group = Testing, safety = Safe)]\n function assumeNoRevert(PotentialRevert calldata potentialRevert) external pure;\n\n /// Discard this run's fuzz inputs and generate new ones if next call reverts with the any of the potential revert parameters.\n #[cheatcode(group = Testing, safety = Safe)]\n function assumeNoRevert(PotentialRevert[] calldata potentialReverts) external pure;\n\n /// Writes a breakpoint to jump to in the debugger.\n #[cheatcode(group = Testing, safety = Safe)]\n function breakpoint(string calldata char) external pure;\n\n /// Writes a conditional breakpoint to jump to in the debugger.\n #[cheatcode(group = Testing, safety = Safe)]\n function breakpoint(string calldata char, bool value) external pure;\n\n /// Returns the Foundry version.\n /// Format: -+..\n /// Sample output: 0.3.0-nightly+3cb96bde9b.1737036656.debug\n /// Note: Build timestamps may vary slightly across platforms due to separate CI jobs.\n /// For reliable version comparisons, use UNIX format (e.g., >= 1700000000)\n /// to compare timestamps while ignoring minor time differences.\n #[cheatcode(group = Testing, safety = Safe)]\n function getFoundryVersion() external view returns (string memory version);\n\n /// Returns the RPC url for the given alias.\n #[cheatcode(group = Testing, safety = Safe)]\n function rpcUrl(string calldata rpcAlias) external view returns (string memory json);\n\n /// Returns all rpc urls and their aliases `[alias, url][]`.\n #[cheatcode(group = Testing, safety = Safe)]\n function rpcUrls() external view returns (string[2][] memory urls);\n\n /// Returns all rpc urls and their aliases as structs.\n #[cheatcode(group = Testing, safety = Safe)]\n function rpcUrlStructs() external view returns (Rpc[] memory urls);\n\n /// Returns a Chain struct for specific alias\n #[cheatcode(group = Testing, safety = Safe)]\n function getChain(string calldata chainAlias) external view returns (Chain memory chain);\n\n /// Returns a Chain struct for specific chainId\n #[cheatcode(group = Testing, safety = Safe)]\n function getChain(uint256 chainId) external view returns (Chain memory chain);\n\n /// Suspends execution of the main thread for `duration` milliseconds.\n #[cheatcode(group = Testing, safety = Safe)]\n function sleep(uint256 duration) external;\n\n /// Expects a call to an address with the specified calldata.\n /// Calldata can either be a strict or a partial match.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectCall(address callee, bytes calldata data) external;\n\n /// Expects given number of calls to an address with the specified calldata.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectCall(address callee, bytes calldata data, uint64 count) external;\n\n /// Expects a call to an address with the specified `msg.value` and calldata.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectCall(address callee, uint256 msgValue, bytes calldata data) external;\n\n /// Expects given number of calls to an address with the specified `msg.value` and calldata.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectCall(address callee, uint256 msgValue, bytes calldata data, uint64 count) external;\n\n /// Expect a call to an address with the specified `msg.value`, gas, and calldata.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectCall(address callee, uint256 msgValue, uint64 gas, bytes calldata data) external;\n\n /// Expects given number of calls to an address with the specified `msg.value`, gas, and calldata.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectCall(address callee, uint256 msgValue, uint64 gas, bytes calldata data, uint64 count) external;\n\n /// Expect a call to an address with the specified `msg.value` and calldata, and a *minimum* amount of gas.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectCallMinGas(address callee, uint256 msgValue, uint64 minGas, bytes calldata data) external;\n\n /// Expect given number of calls to an address with the specified `msg.value` and calldata, and a *minimum* amount of gas.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectCallMinGas(address callee, uint256 msgValue, uint64 minGas, bytes calldata data, uint64 count)\n external;\n\n /// Prepare an expected log with (bool checkTopic1, bool checkTopic2, bool checkTopic3, bool checkData.).\n /// Call this function, then emit an event, then call a function. Internally after the call, we check if\n /// logs were emitted in the expected order with the expected topics and data (as specified by the booleans).\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectEmit(bool checkTopic1, bool checkTopic2, bool checkTopic3, bool checkData) external;\n\n /// Same as the previous method, but also checks supplied address against emitting contract.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectEmit(bool checkTopic1, bool checkTopic2, bool checkTopic3, bool checkData, address emitter)\n external;\n\n /// Prepare an expected log with all topic and data checks enabled.\n /// Call this function, then emit an event, then call a function. Internally after the call, we check if\n /// logs were emitted in the expected order with the expected topics and data.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectEmit() external;\n\n /// Same as the previous method, but also checks supplied address against emitting contract.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectEmit(address emitter) external;\n\n /// Expect a given number of logs with the provided topics.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectEmit(bool checkTopic1, bool checkTopic2, bool checkTopic3, bool checkData, uint64 count) external;\n\n /// Expect a given number of logs from a specific emitter with the provided topics.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectEmit(bool checkTopic1, bool checkTopic2, bool checkTopic3, bool checkData, address emitter, uint64 count)\n external;\n\n /// Expect a given number of logs with all topic and data checks enabled.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectEmit(uint64 count) external;\n\n /// Expect a given number of logs from a specific emitter with all topic and data checks enabled.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectEmit(address emitter, uint64 count) external;\n\n /// Prepare an expected anonymous log with (bool checkTopic1, bool checkTopic2, bool checkTopic3, bool checkData.).\n /// Call this function, then emit an anonymous event, then call a function. Internally after the call, we check if\n /// logs were emitted in the expected order with the expected topics and data (as specified by the booleans).\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectEmitAnonymous(bool checkTopic0, bool checkTopic1, bool checkTopic2, bool checkTopic3, bool checkData) external;\n\n /// Same as the previous method, but also checks supplied address against emitting contract.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectEmitAnonymous(bool checkTopic0, bool checkTopic1, bool checkTopic2, bool checkTopic3, bool checkData, address emitter)\n external;\n\n /// Prepare an expected anonymous log with all topic and data checks enabled.\n /// Call this function, then emit an anonymous event, then call a function. Internally after the call, we check if\n /// logs were emitted in the expected order with the expected topics and data.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectEmitAnonymous() external;\n\n /// Same as the previous method, but also checks supplied address against emitting contract.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectEmitAnonymous(address emitter) external;\n\n /// Expects the deployment of the specified bytecode by the specified address using the CREATE opcode\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectCreate(bytes calldata bytecode, address deployer) external;\n\n /// Expects the deployment of the specified bytecode by the specified address using the CREATE2 opcode\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectCreate2(bytes calldata bytecode, address deployer) external;\n\n /// Expects an error on next call with any revert data.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectRevert() external;\n\n /// Expects an error on next call that exactly matches the revert data.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectRevert(bytes4 revertData) external;\n\n /// Expects an error on next call that exactly matches the revert data.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectRevert(bytes calldata revertData) external;\n\n /// Expects an error with any revert data on next call to reverter address.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectRevert(address reverter) external;\n\n /// Expects an error from reverter address on next call, with any revert data.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectRevert(bytes4 revertData, address reverter) external;\n\n /// Expects an error from reverter address on next call, that exactly matches the revert data.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectRevert(bytes calldata revertData, address reverter) external;\n\n /// Expects a `count` number of reverts from the upcoming calls with any revert data or reverter.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectRevert(uint64 count) external;\n\n /// Expects a `count` number of reverts from the upcoming calls that match the revert data.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectRevert(bytes4 revertData, uint64 count) external;\n\n /// Expects a `count` number of reverts from the upcoming calls that exactly match the revert data.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectRevert(bytes calldata revertData, uint64 count) external;\n\n /// Expects a `count` number of reverts from the upcoming calls from the reverter address.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectRevert(address reverter, uint64 count) external;\n\n /// Expects a `count` number of reverts from the upcoming calls from the reverter address that match the revert data.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectRevert(bytes4 revertData, address reverter, uint64 count) external;\n\n /// Expects a `count` number of reverts from the upcoming calls from the reverter address that exactly match the revert data.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectRevert(bytes calldata revertData, address reverter, uint64 count) external;\n\n /// Expects an error on next call that starts with the revert data.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectPartialRevert(bytes4 revertData) external;\n\n /// Expects an error on next call to reverter address, that starts with the revert data.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectPartialRevert(bytes4 revertData, address reverter) external;\n\n /// Expects an error on next cheatcode call with any revert data.\n #[cheatcode(group = Testing, safety = Unsafe, status = Internal)]\n function _expectCheatcodeRevert() external;\n\n /// Expects an error on next cheatcode call that starts with the revert data.\n #[cheatcode(group = Testing, safety = Unsafe, status = Internal)]\n function _expectCheatcodeRevert(bytes4 revertData) external;\n\n /// Expects an error on next cheatcode call that exactly matches the revert data.\n #[cheatcode(group = Testing, safety = Unsafe, status = Internal)]\n function _expectCheatcodeRevert(bytes calldata revertData) external;\n\n /// Only allows memory writes to offsets [0x00, 0x60) āˆŖ [min, max) in the current subcontext. If any other\n /// memory is written to, the test will fail. Can be called multiple times to add more ranges to the set.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectSafeMemory(uint64 min, uint64 max) external;\n\n /// Stops all safe memory expectation in the current subcontext.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function stopExpectSafeMemory() external;\n\n /// Only allows memory writes to offsets [0x00, 0x60) āˆŖ [min, max) in the next created subcontext.\n /// If any other memory is written to, the test will fail. Can be called multiple times to add more ranges\n /// to the set.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function expectSafeMemoryCall(uint64 min, uint64 max) external;\n\n /// Marks a test as skipped. Must be called at the top level of a test.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function skip(bool skipTest) external;\n\n /// Marks a test as skipped with a reason. Must be called at the top level of a test.\n #[cheatcode(group = Testing, safety = Unsafe)]\n function skip(bool skipTest, string calldata reason) external;\n\n /// Asserts that the given condition is true.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertTrue(bool condition) external pure;\n\n /// Asserts that the given condition is true and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertTrue(bool condition, string calldata error) external pure;\n\n /// Asserts that the given condition is false.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertFalse(bool condition) external pure;\n\n /// Asserts that the given condition is false and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertFalse(bool condition, string calldata error) external pure;\n\n /// Asserts that two `bool` values are equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(bool left, bool right) external pure;\n\n /// Asserts that two `bool` values are equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(bool left, bool right, string calldata error) external pure;\n\n /// Asserts that two `uint256` values are equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(uint256 left, uint256 right) external pure;\n\n /// Asserts that two `uint256` values are equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(uint256 left, uint256 right, string calldata error) external pure;\n\n /// Asserts that two `int256` values are equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(int256 left, int256 right) external pure;\n\n /// Asserts that two `int256` values are equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(int256 left, int256 right, string calldata error) external pure;\n\n /// Asserts that two `address` values are equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(address left, address right) external pure;\n\n /// Asserts that two `address` values are equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(address left, address right, string calldata error) external pure;\n\n /// Asserts that two `bytes32` values are equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(bytes32 left, bytes32 right) external pure;\n\n /// Asserts that two `bytes32` values are equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(bytes32 left, bytes32 right, string calldata error) external pure;\n\n /// Asserts that two `string` values are equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(string calldata left, string calldata right) external pure;\n\n /// Asserts that two `string` values are equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(string calldata left, string calldata right, string calldata error) external pure;\n\n /// Asserts that two `bytes` values are equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(bytes calldata left, bytes calldata right) external pure;\n\n /// Asserts that two `bytes` values are equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(bytes calldata left, bytes calldata right, string calldata error) external pure;\n\n /// Asserts that two arrays of `bool` values are equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(bool[] calldata left, bool[] calldata right) external pure;\n\n /// Asserts that two arrays of `bool` values are equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(bool[] calldata left, bool[] calldata right, string calldata error) external pure;\n\n /// Asserts that two arrays of `uint256 values are equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(uint256[] calldata left, uint256[] calldata right) external pure;\n\n /// Asserts that two arrays of `uint256` values are equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(uint256[] calldata left, uint256[] calldata right, string calldata error) external pure;\n\n /// Asserts that two arrays of `int256` values are equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(int256[] calldata left, int256[] calldata right) external pure;\n\n /// Asserts that two arrays of `int256` values are equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(int256[] calldata left, int256[] calldata right, string calldata error) external pure;\n\n /// Asserts that two arrays of `address` values are equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(address[] calldata left, address[] calldata right) external pure;\n\n /// Asserts that two arrays of `address` values are equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(address[] calldata left, address[] calldata right, string calldata error) external pure;\n\n /// Asserts that two arrays of `bytes32` values are equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(bytes32[] calldata left, bytes32[] calldata right) external pure;\n\n /// Asserts that two arrays of `bytes32` values are equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(bytes32[] calldata left, bytes32[] calldata right, string calldata error) external pure;\n\n /// Asserts that two arrays of `string` values are equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(string[] calldata left, string[] calldata right) external pure;\n\n /// Asserts that two arrays of `string` values are equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(string[] calldata left, string[] calldata right, string calldata error) external pure;\n\n /// Asserts that two arrays of `bytes` values are equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(bytes[] calldata left, bytes[] calldata right) external pure;\n\n /// Asserts that two arrays of `bytes` values are equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEq(bytes[] calldata left, bytes[] calldata right, string calldata error) external pure;\n\n /// Asserts that two `uint256` values are equal, formatting them with decimals in failure message.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEqDecimal(uint256 left, uint256 right, uint256 decimals) external pure;\n\n /// Asserts that two `uint256` values are equal, formatting them with decimals in failure message.\n /// Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEqDecimal(uint256 left, uint256 right, uint256 decimals, string calldata error) external pure;\n\n /// Asserts that two `int256` values are equal, formatting them with decimals in failure message.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEqDecimal(int256 left, int256 right, uint256 decimals) external pure;\n\n /// Asserts that two `int256` values are equal, formatting them with decimals in failure message.\n /// Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertEqDecimal(int256 left, int256 right, uint256 decimals, string calldata error) external pure;\n\n /// Asserts that two `bool` values are not equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(bool left, bool right) external pure;\n\n /// Asserts that two `bool` values are not equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(bool left, bool right, string calldata error) external pure;\n\n /// Asserts that two `uint256` values are not equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(uint256 left, uint256 right) external pure;\n\n /// Asserts that two `uint256` values are not equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(uint256 left, uint256 right, string calldata error) external pure;\n\n /// Asserts that two `int256` values are not equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(int256 left, int256 right) external pure;\n\n /// Asserts that two `int256` values are not equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(int256 left, int256 right, string calldata error) external pure;\n\n /// Asserts that two `address` values are not equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(address left, address right) external pure;\n\n /// Asserts that two `address` values are not equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(address left, address right, string calldata error) external pure;\n\n /// Asserts that two `bytes32` values are not equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(bytes32 left, bytes32 right) external pure;\n\n /// Asserts that two `bytes32` values are not equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(bytes32 left, bytes32 right, string calldata error) external pure;\n\n /// Asserts that two `string` values are not equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(string calldata left, string calldata right) external pure;\n\n /// Asserts that two `string` values are not equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(string calldata left, string calldata right, string calldata error) external pure;\n\n /// Asserts that two `bytes` values are not equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(bytes calldata left, bytes calldata right) external pure;\n\n /// Asserts that two `bytes` values are not equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(bytes calldata left, bytes calldata right, string calldata error) external pure;\n\n /// Asserts that two arrays of `bool` values are not equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(bool[] calldata left, bool[] calldata right) external pure;\n\n /// Asserts that two arrays of `bool` values are not equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(bool[] calldata left, bool[] calldata right, string calldata error) external pure;\n\n /// Asserts that two arrays of `uint256` values are not equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(uint256[] calldata left, uint256[] calldata right) external pure;\n\n /// Asserts that two arrays of `uint256` values are not equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(uint256[] calldata left, uint256[] calldata right, string calldata error) external pure;\n\n /// Asserts that two arrays of `int256` values are not equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(int256[] calldata left, int256[] calldata right) external pure;\n\n /// Asserts that two arrays of `int256` values are not equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(int256[] calldata left, int256[] calldata right, string calldata error) external pure;\n\n /// Asserts that two arrays of `address` values are not equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(address[] calldata left, address[] calldata right) external pure;\n\n /// Asserts that two arrays of `address` values are not equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(address[] calldata left, address[] calldata right, string calldata error) external pure;\n\n /// Asserts that two arrays of `bytes32` values are not equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(bytes32[] calldata left, bytes32[] calldata right) external pure;\n\n /// Asserts that two arrays of `bytes32` values are not equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(bytes32[] calldata left, bytes32[] calldata right, string calldata error) external pure;\n\n /// Asserts that two arrays of `string` values are not equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(string[] calldata left, string[] calldata right) external pure;\n\n /// Asserts that two arrays of `string` values are not equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(string[] calldata left, string[] calldata right, string calldata error) external pure;\n\n /// Asserts that two arrays of `bytes` values are not equal.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(bytes[] calldata left, bytes[] calldata right) external pure;\n\n /// Asserts that two arrays of `bytes` values are not equal and includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEq(bytes[] calldata left, bytes[] calldata right, string calldata error) external pure;\n\n /// Asserts that two `uint256` values are not equal, formatting them with decimals in failure message.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEqDecimal(uint256 left, uint256 right, uint256 decimals) external pure;\n\n /// Asserts that two `uint256` values are not equal, formatting them with decimals in failure message.\n /// Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEqDecimal(uint256 left, uint256 right, uint256 decimals, string calldata error) external pure;\n\n /// Asserts that two `int256` values are not equal, formatting them with decimals in failure message.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEqDecimal(int256 left, int256 right, uint256 decimals) external pure;\n\n /// Asserts that two `int256` values are not equal, formatting them with decimals in failure message.\n /// Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertNotEqDecimal(int256 left, int256 right, uint256 decimals, string calldata error) external pure;\n\n /// Compares two `uint256` values. Expects first value to be greater than second.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertGt(uint256 left, uint256 right) external pure;\n\n /// Compares two `uint256` values. Expects first value to be greater than second.\n /// Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertGt(uint256 left, uint256 right, string calldata error) external pure;\n\n /// Compares two `int256` values. Expects first value to be greater than second.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertGt(int256 left, int256 right) external pure;\n\n /// Compares two `int256` values. Expects first value to be greater than second.\n /// Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertGt(int256 left, int256 right, string calldata error) external pure;\n\n /// Compares two `uint256` values. Expects first value to be greater than second.\n /// Formats values with decimals in failure message.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertGtDecimal(uint256 left, uint256 right, uint256 decimals) external pure;\n\n /// Compares two `uint256` values. Expects first value to be greater than second.\n /// Formats values with decimals in failure message. Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertGtDecimal(uint256 left, uint256 right, uint256 decimals, string calldata error) external pure;\n\n /// Compares two `int256` values. Expects first value to be greater than second.\n /// Formats values with decimals in failure message.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertGtDecimal(int256 left, int256 right, uint256 decimals) external pure;\n\n /// Compares two `int256` values. Expects first value to be greater than second.\n /// Formats values with decimals in failure message. Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertGtDecimal(int256 left, int256 right, uint256 decimals, string calldata error) external pure;\n\n /// Compares two `uint256` values. Expects first value to be greater than or equal to second.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertGe(uint256 left, uint256 right) external pure;\n\n /// Compares two `uint256` values. Expects first value to be greater than or equal to second.\n /// Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertGe(uint256 left, uint256 right, string calldata error) external pure;\n\n /// Compares two `int256` values. Expects first value to be greater than or equal to second.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertGe(int256 left, int256 right) external pure;\n\n /// Compares two `int256` values. Expects first value to be greater than or equal to second.\n /// Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertGe(int256 left, int256 right, string calldata error) external pure;\n\n /// Compares two `uint256` values. Expects first value to be greater than or equal to second.\n /// Formats values with decimals in failure message.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertGeDecimal(uint256 left, uint256 right, uint256 decimals) external pure;\n\n /// Compares two `uint256` values. Expects first value to be greater than or equal to second.\n /// Formats values with decimals in failure message. Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertGeDecimal(uint256 left, uint256 right, uint256 decimals, string calldata error) external pure;\n\n /// Compares two `int256` values. Expects first value to be greater than or equal to second.\n /// Formats values with decimals in failure message.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertGeDecimal(int256 left, int256 right, uint256 decimals) external pure;\n\n /// Compares two `int256` values. Expects first value to be greater than or equal to second.\n /// Formats values with decimals in failure message. Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertGeDecimal(int256 left, int256 right, uint256 decimals, string calldata error) external pure;\n\n /// Compares two `uint256` values. Expects first value to be less than second.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertLt(uint256 left, uint256 right) external pure;\n\n /// Compares two `uint256` values. Expects first value to be less than second.\n /// Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertLt(uint256 left, uint256 right, string calldata error) external pure;\n\n /// Compares two `int256` values. Expects first value to be less than second.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertLt(int256 left, int256 right) external pure;\n\n /// Compares two `int256` values. Expects first value to be less than second.\n /// Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertLt(int256 left, int256 right, string calldata error) external pure;\n\n /// Compares two `uint256` values. Expects first value to be less than second.\n /// Formats values with decimals in failure message.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertLtDecimal(uint256 left, uint256 right, uint256 decimals) external pure;\n\n /// Compares two `uint256` values. Expects first value to be less than second.\n /// Formats values with decimals in failure message. Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertLtDecimal(uint256 left, uint256 right, uint256 decimals, string calldata error) external pure;\n\n /// Compares two `int256` values. Expects first value to be less than second.\n /// Formats values with decimals in failure message.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertLtDecimal(int256 left, int256 right, uint256 decimals) external pure;\n\n /// Compares two `int256` values. Expects first value to be less than second.\n /// Formats values with decimals in failure message. Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertLtDecimal(int256 left, int256 right, uint256 decimals, string calldata error) external pure;\n\n /// Compares two `uint256` values. Expects first value to be less than or equal to second.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertLe(uint256 left, uint256 right) external pure;\n\n /// Compares two `uint256` values. Expects first value to be less than or equal to second.\n /// Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertLe(uint256 left, uint256 right, string calldata error) external pure;\n\n /// Compares two `int256` values. Expects first value to be less than or equal to second.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertLe(int256 left, int256 right) external pure;\n\n /// Compares two `int256` values. Expects first value to be less than or equal to second.\n /// Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertLe(int256 left, int256 right, string calldata error) external pure;\n\n /// Compares two `uint256` values. Expects first value to be less than or equal to second.\n /// Formats values with decimals in failure message.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertLeDecimal(uint256 left, uint256 right, uint256 decimals) external pure;\n\n /// Compares two `uint256` values. Expects first value to be less than or equal to second.\n /// Formats values with decimals in failure message. Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertLeDecimal(uint256 left, uint256 right, uint256 decimals, string calldata error) external pure;\n\n /// Compares two `int256` values. Expects first value to be less than or equal to second.\n /// Formats values with decimals in failure message.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertLeDecimal(int256 left, int256 right, uint256 decimals) external pure;\n\n /// Compares two `int256` values. Expects first value to be less than or equal to second.\n /// Formats values with decimals in failure message. Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertLeDecimal(int256 left, int256 right, uint256 decimals, string calldata error) external pure;\n\n /// Compares two `uint256` values. Expects difference to be less than or equal to `maxDelta`.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertApproxEqAbs(uint256 left, uint256 right, uint256 maxDelta) external pure;\n\n /// Compares two `uint256` values. Expects difference to be less than or equal to `maxDelta`.\n /// Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertApproxEqAbs(uint256 left, uint256 right, uint256 maxDelta, string calldata error) external pure;\n\n /// Compares two `int256` values. Expects difference to be less than or equal to `maxDelta`.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertApproxEqAbs(int256 left, int256 right, uint256 maxDelta) external pure;\n\n /// Compares two `int256` values. Expects difference to be less than or equal to `maxDelta`.\n /// Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertApproxEqAbs(int256 left, int256 right, uint256 maxDelta, string calldata error) external pure;\n\n /// Compares two `uint256` values. Expects difference to be less than or equal to `maxDelta`.\n /// Formats values with decimals in failure message.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertApproxEqAbsDecimal(uint256 left, uint256 right, uint256 maxDelta, uint256 decimals) external pure;\n\n /// Compares two `uint256` values. Expects difference to be less than or equal to `maxDelta`.\n /// Formats values with decimals in failure message. Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertApproxEqAbsDecimal(\n uint256 left,\n uint256 right,\n uint256 maxDelta,\n uint256 decimals,\n string calldata error\n ) external pure;\n\n /// Compares two `int256` values. Expects difference to be less than or equal to `maxDelta`.\n /// Formats values with decimals in failure message.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertApproxEqAbsDecimal(int256 left, int256 right, uint256 maxDelta, uint256 decimals) external pure;\n\n /// Compares two `int256` values. Expects difference to be less than or equal to `maxDelta`.\n /// Formats values with decimals in failure message. Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertApproxEqAbsDecimal(\n int256 left,\n int256 right,\n uint256 maxDelta,\n uint256 decimals,\n string calldata error\n ) external pure;\n\n /// Compares two `uint256` values. Expects relative difference in percents to be less than or equal to `maxPercentDelta`.\n /// `maxPercentDelta` is an 18 decimal fixed point number, where 1e18 == 100%\n #[cheatcode(group = Testing, safety = Safe)]\n function assertApproxEqRel(uint256 left, uint256 right, uint256 maxPercentDelta) external pure;\n\n /// Compares two `uint256` values. Expects relative difference in percents to be less than or equal to `maxPercentDelta`.\n /// `maxPercentDelta` is an 18 decimal fixed point number, where 1e18 == 100%\n /// Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertApproxEqRel(uint256 left, uint256 right, uint256 maxPercentDelta, string calldata error) external pure;\n\n /// Compares two `int256` values. Expects relative difference in percents to be less than or equal to `maxPercentDelta`.\n /// `maxPercentDelta` is an 18 decimal fixed point number, where 1e18 == 100%\n #[cheatcode(group = Testing, safety = Safe)]\n function assertApproxEqRel(int256 left, int256 right, uint256 maxPercentDelta) external pure;\n\n /// Compares two `int256` values. Expects relative difference in percents to be less than or equal to `maxPercentDelta`.\n /// `maxPercentDelta` is an 18 decimal fixed point number, where 1e18 == 100%\n /// Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertApproxEqRel(int256 left, int256 right, uint256 maxPercentDelta, string calldata error) external pure;\n\n /// Compares two `uint256` values. Expects relative difference in percents to be less than or equal to `maxPercentDelta`.\n /// `maxPercentDelta` is an 18 decimal fixed point number, where 1e18 == 100%\n /// Formats values with decimals in failure message.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertApproxEqRelDecimal(\n uint256 left,\n uint256 right,\n uint256 maxPercentDelta,\n uint256 decimals\n ) external pure;\n\n /// Compares two `uint256` values. Expects relative difference in percents to be less than or equal to `maxPercentDelta`.\n /// `maxPercentDelta` is an 18 decimal fixed point number, where 1e18 == 100%\n /// Formats values with decimals in failure message. Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertApproxEqRelDecimal(\n uint256 left,\n uint256 right,\n uint256 maxPercentDelta,\n uint256 decimals,\n string calldata error\n ) external pure;\n\n /// Compares two `int256` values. Expects relative difference in percents to be less than or equal to `maxPercentDelta`.\n /// `maxPercentDelta` is an 18 decimal fixed point number, where 1e18 == 100%\n /// Formats values with decimals in failure message.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertApproxEqRelDecimal(\n int256 left,\n int256 right,\n uint256 maxPercentDelta,\n uint256 decimals\n ) external pure;\n\n /// Compares two `int256` values. Expects relative difference in percents to be less than or equal to `maxPercentDelta`.\n /// `maxPercentDelta` is an 18 decimal fixed point number, where 1e18 == 100%\n /// Formats values with decimals in failure message. Includes error message into revert string on failure.\n #[cheatcode(group = Testing, safety = Safe)]\n function assertApproxEqRelDecimal(\n int256 left,\n int256 right,\n uint256 maxPercentDelta,\n uint256 decimals,\n string calldata error\n ) external pure;\n\n /// Returns true if the current Foundry version is greater than or equal to the given version.\n /// The given version string must be in the format `major.minor.patch`.\n ///\n /// This is equivalent to `foundryVersionCmp(version) >= 0`.\n #[cheatcode(group = Testing, safety = Safe)]\n function foundryVersionAtLeast(string calldata version) external view returns (bool);\n\n /// Compares the current Foundry version with the given version string.\n /// The given version string must be in the format `major.minor.patch`.\n ///\n /// Returns:\n /// -1 if current Foundry version is less than the given version\n /// 0 if current Foundry version equals the given version\n /// 1 if current Foundry version is greater than the given version\n ///\n /// This result can then be used with a comparison operator against `0`.\n /// For example, to check if the current Foundry version is greater than or equal to `1.0.0`:\n /// `if (foundryVersionCmp(\"1.0.0\") >= 0) { ... }`\n #[cheatcode(group = Testing, safety = Safe)]\n function foundryVersionCmp(string calldata version) external view returns (int256);\n\n // ======== OS and Filesystem ========\n\n // -------- Metadata --------\n\n /// Returns true if the given path points to an existing entity, else returns false.\n #[cheatcode(group = Filesystem)]\n function exists(string calldata path) external view returns (bool result);\n\n /// Given a path, query the file system to get information about a file, directory, etc.\n #[cheatcode(group = Filesystem)]\n function fsMetadata(string calldata path) external view returns (FsMetadata memory metadata);\n\n /// Returns true if the path exists on disk and is pointing at a directory, else returns false.\n #[cheatcode(group = Filesystem)]\n function isDir(string calldata path) external view returns (bool result);\n\n /// Returns true if the path exists on disk and is pointing at a regular file, else returns false.\n #[cheatcode(group = Filesystem)]\n function isFile(string calldata path) external view returns (bool result);\n\n /// Get the path of the current project root.\n #[cheatcode(group = Filesystem)]\n function projectRoot() external view returns (string memory path);\n\n /// Get the source file path of the currently running test or script contract,\n /// relative to the project root.\n #[cheatcode(group = Filesystem)]\n function currentFilePath() external view returns (string memory path);\n\n /// Returns the time since unix epoch in milliseconds.\n #[cheatcode(group = Filesystem)]\n function unixTime() external view returns (uint256 milliseconds);\n\n // -------- Reading and writing --------\n\n /// Closes file for reading, resetting the offset and allowing to read it from beginning with readLine.\n /// `path` is relative to the project root.\n #[cheatcode(group = Filesystem)]\n function closeFile(string calldata path) external;\n\n /// Copies the contents of one file to another. This function will **overwrite** the contents of `to`.\n /// On success, the total number of bytes copied is returned and it is equal to the length of the `to` file as reported by `metadata`.\n /// Both `from` and `to` are relative to the project root.\n #[cheatcode(group = Filesystem)]\n function copyFile(string calldata from, string calldata to) external returns (uint64 copied);\n\n /// Creates a new, empty directory at the provided path.\n /// This cheatcode will revert in the following situations, but is not limited to just these cases:\n /// - User lacks permissions to modify `path`.\n /// - A parent of the given path doesn't exist and `recursive` is false.\n /// - `path` already exists and `recursive` is false.\n /// `path` is relative to the project root.\n #[cheatcode(group = Filesystem)]\n function createDir(string calldata path, bool recursive) external;\n\n /// Reads the directory at the given path recursively, up to `maxDepth`.\n /// `maxDepth` defaults to 1, meaning only the direct children of the given directory will be returned.\n /// Follows symbolic links if `followLinks` is true.\n #[cheatcode(group = Filesystem)]\n function readDir(string calldata path) external view returns (DirEntry[] memory entries);\n /// See `readDir(string)`.\n #[cheatcode(group = Filesystem)]\n function readDir(string calldata path, uint64 maxDepth) external view returns (DirEntry[] memory entries);\n /// See `readDir(string)`.\n #[cheatcode(group = Filesystem)]\n function readDir(string calldata path, uint64 maxDepth, bool followLinks)\n external\n view\n returns (DirEntry[] memory entries);\n\n /// Reads the entire content of file to string. `path` is relative to the project root.\n #[cheatcode(group = Filesystem)]\n function readFile(string calldata path) external view returns (string memory data);\n\n /// Reads the entire content of file as binary. `path` is relative to the project root.\n #[cheatcode(group = Filesystem)]\n function readFileBinary(string calldata path) external view returns (bytes memory data);\n\n /// Reads next line of file to string.\n #[cheatcode(group = Filesystem)]\n function readLine(string calldata path) external view returns (string memory line);\n\n /// Reads a symbolic link, returning the path that the link points to.\n /// This cheatcode will revert in the following situations, but is not limited to just these cases:\n /// - `path` is not a symbolic link.\n /// - `path` does not exist.\n #[cheatcode(group = Filesystem)]\n function readLink(string calldata linkPath) external view returns (string memory targetPath);\n\n /// Removes a directory at the provided path.\n /// This cheatcode will revert in the following situations, but is not limited to just these cases:\n /// - `path` doesn't exist.\n /// - `path` isn't a directory.\n /// - User lacks permissions to modify `path`.\n /// - The directory is not empty and `recursive` is false.\n /// `path` is relative to the project root.\n #[cheatcode(group = Filesystem)]\n function removeDir(string calldata path, bool recursive) external;\n\n /// Removes a file from the filesystem.\n /// This cheatcode will revert in the following situations, but is not limited to just these cases:\n /// - `path` points to a directory.\n /// - The file doesn't exist.\n /// - The user lacks permissions to remove the file.\n /// `path` is relative to the project root.\n #[cheatcode(group = Filesystem)]\n function removeFile(string calldata path) external;\n\n /// Writes data to file, creating a file if it does not exist, and entirely replacing its contents if it does.\n /// `path` is relative to the project root.\n #[cheatcode(group = Filesystem)]\n function writeFile(string calldata path, string calldata data) external;\n\n /// Writes binary data to a file, creating a file if it does not exist, and entirely replacing its contents if it does.\n /// `path` is relative to the project root.\n #[cheatcode(group = Filesystem)]\n function writeFileBinary(string calldata path, bytes calldata data) external;\n\n /// Writes line to file, creating a file if it does not exist.\n /// `path` is relative to the project root.\n #[cheatcode(group = Filesystem)]\n function writeLine(string calldata path, string calldata data) external;\n\n /// Gets the artifact path from code (aka. creation code).\n #[cheatcode(group = Filesystem)]\n function getArtifactPathByCode(bytes calldata code) external view returns (string memory path);\n\n /// Gets the artifact path from deployed code (aka. runtime code).\n #[cheatcode(group = Filesystem)]\n function getArtifactPathByDeployedCode(bytes calldata deployedCode) external view returns (string memory path);\n\n /// Gets the creation bytecode from an artifact file. Takes in the relative path to the json file or the path to the\n /// artifact in the form of :: where and parts are optional.\n #[cheatcode(group = Filesystem)]\n function getCode(string calldata artifactPath) external view returns (bytes memory creationBytecode);\n\n /// Deploys a contract from an artifact file. Takes in the relative path to the json file or the path to the\n /// artifact in the form of :: where and parts are optional.\n /// Reverts if the target artifact contains unlinked library placeholders.\n #[cheatcode(group = Filesystem)]\n function deployCode(string calldata artifactPath) external returns (address deployedAddress);\n\n /// Deploys a contract from an artifact file. Takes in the relative path to the json file or the path to the\n /// artifact in the form of :: where and parts are optional.\n /// Reverts if the target artifact contains unlinked library placeholders.\n ///\n /// Additionally accepts abi-encoded constructor arguments.\n #[cheatcode(group = Filesystem)]\n function deployCode(string calldata artifactPath, bytes calldata constructorArgs) external returns (address deployedAddress);\n\n /// Deploys a contract from an artifact file. Takes in the relative path to the json file or the path to the\n /// artifact in the form of :: where and parts are optional.\n /// Reverts if the target artifact contains unlinked library placeholders.\n ///\n /// Additionally accepts `msg.value`.\n #[cheatcode(group = Filesystem)]\n function deployCode(string calldata artifactPath, uint256 value) external returns (address deployedAddress);\n\n /// Deploys a contract from an artifact file. Takes in the relative path to the json file or the path to the\n /// artifact in the form of :: where and parts are optional.\n /// Reverts if the target artifact contains unlinked library placeholders.\n ///\n /// Additionally accepts abi-encoded constructor arguments and `msg.value`.\n #[cheatcode(group = Filesystem)]\n function deployCode(string calldata artifactPath, bytes calldata constructorArgs, uint256 value) external returns (address deployedAddress);\n\n /// Deploys a contract from an artifact file, using the CREATE2 salt. Takes in the relative path to the json file or the path to the\n /// artifact in the form of :: where and parts are optional.\n /// Reverts if the target artifact contains unlinked library placeholders.\n #[cheatcode(group = Filesystem)]\n function deployCode(string calldata artifactPath, bytes32 salt) external returns (address deployedAddress);\n\n /// Deploys a contract from an artifact file, using the CREATE2 salt. Takes in the relative path to the json file or the path to the\n /// artifact in the form of :: where and parts are optional.\n /// Reverts if the target artifact contains unlinked library placeholders.\n ///\n /// Additionally accepts abi-encoded constructor arguments.\n #[cheatcode(group = Filesystem)]\n function deployCode(string calldata artifactPath, bytes calldata constructorArgs, bytes32 salt) external returns (address deployedAddress);\n\n /// Deploys a contract from an artifact file, using the CREATE2 salt. Takes in the relative path to the json file or the path to the\n /// artifact in the form of :: where and parts are optional.\n /// Reverts if the target artifact contains unlinked library placeholders.\n ///\n /// Additionally accepts `msg.value`.\n #[cheatcode(group = Filesystem)]\n function deployCode(string calldata artifactPath, uint256 value, bytes32 salt) external returns (address deployedAddress);\n\n /// Deploys a contract from an artifact file, using the CREATE2 salt. Takes in the relative path to the json file or the path to the\n /// artifact in the form of :: where and parts are optional.\n /// Reverts if the target artifact contains unlinked library placeholders.\n ///\n /// Additionally accepts abi-encoded constructor arguments and `msg.value`.\n #[cheatcode(group = Filesystem)]\n function deployCode(string calldata artifactPath, bytes calldata constructorArgs, uint256 value, bytes32 salt) external returns (address deployedAddress);\n\n /// Gets the deployed bytecode from an artifact file. Takes in the relative path to the json file or the path to the\n /// artifact in the form of :: where and parts are optional.\n #[cheatcode(group = Filesystem)]\n function getDeployedCode(string calldata artifactPath) external view returns (bytes memory runtimeBytecode);\n\n /// Returns the most recent broadcast for the given contract on `chainId` matching `txType`.\n ///\n /// For example:\n ///\n /// The most recent deployment can be fetched by passing `txType` as `CREATE` or `CREATE2`.\n ///\n /// The most recent call can be fetched by passing `txType` as `CALL`.\n #[cheatcode(group = Filesystem)]\n function getBroadcast(string calldata contractName, uint64 chainId, BroadcastTxType txType) external view returns (BroadcastTxSummary memory);\n\n /// Returns all broadcasts for the given contract on `chainId` with the specified `txType`.\n ///\n /// Sorted such that the most recent broadcast is the first element, and the oldest is the last. i.e descending order of BroadcastTxSummary.blockNumber.\n #[cheatcode(group = Filesystem)]\n function getBroadcasts(string calldata contractName, uint64 chainId, BroadcastTxType txType) external view returns (BroadcastTxSummary[] memory);\n\n /// Returns all broadcasts for the given contract on `chainId`.\n ///\n /// Sorted such that the most recent broadcast is the first element, and the oldest is the last. i.e descending order of BroadcastTxSummary.blockNumber.\n #[cheatcode(group = Filesystem)]\n function getBroadcasts(string calldata contractName, uint64 chainId) external view returns (BroadcastTxSummary[] memory);\n\n /// Returns the most recent deployment for the current `chainId`.\n #[cheatcode(group = Filesystem)]\n function getDeployment(string calldata contractName) external view returns (address deployedAddress);\n\n /// Returns the most recent deployment for the given contract on `chainId`\n #[cheatcode(group = Filesystem)]\n function getDeployment(string calldata contractName, uint64 chainId) external view returns (address deployedAddress);\n\n /// Returns all deployments for the given contract on `chainId`\n ///\n /// Sorted in descending order of deployment time i.e descending order of BroadcastTxSummary.blockNumber.\n ///\n /// The most recent deployment is the first element, and the oldest is the last.\n #[cheatcode(group = Filesystem)]\n function getDeployments(string calldata contractName, uint64 chainId) external view returns (address[] memory deployedAddresses);\n\n // -------- Foreign Function Interface --------\n\n /// Performs a foreign function call via the terminal.\n #[cheatcode(group = Filesystem)]\n function ffi(string[] calldata commandInput) external returns (bytes memory result);\n\n /// Performs a foreign function call via terminal and returns the exit code, stdout, and stderr.\n #[cheatcode(group = Filesystem)]\n function tryFfi(string[] calldata commandInput) external returns (FfiResult memory result);\n\n // -------- User Interaction --------\n\n /// Prompts the user for a string value in the terminal.\n #[cheatcode(group = Filesystem)]\n function prompt(string calldata promptText) external returns (string memory input);\n\n /// Prompts the user for a hidden string value in the terminal.\n #[cheatcode(group = Filesystem)]\n function promptSecret(string calldata promptText) external returns (string memory input);\n\n /// Prompts the user for hidden uint256 in the terminal (usually pk).\n #[cheatcode(group = Filesystem)]\n function promptSecretUint(string calldata promptText) external returns (uint256);\n\n /// Prompts the user for an address in the terminal.\n #[cheatcode(group = Filesystem)]\n function promptAddress(string calldata promptText) external returns (address);\n\n /// Prompts the user for uint256 in the terminal.\n #[cheatcode(group = Filesystem)]\n function promptUint(string calldata promptText) external returns (uint256);\n\n // ======== Environment Variables ========\n\n /// Resolves the env variable placeholders of a given input string.\n #[cheatcode(group = Environment)]\n function resolveEnv(string calldata input) external returns (string memory);\n\n /// Sets environment variables.\n #[cheatcode(group = Environment)]\n function setEnv(string calldata name, string calldata value) external;\n\n /// Gets the environment variable `name` and returns true if it exists, else returns false.\n #[cheatcode(group = Environment)]\n function envExists(string calldata name) external view returns (bool result);\n\n /// Gets the environment variable `name` and parses it as `bool`.\n /// Reverts if the variable was not found or could not be parsed.\n #[cheatcode(group = Environment)]\n function envBool(string calldata name) external view returns (bool value);\n /// Gets the environment variable `name` and parses it as `uint256`.\n /// Reverts if the variable was not found or could not be parsed.\n #[cheatcode(group = Environment)]\n function envUint(string calldata name) external view returns (uint256 value);\n /// Gets the environment variable `name` and parses it as `int256`.\n /// Reverts if the variable was not found or could not be parsed.\n #[cheatcode(group = Environment)]\n function envInt(string calldata name) external view returns (int256 value);\n /// Gets the environment variable `name` and parses it as `address`.\n /// Reverts if the variable was not found or could not be parsed.\n #[cheatcode(group = Environment)]\n function envAddress(string calldata name) external view returns (address value);\n /// Gets the environment variable `name` and parses it as `bytes32`.\n /// Reverts if the variable was not found or could not be parsed.\n #[cheatcode(group = Environment)]\n function envBytes32(string calldata name) external view returns (bytes32 value);\n /// Gets the environment variable `name` and parses it as `string`.\n /// Reverts if the variable was not found or could not be parsed.\n #[cheatcode(group = Environment)]\n function envString(string calldata name) external view returns (string memory value);\n /// Gets the environment variable `name` and parses it as `bytes`.\n /// Reverts if the variable was not found or could not be parsed.\n #[cheatcode(group = Environment)]\n function envBytes(string calldata name) external view returns (bytes memory value);\n\n /// Gets the environment variable `name` and parses it as an array of `bool`, delimited by `delim`.\n /// Reverts if the variable was not found or could not be parsed.\n #[cheatcode(group = Environment)]\n function envBool(string calldata name, string calldata delim) external view returns (bool[] memory value);\n /// Gets the environment variable `name` and parses it as an array of `uint256`, delimited by `delim`.\n /// Reverts if the variable was not found or could not be parsed.\n #[cheatcode(group = Environment)]\n function envUint(string calldata name, string calldata delim) external view returns (uint256[] memory value);\n /// Gets the environment variable `name` and parses it as an array of `int256`, delimited by `delim`.\n /// Reverts if the variable was not found or could not be parsed.\n #[cheatcode(group = Environment)]\n function envInt(string calldata name, string calldata delim) external view returns (int256[] memory value);\n /// Gets the environment variable `name` and parses it as an array of `address`, delimited by `delim`.\n /// Reverts if the variable was not found or could not be parsed.\n #[cheatcode(group = Environment)]\n function envAddress(string calldata name, string calldata delim) external view returns (address[] memory value);\n /// Gets the environment variable `name` and parses it as an array of `bytes32`, delimited by `delim`.\n /// Reverts if the variable was not found or could not be parsed.\n #[cheatcode(group = Environment)]\n function envBytes32(string calldata name, string calldata delim) external view returns (bytes32[] memory value);\n /// Gets the environment variable `name` and parses it as an array of `string`, delimited by `delim`.\n /// Reverts if the variable was not found or could not be parsed.\n #[cheatcode(group = Environment)]\n function envString(string calldata name, string calldata delim) external view returns (string[] memory value);\n /// Gets the environment variable `name` and parses it as an array of `bytes`, delimited by `delim`.\n /// Reverts if the variable was not found or could not be parsed.\n #[cheatcode(group = Environment)]\n function envBytes(string calldata name, string calldata delim) external view returns (bytes[] memory value);\n\n /// Gets the environment variable `name` and parses it as `bool`.\n /// Reverts if the variable could not be parsed.\n /// Returns `defaultValue` if the variable was not found.\n #[cheatcode(group = Environment)]\n function envOr(string calldata name, bool defaultValue) external view returns (bool value);\n /// Gets the environment variable `name` and parses it as `uint256`.\n /// Reverts if the variable could not be parsed.\n /// Returns `defaultValue` if the variable was not found.\n #[cheatcode(group = Environment)]\n function envOr(string calldata name, uint256 defaultValue) external view returns (uint256 value);\n /// Gets the environment variable `name` and parses it as `int256`.\n /// Reverts if the variable could not be parsed.\n /// Returns `defaultValue` if the variable was not found.\n #[cheatcode(group = Environment)]\n function envOr(string calldata name, int256 defaultValue) external view returns (int256 value);\n /// Gets the environment variable `name` and parses it as `address`.\n /// Reverts if the variable could not be parsed.\n /// Returns `defaultValue` if the variable was not found.\n #[cheatcode(group = Environment)]\n function envOr(string calldata name, address defaultValue) external view returns (address value);\n /// Gets the environment variable `name` and parses it as `bytes32`.\n /// Reverts if the variable could not be parsed.\n /// Returns `defaultValue` if the variable was not found.\n #[cheatcode(group = Environment)]\n function envOr(string calldata name, bytes32 defaultValue) external view returns (bytes32 value);\n /// Gets the environment variable `name` and parses it as `string`.\n /// Reverts if the variable could not be parsed.\n /// Returns `defaultValue` if the variable was not found.\n #[cheatcode(group = Environment)]\n function envOr(string calldata name, string calldata defaultValue) external view returns (string memory value);\n /// Gets the environment variable `name` and parses it as `bytes`.\n /// Reverts if the variable could not be parsed.\n /// Returns `defaultValue` if the variable was not found.\n #[cheatcode(group = Environment)]\n function envOr(string calldata name, bytes calldata defaultValue) external view returns (bytes memory value);\n\n /// Gets the environment variable `name` and parses it as an array of `bool`, delimited by `delim`.\n /// Reverts if the variable could not be parsed.\n /// Returns `defaultValue` if the variable was not found.\n #[cheatcode(group = Environment)]\n function envOr(string calldata name, string calldata delim, bool[] calldata defaultValue)\n external view\n returns (bool[] memory value);\n /// Gets the environment variable `name` and parses it as an array of `uint256`, delimited by `delim`.\n /// Reverts if the variable could not be parsed.\n /// Returns `defaultValue` if the variable was not found.\n #[cheatcode(group = Environment)]\n function envOr(string calldata name, string calldata delim, uint256[] calldata defaultValue)\n external view\n returns (uint256[] memory value);\n /// Gets the environment variable `name` and parses it as an array of `int256`, delimited by `delim`.\n /// Reverts if the variable could not be parsed.\n /// Returns `defaultValue` if the variable was not found.\n #[cheatcode(group = Environment)]\n function envOr(string calldata name, string calldata delim, int256[] calldata defaultValue)\n external view\n returns (int256[] memory value);\n /// Gets the environment variable `name` and parses it as an array of `address`, delimited by `delim`.\n /// Reverts if the variable could not be parsed.\n /// Returns `defaultValue` if the variable was not found.\n #[cheatcode(group = Environment)]\n function envOr(string calldata name, string calldata delim, address[] calldata defaultValue)\n external view\n returns (address[] memory value);\n /// Gets the environment variable `name` and parses it as an array of `bytes32`, delimited by `delim`.\n /// Reverts if the variable could not be parsed.\n /// Returns `defaultValue` if the variable was not found.\n #[cheatcode(group = Environment)]\n function envOr(string calldata name, string calldata delim, bytes32[] calldata defaultValue)\n external view\n returns (bytes32[] memory value);\n /// Gets the environment variable `name` and parses it as an array of `string`, delimited by `delim`.\n /// Reverts if the variable could not be parsed.\n /// Returns `defaultValue` if the variable was not found.\n #[cheatcode(group = Environment)]\n function envOr(string calldata name, string calldata delim, string[] calldata defaultValue)\n external view\n returns (string[] memory value);\n /// Gets the environment variable `name` and parses it as an array of `bytes`, delimited by `delim`.\n /// Reverts if the variable could not be parsed.\n /// Returns `defaultValue` if the variable was not found.\n #[cheatcode(group = Environment)]\n function envOr(string calldata name, string calldata delim, bytes[] calldata defaultValue)\n external view\n returns (bytes[] memory value);\n\n /// Returns true if `forge` command was executed in given context.\n #[cheatcode(group = Environment)]\n function isContext(ForgeContext context) external view returns (bool result);\n\n // ======== Scripts ========\n // -------- Broadcasting Transactions --------\n\n /// Has the next call (at this call depth only) create transactions that can later be signed and sent onchain.\n ///\n /// Broadcasting address is determined by checking the following in order:\n /// 1. If `--sender` argument was provided, that address is used.\n /// 2. If exactly one signer (e.g. private key, hw wallet, keystore) is set when `forge broadcast` is invoked, that signer is used.\n /// 3. Otherwise, default foundry sender (1804c8AB1F12E6bbf3894d4083f33e07309d1f38) is used.\n #[cheatcode(group = Scripting)]\n function broadcast() external;\n\n /// Has the next call (at this call depth only) create a transaction with the address provided\n /// as the sender that can later be signed and sent onchain.\n #[cheatcode(group = Scripting)]\n function broadcast(address signer) external;\n\n /// Has the next call (at this call depth only) create a transaction with the private key\n /// provided as the sender that can later be signed and sent onchain.\n #[cheatcode(group = Scripting)]\n function broadcast(uint256 privateKey) external;\n\n /// Has all subsequent calls (at this call depth only) create transactions that can later be signed and sent onchain.\n ///\n /// Broadcasting address is determined by checking the following in order:\n /// 1. If `--sender` argument was provided, that address is used.\n /// 2. If exactly one signer (e.g. private key, hw wallet, keystore) is set when `forge broadcast` is invoked, that signer is used.\n /// 3. Otherwise, default foundry sender (1804c8AB1F12E6bbf3894d4083f33e07309d1f38) is used.\n #[cheatcode(group = Scripting)]\n function startBroadcast() external;\n\n /// Has all subsequent calls (at this call depth only) create transactions with the address\n /// provided that can later be signed and sent onchain.\n #[cheatcode(group = Scripting)]\n function startBroadcast(address signer) external;\n\n /// Has all subsequent calls (at this call depth only) create transactions with the private key\n /// provided that can later be signed and sent onchain.\n #[cheatcode(group = Scripting)]\n function startBroadcast(uint256 privateKey) external;\n\n /// Stops collecting onchain transactions.\n #[cheatcode(group = Scripting)]\n function stopBroadcast() external;\n\n /// Takes a signed transaction and broadcasts it to the network.\n #[cheatcode(group = Scripting)]\n function broadcastRawTransaction(bytes calldata data) external;\n\n /// Sign an EIP-7702 authorization for delegation\n #[cheatcode(group = Scripting)]\n function signDelegation(address implementation, uint256 privateKey) external returns (SignedDelegation memory signedDelegation);\n\n /// Sign an EIP-7702 authorization for delegation for specific nonce\n #[cheatcode(group = Scripting)]\n function signDelegation(address implementation, uint256 privateKey, uint64 nonce) external returns (SignedDelegation memory signedDelegation);\n\n /// Sign an EIP-7702 authorization for delegation, with optional cross-chain validity.\n #[cheatcode(group = Scripting)]\n function signDelegation(address implementation, uint256 privateKey, bool crossChain) external returns (SignedDelegation memory signedDelegation);\n\n /// Designate the next call as an EIP-7702 transaction\n #[cheatcode(group = Scripting)]\n function attachDelegation(SignedDelegation calldata signedDelegation) external;\n\n /// Designate the next call as an EIP-7702 transaction, with optional cross-chain validity.\n #[cheatcode(group = Scripting)]\n function attachDelegation(SignedDelegation calldata signedDelegation, bool crossChain) external;\n\n /// Sign an EIP-7702 authorization and designate the next call as an EIP-7702 transaction\n #[cheatcode(group = Scripting)]\n function signAndAttachDelegation(address implementation, uint256 privateKey) external returns (SignedDelegation memory signedDelegation);\n\n /// Sign an EIP-7702 authorization and designate the next call as an EIP-7702 transaction for specific nonce\n #[cheatcode(group = Scripting)]\n function signAndAttachDelegation(address implementation, uint256 privateKey, uint64 nonce) external returns (SignedDelegation memory signedDelegation);\n\n /// Sign an EIP-7702 authorization and designate the next call as an EIP-7702 transaction, with optional cross-chain validity.\n #[cheatcode(group = Scripting)]\n function signAndAttachDelegation(address implementation, uint256 privateKey, bool crossChain) external returns (SignedDelegation memory signedDelegation);\n\n /// Attach an EIP-4844 blob to the next call\n #[cheatcode(group = Scripting)]\n function attachBlob(bytes calldata blob) external;\n\n /// Returns addresses of available unlocked wallets in the script environment.\n #[cheatcode(group = Scripting)]\n function getWallets() external view returns (address[] memory wallets);\n\n // ======== Utilities ========\n\n // -------- Strings --------\n\n /// Converts the given value to a `string`.\n #[cheatcode(group = String)]\n function toString(address value) external pure returns (string memory stringifiedValue);\n /// Converts the given value to a `string`.\n #[cheatcode(group = String)]\n function toString(bytes calldata value) external pure returns (string memory stringifiedValue);\n /// Converts the given value to a `string`.\n #[cheatcode(group = String)]\n function toString(bytes32 value) external pure returns (string memory stringifiedValue);\n /// Converts the given value to a `string`.\n #[cheatcode(group = String)]\n function toString(bool value) external pure returns (string memory stringifiedValue);\n /// Converts the given value to a `string`.\n #[cheatcode(group = String)]\n function toString(uint256 value) external pure returns (string memory stringifiedValue);\n /// Converts the given value to a `string`.\n #[cheatcode(group = String)]\n function toString(int256 value) external pure returns (string memory stringifiedValue);\n\n /// Parses the given `string` into `bytes`.\n #[cheatcode(group = String)]\n function parseBytes(string calldata stringifiedValue) external pure returns (bytes memory parsedValue);\n /// Parses the given `string` into an `address`.\n #[cheatcode(group = String)]\n function parseAddress(string calldata stringifiedValue) external pure returns (address parsedValue);\n /// Parses the given `string` into a `uint256`.\n #[cheatcode(group = String)]\n function parseUint(string calldata stringifiedValue) external pure returns (uint256 parsedValue);\n /// Parses the given `string` into a `int256`.\n #[cheatcode(group = String)]\n function parseInt(string calldata stringifiedValue) external pure returns (int256 parsedValue);\n /// Parses the given `string` into a `bytes32`.\n #[cheatcode(group = String)]\n function parseBytes32(string calldata stringifiedValue) external pure returns (bytes32 parsedValue);\n /// Parses the given `string` into a `bool`.\n #[cheatcode(group = String)]\n function parseBool(string calldata stringifiedValue) external pure returns (bool parsedValue);\n\n /// Converts the given `string` value to Lowercase.\n #[cheatcode(group = String)]\n function toLowercase(string calldata input) external pure returns (string memory output);\n /// Converts the given `string` value to Uppercase.\n #[cheatcode(group = String)]\n function toUppercase(string calldata input) external pure returns (string memory output);\n /// Trims leading and trailing whitespace from the given `string` value.\n #[cheatcode(group = String)]\n function trim(string calldata input) external pure returns (string memory output);\n /// Replaces occurrences of `from` in the given `string` with `to`.\n #[cheatcode(group = String)]\n function replace(string calldata input, string calldata from, string calldata to) external pure returns (string memory output);\n /// Splits the given `string` into an array of strings divided by the `delimiter`.\n #[cheatcode(group = String)]\n function split(string calldata input, string calldata delimiter) external pure returns (string[] memory outputs);\n /// Returns the index of the first occurrence of a `key` in an `input` string.\n /// Returns `NOT_FOUND` (i.e. `type(uint256).max`) if the `key` is not found.\n /// Returns 0 in case of an empty `key`.\n #[cheatcode(group = String)]\n function indexOf(string calldata input, string calldata key) external pure returns (uint256);\n /// Returns true if `search` is found in `subject`, false otherwise.\n #[cheatcode(group = String)]\n function contains(string calldata subject, string calldata search) external pure returns (bool result);\n\n // ======== JSON Parsing and Manipulation ========\n\n // -------- Reading --------\n\n // NOTE: Please read https://book.getfoundry.sh/cheatcodes/parse-json to understand the\n // limitations and caveats of the JSON parsing cheats.\n\n /// Checks if `key` exists in a JSON object\n /// `keyExists` is being deprecated in favor of `keyExistsJson`. It will be removed in future versions.\n #[cheatcode(group = Json, status = Deprecated(Some(\"replaced by `keyExistsJson`\")))]\n function keyExists(string calldata json, string calldata key) external view returns (bool);\n /// Checks if `key` exists in a JSON object.\n #[cheatcode(group = Json)]\n function keyExistsJson(string calldata json, string calldata key) external view returns (bool);\n\n /// ABI-encodes a JSON object.\n #[cheatcode(group = Json)]\n function parseJson(string calldata json) external pure returns (bytes memory abiEncodedData);\n /// ABI-encodes a JSON object at `key`.\n #[cheatcode(group = Json)]\n function parseJson(string calldata json, string calldata key) external pure returns (bytes memory abiEncodedData);\n\n // The following parseJson cheatcodes will do type coercion, for the type that they indicate.\n // For example, parseJsonUint will coerce all values to a uint256. That includes stringified numbers '12.'\n // and hex numbers '0xEF.'.\n // Type coercion works ONLY for discrete values or arrays. That means that the key must return a value or array, not\n // a JSON object.\n\n /// Parses a string of JSON data at `key` and coerces it to `uint256`.\n #[cheatcode(group = Json)]\n function parseJsonUint(string calldata json, string calldata key) external pure returns (uint256);\n /// Parses a string of JSON data at `key` and coerces it to `uint256[]`.\n #[cheatcode(group = Json)]\n function parseJsonUintArray(string calldata json, string calldata key) external pure returns (uint256[] memory);\n /// Parses a string of JSON data at `key` and coerces it to `int256`.\n #[cheatcode(group = Json)]\n function parseJsonInt(string calldata json, string calldata key) external pure returns (int256);\n /// Parses a string of JSON data at `key` and coerces it to `int256[]`.\n #[cheatcode(group = Json)]\n function parseJsonIntArray(string calldata json, string calldata key) external pure returns (int256[] memory);\n /// Parses a string of JSON data at `key` and coerces it to `bool`.\n #[cheatcode(group = Json)]\n function parseJsonBool(string calldata json, string calldata key) external pure returns (bool);\n /// Parses a string of JSON data at `key` and coerces it to `bool[]`.\n #[cheatcode(group = Json)]\n function parseJsonBoolArray(string calldata json, string calldata key) external pure returns (bool[] memory);\n /// Parses a string of JSON data at `key` and coerces it to `address`.\n #[cheatcode(group = Json)]\n function parseJsonAddress(string calldata json, string calldata key) external pure returns (address);\n /// Parses a string of JSON data at `key` and coerces it to `address[]`.\n #[cheatcode(group = Json)]\n function parseJsonAddressArray(string calldata json, string calldata key)\n external\n pure\n returns (address[] memory);\n /// Parses a string of JSON data at `key` and coerces it to `string`.\n #[cheatcode(group = Json)]\n function parseJsonString(string calldata json, string calldata key) external pure returns (string memory);\n /// Parses a string of JSON data at `key` and coerces it to `string[]`.\n #[cheatcode(group = Json)]\n function parseJsonStringArray(string calldata json, string calldata key) external pure returns (string[] memory);\n /// Parses a string of JSON data at `key` and coerces it to `bytes`.\n #[cheatcode(group = Json)]\n function parseJsonBytes(string calldata json, string calldata key) external pure returns (bytes memory);\n /// Parses a string of JSON data at `key` and coerces it to `bytes[]`.\n #[cheatcode(group = Json)]\n function parseJsonBytesArray(string calldata json, string calldata key) external pure returns (bytes[] memory);\n /// Parses a string of JSON data at `key` and coerces it to `bytes32`.\n #[cheatcode(group = Json)]\n function parseJsonBytes32(string calldata json, string calldata key) external pure returns (bytes32);\n /// Parses a string of JSON data at `key` and coerces it to `bytes32[]`.\n #[cheatcode(group = Json)]\n function parseJsonBytes32Array(string calldata json, string calldata key)\n external\n pure\n returns (bytes32[] memory);\n\n /// Parses a string of JSON data and coerces it to type corresponding to `typeDescription`.\n #[cheatcode(group = Json)]\n function parseJsonType(string calldata json, string calldata typeDescription) external pure returns (bytes memory);\n /// Parses a string of JSON data at `key` and coerces it to type corresponding to `typeDescription`.\n #[cheatcode(group = Json)]\n function parseJsonType(string calldata json, string calldata key, string calldata typeDescription) external pure returns (bytes memory);\n /// Parses a string of JSON data at `key` and coerces it to type array corresponding to `typeDescription`.\n #[cheatcode(group = Json)]\n function parseJsonTypeArray(string calldata json, string calldata key, string calldata typeDescription)\n external\n pure\n returns (bytes memory);\n\n /// Returns an array of all the keys in a JSON object.\n #[cheatcode(group = Json)]\n function parseJsonKeys(string calldata json, string calldata key) external pure returns (string[] memory keys);\n\n // -------- Writing --------\n\n // NOTE: Please read https://book.getfoundry.sh/cheatcodes/serialize-json to understand how\n // to use the serialization cheats.\n\n /// Serializes a key and value to a JSON object stored in-memory that can be later written to a file.\n /// Returns the stringified version of the specific JSON file up to that moment.\n #[cheatcode(group = Json)]\n function serializeJson(string calldata objectKey, string calldata value) external returns (string memory json);\n\n /// See `serializeJson`.\n #[cheatcode(group = Json)]\n function serializeBool(string calldata objectKey, string calldata valueKey, bool value)\n external\n returns (string memory json);\n /// See `serializeJson`.\n #[cheatcode(group = Json)]\n function serializeUint(string calldata objectKey, string calldata valueKey, uint256 value)\n external\n returns (string memory json);\n /// See `serializeJson`.\n #[cheatcode(group = Json)]\n function serializeUintToHex(string calldata objectKey, string calldata valueKey, uint256 value)\n external\n returns (string memory json);\n /// See `serializeJson`.\n #[cheatcode(group = Json)]\n function serializeInt(string calldata objectKey, string calldata valueKey, int256 value)\n external\n returns (string memory json);\n /// See `serializeJson`.\n #[cheatcode(group = Json)]\n function serializeAddress(string calldata objectKey, string calldata valueKey, address value)\n external\n returns (string memory json);\n /// See `serializeJson`.\n #[cheatcode(group = Json)]\n function serializeBytes32(string calldata objectKey, string calldata valueKey, bytes32 value)\n external\n returns (string memory json);\n /// See `serializeJson`.\n #[cheatcode(group = Json)]\n function serializeString(string calldata objectKey, string calldata valueKey, string calldata value)\n external\n returns (string memory json);\n /// See `serializeJson`.\n #[cheatcode(group = Json)]\n function serializeBytes(string calldata objectKey, string calldata valueKey, bytes calldata value)\n external\n returns (string memory json);\n\n /// See `serializeJson`.\n #[cheatcode(group = Json)]\n function serializeBool(string calldata objectKey, string calldata valueKey, bool[] calldata values)\n external\n returns (string memory json);\n /// See `serializeJson`.\n #[cheatcode(group = Json)]\n function serializeUint(string calldata objectKey, string calldata valueKey, uint256[] calldata values)\n external\n returns (string memory json);\n /// See `serializeJson`.\n #[cheatcode(group = Json)]\n function serializeInt(string calldata objectKey, string calldata valueKey, int256[] calldata values)\n external\n returns (string memory json);\n /// See `serializeJson`.\n #[cheatcode(group = Json)]\n function serializeAddress(string calldata objectKey, string calldata valueKey, address[] calldata values)\n external\n returns (string memory json);\n /// See `serializeJson`.\n #[cheatcode(group = Json)]\n function serializeBytes32(string calldata objectKey, string calldata valueKey, bytes32[] calldata values)\n external\n returns (string memory json);\n /// See `serializeJson`.\n #[cheatcode(group = Json)]\n function serializeString(string calldata objectKey, string calldata valueKey, string[] calldata values)\n external\n returns (string memory json);\n /// See `serializeJson`.\n #[cheatcode(group = Json)]\n function serializeBytes(string calldata objectKey, string calldata valueKey, bytes[] calldata values)\n external\n returns (string memory json);\n /// See `serializeJson`.\n #[cheatcode(group = Json)]\n function serializeJsonType(string calldata typeDescription, bytes calldata value)\n external\n pure\n returns (string memory json);\n /// See `serializeJson`.\n #[cheatcode(group = Json)]\n function serializeJsonType(string calldata objectKey, string calldata valueKey, string calldata typeDescription, bytes calldata value)\n external\n returns (string memory json);\n\n // NOTE: Please read https://book.getfoundry.sh/cheatcodes/write-json to understand how\n // to use the JSON writing cheats.\n\n /// Write a serialized JSON object to a file. If the file exists, it will be overwritten.\n #[cheatcode(group = Json)]\n function writeJson(string calldata json, string calldata path) external;\n\n /// Write a serialized JSON object to an **existing** JSON file, replacing a value with key = \n /// This is useful to replace a specific value of a JSON file, without having to parse the entire thing.\n /// This cheatcode will create new keys if they didn't previously exist.\n #[cheatcode(group = Json)]\n function writeJson(string calldata json, string calldata path, string calldata valueKey) external;\n\n // ======== TOML Parsing and Manipulation ========\n\n // -------- Reading --------\n\n // NOTE: Please read https://book.getfoundry.sh/cheatcodes/parse-toml to understand the\n // limitations and caveats of the TOML parsing cheat.\n\n /// Checks if `key` exists in a TOML table.\n #[cheatcode(group = Toml)]\n function keyExistsToml(string calldata toml, string calldata key) external view returns (bool);\n\n /// ABI-encodes a TOML table.\n #[cheatcode(group = Toml)]\n function parseToml(string calldata toml) external pure returns (bytes memory abiEncodedData);\n\n /// ABI-encodes a TOML table at `key`.\n #[cheatcode(group = Toml)]\n function parseToml(string calldata toml, string calldata key) external pure returns (bytes memory abiEncodedData);\n\n // The following parseToml cheatcodes will do type coercion, for the type that they indicate.\n // For example, parseTomlUint will coerce all values to a uint256. That includes stringified numbers '12.'\n // and hex numbers '0xEF.'.\n // Type coercion works ONLY for discrete values or arrays. That means that the key must return a value or array, not\n // a TOML table.\n\n /// Parses a string of TOML data at `key` and coerces it to `uint256`.\n #[cheatcode(group = Toml)]\n function parseTomlUint(string calldata toml, string calldata key) external pure returns (uint256);\n /// Parses a string of TOML data at `key` and coerces it to `uint256[]`.\n #[cheatcode(group = Toml)]\n function parseTomlUintArray(string calldata toml, string calldata key) external pure returns (uint256[] memory);\n /// Parses a string of TOML data at `key` and coerces it to `int256`.\n #[cheatcode(group = Toml)]\n function parseTomlInt(string calldata toml, string calldata key) external pure returns (int256);\n /// Parses a string of TOML data at `key` and coerces it to `int256[]`.\n #[cheatcode(group = Toml)]\n function parseTomlIntArray(string calldata toml, string calldata key) external pure returns (int256[] memory);\n /// Parses a string of TOML data at `key` and coerces it to `bool`.\n #[cheatcode(group = Toml)]\n function parseTomlBool(string calldata toml, string calldata key) external pure returns (bool);\n /// Parses a string of TOML data at `key` and coerces it to `bool[]`.\n #[cheatcode(group = Toml)]\n function parseTomlBoolArray(string calldata toml, string calldata key) external pure returns (bool[] memory);\n /// Parses a string of TOML data at `key` and coerces it to `address`.\n #[cheatcode(group = Toml)]\n function parseTomlAddress(string calldata toml, string calldata key) external pure returns (address);\n /// Parses a string of TOML data at `key` and coerces it to `address[]`.\n #[cheatcode(group = Toml)]\n function parseTomlAddressArray(string calldata toml, string calldata key)\n external\n pure\n returns (address[] memory);\n /// Parses a string of TOML data at `key` and coerces it to `string`.\n #[cheatcode(group = Toml)]\n function parseTomlString(string calldata toml, string calldata key) external pure returns (string memory);\n /// Parses a string of TOML data at `key` and coerces it to `string[]`.\n #[cheatcode(group = Toml)]\n function parseTomlStringArray(string calldata toml, string calldata key) external pure returns (string[] memory);\n /// Parses a string of TOML data at `key` and coerces it to `bytes`.\n #[cheatcode(group = Toml)]\n function parseTomlBytes(string calldata toml, string calldata key) external pure returns (bytes memory);\n /// Parses a string of TOML data at `key` and coerces it to `bytes[]`.\n #[cheatcode(group = Toml)]\n function parseTomlBytesArray(string calldata toml, string calldata key) external pure returns (bytes[] memory);\n /// Parses a string of TOML data at `key` and coerces it to `bytes32`.\n #[cheatcode(group = Toml)]\n function parseTomlBytes32(string calldata toml, string calldata key) external pure returns (bytes32);\n /// Parses a string of TOML data at `key` and coerces it to `bytes32[]`.\n #[cheatcode(group = Toml)]\n function parseTomlBytes32Array(string calldata toml, string calldata key)\n external\n pure\n returns (bytes32[] memory);\n\n /// Parses a string of TOML data and coerces it to type corresponding to `typeDescription`.\n #[cheatcode(group = Toml)]\n function parseTomlType(string calldata toml, string calldata typeDescription) external pure returns (bytes memory);\n /// Parses a string of TOML data at `key` and coerces it to type corresponding to `typeDescription`.\n #[cheatcode(group = Toml)]\n function parseTomlType(string calldata toml, string calldata key, string calldata typeDescription) external pure returns (bytes memory);\n /// Parses a string of TOML data at `key` and coerces it to type array corresponding to `typeDescription`.\n #[cheatcode(group = Toml)]\n function parseTomlTypeArray(string calldata toml, string calldata key, string calldata typeDescription)\n external\n pure\n returns (bytes memory);\n\n /// Returns an array of all the keys in a TOML table.\n #[cheatcode(group = Toml)]\n function parseTomlKeys(string calldata toml, string calldata key) external pure returns (string[] memory keys);\n\n // -------- Writing --------\n\n // NOTE: Please read https://book.getfoundry.sh/cheatcodes/write-toml to understand how\n // to use the TOML writing cheat.\n\n /// Takes serialized JSON, converts to TOML and write a serialized TOML to a file.\n #[cheatcode(group = Toml)]\n function writeToml(string calldata json, string calldata path) external;\n\n /// Takes serialized JSON, converts to TOML and write a serialized TOML table to an **existing** TOML file, replacing a value with key = \n /// This is useful to replace a specific value of a TOML file, without having to parse the entire thing.\n /// This cheatcode will create new keys if they didn't previously exist.\n #[cheatcode(group = Toml)]\n function writeToml(string calldata json, string calldata path, string calldata valueKey) external;\n\n // ======== Cryptography ========\n\n // -------- Key Management --------\n\n /// Derives a private key from the name, labels the account with that name, and returns the wallet.\n #[cheatcode(group = Crypto)]\n function createWallet(string calldata walletLabel) external returns (Wallet memory wallet);\n\n /// Generates a wallet from the private key and returns the wallet.\n #[cheatcode(group = Crypto)]\n function createWallet(uint256 privateKey) external returns (Wallet memory wallet);\n\n /// Generates a wallet from the private key, labels the account with that name, and returns the wallet.\n #[cheatcode(group = Crypto)]\n function createWallet(uint256 privateKey, string calldata walletLabel) external returns (Wallet memory wallet);\n\n /// Signs data with a `Wallet`.\n #[cheatcode(group = Crypto)]\n function sign(Wallet calldata wallet, bytes32 digest) external pure returns (uint8 v, bytes32 r, bytes32 s);\n\n /// Signs data with a `Wallet`.\n ///\n /// Returns a compact signature (`r`, `vs`) as per EIP-2098, where `vs` encodes both the\n /// signature's `s` value, and the recovery id `v` in a single bytes32.\n /// This format reduces the signature size from 65 to 64 bytes.\n #[cheatcode(group = Crypto)]\n function signCompact(Wallet calldata wallet, bytes32 digest) external pure returns (bytes32 r, bytes32 vs);\n\n /// Signs `digest` with `privateKey` using the secp256k1 curve.\n #[cheatcode(group = Crypto)]\n function sign(uint256 privateKey, bytes32 digest) external pure returns (uint8 v, bytes32 r, bytes32 s);\n\n /// Signs `digest` with `privateKey` on the secp256k1 curve, using the given `nonce`\n /// as the raw ephemeral k value in ECDSA (instead of deriving it deterministically).\n #[cheatcode(group = Crypto)]\n function signWithNonceUnsafe(uint256 privateKey, bytes32 digest, uint256 nonce) external pure returns (uint8 v, bytes32 r, bytes32 s);\n\n /// Signs `digest` with `privateKey` using the secp256k1 curve.\n ///\n /// Returns a compact signature (`r`, `vs`) as per EIP-2098, where `vs` encodes both the\n /// signature's `s` value, and the recovery id `v` in a single bytes32.\n /// This format reduces the signature size from 65 to 64 bytes.\n #[cheatcode(group = Crypto)]\n function signCompact(uint256 privateKey, bytes32 digest) external pure returns (bytes32 r, bytes32 vs);\n\n /// Signs `digest` with signer provided to script using the secp256k1 curve.\n ///\n /// If `--sender` is provided, the signer with provided address is used, otherwise,\n /// if exactly one signer is provided to the script, that signer is used.\n ///\n /// Raises error if signer passed through `--sender` does not match any unlocked signers or\n /// if `--sender` is not provided and not exactly one signer is passed to the script.\n #[cheatcode(group = Crypto)]\n function sign(bytes32 digest) external pure returns (uint8 v, bytes32 r, bytes32 s);\n\n /// Signs `digest` with signer provided to script using the secp256k1 curve.\n ///\n /// Returns a compact signature (`r`, `vs`) as per EIP-2098, where `vs` encodes both the\n /// signature's `s` value, and the recovery id `v` in a single bytes32.\n /// This format reduces the signature size from 65 to 64 bytes.\n ///\n /// If `--sender` is provided, the signer with provided address is used, otherwise,\n /// if exactly one signer is provided to the script, that signer is used.\n ///\n /// Raises error if signer passed through `--sender` does not match any unlocked signers or\n /// if `--sender` is not provided and not exactly one signer is passed to the script.\n #[cheatcode(group = Crypto)]\n function signCompact(bytes32 digest) external pure returns (bytes32 r, bytes32 vs);\n\n /// Signs `digest` with signer provided to script using the secp256k1 curve.\n ///\n /// Raises error if none of the signers passed into the script have provided address.\n #[cheatcode(group = Crypto)]\n function sign(address signer, bytes32 digest) external pure returns (uint8 v, bytes32 r, bytes32 s);\n\n /// Signs `digest` with signer provided to script using the secp256k1 curve.\n ///\n /// Returns a compact signature (`r`, `vs`) as per EIP-2098, where `vs` encodes both the\n /// signature's `s` value, and the recovery id `v` in a single bytes32.\n /// This format reduces the signature size from 65 to 64 bytes.\n ///\n /// Raises error if none of the signers passed into the script have provided address.\n #[cheatcode(group = Crypto)]\n function signCompact(address signer, bytes32 digest) external pure returns (bytes32 r, bytes32 vs);\n\n /// Signs `digest` with `privateKey` using the secp256r1 curve.\n #[cheatcode(group = Crypto)]\n function signP256(uint256 privateKey, bytes32 digest) external pure returns (bytes32 r, bytes32 s);\n\n /// Derives secp256r1 public key from the provided `privateKey`.\n #[cheatcode(group = Crypto)]\n function publicKeyP256(uint256 privateKey) external pure returns (uint256 publicKeyX, uint256 publicKeyY);\n\n /// Generates an Ed25519 key pair from a deterministic salt.\n /// Returns (publicKey, privateKey) as 32-byte values.\n #[cheatcode(group = Crypto, safety = Safe)]\n function createEd25519Key(bytes32 salt) external pure returns (bytes32 publicKey, bytes32 privateKey);\n\n /// Derives the Ed25519 public key from a private key.\n #[cheatcode(group = Crypto, safety = Safe)]\n function publicKeyEd25519(bytes32 privateKey) external pure returns (bytes32 publicKey);\n\n /// Signs a message with namespace using Ed25519.\n /// The signature covers namespace || message for domain separation.\n /// Returns a 64-byte Ed25519 signature.\n #[cheatcode(group = Crypto, safety = Safe)]\n function signEd25519(bytes calldata namespace, bytes calldata message, bytes32 privateKey)\n external\n pure\n returns (bytes memory signature);\n\n /// Verifies an Ed25519 signature over namespace || message.\n /// Returns true if signature is valid, false otherwise.\n #[cheatcode(group = Crypto, safety = Safe)]\n function verifyEd25519(\n bytes calldata signature,\n bytes calldata namespace,\n bytes calldata message,\n bytes32 publicKey\n ) external pure returns (bool valid);\n\n /// Derive a private key from a provided mnemonic string (or mnemonic file path)\n /// at the derivation path `m/44'/60'/0'/0/{index}`.\n #[cheatcode(group = Crypto)]\n function deriveKey(string calldata mnemonic, uint32 index) external pure returns (uint256 privateKey);\n /// Derive a private key from a provided mnemonic string (or mnemonic file path)\n /// at `{derivationPath}{index}`.\n #[cheatcode(group = Crypto)]\n function deriveKey(string calldata mnemonic, string calldata derivationPath, uint32 index)\n external\n pure\n returns (uint256 privateKey);\n /// Derive a private key from a provided mnemonic string (or mnemonic file path) in the specified language\n /// at the derivation path `m/44'/60'/0'/0/{index}`.\n #[cheatcode(group = Crypto)]\n function deriveKey(string calldata mnemonic, uint32 index, string calldata language)\n external\n pure\n returns (uint256 privateKey);\n /// Derive a private key from a provided mnemonic string (or mnemonic file path) in the specified language\n /// at `{derivationPath}{index}`.\n #[cheatcode(group = Crypto)]\n function deriveKey(string calldata mnemonic, string calldata derivationPath, uint32 index, string calldata language)\n external\n pure\n returns (uint256 privateKey);\n\n /// Adds a private key to the local forge wallet and returns the address.\n #[cheatcode(group = Crypto)]\n function rememberKey(uint256 privateKey) external returns (address keyAddr);\n\n /// Derive a set number of wallets from a mnemonic at the derivation path `m/44'/60'/0'/0/{0..count}`.\n ///\n /// The respective private keys are saved to the local forge wallet for later use and their addresses are returned.\n #[cheatcode(group = Crypto)]\n function rememberKeys(string calldata mnemonic, string calldata derivationPath, uint32 count) external returns (address[] memory keyAddrs);\n\n /// Derive a set number of wallets from a mnemonic in the specified language at the derivation path `m/44'/60'/0'/0/{0..count}`.\n ///\n /// The respective private keys are saved to the local forge wallet for later use and their addresses are returned.\n #[cheatcode(group = Crypto)]\n function rememberKeys(string calldata mnemonic, string calldata derivationPath, string calldata language, uint32 count)\n external\n returns (address[] memory keyAddrs);\n\n // -------- Uncategorized Utilities --------\n\n /// Labels an address in call traces.\n #[cheatcode(group = Utilities)]\n function label(address account, string calldata newLabel) external;\n\n /// Gets the label for the specified address.\n #[cheatcode(group = Utilities)]\n function getLabel(address account) external view returns (string memory currentLabel);\n\n /// Compute the address a contract will be deployed at for a given deployer address and nonce.\n #[cheatcode(group = Utilities)]\n function computeCreateAddress(address deployer, uint256 nonce) external pure returns (address);\n\n /// Compute the address of a contract created with CREATE2 using the given CREATE2 deployer.\n #[cheatcode(group = Utilities)]\n function computeCreate2Address(bytes32 salt, bytes32 initCodeHash, address deployer) external pure returns (address);\n\n /// Compute the address of a contract created with CREATE2 using the default CREATE2 deployer.\n #[cheatcode(group = Utilities)]\n function computeCreate2Address(bytes32 salt, bytes32 initCodeHash) external pure returns (address);\n\n /// Encodes a `bytes` value to a base64 string.\n #[cheatcode(group = Utilities)]\n function toBase64(bytes calldata data) external pure returns (string memory);\n\n /// Encodes a `string` value to a base64 string.\n #[cheatcode(group = Utilities)]\n function toBase64(string calldata data) external pure returns (string memory);\n\n /// Encodes a `bytes` value to a base64url string.\n #[cheatcode(group = Utilities)]\n function toBase64URL(bytes calldata data) external pure returns (string memory);\n\n /// Encodes a `string` value to a base64url string.\n #[cheatcode(group = Utilities)]\n function toBase64URL(string calldata data) external pure returns (string memory);\n\n /// Returns ENS namehash for provided string.\n #[cheatcode(group = Utilities)]\n function ensNamehash(string calldata name) external pure returns (bytes32);\n\n /// Returns an uint256 value bounded in given range and different from the current one.\n #[cheatcode(group = Utilities)]\n function bound(uint256 current, uint256 min, uint256 max) external view returns (uint256);\n\n /// Returns a random uint256 value.\n #[cheatcode(group = Utilities)]\n function randomUint() external view returns (uint256);\n\n /// Returns random uint256 value between the provided range (=min..=max).\n #[cheatcode(group = Utilities)]\n function randomUint(uint256 min, uint256 max) external view returns (uint256);\n\n /// Returns a random `uint256` value of given bits.\n #[cheatcode(group = Utilities)]\n function randomUint(uint256 bits) external view returns (uint256);\n\n /// Returns a random `address`.\n #[cheatcode(group = Utilities)]\n function randomAddress() external view returns (address);\n\n /// Returns an int256 value bounded in given range and different from the current one.\n #[cheatcode(group = Utilities)]\n function bound(int256 current, int256 min, int256 max) external view returns (int256);\n\n /// Returns a random `int256` value.\n #[cheatcode(group = Utilities)]\n function randomInt() external view returns (int256);\n\n /// Returns a random `int256` value of given bits.\n #[cheatcode(group = Utilities)]\n function randomInt(uint256 bits) external view returns (int256);\n\n /// Returns a random `bool`.\n #[cheatcode(group = Utilities)]\n function randomBool() external view returns (bool);\n\n /// Returns a random byte array value of the given length.\n #[cheatcode(group = Utilities)]\n function randomBytes(uint256 len) external view returns (bytes memory);\n\n /// Returns a random fixed-size byte array of length 4.\n #[cheatcode(group = Utilities)]\n function randomBytes4() external view returns (bytes4);\n\n /// Returns a random fixed-size byte array of length 8.\n #[cheatcode(group = Utilities)]\n function randomBytes8() external view returns (bytes8);\n\n /// Pauses collection of call traces. Useful in cases when you want to skip tracing of\n /// complex calls which are not useful for debugging.\n #[cheatcode(group = Utilities)]\n function pauseTracing() external view;\n\n /// Unpauses collection of call traces.\n #[cheatcode(group = Utilities)]\n function resumeTracing() external view;\n\n /// Utility cheatcode to copy storage of `from` contract to another `to` contract.\n #[cheatcode(group = Utilities)]\n function copyStorage(address from, address to) external;\n\n /// Utility cheatcode to set arbitrary storage for given target address.\n #[cheatcode(group = Utilities)]\n function setArbitraryStorage(address target) external;\n\n /// Utility cheatcode to set arbitrary storage for given target address and overwrite\n /// any storage slots that have been previously set.\n #[cheatcode(group = Utilities)]\n function setArbitraryStorage(address target, bool overwrite) external;\n\n /// Sorts an array in ascending order.\n #[cheatcode(group = Utilities)]\n function sort(uint256[] calldata array) external returns (uint256[] memory);\n\n /// Randomly shuffles an array.\n #[cheatcode(group = Utilities)]\n function shuffle(uint256[] calldata array) external returns (uint256[] memory);\n\n /// Set RNG seed.\n #[cheatcode(group = Utilities)]\n function setSeed(uint256 seed) external;\n\n /// Causes the next contract creation (via new) to fail and return its initcode in the returndata buffer.\n /// This allows type-safe access to the initcode payload that would be used for contract creation.\n /// Example usage:\n /// vm.interceptInitcode();\n /// bytes memory initcode;\n /// try new MyContract(param1, param2) { assert(false); }\n /// catch (bytes memory interceptedInitcode) { initcode = interceptedInitcode; }\n #[cheatcode(group = Utilities, safety = Unsafe)]\n function interceptInitcode() external;\n\n /// Generates the hash of the canonical EIP-712 type representation.\n ///\n /// Supports 2 different inputs:\n /// 1. Name of the type (i.e. \"Transaction\"):\n /// * requires previous binding generation with `forge bind-json`.\n /// * bindings will be retrieved from the path configured in `foundry.toml`.\n ///\n /// 2. String representation of the type (i.e. \"Foo(Bar bar) Bar(uint256 baz)\").\n /// * Note: the cheatcode will output the canonical type even if the input is malformated\n /// with the wrong order of elements or with extra whitespaces.\n #[cheatcode(group = Utilities)]\n function eip712HashType(string calldata typeNameOrDefinition) external pure returns (bytes32 typeHash);\n\n /// Generates the hash of the canonical EIP-712 type representation.\n /// Requires previous binding generation with `forge bind-json`.\n ///\n /// Params:\n /// * `bindingsPath`: path where the output of `forge bind-json` is stored.\n /// * `typeName`: Name of the type (i.e. \"Transaction\").\n #[cheatcode(group = Utilities)]\n function eip712HashType(string calldata bindingsPath, string calldata typeName) external pure returns (bytes32 typeHash);\n\n /// Generates the struct hash of the canonical EIP-712 type representation and its abi-encoded data.\n ///\n /// Supports 2 different inputs:\n /// 1. Name of the type (i.e. \"PermitSingle\"):\n /// * requires previous binding generation with `forge bind-json`.\n /// * bindings will be retrieved from the path configured in `foundry.toml`.\n ///\n /// 2. String representation of the type (i.e. \"Foo(Bar bar) Bar(uint256 baz)\").\n /// * Note: the cheatcode will use the canonical type even if the input is malformated\n /// with the wrong order of elements or with extra whitespaces.\n #[cheatcode(group = Utilities)]\n function eip712HashStruct(string calldata typeNameOrDefinition, bytes calldata abiEncodedData) external pure returns (bytes32 typeHash);\n\n /// Generates the struct hash of the canonical EIP-712 type representation and its abi-encoded data.\n /// Requires previous binding generation with `forge bind-json`.\n ///\n /// Params:\n /// * `bindingsPath`: path where the output of `forge bind-json` is stored.\n /// * `typeName`: Name of the type (i.e. \"PermitSingle\").\n /// * `abiEncodedData`: ABI-encoded data for the struct that is being hashed.\n #[cheatcode(group = Utilities)]\n function eip712HashStruct(string calldata bindingsPath, string calldata typeName, bytes calldata abiEncodedData) external pure returns (bytes32 typeHash);\n\n /// Generates a ready-to-sign digest of human-readable typed data following the EIP-712 standard.\n #[cheatcode(group = Utilities)]\n function eip712HashTypedData(string calldata jsonData) external pure returns (bytes32 digest);\n\n /// RLP encodes a list of bytes into an RLP payload.\n #[cheatcode(group = Utilities)]\n function toRlp(bytes[] calldata data) external pure returns (bytes memory);\n /// RLP decodes an RLP payload into a list of bytes.\n #[cheatcode(group = Utilities)]\n function fromRlp(bytes calldata rlp) external pure returns (bytes[] memory data);\n}\n}\n\nimpl PartialEq for ForgeContext {\n // Handles test group case (any of test, coverage or snapshot)\n // and script group case (any of dry run, broadcast or resume).\n fn eq(&self, other: &Self) -> bool {\n match (self, other) {\n (_, Self::TestGroup) => {\n matches!(self, Self::Test | Self::Snapshot | Self::Coverage)\n }\n (_, Self::ScriptGroup) => {\n matches!(self, Self::ScriptDryRun | Self::ScriptBroadcast | Self::ScriptResume)\n }\n (Self::Test, Self::Test)\n | (Self::Snapshot, Self::Snapshot)\n | (Self::Coverage, Self::Coverage)\n | (Self::ScriptDryRun, Self::ScriptDryRun)\n | (Self::ScriptBroadcast, Self::ScriptBroadcast)\n | (Self::ScriptResume, Self::ScriptResume)\n | (Self::Unknown, Self::Unknown) => true,\n _ => false,\n }\n }\n}\n\nimpl fmt::Display for Vm::CheatcodeError {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n self.message.fmt(f)\n }\n}\n\nimpl fmt::Display for Vm::VmErrors {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n match self {\n Self::CheatcodeError(err) => err.fmt(f),\n }\n }\n}\n\n#[track_caller]\nconst fn panic_unknown_safety() -> ! {\n panic!(\"cannot determine safety from the group, add a `#[cheatcode(safety = ...)]` attribute\")\n}\n" }, { "path": "crates/cheatcodes/src/base64.rs", "content": "use crate::{Cheatcode, Cheatcodes, Result, Vm::*};\nuse alloy_sol_types::SolValue;\nuse base64::prelude::*;\n\nimpl Cheatcode for toBase64_0Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { data } = self;\n Ok(BASE64_STANDARD.encode(data).abi_encode())\n }\n}\n\nimpl Cheatcode for toBase64_1Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { data } = self;\n Ok(BASE64_STANDARD.encode(data).abi_encode())\n }\n}\n\nimpl Cheatcode for toBase64URL_0Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { data } = self;\n Ok(BASE64_URL_SAFE.encode(data).abi_encode())\n }\n}\n\nimpl Cheatcode for toBase64URL_1Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { data } = self;\n Ok(BASE64_URL_SAFE.encode(data).abi_encode())\n }\n}\n" }, { "path": "crates/cheatcodes/src/config.rs", "content": "use super::Result;\nuse crate::Vm::Rpc;\nuse alloy_primitives::{U256, map::AddressHashMap};\nuse foundry_common::{ContractsByArtifact, fs::normalize_path};\nuse foundry_compilers::{ArtifactId, ProjectPathsConfig, utils::canonicalize};\nuse foundry_config::{\n Config, FsPermissions, ResolvedRpcEndpoint, ResolvedRpcEndpoints, RpcEndpoint, RpcEndpointUrl,\n cache::StorageCachingConfig, fs_permissions::FsAccessKind,\n};\nuse foundry_evm_core::opts::EvmOpts;\nuse std::{\n path::{Path, PathBuf},\n time::Duration,\n};\n\n/// Additional, configurable context the `Cheatcodes` inspector has access to\n///\n/// This is essentially a subset of various `Config` settings `Cheatcodes` needs to know.\n#[derive(Clone, Debug)]\npub struct CheatsConfig {\n /// Whether the FFI cheatcode is enabled.\n pub ffi: bool,\n /// Use the create 2 factory in all cases including tests and non-broadcasting scripts.\n pub always_use_create_2_factory: bool,\n /// Sets a timeout for vm.prompt cheatcodes\n pub prompt_timeout: Duration,\n /// RPC storage caching settings determines what chains and endpoints to cache\n pub rpc_storage_caching: StorageCachingConfig,\n /// Disables storage caching entirely.\n pub no_storage_caching: bool,\n /// All known endpoints and their aliases\n pub rpc_endpoints: ResolvedRpcEndpoints,\n /// Project's paths as configured\n pub paths: ProjectPathsConfig,\n /// Path to the directory that contains the bindings generated by `forge bind-json`.\n pub bind_json_path: PathBuf,\n /// Filesystem permissions for cheatcodes like `writeFile`, `readFile`\n pub fs_permissions: FsPermissions,\n /// Project root\n pub root: PathBuf,\n /// Absolute Path to broadcast dir i.e project_root/broadcast\n pub broadcast: PathBuf,\n /// How the evm was configured by the user\n pub evm_opts: EvmOpts,\n /// Address labels from config\n pub labels: AddressHashMap,\n /// Artifacts which are guaranteed to be fresh (either recompiled or cached).\n /// If Some, `vm.getDeployedCode` invocations are validated to be in scope of this list.\n /// If None, no validation is performed.\n pub available_artifacts: Option,\n /// Currently running artifact.\n pub running_artifact: Option,\n /// Whether to enable legacy (non-reverting) assertions.\n pub assertions_revert: bool,\n /// Optional seed for the RNG algorithm.\n pub seed: Option,\n /// Whether to allow `expectRevert` to work for internal calls.\n pub internal_expect_revert: bool,\n}\n\nimpl CheatsConfig {\n /// Extracts the necessary settings from the Config\n pub fn new(\n config: &Config,\n evm_opts: EvmOpts,\n available_artifacts: Option,\n running_artifact: Option,\n ) -> Self {\n let rpc_endpoints = config.rpc_endpoints.clone().resolved();\n trace!(?rpc_endpoints, \"using resolved rpc endpoints\");\n\n // If user explicitly disabled safety checks, do not set available_artifacts\n let available_artifacts =\n if config.unchecked_cheatcode_artifacts { None } else { available_artifacts };\n\n Self {\n ffi: evm_opts.ffi,\n always_use_create_2_factory: evm_opts.always_use_create_2_factory,\n prompt_timeout: Duration::from_secs(config.prompt_timeout),\n rpc_storage_caching: config.rpc_storage_caching.clone(),\n no_storage_caching: config.no_storage_caching,\n rpc_endpoints,\n paths: config.project_paths(),\n bind_json_path: config.bind_json.out.clone(),\n fs_permissions: config.fs_permissions.clone().joined(config.root.as_ref()),\n root: config.root.clone(),\n broadcast: config.root.clone().join(&config.broadcast),\n evm_opts,\n labels: config.labels.clone(),\n available_artifacts,\n running_artifact,\n assertions_revert: config.assertions_revert,\n seed: config.fuzz.seed,\n internal_expect_revert: config.allow_internal_expect_revert,\n }\n }\n\n /// Returns a new `CheatsConfig` configured with the given `Config` and `EvmOpts`.\n pub fn clone_with(&self, config: &Config, evm_opts: EvmOpts) -> Self {\n Self::new(config, evm_opts, self.available_artifacts.clone(), self.running_artifact.clone())\n }\n\n /// Attempts to canonicalize (see [std::fs::canonicalize]) the path.\n ///\n /// Canonicalization fails for non-existing paths, in which case we just normalize the path.\n pub fn normalized_path(&self, path: impl AsRef) -> PathBuf {\n let path = self.root.join(path);\n canonicalize(&path).unwrap_or_else(|_| normalize_path(&path))\n }\n\n /// Returns true if the given path is allowed, if any path `allowed_paths` is an ancestor of the\n /// path\n ///\n /// We only allow paths that are inside allowed paths. To prevent path traversal\n /// (\"../../etc/passwd\") we canonicalize/normalize the path first. We always join with the\n /// configured root directory.\n pub fn is_path_allowed(&self, path: impl AsRef, kind: FsAccessKind) -> bool {\n self.is_normalized_path_allowed(&self.normalized_path(path), kind)\n }\n\n fn is_normalized_path_allowed(&self, path: &Path, kind: FsAccessKind) -> bool {\n self.fs_permissions.is_path_allowed(path, kind)\n }\n\n /// Returns an error if no access is granted to access `path`, See also [Self::is_path_allowed]\n ///\n /// Returns the normalized version of `path`, see [`CheatsConfig::normalized_path`]\n pub fn ensure_path_allowed(\n &self,\n path: impl AsRef,\n kind: FsAccessKind,\n ) -> Result {\n let path = path.as_ref();\n let normalized = self.normalized_path(path);\n ensure!(\n self.is_normalized_path_allowed(&normalized, kind),\n \"the path {} is not allowed to be accessed for {kind} operations\",\n normalized.strip_prefix(&self.root).unwrap_or(path).display()\n );\n Ok(normalized)\n }\n\n /// Returns true if the given `path` is the project's foundry.toml file\n ///\n /// Note: this should be called with normalized path\n pub fn is_foundry_toml(&self, path: impl AsRef) -> bool {\n // path methods that do not access the filesystem are such as [`Path::starts_with`], are\n // case-sensitive no matter the platform or filesystem. to make this case-sensitive\n // we convert the underlying `OssStr` to lowercase checking that `path` and\n // `foundry.toml` are the same file by comparing the FD, because it may not exist\n let foundry_toml = self.root.join(Config::FILE_NAME);\n Path::new(&foundry_toml.to_string_lossy().to_lowercase())\n .starts_with(Path::new(&path.as_ref().to_string_lossy().to_lowercase()))\n }\n\n /// Same as [`Self::is_foundry_toml`] but returns an `Err` if [`Self::is_foundry_toml`] returns\n /// true\n pub fn ensure_not_foundry_toml(&self, path: impl AsRef) -> Result<()> {\n ensure!(!self.is_foundry_toml(path), \"access to `foundry.toml` is not allowed\");\n Ok(())\n }\n\n /// Returns the RPC to use\n ///\n /// If `url_or_alias` is a known alias in the `ResolvedRpcEndpoints` then it returns the\n /// corresponding URL of that alias. otherwise this assumes `url_or_alias` is itself a URL\n /// if it starts with a `http` or `ws` scheme.\n ///\n /// If the url is a path to an existing file, it is also considered a valid RPC URL, IPC path.\n ///\n /// # Errors\n ///\n /// - Returns an error if `url_or_alias` is a known alias but references an unresolved env var.\n /// - Returns an error if `url_or_alias` is not an alias but does not start with a `http` or\n /// `ws` `scheme` and is not a path to an existing file\n pub fn rpc_endpoint(&self, url_or_alias: &str) -> Result {\n if let Some(endpoint) = self.rpc_endpoints.get(url_or_alias) {\n Ok(endpoint.clone().try_resolve())\n } else {\n // check if it's a URL or a path to an existing file to an ipc socket\n if url_or_alias.starts_with(\"http\") ||\n url_or_alias.starts_with(\"ws\") ||\n // check for existing ipc file\n Path::new(url_or_alias).exists()\n {\n let url = RpcEndpointUrl::Env(url_or_alias.to_string());\n Ok(RpcEndpoint::new(url).resolve())\n } else {\n Err(fmt_err!(\"invalid rpc url: {url_or_alias}\"))\n }\n }\n }\n /// Returns all the RPC urls and their alias.\n pub fn rpc_urls(&self) -> Result> {\n let mut urls = Vec::with_capacity(self.rpc_endpoints.len());\n for alias in self.rpc_endpoints.keys() {\n let url = self.rpc_endpoint(alias)?.url()?;\n urls.push(Rpc { key: alias.clone(), url });\n }\n Ok(urls)\n }\n}\n\nimpl Default for CheatsConfig {\n fn default() -> Self {\n Self {\n ffi: false,\n always_use_create_2_factory: false,\n prompt_timeout: Duration::from_secs(120),\n rpc_storage_caching: Default::default(),\n no_storage_caching: false,\n rpc_endpoints: Default::default(),\n paths: ProjectPathsConfig::builder().build_with_root(\"./\"),\n fs_permissions: Default::default(),\n root: Default::default(),\n bind_json_path: PathBuf::default().join(\"utils\").join(\"jsonBindings.sol\"),\n broadcast: Default::default(),\n evm_opts: Default::default(),\n labels: Default::default(),\n available_artifacts: Default::default(),\n running_artifact: Default::default(),\n assertions_revert: true,\n seed: None,\n internal_expect_revert: false,\n }\n }\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n use foundry_config::fs_permissions::PathPermission;\n\n fn config(root: &str, fs_permissions: FsPermissions) -> CheatsConfig {\n CheatsConfig::new(\n &Config { root: root.into(), fs_permissions, ..Default::default() },\n Default::default(),\n None,\n None,\n )\n }\n\n #[test]\n fn test_allowed_paths() {\n let root = \"/my/project/root/\";\n let config = config(root, FsPermissions::new(vec![PathPermission::read_write(\"./\")]));\n\n assert!(config.ensure_path_allowed(\"./t.txt\", FsAccessKind::Read).is_ok());\n assert!(config.ensure_path_allowed(\"./t.txt\", FsAccessKind::Write).is_ok());\n assert!(config.ensure_path_allowed(\"../root/t.txt\", FsAccessKind::Read).is_ok());\n assert!(config.ensure_path_allowed(\"../root/t.txt\", FsAccessKind::Write).is_ok());\n assert!(config.ensure_path_allowed(\"../../root/t.txt\", FsAccessKind::Read).is_err());\n assert!(config.ensure_path_allowed(\"../../root/t.txt\", FsAccessKind::Write).is_err());\n }\n\n #[test]\n fn test_is_foundry_toml() {\n let root = \"/my/project/root/\";\n let config = config(root, FsPermissions::new(vec![PathPermission::read_write(\"./\")]));\n\n let f = format!(\"{root}foundry.toml\");\n assert!(config.is_foundry_toml(f));\n\n let f = format!(\"{root}Foundry.toml\");\n assert!(config.is_foundry_toml(f));\n\n let f = format!(\"{root}lib/other/foundry.toml\");\n assert!(!config.is_foundry_toml(f));\n }\n}\n" }, { "path": "crates/cheatcodes/src/crypto.rs", "content": "//! Implementations of [`Crypto`](spec::Group::Crypto) Cheatcodes.\n\nuse crate::{Cheatcode, Cheatcodes, Result, Vm::*};\nuse alloy_primitives::{Address, B256, U256, keccak256};\nuse alloy_signer::{Signer, SignerSync};\nuse alloy_signer_local::{\n LocalSigner, MnemonicBuilder, PrivateKeySigner,\n coins_bip39::{\n ChineseSimplified, ChineseTraditional, Czech, English, French, Italian, Japanese, Korean,\n Portuguese, Spanish, Wordlist,\n },\n};\nuse alloy_sol_types::SolValue;\nuse k256::{\n FieldBytes, Scalar,\n ecdsa::{SigningKey, hazmat},\n elliptic_curve::{bigint::ArrayEncoding, sec1::ToEncodedPoint},\n};\n\nuse p256::ecdsa::{\n Signature as P256Signature, SigningKey as P256SigningKey, signature::hazmat::PrehashSigner,\n};\n\nuse ed25519_consensus::{\n Signature as Ed25519Signature, SigningKey as Ed25519SigningKey,\n VerificationKey as Ed25519VerificationKey,\n};\n\n/// The BIP32 default derivation path prefix.\nconst DEFAULT_DERIVATION_PATH_PREFIX: &str = \"m/44'/60'/0'/0/\";\n\nimpl Cheatcode for createWallet_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { walletLabel } = self;\n create_wallet(&U256::from_be_bytes(keccak256(walletLabel).0), Some(walletLabel), state)\n }\n}\n\nimpl Cheatcode for createWallet_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { privateKey } = self;\n create_wallet(privateKey, None, state)\n }\n}\n\nimpl Cheatcode for createWallet_2Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { privateKey, walletLabel } = self;\n create_wallet(privateKey, Some(walletLabel), state)\n }\n}\n\nimpl Cheatcode for sign_0Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { wallet, digest } = self;\n let sig = sign(&wallet.privateKey, digest)?;\n Ok(encode_full_sig(sig))\n }\n}\n\nimpl Cheatcode for signWithNonceUnsafeCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let pk: U256 = self.privateKey;\n let digest: B256 = self.digest;\n let nonce: U256 = self.nonce;\n let sig: alloy_primitives::Signature = sign_with_nonce(&pk, &digest, &nonce)?;\n Ok(encode_full_sig(sig))\n }\n}\n\nimpl Cheatcode for signCompact_0Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { wallet, digest } = self;\n let sig = sign(&wallet.privateKey, digest)?;\n Ok(encode_compact_sig(sig))\n }\n}\n\nimpl Cheatcode for deriveKey_0Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { mnemonic, index } = self;\n derive_key::(mnemonic, DEFAULT_DERIVATION_PATH_PREFIX, *index)\n }\n}\n\nimpl Cheatcode for deriveKey_1Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { mnemonic, derivationPath, index } = self;\n derive_key::(mnemonic, derivationPath, *index)\n }\n}\n\nimpl Cheatcode for deriveKey_2Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { mnemonic, index, language } = self;\n derive_key_str(mnemonic, DEFAULT_DERIVATION_PATH_PREFIX, *index, language)\n }\n}\n\nimpl Cheatcode for deriveKey_3Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { mnemonic, derivationPath, index, language } = self;\n derive_key_str(mnemonic, derivationPath, *index, language)\n }\n}\n\nimpl Cheatcode for rememberKeyCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { privateKey } = self;\n let wallet = parse_wallet(privateKey)?;\n let address = inject_wallet(state, wallet);\n Ok(address.abi_encode())\n }\n}\n\nimpl Cheatcode for rememberKeys_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { mnemonic, derivationPath, count } = self;\n let wallets = derive_wallets::(mnemonic, derivationPath, *count)?;\n let mut addresses = Vec::
::with_capacity(wallets.len());\n for wallet in wallets {\n let addr = inject_wallet(state, wallet);\n addresses.push(addr);\n }\n\n Ok(addresses.abi_encode())\n }\n}\n\nimpl Cheatcode for rememberKeys_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { mnemonic, derivationPath, language, count } = self;\n let wallets = derive_wallets_str(mnemonic, derivationPath, language, *count)?;\n let mut addresses = Vec::
::with_capacity(wallets.len());\n for wallet in wallets {\n let addr = inject_wallet(state, wallet);\n addresses.push(addr);\n }\n\n Ok(addresses.abi_encode())\n }\n}\n\nfn inject_wallet(state: &mut Cheatcodes, wallet: LocalSigner) -> Address {\n let address = wallet.address();\n state.wallets().add_local_signer(wallet);\n address\n}\n\nimpl Cheatcode for sign_1Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { privateKey, digest } = self;\n let sig = sign(privateKey, digest)?;\n Ok(encode_full_sig(sig))\n }\n}\n\nimpl Cheatcode for signCompact_1Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { privateKey, digest } = self;\n let sig = sign(privateKey, digest)?;\n Ok(encode_compact_sig(sig))\n }\n}\n\nimpl Cheatcode for sign_2Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { digest } = self;\n let sig = sign_with_wallet(state, None, digest)?;\n Ok(encode_full_sig(sig))\n }\n}\n\nimpl Cheatcode for signCompact_2Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { digest } = self;\n let sig = sign_with_wallet(state, None, digest)?;\n Ok(encode_compact_sig(sig))\n }\n}\n\nimpl Cheatcode for sign_3Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { signer, digest } = self;\n let sig = sign_with_wallet(state, Some(*signer), digest)?;\n Ok(encode_full_sig(sig))\n }\n}\n\nimpl Cheatcode for signCompact_3Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { signer, digest } = self;\n let sig = sign_with_wallet(state, Some(*signer), digest)?;\n Ok(encode_compact_sig(sig))\n }\n}\n\nimpl Cheatcode for signP256Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { privateKey, digest } = self;\n sign_p256(privateKey, digest)\n }\n}\n\nimpl Cheatcode for publicKeyP256Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { privateKey } = self;\n let pub_key =\n parse_private_key_p256(privateKey)?.verifying_key().as_affine().to_encoded_point(false);\n let pub_key_x = U256::from_be_bytes((*pub_key.x().unwrap()).into());\n let pub_key_y = U256::from_be_bytes((*pub_key.y().unwrap()).into());\n\n Ok((pub_key_x, pub_key_y).abi_encode())\n }\n}\n\nimpl Cheatcode for createEd25519KeyCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { salt } = self;\n create_ed25519_key(salt)\n }\n}\n\nimpl Cheatcode for publicKeyEd25519Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { privateKey } = self;\n public_key_ed25519(privateKey)\n }\n}\n\nimpl Cheatcode for signEd25519Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { namespace, message, privateKey } = self;\n sign_ed25519(namespace, message, privateKey)\n }\n}\n\nimpl Cheatcode for verifyEd25519Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { signature, namespace, message, publicKey } = self;\n verify_ed25519(signature, namespace, message, publicKey)\n }\n}\n\n/// Using a given private key, return its public ETH address, its public key affine x and y\n/// coordinates, and its private key (see the 'Wallet' struct)\n///\n/// If 'label' is set to 'Some()', assign that label to the associated ETH address in state\nfn create_wallet(private_key: &U256, label: Option<&str>, state: &mut Cheatcodes) -> Result {\n let key = parse_private_key(private_key)?;\n let addr = alloy_signer::utils::secret_key_to_address(&key);\n\n let pub_key = key.verifying_key().as_affine().to_encoded_point(false);\n let pub_key_x = U256::from_be_bytes((*pub_key.x().unwrap()).into());\n let pub_key_y = U256::from_be_bytes((*pub_key.y().unwrap()).into());\n\n if let Some(label) = label {\n state.labels.insert(addr, label.into());\n }\n\n Ok(Wallet { addr, publicKeyX: pub_key_x, publicKeyY: pub_key_y, privateKey: *private_key }\n .abi_encode())\n}\n\nfn encode_full_sig(sig: alloy_primitives::Signature) -> Vec {\n // Retrieve v, r and s from signature.\n let v = U256::from(sig.v() as u64 + 27);\n let r = B256::from(sig.r());\n let s = B256::from(sig.s());\n (v, r, s).abi_encode()\n}\n\nfn encode_compact_sig(sig: alloy_primitives::Signature) -> Vec {\n // Implement EIP-2098 compact signature.\n let r = B256::from(sig.r());\n let mut vs = sig.s();\n vs.set_bit(255, sig.v());\n (r, vs).abi_encode()\n}\n\nfn sign(private_key: &U256, digest: &B256) -> Result {\n // The `ecrecover` precompile does not use EIP-155. No chain ID is needed.\n let wallet = parse_wallet(private_key)?;\n let sig = wallet.sign_hash_sync(digest)?;\n debug_assert_eq!(sig.recover_address_from_prehash(digest)?, wallet.address());\n Ok(sig)\n}\n\n/// Signs `digest` on secp256k1 using a user-supplied ephemeral nonce `k` (no RFC6979).\n/// - `private_key` and `nonce` must be in (0, n)\n/// - `digest` is a 32-byte prehash.\n///\n/// # Warning\n///\n/// Use [`sign_with_nonce`] with extreme caution!\n/// Reusing the same nonce (`k`) with the same private key in ECDSA will leak the private key.\n/// Always generate `nonce` with a cryptographically secure RNG, and never reuse it across\n/// signatures.\nfn sign_with_nonce(\n private_key: &U256,\n digest: &B256,\n nonce: &U256,\n) -> Result {\n let d_scalar: Scalar =\n ::from_repr(private_key.to_be_bytes().into())\n .into_option()\n .ok_or_else(|| fmt_err!(\"invalid private key scalar\"))?;\n if bool::from(d_scalar.is_zero()) {\n return Err(fmt_err!(\"private key cannot be 0\"));\n }\n\n let k_scalar: Scalar =\n ::from_repr(nonce.to_be_bytes().into())\n .into_option()\n .ok_or_else(|| fmt_err!(\"invalid nonce scalar\"))?;\n if bool::from(k_scalar.is_zero()) {\n return Err(fmt_err!(\"nonce cannot be 0\"));\n }\n\n let mut z = [0u8; 32];\n z.copy_from_slice(digest.as_slice());\n let z_fb: FieldBytes = FieldBytes::from(z);\n\n // Hazmat signing using the scalar `d` (SignPrimitive is implemented for `Scalar`)\n // Note: returns (Signature, Option)\n let (sig_raw, recid_opt) =\n >::try_sign_prehashed(\n &d_scalar, k_scalar, &z_fb,\n )\n .map_err(|e| fmt_err!(\"sign_prehashed failed: {e}\"))?;\n\n // Enforce low-s; if mirrored, parity flips (weā€™ll account for it below if we use recid)\n let (sig_low, flipped) =\n if let Some(norm) = sig_raw.normalize_s() { (norm, true) } else { (sig_raw, false) };\n\n let r_u256 = U256::from_be_bytes(sig_low.r().to_bytes().into());\n let s_u256 = U256::from_be_bytes(sig_low.s().to_bytes().into());\n\n // Determine v parity in {0,1}\n let v_parity = if let Some(id) = recid_opt {\n let mut v = id.to_byte() & 1;\n if flipped {\n v ^= 1;\n }\n v\n } else {\n // Fallback: choose parity by recovery to expected address\n let expected_addr = {\n let sk: SigningKey = parse_private_key(private_key)?;\n alloy_signer::utils::secret_key_to_address(&sk)\n };\n // Try v = 0\n let cand0 = alloy_primitives::Signature::new(r_u256, s_u256, false);\n if cand0.recover_address_from_prehash(digest).ok() == Some(expected_addr) {\n return Ok(cand0);\n }\n // Try v = 1\n let cand1 = alloy_primitives::Signature::new(r_u256, s_u256, true);\n if cand1.recover_address_from_prehash(digest).ok() == Some(expected_addr) {\n return Ok(cand1);\n }\n return Err(fmt_err!(\"failed to determine recovery id for signature\"));\n };\n\n let y_parity = v_parity != 0;\n Ok(alloy_primitives::Signature::new(r_u256, s_u256, y_parity))\n}\n\nfn sign_with_wallet(\n state: &mut Cheatcodes,\n signer: Option
,\n digest: &B256,\n) -> Result {\n if state.wallets().is_empty() {\n bail!(\"no wallets available\");\n }\n\n let mut wallets = state.wallets().inner.lock();\n let maybe_provided_sender = wallets.provided_sender;\n let signers = wallets.multi_wallet.signers()?;\n\n let signer = if let Some(signer) = signer {\n signer\n } else if let Some(provided_sender) = maybe_provided_sender {\n provided_sender\n } else if signers.len() == 1 {\n *signers.keys().next().unwrap()\n } else {\n bail!(\n \"could not determine signer, there are multiple signers available use vm.sign(signer, digest) to specify one\"\n );\n };\n\n let wallet = signers\n .get(&signer)\n .ok_or_else(|| fmt_err!(\"signer with address {signer} is not available\"))?;\n\n let sig = foundry_common::block_on(wallet.sign_hash(digest))?;\n debug_assert_eq!(sig.recover_address_from_prehash(digest)?, signer);\n Ok(sig)\n}\n\nfn sign_p256(private_key: &U256, digest: &B256) -> Result {\n let signing_key = parse_private_key_p256(private_key)?;\n let signature: P256Signature = signing_key.sign_prehash(digest.as_slice())?;\n let signature = signature.normalize_s().unwrap_or(signature);\n let r_bytes: [u8; 32] = signature.r().to_bytes().into();\n let s_bytes: [u8; 32] = signature.s().to_bytes().into();\n\n Ok((r_bytes, s_bytes).abi_encode())\n}\n\nfn validate_private_key(private_key: &U256) -> Result<()> {\n ensure!(*private_key != U256::ZERO, \"private key cannot be 0\");\n let order = U256::from_be_slice(&C::ORDER.to_be_byte_array());\n ensure!(\n *private_key < order,\n \"private key must be less than the {curve:?} curve order ({order})\",\n curve = C::default(),\n );\n\n Ok(())\n}\n\nfn parse_private_key(private_key: &U256) -> Result {\n validate_private_key::(private_key)?;\n Ok(SigningKey::from_bytes((&private_key.to_be_bytes()).into())?)\n}\n\nfn parse_private_key_p256(private_key: &U256) -> Result {\n validate_private_key::(private_key)?;\n Ok(P256SigningKey::from_bytes((&private_key.to_be_bytes()).into())?)\n}\n\nfn parse_signing_key_ed25519(private_key: &B256) -> Result {\n Ed25519SigningKey::try_from(private_key.as_slice())\n .map_err(|e| fmt_err!(\"invalid Ed25519 private key: {e}\"))\n}\n\nfn create_ed25519_key(salt: &B256) -> Result {\n let signing_key = parse_signing_key_ed25519(salt)?;\n let public_key = B256::from_slice(signing_key.verification_key().as_ref());\n Ok((public_key, *salt).abi_encode())\n}\n\nfn public_key_ed25519(private_key: &B256) -> Result {\n let signing_key = parse_signing_key_ed25519(private_key)?;\n Ok(B256::from_slice(signing_key.verification_key().as_ref()).abi_encode())\n}\n\nfn sign_ed25519(namespace: &[u8], message: &[u8], private_key: &B256) -> Result {\n let signing_key = parse_signing_key_ed25519(private_key)?;\n let combined = [namespace, message].concat();\n let signature: [u8; 64] = signing_key.sign(&combined).into();\n Ok(signature.to_vec().abi_encode())\n}\n\nfn verify_ed25519(signature: &[u8], namespace: &[u8], message: &[u8], public_key: &B256) -> Result {\n if signature.len() != 64 {\n return Ok(false.abi_encode());\n }\n\n let Ok(verification_key) = Ed25519VerificationKey::try_from(public_key.as_slice()) else {\n return Ok(false.abi_encode());\n };\n\n let Ok(sig_bytes): Result<[u8; 64], _> = signature.try_into() else {\n return Ok(false.abi_encode());\n };\n\n let combined = [namespace, message].concat();\n let valid = verification_key.verify(&Ed25519Signature::from(sig_bytes), &combined).is_ok();\n Ok(valid.abi_encode())\n}\n\npub(super) fn parse_wallet(private_key: &U256) -> Result {\n parse_private_key(private_key).map(PrivateKeySigner::from)\n}\n\nfn derive_key_str(mnemonic: &str, path: &str, index: u32, language: &str) -> Result {\n match language {\n \"chinese_simplified\" => derive_key::(mnemonic, path, index),\n \"chinese_traditional\" => derive_key::(mnemonic, path, index),\n \"czech\" => derive_key::(mnemonic, path, index),\n \"english\" => derive_key::(mnemonic, path, index),\n \"french\" => derive_key::(mnemonic, path, index),\n \"italian\" => derive_key::(mnemonic, path, index),\n \"japanese\" => derive_key::(mnemonic, path, index),\n \"korean\" => derive_key::(mnemonic, path, index),\n \"portuguese\" => derive_key::(mnemonic, path, index),\n \"spanish\" => derive_key::(mnemonic, path, index),\n _ => Err(fmt_err!(\"unsupported mnemonic language: {language:?}\")),\n }\n}\n\nfn derive_key(mnemonic: &str, path: &str, index: u32) -> Result {\n fn derive_key_path(path: &str, index: u32) -> String {\n let mut out = path.to_string();\n if !out.ends_with('/') {\n out.push('/');\n }\n out.push_str(&index.to_string());\n out\n }\n\n let wallet = MnemonicBuilder::::default()\n .phrase(mnemonic)\n .derivation_path(derive_key_path(path, index))?\n .build()?;\n let private_key = U256::from_be_bytes(wallet.credential().to_bytes().into());\n Ok(private_key.abi_encode())\n}\n\nfn derive_wallets_str(\n mnemonic: &str,\n path: &str,\n language: &str,\n count: u32,\n) -> Result>> {\n match language {\n \"chinese_simplified\" => derive_wallets::(mnemonic, path, count),\n \"chinese_traditional\" => derive_wallets::(mnemonic, path, count),\n \"czech\" => derive_wallets::(mnemonic, path, count),\n \"english\" => derive_wallets::(mnemonic, path, count),\n \"french\" => derive_wallets::(mnemonic, path, count),\n \"italian\" => derive_wallets::(mnemonic, path, count),\n \"japanese\" => derive_wallets::(mnemonic, path, count),\n \"korean\" => derive_wallets::(mnemonic, path, count),\n \"portuguese\" => derive_wallets::(mnemonic, path, count),\n \"spanish\" => derive_wallets::(mnemonic, path, count),\n _ => Err(fmt_err!(\"unsupported mnemonic language: {language:?}\")),\n }\n}\n\nfn derive_wallets(\n mnemonic: &str,\n path: &str,\n count: u32,\n) -> Result>> {\n let mut out = path.to_string();\n\n if !out.ends_with('/') {\n out.push('/');\n }\n\n let mut wallets = Vec::with_capacity(count as usize);\n for idx in 0..count {\n let wallet = MnemonicBuilder::::default()\n .phrase(mnemonic)\n .derivation_path(format!(\"{out}{idx}\"))?\n .build()?;\n wallets.push(wallet);\n }\n\n Ok(wallets)\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n use alloy_primitives::{FixedBytes, hex::FromHex};\n use k256::elliptic_curve::Curve;\n use p256::ecdsa::signature::hazmat::PrehashVerifier;\n\n #[test]\n fn test_sign_p256() {\n use p256::ecdsa::VerifyingKey;\n\n let pk_u256: U256 = \"1\".parse().unwrap();\n let signing_key = P256SigningKey::from_bytes(&pk_u256.to_be_bytes().into()).unwrap();\n let digest = FixedBytes::from_hex(\n \"0x44acf6b7e36c1342c2c5897204fe09504e1e2efb1a900377dbc4e7a6a133ec56\",\n )\n .unwrap();\n\n let result = sign_p256(&pk_u256, &digest).unwrap();\n let result_bytes: [u8; 64] = result.try_into().unwrap();\n let signature = P256Signature::from_bytes(&result_bytes.into()).unwrap();\n let verifying_key = VerifyingKey::from(&signing_key);\n assert!(verifying_key.verify_prehash(digest.as_slice(), &signature).is_ok());\n }\n\n #[test]\n fn test_sign_p256_pk_too_large() {\n // max n from https://neuromancer.sk/std/secg/secp256r1\n let pk =\n \"0xffffffff00000000ffffffffffffffffbce6faada7179e84f3b9cac2fc632551\".parse().unwrap();\n let digest = FixedBytes::from_hex(\n \"0x54705ba3baafdbdfba8c5f9a70f7a89bee98d906b53e31074da7baecdc0da9ad\",\n )\n .unwrap();\n let result = sign_p256(&pk, &digest);\n assert_eq!(\n result.err().unwrap().to_string(),\n \"private key must be less than the NistP256 curve order (115792089210356248762697446949407573529996955224135760342422259061068512044369)\"\n );\n }\n\n #[test]\n fn test_sign_p256_pk_0() {\n let digest = FixedBytes::from_hex(\n \"0x54705ba3baafdbdfba8c5f9a70f7a89bee98d906b53e31074da7baecdc0da9ad\",\n )\n .unwrap();\n let result = sign_p256(&U256::ZERO, &digest);\n assert_eq!(result.err().unwrap().to_string(), \"private key cannot be 0\");\n }\n\n #[test]\n fn test_sign_with_nonce_varies_and_recovers() {\n // Given a fixed private key and digest\n let pk_u256: U256 = U256::from(1u64);\n let digest = FixedBytes::from_hex(\n \"0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n )\n .unwrap();\n\n // Two distinct nonces\n let n1: U256 = U256::from(123u64);\n let n2: U256 = U256::from(456u64);\n\n // Sign with both nonces\n let sig1 = sign_with_nonce(&pk_u256, &digest, &n1).expect(\"sig1\");\n let sig2 = sign_with_nonce(&pk_u256, &digest, &n2).expect(\"sig2\");\n\n // (r,s) must differ when nonce differs\n assert!(\n sig1.r() != sig2.r() || sig1.s() != sig2.s(),\n \"signatures should differ with different nonces\"\n );\n\n // ecrecover must yield the address for both signatures\n let sk = parse_private_key(&pk_u256).unwrap();\n let expected = alloy_signer::utils::secret_key_to_address(&sk);\n\n assert_eq!(sig1.recover_address_from_prehash(&digest).unwrap(), expected);\n assert_eq!(sig2.recover_address_from_prehash(&digest).unwrap(), expected);\n }\n\n #[test]\n fn test_sign_with_nonce_zero_nonce_errors() {\n // nonce = 0 should be rejected\n let pk_u256: U256 = U256::from(1u64);\n let digest = FixedBytes::from_hex(\n \"0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb\",\n )\n .unwrap();\n let n0: U256 = U256::ZERO;\n\n let err = sign_with_nonce(&pk_u256, &digest, &n0).unwrap_err();\n let msg = err.to_string();\n assert!(msg.contains(\"nonce cannot be 0\"), \"unexpected error: {msg}\");\n }\n\n #[test]\n fn test_sign_with_nonce_nonce_ge_order_errors() {\n // nonce >= n should be rejected\n use k256::Secp256k1;\n // Curve order n as U256\n let n_u256 = U256::from_be_slice(&Secp256k1::ORDER.to_be_byte_array());\n\n let pk_u256: U256 = U256::from(1u64);\n let digest = FixedBytes::from_hex(\n \"0xcccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc\",\n )\n .unwrap();\n\n // Try exactly n (>= n invalid)\n let err = sign_with_nonce(&pk_u256, &digest, &n_u256).unwrap_err();\n let msg = err.to_string();\n assert!(msg.contains(\"invalid nonce scalar\"), \"unexpected error: {msg}\");\n }\n\n #[test]\n fn test_create_ed25519_key_determinism() {\n let salt = B256::from([1u8; 32]);\n let result1 = create_ed25519_key(&salt).unwrap();\n let result2 = create_ed25519_key(&salt).unwrap();\n assert_eq!(result1, result2, \"same salt should produce same keys\");\n }\n\n #[test]\n fn test_create_ed25519_key_different_salts() {\n let salt1 = B256::from([1u8; 32]);\n let salt2 = B256::from([2u8; 32]);\n let result1 = create_ed25519_key(&salt1).unwrap();\n let result2 = create_ed25519_key(&salt2).unwrap();\n assert_ne!(result1, result2, \"different salts should produce different keys\");\n }\n\n #[test]\n fn test_public_key_ed25519_consistency() {\n let salt = B256::from([42u8; 32]);\n let create_result = create_ed25519_key(&salt).unwrap();\n let (expected_public, private): (B256, B256) =\n <(B256, B256)>::abi_decode(&create_result).unwrap();\n\n let derived_public_result = public_key_ed25519(&private).unwrap();\n let derived_public = B256::abi_decode(&derived_public_result).unwrap();\n\n assert_eq!(expected_public, derived_public, \"derived public key should match\");\n }\n\n #[test]\n fn test_sign_and_verify_ed25519_valid() {\n let salt = B256::from([123u8; 32]);\n let create_result = create_ed25519_key(&salt).unwrap();\n let (public_key, private_key): (B256, B256) =\n <(B256, B256)>::abi_decode(&create_result).unwrap();\n\n let namespace = b\"test.namespace\";\n let message = b\"hello world\";\n let sig_result = sign_ed25519(namespace, message, &private_key).unwrap();\n let sig_bytes: Vec = Vec::abi_decode(&sig_result).unwrap();\n\n let verify_result = verify_ed25519(&sig_bytes, namespace, message, &public_key).unwrap();\n let valid = bool::abi_decode(&verify_result).unwrap();\n\n assert!(valid, \"signature should be valid\");\n }\n\n #[test]\n fn test_verify_ed25519_invalid_signature() {\n let salt = B256::from([123u8; 32]);\n let create_result = create_ed25519_key(&salt).unwrap();\n let (public_key, _): (B256, B256) = <(B256, B256)>::abi_decode(&create_result).unwrap();\n\n let invalid_sig = [0u8; 64];\n let namespace = b\"test.namespace\";\n let message = b\"hello world\";\n\n let verify_result = verify_ed25519(&invalid_sig, namespace, message, &public_key).unwrap();\n let valid = bool::abi_decode(&verify_result).unwrap();\n\n assert!(!valid, \"invalid signature should not verify\");\n }\n\n #[test]\n fn test_verify_ed25519_namespace_separation() {\n let salt = B256::from([123u8; 32]);\n let create_result = create_ed25519_key(&salt).unwrap();\n let (public_key, private_key): (B256, B256) =\n <(B256, B256)>::abi_decode(&create_result).unwrap();\n\n let namespace_a = b\"namespace.a\";\n let message = b\"message\";\n let sig_result = sign_ed25519(namespace_a, message, &private_key).unwrap();\n let sig_bytes: Vec = Vec::abi_decode(&sig_result).unwrap();\n\n let namespace_b = b\"namespace.b\";\n let verify_result = verify_ed25519(&sig_bytes, namespace_b, message, &public_key).unwrap();\n let valid = bool::abi_decode(&verify_result).unwrap();\n assert!(!valid, \"signature with namespace A should not verify with namespace B\");\n\n let verify_result = verify_ed25519(&sig_bytes, namespace_a, message, &public_key).unwrap();\n let valid = bool::abi_decode(&verify_result).unwrap();\n assert!(valid, \"signature should verify with correct namespace\");\n }\n\n #[test]\n fn test_verify_ed25519_invalid_signature_length() {\n let salt = B256::from([123u8; 32]);\n let create_result = create_ed25519_key(&salt).unwrap();\n let (public_key, _): (B256, B256) = <(B256, B256)>::abi_decode(&create_result).unwrap();\n\n let invalid_sig = [0u8; 32];\n let namespace = b\"test\";\n let message = b\"message\";\n\n let verify_result = verify_ed25519(&invalid_sig, namespace, message, &public_key).unwrap();\n let valid = bool::abi_decode(&verify_result).unwrap();\n assert!(!valid, \"signature with wrong length should not verify\");\n }\n}\n" }, { "path": "crates/cheatcodes/src/env.rs", "content": "//! Implementations of [`Environment`](spec::Group::Environment) cheatcodes.\n\nuse crate::{Cheatcode, Cheatcodes, Error, Result, Vm::*, string};\nuse alloy_dyn_abi::DynSolType;\nuse alloy_sol_types::SolValue;\nuse std::{env, sync::OnceLock};\n\n/// Stores the forge execution context for the duration of the program.\npub static FORGE_CONTEXT: OnceLock = OnceLock::new();\n\nimpl Cheatcode for setEnvCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name: key, value } = self;\n if key.is_empty() {\n Err(fmt_err!(\"environment variable key can't be empty\"))\n } else if key.contains('=') {\n Err(fmt_err!(\"environment variable key can't contain equal sign `=`\"))\n } else if key.contains('\\0') {\n Err(fmt_err!(\"environment variable key can't contain NUL character `\\\\0`\"))\n } else if value.contains('\\0') {\n Err(fmt_err!(\"environment variable value can't contain NUL character `\\\\0`\"))\n } else {\n unsafe {\n env::set_var(key, value);\n }\n Ok(Default::default())\n }\n }\n}\n\nimpl Cheatcode for resolveEnvCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { input } = self;\n let resolved = foundry_config::resolve::interpolate(input)\n .map_err(|e| fmt_err!(\"failed to resolve env var: {e}\"))?;\n Ok(resolved.abi_encode())\n }\n}\n\nimpl Cheatcode for envExistsCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name } = self;\n Ok(env::var(name).is_ok().abi_encode())\n }\n}\n\nimpl Cheatcode for envBool_0Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name } = self;\n env(name, &DynSolType::Bool)\n }\n}\n\nimpl Cheatcode for envUint_0Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name } = self;\n env(name, &DynSolType::Uint(256))\n }\n}\n\nimpl Cheatcode for envInt_0Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name } = self;\n env(name, &DynSolType::Int(256))\n }\n}\n\nimpl Cheatcode for envAddress_0Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name } = self;\n env(name, &DynSolType::Address)\n }\n}\n\nimpl Cheatcode for envBytes32_0Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name } = self;\n env(name, &DynSolType::FixedBytes(32))\n }\n}\n\nimpl Cheatcode for envString_0Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name } = self;\n env(name, &DynSolType::String)\n }\n}\n\nimpl Cheatcode for envBytes_0Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name } = self;\n env(name, &DynSolType::Bytes)\n }\n}\n\nimpl Cheatcode for envBool_1Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name, delim } = self;\n env_array(name, delim, &DynSolType::Bool)\n }\n}\n\nimpl Cheatcode for envUint_1Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name, delim } = self;\n env_array(name, delim, &DynSolType::Uint(256))\n }\n}\n\nimpl Cheatcode for envInt_1Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name, delim } = self;\n env_array(name, delim, &DynSolType::Int(256))\n }\n}\n\nimpl Cheatcode for envAddress_1Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name, delim } = self;\n env_array(name, delim, &DynSolType::Address)\n }\n}\n\nimpl Cheatcode for envBytes32_1Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name, delim } = self;\n env_array(name, delim, &DynSolType::FixedBytes(32))\n }\n}\n\nimpl Cheatcode for envString_1Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name, delim } = self;\n env_array(name, delim, &DynSolType::String)\n }\n}\n\nimpl Cheatcode for envBytes_1Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name, delim } = self;\n env_array(name, delim, &DynSolType::Bytes)\n }\n}\n\n// bool\nimpl Cheatcode for envOr_0Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name, defaultValue } = self;\n env_default(name, defaultValue, &DynSolType::Bool)\n }\n}\n\n// uint256\nimpl Cheatcode for envOr_1Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name, defaultValue } = self;\n env_default(name, defaultValue, &DynSolType::Uint(256))\n }\n}\n\n// int256\nimpl Cheatcode for envOr_2Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name, defaultValue } = self;\n env_default(name, defaultValue, &DynSolType::Int(256))\n }\n}\n\n// address\nimpl Cheatcode for envOr_3Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name, defaultValue } = self;\n env_default(name, defaultValue, &DynSolType::Address)\n }\n}\n\n// bytes32\nimpl Cheatcode for envOr_4Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name, defaultValue } = self;\n env_default(name, defaultValue, &DynSolType::FixedBytes(32))\n }\n}\n\n// string\nimpl Cheatcode for envOr_5Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name, defaultValue } = self;\n env_default(name, defaultValue, &DynSolType::String)\n }\n}\n\n// bytes\nimpl Cheatcode for envOr_6Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name, defaultValue } = self;\n env_default(name, defaultValue, &DynSolType::Bytes)\n }\n}\n\n// bool[]\nimpl Cheatcode for envOr_7Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name, delim, defaultValue } = self;\n env_array_default(name, delim, defaultValue, &DynSolType::Bool)\n }\n}\n\n// uint256[]\nimpl Cheatcode for envOr_8Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name, delim, defaultValue } = self;\n env_array_default(name, delim, defaultValue, &DynSolType::Uint(256))\n }\n}\n\n// int256[]\nimpl Cheatcode for envOr_9Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name, delim, defaultValue } = self;\n env_array_default(name, delim, defaultValue, &DynSolType::Int(256))\n }\n}\n\n// address[]\nimpl Cheatcode for envOr_10Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name, delim, defaultValue } = self;\n env_array_default(name, delim, defaultValue, &DynSolType::Address)\n }\n}\n\n// bytes32[]\nimpl Cheatcode for envOr_11Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name, delim, defaultValue } = self;\n env_array_default(name, delim, defaultValue, &DynSolType::FixedBytes(32))\n }\n}\n\n// string[]\nimpl Cheatcode for envOr_12Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name, delim, defaultValue } = self;\n env_array_default(name, delim, defaultValue, &DynSolType::String)\n }\n}\n\n// bytes[]\nimpl Cheatcode for envOr_13Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name, delim, defaultValue } = self;\n let default = defaultValue.to_vec();\n env_array_default(name, delim, &default, &DynSolType::Bytes)\n }\n}\n\nimpl Cheatcode for isContextCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { context } = self;\n Ok((FORGE_CONTEXT.get() == Some(context)).abi_encode())\n }\n}\n\n/// Set `forge` command current execution context for the duration of the program.\n/// Execution context is immutable, subsequent calls of this function won't change the context.\npub fn set_execution_context(context: ForgeContext) {\n let _ = FORGE_CONTEXT.set(context);\n}\n\nfn env(key: &str, ty: &DynSolType) -> Result {\n get_env(key).and_then(|val| string::parse(&val, ty).map_err(map_env_err(key, &val)))\n}\n\nfn env_default(key: &str, default: &T, ty: &DynSolType) -> Result {\n Ok(env(key, ty).unwrap_or_else(|_| default.abi_encode()))\n}\n\nfn env_array(key: &str, delim: &str, ty: &DynSolType) -> Result {\n get_env(key).and_then(|val| {\n string::parse_array(val.split(delim).map(str::trim), ty).map_err(map_env_err(key, &val))\n })\n}\n\nfn env_array_default(key: &str, delim: &str, default: &T, ty: &DynSolType) -> Result {\n Ok(env_array(key, delim, ty).unwrap_or_else(|_| default.abi_encode()))\n}\n\nfn get_env(key: &str) -> Result {\n match env::var(key) {\n Ok(val) => Ok(val),\n Err(env::VarError::NotPresent) => Err(fmt_err!(\"environment variable {key:?} not found\")),\n Err(env::VarError::NotUnicode(s)) => {\n Err(fmt_err!(\"environment variable {key:?} was not valid unicode: {s:?}\"))\n }\n }\n}\n\n/// Converts the error message of a failed parsing attempt to a more user-friendly message that\n/// doesn't leak the value.\nfn map_env_err<'a>(key: &'a str, value: &'a str) -> impl FnOnce(Error) -> Error + 'a {\n move |e| {\n // failed parsing as type `uint256`: parser error:\n // \n // ^\n // expected at least one digit\n let mut e = e.to_string();\n e = e.replacen(&format!(\"\\\"{value}\\\"\"), &format!(\"${key}\"), 1);\n e = e.replacen(&format!(\"\\n{value}\\n\"), &format!(\"\\n${key}\\n\"), 1);\n Error::from(e)\n }\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n\n #[test]\n fn parse_env_uint() {\n let key = \"parse_env_uint\";\n let value = \"t\";\n unsafe {\n env::set_var(key, value);\n }\n\n let err = env(key, &DynSolType::Uint(256)).unwrap_err().to_string();\n assert_eq!(err.matches(\"$parse_env_uint\").count(), 2, \"{err:?}\");\n unsafe {\n env::remove_var(key);\n }\n }\n}\n" }, { "path": "crates/cheatcodes/src/error.rs", "content": "use crate::Vm;\nuse alloy_primitives::{Bytes, hex};\nuse alloy_signer::Error as SignerError;\nuse alloy_signer_local::LocalSignerError;\nuse alloy_sol_types::SolError;\nuse foundry_common::errors::FsPathError;\nuse foundry_config::UnresolvedEnvVarError;\nuse foundry_evm_core::backend::{BackendError, DatabaseError};\nuse foundry_wallets::error::WalletSignerError;\nuse k256::ecdsa::signature::Error as SignatureError;\nuse revm::context_interface::result::EVMError;\nuse std::{borrow::Cow, fmt};\n\n/// Cheatcode result type.\n///\n/// Type alias with a default Ok type of [`Vec`], and default Err type of [`Error`].\npub type Result, E = Error> = std::result::Result;\n\nmacro_rules! fmt_err {\n ($msg:literal $(,)?) => {\n $crate::Error::fmt(::std::format_args!($msg))\n };\n ($err:expr $(,)?) => {\n <$crate::Error as ::std::convert::From<_>>::from($err)\n };\n ($fmt:expr, $($arg:tt)*) => {\n $crate::Error::fmt(::std::format_args!($fmt, $($arg)*))\n };\n}\n\nmacro_rules! bail {\n ($msg:literal $(,)?) => {\n return ::std::result::Result::Err(fmt_err!($msg))\n };\n ($err:expr $(,)?) => {\n return ::std::result::Result::Err(fmt_err!($err))\n };\n ($fmt:expr, $($arg:tt)*) => {\n return ::std::result::Result::Err(fmt_err!($fmt, $($arg)*))\n };\n}\n\nmacro_rules! ensure {\n ($cond:expr $(,)?) => {\n if !$cond {\n return ::std::result::Result::Err($crate::Error::custom(\n ::std::concat!(\"Condition failed: `\", ::std::stringify!($cond), \"`\")\n ));\n }\n };\n ($cond:expr, $msg:literal $(,)?) => {\n if !$cond {\n return ::std::result::Result::Err(fmt_err!($msg));\n }\n };\n ($cond:expr, $err:expr $(,)?) => {\n if !$cond {\n return ::std::result::Result::Err(fmt_err!($err));\n }\n };\n ($cond:expr, $fmt:expr, $($arg:tt)*) => {\n if !$cond {\n return ::std::result::Result::Err(fmt_err!($fmt, $($arg)*));\n }\n };\n}\n\n/// Error thrown by cheatcodes.\n// This uses a custom repr to minimize the size of the error.\n// The repr is basically `enum { Cow<'static, str>, Cow<'static, [u8]> }`\npub struct Error {\n /// If true, encode `data` as `Error(string)`, otherwise encode it directly as `bytes`.\n is_str: bool,\n /// Whether this was constructed from an owned byte vec, which means we have to drop the data\n /// in `impl Drop`.\n drop: bool,\n /// The error data. Always a valid pointer, and never modified.\n data: *const [u8],\n}\n\nimpl std::error::Error for Error {}\n\nimpl fmt::Debug for Error {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n f.write_str(\"Error::\")?;\n self.kind().fmt(f)\n }\n}\n\nimpl fmt::Display for Error {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n self.kind().fmt(f)\n }\n}\n\n/// Kind of cheatcode errors.\n///\n/// Constructed by [`Error::kind`].\n#[derive(Debug)]\npub enum ErrorKind<'a> {\n /// A string error, ABI-encoded as `CheatcodeError(string)`.\n String(&'a str),\n /// A raw bytes error. Does not get encoded.\n Bytes(&'a [u8]),\n}\n\nimpl fmt::Display for ErrorKind<'_> {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n match *self {\n Self::String(ss) => f.write_str(ss),\n Self::Bytes(b) => f.write_str(&hex::encode_prefixed(b)),\n }\n }\n}\n\nimpl Error {\n /// Creates a new error and ABI encodes it as `CheatcodeError(string)`.\n pub fn encode(error: impl Into) -> Bytes {\n error.into().abi_encode().into()\n }\n\n /// Creates a new error with a custom message.\n pub fn display(msg: impl fmt::Display) -> Self {\n Self::fmt(format_args!(\"{msg}\"))\n }\n\n /// Creates a new error with a custom [`fmt::Arguments`] message.\n pub fn fmt(args: fmt::Arguments<'_>) -> Self {\n match args.as_str() {\n Some(s) => Self::new_str(s),\n None => Self::new_string(std::fmt::format(args)),\n }\n }\n\n /// ABI-encodes this error as `CheatcodeError(string)` if the inner message is a string,\n /// otherwise returns the raw bytes.\n pub fn abi_encode(&self) -> Vec {\n match self.kind() {\n ErrorKind::String(string) => Vm::CheatcodeError { message: string.into() }.abi_encode(),\n ErrorKind::Bytes(bytes) => bytes.into(),\n }\n }\n\n /// Returns the kind of this error.\n pub fn kind(&self) -> ErrorKind<'_> {\n let data = self.data();\n if self.is_str {\n debug_assert!(std::str::from_utf8(data).is_ok());\n ErrorKind::String(unsafe { std::str::from_utf8_unchecked(data) })\n } else {\n ErrorKind::Bytes(data)\n }\n }\n\n /// Returns the raw data of this error.\n pub fn data(&self) -> &[u8] {\n unsafe { &*self.data }\n }\n\n /// Returns `true` if this error is a human-readable string.\n pub fn is_str(&self) -> bool {\n self.is_str\n }\n\n fn new_str(data: &'static str) -> Self {\n Self::_new(true, false, data.as_bytes())\n }\n\n fn new_string(data: String) -> Self {\n Self::_new(true, true, Box::into_raw(data.into_boxed_str().into_boxed_bytes()))\n }\n\n fn new_bytes(data: &'static [u8]) -> Self {\n Self::_new(false, false, data)\n }\n\n fn new_vec(data: Vec) -> Self {\n Self::_new(false, true, Box::into_raw(data.into_boxed_slice()))\n }\n\n fn _new(is_str: bool, drop: bool, data: *const [u8]) -> Self {\n debug_assert!(!data.is_null());\n Self { is_str, drop, data }\n }\n}\n\nimpl Drop for Error {\n fn drop(&mut self) {\n if self.drop {\n drop(unsafe { Box::<[u8]>::from_raw(self.data.cast_mut()) });\n }\n }\n}\n\nimpl From> for Error {\n fn from(value: Cow<'static, str>) -> Self {\n match value {\n Cow::Borrowed(str) => Self::new_str(str),\n Cow::Owned(string) => Self::new_string(string),\n }\n }\n}\n\nimpl From for Error {\n fn from(value: String) -> Self {\n Self::new_string(value)\n }\n}\n\nimpl From<&'static str> for Error {\n fn from(value: &'static str) -> Self {\n Self::new_str(value)\n }\n}\n\nimpl From> for Error {\n fn from(value: Cow<'static, [u8]>) -> Self {\n match value {\n Cow::Borrowed(bytes) => Self::new_bytes(bytes),\n Cow::Owned(vec) => Self::new_vec(vec),\n }\n }\n}\n\nimpl From<&'static [u8]> for Error {\n fn from(value: &'static [u8]) -> Self {\n Self::new_bytes(value)\n }\n}\n\nimpl From<&'static [u8; N]> for Error {\n fn from(value: &'static [u8; N]) -> Self {\n Self::new_bytes(value)\n }\n}\n\nimpl From> for Error {\n fn from(value: Vec) -> Self {\n Self::new_vec(value)\n }\n}\n\nimpl From for Error {\n fn from(value: Bytes) -> Self {\n Self::new_vec(value.into())\n }\n}\n\n// So we can use `?` on `Result<_, Error>`.\nmacro_rules! impl_from {\n ($($t:ty),* $(,)?) => {$(\n impl From<$t> for Error {\n fn from(value: $t) -> Self {\n Self::display(value)\n }\n }\n )*};\n}\n\nimpl_from!(\n alloy_sol_types::Error,\n alloy_dyn_abi::Error,\n alloy_primitives::SignatureError,\n alloy_consensus::crypto::RecoveryError,\n FsPathError,\n hex::FromHexError,\n BackendError,\n DatabaseError,\n jsonpath_lib::JsonPathError,\n serde_json::Error,\n SignatureError,\n std::io::Error,\n std::num::TryFromIntError,\n std::str::Utf8Error,\n std::string::FromUtf8Error,\n UnresolvedEnvVarError,\n LocalSignerError,\n SignerError,\n WalletSignerError,\n);\n\nimpl> From> for Error {\n fn from(err: EVMError) -> Self {\n Self::display(BackendError::from(err))\n }\n}\n\nimpl From for Error {\n fn from(err: eyre::Report) -> Self {\n Self::new_string(foundry_common::errors::display_chain(&err))\n }\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n\n #[test]\n fn encode() {\n let error = Vm::CheatcodeError { message: \"hello\".into() }.abi_encode();\n assert_eq!(Error::from(\"hello\").abi_encode(), error);\n assert_eq!(Error::encode(\"hello\"), error);\n\n assert_eq!(Error::from(b\"hello\").abi_encode(), b\"hello\");\n assert_eq!(Error::encode(b\"hello\"), b\"hello\"[..]);\n }\n}\n" }, { "path": "crates/cheatcodes/src/evm/fork.rs", "content": "use crate::{\n Cheatcode, Cheatcodes, CheatcodesExecutor, CheatsCtxt, DatabaseExt, EthCheatCtx, Result, Vm::*,\n json::json_value_to_token,\n};\nuse alloy_dyn_abi::DynSolValue;\nuse alloy_evm::EvmEnv;\nuse alloy_network::AnyNetwork;\nuse alloy_primitives::{B256, U256};\nuse alloy_provider::Provider;\nuse alloy_rpc_types::Filter;\nuse alloy_sol_types::SolValue;\nuse foundry_common::provider::ProviderBuilder;\nuse foundry_evm_core::{FoundryContextExt, backend::JournaledState, fork::CreateFork};\nuse revm::context::{Cfg, ContextTr};\n\nimpl Cheatcode for activeForkCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self {} = self;\n ccx.ecx\n .db()\n .active_fork_id()\n .map(|id| id.abi_encode())\n .ok_or_else(|| fmt_err!(\"no active fork\"))\n }\n}\n\nimpl Cheatcode for createFork_0Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { urlOrAlias } = self;\n create_fork(ccx, urlOrAlias, None)\n }\n}\n\nimpl Cheatcode for createFork_1Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { urlOrAlias, blockNumber } = self;\n create_fork(ccx, urlOrAlias, Some(blockNumber.saturating_to()))\n }\n}\n\nimpl Cheatcode for createFork_2Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { urlOrAlias, txHash } = self;\n create_fork_at_transaction(ccx, urlOrAlias, txHash)\n }\n}\n\nimpl Cheatcode for createSelectFork_0Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { urlOrAlias } = self;\n create_select_fork(ccx, urlOrAlias, None)\n }\n}\n\nimpl Cheatcode for createSelectFork_1Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { urlOrAlias, blockNumber } = self;\n create_select_fork(ccx, urlOrAlias, Some(blockNumber.saturating_to()))\n }\n}\n\nimpl Cheatcode for createSelectFork_2Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { urlOrAlias, txHash } = self;\n create_select_fork_at_transaction(ccx, urlOrAlias, txHash)\n }\n}\n\nimpl Cheatcode for rollFork_0Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { blockNumber } = self;\n persist_caller(ccx);\n fork_env_op(ccx, |db, evm_env, tx_env, inner| {\n db.roll_fork(None, (*blockNumber).to(), evm_env, tx_env, inner)\n })\n }\n}\n\nimpl Cheatcode for rollFork_1Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { txHash } = self;\n persist_caller(ccx);\n fork_env_op(ccx, |db, evm_env, tx_env, inner| {\n db.roll_fork_to_transaction(None, *txHash, evm_env, tx_env, inner)\n })\n }\n}\n\nimpl Cheatcode for rollFork_2Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { forkId, blockNumber } = self;\n persist_caller(ccx);\n fork_env_op(ccx, |db, evm_env, tx_env, inner| {\n db.roll_fork(Some(*forkId), (*blockNumber).to(), evm_env, tx_env, inner)\n })\n }\n}\n\nimpl Cheatcode for rollFork_3Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { forkId, txHash } = self;\n persist_caller(ccx);\n fork_env_op(ccx, |db, evm_env, tx_env, inner| {\n db.roll_fork_to_transaction(Some(*forkId), *txHash, evm_env, tx_env, inner)\n })\n }\n}\n\nimpl Cheatcode for selectForkCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { forkId } = self;\n persist_caller(ccx);\n check_broadcast(ccx.state)?;\n fork_env_op(ccx, |db, evm_env, tx_env, inner| {\n db.select_fork(*forkId, evm_env, tx_env, inner)\n })\n }\n}\n\nimpl Cheatcode for transact_0Call {\n fn apply_full(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n ) -> Result {\n let Self { txHash } = *self;\n transact(ccx, executor, txHash, None)\n }\n}\n\nimpl Cheatcode for transact_1Call {\n fn apply_full(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n ) -> Result {\n let Self { forkId, txHash } = *self;\n transact(ccx, executor, txHash, Some(forkId))\n }\n}\n\nimpl Cheatcode for allowCheatcodesCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { account } = self;\n ccx.ecx.db_mut().allow_cheatcode_access(*account);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for makePersistent_0Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { account } = self;\n ccx.ecx.db_mut().add_persistent_account(*account);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for makePersistent_1Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { account0, account1 } = self;\n ccx.ecx.db_mut().add_persistent_account(*account0);\n ccx.ecx.db_mut().add_persistent_account(*account1);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for makePersistent_2Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { account0, account1, account2 } = self;\n ccx.ecx.db_mut().add_persistent_account(*account0);\n ccx.ecx.db_mut().add_persistent_account(*account1);\n ccx.ecx.db_mut().add_persistent_account(*account2);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for makePersistent_3Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { accounts } = self;\n for account in accounts {\n ccx.ecx.db_mut().add_persistent_account(*account);\n }\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for revokePersistent_0Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { account } = self;\n ccx.ecx.db_mut().remove_persistent_account(account);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for revokePersistent_1Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { accounts } = self;\n for account in accounts {\n ccx.ecx.db_mut().remove_persistent_account(account);\n }\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for isPersistentCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { account } = self;\n Ok(ccx.ecx.db().is_persistent(account).abi_encode())\n }\n}\n\nimpl Cheatcode for rpc_0Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { method, params } = self;\n let url =\n ccx.ecx.db().active_fork_url().ok_or_else(|| fmt_err!(\"no active fork URL found\"))?;\n rpc_call(&url, method, params)\n }\n}\n\nimpl Cheatcode for rpc_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { urlOrAlias, method, params } = self;\n let url = state.config.rpc_endpoint(urlOrAlias)?.url()?;\n rpc_call(&url, method, params)\n }\n}\n\nimpl Cheatcode for eth_getLogsCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { fromBlock, toBlock, target, topics } = self;\n let (Ok(from_block), Ok(to_block)) = (u64::try_from(fromBlock), u64::try_from(toBlock))\n else {\n bail!(\"blocks in block range must be less than 2^64\")\n };\n\n if topics.len() > 4 {\n bail!(\"topics array must contain at most 4 elements\")\n }\n\n let url =\n ccx.ecx.db().active_fork_url().ok_or_else(|| fmt_err!(\"no active fork URL found\"))?;\n let provider = ProviderBuilder::::new(&url).build()?;\n let mut filter = Filter::new().address(*target).from_block(from_block).to_block(to_block);\n for (i, &topic) in topics.iter().enumerate() {\n filter.topics[i] = topic.into();\n }\n\n let logs = foundry_common::block_on(provider.get_logs(&filter))\n .map_err(|e| fmt_err!(\"failed to get logs: {e}\"))?;\n\n let eth_logs = logs\n .into_iter()\n .map(|log| EthGetLogs {\n emitter: log.address(),\n topics: log.topics().to_vec(),\n data: log.inner.data.data,\n blockHash: log.block_hash.unwrap_or_default(),\n blockNumber: log.block_number.unwrap_or_default(),\n transactionHash: log.transaction_hash.unwrap_or_default(),\n transactionIndex: log.transaction_index.unwrap_or_default(),\n logIndex: U256::from(log.log_index.unwrap_or_default()),\n removed: log.removed,\n })\n .collect::>();\n\n Ok(eth_logs.abi_encode())\n }\n}\n\nimpl Cheatcode for getRawBlockHeaderCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { blockNumber } = self;\n let url = ccx.ecx.db().active_fork_url().ok_or_else(|| fmt_err!(\"no active fork\"))?;\n let provider = ProviderBuilder::::new(&url).build()?;\n let block_number = u64::try_from(blockNumber)\n .map_err(|_| fmt_err!(\"block number must be less than 2^64\"))?;\n let block =\n foundry_common::block_on(async move { provider.get_block(block_number.into()).await })\n .map_err(|e| fmt_err!(\"failed to get block: {e}\"))?\n .ok_or_else(|| fmt_err!(\"block {block_number} not found\"))?;\n\n let header: alloy_consensus::Header = block\n .into_inner()\n .header\n .inner\n .try_into_header()\n .map_err(|e| fmt_err!(\"failed to convert to header: {e}\"))?;\n Ok(alloy_rlp::encode(&header).abi_encode())\n }\n}\n\n/// Creates and then also selects the new fork\nfn create_select_fork(\n ccx: &mut CheatsCtxt<'_, CTX>,\n url_or_alias: &str,\n block: Option,\n) -> Result {\n check_broadcast(ccx.state)?;\n\n let fork = create_fork_request(ccx, url_or_alias, block)?;\n fork_env_op(ccx, |db, evm_env, tx_env, inner| {\n db.create_select_fork(fork, evm_env, tx_env, inner)\n })\n}\n\n/// Creates a new fork\nfn create_fork(\n ccx: &mut CheatsCtxt<'_, CTX>,\n url_or_alias: &str,\n block: Option,\n) -> Result {\n let fork = create_fork_request(ccx, url_or_alias, block)?;\n let id = ccx.ecx.db_mut().create_fork(fork)?;\n Ok(id.abi_encode())\n}\n\n/// Creates and then also selects the new fork at the given transaction\nfn create_select_fork_at_transaction(\n ccx: &mut CheatsCtxt<'_, CTX>,\n url_or_alias: &str,\n transaction: &B256,\n) -> Result {\n check_broadcast(ccx.state)?;\n\n let fork = create_fork_request(ccx, url_or_alias, None)?;\n fork_env_op(ccx, |db, evm_env, tx_env, inner| {\n db.create_select_fork_at_transaction(fork, evm_env, tx_env, inner, *transaction)\n })\n}\n\n/// Creates a new fork at the given transaction\nfn create_fork_at_transaction(\n ccx: &mut CheatsCtxt<'_, CTX>,\n url_or_alias: &str,\n transaction: &B256,\n) -> Result {\n let fork = create_fork_request(ccx, url_or_alias, None)?;\n let id = ccx.ecx.db_mut().create_fork_at_transaction(fork, *transaction)?;\n Ok(id.abi_encode())\n}\n\n/// Creates the request object for a new fork request\nfn create_fork_request(\n ccx: &mut CheatsCtxt<'_, CTX>,\n url_or_alias: &str,\n block: Option,\n) -> Result {\n persist_caller(ccx);\n\n let rpc_endpoint = ccx.state.config.rpc_endpoint(url_or_alias)?;\n let url = rpc_endpoint.url()?;\n let mut evm_opts = ccx.state.config.evm_opts.clone();\n evm_opts.fork_block_number = block;\n evm_opts.fork_retries = rpc_endpoint.config.retries;\n evm_opts.fork_retry_backoff = rpc_endpoint.config.retry_backoff;\n if let Some(Ok(auth)) = rpc_endpoint.auth {\n evm_opts.fork_headers = Some(vec![format!(\"Authorization: {auth}\")]);\n }\n let fork = CreateFork {\n enable_caching: !ccx.state.config.no_storage_caching\n && ccx.state.config.rpc_storage_caching.enable_for_endpoint(&url),\n url,\n evm_env: EvmEnv {\n cfg_env: ccx.ecx.cfg_mut().clone(),\n block_env: ccx.ecx.block_mut().clone(),\n },\n evm_opts,\n };\n Ok(fork)\n}\n\n/// Clones the EVM and tx environments, runs a fork operation that may modify them, then writes\n/// them back. This is the common pattern for all fork-switching cheatcodes (rollFork, selectFork,\n/// createSelectFork).\nfn fork_env_op(\n ccx: &mut CheatsCtxt<'_, CTX>,\n f: impl FnOnce(\n &mut dyn DatabaseExt::Spec>,\n &mut EvmEnv<::Spec, CTX::Block>,\n &mut CTX::Tx,\n &mut JournaledState,\n ) -> eyre::Result,\n) -> Result {\n let mut evm_env = ccx.ecx.evm_clone();\n let mut tx_env = ccx.ecx.tx_clone();\n let (db, inner) = ccx.ecx.db_journal_inner_mut();\n let result = f(db, &mut evm_env, &mut tx_env, inner)?;\n ccx.ecx.set_evm(evm_env);\n ccx.ecx.set_tx(tx_env);\n Ok(result.abi_encode())\n}\n\nfn check_broadcast(state: &Cheatcodes) -> Result<()> {\n if state.broadcast.is_none() {\n Ok(())\n } else {\n Err(fmt_err!(\"cannot select forks during a broadcast\"))\n }\n}\n\nfn transact(\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n transaction: B256,\n fork_id: Option,\n) -> Result {\n executor.transact_on_db(ccx.state, ccx.ecx, fork_id, transaction)?;\n Ok(Default::default())\n}\n\n// Helper to add the caller of fork cheat code as persistent account (in order to make sure that the\n// state of caller contract is not lost when fork changes).\n// Applies to create, select and roll forks actions.\n// https://github.com/foundry-rs/foundry/issues/8004\nfn persist_caller>(ccx: &mut CheatsCtxt<'_, CTX>) {\n ccx.ecx.db_mut().add_persistent_account(ccx.caller);\n}\n\n/// Performs an Ethereum JSON-RPC request to the given endpoint.\nfn rpc_call(url: &str, method: &str, params: &str) -> Result {\n let provider = ProviderBuilder::::new(url).build()?;\n let params_json: serde_json::Value = serde_json::from_str(params)?;\n let result =\n foundry_common::block_on(provider.raw_request(method.to_string().into(), params_json))\n .map_err(|err| fmt_err!(\"{method:?}: {err}\"))?;\n let result_as_tokens = convert_to_bytes(\n &json_value_to_token(&result, None)\n .map_err(|err| fmt_err!(\"failed to parse result: {err}\"))?,\n );\n\n Ok(result_as_tokens.abi_encode())\n}\n\n/// Convert fixed bytes and address values to bytes in order to prevent encoding issues.\nfn convert_to_bytes(token: &DynSolValue) -> DynSolValue {\n match token {\n // Convert fixed bytes to prevent encoding issues.\n // See: \n DynSolValue::FixedBytes(bytes, size) => {\n DynSolValue::Bytes(bytes.as_slice()[..*size].to_vec())\n }\n DynSolValue::Address(addr) => DynSolValue::Bytes(addr.to_vec()),\n // Convert tuple values to prevent encoding issues.\n // See: \n DynSolValue::Tuple(vals) => DynSolValue::Tuple(vals.iter().map(convert_to_bytes).collect()),\n val => val.clone(),\n }\n}\n" }, { "path": "crates/cheatcodes/src/evm/mapping.rs", "content": "use crate::{Cheatcode, Cheatcodes, Result, Vm::*};\nuse alloy_primitives::{Address, B256};\nuse alloy_sol_types::SolValue;\nuse foundry_common::mapping_slots::MappingSlots;\n\nimpl Cheatcode for startMappingRecordingCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self {} = self;\n state.mapping_slots.get_or_insert_default();\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for stopMappingRecordingCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self {} = self;\n state.mapping_slots = None;\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for getMappingLengthCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { target, mappingSlot } = self;\n let result = slot_child(state, target, mappingSlot).map(Vec::len).unwrap_or(0);\n Ok((result as u64).abi_encode())\n }\n}\n\nimpl Cheatcode for getMappingSlotAtCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { target, mappingSlot, idx } = self;\n let result = slot_child(state, target, mappingSlot)\n .and_then(|set| set.get(idx.saturating_to::()))\n .copied()\n .unwrap_or_default();\n Ok(result.abi_encode())\n }\n}\n\nimpl Cheatcode for getMappingKeyAndParentOfCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { target, elementSlot: slot } = self;\n let mut found = false;\n let mut key = &B256::ZERO;\n let mut parent = &B256::ZERO;\n if let Some(slots) = mapping_slot(state, target) {\n if let Some(key2) = slots.keys.get(slot) {\n found = true;\n key = key2;\n parent = &slots.parent_slots[slot];\n } else if let Some((key2, parent2)) = slots.seen_sha3.get(slot) {\n found = true;\n key = key2;\n parent = parent2;\n }\n }\n Ok((found, key, parent).abi_encode_params())\n }\n}\n\nfn mapping_slot<'a>(state: &'a Cheatcodes, target: &'a Address) -> Option<&'a MappingSlots> {\n state.mapping_slots.as_ref()?.get(target)\n}\n\nfn slot_child<'a>(\n state: &'a Cheatcodes,\n target: &'a Address,\n slot: &'a B256,\n) -> Option<&'a Vec> {\n mapping_slot(state, target)?.children.get(slot)\n}\n" }, { "path": "crates/cheatcodes/src/evm/mock.rs", "content": "use crate::{Cheatcode, Cheatcodes, CheatsCtxt, Result, Vm::*};\nuse alloy_primitives::{Address, Bytes, U256};\nuse foundry_evm_core::backend::DatabaseExt;\nuse revm::{\n bytecode::Bytecode,\n context::{ContextTr, JournalTr},\n interpreter::InstructionResult,\n};\nuse std::{cmp::Ordering, collections::VecDeque};\n\n/// Mocked call data.\n#[derive(Clone, Debug, Default, PartialEq, Eq, Hash)]\npub struct MockCallDataContext {\n /// The partial calldata to match for mock\n pub calldata: Bytes,\n /// The value to match for mock\n pub value: Option,\n}\n\n/// Mocked return data.\n#[derive(Clone, Debug)]\npub struct MockCallReturnData {\n /// The return type for the mocked call\n pub ret_type: InstructionResult,\n /// Return data or error\n pub data: Bytes,\n}\n\nimpl PartialOrd for MockCallDataContext {\n fn partial_cmp(&self, other: &Self) -> Option {\n Some(self.cmp(other))\n }\n}\n\nimpl Ord for MockCallDataContext {\n fn cmp(&self, other: &Self) -> Ordering {\n // Calldata matching is reversed to ensure that a tighter match is\n // returned if an exact match is not found. In case, there is\n // a partial match to calldata that is more specific than\n // a match to a msg.value, then the more specific calldata takes\n // precedence.\n self.calldata.cmp(&other.calldata).reverse().then(self.value.cmp(&other.value).reverse())\n }\n}\n\nimpl Cheatcode for clearMockedCallsCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self {} = self;\n state.mocked_calls = Default::default();\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for mockCall_0Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { callee, data, returnData } = self;\n let _ = make_acc_non_empty(callee, ccx)?;\n\n mock_call(ccx.state, callee, data, None, returnData, InstructionResult::Return);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for mockCall_1Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { callee, msgValue, data, returnData } = self;\n let _ = make_acc_non_empty(callee, ccx)?;\n\n mock_call(ccx.state, callee, data, Some(msgValue), returnData, InstructionResult::Return);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for mockCall_2Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { callee, data, returnData } = self;\n let _ = make_acc_non_empty(callee, ccx)?;\n\n mock_call(\n ccx.state,\n callee,\n &Bytes::from(*data),\n None,\n returnData,\n InstructionResult::Return,\n );\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for mockCall_3Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { callee, msgValue, data, returnData } = self;\n let _ = make_acc_non_empty(callee, ccx)?;\n\n mock_call(\n ccx.state,\n callee,\n &Bytes::from(*data),\n Some(msgValue),\n returnData,\n InstructionResult::Return,\n );\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for mockCalls_0Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { callee, data, returnData } = self;\n let _ = make_acc_non_empty(callee, ccx)?;\n\n mock_calls(ccx.state, callee, data, None, returnData, InstructionResult::Return);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for mockCalls_1Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { callee, msgValue, data, returnData } = self;\n let _ = make_acc_non_empty(callee, ccx)?;\n\n mock_calls(ccx.state, callee, data, Some(msgValue), returnData, InstructionResult::Return);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for mockCallRevert_0Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { callee, data, revertData } = self;\n let _ = make_acc_non_empty(callee, ccx)?;\n\n mock_call(ccx.state, callee, data, None, revertData, InstructionResult::Revert);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for mockCallRevert_1Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { callee, msgValue, data, revertData } = self;\n let _ = make_acc_non_empty(callee, ccx)?;\n\n mock_call(ccx.state, callee, data, Some(msgValue), revertData, InstructionResult::Revert);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for mockCallRevert_2Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { callee, data, revertData } = self;\n let _ = make_acc_non_empty(callee, ccx)?;\n\n mock_call(\n ccx.state,\n callee,\n &Bytes::from(*data),\n None,\n revertData,\n InstructionResult::Revert,\n );\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for mockCallRevert_3Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { callee, msgValue, data, revertData } = self;\n let _ = make_acc_non_empty(callee, ccx)?;\n\n mock_call(\n ccx.state,\n callee,\n &Bytes::from(*data),\n Some(msgValue),\n revertData,\n InstructionResult::Revert,\n );\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for mockFunctionCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { callee, target, data } = self;\n state.mocked_functions.entry(*callee).or_default().insert(data.clone(), *target);\n\n Ok(Default::default())\n }\n}\n\nfn mock_call(\n state: &mut Cheatcodes,\n callee: &Address,\n cdata: &Bytes,\n value: Option<&U256>,\n rdata: &Bytes,\n ret_type: InstructionResult,\n) {\n mock_calls(state, callee, cdata, value, std::slice::from_ref(rdata), ret_type)\n}\n\nfn mock_calls(\n state: &mut Cheatcodes,\n callee: &Address,\n cdata: &Bytes,\n value: Option<&U256>,\n rdata_vec: &[Bytes],\n ret_type: InstructionResult,\n) {\n state.mocked_calls.entry(*callee).or_default().insert(\n MockCallDataContext { calldata: cdata.clone(), value: value.copied() },\n rdata_vec\n .iter()\n .map(|rdata| MockCallReturnData { ret_type, data: rdata.clone() })\n .collect::>(),\n );\n}\n\n// Etches a single byte onto the account if it is empty to circumvent the `extcodesize`\n// check Solidity might perform.\nfn make_acc_non_empty>(\n callee: &Address,\n ccx: &mut CheatsCtxt<'_, CTX>,\n) -> Result {\n let empty_bytecode = {\n let acc = ccx.ecx.journal_mut().load_account(*callee)?;\n acc.info.code.as_ref().is_none_or(Bytecode::is_empty)\n };\n if empty_bytecode {\n let code = Bytecode::new_raw(Bytes::from_static(&[0u8]));\n ccx.ecx.journal_mut().set_code(*callee, code);\n }\n\n Ok(Default::default())\n}\n" }, { "path": "crates/cheatcodes/src/evm/prank.rs", "content": "use crate::{Cheatcode, CheatsCtxt, Result, Vm::*, evm::journaled_account};\nuse alloy_primitives::Address;\nuse foundry_evm_core::backend::DatabaseExt;\nuse revm::{\n context::{ContextTr, JournalTr, Transaction},\n inspector::JournalExt,\n};\n\n/// Prank information.\n#[derive(Clone, Copy, Debug, Default)]\npub struct Prank {\n /// Address of the contract that initiated the prank\n pub prank_caller: Address,\n /// Address of `tx.origin` when the prank was initiated\n pub prank_origin: Address,\n /// The address to assign to `msg.sender`\n pub new_caller: Address,\n /// The address to assign to `tx.origin`\n pub new_origin: Option
,\n /// The depth at which the prank was called\n pub depth: usize,\n /// Whether the prank stops by itself after the next call\n pub single_call: bool,\n /// Whether the prank should be applied to delegate call\n pub delegate_call: bool,\n /// Whether the prank has been used yet (false if unused)\n pub used: bool,\n}\n\nimpl Prank {\n /// Create a new prank.\n pub fn new(\n prank_caller: Address,\n prank_origin: Address,\n new_caller: Address,\n new_origin: Option
,\n depth: usize,\n single_call: bool,\n delegate_call: bool,\n ) -> Self {\n Self {\n prank_caller,\n prank_origin,\n new_caller,\n new_origin,\n depth,\n single_call,\n delegate_call,\n used: false,\n }\n }\n\n /// Apply the prank by setting `used` to true if it is false\n /// Only returns self in the case it is updated (first application)\n pub fn first_time_applied(&self) -> Option {\n if self.used { None } else { Some(Self { used: true, ..*self }) }\n }\n}\n\nimpl Cheatcode for prank_0Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { msgSender } = self;\n prank(ccx, msgSender, None, true, false)\n }\n}\n\nimpl Cheatcode for startPrank_0Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { msgSender } = self;\n prank(ccx, msgSender, None, false, false)\n }\n}\n\nimpl Cheatcode for prank_1Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { msgSender, txOrigin } = self;\n prank(ccx, msgSender, Some(txOrigin), true, false)\n }\n}\n\nimpl Cheatcode for startPrank_1Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { msgSender, txOrigin } = self;\n prank(ccx, msgSender, Some(txOrigin), false, false)\n }\n}\n\nimpl Cheatcode for prank_2Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { msgSender, delegateCall } = self;\n prank(ccx, msgSender, None, true, *delegateCall)\n }\n}\n\nimpl Cheatcode for startPrank_2Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { msgSender, delegateCall } = self;\n prank(ccx, msgSender, None, false, *delegateCall)\n }\n}\n\nimpl Cheatcode for prank_3Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { msgSender, txOrigin, delegateCall } = self;\n prank(ccx, msgSender, Some(txOrigin), true, *delegateCall)\n }\n}\n\nimpl Cheatcode for startPrank_3Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { msgSender, txOrigin, delegateCall } = self;\n prank(ccx, msgSender, Some(txOrigin), false, *delegateCall)\n }\n}\n\nimpl Cheatcode for stopPrankCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self {} = self;\n ccx.state.pranks.remove(&ccx.ecx.journal().depth());\n Ok(Default::default())\n }\n}\n\nfn prank>(\n ccx: &mut CheatsCtxt<'_, CTX>,\n new_caller: &Address,\n new_origin: Option<&Address>,\n single_call: bool,\n delegate_call: bool,\n) -> Result {\n // Ensure that we load the account of the pranked address and mark it as touched.\n // This is necessary to ensure that account state changes (such as the account's `nonce`) are\n // properly tracked.\n let account = journaled_account(ccx.ecx, *new_caller)?;\n\n // Ensure that code exists at `msg.sender` if delegate calling.\n if delegate_call {\n ensure!(\n account.info.code.as_ref().is_some_and(|code| !code.is_empty()),\n \"cannot `prank` delegate call from an EOA\"\n );\n }\n\n let depth = ccx.ecx.journal().depth();\n if let Some(Prank { used, single_call: current_single_call, .. }) = ccx.state.get_prank(depth) {\n ensure!(used, \"cannot overwrite a prank until it is applied at least once\");\n // This case can only fail if the user calls `vm.startPrank` and then `vm.prank` later on.\n // This should not be possible without first calling `stopPrank`\n ensure!(\n single_call == *current_single_call,\n \"cannot override an ongoing prank with a single vm.prank; \\\n use vm.startPrank to override the current prank\"\n );\n }\n\n let prank = Prank::new(\n ccx.caller,\n ccx.ecx.tx().caller(),\n *new_caller,\n new_origin.copied(),\n depth,\n single_call,\n delegate_call,\n );\n\n ensure!(\n ccx.state.broadcast.is_none(),\n \"cannot `prank` for a broadcasted transaction; \\\n pass the desired `tx.origin` into the `broadcast` cheatcode call\"\n );\n\n ccx.state.pranks.insert(prank.depth, prank);\n Ok(Default::default())\n}\n" }, { "path": "crates/cheatcodes/src/evm/record_debug_step.rs", "content": "use alloy_primitives::{Bytes, U256};\n\nuse foundry_evm_traces::CallTraceArena;\nuse revm::{bytecode::opcode::OpCode, interpreter::InstructionResult};\n\nuse foundry_evm_core::buffer::{BufferKind, get_buffer_accesses};\nuse revm_inspectors::tracing::types::{\n CallTraceNode, CallTraceStep, RecordedMemory, TraceMemberOrder,\n};\nuse spec::Vm::DebugStep;\n\n// Context for a CallTraceStep, includes depth and contract address.\npub(crate) struct CallTraceCtx<'a> {\n pub node: &'a CallTraceNode,\n pub step: &'a CallTraceStep,\n}\n\n// Do a depth first traverse of the nodes and steps and return steps\n// that are after `node_start_idx`\npub(crate) fn flatten_call_trace<'a>(\n root: usize,\n arena: &'a CallTraceArena,\n node_start_idx: usize,\n) -> Vec> {\n let mut steps = Vec::new();\n let mut record_started = false;\n\n // Start the recursion from the root node\n recursive_flatten_call_trace(root, arena, node_start_idx, &mut record_started, &mut steps);\n steps\n}\n\n// Inner recursive function to process nodes.\n// This implementation directly mutates `record_started` and `flatten_steps`.\n// So the recursive call can change the `record_started` flag even for the parent\n// unfinished processing, and append steps to the `flatten_steps` as the final result.\nfn recursive_flatten_call_trace<'a>(\n node_idx: usize,\n arena: &'a CallTraceArena,\n node_start_idx: usize,\n record_started: &mut bool,\n flatten_steps: &mut Vec>,\n) {\n // Once node_idx exceeds node_start_idx, start recording steps\n // for all the recursive processing.\n if !*record_started && node_idx >= node_start_idx {\n *record_started = true;\n }\n\n let node = &arena.nodes()[node_idx];\n\n for order in &node.ordering {\n match order {\n TraceMemberOrder::Step(step_idx) if *record_started => {\n let step = &node.trace.steps[*step_idx];\n flatten_steps.push(CallTraceCtx { node, step });\n }\n TraceMemberOrder::Call(call_idx) => {\n let child_node_idx = node.children[*call_idx];\n recursive_flatten_call_trace(\n child_node_idx,\n arena,\n node_start_idx,\n record_started,\n flatten_steps,\n );\n }\n _ => {}\n }\n }\n}\n\n// Function to convert CallTraceStep to DebugStep\npub(crate) fn convert_call_trace_ctx_to_debug_step(ctx: &CallTraceCtx) -> DebugStep {\n let opcode = ctx.step.op.get();\n let stack = get_stack_inputs_for_opcode(opcode, ctx.step.stack.as_deref());\n\n let memory =\n get_memory_input_for_opcode(opcode, ctx.step.stack.as_deref(), ctx.step.memory.as_ref());\n\n let is_out_of_gas = matches!(\n ctx.step.status,\n Some(\n InstructionResult::OutOfGas\n | InstructionResult::MemoryOOG\n | InstructionResult::MemoryLimitOOG\n | InstructionResult::PrecompileOOG\n | InstructionResult::InvalidOperandOOG\n )\n );\n\n let depth = ctx.node.trace.depth as u64 + 1;\n let contract_addr = ctx.node.execution_address();\n\n DebugStep {\n stack,\n memoryInput: memory,\n opcode: ctx.step.op.get(),\n depth,\n isOutOfGas: is_out_of_gas,\n contractAddr: contract_addr,\n }\n}\n\n// The expected `stack` here is from the trace stack, where the top of the stack\n// is the last value of the vector\nfn get_memory_input_for_opcode(\n opcode: u8,\n stack: Option<&[U256]>,\n memory: Option<&RecordedMemory>,\n) -> Bytes {\n let mut memory_input = Bytes::new();\n let Some(stack_data) = stack else { return memory_input };\n let Some(memory_data) = memory else { return memory_input };\n\n if let Some(accesses) = get_buffer_accesses(opcode, stack_data)\n && let Some((BufferKind::Memory, access)) = accesses.read\n {\n memory_input = get_slice_from_memory(memory_data.as_bytes(), access.offset, access.len);\n };\n\n memory_input\n}\n\n// The expected `stack` here is from the trace stack, where the top of the stack\n// is the last value of the vector\nfn get_stack_inputs_for_opcode(opcode: u8, stack: Option<&[U256]>) -> Vec {\n let mut inputs = Vec::new();\n\n let Some(op) = OpCode::new(opcode) else { return inputs };\n let Some(stack_data) = stack else { return inputs };\n\n let stack_input_size = op.inputs() as usize;\n for i in 0..stack_input_size {\n inputs.push(stack_data[stack_data.len() - 1 - i]);\n }\n inputs\n}\n\nfn get_slice_from_memory(memory: &Bytes, start_index: usize, size: usize) -> Bytes {\n let memory_len = memory.len();\n\n let end_bound = start_index + size;\n\n // Return the bytes if data is within the range.\n if start_index < memory_len && end_bound <= memory_len {\n return memory.slice(start_index..end_bound);\n }\n\n // Pad zero bytes if attempting to load memory partially out of range.\n if start_index < memory_len && end_bound > memory_len {\n let mut result = memory.slice(start_index..memory_len).to_vec();\n result.resize(size, 0u8);\n return Bytes::from(result);\n }\n\n // Return empty bytes with the size if not in range at all.\n Bytes::from(vec![0u8; size])\n}\n" }, { "path": "crates/cheatcodes/src/evm.rs", "content": "//! Implementations of [`Evm`](spec::Group::Evm) cheatcodes.\n\nuse crate::{\n BroadcastableTransaction, Cheatcode, Cheatcodes, CheatcodesExecutor, CheatsCtxt, Error,\n EthCheatCtx, Result,\n Vm::*,\n inspector::{BroadcastKind, RecordDebugStepInfo},\n};\nuse alloy_consensus::{\n Transaction as TransactionTrait, TxEnvelope, transaction::SignerRecoverable,\n};\nuse alloy_evm::{EvmEnv, FromRecoveredTx};\nuse alloy_genesis::{Genesis, GenesisAccount};\nuse alloy_network::eip2718::EIP4844_TX_TYPE_ID;\nuse alloy_primitives::{\n Address, B256, Bytes, U256, hex, keccak256,\n map::{B256Map, HashMap},\n};\nuse alloy_rlp::Decodable;\nuse alloy_sol_types::SolValue;\nuse foundry_common::{\n fs::{read_json_file, write_json_file},\n slot_identifier::{\n ENCODING_BYTES, ENCODING_DYN_ARRAY, ENCODING_INPLACE, ENCODING_MAPPING, SlotIdentifier,\n SlotInfo,\n },\n};\nuse foundry_compilers::artifacts::EvmVersion;\nuse foundry_evm_core::{\n FoundryBlock, FoundryTransaction,\n backend::{DatabaseExt, RevertStateSnapshotAction},\n constants::{CALLER, CHEATCODE_ADDRESS, HARDHAT_CONSOLE_ADDRESS, TEST_CONTRACT_ADDRESS},\n env::FoundryContextExt,\n utils::get_blob_base_fee_update_fraction_by_spec_id,\n};\nuse foundry_evm_traces::TraceMode;\nuse foundry_primitives::FoundryTxEnvelope;\nuse itertools::Itertools;\nuse rand::Rng;\nuse revm::{\n bytecode::Bytecode,\n context::{Block, Cfg, ContextTr, JournalTr, Transaction, TxEnv, result::ExecutionResult},\n inspector::JournalExt,\n primitives::{KECCAK_EMPTY, hardfork::SpecId},\n state::{Account, AccountStatus},\n};\nuse std::{\n collections::{BTreeMap, HashSet, btree_map::Entry},\n fmt::Display,\n path::Path,\n str::FromStr,\n};\n\nmod record_debug_step;\nuse foundry_common::fmt::format_token_raw;\nuse foundry_config::evm_spec_id;\nuse record_debug_step::{convert_call_trace_ctx_to_debug_step, flatten_call_trace};\nuse serde::Serialize;\n\nmod fork;\npub(crate) mod mapping;\npub(crate) mod mock;\npub(crate) mod prank;\n\n/// JSON-serializable log entry for `getRecordedLogsJson`.\n#[derive(Serialize)]\n#[serde(rename_all = \"camelCase\")]\nstruct LogJson {\n /// The topics of the log, including the signature, if any.\n topics: Vec,\n /// The raw data of the log, hex-encoded with 0x prefix.\n data: String,\n /// The address of the log's emitter.\n emitter: String,\n}\n\n/// Records storage slots reads and writes.\n#[derive(Clone, Debug, Default)]\npub struct RecordAccess {\n /// Storage slots reads.\n pub reads: HashMap>,\n /// Storage slots writes.\n pub writes: HashMap>,\n}\n\nimpl RecordAccess {\n /// Records a read access to a storage slot.\n pub fn record_read(&mut self, target: Address, slot: U256) {\n self.reads.entry(target).or_default().push(slot);\n }\n\n /// Records a write access to a storage slot.\n ///\n /// This also records a read internally as `SSTORE` does an implicit `SLOAD`.\n pub fn record_write(&mut self, target: Address, slot: U256) {\n self.record_read(target, slot);\n self.writes.entry(target).or_default().push(slot);\n }\n\n /// Clears the recorded reads and writes.\n pub fn clear(&mut self) {\n // Also frees memory.\n *self = Default::default();\n }\n}\n\n/// Records the `snapshotGas*` cheatcodes.\n#[derive(Clone, Debug)]\npub struct GasRecord {\n /// The group name of the gas snapshot.\n pub group: String,\n /// The name of the gas snapshot.\n pub name: String,\n /// The total gas used in the gas snapshot.\n pub gas_used: u64,\n /// Depth at which the gas snapshot was taken.\n pub depth: usize,\n}\n\n/// Records `deal` cheatcodes\n#[derive(Clone, Debug)]\npub struct DealRecord {\n /// Target of the deal.\n pub address: Address,\n /// The balance of the address before deal was applied\n pub old_balance: U256,\n /// Balance after deal was applied\n pub new_balance: U256,\n}\n\n/// Storage slot diff info.\n#[derive(Serialize, Default)]\n#[serde(rename_all = \"camelCase\")]\nstruct SlotStateDiff {\n /// Initial storage value.\n previous_value: B256,\n /// Current storage value.\n new_value: B256,\n /// Storage layout metadata (variable name, type, offset).\n /// Only present when contract has storage layout output.\n /// This includes decoded values when available.\n #[serde(skip_serializing_if = \"Option::is_none\", flatten)]\n slot_info: Option,\n}\n\n/// Balance diff info.\n#[derive(Serialize, Default)]\n#[serde(rename_all = \"camelCase\")]\nstruct BalanceDiff {\n /// Initial storage value.\n previous_value: U256,\n /// Current storage value.\n new_value: U256,\n}\n\n/// Nonce diff info.\n#[derive(Serialize, Default)]\n#[serde(rename_all = \"camelCase\")]\nstruct NonceDiff {\n /// Initial nonce value.\n previous_value: u64,\n /// Current nonce value.\n new_value: u64,\n}\n\n/// Account state diff info.\n#[derive(Serialize, Default)]\n#[serde(rename_all = \"camelCase\")]\nstruct AccountStateDiffs {\n /// Address label, if any set.\n label: Option,\n /// Contract identifier from artifact. e.g \"src/Counter.sol:Counter\"\n contract: Option,\n /// Account balance changes.\n balance_diff: Option,\n /// Account nonce changes.\n nonce_diff: Option,\n /// State changes, per slot.\n state_diff: BTreeMap,\n}\n\nimpl Display for AccountStateDiffs {\n fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> eyre::Result<(), std::fmt::Error> {\n // Print changed account.\n if let Some(label) = &self.label {\n writeln!(f, \"label: {label}\")?;\n }\n if let Some(contract) = &self.contract {\n writeln!(f, \"contract: {contract}\")?;\n }\n // Print balance diff if changed.\n if let Some(balance_diff) = &self.balance_diff\n && balance_diff.previous_value != balance_diff.new_value\n {\n writeln!(\n f,\n \"- balance diff: {} ā†’ {}\",\n balance_diff.previous_value, balance_diff.new_value\n )?;\n }\n // Print nonce diff if changed.\n if let Some(nonce_diff) = &self.nonce_diff\n && nonce_diff.previous_value != nonce_diff.new_value\n {\n writeln!(f, \"- nonce diff: {} ā†’ {}\", nonce_diff.previous_value, nonce_diff.new_value)?;\n }\n // Print state diff if any.\n if !&self.state_diff.is_empty() {\n writeln!(f, \"- state diff:\")?;\n for (slot, slot_changes) in &self.state_diff {\n match &slot_changes.slot_info {\n Some(slot_info) => {\n if let Some(decoded) = &slot_info.decoded {\n // Have slot info with decoded values - show decoded values\n writeln!(\n f,\n \"@ {slot} ({}, {}): {} ā†’ {}\",\n slot_info.label,\n slot_info.slot_type.dyn_sol_type,\n format_token_raw(&decoded.previous_value),\n format_token_raw(&decoded.new_value)\n )?;\n } else {\n // Have slot info but no decoded values - show raw hex values\n writeln!(\n f,\n \"@ {slot} ({}, {}): {} ā†’ {}\",\n slot_info.label,\n slot_info.slot_type.dyn_sol_type,\n slot_changes.previous_value,\n slot_changes.new_value\n )?;\n }\n }\n None => {\n // No slot info - show raw hex values\n writeln!(\n f,\n \"@ {slot}: {} ā†’ {}\",\n slot_changes.previous_value, slot_changes.new_value\n )?;\n }\n }\n }\n }\n\n Ok(())\n }\n}\n\nimpl Cheatcode for addrCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { privateKey } = self;\n let wallet = super::crypto::parse_wallet(privateKey)?;\n Ok(wallet.address().abi_encode())\n }\n}\n\nimpl Cheatcode for getNonce_0Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { account } = self;\n get_nonce(ccx, account)\n }\n}\n\nimpl Cheatcode for getNonce_1Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { wallet } = self;\n get_nonce(ccx, &wallet.addr)\n }\n}\n\nimpl Cheatcode for loadCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { target, slot } = *self;\n ccx.ensure_not_precompile(&target)?;\n\n ccx.ecx.journal_mut().load_account(target)?;\n let mut val = ccx\n .ecx\n .journal_mut()\n .sload(target, slot.into())\n .map_err(|e| fmt_err!(\"failed to load storage slot: {:?}\", e))?;\n\n if val.is_cold && val.data.is_zero() {\n if ccx.state.has_arbitrary_storage(&target) {\n // If storage slot is untouched and load from a target with arbitrary storage,\n // then set random value for current slot.\n let rand_value = ccx.state.rng().random();\n ccx.state.arbitrary_storage.as_mut().unwrap().save(\n ccx.ecx,\n target,\n slot.into(),\n rand_value,\n );\n val.data = rand_value;\n } else if ccx.state.is_arbitrary_storage_copy(&target) {\n // If storage slot is untouched and load from a target that copies storage from\n // a source address with arbitrary storage, then copy existing arbitrary value.\n // If no arbitrary value generated yet, then the random one is saved and set.\n let rand_value = ccx.state.rng().random();\n val.data = ccx.state.arbitrary_storage.as_mut().unwrap().copy(\n ccx.ecx,\n target,\n slot.into(),\n rand_value,\n );\n }\n }\n\n Ok(val.abi_encode())\n }\n}\n\nimpl Cheatcode for loadAllocsCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { pathToAllocsJson } = self;\n\n let path = Path::new(pathToAllocsJson);\n ensure!(path.exists(), \"allocs file does not exist: {pathToAllocsJson}\");\n\n // Let's first assume we're reading a file with only the allocs.\n let allocs: BTreeMap = match read_json_file(path) {\n Ok(allocs) => allocs,\n Err(_) => {\n // Let's try and read from a genesis file, and extract allocs.\n let genesis = read_json_file::(path)?;\n genesis.alloc\n }\n };\n\n // Then, load the allocs into the database.\n let (db, inner) = ccx.ecx.db_journal_inner_mut();\n db.load_allocs(&allocs, inner)\n .map(|()| Vec::default())\n .map_err(|e| fmt_err!(\"failed to load allocs: {e}\"))\n }\n}\n\nimpl Cheatcode for cloneAccountCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { source, target } = self;\n\n let account = ccx.ecx.journal_mut().load_account(*source)?;\n let genesis = genesis_account(account.data);\n let (db, inner) = ccx.ecx.db_journal_inner_mut();\n db.clone_account(&genesis, target, inner)?;\n // Cloned account should persist in forked envs.\n ccx.ecx.db_mut().add_persistent_account(*target);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for dumpStateCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { pathToStateJson } = self;\n let path = Path::new(pathToStateJson);\n\n // Do not include system account or empty accounts in the dump.\n let skip = |key: &Address, val: &Account| {\n key == &CHEATCODE_ADDRESS\n || key == &CALLER\n || key == &HARDHAT_CONSOLE_ADDRESS\n || key == &TEST_CONTRACT_ADDRESS\n || key == &ccx.caller\n || key == &ccx.state.config.evm_opts.sender\n || val.is_empty()\n };\n\n let alloc = ccx\n .ecx\n .journal_mut()\n .evm_state_mut()\n .iter_mut()\n .filter(|(key, val)| !skip(key, val))\n .map(|(key, val)| (key, genesis_account(val)))\n .collect::>();\n\n write_json_file(path, &alloc)?;\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for recordCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self {} = self;\n state.recording_accesses = true;\n state.accesses.clear();\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for stopRecordCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n state.recording_accesses = false;\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for accessesCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { target } = *self;\n let result = (\n state.accesses.reads.entry(target).or_default().as_slice(),\n state.accesses.writes.entry(target).or_default().as_slice(),\n );\n Ok(result.abi_encode_params())\n }\n}\n\nimpl Cheatcode for recordLogsCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self {} = self;\n state.recorded_logs = Some(Default::default());\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for getRecordedLogsCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self {} = self;\n Ok(state.recorded_logs.replace(Default::default()).unwrap_or_default().abi_encode())\n }\n}\n\nimpl Cheatcode for getRecordedLogsJsonCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self {} = self;\n let logs = state.recorded_logs.replace(Default::default()).unwrap_or_default();\n let json_logs: Vec<_> = logs\n .into_iter()\n .map(|log| LogJson {\n topics: log.topics.iter().map(|t| format!(\"{t}\")).collect(),\n data: hex::encode_prefixed(&log.data),\n emitter: format!(\"{}\", log.emitter),\n })\n .collect();\n Ok(serde_json::to_string(&json_logs)?.abi_encode())\n }\n}\n\nimpl Cheatcode for pauseGasMeteringCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self {} = self;\n state.gas_metering.paused = true;\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for resumeGasMeteringCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self {} = self;\n state.gas_metering.resume();\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for resetGasMeteringCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self {} = self;\n state.gas_metering.reset();\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for lastCallGasCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self {} = self;\n let Some(last_call_gas) = &state.gas_metering.last_call_gas else {\n bail!(\"no external call was made yet\");\n };\n Ok(last_call_gas.abi_encode())\n }\n}\n\nimpl Cheatcode for getChainIdCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self {} = self;\n Ok(U256::from(ccx.ecx.cfg().chain_id()).abi_encode())\n }\n}\n\nimpl Cheatcode for chainIdCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { newChainId } = self;\n ensure!(*newChainId <= U256::from(u64::MAX), \"chain ID must be less than 2^64\");\n ccx.ecx.cfg_mut().chain_id = newChainId.to();\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for coinbaseCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { newCoinbase } = self;\n ccx.ecx.block_mut().set_beneficiary(*newCoinbase);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for difficultyCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { newDifficulty } = self;\n ensure!(\n ccx.ecx.cfg().spec().into() < SpecId::MERGE,\n \"`difficulty` is not supported after the Paris hard fork, use `prevrandao` instead; \\\n see EIP-4399: https://eips.ethereum.org/EIPS/eip-4399\"\n );\n ccx.ecx.block_mut().set_difficulty(*newDifficulty);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for feeCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { newBasefee } = self;\n ensure!(*newBasefee <= U256::from(u64::MAX), \"base fee must be less than 2^64\");\n ccx.ecx.block_mut().set_basefee(newBasefee.saturating_to());\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for prevrandao_0Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { newPrevrandao } = self;\n ensure!(\n ccx.ecx.cfg().spec().into() >= SpecId::MERGE,\n \"`prevrandao` is not supported before the Paris hard fork, use `difficulty` instead; \\\n see EIP-4399: https://eips.ethereum.org/EIPS/eip-4399\"\n );\n ccx.ecx.block_mut().set_prevrandao(Some(*newPrevrandao));\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for prevrandao_1Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { newPrevrandao } = self;\n ensure!(\n ccx.ecx.cfg().spec().into() >= SpecId::MERGE,\n \"`prevrandao` is not supported before the Paris hard fork, use `difficulty` instead; \\\n see EIP-4399: https://eips.ethereum.org/EIPS/eip-4399\"\n );\n ccx.ecx.block_mut().set_prevrandao(Some((*newPrevrandao).into()));\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for blobhashesCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { hashes } = self;\n ensure!(\n ccx.ecx.cfg().spec().into() >= SpecId::CANCUN,\n \"`blobhashes` is not supported before the Cancun hard fork; \\\n see EIP-4844: https://eips.ethereum.org/EIPS/eip-4844\"\n );\n ccx.ecx.tx_mut().set_blob_hashes(hashes.clone());\n // force this as 4844 txtype\n ccx.ecx.tx_mut().set_tx_type(EIP4844_TX_TYPE_ID);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for getBlobhashesCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self {} = self;\n ensure!(\n ccx.ecx.cfg().spec().into() >= SpecId::CANCUN,\n \"`getBlobhashes` is not supported before the Cancun hard fork; \\\n see EIP-4844: https://eips.ethereum.org/EIPS/eip-4844\"\n );\n Ok(ccx.ecx.tx().blob_versioned_hashes().to_vec().abi_encode())\n }\n}\n\nimpl Cheatcode for rollCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { newHeight } = self;\n ccx.ecx.block_mut().set_number(*newHeight);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for getBlockNumberCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self {} = self;\n Ok(ccx.ecx.block().number().abi_encode())\n }\n}\n\nimpl Cheatcode for txGasPriceCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { newGasPrice } = self;\n ensure!(*newGasPrice <= U256::from(u64::MAX), \"gas price must be less than 2^64\");\n ccx.ecx.tx_mut().set_gas_price(newGasPrice.saturating_to());\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for warpCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { newTimestamp } = self;\n ccx.ecx.block_mut().set_timestamp(*newTimestamp);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for getBlockTimestampCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self {} = self;\n Ok(ccx.ecx.block().timestamp().abi_encode())\n }\n}\n\nimpl Cheatcode for blobBaseFeeCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { newBlobBaseFee } = self;\n ensure!(\n ccx.ecx.cfg().spec().into() >= SpecId::CANCUN,\n \"`blobBaseFee` is not supported before the Cancun hard fork; \\\n see EIP-4844: https://eips.ethereum.org/EIPS/eip-4844\"\n );\n\n let spec: SpecId = ccx.ecx.cfg().spec().into();\n ccx.ecx.block_mut().set_blob_excess_gas_and_price(\n (*newBlobBaseFee).to(),\n get_blob_base_fee_update_fraction_by_spec_id(spec),\n );\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for getBlobBaseFeeCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self {} = self;\n Ok(ccx.ecx.block().blob_excess_gas().unwrap_or(0).abi_encode())\n }\n}\n\nimpl Cheatcode for dealCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { account: address, newBalance: new_balance } = *self;\n let account = journaled_account(ccx.ecx, address)?;\n let old_balance = std::mem::replace(&mut account.info.balance, new_balance);\n let record = DealRecord { address, old_balance, new_balance };\n ccx.state.eth_deals.push(record);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for etchCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { target, newRuntimeBytecode } = self;\n ccx.ensure_not_precompile(target)?;\n ccx.ecx.journal_mut().load_account(*target)?;\n let bytecode = Bytecode::new_raw_checked(newRuntimeBytecode.clone())\n .map_err(|e| fmt_err!(\"failed to create bytecode: {e}\"))?;\n ccx.ecx.journal_mut().set_code(*target, bytecode);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for resetNonceCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { account } = self;\n let account = journaled_account(ccx.ecx, *account)?;\n // Per EIP-161, EOA nonces start at 0, but contract nonces\n // start at 1. Comparing by code_hash instead of code\n // to avoid hitting the case where account's code is None.\n let empty = account.info.code_hash == KECCAK_EMPTY;\n let nonce = if empty { 0 } else { 1 };\n account.info.nonce = nonce;\n debug!(target: \"cheatcodes\", nonce, \"reset\");\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for setNonceCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { account, newNonce } = *self;\n let account = journaled_account(ccx.ecx, account)?;\n // nonce must increment only\n let current = account.info.nonce;\n ensure!(\n newNonce >= current,\n \"new nonce ({newNonce}) must be strictly equal to or higher than the \\\n account's current nonce ({current})\"\n );\n account.info.nonce = newNonce;\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for setNonceUnsafeCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { account, newNonce } = *self;\n let account = journaled_account(ccx.ecx, account)?;\n account.info.nonce = newNonce;\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for storeCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { target, slot, value } = *self;\n ccx.ensure_not_precompile(&target)?;\n ensure_loaded_account(ccx.ecx, target)?;\n ccx.ecx\n .journal_mut()\n .sstore(target, slot.into(), value.into())\n .map_err(|e| fmt_err!(\"failed to store storage slot: {:?}\", e))?;\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for coolCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { target } = self;\n if let Some(account) = ccx.ecx.journal_mut().evm_state_mut().get_mut(target) {\n account.unmark_touch();\n account.storage.values_mut().for_each(|slot| slot.mark_cold());\n }\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for accessListCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { access } = self;\n let access_list = access\n .iter()\n .map(|item| {\n let keys = item.storageKeys.iter().map(|key| B256::from(*key)).collect_vec();\n alloy_rpc_types::AccessListItem { address: item.target, storage_keys: keys }\n })\n .collect_vec();\n state.access_list = Some(alloy_rpc_types::AccessList::from(access_list));\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for noAccessListCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self {} = self;\n // Set to empty option in order to override previous applied access list.\n if state.access_list.is_some() {\n state.access_list = Some(alloy_rpc_types::AccessList::default());\n }\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for warmSlotCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { target, slot } = *self;\n set_cold_slot(ccx, target, slot.into(), false);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for coolSlotCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { target, slot } = *self;\n set_cold_slot(ccx, target, slot.into(), true);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for readCallersCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self {} = self;\n read_callers(ccx.state, &ccx.ecx.tx().caller(), ccx.ecx.journal().depth())\n }\n}\n\nimpl Cheatcode for snapshotValue_0Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { name, value } = self;\n inner_value_snapshot(ccx, None, Some(name.clone()), value.to_string())\n }\n}\n\nimpl Cheatcode for snapshotValue_1Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { group, name, value } = self;\n inner_value_snapshot(ccx, Some(group.clone()), Some(name.clone()), value.to_string())\n }\n}\n\nimpl Cheatcode for snapshotGasLastCall_0Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { name } = self;\n let Some(last_call_gas) = &ccx.state.gas_metering.last_call_gas else {\n bail!(\"no external call was made yet\");\n };\n inner_last_gas_snapshot(ccx, None, Some(name.clone()), last_call_gas.gasTotalUsed)\n }\n}\n\nimpl Cheatcode for snapshotGasLastCall_1Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { name, group } = self;\n let Some(last_call_gas) = &ccx.state.gas_metering.last_call_gas else {\n bail!(\"no external call was made yet\");\n };\n inner_last_gas_snapshot(\n ccx,\n Some(group.clone()),\n Some(name.clone()),\n last_call_gas.gasTotalUsed,\n )\n }\n}\n\nimpl Cheatcode for startSnapshotGas_0Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { name } = self;\n inner_start_gas_snapshot(ccx, None, Some(name.clone()))\n }\n}\n\nimpl Cheatcode for startSnapshotGas_1Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { group, name } = self;\n inner_start_gas_snapshot(ccx, Some(group.clone()), Some(name.clone()))\n }\n}\n\nimpl Cheatcode for stopSnapshotGas_0Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self {} = self;\n inner_stop_gas_snapshot(ccx, None, None)\n }\n}\n\nimpl Cheatcode for stopSnapshotGas_1Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { name } = self;\n inner_stop_gas_snapshot(ccx, None, Some(name.clone()))\n }\n}\n\nimpl Cheatcode for stopSnapshotGas_2Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { group, name } = self;\n inner_stop_gas_snapshot(ccx, Some(group.clone()), Some(name.clone()))\n }\n}\n\n// Deprecated in favor of `snapshotStateCall`\nimpl Cheatcode for snapshotCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self {} = self;\n inner_snapshot_state(ccx)\n }\n}\n\nimpl Cheatcode for snapshotStateCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self {} = self;\n inner_snapshot_state(ccx)\n }\n}\n\n// Deprecated in favor of `revertToStateCall`\nimpl Cheatcode for revertToCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { snapshotId } = self;\n inner_revert_to_state(ccx, *snapshotId)\n }\n}\n\nimpl Cheatcode for revertToStateCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { snapshotId } = self;\n inner_revert_to_state(ccx, *snapshotId)\n }\n}\n\n// Deprecated in favor of `revertToStateAndDeleteCall`\nimpl Cheatcode for revertToAndDeleteCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { snapshotId } = self;\n inner_revert_to_state_and_delete(ccx, *snapshotId)\n }\n}\n\nimpl Cheatcode for revertToStateAndDeleteCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { snapshotId } = self;\n inner_revert_to_state_and_delete(ccx, *snapshotId)\n }\n}\n\n// Deprecated in favor of `deleteStateSnapshotCall`\nimpl Cheatcode for deleteSnapshotCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { snapshotId } = self;\n inner_delete_state_snapshot(ccx, *snapshotId)\n }\n}\n\nimpl Cheatcode for deleteStateSnapshotCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { snapshotId } = self;\n inner_delete_state_snapshot(ccx, *snapshotId)\n }\n}\n\n// Deprecated in favor of `deleteStateSnapshotsCall`\nimpl Cheatcode for deleteSnapshotsCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self {} = self;\n inner_delete_state_snapshots(ccx)\n }\n}\n\nimpl Cheatcode for deleteStateSnapshotsCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self {} = self;\n inner_delete_state_snapshots(ccx)\n }\n}\n\nimpl Cheatcode for startStateDiffRecordingCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self {} = self;\n state.recorded_account_diffs_stack = Some(Default::default());\n // Enable mapping recording to track mapping slot accesses\n state.mapping_slots.get_or_insert_default();\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for stopAndReturnStateDiffCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self {} = self;\n get_state_diff(state)\n }\n}\n\nimpl Cheatcode for getStateDiffCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let mut diffs = String::new();\n let state_diffs = get_recorded_state_diffs(ccx);\n for (address, state_diffs) in state_diffs {\n diffs.push_str(&format!(\"{address}\\n\"));\n diffs.push_str(&format!(\"{state_diffs}\\n\"));\n }\n Ok(diffs.abi_encode())\n }\n}\n\nimpl Cheatcode for getStateDiffJsonCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let state_diffs = get_recorded_state_diffs(ccx);\n Ok(serde_json::to_string(&state_diffs)?.abi_encode())\n }\n}\n\nimpl Cheatcode for getStorageSlotsCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { target, variableName } = self;\n\n let storage_layout = get_contract_data(ccx, *target)\n .and_then(|(_, data)| data.storage_layout.as_ref().map(|layout| layout.clone()))\n .ok_or_else(|| fmt_err!(\"Storage layout not available for contract at {target}. Try compiling contracts with `--extra-output storageLayout`\"))?;\n\n trace!(storage = ?storage_layout.storage, \"fetched storage\");\n\n let variable_name_lower = variableName.to_lowercase();\n let storage = storage_layout\n .storage\n .iter()\n .find(|s| s.label.to_lowercase() == variable_name_lower)\n .ok_or_else(|| fmt_err!(\"variable '{variableName}' not found in storage layout\"))?;\n\n let storage_type = storage_layout\n .types\n .get(&storage.storage_type)\n .ok_or_else(|| fmt_err!(\"storage type not found for variable {variableName}\"))?;\n\n if storage_type.encoding == ENCODING_MAPPING || storage_type.encoding == ENCODING_DYN_ARRAY\n {\n return Err(fmt_err!(\n \"cannot get storage slots for variables with mapping or dynamic array types\"\n ));\n }\n\n let slot = U256::from_str(&storage.slot).map_err(|_| {\n fmt_err!(\"invalid slot {} format for variable {variableName}\", storage.slot)\n })?;\n\n let mut slots = Vec::new();\n\n // Always push the base slot\n slots.push(slot);\n\n if storage_type.encoding == ENCODING_INPLACE {\n // For inplace encoding, calculate the number of slots needed\n let num_bytes = U256::from_str(&storage_type.number_of_bytes).map_err(|_| {\n fmt_err!(\n \"invalid number_of_bytes {} for variable {variableName}\",\n storage_type.number_of_bytes\n )\n })?;\n let num_slots = num_bytes.div_ceil(U256::from(32));\n\n // Start from 1 since base slot is already added\n for i in 1..num_slots.to::() {\n slots.push(slot + U256::from(i));\n }\n }\n\n if storage_type.encoding == ENCODING_BYTES {\n // Try to check if it's a long bytes/string by reading the current storage\n // value\n if let Ok(value) = ccx.ecx.journal_mut().sload(*target, slot) {\n let value_bytes = value.data.to_be_bytes::<32>();\n let length_byte = value_bytes[31];\n // Check if it's a long bytes/string (LSB is 1)\n if length_byte & 1 == 1 {\n // Calculate data slots for long bytes/string\n let length: U256 = value.data >> 1;\n let num_data_slots = length.to::().div_ceil(32);\n let data_start = U256::from_be_bytes(keccak256(B256::from(slot).0).0);\n\n for i in 0..num_data_slots {\n slots.push(data_start + U256::from(i));\n }\n }\n }\n }\n\n Ok(slots.abi_encode())\n }\n}\n\nimpl Cheatcode for getStorageAccessesCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let mut storage_accesses = Vec::new();\n\n if let Some(recorded_diffs) = &state.recorded_account_diffs_stack {\n for account_accesses in recorded_diffs.iter().flatten() {\n storage_accesses.extend(account_accesses.storageAccesses.clone());\n }\n }\n\n Ok(storage_accesses.abi_encode())\n }\n}\n\nimpl Cheatcode for broadcastRawTransactionCall {\n fn apply_full(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n ) -> Result {\n let tx = TxEnvelope::decode(&mut self.data.as_ref())\n .map_err(|err| fmt_err!(\"failed to decode RLP-encoded transaction: {err}\"))?;\n\n let from = tx.recover_signer()?;\n let tx_env = FromRecoveredTx::from_recovered_tx(&tx, from);\n\n executor.transact_from_tx_on_db(ccx.state, ccx.ecx, &tx_env)?;\n\n if ccx.state.broadcast.is_some() {\n ccx.state.broadcastable_transactions.push_back(BroadcastableTransaction {\n rpc: ccx.ecx.db().active_fork_url(),\n from,\n to: Some(tx.kind()),\n value: tx.value(),\n input: tx.input().clone(),\n nonce: tx.nonce(),\n gas: Some(tx.gas_limit()),\n kind: BroadcastKind::Signed(Bytes::copy_from_slice(&self.data)),\n });\n }\n\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for setBlockhashCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { blockNumber, blockHash } = *self;\n ensure!(blockNumber <= U256::from(u64::MAX), \"blockNumber must be less than 2^64\");\n ensure!(\n blockNumber <= U256::from(ccx.ecx.block().number()),\n \"block number must be less than or equal to the current block number\"\n );\n\n ccx.ecx.db_mut().set_blockhash(blockNumber, blockHash);\n\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for executeTransactionCall {\n fn apply_full(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n ) -> Result {\n use crate::env::FORGE_CONTEXT;\n\n // Block in script contexts.\n if let Some(ctx) = FORGE_CONTEXT.get()\n && *ctx == ForgeContext::ScriptGroup\n {\n return Err(fmt_err!(\"executeTransaction is not allowed in forge script\"));\n }\n\n // Decode the RLP-encoded signed transaction.\n let tx = FoundryTxEnvelope::decode(&mut self.rawTx.as_ref())\n .map_err(|err| fmt_err!(\"failed to decode RLP-encoded transaction: {err}\"))?;\n\n // Reject unsupported transaction types.\n // TODO: add support for OP deposit transactions.\n if matches!(tx, FoundryTxEnvelope::Deposit(_)) {\n return Err(fmt_err!(\n \"OP deposit transactions are not yet supported by executeTransaction\"\n ));\n }\n // TODO: add support for Tempo AA transactions.\n if matches!(tx, FoundryTxEnvelope::Tempo(_)) {\n return Err(fmt_err!(\"Tempo transactions are not yet supported by executeTransaction\"));\n }\n\n // Recover signer from the transaction signature.\n let sender = tx.recover().map_err(|err| fmt_err!(\"failed to recover signer: {err}\"))?;\n\n // Build TxEnv from the recovered transaction.\n let tx_env = >::from_recovered_tx(&tx, sender);\n\n // Save current env for restoration after execution.\n let cached_evm_env = ccx.ecx.evm_clone();\n let cached_tx_env = ccx.ecx.tx_clone();\n\n // Override env for isolated execution.\n ccx.ecx.block_mut().set_basefee(0);\n ccx.ecx.set_tx(tx_env);\n ccx.ecx.tx_mut().set_gas_price(0);\n ccx.ecx.tx_mut().set_gas_priority_fee(None);\n\n // Enable nonce checks for realistic simulation.\n ccx.ecx.cfg_mut().disable_nonce_check = false;\n\n // EIP-3860: enforce initcode size limit.\n ccx.ecx.cfg_mut().limit_contract_initcode_size =\n Some(revm::primitives::eip3860::MAX_INITCODE_SIZE);\n\n // Snapshot the modified env for EVM construction.\n let modified_evm_env = ccx.ecx.evm_clone();\n let modified_tx_env = ccx.ecx.tx_clone();\n\n // Mark as inner context so isolation mode doesn't trigger a nested transact_inner\n // when the inner EVM executes calls at depth == 1.\n executor.set_in_inner_context(true, Some(sender));\n\n // Clone journaled state and mark all accounts/slots cold.\n let cold_state = {\n let (_, journal) = ccx.ecx.db_journal_inner_mut();\n let mut state = journal.state.clone();\n for (addr, acc_mut) in &mut state {\n if journal.warm_addresses.is_cold(addr) {\n acc_mut.mark_cold();\n }\n for slot_mut in acc_mut.storage.values_mut() {\n slot_mut.is_cold = true;\n slot_mut.original_value = slot_mut.present_value;\n }\n }\n state\n };\n\n let mut res = None;\n let mut nested_env = None;\n let mut cold_state = Some(cold_state);\n let modified_tx = modified_tx_env.clone();\n {\n let (db, _) = ccx.ecx.db_journal_inner_mut();\n executor.with_fresh_nested_evm(\n ccx.state,\n db,\n modified_evm_env,\n modified_tx_env,\n &mut |evm| {\n // SAFETY: closure is called exactly once by the executor.\n evm.journal_inner_mut().state = cold_state.take().expect(\"called once\");\n // Set depth to 1 for proper trace collection.\n evm.journal_inner_mut().depth = 1;\n res = Some(evm.transact(modified_tx.clone()));\n nested_env = Some(evm.to_evm_env());\n Ok(())\n },\n )?;\n }\n let (res, mut nested_evm_env) = (res.unwrap(), nested_env.unwrap());\n\n // Restore env, preserving cheatcode cfg/block changes from the nested EVM\n // but restoring the original tx and basefee (which we zeroed for the nested call)\n // as well as cfg overrides that were applied only for the nested execution.\n nested_evm_env.block_env.basefee = cached_evm_env.block_env.basefee;\n nested_evm_env.cfg_env.disable_nonce_check = cached_evm_env.cfg_env.disable_nonce_check;\n nested_evm_env.cfg_env.limit_contract_initcode_size =\n cached_evm_env.cfg_env.limit_contract_initcode_size;\n ccx.ecx.set_evm(nested_evm_env);\n ccx.ecx.set_tx(cached_tx_env);\n\n // Reset inner context flag.\n executor.set_in_inner_context(false, None);\n\n let res = res.map_err(|e| fmt_err!(\"transaction execution failed: {e}\"))?;\n\n // Merge state changes back into the parent journaled state.\n for (addr, mut acc) in res.state {\n let Some(acc_mut) = ccx.ecx.journal_mut().evm_state_mut().get_mut(&addr) else {\n ccx.ecx.journal_mut().evm_state_mut().insert(addr, acc);\n continue;\n };\n\n // Preserve warm account status from parent context.\n if acc.status.contains(AccountStatus::Cold)\n && !acc_mut.status.contains(AccountStatus::Cold)\n {\n acc.status -= AccountStatus::Cold;\n }\n acc_mut.info = acc.info;\n acc_mut.status |= acc.status;\n\n // Merge storage changes.\n for (key, val) in acc.storage {\n let Some(slot_mut) = acc_mut.storage.get_mut(&key) else {\n acc_mut.storage.insert(key, val);\n continue;\n };\n slot_mut.present_value = val.present_value;\n slot_mut.is_cold &= val.is_cold;\n }\n }\n\n // Return output bytes.\n let output = match res.result {\n ExecutionResult::Success { output, .. } => output.into_data(),\n ExecutionResult::Halt { reason, .. } => {\n return Err(fmt_err!(\"transaction halted: {reason:?}\"));\n }\n ExecutionResult::Revert { output, .. } => {\n return Err(fmt_err!(\"transaction reverted: {}\", hex::encode_prefixed(&output)));\n }\n };\n\n Ok(output.abi_encode())\n }\n}\n\nimpl Cheatcode for startDebugTraceRecordingCall {\n fn apply_full(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n ) -> Result {\n let Some(tracer) = executor.tracing_inspector() else {\n return Err(Error::from(\"no tracer initiated, consider adding -vvv flag\"));\n };\n\n let mut info = RecordDebugStepInfo {\n // will be updated later\n start_node_idx: 0,\n // keep the original config to revert back later\n original_tracer_config: *tracer.config(),\n };\n\n // turn on tracer debug configuration for recording\n *tracer.config_mut() = TraceMode::Debug.into_config().expect(\"cannot be None\");\n\n // track where the recording starts\n if let Some(last_node) = tracer.traces().nodes().last() {\n info.start_node_idx = last_node.idx;\n }\n\n ccx.state.record_debug_steps_info = Some(info);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for stopAndReturnDebugTraceRecordingCall {\n fn apply_full(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n ) -> Result {\n let Some(tracer) = executor.tracing_inspector() else {\n return Err(Error::from(\"no tracer initiated, consider adding -vvv flag\"));\n };\n\n let Some(record_info) = ccx.state.record_debug_steps_info else {\n return Err(Error::from(\"nothing recorded\"));\n };\n\n // Use the trace nodes to flatten the call trace\n let root = tracer.traces();\n let steps = flatten_call_trace(0, root, record_info.start_node_idx);\n\n let debug_steps: Vec =\n steps.iter().map(|step| convert_call_trace_ctx_to_debug_step(step)).collect();\n // Free up memory by clearing the steps if they are not recorded outside of cheatcode usage.\n if !record_info.original_tracer_config.record_steps {\n tracer.traces_mut().nodes_mut().iter_mut().for_each(|node| {\n node.trace.steps = Vec::new();\n node.logs = Vec::new();\n node.ordering = Vec::new();\n });\n }\n\n // Revert the tracer config to the one before recording\n tracer.update_config(|_config| record_info.original_tracer_config);\n\n // Clean up the recording info\n ccx.state.record_debug_steps_info = None;\n\n Ok(debug_steps.abi_encode())\n }\n}\n\nimpl Cheatcode for setEvmVersionCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { evm } = self;\n let spec_id = evm_spec_id(\n EvmVersion::from_str(evm)\n .map_err(|_| Error::from(format!(\"invalid evm version {evm}\")))?,\n );\n ccx.state.execution_evm_version = Some(spec_id);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for getEvmVersionCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let spec: SpecId = ccx.ecx.cfg().spec().into();\n Ok(spec.to_string().to_lowercase().abi_encode())\n }\n}\n\npub(super) fn get_nonce>(\n ccx: &mut CheatsCtxt<'_, CTX>,\n address: &Address,\n) -> Result {\n let account = ccx.ecx.journal_mut().load_account(*address)?;\n Ok(account.data.info.nonce.abi_encode())\n}\n\nfn inner_snapshot_state(ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let evm_env =\n EvmEnv { cfg_env: ccx.ecx.cfg_mut().clone(), block_env: ccx.ecx.block_mut().clone() };\n let (db, inner) = ccx.ecx.db_journal_inner_mut();\n let id = db.snapshot_state(inner, &evm_env);\n Ok(id.abi_encode())\n}\n\nfn inner_revert_to_state(\n ccx: &mut CheatsCtxt<'_, CTX>,\n snapshot_id: U256,\n) -> Result {\n let mut evm_env = ccx.ecx.evm_clone();\n let mut tx_env = ccx.ecx.tx_clone();\n let (db, inner) = ccx.ecx.db_journal_inner_mut();\n if let Some(restored) = db.revert_state(\n snapshot_id,\n inner,\n &mut evm_env,\n &mut tx_env,\n RevertStateSnapshotAction::RevertKeep,\n ) {\n *inner = restored;\n ccx.ecx.set_evm(evm_env);\n ccx.ecx.set_tx(tx_env);\n Ok(true.abi_encode())\n } else {\n Ok(false.abi_encode())\n }\n}\n\nfn inner_revert_to_state_and_delete(\n ccx: &mut CheatsCtxt<'_, CTX>,\n snapshot_id: U256,\n) -> Result {\n let mut evm_env = ccx.ecx.evm_clone();\n let mut tx_env = ccx.ecx.tx_clone();\n let (db, inner) = ccx.ecx.db_journal_inner_mut();\n if let Some(restored) = db.revert_state(\n snapshot_id,\n inner,\n &mut evm_env,\n &mut tx_env,\n RevertStateSnapshotAction::RevertRemove,\n ) {\n *inner = restored;\n ccx.ecx.set_evm(evm_env);\n ccx.ecx.set_tx(tx_env);\n Ok(true.abi_encode())\n } else {\n Ok(false.abi_encode())\n }\n}\n\nfn inner_delete_state_snapshot>(\n ccx: &mut CheatsCtxt<'_, CTX>,\n snapshot_id: U256,\n) -> Result {\n let result = ccx.ecx.db_mut().delete_state_snapshot(snapshot_id);\n Ok(result.abi_encode())\n}\n\nfn inner_delete_state_snapshots>(\n ccx: &mut CheatsCtxt<'_, CTX>,\n) -> Result {\n ccx.ecx.db_mut().delete_state_snapshots();\n Ok(Default::default())\n}\n\nfn inner_value_snapshot(\n ccx: &mut CheatsCtxt<'_, CTX>,\n group: Option,\n name: Option,\n value: String,\n) -> Result {\n let (group, name) = derive_snapshot_name(ccx, group, name);\n\n ccx.state.gas_snapshots.entry(group).or_default().insert(name, value);\n\n Ok(Default::default())\n}\n\nfn inner_last_gas_snapshot(\n ccx: &mut CheatsCtxt<'_, CTX>,\n group: Option,\n name: Option,\n value: u64,\n) -> Result {\n let (group, name) = derive_snapshot_name(ccx, group, name);\n\n ccx.state.gas_snapshots.entry(group).or_default().insert(name, value.to_string());\n\n Ok(value.abi_encode())\n}\n\nfn inner_start_gas_snapshot(\n ccx: &mut CheatsCtxt<'_, CTX>,\n group: Option,\n name: Option,\n) -> Result {\n // Revert if there is an active gas snapshot as we can only have one active snapshot at a time.\n if let Some((group, name)) = &ccx.state.gas_metering.active_gas_snapshot {\n bail!(\"gas snapshot was already started with group: {group} and name: {name}\");\n }\n\n let (group, name) = derive_snapshot_name(ccx, group, name);\n\n ccx.state.gas_metering.gas_records.push(GasRecord {\n group: group.clone(),\n name: name.clone(),\n gas_used: 0,\n depth: ccx.ecx.journal().depth(),\n });\n\n ccx.state.gas_metering.active_gas_snapshot = Some((group, name));\n\n ccx.state.gas_metering.start();\n\n Ok(Default::default())\n}\n\nfn inner_stop_gas_snapshot(\n ccx: &mut CheatsCtxt<'_, CTX>,\n group: Option,\n name: Option,\n) -> Result {\n // If group and name are not provided, use the last snapshot group and name.\n let (group, name) = group\n .zip(name)\n .or_else(|| ccx.state.gas_metering.active_gas_snapshot.clone())\n .ok_or_else(|| fmt_err!(\"no active gas snapshot; call `startGasSnapshot` first\"))?;\n\n if let Some(record) = ccx\n .state\n .gas_metering\n .gas_records\n .iter_mut()\n .find(|record| record.group == group && record.name == name)\n {\n // Calculate the gas used since the snapshot was started.\n // We subtract 171 from the gas used to account for gas used by the snapshot itself.\n let value = record.gas_used.saturating_sub(171);\n\n ccx.state\n .gas_snapshots\n .entry(group.clone())\n .or_default()\n .insert(name.clone(), value.to_string());\n\n // Stop the gas metering.\n ccx.state.gas_metering.stop();\n\n // Remove the gas record.\n ccx.state\n .gas_metering\n .gas_records\n .retain(|record| record.group != group && record.name != name);\n\n // Clear last snapshot cache if we have an exact match.\n if let Some((snapshot_group, snapshot_name)) = &ccx.state.gas_metering.active_gas_snapshot\n && snapshot_group == &group\n && snapshot_name == &name\n {\n ccx.state.gas_metering.active_gas_snapshot = None;\n }\n\n Ok(value.abi_encode())\n } else {\n bail!(\"no gas snapshot was started with the name: {name} in group: {group}\");\n }\n}\n\n// Derives the snapshot group and name from the provided group and name or the running contract.\nfn derive_snapshot_name(\n ccx: &CheatsCtxt<'_, CTX>,\n group: Option,\n name: Option,\n) -> (String, String) {\n let group = group.unwrap_or_else(|| {\n ccx.state.config.running_artifact.clone().expect(\"expected running contract\").name\n });\n let name = name.unwrap_or_else(|| \"default\".to_string());\n (group, name)\n}\n\n/// Reads the current caller information and returns the current [CallerMode], `msg.sender` and\n/// `tx.origin`.\n///\n/// Depending on the current caller mode, one of the following results will be returned:\n/// - If there is an active prank:\n/// - caller_mode will be equal to:\n/// - [CallerMode::Prank] if the prank has been set with `vm.prank(..)`.\n/// - [CallerMode::RecurrentPrank] if the prank has been set with `vm.startPrank(..)`.\n/// - `msg.sender` will be equal to the address set for the prank.\n/// - `tx.origin` will be equal to the default sender address unless an alternative one has been\n/// set when configuring the prank.\n///\n/// - If there is an active broadcast:\n/// - caller_mode will be equal to:\n/// - [CallerMode::Broadcast] if the broadcast has been set with `vm.broadcast(..)`.\n/// - [CallerMode::RecurrentBroadcast] if the broadcast has been set with\n/// `vm.startBroadcast(..)`.\n/// - `msg.sender` and `tx.origin` will be equal to the address provided when setting the\n/// broadcast.\n///\n/// - If no caller modification is active:\n/// - caller_mode will be equal to [CallerMode::None],\n/// - `msg.sender` and `tx.origin` will be equal to the default sender address.\nfn read_callers(state: &Cheatcodes, default_sender: &Address, call_depth: usize) -> Result {\n let mut mode = CallerMode::None;\n let mut new_caller = default_sender;\n let mut new_origin = default_sender;\n if let Some(prank) = state.get_prank(call_depth) {\n mode = if prank.single_call { CallerMode::Prank } else { CallerMode::RecurrentPrank };\n new_caller = &prank.new_caller;\n if let Some(new) = &prank.new_origin {\n new_origin = new;\n }\n } else if let Some(broadcast) = &state.broadcast {\n mode = if broadcast.single_call {\n CallerMode::Broadcast\n } else {\n CallerMode::RecurrentBroadcast\n };\n new_caller = &broadcast.new_origin;\n new_origin = &broadcast.new_origin;\n }\n\n Ok((mode, new_caller, new_origin).abi_encode_params())\n}\n\n/// Ensures the `Account` is loaded and touched.\npub(super) fn journaled_account>(\n ecx: &mut CTX,\n addr: Address,\n) -> Result<&mut Account> {\n ensure_loaded_account(ecx, addr)?;\n Ok(ecx.journal_mut().evm_state_mut().get_mut(&addr).expect(\"account is loaded\"))\n}\n\npub(super) fn ensure_loaded_account>(\n ecx: &mut CTX,\n addr: Address,\n) -> Result<()> {\n ecx.journal_mut().load_account(addr)?;\n ecx.journal_mut().touch_account(addr);\n Ok(())\n}\n\n/// Consumes recorded account accesses and returns them as an abi encoded\n/// array of [AccountAccess]. If there are no accounts were\n/// recorded as accessed, an abi encoded empty array is returned.\n///\n/// In the case where `stopAndReturnStateDiff` is called at a lower\n/// depth than `startStateDiffRecording`, multiple `Vec`\n/// will be flattened, preserving the order of the accesses.\nfn get_state_diff(state: &mut Cheatcodes) -> Result {\n let res = state\n .recorded_account_diffs_stack\n .replace(Default::default())\n .unwrap_or_default()\n .into_iter()\n .flatten()\n .collect::>();\n Ok(res.abi_encode())\n}\n\n/// Helper function that creates a `GenesisAccount` from a regular `Account`.\nfn genesis_account(account: &Account) -> GenesisAccount {\n GenesisAccount {\n nonce: Some(account.info.nonce),\n balance: account.info.balance,\n code: account.info.code.as_ref().map(|o| o.original_bytes()),\n storage: Some(\n account\n .storage\n .iter()\n .map(|(k, v)| (B256::from(*k), B256::from(v.present_value())))\n .collect(),\n ),\n private_key: None,\n }\n}\n\n/// Helper function to returns state diffs recorded for each changed account.\nfn get_recorded_state_diffs>(\n ccx: &mut CheatsCtxt<'_, CTX>,\n) -> BTreeMap {\n let mut state_diffs: BTreeMap = BTreeMap::default();\n\n // First, collect all unique addresses we need to look up\n let mut addresses_to_lookup = HashSet::new();\n if let Some(records) = &ccx.state.recorded_account_diffs_stack {\n for account_access in records.iter().flatten() {\n if !account_access.storageAccesses.is_empty()\n || account_access.oldBalance != account_access.newBalance\n {\n addresses_to_lookup.insert(account_access.account);\n for storage_access in &account_access.storageAccesses {\n if storage_access.isWrite && !storage_access.reverted {\n addresses_to_lookup.insert(storage_access.account);\n }\n }\n }\n }\n }\n\n // Look up contract names and storage layouts for all addresses\n let mut contract_names = HashMap::new();\n let mut storage_layouts = HashMap::new();\n for address in addresses_to_lookup {\n if let Some((artifact_id, contract_data)) = get_contract_data(ccx, address) {\n contract_names.insert(address, artifact_id.identifier());\n\n // Also get storage layout if available\n if let Some(storage_layout) = &contract_data.storage_layout {\n storage_layouts.insert(address, storage_layout.clone());\n }\n }\n }\n\n // Now process the records\n if let Some(records) = &ccx.state.recorded_account_diffs_stack {\n records\n .iter()\n .flatten()\n .filter(|account_access| {\n !account_access.storageAccesses.is_empty()\n || account_access.oldBalance != account_access.newBalance\n || account_access.oldNonce != account_access.newNonce\n })\n .for_each(|account_access| {\n // Record account balance diffs.\n if account_access.oldBalance != account_access.newBalance {\n let account_diff =\n state_diffs.entry(account_access.account).or_insert_with(|| {\n AccountStateDiffs {\n label: ccx.state.labels.get(&account_access.account).cloned(),\n contract: contract_names.get(&account_access.account).cloned(),\n ..Default::default()\n }\n });\n // Update balance diff. Do not overwrite the initial balance if already set.\n if let Some(diff) = &mut account_diff.balance_diff {\n diff.new_value = account_access.newBalance;\n } else {\n account_diff.balance_diff = Some(BalanceDiff {\n previous_value: account_access.oldBalance,\n new_value: account_access.newBalance,\n });\n }\n }\n\n // Record account nonce diffs.\n if account_access.oldNonce != account_access.newNonce {\n let account_diff =\n state_diffs.entry(account_access.account).or_insert_with(|| {\n AccountStateDiffs {\n label: ccx.state.labels.get(&account_access.account).cloned(),\n contract: contract_names.get(&account_access.account).cloned(),\n ..Default::default()\n }\n });\n // Update nonce diff. Do not overwrite the initial nonce if already set.\n if let Some(diff) = &mut account_diff.nonce_diff {\n diff.new_value = account_access.newNonce;\n } else {\n account_diff.nonce_diff = Some(NonceDiff {\n previous_value: account_access.oldNonce,\n new_value: account_access.newNonce,\n });\n }\n }\n\n // Collect all storage accesses for this account\n let raw_changes_by_slot = account_access\n .storageAccesses\n .iter()\n .filter_map(|access| {\n (access.isWrite && !access.reverted)\n .then_some((access.slot, (access.previousValue, access.newValue)))\n })\n .collect::>();\n\n // Record account state diffs.\n for storage_access in &account_access.storageAccesses {\n if storage_access.isWrite && !storage_access.reverted {\n let account_diff = state_diffs\n .entry(storage_access.account)\n .or_insert_with(|| AccountStateDiffs {\n label: ccx.state.labels.get(&storage_access.account).cloned(),\n contract: contract_names.get(&storage_access.account).cloned(),\n ..Default::default()\n });\n let layout = storage_layouts.get(&storage_access.account);\n // Update state diff. Do not overwrite the initial value if already set.\n let entry = match account_diff.state_diff.entry(storage_access.slot) {\n Entry::Vacant(slot_state_diff) => {\n // Get storage layout info for this slot\n // Include mapping slots if available for the account\n let mapping_slots = ccx\n .state\n .mapping_slots\n .as_ref()\n .and_then(|slots| slots.get(&storage_access.account));\n\n let slot_info = layout.and_then(|layout| {\n let decoder = SlotIdentifier::new(layout.clone());\n decoder.identify(&storage_access.slot, mapping_slots).or_else(\n || {\n // Create a map of new values for bytes/string\n // identification. These values are used to determine\n // the length of the data which helps determine how many\n // slots to search\n let current_base_slot_values = raw_changes_by_slot\n .iter()\n .map(|(slot, (_, new_val))| (*slot, *new_val))\n .collect::>();\n decoder.identify_bytes_or_string(\n &storage_access.slot,\n ¤t_base_slot_values,\n )\n },\n )\n });\n\n slot_state_diff.insert(SlotStateDiff {\n previous_value: storage_access.previousValue,\n new_value: storage_access.newValue,\n slot_info,\n })\n }\n Entry::Occupied(slot_state_diff) => {\n let entry = slot_state_diff.into_mut();\n entry.new_value = storage_access.newValue;\n entry\n }\n };\n\n // Update decoded values if we have slot info\n if let Some(slot_info) = &mut entry.slot_info {\n slot_info.decode_values(entry.previous_value, storage_access.newValue);\n if slot_info.is_bytes_or_string() {\n slot_info.decode_bytes_or_string_values(\n &storage_access.slot,\n &raw_changes_by_slot,\n );\n }\n }\n }\n }\n });\n }\n state_diffs\n}\n\n/// EIP-1967 implementation storage slot\nconst EIP1967_IMPL_SLOT: &str = \"360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc\";\n\n/// EIP-1822 UUPS implementation storage slot: keccak256(\"PROXIABLE\")\nconst EIP1822_PROXIABLE_SLOT: &str =\n \"c5f16f0fcc639fa48a6947836d9850f504798523bf8c9a3a87d5876cf622bcf7\";\n\n/// Helper function to get the contract data from the deployed code at an address.\nfn get_contract_data<'a, CTX: ContextTr>(\n ccx: &'a mut CheatsCtxt<'_, CTX>,\n address: Address,\n) -> Option<(&'a foundry_compilers::ArtifactId, &'a foundry_common::contracts::ContractData)> {\n // Check if we have available artifacts to match against\n let artifacts = ccx.state.config.available_artifacts.as_ref()?;\n\n // Try to load the account and get its code\n let account = ccx.ecx.journal_mut().load_account(address).ok()?;\n let code = account.data.info.code.as_ref()?;\n\n // Skip if code is empty\n if code.is_empty() {\n return None;\n }\n\n // Try to find the artifact by deployed code\n let code_bytes = code.original_bytes();\n // First check for proxy patterns\n let hex_str = hex::encode(&code_bytes);\n let find_by_suffix =\n |suffix: &str| artifacts.iter().find(|(a, _)| a.identifier().ends_with(suffix));\n // Simple proxy detection based on storage slot patterns\n if hex_str.contains(EIP1967_IMPL_SLOT)\n && let Some(result) = find_by_suffix(\":TransparentUpgradeableProxy\")\n {\n return Some(result);\n } else if hex_str.contains(EIP1822_PROXIABLE_SLOT)\n && let Some(result) = find_by_suffix(\":UUPSUpgradeable\")\n {\n return Some(result);\n }\n\n // Try exact match\n if let Some(result) = artifacts.find_by_deployed_code_exact(&code_bytes) {\n return Some(result);\n }\n\n // Fallback to fuzzy matching if exact match fails\n artifacts.find_by_deployed_code(&code_bytes)\n}\n\n/// Helper function to set / unset cold storage slot of the target address.\nfn set_cold_slot>(\n ccx: &mut CheatsCtxt<'_, CTX>,\n target: Address,\n slot: U256,\n cold: bool,\n) {\n if let Some(account) = ccx.ecx.journal_mut().evm_state_mut().get_mut(&target)\n && let Some(storage_slot) = account.storage.get_mut(&slot)\n {\n storage_slot.is_cold = cold;\n }\n}\n" }, { "path": "crates/cheatcodes/src/fs.rs", "content": "//! Implementations of [`Filesystem`](spec::Group::Filesystem) cheatcodes.\n\nuse super::string::parse;\nuse crate::{\n Cheatcode, Cheatcodes, CheatcodesExecutor, CheatsCtxt, EthCheatCtx, Result, Vm::*,\n inspector::exec_create,\n};\nuse alloy_dyn_abi::DynSolType;\nuse alloy_json_abi::ContractObject;\nuse alloy_network::{Ethereum, Network, ReceiptResponse};\nuse alloy_primitives::{Bytes, U256, hex, map::Entry};\nuse alloy_sol_types::SolValue;\nuse dialoguer::{Input, Password};\nuse forge_script_sequence::{BroadcastReader, TransactionWithMetadata};\nuse foundry_common::fs;\nuse foundry_config::fs_permissions::FsAccessKind;\nuse revm::{\n context::{Cfg, ContextTr, CreateScheme, JournalTr},\n interpreter::CreateInputs,\n};\nuse revm_inspectors::tracing::types::CallKind;\nuse semver::Version;\nuse std::{\n io::{BufRead, BufReader},\n path::{Path, PathBuf},\n process::Command,\n sync::mpsc,\n thread,\n time::{SystemTime, UNIX_EPOCH},\n};\nuse walkdir::WalkDir;\n\nimpl Cheatcode for existsCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { path } = self;\n let path = state.config.ensure_path_allowed(path, FsAccessKind::Read)?;\n Ok(path.exists().abi_encode())\n }\n}\n\nimpl Cheatcode for fsMetadataCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { path } = self;\n let path = state.config.ensure_path_allowed(path, FsAccessKind::Read)?;\n\n let metadata = path.metadata()?;\n\n // These fields not available on all platforms; default to 0\n let [modified, accessed, created] =\n [metadata.modified(), metadata.accessed(), metadata.created()].map(|time| {\n time.unwrap_or(UNIX_EPOCH).duration_since(UNIX_EPOCH).unwrap_or_default().as_secs()\n });\n\n Ok(FsMetadata {\n isDir: metadata.is_dir(),\n isSymlink: metadata.is_symlink(),\n length: U256::from(metadata.len()),\n readOnly: metadata.permissions().readonly(),\n modified: U256::from(modified),\n accessed: U256::from(accessed),\n created: U256::from(created),\n }\n .abi_encode())\n }\n}\n\nimpl Cheatcode for isDirCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { path } = self;\n let path = state.config.ensure_path_allowed(path, FsAccessKind::Read)?;\n Ok(path.is_dir().abi_encode())\n }\n}\n\nimpl Cheatcode for isFileCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { path } = self;\n let path = state.config.ensure_path_allowed(path, FsAccessKind::Read)?;\n Ok(path.is_file().abi_encode())\n }\n}\n\nimpl Cheatcode for projectRootCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self {} = self;\n Ok(state.config.root.display().to_string().abi_encode())\n }\n}\n\nimpl Cheatcode for currentFilePathCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self {} = self;\n let artifact = state\n .config\n .running_artifact\n .as_ref()\n .ok_or_else(|| fmt_err!(\"no running contract found\"))?;\n let relative = artifact.source.strip_prefix(&state.config.root).unwrap_or(&artifact.source);\n Ok(relative.display().to_string().abi_encode())\n }\n}\n\nimpl Cheatcode for unixTimeCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self {} = self;\n let difference = SystemTime::now()\n .duration_since(UNIX_EPOCH)\n .map_err(|e| fmt_err!(\"failed getting Unix timestamp: {e}\"))?;\n Ok(difference.as_millis().abi_encode())\n }\n}\n\nimpl Cheatcode for closeFileCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { path } = self;\n let path = state.config.ensure_path_allowed(path, FsAccessKind::Read)?;\n\n state.test_context.opened_read_files.remove(&path);\n\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for copyFileCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { from, to } = self;\n let from = state.config.ensure_path_allowed(from, FsAccessKind::Read)?;\n let to = state.config.ensure_path_allowed(to, FsAccessKind::Write)?;\n state.config.ensure_not_foundry_toml(&to)?;\n\n let n = fs::copy(from, to)?;\n Ok(n.abi_encode())\n }\n}\n\nimpl Cheatcode for createDirCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { path, recursive } = self;\n let path = state.config.ensure_path_allowed(path, FsAccessKind::Write)?;\n if *recursive { fs::create_dir_all(path) } else { fs::create_dir(path) }?;\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for readDir_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { path } = self;\n read_dir(state, path.as_ref(), 1, false)\n }\n}\n\nimpl Cheatcode for readDir_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { path, maxDepth } = self;\n read_dir(state, path.as_ref(), *maxDepth, false)\n }\n}\n\nimpl Cheatcode for readDir_2Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { path, maxDepth, followLinks } = self;\n read_dir(state, path.as_ref(), *maxDepth, *followLinks)\n }\n}\n\nimpl Cheatcode for readFileCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { path } = self;\n let path = state.config.ensure_path_allowed(path, FsAccessKind::Read)?;\n Ok(fs::locked_read_to_string(path)?.abi_encode())\n }\n}\n\nimpl Cheatcode for readFileBinaryCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { path } = self;\n let path = state.config.ensure_path_allowed(path, FsAccessKind::Read)?;\n Ok(fs::locked_read(path)?.abi_encode())\n }\n}\n\nimpl Cheatcode for readLineCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { path } = self;\n let path = state.config.ensure_path_allowed(path, FsAccessKind::Read)?;\n\n // Get reader for previously opened file to continue reading OR initialize new reader\n let reader = match state.test_context.opened_read_files.entry(path.clone()) {\n Entry::Occupied(entry) => entry.into_mut(),\n Entry::Vacant(entry) => entry.insert(BufReader::new(fs::open(path)?)),\n };\n\n let mut line: String = String::new();\n reader.read_line(&mut line)?;\n\n // Remove trailing newline character, preserving others for cases where it may be important\n if line.ends_with('\\n') {\n line.pop();\n if line.ends_with('\\r') {\n line.pop();\n }\n }\n\n Ok(line.abi_encode())\n }\n}\n\nimpl Cheatcode for readLinkCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { linkPath: path } = self;\n let path = state.config.ensure_path_allowed(path, FsAccessKind::Read)?;\n let target = fs::read_link(path)?;\n Ok(target.display().to_string().abi_encode())\n }\n}\n\nimpl Cheatcode for removeDirCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { path, recursive } = self;\n let path = state.config.ensure_path_allowed(path, FsAccessKind::Write)?;\n if *recursive { fs::remove_dir_all(path) } else { fs::remove_dir(path) }?;\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for removeFileCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { path } = self;\n let path = state.config.ensure_path_allowed(path, FsAccessKind::Write)?;\n state.config.ensure_not_foundry_toml(&path)?;\n\n // also remove from the set if opened previously\n state.test_context.opened_read_files.remove(&path);\n\n if state.fs_commit {\n fs::remove_file(&path)?;\n }\n\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for writeFileCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { path, data } = self;\n write_file(state, path.as_ref(), data.as_bytes())\n }\n}\n\nimpl Cheatcode for writeFileBinaryCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { path, data } = self;\n write_file(state, path.as_ref(), data)\n }\n}\n\nimpl Cheatcode for writeLineCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { path, data: line } = self;\n let path = state.config.ensure_path_allowed(path, FsAccessKind::Write)?;\n state.config.ensure_not_foundry_toml(&path)?;\n\n if state.fs_commit {\n fs::locked_write_line(path, line)?;\n }\n\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for getArtifactPathByCodeCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { code } = self;\n let (artifact_id, _) = state\n .config\n .available_artifacts\n .as_ref()\n .and_then(|artifacts| artifacts.find_by_creation_code(code))\n .ok_or_else(|| fmt_err!(\"no matching artifact found\"))?;\n\n Ok(artifact_id.path.to_string_lossy().abi_encode())\n }\n}\n\nimpl Cheatcode for getArtifactPathByDeployedCodeCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { deployedCode } = self;\n let (artifact_id, _) = state\n .config\n .available_artifacts\n .as_ref()\n .and_then(|artifacts| artifacts.find_by_deployed_code(deployedCode))\n .ok_or_else(|| fmt_err!(\"no matching artifact found\"))?;\n\n Ok(artifact_id.path.to_string_lossy().abi_encode())\n }\n}\n\nimpl Cheatcode for getCodeCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { artifactPath: path } = self;\n Ok(get_artifact_code(state, path, false)?.abi_encode())\n }\n}\n\nimpl Cheatcode for getDeployedCodeCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { artifactPath: path } = self;\n Ok(get_artifact_code(state, path, true)?.abi_encode())\n }\n}\n\nimpl Cheatcode for deployCode_0Call {\n fn apply_full(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n ) -> Result {\n let Self { artifactPath: path } = self;\n deploy_code(ccx, executor, path, None, None, None)\n }\n}\n\nimpl Cheatcode for deployCode_1Call {\n fn apply_full(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n ) -> Result {\n let Self { artifactPath: path, constructorArgs: args } = self;\n deploy_code(ccx, executor, path, Some(args), None, None)\n }\n}\n\nimpl Cheatcode for deployCode_2Call {\n fn apply_full(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n ) -> Result {\n let Self { artifactPath: path, value } = self;\n deploy_code(ccx, executor, path, None, Some(*value), None)\n }\n}\n\nimpl Cheatcode for deployCode_3Call {\n fn apply_full(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n ) -> Result {\n let Self { artifactPath: path, constructorArgs: args, value } = self;\n deploy_code(ccx, executor, path, Some(args), Some(*value), None)\n }\n}\n\nimpl Cheatcode for deployCode_4Call {\n fn apply_full(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n ) -> Result {\n let Self { artifactPath: path, salt } = self;\n deploy_code(ccx, executor, path, None, None, Some((*salt).into()))\n }\n}\n\nimpl Cheatcode for deployCode_5Call {\n fn apply_full(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n ) -> Result {\n let Self { artifactPath: path, constructorArgs: args, salt } = self;\n deploy_code(ccx, executor, path, Some(args), None, Some((*salt).into()))\n }\n}\n\nimpl Cheatcode for deployCode_6Call {\n fn apply_full(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n ) -> Result {\n let Self { artifactPath: path, value, salt } = self;\n deploy_code(ccx, executor, path, None, Some(*value), Some((*salt).into()))\n }\n}\n\nimpl Cheatcode for deployCode_7Call {\n fn apply_full(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n ) -> Result {\n let Self { artifactPath: path, constructorArgs: args, value, salt } = self;\n deploy_code(ccx, executor, path, Some(args), Some(*value), Some((*salt).into()))\n }\n}\n\n/// Helper function to deploy contract from artifact code.\n/// Uses CREATE2 scheme if salt specified.\nfn deploy_code(\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n path: &str,\n constructor_args: Option<&Bytes>,\n value: Option,\n salt: Option,\n) -> Result {\n let mut bytecode = get_artifact_code(ccx.state, path, false)?.to_vec();\n\n // If active broadcast then set flag to deploy from code.\n if let Some(broadcast) = &mut ccx.state.broadcast {\n broadcast.deploy_from_code = true;\n }\n\n if let Some(args) = constructor_args {\n bytecode.extend_from_slice(args);\n }\n\n let scheme =\n if let Some(salt) = salt { CreateScheme::Create2 { salt } } else { CreateScheme::Create };\n\n // If prank active at current depth, then use it as caller for create input.\n let caller =\n ccx.state.get_prank(ccx.ecx.journal().depth()).map_or(ccx.caller, |prank| prank.new_caller);\n\n let outcome = exec_create(\n executor,\n CreateInputs::new(\n caller,\n scheme,\n value.unwrap_or(U256::ZERO),\n bytecode.into(),\n ccx.gas_limit,\n ),\n ccx,\n )?;\n\n if !outcome.result.result.is_ok() {\n return Err(crate::Error::from(outcome.result.output));\n }\n\n let address = outcome.address.ok_or_else(|| fmt_err!(\"contract creation failed\"))?;\n\n Ok(address.abi_encode())\n}\n\n/// Returns the bytecode from a JSON artifact file.\n///\n/// Can parse following input formats:\n/// - `path/to/artifact.json`\n/// - `path/to/contract.sol`\n/// - `path/to/contract.sol:ContractName`\n/// - `path/to/contract.sol:ContractName:0.8.23`\n/// - `path/to/contract.sol:0.8.23`\n/// - `ContractName`\n/// - `ContractName:0.8.23`\n///\n/// This function is safe to use with contracts that have library dependencies.\n/// `alloy_json_abi::ContractObject` validates bytecode during JSON parsing and will\n/// reject artifacts with unlinked library placeholders.\nfn get_artifact_code(state: &Cheatcodes, path: &str, deployed: bool) -> Result {\n let path = if path.ends_with(\".json\") {\n PathBuf::from(path)\n } else {\n let mut parts = path.split(':');\n\n let mut file = None;\n let mut contract_name = None;\n let mut version = None;\n\n let path_or_name = parts.next().unwrap();\n if path_or_name.contains('.') {\n file = Some(PathBuf::from(path_or_name));\n if let Some(name_or_version) = parts.next() {\n if name_or_version.contains('.') {\n version = Some(name_or_version);\n } else {\n contract_name = Some(name_or_version);\n version = parts.next();\n }\n }\n } else {\n contract_name = Some(path_or_name);\n version = parts.next();\n }\n\n let version = if let Some(version) = version {\n Some(Version::parse(version).map_err(|e| fmt_err!(\"failed parsing version: {e}\"))?)\n } else {\n None\n };\n\n // Use available artifacts list if present\n if let Some(artifacts) = &state.config.available_artifacts {\n let filtered = artifacts\n .iter()\n .filter(|(id, _)| {\n // name might be in the form of \"Counter.0.8.23\"\n let id_name = id.name.split('.').next().unwrap();\n\n if let Some(path) = &file\n && !id.source.ends_with(path)\n {\n return false;\n }\n if let Some(name) = contract_name\n && id_name != name\n {\n return false;\n }\n if let Some(ref version) = version\n && (id.version.minor != version.minor\n || id.version.major != version.major\n || id.version.patch != version.patch)\n {\n return false;\n }\n true\n })\n .collect::>();\n\n let artifact = match &filtered[..] {\n [] => None,\n [artifact] => Some(Ok(*artifact)),\n filtered => {\n let mut filtered = filtered.to_vec();\n // If we know the current script/test contract solc version, try to filter by it\n Some(\n state\n .config\n .running_artifact\n .as_ref()\n .and_then(|running| {\n // Firstly filter by version\n filtered.retain(|(id, _)| id.version == running.version);\n\n // Return artifact if only one matched\n if filtered.len() == 1 {\n return Some(filtered[0]);\n }\n\n // Try filtering by profile as well\n filtered.retain(|(id, _)| id.profile == running.profile);\n\n if filtered.len() == 1 { Some(filtered[0]) } else { None }\n })\n .ok_or_else(|| fmt_err!(\"multiple matching artifacts found\")),\n )\n }\n };\n\n if let Some(artifact) = artifact {\n let artifact = artifact?;\n let maybe_bytecode = if deployed {\n artifact.1.deployed_bytecode().cloned()\n } else {\n artifact.1.bytecode().cloned()\n };\n\n return maybe_bytecode.ok_or_else(|| {\n fmt_err!(\"no bytecode for contract; is it abstract or unlinked?\")\n });\n }\n }\n\n // Fallback: construct path manually when no artifacts list or no match found\n let path_in_artifacts = match (file.map(|f| f.to_string_lossy().to_string()), contract_name)\n {\n (Some(file), Some(contract_name)) => {\n PathBuf::from(format!(\"{file}/{contract_name}.json\"))\n }\n (None, Some(contract_name)) => {\n PathBuf::from(format!(\"{contract_name}.sol/{contract_name}.json\"))\n }\n (Some(file), None) => {\n let name = file.replace(\".sol\", \"\");\n PathBuf::from(format!(\"{file}/{name}.json\"))\n }\n _ => bail!(\"invalid artifact path\"),\n };\n\n state.config.paths.artifacts.join(path_in_artifacts)\n };\n\n let path = state.config.ensure_path_allowed(path, FsAccessKind::Read)?;\n let data = fs::read_to_string(path).map_err(|e| {\n if state.config.available_artifacts.is_some() {\n fmt_err!(\"no matching artifact found\")\n } else {\n e.into()\n }\n })?;\n let artifact = serde_json::from_str::(&data)?;\n let maybe_bytecode = if deployed { artifact.deployed_bytecode } else { artifact.bytecode };\n maybe_bytecode.ok_or_else(|| fmt_err!(\"no bytecode for contract; is it abstract or unlinked?\"))\n}\n\nimpl Cheatcode for ffiCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { commandInput: input } = self;\n\n let output = ffi(state, input)?;\n\n // Check the exit code of the command.\n if output.exitCode != 0 {\n // If the command failed, return an error with the exit code and stderr.\n return Err(fmt_err!(\n \"ffi command {:?} exited with code {}. stderr: {}\",\n input,\n output.exitCode,\n String::from_utf8_lossy(&output.stderr)\n ));\n }\n\n // If the command succeeded but still wrote to stderr, log it as a warning.\n if !output.stderr.is_empty() {\n let stderr = String::from_utf8_lossy(&output.stderr);\n warn!(target: \"cheatcodes\", ?input, ?stderr, \"ffi command wrote to stderr\");\n }\n\n // We already hex-decoded the stdout in the `ffi` helper function.\n Ok(output.stdout.abi_encode())\n }\n}\n\nimpl Cheatcode for tryFfiCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { commandInput: input } = self;\n ffi(state, input).map(|res| res.abi_encode())\n }\n}\n\nimpl Cheatcode for promptCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { promptText: text } = self;\n prompt(state, text, prompt_input).map(|res| res.abi_encode())\n }\n}\n\nimpl Cheatcode for promptSecretCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { promptText: text } = self;\n prompt(state, text, prompt_password).map(|res| res.abi_encode())\n }\n}\n\nimpl Cheatcode for promptSecretUintCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { promptText: text } = self;\n parse(&prompt(state, text, prompt_password)?, &DynSolType::Uint(256))\n }\n}\n\nimpl Cheatcode for promptAddressCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { promptText: text } = self;\n parse(&prompt(state, text, prompt_input)?, &DynSolType::Address)\n }\n}\n\nimpl Cheatcode for promptUintCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { promptText: text } = self;\n parse(&prompt(state, text, prompt_input)?, &DynSolType::Uint(256))\n }\n}\n\npub(super) fn write_file(state: &Cheatcodes, path: &Path, contents: &[u8]) -> Result {\n let path = state.config.ensure_path_allowed(path, FsAccessKind::Write)?;\n // write access to foundry.toml is not allowed\n state.config.ensure_not_foundry_toml(&path)?;\n\n if state.fs_commit {\n fs::locked_write(path, contents)?;\n }\n\n Ok(Default::default())\n}\n\nfn read_dir(state: &Cheatcodes, path: &Path, max_depth: u64, follow_links: bool) -> Result {\n let root = state.config.ensure_path_allowed(path, FsAccessKind::Read)?;\n let paths: Vec = WalkDir::new(root)\n .min_depth(1)\n .max_depth(max_depth.try_into().unwrap_or(usize::MAX))\n .follow_links(follow_links)\n .contents_first(false)\n .same_file_system(true)\n .sort_by_file_name()\n .into_iter()\n .map(|entry| match entry {\n Ok(entry) => DirEntry {\n errorMessage: String::new(),\n path: entry.path().display().to_string(),\n depth: entry.depth() as u64,\n isDir: entry.file_type().is_dir(),\n isSymlink: entry.path_is_symlink(),\n },\n Err(e) => DirEntry {\n errorMessage: e.to_string(),\n path: e.path().map(|p| p.display().to_string()).unwrap_or_default(),\n depth: e.depth() as u64,\n isDir: false,\n isSymlink: false,\n },\n })\n .collect();\n Ok(paths.abi_encode())\n}\n\nfn ffi(state: &Cheatcodes, input: &[String]) -> Result {\n ensure!(\n state.config.ffi,\n \"FFI is disabled; add the `--ffi` flag to allow tests to call external commands\"\n );\n ensure!(!input.is_empty() && !input[0].is_empty(), \"can't execute empty command\");\n let mut cmd = Command::new(&input[0]);\n cmd.args(&input[1..]);\n\n debug!(target: \"cheatcodes\", ?cmd, \"invoking ffi\");\n\n let output = cmd\n .current_dir(&state.config.root)\n .output()\n .map_err(|err| fmt_err!(\"failed to execute command {cmd:?}: {err}\"))?;\n\n // The stdout might be encoded on valid hex, or it might just be a string,\n // so we need to determine which it is to avoid improperly encoding later.\n let trimmed_stdout = String::from_utf8(output.stdout)?;\n let trimmed_stdout = trimmed_stdout.trim();\n let encoded_stdout = if let Ok(hex) = hex::decode(trimmed_stdout) {\n hex\n } else {\n trimmed_stdout.as_bytes().to_vec()\n };\n Ok(FfiResult {\n exitCode: output.status.code().unwrap_or(69),\n stdout: encoded_stdout.into(),\n stderr: output.stderr.into(),\n })\n}\n\nfn prompt_input(prompt_text: &str) -> Result {\n Input::new().allow_empty(true).with_prompt(prompt_text).interact_text()\n}\n\nfn prompt_password(prompt_text: &str) -> Result {\n Password::new().with_prompt(prompt_text).interact()\n}\n\nfn prompt(\n state: &Cheatcodes,\n prompt_text: &str,\n input: fn(&str) -> Result,\n) -> Result {\n let text_clone = prompt_text.to_string();\n let timeout = state.config.prompt_timeout;\n let (tx, rx) = mpsc::channel();\n\n thread::spawn(move || {\n let _ = tx.send(input(&text_clone));\n });\n\n match rx.recv_timeout(timeout) {\n Ok(res) => res.map_err(|err| {\n let _ = sh_println!();\n err.to_string().into()\n }),\n Err(_) => {\n let _ = sh_eprintln!();\n Err(\"Prompt timed out\".into())\n }\n }\n}\n\nimpl Cheatcode for getBroadcastCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { contractName, chainId, txType } = self;\n\n let latest_broadcast = latest_broadcast(\n contractName,\n *chainId,\n &state.config.broadcast,\n vec![map_broadcast_tx_type(*txType)],\n )?;\n\n Ok(latest_broadcast.abi_encode())\n }\n}\n\nimpl Cheatcode for getBroadcasts_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { contractName, chainId, txType } = self;\n\n let reader = BroadcastReader::new(contractName.clone(), *chainId, &state.config.broadcast)?\n .with_tx_type(map_broadcast_tx_type(*txType));\n\n let broadcasts = reader.read::()?;\n\n let summaries = broadcasts\n .into_iter()\n .flat_map(|broadcast| {\n let results = reader.into_tx_receipts(broadcast);\n parse_broadcast_results(results)\n })\n .collect::>();\n\n Ok(summaries.abi_encode())\n }\n}\n\nimpl Cheatcode for getBroadcasts_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { contractName, chainId } = self;\n\n let reader = BroadcastReader::new(contractName.clone(), *chainId, &state.config.broadcast)?;\n\n let broadcasts = reader.read::()?;\n\n let summaries = broadcasts\n .into_iter()\n .flat_map(|broadcast| {\n let results = reader.into_tx_receipts(broadcast);\n parse_broadcast_results(results)\n })\n .collect::>();\n\n Ok(summaries.abi_encode())\n }\n}\n\nimpl Cheatcode for getDeployment_0Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { contractName } = self;\n let chain_id = ccx.ecx.cfg().chain_id();\n\n let latest_broadcast = latest_broadcast(\n contractName,\n chain_id,\n &ccx.state.config.broadcast,\n vec![CallKind::Create, CallKind::Create2],\n )?;\n\n Ok(latest_broadcast.contractAddress.abi_encode())\n }\n}\n\nimpl Cheatcode for getDeployment_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { contractName, chainId } = self;\n\n let latest_broadcast = latest_broadcast(\n contractName,\n *chainId,\n &state.config.broadcast,\n vec![CallKind::Create, CallKind::Create2],\n )?;\n\n Ok(latest_broadcast.contractAddress.abi_encode())\n }\n}\n\nimpl Cheatcode for getDeploymentsCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { contractName, chainId } = self;\n\n let reader = BroadcastReader::new(contractName.clone(), *chainId, &state.config.broadcast)?\n .with_tx_type(CallKind::Create)\n .with_tx_type(CallKind::Create2);\n\n let broadcasts = reader.read::()?;\n\n let summaries = broadcasts\n .into_iter()\n .flat_map(|broadcast| {\n let results = reader.into_tx_receipts(broadcast);\n parse_broadcast_results(results)\n })\n .collect::>();\n\n let deployed_addresses =\n summaries.into_iter().map(|summary| summary.contractAddress).collect::>();\n\n Ok(deployed_addresses.abi_encode())\n }\n}\n\nfn map_broadcast_tx_type(tx_type: BroadcastTxType) -> CallKind {\n match tx_type {\n BroadcastTxType::Call => CallKind::Call,\n BroadcastTxType::Create => CallKind::Create,\n BroadcastTxType::Create2 => CallKind::Create2,\n _ => unreachable!(\"invalid tx type\"),\n }\n}\n\nfn parse_broadcast_results(\n results: Vec<(TransactionWithMetadata, N::ReceiptResponse)>,\n) -> Vec {\n results\n .into_iter()\n .map(|(tx, receipt)| BroadcastTxSummary {\n txHash: receipt.transaction_hash(),\n blockNumber: receipt.block_number().unwrap_or_default(),\n txType: match tx.opcode {\n CallKind::Call => BroadcastTxType::Call,\n CallKind::Create => BroadcastTxType::Create,\n CallKind::Create2 => BroadcastTxType::Create2,\n _ => unreachable!(\"invalid tx type\"),\n },\n contractAddress: tx.contract_address.unwrap_or_default(),\n success: receipt.status(),\n })\n .collect()\n}\n\nfn latest_broadcast(\n contract_name: &String,\n chain_id: u64,\n broadcast_path: &Path,\n filters: Vec,\n) -> Result {\n let mut reader = BroadcastReader::new(contract_name.clone(), chain_id, broadcast_path)?;\n\n for filter in filters {\n reader = reader.with_tx_type(filter);\n }\n\n let broadcast = reader.read_latest::()?;\n\n let results = reader.into_tx_receipts(broadcast);\n\n let summaries = parse_broadcast_results(results);\n\n summaries\n .first()\n .ok_or_else(|| fmt_err!(\"no deployment found for {contract_name} on chain {chain_id}\"))\n .cloned()\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n use crate::CheatsConfig;\n use std::sync::Arc;\n\n fn cheats() -> Cheatcodes {\n let config = CheatsConfig {\n ffi: true,\n root: PathBuf::from(&env!(\"CARGO_MANIFEST_DIR\")),\n ..Default::default()\n };\n Cheatcodes::new(Arc::new(config))\n }\n\n #[test]\n fn test_ffi_hex() {\n let msg = b\"gm\";\n let cheats = cheats();\n let args = [\"echo\".to_string(), hex::encode(msg)];\n let output = ffi(&cheats, &args).unwrap();\n assert_eq!(output.stdout, Bytes::from(msg));\n }\n\n #[test]\n fn test_ffi_string() {\n let msg = \"gm\";\n let cheats = cheats();\n let args = [\"echo\".to_string(), msg.to_string()];\n let output = ffi(&cheats, &args).unwrap();\n assert_eq!(output.stdout, Bytes::from(msg.as_bytes()));\n }\n\n #[test]\n fn test_ffi_fails_on_error_code() {\n let mut cheats = cheats();\n\n // Use a command that is guaranteed to fail with a non-zero exit code on any platform.\n #[cfg(unix)]\n let args = vec![\"false\".to_string()];\n #[cfg(windows)]\n let args = vec![\"cmd\".to_string(), \"/c\".to_string(), \"exit 1\".to_string()];\n\n let result = Cheatcode::apply(&ffiCall { commandInput: args }, &mut cheats);\n\n // Assert that the cheatcode returned an error.\n assert!(result.is_err(), \"Expected ffi cheatcode to fail, but it succeeded\");\n\n // Assert that the error message contains the expected information.\n let err_msg = result.unwrap_err().to_string();\n assert!(\n err_msg.contains(\"exited with code 1\"),\n \"Error message did not contain exit code: {err_msg}\"\n );\n }\n\n #[test]\n fn test_artifact_parsing() {\n let s = include_str!(\"../../evm/test-data/solc-obj.json\");\n let artifact: ContractObject = serde_json::from_str(s).unwrap();\n assert!(artifact.bytecode.is_some());\n\n let artifact: ContractObject = serde_json::from_str(s).unwrap();\n assert!(artifact.deployed_bytecode.is_some());\n }\n\n #[test]\n fn test_alloy_json_abi_rejects_unlinked_bytecode() {\n let artifact_json = r#\"{\n \"abi\": [],\n \"bytecode\": \"0x73__$987e73aeca5e61ce83e4cb0814d87beda9$__63baf2f868\"\n }\"#;\n\n let result: Result = serde_json::from_str(artifact_json);\n assert!(result.is_err(), \"should reject unlinked bytecode with placeholders\");\n let err = result.unwrap_err().to_string();\n assert!(err.contains(\"expected bytecode, found unlinked bytecode with placeholder\"));\n }\n}\n" }, { "path": "crates/cheatcodes/src/inspector/analysis.rs", "content": "//! Cheatcode information, extracted from the syntactic and semantic analysis of the sources.\n\nuse foundry_common::fmt::{StructDefinitions, TypeDefMap};\nuse solar::sema::{self, Compiler, Gcx, hir};\nuse std::sync::{Arc, OnceLock};\nuse thiserror::Error;\n\n/// Represents a failure in one of the lazy analysis steps.\n#[derive(Debug, Clone, PartialEq, Eq, Error)]\npub enum AnalysisError {\n /// Indicates that the resolution of struct definitions failed.\n #[error(\"unable to resolve struct definitions\")]\n StructDefinitionsResolutionFailed,\n}\n\n/// Provides cached, on-demand syntactic and semantic analysis of a completed `Compiler` instance.\n///\n/// This struct acts as a facade over the `Compiler`, offering lazy-loaded analysis for tools like\n/// cheatcode inspectors. It assumes the compiler has already completed parsing and lowering.\n///\n/// # Adding with new analyses types\n///\n/// To add support for a new type of cached analysis, follow this pattern:\n///\n/// 1. Add a new `pub OnceCell>` field to `CheatcodeAnalysis`, where `T` is\n/// the type of the data that you are adding support for.\n///\n/// 2. Implement a getter method for the new field. Inside the getter, use\n/// `self.field.get_or_init()` to compute and cache the value on the first call.\n///\n/// 3. Inside the closure passed to `get_or_init()`, create a dedicated visitor to traverse the HIR\n/// using `self.compiler.enter()` and collect the required data.\n///\n/// This ensures all analyses remain lazy, efficient, and consistent with the existing design.\n#[derive(Clone)]\npub struct CheatcodeAnalysis {\n /// A shared, thread-safe reference to solar's `Compiler` instance.\n pub compiler: Arc,\n\n /// Cached struct definitions in the sources.\n /// Used to keep field order when parsing JSON values.\n struct_defs: OnceLock>,\n}\n\nimpl std::fmt::Debug for CheatcodeAnalysis {\n fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {\n f.debug_struct(\"CheatcodeAnalysis\")\n .field(\"compiler\", &\"\")\n .field(\"struct_defs\", &self.struct_defs)\n .finish()\n }\n}\n\nimpl CheatcodeAnalysis {\n pub fn new(compiler: Arc) -> Self {\n Self { compiler, struct_defs: OnceLock::new() }\n }\n\n /// Lazily initializes and returns the struct definitions.\n pub fn struct_defs(&self) -> Result<&StructDefinitions, &AnalysisError> {\n self.struct_defs\n .get_or_init(|| {\n self.compiler.enter(|compiler| {\n let gcx = compiler.gcx();\n\n StructDefinitionResolver::new(gcx).process()\n })\n })\n .as_ref()\n }\n}\n\n// -- STRUCT DEFINITIONS -------------------------------------------------------\n\n/// Generates a map of all struct definitions from the HIR using the resolved `Ty` system.\nstruct StructDefinitionResolver<'gcx> {\n gcx: Gcx<'gcx>,\n struct_defs: TypeDefMap,\n}\n\nimpl<'gcx> StructDefinitionResolver<'gcx> {\n /// Constructs a new generator.\n pub fn new(gcx: Gcx<'gcx>) -> Self {\n Self { gcx, struct_defs: TypeDefMap::new() }\n }\n\n /// Processes the HIR to generate all the struct definitions.\n pub fn process(mut self) -> Result {\n for id in self.hir().strukt_ids() {\n self.resolve_struct_definition(id)?;\n }\n Ok(self.struct_defs.into())\n }\n\n #[inline]\n fn hir(&self) -> &'gcx hir::Hir<'gcx> {\n &self.gcx.hir\n }\n\n /// The recursive core of the generator. Resolves a single struct and adds it to the cache.\n fn resolve_struct_definition(&mut self, id: hir::StructId) -> Result<(), AnalysisError> {\n let qualified_name = self.get_fully_qualified_name(id);\n if self.struct_defs.contains_key(&qualified_name) {\n return Ok(());\n }\n\n let hir = self.hir();\n let strukt = hir.strukt(id);\n let mut fields = Vec::with_capacity(strukt.fields.len());\n\n for &field_id in strukt.fields {\n let var = hir.variable(field_id);\n let name =\n var.name.ok_or(AnalysisError::StructDefinitionsResolutionFailed)?.to_string();\n if let Some(ty_str) = self.ty_to_string(self.gcx.type_of_hir_ty(&var.ty)) {\n fields.push((name, ty_str));\n }\n }\n\n // Only insert if there are fields, to avoid adding empty entries\n if !fields.is_empty() {\n self.struct_defs.insert(qualified_name, fields);\n }\n\n Ok(())\n }\n\n /// Converts a resolved `Ty` into its canonical string representation.\n fn ty_to_string(&mut self, ty: sema::Ty<'gcx>) -> Option {\n let ty = ty.peel_refs();\n let res = match ty.kind {\n sema::ty::TyKind::Elementary(e) => e.to_string(),\n sema::ty::TyKind::Array(ty, size) => {\n let inner_type = self.ty_to_string(ty)?;\n format!(\"{inner_type}[{size}]\")\n }\n sema::ty::TyKind::DynArray(ty) => {\n let inner_type = self.ty_to_string(ty)?;\n format!(\"{inner_type}[]\")\n }\n sema::ty::TyKind::Struct(id) => {\n // Ensure the nested struct is resolved before proceeding.\n self.resolve_struct_definition(id).ok()?;\n self.get_fully_qualified_name(id)\n }\n sema::ty::TyKind::Udvt(ty, _) => self.ty_to_string(ty)?,\n // For now, map enums to `uint8`\n sema::ty::TyKind::Enum(_) => \"uint8\".to_string(),\n // For now, map contracts to `address`\n sema::ty::TyKind::Contract(_) => \"address\".to_string(),\n // Explicitly disallow unsupported types\n _ => return None,\n };\n\n Some(res)\n }\n\n /// Helper to get the fully qualified name `Contract.Struct`.\n fn get_fully_qualified_name(&self, id: hir::StructId) -> String {\n let hir = self.hir();\n let strukt = hir.strukt(id);\n if let Some(contract_id) = strukt.contract {\n format!(\"{}.{}\", hir.contract(contract_id).name.as_str(), strukt.name.as_str())\n } else {\n strukt.name.as_str().into()\n }\n }\n}\n" }, { "path": "crates/cheatcodes/src/inspector/utils.rs", "content": "use crate::inspector::Cheatcodes;\nuse alloy_primitives::{Address, Bytes, U256};\nuse foundry_evm_core::backend::DatabaseExt;\nuse revm::{\n context::ContextTr,\n inspector::JournalExt,\n interpreter::{CreateInputs, CreateScheme},\n};\n\n/// Common behaviour of legacy and EOF create inputs.\npub(crate) trait CommonCreateInput {\n fn caller(&self) -> Address;\n fn gas_limit(&self) -> u64;\n fn value(&self) -> U256;\n fn init_code(&self) -> Bytes;\n fn scheme(&self) -> Option;\n fn set_caller(&mut self, caller: Address);\n fn log_debug(&self, cheatcode: &mut Cheatcodes, scheme: &CreateScheme);\n fn allow_cheatcodes>(\n &self,\n cheatcodes: &mut Cheatcodes,\n ecx: &mut CTX,\n ) -> Address;\n}\n\nimpl CommonCreateInput for &mut CreateInputs {\n fn caller(&self) -> Address {\n CreateInputs::caller(self)\n }\n fn gas_limit(&self) -> u64 {\n CreateInputs::gas_limit(self)\n }\n fn value(&self) -> U256 {\n CreateInputs::value(self)\n }\n fn init_code(&self) -> Bytes {\n CreateInputs::init_code(self).clone()\n }\n fn scheme(&self) -> Option {\n Some(CreateInputs::scheme(self))\n }\n fn set_caller(&mut self, caller: Address) {\n CreateInputs::set_call(self, caller);\n }\n fn log_debug(&self, cheatcode: &mut Cheatcodes, scheme: &CreateScheme) {\n let kind = match scheme {\n CreateScheme::Create => \"create\",\n CreateScheme::Create2 { .. } => \"create2\",\n CreateScheme::Custom { .. } => \"custom\",\n };\n debug!(target: \"cheatcodes\", tx=?cheatcode.broadcastable_transactions.back().unwrap(), \"broadcastable {kind}\");\n }\n fn allow_cheatcodes>(\n &self,\n cheatcodes: &mut Cheatcodes,\n ecx: &mut CTX,\n ) -> Address {\n let caller = CreateInputs::caller(self);\n let old_nonce =\n ecx.journal().evm_state().get(&caller).map(|acc| acc.info.nonce).unwrap_or_default();\n let created_address = self.created_address(old_nonce);\n cheatcodes.allow_cheatcodes_on_create(ecx, caller, created_address);\n created_address\n }\n}\n" }, { "path": "crates/cheatcodes/src/inspector.rs", "content": "//! Cheatcode EVM inspector.\n\nuse crate::{\n Cheatcode, CheatsConfig, CheatsCtxt, Error, Result,\n Vm::{self, AccountAccess},\n evm::{\n DealRecord, GasRecord, RecordAccess, journaled_account,\n mock::{MockCallDataContext, MockCallReturnData},\n prank::Prank,\n },\n inspector::utils::CommonCreateInput,\n script::{Broadcast, Wallets},\n test::{\n assume::AssumeNoRevert,\n expect::{\n self, ExpectedCallData, ExpectedCallTracker, ExpectedCallType, ExpectedCreate,\n ExpectedEmitTracker, ExpectedRevert, ExpectedRevertKind,\n },\n revert_handlers,\n },\n utils::IgnoredTraces,\n};\nuse alloy_consensus::BlobTransactionSidecarVariant;\nuse alloy_primitives::{\n Address, B256, Bytes, Log, TxKind, U256, hex,\n map::{AddressHashMap, HashMap, HashSet},\n};\nuse alloy_rpc_types::AccessList;\nuse alloy_sol_types::{SolCall, SolInterface, SolValue};\nuse foundry_common::{\n SELECTOR_LEN,\n mapping_slots::{MappingSlots, step as mapping_step},\n};\nuse foundry_evm_core::{\n Breakpoints, EthCheatCtx, EvmEnv, FoundryInspectorExt, FoundryTransaction,\n abi::Vm::stopExpectSafeMemoryCall,\n backend::{DatabaseError, DatabaseExt, RevertDiagnostic},\n constants::{CHEATCODE_ADDRESS, HARDHAT_CONSOLE_ADDRESS, MAGIC_ASSUME},\n env::FoundryContextExt,\n evm::{NestedEvm, NestedEvmClosure, new_eth_evm_with_inspector, with_cloned_context},\n};\nuse foundry_evm_traces::{\n TracingInspector, TracingInspectorConfig, identifier::SignaturesIdentifier,\n};\nuse foundry_wallets::wallet_multi::MultiWallet;\nuse itertools::Itertools;\nuse proptest::test_runner::{RngAlgorithm, TestRng, TestRunner};\nuse rand::Rng;\nuse revm::{\n Inspector,\n bytecode::opcode as op,\n context::{\n BlockEnv, Cfg, ContextTr, JournalTr, Transaction, TransactionType, result::EVMError,\n },\n context_interface::{CreateScheme, transaction::SignedAuthorization},\n handler::FrameResult,\n inspector::JournalExt,\n interpreter::{\n CallInputs, CallOutcome, CallScheme, CreateInputs, CreateOutcome, FrameInput, Gas,\n InstructionResult, Interpreter, InterpreterAction, InterpreterResult,\n interpreter_types::{Jumps, LoopControl, MemoryTr},\n },\n primitives::hardfork::SpecId,\n};\nuse serde_json::Value;\nuse std::{\n cmp::max,\n collections::{BTreeMap, VecDeque},\n fmt::Debug,\n fs::File,\n io::BufReader,\n ops::Range,\n path::PathBuf,\n sync::{Arc, OnceLock},\n};\n\nmod utils;\n\npub mod analysis;\npub use analysis::CheatcodeAnalysis;\n\n/// Helper trait for running nested EVM operations from inside cheatcode implementations.\npub trait CheatcodesExecutor {\n /// Runs a closure with a nested EVM built from the current context.\n /// The inspector is assembled internally ā€” never exposed to the caller.\n fn with_nested_evm(\n &mut self,\n cheats: &mut Cheatcodes,\n ecx: &mut CTX,\n f: NestedEvmClosure<'_, CTX::Block, CTX::Tx, ::Spec>,\n ) -> Result<(), EVMError>;\n\n /// Replays a historical transaction on the database. Inspector is assembled internally.\n fn transact_on_db(\n &mut self,\n cheats: &mut Cheatcodes,\n ecx: &mut CTX,\n fork_id: Option,\n transaction: B256,\n ) -> eyre::Result<()>;\n\n /// Executes a `TransactionRequest` on the database. Inspector is assembled internally.\n fn transact_from_tx_on_db(\n &mut self,\n cheats: &mut Cheatcodes,\n ecx: &mut CTX,\n tx: &CTX::Tx,\n ) -> eyre::Result<()>;\n\n /// Runs a closure with a fresh nested EVM built from a raw database and environment.\n /// Unlike `with_nested_evm`, this does NOT clone from `ecx` and does NOT write back.\n /// The caller is responsible for state merging. Used by `executeTransactionCall`.\n fn with_fresh_nested_evm(\n &mut self,\n cheats: &mut Cheatcodes,\n db: &mut dyn DatabaseExt::Spec>,\n evm_env: EvmEnv<::Spec, CTX::Block>,\n tx_env: CTX::Tx,\n f: NestedEvmClosure<'_, CTX::Block, CTX::Tx, ::Spec>,\n ) -> Result<(), EVMError>;\n\n /// Simulates `console.log` invocation.\n fn console_log(&mut self, cheats: &mut Cheatcodes, msg: &str);\n\n /// Returns a mutable reference to the tracing inspector if it is available.\n fn tracing_inspector(&mut self) -> Option<&mut TracingInspector> {\n None\n }\n\n /// Marks that the next EVM frame is an \"inner context\" so that isolation mode does not\n /// trigger a nested `transact_inner`. `original_origin` is stored for the existing\n /// inner-context adjustment logic that restores `tx.origin`.\n fn set_in_inner_context(&mut self, _enabled: bool, _original_origin: Option
) {}\n}\n\n/// Builds a sub-EVM from the current context and executes the given CREATE frame.\npub(crate) fn exec_create(\n executor: &mut dyn CheatcodesExecutor,\n inputs: CreateInputs,\n ccx: &mut CheatsCtxt<'_, CTX>,\n) -> std::result::Result> {\n let mut inputs = Some(inputs);\n let mut outcome = None;\n executor.with_nested_evm(ccx.state, ccx.ecx, &mut |evm| {\n let inputs = inputs.take().unwrap();\n evm.journal_inner_mut().depth += 1;\n\n let frame = FrameInput::Create(Box::new(inputs));\n\n let result = match evm.run_execution(frame)? {\n FrameResult::Call(_) => unreachable!(),\n FrameResult::Create(create) => create,\n };\n\n evm.journal_inner_mut().depth -= 1;\n\n outcome = Some(result);\n Ok(())\n })?;\n Ok(outcome.unwrap())\n}\n\n/// Basic implementation of [CheatcodesExecutor] that simply returns the [Cheatcodes] instance as an\n/// inspector.\n#[derive(Debug, Default, Clone, Copy)]\nstruct TransparentCheatcodesExecutor;\n\nimpl CheatcodesExecutor for TransparentCheatcodesExecutor {\n fn with_nested_evm(\n &mut self,\n cheats: &mut Cheatcodes,\n ecx: &mut CTX,\n f: NestedEvmClosure<'_, CTX::Block, CTX::Tx, ::Spec>,\n ) -> Result<(), EVMError> {\n with_cloned_context(ecx, |db, evm_env, tx_env, journal_inner| {\n let mut evm = new_eth_evm_with_inspector(db, evm_env, tx_env, cheats);\n *evm.journal_inner_mut() = journal_inner;\n f(&mut evm)?;\n let sub_evm_env = evm.to_evm_env();\n let sub_inner = evm.journaled_state.inner.clone();\n Ok((sub_evm_env, sub_inner))\n })\n }\n\n fn with_fresh_nested_evm(\n &mut self,\n cheats: &mut Cheatcodes,\n db: &mut dyn DatabaseExt::Spec>,\n evm_env: EvmEnv<::Spec, CTX::Block>,\n tx_env: CTX::Tx,\n f: NestedEvmClosure<'_, CTX::Block, CTX::Tx, ::Spec>,\n ) -> Result<(), EVMError> {\n let mut evm = new_eth_evm_with_inspector(db, evm_env, tx_env, cheats);\n f(&mut evm)\n }\n\n fn transact_on_db(\n &mut self,\n cheats: &mut Cheatcodes,\n ecx: &mut CTX,\n fork_id: Option,\n transaction: B256,\n ) -> eyre::Result<()> {\n let evm_env = ecx.evm_clone();\n let tx_env = ecx.tx_clone();\n let (db, inner) = ecx.db_journal_inner_mut();\n db.transact(fork_id, transaction, evm_env, tx_env, inner, cheats)\n }\n\n fn transact_from_tx_on_db(\n &mut self,\n cheats: &mut Cheatcodes,\n ecx: &mut CTX,\n tx: &CTX::Tx,\n ) -> eyre::Result<()> {\n let evm_env = ecx.evm_clone();\n let (db, inner) = ecx.db_journal_inner_mut();\n db.transact_from_tx(tx, evm_env, inner, cheats)\n }\n\n fn console_log(&mut self, _cheats: &mut Cheatcodes, _msg: &str) {}\n}\n\nmacro_rules! try_or_return {\n ($e:expr) => {\n match $e {\n Ok(v) => v,\n Err(_) => return,\n }\n };\n}\n\n/// Contains additional, test specific resources that should be kept for the duration of the test\n#[derive(Debug, Default)]\npub struct TestContext {\n /// Buffered readers for files opened for reading (path => BufReader mapping)\n pub opened_read_files: HashMap>,\n}\n\n/// Every time we clone `Context`, we want it to be empty\nimpl Clone for TestContext {\n fn clone(&self) -> Self {\n Default::default()\n }\n}\n\nimpl TestContext {\n /// Clears the context.\n pub fn clear(&mut self) {\n self.opened_read_files.clear();\n }\n}\n\n/// Helps collecting transactions from different forks.\n///\n/// This type is intentionally network-agnostic ā€” it stores raw EVM data (from, to, value, input,\n/// etc.) without requiring a `Network` type parameter. Conversion to network-specific types\n/// (e.g. `TransactionRequest`, `TxEnvelope`) happens later in the script layer.\n#[derive(Clone, Debug)]\npub struct BroadcastableTransaction {\n /// The optional RPC URL.\n pub rpc: Option,\n /// Sender address.\n pub from: Address,\n /// Recipient (None for contract creation).\n pub to: Option,\n /// Ether value.\n pub value: U256,\n /// Calldata or init code.\n pub input: Bytes,\n /// Sender nonce.\n pub nonce: u64,\n /// Gas limit, if explicitly set.\n pub gas: Option,\n /// Whether this transaction was pre-signed or needs signing.\n pub kind: BroadcastKind,\n}\n\n/// Distinguishes between unsigned transactions (from `startBroadcast`) that need signing, and\n/// pre-signed transactions (from `broadcastRawTransaction`) that carry raw RLP-encoded bytes.\n#[derive(Clone, Debug)]\npub enum BroadcastKind {\n /// Unsigned transaction collected during `startBroadcast`. Needs signing before broadcast.\n Unsigned {\n chain_id: Option,\n blob_sidecar: Option,\n authorization_list: Option>,\n },\n /// Pre-signed transaction from `broadcastRawTransaction`. Contains raw RLP-encoded bytes.\n Signed(Bytes),\n}\n\nimpl BroadcastKind {\n /// Creates an unsigned broadcast with no chain-specific fields set.\n pub fn unsigned() -> Self {\n Self::Unsigned { chain_id: None, blob_sidecar: None, authorization_list: None }\n }\n}\n\n#[derive(Clone, Debug, Copy)]\npub struct RecordDebugStepInfo {\n /// The debug trace node index when the recording starts.\n pub start_node_idx: usize,\n /// The original tracer config when the recording starts.\n pub original_tracer_config: TracingInspectorConfig,\n}\n\n/// Holds gas metering state.\n#[derive(Clone, Debug, Default)]\npub struct GasMetering {\n /// True if gas metering is paused.\n pub paused: bool,\n /// True if gas metering was resumed or reset during the test.\n /// Used to reconcile gas when frame ends (if spent less than refunded).\n pub touched: bool,\n /// True if gas metering should be reset to frame limit.\n pub reset: bool,\n /// Stores paused gas frames.\n pub paused_frames: Vec,\n\n /// The group and name of the active snapshot.\n pub active_gas_snapshot: Option<(String, String)>,\n\n /// Cache of the amount of gas used in previous call.\n /// This is used by the `lastCallGas` cheatcode.\n pub last_call_gas: Option,\n\n /// True if gas recording is enabled.\n pub recording: bool,\n /// The gas used in the last frame.\n pub last_gas_used: u64,\n /// Gas records for the active snapshots.\n pub gas_records: Vec,\n}\n\nimpl GasMetering {\n /// Start the gas recording.\n pub fn start(&mut self) {\n self.recording = true;\n }\n\n /// Stop the gas recording.\n pub fn stop(&mut self) {\n self.recording = false;\n }\n\n /// Resume paused gas metering.\n pub fn resume(&mut self) {\n if self.paused {\n self.paused = false;\n self.touched = true;\n }\n self.paused_frames.clear();\n }\n\n /// Reset gas to limit.\n pub fn reset(&mut self) {\n self.paused = false;\n self.touched = true;\n self.reset = true;\n self.paused_frames.clear();\n }\n}\n\n/// Holds data about arbitrary storage.\n#[derive(Clone, Debug, Default)]\npub struct ArbitraryStorage {\n /// Mapping of arbitrary storage addresses to generated values (slot, arbitrary value).\n /// (SLOADs return random value if storage slot wasn't accessed).\n /// Changed values are recorded and used to copy storage to different addresses.\n pub values: HashMap>,\n /// Mapping of address with storage copied to arbitrary storage address source.\n pub copies: HashMap,\n /// Address with storage slots that should be overwritten even if previously set.\n pub overwrites: HashSet
,\n}\n\nimpl ArbitraryStorage {\n /// Marks an address with arbitrary storage.\n pub fn mark_arbitrary(&mut self, address: &Address, overwrite: bool) {\n self.values.insert(*address, HashMap::default());\n if overwrite {\n self.overwrites.insert(*address);\n } else {\n self.overwrites.remove(address);\n }\n }\n\n /// Maps an address that copies storage with the arbitrary storage address.\n pub fn mark_copy(&mut self, from: &Address, to: &Address) {\n if self.values.contains_key(from) {\n self.copies.insert(*to, *from);\n }\n }\n\n /// Saves arbitrary storage value for a given address:\n /// - store value in changed values cache.\n /// - update account's storage with given value.\n pub fn save(\n &mut self,\n ecx: &mut CTX,\n address: Address,\n slot: U256,\n data: U256,\n ) {\n self.values.get_mut(&address).expect(\"missing arbitrary address entry\").insert(slot, data);\n if ecx.journal_mut().load_account(address).is_ok() {\n ecx.journal_mut()\n .sstore(address, slot, data)\n .expect(\"could not set arbitrary storage value\");\n }\n }\n\n /// Copies arbitrary storage value from source address to the given target address:\n /// - if a value is present in arbitrary values cache, then update target storage and return\n /// existing value.\n /// - if no value was yet generated for given slot, then save new value in cache and update both\n /// source and target storages.\n pub fn copy(\n &mut self,\n ecx: &mut CTX,\n target: Address,\n slot: U256,\n new_value: U256,\n ) -> U256 {\n let source = self.copies.get(&target).expect(\"missing arbitrary copy target entry\");\n let storage_cache = self.values.get_mut(source).expect(\"missing arbitrary source storage\");\n let value = match storage_cache.get(&slot) {\n Some(value) => *value,\n None => {\n storage_cache.insert(slot, new_value);\n // Update source storage with new value.\n if ecx.journal_mut().load_account(*source).is_ok() {\n ecx.journal_mut()\n .sstore(*source, slot, new_value)\n .expect(\"could not copy arbitrary storage value\");\n }\n new_value\n }\n };\n // Update target storage with new value.\n if ecx.journal_mut().load_account(target).is_ok() {\n ecx.journal_mut().sstore(target, slot, value).expect(\"could not set storage\");\n }\n value\n }\n}\n\n/// List of transactions that can be broadcasted.\npub type BroadcastableTransactions = VecDeque;\n\n/// An EVM inspector that handles calls to various cheatcodes, each with their own behavior.\n///\n/// Cheatcodes can be called by contracts during execution to modify the VM environment, such as\n/// mocking addresses, signatures and altering call reverts.\n///\n/// Executing cheatcodes can be very powerful. Most cheatcodes are limited to evm internals, but\n/// there are also cheatcodes like `ffi` which can execute arbitrary commands or `writeFile` and\n/// `readFile` which can manipulate files of the filesystem. Therefore, several restrictions are\n/// implemented for these cheatcodes:\n/// - `ffi`, and file cheatcodes are _always_ opt-in (via foundry config) and never enabled by\n/// default: all respective cheatcode handlers implement the appropriate checks\n/// - File cheatcodes require explicit permissions which paths are allowed for which operation, see\n/// `Config.fs_permission`\n/// - Only permitted accounts are allowed to execute cheatcodes in forking mode, this ensures no\n/// contract deployed on the live network is able to execute cheatcodes by simply calling the\n/// cheatcode address: by default, the caller, test contract and newly deployed contracts are\n/// allowed to execute cheatcodes\n#[derive(Clone, Debug)]\npub struct Cheatcodes {\n /// Solar compiler instance, to grant syntactic and semantic analysis capabilities\n pub analysis: Option,\n\n /// The block environment\n ///\n /// Used in the cheatcode handler to overwrite the block environment separately from the\n /// execution block environment.\n pub block: Option,\n\n /// Currently active EIP-7702 delegations that will be consumed when building the next\n /// transaction. Set by `vm.attachDelegation()` and consumed via `.take()` during\n /// transaction construction.\n pub active_delegations: Vec,\n\n /// The active EIP-4844 blob that will be attached to the next call.\n pub active_blob_sidecar: Option,\n\n /// The gas price.\n ///\n /// Used in the cheatcode handler to overwrite the gas price separately from the gas price\n /// in the execution environment.\n pub gas_price: Option,\n\n /// Address labels\n pub labels: AddressHashMap,\n\n /// Prank information, mapped to the call depth where pranks were added.\n pub pranks: BTreeMap,\n\n /// Expected revert information\n pub expected_revert: Option,\n\n /// Assume next call can revert and discard fuzz run if it does.\n pub assume_no_revert: Option,\n\n /// Additional diagnostic for reverts\n pub fork_revert_diagnostic: Option,\n\n /// Recorded storage reads and writes\n pub accesses: RecordAccess,\n\n /// Whether storage access recording is currently active\n pub recording_accesses: bool,\n\n /// Recorded account accesses (calls, creates) organized by relative call depth, where the\n /// topmost vector corresponds to accesses at the depth at which account access recording\n /// began. Each vector in the matrix represents a list of accesses at a specific call\n /// depth. Once that call context has ended, the last vector is removed from the matrix and\n /// merged into the previous vector.\n pub recorded_account_diffs_stack: Option>>,\n\n /// The information of the debug step recording.\n pub record_debug_steps_info: Option,\n\n /// Recorded logs\n pub recorded_logs: Option>,\n\n /// Mocked calls\n // **Note**: inner must a BTreeMap because of special `Ord` impl for `MockCallDataContext`\n pub mocked_calls: HashMap>>,\n\n /// Mocked functions. Maps target address to be mocked to pair of (calldata, mock address).\n pub mocked_functions: HashMap>,\n\n /// Expected calls\n pub expected_calls: ExpectedCallTracker,\n /// Expected emits\n pub expected_emits: ExpectedEmitTracker,\n /// Expected creates\n pub expected_creates: Vec,\n\n /// Map of context depths to memory offset ranges that may be written to within the call depth.\n pub allowed_mem_writes: HashMap>>,\n\n /// Current broadcasting information\n pub broadcast: Option,\n\n /// Scripting based transactions\n pub broadcastable_transactions: BroadcastableTransactions,\n\n /// Current EIP-2930 access lists.\n pub access_list: Option,\n\n /// Additional, user configurable context this Inspector has access to when inspecting a call.\n pub config: Arc,\n\n /// Test-scoped context holding data that needs to be reset every test run\n pub test_context: TestContext,\n\n /// Whether to commit FS changes such as file creations, writes and deletes.\n /// Used to prevent duplicate changes file executing non-committing calls.\n pub fs_commit: bool,\n\n /// Serialized JSON values.\n // **Note**: both must a BTreeMap to ensure the order of the keys is deterministic.\n pub serialized_jsons: BTreeMap>,\n\n /// All recorded ETH `deal`s.\n pub eth_deals: Vec,\n\n /// Gas metering state.\n pub gas_metering: GasMetering,\n\n /// Contains gas snapshots made over the course of a test suite.\n // **Note**: both must a BTreeMap to ensure the order of the keys is deterministic.\n pub gas_snapshots: BTreeMap>,\n\n /// Mapping slots.\n pub mapping_slots: Option>,\n\n /// The current program counter.\n pub pc: usize,\n /// Breakpoints supplied by the `breakpoint` cheatcode.\n /// `char -> (address, pc)`\n pub breakpoints: Breakpoints,\n\n /// Whether the next contract creation should be intercepted to return its initcode.\n pub intercept_next_create_call: bool,\n\n /// Optional cheatcodes `TestRunner`. Used for generating random values from uint and int\n /// strategies.\n test_runner: Option,\n\n /// Ignored traces.\n pub ignored_traces: IgnoredTraces,\n\n /// Addresses with arbitrary storage.\n pub arbitrary_storage: Option,\n\n /// Deprecated cheatcodes mapped to the reason. Used to report warnings on test results.\n pub deprecated: HashMap<&'static str, Option<&'static str>>,\n /// Unlocked wallets used in scripts and testing of scripts.\n pub wallets: Option,\n /// Signatures identifier for decoding events and functions\n signatures_identifier: OnceLock>,\n /// Used to determine whether the broadcasted call has dynamic gas limit.\n pub dynamic_gas_limit: bool,\n // Custom execution evm version.\n pub execution_evm_version: Option,\n}\n\n// This is not derived because calling this in `fn new` with `..Default::default()` creates a second\n// `CheatsConfig` which is unused, and inside it `ProjectPathsConfig` is relatively expensive to\n// create.\nimpl Default for Cheatcodes {\n fn default() -> Self {\n Self::new(Arc::default())\n }\n}\n\nimpl Cheatcodes {\n /// Creates a new `Cheatcodes` with the given settings.\n pub fn new(config: Arc) -> Self {\n Self {\n analysis: None,\n fs_commit: true,\n labels: config.labels.clone(),\n config,\n block: Default::default(),\n active_delegations: Default::default(),\n active_blob_sidecar: Default::default(),\n gas_price: Default::default(),\n pranks: Default::default(),\n expected_revert: Default::default(),\n assume_no_revert: Default::default(),\n fork_revert_diagnostic: Default::default(),\n accesses: Default::default(),\n recording_accesses: Default::default(),\n recorded_account_diffs_stack: Default::default(),\n recorded_logs: Default::default(),\n record_debug_steps_info: Default::default(),\n mocked_calls: Default::default(),\n mocked_functions: Default::default(),\n expected_calls: Default::default(),\n expected_emits: Default::default(),\n expected_creates: Default::default(),\n allowed_mem_writes: Default::default(),\n broadcast: Default::default(),\n broadcastable_transactions: Default::default(),\n access_list: Default::default(),\n test_context: Default::default(),\n serialized_jsons: Default::default(),\n eth_deals: Default::default(),\n gas_metering: Default::default(),\n gas_snapshots: Default::default(),\n mapping_slots: Default::default(),\n pc: Default::default(),\n breakpoints: Default::default(),\n intercept_next_create_call: Default::default(),\n test_runner: Default::default(),\n ignored_traces: Default::default(),\n arbitrary_storage: Default::default(),\n deprecated: Default::default(),\n wallets: Default::default(),\n signatures_identifier: Default::default(),\n dynamic_gas_limit: Default::default(),\n execution_evm_version: None,\n }\n }\n\n /// Enables cheatcode analysis capabilities by providing a solar compiler instance.\n pub fn set_analysis(&mut self, analysis: CheatcodeAnalysis) {\n self.analysis = Some(analysis);\n }\n\n /// Returns the configured prank at given depth or the first prank configured at a lower depth.\n /// For example, if pranks configured for depth 1, 3 and 5, the prank for depth 4 is the one\n /// configured at depth 3.\n pub fn get_prank(&self, depth: usize) -> Option<&Prank> {\n self.pranks.range(..=depth).last().map(|(_, prank)| prank)\n }\n\n /// Returns the configured wallets if available, else creates a new instance.\n pub fn wallets(&mut self) -> &Wallets {\n self.wallets.get_or_insert_with(|| Wallets::new(MultiWallet::default(), None))\n }\n\n /// Sets the unlocked wallets.\n pub fn set_wallets(&mut self, wallets: Wallets) {\n self.wallets = Some(wallets);\n }\n\n /// Adds a delegation to the active delegations list.\n pub fn add_delegation(&mut self, authorization: SignedAuthorization) {\n self.active_delegations.push(authorization);\n }\n\n /// Returns the signatures identifier.\n pub fn signatures_identifier(&self) -> Option<&SignaturesIdentifier> {\n self.signatures_identifier.get_or_init(|| SignaturesIdentifier::new(true).ok()).as_ref()\n }\n\n /// Decodes the input data and applies the cheatcode.\n fn apply_cheatcode(\n &mut self,\n ecx: &mut CTX,\n call: &CallInputs,\n executor: &mut dyn CheatcodesExecutor,\n ) -> Result {\n // decode the cheatcode call\n let decoded = Vm::VmCalls::abi_decode(&call.input.bytes(ecx)).map_err(|e| {\n if let alloy_sol_types::Error::UnknownSelector { name: _, selector } = e {\n let msg = format!(\n \"unknown cheatcode with selector {selector}; \\\n you may have a mismatch between the `Vm` interface (likely in `forge-std`) \\\n and the `forge` version\"\n );\n return alloy_sol_types::Error::Other(std::borrow::Cow::Owned(msg));\n }\n e\n })?;\n\n let caller = call.caller;\n\n // ensure the caller is allowed to execute cheatcodes,\n // but only if the backend is in forking mode\n ecx.db_mut().ensure_cheatcode_access_forking_mode(&caller)?;\n\n apply_dispatch(\n &decoded,\n &mut CheatsCtxt { state: self, ecx, gas_limit: call.gas_limit, caller },\n executor,\n )\n }\n\n /// Grants cheat code access for new contracts if the caller also has\n /// cheatcode access or the new contract is created in top most call.\n ///\n /// There may be cheatcodes in the constructor of the new contract, in order to allow them\n /// automatically we need to determine the new address.\n fn allow_cheatcodes_on_create>(\n &self,\n ecx: &mut CTX,\n caller: Address,\n created_address: Address,\n ) {\n if ecx.journal().depth() <= 1 || ecx.db().has_cheatcode_access(&caller) {\n ecx.db_mut().allow_cheatcode_access(created_address);\n }\n }\n\n /// Apply EIP-2930 access list.\n ///\n /// If the transaction type is [TransactionType::Legacy] we need to upgrade it to\n /// [TransactionType::Eip2930] in order to use access lists. Other transaction types support\n /// access lists themselves.\n fn apply_accesslist(&mut self, ecx: &mut CTX) {\n if let Some(access_list) = &self.access_list {\n ecx.tx_mut().set_access_list(access_list.clone());\n\n if ecx.tx().tx_type() == TransactionType::Legacy as u8 {\n ecx.tx_mut().set_tx_type(TransactionType::Eip2930 as u8);\n }\n }\n }\n\n /// Called when there was a revert.\n ///\n /// Cleanup any previously applied cheatcodes that altered the state in such a way that revm's\n /// revert would run into issues.\n pub fn on_revert>(&mut self, ecx: &mut CTX) {\n trace!(deals=?self.eth_deals.len(), \"rolling back deals\");\n\n // Delay revert clean up until expected revert is handled, if set.\n if self.expected_revert.is_some() {\n return;\n }\n\n // we only want to apply cleanup top level\n if ecx.journal().depth() > 0 {\n return;\n }\n\n // Roll back all previously applied deals\n // This will prevent overflow issues in revm's [`JournaledState::journal_revert`] routine\n // which rolls back any transfers.\n while let Some(record) = self.eth_deals.pop() {\n if let Some(acc) = ecx.journal_mut().evm_state_mut().get_mut(&record.address) {\n acc.info.balance = record.old_balance;\n }\n }\n }\n\n pub fn call_with_executor(\n &mut self,\n ecx: &mut CTX,\n call: &mut CallInputs,\n executor: &mut dyn CheatcodesExecutor,\n ) -> Option {\n // Apply custom execution evm version.\n if let Some(spec_id) = self.execution_evm_version {\n ecx.cfg_mut().set_spec(spec_id);\n }\n\n let gas = Gas::new(call.gas_limit);\n let curr_depth = ecx.journal().depth();\n\n // At the root call to test function or script `run()`/`setUp()` functions, we are\n // decreasing sender nonce to ensure that it matches on-chain nonce once we start\n // broadcasting.\n if curr_depth == 0 {\n let sender = ecx.tx().caller();\n let account = match super::evm::journaled_account(ecx, sender) {\n Ok(account) => account,\n Err(err) => {\n return Some(CallOutcome {\n result: InterpreterResult {\n result: InstructionResult::Revert,\n output: err.abi_encode().into(),\n gas,\n },\n memory_offset: call.return_memory_offset.clone(),\n was_precompile_called: false,\n precompile_call_logs: vec![],\n });\n }\n };\n let prev = account.info.nonce;\n account.info.nonce = prev.saturating_sub(1);\n\n trace!(target: \"cheatcodes\", %sender, nonce=account.info.nonce, prev, \"corrected nonce\");\n }\n\n if call.target_address == CHEATCODE_ADDRESS {\n return match self.apply_cheatcode(ecx, call, executor) {\n Ok(retdata) => Some(CallOutcome {\n result: InterpreterResult {\n result: InstructionResult::Return,\n output: retdata.into(),\n gas,\n },\n memory_offset: call.return_memory_offset.clone(),\n was_precompile_called: true,\n precompile_call_logs: vec![],\n }),\n Err(err) => Some(CallOutcome {\n result: InterpreterResult {\n result: InstructionResult::Revert,\n output: err.abi_encode().into(),\n gas,\n },\n memory_offset: call.return_memory_offset.clone(),\n was_precompile_called: false,\n precompile_call_logs: vec![],\n }),\n };\n }\n\n if call.target_address == HARDHAT_CONSOLE_ADDRESS {\n return None;\n }\n\n // `expectRevert`: track max call depth. This is also done in `initialize_interp`, but\n // precompile calls don't create an interpreter frame so we must also track it here.\n // The callee executes at `curr_depth + 1`.\n if let Some(expected) = &mut self.expected_revert {\n expected.max_depth = max(curr_depth + 1, expected.max_depth);\n }\n\n // Handle expected calls\n\n // Grab the different calldatas expected.\n if let Some(expected_calls_for_target) = self.expected_calls.get_mut(&call.bytecode_address)\n {\n // Match every partial/full calldata\n for (calldata, (expected, actual_count)) in expected_calls_for_target {\n // Increment actual times seen if...\n // The calldata is at most, as big as this call's input, and\n if calldata.len() <= call.input.len() &&\n // Both calldata match, taking the length of the assumed smaller one (which will have at least the selector), and\n *calldata == call.input.bytes(ecx)[..calldata.len()] &&\n // The value matches, if provided\n expected\n .value.is_none_or(|value| Some(value) == call.transfer_value()) &&\n // The gas matches, if provided\n expected.gas.is_none_or(|gas| gas == call.gas_limit) &&\n // The minimum gas matches, if provided\n expected.min_gas.is_none_or(|min_gas| min_gas <= call.gas_limit)\n {\n *actual_count += 1;\n }\n }\n }\n\n // Handle mocked calls\n if let Some(mocks) = self.mocked_calls.get_mut(&call.bytecode_address) {\n let ctx = MockCallDataContext {\n calldata: call.input.bytes(ecx),\n value: call.transfer_value(),\n };\n\n if let Some(return_data_queue) = match mocks.get_mut(&ctx) {\n Some(queue) => Some(queue),\n None => mocks\n .iter_mut()\n .find(|(mock, _)| {\n call.input.bytes(ecx).get(..mock.calldata.len()) == Some(&mock.calldata[..])\n && mock.value.is_none_or(|value| Some(value) == call.transfer_value())\n })\n .map(|(_, v)| v),\n } && let Some(return_data) = if return_data_queue.len() == 1 {\n // If the mocked calls stack has a single element in it, don't empty it\n return_data_queue.front().map(|x| x.to_owned())\n } else {\n // Else, we pop the front element\n return_data_queue.pop_front()\n } {\n return Some(CallOutcome {\n result: InterpreterResult {\n result: return_data.ret_type,\n output: return_data.data,\n gas,\n },\n memory_offset: call.return_memory_offset.clone(),\n was_precompile_called: true,\n precompile_call_logs: vec![],\n });\n }\n }\n\n // Apply our prank\n if let Some(prank) = &self.get_prank(curr_depth) {\n // Apply delegate call, `call.caller`` will not equal `prank.prank_caller`\n if prank.delegate_call\n && curr_depth == prank.depth\n && let CallScheme::DelegateCall = call.scheme\n {\n call.target_address = prank.new_caller;\n call.caller = prank.new_caller;\n if let Some(new_origin) = prank.new_origin {\n ecx.tx_mut().set_caller(new_origin);\n }\n }\n\n if curr_depth >= prank.depth && call.caller == prank.prank_caller {\n let mut prank_applied = false;\n\n // At the target depth we set `msg.sender`\n if curr_depth == prank.depth {\n // Ensure new caller is loaded and touched\n let _ = journaled_account(ecx, prank.new_caller);\n call.caller = prank.new_caller;\n prank_applied = true;\n }\n\n // At the target depth, or deeper, we set `tx.origin`\n if let Some(new_origin) = prank.new_origin {\n ecx.tx_mut().set_caller(new_origin);\n prank_applied = true;\n }\n\n // If prank applied for first time, then update\n if prank_applied && let Some(applied_prank) = prank.first_time_applied() {\n self.pranks.insert(curr_depth, applied_prank);\n }\n }\n }\n\n // Apply EIP-2930 access list\n self.apply_accesslist(ecx);\n\n // Apply our broadcast\n if let Some(broadcast) = &self.broadcast {\n // Additional check as transfers in forge scripts seem to be estimated at 2300\n // by revm leading to \"Intrinsic gas too low\" failure when simulated on chain.\n let is_fixed_gas_limit = call.gas_limit >= 21_000 && !self.dynamic_gas_limit;\n self.dynamic_gas_limit = false;\n\n // We only apply a broadcast *to a specific depth*.\n //\n // We do this because any subsequent contract calls *must* exist on chain and\n // we only want to grab *this* call, not internal ones\n if curr_depth == broadcast.depth && call.caller == broadcast.original_caller {\n // At the target depth we set `msg.sender` & tx.origin.\n // We are simulating the caller as being an EOA, so *both* must be set to the\n // broadcast.origin.\n ecx.tx_mut().set_caller(broadcast.new_origin);\n\n call.caller = broadcast.new_origin;\n // Add a `legacy` transaction to the VecDeque. We use a legacy transaction here\n // because we only need the from, to, value, and data. We can later change this\n // into 1559, in the cli package, relatively easily once we\n // know the target chain supports EIP-1559.\n if !call.is_static {\n if let Err(err) = ecx.journal_mut().load_account(broadcast.new_origin) {\n return Some(CallOutcome {\n result: InterpreterResult {\n result: InstructionResult::Revert,\n output: Error::encode(err),\n gas,\n },\n memory_offset: call.return_memory_offset.clone(),\n was_precompile_called: false,\n precompile_call_logs: vec![],\n });\n }\n\n let input = call.input.bytes(ecx);\n let chain_id = ecx.cfg().chain_id();\n let rpc = ecx.db().active_fork_url();\n let account =\n ecx.journal_mut().evm_state_mut().get_mut(&broadcast.new_origin).unwrap();\n\n let blob_sidecar = self.active_blob_sidecar.take();\n let active_delegations = std::mem::take(&mut self.active_delegations);\n\n // Ensure blob and delegation are not set for the same tx.\n if blob_sidecar.is_some() && !active_delegations.is_empty() {\n let msg = \"both delegation and blob are active; `attachBlob` and `attachDelegation` are not compatible\";\n return Some(CallOutcome {\n result: InterpreterResult {\n result: InstructionResult::Revert,\n output: Error::encode(msg),\n gas,\n },\n memory_offset: call.return_memory_offset.clone(),\n was_precompile_called: false,\n precompile_call_logs: vec![],\n });\n }\n\n // Capture nonce before delegation bump (delegations increment the\n // account nonce but the transaction itself uses the pre-bump nonce).\n let nonce = account.info.nonce;\n\n // Apply active EIP-7702 delegations, if any.\n let authorization_list = if !active_delegations.is_empty() {\n for auth in &active_delegations {\n let Ok(authority) = auth.recover_authority() else {\n continue;\n };\n if authority == broadcast.new_origin {\n // Increment nonce of broadcasting account to reflect signed\n // authorization.\n account.info.nonce += 1;\n }\n }\n Some(active_delegations)\n } else {\n None\n };\n\n self.broadcastable_transactions.push_back(BroadcastableTransaction {\n rpc,\n from: broadcast.new_origin,\n to: Some(TxKind::from(Some(call.target_address))),\n value: call.transfer_value().unwrap_or_default(),\n input,\n nonce,\n gas: if is_fixed_gas_limit { Some(call.gas_limit) } else { None },\n kind: BroadcastKind::Unsigned {\n chain_id: Some(chain_id),\n blob_sidecar,\n authorization_list,\n },\n });\n debug!(target: \"cheatcodes\", tx=?self.broadcastable_transactions.back().unwrap(), \"broadcastable call\");\n\n // Explicitly increment nonce if calls are not isolated.\n if !self.config.evm_opts.isolate {\n let prev = account.info.nonce;\n account.info.nonce += 1;\n debug!(target: \"cheatcodes\", address=%broadcast.new_origin, nonce=prev+1, prev, \"incremented nonce\");\n }\n } else if broadcast.single_call {\n let msg = \"`staticcall`s are not allowed after `broadcast`; use `startBroadcast` instead\";\n return Some(CallOutcome {\n result: InterpreterResult {\n result: InstructionResult::Revert,\n output: Error::encode(msg),\n gas,\n },\n memory_offset: call.return_memory_offset.clone(),\n was_precompile_called: false,\n precompile_call_logs: vec![],\n });\n }\n }\n }\n\n // Record called accounts if `startStateDiffRecording` has been called\n if let Some(recorded_account_diffs_stack) = &mut self.recorded_account_diffs_stack {\n // Determine if account is \"initialized,\" ie, it has a non-zero balance, a non-zero\n // nonce, a non-zero KECCAK_EMPTY codehash, or non-empty code\n let initialized;\n let old_balance;\n let old_nonce;\n\n if let Ok(acc) = ecx.journal_mut().load_account(call.target_address) {\n initialized = acc.data.info.exists();\n old_balance = acc.data.info.balance;\n old_nonce = acc.data.info.nonce;\n } else {\n initialized = false;\n old_balance = U256::ZERO;\n old_nonce = 0;\n }\n\n let kind = match call.scheme {\n CallScheme::Call => crate::Vm::AccountAccessKind::Call,\n CallScheme::CallCode => crate::Vm::AccountAccessKind::CallCode,\n CallScheme::DelegateCall => crate::Vm::AccountAccessKind::DelegateCall,\n CallScheme::StaticCall => crate::Vm::AccountAccessKind::StaticCall,\n };\n\n // Record this call by pushing it to a new pending vector; all subsequent calls at\n // that depth will be pushed to the same vector. When the call ends, the\n // RecordedAccountAccess (and all subsequent RecordedAccountAccesses) will be\n // updated with the revert status of this call, since the EVM does not mark accounts\n // as \"warm\" if the call from which they were accessed is reverted\n recorded_account_diffs_stack.push(vec![AccountAccess {\n chainInfo: crate::Vm::ChainInfo {\n forkId: ecx.db().active_fork_id().unwrap_or_default(),\n chainId: U256::from(ecx.cfg().chain_id()),\n },\n accessor: call.caller,\n account: call.bytecode_address,\n kind,\n initialized,\n oldBalance: old_balance,\n newBalance: U256::ZERO, // updated on call_end\n oldNonce: old_nonce,\n newNonce: 0, // updated on call_end\n value: call.call_value(),\n data: call.input.bytes(ecx),\n reverted: false,\n deployedCode: Bytes::new(),\n storageAccesses: vec![], // updated on step\n depth: ecx.journal().depth().try_into().expect(\"journaled state depth exceeds u64\"),\n }]);\n }\n\n None\n }\n\n pub fn rng(&mut self) -> &mut impl Rng {\n self.test_runner().rng()\n }\n\n pub fn test_runner(&mut self) -> &mut TestRunner {\n self.test_runner.get_or_insert_with(|| match self.config.seed {\n Some(seed) => TestRunner::new_with_rng(\n proptest::test_runner::Config::default(),\n TestRng::from_seed(RngAlgorithm::ChaCha, &seed.to_be_bytes::<32>()),\n ),\n None => TestRunner::new(proptest::test_runner::Config::default()),\n })\n }\n\n pub fn set_seed(&mut self, seed: U256) {\n self.test_runner = Some(TestRunner::new_with_rng(\n proptest::test_runner::Config::default(),\n TestRng::from_seed(RngAlgorithm::ChaCha, &seed.to_be_bytes::<32>()),\n ));\n }\n\n /// Returns existing or set a default `ArbitraryStorage` option.\n /// Used by `setArbitraryStorage` cheatcode to track addresses with arbitrary storage.\n pub fn arbitrary_storage(&mut self) -> &mut ArbitraryStorage {\n self.arbitrary_storage.get_or_insert_with(ArbitraryStorage::default)\n }\n\n /// Whether the given address has arbitrary storage.\n pub fn has_arbitrary_storage(&self, address: &Address) -> bool {\n match &self.arbitrary_storage {\n Some(storage) => storage.values.contains_key(address),\n None => false,\n }\n }\n\n /// Whether the given slot of address with arbitrary storage should be overwritten.\n /// True if address is marked as and overwrite and if no value was previously generated for\n /// given slot.\n pub fn should_overwrite_arbitrary_storage(\n &self,\n address: &Address,\n storage_slot: U256,\n ) -> bool {\n match &self.arbitrary_storage {\n Some(storage) => {\n storage.overwrites.contains(address)\n && storage\n .values\n .get(address)\n .and_then(|arbitrary_values| arbitrary_values.get(&storage_slot))\n .is_none()\n }\n None => false,\n }\n }\n\n /// Whether the given address is a copy of an address with arbitrary storage.\n pub fn is_arbitrary_storage_copy(&self, address: &Address) -> bool {\n match &self.arbitrary_storage {\n Some(storage) => storage.copies.contains_key(address),\n None => false,\n }\n }\n\n /// Returns struct definitions from the analysis, if available.\n pub fn struct_defs(&self) -> Option<&foundry_common::fmt::StructDefinitions> {\n self.analysis.as_ref().and_then(|analysis| analysis.struct_defs().ok())\n }\n}\n\nimpl Inspector for Cheatcodes {\n fn initialize_interp(&mut self, interpreter: &mut Interpreter, ecx: &mut CTX) {\n // When the first interpreter is initialized we've circumvented the balance and gas checks,\n // so we apply our actual block data with the correct fees and all.\n if let Some(block) = self.block.take() {\n ecx.set_block(block);\n }\n if let Some(gas_price) = self.gas_price.take() {\n ecx.tx_mut().set_gas_price(gas_price);\n }\n\n // Record gas for current frame.\n if self.gas_metering.paused {\n self.gas_metering.paused_frames.push(interpreter.gas);\n }\n\n // `expectRevert`: track the max call depth during `expectRevert`\n if let Some(expected) = &mut self.expected_revert {\n expected.max_depth = max(ecx.journal().depth(), expected.max_depth);\n }\n }\n\n fn step(&mut self, interpreter: &mut Interpreter, ecx: &mut CTX) {\n self.pc = interpreter.bytecode.pc();\n\n if self.broadcast.is_some() {\n self.set_gas_limit_type(interpreter);\n }\n\n // `pauseGasMetering`: pause / resume interpreter gas.\n if self.gas_metering.paused {\n self.meter_gas(interpreter);\n }\n\n // `resetGasMetering`: reset interpreter gas.\n if self.gas_metering.reset {\n self.meter_gas_reset(interpreter);\n }\n\n // `record`: record storage reads and writes.\n if self.recording_accesses {\n self.record_accesses(interpreter);\n }\n\n // `startStateDiffRecording`: record granular ordered storage accesses.\n if self.recorded_account_diffs_stack.is_some() {\n self.record_state_diffs(interpreter, ecx);\n }\n\n // `expectSafeMemory`: check if the current opcode is allowed to interact with memory.\n if !self.allowed_mem_writes.is_empty() {\n self.check_mem_opcodes(\n interpreter,\n ecx.journal().depth().try_into().expect(\"journaled state depth exceeds u64\"),\n );\n }\n\n // `startMappingRecording`: record SSTORE and KECCAK256.\n if let Some(mapping_slots) = &mut self.mapping_slots {\n mapping_step(mapping_slots, interpreter);\n }\n\n // `snapshotGas*`: take a snapshot of the current gas.\n if self.gas_metering.recording {\n self.meter_gas_record(interpreter, ecx);\n }\n }\n\n fn step_end(&mut self, interpreter: &mut Interpreter, ecx: &mut CTX) {\n if self.gas_metering.paused {\n self.meter_gas_end(interpreter);\n }\n\n if self.gas_metering.touched {\n self.meter_gas_check(interpreter);\n }\n\n // `setArbitraryStorage` and `copyStorage`: add arbitrary values to storage.\n if self.arbitrary_storage.is_some() {\n self.arbitrary_storage_end(interpreter, ecx);\n }\n }\n\n fn log(&mut self, _ecx: &mut CTX, log: Log) {\n if !self.expected_emits.is_empty()\n && let Some(err) = expect::handle_expect_emit(self, &log, None)\n {\n // Because we do not have access to the interpreter here, we cannot fail the test\n // immediately. In most cases the failure will still be caught on `call_end`.\n // In the rare case it is not, we log the error here.\n let _ = sh_err!(\"{err:?}\");\n }\n\n // `recordLogs`\n record_logs(&mut self.recorded_logs, &log);\n }\n\n fn log_full(&mut self, interpreter: &mut Interpreter, _ecx: &mut CTX, log: Log) {\n if !self.expected_emits.is_empty() {\n expect::handle_expect_emit(self, &log, Some(interpreter));\n }\n\n // `recordLogs`\n record_logs(&mut self.recorded_logs, &log);\n }\n\n fn call(&mut self, ecx: &mut CTX, inputs: &mut CallInputs) -> Option {\n Self::call_with_executor(self, ecx, inputs, &mut TransparentCheatcodesExecutor)\n }\n\n fn call_end(&mut self, ecx: &mut CTX, call: &CallInputs, outcome: &mut CallOutcome) {\n let cheatcode_call = call.target_address == CHEATCODE_ADDRESS\n || call.target_address == HARDHAT_CONSOLE_ADDRESS;\n\n // Clean up pranks/broadcasts if it's not a cheatcode call end. We shouldn't do\n // it for cheatcode calls because they are not applied for cheatcodes in the `call` hook.\n // This should be placed before the revert handling, because we might exit early there\n if !cheatcode_call {\n // Clean up pranks\n let curr_depth = ecx.journal().depth();\n if let Some(prank) = &self.get_prank(curr_depth)\n && curr_depth == prank.depth\n {\n ecx.tx_mut().set_caller(prank.prank_origin);\n\n // Clean single-call prank once we have returned to the original depth\n if prank.single_call {\n self.pranks.remove(&curr_depth);\n }\n }\n\n // Clean up broadcast\n if let Some(broadcast) = &self.broadcast\n && curr_depth == broadcast.depth\n {\n ecx.tx_mut().set_caller(broadcast.original_origin);\n\n // Clean single-call broadcast once we have returned to the original depth\n if broadcast.single_call {\n let _ = self.broadcast.take();\n }\n }\n }\n\n // Handle assume no revert cheatcode.\n if let Some(assume_no_revert) = &mut self.assume_no_revert {\n // Record current reverter address before processing the expect revert if call reverted,\n // expect revert is set with expected reverter address and no actual reverter set yet.\n if outcome.result.is_revert() && assume_no_revert.reverted_by.is_none() {\n assume_no_revert.reverted_by = Some(call.target_address);\n }\n\n // allow multiple cheatcode calls at the same depth\n let curr_depth = ecx.journal().depth();\n if curr_depth <= assume_no_revert.depth && !cheatcode_call {\n // Discard run if we're at the same depth as cheatcode, call reverted, and no\n // specific reason was supplied\n if outcome.result.is_revert() {\n let assume_no_revert = std::mem::take(&mut self.assume_no_revert).unwrap();\n return match revert_handlers::handle_assume_no_revert(\n &assume_no_revert,\n outcome.result.result,\n &outcome.result.output,\n &self.config.available_artifacts,\n ) {\n // if result is Ok, it was an anticipated revert; return an \"assume\" error\n // to reject this run\n Ok(_) => {\n outcome.result.output = Error::from(MAGIC_ASSUME).abi_encode().into();\n }\n // if result is Error, it was an unanticipated revert; should revert\n // normally\n Err(error) => {\n trace!(expected=?assume_no_revert, ?error, status=?outcome.result.result, \"Expected revert mismatch\");\n outcome.result.result = InstructionResult::Revert;\n outcome.result.output = error.abi_encode().into();\n }\n };\n } else {\n // Call didn't revert, reset `assume_no_revert` state.\n self.assume_no_revert = None;\n }\n }\n }\n\n // Handle expected reverts.\n if let Some(expected_revert) = &mut self.expected_revert {\n // Record current reverter address and call scheme before processing the expect revert\n // if call reverted.\n if outcome.result.is_revert() {\n // Record current reverter address if expect revert is set with expected reverter\n // address and no actual reverter was set yet or if we're expecting more than one\n // revert.\n if expected_revert.reverter.is_some()\n && (expected_revert.reverted_by.is_none() || expected_revert.count > 1)\n {\n expected_revert.reverted_by = Some(call.target_address);\n }\n }\n\n let curr_depth = ecx.journal().depth();\n if curr_depth <= expected_revert.depth {\n let needs_processing = match expected_revert.kind {\n ExpectedRevertKind::Default => !cheatcode_call,\n // `pending_processing` == true means that we're in the `call_end` hook for\n // `vm.expectCheatcodeRevert` and shouldn't expect revert here\n ExpectedRevertKind::Cheatcode { pending_processing } => {\n cheatcode_call && !pending_processing\n }\n };\n\n if needs_processing {\n let mut expected_revert = std::mem::take(&mut self.expected_revert).unwrap();\n return match revert_handlers::handle_expect_revert(\n cheatcode_call,\n false,\n self.config.internal_expect_revert,\n &expected_revert,\n outcome.result.result,\n outcome.result.output.clone(),\n &self.config.available_artifacts,\n ) {\n Err(error) => {\n trace!(expected=?expected_revert, ?error, status=?outcome.result.result, \"Expected revert mismatch\");\n outcome.result.result = InstructionResult::Revert;\n outcome.result.output = error.abi_encode().into();\n }\n Ok((_, retdata)) => {\n expected_revert.actual_count += 1;\n if expected_revert.actual_count < expected_revert.count {\n self.expected_revert = Some(expected_revert);\n }\n outcome.result.result = InstructionResult::Return;\n outcome.result.output = retdata;\n }\n };\n }\n\n // Flip `pending_processing` flag for cheatcode revert expectations, marking that\n // we've exited the `expectCheatcodeRevert` call scope\n if let ExpectedRevertKind::Cheatcode { pending_processing } =\n &mut self.expected_revert.as_mut().unwrap().kind\n {\n *pending_processing = false;\n }\n }\n }\n\n // Exit early for calls to cheatcodes as other logic is not relevant for cheatcode\n // invocations\n if cheatcode_call {\n return;\n }\n\n // Record the gas usage of the call, this allows the `lastCallGas` cheatcode to\n // retrieve the gas usage of the last call.\n let gas = outcome.result.gas;\n self.gas_metering.last_call_gas = Some(crate::Vm::Gas {\n gasLimit: gas.limit(),\n gasTotalUsed: gas.spent(),\n gasMemoryUsed: 0,\n gasRefunded: gas.refunded(),\n gasRemaining: gas.remaining(),\n });\n\n // If `startStateDiffRecording` has been called, update the `reverted` status of the\n // previous call depth's recorded accesses, if any\n if let Some(recorded_account_diffs_stack) = &mut self.recorded_account_diffs_stack {\n // The root call cannot be recorded.\n if ecx.journal().depth() > 0\n && let Some(mut last_recorded_depth) = recorded_account_diffs_stack.pop()\n {\n // Update the reverted status of all deeper calls if this call reverted, in\n // accordance with EVM behavior\n if outcome.result.is_revert() {\n last_recorded_depth.iter_mut().for_each(|element| {\n element.reverted = true;\n element\n .storageAccesses\n .iter_mut()\n .for_each(|storage_access| storage_access.reverted = true);\n })\n }\n\n if let Some(call_access) = last_recorded_depth.first_mut() {\n // Assert that we're at the correct depth before recording post-call state\n // changes. Depending on the depth the cheat was\n // called at, there may not be any pending\n // calls to update if execution has percolated up to a higher depth.\n let curr_depth = ecx.journal().depth();\n if call_access.depth == curr_depth as u64\n && let Ok(acc) = ecx.journal_mut().load_account(call.target_address)\n {\n debug_assert!(access_is_call(call_access.kind));\n call_access.newBalance = acc.data.info.balance;\n call_access.newNonce = acc.data.info.nonce;\n }\n // Merge the last depth's AccountAccesses into the AccountAccesses at the\n // current depth, or push them back onto the pending\n // vector if higher depths were not recorded. This\n // preserves ordering of accesses.\n if let Some(last) = recorded_account_diffs_stack.last_mut() {\n last.extend(last_recorded_depth);\n } else {\n recorded_account_diffs_stack.push(last_recorded_depth);\n }\n }\n }\n }\n\n // At the end of the call,\n // we need to check if we've found all the emits.\n // We know we've found all the expected emits in the right order\n // if the queue is fully matched.\n // If it's not fully matched, then either:\n // 1. Not enough events were emitted (we'll know this because the amount of times we\n // inspected events will be less than the size of the queue) 2. The wrong events\n // were emitted (The inspected events should match the size of the queue, but still some\n // events will not be matched)\n\n // First, check that we're at the call depth where the emits were declared from.\n let should_check_emits = self\n .expected_emits\n .iter()\n .any(|(expected, _)| {\n let curr_depth = ecx.journal().depth();\n expected.depth == curr_depth\n }) &&\n // Ignore staticcalls\n !call.is_static;\n if should_check_emits {\n let expected_counts = self\n .expected_emits\n .iter()\n .filter_map(|(expected, count_map)| {\n let count = match expected.address {\n Some(emitter) => match count_map.get(&emitter) {\n Some(log_count) => expected\n .log\n .as_ref()\n .map(|l| log_count.count(l))\n .unwrap_or_else(|| log_count.count_unchecked()),\n None => 0,\n },\n None => match &expected.log {\n Some(log) => count_map.values().map(|logs| logs.count(log)).sum(),\n None => count_map.values().map(|logs| logs.count_unchecked()).sum(),\n },\n };\n\n if count != expected.count { Some((expected, count)) } else { None }\n })\n .collect::>();\n\n // Revert if not all emits expected were matched.\n if let Some((expected, _)) = self\n .expected_emits\n .iter()\n .find(|(expected, _)| !expected.found && expected.count > 0)\n {\n outcome.result.result = InstructionResult::Revert;\n let error_msg = expected.mismatch_error.as_deref().unwrap_or(\"log != expected log\");\n outcome.result.output = error_msg.abi_encode().into();\n return;\n }\n\n if !expected_counts.is_empty() {\n let msg = if outcome.result.is_ok() {\n let (expected, count) = expected_counts.first().unwrap();\n format!(\"log emitted {count} times, expected {}\", expected.count)\n } else {\n \"expected an emit, but the call reverted instead. \\\n ensure you're testing the happy path when using `expectEmit`\"\n .to_string()\n };\n\n outcome.result.result = InstructionResult::Revert;\n outcome.result.output = Error::encode(msg);\n return;\n }\n\n // All emits were found, we're good.\n // Clear the queue, as we expect the user to declare more events for the next call\n // if they wanna match further events.\n self.expected_emits.clear()\n }\n\n // this will ensure we don't have false positives when trying to diagnose reverts in fork\n // mode\n let diag = self.fork_revert_diagnostic.take();\n\n // if there's a revert and a previous call was diagnosed as fork related revert then we can\n // return a better error here\n if outcome.result.is_revert()\n && let Some(err) = diag\n {\n outcome.result.output = Error::encode(err.to_error_msg(&self.labels));\n return;\n }\n\n // try to diagnose reverts in multi-fork mode where a call is made to an address that does\n // not exist\n if let TxKind::Call(test_contract) = ecx.tx().kind() {\n // if a call to a different contract than the original test contract returned with\n // `Stop` we check if the contract actually exists on the active fork\n if ecx.db().is_forked_mode()\n && outcome.result.result == InstructionResult::Stop\n && call.target_address != test_contract\n {\n self.fork_revert_diagnostic =\n ecx.db().diagnose_revert(call.target_address, ecx.journal().evm_state());\n }\n }\n\n // If the depth is 0, then this is the root call terminating\n if ecx.journal().depth() == 0 {\n // If we already have a revert, we shouldn't run the below logic as it can obfuscate an\n // earlier error that happened first with unrelated information about\n // another error when using cheatcodes.\n if outcome.result.is_revert() {\n return;\n }\n\n // If there's not a revert, we can continue on to run the last logic for expect*\n // cheatcodes.\n\n // Match expected calls\n for (address, calldatas) in &self.expected_calls {\n // Loop over each address, and for each address, loop over each calldata it expects.\n for (calldata, (expected, actual_count)) in calldatas {\n // Grab the values we expect to see\n let ExpectedCallData { gas, min_gas, value, count, call_type } = expected;\n\n let failed = match call_type {\n // If the cheatcode was called with a `count` argument,\n // we must check that the EVM performed a CALL with this calldata exactly\n // `count` times.\n ExpectedCallType::Count => *count != *actual_count,\n // If the cheatcode was called without a `count` argument,\n // we must check that the EVM performed a CALL with this calldata at least\n // `count` times. The amount of times to check was\n // the amount of time the cheatcode was called.\n ExpectedCallType::NonCount => *count > *actual_count,\n };\n if failed {\n let expected_values = [\n Some(format!(\"data {}\", hex::encode_prefixed(calldata))),\n value.as_ref().map(|v| format!(\"value {v}\")),\n gas.map(|g| format!(\"gas {g}\")),\n min_gas.map(|g| format!(\"minimum gas {g}\")),\n ]\n .into_iter()\n .flatten()\n .join(\", \");\n let but = if outcome.result.is_ok() {\n let s = if *actual_count == 1 { \"\" } else { \"s\" };\n format!(\"was called {actual_count} time{s}\")\n } else {\n \"the call reverted instead; \\\n ensure you're testing the happy path when using `expectCall`\"\n .to_string()\n };\n let s = if *count == 1 { \"\" } else { \"s\" };\n let msg = format!(\n \"expected call to {address} with {expected_values} \\\n to be called {count} time{s}, but {but}\"\n );\n outcome.result.result = InstructionResult::Revert;\n outcome.result.output = Error::encode(msg);\n\n return;\n }\n }\n }\n\n // Check if we have any leftover expected emits\n // First, if any emits were found at the root call, then we its ok and we remove them.\n // For count=0 expectations, NOT being found is success, so mark them as found\n for (expected, _) in &mut self.expected_emits {\n if expected.count == 0 && !expected.found {\n expected.found = true;\n }\n }\n self.expected_emits.retain(|(expected, _)| !expected.found);\n // If not empty, we got mismatched emits\n if !self.expected_emits.is_empty() {\n let msg = if outcome.result.is_ok() {\n \"expected an emit, but no logs were emitted afterwards. \\\n you might have mismatched events or not enough events were emitted\"\n } else {\n \"expected an emit, but the call reverted instead. \\\n ensure you're testing the happy path when using `expectEmit`\"\n };\n outcome.result.result = InstructionResult::Revert;\n outcome.result.output = Error::encode(msg);\n return;\n }\n\n // Check for leftover expected creates\n if let Some(expected_create) = self.expected_creates.first() {\n let msg = format!(\n \"expected {} call by address {} for bytecode {} but not found\",\n expected_create.create_scheme,\n hex::encode_prefixed(expected_create.deployer),\n hex::encode_prefixed(&expected_create.bytecode),\n );\n outcome.result.result = InstructionResult::Revert;\n outcome.result.output = Error::encode(msg);\n }\n }\n }\n\n fn create(&mut self, ecx: &mut CTX, mut input: &mut CreateInputs) -> Option {\n // Apply custom execution evm version.\n if let Some(spec_id) = self.execution_evm_version {\n ecx.cfg_mut().set_spec(spec_id);\n }\n\n let gas = Gas::new(input.gas_limit());\n // Check if we should intercept this create\n if self.intercept_next_create_call {\n // Reset the flag\n self.intercept_next_create_call = false;\n\n // Get initcode from the input\n let output = input.init_code();\n\n // Return a revert with the initcode as error data\n return Some(CreateOutcome {\n result: InterpreterResult { result: InstructionResult::Revert, output, gas },\n address: None,\n });\n }\n\n let curr_depth = ecx.journal().depth();\n\n // Apply our prank\n if let Some(prank) = &self.get_prank(curr_depth)\n && curr_depth >= prank.depth\n && input.caller() == prank.prank_caller\n {\n let mut prank_applied = false;\n\n // At the target depth we set `msg.sender`\n if curr_depth == prank.depth {\n // Ensure new caller is loaded and touched\n let _ = journaled_account(ecx, prank.new_caller);\n input.set_caller(prank.new_caller);\n prank_applied = true;\n }\n\n // At the target depth, or deeper, we set `tx.origin`\n if let Some(new_origin) = prank.new_origin {\n ecx.tx_mut().set_caller(new_origin);\n prank_applied = true;\n }\n\n // If prank applied for first time, then update\n if prank_applied && let Some(applied_prank) = prank.first_time_applied() {\n self.pranks.insert(curr_depth, applied_prank);\n }\n }\n\n // Apply EIP-2930 access list\n self.apply_accesslist(ecx);\n\n // Apply our broadcast\n if let Some(broadcast) = &mut self.broadcast\n && curr_depth >= broadcast.depth\n && input.caller() == broadcast.original_caller\n {\n if let Err(err) = ecx.journal_mut().load_account(broadcast.new_origin) {\n return Some(CreateOutcome {\n result: InterpreterResult {\n result: InstructionResult::Revert,\n output: Error::encode(err),\n gas,\n },\n address: None,\n });\n }\n\n ecx.tx_mut().set_caller(broadcast.new_origin);\n\n if curr_depth == broadcast.depth || broadcast.deploy_from_code {\n // Reset deploy from code flag for upcoming calls;\n broadcast.deploy_from_code = false;\n\n input.set_caller(broadcast.new_origin);\n\n let rpc = ecx.db().active_fork_url();\n let account = &ecx.journal().evm_state()[&broadcast.new_origin];\n self.broadcastable_transactions.push_back(BroadcastableTransaction {\n rpc,\n from: broadcast.new_origin,\n to: None,\n value: input.value(),\n input: input.init_code(),\n nonce: account.info.nonce,\n gas: None,\n kind: BroadcastKind::unsigned(),\n });\n\n input.log_debug(self, &input.scheme().unwrap_or(CreateScheme::Create));\n }\n }\n\n // Allow cheatcodes from the address of the new contract\n let address = input.allow_cheatcodes(self, ecx);\n\n // If `recordAccountAccesses` has been called, record the create\n if let Some(recorded_account_diffs_stack) = &mut self.recorded_account_diffs_stack {\n recorded_account_diffs_stack.push(vec![AccountAccess {\n chainInfo: crate::Vm::ChainInfo {\n forkId: ecx.db().active_fork_id().unwrap_or_default(),\n chainId: U256::from(ecx.cfg().chain_id()),\n },\n accessor: input.caller(),\n account: address,\n kind: crate::Vm::AccountAccessKind::Create,\n initialized: true,\n oldBalance: U256::ZERO, // updated on create_end\n newBalance: U256::ZERO, // updated on create_end\n oldNonce: 0, // new contract starts with nonce 0\n newNonce: 1, // updated on create_end (contracts start with nonce 1)\n value: input.value(),\n data: input.init_code(),\n reverted: false,\n deployedCode: Bytes::new(), // updated on create_end\n storageAccesses: vec![], // updated on create_end\n depth: curr_depth as u64,\n }]);\n }\n\n None\n }\n\n fn create_end(&mut self, ecx: &mut CTX, call: &CreateInputs, outcome: &mut CreateOutcome) {\n let call = Some(call);\n let curr_depth = ecx.journal().depth();\n\n // Clean up pranks\n if let Some(prank) = &self.get_prank(curr_depth)\n && curr_depth == prank.depth\n {\n ecx.tx_mut().set_caller(prank.prank_origin);\n\n // Clean single-call prank once we have returned to the original depth\n if prank.single_call {\n std::mem::take(&mut self.pranks);\n }\n }\n\n // Clean up broadcasts\n if let Some(broadcast) = &self.broadcast\n && curr_depth == broadcast.depth\n {\n ecx.tx_mut().set_caller(broadcast.original_origin);\n\n // Clean single-call broadcast once we have returned to the original depth\n if broadcast.single_call {\n std::mem::take(&mut self.broadcast);\n }\n }\n\n // Handle expected reverts\n if let Some(expected_revert) = &self.expected_revert\n && curr_depth <= expected_revert.depth\n && matches!(expected_revert.kind, ExpectedRevertKind::Default)\n {\n let mut expected_revert = std::mem::take(&mut self.expected_revert).unwrap();\n return match revert_handlers::handle_expect_revert(\n false,\n true,\n self.config.internal_expect_revert,\n &expected_revert,\n outcome.result.result,\n outcome.result.output.clone(),\n &self.config.available_artifacts,\n ) {\n Ok((address, retdata)) => {\n expected_revert.actual_count += 1;\n if expected_revert.actual_count < expected_revert.count {\n self.expected_revert = Some(expected_revert.clone());\n }\n\n outcome.result.result = InstructionResult::Return;\n outcome.result.output = retdata;\n outcome.address = address;\n }\n Err(err) => {\n outcome.result.result = InstructionResult::Revert;\n outcome.result.output = err.abi_encode().into();\n }\n };\n }\n\n // If `startStateDiffRecording` has been called, update the `reverted` status of the\n // previous call depth's recorded accesses, if any\n if let Some(recorded_account_diffs_stack) = &mut self.recorded_account_diffs_stack {\n // The root call cannot be recorded.\n if curr_depth > 0\n && let Some(last_depth) = &mut recorded_account_diffs_stack.pop()\n {\n // Update the reverted status of all deeper calls if this call reverted, in\n // accordance with EVM behavior\n if outcome.result.is_revert() {\n last_depth.iter_mut().for_each(|element| {\n element.reverted = true;\n element\n .storageAccesses\n .iter_mut()\n .for_each(|storage_access| storage_access.reverted = true);\n })\n }\n\n if let Some(create_access) = last_depth.first_mut() {\n // Assert that we're at the correct depth before recording post-create state\n // changes. Depending on what depth the cheat was called at, there\n // may not be any pending calls to update if execution has\n // percolated up to a higher depth.\n let depth = ecx.journal().depth();\n if create_access.depth == depth as u64 {\n debug_assert_eq!(\n create_access.kind as u8,\n crate::Vm::AccountAccessKind::Create as u8\n );\n if let Some(address) = outcome.address\n && let Ok(created_acc) = ecx.journal_mut().load_account(address)\n {\n create_access.newBalance = created_acc.data.info.balance;\n create_access.newNonce = created_acc.data.info.nonce;\n create_access.deployedCode = created_acc\n .data\n .info\n .code\n .clone()\n .unwrap_or_default()\n .original_bytes();\n }\n }\n // Merge the last depth's AccountAccesses into the AccountAccesses at the\n // current depth, or push them back onto the pending\n // vector if higher depths were not recorded. This\n // preserves ordering of accesses.\n if let Some(last) = recorded_account_diffs_stack.last_mut() {\n last.append(last_depth);\n } else {\n recorded_account_diffs_stack.push(last_depth.clone());\n }\n }\n }\n }\n\n // Match the create against expected_creates\n if !self.expected_creates.is_empty()\n && let (Some(address), Some(call)) = (outcome.address, call)\n && let Ok(created_acc) = ecx.journal_mut().load_account(address)\n {\n let bytecode = created_acc.data.info.code.clone().unwrap_or_default().original_bytes();\n if let Some((index, _)) =\n self.expected_creates.iter().find_position(|expected_create| {\n expected_create.deployer == call.caller()\n && expected_create.create_scheme.eq(call.scheme().into())\n && expected_create.bytecode == bytecode\n })\n {\n self.expected_creates.swap_remove(index);\n }\n }\n }\n}\n\nimpl FoundryInspectorExt for Cheatcodes {\n fn should_use_create2_factory(&mut self, depth: usize, inputs: &CreateInputs) -> bool {\n if let CreateScheme::Create2 { .. } = inputs.scheme() {\n let target_depth = if let Some(prank) = &self.get_prank(depth) {\n prank.depth\n } else if let Some(broadcast) = &self.broadcast {\n broadcast.depth\n } else {\n 1\n };\n\n depth == target_depth\n && (self.broadcast.is_some() || self.config.always_use_create_2_factory)\n } else {\n false\n }\n }\n\n fn create2_deployer(&self) -> Address {\n self.config.evm_opts.create2_deployer\n }\n}\n\nimpl Cheatcodes {\n #[cold]\n fn meter_gas(&mut self, interpreter: &mut Interpreter) {\n if let Some(paused_gas) = self.gas_metering.paused_frames.last() {\n // Keep gas constant if paused.\n // Make sure we record the memory changes so that memory expansion is not paused.\n let memory = *interpreter.gas.memory();\n interpreter.gas = *paused_gas;\n interpreter.gas.memory_mut().words_num = memory.words_num;\n interpreter.gas.memory_mut().expansion_cost = memory.expansion_cost;\n } else {\n // Record frame paused gas.\n self.gas_metering.paused_frames.push(interpreter.gas);\n }\n }\n\n #[cold]\n fn meter_gas_record(&mut self, interpreter: &mut Interpreter, ecx: &mut CTX) {\n if interpreter.bytecode.action.as_ref().and_then(|i| i.instruction_result()).is_none() {\n self.gas_metering.gas_records.iter_mut().for_each(|record| {\n let curr_depth = ecx.journal().depth();\n if curr_depth == record.depth {\n // Skip the first opcode of the first call frame as it includes the gas cost of\n // creating the snapshot.\n if self.gas_metering.last_gas_used != 0 {\n let gas_diff =\n interpreter.gas.spent().saturating_sub(self.gas_metering.last_gas_used);\n record.gas_used = record.gas_used.saturating_add(gas_diff);\n }\n\n // Update `last_gas_used` to the current spent gas for the next iteration to\n // compare against.\n self.gas_metering.last_gas_used = interpreter.gas.spent();\n }\n });\n }\n }\n\n #[cold]\n fn meter_gas_end(&mut self, interpreter: &mut Interpreter) {\n // Remove recorded gas if we exit frame.\n if let Some(interpreter_action) = interpreter.bytecode.action.as_ref()\n && will_exit(interpreter_action)\n {\n self.gas_metering.paused_frames.pop();\n }\n }\n\n #[cold]\n fn meter_gas_reset(&mut self, interpreter: &mut Interpreter) {\n let mut gas = Gas::new(interpreter.gas.limit());\n gas.memory_mut().words_num = interpreter.gas.memory().words_num;\n gas.memory_mut().expansion_cost = interpreter.gas.memory().expansion_cost;\n interpreter.gas = gas;\n self.gas_metering.reset = false;\n }\n\n #[cold]\n fn meter_gas_check(&mut self, interpreter: &mut Interpreter) {\n if let Some(interpreter_action) = interpreter.bytecode.action.as_ref()\n && will_exit(interpreter_action)\n {\n // Reset gas if spent is less than refunded.\n // This can happen if gas was paused / resumed or reset.\n // https://github.com/foundry-rs/foundry/issues/4370\n if interpreter.gas.spent()\n < u64::try_from(interpreter.gas.refunded()).unwrap_or_default()\n {\n interpreter.gas = Gas::new(interpreter.gas.limit());\n }\n }\n }\n\n /// Generates or copies arbitrary values for storage slots.\n /// Invoked in inspector `step_end` (when the current opcode is not executed), if current opcode\n /// to execute is `SLOAD` and storage slot is cold.\n /// Ensures that in next step (when `SLOAD` opcode is executed) an arbitrary value is returned:\n /// - copies the existing arbitrary storage value (or the new generated one if no value in\n /// cache) from mapped source address to the target address.\n /// - generates arbitrary value and saves it in target address storage.\n #[cold]\n fn arbitrary_storage_end(\n &mut self,\n interpreter: &mut Interpreter,\n ecx: &mut CTX,\n ) {\n let (key, target_address) = if interpreter.bytecode.opcode() == op::SLOAD {\n (try_or_return!(interpreter.stack.peek(0)), interpreter.input.target_address)\n } else {\n return;\n };\n\n let Some(value) = ecx.sload(target_address, key) else {\n return;\n };\n\n if (value.is_cold && value.data.is_zero())\n || self.should_overwrite_arbitrary_storage(&target_address, key)\n {\n if self.has_arbitrary_storage(&target_address) {\n let arbitrary_value = self.rng().random();\n self.arbitrary_storage.as_mut().unwrap().save(\n ecx,\n target_address,\n key,\n arbitrary_value,\n );\n } else if self.is_arbitrary_storage_copy(&target_address) {\n let arbitrary_value = self.rng().random();\n self.arbitrary_storage.as_mut().unwrap().copy(\n ecx,\n target_address,\n key,\n arbitrary_value,\n );\n }\n }\n }\n\n /// Records storage slots reads and writes.\n #[cold]\n fn record_accesses(&mut self, interpreter: &mut Interpreter) {\n let access = &mut self.accesses;\n match interpreter.bytecode.opcode() {\n op::SLOAD => {\n let key = try_or_return!(interpreter.stack.peek(0));\n access.record_read(interpreter.input.target_address, key);\n }\n op::SSTORE => {\n let key = try_or_return!(interpreter.stack.peek(0));\n access.record_write(interpreter.input.target_address, key);\n }\n _ => {}\n }\n }\n\n #[cold]\n fn record_state_diffs>(\n &mut self,\n interpreter: &mut Interpreter,\n ecx: &mut CTX,\n ) {\n let Some(account_accesses) = &mut self.recorded_account_diffs_stack else { return };\n match interpreter.bytecode.opcode() {\n op::SELFDESTRUCT => {\n // Ensure that we're not selfdestructing a context recording was initiated on\n let Some(last) = account_accesses.last_mut() else { return };\n\n // get previous balance, nonce and initialized status of the target account\n let target = try_or_return!(interpreter.stack.peek(0));\n let target = Address::from_word(B256::from(target));\n let (initialized, old_balance, old_nonce) = ecx\n .journal_mut()\n .load_account(target)\n .map(|account| {\n (\n account.data.info.exists(),\n account.data.info.balance,\n account.data.info.nonce,\n )\n })\n .unwrap_or_default();\n\n // load balance of this account\n let value = ecx\n .balance(interpreter.input.target_address)\n .map(|b| b.data)\n .unwrap_or(U256::ZERO);\n\n // register access for the target account\n last.push(crate::Vm::AccountAccess {\n chainInfo: crate::Vm::ChainInfo {\n forkId: ecx.db().active_fork_id().unwrap_or_default(),\n chainId: U256::from(ecx.cfg().chain_id()),\n },\n accessor: interpreter.input.target_address,\n account: target,\n kind: crate::Vm::AccountAccessKind::SelfDestruct,\n initialized,\n oldBalance: old_balance,\n newBalance: old_balance + value,\n oldNonce: old_nonce,\n newNonce: old_nonce, // nonce doesn't change on selfdestruct\n value,\n data: Bytes::new(),\n reverted: false,\n deployedCode: Bytes::new(),\n storageAccesses: vec![],\n depth: ecx\n .journal()\n .depth()\n .try_into()\n .expect(\"journaled state depth exceeds u64\"),\n });\n }\n\n op::SLOAD => {\n let Some(last) = account_accesses.last_mut() else { return };\n\n let key = try_or_return!(interpreter.stack.peek(0));\n let address = interpreter.input.target_address;\n\n // Try to include present value for informational purposes, otherwise assume\n // it's not set (zero value)\n let mut present_value = U256::ZERO;\n // Try to load the account and the slot's present value\n if ecx.journal_mut().load_account(address).is_ok()\n && let Some(previous) = ecx.sload(address, key)\n {\n present_value = previous.data;\n }\n let access = crate::Vm::StorageAccess {\n account: interpreter.input.target_address,\n slot: key.into(),\n isWrite: false,\n previousValue: present_value.into(),\n newValue: present_value.into(),\n reverted: false,\n };\n let curr_depth =\n ecx.journal().depth().try_into().expect(\"journaled state depth exceeds u64\");\n append_storage_access(last, access, curr_depth);\n }\n op::SSTORE => {\n let Some(last) = account_accesses.last_mut() else { return };\n\n let key = try_or_return!(interpreter.stack.peek(0));\n let value = try_or_return!(interpreter.stack.peek(1));\n let address = interpreter.input.target_address;\n // Try to load the account and the slot's previous value, otherwise, assume it's\n // not set (zero value)\n let mut previous_value = U256::ZERO;\n if ecx.journal_mut().load_account(address).is_ok()\n && let Some(previous) = ecx.sload(address, key)\n {\n previous_value = previous.data;\n }\n\n let access = crate::Vm::StorageAccess {\n account: address,\n slot: key.into(),\n isWrite: true,\n previousValue: previous_value.into(),\n newValue: value.into(),\n reverted: false,\n };\n let curr_depth =\n ecx.journal().depth().try_into().expect(\"journaled state depth exceeds u64\");\n append_storage_access(last, access, curr_depth);\n }\n\n // Record account accesses via the EXT family of opcodes\n op::EXTCODECOPY | op::EXTCODESIZE | op::EXTCODEHASH | op::BALANCE => {\n let kind = match interpreter.bytecode.opcode() {\n op::EXTCODECOPY => crate::Vm::AccountAccessKind::Extcodecopy,\n op::EXTCODESIZE => crate::Vm::AccountAccessKind::Extcodesize,\n op::EXTCODEHASH => crate::Vm::AccountAccessKind::Extcodehash,\n op::BALANCE => crate::Vm::AccountAccessKind::Balance,\n _ => unreachable!(),\n };\n let address =\n Address::from_word(B256::from(try_or_return!(interpreter.stack.peek(0))));\n let initialized;\n let balance;\n let nonce;\n if let Ok(acc) = ecx.journal_mut().load_account(address) {\n initialized = acc.data.info.exists();\n balance = acc.data.info.balance;\n nonce = acc.data.info.nonce;\n } else {\n initialized = false;\n balance = U256::ZERO;\n nonce = 0;\n }\n let curr_depth =\n ecx.journal().depth().try_into().expect(\"journaled state depth exceeds u64\");\n let account_access = crate::Vm::AccountAccess {\n chainInfo: crate::Vm::ChainInfo {\n forkId: ecx.db().active_fork_id().unwrap_or_default(),\n chainId: U256::from(ecx.cfg().chain_id()),\n },\n accessor: interpreter.input.target_address,\n account: address,\n kind,\n initialized,\n oldBalance: balance,\n newBalance: balance,\n oldNonce: nonce,\n newNonce: nonce, // EXT* operations don't change nonce\n value: U256::ZERO,\n data: Bytes::new(),\n reverted: false,\n deployedCode: Bytes::new(),\n storageAccesses: vec![],\n depth: curr_depth,\n };\n // Record the EXT* call as an account access at the current depth\n // (future storage accesses will be recorded in a new \"Resume\" context)\n if let Some(last) = account_accesses.last_mut() {\n last.push(account_access);\n } else {\n account_accesses.push(vec![account_access]);\n }\n }\n _ => {}\n }\n }\n\n /// Checks to see if the current opcode can either mutate directly or expand memory.\n ///\n /// If the opcode at the current program counter is a match, check if the modified memory lies\n /// within the allowed ranges. If not, revert and fail the test.\n #[cold]\n fn check_mem_opcodes(&self, interpreter: &mut Interpreter, depth: u64) {\n let Some(ranges) = self.allowed_mem_writes.get(&depth) else {\n return;\n };\n\n // The `mem_opcode_match` macro is used to match the current opcode against a list of\n // opcodes that can mutate memory (either directly or expansion via reading). If the\n // opcode is a match, the memory offsets that are being written to are checked to be\n // within the allowed ranges. If not, the test is failed and the transaction is\n // reverted. For all opcodes that can mutate memory aside from MSTORE,\n // MSTORE8, and MLOAD, the size and destination offset are on the stack, and\n // the macro expands all of these cases. For MSTORE, MSTORE8, and MLOAD, the\n // size of the memory write is implicit, so these cases are hard-coded.\n macro_rules! mem_opcode_match {\n ($(($opcode:ident, $offset_depth:expr, $size_depth:expr, $writes:expr)),* $(,)?) => {\n match interpreter.bytecode.opcode() {\n ////////////////////////////////////////////////////////////////\n // OPERATIONS THAT CAN EXPAND/MUTATE MEMORY BY WRITING //\n ////////////////////////////////////////////////////////////////\n\n op::MSTORE => {\n // The offset of the mstore operation is at the top of the stack.\n let offset = try_or_return!(interpreter.stack.peek(0)).saturating_to::();\n\n // If none of the allowed ranges contain [offset, offset + 32), memory has been\n // unexpectedly mutated.\n if !ranges.iter().any(|range| {\n range.contains(&offset) && range.contains(&(offset + 31))\n }) {\n // SPECIAL CASE: When the compiler attempts to store the selector for\n // `stopExpectSafeMemory`, this is allowed. It will do so at the current free memory\n // pointer, which could have been updated to the exclusive upper bound during\n // execution.\n let value = try_or_return!(interpreter.stack.peek(1)).to_be_bytes::<32>();\n if value[..SELECTOR_LEN] == stopExpectSafeMemoryCall::SELECTOR {\n return\n }\n\n disallowed_mem_write(offset, 32, interpreter, ranges);\n return\n }\n }\n op::MSTORE8 => {\n // The offset of the mstore8 operation is at the top of the stack.\n let offset = try_or_return!(interpreter.stack.peek(0)).saturating_to::();\n\n // If none of the allowed ranges contain the offset, memory has been\n // unexpectedly mutated.\n if !ranges.iter().any(|range| range.contains(&offset)) {\n disallowed_mem_write(offset, 1, interpreter, ranges);\n return\n }\n }\n\n ////////////////////////////////////////////////////////////////\n // OPERATIONS THAT CAN EXPAND MEMORY BY READING //\n ////////////////////////////////////////////////////////////////\n\n op::MLOAD => {\n // The offset of the mload operation is at the top of the stack\n let offset = try_or_return!(interpreter.stack.peek(0)).saturating_to::();\n\n // If the offset being loaded is >= than the memory size, the\n // memory is being expanded. If none of the allowed ranges contain\n // [offset, offset + 32), memory has been unexpectedly mutated.\n if offset >= interpreter.memory.size() as u64 && !ranges.iter().any(|range| {\n range.contains(&offset) && range.contains(&(offset + 31))\n }) {\n disallowed_mem_write(offset, 32, interpreter, ranges);\n return\n }\n }\n\n ////////////////////////////////////////////////////////////////\n // OPERATIONS WITH OFFSET AND SIZE ON STACK //\n ////////////////////////////////////////////////////////////////\n\n op::CALL => {\n // The destination offset of the operation is the fifth element on the stack.\n let dest_offset = try_or_return!(interpreter.stack.peek(5)).saturating_to::();\n\n // The size of the data that will be copied is the sixth element on the stack.\n let size = try_or_return!(interpreter.stack.peek(6)).saturating_to::();\n\n // If none of the allowed ranges contain [dest_offset, dest_offset + size),\n // memory outside of the expected ranges has been touched. If the opcode\n // only reads from memory, this is okay as long as the memory is not expanded.\n let fail_cond = !ranges.iter().any(|range| {\n range.contains(&dest_offset) &&\n range.contains(&(dest_offset + size.saturating_sub(1)))\n });\n\n // If the failure condition is met, set the output buffer to a revert string\n // that gives information about the allowed ranges and revert.\n if fail_cond {\n // SPECIAL CASE: When a call to `stopExpectSafeMemory` is performed, this is allowed.\n // It allocated calldata at the current free memory pointer, and will attempt to read\n // from this memory region to perform the call.\n let to = Address::from_word(try_or_return!(interpreter.stack.peek(1)).to_be_bytes::<32>().into());\n if to == CHEATCODE_ADDRESS {\n let args_offset = try_or_return!(interpreter.stack.peek(3)).saturating_to::();\n let args_size = try_or_return!(interpreter.stack.peek(4)).saturating_to::();\n let memory_word = interpreter.memory.slice_len(args_offset, args_size);\n if memory_word[..SELECTOR_LEN] == stopExpectSafeMemoryCall::SELECTOR {\n return\n }\n }\n\n disallowed_mem_write(dest_offset, size, interpreter, ranges);\n return\n }\n }\n\n $(op::$opcode => {\n // The destination offset of the operation.\n let dest_offset = try_or_return!(interpreter.stack.peek($offset_depth)).saturating_to::();\n\n // The size of the data that will be copied.\n let size = try_or_return!(interpreter.stack.peek($size_depth)).saturating_to::();\n\n // If none of the allowed ranges contain [dest_offset, dest_offset + size),\n // memory outside of the expected ranges has been touched. If the opcode\n // only reads from memory, this is okay as long as the memory is not expanded.\n let fail_cond = !ranges.iter().any(|range| {\n range.contains(&dest_offset) &&\n range.contains(&(dest_offset + size.saturating_sub(1)))\n }) && ($writes ||\n [dest_offset, (dest_offset + size).saturating_sub(1)].into_iter().any(|offset| {\n offset >= interpreter.memory.size() as u64\n })\n );\n\n // If the failure condition is met, set the output buffer to a revert string\n // that gives information about the allowed ranges and revert.\n if fail_cond {\n disallowed_mem_write(dest_offset, size, interpreter, ranges);\n return\n }\n })*\n\n _ => {}\n }\n }\n }\n\n // Check if the current opcode can write to memory, and if so, check if the memory\n // being written to is registered as safe to modify.\n mem_opcode_match!(\n (CALLDATACOPY, 0, 2, true),\n (CODECOPY, 0, 2, true),\n (RETURNDATACOPY, 0, 2, true),\n (EXTCODECOPY, 1, 3, true),\n (CALLCODE, 5, 6, true),\n (STATICCALL, 4, 5, true),\n (DELEGATECALL, 4, 5, true),\n (KECCAK256, 0, 1, false),\n (LOG0, 0, 1, false),\n (LOG1, 0, 1, false),\n (LOG2, 0, 1, false),\n (LOG3, 0, 1, false),\n (LOG4, 0, 1, false),\n (CREATE, 1, 2, false),\n (CREATE2, 1, 2, false),\n (RETURN, 0, 1, false),\n (REVERT, 0, 1, false),\n );\n }\n\n #[cold]\n fn set_gas_limit_type(&mut self, interpreter: &mut Interpreter) {\n match interpreter.bytecode.opcode() {\n op::CREATE2 => self.dynamic_gas_limit = true,\n op::CALL => {\n // If first element of the stack is close to current remaining gas then assume\n // dynamic gas limit.\n self.dynamic_gas_limit =\n try_or_return!(interpreter.stack.peek(0)) >= interpreter.gas.remaining() - 100\n }\n _ => self.dynamic_gas_limit = false,\n }\n }\n}\n\n/// Helper that expands memory, stores a revert string pertaining to a disallowed memory write,\n/// and sets the return range to the revert string's location in memory.\n///\n/// This will set the interpreter's next action to a return with the revert string as the output.\n/// And trigger a revert.\nfn disallowed_mem_write(\n dest_offset: u64,\n size: u64,\n interpreter: &mut Interpreter,\n ranges: &[Range],\n) {\n let revert_string = format!(\n \"memory write at offset 0x{:02X} of size 0x{:02X} not allowed; safe range: {}\",\n dest_offset,\n size,\n ranges.iter().map(|r| format!(\"(0x{:02X}, 0x{:02X}]\", r.start, r.end)).join(\" U \")\n );\n\n interpreter.bytecode.set_action(InterpreterAction::new_return(\n InstructionResult::Revert,\n Bytes::from(revert_string.into_bytes()),\n interpreter.gas,\n ));\n}\n\n/// Returns true if the kind of account access is a call.\nfn access_is_call(kind: crate::Vm::AccountAccessKind) -> bool {\n matches!(\n kind,\n crate::Vm::AccountAccessKind::Call\n | crate::Vm::AccountAccessKind::StaticCall\n | crate::Vm::AccountAccessKind::CallCode\n | crate::Vm::AccountAccessKind::DelegateCall\n )\n}\n\n/// Records a log into the recorded logs vector, if it exists.\nfn record_logs(recorded_logs: &mut Option>, log: &Log) {\n if let Some(storage_recorded_logs) = recorded_logs {\n storage_recorded_logs.push(Vm::Log {\n topics: log.data.topics().to_vec(),\n data: log.data.data.clone(),\n emitter: log.address,\n });\n }\n}\n\n/// Appends an AccountAccess that resumes the recording of the current context.\nfn append_storage_access(\n last: &mut Vec,\n storage_access: crate::Vm::StorageAccess,\n storage_depth: u64,\n) {\n // Assert that there's an existing record for the current context.\n if !last.is_empty() && last.first().unwrap().depth < storage_depth {\n // Three cases to consider:\n // 1. If there hasn't been a context switch since the start of this context, then add the\n // storage access to the current context record.\n // 2. If there's an existing Resume record, then add the storage access to it.\n // 3. Otherwise, create a new Resume record based on the current context.\n if last.len() == 1 {\n last.first_mut().unwrap().storageAccesses.push(storage_access);\n } else {\n let last_record = last.last_mut().unwrap();\n if last_record.kind as u8 == crate::Vm::AccountAccessKind::Resume as u8 {\n last_record.storageAccesses.push(storage_access);\n } else {\n let entry = last.first().unwrap();\n let resume_record = crate::Vm::AccountAccess {\n chainInfo: crate::Vm::ChainInfo {\n forkId: entry.chainInfo.forkId,\n chainId: entry.chainInfo.chainId,\n },\n accessor: entry.accessor,\n account: entry.account,\n kind: crate::Vm::AccountAccessKind::Resume,\n initialized: entry.initialized,\n storageAccesses: vec![storage_access],\n reverted: entry.reverted,\n // The remaining fields are defaults\n oldBalance: U256::ZERO,\n newBalance: U256::ZERO,\n oldNonce: 0,\n newNonce: 0,\n value: U256::ZERO,\n data: Bytes::new(),\n deployedCode: Bytes::new(),\n depth: entry.depth,\n };\n last.push(resume_record);\n }\n }\n }\n}\n\n/// Returns the [`spec::Cheatcode`] definition for a given [`spec::CheatcodeDef`] implementor.\nfn cheatcode_of(_: &T) -> &'static spec::Cheatcode<'static> {\n T::CHEATCODE\n}\n\nfn cheatcode_name(cheat: &spec::Cheatcode<'static>) -> &'static str {\n cheat.func.signature.split('(').next().unwrap()\n}\n\nfn cheatcode_id(cheat: &spec::Cheatcode<'static>) -> &'static str {\n cheat.func.id\n}\n\nfn cheatcode_signature(cheat: &spec::Cheatcode<'static>) -> &'static str {\n cheat.func.signature\n}\n\n/// Dispatches the cheatcode call to the appropriate function.\nfn apply_dispatch(\n calls: &Vm::VmCalls,\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n) -> Result {\n // Extract metadata for logging/deprecation via CheatcodeDef.\n macro_rules! get_cheatcode {\n ($($variant:ident),*) => {\n match calls {\n $(Vm::VmCalls::$variant(cheat) => cheatcode_of(cheat),)*\n }\n };\n }\n let cheat = vm_calls!(get_cheatcode);\n\n let _guard = debug_span!(target: \"cheatcodes\", \"apply\", id = %cheatcode_id(cheat)).entered();\n trace!(target: \"cheatcodes\", cheat = %cheatcode_signature(cheat), \"applying\");\n\n if let spec::Status::Deprecated(replacement) = cheat.status {\n ccx.state.deprecated.insert(cheatcode_signature(cheat), replacement);\n }\n\n // Monomorphized dispatch: calls apply_full directly, no trait objects.\n macro_rules! dispatch {\n ($($variant:ident),*) => {\n match calls {\n $(Vm::VmCalls::$variant(cheat) => Cheatcode::apply_full(cheat, ccx, executor),)*\n }\n };\n }\n let mut result = vm_calls!(dispatch);\n\n // Format the error message to include the cheatcode name.\n if let Err(e) = &mut result\n && e.is_str()\n {\n let name = cheatcode_name(cheat);\n // Skip showing the cheatcode name for:\n // - assertions: too verbose, and can already be inferred from the error message\n // - `rpcUrl`: forge-std relies on it in `getChainWithUpdatedRpcUrl`\n if !name.contains(\"assert\") && name != \"rpcUrl\" {\n *e = fmt_err!(\"vm.{name}: {e}\");\n }\n }\n\n trace!(\n target: \"cheatcodes\",\n return = %match &result {\n Ok(b) => hex::encode(b),\n Err(e) => e.to_string(),\n }\n );\n\n result\n}\n\n/// Helper function to check if frame execution will exit.\nfn will_exit(action: &InterpreterAction) -> bool {\n match action {\n InterpreterAction::Return(result) => {\n result.result.is_ok_or_revert() || result.result.is_error()\n }\n _ => false,\n }\n}\n" }, { "path": "crates/cheatcodes/src/json.rs", "content": "//! Implementations of [`Json`](spec::Group::Json) cheatcodes.\n\nuse crate::{Cheatcode, Cheatcodes, Result, Vm::*, string};\nuse alloy_dyn_abi::{DynSolType, DynSolValue, Resolver, eip712_parser::EncodeType};\nuse alloy_primitives::{Address, B256, I256, U256, hex};\nuse alloy_sol_types::SolValue;\nuse foundry_common::{fmt::StructDefinitions, fs};\nuse foundry_config::fs_permissions::FsAccessKind;\nuse serde_json::{Map, Value};\nuse std::{\n borrow::Cow,\n collections::{BTreeMap, BTreeSet},\n};\n\nimpl Cheatcode for keyExistsCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { json, key } = self;\n check_json_key_exists(json, key)\n }\n}\n\nimpl Cheatcode for keyExistsJsonCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { json, key } = self;\n check_json_key_exists(json, key)\n }\n}\n\nimpl Cheatcode for parseJson_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { json } = self;\n parse_json(json, \"$\", state.struct_defs())\n }\n}\n\nimpl Cheatcode for parseJson_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { json, key } = self;\n parse_json(json, key, state.struct_defs())\n }\n}\n\nimpl Cheatcode for parseJsonUintCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { json, key } = self;\n parse_json_coerce(json, key, &DynSolType::Uint(256))\n }\n}\n\nimpl Cheatcode for parseJsonUintArrayCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { json, key } = self;\n parse_json_coerce(json, key, &DynSolType::Array(Box::new(DynSolType::Uint(256))))\n }\n}\n\nimpl Cheatcode for parseJsonIntCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { json, key } = self;\n parse_json_coerce(json, key, &DynSolType::Int(256))\n }\n}\n\nimpl Cheatcode for parseJsonIntArrayCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { json, key } = self;\n parse_json_coerce(json, key, &DynSolType::Array(Box::new(DynSolType::Int(256))))\n }\n}\n\nimpl Cheatcode for parseJsonBoolCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { json, key } = self;\n parse_json_coerce(json, key, &DynSolType::Bool)\n }\n}\n\nimpl Cheatcode for parseJsonBoolArrayCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { json, key } = self;\n parse_json_coerce(json, key, &DynSolType::Array(Box::new(DynSolType::Bool)))\n }\n}\n\nimpl Cheatcode for parseJsonAddressCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { json, key } = self;\n parse_json_coerce(json, key, &DynSolType::Address)\n }\n}\n\nimpl Cheatcode for parseJsonAddressArrayCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { json, key } = self;\n parse_json_coerce(json, key, &DynSolType::Array(Box::new(DynSolType::Address)))\n }\n}\n\nimpl Cheatcode for parseJsonStringCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { json, key } = self;\n parse_json_coerce(json, key, &DynSolType::String)\n }\n}\n\nimpl Cheatcode for parseJsonStringArrayCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { json, key } = self;\n parse_json_coerce(json, key, &DynSolType::Array(Box::new(DynSolType::String)))\n }\n}\n\nimpl Cheatcode for parseJsonBytesCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { json, key } = self;\n parse_json_coerce(json, key, &DynSolType::Bytes)\n }\n}\n\nimpl Cheatcode for parseJsonBytesArrayCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { json, key } = self;\n parse_json_coerce(json, key, &DynSolType::Array(Box::new(DynSolType::Bytes)))\n }\n}\n\nimpl Cheatcode for parseJsonBytes32Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { json, key } = self;\n parse_json_coerce(json, key, &DynSolType::FixedBytes(32))\n }\n}\n\nimpl Cheatcode for parseJsonBytes32ArrayCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { json, key } = self;\n parse_json_coerce(json, key, &DynSolType::Array(Box::new(DynSolType::FixedBytes(32))))\n }\n}\n\nimpl Cheatcode for parseJsonType_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { json, typeDescription } = self;\n parse_json_coerce(json, \"$\", &resolve_type(typeDescription, state.struct_defs())?)\n .map(|v| v.abi_encode())\n }\n}\n\nimpl Cheatcode for parseJsonType_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { json, key, typeDescription } = self;\n parse_json_coerce(json, key, &resolve_type(typeDescription, state.struct_defs())?)\n .map(|v| v.abi_encode())\n }\n}\n\nimpl Cheatcode for parseJsonTypeArrayCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { json, key, typeDescription } = self;\n let ty = resolve_type(typeDescription, state.struct_defs())?;\n parse_json_coerce(json, key, &DynSolType::Array(Box::new(ty))).map(|v| v.abi_encode())\n }\n}\n\nimpl Cheatcode for parseJsonKeysCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { json, key } = self;\n parse_json_keys(json, key)\n }\n}\n\nimpl Cheatcode for serializeJsonCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { objectKey, value } = self;\n *state.serialized_jsons.entry(objectKey.into()).or_default() = serde_json::from_str(value)?;\n Ok(value.abi_encode())\n }\n}\n\nimpl Cheatcode for serializeBool_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { objectKey, valueKey, value } = self;\n serialize_json(state, objectKey, valueKey, (*value).into())\n }\n}\n\nimpl Cheatcode for serializeUint_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { objectKey, valueKey, value } = self;\n serialize_json(state, objectKey, valueKey, (*value).into())\n }\n}\n\nimpl Cheatcode for serializeInt_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { objectKey, valueKey, value } = self;\n serialize_json(state, objectKey, valueKey, (*value).into())\n }\n}\n\nimpl Cheatcode for serializeAddress_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { objectKey, valueKey, value } = self;\n serialize_json(state, objectKey, valueKey, (*value).into())\n }\n}\n\nimpl Cheatcode for serializeBytes32_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { objectKey, valueKey, value } = self;\n serialize_json(state, objectKey, valueKey, DynSolValue::FixedBytes(*value, 32))\n }\n}\n\nimpl Cheatcode for serializeString_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { objectKey, valueKey, value } = self;\n serialize_json(state, objectKey, valueKey, value.clone().into())\n }\n}\n\nimpl Cheatcode for serializeBytes_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { objectKey, valueKey, value } = self;\n serialize_json(state, objectKey, valueKey, value.to_vec().into())\n }\n}\n\nimpl Cheatcode for serializeBool_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { objectKey, valueKey, values } = self;\n serialize_json(\n state,\n objectKey,\n valueKey,\n DynSolValue::Array(values.iter().copied().map(DynSolValue::Bool).collect()),\n )\n }\n}\n\nimpl Cheatcode for serializeUint_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { objectKey, valueKey, values } = self;\n serialize_json(\n state,\n objectKey,\n valueKey,\n DynSolValue::Array(values.iter().map(|v| DynSolValue::Uint(*v, 256)).collect()),\n )\n }\n}\n\nimpl Cheatcode for serializeInt_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { objectKey, valueKey, values } = self;\n serialize_json(\n state,\n objectKey,\n valueKey,\n DynSolValue::Array(values.iter().map(|v| DynSolValue::Int(*v, 256)).collect()),\n )\n }\n}\n\nimpl Cheatcode for serializeAddress_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { objectKey, valueKey, values } = self;\n serialize_json(\n state,\n objectKey,\n valueKey,\n DynSolValue::Array(values.iter().copied().map(DynSolValue::Address).collect()),\n )\n }\n}\n\nimpl Cheatcode for serializeBytes32_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { objectKey, valueKey, values } = self;\n serialize_json(\n state,\n objectKey,\n valueKey,\n DynSolValue::Array(values.iter().map(|v| DynSolValue::FixedBytes(*v, 32)).collect()),\n )\n }\n}\n\nimpl Cheatcode for serializeString_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { objectKey, valueKey, values } = self;\n serialize_json(\n state,\n objectKey,\n valueKey,\n DynSolValue::Array(values.iter().cloned().map(DynSolValue::String).collect()),\n )\n }\n}\n\nimpl Cheatcode for serializeBytes_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { objectKey, valueKey, values } = self;\n serialize_json(\n state,\n objectKey,\n valueKey,\n DynSolValue::Array(\n values.iter().cloned().map(Into::into).map(DynSolValue::Bytes).collect(),\n ),\n )\n }\n}\n\nimpl Cheatcode for serializeJsonType_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { typeDescription, value } = self;\n let ty = resolve_type(typeDescription, state.struct_defs())?;\n let value = ty.abi_decode(value)?;\n let value = foundry_common::fmt::serialize_value_as_json(value, state.struct_defs())?;\n Ok(value.to_string().abi_encode())\n }\n}\n\nimpl Cheatcode for serializeJsonType_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { objectKey, valueKey, typeDescription, value } = self;\n let ty = resolve_type(typeDescription, state.struct_defs())?;\n let value = ty.abi_decode(value)?;\n serialize_json(state, objectKey, valueKey, value)\n }\n}\n\nimpl Cheatcode for serializeUintToHexCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { objectKey, valueKey, value } = self;\n let hex = format!(\"0x{value:x}\");\n serialize_json(state, objectKey, valueKey, hex.into())\n }\n}\n\nimpl Cheatcode for writeJson_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { json, path } = self;\n let json = serde_json::from_str(json).unwrap_or_else(|_| Value::String(json.to_owned()));\n let json_string = serde_json::to_string_pretty(&json)?;\n super::fs::write_file(state, path.as_ref(), json_string.as_bytes())\n }\n}\n\nimpl Cheatcode for writeJson_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { json: value, path, valueKey } = self;\n\n // Read, parse, and update the JSON object.\n // If the file doesn't exist, start with an empty JSON object so the file is created.\n let data_path = state.config.ensure_path_allowed(path, FsAccessKind::Read)?;\n let mut data = if data_path.exists() {\n let data_string = fs::locked_read_to_string(&data_path)?;\n serde_json::from_str(&data_string).unwrap_or_else(|_| Value::String(data_string))\n } else {\n Value::Object(Default::default())\n };\n upsert_json_value(&mut data, value, valueKey)?;\n\n // Write the updated content back to the file\n let json_string = serde_json::to_string_pretty(&data)?;\n super::fs::write_file(state, path.as_ref(), json_string.as_bytes())\n }\n}\n\npub(super) fn check_json_key_exists(json: &str, key: &str) -> Result {\n let json = parse_json_str(json)?;\n let values = select(&json, key)?;\n let exists = !values.is_empty();\n Ok(exists.abi_encode())\n}\n\npub(super) fn parse_json(json: &str, path: &str, defs: Option<&StructDefinitions>) -> Result {\n let value = parse_json_str(json)?;\n let selected = select(&value, path)?;\n let sol = json_to_sol(defs, &selected)?;\n Ok(encode(sol))\n}\n\npub(super) fn parse_json_coerce(json: &str, path: &str, ty: &DynSolType) -> Result {\n let json = parse_json_str(json)?;\n let [value] = select(&json, path)?[..] else {\n bail!(\"path {path:?} must return exactly one JSON value\");\n };\n\n parse_json_as(value, ty).map(|v| v.abi_encode())\n}\n\n/// Parses given [serde_json::Value] as a [DynSolValue].\npub(super) fn parse_json_as(value: &Value, ty: &DynSolType) -> Result {\n let to_string = |v: &Value| {\n let mut s = v.to_string();\n s.retain(|c: char| c != '\"');\n s\n };\n\n match (value, ty) {\n (Value::Array(array), ty) => parse_json_array(array, ty),\n (Value::Object(object), ty) => parse_json_map(object, ty),\n (Value::String(s), DynSolType::String) => Ok(DynSolValue::String(s.clone())),\n (Value::String(s), DynSolType::Uint(_) | DynSolType::Int(_)) => string::parse_value(s, ty),\n _ => string::parse_value(&to_string(value), ty),\n }\n}\n\npub(super) fn parse_json_array(array: &[Value], ty: &DynSolType) -> Result {\n match ty {\n DynSolType::Tuple(types) => {\n ensure!(array.len() == types.len(), \"array length mismatch\");\n let values = array\n .iter()\n .zip(types)\n .map(|(e, ty)| parse_json_as(e, ty))\n .collect::>>()?;\n\n Ok(DynSolValue::Tuple(values))\n }\n DynSolType::Array(inner) => {\n let values =\n array.iter().map(|e| parse_json_as(e, inner)).collect::>>()?;\n Ok(DynSolValue::Array(values))\n }\n DynSolType::FixedArray(inner, len) => {\n ensure!(array.len() == *len, \"array length mismatch\");\n let values =\n array.iter().map(|e| parse_json_as(e, inner)).collect::>>()?;\n Ok(DynSolValue::FixedArray(values))\n }\n _ => bail!(\"expected {ty}, found array\"),\n }\n}\n\npub(super) fn parse_json_map(map: &Map, ty: &DynSolType) -> Result {\n let Some((name, fields, types)) = ty.as_custom_struct() else {\n bail!(\"expected {ty}, found JSON object\");\n };\n\n let mut values = Vec::with_capacity(fields.len());\n for (field, ty) in fields.iter().zip(types.iter()) {\n let Some(value) = map.get(field) else { bail!(\"field {field:?} not found in JSON object\") };\n values.push(parse_json_as(value, ty)?);\n }\n\n Ok(DynSolValue::CustomStruct {\n name: name.to_string(),\n prop_names: fields.to_vec(),\n tuple: values,\n })\n}\n\npub(super) fn parse_json_keys(json: &str, key: &str) -> Result {\n let json = parse_json_str(json)?;\n let values = select(&json, key)?;\n let [value] = values[..] else {\n bail!(\"key {key:?} must return exactly one JSON object\");\n };\n let Value::Object(object) = value else {\n bail!(\"JSON value at {key:?} is not an object\");\n };\n let keys = object.keys().collect::>();\n Ok(keys.abi_encode())\n}\n\nfn parse_json_str(json: &str) -> Result {\n serde_json::from_str(json).map_err(|e| fmt_err!(\"failed parsing JSON: {e}\"))\n}\n\nfn json_to_sol(defs: Option<&StructDefinitions>, json: &[&Value]) -> Result> {\n let mut sol = Vec::with_capacity(json.len());\n for value in json {\n sol.push(json_value_to_token(value, defs)?);\n }\n Ok(sol)\n}\n\nfn select<'a>(value: &'a Value, mut path: &str) -> Result> {\n // Handle the special case of the root key\n if path == \".\" {\n path = \"$\";\n }\n // format error with debug string because json_path errors may contain newlines\n jsonpath_lib::select(value, &canonicalize_json_path(path))\n .map_err(|e| fmt_err!(\"failed selecting from JSON: {:?}\", e.to_string()))\n}\n\nfn encode(values: Vec) -> Vec {\n // Double `abi_encode` is intentional\n let bytes = match &values[..] {\n [] => Vec::new(),\n [one] => one.abi_encode(),\n _ => DynSolValue::Array(values).abi_encode(),\n };\n bytes.abi_encode()\n}\n\n/// Canonicalize a json path key to always start from the root of the document.\n/// Read more about json path syntax: \npub(super) fn canonicalize_json_path(path: &str) -> Cow<'_, str> {\n if !path.starts_with('$') { format!(\"${path}\").into() } else { path.into() }\n}\n\n/// Converts a JSON [`Value`] to a [`DynSolValue`] by trying to guess encoded type. For safer\n/// decoding, use [`parse_json_as`].\n///\n/// The function is designed to run recursively, so that in case of an object\n/// it will call itself to convert each of it's value and encode the whole as a\n/// Tuple\n#[instrument(target = \"cheatcodes\", level = \"trace\", ret)]\npub(super) fn json_value_to_token(\n value: &Value,\n defs: Option<&StructDefinitions>,\n) -> Result {\n if let Some(defs) = defs {\n _json_value_to_token(value, defs)\n } else {\n _json_value_to_token(value, &StructDefinitions::default())\n }\n}\n\nfn _json_value_to_token(value: &Value, defs: &StructDefinitions) -> Result {\n match value {\n Value::Null => Ok(DynSolValue::FixedBytes(B256::ZERO, 32)),\n Value::Bool(boolean) => Ok(DynSolValue::Bool(*boolean)),\n Value::Array(array) => array\n .iter()\n .map(|v| _json_value_to_token(v, defs))\n .collect::>()\n .map(DynSolValue::Array),\n Value::Object(map) => {\n // Try to find a struct definition that matches the object keys.\n let keys: BTreeSet<_> = map.keys().map(|s| s.as_str()).collect();\n let matching_def = defs.values().find(|fields| {\n fields.len() == keys.len()\n && fields.iter().map(|(name, _)| name.as_str()).collect::>() == keys\n });\n\n if let Some(fields) = matching_def {\n // Found a struct with matching field names, use the order from the definition.\n fields\n .iter()\n .map(|(name, _)| {\n // unwrap is safe because we know the key exists.\n _json_value_to_token(map.get(name).unwrap(), defs)\n })\n .collect::>()\n .map(DynSolValue::Tuple)\n } else {\n // Fallback to alphabetical sorting if no matching struct is found.\n // See: [#3647](https://github.com/foundry-rs/foundry/pull/3647)\n let ordered_object: BTreeMap<_, _> =\n map.iter().map(|(k, v)| (k.clone(), v.clone())).collect();\n ordered_object\n .values()\n .map(|value| _json_value_to_token(value, defs))\n .collect::>()\n .map(DynSolValue::Tuple)\n }\n }\n Value::Number(number) => {\n if let Some(f) = number.as_f64() {\n // Check if the number has decimal digits because the EVM does not support floating\n // point math\n if f.fract() == 0.0 {\n // Use the string representation of the `serde_json` Number type instead of\n // calling f.to_string(), because some numbers are wrongly rounded up after\n // being convented to f64.\n // Example: 18446744073709551615 becomes 18446744073709552000 after parsing it\n // to f64.\n let s = number.to_string();\n\n // Coerced to scientific notation, so short-circuit to using fallback.\n // This will not have a problem with hex numbers, as for parsing these\n // We'd need to prefix this with 0x.\n // See also \n if s.contains('e') {\n // Calling Number::to_string with powers of ten formats the number using\n // scientific notation and causes from_dec_str to fail. Using format! with\n // f64 keeps the full number representation.\n // Example: 100000000000000000000 becomes 1e20 when Number::to_string is\n // used.\n let fallback_s = f.to_string();\n if let Ok(n) = fallback_s.parse() {\n return Ok(DynSolValue::Uint(n, 256));\n }\n if let Ok(n) = I256::from_dec_str(&fallback_s) {\n return Ok(DynSolValue::Int(n, 256));\n }\n }\n\n if let Ok(n) = s.parse() {\n return Ok(DynSolValue::Uint(n, 256));\n }\n if let Ok(n) = s.parse() {\n return Ok(DynSolValue::Int(n, 256));\n }\n }\n }\n\n Err(fmt_err!(\"unsupported JSON number: {number}\"))\n }\n Value::String(string) => {\n // Hanfl hex strings\n if let Some(mut val) = string.strip_prefix(\"0x\") {\n let s;\n if val.len() == 39 {\n return Err(format!(\"Cannot parse \\\"{val}\\\" as an address. If you want to specify address, prepend zero to the value.\").into());\n }\n if !val.len().is_multiple_of(2) {\n s = format!(\"0{val}\");\n val = &s[..];\n }\n if let Ok(bytes) = hex::decode(val) {\n return Ok(match bytes.len() {\n 20 => DynSolValue::Address(Address::from_slice(&bytes)),\n 32 => DynSolValue::FixedBytes(B256::from_slice(&bytes), 32),\n _ => DynSolValue::Bytes(bytes),\n });\n }\n }\n\n // Handle large numbers that were potentially encoded as strings because they exceed the\n // capacity of a 64-bit integer.\n // Note that number-like strings that *could* fit in an `i64`/`u64` will fall through\n // and be treated as literal strings.\n if let Ok(n) = string.parse::()\n && i64::try_from(n).is_err()\n {\n return Ok(DynSolValue::Int(n, 256));\n } else if let Ok(n) = string.parse::()\n && u64::try_from(n).is_err()\n {\n return Ok(DynSolValue::Uint(n, 256));\n }\n\n // Otherwise, treat as a regular string\n Ok(DynSolValue::String(string.to_owned()))\n }\n }\n}\n\n/// Serializes a key:value pair to a specific object. If the key is valueKey, the value is\n/// expected to be an object, which will be set as the root object for the provided object key,\n/// overriding the whole root object if the object key already exists. By calling this function\n/// multiple times, the user can serialize multiple KV pairs to the same object. The value can be of\n/// any type, even a new object in itself. The function will return a stringified version of the\n/// object, so that the user can use that as a value to a new invocation of the same function with a\n/// new object key. This enables the user to reuse the same function to crate arbitrarily complex\n/// object structures (JSON).\nfn serialize_json(\n state: &mut Cheatcodes,\n object_key: &str,\n value_key: &str,\n value: DynSolValue,\n) -> Result {\n let value = foundry_common::fmt::serialize_value_as_json(value, state.struct_defs())?;\n let map = state.serialized_jsons.entry(object_key.into()).or_default();\n map.insert(value_key.into(), value);\n let stringified = serde_json::to_string(map).unwrap();\n Ok(stringified.abi_encode())\n}\n\n/// Resolves a [DynSolType] from user input.\npub(super) fn resolve_type(\n type_description: &str,\n struct_defs: Option<&StructDefinitions>,\n) -> Result {\n let ordered_ty = |ty| -> Result {\n if let Some(defs) = struct_defs { reorder_type(ty, defs) } else { Ok(ty) }\n };\n\n if let Ok(ty) = DynSolType::parse(type_description) {\n return ordered_ty(ty);\n };\n\n if let Ok(encoded) = EncodeType::parse(type_description) {\n let main_type = encoded.types[0].type_name;\n let mut resolver = Resolver::default();\n for t in &encoded.types {\n resolver.ingest(t.to_owned());\n }\n\n // Get the alphabetically-sorted type from the resolver, and reorder if necessary.\n return ordered_ty(resolver.resolve(main_type)?);\n }\n\n bail!(\"type description should be a valid Solidity type or a EIP712 `encodeType` string\")\n}\n\n/// Upserts a value into a JSON object based on a dot-separated key.\n///\n/// This function navigates through a mutable `serde_json::Value` object using a\n/// path-like key. It creates nested JSON objects if they do not exist along the path.\n/// The value is inserted at the final key in the path.\n///\n/// # Arguments\n///\n/// * `data` - A mutable reference to the `serde_json::Value` to be modified.\n/// * `value` - The string representation of the value to upsert. This string is first parsed as\n/// JSON, and if that fails, it's treated as a plain JSON string.\n/// * `key` - A dot-separated string representing the path to the location for upserting.\npub(super) fn upsert_json_value(data: &mut Value, value: &str, key: &str) -> Result<()> {\n // Parse the path key into segments.\n let canonical_key = canonicalize_json_path(key);\n let parts: Vec<&str> = canonical_key\n .strip_prefix(\"$.\")\n .unwrap_or(key)\n .split('.')\n .filter(|s| !s.is_empty())\n .collect();\n\n if parts.is_empty() {\n return Err(fmt_err!(\"'valueKey' cannot be empty or just '$'\"));\n }\n\n // Separate the final key from the path.\n // Traverse the objects, creating intermediary ones if necessary.\n if let Some((key_to_insert, path_to_parent)) = parts.split_last() {\n let mut current_level = data;\n\n for segment in path_to_parent {\n if !current_level.is_object() {\n return Err(fmt_err!(\"path segment '{segment}' does not resolve to an object.\"));\n }\n current_level = current_level\n .as_object_mut()\n .unwrap()\n .entry(segment.to_string())\n .or_insert(Value::Object(Map::new()));\n }\n\n // Upsert the new value\n if let Some(parent_obj) = current_level.as_object_mut() {\n parent_obj.insert(\n key_to_insert.to_string(),\n serde_json::from_str(value).unwrap_or_else(|_| Value::String(value.to_owned())),\n );\n } else {\n return Err(fmt_err!(\"final destination is not an object, cannot insert key.\"));\n }\n }\n\n Ok(())\n}\n\n/// Recursively traverses a `DynSolType` and reorders the fields of any\n/// `CustomStruct` variants according to the provided `StructDefinitions`.\n///\n/// This is necessary because the EIP-712 resolver sorts struct fields alphabetically,\n/// but we want to respect the order defined in the Solidity source code.\nfn reorder_type(ty: DynSolType, struct_defs: &StructDefinitions) -> Result {\n match ty {\n DynSolType::CustomStruct { name, prop_names, tuple } => {\n if let Some(def) = struct_defs.get(&name)? {\n // The incoming `prop_names` and `tuple` are alphabetically sorted.\n let type_map: std::collections::HashMap =\n prop_names.into_iter().zip(tuple).collect();\n\n let mut sorted_props = Vec::with_capacity(def.len());\n let mut sorted_tuple = Vec::with_capacity(def.len());\n for (field_name, _) in def {\n sorted_props.push(field_name.clone());\n if let Some(field_ty) = type_map.get(field_name) {\n sorted_tuple.push(reorder_type(field_ty.clone(), struct_defs)?);\n } else {\n bail!(\n \"mismatch between struct definition and type description: field '{field_name}' not found in provided type for struct '{name}'\"\n );\n }\n }\n Ok(DynSolType::CustomStruct { name, prop_names: sorted_props, tuple: sorted_tuple })\n } else {\n // No definition found, so we can't reorder. However, we still reorder its children\n // in case they have known structs.\n let new_tuple = tuple\n .into_iter()\n .map(|t| reorder_type(t, struct_defs))\n .collect::>>()?;\n Ok(DynSolType::CustomStruct { name, prop_names, tuple: new_tuple })\n }\n }\n DynSolType::Array(inner) => {\n Ok(DynSolType::Array(Box::new(reorder_type(*inner, struct_defs)?)))\n }\n DynSolType::FixedArray(inner, len) => {\n Ok(DynSolType::FixedArray(Box::new(reorder_type(*inner, struct_defs)?), len))\n }\n DynSolType::Tuple(inner) => Ok(DynSolType::Tuple(\n inner.into_iter().map(|t| reorder_type(t, struct_defs)).collect::>>()?,\n )),\n _ => Ok(ty),\n }\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n use alloy_primitives::FixedBytes;\n use foundry_common::fmt::{TypeDefMap, serialize_value_as_json};\n use proptest::{arbitrary::any, prop_oneof, strategy::Strategy};\n use std::collections::HashSet;\n\n fn valid_value(value: &DynSolValue) -> bool {\n (match value {\n DynSolValue::String(s) if s == \"{}\" => false,\n\n DynSolValue::Tuple(_) | DynSolValue::CustomStruct { .. } => false,\n\n DynSolValue::Array(v) | DynSolValue::FixedArray(v) => v.iter().all(valid_value),\n _ => true,\n }) && value.as_type().is_some()\n }\n\n /// [DynSolValue::Bytes] of length 32 and 20 are converted to [DynSolValue::FixedBytes] and\n /// [DynSolValue::Address] respectively. Thus, we can't distinguish between address and bytes of\n /// length 20 during decoding. Because of that, there are issues with handling of arrays of\n /// those types.\n fn fixup_guessable(value: DynSolValue) -> DynSolValue {\n match value {\n DynSolValue::Array(mut v) | DynSolValue::FixedArray(mut v) => {\n if let Some(DynSolValue::Bytes(_)) = v.first() {\n v.retain(|v| {\n let len = v.as_bytes().unwrap().len();\n len != 32 && len != 20\n })\n }\n DynSolValue::Array(v.into_iter().map(fixup_guessable).collect())\n }\n DynSolValue::FixedBytes(v, _) => DynSolValue::FixedBytes(v, 32),\n DynSolValue::Bytes(v) if v.len() == 32 => {\n DynSolValue::FixedBytes(FixedBytes::from_slice(&v), 32)\n }\n DynSolValue::Bytes(v) if v.len() == 20 => DynSolValue::Address(Address::from_slice(&v)),\n _ => value,\n }\n }\n\n fn guessable_types() -> impl proptest::strategy::Strategy {\n any::().prop_map(fixup_guessable).prop_filter(\"invalid value\", valid_value)\n }\n\n /// A proptest strategy for generating a (simple) `DynSolValue::CustomStruct`\n /// and its corresponding `StructDefinitions` object.\n fn custom_struct_strategy() -> impl Strategy {\n // Define a strategy for basic field names and values.\n let field_name_strat = \"[a-z]{4,12}\";\n let field_value_strat = prop_oneof![\n any::().prop_map(DynSolValue::Bool),\n any::().prop_map(|v| DynSolValue::Uint(U256::from(v), 256)),\n any::<[u8; 20]>().prop_map(Address::from).prop_map(DynSolValue::Address),\n any::<[u8; 32]>().prop_map(B256::from).prop_map(|b| DynSolValue::FixedBytes(b, 32)),\n \".*\".prop_map(DynSolValue::String),\n ];\n\n // Combine them to create a list of unique fields that preserve the random order.\n let fields_strat = proptest::collection::vec((field_name_strat, field_value_strat), 1..8)\n .prop_map(|fields| {\n let mut unique_fields = Vec::with_capacity(fields.len());\n let mut seen_names = HashSet::new();\n for (name, value) in fields {\n if seen_names.insert(name.clone()) {\n unique_fields.push((name, value));\n }\n }\n unique_fields\n });\n\n // Generate the `CustomStruct` and its definition.\n (\"[A-Z][a-z]{4,8}\", fields_strat).prop_map(|(struct_name, fields)| {\n let (prop_names, tuple): (Vec, Vec) =\n fields.clone().into_iter().unzip();\n let def_fields: Vec<(String, String)> = fields\n .iter()\n .map(|(name, value)| (name.clone(), value.as_type().unwrap().to_string()))\n .collect();\n let mut defs_map = TypeDefMap::default();\n defs_map.insert(struct_name.clone(), def_fields);\n (defs_map.into(), DynSolValue::CustomStruct { name: struct_name, prop_names, tuple })\n })\n }\n\n // Tests to ensure that conversion [DynSolValue] -> [serde_json::Value] -> [DynSolValue]\n proptest::proptest! {\n #[test]\n fn test_json_roundtrip_guessed(v in guessable_types()) {\n let json = serialize_value_as_json(v.clone(), None).unwrap();\n let value = json_value_to_token(&json, None).unwrap();\n\n // do additional abi_encode -> abi_decode to avoid zero signed integers getting decoded as unsigned and causing assert_eq to fail.\n let decoded = v.as_type().unwrap().abi_decode(&value.abi_encode()).unwrap();\n assert_eq!(decoded, v);\n }\n\n #[test]\n fn test_json_roundtrip(v in any::().prop_filter(\"filter out values without type\", |v| v.as_type().is_some())) {\n let json = serialize_value_as_json(v.clone(), None).unwrap();\n let value = parse_json_as(&json, &v.as_type().unwrap()).unwrap();\n assert_eq!(value, v);\n }\n\n #[test]\n fn test_json_roundtrip_with_struct_defs((struct_defs, v) in custom_struct_strategy()) {\n let json = serialize_value_as_json(v.clone(), Some(&struct_defs)).unwrap();\n let sol_type = v.as_type().unwrap();\n let parsed_value = parse_json_as(&json, &sol_type).unwrap();\n assert_eq!(parsed_value, v);\n }\n }\n\n #[test]\n fn test_resolve_type_with_definitions() -> Result<()> {\n // Define a struct with fields in a specific order (not alphabetical)\n let mut struct_defs = TypeDefMap::new();\n struct_defs.insert(\n \"Apple\".to_string(),\n vec![\n (\"color\".to_string(), \"string\".to_string()),\n (\"sweetness\".to_string(), \"uint8\".to_string()),\n (\"sourness\".to_string(), \"uint8\".to_string()),\n ],\n );\n struct_defs.insert(\n \"FruitStall\".to_string(),\n vec![\n (\"name\".to_string(), \"string\".to_string()),\n (\"apples\".to_string(), \"Apple[]\".to_string()),\n ],\n );\n\n // Simulate resolver output: type string, using alphabetical order for fields.\n let ty_desc = \"FruitStall(Apple[] apples,string name)Apple(string color,uint8 sourness,uint8 sweetness)\";\n\n // Resolve type and ensure struct definition order is preserved.\n let ty = resolve_type(ty_desc, Some(&struct_defs.into())).unwrap();\n if let DynSolType::CustomStruct { name, prop_names, tuple } = ty {\n assert_eq!(name, \"FruitStall\");\n assert_eq!(prop_names, vec![\"name\", \"apples\"]);\n assert_eq!(tuple.len(), 2);\n assert_eq!(tuple[0], DynSolType::String);\n\n if let DynSolType::Array(apple_ty_boxed) = &tuple[1]\n && let DynSolType::CustomStruct { name, prop_names, tuple } = &**apple_ty_boxed\n {\n assert_eq!(*name, \"Apple\");\n // Check that the inner struct's fields are also in definition order.\n assert_eq!(*prop_names, vec![\"color\", \"sweetness\", \"sourness\"]);\n assert_eq!(\n *tuple,\n vec![DynSolType::String, DynSolType::Uint(8), DynSolType::Uint(8)]\n );\n\n return Ok(());\n }\n }\n panic!(\"Expected FruitStall and Apple to be CustomStruct\");\n }\n\n #[test]\n fn test_resolve_type_without_definitions() -> Result<()> {\n // Simulate resolver output: type string, using alphabetical order for fields.\n let ty_desc = \"Person(bool active,uint256 age,string name)\";\n\n // Resolve the type without providing any struct definitions and ensure that original\n // (alphabetical) order is unchanged.\n let ty = resolve_type(ty_desc, None).unwrap();\n if let DynSolType::CustomStruct { name, prop_names, tuple } = ty {\n assert_eq!(name, \"Person\");\n assert_eq!(prop_names, vec![\"active\", \"age\", \"name\"]);\n assert_eq!(tuple.len(), 3);\n assert_eq!(tuple, vec![DynSolType::Bool, DynSolType::Uint(256), DynSolType::String]);\n return Ok(());\n }\n panic!(\"Expected Person to be CustomStruct\");\n }\n\n #[test]\n fn test_resolve_type_for_array_of_structs() -> Result<()> {\n // Define a struct with fields in a specific, non-alphabetical order.\n let mut struct_defs = TypeDefMap::new();\n struct_defs.insert(\n \"Item\".to_string(),\n vec![\n (\"name\".to_string(), \"string\".to_string()),\n (\"price\".to_string(), \"uint256\".to_string()),\n (\"id\".to_string(), \"uint256\".to_string()),\n ],\n );\n\n // Simulate resolver output: type string, using alphabetical order for fields.\n let ty_desc = \"Item(uint256 id,string name,uint256 price)\";\n\n // Resolve type and ensure struct definition order is preserved.\n let ty = resolve_type(ty_desc, Some(&struct_defs.into())).unwrap();\n let array_ty = DynSolType::Array(Box::new(ty));\n if let DynSolType::Array(item_ty) = array_ty\n && let DynSolType::CustomStruct { name, prop_names, tuple } = *item_ty\n {\n assert_eq!(name, \"Item\");\n assert_eq!(prop_names, vec![\"name\", \"price\", \"id\"]);\n assert_eq!(\n tuple,\n vec![DynSolType::String, DynSolType::Uint(256), DynSolType::Uint(256)]\n );\n return Ok(());\n }\n panic!(\"Expected CustomStruct in array\");\n }\n\n #[test]\n fn test_parse_json_missing_field() {\n // Define a struct with a specific field order.\n let mut struct_defs = TypeDefMap::new();\n struct_defs.insert(\n \"Person\".to_string(),\n vec![\n (\"name\".to_string(), \"string\".to_string()),\n (\"age\".to_string(), \"uint256\".to_string()),\n ],\n );\n\n // JSON missing the \"age\" field\n let json_str = r#\"{ \"name\": \"Alice\" }\"#;\n\n // Simulate resolver output: type string, using alphabetical order for fields.\n let type_description = \"Person(uint256 age,string name)\";\n let ty = resolve_type(type_description, Some(&struct_defs.into())).unwrap();\n\n // Now, attempt to parse the incomplete JSON using the ordered type.\n let json_value: Value = serde_json::from_str(json_str).unwrap();\n let result = parse_json_as(&json_value, &ty);\n\n // Should fail with a missing field error because `parse_json_map` requires all fields.\n assert!(result.is_err());\n assert!(result.unwrap_err().to_string().contains(\"field \\\"age\\\" not found in JSON object\"));\n }\n\n #[test]\n fn test_serialize_json_with_struct_def_order() {\n // Define a struct with a specific, non-alphabetical field order.\n let mut struct_defs = TypeDefMap::new();\n struct_defs.insert(\n \"Item\".to_string(),\n vec![\n (\"name\".to_string(), \"string\".to_string()),\n (\"id\".to_string(), \"uint256\".to_string()),\n (\"active\".to_string(), \"bool\".to_string()),\n ],\n );\n\n // Create a DynSolValue instance for the struct.\n let item_struct = DynSolValue::CustomStruct {\n name: \"Item\".to_string(),\n prop_names: vec![\"name\".to_string(), \"id\".to_string(), \"active\".to_string()],\n tuple: vec![\n DynSolValue::String(\"Test Item\".to_string()),\n DynSolValue::Uint(U256::from(123), 256),\n DynSolValue::Bool(true),\n ],\n };\n\n // Serialize the value to JSON and verify that the order is preserved.\n let json_value = serialize_value_as_json(item_struct, Some(&struct_defs.into())).unwrap();\n let json_string = serde_json::to_string(&json_value).unwrap();\n assert_eq!(json_string, r#\"{\"name\":\"Test Item\",\"id\":123,\"active\":true}\"#);\n }\n\n #[test]\n fn test_json_full_cycle_typed_with_struct_defs() {\n // Define a struct with a specific, non-alphabetical field order.\n let mut struct_defs = TypeDefMap::new();\n struct_defs.insert(\n \"Wallet\".to_string(),\n vec![\n (\"owner\".to_string(), \"address\".to_string()),\n (\"balance\".to_string(), \"uint256\".to_string()),\n (\"id\".to_string(), \"bytes32\".to_string()),\n ],\n );\n\n // Create the \"original\" DynSolValue instance.\n let owner_address = Address::from([1; 20]);\n let wallet_id = B256::from([2; 32]);\n let original_wallet = DynSolValue::CustomStruct {\n name: \"Wallet\".to_string(),\n prop_names: vec![\"owner\".to_string(), \"balance\".to_string(), \"id\".to_string()],\n tuple: vec![\n DynSolValue::Address(owner_address),\n DynSolValue::Uint(U256::from(5000), 256),\n DynSolValue::FixedBytes(wallet_id, 32),\n ],\n };\n\n // Serialize it. The resulting JSON should respect the struct definition order.\n let json_value =\n serialize_value_as_json(original_wallet.clone(), Some(&struct_defs.clone().into()))\n .unwrap();\n let json_string = serde_json::to_string(&json_value).unwrap();\n assert_eq!(\n json_string,\n format!(r#\"{{\"owner\":\"{owner_address}\",\"balance\":5000,\"id\":\"{wallet_id}\"}}\"#)\n );\n\n // Resolve the type, which should also respect the struct definition order.\n let type_description = \"Wallet(uint256 balance,bytes32 id,address owner)\";\n let resolved_type = resolve_type(type_description, Some(&struct_defs.into())).unwrap();\n\n // Parse the JSON using the correctly ordered resolved type. Ensure that it is identical to\n // the original one.\n let parsed_value = parse_json_as(&json_value, &resolved_type).unwrap();\n assert_eq!(parsed_value, original_wallet);\n }\n}\n" }, { "path": "crates/cheatcodes/src/lib.rs", "content": "//! # foundry-cheatcodes\n//!\n//! Foundry cheatcodes implementations.\n\n#![cfg_attr(not(test), warn(unused_crate_dependencies))]\n#![cfg_attr(docsrs, feature(doc_cfg))]\n#![allow(elided_lifetimes_in_paths)] // Cheats context uses 3 lifetimes\n\n#[macro_use]\nextern crate foundry_common;\n\n#[macro_use]\npub extern crate foundry_cheatcodes_spec as spec;\n\n#[macro_use]\nextern crate tracing;\n\nuse alloy_primitives::Address;\nuse foundry_evm_core::backend::DatabaseExt;\nuse revm::context::{ContextTr, JournalTr};\n\npub use Vm::ForgeContext;\npub use config::CheatsConfig;\npub use error::{Error, ErrorKind, Result};\npub use foundry_evm_core::{EthCheatCtx, evm::NestedEvmClosure};\npub use inspector::{\n BroadcastKind, BroadcastableTransaction, BroadcastableTransactions, Cheatcodes,\n CheatcodesExecutor,\n};\npub use spec::{CheatcodeDef, Vm};\n\n#[macro_use]\nmod error;\n\nmod base64;\n\nmod config;\n\nmod crypto;\n\nmod version;\n\nmod env;\npub use env::set_execution_context;\n\nmod evm;\n\nmod fs;\n\nmod inspector;\npub use inspector::CheatcodeAnalysis;\n\nmod json;\n\nmod script;\npub use script::{Wallets, WalletsInner};\n\nmod string;\n\nmod test;\npub use test::expect::ExpectedCallTracker;\n\nmod toml;\n\nmod utils;\n\n/// Cheatcode implementation.\npub(crate) trait Cheatcode: CheatcodeDef {\n /// Applies this cheatcode to the given state.\n ///\n /// Implement this function if you don't need access to the EVM data.\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let _ = state;\n unimplemented!(\"{}\", Self::CHEATCODE.func.id)\n }\n\n /// Applies this cheatcode to the given context.\n ///\n /// Implement this function if you need access to the EVM data.\n #[inline(always)]\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n self.apply(ccx.state)\n }\n\n /// Applies this cheatcode to the given context and executor.\n ///\n /// Implement this function if you need access to the executor.\n #[inline(always)]\n fn apply_full(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n ) -> Result {\n let _ = executor;\n self.apply_stateful(ccx)\n }\n}\n\n/// The cheatcode context.\npub struct CheatsCtxt<'a, CTX> {\n /// The cheatcodes inspector state.\n pub(crate) state: &'a mut Cheatcodes,\n /// The EVM context.\n pub(crate) ecx: &'a mut CTX,\n /// The original `msg.sender`.\n pub(crate) caller: Address,\n /// Gas limit of the current cheatcode call.\n pub(crate) gas_limit: u64,\n}\n\nimpl std::ops::Deref for CheatsCtxt<'_, CTX> {\n type Target = CTX;\n\n #[inline(always)]\n fn deref(&self) -> &Self::Target {\n self.ecx\n }\n}\n\nimpl std::ops::DerefMut for CheatsCtxt<'_, CTX> {\n #[inline(always)]\n fn deref_mut(&mut self) -> &mut Self::Target {\n self.ecx\n }\n}\n\nimpl CheatsCtxt<'_, CTX> {\n pub(crate) fn ensure_not_precompile(&self, address: &Address) -> Result<()> {\n if self.is_precompile(address) { Err(precompile_error(address)) } else { Ok(()) }\n }\n\n pub(crate) fn is_precompile(&self, address: &Address) -> bool {\n self.ecx.journal().precompile_addresses().contains(address)\n }\n}\n\n#[cold]\nfn precompile_error(address: &Address) -> Error {\n fmt_err!(\"cannot use precompile {address} as an argument\")\n}\n" }, { "path": "crates/cheatcodes/src/script.rs", "content": "//! Implementations of [`Scripting`](spec::Group::Scripting) cheatcodes.\n\nuse crate::{Cheatcode, CheatsCtxt, Result, Vm::*, evm::journaled_account};\nuse alloy_consensus::{SidecarBuilder, SimpleCoder};\nuse alloy_primitives::{Address, B256, U256, Uint};\nuse alloy_rpc_types::Authorization;\nuse alloy_signer::SignerSync;\nuse alloy_signer_local::PrivateKeySigner;\nuse alloy_sol_types::SolValue;\nuse foundry_evm_core::backend::DatabaseExt;\nuse foundry_wallets::{WalletSigner, wallet_multi::MultiWallet};\nuse parking_lot::Mutex;\nuse revm::{\n bytecode::Bytecode,\n context::{Cfg, ContextTr, JournalTr, Transaction},\n context_interface::transaction::SignedAuthorization,\n inspector::JournalExt,\n primitives::{KECCAK_EMPTY, hardfork::SpecId},\n};\nuse std::sync::Arc;\n\nimpl Cheatcode for broadcast_0Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self {} = self;\n broadcast(ccx, None, true)\n }\n}\n\nimpl Cheatcode for broadcast_1Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { signer } = self;\n broadcast(ccx, Some(signer), true)\n }\n}\n\nimpl Cheatcode for broadcast_2Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { privateKey } = self;\n broadcast_key(ccx, privateKey, true)\n }\n}\n\nimpl Cheatcode for attachDelegation_0Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { signedDelegation } = self;\n attach_delegation(ccx, signedDelegation, false)\n }\n}\n\nimpl Cheatcode for attachDelegation_1Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { signedDelegation, crossChain } = self;\n attach_delegation(ccx, signedDelegation, *crossChain)\n }\n}\n\nimpl Cheatcode for signDelegation_0Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { implementation, privateKey } = *self;\n sign_delegation(ccx, privateKey, implementation, None, false, false)\n }\n}\n\nimpl Cheatcode for signDelegation_1Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { implementation, privateKey, nonce } = *self;\n sign_delegation(ccx, privateKey, implementation, Some(nonce), false, false)\n }\n}\n\nimpl Cheatcode for signDelegation_2Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { implementation, privateKey, crossChain } = *self;\n sign_delegation(ccx, privateKey, implementation, None, crossChain, false)\n }\n}\n\nimpl Cheatcode for signAndAttachDelegation_0Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { implementation, privateKey } = *self;\n sign_delegation(ccx, privateKey, implementation, None, false, true)\n }\n}\n\nimpl Cheatcode for signAndAttachDelegation_1Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { implementation, privateKey, nonce } = *self;\n sign_delegation(ccx, privateKey, implementation, Some(nonce), false, true)\n }\n}\n\nimpl Cheatcode for signAndAttachDelegation_2Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { implementation, privateKey, crossChain } = *self;\n sign_delegation(ccx, privateKey, implementation, None, crossChain, true)\n }\n}\n\n/// Helper function to attach an EIP-7702 delegation.\nfn attach_delegation>(\n ccx: &mut CheatsCtxt<'_, CTX>,\n delegation: &SignedDelegation,\n cross_chain: bool,\n) -> Result {\n let SignedDelegation { v, r, s, nonce, implementation } = delegation;\n // Set chain id to 0 if universal deployment is preferred.\n // See https://github.com/ethereum/EIPs/blob/master/EIPS/eip-7702.md#protection-from-malleability-cross-chain\n let chain_id = if cross_chain { U256::from(0) } else { U256::from(ccx.ecx.cfg().chain_id()) };\n\n let auth = Authorization { address: *implementation, nonce: *nonce, chain_id };\n let signed_auth = SignedAuthorization::new_unchecked(\n auth,\n *v,\n U256::from_be_bytes(r.0),\n U256::from_be_bytes(s.0),\n );\n write_delegation(ccx, signed_auth.clone())?;\n ccx.state.add_delegation(signed_auth);\n Ok(Default::default())\n}\n\n/// Helper function to sign and attach (if needed) an EIP-7702 delegation.\n/// Uses the provided nonce, otherwise retrieves and increments the nonce of the EOA.\nfn sign_delegation>(\n ccx: &mut CheatsCtxt<'_, CTX>,\n private_key: Uint<256, 4>,\n implementation: Address,\n nonce: Option,\n cross_chain: bool,\n attach: bool,\n) -> Result> {\n let signer = PrivateKeySigner::from_bytes(&B256::from(private_key))?;\n let nonce = if let Some(nonce) = nonce {\n nonce\n } else {\n let account_nonce = {\n let authority_acc = ccx.ecx.journal_mut().load_account(signer.address())?;\n authority_acc.info.nonce\n };\n // Calculate next nonce considering existing active delegations\n next_delegation_nonce(\n &ccx.state.active_delegations,\n signer.address(),\n &ccx.state.broadcast,\n account_nonce,\n )\n };\n let chain_id = if cross_chain { U256::from(0) } else { U256::from(ccx.ecx.cfg().chain_id()) };\n\n let auth = Authorization { address: implementation, nonce, chain_id };\n let sig = signer.sign_hash_sync(&auth.signature_hash())?;\n // Attach delegation.\n if attach {\n let signed_auth = SignedAuthorization::new_unchecked(auth, sig.v() as u8, sig.r(), sig.s());\n write_delegation(ccx, signed_auth.clone())?;\n ccx.state.add_delegation(signed_auth);\n }\n Ok(SignedDelegation {\n v: sig.v() as u8,\n r: sig.r().into(),\n s: sig.s().into(),\n nonce,\n implementation,\n }\n .abi_encode())\n}\n\n/// Returns the next valid nonce for a delegation, considering existing active delegations.\nfn next_delegation_nonce(\n active_delegations: &[SignedAuthorization],\n authority: Address,\n broadcast: &Option,\n account_nonce: u64,\n) -> u64 {\n match active_delegations\n .iter()\n .rfind(|auth| auth.recover_authority().is_ok_and(|recovered| recovered == authority))\n {\n Some(auth) => {\n // Increment nonce of last recorded delegation.\n auth.nonce + 1\n }\n None => {\n // First time a delegation is added for this authority.\n if let Some(broadcast) = broadcast {\n // Increment nonce if authority is the sender of transaction.\n if broadcast.new_origin == authority {\n return account_nonce + 1;\n }\n }\n // Return current nonce if authority is not the sender of transaction.\n account_nonce\n }\n }\n}\n\nfn write_delegation>(\n ccx: &mut CheatsCtxt<'_, CTX>,\n auth: SignedAuthorization,\n) -> Result<()> {\n let authority = auth.recover_authority().map_err(|e| format!(\"{e}\"))?;\n let account_nonce = {\n let authority_acc = ccx.ecx.journal_mut().load_account(authority)?;\n authority_acc.info.nonce\n };\n\n let expected_nonce = next_delegation_nonce(\n &ccx.state.active_delegations,\n authority,\n &ccx.state.broadcast,\n account_nonce,\n );\n\n if expected_nonce != auth.nonce {\n return Err(format!(\n \"invalid nonce for {authority:?}: expected {expected_nonce}, got {}\",\n auth.nonce\n )\n .into());\n }\n\n if auth.address.is_zero() {\n // Set empty code if the delegation address of authority is 0x.\n // See https://github.com/ethereum/EIPs/blob/master/EIPS/eip-7702.md#behavior.\n ccx.ecx.journal_mut().set_code_with_hash(authority, Bytecode::default(), KECCAK_EMPTY);\n } else {\n let bytecode = Bytecode::new_eip7702(*auth.address());\n ccx.ecx.journal_mut().set_code(authority, bytecode);\n }\n Ok(())\n}\n\nimpl Cheatcode for attachBlobCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { blob } = self;\n ensure!(\n ccx.ecx.cfg().spec().into() >= SpecId::CANCUN,\n \"`attachBlob` is not supported before the Cancun hard fork; \\\n see EIP-4844: https://eips.ethereum.org/EIPS/eip-4844\"\n );\n let sidecar: SidecarBuilder = SidecarBuilder::from_slice(blob);\n let sidecar_variant = if ccx.ecx.cfg().spec().into() < SpecId::OSAKA {\n sidecar.build_4844().map_err(|e| format!(\"{e}\"))?.into()\n } else {\n sidecar.build_7594().map_err(|e| format!(\"{e}\"))?.into()\n };\n ccx.state.active_blob_sidecar = Some(sidecar_variant);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for startBroadcast_0Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self {} = self;\n broadcast(ccx, None, false)\n }\n}\n\nimpl Cheatcode for startBroadcast_1Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { signer } = self;\n broadcast(ccx, Some(signer), false)\n }\n}\n\nimpl Cheatcode for startBroadcast_2Call {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { privateKey } = self;\n broadcast_key(ccx, privateKey, false)\n }\n}\n\nimpl Cheatcode for stopBroadcastCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self {} = self;\n let Some(broadcast) = ccx.state.broadcast.take() else {\n bail!(\"no broadcast in progress to stop\");\n };\n debug!(target: \"cheatcodes\", ?broadcast, \"stopped\");\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for getWalletsCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let wallets = ccx.state.wallets().signers().unwrap_or_default();\n Ok(wallets.abi_encode())\n }\n}\n\n#[derive(Clone, Debug, Default)]\npub struct Broadcast {\n /// Address of the transaction origin\n pub new_origin: Address,\n /// Original caller\n pub original_caller: Address,\n /// Original `tx.origin`\n pub original_origin: Address,\n /// Depth of the broadcast\n pub depth: usize,\n /// Whether the prank stops by itself after the next call\n pub single_call: bool,\n /// Whether `vm.deployCode` cheatcode is used to deploy from code.\n pub deploy_from_code: bool,\n}\n\n/// Contains context for wallet management.\n#[derive(Debug)]\npub struct WalletsInner {\n /// All signers in scope of the script.\n pub multi_wallet: MultiWallet,\n /// Optional signer provided as `--sender` flag.\n pub provided_sender: Option
,\n}\n\n/// Cloneable wrapper around [`WalletsInner`].\n#[derive(Debug, Clone)]\npub struct Wallets {\n /// Inner data.\n pub inner: Arc>,\n}\n\nimpl Wallets {\n #[expect(missing_docs)]\n pub fn new(multi_wallet: MultiWallet, provided_sender: Option
) -> Self {\n Self { inner: Arc::new(Mutex::new(WalletsInner { multi_wallet, provided_sender })) }\n }\n\n /// Consumes [Wallets] and returns [MultiWallet].\n ///\n /// Panics if [Wallets] is still in use.\n pub fn into_multi_wallet(self) -> MultiWallet {\n Arc::into_inner(self.inner)\n .map(|m| m.into_inner().multi_wallet)\n .unwrap_or_else(|| panic!(\"not all instances were dropped\"))\n }\n\n /// Locks inner Mutex and adds a signer to the [MultiWallet].\n pub fn add_local_signer(&self, wallet: PrivateKeySigner) {\n self.inner.lock().multi_wallet.add_signer(WalletSigner::Local(wallet));\n }\n\n /// Locks inner Mutex and returns all signer addresses in the [MultiWallet].\n pub fn signers(&self) -> Result> {\n Ok(self.inner.lock().multi_wallet.signers()?.keys().copied().collect())\n }\n\n /// Number of signers in the [MultiWallet].\n pub fn len(&self) -> usize {\n let mut inner = self.inner.lock();\n inner.multi_wallet.signers().map_or(0, |signers| signers.len())\n }\n\n /// Whether the [MultiWallet] is empty.\n pub fn is_empty(&self) -> bool {\n self.len() == 0\n }\n}\n\n/// Sets up broadcasting from a script using `new_origin` as the sender.\nfn broadcast>(\n ccx: &mut CheatsCtxt<'_, CTX>,\n new_origin: Option<&Address>,\n single_call: bool,\n) -> Result {\n let depth = ccx.ecx.journal().depth();\n ensure!(\n ccx.state.get_prank(depth).is_none(),\n \"you have an active prank; broadcasting and pranks are not compatible\"\n );\n ensure!(ccx.state.broadcast.is_none(), \"a broadcast is active already\");\n\n let mut new_origin = new_origin.copied();\n\n if new_origin.is_none() {\n let mut wallets = ccx.state.wallets().inner.lock();\n if let Some(provided_sender) = wallets.provided_sender {\n new_origin = Some(provided_sender);\n } else {\n let signers = wallets.multi_wallet.signers()?;\n if signers.len() == 1 {\n let address = signers.keys().next().unwrap();\n new_origin = Some(*address);\n }\n }\n }\n let new_origin = new_origin.unwrap_or(ccx.ecx.tx().caller());\n // Ensure new origin is loaded and touched.\n let _ = journaled_account(ccx.ecx, new_origin)?;\n\n let broadcast = Broadcast {\n new_origin,\n original_caller: ccx.caller,\n original_origin: ccx.ecx.tx().caller(),\n depth,\n single_call,\n deploy_from_code: false,\n };\n debug!(target: \"cheatcodes\", ?broadcast, \"started\");\n ccx.state.broadcast = Some(broadcast);\n Ok(Default::default())\n}\n\n/// Sets up broadcasting from a script with the sender derived from `private_key`.\n/// Adds this private key to `state`'s `wallets` vector to later be used for signing\n/// if broadcast is successful.\nfn broadcast_key>(\n ccx: &mut CheatsCtxt<'_, CTX>,\n private_key: &U256,\n single_call: bool,\n) -> Result {\n let wallet = super::crypto::parse_wallet(private_key)?;\n let new_origin = wallet.address();\n\n let result = broadcast(ccx, Some(&new_origin), single_call);\n if result.is_ok() {\n let wallets = ccx.state.wallets();\n wallets.add_local_signer(wallet);\n }\n result\n}\n" }, { "path": "crates/cheatcodes/src/string.rs", "content": "//! Implementations of [`String`](spec::Group::String) cheatcodes.\n\nuse crate::{Cheatcode, Cheatcodes, Result, Vm::*};\nuse alloy_dyn_abi::{DynSolType, DynSolValue};\nuse alloy_primitives::{U256, hex};\nuse alloy_sol_types::SolValue;\n\n// address\nimpl Cheatcode for toString_0Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { value } = self;\n Ok(value.to_string().abi_encode())\n }\n}\n\n// bytes\nimpl Cheatcode for toString_1Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { value } = self;\n Ok(value.to_string().abi_encode())\n }\n}\n\n// bytes32\nimpl Cheatcode for toString_2Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { value } = self;\n Ok(value.to_string().abi_encode())\n }\n}\n\n// bool\nimpl Cheatcode for toString_3Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { value } = self;\n Ok(value.to_string().abi_encode())\n }\n}\n\n// uint256\nimpl Cheatcode for toString_4Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { value } = self;\n Ok(value.to_string().abi_encode())\n }\n}\n\n// int256\nimpl Cheatcode for toString_5Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { value } = self;\n Ok(value.to_string().abi_encode())\n }\n}\n\nimpl Cheatcode for parseBytesCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { stringifiedValue } = self;\n parse(stringifiedValue, &DynSolType::Bytes)\n }\n}\n\nimpl Cheatcode for parseAddressCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { stringifiedValue } = self;\n parse(stringifiedValue, &DynSolType::Address)\n }\n}\n\nimpl Cheatcode for parseUintCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { stringifiedValue } = self;\n parse(stringifiedValue, &DynSolType::Uint(256))\n }\n}\n\nimpl Cheatcode for parseIntCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { stringifiedValue } = self;\n parse(stringifiedValue, &DynSolType::Int(256))\n }\n}\n\nimpl Cheatcode for parseBytes32Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { stringifiedValue } = self;\n parse(stringifiedValue, &DynSolType::FixedBytes(32))\n }\n}\n\nimpl Cheatcode for parseBoolCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { stringifiedValue } = self;\n parse(stringifiedValue, &DynSolType::Bool)\n }\n}\n\nimpl Cheatcode for toLowercaseCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { input } = self;\n Ok(input.to_lowercase().abi_encode())\n }\n}\n\nimpl Cheatcode for toUppercaseCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { input } = self;\n Ok(input.to_uppercase().abi_encode())\n }\n}\n\nimpl Cheatcode for trimCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { input } = self;\n Ok(input.trim().abi_encode())\n }\n}\n\nimpl Cheatcode for replaceCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { input, from, to } = self;\n Ok(input.replace(from, to).abi_encode())\n }\n}\n\nimpl Cheatcode for splitCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { input, delimiter } = self;\n let parts: Vec<&str> = input.split(delimiter).collect();\n Ok(parts.abi_encode())\n }\n}\n\nimpl Cheatcode for indexOfCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { input, key } = self;\n Ok(input.find(key).map(U256::from).unwrap_or(U256::MAX).abi_encode())\n }\n}\n\nimpl Cheatcode for containsCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { subject, search } = self;\n Ok(subject.contains(search).abi_encode())\n }\n}\n\npub(super) fn parse(s: &str, ty: &DynSolType) -> Result {\n parse_value(s, ty).map(|v| v.abi_encode())\n}\n\npub(super) fn parse_array(values: I, ty: &DynSolType) -> Result\nwhere\n I: IntoIterator,\n S: AsRef,\n{\n let mut values = values.into_iter();\n match values.next() {\n Some(first) if !first.as_ref().is_empty() => std::iter::once(first)\n .chain(values)\n .map(|s| parse_value(s.as_ref(), ty))\n .collect::, _>>()\n .map(|vec| DynSolValue::Array(vec).abi_encode()),\n // return the empty encoded Bytes when values is empty or the first element is empty\n _ => Ok(\"\".abi_encode()),\n }\n}\n\npub(super) fn parse_value(s: &str, ty: &DynSolType) -> Result {\n match ty.coerce_str(s) {\n Ok(value) => Ok(value),\n Err(e) => match parse_value_fallback(s, ty) {\n Some(Ok(value)) => Ok(value),\n Some(Err(e2)) => Err(fmt_err!(\"failed parsing {s:?} as type `{ty}`: {e2}\")),\n None => Err(fmt_err!(\"failed parsing {s:?} as type `{ty}`: {e}\")),\n },\n }\n}\n\n// More lenient parsers than `coerce_str`.\nfn parse_value_fallback(s: &str, ty: &DynSolType) -> Option> {\n match ty {\n DynSolType::Bool => {\n let b = match s {\n \"1\" => true,\n \"0\" => false,\n s if s.eq_ignore_ascii_case(\"true\") => true,\n s if s.eq_ignore_ascii_case(\"false\") => false,\n _ => return None,\n };\n return Some(Ok(DynSolValue::Bool(b)));\n }\n DynSolType::Int(_)\n | DynSolType::Uint(_)\n | DynSolType::FixedBytes(_)\n | DynSolType::Bytes\n if !s.starts_with(\"0x\") && hex::check_raw(s) =>\n {\n return Some(Err(\"missing hex prefix (\\\"0x\\\") for hex string\"));\n }\n _ => {}\n }\n None\n}\n" }, { "path": "crates/cheatcodes/src/test/assert.rs", "content": "use crate::{CheatcodesExecutor, CheatsCtxt, EthCheatCtx, Result, Vm::*};\nuse alloy_primitives::{I256, U256, U512};\nuse foundry_evm_core::{\n abi::console::{format_units_int, format_units_uint},\n backend::{DatabaseExt, GLOBAL_FAIL_SLOT},\n constants::CHEATCODE_ADDRESS,\n};\nuse itertools::Itertools;\nuse revm::context::{ContextTr, JournalTr};\nuse std::{borrow::Cow, fmt};\n\nconst EQ_REL_DELTA_RESOLUTION: U256 = U256::from_limbs([18, 0, 0, 0]);\n\nstruct ComparisonAssertionError<'a, T> {\n kind: AssertionKind,\n left: &'a T,\n right: &'a T,\n}\n\n#[derive(Clone, Copy)]\nenum AssertionKind {\n Eq,\n Ne,\n Gt,\n Ge,\n Lt,\n Le,\n}\n\nimpl AssertionKind {\n fn inverse(self) -> Self {\n match self {\n Self::Eq => Self::Ne,\n Self::Ne => Self::Eq,\n Self::Gt => Self::Le,\n Self::Ge => Self::Lt,\n Self::Lt => Self::Ge,\n Self::Le => Self::Gt,\n }\n }\n\n fn to_str(self) -> &'static str {\n match self {\n Self::Eq => \"==\",\n Self::Ne => \"!=\",\n Self::Gt => \">\",\n Self::Ge => \">=\",\n Self::Lt => \"<\",\n Self::Le => \"<=\",\n }\n }\n}\n\nimpl ComparisonAssertionError<'_, T> {\n fn format_values(&self, f: impl Fn(&T) -> D) -> String {\n format!(\"{} {} {}\", f(self.left), self.kind.inverse().to_str(), f(self.right))\n }\n}\n\nimpl ComparisonAssertionError<'_, T> {\n fn format_for_values(&self) -> String {\n self.format_values(T::to_string)\n }\n}\n\nimpl ComparisonAssertionError<'_, Vec> {\n fn format_for_arrays(&self) -> String {\n self.format_values(|v| format!(\"[{}]\", v.iter().format(\", \")))\n }\n}\n\nimpl ComparisonAssertionError<'_, U256> {\n fn format_with_decimals(&self, decimals: &U256) -> String {\n self.format_values(|v| format_units_uint(v, decimals))\n }\n}\n\nimpl ComparisonAssertionError<'_, I256> {\n fn format_with_decimals(&self, decimals: &U256) -> String {\n self.format_values(|v| format_units_int(v, decimals))\n }\n}\n\n#[derive(thiserror::Error, Debug)]\n#[error(\"{left} !~= {right} (max delta: {max_delta}, real delta: {real_delta})\")]\nstruct EqAbsAssertionError {\n left: T,\n right: T,\n max_delta: D,\n real_delta: D,\n}\n\nimpl EqAbsAssertionError {\n fn format_with_decimals(&self, decimals: &U256) -> String {\n format!(\n \"{} !~= {} (max delta: {}, real delta: {})\",\n format_units_uint(&self.left, decimals),\n format_units_uint(&self.right, decimals),\n format_units_uint(&self.max_delta, decimals),\n format_units_uint(&self.real_delta, decimals),\n )\n }\n}\n\nimpl EqAbsAssertionError {\n fn format_with_decimals(&self, decimals: &U256) -> String {\n format!(\n \"{} !~= {} (max delta: {}, real delta: {})\",\n format_units_int(&self.left, decimals),\n format_units_int(&self.right, decimals),\n format_units_uint(&self.max_delta, decimals),\n format_units_uint(&self.real_delta, decimals),\n )\n }\n}\n\nfn format_delta_percent(delta: &U256) -> String {\n format!(\"{}%\", format_units_uint(delta, &(EQ_REL_DELTA_RESOLUTION - U256::from(2))))\n}\n\n#[derive(Debug)]\nenum EqRelDelta {\n Defined(U256),\n Undefined,\n}\n\nimpl fmt::Display for EqRelDelta {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n match self {\n Self::Defined(delta) => write!(f, \"{}\", format_delta_percent(delta)),\n Self::Undefined => write!(f, \"undefined\"),\n }\n }\n}\n\n#[derive(thiserror::Error, Debug)]\n#[error(\n \"{left} !~= {right} (max delta: {}, real delta: {})\",\n format_delta_percent(max_delta),\n real_delta\n)]\nstruct EqRelAssertionFailure {\n left: T,\n right: T,\n max_delta: U256,\n real_delta: EqRelDelta,\n}\n\n#[derive(thiserror::Error, Debug)]\nenum EqRelAssertionError {\n #[error(transparent)]\n Failure(Box>),\n #[error(\"overflow in delta calculation\")]\n Overflow,\n}\n\nimpl EqRelAssertionError {\n fn format_with_decimals(&self, decimals: &U256) -> String {\n match self {\n Self::Failure(f) => format!(\n \"{} !~= {} (max delta: {}, real delta: {})\",\n format_units_uint(&f.left, decimals),\n format_units_uint(&f.right, decimals),\n format_delta_percent(&f.max_delta),\n &f.real_delta,\n ),\n Self::Overflow => self.to_string(),\n }\n }\n}\n\nimpl EqRelAssertionError {\n fn format_with_decimals(&self, decimals: &U256) -> String {\n match self {\n Self::Failure(f) => format!(\n \"{} !~= {} (max delta: {}, real delta: {})\",\n format_units_int(&f.left, decimals),\n format_units_int(&f.right, decimals),\n format_delta_percent(&f.max_delta),\n &f.real_delta,\n ),\n Self::Overflow => self.to_string(),\n }\n }\n}\n\ntype ComparisonResult<'a, T> = Result<(), ComparisonAssertionError<'a, T>>;\n\n#[cold]\nfn handle_assertion_result, E>(\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n err: E,\n error_formatter: Option<&dyn Fn(&E) -> String>,\n error_msg: Option<&str>,\n) -> Result {\n let error_msg = error_msg.unwrap_or(\"assertion failed\");\n let msg = if let Some(error_formatter) = error_formatter {\n Cow::Owned(format!(\"{error_msg}: {}\", error_formatter(&err)))\n } else {\n Cow::Borrowed(error_msg)\n };\n handle_assertion_result_mono(ccx, executor, msg)\n}\n\nfn handle_assertion_result_mono>(\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n msg: Cow<'_, str>,\n) -> Result {\n if ccx.state.config.assertions_revert {\n Err(msg.into_owned().into())\n } else {\n executor.console_log(ccx.state, &msg);\n ccx.ecx.journal_mut().sstore(CHEATCODE_ADDRESS, GLOBAL_FAIL_SLOT, U256::from(1))?;\n Ok(Default::default())\n }\n}\n\n/// Implements [crate::Cheatcode] for pairs of cheatcodes.\n///\n/// Accepts a list of pairs of cheatcodes, where the first cheatcode is the one that doesn't contain\n/// a custom error message, and the second one contains it at `error` field.\n///\n/// Passed `args` are the common arguments for both cheatcode structs (excluding `error` field).\n///\n/// Macro also accepts an optional closure that formats the error returned by the assertion.\nmacro_rules! impl_assertions {\n (|$($arg:ident),*| $body:expr, false, $(($no_error:ident, $with_error:ident)),* $(,)?) => {\n impl_assertions! { @args_tt |($($arg),*)| $body, None, $(($no_error, $with_error)),* }\n };\n (|$($arg:ident),*| $body:expr, $(($no_error:ident, $with_error:ident)),* $(,)?) => {\n impl_assertions! { @args_tt |($($arg),*)| $body, Some(&ToString::to_string), $(($no_error, $with_error)),* }\n };\n (|$($arg:ident),*| $body:expr, $error_formatter:expr, $(($no_error:ident, $with_error:ident)),* $(,)?) => {\n impl_assertions! { @args_tt |($($arg),*)| $body, Some(&$error_formatter), $(($no_error, $with_error)),* }\n };\n\n // We convert args to `tt` and later expand them back into tuple to allow usage of expanded args inside of\n // each assertion type context.\n (@args_tt |$args:tt| $body:expr, $error_formatter:expr, $(($no_error:ident, $with_error:ident)),* $(,)?) => {\n $(\n impl_assertions! { @impl $no_error, $with_error, $args, $body, $error_formatter }\n )*\n };\n\n (@impl $no_error:ident, $with_error:ident, ($($arg:ident),*), $body:expr, $error_formatter:expr) => {\n impl crate::Cheatcode for $no_error {\n fn apply_full(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n ) -> Result {\n let Self { $($arg),* } = self;\n match $body {\n Ok(()) => Ok(Default::default()),\n Err(err) => handle_assertion_result(ccx, executor, err, $error_formatter, None)\n }\n }\n }\n\n impl crate::Cheatcode for $with_error {\n fn apply_full(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n ) -> Result {\n let Self { $($arg,)* error } = self;\n match $body {\n Ok(()) => Ok(Default::default()),\n Err(err) => handle_assertion_result(ccx, executor, err, $error_formatter, Some(error))\n }\n }\n }\n };\n}\n\nimpl_assertions! {\n |condition| assert_true(*condition),\n false,\n (assertTrue_0Call, assertTrue_1Call),\n}\n\nimpl_assertions! {\n |condition| assert_false(*condition),\n false,\n (assertFalse_0Call, assertFalse_1Call),\n}\n\nimpl_assertions! {\n |left, right| assert_eq(left, right),\n ComparisonAssertionError::format_for_values,\n (assertEq_0Call, assertEq_1Call),\n (assertEq_2Call, assertEq_3Call),\n (assertEq_4Call, assertEq_5Call),\n (assertEq_6Call, assertEq_7Call),\n (assertEq_8Call, assertEq_9Call),\n (assertEq_10Call, assertEq_11Call),\n (assertEq_12Call, assertEq_13Call),\n}\n\nimpl_assertions! {\n |left, right| assert_eq(left, right),\n ComparisonAssertionError::format_for_arrays,\n (assertEq_14Call, assertEq_15Call),\n (assertEq_16Call, assertEq_17Call),\n (assertEq_18Call, assertEq_19Call),\n (assertEq_20Call, assertEq_21Call),\n (assertEq_22Call, assertEq_23Call),\n (assertEq_24Call, assertEq_25Call),\n (assertEq_26Call, assertEq_27Call),\n}\n\nimpl_assertions! {\n |left, right, decimals| assert_eq(left, right),\n |e| e.format_with_decimals(decimals),\n (assertEqDecimal_0Call, assertEqDecimal_1Call),\n (assertEqDecimal_2Call, assertEqDecimal_3Call),\n}\n\nimpl_assertions! {\n |left, right| assert_not_eq(left, right),\n ComparisonAssertionError::format_for_values,\n (assertNotEq_0Call, assertNotEq_1Call),\n (assertNotEq_2Call, assertNotEq_3Call),\n (assertNotEq_4Call, assertNotEq_5Call),\n (assertNotEq_6Call, assertNotEq_7Call),\n (assertNotEq_8Call, assertNotEq_9Call),\n (assertNotEq_10Call, assertNotEq_11Call),\n (assertNotEq_12Call, assertNotEq_13Call),\n}\n\nimpl_assertions! {\n |left, right| assert_not_eq(left, right),\n ComparisonAssertionError::format_for_arrays,\n (assertNotEq_14Call, assertNotEq_15Call),\n (assertNotEq_16Call, assertNotEq_17Call),\n (assertNotEq_18Call, assertNotEq_19Call),\n (assertNotEq_20Call, assertNotEq_21Call),\n (assertNotEq_22Call, assertNotEq_23Call),\n (assertNotEq_24Call, assertNotEq_25Call),\n (assertNotEq_26Call, assertNotEq_27Call),\n}\n\nimpl_assertions! {\n |left, right, decimals| assert_not_eq(left, right),\n |e| e.format_with_decimals(decimals),\n (assertNotEqDecimal_0Call, assertNotEqDecimal_1Call),\n (assertNotEqDecimal_2Call, assertNotEqDecimal_3Call),\n}\n\nimpl_assertions! {\n |left, right| assert_gt(left, right),\n ComparisonAssertionError::format_for_values,\n (assertGt_0Call, assertGt_1Call),\n (assertGt_2Call, assertGt_3Call),\n}\n\nimpl_assertions! {\n |left, right, decimals| assert_gt(left, right),\n |e| e.format_with_decimals(decimals),\n (assertGtDecimal_0Call, assertGtDecimal_1Call),\n (assertGtDecimal_2Call, assertGtDecimal_3Call),\n}\n\nimpl_assertions! {\n |left, right| assert_ge(left, right),\n ComparisonAssertionError::format_for_values,\n (assertGe_0Call, assertGe_1Call),\n (assertGe_2Call, assertGe_3Call),\n}\n\nimpl_assertions! {\n |left, right, decimals| assert_ge(left, right),\n |e| e.format_with_decimals(decimals),\n (assertGeDecimal_0Call, assertGeDecimal_1Call),\n (assertGeDecimal_2Call, assertGeDecimal_3Call),\n}\n\nimpl_assertions! {\n |left, right| assert_lt(left, right),\n ComparisonAssertionError::format_for_values,\n (assertLt_0Call, assertLt_1Call),\n (assertLt_2Call, assertLt_3Call),\n}\n\nimpl_assertions! {\n |left, right, decimals| assert_lt(left, right),\n |e| e.format_with_decimals(decimals),\n (assertLtDecimal_0Call, assertLtDecimal_1Call),\n (assertLtDecimal_2Call, assertLtDecimal_3Call),\n}\n\nimpl_assertions! {\n |left, right| assert_le(left, right),\n ComparisonAssertionError::format_for_values,\n (assertLe_0Call, assertLe_1Call),\n (assertLe_2Call, assertLe_3Call),\n}\n\nimpl_assertions! {\n |left, right, decimals| assert_le(left, right),\n |e| e.format_with_decimals(decimals),\n (assertLeDecimal_0Call, assertLeDecimal_1Call),\n (assertLeDecimal_2Call, assertLeDecimal_3Call),\n}\n\nimpl_assertions! {\n |left, right, maxDelta| uint_assert_approx_eq_abs(*left, *right, *maxDelta),\n (assertApproxEqAbs_0Call, assertApproxEqAbs_1Call),\n}\n\nimpl_assertions! {\n |left, right, maxDelta| int_assert_approx_eq_abs(*left, *right, *maxDelta),\n (assertApproxEqAbs_2Call, assertApproxEqAbs_3Call),\n}\n\nimpl_assertions! {\n |left, right, decimals, maxDelta| uint_assert_approx_eq_abs(*left, *right, *maxDelta),\n |e| e.format_with_decimals(decimals),\n (assertApproxEqAbsDecimal_0Call, assertApproxEqAbsDecimal_1Call),\n}\n\nimpl_assertions! {\n |left, right, decimals, maxDelta| int_assert_approx_eq_abs(*left, *right, *maxDelta),\n |e| e.format_with_decimals(decimals),\n (assertApproxEqAbsDecimal_2Call, assertApproxEqAbsDecimal_3Call),\n}\n\nimpl_assertions! {\n |left, right, maxPercentDelta| uint_assert_approx_eq_rel(*left, *right, *maxPercentDelta),\n (assertApproxEqRel_0Call, assertApproxEqRel_1Call),\n}\n\nimpl_assertions! {\n |left, right, maxPercentDelta| int_assert_approx_eq_rel(*left, *right, *maxPercentDelta),\n (assertApproxEqRel_2Call, assertApproxEqRel_3Call),\n}\n\nimpl_assertions! {\n |left, right, decimals, maxPercentDelta| uint_assert_approx_eq_rel(*left, *right, *maxPercentDelta),\n |e| e.format_with_decimals(decimals),\n (assertApproxEqRelDecimal_0Call, assertApproxEqRelDecimal_1Call),\n}\n\nimpl_assertions! {\n |left, right, decimals, maxPercentDelta| int_assert_approx_eq_rel(*left, *right, *maxPercentDelta),\n |e| e.format_with_decimals(decimals),\n (assertApproxEqRelDecimal_2Call, assertApproxEqRelDecimal_3Call),\n}\n\nfn assert_true(condition: bool) -> Result<(), ()> {\n if condition { Ok(()) } else { Err(()) }\n}\n\nfn assert_false(condition: bool) -> Result<(), ()> {\n assert_true(!condition)\n}\n\nfn assert_eq<'a, T: PartialEq>(left: &'a T, right: &'a T) -> ComparisonResult<'a, T> {\n if left == right {\n Ok(())\n } else {\n Err(ComparisonAssertionError { kind: AssertionKind::Eq, left, right })\n }\n}\n\nfn assert_not_eq<'a, T: PartialEq>(left: &'a T, right: &'a T) -> ComparisonResult<'a, T> {\n if left != right {\n Ok(())\n } else {\n Err(ComparisonAssertionError { kind: AssertionKind::Ne, left, right })\n }\n}\n\nfn assert_gt<'a, T: PartialOrd>(left: &'a T, right: &'a T) -> ComparisonResult<'a, T> {\n if left > right {\n Ok(())\n } else {\n Err(ComparisonAssertionError { kind: AssertionKind::Gt, left, right })\n }\n}\n\nfn assert_ge<'a, T: PartialOrd>(left: &'a T, right: &'a T) -> ComparisonResult<'a, T> {\n if left >= right {\n Ok(())\n } else {\n Err(ComparisonAssertionError { kind: AssertionKind::Ge, left, right })\n }\n}\n\nfn assert_lt<'a, T: PartialOrd>(left: &'a T, right: &'a T) -> ComparisonResult<'a, T> {\n if left < right {\n Ok(())\n } else {\n Err(ComparisonAssertionError { kind: AssertionKind::Lt, left, right })\n }\n}\n\nfn assert_le<'a, T: PartialOrd>(left: &'a T, right: &'a T) -> ComparisonResult<'a, T> {\n if left <= right {\n Ok(())\n } else {\n Err(ComparisonAssertionError { kind: AssertionKind::Le, left, right })\n }\n}\n\nfn get_delta_int(left: I256, right: I256) -> U256 {\n let (left_sign, left_abs) = left.into_sign_and_abs();\n let (right_sign, right_abs) = right.into_sign_and_abs();\n\n if left_sign == right_sign {\n if left_abs > right_abs { left_abs - right_abs } else { right_abs - left_abs }\n } else {\n left_abs.wrapping_add(right_abs)\n }\n}\n\n/// Calculates the relative delta for an absolute difference.\n///\n/// Avoids overflow in the multiplication by using [`U512`] to hold the intermediary result.\nfn calc_delta_full(abs_diff: U256, right: U256) -> Result> {\n let delta = U512::from(abs_diff) * U512::from(10).pow(U512::from(EQ_REL_DELTA_RESOLUTION))\n / U512::from(right);\n U256::checked_from_limbs_slice(delta.as_limbs()).ok_or(EqRelAssertionError::Overflow)\n}\n\nfn uint_assert_approx_eq_abs(\n left: U256,\n right: U256,\n max_delta: U256,\n) -> Result<(), Box>> {\n let delta = left.abs_diff(right);\n\n if delta <= max_delta {\n Ok(())\n } else {\n Err(Box::new(EqAbsAssertionError { left, right, max_delta, real_delta: delta }))\n }\n}\n\nfn int_assert_approx_eq_abs(\n left: I256,\n right: I256,\n max_delta: U256,\n) -> Result<(), Box>> {\n let delta = get_delta_int(left, right);\n\n if delta <= max_delta {\n Ok(())\n } else {\n Err(Box::new(EqAbsAssertionError { left, right, max_delta, real_delta: delta }))\n }\n}\n\nfn uint_assert_approx_eq_rel(\n left: U256,\n right: U256,\n max_delta: U256,\n) -> Result<(), EqRelAssertionError> {\n if right.is_zero() {\n if left.is_zero() {\n return Ok(());\n } else {\n return Err(EqRelAssertionError::Failure(Box::new(EqRelAssertionFailure {\n left,\n right,\n max_delta,\n real_delta: EqRelDelta::Undefined,\n })));\n };\n }\n\n let delta = calc_delta_full::(left.abs_diff(right), right)?;\n\n if delta <= max_delta {\n Ok(())\n } else {\n Err(EqRelAssertionError::Failure(Box::new(EqRelAssertionFailure {\n left,\n right,\n max_delta,\n real_delta: EqRelDelta::Defined(delta),\n })))\n }\n}\n\nfn int_assert_approx_eq_rel(\n left: I256,\n right: I256,\n max_delta: U256,\n) -> Result<(), EqRelAssertionError> {\n if right.is_zero() {\n if left.is_zero() {\n return Ok(());\n } else {\n return Err(EqRelAssertionError::Failure(Box::new(EqRelAssertionFailure {\n left,\n right,\n max_delta,\n real_delta: EqRelDelta::Undefined,\n })));\n }\n }\n\n let delta = calc_delta_full::(get_delta_int(left, right), right.unsigned_abs())?;\n\n if delta <= max_delta {\n Ok(())\n } else {\n Err(EqRelAssertionError::Failure(Box::new(EqRelAssertionFailure {\n left,\n right,\n max_delta,\n real_delta: EqRelDelta::Defined(delta),\n })))\n }\n}\n" }, { "path": "crates/cheatcodes/src/test/assume.rs", "content": "use crate::{Cheatcode, Cheatcodes, CheatsCtxt, Error, Result};\nuse alloy_primitives::Address;\nuse foundry_evm_core::constants::MAGIC_ASSUME;\nuse revm::context::{ContextTr, JournalTr};\nuse spec::Vm::{\n PotentialRevert, assumeCall, assumeNoRevert_0Call, assumeNoRevert_1Call, assumeNoRevert_2Call,\n};\nuse std::fmt::Debug;\n\n#[derive(Clone, Debug)]\npub struct AssumeNoRevert {\n /// The call depth at which the cheatcode was added.\n pub depth: usize,\n /// Acceptable revert parameters for the next call, to be thrown out if they are encountered;\n /// reverts with parameters not specified here will count as normal reverts and not rejects\n /// towards the counter.\n pub reasons: Vec,\n /// Address that reverted the call.\n pub reverted_by: Option
,\n}\n\n/// Parameters for a single anticipated revert, to be thrown out if encountered.\n#[derive(Clone, Debug)]\npub struct AcceptableRevertParameters {\n /// The expected revert data returned by the revert\n pub reason: Vec,\n /// If true then only the first 4 bytes of expected data returned by the revert are checked.\n pub partial_match: bool,\n /// Contract expected to revert next call.\n pub reverter: Option
,\n}\n\nimpl AcceptableRevertParameters {\n fn from(potential_revert: &PotentialRevert) -> Self {\n Self {\n reason: potential_revert.revertData.to_vec(),\n partial_match: potential_revert.partialMatch,\n reverter: if potential_revert.reverter == Address::ZERO {\n None\n } else {\n Some(potential_revert.reverter)\n },\n }\n }\n}\n\nimpl Cheatcode for assumeCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { condition } = self;\n if *condition { Ok(Default::default()) } else { Err(Error::from(MAGIC_ASSUME)) }\n }\n}\n\nimpl Cheatcode for assumeNoRevert_0Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n assume_no_revert(ccx.state, ccx.ecx.journal().depth(), vec![])\n }\n}\n\nimpl Cheatcode for assumeNoRevert_1Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { potentialRevert } = self;\n assume_no_revert(\n ccx.state,\n ccx.ecx.journal().depth(),\n vec![AcceptableRevertParameters::from(potentialRevert)],\n )\n }\n}\n\nimpl Cheatcode for assumeNoRevert_2Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { potentialReverts } = self;\n assume_no_revert(\n ccx.state,\n ccx.ecx.journal().depth(),\n potentialReverts.iter().map(AcceptableRevertParameters::from).collect(),\n )\n }\n}\n\nfn assume_no_revert(\n state: &mut Cheatcodes,\n depth: usize,\n parameters: Vec,\n) -> Result {\n ensure!(\n state.assume_no_revert.is_none(),\n \"you must make another external call prior to calling assumeNoRevert again\"\n );\n\n state.assume_no_revert = Some(AssumeNoRevert { depth, reasons: parameters, reverted_by: None });\n\n Ok(Default::default())\n}\n" }, { "path": "crates/cheatcodes/src/test/expect.rs", "content": "use std::{\n collections::VecDeque,\n fmt::{self, Display},\n};\n\nuse crate::{Cheatcode, Cheatcodes, CheatsCtxt, Error, Result, Vm::*};\nuse alloy_dyn_abi::{DynSolValue, EventExt};\nuse alloy_json_abi::Event;\nuse alloy_primitives::{\n Address, Bytes, LogData as RawLog, U256, hex,\n map::{AddressHashMap, HashMap, hash_map::Entry},\n};\nuse foundry_common::{abi::get_indexed_event, fmt::format_token};\nuse foundry_evm_traces::DecodedCallLog;\nuse revm::{\n context::{ContextTr, JournalTr},\n interpreter::{\n InstructionResult, Interpreter, InterpreterAction, interpreter_types::LoopControl,\n },\n};\n\nuse super::revert_handlers::RevertParameters;\n/// Tracks the expected calls per address.\n///\n/// For each address, we track the expected calls per call data. We track it in such manner\n/// so that we don't mix together calldatas that only contain selectors and calldatas that contain\n/// selector and arguments (partial and full matches).\n///\n/// This then allows us to customize the matching behavior for each call data on the\n/// `ExpectedCallData` struct and track how many times we've actually seen the call on the second\n/// element of the tuple.\npub type ExpectedCallTracker = HashMap>;\n\n#[derive(Clone, Debug)]\npub struct ExpectedCallData {\n /// The expected value sent in the call\n pub value: Option,\n /// The expected gas supplied to the call\n pub gas: Option,\n /// The expected *minimum* gas supplied to the call\n pub min_gas: Option,\n /// The number of times the call is expected to be made.\n /// If the type of call is `NonCount`, this is the lower bound for the number of calls\n /// that must be seen.\n /// If the type of call is `Count`, this is the exact number of calls that must be seen.\n pub count: u64,\n /// The type of expected call.\n pub call_type: ExpectedCallType,\n}\n\n/// The type of expected call.\n#[derive(Clone, Debug, PartialEq, Eq)]\npub enum ExpectedCallType {\n /// The call is expected to be made at least once.\n NonCount,\n /// The exact number of calls expected.\n Count,\n}\n\n/// The type of expected revert.\n#[derive(Clone, Debug)]\npub enum ExpectedRevertKind {\n /// Expects revert from the next non-cheatcode call.\n Default,\n /// Expects revert from the next cheatcode call.\n ///\n /// The `pending_processing` flag is used to track whether we have exited\n /// `expectCheatcodeRevert` context or not.\n /// We have to track it to avoid expecting `expectCheatcodeRevert` call to revert itself.\n Cheatcode { pending_processing: bool },\n}\n\n#[derive(Clone, Debug)]\npub struct ExpectedRevert {\n /// The expected data returned by the revert, None being any.\n pub reason: Option,\n /// The depth at which the revert is expected.\n pub depth: usize,\n /// The type of expected revert.\n pub kind: ExpectedRevertKind,\n /// If true then only the first 4 bytes of expected data returned by the revert are checked.\n pub partial_match: bool,\n /// Contract expected to revert next call.\n pub reverter: Option
,\n /// Address that reverted the call.\n pub reverted_by: Option
,\n /// Max call depth reached during next call execution.\n pub max_depth: usize,\n /// Number of times this revert is expected.\n pub count: u64,\n /// Actual number of times this revert has been seen.\n pub actual_count: u64,\n}\n\n#[derive(Clone, Debug)]\npub struct ExpectedEmit {\n /// The depth at which we expect this emit to have occurred\n pub depth: usize,\n /// The log we expect\n pub log: Option,\n /// The checks to perform:\n /// ```text\n /// ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”¬ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”¬ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”¬ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”¬ā”€ā”€ā”€ā”€ā”\n /// ā”‚topic 0ā”‚topic 1ā”‚topic 2ā”‚topic 3ā”‚dataā”‚\n /// ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”“ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”“ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”“ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”“ā”€ā”€ā”€ā”€ā”˜\n /// ```\n pub checks: [bool; 5],\n /// If present, check originating address against this\n pub address: Option
,\n /// If present, relax the requirement that topic 0 must be present. This allows anonymous\n /// events with no indexed topics to be matched.\n pub anonymous: bool,\n /// Whether the log was actually found in the subcalls\n pub found: bool,\n /// Number of times the log is expected to be emitted\n pub count: u64,\n /// Stores mismatch details if a log didn't match\n pub mismatch_error: Option,\n}\n\n#[derive(Clone, Debug)]\npub struct ExpectedCreate {\n /// The address that deployed the contract\n pub deployer: Address,\n /// Runtime bytecode of the contract\n pub bytecode: Bytes,\n /// Whether deployed with CREATE or CREATE2\n pub create_scheme: CreateScheme,\n}\n\n#[derive(Clone, Debug)]\npub enum CreateScheme {\n Create,\n Create2,\n}\n\nimpl Display for CreateScheme {\n fn fmt(&self, f: &mut fmt::Formatter) -> std::fmt::Result {\n match self {\n Self::Create => write!(f, \"CREATE\"),\n Self::Create2 => write!(f, \"CREATE2\"),\n }\n }\n}\n\nimpl From for CreateScheme {\n fn from(scheme: revm::context_interface::CreateScheme) -> Self {\n match scheme {\n revm::context_interface::CreateScheme::Create => Self::Create,\n revm::context_interface::CreateScheme::Create2 { .. } => Self::Create2,\n _ => unimplemented!(\"Unsupported create scheme\"),\n }\n }\n}\n\nimpl CreateScheme {\n pub fn eq(&self, create_scheme: Self) -> bool {\n matches!(\n (self, create_scheme),\n (Self::Create, Self::Create) | (Self::Create2, Self::Create2 { .. })\n )\n }\n}\n\nimpl Cheatcode for expectCall_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { callee, data } = self;\n expect_call(state, callee, data, None, None, None, 1, ExpectedCallType::NonCount)\n }\n}\n\nimpl Cheatcode for expectCall_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { callee, data, count } = self;\n expect_call(state, callee, data, None, None, None, *count, ExpectedCallType::Count)\n }\n}\n\nimpl Cheatcode for expectCall_2Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { callee, msgValue, data } = self;\n expect_call(state, callee, data, Some(msgValue), None, None, 1, ExpectedCallType::NonCount)\n }\n}\n\nimpl Cheatcode for expectCall_3Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { callee, msgValue, data, count } = self;\n expect_call(\n state,\n callee,\n data,\n Some(msgValue),\n None,\n None,\n *count,\n ExpectedCallType::Count,\n )\n }\n}\n\nimpl Cheatcode for expectCall_4Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { callee, msgValue, gas, data } = self;\n expect_call(\n state,\n callee,\n data,\n Some(msgValue),\n Some(*gas),\n None,\n 1,\n ExpectedCallType::NonCount,\n )\n }\n}\n\nimpl Cheatcode for expectCall_5Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { callee, msgValue, gas, data, count } = self;\n expect_call(\n state,\n callee,\n data,\n Some(msgValue),\n Some(*gas),\n None,\n *count,\n ExpectedCallType::Count,\n )\n }\n}\n\nimpl Cheatcode for expectCallMinGas_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { callee, msgValue, minGas, data } = self;\n expect_call(\n state,\n callee,\n data,\n Some(msgValue),\n None,\n Some(*minGas),\n 1,\n ExpectedCallType::NonCount,\n )\n }\n}\n\nimpl Cheatcode for expectCallMinGas_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { callee, msgValue, minGas, data, count } = self;\n expect_call(\n state,\n callee,\n data,\n Some(msgValue),\n None,\n Some(*minGas),\n *count,\n ExpectedCallType::Count,\n )\n }\n}\n\nimpl Cheatcode for expectEmit_0Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { checkTopic1, checkTopic2, checkTopic3, checkData } = *self;\n expect_emit(\n ccx.state,\n ccx.ecx.journal().depth(),\n [true, checkTopic1, checkTopic2, checkTopic3, checkData],\n None,\n false,\n 1,\n )\n }\n}\n\nimpl Cheatcode for expectEmit_1Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { checkTopic1, checkTopic2, checkTopic3, checkData, emitter } = *self;\n expect_emit(\n ccx.state,\n ccx.ecx.journal().depth(),\n [true, checkTopic1, checkTopic2, checkTopic3, checkData],\n Some(emitter),\n false,\n 1,\n )\n }\n}\n\nimpl Cheatcode for expectEmit_2Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self {} = self;\n expect_emit(ccx.state, ccx.ecx.journal().depth(), [true; 5], None, false, 1)\n }\n}\n\nimpl Cheatcode for expectEmit_3Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { emitter } = *self;\n expect_emit(ccx.state, ccx.ecx.journal().depth(), [true; 5], Some(emitter), false, 1)\n }\n}\n\nimpl Cheatcode for expectEmit_4Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { checkTopic1, checkTopic2, checkTopic3, checkData, count } = *self;\n expect_emit(\n ccx.state,\n ccx.ecx.journal().depth(),\n [true, checkTopic1, checkTopic2, checkTopic3, checkData],\n None,\n false,\n count,\n )\n }\n}\n\nimpl Cheatcode for expectEmit_5Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { checkTopic1, checkTopic2, checkTopic3, checkData, emitter, count } = *self;\n expect_emit(\n ccx.state,\n ccx.ecx.journal().depth(),\n [true, checkTopic1, checkTopic2, checkTopic3, checkData],\n Some(emitter),\n false,\n count,\n )\n }\n}\n\nimpl Cheatcode for expectEmit_6Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { count } = *self;\n expect_emit(ccx.state, ccx.ecx.journal().depth(), [true; 5], None, false, count)\n }\n}\n\nimpl Cheatcode for expectEmit_7Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { emitter, count } = *self;\n expect_emit(ccx.state, ccx.ecx.journal().depth(), [true; 5], Some(emitter), false, count)\n }\n}\n\nimpl Cheatcode for expectEmitAnonymous_0Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { checkTopic0, checkTopic1, checkTopic2, checkTopic3, checkData } = *self;\n expect_emit(\n ccx.state,\n ccx.ecx.journal().depth(),\n [checkTopic0, checkTopic1, checkTopic2, checkTopic3, checkData],\n None,\n true,\n 1,\n )\n }\n}\n\nimpl Cheatcode for expectEmitAnonymous_1Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { checkTopic0, checkTopic1, checkTopic2, checkTopic3, checkData, emitter } = *self;\n expect_emit(\n ccx.state,\n ccx.ecx.journal().depth(),\n [checkTopic0, checkTopic1, checkTopic2, checkTopic3, checkData],\n Some(emitter),\n true,\n 1,\n )\n }\n}\n\nimpl Cheatcode for expectEmitAnonymous_2Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self {} = self;\n expect_emit(ccx.state, ccx.ecx.journal().depth(), [true; 5], None, true, 1)\n }\n}\n\nimpl Cheatcode for expectEmitAnonymous_3Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { emitter } = *self;\n expect_emit(ccx.state, ccx.ecx.journal().depth(), [true; 5], Some(emitter), true, 1)\n }\n}\n\nimpl Cheatcode for expectCreateCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { bytecode, deployer } = self;\n expect_create(state, bytecode.clone(), *deployer, CreateScheme::Create)\n }\n}\n\nimpl Cheatcode for expectCreate2Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { bytecode, deployer } = self;\n expect_create(state, bytecode.clone(), *deployer, CreateScheme::Create2)\n }\n}\n\nimpl Cheatcode for expectRevert_0Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self {} = self;\n expect_revert(ccx.state, None, ccx.ecx.journal().depth(), false, false, None, 1)\n }\n}\n\nimpl Cheatcode for expectRevert_1Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { revertData } = self;\n expect_revert(\n ccx.state,\n Some(revertData.as_ref()),\n ccx.ecx.journal().depth(),\n false,\n false,\n None,\n 1,\n )\n }\n}\n\nimpl Cheatcode for expectRevert_2Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { revertData } = self;\n expect_revert(ccx.state, Some(revertData), ccx.ecx.journal().depth(), false, false, None, 1)\n }\n}\n\nimpl Cheatcode for expectRevert_3Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { reverter } = self;\n expect_revert(ccx.state, None, ccx.ecx.journal().depth(), false, false, Some(*reverter), 1)\n }\n}\n\nimpl Cheatcode for expectRevert_4Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { revertData, reverter } = self;\n expect_revert(\n ccx.state,\n Some(revertData.as_ref()),\n ccx.ecx.journal().depth(),\n false,\n false,\n Some(*reverter),\n 1,\n )\n }\n}\n\nimpl Cheatcode for expectRevert_5Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { revertData, reverter } = self;\n expect_revert(\n ccx.state,\n Some(revertData),\n ccx.ecx.journal().depth(),\n false,\n false,\n Some(*reverter),\n 1,\n )\n }\n}\n\nimpl Cheatcode for expectRevert_6Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { count } = self;\n expect_revert(ccx.state, None, ccx.ecx.journal().depth(), false, false, None, *count)\n }\n}\n\nimpl Cheatcode for expectRevert_7Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { revertData, count } = self;\n expect_revert(\n ccx.state,\n Some(revertData.as_ref()),\n ccx.ecx.journal().depth(),\n false,\n false,\n None,\n *count,\n )\n }\n}\n\nimpl Cheatcode for expectRevert_8Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { revertData, count } = self;\n expect_revert(\n ccx.state,\n Some(revertData),\n ccx.ecx.journal().depth(),\n false,\n false,\n None,\n *count,\n )\n }\n}\n\nimpl Cheatcode for expectRevert_9Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { reverter, count } = self;\n expect_revert(\n ccx.state,\n None,\n ccx.ecx.journal().depth(),\n false,\n false,\n Some(*reverter),\n *count,\n )\n }\n}\n\nimpl Cheatcode for expectRevert_10Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { revertData, reverter, count } = self;\n expect_revert(\n ccx.state,\n Some(revertData.as_ref()),\n ccx.ecx.journal().depth(),\n false,\n false,\n Some(*reverter),\n *count,\n )\n }\n}\n\nimpl Cheatcode for expectRevert_11Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { revertData, reverter, count } = self;\n expect_revert(\n ccx.state,\n Some(revertData),\n ccx.ecx.journal().depth(),\n false,\n false,\n Some(*reverter),\n *count,\n )\n }\n}\n\nimpl Cheatcode for expectPartialRevert_0Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { revertData } = self;\n expect_revert(\n ccx.state,\n Some(revertData.as_ref()),\n ccx.ecx.journal().depth(),\n false,\n true,\n None,\n 1,\n )\n }\n}\n\nimpl Cheatcode for expectPartialRevert_1Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { revertData, reverter } = self;\n expect_revert(\n ccx.state,\n Some(revertData.as_ref()),\n ccx.ecx.journal().depth(),\n false,\n true,\n Some(*reverter),\n 1,\n )\n }\n}\n\nimpl Cheatcode for _expectCheatcodeRevert_0Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n expect_revert(ccx.state, None, ccx.ecx.journal().depth(), true, false, None, 1)\n }\n}\n\nimpl Cheatcode for _expectCheatcodeRevert_1Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { revertData } = self;\n expect_revert(\n ccx.state,\n Some(revertData.as_ref()),\n ccx.ecx.journal().depth(),\n true,\n false,\n None,\n 1,\n )\n }\n}\n\nimpl Cheatcode for _expectCheatcodeRevert_2Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { revertData } = self;\n expect_revert(ccx.state, Some(revertData), ccx.ecx.journal().depth(), true, false, None, 1)\n }\n}\n\nimpl Cheatcode for expectSafeMemoryCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { min, max } = *self;\n expect_safe_memory(ccx.state, min, max, ccx.ecx.journal().depth().try_into()?)\n }\n}\n\nimpl Cheatcode for stopExpectSafeMemoryCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self {} = self;\n ccx.state.allowed_mem_writes.remove(&ccx.ecx.journal().depth().try_into()?);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for expectSafeMemoryCallCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { min, max } = *self;\n expect_safe_memory(ccx.state, min, max, (ccx.ecx.journal().depth() + 1).try_into()?)\n }\n}\n\nimpl RevertParameters for ExpectedRevert {\n fn reverter(&self) -> Option
{\n self.reverter\n }\n\n fn reason(&self) -> Option<&[u8]> {\n self.reason.as_ref().map(|b| &***b)\n }\n\n fn partial_match(&self) -> bool {\n self.partial_match\n }\n}\n\n/// Handles expected calls specified by the `expectCall` cheatcodes.\n///\n/// It can handle calls in two ways:\n/// - If the cheatcode was used with a `count` argument, it will expect the call to be made exactly\n/// `count` times. e.g. `vm.expectCall(address(0xc4f3), abi.encodeWithSelector(0xd34db33f), 4)`\n/// will expect the call to address(0xc4f3) with selector `0xd34db33f` to be made exactly 4 times.\n/// If the amount of calls is less or more than 4, the test will fail. Note that the `count`\n/// argument cannot be overwritten with another `vm.expectCall`. If this is attempted,\n/// `expectCall` will revert.\n/// - If the cheatcode was used without a `count` argument, it will expect the call to be made at\n/// least the amount of times the cheatcode was called. This means that `vm.expectCall` without a\n/// count argument can be called many times, but cannot be called with a `count` argument after it\n/// was called without one. If the latter happens, `expectCall` will revert. e.g\n/// `vm.expectCall(address(0xc4f3), abi.encodeWithSelector(0xd34db33f))` will expect the call to\n/// address(0xc4f3) and selector `0xd34db33f` to be made at least once. If the amount of calls is\n/// 0, the test will fail. If the call is made more than once, the test will pass.\n#[expect(clippy::too_many_arguments)] // It is what it is\nfn expect_call(\n state: &mut Cheatcodes,\n target: &Address,\n calldata: &Bytes,\n value: Option<&U256>,\n mut gas: Option,\n mut min_gas: Option,\n count: u64,\n call_type: ExpectedCallType,\n) -> Result {\n let expecteds = state.expected_calls.entry(*target).or_default();\n\n if let Some(val) = value\n && *val > U256::ZERO\n {\n // If the value of the transaction is non-zero, the EVM adds a call stipend of 2300 gas\n // to ensure that the basic fallback function can be called.\n let positive_value_cost_stipend = 2300;\n if let Some(gas) = &mut gas {\n *gas += positive_value_cost_stipend;\n }\n if let Some(min_gas) = &mut min_gas {\n *min_gas += positive_value_cost_stipend;\n }\n }\n\n match call_type {\n ExpectedCallType::Count => {\n // Get the expected calls for this target.\n // In this case, as we're using counted expectCalls, we should not be able to set them\n // more than once.\n ensure!(\n !expecteds.contains_key(calldata),\n \"counted expected calls can only bet set once\"\n );\n expecteds.insert(\n calldata.clone(),\n (ExpectedCallData { value: value.copied(), gas, min_gas, count, call_type }, 0),\n );\n }\n ExpectedCallType::NonCount => {\n // Check if the expected calldata exists.\n // If it does, increment the count by one as we expect to see it one more time.\n match expecteds.entry(calldata.clone()) {\n Entry::Occupied(mut entry) => {\n let (expected, _) = entry.get_mut();\n // Ensure we're not overwriting a counted expectCall.\n ensure!(\n expected.call_type == ExpectedCallType::NonCount,\n \"cannot overwrite a counted expectCall with a non-counted expectCall\"\n );\n expected.count += 1;\n }\n // If it does not exist, then create it.\n Entry::Vacant(entry) => {\n entry.insert((\n ExpectedCallData { value: value.copied(), gas, min_gas, count, call_type },\n 0,\n ));\n }\n }\n }\n }\n\n Ok(Default::default())\n}\n\nfn expect_emit(\n state: &mut Cheatcodes,\n depth: usize,\n checks: [bool; 5],\n address: Option
,\n anonymous: bool,\n count: u64,\n) -> Result {\n let expected_emit = ExpectedEmit {\n depth,\n checks,\n address,\n found: false,\n log: None,\n anonymous,\n count,\n mismatch_error: None,\n };\n if let Some(found_emit_pos) = state.expected_emits.iter().position(|(emit, _)| emit.found) {\n // The order of emits already found (back of queue) should not be modified, hence push any\n // new emit before first found emit.\n state.expected_emits.insert(found_emit_pos, (expected_emit, Default::default()));\n } else {\n // If no expected emits then push new one at the back of queue.\n state.expected_emits.push_back((expected_emit, Default::default()));\n }\n\n Ok(Default::default())\n}\n\npub(crate) fn handle_expect_emit(\n state: &mut Cheatcodes,\n log: &alloy_primitives::Log,\n mut interpreter: Option<&mut Interpreter>,\n) -> Option<&'static str> {\n // This function returns an optional string indicating a failure reason.\n // If the string is `Some`, it indicates that the expectation failed with the provided reason.\n let mut should_fail = None;\n\n // Fill or check the expected emits.\n // We expect for emit checks to be filled as they're declared (from oldest to newest),\n // so we fill them and push them to the back of the queue.\n // If the user has properly filled all the emits, they'll end up in their original order.\n // If not, the queue will not be in the order the events will be intended to be filled,\n // and we'll be able to later detect this and bail.\n\n // First, we can return early if all events have been matched.\n // This allows a contract to arbitrarily emit more events than expected (additive behavior),\n // as long as all the previous events were matched in the order they were expected to be.\n if state.expected_emits.iter().all(|(expected, _)| expected.found) {\n return should_fail;\n }\n\n // Check count=0 expectations against this log - fail immediately if violated\n for (expected_emit, _) in &state.expected_emits {\n if expected_emit.count == 0\n && !expected_emit.found\n && let Some(expected_log) = &expected_emit.log\n && checks_topics_and_data(expected_emit.checks, expected_log, log)\n // Check revert address \n && (expected_emit.address.is_none() || expected_emit.address == Some(log.address))\n {\n if let Some(interpreter) = &mut interpreter {\n // This event was emitted but we expected it NOT to be (count=0)\n // Fail immediately\n interpreter.bytecode.set_action(InterpreterAction::new_return(\n InstructionResult::Revert,\n Error::encode(\"log emitted but expected 0 times\"),\n interpreter.gas,\n ));\n } else {\n should_fail = Some(\"log emitted but expected 0 times\");\n }\n\n return should_fail;\n }\n }\n\n let should_fill_logs = state.expected_emits.iter().any(|(expected, _)| expected.log.is_none());\n let index_to_fill_or_check = if should_fill_logs {\n // If there's anything to fill, we start with the last event to match in the queue\n // (without taking into account events already matched).\n state\n .expected_emits\n .iter()\n .position(|(emit, _)| emit.found)\n .unwrap_or(state.expected_emits.len())\n .saturating_sub(1)\n } else {\n // if all expected logs are filled, check any unmatched event\n // in the declared order, so we start from the front (like a queue).\n // Skip count=0 expectations as they are handled separately above\n state.expected_emits.iter().position(|(emit, _)| !emit.found && emit.count > 0).unwrap_or(0)\n };\n\n // If there are only count=0 expectations left, we can return early\n if !should_fill_logs\n && state.expected_emits.iter().all(|(emit, _)| emit.found || emit.count == 0)\n {\n return should_fail;\n }\n\n let (mut event_to_fill_or_check, mut count_map) = state\n .expected_emits\n .remove(index_to_fill_or_check)\n .expect(\"we should have an emit to fill or check\");\n\n let Some(expected) = &event_to_fill_or_check.log else {\n // Unless the caller is trying to match an anonymous event, the first topic must be\n // filled.\n if event_to_fill_or_check.anonymous || !log.topics().is_empty() {\n event_to_fill_or_check.log = Some(log.data.clone());\n // If we only filled the expected log then we put it back at the same position.\n state\n .expected_emits\n .insert(index_to_fill_or_check, (event_to_fill_or_check, count_map));\n } else if let Some(interpreter) = &mut interpreter {\n interpreter.bytecode.set_action(InterpreterAction::new_return(\n InstructionResult::Revert,\n Error::encode(\"use vm.expectEmitAnonymous to match anonymous events\"),\n interpreter.gas,\n ));\n } else {\n should_fail = Some(\"use vm.expectEmitAnonymous to match anonymous events\");\n }\n\n return should_fail;\n };\n\n // Increment/set `count` for `log.address` and `log.data`\n match count_map.entry(log.address) {\n Entry::Occupied(mut entry) => {\n let log_count_map = entry.get_mut();\n log_count_map.insert(&log.data);\n }\n Entry::Vacant(entry) => {\n let mut log_count_map = LogCountMap::new(&event_to_fill_or_check);\n if log_count_map.satisfies_checks(&log.data) {\n log_count_map.insert(&log.data);\n entry.insert(log_count_map);\n }\n }\n }\n\n event_to_fill_or_check.found = || -> bool {\n if !checks_topics_and_data(event_to_fill_or_check.checks, expected, log) {\n // Store detailed mismatch information\n\n // Try to decode the events if we have a signature identifier\n let (expected_decoded, actual_decoded) = if let Some(signatures_identifier) =\n state.signatures_identifier()\n && !event_to_fill_or_check.anonymous\n {\n (\n decode_event(signatures_identifier, expected),\n decode_event(signatures_identifier, log),\n )\n } else {\n (None, None)\n };\n event_to_fill_or_check.mismatch_error = Some(get_emit_mismatch_message(\n event_to_fill_or_check.checks,\n expected,\n log,\n event_to_fill_or_check.anonymous,\n expected_decoded.as_ref(),\n actual_decoded.as_ref(),\n ));\n return false;\n }\n\n // Maybe match source address.\n if event_to_fill_or_check.address.is_some_and(|addr| addr != log.address) {\n event_to_fill_or_check.mismatch_error = Some(format!(\n \"log emitter mismatch: expected={:#x}, got={:#x}\",\n event_to_fill_or_check.address.unwrap(),\n log.address\n ));\n return false;\n }\n\n let expected_count = event_to_fill_or_check.count;\n match event_to_fill_or_check.address {\n Some(emitter) => count_map\n .get(&emitter)\n .is_some_and(|log_map| log_map.count(&log.data) >= expected_count),\n None => count_map\n .values()\n .find(|log_map| log_map.satisfies_checks(&log.data))\n .is_some_and(|map| map.count(&log.data) >= expected_count),\n }\n }();\n\n // If we found the event, we can push it to the back of the queue\n // and begin expecting the next event.\n if event_to_fill_or_check.found {\n state.expected_emits.push_back((event_to_fill_or_check, count_map));\n } else {\n // We did not match this event, so we need to keep waiting for the right one to\n // appear.\n state.expected_emits.push_front((event_to_fill_or_check, count_map));\n }\n\n should_fail\n}\n\n/// Handles expected emits specified by the `expectEmit` cheatcodes.\n///\n/// The second element of the tuple counts the number of times the log has been emitted by a\n/// particular address\npub type ExpectedEmitTracker = VecDeque<(ExpectedEmit, AddressHashMap)>;\n\n#[derive(Clone, Debug, Default)]\npub struct LogCountMap {\n checks: [bool; 5],\n expected_log: RawLog,\n map: HashMap,\n}\n\nimpl LogCountMap {\n /// Instantiates `LogCountMap`.\n fn new(expected_emit: &ExpectedEmit) -> Self {\n Self {\n checks: expected_emit.checks,\n expected_log: expected_emit.log.clone().expect(\"log should be filled here\"),\n map: Default::default(),\n }\n }\n\n /// Inserts a log into the map and increments the count.\n ///\n /// The log must pass all checks against the expected log for the count to increment.\n ///\n /// Returns true if the log was inserted and count was incremented.\n fn insert(&mut self, log: &RawLog) -> bool {\n // If its already in the map, increment the count without checking.\n if self.map.contains_key(log) {\n self.map.entry(log.clone()).and_modify(|c| *c += 1);\n\n return true;\n }\n\n if !self.satisfies_checks(log) {\n return false;\n }\n\n self.map.entry(log.clone()).and_modify(|c| *c += 1).or_insert(1);\n\n true\n }\n\n /// Checks the incoming raw log against the expected logs topics and data.\n fn satisfies_checks(&self, log: &RawLog) -> bool {\n checks_topics_and_data(self.checks, &self.expected_log, log)\n }\n\n pub fn count(&self, log: &RawLog) -> u64 {\n if !self.satisfies_checks(log) {\n return 0;\n }\n\n self.count_unchecked()\n }\n\n pub fn count_unchecked(&self) -> u64 {\n self.map.values().sum()\n }\n}\n\nfn expect_create(\n state: &mut Cheatcodes,\n bytecode: Bytes,\n deployer: Address,\n create_scheme: CreateScheme,\n) -> Result {\n let expected_create = ExpectedCreate { bytecode, deployer, create_scheme };\n state.expected_creates.push(expected_create);\n\n Ok(Default::default())\n}\n\nfn expect_revert(\n state: &mut Cheatcodes,\n reason: Option<&[u8]>,\n depth: usize,\n cheatcode: bool,\n partial_match: bool,\n reverter: Option
,\n count: u64,\n) -> Result {\n ensure!(\n state.expected_revert.is_none(),\n \"you must call another function prior to expecting a second revert\"\n );\n state.expected_revert = Some(ExpectedRevert {\n reason: reason.map(Bytes::copy_from_slice),\n depth,\n kind: if cheatcode {\n ExpectedRevertKind::Cheatcode { pending_processing: true }\n } else {\n ExpectedRevertKind::Default\n },\n partial_match,\n reverter,\n reverted_by: None,\n max_depth: depth,\n count,\n actual_count: 0,\n });\n Ok(Default::default())\n}\n\nfn checks_topics_and_data(checks: [bool; 5], expected: &RawLog, log: &RawLog) -> bool {\n if log.topics().len() != expected.topics().len() {\n return false;\n }\n\n // Check topics.\n if !log\n .topics()\n .iter()\n .enumerate()\n .filter(|(i, _)| checks[*i])\n .all(|(i, topic)| topic == &expected.topics()[i])\n {\n return false;\n }\n\n // Check data\n if checks[4] && expected.data.as_ref() != log.data.as_ref() {\n return false;\n }\n\n true\n}\n\nfn decode_event(\n identifier: &foundry_evm_traces::identifier::SignaturesIdentifier,\n log: &RawLog,\n) -> Option {\n let topics = log.topics();\n if topics.is_empty() {\n return None;\n }\n let t0 = topics[0]; // event sig\n // Try to identify the event\n let event = foundry_common::block_on(identifier.identify_event(t0))?;\n\n // Check if event already has indexed information from signatures\n let has_indexed_info = event.inputs.iter().any(|p| p.indexed);\n // Only use get_indexed_event if the event doesn't have indexing info\n let indexed_event = if has_indexed_info { event } else { get_indexed_event(event, log) };\n\n // Try to decode the event\n if let Ok(decoded) = indexed_event.decode_log(log) {\n let params = reconstruct_params(&indexed_event, &decoded);\n\n let decoded_params = params\n .into_iter()\n .zip(indexed_event.inputs.iter())\n .map(|(param, input)| (input.name.clone(), format_token(¶m)))\n .collect();\n\n return Some(DecodedCallLog {\n name: Some(indexed_event.name),\n params: Some(decoded_params),\n });\n }\n\n None\n}\n\n/// Restore the order of the params of a decoded event\nfn reconstruct_params(event: &Event, decoded: &alloy_dyn_abi::DecodedEvent) -> Vec {\n let mut indexed = 0;\n let mut unindexed = 0;\n let mut inputs = vec![];\n for input in &event.inputs {\n if input.indexed && indexed < decoded.indexed.len() {\n inputs.push(decoded.indexed[indexed].clone());\n indexed += 1;\n } else if unindexed < decoded.body.len() {\n inputs.push(decoded.body[unindexed].clone());\n unindexed += 1;\n }\n }\n inputs\n}\n\n/// Gets a detailed mismatch message for emit assertions\npub(crate) fn get_emit_mismatch_message(\n checks: [bool; 5],\n expected: &RawLog,\n actual: &RawLog,\n is_anonymous: bool,\n expected_decoded: Option<&DecodedCallLog>,\n actual_decoded: Option<&DecodedCallLog>,\n) -> String {\n // Early return for completely different events or incompatible structures\n\n // 1. Different number of topics\n if actual.topics().len() != expected.topics().len() {\n return name_mismatched_logs(expected_decoded, actual_decoded);\n }\n\n // 2. Different event signatures (for non-anonymous events)\n if !is_anonymous\n && checks[0]\n && (!expected.topics().is_empty() && !actual.topics().is_empty())\n && expected.topics()[0] != actual.topics()[0]\n {\n return name_mismatched_logs(expected_decoded, actual_decoded);\n }\n\n let expected_data = expected.data.as_ref();\n let actual_data = actual.data.as_ref();\n\n // 3. Check data\n if checks[4] && expected_data != actual_data {\n // Different lengths or not ABI-encoded\n if expected_data.len() != actual_data.len()\n || !expected_data.len().is_multiple_of(32)\n || expected_data.is_empty()\n {\n return name_mismatched_logs(expected_decoded, actual_decoded);\n }\n }\n\n // expected and actual events are the same, so check individual parameters\n let mut mismatches = Vec::new();\n\n // Check topics (indexed parameters)\n for (i, (expected_topic, actual_topic)) in\n expected.topics().iter().zip(actual.topics().iter()).enumerate()\n {\n // Skip topic[0] for non-anonymous events (already checked above)\n if i == 0 && !is_anonymous {\n continue;\n }\n\n // Only check if the corresponding check flag is set\n if i < checks.len() && checks[i] && expected_topic != actual_topic {\n let param_idx = if is_anonymous {\n i // For anonymous events, topic[0] is param 0\n } else {\n i - 1 // For regular events, topic[0] is event signature, so topic[1] is param 0\n };\n mismatches\n .push(format!(\"param {param_idx}: expected={expected_topic}, got={actual_topic}\"));\n }\n }\n\n // Check data (non-indexed parameters)\n if checks[4] && expected_data != actual_data {\n let num_indexed_params = if is_anonymous {\n expected.topics().len()\n } else {\n expected.topics().len().saturating_sub(1)\n };\n\n for (i, (expected_chunk, actual_chunk)) in\n expected_data.chunks(32).zip(actual_data.chunks(32)).enumerate()\n {\n if expected_chunk != actual_chunk {\n let param_idx = num_indexed_params + i;\n mismatches.push(format!(\n \"param {}: expected={}, got={}\",\n param_idx,\n hex::encode_prefixed(expected_chunk),\n hex::encode_prefixed(actual_chunk)\n ));\n }\n }\n }\n\n if mismatches.is_empty() {\n name_mismatched_logs(expected_decoded, actual_decoded)\n } else {\n // Build the error message with event names if available\n let event_prefix = match (expected_decoded, actual_decoded) {\n (Some(expected_dec), Some(actual_dec)) if expected_dec.name == actual_dec.name => {\n format!(\n \"{} param mismatch\",\n expected_dec.name.as_ref().unwrap_or(&\"log\".to_string())\n )\n }\n _ => {\n if is_anonymous {\n \"anonymous log mismatch\".to_string()\n } else {\n \"log mismatch\".to_string()\n }\n }\n };\n\n // Add parameter details if available from decoded events\n let detailed_mismatches = if let (Some(expected_dec), Some(actual_dec)) =\n (expected_decoded, actual_decoded)\n && let (Some(expected_params), Some(actual_params)) =\n (&expected_dec.params, &actual_dec.params)\n {\n mismatches\n .into_iter()\n .map(|basic_mismatch| {\n // Try to find the parameter name and decoded value\n if let Some(param_idx) = basic_mismatch\n .split(' ')\n .nth(1)\n .and_then(|s| s.trim_end_matches(':').parse::().ok())\n && param_idx < expected_params.len()\n && param_idx < actual_params.len()\n {\n let (expected_name, expected_value) = &expected_params[param_idx];\n let (_actual_name, actual_value) = &actual_params[param_idx];\n let param_name = if !expected_name.is_empty() {\n expected_name\n } else {\n &format!(\"param{param_idx}\")\n };\n return format!(\n \"{param_name}: expected={expected_value}, got={actual_value}\",\n );\n }\n basic_mismatch\n })\n .collect::>()\n } else {\n mismatches\n };\n\n format!(\"{} at {}\", event_prefix, detailed_mismatches.join(\", \"))\n }\n}\n\n/// Formats the generic mismatch message: \"log != expected log\" to include event names if available\nfn name_mismatched_logs(\n expected_decoded: Option<&DecodedCallLog>,\n actual_decoded: Option<&DecodedCallLog>,\n) -> String {\n let expected_name = expected_decoded.and_then(|d| d.name.as_deref()).unwrap_or(\"log\");\n let actual_name = actual_decoded.and_then(|d| d.name.as_deref()).unwrap_or(\"log\");\n format!(\"{actual_name} != expected {expected_name}\")\n}\n\nfn expect_safe_memory(state: &mut Cheatcodes, start: u64, end: u64, depth: u64) -> Result {\n ensure!(start < end, \"memory range start ({start}) is greater than end ({end})\");\n #[expect(clippy::single_range_in_vec_init)] // Wanted behaviour\n let offsets = state.allowed_mem_writes.entry(depth).or_insert_with(|| vec![0..0x60]);\n offsets.push(start..end);\n Ok(Default::default())\n}\n" }, { "path": "crates/cheatcodes/src/test/revert_handlers.rs", "content": "use crate::{Error, Result};\nuse alloy_dyn_abi::{DynSolValue, ErrorExt};\nuse alloy_primitives::{Address, Bytes, address, hex};\nuse alloy_sol_types::{SolError, SolValue};\nuse foundry_common::{ContractsByArtifact, abi::get_error};\nuse foundry_evm_core::decode::RevertDecoder;\nuse revm::interpreter::{InstructionResult, return_ok};\nuse spec::Vm;\n\nuse super::{\n assume::{AcceptableRevertParameters, AssumeNoRevert},\n expect::ExpectedRevert,\n};\n\n/// For some cheatcodes we may internally change the status of the call, i.e. in `expectRevert`.\n/// Solidity will see a successful call and attempt to decode the return data. Therefore, we need\n/// to populate the return with dummy bytes so the decode doesn't fail.\n///\n/// 8192 bytes was arbitrarily chosen because it is long enough for return values up to 256 words in\n/// size.\nstatic DUMMY_CALL_OUTPUT: Bytes = Bytes::from_static(&[0u8; 8192]);\n\n/// Same reasoning as [DUMMY_CALL_OUTPUT], but for creates.\nconst DUMMY_CREATE_ADDRESS: Address = address!(\"0x0000000000000000000000000000000000000001\");\n\nfn stringify(data: &[u8]) -> String {\n if let Ok(s) = String::abi_decode(data) {\n return s;\n }\n if data.is_ascii() {\n return std::str::from_utf8(data).unwrap().to_owned();\n }\n hex::encode_prefixed(data)\n}\n\n/// Common parameters for expected or assumed reverts. Allows for code reuse.\npub(crate) trait RevertParameters {\n fn reverter(&self) -> Option
;\n fn reason(&self) -> Option<&[u8]>;\n fn partial_match(&self) -> bool;\n}\n\nimpl RevertParameters for AcceptableRevertParameters {\n fn reverter(&self) -> Option
{\n self.reverter\n }\n\n fn reason(&self) -> Option<&[u8]> {\n Some(&self.reason)\n }\n\n fn partial_match(&self) -> bool {\n self.partial_match\n }\n}\n\n/// Core logic for handling reverts that may or may not be expected (or assumed).\nfn handle_revert(\n is_cheatcode: bool,\n revert_params: &impl RevertParameters,\n status: InstructionResult,\n retdata: &Bytes,\n known_contracts: &Option,\n reverter: Option<&Address>,\n) -> Result<(), Error> {\n // If expected reverter address is set then check it matches the actual reverter.\n if let (Some(expected_reverter), Some(&actual_reverter)) = (revert_params.reverter(), reverter)\n && expected_reverter != actual_reverter\n {\n return Err(fmt_err!(\n \"Reverter != expected reverter: {} != {}\",\n actual_reverter,\n expected_reverter\n ));\n }\n\n let expected_reason = revert_params.reason();\n // If None, accept any revert.\n let Some(expected_reason) = expected_reason else {\n return Ok(());\n };\n\n if !expected_reason.is_empty() && retdata.is_empty() {\n bail!(\"call reverted as expected, but without data\");\n }\n\n let mut actual_revert: Vec = retdata.to_vec();\n\n // Compare only the first 4 bytes if partial match.\n if revert_params.partial_match() && actual_revert.get(..4) == expected_reason.get(..4) {\n return Ok(());\n }\n\n // Try decoding as known errors.\n actual_revert = decode_revert(actual_revert);\n\n if actual_revert == expected_reason\n || (is_cheatcode && memchr::memmem::find(&actual_revert, expected_reason).is_some())\n {\n return Ok(());\n }\n\n // If expected reason is `Error(string)` then decode and compare with actual revert.\n // See \n if expected_reason.len() >= 4\n && let Ok(e) = get_error(\"Error(string)\")\n && let Ok(dec) = e.decode_error(expected_reason)\n && let Some(DynSolValue::String(revert_str)) = dec.body.first()\n && revert_str.as_str() == String::from_utf8_lossy(&actual_revert)\n {\n return Ok(());\n }\n\n let (actual, expected) = if let Some(contracts) = known_contracts {\n let decoder = RevertDecoder::new().with_abis(contracts.values().map(|c| &c.abi));\n (\n &decoder.decode(actual_revert.as_slice(), Some(status)),\n &decoder.decode(expected_reason, Some(status)),\n )\n } else {\n (&stringify(&actual_revert), &stringify(expected_reason))\n };\n\n if expected == actual {\n return Ok(());\n }\n\n Err(fmt_err!(\"Error != expected error: {} != {}\", actual, expected))\n}\n\npub(crate) fn handle_assume_no_revert(\n assume_no_revert: &AssumeNoRevert,\n status: InstructionResult,\n retdata: &Bytes,\n known_contracts: &Option,\n) -> Result<()> {\n // if a generic AssumeNoRevert, return Ok(). Otherwise, iterate over acceptable reasons and try\n // to match against any, otherwise, return an Error with the revert data\n if assume_no_revert.reasons.is_empty() {\n Ok(())\n } else {\n assume_no_revert\n .reasons\n .iter()\n .find_map(|reason| {\n handle_revert(\n false,\n reason,\n status,\n retdata,\n known_contracts,\n assume_no_revert.reverted_by.as_ref(),\n )\n .ok()\n })\n .ok_or_else(|| retdata.clone().into())\n }\n}\n\npub(crate) fn handle_expect_revert(\n is_cheatcode: bool,\n is_create: bool,\n internal_expect_revert: bool,\n expected_revert: &ExpectedRevert,\n status: InstructionResult,\n retdata: Bytes,\n known_contracts: &Option,\n) -> Result<(Option
, Bytes)> {\n let success_return = || {\n if is_create {\n (Some(DUMMY_CREATE_ADDRESS), Bytes::new())\n } else {\n (None, DUMMY_CALL_OUTPUT.clone())\n }\n };\n\n // Check depths if it's not an expect cheatcode call and if internal expect reverts not enabled.\n if !is_cheatcode && !internal_expect_revert {\n ensure!(\n expected_revert.max_depth > expected_revert.depth,\n \"call didn't revert at a lower depth than cheatcode call depth\"\n );\n }\n\n if expected_revert.count == 0 {\n // If no specific reason or reverter is expected, we just check if it reverted\n if expected_revert.reverter.is_none() && expected_revert.reason.is_none() {\n ensure!(\n matches!(status, return_ok!()),\n \"call reverted when it was expected not to revert\"\n );\n return Ok(success_return());\n }\n\n // Flags to track if the reason and reverter match.\n let mut reason_match = expected_revert.reason.as_ref().map(|_| false);\n let mut reverter_match = expected_revert.reverter.as_ref().map(|_| false);\n\n // If we expect no reverts with a specific reason/reverter, but got a revert,\n // we need to check if it matches our criteria\n if !matches!(status, return_ok!()) {\n // We got a revert, but we expected 0 reverts\n // We need to check if this revert matches our expected criteria\n\n // Reverter check\n if let (Some(expected_reverter), Some(actual_reverter)) =\n (expected_revert.reverter, expected_revert.reverted_by)\n && expected_reverter == actual_reverter\n {\n reverter_match = Some(true);\n }\n\n // Reason check\n let expected_reason = expected_revert.reason();\n if let Some(expected_reason) = expected_reason {\n let mut actual_revert: Vec = retdata.to_vec();\n actual_revert = decode_revert(actual_revert);\n\n if actual_revert == expected_reason {\n reason_match = Some(true);\n }\n }\n\n match (reason_match, reverter_match) {\n (Some(true), Some(true)) => Err(fmt_err!(\n \"expected 0 reverts with reason: {}, from address: {}, but got one\",\n stringify(expected_reason.unwrap_or_default()),\n expected_revert.reverter.unwrap()\n )),\n (Some(true), None) => Err(fmt_err!(\n \"expected 0 reverts with reason: {}, but got one\",\n stringify(expected_reason.unwrap_or_default())\n )),\n (None, Some(true)) => Err(fmt_err!(\n \"expected 0 reverts from address: {}, but got one\",\n expected_revert.reverter.unwrap()\n )),\n _ => {\n // The revert doesn't match our criteria, which means it's a different revert\n // For expectRevert with count=0, any revert should fail the test\n let decoded_revert = decode_revert(retdata.to_vec());\n\n // Provide more specific error messages based on what was expected\n if let Some(reverter) = expected_revert.reverter {\n if expected_revert.reason.is_some() {\n Err(fmt_err!(\n \"call reverted with '{}' from {}, but expected 0 reverts with reason '{}' from {}\",\n stringify(&decoded_revert),\n expected_revert.reverted_by.unwrap_or_default(),\n stringify(expected_reason.unwrap_or_default()),\n reverter\n ))\n } else {\n Err(fmt_err!(\n \"call reverted with '{}' from {}, but expected 0 reverts from {}\",\n stringify(&decoded_revert),\n expected_revert.reverted_by.unwrap_or_default(),\n reverter\n ))\n }\n } else {\n Err(fmt_err!(\n \"call reverted with '{}' when it was expected not to revert\",\n stringify(&decoded_revert)\n ))\n }\n }\n }\n } else {\n // No revert occurred, which is what we expected\n Ok(success_return())\n }\n } else {\n ensure!(!matches!(status, return_ok!()), \"next call did not revert as expected\");\n\n handle_revert(\n is_cheatcode,\n expected_revert,\n status,\n &retdata,\n known_contracts,\n expected_revert.reverted_by.as_ref(),\n )?;\n Ok(success_return())\n }\n}\n\nfn decode_revert(revert: Vec) -> Vec {\n if matches!(\n revert.get(..4).map(|s| s.try_into().unwrap()),\n Some(Vm::CheatcodeError::SELECTOR | alloy_sol_types::Revert::SELECTOR)\n ) && let Ok(decoded) = Vec::::abi_decode(&revert[4..])\n {\n return decoded;\n }\n revert\n}\n" }, { "path": "crates/cheatcodes/src/test.rs", "content": "//! Implementations of [`Testing`](spec::Group::Testing) cheatcodes.\n\nuse crate::{Cheatcode, Cheatcodes, CheatsCtxt, EthCheatCtx, Result, Vm::*};\nuse alloy_chains::Chain as AlloyChain;\nuse alloy_primitives::{Address, U256};\nuse alloy_sol_types::SolValue;\nuse foundry_common::version::SEMVER_VERSION;\nuse foundry_evm_core::constants::MAGIC_SKIP;\nuse revm::context::{ContextTr, JournalTr};\nuse std::str::FromStr;\n\npub(crate) mod assert;\npub(crate) mod assume;\npub(crate) mod expect;\npub(crate) mod revert_handlers;\n\nimpl Cheatcode for breakpoint_0Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { char } = self;\n breakpoint(ccx.state, &ccx.caller, char, true)\n }\n}\n\nimpl Cheatcode for breakpoint_1Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { char, value } = self;\n breakpoint(ccx.state, &ccx.caller, char, *value)\n }\n}\n\nimpl Cheatcode for getFoundryVersionCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self {} = self;\n Ok(SEMVER_VERSION.abi_encode())\n }\n}\n\nimpl Cheatcode for rpcUrlCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { rpcAlias } = self;\n let url = state.config.rpc_endpoint(rpcAlias)?.url()?.abi_encode();\n Ok(url)\n }\n}\n\nimpl Cheatcode for rpcUrlsCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self {} = self;\n state.config.rpc_urls().map(|urls| urls.abi_encode())\n }\n}\n\nimpl Cheatcode for rpcUrlStructsCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self {} = self;\n state.config.rpc_urls().map(|urls| urls.abi_encode())\n }\n}\n\nimpl Cheatcode for sleepCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { duration } = self;\n let sleep_duration = std::time::Duration::from_millis(duration.saturating_to());\n std::thread::sleep(sleep_duration);\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for skip_0Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { skipTest } = *self;\n skip_1Call { skipTest, reason: String::new() }.apply_stateful(ccx)\n }\n}\n\nimpl Cheatcode for skip_1Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { skipTest, reason } = self;\n if *skipTest {\n // Skip should not work if called deeper than at test level.\n // Since we're not returning the magic skip bytes, this will cause a test failure.\n ensure!(ccx.ecx.journal().depth() <= 1, \"`skip` can only be used at test level\");\n Err([MAGIC_SKIP, reason.as_bytes()].concat().into())\n } else {\n Ok(Default::default())\n }\n }\n}\n\nimpl Cheatcode for getChain_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { chainAlias } = self;\n get_chain(state, chainAlias)\n }\n}\n\nimpl Cheatcode for getChain_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { chainId } = self;\n // Convert the chainId to a string and use the existing get_chain function\n let chain_id_str = chainId.to_string();\n get_chain(state, &chain_id_str)\n }\n}\n\n/// Adds or removes the given breakpoint to the state.\nfn breakpoint(state: &mut Cheatcodes, caller: &Address, s: &str, add: bool) -> Result {\n let mut chars = s.chars();\n let (Some(point), None) = (chars.next(), chars.next()) else {\n bail!(\"breakpoints must be exactly one character\");\n };\n ensure!(point.is_alphabetic(), \"only alphabetic characters are accepted as breakpoints\");\n\n if add {\n state.breakpoints.insert(point, (*caller, state.pc));\n } else {\n state.breakpoints.remove(&point);\n }\n\n Ok(Default::default())\n}\n\n/// Gets chain information for the given alias.\nfn get_chain(state: &mut Cheatcodes, chain_alias: &str) -> Result {\n // Parse the chain alias - works for both chain names and IDs\n let alloy_chain = AlloyChain::from_str(chain_alias)\n .map_err(|_| fmt_err!(\"invalid chain alias: {chain_alias}\"))?;\n let chain_name = alloy_chain.to_string();\n let chain_id = alloy_chain.id();\n\n // Check if this is an unknown chain ID by comparing the name to the chain ID\n // When a numeric ID is passed for an unknown chain, alloy_chain.to_string() will return the ID\n // So if they match, it's likely an unknown chain ID\n if chain_name == chain_id.to_string() {\n return Err(fmt_err!(\"invalid chain alias: {chain_alias}\"));\n }\n\n // Try to retrieve RPC URL and chain alias from user's config in foundry.toml.\n let (rpc_url, chain_alias) = if let Some(rpc_url) =\n state.config.rpc_endpoint(&chain_name).ok().and_then(|e| e.url().ok())\n {\n (rpc_url, chain_name.clone())\n } else {\n (String::new(), chain_alias.to_string())\n };\n\n let chain_struct = Chain {\n name: chain_name,\n chainId: U256::from(chain_id),\n chainAlias: chain_alias,\n rpcUrl: rpc_url,\n };\n\n Ok(chain_struct.abi_encode())\n}\n" }, { "path": "crates/cheatcodes/src/toml.rs", "content": "//! Implementations of [`Toml`](spec::Group::Toml) cheatcodes.\n\nuse crate::{\n Cheatcode, Cheatcodes, Result,\n Vm::*,\n json::{\n check_json_key_exists, parse_json, parse_json_coerce, parse_json_keys, resolve_type,\n upsert_json_value,\n },\n};\nuse alloy_dyn_abi::DynSolType;\nuse alloy_sol_types::SolValue;\nuse foundry_common::{fmt::StructDefinitions, fs};\nuse foundry_config::fs_permissions::FsAccessKind;\nuse serde_json::Value as JsonValue;\nuse toml::Value as TomlValue;\n\nimpl Cheatcode for keyExistsTomlCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { toml, key } = self;\n check_json_key_exists(&toml_to_json_string(toml)?, key)\n }\n}\n\nimpl Cheatcode for parseToml_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { toml } = self;\n parse_toml(\n toml,\n \"$\",\n state.analysis.as_ref().and_then(|analysis| analysis.struct_defs().ok()),\n )\n }\n}\n\nimpl Cheatcode for parseToml_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { toml, key } = self;\n parse_toml(\n toml,\n key,\n state.analysis.as_ref().and_then(|analysis| analysis.struct_defs().ok()),\n )\n }\n}\n\nimpl Cheatcode for parseTomlUintCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { toml, key } = self;\n parse_toml_coerce(toml, key, &DynSolType::Uint(256))\n }\n}\n\nimpl Cheatcode for parseTomlUintArrayCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { toml, key } = self;\n parse_toml_coerce(toml, key, &DynSolType::Array(Box::new(DynSolType::Uint(256))))\n }\n}\n\nimpl Cheatcode for parseTomlIntCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { toml, key } = self;\n parse_toml_coerce(toml, key, &DynSolType::Int(256))\n }\n}\n\nimpl Cheatcode for parseTomlIntArrayCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { toml, key } = self;\n parse_toml_coerce(toml, key, &DynSolType::Array(Box::new(DynSolType::Int(256))))\n }\n}\n\nimpl Cheatcode for parseTomlBoolCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { toml, key } = self;\n parse_toml_coerce(toml, key, &DynSolType::Bool)\n }\n}\n\nimpl Cheatcode for parseTomlBoolArrayCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { toml, key } = self;\n parse_toml_coerce(toml, key, &DynSolType::Array(Box::new(DynSolType::Bool)))\n }\n}\n\nimpl Cheatcode for parseTomlAddressCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { toml, key } = self;\n parse_toml_coerce(toml, key, &DynSolType::Address)\n }\n}\n\nimpl Cheatcode for parseTomlAddressArrayCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { toml, key } = self;\n parse_toml_coerce(toml, key, &DynSolType::Array(Box::new(DynSolType::Address)))\n }\n}\n\nimpl Cheatcode for parseTomlStringCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { toml, key } = self;\n parse_toml_coerce(toml, key, &DynSolType::String)\n }\n}\n\nimpl Cheatcode for parseTomlStringArrayCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { toml, key } = self;\n parse_toml_coerce(toml, key, &DynSolType::Array(Box::new(DynSolType::String)))\n }\n}\n\nimpl Cheatcode for parseTomlBytesCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { toml, key } = self;\n parse_toml_coerce(toml, key, &DynSolType::Bytes)\n }\n}\n\nimpl Cheatcode for parseTomlBytesArrayCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { toml, key } = self;\n parse_toml_coerce(toml, key, &DynSolType::Array(Box::new(DynSolType::Bytes)))\n }\n}\n\nimpl Cheatcode for parseTomlBytes32Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { toml, key } = self;\n parse_toml_coerce(toml, key, &DynSolType::FixedBytes(32))\n }\n}\n\nimpl Cheatcode for parseTomlBytes32ArrayCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { toml, key } = self;\n parse_toml_coerce(toml, key, &DynSolType::Array(Box::new(DynSolType::FixedBytes(32))))\n }\n}\n\nimpl Cheatcode for parseTomlType_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { toml, typeDescription } = self;\n parse_toml_coerce(\n toml,\n \"$\",\n &resolve_type(\n typeDescription,\n state.analysis.as_ref().and_then(|analysis| analysis.struct_defs().ok()),\n )?,\n )\n .map(|v| v.abi_encode())\n }\n}\n\nimpl Cheatcode for parseTomlType_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { toml, key, typeDescription } = self;\n parse_toml_coerce(\n toml,\n key,\n &resolve_type(\n typeDescription,\n state.analysis.as_ref().and_then(|analysis| analysis.struct_defs().ok()),\n )?,\n )\n .map(|v| v.abi_encode())\n }\n}\n\nimpl Cheatcode for parseTomlTypeArrayCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { toml, key, typeDescription } = self;\n let ty = resolve_type(\n typeDescription,\n state.analysis.as_ref().and_then(|analysis| analysis.struct_defs().ok()),\n )?;\n parse_toml_coerce(toml, key, &DynSolType::Array(Box::new(ty))).map(|v| v.abi_encode())\n }\n}\n\nimpl Cheatcode for parseTomlKeysCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { toml, key } = self;\n parse_toml_keys(toml, key)\n }\n}\n\nimpl Cheatcode for writeToml_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { json, path } = self;\n let value =\n serde_json::from_str(json).unwrap_or_else(|_| JsonValue::String(json.to_owned()));\n\n let toml_string = format_json_to_toml(value)?;\n super::fs::write_file(state, path.as_ref(), toml_string.as_bytes())\n }\n}\n\nimpl Cheatcode for writeToml_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { json: value, path, valueKey } = self;\n\n // Read and parse the TOML file.\n // If the file doesn't exist, start with an empty object so the file is created.\n let data_path = state.config.ensure_path_allowed(path, FsAccessKind::Read)?;\n let mut json_data: JsonValue = if data_path.exists() {\n let toml_data = fs::locked_read_to_string(&data_path)?;\n toml::from_str(&toml_data).map_err(|e| fmt_err!(\"failed parsing TOML: {e}\"))?\n } else {\n JsonValue::Object(Default::default())\n };\n upsert_json_value(&mut json_data, value, valueKey)?;\n\n // Serialize back to TOML and write the updated content back to the file\n let toml_string = format_json_to_toml(json_data)?;\n super::fs::write_file(state, path.as_ref(), toml_string.as_bytes())\n }\n}\n\n/// Parse\nfn parse_toml_str(toml: &str) -> Result {\n toml::from_str(toml).map_err(|e| fmt_err!(\"failed parsing TOML: {e}\"))\n}\n\n/// Parse a TOML string and return the value at the given path.\nfn parse_toml(toml: &str, key: &str, struct_defs: Option<&StructDefinitions>) -> Result {\n parse_json(&toml_to_json_string(toml)?, key, struct_defs)\n}\n\n/// Parse a TOML string and return the value at the given path, coercing it to the given type.\nfn parse_toml_coerce(toml: &str, key: &str, ty: &DynSolType) -> Result {\n parse_json_coerce(&toml_to_json_string(toml)?, key, ty)\n}\n\n/// Parse a TOML string and return an array of all keys at the given path.\nfn parse_toml_keys(toml: &str, key: &str) -> Result {\n parse_json_keys(&toml_to_json_string(toml)?, key)\n}\n\n/// Convert a TOML string to a JSON string.\nfn toml_to_json_string(toml: &str) -> Result {\n let toml = parse_toml_str(toml)?;\n let json = toml_to_json_value(toml);\n serde_json::to_string(&json).map_err(|e| fmt_err!(\"failed to serialize JSON: {e}\"))\n}\n\n/// Format a JSON value to a TOML pretty string.\nfn format_json_to_toml(json: JsonValue) -> Result {\n let toml = json_to_toml_value(json);\n toml::to_string_pretty(&toml).map_err(|e| fmt_err!(\"failed to serialize TOML: {e}\"))\n}\n\n/// Convert a TOML value to a JSON value.\npub(super) fn toml_to_json_value(toml: TomlValue) -> JsonValue {\n match toml {\n TomlValue::String(s) => match s.as_str() {\n \"null\" => JsonValue::Null,\n _ => JsonValue::String(s),\n },\n TomlValue::Integer(i) => JsonValue::Number(i.into()),\n TomlValue::Float(f) => match serde_json::Number::from_f64(f) {\n Some(n) => JsonValue::Number(n),\n None => JsonValue::String(f.to_string()),\n },\n TomlValue::Boolean(b) => JsonValue::Bool(b),\n TomlValue::Array(a) => JsonValue::Array(a.into_iter().map(toml_to_json_value).collect()),\n TomlValue::Table(t) => {\n JsonValue::Object(t.into_iter().map(|(k, v)| (k, toml_to_json_value(v))).collect())\n }\n TomlValue::Datetime(d) => JsonValue::String(d.to_string()),\n }\n}\n\n/// Convert a JSON value to a TOML value.\nfn json_to_toml_value(json: JsonValue) -> TomlValue {\n match json {\n JsonValue::String(s) => TomlValue::String(s),\n JsonValue::Number(n) => match n.as_i64() {\n Some(i) => TomlValue::Integer(i),\n None => match n.as_f64() {\n Some(f) => TomlValue::Float(f),\n None => TomlValue::String(n.to_string()),\n },\n },\n JsonValue::Bool(b) => TomlValue::Boolean(b),\n JsonValue::Array(a) => TomlValue::Array(a.into_iter().map(json_to_toml_value).collect()),\n JsonValue::Object(o) => {\n TomlValue::Table(o.into_iter().map(|(k, v)| (k, json_to_toml_value(v))).collect())\n }\n JsonValue::Null => TomlValue::String(\"null\".to_string()),\n }\n}\n" }, { "path": "crates/cheatcodes/src/utils.rs", "content": "//! Implementations of [`Utilities`](spec::Group::Utilities) cheatcodes.\n\nuse crate::{Cheatcode, Cheatcodes, CheatcodesExecutor, CheatsCtxt, Result, Vm::*};\nuse alloy_dyn_abi::{DynSolType, DynSolValue, Resolver, TypedData, eip712_parser::EncodeType};\nuse alloy_ens::namehash;\nuse alloy_primitives::{B64, Bytes, I256, U256, aliases::B32, keccak256, map::HashMap};\nuse alloy_rlp::{Decodable, Encodable};\nuse alloy_sol_types::SolValue;\nuse foundry_common::{TYPE_BINDING_PREFIX, fs};\nuse foundry_config::fs_permissions::FsAccessKind;\nuse foundry_evm_core::constants::DEFAULT_CREATE2_DEPLOYER;\nuse foundry_evm_fuzz::strategies::BoundMutator;\nuse proptest::prelude::Strategy;\nuse rand::{Rng, RngCore, seq::SliceRandom};\nuse revm::{\n context::{ContextTr, JournalTr},\n inspector::JournalExt,\n};\nuse std::path::PathBuf;\n\n/// Contains locations of traces ignored via cheatcodes.\n///\n/// The way we identify location in traces is by (node_idx, item_idx) tuple where node_idx is an\n/// index of a call trace node, and item_idx is a value between 0 and `node.ordering.len()` where i\n/// represents point after ith item, and 0 represents the beginning of the node trace.\n#[derive(Debug, Default, Clone)]\npub struct IgnoredTraces {\n /// Mapping from (start_node_idx, start_item_idx) to (end_node_idx, end_item_idx) representing\n /// ranges of trace nodes to ignore.\n pub ignored: HashMap<(usize, usize), (usize, usize)>,\n /// Keeps track of (start_node_idx, start_item_idx) of the last `vm.pauseTracing` call.\n pub last_pause_call: Option<(usize, usize)>,\n}\n\nimpl Cheatcode for labelCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { account, newLabel } = self;\n state.labels.insert(*account, newLabel.clone());\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for getLabelCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { account } = self;\n Ok(match state.labels.get(account) {\n Some(label) => label.abi_encode(),\n None => format!(\"unlabeled:{account}\").abi_encode(),\n })\n }\n}\n\nimpl Cheatcode for computeCreateAddressCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { nonce, deployer } = self;\n ensure!(*nonce <= U256::from(u64::MAX), \"nonce must be less than 2^64\");\n Ok(deployer.create(nonce.to()).abi_encode())\n }\n}\n\nimpl Cheatcode for computeCreate2Address_0Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { salt, initCodeHash, deployer } = self;\n Ok(deployer.create2(salt, initCodeHash).abi_encode())\n }\n}\n\nimpl Cheatcode for computeCreate2Address_1Call {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { salt, initCodeHash } = self;\n Ok(DEFAULT_CREATE2_DEPLOYER.create2(salt, initCodeHash).abi_encode())\n }\n}\n\nimpl Cheatcode for ensNamehashCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { name } = self;\n Ok(namehash(name).abi_encode())\n }\n}\n\nimpl Cheatcode for bound_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { current, min, max } = *self;\n let Some(mutated) = U256::bound(current, min, max, state.test_runner()) else {\n bail!(\"cannot bound {current} in [{min}, {max}] range\")\n };\n Ok(mutated.abi_encode())\n }\n}\n\nimpl Cheatcode for bound_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { current, min, max } = *self;\n let Some(mutated) = I256::bound(current, min, max, state.test_runner()) else {\n bail!(\"cannot bound {current} in [{min}, {max}] range\")\n };\n Ok(mutated.abi_encode())\n }\n}\n\nimpl Cheatcode for randomUint_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n random_uint(state, None, None)\n }\n}\n\nimpl Cheatcode for randomUint_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { min, max } = *self;\n random_uint(state, None, Some((min, max)))\n }\n}\n\nimpl Cheatcode for randomUint_2Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { bits } = *self;\n random_uint(state, Some(bits), None)\n }\n}\n\nimpl Cheatcode for randomAddressCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n Ok(DynSolValue::type_strategy(&DynSolType::Address)\n .new_tree(state.test_runner())\n .unwrap()\n .current()\n .abi_encode())\n }\n}\n\nimpl Cheatcode for randomInt_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n random_int(state, None)\n }\n}\n\nimpl Cheatcode for randomInt_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { bits } = *self;\n random_int(state, Some(bits))\n }\n}\n\nimpl Cheatcode for randomBoolCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let rand_bool: bool = state.rng().random();\n Ok(rand_bool.abi_encode())\n }\n}\n\nimpl Cheatcode for randomBytesCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { len } = *self;\n ensure!(\n len <= U256::from(usize::MAX),\n format!(\"bytes length cannot exceed {}\", usize::MAX)\n );\n let mut bytes = vec![0u8; len.to::()];\n state.rng().fill_bytes(&mut bytes);\n Ok(bytes.abi_encode())\n }\n}\n\nimpl Cheatcode for randomBytes4Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let rand_u32 = state.rng().next_u32();\n Ok(B32::from(rand_u32).abi_encode())\n }\n}\n\nimpl Cheatcode for randomBytes8Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let rand_u64 = state.rng().next_u64();\n Ok(B64::from(rand_u64).abi_encode())\n }\n}\n\nimpl Cheatcode for pauseTracingCall {\n fn apply_full(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n ) -> Result {\n let Some(tracer) = executor.tracing_inspector() else {\n // No tracer -> nothing to pause\n return Ok(Default::default());\n };\n\n // If paused earlier, ignore the call\n if ccx.state.ignored_traces.last_pause_call.is_some() {\n return Ok(Default::default());\n }\n\n let cur_node = &tracer.traces().nodes().last().expect(\"no trace nodes\");\n ccx.state.ignored_traces.last_pause_call = Some((cur_node.idx, cur_node.ordering.len()));\n\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for resumeTracingCall {\n fn apply_full(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n executor: &mut dyn CheatcodesExecutor,\n ) -> Result {\n let Some(tracer) = executor.tracing_inspector() else {\n // No tracer -> nothing to unpause\n return Ok(Default::default());\n };\n\n let Some(start) = ccx.state.ignored_traces.last_pause_call.take() else {\n // Nothing to unpause\n return Ok(Default::default());\n };\n\n let node = &tracer.traces().nodes().last().expect(\"no trace nodes\");\n ccx.state.ignored_traces.ignored.insert(start, (node.idx, node.ordering.len()));\n\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for interceptInitcodeCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self {} = self;\n if !state.intercept_next_create_call {\n state.intercept_next_create_call = true;\n } else {\n bail!(\"vm.interceptInitcode() has already been called\")\n }\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for setArbitraryStorage_0Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { target } = self;\n ccx.state.arbitrary_storage().mark_arbitrary(target, false);\n\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for setArbitraryStorage_1Call {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { target, overwrite } = self;\n ccx.state.arbitrary_storage().mark_arbitrary(target, *overwrite);\n\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for copyStorageCall {\n fn apply_stateful>(\n &self,\n ccx: &mut CheatsCtxt<'_, CTX>,\n ) -> Result {\n let Self { from, to } = self;\n\n ensure!(\n !ccx.state.has_arbitrary_storage(to),\n \"target address cannot have arbitrary storage\"\n );\n\n if let Ok(from_account) = ccx.ecx.journal_mut().load_account(*from) {\n let from_storage = from_account.storage.clone();\n if ccx.ecx.journal_mut().load_account(*to).is_ok() {\n // SAFETY: We ensured the account was already loaded.\n ccx.ecx.journal_mut().evm_state_mut().get_mut(to).unwrap().storage = from_storage;\n if let Some(arbitrary_storage) = &mut ccx.state.arbitrary_storage {\n arbitrary_storage.mark_copy(from, to);\n }\n }\n }\n\n Ok(Default::default())\n }\n}\n\nimpl Cheatcode for sortCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { array } = self;\n\n let mut sorted_values = array.clone();\n sorted_values.sort();\n\n Ok(sorted_values.abi_encode())\n }\n}\n\nimpl Cheatcode for shuffleCall {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { array } = self;\n\n let mut shuffled_values = array.clone();\n let rng = state.rng();\n shuffled_values.shuffle(rng);\n\n Ok(shuffled_values.abi_encode())\n }\n}\n\nimpl Cheatcode for setSeedCall {\n fn apply_stateful(&self, ccx: &mut CheatsCtxt<'_, CTX>) -> Result {\n let Self { seed } = self;\n ccx.state.set_seed(*seed);\n Ok(Default::default())\n }\n}\n\n/// Helper to generate a random `uint` value (with given bits or bounded if specified)\n/// from type strategy.\nfn random_uint(state: &mut Cheatcodes, bits: Option, bounds: Option<(U256, U256)>) -> Result {\n if let Some(bits) = bits {\n // Generate random with specified bits.\n ensure!(bits <= U256::from(256), \"number of bits cannot exceed 256\");\n return Ok(DynSolValue::type_strategy(&DynSolType::Uint(bits.to::()))\n .new_tree(state.test_runner())\n .unwrap()\n .current()\n .abi_encode());\n }\n\n if let Some((min, max)) = bounds {\n ensure!(min <= max, \"min must be less than or equal to max\");\n // Generate random between range min..=max\n let exclusive_modulo = max - min;\n let mut random_number: U256 = state.rng().random();\n if exclusive_modulo != U256::MAX {\n let inclusive_modulo = exclusive_modulo + U256::from(1);\n random_number %= inclusive_modulo;\n }\n random_number += min;\n return Ok(random_number.abi_encode());\n }\n\n // Generate random `uint256` value.\n Ok(DynSolValue::type_strategy(&DynSolType::Uint(256))\n .new_tree(state.test_runner())\n .unwrap()\n .current()\n .abi_encode())\n}\n\n/// Helper to generate a random `int` value (with given bits if specified) from type strategy.\nfn random_int(state: &mut Cheatcodes, bits: Option) -> Result {\n let no_bits = bits.unwrap_or(U256::from(256));\n ensure!(no_bits <= U256::from(256), \"number of bits cannot exceed 256\");\n Ok(DynSolValue::type_strategy(&DynSolType::Int(no_bits.to::()))\n .new_tree(state.test_runner())\n .unwrap()\n .current()\n .abi_encode())\n}\n\nimpl Cheatcode for eip712HashType_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { typeNameOrDefinition } = self;\n\n let type_def = get_canonical_type_def(typeNameOrDefinition, state, None)?;\n\n Ok(keccak256(type_def.as_bytes()).to_vec())\n }\n}\n\nimpl Cheatcode for eip712HashType_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { bindingsPath, typeName } = self;\n\n let path = state.config.ensure_path_allowed(bindingsPath, FsAccessKind::Read)?;\n let type_def = get_type_def_from_bindings(typeName, path, &state.config.root)?;\n\n Ok(keccak256(type_def.as_bytes()).to_vec())\n }\n}\n\nimpl Cheatcode for eip712HashStruct_0Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { typeNameOrDefinition, abiEncodedData } = self;\n\n let type_def = get_canonical_type_def(typeNameOrDefinition, state, None)?;\n let primary = &type_def[..type_def.find('(').unwrap_or(type_def.len())];\n\n get_struct_hash(primary, &type_def, abiEncodedData)\n }\n}\n\nimpl Cheatcode for eip712HashStruct_1Call {\n fn apply(&self, state: &mut Cheatcodes) -> Result {\n let Self { bindingsPath, typeName, abiEncodedData } = self;\n\n let path = state.config.ensure_path_allowed(bindingsPath, FsAccessKind::Read)?;\n let type_def = get_type_def_from_bindings(typeName, path, &state.config.root)?;\n\n get_struct_hash(typeName, &type_def, abiEncodedData)\n }\n}\n\nimpl Cheatcode for eip712HashTypedDataCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { jsonData } = self;\n let typed_data: TypedData = serde_json::from_str(jsonData)?;\n let digest = typed_data.eip712_signing_hash()?;\n\n Ok(digest.to_vec())\n }\n}\n\n/// Returns EIP-712 canonical type definition from the provided string type representation or type\n/// name. If type name provided, then it looks up bindings from file generated by `forge bind-json`.\nfn get_canonical_type_def(\n name_or_def: &String,\n state: &mut Cheatcodes,\n path: Option,\n) -> Result {\n let type_def = if name_or_def.contains('(') {\n // If the input contains '(', it must be the type definition.\n EncodeType::parse(name_or_def).and_then(|parsed| parsed.canonicalize())?\n } else {\n // Otherwise, it must be the type name.\n let path = path.as_ref().unwrap_or(&state.config.bind_json_path);\n let path = state.config.ensure_path_allowed(path, FsAccessKind::Read)?;\n get_type_def_from_bindings(name_or_def, path, &state.config.root)?\n };\n\n Ok(type_def)\n}\n\n/// Returns the EIP-712 type definition from the bindings in the provided path.\n/// Assumes that read validation for the path has already been checked.\nfn get_type_def_from_bindings(name: &String, path: PathBuf, root: &PathBuf) -> Result {\n let content = fs::read_to_string(&path)?;\n\n let type_defs: HashMap<&str, &str> = content\n .lines()\n .filter_map(|line| {\n let relevant = line.trim().strip_prefix(TYPE_BINDING_PREFIX)?;\n let (name, def) = relevant.split_once('=')?;\n Some((name.trim(), def.trim().strip_prefix('\"')?.strip_suffix(\"\\\";\")?))\n })\n .collect();\n\n match type_defs.get(name.as_str()) {\n Some(value) => Ok(value.to_string()),\n None => {\n let bindings =\n type_defs.keys().map(|k| format!(\" - {k}\")).collect::>().join(\"\\n\");\n\n bail!(\n \"'{}' not found in '{}'.{}\",\n name,\n path.strip_prefix(root).unwrap_or(&path).to_string_lossy(),\n if bindings.is_empty() {\n String::new()\n } else {\n format!(\"\\nAvailable bindings:\\n{bindings}\\n\")\n }\n );\n }\n }\n}\n\n/// Returns the EIP-712 struct hash for provided name, definition and ABI encoded data.\nfn get_struct_hash(primary: &str, type_def: &String, abi_encoded_data: &Bytes) -> Result {\n let mut resolver = Resolver::default();\n\n // Populate the resolver by ingesting the canonical type definition, and then get the\n // corresponding `DynSolType` of the primary type.\n resolver\n .ingest_string(type_def)\n .map_err(|e| fmt_err!(\"Resolver failed to ingest type definition: {e}\"))?;\n\n let resolved_sol_type = resolver\n .resolve(primary)\n .map_err(|e| fmt_err!(\"Failed to resolve EIP-712 primary type '{primary}': {e}\"))?;\n\n // ABI-decode the bytes into `DynSolValue::CustomStruct`.\n let sol_value = resolved_sol_type.abi_decode(abi_encoded_data.as_ref()).map_err(|e| {\n fmt_err!(\"Failed to ABI decode using resolved_sol_type directly for '{primary}': {e}.\")\n })?;\n\n // Use the resolver to properly encode the data.\n let encoded_data: Vec = resolver\n .encode_data(&sol_value)\n .map_err(|e| fmt_err!(\"Failed to EIP-712 encode data for struct '{primary}': {e}\"))?\n .ok_or_else(|| fmt_err!(\"EIP-712 data encoding returned 'None' for struct '{primary}'\"))?;\n\n // Compute the type hash of the primary type.\n let type_hash = resolver\n .type_hash(primary)\n .map_err(|e| fmt_err!(\"Failed to compute typeHash for EIP712 type '{primary}': {e}\"))?;\n\n // Compute the struct hash of the concatenated type hash and encoded data.\n let mut bytes_to_hash = Vec::with_capacity(32 + encoded_data.len());\n bytes_to_hash.extend_from_slice(type_hash.as_slice());\n bytes_to_hash.extend_from_slice(&encoded_data);\n\n Ok(keccak256(&bytes_to_hash).to_vec())\n}\n\nimpl Cheatcode for toRlpCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { data } = self;\n\n let mut buf = Vec::new();\n data.encode(&mut buf);\n\n Ok(Bytes::from(buf).abi_encode())\n }\n}\n\nimpl Cheatcode for fromRlpCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { rlp } = self;\n\n let decoded: Vec = Vec::::decode(&mut rlp.as_ref())\n .map_err(|e| fmt_err!(\"Failed to decode RLP: {e}\"))?;\n\n Ok(decoded.abi_encode())\n }\n}\n" }, { "path": "crates/cheatcodes/src/version.rs", "content": "use crate::{Cheatcode, Cheatcodes, Result, Vm::*};\nuse alloy_sol_types::SolValue;\nuse foundry_common::version::SEMVER_VERSION;\nuse semver::Version;\nuse std::cmp::Ordering;\n\nimpl Cheatcode for foundryVersionCmpCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { version } = self;\n foundry_version_cmp(version).map(|cmp| (cmp as i8).abi_encode())\n }\n}\n\nimpl Cheatcode for foundryVersionAtLeastCall {\n fn apply(&self, _state: &mut Cheatcodes) -> Result {\n let Self { version } = self;\n foundry_version_cmp(version).map(|cmp| cmp.is_ge().abi_encode())\n }\n}\n\nfn foundry_version_cmp(version: &str) -> Result {\n version_cmp(SEMVER_VERSION.split('-').next().unwrap(), version)\n}\n\nfn version_cmp(version_a: &str, version_b: &str) -> Result {\n let version_a = parse_version(version_a)?;\n let version_b = parse_version(version_b)?;\n Ok(version_a.cmp(&version_b))\n}\n\nfn parse_version(version: &str) -> Result {\n let version =\n Version::parse(version).map_err(|e| fmt_err!(\"invalid version `{version}`: {e}\"))?;\n if !version.pre.is_empty() {\n return Err(fmt_err!(\n \"invalid version `{version}`: pre-release versions are not supported\"\n ));\n }\n if !version.build.is_empty() {\n return Err(fmt_err!(\"invalid version `{version}`: build metadata is not supported\"));\n }\n Ok(version)\n}\n" }, { "path": "crates/chisel/Cargo.toml", "content": "[package]\nname = \"chisel\"\ndescription = \"Fast, utilitarian, and verbose Solidity REPL\"\n\nauthors.workspace = true\nversion.workspace = true\nedition.workspace = true\nrust-version.workspace = true\nlicense.workspace = true\nhomepage.workspace = true\nrepository.workspace = true\n\n[lints]\nworkspace = true\n\n[[bin]]\nname = \"chisel\"\npath = \"bin/main.rs\"\n\n[dependencies]\n# forge\nforge-doc.workspace = true\nforge-fmt.workspace = true\nfoundry-cli.workspace = true\nfoundry-common.workspace = true\nfoundry-compilers.workspace = true\nfoundry-config.workspace = true\nfoundry-evm.workspace = true\n\ntempfile.workspace = true\n\nsolar.workspace = true\n\nalloy-dyn-abi = { workspace = true, features = [\"arbitrary\"] }\nalloy-primitives = { workspace = true, features = [\n \"serde\",\n \"getrandom\",\n \"arbitrary\",\n \"rlp\",\n] }\nalloy-json-abi.workspace = true\n\nclap = { version = \"4\", features = [\"derive\", \"env\", \"wrap_help\"] }\ndirs.workspace = true\neyre.workspace = true\nreqwest.workspace = true\nrustyline = \"17\"\nitertools.workspace = true\nsemver.workspace = true\nserde_json.workspace = true\nserde.workspace = true\nsolang-parser.workspace = true\ntime = { version = \"0.3\", features = [\"formatting\"] }\nyansi.workspace = true\ntracing.workspace = true\nwalkdir.workspace = true\n\n[dev-dependencies]\ntracing-subscriber.workspace = true\n\n# REPL tests only work on Unix.\n[target.'cfg(unix)'.dev-dependencies]\nfoundry-test-utils.workspace = true\nrexpect = \"0.6\"\n\n[features]\ndefault = [\"jemalloc\"]\nasm-keccak = [\"alloy-primitives/asm-keccak\"]\njemalloc = [\"foundry-cli/jemalloc\"]\nmimalloc = [\"foundry-cli/mimalloc\"]\ntracy-allocator = [\"foundry-cli/tracy-allocator\"]\n" }, { "path": "crates/chisel/assets/preview.tape", "content": "# VHS File source\n# https://github.com/charmbracelet/vhs\n#\n# Output:\n# Output .gif Create a GIF output at the given \n# Output .mp4 Create an MP4 output at the given \n# Output .webm Create a WebM output at the given \n#\n# Settings:\n# Set FontSize Set the font size of the terminal\n# Set FontFamily Set the font family of the terminal\n# Set Height Set the height of the terminal\n# Set Width Set the width of the terminal\n# Set LetterSpacing Set the font letter spacing (tracking)\n# Set LineHeight Set the font line height\n# Set Theme Set the theme of the terminal (JSON)\n# Set Padding Set the padding of the terminal\n# Set Framerate Set the framerate of the recording\n# Set PlaybackSpeed Set the playback speed of the recording\n#\n# Sleep:\n# Sleep