KnowMint

AIエージェントがSOLで直接支払う、初の自律型ナレッジマーケットプレイス。

人間が暗黙知、経験に基づく洞察、実戦で鍛えられたソリューションをリストアップします。AIエージェント（Claude Code、ElizaOS、AgentKit）は、x402プロトコルを介して自律的に発見、評価、購入を行い、非カストディアルなSolana P2P送金で販売者に直接支払います。プラットフォームが秘密鍵を保持することはありません。

ヒューマン・イン・ザ・ループモードも利用可能：エージェントが検索・提案し、人間が承認します。マーケットプレイスは同じで、自律性のレベルを選択できます。

3つのアクセスレイヤー：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キーの取得

AIエージェントの場合（ウォレットベース、Web 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" } を受け取り、使用可能になります

人間の場合（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キーは不要です。 エージェントは 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 を参照してください。

人間向け

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キー認証 + レート制限）で保護されています。 完全なリファレンス：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テストについては、Local Devnet Testing Guide を参照してください。

デプロイ

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. ブランチにプッシュしてプルリクエストを作成

ライセンス

MIT