@ar.io/wayfinder-core 1.4.0-alpha.0 → 1.4.0-alpha.2

package/README.md

@@ -75,14 +75,6 @@ const wayfinder = createWayfinderClient({
   // List of trusted gateways for verification
   trustedGateways: ['https://arweave.net', 'https://permagate.io'],
 });
-
-// Sync version with static gateways (when no ario instance provided)
-const wayfinderSync = createWayfinderClientSync({
-  // Same options as above, but uses static gateways by default
-  routing: 'random',
-  verification: 'disabled',
-  trustedGateways: ['https://permagate.io', 'https://arweave.net'],
-});
 ```
 
 ### Gateway Selection Options (with AR.IO Network)
@@ -97,11 +89,12 @@ const wayfinder = createWayfinderClient({
   ario: ARIO.mainnet(),
   
   // Gateway selection (only works with ARIO instance)
-  gatewaySelection: 'highest-performing', // Options:
-  // 'highest-performing' - Gateways with best performance metrics
-  // 'longest-tenure' - Gateways with longest service history  
+  gatewaySelection: 'top-ranked', // Options:
+  // 'top-ranked' - Gateways with highest composite weight
+  // 'most-tenured' - Gateways with longest service history  
   // 'highest-staked' - Gateways with most stake
-  // 'highest-weight' - Gateways with highest composite weight
+  // '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
@@ -216,10 +209,28 @@ Wayfinder supports multiple routing strategies to select target gateways for you
 Selects a random gateway from a list of gateways.
 
 ```javascript
-const routingStrategy = new RandomRoutingStrategy();
+import { RandomRoutingStrategy, NetworkGatewaysProvider } from '@ar.io/wayfinder-core';
+import { ARIO } from '@ar.io/sdk';
 
+// Option 1: Use with static gateways (override gatewaysProvider if provided)
+const routingStrategy = new RandomRoutingStrategy();
 const gateway = await routingStrategy.selectGateway({
-  gateways: ['https://arweave.net', 'https://permagate.io'],
+  gateways: [new URL('https://arweave.net'), new URL('https://permagate.io')],
+});
+
+// Option 2: Use with gatewaysProvider (fetches dynamically)
+const routingStrategy2 = new RandomRoutingStrategy({
+  gatewaysProvider: new NetworkGatewaysProvider({
+    ario: ARIO.mainnet(),
+    sortBy: 'operatorStake',
+    limit: 10,
+  }),
+});
+const gateway2 = await routingStrategy2.selectGateway(); // uses gatewaysProvider
+
+// Option 3: Override gatewaysProvider with static gateways
+const gateway3 = await routingStrategy2.selectGateway({
+  gateways: [new URL('https://custom-gateway.net')], // overrides gatewaysProvider
 });
 ```
 
@@ -237,42 +248,61 @@ const gateway = await routingStrategy.selectGateway(); // always returns the sam
 
 ### RoundRobinRoutingStrategy
 
-Selects gateways in round-robin order. The gateway list is stored in memory and is not persisted across instances.
+Selects gateways in round-robin order. The gateway list is stored in memory and is not persisted across instances. You must provide either `gateways` OR `gatewaysProvider` (not both).
 
 ```javascript
-import { Wayfinder, NetworkGatewaysProvider, RoundRobinRoutingStrategy } from '@ar.io/wayfinder-core';
+import { RoundRobinRoutingStrategy, NetworkGatewaysProvider } from '@ar.io/wayfinder-core';
 import { ARIO } from '@ar.io/sdk';
 
