Yield Vault vs Oracle Vault


See:

Quick Comparison Reward Generation Distribution Model Stake Activation & Forfeiture Claiming Rewards & Data Pruning Unique Value Propositions Working Together Important Notes & Disclaimers


Flareporium offers two primary staking vaults for its native $FOTON Token: Yield Vault staking and Oracle Vault staking. Although both vaults share an epoch-based schedule and a manual claiming system, they differ significantly in how rewards are sourced, how participants earn those rewards, and their long-term strategic advantages. These mechanisms complement each other when deployed side by side, offering $FOTON holders a choice (or combination) of staking strategies based on their personal goals.


Quick Comparison

Primary Reward Source

Direct distribution of platform/application fees (e.g., NFT marketplace)

Delegation rewards from Flare’s FTSO via $WFLR (wrapped FLR)

Reward Nature

Multi-token (fees can arrive in $FLR, $FOTON, F-Assets, and other ERC-20s)

Primarily $WFLR (can also accumulate additional $WFLR from monthly airdrops or other inflows)

Reward Dependence

Depends on platform activity and fee inflows during each epoch

Depends on delegation performance over time & external contributions (Mint Treasury, Momentum Reserve, etc.)

Epoch Duration

~3.5 days (aligned with Flare’s reward epochs)

~3.5 days (aligned with Flare’s reward epochs)

Activation of Stake

Pending stake becomes active at the start of each new epoch

Pending stake becomes active at the start of each new epoch

Reward Distribution

Fees that arrive in the vault get allocated proportionally to stakers

Claimed $WFLR delegation rewards get allocated proportionally to stakers

Early Unstake Forfeiture

Removing stake mid-epoch forfeits that epoch’s share of new fees

Removing stake mid-epoch forfeits that epoch’s share of delegation rewards

Long-Term Growth Drivers

Driven by marketplace usage and external fee contributions

Grows with Mint Treasury & Momentum Reserve deposits.

Emergency Withdrawal

2-day timelock for large admin withdrawals

2-day timelock for large admin withdrawals

Unclaimed Rewards After 32 Epochs

Pruned and redistributed to active stakers

Pruned and boosts vault’s $WFLR balance to enhance rewards for active stakers

Ideal For

Stakers wanting to capture real-time ecosystem fee revenue

Stakers seeking a more predictable, potentially growing $WFLR reward mechanism over the long term


Reward Generation

  • Yield Vault

    • Source: Direct fees from Flareporium applications (initially, the NFT Marketplace), plus any external scripts depositing tokens as recognized “reward tokens.”

    • Variability: Highly dependent on actual platform usage. Periods of high marketplace volume can result in significantly higher distributions, potentially in multiple token types.

  • Oracle Vault

    • Source: Delegation rewards from Flare’s FTSO mechanism, plus periodic funding from the Mint Treasury and allocations from the Momentum Reserve. An initial seed of 50,000 FLR will also be provided by the Flareporium Team.

    • Consistency: More predictable, as FTSO delegation rewards arrive regularly via the official Flare RewardManager. Over time, large inflows from the Mint Treasury or the Momentum Reserve can further amplify the total $WFLR stake—thus potentially increasing rewards.


Distribution Model

Both vaults finalize and distribute rewards on an epoch basis, referencing the Flare RewardManager’s epoch (~3.5 days).

  • Yield Vault

    • Multiple tokens (e.g., $FOTON, $FLR, F-Assets, or any ERC-20) can be deposited as “reward tokens.”

    • At epoch finalization, newly arrived tokens are proportionally allocated to stakers, based on the amount of $FOTON actively staked during the epoch.

  • Oracle Vault

    • Rewards are primarily $WFLR collected through FTSO delegations.

    • Upon epoch finalization, the newly claimed $WFLR from delegation is allocated among active stakers.

    • Additional inflows (e.g., if an external address sends FLR or $WFLR) also become part of the distribution pool in subsequent epochs.


Stake Activation & Forfeiture

Both vaults use similar logic for stake activation and forfeiture:

  1. Staking: New deposits go into a “pending” state and only become active at the next epoch transition.

  2. Mid-Epoch Unstake: If you remove or reduce your stake before an epoch ends, the portion removed forfeits that epoch’s reward.

These mechanisms are designed to prevent last-minute staking or unstaking from exploiting the reward cycle.


