mirror of
https://github.com/fluencelabs/tendermint
synced 2025-04-25 14:52:17 +00:00
61c5791fa3
except now we calculate the max size using the maxPacketMsgSize() function, which frees developers from having to know amino encoding details. plus, 10 additional bytes are added to leave the room for amino upgrades (both making it more efficient / less efficient)
338 lines
11 KiB
Go
338 lines
11 KiB
Go
package config
|
|
|
|
import (
|
|
"bytes"
|
|
"os"
|
|
"path/filepath"
|
|
"text/template"
|
|
|
|
cmn "github.com/tendermint/tmlibs/common"
|
|
)
|
|
|
|
var configTemplate *template.Template
|
|
|
|
func init() {
|
|
var err error
|
|
if configTemplate, err = template.New("configFileTemplate").Parse(defaultConfigTemplate); err != nil {
|
|
panic(err)
|
|
}
|
|
}
|
|
|
|
/****** these are for production settings ***********/
|
|
|
|
// EnsureRoot creates the root, config, and data directories if they don't exist,
|
|
// and panics if it fails.
|
|
func EnsureRoot(rootDir string) {
|
|
if err := cmn.EnsureDir(rootDir, 0700); err != nil {
|
|
cmn.PanicSanity(err.Error())
|
|
}
|
|
if err := cmn.EnsureDir(filepath.Join(rootDir, defaultConfigDir), 0700); err != nil {
|
|
cmn.PanicSanity(err.Error())
|
|
}
|
|
if err := cmn.EnsureDir(filepath.Join(rootDir, defaultDataDir), 0700); err != nil {
|
|
cmn.PanicSanity(err.Error())
|
|
}
|
|
|
|
configFilePath := filepath.Join(rootDir, defaultConfigFilePath)
|
|
|
|
// Write default config file if missing.
|
|
if !cmn.FileExists(configFilePath) {
|
|
writeDefaultConfigFile(configFilePath)
|
|
}
|
|
}
|
|
|
|
// XXX: this func should probably be called by cmd/tendermint/commands/init.go
|
|
// alongside the writing of the genesis.json and priv_validator.json
|
|
func writeDefaultConfigFile(configFilePath string) {
|
|
WriteConfigFile(configFilePath, DefaultConfig())
|
|
}
|
|
|
|
// WriteConfigFile renders config using the template and writes it to configFilePath.
|
|
func WriteConfigFile(configFilePath string, config *Config) {
|
|
var buffer bytes.Buffer
|
|
|
|
if err := configTemplate.Execute(&buffer, config); err != nil {
|
|
panic(err)
|
|
}
|
|
|
|
cmn.MustWriteFile(configFilePath, buffer.Bytes(), 0644)
|
|
}
|
|
|
|
// Note: any changes to the comments/variables/mapstructure
|
|
// must be reflected in the appropriate struct in config/config.go
|
|
const defaultConfigTemplate = `# This is a TOML config file.
|
|
# For more information, see https://github.com/toml-lang/toml
|
|
|
|
##### main base config options #####
|
|
|
|
# TCP or UNIX socket address of the ABCI application,
|
|
# or the name of an ABCI application compiled in with the Tendermint binary
|
|
proxy_app = "{{ .BaseConfig.ProxyApp }}"
|
|
|
|
# A custom human readable name for this node
|
|
moniker = "{{ .BaseConfig.Moniker }}"
|
|
|
|
# If this node is many blocks behind the tip of the chain, FastSync
|
|
# allows them to catchup quickly by downloading blocks in parallel
|
|
# and verifying their commits
|
|
fast_sync = {{ .BaseConfig.FastSync }}
|
|
|
|
# Database backend: leveldb | memdb
|
|
db_backend = "{{ .BaseConfig.DBBackend }}"
|
|
|
|
# Database directory
|
|
db_path = "{{ js .BaseConfig.DBPath }}"
|
|
|
|
# Output level for logging, including package level options
|
|
log_level = "{{ .BaseConfig.LogLevel }}"
|
|
|
|
##### additional base config options #####
|
|
|
|
# Path to the JSON file containing the initial validator set and other meta data
|
|
genesis_file = "{{ js .BaseConfig.Genesis }}"
|
|
|
|
# Path to the JSON file containing the private key to use as a validator in the consensus protocol
|
|
priv_validator_file = "{{ js .BaseConfig.PrivValidator }}"
|
|
|
|
# Path to the JSON file containing the private key to use for node authentication in the p2p protocol
|
|
node_key_file = "{{ js .BaseConfig.NodeKey}}"
|
|
|
|
# Mechanism to connect to the ABCI application: socket | grpc
|
|
abci = "{{ .BaseConfig.ABCI }}"
|
|
|
|
# TCP or UNIX socket address for the profiling server to listen on
|
|
prof_laddr = "{{ .BaseConfig.ProfListenAddress }}"
|
|
|
|
# If true, query the ABCI app on connecting to a new peer
|
|
# so the app can decide if we should keep the connection or not
|
|
filter_peers = {{ .BaseConfig.FilterPeers }}
|
|
|
|
##### advanced configuration options #####
|
|
|
|
##### rpc server configuration options #####
|
|
[rpc]
|
|
|
|
# TCP or UNIX socket address for the RPC server to listen on
|
|
laddr = "{{ .RPC.ListenAddress }}"
|
|
|
|
# TCP or UNIX socket address for the gRPC server to listen on
|
|
# NOTE: This server only supports /broadcast_tx_commit
|
|
grpc_laddr = "{{ .RPC.GRPCListenAddress }}"
|
|
|
|
# Maximum number of simultaneous connections.
|
|
# Does not include RPC (HTTP&WebSocket) connections. See max_open_connections
|
|
# If you want to accept more significant number than the default, make sure
|
|
# you increase your OS limits.
|
|
# 0 - unlimited.
|
|
grpc_max_open_connections = {{ .RPC.GRPCMaxOpenConnections }}
|
|
|
|
# Activate unsafe RPC commands like /dial_seeds and /unsafe_flush_mempool
|
|
unsafe = {{ .RPC.Unsafe }}
|
|
|
|
# Maximum number of simultaneous connections (including WebSocket).
|
|
# Does not include gRPC connections. See grpc_max_open_connections
|
|
# If you want to accept more significant number than the default, make sure
|
|
# you increase your OS limits.
|
|
# 0 - unlimited.
|
|
max_open_connections = {{ .RPC.MaxOpenConnections }}
|
|
|
|
##### peer to peer configuration options #####
|
|
[p2p]
|
|
|
|
# Address to listen for incoming connections
|
|
laddr = "{{ .P2P.ListenAddress }}"
|
|
|
|
# Comma separated list of seed nodes to connect to
|
|
seeds = "{{ .P2P.Seeds }}"
|
|
|
|
# Comma separated list of nodes to keep persistent connections to
|
|
# Do not add private peers to this list if you don't want them advertised
|
|
persistent_peers = "{{ .P2P.PersistentPeers }}"
|
|
|
|
# UPNP port forwarding
|
|
upnp = {{ .P2P.UPNP }}
|
|
|
|
# Path to address book
|
|
addr_book_file = "{{ js .P2P.AddrBook }}"
|
|
|
|
# Set true for strict address routability rules
|
|
addr_book_strict = {{ .P2P.AddrBookStrict }}
|
|
|
|
# Time to wait before flushing messages out on the connection, in ms
|
|
flush_throttle_timeout = {{ .P2P.FlushThrottleTimeout }}
|
|
|
|
# Maximum number of peers to connect to
|
|
max_num_peers = {{ .P2P.MaxNumPeers }}
|
|
|
|
# Maximum size of a message packet payload, in bytes
|
|
max_packet_msg_payload_size = {{ .P2P.MaxPacketMsgPayloadSize }}
|
|
|
|
# Rate at which packets can be sent, in bytes/second
|
|
send_rate = {{ .P2P.SendRate }}
|
|
|
|
# Rate at which packets can be received, in bytes/second
|
|
recv_rate = {{ .P2P.RecvRate }}
|
|
|
|
# Set true to enable the peer-exchange reactor
|
|
pex = {{ .P2P.PexReactor }}
|
|
|
|
# Seed mode, in which node constantly crawls the network and looks for
|
|
# peers. If another node asks it for addresses, it responds and disconnects.
|
|
#
|
|
# Does not work if the peer-exchange reactor is disabled.
|
|
seed_mode = {{ .P2P.SeedMode }}
|
|
|
|
# Comma separated list of peer IDs to keep private (will not be gossiped to other peers)
|
|
private_peer_ids = "{{ .P2P.PrivatePeerIDs }}"
|
|
|
|
##### mempool configuration options #####
|
|
[mempool]
|
|
|
|
recheck = {{ .Mempool.Recheck }}
|
|
recheck_empty = {{ .Mempool.RecheckEmpty }}
|
|
broadcast = {{ .Mempool.Broadcast }}
|
|
wal_dir = "{{ js .Mempool.WalPath }}"
|
|
|
|
# size of the mempool
|
|
size = {{ .Mempool.Size }}
|
|
|
|
# size of the cache (used to filter transactions we saw earlier)
|
|
cache_size = {{ .Mempool.CacheSize }}
|
|
|
|
##### consensus configuration options #####
|
|
[consensus]
|
|
|
|
wal_file = "{{ js .Consensus.WalPath }}"
|
|
|
|
# All timeouts are in milliseconds
|
|
timeout_propose = {{ .Consensus.TimeoutPropose }}
|
|
timeout_propose_delta = {{ .Consensus.TimeoutProposeDelta }}
|
|
timeout_prevote = {{ .Consensus.TimeoutPrevote }}
|
|
timeout_prevote_delta = {{ .Consensus.TimeoutPrevoteDelta }}
|
|
timeout_precommit = {{ .Consensus.TimeoutPrecommit }}
|
|
timeout_precommit_delta = {{ .Consensus.TimeoutPrecommitDelta }}
|
|
timeout_commit = {{ .Consensus.TimeoutCommit }}
|
|
|
|
# Make progress as soon as we have all the precommits (as if TimeoutCommit = 0)
|
|
skip_timeout_commit = {{ .Consensus.SkipTimeoutCommit }}
|
|
|
|
# EmptyBlocks mode and possible interval between empty blocks in seconds
|
|
create_empty_blocks = {{ .Consensus.CreateEmptyBlocks }}
|
|
create_empty_blocks_interval = {{ .Consensus.CreateEmptyBlocksInterval }}
|
|
|
|
# Reactor sleep duration parameters are in milliseconds
|
|
peer_gossip_sleep_duration = {{ .Consensus.PeerGossipSleepDuration }}
|
|
peer_query_maj23_sleep_duration = {{ .Consensus.PeerQueryMaj23SleepDuration }}
|
|
|
|
##### transactions indexer configuration options #####
|
|
[tx_index]
|
|
|
|
# What indexer to use for transactions
|
|
#
|
|
# Options:
|
|
# 1) "null" (default)
|
|
# 2) "kv" - the simplest possible indexer, backed by key-value storage (defaults to levelDB; see DBBackend).
|
|
indexer = "{{ .TxIndex.Indexer }}"
|
|
|
|
# Comma-separated list of tags to index (by default the only tag is tx hash)
|
|
#
|
|
# It's recommended to index only a subset of tags due to possible memory
|
|
# bloat. This is, of course, depends on the indexer's DB and the volume of
|
|
# transactions.
|
|
index_tags = "{{ .TxIndex.IndexTags }}"
|
|
|
|
# When set to true, tells indexer to index all tags. Note this may be not
|
|
# desirable (see the comment above). IndexTags has a precedence over
|
|
# IndexAllTags (i.e. when given both, IndexTags will be indexed).
|
|
index_all_tags = {{ .TxIndex.IndexAllTags }}
|
|
|
|
##### instrumentation configuration options #####
|
|
[instrumentation]
|
|
|
|
# When true, Prometheus metrics are served under /metrics on
|
|
# PrometheusListenAddr.
|
|
# Check out the documentation for the list of available metrics.
|
|
prometheus = {{ .Instrumentation.Prometheus }}
|
|
|
|
# Address to listen for Prometheus collector(s) connections
|
|
prometheus_listen_addr = "{{ .Instrumentation.PrometheusListenAddr }}"
|
|
`
|
|
|
|
/****** these are for test settings ***********/
|
|
|
|
func ResetTestRoot(testName string) *Config {
|
|
rootDir := os.ExpandEnv("$HOME/.tendermint_test")
|
|
rootDir = filepath.Join(rootDir, testName)
|
|
// Remove ~/.tendermint_test_bak
|
|
if cmn.FileExists(rootDir + "_bak") {
|
|
if err := os.RemoveAll(rootDir + "_bak"); err != nil {
|
|
cmn.PanicSanity(err.Error())
|
|
}
|
|
}
|
|
// Move ~/.tendermint_test to ~/.tendermint_test_bak
|
|
if cmn.FileExists(rootDir) {
|
|
if err := os.Rename(rootDir, rootDir+"_bak"); err != nil {
|
|
cmn.PanicSanity(err.Error())
|
|
}
|
|
}
|
|
// Create new dir
|
|
if err := cmn.EnsureDir(rootDir, 0700); err != nil {
|
|
cmn.PanicSanity(err.Error())
|
|
}
|
|
if err := cmn.EnsureDir(filepath.Join(rootDir, defaultConfigDir), 0700); err != nil {
|
|
cmn.PanicSanity(err.Error())
|
|
}
|
|
if err := cmn.EnsureDir(filepath.Join(rootDir, defaultDataDir), 0700); err != nil {
|
|
cmn.PanicSanity(err.Error())
|
|
}
|
|
|
|
baseConfig := DefaultBaseConfig()
|
|
configFilePath := filepath.Join(rootDir, defaultConfigFilePath)
|
|
genesisFilePath := filepath.Join(rootDir, baseConfig.Genesis)
|
|
privFilePath := filepath.Join(rootDir, baseConfig.PrivValidator)
|
|
|
|
// Write default config file if missing.
|
|
if !cmn.FileExists(configFilePath) {
|
|
writeDefaultConfigFile(configFilePath)
|
|
}
|
|
if !cmn.FileExists(genesisFilePath) {
|
|
cmn.MustWriteFile(genesisFilePath, []byte(testGenesis), 0644)
|
|
}
|
|
// we always overwrite the priv val
|
|
cmn.MustWriteFile(privFilePath, []byte(testPrivValidator), 0644)
|
|
|
|
config := TestConfig().SetRoot(rootDir)
|
|
return config
|
|
}
|
|
|
|
var testGenesis = `{
|
|
"genesis_time": "0001-01-01T00:00:00.000Z",
|
|
"chain_id": "tendermint_test",
|
|
"validators": [
|
|
{
|
|
"pub_key": {
|
|
"type": "tendermint/PubKeyEd25519",
|
|
"value":"AT/+aaL1eB0477Mud9JMm8Sh8BIvOYlPGC9KkIUmFaE="
|
|
},
|
|
"power": "10",
|
|
"name": ""
|
|
}
|
|
],
|
|
"app_hash": ""
|
|
}`
|
|
|
|
var testPrivValidator = `{
|
|
"address": "A3258DCBF45DCA0DF052981870F2D1441A36D145",
|
|
"pub_key": {
|
|
"type": "tendermint/PubKeyEd25519",
|
|
"value": "AT/+aaL1eB0477Mud9JMm8Sh8BIvOYlPGC9KkIUmFaE="
|
|
},
|
|
"priv_key": {
|
|
"type": "tendermint/PrivKeyEd25519",
|
|
"value": "EVkqJO/jIXp3rkASXfh9YnyToYXRXhBr6g9cQVxPFnQBP/5povV4HTjvsy530kybxKHwEi85iU8YL0qQhSYVoQ=="
|
|
},
|
|
"last_height": "0",
|
|
"last_round": "0",
|
|
"last_step": 0
|
|
}`
|