> For the complete documentation index, see [llms.txt](https://docs.regenerative.fi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.regenerative.fi/usdrefi/how-it-works.md).

# How it works

USDREFI is designed to be a set-and-forget regenerative savings experience. Here's the complete flow.

## Deposit

1. Verify your identity via [Self](/architecture/identity-and-tiers.md) to unlock vault access
2. Approve USDC spend and deposit into the USDREFI vault
3. Receive USDREFI tokens at a 1:1 rate representing your position
4. The Foundation Safe deploys your capital into curated regenerative credit positions

The vault enforces per-user caps based on your identity tier, and a global cap to manage total exposure.

## Earn Yield

Your deposited capital is deployed into curated lending sources — starting with Quipu (Colombian AI-powered microcredit) via Textile infrastructure. Yield from these real-world loans flows back to the protocol monthly.

Rewards are distributed through [Merkl](/architecture/rewards.md) as a combination of USDREFI and $REFI tokens. You claim rewards on-demand via on-chain Merkle proofs, or compound by re-depositing claimed USDREFI back into the vault.

## Exit

USDREFI does not support direct vault withdrawals. To exit, you swap USDREFI for USDC on the [Uniswap V4 USDREFI/USDC pool](/architecture/uniswap-pool.md).

USDREFI is designed to trade close to $1 but is not a hard-pegged stablecoin — the swap is a market transaction. Protocol-owned liquidity and LP incentives maintain pool depth for healthy exits.

{% hint style="info" %}
If the Uniswap pool ever loses critical liquidity, the Foundation Safe can enable emergency direct vault withdrawals as a safety measure.
{% endhint %}

## The USDREFI Flywheel

USDREFI creates a self-reinforcing regenerative cycle:

1. **Deposits** flow through the Credit Curation Framework into curated lending sources
2. **Yield** is generated from real-world regenerative loans
3. **Yield splits three ways** — to users (rewards), to the protocol (liquidity & operations), and to $REFI incentives
4. **All three streams converge** back into regeneration: users re-deposit and compound, the protocol deepens liquidity and funds new sources, and incentives attract new participants

Every dollar of yield strengthens the system's capacity to regenerate.


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.regenerative.fi/usdrefi/how-it-works.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.