Skip to main content

Direct RPC queries

In order to make on-chain calls, one must set up a JSON-RPC endpoint using setRpcEndpoint(). We recommend using a private endpoint from e.g. BlastAPI or the Subsquid Cloud's RPC proxy service, and set it via an environment variable:


You can define the RPC_ETH_HTTP in three ways:

  • for local runs, simply update the local .env file;
  • for squids deployed to Cloud define it as a secret on your Cloud account;
  • if you are using the RPC proxy service, leave it to the Cloud to define it for you.

Contract class

The EVM contract state is accessed using the Contract class generated by squid-evm-typegen. It takes a handler context and a contract address as constructor arguments. The state is always accessed at the context block height unless explicitly defined in the constructor.

For example, assume that we index an ERC721 contract. Typescript ABI module generated with squid-evm-typegen will contain the following class:

export class Contract extends ContractBase {
balanceOf(owner: string): Promise<ethers.BigNumber> {
return'balanceOf', [owner])

Now suppose we want to query our contract from the batch handler. To create a Contract pass the context object and the current Block to its constructor, then query the contract state at that block:

// ...
const CONTRACT_ADDRESS = '0xb654611f84a8dc429ba3cb4fda9fad236c505a1a' TypeormDatabase(), async ctx => {
for (const block of ctx.blocks) {
const contract = new abi.Contract(ctx, block.header, CONTRACT_ADDRESS)
// query the contract state at the current block
const uri = await contract.balanceOf('0xd8da6bf26964af9d7eed9e03e53415d37aa96045')
// ...

Batch state queries

The MakerDAO Multicall contract was designed to batch multiple state queries into a single contract call. In the context of indexing, it normally significantly improves the indexing speed since JSON RPC calls are typically the bottleneck.

Multicall contracts are deployed in many EVM chains, see the contract repo for addresses. You can use any of them with a multicall Typescript module that is generated when running squid-evm-typegen with --multicall option. The module exports a Multicall class with this method:

tryAggregate<Args extends any[], R>(
func: Func<Args, {}, R>,
calls: [address: string, args: Args][],
paging?: number
): Promise<MulticallResult<R>[]>

The arguments are as follows:

  • func: the contract function to be called
  • calls: an array of tuples [contractAddress: string, args]. Each specified contract will be called with the specified arguments.
  • paging an (optional) argument for the maximal number of calls to be batched into a single JSON PRC request. Note that large page sizes may cause timeouts.

A typical usage is as follows:

// generated by evm-typegen
import { functions } from './abi/mycontract'
import { Multicall } from './abi/multicall'

const MY_CONTRACT = '0xac5c7493036de60e63eb81c5e9a440b42f47ebf5'
const MULTICALL_CONTRACT = '0x5ba1e12693dc8f9c48aad8770482f4739beed696' TypeormDatabase(), async (ctx) => {
for (let c of ctx.blocks) {
// some logic
const lastBlock = ctx.blocks[ctx.blocks.length - 1]
const multicall = new Multicall(
// call MY_CONTRACT.myContractMethod('foo') and MY_CONTRACT.myContractMethod('bar')
const args = ['foo', 'bar']
const results = await multicall.tryAggregate(
functions.myContractMethod, => [MY_CONTRACT, a]) as [string, any[]],

results.forEach((res, i) => {
if (res.success) {`Result for argument ${args[i]} is ${res.value}`)