LaconicNetwork/cosmos-sdk
7
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 2 Wiki Activity

Move specification.md to README.md, cleanup overview, separate MVP directory

Browse Source
This commit is contained in:
Christopher Goes
2018-04-17 16:28:33 +02:00
parent 6500728dd2
commit dc2c638f7f
11 changed files with 46 additions and 57 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/spec/ibc/README.md
+41 -4
View File
@@ -1,7 +1,44 @@
# Inter Blockchain Communication protocol
# Cosmos Inter-Blockchain Communication (IBC) Protocol
IBC was defined in the [cosmos whitepaper](https://github.com/cosmos/cosmos/blob/master/WHITEPAPER.md#inter-blockchain-communication-ibc),
and then in detail in a [specification paper](https://github.com/cosmos/ibc/raw/master/CosmosIBCSpecification.pdf).
## Abstract
This package builds on that and includes detailed specifications, pseudocode and protocol specification. Please read the [table of contents](specification.md) of the IBC specification.
This paper specifies the Cosmos Inter-Blockchain Communication (IBC) protocol. The IBC protocol defines a set of semantics for authenticated, strictly-ordered message passing between two blockchains with independent consensus algorithms.
The protocol requires two blockchains with cheaply verifiable instant finality. The protocol makes no assumptions of block confirmation times or maximum network latency of packet transmissions, and the two consensus algorithms remain completely independent. Each chain maintains a local partial order and inter-chain message sequencing ensures cross-chain linearity. Once the two chains have registered a trust relationship, cryptographically provable packets can be sent between the chains.
Each chain maintains a local partial order and inter-chain message sequencing ensures cross-chain linearity. The core IBC protocol is payload-agnostic. On top of IBC, developers can implement the semantics of a particular application, enabling users to transfer valuable assets between different blockchains while preserving, under particular security assumptions of the underlying blockchains, the contractual guarantees of the asset in question - such as scarcity and fungibility for a currency or global uniqueness for a digital kitty-cat.
IBC was first outlined in the [Cosmos Whitepaper](https://github.com/cosmos/cosmos/blob/master/WHITEPAPER.md#inter-blockchain-communication-ibc),
and then later described in more detail by the [IBC specification paper](https://github.com/cosmos/ibc/raw/master/CosmosIBCSpecification.pdf).
This documentation replaces and supersedes both. It explains the requirements and structure of the protocol and provides sufficient detail for both analysis and implementation, including example pseudocode.
## Contents
1. **[Overview](overview.md)**
1. Definitions
1. Threat Models
1. **[Proofs](proofs.md)**
1. Establishing a Root of Trust
1. Following Block Headers
1. **[Messaging Queue](queues.md)**
1. Merkle Proofs for Queues
1. Naming Queues
1. Message Contents
1. Sending a Packet
1. Receipts
1. Relay Process
1. **[Optimizations](optimizations.md)**
1. Cleanup
1. Timeout
1. Handling Byzantine Failures
1. **[Conclusion](conclusion.md)**
**[Appendix A: Encoding Libraries](appendix.md#appendix-a-encoding-libraries)**
**[Appendix B: IBC Queue Format](appendix.md#appendix-b-ibc-queue-format)**
**[Appendix C: Merkle Proof Format](appendix.md#appendix-c-merkle-proof-formats)**
**[Appendix D: Universal IBC Packets](appendix.md#appendix-d-universal-ibc-packets)**
**[Appendix E: Tendermint Header Proofs](appendix.md#appendix-e-tendermint-header-proofs)**