---
title: "Tài liệu Solana RPC Endpoint"
description: "Dùng ERPC làm Solana RPC endpoint độ trễ thấp cho HTTP JSON-RPC request và WebSocket subscription."
canonical: "https://erpc.global/vi/doc/rpc/general/"
locale: "vi"
---

# Tài liệu Solana RPC Endpoint

## Tài liệu Solana RPC Endpoint

ERPC có thể được dùng làm Solana RPC endpoint cho HTTP JSON-RPC request và WebSocket subscription. Cùng một endpoint Solana hoạt động với các phương thức RPC chuẩn, và API key có thể được quản lý từ ERPC Web Dashboard.

Thêm API key của bạn vào tham số 'api-key'.

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

### Ví dụ

Ví dụ HTTP request:

```bash
curl https://edge.erpc.global?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"getBlockHeight"
}'
```

Ví dụ WebSocket subscription. Host giống với HTTP.

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

```bash
# Ví dụ: subscribe cập nhật slot
wscat -c "wss://edge.erpc.global?api-key=<YOUR_API_KEY>"
# Sau khi kết nối, gửi:
{"jsonrpc":"2.0","id":1,"method":"slotSubscribe"}
```

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)

Nếu bạn cần độ trễ thấp hơn WebSocket, hãy cân nhắc Geyser gRPC hoặc ShredStream. Bạn có thể thảo luận chi tiết với chúng tôi trong ERPC Web Dashboard.

### History Access

Thêm `history=true` vào URL `edge.erpc.global` của một HTTP request để truy xuất block và giao dịch cũ; giá trị phải đúng là `true`, viết thường. Trừ `getTransactionsForAddress`, một request không có `history=true` được trả lời từ phạm vi gần đây mà mỗi node lưu giữ; tùy chọn này áp dụng cho các phương thức sau:

- `getBlock`
- `getBlockTime`
- `getBlocks`
- `getBlocksWithLimit`
- `getTransaction`, bao gồm `getParsedTransaction`
- `getSignaturesForAddress`
- `getSignatureStatuses`, khi `searchTransactionHistory` là `true`
- `getTransactionsForAddress`, khi `transactionDetails` là `"full"` (cần có History Access)

Đặt API key và tùy chọn trong URL dưới dạng query parameter:

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

Hoặc gửi `Authorization: Bearer <YOUR_API_KEY>` dưới dạng header, với tùy chọn trong URL:

```text
https://edge.erpc.global?history=true
```

Ví dụ HTTP request sử dụng History Access.

```bash
curl 'https://edge.erpc.global?history=true' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "jsonrpc":"2.0","id":1,
  "method":"getBlock",
  "params":[<SLOT>,{"maxSupportedTransactionVersion":1}]
}'
```

Với mọi phương thức trừ `getTransactionsForAddress` ở chế độ `"full"`:

- Mỗi lệnh gọi được History Access trả lời tốn tổng cộng 640 + 82 × N token, thay cho giá thông thường của nó.
- Với `getSignatureStatuses`, N là số signature trong `params[0]`: 10 signature tốn 640 + 82 × 10 = 1.460 token. Với mọi phương thức khác, N bằng 1, nên một lệnh gọi được History Access trả lời tốn 640 + 82 = 722 token. Ví dụ, một lệnh gọi `getBlock` tốn 722 token khi được History Access trả lời và 420 token khi được trả lời từ dữ liệu gần đây.
- Kết quả `null`, rỗng hoặc một phần từ History Access cũng được tính theo giá History Access. Một lần truy xuất thất bại chỉ tốn giá thông thường.
- Một lệnh gọi được trả lời từ dữ liệu gần đây giữ nguyên giá thông thường, kể cả khi có `history=true`.
- Một batch tính từng lệnh gọi riêng.
- Đừng thêm `history=true` khi polling các giao dịch gần đây: mỗi `null` ở đó đều được tính theo giá History Access.

Hạn mức miễn phí, bao gồm hạn mức của Gói Free, có giới hạn cho History Access. Gói Free bị giới hạn ở một request History Access mỗi 10 giây.

