nyxora 1.4.0 → 1.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +51 -75
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,94 +1,70 @@
1
1
  # Nyxora Agent 🤖
2
2
 
3
- 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.
3
+ Nyxora adalah Agen Web3 otonom generasi berikutnya yang dibangun menggunakan Node.js dan React. Agen ini beroperasi secara langsung pada jaringan blockchain yang kompatibel dengan EVM (Ethereum, Arbitrum, Base, BSC, Optimism, dll.), memungkinkan Anda untuk mengeksekusi operasi on-chain hanya dengan mengobrol bersama AI.
4
4
 
5
- With a beautiful, real-time dashboard inspired by modern control centers, Nyxora brings an unparalleled user experience to blockchain automation.
5
+ Dilengkapi dengan antarmuka dasbor *Glassmorphism* yang menawan dan integrasi Telegram, Nyxora membawa pengalaman otomatisasi Web3 ke tingkat selanjutnya.
6
6
 
7
- ## Features ✨
7
+ ---
8
8
 
9
- ### 🧠 Core Agent Capabilities
10
- * **Multi-LLM Support**: Seamlessly switch between Google Gemini, OpenAI, OpenRouter (unlimited models!), or local Ollama models dynamically.
11
- * **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.
12
- * **Deep Personalization**: Feed the agent custom rules via `user.md` and define its core persona via `IDENTITY.md`.
13
- * **Multi-Lingual Auto-Sync**: The agent natively detects your language and replies in the exact same language automatically.
9
+ ## Kemampuan & Fitur (Skills)
14
10
 
15
- ### 🛡️ Production-Ready Security (NEW in v1.0.10)
16
- * **Encrypted Local Keystore**: No more `.env` leaks. Your Private Key is encrypted using `AES-256-GCM` and locked behind a custom **Master Password**.
17
- * **Human-in-the-Loop Sandboxing**: The agent CANNOT execute transactions on its own. All transactions (Transfers & Swaps) are queued in a **Transaction Manager** and require explicit 1-click Approval from you.
18
- * **Omnichannel Approvals**: Approve or reject pending transactions directly from the Web Dashboard's UI or via Telegram Inline Keyboard buttons on the go!
19
- * **Strict API Auth**: The local Express server is protected via ephemeral Session Tokens (`x-nyxora-token`) and Strict CORS, preventing unauthorized local API requests.
11
+ Agen ini memiliki berbagai *skills* bawaan yang memungkinkannya berinteraksi dengan blockchain maupun sistem operasi lokal Anda.
20
12
 
21
- ### ⛓️ Web3 DeFi Skills (Pro-Trader AI)
22
- * **Multi-Chain Support**: Operate across Ethereum, Base, BSC, Arbitrum, Optimism, and Sepolia Testnet.
23
- * **Wallet Generation**: Instruct the AI to generate new EVM wallets on the fly securely (Keys are never saved).
24
- * **Native Wallet Operations**: Autonomously check balances and transfer native tokens using securely injected wallets.
25
- * **Advanced Market Intelligence**: Fetch live crypto prices, 24h market movements, FDV, and liquidity via CoinGecko and DexScreener integrations.
26
- * **Anti-Rugpull & Security Scanner**: Nyxora can scan smart contracts via GoPlus Labs to detect Honeypots, Hidden Taxes, and malicious proxy upgrades before you buy.
27
- * **PNL & Portfolio Tracking**: The AI scans your wallets and multiplies balances by live DEX prices to give you real-time Net Worth estimations.
28
- * **DeFi Token Swapping & Bridging**: The agent can autonomously simulate liquidity routes and execute token swaps or cross-chain bridges with gas fee estimations.
29
- * **Automated Limit Orders (Take-Profit/Cut-Loss)**: Set rules (e.g., "Sell my PEPE if price drops below $0.001"). Nyxora runs a background cron monitor and automatically executes the swap while you sleep without requiring manual approval!
13
+ ### 1. Manajemen Wallet & Saldo
14
+ Nyxora dibekali dengan dompet (wallet) bawaan yang terenkripsi aman secara lokal.
15
+ * **Generate Wallet:** Anda dapat memerintahkan AI untuk membuat dompet EVM baru secara instan.
16
+ * **Cek Saldo & Portofolio:** Memeriksa saldo koin native (ETH, BNB, MATIC) atau token ERC-20, serta menghitung total kekayaan (Net Worth) secara real-time.
30
17
 
