Multicall.js

Utilising the Ethereum Multi-call contract, this package helps engages with it by automatically flattening, encoding, decoding and un-flattening.

Install

yarn add multicall.js

Multicall Contract Addresses

Chain	Address
Mainnet	0xeefba1e63905ef1d7acba5a8513c70307c1ce441
Kovan	0x2cc8688c5f75e365aaeeb4ea8d6a480405a48d2a
Rinkeby	0x42ad527de7d4e9d9d011ac45b31d8551f8fe9821
Görli	0x77dca2c955b15e9de4dbbcf1246b4b85b651e50e
Ropsten	0x53c43764255c17bd724f74c4ef150724ac50a3ed
xDai	0xb5b692a88bdfc81ca69dcb1d924f59f0413a602a
BSC	0xB94858b0bB5437498F5453A16039337e5Fdc269C
Polygon	0x11ce4B23bD875D7F5C6a31084f55fDe1e9A87507

Example

Constructor params

• Web3 instance
• (Defaults to main net) Multicall contract address
• (Defaults to [300, 100, 25]) Chunk sizes

import { MultiCall } from 'eth-multicall'
const web3 = new Web3(...)
const multiCallContract = '0x5Eb3fa2DFECdDe21C950813C665E9364fa609bD2'
const multicall = new MultiCall(web3, multiCallContract);

Request

 const addresses = [
   "0x960b236A07cf122663c4303350609A66A7B288C0",
   "0x1f573d6fb3f13d689ff844b4ce37794d79a7ff1c",
 ];

 const tokens = addresses.map((address) => {
   const token = new web3.eth.Contract(ABIERC20Token, address);
   return {
     symbol: token.methods.symbol(),
     decimals: token.methods.decimals(),
   };
 });

const [tokensRes] = await multiCall.all([tokens]);

[
    {
        symbol: "ANT",
        decimals: "18",
    },
    {
        symbol: "BNT",
        decimals: "18",
    }
]

• To add the contracts address to the response add a property with the string value 'originAddress' to the schema.

{
  symbol: token.methods.symbol(),
  decimals: token.methods.decimals(),
  tokenAddress: 'originAddress'
}

=>

{
    symbol: "ANT",
    decimals: "18",
    tokenAddress: "0x960b236A07cf122663c4303350609A66A7B288C0"
}

• Meta strings are also supported to track any data that you might wish to be retained

{
  symbol: token.methods.symbol(),
  decimals: token.methods.decimals(),
  tokenAddress: 'originAddress'
  foo: 'bar'
}

=>

{
    symbol: "ANT",
    decimals: "18",
    tokenAddress: "0x960b236A07cf122663c4303350609A66A7B288C0",
    foo: 'bar'
}

• Failed requests currently returning undefined with no sign or indication of error.