127 lines
4.6 KiB
Python
127 lines
4.6 KiB
Python
# Copyright © 2020 Interplanetary Database Association e.V.,
|
|
# BigchainDB and IPDB software contributors.
|
|
# SPDX-License-Identifier: (Apache-2.0 AND CC-BY-4.0)
|
|
# Code is Apache-2.0 and docs are CC-BY-4.0
|
|
|
|
# # Multiple owners integration testing
|
|
# This test checks if we can successfully create and transfer a transaction
|
|
# with multiple owners.
|
|
# The script tests various things like:
|
|
#
|
|
# - create a transaction with multiple owners
|
|
# - check if the transaction is stored and has the right amount of public keys
|
|
# - transfer the transaction to a third person
|
|
#
|
|
# We run a series of checks for each step, that is retrieving
|
|
# the transaction from the remote system, and also checking the public keys
|
|
# of a given transaction.
|
|
#
|
|
# This integration test is a rip-off of our
|
|
# [tutorial](https://docs.bigchaindb.com/projects/py-driver/en/latest/usage.html).
|
|
|
|
# ## Imports
|
|
# We need some utils from the `os` package, we will interact with
|
|
# env variables.
|
|
import os
|
|
|
|
# For this test case we import and use the Python Driver.
|
|
from bigchaindb_driver import BigchainDB
|
|
from bigchaindb_driver.crypto import generate_keypair
|
|
|
|
|
|
def test_multiple_owners():
|
|
# ## Set up a connection to BigchainDB
|
|
# Check [test_basic.py](./test_basic.html) to get some more details
|
|
# about the endpoint.
|
|
bdb = BigchainDB(os.environ.get('BIGCHAINDB_ENDPOINT'))
|
|
|
|
# Hey Alice and Bob, nice to see you again!
|
|
alice, bob = generate_keypair(), generate_keypair()
|
|
|
|
# ## Alice and Bob create a transaction
|
|
# Alice and Bob just moved into a shared flat, no one can afford these
|
|
# high rents anymore. Bob suggests to get a dish washer for the
|
|
# kitchen. Alice agrees and here they go, creating the asset for their
|
|
# dish washer.
|
|
dw_asset = {
|
|
'data': {
|
|
'dish washer': {
|
|
'serial_number': 1337
|
|
}
|
|
}
|
|
}
|
|
|
|
# They prepare a `CREATE` transaction. To have multiple owners, both
|
|
# Bob and Alice need to be the recipients.
|
|
prepared_dw_tx = bdb.transactions.prepare(
|
|
operation='CREATE',
|
|
signers=alice.public_key,
|
|
recipients=(alice.public_key, bob.public_key),
|
|
asset=dw_asset)
|
|
|
|
# Now they both sign the transaction by providing their private keys.
|
|
# And send it afterwards.
|
|
fulfilled_dw_tx = bdb.transactions.fulfill(
|
|
prepared_dw_tx,
|
|
private_keys=[alice.private_key, bob.private_key])
|
|
|
|
bdb.transactions.send_commit(fulfilled_dw_tx)
|
|
|
|
# We store the `id` of the transaction to use it later on.
|
|
dw_id = fulfilled_dw_tx['id']
|
|
|
|
# Let's check if the transaction was successful.
|
|
assert bdb.transactions.retrieve(dw_id), \
|
|
'Cannot find transaction {}'.format(dw_id)
|
|
|
|
# The transaction should have two public keys in the outputs.
|
|
assert len(
|
|
bdb.transactions.retrieve(dw_id)['outputs'][0]['public_keys']) == 2
|
|
|
|
# ## Alice and Bob transfer a transaction to Carol.
|
|
# Alice and Bob save a lot of money living together. They often go out
|
|
# for dinner and don't cook at home. But now they don't have any dishes to
|
|
# wash, so they decide to sell the dish washer to their friend Carol.
|
|
|
|
# Hey Carol, nice to meet you!
|
|
carol = generate_keypair()
|
|
|
|
# Alice and Bob prepare the transaction to transfer the dish washer to
|
|
# Carol.
|
|
transfer_asset = {'id': dw_id}
|
|
|
|
output_index = 0
|
|
output = fulfilled_dw_tx['outputs'][output_index]
|
|
transfer_input = {'fulfillment': output['condition']['details'],
|
|
'fulfills': {'output_index': output_index,
|
|
'transaction_id': fulfilled_dw_tx[
|
|
'id']},
|
|
'owners_before': output['public_keys']}
|
|
|
|
# Now they create the transaction...
|
|
prepared_transfer_tx = bdb.transactions.prepare(
|
|
operation='TRANSFER',
|
|
asset=transfer_asset,
|
|
inputs=transfer_input,
|
|
recipients=carol.public_key)
|
|
|
|
# ... and sign it with their private keys, then send it.
|
|
fulfilled_transfer_tx = bdb.transactions.fulfill(
|
|
prepared_transfer_tx,
|
|
private_keys=[alice.private_key, bob.private_key])
|
|
|
|
sent_transfer_tx = bdb.transactions.send_commit(fulfilled_transfer_tx)
|
|
|
|
# They check if the transaction was successful.
|
|
assert bdb.transactions.retrieve(
|
|
fulfilled_transfer_tx['id']) == sent_transfer_tx
|
|
|
|
# The owners before should include both Alice and Bob.
|
|
assert len(
|
|
bdb.transactions.retrieve(fulfilled_transfer_tx['id'])['inputs'][0][
|
|
'owners_before']) == 2
|
|
|
|
# While the new owner is Carol.
|
|
assert bdb.transactions.retrieve(fulfilled_transfer_tx['id'])[
|
|
'outputs'][0]['public_keys'][0] == carol.public_key
|