LNBits Wallet wtih QR Code

LNBits Wallet Manager

Позволяет вашему ассистенту безопасно и эффективно управлять кошельком LNbits в сети Lightning.

Критически важные протоколы

• Никогда не раскрывать секреты: не отображайте Admin Key, User ID или Wallet ID.
• Явное подтверждение: перед отправкой платежа обязательно запросите подтверждение «Да/Нет». Формат: «Я собираюсь отправить [сумма] сатоши на [назначение]. Продолжить? (y/n)».
• Проверка баланса: всегда вызывайте команду balance перед оплатой.
• Инвойс + QR-код: при создании инвойса обязательно выводите текст payment_request и строку MEDIA: с путем к QR-коду в одной строке.

Использование

0. Создание / настройка кошелька

Если у пользователя ещё нет кошелька LNbits, его можно создать на демо-сервере.

python3 {baseDir}/scripts/lnbits_cli.py create --name "My Wallet"

• Запустите команду — CLI вернёт JSON с adminkey и base_url.
• Не раскрывайте секреты: не копируйте ключи в чат.
• Сообщите пользователю, чтобы он сохранил значения в переменные окружения LNBITS_API_KEY и LNBITS_BASE_URL.

1. Проверка баланса

Получить текущий баланс кошелька в сатоши:

python3 {baseDir}/scripts/lnbits_cli.py balance

2. Создание инвойса (получение средств)

Сгенерируйте Bolt11-инвойс для получения платежа с QR-кодом.

python3 {baseDir}/scripts/lnbits_cli.py invoice --amount 1000 --memo "Coffee"

Результат должен включать:

• строку payment_request для копирования;
• QR-код, доступный через MEDIA: и путь к файлу.

3. Оплата инвойса (отправка средств)

Требуется подтверждение. Сначала декодируйте инвойс, затем проверьте баланс и только после этого выполняйте оплату.

# Шаг 1: декодирование
python3 {baseDir}/scripts/lnbits_cli.py decode 

# Шаг 2: оплата (после подтверждения)
python3 {baseDir}/scripts/lnbits_cli.py pay 

Обработка ошибок

Если CLI возвращает ошибку (например, {"error": "Insufficient funds"}), необходимо кратко и понятно объяснить проблему пользователю, не показывая технические детали или стек вызовов.

Пример рабочего процесса

Запрос пользователя: создать инвойс на 500 сатоши для «Coffee».

• Выполнить команду создания инвойса.
• Извлечь payment_request и путь к QR-коду.
• Показать строку инвойса для копирования.
• Вывести строку MEDIA: с путем к QR-коду.

В результате пользователь получает строку Bolt11 и QR-код для оплаты. :

Требования

• Аккаунт LNbits (локальный или demo-сервер)
• Переменные окружения: LNBITS_API_KEY, LNBITS_BASE_URL
• CLI-скрипт для работы с LNbits

Инструмент предназначен для безопасной работы с платежами Lightning: проверяет баланс, требует подтверждение и упрощает оплату через QR-коды.