Mirroristas/bigchaindb
2
0
Fork 0
mirror of https://github.com/bigchaindb/bigchaindb.git synced 2024-10-13 13:34:05 +00:00
Code Issues Packages Projects Releases Wiki Activity

Added clarity to TRANSFER Transactions section of the Transaction Concepts page

Browse Source
This commit is contained in:
troymc 2016-11-28 17:55:13 +01:00
parent 47fbd2b1ee
commit 95f605287f
1 changed files with 17 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
docs/root/source/transaction-concepts.md
View File

@ -15,7 +15,7 @@ one might register an identity or a creative work. The things are often called
BigchainDB supports divisible assets as of BigchainDB Server v0.8.0. BigchainDB supports divisible assets as of BigchainDB Server v0.8.0.
That means you can create/register an asset with an initial quantity, That means you can create/register an asset with an initial quantity,
e.g. 700 thumbtacks. Divisible assets can be split apart or recombined e.g. 700 oak trees. Divisible assets can be split apart or recombined
by transfer transactions (described more below). by transfer transactions (described more below).
A CREATE transaction also establishes the conditions that must be met to A CREATE transaction also establishes the conditions that must be met to
@ -28,21 +28,28 @@ Protocol (ILP)](https://interledger.org/).
## TRANSFER Transactions ## TRANSFER Transactions
A TRANSFER transaction can transfer an asset A TRANSFER transaction can transfer an asset
(or set of assets of the same type) by fulfilling the current conditions on the asset.
by fulfilling the current conditions on the asset(s).
It must also specify new transfer conditions. It must also specify new transfer conditions.
Example: Someone might construct a TRANSFER transaction **Example 1:** Suppose a red car is owned and controlled by Joe.
Suppose the current transfer condition on the car says
that any valid transfer must be signed by Joe.
Joe and a buyer named Rae could build a TRANSFER transaction containing
Joe's signature (to fulfill the current transfer condition)
plus a new transfer condition saying that any valid transfer
must be signed by Rae.
**Example 2:** Someone might construct a TRANSFER transaction
that fulfills the transfer conditions on four that fulfills the transfer conditions on four
previously-untransferred assets of the same asset type previously-untransferred assets of the same asset type
e.g. thumbtacks. The amounts might be 20, 10, 45 and 25, say, e.g. paperclips. The amounts might be 20, 10, 45 and 25, say,
for a total of 100 thumbtacks. for a total of 100 paperclips.
The TRANSFER transaction would also set up new transfer conditions. The TRANSFER transaction would also set up new transfer conditions.
For example, maybe a set of 60 thumbtacks can only be transferred For example, maybe a set of 60 paperclips can only be transferred
if Gertrude signs, and a separate set of 40 thumbtacks can only be if Gertrude signs, and a separate set of 40 paperclips can only be
transferred if both Jack and Kelly sign. transferred if both Jack and Kelly sign.
Note how the sum of the incoming thumbtacks must equal the sum Note how the sum of the incoming paperclips must equal the sum
of the outgoing thumbtacks (100). of the outgoing paperclips (100).
## Transaction Validity ## Transaction Validity