BEP20-адрес: формат, проверка и создание через API
BEP20-адрес — это шестнадцатеричный идентификатор аккаунта в BNB Smart Chain: префикс 0x и 42 символа. Один адрес хранит BNB и все токены BEP-20. Его формат совпадает с адресом Ethereum, потому что BSC совместима с EVM, и он не то же самое, что адрес BEP-2, который начинается с bnb1.
Чтобы получить BEP20-адрес, сгенерируйте пару ключей в кошельке или вызовите POST /api/v2/bsc/addresses. Результат — строка из 42 символов с префиксом 0x. Её можно публиковать для приёма депозитов: адрес получен из открытого ключа, а потратить средства с него может только владелец приватного ключа.
На странице разобраны формат, отличие BEP-20 от BEP-2 и создание адресов через REST. Подробнее о контрольных суммах — в руководстве по BEP20-адресам в блоге.
Как выглядит BEP20-адрес?
BEP20-адрес выглядит так: 0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed. Это префикс 0x и 40 шестнадцатеричных символов, то есть 20 байт. Согласно документации ethereum.org об аккаунтах, адрес внешнего аккаунта — последние 20 байт хеша Keccak-256 от его открытого ключа, записанные с 0x впереди. BNB Smart Chain работает на Ethereum Virtual Machine и поэтому берёт эту схему без изменений.
Смешанный регистр букв сделан намеренно. EIP-55 определяет контрольную сумму, при которой часть букв пишется заглавными, и кошелёк замечает большинство опечаток. Адрес целиком в нижнем регистре тоже действителен, просто без контрольной суммы.
- Префикс 0x показывает, что значение записано в шестнадцатеричной системе.
- 40 шестнадцатеричных символов — это 20 байт: последние 20 байт хеша Keccak-256 от открытого ключа.
- Всего 42 символа. Сочетание заглавных и строчных букв — это контрольная сумма EIP-55.
Чем BEP-20 отличается от BEP-2 и ERC-20?
BEP-20 — стандарт токенов BNB Smart Chain. Согласно спецификации BEP-20, он выведен из ERC-20 в Ethereum и добавляет поддержку переводов между BNB Beacon Chain и BNB Smart Chain. Функции те же: balanceOf, transfer, approve и связанные события.
BEP-2 — другой стандарт. Он относится к BNB Beacon Chain, ранее Binance Chain, а его адреса начинаются с bnb1, а не с 0x. Актив BEP-2 нельзя отправить на адрес 0x напрямую. Для перемещения средств между двумя сетями нужен кросс-чейн-перевод, поэтому проверяйте, какую сеть запрашивает экран депозита.
Адрес Ethereum и BEP20-адрес выглядят одинаково, но существуют в разных сетях. Один и тот же приватный ключ управляет одной и той же строкой в обеих сетях. Перевод доходит только до той сети, в которую его отправили.
Хранит ли один BEP20-адрес BNB и все BEP-20-токены?
Да. Один адрес соответствует одному аккаунту в BNB Smart Chain, и на нём одновременно лежат нативный BNB и все BEP-20-токены. Баланс токена хранится не в самом адресе. Смарт-контракт токена ведёт соответствие «адрес — баланс», а balanceOf(address) его читает.
Не путайте адрес кошелька с адресом контракта токена. Оба — строки 0x из 42 символов, и по самой строке их не отличить. Адрес контракта указывает, какой токен переводится, и никогда не должен быть получателем перевода. Токены, отправленные на адрес контракта, в большинстве случаев теряются.
Кошельку с BEP-20-токенами нужно и немного BNB. Газ в BNB Smart Chain оплачивается в BNB, поэтому одним балансом токена перевод не отправить.
Создание и отслеживание BEP20-адреса через REST
Вместо того чтобы создавать адрес в приложении-кошельке и копировать его в бэкенд, адреса можно создавать и импортировать прямо через BSC API. О поступлении депозита сообщает вебхук. Так отдельный адрес для каждого клиента создаётся одним запросом.
| Эндпоинт | Что делает |
|---|---|
POST /api/v2/bsc/addresses | Сгенерировать новый BEP20-адрес |
POST /api/v2/bsc/addresses/import | Импортировать существующий приватный ключ, чтобы API мог подписывать от имени этого адреса |
GET /api/v2/bsc/addresses | Список адресов, сохранённых в вашем аккаунте |
GET /api/v2/bsc/balances/{address} | Баланс BNB на адресе |
GET /api/v2/bsc/balances/{address}/bep20/{contract_address} | Баланс одного BEP-20-токена |
POST /api/v2/bsc/webhooks | Зарегистрировать вебхук: депозит на адрес вызывает callback с подписью HMAC |
GET /api/v2/bsc/webhooks/notifications | Список прошлых уведомлений о депозитах для сверки |
Для отслеживания адреса приватный ключ не нужен, он нужен только для отправки. Держите депозитные адреса в режиме наблюдения и импортируйте ключ лишь для горячего кошелька, который делает выплаты. В документации API адресные поля описаны как 0x и ровно 40 шестнадцатеричных символов, поэтому некорректная строка отклоняется.
Создайте адрес и отслеживайте BEP-20-депозиты
Первый вызов создаёт адрес, второй регистрирует вебхук на депозиты BEP-20-токена. Оба вызова требуют Bearer-токен. Добавьте X-Network: testnet, чтобы сначала отработать сценарий в тестовой сети BSC.
curl -X POST https://app.chaingateway.io/api/v2/bsc/addresses \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"password": "a-strong-password-per-wallet"}'
curl -X POST https://app.chaingateway.io/api/v2/bsc/webhooks \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://your-backend.example/hooks/bsc",
"to": "0xYourDepositAddress",
"type": "BEP20",
"contractaddress": "0xTokenContract",
"reference": "customer-4711"
}'Как проверить BEP20-адрес перед отправкой?
Перед отправкой выплаты выполните три проверки. Сначала сопоставьте строку с шаблоном ^0x[a-fA-F0-9]{40}$: он отсекает неверную длину и лишние символы. Затем, если в адресе есть и заглавные, и строчные буквы, проверьте контрольную сумму EIP-55, потому что одна неверная буква её нарушит.
Третья проверка касается сети. Адрес 0x действителен в любой EVM-сети, поэтому проверка формата не скажет, ждёт получатель BSC, Ethereum или Polygon. Спросите сеть у пользователя явно и отправляйте небольшой тестовый перевод на каждый новый адрес выплат.
Если нужно проверить один адрес вручную, валидатор адресов выполняет проверку формата и контрольной суммы прямо в браузере.
Источники
- BEP-20: токены в BNB Smart Chain (bnb-chain/BEPs)
- Аккаунты Ethereum (ethereum.org)
- ERC-55: кодирование адреса с контрольной суммой в смешанном регистре
Проверено 5 ноября 2026 года.
Нужны адреса партиями, а не по одному? Создайте бесплатный аккаунт и сгенерируйте партию BEP20-адресов в testnet. 7-дневный пробный период, без карты и без KYC.
FAQ: BEP20-адреса
Готовы строить на BNB Smart Chain?
Создайте аккаунт и сгенерируйте тестовый BEP20-адрес за несколько минут. 7-дневный пробный период, без карты и без KYC. Полный справочник эндпоинтов — в документации BSC API, а все семь сетей закрывает мультичейн blockchain API.
Проверил(а) Maurice Sobiera Как мы пишем эти страницы