Skip to content
This repository was archived by the owner on Nov 17, 2025. It is now read-only.
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
members = [
"bindings/rust/evmc-sys",
"bindings/rust/evmc-vm",
"bindings/rust/evmc-client",
"bindings/rust/evmc-declare",
"bindings/rust/evmc-declare-tests",
"bindings/rust/evmc-loader",
Expand Down
3 changes: 3 additions & 0 deletions bindings/rust/evmc-client/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
/target
**/*.rs.bk
/Cargo.lock
19 changes: 19 additions & 0 deletions bindings/rust/evmc-client/Cargo.toml
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# EVMC: Ethereum Client-VM Connector API.
# Copyright 2019 The EVMC Authors.
# Licensed under the Apache License, Version 2.0.

[package]
name = "evmc-client"
version = "7.4.0"
authors = ["Zigang Lin <vincent@secondstate.io>"]
license = "Apache-2.0"
repository = "https://github.com/ethereum/evmc"
description = "Bindings to EVMC (Client/Host specific)"
edition = "2018"

[dependencies]
evmc-loader = { path = "../evmc-loader" }
evmc-sys = { path = "../evmc-sys" }
evmc-vm = { path = "../evmc-vm" }
enum_primitive = "0.1.1"
num = "0.3"
261 changes: 261 additions & 0 deletions bindings/rust/evmc-client/src/host.rs
Original file line number Diff line number Diff line change
@@ -0,0 +1,261 @@
/* EVMC: Ethereum Client-VM Connector API.
* Copyright 2019 The EVMC Authors.
* Licensed under the Apache License, Version 2.0.
*/

use crate::types::*;
use evmc_sys as ffi;
use std::mem;

#[repr(C)]
pub(crate) struct ExtendedContext<'a> {
pub hctx: &'a mut dyn HostContext,
}

pub trait HostContext {
fn account_exists(&mut self, addr: &Address) -> bool;
fn get_storage(&mut self, addr: &Address, key: &Bytes32) -> Bytes32;
fn set_storage(&mut self, addr: &Address, key: &Bytes32, value: &Bytes32) -> StorageStatus;
fn get_balance(&mut self, addr: &Address) -> Bytes32;
fn get_code_size(&mut self, addr: &Address) -> usize;
fn get_code_hash(&mut self, addr: &Address) -> Bytes32;
fn copy_code(
&mut self,
addr: &Address,
offset: &usize,
buffer_data: &*mut u8,
buffer_size: &usize,
) -> usize;
fn selfdestruct(&mut self, addr: &Address, beneficiary: &Address);
fn get_tx_context(
&mut self,
) -> (
Bytes32,
Address,
Address,
i64,
i64,
i64,
Bytes32,
Bytes32,
Bytes32,
);
fn get_block_hash(&mut self, number: i64) -> Bytes32;
fn emit_log(&mut self, addr: &Address, topics: &Vec<Bytes32>, data: &Bytes);
fn call(
&mut self,
kind: MessageKind,
recipient: &Address,
sender: &Address,
value: &Bytes32,
input: &Bytes,
gas: i64,
depth: i32,
is_static: bool,
salt: &Bytes32,
) -> (Vec<u8>, i64, Address, StatusCode);
}

pub(crate) fn get_evmc_host_interface() -> ffi::evmc_host_interface {
ffi::evmc_host_interface {
account_exists: Some(account_exists),
get_storage: Some(get_storage),
set_storage: Some(set_storage),
get_balance: Some(get_balance),
get_code_size: Some(get_code_size),
get_code_hash: Some(get_code_hash),
copy_code: Some(copy_code),
selfdestruct: Some(selfdestruct),
call: Some(call),
get_tx_context: Some(get_tx_context),
get_block_hash: Some(get_block_hash),
emit_log: Some(emit_log),
access_account: None, // TODO
access_storage: None, // TODO
}
}

unsafe extern "C" fn account_exists(
context: *mut ffi::evmc_host_context,
address: *const ffi::evmc_address,
) -> bool {
return (*(context as *mut ExtendedContext))
.hctx
.account_exists(&(*address).bytes);
}

unsafe extern "C" fn get_storage(
context: *mut ffi::evmc_host_context,
address: *const ffi::evmc_address,
key: *const ffi::evmc_bytes32,
) -> ffi::evmc_bytes32 {
return ffi::evmc_bytes32 {
bytes: (*(context as *mut ExtendedContext))
.hctx
.get_storage(&(*address).bytes, &(*key).bytes),
};
}

unsafe extern "C" fn set_storage(
context: *mut ffi::evmc_host_context,
address: *const ffi::evmc_address,
key: *const ffi::evmc_bytes32,
value: *const ffi::evmc_bytes32,
) -> ffi::evmc_storage_status {
return (*(context as *mut ExtendedContext)).hctx.set_storage(
&(*address).bytes,
&(*key).bytes,
&(*value).bytes,
);
}

