def _fund_issuer(
cluster_obj: clusterlib.ClusterLib,
temp_template: str,
payment_addr: clusterlib.AddressRecord,
issuer_addr: clusterlib.AddressRecord,
amount: int,
collateral_amount: int,
) -> Tuple[List[clusterlib.UTXOData], List[clusterlib.UTXOData],
clusterlib.TxRawOutput]:
"""Fund the token issuer."""
issuer_init_balance = cluster_obj.get_address_balance(issuer_addr.address)
tx_files = clusterlib.TxFiles(signing_key_files=[payment_addr.skey_file], )
txouts = [
clusterlib.TxOut(
address=issuer_addr.address,
amount=amount,
),
clusterlib.TxOut(address=issuer_addr.address,
amount=collateral_amount),
]
tx_output = cluster_obj.build_tx(
src_address=payment_addr.address,
tx_name=f"{temp_template}_step1",
tx_files=tx_files,
txouts=txouts,
fee_buffer=2_000_000,
# don't join 'change' and 'collateral' txouts, we need separate UTxOs
join_txouts=False,
)
tx_signed = cluster_obj.sign_tx(
tx_body_file=tx_output.out_file,
signing_key_files=tx_files.signing_key_files,
tx_name=f"{temp_template}_step1",
)
cluster_obj.submit_tx(tx_file=tx_signed, txins=tx_output.txins)
issuer_balance = cluster_obj.get_address_balance(issuer_addr.address)
assert (
issuer_balance == issuer_init_balance + amount + collateral_amount
), f"Incorrect balance for token issuer address `{issuer_addr.address}`"
txid = cluster_obj.get_txid(tx_body_file=tx_output.out_file)
mint_utxos = cluster_obj.get_utxo(txin=f"{txid}#1")
collateral_utxos = [
clusterlib.UTXOData(utxo_hash=txid,
utxo_ix=2,
amount=collateral_amount,
address=issuer_addr.address)
]
return mint_utxos, collateral_utxos, tx_output
def get_txins(txhash: str) -> List[clusterlib.UTXOData]:
"""Get txins of a transaction from db-sync."""
txins: List[clusterlib.UTXOData] = []
seen_txins_out_ids = set()
seen_txins_ma_ids = set()
for txins_row in query_tx_ins(txhash=txhash):
# Lovelace inputs
if txins_row.tx_out_id and txins_row.tx_out_id not in seen_txins_out_ids:
seen_txins_out_ids.add(txins_row.tx_out_id)
txins.append(
clusterlib.UTXOData(
utxo_hash=txins_row.tx_hash.hex(),
utxo_ix=int(txins_row.utxo_ix),
amount=int(txins_row.value),
address=str(txins_row.address),
))
# MA inputs
if txins_row.ma_tx_out_id and txins_row.ma_tx_out_id not in seen_txins_ma_ids:
seen_txins_ma_ids.add(txins_row.ma_tx_out_id)
asset_name = (bytearray.fromhex(
txins_row.ma_tx_out_name.hex()).decode()
if txins_row.ma_tx_out_name else None)
policyid = txins_row.ma_tx_out_policy.hex(
) if txins_row.ma_tx_out_policy else ""
coin = f"{policyid}.{asset_name}" if asset_name else policyid
txins.append(
clusterlib.UTXOData(
utxo_hash=txins_row.tx_hash.hex(),
utxo_ix=int(txins_row.utxo_ix),
amount=int(txins_row.ma_tx_out_quantity or 0),
address=str(txins_row.address),
coin=coin,
))
return txins
def get_prelim_tx_record(txhash: str) -> TxPrelimRecord:
"""Get first batch of transaction data from db-sync."""
utxo_out: List[clusterlib.UTXOData] = []
seen_tx_out_ids = set()
ma_utxo_out: List[clusterlib.UTXOData] = []
seen_ma_tx_out_ids = set()
mint_utxo_out: List[clusterlib.UTXOData] = []
seen_ma_tx_mint_ids = set()
tx_id = -1
for query_row in query_tx(txhash=txhash):
if tx_id == -1:
tx_id = query_row.tx_id
if tx_id != query_row.tx_id:
raise AssertionError(
"Transaction ID differs from the expected ID.")
# Lovelace outputs
if query_row.tx_out_id and query_row.tx_out_id not in seen_tx_out_ids:
seen_tx_out_ids.add(query_row.tx_out_id)
out_rec = clusterlib.UTXOData(
utxo_hash=str(txhash),
utxo_ix=int(query_row.utxo_ix),
amount=int(query_row.tx_out_value),
address=str(query_row.tx_out_addr),
)
utxo_out.append(out_rec)
# MA outputs
if query_row.ma_tx_out_id and query_row.ma_tx_out_id not in seen_ma_tx_out_ids:
seen_ma_tx_out_ids.add(query_row.ma_tx_out_id)
asset_name = (bytearray.fromhex(
query_row.ma_tx_out_name.hex()).decode()
if query_row.ma_tx_out_name else None)
policyid = query_row.ma_tx_out_policy.hex(
) if query_row.ma_tx_out_policy else ""
coin = f"{policyid}.{asset_name}" if asset_name else policyid
ma_rec = clusterlib.UTXOData(
utxo_hash=str(txhash),
utxo_ix=int(query_row.utxo_ix),
amount=int(query_row.ma_tx_out_quantity or 0),
address=str(query_row.tx_out_addr),
coin=coin,
)
ma_utxo_out.append(ma_rec)
# MA minting
if query_row.ma_tx_mint_id and query_row.ma_tx_mint_id not in seen_ma_tx_mint_ids:
seen_ma_tx_mint_ids.add(query_row.ma_tx_mint_id)
asset_name = (bytearray.fromhex(
query_row.ma_tx_mint_name.hex()).decode()
if query_row.ma_tx_mint_name else None)
policyid = query_row.ma_tx_mint_policy.hex(
) if query_row.ma_tx_mint_policy else ""
coin = f"{policyid}.{asset_name}" if asset_name else policyid
mint_rec = clusterlib.UTXOData(
utxo_hash=str(txhash),
utxo_ix=int(query_row.utxo_ix),
amount=int(query_row.ma_tx_mint_quantity or 0),
address=str(query_row.tx_out_addr),
coin=coin,
)
mint_utxo_out.append(mint_rec)
if tx_id == -1:
raise RuntimeError("No results were returned by the TX SQL query.")
# pylint: disable=undefined-loop-variable
txdata = TxPrelimRecord(
utxo_out=utxo_out,
ma_utxo_out=ma_utxo_out,
mint_utxo_out=mint_utxo_out,
last_row=query_row,
)
return txdata
def get_tx_record(txhash: str) -> TxRecord: # noqa: C901
"""Get transaction data from db-sync.
Compile data from multiple SQL queries to get as much information about the TX as possible.
"""
txdata = get_prelim_tx_record(txhash)
txins = get_txins(txhash)
metadata = []
if txdata.last_row.metadata_count:
metadata = [
MetadataRecord(key=int(r.key), json=r.json, bytes=r.bytes)
for r in dbsync_queries.query_tx_metadata(txhash=txhash)
]
reserve = []
if txdata.last_row.reserve_count:
reserve = [
ADAStashRecord(
address=str(r.addr_view), cert_index=int(r.cert_index), amount=int(r.amount)
)
for r in dbsync_queries.query_tx_reserve(txhash=txhash)
]
treasury = []
if txdata.last_row.treasury_count:
treasury = [
ADAStashRecord(
address=str(r.addr_view), cert_index=int(r.cert_index), amount=int(r.amount)
)
for r in dbsync_queries.query_tx_treasury(txhash=txhash)
]
pot_transfers = []
if txdata.last_row.pot_transfer_count:
pot_transfers = [
PotTransferRecord(treasury=int(r.treasury), reserves=int(r.reserves))
for r in dbsync_queries.query_tx_pot_transfers(txhash=txhash)
]
stake_registration = []
if txdata.last_row.stake_reg_count:
stake_registration = [r.view for r in dbsync_queries.query_tx_stake_reg(txhash=txhash)]
stake_deregistration = []
if txdata.last_row.stake_dereg_count:
stake_deregistration = [r.view for r in dbsync_queries.query_tx_stake_dereg(txhash=txhash)]
stake_delegation = []
if txdata.last_row.stake_deleg_count:
stake_delegation = [
DelegationRecord(
address=r.address, pool_id=r.pool_id, active_epoch_no=r.active_epoch_no
)
for r in dbsync_queries.query_tx_stake_deleg(txhash=txhash)
if (r.address and r.pool_id and r.active_epoch_no)
]
withdrawals = []
if txdata.last_row.withdrawal_count:
withdrawals = [
clusterlib.TxOut(address=r.address, amount=int(r.amount))
for r in dbsync_queries.query_tx_withdrawal(txhash=txhash)
]
collaterals = []
if txdata.last_row.collateral_count:
collaterals = [
clusterlib.UTXOData(
utxo_hash=r.tx_hash.hex(),
utxo_ix=int(r.utxo_ix),
amount=int(r.value),
address=str(r.address),
)
for r in dbsync_queries.query_collateral_tx_ins(txhash=txhash)
]
scripts = []
if txdata.last_row.script_count:
scripts = [
ScriptRecord(
hash=r.hash.hex(),
type=str(r.type),
serialised_size=int(r.serialised_size) if r.serialised_size else 0,
)
for r in dbsync_queries.query_plutus_scripts(txhash=txhash)
]
redeemers = []
if txdata.last_row.redeemer_count:
redeemers = [
RedeemerRecord(
unit_mem=int(r.unit_mem),
unit_steps=int(r.unit_steps),
fee=int(r.fee),
purpose=str(r.purpose),
script_hash=r.script_hash.hex(),
)
for r in dbsync_queries.query_redeemers(txhash=txhash)
]
record = TxRecord(
tx_id=int(txdata.last_row.tx_id),
tx_hash=txdata.last_row.tx_hash.hex(),
block_id=int(txdata.last_row.block_id),
block_index=int(txdata.last_row.block_index),
out_sum=int(txdata.last_row.out_sum),
fee=int(txdata.last_row.fee),
deposit=int(txdata.last_row.deposit),
size=int(txdata.last_row.size),
invalid_before=int(txdata.last_row.invalid_before)
if txdata.last_row.invalid_before
else None,
invalid_hereafter=int(txdata.last_row.invalid_hereafter)
if txdata.last_row.invalid_hereafter
else None,
txins=txins,
txouts=[*txdata.utxo_out, *txdata.ma_utxo_out],
mint=txdata.mint_utxo_out,
collaterals=collaterals,
scripts=scripts,
redeemers=redeemers,
metadata=metadata,
reserve=reserve,
treasury=treasury,
pot_transfers=pot_transfers,
stake_registration=stake_registration,
stake_deregistration=stake_deregistration,
stake_delegation=stake_delegation,
withdrawals=withdrawals,
)
return record
def _fund_issuer(
cluster_obj: clusterlib.ClusterLib,
temp_template: str,
payment_addr: clusterlib.AddressRecord,
issuer_addr: clusterlib.AddressRecord,
minting_cost: plutus_common.ScriptCost,
amount: int,
collateral_utxo_num: int = 1,
) -> Tuple[List[clusterlib.UTXOData], List[clusterlib.UTXOData],
clusterlib.TxRawOutput]:
"""Fund the token issuer."""
single_collateral_amount = minting_cost.collateral // collateral_utxo_num
collateral_amounts = [
single_collateral_amount for c in range(collateral_utxo_num - 1)
]
collateral_subtotal = sum(collateral_amounts)
collateral_amounts.append(minting_cost.collateral - collateral_subtotal)
issuer_init_balance = cluster_obj.get_address_balance(issuer_addr.address)
tx_files = clusterlib.TxFiles(signing_key_files=[payment_addr.skey_file], )
txouts = [
clusterlib.TxOut(
address=issuer_addr.address,
amount=amount,
),
*[
clusterlib.TxOut(address=issuer_addr.address, amount=a)
for a in collateral_amounts
],
]
tx_output = cluster_obj.build_tx(
src_address=payment_addr.address,
tx_name=f"{temp_template}_step1",
tx_files=tx_files,
txouts=txouts,
fee_buffer=2_000_000,
# don't join 'change' and 'collateral' txouts, we need separate UTxOs
join_txouts=False,
)
tx_signed = cluster_obj.sign_tx(
tx_body_file=tx_output.out_file,
signing_key_files=tx_files.signing_key_files,
tx_name=f"{temp_template}_step1",
)
cluster_obj.submit_tx(tx_file=tx_signed, txins=tx_output.txins)
issuer_balance = cluster_obj.get_address_balance(issuer_addr.address)
assert (
issuer_balance == issuer_init_balance + amount +
minting_cost.collateral
), f"Incorrect balance for token issuer address `{issuer_addr.address}`"
txid = cluster_obj.get_txid(tx_body_file=tx_output.out_file)
mint_utxos = cluster_obj.get_utxo(txin=f"{txid}#1")
collateral_utxos = [
clusterlib.UTXOData(utxo_hash=txid,
utxo_ix=idx,
amount=a,
address=issuer_addr.address)
for idx, a in enumerate(collateral_amounts, start=2)
]
return mint_utxos, collateral_utxos, tx_output