stVaults Watcher: monitorización open source para stVaults de Lido V3
Los stVaults de Lido V3 permiten construir productos de staking de ETH con configuraciones distintas: desde vaults públicos hasta despliegues con una arquitectura más específica. Pero operar un stVault no termina al desplegar contratos o activar validadores. También exige tener visibilidad continua sobre la salud del vault, su liquidez, las solicitudes de retirada y los elementos que pueden requerir una respuesta operativa.
Por eso, en Stakely hemos desarrollado stVaults Watcher, una herramienta open source para monitorizar stVaults de Lido V3 y sus pools DeFi Wrapper.
El proyecto recopila datos on-chain, los expone como métricas de Prometheus y permite crear dashboards en Grafana y alertas de Discord para seguir el estado de uno o varios vaults desde una misma instancia.
Qué es stVaults Watcher
stVaults Watcher es una herramienta de monitorización pensada para los equipos que operan o supervisan stVaults construidos sobre Lido V3.
Lee datos públicos de Ethereum mediante un endpoint RPC y convierte esa información en métricas que pueden integrarse en una infraestructura de observabilidad existente. El objetivo es que el seguimiento operativo no dependa de consultar contratos, interfaces o exploradores de bloques de forma manual cada vez que surge una duda.
La herramienta es compatible con Ethereum mainnet y con Hoodi testnet, y puede utilizarse para monitorizar varios vaults con nombres identificables desde una única instancia.
Las métricas que importa seguir en un stVault
Un stVault combina diferentes piezas de infraestructura. Por eso, una monitorización útil debe ir más allá de comprobar si los validadores están activos.
stVaults Watcher expone métricas sobre:
- valor total del vault;
- ETH disponible, preparado para validadores e inactivo;
- ETH disponible para retiradas desde VaultHub;
- comisiones pendientes del node operator;
- health factor y estado de salud del vault;
- ratio de utilización y reserva;
- capacidad de emisión y pasivo asociado a stETH;
- estado de la garantía PDG;
- actividad de cuarentena vinculada a LazyOracle;
- solicitudes de retirada pendientes y su volumen;
- frescura de los informes del oráculo;
- estado de conexión con VaultHub.
Esta información permite entender con más contexto qué está ocurriendo en el vault y detectar cambios que merecen seguimiento antes de que se conviertan en un problema operativo.
Alertas para no depender de una revisión manual
Además de las métricas, stVaults Watcher puede enviar alertas a Discord cuando detecta condiciones configurables por el operador.
Entre ellas se incluyen:
- un health factor por debajo de los umbrales definidos;
- un vault marcado como no saludable;
- una solicitud de retirada pendiente de finalizar;
- un nivel elevado de ETH inactivo;
- un ratio de utilización alto;
- una necesidad de forced rebalance.
Las alertas incluyen un periodo de enfriamiento configurable por vault y tipo de evento, para evitar recibir notificaciones repetidas sobre una misma condición.
No sustituye la gestión operativa ni las decisiones del equipo responsable. Sí ayuda a que las señales relevantes sean visibles a tiempo y lleguen al canal en el que el equipo ya trabaja.
Prometheus, Grafana y una integración adaptable
La herramienta expone las métricas en formato Prometheus, por lo que puede encajar en entornos de observabilidad que ya utilicen esta tecnología.
También incluye un dashboard de Grafana listo para importar. Desde ahí se pueden filtrar los datos por red y vault, consultar el estado general y revisar las métricas de salud, liquidez, retiradas y actividad del watcher.
Para equipos que ya trabajan con Grafana Loki, stVaults Watcher también puede enviar los logs del contenedor a su entorno de monitorización. El proyecto está preparado para desplegarse con Docker o ejecutarse con Node.js, según las necesidades de cada equipo.
Una herramienta abierta para un modelo de staking más observable
Los stVaults amplían las posibilidades de construir productos sobre la infraestructura de Lido V3. A medida que estas configuraciones ganan complejidad, la observabilidad deja de ser un detalle secundario.
Publicar stVaults Watcher como proyecto open source bajo licencia MIT permite que otros equipos puedan revisar su funcionamiento, desplegarlo en su propia infraestructura y adaptarlo a sus procesos de monitorización.
En Stakely, entendemos las herramientas operativas como una parte importante de una infraestructura más transparente y robusta. Con este proyecto queremos aportar una forma práctica de seguir el estado de los stVaults y facilitar su operación diaria.
Puedes consultar el código, la configuración y el dashboard incluidos en el repositorio de stVaults Watcher en GitHub.
