### スキャン履歴

最新の10件のスキャンが自動的にローカルに保存されます：
- 以前にスキャンしたコントラクトへ素早くアクセス可能
- サーバー保存なし - 完全なプライバシー
- トークン名、シンボル、スキャンタイムスタンプを含む
- ワンクリックで再スキャンまたは共有機能

### 共有とエクスポート

**URLで結果を共有：**```
https://honeypotscan.com#result=eyJhIjoiMHguLi4ifQ==

**テキストとしてコピー:**```
🔍 HoneypotScan Result
════════════════════════════════════════
Token: Scam Token (SCAM)
Address: 0x...
Chain: Ethereum

Status: 🚨 HONEYPOT DETECTED
Confidence: 95%

⚠️ Patterns Found (3):
  • tx_origin_require (line 123)
  • hidden_sell_tax (line 456)
  • transfer_whitelist_only (line 789)

## 🧬 検出アルゴリズム

HoneypotScanは高度な**静的解析**を使用して、スマートコントラクトのソースコード内の悪意のあるパターンを検出します。当アルゴリズムは、誤検知を最小限に抑えつつ高い精度を実現するように設計されています。

### 動作の仕組み```
1. Input Validation
   └─> EIP-55 checksum validation (keccak256)
   └─> Format verification (0x + 40 hex chars)
   └─> Chain detection (Ethereum/Polygon/Arbitrum)

2. Contract Source Retrieval
   └─> Fetch from Etherscan API
   └─> 6 API keys with intelligent rotation
   └─> 10-second timeout protection
   └─> Zod schema validation

3. Code Sanitization
   └─> Remove comments and whitespace
   └─> Normalize line endings
   └─> Verify Solidity structure
   └─> Size validation (50 chars - 2MB)

4. Pattern Matching
   └─> Run 13 specialized regex patterns
   └─> Each pattern detects specific honeypot techniques
   └─> Record all matches

5. Confidence Scoring
   └─> ≥2 patterns = HONEYPOT (95% confidence)
   └─> 1 pattern = SUSPICIOUS (needs review)
   └─> 0 patterns = SAFE (100% confidence)

#### 2️⃣ **隠れたヘルパー関数（2パターン）**

選択的な販売を可能にする内部関数：

| パターン | 説明 | リスク |
|---------|-------------|------|
| `hidden_fee_taxPayer` | `_taxPayer()`ヘルパーはtx.originを使用 | 非オリジナルバイヤーを対象とした隠れた税金ロジック |
| `isSuper_tx_origin` | `_isSuper()`ヘルパーはtx.originを使用 | スキャマーのみが販売できるホワイトリスト機能 |

#### 3️⃣ **認証バイパス（4パターン）**

`tx.origin`をアクセス制御に使用（危険なパターン）：

| パターン | 説明 | リスク |
|---------|-------------|------|
| `tx_origin_require` | `require()`文がtx.originをチェック | DEXルーターからのトランザクションをリバート |
| `tx_origin_if_auth` | `if`文でtx.originを使用して認証 | 再販をブロックする条件付きロジック |
| `tx_origin_assert` | `assert()`文がtx.originをチェック | 非オリジナルトランザクションでハードフォールバック |
| `tx_origin_mapping` | `[tx.origin]`によるマッピングアクセス | 元の呼び出し元に基づく追跡/ブラックリスト化 |

**なぜtx.originは危険なのか:**
- Uniswap経由で購入する場合: `tx.origin = YOUR_WALLET` ✅
- Uniswap経由で売却する場合: `tx.origin = YOUR_WALLET`、しかし `msg.sender = UNISWAP_ROUTER` ❌
- ハニーポットはこの違いを悪用して、購入を許可しながら売却をブロックします

#### 4️⃣ **転送制限（4パターン）**

直接的な売却ブロックメカニズム：

| パターン | 説明 | リスク |
|---------|-------------|------|
| `sell_block_pattern` | `_isSuper(recipient)`がfalseを返す | ホワイトリストに登録されていないアドレスへの売却を明示的にブロック |
| `asymmetric_transfer_logic` | `_canTransfer()`が常にfalseを返す | 最初の購入後のすべての転送を防止 |
| `transfer_whitelist_only` | 送信者と受信者の両方がホワイトリストに登録されている必要がある | スキャマーのみがトークンを移動可能 |
| `hidden_sell_tax` | DEXペアロジックで95～100%の売却税 | 売却時にトークンを完全に吸い取る |

### なぜしきい値は2なのか？

**当社の検出しきい値は、ハニーポットの分類にパターンマッチが2以上であることを必要とします。** その理由は以下のとおりです。

#### ✅ **誤検出の低減**
- 単一のパターンは、正当なコントラクトで偶然現れることがある
- 2つ以上のパターンは**意図的な悪意のある設計**を示す
- 例：コントラクトが1つの`tx.origin`チェック（安全）を持つ場合があるが、2つ以上は組織的な悪用を示す

