> For the complete documentation index, see [llms.txt](https://docs.kpk.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kpk.io/funds/infrastructure/onchain-accounting/price-feeds/rwiv.md).

# RWIV

Custom price feed for the **Nexus Mutual Real-World Investments Vault (RWIV)**. RWIV is an ERC-4626 vault share backed by USDC. The price is derived from the vault's current share-to-asset conversion rate multiplied by the USDC/USD price read from the NAV's own primary feed.

**Source:** [`RWIV_CustomPriceFeed.sol`](https://github.com/karpatkey/onchain-accounting/blob/main/src/prices/protocols/RWIV_CustomPriceFeed.sol)

{% hint style="info" %}
The USDC/USD term is sourced from the NAV's own selector — see [Base/USD from the NAV's own selector](/funds/infrastructure/onchain-accounting/price-feeds.md#base-usd-from-the-navs-own-selector).
{% endhint %}

***

## Approach

`RWIV.convertToAssets(1 RWIV)` × USDC/USD (from the NAV's primary feed via `getPriceDataNoDivergence(USDC)`)

<figure><img src="/files/xoWXpp3ZBhkFdHAiXasP" alt="Left-to-right flowchart of the RWIV price feed: rate and Chainlink inputs combine into a USD price, with a staleness gate."><figcaption><p>RWIV price feed — how its oracle inputs compose into a USD price, with the staleness gate.</p></figcaption></figure>

***

## Price calculation

```
decimals = RWIV.decimals()                        // vault share decimals
rate     = RWIV.convertToAssets(10^decimals)       // USDC per 1 RWIV (vault decimals)
price    = rate × USDC_USD / 10^decimals
```

| Input               | Source                                              | Description                                             |
| ------------------- | --------------------------------------------------- | ------------------------------------------------------- |
| `convertToAssets()` | `IERC4626(RWIV)`                                    | USDC backing per 1 RWIV share at the current vault rate |
| `USDC_USD`          | NAV base — `getPriceDataNoDivergence(USDC)` (8 dec) | the NAV's primary USDC/USD price                        |

The ERC-4626 `convertToAssets` call returns the current exchange rate. The vault decimals are read once at deploy. Result carries the feed's **8 decimals**. The USDC/USD base term is read from the NAV's primary feed rather than a hardcoded oracle.

***

## Constructor

```solidity
constructor(
    address rwiv_,
    address nav_,
    address baseAsset_
)
```

| Parameter    | Description                                                                                                                                 |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `rwiv_`      | The RWIV vault address (also used to read vault decimals)                                                                                   |
| `nav_`       | NAVCalculator (proxy) — supplies the base stablecoin's USD price via `getPriceDataNoDivergence`                                             |
| `baseAsset_` | The registered base stablecoin whose USD price is read (USDC); **must equal the vault's `asset()`** — reverts `BaseAssetMismatch` otherwise |

***

## Staleness

The price is stale if the base USD price is `≤ 0`, or if the NAV reports the base asset (USDC) stale — all its feeds stale. The base leg's `updatedAt` comes from the NAV's selected USDC feed. The `convertToAssets` rate has no heartbeat — it is a live view on the ERC-4626 vault.

***

## Chains

Deployed on **Ethereum mainnet** only.


---

# 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.kpk.io/funds/infrastructure/onchain-accounting/price-feeds/rwiv.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.