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.
 
 
 
 
 
 
Marko cadcbb2bf5
docs: amend adr-54 with changes in the sdk (#4684)
5 years ago
..
img docs: adr-046 add bisection algorithm details (#4496) 5 years ago
README.md docs/architecture: add adr-55 for proto repo design (#4623) 5 years ago
adr-001-logging.md [R4R] libs/log: add year to log format (#2707) 6 years ago
adr-002-event-subscription.md docs: fix links (#4531) 5 years ago
adr-003-abci-app-rpc.md docs: update and clean up adr 7 years ago
adr-004-historical-validators.md lint markdown docs using a stop-words and write-good linters (#2195) 6 years ago
adr-005-consensus-params.md lint markdown docs using a stop-words and write-good linters (#2195) 6 years ago
adr-006-trust-metric.md lint markdown docs using a stop-words and write-good linters (#2195) 6 years ago
adr-007-trust-metric-usage.md lint markdown docs using a stop-words and write-good linters (#2195) 6 years ago
adr-008-priv-validator.md [pv] add ability to use ipc validator (#2866) 6 years ago
adr-009-ABCI-design.md lint markdown docs using a stop-words and write-good linters (#2195) 6 years ago
adr-010-crypto-changes.md lint markdown docs using a stop-words and write-good linters (#2195) 6 years ago
adr-011-monitoring.md docs: fix links (#4531) 5 years ago
adr-012-peer-transport.md lint markdown docs using a stop-words and write-good linters (#2195) 6 years ago
adr-013-symmetric-crypto.md lint markdown docs using a stop-words and write-good linters (#2195) 6 years ago
adr-014-secp-malleability.md crypto/secp256k1: Fix signature malleability, adopt more efficient en… (#2239) 6 years ago
adr-015-crypto-encoding.md docs: minor doc fixes (#4335) 5 years ago
adr-016-protocol-versions.md adr-016: update int64->uint64; add version to ConsensusParams (#2667) 6 years ago
adr-017-chain-versions.md lint markdown docs using a stop-words and write-good linters (#2195) 6 years ago
adr-018-ABCI-Validators.md docs: fix links (#4531) 5 years ago
adr-019-multisigs.md lint markdown docs using a stop-words and write-good linters (#2195) 6 years ago
adr-020-block-size.md update ADR-020 (#3116) 6 years ago
adr-021-abci-events.md adr-021: note about tag spacers (#2362) 6 years ago
adr-022-abci-errors.md [ADR] ABCI errors and events (#2314) 6 years ago
adr-023-ABCI-propose-tx.md [ADR] ABCI errors and events (#2314) 6 years ago
adr-024-sign-bytes.md [ADR][DRAFT] 024: SignBytes and validator types in privval (#2445) 6 years ago
adr-025-commit.md Update ADR-025 and mark it as Accepted (#3958) 5 years ago
adr-026-general-merkle-proof.md add adr (#2553) 6 years ago
adr-029-check-tx-consensus.md adr-029: update CheckBlock 6 years ago
adr-030-consensus-refactor.md [WIP] Fill in consensus core details in ADR 030 (#2696) 6 years ago
adr-033-pubsub.md adr-033 update 6 years ago
adr-034-priv-validator-file-structure.md [R4R] Add adr-034: PrivValidator file structure (#2751) 6 years ago
adr-035-documentation.md docs ADR (#2828) 6 years ago
adr-037-deliver-block.md libs/common: refactor libs/common 01 (#4230) 5 years ago
adr-039-peer-behaviour.md adr: PeerBehaviour updates (#3558) 6 years ago
adr-040-blockchain-reactor-refactor.md [ADR] ADR-36: blockchain reactor refactor spec (#3506) 6 years ago
adr-041-proposer-selection-via-abci.md adr renames (#3622) 6 years ago
adr-042-state-sync.md lite2: indicate success/failure of Update (#4536) 5 years ago
adr-043-blockchain-riri-org.md docs: fix links (#4531) 5 years ago
adr-044-lite-client-with-weak-subjectivity.md Fix broken /docs/spec links (#4376) 5 years ago
adr-045-abci-evidence.md Fix broken /docs/spec links (#4376) 5 years ago
adr-046-light-client-implementation.md lite2: make maxClockDrift an option (#4616) 5 years ago
adr-047-handling-evidence-from-light-client.md adr-047: evidence handling (#4429) 5 years ago
adr-050-improved-trusted-peering.md adr#50: improve trusted peering (#4072) 5 years ago
adr-051-double-signing-risk-reduction.md Docs staging (#4407) 5 years ago
adr-052-tendermint-mode.md Docs staging (#4407) 5 years ago
adr-053-state-sync-prototype.md ADR-053: strengthen and simplify the state sync ABCI interface (#4610) 5 years ago
adr-054-crypto-encoding-2.md docs: amend adr-54 with changes in the sdk (#4684) 5 years ago
adr-055-protobuf-design.md docs/architecture: add adr-55 for proto repo design (#4623) 5 years ago
adr-template.md adr: crypto encoding for proto (#4481) 5 years ago

README.md

order parent
1 [{order false}]

Architecture Decision Records (ADR)

This is a location to record all high-level architecture decisions in the tendermint project.

You can read more about the ADR concept in this blog post.

An ADR should provide:

  • Context on the relevant goals and the current state
  • Proposed changes to achieve the goals
  • Summary of pros and cons
  • References
  • Changelog

Note the distinction between an ADR and a spec. The ADR provides the context, intuition, reasoning, and justification for a change in architecture, or for the architecture of something new. The spec is much more compressed and streamlined summary of everything as it stands today.

If recorded decisions turned out to be lacking, convene a discussion, record the new decisions here, and then modify the code to match.

Note the context/background should be written in the present tense.

Table of Contents: