Tài liệu NEAR RPC Endpoint | ERPC
Tài liệu NEAR RPC Endpoint
ERPC có thể được dùng làm NEAR RPC endpoint cho HTTP JSON-RPC request. NEAR RPC là một phần trong RPC APIs 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/near?api-key=<YOUR_API_KEY>https://edge.erpc.global/near?api-key=<YOUR_API_KEY>Hoặc đến host chuyên dụng:
text
https://near.erpc.global?api-key=<YOUR_API_KEY>https://near.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/near?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"block",
"params":{"finality":"final"}
}'curl 'https://edge.erpc.global/near?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"block",
"params":{"finality":"final"}
}'Đây là cùng request đó nhưng đặt API key trong header
Authorization.bash
curl 'https://edge.erpc.global/near' --header 'Content-Type: application/json' --header 'Authorization: Bearer <YOUR_API_KEY>' --data '{
"jsonrpc":"2.0","id":1,
"method":"block",
"params":{"finality":"final"}
}'curl 'https://edge.erpc.global/near' --header 'Content-Type: application/json' --header 'Authorization: Bearer <YOUR_API_KEY>' --data '{
"jsonrpc":"2.0","id":1,
"method":"block",
"params":{"finality":"final"}
}'Bạn có thể lấy và kiểm tra API key trên ERPC Web Dashboard: ERPC Web Dashboard
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à tỷ lệ 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. Hãy gửi từng lệnh gọi một thay vào đó.Phương thức được hỗ trợ
Endpoint này phục vụ các method NEAR JSON-RPC sau đây. Các method
EXPERIMENTAL_ được gửi kèm tiền tố viết hoa.- Method (17):
EXPERIMENTAL_changes_in_block,EXPERIMENTAL_genesis_config,EXPERIMENTAL_protocol_config,EXPERIMENTAL_receipt,EXPERIMENTAL_receipt_to_tx,EXPERIMENTAL_tx_status,EXPERIMENTAL_validators_ordered,block,broadcast_tx_async,broadcast_tx_commit,chunk,gas_price,network_info,send_tx,status,tx,validators query(6 giá trịrequest_type):call_function,view_access_key,view_access_key_list,view_account,view_code,view_stateEXPERIMENTAL_changes(5 giá trịchanges_type):account_changes,all_access_key_changes,contract_code_changes,data_changes,single_access_key_changes
query và EXPERIMENTAL_changes phải được gửi với params là một object chứa giá trị request_type hoặc changes_type ở trên.Method 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
| HTTP status | Ý 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 NEAR RPC và tài liệu
Để xem danh sách đầy đủ các phương thức chuẩn, tham số và đặc tả, hãy tham khảo tài liệu chính thức.