evmc::HostContext Class Reference

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

#include <evmc.hpp>

Inherits 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. More...
bool	account_exists (const address &address) const noexcept final
	Check account existence callback function. More...
bytes32	get_storage (const address &address, const bytes32 &key) const noexcept final
	Get storage callback function. More...
evmc_storage_status	set_storage (const address &address, const bytes32 &key, const bytes32 &value) noexcept final
	Set storage callback function. More...
uint256be	get_balance (const address &address) const noexcept final
	Get balance callback function. More...
size_t	get_code_size (const address &address) const noexcept final
	Get code size callback function. More...
bytes32	get_code_hash (const address &address) const noexcept final
	Get code hash callback function. More...
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. More...
void	selfdestruct (const address &addr, const address &beneficiary) noexcept final
	Selfdestruct callback function. More...
result	call (const evmc_message &message) noexcept final
	Call callback function. More...
evmc_tx_context	get_tx_context () const noexcept final
	Get transaction context callback function. More...
bytes32	get_block_hash (int64_t number) const noexcept final
	Get block hash callback function. More...
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. More...

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 459 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

interface	The reference to the Host interface.
ctx	The pointer to the Host context object. This parameter MAY be null.

Definition at line 472 of file evmc.hpp.

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

Member Function Documentation

account_exists()

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

inlinefinalvirtualnoexcept

Check account existence callback function.

Implements evmc::HostInterface.

Definition at line 476 of file evmc.hpp.

    {
        return host->account_exists(context, &address);
    }

call()

result evmc::HostContext::call ( const evmc_message &  msg )

inlinefinalvirtualnoexcept

Call callback function.

Implements evmc::HostInterface.

Definition at line 521 of file evmc.hpp.

    {
        return result{host->call(context, &message)};
    }

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 508 of file evmc.hpp.

    {
        return host->copy_code(context, &address, code_offset, buffer_data, buffer_size);
    }

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 544 of file evmc.hpp.

    {
        host->emit_log(context, &addr, data, data_size, topics, topics_count);
    }

get_balance()

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

inlinefinalvirtualnoexcept

Get balance callback function.

Implements evmc::HostInterface.

Definition at line 493 of file evmc.hpp.

    {
        return host->get_balance(context, &address);
    }

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 539 of file evmc.hpp.

    {
        return host->get_block_hash(context, number);
    }

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 503 of file evmc.hpp.

    {
        return host->get_code_hash(context, &address);
    }

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 498 of file evmc.hpp.

    {
        return host->get_code_size(context, &address);
    }

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 481 of file evmc.hpp.

    {
        return host->get_storage(context, &address, &key);
    }

get_tx_context()

evmc_tx_context evmc::HostContext::get_tx_context ( ) const

inlinefinalvirtualnoexcept

Get transaction context callback function.

The implementation caches the received transaction context by assuming that the block timestamp should never be zero.

Returns

The cached transaction context.

Implements evmc::HostInterface.

Definition at line 532 of file evmc.hpp.

    {
        if (tx_context.block_timestamp == 0)
            tx_context = host->get_tx_context(context);
        return tx_context;
    }

selfdestruct()

void evmc::HostContext::selfdestruct ( const address &  addr, const address &  beneficiary  )

inlinefinalvirtualnoexcept

Selfdestruct callback function.

Implements evmc::HostInterface.

Definition at line 516 of file evmc.hpp.

    {
        host->selfdestruct(context, &addr, &beneficiary);
    }

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 486 of file evmc.hpp.

    {
        return host->set_storage(context, &address, &key, &value);
    }

---

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

• include/evmc/evmc.hpp