{"id":18844014,"url":"https://github.com/mulx10/arsubscribe","last_synced_at":"2026-07-02T15:36:05.659Z","repository":{"id":187028370,"uuid":"675740096","full_name":"MuLx10/ArSubscribe","owner":"MuLx10","description":"ArSubscribe offers a seamless solution to keep users updated on their on-chain transactions. By subscribing to our notification system, users receive instant email alerts whenever any transaction involving their wallet address occurs on the chain.","archived":false,"fork":false,"pushed_at":"2023-08-10T03:35:44.000Z","size":60,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-22T23:37:44.455Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://smqon2qa3ez5pijrzvizwvrntrvbr46obqz4fncrrlgwqzseo36a.arweave.net/kyDm6gDZM9ehMc1Rm1YtnGoY884MM8K0UYrNaGZEdvw/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MuLx10.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-08-07T16:00:20.000Z","updated_at":"2023-08-10T15:26:31.000Z","dependencies_parsed_at":"2023-08-08T18:24:22.501Z","dependency_job_id":null,"html_url":"https://github.com/MuLx10/ArSubscribe","commit_stats":null,"previous_names":["mulx10/arsubscribe"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/MuLx10/ArSubscribe","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MuLx10%2FArSubscribe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MuLx10%2FArSubscribe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MuLx10%2FArSubscribe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MuLx10%2FArSubscribe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MuLx10","download_url":"https://codeload.github.com/MuLx10/ArSubscribe/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MuLx10%2FArSubscribe/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35053491,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-02T02:00:06.368Z","response_time":173,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-08T02:59:33.188Z","updated_at":"2026-07-02T15:36:05.623Z","avatar_url":"https://github.com/MuLx10.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ArSubscribe: Listen to Chain Transactions with Ease! 🎧\n🔗 Link: [ArSubscribe](https://arweave.net/kyDm6gDZM9ehMc1Rm1YtnGoY884MM8K0UYrNaGZEdvw)\\\n🔗 Link: [MailerService](https://arsubscribe-cron.onrender.com/)\n\n## 💡 Inspiration\nThe inspiration behind ArSubscribe's on-chain transaction notification system was the growing need for individuals to stay informed and in control of their cryptocurrency activities within the decentralized finance (DeFi) ecosystem. As blockchain enthusiasts, we recognized the importance of real-time updates for wallet transactions in the ever-evolving world of cryptocurrencies.\n\n## What it does\nArSubscribe offers a seamless solution to keep users updated on their on-chain transactions. By subscribing to our notification system, users receive instant email alerts whenever any transaction involving their wallet address occurs on the blockchain. Our user-friendly landing page provides a clear and concise explanation of our protocol, illustrating why it's an indispensable tool for anyone engaged in blockchain and DeFi.\n\n## 🏗️ Building \u0026 Blasting Off:\n🛠️ Clone the repo with Git: git clone https://github.com/MuLx10/ArSubscribe\n```bash\n $ git clone https://github.com/MuLx10/ArSubscribe\n```\n\n### Running the ArSubscribe app\n1. To run the app locally, install dependencies and build the app.\n   ```bash\n   $ cd app\n   $ npm i\n   $ npm run build\n   ```\n2. Start the app and point the browser to [localhost:5000](http://localhost:5000)\n   ```bash\n   $ npm start\n   ```\n\n### Building the email service:\nThe email service requires an email and password from which the email will be sent to subscribed users.\n\n1. Create a .env file in the `cron-mailer` folder with the following properties:\n   ```bash\n   EMAIL_ID=\u003csender-email-id\u003e\n   EMAIL_PASSWORD=\u003cpassword\u003e\n   ```\n2. Run the build and run the mailer service.\n   ```bash\n   $ cd cron mailer\n   $ npm i\n   $ npm run build \u0026\u0026 npm start\n   ```\nHurray 🎉! The service is started.\n\n### Requirements:\n1. node.js (\u003e=16.15.0)\n2. npm\n\n\n## How we built it\nThe development of ArSubscribe's on-chain transaction notification system involved several key steps:\n- **Subscription** - Using Arweave as DB the user subscription data is stored as a wallet - email pair. It uses Arweave transactions with the support of `tags` to store the subscription data.\n- **Email service** - The service listens to the Arweave net via GraphQL queries for all the transactions happening pertaining to subscribed users, it pulls the transaction information including block details, and creates a notification email. The emails are sent using Arsubscribe753@gmail.com via `nodemailer`.\n- **UI** - The App offers an intuitive way to subscribe to the notifications. TO login into the app users can connect with their ArConnect wallet.\n\n## Challenges we ran into\n\nOne of the main challenges was to come up with a very light app (within 100Kb).\n\n## Accomplishments that we're proud of\nWe are proud to have our app deployed to the [arweave.net](https://arweave.net) and ready to use 🍾.\n\n## What we learned\nThe hackathon was a very fun experience with full of learnings.\n\n## What's next for ArSubscribe\nLooking ahead, we have exciting plans for ArSubscribe:\n\n- **Customizable Alerts:** Enhancing the notification system to allow users to customize their alert preferences, including specific transaction types and thresholds.\n- **Mobile App:** We are exploring the development of a dedicated mobile app to provide users with even more convenient access to transaction alerts on the go.\n- **Instant Alert**: Currently alerts are fired when blocks are successfully mined, we want to add support for pending transactions as well.\n\n\nArSubscribe is all about helping out blockchain fans with up-to-the-minute info on their crypto moves. We're here to make sure you're always in the loop when it comes to the fast-paced universe of decentralized finance. Jump in now and keep up with all your crypto adventures\n\nSnaps:\n![image](https://d112y698adiu2z.cloudfront.net/photos/production/software_photos/002/557/361/datas/original.png)\n![image](https://d112y698adiu2z.cloudfront.net/photos/production/software_photos/002/557/364/datas/original.png)\n![259137707-7e2f853e-0d8b-4f6a-8b98-87fd3357a7f0](https://github.com/MuLx10/ArSubscribe/assets/23444642/87843623-8d88-4d84-a66c-db388468fefb)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmulx10%2Farsubscribe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmulx10%2Farsubscribe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmulx10%2Farsubscribe/lists"}