# 🔧 Интеграция с LNbits - Руководство по тестированию

## 📋 Обзор

Интеграция с [LNbits](https://demo.lnbits.com) позволяет создавать Lightning Network инвойсы и верифицировать платежи в реальном времени.

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

### 1. Запуск тестов
```bash
# Откройте в браузере
test-lnbits-integration.html
```

### 2. Автоматическое тестирование
Нажмите кнопку **"🚀 Запустить все тесты"** для полной проверки интеграции.

## 🧪 Доступные тесты

### ✅ 1. Проверка API
- Тестирует доступность LNbits API
- Проверяет статус сервера
- Валидирует API ключ

### ✅ 2. Создание инвойса
- Создает Lightning инвойс на 500 sats
- Проверяет корректность ответа
- Валидирует структуру данных

### ✅ 3. Проверка статуса
- Проверяет статус созданного инвойса
- Отображает детали платежа
- Показывает время создания

### ✅ 4. Верификация платежа
- Тестирует криптографические функции
- Проверяет SHA-256 хеширование
- Валидирует preimage/hash пары

### ✅ 5. Тест реального платежа
- Проверяет готовность к реальным платежам
- Показывает инструкции по оплате
- Демонстрирует полный цикл

## 💡 Как протестировать реальный платеж

### Шаг 1: Создайте инвойс
1. Нажмите **"2. Создание инвойса"**
2. Скопируйте Payment Request из логов
3. Или отсканируйте QR код (если доступен)

### Шаг 2: Оплатите инвойс
Используйте любой Lightning кошелек:
- **Alby** (браузерное расширение)
- **Zeus** (мобильный кошелек)
- **Phoenix** (мобильный кошелек)
- **Wallet of Satoshi** (мобильный кошелек)

### Шаг 3: Проверьте статус
1. Нажмите **"3. Проверка статуса"**
2. Убедитесь, что `paid: true`
3. Скопируйте preimage из кошелька

### Шаг 4: Верифицируйте платеж
1. Нажмите **"5. Тест реального платежа"**
2. Введите preimage в поле
3. Проверьте результат верификации

## 🔧 Конфигурация

### API настройки
```javascript
{
    apiUrl: 'https://demo.lnbits.com',
    apiKey: '623515641d2e4ebcb1d5992d6d78419c',
    walletId: 'bcd00f561c7b46b4a7b118f069e68997',
    isDemo: true,
    demoTimeout: 30000
}
```

### Типы сессий
```javascript
{
    free: { sats: 0, hours: 1/60, usd: 0.00 },
    basic: { sats: 500, hours: 1, usd: 0.20 },
    premium: { sats: 1000, hours: 4, usd: 0.40 },
    extended: { sats: 2000, hours: 24, usd: 0.80 }
}
```

## 📊 Ожидаемые результаты

### Успешный тест
```
✅ API доступен
✅ Инвойс создан успешно
✅ Статус получен
✅ Криптографическая верификация работает
✅ Платеж готов к тестированию
```

### Возможные ошибки
- **API недоступен**: Проверьте интернет соединение
- **Ошибка создания инвойса**: Проверьте API ключ
- **Ошибка верификации**: Проверьте preimage формат

## 🔍 Отладка

### Логи в консоли
Откройте Developer Tools (F12) для детальных логов:
```javascript
console.log('🔍 Тестирование доступности API...');
console.log('✅ API доступен');
console.log('📊 Статус:', data);
```

### Проверка сети
В Network tab проверьте:
- Статус HTTP запросов
- Заголовки авторизации
- Тело ответов

## 🚨 Известные проблемы

### 1. CORS ошибки
**Проблема**: Браузер блокирует запросы к LNbits
**Решение**: Используйте локальный сервер или прокси

### 2. API лимиты
**Проблема**: Слишком много запросов
**Решение**: Добавьте задержки между тестами

### 3. Неверный preimage
**Проблема**: Ошибка верификации
**Решение**: Убедитесь, что preimage 64 символа hex

## 📞 Поддержка

### Полезные ссылки
- [LNbits Documentation](https://docs.lnbits.com/)
- [Lightning Network](https://lightning.network/)
- [BOLT11 Specification](https://github.com/lightning/bolts/blob/master/11-payment-encoding.md)

### Контакты
- **GitHub**: [LockBit.chat](https://github.com/lockbitchat/lockbit-chat)
- **Документация**: [README.md](../README.md)

## 🎯 Следующие шаги

1. **Протестируйте все функции**
2. **Настройте продакшн API ключи**
3. **Интегрируйте в основное приложение**
4. **Добавьте мониторинг платежей**
5. **Настройте уведомления**

---

**🎉 Интеграция готова к использованию!**