---
title: "Документация Arc RPC endpoint"
description: "Используйте ERPC как Arc Network RPC endpoint для HTTP JSON-RPC запросов."
canonical: "https://erpc.global/ru/doc/arc-rpc/general/"
locale: "ru"
---

# Документация Arc RPC endpoint

## Документация Arc RPC endpoint

Используйте ERPC как ваш Arc™ RPC endpoint для HTTP JSON-RPC запросов. Arc RPC входит в RPC API ERPC в рамках нашей Global Edge Blockchain Infrastructure, а управление API key доступно через ERPC Web Dashboard.

Вы можете использовать тот же RPC key, что и для Solana, Ethereum и Avalanche.

Передайте ваш API key в параметре запроса `api-key` или отправьте его как `Authorization: Bearer <YOUR_API_KEY>`. Если указаны оба варианта, используется параметр запроса.

### Эндпоинты

Отправляйте запросы JSON-RPC 2.0 как HTTP POST на:

```text
https://edge.erpc.global/arc?api-key=<YOUR_API_KEY>
```

или на выделенный хост:

```text
https://arc.erpc.global?api-key=<YOUR_API_KEY>
```

Запросы принимаются только по пути `/`.

### Примеры

Пример HTTP-запроса с API key в параметре запроса.

```bash
curl 'https://edge.erpc.global/arc?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_blockNumber"
}'
```

Тот же запрос с API key в заголовке `Authorization`.

```bash
curl 'https://edge.erpc.global/arc' --header 'Content-Type: application/json' --header 'Authorization: Bearer <YOUR_API_KEY>' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_blockNumber"
}'
```

Получить и проверить ваш API key можно на ERPC Web Dashboard: [ERPC Web Dashboard](https://dashboard.erpc.global/ru)

### Batch-запросы

Поддерживаются batch-запросы JSON-RPC: от 1 до 100 вызовов в одном HTTP-запросе. У каждого вызова должен быть свой `id`, и значения `id` внутри одного batch не должны повторяться. Каждый вызов в batch тарифицируется как отдельный вызов. Размер тела запроса — до 1 MiB.

### Тарификация использования

Использование тарифицируется в токенах, и ставка в токенах может различаться в зависимости от метода. Каждый вызов в HTTP batch тарифицируется отдельно.

### Ограничения тарифа Free

На тарифе Free ваш аккаунт может отправлять один запрос в 10 секунд. Лимит считается по аккаунту, а не по endpoint, поэтому запрос к другой сети тоже может засчитываться в этот лимит. На запрос, отправленный раньше, возвращается HTTP `429`, а заголовок `retry-after` указывает время ожидания в секундах.

На тарифе Free на запрос, содержащий два или более вызова JSON-RPC, возвращается HTTP `429`, и ни один из его вызовов не отправляется: каждый вызов получает ошибку JSON-RPC с кодом `-32041`. Отправляйте такие вызовы по одному.

### Поддерживаемые методы

Endpoint обслуживает следующие 38 методов, сгруппированных по пространствам имён.

- `eth_*` (24): `eth_blockNumber`, `eth_call`, `eth_chainId`, `eth_estimateGas`, `eth_feeHistory`, `eth_gasPrice`, `eth_getBalance`, `eth_getBlockByHash`, `eth_getBlockByNumber`, `eth_getBlockReceipts`, `eth_getBlockTransactionCountByHash`, `eth_getBlockTransactionCountByNumber`, `eth_getCode`, `eth_getLogs`, `eth_getProof`, `eth_getStorageAt`, `eth_getTransactionByBlockHashAndIndex`, `eth_getTransactionByBlockNumberAndIndex`, `eth_getTransactionByHash`, `eth_getTransactionCount`, `eth_getTransactionReceipt`, `eth_maxPriorityFeePerGas`, `eth_sendRawTransaction`, `eth_syncing`
- `net_*` (3): `net_listening`, `net_peerCount`, `net_version`
- `web3_*` (2): `web3_clientVersion`, `web3_sha3`
- `txpool_*` (3): `txpool_content`, `txpool_inspect`, `txpool_status`
- `debug_*` (4): `debug_traceBlockByHash`, `debug_traceBlockByNumber`, `debug_traceCall`, `debug_traceTransaction`
- `trace_*` (2): `trace_block`, `trace_transaction`

На метод или путь, которого нет в списке, возвращается HTTP `400`.

### Коды состояния ответа

| HTTP-статус | Значение |
| --- | --- |
| 200 | Ответ JSON-RPC от upstream. Ошибка JSON-RPC тоже возвращается с HTTP `200`: в ней сохраняются `id` запроса и `error.code`, в `error.message` стоит `ERPC upstream error`, а `error.data` не возвращается. |
| 400 | Метод или путь вне раздела «Поддерживаемые методы», некорректный запрос JSON-RPC, пустой batch или batch из более чем 100 вызовов, повторяющийся `id` в batch или тело запроса больше 1 MiB. |
| 401 | API key отсутствует или недействителен либо не выполнено ограничение по IP или Origin, заданное для ключа. |
| 405 | HTTP-метод запроса, отличный от POST. |
| 426 | Запрошен WebSocket Upgrade. Endpoint работает только по HTTP. |
| 429 | Ограничение скорости, включая описанные выше ограничения тарифа Free: более одного запроса в 10 секунд или два и более вызова в одном запросе. Если в ответе есть заголовок `retry-after`, подождите указанное в нём число секунд. |
| 502 | Не удалось выполнить upstream-запрос: upstream вернул ответ с ошибкой, ответ превышает 8 MiB или ответа нет в течение 30 секунд. |
| 503 | Сервис временно недоступен. |

### Методы Arc RPC и документация

В документации Arc описаны стандартные методы Ethereum JSON-RPC на Arc и даны ссылки на справочник по их параметрам. На метод, которого нет в списке выше, возвращается HTTP `400`, даже если он указан в документации Arc.

[https://docs.arc.io/arc/references/rpc-endpoints](https://docs.arc.io/arc/references/rpc-endpoints)

Arc is a trademark of Circle Internet Group, Inc. and/or its affiliates.
