### Scan History

Ihre letzten 10 Scans werden automatisch lokal gespeichert:
- Schneller Zugriff auf zuvor gescannte Verträge
- Keine Serverspeicherung – vollständige Privatsphäre
- Enthält Token-Name, Symbol und Zeitstempel des Scans
- Ein-Klick-Neuscan oder Freigabefunktion

### Teilen & Exportieren

**Ergebnisse per URL teilen:**```
https://honeypotscan.com#result=eyJhIjoiMHguLi4ifQ==

**Als Text kopieren:**```
🔍 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)

## 🧬 Erkennungsalgorithmus

HoneypotScan verwendet eine fortschrittliche **statische Analyse**, um bösartige Muster im Quellcode von Smart Contracts zu erkennen. Unser Algorithmus ist auf hohe Genauigkeit ausgelegt, während Fehlalarme minimiert werden.

### Funktionsweise```
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)

// Example honeypot code
``````solidity
function balanceOf(address account) public view returns (uint256) {
    if (tx.origin != account) return 0;  // 🚩 HONEYPOT
    return _balances[account];
}

#### 📊 **Leistung in der Praxis**

Basierend auf unseren Tests an über 1000+ Verträgen:
- **Sensitivität**: 98% (erfasst 98% der bekannten Honeypots)
- **Spezifität**: 97% (nur 3% Fehlalarme)
- **Durchschnittliche Muster in Honeypots**: 4.2
- **Durchschnittliche Muster in sicheren Token**: 0.1

### Grenzfälle und Einschränkungen

**Was wir möglicherweise übersehen:**
- ❌ Neuartige Techniken, die noch nicht in unseren Mustern enthalten sind
- ❌ Verschleierter Code oder Proxy-Verträge
- ❌ Zeitbasierte Honeypots (aktivieren sich nach X Tagen)
- ❌ Upgrade-fähige Verträge (Besitzer kann später Honeypot hinzufügen)

**Wonach wir NICHT suchen:**
- Reentrancy-Schwachstellen
- Flash-Kredit-Exploits
- Eigentumsrisiken
- Liquiditätssperren
- Zentralisierungsprobleme

**Fazit**: HoneypotScan ist auf eine Aufgabe spezialisiert – **Erkennung von verkaufsblockierenden Honeypot-Token**. Für umfassende Sicherheitsüberprüfungen konsultieren Sie professionelle Auditoren.

## 🔐 Sicherheitsfunktionen

HoneypotScan ist mit einer **Sicherheit-zuerst-Architektur** über den gesamten Stack hinweg aufgebaut:

### 🛡️ Eingabesicherheit

| Funktion | Implementierung | Schutz |
|---------|---------------|------------|
| **EIP-55-Prüfsummenvalidierung** | Korrektes keccak256 mit @noble/hashes | Verhindert Adressmanipulationsangriffe |
| **Formatvalidierung** | Regex + Längenprüfung (0x + 40 Hex) | Lehnt fehlerhafte Eingaben vor der Verarbeitung ab |
| **Eingabebereinigung** | Trimmen, Kleinschreibung, Zeichenfilterung | Tiefenverteidigung gegen Injektion |
| **Größenbeschränkungen** | Min. 50 Zeichen, max. 2 MB Vertragscode | Verhindert DoS durch übermäßig große Nutzlasten |

### 🌐 Netzwerksicherheit

| Funktion | Implementierung | Schutz |
|---------|---------------|------------|
| **Content Security Policy** | Strenge CSP-Header auf allen Seiten | Verhindert XSS, Clickjacking, Dateneinschleusung |
| **CORS-Whitelist** | Ursprungsvalidierung gegen die erlaubte Liste | Blockiert nicht autorisierte API-Nutzung von unbekannten Domains |
| **Ratenbegrenzung** | Pro-IP-Anfragelimit (30 Anfragen/Min.) | Verhindert Missbrauch und gewährleistet faire Nutzung |
| **Anfragezeitüberschreitung** | 10-Sekunden-Timeout mit AbortController | Verhindert hängende Anfragen und Ressourcenerschöpfung |

