feat(cast): Cast generic Network support (foundry-rs#13624)

[Dargon789]

Motivation

Solution

PR Checklist

• Added Tests
• Added Documentation
• Breaking changes
  feat(cast): Cast generic Network support foundry-rs/foundry#13624

[codesandbox]

Review or Edit in CodeSandbox

Open the branch in Web Editor • VS Code • Insiders

Open Preview

[sourcery-ai]

Sorry @Dargon789, your pull request is larger than the review limit of 150000 diff characters

[snyk-io]

✅ Snyk checks have passed. No issues have been found so far.

Status	Scan Engine	Critical	High	Medium	Low	Total (0)
✅	Open Source Security	0	0	0	0	0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

[Dargon789]

@Mergifyio refresh

[gemini-code-assist]

Summary of Changes

Hello, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly enhances the foundry ecosystem by introducing generic network support to the cast CLI tool and refactoring core EVM and transaction handling components. The changes aim to improve the flexibility and extensibility of foundry by making its tools and internal logic more adaptable to different blockchain networks, particularly TempoNetwork. This involves a broad update of type parameters, trait implementations, and dependency management to ensure a robust and future-proof architecture.

Highlights

• Generic Network Support for Cast: The cast CLI tool has been refactored to support generic Network types, moving away from hardcoded AnyNetwork in many commands. This allows for greater flexibility and future integration with different network types, such as TempoNetwork.
• EVM Environment Simplification: EVM-related components across anvil, cheatcodes, chisel, and evm/core have been updated to streamline environment handling. This includes removing TxEnv from snapshot_state parameters and directly passing EvmEnv for fork creation and management, simplifying the internal EVM state logic.
• Signer Trait Refactoring: The Signer trait in crates/anvil/src/eth/sign.rs has been split into MessageSigner and Signer<N: Network>. This change clearly separates the concerns of signing generic messages from network-specific transaction signing, improving modularity and type safety.
• Dependency Updates: Key dependencies have been adjusted, with alloy-consensus, foundry-primitives, and tempo-alloy being added, and alloy-rpc-types and alloy-serde being removed from direct dependencies in crates/cast/Cargo.toml (with alloy-serde moving to dev-dependencies). This reflects the shift towards more granular and network-aware alloy components.
• RLP Encoding Enhancements: A new TryIntoRlpEncodable trait has been introduced in crates/cast/src/rlp_converter.rs to provide a generic mechanism for RLP encoding various header types, including AnyHeader and TempoHeader.

Changelog

• Cargo.lock
  • Updated dependencies, adding alloy-consensus, foundry-primitives, and tempo-alloy while removing alloy-rpc-types and alloy-serde.
• crates/anvil/src/eth/api.rs
  • Updated storage_info method to return StorageInfo<FoundryNetwork>.
• crates/anvil/src/eth/backend/info.rs
  • Modified StorageInfo struct to be generic over Network and moved receipt-related methods to a FoundryNetwork specific implementation.
• crates/anvil/src/eth/fees.rs
  • Updated FeeHistoryService to use StorageInfo<FoundryNetwork>.
• crates/anvil/src/eth/sign.rs
  • Refactored Signer trait into MessageSigner and Signer<N: Network> to separate message and transaction signing.
• crates/anvil/src/evm.rs
  • Removed EvmEnv from create_eth_evm and create_op_evm functions, and updated EVM context initialization to use BlockEnv::default() and CfgEnv::new_with_spec directly.
• crates/anvil/src/filter.rs
  • Updated LogsFilter to use StorageInfo<FoundryNetwork>.
• crates/anvil/src/pubsub.rs
  • Updated LogsSubscription and EthSubscription to use StorageInfo<FoundryNetwork>.
• crates/cast/Cargo.toml
  • Removed alloy-serde from main dependencies and added alloy-serde to dev-dependencies.
  • Added alloy-consensus, foundry-primitives, and tempo-alloy as dependencies.
• crates/cast/src/args.rs
  • Introduced a transaction_raw helper function for FoundryNetwork specific raw transaction encoding.
  • Modified CastSubcommand::Tx to conditionally use transaction_raw or the generic Cast::transaction.
• crates/cast/src/cmd/access_list.rs
  • Updated AccessListArgs to support generic Network types via run_with_network and use ProviderBuilder<N>.
• crates/cast/src/cmd/call.rs
  • Updated CallArgs to support generic Network types via run_with_network and use ProviderBuilder<N>.
  • Modified transaction parameter accessors (e.g., tx.value, tx.inner.input) to use new network-agnostic methods.
• crates/cast/src/cmd/estimate.rs
  • Updated EstimateArgs to support generic Network types via run_with_network and use ProviderBuilder<N>.
• crates/cast/src/cmd/send.rs
  • Refactored transaction sending logic to use a new print_tx_result method for consistent output.
  • Simplified browser wallet handling.
• crates/cast/src/lib.rs
  • Made Cast struct generic over Network.
  • Removed raw parameter from Cast::transaction and introduced transaction_raw helper.
  • Updated block header RLP encoding to use TryIntoRlpEncodable.
  • Modified Cast::call and Cast::access_list to accept generic N::TransactionRequest.
• crates/cast/src/rlp_converter.rs
  • Added TryIntoRlpEncodable trait for generic RLP encoding of headers, with implementations for alloy_consensus::Header, TempoHeader, and AnyHeader.
• crates/cast/src/tx.rs
  • Added print_tx_result method to CastTxSender for unified transaction result printing.
• crates/cheatcodes/src/evm.rs
  • Updated inner_snapshot_state to use EvmEnv directly for snapshot creation, removing TxEnv.
• crates/cheatcodes/src/evm/fork.rs
  • Modified create_fork_request to pass EvmEnv directly instead of a combined Env struct.
• crates/chisel/src/executor.rs
  • Updated SessionSource to pass env.evm_env.clone() to get_fork.
• crates/common/fmt/src/lib.rs
  • Added UIfmtHeaderExt and UIfmtSignatureExt traits for UI formatting.
• crates/evm/core/src/backend/cow.rs
  • Updated snapshot_state to remove TxEnv parameter and use TxEnv::default() internally.
• crates/evm/core/src/backend/mod.rs
  • Modified DatabaseExt::snapshot_state trait method to remove TxEnv parameter.
  • Updated Backend::snapshot_state and Backend::revert_state to reflect the change in snapshot_state signature.
• crates/evm/core/src/backend/snapshot.rs
  • Removed snap_tx_env field from BackendStateSnapshot struct.
• crates/evm/core/src/fork/mod.rs
  • Updated CreateFork struct to use EvmEnv directly instead of a combined Env struct.
• crates/evm/core/src/fork/multi.rs
  • Modified MultiFork methods (create_fork, get_evm_env) and Request enum to use EvmEnv instead of Env.
• crates/evm/core/src/opts.rs
  • Updated EvmOpts::get_fork to accept EvmEnv directly instead of a combined Env struct.
• crates/evm/evm/src/executors/trace.rs
  • Updated TracingExecutor to pass env.evm_env.clone() to get_fork.
• crates/forge/Cargo.toml
  • Added alloy-consensus, foundry-primitives, and tempo-alloy as dependencies.
  • Removed alloy-rpc-types and alloy-serde.
• crates/forge/src/cmd/create.rs
  • Refactored CreateArgs::run to be generic over Network via run_generic.
  • Updated deploy function to be generic over Network and use ProviderBuilder<N>.
  • Modified transaction parameter application logic to use self.tx.apply::<N> and fetch defaults from the provider.
• crates/forge/src/cmd/test/mod.rs
  • Updated TestArgs to pass env.evm_env.clone() to get_fork.
• crates/primitives/src/transaction/envelope.rs
  • Removed SignableTransaction and RlpEcdsaEncodableTx implementations for FoundryTypedTx.
• crates/script/src/lib.rs
  • Updated ScriptConfig to pass env.evm_env.clone() to get_fork.
• crates/verify/src/etherscan/standard_json.rs
  • Simplified Vyper input generation by using context.get_vyper_standard_json_input().
• crates/verify/src/provider.rs
  • Added get_vyper_standard_json_input method to VerificationContext.
• crates/verify/src/sourcify.rs
  • Simplified Vyper input generation by using context.get_vyper_standard_json_input().

Activity

• The pull request description is a template and does not contain specific activity details or comments.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[mergify]

refresh

✅ Pull request refreshed

[gemini-code-assist]

Code Review

This pull request introduces generic network support for the cast crate, a significant architectural refactoring. The Cast struct and its methods are now generic over the alloy_network::Network trait, allowing them to work with different network types like AnyNetwork and TempoNetwork. This required changes across multiple crates, including anvil, forge, and foundry-evm-core, to adapt to the new generic APIs. Key changes include using generic transaction requests, introducing a TryIntoRlpEncodable trait for headers, and refactoring provider creation to use a generic ProviderBuilder. The changes are well-structured and improve the flexibility of cast.

[vercel]

@github-actions[bot] is attempting to deploy a commit to the Foundry development Team on Vercel.

A member of the Team first needs to authorize it.