Enhance staking module with Move integration and improved data structures

- Refactor staking constants to align with Move specifications.
- Introduce EnhancedStakedNode and StakingPoolManager for better state management.
- Implement enhanced staking and unstaking functions with Move-aligned validation.
- Update reward distribution logic to support Move-based calculations.
- Enhance storage functions for improved state persistence.
- Add new utility functions for penalty calculation and validator management.
- Ensure thread-safe access to staking data with updated locking mechanisms.

Author: jamesatomc

crates/rpc/rpc-api/1.Blockchain.md

@@ -122,10 +122,10 @@ curl -X POST -H "Content-Type: application/json" -d '{
 }' http://192.168.1.103:30030
 ```
 
-## 10. Staking Operations
+## 10. Enhanced Staking Operations
 
-### 10.1 Stake Tokens
-Stake KARI tokens to run a node or become a validator:
+### 10.1 Stake Tokens (Enhanced with Move Integration)
+Stake KARI tokens to run a node or become a validator with Move smart contract integration:
 ```bash
 curl -X POST -H "Content-Type: application/json" -d '{
   "jsonrpc": "2.0",
@@ -134,36 +134,56 @@ curl -X POST -H "Content-Type: application/json" -d '{
     "address": "YOUR_ACCOUNT_ADDRESS",
     "amount": 200.0,
     "password": "WALLET_PASSWORD",
-    "validator": true
+    "validator": true,
+    "use_move_integration": true
   },
   "id": 1
 }' http://192.168.1.103:30030
 ```
 
-- Minimum amount for running a node: 200 KARI
-- Minimum amount for becoming a validator: 32 KARI
-- Setting `validator` to `true` will make the node eligible for staking rewards (0.01%)
-- All staked tokens have a 24-hour lock period
-
-### 10.2 Unstake Tokens
-Withdraw your staked KARI tokens (plus rewards if a validator):
+**Enhanced Staking Requirements:**
+- Minimum amount for running a node: **200 KARI** (200,000,000,000 KA)
+- Minimum amount for becoming a validator: **32 KARI** (32,000,000,000 KA)
+- Setting `validator` to `true` enables validator rewards with 5% default commission
+- All staked tokens have a **24-hour lock period**
+- Move integration provides enhanced security and smart contract functionality
+- Validators earn **0.01% annual rewards** distributed proportionally based on stake
+
+**Response includes:**
+- `commission_rate`: Validator commission rate (500 basis points = 5%)
+- `move_object_id`: Move smart contract object ID (if Move integration enabled)
+- `security_hash`: Cryptographic security hash for the staking position
+- `delegated_stake`: Amount delegated to this validator
+- `penalty_rate`: Early unstaking penalty rate (10%)
+
+### 10.2 Enhanced Unstake Tokens
+Withdraw your staked KARI tokens with enhanced penalty calculation:
 ```bash
 curl -X POST -H "Content-Type: application/json" -d '{
   "jsonrpc": "2.0",
   "method": "unstake_tokens",
   "params": {
     "address": "YOUR_ACCOUNT_ADDRESS",
-    "password": "WALLET_PASSWORD"
+    "password": "WALLET_PASSWORD",
+    "force": false
   },
   "id": 1
 }' http://192.168.1.103:30030
 ```
 
-- Early unstaking (before lock period ends) will incur a 10% penalty
-- Validators will receive accumulated rewards when unstaking
+**Enhanced Unstaking Features:**
+- `force` parameter allows early unstaking with 10% penalty (1000 basis points)
+- Normal unstaking after 24-hour lock period has no penalty
+- Validators receive accumulated rewards when unstaking
+- Early unstaking penalty is calculated using Move-aligned formula: `(amount * 1000) / 10000`
 
-### 10.3 Get Staking Info
-Check your staking status and rewards:
+**Response includes:**
+- `penalty`: Penalty amount if unstaking early (0 if after lock period)
+- `force_unstake`: Whether force unstaking was used
+- Detailed breakdown of withdrawn amount, rewards, and penalties
+
+### 10.3 Enhanced Staking Info
+Check your staking status with comprehensive details:
 ```bash
 curl -X POST -H "Content-Type: application/json" -d '{
   "jsonrpc": "2.0",
@@ -173,8 +193,17 @@ curl -X POST -H "Content-Type: application/json" -d '{
 }' http://192.168.1.103:30030
 ```
 
-### 10.4 Get Staking Statistics
-Get network-wide staking information:
+**Enhanced Response includes:**
+- `commission_rate`: Current validator commission rate
+- `delegated_stake`: Amount delegated to this validator
+- `move_object_id`: Move smart contract object ID
+- `security_hash`: Position security hash
+- `estimated_daily_reward`: Estimated daily rewards for validators
+- `lock_period_remaining_hours`: Hours remaining in lock period
+- `early_unstake_penalty`: Calculated penalty for early unstaking
+
+### 10.4 Enhanced Staking Statistics
+Get comprehensive network-wide staking information:
 ```bash
 curl -X POST -H "Content-Type: application/json" -d '{
   "jsonrpc": "2.0",
