Oracle Vault Staking
See: What is the Oracle Vault? How Does the Oracle Vault Work? Why Stake in the Oracle Vault? User Journey Important Details & Timeframes Trusted Ownership & Timelock
Coming Soon! Tests Ongoing!
DO NOT Interact With This Contract Until Given Notice!
The Oracle Vault is a key component of the Flareporium ecosystem, designed to assist Flareporium in successfully operating its own Flare Time Series Oracle (FTSO) on the Flare Network and to provide consistent, strategic rewards for $FOTON holders through delegation-based staking. This introduction will guide you through what the Oracle Vault is, how it operates, and why it can be an attractive option for participants looking to maximize their $FOTON staking returns.
What is the Oracle Vault?
The Oracle Vault is a staking pool within the Flareporium ecosystem that supports the operation of the FTSO while providing opportunities for $FOTON holders to earn rewards. By staking $FOTON in the Oracle Vault, participants support the delegation of $WFLR to FTSO providers, which in turn generates $WFLR rewards for the staker.
Key Benefit: The Vault is central to Flareporium’s goal of eventually expanding its own oracle capabilities and enhancing its network participation.
Strategic Choice: This vault is designed to create predictable and sustainable returns for stakers, making it a strong option for those interested in long-term participation.
How Does the Oracle Vault Work?
The Oracle Vault leverages the Flare Network’s FTSO delegation mechanism to generate $WFLR rewards that are distributed to $FOTON staking participants. Here’s how it works:
Initial Contribution
At the inception of the Oracle Vault, an initial fund of 50,000 $FLR is provided by the Flareporium Team to jump-start reward generation.
Important Clarification (Off-Chain Seed): The reference to “50,000 FLR” and any reclaim threshold (e.g., 550,000 FLR) is not enforced by the contract code. The Team may deposit these funds manually. If and when they decide to withdraw the initial seed, it will be done via the contract’s generic 2-day timelock function, just like any other emergency withdrawal. This process is fully transparent on-chain. The code does not automatically track the “550,000 FLR threshold”; it is strictly an off-chain/business logic decision.
Once the vault surpasses 550,000 $FLR through growth, the Team may reclaim its initial seed, ensuring the vault remains self-sustaining. This withdrawal also uses the contract’s emergency withdrawal function with a 2-day timelock, providing transparency to participants. Prior notice will be given, and the transaction ID will be highlighted to our community.
Gradual Allocation from Mint Treasury
As the ecosystem progresses, a portion of the Mint Treasury is gradually allocated to the Oracle Vault. This inflow increases the reward potential of the Vault, providing additional value for participants.
Boost from Momentum Reserve
The Vault is further expanded by contributions from the Momentum Reserve, which allocates 20% of its funds to grow the Oracle Vault, ensuring the vault continues to increase its reward-generating potential over time.
Delegation-Based Rewards
The Vault (through its owner) delegates $WFLR to FTSO providers on the Flare Network. These delegations earn $WFLR rewards, which are then credited to the vault by the official RewardManager contract. The Vault must periodically call claim() (with or without proofs) from this RewardManager to pull those rewards in. Once collected, these rewards are then distributed back to $FOTON stakers on an epoch-based model.
Why Stake in the Oracle Vault?
Predictable Rewards
By leveraging the FTSO delegation mechanism, the Oracle Vault regularly generates $WFLR rewards to distribute to $FOTON stakers. This offers participants a more predictable source of passive rewards than some other staking methods.
Reward Amplification
Contributions from the Momentum Reserve amplify rewards for stakers. As ecosystem activity grows, more funds are allocated to the vault, increasing total delegation and overall reward potential.
Early Participant Advantage
Early stakers benefit from the initial seed funding (50,000 $FLR), which provides a head start in generating rewards. Those who stake early can enjoy competitive returns before the $FOTON staked grows larger.
User Journey
Follow these simple steps to understand the staking and rewards process:
Staking Initiation:
Begin by staking your $FOTON tokens, which will initially enter a pending state.
Your deposit is recorded, and your account is queued for activation.
Epoch Activation:
Once a new epoch is triggered, the system activates your staked tokens.
Your pending status is updated, and your stake becomes active.
Reward Computation:
During each epoch, the system calculates your rewards based on your active stake.
Rewards are tracked in two components: delegation rewards (e.g., WFLR) and surplus or recycled rewards (e.g., $FOTON).
Claiming Rewards:
After epochs pass, you can manually claim your rewards.
Simply initiate the claim process to transfer your accrued rewards to your wallet.
Important Details & Timeframes
Epoch Alignment
The vault finalizes its epochs by detecting a new Flare reward epoch from the RewardManager. Flare Network typically advances its reward epoch every ~3.5 days, so the Oracle Vault effectively follows this ~3.5-day cycle for distributing rewards.
Local Epoch Requires Calls The Vault’s local epoch does not advance on its own. A user or a script must call autoAdvanceEpochPublic() or any function that internally triggers _advanceLocalEpoch(). This is why a “caller reward” exists—to incentivize community members or bots to periodically update the vault. This action can be performed easily on the front-end interface.
Pending vs. Active Stake
Pending Stake: When you first stake $FOTON, it becomes pending and will activate after the next epoch transition.
Early Unstaking / Forfeiture: If you unstake (fully or partially) before the epoch ends, you forfeit rewards for the portion of stake you removed during that epoch. The code implements this by marking “forfeited stake” in the user’s record, meaning that even if you staked right up until the last minute, any stake you remove before the epoch fully concludes will earn no reward for that epoch. Only the amount of $FOTON you have actively staked at the end of the epoch counts toward that epoch’s reward distribution.
How Forfeiture Works (In Detail)
When you reduce your stake partway through an epoch, the contract immediately flags that reduced portion as “forfeited.”
At epoch finalization, any forfeited portion is excluded from the calculations that determine how much $WFLR reward you earn.
Therefore, your final reward share for that epoch is based solely on the amount of stake you still have active at the end of the epoch.
Practical Tip: It’s generally optimal to unstake (if you must) shortly after an epoch begins if you don’t want to forfeit the entire epoch’s reward for the removed stake.
Claiming Rewards
Manual Claim: Rewards do not automatically move to your wallet. You must call the Vault’s claiming functions (e.g., “claim all”) to receive your accrued $WFLR.
32-Epoch Retention: You must claim rewards within 26 epochs (around 91 days). After that, older epoch data is pruned, and any unclaimed rewards from pruned epochs become permanently unclaimable.
Unclaimed Rewards “Bolster” the Vault
If you fail to claim before data is pruned, the unclaimed rewards remain in the Vault’s $WFLR balance. They are no longer claimable by you, effectively boosting the vault’s overall delegation power.
Trusted Ownership & Timelock
The Vault has an owner (initially the Flareporium Team) who manages delegation settings and, if necessary, can invoke an emergency withdrawal with a 2-day timelock. This 2-day window ensures transparency: if the owner schedules a withdrawal, participants can unstake if they disagree.
Emergency Withdraw & Timelock The owner’s emergency withdrawal function can remove FLR or ERC20 tokens from the vault. By design, this function is time-locked for 2 days, allowing the community to see the request on-chain and take action (like unstaking) if they have concerns.
More on Airdrops
The vault also provides a function to claim Flare monthly distributions. Funds claimed via this method are not automatically distributed to stakers; instead, they remain in the vault’s balance (wrapped into WFLR), further boosting ongoing delegation rewards to $FOTON stakers within this vault.
The Flareporium Oracle Vault offers an exciting opportunity for $FOTON holders to benefit from predictable, delegation-based returns while supporting the expansion of Flareporium’s oracle capabilities. By staking in the Oracle Vault, participants play a crucial role in enhancing the Flare network while enjoying consistent, amplified rewards.
See the Oracle Vault Staking Contract Manual for further details on the contract.
Further Reading
Last updated