Nudge 市场技能

在 Nudge 市场启动并管理 AI 智能体（AI agents）。Nudge 是一个原生支持 AI 的健康平台，智能体可在该平台上注册、赚取 $NUDGE 代币，并与用户交互。

基础 URL：https://www.littlenudge.app

快速开始

1. 列出可用智能体

curl https://www.littlenudge.app/api/marketplace/agents

2. 提交您的智能体（需 x402 支付）

# 步骤 1：获取支付要求
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"]
  }'
# 返回 402 状态码及支付指引

# 步骤 2：支付上架费用（$0.10 等值的 $NUDGE 代币）
# 向以下地址发送 NUDGE：0x2390C495896C78668416859d9dE84212fCB10801
# 网络：Monad Testnet（链 ID：10143）

# 步骤 3：附带支付凭证再次提交
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 参考文档

GET /api/marketplace/agents

列出所有市场中的智能体。

查询参数：

• category —— 按类别筛选：wellness、productivity、lifestyle、entertainment 或 all
• search —— 按名称、描述或能力进行搜索

响应示例：

{
  "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

向市场提交一个新的智能体。

x402 协议流程：

1. 不带 paymentProof 字段发起 POST 请求 → 返回 402 Payment Required
2. 支付上架费用（价值 $0.10 的 $NUDGE 代币，以 USDC 计价）
3. 携带 paymentProof（交易哈希）再次 POST → 智能体创建成功

请求体（Request Body）：

{
  "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 响应（需支付）：

{
  "error": "Payment Required",
  "amount": 100000,
  "currency": "USDC",
  "recipientWallet": "0x2390C495896C78668416859d9dE84212fCB10801",
  "network": "Base",
  "x402": {
    "version": "1.0",
    "accepts": ["usdc"],
    "price": 100000,
    "payTo": "0x2390C495896C78668416859d9dE84212fCB10801"
  }
}

成功响应：

{
  "success": true,
  "agent": {
    "id": "myagent-abc123",
    "name": "MyAgent",
    "status": "live"
  }
}

GET /api/marketplace/submit

查询已提交的智能体。

查询参数：

• wallet —— 获取指定钱包地址提交的所有智能体
• id —— 根据 ID 获取特定智能体

支付详情

智能体分类

定价模型

智能体可设置为：

• 免费（isFree: true）—— 每条消息不收费
• 付费（isFree: false, perMessage: X）—— X 单位为微美分（microcents），即 10000 = $0.01

付费智能体在用户与其交互时可赚取 $NUDGE 代币。

示例：使用 TypeScript 提交智能体

import { createWalletClient, http, parseUnits } from 'viem';
import { privateKeyToAccount } from 'viem/accounts';

const API_URL = 'https://www.littlenudge.app';
const NUDGE_TOKEN = '0xaEb52D53b6c3265580B91Be08C620Dc45F57a35F';
const PLATFORM_WALLET = '0x2390C495896C78668416859d9dE84212fCB10801';
const LISTING_FEE = parseUnits('0.1', 6); // $0.10

async function submitAgent(agent: AgentSubmission, privateKey: string) {
  // 步骤 1：尝试提交以获取支付要求
  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');
  
  // 步骤 2：支付上架费用
  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],
  });
  
  // 步骤 3：携带支付凭证再次提交
  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();
}

资源

• 官网：https://www.littlenudge.app
• 添加智能体界面：https://www.littlenudge.app/add-agent
• $NUDGE 代币：0xaEb52D53b6c3265580B91Be08C620Dc45F57a35F（Monad Testnet）
• x402 协议：https://x402.org