EVMC
evmc::HostContext Class Reference

Wrapper around EVMC host context / host interface. More...

#include <evmc.hpp>

Inheritance diagram for evmc::HostContext:
evmc::HostInterface

Public Member Functions

 HostContext ()=default
 Default constructor for null Host context.
 
 HostContext (const evmc_host_interface &interface, evmc_host_context *ctx) noexcept
 Constructor from the EVMC Host primitives.
 
bool account_exists (const address &address) const noexcept final
 Check account existence callback function.
 
bytes32 get_storage (const address &address, const bytes32 &key) const noexcept final
 Get storage callback function.
 
evmc_storage_status set_storage (const address &address, const bytes32 &key, const bytes32 &value) noexcept final
 Set storage callback function.
 
uint256be get_balance (const address &address) const noexcept final
 Get balance callback function.
 
size_t get_code_size (const address &address) const noexcept final
 Get code size callback function.
 
bytes32 get_code_hash (const address &address) const noexcept final
 Get code hash callback function.
 
size_t copy_code (const address &address, size_t code_offset, uint8_t *buffer_data, size_t buffer_size) const noexcept final
 Copy code callback function.
 
bool selfdestruct (const address &addr, const address &beneficiary) noexcept final
 Selfdestruct callback function.
 
Result call (const evmc_message &message) noexcept final
 Call callback function.
 
evmc_tx_context get_tx_context () const noexcept final
 Get transaction context callback function.
 
bytes32 get_block_hash (int64_t number) const noexcept final
 Get block hash callback function.
 
void emit_log (const address &addr, const uint8_t *data, size_t data_size, const bytes32 topics[], size_t topics_count) noexcept final
 Emit log callback function.
 
evmc_access_status access_account (const address &address) noexcept final
 Access account callback function.
 
evmc_access_status access_storage (const address &address, const bytes32 &key) noexcept final
 Access storage callback function.
 
bytes32 get_transient_storage (const address &address, const bytes32 &key) const noexcept final
 Get transient storage callback function.
 
void set_transient_storage (const address &address, const bytes32 &key, const bytes32 &value) noexcept final
 Set transient storage callback function.
 
virtual bool account_exists (const address &addr) const noexcept=0
 Check account existence callback function.
 
virtual bytes32 get_storage (const address &addr, const bytes32 &key) const noexcept=0
 Get storage callback function.
 
virtual evmc_storage_status set_storage (const address &addr, const bytes32 &key, const bytes32 &value) noexcept=0
 Set storage callback function.
 
virtual uint256be get_balance (const address &addr) const noexcept=0
 Get balance callback function.
 
virtual size_t get_code_size (const address &addr) const noexcept=0
 Get code size callback function.
 
virtual bytes32 get_code_hash (const address &addr) const noexcept=0
 Get code hash callback function.
 
virtual size_t copy_code (const address &addr, size_t code_offset, uint8_t *buffer_data, size_t buffer_size) const noexcept=0
 Copy code callback function.
 
virtual bool selfdestruct (const address &addr, const address &beneficiary) noexcept=0
 Selfdestruct callback function.
 
virtual Result call (const evmc_message &msg) noexcept=0
 Call callback function.
 
virtual evmc_tx_context get_tx_context () const noexcept=0
 Get transaction context callback function.
 
virtual bytes32 get_block_hash (int64_t block_number) const noexcept=0
 Get block hash callback function.
 
virtual void emit_log (const address &addr, const uint8_t *data, size_t data_size, const bytes32 topics[], size_t num_topics) noexcept=0
 Emit log callback function.
 
virtual evmc_access_status access_account (const address &addr) noexcept=0
 Access account callback function.
 
virtual evmc_access_status access_storage (const address &addr, const bytes32 &key) noexcept=0
 Access storage callback function.
 
virtual bytes32 get_transient_storage (const address &addr, const bytes32 &key) const noexcept=0
 Get transient storage callback function.
 
virtual void set_transient_storage (const address &addr, const bytes32 &key, const bytes32 &value) noexcept=0
 Set transient storage callback function.
 

Detailed Description

Wrapper around EVMC host context / host interface.

To be used by VM implementations as better alternative to using evmc_host_context directly.

Definition at line 508 of file evmc.hpp.

Constructor & Destructor Documentation

◆ HostContext()

evmc::HostContext::HostContext ( const evmc_host_interface interface,
evmc_host_context ctx 
)
inlinenoexcept

Constructor from the EVMC Host primitives.

Parameters
interfaceThe reference to the Host interface.
ctxThe pointer to the Host context object. This parameter MAY be null.

Definition at line 520 of file evmc.hpp.

521 : host{&interface}, context{ctx}
522 {}

Member Function Documentation

◆ access_account()

evmc_access_status evmc::HostContext::access_account ( const address addr)
inlinefinalvirtualnoexcept

Access account callback function.

Implements evmc::HostInterface.

Definition at line 591 of file evmc.hpp.

592 {
593 return host->access_account(context, &address);
594 }
evmc_access_account_fn access_account
Access account callback function.
Definition: evmc.h:883

◆ access_storage()

evmc_access_status evmc::HostContext::access_storage ( const address addr,
const bytes32 key 
)
inlinefinalvirtualnoexcept

Access storage callback function.

Implements evmc::HostInterface.

Definition at line 596 of file evmc.hpp.

597 {
598 return host->access_storage(context, &address, &key);
599 }
evmc_access_storage_fn access_storage
Access storage callback function.
Definition: evmc.h:886

◆ account_exists()

bool evmc::HostContext::account_exists ( const address addr) const
inlinefinalvirtualnoexcept

Check account existence callback function.

Implements evmc::HostInterface.

Definition at line 524 of file evmc.hpp.

525 {
526 return host->account_exists(context, &address);
527 }
evmc_account_exists_fn account_exists
Check account existence callback function.
Definition: evmc.h:847

◆ call()

Result evmc::HostContext::call ( const evmc_message msg)
inlinefinalvirtualnoexcept

Call callback function.

Implements evmc::HostInterface.

Definition at line 569 of file evmc.hpp.

570 {
571 return Result{host->call(context, &message)};
572 }
evmc_call_fn call
Call callback function.
Definition: evmc.h:871

◆ copy_code()

size_t evmc::HostContext::copy_code ( const address addr,
size_t  code_offset,
uint8_t *  buffer_data,
size_t  buffer_size 
) const
inlinefinalvirtualnoexcept

Copy code callback function.

Implements evmc::HostInterface.

Definition at line 556 of file evmc.hpp.

560 {
561 return host->copy_code(context, &address, code_offset, buffer_data, buffer_size);
562 }
evmc_copy_code_fn copy_code
Copy code callback function.
Definition: evmc.h:865

◆ emit_log()

void evmc::HostContext::emit_log ( const address addr,
const uint8_t *  data,
size_t  data_size,
const bytes32  topics[],
size_t  num_topics 
)
inlinefinalvirtualnoexcept

Emit log callback function.

Implements evmc::HostInterface.

Definition at line 582 of file evmc.hpp.

587 {
588 host->emit_log(context, &addr, data, data_size, topics, topics_count);
589 }
evmc_emit_log_fn emit_log
Emit log callback function.
Definition: evmc.h:880

◆ get_balance()

uint256be evmc::HostContext::get_balance ( const address addr) const
inlinefinalvirtualnoexcept

Get balance callback function.

Implements evmc::HostInterface.

Definition at line 541 of file evmc.hpp.

542 {
543 return host->get_balance(context, &address);
544 }
evmc_get_balance_fn get_balance
Get balance callback function.
Definition: evmc.h:856

◆ get_block_hash()

bytes32 evmc::HostContext::get_block_hash ( int64_t  block_number) const
inlinefinalvirtualnoexcept

