def deserialize_token_info(cls, buf: bytes, *, verbose: VerboseCallback = None) -> Tuple[str, str, bytes]:
""" Gets the token name and symbol from serialized format
"""
(token_info_version,), buf = unpack('!B', buf)
if verbose:
verbose('token_info_version', token_info_version)
if token_info_version != TOKEN_INFO_VERSION:
raise ValueError('unknown token info version: {}'.format(token_info_version))
(name_len,), buf = unpack('!B', buf)
if verbose:
verbose('token_name_len', name_len)
name, buf = unpack_len(name_len, buf)
if verbose:
verbose('token_name', name)
(symbol_len,), buf = unpack('!B', buf)
if verbose:
verbose('token_symbol_len', symbol_len)
symbol, buf = unpack_len(symbol_len, buf)
if verbose:
verbose('token_symbol', symbol)
# Token name and symbol can be only utf-8 valid strings for now
decoded_name = decode_string_utf8(name, 'Token name')
decoded_symbol = decode_string_utf8(symbol, 'Token symbol')
return decoded_name, decoded_symbol, buf
def create_from_bytes(cls, buf: bytes) -> Tuple['TxInput', bytes]:
""" Creates a TxInput from a serialized input. Returns the input
and remaining bytes
"""
input_tx_id, buf = unpack_len(TX_HASH_SIZE, buf)
(input_index, data_len), buf = unpack('!BH', buf)
input_data, buf = unpack_len(data_len, buf)
txin = cls(input_tx_id, input_index, input_data)
return txin, buf
def get_funds_fields_from_struct(self, buf: bytes) -> bytes:
""" Gets all funds fields for a transaction from a buffer.
:param buf: Bytes of a serialized transaction
:type buf: bytes
:return: A buffer containing the remaining struct bytes
:rtype: bytes
:raises ValueError: when the sequence of bytes is incorect
"""
(self.version, tokens_len, inputs_len,
outputs_len), buf = unpack(_FUNDS_FORMAT_STRING, buf)
for _ in range(tokens_len):
token_uid, buf = unpack_len(TX_HASH_SIZE, buf)
self.tokens.append(token_uid)
for _ in range(inputs_len):
txin, buf = TxInput.create_from_bytes(buf)
self.inputs.append(txin)
for _ in range(outputs_len):
txout, buf = TxOutput.create_from_bytes(buf)
self.outputs.append(txout)
return buf
def create_from_bytes(cls, buf: bytes) -> Tuple['TxOutput', bytes]:
""" Creates a TxOutput from a serialized output. Returns the output
and remaining bytes
"""
value, buf = bytes_to_output_value(buf)
(token_data, script_len), buf = unpack('!BH', buf)
script, buf = unpack_len(script_len, buf)
txout = cls(value, script, token_data)
return txout, buf
def get_graph_fields_from_struct(self, buf: bytes) -> bytes:
""" Gets graph fields for a block from a buffer.
:param buf: Bytes of a serialized transaction
:type buf: bytes
:return: A buffer containing the remaining struct bytes
:rtype: bytes
:raises ValueError: when the sequence of bytes is incorect
"""
buf = super().get_graph_fields_from_struct(buf)
(data_bytes, ), buf = unpack('!B', buf)
self.data, buf = unpack_len(data_bytes, buf)
return buf
def get_graph_fields_from_struct(self, buf: bytes) -> bytes:
""" Gets all common graph fields for a Transaction and a Block from a buffer.
:param buf: Bytes of a serialized transaction
:type buf: bytes
:return: A buffer containing the remaining struct bytes
:rtype: bytes
:raises ValueError: when the sequence of bytes is incorect
"""
(self.weight, self.timestamp,
parents_len), buf = unpack(_GRAPH_FORMAT_STRING, buf)
for _ in range(parents_len):
parent, buf = unpack_len(TX_HASH_SIZE, buf) # 256bits
self.parents.append(parent)
return buf
def get_graph_fields_from_struct(self,
buf: bytes,
*,
verbose: VerboseCallback = None) -> bytes:
""" Gets graph fields for a block from a buffer.
:param buf: Bytes of a serialized transaction
:type buf: bytes
:return: A buffer containing the remaining struct bytes
:rtype: bytes
:raises ValueError: when the sequence of bytes is incorect
"""
buf = super().get_graph_fields_from_struct(buf, verbose=verbose)
(data_bytes, ), buf = unpack('!B', buf)
if verbose:
verbose('data_len', data_bytes)
self.data, buf = unpack_len(data_bytes, buf)
if verbose:
verbose('data', self.data.hex())
return buf