transaction

class Transaction(sender, fee, first, last, note, gen, gh, lease, txn_type, rekey_to)

Bases: object

Superclass for various transaction types.

get_txid()

Get the transaction’s ID.

Returns:transaction ID
Return type:str
sign(private_key)

Sign the transaction with a private key.

Parameters:private_key (str) – the private key of the signing account
Returns:signed transaction with the signature
Return type:SignedTransaction
raw_sign(private_key)

Sign the transaction.

Parameters:private_key (str) – the private key of the signing account
Returns:signature
Return type:bytes
estimate_size()
dictify()
static undictify(d)
class PaymentTxn(sender, fee, first, last, gh, receiver, amt, close_remainder_to=None, note=None, gen=None, flat_fee=False, lease=None, rekey_to=None)

Bases: algosdk.transaction.Transaction

Represents a payment transaction.

Parameters:
  • sender (str) – address of the sender
  • fee (int) – transaction fee (per byte if flat_fee is false). When flat_fee is true, fee may fall to zero but a group of N atomic transactions must still have a fee of at least N*min_txn_fee.
  • first (int) – first round for which the transaction is valid
  • last (int) – last round for which the transaction is valid
  • gh (str) – genesis_hash
  • receiver (str) – address of the receiver
  • amt (int) – amount in microAlgos to be sent
  • close_remainder_to (str, optional) – if nonempty, account will be closed and remaining algos will be sent to this address
  • note (bytes, optional) – arbitrary optional bytes
  • gen (str, optional) – genesis_id
  • flat_fee (bool, optional) – whether the specified fee is a flat fee
  • lease (byte[32], optional) – specifies a lease, and no other transaction with the same sender and lease can be confirmed in this transaction’s valid rounds
  • rekey_to (str, optional) – additionally rekey the sender to this address
sender
Type:str
fee
Type:int
first_valid_round
Type:int
last_valid_round
Type:int
note
Type:bytes
genesis_id
Type:str
genesis_hash
Type:str
group
Type:bytes
receiver
Type:str
amt
Type:int
close_remainder_to
Type:str
type
Type:str
lease
Type:byte[32]
rekey_to
Type:str
dictify()
class KeyregTxn(sender, fee, first, last, gh, votekey, selkey, votefst, votelst, votekd, note=None, gen=None, flat_fee=False, lease=None, rekey_to=None)

Bases: algosdk.transaction.Transaction

Represents a key registration transaction.

Parameters:
  • sender (str) – address of sender
  • fee (int) – transaction fee (per byte if flat_fee is false). When flat_fee is true, fee may fall to zero but a group of N atomic transactions must still have a fee of at least N*min_txn_fee.
  • first (int) – first round for which the transaction is valid
  • last (int) – last round for which the transaction is valid
  • gh (str) – genesis_hash
  • votekey (str) – participation public key
  • selkey (str) – VRF public key
  • votefst (int) – first round to vote
  • votelst (int) – last round to vote
  • votekd (int) – vote key dilution
  • note (bytes, optional) – arbitrary optional bytes
  • gen (str, optional) – genesis_id
  • flat_fee (bool, optional) – whether the specified fee is a flat fee
  • lease (byte[32], optional) – specifies a lease, and no other transaction with the same sender and lease can be confirmed in this transaction’s valid rounds
  • rekey_to (str, optional) – additionally rekey the sender to this address
sender
Type:str
fee
Type:int
first_valid_round
Type:int
last_valid_round
Type:int
note
Type:bytes
genesis_id
Type:str
genesis_hash
Type:str
group
Type:bytes
votepk
Type:str
selkey
Type:str
votefst
Type:int
votelst
Type:int
votekd
Type:int
type
Type:str
lease
Type:byte[32]
rekey_to
Type:str
dictify()
class AssetConfigTxn(sender, fee, first, last, gh, index=None, total=None, default_frozen=None, unit_name=None, asset_name=None, manager=None, reserve=None, freeze=None, clawback=None, url=None, metadata_hash=None, note=None, gen=None, flat_fee=False, lease=None, strict_empty_address_check=True, decimals=0, rekey_to=None)

