---
title: "Tài liệu Arc RPC Endpoint"
description: "Dùng ERPC làm Arc Network RPC endpoint cho HTTP JSON-RPC request."
canonical: "https://erpc.global/vi/doc/arc-rpc/general/"
locale: "vi"
---

# Tài liệu Arc RPC Endpoint

## Tài liệu Arc RPC Endpoint

ERPC có thể được dùng làm Arc™ RPC endpoint cho HTTP JSON-RPC request. Arc RPC là một phần trong các RPC API của ERPC, nằm trong Global Edge Blockchain Infrastructure của chúng tôi, và API key có thể được quản lý từ ERPC Web Dashboard.

Bạn có thể dùng cùng một RPC key như với Solana, Ethereum và Avalanche.

Truyền API key của bạn qua tham số query `api-key`, hoặc gửi dưới dạng `Authorization: Bearer <YOUR_API_KEY>`. Khi có cả hai, tham số query sẽ được dùng.

### Endpoint

Gửi request JSON-RPC 2.0 dưới dạng HTTP POST đến:

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

Hoặc đến host chuyên dụng:

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

Chỉ chấp nhận request tại `/`.

### Ví dụ

Đây là ví dụ về HTTP request với API key trong tham số query.

```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"
}'
```

Đây là cùng request đó nhưng đặt API key trong header `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"
}'
```

Bạn có thể lấy và kiểm tra API key trên ERPC Web Dashboard: [ERPC Web Dashboard](https://dashboard.erpc.global/vi)

### Batch Request

Hỗ trợ batch JSON-RPC từ 1 đến 100 lệnh gọi cho mỗi HTTP request. Mỗi lệnh gọi cần có `id` riêng, và các giá trị `id` không được trùng nhau trong một batch. Mỗi lệnh gọi trong một batch được tính là một lệnh gọi riêng. Request body có kích thước tối đa 1 MiB.

### Đo lường mức sử dụng

Mức sử dụng được đo bằng token, và mức token có thể khác nhau tùy theo method. Mỗi lệnh gọi trong một HTTP batch được đo riêng biệt.

### Giới hạn của Gói Free

Trên Gói Free, tài khoản của bạn có thể gửi một request mỗi 10 giây. Giới hạn được tính theo tài khoản, không phải theo endpoint, nên một request tới chain khác cũng có thể được tính vào giới hạn này. Request gửi sớm hơn sẽ nhận phản hồi HTTP `429`, và header `retry-after` cho biết thời gian chờ tính bằng giây.

Trên Gói Free, một request chứa từ hai lệnh gọi JSON-RPC trở lên sẽ nhận phản hồi HTTP `429`, và không lệnh gọi nào trong đó được gửi đi: mỗi lệnh gọi nhận một lỗi JSON-RPC với mã `-32041`. Thay vào đó, hãy gửi từng lệnh gọi một.

### Phương thức được hỗ trợ

Endpoint này phục vụ 38 method sau đây, được nhóm theo namespace.

- `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`

Method hoặc path không có trong danh sách sẽ nhận phản hồi HTTP `400`.

### Mã trạng thái phản hồi

| Trạng thái HTTP | Ý nghĩa |
| --- | --- |
| 200 | Response JSON-RPC từ upstream. Lỗi JSON-RPC cũng được trả về với HTTP `200`: giữ nguyên `id` của request và `error.code`, `error.message` là `ERPC upstream error`, và không trả về `error.data`. |
| 400 | Method hoặc path nằm ngoài danh sách Phương thức được hỗ trợ, request JSON-RPC không hợp lệ, batch rỗng hoặc batch vượt quá 100 lệnh gọi, `id` bị trùng trong một batch, hoặc body vượt quá 1 MiB. |
| 401 | Thiếu API key hoặc API key không hợp lệ, hoặc không đáp ứng giới hạn IP hoặc Origin đã đặt cho key. |
| 405 | Phương thức request không phải POST. |
| 426 | Đã yêu cầu WebSocket Upgrade. Endpoint này chỉ hỗ trợ HTTP. |
| 429 | Bị giới hạn tốc độ, bao gồm các giới hạn của Gói Free ở trên: nhiều hơn một request mỗi 10 giây, hoặc từ hai lệnh gọi trở lên trong một request. Nếu có header `retry-after`, hãy chờ đúng số giây đó. |
| 502 | Không thể hoàn tất request tới upstream: response từ upstream bị lỗi, response vượt quá 8 MiB, hoặc không có phản hồi trong vòng 30 giây. |
| 503 | Dịch vụ tạm thời không khả dụng. |

### Phương thức Arc RPC và tài liệu

Tài liệu Arc mô tả các method JSON-RPC chuẩn của Ethereum trên Arc và có liên kết đến tài liệu tham chiếu về tham số của các method này. Method không có trong danh sách ở trên sẽ nhận phản hồi HTTP `400`, kể cả khi tài liệu Arc có liệt kê method đó.

[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.
