Enum ethers_solc::artifacts::bytecode::BytecodeObject

pub enum BytecodeObject {
    Bytecode(Bytes),
    Unlinked(String),
}

Represents the bytecode of a contracts that might be not fully linked yet.

Variants

Bytecode(Bytes)

Fully linked bytecode object

Unlinked(String)

Bytecode as hex string that’s not fully linked yet and contains library placeholders

Implementations

impl BytecodeObject

pub fn into_bytes(self) -> Option<Bytes>

Returns the underlying Bytes if the object is a valid bytecode, and not empty

pub fn as_bytes(&self) -> Option<&Bytes>

Returns a reference to the underlying Bytes if the object is a valid bytecode, and not empty

pub fn bytes_len(&self) -> usize

Returns the number of bytes of the fully linked bytecode

Returns 0 if this object is unlinked.

pub fn as_str(&self) -> Option<&str>

Returns a reference to the underlying String if the object is unlinked

pub fn into_unlinked(self) -> Option<String>

Returns the unlinked String if the object is unlinked or empty

pub fn is_unlinked(&self) -> bool

Whether this object is still unlinked

pub fn is_bytecode(&self) -> bool

Whether this object a valid bytecode

pub fn is_non_empty_bytecode(&self) -> bool

Returns true if the object is a valid bytecode and not empty. Returns false the object is a valid but empty bytecode or unlinked.

pub fn resolve(&mut self) -> Option<&Bytes>

Tries to resolve the unlinked string object a valid bytecode object in place

Returns the string if it is a valid

pub fn link_fully_qualified(
    &mut self,
    name: impl AsRef<str>,
    addr: Address
) -> &mut Self

Link using the fully qualified name of a library The fully qualified library name is the path of its source file and the library name separated by : like file.sol:Math

This will replace all occurrences of the library placeholder with the given address.

See also: https://docs.soliditylang.org/en/develop/using-the-compiler.html#library-linking

pub fn link(
    &mut self,
    file: impl AsRef<str>,
    library: impl AsRef<str>,
    addr: Address
) -> &mut Self

Link using the file and library names as fully qualified name <file>:<library> See BytecodeObject::link_fully_qualified

pub fn link_all<I, S, T>(&mut self, libs: I) -> &mut Selfwhere
    I: IntoIterator<Item = (S, T, Address)>,
    S: AsRef<str>,
    T: AsRef<str>,

Links the bytecode object with all provided (file, lib, addr)

pub fn contains_fully_qualified_placeholder(&self, name: impl AsRef<str>) -> bool

Whether the bytecode contains a matching placeholder using the qualified name

pub fn contains_placeholder(
    &self,
    file: impl AsRef<str>,
    library: impl AsRef<str>
) -> bool

Whether the bytecode contains a matching placeholder

Trait Implementations

impl AsRef<[u8]> for BytecodeObject

fn as_ref(&self) -> &[u8]

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

impl Clone for BytecodeObject

fn clone(&self) -> BytecodeObject

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for BytecodeObject

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

Formats the value using the given formatter.

impl Default for BytecodeObject

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for BytecodeObject

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
    __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<BytecodeObject> for Bytecode

fn from(object: BytecodeObject) -> Bytecode

Converts to this type from the input type.

impl PartialEq<BytecodeObject> for BytecodeObject

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

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

const 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 Serialize for BytecodeObject

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 BytecodeObject

impl StructuralEq for BytecodeObject

impl StructuralPartialEq for BytecodeObject