Skip to content

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧊 Xworth — Claim Your X Worth

A viral "Crypto Twitter Worth" calculator + token claim system built on Base.

Users enter their X username → get a CT worth calculation → claim tokens from a depleting global supply → share flex cards → drive virality.


🚀 Quick Start

Prerequisites

  • Node.js 18+
  • npm

Run Locally

# 1. Start the backend
cd server
npm install
node server.js

# 2. Start the frontend (new terminal)
cd client
npm install
npx vite

📁 Project Structure

xworth/
├── client/                  # React + Vite + Tailwind frontend
│   ├── src/
│   │   ├── components/      # All UI components
│   │   ├── hooks/           # useSocket, useWallet
│   │   ├── utils/           # API + contract utilities
│   │   └── App.jsx          # Main app
│   └── ...
├── server/                  # Express + Socket.io backend
│   ├── models/              # MongoDB schemas
│   ├── routes/              # API endpoints
│   ├── services/            # Twitter + worth calculator
│   └── server.js            # Entry point
├── contract/                # Solidity smart contract
│   └── Xworth.sol           # ERC-20 on Base
└── README.md

⚙️ Tech Stack

Layer Technology
Frontend React, Vite, Tailwind CSS v4
Animations Framer Motion
Backend Express, Socket.io
Database MongoDB (with in-memory fallback)
Blockchain Base (ERC-20, ethers.js)
Sharing html2canvas

🔗 API Endpoints

Method Endpoint Description
POST /api/worth Calculate user worth
POST /api/claim Submit a token claim
GET /api/claims/recent Recent claims feed
GET /api/claims/leaderboard Top 10 claimers
GET /api/claims/stats Global statistics

🪙 Tokenomics

Allocation Percentage Amount
Claim Pool 70% 7,000,000,000
Liquidity 29% 2,900,000,000
Creator 1% 100,000,000
Total 100% 10,000,000,000
  • ✅ No mint after deploy
  • ✅ 0% tax
  • ✅ Verified contract
  • ✅ Base chain

🚀 Deployment

Frontend (Vercel)

cd client
npx vercel

Backend (Render)

  1. Push server/ to GitHub
  2. Create new Web Service on Render
  3. Set environment variables:
    • MONGO_URI — MongoDB Atlas connection string
    • CLIENT_URL — Your Vercel frontend URL
    • PORT — 3001

Smart Contract (Remix)

  1. Open Remix IDE
  2. Copy contract/Xworth.sol
  3. Compile with Solidity 0.8.20+
  4. Deploy to Base network
  5. Constructor args: (liquidityWallet, creatorWallet)
  6. Verify on BaseScan

MongoDB Atlas

  1. Create free cluster at MongoDB Atlas
  2. Get connection string
  3. Set as MONGO_URI env var

📈 Launch Strategy

Launch Thread Template

🧵 THREAD: Just built something wild.

1/ Enter your X username
2/ See what you're worth in crypto
3/ Claim $XWORTH tokens before supply runs out

Total supply: 10,000,000,000
Every claim reduces what's left.
Late = less tokens.

Check yours 👇
[LINK]

Reply Strategy

  • Reply to big CT accounts: "checked your worth 👀 you'd be surprised"
  • Attach personalized screenshots
  • Use FOMO: "supply already 20% claimed"

⚠️ Disclaimer

This is a fun experiment. Not financial advice. No guarantees of returns. Crypto is volatile — only invest what you can afford to lose. DYOR.


Built with 💜 on Base

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages