Docs

Docs

  • Develop
  • Validate
  • Integrate
  • Learn

›REST API

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

Versions and Changelog

Overview

This page offers a high level overview of the important releases of the Elrond Proxy API, along with recommendations (such as upgrade or transitioning recommendations) for API consumers.

warning

Documentation in this section is preliminary and subject to change.

Elrond Proxy HTTP API v1.1.0

This is the API launched at the Genesis.

Elrond Proxy HTTP API v1.1.1

This API version brought new features such as the hyperblock-related endpoints, useful for monitoring the blockchain. Furthermore, the GET transaction endpoint has been adjusted to include extra fields - for example, the so-called hyperblock coordinates (the nonce and the hash of the containing hyperblock).

This API has never been deployed to the central instance of the Elrond Proxy, available at api.elrond.com. However, until November 2020, this API has been deployed on-premises to several partners and 3rd party services (such as Exchange systems) - in the shape of Observing Squads, set up via the Mainnet installation scripts - version e1.0.0.

This version of the API requires Observer Nodes with tag e1.1.0 or greater.

There are no breaking changes between API v1.1.0 and API v1.1.1 - neither in terms of structure and format of the requests / responses, nor in the scheme of the URL. However, in terms of semantics, the following fixes might lead to breaking changes for some API consumers:

  • GET transaction endpoint has been fixed to report the appropriate status invalid for actually invalid transactions (e.g. not enough balance). In v1.1.0, the reported status was imprecise: partially-executed.
warning

As of November 2020, new API consumers are recommended to use a newer version of the API.

v1.1.0 and v1.1.1 will be deprecated once all existing API consumers are known to have been upgraded to a more recent version.

Elrond Proxy HTTP API v1.1.3

This API version brought additions - new endpoints, such as network/economics or address/shard. Furthermore, the response of vm-values endpoints has been altered. Though, perhaps the most significant change is the renaming of transaction statuses.

This version of the API requires Observer Nodes with tag v1.1.6 or greater.

Between API v1.1.1 and API v1.1.3, the API consumer would observe the following breaking changes:

  • All fields of vm-values endpoints has been renamed (changed casing, among others).
  • The possible set of values for the transaction statuses has been changed: executed has been renamed to success. The statuses received and partially-executed have been merged under the status pending, while the status not-executed has been renamed to fail. For API consumers to not be affected by this change, they should follow the recommendations in Querying the Blockchain.
important

As of November 2020, new API consumers are recommended to switch to this version (or a more recent one) of the API. An Elrond Proxy instance providing this API is already available in the staging environment api-backup.elrond.com.

For API consumers that use on-premises Observing Squads, an updated installer will be provided (on this matter, the work is in progress).

← Virtual MachineProxy →
  • Overview
  • Elrond Proxy HTTP API v1.1.0
  • Elrond Proxy HTTP API v1.1.1
  • Elrond Proxy HTTP API v1.1.3
Made withby the Elrond team.
GithubChat
Main siteWalletExplorerBridgeDocs