feat(staking-vault): add early-exit penalty and unbonding cooldown

[Devsol-01]

Summary

This PR adds an unbonding cooldown and configurable early-exit penalty to the staking vault.

Previously, stakers could unlock and withdraw their funds immediately, allowing them to enter and exit around reward snapshots without any cooldown or penalty. This could dilute rewards for stakers who remain in the vault.

Changes

• Added a configurable unbonding cooldown for unlocked positions.
• Added pending-unlock timestamp tracking per staking position.
• Prevented withdrawals before the configured cooldown period unless the configured early-exit behavior allows them.
• Added configurable early-exit penalties in basis points.
• Routed collected penalties through the vault fee handling.
• Added checked arithmetic for penalty and withdrawal calculations.
• Added WithdrawalLocked error for withdrawals attempted before the cooldown expires.
• Added InvalidPenaltyConfig error for invalid penalty configurations.
• Rejected penalty configurations greater than 10,000 bps.
• Updated staking storage types to track pending unlock state.
• Added tests covering cooldown, penalties, fee routing, and invalid configurations.

Testing

• Tested unlocking a staking position and verifying the pending-unlock timestamp.
• Tested withdrawal before the cooldown expires.
• Tested early withdrawal penalty calculation.
• Tested penalty-free withdrawal after the cooldown expires.
• Tested penalty routing through the fee mechanism.
• Tested invalid penalty configurations above 10,000 bps.
• Tested checked arithmetic for penalty and withdrawal calculations.
• Verified existing staking and reward behavior remains intact.

Acceptance Criteria

• Unbonding cooldown is enforced before penalty-free withdrawal.
• Pending-unlock timestamps are stored per position.
• Early exits are penalized according to the configured penalty.
• Penalties are routed through the fee mechanism.
• Withdrawals after the cooldown are penalty-free.
• Penalty configurations above 10,000 bps are rejected.
• Withdrawal and penalty edge cases are covered by tests.

Related Issue

Closes #1759

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
insight-arena-4rll	Ready	Preview	Aug 29, 2026 10:54pm