Dokumentasi Sui RPC Endpoint | ERPC
Dokumentasi Sui RPC Endpoint
Gunakan ERPC sebagai endpoint RPC Sui Anda untuk request gRPC-web unary. Sui RPC adalah bagian dari RPC APIs ERPC di dalam Global Edge Blockchain Infrastructure kami, dan API key dapat dikelola dari ERPC Web Dashboard.
Anda dapat menggunakan RPC key yang sama dengan Solana, Ethereum, dan Avalanche.
Kirim API key Anda sebagai
Authorization: Bearer <YOUR_API_KEY>. SDK Sui menambahkan path service ke base URL, sehingga key dikirim di header, bukan di query parameter api-key.Endpoint
Gunakan salah satu base URL berikut sebagai
baseUrl transport gRPC-web Anda:text
https://edge.erpc.global/suihttps://edge.erpc.global/suitext
https://sui.erpc.globalhttps://sui.erpc.globalRequest berupa POST gRPC-web biner (
application/grpc-web+proto) ke /sui.rpc.v2.<Service>/<Method>, dengan satu frame protobuf tanpa kompresi per panggilan unary.Contoh
Berikut adalah contoh konfigurasi 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>' },
})Teruskan transport ke client service unary yang di-generate untuk Sui gRPC API.
Anda dapat membuat dan memeriksa API key Anda di ERPC Web Dashboard: ERPC Web Dashboard
Batch Request
Sui tidak memiliki batch request. Setiap HTTP request membawa satu panggilan unary dan diukur sebagai satu panggilan. Body request maksimal 1 MiB.
Pengukuran Penggunaan
Penggunaan diukur dalam token, dan tarif token dapat berbeda per method. Setiap panggilan unary diukur sebagai satu panggilan.
Batas Paket Free
Pada Paket Free, akun Anda dapat mengirim satu request per 10 detik. Batas ini dihitung per akun, bukan per endpoint, sehingga request ke chain lain juga dapat dihitung ke dalam batas tersebut. Request yang dikirim lebih cepat dijawab dengan HTTP
429, dan header retry-after memberikan waktu tunggu dalam detik.Method yang Didukung
Endpoint ini melayani 19 method gRPC-web unary berikut. Setiap method dipanggil di
/sui.rpc.v2.<Service>/<Method>, dan huruf besar-kecilnya harus sama persis.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
Path yang tidak tercantum dijawab dengan HTTP
400. gRPC native, gRPC-web format teks, streaming, dan panggilan BatchGet* tidak didukung.Kode Status Response
| HTTP status | Arti |
|---|---|
| 200 | Panggilan unary berhasil. Body berformat application/grpc-web+proto. |
| 400 | Path di luar daftar Method yang Didukung, body yang bukan satu frame gRPC-web biner tanpa kompresi, atau body lebih dari 1 MiB. |
| 401 | API key tidak ada atau tidak valid, atau pembatasan IP atau Origin pada key tidak terpenuhi. |
| 405 | Request dengan method HTTP selain POST. |
| 426 | WebSocket Upgrade diminta. Endpoint ini hanya mendukung HTTP. |
| 429 | Dibatasi rate, termasuk batas Paket Free sebesar satu request per 10 detik. Jika ada header retry-after, tunggu selama jumlah detik yang disebutkan. |
| 502 | Panggilan upstream tidak dapat diselesaikan: response upstream gagal, response lebih dari 8 MiB, tidak ada jawaban dalam 30 detik, atau grpc-status selain 0. |
| 503 | Layanan tidak tersedia sementara. |
Metode dan Dokumentasi Sui RPC
Untuk daftar lengkap metode standar, parameter, dan spesifikasi, lihat dokumentasi resmi.