> For the complete documentation index, see [llms.txt](https://docs.mutuum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mutuum.com/protocol-updates/001.md).
# #001
### Mutuum Protocol Update #001 โ Architecture & Wireframes Complete, Liquidation Bot in Dev
#### โ Completed
**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**
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.mutuum.com/protocol-updates/001.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.