github.1485827954.workers.dev/ethereum/go-ethereum@v1.14.3/cmd/bootnode/main.go (about)

     1  // Copyright 2015 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  // bootnode runs a bootstrap node for the Ethereum Discovery Protocol.
    18  package main
    19  
    20  import (
    21  	"crypto/ecdsa"
    22  	"flag"
    23  	"fmt"
    24  	"net"
    25  	"os"
    26  	"time"
    27  
    28  	"github.com/ethereum/go-ethereum/cmd/utils"
    29  	"github.com/ethereum/go-ethereum/crypto"
    30  	"github.com/ethereum/go-ethereum/log"
    31  	"github.com/ethereum/go-ethereum/p2p/discover"
    32  	"github.com/ethereum/go-ethereum/p2p/enode"
    33  	"github.com/ethereum/go-ethereum/p2p/nat"
    34  	"github.com/ethereum/go-ethereum/p2p/netutil"
    35  )
    36  
    37  func main() {
    38  	var (
    39  		listenAddr  = flag.String("addr", ":30301", "listen address")
    40  		genKey      = flag.String("genkey", "", "generate a node key")
    41  		writeAddr   = flag.Bool("writeaddress", false, "write out the node's public key and quit")
    42  		nodeKeyFile = flag.String("nodekey", "", "private key filename")
    43  		nodeKeyHex  = flag.String("nodekeyhex", "", "private key as hex (for testing)")
    44  		natdesc     = flag.String("nat", "none", "port mapping mechanism (any|none|upnp|pmp|pmp:<IP>|extip:<IP>)")
    45  		netrestrict = flag.String("netrestrict", "", "restrict network communication to the given IP networks (CIDR masks)")
    46  		runv5       = flag.Bool("v5", false, "run a v5 topic discovery bootnode")
    47  		verbosity   = flag.Int("verbosity", 3, "log verbosity (0-5)")
    48  		vmodule     = flag.String("vmodule", "", "log verbosity pattern")
    49  
    50  		nodeKey *ecdsa.PrivateKey
    51  		err     error
    52  	)
    53  	flag.Parse()
    54  
    55  	glogger := log.NewGlogHandler(log.NewTerminalHandler(os.Stderr, false))
    56  	slogVerbosity := log.FromLegacyLevel(*verbosity)
    57  	glogger.Verbosity(slogVerbosity)
    58  	glogger.Vmodule(*vmodule)
    59  	log.SetDefault(log.NewLogger(glogger))
    60  
    61  	natm, err := nat.Parse(*natdesc)
    62  	if err != nil {
    63  		utils.Fatalf("-nat: %v", err)
    64  	}
    65  	switch {
    66  	case *genKey != "":
    67  		nodeKey, err = crypto.GenerateKey()
    68  		if err != nil {
    69  			utils.Fatalf("could not generate key: %v", err)
    70  		}
    71  		if err = crypto.SaveECDSA(*genKey, nodeKey); err != nil {
    72  			utils.Fatalf("%v", err)
    73  		}
    74  		if !*writeAddr {
    75  			return
    76  		}
    77  	case *nodeKeyFile == "" && *nodeKeyHex == "":
    78  		utils.Fatalf("Use -nodekey or -nodekeyhex to specify a private key")
    79  	case *nodeKeyFile != "" && *nodeKeyHex != "":
    80  		utils.Fatalf("Options -nodekey and -nodekeyhex are mutually exclusive")
    81  	case *nodeKeyFile != "":
    82  		if nodeKey, err = crypto.LoadECDSA(*nodeKeyFile); err != nil {
    83  			utils.Fatalf("-nodekey: %v", err)
    84  		}
    85  	case *nodeKeyHex != "":
    86  		if nodeKey, err = crypto.HexToECDSA(*nodeKeyHex); err != nil {
    87  			utils.Fatalf("-nodekeyhex: %v", err)
    88  		}
    89  	}
    90  
    91  	if *writeAddr {
    92  		fmt.Printf("%x\n", crypto.FromECDSAPub(&nodeKey.PublicKey)[1:])
    93  		os.Exit(0)
    94  	}
    95  
    96  	var restrictList *netutil.Netlist
    97  	if *netrestrict != "" {
    98  		restrictList, err = netutil.ParseNetlist(*netrestrict)
    99  		if err != nil {
   100  			utils.Fatalf("-netrestrict: %v", err)
   101  		}
   102  	}
   103  
   104  	addr, err := net.ResolveUDPAddr("udp", *listenAddr)
   105  	if err != nil {
   106  		utils.Fatalf("-ResolveUDPAddr: %v", err)
   107  	}
   108  	conn, err := net.ListenUDP("udp", addr)
   109  	if err != nil {
   110  		utils.Fatalf("-ListenUDP: %v", err)
   111  	}
   112  	defer conn.Close()
   113  
   114  	db, _ := enode.OpenDB("")
   115  	ln := enode.NewLocalNode(db, nodeKey)
   116  
   117  	listenerAddr := conn.LocalAddr().(*net.UDPAddr)
   118  	if natm != nil && !listenerAddr.IP.IsLoopback() {
   119  		natAddr := doPortMapping(natm, ln, listenerAddr)
   120  		if natAddr != nil {
   121  			listenerAddr = natAddr
   122  		}
   123  	}
   124  
   125  	printNotice(&nodeKey.PublicKey, *listenerAddr)
   126  	cfg := discover.Config{
   127  		PrivateKey:  nodeKey,
   128  		NetRestrict: restrictList,
   129  	}
   130  	if *runv5 {
   131  		if _, err := discover.ListenV5(conn, ln, cfg); err != nil {
   132  			utils.Fatalf("%v", err)
   133  		}
   134  	} else {
   135  		if _, err := discover.ListenUDP(conn, ln, cfg); err != nil {
   136  			utils.Fatalf("%v", err)
   137  		}
   138  	}
   139  
   140  	select {}
   141  }
   142  
   143  func printNotice(nodeKey *ecdsa.PublicKey, addr net.UDPAddr) {
   144  	if addr.IP.IsUnspecified() {
   145  		addr.IP = net.IP{127, 0, 0, 1}
   146  	}
   147  	n := enode.NewV4(nodeKey, addr.IP, 0, addr.Port)
   148  	fmt.Println(n.URLv4())
   149  	fmt.Println("Note: you're using cmd/bootnode, a developer tool.")
   150  	fmt.Println("We recommend using a regular node as bootstrap node for production deployments.")
   151  }
   152  
   153  func doPortMapping(natm nat.Interface, ln *enode.LocalNode, addr *net.UDPAddr) *net.UDPAddr {
   154  	const (
   155  		protocol = "udp"
   156  		name     = "ethereum discovery"
   157  	)
   158  	newLogger := func(external int, internal int) log.Logger {
   159  		return log.New("proto", protocol, "extport", external, "intport", internal, "interface", natm)
   160  	}
   161  
   162  	var (
   163  		intport    = addr.Port
   164  		extaddr    = &net.UDPAddr{IP: addr.IP, Port: addr.Port}
   165  		mapTimeout = nat.DefaultMapTimeout
   166  		log        = newLogger(addr.Port, intport)
   167  	)
   168  	addMapping := func() {
   169  		// Get the external address.
   170  		var err error
   171  		extaddr.IP, err = natm.ExternalIP()
   172  		if err != nil {
   173  			log.Debug("Couldn't get external IP", "err", err)
   174  			return
   175  		}
   176  		// Create the mapping.
   177  		p, err := natm.AddMapping(protocol, extaddr.Port, intport, name, mapTimeout)
   178  		if err != nil {
   179  			log.Debug("Couldn't add port mapping", "err", err)
   180  			return
   181  		}
   182  		if p != uint16(extaddr.Port) {
   183  			extaddr.Port = int(p)
   184  			log = newLogger(extaddr.Port, intport)
   185  			log.Info("NAT mapped alternative port")
   186  		} else {
   187  			log.Info("NAT mapped port")
   188  		}
   189  		// Update IP/port information of the local node.
   190  		ln.SetStaticIP(extaddr.IP)
   191  		ln.SetFallbackUDP(extaddr.Port)
   192  	}
   193  
   194  	// Perform mapping once, synchronously.
   195  	log.Info("Attempting port mapping")
   196  	addMapping()
   197  
   198  	// Refresh the mapping periodically.
   199  	go func() {
   200  		refresh := time.NewTimer(mapTimeout)
   201  		defer refresh.Stop()
   202  		for range refresh.C {
   203  			addMapping()
   204  			refresh.Reset(mapTimeout)
   205  		}
   206  	}()
   207  
   208  	return extaddr
   209  }