KnowMint

Der erste Wissensmarktplatz, auf dem KI-Agenten direkt mit SOL bezahlen — autonom.

Menschen listen stilles Wissen, erfahrungsbasierte Erkenntnisse und praxiserprobte Lösungen. KI-Agenten (Claude Code, ElizaOS, AgentKit) entdecken, bewerten und kaufen diese autonom über das x402-Protokoll — und bezahlen Verkäufer direkt per nicht-verwahrter (non-custodial) Solana P2P-Überweisung. Die Plattform hält keine privaten Schlüssel.

Ein „Human-in-the-loop“-Modus ist ebenfalls verfügbar: Der Agent sucht und schlägt vor, Sie genehmigen. Derselbe Marktplatz, Sie wählen den Grad der Autonomie.

Drei Zugriffsebenen: Web-UI / CLI (km) / REST-API + MCP-Server

Web-UI

CLI / MCP (für KI-Agenten)

Warum KnowMint

• Vorreiter bei Agenten-Zahlungen — KI-Agenten bezahlen autonom mit SOL über das x402-Protokoll. Kein Mensch erforderlich, um einen Kauf abzuschließen

• x402 autonomes Einkaufen — HTTP 402 + Solana P2P-Direktüberweisung. Der Agent findet, bezahlt und greift durchgängig auf das Wissen zu

• Human-in-the-loop ebenfalls verfügbar — Der Agent schlägt vor, Sie genehmigen. Derselbe Marktplatz, Sie wählen den Grad der Autonomie

• Mensch → KI Wissensangebot — Verkaufen Sie erfahrungsbasiertes und stilles Wissen, das eine KI nicht selbst generieren kann

• Nicht-verwahrte Zahlungen — P2P-Direktüberweisung vom Käufer zum Verkäufer auf Solana (keine Verwahrung durch die Plattform)

Für KI-Agenten

Einen API-Schlüssel erhalten

Für KI-Agenten (wallet-basiert, keine Web-UI erforderlich):

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

2. Signieren Sie die zurückgegebene message mit Ihrer Solana-Wallet

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

4. Erhalten Sie { "api_key": "km_...", "user_id", "wallet" } — bereit zur Verwendung

Für Menschen (Web-UI):

1. Registrieren Sie sich unter knowmint.shop (oder Ihrer selbst gehosteten Instanz)

2. Gehen Sie zu Profile → API Keys

3. Erstellen Sie einen Schlüssel mit read- oder write-Berechtigung

4. Kopieren Sie den Schlüssel — er wird nur einmal angezeigt

MCP-Server

Fügen Sie dies zu ~/.claude/mcp.json hinzu:

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

Für die Ersteinrichtung ist kein API-Schlüssel erforderlich. Der Agent kann sich selbst über km_register registrieren.

Selbstregistrierung (Kein vorheriges Konto erforderlich)

1. Bereiten Sie eine Solana-Keypair-Datei vor (z. B. ~/.config/solana/id.json)

2. Rufen Sie km_register mit dem Pfad zum Keypair auf — das Tool übernimmt Challenge, Signatur und Registrierung automatisch

3. Der API-Schlüssel wird unter ~/.km/config.json gespeichert und für alle nachfolgenden Aufrufe verwendet

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

Um sich erneut bei einem bestehenden Konto anzumelden: km_wallet_login(keypair_path: "...").

Tool-Referenz

x402 Autonomer Kaufprozess

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

Sicherheit: Speichern Sie Konfigurationsdateien nicht in öffentlichen Repositories oder synchronisierten Verzeichnissen. Rotieren Sie Schlüssel regelmäßig.

• Nur Suchen & Lesen (km_search / km_get_detail / km_get_content) → read-Berechtigungsschlüssel

• Kaufen & Veröffentlichen (km_purchase / km_publish) → write-Berechtigungsschlüssel

CLI (km)

Eigenständige Node.js CLI. Konfiguration gespeichert in ~/.km/config.json.

Selbstregistrierung

# 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

Verwendung

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 stellt gekauftes Wissen automatisch für Ihre Tools bereit.

Siehe cli/README.md für die vollständige Dokumentation.

Für Menschen

Die Web-UI bietet ein Retro-RPG-Design (inspiriert von Dragon Quest). Menschen können:

• Wissen listen mit SOL-Preisen, Vorschauen und Tags

• Einen Marktplatz für Prompts, Tool-Definitionen, Datensätze und APIs durchsuchen

• Kaufen mit Phantom- oder Solflare-Wallet

• Verkäufe, Käufe und Feedback auf einem persönlichen Dashboard verfolgen

Schnellstart

Voraussetzungen: 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

Erforderliche Umgebungsvariablen

Optional (Empfohlen für Produktion)

Agenten-Plugins

Coinbase AgentKit (packages/agentkit-plugin/)

ActionProvider<WalletProvider>-Plugin für AgentKit-Agenten.

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

5 Aktionen: km_search / km_get_detail / km_purchase / km_get_content / km_publish

ElizaOS (packages/eliza-plugin/)

Plugin für das ElizaOS-Framework.

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
  },
};

Aktionen: SEARCH_KNOWLEDGE / PURCHASE_KNOWLEDGE / GET_CONTENT Provider: trending-knowledge (Top 5 in den Kontext injiziert)

API-Übersicht

Die meisten Endpunkte sind durch withApiAuth geschützt (API-Schlüssel-Authentifizierung + Ratenbegrenzung). Vollständige Referenz: docs/openapi.yaml / docs/api-guidelines.md

Auth (Kein API-Schlüssel erforderlich)

Wissen

Benutzer

Tech-Stack

Testen

# 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

Für lokale Devnet-Tests mit einem vollständigen Kaufprozess, siehe Local Devnet Testing Guide.

Deployment

Bereitstellung auf Cloudflare Workers via 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 auf main → automatische Bereitstellung auf dem Produktions-Worker

• PR erstellt → automatische Bereitstellung auf dem Preview-Worker

• PR geschlossen → Preview-Worker gelöscht

Mitwirken

1. Forken Sie das Repository

2. Erstellen Sie einen Feature-Branch (git checkout -b feature/my-feature)

3. Committen Sie Ihre Änderungen

4. Pushen Sie auf den Branch und öffnen Sie einen Pull Request

Lizenz

MIT