Enum ethers_contract_abigen::Source

pub enum Source {
    String(String),
    Local(String),
    Http(Url),
    Etherscan(Address),
    Polygonscan(Address),
    Snowtrace(Address),
    Npm(String),
}

A source of a Truffle artifact JSON.

Variants

String(String)

A raw ABI string

Local(String)

An ABI located on the local file system.

Http(Url)

An ABI to be retrieved over HTTP(S).

Etherscan(Address)

An address of a mainnet contract that has been verified on Etherscan.io.

Polygonscan(Address)

An address of a mainnet contract that has been verified on Polygonscan.com.

Snowtrace(Address)

An address of a mainnet contract that has been verified on snowtrace.io.

Npm(String)

The package identifier of an npm package with a path to a Truffle artifact or ABI to be retrieved from unpkg.io.

Implementations

impl Source

pub fn parse<S>(source: S) -> Result<Self>where
    S: AsRef<str>,

Parses an ABI from a source

Contract ABIs can be retrieved from the local filesystem or online from etherscan.io. They can also be provided in-line. This method parses ABI source URLs and accepts the following:

• raw ABI JSON

• relative/path/to/Contract.json: a relative path to an ABI JSON file. This relative path is rooted in the current working directory. To specify the root for relative paths, use Source::with_root.

• /absolute/path/to/Contract.json or file:///absolute/path/to/Contract.json: an absolute path or file URL to an ABI JSON file.

• http(s)://... an HTTP url to a contract ABI.

• etherscan:0xXX..XX or https://etherscan.io/address/0xXX..XX: a address or URL of a verified contract on Etherscan.

• npm:@org/package@1.0.0/path/to/contract.json an npmjs package with an optional version and path (defaulting to the latest version and index.js). The contract ABI will be retrieved through unpkg.io.

pub fn local(path: impl Into<String>) -> Self

Creates a local filesystem source from a path string.

pub fn http<S>(url: S) -> Result<Self>where
    S: AsRef<str>,

Creates an HTTP source from a URL.

pub fn etherscan<S>(address: S) -> Result<Self>where
    S: AsRef<str>,

Creates an Etherscan source from an address string.

pub fn polygonscan<S>(address: S) -> Result<Self>where
    S: AsRef<str>,

Creates an Polygonscan source from an address string.

pub fn snowtrace<S>(address: S) -> Result<Self>where
    S: AsRef<str>,

Creates an Snowtrace source from an address string.

pub fn npm<S>(package_path: S) -> Selfwhere
    S: Into<String>,

Creates an Etherscan source from an address string.

pub fn get(&self) -> Result<String>

Retrieves the source JSON of the artifact this will either read the JSON from the file system or retrieve a contract ABI from the network depending on the source type.

Trait Implementations

impl Clone for Source

fn clone(&self) -> Source

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Source

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

Formats the value using the given formatter.

impl FromStr for Source

type Err = Report

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self>

Parses a string s to return a value of this type.

impl PartialEq<Source> for Source

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

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

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

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

impl Eq for Source

impl StructuralEq for Source

impl StructuralPartialEq for Source