@ar.io/wayfinder-core 1.6.1 → 1.7.0

package/README.md

@@ -29,51 +29,112 @@ const response = await wayfinder.request('ar://example-name');
 ### Using with AR.IO Network
 
 ```javascript
-import { createWayfinderClient } from '@ar.io/wayfinder-core';
+import {
+  createWayfinderClient,
+  FastestPingRoutingStrategy,
+  NetworkGatewaysProvider,
+} from '@ar.io/wayfinder-core';
 import { ARIO } from '@ar.io/sdk';
 
-// Provide ARIO instance to use AR.IO network gateways
-const wayfinder = createWayfinderClient({
+const gatewaysProvider = new NetworkGatewaysProvider({
   ario: ARIO.mainnet(),
-  gatewaySelection: 'highest-performing', // Selection criteria for AR.IO network
+  sortBy: 'operatorStake',
+  sortOrder: 'desc',
+  limit: 10,
+});
+
+const wayfinder = createWayfinderClient({
+  routingStrategy: new FastestPingRoutingStrategy({ gatewaysProvider }),
 });
 ```
 
 ### Custom Trusted Gateway
 
 ```javascript
-import { createWayfinderClient } from '@ar.io/wayfinder-core';
+import {
+  createWayfinderClient,
+  FastestPingRoutingStrategy,
+  HashVerificationStrategy,
+} from '@ar.io/wayfinder-core';
+
+const trustedGateways = [new URL('https://permagate.io')];
 
-// Use a specific trusted gateway for fetching peers
 const wayfinder = createWayfinderClient({
-  trustedGateways: ['https://permagate.io'], // First gateway is used for TrustedPeersGatewaysProvider
-  routing: 'fastest',
-  verification: 'hash',
+  routingStrategy: new FastestPingRoutingStrategy(),
+  verificationStrategy: new HashVerificationStrategy({
+    trustedGateways,
+  }),
 });
 ```
 
+> [!NOTE]
+> The legacy `trustedGateways` option on `createWayfinderClient` is deprecated.
+> Configure trusted gateways on the verification strategy instead, as shown
+> above.
+
 ### Configuration Options
 
-`createWayfinderClient` accepts the following options:
+> [!IMPORTANT]
+> `createWayfinderClient` only honors the `cache`, `routingStrategy`,
+> `verificationStrategy`, and `telemetry` options. All other legacy options are
+> deprecated and ignored. Supply concrete strategy instances or instantiate
+> `Wayfinder` directly for advanced customization.
+
+By default the helper constructs a
+`TrustedPeersGatewaysProvider('https://permagate.io')`, applies a
+`RandomRoutingStrategy`, and disables verification.
 
 ```javascript
+import {
+  createWayfinderClient,
+  FastestPingRoutingStrategy,
+  HashVerificationStrategy,
+} from '@ar.io/wayfinder-core';
+
 const wayfinder = createWayfinderClient({
-  // Routing strategy
-  routing: 'fastest', // 'random' | 'fastest' | 'round-robin' | 'preferred'
-  
-  // Verification strategy  
-  verification: 'hash', // 'hash' | 'data-root' | 'remote' | 'disabled' (default: 'disabled')
-  
-  // Gateway selection (only applies when ario instance is provided)
-  gatewaySelection: 'highest-performing', // 'highest-performing' | 'longest-tenure' | etc.
-  
-  // Enable caching for routing and gateway providers
-  cache: true, // Uses default 5-minute TTL
-  // OR specify custom TTL:
-  // cache: { ttlSeconds: 3600 }, // 1 hour
-  
-  // List of trusted gateways for verification
-  trustedGateways: ['https://arweave.net', 'https://permagate.io'],
+  cache: { ttlSeconds: 600 },
+  routingStrategy: new FastestPingRoutingStrategy(),
+  verificationStrategy: new HashVerificationStrategy({
+    trustedGateways: [new URL('https://permagate.io')],
+  }),
+});
+```
+
+For custom gateway providers or bespoke routing logic, instantiate `Wayfinder`
+directly:
+
+```javascript
+import {
+  FastestPingRoutingStrategy,
+  HashVerificationStrategy,
+  NetworkGatewaysProvider,
+  Wayfinder,
+} from '@ar.io/wayfinder-core';
+import { ARIO } from '@ar.io/sdk';
+
+const gatewaysProvider = new NetworkGatewaysProvider({
+  ario: ARIO.mainnet(),
+  sortBy: 'operatorStake',
+  sortOrder: 'desc',
+  limit: 10,
+});
+
+const trustedGateways = [
+  new URL('https://arweave.net'),
+  new URL('https://permagate.io'),
+];
+
+const wayfinder = new Wayfinder({
+  gatewaysProvider,
+  routingSettings: {
+    strategy: new FastestPingRoutingStrategy({ gatewaysProvider }),
+  },
+  verificationSettings: {
+    strategy: new HashVerificationStrategy({
+      trustedGateways,
+    }),
+  },
+  telemetrySettings: { enabled: true },
 });
 ```
 
