DIY CardanoBot - Build your bot with Zero cost

[GENERAL] Name and surname of main applicant

Jimmy Lee

[GENERAL] Are you delivering this project as an individual or as an entity (whether formally incorporated or not)

Individual

[GENERAL] Requested funds in ada

46550

[GENERAL] Please specify how many months you expect your project to last (from 2-12 months)

4

[GENERAL] Please indicate if your proposal has been auto-translated into English from another language

Yes

[GENERAL] Summarize your solution to the problem (200-character limit including spaces)

• Create docs to help users easily build a Telegram bot to track ADA and token fluctuations in their wallets.
• Asset notifications can be sent anytime, anywhere.
• Bot building n maintaining fee are 0

[GENERAL] Does your project have any dependencies on other organizations, technical or otherwise?

No

[GENERAL] If YES, please describe what the dependency is and why you believe it is essential for your project’s delivery. If NO, please write “No dependencies.”

No dependencies.

[GENERAL] Will your project’s output/s be fully open source?

Yes

[GENERAL] Please provide here more information on the open source status of your project outputs

Will be public in github https://github.com/JimmyLee16/Cardanodocs

[METADATA] Horizons

Developer Tools

[SOLUTION] Please describe your proposed solution

Context and problem.

• Currently, Cardano only has one mobile wallet app, Yoroi, which consistently faces issues with blockchain data synchronization.
• The habits and level of understanding of most users involve checking their assets through mobile wallets. When the Yoroi wallet encounters synchronization problems, users are unable to check their assets.
• Checking and monitoring assets through explorers is limited by the necessity to use a PC or laptop.
• There are already some apps or bots that help track wallet assets; however, to some extent, users who value their privacy may choose not to use them.
• For example, when users use a Telegram bot to query wallet asset information, the bot owner can know your Telegram ID, which addresses you hold assets in, how much assets you have, and even the IP address from which you are connecting to the internet.
• Many regular users want to create their own tracking tools to monitor their assets daily and as they wish without needing a PC or using a third-party app. However, creating, programming, or deploying a bot requires time for research and may involve costs for renting an online server…
• Cardano has many API sources that provide free blockchain data. Most of these projects creating these APIs are funded by the Catalyst fund. However, their popularity is not yet high.

Solution

Starting from real needs, we will create documentation to guide users in creating their own Telegram bot to monitor asset fluctuations in their wallets. The documentation includes:

• Documentation and Videos: Guides on how to create and deploy a Telegram bot.
• Using Free APIs: Instructions on how to utilize free API sources.
• Bot Source Code Documentation: Detailed documentation of the bot's source code.

Bot Functions:

• Track ADA Balance Fluctuations: Monitor ADA balances by stake address and payment address.
• Track Cardano Token Balance Fluctuations: Monitor Cardano token balances by stake address and payment address.
• Manual Tracking Mode: Check at any time.
• Auto Tracking Mode: Every minute.
• Daily and Weekly Modes: Set tracking intervals.
• Notifications: Include transaction ID (tx id) and on-chain messages accompanying the transaction.
• Notification Delivery: Sent via Telegram or email.
• Periodic Asset Reports: Track and send reports about wallet assets to users on a daily, weekly, and monthly basis.

Note: Feel free to use my bot (Vietnamese version)

Advantages of the Solution:

• Convenience for Busy or Mobile Users: Ideal for those who are busy, frequently on the move, do not regularly use a computer, or do not want to frequently install the Yoroi wallet app on their mobile devices.
• Zero Cost:
• Blockchain Data Queries: Free (using public APIs like Koios, Blockfrost, etc.).
• Bot Deployment Server Fees: Free (using Google’s free cloud server).
• Database: Free and easy to use with Google Sheets.
• Bot Source Code: Simple, utilizing Google AppScript code.
• Google Account: Free.
• Telegram Bot: Always free.
• Faster Result Retrieval: Provides quicker access to results compared to using explorer websites or wallet apps.

[IMPACT] Please define the positive impact your project will have on the wider Cardano community

Impact and benefit

• ADA holders now have an additional convenient solution to track assets in their personal wallets, aside from using wallet apps, blockchain explorers, or third-party software.
• Cost-saving solution: No deployment costs… all resources used are free and familiar to millions of people worldwide (Google).
• Promotes and enhances awareness and usability of the available public APIs on Cardano. The expected sources are Blockfrost and Koios.
• Non-developer holders who master the bot will also gain additional knowledge about the Cardano blockchain.

Key metrics to measure the success of the project

• Number of bot functions.
• Number of bot users.
• Number of public API sources used.

Main goal (6 months)

• Goal 1: Number of bot functions. This goal is defined by the following parameter:
• Number of bot functions: 5

• Goal 2: Number of interactions with the product. This goal is determined by the number of times the code is forked from GitHub.
• Forked times: 100

• Goal 3: Number of direct support cases.
• Support number: 20 users

• Goal 4: Number of public API sources used.
• Number of API sources: 2 (Blockfrost + Koios)

[CAPABILITY & FEASIBILITY] What is your capability to deliver your project with high levels of trust and accountability? How do you intend to validate if your approach is feasible?

Jimmy Lee

