Solana Geyser gRPC - 빠른 시작
SLV 설치
bash
curl -fsSL https://storage.slv.dev/slv/install | shcurl -fsSL https://storage.slv.dev/slv/install | sh$ slv b init
slv b init 명령 하나만으로 고성능 스트림 기반 데이터를 활용하는 Solana 봇용 개발 환경을 즉시 구성할 수 있습니다.bash
slv b initslv b init- TypeScript Geyser 봇을 선호한다면
geyser-ts를 사용하세요 - Rust Geyser 봇을 선호한다면
geyser-rust를 사용하세요
gRPC 로드 밸런서 IP 허용 목록 등록
각 지역의 gRPC 로드 밸런서에서 실시간 핑 검사를 수행하여 등록된 IP에 가장 가까운 노드를 선택합니다. 방화벽(ufw, security groups 등)에서 ICMP가 차단되면 핑이
9999ms로 표시될 수 있으며, 이 경우 가장 가까운 최적 지역이 선택되지 않을 수 있습니다. 아래 IP를 허용 목록에 추가하면 가장 가까운 지역이 자동으로 선택됩니다.| Region | Domain | IP Address |
|---|---|---|
| 🇳🇱 Amsterdam | grpc-ams1.erpc.global | 84.32.103.245 |
| 🇳🇱 Amsterdam | grpc-ams1.erpc.global | 84.32.64.77 |
| 🇺🇸 New York | grpc-ny6-1.erpc.global | 64.130.37.222 |
| 🇩🇪 Frankfurt | grpc-fra1-1.erpc.global | 185.191.118.149 |
| 🇩🇪 Frankfurt | grpc-fra1-1.erpc.global | 185.191.118.177 |
| 🇩🇪 Frankfurt | grpc-fra1-1.erpc.global | 185.191.118.206 |
| 🇬🇧 London | grpc-lon6-1.erpc.global | 67.209.52.250 |
| 🇯🇵 Tokyo | grpc-tokyo-6.erpc.global | 198.13.133.88 |
| 🇸🇬 Singapore | grpc-sgp6-1.erpc.global | 202.8.11.52 |
| 🇦🇺 Sydney | grpc-syd-1.erpc.global | 82.26.116.36 |
| 🛰️ Far Point | grpc-far-point.erpc.global | 63.254.162.14 |
Burst gRPC 엔드포인트
Geyser gRPC Burst는 지연 시간에 민감한 Solana 스트림 워크로드를 위한 ERPC의 저지연 공유 gRPC 등급입니다. Burst는 일반 gRPC 서비스와 동일한 Yellowstone/Geyser gRPC 인터페이스를 사용하므로, 기존 gRPC 클라이언트는 표준 account, transaction, slot, block 구독을 그대로 계속 사용할 수 있습니다.
Burst는 현재 Frankfurt, Amsterdam, New York, Tokyo, Singapore에서 실행됩니다. 지연 시간 선택에는 위에 나열된 일반 gRPC ping 소스 IP를 계속 사용합니다. 아래의 Burst 로드 밸런서 IP는 클라이언트 연결을 위해 허용해야 하는 공개 Burst 엔드포인트입니다.
| Region | Burst Domain | IP Address |
|---|---|---|
| 🇩🇪 Frankfurt | grpc-fra1-burst.erpc.global | 64.130.41.234 |
| 🇳🇱 Amsterdam | grpc-ams1-burst.erpc.global | 64.130.55.180 |
| 🇺🇸 New York | grpc-ny6-burst.erpc.global | 64.130.59.217 |
| 🇯🇵 Tokyo | grpc-tokyo-burst.erpc.global | 208.91.107.247 |
| 🇸🇬 Singapore | grpc-singapore-burst.erpc.global | 67.209.55.15 |
IP를 등록한 후 ERPC Web Dashboard에 표시되는 엔드포인트를 사용하세요. Burst는 완전한 Geyser gRPC 스트림으로 유지되며, Direct Shreds/ShredStream은 원시 shred 데이터를 위한 별도의 UDP 기반 제품입니다.
Geyser 클라이언트 예제 – TypeScript
.env.sample의 이름을.env로 변경하세요.env를 실제 값으로 편집하세요:
ini
GEYSER_ENDPOINT=http://grpc-ams1.erpc.global
SOLANA_RPC_ENDPOINT="https://edge.erpc.global?api-key=YOUR_API_KEY"GEYSER_ENDPOINT=http://grpc-ams1.erpc.global
SOLANA_RPC_ENDPOINT="https://edge.erpc.global?api-key=YOUR_API_KEY"참고:
이 엔드포인트는 샘플이므로 그대로 사용할 수 없습니다. 사용 환경에 맞는 적절한 엔드포인트를 발급받아 구성하세요.
- 의존성을 설치하고 개발 서버를 시작하세요:
bash
pnpm i
pnpm devpnpm i
pnpm dev
Geyser 클라이언트 예제 – Rust
.env.sample의 이름을.env로 변경하세요.env를 실제 값으로 편집하세요:
ini
GEYSER_ENDPOINT=http://grpc-ams1.erpc.global
SOLANA_RPC_ENDPOINT="https://edge.erpc.global?api-key=YOUR_API_KEY"GEYSER_ENDPOINT=http://grpc-ams1.erpc.global
SOLANA_RPC_ENDPOINT="https://edge.erpc.global?api-key=YOUR_API_KEY"참고:
이 엔드포인트는 샘플이므로 그대로 사용할 수 없습니다. 사용 환경에 맞는 적절한 엔드포인트를 발급받아 구성하세요.
- 클라이언트를 빌드하고 실행하세요:
bash
RUST_LOG=info cargo runRUST_LOG=info cargo run
✅ 1일 무료 체험 제공
Geyser와 Shreds 봇 모두 ERPC Web Dashboard를 통해 1일 동안 무료로 테스트할 수 있습니다.
대시보드 열기: https://dashboard.erpc.global/en
Solana Stream SDK
slv b init 명령으로 다운로드되는 스타터 코드에서 사용하는 Geyser 어댑터는오픈소스 Solana Stream SDK가 제공합니다.
이 SDK는 Rust와 TypeScript를 모두 지원하며, Geyser 구독, 트랜잭션 처리, 실시간 계정 업데이트 모니터링 등
Solana 스트림 통신을 효율적으로 구현할 수 있게 해줍니다.
Solana 스트림 통신을 효율적으로 구현할 수 있게 해줍니다.
여러분이 받게 되는 스타터 코드는 이 SDK가 실제로 동작하는 직접적인 예제이며,
자체 봇 개발이나 커스텀 로직으로 손쉽게 확장할 수 있습니다.
자체 봇 개발이나 커스텀 로직으로 손쉽게 확장할 수 있습니다.
자세한 내용은 GitHub 저장소를 참고하세요:
https://github.com/ValidatorsDAO/solana-stream
https://github.com/ValidatorsDAO/solana-stream