Struct StandardJsonInput 

pub struct StandardJsonInput {
    pub language: Language,
    pub sources: BTreeMap<String, Source>,
    pub settings: Settings,
}

Represents the Solidity compiler’s Standard JSON StandardJsonInput object used by solc --standard-json.

This struct mirrors the compiler’s JSON schema:

• language selects the source language (for example Solidity or Yul).
• sources maps logical file names to Source entries (either literal content or a list of URLs). See Source for details on content vs urls.
• settings configures the compiler (optimizer, output selection, model checker, metadata, etc.).

The struct is serialized using camelCase fields to match the compiler’s expected keys. Use the builder-style helpers (StandardJsonInput::new, add_source, add_source_urls, model_checker) for common workflows. For advanced configuration modify input.settings directly.

Example:

use solc::StandardJsonInput;
let input = StandardJsonInput::new()
    .add_source("Counter.sol", "contract Counter { uint x; }");
let json = serde_json::to_string(&input).unwrap();

For a complete description of available settings and outputSelection values consult the Solidity documentation for the Standard JSON Input/Output interface.

Fields

language: Language

The source language for the provided sources map.

This is serialized to the compiler-expected string (for example "Solidity" or "Yul"). It defaults to Language::Solidity via StandardJsonInput::new() and controls how the compiler interprets the provided source files (regular Solidity source files, pre-parsed ASTs, or EVM assembly).

sources: BTreeMap<String, Source>

A mapping from logical filenames to Source entries.

The keys are the virtual/global names used by the compiler and by outputSelection (for example "src/Contract.sol"). Each value is a Source that either embeds literal content or specifies urls to fetch the source (optionally validated with a keccak256 hash). Use StandardJsonInput::add_source or StandardJsonInput::add_source_urls to populate this map in a safe, builder-style manner.

settings: Settings

Top-level compiler settings that control optimization, outputs, EVM target, metadata, libraries, model checking and debugging behavior.

Most fields are optional and will be omitted from serialized JSON if left as None. Set only the options you need such as enabling the optimizer, setting evmVersion, populating outputSelection, or providing library addresses in libraries to request linked artifacts.

Implementations

impl StandardJsonInput

pub fn new() -> Self

Create a new, empty StandardJsonInput with sensible defaults:

• language defaults to Language::Solidity.
• sources is empty.
• settings uses Settings::default().

The methods on StandardJsonInput return Self to enable builder-style chaining.

pub fn add_source( self, name: impl Into<String>, content: impl Into<String>, ) -> Self

Add a source by literal content.

name is the logical filename used by the compiler (for example "MyContract.sol"). If a source with the same name already exists it will be replaced. The resulting JSON contains { "content": "..." }.

pub fn add_source_urls( self, name: impl Into<String>, urls: Vec<String>, hash: Option<String>, ) -> Self

Add a source that should be fetched from one or more urls (for example IPFS or bzzr addresses). Optionally provide the keccak256 hash to validate downloaded content.

The serialized JSON will be { "urls": [...], "keccak256": "0x..." }.

pub fn model_checker(self, settings: ModelCheckerSettings) -> Self

Set the modelChecker section of settings (builder-style).

Trait Implementations

impl Clone for StandardJsonInput

fn clone(&self) -> StandardJsonInput

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StandardJsonInput

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

Formats the value using the given formatter.

impl Default for StandardJsonInput

fn default() -> StandardJsonInput

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for StandardJsonInput

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for StandardJsonInput

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

where __S: Serializer,

Serialize this value into the given Serde serializer.