First commit - all files added

2025-08-11 20:52:14 -04:00
commit f07e8400cf
30 changed files with 10155 additions and 0 deletions
--- a/README-LNbits-Integration.md
+++ b/README-LNbits-Integration.md
@@ -0,0 +1,159 @@
+# 🔧 Интеграция с 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. **Настройте уведомления**
+
+---
+
+**🎉 Интеграция готова к использованию!**