RPC URL для Base: доступ без ключа, примеры для curl и viem

Начните с публичного RPC URL для Base mainnet ниже, чтобы запросить chain ID без API key. Ознакомьтесь с поддерживаемыми методами и лимитами на IP на странице сети Base; используйте ключ для методов, выходящих за рамки public.methods, разрешенных сетью.

curl -sS "https://api.blockvectra.com/v1/base_mainnet/public" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

Информация о сети и эндпоинты

Каждый запрос к Base явно определяет целевую сеть в пути URL с помощью слага base_mainnet. JSON-RPC поддерживает аутентификацию по ключу как в пути URL, так и в заголовке запроса (x-api-key).

Примеры вызовов через curl и viem

Вы можете выполнять вызовы JSON-RPC напрямую с помощью curl или клиентских библиотек web3, таких как viem. Задайте свой API key в переменной окружения BLOCKVECTRA_API_KEY:

curl -s "https://api.blockvectra.com/v1/base_mainnet" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

Структура ответа

Ответы соответствуют спецификации JSON-RPC 2.0:

• Успешный ответ: возвращает объект, содержащий jsonrpc: "2.0", соответствующий целочисленный id и результат result в шестнадцатеричной кодировке (eth_chainId возвращает chain ID в шестнадцатеричном виде; eth_blockNumber возвращает высоту последнего блока).
• Запрещенные методы: запрос метода, не входящего в список разрешенных методов сети, возвращает код ошибки JSON-RPC -32601 (method not available, не тарифицируется).
• Запросы за пределами окна: запросы исторического состояния старше окна хранения состояния возвращают код ошибки JSON-RPC -32011 (не тарифицируется).
• Отсутствующий API key: отправка запроса без ключа возвращает HTTP 401 с кодом ошибки JSON-RPC -32024 (missing_api_key, не тарифицируется).
• Некорректные параметры: неверные параметры запроса возвращают код ошибки JSON-RPC -32602 (не тарифицируется).

Возможности и политика методов

Актуальные значения: GET /v1/chains (methods, max_logs_block_range, state_window_blocks).

Blockchain Data API

Актуальные значения: GET /v1/chains (data).

Начало работы и API keys

• Веб-консоль: зарегистрируйтесь с помощью подписи кошелька Ethereum и создайте API key в консоли. Подробности настройки см. в руководстве Быстрый старт.
• Программная регистрация: автономные ИИ-агенты, автоматизированные скрипты и CI-пайплайны могут входить в систему и создавать API keys с помощью подписей кошелька Ethereum (EIP-191) без браузера. Следуйте руководству по программной регистрации.
• ИИ-агенты: автономные ИИ-агенты могут определять возможности Base через официальный сервер Model Context Protocol (MCP). См. Подключение ИИ-агентов к BlockVectra.
• Повышение лимитов: после пополнения ограничение на количество вызовов в секунду для всего аккаунта снимается; для каждого ключа продолжают действовать лимиты скорости Compute Units (CU) и лимиты всплесков (burst). Актуальные тарифы и расчетные единицы см. на странице Цены.

Связанные руководства и ресурсы

• Документация для разработчиков Base: спецификации сети, механику газа и контракты на Base см. в официальной документации Base.
• Пользовательский RPC для кошельков: настройте пользовательские эндпоинты RPC для Base в MetaMask и Rabby с помощью руководства по пользовательским RPC в кошельках.
• Симуляция транзакций: тестируйте выполнение транзакций и оценивайте изменения состояния перед их отправкой в сеть с помощью eth_simulateV1 в руководстве по симуляции транзакций.

Следующие шаги

• Изучите каталог наборов данных, чтобы увидеть все наборы данных, индексируемые BlockVectra.
• Ознакомьтесь с бесплатным тарифом и ценами, чтобы узнать, что включено в ваш аккаунт.
• Войдите в консоль, чтобы создать API key.