> ## Documentation Index
> Fetch the complete documentation index at: https://docs-staging.centuari.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Idle Yield Router

> Automatic deployment of idle capital to maximize capital efficiency via the Idle Yield Router

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/centuari/assets/gifs/yield-router.gif" alt="Animation showing idle capital automatically flowing to yield protocols and being recalled for order matching" />
</Frame>

## Overview

Idle Yield Router automatically deploys idle capital (unmatched lend orders, withdrawal buffers) to low-risk yield protocols. When orders match or withdrawals are needed, capital is instantly recalled.

<Info>
  **Capital Efficiency**: Instead of capital sitting idle in the order book earning 0%, Idle Yield Router puts it to work while maintaining instant availability.
</Info>

## The Problem

In an order book model, capital often sits idle:

| Scenario                     | Traditional Result |
| ---------------------------- | ------------------ |
| Lend order waiting for match | 0% yield           |
| Vault withdrawal buffer      | 0% yield           |
| Partial fill remainder       | 0% yield           |
| Between maturities           | 0% yield           |

This idle capital represents significant opportunity cost.

## The Solution

<CardGroup cols={2}>
  <Card title="Auto-Deploy" icon="rocket">
    Idle capital automatically deployed to yield sources
  </Card>

  <Card title="Instant Recall" icon="bolt">
    Capital recalled instantly when needed
  </Card>

  <Card title="Low Risk" icon="shield">
    Only battle-tested, liquid protocols
  </Card>

  <Card title="Transparent" icon="eye">
    See exactly where capital is deployed
  </Card>
</CardGroup>

## How It Works

<Steps>
  <Step title="Deposit Capital">
    You deposit USDC and place a lend order
  </Step>

  <Step title="Order Enters Book">
    If no immediate match, order waits in book
  </Step>

  <Step title="Idle Yield Router Activates">
    After short delay, capital routes to yield protocols
  </Step>

  <Step title="Earn While Waiting">
    Capital earns yield from Aave, Compound, etc.
  </Step>

  <Step title="Order Matches">
    When a borrower matches your order...
  </Step>

  <Step title="Instant Recall">
    Capital recalled from yield protocol in same transaction
  </Step>

  <Step title="Position Created">
    Your fixed-rate position begins, keeping the interim yield
  </Step>
</Steps>

## Yield Sources

Capital is deployed to a curated list of low-risk protocols:

| Protocol     | Asset | Typical Yield | Risk Level |
| ------------ | ----- | ------------- | ---------- |
| Aave V3      | USDC  | 2-5%          | Very Low   |
| Compound V3  | USDC  | 2-4%          | Very Low   |
| MakerDAO DSR | DAI   | 3-5%          | Very Low   |
| Spark        | DAI   | 3-5%          | Very Low   |

<Warning>
  **Conservative Selection**: Idle Yield Router only uses established, audited protocols with high liquidity. Riskier high-yield opportunities are not included.
</Warning>

### Selection Criteria

Protocols must meet all criteria:

* [ ] \$100M+ TVL
* [ ] Multiple security audits
* [ ] 1+ year operating history
* [ ] Instant or near-instant withdrawals
* [ ] No lock-up periods
* [ ] Sufficient liquidity for recall

## Capital Flow

```
User Deposit ($100,000 USDC)
         │
         ▼
┌─────────────────┐
│   Order Book    │ ← Order waiting for match
│   (Your Order)  │
└────────┬────────┘
         │
         ▼ (After 5 min delay)
┌─────────────────┐
│  Idle Yield Router   │ ← Routes to highest-yield eligible protocol
└────────┬────────┘
         │
    ┌────┴────┬─────────┐
    ▼         ▼         ▼
┌───────┐ ┌───────┐ ┌───────┐
│ Aave  │ │Compound│ │ DSR   │
│ 3.5%  │ │  3.2%  │ │ 4.0%  │ ← DSR selected (highest)
└───────┘ └───────┘ └───┬───┘
                        │
         When order matches...
                        │
         ▼ (Instant recall)
┌─────────────────┐
│   Order Book    │ ← Match executed
│   (Matched!)    │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│ Fixed-Rate      │ ← Your Centuari position begins
│ Position (CBT)  │
└─────────────────┘
```

