How to index every WMON transfer using QuickNode Streams

In this guide, you will learn how to use QuickNode Streams to index every WMON transfer, including internal transactions, on Monad Testnet.

What is QuickNode Streams?

QuickNode Streams is a web3 data streaming solution supporting real-time and historical Monad data that offers:

Reliable Data Delivery - Exactly-once, guaranteed delivery, seamlessly integrating with your data lake. Streams ensures every block, receipt, or trace is delivered exactly-once in the order of dataset finality, preventing issues like corrupt or missing data
Real-Time Data Consistency - Consistent, live data streaming
Efficient Historical Data Handling - Configurable date ranges and destinations for streamlined historical data management
Easy Integration - Simple setup through a user-friendly interface
Transparent User Experience - Clear logging, metrics, and usage tracking

Setup Guide

1. Initial setup

Sign up for QuickNode and log into your dashboard.
Click on "Streams" in the left sidebar.

QuickNode Dashboard

Click on "Create Stream".

Create Stream Button

2. Configure Stream range

Give your stream a name. In this example we will name it monad-quicknode-stream.
In the "Network" section, select Monad from the dropdown.
In the "Stream Start" section you can choose to start the stream from the latest block or from a specific block number.

Stream Configuration

In the "Stream End" section you can choose to end the stream until manually paused or at a specific block number.
In the "Latest block delay" section, you can set a block number as a delay in receiving data. For this guide we will receive data as soon as it is available.

For example: If the block delay is 3, you will receive data only when there is new data available for 3 blocks including latest block, this helps in case there is a reorg.
In the "Restream on reorg" section you can decide if you would like to get updated data restreamed in case of a reorg. For this guide we will keep this off.
Once done click "Next".

Additional Settings

3. Set up dataset

In the "Dataset" dropdown you can select the dataset of your choice according to the use case. For this guide we will select Block with Receipts since we want to filter logs with events emitted by WMON contract.

Optional: Enable "Batch messages" to receive multiple blocks in a single message. This can be useful when the stream is not starting from the latest block.

Dataset Selection

Feel free to test it out by entering a block number and clicking "Fetch payload".

Raw Payload Example

4. Create WMON Transfer filter

In the "Modify the stream payload" section, you can define filters by clicking "Customize your payload". For this guide, we will filter to only retrieve receipts involving WMON transfers.

modify stream image

QuickNode has a set of filter templates. Select the Decoded ERC20 transfers template:

image for filter

The editor will appear:

image of filter editor

The current filter allows all ERC20 transfers through. Replace the filter code with:

function main(stream) {  
  const erc20Abi = `[{
    "anonymous": false,
    "inputs": [
      {"indexed": true, "type": "address", "name": "from"},
      {"indexed": true, "type": "address", "name": "to"},
      {"indexed": false, "type": "uint256", "name": "value"}
    ],
    "name": "Transfer",
    "type": "event"
  }]`;
  
  const data = stream.data ? stream.data : stream;
  
  // Decodes logs from the receipts that match the Transfer event ABI
  var result = decodeEVMReceipts(data[0].receipts, [erc20Abi]);
  
  // Filter for receipts with decoded logs
  result = result.filter(receipt => {
        // Check if there are any ERC20 transfers
        if(receipt.decodedLogs) {
            // Check if there are any WMON transfers
            receipt.decodedLogs = receipt.decodedLogs.filter(log => log.address == "0x760AfE86e5de5fa0Ee542fc7B7B713e1c5425701");
            
            // Return receipt if there logs which indicate a WMON transfer.
            return receipt.decodedLogs.length > 0;
        }

        // Return nothing if there are no ERC20 transfers.
        return false;
    });
  
  return { result };
}