Bond Notifications
How validators are notified of bond-related events including underfunding, auction status changes, and announcements.
TL;DR: Subscribe via Telegram, email, or the CLI to get alerted on bond underfunding, auction status changes, and announcements. Critical alerts fire below 2 epochs of coverage; warnings below 10. Setting this up is the easiest way to stay ahead of the Bond Risk Reduction Mechanism.
Overview
The notification system monitors the state of validator bonds and alerts the bond authority when something important changes. This page covers how the system works, the notification types, and how to subscribe.
How Notifications Work
The processing pipeline works as follows:
State monitoring: The system periodically checks the state of all bonds participating in the SAM Auction (bond balance, auction status, eligibility, and so on).
Change detection: When a relevant change is detected for a bond (e.g., the bond becomes underfunded, the validator exits the auction), an event is generated.
Notification delivery: The event is evaluated, prioritized, and delivered through the validator's subscribed channels (Telegram, email, or the CLI notifications view).
Validators only receive notifications when something changes. The system does not repeatedly alert about a persistent condition. For ongoing issues (e.g., underfunding), re-alerts are sent at most once per 24 hours and only if the condition changed significantly.
Notification Types
Bond underfunded: The bond's SOL balance is insufficient to cover SAM Auction costs for the delegated stake. The system tracks how many epochs the current balance can sustain.
A critical alert fires when coverage drops below 2 epochs, and a warning when it drops below 10 epochs.
Only deficits ≥ 0.5 SOL trigger a notification.
The expected cost calculation now includes the Activating Stake Fee when applicable. Validators receiving new stake will see this reflected in the projected coverage. See the Activating Stake Fee page for the fee mechanics.
See also the Bond Risk Reduction Mechanism for what happens when coverage falls below the minimum.
Auction exited / entered: The validator left or joined the SAM Auction. Exiting is critical. Act quickly to avoid losing delegated stake.
Cap constraint changed: The binding constraint limiting the validator's delegated stake changed. Only the
BONDcap type (bond size is the limiting factor) triggers a notification. Other cap types (e.g., country, ASO) are system-managed and suppressed.Bond removed: Bond is no longer visible in on-chain data. This is a critical alert. It may indicate accidental bond closure. All delegated stake will be lost if not resolved.
Bond balance changed: SOL balance on the bond account changed.
SAM eligibility changed: Validator SAM eligibility toggled (e.g., due to delinquency). Ineligibility means Marinade will not delegate to the validator even if the bid is competitive. See Eligibility Criteria.
Announcements: Broadcast messages from Marinade to all validators.
The notification system is currently in beta. Thresholds, priority levels, and notification frequency may change during testing.
Subscribing to Notifications
Requirements
The
validator-bondsCLI. Install it via npm:npm install -g @marinade.finance/validator-bonds-cliThe bond authority keypair or validator identity keypair (file-based keypair or Ledger hardware wallet).
Subscribe via Telegram
The CLI signs an off-chain message with the authority keypair to prove bond ownership. The browser then opens a Telegram deep link. Press Start in the bot to activate. Notifications are not delivered until confirmation in Telegram. If the browser does not open automatically, copy the link from the CLI output manually.
Telegram activation is required every time a subscription is created or re-created, even for the same bond. Always go through the CLI first.
Subscribe via Email
Unlike Telegram, email subscriptions are active immediately. No additional confirmation step is needed.
Subscription Scope
A subscription currently covers all notification types for the given bond. Granular subscription modes (e.g., subscribing only to critical alerts or specific event types) are not available at this time and may be added in the future.
Viewing Your Subscriptions
To see your active subscriptions for a bond:
Use -f json or -f yaml for machine-readable output.
Unsubscribing
Unsubscribe a specific channel address:
Unsubscribe All Subscriptions of a Given Type
Omit --address:
Unsubscribing requires signing with the bond authority or validator identity keypair, the same as subscribing.
Viewing Notifications
Notifications have a relevance window (typically 2 to 5 days depending on the event type). Older notifications will no longer appear in this view.
To view broadcast announcements from Marinade:
Quick Reference
Subscribe (Telegram)
validator-bonds subscribe <BOND> --type telegram --address @handle --authority keypair.json
Subscribe (Email)
validator-bonds subscribe <BOND> --type email --address [email protected] --authority keypair.json
List subscriptions
validator-bonds subscriptions <BOND> --authority keypair.json
Unsubscribe specific
validator-bonds unsubscribe <BOND> --type telegram --address @handle --authority keypair.json
Unsubscribe all of type
validator-bonds unsubscribe <BOND> --type telegram --authority keypair.json
View notifications
validator-bonds show-notifications <BOND>
View announcements
validator-bonds show-notifications
<BOND> can be either a bond account address or a vote account address.
Ledger Hardware Wallet Support
All subscribe and unsubscribe commands support Ledger hardware wallets. Pass the Ledger as the --authority option and the CLI will prompt to confirm the off-chain message signing on the device.
Last updated
Was this helpful?