Ledger
Summary

- The ledger is subjective from each peer’s perspective
- Two peers are always guaranteed to see the exact same version of any on-ledger facts they share
Video

Ledger Data

In Corda, there is no single central store of data. Instead, each node maintains its own database of those facts that it is aware of.
The facts that a node knows about are those that it is involved with. For example, if there are nodes representing Alice and Bob on the network and Alice loans Bob some money, both Alice and Bob will store an identical record of the facts about that loan. If the only parties involved with the loan are Alice and Bob, then they will be the only nodes that ever see or store this data.
Important: The result of this design is that each peer only sees a subset of facts on the ledger, and no peer is aware of the ledger in its entirety.
Example: A network with five nodes, where each numbered circle on an intersection represents a fact shared between two or more nodes.
Notably, in this Venn diagram, Alice only shares facts with Bob. Alice does not share facts with any of Carl, Demi or Ed.
Summary
The Corda Ledger is a subjective construct from each peer’s point of view.
What does that mean?
- There are no omniscient peers who can see everything on the ledger.
- Each node sees their own facts, and the facts that they share with others.
For example, Alice and Demi don’t share any facts, so they each see a completely different set of shared facts.
Shared Facts

In the previous diagram, we could see that although Carl, Demi and Ed are aware of shared fact 3, Alice and Bob are not.
On Corda, there is no central or general ledger operating with agency on behalf of all of the nodes on the network. Instead, each node on the network maintains its own vault containing all of its known facts.
You can think of this vault as being a database or simple table.
Corda guarantees that whenever one of these facts is shared by multiple nodes on the network, it evolves in lockstep in the database of every node that is aware of it. This means that Alice and Bob will both see an exactly identical version of shared facts 1 and 7.
Note: Not all on-ledger facts are shared between peers. For example, Alice’s fact 11 is not shared with Bob. Fact 11 could, in fact, not be shared with any other node at all. If this is the case, it is deemed a unilateral fact.
Note: Although there is no central ledger, it is possible to broadcast a basic fact to all participants should you wish to. You would do this by using the network map service to loop over all parties.
Was this page helpful?
Thanks for your feedback!
Chat with us
Chat with us on our #docs channel on slack. You can also join a lot of other slack channels there and have access to 1-on-1 communication with members of the R3 team and the online community.
Propose documentation improvements directly
Help us to improve the docs by contributing directly. It's simple - just fork this repository and raise a PR of your own - R3's Technical Writers will review it and apply the relevant suggestions.
We're sorry this page wasn't helpful. Let us know how we can make it better!
Chat with us
Chat with us on our #docs channel on slack. You can also join a lot of other slack channels there and have access to 1-on-1 communication with members of the R3 team and the online community.
Create an issue
Create a new GitHub issue in this repository - submit technical feedback, draw attention to a potential documentation bug, or share ideas for improvement and general feedback.
Propose documentation improvements directly
Help us to improve the docs by contributing directly. It's simple - just fork this repository and raise a PR of your own - R3's Technical Writers will review it and apply the relevant suggestions.