feat(solc): add configurable Artifact type

[mattsse]

Motivation

Ref foundry-rs/foundry#705

Solution

• make the Project take the ArtifactOutput as value
• Add ConfigurableArtifacts type that can be configured to include additional values from the Contract

Open questions for follow:

• since the new ConfigurableContractArtifact is basically a super set of the CompactContractBytecode we use by default, which are identical without additional config, should we change the default ArtifactType? I can refactor this to not break anything on foundry

PR Checklist

• Added Tests
• Added Documentation
• Updated the changelog

[gakonst]

since the new ConfigurableContractArtifact is basically a super set of the CompactContractBytecode we use by default, which are identical without additional config, should we change the default ArtifactType? I can refactor this to not break anything on foundry

As discussed in DMs, let's merge the types together.

[mattsse]

Update

• made the default project ArtifactOutput type ConfigurableArtifacts which by default behaves exactly as the minimal MinimalCombinedArtifacts which is the basic config, (basically solc --combined-json abi bin bin-runtime)

The Project now takes the ArtifactOutput handler as value, instead of PhantomData pin, which also us to dynamically configure the ConfigurableArtifacts with any variant from the ContractOutputSelection enum.

with ConfigurableArtifacts we can modify the contract's json artifact on the fly and include metadata, devdoc, ir etc... but also emit some of them as additional files, or both.

This is mirrored on foundry foundry-rs/foundry#762

[gakonst]

LGTM.

[gakonst]

how come the contract _name and _file are not needed in this case? is our abstraction maybe not ideal and should be reconsidered?

[mattsse]

right this is not needed in this case as we only want the artifact object, but the full info could still be relevant, e.g. for an artifact that also contains the name of the contract.