Feat/deepbook

LOANS.md

@@ -249,15 +249,21 @@ sui move test
 sui move test --coverage
 ```
 
-## Future: DeepBook Integration
+## Future: DeepBook Integration — ⏸️ DEFERRED
 
-Planned enhancements via DeepBook V3:
-- **Phase 1:** Flash loan liquidations (capital-free)
-- **Phase 2:** Dynamic interest rates (utilization-based)
-- **Phase 3:** Hybrid liquidity (source from DeepBook pools)
-- **Phase 4:** DEEP token rewards for backers
+DeepBook integration is **deferred** until the protocol reaches scale:
 
-See [spec/deepbook-integration-v1.md](./spec/deepbook-integration-v1.md) for the full specification.
+**Current approach (v1):**
+- Treasury-funded loans (simple, works for 1-2 issuers)
+- Fixed 5% APR (predictable for borrowers)
+- Standard liquidations (rarely needed with self-paying loans)
+
+**When to revisit DeepBook:**
+- Treasury consistently 50%+ utilized
+- 3+ issuers onboarded
+- User demand for dynamic rates
+
+See [spec/deepbook-integration-v1.md](./spec/deepbook-integration-v1.md) for the full specification (when ready to implement).
 
 ## Related Documentation
 

MARKETPLACE.md

@@ -334,18 +334,20 @@ This emits a `TreasuryDeposit` event for tracking.
 | TransferPolicy | High | Ecosystem-wide royalty enforcement |
 | Yield Display | High | Show pending rewards on UI |
 
-## Future: Marketplace v2 (Bid System)
+## Future: Marketplace v2 (Bid System) — Deferred
 
-A bid system is planned to enable:
+A bid system was considered to enable:
 - **Buy Orders** - Buyers place standing bids with escrowed funds
 - **Instant Sell** - Sellers match against best bid
 - **Flash Liquidations** - Capital-free liquidations via DeepBook
 
-See [spec/marketplace-v2.md](./spec/marketplace-v2.md) for the full specification.
+**Status:** ⏸️ **DEFERRED** — Flash Liquidate + Keep provides 90% of value without requiring a bid system.
+
+See [spec/marketplace-v2.md](./spec/marketplace-v2.md) for the specification (when revisiting).
 
 ## Related Documentation
 
 - [spec/marketplace-v1.md](./spec/marketplace-v1.md) - Full technical specification (current)
-- [spec/marketplace-v2.md](./spec/marketplace-v2.md) - Bid system specification (planned)
+- [spec/marketplace-v2.md](./spec/marketplace-v2.md) - Bid system specification (deferred)
 - [README.md](./README.md) - Protocol overview
 - [ADAPTERS.md](./ADAPTERS.md) - Revenue adapter integration

PLAN.md

@@ -849,11 +849,19 @@ The following features have been added to expand the v1 foundation:
 - 21 tests (14 unit + 7 E2E)
 - See: `spec/self-paying-loans-v2.md`
 
-### Future: DeepBook Integration (Planned)
-- Flash loan liquidations (Phase 1)
-- Dynamic interest rates (Phase 2)
-- Hybrid liquidity (Phase 3)
-- DEEP token rewards (Phase 4)
+### Future: DeepBook Integration — ⏸️ DEFERRED
+
+DeepBook integration is deferred until the protocol reaches scale.
+
+**Current approach (v1):**
+- Treasury-funded loans (sufficient for FAITH + 1-2 issuers)
+- Fixed 5% APR
+
+**When to revisit:**
+- Treasury 50%+ utilized
+- 3+ issuers onboarded
+
+See [spec/deepbook-integration-v1.md](./spec/deepbook-integration-v1.md) for the full specification.
 - See: `spec/deepbook-integration-v1.md`
 
 ### Future: Marketplace Bid System (Planned)

README.md

@@ -511,9 +511,9 @@ tide-protocol/
 ├── spec/
 │   ├── tide-core-v1.md          # Locked specification
 │   ├── marketplace-v1.md        # Marketplace specification (current)
-│   ├── marketplace-v2.md        # Marketplace bid system (planned)
+│   ├── marketplace-v2.md        # Marketplace bid system (deferred)
 │   ├── self-paying-loans-v2.md  # Self-paying loans design (v2)
-│   ├── deepbook-integration-v1.md # DeepBook integration (planned)
+│   ├── deepbook-integration-v1.md # DeepBook integration (deferred)
 │   ├── frontend-spec.md         # Frontend/API specification
 │   └── invariants.md            # Audit-ready invariant list
 │
@@ -576,15 +576,22 @@ See [LOANS.md](./LOANS.md) for:
 - Keeper model for harvesting
 - Liquidation mechanics
 
-### DeepBook Integration (Planned)
+### DeepBook Integration — ⏸️ DEFERRED
 
-See [spec/deepbook-integration-v1.md](./spec/deepbook-integration-v1.md) for planned enhancements:
-- **Phase 1A:** Flash liquidate + keep (liquidator keeps pass)
-- **Phase 1B:** Marketplace bid system ([spec/marketplace-v2.md](./spec/marketplace-v2.md))
-- **Phase 1C:** Flash liquidate + sell (true capital-free liquidations)
-- **Phase 2:** Dynamic interest rates (utilization-based)
-- **Phase 3:** Hybrid liquidity (source from DeepBook pools)
-- **Phase 4:** DEEP token rewards for backers
+DeepBook integration is **deferred** until the protocol reaches scale.
+
+**Current approach (v1):**
+- Treasury-funded loans (sufficient for FAITH + 1-2 issuers)
+- Fixed 5% APR (simple, predictable)
+
+**When to revisit:**
+- Treasury 50%+ utilized consistently
+- 3+ issuers onboarded
+- User demand for dynamic rates
+
+See [spec/deepbook-integration-v1.md](./spec/deepbook-integration-v1.md) for the specification (when ready).
+
+**Note:** Phase 3 has sub-phases: 3A (flash + keep), 3B (marketplace bid system), 3C (flash + sell).
 
 ## Protocol Integrations