@ar.io/wayfinder-core 0.0.2 → 0.0.3-alpha.1

package/README.md

@@ -174,7 +174,7 @@ Wayfinder includes verification mechanisms to ensure the integrity of retrieved
 | ------------------------------- | ---------- | ----------- | -------- | ------------------------------------------------------------------------------------------------------------ |
 | `HashVerificationStrategy`      | Low        | High        | Low      | Verifies data integrity using SHA-256 hash comparison of the returned data                                   |
 | `DataRootVerificationStrategy`  | Medium     | Medium      | Low      | Verifies data using Arweave by computing the data root for the transaction (most useful for L1 transactions) |
-| `SignatureVerificationStrategy` | Medium     | Medium      | Medium   | Verifies signature of an Arweave transaction or data item using offsets provided by trusted gateway          |
+| `SignatureVerificationStrategy` | Medium     | Medium      | Medium   | Verifies signature of an Arweave transaction or data item using signature data provided by the Arweave network, or trusted gateways|
 
 ### HashVerificationStrategy
 
@@ -204,6 +204,20 @@ const wayfinder = new Wayfinder({
 });
 ```
 
+### SignatureVerificationStrategy
+
+Verifies signatures of Arweave transactions and data items. Headers are retrieved from trusted gateways for use during verification. For a transaction, its data root is computed while streaming its data and then utilized alongside its headers for verification. For data items, the ANS-104 deep hash method of signature verification is used.
+
+```javascript
+import { Wayfinder, SignatureVerificationStrategy } from '@ar-io/sdk';
+
+const wayfinder = new Wayfinder({
+  verificationStrategy: new SignatureVerificationStrategy({
+    trustedGateways: ['https://permagate.io'],
+  }),
+});
+```
+
 ## Monitoring and Events
 
 Wayfinder emits events during the routing and verification process, allowing you to monitor its operation.

package/dist/gateways/network.d.ts

@@ -33,6 +33,9 @@ export declare class NetworkGatewaysProvider implements GatewaysProvider {
         filter?: (gateway: any) => boolean;
         logger?: Logger;
     });
-    getGateways(): Promise<URL[]>;
+    getGateways(_params?: {
+        path?: string;
+        subdomain?: string;
+    }): Promise<URL[]>;
 }
 //# sourceMappingURL=network.d.ts.map

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,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAiB,MAAM,iBAAiB,CAAC;AAExD,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,MAAM,CAA6D;IAC3E,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,YAAY,CAAC;QACnB,MAAM,CAAC,EAAE,qBAAqB,GAAG,eAAe,GAAG,gBAAgB,CAAC;QACpE,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;CA0DpC"}
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/gateways/network.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAiB,MAAM,iBAAiB,CAAC;AAExD,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,MAAM,CAA6D;IAC3E,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,YAAY,CAAC;QACnB,MAAM,CAAC,EAAE,qBAAqB,GAAG,eAAe,GAAG,gBAAgB,CAAC;QACpE,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,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;CA0DnF"}

package/dist/gateways/network.js

@@ -14,7 +14,7 @@ export class NetworkGatewaysProvider {
         this.filter = filter;
         this.logger = logger;
     }
-    async getGateways() {
+    async getGateways(_params) {
         let cursor;
         let attempts = 0;
         const gateways = [];

package/dist/gateways/simple-cache.d.ts

@@ -45,6 +45,9 @@ export declare class SimpleCacheGatewaysProvider implements GatewaysProvider {
         ttlSeconds?: number;
         logger?: Logger;
     });
-    getGateways(): Promise<URL[]>;
+    getGateways(params?: {
+        path?: string;
+        subdomain?: string;
+    }): Promise<URL[]>;
 }
 //# sourceMappingURL=simple-cache.d.ts.map

package/dist/gateways/simple-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"simple-cache.d.ts","sourceRoot":"","sources":["../../src/gateways/simple-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,MAAM,EAAiB,MAAM,iBAAiB,CAAC;AAExD,qBAAa,2BAA4B,YAAW,gBAAgB;IAClE,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,MAAM,CAAS;gBAEX,EACV,gBAAgB,EAChB,UAAoB,EAAE,SAAS;IAC/B,MAAsB,GACvB,EAAE;QACD,gBAAgB,EAAE,gBAAgB,CAAC;QACnC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAQK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;CAmCpC"}
+{"version":3,"file":"simple-cache.d.ts","sourceRoot":"","sources":["../../src/gateways/simple-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,MAAM,EAAiB,MAAM,iBAAiB,CAAC;AAExD,qBAAa,2BAA4B,YAAW,gBAAgB;IAClE,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,MAAM,CAAS;gBAEX,EACV,gBAAgB,EAChB,UAAoB,EAAE,SAAS;IAC/B,MAAsB,GACvB,EAAE;QACD,gBAAgB,EAAE,gBAAgB,CAAC;QACnC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAQK,WAAW,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;CAmClF"}

package/dist/gateways/simple-cache.js

@@ -30,7 +30,7 @@ export class SimpleCacheGatewaysProvider {
         this.lastUpdated = 0;
         this.logger = logger;
     }
-    async getGateways() {
+    async getGateways(params) {
         const now = Date.now();
         if (this.gatewaysCache.length === 0 ||
             now - this.lastUpdated > this.ttlSeconds * 1000) {
@@ -40,7 +40,7 @@ export class SimpleCacheGatewaysProvider {
                     ttlSeconds: this.ttlSeconds,
                 });
                 // preserve the cache if the fetch fails
-                const allGateways = await this.gatewaysProvider.getGateways();
+                const allGateways = await this.gatewaysProvider.getGateways(params);
                 this.gatewaysCache = allGateways;
                 this.lastUpdated = now;
                 this.logger.debug('Updated gateways cache', {

package/dist/gateways/static.d.ts

@@ -20,6 +20,9 @@ export declare class StaticGatewaysProvider implements GatewaysProvider {
     constructor({ gateways }: {
         gateways: string[];
     });
-    getGateways(): Promise<URL[]>;
+    getGateways(_params?: {
+        path?: string;
+        subdomain?: string;
+    }): Promise<URL[]>;
 }
 //# sourceMappingURL=static.d.ts.map

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,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"}
+{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../../src/gateways/static.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;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,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;CAGnF"}

package/dist/gateways/static.js

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

package/dist/routing/ping.d.ts

@@ -2,18 +2,17 @@ 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, }?: {
+    constructor({ timeoutMs, maxConcurrency, logger, }?: {
         timeoutMs?: number;
         maxConcurrency?: number;
-        probePath?: string;
         logger?: Logger;
     });
-    selectGateway({ gateways }: {
+    selectGateway({ gateways, path, subdomain, }: {
         gateways: URL[];
+        path?: string;
+        subdomain?: string;
     }): Promise<URL>;
 }
 //# sourceMappingURL=ping.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ping.d.ts","sourceRoot":"","sources":["../../src/routing/ping.ts"],"names":[],"mappings":"AAiBA,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"}
+{"version":3,"file":"ping.d.ts","sourceRoot":"","sources":["../../src/routing/ping.ts"],"names":[],"mappings":"AAiBA,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,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAS;gBAEnB,EACV,SAAe,EACf,cAAmB,EACnB,MAAsB,GACvB,GAAE;QACD,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;KACZ;IAMA,aAAa,CAAC,EAClB,QAAQ,EACR,IAAS,EACT,SAAS,GACV,EAAE;QACD,QAAQ,EAAE,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,GAAG,CAAC;CA+DjB"}

package/dist/routing/ping.js

@@ -18,17 +18,14 @@ 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, } = {}) {
+    constructor({ timeoutMs = 500, maxConcurrency = 50, logger = defaultLogger, } = {}) {
         this.timeoutMs = timeoutMs;
-        this.probePath = probePath;
         this.logger = logger;
         this.maxConcurrency = maxConcurrency;
     }
-    async selectGateway({ gateways }) {
+    async selectGateway({ gateways, path = '', subdomain, }) {
         if (gateways.length === 0) {
             const error = new Error('No gateways provided');
             this.logger.error('Failed to select gateway', { error: error.message });
@@ -37,12 +34,16 @@ export class FastestPingRoutingStrategy {
         this.logger.debug(`Pinging ${gateways.length} gateways with timeout ${this.timeoutMs}ms`, {
             gateways: gateways.map((g) => g.toString()),
             timeoutMs: this.timeoutMs,
-            probePath: this.probePath,
+            probePath: path,
         });
         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}`;