31
- ### 💻 The Interface (Live Canvas)
32
- * **Premium Glassmorphism UI**: A gorgeous, resizable split-pane interface.
33
- * **Pseudo-Generative UI**: Instead of raw text, the agent dynamically renders interactive widgets (`<BalanceWidget>`, `<MarketWidget>`, `<SwapWidget>`) onto the "Live Canvas" when executing Web3 skills.
34
- * **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.
18
+ ### 2. Kirim Koin / Token (Transfer)
19
+ Mengirim koin native atau token ERC-20 ke alamat lain secara otonom.
35
20
 
36
- ### 📱 Telegram Integration
37
- * Take your agent anywhere! Connect Nyxora to a Telegram Bot to execute trades, check prices, and chat on the go.
21
+ ### 3. Swap & Bridge Lintas Jaringan
22
+ * **Swap Token:** Menukar token di jaringan yang sama dengan simulasi rute likuiditas dan estimasi gas.
23
+ * **Bridge Lintas Jaringan:** Mengirim dan menukar token dari satu jaringan ke jaringan lainnya (misal: Arbitrum ke Base).
38
24
 
39
- ## Quick Start 🚀 (Global Install)
25
+ ### 4. Limit Order Otomatis (Take-Profit/Cut-Loss)
26
+ Anda dapat menetapkan aturan khusus dalam bahasa natural (misal: *"Jual PEPE saya jika harga turun di bawah $0.001"*). Nyxora akan menjalankan pemantauan (cron monitor) di latar belakang dan mengeksekusi *swap* secara otomatis saat Anda tidur!
40
27
 
41
- Nyxora is now available on NPM! You can install it as a global CLI tool on your operating system.
28
+ ### 5. Analisis Market & Keamanan (Anti-Rugpull)
29
+ * **Market Intelligence:** Mengambil harga kripto secara live, pergerakan pasar 24 jam, dan likuiditas (terintegrasi dengan CoinGecko & DexScreener).
30
+ * **Security Scanner (GoPlus Labs):** Agen dapat memindai *smart contract* untuk mendeteksi Honeypot, pajak tersembunyi (Hidden Taxes), dan proksi berbahaya sebelum Anda membeli token.
42
31
 
43
- ### 1. Installation
44
- Open your terminal (Command Prompt, PowerShell, or Linux Terminal) and run:
32
+ ### 6. Otomatisasi Sistem & Plugin (NEW v1.4.1)
33
+ Nyxora kini memiliki kemampuan akses OS tingkat lanjut (layaknya OpenClaw):
34
+ * **Full OS Access:** Mampu membaca/menulis *file* lokal, mengeksekusi perintah terminal (Shell/PowerShell), dan melakukan *browsing* web secara natif.
35
+ * **Plugin Manager:** Muat *skill* pihak ketiga secara dinamis. Cukup berikan URL GitHub Gist, dan Nyxora akan mengunduh serta menginstalnya secara otomatis ke dalam direktori `external_skills`.
36
+
37
+ ---
38
+
39
+ ## Panduan Perilaku Agent & Keamanan
40
+
41
+ Nyxora dirancang dengan protokol keamanan tingkat tinggi dan personalisasi mendalam:
42
+
43
+ 1. **Personalisasi (Prompt Tambahan):** Perilaku AI dapat diatur sepenuhnya dengan mengedit *file* `IDENTITY.md` dan `user.md`. Agen akan mendeteksi bahasa Anda secara otomatis dan membalas dengan bahasa yang sama.
44
+ 2. **Keamanan Otonom (NLP Security Policy):** Anda dapat memberikan batasan keamanan menggunakan bahasa natural (misal: *"Jangan pernah mengakses partisi E"* atau *"Jangan instal aplikasi global"*). Aturan ini disimpan di `security_policy.md` dan Nyxora akan dengan patuh menolaknya jika ada instruksi yang melanggar.
45
+ 3. **Human-in-the-Loop Sandboxing:** Agen **TIDAK AKAN PERNAH** mengeksekusi transaksi finansial (Transfer/Swap) secara sepihak. Semua transaksi akan masuk ke **Transaction Manager** dan menunggu persetujuan (*Approve/Reject*) 1-klik dari Anda via Web Dashboard atau tombol Telegram.
46
+ 4. **Keamanan Keystore:** Private Key Anda dienkripsi menggunakan `AES-256-GCM` dan dikunci oleh Master Password Anda sendiri. Tidak ada data sensitif yang bocor ke file `.env`.
47
+
48
+ ---
49
+
50
+ ## Cara Instalasi & Penggunaan 🚀
51
+
52
+ Nyxora tersedia di NPM dan dapat diinstal secara global di sistem operasi Anda.
53
+
54
+ ### 1. Instalasi Global
55
+ Buka terminal Anda (Command Prompt, PowerShell, atau Linux Terminal) dan jalankan:
45
56
  ```bash
46
57
  npm install -g nyxora
47
58
  ```
