GODMODE — Solana Intelligence Platform

Open-source Solana wallet analysis & bundle detection tool. Detect bundlers, trace funding chains, expose coordinated wallets manipulating memecoins.

Live: godmode.fun

Features

• Check Wallet — full wallet profile: identity, balances, funding chain (multi-level), behavioral analysis, risk scoring (0-100), auto-verdict (BUNDLER / SNIPER BOT / WHALE / TRADER / CLEAN, etc.)
• Check Token CA — scan top holders of any token, detect bundle clusters (groups of wallets funded from the same source)
• Cross-token analysis — serial bundler detection across multiple tokens
• Database — all results saved to PostgreSQL, check history with versioning
• OG images — auto-generated social previews for Discord/Telegram/Twitter
• 4 languages — EN / FR / RU / ES
• Custom API key — bring your own Helius key for deeper scans (GOLD tier)
• SPA routing — shareable URLs like /wallet/ADDRESS and /token/MINT

Architecture

Browser (SPA)
    │
    ├── /api/helius/*     →  Nginx proxy  →  Helius API (key injected server-side)
    ├── /api/helius-rpc   →  Nginx proxy  →  Helius RPC (DAS API)
    ├── /api/db/*         →  Nginx proxy  →  Express.js API (:3001)
    └── /og/*             →  Nginx proxy  →  Express.js (OG image generation)
                                                    │
                                                PostgreSQL

All Helius API calls go through Nginx which injects the API key — the key never reaches the browser. Users can also use their own key (calls go directly to Helius, bypassing the proxy).

Helius API Endpoints Used

Endpoint	Purpose	Credits
GET /v1/wallet/{addr}/identity	Wallet identification	100
GET /v1/wallet/{addr}/balances	Token balances + USD	100
GET /v1/wallet/{addr}/funded-by	First SOL sender	100
GET /v0/addresses/{addr}/transactions	Enhanced Transactions (parsed)	100
POST /v1/wallet/batch-identity	Batch identify up to 100 wallets	100
POST /rpc (getAsset)	DAS: token metadata	10
POST /rpc (getTokenAccounts)	DAS: token holders by mint	10
POST /rpc (getSignaturesForAddress)	Standard RPC: signatures	1
POST /v0/transactions	Batch parse transactions	100/100tx

Cost per operation:

• Check Wallet: ~900 credits (shared mode, 250 sigs depth)
• Check Token CA: ~300-400 credits (100 holders)
• Helius Free Plan: 1M credits/month → ~1100 wallet checks or ~2500 token scans

Get your API key at helius.dev

Deployment

Prerequisites

• Ubuntu 22.04+ (or any Linux with systemd)
• Node.js 18+
• PostgreSQL 16+
• Nginx
• Domain with DNS pointed to your server
• Helius API key (free tier works)

Quick Deploy with Claude Code

If you have Claude Code installed, you can deploy interactively:

claude "Deploy GODMODE from this repo to my server. I have Ubuntu with nginx and postgres already installed."

Manual Deployment

1. Clone & Install

git clone https://github.com/netvyxe/godmode.git
cd godmode
npm install

2. PostgreSQL Setup

sudo -u postgres psql

CREATE USER godmode WITH PASSWORD 'your_strong_password';
CREATE DATABASE godmode OWNER godmode;
\c godmode
\i db/schema.sql
GRANT ALL ON ALL TABLES IN SCHEMA public TO godmode;
GRANT ALL ON ALL SEQUENCES IN SCHEMA public TO godmode;

3. Environment

cp .env.example .env
nano .env

Fill in your values:

DB_PASSWORD=your_strong_password
HELIUS_API_KEY=your_helius_key
DOMAIN=yourdomain.com

4. Frontend

sudo cp public/* /var/www/html/

5. Nginx

Add crawler map to /etc/nginx/nginx.conf inside the http {} block:

sudo cat nginx/crawler-map.conf  # copy this into nginx.conf

Configure the site:

sudo cp nginx/godmode.conf /etc/nginx/sites-available/godmode
sudo ln -s /etc/nginx/sites-available/godmode /etc/nginx/sites-enabled/
# Edit the file: replace YOUR_DOMAIN and YOUR_HELIUS_KEY
sudo nano /etc/nginx/sites-available/godmode
sudo nginx -t && sudo systemctl reload nginx

6. SSL (Let's Encrypt)

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d yourdomain.com -d www.yourdomain.com

After certbot runs, update the nginx config to use SSL (uncomment the SSL lines, comment out the HTTP listen).

7. Systemd Service

sudo cp systemd/godmode-api.service /etc/systemd/system/
# Edit WorkingDirectory and EnvironmentFile paths if needed
sudo nano /etc/systemd/system/godmode-api.service
sudo systemctl daemon-reload
sudo systemctl enable godmode-api
sudo systemctl start godmode-api

8. Verify

# Check API is running
curl http://localhost:3001/auth -X POST

# Check nginx proxy
curl https://yourdomain.com/api/db/auth -X POST

# Open in browser
open https://yourdomain.com

Project Structure

├── server.js              # Express.js backend API (auth, DB, OG images)
├── package.json
├── .env.example           # Environment variables template
├── public/
│   ├── index.html         # Full SPA frontend (single file)
│   ├── HaradrimGodMode.png
│   ├── favicon.ico
│   └── ...                # Icons, manifest
├── db/
│   └── schema.sql         # PostgreSQL schema (6 tables)
├── nginx/
│   ├── godmode.conf       # Nginx site config template
│   └── crawler-map.conf   # User-agent detection for OG
├── systemd/
│   └── godmode-api.service
└── README.md

Database Tables

Table	Purpose
wallets	Wallet metadata, risk scores, tags, funder info
tokens	Token mint metadata
scans	Bundle detection scan results
scan_holders	Individual holder data per scan
wallet_tags	Flexible tagging (BUNDLER, etc.)
wallet_checks	Wallet check history with full HTML results

License

MIT — free to use, modify, distribute.

Author

@netvyxe

Support: bags.fm/s64RinoknMmndiAMH2hcFC4yRJkT58VeMT93jJFBAGS