Skip to main content
Setting a data request field to [] selects no data. Pass undefined for a wildcard selection:
All array-valued data request fields (e.g. name?: string[] of addEvent() are arrays of acceptable values. That means that you can request e.g. multiple events with a single addEvent() call. Requesting data that way is more efficient than requesting data with many individual calls.
There is no addExtrinsic() method. Request extrinsics as related data with extrinsic: true on an event, call, or specialized request.

​
Events

addEvent(options): Subscribe to Substrate runtime events. options has the following structure:
names must follow the convention ${Pallet}.${NameWithinPallet} with both parts usually capitalized, e.g. Balances.Transfer. You may also request the data related to the events:
  • with call = true the processor will retrieve the parent call and add it to the calls iterable within the block data;
  • with stack = true it will do that with all calls in the entire call stack;
  • with extrinsic = true it will add the parent extrinsic to the extrinsics block data iterable.
Note than events can also be requested by the addCall() method as related data. Selection of the exact data to be retrieved for each log and its optional parent transaction is done with the setFields() method documented on the Fields selection page.

​
Calls

addCall(options): Subscribe to runtime calls (even if wrapped into a system.sudo or util.batch extrinsic). options has the following structure:
The name must follow the convention ${Pallet}.${call_name}. The pallet name is normally capitalized, and the call name is in the snake_case format, as in Balances.transfer_keep_alive. By default, both successful and failed calls are fetched. Select the call.success field and later check it within the batch handler if you need to disambiguate. You may also request the data related to the calls:
  • with events = true the processor will retrieve all the events that the call emitted and add them to the events iterable within the block data;
  • with stack = true it will add all calls in the stack of each matching call, including itself, to the calls iterable;
  • with extrinsic = true it will add the parent extrinsic to the extrinsics block data iterable.
Note than calls can also be requested by the addEvent() method as related data. Selection of the exact data to be retrieved for each log and its optional parent transaction is done with the setFields() method documented on the Fields selection page.

​
Specialized setters

​
addEvmLog(options)

A SubstrateBatchProcessor configuration setter that subscribes it to EVM.Log events by contract address(es) and/or EVM log topics. options have the following structure:
Related data retrieval and field selection are identical to addEvent().

​
addEthereumTransaction(options)

A SubstrateBatchProcessor configuration setter that subscribes it to Ethereum.transact calls by contract address(es) and/or function sighashes. options have the following structure:
Related data retrieval and field selection are identical to that addCall(). The processor with fetch both successful and failed transactions. Further, there’s a difference between the success of a Substrate call and the internal EVM transaction. The transaction may fail even if the enclosing Substrate call has succeeded. Use events = true to retrieve Ethereum.Executed events that can be used to figure out the EVM transaction status (see getTransactionResult()).

​
addContractsContractEmitted(options)

Subscribe to the ink! events (Contracts.ContractEmitted) of the WASM runtime. options has the following structure:
Contract addresses must be specified as hex strings, so make sure to decode them if yours are encoded with ss58. Related data retrieval and field selection are identical to addEvent().

​
addReviveContractEmitted(options)

Subscribe to Revive.ContractEmitted events. Filters support contract and topic0 through topic3; related-data flags are the same as for addEvent().

​
addGearMessageQueued(options)

​
addGearUserMessageSent(options)

Structure of options is identical for both methods:
The methods above subscribe to the events Gear.MessageQueued and Gear.UserMessageSent emitted by the specified Gear program. Related data retrieval and field selection are identical to addEvent().