stVaults Watcher : surveillance open source pour les stVaults de Lido V3
Les stVaults de Lido V3 permettent de créer des produits de staking ETH avec différentes configurations, des vaults publics aux déploiements reposant sur une architecture plus spécifique. Mais l'opération d'un stVault ne s'arrête pas au déploiement des contrats ou à l'activation des validateurs. Elle exige aussi une visibilité continue sur la santé du vault, sa liquidité, les demandes de retrait et les conditions pouvant nécessiter une réponse opérationnelle.
C'est pourquoi, chez Stakely, nous avons développé stVaults Watcher, un outil open source destiné à surveiller les stVaults de Lido V3 et leurs pools DeFi Wrapper.
Le projet collecte des données on-chain, les expose sous forme de métriques Prometheus et permet de créer des dashboards Grafana ainsi que des alertes Discord pour suivre un ou plusieurs vaults depuis une seule instance.
Qu'est-ce que stVaults Watcher ?
stVaults Watcher est un outil de surveillance conçu pour les équipes qui opèrent ou supervisent des stVaults construits sur Lido V3.
Il lit des données publiques d'Ethereum via un endpoint RPC et les transforme en métriques pouvant s'intégrer dans une stack d'observabilité existante. L'objectif est d'éviter de dépendre de vérifications manuelles des contrats, interfaces ou explorateurs de blocs chaque fois qu'une question opérationnelle se pose.
L'outil prend en charge Ethereum mainnet et Hoodi testnet, et peut surveiller plusieurs vaults identifiés par des noms lisibles depuis une seule instance.
Les métriques à suivre pour un stVault
Un stVault combine plusieurs éléments d'infrastructure. Une surveillance utile doit donc aller au-delà de la simple vérification de l'activité des validateurs.
stVaults Watcher expose notamment des métriques sur :
- la valeur totale du vault ;
- l'ETH disponible, préparé pour les validateurs et inactif ;
- l'ETH retirable via VaultHub ;
- les frais du node operator non distribués ;
- le health factor et l'état de santé du vault ;
- les ratios d'utilisation et de réserve ;
- le passif stETH et la capacité de mint ;
- l'état de la garantie PDG ;
- l'activité de quarantaine de LazyOracle ;
- les demandes de retrait en attente et leur volume ;
- la fraîcheur des rapports de l'oracle ;
- l'état de connexion avec VaultHub.
Ces données apportent un contexte plus complet sur l'état du vault et aident à identifier les changements qui méritent une analyse avant de devenir un problème opérationnel.
Des alertes sans dépendre de vérifications manuelles
En complément des métriques, stVaults Watcher peut envoyer des alertes vers Discord lorsqu'il détecte des conditions configurées par l'opérateur.
Elles incluent notamment :
- un health factor inférieur aux seuils définis ;
- un vault signalé comme non sain ;
- une demande de retrait en attente de finalisation ;
- un niveau élevé d'ETH inactif ;
- un ratio d'utilisation élevé ;
- un besoin de forced rebalance.
Les alertes intègrent un délai de refroidissement configurable par vault et par type d'alerte, afin d'éviter des notifications répétées pour une même condition.
L'outil ne remplace pas la gestion opérationnelle ni les décisions de l'équipe responsable. Il aide à rendre les signaux importants visibles à temps et à les transmettre dans le canal où l'équipe travaille déjà.
Prometheus, Grafana et une intégration adaptable
L'outil expose les métriques au format Prometheus, ce qui lui permet de s'intégrer dans les environnements d'observabilité utilisant déjà cette technologie.
Il comprend également un dashboard Grafana prêt à être importé. Les équipes peuvent filtrer les données par réseau et par vault, consulter l'état général et suivre les métriques liées à la santé, la liquidité, les retraits et l'activité du watcher.
Pour les équipes qui utilisent déjà Grafana Loki, stVaults Watcher peut aussi envoyer les logs du conteneur vers leur environnement de surveillance. Le projet peut être déployé avec Docker ou exécuté avec Node.js, selon les besoins de chaque équipe.
Un outil ouvert pour un staking plus observable
Les stVaults élargissent les possibilités de construction sur l'infrastructure de Lido V3. À mesure que ces configurations se sophistiquent, l'observabilité ne peut plus être considérée comme un détail secondaire.
La publication de stVaults Watcher comme projet open source sous licence MIT permet à d'autres équipes d'examiner son fonctionnement, de le déployer dans leur propre infrastructure et de l'adapter à leurs processus de surveillance.
Chez Stakely, nous considérons les outils opérationnels comme une composante importante d'une infrastructure plus transparente et plus robuste. Avec ce projet, nous voulons proposer une manière pratique de suivre l'état des stVaults et de faciliter leur opération au quotidien.
Vous pouvez consulter le code, la configuration et le dashboard inclus dans le dépôt stVaults Watcher sur GitHub.
