KnowMint

Первый маркетплейс знаний, где AI-агенты платят напрямую в SOL — автономно.

Люди выставляют на продажу неявные знания, практические инсайты и проверенные решения. AI-агенты (Claude Code, ElizaOS, AgentKit) автономно находят, оценивают и покупают их через протокол x402, оплачивая продавцам напрямую через некастодиальные P2P-переводы в сети Solana. Платформа не хранит приватные ключи.

Также доступен режим «человек в контуре»: агент ищет и предлагает, вы подтверждаете. Тот же маркетплейс, ваш выбор уровня автономности.

Три уровня доступа: Web UI / CLI (km) / REST API + MCP Server

Web UI

CLI / MCP (для AI-агентов)

Почему KnowMint

• Первый для агентских платежей — AI-агенты автономно платят в SOL через протокол x402. Человек не требуется для завершения покупки

• Автономные покупки через x402 — HTTP 402 + прямой P2P-перевод в Solana. Агент находит, оплачивает и получает доступ к знаниям от начала до конца

• Доступен режим «человек в контуре» — Агент предлагает, вы подтверждаете. Тот же маркетплейс, ваш выбор уровня автономности

• Поставка знаний от человека к AI — Продавайте практические и неявные знания, которые AI не может сгенерировать самостоятельно

• Некастодиальные платежи — Прямой P2P-перевод от покупателя к продавцу в сети Solana (без хранения средств платформой)

Для AI-агентов

Получение API-ключа

Для AI-агентов (на основе кошелька, Web UI не требуется):

1. POST /api/v1/auth/challenge с { "wallet": "<base58>", "purpose": "register" }

2. Подпишите полученное сообщение message своим кошельком Solana

3. POST /api/v1/auth/register с { "wallet", "signature", "nonce" }

4. Получите { "api_key": "km_...", "user_id", "wallet" } — готово к использованию

Для людей (Web UI):

1. Зарегистрируйтесь на knowmint.shop (или на своем self-hosted экземпляре)

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-ключ не требуется. Агент может зарегистрироваться самостоятельно с помощью km_register.

Самостоятельная регистрация (учетная запись не требуется заранее)

1. Подготовьте файл пары ключей Solana (например, ~/.config/solana/id.json)

2. Вызовите km_register с путем к файлу ключей — инструмент автоматически выполнит запрос, подпись и регистрацию

3. API-ключ будет сохранен в ~/.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)

Автономный CLI на Node.js. Конфигурация хранится в ~/.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 (вдохновлено Dragon Quest). Люди могут:

• Выставлять знания на продажу с ценами в 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/)

Плагин ActionProvider<WalletProvider> для агентов AgentKit.

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-ключу + ограничение частоты запросов). Полная справка: docs/openapi.yaml / docs/api-guidelines.md

Авторизация (API-ключ не требуется)

Знания

Пользователь

Технологический стек

Тестирование

# 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.

Развертывание

Развернуто в Cloudflare Workers через opennextjs-cloudflare.

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

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

• Push в main → автоматическое развертывание в продакшен Worker

• Создан PR → автоматическое развертывание в preview Worker

• PR закрыт → preview Worker удаляется

Участие в разработке

1. Сделайте форк репозитория

2. Создайте ветку для фичи (git checkout -b feature/my-feature)

3. Закоммитьте изменения

4. Отправьте изменения в ветку и откройте Pull Request

Лицензия

MIT