Luminara Wallet – Agentic Crypto Wallet

Experimental agentic Web3 wallet connected to a swarm of autonomous AI agents for real-time portfolio monitoring, automated risk alerts, and intelligent transaction analysis across TON and EVM networks.

---

🧭 Problem

Modern crypto portfolios are increasingly complex and fragmented across multiple chains and protocols:

• Passive Dashboards: Existing wallets merely display static token balances and historical charts without offering contextual insights.
• Cognitive Overload: Tracking volatile DeFi liquidity pools, token unlocks, gas fluctuations, and governance proposals manually requires constant vigilance.
• Security Vulnerabilities: Users often sign malicious transactions or blind-sign smart contracts without automated risk inspection.

---

⚡ Solution

Luminara Wallet introduces Agentic Custody Assistance:

• Autonomous Agent Swarm: Specialized background AI agents continuously monitor positions, liquidity pools, and protocol health.
• Smart Transaction Simulation: Evaluates contract calldata before signature to alert users to unusual risks, slippage, or drainage exploits.
• Strict Non-Custodial Architecture: Private keys and seed phrases remain entirely client-side, encrypted on device. AI agents operate purely as read/assist or gated approval co-pilots.

---

✨ Key Features

• Multi-Chain Portfolio Aggregation: Unified visibility across The Open Network (TON) and EVM chains.
• Agent Swarm Intelligence:
  • Risk Sentinel Agent: Flags suspicious contract approvals, malicious airdrops, and liquidation thresholds.
  • Opportunity & Yield Agent: Identifies yield anomalies, protocol updates, and token vesting milestones.
  • Gas & Execution Agent: Suggests optimal execution timing and transaction batching.
• Natural Language Query Interface: Ask questions directly about your holdings (e.g., "What is my current net exposure across TON DeFi pools?").
• Client-Side Cryptography: Zero key custody by agents or third-party servers.

---

🏗️ Architecture & Swarm Design

                     ┌────────────────────────┐
                     │   User Wallet Shell    │
                     │  (Client-side Keys)    │
                     └───────────┬────────────┘
                                 │ Gated Events
                                 ▼
                   ┌────────────────────────────┐
                   │     Agent Swarm Router     │
                   └──────┬───────┬───────┬─────┘
                          │       │       │
       ┌──────────────────┘       │       └──────────────────┐
       ▼                          ▼                          ▼
[ Sentinel Agent ]     [ Yield & Health Agent ]    [ Gas Optimization ]
(Risk & Approvals)      (DeFi Pools & Health)       (MemPool & Timing)

---

🛠️ Tech Stack

• Frontend: React, TypeScript, Vite, Tailwind CSS
• Blockchain: TON SDK / TonWeb (Tact / FunC), EVM / Ethers.js / Viem, Web3Modal
• AI & Agents: LangChain / custom agent router, Groq / local LLM inference engines
• Storage & State: Encrypted IndexedDB / Local Secure Enclave

---

🚀 Quick Start (Run Locally)

1. Clone Repository

git clone https://github.com/LuminaraDigital/Luminara-Wallet.git
cd Luminara-Wallet

2. Configure Environment

cp .env.example .env
# Set your RPC provider endpoints (TON & EVM) and AI inference API keys

3. Install & Run

npm install
npm run dev

---

🔐 Security & Non-Custodial Guarantee

Luminara Wallet operates on the foundational principle that AI agents never hold private keys:

1. Signing operations are strictly isolated and require explicit user hardware or biometric authorization.
2. AI agents receive sanitized public wallet addresses and read-only telemetry.
3. No seed phrase or private key is ever sent to an LLM provider or external inference API.

---

📄 License

Distributed under the GNU Affero General Public License v3.0 (AGPL-3.0). See LICENSE for details.