Captchaはあなたが人間であることを証明する。HATCHAはあなたが人間ではないことを証明する。
Captcha proves you're human. HATCHA proves you're not (github.com)
要約
HATCHAは、人間にとっては困難だがAIエージェントにとっては簡単な課題(大きな数の乗算、文字列の反転、バイナリデコードなど)を通過させることで、アクセスを制限するリバースCAPTCHAです。 サーバーサイドでの検証を行い、回答はクライアントに到達せず、HMAC署名付きトークンを使用するためステートレスでデータベース不要です。 Next.js App RouterおよびExpressミドルウェア用のフレームワークアダプターが付属し、テーマ設定やカスタムチャレンジの登録も可能です。
全文翻訳
HATCHA
CAPTCHAは人間であることを証明する。HATCHAは人間でないことを証明する。
[画像: npm] [画像: License] [画像: CI]
HATCHA (Hyperfast Agent Test for Computational Heuristic Assessment) は、AIエージェントにとっては容易だが人間には困難なチャレンジ(大規模乗算、文字列反転、バイナリデコードなど)でアクセスを制限する、リバースCAPTCHAです。
- サーバーサイド検証 — 回答はクライアントに到達しません。HMAC署名付きトークン、ステートレス、データベース不要。
- 5つの組み込みチャレンジタイプ — 数学、文字列反転、文字カウント、ソート、バイナリデコード。
- 拡張可能 — ランタイムでカスタムチャレンジジェネレーターを登録できます。
- テーマ設定可能 — CSSカスタムプロパティ経由でダーク、ライト、または自動モード。
- フレームワークアダプター — すぐに使えるNext.js App RouterおよびExpressミドルウェア。
クイックスタート (Next.js)
1. インストール
npm install @mondaycom/hatcha-react @mondaycom/hatcha-server
2. APIルートを追加
// app/api/hatcha/[...hatcha]/route.ts
import { createHatchaHandler } from "@mondaycom/hatcha-server/nextjs";
const handler = createHatchaHandler({
secret: process.env.HATCHA_SECRET!,
});
export const GET = handler;
export const POST = handler;
3. レイアウトをラップ
// app/layout.tsx
import { HatchaProvider } from "@mondaycom/hatcha-react";
import "@mondaycom/hatcha-react/styles.css";
export default function RootLayout({ children }) {
return (
<html lang="en">
<body>
<HatchaProvider>{children}</HatchaProvider>
</body>
</html>
);
}
4. 検証をトリガー
"use client";
import { useHatcha } from "@mondaycom/hatcha-react";
function AgentModeButton() {
const { requestVerification } = useHatcha();
return (
<button
onClick={() =>
requestVerification((token) => {
console.log("Agent verified!", token);
})
}
>
Agent Modeに入る
</button>
);
}
5. シークレットを設定
# .env.local
HATCHA_SECRET=your-random-secret-here
仕組み
クライアント サーバー
│ │
│ GET /api/hatcha/challenge │
│────────────────────────────────►│
│ │ チャレンジを生成
│ │ 回答をハッシュ化
│ │ { hash, expiry } をHMAC署名
│ { challenge (回答なし), token }
│◄────────────────────────────────│
│ │
│ エージェントがチャレンジを解く │
│ │
│ POST /api/hatcha/verify │
│ { answer, token }
│────────────────────────────────►│
│ │ HMAC署名を検証
│ │ 有効期限を確認
│ │ 回答ハッシュを比較
│ { success, verificationToken }
│◄────────────────────────────────│
回答はクライアントに到達しません。署名付きトークンは不透明で、ハッシュ化された回答と有効期限のみを含みます。検証はステートレスで、データベースは不要です。
チャレンジタイプ
| タイプ | アイコン | 内容 | 時間制限 |
|---|---|---|---|
math | × | 5桁 × 5桁の乗算 | 30秒 |
string | ↔ | 60-80文字のランダムな文字列を反転 | 30秒 |
count | # | 約250文字中の特定文字をカウント | 30秒 |
sort | ⇅ | 15個の数値をソートし、k番目に小さい値を返す | 30秒 |
binary | 01 | バイナリオクテットをASCIIにデコード | 30秒 |
カスタムチャレンジ
import { registerChallenge } from "@mondaycom/hatcha-server";
registerChallenge({
type: "hex",
generate() {
const n = Math.floor(Math.random() * 0xffffff);
return {
display: {
type: "hex",
icon: "0x",
title: "Hex Decode",
description: "この16進数を10進数に変換してください。",
prompt: `0x${n.toString(16).toUpperCase()}`,
timeLimit: 30,
answer: String(n),
},
answer: String(n),
};
},
});
テーマ設定
HATCHAは --hatcha-* でスコープされたCSSカスタムプロパティを使用します。これらは任意の親要素でオーバーライドできます。
[data-hatcha-theme] {
--hatcha-accent: #3b82f6;
--hatcha-accent-light: #60a5fa;
--hatcha-bg: #060b18;
--hatcha-fg: #e4eaf6;
--hatcha-success: #22c55e;
--hatcha-danger: #ef4444;
}
<HatchaProvider> または <Hatcha> に theme="dark"、theme="light"、または theme="auto" を渡します。
Express
import express from "express";
import { hatchaRouter } from "@mondaycom/hatcha-server/express";
const app = express();
app.use(express.json());
app.use("/api/hatcha", hatchaRouter({ secret: process.env.HATCHA_SECRET! }));
app.listen(3000);
パッケージ
| パッケージ | 説明 |
|---|---|
@mondaycom/hatcha-core | チャレンジ生成と暗号検証 |
@mondaycom/hatcha-react | Reactコンポーネント、プロバイダー、スタイル |
@mondaycom/hatcha-server | Next.jsおよびExpressサーバーハンドラー |
開発
git clone https://github.com/mondaycom/HATCHA.git
cd HATCHA
pnpm install
pnpm build
cd examples/nextjs-app
pnpm dev
貢献
貢献を歓迎します!セットアップ手順とガイドラインについては、CONTRIBUTING.md を参照してください。