Yield Vault Staking
See:
What is the Yield Vault? How Does the Yield Vault Work? Why Stake in the Yield Vault? Important Details & Timeframes Trusted Ownership & Timelock
Find Flareporium Vield Vault Staking at:
Yield Vault Staking is a cornerstone staking mechanism of the Flareporium 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 Flareporium’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 Flareporium’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
claimAllEpochRewardsorclaimAllForUser.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.
See the Yield Vault Staking Contract Manual for further details on the contract.
Further Reading
Last updated