github.com/yinchengtsinghua/golang-Eos-dpos-Ethereum@v0.0.0-20190121132951-92cc4225ed8e/accounts/abi/method.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  //版权所有2015 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 abi
    26  
    27  import (
    28  	"fmt"
    29  	"strings"
    30  
    31  	"github.com/ethereum/go-ethereum/crypto"
    32  )
    33  
    34  //方法表示给定“name”的可调用项,以及该方法是否为常量。
    35  //如果方法为“const”,则不需要为此创建任何事务
    36  //特定方法调用。它可以很容易地使用本地虚拟机进行模拟。
    37  //例如,“balance()”方法只需要检索
    38  //从存储器中,因此不需要发送到
    39  //网络。像“transact”这样的方法需要一个tx,因此
    40  //标记为“真”。
    41  //输入指定此给定方法所需的输入参数。
    42  type Method struct {
    43  	Name    string
    44  	Const   bool
    45  	Inputs  Arguments
    46  	Outputs Arguments
    47  }
    48  
    49  //SIG根据ABI规范返回方法字符串签名。
    50  //
    51  //例子
    52  //
    53  //函数foo(uint32 a,int b)=“foo(uint32,int256)”
    54  //
    55  //请注意,“int”代替其规范表示“int256”
    56  func (method Method) Sig() string {
    57  	types := make([]string, len(method.Inputs))
    58  	for i, input := range method.Inputs {
    59  		types[i] = input.Type.String()
    60  	}
    61  	return fmt.Sprintf("%v(%v)", method.Name, strings.Join(types, ","))
    62  }
    63  
    64  func (method Method) String() string {
    65  	inputs := make([]string, len(method.Inputs))
    66  	for i, input := range method.Inputs {
    67  		inputs[i] = fmt.Sprintf("%v %v", input.Name, input.Type)
    68  	}
    69  	outputs := make([]string, len(method.Outputs))
    70  	for i, output := range method.Outputs {
    71  		if len(output.Name) > 0 {
    72  			outputs[i] = fmt.Sprintf("%v ", output.Name)
    73  		}
    74  		outputs[i] += output.Type.String()
    75  	}
    76  	constant := ""
    77  	if method.Const {
    78  		constant = "constant "
    79  	}
    80  	return fmt.Sprintf("function %v(%v) %sreturns(%v)", method.Name, strings.Join(inputs, ", "), constant, strings.Join(outputs, ", "))
    81  }
    82  
    83  func (method Method) Id() []byte {
    84  	return crypto.Keccak256([]byte(method.Sig()))[:4]
    85  }