You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

689 lines
28 KiB

7 years ago
p2p: introduce peerConn to simplify peer creation (#1226) * expose AuthEnc in the P2P config if AuthEnc is true, dialed peers must have a node ID in the address and it must match the persistent pubkey from the secret handshake. Refs #1157 * fixes after my own review * fix docs * fix build failure ``` p2p/pex/pex_reactor_test.go:288:88: cannot use seed.NodeInfo().NetAddress() (type *p2p.NetAddress) as type string in array or slice literal ``` * p2p: introduce peerConn to simplify peer creation * Introduce `peerConn` containing the known fields of `peer` * `peer` only created in `sw.addPeer` once handshake is complete and NodeInfo is checked * Eliminates some mutable variables and makes the code flow better * Simplifies the `newXxxPeer` funcs * Use ID instead of PubKey where possible. * SetPubKeyFilter -> SetIDFilter * nodeInfo.Validate takes ID * remove peer.PubKey() * persistent node ids * fixes from review * test: use ip_plus_id.sh more * fix invalid memory panic during fast_sync test ``` 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: panic: runtime error: invalid memory address or nil pointer dereference 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: [signal SIGSEGV: segmentation violation code=0x1 addr=0x20 pc=0x98dd3e] 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: goroutine 3432 [running]: 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: github.com/tendermint/tendermint/p2p.newOutboundPeerConn(0xc423fd1380, 0xc420933e00, 0x1, 0x1239a60, 0 xc420128c40, 0x2, 0x42caf6, 0xc42001f300, 0xc422831d98, 0xc4227951c0, ...) 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: #011/go/src/github.com/tendermint/tendermint/p2p/peer.go:123 +0x31e 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: github.com/tendermint/tendermint/p2p.(*Switch).addOutboundPeerWithConfig(0xc4200ad040, 0xc423fd1380, 0 xc420933e00, 0xc423f48801, 0x28, 0x2) 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: #011/go/src/github.com/tendermint/tendermint/p2p/switch.go:455 +0x12b 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: github.com/tendermint/tendermint/p2p.(*Switch).DialPeerWithAddress(0xc4200ad040, 0xc423fd1380, 0x1, 0x 0, 0x0) 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: #011/go/src/github.com/tendermint/tendermint/p2p/switch.go:371 +0xdc 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: github.com/tendermint/tendermint/p2p.(*Switch).reconnectToPeer(0xc4200ad040, 0x123e000, 0xc42007bb00) 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: #011/go/src/github.com/tendermint/tendermint/p2p/switch.go:290 +0x25f 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: created by github.com/tendermint/tendermint/p2p.(*Switch).StopPeerForError 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: #011/go/src/github.com/tendermint/tendermint/p2p/switch.go:256 +0x1b7 ```
6 years ago
p2p: introduce peerConn to simplify peer creation (#1226) * expose AuthEnc in the P2P config if AuthEnc is true, dialed peers must have a node ID in the address and it must match the persistent pubkey from the secret handshake. Refs #1157 * fixes after my own review * fix docs * fix build failure ``` p2p/pex/pex_reactor_test.go:288:88: cannot use seed.NodeInfo().NetAddress() (type *p2p.NetAddress) as type string in array or slice literal ``` * p2p: introduce peerConn to simplify peer creation * Introduce `peerConn` containing the known fields of `peer` * `peer` only created in `sw.addPeer` once handshake is complete and NodeInfo is checked * Eliminates some mutable variables and makes the code flow better * Simplifies the `newXxxPeer` funcs * Use ID instead of PubKey where possible. * SetPubKeyFilter -> SetIDFilter * nodeInfo.Validate takes ID * remove peer.PubKey() * persistent node ids * fixes from review * test: use ip_plus_id.sh more * fix invalid memory panic during fast_sync test ``` 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: panic: runtime error: invalid memory address or nil pointer dereference 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: [signal SIGSEGV: segmentation violation code=0x1 addr=0x20 pc=0x98dd3e] 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: goroutine 3432 [running]: 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: github.com/tendermint/tendermint/p2p.newOutboundPeerConn(0xc423fd1380, 0xc420933e00, 0x1, 0x1239a60, 0 xc420128c40, 0x2, 0x42caf6, 0xc42001f300, 0xc422831d98, 0xc4227951c0, ...) 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: #011/go/src/github.com/tendermint/tendermint/p2p/peer.go:123 +0x31e 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: github.com/tendermint/tendermint/p2p.(*Switch).addOutboundPeerWithConfig(0xc4200ad040, 0xc423fd1380, 0 xc420933e00, 0xc423f48801, 0x28, 0x2) 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: #011/go/src/github.com/tendermint/tendermint/p2p/switch.go:455 +0x12b 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: github.com/tendermint/tendermint/p2p.(*Switch).DialPeerWithAddress(0xc4200ad040, 0xc423fd1380, 0x1, 0x 0, 0x0) 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: #011/go/src/github.com/tendermint/tendermint/p2p/switch.go:371 +0xdc 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: github.com/tendermint/tendermint/p2p.(*Switch).reconnectToPeer(0xc4200ad040, 0x123e000, 0xc42007bb00) 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: #011/go/src/github.com/tendermint/tendermint/p2p/switch.go:290 +0x25f 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: created by github.com/tendermint/tendermint/p2p.(*Switch).StopPeerForError 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: #011/go/src/github.com/tendermint/tendermint/p2p/switch.go:256 +0x1b7 ```
6 years ago
p2p: introduce peerConn to simplify peer creation (#1226) * expose AuthEnc in the P2P config if AuthEnc is true, dialed peers must have a node ID in the address and it must match the persistent pubkey from the secret handshake. Refs #1157 * fixes after my own review * fix docs * fix build failure ``` p2p/pex/pex_reactor_test.go:288:88: cannot use seed.NodeInfo().NetAddress() (type *p2p.NetAddress) as type string in array or slice literal ``` * p2p: introduce peerConn to simplify peer creation * Introduce `peerConn` containing the known fields of `peer` * `peer` only created in `sw.addPeer` once handshake is complete and NodeInfo is checked * Eliminates some mutable variables and makes the code flow better * Simplifies the `newXxxPeer` funcs * Use ID instead of PubKey where possible. * SetPubKeyFilter -> SetIDFilter * nodeInfo.Validate takes ID * remove peer.PubKey() * persistent node ids * fixes from review * test: use ip_plus_id.sh more * fix invalid memory panic during fast_sync test ``` 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: panic: runtime error: invalid memory address or nil pointer dereference 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: [signal SIGSEGV: segmentation violation code=0x1 addr=0x20 pc=0x98dd3e] 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: goroutine 3432 [running]: 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: github.com/tendermint/tendermint/p2p.newOutboundPeerConn(0xc423fd1380, 0xc420933e00, 0x1, 0x1239a60, 0 xc420128c40, 0x2, 0x42caf6, 0xc42001f300, 0xc422831d98, 0xc4227951c0, ...) 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: #011/go/src/github.com/tendermint/tendermint/p2p/peer.go:123 +0x31e 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: github.com/tendermint/tendermint/p2p.(*Switch).addOutboundPeerWithConfig(0xc4200ad040, 0xc423fd1380, 0 xc420933e00, 0xc423f48801, 0x28, 0x2) 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: #011/go/src/github.com/tendermint/tendermint/p2p/switch.go:455 +0x12b 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: github.com/tendermint/tendermint/p2p.(*Switch).DialPeerWithAddress(0xc4200ad040, 0xc423fd1380, 0x1, 0x 0, 0x0) 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: #011/go/src/github.com/tendermint/tendermint/p2p/switch.go:371 +0xdc 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: github.com/tendermint/tendermint/p2p.(*Switch).reconnectToPeer(0xc4200ad040, 0x123e000, 0xc42007bb00) 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: #011/go/src/github.com/tendermint/tendermint/p2p/switch.go:290 +0x25f 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: created by github.com/tendermint/tendermint/p2p.(*Switch).StopPeerForError 2018-02-21T06:30:05Z box887.localdomain docker/local_testnet_4[14907]: #011/go/src/github.com/tendermint/tendermint/p2p/switch.go:256 +0x1b7 ```
6 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
  1. # Changelog
  2. ## Roadmap
  3. BREAKING CHANGES:
  4. - Better support for injecting randomness
  5. - Upgrade consensus for more real-time use of evidence
  6. FEATURES:
  7. - Use the chain as its own CA for nodes and validators
  8. - Tooling to run multiple blockchains/apps, possibly in a single process
  9. - State syncing (without transaction replay)
  10. - Add authentication and rate-limitting to the RPC
  11. IMPROVEMENTS:
  12. - Improve subtleties around mempool caching and logic
  13. - Consensus optimizations:
  14. - cache block parts for faster agreement after round changes
  15. - propagate block parts rarest first
  16. - Better testing of the consensus state machine (ie. use a DSL)
  17. - Auto compiled serialization/deserialization code instead of go-wire reflection
  18. BUG FIXES:
  19. - Graceful handling/recovery for apps that have non-determinism or fail to halt
  20. - Graceful handling/recovery for violations of safety, or liveness
  21. ## 0.19.1 (TBD)
  22. BUG FIXES
  23. - [spec] Document address format and pubkey encoding
  24. ## 0.19.0 (April 13th, 2018)
  25. BREAKING:
  26. - [cmd] improved `testnet` command; now it can fill in `persistent_peers` for you in the config file and much more (see `tendermint testnet --help` for details)
  27. - [cmd] `show_node_id` now returns an error if there is no node key
  28. - [rpc]: changed the output format for the `/status` endpoint (see https://godoc.org/github.com/tendermint/tendermint/rpc/core#Status)
  29. Upgrade from go-wire to go-amino. This is a sweeping change that breaks everything that is
  30. serialized to disk or over the network.
  31. See github.com/tendermint/go-amino for details on the new format.
  32. See `scripts/wire2amino.go` for a tool to upgrade
  33. genesis/priv_validator/node_key JSON files.
  34. FEATURES:
  35. - [cmd] added `gen_node_key` command
  36. ## 0.18.0 (April 6th, 2018)
  37. BREAKING:
  38. - [types] Merkle tree uses different encoding for varints (see tmlibs v0.8.0)
  39. - [types] ValidtorSet.GetByAddress returns -1 if no validator found
  40. - [p2p] require all addresses come with an ID no matter what
  41. - [rpc] Listening address must contain tcp:// or unix:// prefix
  42. FEATURES:
  43. - [rpc] StartHTTPAndTLSServer (not used yet)
  44. - [rpc] Include validator's voting power in `/status`
  45. - [rpc] `/tx` and `/tx_search` responses now include the transaction hash
  46. - [rpc] Include peer NodeIDs in `/net_info`
  47. IMPROVEMENTS:
  48. - [config] trim whitespace from elements of lists (like `persistent_peers`)
  49. - [rpc] `/tx_search` results are sorted by height
  50. - [p2p] do not try to connect to ourselves (ok, maybe only once)
  51. - [p2p] seeds respond with a bias towards good peers
  52. BUG FIXES:
  53. - [rpc] fix subscribing using an abci.ResponseDeliverTx tag
  54. - [rpc] fix tx_indexers matchRange
  55. - [rpc] fix unsubscribing (see tmlibs v0.8.0)
  56. ## 0.17.1 (March 27th, 2018)
  57. BUG FIXES:
  58. - [types] Actually support `app_state` in genesis as `AppStateJSON`
  59. ## 0.17.0 (March 27th, 2018)
  60. BREAKING:
  61. - [types] WriteSignBytes -> SignBytes
  62. IMPROVEMENTS:
  63. - [all] renamed `dummy` (`persistent_dummy`) to `kvstore` (`persistent_kvstore`) (name "dummy" is deprecated and will not work in the next breaking release)
  64. - [docs] note on determinism (docs/determinism.rst)
  65. - [genesis] `app_options` field is deprecated. please rename it to `app_state` in your genesis file(s). `app_options` will not work in the next breaking release
  66. - [p2p] dial seeds directly without potential peers
  67. - [p2p] exponential backoff for addrs in the address book
  68. - [p2p] mark peer as good if it contributed enough votes or block parts
  69. - [p2p] stop peer if it sends incorrect data, msg to unknown channel, msg we did not expect
  70. - [p2p] when `auth_enc` is true, all dialed peers must have a node ID in their address
  71. - [spec] various improvements
  72. - switched from glide to dep internally for package management
  73. - [wire] prep work for upgrading to new go-wire (which is now called go-amino)
  74. FEATURES:
  75. - [config] exposed `auth_enc` flag to enable/disable encryption
  76. - [config] added the `--p2p.private_peer_ids` flag and `PrivatePeerIDs` config variable (see config for description)
  77. - [rpc] added `/health` endpoint, which returns empty result for now
  78. - [types/priv_validator] new format and socket client, allowing for remote signing
  79. BUG FIXES:
  80. - [consensus] fix liveness bug by introducing ValidBlock mechanism
  81. ## 0.16.0 (February 20th, 2018)
  82. BREAKING CHANGES:
  83. - [config] use $TMHOME/config for all config and json files
  84. - [p2p] old `--p2p.seeds` is now `--p2p.persistent_peers` (persistent peers to which TM will always connect to)
  85. - [p2p] now `--p2p.seeds` only used for getting addresses (if addrbook is empty; not persistent)
  86. - [p2p] NodeInfo: remove RemoteAddr and add Channels
  87. - we must have at least one overlapping channel with peer
  88. - we only send msgs for channels the peer advertised
  89. - [p2p/conn] pong timeout
  90. - [lite] comment out IAVL related code
  91. FEATURES:
  92. - [p2p] added new `/dial_peers&persistent=_` **unsafe** endpoint
  93. - [p2p] persistent node key in `$THMHOME/config/node_key.json`
  94. - [p2p] introduce peer ID and authenticate peers by ID using addresses like `ID@IP:PORT`
  95. - [p2p/pex] new seed mode crawls the network and serves as a seed.
  96. - [config] MempoolConfig.CacheSize
  97. - [config] P2P.SeedMode (`--p2p.seed_mode`)
  98. IMPROVEMENT:
  99. - [p2p/pex] stricter rules in the PEX reactor for better handling of abuse
  100. - [p2p] various improvements to code structure including subpackages for `pex` and `conn`
  101. - [docs] new spec!
  102. - [all] speed up the tests!
  103. BUG FIX:
  104. - [blockchain] StopPeerForError on timeout
  105. - [consensus] StopPeerForError on a bad Maj23 message
  106. - [state] flush mempool conn before calling commit
  107. - [types] fix priv val signing things that only differ by timestamp
  108. - [mempool] fix memory leak causing zombie peers
  109. - [p2p/conn] fix potential deadlock
  110. ## 0.15.0 (December 29, 2017)
  111. BREAKING CHANGES:
  112. - [p2p] enable the Peer Exchange reactor by default
  113. - [types] add Timestamp field to Proposal/Vote
  114. - [types] add new fields to Header: TotalTxs, ConsensusParamsHash, LastResultsHash, EvidenceHash
  115. - [types] add Evidence to Block
  116. - [types] simplify ValidateBasic
  117. - [state] updates to support changes to the header
  118. - [state] Enforce <1/3 of validator set can change at a time
  119. FEATURES:
  120. - [state] Send indices of absent validators and addresses of byzantine validators in BeginBlock
  121. - [state] Historical ConsensusParams and ABCIResponses
  122. - [docs] Specification for the base Tendermint data structures.
  123. - [evidence] New evidence reactor for gossiping and managing evidence
  124. - [rpc] `/block_results?height=X` returns the DeliverTx results for a given height.
  125. IMPROVEMENTS:
  126. - [consensus] Better handling of corrupt WAL file
  127. BUG FIXES:
  128. - [lite] fix race
  129. - [state] validate block.Header.ValidatorsHash
  130. - [p2p] allow seed addresses to be prefixed with eg. `tcp://`
  131. - [p2p] use consistent key to refer to peers so we dont try to connect to existing peers
  132. - [cmd] fix `tendermint init` to ignore files that are there and generate files that aren't.
  133. ## 0.14.0 (December 11, 2017)
  134. BREAKING CHANGES:
  135. - consensus/wal: removed separator
  136. - rpc/client: changed Subscribe/Unsubscribe/UnsubscribeAll funcs signatures to be identical to event bus.
  137. FEATURES:
  138. - new `tendermint lite` command (and `lite/proxy` pkg) for running a light-client RPC proxy.
  139. NOTE it is currently insecure and its APIs are not yet covered by semver
  140. IMPROVEMENTS:
  141. - rpc/client: can act as event bus subscriber (See https://github.com/tendermint/tendermint/issues/945).
  142. - p2p: use exponential backoff from seconds to hours when attempting to reconnect to persistent peer
  143. - config: moniker defaults to the machine's hostname instead of "anonymous"
  144. BUG FIXES:
  145. - p2p: no longer exit if one of the seed addresses is incorrect
  146. ## 0.13.0 (December 6, 2017)
  147. BREAKING CHANGES:
  148. - abci: update to v0.8 using gogo/protobuf; includes tx tags, vote info in RequestBeginBlock, data.Bytes everywhere, use int64, etc.
  149. - types: block heights are now `int64` everywhere
  150. - types & node: EventSwitch and EventCache have been replaced by EventBus and EventBuffer; event types have been overhauled
  151. - node: EventSwitch methods now refer to EventBus
  152. - rpc/lib/types: RPCResponse is no longer a pointer; WSRPCConnection interface has been modified
  153. - rpc/client: WaitForOneEvent takes an EventsClient instead of types.EventSwitch
  154. - rpc/client: Add/RemoveListenerForEvent are now Subscribe/Unsubscribe
  155. - rpc/core/types: ResultABCIQuery wraps an abci.ResponseQuery
  156. - rpc: `/subscribe` and `/unsubscribe` take `query` arg instead of `event`
  157. - rpc: `/status` returns the LatestBlockTime in human readable form instead of in nanoseconds
  158. - mempool: cached transactions return an error instead of an ABCI response with BadNonce
  159. FEATURES:
  160. - rpc: new `/unsubscribe_all` WebSocket RPC endpoint
  161. - rpc: new `/tx_search` endpoint for filtering transactions by more complex queries
  162. - p2p/trust: new trust metric for tracking peers. See ADR-006
  163. - config: TxIndexConfig allows to set what DeliverTx tags to index
  164. IMPROVEMENTS:
  165. - New asynchronous events system using `tmlibs/pubsub`
  166. - logging: Various small improvements
  167. - consensus: Graceful shutdown when app crashes
  168. - tests: Fix various non-deterministic errors
  169. - p2p: more defensive programming
  170. BUG FIXES:
  171. - consensus: fix panic where prs.ProposalBlockParts is not initialized
  172. - p2p: fix panic on bad channel
  173. ## 0.12.1 (November 27, 2017)
  174. BUG FIXES:
  175. - upgrade tmlibs dependency to enable Windows builds for Tendermint
  176. ## 0.12.0 (October 27, 2017)
  177. BREAKING CHANGES:
  178. - rpc/client: websocket ResultsCh and ErrorsCh unified in ResponsesCh.
  179. - rpc/client: ABCIQuery no longer takes `prove`
  180. - state: remove GenesisDoc from state.
  181. - consensus: new binary WAL format provides efficiency and uses checksums to detect corruption
  182. - use scripts/wal2json to convert to json for debugging
  183. FEATURES:
  184. - new `certifiers` pkg contains the tendermint light-client library (name subject to change)!
  185. - rpc: `/genesis` includes the `app_options` .
  186. - rpc: `/abci_query` takes an additional `height` parameter to support historical queries.
  187. - rpc/client: new ABCIQueryWithOptions supports options like `trusted` (set false to get a proof) and `height` to query a historical height.
  188. IMPROVEMENTS:
  189. - rpc: `/genesis` result includes `app_options`
  190. - rpc/lib/client: add jitter to reconnects.
  191. - rpc/lib/types: `RPCError` satisfies the `error` interface.
  192. BUG FIXES:
  193. - rpc/client: fix ws deadlock after stopping
  194. - blockchain: fix panic on AddBlock when peer is nil
  195. - mempool: fix sending on TxsAvailable when a tx has been invalidated
  196. - consensus: dont run WAL catchup if we fast synced
  197. ## 0.11.1 (October 10, 2017)
  198. IMPROVEMENTS:
  199. - blockchain/reactor: respondWithNoResponseMessage for missing height
  200. BUG FIXES:
  201. - rpc: fixed client WebSocket timeout
  202. - rpc: client now resubscribes on reconnection
  203. - rpc: fix panics on missing params
  204. - rpc: fix `/dump_consensus_state` to have normal json output (NOTE: technically breaking, but worth a bug fix label)
  205. - types: fixed out of range error in VoteSet.addVote
  206. - consensus: fix wal autofile via https://github.com/tendermint/tmlibs/blob/master/CHANGELOG.md#032-october-2-2017
  207. ## 0.11.0 (September 22, 2017)
  208. BREAKING:
  209. - genesis file: validator `amount` is now `power`
  210. - abci: Info, BeginBlock, InitChain all take structs
  211. - rpc: various changes to match JSONRPC spec (http://www.jsonrpc.org/specification), including breaking ones:
  212. - requests that previously returned HTTP code 4XX now return 200 with an error code in the JSONRPC.
  213. - `rpctypes.RPCResponse` uses new `RPCError` type instead of `string`.
  214. - cmd: if there is no genesis, exit immediately instead of waiting around for one to show.
  215. - types: `Signer.Sign` returns an error.
  216. - state: every validator set change is persisted to disk, which required some changes to the `State` structure.
  217. - p2p: new `p2p.Peer` interface used for all reactor methods (instead of `*p2p.Peer` struct).
  218. FEATURES:
  219. - rpc: `/validators?height=X` allows querying of validators at previous heights.
  220. - rpc: Leaving the `height` param empty for `/block`, `/validators`, and `/commit` will return the value for the latest height.
  221. IMPROVEMENTS:
  222. - docs: Moved all docs from the website and tools repo in, converted to `.rst`, and cleaned up for presentation on `tendermint.readthedocs.io`
  223. BUG FIXES:
  224. - fix WAL openning issue on Windows
  225. ## 0.10.4 (September 5, 2017)
  226. IMPROVEMENTS:
  227. - docs: Added Slate docs to each rpc function (see rpc/core)
  228. - docs: Ported all website docs to Read The Docs
  229. - config: expose some p2p params to tweak performance: RecvRate, SendRate, and MaxMsgPacketPayloadSize
  230. - rpc: Upgrade the websocket client and server, including improved auto reconnect, and proper ping/pong
  231. BUG FIXES:
  232. - consensus: fix panic on getVoteBitArray
  233. - consensus: hang instead of panicking on byzantine consensus failures
  234. - cmd: dont load config for version command
  235. ## 0.10.3 (August 10, 2017)
  236. FEATURES:
  237. - control over empty block production:
  238. - new flag, `--consensus.create_empty_blocks`; when set to false, blocks are only created when there are txs or when the AppHash changes.
  239. - new config option, `consensus.create_empty_blocks_interval`; an empty block is created after this many seconds.
  240. - in normal operation, `create_empty_blocks = true` and `create_empty_blocks_interval = 0`, so blocks are being created all the time (as in all previous versions of tendermint). The number of empty blocks can be reduced by increasing `create_empty_blocks_interval` or by setting `create_empty_blocks = false`.
  241. - new `TxsAvailable()` method added to Mempool that returns a channel which fires when txs are available.
  242. - new heartbeat message added to consensus reactor to notify peers that a node is waiting for txs before entering propose step.
  243. - rpc: Add `syncing` field to response returned by `/status`. Is `true` while in fast-sync mode.
  244. IMPROVEMENTS:
  245. - various improvements to documentation and code comments
  246. BUG FIXES:
  247. - mempool: pass height into constructor so it doesn't always start at 0
  248. ## 0.10.2 (July 10, 2017)
  249. FEATURES:
  250. - Enable lower latency block commits by adding consensus reactor sleep durations and p2p flush throttle timeout to the config
  251. IMPROVEMENTS:
  252. - More detailed logging in the consensus reactor and state machine
  253. - More in-code documentation for many exposed functions, especially in consensus/reactor.go and p2p/switch.go
  254. - Improved readability for some function definitions and code blocks with long lines
  255. ## 0.10.1 (June 28, 2017)
  256. FEATURES:
  257. - Use `--trace` to get stack traces for logged errors
  258. - types: GenesisDoc.ValidatorHash returns the hash of the genesis validator set
  259. - types: GenesisDocFromFile parses a GenesiDoc from a JSON file
  260. IMPROVEMENTS:
  261. - Add a Code of Conduct
  262. - Variety of improvements as suggested by `megacheck` tool
  263. - rpc: deduplicate tests between rpc/client and rpc/tests
  264. - rpc: addresses without a protocol prefix default to `tcp://`. `http://` is also accepted as an alias for `tcp://`
  265. - cmd: commands are more easily reuseable from other tools
  266. - DOCKER: automate build/push
  267. BUG FIXES:
  268. - Fix log statements using keys with spaces (logger does not currently support spaces)
  269. - rpc: set logger on websocket connection
  270. - rpc: fix ws connection stability by setting write deadline on pings
  271. ## 0.10.0 (June 2, 2017)
  272. Includes major updates to configuration, logging, and json serialization.
  273. Also includes the Grand Repo-Merge of 2017.
  274. BREAKING CHANGES:
  275. - Config and Flags:
  276. - The `config` map is replaced with a [`Config` struct](https://github.com/tendermint/tendermint/blob/master/config/config.go#L11),
  277. containing substructs: `BaseConfig`, `P2PConfig`, `MempoolConfig`, `ConsensusConfig`, `RPCConfig`
  278. - This affects the following flags:
  279. - `--seeds` is now `--p2p.seeds`
  280. - `--node_laddr` is now `--p2p.laddr`
  281. - `--pex` is now `--p2p.pex`
  282. - `--skip_upnp` is now `--p2p.skip_upnp`
  283. - `--rpc_laddr` is now `--rpc.laddr`
  284. - `--grpc_laddr` is now `--rpc.grpc_laddr`
  285. - Any configuration option now within a substract must come under that heading in the `config.toml`, for instance:
  286. ```
  287. [p2p]
  288. laddr="tcp://1.2.3.4:46656"
  289. [consensus]
  290. timeout_propose=1000
  291. ```
  292. - Use viper and `DefaultConfig() / TestConfig()` functions to handle defaults, and remove `config/tendermint` and `config/tendermint_test`
  293. - Change some function and method signatures to
  294. - Change some [function and method signatures](https://gist.github.com/ebuchman/640d5fc6c2605f73497992fe107ebe0b) accomodate new config
  295. - Logger
  296. - Replace static `log15` logger with a simple interface, and provide a new implementation using `go-kit`.
  297. See our new [logging library](https://github.com/tendermint/tmlibs/log) and [blog post](https://tendermint.com/blog/abstracting-the-logger-interface-in-go) for more details
  298. - Levels `warn` and `notice` are removed (you may need to change them in your `config.toml`!)
  299. - Change some [function and method signatures](https://gist.github.com/ebuchman/640d5fc6c2605f73497992fe107ebe0b) to accept a logger
  300. - JSON serialization:
  301. - Replace `[TypeByte, Xxx]` with `{"type": "some-type", "data": Xxx}` in RPC and all `.json` files by using `go-wire/data`. For instance, a public key is now:
  302. ```
  303. "pub_key": {
  304. "type": "ed25519",
  305. "data": "83DDF8775937A4A12A2704269E2729FCFCD491B933C4B0A7FFE37FE41D7760D0"
  306. }
  307. ```
  308. - Remove type information about RPC responses, so `[TypeByte, {"jsonrpc": "2.0", ... }]` is now just `{"jsonrpc": "2.0", ... }`
  309. - Change `[]byte` to `data.Bytes` in all serialized types (for hex encoding)
  310. - Lowercase the JSON tags in `ValidatorSet` fields
  311. - Introduce `EventDataInner` for serializing events
  312. - Other:
  313. - Send InitChain message in handshake if `appBlockHeight == 0`
  314. - Do not include the `Accum` field when computing the validator hash. This makes the ValidatorSetHash unique for a given validator set, rather than changing with every block (as the Accum changes)
  315. - Unsafe RPC calls are not enabled by default. This includes `/dial_seeds`, and all calls prefixed with `unsafe`. Use the `--rpc.unsafe` flag to enable.
  316. FEATURES:
  317. - Per-module log levels. For instance, the new default is `state:info,*:error`, which means the `state` package logs at `info` level, and everything else logs at `error` level
  318. - Log if a node is validator or not in every consensus round
  319. - Use ldflags to set git hash as part of the version
  320. - Ignore `address` and `pub_key` fields in `priv_validator.json` and overwrite them with the values derrived from the `priv_key`
  321. IMPROVEMENTS:
  322. - Merge `tendermint/go-p2p -> tendermint/tendermint/p2p` and `tendermint/go-rpc -> tendermint/tendermint/rpc/lib`
  323. - Update paths for grand repo merge:
  324. - `go-common -> tmlibs/common`
  325. - `go-data -> go-wire/data`
  326. - All other `go-` libs, except `go-crypto` and `go-wire`, are merged under `tmlibs`
  327. - No global loggers (loggers are passed into constructors, or preferably set with a SetLogger method)
  328. - Return HTTP status codes with errors for RPC responses
  329. - Limit `/blockchain_info` call to return a maximum of 20 blocks
  330. - Use `.Wrap()` and `.Unwrap()` instead of eg. `PubKeyS` for `go-crypto` types
  331. - RPC JSON responses use pretty printing (via `json.MarshalIndent`)
  332. - Color code different instances of the consensus for tests
  333. - Isolate viper to `cmd/tendermint/commands` and do not read config from file for tests
  334. ## 0.9.2 (April 26, 2017)
  335. BUG FIXES:
  336. - Fix bug in `ResetPrivValidator` where we were using the global config and log (causing external consumers, eg. basecoin, to fail).
  337. ## 0.9.1 (April 21, 2017)
  338. FEATURES:
  339. - Transaction indexing - txs are indexed by their hash using a simple key-value store; easily extended to more advanced indexers
  340. - New `/tx?hash=X` endpoint to query for transactions and their DeliverTx result by hash. Optionally returns a proof of the tx's inclusion in the block
  341. - `tendermint testnet` command initializes files for a testnet
  342. IMPROVEMENTS:
  343. - CLI now uses Cobra framework
  344. - TMROOT is now TMHOME (TMROOT will stop working in 0.10.0)
  345. - `/broadcast_tx_XXX` also returns the Hash (can be used to query for the tx)
  346. - `/broadcast_tx_commit` also returns the height the block was committed in
  347. - ABCIResponses struct persisted to disk before calling Commit; makes handshake replay much cleaner
  348. - WAL uses #ENDHEIGHT instead of #HEIGHT (#HEIGHT will stop working in 0.10.0)
  349. - Peers included via `--seeds`, under `seeds` in the config, or in `/dial_seeds` are now persistent, and will be reconnected to if the connection breaks
  350. BUG FIXES:
  351. - Fix bug in fast-sync where we stop syncing after a peer is removed, even if they're re-added later
  352. - Fix handshake replay to handle validator set changes and results of DeliverTx when we crash after app.Commit but before state.Save()
  353. ## 0.9.0 (March 6, 2017)
  354. BREAKING CHANGES:
  355. - Update ABCI to v0.4.0, where Query is now `Query(RequestQuery) ResponseQuery`, enabling precise proofs at particular heights:
  356. ```
  357. message RequestQuery{
  358. bytes data = 1;
  359. string path = 2;
  360. uint64 height = 3;
  361. bool prove = 4;
  362. }
  363. message ResponseQuery{
  364. CodeType code = 1;
  365. int64 index = 2;
  366. bytes key = 3;
  367. bytes value = 4;
  368. bytes proof = 5;
  369. uint64 height = 6;
  370. string log = 7;
  371. }
  372. ```
  373. - `BlockMeta` data type unifies its Hash and PartSetHash under a `BlockID`:
  374. ```
  375. type BlockMeta struct {
  376. BlockID BlockID `json:"block_id"` // the block hash and partsethash
  377. Header *Header `json:"header"` // The block's Header
  378. }
  379. ```
  380. - `ValidatorSet.Proposer` is exposed as a field and persisted with the `State`. Use `GetProposer()` to initialize or update after validator-set changes.
  381. - `tendermint gen_validator` command output is now pure JSON
  382. FEATURES:
  383. - New RPC endpoint `/commit?height=X` returns header and commit for block at height `X`
  384. - Client API for each endpoint, including mocks for testing
  385. IMPROVEMENTS:
  386. - `Node` is now a `BaseService`
  387. - Simplified starting Tendermint in-process from another application
  388. - Better organized Makefile
  389. - Scripts for auto-building binaries across platforms
  390. - Docker image improved, slimmed down (using Alpine), and changed from tendermint/tmbase to tendermint/tendermint
  391. - New repo files: `CONTRIBUTING.md`, Github `ISSUE_TEMPLATE`, `CHANGELOG.md`
  392. - Improvements on CircleCI for managing build/test artifacts
  393. - Handshake replay is doen through the consensus package, possibly using a mockApp
  394. - Graceful shutdown of RPC listeners
  395. - Tests for the PEX reactor and DialSeeds
  396. BUG FIXES:
  397. - Check peer.Send for failure before updating PeerState in consensus
  398. - Fix panic in `/dial_seeds` with invalid addresses
  399. - Fix proposer selection logic in ValidatorSet by taking the address into account in the `accumComparable`
  400. - Fix inconcistencies with `ValidatorSet.Proposer` across restarts by persisting it in the `State`
  401. ## 0.8.0 (January 13, 2017)
  402. BREAKING CHANGES:
  403. - New data type `BlockID` to represent blocks:
  404. ```
  405. type BlockID struct {
  406. Hash []byte `json:"hash"`
  407. PartsHeader PartSetHeader `json:"parts"`
  408. }
  409. ```
  410. - `Vote` data type now includes validator address and index:
  411. ```
  412. type Vote struct {
  413. ValidatorAddress []byte `json:"validator_address"`
  414. ValidatorIndex int `json:"validator_index"`
  415. Height int `json:"height"`
  416. Round int `json:"round"`
  417. Type byte `json:"type"`
  418. BlockID BlockID `json:"block_id"` // zero if vote is nil.
  419. Signature crypto.Signature `json:"signature"`
  420. }
  421. ```
  422. - Update TMSP to v0.3.0, where it is now called ABCI and AppendTx is DeliverTx
  423. - Hex strings in the RPC are now "0x" prefixed
  424. FEATURES:
  425. - New message type on the ConsensusReactor, `Maj23Msg`, for peers to alert others they've seen a Maj23,
  426. in order to track and handle conflicting votes intelligently to prevent Byzantine faults from causing halts:
  427. ```
  428. type VoteSetMaj23Message struct {
  429. Height int
  430. Round int
  431. Type byte
  432. BlockID types.BlockID
  433. }
  434. ```
  435. - Configurable block part set size
  436. - Validator set changes
  437. - Optionally skip TimeoutCommit if we have all the votes
  438. - Handshake between Tendermint and App on startup to sync latest state and ensure consistent recovery from crashes
  439. - GRPC server for BroadcastTx endpoint
  440. IMPROVEMENTS:
  441. - Less verbose logging
  442. - Better test coverage (37% -> 49%)
  443. - Canonical SignBytes for signable types
  444. - Write-Ahead Log for Mempool and Consensus via tmlibs/autofile
  445. - Better in-process testing for the consensus reactor and byzantine faults
  446. - Better crash/restart testing for individual nodes at preset failure points, and of networks at arbitrary points
  447. - Better abstraction over timeout mechanics
  448. BUG FIXES:
  449. - Fix memory leak in mempool peer
  450. - Fix panic on POLRound=-1
  451. - Actually set the CommitTime
  452. - Actually send BeginBlock message
  453. - Fix a liveness issues caused by Byzantine proposals/votes. Uses the new `Maj23Msg`.
  454. ## 0.7.4 (December 14, 2016)
  455. FEATURES:
  456. - Enable the Peer Exchange reactor with the `--pex` flag for more resilient gossip network (feature still in development, beware dragons)
  457. IMPROVEMENTS:
  458. - Remove restrictions on RPC endpoint `/dial_seeds` to enable manual network configuration
  459. ## 0.7.3 (October 20, 2016)
  460. IMPROVEMENTS:
  461. - Type safe FireEvent
  462. - More WAL/replay tests
  463. - Cleanup some docs
  464. BUG FIXES:
  465. - Fix deadlock in mempool for synchronous apps
  466. - Replay handles non-empty blocks
  467. - Fix race condition in HeightVoteSet
  468. ## 0.7.2 (September 11, 2016)
  469. BUG FIXES:
  470. - Set mustConnect=false so tendermint will retry connecting to the app
  471. ## 0.7.1 (September 10, 2016)
  472. FEATURES:
  473. - New TMSP connection for Query/Info
  474. - New RPC endpoints:
  475. - `tmsp_query`
  476. - `tmsp_info`
  477. - Allow application to filter peers through Query (off by default)
  478. IMPROVEMENTS:
  479. - TMSP connection type enforced at compile time
  480. - All listen/client urls use a "tcp://" or "unix://" prefix
  481. BUG FIXES:
  482. - Save LastSignature/LastSignBytes to `priv_validator.json` for recovery
  483. - Fix event unsubscribe
  484. - Fix fastsync/blockchain reactor
  485. ## 0.7.0 (August 7, 2016)
  486. BREAKING CHANGES:
  487. - Strict SemVer starting now!
  488. - Update to ABCI v0.2.0
  489. - Validation types now called Commit
  490. - NewBlock event only returns the block header
  491. FEATURES:
  492. - TMSP and RPC support TCP and UNIX sockets
  493. - Addition config options including block size and consensus parameters
  494. - New WAL mode `cswal_light`; logs only the validator's own votes
  495. - New RPC endpoints:
  496. - for starting/stopping profilers, and for updating config
  497. - `/broadcast_tx_commit`, returns when tx is included in a block, else an error
  498. - `/unsafe_flush_mempool`, empties the mempool
  499. IMPROVEMENTS:
  500. - Various optimizations
  501. - Remove bad or invalidated transactions from the mempool cache (allows later duplicates)
  502. - More elaborate testing using CircleCI including benchmarking throughput on 4 digitalocean droplets
  503. BUG FIXES:
  504. - Various fixes to WAL and replay logic
  505. - Various race conditions
  506. ## PreHistory
  507. Strict versioning only began with the release of v0.7.0, in late summer 2016.
  508. The project itself began in early summer 2014 and was workable decentralized cryptocurrency software by the end of that year.
  509. Through the course of 2015, in collaboration with Eris Industries (now Monax Indsutries),
  510. many additional features were integrated, including an implementation from scratch of the Ethereum Virtual Machine.
  511. That implementation now forms the heart of [Burrow](https://github.com/hyperledger/burrow).
  512. In the later half of 2015, the consensus algorithm was upgraded with a more asynchronous design and a more deterministic and robust implementation.
  513. By late 2015, frustration with the difficulty of forking a large monolithic stack to create alternative cryptocurrency designs led to the
  514. invention of the Application Blockchain Interface (ABCI), then called the Tendermint Socket Protocol (TMSP).
  515. The Ethereum Virtual Machine and various other transaction features were removed, and Tendermint was whittled down to a core consensus engine
  516. driving an application running in another process.
  517. The ABCI interface and implementation were iterated on and improved over the course of 2016,
  518. until versioned history kicked in with v0.7.0.