def unpack(self, data):
"""Unpack data into transaction object
Args:
data (bytes): packed binary data
Returns:
bool: True if successful
"""
ptr = 0
data_size = len(data)
try:
ptr, self.asset_group_id = bbclib_utils.get_bigint(ptr, data)
ptr, pt_num = bbclib_utils.get_n_byte_int(ptr, 2, data)
self.pointers = list()
for i in range(pt_num):
ptr, size = bbclib_utils.get_n_byte_int(ptr, 2, data)
ptr, ptdata = bbclib_utils.get_n_bytes(ptr, size, data)
if ptr >= data_size:
return False
pt = BBcPointer()
if not pt.unpack(ptdata):
return False
self.pointers.append(pt)
self.asset = None
ptr, astsize = bbclib_utils.get_n_byte_int(ptr, 4, data)
if astsize > 0:
self.asset = BBcAsset(id_length=self.id_length)
ptr, astdata = bbclib_utils.get_n_bytes(ptr, astsize, data)
if not self.asset.unpack(astdata):
return False
except:
return False
return True
def make_transaction(event_num=0,
relation_num=0,
witness=False,
id_length=DEFAULT_ID_LEN):
"""Utility to make transaction object
Args:
event_num (int): the number of BBcEvent object to include in the transaction
relation_num (int): the number of BBcRelation object to include in the transaction
witness (bool): If true, BBcWitness object is included in the transaction
id_length (int): If <32, IDs will be truncated
Returns:
BBcTransaction:
"""
transaction = BBcTransaction(id_length=id_length)
if event_num > 0:
for i in range(event_num):
evt = BBcEvent(id_length=id_length)
ast = BBcAsset(id_length=id_length)
evt.add(asset=ast)
transaction.add(event=evt)
if relation_num > 0:
for i in range(relation_num):
transaction.add(relation=BBcRelation(id_length=id_length))
if witness:
transaction.add(witness=BBcWitness(id_length=id_length))
return transaction
def unpack(self, data):
"""Unpack into this object
Args:
data (bytes): packed binary data
Returns:
bool: True if successful
"""
ptr = 0
data_size = len(data)
try:
ptr, self.asset_group_id = bbclib_utils.get_bigint(ptr, data)
ptr, ref_num = bbclib_utils.get_n_byte_int(ptr, 2, data)
self.reference_indices = []
for i in range(ref_num):
ptr, idx = bbclib_utils.get_n_byte_int(ptr, 2, data)
self.reference_indices.append(idx)
if ptr >= data_size:
return False
ptr, appr_num = bbclib_utils.get_n_byte_int(ptr, 2, data)
self.mandatory_approvers = []
for i in range(appr_num):
ptr, appr = bbclib_utils.get_bigint(ptr, data)
self.mandatory_approvers.append(appr)
if ptr >= data_size:
return False
ptr, self.option_approver_num_numerator = bbclib_utils.get_n_byte_int(
ptr, 2, data)
ptr, self.option_approver_num_denominator = bbclib_utils.get_n_byte_int(
ptr, 2, data)
self.option_approvers = []
for i in range(self.option_approver_num_denominator):
ptr, appr = bbclib_utils.get_bigint(ptr, data)
self.option_approvers.append(appr)
if ptr >= data_size:
return False
ptr, astsize = bbclib_utils.get_n_byte_int(ptr, 4, data)
ptr, astdata = bbclib_utils.get_n_bytes(ptr, astsize, data)
self.asset = BBcAsset(id_length=self.id_length)
self.asset.unpack(astdata)
except:
return False
return True
def add_event_asset(transaction,
event_idx,
asset_group_id,
user_id,
asset_body=None,
asset_file=None):
"""Utility to add BBcEvent object with BBcAsset in the transaction"""
ast = BBcAsset(user_id=user_id,
asset_file=asset_file,
asset_body=asset_body,
id_length=transaction.id_length)
transaction.events[event_idx].add(asset_group_id=asset_group_id, asset=ast)
def make_relation_with_asset(asset_group_id,
user_id,
asset_body=None,
asset_file=None,
id_length=DEFAULT_ID_LEN):
"""Utility to make BBcRelation object"""
relation = BBcRelation(id_length=id_length)
ast = BBcAsset(user_id=user_id,
asset_file=asset_file,
asset_body=asset_body,
id_length=id_length)
relation.add(asset_group_id=asset_group_id, asset=ast)
return relation
def add_relation_asset(transaction,
relation_idx,
asset_group_id,
user_id,
asset_body=None,
asset_file=None):
"""Utility to add BBcRelation object with BBcAsset in the transaction"""
ast = BBcAsset(user_id=user_id,
asset_file=asset_file,
asset_body=asset_body,
id_length=transaction.id_length)
transaction.relations[relation_idx].add(asset_group_id=asset_group_id,
asset=ast)
class BBcRelation:
"""Relation part in a transaction"""
def __init__(self, asset_group_id=None, id_length=DEFAULT_ID_LEN):
self.id_length = id_length
if asset_group_id is not None and id_length < 32:
self.asset_group_id = asset_group_id[:id_length]
else:
self.asset_group_id = asset_group_id
self.pointers = list()
self.asset = None
def __str__(self):
ret = " asset_group_id: %s\n" % bbclib_utils.str_binary(
self.asset_group_id)
if len(self.pointers) > 0:
ret += " Pointers[]: %d\n" % len(self.pointers)
for i, pt in enumerate(self.pointers):
ret += " [%d]\n" % i
ret += str(pt)
ret += str(self.asset)
return ret
def add(self, asset_group_id=None, asset=None, pointer=None):
"""Add parts"""
if asset_group_id is not None:
self.asset_group_id = asset_group_id[:self.id_length]
if pointer is not None:
if isinstance(pointer, list):
self.pointers.extend(pointer)
else:
self.pointers.append(pointer)
if asset is not None:
self.asset = asset
return True
def pack(self):
"""Pack this object
Returns:
bytes: packed binary data
"""
dat = bytearray(
bbclib_utils.to_bigint(self.asset_group_id, size=self.id_length))
dat.extend(bbclib_utils.to_2byte(len(self.pointers)))
for i in range(len(self.pointers)):
pt = self.pointers[i].pack()
dat.extend(bbclib_utils.to_2byte(len(pt)))
dat.extend(pt)
if self.asset is not None:
ast = self.asset.pack()
dat.extend(bbclib_utils.to_4byte(len(ast)))
dat.extend(ast)
else:
dat.extend(bbclib_utils.to_4byte(0))
return bytes(dat)
def unpack(self, data):
"""Unpack data into transaction object
Args:
data (bytes): packed binary data
Returns:
bool: True if successful
"""
ptr = 0
data_size = len(data)
try:
ptr, self.asset_group_id = bbclib_utils.get_bigint(ptr, data)
ptr, pt_num = bbclib_utils.get_n_byte_int(ptr, 2, data)
self.pointers = list()
for i in range(pt_num):
ptr, size = bbclib_utils.get_n_byte_int(ptr, 2, data)
ptr, ptdata = bbclib_utils.get_n_bytes(ptr, size, data)
if ptr >= data_size:
return False
pt = BBcPointer()
if not pt.unpack(ptdata):
return False
self.pointers.append(pt)
self.asset = None
ptr, astsize = bbclib_utils.get_n_byte_int(ptr, 4, data)
if astsize > 0:
self.asset = BBcAsset(id_length=self.id_length)
ptr, astdata = bbclib_utils.get_n_bytes(ptr, astsize, data)
if not self.asset.unpack(astdata):
return False
except:
return False
return True
class BBcEvent:
"""Event part in a transaction"""
def __init__(self, asset_group_id=None, id_length=DEFAULT_ID_LEN):
self.id_length = id_length
if asset_group_id is not None and id_length < 32:
self.asset_group_id = asset_group_id[:id_length]
else:
self.asset_group_id = asset_group_id
self.reference_indices = []
self.mandatory_approvers = []
self.option_approver_num_numerator = 0
self.option_approver_num_denominator = 0
self.option_approvers = []
self.asset = None
def __str__(self):
ret = " asset_group_id: %s\n" % bbclib_utils.str_binary(
self.asset_group_id)
ret += " reference_indices: %s\n" % self.reference_indices
ret += " mandatory_approvers:\n"
if len(self.mandatory_approvers) > 0:
for user in self.mandatory_approvers:
ret += " - %s\n" % bbclib_utils.str_binary(user)
else:
ret += " - None\n"
ret += " option_approvers:\n"
if len(self.option_approvers) > 0:
for user in self.option_approvers:
ret += " - %s\n" % bbclib_utils.str_binary(user)
else:
ret += " - None\n"
ret += " option_approver_num_numerator: %d\n" % self.option_approver_num_numerator
ret += " option_approver_num_denominator: %d\n" % self.option_approver_num_denominator
ret += str(self.asset)
return ret
def add(self,
asset_group_id=None,
reference_index=None,
mandatory_approver=None,
option_approver_num_numerator=0,
option_approver_num_denominator=0,
option_approver=None,
asset=None):
"""Add parts"""
if asset_group_id is not None:
self.asset_group_id = asset_group_id[:self.id_length]
if reference_index is not None:
self.reference_indices.append(reference_index)
if mandatory_approver is not None:
self.mandatory_approvers.append(
mandatory_approver[:self.id_length])
if option_approver_num_numerator > 0:
self.option_approver_num_numerator = option_approver_num_numerator
if option_approver_num_denominator > 0:
self.option_approver_num_denominator = option_approver_num_denominator
if option_approver is not None:
self.option_approvers.append(option_approver[:self.id_length])
if asset is not None:
self.asset = asset
return True
def pack(self):
"""Pack this object
Returns:
bytes: packed binary data
"""
dat = bytearray(
bbclib_utils.to_bigint(self.asset_group_id, size=self.id_length))
dat.extend(bbclib_utils.to_2byte(len(self.reference_indices)))
for i in range(len(self.reference_indices)):
dat.extend(bbclib_utils.to_2byte(self.reference_indices[i]))
dat.extend(bbclib_utils.to_2byte(len(self.mandatory_approvers)))
for i in range(len(self.mandatory_approvers)):
dat.extend(
bbclib_utils.to_bigint(self.mandatory_approvers[i],
size=self.id_length))
dat.extend(bbclib_utils.to_2byte(self.option_approver_num_numerator))
dat.extend(bbclib_utils.to_2byte(self.option_approver_num_denominator))
for i in range(self.option_approver_num_denominator):
dat.extend(
bbclib_utils.to_bigint(self.option_approvers[i],
size=self.id_length))
ast = self.asset.pack()
dat.extend(bbclib_utils.to_4byte(len(ast)))
dat.extend(ast)
return bytes(dat)
def unpack(self, data):
"""Unpack into this object
Args:
data (bytes): packed binary data
Returns:
bool: True if successful
"""
ptr = 0
data_size = len(data)
try:
ptr, self.asset_group_id = bbclib_utils.get_bigint(ptr, data)
ptr, ref_num = bbclib_utils.get_n_byte_int(ptr, 2, data)
self.reference_indices = []
for i in range(ref_num):
ptr, idx = bbclib_utils.get_n_byte_int(ptr, 2, data)
self.reference_indices.append(idx)
if ptr >= data_size:
return False
ptr, appr_num = bbclib_utils.get_n_byte_int(ptr, 2, data)
self.mandatory_approvers = []
for i in range(appr_num):
ptr, appr = bbclib_utils.get_bigint(ptr, data)
self.mandatory_approvers.append(appr)
if ptr >= data_size:
return False
ptr, self.option_approver_num_numerator = bbclib_utils.get_n_byte_int(
ptr, 2, data)
ptr, self.option_approver_num_denominator = bbclib_utils.get_n_byte_int(
ptr, 2, data)
self.option_approvers = []
for i in range(self.option_approver_num_denominator):
ptr, appr = bbclib_utils.get_bigint(ptr, data)
self.option_approvers.append(appr)
if ptr >= data_size:
return False
ptr, astsize = bbclib_utils.get_n_byte_int(ptr, 4, data)
ptr, astdata = bbclib_utils.get_n_bytes(ptr, astsize, data)
self.asset = BBcAsset(id_length=self.id_length)
self.asset.unpack(astdata)
except:
return False
return True