github.com/yinchengtsinghua/golang-Eos-dpos-Ethereum@v0.0.0-20190121132951-92cc4225ed8e/core/vm/interface.go (about)

     1  
     2  //此源码被清华学神尹成大魔王专业翻译分析并修改
     3  //尹成QQ77025077
     4  //尹成微信18510341407
     5  //尹成所在QQ群721929980
     6  //尹成邮箱 yinc13@mails.tsinghua.edu.cn
     7  //尹成毕业于清华大学,微软区块链领域全球最有价值专家
     8  //https://mvp.microsoft.com/zh-cn/PublicProfile/4033620
     9  //版权所有2016 Go Ethereum作者
    10  //此文件是Go以太坊库的一部分。
    11  //
    12  //Go-Ethereum库是免费软件：您可以重新分发它和/或修改
    13  //根据GNU发布的较低通用公共许可证的条款
    14  //自由软件基金会，或者许可证的第3版，或者
    15  //（由您选择）任何更高版本。
    16  //
    17  //Go以太坊图书馆的发行目的是希望它会有用，
    18  //但没有任何保证；甚至没有
    19  //适销性或特定用途的适用性。见
    20  //GNU较低的通用公共许可证，了解更多详细信息。
    21  //
    22  //你应该收到一份GNU较低级别的公共许可证副本
    23  //以及Go以太坊图书馆。如果没有，请参见<http://www.gnu.org/licenses/>。
    24  
    25  package vm
    26  
    27  import (
    28  	"math/big"
    29  
    30  	"github.com/ethereum/go-ethereum/common"
    31  	"github.com/ethereum/go-ethereum/core/types"
    32  )
    33  
    34  //StateDB是用于完整状态查询的EVM数据库。
    35  type StateDB interface {
    36  	CreateAccount(common.Address)
    37  
    38  	SubBalance(common.Address, *big.Int)
    39  	AddBalance(common.Address, *big.Int)
    40  	GetBalance(common.Address) *big.Int
    41  
    42  	GetNonce(common.Address) uint64
    43  	SetNonce(common.Address, uint64)
    44  
    45  	GetCodeHash(common.Address) common.Hash
    46  	GetCode(common.Address) []byte
    47  	SetCode(common.Address, []byte)
    48  	GetCodeSize(common.Address) int
    49  
    50  	AddRefund(uint64)
    51  	GetRefund() uint64
    52  
    53  	GetState(common.Address, common.Hash) common.Hash
    54  	SetState(common.Address, common.Hash, common.Hash)
    55  
    56  	Suicide(common.Address) bool
    57  	HasSuicided(common.Address) bool
    58  
    59  //exist报告给定帐户是否处于状态。
    60  //值得注意的是，对于自杀账户来说，这也应该是正确的。
    61  	Exist(common.Address) bool
    62  //empty返回给定帐户是否为空。空的
    63  //根据EIP161定义（balance=nonce=code=0）。
    64  	Empty(common.Address) bool
    65  
    66  	RevertToSnapshot(int)
    67  	Snapshot() int
    68  
    69  	AddLog(*types.Log)
    70  	AddPreimage(common.Hash, []byte)
    71  
    72  	ForEachStorage(common.Address, func(common.Hash, common.Hash) bool)
    73  }
    74  
    75  //CallContext为EVM调用约定提供基本接口。EVM EVM
    76  //取决于为执行子调用和初始化新的EVM合同而实现的上下文。
    77  type CallContext interface {
    78  //调用另一个合同
    79  	Call(env *EVM, me ContractRef, addr common.Address, data []byte, gas, value *big.Int) ([]byte, error)
    80  //采用他人的合同代码并在我们自己的上下文中执行
    81  	CallCode(env *EVM, me ContractRef, addr common.Address, data []byte, gas, value *big.Int) ([]byte, error)
    82  //与callcode相同，但发送方和值从父作用域传播到子作用域
    83  	DelegateCall(env *EVM, me ContractRef, addr common.Address, data []byte, gas *big.Int) ([]byte, error)
    84  //创建新合同
    85  	Create(env *EVM, me ContractRef, data []byte, gas, value *big.Int) ([]byte, common.Address, error)
    86  }