Ward Protocol - Institutional Insurance for XRPL DeFi

Overview

Ward Protocol provides institutional insurance for XLS-66 Lending Protocol vault depositors. When borrowers default, lenders lose capital - Ward Protocol makes depositors whole.

1,000 XRP Pool Capital

Infinite Coverage Ratio

0 Default Events

100% Pool Health

Features

Real-Time Monitoring

WebSocket-based XLS-66 default detection with instant alerts and PostgreSQL logging.

9-Step Validation

Automated claim validation using XLS-66/65 formulas with multi-factor verification.

NFT Policies

XLS-20 NFT-based policy certificates with transferable coverage and on-chain metadata.

Risk-Based Pricing

Multi-factor premium calculation with 0.5x-2.0x risk multipliers based on vault metrics.

48-Hour Escrow

Time-locked claim settlement with community dispute window before payout.

XLS-30 AMM Pools

Institutional capital aggregation with 200% minimum coverage ratio enforcement.

Architecture

Core Components

Monitor: Real-time XLS-66 default detection via WebSocket
Validator: 9-step claim validation with XLS-66/65 calculations
Policy Manager: NFT minting and lifecycle management
Premium Calculator: Risk-based pricing engine
Pool Manager: AMM capital management with coverage ratios
Escrow Settlement: Time-locked claim payouts

Technology Stack

XRPL: XLS-66 (Lending), XLS-30 (AMM), XLS-20 (NFT), Escrow
Database: PostgreSQL with 6-table schema
Backend: Python 3.12 with xrpl-py SDK
API: FastAPI with auto-generated docs
Frontend: Vanilla JavaScript with real-time updates

API Documentation

Ward Protocol provides a comprehensive REST API for integration.

Base URL

https://api.wardprotocol.org

Endpoints

GET /health

System health check

curl https://api.wardprotocol.org/health

GET /pools

Get all insurance pools

curl https://api.wardprotocol.org/pools

GET /pools/{pool_id}

Get specific pool details with metrics

curl https://api.wardprotocol.org/pools/fccc5eca-4dfa-4ac7-966f-09ce5786ff76

GET /stats

Protocol-wide statistics

curl https://api.wardprotocol.org/stats

GET /defaults

Get default events with optional vault filter

curl https://api.wardprotocol.org/defaults?limit=10

Interactive Docs

Full Swagger UI available at:

https://api.wardprotocol.org/docs

Deployment

Testnet Status

Ward Protocol is currently deployed on XRPL Testnet:

Network: XRPL Testnet
Pool ID: fccc5eca-4dfa-4ac7-966f-09ce5786ff76
Operator: rPJsGb9V1NivCptS6P8KmsWaViVsUYfyLf
Pool Account: rK4dpLy9bGVmNmnJNGzkHfNdhB7XzZh9iV
Initial Capital: 1,000 XRP

Quick Start

                # Clone repository
git clone https://github.com/wflores9/ward-protocol.git
cd ward-protocol

# Setup database
./database/setup_database.sh

# Create testnet wallets
python3 scripts/setup_testnet_wallets.py

# Deploy to testnet
python3 scripts/deploy_testnet.py

# Start monitoring
python3 scripts/start_monitor.py
            

Insurance for XRPL DeFi Lending