Knoww

Knoww

Polymarket を活用した、自分のオッズを知るための予測市場プラットフォームです。

機能

• Polymarket のリアルタイム市場データ
• Reown AppKit による複数ウォレットのサポート
• カテゴリ別の閲覧：政治、スポーツ、金融、暗号資産
• 価格チャート付きのイベントおよび市場の詳細表示
• 内部ペーパートレーディングエージェントのダッシュボードと管理 API
• Cloudflare Workers へのエッジデプロイ

クイックスタート

前提条件

• Node.js 20.19+（または 22.x）
• pnpm
• Reown Cloud Project ID

apps/agent で作業する場合は、このパッケージのテストスクリプトで使われる node --experimental-strip-types をサポートする最新の Node.js リリースを使用してください。

セットアップ

# Install dependencies
pnpm install

# Seed the Next.js environment file used by `pnpm dev:web`
cp apps/web/.env.local.example apps/web/.env.local

# Seed the Wrangler/Worker environment file used by `pnpm preview`
# and by local Cloudflare-style bindings such as D1/cron vars
cp apps/web/.dev.vars.example apps/web/.dev.vars

# Add required local variables
$EDITOR apps/web/.env.local
# Add Worker/runtime variables when you need preview mode, agent admin flows,
# or parity with Cloudflare bindings
$EDITOR apps/web/.dev.vars
# Required beyond the example file:
# NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID
#
# The example file already includes:
# NEXT_PUBLIC_POLY_BUILDER_CODE
# NEXT_PUBLIC_POLYMARKET_HOST
# NEXT_PUBLIC_POLYMARKET_WS_HOST
# NEXT_PUBLIC_POLYMARKET_CHAIN_ID
# POLY_RELAYER_API_KEY
# POLY_RELAYER_API_KEY_ADDRESS
#
# Common optional vars for local parity:
# NEXT_PUBLIC_APP_URL, NEXT_PUBLIC_POSTHOG_PROJECT_TOKEN,
# NEXT_PUBLIC_POSTHOG_HOST, POSTHOG_PROJECT_API_KEY, POSTHOG_HOST,
# OPENROUTER_API_KEY, EXTENSION_SESSION_SECRET,
# BUILDER_SIGNING_SERVER_URL, INTERNAL_AUTH_TOKEN,
# ALCHEMY_API_KEY, POLYGON_RPC_URL, COINMARKET_API_KEY

# Run the web app
pnpm dev:web

http://localhost:8000 を開いてください。

pnpm dev:web は apps/web/.env.local を読み込みます。pnpm preview と Cloudflare Worker ランタイムは apps/web/.dev.vars を読み込みます。ローカルの D1／エージェントの cron 設定もここに記述します。

拡張機能の開発

# Configure the extension environment
cp apps/extension/.env.example apps/extension/.env

# Optional overrides:
# DEV_MODE=false        # point the built extension at production
# POLY_BUILDER_CODE=... # builder attribution code for extension orders
# WALLETCONNECT_PROJECT_ID=... # required for WalletConnect/mobile wallet QR flows

# Run the web app locally for extension API calls
pnpm dev:web

# In a second terminal, run the extension build in watch mode
pnpm dev:ext

開発時、拡張機能はデフォルトで http://localhost:8000 を対象にします。ビルド済みの拡張機能から本番環境に接続する場合は、apps/extension/.env で DEV_MODE=false を使用してください。

技術スタック

カテゴリ	技術
フレームワーク	Next.js 15（App Router）
ウォレット	Reown AppKit、Wagmi、Viem
データ	TanStack Query
UI	Shadcn、Tailwind CSS v4、Framer Motion
ツール	BiomeJS、TypeScript
デプロイ	Cloudflare Workers

スクリプト

ルートワークスペースのスクリプト：

pnpm dev:web        # Run the Next.js web app on port 8000
pnpm dev:ext        # Run the extension build in watch mode
pnpm build          # Build all workspace packages
pnpm build:web      # Build the web app only
pnpm build:ext      # Build the extension only
pnpm build:ext:dev  # Build the extension once in development mode
pnpm test           # Run workspace tests where defined
pnpm preview        # Preview the Cloudflare web deployment locally
pnpm lint           # Lint the monorepo
pnpm lint:web       # Lint the web app only
pnpm lint:ext       # Lint the extension only
pnpm format         # Format the monorepo
pnpm typecheck      # Type-check all workspace packages
pnpm typecheck:web  # Type-check the web app only
pnpm typecheck:ext  # Type-check the extension only
pnpm audit:security # Run a high-severity dependency audit
pnpm brand:render   # Render the brand mark asset
pnpm deploy         # Deploy the web app to Cloudflare
pnpm prepare        # Install Husky hooks
pnpm release:ext    # Bump, build, and zip the extension release

パッケージレベルのスクリプトは、ワークスペース内のパッケージにあります：

• apps/web/package.json：dev:turbo、start、soak、soak:assert、cf-typegen、agent:d1:list:local、agent:d1:adopt-runtime-schema:local、agent:d1:adopt-runtime-schema:remote、agent:d1:migrate:local、agent:d1:migrate:remote、test、test:node、test:watch、test:coverage、test:e2e
• apps/extension/package.json：clean、test、test:scoring、benchmark:embeddings、format、version:bump、zip、release
• apps/agent/package.json：build、typecheck、lint、format、test

よく使うテストコマンド：

pnpm --filter @knoww/web test           # Web Vitest suite + node-based tests
pnpm --filter @knoww/web test:watch     # Web Vitest watch mode
pnpm --filter @knoww/web test:coverage  # Web coverage run
pnpm --filter @knoww/web test:e2e       # Web Playwright smoke test
pnpm --filter @knoww/extension test     # Extension scoring tests
pnpm --filter @knoww/agent test         # Agent node tests

ドキュメント

• Cursor 向け Knoww - MCP プラグインのセットアップとマーケットプレイスパッケージ
• docs/ARCHITECTURE.md - アーキテクチャの概要
• docs/API.md - API ルートのリファレンス
• Polymarket ドキュメント
• Reown ドキュメント

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 提出前に pnpm lint を実行します
4. プルリクエストを作成します

ライセンス

AGPL-3.0

---

Soclly が開発しました