**Zugelassene CORS-Ursprünge:**```
https://honeypotscan.com
https://www.honeypotscan.com
https://honeypotscan.pages.dev
http://localhost:3000 (development)

### 🔐 Verantwortungsvolle Offenlegung

Ein Sicherheitsproblem gefunden? Bitte melden Sie es vertraulich:
- **Email**: [email protected]
- **Betreff**: "HoneypotScan Security Issue"
- **Antwortzeit**: 24-48 Stunden

Wir schätzen verantwortungsvolle Offenlegung und werden Sicherheitsforscher in unseren Versionshinweisen nennen.

## 🚀 Schnellstart

### Lokale Entwicklung```bash
# Clone the repository
git clone https://github.com/Teycir/honeypotscan.git
cd honeypotscan

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env.local
# Edit .env.local with your API keys

# Run development server
npm run dev
# Open http://localhost:3000

# Build for production
npm run build

# Deploy to Cloudflare
npm run deploy

## 📊 Erkennungsmuster

HoneypotScan verwendet **13 spezialisierte Muster** in 4 Kategorien:

- ✅ **Kern-ERC20-Missbrauch** - tx.origin in balanceOf/allowance/transfer (3 Muster)
- ✅ **Versteckte Helfer** - _taxPayer, _isSuper mit tx.origin (2 Muster)
- ✅ **Authentifizierungsumgehungen** - tx.origin in require/if/assert/mapping (4 Muster)
- ✅ **Transferblockaden** - Verkaufsbeschränkungen, Whitelists, Steuern von 95-100 % (4 Muster)

**Erkennungsschwelle**: Erfordert **2+ Muster** für 95%ige Konfidenz bei der Honeypot-Klassifizierung.

