feat: Inverse finance

.github/workflows/hourly.yml

@@ -119,6 +119,8 @@ jobs:
         run: uv run rtoken/monitor_rtoken.py
       # - name: Run USD0 Peg Price Checker
       #   run: uv run usd0/price.py
+      - name: Run Inverse script
+        run: uv run inverse/inverse.py
       - name: Run RESOLV Monitoring script
         run: uv run resolv/resolv.py
       - name: Run Ethena script

inverse/README.md

@@ -0,0 +1,33 @@
+# Inverse Finance
+
+## FiRM (Fixed Rate Market)
+
+### Data Monitoring
+
+The script `inverse/inverse.py` runs [hourly via GitHub Actions](../.github/workflows/hourly.yml) to monitor key health indicators of the Inverse Finance system using API data.
+
+#### FiRM Monitoring
+
+- **DOLA Supply Check**: Alerts if FiRM's circulating supply exceeds the total DOLA circulating supply by more than 9M DOLA (accounting for Frontier bad debt and Gearbox).
+- **TVL to Borrows Ratio**: Alerts if borrows exceed 80% of the TVL, indicating high utilization.
+
+#### DOLA Staking Monitoring
+
+- **DOLA Price Stability**: Alerts if DOLA price drops below $0.998, indicating potential depegging.
+- **Staking Coverage**: Alerts if total staked DOLA assets are less than the sDOLA supply, indicating potential undercollateralization.
+- **Exchange Rate Validation**: Verifies that the calculated exchange rate matches the reported rate from the API.
+
+All API responses are validated to ensure data is not older than 2 hours.
+
+#### DOLA Supply Monitoring
+
+DOLA supply is checked from the contract and verified it matches the supply from the API. API data is calculated by summing all values from FED list. If the difference is greater than 0.5%, telegram alert is sent.
+
+#### SDOLA Supply Monitoring
+
+Check SDOLA supply from the contract and verify it matches the supply from the API, if the difference is greater than 0.5%, telegram alert is sent. Exchange rate is also verified from the contract and API.
+
+## Governance
+
+- Monitor [Governance timelock contract](https://etherscan.io/address/0xe082EB109fAd53eA8DB9827ce6b8ef74882734fc#readContract#F3) using Tenderly alerts. TODO: add tenderly before merging
+- Monitor [chair multisig](https://etherscan.io/address/0xe082EB109fAd53eA8DB9827ce6b8ef74882734fc#readContract#F1) which can mint and burn additional liquidity.