Docs

Docs

  • Develop
  • Validate
  • Integrate
  • Learn

›Integrators

Welcome to Elrond

  • Welcome to Elrond

Technology

  • Architecture Overview
  • Entities
  • Chronology
  • Secure Proof of Stake
  • Adaptive State Sharding
  • The Arwen WASM VM
  • Cross Shard Transactions

Wallet

  • Web Wallet
  • Ledger

Validators

  • Overview
  • System Requirements
  • Install a Mainnet Node

    • Scripts & User config
    • Installing a Validator Node
    • Optional Configurations
    • How to use the Docker Image

    Install a Testnet Node

    • Scripts & User config
    • Installing & updating
    • Manage your testnet node

    Install a Devnet Node

    • Scripts & User config
    • Installing & updating
    • Manage your devnet node

    Manage your keys

    • Validator Keys
    • Wallet Keys
    • Protecting your keys

    Staking, Unstaking, Unjailing

    • Staking, unstaking and unjailing
    • Staking
    • Unjailing
  • Rating
  • Node CLI
  • Useful Links & Tools
  • FAQs

Developers

    Tutorials

    • The Counter Smart Contract
    • Start Building - Crowdfunding Tutorial
    • The Crowdfunding Smart Contract (part 2)

    Signing Transactions

    • Signing Transactions
    • Tools for signing
    • Signing programmatically
  • ESDT tokens
  • The Staking Smart Contract
  • Developer reference

    • Mandos tests reference
    • The Elrond Serialization Format
  • Setup a Local Testnet
  • Setup a Local Testnet (advanced)
  • Creating Wallets

SDK and Tools

    REST API

    • REST API
    • Addresses
    • Transactions
    • Network
    • Nodes
    • Blocks
    • Virtual Machine
    • Versions and Changelog
  • Proxy
  • erdpy

    • erdpy
    • Installing erdpy
    • Configuring erdpy
    • erdpy CLI
    • Deriving the Wallet PEM file
    • Sending bulk transactions
    • Writing and running erdpy scripts
  • erdjs
  • erdgo
  • erdjava
  • erdwalletjs-cli

Integrators

  • Observing Squad
  • Accounts Management
  • Creating Transactions
  • Querying the Blockchain

Detailed comparison

  • Overview
  • Elrond vs. Ethereum Serenity
  • Elrond vs. Zilliqa
  • Elrond vs. Dfinity
  • Elrond vs. Algorand
  • Elrond vs. Harmony

Querying the Blockchain

Querying broadcasted transactions

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

  • get transaction by hash
  • get transaction status by hash

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.

Transaction Status

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

StatusMeaning
success or executedThe transaction has been fully executed - with respect to Elrond's sharded architecture, it has been executed in both source shard and destination shard.
invalidThe transaction has been processed with failure (not enough balance at sender's side).
pending or received or partially-executedThe transaction has been accepted in the mempool or accepted and partially executed (in the source shard).
fail or not-executedRegular transfer transactions cannot reach this status.
warning

The statuses are (broadly speaking) directly fetched from the Observer Nodes themselves. The Node v1.1.6 returns different statuses than previous versions. For example, the status executed has been renamed to success, while the statuses received and partially-executed have been merged under the status pending.

Currently, the HTTP API does not implement a versioning scheme (work is in progress on this matter) and thus does not yet provide a layer that abstracts away this renaming of statuses. Therefore the API consumers - in order to appropriately handle the data coming from both versions of the Node (prior to v1.1.6 and after v1.1.6) - are recommended to:

✔ handle success and executed as synonyms

✔ handle pending, received and partially-executed as synonyms

✔ handle fail and not-executed as synonyms.

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

StatusMeaning
success or executedThe 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 - the erroneous scenarios will be handled in a future release.
invalidThe transaction has been processed with failure at sender's side (e.g. not enough balance), but did not actually reach the Smart Contract for execution.
pending or received or partially-executedThe transaction has been accepted in the mempool or accepted and partially executed (in the source shard).
failNot yet applicable. Reserved for future use - for transactions with user error.
important

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:

  • get hyperblock by nonce
  • get hyperblock by hash

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
      ...
    }
  },
  ...
}

← Creating TransactionsOverview →
  • Querying broadcasted transactions
  • Transaction Status
  • Querying hyperblocks and fully executed transactions
  • Querying finality information
Made withby the Elrond team.
GithubChat
Main siteWalletExplorerBridgeDocs