github.com/halybang/go-ethereum@v1.0.5-0.20180325041310-3b262bc1367c/node/config.go (about) 1 // Copyright 2014 The go-ethereum Authors 2 // This file is part of the go-ethereum library. 3 // 4 // The go-ethereum library is free software: you can redistribute it and/or modify 5 // it under the terms of the GNU Lesser 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 // The go-ethereum library 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 Lesser General Public License for more details. 13 // 14 // You should have received a copy of the GNU Lesser General Public License 15 // along with the go-ethereum library. If not, see <http://www.gnu.org/licenses/>. 16 17 package node 18 19 import ( 20 "crypto/ecdsa" 21 "fmt" 22 "io/ioutil" 23 "os" 24 "path/filepath" 25 "runtime" 26 "strings" 27 28 "github.com/wanchain/go-wanchain/accounts" 29 "github.com/wanchain/go-wanchain/accounts/keystore" 30 "github.com/wanchain/go-wanchain/accounts/usbwallet" 31 "github.com/wanchain/go-wanchain/common" 32 "github.com/wanchain/go-wanchain/crypto" 33 "github.com/wanchain/go-wanchain/log" 34 "github.com/wanchain/go-wanchain/p2p" 35 "github.com/wanchain/go-wanchain/p2p/discover" 36 ) 37 38 const ( 39 datadirPrivateKey = "nodekey" // Path within the datadir to the node's private key 40 datadirDefaultKeyStore = "keystore" // Path within the datadir to the keystore 41 datadirStaticNodes = "static-nodes.json" // Path within the datadir to the static node list 42 datadirTrustedNodes = "trusted-nodes.json" // Path within the datadir to the trusted node list 43 datadirNodeDatabase = "nodes" // Path within the datadir to store the node infos 44 ) 45 46 // Config represents a small collection of configuration values to fine tune the 47 // P2P network layer of a protocol stack. These values can be further extended by 48 // all registered services. 49 type Config struct { 50 // Name sets the instance name of the node. It must not contain the / character and is 51 // used in the devp2p node identifier. The instance name of geth is "geth". If no 52 // value is specified, the basename of the current executable is used. 53 Name string `toml:"-"` 54 55 // UserIdent, if set, is used as an additional component in the devp2p node identifier. 56 UserIdent string `toml:",omitempty"` 57 58 // Version should be set to the version number of the program. It is used 59 // in the devp2p node identifier. 60 Version string `toml:"-"` 61 62 // DataDir is the file system folder the node should use for any data storage 63 // requirements. The configured data directory will not be directly shared with 64 // registered services, instead those can use utility methods to create/access 65 // databases or flat files. This enables ephemeral nodes which can fully reside 66 // in memory. 67 DataDir string 68 69 // Configuration of peer-to-peer networking. 70 P2P p2p.Config 71 72 // KeyStoreDir is the file system folder that contains private keys. The directory can 73 // be specified as a relative path, in which case it is resolved relative to the 74 // current directory. 75 // 76 // If KeyStoreDir is empty, the default location is the "keystore" subdirectory of 77 // DataDir. If DataDir is unspecified and KeyStoreDir is empty, an ephemeral directory 78 // is created by New and destroyed when the node is stopped. 79 KeyStoreDir string `toml:",omitempty"` 80 81 // UseLightweightKDF lowers the memory and CPU requirements of the key store 82 // scrypt KDF at the expense of security. 83 UseLightweightKDF bool `toml:",omitempty"` 84 85 // NoUSB disables hardware wallet monitoring and connectivity. 86 NoUSB bool `toml:",omitempty"` 87 88 // IPCPath is the requested location to place the IPC endpoint. If the path is 89 // a simple file name, it is placed inside the data directory (or on the root 90 // pipe path on Windows), whereas if it's a resolvable path name (absolute or 91 // relative), then that specific path is enforced. An empty path disables IPC. 92 IPCPath string `toml:",omitempty"` 93 94 // HTTPHost is the host interface on which to start the HTTP RPC server. If this 95 // field is empty, no HTTP API endpoint will be started. 96 HTTPHost string `toml:",omitempty"` 97 98 // HTTPPort is the TCP port number on which to start the HTTP RPC server. The 99 // default zero value is/ valid and will pick a port number randomly (useful 100 // for ephemeral nodes). 101 HTTPPort int `toml:",omitempty"` 102 103 // HTTPCors is the Cross-Origin Resource Sharing header to send to requesting 104 // clients. Please be aware that CORS is a browser enforced security, it's fully 105 // useless for custom HTTP clients. 106 HTTPCors []string `toml:",omitempty"` 107 108 // HTTPModules is a list of API modules to expose via the HTTP RPC interface. 109 // If the module list is empty, all RPC API endpoints designated public will be 110 // exposed. 111 HTTPModules []string `toml:",omitempty"` 112 113 // WSHost is the host interface on which to start the websocket RPC server. If 114 // this field is empty, no websocket API endpoint will be started. 115 WSHost string `toml:",omitempty"` 116 117 // WSPort is the TCP port number on which to start the websocket RPC server. The 118 // default zero value is/ valid and will pick a port number randomly (useful for 119 // ephemeral nodes). 120 WSPort int `toml:",omitempty"` 121 122 // WSOrigins is the list of domain to accept websocket requests from. Please be 123 // aware that the server can only act upon the HTTP request the client sends and 124 // cannot verify the validity of the request header. 125 WSOrigins []string `toml:",omitempty"` 126 127 // WSModules is a list of API modules to expose via the websocket RPC interface. 128 // If the module list is empty, all RPC API endpoints designated public will be 129 // exposed. 130 WSModules []string `toml:",omitempty"` 131 132 // WSExposeAll exposes all API modules via the WebSocket RPC interface rather 133 // than just the public ones. 134 // 135 // *WARNING* Only set this if the node is running in a trusted network, exposing 136 // private APIs to untrusted users is a major security risk. 137 WSExposeAll bool `toml:",omitempty"` 138 } 139 140 // IPCEndpoint resolves an IPC endpoint based on a configured value, taking into 141 // account the set data folders as well as the designated platform we're currently 142 // running on. 143 func (c *Config) IPCEndpoint() string { 144 // Short circuit if IPC has not been enabled 145 if c.IPCPath == "" { 146 return "" 147 } 148 // On windows we can only use plain top-level pipes 149 if runtime.GOOS == "windows" { 150 if strings.HasPrefix(c.IPCPath, `\\.\pipe\`) { 151 return c.IPCPath 152 } 153 return `\\.\pipe\` + c.IPCPath 154 } 155 // Resolve names into the data directory full paths otherwise 156 if filepath.Base(c.IPCPath) == c.IPCPath { 157 if c.DataDir == "" { 158 return filepath.Join(os.TempDir(), c.IPCPath) 159 } 160 return filepath.Join(c.DataDir, c.IPCPath) 161 } 162 return c.IPCPath 163 } 164 165 // NodeDB returns the path to the discovery node database. 166 func (c *Config) NodeDB() string { 167 if c.DataDir == "" { 168 return "" // ephemeral 169 } 170 return c.resolvePath(datadirNodeDatabase) 171 } 172 173 // DefaultIPCEndpoint returns the IPC path used by default. 174 func DefaultIPCEndpoint(clientIdentifier string) string { 175 if clientIdentifier == "" { 176 clientIdentifier = strings.TrimSuffix(filepath.Base(os.Args[0]), ".exe") 177 if clientIdentifier == "" { 178 panic("empty executable name") 179 } 180 } 181 config := &Config{DataDir: DefaultDataDir(), IPCPath: clientIdentifier + ".ipc"} 182 return config.IPCEndpoint() 183 } 184 185 // HTTPEndpoint resolves an HTTP endpoint based on the configured host interface 186 // and port parameters. 187 func (c *Config) HTTPEndpoint() string { 188 if c.HTTPHost == "" { 189 return "" 190 } 191 return fmt.Sprintf("%s:%d", c.HTTPHost, c.HTTPPort) 192 } 193 194 // DefaultHTTPEndpoint returns the HTTP endpoint used by default. 195 func DefaultHTTPEndpoint() string { 196 config := &Config{HTTPHost: DefaultHTTPHost, HTTPPort: DefaultHTTPPort} 197 return config.HTTPEndpoint() 198 } 199 200 // WSEndpoint resolves an websocket endpoint based on the configured host interface 201 // and port parameters. 202 func (c *Config) WSEndpoint() string { 203 if c.WSHost == "" { 204 return "" 205 } 206 return fmt.Sprintf("%s:%d", c.WSHost, c.WSPort) 207 } 208 209 // DefaultWSEndpoint returns the websocket endpoint used by default. 210 func DefaultWSEndpoint() string { 211 config := &Config{WSHost: DefaultWSHost, WSPort: DefaultWSPort} 212 return config.WSEndpoint() 213 } 214 215 // NodeName returns the devp2p node identifier. 216 func (c *Config) NodeName() string { 217 name := c.name() 218 219 if c.UserIdent != "" { 220 name += "/" + c.UserIdent 221 } 222 if c.Version != "" { 223 name += "/v" + c.Version 224 } 225 name += "/" + runtime.GOOS + "-" + runtime.GOARCH 226 name += "/" + runtime.Version() 227 return name 228 } 229 230 func (c *Config) name() string { 231 if c.Name == "" { 232 progname := strings.TrimSuffix(filepath.Base(os.Args[0]), ".exe") 233 if progname == "" { 234 panic("empty executable name, set Config.Name") 235 } 236 return progname 237 } 238 return c.Name 239 } 240 241 // These resources are resolved differently for "geth" instances. 242 var isOldGethResource = map[string]bool{ 243 "chaindata": true, 244 "nodes": true, 245 "nodekey": true, 246 "static-nodes.json": true, 247 "trusted-nodes.json": true, 248 } 249 250 // resolvePath resolves path in the instance directory. 251 func (c *Config) resolvePath(path string) string { 252 if filepath.IsAbs(path) { 253 return path 254 } 255 if c.DataDir == "" { 256 return "" 257 } 258 // Backwards-compatibility: ensure that data directory files created 259 // by geth 1.4 are used if they exist. 260 if c.name() == "gwan" && isOldGethResource[path] { 261 oldpath := "" 262 if c.Name == "gwan" { 263 oldpath = filepath.Join(c.DataDir, path) 264 } 265 266 if oldpath != "" && common.FileExist(oldpath) { 267 // TODO: print warning 268 return oldpath 269 } 270 } 271 272 return filepath.Join(c.instanceDir(), path) 273 } 274 275 func (c *Config) instanceDir() string { 276 if c.DataDir == "" { 277 return "" 278 } 279 return filepath.Join(c.DataDir, c.name()) 280 } 281 282 // NodeKey retrieves the currently configured private key of the node, checking 283 // first any manually set key, falling back to the one found in the configured 284 // data folder. If no key can be found, a new one is generated. 285 func (c *Config) NodeKey() *ecdsa.PrivateKey { 286 // Use any specifically configured key. 287 if c.P2P.PrivateKey != nil { 288 return c.P2P.PrivateKey 289 } 290 // Generate ephemeral key if no datadir is being used. 291 if c.DataDir == "" { 292 key, err := crypto.GenerateKey() 293 if err != nil { 294 log.Crit(fmt.Sprintf("Failed to generate ephemeral node key: %v", err)) 295 } 296 return key 297 } 298 299 keyfile := c.resolvePath(datadirPrivateKey) 300 if key, err := crypto.LoadECDSA(keyfile); err == nil { 301 return key 302 } 303 // No persistent key found, generate and store a new one. 304 key, err := crypto.GenerateKey() 305 if err != nil { 306 log.Crit(fmt.Sprintf("Failed to generate node key: %v", err)) 307 } 308 instanceDir := filepath.Join(c.DataDir, c.name()) 309 if err := os.MkdirAll(instanceDir, 0700); err != nil { 310 log.Error(fmt.Sprintf("Failed to persist node key: %v", err)) 311 return key 312 } 313 keyfile = filepath.Join(instanceDir, datadirPrivateKey) 314 if err := crypto.SaveECDSA(keyfile, key); err != nil { 315 log.Error(fmt.Sprintf("Failed to persist node key: %v", err)) 316 } 317 return key 318 } 319 320 // StaticNodes returns a list of node enode URLs configured as static nodes. 321 func (c *Config) StaticNodes() []*discover.Node { 322 return c.parsePersistentNodes(c.resolvePath(datadirStaticNodes)) 323 } 324 325 // TrustedNodes returns a list of node enode URLs configured as trusted nodes. 326 func (c *Config) TrustedNodes() []*discover.Node { 327 return c.parsePersistentNodes(c.resolvePath(datadirTrustedNodes)) 328 } 329 330 // parsePersistentNodes parses a list of discovery node URLs loaded from a .json 331 // file from within the data directory. 332 func (c *Config) parsePersistentNodes(path string) []*discover.Node { 333 // Short circuit if no node config is present 334 if c.DataDir == "" { 335 return nil 336 } 337 if _, err := os.Stat(path); err != nil { 338 return nil 339 } 340 // Load the nodes from the config file. 341 var nodelist []string 342 if err := common.LoadJSON(path, &nodelist); err != nil { 343 log.Error(fmt.Sprintf("Can't load node file %s: %v", path, err)) 344 return nil 345 } 346 // Interpret the list as a discovery node array 347 var nodes []*discover.Node 348 for _, url := range nodelist { 349 if url == "" { 350 continue 351 } 352 node, err := discover.ParseNode(url) 353 if err != nil { 354 log.Error(fmt.Sprintf("Node URL %s: %v\n", url, err)) 355 continue 356 } 357 nodes = append(nodes, node) 358 } 359 return nodes 360 } 361 362 func makeAccountManager(conf *Config) (*accounts.Manager, string, error) { 363 scryptN := keystore.StandardScryptN 364 scryptP := keystore.StandardScryptP 365 if conf.UseLightweightKDF { 366 scryptN = keystore.LightScryptN 367 scryptP = keystore.LightScryptP 368 } 369 370 var ( 371 keydir string 372 ephemeral string 373 err error 374 ) 375 switch { 376 case filepath.IsAbs(conf.KeyStoreDir): 377 keydir = conf.KeyStoreDir 378 case conf.DataDir != "": 379 if conf.KeyStoreDir == "" { 380 keydir = filepath.Join(conf.DataDir, datadirDefaultKeyStore) 381 } else { 382 keydir, err = filepath.Abs(conf.KeyStoreDir) 383 } 384 case conf.KeyStoreDir != "": 385 keydir, err = filepath.Abs(conf.KeyStoreDir) 386 default: 387 // There is no datadir. 388 keydir, err = ioutil.TempDir("", "go-ethereum-keystore") 389 ephemeral = keydir 390 } 391 if err != nil { 392 return nil, "", err 393 } 394 if err := os.MkdirAll(keydir, 0700); err != nil { 395 return nil, "", err 396 } 397 // Assemble the account manager and supported backends 398 backends := []accounts.Backend{ 399 keystore.NewKeyStore(keydir, scryptN, scryptP), 400 } 401 if !conf.NoUSB { 402 // Start a USB hub for Ledger hardware wallets 403 if ledgerhub, err := usbwallet.NewLedgerHub(); err != nil { 404 log.Warn(fmt.Sprintf("Failed to start Ledger hub, disabling: %v", err)) 405 } else { 406 backends = append(backends, ledgerhub) 407 } 408 // Start a USB hub for Trezor hardware wallets 409 if trezorhub, err := usbwallet.NewTrezorHub(); err != nil { 410 log.Warn(fmt.Sprintf("Failed to start Trezor hub, disabling: %v", err)) 411 } else { 412 backends = append(backends, trezorhub) 413 } 414 } 415 return accounts.NewManager(backends...), ephemeral, nil 416 }