Skip to content

EdwinSotto123/athenea

Repository files navigation

🦉 Athena - AI-Powered Financial Freedom Agent

IQAI Agent Fraxtal ADK-TS

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.

🔗 Live Links

Resource Link
🌐 Live App athenea-nine.vercel.app
🤖 Agent Dashboard IQAI ATP Dashboard
🌐 Landing Page athenea-landing.vercel.app
💜 $ATHENA Token 0xee30b1d751c32cfed78826ed6377927d7ff85892
🌐 Donation Page https://athenea-nine.vercel.app/donate
📜 Agent Contract 0xce4f65d10b16ff7ab32581d3f66d570Sac76d03b4

🎯 The Problem

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

Challenge Reality
💰 Financial Control Abusers control bank accounts, credit cards, and income. Victims have no savings to escape.
📱 Evidence Destruction Photos of injuries, threatening messages, recordings - abusers delete them to eliminate proof.
🏃 No Exit Strategy Without a plan, money, and documentation, leaving becomes nearly impossible.
🔍 Digital Tracking Abusers monitor phones, apps, and browser history. Privacy is non-existent.
😢 Isolation Cut off from family, friends, and support networks. Nowhere to turn.

Statistics speak:

  • 1 in 3 women worldwide experience physical or sexual violence
  • Financial abuse occurs in 99% of domestic violence cases
  • Victims attempt to leave an average of 7 times before succeeding
  • 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 9÷11= 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

1. Freedom Vault (Custodial Wallet)

Feature Description
Auto-creation Wallet generated instantly on registration
AES-256 Encryption Private keys never stored in plain text
Zero Knowledge Required Users just see dollar amounts, not crypto complexity
Hidden Interface Appears as calculator until secret code entered

2. AI Escape Planner

Feature Description
Empathetic Chat Gemini AI trained for crisis support and emotional intelligence
Personalized Plans Based on location, children, risk level, available resources
Legal Resources Country-specific hotlines, shelters, legal aid
Freedom Goal AI calculates exact funds needed for safe escape

3. Evidence Locker

Feature Description
IPFS Storage Permanent, decentralized, censorship-resistant
Blockchain Timestamps Immutable proof of when evidence was captured
Multiple Formats Photos, audio recordings, video, text notes
AI Analysis Automatic categorization and risk assessment

4. Emergency SOS Protocol

Feature Description
One-Button Trigger Hold button for 3 seconds to activate
Instant Fund Transfer All crypto sent to pre-registered trusted contact
Data Wipe Local evidence and wallet data deleted immediately
ATP Logged Emergency creates audit trail for accountability

5. Stealth Mode

Feature Description
Calculator Disguise App looks and works like a calculator
Quick Escape ESC key or screen tap shows news website
No App Icon Can be launched from widget or shortcut only
Encrypted Storage Even if found, data is unreadable without auth

⌨️ Shortcuts & Commands

Shortcut Action
%= Toggle Legend
9÷11= Flash Balance
7 x 7 = Pool Status
1999 = Unlock Vault
0 ÷ 0 = TRIGGER SOS
Triple tap Toggle stealth mode
Hold SOS 3s Activate emergency protocol

🛠️ Tech Stack

Layer Technology Purpose
Frontend React 19, TypeScript, Vite Fast, modern UI
AI Brain Google Gemini 2.5 Flash Reasoning & empathy
Blockchain Fraxtal L2, Ethers.js v6 Fast, cheap transactions
Evidence Storage IPFS via Pinata Permanent, decentralized
User Data Firebase Firestore Real-time sync
Auth Firebase Authentication Secure login
Hosting Vercel + Serverless Functions Global, secure hosting
Agent Standard IQAI ADK-TS Agent logging & transparency

📊 IQAI ATP Integration

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

Event Example Log
User Registration 💜 ¡Luna AB. ha iniciado su camino hacia la libertad!
Plan Completed ✨ ¡Aurora FD. tiene su Freedom Goal! Meta: $2350
Evidence Stored 🔐 Esperanza MZ. aseguró evidencia (AUDIO) en blockchain
SOS Triggered 🆘 EMERGENCIA: Victoria LP. activó el protocolo SOS
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

Layer Protection
API Keys Stored in Vercel environment variables, never exposed to frontend
Wallet Private Keys AES-256 encrypted with user-specific salt before Firestore storage
Evidence Files Hashed on IPFS, only CID stored on blockchain
User Sessions Firebase Auth with secure token refresh
Data in Transit HTTPS everywhere, no plain HTTP endpoints
Data at Rest Firestore encryption + 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.


🤝 How to Help

  1. Donate: Send frxETH or USDC to victim wallets via our donation page
  2. Share: Spread awareness about Athena in your community
  3. Contribute: Help us build new features (PRs welcome!)
  4. Hold $ATHENA: Support the agent's mission

📄 License

MIT License


"Financial freedom is the first step to true freedom."

Built with 💜 for survivors everywhere

About

Athena is a stealth AI disguised as a calculator that helps victims secretly save money, plan safe exits with AI, and securely store evidence on-chain—empowering escape and financial independence through decentralized protection.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors