Solana Geyser gRPC - Quickstart
Instalar o SLV
bash
curl -fsSL https://storage.slv.dev/slv/install | shcurl -fsSL https://storage.slv.dev/slv/install | sh$ slv b init
Com um único comando,
slv b init, você pode imediatamente criar um ambiente de desenvolvimento para robôs Solana usando dados baseados em fluxo de alto desempenho.bash
slv b initslv b init- Use
geyser-tsse preferir um bot TypeScript Geyser - Use
geyser-rustse preferir um bot Rust Geyser
Adicione os IPs à allowlist do balanceador de carga gRPC
O nó mais próximo de seu IP registrado é escolhido usando verificações de ping em tempo real de cada balanceador de carga gRPC regional. Se ICMP é bloqueado por um firewall (ufw, grupos de segurança, etc.), o ping pode mostrar
9999ms, o que pode impedir que a região próxima ideal seja selecionada. Adicione os IPs à allowlist abaixo para que sua região mais próxima seja escolhida automaticamente.| 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 |
Endpoints gRPC Burst
Geyser gRPC Burst é o nível gRPC compartilhado de baixa latência da ERPC para cargas de trabalho de streaming Solana sensíveis à latência. O Burst usa a mesma interface Yellowstone/Geyser gRPC do serviço gRPC regular, então clientes gRPC existentes podem continuar usando assinaturas padrão de account, transaction, slot e block.
O Burst atualmente opera em Frankfurt, Amsterdam, New York, Tokyo e Singapore. A seleção por latência ainda usa os IPs de origem de ping gRPC regulares listados acima; os IPs dos load balancers Burst abaixo são os endpoints Burst públicos que devem ser permitidos para conexões de clientes.
| 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 |
Use o endpoint exibido no ERPC Web Dashboard depois de registrar seu IP. O Burst continua sendo um stream Geyser gRPC completo; Direct Shreds/ShredStream é um produto separado baseado em UDP para dados shred brutos.
Exemplo do cliente Geyser – TypeScript
- Renomeie
.env.samplepara.env - Edite
.envcom seus valores reais:
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"Nota:
Este endpoint é um exemplo e não pode ser usado como está. Por favor, obtenha e configure o endpoint apropriado para o seu ambiente.
- Instale dependências e inicie o servidor de desenvolvimento:
bash
pnpm i
pnpm devpnpm i
pnpm dev
Exemplo do cliente Geyser – Rust
- Renomeie
.env.samplepara.env - Edite
.envcom seus valores reais:
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"Nota:
Este endpoint é um exemplo e não pode ser usado como está. Por favor, obtenha e configure o endpoint apropriado para o seu ambiente.
- Compilar e executar o cliente:
bash
RUST_LOG=info cargo runRUST_LOG=info cargo run
1 dia de teste grátis disponível
Os bots Geyser e Shreds podem ser testados gratuitamente por 1 dia através do Painel Web ERPC.
Abra o painel: https://dashboard.erpc.global/pt
Solana Stream SDK
O adaptador Geyser usado no código inicial baixado através do
é fornecido pelo código aberto Solana Stream SDK.
slv b init comandoé fornecido pelo código aberto Solana Stream SDK.
Ele suporta tanto Rust quanto TypeScript, permitindo a implementação eficiente da comunicação de fluxo Solana,
incluindo assinaturas da Geyser, processamento de transações e monitoramento da atualização da conta em tempo real.
incluindo assinaturas da Geyser, processamento de transações e monitoramento da atualização da conta em tempo real.
O código inicial que você obtém é um exemplo direto deste SDK em ação,
tornando mais fácil estender para o seu próprio desenvolvimento bot ou lógica personalizada.
tornando mais fácil estender para o seu próprio desenvolvimento bot ou lógica personalizada.
Para mais detalhes, visite o repositório GitHub:
https://github.com/ValidatorsDAO/solana-stream
https://github.com/ValidatorsDAO/solana-stream