Skip to content

wrap queries of indexer data into http API for ref-finance front-end.

License

Notifications You must be signed in to change notification settings

ref-finance/indexer-helper

Repository files navigation

ref-indexer-helper

A light web server using Flask + Gunicorn + Nginx

Feature List

feature remark URL
welcome msg version info /
timestamp current timestamp at server-side /timestamp
latest actions user's latest actions on REF /latest-actions/<account_id>
liquidity pools user's liquidity pools on REF /liquidity-pools/<account_id>
all farms -- /list-farms
pools info for distinct token pair -- /list-top-pools
token price by token id -- /get-token-price?token_id=<token_id>
all tokens price price from coingecko or native pool /list-token-price
all tokens metadata -- /list-token
pool info by single pool id -- /get-pool?pool_id=<pool_id>
all pools info -- /list-pools
pools info by tokens -- /list-pools-by-tokens?token0=<token0>&token1=<token1>
pools info by pool ids -- /list-pools-by-ids?ids=id0|id1|...|idn
provide general info of whitelist pools volume, liquidity /whitelisted-active-pools
provide info for coingecko price, volume, liquidity of all global whitelisted token pools /to-coingecko

Usage

Get user's action history of ref-finance

# request ref-user's latest 10 actions on mainnet
http://localhost/latest-actions/<account_id>
# response in json type
[
    ["<timestamp>", "<method>", "<args>", "<attached_deposit>"],
    ["<timestamp>", "<method>", "<args>", "<attached_deposit>"],
    ...
]

get user's liquidity pools

http://localhost/liquidity-pools/<account_id>
# response in json type
[
    {<pool info>},
    {<pool info>},
    ...
]

List pools with max liquidity in each token pair

http://localhost/list-top-pools
# response in json type
[
    {<pool info>},
    {<pool info>},
    ...
]

list all token with cur market price from coingecko

http://localhost/list-token-price
# response in json type
{
    token_id: {"pirce": "", "decimal": 8, "symbol": ""},
    token_id: {"pirce": "", "decimal": 8, "symbol": ""},
    ...
}

list all pools in ref-finance

http://localhost/list-pools
# response in json type
[
    {<pool info>},
    {<pool info>},
    ...
]

given two tokens, list all pools using that token pair.

http://localhost/list-pools-by-tokens?token0=xxx&token1=xxxx
# response in json type
[
    {<pool info>},
    {<pool info>},
    ...
]

Get all farms in ref-farming

# request for mainnet
http://localhost:8000/list-farms
# response
[
    {...}, # FarmInfo
    {...}, # FarmInfo
    ...
    {...}, # FarmInfo
]

Build

python3 -m venv venv
source venv/bin/activate
# apt-get install libpq-dev
pip install flask
pip install flask-cors
pip install gunicorn
pip install psycopg2
pip install base58
pip install redis
pip install requests
# Flask (2.0.0)
# gunicorn (20.1.0)
# psycopg2 (2.8.6)

deploy backend

Call deploy_xxx.sh to deploy backend shell scripts with correct network id. Then make those scripts be periodically called.
There are several ways to do that:

  • crontab
  • flask_apscheduler
  • other third-party tools

Start Service

source start_server.sh

Stop Service

pstree -ap|grep gunicorn
kill -9 <pid>

About

wrap queries of indexer data into http API for ref-finance front-end.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published