### 스캔 기록

최근 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)

// Example Solidity code showing tx.origin abuse
// This function returns different values based on who calls it
function balanceOf(address account) public view returns (uint256) {
    if (tx.origin == account) {
        return _balances[account];
    } else {
        return _balances[account] * 1000; // Fake inflated balance
    }
}
``````solidity
function balanceOf(address account) public view returns (uint256) {
    if (tx.origin != account) return 0;  // 🚩 HONEYPOT
    return _balances[account];
}

#### 📊 **실제 성능**

1000개 이상의 계약을 대상으로 한 테스트 결과:
- **민감도**: 98% (알려진 허니팟의 98% 탐지)
- **특이도**: 97% (오탐률 3%에 불과)
- **허니팟의 평균 패턴 수**: 4.2
- **안전한 토큰의 평균 패턴 수**: 0.1

### 경계 사례 및 한계

**놓칠 수 있는 경우:**
- ❌ 아직 패턴에 포함되지 않은 새로운 기법
- ❌ 난독화된 코드나 프록시 계약
- ❌ 시간 기반 허니팟 (X일 후 활성화)
- ❌ 업그레이드 가능한 계약 (소유자가 나중에 허니팟 추가 가능)

**스캔하지 않는 항목:**
- 재진입 취약점
- 플래시론 익스플로잇
- 소유권 위험
- 유동성 잠금
- 중앙집중화 문제

**결론**: HoneypotScan은 하나의 작업, 즉 **판매 차단 허니팟 토큰 탐지**에 특화되어 있습니다. 포괄적인 보안을 위해서는 전문 감사관에게 문의하세요.

## 🔐 보안 기능

HoneypotScan은 전체 스택에 걸쳐 **보안 우선 아키텍처**로 구축되었습니다:

### 🛡️ 입력 보안

| 기능 | 구현 | 보호 방식 |
|---------|---------------|------------|
| **EIP-55 체크섬 검증** | @noble/hashes를 사용한 적절한 keccak256 | 주소 변조 공격 방지 |
| **형식 검증** | 정규식 + 길이 검사 (0x + 40자리 16진수) | 처리 전 잘못된 입력 거부 |
| **입력 정제** | 공백 제거, 소문자 변환, 문자 필터링 | 인젝션에 대한 심층 방어 |
| **크기 제한** | 최소 50자, 최대 2MB 계약 코드 | 대용량 페이로드를 통한 DoS 방지 |

### 🌐 네트워크 보안

| 기능 | 구현 | 보호 방식 |
|---------|---------------|------------|
| **콘텐츠 보안 정책** | 모든 페이지에 엄격한 CSP 헤더 | XSS, 클릭재킹, 데이터 인젝션 방지 |
| **CORS 화이트리스트** | 허용 목록에 대한 출처 검증 | 알 수 없는 도메인의 무단 API 사용 차단 |
| **속도 제한** | IP당 요청 제한 (30회/분) | 남용 방지 및 공정한 사용 보장 |
| **요청 타임아웃** | AbortController를 사용한 10초 타임아웃 | 요청 중단 및 리소스 고갈 방지 |

**CORS 허용 출처:**```
https://honeypotscan.com
https://www.honeypotscan.com
https://honeypotscan.pages.dev
http://localhost:3000 (development)

### 🔐 책임 있는 공개

보안 문제를 발견하셨나요? 비공개로 신고해 주세요:
- **이메일**: [email protected]
- **제목**: "HoneypotScan 보안 문제"
- **응답 시간**: 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개 카테고리로 사용합니다:

- ✅ **Core ERC20 남용** - balanceOf/allowance/transfer 내 tx.origin (3개 패턴)
- ✅ **숨겨진 헬퍼** - _taxPayer, _isSuper와 tx.origin (2개 패턴)
- ✅ **인증 우회** - require/if/assert/mapping 내 tx.origin (4개 패턴)
- ✅ **전송 차단** - 판매 제한, 화이트리스트, 95-100% 세금 (4개 패턴)

**탐지 임계값**: 허니팟 분류의 95% 신뢰도를 위해 **2개 이상의 패턴** 필요.

👉 자세한 패턴 설명은 위의 [탐지 알고리즘](#-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)
- [보안 기능](#-security-features) - 보안 아키텍처 및 개인정보 보호 관행
- [탐지 알고리즘](#-detection-algorithm) - 패턴 탐지 작동 방식
- [변경 로그](https://github.com/teycir/honeypotscan/blob/HEAD/CHANGELOG.md)

## 🤝 기여하기

기여를 환영합니다! 이슈를 제출하거나 풀 리퀘스트를 보내주세요.

1. 저장소를 포크합니다.
2. 기능 브랜치를 생성합니다 (`git checkout -b feature/amazing-feature`)
3. 변경 사항을 커밋합니다 (`git commit -m 'Add amazing feature'`)
4. 브랜치에 푸시합니다 (`git push origin feature/amazing-feature`)
5. 풀 리퀘스트를 엽니다.

## 📝 라이선스

Business Source License 1.1 - [LICENSE](https://github.com/teycir/honeypotscan/blob/HEAD/LICENSE) 파일 참조

**추가 사용 허가**: 비생산적 사용은 무료입니다. 생산적 사용은 상용 라이선스가 필요합니다.

**변경 날짜**: 2030-01-30 (MIT 라이선스로 전환)

## ❓ FAQ

<details>
<summary><strong>허니팟 토큰이란 무엇인가요?</strong></summary>

허니팟은 구매는 가능하지만 판매를 막도록 설계된 사기 토큰입니다. 사기꾼들은 스마트 계약 코드에서 다양한 트릭을 사용하여 자금을 가둡니다.
</details>

<details>
<summary><strong>HoneypotScan의 정확도는 얼마나 되나요?</strong></summary>

HoneypotScan은 13가지 특수 패턴과 2개 이상 일치 시 임계값을 사용하여 98%의 민감도(허니팟의 98%를 탐지)와 97%의 특이도(오탐률 3%에 불과)를 달성합니다. 자세한 내용은 [탐지 알고리즘](#-detection-algorithm) 섹션을 참조하세요. 높은 정확도를 자랑하지만 어떤 스캐너도 100% 완벽하지는 않으므로 항상 DYOR(직접 조사)하세요.
</details>

<details>
<summary><strong>어떤 블록체인이 지원되나요?</strong></summary>

현재: 이더리움, 폴리곤, 아비트럼. 더 많은 체인이 곧 추가될 예정입니다.
</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은 재정적 조언이 아닙니다.

## 👤 저자

**Teycir Ben Soltane**
- 웹사이트: [teycirbensoltane.tn](https://teycirbensoltane.tn)
- GitHub: [@Teycir](https://github.com/Teycir)

---

## 💼 고용 문의

맞춤형 블록체인 도구, 보안 스캐너 또는 웹 애플리케이션이 필요하신가요? 프리랜서 프로젝트를 수락합니다.

**제공하는 서비스:**
- 스마트 계약 분석 도구
- DeFi 대시보드 및 트레이딩 인터페이스
- 개인정보 보호 중심 웹 애플리케이션
- Cloudflare Workers 및 엣지 컴퓨팅 솔루션
- 풀스택 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>