MegaETH nodes use a ~15-day pruning window for historical state data. Calls targeting a block older than ~15 days (1,296,064 blocks) may fail because the required account and storage history has been pruned. For more details, see the MegaETH Pruning Policy.

Parameters

bundles

array

An array of bundle objects, each containing transactions and optional block override settings

transactions

array

An array of transaction call objects

from

string

The address from which the transaction is sent

to

string

REQUIRED

The address to which the transaction is addressed

gas

string

The integer of gas provided for the transaction execution encoded as hexadecimal

gasPrice

string

The integer of gasPrice used for each paid gas encoded as hexadecimal

value

string

The integer of value sent with this transaction encoded as hexadecimal

data

string

The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation

blockOverride

object

(Optional) The overrides of the execution context block header

number

string

The simulated block number, encoded as a hexadecimal quantity. Defaults to the block number of the first simulated block.

blockHash

object

A dictionary that maps blockNumber to a user-defined hash. It could be queried from the solidity opcode BLOCKHASH

feeRecipient

address

The fee recipient address. Defaults to the fee recipient of the first simulated block.

time

string

The simulated block timestamp in Unix seconds, encoded as a hexadecimal quantity. Defaults to the timestamp of the first simulated block. Each following block increments its timestamp by 1.

difficulty

string

The difficulty of the current block. Defaults to the difficulty of the first simulated block.

gasLimit

string

The gas limit of the current block. Defaults to the difficulty of the first simulated block.

baseFeePerGas

string

The simulated base fee per gas in wei, encoded as a hexadecimal quantity. Defaults to the base fee of the first simulated block.

simulationContext

object

(Optional) The simulation context

blockNumber

string

The Tag 'latest', 'earliest', 'pending', 'safe' or 'finalized', or a hexadecimal block number

transactionIndex

integer

The transaction index of the simulated transactions. Default value of the transaction index is -1, which would place the simulated transactions after the entire block.

stateOverride

object

(Optional) The State Override Set option allows you to change the state of a contract before executing the call, which means you can modify the values of variables stored in the contract, such as balances and approvals for that call without actually modifying the contract. Each address maps to an object containing:

balance

string

The fake balance to set for the account before executing the call

nonce

string

The fake nonce to set for the account before executing the call

code

string

The fake EVM bytecode to inject into the account before executing the call

state

object

The fake key-value mapping to override all slots in the account storage before executing the call

stateDiff

object

The fake key-value mapping to override individual slots in the account storage before executing the call

timeout

integer

The upper limit running time for the simulations in milliseconds. Defaults to 5000 milliseconds.

Returns

array

array

An array of bundles, where each bundle is an array of call results

array

array

An array of call results

value

string

The return data if the call was successful

error

string

The error if the call failed

Request

1
curl -X POST "https://docs-demo.megaeth-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "eth_callMany",
6
  "params": [
7
    [
8
      {
9
        "transactions": [
10
          {
11
            "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
12
            "gas": "0xf4240",
13
            "data": "0xa9059cbb000000000000000000000000bc0E63965946815d105E7591407704e6e1964E590000000000000000000000000000000000000000000000000000000005f5e100"
14
          }
15
        ],
16
        "blockOverride": {
17
          "number": "0x19e4e00"
18
        }
19
      }
20
    ],
21
    {
22
      "blockNumber": "latest",
23
      "transactionIndex": 1
24
    }
25
  ],
26
  "id": 1
27
}'

1
curl -X POST "https://docs-demo.megaeth-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "eth_callMany",
6
  "params": [
7
    [
8
      {
9
        "transactions": [
10
          {
11
            "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
12
            "gas": "0xf4240",
13
            "data": "0xa9059cbb000000000000000000000000bc0E63965946815d105E7591407704e6e1964E590000000000000000000000000000000000000000000000000000000005f5e100"
14
          }
15
        ],
16
        "blockOverride": {
17
          "number": "0x19e4e00"
18
        }
19
      }
20
    ],
21
    {
22
      "blockNumber": "latest",
23
      "transactionIndex": 1
24
    }
25
  ],
26
  "id": 1
27
}'

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.megaeth-mainnet.quiknode.pro/");
5
    const response = await provider.send("eth_callMany", [
6
    [
7
        {
8
            "transactions": [
9
                {
10
                    "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
11
                    "gas": "0xf4240",
12
                    "data": "0xa9059cbb000000000000000000000000bc0E63965946815d105E7591407704e6e1964E590000000000000000000000000000000000000000000000000000000005f5e100"
13
                }
14
            ],
15
            "blockOverride": {
16
                "number": "0x19e4e00"
17
            }
18
        }
19
    ],
20
    {
21
        "blockNumber": "latest",
22
        "transactionIndex": 1
23
    }
24
]);
25
    console.log(response);
