Creating a Python Transaction with the PureStake API
Creating a transaction and sending it in to the network programmatically are foundational tasks for working with a blockchain. Using the PureStake API allows a developer full access to the complete Algorand MainNet/Testnet ledgers without running any infrastructure, but does require a few minor changes to the code.
Python
Requirements
- The Python SDK: Download Here
- A PureStake Account: See Tutorial
- A Funded TestNet Account: See Tutorial
Background
- The PureStake API Service https://developer.purestake.io/
- About the PureStake API: https://www.purestake.com/technology/algorand-api/
- Code Samples: https://developer.purestake.io/code-samples
- API Examples: https://github.com/PureStake/api-examples
Steps
1. Set Configuration Values for the PureStake API
First, you’ll need to set the default configuration values for PureStake’s API. This process varies from the Algorand-published examples in that you’ll need to set the token as a dict.
To do that, enter the following:
import json
import time
import base64
from algosdk.v2client import algod
from algosdk import mnemonic
from algosdk import transaction
algod_token = 'YOUR API KEY HERE'
algod_address = 'https://testnet-algorand.api.purestake.io/ps2'
purestake_token = {'X-Api-key': algod_token}
2. Recover Account
Now you’ll need to recover your account using your mnemonic.
Important Note: Mnemonics control your account. Never share them or store insecurely. The code below is for demonstration purposes only.
mnemonic_phrase = "YOUR MNEMONIC HERE";
account_private_key = mnemonic.to_private_key(mnemonic_phrase)
account_public_key = mnemonic.to_public_key(mnemonic_phrase)
3. Create the Client
To instantiate the client, enter:
algodclient = algod.AlgodClient(algod_token, algod_address, headers=purestake_token)
4. Get and Set Transaction Parameters
Get the transaction parameters from the blockchain using the client object and set the amount and destination address.
params = algodclient.suggested_params()
gh = params.gh
first_valid_round = params.first
last_valid_round = params.last
fee = params.min_fee
send_amount = 10
existing_account = account_public_key
send_to_address = 'AEC4WDHXCDF4B5LBNXXRTB3IJTVJSWUZ4VJ4THPU2QGRJGTA3MIDFN3CQA'
5. Create and Sign Transaction
Create a new transaction using the parameters defined above and sign it.
tx = transaction.PaymentTxn(existing_account, fee, first_valid_round, last_valid_round, gh, send_to_address, send_amount, flat_fee=True)
signed_tx = tx.sign(account_private_key)
6. Include Verification Method
After the transaction is complete and sent in, this method is called to verify that the transaction has been included in the blockchain:
# Function from Algorand Inc. - utility for waiting on a transaction confirmation
def wait_for_confirmation(client, txid):
last_round = client.status().get('last-round')
txinfo = client.pending_transaction_info(txid)
while not (txinfo.get('confirmed-round') and txinfo.get('confirmed-round') > 0):
print('Waiting for confirmation')
last_round += 1
client.status_after_block(last_round)
txinfo = client.pending_transaction_info(txid)
print('Transaction confirmed in round', txinfo.get('confirmed-round'))
return txinfo
7. Submit and Verify Transaction
Lasty send in the signed transaction to the blockchain.
try:
tx_confirm = algodclient.send_transaction(signed_tx)
print('Transaction sent with ID', signed_tx.transaction.get_txid())
wait_for_confirmation(algodclient, txid=signed_tx.transaction.get_txid())
except Exception as e:
print(e)
You should see a response similar to this one:
Transaction sent with ID E6DNGM6TMV4JRUASPF3Z6WZG3R7WWF7BUW63RRBFVVPDGA5VVRQQ
Waiting for confirmation
Transaction confirmed in round 10461447
8. Run All of the Code Together
If you’d rather just drop in the code in its entirety, copy below. You’ll need to enter your API key, your mnemonic, and some other specifics in order for it to function properly.
import json
import time
import base64
from algosdk.v2client import algod
from algosdk import mnemonic
from algosdk import transaction
# Function from Algorand Inc.
def wait_for_confirmation(client, txid):
last_round = client.status().get('last-round')
txinfo = client.pending_transaction_info(txid)
while not (txinfo.get('confirmed-round') and txinfo.get('confirmed-round') > 0):
print('Waiting for confirmation')
last_round += 1
client.status_after_block(last_round)
txinfo = client.pending_transaction_info(txid)
print('Transaction confirmed in round', txinfo.get('confirmed-round'))
return txinfo
# Setup HTTP client w/guest key provided by PureStake
algod_token = 'YOUR API KEY HERE'
algod_address = 'https://testnet-algorand.api.purestake.io/ps2'
purestake_token = {'X-Api-key': algod_token}
# Initalize throw-away account for this example - check that is has funds before running script
mnemonic_phrase = 'YOUR MNEMONIC HERE';
account_private_key = mnemonic.to_private_key(mnemonic_phrase)
account_public_key = mnemonic.to_public_key(mnemonic_phrase)
algodclient = algod.AlgodClient(algod_token, algod_address, headers=purestake_token)
# get suggested parameters from Algod
params = algodclient.suggested_params()
gh = params.gh
first_valid_round = params.first
last_valid_round = params.last
fee = params.min_fee
send_amount = 10
existing_account = account_public_key
send_to_address = 'AEC4WDHXCDF4B5LBNXXRTB3IJTVJSWUZ4VJ4THPU2QGRJGTA3MIDFN3CQA'
# Create and sign transaction
tx = transaction.PaymentTxn(existing_account, fee, first_valid_round, last_valid_round, gh, send_to_address, send_amount, flat_fee=True)
signed_tx = tx.sign(account_private_key)
try:
tx_confirm = algodclient.send_transaction(signed_tx)
print('Transaction sent with ID', signed_tx.transaction.get_txid())
wait_for_confirmation(algodclient, txid=signed_tx.transaction.get_txid())
except Exception as e:
print(e)