ERPC

NEAR RPC Endpoint Documentation | ERPC

เอกสาร NEAR RPC Endpoint

ใช้ ERPC เป็น NEAR RPC endpoint ของคุณสำหรับ HTTP JSON-RPC requests. NEAR RPC เป็นส่วนหนึ่งของ RPC APIs ของ ERPC ภายใน Global Edge Blockchain Infrastructure ของเรา และสามารถจัดการ API key ได้จาก ERPC Web Dashboard.
คุณสามารถใช้ RPC key เดียวกับ Solana, Ethereum และ Avalanche ได้.
ส่ง API key ของคุณผ่าน query parameter api-key หรือส่งเป็น Authorization: Bearer <YOUR_API_KEY>. หากมีทั้งสองแบบ ระบบจะใช้ query parameter.

Endpoint

ส่ง JSON-RPC 2.0 requests แบบ HTTP POST ไปที่:
text
https://edge.erpc.global/near?api-key=<YOUR_API_KEY>
หรือส่งไปที่ host เฉพาะ:
text
https://near.erpc.global?api-key=<YOUR_API_KEY>
รับ request ที่ / เท่านั้น.

ตัวอย่าง

นี่คือตัวอย่าง HTTP request ที่ใส่ API key ใน query parameter.
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"}
}'
นี่คือ request เดียวกันที่ใส่ API key ใน 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"}
}'
คุณสามารถสร้างและตรวจสอบ API key ได้ใน ERPC Web Dashboard: ERPC Web Dashboard

Batch Requests

รองรับ JSON-RPC batch ตั้งแต่ 1 ถึง 100 คำสั่งเรียกต่อหนึ่ง HTTP request. แต่ละคำสั่งเรียกต้องมี id ของตัวเอง และค่า id ต้องไม่ซ้ำกันภายใน batch เดียวกัน. แต่ละคำสั่งเรียกในหนึ่ง batch จะถูกวัดเป็นคำสั่งเรียกแยกกัน. request body มีขนาดได้สูงสุด 1 MiB.

การวัดผลการใช้งาน

การใช้งานจะถูกวัดเป็น token และอัตรา token อาจแตกต่างกันไปตาม method. แต่ละคำสั่งเรียกในหนึ่ง HTTP batch จะถูกวัดแยกกัน.

ข้อจำกัดของแพ็กเกจ Free

ในแพ็กเกจ Free บัญชีของคุณส่งได้หนึ่ง request ต่อ 10 วินาที. ขีดจำกัดนี้นับต่อบัญชี ไม่ใช่ต่อ endpoint ดังนั้น request ที่ส่งไปยัง chain อื่นก็อาจถูกนับรวมในขีดจำกัดนี้ด้วย. request ที่ส่งเร็วกว่านั้นจะได้รับการตอบกลับด้วย HTTP 429 และ header retry-after จะระบุเวลาที่ต้องรอเป็นวินาที.
ในแพ็กเกจ Free request ที่มีคำสั่งเรียก JSON-RPC ตั้งแต่ 2 รายการขึ้นไปจะได้รับการตอบกลับด้วย HTTP 429 และจะไม่มีคำสั่งเรียกใดถูกส่งเลย: แต่ละคำสั่งเรียกจะได้รับ JSON-RPC error ที่มีรหัส -32041. ให้ส่งคำสั่งเรียกเหล่านี้ทีละรายการแทน.

เมธอดที่รองรับ

Endpoint นี้ให้บริการ NEAR JSON-RPC method ต่อไปนี้. method ที่ขึ้นต้นด้วย EXPERIMENTAL_ ต้องส่งพร้อม prefix ตัวพิมพ์ใหญ่.
  • เมธอด (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 (ค่า request_type 6 ค่า): call_function, view_access_key, view_access_key_list, view_account, view_code, view_state
  • EXPERIMENTAL_changes (ค่า changes_type 5 ค่า): account_changes, all_access_key_changes, contract_code_changes, data_changes, single_access_key_changes
query และ EXPERIMENTAL_changes ต้องส่ง params เป็น object ที่มีค่า request_type หรือ changes_type ข้างต้น.
method ที่ไม่อยู่ในรายการจะได้รับการตอบกลับด้วย HTTP 400.

รหัสสถานะการตอบกลับ

HTTP statusความหมาย
200การตอบกลับ JSON-RPC จาก upstream. JSON-RPC error จะถูกส่งกลับด้วย HTTP 200 เช่นกัน: คง id ของ request และ error.code ไว้ ค่า error.message เป็น ERPC upstream error และไม่ส่ง error.data กลับมา.
400method หรือ path ที่ไม่อยู่ในรายการเมธอดที่รองรับ, JSON-RPC request ไม่ถูกต้อง, batch ว่างหรือ batch ที่เกิน 100 คำสั่งเรียก, id ซ้ำกันใน batch หรือ body ที่เกิน 1 MiB.
401ไม่มี API key หรือ API key ไม่ถูกต้อง หรือไม่เป็นไปตามข้อจำกัด IP หรือ Origin ที่ตั้งไว้สำหรับ key.
405ใช้ request method อื่นที่ไม่ใช่ POST.
426มีการร้องขอ WebSocket Upgrade. endpoint นี้รองรับเฉพาะ HTTP.
429ถูกจำกัดอัตรา รวมถึงข้อจำกัดของแพ็กเกจ Free ข้างต้น: มากกว่าหนึ่ง request ต่อ 10 วินาที หรือมีคำสั่งเรียกตั้งแต่ 2 รายการขึ้นไปใน request เดียว. หากมี header retry-after ให้รอตามจำนวนวินาทีที่ระบุ.
502ไม่สามารถดำเนินการ upstream request ให้เสร็จสมบูรณ์ได้: upstream ตอบกลับล้มเหลว, การตอบกลับเกิน 8 MiB หรือไม่มีการตอบกลับภายใน 30 วินาที.
503บริการไม่พร้อมใช้งานชั่วคราว.

NEAR RPC Methods และ Documentation

สำหรับรายการ method มาตรฐาน พารามิเตอร์ และข้อกำหนดทั้งหมด โปรดดูเอกสารทางการ.
https://docs.near.org/api/rpc/introduction

ก่อนหน้า

NEAR RPC เริ่มต้นใช้งานอย่างรวดเร็ว | ERPC

ถัดไป

Optimism RPC เริ่มต้นใช้งานอย่างรวดเร็ว | ERPC