Sui RPC 빠른 시작 | ERPC
Sui RPC 빠른 시작
이 가이드는 처음부터 ERPC로 Sui gRPC-web 트랜스포트를 설정하기까지의 과정을 안내합니다.
1. API key 발급받기
API key는 ERPC Web Dashboard에서 발급받고 확인할 수 있습니다.
이미 Solana, Ethereum 또는 Avalanche용으로 ERPC를 사용 중이신가요? 동일한 RPC key를 그대로 사용할 수 있습니다.
2. gRPC-web 트랜스포트 설정하기
Sui는 바이너리 gRPC-web(
application/grpc-web+proto)으로 제공되며, HTTP 요청 하나에 unary 호출 하나가 담깁니다. ERPC 기본 URL을 지정하고 API key를 Bearer 토큰으로 넣어 GrpcWebFetchTransport를 설정합니다.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>' },
})이 트랜스포트를 Sui gRPC API용으로 생성된 unary 서비스 클라이언트에 전달합니다. 클라이언트는
baseUrl 뒤에 /sui.rpc.v2.<Service>/<Method>를 붙입니다(예: /sui.rpc.v2.LedgerService/GetServiceInfo). SDK가 기본 URL 뒤에 경로를 붙이므로, API key는 api-key 쿼리 매개변수가 아니라 Authorization 헤더로 보냅니다.바이너리 gRPC-web을 통한 unary 호출만 지원합니다. JSON-RPC 요청, 네이티브 gRPC, 텍스트 형식 gRPC-web, 스트리밍은 지원하지 않습니다.
다음 단계
- 엔드포인트, 계량, 상태 코드: Sui RPC 엔드포인트 문서
- 공식 Sui 문서: https://docs.sui.io/references/sui-api