@helia/verified-fetch-interop 0.0.0

package/LICENSE

@@ -0,0 +1,4 @@
+This project is dual licensed under MIT and Apache-2.0.
+
+MIT: https://www.opensource.org/licenses/mit
+Apache-2.0: https://www.apache.org/licenses/license-2.0

package/README.md

@@ -0,0 +1,58 @@
+<p align="center">
+  <a href="https://github.com/ipfs/helia" title="Helia">
+    <img src="https://raw.githubusercontent.com/ipfs/helia/main/assets/helia.png" alt="Helia logo" width="300" />
+  </a>
+</p>
+
+# @helia/interop
+
+[![ipfs.tech](https://img.shields.io/badge/project-IPFS-blue.svg?style=flat-square)](https://ipfs.tech)
+[![Discuss](https://img.shields.io/discourse/https/discuss.ipfs.tech/posts.svg?style=flat-square)](https://discuss.ipfs.tech)
+[![codecov](https://img.shields.io/codecov/c/github/ipfs/helia-verified-fetch.svg?style=flat-square)](https://codecov.io/gh/ipfs/helia-verified-fetch)
+[![CI](https://img.shields.io/github/actions/workflow/status/ipfs/helia-verified-fetch/js-test-and-release.yml?branch=main\&style=flat-square)](https://github.com/ipfs/helia-verified-fetch/actions/workflows/js-test-and-release.yml?query=branch%3Amain)
+
+> Interop tests for @helia/verified-fetch
+
+# About
+
+Runs interop tests between Helia and Kubo.
+
+## Example - Testing a new Kubo release
+
+```console
+$ npm i @helia/interop
+$ KUBO_BINARY=/path/to/kubo helia-interop
+```
+
+# Install
+
+```console
+$ npm i @helia/interop
+```
+
+## Browser `<script>` tag
+
+Loading this module through a script tag will make it's exports available as `HeliaInterop` in the global namespace.
+
+```html
+<script src="https://unpkg.com/@helia/interop/dist/index.min.js"></script>
+```
+
+# License
+
+Licensed under either of
+
+- Apache 2.0, ([LICENSE-APACHE](LICENSE-APACHE) / <http://www.apache.org/licenses/LICENSE-2.0>)
+- MIT ([LICENSE-MIT](LICENSE-MIT) / <http://opensource.org/licenses/MIT>)
+
+# Contribute
+
+Contributions welcome! Please check out [the issues](https://github.com/ipfs/helia-verified-fetch/issues).
+
+Also see our [contributing document](https://github.com/ipfs/community/blob/master/CONTRIBUTING_JS.md) for more information on how we work, and about contributing in general.
+
+Please be aware that all interactions related to this repo are subject to the IPFS [Code of Conduct](https://github.com/ipfs/community/blob/master/code-of-conduct.md).
+
+Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
+
+[![](https://cdn.rawgit.com/jbenet/contribute-ipfs-gif/master/img/contribute.gif)](https://github.com/ipfs/community/blob/master/CONTRIBUTING.md)

package/dist/index.min.js

@@ -0,0 +1,3 @@
+(function (root, factory) {(typeof module === 'object' && module.exports) ? module.exports = factory() : root.HeliaInterop = factory()}(typeof self !== 'undefined' ? self : this, function () {
+"use strict";var HeliaInterop=(()=>{var t=Object.defineProperty;var a=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var c=Object.prototype.hasOwnProperty;var d=(o,e,x,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let p of b(e))!c.call(o,p)&&p!==x&&t(o,p,{get:()=>e[p],enumerable:!(r=a(e,p))||r.enumerable});return o};var f=o=>d(t({},"__esModule",{value:!0}),o);var g={};return f(g);})();
+return HeliaInterop}));

package/dist/src/fixtures/create-kubo.browser.d.ts

@@ -0,0 +1,3 @@
+import { type Controller } from 'ipfsd-ctl';
+export declare function createKuboNode(): Promise<Controller>;
+//# sourceMappingURL=create-kubo.browser.d.ts.map

package/dist/src/fixtures/create-kubo.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-kubo.browser.d.ts","sourceRoot":"","sources":["../../../src/fixtures/create-kubo.browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAoB,MAAM,WAAW,CAAA;AAG7D,wBAAsB,cAAc,IAAK,OAAO,CAAC,UAAU,CAAC,CA0B3D"}

package/dist/src/fixtures/create-kubo.browser.js

@@ -0,0 +1,30 @@
+import { createController } from 'ipfsd-ctl';
+import * as kuboRpcClient from 'kubo-rpc-client';
+export async function createKuboNode() {
+    return createController({
+        kuboRpcModule: kuboRpcClient,
+        test: true,
+        endpoint: process.env.IPFSD_SERVER,
+        ipfsOptions: {
+            config: {
+                Addresses: {
+                    Swarm: [
+                        '/ip4/0.0.0.0/tcp/0',
+                        '/ip4/0.0.0.0/tcp/0/ws'
+                    ],
+                    Gateway: '/ip4/127.0.0.1/tcp/8180'
+                },
+                Gateway: {
+                    NoFetch: true,
+                    ExposeRoutingAPI: true,
+                    HTTPHeaders: {
+                        'Access-Control-Allow-Origin': ['*'],
+                        'Access-Control-Allow-Methods': ['GET', 'POST', 'PUT', 'OPTIONS']
+                    }
+                }
+            }
+        },
+        args: ['--enable-pubsub-experiment', '--enable-namesys-pubsub']
+    });
+}
+//# sourceMappingURL=create-kubo.browser.js.map

package/dist/src/fixtures/create-kubo.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-kubo.browser.js","sourceRoot":"","sources":["../../../src/fixtures/create-kubo.browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC7D,OAAO,KAAK,aAAa,MAAM,iBAAiB,CAAA;AAEhD,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,OAAO,gBAAgB,CAAC;QACtB,aAAa,EAAE,aAAa;QAC5B,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY;QAClC,WAAW,EAAE;YACX,MAAM,EAAE;gBACN,SAAS,EAAE;oBACT,KAAK,EAAE;wBACL,oBAAoB;wBACpB,uBAAuB;qBACxB;oBACD,OAAO,EAAE,yBAAyB;iBACnC;gBACD,OAAO,EAAE;oBACP,OAAO,EAAE,IAAI;oBACb,gBAAgB,EAAE,IAAI;oBACtB,WAAW,EAAE;wBACX,6BAA6B,EAAE,CAAC,GAAG,CAAC;wBACpC,8BAA8B,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC;qBAClE;iBACF;aACF;SACF;QACD,IAAI,EAAE,CAAC,4BAA4B,EAAE,yBAAyB,CAAC;KAChE,CAAC,CAAA;AACJ,CAAC"}

package/dist/src/fixtures/create-kubo.d.ts

@@ -0,0 +1,3 @@
+import { type Controller } from 'ipfsd-ctl';
+export declare function createKuboNode(): Promise<Controller>;
+//# sourceMappingURL=create-kubo.d.ts.map

package/dist/src/fixtures/create-kubo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-kubo.d.ts","sourceRoot":"","sources":["../../../src/fixtures/create-kubo.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAI7D,wBAAsB,cAAc,IAAK,OAAO,CAAC,UAAU,CAAC,CA0B3D"}

package/dist/src/fixtures/create-kubo.js

@@ -0,0 +1,32 @@
+/* eslint-disable @typescript-eslint/ban-ts-comment,@typescript-eslint/prefer-ts-expect-error */
+import { createController } from 'ipfsd-ctl';
+import { path as kuboPath } from 'kubo';
+import * as kuboRpcClient from 'kubo-rpc-client';
+export async function createKuboNode() {
+    return createController({
+        kuboRpcModule: kuboRpcClient,
+        ipfsBin: kuboPath(),
+        test: true,
+        ipfsOptions: {
+            config: {
+                Addresses: {
+                    Swarm: [
+                        '/ip4/0.0.0.0/tcp/4001',
+                        '/ip4/0.0.0.0/tcp/4002/ws'
+                    ],
+                    Gateway: '/ip4/127.0.0.1/tcp/8180'
+                },
+                Gateway: {
+                    NoFetch: true,
+                    ExposeRoutingAPI: true,
+                    HTTPHeaders: {
+                        'Access-Control-Allow-Origin': ['*'],
+                        'Access-Control-Allow-Methods': ['GET', 'POST', 'PUT', 'OPTIONS']
+                    }
+                }
+            }
+        },
+        args: ['--enable-pubsub-experiment', '--enable-namesys-pubsub']
+    });
+}
+//# sourceMappingURL=create-kubo.js.map

package/dist/src/fixtures/create-kubo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-kubo.js","sourceRoot":"","sources":["../../../src/fixtures/create-kubo.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,OAAO,EAAE,gBAAgB,EAAmB,MAAM,WAAW,CAAA;AAC7D,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,MAAM,CAAA;AACvC,OAAO,KAAK,aAAa,MAAM,iBAAiB,CAAA;AAEhD,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,OAAO,gBAAgB,CAAC;QACtB,aAAa,EAAE,aAAa;QAC5B,OAAO,EAAE,QAAQ,EAAE;QACnB,IAAI,EAAE,IAAI;QACV,WAAW,EAAE;YACX,MAAM,EAAE;gBACN,SAAS,EAAE;oBACT,KAAK,EAAE;wBACL,uBAAuB;wBACvB,0BAA0B;qBAC3B;oBACD,OAAO,EAAE,yBAAyB;iBACnC;gBACD,OAAO,EAAE;oBACP,OAAO,EAAE,IAAI;oBACb,gBAAgB,EAAE,IAAI;oBACtB,WAAW,EAAE;wBACX,6BAA6B,EAAE,CAAC,GAAG,CAAC;wBACpC,8BAA8B,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC;qBAClE;iBACF;aACF;SACF;QACD,IAAI,EAAE,CAAC,4BAA4B,EAAE,yBAAyB,CAAC;KAChE,CAAC,CAAA;AACJ,CAAC"}

package/dist/src/fixtures/load-fixture-data.d.ts

@@ -0,0 +1,3 @@
+import type { Controller } from 'ipfsd-ctl';
+export declare function loadFixtureDataCar(controller: Controller, path: string): Promise<void>;
+//# sourceMappingURL=load-fixture-data.d.ts.map

package/dist/src/fixtures/load-fixture-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-fixture-data.d.ts","sourceRoot":"","sources":["../../../src/fixtures/load-fixture-data.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C,wBAAsB,kBAAkB,CAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7F"}

package/dist/src/fixtures/load-fixture-data.js

@@ -0,0 +1,8 @@
+import loadFixture from 'aegir/fixtures';
+import drain from 'it-drain';
+export async function loadFixtureDataCar(controller, path) {
+    const fixtureData = `src/fixtures/data/${path}`;
+    const buf = loadFixture(fixtureData);
+    await drain(controller.api.dag.import([buf]));
+}
+//# sourceMappingURL=load-fixture-data.js.map

package/dist/src/fixtures/load-fixture-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-fixture-data.js","sourceRoot":"","sources":["../../../src/fixtures/load-fixture-data.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,gBAAgB,CAAA;AACxC,OAAO,KAAK,MAAM,UAAU,CAAA;AAG5B,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAE,UAAsB,EAAE,IAAY;IAC5E,MAAM,WAAW,GAAG,qBAAqB,IAAI,EAAE,CAAA;IAC/C,MAAM,GAAG,GAAG,WAAW,CAAC,WAAW,CAAC,CAAA;IACpC,MAAM,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;AAC/C,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @packageDocumentation
+ *
+ * Runs interop tests between Helia and Kubo.
+ *
+ * @example Testing a new Kubo release
+ *
+ * ```console
+ * $ npm i @helia/interop
+ * $ KUBO_BINARY=/path/to/kubo helia-interop
+ * ```
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAA"}

package/dist/src/index.js

@@ -0,0 +1,14 @@
+/**
+ * @packageDocumentation
+ *
+ * Runs interop tests between Helia and Kubo.
+ *
+ * @example Testing a new Kubo release
+ *
+ * ```console
+ * $ npm i @helia/interop
+ * $ KUBO_BINARY=/path/to/kubo helia-interop
+ * ```
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAA"}

package/dist/src/json.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=json.spec.d.ts.map

package/dist/src/json.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.spec.d.ts","sourceRoot":"","sources":["../../src/json.spec.ts"],"names":[],"mappings":""}

package/dist/src/json.spec.js

@@ -0,0 +1,43 @@
+/* eslint-env mocha */
+import { createVerifiedFetch } from '@helia/verified-fetch';
+import { expect } from 'aegir/chai';
+import { CID } from 'multiformats/cid';
+import { createKuboNode } from './fixtures/create-kubo.js';
+import { loadFixtureDataCar } from './fixtures/load-fixture-data.js';
+describe('@helia/verified-fetch - json', () => {
+    describe('unixfs - multiblock', () => {
+        let controller;
+        let verifiedFetch;
+        before(async () => {
+            controller = await createKuboNode();
+            await controller.start();
+            // As of 2024-01-18, https://cloudflare-ipfs.com/ipns/tokens.uniswap.org resolves to:
+            // root: QmQJ8fxavY54CUsxMSx9aE9Rdcmvhx8awJK2jzJp4iAqCr
+            // child1: QmNik5N4ryNwzzXYq5hCYKGcRjAf9QtigxtiJh9o8aXXbG // partial JSON
+            // child2: QmWNBJX6fZyNTLWNYBHxAHpBctCP43R2zeqV2G8uavqFZn // partial JSON
+            await loadFixtureDataCar(controller, 'QmQJ8fxavY54CUsxMSx9aE9Rdcmvhx8awJK2jzJp4iAqCr-tokens.uniswap.org-2024-01-18.car');
+            verifiedFetch = await createVerifiedFetch({
+                gateways: [`http://${controller.api.gatewayHost}:${controller.api.gatewayPort}`],
+                routers: [`http://${controller.api.gatewayHost}:${controller.api.gatewayPort}`]
+            });
+        });
+        after(async () => {
+            await controller.stop();
+            await verifiedFetch.stop();
+        });
+        it('handles UnixFS-chunked JSON file', async () => {
+            const resp = await verifiedFetch(CID.parse('QmQJ8fxavY54CUsxMSx9aE9Rdcmvhx8awJK2jzJp4iAqCr'));
+            expect(resp).to.be.ok();
+            const jsonObj = await resp.json();
+            expect(jsonObj).to.be.ok();
+            expect(jsonObj).to.have.property('name').equal('Uniswap Labs Default');
+            expect(jsonObj).to.have.property('timestamp').equal('2023-12-13T18:25:25.830Z');
+            expect(jsonObj).to.have.property('version').to.deep.equal({ major: 11, minor: 11, patch: 0 });
+            expect(jsonObj).to.have.property('tags');
+            expect(jsonObj).to.have.property('logoURI').equal('ipfs://QmNa8mQkrNKp1WEEeGjFezDmDeodkWRevGFN8JCV7b4Xir');
+            expect(jsonObj).to.have.property('keywords').to.deep.equal(['uniswap', 'default']);
+            expect(jsonObj.tokens).to.be.an('array').of.length(767);
+        });
+    });
+});
+//# sourceMappingURL=json.spec.js.map

package/dist/src/json.spec.js.map

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

package/dist/src/unixfs-dir.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=unixfs-dir.spec.d.ts.map

package/dist/src/unixfs-dir.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unixfs-dir.spec.d.ts","sourceRoot":"","sources":["../../src/unixfs-dir.spec.ts"],"names":[],"mappings":""}

package/dist/src/unixfs-dir.spec.js

@@ -0,0 +1,81 @@
+/* eslint-env mocha */
+import { createVerifiedFetch } from '@helia/verified-fetch';
+import { expect } from 'aegir/chai';
+import { filetypemime } from 'magic-bytes.js';
+import { createKuboNode } from './fixtures/create-kubo.js';
+import { loadFixtureDataCar } from './fixtures/load-fixture-data.js';
+describe('@helia/verified-fetch - unixfs directory', () => {
+    let controller;
+    let verifiedFetch;
+    before(async () => {
+        controller = await createKuboNode();
+        await controller.start();
+        verifiedFetch = await createVerifiedFetch({
+            gateways: [`http://${controller.api.gatewayHost}:${controller.api.gatewayPort}`],
+            routers: [`http://${controller.api.gatewayHost}:${controller.api.gatewayPort}`]
+        });
+    });
+    after(async () => {
+        await controller.stop();
+        await verifiedFetch.stop();
+    });
+    describe('XKCD Barrel Part 1', () => {
+        before(async () => {
+            // This is the content of https://explore.ipld.io/#/explore/QmdmQXB2mzChmMeKY47C43LxUdg1NDJ5MWcKMKxDu7RgQm/1%20-%20Barrel%20-%20Part%201
+            await loadFixtureDataCar(controller, 'QmbQDovX7wRe9ek7u6QXe9zgCXkTzoUSsTFJEkrYV1HrVR-xkcd-Barrel-part-1.car');
+        });
+        it('fails to load when passed the root', async () => {
+            // The spec says we should generate HTML with directory listings, but we don't do that yet, so expect a failure
+            const resp = await verifiedFetch('ipfs://QmbQDovX7wRe9ek7u6QXe9zgCXkTzoUSsTFJEkrYV1HrVR');
+            expect(resp).to.be.ok();
+            expect(resp.status).to.equal(501); // TODO: we should do a directory listing instead
+        });
+        it('can return a string for unixfs pathed data', async () => {
+            const resp = await verifiedFetch('ipfs://QmbQDovX7wRe9ek7u6QXe9zgCXkTzoUSsTFJEkrYV1HrVR/1 - Barrel - Part 1 - alt.txt');
+            expect(resp).to.be.ok();
+            const text = await resp.text();
+            expect(text).to.equal('Don\'t we all.');
+        });
+        it('can return an image for unixfs pathed data', async () => {
+            const resp = await verifiedFetch('ipfs://QmbQDovX7wRe9ek7u6QXe9zgCXkTzoUSsTFJEkrYV1HrVR/1 - Barrel - Part 1.png');
+            expect(resp).to.be.ok();
+            const imgData = await resp.blob();
+            expect(imgData).to.be.ok();
+            expect(imgData.size).to.equal(24848);
+        });
+    });
+    describe('content type parser', () => {
+        before(async () => {
+            await verifiedFetch.stop();
+            verifiedFetch = await createVerifiedFetch({
+                gateways: [`http://${controller.api.gatewayHost}:${controller.api.gatewayPort}`],
+                routers: [`http://${controller.api.gatewayHost}:${controller.api.gatewayPort}`]
+            }, {
+                contentTypeParser: (bytes) => {
+                    return filetypemime(bytes)?.[0];
+                }
+            });
+        });
+        it('can return an image content-type for unixfs pathed data', async () => {
+            const resp = await verifiedFetch('ipfs://QmbQDovX7wRe9ek7u6QXe9zgCXkTzoUSsTFJEkrYV1HrVR/1 - Barrel - Part 1.png');
+            // tediously this is actually a jpeg file with a .png extension
+            expect(resp.headers.get('content-type')).to.equal('image/jpeg');
+        });
+    });
+    describe('HAMT-sharded directory', () => {
+        before(async () => {
+            // from https://github.com/ipfs/gateway-conformance/blob/193833b91f2e9b17daf45c84afaeeae61d9d7c7e/fixtures/trustless_gateway_car/single-layer-hamt-with-multi-block-files.car
+            await loadFixtureDataCar(controller, 'bafybeidbclfqleg2uojchspzd4bob56dqetqjsj27gy2cq3klkkgxtpn4i-single-layer-hamt-with-multi-block-files.car');
+        });
+        it('loads path /ipfs/bafybeidbclfqleg2uojchspzd4bob56dqetqjsj27gy2cq3klkkgxtpn4i/685.txt', async () => {
+            const resp = await verifiedFetch('ipfs://bafybeidbclfqleg2uojchspzd4bob56dqetqjsj27gy2cq3klkkgxtpn4i/685.txt');
+            expect(resp).to.be.ok();
+            const text = await resp.text();
+            // npx kubo@0.25.0 cat '/ipfs/bafybeidbclfqleg2uojchspzd4bob56dqetqjsj27gy2cq3klkkgxtpn4i/685.txt'
+            expect(text).to.equal(`Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc non imperdiet nunc. Proin ac quam ut nibh eleifend aliquet. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia curae; Sed ligula dolor, imperdiet sagittis arcu et, semper tincidunt urna. Donec et tempor augue, quis sollicitudin metus. Curabitur semper ullamcorper aliquet. Mauris hendrerit sodales lectus eget fermentum. Proin sollicitudin vestibulum commodo. Vivamus nec lectus eu augue aliquet dignissim nec condimentum justo. In hac habitasse platea dictumst. Mauris vel sem neque.
+
+Vivamus finibus, enim at lacinia semper, arcu erat gravida lacus, sit amet gravida magna orci sit amet est. Sed non leo lacus. Nullam viverra ipsum a tincidunt dapibus. Nulla pulvinar ligula sit amet ante ultrices tempus. Proin purus urna, semper sed lobortis quis, gravida vitae ipsum. Aliquam mi urna, pulvinar eu bibendum quis, convallis ac dolor. In gravida justo sed risus ullamcorper, vitae luctus massa hendrerit. Pellentesque habitant amet.`);
+        });
+    });
+});
+//# sourceMappingURL=unixfs-dir.spec.js.map

package/dist/src/unixfs-dir.spec.js.map

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

package/dist/src/websites.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=websites.spec.d.ts.map

package/dist/src/websites.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websites.spec.d.ts","sourceRoot":"","sources":["../../src/websites.spec.ts"],"names":[],"mappings":""}

package/dist/src/websites.spec.js

@@ -0,0 +1,76 @@
+/* eslint-env mocha */
+import { createVerifiedFetch } from '@helia/verified-fetch';
+import { expect } from 'aegir/chai';
+import { createKuboNode } from './fixtures/create-kubo.js';
+import { loadFixtureDataCar } from './fixtures/load-fixture-data.js';
+describe('@helia/verified-fetch - websites', () => {
+    describe('helia-identify.on.fleek.co', () => {
+        let controller;
+        let verifiedFetch;
+        before(async () => {
+            controller = await createKuboNode();
+            await controller.start();
+            // 2024-01-22 CID for _dnslink.helia-identify.on.fleek.co
+            await loadFixtureDataCar(controller, 'QmbxpRxwKXxnJQjnPqm1kzDJSJ8YgkLxH23mcZURwPHjGv-helia-identify-website.car');
+            verifiedFetch = await createVerifiedFetch({
+                gateways: [`http://${controller.api.gatewayHost}:${controller.api.gatewayPort}`],
+                routers: [`http://${controller.api.gatewayHost}:${controller.api.gatewayPort}`]
+            });
+        });
+        after(async () => {
+            await controller.stop();
+            await verifiedFetch.stop();
+        });
+        it('loads index.html when passed helia-identify.on.fleek.co root CID', async () => {
+            const resp = await verifiedFetch('ipfs://QmbxpRxwKXxnJQjnPqm1kzDJSJ8YgkLxH23mcZURwPHjGv');
+            expect(resp).to.be.ok();
+            const html = await resp.text();
+            expect(html).to.be.ok();
+            expect(html).to.include('<title>Run Identify on a remote node with Helia</title>');
+        });
+        it('loads helia-identify.on.fleek.co index.html directly ', async () => {
+            const resp = await verifiedFetch('ipfs://QmbxpRxwKXxnJQjnPqm1kzDJSJ8YgkLxH23mcZURwPHjGv/index.html');
+            expect(resp).to.be.ok();
+            const html = await resp.text();
+            expect(html).to.be.ok();
+            expect(html).to.include('<title>Run Identify on a remote node with Helia</title>');
+        });
+    });
+    /**
+     *
+     * Created on 2024-01-23. /ipns/blog.libp2p.io/index.html resolved to QmVZNGy6SPvUbvQCXXaGDdp8kvfJm9MMozjU12dyzH6hKf
+     *
+     * ```shell
+     * mkdir fake-blog.libp2p.io
+     * npx kubo@0.25.0 cat '/ipfs/QmVZNGy6SPvUbvQCXXaGDdp8kvfJm9MMozjU12dyzH6hKf' > fake-blog.libp2p.io/index.html
+     * npx kubo@0.25.0 add -r fake-blog.libp2p.io
+     * npx kubo@0.25.0 dag export QmeiDMLtPUS3RT2xAcUwsNyZz169wPke2q7im9vZpVLSYw > QmeiDMLtPUS3RT2xAcUwsNyZz169wPke2q7im9vZpVLSYw-fake-blog.libp2p.io.car
+     * ```
+     */
+    describe('fake blog.libp2p.io', () => {
+        let controller;
+        let verifiedFetch;
+        before(async () => {
+            controller = await createKuboNode();
+            await controller.start();
+            await loadFixtureDataCar(controller, 'QmeiDMLtPUS3RT2xAcUwsNyZz169wPke2q7im9vZpVLSYw-fake-blog.libp2p.io.car');
+            verifiedFetch = await createVerifiedFetch({
+                gateways: [`http://${controller.api.gatewayHost}:${controller.api.gatewayPort}`],
+                routers: [`http://${controller.api.gatewayHost}:${controller.api.gatewayPort}`]
+            });
+        });
+        after(async () => {
+            await controller.stop();
+            await verifiedFetch.stop();
+        });
+        it('loads index.html when passed fake-blog.libp2p.io root CID', async () => {
+            const resp = await verifiedFetch('ipfs://QmeiDMLtPUS3RT2xAcUwsNyZz169wPke2q7im9vZpVLSYw');
+            expect(resp).to.be.ok();
+            const html = await resp.text();
+            expect(html).to.be.ok();
+            expect(html).to.include('<title>Home | libp2p Blog &#x26; News</title>');
+            expect(html).to.include('<link href="https://libp2p.io/" rel="canonical">');
+        });
+    });
+});
+//# sourceMappingURL=websites.spec.js.map

package/dist/src/websites.spec.js.map

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

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@helia/verified-fetch-interop",
+  "version": "0.0.0",
+  "description": "Interop tests for @helia/verified-fetch",
+  "license": "Apache-2.0 OR MIT",
+  "homepage": "https://github.com/ipfs/helia-verified-fetch/tree/main/packages/interop#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ipfs/helia-verified-fetch.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ipfs/helia-verified-fetch/issues"
+  },
+  "keywords": [
+    "IPFS"
+  ],
+  "bin": {
+    "helia-verified-fetch-interop": "./dist/src/bin.js"
+  },
+  "type": "module",
+  "types": "./dist/src/index.d.ts",
+  "files": [
+    "src",
+    "dist",
+    "!dist/test",
+    "!**/*.tsbuildinfo"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "eslintConfig": {
+    "extends": "ipfs",
+    "parserOptions": {
+      "project": true,
+      "sourceType": "module"
+    }
+  },
+  "scripts": {
+    "clean": "aegir clean",
+    "lint": "aegir lint",
+    "dep-check": "aegir dep-check",
+    "doc-check": "aegir doc-check",
+    "build": "aegir build",
+    "test": "aegir test",
+    "test:chrome": "aegir test -t browser --cov",
+    "test:chrome-webworker": "aegir test -t webworker",
+    "test:firefox": "aegir test -t browser -- --browser firefox",
+    "test:firefox-webworker": "aegir test -t webworker -- --browser firefox",
+    "test:node": "aegir test -t node --cov",
+    "test:electron-main": "aegir test -t electron-main"
+  },
+  "dependencies": {
+    "@helia/verified-fetch": "~0.0.0",
+    "aegir": "^42.2.5",
+    "ipfsd-ctl": "^13.0.0",
+    "it-drain": "^3.0.5",
+    "kubo": "^0.26.0",
+    "kubo-rpc-client": "^3.0.3",
+    "magic-bytes.js": "^1.8.0",
+    "multiformats": "^13.1.0"
+  },
+  "browser": {
+    "./dist/src/fixtures/create-kubo.js": "./dist/src/fixtures/create-kubo.browser.js",
+    "kubo": false
+  }
+}

package/src/bin.ts

@@ -0,0 +1,25 @@
+#! /usr/bin/env node
+/* eslint-disable no-console */
+
+import { spawn } from 'node:child_process'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+// aegir should be run from `node_modules/@helia/interop`
+const cwd = resolve(dirname(fileURLToPath(import.meta.url)), '../../')
+
+const test = spawn('npx', ['aegir', 'test'], {
+  cwd
+})
+
+test.stdout.on('data', (data) => {
+  process.stdout.write(data)
+})
+
+test.stderr.on('data', (data) => {
+  process.stderr.write(data)
+})
+
+test.on('close', (code) => {
+  process.exit(code ?? 0)
+})

package/src/fixtures/create-kubo.browser.ts

@@ -0,0 +1,30 @@
+import { type Controller, createController } from 'ipfsd-ctl'
+import * as kuboRpcClient from 'kubo-rpc-client'
+
+export async function createKuboNode (): Promise<Controller> {
+  return createController({
+    kuboRpcModule: kuboRpcClient,
+    test: true,
+    endpoint: process.env.IPFSD_SERVER,
+    ipfsOptions: {
+      config: {
+        Addresses: {
+          Swarm: [
+            '/ip4/0.0.0.0/tcp/0',
+            '/ip4/0.0.0.0/tcp/0/ws'
+          ],
+          Gateway: '/ip4/127.0.0.1/tcp/8180'
+        },
+        Gateway: {
+          NoFetch: true,
+          ExposeRoutingAPI: true,
+          HTTPHeaders: {
+            'Access-Control-Allow-Origin': ['*'],
+            'Access-Control-Allow-Methods': ['GET', 'POST', 'PUT', 'OPTIONS']
+          }
+        }
+      }
+    },
+    args: ['--enable-pubsub-experiment', '--enable-namesys-pubsub']
+  })
+}

package/src/fixtures/create-kubo.ts

@@ -0,0 +1,32 @@
+/* eslint-disable @typescript-eslint/ban-ts-comment,@typescript-eslint/prefer-ts-expect-error */
+import { createController, type Controller } from 'ipfsd-ctl'
+import { path as kuboPath } from 'kubo'
+import * as kuboRpcClient from 'kubo-rpc-client'
+
+export async function createKuboNode (): Promise<Controller> {
+  return createController({
+    kuboRpcModule: kuboRpcClient,
+    ipfsBin: kuboPath(),
+    test: true,
+    ipfsOptions: {
+      config: {
+        Addresses: {
+          Swarm: [
+            '/ip4/0.0.0.0/tcp/4001',
+            '/ip4/0.0.0.0/tcp/4002/ws'
+          ],
+          Gateway: '/ip4/127.0.0.1/tcp/8180'
+        },
+        Gateway: {
+          NoFetch: true,
+          ExposeRoutingAPI: true,
+          HTTPHeaders: {
+            'Access-Control-Allow-Origin': ['*'],
+            'Access-Control-Allow-Methods': ['GET', 'POST', 'PUT', 'OPTIONS']
+          }
+        }
+      }
+    },
+    args: ['--enable-pubsub-experiment', '--enable-namesys-pubsub']
+  })
+}

package/src/fixtures/load-fixture-data.ts

@@ -0,0 +1,9 @@
+import loadFixture from 'aegir/fixtures'
+import drain from 'it-drain'
+import type { Controller } from 'ipfsd-ctl'
+
+export async function loadFixtureDataCar (controller: Controller, path: string): Promise<void> {
+  const fixtureData = `src/fixtures/data/${path}`
+  const buf = loadFixture(fixtureData)
+  await drain(controller.api.dag.import([buf]))
+}

package/src/index.ts

@@ -0,0 +1,14 @@
+/**
+ * @packageDocumentation
+ *
+ * Runs interop tests between @helia/verified-fetch and Kubo.
+ *
+ * @example Testing a new Kubo release
+ *
+ * ```console
+ * $ npm i @helia/verified-fetch-interop
+ * $ KUBO_BINARY=/path/to/kubo helia-verified-fetch-interop
+ * ```
+ */
+
+export {}

package/src/json.spec.ts

@@ -0,0 +1,47 @@
+/* eslint-env mocha */
+import { createVerifiedFetch } from '@helia/verified-fetch'
+import { expect } from 'aegir/chai'
+import { CID } from 'multiformats/cid'
+import { createKuboNode } from './fixtures/create-kubo.js'
+import { loadFixtureDataCar } from './fixtures/load-fixture-data.js'
+import type { Controller } from 'ipfsd-ctl'
+
+describe('@helia/verified-fetch - json', () => {
+  describe('unixfs - multiblock', () => {
+    let controller: Controller<'go'>
+    let verifiedFetch: Awaited<ReturnType<typeof createVerifiedFetch>>
+
+    before(async () => {
+      controller = await createKuboNode()
+      await controller.start()
+      // As of 2024-01-18, https://cloudflare-ipfs.com/ipns/tokens.uniswap.org resolves to:
+      // root: QmQJ8fxavY54CUsxMSx9aE9Rdcmvhx8awJK2jzJp4iAqCr
+      // child1: QmNik5N4ryNwzzXYq5hCYKGcRjAf9QtigxtiJh9o8aXXbG // partial JSON
+      // child2: QmWNBJX6fZyNTLWNYBHxAHpBctCP43R2zeqV2G8uavqFZn // partial JSON
+      await loadFixtureDataCar(controller, 'QmQJ8fxavY54CUsxMSx9aE9Rdcmvhx8awJK2jzJp4iAqCr-tokens.uniswap.org-2024-01-18.car')
+      verifiedFetch = await createVerifiedFetch({
+        gateways: [`http://${controller.api.gatewayHost}:${controller.api.gatewayPort}`],
+        routers: [`http://${controller.api.gatewayHost}:${controller.api.gatewayPort}`]
+      })
+    })
+
+    after(async () => {
+      await controller.stop()
+      await verifiedFetch.stop()
+    })
+
+    it('handles UnixFS-chunked JSON file', async () => {
+      const resp = await verifiedFetch(CID.parse('QmQJ8fxavY54CUsxMSx9aE9Rdcmvhx8awJK2jzJp4iAqCr'))
+      expect(resp).to.be.ok()
+      const jsonObj = await resp.json()
+      expect(jsonObj).to.be.ok()
+      expect(jsonObj).to.have.property('name').equal('Uniswap Labs Default')
+      expect(jsonObj).to.have.property('timestamp').equal('2023-12-13T18:25:25.830Z')
+      expect(jsonObj).to.have.property('version').to.deep.equal({ major: 11, minor: 11, patch: 0 })
+      expect(jsonObj).to.have.property('tags')
+      expect(jsonObj).to.have.property('logoURI').equal('ipfs://QmNa8mQkrNKp1WEEeGjFezDmDeodkWRevGFN8JCV7b4Xir')
+      expect(jsonObj).to.have.property('keywords').to.deep.equal(['uniswap', 'default'])
+      expect(jsonObj.tokens).to.be.an('array').of.length(767)
+    })
+  })
+})

package/src/unixfs-dir.spec.ts

@@ -0,0 +1,94 @@
+/* eslint-env mocha */
+import { createVerifiedFetch } from '@helia/verified-fetch'
+import { expect } from 'aegir/chai'
+import { filetypemime } from 'magic-bytes.js'
+import { createKuboNode } from './fixtures/create-kubo.js'
+import { loadFixtureDataCar } from './fixtures/load-fixture-data.js'
+import type { VerifiedFetch } from '@helia/verified-fetch'
+import type { Controller } from 'ipfsd-ctl'
+
+describe('@helia/verified-fetch - unixfs directory', () => {
+  let controller: Controller
+  let verifiedFetch: VerifiedFetch
+
+  before(async () => {
+    controller = await createKuboNode()
+    await controller.start()
+
+    verifiedFetch = await createVerifiedFetch({
+      gateways: [`http://${controller.api.gatewayHost}:${controller.api.gatewayPort}`],
+      routers: [`http://${controller.api.gatewayHost}:${controller.api.gatewayPort}`]
+    })
+  })
+
+  after(async () => {
+    await controller.stop()
+    await verifiedFetch.stop()
+  })
+
+  describe('XKCD Barrel Part 1', () => {
+    before(async () => {
+      // This is the content of https://explore.ipld.io/#/explore/QmdmQXB2mzChmMeKY47C43LxUdg1NDJ5MWcKMKxDu7RgQm/1%20-%20Barrel%20-%20Part%201
+      await loadFixtureDataCar(controller, 'QmbQDovX7wRe9ek7u6QXe9zgCXkTzoUSsTFJEkrYV1HrVR-xkcd-Barrel-part-1.car')
+    })
+
+    it('fails to load when passed the root', async () => {
+      // The spec says we should generate HTML with directory listings, but we don't do that yet, so expect a failure
+      const resp = await verifiedFetch('ipfs://QmbQDovX7wRe9ek7u6QXe9zgCXkTzoUSsTFJEkrYV1HrVR')
+      expect(resp).to.be.ok()
+      expect(resp.status).to.equal(501) // TODO: we should do a directory listing instead
+    })
+
+    it('can return a string for unixfs pathed data', async () => {
+      const resp = await verifiedFetch('ipfs://QmbQDovX7wRe9ek7u6QXe9zgCXkTzoUSsTFJEkrYV1HrVR/1 - Barrel - Part 1 - alt.txt')
+      expect(resp).to.be.ok()
+      const text = await resp.text()
+      expect(text).to.equal('Don\'t we all.')
+    })
+
+    it('can return an image for unixfs pathed data', async () => {
+      const resp = await verifiedFetch('ipfs://QmbQDovX7wRe9ek7u6QXe9zgCXkTzoUSsTFJEkrYV1HrVR/1 - Barrel - Part 1.png')
+      expect(resp).to.be.ok()
+      const imgData = await resp.blob()
+      expect(imgData).to.be.ok()
+      expect(imgData.size).to.equal(24848)
+    })
+  })
+
+  describe('content type parser', () => {
+    before(async () => {
+      await verifiedFetch.stop()
+      verifiedFetch = await createVerifiedFetch({
+        gateways: [`http://${controller.api.gatewayHost}:${controller.api.gatewayPort}`],
+        routers: [`http://${controller.api.gatewayHost}:${controller.api.gatewayPort}`]
+      }, {
+        contentTypeParser: (bytes) => {
+          return filetypemime(bytes)?.[0]
+        }
+      })
+    })
+
+    it('can return an image content-type for unixfs pathed data', async () => {
+      const resp = await verifiedFetch('ipfs://QmbQDovX7wRe9ek7u6QXe9zgCXkTzoUSsTFJEkrYV1HrVR/1 - Barrel - Part 1.png')
+      // tediously this is actually a jpeg file with a .png extension
+      expect(resp.headers.get('content-type')).to.equal('image/jpeg')
+    })
+  })
+
+  describe('HAMT-sharded directory', () => {
+    before(async () => {
+      // from https://github.com/ipfs/gateway-conformance/blob/193833b91f2e9b17daf45c84afaeeae61d9d7c7e/fixtures/trustless_gateway_car/single-layer-hamt-with-multi-block-files.car
+      await loadFixtureDataCar(controller, 'bafybeidbclfqleg2uojchspzd4bob56dqetqjsj27gy2cq3klkkgxtpn4i-single-layer-hamt-with-multi-block-files.car')
+    })
+
+    it('loads path /ipfs/bafybeidbclfqleg2uojchspzd4bob56dqetqjsj27gy2cq3klkkgxtpn4i/685.txt', async () => {
+      const resp = await verifiedFetch('ipfs://bafybeidbclfqleg2uojchspzd4bob56dqetqjsj27gy2cq3klkkgxtpn4i/685.txt')
+      expect(resp).to.be.ok()
+      const text = await resp.text()
+      // npx kubo@0.25.0 cat '/ipfs/bafybeidbclfqleg2uojchspzd4bob56dqetqjsj27gy2cq3klkkgxtpn4i/685.txt'
+      expect(text).to.equal(`Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc non imperdiet nunc. Proin ac quam ut nibh eleifend aliquet. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia curae; Sed ligula dolor, imperdiet sagittis arcu et, semper tincidunt urna. Donec et tempor augue, quis sollicitudin metus. Curabitur semper ullamcorper aliquet. Mauris hendrerit sodales lectus eget fermentum. Proin sollicitudin vestibulum commodo. Vivamus nec lectus eu augue aliquet dignissim nec condimentum justo. In hac habitasse platea dictumst. Mauris vel sem neque.
+
+Vivamus finibus, enim at lacinia semper, arcu erat gravida lacus, sit amet gravida magna orci sit amet est. Sed non leo lacus. Nullam viverra ipsum a tincidunt dapibus. Nulla pulvinar ligula sit amet ante ultrices tempus. Proin purus urna, semper sed lobortis quis, gravida vitae ipsum. Aliquam mi urna, pulvinar eu bibendum quis, convallis ac dolor. In gravida justo sed risus ullamcorper, vitae luctus massa hendrerit. Pellentesque habitant amet.`)
+    })
+  })
+})

package/src/websites.spec.ts

@@ -0,0 +1,85 @@
+/* eslint-env mocha */
+import { createVerifiedFetch } from '@helia/verified-fetch'
+import { expect } from 'aegir/chai'
+import { createKuboNode } from './fixtures/create-kubo.js'
+import { loadFixtureDataCar } from './fixtures/load-fixture-data.js'
+import type { Controller } from 'ipfsd-ctl'
+
+describe('@helia/verified-fetch - websites', () => {
+  describe('helia-identify.on.fleek.co', () => {
+    let controller: Controller<'go'>
+    let verifiedFetch: Awaited<ReturnType<typeof createVerifiedFetch>>
+
+    before(async () => {
+      controller = await createKuboNode()
+      await controller.start()
+      // 2024-01-22 CID for _dnslink.helia-identify.on.fleek.co
+      await loadFixtureDataCar(controller, 'QmbxpRxwKXxnJQjnPqm1kzDJSJ8YgkLxH23mcZURwPHjGv-helia-identify-website.car')
+      verifiedFetch = await createVerifiedFetch({
+        gateways: [`http://${controller.api.gatewayHost}:${controller.api.gatewayPort}`],
+        routers: [`http://${controller.api.gatewayHost}:${controller.api.gatewayPort}`]
+      })
+    })
+
+    after(async () => {
+      await controller.stop()
+      await verifiedFetch.stop()
+    })
+
+    it('loads index.html when passed helia-identify.on.fleek.co root CID', async () => {
+      const resp = await verifiedFetch('ipfs://QmbxpRxwKXxnJQjnPqm1kzDJSJ8YgkLxH23mcZURwPHjGv')
+      expect(resp).to.be.ok()
+      const html = await resp.text()
+      expect(html).to.be.ok()
+      expect(html).to.include('<title>Run Identify on a remote node with Helia</title>')
+    })
+
+    it('loads helia-identify.on.fleek.co index.html directly ', async () => {
+      const resp = await verifiedFetch('ipfs://QmbxpRxwKXxnJQjnPqm1kzDJSJ8YgkLxH23mcZURwPHjGv/index.html')
+      expect(resp).to.be.ok()
+      const html = await resp.text()
+      expect(html).to.be.ok()
+      expect(html).to.include('<title>Run Identify on a remote node with Helia</title>')
+    })
+  })
+
+  /**
+   *
+   * Created on 2024-01-23. /ipns/blog.libp2p.io/index.html resolved to QmVZNGy6SPvUbvQCXXaGDdp8kvfJm9MMozjU12dyzH6hKf
+   *
+   * ```shell
+   * mkdir fake-blog.libp2p.io
+   * npx kubo@0.25.0 cat '/ipfs/QmVZNGy6SPvUbvQCXXaGDdp8kvfJm9MMozjU12dyzH6hKf' > fake-blog.libp2p.io/index.html
+   * npx kubo@0.25.0 add -r fake-blog.libp2p.io
+   * npx kubo@0.25.0 dag export QmeiDMLtPUS3RT2xAcUwsNyZz169wPke2q7im9vZpVLSYw > QmeiDMLtPUS3RT2xAcUwsNyZz169wPke2q7im9vZpVLSYw-fake-blog.libp2p.io.car
+   * ```
+   */
+  describe('fake blog.libp2p.io', () => {
+    let controller: Controller<'go'>
+    let verifiedFetch: Awaited<ReturnType<typeof createVerifiedFetch>>
+
+    before(async () => {
+      controller = await createKuboNode()
+      await controller.start()
+      await loadFixtureDataCar(controller, 'QmeiDMLtPUS3RT2xAcUwsNyZz169wPke2q7im9vZpVLSYw-fake-blog.libp2p.io.car')
+      verifiedFetch = await createVerifiedFetch({
+        gateways: [`http://${controller.api.gatewayHost}:${controller.api.gatewayPort}`],
+        routers: [`http://${controller.api.gatewayHost}:${controller.api.gatewayPort}`]
+      })
+    })
+
+    after(async () => {
+      await controller.stop()
+      await verifiedFetch.stop()
+    })
+
+    it('loads index.html when passed fake-blog.libp2p.io root CID', async () => {
+      const resp = await verifiedFetch('ipfs://QmeiDMLtPUS3RT2xAcUwsNyZz169wPke2q7im9vZpVLSYw')
+      expect(resp).to.be.ok()
+      const html = await resp.text()
+      expect(html).to.be.ok()
+      expect(html).to.include('<title>Home | libp2p Blog &#x26; News</title>')
+      expect(html).to.include('<link href="https://libp2p.io/" rel="canonical">')
+    })
+  })
+})