> 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/002.md).

# #002

<figure><img src="/files/sHQmKDMZn1vUN8bGJv8e" alt=""><figcaption></figcaption></figure>

### Mutuum Protocol Update #002 — Initial Codebase Finalized, Fee Collector Complete, Liquidation Indexer Live

#### ✅ Completed&#x20;

**Initial codebase finalized**\
Initial commit of the core workspace and contract set. Includes baseline interfaces, events, libraries, and a clean project structure for contracts, tests, and deployment artifacts. Scaffolding is aligned with the architecture from #001 so future modules slot in without refactors.

**Fee Collector contract (implementation pass)**\
Spec-complete V1 with:

* Role-gated configuration and pausability
* Deterministic accounting, `FeeAccrued` / `FeeRouted` events
* Hooks for the buy-and-distribute path (treasury → market purchase → staker distribution)
* Unit tests around accrual, routing, and failure modes (reverts on invalid params, paused state)

**Liquidation Bot Indexer (service layer)**\
Off-chain indexer that:

* Subscribes to pool/oracle events and normalizes them into the schema from #001
* Maintains exactly-once processing via block/tx cursors and reorg-safe checkpoints
* Derives per-position health metadata for the client bot (LTV/threshold deltas)
* Exposes a job queue for actionable liquidations and alert hooks for edge cases

***

#### ⌛ In Progress

**Oracle integration**\
Chainlink as primary feed with Pyth fallback. Implementing max-age guards, stale-price reverts, and a registry so feeds can be added/removed per market without redeploys. Simulation tests cover primary/fallback switches and boundary conditions.

**Safety Module**\
Secure multisig for privileged actions, mtToken staking flows, proportional rewards via the distribution manager, and the slashing path for covering shortfalls. Current work is on staking/unstaking state transitions and emission math.

**Liquidation Bot (client)**\
Position-health evaluator, execution routing, and flash-loan path (Morpho-inspired) to close under-collateralized debt promptly. Adding notification webhooks and guardrails for race conditions and stale quotes.

***

Released: **03 Oct 2025** (UTC) · Update **#002**


---

# 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/002.md?ask=<question>
```

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.