feat(cheatcodes): access broadcast artifacts

[yash-atreya]

Motivation

Builds upon #9098

Closes #4732 + Closes #9083

Solution

// Returns the most recent broadcast for the given contract on `chainId` matching `txType`.
function getBroadcast(string memory contractName, uint64 chainId, BroadcastTxType txType) external returns (BroadcastTxSummary memory);

//  Returns all broadcasts for the given contract on `chainId` with the specified `txType`.
//  Sorted such that the most recent broadcast is the first element, and the oldest is the last. i.e descending order of BroadcastTxSummary.blockNumber.
function getBroadcasts(string memory contractName, uint64 chainId, BroadcastTxType txType) external returns (BroadcastTxSummary[] memory);

// Returns all broadcasts for the given contract on `chainId`.
// Sorted such that the most recent broadcast is the first element, and the oldest is the last. i.e descending order of BroadcastTxSummary.blockNumber.
function getBroadcasts(string memory contractName, uint64 chainId) external returns (BroadcastTxSummary[] memory);

• Tests

[grandizzy]

I think we should add some comments to struct and functions. Also, would it make sense to move the reader in a common crate so it could also be used from other places, wdyt? (like if we want to provide a cli for broadcast history)

[yash-atreya]

This would cause cyclic deps between common and script-seqeunce. I could move it to script-sequence? @grandizzy

[grandizzy]

ah, I see, I think should work. @klkvr wdyt, would script-sequence be a good place or not worth moving it?