API ドキュメント

型付き API は /v1 配下にあります。このサイト自体がこの面からレンダリングされているため、ページで見えるものはすべて同じ形の JSON としても読み取れます。

互換 API は /api?module=…&action=… にあります。ウォレット、インデクサ、デプロイスクリプト、ボットがすでに話している事実上標準のエクスプローラ REST 契約を再現しているため、既存のツールはベース URL を 1 つ変えるだけで Arc に向けられます。result 内のスカラー値はすべて、その契約が要求するとおり文字列です。

GET /v1/blocks/latest
GET /api?module=proxy&action=eth_blockNumber
GET /api?module=account&action=balance&address=0x…

上の例はメソッドと経路で、前にホストは付いていません。公開された API のベース URL はまだ無く、書けません — このページ冒頭の告知をご覧ください。

大文字小文字:

JSON のキーは snake_case です。ワイヤ上のアドレスとハッシュは小文字で、表示形は checksum フィールドが持ちます。入力側はどの大文字小文字でも受け付けます。

大きな整数:

2⁵³ を超えうる値 — 金額、ガス、供給量 — はすべて十進文字列です。ブロック高は JSON の数値です。金額を JavaScript の number としてパースすると、静かに壊れます。

金額:

金額は Money オブジェクトでやり取りします。raw（整数文字列）、decimals、formatted（正確・完全精度）、usd、symbol です。小数桁は必ずコントラクトから読み取ります。シンボルからスケールを推測してはいけません。

時刻:

Unix 秒であり、あらかじめ整形されることはありません。ブロックのタイムスタンプは 1 秒分解能ですが、ブロックは毎秒 2 つほど到着するため、タイムスタンプは全順序になりません。これで並べ替えたりページ送りしたりしないでください。

ページング:

ページ番号ではなく不透明なカーソルです。Arc には再編成がないため、カーソルは永久に有効です。ウィンドウ付きのエンドポイントは、実際に走査したブロック範囲も返します。

エラー:

{"error":{"code":"NOT_FOUND","message":"…","detail":null}}

コード: INVALID_INPUT（400）、NOT_FOUND（404）、RATE_LIMITED（429）、CAPABILITY_UNAVAILABLE（501）、UPSTREAM_ERROR（502）、UPSTREAM_TIMEOUT（504）。

キャッシュ:

コミット済みブロック高やマイン済みトランザクションハッシュをキーとするものはすべて不変であり、Cache-Control: public, max-age=31536000, immutable とともに配信されます。確率的なチェーンには出せない強い保証であり、これを前提に作る価値があります。

/v1/stream/head は、コミットされたブロックごとに head イベントを 1 件ずつ送出する server-sent event ストリームです。ペイロードに server_now が入っているため、クライアントはブラウザの時計を信じるのではなく時計のずれを補正できます。

event: head
data: {"height":54190133,"hash":"0x…","timestamp":1785345456,"tx_count":11,"server_now":1785345456}

ペンディングトランザクションのストリームはありません。このチェーンでは mempool 名前空間が無効で、ブロック時間が 0.5 秒では、ペンディング表示がトランザクションを見せている時間より読む時間のほうが長くなります。

ガスはドルで支払われます:

ガストークンは USDC です。手数料、残高、トランザクションの金額はドル建てであり、Arcscan はオラクルを一切介さず正確なドル額を示します。

互換 API では値は小数 18 桁のままです:

value、gasPrice、gasUsed、cumulativeGasUsed は小数 18 桁の整数文字列のままです。10¹⁸ で割れば正しいドル額になります。こちらで「気を利かせて」スケールを変えることは決してありません。そうすれば連携するボットがすべて 1 兆倍ずれます。

1 つのドル、2 つの表現:

ネイティブ残高は小数 18 桁、同じ資産の ERC-20 インターフェースは 6 桁です。プリコンパイルが両者を等価に保つため、erc20 = native / 10^12 が厳密に成り立ちます。account.balance はネイティブの値を、account.tokenbalance は ERC-20 の値を返します。どちらも正しく、足し合わせると同じドルを二重に数えることになります。

トークンの小数桁は決して仮定しません:

tokenDecimal は常にコントラクトから読み取ります。このチェーンでは 2 つのコントラクトが同じシンボルで異なるスケールを使えるため、シンボルから小数桁を引く表は構造的に誤りです。

ファイナリティは決定的です:

confirmations は互換のために出力され、その隣に追加で isFinalized が出力されます。確率的な安全域はありません。コミットされたブロックはファイナルです。Arcscan は自身の画面で確認数を表示しません。

フィールド名の綴りはそのままです:

互換面のメソッド名とフィールド名はプロトコルの識別子であり、そのまま再現されるので既存クライアントは動き続けます。Arc のものは値だけです。

これらは HTTP 200 とともに標準のエラーエンベロープを返します。クライアントライブラリがそのまま落ちないよう 404 は使いません。ひとつの決まり文句ではなく、それぞれが固有の理由を載せます — 当サイトが構築していないインデックス、Arc そのものの構造的な性質、あるいは別名で動いているエンドポイントです。

• account.getminedblocks
• account.tokennfttx
• account.token1155tx
• account.addresstokennftbalance
• token.tokeninfo
• contract.verifysourcecode

NFT 履歴の 2 つのアクションが最もよく求められますが、いずれもアドレス指定では答えられません。ERC-20 版の account.tokentx は答えられますが、startblock と endblock を明示する必要があります。

レート制限:

IP ごとのトークンバケットで、アプリケーションではなくエッジで適用されます。外部の呼び出し元に適用される枠はまだ決まっていないため、ここには数字を書きません。API が開いたときにこのページに載せます。

ログ範囲:

ログクエリは最大ブロックスパンに制限されます。範囲を超える要求は黙って切り詰められるのではなく、メッセージに最大値を明示して拒否されます。

重いエンドポイント:

trace と state-diff のエンドポイントは、実時間の予算とレスポンスサイズの上限を持つ小さな専用プールで動作し、ハングする代わりに truncated: true を報告します。