Walasi/Moyo_Nokia_api

Moyo Token – Africa Ignite Hackathon Prototype with the real Nokia api integrated. ## Real Nokia API Integration - **SIM Swap** and **Location Verification** are integrated via the official Nokia Network as Code SDK and raw HTTP fallback. - Tested with valid simulator phone numbers (`+3672123456`, `+99999991000`) and returned successful 200 OK responses. - **Number Verification** is documented and integrated in code, but uses a mock fallback due to the OAuth2 mobile consent flow required by the simulator. - Evidence screenshots are in `docs/real-api-test-success.png`. Integration code: `backend/nokia_sdk.py` Test script: `backend/test_sdk.py` >>>>>> 9dc3e12e6d32495d22027bee3eb79b36c47d8674 **Ghost beneficiaries** in government payrolls and aid programs cost African nations billions each year. Without a verified identity anchor, the same person can be registered multiple times and collect payments under different names. In West Africa, the ECOWAS ID card provides a ready‑made biometric identity base that is underutilised in payment systems. Solution - **ECOWAS ID → SIM linkage:** During onboarding, the user's national ID number is bound to their phone number via Nokia’s Number Verification, creating a trusted digital identity. - **One ID, one claim:** Before each disbursement, the backend checks whether that ID has already received a payment in the current cycle. If yes, the transaction is blocked—making double‑dipping impossible. How it works 1. **Onboarding:** User provides ECOWAS ID number + phone number. Nokia Number Verification confirms the SIM belongs to that device. The ID‑SIM pair is stored. 2. **Monthly Claim:** SIM Swap check → Location Verification → Duplicate claim check → Blockchain payment. 3. **Recovery:** If SIM is swapped legitimately, secret word verification restores access without losing the ID linkage. ## User Stories ### Abena – A Smooth Claim Abena, a trader in Accra, has never changed her SIM card. Each month, she enters her phone number (`+233500000001`) and confirms her location. The Nokia APIs instantly verify he …