Athenea: The AI Freedom Shield

🦉 Athena - AI-Powered Financial Freedom Agent

Athena is an autonomous AI agent that helps women in dangerous situations achieve financial independence and escape safely. Built on Fraxtal L2, it combines custodial blockchain wallets, immutable IPFS evidence storage, and an empathetic AI companion that thinks before acting.

🎯 The Problem Every day, thousands of women are trapped in abusive relationships where they face:

a. 💰 Financial Control*Abusers control bank accounts, credit cards, and income. Victims have no savings to escape.

b. 📱 Evidence Destruction*Photos of injuries, threatening messages, and recordings are deleted by abusers to eliminate proof.

c. 🏃 No Exit Strategy*Without a plan, money, or proper documentation, leaving becomes nearly impossible.

d. 🔍 Digital Tracking*Abusers monitor phones, apps, and browser history. Privacy is non-existent.

e. 😢 Isolation*Victims are cut off from family, friends, and support networks, leaving them with nowhere to turn.

📊 Key Statistics a. 1 in 3 women worldwide experience physical or sexual violence. b. Financial abuse occurs in 99% of domestic violence cases. c. Victims attempt to leave an average of 7 times before succeeding. d. The most dangerous time is the 48 hours after leaving.

💡 The Solution: Athena Athena is an AI agent that operates autonomously to protect women. It's not just an app - it's a thinking companion that:

🧠 Thinks Before Acting Unlike simple automation, Athena uses Google Gemini 2.5 Flash to:

Analyze each situation contextually Provide personalized escape recommendations Understand emotional states and respond with empathy Calculate realistic financial freedom goals 🔐 Operates in Total Stealth Calculator Disguise: App appears as a simple calculator. Secret code 1999= reveals true interface Quick Escape: Press ESC or tap screen to instantly hide, showing a news website No Traces: Minimal device footprint, encrypted storage, wipeable data 💼 Manages Crypto Wallets Autonomously Creates custodial wallets automatically on registration Users need zero crypto knowledge - it just works Private keys are AES-256 encrypted and stored off-device Emergency SOS transfers all funds to trusted contact in seconds 📊 Logs Everything Transparently Every action is logged to the IQAI ATP Dashboard with pseudonymized, humanized messages:

💜 ¡Luna AB. ha iniciado su camino hacia la libertad! 🔐 Esperanza MZ. aseguró evidencia (AUDIO) en blockchain 🆘 EMERGENCIA: Victoria LP. activó el protocolo SOS 🏗️ Architecture ┌─────────────────────────────────────────────────────────────────────┐ │ ATHENA AGENT │ ├─────────────────────────────────────────────────────────────────────┤ │ │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────────────┐ │ │ │ 🧠 BRAIN │ │ 💪 MUSCLE │ │ 📊 ATP LOGGING │ │ │ │ Gemini AI │ │ Blockchain │ │ IQAI Dashboard │ │ │ │ 2.5 Flash │───▶│ Fraxtal │───▶│ Humanized Logs │ │ │ │ (Thinks) │ │ + IPFS │ │ (Transparency) │ │ │ └──────────────┘ └──────────────┘ └──────────────────────┘ │ │ │ │ │ │ │ ▼ ▼ ▼ │ │ ┌──────────────────────────────────────────────────────────────┐ │ │ │ SECURE API ROUTES │ │ │ │ /api/gemini │ /api/ipfs │ /api/atp-log │ /api/wallet │ │ │ └──────────────────────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────┘

�️ How Athena Prevents Fraud & Misuse A critical concern for any donation-based system is preventing fraud. Athena implements multiple layers of protection:

1. AI-Powered Verification The Gemini AI analyzes evidence before storing: Examines photo metadata for authenticity Assesses audio for signs of distress Cross-references user stories for consistency Flags suspicious patterns for review

2. Blockchain Transparency Every transaction is recorded on Fraxtal L2: All wallet addresses are public and auditable Fund movements can be traced by anyone Donation-to-victim flow is transparent Smart contract ensures proper fund allocation

3. ATP Logging (Agent Transparency Protocol) All agent actions are logged to IQAI Dashboard: Actions are timestamped and immutable Pseudonymized for privacy but verifiable Community can audit agent behavior Anomalies trigger automatic alerts

4. Evidence Immutability Evidence is stored on IPFS with blockchain timestamps: Once uploaded, evidence cannot be modified CID (Content ID) is recorded on-chain Court-admissible with cryptographic proof Prevents both deletion AND fabrication

🔐 Key Features 🛠️ Solution Overview

1. Freedom Vault (Custodial Wallet) a. Auto-creation Wallet generated instantly upon registration. b. AES-256 Encryption Private keys are never stored in plain text. c. Zero Knowledge Required Users see only dollar amounts, no crypto complexity. d. Hidden Interface App appears as a calculator until a secret code is entered.

2. AI Escape Planner a. Empathetic Chat Gemini AI trained for crisis support and emotional intelligence. b. Personalized Plans Plans based on location, children, risk level, and available resources. c. Legal Resources Country-specific hotlines, shelters, and legal aid. d. Freedom Goal AI calculates the exact funds needed for a safe escape.

3. Evidence Locker a. IPFS Storage Permanent, decentralized, and censorship-resistant storage. b. Blockchain Timestamps Immutable proof of when evidence was captured. c. Multiple Formats Supports photos, audio recordings, videos, and text notes. d. AI Analysis Automatic categorization and risk assessment.

4. Emergency SOS Protocol a. One-Button Trigger Hold the button for 3 seconds to activate. b. Instant Fund Transfer All crypto is sent to a pre-registered trusted contact. c. Data Wipe Local evidence and wallet data are deleted immediately. d. ATP Logged Emergency events create an audit trail for accountability.

5. Stealth Mode a. Disguised Application App behaves like a harmless utility application. b. Silent Notifications No visible alerts or suspicious messages. c. Secure Access Pattern Access granted only through predefined gestures or codes.

⌨️ Shortcuts & Commands a. % — Toggle Legend Shows or hides the shortcut legend. b. 9 ÷ 11 — Flash Balance Quickly displays the current balance. c. 7 × 7 — Pool Status Checks the status of the shared fund pool. d. 1999 — Unlock Vault Unlocks the Freedom Vault. e. 0 ÷ 0 — TRIGGER SOS Immediately triggers the SOS protocol. f. Triple Tap — Toggle Stealth Mode Enables or disables stealth mode. g. Hold SOS (3s) — Activate Emergency Protocol Fully activates the emergency response sequence.

🛠️ Tech Stack a. Frontend React 19, TypeScript, Vite Fast, modern user interface. b. AI Brain Google Gemini 2.5 Flash Advanced reasoning with empathetic responses. c. Blockchain Fraxtal L2, Ethers.js v6 Fast and low-cost transactions. d. Evidence Storage IPFS via Pinata Permanent and decentralized storage. e. User Data Firebase Firestore Real-time data synchronization. f. Authentication Firebase Authentication Secure user login. g. Hosting Vercel + Serverless Functions Global, scalable, and secure hosting. h. Agent Standard IQAI ADK-TS Agent logging, transparency, and compliance.

📊 IQAI ATP Integration Athena logs all critical actions to the IQAI ATP Dashboard using humanized, Spanish-language messages:

a. User Registration 💜 ¡Luna AB. ha iniciado su camino hacia la libertad! b. Plan Completed ✨ ¡Aurora FD. tiene su Freedom Goal! Meta: $2350 c. Evidence Stored 🔐 Esperanza MZ. aseguró evidencia (AUDIO) en blockchain d. SOS Triggered 🆘 EMERGENCIA: Victoria LP. activó el protocolo SOS e. Donation Received 💜 ¡Donación de $50.00 recibida! Gracias, ángeles donadores

Privacy: All logs use pseudonyms (Luna, Aurora, Esperanza, etc.) - never real names. Names are randomly assigned and not linked to user identity.

🔒 Security Architecture a. API Keys Stored securely in Vercel environment variables, never exposed to the frontend. b. Wallet Private Keys Encrypted using AES-256 with a user-specific salt before being stored in Firestore. c. Evidence Files Hashed and stored on IPFS; only the CID is recorded on the blockchain. d. User Sessions Managed through Firebase Authentication with secure token refresh mechanisms. e. Data in Transit Protected via HTTPS everywhere, with no plain HTTP endpoints. f. Data at Rest Secured using Firestore native encryption plus additional client-side encryption.

🗺️ Roadmap ✅ Completed Custodial wallet creation on registration Evidence upload to IPFS with blockchain timestamping AI escape planning with Gemini 2.5 Flash Emergency SOS with real blockchain transfers IQAI ATP Dashboard integration Secure API routes (no exposed keys) Stealth calculator mode Public donation page

🔜 Coming Soon Multi-language support (English, Portuguese) Mobile app (React Native) Integration with shelter networks Legal document generation Video call with counselors

💜 Impact Athena represents a new paradigm in protection technology.

By combining:

AI empathy that understands context Blockchain security that cannot be compromised Stealth design that protects users Transparent logging that prevents abuse We provide women with the tools they need to escape dangerous situations safely and with financial independence.

Built With

• ethers.js-v6
• firebase-authentication
• firebase-firestore
• fraxtal-l2
• google-gemini-2.5-flash
• ipfs-(pinata)
• iqai
• react
• typescript
• vercel-serverless-functions
• vite