Skip to content

feat(monitor): advanced event filters and balance-alert watchman#189

Merged
Nanle-code merged 8 commits into
Nanle-code:masterfrom
auraroom:fix/issues-169-175
May 28, 2026
Merged

feat(monitor): advanced event filters and balance-alert watchman#189
Nanle-code merged 8 commits into
Nanle-code:masterfrom
auraroom:fix/issues-169-175

Conversation

@auraroom
Copy link
Copy Markdown
Contributor

Summary

  • Add Soroban getEvents filtering in stream.rs with --type, --topic, and --value flags on starforge monitor --contract, including RPC topic encoding and client-side value matching.
  • Restore the contract monitor loop with reconnect backoff and --follow support.
  • Add a wallet watchman via --balance-alert that alerts the terminal and OS when XLM balance drops below the configured threshold.

Verification

  • Confirmed src/utils/stream.rs, src/commands/monitor.rs, and src/utils/notifications.rs compile with cargo check (other upstream files on master still have unrelated errors).
  • Reviewed commit history: all commits authored and committed as auraroom <auraroom001@gmail.com>.
  • Tests not run (per task instructions).

Closes #169
Closes #175

Made with Cursor

auraroom and others added 8 commits May 28, 2026 21:53
Introduce a Backoff helper used when Soroban getEvents polling fails so
monitor can retry with increasing delays instead of hammering the RPC.

Co-authored-by: Cursor <cursoragent@cursor.com>
Add filter struct and builder methods so callers can set event type,
topic segments, and value matching before polling getEvents.

Co-authored-by: Cursor <cursoragent@cursor.com>
Extend the monitor CLI with Soroban event filter options and a watchman
threshold for low wallet balance alerts.

Co-authored-by: Cursor <cursoragent@cursor.com>
Emit a prominent terminal warning, bell, and OS notification when the
monitor watchman detects a low wallet balance.

Co-authored-by: Cursor <cursoragent@cursor.com>
Pass --type, --topic, --value, and --follow from the CLI into the contract
event monitor so Soroban getEvents filters can be applied server-side.

Co-authored-by: Cursor <cursoragent@cursor.com>
Build EventStreamFilters from --type, --topic, and --value, then poll the
RPC with server-side filters plus legacy --events matching.

Co-authored-by: Cursor <cursoragent@cursor.com>
Validate --balance-alert, announce watchman mode, and support graceful
shutdown while polling wallet balances.

Co-authored-by: Cursor <cursoragent@cursor.com>
Notify the terminal and OS when wallet XLM falls under --balance-alert,
and reset the latch after the balance recovers.

Co-authored-by: Cursor <cursoragent@cursor.com>
@drips-wave
Copy link
Copy Markdown

drips-wave Bot commented May 28, 2026

@auraroom 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

@Nanle-code Nanle-code merged commit 95cd972 into Nanle-code:master May 28, 2026
1 of 3 checks passed
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.

Low Balance Threshold Alerts Advanced Contract Event Filtering

2 participants