+                const url = new URL(gateway.toString());
+                if (subdomain) {
+                    url.hostname = `${subdomain}.${url.hostname}`;
+                }
+                const pingUrl = new URL(path.replace(/^\//, ''), url).toString();
                 this.logger.debug(`Pinging gateway ${gateway.toString()}`, {
                     gateway: gateway.toString(),
                     pingUrl,
@@ -60,7 +61,7 @@ export class FastestPingRoutingStrategy {
                 throw new Error('Failed to ping gateway', {
                     cause: {
                         gateway: gateway.toString(),
-                        probePath: this.probePath,
+                        probePath: path,
                         status: response.status,
                     },
                 });

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

@@ -26,8 +26,10 @@ export declare class PreferredWithFallbackRoutingStrategy implements RoutingStra
         fallbackStrategy?: RoutingStrategy;
         logger?: Logger;
     });
-    selectGateway({ gateways }: {
+    selectGateway({ gateways, path, subdomain, }: {
         gateways: URL[];
+        path?: string;
+        subdomain?: string;
     }): Promise<URL>;
 }
 //# sourceMappingURL=preferred-with-fallback.d.ts.map

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;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"}
+{"version":3,"file":"preferred-with-fallback.d.ts","sourceRoot":"","sources":["../../src/routing/preferred-with-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;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,EAClB,QAAa,EACb,IAAS,EACT,SAAS,GACV,EAAE;QACD,QAAQ,EAAE,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,GAAG,CAAC;CA6CjB"}

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

@@ -10,13 +10,18 @@ export class PreferredWithFallbackRoutingStrategy {
         this.fallbackStrategy = fallbackStrategy;
         this.preferredGateway = new URL(preferredGateway);
     }
-    async selectGateway({ gateways = [] }) {
+    async selectGateway({ gateways = [], path = '', subdomain, }) {
         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(), {
+            const url = new URL(this.preferredGateway.toString());
+            if (subdomain) {
+                url.hostname = `${subdomain}.${url.hostname}`;
+            }
+            const probeUrl = path ? new URL(path.replace(/^\//, ''), url) : url;
+            const response = await fetch(probeUrl.toString(), {
                 method: 'HEAD',
                 signal: AbortSignal.timeout(1000),
             });
@@ -35,7 +40,11 @@ export class PreferredWithFallbackRoutingStrategy {
                 fallbackStrategy: this.fallbackStrategy.constructor.name,
             });
             // Fall back to the provided routing strategy
-            return this.fallbackStrategy.selectGateway({ gateways });
+            return this.fallbackStrategy.selectGateway({
+                gateways,
+                path,
+                subdomain,
+            });
         }
     }
 }

package/dist/routing/random.d.ts

@@ -16,8 +16,10 @@
  */
 import { RoutingStrategy } from '../../types/wayfinder.js';
 export declare class RandomRoutingStrategy implements RoutingStrategy {
-    selectGateway({ gateways }: {
+    selectGateway({ gateways, }: {
         gateways: URL[];
+        path?: string;
+        subdomain?: string;
     }): Promise<URL>;
 }
 //# sourceMappingURL=random.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/routing/random.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;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"}
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/routing/random.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG3D,qBAAa,qBAAsB,YAAW,eAAe;IACrD,aAAa,CAAC,EAClB,QAAQ,GACT,EAAE;QACD,QAAQ,EAAE,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,GAAG,CAAC;CAMjB"}

package/dist/routing/random.js

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

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

@@ -44,6 +44,8 @@ export declare class RoundRobinRoutingStrategy implements RoutingStrategy {
     });
     selectGateway({ gateways, }?: {
         gateways?: URL[];
+        path?: string;
+        subdomain?: string;
     }): Promise<URL>;
 }
 //# sourceMappingURL=round-robin.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"round-robin.d.ts","sourceRoot":"","sources":["../../src/routing/round-robin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;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"}
+{"version":3,"file":"round-robin.d.ts","sourceRoot":"","sources":["../../src/routing/round-robin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;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;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,GAAG,CAAC;CActB"}

package/dist/routing/static.d.ts

@@ -43,6 +43,8 @@ export declare class StaticRoutingStrategy implements RoutingStrategy {
     });
     selectGateway({ gateways, }?: {
         gateways?: URL[];
+        path?: string;
+        subdomain?: string;
     }): Promise<URL>;
 }
 //# sourceMappingURL=static.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../../src/routing/static.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;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"}
+{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../../src/routing/static.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;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;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,GAAG,CAAC;CAYtB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ar.io/wayfinder-core",
-  "version": "0.0.2",
+  "version": "0.0.3-alpha.1",
   "description": "WayFinder core library for intelligently routing to optimal AR.IO gateways",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -13,7 +13,11 @@
     "wayfinder",
     "ar://"
   ],
-  "author": "Permanent Data Solutions, Inc.",
+  "author": {
+    "name": "Permanent Data Solutions Inc",
+    "email": "info@ar.io",
+    "website": "https://ar.io"
+  },
   "publishConfig": {
     "access": "public"
   },
@@ -36,6 +40,7 @@
   "scripts": {
     "build": "npm run clean && tsc",
     "clean": "rimraf dist",
+    "test": "npm run test:unit",
     "test:unit": "c8 node --import=../../register.mjs --test --enable-source-maps --trace-warnings 'src/**/*.test.ts'",
     "lint:fix": "biome check --write --unsafe",
     "lint:check": "biome check --unsafe",
@@ -43,6 +48,7 @@
     "format:check": "biome format"
   },
   "dependencies": {
+    "@dha-team/arbundles": "^1.0.3",
     "arweave": "^1.14.0",
     "eventemitter3": "^5.0.1",
     "plimit-lit": "^3.0.1",