48
59
 
49
- ### 2. Launching Nyxora
50
- No need to navigate to any specific folder! Just type:
60
+ ### 2. Menjalankan Nyxora
61
+ Cukup ketik perintah berikut di mana saja:
51
62
  ```bash
52
63
  nyxora
53
64
  ```
54
- On first launch, Nyxora will greet you with an **Interactive Setup Wizard**. This CLI wizard will guide you to securely configure your LLM providers, API keys, and Web3 Wallet.
55
-
56
- Nyxora will automatically:
57
- 1. Initialize a secure vault in your `~/.nyxora/` directory.
58
- 2. Store your Wallet Private Key securely in an encrypted `~/.nyxora/keystore.json` locked by your Master Password.
59
- 3. Store operational data (API Keys, RPCs) in `~/.nyxora/config.yaml`.
60
- 4. Start the local server, generate a secure Session Token, and open the Web Dashboard automatically!
61
-
62
- > 💡 **Tip:** You can invoke the setup wizard at any time to update your keys by running `nyxora setup`.
63
-
64
- ### 3. Configuration
65
- When the dashboard opens, you can modify any operational parameters in the **Settings** tab. The dashboard allows you to type custom model names, switch RPCs, and rotate your API keys effortlessly.
66
-
67
- ## Local Development (For Contributors) 🏗️
68
-
69
- If you want to modify Nyxora's code, build new skills, or contribute:
70
-
71
- 1. Clone the repo:
72
- ```bash
73
- git clone https://github.com/perasyudha/Nyxora.git
74
- cd Nyxora
75
- ```
76
- 2. Install dependencies:
77
- ```bash
78
- npm install
79
- cd dashboard && npm install && cd ..
80
- ```
81
- 3. Run the development build:
82
- ```bash
83
- npm run build && npm run start
84
- ```
85
-
86
- *To deploy your own branch to NPM, bump the version and run `npm run deploy`!*
87
-
88
- ## Architecture
89
- * **Backend**: Node.js, Express, Viem (Web3), node-telegram-bot-api, OpenAI API.
90
- * **Frontend**: React, Vite, Vanilla CSS, Web Speech API (TTS/STT).
91
- * **Data**: Local `~/.nyxora/config.yaml` and `~/.nyxora/memory.json`.
92
-
93
- ## License
94
- MIT License
65
+ Pada peluncuran pertama, Nyxora akan menyapa Anda dengan **Interactive Setup Wizard** yang akan memandu Anda untuk mengatur konfigurasi LLM (OpenAI, Gemini, Ollama, OpenRouter), API Keys, dan Master Password Wallet.
66
+
67
+ > 💡 **Tips:** Anda dapat memanggil wizard pengaturan kapan saja untuk memperbarui kunci Anda dengan menjalankan perintah `nyxora setup`.
68
+
69
+ ### 3. Dasbor Web & Interaksi
70
+ Setelah peladen (*server*) berjalan, Dasbor Web akan terbuka secara otomatis di *browser* Anda. Anda dapat berinteraksi langsung melalui antarmuka *Glassmorphism* Premium atau menghubungkannya ke Bot Telegram untuk akses dari mana saja.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "nyxora",
3
- "version": "1.4.0",
3
+ "version": "1.4.2",
4
4
  "description": "",
5
5
  "main": "dist/gateway/cli.js",
6
6
  "files": [