Jemiiah
commented
2 days ago I am applying to this issue via OnlyDust platform.
My background and how it can be leveraged
Hello @mo-jaber I'm a front-end web 3 developer with good experience in contributing to OD Project and over 50+ contributions in OD Hack this is my github profile : https://github.com/Jemiiah here is my onlydust profile as well : https://app.onlydust.com/u/Jemiiah
How I plan on tackling this issue
Admin Dashboard Setup Start by adding a section in the admin dashboard where admins can define a custom "low balance" threshold. This will let admins set the minimum acceptable wallet balance (in BSV). Make this threshold editable, but with sensible defaults (e.g., 0.1 BSV).
Real-time Wallet Monitoring I’ll need to implement real-time monitoring of the faucet’s BSV wallet balance. This will involve integrating an API or Web3 function to periodically check the wallet's balance and compare it against the threshold set by the admin.
For this, a simple polling mechanism (maybe every few minutes) can be used to fetch the balance of the wallet. Alternatively, I could use a WebSocket or event listener to trigger the check when the balance updates.
Trigger Alert on Low Balance If the balance falls below the defined threshold, we need to fire off alerts immediately. Here’s what I’ll do:
Send an alert via email and/or SMS (this will require integrating with services like SendGrid for email or Twilio for SMS). Include the following in the message: Current wallet balance Date/time the alert was triggered Suggested action (e.g., "Please refill the wallet with at least X BSV to continue operations.") Alert Configurations The admin should be able to configure multiple contact points (email addresses and phone numbers) that will receive the low-balance alerts. I’ll add a form where they can input multiple contacts and choose how they want to be notified (email, SMS, or both).
Continuous Alerts Until Replenishment If the wallet stays below the threshold, I’ll set up recurring alerts. Let’s say every X hours (configurable by the admin, with a default of 4 or 6 hours), the system will keep sending reminders until the balance is topped up. This ensures that the faucet doesn’t run out of funds unnoticed for long.
UI Design Considerations On the front-end, make the alert settings interface simple and clear. The admin should easily be able to:
Set the low-balance threshold Add/edit email addresses or phone numbers for alerting See the current wallet balance in real-time on the dashboard (so they can track it easily without waiting for alerts) Backend Integration for Alerts For this, I’ll need the backend to support:
Fetching the wallet balance Managing alert contacts (emails and phone numbers) Triggering the actual alerts (using services like SendGrid/Twilio as mentioned above) My job here would be to ensure the front-end integrates smoothly with these backend services. On the frontend side, I’ll handle:
Form submissions for alert setup Real-time balance monitoring (polling/WebSocket) Displaying the current balance and alert status in the admin dashboard. Testing Before deploying, I’ll:
Test the balance threshold functionality by setting a low threshold and manually lowering the wallet balance to see if the alert fires. Verify that the email and SMS notifications work as expected, with correct information. Test edge cases, like invalid email/phone inputs or balance fluctuating around the threshold.
0xdevcollins
saimeunt
Benjtalkshow
ShantelPeters
jrmncos
suhas-sensei
aniruddhaaps
blessingbytes
Related to https://github.com/bitcoin-sv/bsv-faucet/issues/17 and https://github.com/bitcoin-sv/bsv-faucet/issues/13
Description: Automatically alert admins when the faucet's wallet is running low on coins, enabling timely refills to maintain service continuity.
User Story: As an admin, I want to receive alerts when the faucet wallet's balance is low, so that I can replenish funds in a timely manner to ensure uninterrupted distribution of testnet coins.
acceptance criteria
I can set a custom low-balance threshold in the admin dashboard for when an alert should be triggered.
The system monitors the faucet wallet balance in real-time and checks it against the defined threshold.
When the wallet balance falls below the set threshold, the system sends an immediate alert via email and/or SMS.
The alert includes:
I can configure multiple email addresses or phone numbers to receive alerts.
The system continues to send periodic alerts if the balance remains below the threshold until the wallet is replenished.