pub struct StylusEvmApi { /* private fields */ }Expand description
Concrete EvmApi bridging WASM host function calls to revm’s journaled state.
Uses a type-erased raw pointer to JournalAccess so that the DB generic
parameter is erased. This allows StylusEvmApi to be 'static without
requiring DB: 'static, which is needed for wasmer’s FunctionEnv.
§Safety
Wasmer executes WASM programs synchronously on the calling thread, so no
cross-thread sharing occurs despite the Send bound on EvmApi.
The raw pointer must remain valid for the lifetime of the Stylus execution.
Implementations§
Source§impl StylusEvmApi
impl StylusEvmApi
Sourcepub unsafe fn new<DB: Database>(
journal: *mut Journal<DB>,
address: Address,
caller: Address,
call_value: U256,
read_only: bool,
free_pages: u16,
page_gas: u16,
arbos_version: u64,
ctx_ptr: *mut (),
do_call: Option<DoCallFn>,
do_create: Option<DoCreateFn>,
) -> Self
pub unsafe fn new<DB: Database>( journal: *mut Journal<DB>, address: Address, caller: Address, call_value: U256, read_only: bool, free_pages: u16, page_gas: u16, arbos_version: u64, ctx_ptr: *mut (), do_call: Option<DoCallFn>, do_create: Option<DoCreateFn>, ) -> Self
Create a new StylusEvmApi from a raw pointer to a revm Journal.
§Safety
The journal pointer must remain valid for the lifetime of this struct.
The caller must ensure exclusive mutable access through this pointer.
If ctx_ptr is provided, it must also remain valid.
Sourcepub fn sstore_refund(&self) -> i64
pub fn sstore_refund(&self) -> i64
Return the accumulated SSTORE refund from flush operations.
Trait Implementations§
Source§impl Debug for StylusEvmApi
impl Debug for StylusEvmApi
Source§impl EvmApi for StylusEvmApi
impl EvmApi for StylusEvmApi
Source§fn get_bytes32(
&mut self,
key: B256,
evm_api_gas_to_use: Gas,
) -> Result<(B256, Gas)>
fn get_bytes32( &mut self, key: B256, evm_api_gas_to_use: Gas, ) -> Result<(B256, Gas)>
Read a storage slot. Returns the value and access cost.
Source§fn cache_bytes32(&mut self, key: B256, value: B256) -> Result<Gas>
fn cache_bytes32(&mut self, key: B256, value: B256) -> Result<Gas>
Cache a storage value for later flushing.
Source§fn flush_storage_cache(
&mut self,
clear: bool,
gas_left: Gas,
) -> Result<(Gas, UserOutcomeKind)>
fn flush_storage_cache( &mut self, clear: bool, gas_left: Gas, ) -> Result<(Gas, UserOutcomeKind)>
Flush the storage cache to EVM state.
Source§fn get_transient_bytes32(&mut self, key: B256) -> Result<B256>
fn get_transient_bytes32(&mut self, key: B256) -> Result<B256>
Read a transient storage slot.
Source§fn set_transient_bytes32(
&mut self,
key: B256,
value: B256,
) -> Result<UserOutcomeKind>
fn set_transient_bytes32( &mut self, key: B256, value: B256, ) -> Result<UserOutcomeKind>
Write a transient storage slot.
Source§fn contract_call(
&mut self,
contract: Address,
calldata: &[u8],
gas_left: Gas,
gas_req: Gas,
value: U256,
) -> Result<(u32, Gas, UserOutcomeKind)>
fn contract_call( &mut self, contract: Address, calldata: &[u8], gas_left: Gas, gas_req: Gas, value: U256, ) -> Result<(u32, Gas, UserOutcomeKind)>
Execute a CALL. Returns return data length, gas cost, and outcome.
Source§fn delegate_call(
&mut self,
contract: Address,
calldata: &[u8],
gas_left: Gas,
gas_req: Gas,
) -> Result<(u32, Gas, UserOutcomeKind)>
fn delegate_call( &mut self, contract: Address, calldata: &[u8], gas_left: Gas, gas_req: Gas, ) -> Result<(u32, Gas, UserOutcomeKind)>
Execute a DELEGATECALL.
Source§fn static_call(
&mut self,
contract: Address,
calldata: &[u8],
gas_left: Gas,
gas_req: Gas,
) -> Result<(u32, Gas, UserOutcomeKind)>
fn static_call( &mut self, contract: Address, calldata: &[u8], gas_left: Gas, gas_req: Gas, ) -> Result<(u32, Gas, UserOutcomeKind)>
Execute a STATICCALL.
Source§fn create1(
&mut self,
code: Vec<u8>,
endowment: U256,
gas: Gas,
) -> Result<(CreateResponse, u32, Gas)>
fn create1( &mut self, code: Vec<u8>, endowment: U256, gas: Gas, ) -> Result<(CreateResponse, u32, Gas)>
Deploy via CREATE.
Source§fn create2(
&mut self,
code: Vec<u8>,
endowment: U256,
salt: B256,
gas: Gas,
) -> Result<(CreateResponse, u32, Gas)>
fn create2( &mut self, code: Vec<u8>, endowment: U256, salt: B256, gas: Gas, ) -> Result<(CreateResponse, u32, Gas)>
Deploy via CREATE2.
Source§fn emit_log(&mut self, data: Vec<u8>, topics: u32) -> Result<()>
fn emit_log(&mut self, data: Vec<u8>, topics: u32) -> Result<()>
Emit a log with the given data and number of topics.
Source§fn account_balance(&mut self, address: Address) -> Result<(U256, Gas)>
fn account_balance(&mut self, address: Address) -> Result<(U256, Gas)>
Get an account’s balance. Returns balance and access cost.
Source§fn account_code(
&mut self,
_arbos_version: u64,
address: Address,
gas_left: Gas,
) -> Result<(Vec<u8>, Gas)>
fn account_code( &mut self, _arbos_version: u64, address: Address, gas_left: Gas, ) -> Result<(Vec<u8>, Gas)>
Get an account’s code. Returns code and access cost.
Source§fn account_codehash(&mut self, address: Address) -> Result<(B256, Gas)>
fn account_codehash(&mut self, address: Address) -> Result<(B256, Gas)>
Get an account’s code hash. Returns hash and access cost.
impl Send for StylusEvmApi
Auto Trait Implementations§
impl Freeze for StylusEvmApi
impl !RefUnwindSafe for StylusEvmApi
impl !Sync for StylusEvmApi
impl Unpin for StylusEvmApi
impl !UnwindSafe for StylusEvmApi
Blanket Implementations§
§impl<T> ArchivePointee for T
impl<T> ArchivePointee for T
§type ArchivedMetadata = ()
type ArchivedMetadata = ()
The archived version of the pointer metadata for this type.
§fn pointer_metadata(
_: &<T as ArchivePointee>::ArchivedMetadata,
) -> <T as Pointee>::Metadata
fn pointer_metadata( _: &<T as ArchivePointee>::ArchivedMetadata, ) -> <T as Pointee>::Metadata
Converts some archived metadata to the pointer metadata for itself.
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
§impl<T> Conv for T
impl<T> Conv for T
§impl<T> DebugColor for Twhere
T: Debug,
impl<T> DebugColor for Twhere
T: Debug,
fn debug_color(&self, color: &str) -> String
fn debug_blue(&self) -> String
fn debug_dim(&self) -> String
fn debug_clear(&self) -> String
fn debug_grey(&self) -> String
fn debug_mint(&self) -> String
fn debug_pink(&self) -> String
fn debug_red(&self) -> String
fn debug_white(&self) -> String
fn debug_yellow(&self) -> String
fn debug_orange(&self) -> String
§impl<F, W, T, D> Deserialize<With<T, W>, D> for F
impl<F, W, T, D> Deserialize<With<T, W>, D> for F
§fn deserialize(
&self,
deserializer: &mut D,
) -> Result<With<T, W>, <D as Fallible>::Error>
fn deserialize( &self, deserializer: &mut D, ) -> Result<With<T, W>, <D as Fallible>::Error>
Deserializes using the given deserializer
§impl<T> FmtForward for T
impl<T> FmtForward for T
§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
Causes
self to use its Binary implementation when Debug-formatted.§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
Causes
self to use its Display implementation when
Debug-formatted.§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
Causes
self to use its LowerExp implementation when
Debug-formatted.§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
Causes
self to use its LowerHex implementation when
Debug-formatted.§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
Causes
self to use its Octal implementation when Debug-formatted.§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
Causes
self to use its Pointer implementation when
Debug-formatted.§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
Causes
self to use its UpperExp implementation when
Debug-formatted.§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
Causes
self to use its UpperHex implementation when
Debug-formatted.§fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
Formats each item in a sequence. Read more
§impl<TxEnv, T> FromRecoveredTx<&T> for TxEnvwhere
TxEnv: FromRecoveredTx<T>,
impl<TxEnv, T> FromRecoveredTx<&T> for TxEnvwhere
TxEnv: FromRecoveredTx<T>,
§fn from_recovered_tx(tx: &&T, sender: Address) -> TxEnv
fn from_recovered_tx(tx: &&T, sender: Address) -> TxEnv
Builds a [
TxEnv] from a transaction and a sender address.§impl<TxEnv, T> FromTxWithEncoded<&T> for TxEnvwhere
TxEnv: FromTxWithEncoded<T>,
impl<TxEnv, T> FromTxWithEncoded<&T> for TxEnvwhere
TxEnv: FromTxWithEncoded<T>,
§fn from_encoded_tx(tx: &&T, sender: Address, encoded: Bytes) -> TxEnv
fn from_encoded_tx(tx: &&T, sender: Address, encoded: Bytes) -> TxEnv
Builds a [
TxEnv] from a transaction, its sender, and encoded transaction bytes.§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more§impl<T> LayoutRaw for T
impl<T> LayoutRaw for T
§fn layout_raw(_: <T as Pointee>::Metadata) -> Result<Layout, LayoutError>
fn layout_raw(_: <T as Pointee>::Metadata) -> Result<Layout, LayoutError>
Gets the layout of the type.
§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
Pipes by value. This is generally the method you want to use. Read more
§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
Borrows
self and passes that borrow into the pipe function. Read more§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
Mutably borrows
self and passes that borrow into the pipe function. Read more§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R,
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
Borrows
self, then passes self.as_ref() into the pipe function.§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
Mutably borrows
self, then passes self.as_mut() into the pipe
function.§fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
Borrows
self, then passes self.deref() into the pipe function.§impl<T> Pointable for T
impl<T> Pointable for T
§impl<T> Tap for T
impl<T> Tap for T
§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Immutable access to the
Borrow<B> of a value. Read more§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
Mutable access to the
BorrowMut<B> of a value. Read more§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
Immutable access to the
AsRef<R> view of a value. Read more§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
Mutable access to the
AsMut<R> view of a value. Read more§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Immutable access to the
Deref::Target of a value. Read more§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Mutable access to the
Deref::Target of a value. Read more§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
Calls
.tap() only in debug builds, and is erased in release builds.§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
Calls
.tap_mut() only in debug builds, and is erased in release
builds.§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
Calls
.tap_borrow() only in debug builds, and is erased in release
builds.§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
Calls
.tap_borrow_mut() only in debug builds, and is erased in release
builds.§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
Calls
.tap_ref() only in debug builds, and is erased in release
builds.§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
Calls
.tap_ref_mut() only in debug builds, and is erased in release
builds.§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
Calls
.tap_deref() only in debug builds, and is erased in release
builds.