Features

Core Capabilities

🔍 Real-Time Follower Detection

Wallet Protect continuously monitors your X account for new followers with configurable polling intervals.

• Instant Detection - New followers identified within seconds

• Configurable Polling - Set your preferred interval (default: 60 seconds)

• Efficient Delta Processing - Only new followers trigger actions

• Rate Limit Aware - Respects X API limitations

// Default configuration
POLL_INTERVAL_MS=60000  // Check every minute
FETCH_LIMIT=100         // Process up to 100 followers per poll

---

🚀 Automatic Token Launching

Every new follower automatically triggers a token launch on pump.fun.

• Deterministic Naming - Token names derived from usernames

• IPFS Metadata - Permanent, decentralized storage

• On-Chain Deployment - Real tokens on Solana mainnet

• Transaction Confirmation - Verified before marking complete

Each token launch costs approximately 0.02-0.05 SOL depending on network conditions.

---

🎨 Custom Branding

Make every token uniquely yours with customizable branding options.

Element	Customization	Default
Token Name	PREFIX_USERNAME	WP_USERNAME
Symbol	XUSERNAME	WUSERNAME
Description	Any text	"Protected by Wallet Protect 🛡️"
Logo	Local file or URL	Your custom logo

---

🛡️ Bulletproof Reliability

Built for production with enterprise-grade reliability features.

Idempotent Operations

Same follower never launches twice, even if the service restarts mid-operation.

Automatic Retry

Failed launches can be safely retried without duplicate tokens.

Graceful Recovery

Service restarts continue from where they left off.

Transaction Safety

Confirms on-chain before updating database status.

---

📊 Complete Audit Trail

Every action is logged for full transparency and debugging.

{
  "action": "LAUNCH_SUCCESS",
  "followerId": "abc-123",
  "details": {
    "tokenAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "signature": "5Uj8...",
    "pumpUrl": "https://pump.fun/7xKXtg..."
  },
  "timestamp": "2024-01-15T12:00:00.000Z"
}

Tracked Events:

• DETECTED - New follower found

• LAUNCH_STARTED - Processing begins

• IPFS_UPLOADED - Metadata stored

• TX_SUBMITTED - Transaction sent

• LAUNCH_SUCCESS - Token live

• LAUNCH_FAILED - Error occurred

• RETRY_SCHEDULED - Retry queued

---

🌐 RESTful API

Full HTTP API for monitoring and management.

Endpoint	Description
GET /health	Service health status
GET /status	Detailed engine metrics
GET /followers	List all tracked followers
GET /followers/:id	Get specific follower details
POST /retry/:id	Retry a failed launch
GET /logs	View audit logs
GET /stats	Launch statistics

---

🐳 Docker Ready

Production-ready containerization included.

docker-compose.yaml

# One command to run everything
docker-compose up -d

• Multi-stage build for minimal image size

• Health checks included

• PostgreSQL service configured

• Volume persistence

• Environment variable support

---

Feature Matrix

╔══════════════════════════════════════════════════════════════════╗
║                    WALLET PROTECT CAPABILITIES                    ║
╠══════════════════════════════════════════════════════════════════╣
║  ✅ Autonomous token launches triggered by X followers            ║
║  ✅ Deterministic metadata generation from usernames              ║
║  ✅ IPFS-hosted metadata via pump.fun infrastructure              ║
║  ✅ PostgreSQL persistence with complete audit trail              ║
║  ✅ Configurable polling intervals (default: 60s)                 ║
║  ✅ Backfill mode for existing followers                          ║
║  ✅ Robust failure handling with safe retry                       ║
║  ✅ RESTful health & status endpoints                             ║
║  ✅ Full TypeScript with strict type safety                       ║
║  ✅ Docker-ready for instant deployment                           ║
║  ✅ Structured JSON logging with Pino                             ║
║  ✅ Zod-validated configuration                                   ║
╚══════════════════════════════════════════════════════════════════╝

---

Coming Soon

These features are planned for future releases.

• 🔔 Webhook Notifications - Get notified on Discord, Slack, or custom endpoints

• 📱 Dashboard UI - Web interface for monitoring and management

• 🎯 Filtering Rules - Only launch for followers matching criteria

• 💰 Buy Support - Optionally buy tokens after launching

• 🔗 Multi-Account - Monitor multiple X accounts simultaneously