## Configuration

### For Individual Users

Idle Yield Router is **enabled by default** for:

* Unmatched lend orders
* Cancelled order refunds (brief period)

You can disable it in settings if you prefer capital to remain idle.

### Protocol-Managed

Idle Yield Router is currently in v0. The protocol manages all parameters including allowed protocols, deployment thresholds, and diversification limits. Once Mutual Fund Vaults are production-ready, idle capital will be allocated into Centuari Mutual Fund Vaults, also managed by the protocol.

## Yield Distribution

Who keeps the yield from Idle Yield Router?

<Tabs>
  <Tab title="Individual Users">
    **You keep 100% of interim yield**

    Example:

    * Deposit \$10,000 USDC, place lend order
    * Order waits 5 days before matching
    * Idle Yield Router earned 0.05% during wait (\~\$5)
    * You keep the \$5 (added to your CBT position)
  </Tab>

  <Tab title="Vault Depositors">
    **Yield accrues to vault**

    Interim yield increases vault share price, benefiting all depositors proportionally.
  </Tab>
</Tabs>

## Recall Mechanics

When capital is needed, Idle Yield Router executes instant recall:

### Single-Transaction Recall

All happens atomically:

1. Order match initiated
2. Capital withdrawn from yield protocol
3. Transfer to order book
4. Match executed
5. CBT issued to lender

If any step fails, entire transaction reverts.

### Gas Handling

* Recall gas covered by protocol
* No additional cost to users
* Included in standard gasless experience

## Risk Considerations

### Protocol Risk

<Info>
  Idle Yield Router uses only established protocols, but smart contract risk always exists. The protocol maintains insurance coverage for yield source failures.
</Info>

| Risk                   | Mitigation                         |
| ---------------------- | ---------------------------------- |
| Smart contract exploit | Insurance fund, diversification    |
| Protocol pause         | Multiple fallback protocols        |
| Liquidity crunch       | Only protocols with deep liquidity |

### Opportunity Cost Risk

In rare cases, recall might happen at unfavorable moment:

* Protocol has temporary withdrawal fee
* Gas spike makes recall expensive

Protocol absorbs these costs; users are not affected.

## Monitoring

### Dashboard View

See your capital's current deployment:

```
Your Idle Capital: $50,000 USDC

Currently Deployed:
├── Aave V3: $30,000 (60%) @ 3.5% APY
├── Compound V3: $20,000 (40%) @ 3.2% APY
└── Total earning: ~$4.50/day

Accumulated Yield: $127.50 (25 days)
```

### Yield History

Track interim yields earned over time:

| Period   | Idle Days | Yield Earned | Effective APY |
| -------- | --------- | ------------ | ------------- |
| March    | 12.5      | \$145.20     | 3.4%          |
| February | 8.2       | \$89.50      | 3.2%          |
| January  | 15.0      | \$178.00     | 3.5%          |

## FAQs

<AccordionGroup>
  <Accordion title="Does Idle Yield Router delay my order matching?">
    No. Idle Yield Router operates asynchronously. Your order is always available for matching at your specified rate. Capital is recalled instantly in the same transaction as the match.
  </Accordion>

  <Accordion title="What if the yield protocol doesn't have liquidity?">
    Protocols are selected for deep liquidity. If somehow a recall fails, the protocol uses reserve funds to complete your match while waiting for withdrawal.
  </Accordion>

  <Accordion title="Can I choose which yield protocols to use?">
    The protocol manages all Idle Yield Router parameters. Individual users use protocol defaults.
  </Accordion>

  <Accordion title="Is the interim yield taxable?">
    Likely yes, as investment income. Consult a tax professional for your jurisdiction.
  </Accordion>

  <Accordion title="How is protocol selection determined?">
    Idle Yield Router selects the highest-yielding eligible protocol at deployment time, subject to diversification limits.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="Auto-Deployment" icon="play" href="./auto-deployment">
    Learn how capital is automatically deployed
  </Card>

  <Card title="Capital Recall" icon="rotate-left" href="./capital-recall">
    Understand the instant recall mechanism
  </Card>
</CardGroup>