26
}
27

28
main();

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.megaeth-mainnet.quiknode.pro/");
5
    const response = await provider.send("eth_callMany", [
6
    [
7
        {
8
            "transactions": [
9
                {
10
                    "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
11
                    "gas": "0xf4240",
12
                    "data": "0xa9059cbb000000000000000000000000bc0E63965946815d105E7591407704e6e1964E590000000000000000000000000000000000000000000000000000000005f5e100"
13
                }
14
            ],
15
            "blockOverride": {
16
                "number": "0x19e4e00"
17
            }
18
        }
19
    ],
20
    {
21
        "blockNumber": "latest",
22
        "transactionIndex": 1
23
    }
24
]);
25
    console.log(response);
26
}
27

28
main();

1
import json
2
from web3 import Web3, HTTPProvider
3
w3 = Web3(HTTPProvider('https://docs-demo.megaeth-mainnet.quiknode.pro/'))
4
response = w3.provider.make_request("eth_callMany", [[{"transactions":[{"to":"0x6b175474e89094c44da98b954eedeac495271d0f","gas":"0xf4240","data":"0xa9059cbb000000000000000000000000bc0E63965946815d105E7591407704e6e1964E590000000000000000000000000000000000000000000000000000000005f5e100"}],"blockOverride":{"number":"0x19e4e00"}}],{"blockNumber":"latest","transactionIndex":1}])
5
print(response)

1
import json
2
from web3 import Web3, HTTPProvider
3
w3 = Web3(HTTPProvider('https://docs-demo.megaeth-mainnet.quiknode.pro/'))
4
response = w3.provider.make_request("eth_callMany", [[{"transactions":[{"to":"0x6b175474e89094c44da98b954eedeac495271d0f","gas":"0xf4240","data":"0xa9059cbb000000000000000000000000bc0E63965946815d105E7591407704e6e1964E590000000000000000000000000000000000000000000000000000000005f5e100"}],"blockOverride":{"number":"0x19e4e00"}}],{"blockNumber":"latest","transactionIndex":1}])
5
print(response)

1
import { createPublicClient, http } from 'viem'
2

3
async function main() {
4
    const client = createPublicClient({
5
        transport: http('https://docs-demo.megaeth-mainnet.quiknode.pro/')
6
    })
7

8
    const result = await client.request({
9
        method: 'eth_callMany',
10
        params: [
11
          [
12
            {
13
              "transactions": [
14
                {
15
                  "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
16
                  "gas": "0xf4240",
17
                  "data": "0xa9059cbb000000000000000000000000bc0E63965946815d105E7591407704e6e1964E590000000000000000000000000000000000000000000000000000000005f5e100"
18
                }
19
              ],
20
              "blockOverride": {
21
                "number": "0x19e4e00"
22
              }
23
            }
24
          ],
25
          {
26
            "blockNumber": "latest",
27
            "transactionIndex": 1
28
          }
29
        ]
30
    })
31

32
    console.log(result)
33
}
34

35
main()

1
import { createPublicClient, http } from 'viem'
2

3
async function main() {
4
    const client = createPublicClient({
5
        transport: http('https://docs-demo.megaeth-mainnet.quiknode.pro/')
6
    })
7

8
    const result = await client.request({
9
        method: 'eth_callMany',
10
        params: [
11
          [
12
            {
13
              "transactions": [
14
                {
15
                  "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
16
                  "gas": "0xf4240",
17
                  "data": "0xa9059cbb000000000000000000000000bc0E63965946815d105E7591407704e6e1964E590000000000000000000000000000000000000000000000000000000005f5e100"
18
                }
19
              ],
20
              "blockOverride": {
21
                "number": "0x19e4e00"
22
              }
23
            }
24
          ],
25
          {
26
            "blockNumber": "latest",
27
            "transactionIndex": 1
28
          }
29
        ]
30
    })
31

32
    console.log(result)
33
}
34

35
main()

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'eth_callMany',
7
  [
8
  [
9
    {
10
      "transactions": [
11
        {
12
          "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
13
          "gas": "0xf4240",
14
          "data": "0xa9059cbb000000000000000000000000bc0E63965946815d105E7591407704e6e1964E590000000000000000000000000000000000000000000000000000000005f5e100"
15
        }
16
      ],
17
      "blockOverride": {
18
        "number": "0x19e4e00"
19
      }
20
    }
21
  ],
22
  {
23
    "blockNumber": "latest",
24
    "transactionIndex": 1
25
  }
26
],
27
  undefined,
28
  'https://docs-demo.megaeth-mainnet.quiknode.pro/'
29
)
30

