FastestPingRoutingStrategy

Overview

The FastestPingRoutingStrategy selects the gateway with the lowest latency by performing HEAD requests to all available gateways and choosing the one that responds fastest. This strategy optimizes for performance by dynamically selecting the most responsive gateway for each request.

How It Works

Ping All Gateways: Send HEAD requests to all available gateways for the provided path and subdomain
Measure Response Times: Records the time taken for each gateway to respond
Select Fastest: Choose the gateway with the lowest response time

Basic Usage

import { FastestPingRoutingStrategy } from '@ar.io/wayfinder-core'

const strategy = new FastestPingRoutingStrategy({
  timeoutMs: 500,
  maxConcurrency: 3,
})

const selectedGateway = await strategy.selectGateway({
  path: '/',
  subdomain: 'ardrive',
  gateways: ['https://arweave.net', 'https://permagate.io', 'https://arweave.dev']
})

// does a HEAD request on each and selects the one that responded the fastest

Parameters

Parameter	Type	Default	Description
`timeoutMs`	`number`	`500`	Timeout for ping requests in milliseconds
`maxConcurrency`	`number`	`3`	Number that determines how many HEAD checks to send at once
`logger`	`Logger`	`defaultLogger`	Optional logger instance

PreferredWithFallbackRoutingStrategy: Static gateway configuration
RoundRobinRoutingStrategy: Even distribution across gateways
RandomRoutingStrategy: Randomized gateway selection
StaticRoutingStrategy: Always use a single, fixed gateway