#### ✅ **高い精度の維持**
- 当社のテストでは、ハニーポットは通常**3～7個のパターン**を示す
- 正当なコントラクトはほとんど1つ以上のパターンを示さない
- しきい値2は**感度と特異性の最適なバランス**

#### ✅ **信頼レベル**```
0 patterns  = 100% Safe (no suspicious code)
1 pattern   = Needs Review (possibly safe anti-bot measures)
2+ patterns = 95% Honeypot (intentional malicious design)

### 🔒 API セキュリティ

| 機能 | 実装 | 保護 |
|---------|---------------|------------|
| **APIキーのローテーション** | 6つのEtherscanキーをランダム選択 | 負荷を分散し、単一キーの枯渇を防止 |
| **スキーマバリデーション** | 全てのAPIレスポンスにZodバリデーション | 不正なデータによるランタイムエラーを防止 |
| **エラーのサニタイズ** | ユーザーへは汎用的なエラーメッセージ | 情報漏洩を防止 |
| **構造化ログ** | タイムスタンプとメタデータを含むJSONログ | デバッグとセキュリティ監視のための監査証跡 |

### 🏗️ インフラストラクチャ セキュリティ

| 機能 | 実装 | 保護 |
|---------|---------------|------------|
| **ハードコードされたシークレットなし** | 全ての認証情報は環境変数経由 | リポジトリ内でのシークレット露出を防止 |
| **Cloudflare Workers** | 分離実行によるエッジコンピューティング | DDoS保護と自動スケーリング |
| **TTL付きKVキャッシュ** | 自動期限切れ（24時間） | 古いデータによる攻撃を防止 |
| **OAuth認証** | デプロイメント用Cloudflare OAuthトークン | コード内のAPIキーなしでCI/CDを保護 |

### 🔍 コード セキュリティ

| 機能 | 実装 | 保護 |
|---------|---------------|------------|
| **TypeScript 厳格モード** | 完全な厳格モードでのコンパイル | コンパイル時に型エラーを検出 |
| **防御的な配列アクセス** | アクセス前のundefinedチェック | ランタイムクラッシュを防止 |
| **正規表現の安全性** | パターン内の制限付き量指定子 | ReDoS攻撃を緩和 |
| **eval()やFunction()なし** | 純粋な静的解析 | コードインジェクションを防止 |

### 🚨 保存しないもの

**プライバシー最優先設計：データを一切収集しません。**
- ❌ ユーザーアカウントや認証はありません
- ❌ スキャン履歴やログはありません
- ❌ レート制限以外のIPアドレストラッキングはありません（インメモリ、毎分クリア）
- ❌ Cookieやブラウザフィンガープリンティングはありません
- ❌ 分析やサードパーティトラッカーはありません

**スキャンは完全に匿名です。**

### 📋 セキュリティヘッダー

すべてのレスポンスには以下が含まれます：```http
Content-Security-Policy: default-src 'self'; script-src 'self' 'unsafe-inline' 'unsafe-eval'; 
  style-src 'self' 'unsafe-inline'; img-src 'self' data: https:; 
  font-src 'self' data:; connect-src 'self' https://honeypotscan-api.teycircoder4.workers.dev; 
  frame-ancestors 'none'; base-uri 'self'; form-action 'self'
X-Frame-Options: DENY
X-Content-Type-Options: nosniff
Referrer-Policy: no-referrer
Permissions-Policy: camera=(), microphone=(), geolocation=()

### APIの使い方```bash
# Scan a token contract
curl "https://your-worker.workers.dev/api/scan?address=0x...&chain=ethereum"

# Response format
{
  "isHoneypot": true,
  "confidence": "high",
  "patterns": ["tx.origin abuse", "hidden fees"],
  "riskScore": 85,
  "cached": false
}

## 📈 スケーリング

**無料枠の容量:**
- 1日あたり10万リクエスト (Cloudflare Workers)
- 1日あたり10万回の読み取り (Cloudflare KV)
- 1日あたり260万APIコール (Etherscan)
- **キャッシュヒット率95%の場合: 1日あたり200万スキャン**

**コスト: 月額0ドル** 🎉

## 🛠️ 技術スタック

- **フロントエンド**: Next.js 16, React 19, Tailwind CSS v4, Framer Motion
- **バックエンド**: Cloudflare Workers
- **キャッシュ**: Cloudflare KV
- **スキャナー**: TypeScript (カスタムパターン検出)
- **API**: Etherscan, Polygonscan, Arbiscan
- **デプロイ**: Cloudflare Pages + Workers

## 🧪 テスト```bash
# Run contract scanner tests
npm run test:scan

# Test specific contract
tsx test/scan-contracts.ts 0x...

# Debug pattern detection
tsx test/debug-pattern.ts