Документация Arcscan

Начните с того, что вам нужно#

Шесть мест, которые стоит прочитать первыми. Каждое из них — страница этой документации, а не экран обозревателя.

Разберитесь в данных#

Каждая величина в Arcscan либо прочитана с ноды, либо вычислена по нашему собственному индексу цепи. Держать в голове нужно только это различие: у цепи краёв нет, а у индекса их несколько.

Следование за головой цепи#

Arc выпускает блок примерно раз в полсекунды — 506 мс в основной сети и 536 мс в тестовой, измерено 2026-08-10 — и сообщает о финальности как о instant, поэтому существующий блок уже окончателен и никаких реорганизаций пережидать не нужно. Индексатор идёт следом за головой цепи, а не стоит на ней, поэтому самые новые блоки могут существовать в цепи за мгновение до того, как Arcscan сможет о них ответить: в момент измерения индекс основной сети отставал от головы на 13 блоков — примерно семь секунд. Пока этот разрыв закрывается, ничего не скрывается: блок, до которого Arcscan ещё не дошёл, читается как не проиндексированный, но никогда как пустой.

Проиндексированная история#

В основной сети индекс доходит до начала цепи: один непрерывный диапазон с блока 0 по блок 14 852 068, без пропусков внутри, измерено 2026-08-10. В тестовой — нет: история тестовой сети в Arcscan начинается с блока 53 500 000, а 53 500 000 блоков ниже этой границы здесь не проиндексированы вовсе, поэтому ответить о них не может ни одна поверхность Arcscan. Пустой ответ по этому диапазону — это наша недостающая история, а не история цепи. Третий поток, traces, не содержит в основной сети ни одного проиндексированного блока, поэтому история внутренних вызовов основной сети сегодня из индекса недоступна.

Вычисленные значения#

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

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

Параметры сетей#

Обе сети рядом, по измерению нашего собственного API от 2026-08-10.

Каждое имя хоста обслуживает ровно одну сеть: arc-scan.io — это основная сеть 5042 и ничто иное, testnet.arc-scan.io — это 5042002 и ничто иное. Верификация контрактов в основной сети недоступна, потому что Sourcify не числит сеть 5042: сегодня ни один контракт в этой сети верифицировать нельзя — ни через Arcscan, ни через любой другой клиент Sourcify. Ничто там не ждёт нас; оно ждёт, когда сеть добавят на стороне Sourcify. В тестовой сети верификация работает, но то, что держит Arcscan, — это кеш, наполняемый по первому запросу, поэтому число контрактов, исходники которых у него есть, много меньше числа верифицированных.

Наш публичный RPC работает только с основной сетью, только на чтение и отвечает на обычные методы чтения, стоя перед несколькими независимыми поставщиками с переключением при отказе. Убедиться, до какой сети вы дошли, можно одним вызовом:

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

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

Методы, ограничения и поведение при отказе — в разделе Публичный RPC; HTTP-API данных, на котором работает сам обозреватель, — в разделе REST API.

Знайте границы#

Arcscan документирует то, что может показать, и вслух отказывается от остального. Три страницы несут все известные нам ограничения, и прочитать их быстрее, чем наткнуться на одно из них ровно тогда, когда оно понадобится.

• Полнота данных — что проиндексировано, по сетям и по потокам, и что отвечает каждая поверхность, когда её спрашивают за краем.
• Глоссарий — слова, которыми пользуется этот обозреватель, и те немногие, которые в Arc значат не то же самое, что в знакомых вам сетях.
• Частые вопросы — вопросы, с которыми читатели действительно приходят, с короткими ответами.