This add-on bundles up multiple RPC calls into a single call so you don't have to iterate through blocks, transactions or receipts!

Single flight RPC implements retries in each request when needed, while allowing you to get the block and transaction information in only one call.

It conforms to the RPC spec and fulfills block traces faster than calling the RPC directly.

It supports returning all transactions in a block with a single call.

The qn_getBlockWithReceipts and qn_getReceipts requests each cost the chain default (see the API credits pricing page for more details), however they will each make additional requests to your endpoint which will use additional API credits.

For blockchains that support eth_getBlockReceipts:

- The qn_getReceipts method will make 1 call
- The qn_getBlockWithReceipts method will make 1 call

For blockchains that don’t support eth_getBlockReceipts:

- The qn_getReceipts method will make X number of eth_getTransactionReceipt calls, where X is the number of transactions in the block.
- The qn_getBlockWithReceipts method will make X number of eth_getTransactionReceipt calls, where X is the number of transactions in the block, and 1 additional call to eth_getBlockByNumber.

Examples:

If method qn_getReceipts is called on Ethereum Mainnet, you will be charged 20 credit for the qn_getblockwithreceipts call, plus 20 credits for eth_getBlockReceipts.

Total credits used: 20 + 20 = 40.

If method qn_getBlockWithReceipts is called on Fantom Mainnet with a block that contains 50 transactions, you will be charged 20 credit for qn_getBlockWithReceipts, 20 credits for eth_getBlockByNumber, plus an additional 1000 credits for eth_getTransactionReceipts (50 calls * 20 credits).

Total credits used: 20 + 20 + (20*50) = 1040

RPC Methods

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'qn_getBlockWithReceipts',
  ["0xF7D1EC"]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"qn_getBlockWithReceipts",
    "params": ["0xF7D1EC"]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "qn_getBlockWithReceipts",
    ["0xF7D1EC"]
  );
  console.log(network);
})();

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"qn_getBlockWithReceipts","params": ["0xF7D1EC"],"id":1,"jsonrpc":"2.0"}'

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'qn_getReceipts',
  ["0xF7D1EC"]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"qn_getReceipts",
    "params": ["0xF7D1EC"]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "qn_getReceipts",
    ["0xF7D1EC"]
  );
  console.log(network);
})();

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"qn_getReceipts","params": ["0xF7D1EC"],"id":1,"jsonrpc":"2.0"}'