libevm

type AddressContext struct {
	Origin common.Address // equivalent to vm.ORIGIN op code
	// EVMSemantic addresses are those defined by the rules of the EVM, based on
	// the type of call made to a contract; i.e. the addresses pushed to the
	// stack by the vm.CALLER and vm.SELF op codes, respectively.
	EVMSemantic CallerAndSelf
	// Raw addresses are those that would be available to a contract under a
	// standard CALL; i.e. not interpreted according EVM rules. They are the
	// "intuitive" addresses such that the `Caller` is the account that called
	// `Self` even if it did so via DELEGATECALL or CALLCODE (in which cases
	// `Raw` and `EVMSemantic` would differ).
	//
	// Raw MUST NOT be nil when returned to a precompile implementation but MAY
	// be nil in other situations (e.g. hooks), which MUST document behaviour on
	// a case-by-case basis.
	Raw *CallerAndSelf
}

type CallerAndSelf struct {
	Caller common.Address
	Self   common.Address
}

type PrecompiledContract interface {
	RequiredGas(input []byte) uint64
	Run(input []byte) ([]byte, error)
}

type StateReader interface {
	GetBalance(common.Address) *uint256.Int
	GetNonce(common.Address) uint64

	GetCodeHash(common.Address) common.Hash
	GetCode(common.Address) []byte
	GetCodeSize(common.Address) int

	GetRefund() uint64

	GetCommittedState(common.Address, common.Hash, ...stateconf.StateDBStateOption) common.Hash
	GetState(common.Address, common.Hash, ...stateconf.StateDBStateOption) common.Hash

	GetTransientState(addr common.Address, key common.Hash) common.Hash

	HasSelfDestructed(common.Address) bool

	Exist(common.Address) bool
	Empty(common.Address) bool

	AddressInAccessList(addr common.Address) bool
	SlotInAccessList(addr common.Address, slot common.Hash) (addressOk bool, slotOk bool)
}