Чтение состояния цепи
getblockcount, getblockchaininfo, getblock — методы для получения актуальной высоты цепи, параметров сети и данных конкретного блока. Любой метод Bitcoin Core доступен без ограничений.
Bitcoin · Bitcoin Core JSON-RPC
Нода Bitcoin Core
Нода Bitcoin Core
по API — Bitcoin RPC
Отправляете JSON-RPC запросы на наш адрес — прокси передаёт их ноде Bitcoin Core и возвращает ответ без изменений. Набор методов ничем не ограничен: getblockcount, getrawtransaction, sendrawtransaction и всё остальное, что принимает нода. Тело запроса не трогается — транзакции проходят насквозь.
Bitcoin Core RPC
стандартный протокол ноды
Все методы
whitelist отсутствует
Старт сегодня
доступ открывается в день обращения
# getblockcount — текущая высота цепи
curl -X POST https://nodes-api.cryptosafe.pro/proxy/bitcoin \
-H "Authorization: $CSN_TOKEN" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"getblockcount","params":[],"id":1}'
# ответ приходит от ноды без изменений
{"result":851247,"error":null,"id":1}import requests
# ключ — без префикса Bearer
r = requests.post(
'https://nodes-api.cryptosafe.pro/proxy/bitcoin',
headers={'Authorization': CSN_TOKEN},
json={'jsonrpc': '2.0', 'method': 'getblockchaininfo', 'params': [], 'id': 1},
timeout=10,
)
print(r.json())
Один адрес — все методы Bitcoin Core
Возможности
Что открывает Bitcoin RPC
Нода Bitcoin Core — эталонная реализация протокола. Через наш эндпоинт вы отправляете стандартные JSON-RPC вызовы и получаете ответы напрямую с ноды. Никакой дополнительной прослойки и никаких ограничений по методам.
Работа с транзакциями
getrawtransaction возвращает данные транзакции по её хэшу. sendrawtransaction отправляет подписанную транзакцию в сеть. Тело запроса прокси передаёт ноде без изменений.
Оценка комиссии
estimatesmartfee рассчитывает рекомендуемую комиссию для попадания транзакции в блок за заданное число подтверждений. Данные приходят напрямую с ноды.
Ключ с IP-ограничением
Ключ можно привязать к IP-адресам и подсетям CIDR ваших серверов. Запрос с незарегистрированного адреса получит ошибку 8003. Поддерживаются IPv4 и IPv6; до 50 записей на ключ.
Инфраструктура на нас
Синхронизация цепи Bitcoin, обновления клиента и мониторинг ноды — наша ответственность. Адрес вашего эндпоинта не меняется. Зачем вообще нужна полная история цепи — в статье об архивных нодах.
Статистика по запросам
В личном кабинете видно количество запросов к ноде Bitcoin, долю успешных и время ответа. Метрики собираются с первого дня без дополнительной настройки.
Подключение
Четыре шага до первых запросов к Bitcoin
От первого сообщения до рабочего Bitcoin RPC — обычно в тот же день.
01
Напишите нам
Напишите нам в чат поддержки на сайте: скажите, что нужен доступ к ноде Bitcoin. Мы откроем кабинет в день обращения.
02
Выпустите ключ
В личном кабинете создайте ключ. При необходимости добавьте IP-адреса серверов, с которых будут идти запросы к Bitcoin RPC.
03
Укажите адрес эндпоинта
Используйте https://nodes-api.cryptosafe.pro/proxy/bitcoin
как адрес Bitcoin RPC в вашем приложении.
Добавьте ключ в заголовок Authorization.
04
Отправляйте запросы
Методы Bitcoin Core работают как обычно — прокси прозрачен. В кабинете сразу начнёт накапливаться статистика.
Вопросы
Частые вопросы о Bitcoin RPC
Какой протокол использует нода Bitcoin?
Нода Bitcoin Core работает по JSON-RPC поверх HTTP POST. Запрос отправляется методом POST на адрес https://nodes-api.cryptosafe.pro/proxy/bitcoin с телом {"jsonrpc":"2.0","method":"...","params":[...],"id":1}. Ответ приходит от ноды без изменений.
Какие методы Bitcoin Core доступны?
Набор методов ничем не ограничен — прокси прозрачен и передаёт ноде любой вызов как есть. Типовые методы: getblockcount, getblockchaininfo, getblock, getrawtransaction, sendrawtransaction, estimatesmartfee.
Как передавать ключ аутентификации?
Ключ передаётся в заголовке Authorization без префикса Bearer. Пример: Authorization: ваш-ключ. Ключи выпускаются в личном кабинете; на компанию доступно до трёх ключей.
Можно ли ограничить доступ по IP?
Да. Каждый ключ можно привязать к списку IP-адресов и подсетей CIDR — до 50 записей. Поддерживаются IPv4 и IPv6. Пустой список означает доступ с любого IP. Вспомогательный эндпоинт https://nodes-api.cryptosafe.pro/info/getip вернёт ваш текущий адрес текстом.
Что означают коды ошибок сервиса?
Ошибки сервиса возвращаются с HTTP 400 и телом {"errorCode": N, "errorMessage": "..."}. Коды: 8001 — ключ не предоставлен, 8002 — неверный ключ, 8003 — IP не разрешён, 8004 — компания отключена, 8012 — ошибка апстрима, 8013 — таймаут апстрима. Таймаут запроса к ноде — 10 минут.
Нужен Bitcoin RPC для вашего сервиса?
Напишите в чат поддержки — откроем доступ к ноде Bitcoin Core в день обращения. Ключ выпускаете сами в кабинете, инфраструктуру держим мы.