AI-powered social media monetization intelligence, built on Circle's Agent Stack.
Pay-per-inference. Autonomous payments. Zero crypto knowledge required.
Live at socialmint.org ยท API: health check ยท GitHub
SocialMint Agent analyzes a creator, business owner, influencer, or digital marketer's social media presence and returns specific, actionable monetization intelligence:
- ๐ฆ Products to sell โ physical, digital, or services with real price ranges tailored to your market
- ๐ฌ Content ideas โ hooks, formats, and viral angles that convert followers to buyers
- ๐ฃ Marketing channels โ where to push harder and what specific tactic to use
Every analysis costs 0.50 USDC, charged autonomously from the user's Circle Programmable Wallet on Arc Testnet. No credit cards. No subscriptions. No crypto knowledge needed.
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ socialmint.org โ
โ React + Vite (Vercel) โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ HTTPS
โโโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Express API (Railway) โ
โ โ
โ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโ โ
โ โ Clerk โ โ MongoDB โ โ Rate Limiter + โ โ
โ โ Auth โ โ Atlas โ โ JWT Middleware โ โ
โ โโโโโโโโฌโโโโโโโ โโโโโโโโฌโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโ โ
โ โ โ โ
โ โโโโโโโโผโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ /api/auth/login โ โ
โ โ โข Verify Clerk token โ โ
โ โ โข Create Circle wallet on Arc Testnet (new users) โ โ
โ โ โข Auto-fund wallet via Circle Faucet API โ โ
โ โ โข Save user + wallet to MongoDB โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ /api/analyze โ โ
โ โ 1. Check wallet balance โ Circle API โ โ
โ โ 2. Charge 0.50 USDC โ treasury (Circle transfer API) โ โ
โ โ 3. Call Anthropic Claude Sonnet โ โ
โ โ 4. Save analysis + transaction to MongoDB โ โ
โ โ 5. Return results to user โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โ
โโโโโโโโโโโโโโโโผโโโโโโโโ โโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Circle Wallets API โ โ Anthropic Claude API โ
โ Arc Testnet โ โ claude-sonnet-4-20250514 โ
โ โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โข Wallet creation โ
โ โข Balance checks โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โข USDC transfers โ โ MongoDB Atlas โ
โ โข Faucet auto-fund โ โ โ
โ โข Webhooks โ โ โข users (wallets, freeRunsUsed) โ
โโโโโโโโโโโโโโโโโโโโโโโโโ โ โข analyses (full results history) โ
โ โข transactions (Circle tx ledger) โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Every time a user clicks Analyze this happens autonomously โ no human approves any step:
User signs in with Google / Email OTP
โ
Circle Programmable Wallet auto-created on Arc Testnet
โ
Wallet auto-funded via Circle Faucet API (testnet)
โ
User submits niche + platform + monetization goals
โ
Agent checks wallet balance โ GET /v1/w3s/wallets/{id}/balances
โ
Balance โฅ 0.50 USDC? โ Agent executes transfer
POST /v1/w3s/developer/transactions/transfer
โ
Payment confirmed โ Anthropic Claude Sonnet called
โ
AI returns products, content hooks, marketing strategies
โ
Results + transaction saved to MongoDB permanently
โ
Treasury wallet receives 0.50 USDC ยท User sees results
| Circle API | Endpoint | Purpose |
|---|---|---|
| Wallet creation | POST /v1/w3s/developer/wallets |
One SCA wallet per user on signup |
| Auto-funding | POST /v1/faucet/drips |
Auto-fund new wallets on Arc Testnet |
| Balance checks | GET /v1/w3s/wallets/{id}/balances |
Checked before every analysis |
| USDC transfers | POST /v1/w3s/developer/transactions/transfer |
0.50 USDC per inference call |
| Entity secret | GET /v1/w3s/config/entity/publicKey |
Per-request encryption |
| Webhooks | transfers.complete ยท wallets.created |
Real-time settlement events |
Network: Arc Testnet (ARC-TESTNET)
USDC token: 0x3600000000000000000000000000000000000000
Wallet type: SCA (Smart Contract Account) via Developer-Controlled Wallets
Wallet Set ID: bf6301a4-d50b-5aa1-92ea-e27c575c09cb
Treasury: 0xce67b5c7a1e1e2ef75fad910fa590d97fb046312
All API activity is verifiable in the Circle Developer Console.
| Layer | Technology |
|---|---|
| Frontend | React + Vite โ Vercel |
| Backend | Node.js + Express โ Railway |
| Auth | Clerk (Google OAuth, Email OTP, MetaMask, Coinbase Wallet) |
| Payments | Circle Programmable Wallets (Arc Testnet) |
| AI | Anthropic Claude Sonnet (claude-sonnet-4-20250514) |
| Database | MongoDB Atlas (local db.json fallback for dev) |
| Domain | socialmint.org (Porkbun + Vercel) |
Clerk handles Google OAuth, Email OTP, MetaMask, and Coinbase Wallet. Every user gets a Circle USDC wallet created automatically on first sign-in. No seed phrases. No crypto knowledge needed.
0.50 USDC charged per analysis via Circle's transfer API. The agent checks balance, executes payment, and calls Claude โ all autonomously before returning results.
Claude analyzes niche, audience, platform, and goals and returns platform-specific, market-aware recommendations priced in local currency context.
Pre-built prompts across Nigerian/African niches, business owners, and creators. First 3 are free โ tracked server-side in MongoDB.
Free demo limit enforced at the API level. Clearing browser storage, incognito mode, or different devices cannot reset free runs โ stored per user in MongoDB.
Every paid and free analysis saved permanently. View full results anytime, run again with one click, build on previous insights.
New users on Arc Testnet are auto-funded via Circle Faucet API on wallet creation โ they can use the app immediately without visiting the faucet manually.
| Per call | |
|---|---|
| User pays | 0.50 USDC |
| Anthropic API cost | ~0.008 USDC |
| Gross margin | ~98.4% |
| $5 API credit covers | ~625 analysis calls |
| Revenue at 1,000 users ร 5 analyses/month | 2,500 USDC/month |
The micropayment model is economically viable precisely because USDC on Arc settles at negligible cost โ traditional payment rails (Stripe, PayPal) would consume the entire margin in fees at this price point.
- JWT authentication on all API routes
- Free run limits enforced server-side (MongoDB, not browser)
- Circle Entity Secret registered and encrypted per Circle spec
- Rate limiting on all endpoints (
express-rate-limit) - CORS restricted to production domain (
socialmint.org) - MongoDB Atlas with IP allowlist
- Environment variables never committed (
.gitignore)
SocialMint uses a single environment variable to switch networks:
| Variable | Value | Network |
|---|---|---|
| (default) | โ | Base Sepolia testnet |
USE_ARC=true |
true |
Arc Testnet (current) |
USE_MAINNET=true |
true |
Base Mainnet |
Switching to mainnet requires only setting USE_MAINNET=true in Railway and creating a new mainnet treasury wallet via node setup.js.
# Clone
git clone https://github.com/Angelmykl/socialmint
cd socialmint
# Backend
cd backend
cp .env.example .env
# Fill in your keys (see below)
npm install
node server.js
# Frontend (new terminal)
cd ../frontend
npm install
npm run devCIRCLE_API_KEY=TEST_API_KEY:your-key-id:your-key-secret
ENTITY_SECRET=your-64-char-hex
CIRCLE_WALLET_SET_ID=your-wallet-set-id
CIRCLE_TREASURY_WALLET_ID=your-treasury-wallet-id
CIRCLE_TREASURY_ADDRESS=0xYourTreasuryAddress
ANTHROPIC_API_KEY=sk-ant-your-key
MONGODB_URI=mongodb+srv://...
JWT_SECRET=your-secret
NODE_ENV=development
FRONTEND_URL=http://localhost:5173
USE_ARC=trueVITE_API_URL=http://localhost:4000
VITE_CLERK_PUBLISHABLE_KEY=pk_test_your-keynode -e "console.log(require('crypto').randomBytes(32).toString('hex'))"Register the output in Circle Console โ Keys โ Entity Secret.
node setup.js| Service | Purpose | Config |
|---|---|---|
| Railway | Backend | Root dir: socialmint/backend |
| Vercel | Frontend | Root dir: socialmint/frontend |
| MongoDB Atlas | Database | IP allowlist: 0.0.0.0/0 |
| Clerk | Auth | Production instance, domain: socialmint.org |
| Porkbun | Domain | DNS โ Vercel + Clerk CNAMEs |
Primary: Agentic Economic Activity
SocialMint demonstrates the Agent Stack vision at the consumer layer:
- AI agent autonomously provisions Circle wallets on user signup
- Agent checks balances and executes USDC transfers without human approval
- Pay-per-inference model: 0.50 USDC per Claude call, settled on Arc
- Targeting non-crypto-native users (creators, marketers, business owners) globally
Secondary: Peer-to-peer payments
Each analysis is a direct micropayment from user wallet to treasury wallet, settled on Arc in seconds.
SocialMint Agent is built in phases โ starting with AI monetization intelligence and expanding into a full financial intelligence platform for creators.
- Pay-per-inference AI analysis at 0.50 USDC per call
- Circle Programmable Wallets on Arc Testnet
- Google OAuth + Email OTP via Clerk
- 12 ready-made prompts for creators and business owners
- Server-side free run enforcement via MongoDB
- Full analysis history with View + Run again
- Auto-funding new user wallets on signup
- Switch to Arc Mainnet (
USE_MAINNET=true) - Real USDC payments from real users
- Facebook and Twitter OAuth
- Circle Webhooks for real-time settlement (replacing polling)
- Mobile-responsive polish
The next major feature: an autonomous trading agent that works 24/7 on behalf of users โ even when they are offline.
How it works:
User opens Agent Trade
โ
Agent scans market โ returns top 5-10 low-cap tokens
(market cap, volume, holder count, rug risk indicators)
โ
User sets buy condition:
"Buy 5 USDC of [token] when market cap drops to $500k"
โ
User sets sell condition:
"Sell when market cap reaches $2M"
โ
Agent monitors 24/7 via Circle Programmable Wallet
โ
Condition met โ Agent executes trade autonomously
โ
Fee charged per execution (buy + sell) via USDC
Scanning is always free
Key features:
- Autonomous 24/7 execution โ agent trades while user is offline
- AI-powered rug screening โ flags unverified contracts, unlocked liquidity, whale concentration
- Limit order logic โ buy low, sell high, set and forget
- Per-trade fee model โ charged on execution, not subscription
- Full trade history โ PnL per position, total agent fees, performance tracking
Multi-chain support via Circle Unified Balance:
Agent Trade will leverage Circle's Unified Balance Kit to let users fund their trading wallet from any supported chain โ no manual bridging, no network switching. One USDC balance, accessible everywhere. This makes the product accessible to creators who hold USDC on Base, Ethereum, Arbitrum, or any other Circle-supported chain.
User USDC on Base / Ethereum / Arbitrum
โ
Circle Unified Balance Kit aggregates liquidity
โ
Agent executes trades on Arc using unified balance
โ
Settlement in USDC across chains seamlessly
- SocialMint Yield โ idle USDC in wallets earns yield via Circle's USYC
- SocialMint Pay โ creators accept USDC payments from fans directly via their SocialMint wallet
- SocialMint Analytics โ cross-platform performance dashboard with monetization scoring
- Agent Marketplace โ community-built analysis prompts, buy/sell with USDC
| Live app | https://socialmint.org |
| API health | https://socialmint-production.up.railway.app/api/health |
| GitHub | https://github.com/Angelmykl/socialmint |
| Circle console | console.circle.com (Testnet โ Wallets โ Wallet Set bf6301a4) |
Built with Circle Agent Stack ยท Anthropic Claude ยท MongoDB ยท Deployed on Railway + Vercel ยท Running on Arc Testnet