Bases: algosdk.transaction.Transaction

Represents a transaction for asset creation, reconfiguration, or destruction.

To create an asset, include the following:
total, default_frozen, unit_name, asset_name, manager, reserve, freeze, clawback, url, metadata, decimals
To destroy an asset, include the following:
index, strict_empty_address_check (set to False)
To update asset configuration, include the following:
index, manager, reserve, freeze, clawback, strict_empty_address_check (optional)
Parameters:
  • sender (str) – address of the sender
  • fee (int) – transaction fee (per byte if flat_fee is false). When flat_fee is true, fee may fall to zero but a group of N atomic transactions must still have a fee of at least N*min_txn_fee.
  • first (int) – first round for which the transaction is valid
  • last (int) – last round for which the transaction is valid
  • gh (str) – genesis_hash
  • index (int, optional) – index of the asset
  • total (int, optional) – total number of base units of this asset created
  • default_frozen (bool, optional) – whether slots for this asset in user accounts are frozen by default
  • unit_name (str, optional) – hint for the name of a unit of this asset
  • asset_name (str, optional) – hint for the name of the asset
  • manager (str, optional) – address allowed to change nonzero addresses for this asset
  • reserve (str, optional) – account whose holdings of this asset should be reported as “not minted”
  • freeze (str, optional) – account allowed to change frozen state of holdings of this asset
  • clawback (str, optional) – account allowed take units of this asset from any account
  • url (str, optional) – a URL where more information about the asset can be retrieved
  • metadata_hash (byte[32], optional) – a commitment to some unspecified asset metadata (32 byte hash)
  • note (bytes, optional) – arbitrary optional bytes
  • gen (str, optional) – genesis_id
  • flat_fee (bool, optional) – whether the specified fee is a flat fee
  • lease (byte[32], optional) – specifies a lease, and no other transaction with the same sender and lease can be confirmed in this transaction’s valid rounds
  • strict_empty_address_check (bool, optional) – set this to False if you want to specify empty addresses. Otherwise, if this is left as True (the default), having empty addresses will raise an error, which will prevent accidentally removing admin access to assets or deleting the asset.
  • decimals (int, optional) – number of digits to use for display after decimal. If set to 0, the asset is not divisible. If set to 1, the base unit of the asset is in tenths. Must be between 0 and 19, inclusive. Defaults to 0.
  • rekey_to (str, optional) – additionally rekey the sender to this address
sender
Type:str
fee
Type:int
first_valid_round
Type:int
last_valid_round
Type:int
genesis_hash
Type:str
index
Type:int
total
Type:int
default_frozen
Type:bool
unit_name
Type:str
asset_name
Type:str
manager
Type:str
reserve
Type:str
freeze
Type:str
clawback
Type:str
url
Type:str
metadata_hash
Type:byte[32]
note
Type:bytes
genesis_id
Type:str
type
Type:str
lease
Type:byte[32]
decimals
Type:int
rekey_to
Type:str
dictify()
class AssetFreezeTxn(sender, fee, first, last, gh, index, target, new_freeze_state, note=None, gen=None, flat_fee=False, lease=None, rekey_to=None)

Bases: algosdk.transaction.Transaction

Represents a transaction for freezing or unfreezing an account’s asset holdings. Must be issued by the asset’s freeze manager.

