Hi everyone, this is Bongan Ha from the ICON team.
I’m happy to introduce our initial implementation of the Rosetta Data & Construction API on the ICON Network. The repository is now public at GitHub - icon-project/rosetta-icon
ICON is a decentralized general-purpose smart contract platform that is pursuing a fully interoperable blockchain. ICON is the world’s 60ths largest blockchain with a market cap of about $1 billion, and the ecosystem is growing rapidly. More details can be found in the below links.
- ICON Network - https://iconrepublic.org/
- ICON Foundation - https://icon.foundation/
- ICON Community: https://icon.community
- ICON Community Forum: https://forum.icon.community
- ICON Project Telegram: Telegram: Contact @hello_iconworld
- ICON Community Telegram: Telegram: Contact @iconcm
- ICON Developer Telegram: Telegram: Contact @icondevs
- Medium: Hello ICON World – Medium
- Reddit: https://www.reddit.com/r/helloicon/
- Twitter: https://twitter.com/helloiconworld
Documentation
A basic guide is provided at here and you can find details on the ICON API at here
Node Deployment
System Requirements
ICON Citizen Node has been tested on an AWS c5.2xlarge instance. This instance type has 4 vCPU and 16 GB of RAM.
Run in Docker Compose
cd docker
docker-compose up
Run Local
pre-requirements
- Run Citizen Node: ref) Running ICON Node
- Build rosetta-icon: make
- Run rosetta-icon with enviroment variables (ex TestNet)
- ENDPOINT=http://localhost:9000
- MODE=ONLINE # (ONLINE, OFFLINE)
- NETWORK=TESTNET # (MAINNET, TESTNET, ZICON, DEVNET)
- PORT=8080
Run Local without Citizen Node
pre-requirements
- Build rosetta-icon: make
- Run rosetta-icon with enviroment variables (ex TestNet)
- ENDPOINT=https://testwallet.icon.foundation
- MODE=ONLINE # (ONLINE, OFFLINE)
- NETWORK=TESTNET # (MAINNET, TESTNET, ZICON, DEVNET)
- PORT=8080
Caution
- ICON Node Required Full DB.
- ICON Node doesn’t support light client.
- Recommend Docker-compose DB Snapshot(FASTEST_START: “yes”)
Docker Compose Configration
version: '3'
services:
prep-node:
image: 'iconloop/prep-node:dev'
container_name: "prep-node"
restart: "on-failure"
environment:
LOOPCHAIN_LOG_LEVEL: "SPAM" # Log Level
ICON_LOG_LEVEL: "DEBUG" # Log Level
DEFAULT_PATH: "/data/loopchain" # DB, SCORE Storage Path
LOG_OUTPUT_TYPE: "file" # Log export (file, console)
SERVICE: "testnet" # mainnet, testnet(을지로), zicon(파고다)
IS_AUTOGEN_CERT: "true" # Auto Generate Cert
FASTEST_START: "yes" # download DB Snapshot
IS_COMPRESS_LOG: "true"
USER_DEFINED_ENV: |
.CHANNEL_OPTION.icon_dex.crep_root_hash=0xb7cc19da5bff37a2c4954e16473ab65610a9481f8f864d7ea587c65bff82402f|configure_json
cap_add:
- SYS_TIME
volumes:
- ./data/loopchain/mainnet:/data/loopchain/
- ./cert:/prep_peer/cert
ports:
- '7100:7100' # GRPC
- '9000:9000' # RPC
rosetta:
image: 'jinyyo/rosetta-test'
container_name: "rosetta"
restart: "on-failure"
environment:
ENDPOINT: 'http://localhost:9000'
MODE: 'ONLINE'
NETWORK: 'TESTNET'
ports:
- '8080:8080'
Report and Feedback
We are happy to get any reports or feedback on this implementation. Please feel free to share it on this repository or this thread.