Overview of HOPR transfers on xDai

[QYuQianchen]

The following is an issue for bounty, meant for external contributors to pick up and work on the analytics of HOPR tokens. Click here to check all the bounties and here to check all the open positions at HOPR.

Introduction

Recently our community has launched a three-phase token distribution on xDai chain and Ethereum blockchain at the end of February 2021. More than 30,000 of transactions were generated from various decentralized exchanges (DEX) since the launch. The HOPR token was even ranked as one of the top 20 tokens by trading volume on CoinMarketCap.

From the vast public data, we want to get a better understanding of HOPR trading activities. We invite you to explore the public Ethereum and xDai chain and provide answers to the following questions with source code and visualizations.

HOPR token was deployed on Ethereum mainnet on the 19th Feb. Shortly after the deployment, 85 million HOPR were minted for the token launch. 50 million out of the 85 million were pre-sale (1st phase of token launch) tokens that were bridged to xDai chain for HOPR Genesis DAO members to purchase. HOPR Genesis DAO members are accounts that hold gHOP tokens. Those presale tokens have a locking period until almost the end of the Balancer LBP sale (2nd phase of token launch). DAI collected from presale and the remainder of pre-sale tokens were bridged back to Ethereum mainnet to be put into the Balancer LBP sale pool, together with the 30 million HOPR tokens planned for the 2nd phase of token launch. Towards the end of the LBP sale, pre-sale tokens were unlocked on the xDai chain. All the DAI and HOPR staying in the LBP pool were transferred to Uniswap for the 3rd phase of token launch. Those tokens were the initial liquidity providers for the HOPR/DAI pair. This pool remains open.

Besides the 85 million token launch, there are around 13.3 million circulating HOPR tokens later minted for bounties (bridged to xDai) and 31.9 million tokens minted for treasury.

Some analytics has been done for the LBP sale part of HOPR token launch. See the dashboard here.

Task Description

Due to the cross-chain nature of HOPR tokens (living both on Ethereum mainnet and xDai chain), we would like to gain a bird view on the HOPR token transfers on both chains:

1. Visualize life-cycle (provenance) of xHOPR in a network graph: a. Token minted by OmniBridge (bridging from Ethereum Mainnet) b. Distribution/Transfer/Trading activities with EOAs/contracts (e.g. “HoprPresale”, Pancake swap, “HoprDistributor”) c. Token burnt by OmniBridge (bridging back to Ethereum Mainnet)

Definition of complete

• [ ] A working Nodejs project or python project or with another data analytics platform (e.g. DuneAnalytics/BigQuery) that contains scripts/queries that extracts HOPR transfers on Ethereum mainnet and xDai chain. Instruction on installation and running should be well-documented.
• [ ] Visualize xHOPR token transfers in a network graph, where a node represents an Ethereum address and a directional edge denotes a token transfer. The amount of tokens being transferred and the timestamp of the transfer is labeled on the edge.

Useful sources

• HOPR price
• HOPR markets
• General information on HOPR token
• Contracts:
  • HOPR token
  • xHOPR
  • HOPR presale
  • HOPR LBP
  • HOPR/DAI UNI pool
  • HOPR Farm
• Twitter API
• Analytics dashboards
  • Phase 2 - LBP
  • Liquidity mining - Farm
• HOPR medium blog
  • Analysis on Presale
  • Analysis on LBP
  • Breakdown on cost and schedule of HOPR farm

[gitcoinbot]

Issue Status: 1. Open 2. Started 3. Submitted 4. Done

---

This issue now has a funding of 400.0 HOPR (236.52 USD @ $0.59/HOPR) attached to it as part of the hoprnet fund.

• If you would like to work on this issue you can 'start work' on the Gitcoin Issue Details page.
  • Want to chip in? Add your own contribution here.
  • Questions? Checkout Gitcoin Help or the Gitcoin's Discord
  • $1,976,277.86 more funded OSS Work available on the Gitcoin Issue Explorer

[QYuQianchen]

Devide this bounty into 2. The other half can be found in issue

[gitcoinbot]

@longin-imperial Hello from Gitcoin Core - are you still working on this issue? Please submit a WIP PR or comment back within the next 3 days or you will be removed from this ticket and it will be returned to an ‘Open’ status. Please let us know if you have questions!

• [x] reminder (3 days)
• [ ] escalation to mods (6 days)

Funders only: Snooze warnings for 1 day | 3 days | 5 days | 10 days | 100 days

[gitcoinbot]

@longin-imperial Hello from Gitcoin Core - are you still working on this issue? Please submit a WIP PR or comment back within the next 3 days or you will be removed from this ticket and it will be returned to an ‘Open’ status. Please let us know if you have questions!

• [x] reminder (3 days)
• [ ] escalation to mods (6 days)

