SAM Tools

Monitoring scripts for DeFi protocols to track key metrics and send alerts.

Supported Protocols

• Aave V3
• Compound V3
• Ethena
• Euler
• Lido
• LRTs
• Maker DAO
• Moonwell
• Morpho
• Pendle
• Resolv
• RTokens - ETH+
• Silo
• Spark
• Stargate
• USD0 - Usual Money

Telegram Alerts

• Invite SAM alerter bot to Telegram group using handle: @sam_alerter_bot

Installation

1. Clone the repository

git clone https://github.com/yearn/monitoring-scripts-py.git
cd monitoring-scripts-py

2. Set up virtual environment

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. Install dependencies

uv pip install -e ".[dev]"

Note: This project uses uv for faster dependency installation. If you don't have uv installed, you can install it with pip install uv or follow the installation instructions.

4. Environment setup

Copy and edit example environment file:

cp .env.example .env

Usage

Run a specific script for a protocol. Example:

uv run aave/main.py

Code Style

Format and lint code with ruff:

uv run ruff format .
uv run ruff check --fix .