ExternalVendorCode/corda
1
0
Fork 0
mirror of https://github.com/corda/corda.git synced 2024-12-21 13:57:54 +00:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity

Docs: Add a section on what data is visible to notaries (#3159)

Browse Source
This commit is contained in:
Andrius Dagys 2018-05-23 08:59:58 +01:00 committed by GitHub
parent c943a4d46b
commit 57fce1dd16
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 28 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
docs/source/key-concepts-notaries.rst
View File

@ -66,6 +66,34 @@ created the "denial of state" transaction, allowing the attack to be resolved of
In the case of the validating model, the use of anonymous, freshly-generated public keys instead of legal identities to
identify parties in a transaction limit the information the notary cluster sees.
Data visibility
^^^^^^^^^^^^^^^
Below is a summary of what specific transaction components have to be revealed to each type of notary:
+-----------------------------------+---------------+-----------------------+
| Transaction components | Validating | Non-validating |
+===================================+===============+=======================+
| Input states | Fully visible | References only [1]_ |
+-----------------------------------+---------------+-----------------------+
| Output states | Fully visible | Hidden |
+-----------------------------------+---------------+-----------------------+
| Commands (with signer identities) | Fully visible | Hidden |
+-----------------------------------+---------------+-----------------------+
| Attachments | Fully visible | Hidden |
+-----------------------------------+---------------+-----------------------+
| Time window | Fully visible | Fully visible |
+-----------------------------------+---------------+-----------------------+
| Notary identity | Fully visible | Fully visible |
+-----------------------------------+---------------+-----------------------+
| Signatures | Fully visible | Hidden |
+-----------------------------------+---------------+-----------------------+
Both types of notaries record the calling party's identity: the public key and the X.500 Distinguished Name.
.. [1] A state reference is composed of the issuing transaction's id and the state's position in the outputs. It does not
reveal what kind of state it is or its contents.
Multiple notaries
-----------------
Each Corda network can have multiple notary clusters, each potentially running a different consensus algorithm. This