配置

Tendermint Core 可以通过 $TMHOME/config/config.toml TOML 文件进行配置。其中一些参数可以由命令行标志覆盖。对于大多数用户来说，对于大多数用户来说，##### main base configuration options ##### 中的选项将被修改，而下面的配置选项将用于高级用户。

选项

由 tendermint init 创建的默认配置文件使用默认值设置了所有参数。不过，它看起来就像下面的文件一样，通过您已安装的 tendermint 版本创建的 config.toml 进行双重检查：

  1. # This is a TOML config file.
  2. # For more information, see https://github.com/toml-lang/toml
  4. ##### main base config options #####
  6. # TCP or UNIX socket address of the ABCI application,
  7. # or the name of an ABCI application compiled in with the Tendermint binary
  8. proxy_app = "tcp://127.0.0.1:26658"
  10. # A custom human readable name for this node
  11. moniker = "anonymous"
  13. # If this node is many blocks behind the tip of the chain, FastSync
  14. # allows them to catchup quickly by downloading blocks in parallel
  15. # and verifying their commits
  16. fast_sync = true
  18. # Database backend: leveldb | memdb | cleveldb
  19. db_backend = "leveldb"
  21. # Database directory
  22. db_dir = "data"
  24. # Output level for logging, including package level options
  25. log_level = "main:info,state:info,*:error"
  27. # Output format: 'plain' (colored text) or 'json'
  28. log_format = "plain"
  30. ##### additional base config options #####
  32. # Path to the JSON file containing the initial validator set and other meta data
  33. genesis_file = "config/genesis.json"
  35. # Path to the JSON file containing the private key to use as a validator in the consensus protocol
  36. priv_validator_file = "config/priv_validator.json"
  38. # TCP or UNIX socket address for Tendermint to listen on for
  39. # connections from an external PrivValidator process
  40. priv_validator_laddr = ""
  42. # Path to the JSON file containing the private key to use for node authentication in the p2p protocol
  43. node_key_file = "config/node_key.json"
  45. # Mechanism to connect to the ABCI application: socket | grpc
  46. abci = "socket"
  48. # TCP or UNIX socket address for the profiling server to listen on
  49. prof_laddr = ""
  51. # If true, query the ABCI app on connecting to a new peer
  52. # so the app can decide if we should keep the connection or not
  53. filter_peers = false
  55. ##### advanced configuration options #####
  57. ##### rpc server configuration options #####
  58. [rpc]
  60. # TCP or UNIX socket address for the RPC server to listen on
  61. laddr = "tcp://0.0.0.0:26657"
  63. # A list of origins a cross-domain request can be executed from
  64. # Default value '[]' disables cors support
  65. # Use '["*"]' to allow any origin
  66. cors_allowed_origins = []
  68. # A list of methods the client is allowed to use with cross-domain requests
  69. cors_allowed_methods = ["HEAD", "GET", "POST"]
  71. # A list of non simple headers the client is allowed to use with cross-domain requests
  72. cors_allowed_headers = ["Origin", "Accept", "Content-Type", "X-Requested-With", "X-Server-Time"]
  74. # TCP or UNIX socket address for the gRPC server to listen on
  75. # NOTE: This server only supports /broadcast_tx_commit
  76. grpc_laddr = ""
  78. # Maximum number of simultaneous connections.
  79. # Does not include RPC (HTTP&WebSocket) connections. See max_open_connections
  80. # If you want to accept a larger number than the default, make sure
  81. # you increase your OS limits.
  82. # 0 - unlimited.
  83. # Should be < {ulimit -Sn} - {MaxNumInboundPeers} - {MaxNumOutboundPeers} - {N of wal, db and other open files}
  84. # 1024 - 40 - 10 - 50 = 924 = ~900
  85. grpc_max_open_connections = 900
  87. # Activate unsafe RPC commands like /dial_seeds and /unsafe_flush_mempool
  88. unsafe = false
  90. # Maximum number of simultaneous connections (including WebSocket).
  91. # Does not include gRPC connections. See grpc_max_open_connections
  92. # If you want to accept a larger number than the default, make sure
  93. # you increase your OS limits.
  94. # 0 - unlimited.
  95. # Should be < {ulimit -Sn} - {MaxNumInboundPeers} - {MaxNumOutboundPeers} - {N of wal, db and other open files}
  96. # 1024 - 40 - 10 - 50 = 924 = ~900
  97. max_open_connections = 900
  99. # Maximum number of unique clientIDs that can /subscribe
  100. # If you're using /broadcast_tx_commit, set to the estimated maximum number
  101. # of broadcast_tx_commit calls per block.
  102. max_subscription_clients = 100
  104. # Maximum number of unique queries a given client can /subscribe to
  105. # If you're using GRPC (or Local RPC client) and /broadcast_tx_commit, set to
  106. # the estimated # maximum number of broadcast_tx_commit calls per block.
  107. max_subscriptions_per_client = 5
  109. # How long to wait for a tx to be committed during /broadcast_tx_commit.
  110. # WARNING: Using a value larger than 10s will result in increasing the
  111. # global HTTP write timeout, which applies to all connections and endpoints.
  112. # See https://github.com/tendermint/tendermint/issues/3435
  113. timeout_broadcast_tx_commit = "10s"
  115. # The name of a file containing certificate that is used to create the HTTPS server.
  116. # If the certificate is signed by a certificate authority,
  117. # the certFile should be the concatenation of the server's certificate, any intermediates,
  118. # and the CA's certificate.
  119. # NOTE: both tls_cert_file and tls_key_file must be present for Tendermint to create HTTPS server. Otherwise, HTTP server is run.
  120. tls_cert_file = ""
  122. # The name of a file containing matching private key that is used to create the HTTPS server.
  123. # NOTE: both tls_cert_file and tls_key_file must be present for Tendermint to create HTTPS server. Otherwise, HTTP server is run.
  124. tls_key_file = ""
  126. ##### peer to peer configuration options #####
  127. [p2p]
  129. # Address to listen for incoming connections
  130. laddr = "tcp://0.0.0.0:26656"
  132. # Address to advertise to peers for them to dial
  133. # If empty, will use the same port as the laddr,
  134. # and will introspect on the listener or use UPnP
  135. # to figure out the address.
  136. external_address = ""
  138. # Comma separated list of seed nodes to connect to
  139. seeds = ""
  141. # Comma separated list of nodes to keep persistent connections to
  142. persistent_peers = ""
  144. # UPNP port forwarding
  145. upnp = false
  147. # Path to address book
  148. addr_book_file = "config/addrbook.json"
  150. # Set true for strict address routability rules
  151. # Set false for private or local networks
  152. addr_book_strict = true
  154. # Maximum number of inbound peers
  155. max_num_inbound_peers = 40
  157. # Maximum number of outbound peers to connect to, excluding persistent peers
  158. max_num_outbound_peers = 10
  160. # Time to wait before flushing messages out on the connection
  161. flush_throttle_timeout = "100ms"
  163. # Maximum size of a message packet payload, in bytes
  164. max_packet_msg_payload_size = 1024
  166. # Rate at which packets can be sent, in bytes/second
  167. send_rate = 5120000
  169. # Rate at which packets can be received, in bytes/second
  170. recv_rate = 5120000
  172. # Set true to enable the peer-exchange reactor
  173. pex = true
  175. # Seed mode, in which node constantly crawls the network and looks for
  176. # peers. If another node asks it for addresses, it responds and disconnects.
  177. #
  178. # Does not work if the peer-exchange reactor is disabled.
  179. seed_mode = false
  181. # Comma separated list of peer IDs to keep private (will not be gossiped to other peers)
  182. private_peer_ids = ""
  184. # Toggle to disable guard against peers connecting from the same ip.
  185. allow_duplicate_ip = false
  187. # Peer connection configuration.
  188. handshake_timeout = "20s"
  189. dial_timeout = "3s"
  191. ##### mempool configuration options #####
  192. [mempool]
  194. recheck = true
  195. broadcast = true
  196. wal_dir = ""
  198. # Maximum number of transactions in the mempool
  199. size = 5000
  201. # Limit the total size of all txs in the mempool.
  202. # This only accounts for raw transactions (e.g. given 1MB transactions and
  203. # max_txs_bytes=5MB, mempool will only accept 5 transactions).
  204. max_txs_bytes = 1073741824
  206. # Size of the cache (used to filter transactions we saw earlier) in transactions
  207. cache_size = 10000
  209. ##### consensus configuration options #####
  210. [consensus]
  212. wal_file = "data/cs.wal/wal"
  214. timeout_propose = "3s"
  215. timeout_propose_delta = "500ms"
  216. timeout_prevote = "1s"
  217. timeout_prevote_delta = "500ms"
  218. timeout_precommit = "1s"
  219. timeout_precommit_delta = "500ms"
  220. timeout_commit = "1s"
  222. # Make progress as soon as we have all the precommits (as if TimeoutCommit = 0)
  223. skip_timeout_commit = false
  225. # EmptyBlocks mode and possible interval between empty blocks
  226. create_empty_blocks = true
  227. create_empty_blocks_interval = "0s"
  229. # Reactor sleep duration parameters
  230. peer_gossip_sleep_duration = "100ms"
  231. peer_query_maj23_sleep_duration = "2s"
  233. # Block time parameters. Corresponds to the minimum time increment between consecutive blocks.
  234. blocktime_iota = "1s"
  236. ##### transactions indexer configuration options #####
  237. [tx_index]
  239. # What indexer to use for transactions
  240. #
  241. # Options:
  242. #   1) "null"
  243. #   2) "kv" (default) - the simplest possible indexer, backed by key-value storage (defaults to levelDB; see DBBackend).
  244. indexer = "kv"
  246. # Comma-separated list of tags to index (by default the only tag is "tx.hash")
  247. #
  248. # You can also index transactions by height by adding "tx.height" tag here.
  249. #
  250. # It's recommended to index only a subset of tags due to possible memory
  251. # bloat. This is, of course, depends on the indexer's DB and the volume of
  252. # transactions.
  253. index_tags = ""
  255. # When set to true, tells indexer to index all tags (predefined tags:
  256. # "tx.hash", "tx.height" and all tags from DeliverTx responses).
  257. #
  258. # Note this may be not desirable (see the comment above). IndexTags has a
  259. # precedence over IndexAllTags (i.e. when given both, IndexTags will be
  260. # indexed).
  261. index_all_tags = false
  263. ##### instrumentation configuration options #####
  264. [instrumentation]
  266. # When true, Prometheus metrics are served under /metrics on
  267. # PrometheusListenAddr.
  268. # Check out the documentation for the list of available metrics.
  269. prometheus = false
  271. # Address to listen for Prometheus collector(s) connections
  272. prometheus_listen_addr = ":26660"
  274. # Maximum number of simultaneous connections.
  275. # If you want to accept a larger number than the default, make sure
  276. # you increase your OS limits.
  277. # 0 - unlimited.
  278. max_open_connections = 3
  280. # Instrumentation namespace
  281. namespace = "tendermint"

