Skip to content
WireTap

Providers

After this page you can pick the right chain-plane adapter for your budget and latency needs, and switch between them with a config change.

The ingester observes the chain through one of three adapters, selected by WIRETAP_PROVIDER. All three produce identical events downstream — the choice affects latency and coverage, never features.

polling (default — free)

Section titled “polling (default — free)”

Polls any Solana JSON-RPC endpoint (getSignaturesForAddress + transaction fetches) under a strict request budget (WIRETAP_RPC_BUDGET_RPS, default 8 rps).

Terminal window
WIRETAP_PROVIDER=polling
WIRETAP_RPC_URL=https://api.devnet.solana.com
  • Cost: free; works with any public endpoint.
  • Latency: seconds to tens of seconds — honest, production-quality, but not real-time.
  • Coverage: complete for tracked programs within the budget; under very high program throughput the adapter falls back to documented sampling rather than silently lagging.

Right for: devnet, small mainnet programs, evaluation, most self-hosts.

yellowstone (paid gRPC stream)

Section titled “yellowstone (paid gRPC stream)”

Subscribes to a Yellowstone Geyser gRPC feed (Triton One, Helius, Shyft and others sell endpoints).

Terminal window
WIRETAP_PROVIDER=yellowstone
YELLOWSTONE_ENDPOINT=https://your-endpoint.example:443
YELLOWSTONE_X_TOKEN=your-token
  • Cost: provider-dependent (typically hundreds of $/month).
  • Latency: sub-second; slot-level completeness — no sampling.
  • Right for: production mainnet programs, leaderboard-grade coverage.

helius (paid enhanced WebSocket)

Section titled “helius (paid enhanced WebSocket)”

Helius’s enhanced WebSocket subscriptions — a middle ground when you’re already a Helius customer.

Terminal window
WIRETAP_PROVIDER=helius
HELIUS_API_KEY=your-key
  • Cost: included in Helius paid tiers.
  • Latency: near-real-time.

Switching

Section titled “Switching”

The adapter is stateless with respect to history — switching is a config change plus restart:

Terminal window
# in .env, then:
docker compose -f infra/docker-compose.yml --profile full up -d ingester
npx @wiretap-labs/cli doctor    # confirms which adapter is live

The hosted leaderboard currently runs on the polling adapter with documented sampling; the methodology page states exactly what that does to published numbers.