unsafe extern "C" fn get_balance(
context: *mut ffi::evmc_host_context,
address: *const ffi::evmc_address,
) -> ffi::evmc_uint256be {
return ffi::evmc_uint256be {
bytes: (*(context as *mut ExtendedContext))
.hctx
.get_balance(&(*address).bytes),
};
}

unsafe extern "C" fn get_code_size(
context: *mut ffi::evmc_host_context,
address: *const ffi::evmc_address,
) -> usize {
return (*(context as *mut ExtendedContext))
.hctx
.get_code_size(&(*address).bytes);
}

unsafe extern "C" fn get_code_hash(
context: *mut ffi::evmc_host_context,
address: *const ffi::evmc_address,
) -> ffi::evmc_bytes32 {
return ffi::evmc_bytes32 {
bytes: (*(context as *mut ExtendedContext))
.hctx
.get_code_hash(&(*address).bytes),
};
}

unsafe extern "C" fn copy_code(
context: *mut ffi::evmc_host_context,
address: *const ffi::evmc_address,
code_offset: usize,
buffer_data: *mut u8,
buffer_size: usize,
) -> usize {
return (*(context as *mut ExtendedContext)).hctx.copy_code(
&(*address).bytes,
&code_offset,
&buffer_data,
&buffer_size,
);
}

unsafe extern "C" fn selfdestruct(
context: *mut ffi::evmc_host_context,
address: *const ffi::evmc_address,
beneficiary: *const ffi::evmc_address,
) {
(*(context as *mut ExtendedContext))
.hctx
.selfdestruct(&(*address).bytes, &(*beneficiary).bytes)
}

unsafe extern "C" fn get_tx_context(context: *mut ffi::evmc_host_context) -> ffi::evmc_tx_context {
let (
gas_price,
origin,
coinbase,
number,
timestamp,
gas_limit,
prev_randao,
chain_id,
base_fee,
) = (*(context as *mut ExtendedContext)).hctx.get_tx_context();
return ffi::evmc_tx_context {
tx_gas_price: evmc_sys::evmc_bytes32 { bytes: gas_price },
tx_origin: evmc_sys::evmc_address { bytes: origin },
block_coinbase: evmc_sys::evmc_address { bytes: coinbase },
block_number: number,
block_timestamp: timestamp,
block_gas_limit: gas_limit,
block_prev_randao: evmc_sys::evmc_bytes32 { bytes: prev_randao },
chain_id: evmc_sys::evmc_bytes32 { bytes: chain_id },
block_base_fee: evmc_sys::evmc_bytes32 { bytes: base_fee },
};
}

unsafe extern "C" fn get_block_hash(
context: *mut ffi::evmc_host_context,
number: i64,
) -> ffi::evmc_bytes32 {
return ffi::evmc_bytes32 {
bytes: (*(context as *mut ExtendedContext))
.hctx
.get_block_hash(number),
};
}

unsafe extern "C" fn emit_log(
context: *mut ffi::evmc_host_context,
address: *const ffi::evmc_address,
data: *const u8,
data_size: usize,
topics: *const ffi::evmc_bytes32,
topics_count: usize,
) {
let ts = &std::slice::from_raw_parts(topics, topics_count)
.iter()
.map(|topic| topic.bytes)
.collect::<Vec<_>>();
(*(context as *mut ExtendedContext)).hctx.emit_log(
&(*address).bytes,
&ts,
&std::slice::from_raw_parts(data, data_size),
);
}

unsafe extern "C" fn release(result: *const ffi::evmc_result) {
drop(std::slice::from_raw_parts(
(*result).output_data,
(*result).output_size,
));
}

pub unsafe extern "C" fn call(
context: *mut ffi::evmc_host_context,
msg: *const ffi::evmc_message,
) -> ffi::evmc_result {
let msg = *msg;
let (output, gas_left, create_address, status_code) =
(*(context as *mut ExtendedContext)).hctx.call(
msg.kind,
&msg.recipient.bytes,
&msg.sender.bytes,
&msg.value.bytes,
&std::slice::from_raw_parts(msg.input_data, msg.input_size),
msg.gas,
msg.depth,
msg.flags != 0,
&msg.create2_salt.bytes,
);
let ptr = output.as_ptr();
let len = output.len();
mem::forget(output);
return ffi::evmc_result {
status_code: status_code,
gas_left: gas_left,
output_data: ptr,
output_size: len,
release: Some(release),
create_address: ffi::evmc_address {
bytes: create_address,
},
padding: [0u8; 4],
};
}
Loading