Documentation
use ethereum_types::{Address, H256, U256};

use crate::evm::err;
use crate::evm::interpreter;
use crate::evm::opcodes;

pub trait DataProvider {
    fn get_balance(&self, address: &Address) -> U256;

    fn add_refund(&mut self, address: &Address, n: u64);
    fn sub_refund(&mut self, address: &Address, n: u64);
    fn get_refund(&self, address: &Address) -> u64;

    fn get_code_size(&self, address: &Address) -> u64;
    fn get_code(&self, address: &Address) -> Vec<u8>;
    fn get_code_hash(&self, address: &Address) -> H256;

    fn get_block_hash(&self, number: &U256) -> H256;

    fn get_storage(&self, address: &Address, key: &H256) -> H256;
    fn set_storage(&mut self, address: &Address, key: H256, value: H256);
    fn get_storage_origin(&self, address: &Address, key: &H256) -> H256;
    fn set_storage_origin(&mut self, address: &Address, key: H256, value: H256);

    fn selfdestruct(&mut self, address: &Address, refund_address: &Address) -> bool;
    fn sha3(&self, input: &[u8]) -> H256;
    // is_empty returns whether the given account is empty. Empty
    // is defined according to EIP161 (balance = nonce = code = 0).
    fn is_empty(&self, address: &Address) -> bool;
    fn exist(&self, address: &Address) -> bool;

    // call is a low-level function for
    //   OpCode::CALL
    //   OpCode::CALLCODE
    //   OpCode::DELEGATECALL
    //   OpCode::STATICCALL
    //   OpCode::CREATE
    //   OpCode::CREATE2
    fn call(
        &self,
        opcode: opcodes::OpCode,
        params: interpreter::InterpreterParams,
    ) -> Result<interpreter::InterpreterResult, err::Error>;
}