github.com/mprishchepo/go-ethereum@v1.9.7-0.20191031044858-21506be82b68/cmd/devp2p/enrcmd.go (about) 1 // Copyright 2019 The go-ethereum Authors 2 // This file is part of go-ethereum. 3 // 4 // go-ethereum is free software: you can redistribute it and/or modify 5 // it under the terms of the GNU General Public License as published by 6 // the Free Software Foundation, either version 3 of the License, or 7 // (at your option) any later version. 8 // 9 // go-ethereum is distributed in the hope that it will be useful, 10 // but WITHOUT ANY WARRANTY; without even the implied warranty of 11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 12 // GNU General Public License for more details. 13 // 14 // You should have received a copy of the GNU General Public License 15 // along with go-ethereum. If not, see <http://www.gnu.org/licenses/>. 16 17 package main 18 19 import ( 20 "bytes" 21 "encoding/base64" 22 "encoding/hex" 23 "fmt" 24 "io/ioutil" 25 "net" 26 "os" 27 "strconv" 28 "strings" 29 30 "github.com/Fantom-foundation/go-ethereum/p2p/enode" 31 "github.com/Fantom-foundation/go-ethereum/p2p/enr" 32 "github.com/Fantom-foundation/go-ethereum/rlp" 33 "gopkg.in/urfave/cli.v1" 34 ) 35 36 var enrdumpCommand = cli.Command{ 37 Name: "enrdump", 38 Usage: "Pretty-prints node records", 39 Action: enrdump, 40 Flags: []cli.Flag{ 41 cli.StringFlag{Name: "file"}, 42 }, 43 } 44 45 func enrdump(ctx *cli.Context) error { 46 var source string 47 if file := ctx.String("file"); file != "" { 48 if ctx.NArg() != 0 { 49 return fmt.Errorf("can't dump record from command-line argument in -file mode") 50 } 51 var b []byte 52 var err error 53 if file == "-" { 54 b, err = ioutil.ReadAll(os.Stdin) 55 } else { 56 b, err = ioutil.ReadFile(file) 57 } 58 if err != nil { 59 return err 60 } 61 source = string(b) 62 } else if ctx.NArg() == 1 { 63 source = ctx.Args()[0] 64 } else { 65 return fmt.Errorf("need record as argument") 66 } 67 68 r, err := parseRecord(source) 69 if err != nil { 70 return fmt.Errorf("INVALID: %v", err) 71 } 72 fmt.Print(dumpRecord(r)) 73 return nil 74 } 75 76 // dumpRecord creates a human-readable description of the given node record. 77 func dumpRecord(r *enr.Record) string { 78 out := new(bytes.Buffer) 79 if n, err := enode.New(enode.ValidSchemes, r); err != nil { 80 fmt.Fprintf(out, "INVALID: %v\n", err) 81 } else { 82 fmt.Fprintf(out, "Node ID: %v\n", n.ID()) 83 } 84 kv := r.AppendElements(nil)[1:] 85 fmt.Fprintf(out, "Record has sequence number %d and %d key/value pairs.\n", r.Seq(), len(kv)/2) 86 fmt.Fprint(out, dumpRecordKV(kv, 2)) 87 return out.String() 88 } 89 90 func dumpRecordKV(kv []interface{}, indent int) string { 91 // Determine the longest key name for alignment. 92 var out string 93 var longestKey = 0 94 for i := 0; i < len(kv); i += 2 { 95 key := kv[i].(string) 96 if len(key) > longestKey { 97 longestKey = len(key) 98 } 99 } 100 // Print the keys, invoking formatters for known keys. 101 for i := 0; i < len(kv); i += 2 { 102 key := kv[i].(string) 103 val := kv[i+1].(rlp.RawValue) 104 pad := longestKey - len(key) 105 out += strings.Repeat(" ", indent) + strconv.Quote(key) + strings.Repeat(" ", pad+1) 106 formatter := attrFormatters[key] 107 if formatter == nil { 108 formatter = formatAttrRaw 109 } 110 fmtval, ok := formatter(val) 111 if ok { 112 out += fmtval + "\n" 113 } else { 114 out += hex.EncodeToString(val) + " (!)\n" 115 } 116 } 117 return out 118 } 119 120 // parseNode parses a node record and verifies its signature. 121 func parseNode(source string) (*enode.Node, error) { 122 if strings.HasPrefix(source, "enode://") { 123 return enode.ParseV4(source) 124 } 125 r, err := parseRecord(source) 126 if err != nil { 127 return nil, err 128 } 129 return enode.New(enode.ValidSchemes, r) 130 } 131 132 // parseRecord parses a node record from hex, base64, or raw binary input. 133 func parseRecord(source string) (*enr.Record, error) { 134 bin := []byte(source) 135 if d, ok := decodeRecordHex(bytes.TrimSpace(bin)); ok { 136 bin = d 137 } else if d, ok := decodeRecordBase64(bytes.TrimSpace(bin)); ok { 138 bin = d 139 } 140 var r enr.Record 141 err := rlp.DecodeBytes(bin, &r) 142 return &r, err 143 } 144 145 func decodeRecordHex(b []byte) ([]byte, bool) { 146 if bytes.HasPrefix(b, []byte("0x")) { 147 b = b[2:] 148 } 149 dec := make([]byte, hex.DecodedLen(len(b))) 150 _, err := hex.Decode(dec, b) 151 return dec, err == nil 152 } 153 154 func decodeRecordBase64(b []byte) ([]byte, bool) { 155 if bytes.HasPrefix(b, []byte("enr:")) { 156 b = b[4:] 157 } 158 dec := make([]byte, base64.RawURLEncoding.DecodedLen(len(b))) 159 n, err := base64.RawURLEncoding.Decode(dec, b) 160 return dec[:n], err == nil 161 } 162 163 // attrFormatters contains formatting functions for well-known ENR keys. 164 var attrFormatters = map[string]func(rlp.RawValue) (string, bool){ 165 "id": formatAttrString, 166 "ip": formatAttrIP, 167 "ip6": formatAttrIP, 168 "tcp": formatAttrUint, 169 "tcp6": formatAttrUint, 170 "udp": formatAttrUint, 171 "udp6": formatAttrUint, 172 } 173 174 func formatAttrRaw(v rlp.RawValue) (string, bool) { 175 s := hex.EncodeToString(v) 176 return s, true 177 } 178 179 func formatAttrString(v rlp.RawValue) (string, bool) { 180 content, _, err := rlp.SplitString(v) 181 return strconv.Quote(string(content)), err == nil 182 } 183 184 func formatAttrIP(v rlp.RawValue) (string, bool) { 185 content, _, err := rlp.SplitString(v) 186 if err != nil || len(content) != 4 && len(content) != 6 { 187 return "", false 188 } 189 return net.IP(content).String(), true 190 } 191 192 func formatAttrUint(v rlp.RawValue) (string, bool) { 193 var x uint64 194 if err := rlp.DecodeBytes(v, &x); err != nil { 195 return "", false 196 } 197 return strconv.FormatUint(x, 10), true 198 }