Feature: Local EVM Testing Environment with Foundry

[isSerge]

Describe the feature

The absence of a documented local testing strategy presents a significant hurdle. Without a documented local setup, relying on public testnets is less controllable, introduces potential costs, and slows down the feedback loop. A dedicated local testing environment would provide a faster, more controlled, and cost-effective way to iterate on monitor development and debugging.

I think it would be beneficial to add support and documentation for setting up a local EVM testing environment using Foundry, specifically:

• Anvil to run local EVM node
• Cast to send transactions to a local EVM node and trigger monitor conditions
• Forge to compile and deploy test contracts

This feature would primarily involve:

• Adding documentation describing setup and usage
• Adding network configuration for Anvil
• Adding monitor configuration adapted for a locally deployed contract
• Solidity contract(s) for testing (can start with just an ERC-20)

This setup will greatly enhance the testability and reliability of monitors and filters before they are deployed to watch mainnet or testnet environments.

Additional context

No response

[shahnami]

This is a great suggestion, thanks! We could add a sort of "tutorials" page in our current docs which includes a "Setup a local testing environment" section. Additionally, we can add some examples configs in the examples folder, and/or a shell script to:

1. Run a local node with Hardhat or Anvil
2. Compile and deploy the contract with the default address
3. (optionally) Run the monitor service
4. Send a test transaction

However, given our current workload and the priority on this, we may only be able to tackle this in a few months..
If you feel up for it, let me know!

[isSerge]

I can tackle some higher priority items if you create issues

[dajneem23]

I'm interested in this issue too

[NicoMolinaOZ]

I'm interested in this issue too

Feel free to go ahead, thanks!