def distribute(self,
address: "The address to distribute the asset from",
forward_address: "The address where to forward the collected bitcoin funds",
price: "Price of an asset unit in satoshis",
metadata: "The metadata to embed in the transaction"='',
fees: "The fess in satoshis for the transaction"=None,
mode: """'broadcast' for signing and broadcasting the transaction,
'signed' for signing the transaction without broadcasting,
'unsigned' for getting the raw unsigned transaction without broadcasting,
'preview' (default) for displaying a preview of the transactions"""='preview'
):
"""For every inbound transaction sending bitcoins to 'address', create an outbound transaction sending back
to the sender newly issued assets, and send the bitcoins to the forward address. The number of issued coins
sent back is proportional to the number of bitcoins sent, and configurable through the ratio argument.
Because the asset issuance transaction is chained from the inbound transaction, double spend is impossible."""
from_address = self._as_any_address(address)
to_address = self._as_any_address(forward_address)
decimal_price = self._as_decimal(price)
builder = openassets.transactions.TransactionBuilder(self.configuration.dust_limit)
colored_outputs = yield from self._get_unspent_outputs(from_address)
transactions = []
summary = []
for output in colored_outputs:
incoming_transaction = yield from self.provider.get_transaction(output.out_point.hash)
script = bytes(incoming_transaction.vout[0].scriptPubKey)
collected, amount_issued, change = self._calculate_distribution(
output.output.value, decimal_price, self._get_fees(fees), self.configuration.dust_limit)
if amount_issued > 0:
inputs = [bitcoin.core.CTxIn(output.out_point, output.output.script)]
outputs = [
builder._get_colored_output(script),
builder._get_marker_output([amount_issued], bytes(metadata, encoding='utf-8')),
builder._get_uncolored_output(to_address.to_scriptPubKey(), collected)
]
if change > 0:
outputs.append(builder._get_uncolored_output(script, change))
transaction = bitcoin.core.CTransaction(vin=inputs, vout=outputs)
transactions.append(transaction)
summary.append({
'from': self.convert.script_to_display_string(script),
'received': self.convert.to_coin(output.output.value) + " BTC",
'collected': self.convert.to_coin(collected) + " BTC",
'sent': str(amount_issued) + " Units",
'transaction': bitcoin.core.b2lx(output.out_point.hash)
})
if mode == 'preview':
return summary
else:
result = []
for transaction in transactions:
result.append(self.tx_parser((yield from self._process_transaction(transaction, mode))))
return result
def distribute(self,
address: "The address to distribute the asset from",
forward_address: "The address where to forward the collected bitcoin funds",
price: "Price of an asset unit in satoshis",
metadata: "The metadata to embed in the transaction"='',
fees: "The fess in satoshis for the transaction"=None,
mode: """'broadcast' for signing and broadcasting the transaction,
'signed' for signing the transaction without broadcasting,
'unsigned' for getting the raw unsigned transaction without broadcasting,
'preview' (default) for displaying a preview of the transactions"""='preview'
):
"""For every inbound transaction sending bitcoins to 'address', create an outbound transaction sending back
to the sender newly issued assets, and send the bitcoins to the forward address. The number of issued coins
sent back is proportional to the number of bitcoins sent, and configurable through the ratio argument.
Because the asset issuance transaction is chained from the inbound transaction, double spend is impossible."""
from_address = self._as_any_address(address)
to_address = self._as_any_address(forward_address)
decimal_price = self._as_decimal(price)
builder = openassets.transactions.TransactionBuilder(self.configuration.dust_limit)
colored_outputs = yield from self._get_unspent_outputs(from_address)
transactions = []
summary = []
for output in colored_outputs:
incoming_transaction = yield from self.provider.get_transaction(output.out_point.hash)
script = bytes(incoming_transaction.vout[0].scriptPubKey)
collected, amount_issued, change = self._calculate_distribution(
output.output.value, decimal_price, self._get_fees(fees), self.configuration.dust_limit)
if amount_issued > 0:
inputs = [bitcoin.core.CTxIn(output.out_point, output.output.script)]
outputs = [
builder._get_colored_output(script),
builder._get_marker_output([amount_issued], bytes(metadata, encoding='utf-8')),
builder._get_uncolored_output(to_address.to_scriptPubKey(), collected)
]
if change > 0:
outputs.append(builder._get_uncolored_output(script, change))
transaction = bitcoin.core.CTransaction(vin=inputs, vout=outputs)
transactions.append(transaction)
summary.append({
'from': self.convert.script_to_display_string(script),
'received': self.convert.to_coin(output.output.value) + " BTC",
'collected': self.convert.to_coin(collected) + " BTC",
'sent': str(amount_issued) + " Units",
'transaction': bitcoin.core.b2lx(output.out_point.hash)
})
if mode == 'preview':
return summary
else:
result = []
for transaction in transactions:
result.append(self.tx_parser((yield from self._process_transaction(transaction, mode))))
return result