KnowMint

El primer mercado de conocimiento donde los agentes de IA pagan directamente con SOL — de forma autónoma.

Los humanos listan conocimiento tácito, perspectivas experienciales y soluciones probadas en batalla. Los agentes de IA (Claude Code, ElizaOS, AgentKit) descubren, evalúan y compran de forma autónoma a través del protocolo x402, pagando a los vendedores directamente mediante transferencias P2P de Solana sin custodia. La plataforma no retiene claves privadas.

También disponible el modo humano en el bucle: el agente busca y propone, tú apruebas. El mismo mercado, tu elección del nivel de autonomía.

Tres capas de acceso: Interfaz Web / CLI (km) / API REST + Servidor MCP

Interfaz Web

CLI / MCP (para Agentes de IA)

Por qué KnowMint

• Primero para pagos de agentes — Los agentes de IA pagan de forma autónoma con SOL a través del protocolo x402. No se requiere intervención humana para completar una compra

• Compra autónoma x402 — HTTP 402 + transferencia directa P2P de Solana. El agente encuentra, paga y accede al conocimiento de principio a fin

• Humano en el bucle también disponible — El agente propone, tú apruebas. El mismo mercado, tu elección del nivel de autonomía

• Suministro de conocimiento Humano → IA — Vende conocimiento experiencial y tácito que la IA no puede autogenerar

• Pagos sin custodia — Transferencia directa P2P de comprador a vendedor en Solana (sin custodia de la plataforma)

Para Agentes de IA

Obtención de una clave API

Para agentes de IA (basados en billetera, no se necesita interfaz web):

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

2. Firma el message devuelto con tu billetera de Solana

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

4. Recibe { "api_key": "km_...", "user_id", "wallet" } — listo para usar

Para humanos (interfaz web):

1. Regístrate en knowmint.shop (o en tu instancia autohospedada)

2. Ve a Perfil → Claves API

3. Crea una clave con permiso de read o write

4. Copia la clave — solo se muestra una vez

Servidor MCP

Agrégalo a ~/.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"
      }
    }
  }
}

No se necesita clave API para la configuración inicial. El agente puede autorregistrarse usando km_register.

Autorregistro (No se necesita cuenta previa)

1. Prepara un archivo de par de claves de Solana (ej. ~/.config/solana/id.json)

2. Llama a km_register con la ruta del par de claves — la herramienta maneja el desafío, la firma y el registro automáticamente

3. La clave API se guarda en ~/.km/config.json y se usa para todas las llamadas posteriores

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

Para volver a iniciar sesión en una cuenta existente: km_wallet_login(keypair_path: "...").

Referencia de herramientas

Flujo de compra autónoma x402

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

Seguridad: No coloques archivos de configuración en repositorios públicos o directorios sincronizados. Rota las claves regularmente.

• Solo buscar y leer (km_search / km_get_detail / km_get_content) → clave con permiso read

• Comprar y publicar (km_purchase / km_publish) → clave con permiso write

CLI (km)

CLI de Node.js independiente. Configuración almacenada en ~/.km/config.json.

Autorregistro

# 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

Uso

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 despliega automáticamente el conocimiento comprado en tus herramientas.

Consulta cli/README.md para la documentación completa.

Para Humanos

La interfaz web presenta un diseño estilo RPG retro (inspirado en Dragon Quest). Los humanos pueden:

• Listar conocimiento con precios en SOL, vistas previas y etiquetas

• Navegar por un mercado de prompts, definiciones de herramientas, conjuntos de datos y APIs

• Comprar con la billetera Phantom o Solflare

• Rastrear ventas, compras y comentarios en un panel personal

Inicio rápido

Requisitos previos: 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

Variables de entorno requeridas

Opcional (Recomendado para producción)

Plugins de Agentes

Coinbase AgentKit (packages/agentkit-plugin/)

Plugin ActionProvider<WalletProvider> para agentes de AgentKit.

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

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

ElizaOS (packages/eliza-plugin/)

Plugin para el framework 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
  },
};

Acciones: SEARCH_KNOWLEDGE / PURCHASE_KNOWLEDGE / GET_CONTENT Proveedor: trending-knowledge (los 5 principales inyectados en el contexto)

Descripción general de la API

La mayoría de los endpoints están protegidos por withApiAuth (autenticación con clave API + limitación de tasa). Referencia completa: docs/openapi.yaml / docs/api-guidelines.md

Autenticación (No se requiere clave API)

Conocimiento

Usuario

Stack Tecnológico

Pruebas

# 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

Para pruebas locales en devnet con un flujo de compra completo, consulta la Guía de pruebas locales en Devnet.

Despliegue

Desplegado en Cloudflare Workers a través de 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 a main → despliegue automático al Worker de producción

• PR creado → despliegue automático al Worker de vista previa

• PR cerrado → Worker de vista previa eliminado

Contribución

1. Haz un fork del repositorio

2. Crea una rama de característica (git checkout -b feature/my-feature)

3. Confirma tus cambios

4. Haz push a la rama y abre un Pull Request

Licencia

MIT