KnowMint

AI 에이전트가 SOL로 직접 결제하는 최초의 지식 마켓플레이스 — 자율적으로 작동합니다.

인간은 암묵적 지식, 경험적 통찰, 검증된 솔루션을 등록합니다. AI 에이전트(Claude Code, ElizaOS, AgentKit)는 x402 프로토콜을 통해 자율적으로 이를 발견, 평가 및 구매하며, 비수탁형 Solana P2P 전송을 통해 판매자에게 직접 결제합니다. 플랫폼은 개인 키를 보유하지 않습니다.

인간 개입(Human-in-the-loop) 모드도 제공됩니다: 에이전트가 검색하고 제안하면 사용자가 승인합니다. 동일한 마켓플레이스에서 원하는 자율성 수준을 선택할 수 있습니다.

세 가지 액세스 계층: 웹 UI / CLI (km) / REST API + MCP 서버

웹 UI

CLI / MCP (AI 에이전트용)

KnowMint를 선택해야 하는 이유

• 에이전트 결제 최초 도입 — AI 에이전트가 x402 프로토콜을 통해 SOL로 자율 결제합니다. 구매 완료를 위해 인간이 개입할 필요가 없습니다.

• x402 자율 구매 — HTTP 402 + Solana P2P 직접 전송. 에이전트가 지식을 찾고, 결제하고, 처음부터 끝까지 액세스합니다.

• 인간 개입 모드 지원 — 에이전트가 제안하고 사용자가 승인합니다. 동일한 마켓플레이스에서 원하는 자율성 수준을 선택할 수 있습니다.

• 인간 → AI 지식 공급 — AI가 스스로 생성할 수 없는 경험적이고 암묵적인 지식을 판매합니다.

• 비수탁형 결제 — Solana 기반의 구매자-판매자 간 P2P 직접 전송 (플랫폼 보관 없음)

AI 에이전트를 위한 안내

API 키 발급받기

AI 에이전트용 (지갑 기반, 웹 UI 불필요):

1. { "wallet": "<base58>", "purpose": "register" }와 함께 POST /api/v1/auth/challenge 호출

2. 반환된 message에 Solana 지갑으로 서명

3. { "wallet", "signature", "nonce" }와 함께 POST /api/v1/auth/register 호출

4. { "api_key": "km_...", "user_id", "wallet" } 수신 — 즉시 사용 가능

인간용 (웹 UI):

1. knowmint.shop (또는 직접 호스팅한 인스턴스)에서 가입

2. 프로필 → API 키로 이동

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)

독립형 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를 참조하십시오.

인간을 위한 안내

웹 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 키 인증 + 속도 제한)로 보호됩니다. 전체 참조: 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 테스트 가이드를 참조하십시오.

배포

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. 저장소 포크

2. 기능 브랜치 생성 (git checkout -b feature/my-feature)

3. 변경 사항 커밋

4. 브랜치 푸시 및 Pull Request 열기

라이선스

MIT