Чтение состояния сети
eth_getBalance, eth_call, eth_getLogs, eth_getTransactionReceipt — методы для чтения балансов, вызова view-функций контрактов и получения логов событий. Любой метод, который принимает нода BSC, доступен без ограничений.
BNB Smart Chain · JSON-RPC 2.0 · BEP-20
RPC-нода BNB Smart Chain
RPC-нода BNB Smart Chain
BSC API по JSON-RPC
BNB Smart Chain полностью совместима с EVM, поэтому работает по тому же JSON-RPC 2.0, что и Ethereum. Отправляете запрос на наш адрес — прокси передаёт его ноде BSC и возвращает ответ как есть. ethers.js, web3.js и web3.py подключаются без изменения логики приложения — меняется только адрес провайдера.
JSON-RPC 2.0
тот же протокол, что у Ethereum
Все методы
whitelist отсутствует
Старт сегодня
доступ открывается в день обращения
# bsc — так нода названа в этом примере, своё имя смотрите в личном кабинете
# eth_getBalance — баланс адреса в wei (BNB)
curl -X POST https://nodes-api.cryptosafe.pro/proxy/bsc \
-H "Authorization: $CSN_TOKEN" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe","latest"],"id":1}'
# ответ приходит от ноды без изменений
{"jsonrpc":"2.0","id":1,"result":"0x2b5e3af16b18800"}import { JsonRpcProvider, FetchRequest } from 'ethers'
const req = new FetchRequest('https://nodes-api.cryptosafe.pro/proxy/bsc')
// ключ — без префикса Bearer, именно так, как выдан в кабинете
req.setHeader('Authorization', process.env.CSN_TOKEN)
const provider = new JsonRpcProvider(req, 56)
const balance = await provider.getBalance('0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe')
// ethers.js работает как обычно — адрес провайдера единственное, что изменилось
Адрес провайдера — единственное изменение в коде
Возможности
Что открывает RPC-нода BNB Smart Chain
BNB Smart Chain — EVM-совместимая сеть: состояние, контракты и транзакции читаются и отправляются теми же вызовами, что и в Ethereum. Через наш RPC-эндпоинт вы получаете данные напрямую с ноды.
BEP-20 тем же интерфейсом, что ERC-20
Токены BEP-20 читаются и отправляются теми же вызовами eth_call и eth_sendRawTransaction, что и ERC-20 в Ethereum, — меняется только адрес контракта токена и сети. Прокси передаёт тело запроса ноде без изменений.
Отправка транзакций
eth_sendRawTransaction принимает подписанные транзакции и передаёт их ноде без изменений. eth_estimateGas помогает рассчитать лимит газа перед отправкой.
Ключ с IP-ограничением
Ключ можно привязать к IP-адресам и подсетям CIDR ваших серверов. Запрос с незарегистрированного адреса получит ошибку 8003. Поддерживаются IPv4 и IPv6; до 50 записей на ключ.
Инфраструктура на нас
Синхронизация ноды BNB Smart Chain, обновления клиента и мониторинг — наша ответственность. Адрес вашего эндпоинта не меняется при любых обновлениях с нашей стороны.
Статистика по запросам
В личном кабинете видно количество запросов к ноде BSC, долю успешных и время ответа. Метрики собираются с первого дня без дополнительной настройки.
Подключение
Четыре шага до первых запросов к BNB Smart Chain
От первого сообщения до рабочего провайдера — обычно в тот же день.
01
Напишите нам
Напишите нам в чат поддержки на сайте: скажите, что нужен доступ к ноде BNB Smart Chain. Мы откроем кабинет в день обращения.
02
Выпустите ключ
В личном кабинете создайте ключ. При необходимости добавьте IP-адреса серверов, с которых будут идти запросы.
03
Укажите адрес провайдера
Подставьте https://nodes-api.cryptosafe.pro/proxy/bsc
в настройки ethers.js, web3.js или любой другой библиотеки.
Добавьте ключ в заголовок Authorization.
04
Отправляйте запросы
Логика приложения остаётся прежней — библиотека работает как обычно. В кабинете сразу начнёт накапливаться статистика по вашим вызовам.
Вопросы
Частые вопросы о BNB Smart Chain RPC
Какой протокол использует BNB Smart Chain?
BNB Smart Chain — EVM-совместимая сеть, поэтому нода отвечает по тому же JSON-RPC 2.0 поверх HTTP POST, что и Ethereum. Запрос отправляется методом POST на адрес https://nodes-api.cryptosafe.pro/proxy/bsc с телом {"jsonrpc":"2.0","method":"...","params":[...],"id":1}. Ответ приходит от ноды без изменений.
Работают ли ethers.js, web3.js и web3.py на BSC без переделки кода?
Да. Библиотеки, написанные для Ethereum, работают на BNB Smart Chain без изменения логики — меняется только адрес провайдера. Для сети mainnet chain id равен 56, для этой сети библиотеке достаточно указать наш адрес и ключ в заголовке Authorization.
Как работать с токенами BEP-20?
BEP-20 использует тот же интерфейс вызовов, что и ERC-20 — баланс и переводы читаются и отправляются через eth_call и eth_sendRawTransaction с адресом контракта токена. Прокси прозрачен к телу запроса и передаёт его ноде без изменений.
Какие методы BNB Smart Chain доступны?
Набор RPC-методов ничем не ограничен — работает любой метод, который принимает нода. Среди типовых: eth_blockNumber, eth_getBalance, eth_call, eth_getLogs, eth_getTransactionReceipt, eth_sendRawTransaction, eth_estimateGas.
Как правильно передавать ключ аутентификации?
Ключ передаётся в заголовке Authorization без префикса Bearer — именно как значение, без дополнительных слов. Пример: Authorization: ваш-ключ. Ключ выпускается в личном кабинете; на компанию доступно до трёх ключей.
Можно ли ограничить доступ по IP?
Да. Каждый ключ можно привязать к списку IP-адресов и подсетей CIDR — до 50 записей. Поддерживаются IPv4 и IPv6. Пустой список означает доступ с любого адреса. Вспомогательный эндпоинт https://nodes-api.cryptosafe.pro/info/getip вернёт ваш текущий IP текстом.
Нужна RPC-нода BNB Smart Chain?
Напишите в чат поддержки — откроем доступ к ноде BNB Smart Chain в день обращения. Ключ выпускаете сами в кабинете, инфраструктуру держим мы.