# DeFi Integration Service

Bridges Lilith treasury and yield strategies into trusted DeFi protocols with
compliance validation, risk monitoring, and analytics reporting.

## Pipeline

1. **Compliance guard** – verifies protocol, pool, and account policies before
   liquidity moves.
2. **Protocol adapter** – executes deposits, withdrawals, harvests, and fetches
   snapshots.
3. **Risk engine** – evaluates position risk levels and raises guardrail
   notifications.
4. **Ledger** – persists positions, yield snapshots, and harvest events for
   auditability.
5. **Notification + analytics** – emits lifecycle events and publishes telemetry
   for dashboards.

## Usage

```ts
import { createDeFiIntegrationService } from './service';

const service = createDeFiIntegrationService({
  protocolAdapter,
  riskEngine,
  complianceGuard,
  ledger,
  analyticsReporter,
  notificationService,
});

const result = await service.provisionLiquidity({
  protocolConfig: {
    protocol: 'aave',
    network: 'polygon',
    poolId: 'aave-v3-matic',
    depositAsset: 'USDC',
    rewardsAsset: 'MATIC',
    strategy: 'stable_yield',
  },
  amount: '100000000',
  account: '0xAyaGuardian',
});
```

## Tests

```bash
npx jest --config apps/lilith/svc-defi-integration/jest.config.cjs --runInBand
```