Ссылка bitcoin: — это набор платёжных инструкций для совместимого кошелька, а не доказательство личности продавца и не подтверждение оплаты. Перед подтверждением проверь адрес или платёжную инструкцию, сеть, сумму и описание в самом кошельке.
Актуальная спецификация BIP 321 заменяет BIP 21 и описывает современные правила URI. Кошелёк не должен выполнять платёж без разрешения пользователя. Сумма amount задаётся десятичным числом BTC; параметры label и message помогают описать запрос, но сами по себе не удостоверяют получателя. Неизвестный необязательный параметр можно игнорировать, а неизвестный req-... делает URI неподдерживаемым и недействительным для клиента.
Проверка по шагам
- Открой ссылку только в ожидаемом кошельке. Если приложение или сайт внезапно просит seed, приватный ключ или подключить удалённое управление ради оплаты — остановись.
- Проверь всю строку получателя и выбранную сеть. Не считай знакомое имя в
labelдоказательством, что адрес принадлежит нужному магазину. - Пересчитай сумму и единицы. В Bitcoin URI сумма указывается в BTC, а не в сатоши.
- Прочитай
messageкак описание, а не как команду или подтверждение заказа. Текст может быть percent-encoded и после декодирования содержать обычные символы. - Если есть незнакомый
req-параметр и кошелёк сообщает, что он не поддерживается, не обходи это предупреждение: запрос нельзя корректно интерпретировать. - На экране подтверждения снова сверь актив, адрес/инструкцию, сумму и комиссию. Подтверждай только после личной проверки.
Полностью синтетический пример
Ниже ADDRESS_PLACEHOLDER намеренно не является адресом и не предназначен для сканирования или оплаты:
bitcoin:ADDRESS_PLACEHOLDER?amount=0.005&label=Demo&message=Invoice%2042
Разбор учебного значения:
| Часть | Значение | Что проверить |
|---|---|---|
bitcoin: |
URI scheme | Открывает обработчик Bitcoin URI; само по себе не гарантирует безопасность приложения |
ADDRESS_PLACEHOLDER |
фиктивный получатель | Не настоящий адрес; для оплаты требуется проверяемая инструкция из доверенного источника |
amount=0.005 |
0.005 BTC | Это 500,000 сатоши, поскольку 1 BTC = 100,000,000 сатоши |
label=Demo |
подпись получателя | Не подтверждает владельца адреса |
message=Invoice%2042 |
Invoice 42 после декодирования |
Текст описывает платёж, но не проверяет заказ |
В сценарии тестирования пользователь открывает ссылку в тестовом интерфейсе, видит фиктивное значение и останавливается до подтверждения. Если бы адрес был реальным, его следовало бы сравнить с реквизитами заказа независимым каналом, а затем проверить итоговый экран кошелька. Здесь платёж не выполняется, так как получатель — placeholder.
Копируемый запрос к ИИ
Разбери Bitcoin URI по актуальной BIP 321. Не открывай ссылку и не инициируй платёж. Раздели URI на scheme, recipient/payment-instruction, amount, label, message и прочие параметры; декодируй percent-encoding; проверь сумму в BTC и сатоши; отметь неизвестные req-* как stop condition, а обычные неизвестные параметры — как требующие проверки поддержки. Не считай label доказательством личности и не подтверждай, что платёж безопасен. Если адрес или инвойс реальный, замени его в ответе на [СКРЫТО]. Верни таблицу «поле / значение / проверка / ограничение» и перечисли, что пользователь должен сверить в самом кошельке.
Ошибки, которые меняют смысл проверки
- Считать label именем, которое проверено сетью. Это только текстовая подпись.
- Прочитать
0.005как 0.005 сатоши. BIP 321 указывает BTC; здесь это 500,000 сатоши. - Повторяющийся
label,messageилиpop. BIP 321 не разрешает дублировать эти ключи. Правила других параметров зависят от их назначения; не переноси этот запрет автоматически на все поля. Если итоговая сумма неоднозначна, запроси корректный счёт вместо угадывания. - Игнорировать незнакомый
req-.... Это обязательный параметр, без понимания которого кошелёк должен считать запрос неподдерживаемым. - Путать URI с квитанцией. Ссылка задаёт инструкции, но не доказывает, что средства отправлены или зачислены.
Для отдельной оплаты через Lightning см. как сверить Lightning invoice перед оплатой, а про форматы адресов — совместимость Bitcoin-адресов.
Материал подготовлен с помощью ИИ. Ссылка содержит фиктивный placeholder; кошелёк и платёж не использовались.
