Публичный RPC

https://rpc.arc-scan.io — это бесплатная точка JSON-RPC для основной сети Arc, стоящая перед несколькими независимыми поставщиками, поэтому отказ одного из них для вас не виден.

Точка#

Одно имя хоста, одна сеть, никаких учётных данных. Она отвечает на обычные методы чтения, по политике отказывает в коротком списке других и на web3_clientVersion представляется как arcscan-rpc-gateway/1 — так вы и понимаете, что дошли до нас, а не до какой-то другой точки, настроенной в вашем кошельке.

Ваш первый вызов#

Регистрироваться не нужно нигде, поэтому первый вызов и есть всё начало работы. Спросите, с какой сетью вы разговариваете:

curl -s -X POST https://rpc.arc-scan.io \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId"}'

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x13b2"
}

И голову цепи. Arc выпускает блок примерно раз в полсекунды, поэтому это число сдвигается, пока вы его читаете.

curl -s -X POST https://rpc.arc-scan.io \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber"}'

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0xe2a22d"
}

Пакеты#

На JSON-массив вызовов приходит массив результатов в порядке id. До 50 записей и 131 072 байт на запрос; при превышении любого из двух весь запрос отклоняется с 413 ещё до того, как что-либо из него выполнится.

curl -s -X POST https://rpc.arc-scan.io \
  -H 'content-type: application/json' \
  -d '[{"jsonrpc":"2.0","id":1,"method":"eth_chainId"},
       {"jsonrpc":"2.0","id":2,"method":"eth_blockNumber"}]'

[
  {
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x13b2"
  },
  {
    "jsonrpc": "2.0",
    "id": 2,
    "result": "0xe2a22e"
  }
]

На что она отвечает#

Обычные методы чтения eth_ работают: получение блока, транзакции и квитанции, eth_getBalance, eth_call, eth_getLogs, eth_gasPrice, eth_estimateGas. Четыре метода точка отвечает сама, без единого исходящего запроса, — eth_chainId, net_version, web3_clientVersion и eth_accounts, который возвращает пустой массив, потому что аккаунтов мы не держим.

Вместо того чтобы публиковать список всех работающих методов, спросите иначе: всё, что не отклонено ниже, пересылается. Метод, которого не предлагает ни один источник, возвращается как -32601 с data.reason, равным method_not_served, — это другой факт, нежели отказ по политике, и он об этом говорит.

В чём она отказывает#

Отказы намеренны, и каждый называет, кто решил и почему. Причина машиночитаема: error.data.reason равно refused_by_policy, а error.data.policy — один из слагов ниже; именно это клиенту и следует читать, чтобы решить, может ли повторный запрос позже хоть чем-то помочь. Ни для одного слага отсюда — не может.

curl -s -X POST https://rpc.arc-scan.io \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_sendTransaction","params":[{}]}'

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "arc-scan.io does not serve eth_sendTransaction on this endpoint. This is our own policy decision, not a limitation of the Arc network. This endpoint holds no keys and will not forward a signing request. Sign locally and use eth_sendRawTransaction.",
    "data": {
      "reason": "refused_by_policy",
      "method": "eth_sendTransaction",
      "policy": "no_custody",
      "documentation": "https://arc-scan.io/developers"
    }
  }
}

Отправка транзакции#

Ключей мы не держим, поэтому каждый метод, который потребовал бы владения ключом, отклоняется — подписывайте локально. Уже подписанную транзакцию отправить можно: eth_sendRawTransaction пересылается и намеренно уходит ровно к одному поставщику и никогда не повторяется, потому что прокси, повторяющий отправку, мог бы отправить вашу транзакцию дважды.

Переключение при отказе#

За одним именем хоста стоит несколько независимых поставщиков основной сети Arc. Вызов, не удавшийся у одного, повторяется у другого; поставщик, начавший отдавать ошибки или ограничивать нас по частоте, остывает и пропускается, и ничто из этого в вашем ответе не видно: вы получаете ответ или честную ошибку и никогда — намёка на то, какой источник вас обслужил. Кто они, мы не публикуем.

Ограничения и ошибки#

Запросы ограничены по частоте на каждого вызывающего. Порог мы здесь не публикуем — единственная величина, которую мы могли бы назвать, это настроенная, а встречаете вы развёрнутый периметр, — поэтому считайте сигналом 429, соблюдайте его retry-after и отступайте, а не подстраивайтесь под число. Ограничения по размеру точны и названы в самом отказе.

HTTP/1.1 429 Too Many Requests
retry-after: 1
content-type: application/json

{
  "jsonrpc": "2.0",
  "id": null,
  "error": {
    "code": -32005,
    "message": "arc-scan.io is rate limiting requests from this client. Retry shortly.",
    "data": {
      "reason": "edge_rate_limited",
      "retry_after_seconds": 1,
      "scope": "client"
    }
  }
}