@@ -82,23 +143,22 @@ const wayfinder = createWayfinderClient({
 When using the AR.IO Network provider, you can specify how gateways are selected:
 
 ```javascript
-import { createWayfinderClient } from '@ar.io/wayfinder-core';
+import {
+  createWayfinderClient,
+  NetworkGatewaysProvider,
+  RandomRoutingStrategy,
+} from '@ar.io/wayfinder-core';
 import { ARIO } from '@ar.io/sdk';
 
-const wayfinder = createWayfinderClient({
+const gatewaysProvider = new NetworkGatewaysProvider({
   ario: ARIO.mainnet(),
-  
-  // Gateway selection (only works with ARIO instance)
-  gatewaySelection: 'top-ranked', // Options:
-  // 'top-ranked' - Gateways with highest composite weight
-  // 'most-tenured' - Gateways with longest service history  
-  // 'highest-staked' - Gateways with most stake
-  // 'top-ranked' - Gateways with highest composite weight
-  // 'best-performance' - Gateways with best performance metrics
-  // 'longest-streak' - Gateways with longest uptime streak
-  
-  routing: 'random', // How to select from the filtered gateways
-  cache: { ttlSeconds: 600 }, // Cache for 10 minutes
+  sortBy: 'weights.normalizedCompositeWeight',
+  sortOrder: 'desc',
+  limit: 10,
+});
+
+const wayfinder = createWayfinderClient({
+  routingStrategy: new RandomRoutingStrategy({ gatewaysProvider }),
 });
 ```
 
@@ -637,7 +697,7 @@ const wayfinder = new Wayfinder({
   verificationSettings: {
     enabled: true,
     strategy: new HashVerificationStrategy({
-      trustedGateways: ['https://permagate.io'],
+      trustedGateways: [new URL('https://permagate.io')],
     }),
   },
 });
@@ -654,7 +714,7 @@ const wayfinder = new Wayfinder({
   verificationSettings: {
     enabled: true,
     strategy: new DataRootVerificationStrategy({
-      trustedGateways: ['https://permagate.io'],
+      trustedGateways: [new URL('https://permagate.io')],
     }),
   },
 });
@@ -671,7 +731,7 @@ const wayfinder = new Wayfinder({
   verificationSettings: {
     enabled: true,
     strategy: new SignatureVerificationStrategy({
-      trustedGateways: ['https://permagate.io'],
+      trustedGateways: [new URL('https://permagate.io')],
     }),
   },
 });
@@ -787,7 +847,7 @@ const response = await wayfinder.request('ar://example-name', {
 
 ### Optional Dependencies
 
-The `@ar.io/sdk` package is an optional peer dependency. To use AR.IO network gateways, you must explicitly provide an `ario` instance:
+The `@ar.io/sdk` package is an optional peer dependency. To use AR.IO network gateways, instantiate a `NetworkGatewaysProvider` with an `ario` instance and supply it to `Wayfinder` directly:
 
 **With AR.IO SDK (Recommended):**
 ```bash
@@ -795,7 +855,7 @@ npm install @ar.io/wayfinder-core @ar.io/sdk
 # or
 yarn add @ar.io/wayfinder-core @ar.io/sdk
 ```
-- `createWayfinderClient({ ario: ARIO.mainnet() })` uses AR.IO network gateways
+- `new NetworkGatewaysProvider({ ario: ARIO.mainnet() })` exposes AR.IO network gateways
 - Supports intelligent gateway selection criteria
 - Dynamic gateway discovery and updates
 
@@ -815,29 +875,27 @@ Wayfinder supports intelligent caching:
 
 ### Custom Providers and Strategies
 
-For advanced use cases, you can provide custom providers and strategies to `createWayfinderClient`:
+For advanced use cases, provide strategy instances explicitly:
 
 ```javascript
-import { createWayfinderClient, NetworkGatewaysProvider } from '@ar.io/wayfinder-core';
-import { ARIO } from '@ar.io/sdk';
+import {
+  createWayfinderClient,
+  FastestPingRoutingStrategy,
+  HashVerificationStrategy,
+} from '@ar.io/wayfinder-core';
 
 const wayfinder = createWayfinderClient({
-  ario: ARIO.mainnet()
-  
-  // Gateway selection
-  gatewaySelection: 'top-ranked',
-  
   // Enable caching with custom TTL
   cache: { ttlSeconds: 3600 }, // 1 hour
 
-  // Override 'routing' with custom routing strategy
+  // Supply a bespoke routing strategy
   routingStrategy: new FastestPingRoutingStrategy({
     timeoutMs: 1000,
   }),
 
-  // Override 'verification' with custom verification strategy
+  // Configure verification explicitly
   verificationStrategy: new HashVerificationStrategy({
-    trustedGateways: ['https://permagate.io'],
+    trustedGateways: [new URL('https://permagate.io')],
   }),
 });
 ```
@@ -888,7 +946,7 @@ const wayfinder = new Wayfinder({
     enabled: true,
     // verify the data using the hash of the data against a list of trusted gateways
     strategy: new HashVerificationStrategy({
-      trustedGateways: ['https://permagate.io'],
+      trustedGateways: [new URL('https://permagate.io')],
     }),
     // strict verification - if true, verification failures will cause requests to fail
     strict: true,
@@ -910,17 +968,15 @@ const wayfinder = new Wayfinder({
 
 ## Telemetry
 
-Wayfinder can optionally emit OpenTelemetry spans for every request. **By default, telemetry is disabled**. You can control this behavior with the `telemetrySettings` option.
+Wayfinder can optionally emit OpenTelemetry spans for every request. **By default, telemetry is disabled**. You can control this behavior with the `telemetry` option.
 
 ```javascript
 
 import { createWayfinderClient } from '@ar.io/wayfinder-core';
-import { ARIO } from '@ar.io/sdk';
 
 const wayfinder = createWayfinderClient({
-  ario: ARIO.mainnet(),
   // other settings...
-  telemetrySettings: {
+  telemetry: {
     enabled: true, // disabled by default (must be explicitly enabled)
     sampleRate: 0.1, // 10% sample rate by default
     exporterUrl: 'https://your-custom-otel-exporter', // optional, defaults to https://api.honeycomb.io/v1/traces

package/dist/client.d.ts

@@ -21,27 +21,32 @@ export interface CreateWayfinderClientOptions {
     /**
      * The ARIO instance to use for network gateways provider
      * If not provided, will fall back to static gateways
+     * @deprecated Provide a custom `gatewaysProvider` instead.
      */
     ario?: AoARIORead;
     /**
      * The routing strategy to use
      * @default 'random'
+     * @deprecated Provide a `routingStrategy` instance instead.
      */
     routing?: RoutingOption;
     /**
      * The verification strategy to use
      * @default 'disabled'
+     * @deprecated Provide a `verificationStrategy` instance instead.
      */
     verification?: VerificationOption;
     /**
      * The gateway selection when using NetworkGatewaysProvider (requires ario instance)
      * Only applies when using AR.IO network - ignored for static gateways
      * @default 'top-ranked'
+     * @deprecated Configure gateway selection via your custom `gatewaysProvider`.
      */
     gatewaySelection?: GatewaySelection;
     /**
      * The trusted gateways to use
      * @default ['https://permagate.io']
+     * @deprecated Configure trusted gateways via your `verificationStrategy`.
      */
     trustedGateways?: string[];
     /**
@@ -62,6 +67,7 @@ export interface CreateWayfinderClientOptions {
     /**
      * Custom gateways provider (overrides gatewaySelection)
      * @default undefined
+     * @deprecated Instantiate `Wayfinder` directly when providing custom gateways providers.
      */
     gatewaysProvider?: GatewaysProvider;
     /**
@@ -83,8 +89,9 @@ export interface CreateWayfinderClientOptions {
     /**
      * The fallback routing strategy to use when routing is 'preferred'
      * @default 'random'
+     * @deprecated Compose fallback behavior directly in your `routingStrategy`.
      */
-    fallbackStrategy?: RoutingOption;
+    fallbackStrategy?: RoutingOption | RoutingStrategy;
     /**
      * Telemetry configuration for OpenTelemetry tracing
      * @default { enabled: false }
@@ -97,7 +104,13 @@ export interface CreateWayfinderClientOptions {
  * @param config
  * @returns
  */
-export declare const useRoutingStrategy: (strategy: RoutingOption, config?: any) => RoutingStrategy;
+type UseRoutingStrategyConfig = {
+    gatewaysProvider?: GatewaysProvider;
+    logger?: Logger;
+    preferredGateway?: string;
+    fallbackStrategy?: RoutingStrategy;
+};
+export declare const useRoutingStrategy: (strategy: RoutingOption, config?: UseRoutingStrategyConfig) => RoutingStrategy;
 /**
  * Helper function to construct a verification strategy
  * @param strategy - The verification strategy to use
@@ -106,9 +119,10 @@ export declare const useRoutingStrategy: (strategy: RoutingOption, config?: any)
  */
 export declare const useVerificationStrategy: (strategy: VerificationOption, config?: any) => VerificationStrategy;
 /**
- * Creates a Wayfinder client with the specified configuration
- * Uses static gateways by default. Provide an `ario` instance to use NetworkGatewaysProvider
+ * Creates a Wayfinder client with the specified configuration.
+ * Uses the trusted peers gateways provider and random routing by default.
  */
 export declare function createWayfinderClient(options?: CreateWayfinderClientOptions): Wayfinder;
 export declare const createWayfinder: typeof createWayfinderClient;
+export {};
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAU7C,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,MAAM,EACN,aAAa,EACb,eAAe,EAGf,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAsB3C,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IAExB;;;OAGG;IACH,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAElC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAEzC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC;;;OAGG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAElC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAE5C;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,aAAa,CAAC;IAEjC;;;OAGG;IACH,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,UAAU,aAAa,EACvB,SAAS,GAAG,KACX,eAQF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,kBAAkB,EAC5B,SAAS,GAAG,KACX,oBAQF,CAAC;AAEF;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,4BAAiC,GACzC,SAAS,CA+GX;AAED,eAAO,MAAM,eAAe,8BAAwB,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAU7C,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,MAAM,EACN,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAc3C,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IAExB;;;;OAIG;IACH,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAElC;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAEzC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC;;;OAGG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAElC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAE5C;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,aAAa,GAAG,eAAe,CAAC;IAEnD;;;OAGG;IACH,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED;;;;;GAKG;AACH,KAAK,wBAAwB,GAAG;IAC9B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,eAAe,CAAC;CACpC,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,UAAU,aAAa,EACvB,SAAQ,wBAA6B,KACpC,eAkBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,kBAAkB,EAC5B,SAAS,GAAG,KACX,oBAQF,CAAC;AAEF;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,4BAAiC,GACzC,SAAS,CA0HX;AAED,eAAO,MAAM,eAAe,8BAAwB,CAAC"}

package/dist/client.js

@@ -15,9 +15,9 @@
  * limitations under the License.
  */
 import { LocalStorageGatewaysProvider } from './gateways/local-storage-cache.js';
-import { NetworkGatewaysProvider } from './gateways/network.js';
 import { SimpleCacheGatewaysProvider } from './gateways/simple-cache.js';
 import { TrustedPeersGatewaysProvider } from './gateways/trusted-peers.js';
+import { defaultLogger } from './logger.js';
 import { FastestPingRoutingStrategy } from './routing/ping.js';
 import { PreferredWithFallbackRoutingStrategy } from './routing/preferred-with-fallback.js';
 import { RandomRoutingStrategy } from './routing/random.js';
@@ -28,34 +28,22 @@ import { DataRootVerificationStrategy } from './verification/data-root-verificat
 import { HashVerificationStrategy } from './verification/hash-verification.js';
 import { RemoteVerificationStrategy } from './verification/remote-verification.js';
 import { Wayfinder } from './wayfinder.js';
-const selectionSortMap = {
-    'best-performance': {
-        sortBy: 'weights.gatewayPerformanceRatio',
-        sortOrder: 'desc',
-    },
-    'most-tenured': { sortBy: 'weights.tenureWeight', sortOrder: 'desc' },
-    'highest-staked': { sortBy: 'weights.stakeWeight', sortOrder: 'desc' },
-    'top-ranked': {
-        sortBy: 'weights.normalizedCompositeWeight',
-        sortOrder: 'desc',
-    },
-    'longest-streak': {
-        sortBy: 'stats.passedConsecutiveEpochs',
-        sortOrder: 'desc',
-    },
+const DEFAULT_TRUSTED_GATEWAY = 'https://permagate.io';
+const warnDeprecatedOption = (logger, option, guidance) => {
+    logger.warn(`[wayfinder] The \`${option}\` option for createWayfinderClient() is deprecated. ${guidance}`);
 };
-/**
- * Helper function to construct a routing strategy
- * @param strategy - The routing strategy to use
- * @param config
- * @returns
- */
-export const useRoutingStrategy = (strategy, config) => {
+export const useRoutingStrategy = (strategy, config = {}) => {
+    const { fallbackStrategy, preferredGateway, ...baseConfig } = config;
+    const resolvedFallbackStrategy = fallbackStrategy ?? new FastestPingRoutingStrategy(baseConfig);
     const routingMap = {
-        random: new RandomRoutingStrategy(config),
-        fastest: new FastestPingRoutingStrategy(config),
-        preferred: new PreferredWithFallbackRoutingStrategy(config),
-        'round-robin': new RoundRobinRoutingStrategy(config),
+        random: new RandomRoutingStrategy(baseConfig),
+        fastest: new FastestPingRoutingStrategy(baseConfig),
+        preferred: new PreferredWithFallbackRoutingStrategy({
+            preferredGateway: preferredGateway ?? 'https://arweave.net',
+            fallbackStrategy: resolvedFallbackStrategy,
+            logger: config.logger,
+        }),
+        'round-robin': new RoundRobinRoutingStrategy(baseConfig),
     };
     return routingMap[strategy];
 };
@@ -75,91 +63,103 @@ export const useVerificationStrategy = (strategy, config) => {
     return verificationMap[strategy];
 };
 /**
- * Creates a Wayfinder client with the specified configuration
- * Uses static gateways by default. Provide an `ario` instance to use NetworkGatewaysProvider
+ * Creates a Wayfinder client with the specified configuration.
+ * Uses the trusted peers gateways provider and random routing by default.
  */
 export function createWayfinderClient(options = {}) {
-    const { routing = 'random', verification = 'disabled', trustedGateways = ['https://permagate.io'], cache = false, gatewaySelection = 'top-ranked', logger, ario, gatewaysProvider: customGatewaysProvider, routingStrategy: customRoutingStrategy, verificationStrategy: customVerificationStrategy, preferredGateway = 'https://arweave.net', fallbackStrategy = 'random', telemetry, } = options;
+    const { cache = false, logger, routingStrategy: customRoutingStrategy, verificationStrategy: customVerificationStrategy, telemetry, } = options;
+    const resolvedLogger = logger ?? defaultLogger;
+    const deprecatedGuidance = [
+        ['routing', 'Provide a `routingStrategy` instance instead.'],
+        ['verification', 'Provide a `verificationStrategy` instance instead.'],
+        [
+            'gatewaySelection',
+            'Configure gateway selection via your custom `routingStrategy`.',
+        ],
+        [
+            'gatewaysProvider',
+            'Instantiate `Wayfinder` directly when providing custom gateways providers.',
+        ],
+        [
+            'fallbackStrategy',
+            'Compose fallback behavior directly in your `routingStrategy`.',
+        ],
+        [
+            'preferredGateway',
+            'Configure preferred gateways within your `routingStrategy`.',
+        ],
+        [
+            'ario',
+            'Instantiate `Wayfinder` directly and supply your own gateways provider.',
+        ],
+        [
+            'trustedGateways',
+            'Configure trusted gateways via your `verificationStrategy`.',
+        ],
+    ];
+    for (const [option, guidance] of deprecatedGuidance) {
+        if (Object.prototype.hasOwnProperty.call(options, option)) {
+            warnDeprecatedOption(resolvedLogger, option, guidance);
+        }
+    }
     // Parse cache configuration
     const cacheEnabled = !!cache;
     const cacheTTLSeconds = typeof cache === 'object' ? cache.ttlSeconds : 300; // 5 minutes default
-    // Set up gateways provider
-    let gatewaysProvider;
-    if (customGatewaysProvider) {
-        gatewaysProvider = customGatewaysProvider;
-    }
-    else if (ario) {
-        const { sortBy, sortOrder } = selectionSortMap[gatewaySelection];
-        gatewaysProvider = new NetworkGatewaysProvider({
-            ario,
-            sortBy,
-            sortOrder,
-            limit: 10,
-        });
-    }
-    else {
-        // Fall back to trusted peers gateway provider when no ARIO instance is provided
-        gatewaysProvider = new TrustedPeersGatewaysProvider({
-            trustedGateway: trustedGateways[0] || 'https://arweave.net',
-            logger,
-        });
-    }
-    // Wrap with cache if enabled
-    if (cacheEnabled) {
-        if (isBrowser()) {
-            gatewaysProvider = new LocalStorageGatewaysProvider({
-                gatewaysProvider: gatewaysProvider,
-                ttlSeconds: cacheTTLSeconds,
-            });
-        }
-        else {
-            gatewaysProvider = new SimpleCacheGatewaysProvider({
-                gatewaysProvider: gatewaysProvider,
-                ttlSeconds: cacheTTLSeconds,
-            });
-        }
-    }
     // Set up routing strategy
     let routingStrategy;
     if (customRoutingStrategy) {
         routingStrategy = customRoutingStrategy;
     }
     else {
-        routingStrategy = useRoutingStrategy(routing, {
-            preferredGateway,
-            fallbackStrategy,
+        // Create base gateways provider
+        let gatewaysProvider = new TrustedPeersGatewaysProvider({
+            trustedGateway: DEFAULT_TRUSTED_GATEWAY,
+            logger: resolvedLogger,
+        });
+        // Wrap gateways provider with cache if enabled
+        if (cacheEnabled) {
+            if (isBrowser()) {
+                gatewaysProvider = new LocalStorageGatewaysProvider({
+                    gatewaysProvider: gatewaysProvider,
+                    ttlSeconds: cacheTTLSeconds,
+                    logger: resolvedLogger,
+                });
+            }
+            else {
+                gatewaysProvider = new SimpleCacheGatewaysProvider({
+                    gatewaysProvider: gatewaysProvider,
+                    ttlSeconds: cacheTTLSeconds,
+                    logger: resolvedLogger,
+                });
+            }
+        }
+        // Create routing strategy with the gateways provider
+        routingStrategy = useRoutingStrategy('random', {
+            gatewaysProvider,
+            logger: resolvedLogger,
         });
-        // Wrap with cache if enabled
+        // Wrap routing strategy with cache if enabled
         if (cacheEnabled) {
             // TODO: add browser cache support for routing strategy
             routingStrategy = new SimpleCacheRoutingStrategy({
                 routingStrategy,
                 ttlSeconds: cacheTTLSeconds,
+                logger: resolvedLogger,
             });
         }
     }
     // Set up verification strategy
-    let verificationStrategy;
-    const verificationEnabled = true;
-    if (customVerificationStrategy) {
-        verificationStrategy = customVerificationStrategy;
-    }
-    else {
-        verificationStrategy = useVerificationStrategy(verification, {
-            trustedGateways: trustedGateways.map((url) => new URL(url)),
-        });
-    }
+    const verificationStrategy = customVerificationStrategy;
     // Create Wayfinder options
     const wayfinderOptions = {
-        logger,
-        gatewaysProvider,
+        logger: resolvedLogger,
         routingSettings: {
             strategy: routingStrategy,
         },
         telemetrySettings: telemetry,
     };
     // Only add verification settings if not disabled
-    if (verificationEnabled && verificationStrategy) {
+    if (verificationStrategy) {
         wayfinderOptions.verificationSettings = {
             enabled: true,
             strategy: verificationStrategy,

package/dist/routing/ping.d.ts

@@ -1,5 +1,6 @@
 import type { GatewaysProvider, Logger, RoutingStrategy } from '../types.js';
 export declare class FastestPingRoutingStrategy implements RoutingStrategy {
+    readonly name = "fastest-ping";
     private timeoutMs;
     private logger;
     private maxConcurrency;
@@ -23,10 +24,11 @@ export declare class FastestPingRoutingStrategy implements RoutingStrategy {
  * If the HEAD check fails after all retries, it throws an error.
  */
 export declare class PingRoutingStrategy implements RoutingStrategy {
-    private routingStrategy;
+    readonly name = "ping";
+    readonly routingStrategy: RoutingStrategy;
     private logger;
-    private retries;
-    private timeoutMs;
+    readonly retries: number;
+    readonly timeoutMs: number;
     private gatewaysProvider?;
     constructor({ routingStrategy, logger, retries, timeoutMs, gatewaysProvider, }: {
         routingStrategy: RoutingStrategy;

package/dist/routing/ping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ping.d.ts","sourceRoot":"","sources":["../../src/routing/ping.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE7E,qBAAa,0BAA2B,YAAW,eAAe;IAChE,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,gBAAgB,CAAC,CAAmB;gBAEhC,EACV,SAAe,EACf,cAAmB,EACnB,MAAsB,EACtB,gBAAgB,GACjB,GAAE;QACD,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;KAChC;IAOA,aAAa,CAAC,EAClB,QAAQ,EACR,IAAS,EACT,SAAS,GACV,EAAE;QACD,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,GAAG,CAAC;CAoFjB;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IACzD,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAAC,CAAmB;gBAEhC,EACV,eAAe,EACf,MAAsB,EACtB,OAAW,EACX,SAAgB,EAChB,gBAAgB,GACjB,EAAE;QACD,eAAe,EAAE,eAAe,CAAC;QACjC,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;KACrC;IAQK,aAAa,CAAC,MAAM,EAAE;QAC1B,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,GAAG,CAAC;CAkFjB"}
+{"version":3,"file":"ping.d.ts","sourceRoot":"","sources":["../../src/routing/ping.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE7E,qBAAa,0BAA2B,YAAW,eAAe;IAChE,SAAgB,IAAI,kBAAkB;IACtC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,gBAAgB,CAAC,CAAmB;gBAEhC,EACV,SAAe,EACf,cAAmB,EACnB,MAAsB,EACtB,gBAAgB,GACjB,GAAE;QACD,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;KAChC;IAOA,aAAa,CAAC,EAClB,QAAQ,EACR,IAAS,EACT,SAAS,GACV,EAAE;QACD,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,GAAG,CAAC;CAoFjB;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IACzD,SAAgB,IAAI,UAAU;IAC9B,SAAgB,eAAe,EAAE,eAAe,CAAC;IACjD,OAAO,CAAC,MAAM,CAAS;IACvB,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,OAAO,CAAC,gBAAgB,CAAC,CAAmB;gBAEhC,EACV,eAAe,EACf,MAAsB,EACtB,OAAW,EACX,SAAgB,EAChB,gBAAgB,GACjB,EAAE;QACD,eAAe,EAAE,eAAe,CAAC;QACjC,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;KACrC;IAQK,aAAa,CAAC,MAAM,EAAE;QAC1B,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,GAAG,CAAC;CAkFjB"}

package/dist/routing/ping.js

@@ -17,6 +17,7 @@
 import { pLimit } from 'plimit-lit';
 import { defaultLogger } from '../logger.js';
 export class FastestPingRoutingStrategy {
+    name = 'fastest-ping';
     timeoutMs;
     logger;
     maxConcurrency;
@@ -102,6 +103,7 @@ export class FastestPingRoutingStrategy {
  * If the HEAD check fails after all retries, it throws an error.
  */
 export class PingRoutingStrategy {
+    name = 'ping';
     routingStrategy;
     logger;
     retries;

package/dist/telemetry.d.ts

@@ -19,18 +19,17 @@ import { BasicTracerProvider } from '@opentelemetry/sdk-trace-base';
 import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';
 import { WebTracerProvider } from '@opentelemetry/sdk-trace-web';
 import { WayfinderEmitter } from './emitter.js';
-import type { GatewaysProvider, TelemetrySettings, WayfinderOptions } from './types.js';
+import type { TelemetrySettings, WayfinderOptions } from './types.js';
 export declare const initTelemetry: ({ enabled, sampleRate, exporterUrl, apiKey, clientName, clientVersion, }: TelemetrySettings) => {
     tracerProvider: WebTracerProvider | NodeTracerProvider | BasicTracerProvider;
     tracer: Tracer;
 } | undefined;
-export declare const startRequestSpans: ({ originalUrl, emitter, tracer, verificationSettings, routingSettings, gatewaysProvider, }?: {
+export declare const startRequestSpans: ({ originalUrl, emitter, tracer, verificationSettings, routingSettings, }?: {
     originalUrl?: string;
     emitter?: WayfinderEmitter;
     tracer?: Tracer;
     verificationSettings?: WayfinderOptions["verificationSettings"];
     routingSettings?: WayfinderOptions["routingSettings"];
-    gatewaysProvider?: GatewaysProvider;
 }) => {
     parentSpan: Span | undefined;
     routingSpan: Span | undefined;

package/dist/telemetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAGL,IAAI,EACJ,KAAK,MAAM,EAIZ,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EACL,mBAAmB,EAIpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAKjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAkBpB,eAAO,MAAM,aAAa,GAAI,0EAO3B,iBAAiB,KAChB;IACE,cAAc,EACV,iBAAiB,GACjB,kBAAkB,GAClB,mBAAmB,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB,GACD,SAuEH,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,6FAO/B;IACD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,gBAAgB,CAAC,sBAAsB,CAAC,CAAC;IAChE,eAAe,CAAC,EAAE,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;IACtD,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CAChC;;;;CA+EL,CAAC"}
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAGL,IAAI,EACJ,KAAK,MAAM,EAIZ,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EACL,mBAAmB,EAIpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAKjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAkBtE,eAAO,MAAM,aAAa,GAAI,0EAO3B,iBAAiB,KAChB;IACE,cAAc,EACV,iBAAiB,GACjB,kBAAkB,GAClB,mBAAmB,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB,GACD,SAuEH,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,2EAM/B;IACD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,gBAAgB,CAAC,sBAAsB,CAAC,CAAC;IAChE,eAAe,CAAC,EAAE,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;CAClD;;;;CA8EL,CAAC"}

package/dist/telemetry.js

@@ -98,7 +98,7 @@ clientName, clientVersion, }) => {
         tracer,
     };
 };
-export const startRequestSpans = ({ originalUrl, emitter, tracer, verificationSettings, routingSettings, gatewaysProvider, } = {}) => {
+export const startRequestSpans = ({ originalUrl, emitter, tracer, verificationSettings, routingSettings, } = {}) => {
     const parentSpan = tracer?.startSpan('wayfinder.request', {
         attributes: {
             originalUrl: originalUrl ?? 'undefined',
@@ -109,7 +109,6 @@ export const startRequestSpans = ({ originalUrl, emitter, tracer, verificationSe
                 ?.map((gateway) => gateway.toString())
                 .join(','),
             'routing.strategy': routingSettings?.strategy?.constructor.name ?? 'undefined',
-            gatewaysProvider: gatewaysProvider?.constructor.name,
         },
     }, context.active());
     let routingSpan;

package/dist/types.d.ts

@@ -99,6 +99,7 @@ export interface WayfinderOptions {
     logger?: Logger;
     /**
      * The gateways provider to use for routing requests.
+     * @deprecated Use routing strategies with their own gateways providers instead.
      */
     gatewaysProvider?: GatewaysProvider;
     /**

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -14,5 +14,5 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export declare const WAYFINDER_CORE_VERSION = "v1.6.1";
+export declare const WAYFINDER_CORE_VERSION = "v1.7.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -14,4 +14,4 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export const WAYFINDER_CORE_VERSION = 'v1.6.1';
+export const WAYFINDER_CORE_VERSION = 'v1.7.0';

package/dist/wayfinder.d.ts

@@ -75,9 +75,8 @@ export declare function tapAndVerifyReadableStream({ originalStream, contentLeng
  * @param resolveUrl - the function to construct the redirect url for ar:// requests
  * @returns a wrapped fetch function that supports ar:// protocol and always returns Response
  */
-export declare const wayfinderFetch: ({ logger, gatewaysProvider, verificationSettings, routingSettings, emitter, tracer, }: {
+export declare const wayfinderFetch: ({ logger, verificationSettings, routingSettings, emitter, tracer, }: {
     logger?: Logger;
-    gatewaysProvider: GatewaysProvider;
     verificationSettings: NonNullable<WayfinderOptions["verificationSettings"]>;
     routingSettings: NonNullable<WayfinderOptions["routingSettings"]>;
     emitter?: WayfinderEmitter;
@@ -93,13 +92,7 @@ export declare class Wayfinder {
     /**
      * The gateways provider is responsible for providing the list of gateways to use for routing requests.
      *
-     * @example
-     * const wayfinder = new Wayfinder({
-     *   gatewaysProvider: new SimpleCacheGatewaysProvider({
-     *     gatewaysProvider: new NetworkGatewaysProvider({ ario: ARIO.mainnet() }),
-     *     ttlSeconds: 60 * 60 * 24, // 1 day
-     *   }),
-     * });
+     * Useful if you want to get the list of gateways from a dynamic source.
      */
     readonly gatewaysProvider: GatewaysProvider;
     /**
@@ -194,6 +187,12 @@ export declare class Wayfinder {
      * @param options - Wayfinder configuration options
      */
     constructor({ logger, gatewaysProvider, verificationSettings, routingSettings, telemetrySettings, }?: WayfinderOptions);
+    /**
+     * Helper method to inject gatewaysProvider into routing strategies that support it
+     * @param strategy - The routing strategy to inject into
+     * @param gatewaysProvider - The gateways provider to inject
+     */
+    private injectGatewaysProviderIntoStrategy;
     /**
      * Sets the routing strategy to use for routing requests.
      *

package/dist/wayfinder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wayfinder.d.ts","sourceRoot":"","sources":["../src/wayfinder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wayfinder.d.ts","sourceRoot":"","sources":["../src/wayfinder.ts"],"names":[],"mappings":"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"}

package/dist/wayfinder.js

@@ -220,7 +220,7 @@ export function tapAndVerifyReadableStream({ originalStream, contentLength, veri
  * @param resolveUrl - the function to construct the redirect url for ar:// requests
  * @returns a wrapped fetch function that supports ar:// protocol and always returns Response
  */
-export const wayfinderFetch = ({ logger = defaultLogger, gatewaysProvider, verificationSettings, routingSettings, emitter, tracer, }) => {
+export const wayfinderFetch = ({ logger = defaultLogger, verificationSettings, routingSettings, emitter, tracer, }) => {
     return async (input, init) => {
         const { 
         // allows for overriding the verification and routing settings for a single request
@@ -235,7 +235,6 @@ export const wayfinderFetch = ({ logger = defaultLogger, gatewaysProvider, verif
             originalUrl: url,
             verificationSettings: requestVerificationSettings ?? verificationSettings,
             routingSettings: requestRoutingSettings ?? routingSettings,
-            gatewaysProvider,
             emitter: requestEmitter,
             tracer,
         });
@@ -260,7 +259,6 @@ export const wayfinderFetch = ({ logger = defaultLogger, gatewaysProvider, verif
                 const { subdomain, path } = extractRoutingInfo(url);
                 // select the target gateway
                 const selectedGateway = await routingSettings.strategy?.selectGateway({
-                    gateways: await gatewaysProvider.getGateways(),
                     path,
                     subdomain,
                 });
@@ -420,13 +418,7 @@ export class Wayfinder {
     /**
      * The gateways provider is responsible for providing the list of gateways to use for routing requests.
      *
-     * @example
-     * const wayfinder = new Wayfinder({
-     *   gatewaysProvider: new SimpleCacheGatewaysProvider({
-     *     gatewaysProvider: new NetworkGatewaysProvider({ ario: ARIO.mainnet() }),
-     *     ttlSeconds: 60 * 60 * 24, // 1 day
-     *   }),
-     * });
+     * Useful if you want to get the list of gateways from a dynamic source.
      */
     gatewaysProvider;
     /**
@@ -521,7 +513,7 @@ export class Wayfinder {
     constructor({ logger, gatewaysProvider, verificationSettings, routingSettings, telemetrySettings, } = {}) {
         // default logger to use if no logger is provided
         this.logger = logger ?? defaultLogger;
-        // default gateways provider to use if no provider is provided
+        // deprecated - kept for backwards compatibility
         this.gatewaysProvider =
             gatewaysProvider ??
                 new TrustedPeersGatewaysProvider({
@@ -543,16 +535,24 @@ export class Wayfinder {
             // overwrite the default settings with the provided ones
             ...verificationSettings,
         };
-        // default routing settings
+        // default routing settings with backwards compatibility for gatewaysProvider
         this.routingSettings = {
             events: {},
             strategy: new PingRoutingStrategy({
                 logger,
-                routingStrategy: new RandomRoutingStrategy({ logger }),
+                routingStrategy: new RandomRoutingStrategy({
+                    logger,
+                    // use the gateways provider given, or fallback to the default if non provided
+                    gatewaysProvider: this.gatewaysProvider,
+                }),
             }),
             // overwrite the default settings with the provided ones
             ...routingSettings,
         };
+        // If a custom routing strategy is provided, inject the gatewaysProvider into it
+        if (routingSettings?.strategy) {
+            this.injectGatewaysProviderIntoStrategy(routingSettings.strategy, this.gatewaysProvider);
+        }
         this.emitter = new WayfinderEmitter({
             verification: this.verificationSettings?.events,
             routing: this.routingSettings?.events,
@@ -588,7 +588,25 @@ export class Wayfinder {
             telemetrySettings: this.telemetrySettings,
         });
     }
-    // TODO: consider property getters and setters for strategies and settings
+    /**
+     * Helper method to inject gatewaysProvider into routing strategies that support it
+     * @param strategy - The routing strategy to inject into
+     * @param gatewaysProvider - The gateways provider to inject
+     */
+    injectGatewaysProviderIntoStrategy(strategy, gatewaysProvider) {
+        // Check if the strategy has a gatewaysProvider property that can be set
+        if ('gatewaysProvider' in strategy &&
+            strategy.gatewaysProvider === undefined) {
+            strategy.gatewaysProvider = gatewaysProvider;
+        }
+        // Handle composite strategies that might have nested strategies
+        if ('routingStrategy' in strategy && strategy.routingStrategy) {
+            this.injectGatewaysProviderIntoStrategy(strategy.routingStrategy, gatewaysProvider);
+        }
+        if ('fallbackStrategy' in strategy && strategy.fallbackStrategy) {
+            this.injectGatewaysProviderIntoStrategy(strategy.fallbackStrategy, gatewaysProvider);
+        }
+    }
     /**
      * Sets the routing strategy to use for routing requests.
      *
@@ -600,6 +618,10 @@ export class Wayfinder {
      */
     setRoutingStrategy(strategy) {
         this.routingSettings.strategy = strategy;
+        // If a deprecated gatewaysProvider is set, inject it into the new strategy
+        if (this.gatewaysProvider) {
+            this.injectGatewaysProviderIntoStrategy(strategy, this.gatewaysProvider);
+        }
     }
     /**
      * Sets the verification strategy to use for verifying requests.
@@ -694,7 +716,6 @@ export class Wayfinder {
     request(input, init) {
         return wayfinderFetch({
             logger: this.logger,
-            gatewaysProvider: this.gatewaysProvider,
             emitter: this.emitter,
             routingSettings: this.routingSettings,
             verificationSettings: this.verificationSettings,
@@ -753,7 +774,6 @@ export class Wayfinder {
         resolveUrlSpan?.setAttribute('subdomain', subdomain);
         resolveUrlSpan?.setAttribute('path', path);
         const selectedGateway = await this.routingSettings.strategy.selectGateway({
-            gateways: await this.gatewaysProvider.getGateways(),
             path,
             subdomain,
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ar.io/wayfinder-core",
-  "version": "1.6.1",
+  "version": "1.7.0",
   "description": "WayFinder core library for intelligently routing to optimal AR.IO gateways",
   "main": "dist/index.js",
   "module": "dist/index.js",