### История сканирования

Ваши последние 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)

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

#### 📊 **Реальная производительность**

По результатам нашего тестирования на 1000+ контрактах:
- **Чувствительность**: 98% (выявляет 98% известных honeypot)
- **Специфичность**: 97% (только 3% ложных срабатываний)
- **Среднее количество паттернов в honeypot**: 4.2
- **Среднее количество паттернов в безопасных токенах**: 0.1

### Граничные случаи и ограничения

**Что мы можем пропустить:**
- ❌ Новые методы, ещё не попавшие в наши паттерны
- ❌ Запутанный код или прокси-контракты
- ❌ Временные honeypot (активируются через X дней)
- ❌ Обновляемые контракты (владелец может добавить honeypot позже)

**Что мы НЕ проверяем:**
- Уязвимости повторного входа
- Эксплойты флеш-кредитов
- Риски владения
- Блокировки ликвидности
- Проблемы централизации

**Суть**: HoneypotScan специализируется на одной задаче — **обнаружении токенов honeypot, блокирующих продажу**. Для всесторонней безопасности обращайтесь к профессиональным аудиторам.

## 🔐 Функции безопасности

HoneypotScan построен на **архитектуре безопасности в первую очередь** во всём стеке:

### 🛡️ Входная безопасность

| Характеристика | Реализация | Защита |
|---------|---------------|------------|
| **Проверка контрольной суммы EIP-55** | Правильное keccak256 с использованием @noble/hashes | Предотвращает атаки с манипуляцией адресами |
| **Проверка формата** | Regex + проверка длины (0x + 40 hex) | Отклоняет некорректные входные данные до обработки |
| **Очистка входных данных** | Обрезка, нижний регистр, фильтрация символов | Глубинная защита от инъекций |
| **Ограничения размера** | Мин. 50 символов, макс. 2 МБ кода контракта | Предотвращает DoS через чрезмерно большие полезные нагрузки |

### 🌐 Сетевая безопасность

| Характеристика | Реализация | Защита |
|---------|---------------|------------|
| **Политика безопасности контента (CSP)** | Строгие заголовки CSP на всех страницах | Предотвращает XSS, кликджекинг, внедрение данных |
| **Белый список CORS** | Проверка источника по разрешённому списку | Блокирует несанкционированное использование API с неизвестных доменов |
| **Ограничение частоты запросов** | Лимиты запросов на IP (30 запросов/мин) | Предотвращает злоупотребления и обеспечивает справедливое использование |
| **Тайм-ауты запросов** | 10-секундный тайм-аут с AbortController | Предотвращает зависшие запросы и исчерпание ресурсов |

**Разрешённые источники CORS:**```
https://honeypotscan.com
https://www.honeypotscan.com
https://honeypotscan.pages.dev
http://localhost:3000 (development)

### 🔐 Ответственное раскрытие

Обнаружили проблему безопасности? Пожалуйста, сообщите о ней приватно:
- **Эл. почта**: [email protected]
- **Тема**: "HoneypotScan Security Issue"
- **Время ответа**: 24-48 часов

Мы ценим ответственное раскрытие и будем упоминать исследователей безопасности в наших примечаниях к выпуску.

## 🚀 Быстрый старт

### Локальная разработка```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

## 📊 Шаблоны обнаружения

HoneypotScan использует **13 специализированных шаблонов** в 4 категориях:

- ✅ **Основное злоупотребление ERC20** - tx.origin в balanceOf/allowance/transfer (3 шаблона)
- ✅ **Скрытые помощники** - _taxPayer, _isSuper с tx.origin (2 шаблона)
- ✅ **Обходы аутентификации** - tx.origin в require/if/assert/mapping (4 шаблона)
- ✅ **Блокировки передачи** - Ограничения продаж, белые списки, налоги 95-100% (4 шаблона)

**Порог обнаружения**: Требуется **2+ шаблона** для классификации ханипота с уверенностью 95%.

