[Developer Competition] YAM Community API
đ«đ· Version francophone en deuxiĂšme partie de message
Summary
I propose the development of a YAM Community API, an off-chain indexing service that will store and expose all past and present YAM events. This API will help the community developers, enabling them to easily retrieve transaction history for reporting, statistics, dashboards, and other applications.
Objective
Currently, there is no built-in way to access past transactions or historical data about offers on YAM. External solutions like The Graph exist but they are often not easily flexible and not always reliable. This project aims to solve that issue by creating a fully indexed API that records all YAM-related events and transactions, making them easily accessible to the community.
By providing this API, developers will no longer need to worry about how to retrieve historical YAM data. Instead, they can focus on building valuable applications such as analytics tools, portfolio trackers, automated reporting systems, and more.
How it works?
The YAM Community API will be a publicly available web service (access might be limited to developers that have requested a token like the existing realtokens community API). Developers and users will be able to query this YAM Community API to retrieve detailed information about past YAM transactions and events.
- The API will continuously index and store all YAM transactions, ensuring a complete and accurate historical record.
- It will be off-chain, meaning that it does not rely on the YAM smart contracts but instead maintains a dedicated database to store the indexed data.
- Developers will be able to query the API via simple endpoints to retrieve transaction history, past/present offers, and other relevant YAM data.
Application Architecture
The application will be structured into three main components:
Transaction Indexing Module
A dedicated module responsible for tracking and indexing all YAM transactions and events. This ensures that past offers and historical transaction data remain accessible, unlike the YAM on-chain smart contract that only retains the current status of any offers.
Data Retrieval Engine
This module will process queries efficiently, allowing users to fetch historical YAM data based on filters such as wallet address, realtokens address, time range, and transaction type.
Public API
A set of well-documented API endpoints that developers can use to integrate YAM transaction history into their applications, dashboards, or reports.
Available Endpoints
The YAM Community API will provide the following endpoints to facilitate access to historical transaction data and offer-related events:
Note: The following endpoints provide an overview of the planned API functionality. Some adjustments may be made during development to account for technical considerations or community feedback from forum discussions.
Retrieve all events for a specific offer ID
Returns the complete event history (creation, purchases, updates, deletions) associated with a given offer ID.
Retrieve all events for a specific seller within a given time frame
Returns all recorded events for any offer linked to a seller over a specified period. Optionally, results can be filtered by event type (offer creation, modification, or deletion).
Retrieve all offer IDs associated with a specific seller within a given time frame
Returns the IDs list of all offers created by a seller during the specified period.
Retrieve all active offer IDs for a given seller
Returns the ID list of all currently active offers from a seller. Active offers are those that have not been sold out or deleted.
Retrieve all events (creation, modification, purchase, deletion) for active offers of a given seller
Returns the history of all modifications and status changes for currently active offers associated with a seller.
Retrieve all purchase events for a specific buyer within a given time frame
Returns a list of all transactions where a given buyer has purchased RealTokens during the specified period.
Retrieve all purchase events for a specific RealToken within a given time frame
Returns all purchase transactions related to a particular RealToken over the specified period.
Development timeline
The development timeline for this project aligns with the competition requirements, with an estimated completion time of 1 to 2 months. The initial version will focus on indexing transactions and exposing essential endpoints for data retrieval. Additional endpoints could be implemented based on community feedback and developer needs.
About Me
As a frequent RealToken investor passionate about blockchain and tech, I understand the challenges of tracking YAM transactions and historical data. This API is something that I wish existed, and Iâm excited to build it for the community.
One of my previous projects includes developing the Telegram bot The YAMSaleNotifyBot, which has sent over 10,000 notifications to RealToken users keeping them informed whenever one of their YAM offers has been bought. I am committed to enhancing the RealToken and YAM ecosystem by building tools that improve transparency and usability.
Additionally, I am an application engineer working in a Belgian tech company, which allows me to bring professional expertise to the development of reliable and efficient solutions for the community.
=====================================================
đ«đ· [Concours pour dĂ©veloppeurs] API Communautaire YAM
Résumé
Je propose le dĂ©veloppement d'une API Communautaire YAM, un service d'indexation off-chain qui stockera et exposera tous les Ă©vĂ©nements passĂ©s du YAM. Cette API facilitera le travail des dĂ©veloppeurs de la communautĂ© en leur permettant de rĂ©cupĂ©rer facilement lâhistorique des transactions pour des besoins de reporting, statistiques, tableaux de bord, et autres applications.
Objectif
Actuellement, il nâexiste aucun moyen simple dâaccĂ©der aux donnĂ©es historiques aux actuelles du YAM. Des solutions externes comme The Graph existent, mais elles sont souvent peu flexibles et pas toujours fiables.
Ce projet vise à résoudre ce problÚme en créant une API qui enregistre tous les événements et transactions liés au YAM, les rendant facilement accessibles à la communauté.
GrĂące Ă cette API, les dĂ©veloppeurs nâauront plus Ă se soucier de la rĂ©cupĂ©ration des donnĂ©es du YAM (donnĂ©es historiques ou offres en cours). Ils pourront se concentrer sur la crĂ©ation dâoutils utiles tels que des outils dâanalyse, des trackers de portefeuille, des systĂšmes de reporting automatisĂ©s, etc.
Comment ça fonctionne ?
LâAPI Communautaire YAM sera un service web accessible publiquement (lâaccĂšs pourrait ĂȘtre limitĂ© aux dĂ©veloppeurs ayant demandĂ© un token, comme pour lâAPI communautaire de RealTokens). Les dĂ©veloppeurs et utilisateurs pourront interroger cette API pour obtenir des informations dĂ©taillĂ©es sur les transactions et Ă©vĂ©nements passĂ©s du YAM.
- LâAPI indexera et stockera en continu toutes les transactions YAM, garantissant un enregistrement complet et prĂ©cis de lâhistorique.
- Elle fonctionnera hors-chaĂźne, câest-Ă -dire sans dĂ©pendre directement des smart contracts YAM, en maintenant une base de donnĂ©es dĂ©diĂ©e.
- Les dĂ©veloppeurs pourront interroger lâAPI via des endpoints simples pour rĂ©cupĂ©rer lâhistorique des transactions, les offres passĂ©es/actuelles, et dâautres donnĂ©es pertinentes.
Architecture de l'application
Lâapplication sera structurĂ©e autour de trois composants principaux :
Module dâindexation des transactions
Un module dĂ©diĂ© au suivi et Ă lâindexation de toutes les transactions et Ă©vĂ©nements YAM. Il garantit que les offres passĂ©es et les donnĂ©es historiques restent accessibles, contrairement au smart contract YAM on-chain qui ne conserve que lâĂ©tat actuel.
Moteur de récupération des données
Ce module traitera les requĂȘtes efficacement, permettant aux utilisateurs dâobtenir les donnĂ©es historiques en fonction de filtres (adresse de portefeuille, adresse RealToken, plage temporelle, type de transaction, etc.).
API publique
Une sĂ©rie dâendpoints bien documentĂ©s que les dĂ©veloppeurs pourront utiliser pour intĂ©grer lâhistorique YAM dans leurs applications, dashboards ou rapports.
Endpoints disponibles
LâAPI Communautaire YAM proposera les endpoints suivants pour faciliter lâaccĂšs aux donnĂ©es historiques de transactions et Ă©vĂ©nements liĂ©s aux offres :
Remarque : ces endpoints donnent une vue dâensemble des fonctionnalitĂ©s prĂ©vues. Certains ajustements pourront ĂȘtre faits pendant le dĂ©veloppement selon les contraintes techniques ou les retours de la communautĂ© sur le forum.
Récupérer tous les événements pour un offer ID spécifique
Retourne lâhistorique complet (crĂ©ation, achats, modifications, suppressions) associĂ© Ă un offer ID donnĂ©.
RĂ©cupĂ©rer tous les Ă©vĂ©nements dâun vendeur donnĂ© sur une pĂ©riode donnĂ©e
Retourne tous les Ă©vĂ©nements enregistrĂ©s liĂ©s Ă un vendeur sur une pĂ©riode spĂ©cifiĂ©e. Filtrage possible par type dâĂ©vĂ©nement (crĂ©ation, modification, suppression).
Récupérer tous les offers ID associés à un vendeur sur une période donnée
Retourne la liste des offers ID créées par un vendeur pendant la période spécifiée.
RĂ©cupĂ©rer tous les offers ID actives dâun vendeur
Retourne la liste des offres actuellement actives (ni sold-out, ni supprimĂ©es) dâun vendeur.
RĂ©cupĂ©rer tous les Ă©vĂ©nements pour les offres actives dâun vendeur
Retourne lâhistorique des modifications et changements de statut des offres actives dâun vendeur.
RĂ©cupĂ©rer tous les achats dâun acheteur sur une pĂ©riode donnĂ©e
Retourne la liste des transactions oĂč un acheteur a acquis des RealTokens durant la pĂ©riode spĂ©cifiĂ©e.
RĂ©cupĂ©rer tous les achats dâun RealToken sur une pĂ©riode donnĂ©e
Retourne toutes les transactions dâachat concernant un RealToken donnĂ© sur une pĂ©riode dĂ©finie.
Calendrier de développement
Le calendrier de dĂ©veloppement respecte les exigences du concours, avec une durĂ©e estimĂ©e de 1 Ă 2 mois. La version initiale se concentrera sur lâindexation des transactions et la mise Ă disposition des endpoints essentiels. Des endpoints supplĂ©mentaires pourraient ĂȘtre ajoutĂ©s selon les retours de la communautĂ© et les besoins des dĂ©veloppeurs.
Ă propos de moi
En tant quâinvestisseur rĂ©gulier dans lâĂ©cosystĂšme RealT et passionnĂ© par la blockchain et la tech, je comprends les difficultĂ©s pour suivre les transactions YAM et accĂ©der Ă des donnĂ©es historiques fiables. Cette API est un outil que jâaurais aimĂ© avoir, et je suis enthousiaste Ă lâidĂ©e de la construire pour la communautĂ©.
Lâun de mes projets prĂ©cĂ©dents est le dĂ©veloppement du bot Telegram The YAMSaleNotifyBot, qui a envoyĂ© plus de 10 000 notifications aux utilisateurs de RealToken pour les informer quand une de leurs offres YAM avait Ă©tĂ© achetĂ©e.
Je suis Ă©galement ingĂ©nieur dâapplication dans une entreprise tech en Belgique, ce qui me permet dâapporter une expertise professionnelle au dĂ©veloppement de solutions fiables et efficaces pour la communautĂ©.