Skip to content

feat: add USTB (Superstate) monitoring#205

Open
spalen0 wants to merge 2 commits intomainfrom
ustb
Open

feat: add USTB (Superstate) monitoring#205
spalen0 wants to merge 2 commits intomainfrom
ustb

Conversation

@spalen0
Copy link
Copy Markdown
Collaborator

@spalen0 spalen0 commented Apr 7, 2026

Summary

  • Adds monitoring for Superstate USTB (Short Duration US Government Securities Fund) on Ethereum Mainnet
  • New ustb/ folder with hourly monitoring script covering NAV/Share, RedemptionIdle, supply changes, and oracle staleness
  • Adds USTB to stables/main.py for DeFiLlama price checking
  • Wired into hourly GitHub Actions workflow

Monitoring checks

Check Severity Threshold
NAV/Share decrease (checkpoint comparison) CRITICAL Any decrease
Oracle divergence (Continuous vs Chainlink) HIGH > 0.5%
RedemptionIdle USDC balance HIGH < $500K
Supply change (24h cached baseline) HIGH > ±10%
Oracle staleness HIGH > 4 days (reverts at 5)
DeFiLlama price (via stables) CRITICAL < $10.50

Implementation details

  • Uses 2 batched RPC calls (6 calls in batch 1, 2 in batch 2) instead of individual calls
  • 24h supply baseline uses cache-id.txt (shared hourly workflow cache) with separate keys for supply value and timestamp
  • No events used — all monitoring is via contract reads

Closes #189

Test plan

  • Verify RPC calls return expected data with a manual python ustb/main.py run
  • Confirm alerts route to correct Telegram channel
  • Validate cache initialization on first run (no false alerts)
  • Check that stables monitoring picks up USTB price

🤖 Generated with Claude Code

spalen0 and others added 2 commits April 7, 2026 20:37
Monitors the Superstate Short Duration US Government Securities Fund:
- NAV/Share monotonicity check via Continuous Price Oracle checkpoints
- Oracle divergence alert (Continuous vs Chainlink > 0.5%)
- RedemptionIdle USDC balance alert (< $500K)
- Large supply change alert (> 10% in 24h)
- Oracle staleness alert (> 4 days, reverts at 5)
- DeFiLlama price check via stables monitoring

Closes #189

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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.

Add monitoring for USDG

1 participant