Кальтер / Блог

Bitcoin URI перед оплатой: проверь адрес, сумму и параметры

Разбери Bitcoin URI по BIP 321: проверь инструкцию получателя, сумму в BTC, подписи и обязательные req-параметры до подтверждения в кошельке.

Материал подготовлен с помощью ИИ; BIP 321 и синтетический разбор проверены редакцией ZASLON. Оплата не выполнялась.

Редакционная схема: Разобрать Bitcoin URI. Условные обозначения, не скриншот сервиса или реальной операции.
Редакционная схема: Разобрать Bitcoin URI. Условные обозначения, не скриншот сервиса или реальной операции.

Ссылка bitcoin: — это набор платёжных инструкций для совместимого кошелька, а не доказательство личности продавца и не подтверждение оплаты. Перед подтверждением проверь адрес или платёжную инструкцию, сеть, сумму и описание в самом кошельке.

Актуальная спецификация BIP 321 заменяет BIP 21 и описывает современные правила URI. Кошелёк не должен выполнять платёж без разрешения пользователя. Сумма amount задаётся десятичным числом BTC; параметры label и message помогают описать запрос, но сами по себе не удостоверяют получателя. Неизвестный необязательный параметр можно игнорировать, а неизвестный req-... делает URI неподдерживаемым и недействительным для клиента.

Проверка по шагам

  1. Открой ссылку только в ожидаемом кошельке. Если приложение или сайт внезапно просит seed, приватный ключ или подключить удалённое управление ради оплаты — остановись.
  2. Проверь всю строку получателя и выбранную сеть. Не считай знакомое имя в label доказательством, что адрес принадлежит нужному магазину.
  3. Пересчитай сумму и единицы. В Bitcoin URI сумма указывается в BTC, а не в сатоши.
  4. Прочитай message как описание, а не как команду или подтверждение заказа. Текст может быть percent-encoded и после декодирования содержать обычные символы.
  5. Если есть незнакомый req- параметр и кошелёк сообщает, что он не поддерживается, не обходи это предупреждение: запрос нельзя корректно интерпретировать.
  6. На экране подтверждения снова сверь актив, адрес/инструкцию, сумму и комиссию. Подтверждай только после личной проверки.

Полностью синтетический пример

Ниже 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; кошелёк и платёж не использовались.