Invalid address и bad checksum: почему кошелёк не принимает адрес

Ошибка «invalid address» или «bad checksum» значит, что вставленная строка не прошла встроенную проверку формата адреса. У большинства криптоадресов несколько последних символов вычисляются из остальных; если один символ набран неверно, пропущен или переставлен, проверка не сходится, и кошелёк отказывается отправлять. Это хороший исход: контрольная сумма только что остановила платёж на адрес, которым никто не управляет. Скопируйте адрес заново из источника, а не исправляйте вручную.

Как устроены контрольные суммы по форматам

В Base58 намеренно нет похожих символов 0, O, I и l, поэтому перепутанная «O» вместо «o» либо невозможна, либо ловится. Bech32 пишется строчными или прописными, но никогда вперемешку, а его код рассчитан на обнаружение любой ошибки до четырёх символов. EIP-55 слабее: контрольная сумма закодирована регистром шестнадцатеричных букв, а адрес целиком в нижнем или верхнем регистре не несёт её вовсе — поэтому некоторые кошельки принимают его с предупреждением.

Частые причины

• Символ потерялся при копировании — выделение не захватило первый или последний символ, или в сообщении чата появился перенос строки.
• Набор вручную со скриншота или бумаги. Похожие символы — обычная причина сбоев Bech32 и Base58.
• Смешанный регистр в адресе Bech32, когда приложение «услужливо» сделало первую букву заглавной.
• Адрес, разбитый на две строки в письме или PDF, когда скопирована только первая строка.
• Невидимые символы: пробел нулевой ширины или неразрывный пробел, скопированные с веб-страницы или из PDF.
• Адрес другой сети: M-адрес Litecoin в поле Bitcoin или адрес Bitcoin Cash bitcoincash: в кошельке Bitcoin. Они не проходят из-за другого байта версии или префикса.
• Неверная контрольная сумма EVM, когда кто-то изменил одну букву адреса со смешанным регистром.

От чего контрольная сумма не защищает

Контрольная сумма доказывает, что адрес правильно сформирован, но не что это нужный адрес. Три опасные ошибки проходят проверку:

1. Address poisoning: мошенник генерирует валидный адрес с теми же первыми и последними символами, что у вашего контрагента, и подбрасывает его в историю крошечным переводом. Проверка address poisoning сравнивает строки целиком.
2. Вирус-подменщик буфера обмена, который меняет скопированный адрес на валидный адрес злоумышленника.
3. Валидный адрес в чужой сети — тот же 0x-адрес в BSC вместо Ethereum, например. См. отправка не в ту сеть.

Почему одни форматы строже других

Четыре байта Base58Check дают примерно один шанс из 4,3 млрд, что случайная ошибка проскочит. Bech32 разработали Питер Вуйле и Грег Максвелл так, чтобы он гарантированно ловил до четырёх заменённых символов и указывал место ошибки; Bech32m исправил слабость исходного кода для адресов Taproot. EIP-55 добавили в Ethereum спустя годы после запуска, поэтому адреса в нижнем регистре остаются валидными: протокол никогда не требовал контрольной суммы, и кошелёк может проверить её, только если регистр смешанный. Адреса Solana — это публичные ключи в base58 без контрольной суммы, так что опечатка может дать другой валидный ключ; проверяется только, что строка декодируется в 32 байта.

Быстрая проверка перед каждой отправкой

1. Копируйте адрес с экрана самого получателя: страницы заказа, страницы депозита биржи, кошелька получателя.
2. Вставьте и сверьте минимум шесть символов в начале, шесть в конце и несколько в середине.
3. Проверьте название сети рядом с адресом и memo или тег, если он нужен; проверка memo и тега показывает, каким монетам он требуется.
4. Если сомневаетесь, пропустите адрес через проверку адреса: она локально в браузере проверяет контрольную сумму для форматов Bitcoin, Ethereum, TRON, Solana, Litecoin и Monero.

В KOT.CASH форма заказа проверяет адрес выплаты для выбранной монеты до создания заказа, а провайдер выполняет свою проверку. Отклонённый адрес там почти всегда означает, что он из другой сети, чем выбранная монета.