[Feat]: Recovery (Lost Wallet Token Reassignment)

[sphamjoli]

Component

Smart contracts

Summary

Implement a token recovery mechanism allowing an authorised recovery agent to transfer all tokens from a verified holder’s lost wallet to a new, KYC-verified wallet after proper identity validation.

Scenario:

• Alice holds 1000 RWA tokens but loses access to her wallet.
• Alice completes off-chain identity verification (e.g., government ID, notarised documents).
• Alice creates a new wallet (Alice2) and completes KYC/identity registration.
• The Recovery Agent confirms the claim and executes:
• All 1000 tokens are moved from Alice’s old wallet to the new wallet.
• The old wallet is marked as recovered or optionally frozen to prevent further use.

Proposal

We need to implement the frontend and backend work for this feature, the token already exposes this feature

Acceptance criteria

• Only the Recovery Agent role can perform wallet recovery.
• The new wallet must be KYC-verified and registered before recovery.
• The recovery must emit a RecoverySuccess event.
• System must record the operation for audit and compliance logs.
• Old wallet must be flagged as recovered/frozen to prevent double recovery or malicious reuse.

Context / notes

No response

[github-actions]

Please choose a Component in the issue form (Frontend, Backend, or Smart contracts) so labels can be applied.