-const gatewayProvider = new NetworkGatewaysProvider({
-  ario: ARIO.mainnet(),
-  sortBy: 'operatorStake',
-  sortOrder: 'desc',
-  limit: 10,
+// use with a static list of gateways
+const routingStrategy = new RoundRobinRoutingStrategy({
+  gateways: [new URL('https://arweave.net'), new URL('https://permagate.io')],
 });
 
-// provide the gateways to the routing strategy on initialization to track the request count per gateway.
-// Any additional gateways provided to the selectGateway method will be ignored.
-const routingStrategy = new RoundRobinRoutingStrategy({
-  gateways: await gatewayProvider.getGateways(),
+// use with gatewaysProvider (loaded once and memoized)
+const routingStrategy2 = new RoundRobinRoutingStrategy({
+  gatewaysProvider: new NetworkGatewaysProvider({
+    ario: ARIO.mainnet(),
+    sortBy: 'operatorStake',
+    sortOrder: 'desc',
+    limit: 10,
+  }),
 });
 
-const gateway = await routingStrategy.selectGateway(); // returns the next gateway in the list
+const gateway = await routingStrategy.selectGateway(); // returns the next gateway in round-robin order
 ```
 
 ### FastestPingRoutingStrategy
 
-Selects the fastest gateway based simple HEAD request to the specified route.
+Selects the fastest gateway based on simple HEAD request to the specified route.
 
 ```javascript
-import { Wayfinder, FastestPingRoutingStrategy } from '@ar.io/wayfinder-core';
+import { FastestPingRoutingStrategy, NetworkGatewaysProvider } from '@ar.io/wayfinder-core';
+import { ARIO } from '@ar.io/sdk';
 
+// use with static gateways (override gatewaysProvider if provided)
 const routingStrategy = new FastestPingRoutingStrategy({
   timeoutMs: 1000,
 });
-
-// will select the fastest gateway from the list based on the ping time of the /ar-io/info route
 const gateway = await routingStrategy.selectGateway({
-  gateways: ['https://slow.net', 'https://medium.net', 'https://fast.net'],
+  gateways: [new URL('https://slow.net'), new URL('https://medium.net'), new URL('https://fast.net')],
+});
+
+// use with gatewaysProvider (fetches dynamically)
+const routingStrategy2 = new FastestPingRoutingStrategy({
+  timeoutMs: 1000,
+  gatewaysProvider: new NetworkGatewaysProvider({
+    ario: ARIO.mainnet(),
+    sortBy: 'operatorStake',
+    limit: 20,
+  }),
+});
+const gateway2 = await routingStrategy2.selectGateway({ path: '/ar-io/info' }); // uses gatewaysProvider
+
+// override the gatewaysProvider with a static list of gateways
+const gateway3 = await routingStrategy2.selectGateway({
+  gateways: [new URL('https://priority-gateway.net')], // overrides gatewaysProvider
+  path: '/ar-io/info'
 });
 ```
 
@@ -332,7 +362,7 @@ const strategy = new SimpleCacheRoutingStrategy({
 });
 ```
 
-#### Preferred gateway with fallback to ping-random
+#### Preferred gateway + network fallback strategy
 
 Attempt to use a favorite gateway, but fallback to a fastest pinging strategy using the ARIO Network if it fails.
 
@@ -639,15 +669,6 @@ yarn add @ar.io/wayfinder-core @ar.io/sdk
 - Supports intelligent gateway selection criteria
 - Dynamic gateway discovery and updates
 
-**Without AR.IO SDK:**
-```bash
-npm install @ar.io/wayfinder-core
-```
-- `createWayfinderClient()` falls back to curated static gateways
-- `createWayfinderClientSync()` uses only static gateways
-- Full routing and verification functionality available
-- No network gateway selection options
-
 ### Caching
 
 Wayfinder supports intelligent caching:
@@ -671,23 +692,23 @@ import { createWayfinderClient, NetworkGatewaysProvider } from '@ar.io/wayfinder
 import { ARIO } from '@ar.io/sdk';
 
 const wayfinder = createWayfinderClient({
-  // Use custom gateways provider
-  gatewaysProvider: new NetworkGatewaysProvider({
-    ario: ARIO.mainnet(),
-    sortBy: 'operatorStake',
-    sortOrder: 'desc',
-    limit: 10,
-  }),
-  
-  // Override with custom verification strategy
-  verification: 'hash',
-  trustedGateways: ['https://permagate.io'],
+  ario: ARIO.mainnet()
   
   // Gateway selection
-  gatewaySelection: 'highest-staked',
+  gatewaySelection: 'top-ranked',
   
   // Enable caching with custom TTL
   cache: { ttlSeconds: 3600 }, // 1 hour
+
+  // Override 'routing' with custom routing strategy
+  routingStrategy: new FastestPingRoutingStrategy({
+    timeoutMs: 1000,
+  }),
+
+  // Override 'verification' with custom verification strategy
+  verificationStrategy: new HashVerificationStrategy({
+    trustedGateways: ['https://permagate.io'],
+  }),
 });
 ```
 

package/dist/client.d.ts

@@ -15,16 +15,8 @@
  * limitations under the License.
  */
 import type { AoARIORead } from '@ar.io/sdk';
-import type { GatewaysProvider, Logger, RoutingStrategy, VerificationStrategy } from './types.js';
+import type { GatewaySelection, GatewaysProvider, Logger, RoutingOption, RoutingStrategy, VerificationOption, VerificationStrategy } from './types.js';
 import { Wayfinder } from './wayfinder.js';
-export type RoutingOption = 'random' | 'fastest' | 'round-robin' | 'preferred';
-export type VerificationOption = 'hash' | 'data-root' | 'remote' | 'disabled';
-export type GatewaySelection = 'highest-performing' | 'longest-tenure' | 'highest-staked' | 'highest-weight' | 'longest-streak';
-/**
- * Creates a Wayfinder client synchronously using static gateways
- * Use this when you want to avoid the AR.IO SDK dependency
- */
-export declare function createWayfinderClientSync(options?: CreateWayfinderClientOptions): Wayfinder;
 export interface CreateWayfinderClientOptions {
     /**
      * The ARIO instance to use for network gateways provider
@@ -44,12 +36,12 @@ export interface CreateWayfinderClientOptions {
     /**
      * The gateway selection when using NetworkGatewaysProvider (requires ario instance)
      * Only applies when using AR.IO network - ignored for static gateways
-     * @default 'highest-performing'
+     * @default 'top-ranked'
      */
     gatewaySelection?: GatewaySelection;
     /**
      * The trusted gateways to use
-     * @default ['https://arweave.net']
+     * @default ['https://permagate.io']
      */
     trustedGateways?: string[];
     /**
@@ -64,26 +56,54 @@ export interface CreateWayfinderClientOptions {
     };
     /**
      * Custom logger implementation
+     * @default undefined
      */
     logger?: Logger;
     /**
      * Custom gateways provider (overrides gatewaySelection)
+     * @default undefined
      */
     gatewaysProvider?: GatewaysProvider;
     /**
      * Custom routing strategy (overrides routing option)
+     * @default undefined
      */
     routingStrategy?: RoutingStrategy;
     /**
      * Custom verification strategy (overrides verification option)
+     * @default undefined
      */
     verificationStrategy?: VerificationStrategy;
+    /**
+     * The preferred gateway to use when routing is 'preferred'
+     * Defaults to the first trusted gateway if not specified
+     * @default 'arweave.net'
+     */
+    preferredGateway?: string;
+    /**
+     * The fallback routing strategy to use when routing is 'preferred'
+     * @default 'random'
+     */
+    fallbackStrategy?: RoutingOption;
 }
+/**
+ * Helper function to construct a routing strategy
+ * @param strategy - The routing strategy to use
+ * @param config
+ * @returns
+ */
+export declare const useRoutingStrategy: (strategy: RoutingOption, config?: any) => RoutingStrategy;
+/**
+ * Helper function to construct a verification strategy
+ * @param strategy - The verification strategy to use
+ * @param config - The configuration to use
+ * @returns
+ */
+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
  */
 export declare function createWayfinderClient(options?: CreateWayfinderClientOptions): Wayfinder;
 export declare const createWayfinder: typeof createWayfinderClient;
-export declare const createWayfinderSync: typeof createWayfinderClientSync;
 //# 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;AAS7C,OAAO,KAAK,EACV,gBAAgB,EAChB,MAAM,EACN,eAAe,EACf,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;AAE/E,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE9E,MAAM,MAAM,gBAAgB,GACxB,oBAAoB,GACpB,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,CAAC;AAErB;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,4BAAiC,GACzC,SAAS,CAoLX;AAED,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;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC;;OAEG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAElC;;OAEG;IACH,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,4BAAiC,GACzC,SAAS,CAmLX;AAGD,eAAO,MAAM,eAAe,8BAAwB,CAAC;AACrD,eAAO,MAAM,mBAAmB,kCAA4B,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,EAGf,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;CAClC;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,CAkHX;AAED,eAAO,MAAM,eAAe,8BAAwB,CAAC"}

package/dist/client.js

@@ -21,179 +21,65 @@ import { StaticGatewaysProvider } from './gateways/static.js';
 import { FastestPingRoutingStrategy } from './routing/ping.js';
 import { PreferredWithFallbackRoutingStrategy } from './routing/preferred-with-fallback.js';
 import { RandomRoutingStrategy } from './routing/random.js';
+import { RoundRobinRoutingStrategy } from './routing/round-robin.js';
 import { SimpleCacheRoutingStrategy } from './routing/simple-cache.js';
 import { isBrowser } from './utils/browser.js';
 import { DataRootVerificationStrategy } from './verification/data-root-verification.js';
 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',
+    },
+};
 /**
- * Creates a Wayfinder client synchronously using static gateways
- * Use this when you want to avoid the AR.IO SDK dependency
+ * Helper function to construct a routing strategy
+ * @param strategy - The routing strategy to use
+ * @param config
+ * @returns
  */
-export function createWayfinderClientSync(options = {}) {
-    const { routing = 'random', verification = 'disabled', trustedGateways = [], cache = false, gatewaySelection, logger, ario, gatewaysProvider: customGatewaysProvider, routingStrategy: customRoutingStrategy, verificationStrategy: customVerificationStrategy, } = options;
-    // 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) {
-        // Use NetworkGatewaysProvider if ARIO instance is provided
-        let sortBy = 'totalDelegatedStake';
-        let sortOrder = 'desc';
-        const selection = gatewaySelection || 'highest-performing';
-        switch (selection) {
-            case 'highest-performing':
-                sortBy = 'weights.gatewayPerformanceRatio';
-                sortOrder = 'desc';
-                break;
-            case 'longest-tenure':
-                sortBy = 'weights.tenureWeight';
-                sortOrder = 'desc';
-                break;
-            case 'highest-staked':
-                sortBy = 'weights.stakeWeight';
-                sortOrder = 'desc';
-                break;
-            case 'highest-weight':
-                sortBy = 'weights.normalizedCompositeWeight';
-                sortOrder = 'desc';
-                break;
-            case 'longest-streak':
-                sortBy = 'stats.passedConsecutiveEpochs';
-                sortOrder = 'desc';
-                break;
-            default:
-                sortBy = 'weights.normalizedCompositeWeight';
-                sortOrder = 'desc';
-                break;
-        }
-        gatewaysProvider = new NetworkGatewaysProvider({
-            ario,
-            sortBy,
-            sortOrder,
-            limit: 10,
-        });
-    }
-    else {
-        // Fall back to static gateways when no ARIO instance is provided
-        gatewaysProvider = new StaticGatewaysProvider({
-            gateways: trustedGateways.length
-                ? trustedGateways
-                : [
-                    'https://permagate.io',
-                    'https://arweave.net',
-                    'https://ardrive.net',
-                ],
-        });
-    }
-    // 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 {
-        switch (routing) {
-            case 'random':
-                routingStrategy = new RandomRoutingStrategy();
-                break;
-            case 'fastest':
-                routingStrategy = new FastestPingRoutingStrategy();
-                break;
-            case 'preferred':
-                routingStrategy = new PreferredWithFallbackRoutingStrategy({
-                    preferredGateway: trustedGateways[0],
-                    fallbackStrategy: new RandomRoutingStrategy(),
-                });
-                break;
-            default:
-                throw new Error(`Unknown routing strategy: ${routing}`);
-        }
-        // Wrap with cache if enabled
-        if (cacheEnabled) {
-            // TODO: add browser cache support for routing strategy
-            routingStrategy = new SimpleCacheRoutingStrategy({
-                routingStrategy,
-                ttlSeconds: cacheTTLSeconds,
-            });
-        }
-    }
-    // Set up verification strategy
-    let verificationStrategy;
-    let verificationEnabled = true;
-    if (customVerificationStrategy) {
-        verificationStrategy = customVerificationStrategy;
-    }
-    else {
-        switch (verification) {
-            case 'hash':
-                verificationStrategy = new HashVerificationStrategy({
-                    trustedGateways: trustedGateways.map((url) => new URL(url)),
-                });
-                break;
-            case 'data-root':
-                verificationStrategy = new DataRootVerificationStrategy({
-                    trustedGateways: trustedGateways.map((url) => new URL(url)),
-                });
-                break;
-            case 'remote':
-                verificationStrategy = new RemoteVerificationStrategy();
-                break;
-            case 'disabled':
-                verificationEnabled = false;
-                verificationStrategy = undefined;
-                break;
-            default:
-                throw new Error(`Unknown verification strategy: ${verification}`);
-        }
-    }
-    // Create Wayfinder options
-    const wayfinderOptions = {
-        logger,
-        gatewaysProvider,
-        routingSettings: {
-            strategy: routingStrategy,
-        },
+export const useRoutingStrategy = (strategy, config) => {
+    const routingMap = {
+        random: new RandomRoutingStrategy(config),
+        fastest: new FastestPingRoutingStrategy(config),
+        preferred: new PreferredWithFallbackRoutingStrategy(config),
+        'round-robin': new RoundRobinRoutingStrategy(config),
     };
-    // Only add verification settings if not disabled
-    if (verificationEnabled && verificationStrategy) {
-        wayfinderOptions.verificationSettings = {
-            enabled: true,
-            strategy: verificationStrategy,
-        };
-    }
-    else {
-        wayfinderOptions.verificationSettings = {
-            enabled: false,
-        };
-    }
-    return new Wayfinder(wayfinderOptions);
-}
+    return routingMap[strategy];
+};
+/**
+ * Helper function to construct a verification strategy
+ * @param strategy - The verification strategy to use
+ * @param config - The configuration to use
+ * @returns
+ */
+export const useVerificationStrategy = (strategy, config) => {
+    const verificationMap = {
+        hash: new HashVerificationStrategy(config),
+        'data-root': new DataRootVerificationStrategy(config),
+        remote: new RemoteVerificationStrategy(),
+        disabled: undefined,
+    };
+    return verificationMap[strategy];
+};
 /**
  * Creates a Wayfinder client with the specified configuration
  * Uses static gateways by default. Provide an `ario` instance to use NetworkGatewaysProvider
  */
 export function createWayfinderClient(options = {}) {
-    const { routing = 'random', verification = 'disabled', trustedGateways = [], cache = false, gatewaySelection, logger, ario, gatewaysProvider: customGatewaysProvider, routingStrategy: customRoutingStrategy, verificationStrategy: customVerificationStrategy, } = options;
+    const { routing = 'random', verification = 'disabled', trustedGateways = ['https://permagate.io'], cache = false, gatewaySelection = 'top-ranked', logger, ario, gatewaysProvider: customGatewaysProvider, routingStrategy: customRoutingStrategy, verificationStrategy: customVerificationStrategy, preferredGateway = 'arweave.net', fallbackStrategy = 'random', } = options;
     // Parse cache configuration
     const cacheEnabled = !!cache;
     const cacheTTLSeconds = typeof cache === 'object' ? cache.ttlSeconds : 300; // 5 minutes default
@@ -203,35 +89,7 @@ export function createWayfinderClient(options = {}) {
         gatewaysProvider = customGatewaysProvider;
     }
     else if (ario) {
-        // Use NetworkGatewaysProvider with dynamically imported ARIO
-        let sortBy = 'totalDelegatedStake';
-        let sortOrder = 'desc';
-        switch (gatewaySelection) {
-            case 'highest-performing':
-                sortBy = 'weights.gatewayPerformanceRatio';
-                sortOrder = 'desc';
-                break;
-            case 'longest-tenure':
-                sortBy = 'weights.tenureWeight';
-                sortOrder = 'desc';
-                break;
-            case 'highest-staked':
-                sortBy = 'weights.stakeWeight';
-                sortOrder = 'desc';
-                break;
-            case 'highest-weight':
-                sortBy = 'weights.normalizedCompositeWeight';
-                sortOrder = 'desc';
-                break;
-            case 'longest-streak':
-                sortBy = 'stats.passedConsecutiveEpochs';
-                sortOrder = 'desc';
-                break;
-            default:
-                sortBy = 'weights.normalizedCompositeWeight';
-                sortOrder = 'desc';
-                break;
-        }
+        const { sortBy, sortOrder } = selectionSortMap[gatewaySelection];
         gatewaysProvider = new NetworkGatewaysProvider({
             ario,
             sortBy,
@@ -272,22 +130,10 @@ export function createWayfinderClient(options = {}) {
         routingStrategy = customRoutingStrategy;
     }
     else {
-        switch (routing) {
-            case 'random':
-                routingStrategy = new RandomRoutingStrategy();
-                break;
-            case 'fastest':
-                routingStrategy = new FastestPingRoutingStrategy();
-                break;
-            case 'preferred':
-                routingStrategy = new PreferredWithFallbackRoutingStrategy({
-                    preferredGateway: trustedGateways[0],
-                    fallbackStrategy: new RandomRoutingStrategy(),
-                });
-                break;
-            default:
-                throw new Error(`Unknown routing strategy: ${routing}`);
-        }
+        routingStrategy = useRoutingStrategy(routing, {
+            preferredGateway,
+            fallbackStrategy,
+        });
         // Wrap with cache if enabled
         if (cacheEnabled) {
             // TODO: add browser cache support for routing strategy
@@ -299,32 +145,14 @@ export function createWayfinderClient(options = {}) {
     }
     // Set up verification strategy
     let verificationStrategy;
-    let verificationEnabled = true;
+    const verificationEnabled = true;
     if (customVerificationStrategy) {
         verificationStrategy = customVerificationStrategy;
     }
     else {
-        switch (verification) {
-            case 'hash':
-                verificationStrategy = new HashVerificationStrategy({
-                    trustedGateways: trustedGateways.map((url) => new URL(url)),
-                });
-                break;
-            case 'data-root':
-                verificationStrategy = new DataRootVerificationStrategy({
-                    trustedGateways: trustedGateways.map((url) => new URL(url)),
-                });
-                break;
-            case 'remote':
-                verificationStrategy = new RemoteVerificationStrategy();
-                break;
-            case 'disabled':
-                verificationEnabled = false;
-                verificationStrategy = undefined;
-                break;
-            default:
-                throw new Error(`Unknown verification strategy: ${verification}`);
-        }
+        verificationStrategy = useVerificationStrategy(verification, {
+            trustedGateways: trustedGateways.map((url) => new URL(url)),
+        });
     }
     // Create Wayfinder options
     const wayfinderOptions = {
@@ -348,6 +176,4 @@ export function createWayfinderClient(options = {}) {
     }
     return new Wayfinder(wayfinderOptions);
 }
-// Re-export as aliases
 export const createWayfinder = createWayfinderClient;
-export const createWayfinderSync = createWayfinderClientSync;

package/dist/gateways/local-storage-cache.d.ts

@@ -23,10 +23,11 @@ export declare class LocalStorageGatewaysProvider implements GatewaysProvider {
     private readonly ttlSeconds;
     private readonly logger;
     private gatewaysPromise;
-    constructor({ ttlSeconds, gatewaysProvider, logger, }: {
+    constructor({ ttlSeconds, gatewaysProvider, logger, cacheKey, }: {
         ttlSeconds?: number;
         gatewaysProvider: GatewaysProvider;
         logger?: Logger;
+        cacheKey?: string;
     });
     getGateways(): Promise<URL[]>;
     private getCachedGateways;

package/dist/gateways/local-storage-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-storage-cache.d.ts","sourceRoot":"","sources":["../../src/gateways/local-storage-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AA+B1C,qBAAa,4BAA6B,YAAW,gBAAgB;IACnE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IACzD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,eAAe,CAA6B;gBAExC,EACV,UAAU,EACV,gBAAgB,EAChB,MAAsB,GACvB,EAAE;QACD,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,gBAAgB,CAAC;QACnC,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAYK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAwCnC,OAAO,CAAC,iBAAiB;IAkBzB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,aAAa;IAuBrB,UAAU,IAAI,IAAI;CAWnB"}
+{"version":3,"file":"local-storage-cache.d.ts","sourceRoot":"","sources":["../../src/gateways/local-storage-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAmC1C,qBAAa,4BAA6B,YAAW,gBAAgB;IACnE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,eAAe,CAA6B;gBAExC,EACV,UAAU,EACV,gBAAgB,EAChB,MAAsB,EACtB,QAAqB,GACtB,EAAE;QACD,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,gBAAgB,CAAC;QACnC,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;IAaK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAyCnC,OAAO,CAAC,iBAAiB;IAkBzB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,aAAa;IAuBrB,UAAU,IAAI,IAAI;CAWnB"}

package/dist/gateways/local-storage-cache.js

@@ -1,16 +1,17 @@
 import { defaultLogger } from '../logger.js';
 import { isBrowser } from '../utils/browser.js';
 export class LocalStorageGatewaysProvider {
-    storageKey = 'wayfinder-gateways-cache';
+    storageKey;
     defaultTtlSeconds = 3600; // 1 hour default
     gatewaysProvider;
     ttlSeconds;
     logger;
     gatewaysPromise;
-    constructor({ ttlSeconds, gatewaysProvider, logger = defaultLogger, }) {
+    constructor({ ttlSeconds, gatewaysProvider, logger = defaultLogger, cacheKey = 'gateways', }) {
         if (!isBrowser()) {
             throw new Error('LocalStorageGatewaysProvider is only available in browser environments. Consider using SimpleCacheGatewaysProvider for node.js environments.');
         }
+        this.storageKey = `wayfinder|${cacheKey}`;
         this.ttlSeconds = ttlSeconds ?? this.defaultTtlSeconds;
         this.gatewaysProvider = gatewaysProvider;
         this.logger = logger;
@@ -19,6 +20,7 @@ export class LocalStorageGatewaysProvider {
         const cached = this.getCachedGateways();
         if (cached && this.isCacheValid(cached)) {
             this.logger?.debug('Using cached gateways', {
+                storageKey: this.storageKey,
                 ttlSeconds: this.ttlSeconds,
                 timestamp: cached.timestamp,
                 expiresAt: cached.expiresAt,

package/dist/gateways/network.d.ts

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 import type { AoARIORead } from '@ar.io/sdk';
-import type { GatewaysProvider, Logger } from '../types.js';
+import type { GatewaysProvider, Logger, SortBy, SortOrder } from '../types.js';
 export declare class NetworkGatewaysProvider implements GatewaysProvider {
     private ario;
     private sortBy;
@@ -25,8 +25,8 @@ export declare class NetworkGatewaysProvider implements GatewaysProvider {
     private logger;
     constructor({ ario, sortBy, sortOrder, limit, filter, logger, }: {
         ario: AoARIORead;
-        sortBy?: 'totalDelegatedStake' | 'operatorStake' | 'startTimestamp' | 'weights.gatewayPerformanceRatio' | 'weights.tenureWeight' | 'weights.stakeWeight' | 'weights.compositeWeight' | 'stats.passedConsecutiveEpochs' | 'weights.normalizedCompositeWeight';
-        sortOrder?: 'asc' | 'desc';
+        sortBy?: SortBy;
+        sortOrder?: SortOrder;
         limit?: number;
         blocklist?: string[];
         filter?: (gateway: any) => boolean;

package/dist/gateways/network.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/gateways/network.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE5D,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAS0B;IACxC,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,MAAM,CAAS;gBAEX,EACV,IAAI,EACJ,MAAwB,EACxB,SAAkB,EAClB,KAAY,EACZ,MAAqC,EACrC,MAAsB,GACvB,EAAE;QACD,IAAI,EAAE,UAAU,CAAC;QACjB,MAAM,CAAC,EACH,qBAAqB,GACrB,eAAe,GACf,gBAAgB,GAChB,iCAAiC,GACjC,sBAAsB,GACtB,qBAAqB,GACrB,yBAAyB,GACzB,+BAA+B,GAC/B,mCAAmC,CAAC;QACxC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;QAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC;QACnC,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IASK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;CA2DpC"}
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/gateways/network.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE/E,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,MAAM,CAAS;gBAEX,EACV,IAAI,EACJ,MAAwB,EACxB,SAAkB,EAClB,KAAY,EACZ,MAAqC,EACrC,MAAsB,GACvB,EAAE;QACD,IAAI,EAAE,UAAU,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC;QACnC,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IASK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;CA2DpC"}

package/dist/gateways/static.d.ts

@@ -16,7 +16,7 @@
  */
 import type { GatewaysProvider } from '../types.js';
 export declare class StaticGatewaysProvider implements GatewaysProvider {
-    private gateways;
+    readonly gateways: URL[];
     constructor({ gateways }: {
         gateways: string[];
     });

package/dist/gateways/static.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../../src/gateways/static.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,qBAAa,sBAAuB,YAAW,gBAAgB;IAC7D,OAAO,CAAC,QAAQ,CAAQ;gBACZ,EAAE,QAAQ,EAAE,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE;IAI1C,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;CAGpC"}
+{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../../src/gateways/static.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,qBAAa,sBAAuB,YAAW,gBAAgB;IAC7D,SAAgB,QAAQ,EAAE,GAAG,EAAE,CAAC;gBACpB,EAAE,QAAQ,EAAE,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE;IAI1C,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;CAGpC"}

package/dist/routing/preferred-with-fallback.d.ts

@@ -17,8 +17,8 @@
 import type { Logger, RoutingStrategy } from '../types.js';
 export declare class PreferredWithFallbackRoutingStrategy implements RoutingStrategy {
     readonly name = "preferred-with-fallback";
-    private preferredGateway;
-    private fallbackStrategy;
+    readonly preferredGateway: URL;
+    readonly fallbackStrategy: RoutingStrategy;
     private logger;
     constructor({ preferredGateway, fallbackStrategy, logger, }: {
         preferredGateway: string;

package/dist/routing/preferred-with-fallback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preferred-with-fallback.d.ts","sourceRoot":"","sources":["../../src/routing/preferred-with-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG3D,qBAAa,oCAAqC,YAAW,eAAe;IAC1E,SAAgB,IAAI,6BAA6B;IACjD,OAAO,CAAC,gBAAgB,CAAM;IAC9B,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,MAAM,CAAS;gBAEX,EACV,gBAAgB,EAChB,gBAAmD,EACnD,MAAsB,GACvB,EAAE;QACD,gBAAgB,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,eAAe,CAAC;QACnC,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAMK,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;CA6CjB"}
+{"version":3,"file":"preferred-with-fallback.d.ts","sourceRoot":"","sources":["../../src/routing/preferred-with-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG3D,qBAAa,oCAAqC,YAAW,eAAe;IAC1E,SAAgB,IAAI,6BAA6B;IACjD,SAAgB,gBAAgB,EAAE,GAAG,CAAC;IACtC,SAAgB,gBAAgB,EAAE,eAAe,CAAC;IAClD,OAAO,CAAC,MAAM,CAAS;gBAEX,EACV,gBAAgB,EAChB,gBAAmD,EACnD,MAAsB,GACvB,EAAE;QACD,gBAAgB,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,eAAe,CAAC;QACnC,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAMK,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;CA6CjB"}

package/dist/types.d.ts

@@ -48,6 +48,11 @@ export type WayfinderEvent = {
         totalBytes: number;
     };
 };
+export type RoutingOption = 'random' | 'fastest' | 'round-robin' | 'preferred';
+export type VerificationOption = 'hash' | 'data-root' | 'remote' | 'disabled';
+export type GatewaySelection = 'best-performance' | 'most-tenured' | 'highest-staked' | 'top-ranked' | 'longest-streak';
+export type SortBy = 'totalDelegatedStake' | 'operatorStake' | 'startTimestamp' | 'weights.gatewayPerformanceRatio' | 'weights.tenureWeight' | 'weights.stakeWeight' | 'weights.compositeWeight' | 'stats.passedConsecutiveEpochs' | 'weights.normalizedCompositeWeight';
+export type SortOrder = 'asc' | 'desc';
 /**
  * Simple logger interface that Wayfinder will use
  * This allows users to provide their own logger implementation
@@ -112,7 +117,7 @@ export interface WayfinderOptions {
         /**
          * The verification strategy to use for verifying data
          */
-        strategy?: VerificationStrategy;
+        strategy?: VerificationStrategy | undefined;
         /**
          * Whether verification should be strict (blocking)
          * If true, verification failures will cause requests to fail

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.4.0-alpha.0";
+export declare const WAYFINDER_CORE_VERSION = "v1.4.0-alpha.2";
 //# 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.4.0-alpha.0';
+export const WAYFINDER_CORE_VERSION = 'v1.4.0-alpha.2';

package/dist/wayfinder.d.ts

@@ -111,7 +111,9 @@ export declare class Wayfinder {
     /**
      * The verification settings to use when verifying data.
      */
-    readonly verificationSettings: Required<NonNullable<WayfinderOptions['verificationSettings']>>;
+    readonly verificationSettings: Required<Omit<NonNullable<WayfinderOptions['verificationSettings']>, 'strategy'>> & {
+        strategy: VerificationStrategy | undefined;
+    };
     /**
      * Telemetry configuration used for OpenTelemetry tracing
      */
@@ -248,8 +250,9 @@ export declare class Wayfinder {
      * wayfinder.enableVerification();
      * @param strict - Whether to make verification strict
      */
-    enableVerification({ strict, }?: {
+    enableVerification({ strict, strategy, }?: {
         strict?: boolean;
+        strategy?: VerificationStrategy;
     }): void;
     /**
      * A wrapped fetch function that supports ar:// protocol. If a verification strategy is provided,

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

@@ -537,9 +537,11 @@ export class Wayfinder {
                 verificationSettings?.strategy !== undefined,
             events: {},
             strict: false,
-            strategy: new HashVerificationStrategy({
-                trustedGateways: [new URL('https://permagate.io')],
-            }),
+            strategy: (verificationSettings?.strategy ?? verificationSettings?.enabled)
+                ? new HashVerificationStrategy({
+                    trustedGateways: [new URL('https://permagate.io')],
+                })
+                : undefined,
             // overwrite the default settings with the provided ones
             ...verificationSettings,
         };
@@ -650,9 +652,15 @@ export class Wayfinder {
      * wayfinder.enableVerification();
      * @param strict - Whether to make verification strict
      */
-    enableVerification({ strict = false, } = {}) {
+    enableVerification({ strict = false, strategy, } = {}) {
         this.verificationSettings.enabled = true;
         this.verificationSettings.strict = strict;
+        this.verificationSettings.strategy =
+            strategy ??
+                this.verificationSettings.strategy ??
+                new HashVerificationStrategy({
+                    trustedGateways: [new URL('https://permagate.io')],
+                });
     }
     /**
      * A wrapped fetch function that supports ar:// protocol. If a verification strategy is provided,

package/package.json

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