<!--
Sitemap:
- [Welcome to River](/index)
- [Asset-Backed Finance Primer](/concepts/finance-primer)
- [River for Lenders](/lenders/introduction)
- [Depositing](/lenders/depositing)
- [Earning: the Coupon](/lenders/earning)
- [The Accumulating Wrapper](/lenders/wrapper)
- [Withdrawals & Exits](/lenders/withdrawals)
- [Losses & Impairments](/lenders/losses)
- [FAQ](/lenders/faq)
- [Integrate with River](/integrate/get-started)
- [Wrapper Integration](/integrate/wrapper)
- [Class Token Integration](/integrate/class-token)
- [Contract Addresses](/integrate/addresses)
- [Protocol Architecture](/architecture)
- [Actors: Roles & Permissions](/technical/actors)
- [Proxies & Upgradeability](/technical/proxies)
- [Strategies & Reporters](/technical/strategies)
- [Glossary](/concepts/glossary)
- [Dual NAV & Exchange Rates](/accounting/dual-nav)
- [Settlement & Conservation](/accounting/settlement)
- [The Coupon Ledger](/accounting/coupon-ledger)
- [Wrapper Accounting](/accounting/wrapper)
- [Accounting Examples](/accounting/examples)
- [The Tiered Waterfall](/waterfall/)
- [Waterfall Scenarios](/waterfall/scenarios)
- [Security Model](/security)
- [Protocol Invariants](/technical/invariants)
- [List of Assumptions](/technical/assumptions)
- [External Entry Points](/technical/entry-points)
- [Governance](/governance)
- [Contract Reference](/reference/contracts)
- [River Engineering Standards](/reference/engineering-standards)
-->

# The Accumulating Wrapper

The accumulating wrapper is the compounding form of a River position.

A lender can hold the position through an ERC-4626 wrapper that collects the class token's coupon
and rolls it into the wrapper share price. The economic exposure is the same as the class token,
with a compounding product shape.

```mermaid
flowchart LR
    A["Class token<br/>principal + cash coupon"] -- "wrap" --> B["Accumulating wrapper<br/>single growing share"]
    B -- "unwrap" --> A
```

## Why use it

The wrapper is useful when a lender or protocol wants:

* a single balance with principal and coupon combined;
* an ERC-4626 read surface for integrations;
* automatic reinvestment of funded coupon;
* collateral, treasury, vault, or structured-product compatibility.

## Wrapping

Wrapping is synchronous. A holder deposits class tokens and receives wrapper shares in the same
transaction.

## Unwrapping

Unwrapping is cash-first.

If the wrapper has earned cash/coupons available for the holder, that portion pays immediately. Any
remaining principal exposure moves through the underlying class exit process and keeps earning
until paid.

:::tip\[Cash-first behavior]
If the requested unwrap is fully covered by the holder's earned cash capacity, the exit can
settle immediately without joining the class exit queue.
:::

## Transfers

When wrapper shares transfer, the economic exposure transfers with them. Unused instant-cash (realized but unclaimed coupons)
capacity follows the shares proportionally, so the wrapper remains fair to both sender and
receiver.

## Integration surface

The wrapper is the default surface for most protocols. It is easier to compose with because it
looks like a standard ERC-4626 vault for reads and has a single price that reflects retained
income.

Developers should read [Wrapper Integration](/integrate/wrapper) and
[Wrapper Accounting](/accounting/wrapper) before using it as collateral or routing user funds
through it.