Parameters:
  • sender (str) – address of the sender, who must be the asset’s freeze manager
  • fee (int) – transaction fee (per byte if flat_fee is false). When flat_fee is true, fee may fall to zero but a group of N atomic transactions must still have a fee of at least N*min_txn_fee.
  • first (int) – first round for which the transaction is valid
  • last (int) – last round for which the transaction is valid
  • gh (str) – genesis_hash
  • index (int) – index of the asset
  • target (str) – address having its assets frozen or unfrozen
  • new_freeze_state (bool) – true if the assets should be frozen, false if they should be transferrable
  • note (bytes, optional) – arbitrary optional bytes
  • gen (str, optional) – genesis_id
  • flat_fee (bool, optional) – whether the specified fee is a flat fee
  • lease (byte[32], optional) – specifies a lease, and no other transaction with the same sender and lease can be confirmed in this transaction’s valid rounds
  • rekey_to (str, optional) – additionally rekey the sender to this address
sender
Type:str
fee
Type:int
first_valid_round
Type:int
last_valid_round
Type:int
genesis_hash
Type:str
index
Type:int
target
Type:str
new_freeze_state
Type:bool
note
Type:bytes
genesis_id
Type:str
type
Type:str
lease
Type:byte[32]
rekey_to
Type:str
dictify()
class AssetTransferTxn(sender, fee, first, last, gh, receiver, amt, index, close_assets_to=None, revocation_target=None, note=None, gen=None, flat_fee=False, lease=None, rekey_to=None)

Bases: algosdk.transaction.Transaction

Represents a transaction for asset transfer. To begin accepting an asset, supply the same address as both sender and receiver, and set amount to 0. To revoke an asset, set revocation_target, and issue the transaction from the asset’s revocation manager account.

Parameters:
  • sender (str) – address of the sender
  • fee (int) – transaction fee (per byte if flat_fee is false). When flat_fee is true, fee may fall to zero but a group of N atomic transactions must still have a fee of at least N*min_txn_fee.
  • first (int) – first round for which the transaction is valid
  • last (int) – last round for which the transaction is valid
  • gh (str) – genesis_hash
  • receiver (str) – address of the receiver
  • amt (int) – amount of asset base units to send
  • index (int) – index of the asset
  • close_assets_to (string, optional) – send all of sender’s remaining assets, after paying amt to receiver, to this address
  • revocation_target (string, optional) – send assets from this address, rather than the sender’s address (can only be used by an asset’s revocation manager, also known as clawback)
  • note (bytes, optional) – arbitrary optional bytes
  • gen (str, optional) – genesis_id
  • flat_fee (bool, optional) – whether the specified fee is a flat fee
  • lease (byte[32], optional) – specifies a lease, and no other transaction with the same sender and lease can be confirmed in this transaction’s valid rounds
  • rekey_to (str, optional) – additionally rekey the sender to this address
sender
Type:str
fee
Type:int
first_valid_round
Type:int
last_valid_round
Type:int
genesis_hash
Type:str
index
Type:int
amount
Type:int
receiver
Type:string
close_assets_to
Type:string
revocation_target
Type:string
note
Type:bytes
genesis_id
Type:str
type
Type:str
lease
Type:byte[32]
rekey_to
Type:str
dictify()
class SignedTransaction(transaction, signature, authorizing_address=None)

Bases: object

Represents a signed transaction.

Parameters:
  • transaction (Transaction) – transaction that was signed
  • signature (str) – signature of a single address
  • authorizing_address (str, optional) – the address authorizing the signed transaction, if different from sender
transaction
Type:Transaction
signature
Type:str
authorizing_address
Type:str
dictify()
static undictify(d)
class MultisigTransaction(transaction, multisig)

Bases: object

Represents a signed transaction.

Parameters:
  • transaction (Transaction) – transaction that was signed
  • multisig (Multisig) – multisig account and signatures
transaction
Type:Transaction
multisig
Type:Multisig
sign(private_key)

Sign the multisig transaction.

Parameters:private_key (str) – private key of signing account

Note

A new signature will replace the old if there is already a signature for the address. To sign another transaction, you can either overwrite the signatures in the current Multisig, or you can use Multisig.get_multisig_account() to get a new multisig object with the same addresses.

dictify()
static undictify(d)
static merge(part_stxs)

