공용 RPC

https://rpc.arc-scan.io는 Arc 메인넷을 위한 무료 JSON-RPC 엔드포인트이며, 여러 독립적인 제공자를 앞에 두고 있어 한 제공자의 장애가 여러분에게 보이지 않습니다.

엔드포인트#

호스트명 하나, 체인 하나, 자격 증명 없음. 일반적인 읽기 메서드에 답하고, 짧은 목록의 다른 메서드는 정책에 따라 거절하며, 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는 대략 0.5초마다 블록을 생성하므로, 이 숫자는 읽으시는 동안에도 움직입니다.

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입니다.

동작하는 메서드를 모두 나열하기보다 이렇게 생각하십시오: 아래에서 거절하지 않는 것은 모두 전달됩니다. 어떤 출처도 제공하지 않는 메서드는 data.reason이 method_not_served인 -32601로 돌아오며, 이는 정책상의 거절과는 다른 사실이고 그렇다고 밝힙니다.

무엇을 거절하는가#

거절은 의도된 것이며, 각각 누가 정했고 왜인지를 밝힙니다. 그 이유는 기계가 읽을 수 있습니다: 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"
    }
  }
}