@ar.io/wayfinder-core 0.0.3-alpha.2 → 0.0.3-alpha.3

package/dist/classifiers/gql-classifier.d.ts

@@ -0,0 +1,30 @@
+/**
+ * WayFinder
+ * Copyright (C) 2022-2025 Permanent Data Solutions, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { DataClassifier } from '../../types/wayfinder.js';
+import { Logger } from '../wayfinder.js';
+export declare class GqlClassifier implements DataClassifier {
+    private readonly gqlEndpoint;
+    private readonly logger;
+    constructor({ gqlEndpoint, logger, }?: {
+        gqlEndpoint?: string;
+        logger?: Logger;
+    });
+    classify({ txId, }: {
+        txId: string;
+    }): Promise<'ans104' | 'transaction'>;
+}
+//# sourceMappingURL=gql-classifier.d.ts.map

package/dist/classifiers/gql-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gql-classifier.d.ts","sourceRoot":"","sources":["../../src/classifiers/gql-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAiB,MAAM,iBAAiB,CAAC;AAExD,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAM;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,EACV,WAA0D,EAC1D,MAAsB,GACvB,GAAE;QACD,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;KACZ;IAKA,QAAQ,CAAC,EACb,IAAI,GACL,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,GAAG,aAAa,CAAC;CAuCxD"}

package/dist/classifiers/gql-classifier.js

@@ -0,0 +1,45 @@
+import { defaultLogger } from '../wayfinder.js';
+export class GqlClassifier {
+    gqlEndpoint;
+    logger;
+    constructor({ gqlEndpoint = 'https://arweave-search.goldsky.com/graphql', logger = defaultLogger, } = {}) {
+        this.gqlEndpoint = new URL(gqlEndpoint);
+        this.logger = logger;
+    }
+    async classify({ txId, }) {
+        const response = await fetch(this.gqlEndpoint.toString(), {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                query: `
+            query GetTransaction($id: ID!) {
+              transactions(ids: [$id]) {
+                edges {
+                  node {
+                    bundledIn {
+                      id
+                    }
+                  }
+                }
+              }
+            }
+          `,
+                variables: {
+                    id: txId,
+                },
+            }),
+        });
+        if (!response.ok) {
+            this.logger.debug('Failed to fetch transaction from GraphQL', {
+                txId,
+                status: response.status,
+            });
+            return 'transaction';
+        }
+        const result = await response.json();
+        const bundledIn = result.data?.transaction?.bundledIn;
+        return bundledIn ? 'ans104' : 'transaction';
+    }
+}

package/dist/gateways/network.d.ts

@@ -33,9 +33,6 @@ export declare class NetworkGatewaysProvider implements GatewaysProvider {
         filter?: (gateway: any) => boolean;
         logger?: Logger;
     });
-    getGateways(_params?: {
-        path?: string;
-        subdomain?: string;
-    }): Promise<URL[]>;
+    getGateways(): 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,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;CA0DnF"}
+{"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"}

package/dist/gateways/network.js

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

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,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;CAmClF"}
+{"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,CACxE,GAAG,EAAE,CACN;CAmCF"}

package/dist/gateways/static.d.ts

@@ -20,9 +20,6 @@ export declare class StaticGatewaysProvider implements GatewaysProvider {
     constructor({ gateways }: {
         gateways: string[];
     });
-    getGateways(_params?: {
-        path?: string;
-        subdomain?: string;
-    }): Promise<URL[]>;
+    getGateways(): 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,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;CAGnF"}
+{"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"}

package/dist/gateways/static.js

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

package/dist/index.d.ts

@@ -25,4 +25,5 @@ export * from './gateways/simple-cache.js';
 export * from './gateways/static.js';
 export * from './verification/data-root-verifier.js';
 export * from './verification/hash-verifier.js';
+export * from './verification/signature-verifier.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;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;AAChD,cAAc,sCAAsC,CAAC"}

package/dist/index.js

@@ -28,4 +28,4 @@ export * from './gateways/static.js';
 // verification strategies
 export * from './verification/data-root-verifier.js';
 export * from './verification/hash-verifier.js';
-// TODO: signature verification
+export * from './verification/signature-verifier.js';

package/dist/routing/ping.js

@@ -61,7 +61,7 @@ export class FastestPingRoutingStrategy {
                 throw new Error('Failed to ping gateway', {
                     cause: {
                         gateway: gateway.toString(),
-                        probePath: path,
+                        path: path,
                         status: response.status,
                     },
                 });

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

@@ -1 +1 @@
-{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,MAAM,EAAiB,MAAM,iBAAiB,CAAC;AAGxD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,OAAO,GACX,GAAG,IAAI,aAAa,CAAC,UAAU,CAAC,CAQlC;AAED,wBAAuB,6BAA6B,CAClD,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GACjC,aAAa,CAAC,UAAU,CAAC,CAa3B;AAED,wBAAsB,sBAAsB,CAAC,EAC3C,MAAM,EACN,SAAqB,EACrB,MAAsB,GACvB,EAAE;IACD,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA2C9B"}
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,MAAM,EAAiB,MAAM,iBAAiB,CAAC;AAGxD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,OAAO,GACX,GAAG,IAAI,aAAa,CAAC,UAAU,CAAC,CAQlC;AAED,wBAAuB,6BAA6B,CAClD,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GACjC,aAAa,CAAC,UAAU,CAAC,CAa3B;AAED,wBAAsB,sBAAsB,CAAC,EAC3C,MAAM,EACN,SAAoB,EACpB,MAAsB,GACvB,EAAE;IACD,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA2C9B"}

package/dist/utils/hash.js

@@ -39,7 +39,7 @@ export async function* readableStreamToAsyncIterable(stream) {
         reader.releaseLock();
     }
 }
-export async function hashDataStreamToB64Url({ stream, algorithm = 'SHA-256', logger = defaultLogger, }) {
+export async function hashDataStreamToB64Url({ stream, algorithm = 'sha256', logger = defaultLogger, }) {
     try {
         logger.debug('Starting to hash data stream', {
             algorithm,

package/dist/verification/data-root-verifier.d.ts

@@ -1,4 +1,4 @@
-import { DataStream, VerificationStrategy } from '../../types/wayfinder.js';
+import { DataClassifier, DataStream, VerificationStrategy } from '../../types/wayfinder.js';
 import { Logger } from '../wayfinder.js';
 export declare const convertDataStreamToDataRoot: ({ stream, }: {
     stream: DataStream;
@@ -7,10 +7,12 @@ export declare class DataRootVerificationStrategy implements VerificationStrateg
     private readonly trustedGateways;
     private readonly maxConcurrency;
     private readonly logger;
-    constructor({ trustedGateways, maxConcurrency, logger, }: {
+    private readonly classifier;
+    constructor({ trustedGateways, maxConcurrency, logger, classifier, }: {
         trustedGateways: URL[];
         maxConcurrency?: number;
         logger?: Logger;
+        classifier?: DataClassifier;
     });
     /**
      * Get the data root for a given txId from all trusted gateways and ensure they all match.

package/dist/verification/data-root-verifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-root-verifier.d.ts","sourceRoot":"","sources":["../../src/verification/data-root-verifier.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAM5E,OAAO,EAAE,MAAM,EAAiB,MAAM,iBAAiB,CAAC;AAExD,eAAO,MAAM,2BAA2B,GAAU,aAE/C;IACD,MAAM,EAAE,UAAU,CAAC;CACpB,KAAG,OAAO,CAAC,MAAM,CAwDjB,CAAC;AAEF,qBAAa,4BAA6B,YAAW,oBAAoB;IACvE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBACpB,EACV,eAAe,EACf,cAAkB,EAClB,MAAsB,GACvB,EAAE;QACD,eAAe,EAAE,GAAG,EAAE,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAMD;;;;OAIG;IACG,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAuCxD,UAAU,CAAC,EACf,IAAI,EACJ,IAAI,GACL,EAAE;QACD,IAAI,EAAE,UAAU,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,IAAI,CAAC;CAelB"}
+{"version":3,"file":"data-root-verifier.d.ts","sourceRoot":"","sources":["../../src/verification/data-root-verifier.ts"],"names":[],"mappings":"AA0BA,OAAO,EACL,cAAc,EACd,UAAU,EACV,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAOlC,OAAO,EAAE,MAAM,EAAiB,MAAM,iBAAiB,CAAC;AAExD,eAAO,MAAM,2BAA2B,GAAU,aAE/C;IACD,MAAM,EAAE,UAAU,CAAC;CACpB,KAAG,OAAO,CAAC,MAAM,CAwDjB,CAAC;AAGF,qBAAa,4BAA6B,YAAW,oBAAoB;IACvE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;gBAChC,EACV,eAAe,EACf,cAAkB,EAClB,MAAsB,EACtB,UAA0C,GAC3C,EAAE;QACD,eAAe,EAAE,GAAG,EAAE,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,cAAc,CAAC;KAC7B;IAOD;;;;OAIG;IACG,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAuCxD,UAAU,CAAC,EACf,IAAI,EACJ,IAAI,GACL,EAAE;QACD,IAAI,EAAE,UAAU,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,IAAI,CAAC;CA0BlB"}

package/dist/verification/data-root-verifier.js

@@ -17,6 +17,7 @@
 import Arweave from 'arweave';
 import { MAX_CHUNK_SIZE, MIN_CHUNK_SIZE, buildLayers, generateLeaves, } from 'arweave/node/lib/merkle.js';
 import { pLimit } from 'plimit-lit';
+import { GqlClassifier } from '../classifiers/gql-classifier.js';
 import { toB64Url } from '../utils/base64.js';
 import { isAsyncIterable, readableStreamToAsyncIterable, } from '../utils/hash.js';
 import { defaultLogger } from '../wayfinder.js';
@@ -64,14 +65,17 @@ export const convertDataStreamToDataRoot = async ({ stream, }) => {
     const root = await buildLayers(leaves);
     return toB64Url(new Uint8Array(root.id));
 };
+// TODO: this is a TransactionDataRootVerificationStrategy, we will hold of on implementing Ans104DataRootVerificationStrategy for now
 export class DataRootVerificationStrategy {
     trustedGateways;
     maxConcurrency;
     logger;
-    constructor({ trustedGateways, maxConcurrency = 1, logger = defaultLogger, }) {
+    classifier;
+    constructor({ trustedGateways, maxConcurrency = 1, logger = defaultLogger, classifier = new GqlClassifier({ logger }), }) {
         this.trustedGateways = trustedGateways;
         this.maxConcurrency = maxConcurrency;
         this.logger = logger;
+        this.classifier = classifier;
     }
     /**
      * Get the data root for a given txId from all trusted gateways and ensure they all match.
@@ -111,6 +115,13 @@ export class DataRootVerificationStrategy {
         return dataRoot;
     }
     async verifyData({ data, txId, }) {
+        // classify the data, if ans104 throw an error
+        const dataType = await this.classifier.classify({ txId });
+        if (dataType === 'ans104') {
+            throw new Error('ANS-104 data is not supported for data root verification', {
+                cause: { txId },
+            });
+        }
         const [computedDataRoot, trustedDataRoot] = await Promise.all([
             convertDataStreamToDataRoot({
                 stream: data,

package/dist/verification/signature-verifier.d.ts

@@ -0,0 +1,117 @@
+import { DataClassifier, DataStream, VerificationStrategy } from '../../types/wayfinder.js';
+import { Logger } from '../wayfinder.js';
+/**
+ * Implementation of DataVerificationStrategy that verifies data item signatures
+ * using trusted gateways to provide the metadata needed for verification.
+ */
+export declare class Ans104SignatureVerificationStrategy implements VerificationStrategy {
+    private readonly trustedGateways;
+    private readonly maxConcurrency;
+    private readonly logger;
+    constructor({ trustedGateways, maxConcurrency, logger, }: {
+        trustedGateways: URL[];
+        maxConcurrency?: number;
+        logger?: Logger;
+    });
+    /**
+     * Gets data item information from trusted gateways
+     *
+     * @param txId - The transaction ID to get information for
+     * @returns Object containing offsets and root transaction ID
+     */
+    private getDataItemAttributes;
+    /**
+     * Fetches just the bytes header data of a data item from a trusted gateway needed for signature verification.
+     *
+     * @param txId - The transaction ID to get signature data for
+     * @returns The bytes containing the data item up to the data section
+     */
+    getSignatureData({ txId, }: {
+        txId: string;
+    }): Promise<{
+        signatureType: number;
+        signature: Uint8Array;
+        owner: Uint8Array;
+        target: Uint8Array;
+        anchor: Uint8Array;
+        tags: Uint8Array;
+    }>;
+    /**
+     * Verifies the signature of a data item using trusted gateways to get the signature data
+     * and then verifying it against the data payload.
+     *
+     * This implementation follows the ANS-104 standard for verifying data item signatures:
+     * 1. Get the signature data from the trusted gateway
+     * 2. Parse the signature components (owner, signature type, tags, etc.)
+     * 3. Calculate the deep hash of all components and the data
+     * 4. Verify the signature against the deep hash
+     *
+     * @param data - The data stream to verify
+     * @param txId - The transaction ID of the data
+     */
+    verifyData({ data, txId, }: {
+        data: DataStream;
+        txId: string;
+    }): Promise<void>;
+}
+/**
+ * Implementation of SignatureDataProvider that fetches signature data directly
+ * from a trusted gateway's /tx/<tx-id>/signature endpoint.
+ */
+export declare class TransactionSignatureVerificationStrategy implements VerificationStrategy {
+    private readonly trustedGateways;
+    private readonly logger;
+    constructor({ trustedGateways, logger, }: {
+        trustedGateways: URL[];
+        maxConcurrency?: number;
+        logger?: Logger;
+    });
+    /**
+     * Fetches signature data directly from a trusted gateway's /tx/<tx-id>/signature endpoint.
+     *
+     * @param txId - The transaction ID to get signature data for
+     * @returns The signature data as a Uint8Array
+     */
+    getSignatureData({ txId, }: {
+        txId: string;
+    }): Promise<{
+        format: number;
+        owner: string;
+        target: string;
+        anchor: string;
+        quantity: string;
+        reward: string;
+        dataRoot: string;
+        dataSize: number;
+        lastTx: string;
+        tags: {
+            name: string;
+            value: string;
+        }[];
+        signature: string;
+    }>;
+    verifyData({ data, txId, }: {
+        data: DataStream;
+        txId: string;
+    }): Promise<void>;
+}
+export declare const SignatureVerificationStrategies: {
+    ans104: typeof Ans104SignatureVerificationStrategy;
+    transaction: typeof TransactionSignatureVerificationStrategy;
+};
+export declare class SignatureVerificationStrategy {
+    private readonly ans104;
+    private readonly transaction;
+    private readonly classifier;
+    constructor({ trustedGateways, maxConcurrency, logger, classifier, }: {
+        trustedGateways: URL[];
+        maxConcurrency?: number;
+        logger?: Logger;
+        classifier?: DataClassifier;
+    });
+    verifyData({ data, txId, }: {
+        data: DataStream;
+        txId: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=signature-verifier.d.ts.map

package/dist/verification/signature-verifier.d.ts.map

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

package/dist/verification/signature-verifier.js

@@ -0,0 +1,362 @@
+/**
+ * WayFinder
+ * Copyright (C) 2022-2025 Permanent Data Solutions, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Arweave, DataItem, deepHash, indexToType, stringToBuffer, } from '@dha-team/arbundles';
+import { pLimit } from 'plimit-lit';
+import { GqlClassifier } from '../classifiers/gql-classifier.js';
+import { arioGatewayHeaders } from '../utils/ario.js';
+import { fromB64Url } from '../utils/base64.js';
+import { isAsyncIterable, readableStreamToAsyncIterable, } from '../utils/hash.js';
+import { defaultLogger } from '../wayfinder.js';
+import { convertDataStreamToDataRoot } from './data-root-verifier.js';
+/**
+ * Implementation of DataVerificationStrategy that verifies data item signatures
+ * using trusted gateways to provide the metadata needed for verification.
+ */
+export class Ans104SignatureVerificationStrategy {
+    trustedGateways;
+    maxConcurrency;
+    logger;
+    constructor({ trustedGateways, maxConcurrency = 1, logger = defaultLogger, }) {
+        this.trustedGateways = trustedGateways;
+        this.maxConcurrency = maxConcurrency;
+        this.logger = logger;
+    }
+    /**
+     * Gets data item information from trusted gateways
+     *
+     * @param txId - The transaction ID to get information for
+     * @returns Object containing offsets and root transaction ID
+     */
+    async getDataItemAttributes(txId) {
+        // Try each gateway until we get the information we need
+        const throttle = pLimit(this.maxConcurrency);
+        const dataItemAttributesPromises = this.trustedGateways.map(async (gateway) => {
+            return throttle(async () => {
+                // TODO: add sandbox support to the URL - useful to test against localhost with it disabled
+                // const sandbox = sandboxFromId(txId);
+                const url = `${gateway.protocol}//${gateway.hostname}:${gateway.port}/${txId}`;
+                // Make a HEAD request to get headers without fetching the full data
+                const response = await fetch(url, {
+                    method: 'HEAD',
+                    redirect: 'follow',
+                    mode: 'cors',
+                    headers: {
+                        'Cache-Control': 'no-cache',
+                    },
+                });
+                if (!response.ok) {
+                    throw new Error('Failed to fetch data item info from trusted gateway', {
+                        cause: {
+                            txId,
+                            gateway: gateway.toString(),
+                        },
+                    });
+                }
+                const dataItemOffset = response.headers.get(arioGatewayHeaders.dataItemOffset);
+                const dataItemDataOffset = response.headers.get(arioGatewayHeaders.dataItemDataOffset);
+                const rootTransactionId = response.headers.get(arioGatewayHeaders.rootTransactionId);
+                const dataItemSize = response.headers.get(arioGatewayHeaders.dataItemSize);
+                // if any are undefined, throw an error
+                if (dataItemOffset &&
+                    dataItemDataOffset &&
+                    rootTransactionId &&
+                    dataItemSize) {
+                    throttle.clearQueue();
+                    return {
+                        gateway,
+                        dataItemOffset: parseInt(dataItemOffset, 10),
+                        dataItemDataOffset: parseInt(dataItemDataOffset, 10),
+                        rootTransactionId,
+                        dataItemSize: parseInt(dataItemSize, 10),
+                    };
+                }
+                // if we get here, we didn't get the information we need from this gateway
+                throw new Error('Missing data item attributes from trusted gateway', {
+                    cause: {
+                        txId,
+                        gateway: gateway.toString(),
+                        dataItemOffset,
+                        dataItemDataOffset,
+                        rootTransactionId,
+                        dataItemSize,
+                    },
+                });
+            });
+        });
+        const { gateway, dataItemOffset, dataItemDataOffset, rootTransactionId, dataItemSize, } = await Promise.any(dataItemAttributesPromises);
+        this.logger.debug('Successfully fetched data item attributes for txId', {
+            txId,
+            dataItemOffset,
+            dataItemDataOffset,
+            rootTransactionId,
+            dataItemSize,
+            gateway: gateway.toString(),
+        });
+        return {
+            dataItemOffset,
+            dataItemDataOffset,
+            rootTransactionId,
+            dataItemSize,
+        };
+    }
+    /**
+     * Fetches just the bytes header data of a data item from a trusted gateway needed for signature verification.
+     *
+     * @param txId - The transaction ID to get signature data for
+     * @returns The bytes containing the data item up to the data section
+     */
+    async getSignatureData({ txId, }) {
+        const { rootTransactionId, dataItemOffset, dataItemDataOffset } = await this.getDataItemAttributes(txId);
+        // this byte range is the header data of the data item within it's parent transaction, containing all the header data needed for signature verification
+        const rangeStart = dataItemOffset;
+        const rangeEnd = dataItemDataOffset - 1;
+        // TODO: we are fetching data here via range request - we may not want to do this concurrently and instead shuffle gateways before iterating through each
+        for (const gateway of this.trustedGateways) {
+            try {
+                const url = `${gateway.toString()}${rootTransactionId}`;
+                const response = await fetch(url, {
+                    method: 'GET',
+                    redirect: 'follow',
+                    mode: 'cors',
+                    headers: {
+                        Range: `bytes=${rangeStart}-${rangeEnd}`,
+                        'Cache-Control': 'no-cache',
+                    },
+                });
+                if (!response.ok || response.body === null) {
+                    continue;
+                }
+                // create the data item object from just the headers, so we can get the components easily
+                // this is somewhat of a hack as we are not including the data when creating the DataItem object
+                const trustedDataItemHeaderBytes = Buffer.from(await response.arrayBuffer());
+                const dataItem = new DataItem(trustedDataItemHeaderBytes);
+                // first verify the data item id matches the txId before we do any other verification
+                const dataItemId = await dataItem.id;
+                if (dataItemId !== txId) {
+                    throw new Error('Data item ID does not match txId', {
+                        cause: { dataItemId, txId },
+                    });
+                }
+                // now get the components needed for verification from the DataItem
+                const signatureType = dataItem.signatureType;
+                const signature = dataItem.rawSignature;
+                const owner = dataItem.rawOwner;
+                const target = dataItem.rawTarget;
+                const anchor = dataItem.rawAnchor;
+                const tags = dataItem.rawTags;
+                return {
+                    signatureType,
+                    signature,
+                    owner,
+                    target,
+                    anchor,
+                    tags,
+                };
+            }
+            catch (error) {
+                this.logger.debug('Failed to fetch data item signature bytes', {
+                    error: error.message,
+                    stack: error.stack,
+                    txId,
+                });
+            }
+        }
+        throw new Error('Failed to fetch data item signature bytes', {
+            cause: { txId, rootTransactionId, dataItemOffset, dataItemDataOffset },
+        });
+    }
+    /**
+     * Verifies the signature of a data item using trusted gateways to get the signature data
+     * and then verifying it against the data payload.
+     *
+     * This implementation follows the ANS-104 standard for verifying data item signatures:
+     * 1. Get the signature data from the trusted gateway
+     * 2. Parse the signature components (owner, signature type, tags, etc.)
+     * 3. Calculate the deep hash of all components and the data
+     * 4. Verify the signature against the deep hash
+     *
+     * @param data - The data stream to verify
+     * @param txId - The transaction ID of the data
+     */
+    async verifyData({ data, txId, }) {
+        // fetch signature data from trusted gateway
+        const trustedSignatureData = await this.getSignatureData({ txId });
+        if (!DataItem.isDataItem(trustedSignatureData)) {
+            throw new Error('TxId is not a data item', {
+                cause: { txId },
+            });
+        }
+        // ensure data is in the right format for verification
+        const asyncIterable = isAsyncIterable(data)
+            ? data
+            : readableStreamToAsyncIterable(data);
+        const { signatureType, signature, owner, target, anchor, tags } = trustedSignatureData;
+        // calculate the deep hash of all components including the data stream
+        // this follows the arbundles DataItem.verify() approach but prevents loading the entire data stream into memory
+        const signatureData = await deepHash([
+            stringToBuffer('dataitem'),
+            stringToBuffer('1'),
+            stringToBuffer(`${signatureType}`),
+            new Uint8Array(owner),
+            new Uint8Array(target),
+            new Uint8Array(anchor),
+            new Uint8Array(tags),
+            asyncIterable,
+        ]);
+        const signer = indexToType[signatureType];
+        const isValid = await signer.verify(new Uint8Array(owner), signatureData, new Uint8Array(signature));
+        if (!isValid) {
+            throw new Error('Data item signature verification failed', {
+                cause: { txId },
+            });
+        }
+    }
+}
+/**
+ * Implementation of SignatureDataProvider that fetches signature data directly
+ * from a trusted gateway's /tx/<tx-id>/signature endpoint.
+ */
+export class TransactionSignatureVerificationStrategy {
+    trustedGateways;
+    logger;
+    constructor({ trustedGateways, logger = defaultLogger, }) {
+        this.trustedGateways = trustedGateways;
+        this.logger = logger;
+    }
+    /**
+     * Fetches signature data directly from a trusted gateway's /tx/<tx-id>/signature endpoint.
+     *
+     * @param txId - The transaction ID to get signature data for
+     * @returns The signature data as a Uint8Array
+     */
+    async getSignatureData({ txId, }) {
+        this.logger.debug('Getting signature data for txId', {
+            txId,
+            trustedGateways: this.trustedGateways,
+        });
+        // TODO: shuffle gateways before iterating through each and potentially allow for concurrent requests
+        for (const gateway of this.trustedGateways) {
+            try {
+                const url = `${gateway.toString()}tx/${txId}`;
+                const response = await fetch(url, {
+                    method: 'GET',
+                    redirect: 'follow',
+                    mode: 'cors',
+                    headers: {
+                        'Cache-Control': 'no-cache',
+                        'Content-Type': 'application/json',
+                    },
+                });
+                if (!response.ok) {
+                    throw new Error('Failed to fetch signature data from trusted gateway', {
+                        cause: { txId, gateway: gateway.toString() },
+                    });
+                }
+                const tx = await response.json();
+                return {
+                    format: tx.format,
+                    owner: tx.owner,
+                    target: tx.target,
+                    anchor: tx.anchor,
+                    quantity: tx.quantity,
+                    reward: tx.reward,
+                    dataRoot: tx.data_root,
+                    dataSize: tx.data_size,
+                    lastTx: tx.last_tx,
+                    tags: tx.tags,
+                    signature: tx.signature,
+                };
+            }
+            catch (error) {
+                this.logger.debug('Error fetching signature data', {
+                    error: error.message,
+                    stack: error.stack,
+                    txId,
+                    gateway: gateway.toString(),
+                });
+            }
+        }
+        throw new Error('Failed to fetch signature data from any trusted gateway', {
+            cause: { txId },
+        });
+    }
+    async verifyData({ data, txId, }) {
+        const { format, owner, target, quantity, reward, dataSize, lastTx, tags, signature, } = await this.getSignatureData({ txId });
+        const tagList = tags.map((tag) => [
+            fromB64Url(tag.name),
+            fromB64Url(tag.value),
+        ]);
+        // use the provided data stream to compute the data root for the signature data
+        const computedDataRoot = await convertDataStreamToDataRoot({
+            stream: data,
+        });
+        // compute the signature data using the computed data root and retrieved signature data
+        const signatureData = await deepHash([
+            stringToBuffer(format.toString()),
+            fromB64Url(owner),
+            fromB64Url(target),
+            stringToBuffer(quantity),
+            stringToBuffer(reward),
+            fromB64Url(lastTx),
+            tagList,
+            stringToBuffer(dataSize.toString()),
+            fromB64Url(computedDataRoot),
+        ]);
+        // verify the signature using the computed signature data and the computed signature data
+        const isValid = await Arweave.crypto.verify(owner, signatureData, fromB64Url(signature));
+        if (!isValid) {
+            throw new Error('Transaction signature verification failed', {
+                cause: { txId },
+            });
+        }
+    }
+}
+export const SignatureVerificationStrategies = {
+    ans104: Ans104SignatureVerificationStrategy,
+    transaction: TransactionSignatureVerificationStrategy,
+    // TODO: ans102
+};
+export class SignatureVerificationStrategy {
+    ans104;
+    transaction;
+    classifier;
+    constructor({ trustedGateways, maxConcurrency = 1, logger = defaultLogger, classifier = new GqlClassifier({ logger }), }) {
+        this.ans104 = new Ans104SignatureVerificationStrategy({
+            trustedGateways,
+            maxConcurrency,
+            logger,
+        });
+        this.transaction = new TransactionSignatureVerificationStrategy({
+            trustedGateways,
+            logger,
+        });
+        this.classifier = classifier;
+    }
+    async verifyData({ data, txId, }) {
+        const dataType = await this.classifier.classify({ txId });
+        switch (dataType) {
+            case 'ans104':
+                return this.ans104.verifyData({ data, txId });
+            case 'transaction':
+                return this.transaction.verifyData({ data, txId });
+            default:
+                throw new Error('Unknown data type', {
+                    cause: { dataType },
+                });
+        }
+    }
+}

package/dist/wayfinder.d.ts

@@ -109,8 +109,9 @@ export declare function sandboxFromId(id: string): string;
  * @param resolveUrl - the function to construct the redirect url for ar:// requests
  * @returns a wrapped fetch function that supports ar:// protocol and always returns Response
  */
-export declare const createWayfinderClient: ({ resolveUrl, verifyData, selectGateway, emitter, logger, strict, }: {
-    selectGateway: () => Promise<URL>;
+export declare const createWayfinderClient: ({ getGateways, resolveUrl, verifyData, selectGateway, emitter, logger, strict, }: {
+    getGateways: GatewaysProvider["getGateways"];
+    selectGateway: RoutingStrategy["selectGateway"];
     resolveUrl: (params: {
         originalUrl: string;
         selectedGateway: URL;

package/dist/wayfinder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wayfinder.d.ts","sourceRoot":"","sources":["../src/wayfinder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAK/B,KAAK,mBAAmB,GAAG,OAAO,KAAK,CAAC;AAExC;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IACjD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAChD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAChD,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;CAClD;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAK3B,CAAC;AAGF,eAAO,MAAM,SAAS,QAAuB,CAAC;AAC9C,eAAO,MAAM,SAAS,QAAwB,CAAC;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,2CAIjC;IACD,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,GAAG,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,KAAG,GAgDH,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,wBAAwB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,qBAAqB,EAAE,KAAK,CAAC;IAC7B,sBAAsB,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,uBAAuB,EAAE;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,iBAAiB,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,iBAAiB,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,mBAAmB,EAAE;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,gBAAgB,EAAE,KAAK,CAAC;IACxB,2BAA2B,EAAE;QAC3B,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;QACxB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,uBAAuB,CAAC,EAAE,CACxB,OAAO,EAAE,cAAc,CAAC,wBAAwB,CAAC,KAC9C,IAAI,CAAC;IACV,oBAAoB,CAAC,EAAE,CACrB,OAAO,EAAE,cAAc,CAAC,qBAAqB,CAAC,KAC3C,IAAI,CAAC;IACV,sBAAsB,CAAC,EAAE,CACvB,OAAO,EAAE,cAAc,CAAC,uBAAuB,CAAC,KAC7C,IAAI,CAAC;CACX;AAED,qBAAa,gBAAiB,SAAQ,YAAY,CAAC,cAAc,CAAC;gBACpD,EACV,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,GACvB,GAAE,kBAAuB;CAY3B;AAED,wBAAgB,0BAA0B,CAAC,EACzC,cAAc,EACd,aAAa,EACb,UAAU,EACV,IAAI,EACJ,OAAO,EACP,MAAc,GACf,EAAE;IACD,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,cAAc,CAiFjB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,GAAI,qEAOnC;IACD,aAAa,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;IAClC,UAAU,EAAE,CAAC,MAAM,EAAE;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,GAAG,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,KAAK,GAAG,CAAC;IACV,UAAU,CAAC,EAAE,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,MAEG,OAAO,GAAG,GAAG,WAAW,EACxB,OAAO,WAAW,KACjB,OAAO,CAAC,QAAQ,CA4IpB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,gBAAgB,EAAE,gBAAgB,CAAC;IAEnC;;;OAGG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAElC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAE5C;;OAEG;IACH,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAE5B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB;;;;;;;;;;OAUG;IACH,SAAgB,gBAAgB,EAAE,gBAAgB,CAAC;IAEnD;;;;;;;;;OASG;IACH,SAAgB,eAAe,EAAE,eAAe,CAAC;IAEjD;;;;;;;;;;;;;;OAcG;IACH,SAAgB,UAAU,EAAE,CAAC,MAAM,EAAE;QACnC,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,SAAgB,OAAO,EAAE,mBAAmB,CAAC;IAE7C;;;;;;;;;;OAUG;IACH,SAAgB,UAAU,EAAE,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAE/D;;;;OAIG;IACH,SAAgB,MAAM,EAAE,OAAO,CAAC;IAEhC;;OAEG;IACH,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,SAAgB,OAAO,EAAE,gBAAgB,CAAC;IAE1C;;;OAGG;gBACS,EACV,MAAsB,EACtB,gBAAgB,EAChB,eAGE,EACF,oBAEE,EACF,MAcC,EACD,MAAc,GACf,EAAE,gBAAgB;CAuCpB"}
+{"version":3,"file":"wayfinder.d.ts","sourceRoot":"","sources":["../src/wayfinder.ts"],"names":[],"mappings":"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"}

package/dist/wayfinder.js

@@ -185,18 +185,18 @@ export function sandboxFromId(id) {
  * @param resolveUrl - the function to construct the redirect url for ar:// requests
  * @returns a wrapped fetch function that supports ar:// protocol and always returns Response
  */
-export const createWayfinderClient = ({ resolveUrl, verifyData, selectGateway, emitter = new WayfinderEmitter(), logger = defaultLogger, strict = false, }) => {
+export const createWayfinderClient = ({ getGateways, resolveUrl, verifyData, selectGateway, emitter = new WayfinderEmitter(), logger = defaultLogger, strict = false, }) => {
     return async (input, init) => {
-        const url = input instanceof URL ? input.toString() : input.toString();
-        if (typeof url !== 'string') {
+        if (!(input instanceof URL)) {
             logger?.debug('URL is not a string, skipping routing', {
-                url,
+                input,
             });
             emitter?.emit('routing-skipped', {
-                originalUrl: JSON.stringify(url),
+                originalUrl: JSON.stringify(input),
             });
-            return fetch(url, init);
+            return fetch(input, init);
         }
+        const url = input.toString();
         emitter?.emit('routing-started', {
             originalUrl: url,
         });
@@ -205,7 +205,11 @@ export const createWayfinderClient = ({ resolveUrl, verifyData, selectGateway, e
         for (let i = 0; i < maxRetries; i++) {
             try {
                 // select the target gateway
-                const selectedGateway = await selectGateway();
+                const selectedGateway = await selectGateway({
+                    gateways: await getGateways(),
+                    path: input.pathname.split('/')[1],
+                    subdomain: input.hostname.split('.')[0],
+                });
                 logger?.debug('Selected gateway', {
                     originalUrl: url,
                     selectedGateway: selectedGateway.toString(),
@@ -477,11 +481,8 @@ export class Wayfinder {
         };
         // create a wayfinder client with the routing strategy and gateways provider
         this.request = createWayfinderClient({
-            selectGateway: async () => {
-                return this.routingStrategy.selectGateway({
-                    gateways: await this.gatewaysProvider.getGateways(),
-                });
-            },
+            getGateways: this.gatewaysProvider.getGateways.bind(this.gatewaysProvider),
+            selectGateway: this.routingStrategy.selectGateway.bind(this.routingStrategy),
             resolveUrl: resolveWayfinderUrl,
             verifyData: this.verifyData,
             emitter: this.emitter,

package/package.json

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