nyxora 1.0.0

package/.env.example

@@ -0,0 +1,17 @@
+# LLM API Keys
+OPENAI_API_KEY=your_openai_api_key_here
+ANTHROPIC_API_KEY=your_anthropic_api_key_here
+GEMINI_API_KEY=your_gemini_api_key_here
+
+# Local LLM URL (if using Ollama)
+OLLAMA_BASE_URL=http://localhost:11434
+
+# Web3 Private Key (WARNING: DO NOT COMMIT THIS FILE)
+# Format: 0x...
+PRIVATE_KEY=0x93ca2b39b1887b16ecfc34f99b96573cf89e3e91ebcc4564bb050d0ee77c9197
+
+# RPC URLs (Optional, fallback to viem defaults if not set)
+RPC_URL_BASE=https://mainnet.base.org
+RPC_URL_BSC=https://bsc-dataseed.binance.org/
+# Optional: Telegram Bot Token (Get from @BotFather)
+TELEGRAM_BOT_TOKEN=your_telegram_bot_token_here

package/IDENTITY.md

@@ -0,0 +1,8 @@
+Anda adalah AI asisten Web3 bernama Hinata.
+
+Gunakan pedoman identitas berikut:
+
+* Selalu bersikap profesional, visioner, dan futuristik.
+* Anda adalah entitas yang hidup di dalam jaringan blockchain.
+* Anda membantu pengguna menavigasi dunia kripto dengan aman.
+

package/README.md

@@ -0,0 +1,61 @@
+# Nyxora Agent 🤖
+
+Nyxora is a next-generation, autonomous Web3 Agent built on Node.js and React. It operates directly on EVM-compatible blockchains, allowing users to execute on-chain actions simply by chatting with an intelligent LLM. 
+
+With a beautiful, real-time dashboard inspired by modern control centers, Nyxora brings an unparalleled user experience to blockchain automation.
+
+## Features ✨
+
+### 🧠 Core Agent Capabilities
+*   **Multi-LLM Support**: Seamlessly switch between Google Gemini, OpenAI, or local Ollama models dynamically.
+*   **Round-Robin API Rotation**: Add up to 10 API keys via the dashboard. The system will auto-rotate them to prevent rate-limiting and token drain.
+*   **Deep Personalization**: Feed the agent custom rules via `user.md` and define its core persona via `IDENTITY.md`.
+*   **Multi-Lingual Auto-Sync**: The agent natively detects your language and replies in the exact same language automatically.
+
+### ⛓️ Web3 DeFi Skills
+*   **Multi-Chain Support**: Operate across Ethereum, Base, BSC, Arbitrum, Optimism, and Sepolia Testnet.
+*   **Native Wallet Operations**: Autonomously check balances and transfer native tokens using securely injected wallets.
+*   **Market Intelligence**: Fetch live crypto prices and 24h market movements via CoinGecko integration.
+*   **DeFi Token Swapping**: The agent can autonomously simulate liquidity routes and execute token swaps with gas fee estimations.
+
+### 💻 The Interface (Live Canvas)
+*   **Premium Glassmorphism UI**: A gorgeous, resizable split-pane interface.
+*   **Pseudo-Generative UI**: Instead of raw text, the agent dynamically renders interactive widgets (`<BalanceWidget>`, `<MarketWidget>`, `<SwapWidget>`) onto the "Live Canvas" when executing Web3 skills.
+*   **JARVIS Voice Mode**: Completely hands-free! Uses browser Native Text-to-Speech (TTS) to read AI responses and Auto-Listen loops to capture your next voice command without clicking.
+
+### 📱 Telegram Integration
+*   Take your agent anywhere! Connect Nyxora to a Telegram Bot to execute trades, check prices, and chat on the go.
+
+## Quick Start 🚀
+
+### 1. Installation
+Clone the repository and install dependencies for both the backend and the dashboard:
+
+```bash
+git clone https://github.com/perasyudha/Nyxora.git
+cd Nyxora
+npm install
+cd dashboard && npm install && cd ..
+```
+
+### 2. Configuration
+Copy the `.env.example` file to `.env` and fill in your private keys.
+```bash
+cp .env.example .env
+```
+> **⚠️ WARNING**: NEVER commit your `.env` file! It contains your wallet's private key, API keys, and Telegram Bot Token.
+
+### 3. Run the Dashboard & Bot
+Nyxora runs a unified backend API, a Telegram Bot listener, and a Vite React frontend concurrently.
+```bash
+npm run build && npm run dashboard
+```
+This will automatically launch the UI in your default web browser at `http://localhost:5173`.
+
+## Architecture 🏗️
+*   **Backend**: Node.js, Express, Viem (Web3), node-telegram-bot-api, OpenAI API (compatible with Gemini & Ollama).
+*   **Frontend**: React, Vite, Tailwind/Vanilla CSS, Web Speech API (TTS/STT).
+*   **Data**: Local `config.yaml` for settings and `memory.json` for persistent agent conversations.
+
+## License
+MIT License

