Local Relay

[hashcashier]

This PR introduces a local simplified Relay in addition to the foundry integration middleware.

Usage

1. Start an anvil instance:

anvil

2. Run the provided deploy script to deploy the local relay and the starter contract:

RELAY_PRIVATE_KEY=0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80 forge script script/Deploy.s.sol:Deploy --rpc-url http://localhost:8545 --broadcast

3. Run the local relay binary:

cargo run relay --relay-contract-address 0x5fbdb2315678afecb367f032d93f642f64180aa3 --eth-node-url ws://localhost:8545 --private-key ac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80

4. Send a transaction to the starter contract:

cast send --private-key 0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d 0xe7f1725e7734ce288f8367e1bb143e90bb3f0512 'calculateFibonacci(uint256)' 5

5. Check the relayed result:

cast call 0xe7f1725e7734ce288f8367e1bb143e90bb3f0512 'fibonacci(uint256)' 5

[mothran]

I ran things locally and it all makes sense to me. Seems like a good path to get a full local mock of the relay working! Really nice work.

Here are a couple general items I would call out:

1. clippy warnings across a few files that might be nice to clear up
2. It would be great to get the relay e2e in the github actions CI
3. Could we add a new section to the README describing the steps to use the relay that you put in the PR.
4. In the README steps you might wanna call out which commands have to be run in new terminals (and how to set the BONSAI_PROVER=... for the relay command
5. Could we add logging to the relay when its running in non-query mode? maybe use the tracing_subscriber system at set the log level when its invoked in relay mode. That way a user could see the requests being processed.

Thanks so much for hacking this together!

[onokatio]

I noteced that clear build cache (rm target/) is neccessary to run relay. Or we got error:

thread 'main' panicked at 'Failed to resolve guest entry: Unknown guest binary 0000000000000000000000000000000000000000000000000000000000000000, found: ["ee32dd84d935ed8db5221232ab389d77b1e07bde85db192d31fcc673bfd0726f"]', /Users/tmaruyama/script2/github.com/risc0/bonsai-foundry-template/relay/src/lib.rs:174:56
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace

[onokatio]

It may happend from reading old GUEST_LIST.

[nategraf]

Is it intentional that these JSON artifacts are included? It seems like they should not be.

[hashcashier]

the contracts in the relay directory don't get compiled by foundry, but get compiled using ethers-solc when the solidity_compile feature flag is passed in, so using this build cache is a shortcut to that

[nategraf]

Sure sure, but why does the cache need to be committed to git? By default I would assume it should not be.

[hashcashier]

I've revised the PR but I've left out the CI and the logging/tracing work for a future PR.