github.com/cheng762/platon-go@v1.8.17-0.20190529111256-7deff2d7be26/mobile/geth.go (about)

     1  // Copyright 2016 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  // Contains all the wrappers from the node package to support client side node
    18  // management on mobile platforms.
    19  
    20  package geth
    21  
    22  import (
    23  	"encoding/json"
    24  	"fmt"
    25  	"path/filepath"
    26  
    27  	"github.com/PlatONnetwork/PlatON-Go/core"
    28  	"github.com/PlatONnetwork/PlatON-Go/eth"
    29  	"github.com/PlatONnetwork/PlatON-Go/eth/downloader"
    30  	"github.com/PlatONnetwork/PlatON-Go/ethclient"
    31  	"github.com/PlatONnetwork/PlatON-Go/ethstats"
    32  	"github.com/PlatONnetwork/PlatON-Go/internal/debug"
    33  	"github.com/PlatONnetwork/PlatON-Go/les"
    34  	"github.com/PlatONnetwork/PlatON-Go/node"
    35  	"github.com/PlatONnetwork/PlatON-Go/p2p"
    36  	"github.com/PlatONnetwork/PlatON-Go/p2p/nat"
    37  	"github.com/PlatONnetwork/PlatON-Go/params"
    38  	whisper "github.com/PlatONnetwork/PlatON-Go/whisper/whisperv6"
    39  )
    40  
    41  // NodeConfig represents the collection of configuration values to fine tune the Geth
    42  // node embedded into a mobile process. The available values are a subset of the
    43  // entire API provided by go-ethereum to reduce the maintenance surface and dev
    44  // complexity.
    45  type NodeConfig struct {
    46  	// Bootstrap nodes used to establish connectivity with the rest of the network.
    47  	BootstrapNodes *Enodes
    48  
    49  	// MaxPeers is the maximum number of peers that can be connected. If this is
    50  	// set to zero, then only the configured static and trusted peers can connect.
    51  	MaxPeers int
    52  
    53  	// EthereumEnabled specifies whether the node should run the Ethereum protocol.
    54  	EthereumEnabled bool
    55  
    56  	// EthereumNetworkID is the network identifier used by the Ethereum protocol to
    57  	// decide if remote peers should be accepted or not.
    58  	EthereumNetworkID int64 // uint64 in truth, but Java can't handle that...
    59  
    60  	// EthereumGenesis is the genesis JSON to use to seed the blockchain with. An
    61  	// empty genesis state is equivalent to using the mainnet's state.
    62  	EthereumGenesis string
    63  
    64  	// EthereumDatabaseCache is the system memory in MB to allocate for database caching.
    65  	// A minimum of 16MB is always reserved.
    66  	EthereumDatabaseCache int
    67  
    68  	// EthereumNetStats is a netstats connection string to use to report various
    69  	// chain, transaction and node stats to a monitoring server.
    70  	//
    71  	// It has the form "nodename:secret@host:port"
    72  	EthereumNetStats string
    73  
    74  	// WhisperEnabled specifies whether the node should run the Whisper protocol.
    75  	WhisperEnabled bool
    76  
    77  	// Listening address of pprof server.
    78  	PprofAddress string
    79  }
    80  
    81  // defaultNodeConfig contains the default node configuration values to use if all
    82  // or some fields are missing from the user's specified list.
    83  var defaultNodeConfig = &NodeConfig{
    84  	BootstrapNodes:        FoundationBootnodes(),
    85  	MaxPeers:              25,
    86  	EthereumEnabled:       true,
    87  	EthereumNetworkID:     1,
    88  	EthereumDatabaseCache: 16,
    89  }
    90  
    91  // NewNodeConfig creates a new node option set, initialized to the default values.
    92  func NewNodeConfig() *NodeConfig {
    93  	config := *defaultNodeConfig
    94  	return &config
    95  }
    96  
    97  // Node represents a Geth Ethereum node instance.
    98  type Node struct {
    99  	node *node.Node
   100  }
   101  
   102  // NewNode creates and configures a new Geth node.
   103  func NewNode(datadir string, config *NodeConfig) (stack *Node, _ error) {
   104  	// If no or partial configurations were specified, use defaults
   105  	if config == nil {
   106  		config = NewNodeConfig()
   107  	}
   108  	if config.MaxPeers == 0 {
   109  		config.MaxPeers = defaultNodeConfig.MaxPeers
   110  	}
   111  	if config.BootstrapNodes == nil || config.BootstrapNodes.Size() == 0 {
   112  		config.BootstrapNodes = defaultNodeConfig.BootstrapNodes
   113  	}
   114  
   115  	if config.PprofAddress != "" {
   116  		debug.StartPProf(config.PprofAddress)
   117  	}
   118  
   119  	// Create the empty networking stack
   120  	nodeConf := &node.Config{
   121  		Name:        clientIdentifier,
   122  		Version:     params.VersionWithMeta,
   123  		DataDir:     datadir,
   124  		KeyStoreDir: filepath.Join(datadir, "keystore"), // Mobile should never use internal keystores!
   125  		P2P: p2p.Config{
   126  			NoDiscovery:      true,
   127  			DiscoveryV5:      true,
   128  			BootstrapNodesV5: config.BootstrapNodes.nodes,
   129  			ListenAddr:       ":0",
   130  			NAT:              nat.Any(),
   131  			MaxPeers:         config.MaxPeers,
   132  		},
   133  	}
   134  	rawStack, err := node.New(nodeConf)
   135  	if err != nil {
   136  		return nil, err
   137  	}
   138  
   139  	debug.Memsize.Add("node", rawStack)
   140  
   141  	var genesis *core.Genesis
   142  	if config.EthereumGenesis != "" {
   143  		// Parse the user supplied genesis spec if not mainnet
   144  		genesis = new(core.Genesis)
   145  		if err := json.Unmarshal([]byte(config.EthereumGenesis), genesis); err != nil {
   146  			return nil, fmt.Errorf("invalid genesis spec: %v", err)
   147  		}
   148  		// If we have the testnet, hard code the chain configs too
   149  		if config.EthereumGenesis == TestnetGenesis() {
   150  			genesis.Config = params.TestnetChainConfig
   151  			if config.EthereumNetworkID == 1 {
   152  				config.EthereumNetworkID = 3
   153  			}
   154  		}
   155  		if config.EthereumGenesis == BetanetGenesis() {
   156  			genesis.Config = params.BetanetChainConfig
   157  			if config.EthereumNetworkID == 1 {
   158  				config.EthereumNetworkID = 3
   159  			}
   160  		}
   161  		if config.EthereumGenesis == InnerTestnetGenesis() {
   162  			genesis.Config = params.InnerTestnetChainConfig
   163  			if config.EthereumNetworkID == 1 {
   164  				config.EthereumNetworkID = 3
   165  			}
   166  		}
   167  		if config.EthereumGenesis == InnerDevnetGenesis() {
   168  			genesis.Config = params.InnerDevnetChainConfig
   169  			if config.EthereumNetworkID == 1 {
   170  				config.EthereumNetworkID = 3
   171  			}
   172  		}
   173  	}
   174  	// Register the Ethereum protocol if requested
   175  	if config.EthereumEnabled {
   176  		ethConf := eth.DefaultConfig
   177  		ethConf.Genesis = genesis
   178  		ethConf.SyncMode = downloader.LightSync
   179  		ethConf.NetworkId = uint64(config.EthereumNetworkID)
   180  		ethConf.DatabaseCache = config.EthereumDatabaseCache
   181  		if err := rawStack.Register(func(ctx *node.ServiceContext) (node.Service, error) {
   182  			return les.New(ctx, &ethConf)
   183  		}); err != nil {
   184  			return nil, fmt.Errorf("ethereum init: %v", err)
   185  		}
   186  		// If netstats reporting is requested, do it
   187  		if config.EthereumNetStats != "" {
   188  			if err := rawStack.Register(func(ctx *node.ServiceContext) (node.Service, error) {
   189  				var lesServ *les.LightEthereum
   190  				ctx.Service(&lesServ)
   191  
   192  				return ethstats.New(config.EthereumNetStats, nil, lesServ)
   193  			}); err != nil {
   194  				return nil, fmt.Errorf("netstats init: %v", err)
   195  			}
   196  		}
   197  	}
   198  	// Register the Whisper protocol if requested
   199  	if config.WhisperEnabled {
   200  		if err := rawStack.Register(func(*node.ServiceContext) (node.Service, error) {
   201  			return whisper.New(&whisper.DefaultConfig), nil
   202  		}); err != nil {
   203  			return nil, fmt.Errorf("whisper init: %v", err)
   204  		}
   205  	}
   206  	return &Node{rawStack}, nil
   207  }
   208  
   209  // Start creates a live P2P node and starts running it.
   210  func (n *Node) Start() error {
   211  	return n.node.Start()
   212  }
   213  
   214  // Stop terminates a running node along with all it's services. If the node was
   215  // not started, an error is returned.
   216  func (n *Node) Stop() error {
   217  	return n.node.Stop()
   218  }
   219  
   220  // GetEthereumClient retrieves a client to access the Ethereum subsystem.
   221  func (n *Node) GetEthereumClient() (client *EthereumClient, _ error) {
   222  	rpc, err := n.node.Attach()
   223  	if err != nil {
   224  		return nil, err
   225  	}
   226  	return &EthereumClient{ethclient.NewClient(rpc)}, nil
   227  }
   228  
   229  // GetNodeInfo gathers and returns a collection of metadata known about the host.
   230  func (n *Node) GetNodeInfo() *NodeInfo {
   231  	return &NodeInfo{n.node.Server().NodeInfo()}
   232  }
   233  
   234  // GetPeersInfo returns an array of metadata objects describing connected peers.
   235  func (n *Node) GetPeersInfo() *PeerInfos {
   236  	return &PeerInfos{n.node.Server().PeersInfo()}
   237  }