Field

Description

from

The address initiating, signing, the transaction

to

Address receiving the transaction

nonce

The from address nonce (transaction count from that address)

gas

Maximum amount of gas available to the transaction

gasPrice

Amount, in wei, per unit of gas

value

Amount of ETH transferred directly from from address

hash

Transaction id hash unique for every transaction

input

Data sent to transaction. For direct value transfers from one external account to another, this field contains 0x. For contract calls, this value contains the contract method signature and params as a hex string.

v, r, s

Transaction signature components (ECDSA signature components and recovery id)

blockHash

Block id hash for transactions that are on-chain. Field is null unless notification status is confirmed or failed

blockNumber

Block number for transactions that are on-chain. Field is null unless notification status is confirmed or failed

Field

Description

system

Blockchain of this transaction (currently only ethereum supported)

network

Network name of this transaction (see table to supported networks below)

status

New status of this transaction (see table of supported status values below)

timePending

Optional. Time difference in milliseconds between first pending detection and first on-chain detection. Value is empty string if first detection is on-chain (i.e. there was no pending detection. This field is present only if transaction status indicates an on-chain state (confirmed or failed)

apiKey

Blocknative API key associated with the notification

monitorVersion

Version number of the Blocknative monitor that detected the transaction state change

monitorId

Identifier of the Blocknative monitor that first detected the transaction state change

serverVersion

Version number of the Blocknative server that delivered the notification

timestamp

Timestamp when notification is sent

asset

Optional. Symbol of the asset being transferred, e.g. ETH. This field is present only if transaction directly transfers Ether or is an ERC20 token transfer

direction

Optional. Indicates if funds are incoming or outgoing relative to the watchedAddress. This field is present only if notification triggered by watchedAddress

counterparty

Optional. Address of recipient of funds if watchedAddress is the sender in the transaction, address of sender of funds if watchedAddress is the recipient in the transaction. This field is present only if notification triggered by watchedAddress

watchedAddress

Optional. Watched address which triggered the notification. This field is present only if notification triggered by watchedAddress

Field

Description

contractType

Name of the called contract

contractAddress

Address of the called contract

methodName

Name of the called method

params

Optional. A series of keys and values specific to the contract method. This field is present only if the contract method call includes parameters.

Field

Description

internalTransactions

Array of objects containing details of each internal transaction (see below)

netBalanceChanges

Object containing details of balance changes for all addresses involved in internal transactions (see below)

Field

Description

type

Type of internal transaction (one of CALL, DELEGATECALL, STATICCALL, CALLCODE)

from

Address initiating the internal transaction call (typically the parent (main) transaction's contract address

to

Address the internal transaction is calling or sending value to

input

Data sent to internal transaction. For value transfers from external account initiating parent (main) transaction to another external account, this field contains 0x. For contract calls, this value contains the contract method signature and params as a hex string.

gas

Maximum amount of gas available to the internal transaction

gasUsed

Amount of gas actually used executing the internal transaction

value

Amount of ETH transferred directly to to address from parent (main) transaction from address.

contractCall

Optional. A series of keys and values specific to the contract method . This object is present only if the contract method call includes parameters and Blocknative decodes the internal transaction contract call (e.g. an ERC20 transfer). For details see decoded contract payload above. NOTE: If the Internal transaction is an ERC20 transfer or transferFrom call, the contractCall object will include an additional field, contractAlias with the symbol of the token transferred.

Field

Description

<address>

Address involved in internal transaction. Each address contains an array of balances changes, one for each counterparty

asset

Details of the asset being transferred. Contains type and symbol.

delta

Amount of value transfer (balance change) in wei to the <address>. Outgoing value is represented as a negative balance change and incoming value is represented as a positive balance change

type

The type of asset transferred (e.g. "ether")

symbol

The symbol of the asset transferred. "ETH" or appropriate ERC20 symbol

breakdown

Array of individual transfers to <address> for the current asset

counterparty

Address of the other side of the transfer relative to the <address>

amount

The amount of asset transferred with this counterparty

Name

Id

main

1

ropsten

3

rinkeby

4

goerli

5

kovan

42

Key

Description

pending

server detected transaction in mempool indicating transaction is pending

speedup

server detected replacement transaction in mempool with more gas

cancel

server detected replacement transaction in mempool sent to another wallet account (not contract) with more gas and no value

confirmed

server detected transaction on blockchain as confirmed

failed

server detected transaction on blockchain as failed

dropped

server detected transaction removed from mempool and not confirmed in a block