github.com/yinchengtsinghua/golang-Eos-dpos-Ethereum@v0.0.0-20190121132951-92cc4225ed8e/mobile/discover.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 //包含来自帐户包的所有包装,以支持客户端enode 26 //移动平台管理。 27 28 package geth 29 30 import ( 31 "errors" 32 33 "github.com/ethereum/go-ethereum/p2p/discv5" 34 ) 35 36 //enode表示网络上的主机。 37 type Enode struct { 38 node *discv5.Node 39 } 40 41 //newenode解析节点指示符。 42 // 43 //节点指示符有两种基本形式 44 //-节点不完整,只有公钥(节点ID) 45 //-包含公钥和IP/端口信息的完整节点 46 // 47 //对于不完整的节点,指示器必须类似于 48 // 49 //enode://<hex node id> 50 //<十六进制节点ID > 51 // 52 //对于完整的节点,节点ID编码在用户名部分 53 //以@符号与主机分隔的URL。主机名可以 54 //仅作为IP地址提供,不允许使用DNS域名。 55 //主机名部分中的端口是TCP侦听端口。如果 56 //TCP和UDP(发现)端口不同,UDP端口指定为 57 //查询参数“discport”。 58 // 59 //在下面的示例中,节点URL描述了 60 //IP地址为10.3.58.6、TCP侦听端口为30303的节点。 61 //和UDP发现端口30301。 62 // 63 //enode://<hex node id>@10.3.58.6:30303?磁盘端口=30301 64 func NewEnode(rawurl string) (enode *Enode, _ error) { 65 node, err := discv5.ParseNode(rawurl) 66 if err != nil { 67 return nil, err 68 } 69 return &Enode{node}, nil 70 } 71 72 //Enodes代表一部分账户。 73 type Enodes struct{ nodes []*discv5.Node } 74 75 //newenodes创建一个未初始化的enodes切片。 76 func NewEnodes(size int) *Enodes { 77 return &Enodes{ 78 nodes: make([]*discv5.Node, size), 79 } 80 } 81 82 //newEnodeEmpty创建一个enode值的空切片。 83 func NewEnodesEmpty() *Enodes { 84 return NewEnodes(0) 85 } 86 87 //SIZE返回切片中的enodes数。 88 func (e *Enodes) Size() int { 89 return len(e.nodes) 90 } 91 92 //get从切片返回给定索引处的enode。 93 func (e *Enodes) Get(index int) (enode *Enode, _ error) { 94 if index < 0 || index >= len(e.nodes) { 95 return nil, errors.New("index out of bounds") 96 } 97 return &Enode{e.nodes[index]}, nil 98 } 99 100 //set在切片中的给定索引处设置enode。 101 func (e *Enodes) Set(index int, enode *Enode) error { 102 if index < 0 || index >= len(e.nodes) { 103 return errors.New("index out of bounds") 104 } 105 e.nodes[index] = enode.node 106 return nil 107 } 108 109 //append在切片的末尾添加一个新的enode元素。 110 func (e *Enodes) Append(enode *Enode) { 111 e.nodes = append(e.nodes, enode.node) 112 }