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