ERPC Sui RPC 端點文件
Sui RPC 端點文件
將 ERPC 作為您的 Sui RPC 端點，用於處理 unary gRPC-web 請求。Sui RPC 是 ERPC 在 Global Edge Blockchain Infrastructure 中提供的 RPC APIs 之一，API key 可以在 ERPC Web Dashboard 中管理。
您可以直接使用與 Solana、Ethereum 和 Avalanche 相同的 RPC key。
請以
Authorization: Bearer <YOUR_API_KEY> 傳送 API key。Sui SDK 會在 base URL 後附加服務路徑，因此 key 需放在標頭中，而非 api-key 查詢參數中。端點
使用以下任一 base URL 作為 gRPC-web transport 的
baseUrl：text
https://edge.erpc.global/suihttps://edge.erpc.global/suitext
https://sui.erpc.globalhttps://sui.erpc.global請求為傳送至
/sui.rpc.v2.<Service>/<Method> 的二進位 gRPC-web（application/grpc-web+proto）POST，每次 unary 呼叫對應一個未壓縮的 protobuf 訊框。範例
以下是 transport 設定範例。
typescript
import { GrpcWebFetchTransport } from '@protobuf-ts/grpcweb-transport'
const transport = new GrpcWebFetchTransport({
baseUrl: 'https://sui.erpc.global', // or https://edge.erpc.global/sui
format: 'binary',
meta: { Authorization: 'Bearer <YOUR_API_KEY>' },
})import { GrpcWebFetchTransport } from '@protobuf-ts/grpcweb-transport'
const transport = new GrpcWebFetchTransport({
baseUrl: 'https://sui.erpc.global', // or https://edge.erpc.global/sui
format: 'binary',
meta: { Authorization: 'Bearer <YOUR_API_KEY>' },
})將該 transport 傳給為 Sui gRPC API 產生的 unary 服務用戶端。
您可以在 ERPC Web Dashboard 上取得和檢視您的 API key。
批次請求
Sui 沒有批次請求。每個 HTTP 請求承載一次 unary 呼叫，並計為一次呼叫。請求本文最大為 1 MiB。
用量計量
用量以 token 計量，token 費率可能因方法而異。每次 unary 呼叫計為一次呼叫。
Free 方案限制
在 Free 方案中，您的帳戶每 10 秒可以傳送一個請求。此限制依帳戶計算，而不是依端點計算，因此傳送至另一條鏈的請求也可能計入此限制。過早傳送的請求會收到 HTTP
429 回應，retry-after 標頭會給出以秒為單位的等待時間。支援的方法
此端點提供以下 19 個 unary gRPC-web 方法。每個方法都透過
/sui.rpc.v2.<Service>/<Method> 呼叫，且大小寫必須完全一致。LedgerService(5):GetServiceInfo,GetCheckpoint,GetObject,GetTransaction,GetEpochMovePackageService(4):GetPackage,GetDatatype,GetFunction,ListPackageVersionsNameService(2):LookupName,ReverseLookupNameSignatureVerificationService(1):VerifySignatureStateService(5):GetCoinInfo,GetBalance,ListBalances,ListDynamicFields,ListOwnedObjectsTransactionExecutionService(2):ExecuteTransaction,SimulateTransaction
未列出的路徑會收到 HTTP
400 回應。不支援原生 gRPC、文字格式的 gRPC-web、串流以及 BatchGet* 呼叫。回應狀態碼
| HTTP 狀態碼 | 意義 |
|---|---|
| 200 | unary 呼叫成功。回應本文為 application/grpc-web+proto |
| 400 | 不在「支援的方法」清單中的路徑、不是單一未壓縮二進位 gRPC-web 訊框的請求本文，或超過 1 MiB 的請求本文 |
| 401 | 缺少 API key 或 API key 無效，或不符合該 key 的 IP 或 Origin 限制 |
| 405 | 使用了 POST 以外的請求方法 |
| 426 | 請求了 WebSocket Upgrade。此端點僅支援 HTTP |
| 429 | 已被限速，包括 Free 方案每 10 秒一個請求的限制。若有 retry-after 標頭，請等待其指定的秒數 |
| 502 | 上游呼叫無法完成：上游回應失敗、回應超過 8 MiB、30 秒內未回應，或 grpc-status 不為 0 |
| 503 | 服務暫時無法使用 |
Sui RPC 方法和文件
有關標準方法、參數和規範的完整列表，請參閱官方文件。