空块 VS 没有空块

create_empty_blocks = true

如果在你的配置中 create_empty_blocks 被设置为 true，

If create_empty_blocks is set to true in your config, 每隔大约一秒就会创建一个块(默认的共识参数)。您可以通过更改 timeout_commit 来调节块之间的延迟。如 timeout_commit = "10s" 应该导致大约每 10 秒一个块。

create_empty_blocks = false

在此设置中，在接收交易时创建块。

注意，在 H 块之后，Tendermint 创建了一个我们称为 H+1 “proof block”的东西(只有当应用程序哈希发生变化时) 。这样做的原因是为了支持证明。如果在块 H 中有一个交易将状态更改为 X，则新的应用程序哈希将只包含在块 H+1 中。如果提交交易后，你想要一个轻节点证明新状态(X)，为此，需要提交新块，因为新块具有状态 X 的新应用程序哈希。这就是为什么如果应用程序块哈希变化我们出一个新块(空的)。否则，就无法证明新状态。

另外，如果您将 create_empty_blocks_interval 设置为默认值(0)以外的值，Tendermint 将创建空块，即使在每个 create_empty_blocks_interval 都没有交易的情况下也是如此。例如，使用 create_empty_blocks = false 和 create_empty_blocks_interval = "30s"，Tendermint 只在有交易时创建块，或者在等待 30 秒后没有收到任何交易时创建块。