Funders only: Snooze warnings for 1 day | 3 days | 5 days | 10 days | 100 days

[gitcoinbot]

@longin-imperial Hello from Gitcoin Core - are you still working on this issue? Please submit a WIP PR or comment back within the next 3 days or you will be removed from this ticket and it will be returned to an ‘Open’ status. Please let us know if you have questions!

• [x] reminder (3 days)
• [ ] escalation to mods (6 days)

Funders only: Snooze warnings for 1 day | 3 days | 5 days | 10 days | 100 days

[gitcoinbot]

@longin-imperial Hello from Gitcoin Core - are you still working on this issue? Please submit a WIP PR or comment back within the next 3 days or you will be removed from this ticket and it will be returned to an ‘Open’ status. Please let us know if you have questions!

• [x] reminder (3 days)
• [ ] escalation to mods (6 days)

Funders only: Snooze warnings for 1 day | 3 days | 5 days | 10 days | 100 days

[gitcoinbot]

@d10-cat Hello from Gitcoin Core - are you still working on this issue? Please submit a WIP PR or comment back within the next 3 days or you will be removed from this ticket and it will be returned to an ‘Open’ status. Please let us know if you have questions!

• [x] reminder (3 days)
• [ ] escalation to mods (6 days)

Funders only: Snooze warnings for 1 day | 3 days | 5 days | 10 days | 100 days

[gitcoinbot]

@d10-cat Hello from Gitcoin Core - are you still working on this issue? Please submit a WIP PR or comment back within the next 3 days or you will be removed from this ticket and it will be returned to an ‘Open’ status. Please let us know if you have questions!

• [x] reminder (3 days)
• [ ] escalation to mods (6 days)

Funders only: Snooze warnings for 1 day | 3 days | 5 days | 10 days | 100 days

[gitcoinbot]

@d10-cat Hello from Gitcoin Core - are you still working on this issue? Please submit a WIP PR or comment back within the next 3 days or you will be removed from this ticket and it will be returned to an ‘Open’ status. Please let us know if you have questions!

• [x] reminder (3 days)
• [ ] escalation to mods (6 days)

Funders only: Snooze warnings for 1 day | 3 days | 5 days | 10 days | 100 days

[QYuQianchen]

Hi @niklr! As you've already included your work on xDAI in your submission for issue #9. Could you please also apply for this bounty?

Also, as your PR #13 is merged and deployed. Could you extend your application and include "the amount of token being transferred per transaction" along with "the number of token transfers"?

[niklr]

Hey @QYuQianchen! Thanks for the feedback! I will change the application so that multiple data sources are possible; The Graph, RPC and local JSON. First it will try to get live data from The Graph, if this should fail the app will check if an RPC endpoint is configured and if so use it. In case this should fail as well, the last resort will be local JSON files with stale data (as it is now).

I assume "the amount of token being transferred per transaction" means to label the edges (amount of tokens + timestamp) and "the number of token transfers" means to label the nodes (address + number of mint/burn/transfer events). If this is not what you mean, let me know. In any case, labels will be tricky performance-wise with so many data points but I will give it a shot! Maybe just display them when zoomed in.

[niklr]

Just a short update: I'm currently experimenting with NetV.js and Stardust to render the network graph with WebGL. So far it looks very promising!

[gitcoinbot]

@niklr Hello from Gitcoin Core - are you still working on this issue? Please submit a WIP PR or comment back within the next 3 days or you will be removed from this ticket and it will be returned to an ‘Open’ status. Please let us know if you have questions!

• [x] reminder (3 days)
• [ ] escalation to mods (6 days)

Funders only: Snooze warnings for 1 day | 3 days | 5 days | 10 days | 100 days

[niklr]

Visualization is almost done. Next will be the integration with TheGraph to extend the transfer information with the actual timestamp.

[gitcoinbot]

Issue Status: 1. Open 2. Started 3. Submitted 4. Done

---

Work for 400.0 HOPR (135.99 USD @ $0.34/HOPR) has been submitted by:

---

• Learn more on the Gitcoin Issue Details page
• Want to chip in? Add your own contribution here.
• Questions? Checkout Gitcoin Help or the Gitcoin's Discord
• $1,699,392.07 more funded OSS Work available on the Gitcoin Issue Explorer

[gitcoinbot]

Issue Status: 1. Open 2. Started 3. Submitted 4. Done

---

The funding of 400.0 HOPR (115.69 USD @ $0.29/HOPR) attached to this issue has been approved & issued to @niklr.

• Learn more on the Gitcoin Issue Details page
• Questions? Checkout Gitcoin Help or the Gitcoin's Discord
• $1,993,882.49 more funded OSS Work available on the Gitcoin Issue Explorer

[QYuQianchen]

Thank you @niklr for the amazing work and the interview!