use crate::{ artifacts::Source, error::{Result, SolcError}, utils, CompilerInput, CompilerOutput, }; use semver::{Version, VersionReq}; use serde::{de::DeserializeOwned, Deserialize, Serialize}; use std::{ fmt, io::BufRead, path::{Path, PathBuf}, process::{Command, Output, Stdio}, str::FromStr, }; pub mod many; pub mod output; pub use output::{contracts, info, sources}; pub mod project; /// The name of the `solc` binary on the system pub const SOLC: &str = "solc"; /// Support for configuring the EVM version /// pub const CONSTANTINOPLE_SOLC: Version = Version::new(0, 4, 21); /// Petersburg support /// pub const PETERSBURG_SOLC: Version = Version::new(0, 5, 5); /// Istanbul support /// pub const ISTANBUL_SOLC: Version = Version::new(0, 5, 14); /// Berlin support /// pub const BERLIN_SOLC: Version = Version::new(0, 8, 5); /// London support /// pub const LONDON_SOLC: Version = Version::new(0, 8, 7); // `--base-path` was introduced in 0.6.9 pub static SUPPORTS_BASE_PATH: once_cell::sync::Lazy = once_cell::sync::Lazy::new(|| VersionReq::parse(">=0.6.9").unwrap()); // `--include-path` was introduced in 0.8.8 pub static SUPPORTS_INCLUDE_PATH: once_cell::sync::Lazy = once_cell::sync::Lazy::new(|| VersionReq::parse(">=0.8.8").unwrap()); #[cfg(any(test, feature = "tests"))] use std::sync::Mutex; #[cfg(any(test, feature = "tests"))] #[allow(unused)] static LOCK: once_cell::sync::Lazy> = once_cell::sync::Lazy::new(|| Mutex::new(())); /// take the lock in tests, we use this to enforce that /// a test does not run while a compiler version is being installed /// /// This ensures that only one thread installs a missing `solc` exe. /// Instead of taking this lock in `Solc::blocking_install`, the lock should be taken before /// installation is detected. #[cfg(any(test, feature = "tests"))] #[allow(unused)] pub(crate) fn take_solc_installer_lock() -> std::sync::MutexGuard<'static, ()> { LOCK.lock().unwrap() } /// A list of upstream Solc releases, used to check which version /// we should download. /// The boolean value marks whether there was an error accessing the release list #[cfg(all(feature = "svm-solc", not(target_arch = "wasm32")))] pub static RELEASES: once_cell::sync::Lazy<(svm::Releases, Vec, bool)> = once_cell::sync::Lazy::new(|| { match serde_json::from_str::(svm_builds::RELEASE_LIST_JSON) { Ok(releases) => { let sorted_versions = releases.clone().into_versions(); (releases, sorted_versions, true) } Err(err) => { tracing::error!("{:?}", err); (svm::Releases::default(), Vec::new(), false) } } }); /// A `Solc` version is either installed (available locally) or can be downloaded, from the remote /// endpoint #[derive(Debug, Clone, Eq, PartialEq, Ord, PartialOrd, Hash, Serialize, Deserialize)] #[serde(untagged)] pub enum SolcVersion { Installed(Version), Remote(Version), } impl SolcVersion { /// Whether this version is installed pub fn is_installed(&self) -> bool { matches!(self, SolcVersion::Installed(_)) } } impl AsRef for SolcVersion { fn as_ref(&self) -> &Version { match self { SolcVersion::Installed(v) | SolcVersion::Remote(v) => v, } } } impl From for Version { fn from(s: SolcVersion) -> Version { match s { SolcVersion::Installed(v) | SolcVersion::Remote(v) => v, } } } impl fmt::Display for SolcVersion { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { write!(f, "{}", self.as_ref()) } } /// Abstraction over `solc` command line utility /// /// Supports sync and async functions. /// /// By default the solc path is configured as follows, with descending priority: /// 1. `SOLC_PATH` environment variable /// 2. [svm](https://github.com/roynalnaruto/svm-rs)'s `global_version` (set via `svm use `), stored at `/.global_version` /// 3. `solc` otherwise #[derive(Debug, Clone, Eq, PartialEq, PartialOrd, Ord, Serialize, Deserialize)] pub struct Solc { /// Path to the `solc` executable pub solc: PathBuf, /// The base path to set when invoking solc, see also pub base_path: Option, /// Additional arguments passed to the `solc` exectuable pub args: Vec, } impl Default for Solc { fn default() -> Self { if let Ok(solc) = std::env::var("SOLC_PATH") { return Solc::new(solc) } #[cfg(not(target_arch = "wasm32"))] { if let Some(solc) = Solc::svm_global_version() .and_then(|vers| Solc::find_svm_installed_version(vers.to_string()).ok()) .flatten() { return solc } } Solc::new(SOLC) } } impl fmt::Display for Solc { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { write!(f, "{}", self.solc.display())?; if !self.args.is_empty() { write!(f, " {}", self.args.join(" "))?; } Ok(()) } } impl Solc { /// A new instance which points to `solc` pub fn new(path: impl Into) -> Self { Solc { solc: path.into(), base_path: None, args: Vec::new() } } /// Sets solc's base path /// /// Ref: pub fn with_base_path(mut self, base_path: impl Into) -> Self { self.base_path = Some(base_path.into()); self } /// Adds an argument to pass to the `solc` command. #[must_use] pub fn arg>(mut self, arg: T) -> Self { self.args.push(arg.into()); self } /// Adds multiple arguments to pass to the `solc`. #[must_use] pub fn args(mut self, args: I) -> Self where I: IntoIterator, S: Into, { for arg in args { self = self.arg(arg); } self } /// Returns the directory in which [svm](https://github.com/roynalnaruto/svm-rs) stores all versions /// /// This will be `~/.svm` on unix #[cfg(not(target_arch = "wasm32"))] pub fn svm_home() -> Option { home::home_dir().map(|dir| dir.join(".svm")) } /// Returns the `semver::Version` [svm](https://github.com/roynalnaruto/svm-rs)'s `.global_version` is currently set to. /// `global_version` is configured with (`svm use `) /// /// This will read the version string (eg: "0.8.9") that the `~/.svm/.global_version` file /// contains #[cfg(not(target_arch = "wasm32"))] pub fn svm_global_version() -> Option { let version = std::fs::read_to_string(Self::svm_home().map(|p| p.join(".global_version"))?).ok()?; Version::parse(&version).ok() } /// Returns the list of all solc instances installed at `SVM_HOME` #[cfg(not(target_arch = "wasm32"))] pub fn installed_versions() -> Vec { if let Some(home) = Self::svm_home() { utils::installed_versions(home) .unwrap_or_default() .into_iter() .map(SolcVersion::Installed) .collect() } else { Vec::new() } } /// Returns the list of all versions that are available to download and marking those which are /// already installed. #[cfg(all(feature = "svm-solc", not(target_arch = "wasm32")))] pub fn all_versions() -> Vec { let mut all_versions = Self::installed_versions(); let mut uniques = all_versions .iter() .map(|v| { let v = v.as_ref(); (v.major, v.minor, v.patch) }) .collect::>(); all_versions.extend( RELEASES .1 .clone() .into_iter() .filter(|v| uniques.insert((v.major, v.minor, v.patch))) .map(SolcVersion::Remote), ); all_versions.sort_unstable(); all_versions } /// Returns the path for a [svm](https://github.com/roynalnaruto/svm-rs) installed version. /// /// # Example /// ```no_run /// # fn main() -> Result<(), Box> { /// use ethers_solc::Solc; /// let solc = Solc::find_svm_installed_version("0.8.9").unwrap(); /// assert_eq!(solc, Some(Solc::new("~/.svm/0.8.9/solc-0.8.9"))); /// # Ok(()) /// # } /// ``` #[cfg(not(target_arch = "wasm32"))] pub fn find_svm_installed_version(version: impl AsRef) -> Result> { let version = version.as_ref(); let solc = Self::svm_home() .ok_or_else(|| SolcError::solc("svm home dir not found"))? .join(version) .join(format!("solc-{version}")); if !solc.is_file() { return Ok(None) } Ok(Some(Solc::new(solc))) } /// Returns the path for a [svm](https://github.com/roynalnaruto/svm-rs) installed version. /// /// If the version is not installed yet, it will install it. /// /// # Example /// ```no_run /// # fn main() -> Result<(), Box> { /// use ethers_solc::Solc; /// let solc = Solc::find_or_install_svm_version("0.8.9").unwrap(); /// assert_eq!(solc, Solc::new("~/.svm/0.8.9/solc-0.8.9")); /// # Ok(()) /// # } /// ``` #[cfg(all(not(target_arch = "wasm32"), all(feature = "svm-solc")))] pub fn find_or_install_svm_version(version: impl AsRef) -> Result { let version = version.as_ref(); if let Some(solc) = Solc::find_svm_installed_version(version)? { Ok(solc) } else { Ok(Solc::blocking_install(&version.parse::()?)?) } } /// Assuming the `versions` array is sorted, it returns the first element which satisfies /// the provided [`VersionReq`] pub fn find_matching_installation( versions: &[Version], required_version: &VersionReq, ) -> Option { // iterate in reverse to find the last match versions.iter().rev().find(|version| required_version.matches(version)).cloned() } /// Given a Solidity source, it detects the latest compiler version which can be used /// to build it, and returns it. /// /// If the required compiler version is not installed, it also proceeds to install it. #[cfg(all(feature = "svm-solc", not(target_arch = "wasm32")))] pub fn detect_version(source: &Source) -> Result { // detects the required solc version let sol_version = Self::source_version_req(source)?; Self::ensure_installed(&sol_version) } /// Given a Solidity version requirement, it detects the latest compiler version which can be /// used to build it, and returns it. /// /// If the required compiler version is not installed, it also proceeds to install it. #[cfg(all(feature = "svm-solc", not(target_arch = "wasm32")))] pub fn ensure_installed(sol_version: &VersionReq) -> Result { #[cfg(any(test, feature = "tests"))] let _lock = take_solc_installer_lock(); // load the local / remote versions let versions = utils::installed_versions(svm::SVM_HOME.as_path()).unwrap_or_default(); let local_versions = Self::find_matching_installation(&versions, sol_version); let remote_versions = Self::find_matching_installation(&RELEASES.1, sol_version); // if there's a better upstream version than the one we have, install it Ok(match (local_versions, remote_versions) { (Some(local), None) => local, (Some(local), Some(remote)) => { if remote > local { Self::blocking_install(&remote)?; remote } else { local } } (None, Some(version)) => { Self::blocking_install(&version)?; version } // do nothing otherwise _ => return Err(SolcError::VersionNotFound), }) } /// Parses the given source looking for the `pragma` definition and /// returns the corresponding SemVer version requirement. pub fn source_version_req(source: &Source) -> Result { let version = utils::find_version_pragma(&source.content).ok_or(SolcError::PragmaNotFound)?; Self::version_req(version.as_str()) } /// Returns the corresponding SemVer version requirement for the solidity version pub fn version_req(version: &str) -> Result { let version = version.replace(' ', ","); // Somehow, Solidity semver without an operator is considered to be "exact", // but lack of operator automatically marks the operator as Caret, so we need // to manually patch it? :shrug: let exact = !matches!(&version[0..1], "*" | "^" | "=" | ">" | "<" | "~"); let mut version = VersionReq::parse(&version)?; if exact { version.comparators[0].op = semver::Op::Exact; } Ok(version) } /// Installs the provided version of Solc in the machine under the svm dir and returns the /// [Solc] instance pointing to the installation. /// /// # Example /// ```no_run /// # async fn run() -> Result<(), Box> { /// use ethers_solc::{Solc, ISTANBUL_SOLC}; /// let solc = Solc::install(&ISTANBUL_SOLC).await.unwrap(); /// # Ok(()) /// # } /// ``` #[cfg(all(feature = "svm-solc", not(target_arch = "wasm32")))] pub async fn install(version: &Version) -> std::result::Result { tracing::trace!("installing solc version \"{}\"", version); crate::report::solc_installation_start(version); let result = svm::install(version).await; crate::report::solc_installation_success(version); result.map(Solc::new) } /// Blocking version of `Self::install` #[cfg(all(feature = "svm-solc", not(target_arch = "wasm32")))] pub fn blocking_install(version: &Version) -> std::result::Result { use crate::utils::RuntimeOrHandle; tracing::trace!("blocking installing solc version \"{}\"", version); crate::report::solc_installation_start(version); // the async version `svm::install` is used instead of `svm::blocking_intsall` // because the underlying `reqwest::blocking::Client` does not behave well // in tokio rt. see https://github.com/seanmonstar/reqwest/issues/1017 cfg_if::cfg_if! { if #[cfg(target_arch = "wasm32")] { let installation = svm::blocking_install(version); } else { let installation = RuntimeOrHandle::new().block_on(svm::install(version)); } }; match installation { Ok(path) => { crate::report::solc_installation_success(version); Ok(Solc::new(path)) } Err(err) => { crate::report::solc_installation_error(version, &err.to_string()); Err(err) } } } /// Verify that the checksum for this version of solc is correct. We check against the SHA256 /// checksum from the build information published by [binaries.soliditylang.org](https://binaries.soliditylang.org/) #[cfg(all(feature = "svm-solc", not(target_arch = "wasm32")))] pub fn verify_checksum(&self) -> Result<()> { let version = self.version_short()?; let mut version_path = svm::version_path(version.to_string().as_str()); version_path.push(format!("solc-{}", version.to_string().as_str())); tracing::trace!(target:"solc", "reading solc binary for checksum {:?}", version_path); let content = std::fs::read(&version_path).map_err(|err| SolcError::io(err, version_path.clone()))?; if !RELEASES.2 { // we skip checksum verification because the underlying request to fetch release info // failed so we have nothing to compare against return Ok(()) } use sha2::Digest; let mut hasher = sha2::Sha256::new(); hasher.update(content); let checksum_calc = &hasher.finalize()[..]; let checksum_found = &RELEASES.0.get_checksum(&version).expect("checksum not found"); if checksum_calc == checksum_found { Ok(()) } else { let expected = hex::encode(checksum_found); let detected = hex::encode(checksum_calc); tracing:: warn!(target : "solc", "checksum mismatch for {:?}, expected {}, but found {} for file {:?}", version, expected, detected, version_path); Err(SolcError::ChecksumMismatch { version, expected, detected, file: version_path }) } } /// Convenience function for compiling all sources under the given path pub fn compile_source(&self, path: impl AsRef) -> Result { let path = path.as_ref(); let mut res: CompilerOutput = Default::default(); for input in CompilerInput::new(path)? { let output = self.compile(&input)?; res.merge(output) } Ok(res) } /// Same as [`Self::compile()`], but only returns those files which are included in the /// `CompilerInput`. /// /// In other words, this removes those files from the `CompilerOutput` that are __not__ included /// in the provided `CompilerInput`. /// /// # Example /// /// ```no_run /// # fn main() -> Result<(), Box> { /// use ethers_solc::{CompilerInput, Solc}; /// let solc = Solc::default(); /// let input = CompilerInput::new("./contracts")?[0].clone(); /// let output = solc.compile_exact(&input)?; /// # Ok(()) /// # } /// ``` pub fn compile_exact(&self, input: &CompilerInput) -> Result { let mut out = self.compile(input)?; out.retain_files(input.sources.keys().filter_map(|p| p.to_str())); Ok(out) } /// Run `solc --stand-json` and return the `solc`'s output as /// `CompilerOutput` /// /// # Example /// /// ```no_run /// # fn main() -> Result<(), Box> { /// use ethers_solc::{CompilerInput, Solc}; /// let solc = Solc::default(); /// let input = CompilerInput::new("./contracts")?; /// let output = solc.compile(&input)?; /// # Ok(()) /// # } /// ``` pub fn compile(&self, input: &T) -> Result { self.compile_as(input) } /// Run `solc --stand-json` and return the `solc`'s output as the given json /// output pub fn compile_as(&self, input: &T) -> Result { let output = self.compile_output(input)?; Ok(serde_json::from_slice(&output)?) } pub fn compile_output(&self, input: &T) -> Result> { let mut cmd = Command::new(&self.solc); if let Some(ref base_path) = self.base_path { cmd.current_dir(base_path); cmd.arg("--base-path").arg(base_path); } let mut child = cmd .args(&self.args) .arg("--standard-json") .stdin(Stdio::piped()) .stderr(Stdio::piped()) .stdout(Stdio::piped()) .spawn() .map_err(|err| SolcError::io(err, &self.solc))?; let stdin = child.stdin.take().expect("Stdin exists."); serde_json::to_writer(stdin, input)?; compile_output(child.wait_with_output().map_err(|err| SolcError::io(err, &self.solc))?) } pub fn version_short(&self) -> Result { let version = self.version()?; Ok(Version::new(version.major, version.minor, version.patch)) } /// Returns the version from the configured `solc` pub fn version(&self) -> Result { version_from_output( Command::new(&self.solc) .arg("--version") .stdin(Stdio::piped()) .stderr(Stdio::piped()) .stdout(Stdio::piped()) .output() .map_err(|err| SolcError::io(err, &self.solc))?, ) } } #[cfg(feature = "async")] impl Solc { /// Convenience function for compiling all sources under the given path pub async fn async_compile_source(&self, path: impl AsRef) -> Result { self.async_compile(&CompilerInput::with_sources(Source::async_read_all_from(path).await?)) .await } /// Run `solc --stand-json` and return the `solc`'s output as /// `CompilerOutput` pub async fn async_compile(&self, input: &T) -> Result { self.async_compile_as(input).await } /// Run `solc --stand-json` and return the `solc`'s output as the given json /// output pub async fn async_compile_as( &self, input: &T, ) -> Result { let output = self.async_compile_output(input).await?; Ok(serde_json::from_slice(&output)?) } pub async fn async_compile_output(&self, input: &T) -> Result> { use tokio::io::AsyncWriteExt; let content = serde_json::to_vec(input)?; let mut cmd = tokio::process::Command::new(&self.solc); if let Some(ref base_path) = self.base_path { cmd.current_dir(base_path); } let mut child = cmd .args(&self.args) .arg("--standard-json") .stdin(Stdio::piped()) .stderr(Stdio::piped()) .stdout(Stdio::piped()) .spawn() .map_err(|err| SolcError::io(err, &self.solc))?; let stdin = child.stdin.as_mut().unwrap(); stdin.write_all(&content).await.map_err(|err| SolcError::io(err, &self.solc))?; stdin.flush().await.map_err(|err| SolcError::io(err, &self.solc))?; compile_output( child.wait_with_output().await.map_err(|err| SolcError::io(err, &self.solc))?, ) } pub async fn async_version(&self) -> Result { version_from_output( tokio::process::Command::new(&self.solc) .arg("--version") .stdin(Stdio::piped()) .stderr(Stdio::piped()) .stdout(Stdio::piped()) .spawn() .map_err(|err| SolcError::io(err, &self.solc))? .wait_with_output() .await .map_err(|err| SolcError::io(err, &self.solc))?, ) } /// Compiles all `CompilerInput`s with their associated `Solc`. /// /// This will buffer up to `n` `solc` processes and then return the `CompilerOutput`s in the /// order in which they complete. No more than `n` futures will be buffered at any point in /// time, and less than `n` may also be buffered depending on the state of each future. /// /// # Example /// /// Compile 2 `CompilerInput`s at once /// /// ```no_run /// # async fn example() { /// use ethers_solc::{CompilerInput, Solc}; /// let solc1 = Solc::default(); /// let solc2 = Solc::default(); /// let input1 = CompilerInput::new("contracts").unwrap()[0].clone(); /// let input2 = CompilerInput::new("src").unwrap()[0].clone(); /// /// let outputs = Solc::compile_many([(solc1, input1), (solc2, input2)], 2).await.flattened().unwrap(); /// # } /// ``` pub async fn compile_many(jobs: I, n: usize) -> crate::many::CompiledMany where I: IntoIterator, { use futures_util::stream::StreamExt; let outputs = futures_util::stream::iter( jobs.into_iter() .map(|(solc, input)| async { (solc.async_compile(&input).await, solc, input) }), ) .buffer_unordered(n) .collect::>() .await; crate::many::CompiledMany::new(outputs) } } fn compile_output(output: Output) -> Result> { if output.status.success() { Ok(output.stdout) } else { Err(SolcError::solc(String::from_utf8_lossy(&output.stderr).to_string())) } } fn version_from_output(output: Output) -> Result { if output.status.success() { let version = output .stdout .lines() .filter_map(|l| l.ok()) .filter(|l| !l.trim().is_empty()) .last() .ok_or_else(|| SolcError::solc("version not found in solc output"))?; // NOTE: semver doesn't like `+` in g++ in build metadata which is invalid semver Ok(Version::from_str(&version.trim_start_matches("Version: ").replace(".g++", ".gcc"))?) } else { Err(SolcError::solc(String::from_utf8_lossy(&output.stderr).to_string())) } } impl AsRef for Solc { fn as_ref(&self) -> &Path { &self.solc } } impl> From for Solc { fn from(solc: T) -> Self { Solc::new(solc.into()) } } #[cfg(test)] mod tests { use super::*; use crate::{Artifact, CompilerInput}; fn solc() -> Solc { Solc::default() } #[test] fn solc_version_works() { solc().version().unwrap(); } #[test] fn can_parse_version_metadata() { let _version = Version::from_str("0.6.6+commit.6c089d02.Linux.gcc").unwrap(); } #[cfg(feature = "async")] #[tokio::test] async fn async_solc_version_works() { let _version = solc().async_version().await.unwrap(); } #[test] fn solc_compile_works() { let input = include_str!("../../test-data/in/compiler-in-1.json"); let input: CompilerInput = serde_json::from_str(input).unwrap(); let out = solc().compile(&input).unwrap(); let other = solc().compile(&serde_json::json!(input)).unwrap(); assert_eq!(out, other); } #[test] fn solc_metadata_works() { let input = include_str!("../../test-data/in/compiler-in-1.json"); let mut input: CompilerInput = serde_json::from_str(input).unwrap(); input.settings.push_output_selection("metadata"); let out = solc().compile(&input).unwrap(); for (_, c) in out.split().1.contracts_iter() { assert!(c.metadata.is_some()); } } #[test] fn can_compile_with_remapped_links() { let input: CompilerInput = serde_json::from_str(include_str!("../../test-data/library-remapping-in.json")) .unwrap(); let out = solc().compile(&input).unwrap(); let (_, mut contracts) = out.split(); let contract = contracts.remove("LinkTest").unwrap(); let bytecode = &contract.get_bytecode().unwrap().object; assert!(!bytecode.is_unlinked()); } #[test] fn can_compile_with_remapped_links_temp_dir() { let input: CompilerInput = serde_json::from_str(include_str!("../../test-data/library-remapping-in-2.json")) .unwrap(); let out = solc().compile(&input).unwrap(); let (_, mut contracts) = out.split(); let contract = contracts.remove("LinkTest").unwrap(); let bytecode = &contract.get_bytecode().unwrap().object; assert!(!bytecode.is_unlinked()); } #[cfg(feature = "async")] #[tokio::test] async fn async_solc_compile_works() { let input = include_str!("../../test-data/in/compiler-in-1.json"); let input: CompilerInput = serde_json::from_str(input).unwrap(); let out = solc().async_compile(&input).await.unwrap(); let other = solc().async_compile(&serde_json::json!(input)).await.unwrap(); assert_eq!(out, other); } #[cfg(feature = "async")] #[tokio::test] async fn async_solc_compile_works2() { let input = include_str!("../../test-data/in/compiler-in-2.json"); let input: CompilerInput = serde_json::from_str(input).unwrap(); let out = solc().async_compile(&input).await.unwrap(); let other = solc().async_compile(&serde_json::json!(input)).await.unwrap(); assert_eq!(out, other); let sync_out = solc().compile(&input).unwrap(); assert_eq!(out, sync_out); } #[test] fn test_version_req() { let versions = ["=0.1.2", "^0.5.6", ">=0.7.1", ">0.8.0"]; let sources = versions.iter().map(|version| source(version)); sources.zip(versions).for_each(|(source, version)| { let version_req = Solc::source_version_req(&source).unwrap(); assert_eq!(version_req, VersionReq::from_str(version).unwrap()); }); // Solidity defines version ranges with a space, whereas the semver package // requires them to be separated with a comma let version_range = ">=0.8.0 <0.9.0"; let source = source(version_range); let version_req = Solc::source_version_req(&source).unwrap(); assert_eq!(version_req, VersionReq::from_str(">=0.8.0,<0.9.0").unwrap()); } #[test] // This test might be a bit hard to maintain #[cfg(all(feature = "svm-solc", not(target_arch = "wasm32")))] fn test_detect_version() { for (pragma, expected) in [ // pinned ("=0.4.14", "0.4.14"), // pinned too ("0.4.14", "0.4.14"), // The latest patch is 0.4.26 ("^0.4.14", "0.4.26"), // latest version above 0.5.0 -> we have to // update this test whenever there's a new sol // version. that's ok! good reminder to check the // patch notes. (">=0.5.0", "0.8.19"), // range (">=0.4.0 <0.5.0", "0.4.26"), ] .iter() { let source = source(pragma); let res = Solc::detect_version(&source).unwrap(); assert_eq!(res, Version::from_str(expected).unwrap()); } } #[test] #[cfg(feature = "full")] fn test_find_installed_version_path() { // this test does not take the lock by default, so we need to manually // add it here. let _lock = LOCK.lock(); let ver = "0.8.6"; let version = Version::from_str(ver).unwrap(); if utils::installed_versions(svm::SVM_HOME.as_path()) .map(|versions| !versions.contains(&version)) .unwrap_or_default() { Solc::blocking_install(&version).unwrap(); } let res = Solc::find_svm_installed_version(version.to_string()).unwrap().unwrap(); let expected = svm::SVM_HOME.join(ver).join(format!("solc-{ver}")); assert_eq!(res.solc, expected); } #[test] #[cfg(all(feature = "svm-solc", not(target_arch = "wasm32")))] fn can_install_solc_in_tokio_rt() { let version = Version::from_str("0.8.6").unwrap(); let rt = tokio::runtime::Runtime::new().unwrap(); let result = rt.block_on(async { Solc::blocking_install(&version) }); assert!(result.is_ok()); } #[test] fn does_not_find_not_installed_version() { let ver = "1.1.1"; let version = Version::from_str(ver).unwrap(); let res = Solc::find_svm_installed_version(version.to_string()).unwrap(); assert!(res.is_none()); } #[test] fn test_find_latest_matching_installation() { let versions = ["0.4.24", "0.5.1", "0.5.2"] .iter() .map(|version| Version::from_str(version).unwrap()) .collect::>(); let required = VersionReq::from_str(">=0.4.24").unwrap(); let got = Solc::find_matching_installation(&versions, &required).unwrap(); assert_eq!(got, versions[2]); } #[test] fn test_no_matching_installation() { let versions = ["0.4.24", "0.5.1", "0.5.2"] .iter() .map(|version| Version::from_str(version).unwrap()) .collect::>(); let required = VersionReq::from_str(">=0.6.0").unwrap(); let got = Solc::find_matching_installation(&versions, &required); assert!(got.is_none()); } ///// helpers fn source(version: &str) -> Source { Source::new(format!("pragma solidity {version};\n")) } }