31
console.log(result)

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'eth_callMany',
7
  [
8
  [
9
    {
10
      "transactions": [
11
        {
12
          "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
13
          "gas": "0xf4240",
14
          "data": "0xa9059cbb000000000000000000000000bc0E63965946815d105E7591407704e6e1964E590000000000000000000000000000000000000000000000000000000005f5e100"
15
        }
16
      ],
17
      "blockOverride": {
18
        "number": "0x19e4e00"
19
      }
20
    }
21
  ],
22
  {
23
    "blockNumber": "latest",
24
    "transactionIndex": 1
25
  }
26
],
27
  undefined,
28
  'https://docs-demo.megaeth-mainnet.quiknode.pro/'
29
)
30

31
console.log(result)

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "eth_callMany",
8
        [
9
            [
10
                {
11
                    "transactions": [
12
                        {
13
                            "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
14
                            "gas": "0xf4240",
15
                            "data": "0xa9059cbb000000000000000000000000bc0E63965946815d105E7591407704e6e1964E590000000000000000000000000000000000000000000000000000000005f5e100"
16
                        }
17
                    ],
18
                    "blockOverride": {
19
                        "number": "0x19e4e00"
20
                    }
21
                }
22
            ],
23
            {
24
                "blockNumber": "latest",
25
                "transactionIndex": 1
26
            }
27
        ],
28
        endpoint_url="https://docs-demo.megaeth-mainnet.quiknode.pro/",
29
    )
30
    print(result)
31

32
asyncio.run(main())

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "eth_callMany",
8
        [
9
            [
10
                {
11
                    "transactions": [
12
                        {
13
                            "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
14
                            "gas": "0xf4240",
15
                            "data": "0xa9059cbb000000000000000000000000bc0E63965946815d105E7591407704e6e1964E590000000000000000000000000000000000000000000000000000000005f5e100"
16
                        }
17
                    ],
18
                    "blockOverride": {
19
                        "number": "0x19e4e00"
20
                    }
21
                }
22
            ],
23
            {
24
                "blockNumber": "latest",
25
                "transactionIndex": 1
26
            }
27
        ],
28
        endpoint_url="https://docs-demo.megaeth-mainnet.quiknode.pro/",
29
    )
30
    print(result)
31

32
asyncio.run(main())

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "eth_callMany",
7
  params: [
8
    [
9
      {
10
        "transactions" => [
11
          {
12
            "to" => "0x6b175474e89094c44da98b954eedeac495271d0f",
13
            "gas" => "0xf4240",
14
            "data" => "0xa9059cbb000000000000000000000000bc0E63965946815d105E7591407704e6e1964E590000000000000000000000000000000000000000000000000000000005f5e100"
15
          }
16
        ],
17
        "blockOverride" => {
18
          "number" => "0x19e4e00"
19
        }
20
      }
21
    ],
22
    {
23
      "blockNumber" => "latest",
24
      "transactionIndex" => 1
25
    }
26
  ],
27
  endpoint_url: "https://docs-demo.megaeth-mainnet.quiknode.pro/"
28
)
29

30
puts result

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "eth_callMany",
7
  params: [
8
    [
9
      {
10
        "transactions" => [
11
          {
12
            "to" => "0x6b175474e89094c44da98b954eedeac495271d0f",
13
            "gas" => "0xf4240",
14
            "data" => "0xa9059cbb000000000000000000000000bc0E63965946815d105E7591407704e6e1964E590000000000000000000000000000000000000000000000000000000005f5e100"
15
          }
16
        ],
17
        "blockOverride" => {
18
          "number" => "0x19e4e00"
19
        }
20
      }
21
    ],
22
    {
23
      "blockNumber" => "latest",
24
      "transactionIndex" => 1
25
    }
26
  ],
27
  endpoint_url: "https://docs-demo.megaeth-mainnet.quiknode.pro/"
28
)
29

30
puts result

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "eth_callMany",
10
            Some(serde_json::json!([
11
    [
12
        {
13
            "transactions": [
14
                {
15
                    "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
16
                    "gas": "0xf4240",
17
                    "data": "0xa9059cbb000000000000000000000000bc0E63965946815d105E7591407704e6e1964E590000000000000000000000000000000000000000000000000000000005f5e100"
18
                }
19
            ],
20
            "blockOverride": {
21
                "number": "0x19e4e00"
22
            }
23
        }
24
    ],
25
    {
26
        "blockNumber": "latest",
27
        "transactionIndex": 1
28
    }
29
])),
30
            None,
31
            Some("https://docs-demo.megaeth-mainnet.quiknode.pro/".into()),
32
        )
33
        .await?;
34

35
    println!("{result}");
36
    Ok(())
