feat(forge): specify compilation profile in vm.getCode (foundry-rs#13191)

* feat(forge): specify compilation profile in vm.getCode

Add support for specifying a compilation profile in artifact path parsing for
vm.getCode, vm.getDeployedCode, and vm.deployCode cheatcodes.

This allows users with multiple compilation profiles in foundry.toml to select
specific artifact versions. For example:
- `vm.getCode("Contract.sol:v1")`
- `vm.getCode("Contract.sol:ContractName:optimized")`

The feature distinguishes between semver versions (like 0.8.23) and profile
names (like v1, optimized) by attempting to parse the suffix as a version
first.

Closes foundry-rs#12821

* fix: address clippy warnings

- Combine duplicate if branches for version detection
- Remove needless ref borrow in profile comparison

* test: add unit tests for artifact path parsing and profile support

- Refactor parsing logic into reusable parse_artifact_path function
- Add 11 unit tests covering all artifact path formats:
  - file only, file+contract, file+contract+version, file+contract+profile
  - file+version, contract only, contract+version, contract+profile
  - Various profile name patterns (v1, v2, paris, optimized, etc.)
- Add Solidity integration test for profile-based getCode

* test: add multi-profile test demonstrating different bytecode per profile

Add comprehensive tests showing that vm.getCode correctly retrieves
different bytecode for different compilation profiles:

- Create testdata/multi-profile/ with Counter contract compiled using
  'default', 'optimized' (10000 runs), and 'unoptimized' (no optimizer) profiles
- Add tests verifying:
  - Different profiles produce different bytecode
  - vm.getCode('Contract:profile') works correctly
  - vm.getCode('path/to/Contract.sol:Contract:profile') works correctly
  - vm.deployCode with profile works
  - vm.getDeployedCode with profile works
  - Non-existent profiles fail appropriately

* style: fix rustfmt formatting

* style: fix forge fmt formatting in Solidity test

* fix: simplify multi-profile tests to verify parsing behavior

- Remove invalid 'profiles' field from compilation_restrictions
- Use assertTrue instead of assertNotEq (not available in DSTest)
- Simplify tests to verify profile parsing works with default profile
- Test that non-existent profiles fail appropriately

* fix: restore multi-profile compilation restriction in foundry.toml

* fix: rename Counter to ProfileCounter to avoid artifact name collision

The multi-version tests use a contract named Counter, causing conflicts
when my multi-profile tests also used Counter.

* fix: remove multi-profile Solidity test to avoid breaking existing tests

The additional_compiler_profiles cause all contracts to be compiled with
multiple profiles, which breaks the existing multi-version tests that
rely on version-based disambiguation.

The unit tests for artifact path parsing adequately test the profile
feature at the parsing level. End-to-end testing of profile-based
selection requires a more complex test setup.

* test: add profile-based getCode test using existing paris profile

Add test demonstrating vm.getCode with profile selection using the existing
paris compilation profile. Tests:
- vm.getCode("path:Contract:paris") format
- vm.getCode("Contract:paris") format
- vm.getDeployedCode and vm.deployCode with profile
- Error when using non-existent profile
- Error when requesting wrong profile for a contract

This test uses the existing paris profile which is already scoped to
paris/** files, avoiding conflicts with other multi-version tests.

Amp-Thread-ID: https://ampcode.com/threads/T-019bea01-185e-7079-990e-f33585663be2
Co-authored-by: Amp <amp@ampcode.com>

* test: add multi-profile test with proper disambiguation fix

Fix the artifact disambiguation logic to not filter by running_artifact's
version/profile when user has explicitly specified those criteria. This
allows adding global additional_compiler_profiles without breaking
existing tests.

Changes:
- Fix disambiguation: only use running_artifact's version for filtering
  when user did NOT specify a version in the artifact path
- Same fix for profile filtering
- Add 'optimized' and 'unoptimized' profiles to testdata/foundry.toml
- Add GetCodeMultiProfile.t.sol demonstrating that different profiles
  produce different bytecode and can be selected via vm.getCode

The test verifies:
- vm.getCode("Contract:optimized") returns different bytecode than
  vm.getCode("Contract:unoptimized")
- vm.deployCode and vm.getDeployedCode work with profile selection
- Non-existent profiles fail appropriately

Amp-Thread-ID: https://ampcode.com/threads/T-019bea01-185e-7079-990e-f33585663be2
Co-authored-by: Amp <amp@ampcode.com>

* fix: use require instead of assertNotEq for bytes32 comparison

assertNotEq doesn't have an overload for bytes32, use require with != instead

* fix: resolve CI failures for profile-based artifact selection

Changes:
- Remove GetCodeMultiProfile.t.sol test that expected artifacts compiled
  with 'optimized' and 'unoptimized' profiles without corresponding
  compilation_restrictions
- Remove unused 'optimized' and 'unoptimized' profiles from foundry.toml
  (the paris profile remains as it has proper restrictions)
- Update multi-version tests to use full paths (multi-version/Counter.sol)
  to avoid ambiguity with other Counter contracts in testdata that would
  cause 'multiple matching artifacts found' error

Amp-Thread-ID: https://ampcode.com/threads/T-019bea8a-abde-7172-9b50-efb0569a8222
Co-authored-by: Amp <amp@ampcode.com>

* fix fmt

* fix getCode file profile lookup

* fix: prefer contract name for ambiguous getCode artifact paths

---------

Co-authored-by: Amp <amp@ampcode.com>
Co-authored-by: zerosnacks <zerosnacks@protonmail.com>
Co-authored-by: zerosnacks <95942363+zerosnacks@users.noreply.github.com>
Co-authored-by: Derek <256792747+decofe@users.noreply.github.com>
Co-authored-by: Centaur AI <ai@centaur.local>
Co-authored-by: Mablr <59505383+mablr@users.noreply.github.com>
Co-authored-by: grandizzy <38490174+grandizzy@users.noreply.github.com>

Author: 8 people

crates/cheatcodes/assets/cheatcodes.json

@@ -1998,72 +1998,83 @@ interface Vm {
     function getArtifactPathByDeployedCode(bytes calldata deployedCode) external view returns (string memory path);
 
     /// Gets the creation bytecode from an artifact file. Takes in the relative path to the json file or the path to the
-    /// artifact in the form of <path>:<contract>:<version> where <contract> and <version> parts are optional.
+    /// artifact in the form of <path>:<contract>:<version> or <path>:<contract>:<profile> where <contract> and
+    /// <version>/<profile> parts are optional. Use <profile> to select artifacts compiled with a specific profile
+    /// from foundry.toml.
     #[cheatcode(group = Filesystem)]
     function getCode(string calldata artifactPath) external view returns (bytes memory creationBytecode);
 
     /// Deploys a contract from an artifact file. Takes in the relative path to the json file or the path to the
-    /// artifact in the form of <path>:<contract>:<version> where <contract> and <version> parts are optional.
+    /// artifact in the form of <path>:<contract>:<version> or <path>:<contract>:<profile> where <contract> and
+    /// <version>/<profile> parts are optional.
     /// Reverts if the target artifact contains unlinked library placeholders.
     #[cheatcode(group = Filesystem)]
     function deployCode(string calldata artifactPath) external returns (address deployedAddress);
 
     /// Deploys a contract from an artifact file. Takes in the relative path to the json file or the path to the
-    /// artifact in the form of <path>:<contract>:<version> where <contract> and <version> parts are optional.
+    /// artifact in the form of <path>:<contract>:<version> or <path>:<contract>:<profile> where <contract> and
+    /// <version>/<profile> parts are optional.
     /// Reverts if the target artifact contains unlinked library placeholders.
     ///
     /// Additionally accepts abi-encoded constructor arguments.
     #[cheatcode(group = Filesystem)]
     function deployCode(string calldata artifactPath, bytes calldata constructorArgs) external returns (address deployedAddress);
 
     /// Deploys a contract from an artifact file. Takes in the relative path to the json file or the path to the
-    /// artifact in the form of <path>:<contract>:<version> where <contract> and <version> parts are optional.
+    /// artifact in the form of <path>:<contract>:<version> or <path>:<contract>:<profile> where <contract> and
+    /// <version>/<profile> parts are optional.
     /// Reverts if the target artifact contains unlinked library placeholders.
     ///
     /// Additionally accepts `msg.value`.
     #[cheatcode(group = Filesystem)]
     function deployCode(string calldata artifactPath, uint256 value) external returns (address deployedAddress);
 
     /// Deploys a contract from an artifact file. Takes in the relative path to the json file or the path to the
-    /// artifact in the form of <path>:<contract>:<version> where <contract> and <version> parts are optional.
+    /// artifact in the form of <path>:<contract>:<version> or <path>:<contract>:<profile> where <contract> and
+    /// <version>/<profile> parts are optional.
     /// Reverts if the target artifact contains unlinked library placeholders.
     ///
     /// Additionally accepts abi-encoded constructor arguments and `msg.value`.
     #[cheatcode(group = Filesystem)]
     function deployCode(string calldata artifactPath, bytes calldata constructorArgs, uint256 value) external returns (address deployedAddress);
 
     /// Deploys a contract from an artifact file, using the CREATE2 salt. Takes in the relative path to the json file or the path to the
-    /// artifact in the form of <path>:<contract>:<version> where <contract> and <version> parts are optional.
+    /// artifact in the form of <path>:<contract>:<version> or <path>:<contract>:<profile> where <contract> and
+    /// <version>/<profile> parts are optional.
     /// Reverts if the target artifact contains unlinked library placeholders.
     #[cheatcode(group = Filesystem)]
     function deployCode(string calldata artifactPath, bytes32 salt) external returns (address deployedAddress);
 
     /// Deploys a contract from an artifact file, using the CREATE2 salt. Takes in the relative path to the json file or the path to the
-    /// artifact in the form of <path>:<contract>:<version> where <contract> and <version> parts are optional.
+    /// artifact in the form of <path>:<contract>:<version> or <path>:<contract>:<profile> where <contract> and
+    /// <version>/<profile> parts are optional.
     /// Reverts if the target artifact contains unlinked library placeholders.
     ///
     /// Additionally accepts abi-encoded constructor arguments.
     #[cheatcode(group = Filesystem)]
     function deployCode(string calldata artifactPath, bytes calldata constructorArgs, bytes32 salt) external returns (address deployedAddress);
 
     /// Deploys a contract from an artifact file, using the CREATE2 salt. Takes in the relative path to the json file or the path to the
-    /// artifact in the form of <path>:<contract>:<version> where <contract> and <version> parts are optional.
+    /// artifact in the form of <path>:<contract>:<version> or <path>:<contract>:<profile> where <contract> and
+    /// <version>/<profile> parts are optional.
     /// Reverts if the target artifact contains unlinked library placeholders.
     ///
     /// Additionally accepts `msg.value`.
     #[cheatcode(group = Filesystem)]
     function deployCode(string calldata artifactPath, uint256 value, bytes32 salt) external returns (address deployedAddress);
 
     /// Deploys a contract from an artifact file, using the CREATE2 salt. Takes in the relative path to the json file or the path to the
-    /// artifact in the form of <path>:<contract>:<version> where <contract> and <version> parts are optional.
+    /// artifact in the form of <path>:<contract>:<version> or <path>:<contract>:<profile> where <contract> and
+    /// <version>/<profile> parts are optional.
     /// Reverts if the target artifact contains unlinked library placeholders.
     ///
     /// Additionally accepts abi-encoded constructor arguments and `msg.value`.
     #[cheatcode(group = Filesystem)]
     function deployCode(string calldata artifactPath, bytes calldata constructorArgs, uint256 value, bytes32 salt) external returns (address deployedAddress);
 
     /// Gets the deployed bytecode from an artifact file. Takes in the relative path to the json file or the path to the
-    /// artifact in the form of <path>:<contract>:<version> where <contract> and <version> parts are optional.
+    /// artifact in the form of <path>:<contract>:<version> or <path>:<contract>:<profile> where <contract> and
+    /// <version>/<profile> parts are optional.
     #[cheatcode(group = Filesystem)]
     function getDeployedCode(string calldata artifactPath) external view returns (bytes memory runtimeBytecode);