@ar.io/wayfinder-core 0.0.1

package/dist/gateways/simple-cache.js

@@ -0,0 +1,66 @@
+/**
+ * WayFinder
+ * Copyright (C) 2022-2025 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+import { defaultLogger } from '../wayfinder.js';
+export class SimpleCacheGatewaysProvider {
+    gatewaysProvider;
+    ttlSeconds;
+    lastUpdated;
+    gatewaysCache;
+    logger;
+    constructor({ gatewaysProvider, ttlSeconds = 60 * 60, // 1 hour
+    logger = defaultLogger, }) {
+        this.gatewaysCache = [];
+        this.gatewaysProvider = gatewaysProvider;
+        this.ttlSeconds = ttlSeconds;
+        this.lastUpdated = 0;
+        this.logger = logger;
+    }
+    async getGateways() {
+        const now = Date.now();
+        if (this.gatewaysCache.length === 0 ||
+            now - this.lastUpdated > this.ttlSeconds * 1000) {
+            try {
+                this.logger.debug('Cache expired, fetching new gateways', {
+                    cacheAge: now - this.lastUpdated,
+                    ttlSeconds: this.ttlSeconds,
+                });
+                // preserve the cache if the fetch fails
+                const allGateways = await this.gatewaysProvider.getGateways();
+                this.gatewaysCache = allGateways;
+                this.lastUpdated = now;
+                this.logger.debug('Updated gateways cache', {
+                    gatewayCount: allGateways.length,
+                });
+            }
+            catch (error) {
+                this.logger.error('Failed to fetch gateways', {
+                    error: error.message,
+                    stack: error.stack,
+                });
+            }
+        }
+        else {
+            this.logger.debug('Using cached gateways', {
+                cacheAge: now - this.lastUpdated,
+                ttlSeconds: this.ttlSeconds,
+                gatewayCount: this.gatewaysCache.length,
+            });
+        }
+        return this.gatewaysCache;
+    }
+}

package/dist/gateways/static.d.ts

@@ -0,0 +1,26 @@
+/**
+ * WayFinder
+ * Copyright (C) 2022-2025 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+import { GatewaysProvider } from '../../types/wayfinder.js';
+export declare class StaticGatewaysProvider implements GatewaysProvider {
+    private gateways;
+    constructor({ gateways }: {
+        gateways: string[];
+    });
+    getGateways(): Promise<URL[]>;
+}
+//# sourceMappingURL=static.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../../src/gateways/static.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,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"}

package/dist/gateways/static.js

@@ -0,0 +1,9 @@
+export class StaticGatewaysProvider {
+    gateways;
+    constructor({ gateways }) {
+        this.gateways = gateways.map((g) => new URL(g));
+    }
+    async getGateways() {
+        return this.gateways;
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * WayFinder
+ * Copyright (C) 2022-2025 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+export * from './wayfinder.js';
+export * from './routing/random.js';
+export * from './routing/static.js';
+export * from './routing/ping.js';
+export * from './routing/round-robin.js';
+export * from './routing/preferred-with-fallback.js';
+export * from './gateways/network.js';
+export * from './gateways/simple-cache.js';
+export * from './gateways/static.js';
+export * from './verification/data-root-verifier.js';
+export * from './verification/hash-verifier.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,cAAc,gBAAgB,CAAC;AAG/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sCAAsC,CAAC;AAGrD,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AAGrC,cAAc,sCAAsC,CAAC;AACrD,cAAc,iCAAiC,CAAC"}

package/dist/index.js

@@ -0,0 +1,32 @@
+/**
+ * WayFinder
+ * Copyright (C) 2022-2025 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+export * from './wayfinder.js';
+// routing strategies
+export * from './routing/random.js';
+export * from './routing/static.js';
+export * from './routing/ping.js';
+export * from './routing/round-robin.js';
+export * from './routing/preferred-with-fallback.js';
+// gateways providers
+export * from './gateways/network.js';
+export * from './gateways/simple-cache.js';
+export * from './gateways/static.js';
+// verification strategies
+export * from './verification/data-root-verifier.js';
+export * from './verification/hash-verifier.js';
+// TODO: signature verifier

package/dist/routing/ping.d.ts

@@ -0,0 +1,19 @@
+import { RoutingStrategy } from '../../types/wayfinder.js';
+import { Logger } from '../wayfinder.js';
+export declare class FastestPingRoutingStrategy implements RoutingStrategy {
+    private timeoutMs;
+    private probePath;
+    private logger;
+    private maxConcurrency;
+    constructor({ timeoutMs, maxConcurrency, probePath, // TODO: limit to allowed /ar-io and arweave node endpoints
+    logger, }?: {
+        timeoutMs?: number;
+        maxConcurrency?: number;
+        probePath?: string;
+        logger?: Logger;
+    });
+    selectGateway({ gateways }: {
+        gateways: URL[];
+    }): Promise<URL>;
+}
+//# sourceMappingURL=ping.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ping.d.ts","sourceRoot":"","sources":["../../src/routing/ping.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAiB,MAAM,iBAAiB,CAAC;AAExD,qBAAa,0BAA2B,YAAW,eAAe;IAChE,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAS;gBAEnB,EACV,SAAe,EACf,cAAmB,EACnB,SAAyB,EAAE,2DAA2D;IACtF,MAAsB,GACvB,GAAE;QACD,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACZ;IAOA,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE;QAAE,QAAQ,EAAE,GAAG,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;CA2DrE"}

package/dist/routing/ping.js

@@ -0,0 +1,77 @@
+/**
+ * WayFinder
+ * Copyright (C) 2022-2025 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+import { pLimit } from 'plimit-lit';
+import { defaultLogger } from '../wayfinder.js';
+export class FastestPingRoutingStrategy {
+    timeoutMs;
+    probePath;
+    logger;
+    maxConcurrency;
+    constructor({ timeoutMs = 500, maxConcurrency = 50, probePath = '/ar-io/info', // TODO: limit to allowed /ar-io and arweave node endpoints
+    logger = defaultLogger, } = {}) {
+        this.timeoutMs = timeoutMs;
+        this.probePath = probePath;
+        this.logger = logger;
+        this.maxConcurrency = maxConcurrency;
+    }
+    async selectGateway({ gateways }) {
+        if (gateways.length === 0) {
+            const error = new Error('No gateways provided');
+            this.logger.error('Failed to select gateway', { error: error.message });
+            throw error;
+        }
+        this.logger.debug(`Pinging ${gateways.length} gateways with timeout ${this.timeoutMs}ms`, {
+            gateways: gateways.map((g) => g.toString()),
+            timeoutMs: this.timeoutMs,
+            probePath: this.probePath,
+        });
+        const throttle = pLimit(Math.min(this.maxConcurrency, gateways.length));
+        const pingPromises = gateways.map(async (gateway) => {
+            return throttle(async () => {
+                const pingUrl = `${gateway.toString().replace(/\/$/, '')}${this.probePath}`;
+                this.logger.debug(`Pinging gateway ${gateway.toString()}`, {
+                    gateway: gateway.toString(),
+                    pingUrl,
+                });
+                const startTime = Date.now();
+                const response = await fetch(pingUrl, {
+                    method: 'HEAD',
+                    signal: AbortSignal.timeout(this.timeoutMs),
+                });
+                if (response.ok) {
+                    // clear the queue to prevent the next gateway from being pinged
+                    throttle.clearQueue();
+                    return { gateway, durationMs: Date.now() - startTime };
+                }
+                throw new Error('Failed to ping gateway', {
+                    cause: {
+                        gateway: gateway.toString(),
+                        probePath: this.probePath,
+                        status: response.status,
+                    },
+                });
+            });
+        });
+        const { gateway, durationMs } = await Promise.any(pingPromises);
+        this.logger.debug('Successfully selected fastest gateway', {
+            gateway: gateway.toString(),
+            durationMs,
+        });
+        return gateway;
+    }
+}

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

@@ -0,0 +1,34 @@
+/**
+ * WayFinder
+ * Copyright (C) 2022-2025 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+import { RoutingStrategy } from '../../types/wayfinder.js';
+import { Logger } from '../wayfinder.js';
+export declare class PreferredWithFallbackRoutingStrategy implements RoutingStrategy {
+    readonly name = "preferred-with-fallback";
+    private preferredGateway;
+    private fallbackStrategy;
+    private logger;
+    constructor({ preferredGateway, fallbackStrategy, logger, }: {
+        preferredGateway: string;
+        fallbackStrategy?: RoutingStrategy;
+        logger?: Logger;
+    });
+    selectGateway({ gateways }: {
+        gateways: URL[];
+    }): Promise<URL>;
+}
+//# sourceMappingURL=preferred-with-fallback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preferred-with-fallback.d.ts","sourceRoot":"","sources":["../../src/routing/preferred-with-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAiB,MAAM,iBAAiB,CAAC;AAGxD,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,EAAE,QAAa,EAAE,EAAE;QAAE,QAAQ,EAAE,GAAG,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;CAoC1E"}

package/dist/routing/preferred-with-fallback.js

@@ -0,0 +1,41 @@
+import { defaultLogger } from '../wayfinder.js';
+import { FastestPingRoutingStrategy } from './ping.js';
+export class PreferredWithFallbackRoutingStrategy {
+    name = 'preferred-with-fallback';
+    preferredGateway;
+    fallbackStrategy;
+    logger;
+    constructor({ preferredGateway, fallbackStrategy = new FastestPingRoutingStrategy(), logger = defaultLogger, }) {
+        this.logger = logger;
+        this.fallbackStrategy = fallbackStrategy;
+        this.preferredGateway = new URL(preferredGateway);
+    }
+    async selectGateway({ gateways = [] }) {
+        this.logger.debug('Attempting to connect to preferred gateway', {
+            preferredGateway: this.preferredGateway.toString(),
+        });
+        try {
+            // Check if the preferred gateway is responsive
+            const response = await fetch(this.preferredGateway.toString(), {
+                method: 'HEAD',
+                signal: AbortSignal.timeout(1000),
+            });
+            if (response.ok) {
+                this.logger.debug('Successfully connected to preferred gateway', {
+                    preferredGateway: this.preferredGateway.toString(),
+                });
+                return this.preferredGateway;
+            }
+            throw new Error(`Preferred gateway responded with status: ${response.status}`);
+        }
+        catch (error) {
+            this.logger.warn('Failed to connect to preferred gateway, falling back to alternative strategy', {
+                preferredGateway: this.preferredGateway.toString(),
+                error: error instanceof Error ? error.message : String(error),
+                fallbackStrategy: this.fallbackStrategy.constructor.name,
+            });
+            // Fall back to the provided routing strategy
+            return this.fallbackStrategy.selectGateway({ gateways });
+        }
+    }
+}

package/dist/routing/random.d.ts

@@ -0,0 +1,24 @@
+/**
+ * WayFinder
+ * Copyright (C) 2022-2025 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+import { RoutingStrategy } from '../../types/wayfinder.js';
+export declare class RandomRoutingStrategy implements RoutingStrategy {
+    selectGateway({ gateways }: {
+        gateways: URL[];
+    }): Promise<URL>;
+}
+//# sourceMappingURL=random.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/routing/random.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG3D,qBAAa,qBAAsB,YAAW,eAAe;IACrD,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE;QAAE,QAAQ,EAAE,GAAG,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;CAMrE"}

package/dist/routing/random.js

@@ -0,0 +1,9 @@
+import { randomInt } from '../utils/random.js';
+export class RandomRoutingStrategy {
+    async selectGateway({ gateways }) {
+        if (gateways.length === 0) {
+            throw new Error('No gateways available');
+        }
+        return gateways[randomInt(0, gateways.length)];
+    }
+}

package/dist/routing/round-robin.d.ts

@@ -0,0 +1,50 @@
+/**
+ * WayFinder
+ * Copyright (C) 2022-2025 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+import { RoutingStrategy } from '../../types/wayfinder.js';
+/**
+ * WayFinder
+ * Copyright (C) 2022-2025 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+import { Logger } from '../wayfinder.js';
+export declare class RoundRobinRoutingStrategy implements RoutingStrategy {
+    readonly name = "round-robin";
+    private gateways;
+    private currentIndex;
+    private logger;
+    constructor({ gateways, logger, }: {
+        gateways: URL[];
+        logger?: Logger;
+    });
+    selectGateway({ gateways, }?: {
+        gateways?: URL[];
+    }): Promise<URL>;
+}
+//# sourceMappingURL=round-robin.d.ts.map

package/dist/routing/round-robin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"round-robin.d.ts","sourceRoot":"","sources":["../../src/routing/round-robin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,MAAM,EAAiB,MAAM,iBAAiB,CAAC;AAExD,qBAAa,yBAA0B,YAAW,eAAe;IAC/D,SAAgB,IAAI,iBAAiB;IACrC,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,MAAM,CAAS;gBAEX,EACV,QAAQ,EACR,MAAsB,GACvB,EAAE;QACD,QAAQ,EAAE,GAAG,EAAE,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAOK,aAAa,CAAC,EAClB,QAAa,GACd,GAAE;QACD,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;KACb,GAAG,OAAO,CAAC,GAAG,CAAC;CActB"}

package/dist/routing/round-robin.js

@@ -0,0 +1,41 @@
+/**
+ * WayFinder
+ * Copyright (C) 2022-2025 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+import { defaultLogger } from '../wayfinder.js';
+export class RoundRobinRoutingStrategy {
+    name = 'round-robin';
+    gateways;
+    currentIndex;
+    logger;
+    constructor({ gateways, logger = defaultLogger, }) {
+        this.gateways = gateways;
+        this.currentIndex = 0;
+        this.logger = logger;
+    }
+    // provided gateways are ignored
+    async selectGateway({ gateways = [], } = {}) {
+        if (gateways.length > 0) {
+            this.logger.warn('RoundRobinRoutingStrategy does not accept provided gateways. Ignoring provided gateways...', {
+                providedGateways: gateways.length,
+                internalGateways: this.gateways,
+            });
+        }
+        const gateway = this.gateways[this.currentIndex];
+        this.currentIndex = (this.currentIndex + 1) % this.gateways.length;
+        return gateway;
+    }
+}

package/dist/routing/static.d.ts

@@ -0,0 +1,49 @@
+/**
+ * WayFinder
+ * Copyright (C) 2022-2025 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+import { RoutingStrategy } from '../../types/wayfinder.js';
+/**
+ * WayFinder
+ * Copyright (C) 2022-2025 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+import { Logger } from '../wayfinder.js';
+export declare class StaticRoutingStrategy implements RoutingStrategy {
+    readonly name = "static";
+    private gateway;
+    private logger;
+    constructor({ gateway, logger, }: {
+        gateway: string;
+        logger?: Logger;
+    });
+    selectGateway({ gateways, }?: {
+        gateways?: URL[];
+    }): Promise<URL>;
+}
+//# sourceMappingURL=static.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../../src/routing/static.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,MAAM,EAAiB,MAAM,iBAAiB,CAAC;AAExD,qBAAa,qBAAsB,YAAW,eAAe;IAC3D,SAAgB,IAAI,YAAY;IAChC,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,MAAM,CAAS;gBAEX,EACV,OAAO,EACP,MAAsB,GACvB,EAAE;QACD,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAOK,aAAa,CAAC,EAClB,QAAa,GACd,GAAE;QACD,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;KACb,GAAG,OAAO,CAAC,GAAG,CAAC;CAYtB"}

package/dist/routing/static.js

@@ -0,0 +1,37 @@
+/**
+ * WayFinder
+ * Copyright (C) 2022-2025 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+import { defaultLogger } from '../wayfinder.js';
+export class StaticRoutingStrategy {
+    name = 'static';
+    gateway;
+    logger;
+    constructor({ gateway, logger = defaultLogger, }) {
+        this.logger = logger;
+        this.gateway = new URL(gateway);
+    }
+    // provided gateways are ignored
+    async selectGateway({ gateways = [], } = {}) {
+        if (gateways.length > 0) {
+            this.logger.warn('StaticRoutingStrategy does not accept provided gateways. Ignoring provided gateways...', {
+                providedGateways: gateways.length,
+                internalGateway: this.gateway,
+            });
+        }
+        return this.gateway;
+    }
+}

package/dist/utils/ario.d.ts

@@ -0,0 +1,28 @@
+/**
+ * WayFinder
+ * Copyright (C) 2022-2025 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+export declare const arioGatewayHeaders: {
+    digest: string;
+    verified: string;
+    txId: string;
+    processId: string;
+    dataItemOffset: string;
+    dataItemDataOffset: string;
+    dataItemSize: string;
+    rootTransactionId: string;
+};
+//# sourceMappingURL=ario.d.ts.map

package/dist/utils/ario.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ario.d.ts","sourceRoot":"","sources":["../../src/utils/ario.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;CAS9B,CAAC"}

package/dist/utils/ario.js

@@ -0,0 +1,27 @@
+/**
+ * WayFinder
+ * Copyright (C) 2022-2025 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+export const arioGatewayHeaders = {
+    digest: 'x-ar-io-digest',
+    verified: 'x-ar-io-verified',
+    txId: 'x-arns-resolved-tx-id',
+    processId: 'x-arns-resolved-process-id',
+    dataItemOffset: 'x-ar-io-data-item-offset',
+    dataItemDataOffset: 'x-ar-io-data-item-data-offset',
+    dataItemSize: 'x-ar-io-data-item-size',
+    rootTransactionId: 'x-ar-io-root-transaction-id',
+};