👉 Siehe detaillierte Mustererklärungen im Abschnitt [Erkennungsalgorithmus](#-detection-algorithm) oben.

## 🔧 Umgebungsvariablen```env
# Etherscan API Keys (6 keys for rotation)
ETHERSCAN_API_KEY_1=your-key-1
ETHERSCAN_API_KEY_2=your-key-2
ETHERSCAN_API_KEY_3=your-key-3
ETHERSCAN_API_KEY_4=your-key-4
ETHERSCAN_API_KEY_5=your-key-5
ETHERSCAN_API_KEY_6=your-key-6

# Cloudflare (for deployment)
CLOUDFLARE_ACCOUNT_ID=your-account-id
CLOUDFLARE_API_TOKEN=your-api-token

## 📚 Dokumentation

- [Schnellstartanleitung](https://github.com/teycir/honeypotscan/blob/HEAD/docs/QUICKSTART.md)
- [Bereitstellungsleitfaden](https://github.com/teycir/honeypotscan/blob/HEAD/docs/DEPLOY.md)
- [Projektübersicht](https://github.com/teycir/honeypotscan/blob/HEAD/docs/PROJECT_SUMMARY.md)
- [Sicherheitsfunktionen](#-security-features) – Sicherheitsarchitektur und Datenschutzpraktiken
- [Erkennungsalgorithmus](#-detection-algorithm) – Wie unsere Mustererkennung funktioniert
- [Changelog](https://github.com/teycir/honeypotscan/blob/HEAD/CHANGELOG.md)

## 🤝 Mitwirken

Beiträge sind willkommen! Reichen Sie gerne Issues oder Pull Requests ein.

1. Repository forken
2. Erstellen Sie Ihren Feature-Branch (`git checkout -b feature/amazing-feature`)
3. Committen Sie Ihre Änderungen (`git commit -m 'Add amazing feature'`)
4. Pushen Sie zum Branch (`git push origin feature/amazing-feature`)
5. Öffnen Sie einen Pull Request

## 📝 Lizenz

Business Source License 1.1 – siehe Datei [LICENSE](https://github.com/teycir/honeypotscan/blob/HEAD/LICENSE)

**Zusätzliche Nutzungserlaubnis**: Die nicht-produktive Nutzung ist kostenlos. Für die produktive Nutzung ist eine kommerzielle Lizenz erforderlich.

**Änderungsdatum**: 2030-01-30 (wird in MIT-Lizenz umgewandelt)

## ❓ FAQ

<details>
<summary><strong>Was ist ein Honeypot-Token?</strong></summary>

Ein Honeypot ist ein Betrugs-Token, der darauf ausgelegt ist, Ihnen den Kauf zu ermöglichen, aber den Verkauf zu verhindern. Betrüger nutzen verschiedene Tricks im Smart-Contract-Code, um Ihr Geld zu sperren.
</details>

<details>
<summary><strong>Wie genau ist HoneypotScan?</strong></summary>

HoneypotScan erreicht eine Sensitivität von 98 % (erfasst 98 % der Honeypots) und eine Spezifität von 97 % (nur 3 % Fehlalarme) unter Verwendung von 13 spezialisierten Mustern mit einem Schwellenwert von 2+ Übereinstimmungen. Weitere Einzelheiten finden Sie im Abschnitt [Erkennungsalgorithmus](#-detection-algorithm). Obwohl sehr genau, ist kein Scanner 100% narrensicher – machen Sie immer Ihre eigene Recherche (DYOR).
</details>

<details>
<summary><strong>Welche Blockchains werden unterstützt?</strong></summary>

Derzeit: Ethereum, Polygon und Arbitrum. Weitere Chains bald verfügbar.
</details>

<details>
<summary><strong>Gibt es ein Ratelimit?</strong></summary>

Keine Ratelimits bei normaler Nutzung. Das intelligente Caching-System bewältigt hohen Datenverkehr effizient.
</details>

<details>
<summary><strong>Können Honeypots immer noch durchrutschen?</strong></summary>

Ja, ausgeklügelte Betrüger können neuartige Techniken einsetzen. HoneypotScan ist ein Hilfsmittel, keine Garantie. Überprüfen Sie immer mit mehreren Quellen.
</details>

## 🌐 Andere Projekte

Sehen Sie sich diese anderen datenschutzorientierten Tools an:

| Projekt | Beschreibung |
|---------|-------------|
| [TimeSeal.online](https://timeseal.online) | Dokumente zeitstempeln und Existenz auf der Blockchain nachweisen |
| [SanctumVault.online](https://sanctumvault.online) | Sichere verschlüsselte Dateispeicherung und -freigabe |
| [Ghost-Chat](https://ghost-chat.pages.dev) | Anonyme verschlüsselte Nachrichtenübermittlung |

## ⚠️ Haftungsausschluss

Dieses Tool dient nur zu Informationszwecken. Machen Sie immer Ihre eigene Recherche (DYOR), bevor Sie in eine Kryptowährung oder einen Token investieren. HoneypotScan ist keine Finanzberatung.

## 👤 Autor

**Teycir Ben Soltane**
- Webseite: [teycirbensoltane.tn](https://teycirbensoltane.tn)
- GitHub: [@Teycir](https://github.com/Teycir)

---

## 💼 Stellen Sie mich ein

Benötigen Sie ein benutzerdefiniertes Blockchain-Tool, einen Sicherheitsscanner oder eine Webanwendung? Ich bin für freiberufliche Projekte verfügbar.

**Dienstleistungen, die ich anbiete:**
- Smart-Contract-Analyse-Tools
- DeFi-Dashboards und Handelschnittstellen
- Datenschutzorientierte Webanwendungen
- Cloudflare Workers & Edge-Computing-Lösungen
- Full-Stack-Entwicklung mit Next.js

<p align="center">
  <a href="https://teycirbensoltane.tn"><strong>🚀 Lassen Sie uns zusammenarbeiten → teycirbensoltane.tn</strong></a>
</p>

---

<p align="center">
  <strong>Mit ❤️ erstellt mit Next.js und Cloudflare</strong>
</p>