Struct Solc

pub struct Solc {
    pub solc: PathBuf,
    pub version: Version,
    pub base_path: Option<PathBuf>,
    pub allow_paths: BTreeSet<PathBuf>,
    pub include_paths: BTreeSet<PathBuf>,
}

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’s global_version (set via svm use <version>), stored at <svm_home>/.global_version
3. solc otherwise

Fields

solc: PathBuf

Path to the solc executable

version: Version

Compiler version.

base_path: Option<PathBuf>

Value for –base-path arg.

allow_paths: BTreeSet<PathBuf>

Value for –allow-paths arg.

include_paths: BTreeSet<PathBuf>

Value for –include-paths arg.

Implementations

impl Solc

pub fn new(path: impl AsRef<Path>) -> Result<Self>

A new instance which points to solc. Invokes solc --version to determine the version.

Returns error if solc is not found in the system or if the version cannot be retrieved.

pub fn new_with_version(path: impl Into<PathBuf>, version: Version) -> Self

A new instance which points to solc with the given version

pub fn svm_home() -> Option<PathBuf>

Returns the directory in which svm stores all versions

This will be:

• ~/.svm on unix, if it exists
• $XDG_DATA_HOME (~/.local/share/svm) if the svm folder does not exist.

pub fn svm_global_version() -> Option<Version>

Returns the semver::Version svm’s .global_version is currently set to. global_version is configured with (svm use <version>)

This will read the version string (eg: “0.8.9”) that the ~/.svm/.global_version file contains

pub fn installed_versions() -> Vec<Version>

Returns the list of all solc instances installed at SVM_HOME

pub fn released_versions() -> Vec<Version>

Available on crate feature svm-solc only.

Returns the list of all versions that are available to download

pub async fn install(version: &Version) -> Result<Self, SvmError>

Available on crate feature svm-solc only.

Installs the provided version of Solc in the machine under the svm dir and returns the Solc instance pointing to the installation.

Examples

use foundry_compilers::{Solc, ISTANBUL_SOLC};

let solc = Solc::install(&ISTANBUL_SOLC).await?;

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

Available on crate feature svm-solc only.

Blocking version of Self::install

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

Available on crate feature svm-solc only.

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

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

Convenience function for compiling all sources under the given path

pub fn compile_exact(&self, input: &SolcInput) -> Result<CompilerOutput>

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.

Examples

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

Compiles with --standard-json and deserializes the output as CompilerOutput.

Examples

use foundry_compilers::{CompilerInput, Solc};

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

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

Compiles with --standard-json and deserializes the output as the given D.

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

Compiles with --standard-json and returns the raw stdout output.

pub fn version_short(&self) -> Version

Invokes solc --version and parses the output as a SemVer Version, stripping the pre-release and build metadata.

pub fn version(solc: impl Into<PathBuf>) -> Result<Version>

Invokes solc --version and parses the output as a SemVer Version.

pub fn configure_cmd(&self) -> Command

Configures Command object depeending on settings and solc version used. Some features are only supported by newer versions of solc, so we have to disable them for older ones.

impl Solc

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

Available on crate feature async only.

Convenience function for compiling all sources under the given path

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

Available on crate feature async only.

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

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

Available on crate feature async only.

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

pub async fn async_compile_output<T: Serialize>( &self, input: &T, ) -> Result<Vec<u8>>

Available on crate feature async only.

pub async fn async_version(solc: impl AsRef<Path>) -> Result<Version>

Available on crate feature async only.

pub async fn compile_many<I>(jobs: I, n: usize) -> CompiledMany

where I: IntoIterator<Item = (Solc, SolcInput)>,

Available on crate feature async only.

Compiles all CompilerInputs with their associated Solc.

This will buffer up to n solc processes and then return the CompilerOutputs 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.

Examples

Compile 2 CompilerInputs at once

use foundry_compilers::{CompilerInput, Solc};

let solc1 = Solc::default();
let solc2 = Solc::default();
let input1 = CompilerInput::new("contracts")?[0].clone();
let input2 = CompilerInput::new("src")?[0].clone();

let outputs = Solc::compile_many([(solc1, input1), (solc2, input2)], 2).await.flattened()?;

Trait Implementations

impl AsRef<Path> for Solc

fn as_ref(&self) -> &Path

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for Solc

fn clone(&self) -> Solc

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Compiler for Solc

const FILE_EXTENSIONS: &'static [&'static str] = SOLC_EXTENSIONS

Extensions of source files recognized by the compiler.

type Input = SolcInput

Input type for the compiler. Contains settings and sources to be compiled.

type CompilationError = Error

Error type returned by the compiler.

type ParsedSource = SolData

Source parser used for resolving imports and version requirements.

type Settings = Settings

Compiler settings.

fn compile( &self, input: Self::Input, ) -> Result<(Self::Input, CompilerOutput<Self::CompilationError>)>

Main entrypoint for the compiler. Compiles given input into CompilerOutput. Takes ownership over the input and returns back version with potential modifications made to it. Returned input is always the one which was seen by the binary.

fn version(&self) -> &Version

Returns the version of the compiler.

fn with_allowed_paths(self, allowed_paths: BTreeSet<PathBuf>) -> Self

Builder method to set the allowed paths for the compiler. Primarily used by solc implementation to set –allow-paths.

fn with_base_path(self, base_path: PathBuf) -> Self

Builder method to set the base path for the compiler. Primarily used by solc implementation to se –base-path.

fn with_include_paths(self, include_paths: BTreeSet<PathBuf>) -> Self

Builder method to set the include paths for the compiler. Primarily used by solc implementation to set –include-paths.

impl Debug for Solc

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Solc

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Ord for Solc

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

This method returns an Ordering between self and other.

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

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

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Solc

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Solc

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl Serialize for Solc

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Solc

impl StructuralPartialEq for Solc