Claiming Rewards & Data Pruning

  • Manual Claim: Neither vault automatically sends rewards to users. Stakers must call the appropriate claim function (e.g., “claim all”).

  • 32 Epoch Limit: Both vaults store data for ~32 epochs (about 112 days). Unclaimed rewards older than 32 epochs are pruned:

    • Yield Vault: Unclaimed tokens remain in the contract and are “recycled,” effectively boosting yields for the current stakers.

    • Oracle Vault: Unclaimed $WFLR is similarly kept in the vault, increasing the overall delegation amount and subsequent reward generation.

The result is that regular claiming is advisable to avoid losing older rewards.


Unique Value Propositions

Yield Vault

  1. Direct Fee Participation

    • Real-time capture of marketplace and future application fees—highly attractive during peak usage periods.

  2. Multi-Token Rewards

    • Potential for a variety of ERC-20 tokens, which can diversify a staker’s returns.

  3. Revenue Sharing Model

    • A direct link between ecosystem usage and staker payouts.

Oracle Vault

  1. Predictable, Long-Horizon Returns

    • Relying on FTSO delegation yields in $WFLR tends to be more stable and consistent.

  2. Growth Through Additional Funding

    • Contributions from the Mint Treasury and the Momentum Reserve can enhance the vault’s staking power, potentially increasing everyone’s share over time.

  3. Initial Seed Advantage

    • Early stakers can benefit from the Team’s initial 50,000 FLR seeding (where applicable) before the vault hits self-sustaining thresholds.


Working Together

Although each vault stands on its own, deploying both within the ecosystem can balance short-term fee-based income (Yield Vault) with longer-term, predictable $WFLR returns (Oracle Vault). Some $FOTON holders may choose to spread their stake across both:

  • Diversification: Split your $FOTON between the two vaults to benefit from both marketplace fee surges and steady delegation yields.

  • Risk Management: If marketplace volume temporarily dips, the Oracle Vault still generates consistent $WFLR rewards.


Important Notes & Disclaimers

  1. Manual Epoch Advancement

    • Both vaults rely on a function call (either from users or automated scripts) to detect and finalize a new epoch. A “caller reward” in $WFLR or other tokens may incentivize community members to keep the vaults current.

  2. Timelocked Emergency Withdrawals

    • Each vault has a 2-day timelock on large fund withdrawals, ensuring transparency if the owner attempts to remove assets. During this window, participants may unstake if they feel uncomfortable with the action.

  3. Evolving Parameters

    • Configurations like the minimum stake amount and recognized reward tokens may be updated by vault owners over time, subject to governance or team decisions.

  4. Off-Chain Logic

    • Specific thresholds (e.g., the Oracle Vault’s 50,000 FLR seed and 550,000 FLR reclaim threshold) are not enforced by code but are part of the team’s stated operational plan. All inflows and outflows are still visible on-chain and subject to the 2-day timelock process.

  5. Claim Regularly

    • Unclaimed rewards are pruned after 32 epochs, meaning any older rewards are forfeited and effectively boost the rewards for other active stakers.


Summary

Yield Vault Staking and Oracle Vault Staking both leverage Flare’s epoch-based system to reward $FOTON stakers, yet they do so via distinct economic channels:

  • Yield Vault is ideal for stakers who want to directly capture platform fee revenues and potentially earn multiple tokens correlated to ecosystem usage.

  • Oracle Vault focuses on $WFLR delegation rewards, sustained by contributions from the Mint Treasury and the Momentum Reserve, offering a more predictable, growth-oriented staking environment.

By combining or choosing between these vaults, $FOTON holders can tailor their staking strategy to their preference for immediate fee-based yield versus steady, delegation-based accumulation of $WFLR. Both vaults incorporate transparent governance features, manual claiming, and timelocked safeguards to foster trust and security in the Flareporium ecosystem. As always, participants should stay informed of any updates, contract upgrades, or governance decisions that may adjust the vaults’ parameters.

These contain more in-depth technical details, function references, and guidelines on interacting directly with each vault’s smart contract. Please refer to the latest documentation and consider your own risk tolerance before staking.


See the Yield Vault Staking Contract Manual for further details on this contract.

See the Oracle Vault Staking Contract Manual for further details on this contract.


Further Reading

Last updated