From f7233c46f6de1a07c153b1252733a2e8810d0cf6 Mon Sep 17 00:00:00 2001 From: troymc Date: Thu, 9 Jun 2016 12:04:37 +0200 Subject: [PATCH] Docs: Added section on why BCBB good for assets --- docs/source/introduction.md | 2 +- docs/source/topic-guides/assets.md | 13 +++++++++++++ docs/source/topic-guides/index.rst | 1 + 3 files changed, 15 insertions(+), 1 deletion(-) create mode 100644 docs/source/topic-guides/assets.md diff --git a/docs/source/introduction.md b/docs/source/introduction.md index 1f029fbc..c78a7358 100644 --- a/docs/source/introduction.md +++ b/docs/source/introduction.md @@ -1,6 +1,6 @@ # Introduction -BigchainDB is a scalable blockchain database. That is, it's a "big data" database with some blockchain characteristics, including decentralization, immutability and native support for assets. +BigchainDB is a scalable blockchain database. That is, it's a "big data" database with some blockchain characteristics, including [decentralization](topic-guides/decentralized.html), [immutability](topic-guides/immutable.html) and [native support for assets](topic-guides/assets.html). You can read about the motivations, goals and high-level architecture in the [BigchainDB whitepaper](https://www.bigchaindb.com/whitepaper/). diff --git a/docs/source/topic-guides/assets.md b/docs/source/topic-guides/assets.md new file mode 100644 index 00000000..dc736ad2 --- /dev/null +++ b/docs/source/topic-guides/assets.md @@ -0,0 +1,13 @@ +# How BigchainDB is Good for Asset Registrations & Transfers + +BigchainDB can store data of any kind (within reason), but it's designed to be particularly good for storing asset registrations and transfers: + +* The fundamental thing that one submits to a BigchainDB federation to be checked and stored (if valid) is a _transaction_, and there are two kinds: creation transactions and transfer transactions +* A creation transaction can be use to register any kind of indivisible asset, along with arbitrary metadata +* An asset can have zero, one, or several owners +* The owners of an asset can specify (crypto-)conditions which must be satisified by anyone wishing transfer the asset to new owners (typically at least m signatures from the n current owners) +* BigchainDB verifies that the conditions have been satisified as part of checking the validity of transfer transactions. (Moreover, anyone can check that they were satisfied.) +* BigchainDB prevents double-spending of an asset +* Validated transactions are strongly tamper-resistant; see [the section about immutability / tamper-resistance](immutable.html) + +You can read more about the details of BigchainDB transactions in [the section on Transaction, Block and Vote Models (data models)](models.html). diff --git a/docs/source/topic-guides/index.rst b/docs/source/topic-guides/index.rst index 274cfe04..309620e2 100644 --- a/docs/source/topic-guides/index.rst +++ b/docs/source/topic-guides/index.rst @@ -12,4 +12,5 @@ Topic guides give background and explain concepts at a high level. decentralized diversity immutable + assets models