How fdsapoawa/telegram-rate-relay works
RateRelay is a Cloudflare Worker Telegram bot for currency and crypto conversions. Telegram webhook updates enter the Worker and are routed to message-command, private-chat, or Inline handling; conversion requests are parsed, user defaults and time zones are resolved, a selected rate source is queried, and the result is formatted and returned through Telegram. Separate capabilities include saved per-user preferences, four rate providers, configurable quote caching, and health checks. The graph follows the sampled entry point and core modules; provider integrations and Durable Object storage are evidenced by source excerpts, while README statements establish webhook and product behavior.
Main entry points: registry.ts Rate service · index.ts Worker routes · app.ts Update handling · settings.ts User settings store
Components 18
Worker Entry
- Worker routes
src/index.ts
Bot Experience
- Update handling
src/app.ts - Conversion parser
src/parser.ts - Result formatting
src/format.ts - Telegram client
src/telegram.ts
Rate Retrieval
- Rate service
src/providers/registry.ts - Quote cache
src/providers/cache.ts - Provider utilities
src/providers/types.ts - Coinbase rates
src/providers/coinbase.ts - Binance rates
src/providers/binance.ts - Kraken rates
src/providers/kraken.ts - Frankfurter rates
src/providers/frankfurter.ts
Preferences and Time
- User settings store
src/settings.ts - Time zone utilities
src/timezone.ts
Other components
- Telegram user
- Telegram API
- Rate provider APIs
- Durable Object storage
Connections 22
- Telegram user → Telegram API: sends updates
README.md - Telegram API → Worker routes: posts webhook
README.md - Worker routes → Update handling: dispatches updates
src/index.ts - Worker routes → Rate service: creates service
src/index.ts - Worker routes → Telegram client: creates client
src/index.ts - Worker routes → User settings store: creates store
src/index.ts - Update handling → Conversion parser: parses requests
src/app.ts - Update handling → User settings store: reads and saves
src/app.ts - Update handling → Result formatting: formats quotes
src/app.ts - Update handling → Telegram client: sends responses
src/app.ts - Conversion parser → Time zone utilities: normalizes zones
src/parser.ts - Result formatting → Time zone utilities: labels zones
src/format.ts - Rate service → Quote cache: caches quotes
src/providers/registry.ts - Rate service → Coinbase rates: dispatches quotes
src/providers/registry.ts - Rate service → Binance rates: dispatches quotes
src/providers/registry.ts - Rate service → Kraken rates: dispatches quotes
src/providers/registry.ts - Rate service → Frankfurter rates: dispatches quotes
src/providers/registry.ts - Coinbase rates → Rate provider APIs: fetches rates
src/providers/coinbase.ts - Binance rates → Rate provider APIs: fetches tickers
src/providers/binance.ts - Kraken rates → Rate provider APIs: fetches tickers
src/providers/kraken.ts - Frankfurter rates → Rate provider APIs: fetches reference rates
src/providers/frankfurter.ts - User settings store → Durable Object storage: reads and writes
src/settings.ts