Serverz

serverz.tribewarez.com

A server hub and gateway for the TribeWarez ecosystem. Serverz provides a terminal-style landing page with wallet connection, X Connect OAuth, and Solana token reward claims.

Features

Wallet Connection

Supports MetaMask / EVM wallet connection with a fallback mock connection for testing. After connecting, users see the connected view with ecosystem links and status.

X Connect + Token Claim

Integrated X (Twitter) OAuth flow:

1. Click Connect X to start the OAuth handshake
2. Authorize the TribeWarez app on X
3. Connect a Solana wallet
4. Claim 1000 NMTC + 1000 PTtC (one-time per X account)

Claimed user IDs are tracked server-side to prevent duplicate claims.

Terminal UI

CRT-style retro interface with:

• Grain overlay and scanline effects
• Neon accent colors
• Typing animation in the header
• Dark theme throughout

Ecosystem Navigation

Links to all TribeWarez products:

• Hub (hub.tribewarez.com)
• Mystic Numbers (mystic.tribewarez.com)
• Terminal (terminal.tribewarez.com)
• DeFi Portal (defi.tribewarez.com)
• Social channels (X, Telegram)
• Pump.fun token pages

Tech Stack

Layer	Technology
Framework	Next.js 16, React 19
UI	Tailwind CSS, Radix UI, Lucide icons
Forms	React Hook Form, Zod
Blockchain	Solana web3.js, SPL Token, bs58
Runtime	Bun

API Routes

Server-side API routes handle the X OAuth flow:

Route	Purpose
GET /api/x-auth/authorize	Redirects to X OAuth consent screen
GET /api/x-auth/callback	Processes OAuth callback, stores tokens
POST /api/x-auth/claim	Sends NMTC + PTtC to user's Solana wallet
POST /api/x-auth/webhook	X webhook CRC verification handler

Key Components

Component	Purpose
app/page.tsx	Main hub page, connect/disconnect logic
terminal-header.tsx	Header with typing animation and connect button
disconnected-view.tsx	Pre-connect state with branding
connected-view.tsx	Post-connect state with ecosystem links

Docker

Built with a Bun-based Dockerfile. Exposed internally and routed via VIRTUAL_HOST=serverz.tribewarez.com.