> ## Documentation Index
> Fetch the complete documentation index at: https://shinydapps-bd9fa40b.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Расширение VS Code

> Отслеживайте свои Lightning-платежи в реальном времени прямо в VS Code — строка состояния, графики, экспорт в CSV и Pro-подписка, оплачиваемая в Bitcoin.

Расширение **ShinyDapps Payments** отображает данные о платежах l402-kit, не выходя из редактора. Установите один раз, укажите свой Lightning-адрес и наблюдайте, как sats поступают в строку состояния.

<Card title="Установить из Marketplace" icon="download" href="https://marketplace.visualstudio.com/items?itemName=ShinyDapps.shinydapps-l402">
  ShinyDapps.shinydapps-l402 — работает с VS Code 1.85+
</Card>

***

## Быстрая настройка

1. Установите расширение из [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=ShinyDapps.shinydapps-l402).
2. Откройте палитру команд (`Ctrl+Shift+P` / `Cmd+Shift+P`).
3. Выполните команду **ShinyDapps: Configure Lightning Address**.
4. Введите свой Lightning-адрес (например, `you@blink.sv`).

Элемент строки состояния `⚡ 0 sats (0)` загорается сразу же. Опрос выполняется каждые 30 секунд, данные обновляются автоматически.

Также можно задать адрес вручную в настройках VS Code:

```json theme={null}
{
  "shinydapps.lightningAddress": "you@blink.sv"
}
```

***

## Что отображается

### Строка состояния

`⚡ 1,234 sats (42)` — суммарное количество заработанных sats и число платежей, всегда на виду.
Наведите курсор на элемент, чтобы увидеть подсказку с подробностями. Если вы используете бесплатный план, подсказка также напомнит, что Pro открывает полную историю.

### Панель управления

Нажмите на элемент строки состояния или выполните команду **ShinyDapps: Open Dashboard**, чтобы открыть полную панель. Она содержит:

| Раздел              | Описание                                                             |
| ------------------- | -------------------------------------------------------------------- |
| Карточки статистики | Общее число платежей, суммарные sats, оценка в USD, текущая цена BTC |
| Столбчатый график   | Заработанные sats за период (см. диапазоны ниже)                     |
| Таблица платежей    | Последние 50 транзакций: время, эндпоинт, sats                       |
| Тикер BTC           | Актуальная цена с mempool.space, отображается в sat-per-dollar       |

Панель также доступна на боковой панели (Activity Bar → значок ⚡).

### Поддержка языков

11 встроенных языков: English, Português, Español, 中文, 日本語, Français, Deutsch, Русский, हिन्दी, العربية, Italiano. Переключение осуществляется через выпадающий список в верхней части панели управления.

***

## Бесплатный план и Pro

| Функция                        | Бесплатно         | Pro                      |
| ------------------------------ | ----------------- | ------------------------ |
| История платежей               | Последние 30 дней | За всё время             |
| Диапазоны графика              | 1D · 7D           | 1D · 7D · 30D · 1Y · ALL |
| Экспорт в CSV                  | —                 | ✓                        |
| Строка состояния + живой опрос | ✓                 | ✓                        |
| Тикер цены BTC                 | ✓                 | ✓                        |
| Языки                          | 11                | 11                       |

### Переход на Pro

Pro стоит **\$9 в месяц**, оплата в Bitcoin через Lightning — без банковской карты, без учётной записи.

Нажмите **Upgrade with Bitcoin →** внутри панели управления или перейдите напрямую по адресу:

```
https://l402kit.com/api/checkout?address=YOU@DOMAIN.COM&tier=pro
```

Страница оформления заказа генерирует BOLT11-инвойс, показывает QR-код и ожидает оплаты. После подтверждения Pro активируется мгновенно — перезапуск не требуется.

<Note>
  Расширение проверяет статус Pro при запуске. Если вы только что оплатили, нажмите кнопку **↺** обновления в панели управления для немедленной активации.
</Note>

***

## Уведомления

Расширение отправляет уведомление VS Code, когда **первый платёж поступает** в то время, пока редактор открыт:

> ⚡ First payment received! Open your dashboard to see it.

Нажмите **Open Dashboard** в уведомлении, чтобы сразу перейти к панели.

***

## Конфиденциальность и данные

* Расширение считывает данные о платежах из Supabase, используя **публичный (только для чтения)** ключ, привязанный к вашему Lightning-адресу.
* Никакие токены аутентификации не хранятся локально — только ваш Lightning-адрес в настройках VS Code.
* Вы можете удалить все свои данные в любой момент через **Danger Zone → Delete all my data** внутри панели управления. Это удаляет историю платежей и Pro-подписку из Supabase.

***

## Опасная зона

Панель управления включает самостоятельный процесс удаления данных:

1. Разверните раздел **Danger Zone** в нижней части панели управления.
2. Введите свой Lightning-адрес для подтверждения.
3. Нажмите **Delete my data**.

Вся история платежей и Pro-доступ для этого адреса будут удалены безвозвратно.

***

## Устранение неполадок

<AccordionGroup>
  <Accordion title="Строка состояния показывает ⚡ — (offline)">
    Расширению не удалось подключиться к Supabase. Проверьте подключение к интернету и попробуйте нажать **↺** для обновления.
  </Accordion>

  <Accordion title="Платежи не отображаются после успешной транзакции">
    Расширение выполняет опрос каждые 30 секунд. Нажмите **↺**, чтобы принудительно обновить данные. Если платежи по-прежнему не отображаются, убедитесь, что Lightning-адрес в настройках VS Code точно совпадает с адресом, зарегистрированным в l402-kit (с учётом регистра).
  </Accordion>

  <Accordion title="Pro активирован, но на графике по-прежнему отображается 🔒">
    Нажмите **↺** для обновления. Статус Pro проверяется при загрузке — ручное обновление повторно валидирует его немедленно.
  </Accordion>

  <Accordion title="Платежи отображаются, но их количество кажется заниженным">
    На бесплатном плане загружается только история за **последние 30 дней**. Перейдите на Pro, чтобы видеть данные за всё время. Баннер Pro показывает, сколько платежей скрыто, если у вас есть более ранние записи.
  </Accordion>
</AccordionGroup>
