Sui RPC Endpoint Dokümantasyonu | ERPC
Sui RPC Endpoint Dokümantasyonu
ERPC'yi unary gRPC-web istekleri için Sui RPC endpoint'iniz olarak kullanabilirsiniz. Sui RPC, Global Edge Blockchain Infrastructure'ımız kapsamındaki ERPC'nin RPC APIs'inin bir parçasıdır ve API key, ERPC Web Dashboard üzerinden yönetilebilir.
Solana, Ethereum ve Avalanche ile aynı RPC key'i kullanabilirsiniz.
API key'inizi
Authorization: Bearer <YOUR_API_KEY> olarak gönderin. Sui SDK servis yolunu base URL'ye eklediği için anahtar, api-key query parametresi yerine başlıkta gönderilir.Endpoints
gRPC-web transport'unuzun
baseUrl değeri olarak iki base URL'den birini kullanın:text
https://edge.erpc.global/suihttps://edge.erpc.global/suitext
https://sui.erpc.globalhttps://sui.erpc.globalİstekler,
/sui.rpc.v2.<Service>/<Method> yoluna gönderilen binary gRPC-web (application/grpc-web+proto) POST istekleridir; her unary çağrı sıkıştırılmamış tek bir protobuf frame taşır.Örnekler
Aşağıda bir transport yapılandırma örneği yer alır.
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'u Sui gRPC API için oluşturulan unary servis istemcisine iletin.
API key'inizi ERPC Web Dashboard üzerinden alabilir ve kontrol edebilirsiniz: ERPC Web Dashboard
Toplu İstekler
Sui'de toplu istek yoktur. Her HTTP isteği tek bir unary çağrı taşır ve tek çağrı olarak ücretlendirilir. İstek gövdesi en fazla 1 MiB olabilir.
Kullanım Ücretlendirmesi
Kullanım token cinsinden ücretlendirilir ve token oranı yönteme göre değişebilir. Her unary çağrı tek çağrı olarak ücretlendirilir.
Free Plan Sınırları
Free planda hesabınız 10 saniyede bir istek gönderebilir. Sınır endpoint başına değil, hesap başına sayılır; bu nedenle başka bir zincire gönderilen bir istek de bu sınıra dahil edilebilir. Daha erken gönderilen bir istek HTTP
429 ile yanıtlanır ve retry-after başlığı bekleme süresini saniye cinsinden verir.Desteklenen Yöntemler
Endpoint şu 19 unary gRPC-web yöntemini sunar. Her biri
/sui.rpc.v2.<Service>/<Method> yolunda çağrılır ve büyük/küçük harfler tam olarak eşleşmelidir.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
Listede olmayan bir yol HTTP
400 ile yanıtlanır. Native gRPC, metin biçimli gRPC-web, streaming ve BatchGet* çağrıları desteklenmez.Yanıt Durum Kodları
| HTTP status | Anlamı |
|---|---|
| 200 | Başarılı unary çağrı. Gövde application/grpc-web+proto biçimindedir. |
| 400 | Desteklenen Yöntemler listesinde olmayan bir yol, sıkıştırılmamış tek bir binary gRPC-web frame'i olmayan bir gövde ya da 1 MiB sınırını aşan bir gövde. |
| 401 | Eksik veya geçersiz API key ya da anahtar için tanımlanan IP veya Origin kısıtlamasının karşılanmaması. |
| 405 | POST dışında bir HTTP istek yöntemi. |
| 426 | WebSocket Upgrade istendi. Endpoint yalnızca HTTP üzerinden çalışır. |
| 429 | Hız sınırlaması uygulandı; 10 saniyede bir istek olan Free plan sınırı da buna dahildir. retry-after başlığı varsa, belirtilen saniye kadar bekleyin. |
| 502 | Upstream çağrısı tamamlanamadı: upstream başarısız bir yanıt döndürdü, yanıt 8 MiB sınırını aştı, 30 saniye içinde yanıt gelmedi ya da grpc-status değeri 0 dışında bir değerdi. |
| 503 | Hizmet geçici olarak kullanılamıyor. |
Sui RPC Yöntemleri ve Dokümantasyon
Tüm standart yöntemler, parametreler ve özellikler için lütfen resmi dokümantasyona bakın.