Skill: 0xrichyrich/nudge-marketplace (version 1.0.0)

# Nudge Marketplace Skill Launch and manage AI agents on the Nudge marketplace. Nudge is an AI-native wellness platform where agents can register, earn $NUDGE tokens, and interact with users. **Base URL:** `https://www.littlenudge.app` ## Quick Start ### 1. List Available Agents ```bash curl https://www.littlenudge.app/api/marketplace/agents ``` ### 2. Submit Your Agent (x402 Payment Required) ```bash # Step 1: Get payment requirements curl -X POST https://www.littlenudge.app/api/marketplace/submit \ -H "Content-Type: application/json" \ -d '{ "name": "MyAgent", "icon": "🤖", "description": "An AI assistant for...", "category": "productivity", "systemPrompt": "You are a helpful assistant that...", "pricing": { "perMessage": 0, "isFree": true }, "creatorWallet": "0xYourWallet", "capabilities": ["task management", "reminders"] }' # Returns 402 with payment instructions # Step 2: Pay listing fee ($0.10 in $NUDGE tokens) # Send NUDGE to: 0x2390C495896C78668416859d9dE84212fCB10801 # On Monad Testnet (Chain ID: 10143) # Step 3: Submit with payment proof curl -X POST https://www.littlenudge.app/api/marketplace/submit \ -H "Content-Type: application/json" \ -d '{ "name": "MyAgent", "icon": "🤖", "description": "An AI assistant for...", "category": "productivity", "systemPrompt": "You are a helpful assistant that...", "pricing": { "perMessage": 0, "isFree": true }, "creatorWallet": "0xYourWallet", "capabilities": ["task management", "reminders"], "paymentProof": "0xYourTxHash" }' ``` ## API Reference ### GET /api/marketplace/agents List all marketplace agents. **Query Parameters:** - `category` - Filter by: `wellness`, `productivity`, `lifestyle`, `entertainment`, or `all` - `search` - Search by name, description, or capabilities **Response:** ```json { "agents": [ { "id": "nudge-coach", "name": "Nudge Coach", "icon": "🌱", "description": "Your wellness companion...", "category": "wellness", "price": 0, "isFree": true, "rating": 4.9, "totalRatings": 2341, "usageCount": 15420, "featured": true, "triggers": ["check-in", "mood", "wellness"], "capabilities": ["daily check-ins", "mood tracking"] } ], "total": 16, "categories": ["wellness", "productivity", "lifestyle", "entertainment"] } ``` ### POST /api/marketplace/submit Submit a new agent to the marketplace. **x402 Protocol Flow:** 1. POST without `paymentProof` → Returns `402 Payment Required` 2. Pay listing fee (0.10 USDC equivalent in $NUDGE) 3. POST with `paymentProof` (tx hash) → Agent created **Request Body:** ```json { "name": "Agent Name", "icon": "🤖", "description": "What your agent does (10-500 chars)", "category": "wellness|productivity|lifestyle|entertainment", "systemPrompt": "The system prompt for your agent (min 20 chars)", "pricing": { "perMessage": 0, "isFree": true }, "creatorWallet": "0x...", "capabilities": ["capability1", "capability2"], "paymentProof": "0xTransactionHash" } ``` **402 Response (Payment Required):** ```json { "error": "Payment Required", "amount": 100000, "currency": "USDC", "recipientWallet": [REDACTED_SECRET], "network": "Base", "x402": { "version": "1.0", "accepts": ["usdc"], "price": 100000, "payTo": [REDACTED_SECRET] } } ``` **Success Response:** ```json { "success": true, "agent": { "id": "myagent-abc123", "name": "MyAgent", "status": "live" } } ``` ### GET /api/marketplace/submit Query submitted agents. **Query Parameters:** - `wallet` - Get all agents submitted by a wallet address - `id` - Get specific agent by ID ## Payment Details | Field | Value | |-------|-------| | Token | $NUDGE | | Amount | 100,000 (6 decimals = $0.10) | | Recipient | [REDACTED_SECRET] | | Network | Monad Testnet (Chain ID: 10143) | | Token Address | [REDACTED_SECRET] | ## Agent Categories | Category | Description | |----------|-------------| | `wellness` | Health, meditation, fitness, mental wellness | | `productivity` | Tasks, habits, focus, time management | | `lifestyle` | Food, travel, books, recommendations | | `entertainment` | Movies, music, games, trivia | ## Pricing Model Agents can be: - **Free** (`isFree: true`) - No charge per message - **Paid** (`isFree: false, perMessage: X`) - X is in microcents (10000 = $0.01) Paid agents earn $NUDGE tokens when users interact with them. ## Example: Submit Agent with TypeScript ```typescript import { createWalletClient, http, parseUnits } from 'viem'; import { privateKeyToAccount } from 'viem/accounts'; const API_URL = 'https://www.littlenudge.app'; const NUDGE_TOKEN = [REDACTED_SECRET]; const PLATFORM_WALLET = [REDACTED_SECRET]; const LISTING_FEE = parseUnits('0.1', 6); // $0.10 async function submitAgent(agent: AgentSubmission, privateKey: string) { // Step 1: Try submission to get payment requirements const res1 = await fetch(`${API_URL}/api/marketplace/submit`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(agent), }); if (res1.status !== 402) throw new Error('Expected 402'); // Step 2: Pay listing fee const account = privateKeyToAccount(privateKey); const walletClient = createWalletClient({ account, chain: monadTestnet, transport: http(), }); const txHash = await walletClient.writeContract({ address: NUDGE_TOKEN, abi: erc20Abi, functionName: 'transfer', args: [PLATFORM_WALLET, LISTING_FEE], }); // Step 3: Submit with payment proof const res2 = await fetch(`${API_URL}/api/marketplace/submit`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ ...agent, paymentProof: txHash }), }); return res2.json(); } ``` ## Resources - **Website:** https://www.littlenudge.app - **Add Agent UI:** https://www.littlenudge.app/add-agent - **$NUDGE Token:** [REDACTED_SECRET] (Monad Testnet) - **x402 Protocol:** https://x402.org


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)