# Yield Vault Staking

***

**See:**

[#what-is-the-yield-vault](#what-is-the-yield-vault "mention")\
[#how-does-the-yield-vault-work](#how-does-the-yield-vault-work "mention")\
[#why-stake-in-the-yield-vault](#why-stake-in-the-yield-vault "mention")\
[#important-details-and-timeframes](#important-details-and-timeframes "mention")\
[#trusted-ownership-and-timelock](#trusted-ownership-and-timelock "mention")

***

## Find Nexapia Yield Vault Staking at:

[https://stake.nexapia.xyz/yieldvault](https://stake.nexapia.xyz/yieldvaultv2)
-----------------------------------------

***

**Yield Vault Staking** is a cornerstone staking mechanism of the Nexapia ecosystem, designed to **directly** distribute marketplace & further application service fees to **$FOTON** stakers on an epoch-based schedule. This introduction will guide you through what the Yield Vault is, how it operates, and why it can be attractive for participants looking to earn **real-time** **activity-derived** **yield** on their **$FOTON**.

***

## **What is the Yield Vault?**

The Yield Vault is a **staking pool** within Nexapia’s ecosystem that focuses on distributing **marketplace & future application fees** to $FOTON holders. By staking $FOTON in the Yield Vault, participants **directly** share in fees that are deposited into this vault.

* **Key Benefit**: The vault directly captures revenue through use of applications (e.g., from NFT sales fees or other incomes) to then deposit into the contract. Stakers receive these tokens according to their active staked $FOTON share.
* **Strategic Choice**: This vault’s structure ensures **real-time** integration with ecosystem fee flows, making it ideal for participants who want a stake in ongoing marketplace & other application revenue.

***

## **How Does the Yield Vault Work?**

Where the Oracle Vault accumulates over time and focuses on delegation-based WFLR rewards, the Yield Vault can potentially distribute a **variety of** **ERC-20** **fees** sent to it by external scripts such as the marketplace contract. Here’s an overview:

#### **Fee Deposits**

* Various fees (e.g., from the NFT marketplace) can be sent to the Yield Vault in **$FLR**, **$WFLR**, **$FOTON**, **F-Assets** & other **ERC-20** or other tokens you choose to recognize as “reward tokens.”
* These deposits are **not** automated by the contract itself; they are performed externally by the marketplace or a script.

#### **Epoch Model**

* Like the Oracle Vault, the Yield Vault operates on a local “epoch” system. It references Flare’s `rewardManager.getCurrentRewardEpochId()` to identify when to advance epochs (every 3.5 days).
* At each epoch finalization, the vault calculates newly arrived fees and distributes them proportionally to active stakers.

#### **Multiple Token Rewards**

* The Yield Vault can track **several** tokens as “reward tokens.” When new tokens arrive, the contract updates internal accounting so that stakers can claim them at epoch finalization.
* Stakers receive their share of tokens according to how long and how many $FOTON they have actively staked in a finalized epoch.

#### **Manual Claims**

* Similar to the Oracle Vault, users must use a claiming function on our interface to claim their rewards from the vault. Rewards do **not** automatically appear in a staker’s wallet.

***

## **Why Stake in the Yield Vault?**

* **Direct Marketplace Fee Access**\
  The Yield Vault directly taps into the revenue streams from Nexapia’s marketplace (or other applications). This can yield a diverse set of tokens beyond just $FLR.
* **Potential Multi-Token Rewards**\
  By design, the Yield Vault can accept several different **reward tokens**. Participants may benefit significantly if actively staked during periods of high marketplace activity & activity across other applications.
* **Familiar Epoch System**\
  The Yield Vault uses a similar epoch-based approach as the Oracle Vault, giving stakers a consistent, frequent model for earning and claiming.

***

## **Important Details & Timeframes**

#### **Epoch Alignment**

* The vault finalizes its epochs by detecting a **new** Flare reward epoch from the `RewardManager`. Typically \~3.5 days.
* Someone (the owner or a community caller) must call `autoAdvanceEpochPublic()` or related functions that trigger `_advanceLocalEpoch()`.
* A **caller reward** (a small BIPS-based cut, up to 30 $FLR-equivalent in WNAT) is paid to whoever triggers these updates.

#### **Pending vs. Active Stake**

* **Pending Stake**: When you first stake $FOTON, it’s queued until the next epoch increment.
* **Early Unstaking / Forfeiture**: If you remove stake mid-epoch, you **forfeit** the rewards for that removed portion in the current epoch. Only the stake **remaining** at epoch finalization earns that epoch’s rewards.

#### **Claiming Rewards**

* **Manual Claim**: Rewards (fees) must be manually claimed by calling functions like `claimAllEpochRewards` or `claimAllForUser`.&#x20;
* **32-Epoch Retention**: The vault prunes data older than 32 epochs (\~112 days). Rewards not claimed before pruning are redistributed the next epoch, boosting rewards for active stakers.

#### **Epoch Retention & Pruning Unclaimed Rewards**

The vault keeps detailed reward data for 32 epochs (about 112 days). After that point, any unclaimed rewards are effectively “pruned” and recycled back to benefit current stakers. This means you should claim your rewards regularly before they age out. Otherwise, unclaimed rewards from older epochs will boost the distribution for those stakers who remain active.

***

## **Trusted Ownership & Timelock**

* The Yield Vault owner can **pause** user actions, manage which tokens are recognized as “reward tokens,” and perform an **emergency withdrawal** with a **2-day timelock**.
* This ensures transparency if a large withdrawal necessary to be scheduled while giving stakers time to unstake.

***

By staking **$FOTON** in the Yield Vault, participants share directly in marketplace fees and other deposits that flow into this contract. The epoch-based distribution model ensures consistency, while manual claiming and a 2-day emergency withdrawal timelock offer transparency and user control.

{% hint style="info" %}
**Disclaimer**: The information above is subject to change based on evolving network conditions, contract upgrades, or governance decisions within the Nexapia ecosystem. Always review the most current documentation and consider your own risk tolerance before staking.
{% endhint %}

***

See the [yield-vault-staking-contract-manual](yield-vault-staking/yield-vault-staking-contract-manual "mention") for further details on the contract.

***

## Further Reading

* [](<> "mention")
* [block-sapiens-nft-staking](block-sapiens-nft-staking "mention")
* [lp-staking](lp-staking "mention")
