Skip to content
Back to search

noraz-agent

Open-source Robinhood trading agent infrastructure with MCP-powered DEX research, autonomous trading, agent wallets, and copy-trading capabilities

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mogons--noraz-agent/badge.svg)](/listings/mogons--noraz-agent)

HTML

<a href="/listings/mogons--noraz-agent"><img src="/api/listings/mogons--noraz-agent/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Noraz AI is built with Node.js and TypeScript, making it **100% cross-platform compatible** across **Windows (PowerShell / Command Prompt / Windows Terminal)**, **Linux (Ubuntu, Debian, CentOS, etc.)**, and **macOS**.

๐ŸชŸ Windows (PowerShell / CMD / Windows Terminal)

1. One-Click Setup

# Clone the repository
git clone https://github.com/runesatsdev/noraz-agent.git
cd noraz-agent

# Run the Windows setup script
.\setup.bat

2. Manual / Standard Setup

# Install dependencies & compile TypeScript
npm install
npm run build

# Run interactive onboarding wizard (.env, API keys, AI models, TP/SL)
npm run wizard

# Launch the live bot in development mode
npm run dev

# Launch the standalone Command Center Terminal TUI (24-bit TrueColor)
npm run terminal

3. Running 24/7 on Windows

# Using PM2 daemon
npx pm2 start dist/index.js --name noraz-agent --update-env
npx pm2 status
npx pm2 logs noraz-agent

---

๐Ÿง Linux / macOS / VPS

1. One-Click Setup

# Clone the repository
git clone https://github.com/runesatsdev/noraz-agent.git
cd noraz-agent

# Run the Linux/macOS setup script
bash setup.sh

2. Manual Setup

npm install
npm run build
noraz onboard           # interactive .env wizard
noraz run               # live bot / development mode
noraz terminal          # standalone Terminal TUI

3. Running 24/7 on Linux/VPS

noraz deploy            # or: npm run deploy

> **Invite the bot:** use your Discord OAuth2 URL with `applications.commands` + bot scopes. On first launch Noraz **auto-creates** the `๐Ÿพ NORAZ COMMAND CENTER` category, 7 dedicated channels, and registers all 22 slash commands โ€” zero manual channel setup.

๐Ÿ”„ Auto-Update Engine

noraz update            # or: npm run update

