Initial commit.
This commit is contained in:
parent
6654576c6a
commit
4fbc4104cc
|
@ -0,0 +1,306 @@
|
|||
# Nimbus
|
||||
# Copyright (c) 2018 Status Research & Development GmbH
|
||||
# Licensed under either of
|
||||
# * Apache License, version 2.0, ([LICENSE-APACHE](LICENSE-APACHE))
|
||||
# * MIT license ([LICENSE-MIT](LICENSE-MIT))
|
||||
# at your option.
|
||||
# This file may not be copied, modified, or distributed except according to
|
||||
# those terms.
|
||||
|
||||
import parseopt, strutils
|
||||
|
||||
const
|
||||
NimbusName* = "Nimbus"
|
||||
## project name string
|
||||
|
||||
NimbusCopyright* = "Copyright (C) 2018 Status Research & Development GmbH"
|
||||
## copyright string
|
||||
|
||||
NimbusMajor*: int = 0
|
||||
## is the major number of Nimbus' version.
|
||||
|
||||
NimbusMinor*: int = 0
|
||||
## is the minor number of Nimbus' version.
|
||||
|
||||
NimbusPatch*: int = 1
|
||||
## is the patch number of Nimbus' version.
|
||||
|
||||
NimbusVersion* = $NimbusMajor & "." & $NimbusMinor & "." & $NimbusPatch
|
||||
## is the version of Nimbus as a string.
|
||||
|
||||
type
|
||||
ConfigStatus* = enum
|
||||
## Configuration status flags
|
||||
Success, ## Success
|
||||
EmptyOption, ## No options in category
|
||||
ErrorUnknownOption, ## Unknown option in command line found
|
||||
ErrorParseOption, ## Error in parsing command line option
|
||||
Error ## Unspecified error
|
||||
|
||||
RpcFlags* {.pure.} = enum
|
||||
## RPC flags
|
||||
Enabled ## RPC enabled
|
||||
|
||||
RpcConfiguration* = object
|
||||
## JSON-RPC configuration object
|
||||
flags*: set[RpcFlags] ## RPC flags
|
||||
bindAddress*: string ## RPC bind address string
|
||||
bindPort*: uint16 ## RPC bind port
|
||||
allowedIPs*: seq[string] ## Sequence of allowed IP addresses
|
||||
username*: string ## RPC authorization username
|
||||
password*: string ## RPC authorization password
|
||||
|
||||
NetworkFlags* = enum
|
||||
## Ethereum network flags
|
||||
LocalNet, ## Use local network only
|
||||
TestNet, ## Use test network only
|
||||
MainNet, ## Use main network only
|
||||
NoDiscover, ## Peer discovery disabled
|
||||
V5Discover, ## Dicovery V5 enabled
|
||||
|
||||
DebugFlags* {.pure.} = enum
|
||||
## Debug selection flags
|
||||
Enabled, ## Debugging enabled
|
||||
Test1, ## Test1 enabled
|
||||
Test2, ## Test2 enabled
|
||||
Test3 ## Test3 enabled
|
||||
|
||||
NetConfiguration* = object
|
||||
## Network configuration object
|
||||
flags*: set[NetworkFlags]
|
||||
bootNodes: seq[string]
|
||||
bootNodes4: seq[string]
|
||||
bootNodes5: seq[string]
|
||||
bindPort: uint16
|
||||
maxPeers: int
|
||||
maxPendingPeers: int
|
||||
nodeKey: string
|
||||
|
||||
DebugConfiguration* = object
|
||||
## Debug configuration object
|
||||
flags*: set[DebugFlags]
|
||||
|
||||
NimbusConfiguration* = ref object
|
||||
## Main Nimbus configuration object
|
||||
rpc*: RpcConfiguration ## JSON-RPC configuration
|
||||
net*: NetConfiguration ## Network configuration
|
||||
debug*: DebugConfiguration ## Debug configuration
|
||||
|
||||
var nimbusConfig {.threadvar.}: NimbusConfiguration
|
||||
|
||||
proc initConfiguration(): NimbusConfiguration =
|
||||
## Allocates and initializes `NimbusConfiguration` with default values
|
||||
result = new NimbusConfiguration
|
||||
|
||||
## RPC defaults
|
||||
result.rpc.flags = {}
|
||||
result.rpc.bindAddress = "127.0.0.1"
|
||||
result.rpc.bindPort = uint16(7654)
|
||||
result.rpc.username = ""
|
||||
result.rpc.password = ""
|
||||
result.rpc.allowedIPs = newSeq[string]()
|
||||
|
||||
## Network defaults
|
||||
result.net.flags = {TestNet}
|
||||
result.net.bootNodes = newSeq[string]()
|
||||
result.net.bootNodes4 = newSeq[string]()
|
||||
result.net.bootNodes5 = newSeq[string]()
|
||||
result.net.maxPeers = 25
|
||||
result.net.maxPendingPeers = 0
|
||||
result.net.bindPort = 30303'u16
|
||||
|
||||
## Debug defaults
|
||||
result.debug.flags = {}
|
||||
|
||||
proc getConfiguration*(): NimbusConfiguration =
|
||||
## Retreive current configuration object `NimbusConfiguration`.
|
||||
if isNil(nimbusConfig):
|
||||
nimbusConfig = initConfiguration()
|
||||
result = nimbusConfig
|
||||
|
||||
proc processList(v: string, o: var seq[string]) =
|
||||
if len(v) > 0:
|
||||
for n in v.split({' ', ','}):
|
||||
if len(n) > 0:
|
||||
o.add(n)
|
||||
|
||||
proc processInteger(v: string, o: var int): ConfigStatus =
|
||||
result = Success
|
||||
try:
|
||||
o = parseInt(v)
|
||||
except:
|
||||
result = ErrorParseOption
|
||||
|
||||
proc processRpcArguments(key, value: string): ConfigStatus =
|
||||
## Processes only `RPC` related command line options
|
||||
result = Success
|
||||
let config = getConfiguration()
|
||||
let skey = key.toLowerAscii()
|
||||
if skey == "rpc":
|
||||
config.rpc.flags.incl(Enabled)
|
||||
elif skey == "rpcbind":
|
||||
config.rpc.bindAddress = value
|
||||
elif skey == "rpcport":
|
||||
var res = 0
|
||||
result = processInteger(value, res)
|
||||
if result == Success:
|
||||
config.rpc.bindPort = uint16(res and 0xFFFF)
|
||||
elif skey == "rpcuser":
|
||||
config.rpc.username = value
|
||||
elif skey == "rpcpassword":
|
||||
config.rpc.password = value
|
||||
elif skey == "rpcallowip":
|
||||
processList(value, config.rpc.allowedIPs)
|
||||
else:
|
||||
result = EmptyOption
|
||||
|
||||
proc processNetArguments(key, value: string): ConfigStatus =
|
||||
## Processes only `Networking` related command line options
|
||||
result = Success
|
||||
let config = getConfiguration()
|
||||
let skey = key.toLowerAscii()
|
||||
if skey == "bootnodes":
|
||||
processList(value, config.net.bootNodes)
|
||||
elif skey == "bootnodesv4":
|
||||
processList(value, config.net.bootNodes4)
|
||||
elif skey == "bootnodesv5":
|
||||
processList(value, config.net.bootNodes5)
|
||||
elif skey == "testnet":
|
||||
config.net.flags.incl(TestNet)
|
||||
config.net.flags.excl(LocalNet)
|
||||
config.net.flags.excl(MainNet)
|
||||
elif skey == "localnet":
|
||||
config.net.flags.incl(LocalNet)
|
||||
config.net.flags.excl(TestNet)
|
||||
config.net.flags.excl(MainNet)
|
||||
elif skey == "mainnet":
|
||||
config.net.flags.incl(MainNet)
|
||||
config.net.flags.excl(LocalNet)
|
||||
config.net.flags.excl(TestNet)
|
||||
elif skey == "nodiscover":
|
||||
config.net.flags.incl(NoDiscover)
|
||||
elif skey == "v5discover":
|
||||
config.net.flags.incl(V5Discover)
|
||||
elif skey == "port":
|
||||
var res = 0
|
||||
result = processInteger(value, res)
|
||||
if result == Success:
|
||||
config.net.bindPort = uint16(res and 0xFFFF)
|
||||
elif skey == "maxpeers":
|
||||
var res = 0
|
||||
result = processInteger(value, res)
|
||||
if result == Success:
|
||||
config.net.maxPeers = res
|
||||
elif skey == "maxpendpeers":
|
||||
var res = 0
|
||||
result = processInteger(value, res)
|
||||
if result == Success:
|
||||
config.net.maxPendingPeers = res
|
||||
else:
|
||||
result = EmptyOption
|
||||
|
||||
proc processDebugArguments(key, value: string): ConfigStatus =
|
||||
## Processes only `Debug` related command line options
|
||||
let config = getConfiguration()
|
||||
result = Success
|
||||
let skey = key.toLowerAscii()
|
||||
if skey == "debug":
|
||||
config.debug.flags.incl(DebugFlags.Enabled)
|
||||
elif skey == "test":
|
||||
var res = newSeq[string]()
|
||||
processList(value, res)
|
||||
for item in res:
|
||||
if item == "test1":
|
||||
config.debug.flags.incl(DebugFlags.Test1)
|
||||
elif item == "test2":
|
||||
config.debug.flags.incl(DebugFlags.Test2)
|
||||
elif item == "test3":
|
||||
config.debug.flags.incl(DebugFlags.Test3)
|
||||
else:
|
||||
result = EmptyOption
|
||||
|
||||
proc dumpConfiguration*(): string =
|
||||
## Dumps current configuration as string
|
||||
let config = getConfiguration()
|
||||
result = repr config
|
||||
|
||||
template checkArgument(a, b, c, e: untyped) =
|
||||
var res = (a)(string((b)), string((c)))
|
||||
if res == Success:
|
||||
continue
|
||||
elif res == ErrorParseOption:
|
||||
(e) = "Error processing option [" & key & "] with value [" & value & "]"
|
||||
result = res
|
||||
break
|
||||
|
||||
proc getVersionString*(): string =
|
||||
result = NimbusName & ", " & NimbusVersion & "\n" & NimbusCopyright & "\n"
|
||||
|
||||
proc getHelpString*(): string =
|
||||
result = getVersionString()
|
||||
result &= """
|
||||
|
||||
USAGE:
|
||||
nimbus [options]
|
||||
|
||||
NETWORKING OPTIONS:
|
||||
--bootnodes:<value> Comma separated enode URLs for P2P discovery bootstrap (set v4+v5 instead for light servers)
|
||||
--bootnodesv4:<value> Comma separated enode URLs for P2P v4 discovery bootstrap (light server, full nodes)
|
||||
--botnoodesv5:<value> Comma separated enode URLs for P2P v5 discovery bootstrap (light server, light nodes)
|
||||
--port:<value> Network listening port (default: 30303)
|
||||
--maxpeers:<value> Maximum number of network peers (default: 25)
|
||||
--maxpendpeers:<value> Maximum number of pending connection attempts (default: 0)
|
||||
--nodiscover Disables the peer discovery mechanism (manual peer addition)
|
||||
--v5discover Enables the experimental RLPx V5 (Topic Discovery) mechanism
|
||||
--testnet Use Ethereum Test Network
|
||||
--mainnet Use Ethereum Main Network
|
||||
--localnet Use local network only
|
||||
|
||||
API AND CONSOLE OPTIONS:
|
||||
--rpc Enable the HTTP-RPC server
|
||||
--rpcbind:<value> HTTP-RPC server will bind to given address (default: 127.0.0.1)
|
||||
--rpcport:<value> HTTP-RPC server listening port (default: 7654)
|
||||
--rpcuser:<value> HTTP-RPC authorization username
|
||||
--rpcpassword:<value> HTTP-RPC authorization password
|
||||
--rpcallowip:<value> Allow HTTP-RPC connections from specified sources
|
||||
|
||||
LOGGING AND DEBUGGING OPTIONS:
|
||||
--debug Enable debug mode
|
||||
--test:<value> Perform specified test
|
||||
"""
|
||||
|
||||
proc processArguments*(msg: var string): ConfigStatus =
|
||||
## Process command line argument and update `NimbusConfiguration`.
|
||||
var opt = initOptParser()
|
||||
var length = 0
|
||||
for kind, key, value in opt.getopt():
|
||||
case kind
|
||||
of cmdArgument:
|
||||
discard
|
||||
of cmdLongOption, cmdShortOption:
|
||||
inc(length)
|
||||
case key.toLowerAscii()
|
||||
of "help", "h":
|
||||
msg = getHelpString()
|
||||
result = Success
|
||||
break
|
||||
of "version", "ver", "v":
|
||||
msg = getVersionString()
|
||||
result = Success
|
||||
break
|
||||
else:
|
||||
checkArgument processRpcArguments, key, value, msg
|
||||
checkArgument processNetArguments, key, value, msg
|
||||
checkArgument processDebugArguments, key, value, msg
|
||||
of cmdEnd:
|
||||
msg = "Error processing option [" & key & "]"
|
||||
result = ErrorParseOption
|
||||
break
|
||||
|
||||
if length == 0 and result == Success:
|
||||
msg = getHelpString()
|
||||
result = Success
|
||||
|
||||
proc processConfig*(pathname: string): ConfigStatus =
|
||||
## Process configuration file `pathname` and update `NimbusConfiguration`.
|
||||
result = Success
|
|
@ -0,0 +1,21 @@
|
|||
# Nimbus
|
||||
# Copyright (c) 2018 Status Research & Development GmbH
|
||||
# Licensed under either of
|
||||
# * Apache License, version 2.0, ([LICENSE-APACHE](LICENSE-APACHE))
|
||||
# * MIT license ([LICENSE-MIT](LICENSE-MIT))
|
||||
# at your option.
|
||||
# This file may not be copied, modified, or distributed except according to
|
||||
# those terms.
|
||||
|
||||
import config, asyncdispatch
|
||||
|
||||
when isMainModule:
|
||||
var message: string
|
||||
if processArguments(message) != Success:
|
||||
echo message
|
||||
quit(QuitFailure)
|
||||
else:
|
||||
if len(message) > 0:
|
||||
echo message
|
||||
|
||||
echo dumpConfiguration()
|
Loading…
Reference in New Issue