From 19d266df79cd765f6ad6925d4a6d950197756d12 Mon Sep 17 00:00:00 2001
From: diminator <dimi.dejonghe@gmail.com>
Date: Thu, 26 May 2016 10:33:27 +0200
Subject: [PATCH] escrow tutorial

---
 docs/source/_static/tx_schematics.odg         | Bin 12538 -> 17274 bytes
 docs/source/python-server-api-examples.md     | 212 +++++++++++++++++-
 .../doc/run_doc_python_server_api_examples.py |   4 +-
 3 files changed, 211 insertions(+), 5 deletions(-)

diff --git a/docs/source/_static/tx_schematics.odg b/docs/source/_static/tx_schematics.odg
index b66b138f728d0c0f01893a14eefda38a7681771d..fdb79cac17f40fe97e2f9534d44a587ebf881880 100644
GIT binary patch
literal 17274
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
Q#`}ZqU5-P?|NGtl2f7+&bpQYW

literal 12538
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
S1OSj<Uo5ZqVmbBCqyGhx@*V;J

diff --git a/docs/source/python-server-api-examples.md b/docs/source/python-server-api-examples.md
index d2534bb2..a912c146 100644
--- a/docs/source/python-server-api-examples.md
+++ b/docs/source/python-server-api-examples.md
@@ -894,7 +894,7 @@ hashlock_fulfill_tx
 ### Timeout Conditions
 
 Timeout conditions allow assets to expire after a certain time.
