Metadata-Version: 2.4
Name: ward-protocol
Version: 0.1.0
Summary: XLS-66 Lending Protocol insurance and monitoring SDK
Home-page: https://github.com/wflores9/ward-protocol
Author: Will Flores
Author-email: wflores@wardprotocol.org
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: xrpl-py>=2.5.0
Requires-Dist: asyncpg>=0.29.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Ward Protocol SDK

Python SDK for monitoring XLS-66 Lending Protocol defaults and calculating vault depositor losses.

## Installation
```bash
pip install -e .
```

## Quick Start
```python
import asyncio
from ward.monitor import XLS66Monitor, DefaultEvent

async def main():
    # Connect to XRPL
    monitor = XLS66Monitor("wss://xrplcluster.com")
    
    # Handle defaults
    @monitor.on_default
    async def handle_default(event: DefaultEvent):
        print(f"Default: {event.vault_loss / 1_000_000:.2f} XRP lost")
    
    # Start monitoring
    await monitor.start()

asyncio.run(main())
```

## Features

- ✅ Real-time XLS-66 default detection via WebSocket
- ✅ Automatic vault loss calculation
- ✅ Share value impact analysis
- ✅ LoanBroker and Vault state tracking
- ✅ Async/await support

## Examples

See `/examples` directory for complete examples.

## Documentation

Full documentation: https://github.com/wflores9/ward-protocol/docs