@@ -184,6 +213,29 @@ curl -X POST -H "Content-Type: application/json" -d '{
 }' http://192.168.1.103:30030
 ```
 
+**Enhanced Statistics include:**
+- **Pool State**: Total staked, validator/node counts, reward rate, last reward epoch
+- **Validator Details**: Complete validator list with stake amounts, commission rates, active status
+- **Requirements**: Move-aligned minimum stake requirements
+- **Parameters**: Lock period (24 hours), penalty rate (10%), reward rate (0.01% annual)
+- **Move Integration**: Current Move integration status
+
+### 10.5 Claim Rewards (New)
+Check claimable rewards for your staking position:
+```bash
+curl -X POST -H "Content-Type: application/json" -d '{
+  "jsonrpc": "2.0",
+  "method": "claim_rewards",
+  "params": ["YOUR_ACCOUNT_ADDRESS"],
+  "id": 1
+}' http://192.168.1.103:30030
+```
+
+**Features:**
+- Check accumulated rewards without claiming
+- Indicates if rewards are available for claiming
+- Provides formatted reward amounts in both KA and KARI units
+
 ## Placeholders
 Replace these placeholders with actual values when making requests:
 - `YOUR_ACCOUNT_ADDRESS`: Your wallet address
@@ -237,16 +289,43 @@ Gas fees range from a minimum of 0.000000002 KARI to a maximum of 0.000000050 KA
 
 To prioritize your transaction, you can add the optional `priority_boost` parameter when making transfers.
 
-## Staking System
-
-The Kanari network uses a Proof of Stake (PoS) consensus mechanism where:
-
-- Users must stake at least 200 KARI to run a node
-- Validators must stake at least 32 KARI and opt in to validation
-- Validators receive a 0.01% annual reward on their staked amount
-- Rewards are drawn from the token pool at address: `0x47621776628ba3a5b9baaab38e61f4c98e893e124204bc4dad52e702e2b24ea1`
-- All staked tokens have a 24-hour lock period
-- Early unstaking incurs a 10% penalty
+## Enhanced Staking System
+
+The Kanari network uses an enhanced Proof of Stake (PoS) consensus mechanism with Move smart contract integration:
+
+### Core Features:
+- **Move Integration**: Enhanced security through Move smart contract validation
+- **Dual Staking Tiers**: Node operators (200 KARI minimum) and Validators (32 KARI minimum)
+- **Proportional Rewards**: Validators earn 0.01% annual rewards based on their stake
+- **Commission System**: Validators earn 5% commission on delegated stakes
+- **Security**: Each staking position has a unique cryptographic security hash
+
+### Economic Parameters:
+- **Minimum Node Stake**: 200 KARI (200,000,000,000 KA)
+- **Minimum Validator Stake**: 32 KARI (32,000,000,000 KA)
+- **Lock Period**: 24 hours (86,400,000 milliseconds)
+- **Early Unstake Penalty**: 10% (1000 basis points)
+- **Validator Commission**: 5% (500 basis points)
+- **Annual Reward Rate**: 0.01% (1 basis point)
+
+### Reward Distribution:
+- Rewards are distributed daily (epoch-based)
+- Validators receive rewards proportional to their stake
+- Commission is deducted for delegated stakes
+- Rewards are drawn from the pool at: `0x47621776628ba3a5b9baaab38e61f4c98e893e124204bc4dad52e702e2b24ea1`
+
+### Move Smart Contract Benefits:
+- Enhanced transaction validation
+- Immutable staking rules
+- Automated penalty calculation
+- Transparent reward distribution
+- Cross-chain compatibility
+
+### Validator Requirements:
+- Minimum 32 KARI stake
+- 24-hour commitment period
+- Network participation requirements
+- Commission rate disclosure (default 5%)
 
 ## Security Note
 

crates/rpc/rpc-api/src/lib.rs

@@ -10,7 +10,7 @@ mod get_block;
 mod accounts;
 mod move_api; // Add the new module
 
-use stake::{get_staking_info, get_staking_stats, stake_tokens, unstake_tokens};
+use stake::{get_staking_info, get_staking_stats, stake_tokens, unstake_tokens, claim_rewards};
 use get_block::{
     get_all_blocks, 
     get_account_details, 
@@ -134,6 +134,11 @@ pub async fn start_rpc_server(network_config: NetworkConfig) -> Result<(), tokio
         futures::future::ready(get_staking_stats(params)).boxed()
     });
 
+    // Add enhanced staking operations
+    io.add_method("claim_rewards", |params| {
+        futures::future::ready(claim_rewards(params)).boxed()
+    });
+
     // Add Move VM operations
     io.add_method("list_modules", |params| {
         futures::future::ready(list_modules(params)).boxed()