feat: implement time-locked savings wallet with interest accrual

[Hallab7]

Description

This PR implements a complete time-locked savings wallet system with interest accrual and early withdrawal penalties. Users can create savings accounts with configurable lock periods (1 day to 1 year), earn continuous compound interest, and withdraw funds either after maturity (penalty-free) or early (with a 10% penalty).

What this PR accomplishes:

• Implements savings account creation with configurable lock periods and interest rates
• Adds continuous compound interest calculation with per-second accrual
• Enforces lock periods with early withdrawal penalties (default 10%)
• Provides penalty-free withdrawals after maturity
• Delivers a complete frontend dashboard for savings management
• Includes comprehensive test suite with 17+ test cases

Why it is needed:
Traditional savings accounts lack transparency and user control. This decentralized solution provides full visibility into savings, interest calculations, and withdrawal terms while maintaining blockchain security and immutability.

Key Features:

• Lock periods: 1 day to 1 year
• Interest rates: Configurable APY in basis points
• Early withdrawal penalty: 10% (configurable)
• Real-time interest tracking with auto-refresh
• Gas-optimized for 10,000+ concurrent accounts
• Complete event emission for audit trail

Files Added:

• contracts/src/savings_wallet.rs - Core savings contract
• contracts/src/interest_accrual.rs - Interest calculation service
• contracts/src/tests/savings_tests.rs - Test suite
• contracts/src/savings_standalone_test.rs - Standalone tests
• frontend/src/components/savings/SavingsDashboard.tsx - UI component
• frontend/src/components/savings/index.ts - Module exports
• frontend/src/components/savings/SavingsIntegration.example.tsx - Integration examples

Files Modified:

• contracts/src/lib.rs - Added module declarations
• contracts/src/tests.rs - Added test module inclusion

Total: 9 new files, 2 modified, ~1,713 lines of code

Reference Issues

closes #396

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation Update

Checklist:

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes

[drips-wave]

@Hallab7 Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

[ayomideadeniran]

pr under review, if i find any wrong implementation i will notify you.

[ayomideadeniran]

pr under review, if i find any wrong implementation i will notify you.

[ayomideadeniran]

pr under review, if i find any wrong implementation i will notify you.