Docs

Docs

  • Develop
  • Validate
  • Integrate
  • Learn

›SDK and Tools

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

Proxy

Overview of the Elrond Proxy

Architectural Overview

While any Node in the Network can accept Transaction requests, the Transactions are usually submitted to the Proxy application, which maintains a list of Nodes - Observers - to forward Transaction requests to - these Observers are selected in such manner that any Transaction submitted to them will be processed by the Network as soon and as efficiently as possible.

The Proxy will submit a Transaction on behalf of the user to the REST API of one of its listed Observers, selected for (a) being online at the moment and (b) being located within the Shard to which the Sender's Account belongs. After receiving the Transaction on its REST API, that specific Observer will propagate the Transaction throughout the Network, which will lead to its execution.

The Observer Nodes of the Proxy thus act as a default dedicated entry point into the Network.

It is worth repeating here, though, that submitting a Transaction through the Proxy is completely optional - any Node of the Network will accept Transactions to propagate, given it has not disabled its REST API.

img

Overview of the Elrond Proxy

In the figure above:

  1. The Elrond Network - consisting of Nodes grouped within Shards. Some of these Nodes are Observers.
  2. One or more instances of the Elrond Proxy - including the official one - connect to Observer Nodes in order to forward incoming user Transactions to the Network and to query state within the Blockchain.
  3. The client applications connect to the Network through the Elrond Proxy. Is is also possible for a blockchain-powered application to talk directly to an Observer or even to a Validator.

Official Elrond Proxy

The official instance of the Elrond Proxy is located at https://api.elrond.com.

Setup a Proxy Instance

warning

Documentation for setting up a Proxy is preliminary and subject to change

In order to host a Proxy instance on a web server, one has to first clone and build the repository:

git clone https://github.com/ElrondNetwork/elrond-proxy-go.git
cd elrond-proxy-go/cmd/proxy
go build .

Configuration

The Proxy holds its configuration within the config folder:

  • config.toml - this is the main configuration file. It has to be adjusted so that the Proxy points to a list of chosen Observer Nodes.
  • economics.toml - this file should not be normally altered. It must be kept in sync with the economics configuration of the Network.
  • external.toml - this file holds configuration necessary to Proxy components that interact with external systems. An example of such an external system is Elastic Search - currently, Elrond Proxy requires an Elastic Search instance to implement some of its functionality.

Dependency on Elastic Search

warning

Only the default (official) Proxy instance connects to the official Elastic Search instance. Documentation from this section is preliminary and subject to change.

Currently, two routes provided by the REST API - namely Get Address Transactions and Get Block - resolve the requested resources by querying an Elastic Search instance. This is subject to change. Therefore, if one desires to host a separate Elrond Proxy instance instead of using the official (default) instance, we recommend disabling the Elastic Search Connector by adjusting the configuration file external.toml - the previously mentioned routes will not work, but the rest of Proxy's functionality is unaffected.

← Versions and Changelogerdpy →
  • Architectural Overview
  • Official Elrond Proxy
  • Setup a Proxy Instance
    • Configuration
  • Dependency on Elastic Search
Made withby the Elrond team.
GithubChat
Main siteWalletExplorerBridgeDocs