Skip to content
Switch branches/tags

Build Status PyPI


This is intended to give an introduction ICON RPC Server. ICON RPC Server receives request messages from external clients, and send a response to clients. when receiving the message, ICON RPC Server checks the method of requests and transfer it to appropriate components (loopchain or ICON Service). ICON RPC Server also checks the basic syntax error of messages.

  • ICON RPC Server provides old version protocol

Building source code

First, clone this project. Then go to the project folder and create a user environment and run build script.

$ python3 -m venv venv        # Create a virtual environment.
$ source venv/bin/activate    # Enter the virtual environment.
(venv)$ make build            # run build
(venv)$ ls dist/              # check result wheel file


This chapter will explain how to install ICON RPC Server on your system.


ICON RPC Server development and execution requires following environments.

  • OS: MacOS, Linux
    • Windows are not supported yet.
  • Python
    • Make Virtual Env for Python 3.7.x

      Now we support 3.7.x only. Please upgrade python version to 3.7.x.

    • check your python version

      $ python3 -V
    • IDE: Pycharm is recommended.

Setup on MacOS / Linux

$ python3 -m venv work      # Create a virtual environment.
# Install the ICON RPC Server
(work) $ pip install iconrpcserver



This project follows the Apache 2.0 License. Please refer to LICENSE for details.