bft blockchain consensus consistency cryptocurrency cryptography db distributed-systems go

History

Alexander Bezobchuk ab0835463f abci: Refactor tagging events using list of lists (#3643 ) ## PR This PR introduces a fundamental breaking change to the structure of ABCI response and tx tags and the way they're processed. Namely, the SDK can support more complex and aggregated events for distribution and slashing. In addition, block responses can include duplicate keys in events. Implement new Event type. An event has a type and a list of KV pairs (ie. list-of-lists). Typical events may look like: "rewards": [{"amount": "5000uatom", "validator": "...", "recipient": "..."}] "sender": [{"address": "...", "balance": "100uatom"}] The events are indexed by {even.type}.{even.attribute[i].key}/.... In this case a client would subscribe or query for rewards.recipient='...' ABCI response types and related types now include Events []Event instead of Tags []cmn.KVPair. PubSub logic now publishes/matches against map[string][]string instead of map[string]string to support duplicate keys in response events (from #1385). A match is successful if the value is found in the slice of strings. closes: #1859 closes: #2905 ## Commits: * Implement Event ABCI type and updates responses to use events * Update messages_test.go * Update kvstore.go * Update event_bus.go * Update subscription.go * Update pubsub.go * Update kvstore.go * Update query logic to handle slice of strings in events * Update Empty#Matches and unit tests * Update pubsub logic * Update EventBus#Publish * Update kv tx indexer * Update godocs * Update ResultEvent to use slice of strings; update RPC * Update more tests * Update abci.md * Check for key in validateAndStringifyEvents * Fix KV indexer to skip empty keys * Fix linting errors * Update CHANGELOG_PENDING.md * Update docs/spec/abci/abci.md Co-Authored-By: Federico Kunze <31522760+fedekunze@users.noreply.github.com> * Update abci/types/types.proto Co-Authored-By: Ethan Buchman <ethan@coinculture.info> * Update docs/spec/abci/abci.md Co-Authored-By: Ethan Buchman <ethan@coinculture.info> * Update libs/pubsub/query/query.go Co-Authored-By: Ethan Buchman <ethan@coinculture.info> * Update match function to match if ANY value matches * Implement TestSubscribeDuplicateKeys * Update TestMatches to include multi-key test cases * Update events.go * Update Query interface godoc * Update match godoc * Add godoc for matchValue * DRY-up tx indexing * Return error from PublishWithEvents in EventBus#Publish * Update PublishEventNewBlockHeader to return an error * Fix build * Update events doc in ABCI * Update ABCI events godoc * Implement TestEventBusPublishEventTxDuplicateKeys * Update TestSubscribeDuplicateKeys to be table-driven * Remove mod file * Remove markdown from events godoc * Implement TestTxSearchDeprecatedIndexing test		6 years ago
..
.vuepress	update docs (#3349)	6 years ago
app-dev	switch to go mod (#3613)	6 years ago
architecture	[ADR] ADR-36: blockchain reactor refactor spec (#3506)	6 years ago
imgs	docs: fixes from 'first time' review (#2999)	6 years ago
interviews	Peng/deprecate aib data (#1926)	6 years ago
introduction	switch to go mod (#3613)	6 years ago
networks	fix integration script (#3667)	6 years ago
research	Minor docs cleanup (#2472)	6 years ago
spec	abci: Refactor tagging events using list of lists (#3643)	6 years ago
tendermint-core	p2p: Per channel metrics (#3666) (#3677)	6 years ago
tools	switch to go mod (#3613)	6 years ago
.python-version	Cleanup build and structure	7 years ago
.textlintrc.json	lint markdown docs using a stop-words and write-good linters (#2195)	6 years ago
DOCS_README.md	update docs (#3349)	6 years ago
README.md	use a github link (#2849)	6 years ago
stop-words.txt	lint markdown docs using a stop-words and write-good linters (#2195)	6 years ago

README.md

Tendermint

Welcome to the Tendermint Core documentation!

Tendermint Core is a blockchain application platform; it provides the equivalent of a web-server, database, and supporting libraries for blockchain applications written in any programming language. Like a web-server serving web applications, Tendermint serves blockchain applications.

More formally, Tendermint Core performs Byzantine Fault Tolerant (BFT) State Machine Replication (SMR) for arbitrary deterministic, finite state machines. For more background, see What is Tendermint?.

To get started quickly with an example application, see the quick start guide.

To learn about application development on Tendermint, see the Application Blockchain Interface.

For more details on using Tendermint, see the respective documentation for Tendermint Core, benchmarking and monitoring, and network deployments.

Contribute

To contribute to the documentation, see this file for details of the build process and considerations when making changes.

Version

This documentation is built from the following commit: