ShredStream - Quickstart

Install SLV

bash
curl -fsSL https://storage.slv.dev/slv/install | sh

$ slv b init

slv b init
With a single command, slv b init, you can instantly scaffold a development environment for Solana bots using high-performance stream-based data.
bash
slv b init
  • Use shreds-ts if you prefer a TypeScript-based Shreds bot
  • Use shreds-rust for a Rust-based bot leveraging Shreds

Allow ICMP latency-probe sources

For Shreds region selection, ERPC sends ICMP latency probes to your registered IP from the proxy hosts listed below. Allow inbound ICMP echo requests from every listed source IP. If they are blocked by a firewall (ufw, cloud firewall, security group, etc.), the measurement can become 9999ms and a non-optimal region may be selected. Multiple IPs in one region are separate probe hosts; all of them are required.
RegionICMP source IPs
🇳🇱 Amsterdam64.130.43.108, 82.21.43.35
🇺🇸 New York151.243.244.162
🇩🇪 Frankfurt64.130.41.236, 151.241.178.73
🇯🇵 Tokyo143.20.238.88
🇸🇬 Singapore67.209.55.19, 151.245.186.3
🇬🇧 London64.130.63.211, 151.241.65.10

Far Point selected

Shared Shreds Far Point is a limited-capacity fallback. Each endpoint supports up to 32 concurrent proxied streams across all customers—not 32 slots per customer. Streaming is most effective when the subscriber runs near the selected Shreds endpoint; long-distance streams retain shared connections, flow-control windows, and egress capacity for longer. To help keep the shared environment responsive, allow every listed regional ICMP probe source and run region selection again. For ongoing use, consider an ERPC VPS near the selected endpoint. If a different geography is required, Dedicated Shreds can be arranged for a preferred region, subject to availability and deployment planning.

Shreds Client Example – TypeScript

  1. Rename the .env.sample file to .env.
  2. Update the values in the .env file with your actual endpoint:
ini
SHREDS_ENDPOINT=http://shreds-ams6-1.erpc.global
SOLANA_RPC_ENDPOINT="https://edge.erpc.global?api-key=YOUR_API_KEY"
⚠️ Important Note: This endpoint is provided as an example and cannot be used directly. Obtain and set your actual endpoint accordingly.
  1. Install dependencies and run the script:
bash
pnpm i
pnpm dev
Shreds TypeScript VSCode

Shreds Client Example – Rust

  1. Rename .env.sample to .env
  2. Edit .env with your actual Shreds endpoint:
ini
SHREDS_ENDPOINT=http://shreds-ams6-1.erpc.global
SOLANA_RPC_ENDPOINT="https://edge.erpc.global?api-key=YOUR_API_KEY"
Please note:
This endpoint is a sample and cannot be used as is. Please obtain and configure the appropriate endpoint for your environment.
  1. Build and run the client:
bash
RUST_LOG=info cargo run
Shreds Rust VSCode