gitcoinbot
commented
5 years ago Issue Status: 1. Open 2. Started 3. Submitted 4. Done
This issue now has a funding of 2500.0 PROCN attached to it as part of the Ocean Protocol Foundation 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 Slack
- $59,171.41 more funded OSS Work available on the Gitcoin Issue Explorer
Anirudh2490
acolytec3
nanspro
Token Distributing Twitter Bot for Ocean Protocol’s Testnet
How can you help?
We want to create a Twitter bot that can help distribute tokens to our testnet users. The starting point will be to set up our Faucet Server. You can follow the README.md to get set up. You will be working with Twitter APIs to make a bot that interacts with our faucet server through API calls and by using a test Twitter account that we created.
Here’s how a Twitter user can request for tokens from Ocean.
A follower of Ocean Protocol’s Twitter page tweets to the account requesting some tokens. For example, user tweets the testnet address with a common phrase - "@TestOcean, requesting test tokens into 0x0000000000000000000000000000000000000000 for the #OceanTestNet". Request for tokens are tied to Twitter accounts to ensure verification and prevent malicious actors from exhausting all available funds or accumulating enough testnet tokens to mount spam attacks.
The bot then picks up the comment with the wallet address and instructs the faucet server to award a given number (configurable) of testnet tokens to the corresponding address.
The faucet server will then initiate the transfer and sends back a response. The response can be of 3 types - a) 200 (successfully transferred) b) 503 (service unavailable) which means this account has had tokens transferred to it within the last 24 hours c) 404 - Something went wrong.
Depending on the response, the Twitter bot needs to send a reply tweet to the user with the appropriate message. If a) 202 - Tweet “@userhandle x tokens have been transferred to your account!” b) 503 - Tweet “@userhandle you’ve already requested for tokens in the last 24 hrs. Only one transfer in 24 hours is allowed. Try again in xxx hours” or c) Tweet “@userhandle something went wrong and we couldn’t transfer tokens to your wallet address. Please check address provided and try again later”.
You may modify these tweets to fit Twitter’s character limits but the nature of the content should be similar.
What needs to be done?
You will be working with this test Twitter account and will be provided with API access keys and tokens via email once your application has been approved.
Here are some additional tutorials to help with your setup
Twitter APIs and rules/best practices
The bot may be built using Twitter API Libraries for NodeJS and Python. We will require implementation in either of one of these two. Set up our faucet first, and make sure it can interact with the Twitter bot/API.
We prefer the final code to be written in Javascript but Python is also acceptable. Please inform us beforehand about your approach. You may reach out to us via. Gitter with any issues.
We are very happy when
You may create a repository for this bounty and provide us the link while entering your final submission.
Seen this problem before?
Any help solving this is welcome. Feel free to leave any comments and help someone else to solve it. We might airdrop tokens to someone even if not directly completing bounty.
Questions & Reviews
Pull requests will be reviewed by one of the maintainers or long-term contributors. In case of any additional questions feel free to ask in this thread and we will do our best to add the missing info :)
Things to know
The bounty lifecycle process including payout will be managed using Gitcoin. We'll be responding to your questions here, but for discussion and clarification we recommend to join also our Gitter channel where our tech community is accessible. In order to see the PROCN balance in your wallet you'll need to reference the related token contract with address 0xf2aabdd898a0139195b2b5da7387d43a45ded254. If you use a MetaMask plugin you'll find the the exact steps here. Lastly, even if it is a contest bounty, we will reward all valuable contributions and efforts. We greatly appreciate the value our open source community brings to Ocean and will always award some tokens to all great contributions! :smiley:
Reward
Once the project was reviewed and merged in the master branch, you will receive the reward. PROCN is a Proto-Ocean token. Bounty hunters that earn PROCN will be able to convert them 1:1 to Ocean tokens on network launch (Ocean Token will be valued at at 0.22 EUR on network launch). Network launch is expected to happen by Mar 31, 2019. Until then PROCN will be locked and non-transferrable in the ETH wallet to which it is delivered to.