-The primary use case of timeout conditions is to enable Escrow (see further).
+The primary use case of timeout conditions is to enable [Escrow](#escrow).
 
 The condition can only be fulfilled before the expiry time. 
 Once expired, the asset is lost and cannot be fulfilled by anyone.
@@ -1036,17 +1036,18 @@ The above switch can be implemented as follows using threshold cryptoconditions:
   <img width="100%" height="100%" src ="./_static/cc_escrow_execute_abort.png" />
 </p>
 
-The small circle on the threshold conditions denotes an inversion of the fulfillment:
+The small circle (&#9898;) at an input of a threshold condition denotes an inversion of the fulfillment:
 
 ```python
 inverted_fulfillment.validate(msg) == not fulfillment.validate(msg)
 ```
 
-An inverted input to a threshold condition is simply obtained by using negative weights.
+An inverted input to a threshold condition is simply obtained by negative weights.
 
 __Note__: negative weights are BigchainDB-specific and not (yet) supported by the ILP standard.
 
-The following code snippet shows how to create an escrow condition
+
+The following code snippet shows how to create an escrow condition:
 
 ```python
 # Retrieve the last transaction of testuser2_pub
@@ -1093,4 +1094,207 @@ assert b.is_valid_transaction(tx_escrow_signed) == tx_escrow_signed
 
 b.write_transaction(tx_escrow_signed)
 tx_escrow_signed
+```
+
+```python
+{
+    "id":"1a281da2b9bc3d2beba92479058d440de3353427fd64045a61737bad0d0c809c",
+    "transaction":{
+        "conditions":[
+            {
+                "cid":0,
+                "condition":{
+                    "details":{
+                        "bitmask":41,
+                        "subfulfillments":[
+                            {
+                                "bitmask":41,
+                                "subfulfillments":[
+                                    {
+                                        "bitmask":32,
+                                        "public_key":"qv8DvdNG5nZHWCP5aPSqgqxAvaPJpQj19abRvFCntor",
+                                        "signature":null,
+                                        "type":"fulfillment",
+                                        "type_id":4,
+                                        "weight":1
+                                    },
+                                    {
+                                        "bitmask":9,
+                                        "expire_time":"1464242352.227917",
+                                        "type":"fulfillment",
+                                        "type_id":99,
+                                        "weight":1
+                                    }
+                                ],
+                                "threshold":2,
+                                "type":"fulfillment",
+                                "type_id":2,
+                                "weight":1
+                            },
+                            {
+                                "bitmask":41,
+                                "subfulfillments":[
+                                    {
+                                        "bitmask":32,
+                                        "public_key":"BwuhqQX8FPsmqYiRV2CSZYWWsSWgSSQQFHjqxKEuqkPs",
+                                        "signature":null,
+                                        "type":"fulfillment",
+                                        "type_id":4,
+                                        "weight":1
+                                    },
+                                    {
+                                        "bitmask":9,
+                                        "expire_time":"1464242352.227917",
+                                        "type":"fulfillment",
+                                        "type_id":99,
+                                        "weight":-1
+                                    }
+                                ],
+                                "threshold":2,
+                                "type":"fulfillment",
+                                "type_id":2,
+                                "weight":1
+                            }
+                        ],
+                        "threshold":1,
+                        "type":"fulfillment",
+                        "type_id":2
+                    },
+                    "uri":"cc:2:29:sg08ERtppQrGxot7mu7XMdNkZTc29xCbWE1r8DgxuL8:181"
+                },
+                "new_owners":[
+                    "BwuhqQX8FPsmqYiRV2CSZYWWsSWgSSQQFHjqxKEuqkPs",
+                    "qv8DvdNG5nZHWCP5aPSqgqxAvaPJpQj19abRvFCntor"
+                ]
+            }
+        ],
+        "data":null,
+        "fulfillments":[
+            {
+                "current_owners":[
+                    "qv8DvdNG5nZHWCP5aPSqgqxAvaPJpQj19abRvFCntor"
+                ],
+                "fid":0,
+                "fulfillment":"cf:4:B6VAa7KAMD1v-pyvDx9RuBLb6l2Qs3vhucgXqzU_RbuRucOp6tNY8AoNMoC-HAOZBJSnHXZsdJ7pLCZ6aDTwUHXf0zxyLaCgy1NpES3h8qcuxbfv4Nchw3BtUcVSY3AM",
+                "input":{
+                    "cid":1,
+                    "txid":"d3f5e78f6d4346466178745f1c01cbcaf1c1dce1932a16cd653051b16ee29bac"
+                }
+            }
+        ],
+        "operation":"TRANSFER",
+        "timestamp":"1464242340.227787"
+    },
+    "version":1
+}
+```
+
+At any given moment `testuser1` and `testuser2` can try to fulfill the `execute` and `abort` branch respectively.
+Whether the fulfillment will validate depends on the timeout condition.
+
+We'll illustrate this by example.
+
+In the case of `testuser1`, we create the `execute` fulfillment:
+
+```python
+# Create a base template for execute fulfillment
+tx_escrow_execute = b.create_transaction([testuser2_pub, testuser1_pub], testuser1_pub, {'txid': tx_escrow_signed['id'], 'cid': 0}, 'TRANSFER')
+
+# Parse the Escrow cryptocondition
+escrow_fulfillment = cc.Fulfillment.from_json(
+    tx_escrow['transaction']['conditions'][0]['condition']['details'])
+
+subfulfillment_testuser1 = escrow_fulfillment.get_subcondition_from_vk(testuser1_pub)[0]
+subfulfillment_testuser2 = escrow_fulfillment.get_subcondition_from_vk(testuser2_pub)[0]
+subfulfillment_timeout = escrow_fulfillment.subconditions[0]['body'].subconditions[1]['body']
+
+# Get the fulfillment message to sign
+tx_escrow_execute_fulfillment_message = \
+    util.get_fulfillment_message(tx_escrow_execute,
+                                 tx_escrow_execute['transaction']['fulfillments'][0],
+                                 serialized=True)
+
+# Clear the subconditions of the escrow fulfillment
+escrow_fulfillment.subconditions = []
+
+# Fulfill the execute branch
+fulfillment_execute = cc.ThresholdSha256Fulfillment(threshold=2)
+subfulfillment_testuser1.sign(tx_escrow_execute_fulfillment_message, crypto.SigningKey(testuser1_priv))
+fulfillment_execute.add_subfulfillment(subfulfillment_testuser1)
+fulfillment_execute.add_subfulfillment(subfulfillment_timeout)
+escrow_fulfillment.add_subfulfillment(fulfillment_execute)
+
+# Do not fulfill the abort branch
+condition_abort = cc.ThresholdSha256Fulfillment(threshold=2)
+condition_abort.add_subfulfillment(subfulfillment_testuser2)
+condition_abort.add_subfulfillment(subfulfillment_timeout, weight=-1)
+escrow_fulfillment.add_subcondition(condition_abort.condition)  # Adding only the condition here
+
+# Update the execute transaction with the fulfillment
+tx_escrow_execute['transaction']['fulfillments'][0]['fulfillment'] = escrow_fulfillment.serialize_uri()
+```
+
+In the case of `testuser2`, we create the `abort` fulfillment:
+
+```python
+# Create a base template for execute fulfillment
+tx_escrow_execute = b.create_transaction([testuser2_pub, testuser1_pub], testuser2_pub, {'txid': tx_escrow_signed['id'], 'cid': 0}, 'TRANSFER')
+
+# Parse the threshold cryptocondition
+escrow_fulfillment = cc.Fulfillment.from_json(
+    tx_escrow['transaction']['conditions'][0]['condition']['details'])
+
+subfulfillment_testuser1 = escrow_fulfillment.get_subcondition_from_vk(testuser1_pub)[0]
+subfulfillment_testuser2 = escrow_fulfillment.get_subcondition_from_vk(testuser2_pub)[0]
+subfulfillment_timeout = escrow_fulfillment.subconditions[0]['body'].subconditions[1]['body']
+
+# Get the fulfillment message to sign
+tx_escrow_abort_fulfillment_message = \
+    util.get_fulfillment_message(tx_escrow_abort,
+                                 tx_escrow_abort['transaction']['fulfillments'][0],
+                                 serialized=True)
+                                 
+# Clear the subconditions of the escrow fulfillment
+escrow_fulfillment.subconditions = []
+
+# Do not fulfill the execute branch
+condition_execute = cc.ThresholdSha256Fulfillment(threshold=2)
+condition_execute.add_subfulfillment(subfulfillment_testuser1)
+condition_execute.add_subfulfillment(subfulfillment_timeout)
+escrow_fulfillment.add_subcondition(condition_execute.condition) # Adding only the condition here
+
+# Fulfill the abort branch
+fulfillment_abort = cc.ThresholdSha256Fulfillment(threshold=2)
+subfulfillment_testuser2.sign(tx_escrow_abort_fulfillment_message, crypto.SigningKey(testuser2_priv))
+fulfillment_abort.add_subfulfillment(subfulfillment_testuser2)
+fulfillment_abort.add_subfulfillment(subfulfillment_timeout, weight=-1)
+escrow_fulfillment.add_subfulfillment(fulfillment_abort)
+
+# Update the abort transaction with the fulfillment
+tx_escrow_abort['transaction']['fulfillments'][0]['fulfillment'] = escrow_fulfillment.serialize_uri()
+```
+
+The following demonstrates that the transaction validation switches once the timeout occurs:
+
+```python
+for i in range(time_sleep - 4):
+    valid_execute = b.is_valid_transaction(tx_escrow_execute) == tx_escrow_execute
+    valid_abort = b.is_valid_transaction(tx_escrow_abort) == tx_escrow_abort
+
+    seconds_to_timeout = int(float(time_expire) - float(util.timestamp()))
+    print('tx_execute valid: {} - tx_abort valid {} ({}s to timeout)'.format(valid_execute, valid_abort, seconds_to_timeout))
+    sleep(1)
+```
+
+If you execute in a timely fashion, you should see the following:
+
+```python
+tx_execute valid: True - tx_abort valid False (3s to timeout)
+tx_execute valid: True - tx_abort valid False (2s to timeout)
+tx_execute valid: True - tx_abort valid False (1s to timeout)
+tx_execute valid: True - tx_abort valid False (0s to timeout)
+tx_execute valid: False - tx_abort valid True (0s to timeout)
+tx_execute valid: False - tx_abort valid True (-1s to timeout)
+tx_execute valid: False - tx_abort valid True (-2s to timeout)
+tx_execute valid: False - tx_abort valid True (-3s to timeout)
 ```
\ No newline at end of file
diff --git a/tests/doc/run_doc_python_server_api_examples.py b/tests/doc/run_doc_python_server_api_examples.py
index ee95ef3a..5ae9300f 100644
--- a/tests/doc/run_doc_python_server_api_examples.py
+++ b/tests/doc/run_doc_python_server_api_examples.py
@@ -481,5 +481,7 @@ tx_escrow_abort['transaction']['fulfillments'][0]['fulfillment'] = escrow_fulfil
 for i in range(time_sleep - 4):
     valid_execute = b.is_valid_transaction(tx_escrow_execute) == tx_escrow_execute
     valid_abort = b.is_valid_transaction(tx_escrow_abort) == tx_escrow_abort
-    print('execute: {} - abort {}'.format(valid_execute, valid_abort))
+
+    seconds_to_timeout = int(float(time_expire) - float(util.timestamp()))
+    print('tx_execute valid: {} - tx_abort valid {} ({}s to timeout)'.format(valid_execute, valid_abort, seconds_to_timeout))
     sleep(1)