beem.transactionbuilder module

class beem.transactionbuilder.TransactionBuilder(tx={}, expiration=None, steem_instance=None)

Bases: dict

This class simplifies the creation of transactions by adding operations and signers. To build your own transactions and sign them

param dict tx: transaction (Optional). If not set, the new transaction is created. param str expiration: expiration date param Steem steem_instance: If not set, shared_steem_instance() is used

from beem.transactionbuilder import TransactionBuilder
from beembase.operations import Transfer
tx = TransactionBuilder()
tx.appendOps(Transfer(**{
         "from": "test",
         "to": "test1",
         "amount": "1 STEEM",
         "memo": ""
     }))
tx.appendSigner("test", "active")
tx.sign()
tx.broadcast()

addSigningInformation(account, permission, reconstruct_tx=False)

This is a private method that adds side information to a unsigned/partial transaction in order to simplify later signing (e.g. for multisig or coldstorage)

Not needed when “appendWif” was already or is going to be used

FIXME: Does not work with owner keys!

Parameters:reconstruct_tx (bool) – when set to False and tx is already contructed, it will not reconstructed and already added signatures remain

appendMissingSignatures()

Store which accounts/keys are supposed to sign the transaction

This method is used for an offline-signer!

appendOps(ops, append_to=None)

Append op(s) to the transaction builder

Parameters:ops (list) – One or a list of operations

appendSigner(account, permission)

Try to obtain the wif key from the wallet by telling which account and permission is supposed to sign the transaction It is possible to add more than one signer.

appendWif(wif)

Add a wif that should be used for signing of the transaction.

Parameters:wif (string) – One wif key to use for signing a transaction.

broadcast(max_block_age=-1)

Broadcast a transaction to the steem network Returns the signed transaction and clears itself after broadast

Clears itself when broadcast was not sucessfully.

Parameters:max_block_age (int) – paramerter only used for appbase ready nodes

clear()

Clear the transaction builder and start from scratch

clearWifs()

Clear all stored wifs

constructTx()

Construct the actual transaction and store it in the class’s dict store

get_parent()

TransactionBuilders don’t have parents, they are their own parent

is_empty()

Check if ops is empty

json()

Show the transaction as plain json

list_operations()

List all ops

set_expiration(p)

Set expiration date

sign(reconstruct_tx=True)

Sign a provided transaction with the provided key(s) One or many wif keys to use for signing a transaction. The wif keys can be provided by “appendWif” or the signer can be defined “appendSigner”. The wif keys from all signer that are defined by “appendSigner will be loaded from the wallet.

Parameters:reconstruct_tx (bool) – when set to False and tx is already contructed, it will not reconstructed and already added signatures remain

verify_authority()

Verify the authority of the signed transaction