Enum foundry_compilers_artifacts::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 as_bytes(&self) -> Option<&Bytes>

Returns a reference to the underlying Bytes if the object is a valid bytecode.

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

Returns the underlying Bytes if the object is a valid bytecode.

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.

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 if the object is a valid but empty or unlinked bytecode.

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: &str, addr: Address, ) -> &mut BytecodeObject

Links 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: &str, library: &str, addr: Address, ) -> &mut BytecodeObject

Links using the file and library names as fully qualified name <file>:<library>.

See link_fully_qualified.

pub fn link_all<I, S, T>(&mut self, libs: I) -> &mut BytecodeObject

where 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: &str) -> bool

Returns whether the bytecode contains a matching placeholder using the qualified name.

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

Returns 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.

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

Performs copy-assignment from source.

impl Debug for BytecodeObject

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

Formats the value using the given formatter.

impl Default for BytecodeObject

fn default() -> BytecodeObject

Returns the “default value” for a type.

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

fn deserialize<__D>( __deserializer: __D, ) -> Result<BytecodeObject, <__D as Deserializer<'de>>::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 for BytecodeObject

fn eq(&self, other: &BytecodeObject) -> 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 Serialize for BytecodeObject

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for BytecodeObject

impl StructuralPartialEq for BytecodeObject