Struct ethers::solc::Solc

pub struct Solc {
    pub solc: PathBuf,
    pub args: Vec<String, Global>,
}

Abstraction over solc command line utility

Supports sync and async functions.

Fields

solc: PathBuf

Path to the solc executable

args: Vec<String, Global>

Additional arguments passed to the solc exectuable

Implementations

impl Solc

pub fn new(path: impl Into<PathBuf>) -> Solc

A new instance which points to solc

pub fn arg<T>(self, arg: T) -> Solc where
    T: Into<String>, 

Adds an argument to pass to the solc command.

pub fn args<I, S>(self, args: I) -> Solc where
    I: IntoIterator<Item = S>,
    S: Into<String>, 

Adds multiple arguments to pass to the solc.

pub fn svm_home() -> Option<PathBuf>

Returns the directory in which svm stores all versions

This will be ~/.svm on unix

pub fn find_svm_installed_version(
    version: impl AsRef<str>
) -> Result<Option<Solc>, SolcError>

Returns the path for a svm installed version.

Example

 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")));

pub fn find_matching_installation(
    versions: &[Version],
    required_version: &VersionReq
) -> Option<Version>

Assuming the versions array is sorted, it returns the first element which satisfies the provided VersionReq

pub fn detect_version(source: &Source) -> Result<Version, SolcError>

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.

pub fn version_req(source: &Source) -> Result<VersionReq, SolcError>

Parses the given source looking for the pragma definition and returns the corresponding SemVer version requirement.

pub async fn install(version: &'_ Version) -> Result<(), SolcVmError>

Installs the provided version of Solc in the machine under the svm dir

Example

 use ethers_solc::{Solc, ISTANBUL_SOLC};
 Solc::install(&ISTANBUL_SOLC).await.unwrap();
 let solc = Solc::find_svm_installed_version(&ISTANBUL_SOLC.to_string());

pub fn blocking_install(version: &Version) -> Result<(), SolcVmError>

Blocking version of Self::install

pub fn verify_checksum(&self) -> Result<(), SolcError>

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

pub fn compile_source(
    &self,
    path: impl AsRef<Path>
) -> Result<CompilerOutput, SolcError>

Convenience function for compiling all sources under the given path

pub fn compile<T>(&self, input: &T) -> Result<CompilerOutput, SolcError> where
    T: Serialize, 

Run solc --stand-json and return the solc’s output as CompilerOutput

Example

 use ethers_solc::{CompilerInput, Solc};
let solc = Solc::default();
let input = CompilerInput::new("./contracts")?;
let output = solc.compile(&input)?;

pub fn compile_as<T, D>(&self, input: &T) -> Result<D, SolcError> where
    T: Serialize,
    D: DeserializeOwned, 

Run solc --stand-json and return the solc’s output as the given json output

pub fn compile_output<T>(&self, input: &T) -> Result<Vec<u8, Global>, SolcError> where
    T: Serialize, 

pub fn version_short(&self) -> Result<Version, SolcError>

pub fn version(&self) -> Result<Version, SolcError>

Returns the version from the configured solc

impl Solc

pub async fn async_compile_source<T>(
    &'_ self,
    path: impl AsRef<Path>
) -> Result<CompilerOutput, SolcError> where
    T: Serialize, 

Convenience function for compiling all sources under the given path

pub async fn async_compile<T>(
    &'_ self,
    input: &'_ T
) -> Result<CompilerOutput, SolcError> where
    T: Serialize, 

Run solc --stand-json and return the solc’s output as CompilerOutput

pub async fn async_compile_as<T, D>(
    &'_ self,
    input: &'_ T
) -> Result<D, SolcError> where
    T: Serialize,
    D: DeserializeOwned, 

Run solc --stand-json and return the solc’s output as the given json output

pub async fn async_compile_output<T>(
    &'_ self,
    input: &'_ T
) -> Result<Vec<u8, Global>, SolcError> where
    T: Serialize, 

pub async fn async_version(&'_ self) -> Result<Version, SolcError>

Trait Implementations

impl AsRef<Path> for Solc

pub fn as_ref(&self) -> &Path

Performs the conversion.

impl Clone for Solc

pub fn clone(&self) -> Solc

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Solc

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for Solc

pub fn default() -> Solc

Returns the “default value” for a type.

impl<T> From<T> for Solc where
    T: Into<PathBuf>, 

pub fn from(solc: T) -> Solc

Performs the conversion.

impl Ord for Solc

pub fn cmp(&self, other: &Solc) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl PartialEq<Solc> for Solc

pub fn eq(&self, other: &Solc) -> bool

This method tests for self and other values to be equal, and is used by ==.

pub fn ne(&self, other: &Solc) -> bool

This method tests for !=.

impl PartialOrd<Solc> for Solc

pub fn partial_cmp(&self, other: &Solc) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for Solc

impl StructuralEq for Solc

impl StructuralPartialEq for Solc