https://github.com/naserhha/ethereum-bitcoin-tx-notifier-extension
A Chrome Extension (Manifest V3) that monitors both Ethereum and Bitcoin wallet addresses and sends browser notifications when new transactions are detected.
https://github.com/naserhha/ethereum-bitcoin-tx-notifier-extension
bitcoin bitcoin-transaction bitcoin-wallet chrome-extension ethereum extension
Last synced: 2 months ago
JSON representation
A Chrome Extension (Manifest V3) that monitors both Ethereum and Bitcoin wallet addresses and sends browser notifications when new transactions are detected.
- Host: GitHub
- URL: https://github.com/naserhha/ethereum-bitcoin-tx-notifier-extension
- Owner: naserhha
- License: mit
- Created: 2025-07-17T22:15:21.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-08-02T21:04:34.000Z (2 months ago)
- Last Synced: 2025-08-02T23:25:33.084Z (2 months ago)
- Topics: bitcoin, bitcoin-transaction, bitcoin-wallet, chrome-extension, ethereum, extension
- Language: HTML
- Homepage: https://crypto-transaction.mohammadnasser.com/
- Size: 292 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: contributing.html
- License: LICENSE
- Security: security.html
Awesome Lists containing this project
README
# 🔗 Ethereum & Bitcoin Crypto Transaction Notifier
A Chrome Extension (Manifest V3) that monitors both **Ethereum** and **Bitcoin** wallet addresses and sends browser notifications when new transactions are detected.
[](https://chromewebstore.google.com/detail/ethereum-bitcoin-crypto-t/ajmjebdaemobbnlaedjbgleokcpmebjk)
[](https://ethereum.org/)
[](https://bitcoin.org/)
[](https://github.com/naserhha/ethereum-bitcoin-crypto-transaction-notifier)
[](LICENSE)
**Tags:** `chrome-extension` `ethereum` `bitcoin` `crypto` `blockchain` `transaction` `notifier` `wallet` `notifications` `open-source`
## ✨ Features
- **🔗 Dual Blockchain Support**: Monitor Ethereum (ETH) and Bitcoin (BTC) addresses simultaneously
- **🔔 Real-time Notifications**: Get browser notifications for new transactions
- **🔑 Secure API Key Management**: Use your own Etherscan API key for ETH monitoring
- **🆓 No API Key Required for BTC**: Bitcoin monitoring uses free Blockstream API
- **🛡️ Privacy First**: All data stored locally, no external servers
- **⚙️ Individual Controls**: Enable/disable monitoring for each blockchain separately
- **📊 Status Monitoring**: Real-time status indicators and error reporting
- **🌍 Multilingual**: Support for multiple languages
- **🚀 Production Ready**: Comprehensive error handling and rate limiting
## 📋 Requirements
- **Chrome Browser** (or Chromium-based browsers)
- **Etherscan API Key** (free) for Ethereum monitoring
- **No API key required** for Bitcoin monitoring
## 🚀 Installation
### 1. Download Extension Files
```bash
git clone https://github.com/naserhha/ethereum-bitcoin-crypto-transaction-notifier
cd ethereum-bitcoin-crypto-transaction-notifier
```
### 2. Generate Icons
1. Open `create_icons.html` in your browser
2. Click "Generate All Icons"
3. Download the generated icons (icon16.png, icon48.png, icon128.png)
4. Place them in the `icons/` folder
### 3. Load Extension in Chrome
1. Open Chrome and navigate to `chrome://extensions/`
2. Enable "Developer mode" (toggle in top right)
3. Click "Load unpacked"
4. Select the extension folder
5. The extension should now appear in your extensions list
### 4. Configure the Extension
1. Click the extension icon in your browser toolbar
2. Enter your Ethereum and/or Bitcoin addresses
3. Enter your Etherscan API key (required for ETH monitoring)
4. Enable monitoring for ETH and/or BTC using the toggles
5. Click "Save Configuration"
## 🔑 API Key Setup
### Etherscan API Key (Required for ETH)
1. Visit [Etherscan API Key](https://etherscan.io/myapikey)
2. Create a free account if you don't have one
3. Generate a new API key
4. Copy the API key and paste it in the extension
5. **Free tier limits**: 5 calls/second, 100,000 calls/day
### Bitcoin Monitoring (No API Key Required)
- Uses Blockstream.info API
- No registration required
- Generous rate limits
## 🧪 Test Addresses
### Ethereum (High Activity)
```
0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6
```
*Vitalik Buterin's address - good for testing notifications*
### Bitcoin (Example)
```
bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh
```
*Example Bitcoin address for testing*
## 📁 File Structure
```
blockchain-tx-notifier/
├── manifest.json # Extension configuration
├── background.js # Service worker for monitoring
├── popup.html # User interface
├── popup.js # Popup functionality
├── popup.css # Styling
├── _locales/ # Internationalization
│ └── en/
│ └── messages.json # English translations
├── icons/ # Extension icons
│ ├── icon16.png
│ ├── icon48.png
│ └── icon128.png
├── create_icons.html # Icon generator
├── test-extension.html # Test page
└── README.md # This file
```
## 🔧 Technical Details
### Permissions
- `storage`: Save configuration locally
- `notifications`: Show transaction alerts
- `alarms`: Schedule periodic checks
- `host_permissions`: Access Etherscan and Blockstream APIs
### APIs Used
- **Etherscan API**: For Ethereum transaction monitoring
- **Blockstream API**: For Bitcoin transaction monitoring
### Monitoring Frequency
- Checks every 60 seconds when monitoring is enabled
- Automatic rate limiting and error handling
- Pauses monitoring when API limits are reached
## 🛡️ Security & Privacy
### Security Features
- ✅ **Local Storage**: All data stored in your browser's local storage
- ✅ **No External Servers**: Extension works entirely client-side
- ✅ **API Key Protection**: Your API key never leaves your device
- ✅ **HTTPS Only**: All API calls use secure HTTPS connections
- ✅ **Rate Limiting**: Built-in protection against API abuse
- ✅ **Error Handling**: Comprehensive error handling and user feedback
### Privacy Guarantees
- Your wallet addresses stay on your device
- Your API key is never transmitted to external servers
- No tracking or analytics
- No data collection
## 🔧 Troubleshooting
### Common Issues
**No notifications appearing:**
- Check browser notification permissions
- Verify addresses are in correct format
- Ensure monitoring is enabled for the blockchain
**API errors:**
- Verify your Etherscan API key is valid
- Check if you've exceeded API rate limits
- Try refreshing the extension
**Rate limiting:**
- Wait for the automatic pause to end (usually 1 minute)
- Consider upgrading your Etherscan API plan if needed
**Extension not loading:**
- Check Chrome developer console for errors
- Verify all files are in the correct location
- Try reloading the extension
### Debug Mode
1. Open Chrome DevTools (F12)
2. Go to the Console tab
3. Look for extension-related messages
4. Check for any error messages
## 🌍 Internationalization
The extension supports multiple languages through the `_locales/` directory. Currently includes:
- English (en)
To add more languages:
1. Create a new folder in `_locales/` (e.g., `es/` for Spanish)
2. Add a `messages.json` file with translated strings
3. Update the manifest.json to include the new locale
## 🚀 Development
### Building from Source
1. Clone the repository
2. Generate icons using `create_icons.html`
3. Load as unpacked extension in Chrome
4. Make changes and reload the extension
### Testing
1. Use the provided test addresses
2. Monitor the browser console for errors
3. Test with both ETH and BTC addresses
4. Verify notifications work correctly
## 📊 API Usage
### Etherscan API (Ethereum)
- **Free Tier**: 5 calls/second, 100,000 calls/day
- **Endpoint**: `https://api.etherscan.io/api`
- **Authentication**: API key required
### Blockstream API (Bitcoin)
- **Rate Limits**: Generous, no authentication required
- **Endpoint**: `https://blockstream.info/api`
- **Authentication**: None required
## 🤝 Contributing
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request
## 📄 License
This project is open source and available under the [MIT License](LICENSE).
## 🙏 Acknowledgments
- **Etherscan** for providing the Ethereum API
- **Blockstream** for providing the Bitcoin API
- **Chrome Extensions** team for the excellent documentation
## 📞 Support
If you encounter any issues:
1. Check the troubleshooting section above
2. Review the browser console for error messages
3. Verify your API keys and addresses are correct
4. Test with the provided test addresses
---
**🔗 Ethereum & Bitcoin Crypto Transaction Notifier** - Secure • Local Storage • No External Servers
Built with ❤️ for the blockchain community
# 🔗 Ethereum & Bitcoin Crypto Transaction Notifier
A Chrome Extension (Manifest V3) that monitors both **Ethereum** and **Bitcoin** wallet addresses and sends browser notifications when new transactions are detected.
[](https://chrome.google.com/webstore)
[](https://ethereum.org/)
[](https://bitcoin.org/)
[](https://github.com/naserhha/ethereum-bitcoin-crypto-transaction-notifier)
[](LICENSE)
**Tags:** `chrome-extension` `ethereum` `bitcoin` `crypto` `blockchain` `transaction` `notifier` `wallet` `notifications` `open-source`
## ✨ Features
- **🔗 Dual Blockchain Support**: Monitor Ethereum (ETH) and Bitcoin (BTC) addresses simultaneously
- **🔔 Real-time Notifications**: Get browser notifications for new transactions
- **🔑 Secure API Key Management**: Use your own Etherscan API key for ETH monitoring
- **🆓 No API Key Required for BTC**: Bitcoin monitoring uses free Blockstream API
- **🛡️ Privacy First**: All data stored locally, no external servers
- **⚙️ Individual Controls**: Enable/disable monitoring for each blockchain separately
- **📊 Status Monitoring**: Real-time status indicators and error reporting
- **🌍 Multilingual**: Support for multiple languages
- **🚀 Production Ready**: Comprehensive error handling and rate limiting
## 📋 Requirements
- **Chrome Browser** (or Chromium-based browsers)
- **Etherscan API Key** (free) for Ethereum monitoring
- **No API key required** for Bitcoin monitoring
## 🚀 Installation
### 1. Download Extension Files
```bash
git clone https://github.com/naserhha/ethereum-bitcoin-crypto-transaction-notifier
cd ethereum-bitcoin-crypto-transaction-notifier
```
### 2. Generate Icons
1. Open `create_icons.html` in your browser
2. Click "Generate All Icons"
3. Download the generated icons (icon16.png, icon48.png, icon128.png)
4. Place them in the `icons/` folder
### 3. Load Extension in Chrome
1. Open Chrome and navigate to `chrome://extensions/`
2. Enable "Developer mode" (toggle in top right)
3. Click "Load unpacked"
4. Select the extension folder
5. The extension should now appear in your extensions list
### 4. Configure the Extension
1. Click the extension icon in your browser toolbar
2. Enter your Ethereum and/or Bitcoin addresses
3. Enter your Etherscan API key (required for ETH monitoring)
4. Enable monitoring for ETH and/or BTC using the toggles
5. Click "Save Configuration"
## 🔑 API Key Setup
### Etherscan API Key (Required for ETH)
1. Visit [Etherscan API Key](https://etherscan.io/myapikey)
2. Create a free account if you don't have one
3. Generate a new API key
4. Copy the API key and paste it in the extension
5. **Free tier limits**: 5 calls/second, 100,000 calls/day
### Bitcoin Monitoring (No API Key Required)
- Uses Blockstream.info API
- No registration required
- Generous rate limits
## 🧪 Test Addresses
### Ethereum (High Activity)
```
0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6
```
*Vitalik Buterin's address - good for testing notifications*
### Bitcoin (Example)
```
bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh
```
*Example Bitcoin address for testing*
## 📁 File Structure
```
blockchain-tx-notifier/
├── manifest.json # Extension configuration
├── background.js # Service worker for monitoring
├── popup.html # User interface
├── popup.js # Popup functionality
├── popup.css # Styling
├── _locales/ # Internationalization
│ └── en/
│ └── messages.json # English translations
├── icons/ # Extension icons
│ ├── icon16.png
│ ├── icon48.png
│ └── icon128.png
├── create_icons.html # Icon generator
├── test-extension.html # Test page
└── README.md # This file
```
## 🔧 Technical Details
### Permissions
- `storage`: Save configuration locally
- `notifications`: Show transaction alerts
- `alarms`: Schedule periodic checks
- `host_permissions`: Access Etherscan and Blockstream APIs
### APIs Used
- **Etherscan API**: For Ethereum transaction monitoring
- **Blockstream API**: For Bitcoin transaction monitoring
### Monitoring Frequency
- Checks every 60 seconds when monitoring is enabled
- Automatic rate limiting and error handling
- Pauses monitoring when API limits are reached
## 🛡️ Security & Privacy
### Security Features
- ✅ **Local Storage**: All data stored in your browser's local storage
- ✅ **No External Servers**: Extension works entirely client-side
- ✅ **API Key Protection**: Your API key never leaves your device
- ✅ **HTTPS Only**: All API calls use secure HTTPS connections
- ✅ **Rate Limiting**: Built-in protection against API abuse
- ✅ **Error Handling**: Comprehensive error handling and user feedback
### Privacy Guarantees
- Your wallet addresses stay on your device
- Your API key is never transmitted to external servers
- No tracking or analytics
- No data collection
## 🔧 Troubleshooting
### Common Issues
**No notifications appearing:**
- Check browser notification permissions
- Verify addresses are in correct format
- Ensure monitoring is enabled for the blockchain
**API errors:**
- Verify your Etherscan API key is valid
- Check if you've exceeded API rate limits
- Try refreshing the extension
**Rate limiting:**
- Wait for the automatic pause to end (usually 1 minute)
- Consider upgrading your Etherscan API plan if needed
**Extension not loading:**
- Check Chrome developer console for errors
- Verify all files are in the correct location
- Try reloading the extension
### Debug Mode
1. Open Chrome DevTools (F12)
2. Go to the Console tab
3. Look for extension-related messages
4. Check for any error messages
## 🌍 Internationalization
The extension supports multiple languages through the `_locales/` directory. Currently includes:
- English (en)
To add more languages:
1. Create a new folder in `_locales/` (e.g., `es/` for Spanish)
2. Add a `messages.json` file with translated strings
3. Update the manifest.json to include the new locale
## 🚀 Development
### Building from Source
1. Clone the repository
2. Generate icons using `create_icons.html`
3. Load as unpacked extension in Chrome
4. Make changes and reload the extension
### Testing
1. Use the provided test addresses
2. Monitor the browser console for errors
3. Test with both ETH and BTC addresses
4. Verify notifications work correctly
## 📊 API Usage
### Etherscan API (Ethereum)
- **Free Tier**: 5 calls/second, 100,000 calls/day
- **Endpoint**: `https://api.etherscan.io/api`
- **Authentication**: API key required
### Blockstream API (Bitcoin)
- **Rate Limits**: Generous, no authentication required
- **Endpoint**: `https://blockstream.info/api`
- **Authentication**: None required
## 🤝 Contributing
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request
## 📄 License
This project is open source and available under the [MIT License](LICENSE).
## 🙏 Acknowledgments
- **Etherscan** for providing the Ethereum API
- **Blockstream** for providing the Bitcoin API
- **Chrome Extensions** team for the excellent documentation
## 📞 Support
If you encounter any issues:
1. Check the troubleshooting section above
2. Review the browser console for error messages
3. Verify your API keys and addresses are correct
4. Test with the provided test addresses
---
**🔗 Ethereum & Bitcoin Crypto Transaction Notifier** - Secure • Local Storage • No External Servers
Built with ❤️ for the blockchain community
---
## 👨💻 Author
**Mohammad Nasser Haji Hashemabad**
- **LinkedIn**: [@naserhha](https://ir.linkedin.com/in/naserhha)
- **GitHub**: [@naserhha](https://github.com/naserhha)
- **Website**: [mohammadnasser.com](https://mohammadnasser.com/)
- **Extension Homepage**: [crypto-transaction.mohammadnasser.com](https://crypto-transaction.mohammadnasser.com/)
- **Repository**: [ethereum-bitcoin-crypto-transaction-notifier](https://github.com/naserhha/ethereum-bitcoin-crypto-transaction-notifier)
---
## 🌍 Description in Other Languages
### 🇮🇷 فارسی (Persian)
دریافت نوتیفیکیشن لحظهای تراکنشهای اتریوم و بیتکوین — مستقیماً در مرورگر شما!
با دریافت اعلانهای فوری برای تراکنشهای جدید اتریوم و بیتکوین، همیشه از فعالیتهای رمزارزی خود باخبر باشید.
این افزونه بهصورت امن آدرسهای کیف پول شما را پایش میکند و به محض شناسایی تراکنش جدید، شما را مطلع میسازد — بدون نیاز به رفرش اکسپلوررها یا چک کردن گوشی!
**ویژگیهای کلیدی:**
- هشدار لحظهای: دریافت اعلان مرورگر برای هر تراکنش جدید ETH یا BTC
- پشتیبانی چندزبانه: تجربهای روان به انگلیسی، فارسی، عربی، چینی و روسی
- رابط کاربری مدرن و کاربرپسند: الهامگرفته از MetaMask با آیکونهای واضح و طراحی تمیز
- راهاندازی آسان: فقط آدرس کیف پول (و کلید API اترسکن برای اتریوم) را وارد و ذخیره کنید
- متنباز و حریمخصوصی محور: اطلاعات فقط بهصورت محلی ذخیره میشود؛ بدون ردیابی، تبلیغ یا اشتراکگذاری
- قابل تنظیم: پایش چند آدرس، انتخاب زبان و کنترل تنظیمات اعلان
### 🇸🇦 العربية (Arabic)
احصل على إشعارات فورية بمعاملات الإيثريوم والبيتكوين — مباشرة في متصفحك!
تابع نشاطك في العملات الرقمية مع إشعارات فورية لكل معاملة جديدة على الإيثريوم أو البيتكوين.
يراقب هذا الامتداد عناوين محافظك بأمان وينبهك فور اكتشاف أي معاملة — دون الحاجة لتحديث مستكشفات البلوك أو فحص هاتفك!
**الميزات الرئيسية:**
- تنبيهات فورية: استلم إشعارات المتصفح لكل معاملة ETH أو BTC جديدة
- دعم متعدد اللغات: تجربة سلسة بالإنجليزية، الفارسية، العربية، الصينية، والروسية
- واجهة حديثة وسهلة الاستخدام: مستوحاة من MetaMask مع أيقونات واضحة وتصميم نظيف
- إعداد سهل: فقط أدخل عنوان محفظتك (ومفتاح Etherscan API للإيثريوم)، ثم احفظ
- مفتوح المصدر ويراعي الخصوصية: عناوينك محفوظة محليًا؛ لا تتبع، لا إعلانات، لا مشاركة بيانات
- قابل للتخصيص: راقب عدة عناوين، اختر لغتك، وتحكم في إعدادات الإشعارات
### 🇷🇺 Русский (Russian)
Получайте уведомления о транзакциях Ethereum и Bitcoin — прямо в вашем браузере!
Следите за своей крипто-активностью с помощью мгновенных уведомлений о новых транзакциях Ethereum и Bitcoin.
Это расширение безопасно отслеживает ваши адреса кошельков и мгновенно оповещает вас о новых транзакциях — не нужно обновлять блок-эксплореры или проверять телефон!
**Ключевые возможности:**
- Мгновенные оповещения: уведомления в браузере о каждой новой транзакции ETH или BTC
- Многоязычная поддержка: удобный интерфейс на английском, персидском, арабском, китайском и русском языках
- Современный и удобный UI: вдохновлён MetaMask, с чёткими иконками и адаптивным дизайном
- Лёгкая настройка: просто введите адрес кошелька (и API-ключ Etherscan для ETH), сохраните — и всё готово
- Открытый исходный код и приватность: ваши адреса хранятся только локально; без трекинга, рекламы и передачи данных
- Гибкость: отслеживайте несколько адресов, выбирайте язык, управляйте уведомлениями
### 🇨🇳 简体中文 (Simplified Chinese)
在浏览器中实时获取以太坊和比特币交易通知！
通过即时通知，随时掌握您的以太坊和比特币账户动态。
此扩展安全地监控您的钱包地址，一旦检测到新交易立即提醒您——无需刷新区块浏览器或查看手机！
**主要功能：**
- 实时提醒：每笔新的ETH或BTC交易都会收到浏览器通知
- 多语言支持：支持英语、波斯语、阿拉伯语、中文和俄语
- 现代且易用的界面：借鉴MetaMask风格，图标清晰，设计简洁响应式
- 简单设置：输入钱包地址（ETH需Etherscan API密钥），保存即可
- 开源且注重隐私：地址仅本地存储，无跟踪、无广告、无数据共享
- 可自定义：可监控多个地址，选择语言，管理通知设置
---
---
## 👨💻 Author
**Mohammad Nasser Haji Hashemabad**
- **LinkedIn**: [@naserhha](https://ir.linkedin.com/in/naserhha)
- **GitHub**: [@naserhha](https://github.com/naserhha)
- **Website**: [mohammadnasser.com](https://mohammadnasser.com/)
- **Extension Homepage**: [crypto-transaction.mohammadnasser.com](https://crypto-transaction.mohammadnasser.com/)
- **Repository**: [ethereum-bitcoin-crypto-transaction-notifier](https://github.com/naserhha/ethereum-bitcoin-crypto-transaction-notifier)
## Branch V1