[LOADING_MARKETS...]
> TECHNICAL_DOCUMENTATION
Permissionless crypto-native commerce infrastructure on Base
[MISSION] Doing to protected IP what Bitcoin did to money. CC0 Company enables merchants to deploy tokenized stores in <5 minutes with automatic Brand Coin creation via Zora Protocol.
DEPLOYMENT_TIME
<5min
PLATFORM_FEES
0%
NETWORK
BASE
ARCHITECTURE
HYBRID
> 1. ARCHITECTURE_OVERVIEW
[TECH_STACK]
FRONTEND:
- → Next.js 14 (App Router)
- → RainbowKit + wagmi + viem
- → Tailwind CSS
- → Deployed on Vercel
BACKEND:
- → Medusa v2
- → PostgreSQL
- → SendGrid (emails)
- → Deployed on Railway
BLOCKCHAIN:
- → Base Network (L2)
- → Zora Protocol (tokens)
- → OnchainKit (Coinbase)
SERVICES:
- → GeckoTerminal (price feeds)
- → Zora API (token data)
- → Cloudinary (media storage)
[SYSTEM_DIAGRAM]
┌─────────────────────────────────────────────┐
│ USER INTERFACE (Next.js) │
│ + Base Network │
└─────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────┐
│ MERCHANT STORES │
│ • Subdomain routing │
│ • Independent carts │
│ • Custom payment tokens │
│ • Real-time pricing │
└─────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────┐
│ MEDUSA V2 BACKEND │
│ • Multi-tenant architecture │
│ • Sales channel isolation │
│ • Order processing │
└─────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────┐
│ BLOCKCHAIN LAYER (BASE) │
│ • Payment processing │
│ • Token trading │
│ • Fee distribution │
└─────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────┐
│ ZORA PROTOCOL │
│ • Brand Coin creation │
│ • Trading infrastructure │
│ • Fee collection │
└─────────────────────────────────────────────┘> 2. STORE_DEPLOYMENT_PROCESS
[DEPLOYMENT_FLOW]
STEP_1:
Merchant Onboarding
- → Connect Base wallet (RainbowKit)
- → Fill store details (name, subdomain, description)
- → Configure Brand Coin (name, symbol, supply)
- → Upload logo/banner (Cloudinary)
- → Time: ~2 minutes
STEP_2:
Backend Processing
- → Create Medusa sales channel
- → Store merchant data in PostgreSQL
- → Generate unique subdomain
- → Time: ~30 seconds
STEP_3:
Zora Token Creation
- → Deploy ERC-20 token on Base via Zora
- → Set merchant as token creator
- → Configure 5% trading fee
- → Time: ~2-3 minutes
STEP_4:
Store Activation
- → Store goes live at merchant.cc0co.xyz
- → Brand Coin tradable on Zora
- → Merchant dashboard enabled
- → Payment processing active
[TOTAL_TIME]
~5 MINUTES
From wallet connection to fully operational store with tradable Brand Coin
> 3. PAYMENT_SYSTEM
[ACCEPTED_TOKENS]
STABLECOINS:
- → USDC (primary)
- → DAI
CRYPTO:
- → ETH
- → WETH
MEMECOINS:
- → $DICKBUTT
- → $MFER
- → $BOME
CONTENT_COINS:
Any Brand Coin created on the platform. Cross-store payments enabled.
[REAL_TIME_PRICING]
Price Feed Sources:
- → GeckoTerminal API: Major tokens & memecoins
- → Zora API: Content Coins
- → Cache duration: 60 seconds
- → Fallback: Last known price on API failure
Checkout Flow:
- Customer adds products to cart
- Total calculated in USD
- Customer selects payment token
- Real-time price conversion displayed
- Customer sends exact token amount
- Transaction verified onchain
- Order created automatically
[ZERO_FEES]
Platform fees on sales:0%
Payment processing fees:0%
Monthly subscription:$0
Merchant receives:100% of sales
Gas fees paid by customers (Base = ultra-low cost)
> 4. CONTENT_COIN_SYSTEM
[WHAT_ARE_CONTENT_COINS]
Content Coins (Brand Coins) are ERC-20 tokens automatically created for each merchant store via Zora Protocol. They represent store brand value, enable community ownership, serve as speculative assets, and function as alternative payment methods.
TOKEN_PARAMETERS:
- → Standard: ERC-20
- → Network: Base
- → Initial supply: Configurable
- → Trading fee: 5%
- → Creator: Merchant wallet
USE_CASES:
- → Speculation & trading
- → Community ownership
- → Payment method
- → Loyalty rewards (future)
- → Governance (future)
[TRADING_FEE_DISTRIBUTION]
Zora V4 Trading Model:
Trading fees are collected on every swap via Uniswap V4 hooks and automatically distributed to stakeholders
How It Works:
- → Fees collected automatically on each trade
- → Distributed to multiple stakeholders (creator, platform, protocol)
- → Converted to final payout currency (multi-hop swaps)
- → Sent directly to recipients (no manual claiming)
[MERCHANT_REWARDS]
Merchants receive 100% of Platform Referrer rewards from all trading activity on their CC0 Coin
Additional Benefits:
- → Passive income from token trading
- → No liquidity provision required
- → Automatic fee conversion to payout currency
- → Real-time distribution on every swap
[TOKEN_STATS]
Real-time data displayed on all store pages:
PRICE_USD
$0.05
MARKET_CAP
$50K
VOLUME_24H
$5K
HOLDERS
250
Updates every 60 seconds via Zora API
> 5. MERCHANT_DASHBOARD
[FEATURES]
ORDERS_MANAGEMENT:
- → Real-time order tracking
- → Customer details
- → Transaction verification
- → Order status updates
- → CSV export
STORE_SETTINGS:
- → Edit store info
- → Logo & banner upload
- → Social links
- → Payment tokens config
- → Shipping options
TOKEN_ANALYTICS:
- → Real-time price
- → Market cap tracking
- → Trading volume
- → Holder count
- → Trading fee earnings
PRODUCT_MANAGEMENT:
- → Add/edit/delete products
- → Image upload (Cloudinary)
- → Price management (USD)
- → Inventory tracking
- → SEO optimization
[ACCESS_CONTROL]
- → Wallet signature authentication (SIWE)
- → Sales channel isolation via Medusa
- → No cross-merchant data access
- → Session management with JWT
> 6. SECURITY_AND_TRUST
AUTHENTICATION
- → Sign-In With Ethereum (SIWE)
- → Signature-based (no passwords)
- → JWT session management
- → Wallet ownership verification
PAYMENT_SECURITY
- → Onchain verification
- → Transaction receipts stored
- → No platform custody
- → Direct merchant payments
DATA_PRIVACY
- → Minimal data collection
- → No KYC required
- → Wallet pseudonymity
- → GDPR compliant
SMART_CONTRACTS
- → Zora Protocol (audited)
- → No custom contracts
- → Base network security
- → Reduced attack surface
> 7. API_DOCUMENTATION
[PUBLIC_ENDPOINTS]
GET /api/stores/:subdomain
Retrieve store information and stats
{
"id": "store_123",
"name": "Merchant Store",
"subdomain": "merchant",
"content_coin_address": "0x...",
"zora_stats": {
"symbol": "BRAND",
"price_usd": 0.05,
"market_cap": 50000,
"volume_24h": 5000,
"holders": 250
}
}GET /api/stores/:subdomain/products
List all products for a store
{
"products": [{
"id": "prod_456",
"title": "Product Name",
"price_usd": 29.99,
"images": ["https://..."],
"inventory": 100
}],
"pagination": { "total": 42, "page": 1 }
}GET /api/tokens/:address/stats
Get real-time token statistics
{
"address": "0x...",
"symbol": "BRAND",
"price_usd": 0.05,
"market_cap": 50000,
"volume_24h": 5000,
"holders": 250,
"price_change_24h": 12.5
}[MERCHANT_ENDPOINTS]
Authentication required via JWT token
POST /api/stores/:id/products
Create new product
Authorization: Bearer {jwt_token}
{
"title": "New Product",
"description": "...",
"price_usd": 29.99,
"images": ["base64_or_url"],
"inventory": 100
}GET /api/stores/:id/orders
Retrieve store orders
Authorization: Bearer {jwt_token}
{
"orders": [{
"id": "order_789",
"total_usd": 59.98,
"payment_token": "USDC",
"tx_hash": "0x...",
"status": "pending"
}]
}> 8. INFRASTRUCTURE
[FRONTEND]
Platform: Vercel
Key Variables:
NEXT_PUBLIC_MEDUSA_BACKEND_URL
NEXT_PUBLIC_BASE_CHAIN_ID=8453
NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID
NEXT_PUBLIC_ZORA_API_KEY
NEXT_PUBLIC_CLOUDINARY_CLOUD_NAME
Features: Edge functions, automatic scaling, global CDN
[BACKEND]
Platform: Railway
Key Variables:
DATABASE_URL=postgresql://...
REDIS_URL=redis://...
MEDUSA_BACKEND_URL
JWT_SECRET
ZORA_API_KEY
SENDGRID_API_KEY
Database: PostgreSQL with connection pooling
[DOMAIN_CONFIG]
Type Name Target
A @ [Vercel IP]
CNAME api [Railway URL]
CNAME * [Vercel] (wildcard for merchant subdomains)
[SCALING_STRATEGY]
CURRENT (V3):
- → Vercel Edge (auto-scaling)
- → Railway Hobby ($5/mo)
- → Shared PostgreSQL
- → Cloudinary CDN
FUTURE:
- → Separate DB cluster
- → Redis caching layer
- → Load balancing
- → Railway Pro plan
> 9. ROADMAP
[Q4_2025]
PLATFORM:
- ✅ V3 Launch (merchant stores + tokens)
- 🔄 Mobile PWA
- 🔄 Advanced search & discovery
- 🔄 Analytics dashboard v2
TOKENS:
- 🔄 CC0 governance token
- 🔄 Token utility features
- 🔄 Deflationary burn
[Q1_2026]
SCALING:
- → Cross-chain support (Ethereum)
- → Fiat on-ramp (Coinbase Pay)
- → Wholesale/B2B tier
- → Third-party API integrations
COMMUNITY:
- → DAO governance structure
- → Merchant grant program
- → Bug bounty program
- → Expanded dev docs
[LONG_TERM_VISION]
Mission: Become the Shopify of crypto-native commerce
10K+
Merchant Stores
$100M+
Annual GMV
#1
CC0 Marketplace
STD
Tokenized Commerce
> 10. COMPETITIVE_ADVANTAGES
01
One time fee
Low deployment fee of 0.005ETH
02
ZERO PLATFORM FEES
No cut from sales. No monthly subscriptions. No payment processing fees. 100% to merchants.
03
AUTOMATIC TOKENIZATION
5-minute deployment. Zero code required. No smart contract expertise. Passive income from trading fees.
04
NATIVE BASE INTEGRATION
Optimized for Base. Low gas fees. Coinbase ecosystem. Easy fiat on-ramps. Early mover advantage.
05
CC0 PHILOSOPHY
Copyright-free. Maximum content spread. Permissionless remixing. Cultural propagation. Community-first.
> 11. BASE_ECOSYSTEM_CONTRIBUTION
[WHY_GRANTS]
→
Native Base Builder: 100% of transactions on Base. Promotes Base adoption. Showcases low-cost infrastructure.
→
Innovative Use Case: Novel tokenized commerce model. Onchain reputation system. Real-world crypto utility.
→
Ecosystem Growth: Onboards new users to Base. Drives Zora Protocol usage. Increases transaction volume.
→
Open Source Potential: Can open-source deployment tools. Shareable templates. Educational resources.
→
Community Building: CC0 philosophy aligns with open-source ethos. Build-in-public approach.
> 12. CONTACT_AND_RESOURCES
NETWORK
[CONTRIBUTING]
Ways to contribute to the ecosystem:
- → Deploy a merchant store
- → Provide UX feedback
- → Report bugs
- → Build integrations
- → Create SDK/libraries
- → Share on social media
