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'.
endpoint
Ví dụ
Ví dụ HTTP request:
bash
Ví dụ WebSocket subscription. Host giống với HTTP.
endpoint
bash
Bạn có thể lấy và kiểm tra API key trên ERPC Web Dashboard: ERPC Web Dashboard
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:getBlockgetBlockTimegetBlocksgetBlocksWithLimitgetTransaction, bao gồmgetParsedTransactiongetSignaturesForAddressgetSignatureStatuses, khisearchTransactionHistorylàtruegetTransactionsForAddress, khitransactionDetailslà"full"(cần có History Access)
Đặt API key và tùy chọn trong URL dưới dạng query parameter:
endpoint
Hoặc gửi
Authorization: Bearer <YOUR_API_KEY> dưới dạng header, với tùy chọn trong URL:endpoint
Ví dụ HTTP request sử dụng History Access.
bash
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 trongparams[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ọigetBlocktố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=truekhi polling các giao dịch gần đây: mỗinullở đó đề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=truetrong URLedge.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-32600và thông báoThis 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
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à:
getSlotgetBlockHeightgetLatestBlockhashgetBalancegetAccountInfogetMultipleAccountsgetTransactionsendTransactionsimulateTransactiongetSignatureStatusesgetRecentPrioritizationFeesgetHealthgetVersiongetEpochInfogetBlock
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.






