Skip to content

feat: add off-chain notification service (#114)#205

Open
precious522 wants to merge 1 commit into
PrincessnJoy:mainfrom
precious522:feat/issue-114-notification-service
Open

feat: add off-chain notification service (#114)#205
precious522 wants to merge 1 commit into
PrincessnJoy:mainfrom
precious522:feat/issue-114-notification-service

Conversation

@precious522
Copy link
Copy Markdown

Summary

Implements an off-chain notification service that watches Stellar Horizon for CosmosVote governance events and notifies subscribers via email and/or webhook.

Changes

notification-service/ (new)

  • src/types.tsGovernanceEvent, Subscriber, SubscriptionStore types
  • src/subscriptions.ts — subscriber CRUD, event matching, JSON file persistence with cursor tracking
  • src/notifier.ts — email dispatch (nodemailer/SMTP) and webhook dispatch (axios)
  • src/watcher.ts — polls Horizon contract events, filters (gov, created/voted/final/exec/cancel), resumes from last cursor
  • src/index.ts — CLI entry: start, subscribe, unsubscribe, list
  • .env.example — all config variables documented
  • package.json / tsconfig.json — project config matching repo conventions

Docs

  • docs/notification-service.md — setup guide, CLI reference, webhook payload format, subscription file format
  • README.md — project structure and Resources section updated

Acceptance Criteria

  • Watches Horizon for governance events
  • Supports email and webhook notifications
  • Per-proposal and all-proposals subscription filtering
  • Notification service documented

Closes #114

- notification-service/ — Node.js/TypeScript service that polls Horizon
  for governance contract events and notifies subscribers
- src/types.ts        — GovernanceEvent, Subscriber, SubscriptionStore types
- src/subscriptions.ts — CRUD + matching logic, JSON file persistence
- src/notifier.ts     — email (nodemailer) and webhook (axios) dispatch
- src/watcher.ts      — Horizon event poller with cursor tracking
- src/index.ts        — CLI: start | subscribe | unsubscribe | list
- .env.example        — all configurable env vars documented
- docs/notification-service.md — setup, usage, CLI reference, payload format
- README.md           — project structure entry + Resources link

Closes PrincessnJoy#114
@drips-wave
Copy link
Copy Markdown

drips-wave Bot commented Jun 1, 2026

@precious522 Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

No notification system for proposal lifecycle events

1 participant