zkevm_getBatchByNumber | zkEVM

Polygon zkEVM API method that returns information about a specific batch of transactions based on the batch number.

​

Parameters

• batchNumber — an integer or hexadecimal string representing the batch number.

​

Response

• number — a hexadecimal value representing the batch number.
• coinbase — the address of the sequencer that virtualized this batch, for now, it refers to the Trusted Sequencer address.
• stateRoot — the root of the final state of the batch.
• globalExitRoot — the root of the tree that represents the deposits of the bridge (multichain). Root containing all the local exit roots of all the connected networks (in this case, a local exit root for L1 and another for L2).
• localExitRoot — the root of the tree that represents the deposits of the zkEVM.
• accInputHash — the hash of the inputs used to build the zero-knowledge proof for a batch. Also included in the input is the accInputHash from the previous batch, used for the aggregation of zero-knowledge proofs.
• timestamp — the hexadecimal value of the Unix timestamp representing the exact time of the batch being verified.
• sendSequencesTxHash — the hash of the transaction that virtualized this batch. null when it’s not virtualized yet.
• verifyBatchTxHash — the hash of the transaction that verified this batch. null when it’s not verified yet.
• transactions[] — an array of hashes of all the transactions included in the batch.

​

zkevm_getBatchByNumber code examples

const Web3 = require("web3");
const NODE_URL = "YOUR_CHAINSTACK_ENDPOINT";
const web3 = new Web3(NODE_URL);

web3.extend({
    property: 'zkEVM',
    methods: [{
      name: 'getBatchByNumber',
      call: 'zkevm_getBatchByNumber',
      params: 1,
      inputFormatter: null,
      outputFormatter: null
    }]
  });

async function getBatchByNumber(batchNumber) {
  const output = await web3.zkEVM.getBatchByNumber(batchNumber)
  console.log(output)
}

getBatchByNumber(8128);