Base RPC URL: доступ без ключа, приклади 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 підтримує як автентифікацію з ключем у шляху, так і через заголовок запиту (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 повертає hex-значення 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 у Консолі. Деталі налаштування див. у Посібнику зі швидкого старту.
• Програмна реєстрація: автономні AI-агенти, автоматизовані скрипти та конвеєри CI можуть входити та отримувати API keys за допомогою підписів Ethereum-гаманців (EIP-191) без браузера. Дотримуйтесь Посібника з програмної реєстрації.
• AI-агенти: автономні AI-агенти можуть досліджувати можливості Base за допомогою офіційного сервера Model Context Protocol (MCP). Див. Підключення AI-агентів до BlockVectra.
• Підвищення лімітів: після поповнення обмеження кількості викликів на секунду для всього акаунта знімається; для кожного ключа продовжують діяти ліміти швидкості та burst у Compute Units (CU). Актуальні тарифи та розрахункові одиниці див. на Сторінці цін.

Пов'язані посібники та ресурси

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

Наступні кроки

• Перегляньте каталог наборів даних, щоб побачити кожен набір даних, який індексує BlockVectra.
• Ознайомтеся з безкоштовним планом та цінами, щоб перевірити, що включено у ваш акаунт.
• Увійдіть до консолі, щоб створити API key.