refactor(solc): rewrite compiler passes and cache change detection

[mattsse]

Motivation

Close #784
Close #727

Solution

PR Checklist

• Added Tests
• Added Documentation
• Updated the changelog

[gakonst]

so far so good-really like the direction

[mattsse]

Update

• complete new compile API
• more docs

TODO

• integrate source units paths for imports/sources
• integrate version ref Change artifact naming conventions #791
• delete deprecated code

Update 2

• updated CacheEntry model (adapted from Change artifact naming conventions #791)
• started phasing out existing compile pipeline, currently totally broken

  TODO

  • • Update/simplify ArtifactOutput trait, including write CompactContractBytecode instead of CompactContract #833

[gakonst]

@mattsse should we pull in the Forge integration tests for compilation in ethers-solc perhaps?

[mattsse]

@mattsse should we pull in the Forge integration tests for compilation in ethers-solc perhaps?

debugging on patched foundry rn

Also, currently we're storing absolute paths in the cache file, we can store them relatively, however it doesn't really matter since this should be always kept locally, so I guess absolute paths are fine.

[gakonst]

Just a doctest failing

[mattsse]

Update

• added various helper functions
• simplified source map handling
• fixed doctests

manual testing indicates, that this appears to finally resolve the spells-mainnet cache bug

foundry-rs/foundry#316

• added foundry companion feat(solc): migrate new ethers-solc backend foundry-rs/foundry#660, all tests pass

BEFORE MERGE

• double check on foundry regarding relative/absolute paths, especially for linking

[gakonst]

OK let's go - pray