Watchtower
Production monitoring dashboard for deployed Soroban smart contracts.
Watchtower gives you operational visibility into your contracts after deployment — real-time invocation tracking, decoded error monitoring, resource consumption trends, storage TTL health, cost attribution, and multi-channel alerting.
Features
- Real-time invocation tracking: Live feed of every function call with caller, status, and resource footprint.
- HostError decoding: Translates cryptic Soroban error codes into human-readable causes and remediations.
- Resource consumption analytics: Track CPU instructions, memory bytes, and ledger reads/writes per function.
- Storage TTL health: Continuous monitoring of storage entries with renewal cost estimates.
- Cost attribution: Aggregated daily/weekly/monthly costs broken down by function and storage.
- Multi-channel alerting: Get notified via Slack, PagerDuty, or Discord when errors spike or state approaches expiration.
How It Works
Watchtower continuously ingests data through two sources:
- Soroban RPC: For real-time events and transaction details.
- Mercury API: For historical depth and resilience fallback.
Dashboard Views
- Invocations: Live stream of function calls with heatmaps.
- Errors: Percentage-based error tracking with decoded host errors.
- Resources: Percentile bands (p50, p95, p99) for compute and storage usage.
- Storage: Color-coded TTL status for all tracked storage keys.
- Costs: Burn rate trend lines and budget utilization gauges.
Support Alert Channels
| Channel | Integration | | :--- | :--- | | Slack | Incoming webhooks with rich formatting | | PagerDuty | Events API v2 for on-call escalation | | Discord | Webhook integration | | Email | Digest and critical alert delivery | | Telegram | Bot API integration | | Webhook | Generic HMAC-signed JSON payloads |
Security
Watchtower is read-only. It never requires or stores any Stellar secret keys. All data is encrypted in transit via HTTPS, and team access is managed through RBAC.
Learn more about the Stellar Ecosystem at stellar.org