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.
Badge for your README
Markdown
[](/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
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)
- # ๐พ NORAZ AI โ Robinhood Chain Edition
- ```
- /\_____/\
- / โ โ \ ๐พ NORAZ AI (ROBINHOOD CHAIN) ๐พ
- ( == ^ == ) Autonomous Multi-Agent Crypto Intelligence
- ) ~ ( & On-Chain Trading Ecosystem
- ( _____ ) exclusively for Robinhood Chain EVM L2 (#4663)
- ( ( ) ( ) )
- (__(__)___(__)__)
- ```
- **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**.
- 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.
- [](https://noraz.space)
- [](https://robinhoodchain.blockscout.com)
- [](https://nodejs.org/)
- [](https://x.com/mogonsx)
- [](https://nodejs.org/)
- [](LICENSE)
- [](https://vitest.dev/)
- > *"Chill trades, 9 lives, razor-sharp on-chain instincts."* ๐พโก
- >
- > โ ๏ธ **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.
- ---
- ## ๐ Official Web Portal & Community Links
- - ๐ **Official Web Portal:** [noraz.space](https://noraz.space)
- - ๐ฆ **Official X (Twitter):** [@norazspace](https://x.com/mogonsx)
- - ๐ **Interactive Documentation & Quickstart:** [noraz.space/docs](https://noraz.space/docs)
- - $Nora: [0xe03C7E86f6b73b47919be34602F233c6149F5C1e](https://www.ponsfamily.com/launchpad/0xe03C7E86f6b73b47919be34602F233c6149F5C1e)
- ---
- ## ๐พ The Noraz System Architecture
- | Component | Role | What it does |
- | :--- | :--- | :--- |
- | ๐พ **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. |
- | ๐ฎ **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. |
- | โก **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. |
- ---
- ## ๐บ๏ธ System Flowchart
- ```
- USER INTERFACE PLATFORMS
- (Discord Command Center ยท Terminal TUI ยท Telegram Bridge)
- โ
- โผ
- โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
- โ NORAZ CORE HUB โ
- โ #noraz-control-room ยท chat โ
- โ risk gate ยท 9-lives risk engine โ
- โ wallet service ยท trade journal โ
- โโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโ
- โ candidate signals
- โโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโ
- โผ โผ โผ โผ โผ
- โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ
- โ MEME AGENT โ โ LP VELOCITY โ โ NFT AGENT โ โ ALPHA SCRAPERโ โ ETH WHALES โ
- โmeme-robinhoodโ โ lp-robinhood โ โ nft โ โalpha-robinhoodโ โ whale-eth โ
- โGMGN+Dex tape โ โ Krystal Cloudโ โ OpenSea โ โX API v2 / Webโ โ Hyperliquid โ
- โvol 24h โฅ $25kโ โFee/TVL โฅ 2% โ โfloor +10%/1h โ โ1h rh alpha โ โperps โฅ $500k โ
- โliq โฅ $5k โ โTVL โฅ $10k โ โsales โฅ 3/h โ โsentiment highโ โspot โฅ $50k โ
- โโโโโโโโฌโโโโโโโโ โโโโโโโโฌโโโโโโโโ โโโโโโโโฌโโโโโโโโ โโโโโโโโฌโโโโโโโโ โโโโโโโโฌโโโโโโโโ
- โโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโ
- โผ
- โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
- โ SWARM CONSENSUS ENGINE (โฅ 80%) โ
- โ Quant ยท Catalyst ยท Security Audit โ
- โโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโ
- โ only โฅ 80% confidence
- โผ
- MULTI-PLATFORM DISPATCH (Discord ยท Terminal TUI ยท Telegram)
- โข Discord: #call-meme-robinhood ยท #call-lp-robinhood ยท #call-nft-robinhood ยท #call-alpha-robinhood ยท #call-whale-eth
- โข Terminal: Interactive TUI Live Feed, Audits & Chat (noraz terminal)
- โข Telegram: Real-Time Signal Alert Cards & Interactive Inline Menu
- โ
- โผ
- WALLET TRACKER (holdings lifecycle)
- โ
- โผ
- POSITION MANAGER (TP 2x/3x ยท SL -20% ยท trailing)
- ```
- ---
- ## โจ Feature Grid
- | # | Feature | Description |
- | :-: | :--- | :--- |
- | 1 | ๐ก๏ธ **3-Layer Swarm Consensus** | Quant & Liquidity, Catalyst & Sentiment, Security Audit โ **โฅ 80% confidence** required before any call card is posted. |
- | 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. |
- | 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. |
- | 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. |
- | 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**). |
- | 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. |
- | 7 | โ๏ธ **22 Slash Commands** | Full command surface: wallets, screening control, audits, price/alert tools, journal, update, emergency cancel, and more. |
- | 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. |
- | 9 | ๐ **Trade Journal & Analytics** | Open/close audit trail with win-rate, PnL, and CSV export for Excel/Notion. |
- | 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. |
- | 11 | โก **Noraz Ops Ops** | PM2 24/7 deploy, `noraz update` self-updater with Telegram + Discord webhook notifications, `noraz doctor`, Windows & Linux setup scripts. |
- ---
- ## ๐ง Screening Strategies (Fully Customizable)
- Screening strictness is fully user-configurable at onboarding (wizard **STEP 5.5**) โ you pick how aggressive Noraz should be when hunting signals.
- - **Loosened Default (2x):** ~2x more signals than Standard โ more frequent call cards, still gated by the **>= 80% quality floor**. Recommended for most users.
- - **Standard (strict):** Conservative hard gates (e.g. meme 24h volume โฅ $50k, LP TVL โฅ $20k, Fee/TVL > 4%, Whale perps โฅ $1M) โ fewer, higher-conviction calls.
- - **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"*.
- - **Advanced numeric editor:** Fine-tune every hard gate per agent directly (via wizard / control room).
- **Loosened defaults per agent:**
- | Agent | Hard gates (loosened default) |
- | :--- | :--- |
- | ๐ธ **meme-robinhood** | 24h volume โฅ $25k ยท liquidity โฅ $5k ยท total fees โฅ $250 ยท security audit pass |
- | ๐ **lp-robinhood** | TVL โฅ $10k ยท 24h volume โฅ $100k ยท 24h Fee/TVL โฅ 2% ยท market cap โฅ $100k ยท security audit pass |
- | ๐ฎ **nft** | Floor surge โฅ +10%/1h ยท volume spike โฅ 1.5x ยท sales velocity โฅ 3/h ยท security audit pass |
- | ๐ **whale-eth** | Min perps position โฅ $500k ยท min spot fill โฅ $50k ยท min whale count 1 |
- > **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.
- ---
- ## ๐ Quickstart & Platform Setup
- 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
- ```powershell
- # 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
- ```powershell
- # 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
- ```powershell
- # 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
- ```bash
- # 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
- ```bash
- 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
- ```bash
- 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
- ```bash
- noraz update # or: npm run update
- ```
- *Performs `git stash` โ `git pull` โ `npm install` โ `npm run build` โ detached PM2 restart and notifies Telegram / Discord webhook.*
- ---
- ## โจ๏ธ CLI Commands (`noraz`)
- | Command | Aliases | Description |
- | :--- | :--- | :--- |
- | `noraz run` | `dev`, `start` | Launch the Noraz engine (development / live bot, hot reload) |
- | `noraz onboard` | `wizard`, `setup`, `config` | Interactive `.env` onboarding wizard (modes, TP/SL, X API v2, API keys) |
- | `noraz terminal` | `tui` | Noraz interactive Terminal TUI |
- | `noraz deploy` | `pm2` | Deploy 24/7 background daemon via PM2 |
- | `noraz test` | โ | Run the Vitest unit test suite |
- | `noraz build` | โ | Compile TypeScript into `/dist` |
- | `noraz update` | โ | Pull latest code, reinstall, rebuild, restart (notifies Telegram/Discord webhook) |
- | `noraz uninstall` | `purge`, `clean-all` | Clean uninstaller: stop PM2 daemons, wipe database state, purge `.env` & dist |
- | `noraz doctor` | `check` | Full diagnostics: API keys, agent states, risk state, connectivity |
- | `noraz help` | `-h`, `--help` | Show the CLI cheatsheet |
- > ๐ก **Cross-Platform Invocation & Non-Root Fallbacks:**
- > 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:
- > * **Via `npm run`:** `npm run dev`, `npm run terminal`, `npm run wizard`, `npm run deploy`, `npm run update`, `npm run test`, `npm run doctor`
- > * **Via Direct Node:** `node bin/noraz.js <command>` (e.g. `node bin/noraz.js terminal`)
- ---
- ## ๐ค Discord Slash Commands (22)
- > ๐พ **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.
- | Command | Description |
- | :--- | :--- |
- | `/wallet` | Manage burner wallets: `setup`, `list`, `replace`, `remove`, `balance`, `withdraw` |
- | `/analyze` | On-demand 3-layer audit for a token Contract Address |
- | `/screening` | Control 24/7 agents: `start`, `stop`, `status`, `trigger` |
- | `/cancel` | Emergency halt: `all` |
- | `/config` | Runtime config: `risk`, `status` |
- | `/health` | Per-agent heartbeat check (HEALTHY / DEGRADED / UNRESPONSIVE) |
- | `/strategy` | Manage strategy modules: `list`, `view`, `activate`, `rollback` |
- | `/channel` | Create / rearrange channels: `create`, `rearrange` |
- | `/price` | Quick price, 24h change & market cap lookup |
- | `/chart` | Quick chart & DexScreener link |
- | `/holders` | Top Holders audit & insider ownership breakdown |
- | `/wallets` | Top Wallets & Smart Money activity scan |
- | `/pump` | Robinhood Chain token momentum, holder & liquidity tracker |
- | `/convert` | Token value & USD converter |
- | `/alert` | Price alerts: `set`, `list`, `cancel` |
- | `/menu` | Interactive Noraz Control Center dashboard |
- | `/dashboard` | Interactive Noraz Control Center dashboard |
- | `/journal` | Trade journal: `summary`, `history`, `export` (CSV) |
- | `/update` | Pull latest code, rebuild, soft-restart |
- | `/swap` | Swap tokens via Uniswap V3 Router on Robinhood Chain L2 (#4663) |
- | `/send` | Direct native token send/transfer to another EVM address |
- ---
- ## ๐ข Auto-Created Channels (7)
- On launch, Noraz creates the **`๐พ NORAZ COMMAND CENTER`** category and 7 text channels:
- | Channel | Purpose |
- | :--- | :--- |
- | `#noraz-control-room` | Core command hub โ chat, wallet management, risk configuration |
- | `#audit-on-demand` | Paste any Robinhood Chain / EVM Contract Address for an instant audit |
- | `#call-meme-robinhood` | High-confidence Robinhood Chain meme signal calls (GMGN + security audit) |
- | `#call-lp-robinhood` | High-yield Robinhood Chain concentrated-liquidity calls (Krystal / Uniswap V3) |
- | `#call-nft-robinhood` | NFT floor price & rarity sniping alerts (OpenSea) |
- | `#call-alpha-robinhood` | 1-Hour Robinhood Chain Alpha Scraper & X (Twitter) social sentiment calls |
- | `#call-whale-eth` | Hyperliquid ETH whale positioning & spot flow tracking |
- **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.
- ---
- ## ๐ Environment Variables
- 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.
- | Variable | Description |
- | :--- | :--- |
- | `DRY_RUN` | `true` = safe simulation (default); `false` = live transactions possible |
- | `AUTO_EXECUTE_ENABLED` | Default `false` โ bot is a screener/caller; execution stays manual |
- | `DISCORD_BOT_TOKEN` / `DISCORD_CLIENT_ID` | Discord bot credentials |
- | `DISCORD_CHANNEL_CONTROL_ROOM` | ID of `#noraz-control-room` |
- | `TELEGRAM_BOT_TOKEN` / `TELEGRAM_CHAT_ID` | Telegram notification bridge + bot polling |
- | `DISCORD_DEPLOY_WEBHOOK_URL` | Optional Discord webhook for deploy notifications |
- | `EVM_ROBINHOOD_RPC_URL` | Canonical Robinhood Chain RPC (`https://rpc.mainnet.chain.robinhood.com`) |
- | `EVM_RPC_URL` | Generic EVM fallback RPC |
- | `RPC_FAILOVER_URLS` | JSON pool of backup RPCs (auto-failover) |
- | `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.) |
- | `GMGN_API_KEY` / `GMGN_API_KEY_ROBINHOOD` | GMGN OpenAPI (smart-money, rank, trenches, token security) |
- | `OPENSEA_API_KEY` | NFT floor/rarity + swap aggregator (nft agent) |
- | `X_API_BEARER_TOKEN` | Official X (Twitter) API v2 Bearer Token โ required for `#call-alpha-robinhood` sub-agent social sentiment search |
- | `GOPLUS_API_KEY` | EVM token security audit (GoPlus) |
- | `UNISWAP_API_KEY` | Uniswap Trade API โ Robinhood/EVM swap entry |
- | `KRYSTAL_CLOUD_API_KEY` | Krystal Cloud DeFi data โ Robinhood LP pools (`ethereum@4663`), required for the LP agent |
- | `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 |
- | `EVM_PRIVATE_KEY` | Trading wallet private key (keep `DRY_RUN=true` while testing) |
- | `EVM_PRIORITY_FEE_GWEI` / `SIMULATION_BALANCE_ETH` | Execution tuning / simulated balance |
- | `API_PORT` | Noraz Web Dashboard REST API port (default `3000`) |
- | `NORAZ_API_KEY` | Optional security key for REST API guard (`X-Noraz-Api-Key` or `Bearer <key>`) |
- ---
- ## ๐ก Web Dashboard REST API
- 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`).
- | Endpoint | Method | Purpose |
- | :--- | :--- | :--- |
- | **`/api/status`** (or `/health`) | `GET` | Execution mode, active sub-agents, market regime, kill-switch status, and connected API keys |
- | **`/api/calls`** | `GET` | Historical signal calls evaluated by Swarm Consensus across all sub-agents (`?domain=alpha-robinhood&limit=50`) |
- | **`/api/positions`** | `GET` | Active token positions, LP positions, and NFT positions with PnL and TP/SL milestones |
- | **`/api/executions`** | `GET` | Trade journal ledger entries, win-rate, total PnL, and transaction stats |
- | **`/api/alerts`** | `GET` | Active custom price alerts set by users |
- | **`/api/agents/toggle`** | `POST` | Enable or pause a specific sub-agent domain (`{ "domain": "alpha-robinhood", "active": true }`) |
- | **`/api/command`** | `POST` | Execute ToolRegistry actions directly from web UI inputs (`{ "command": "pause_sub_agent", "args": { "agentId": "nft" } }`) |
- ---
- ## โ FAQ
- **1. What is Robinhood Chain?**
- 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.
- **2. What is Noraz AI?**
- 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).
- **3. Does Noraz AI run on Windows as well as Linux?**
- 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.
- **4. Is `DRY_RUN` safe?**
- 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.
- **5. How do backup keys work?**
- 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`.
- **6. Where are keys stored?**
- 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.
- ---
- ## โ ๏ธ Risk Disclaimer
- > [!WARNING]
- > **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.
- ---
- ## ๐ License
- MIT โ see [LICENSE](LICENSE).
- ---
- *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 inFree to use. If itโs helped, pass it on.