Get block hash callback function.

Implements evmc::HostInterface.

Definition at line 577 of file evmc.hpp.

578 {
579 return host->get_block_hash(context, number);
580 }
evmc_get_block_hash_fn get_block_hash
Get block hash callback function.
Definition: evmc.h:877

◆ get_code_hash()

bytes32 evmc::HostContext::get_code_hash ( const address addr) const
inlinefinalvirtualnoexcept

Get code hash callback function.

Implements evmc::HostInterface.

Definition at line 551 of file evmc.hpp.

552 {
553 return host->get_code_hash(context, &address);
554 }
evmc_get_code_hash_fn get_code_hash
Get code hash callback function.
Definition: evmc.h:862

◆ get_code_size()

size_t evmc::HostContext::get_code_size ( const address addr) const
inlinefinalvirtualnoexcept

Get code size callback function.

Implements evmc::HostInterface.

Definition at line 546 of file evmc.hpp.

547 {
548 return host->get_code_size(context, &address);
549 }
evmc_get_code_size_fn get_code_size
Get code size callback function.
Definition: evmc.h:859

◆ get_storage()

bytes32 evmc::HostContext::get_storage ( const address addr,
const bytes32 key 
) const
inlinefinalvirtualnoexcept

Get storage callback function.

Implements evmc::HostInterface.

Definition at line 529 of file evmc.hpp.

530 {
531 return host->get_storage(context, &address, &key);
532 }
evmc_get_storage_fn get_storage
Get storage callback function.
Definition: evmc.h:850

◆ get_transient_storage()

bytes32 evmc::HostContext::get_transient_storage ( const address addr,
const bytes32 key 
) const
inlinefinalvirtualnoexcept

Get transient storage callback function.

Implements evmc::HostInterface.

Definition at line 601 of file evmc.hpp.

602 {
603 return host->get_transient_storage(context, &address, &key);
604 }
evmc_get_transient_storage_fn get_transient_storage
Get transient storage callback function.
Definition: evmc.h:889

◆ get_tx_context()

evmc_tx_context evmc::HostContext::get_tx_context ( ) const
inlinefinalvirtualnoexcept

Get transaction context callback function.

Implements evmc::HostInterface.

Definition at line 575 of file evmc.hpp.

575{ return host->get_tx_context(context); }
evmc_get_tx_context_fn get_tx_context
Get transaction context callback function.
Definition: evmc.h:874

◆ selfdestruct()

bool evmc::HostContext::selfdestruct ( const address addr,
const address beneficiary 
)
inlinefinalvirtualnoexcept

Selfdestruct callback function.

Implements evmc::HostInterface.

Definition at line 564 of file evmc.hpp.

565 {
566 return host->selfdestruct(context, &addr, &beneficiary);
567 }
evmc_selfdestruct_fn selfdestruct
Selfdestruct callback function.
Definition: evmc.h:868

◆ set_storage()

evmc_storage_status evmc::HostContext::set_storage ( const address addr,
const bytes32 key,
const bytes32 value 
)
inlinefinalvirtualnoexcept

Set storage callback function.

Implements evmc::HostInterface.

Definition at line 534 of file evmc.hpp.

537 {
538 return host->set_storage(context, &address, &key, &value);
539 }
evmc_set_storage_fn set_storage
Set storage callback function.
Definition: evmc.h:853

◆ set_transient_storage()

void evmc::HostContext::set_transient_storage ( const address addr,
const bytes32 key,
const bytes32 value 
)
inlinefinalvirtualnoexcept

Set transient storage callback function.

Implements evmc::HostInterface.

Definition at line 606 of file evmc.hpp.

609 {
610 host->set_transient_storage(context, &address, &key, &value);
611 }
evmc_set_transient_storage_fn set_transient_storage
Set transient storage callback function.
Definition: evmc.h:892

The documentation for this class was generated from the following file: