@libp2p/daemon-client 0.0.0

package/dist/src/pubsub.js

@@ -0,0 +1,81 @@
+import errcode from 'err-code';
+import { Request, Response, PSRequest, PSMessage } from '@libp2p/daemon-protocol';
+export class Pubsub {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get a list of topics the node is subscribed to.
+     *
+     * @returns {Array<string>} topics
+     */
+    async getTopics() {
+        const sh = await this.client.send({
+            type: Request.Type.PUBSUB,
+            pubsub: {
+                type: PSRequest.Type.GET_TOPICS
+            }
+        });
+        const message = await sh.read();
+        const response = Response.decode(message);
+        await sh.close();
+        if (response.type !== Response.Type.OK) {
+            throw errcode(new Error(response.error?.msg ?? 'Pubsub get topics failed'), 'ERR_PUBSUB_GET_TOPICS_FAILED');
+        }
+        if (response.pubsub == null || response.pubsub.topics == null) {
+            throw errcode(new Error('Invalid response'), 'ERR_PUBSUB_GET_TOPICS_FAILED');
+        }
+        return response.pubsub.topics;
+    }
+    /**
+     * Publish data under a topic
+     */
+    async publish(topic, data) {
+        if (typeof topic !== 'string') {
+            throw errcode(new Error('invalid topic received'), 'ERR_INVALID_TOPIC');
+        }
+        if (!(data instanceof Uint8Array)) {
+            throw errcode(new Error('data received is not a Uint8Array'), 'ERR_INVALID_DATA');
+        }
+        const sh = await this.client.send({
+            type: Request.Type.PUBSUB,
+            pubsub: {
+                type: PSRequest.Type.PUBLISH,
+                topic,
+                data
+            }
+        });
+        const message = await sh.read();
+        const response = Response.decode(message);
+        await sh.close();
+        if (response.type !== Response.Type.OK) {
+            throw errcode(new Error(response.error?.msg ?? 'Pubsub publish failed'), 'ERR_PUBSUB_PUBLISH_FAILED');
+        }
+    }
+    /**
+     * Request to subscribe a certain topic
+     */
+    async *subscribe(topic) {
+        if (typeof topic !== 'string') {
+            throw errcode(new Error('invalid topic received'), 'ERR_INVALID_TOPIC');
+        }
+        const sh = await this.client.send({
+            type: Request.Type.PUBSUB,
+            pubsub: {
+                type: PSRequest.Type.SUBSCRIBE,
+                topic
+            }
+        });
+        let message = await sh.read();
+        let response = Response.decode(message);
+        if (response.type !== Response.Type.OK) {
+            throw errcode(new Error(response.error?.msg ?? 'Pubsub publish failed'), 'ERR_PUBSUB_PUBLISH_FAILED');
+        }
+        // stream messages
+        while (true) {
+            message = await sh.read();
+            yield PSMessage.decode(message);
+        }
+    }
+}
+//# sourceMappingURL=pubsub.js.map

package/dist/src/pubsub.js.map

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

package/dist/src/stream-handler.d.ts

@@ -0,0 +1,28 @@
+import type { Duplex } from 'it-stream-types';
+export interface StreamHandlerOptions {
+    stream: Duplex<Uint8Array>;
+    maxLength?: number;
+}
+export declare class StreamHandler {
+    private stream;
+    private shake;
+    private decoder;
+    /**
+     * Create a stream handler for connection
+     */
+    constructor(opts: StreamHandlerOptions);
+    /**
+     * Read and decode message
+     */
+    read(): Promise<any>;
+    write(msg: Uint8Array): void;
+    /**
+     * Return the handshake rest stream and invalidate handler
+     */
+    rest(): Duplex<Uint8Array, Uint8Array, Promise<void>>;
+    /**
+     * Close the stream
+     */
+    close(): void;
+}
+//# sourceMappingURL=stream-handler.d.ts.map

package/dist/src/stream-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-handler.d.ts","sourceRoot":"","sources":["../../src/stream-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAU,MAAM,iBAAiB,CAAA;AAKrD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,OAAO,CAAoB;IACnC;;OAEG;gBACU,IAAI,EAAE,oBAAoB;IAQvC;;OAEG;IACG,IAAI;IAWV,KAAK,CAAE,GAAG,EAAE,UAAU;IAOtB;;OAEG;IACH,IAAI;IAKJ;;OAEG;IACH,KAAK;CAIN"}

package/dist/src/stream-handler.js

@@ -0,0 +1,47 @@
+import * as lp from 'it-length-prefixed';
+import { handshake } from 'it-handshake';
+import { logger } from '@libp2p/logger';
+const log = logger('libp2p:daemon-client:stream-handler');
+export class StreamHandler {
+    /**
+     * Create a stream handler for connection
+     */
+    constructor(opts) {
+        const { stream, maxLength } = opts;
+        this.stream = stream;
+        this.shake = handshake(this.stream);
+        this.decoder = lp.decode.fromReader(this.shake.reader, { maxDataLength: maxLength ?? 4096 });
+    }
+    /**
+     * Read and decode message
+     */
+    async read() {
+        // @ts-expect-error decoder is really a generator
+        const msg = await this.decoder.next();
+        if (msg.value) {
+            return msg.value.slice();
+        }
+        log('read received no value, closing stream');
+        // End the stream, we didn't get data
+        this.close();
+    }
+    write(msg) {
+        log('write message');
+        this.shake.write(lp.encode.single(msg).slice());
+    }
+    /**
+     * Return the handshake rest stream and invalidate handler
+     */
+    rest() {
+        this.shake.rest();
+        return this.shake.stream;
+    }
+    /**
+     * Close the stream
+     */
+    close() {
+        log('closing the stream');
+        this.rest().sink([]);
+    }
+}
+//# sourceMappingURL=stream-handler.js.map

package/dist/src/stream-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-handler.js","sourceRoot":"","sources":["../../src/stream-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,oBAAoB,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAIvC,MAAM,GAAG,GAAG,MAAM,CAAC,qCAAqC,CAAC,CAAA;AAOzD,MAAM,OAAO,aAAa;IAIxB;;OAEG;IACH,YAAa,IAA0B;QACrC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAA;QAElC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACnC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,SAAS,IAAI,IAAI,EAAE,CAAC,CAAA;IAC9F,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,iDAAiD;QACjD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;QACrC,IAAI,GAAG,CAAC,KAAK,EAAE;YACb,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;SACzB;QACD,GAAG,CAAC,wCAAwC,CAAC,CAAA;QAC7C,qCAAqC;QACrC,IAAI,CAAC,KAAK,EAAE,CAAA;IACd,CAAC;IAED,KAAK,CAAE,GAAe;QACpB,GAAG,CAAC,eAAe,CAAC,CAAA;QACpB,IAAI,CAAC,KAAK,CAAC,KAAK,CACd,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAC9B,CAAA;IACH,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAA;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,GAAG,CAAC,oBAAoB,CAAC,CAAA;QACzB,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACtB,CAAC;CACF"}

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

@@ -0,0 +1,12 @@
+import type { Upgrader } from '@libp2p/interfaces/transport';
+import type { Multiaddr } from '@multiformats/multiaddr';
+export declare const passThroughUpgrader: Upgrader;
+/**
+ * Converts the multiaddr to a nodejs NET compliant option
+ * for .connect or .listen
+ *
+ * @param {Multiaddr} addr
+ * @returns {string|object} A nodejs NET compliant option
+ */
+export declare function multiaddrToNetConfig(addr: Multiaddr): string | import("@multiformats/multiaddr").NodeAddress;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/util/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAGxD,eAAO,MAAM,mBAAmB,EAAE,QAKjC,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAE,IAAI,EAAE,SAAS,0DAQpD"}

package/dist/src/util/index.js

@@ -0,0 +1,24 @@
+import { resolve } from 'path';
+export const passThroughUpgrader = {
+    // @ts-expect-error
+    upgradeInbound: maConn => maConn,
+    // @ts-expect-error
+    upgradeOutbound: maConn => maConn
+};
+/**
+ * Converts the multiaddr to a nodejs NET compliant option
+ * for .connect or .listen
+ *
+ * @param {Multiaddr} addr
+ * @returns {string|object} A nodejs NET compliant option
+ */
+export function multiaddrToNetConfig(addr) {
+    const listenPath = addr.getPath();
+    // unix socket listening
+    if (listenPath) {
+        return resolve(listenPath);
+    }
+    // tcp listening
+    return addr.nodeAddress();
+}
+//# sourceMappingURL=index.js.map

package/dist/src/util/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/util/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAE9B,MAAM,CAAC,MAAM,mBAAmB,GAAa;IAC3C,mBAAmB;IACnB,cAAc,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM;IAChC,mBAAmB;IACnB,eAAe,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM;CAClC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAE,IAAe;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;IACjC,wBAAwB;IACxB,IAAI,UAAU,EAAE;QACd,OAAO,OAAO,CAAC,UAAU,CAAC,CAAA;KAC3B;IACD,gBAAgB;IAChB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAA;AAC3B,CAAC"}

package/package.json

@@ -0,0 +1,160 @@
+{
+  "name": "@libp2p/daemon-client",
+  "version": "0.0.0",
+  "description": "libp2p-daemon client implementation",
+  "license": "Apache-2.0 OR MIT",
+  "homepage": "https://github.com/libp2p/js-libp2p-daemon/tree/master/packages/libp2p-daemon-client#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/libp2p/js-libp2p-daemon.git"
+  },
+  "bugs": {
+    "url": "https://github.com/libp2p/js-libp2p-daemon/issues"
+  },
+  "keywords": [
+    "libp2p"
+  ],
+  "engines": {
+    "node": ">=16.0.0",
+    "npm": ">=7.0.0"
+  },
+  "type": "module",
+  "types": "./dist/src/index.d.ts",
+  "files": [
+    "src",
+    "dist/src",
+    "!dist/test",
+    "!**/*.tsbuildinfo"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/src/index.js"
+    }
+  },
+  "eslintConfig": {
+    "extends": "ipfs",
+    "parserOptions": {
+      "sourceType": "module"
+    }
+  },
+  "release": {
+    "branches": [
+      "master"
+    ],
+    "plugins": [
+      [
+        "@semantic-release/commit-analyzer",
+        {
+          "preset": "conventionalcommits",
+          "releaseRules": [
+            {
+              "breaking": true,
+              "release": "major"
+            },
+            {
+              "revert": true,
+              "release": "patch"
+            },
+            {
+              "type": "feat",
+              "release": "minor"
+            },
+            {
+              "type": "fix",
+              "release": "patch"
+            },
+            {
+              "type": "chore",
+              "release": "patch"
+            },
+            {
+              "type": "docs",
+              "release": "patch"
+            },
+            {
+              "type": "test",
+              "release": "patch"
+            },
+            {
+              "scope": "no-release",
+              "release": false
+            }
+          ]
+        }
+      ],
+      [
+        "@semantic-release/release-notes-generator",
+        {
+          "preset": "conventionalcommits",
+          "presetConfig": {
+            "types": [
+              {
+                "type": "feat",
+                "section": "Features"
+              },
+              {
+                "type": "fix",
+                "section": "Bug Fixes"
+              },
+              {
+                "type": "chore",
+                "section": "Trivial Changes"
+              },
+              {
+                "type": "docs",
+                "section": "Trivial Changes"
+              },
+              {
+                "type": "test",
+                "section": "Tests"
+              }
+            ]
+          }
+        }
+      ],
+      "@semantic-release/changelog",
+      "@semantic-release/npm",
+      "@semantic-release/github",
+      "@semantic-release/git"
+    ]
+  },
+  "scripts": {
+    "lint": "aegir lint",
+    "build": "tsc",
+    "pretest": "npm run build",
+    "test": "aegir test -t node -f ./dist/test/*.js",
+    "test:node": "aegir test -t node -f ./dist/test/*.js",
+    "release": "semantic-release"
+  },
+  "dependencies": {
+    "@libp2p/daemon-protocol": "^0.0.0",
+    "@libp2p/interfaces": "^1.3.17",
+    "@libp2p/logger": "^1.1.2",
+    "@libp2p/peer-id": "^1.1.8",
+    "@multiformats/multiaddr": "^10.1.8",
+    "err-code": "^3.0.1",
+    "it-handshake": "^3.0.1",
+    "it-length-prefixed": "^7.0.1",
+    "it-stream-types": "^1.0.4",
+    "libp2p-daemon": "^0.10.0",
+    "libp2p-tcp": "^0.17.1",
+    "multiaddr": "^10.0.0",
+    "multiformats": "^9.4.2",
+    "peer-id": "^0.16.0"
+  },
+  "devDependencies": {
+    "@libp2p/peer-id-factory": "^1.0.8",
+    "@libp2p/tcp": "^1.0.6",
+    "aegir": "^36.0.0",
+    "it-buffer": "^0.1.3",
+    "it-pipe": "^2.0.3",
+    "it-pushable": "^2.0.1",
+    "mocha": "^9.1.1",
+    "net": "^1.0.2",
+    "os": "^0.1.2",
+    "path": "^0.12.7",
+    "sinon": "^13.0.1",
+    "streaming-iterables": "^6.0.0",
+    "uint8arrays": "^3.0.0"
+  }
+}

package/src/dht.ts

@@ -0,0 +1,285 @@
+import { CID } from 'multiformats/cid'
+import { Multiaddr } from '@multiformats/multiaddr'
+import errcode from 'err-code'
+import {
+  Request,
+  Response,
+  DHTRequest,
+  DHTResponse
+} from '@libp2p/daemon-protocol'
+import type { DaemonClient } from './index.js'
+import { isPeerId, PeerId } from '@libp2p/interfaces/peer-id'
+import type { PeerData } from '@libp2p/interfaces/peer-data'
+import { peerIdFromBytes } from '@libp2p/peer-id'
+
+export class DHT {
+  private client: DaemonClient
+
+  constructor (client: DaemonClient) {
+    this.client = client
+  }
+
+  /**
+   * Write a value to a key in the DHT
+   */
+  async put (key: Uint8Array, value: Uint8Array): Promise<void> {
+    if (!(key instanceof Uint8Array)) {
+      throw errcode(new Error('invalid key received'), 'ERR_INVALID_KEY')
+    }
+
+    if (!(value instanceof Uint8Array)) {
+      throw errcode(new Error('value received is not a Uint8Array'), 'ERR_INVALID_VALUE')
+    }
+
+    const sh = await this.client.send({
+      type: Request.Type.DHT,
+      dht: {
+        type: DHTRequest.Type.PUT_VALUE,
+        key,
+        value
+      }
+    })
+
+    const message = await sh.read()
+    const response = Response.decode(message)
+
+    await sh.close()
+
+    if (response.type !== Response.Type.OK) {
+      throw errcode(new Error(response.error?.msg ?? 'DHT put failed'), 'ERR_DHT_PUT_FAILED')
+    }
+  }
+
+  /**
+   * Query the DHT for a value stored at a key in the DHT
+   */
+  async get (key: Uint8Array): Promise<Uint8Array> {
+    if (!(key instanceof Uint8Array)) {
+      throw errcode(new Error('invalid key received'), 'ERR_INVALID_KEY')
+    }
+
+    const sh = await this.client.send({
+      type: Request.Type.DHT,
+      dht: {
+        type: DHTRequest.Type.GET_VALUE,
+        key
+      }
+    })
+
+    const message = await sh.read()
+    const response = Response.decode(message)
+
+    await sh.close()
+
+    if (response.type !== Response.Type.OK) {
+      throw errcode(new Error(response.error?.msg ?? 'DHT get failed'), 'ERR_DHT_GET_FAILED')
+    }
+
+    if (response.dht == null || response.dht.value == null) {
+      throw errcode(new Error('Invalid DHT get response'), 'ERR_DHT_GET_FAILED')
+    }
+
+    return response.dht.value
+  }
+
+  /**
+   * Query the DHT for a given peer's known addresses.
+   *
+   * @param {PeerId} peerId
+   * @returns {PeerInfo}
+   */
+  async findPeer (peerId: PeerId): Promise<PeerData> {
+    if (!isPeerId(peerId)) {
+      throw errcode(new Error('invalid peer id received'), 'ERR_INVALID_PEER_ID')
+    }
+
+    const sh = await this.client.send({
+      type: Request.Type.DHT,
+      dht: {
+        type: DHTRequest.Type.FIND_PEER,
+        peer: peerId.toBytes()
+      }
+    })
+
+    const message = await sh.read()
+    const response = Response.decode(message)
+
+    await sh.close()
+
+    if (response.type !== Response.Type.OK) {
+      throw errcode(new Error(response.error?.msg ?? 'DHT find peer failed'), 'ERR_DHT_FIND_PEER_FAILED')
+    }
+
+    if (response.dht == null || response.dht.peer == null || response.dht.peer.addrs == null) {
+      throw errcode(new Error('Invalid response'), 'ERR_DHT_FIND_PEER_FAILED')
+    }
+
+    return {
+      id: peerIdFromBytes(response.dht.peer.id),
+      multiaddrs: response.dht.peer.addrs.map((a) => new Multiaddr(a)),
+      protocols: []
+    }
+  }
+
+  /**
+   * Announce to the network that the peer have data addressed by the provided CID
+   */
+  async provide (cid: CID) {
+    if (cid == null || CID.asCID(cid) == null) {
+      throw errcode(new Error('invalid cid received'), 'ERR_INVALID_CID')
+    }
+
+    const sh = await this.client.send({
+      type: Request.Type.DHT,
+      dht: {
+        type: DHTRequest.Type.PROVIDE,
+        cid: cid.bytes
+      }
+    })
+
+    const message = await sh.read()
+    const response = Response.decode(message)
+
+    await sh.close()
+
+    if (response.type !== Response.Type.OK) {
+      throw errcode(new Error(response.error?.msg ?? 'DHT provide failed'), 'ERR_DHT_PROVIDE_FAILED')
+    }
+  }
+
+  /**
+   * Query the DHT for peers that have a piece of content, identified by a CID
+   */
+  async * findProviders (cid: CID, count: number = 1): AsyncIterator<PeerData> {
+    if (cid == null || CID.asCID(cid) == null) {
+      throw errcode(new Error('invalid cid received'), 'ERR_INVALID_CID')
+    }
+
+    const sh = await this.client.send({
+      type: Request.Type.DHT,
+      dht: {
+        type: DHTRequest.Type.FIND_PROVIDERS,
+        cid: cid.bytes,
+        count
+      }
+    })
+
+    let message = await sh.read()
+
+    // stream begin message
+    let response = Response.decode(message)
+
+    if (response.type !== Response.Type.OK) {
+      await sh.close()
+      throw errcode(new Error(response.error?.msg || 'DHT find providers failed'), 'ERR_DHT_FIND_PROVIDERS_FAILED')
+    }
+
+    while (true) {
+      message = await sh.read()
+      const response = DHTResponse.decode(message)
+
+      // Stream end
+      if (response.type === DHTResponse.Type.END) {
+        await sh.close()
+        return
+      }
+
+      // Stream values
+      if (response.type === DHTResponse.Type.VALUE && response.peer != null && response.peer?.addrs != null) {
+        yield {
+          id: peerIdFromBytes(response.peer.id),
+          multiaddrs: response.peer.addrs.map((a) => new Multiaddr(a)),
+          protocols: []
+        }
+      } else {
+        // Unexpected message received
+        await sh.close()
+        throw errcode(new Error('unexpected message received'), 'ERR_UNEXPECTED_MESSAGE_RECEIVED')
+      }
+    }
+  }
+
+  /**
+   * Query the DHT routing table for peers that are closest to a provided key.
+   */
+  async * getClosestPeers (key: Uint8Array): AsyncIterable<PeerData> {
+    if (!(key instanceof Uint8Array)) {
+      throw errcode(new Error('invalid key received'), 'ERR_INVALID_KEY')
+    }
+
+    const sh = await this.client.send({
+      type: Request.Type.DHT,
+      dht: {
+        type: DHTRequest.Type.GET_CLOSEST_PEERS,
+        key
+      }
+    })
+
+    // stream begin message
+    let message = await sh.read()
+    let response = Response.decode(message)
+
+    if (response.type !== Response.Type.OK) {
+      await sh.close()
+      throw errcode(new Error(response.error?.msg ?? 'DHT find providers failed'), 'ERR_DHT_FIND_PROVIDERS_FAILED')
+    }
+
+    while (true) {
+      message = await sh.read()
+      const response = DHTResponse.decode(message)
+
+      // Stream end
+      if (response.type === DHTResponse.Type.END) {
+        await sh.close()
+        return
+      }
+
+      // Stream values
+      if (response.type === DHTResponse.Type.VALUE && response.value != null) {
+        const peerId = peerIdFromBytes(response.value)
+
+        yield {
+          id: peerId,
+          multiaddrs: [],
+          protocols: []
+        }
+      } else {
+        // Unexpected message received
+        await sh.close()
+        throw errcode(new Error('unexpected message received'), 'ERR_UNEXPECTED_MESSAGE_RECEIVED')
+      }
+    }
+  }
+
+  /**
+   * Query the DHT routing table for a given peer's public key.
+   */
+  async getPublicKey (peerId: PeerId) {
+    if (!isPeerId(peerId)) {
+      throw errcode(new Error('invalid peer id received'), 'ERR_INVALID_PEER_ID')
+    }
+
+    const sh = await this.client.send({
+      type: Request.Type.DHT,
+      dht: {
+        type: DHTRequest.Type.GET_PUBLIC_KEY,
+        peer: peerId.toBytes()
+      }
+    })
+
+    const message = await sh.read()
+    const response = Response.decode(message)
+
+    await sh.close()
+
+    if (response.type !== Response.Type.OK) {
+      throw errcode(new Error(response.error?.msg ?? 'DHT get public key failed'), 'ERR_DHT_GET_PUBLIC_KEY_FAILED')
+    }
+
+    if (response.dht == null) {
+      throw errcode(new Error('Invalid response'), 'ERR_DHT_GET_PUBLIC_KEY_FAILED')
+    }
+
+    return response.dht.value
+  }
+}