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 qngetBlockWithReceipts and qngetReceipts 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 ethgetBlockReceipts:

- The qngetReceipts method will make 1 call
- The qngetBlockWithReceipts method will make 1 call

For blockchains that don’t support ethgetBlockReceipts:

- The qngetReceipts method will make X number of ethgetTransactionReceipt calls, where X is the number of transactions in the block.
- The qngetBlockWithReceipts method will make X number of ethgetTransactionReceipt calls, where X is the number of transactions in the block, and 1 additional call to ethgetBlockByNumber.

Examples:

If method qngetReceipts is called on Ethereum Mainnet, you will be charged 20 credit for the qngetblockwithreceipts call, plus 20 credits for ethgetBlockReceipts.

Total credits used: 20 + 20 = 40.

If method qngetBlockWithReceipts is called on Fantom Mainnet with a block that contains 50 transactions, you will be charged 20 credit for qngetBlockWithReceipts, 20 credits for ethgetBlockByNumber, plus an additional 1000 credits for ethgetTransactionReceipts (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"}'