👉 Подробные объяснения шаблонов см. в разделе [Алгоритм обнаружения](#-detection-algorithm) выше.

## 🔧 Переменные окружения```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

## 📚 Документация

- [Руководство по быстрому старту](https://github.com/teycir/honeypotscan/blob/HEAD/docs/QUICKSTART.md)
- [Руководство по развертыванию](https://github.com/teycir/honeypotscan/blob/HEAD/docs/DEPLOY.md)
- [Сводка проекта](https://github.com/teycir/honeypotscan/blob/HEAD/docs/PROJECT_SUMMARY.md)
- [Функции безопасности](#-функции-безопасности) — Архитектура безопасности и практики конфиденциальности
- [Алгоритм обнаружения](#-алгоритм-обнаружения) — Как работает наше обнаружение шаблонов
- [Журнал изменений](https://github.com/teycir/honeypotscan/blob/HEAD/CHANGELOG.md)

## 🤝 Вклад

Приветствуется вклад! Пожалуйста, не стесняйтесь отправлять issues или pull requests.

1. Форкните репозиторий
2. Создайте ветку функции (`git checkout -b feature/amazing-feature`)
3. Зафиксируйте изменения (`git commit -m 'Add amazing feature'`)
4. Отправьте изменения в ветку (`git push origin feature/amazing-feature`)
5. Откройте Pull Request

## 📝 Лицензия

Business Source License 1.1 — см. файл [LICENSE](https://github.com/teycir/honeypotscan/blob/HEAD/LICENSE)

**Дополнительное разрешение на использование**: Некоммерческое использование бесплатно. Для коммерческого использования требуется коммерческая лицензия.

**Дата изменения**: 2030-01-30 (конвертируется в лицензию MIT)

## ❓ Часто задаваемые вопросы (FAQ)

<details>
<summary><strong>Что такое токен-ловушка (honeypot)?</strong></summary>

Honeypot — это мошеннический токен, который позволяет купить, но препятствует продаже. Мошенники используют различные уловки в коде смарт-контракта, чтобы заблокировать ваши средства.
</details>

<details>
<summary><strong>Насколько точен HoneypotScan?</strong></summary>

HoneypotScan достигает 98% чувствительности (обнаруживает 98% ловушек) и 97% специфичности (только 3% ложных срабатываний) с использованием 13 специализированных шаблонов и порога в 2+ совпадения. См. раздел [Алгоритм обнаружения](#-алгоритм-обнаружения) для подробностей. Хотя инструмент очень точен, ни один сканер не является абсолютно надежным — всегда проводите собственное исследование (DYOR).
</details>

<details>
<summary><strong>Какие блокчейны поддерживаются?</strong></summary>

В настоящее время: Ethereum, Polygon и Arbitrum. Скоро будут добавлены другие сети.
</details>

<details>
<summary><strong>Есть ли ограничение на количество запросов?</strong></summary>

Ограничений на количество запросов при обычном использовании нет. Умная система кэширования эффективно обрабатывает высокий трафик.
</details>

<details>
<summary><strong>Могут ли ловушки быть пропущены?</strong></summary>

Да, опытные мошенники могут использовать новые методы. HoneypotScan — это инструмент для помощи, а не гарантия. Всегда проверяйте информацию из нескольких источников.
</details>

## 🌐 Другие проекты

Ознакомьтесь с другими инструментами, ориентированными на конфиденциальность:

| Проект | Описание |
|--------|----------|
| [TimeSeal.online](https://timeseal.online) | Фиксация времени и подтверждение существования документов в блокчейне |
| [SanctumVault.online](https://sanctumvault.online) | Безопасное зашифрованное хранение и обмен файлами |
| [Ghost-Chat](https://ghost-chat.pages.dev) | Анонимный зашифрованный обмен сообщениями |

## ⚠️ Отказ от ответственности

Этот инструмент предоставляется только в информационных целях. Всегда проводите собственное исследование (DYOR) перед инвестированием в любую криптовалюту или токен. HoneypotScan не является финансовым советом.

## 👤 Автор

**Тейсир Бен Солтан**
- Веб-сайт: [teycirbensoltane.tn](https://teycirbensoltane.tn)
- GitHub: [@Teycir](https://github.com/Teycir)

---

## 💼 Наймите меня

Нужен индивидуальный инструмент для блокчейна, сканер безопасности или веб-приложение? Я доступен для фриланс-проектов.

**Предлагаемые услуги:**
- Инструменты для анализа смарт-контрактов
- DeFi-дашборды и торговые интерфейсы
- Веб-приложения, ориентированные на конфиденциальность
- Cloudflare Workers и решения для граничных вычислений
- Full-stack разработка на Next.js

<p align="center">
  <a href="https://teycirbensoltane.tn"><strong>🚀 Давайте работать вместе → teycirbensoltane.tn</strong></a>
</p>

---

<p align="center">
  <strong>Сделано с ❤️ с использованием Next.js и Cloudflare</strong>
</p>