def from_bytes(b):
""" Deserializes a byte stream into a TransactionInput.
Args:
b (bytes): byte stream starting with the outpoint.
Returns:
tuple: First element of the tuple is the TransactionInput
object and the second is the remaining byte stream.
"""
outpoint = b[0:32]
outpoint_index, b1 = unpack_u32(b[32:])
script, b1 = Script.from_bytes(b1)
sequence_num, b1 = unpack_u32(b1)
return (TransactionInput(Hash(outpoint), outpoint_index, script, sequence_num), b1)
def from_bytes(b):
""" Deserializes a byte stream into a TransactionInput.
Args:
b (bytes): byte stream starting with the outpoint.
Returns:
tuple: First element of the tuple is the TransactionInput
object and the second is the remaining byte stream.
"""
outpoint = b[0:32]
outpoint_index, b1 = unpack_u32(b[32:])
script, b1 = Script.from_bytes(b1)
sequence_num, b1 = unpack_u32(b1)
return (TransactionInput(Hash(outpoint), outpoint_index, script,
sequence_num), b1)
def get_utxos(self, address_list):
""" Provides all unspent transactions associated with each address in
the address_list.
Args:
address_list (list(str)): List of Base58Check encoded Bitcoin
addresses.
Returns:
dict: A dict keyed by address with each value being a list of
UnspentTransactionOutput objects.
"""
ret = defaultdict(list)
for addresses in self._list_chunks(address_list, 199):
r = self._request("GET", "addresses/" + ",".join(addresses)
+ "/unspents")
data = r.json()
# for each address
# {
# "transaction_hash": "0bf0de38c261...",
# "output_index": 0,
# "value": 290000,
# "addresses": [
# "1K4nPxBMy6sv7jssTvDLJWk1ADHBZEoUVb"
# ],
# "script": "OP_DUP OP_HASH160 c6296...",
# "script_hex": "76a914c629680b8d1...",
# "script_type": "pubkeyhash",
# "required_signatures": 1,
# "spent": false,
# "confirmations": 8758
# },
for d in data:
address = d["addresses"][0]
txn_hash = Hash(d["transaction_hash"])
script, _ = Script.from_bytes(
pack_var_str(bytes.fromhex(d["script_hex"])))
ret[address].append(UnspentTransactionOutput(txn_hash,
d["output_index"],
d["value"],
script,
d["confirmations"]))
return ret
def txn_from_json(txn_json):
# {
# "hash": "0bf0de38c26195919179f...",
# "block_hash": "000000000000000...",
# "block_height": 303404,
# "block_time": "2014-05-30T23:54:55Z",
# "chain_received_at": "2015-08-13T10:52:21.718Z",
# "confirmations": 69389,
# "lock_time": 0,
# "inputs": [
# {
# "transaction_hash": "0bf0de38c2619...",
# "output_hash": "b84a66c46e24fe71f9...",
# "output_index": 0,
# "value": 300000,
# "addresses": [
# "3L7dKYQGNoZub928CJ8NC2WfrM8U8GGBjr"
# ],
# "script_signature": "03046022100de7b67b9...",
# "script_signature_hex": "00493046022100de7b...",
# "sequence": 4294967295
# }
# ],
# "outputs": [
# {
# "transaction_hash": "0bf0de38c261959...",
# "output_index": 0,
# "value": 290000,
# "addresses": [
# "1K4nPxBMy6sv7jssTvDLJWk1ADHBZEoUVb"
# ],
# "script": "OP_DUP OP_HASH160 c629680b8d...",
# "script_hex": "76a914c629680b8d13...",
# "script_type": "pubkeyhash",
# "required_signatures": 1,
# "spent": false,
# "spending_transaction": null
# }
# ],
# "fees": 10000,
# "amount": 290000
# },
# Transaction.DEFAULT_TRANSACTION_VERSION
inputs = []
outputs = []
addr_keys = set()
for i in txn_json["inputs"]:
# Chain doesn't return the stuff about script length etc, so
# we need to prepend that.
script, _ = Script.from_bytes(
pack_var_str(bytes.fromhex(i["script_signature_hex"])))
inputs.append(TransactionInput(Hash(i["output_hash"]),
i["output_index"],
script,
i["sequence"]))
if "addresses" in i:
addr_keys.add(i["addresses"][0])
for i in txn_json["outputs"]:
script, _ = Script.from_bytes(
pack_var_str(bytes.fromhex(i["script_hex"])))
outputs.append(TransactionOutput(i["value"],
script))
if "addresses" in i:
addr_keys.add(i["addresses"][0])
txn = Transaction(Transaction.DEFAULT_TRANSACTION_VERSION,
inputs,
outputs,
txn_json["lock_time"])
return txn, addr_keys
def txn_from_json(txn_json):
""" Returns a new Transaction from a JSON-serialized transaction
Args:
txn_json: JSON with the following format:
{
"hash": "0bf0de38c26195919179f...",
"block_hash": "000000000000000...",
"block_height": 303404,
"block_time": "2014-05-30T23:54:55Z",
"chain_received_at": "2015-08-13T10:52:21.718Z",
"confirmations": 69389,
"lock_time": 0,
"inputs": [
{
"transaction_hash": "0bf0de38c2619...",
"output_hash": "b84a66c46e24fe71f9...",
"output_index": 0,
"value": 300000,
"addresses": [
"3L7dKYQGNoZub928CJ8NC2WfrM8U8GGBjr"
],
"script_signature": "03046022100de7b67b9...",
"script_signature_hex": "00493046022100de7b...",
"sequence": 4294967295
}
],
"outputs": [
{
"transaction_hash": "0bf0de38c261959...",
"output_index": 0,
"value": 290000,
"addresses": [
"1K4nPxBMy6sv7jssTvDLJWk1ADHBZEoUVb"
],
"script": "OP_DUP OP_HASH160 c629680b8d...",
"script_hex": "76a914c629680b8d13...",
"script_type": "pubkeyhash",
"required_signatures": 1,
"spent": false,
"spending_transaction": null
}
],
"fees": 10000,
"amount": 290000
},
Transaction.DEFAULT_TRANSACTION_VERSION
Returns:
two1.lib.bitcoin.Transaction: a deserialized transaction derived
from the provided json.
"""
inputs = []
outputs = []
addr_keys = set()
for i in txn_json["inputs"]:
if 'coinbase' in i:
inputs.append(
CoinbaseInput(height=txn_json["block_height"] or 0,
raw_script=bytes.fromhex(i['coinbase']),
sequence=i['sequence'],
block_version=1))
else:
# Script length etc. are not returned so we need to
# prepend that.
script, _ = Script.from_bytes(
pack_var_str(bytes.fromhex(i["script_signature_hex"])))
inputs.append(
TransactionInput(Hash(i["output_hash"]), i["output_index"],
script, i["sequence"]))
if "addresses" in i:
addr_keys.add(i["addresses"][0])
for i in txn_json["outputs"]:
script, _ = Script.from_bytes(
pack_var_str(bytes.fromhex(i["script_hex"])))
outputs.append(TransactionOutput(i["value"], script))
if "addresses" in i:
addr_keys.add(i["addresses"][0])
txn = Transaction(Transaction.DEFAULT_TRANSACTION_VERSION, inputs,
outputs, txn_json["lock_time"])
return txn, addr_keys
def txn_from_json(txn_json):
"""
Args:
txn_json: Json with the following format:
{
"block_hash": "0000000000000000af64802c79...",
"block_height": 292586,
"hash": "b4735a0690dab16b8789fceaf81c511f...",
"addresses": [
"18KXZzuC3xvz6upUMQpsZzXrBwNPWZjdSa",
"1AAuRETEcHDqL4VM3R97aZHP8DSUHxpkFV",
"1DEP8i3QJCsomS4BSMY2RpU1upv62aGvhD",
"1VxsEDjo6ZLMT99dpcLu4RQonMDVEQQTG"
],
"total": 3537488,
"fees": 20000,
"size": 438,
"preference": "medium",
"relayed_by": "",
"confirmed": "2014-03-26T17:08:04Z",
"received": "2014-03-26T17:08:04Z",
"ver": 1,
"lock_time": 0,
"double_spend": false,
"vin_sz": 2,
"vout_sz": 2,
"confirmations": 64492,
"confidence": 1,
"inputs": [
{
"prev_hash": "729f6469b59fea5da7...",
"output_index": 0,
"script": "483045022100d06cdad1a...",
"output_value": 3500000,
"sequence": 4294967295,
"addresses": [
"1VxsEDjo6ZLMT99dpcLu4RQonMDVEQQTG"
],
"script_type": "pay-to-pubkey-hash"
},
...
],
"outputs": [
{
"value": 3500000,
"script": "76a9148629647bd642a237...",
"addresses": [
"1DEP8i3QJCsomS4BSMY2RpU1upv62aGvhD"
],
"script_type": "pay-to-pubkey-hash"
}
]...
Returns: An Object of type Transaction
"""
inputs = []
outputs = []
addr_keys = set()
for i in txn_json["inputs"]:
# Chain doesn't return the stuff about script length etc, so
# we need to prepend that.
script, _ = Script.from_bytes(
pack_var_str(bytes.fromhex(i["script"])))
inputs.append(
TransactionInput(Hash(i["prev_hash"]), i["output_index"],
script, i["sequence"]))
if "addresses" in i and i["addresses"]:
addr_keys.add(i["addresses"][0])
for i in txn_json["outputs"]:
script, _ = Script.from_bytes(
pack_var_str(bytes.fromhex(i["script"])))
outputs.append(TransactionOutput(i["value"], script))
if "addresses" in i and i["addresses"]:
addr_keys.add(i["addresses"][0])
txn = Transaction(Transaction.DEFAULT_TRANSACTION_VERSION, inputs,
outputs, txn_json["lock_time"])
return txn, addr_keys
def txn_from_json(txn_json):
""" Returns a new Transaction from a JSON-serialized transaction
Args:
txn_json: JSON with the following format:
{
"hash": "0bf0de38c26195919179f...",
"block_hash": "000000000000000...",
"block_height": 303404,
"block_time": "2014-05-30T23:54:55Z",
"chain_received_at": "2015-08-13T10:52:21.718Z",
"confirmations": 69389,
"lock_time": 0,
"inputs": [
{
"transaction_hash": "0bf0de38c2619...",
"output_hash": "b84a66c46e24fe71f9...",
"output_index": 0,
"value": 300000,
"addresses": [
"3L7dKYQGNoZub928CJ8NC2WfrM8U8GGBjr"
],
"script_signature": "03046022100de7b67b9...",
"script_signature_hex": "00493046022100de7b...",
"sequence": 4294967295
}
],
"outputs": [
{
"transaction_hash": "0bf0de38c261959...",
"output_index": 0,
"value": 290000,
"addresses": [
"1K4nPxBMy6sv7jssTvDLJWk1ADHBZEoUVb"
],
"script": "OP_DUP OP_HASH160 c629680b8d...",
"script_hex": "76a914c629680b8d13...",
"script_type": "pubkeyhash",
"required_signatures": 1,
"spent": false,
"spending_transaction": null
}
],
"fees": 10000,
"amount": 290000
},
Transaction.DEFAULT_TRANSACTION_VERSION
Returns:
two1.lib.bitcoin.Transaction: a deserialized transaction derived
from the provided json.
"""
inputs = []
outputs = []
addr_keys = set()
for i in txn_json["inputs"]:
if 'coinbase' in i:
inputs.append(
CoinbaseInput(
height=txn_json["block_height"] or 0,
raw_script=bytes.fromhex(i['coinbase']),
sequence=i['sequence'],
block_version=1))
else:
# Script length etc. are not returned so we need to
# prepend that.
script, _ = Script.from_bytes(
pack_var_str(bytes.fromhex(i["script_signature_hex"])))
inputs.append(TransactionInput(Hash(i["output_hash"]),
i["output_index"],
script,
i["sequence"]))
if "addresses" in i:
addr_keys.add(i["addresses"][0])
for i in txn_json["outputs"]:
script, _ = Script.from_bytes(
pack_var_str(bytes.fromhex(i["script_hex"])))
outputs.append(TransactionOutput(i["value"],
script))
if "addresses" in i:
addr_keys.add(i["addresses"][0])
txn = Transaction(Transaction.DEFAULT_TRANSACTION_VERSION,
inputs,
outputs,
txn_json["lock_time"])
return txn, addr_keys
def txn_from_json(txn_json):
"""
Args:
txn_json: Json with the following format:
{
"block_hash": "0000000000000000af64802c79...",
"block_height": 292586,
"hash": "b4735a0690dab16b8789fceaf81c511f...",
"addresses": [
"18KXZzuC3xvz6upUMQpsZzXrBwNPWZjdSa",
"1AAuRETEcHDqL4VM3R97aZHP8DSUHxpkFV",
"1DEP8i3QJCsomS4BSMY2RpU1upv62aGvhD",
"1VxsEDjo6ZLMT99dpcLu4RQonMDVEQQTG"
],
"total": 3537488,
"fees": 20000,
"size": 438,
"preference": "medium",
"relayed_by": "",
"confirmed": "2014-03-26T17:08:04Z",
"received": "2014-03-26T17:08:04Z",
"ver": 1,
"lock_time": 0,
"double_spend": false,
"vin_sz": 2,
"vout_sz": 2,
"confirmations": 64492,
"confidence": 1,
"inputs": [
{
"prev_hash": "729f6469b59fea5da7...",
"output_index": 0,
"script": "483045022100d06cdad1a...",
"output_value": 3500000,
"sequence": 4294967295,
"addresses": [
"1VxsEDjo6ZLMT99dpcLu4RQonMDVEQQTG"
],
"script_type": "pay-to-pubkey-hash"
},
...
],
"outputs": [
{
"value": 3500000,
"script": "76a9148629647bd642a237...",
"addresses": [
"1DEP8i3QJCsomS4BSMY2RpU1upv62aGvhD"
],
"script_type": "pay-to-pubkey-hash"
}
]...
Returns: An Object of type Transaction
"""
inputs = []
outputs = []
addr_keys = set()
for i in txn_json["inputs"]:
# Chain doesn't return the stuff about script length etc, so
# we need to prepend that.
script, _ = Script.from_bytes(
pack_var_str(bytes.fromhex(i["script"])))
inputs.append(TransactionInput(Hash(i["prev_hash"]),
i["output_index"],
script,
i["sequence"]))
if "addresses" in i and i["addresses"]:
addr_keys.add(i["addresses"][0])
for i in txn_json["outputs"]:
script, _ = Script.from_bytes(
pack_var_str(bytes.fromhex(i["script"])))
outputs.append(TransactionOutput(i["value"],
script))
if "addresses" in i and i["addresses"]:
addr_keys.add(i["addresses"][0])
txn = Transaction(Transaction.DEFAULT_TRANSACTION_VERSION,
inputs,
outputs,
txn_json["lock_time"])
return txn, addr_keys