共识超时解释

关于生产运行中的超时有很多信息。

您还可以在规范中找到更详细的技术解释：拜占庭共识最新 gossip。

  1. [consensus]
  2. ...
  4. timeout_propose = "3s"
  5. timeout_propose_delta = "500ms"
  6. timeout_prevote = "1s"
  7. timeout_prevote_delta = "500ms"
  8. timeout_precommit = "1s"
  9. timeout_precommit_delta = "500ms"
  10. timeout_commit = "1s"

注意，在成功的一个轮中，我们绝对等待的惟一超时是 timeout_commit。

以下是超时时间的简要总结:

  • timeout_propose = 我们要等多久才会有提案被否决
  • timeout_propose_delta = 每轮增加的 timeout_propose
  • timeout_prevote = 在收到 +2/3 的预选后我们要等多久 (也就是说，没有一个快或者空)
  • timeout_prevote_delta = 每轮增加的 timeout_prevote
  • timeout_precommit = 在收到 +2/3 的预提交后我们要等多久 (也就是说，没有一个快或者空)
  • timeout_precommit_delta = 每轮增加的 timeout_precommit
  • timeout_commit = 提交一个块之后，在开始新的高度之前等待的时间(这给了我们一个机会来接收更多的预提交，即使我们已经有 +2/3)