Một lệnh gọi `getTransactionsForAddress` với `transactionDetails` đặt là `"full"` là History Access, dù các giao dịch mới hay cũ:

- Lệnh gọi này bắt buộc có `history=true` trong URL `edge.erpc.global`. Một request không có tùy chọn này bị từ chối với lỗi History Access (mã `-32011`) và không mất phí.
- Với `history=true`, lệnh gọi tốn 640 + 82 × N token, trong đó N là số giao dịch được lấy về, dù mới hay cũ: 100 giao dịch tốn 640 + 82 × 100 = 8.840 token. Một dòng không có giao dịch không được tính.
- Lệnh gọi phải được gửi dưới dạng một request riêng. Một batch chứa nó bị từ chối, dù có hay không có `history=true`: mỗi lệnh gọi trong batch được trả lời bằng lỗi `-32600` và thông báo `This request is not available in a mixed JSON-RPC batch. Please send it as a separate request.`, và không lệnh gọi nào được gửi.

Chế độ `signatures` mặc định không cần `history=true` và tốn mức giá thông thường 420 token. Để polling một địa chỉ tìm giao dịch mới, hãy dùng chế độ `signatures` và lấy những giao dịch bạn cần bằng `getTransaction`.

Việc truy xuất block hoặc giao dịch cũ có thể mất nhiều thời gian hơn đáng kể so với một request thông thường, trong một số trường hợp là vài giây. History Access là một tùy chọn riêng, tách các lần truy xuất này khỏi request thông thường, để request thông thường vẫn nhanh.

Khi không có `history=true`, một request `getBlock` hoặc `getBlockTime` cho một slot cũ có thể trả về lỗi này:

```json
{
  "jsonrpc": "2.0",
  "error": {
    "code": -32011,
    "message": "This request needs history access. Add history=true to the endpoint URL.",
    "data": {
      "erpcCode": "ERPC_HISTORY_OPTION_REQUIRED"
    }
  },
  "id": 1
}
```

`getTransaction`, `getParsedTransaction` và `getSignatureStatuses` (với `searchTransactionHistory: true`) trả về `null` cho một signature cũ hơn những gì node lưu giữ, còn `getSignaturesForAddress`, `getBlocks` và `getBlocksWithLimit` trả về kết quả rỗng hoặc một phần.

Một request có `history=true` có thể trả về các thông báo sau:

- `This plan has reached its limit for history access. Add a paid plan to use tokens for history access.` — hiển thị khi một hạn mức, chẳng hạn hạn mức của Gói Free, đạt giới hạn.
- `History access is unavailable while your token balance is low. Add tokens.` — hiển thị ở gói trả phí khi số dư token thấp.
- `On the Free plan, history access is limited to one request per 10 seconds. Slow down or use a paid plan.` — hiển thị ở Gói Free khi các request History Access đến quá nhanh.

### Các phương thức Unlimited Endpoint hỗ trợ

Unlimited Endpoint là các HTTP endpoint chuyên dụng, được tối ưu cho các lệnh gọi Solana RPC tiêu chuẩn có độ trễ thấp. Các phương thức Solana RPC tiêu chuẩn được hỗ trợ là:

- `getSlot`
- `getBlockHeight`
- `getLatestBlockhash`
- `getBalance`
- `getAccountInfo`
- `getMultipleAccounts`
- `getTransaction`
- `sendTransaction`
- `simulateTransaction`
- `getSignatureStatuses`
- `getRecentPrioritizationFees`
- `getHealth`
- `getVersion`
- `getEpochInfo`
- `getBlock`

Với các phương thức ngoài nhóm được hỗ trợ này, hãy dùng `https://edge.erpc.global?api-key=<YOUR_API_KEY>`.

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

Để xem danh sách đầy đủ các phương thức, tham số và đặc tả subscription, hãy tham khảo tài liệu chính thức. Tài liệu này bao gồm cả HTTP và WebSocket.

[https://solana.com/docs/rpc](https://solana.com/docs/rpc)