Merge partially signed multisig transactions.

Parameters:part_stxs (MultisigTransaction[]) – list of partially signed multisig transactions
Returns:multisig transaction containing signatures
Return type:MultisigTransaction

Note

Only use this if you are given two partially signed multisig transactions. To append a signature to a multisig transaction, just use MultisigTransaction.sign()

class Multisig(version, threshold, addresses)

Bases: object

Represents a multisig account and signatures.

Parameters:
  • version (int) – currently, the version is 1
  • threshold (int) – how many signatures are necessary
  • addresses (str[]) – addresses in the multisig account
version
Type:int
threshold
Type:int
subsigs
Type:MultisigSubsig[]
validate()

Check if the multisig account is valid.

address()

Return the multisig account address.

verify(message)

Verify that the multisig is valid for the message.

dictify()
json_dictify()
static undictify(d)
get_multisig_account()

Return a Multisig object without signatures.

get_public_keys()

Return the base32 encoded addresses for the multisig account.

class MultisigSubsig(public_key, signature=None)

Bases: object

public_key
Type:bytes
signature
Type:bytes
dictify()
json_dictify()
static undictify(d)
class LogicSig(program, args=None)

Bases: object

Represents a logic signature.

Parameters:
  • logic (bytes) – compiled program
  • args (list[bytes]) – args are not signed, but are checked by logic
logic
Type:bytes
sig
Type:bytes
msig
Type:Multisig
args
Type:list[bytes]
dictify()
static undictify(d)
verify(public_key)

Verifies LogicSig against the transaction’s sender address

Parameters:public_key (bytes) – sender address
Returns:true if the signature is valid (the sender address matches the logic hash or the signature is valid against the sender address), false otherwise
Return type:bool
address()

Compute hash of the logic sig program (that is the same as escrow account address) as string address

Returns:program address
Return type:str
static sign_program(program, private_key)
static single_sig_multisig(program, private_key, multisig)
sign(private_key, multisig=None)

Creates signature (if no pk provided) or multi signature

Parameters:
  • private_key (str) – private key of signing account
  • multisig (Multisig) – optional multisig account without signatures to sign with
Raises:

InvalidSecretKeyError – if no matching private key in multisig object
append_to_multisig(private_key)

Appends a signature to multi signature

Parameters:private_key (str) – private key of signing account
Raises:InvalidSecretKeyError – if no matching private key in multisig object
class LogicSigTransaction(transaction, lsig)

Bases: object

Represents a logic signed transaction.

Parameters:
transaction
Type:Transaction
lsig
Type:LogicSig
verify()

Verify LogicSig against the transaction

Returns:true if the signature is valid (the sender address matches the logic hash or the signature is valid against the sender address), false otherwise
Return type:bool
dictify()
static undictify(d)
write_to_file(objs, path, overwrite=True)

Write signed or unsigned transactions to a file.

Parameters:
  • txns (Transaction[], SignedTransaction[], or MultisigTransaction[]) – can be a mix of the three
  • path (str) – file to write to
  • overwrite (bool) – whether or not to overwrite what’s already in the file; if False, transactions will be appended to the file
Returns:

true if the transactions have been written to the file
Return type:

bool
retrieve_from_file(path)

Retrieve encoded objects from a file.

Parameters:path (str) – file to read from
Returns:list of objects
Return type:Object[]
class TxGroup(txns)

Bases: object

dictify()
static undictify(d)
calculate_group_id(txns)

Calculate group id for a given list of unsigned transactions

Parameters:txns (list) – list of unsigned transactions
Returns:checksum value representing the group id
Return type:bytes
assign_group_id(txns, address=None)

Assign group id to a given list of unsigned transactions.

Parameters:
  • txns (list) – list of unsigned transactions
  • address (str) – optional sender address specifying which transaction to return
Returns:

list of unsigned transactions with group property set
Return type:

txns (list)