Querying the Blockchain

Querying broadcasted transactions

In order to query a transaction and inspect its status, please follow:

Querying a recently broadcasted transaction may not return the hyperblock coordinates (hyperblock nonce and hyperblock hash) in the response. However, once the transaction is fully executed - according to the status field (whether with success or with failure), the hyperblock coordinates will be set and present in the response.

For regular transfer transactions, the transaction status has the following meaning:

Status

Meaning

executed

The transaction has been fully executed - with respect to Elrond's sharded architecture, it has been executed in both source shard and destination shard.

invalid

The transaction has been executed, with failure (not enough balance at sender's side).

For smart contract transactions, the transaction status has the following meaning:

Status

Meaning

executed

The smart contract transaction has been executed, but not necessarily with success - transactions executed with errors such as user error (raised by the contract) or out of gas also have this status.

Documentation in this sub-section (about smart contract transactions) is preliminary and subject to change.

Querying hyperblocks and fully executed transactions

In order to query executed transactions, please follow:

Querying finality information

In order to fetch the nonce (the height) of the latest final (hyper) block, one would perform the following request against the on-premises Proxy instance:

curl http://myProxy:8079/network/status/4294967295

Above, 4294967295 is a special number - the ID of the Metachain.

From the response, one should be interested into the field erd_highest_final_nonce, which will point to the latest final hyperblock.

"data": {
"status": {
"erd_highest_final_nonce": 54321
...
}
},
...
}