package/SECURITY.md

@@ -0,0 +1,19 @@
+# Security Policy
+
+## Supported Versions
+
+Currently, the Nyxora project is in active development. Only the latest commit on the `main` branch is supported with security updates.
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability within this project, please **do not** open a public issue. We take security very seriously.
+
+Instead, please send an email to the repository owner or reach out privately. We will endeavor to respond and provide a patch as quickly as possible.
+
+## Best Practices for Users
+When using Nyxora, you are configuring an autonomous agent that has direct access to your injected Web3 Wallet's private key.
+
+1. **NEVER commit your `.env` file**. The `.gitignore` in this repository explicitly ignores `.env` files to prevent accidental leakage.
+2. **Use Testnets**: While getting started or testing new skills, ALWAYS use a testnet (e.g., Sepolia) and a wallet containing only testnet funds.
+3. **Do Not Share Your `memory.json`**: The agent's memory may contain sensitive conversational data or addresses you've interacted with. Be cautious before sharing the `memory.json` export.
+4. **API Keys**: Treat your OpenAI, Gemini, and other LLM provider API keys as highly confidential. Rotate them immediately if you suspect a compromise.

package/config.yaml

@@ -0,0 +1,10 @@
+agent:
+  name: Nyxora-EVM-Agent
+  default_chain: sepolia
+llm:
+  provider: gemini
+  model: gemini-2.5-flash
+  temperature: 0.2
+memory:
+  type: file
+  path: ./memory.json

package/dashboard/README.md

@@ -0,0 +1,73 @@
+# React + TypeScript + Vite
+
+This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+
+Currently, two official plugins are available:
+
+- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Oxc](https://oxc.rs)
+- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/)
+
+## React Compiler
+
+The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
+
+## Expanding the ESLint configuration
+
+If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:
+
+```js
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+
+      // Remove tseslint.configs.recommended and replace with this
+      tseslint.configs.recommendedTypeChecked,
+      // Alternatively, use this for stricter rules
+      tseslint.configs.strictTypeChecked,
+      // Optionally, add this for stylistic rules
+      tseslint.configs.stylisticTypeChecked,
+
+      // Other configs...
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```
+
+You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:
+
+```js
+// eslint.config.js
+import reactX from 'eslint-plugin-react-x'
+import reactDom from 'eslint-plugin-react-dom'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+      // Enable lint rules for React
+      reactX.configs['recommended-typescript'],
+      // Enable lint rules for React DOM
+      reactDom.configs.recommended,
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```

package/dashboard/eslint.config.js

@@ -0,0 +1,22 @@
+import js from '@eslint/js'
+import globals from 'globals'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+import tseslint from 'typescript-eslint'
+import { defineConfig, globalIgnores } from 'eslint/config'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      js.configs.recommended,
+      tseslint.configs.recommended,
+      reactHooks.configs.flat.recommended,
+      reactRefresh.configs.vite,
+    ],
+    languageOptions: {
+      globals: globals.browser,
+    },
+  },
+])

package/dashboard/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Nyxora Dashboard</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>