BEP20-адрес: формат, валидация и создание через API
Как устроен BEP20-адрес, чем он отличается от адреса BEP-2 или контракта, и как генерировать и отслеживать депозитные адреса BSC через API Chaingateway.
BEP20-адрес — это 42-символьная hex-строка с префиксом 0x, на которой хранятся BNB и BEP-20-токены в BNB Smart Chain, — тот же формат адреса, что использует Ethereum, поскольку уровень исполнения BSC совместим с EVM. Если вы интегрируете депозиты или выплаты BSC, адрес — это то, с чего начинается любой процесс: сгенерируйте его для каждого клиента, отслеживайте, зачисляйте депозит. На этой странице описан формат и способ получения адресов через API вместо интерфейса кошелька; более глубокое техническое объяснение чек-сумм и отличия BEP-2 от BEP-20 — в руководстве по BEP20-адресам в блоге.
Что такое BEP20-адрес?
BEP20-адрес — это 20-байтовое значение, записанное как 40 шестнадцатеричных символов с префиксом 0x, например 0x8894E0a0c962CB723c1976a4421c95949bE2D4E. Он выводится так же, как и адрес Ethereum: из открытого ключа пары ключей, посредством хеширования Keccak-256. Именно этот общий способ вывода позволяет кошельку, хранящему Ethereum-адрес, отображать идентичную строку в BSC — формат не различает сети, это делает только сеть, в которую вы транслируете транзакцию.
BSC BEP20 против BEP-2: разные стандарты
BEP20 — это стандарт токенов BNB Smart Chain, функционально близкий к ERC-20 Ethereum и использующий тот же формат адреса. BEP-2 — другой, более старый стандарт, работающий в BNB Beacon Chain (ранее Binance Chain), со своим собственным форматом адреса, начинающимся с bnb1 вместо 0x. Адреса «BSC BEP20» и «BEP-2» не взаимозаменяемы, и отправка актива BEP-2 на адрес в формате BEP20 (или наоборот) завершится ошибкой либо, на некоторых биржах, потребует отдельного шага кросс-чейн-конвертации. Если вы попали сюда по запросу «bep20 bsc», вот в чём суть: вы на верной сети.
Что такое BEP20-адрес кошелька на практике?
Функционально BEP20-адрес кошелька — это идентификатор вашего аккаунта в BSC: адрес назначения для входящих BNB или BEP-20-токенов (таких как USDT, USDC или собственный токен проекта) и адрес источника для исходящих переводов. Один и тот же формат адреса кошелька binance smart chain хранит нативный BNB и любой BEP-20-токен одновременно — на один аккаунт приходится один адрес, а не один на актив, и баланс токена по этому адресу отслеживается смарт-контрактом самого токена, а не самим адресом.
Создание и отслеживание BEP20-адреса через REST
Вместо генерации адреса в приложении-кошельке и копирования его в бэкенд, BSC API создаёт и импортирует адреса напрямую, а вебхук сообщает вам о поступлении депозита.
| Эндпоинт | Что он делает |
|---|---|
POST /api/v2/bsc/addresses | Сгенерировать новый BEP20-адрес |
POST /api/v2/bsc/addresses/import | Импортировать существующий приватный ключ, чтобы API мог подписывать от имени этого адреса |
POST /api/v2/bsc/webhooks | Зарегистрировать вебхук, чтобы депозит на адрес вызывал HMAC-подписанный callback |
GET /api/v2/bsc/webhooks/notifications | Получить список прошлых уведомлений о депозитах для сверки |
Отслеживание адреса на предмет депозитов не требует импортированного ключа — он нужен только для отправки с адреса. Это разделение важно для BEP20-токенов: ваши адреса для сбора депозитов могут оставаться только для наблюдения, и импортированный ключ нужен лишь горячему кошельку, который выполняет выплаты.
Нужны адреса в масштабе, а не по одному за раз? Создайте бесплатный аккаунт и сгенерируйте пакет BEP20-адресов в testnet — 7-дневный пробный период, без карты, без KYC.
FAQ: BEP20-адреса
Готовы разрабатывать на BNB Smart Chain?
Создайте аккаунт и сгенерируйте тестовый BEP20-адрес за несколько минут — 7-дневный пробный период, без карты, без KYC. Полный справочник эндпоинтов — в документации BSC API, либо охватите все семь сетей с помощью multi-chain blockchain API.