Адреса BNB Smart Chain

BEP20-адрес: формат, проверка и создание через API

BEP20-адрес — это шестнадцатеричный идентификатор аккаунта в BNB Smart Chain: префикс 0x и 42 символа. Один адрес хранит BNB и все токены BEP-20. Его формат совпадает с адресом Ethereum, потому что BSC совместима с EVM, и он не то же самое, что адрес BEP-2, который начинается с bnb1.

7 дней бесплатно — для начала не нужна карта и KYC Некастодиальный — приватные ключи остаются под вашим контролем Тарифы от 49 €/мес (490 €/год) — посмотреть тарифы и лимиты запросов

Чтобы получить 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 определяет контрольную сумму, при которой часть букв пишется заглавными, и кошелёк замечает большинство опечаток. Адрес целиком в нижнем регистре тоже действителен, просто без контрольной суммы.

0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed 1 2 3
  1. Префикс 0x показывает, что значение записано в шестнадцатеричной системе.
  2. 40 шестнадцатеричных символов — это 20 байт: последние 20 байт хеша Keccak-256 от открытого ключа.
  3. Всего 42 символа. Сочетание заглавных и строчных букв — это контрольная сумма EIP-55.
Строение EVM-адреса. BNB Smart Chain и Ethereum используют одну и ту же раскладку.

Чем 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
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. Спросите сеть у пользователя явно и отправляйте небольшой тестовый перевод на каждый новый адрес выплат.

Если нужно проверить один адрес вручную, валидатор адресов выполняет проверку формата и контрольной суммы прямо в браузере.

Нужны адреса партиями, а не по одному? Создайте бесплатный аккаунт и сгенерируйте партию BEP20-адресов в testnet. 7-дневный пробный период, без карты и без KYC.

FAQ: BEP20-адреса

42-символьная шестнадцатеричная строка с префиксом 0x, которая идентифицирует аккаунт в BNB Smart Chain и хранит BNB и любые BEP-20-токены. Он получается так же, как адрес Ethereum, поэтому у двух сетей общий формат.

BEP20-адрес — это формат адресов BNB Smart Chain: префикс 0x, как в EVM. BEP-2 — отдельный, более старый стандарт BNB Beacon Chain, его адреса начинаются с bnb1. Они не взаимозаменяемы: перед отправкой проверьте, какую сеть на самом деле запрашивает получатель.

Формат одинаковый, сеть разная. Один и тот же приватный ключ даёт похожий 0x-адрес и в Ethereum, и в BSC, но средства, отправленные в одной сети, в другой не существуют. Транзакцию нужно отправлять в той сети, которую ожидает получатель.

Запрос POST /api/v2/bsc/addresses создаёт его через API. Если зарегистрировать вебхук на этом адресе, бэкенд получит уведомление с подписью HMAC сразу при поступлении депозита в BNB или BEP-20, опрашивать сеть не нужно.

Да. Один BEP20-адрес хранит нативный BNB и все BEP-20-токены (USDT, USDC, собственный токен проекта) на одном адресе. Балансы по токенам учитывает смарт-контракт каждого токена, а не сам адрес.

Готовы строить на BNB Smart Chain?

Создайте аккаунт и сгенерируйте тестовый BEP20-адрес за несколько минут. 7-дневный пробный период, без карты и без KYC. Полный справочник эндпоинтов — в документации BSC API, а все семь сетей закрывает мультичейн blockchain API.

Проверил(а) Maurice Sobiera Как мы пишем эти страницы