https://github.com/cheeroo2020/aiva-glow-wallet
AI-powered multi-currency wallet with smart FX recommendations, built as a solo founder journey into the future of finance.
https://github.com/cheeroo2020/aiva-glow-wallet
ai fintech fx gpt multicurrency typescript wallet
Last synced: 2 months ago
JSON representation
AI-powered multi-currency wallet with smart FX recommendations, built as a solo founder journey into the future of finance.
- Host: GitHub
- URL: https://github.com/cheeroo2020/aiva-glow-wallet
- Owner: cheeroo2020
- Created: 2025-07-31T13:39:39.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-10-03T09:52:06.000Z (10 months ago)
- Last Synced: 2026-05-13T13:55:40.275Z (2 months ago)
- Topics: ai, fintech, fx, gpt, multicurrency, typescript, wallet
- Language: TypeScript
- Homepage: https://cheeroo2020.github.io/aiva-glow-wallet/
- Size: 3.69 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# π Aiva Glow Wallet
A next-gen multi-currency wallet with AI-powered smart FX recommendations, live trend analysis, environmental impact tracking, and DeFi-friendly architecture β designed and built by a solo founder to explore the future of money, cross-border finance, and digital wallets.
---
## π Project Vision
Aiva is a build + learn journey to explore how the future of money is being shaped by:
- Smart FX engines
- Real-time trend data
- AI UX logic
- Environmental impact tracking (Green FX)
- Multicurrency interoperability
- Blockchain + DeFi infrastructure
- Compliance & risk intelligence
---
## π§± Folder Structure (Reset on 1 October 2025)
```
βββ ai/ # Smart FX engine & simulations
β βββ fx_trend_analysis.py
β βββ fx_trend_with_threshold.py
β βββ fx_conversion_sim.py # FX simulation with compliance + audit logging
β βββ carbon_estimator.py
β
βββ fx_data/ # Mock FX, balances, transaction, and carbon data
β βββ fxrates.json
β βββ balances.json
β βββ transactions_sample.json
β βββ transactions_log.json # enriched with compliance + carbon
β βββ audit_log.json # structured audit log
β βββ carbon_factors.json
β
βββ lovable_ui/ # UI exported from Lovable (Markdown + assets)
β βββ ai_suggestion_component.md
β βββ compliance_collapsible_panel.md
β βββ Smart Fx.png
β
βββ compliance/ # NEW: compliance-first reset
β βββ kyc_flow.md # KYC/AML notes and flows
β βββ risk_log.json # Risk factors log
β
βββ designs/ # UI concepts
βββ screenshots/ # Output snapshots for tracking
βββ docs/
β βββ Mission.md # Reset vision pillars
β βββ audit_log_schema.md # Schema for audit events
β βββ privacy_compliance.md # Privacy + compliance scaffolding
β βββ governance.md # Governance and regulator engagement notes
β βββ ai_ethics.md # AI safety & ethics documentation
β
βββ tests/ # OCR, compliance, and anchoring test results
β βββ ocr_results.md
β
βββ logbook.md # Daily build journal
βββ README.md # Project overview
```
---
## π§βπ» Sprint 1 Summary (1 Aug β 18 Aug)
| Task ID | Title | Status |
|---------|-------|--------|
| AIVA-4 | Design wallet dashboard in Lovable | β
Done |
| AIVA-5 | Add 3 currency balance blocks | β
Done |
| AIVA-6 | Create FX converter UI | β
Done |
| AIVA-7 | Display static transaction log | β
Done |
| AIVA-9 | Draft Smart FX GPT prompt logic | β
Done |
| AIVA-10 | Create Lovable UI element for AI suggestion | β
Done |
| AIVA-11 | Test FX trend data with GPT-style response | β
Done |
| AIVA-14 | Add FX threshold logic for convert/wait | β
Done |
| AIVA-15 | Simulate FX conversions with mock balances | β
Done |
| AIVA-52 | Add Green FX carbon badge to Smart FX UI | β
Done |
| AIVA-53 | Add Compliance & Risk collapsible panel to UI | β
Done |
---
## π Sprint 2 Summary (15β31 Aug 2025)
| Task ID | Title | Status |
|---------|-------|--------|
| AIVA-17 | Create GitHub repo aiva-wallet | β
Done |
| AIVA-18 | Write README.md with vision and stack | β
Done |
| AIVA-19 | Add mockdata and ai folders in GitHub | β
Done |
**Health:** Sprint 2 completed successfully.
- Repo + README finalized.
- `fx_conversion_sim.py` enhanced with: carbon footprint estimation, compliance stub, and transaction logging.
- CLI runs tested with both small and large trades.
- All deliverables closed on **31 Aug 2025**.
---
## π Sprint 3 Progress (2β22 Sep 2025)
**Status as of 22 September 2025: Compliance enrichment nearing completion**
| Task ID | Title | Status |
|----------|-----------------------------------------------------|---------------|
| AIVA-46 | Compliance Rule Engine (thresholds) | β
Done |
| AIVA-47 | Velocity & Pattern Checks (structuring) | β
Done |
| AIVA-48 | Enrich transaction log with compliance metadata | β³ In Progress|
| AIVA-49 | Audit Logging framework | β
Done |
| AIVA-50 | Privacy & Data Mapping (APP) | β³ In Progress|
| AIVA-51 | AI Ethics Safeguards | β³ In Progress|
| AIVA-52 | Collapsible Compliance Panel UI | β³ In Progress|
| AIVA-53 | Compliance Alerts UI | β³ In Progress|
| AIVA-106 | Implement compliance rule engine (thresholds, velocity, sanctions) | β
Done |
**Highlights Today (22 September 2025):**
- Refined **`ai/fx_conversion_sim.py`** with full compliance logic: threshold checks, velocity detection, and sanctions mock.
- Integrated **audit logging** to `fx_data/audit_log.json` using a standardized writer (`write_audit`) and documented schema (`docs/audit_log_schema.md`).
- CLI test runs: clear (small), review (>10k USD), blocked (>50k USD), and velocity (β₯3 trades in 60s).
- During large tests, insufficient balances triggered overdraft prevention as expected β captured in logbook.
- Logbook updated for **22 Sep 2025**.
---
## π Reset (1 Oct 2025)
- **New 90-day plan launched (OctβDec 2025).**
- Repo restructured with compliance-first focus:
- `/compliance`, `/docs`, `/tests` created.
- Drafted **Mission.md** with 4 core pillars:
1. Borderless multi-currency wallet
2. Compliance-first design
3. Blockchain-anchored statements
4. AI-resistant, auditor-friendly exports
- Logbook updated to mark reset milestone.
---
## π§ Module Progress
1. **Wallet UI (/lovable_ui)**
- β
Dashboard, balances, FX converter, static log.
- β
Smart FX Recommendation with Green FX badge.
- β
Collapsible compliance panel.
- β³ Pending: compliance alerts, timeline transaction view, dark mode toggle.
2. **Smart FX AI Engine (/ai)**
- Fully enriched `fx_conversion_sim.py` with compliance + audit logging.
- Thresholds, velocity, sanctions checks, and carbon estimation integrated.
3. **FX Data Store (/fx_data)**
- `transactions_log.json` β enriched with compliance & carbon.
- `audit_log.json` β standardized audit events (`conversion_attempt`, `conversion_settled`).
4. **Compliance (/compliance)**
- Reset structure added.
- `kyc_flow.md` scaffolded.
- `risk_log.json` scaffolded.
5. **Docs (/docs)**
- `Mission.md` reset pillars defined.
- Privacy, governance, and AI ethics files scaffolded.
6. **Tests (/tests)**
- OCR and compliance test logs to be added (Nov 2025).
---
## π§ Whatβs Next
- Complete reset tasks: fill Mission.md, draft KYC flow, add first risk log.
- Resume Sprint 3 compliance enrichment.
- Begin Sprint 4 in October: FastAPI endpoints (`/convert`, `/balances`, `/transactions`).
- Prototype Cloked Compliance: statement hashing + blockchain anchoring + cloaked exports.
---
## π€ Built By
**Chirantan (Chris) Gogoi**
π Based in Australia
π Exploring the future of money, wallets, AI, and cross-border solutions
πΌ Solo founder in learning & prototyping phase