37
}

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "eth_callMany",
10
            Some(serde_json::json!([
11
    [
12
        {
13
            "transactions": [
14
                {
15
                    "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
16
                    "gas": "0xf4240",
17
                    "data": "0xa9059cbb000000000000000000000000bc0E63965946815d105E7591407704e6e1964E590000000000000000000000000000000000000000000000000000000005f5e100"
18
                }
19
            ],
20
            "blockOverride": {
21
                "number": "0x19e4e00"
22
            }
23
        }
24
    ],
25
    {
26
        "blockNumber": "latest",
27
        "transactionIndex": 1
28
    }
29
])),
30
            None,
31
            Some("https://docs-demo.megaeth-mainnet.quiknode.pro/".into()),
32
        )
33
        .await?;
34

35
    println!("{result}");
36
    Ok(())
37
}

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'eth_callMany',
4
    params: [[{"transactions":[{"to":"0x6b175474e89094c44da98b954eedeac495271d0f","gas":"0xf4240","data":"0xa9059cbb000000000000000000000000bc0E63965946815d105E7591407704e6e1964E590000000000000000000000000000000000000000000000000000000005f5e100"}],"blockOverride":{"number":"0x19e4e00"}}],{"blockNumber":"latest","transactionIndex":1}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.megaeth-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'eth_callMany',
4
    params: [[{"transactions":[{"to":"0x6b175474e89094c44da98b954eedeac495271d0f","gas":"0xf4240","data":"0xa9059cbb000000000000000000000000bc0E63965946815d105E7591407704e6e1964E590000000000000000000000000000000000000000000000000000000005f5e100"}],"blockOverride":{"number":"0x19e4e00"}}],{"blockNumber":"latest","transactionIndex":1}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.megaeth-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
import requests
2
import json
3

4
url = "https://docs-demo.megaeth-mainnet.quiknode.pro/"
5

6
payload = json.dumps(json.loads("{\"jsonrpc\":\"2.0\",\"method\":\"eth_callMany\",\"params\":[[{\"transactions\":[{\"to\":\"0x6b175474e89094c44da98b954eedeac495271d0f\",\"gas\":\"0xf4240\",\"data\":\"0xa9059cbb000000000000000000000000bc0E63965946815d105E7591407704e6e1964E590000000000000000000000000000000000000000000000000000000005f5e100\"}],\"blockOverride\":{\"number\":\"0x19e4e00\"}}],{\"blockNumber\":\"latest\",\"transactionIndex\":1}],\"id\":1}"))
7
headers = {
8
  'Content-Type': 'application/json'
9
}
10

11
response = requests.request("POST", url, headers=headers, data=payload)
12

13
print(response.text)

1
import requests
2
import json
3

4
url = "https://docs-demo.megaeth-mainnet.quiknode.pro/"
5

6
payload = json.dumps(json.loads("{\"jsonrpc\":\"2.0\",\"method\":\"eth_callMany\",\"params\":[[{\"transactions\":[{\"to\":\"0x6b175474e89094c44da98b954eedeac495271d0f\",\"gas\":\"0xf4240\",\"data\":\"0xa9059cbb000000000000000000000000bc0E63965946815d105E7591407704e6e1964E590000000000000000000000000000000000000000000000000000000005f5e100\"}],\"blockOverride\":{\"number\":\"0x19e4e00\"}}],{\"blockNumber\":\"latest\",\"transactionIndex\":1}],\"id\":1}"))
7
headers = {
8
  'Content-Type': 'application/json'
9
}
10

11
response = requests.request("POST", url, headers=headers, data=payload)
12

13
print(response.text)

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.megaeth-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "eth_callMany",
11
  params: [[{"transactions":[{"to":"0x6b175474e89094c44da98b954eedeac495271d0f","gas":"0xf4240","data":"0xa9059cbb000000000000000000000000bc0E63965946815d105E7591407704e6e1964E590000000000000000000000000000000000000000000000000000000005f5e100"}],"blockOverride":{"number":"0x19e4e00"}}],{"blockNumber":"latest","transactionIndex":1}]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.megaeth-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "eth_callMany",
11
  params: [[{"transactions":[{"to":"0x6b175474e89094c44da98b954eedeac495271d0f","gas":"0xf4240","data":"0xa9059cbb000000000000000000000000bc0E63965946815d105E7591407704e6e1964E590000000000000000000000000000000000000000000000000000000005f5e100"}],"blockOverride":{"number":"0x19e4e00"}}],{"blockNumber":"latest","transactionIndex":1}]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

Response

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": [
5
    [
6
      {
7
        "value": "0x"
8
      }
9
    ]
10
  ]
11
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": [
5
    [
6
      {
7
        "value": "0x"
8
      }
9
    ]
10
  ]
11
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free