AML Chainalysis

Open-source crypto address sanctions & risk checker

🚀 Live Demo • Features • Quick Start • Project Structure • Configuration

---

🌐 English

📋 Table of Contents

• Features
• Quick Start
• Tech Stack
• Project Structure
• Configuration
• Contributing
• License

✨ Features

• 🔍 Check crypto wallet addresses against OFAC sanctions and risk indicators.
• 🌐 Multi-network support: Bitcoin, Ethereum, BNB Smart Chain, Polygon, Arbitrum, Optimism, Avalanche, TRON, Solana, Litecoin.
• 🔗 Aggregates results from Chainalysis, Scorechain, GoPlus, and Watchman.
• 🛡️ Risk scoring: Low / Medium / High / Critical.
• 📜 Local check history (current session).
• 🌍 English & Russian UI with persistent language switcher.
• ⚡ Built with Vite + React + TypeScript + Tailwind CSS + shadcn/ui.
• 🚀 Auto-deployed to GitHub Pages via GitHub Actions.

🚀 Quick Start

# 1. Clone the repo
git clone https://github.com/BOSSincrypto/aml-chainalysis.git
cd aml-chainalysis

# 2. Install dependencies
npm install

# 3. Run locally
npm run dev

# 4. Build for production
npm run build

🛠 Tech Stack

Layer	Technology
Framework	React 18 + TypeScript
Bundler	Vite
Styling	Tailwind CSS + shadcn/ui
Icons	Lucide React
Forms	React Hook Form + Zod
API	Vercel serverless functions (Node/TypeScript)
CI/CD	GitHub Actions → GitHub Pages

📁 Project Structure

aml-chainalysis/
├── api/                    # Vercel serverless functions
│   └── check/[address].ts  # Aggregated screening endpoint
├── public/                 # Static assets
├── src/
│   ├── components/ui/      # shadcn/ui components
│   ├── i18n/               # EN/RU translations & language context
│   ├── App.tsx             # Main application
│   └── main.tsx            # Entry point
├── .github/workflows/      # GitHub Pages deployment
├── index.html              # SEO-optimized page shell
├── robots.txt              # Allow all + sitemap reference
├── sitemap.xml             # Sitemap for search engines
├── LICENSE                 # MIT
└── README.md               # This file

⚙️ Configuration

The frontend talks to a backend API endpoint. By default it uses a relative path:

VITE_API_URL=

For local Vercel development set:

VITE_API_URL=http://localhost:3000
CHAINALYSIS_API_KEY=your_chainalysis_key
SCORECHAIN_API_KEY=your_scorechain_key

The API keys are server-side secrets and must be configured in your hosting environment (e.g. Vercel → Environment Variables), never committed to the repo.

🤝 Contributing

1. Fork the repository.
2. Create a feature branch: git checkout -b feat/amazing-feature.
3. Commit your changes: git commit -m "feat: add amazing feature".
4. Push to the branch: git push origin feat/amazing-feature.
5. Open a Pull Request.

📄 License

This project is licensed under the MIT License.

---

🇷🇺 Русский

📋 Содержание

• Возможности
• Быстрый старт
• Стек технологий
• Структура проекта
• Конфигурация
• Участие в проекте
• Лицензия

✨ Возможности

• 🔍 Проверка криптовалютных адресов по санкционным спискам OFAC и индикаторам риска.
• 🌐 Поддержка множества сетей: Bitcoin, Ethereum, BNB Smart Chain, Polygon, Arbitrum, Optimism, Avalanche, TRON, Solana, Litecoin.
• 🔗 Агрегирует данные из Chainalysis, Scorechain, GoPlus и Watchman.
• 🛡️ Оценка риска: Низкий / Средний / Высокий / Критический.
• 📜 Локальная история проверок (в рамках сессии).
• 🌍 Интерфейс на английском и русском языках с переключателем.
• ⚡ Сборка на Vite + React + TypeScript + Tailwind CSS + shadcn/ui.
• 🚀 Автодеплой на GitHub Pages через GitHub Actions.

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

# 1. Клонируйте репозиторий
git clone https://github.com/BOSSincrypto/aml-chainalysis.git
cd aml-chainalysis

# 2. Установите зависимости
npm install

# 3. Запустите локально
npm run dev

# 4. Соберите production-версию
npm run build

🛠 Стек технологий

Уровень	Технология
Фреймворк	React 18 + TypeScript
Сборщик	Vite
Стили	Tailwind CSS + shadcn/ui
Иконки	Lucide React
Формы	React Hook Form + Zod
API	Серверлесс-функции Vercel (Node/TypeScript)
CI/CD	GitHub Actions → GitHub Pages

📁 Структура проекта

aml-chainalysis/
├── api/                    # Серверлесс-функции Vercel
│   └── check/[address].ts  # Endpoint агрегированной проверки
├── public/                 # Статические файлы
├── src/
│   ├── components/ui/      # Компоненты shadcn/ui
│   ├── i18n/               # Переводы EN/RU и контекст языка
│   ├── App.tsx             # Главное приложение
│   └── main.tsx            # Точка входа
├── .github/workflows/      # Деплой на GitHub Pages
├── index.html              # SEO-оптимизированная оболочка
├── robots.txt              # Allow all + ссылка на sitemap
├── sitemap.xml             # Карта сайта
├── LICENSE                 # MIT
└── README.md               # Этот файл

⚙️ Конфигурация

Фронтенд обращается к backend-API. По умолчанию используется относительный путь:

VITE_API_URL=

Для локальной разработки на Vercel укажите:

VITE_API_URL=http://localhost:3000
CHAINALYSIS_API_KEY=your_chainalysis_key
SCORECHAIN_API_KEY=your_scorechain_key

API-ключи — серверные секреты, их нужно настроить в окружении хостинга (например, Vercel → Environment Variables), но никогда не коммитить в репозиторий.

🤝 Участие в проекте

1. Сделайте Fork репозитория.
2. Создайте ветку: git checkout -b feat/amazing-feature.
3. Закоммитьте изменения: git commit -m "feat: add amazing feature".
4. Отправьте ветку: git push origin feat/amazing-feature.
5. Откройте Pull Request.

📄 Лицензия

Проект распространяется под MIT License.