# #001

<figure><img src="https://3881291275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCaql6uzRSSdezScAKgMU%2Fuploads%2Fx5CMuuXltWSIkIJX7HmD%2FProtocol001.png?alt=media&#x26;token=41c13a21-c982-49ab-816d-238e67f7602c" alt=""><figcaption></figcaption></figure>

### Mutuum Protocol Update #001 — Architecture & Wireframes Complete, Liquidation Bot in Dev

#### ✅ Completed&#x20;

**System Architecture**\
End-to-end blueprint for V1: contract layout (liquidity pool, mtToken, debt token, fee collector), indexing layer, and client services. Defines permission boundaries, upgrade paths, and the flow of funds/events through the stack.

**UI/UX Wireframes**\
Core flows mapped: deposit, withdraw, borrow, repay, stake/unstake, and portfolio/health views. Screen states cover success, pending, and error, plus edge cases (insufficient collateral, oracle delay).

**Custom Lending Pool Configuration**\
Baseline market presets for initial assets (e.g., ETH, USDT): utilization-based rate model hooks, LTV and liquidation thresholds, reserve factors, and asset listing parameters. Config is modular so new markets can be added without contract rewrites.

**Event Handlers (indexing layer)**\
Listeners scaffolded for key on-chain events: `Deposit`, `Withdraw`, `Borrow`, `Repay`, `Liquidation`, and `FeeAccrued`. Handlers normalize payloads, enforce idempotency, and write to an event cursor to guarantee exactly-once processing.

**Fee Collector Contract**\
V1 contract to accrue protocol fees and emit structured accounting events. Supports routing to treasury and the buy-and-distribute path for MUTM, with role-gated controls and pausability for safe operations.

**Custom Database Schema**\
Initial schema for positions, accounts, markets, price snapshots, and event cursors. Designed for fast reads (portfolio/health) and durable audit trails, with indexes on block/time and address to power real-time dashboards.

***

#### ⌛ In Progress

**Liquidation Bot (client)**\
Development started. The service listens to pool/oracle events, updates an off-chain state store, evaluates position health, and executes liquidations when required. Includes alert hooks for edge cases and support for flash-loan based execution (built on the Morpho Blue reference with custom safeguards).

***

Released: **19 Sep 2025** (UTC) · Update **#001**