Retrieving pending transactions is a helpful concept; let's see how to retrieve the pending transactions and display the transaction hash using web3.py!
The script we'll create in this tutorial allows a user to input an HTTPS endpoint for an EVM-based network, then displays:
- Latest block number;
- List of pending transaction hash.
After that, you can take the hashes and analyze them or do what you wish with some Python logic.
The code is commented to that you can understand what we do and why!
You can also check my Skillshare class where I elaborate more on this!
Get 30 days for free on Skillshare using this link!
This program has been designed using the Web3.py
library, you will need to install the following:
You can install web3.py
after installing Python with:
pip install web3
Note that on Windows, you will need to install the Microsoft C++ Build Tools to make it work.
Then you need access to a node endpoint to connect to the blockchain from which you want to get pending transactions.
To access a node endpoint, I recommend using Chainstack:
Follow these steps to sign up on Chainstack, deploy a node, and find your endpoint credentials:
Web3.py is a Python library for interacting with the Ethereum network (Or other networks based on the EVM).
It’s commonly found in decentralized apps (dapps) to help with sending transactions, interacting with smart contracts, reading block data, and a variety of other use cases.
The original API was derived from the Web3.js Javascript API but has since evolved toward the needs and creature comforts of Python developers.
- source: Web3.py docs
The code is very Python fashion and is absolutely straightforward. The script can be divided into three sections:
- Establish a connection to the node by inserting the node URL.
- Use a filter to retrieve pending transactions.
- Loop through the list of pending transactions returned by the filter and display the hashed on the console.
Let's start by creating a new Python file in your project's folder; I named it pending_tx.py
.
The first part of the script is to establish a connection to the node; for this, we use the following code.
Note: In this case, we ask the user for an input, so you can use the URL you want at that moment since you can use this script with any EVM-compatible network, but you can also hardcode the URL.
from web3 import Web3 # Import the web3 library at the top.
node_url = input('Insert your Node URL: ') # Accepts the user node URL.
web3 = Web3(Web3.HTTPProvider(node_url)) # Establish connection to the node.
# Verify if the connection is successful. This is optional, but it's nice to notify the user.
if web3.isConnected():
print('Connection Successful')
else:
print('Connection Failed')
The next step is to use a filter to retrieve the pending transactions.
# Display the latest block. This is optional, but it's nice to add this info for the user.
print('The latest block number is: ', str(web3.eth.blockNumber) + '\n')
# Retrive pending transactions hash using a filter.
pending_tx_filter = web3.eth.filter('pending')
pending_tx = pending_tx_filter.get_new_entries() # This is a list object.
This is now returning a list of the pending transactions in the mempool.
The last step is to take the hashes from our list. We simply loop through the list, take the hash, convert it into HEX, and display it on the console.
# loop through the list of transactions and display the tx hash.
for hash in pending_tx:
print('Hash of a Pending Transaction:' , web3.toHex(hash))
That's it! So simple; at this point, we just need to run it.
To run the program, open a console in the folder where you saved the Python file and run:
python pending_tx.py
Input your HTTPS endpoint URL where the program prompts it:
The program will try to connect and give a message to the user specifying if the connection was successful or failed.
The console will display the latest block number and a list of pending transactions if the connection is successful.
Now you can look up the transaction hash on the chain explorer or include some more Python logic to extracts the data that you need!
This simple script can retrieve pending transaction hashes from the mempool, but most importantly, it's an excellent way to learn how to use web3.py to interact with a blockchain!