KnowMint

第一个 AI 智能体可以直接使用 SOL 进行自主支付的知识市场。

人类在此发布隐性知识、经验见解和经过实战检验的解决方案。AI 智能体（如 Claude Code、ElizaOS、AgentKit）通过 x402 协议自主发现、评估并购买这些内容——通过非托管的 Solana P2P 转账直接向卖家支付。平台不持有任何私钥。

同时提供“人在回路”（Human-in-the-loop）模式：智能体进行搜索并提出建议，由你进行确认。同样的市场，你可以选择不同的自主级别。

三种访问层级：Web UI / CLI (km) / REST API + MCP 服务器

Web UI

CLI / MCP (面向 AI 智能体)

为什么选择 KnowMint

• 首个面向智能体支付的市场 — AI 智能体通过 x402 协议自主使用 SOL 支付。无需人工干预即可完成购买

• x402 自主购买 — HTTP 402 + Solana P2P 直接转账。智能体端到端地完成发现、支付和获取知识的过程

• 支持“人在回路”模式 — 智能体提出建议，你来确认。同样的市场，你可以选择不同的自主级别

• 人类 → AI 知识供给 — 出售 AI 无法自行生成的经验性和隐性知识

• 非托管支付 — Solana 上的买家对卖家 P2P 直接转账（平台不托管资金）

面向 AI 智能体

获取 API Key

对于 AI 智能体（基于钱包，无需 Web UI）：

1. POST /api/v1/auth/challenge，请求体为 { "wallet": "<base58>", "purpose": "register" }

2. 使用你的 Solana 钱包对返回的 message 进行签名

3. POST /api/v1/auth/register，请求体为 { "wallet", "signature", "nonce" }

4. 接收 { "api_key": "km_...", "user_id", "wallet" } — 即可使用

对于人类用户（Web UI）：

1. 在 knowmint.shop（或你自托管的实例）注册

2. 进入 Profile → API Keys

3. 创建一个具有 read 或 write 权限的密钥

4. 复制密钥 — 它仅显示一次

MCP 服务器

添加到 ~/.claude/mcp.json：

{
  "mcpServers": {
    "knowmint": {
      "command": "npx",
      "args": ["--yes", "--package", "@knowmint/mcp-server@0.1.2", "mcp-server"],
      "env": {
        "KM_BASE_URL": "https://knowmint.shop"
      }
    }
  }
}

初始设置无需 API Key。 智能体可以使用 km_register 自行注册。

自行注册（无需预先拥有账户）

1. 准备一个 Solana 密钥对文件（例如 ~/.config/solana/id.json）

2. 使用密钥对路径调用 km_register — 该工具会自动处理挑战、签名和注册过程

3. API Key 会被保存到 ~/.km/config.json 并用于后续所有调用

km_register(keypair_path: "~/.config/solana/id.json")
  → POST /api/v1/auth/challenge (get nonce)
  → Sign message with keypair
  → POST /api/v1/auth/register (get API key)
  → Saved to ~/.km/config.json — ready to use

重新登录现有账户：km_wallet_login(keypair_path: "...")。

工具参考

x402 自主购买流程

km_get_content()
  → HTTP 402 (payment_required)
  → Solana transfer
  → Retry with payment_proof
  → Content returned

安全性：请勿将配置文件放置在公共仓库或同步目录中。定期轮换密钥。

• 仅搜索和阅读 (km_search / km_get_detail / km_get_content) → 使用 read 权限密钥

• 购买和发布 (km_purchase / km_publish) → 使用 write 权限密钥

CLI (km)

独立的 Node.js CLI。配置存储在 ~/.km/config.json 中。

自行注册

# Register with an existing Solana keypair (creates account + saves API key)
km register --keypair ~/.config/solana/id.json

# Register with auto-generated keypair (new wallet created automatically)
km register

# Re-login to an existing account
km wallet-login --keypair ~/.config/solana/id.json

使用方法

km login --base-url https://knowmint.shop   # Manual API key input (if already have one)
km search "prompt engineering"
km install <knowledge_id> --tx-hash <solana_tx_hash> --deploy-to claude
km publish prompt ./prompt.md --price 0.5SOL --tags "seo,marketing"
km my purchases

--deploy-to claude,opencode 可将购买的知识自动部署到你的工具中。

查看 cli/README.md 获取完整文档。

面向人类用户

Web UI 采用复古 RPG 风格设计（灵感来自《勇者斗恶龙》）。人类用户可以：

• 发布 带有 SOL 定价、预览和标签的知识

• 浏览 包含提示词、工具定义、数据集和 API 的市场

• 购买 使用 Phantom 或 Solflare 钱包

• 追踪 个人仪表板上的销售、购买和反馈记录

快速开始

先决条件：Node.js 22.6+ / npm

git clone https://github.com/Sou0327/knowmint.git
cd knowmint
npm install

# Start local Supabase (applies migrations automatically)
npx supabase start

# Copy and fill environment variables
cp .env.local.example .env.local

# Start dev server
npm run dev   # http://localhost:3000

所需环境变量

可选（生产环境推荐）

智能体插件

Coinbase AgentKit (packages/agentkit-plugin/)

面向 AgentKit 智能体的 ActionProvider<WalletProvider> 插件。

cd packages/agentkit-plugin && npm install && npm run build

5 个操作：km_search / km_get_detail / km_purchase / km_get_content / km_publish

ElizaOS (packages/eliza-plugin/)

面向 ElizaOS 框架的插件。

cd packages/eliza-plugin && npm install && npm run build

import { knowmintPlugin } from "@knowmint/eliza-plugin";

const character = {
  plugins: [knowmintPlugin],
  settings: {
    KM_API_KEY: "km_xxx",
    KM_BASE_URL: "https://knowmint.shop", // optional
  },
};

操作：SEARCH_KNOWLEDGE / PURCHASE_KNOWLEDGE / GET_CONTENT 提供者：trending-knowledge（前 5 名注入到上下文中）

API 概览

大多数端点受 withApiAuth 保护（API Key 认证 + 速率限制）。 完整参考：docs/openapi.yaml / docs/api-guidelines.md

认证（无需 API Key）

知识

用户

技术栈

测试

# Unit tests (202 tests, Mocha/Chai)
npm run test:unit

# Component tests (Vitest)
npm run test:components

# Staging integration tests (requires supabase start)
npm run test:staging

# E2E tests
npm run test:e2e:fake-tx        # Fake transaction rejection
npm run test:e2e:cli-flow       # CLI flow (login/search/install/publish/deploy)
npm run test:e2e:cli-purchase   # CLI purchase flow
npm run test:e2e:x402-flow      # HTTP 402 payment gate
npm run test:e2e:devnet         # Devnet SOL transfer → purchase → content

有关使用完整购买流程进行本地 devnet 测试的信息，请参阅 本地 Devnet 测试指南。

部署

通过 opennextjs-cloudflare 部署到 Cloudflare Workers。

npm run build:cf    # Build + strip @vercel/og WASM
npm run deploy:cf   # Deploy to production

CI/CD (.github/workflows/deploy.yml)：

• 推送到 main → 自动部署到生产环境 Worker

• 创建 PR → 自动部署到预览 Worker

• 关闭 PR → 删除预览 Worker

贡献

1. Fork 本仓库

2. 创建功能分支 (git checkout -b feature/my-feature)

3. 提交你的更改

4. 推送到分支并开启 Pull Request

许可证

MIT