/\_____/\
      /  ■   ■  \       🐾 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.

"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: noraz.space
• 🐦 Official X (Twitter): @norazspace
• 📖 Interactive Documentation & Quickstart: noraz.space/docs
• $Nora: 0xe03C7E86f6b73b47919be34602F233c6149F5C1e

                          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)

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:

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.

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.

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

# Run the Windows setup script
.\setup.bat

# 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

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

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

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

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

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.

noraz update            # or: npm run update

Performs git stash → git pull → npm install → npm run build → detached PM2 restart and notifies Telegram / Discord webhook.

💡 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)

🐾 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.

On launch, Noraz creates the 🐾 NORAZ COMMAND CENTER category and 7 text channels:

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.

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.

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).

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.

MIT — see LICENSE.

Built with precision, chill vibes, and razor-sharp on-chain instincts — powered by Noraz AI. 🐾⚡🌸