*Performs `git stash` โ†’ `git pull` โ†’ `npm install` โ†’ `npm run build` โ†’ detached PM2 restart and notifies Telegram / Discord webhook.*

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md ยท README ยท 365 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # ๐Ÿพ NORAZ AI โ€” Robinhood Chain Edition
  2. ```
  3. /\_____/\
  4. / โ–  โ–  \ ๐Ÿพ NORAZ AI (ROBINHOOD CHAIN) ๐Ÿพ
  5. ( == ^ == ) Autonomous Multi-Agent Crypto Intelligence
  6. ) ~ ( & On-Chain Trading Ecosystem
  7. ( _____ ) exclusively for Robinhood Chain EVM L2 (#4663)
  8. ( ( ) ( ) )
  9. (__(__)___(__)__)
  10. ```
  11. **Autonomous Multi-Agent Crypto Intelligence & Trading Ecosystem** โ€” built exclusively for **Robinhood Chain (EVM L2, chain ID 4663, native ETH)**, operated through a **Discord Command Center**, an **Interactive Terminal TUI**, and a **Telegram Notification Bridge**.
  12. Noraz AI separates **24/7 market screening + 3-Layer Swarm Consensus signal generation** from **execution** โ€” signal cards are delivered to Discord with audit data and one-click links, while execution stays under your control via `DRY_RUN` and manual confirmation.
  13. [![Domain](https://img.shields.io/badge/Domain-noraz.space-brightgreen.svg)](https://noraz.space)
  14. [![Chain](https://img.shields.io/badge/Robinhood%20Chain-4663%20%7C%20ETH-7b5cff.svg)](https://robinhoodchain.blockscout.com)
  15. [![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20Linux%20%7C%20macOS-blue.svg)](https://nodejs.org/)
  16. [![X (Twitter)](https://img.shields.io/badge/X-%40mogonsx-black.svg)](https://x.com/mogonsx)
  17. [![Node](https://img.shields.io/badge/Node.js-%3E%3D22.12-green.svg)](https://nodejs.org/)
  18. [![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
  19. [![Tests](https://img.shields.io/badge/Tests-264%20Passed-brightgreen.svg)](https://vitest.dev/)
  20. > *"Chill trades, 9 lives, razor-sharp on-chain instincts."* ๐Ÿพโšก
  21. >
  22. > โš ๏ธ **Disclaimer (NFA & DYOR):** Noraz AI is an experimental open-source research and intelligence tool. On-chain cryptocurrency trading carries significant financial risk. Past performance does not guarantee future results. Not financial advice. Always do your own research.
  23. ---
  24. ## ๐ŸŒ Official Web Portal & Community Links
  25. - ๐ŸŒ **Official Web Portal:** [noraz.space](https://noraz.space)
  26. - ๐Ÿฆ **Official X (Twitter):** [@norazspace](https://x.com/mogonsx)
  27. - ๐Ÿ“– **Interactive Documentation & Quickstart:** [noraz.space/docs](https://noraz.space/docs)
  28. - $Nora: [0xe03C7E86f6b73b47919be34602F233c6149F5C1e](https://www.ponsfamily.com/launchpad/0xe03C7E86f6b73b47919be34602F233c6149F5C1e)
  29. ---
  30. ## ๐Ÿพ The Noraz System Architecture
  31. | Component | Role | What it does |
  32. | :--- | :--- | :--- |
  33. | ๐Ÿพ **Noraz Core** โ€” Intelligence | Screening & Reasoning | **3-Layer Swarm Consensus Engine** (Quant & Liquidity, Catalyst & Sentiment, Security Audit) demanding a **โ‰ฅ 80% Confidence Score** before a signal is posted. Five specialist screening agents run 24/7: **meme-robinhood** (GMGN smart-money data + GMGN/GoPlus security audits, **24h volume โ‰ฅ $25k**, **liquidity โ‰ฅ $5k**), **lp-robinhood** (Concentrated Liquidity velocity via **Krystal Cloud**, **TVL โ‰ฅ $10k**, **24h volume โ‰ฅ $100k**, **24h Fee/TVL โ‰ฅ 2%**), **nft** (OpenSea floor & rarity sniping, **floor surge โ‰ฅ +10%/1h**, **volume spike โ‰ฅ 1.5x**, **sales โ‰ฅ 3/h**), **alpha-robinhood** (1-hour Robinhood Chain alpha scraper + optional official **X (Twitter) API v2** social sentiment search), and **whale-eth** (Hyperliquid ETH smart money & institutional perps/spot order flow tracking, **perps โ‰ฅ $500k**, **spot โ‰ฅ $50k**). A **Position Manager** tracks open positions with Take Profit milestones (**+100% / +200%**), **Stop Loss (-20%)**, **dynamic trailing stops**, LP out-of-range warnings, and NFT floor-drop alerts. |
  34. | ๐ŸŽฎ **Command Center** โ€” Multi-Platform | Discord ยท Terminal ยท Telegram | **1. Discord**: `#noraz-control-room` natural-language chat, `#audit-on-demand` token auditor, portfolio & risk views, **22 slash commands**, interactive dashboard, and 5 dedicated call channels (`#call-meme-robinhood`, `#call-lp-robinhood`, `#call-nft-robinhood`, `#call-alpha-robinhood`, `#call-whale-eth`).<br>**2. Terminal TUI** (`noraz terminal` / `npm run terminal`): Full interactive standalone console with live token audits, screening triggers, strategy switcher, treasury & portfolio management without Discord.<br>**3. Telegram Bridge**: Real-time signal alert broadcast cards with quick inline action buttons and interactive callback dashboard. |
  35. | โšก **Noraz Ops Ops** โ€” Deploy & Maintain | Daemon & Health | **PM2 24/7 daemon** (`noraz deploy`), self-update engine (`noraz update` โ†’ git pull โ†’ install โ†’ build โ†’ detached PM2 restart) with **Telegram + Discord webhook deployment notifications**, `noraz doctor` full diagnostics, and interactive **`noraz onboard`** wizard. |
  36. ---
  37. ## ๐Ÿ—บ๏ธ System Flowchart
  38. ```
  39. USER INTERFACE PLATFORMS
  40. (Discord Command Center ยท Terminal TUI ยท Telegram Bridge)
  41. โ”‚
  42. โ–ผ
  43. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  44. โ”‚ NORAZ CORE HUB โ”‚
  45. โ”‚ #noraz-control-room ยท chat โ”‚
  46. โ”‚ risk gate ยท 9-lives risk engine โ”‚
  47. โ”‚ wallet service ยท trade journal โ”‚
  48. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  49. โ”‚ candidate signals
  50. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  51. โ–ผ โ–ผ โ–ผ โ–ผ โ–ผ
  52. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  53. โ”‚ MEME AGENT โ”‚ โ”‚ LP VELOCITY โ”‚ โ”‚ NFT AGENT โ”‚ โ”‚ ALPHA SCRAPERโ”‚ โ”‚ ETH WHALES โ”‚
  54. โ”‚meme-robinhoodโ”‚ โ”‚ lp-robinhood โ”‚ โ”‚ nft โ”‚ โ”‚alpha-robinhoodโ”‚ โ”‚ whale-eth โ”‚
  55. โ”‚GMGN+Dex tape โ”‚ โ”‚ Krystal Cloudโ”‚ โ”‚ OpenSea โ”‚ โ”‚X API v2 / Webโ”‚ โ”‚ Hyperliquid โ”‚
  56. โ”‚vol 24h โ‰ฅ $25kโ”‚ โ”‚Fee/TVL โ‰ฅ 2% โ”‚ โ”‚floor +10%/1h โ”‚ โ”‚1h rh alpha โ”‚ โ”‚perps โ‰ฅ $500k โ”‚
  57. โ”‚liq โ‰ฅ $5k โ”‚ โ”‚TVL โ‰ฅ $10k โ”‚ โ”‚sales โ‰ฅ 3/h โ”‚ โ”‚sentiment highโ”‚ โ”‚spot โ‰ฅ $50k โ”‚
  58. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  59. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  60. โ–ผ
  61. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  62. โ”‚ SWARM CONSENSUS ENGINE (โ‰ฅ 80%) โ”‚
  63. โ”‚ Quant ยท Catalyst ยท Security Audit โ”‚
  64. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  65. โ”‚ only โ‰ฅ 80% confidence
  66. โ–ผ
  67. MULTI-PLATFORM DISPATCH (Discord ยท Terminal TUI ยท Telegram)
  68. โ€ข Discord: #call-meme-robinhood ยท #call-lp-robinhood ยท #call-nft-robinhood ยท #call-alpha-robinhood ยท #call-whale-eth
  69. โ€ข Terminal: Interactive TUI Live Feed, Audits & Chat (noraz terminal)
  70. โ€ข Telegram: Real-Time Signal Alert Cards & Interactive Inline Menu
  71. โ”‚
  72. โ–ผ
  73. WALLET TRACKER (holdings lifecycle)
  74. โ”‚
  75. โ–ผ
  76. POSITION MANAGER (TP 2x/3x ยท SL -20% ยท trailing)
  77. ```
  78. ---
  79. ## โœจ Feature Grid
  80. | # | Feature | Description |
  81. | :-: | :--- | :--- |
  82. | 1 | ๐Ÿ›ก๏ธ **3-Layer Swarm Consensus** | Quant & Liquidity, Catalyst & Sentiment, Security Audit โ€” **โ‰ฅ 80% confidence** required before any call card is posted. |
  83. | 2 | ๐ŸŒธ **Robinhood Meme Agent** (`#call-meme-robinhood`) | GMGN smart-money/rank/trenches screening + native DexScreener 1h tape (dump / vol-liq) + RH launchpad origin (Pons, NOXA, LetsCash, โ€ฆ) + GMGN & GoPlus security audits; hard gate **real 24h volume โ‰ฅ $25k**, **liquidity โ‰ฅ $5k**, **total fees โ‰ฅ $250**, fail-closed. |
  84. | 3 | ๐ŸŒŠ **Robinhood LP Velocity Engine** (`#call-lp-robinhood`) | Concentrated-liquidity (Uniswap V3) high-yield pools via **Krystal Cloud** (`ethereum@4663`); **TVL โ‰ฅ $10k**, **24h volume โ‰ฅ $100k**, **24h Fee/TVL โ‰ฅ 2%**, **market cap โ‰ฅ $100k**, volume velocity, GMGN security re-check. |
  85. | 4 | ๐Ÿ”ฎ **NFT Sniper** (`#call-nft-robinhood`) | OpenSea REST v2 floor & rarity sniping; hard filters **floor surge โ‰ฅ +10%/1h**, **volume โ‰ฅ 1.5x**, **sales โ‰ฅ 3/h**; whale sweep & verified badge as card info. |
  86. | 5 | ๐Ÿ‹ **ETH Whale Tracker** (`#call-whale-eth`) | Hyperliquid L1 institutional positioning & smart money tracker; monitors open perps positions (**โ‰ฅ $500k**), direction flips, and large spot order flow (**โ‰ฅ $50k**). |
  87. | 6 | ๐Ÿ’ฌ **Natural-Language Command Room** | Chat with Noraz in `#noraz-control-room` โ€” swap/send intents, audits, alerts, and strategy questions via the agent tool loop. |
  88. | 7 | โš™๏ธ **22 Slash Commands** | Full command surface: wallets, screening control, audits, price/alert tools, journal, update, emergency cancel, and more. |
  89. | 8 | ๐Ÿ“ˆ **Position Manager** | Auto-sell targets: TP **+100% (2x)** / **+200% (3x)**, **SL -20%**, dynamic trailing stops, LP out-of-range warnings, NFT floor-drop alerts. |
  90. | 9 | ๐Ÿ“Š **Trade Journal & Analytics** | Open/close audit trail with win-rate, PnL, and CSV export for Excel/Notion. |
  91. | 10 | ๐Ÿ”’ **Security-First Design** | `DRY_RUN=true` default, 9-Lives circuit breaker, sandboxed strategy modules (sanitized `process.env`), prompt-injection hardening, backup API key rotation. |
  92. | 11 | โšก **Noraz Ops Ops** | PM2 24/7 deploy, `noraz update` self-updater with Telegram + Discord webhook notifications, `noraz doctor`, Windows & Linux setup scripts. |
  93. ---
  94. ## ๐Ÿง  Screening Strategies (Fully Customizable)
  95. Screening strictness is fully user-configurable at onboarding (wizard **STEP 5.5**) โ€” you pick how aggressive Noraz should be when hunting signals.
  96. - **Loosened Default (2x):** ~2x more signals than Standard โ€” more frequent call cards, still gated by the **>= 80% quality floor**. Recommended for most users.
  97. - **Standard (strict):** Conservative hard gates (e.g. meme 24h volume โ‰ฅ $50k, LP TVL โ‰ฅ $20k, Fee/TVL > 4%, Whale perps โ‰ฅ $1M) โ€” fewer, higher-conviction calls.
  98. - **Custom Prompt:** Write screening rules in plain English (e.g. *"only CTO tokens with 2+ smart wallets, min $10k liq"*). Noraz compiles your prompt into a **validated strategy `.mjs`** automatically on first boot after deploy, with a safe default fallback if compilation fails. Re-runnable anytime via chat: *"re-apply my strategy prompt"*.
  99. - **Advanced numeric editor:** Fine-tune every hard gate per agent directly (via wizard / control room).
  100. **Loosened defaults per agent:**
  101. | Agent | Hard gates (loosened default) |
  102. | :--- | :--- |
  103. | ๐ŸŒธ **meme-robinhood** | 24h volume โ‰ฅ $25k ยท liquidity โ‰ฅ $5k ยท total fees โ‰ฅ $250 ยท security audit pass |
  104. | ๐ŸŒŠ **lp-robinhood** | TVL โ‰ฅ $10k ยท 24h volume โ‰ฅ $100k ยท 24h Fee/TVL โ‰ฅ 2% ยท market cap โ‰ฅ $100k ยท security audit pass |
  105. | ๐Ÿ”ฎ **nft** | Floor surge โ‰ฅ +10%/1h ยท volume spike โ‰ฅ 1.5x ยท sales velocity โ‰ฅ 3/h ยท security audit pass |
  106. | ๐Ÿ‹ **whale-eth** | Min perps position โ‰ฅ $500k ยท min spot fill โ‰ฅ $50k ยท min whale count 1 |
  107. > **Quality floor is never lowered:** the swarm **>= 80% confidence** gate and all security gates remain mandatory and **fail-closed** โ€” missing data or failed audits always reject, regardless of preset.
  108. ---
  109. ## ๐Ÿš€ Quickstart & Platform Setup
  110. Noraz AI is built with Node.js and TypeScript, making it **100% cross-platform compatible** across **Windows (PowerShell / Command Prompt / Windows Terminal)**, **Linux (Ubuntu, Debian, CentOS, etc.)**, and **macOS**.
  111. ### ๐ŸชŸ Windows (PowerShell / CMD / Windows Terminal)
  112. #### 1. One-Click Setup
  113. ```powershell
  114. # Clone the repository
  115. git clone https://github.com/runesatsdev/noraz-agent.git
  116. cd noraz-agent
  117. # Run the Windows setup script
  118. .\setup.bat
  119. ```
  120. #### 2. Manual / Standard Setup
  121. ```powershell
  122. # Install dependencies & compile TypeScript
  123. npm install
  124. npm run build
  125. # Run interactive onboarding wizard (.env, API keys, AI models, TP/SL)
  126. npm run wizard
  127. # Launch the live bot in development mode
  128. npm run dev
  129. # Launch the standalone Command Center Terminal TUI (24-bit TrueColor)
  130. npm run terminal
  131. ```
  132. #### 3. Running 24/7 on Windows
  133. ```powershell
  134. # Using PM2 daemon
  135. npx pm2 start dist/index.js --name noraz-agent --update-env
  136. npx pm2 status
  137. npx pm2 logs noraz-agent
  138. ```
  139. ---
  140. ### ๐Ÿง Linux / macOS / VPS
  141. #### 1. One-Click Setup
  142. ```bash
  143. # Clone the repository
  144. git clone https://github.com/runesatsdev/noraz-agent.git
  145. cd noraz-agent
  146. # Run the Linux/macOS setup script
  147. bash setup.sh
  148. ```
  149. #### 2. Manual Setup
  150. ```bash
  151. npm install
  152. npm run build
  153. noraz onboard # interactive .env wizard
  154. noraz run # live bot / development mode
  155. noraz terminal # standalone Terminal TUI
  156. ```
  157. #### 3. Running 24/7 on Linux/VPS
  158. ```bash
  159. noraz deploy # or: npm run deploy
  160. ```
  161. > **Invite the bot:** use your Discord OAuth2 URL with `applications.commands` + bot scopes. On first launch Noraz **auto-creates** the `๐Ÿพ NORAZ COMMAND CENTER` category, 7 dedicated channels, and registers all 22 slash commands โ€” zero manual channel setup.
  162. ### ๐Ÿ”„ Auto-Update Engine
  163. ```bash
  164. noraz update # or: npm run update
  165. ```
  166. *Performs `git stash` โ†’ `git pull` โ†’ `npm install` โ†’ `npm run build` โ†’ detached PM2 restart and notifies Telegram / Discord webhook.*
  167. ---
  168. ## โŒจ๏ธ CLI Commands (`noraz`)
  169. | Command | Aliases | Description |
  170. | :--- | :--- | :--- |
  171. | `noraz run` | `dev`, `start` | Launch the Noraz engine (development / live bot, hot reload) |
  172. | `noraz onboard` | `wizard`, `setup`, `config` | Interactive `.env` onboarding wizard (modes, TP/SL, X API v2, API keys) |
  173. | `noraz terminal` | `tui` | Noraz interactive Terminal TUI |
  174. | `noraz deploy` | `pm2` | Deploy 24/7 background daemon via PM2 |
  175. | `noraz test` | โ€” | Run the Vitest unit test suite |
  176. | `noraz build` | โ€” | Compile TypeScript into `/dist` |
  177. | `noraz update` | โ€” | Pull latest code, reinstall, rebuild, restart (notifies Telegram/Discord webhook) |
  178. | `noraz uninstall` | `purge`, `clean-all` | Clean uninstaller: stop PM2 daemons, wipe database state, purge `.env` & dist |
  179. | `noraz doctor` | `check` | Full diagnostics: API keys, agent states, risk state, connectivity |
  180. | `noraz help` | `-h`, `--help` | Show the CLI cheatsheet |
  181. > ๐Ÿ’ก **Cross-Platform Invocation & Non-Root Fallbacks:**
  182. > If you prefer not to use global `npm link` (or on restricted environments), all commands can be invoked identically across PowerShell, CMD, and Bash via `npm run` or direct Node:
  183. > * **Via `npm run`:** `npm run dev`, `npm run terminal`, `npm run wizard`, `npm run deploy`, `npm run update`, `npm run test`, `npm run doctor`
  184. > * **Via Direct Node:** `node bin/noraz.js <command>` (e.g. `node bin/noraz.js terminal`)
  185. ---
  186. ## ๐Ÿค– Discord Slash Commands (22)
  187. > ๐Ÿพ **Channel Restriction:** All slash commands and interactive UI controls are restricted to channels inside the **`๐Ÿพ NORAZ COMMAND CENTER`** category (e.g. `#noraz-control-room`) to prevent cluttering external server channels.
  188. | Command | Description |
  189. | :--- | :--- |
  190. | `/wallet` | Manage burner wallets: `setup`, `list`, `replace`, `remove`, `balance`, `withdraw` |
  191. | `/analyze` | On-demand 3-layer audit for a token Contract Address |
  192. | `/screening` | Control 24/7 agents: `start`, `stop`, `status`, `trigger` |
  193. | `/cancel` | Emergency halt: `all` |
  194. | `/config` | Runtime config: `risk`, `status` |
  195. | `/health` | Per-agent heartbeat check (HEALTHY / DEGRADED / UNRESPONSIVE) |
  196. | `/strategy` | Manage strategy modules: `list`, `view`, `activate`, `rollback` |
  197. | `/channel` | Create / rearrange channels: `create`, `rearrange` |
  198. | `/price` | Quick price, 24h change & market cap lookup |
  199. | `/chart` | Quick chart & DexScreener link |
  200. | `/holders` | Top Holders audit & insider ownership breakdown |
  201. | `/wallets` | Top Wallets & Smart Money activity scan |
  202. | `/pump` | Robinhood Chain token momentum, holder & liquidity tracker |
  203. | `/convert` | Token value & USD converter |
  204. | `/alert` | Price alerts: `set`, `list`, `cancel` |
  205. | `/menu` | Interactive Noraz Control Center dashboard |
  206. | `/dashboard` | Interactive Noraz Control Center dashboard |
  207. | `/journal` | Trade journal: `summary`, `history`, `export` (CSV) |
  208. | `/update` | Pull latest code, rebuild, soft-restart |
  209. | `/swap` | Swap tokens via Uniswap V3 Router on Robinhood Chain L2 (#4663) |
  210. | `/send` | Direct native token send/transfer to another EVM address |
  211. ---
  212. ## ๐Ÿ“ข Auto-Created Channels (7)
  213. On launch, Noraz creates the **`๐Ÿพ NORAZ COMMAND CENTER`** category and 7 text channels:
  214. | Channel | Purpose |
  215. | :--- | :--- |
  216. | `#noraz-control-room` | Core command hub โ€” chat, wallet management, risk configuration |
  217. | `#audit-on-demand` | Paste any Robinhood Chain / EVM Contract Address for an instant audit |
  218. | `#call-meme-robinhood` | High-confidence Robinhood Chain meme signal calls (GMGN + security audit) |
  219. | `#call-lp-robinhood` | High-yield Robinhood Chain concentrated-liquidity calls (Krystal / Uniswap V3) |
  220. | `#call-nft-robinhood` | NFT floor price & rarity sniping alerts (OpenSea) |
  221. | `#call-alpha-robinhood` | 1-Hour Robinhood Chain Alpha Scraper & X (Twitter) social sentiment calls |
  222. | `#call-whale-eth` | Hyperliquid ETH whale positioning & spot flow tracking |
  223. **Call cards** are Discord embeds with market metrics, security/holder audit fields, an AI thesis, and action **links** โ€” `๐ŸŒ Trade on Uniswap`, `๐Ÿ“Š Chart on DexScreener`, `๐Ÿ” View on Krystal`, `๐Ÿ“Š View Collection on OpenSea` โ€” plus `โธ๏ธ Pause` buttons. Cards never contain BUY buttons: execution is manual via those links (or `DRY_RUN` simulations), unless you explicitly enable auto-execution.
  224. ---
  225. ## ๐Ÿ” Environment Variables
  226. Primary keys are set in `.env` (see `.env.example`). Every provider key accepts a `_BACKUP_KEYS` comma-separated companion โ€” sub-agents auto-rotate to backups on 401/403/429.
  227. | Variable | Description |
  228. | :--- | :--- |
  229. | `DRY_RUN` | `true` = safe simulation (default); `false` = live transactions possible |
  230. | `AUTO_EXECUTE_ENABLED` | Default `false` โ€” bot is a screener/caller; execution stays manual |
  231. | `DISCORD_BOT_TOKEN` / `DISCORD_CLIENT_ID` | Discord bot credentials |
  232. | `DISCORD_CHANNEL_CONTROL_ROOM` | ID of `#noraz-control-room` |
  233. | `TELEGRAM_BOT_TOKEN` / `TELEGRAM_CHAT_ID` | Telegram notification bridge + bot polling |
  234. | `DISCORD_DEPLOY_WEBHOOK_URL` | Optional Discord webhook for deploy notifications |
  235. | `EVM_ROBINHOOD_RPC_URL` | Canonical Robinhood Chain RPC (`https://rpc.mainnet.chain.robinhood.com`) |
  236. | `EVM_RPC_URL` | Generic EVM fallback RPC |
  237. | `RPC_FAILOVER_URLS` | JSON pool of backup RPCs (auto-failover) |
  238. | `AI_PROVIDER` / `AI_BASE_URL` / `AI_API_KEYS` / `AI_API_KEY` / `AI_MODEL_NAME` | Multi-provider LLM with per-key failover (`anthropic`, `openai`, `openrouter`, etc.) |
  239. | `GMGN_API_KEY` / `GMGN_API_KEY_ROBINHOOD` | GMGN OpenAPI (smart-money, rank, trenches, token security) |
  240. | `OPENSEA_API_KEY` | NFT floor/rarity + swap aggregator (nft agent) |
  241. | `X_API_BEARER_TOKEN` | Official X (Twitter) API v2 Bearer Token โ€” required for `#call-alpha-robinhood` sub-agent social sentiment search |
  242. | `GOPLUS_API_KEY` | EVM token security audit (GoPlus) |
  243. | `UNISWAP_API_KEY` | Uniswap Trade API โ€” Robinhood/EVM swap entry |
  244. | `KRYSTAL_CLOUD_API_KEY` | Krystal Cloud DeFi data โ€” Robinhood LP pools (`ethereum@4663`), required for the LP agent |
  245. | `GMGN_BACKUP_KEYS`, `KRYSTAL_CLOUD_BACKUP_KEYS`, `OPENSEA_BACKUP_KEYS`, `GOPLUS_BACKUP_KEYS`, `UNISWAP_BACKUP_KEYS`, `X_API_BACKUP_KEYS` | Backup keys, auto-rotated on rate-limit/401/403 |
  246. | `EVM_PRIVATE_KEY` | Trading wallet private key (keep `DRY_RUN=true` while testing) |
  247. | `EVM_PRIORITY_FEE_GWEI` / `SIMULATION_BALANCE_ETH` | Execution tuning / simulated balance |
  248. | `API_PORT` | Noraz Web Dashboard REST API port (default `3000`) |
  249. | `NORAZ_API_KEY` | Optional security key for REST API guard (`X-Noraz-Api-Key` or `Bearer <key>`) |
  250. ---
  251. ## ๐Ÿ“ก Web Dashboard REST API
  252. Noraz AI ships with a native, zero-dependency REST API server (`src/api/server.ts`) designed for web dashboard and frontend integration (e.g. Next.js, Astro, React, Vue, or Mobile Apps). Includes **CORS headers (`Access-Control-Allow-Origin: *`)** and optional API Key protection (`NORAZ_API_KEY`).
  253. | Endpoint | Method | Purpose |
  254. | :--- | :--- | :--- |
  255. | **`/api/status`** (or `/health`) | `GET` | Execution mode, active sub-agents, market regime, kill-switch status, and connected API keys |
  256. | **`/api/calls`** | `GET` | Historical signal calls evaluated by Swarm Consensus across all sub-agents (`?domain=alpha-robinhood&limit=50`) |
  257. | **`/api/positions`** | `GET` | Active token positions, LP positions, and NFT positions with PnL and TP/SL milestones |
  258. | **`/api/executions`** | `GET` | Trade journal ledger entries, win-rate, total PnL, and transaction stats |
  259. | **`/api/alerts`** | `GET` | Active custom price alerts set by users |
  260. | **`/api/agents/toggle`** | `POST` | Enable or pause a specific sub-agent domain (`{ "domain": "alpha-robinhood", "active": true }`) |
  261. | **`/api/command`** | `POST` | Execute ToolRegistry actions directly from web UI inputs (`{ "command": "pause_sub_agent", "args": { "agentId": "nft" } }`) |
  262. ---
  263. ## โ“ FAQ
  264. **1. What is Robinhood Chain?**
  265. Robinhood Chain is an EVM Layer-2 network โ€” **chain ID 4663, native token ETH** โ€” with the canonical RPC `https://rpc.mainnet.chain.robinhood.com` (Blockscout explorer: `https://robinhoodchain.blockscout.com`). It is the sole target chain of Noraz AI.
  266. **2. What is Noraz AI?**
  267. Noraz AI is an autonomous, multi-agent crypto intelligence and trading ecosystem specialized for Robinhood Chain (EVM L2), featuring 3-Layer Swarm Consensus, a resilient risk engine (9-Lives Shield), and unified multi-platform interfaces (Discord, Terminal TUI, and Telegram).
  268. **3. Does Noraz AI run on Windows as well as Linux?**
  269. Yes! Noraz AI runs on Node.js (>=22.12) & TypeScript, making it **100% natively compatible with Windows (PowerShell / Command Prompt / Windows Terminal)**, **Linux (Ubuntu, Debian, etc.)**, and **macOS**. Use `.\setup.bat` on Windows or `bash setup.sh` on Linux/macOS.
  270. **4. Is `DRY_RUN` safe?**
  271. Yes. `DRY_RUN=true` (the default) guarantees **no live blockchain transactions** โ€” swaps, sends and withdrawals are simulated, and call cards only provide execution *links*. Only when you explicitly set `DRY_RUN=false` (and optionally `AUTO_EXECUTE_ENABLED`) can real transactions be signed. Always test with `DRY_RUN=true` first.
  272. **5. How do backup keys work?**
  273. Each provider key has a `_BACKUP_KEYS` companion (e.g. `GMGN_BACKUP_KEYS`). The API key pool loads the primary plus comma-separated backups and **auto-rotates to the next key on 401/403/429** responses, keeping screening alive through rate limits. AI keys support the same pattern via `AI_API_KEYS`.
  274. **6. Where are keys stored?**
  275. Credentials live in the local `.env` file (loaded via `dotenv`); runtime-set keys are persisted back to `.env` by the API key guard. Wallet private keys are held **in memory** by the WalletService and mirrored in the gitignored `database/noraz_state.json`. Nothing is uploaded or stored remotely.
  276. ---
  277. ## โš ๏ธ Risk Disclaimer
  278. > [!WARNING]
  279. > **NOT FINANCIAL ADVICE (NFA).** Noraz AI is an experimental research and education tool. Cryptocurrency, meme tokens, concentrated-liquidity positions, and NFTs are extremely volatile and you can lose your entire capital. Noraz AI runs in **`DRY_RUN` mode by default** and never sends live transactions unless you explicitly disable it โ€” but even then, past signal accuracy is no guarantee of future performance. Always trade with funds you can afford to lose, use capped burner wallets, and do your own research (DYOR) before any decision.
  280. ---
  281. ## ๐Ÿ“œ License
  282. MIT โ€” see [LICENSE](LICENSE).
  283. ---
  284. *Built with precision, chill vibes, and razor-sharp on-chain instincts โ€” powered by Noraz AI.* ๐Ÿพโšก๐ŸŒธ

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If itโ€™s helped, pass it on.