• Leader of Viet Cardano Community (VCC) pool
• Creator of VCC bot https://t.me/vietpool_bot
• Alternate delegate of Cardano Constituation Convention 2024
• Admin of largest Vietnamese Cardano facebook Community (helping over 47k followers) https://www.facebook.com/groups/cardanoviet
• Instructor of 2 “how to evaluate a crypto’s project" courses.
• An Entrepreneur with 3 year experience in the blockchain field.
• Has a deep knowledge in blockchain technology and blockchain projects.
• Telegram: https://t.me/Jimmy_Lee01
• Linkedin : linkedin.com/in/le-linh-813125117

I have experience managing and completing 7 proposals since Fund7. I have also successfully created a bot with similar functions to serve my Telegram community.

[PROJECT MILESTONES] What are the key milestones you need to achieve in order to complete your project successfully?

Research and Planning

Tasks:

• Research product structure.
• Collect user needs for bot usage.
• Define the bot's functions.

Outputs:

• A document detailing the survey of user needs within the community.
• A detailed document describing the bot creation process, bot functions, and deployment resources.
• A detailed document describing the process of creating a Telegram bot.

Acceptance Criteria:

• One document describing the article structure, the structure of one clip, the list of articles, and the plan for writing articles, making clips, and live streaming details by week.
• Two basic introductory articles.

Tracking/Audit sources: Google shared documents, Github (https://github.com/JimmyLee16/Cardanodocs)

Timeline: 1st month

Budget Est: 13750 ADA

Develop and Deploy the First 2 bot Functions

Task:

• Develop and deploy the function to query ADA balance via payment address in manual mode.
• Develop and deploy the function to query ADA + token balance via payment address in manual mode.
• Develop and deploy the function to query ADA balance via stake address in manual mode.
• Develop and deploy the function to query ADA + token balance via stake address in manual mode.
• Implement user engagement and provide direct support.

Outputs:

• A document describing the bot implementation process (Google Doc + GitHub).
• Bot source code (GitHub).
• User engagement report.

Acceptance Criteria:

• Source code repositories: 4 repositories.
• User engagement report (Google shared document).

Timeline: month 2nd

Budget Est: 14600 ADA

Develop and Deploy the Remaining 2 Bot Functions

Task:

• Develop and deploy the function to track ADA balance fluctuations in real-time.
• Develop and deploy the function to query token balance in real-time.
• Implement user engagement and provide direct support.

Outputs:

• A document describing the bot implementation process (Google Doc + GitHub).
• Bot source code (GitHub).
• User engagement report.

Acceptance Criteria:

• Source code repositories: 2 GitHub repositories.
• Summary report: 1 document.

Timeline: month 3th

Budget Est: 14600 ADA

Task

• Creating instructions video
• Summarize and Create a Final Project Report

Output

• Instructional video clips (YouTube)
• Final documents

Acceptance criteria

• Number of clips: 04 clips

Timeline: month 4th

Budget Est: 3600 ADA

[RESOURCES] Who is in the project team and what are their roles?

1.Jimmy Lee – Project leader

• Leader of Viet Cardano Community (VCC) pool
• Alternate delegate of Cardano Constituation Convention 2024
• Admin of 2 Vietnamese Cardano facebook Community (helping over 40k followers) https://www.facebook.com/groups/cardanoviet and https://www.facebook.com/groups/ada.holder
• Instructor of 2 “how to evaluate a crypto’s project" courses.
• An Entrepreneur with 3 year experience in the blockchain field.
• Has a deep knowledge in blockchain technology and blockchain projects.
• Telegram: https://t.me/Jimmy_Lee01
• Linkedin : linkedin.com/in/le-linh-813125117

[BUDGET & COSTS] Please provide a cost breakdown of the proposed work and resources

Conver rate: 1 ADA = 0.35$

Total budget: 46550 ADA

Milestone 1: 13750 ADA

• Research product structure: 9200 ADA (80 working hours, 115ADA/hour)
• Documentation writing: Writing bot functionality, technical details, deployment process: 3200 ADA (40 working hours, 80ADA/hour)
• Project management & planning: 1350 ADA (30 working hours, 45 ADA/hour)

 

Milestone 2: 14600 ADA

 

• Develop and deploy bot source code (2 features): 12800 ADA (80 working hours, 160ADA/hour)
• Project management, user supporting, making report: 1800 ADA (45 working hours, 40ADA/hours)

 

Milestone 3: 14600 ADA

 

• Develop and deploy bot source code (2 features): 12800 ADA (80 working hours, 160ADA/hour)
• Project management, user supporting, making report: 1800 ADA (45 working hours, 40ADA/hours)

Final milestone: 3600 ADA

• Create instructional videos: Scripting, recording, editing: 2800 ADA ( 700ADA/clip)
• Project management, user supporting, making final report: 800 ADA (20 working hours, 40ADA/hours)

 

[VALUE FOR MONEY] How does the cost of the project represent value for money for the Cardano ecosystem?

• I and my team has experience in implementing and completing 6 proposals.
• We already have a community with tens of thousands of members, a website with 500 accounts, so the marketing costs are reduced to a minimum.
• With ZERO cost to build bot as free cloud sever, free bot telegram, free database (google sheet) and Public API as Blockfrost, Koios. This Project will bring huge value of money for Cardano's ecosytem
• Every labour cost are listed and calculated in budget breakdown section.