@libp2p/fetch 0.0.0-97ab31c0c

package/dist/src/pb/proto.d.ts

@@ -0,0 +1,28 @@
+import type { Codec } from 'protons-runtime';
+import type { Uint8ArrayList } from 'uint8arraylist';
+export interface FetchRequest {
+    identifier: string;
+}
+export declare namespace FetchRequest {
+    const codec: () => Codec<FetchRequest>;
+    const encode: (obj: Partial<FetchRequest>) => Uint8Array;
+    const decode: (buf: Uint8Array | Uint8ArrayList) => FetchRequest;
+}
+export interface FetchResponse {
+    status: FetchResponse.StatusCode;
+    data: Uint8Array;
+}
+export declare namespace FetchResponse {
+    enum StatusCode {
+        OK = "OK",
+        NOT_FOUND = "NOT_FOUND",
+        ERROR = "ERROR"
+    }
+    namespace StatusCode {
+        const codec: () => Codec<StatusCode>;
+    }
+    const codec: () => Codec<FetchResponse>;
+    const encode: (obj: Partial<FetchResponse>) => Uint8Array;
+    const decode: (buf: Uint8Array | Uint8ArrayList) => FetchResponse;
+}
+//# sourceMappingURL=proto.d.ts.map

package/dist/src/pb/proto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proto.d.ts","sourceRoot":"","sources":["../../../src/pb/proto.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,yBAAiB,YAAY,CAAC;IAGrB,MAAM,KAAK,QAAO,MAAM,YAAY,CAwC1C,CAAA;IAEM,MAAM,MAAM,QAAS,QAAQ,YAAY,CAAC,KAAG,UAEnD,CAAA;IAEM,MAAM,MAAM,QAAS,UAAU,GAAG,cAAc,KAAG,YAEzD,CAAA;CACF;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,aAAa,CAAC,UAAU,CAAA;IAChC,IAAI,EAAE,UAAU,CAAA;CACjB;AAED,yBAAiB,aAAa,CAAC;IAC7B,KAAY,UAAU;QACpB,EAAE,OAAO;QACT,SAAS,cAAc;QACvB,KAAK,UAAU;KAChB;IAQD,UAAiB,UAAU,CAAC;QACnB,MAAM,KAAK,QAAO,MAAM,UAAU,CAExC,CAAA;KACF;IAIM,MAAM,KAAK,QAAO,MAAM,aAAa,CAiD3C,CAAA;IAEM,MAAM,MAAM,QAAS,QAAQ,aAAa,CAAC,KAAG,UAEpD,CAAA;IAEM,MAAM,MAAM,QAAS,UAAU,GAAG,cAAc,KAAG,aAEzD,CAAA;CACF"}

package/dist/src/pb/proto.js

@@ -0,0 +1,120 @@
+/* eslint-disable import/export */
+/* eslint-disable complexity */
+/* eslint-disable @typescript-eslint/no-namespace */
+/* eslint-disable @typescript-eslint/no-unnecessary-boolean-literal-compare */
+/* eslint-disable @typescript-eslint/no-empty-interface */
+import { encodeMessage, decodeMessage, message, enumeration } from 'protons-runtime';
+export var FetchRequest;
+(function (FetchRequest) {
+    let _codec;
+    FetchRequest.codec = () => {
+        if (_codec == null) {
+            _codec = message((obj, w, opts = {}) => {
+                if (opts.lengthDelimited !== false) {
+                    w.fork();
+                }
+                if ((obj.identifier != null && obj.identifier !== '')) {
+                    w.uint32(10);
+                    w.string(obj.identifier);
+                }
+                if (opts.lengthDelimited !== false) {
+                    w.ldelim();
+                }
+            }, (reader, length) => {
+                const obj = {
+                    identifier: ''
+                };
+                const end = length == null ? reader.len : reader.pos + length;
+                while (reader.pos < end) {
+                    const tag = reader.uint32();
+                    switch (tag >>> 3) {
+                        case 1:
+                            obj.identifier = reader.string();
+                            break;
+                        default:
+                            reader.skipType(tag & 7);
+                            break;
+                    }
+                }
+                return obj;
+            });
+        }
+        return _codec;
+    };
+    FetchRequest.encode = (obj) => {
+        return encodeMessage(obj, FetchRequest.codec());
+    };
+    FetchRequest.decode = (buf) => {
+        return decodeMessage(buf, FetchRequest.codec());
+    };
+})(FetchRequest || (FetchRequest = {}));
+export var FetchResponse;
+(function (FetchResponse) {
+    let StatusCode;
+    (function (StatusCode) {
+        StatusCode["OK"] = "OK";
+        StatusCode["NOT_FOUND"] = "NOT_FOUND";
+        StatusCode["ERROR"] = "ERROR";
+    })(StatusCode = FetchResponse.StatusCode || (FetchResponse.StatusCode = {}));
+    let __StatusCodeValues;
+    (function (__StatusCodeValues) {
+        __StatusCodeValues[__StatusCodeValues["OK"] = 0] = "OK";
+        __StatusCodeValues[__StatusCodeValues["NOT_FOUND"] = 1] = "NOT_FOUND";
+        __StatusCodeValues[__StatusCodeValues["ERROR"] = 2] = "ERROR";
+    })(__StatusCodeValues || (__StatusCodeValues = {}));
+    (function (StatusCode) {
+        StatusCode.codec = () => {
+            return enumeration(__StatusCodeValues);
+        };
+    })(StatusCode = FetchResponse.StatusCode || (FetchResponse.StatusCode = {}));
+    let _codec;
+    FetchResponse.codec = () => {
+        if (_codec == null) {
+            _codec = message((obj, w, opts = {}) => {
+                if (opts.lengthDelimited !== false) {
+                    w.fork();
+                }
+                if (obj.status != null && __StatusCodeValues[obj.status] !== 0) {
+                    w.uint32(8);
+                    FetchResponse.StatusCode.codec().encode(obj.status, w);
+                }
+                if ((obj.data != null && obj.data.byteLength > 0)) {
+                    w.uint32(18);
+                    w.bytes(obj.data);
+                }
+                if (opts.lengthDelimited !== false) {
+                    w.ldelim();
+                }
+            }, (reader, length) => {
+                const obj = {
+                    status: StatusCode.OK,
+                    data: new Uint8Array(0)
+                };
+                const end = length == null ? reader.len : reader.pos + length;
+                while (reader.pos < end) {
+                    const tag = reader.uint32();
+                    switch (tag >>> 3) {
+                        case 1:
+                            obj.status = FetchResponse.StatusCode.codec().decode(reader);
+                            break;
+                        case 2:
+                            obj.data = reader.bytes();
+                            break;
+                        default:
+                            reader.skipType(tag & 7);
+                            break;
+                    }
+                }
+                return obj;
+            });
+        }
+        return _codec;
+    };
+    FetchResponse.encode = (obj) => {
+        return encodeMessage(obj, FetchResponse.codec());
+    };
+    FetchResponse.decode = (buf) => {
+        return decodeMessage(buf, FetchResponse.codec());
+    };
+})(FetchResponse || (FetchResponse = {}));
+//# sourceMappingURL=proto.js.map

package/dist/src/pb/proto.js.map

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

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@libp2p/fetch",
+  "version": "0.0.0-97ab31c0c",
+  "description": "Implementation of the Fetch Protocol",
+  "license": "Apache-2.0 OR MIT",
+  "homepage": "https://github.com/libp2p/js-libp2p/tree/master/packages/protocol-fetch#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/libp2p/js-libp2p.git"
+  },
+  "bugs": {
+    "url": "https://github.com/libp2p/js-libp2p/issues"
+  },
+  "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": {
+    "start": "node dist/src/main.js",
+    "build": "aegir build",
+    "test": "aegir test",
+    "clean": "aegir clean",
+    "generate": "protons ./src/pb/index.proto",
+    "lint": "aegir lint",
+    "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",
+    "dep-check": "aegir dep-check"
+  },
+  "dependencies": {
+    "@libp2p/interface": "0.1.6-97ab31c0c",
+    "@libp2p/interface-internal": "0.1.9-97ab31c0c",
+    "it-protobuf-stream": "^1.0.2",
+    "protons-runtime": "^5.0.0",
+    "uint8arraylist": "^2.4.3",
+    "uint8arrays": "^4.0.6"
+  },
+  "devDependencies": {
+    "@libp2p/logger": "3.1.0-97ab31c0c",
+    "@libp2p/peer-id-factory": "3.0.8-97ab31c0c",
+    "aegir": "^41.0.2",
+    "it-pair": "^2.0.6",
+    "protons": "^7.3.0",
+    "sinon": "^17.0.0",
+    "sinon-ts": "^2.0.0"
+  }
+}

package/src/constants.ts

@@ -0,0 +1,3 @@
+// https://github.com/libp2p/specs/tree/master/fetch#wire-protocol
+export const PROTOCOL_VERSION = '0.0.1'
+export const PROTOCOL_NAME = 'fetch'

package/src/fetch.ts

@@ -0,0 +1,236 @@
+import { CodeError, ERR_INVALID_MESSAGE, ERR_INVALID_PARAMETERS, ERR_TIMEOUT } from '@libp2p/interface/errors'
+import { setMaxListeners } from '@libp2p/interface/events'
+import { pbStream } from 'it-protobuf-stream'
+import { fromString as uint8arrayFromString } from 'uint8arrays/from-string'
+import { toString as uint8arrayToString } from 'uint8arrays/to-string'
+import { PROTOCOL_NAME, PROTOCOL_VERSION } from './constants.js'
+import { FetchRequest, FetchResponse } from './pb/proto.js'
+import type { Fetch as FetchInterface, FetchComponents, FetchInit, LookupFunction } from './index.js'
+import type { AbortOptions, Logger } from '@libp2p/interface'
+import type { Stream } from '@libp2p/interface/connection'
+import type { PeerId } from '@libp2p/interface/peer-id'
+import type { Startable } from '@libp2p/interface/startable'
+import type { IncomingStreamData } from '@libp2p/interface-internal/registrar'
+
+const DEFAULT_TIMEOUT = 10000
+
+/**
+ * A simple libp2p protocol for requesting a value corresponding to a key from a peer.
+ * Developers can register one or more lookup function for retrieving the value corresponding to
+ * a given key.  Each lookup function must act on a distinct part of the overall key space, defined
+ * by a fixed prefix that all keys that should be routed to that lookup function will start with.
+ */
+export class Fetch implements Startable, FetchInterface {
+  public readonly protocol: string
+  private readonly components: FetchComponents
+  private readonly lookupFunctions: Map<string, LookupFunction>
+  private started: boolean
+  private readonly init: FetchInit
+  private readonly log: Logger
+
+  constructor (components: FetchComponents, init: FetchInit = {}) {
+    this.log = components.logger.forComponent('libp2p:fetch')
+    this.started = false
+    this.components = components
+    this.protocol = `/${init.protocolPrefix ?? 'libp2p'}/${PROTOCOL_NAME}/${PROTOCOL_VERSION}`
+    this.lookupFunctions = new Map() // Maps key prefix to value lookup function
+    this.handleMessage = this.handleMessage.bind(this)
+    this.init = init
+  }
+
+  async start (): Promise<void> {
+    await this.components.registrar.handle(this.protocol, (data) => {
+      void this.handleMessage(data)
+        .then(async () => {
+          await data.stream.close()
+        })
+        .catch(err => {
+          this.log.error(err)
+        })
+    }, {
+      maxInboundStreams: this.init.maxInboundStreams,
+      maxOutboundStreams: this.init.maxOutboundStreams
+    })
+    this.started = true
+  }
+
+  async stop (): Promise<void> {
+    await this.components.registrar.unhandle(this.protocol)
+    this.started = false
+  }
+
+  isStarted (): boolean {
+    return this.started
+  }
+
+  /**
+   * Sends a request to fetch the value associated with the given key from the given peer
+   */
+  async fetch (peer: PeerId, key: string, options: AbortOptions = {}): Promise<Uint8Array | undefined> {
+    this.log('dialing %s to %p', this.protocol, peer)
+
+    const connection = await this.components.connectionManager.openConnection(peer, options)
+    let signal = options.signal
+    let stream: Stream | undefined
+    let onAbort = (): void => {}
+
+    // create a timeout if no abort signal passed
+    if (signal == null) {
+      this.log('using default timeout of %d ms', this.init.timeout)
+      signal = AbortSignal.timeout(this.init.timeout ?? DEFAULT_TIMEOUT)
+
+      setMaxListeners(Infinity, signal)
+    }
+
+    try {
+      stream = await connection.newStream(this.protocol, {
+        signal
+      })
+
+      onAbort = () => {
+        stream?.abort(new CodeError('fetch timeout', ERR_TIMEOUT))
+      }
+
+      // make stream abortable
+      signal.addEventListener('abort', onAbort, { once: true })
+
+      this.log('fetch %s', key)
+
+      const pb = pbStream(stream)
+      await pb.write({
+        identifier: key
+      }, FetchRequest, options)
+
+      const response = await pb.read(FetchResponse, options)
+      await pb.unwrap().close(options)
+
+      switch (response.status) {
+        case (FetchResponse.StatusCode.OK): {
+          this.log('received status for %s ok', key)
+          return response.data
+        }
+        case (FetchResponse.StatusCode.NOT_FOUND): {
+          this.log('received status for %s not found', key)
+          return
+        }
+        case (FetchResponse.StatusCode.ERROR): {
+          this.log('received status for %s error', key)
+          const errmsg = uint8arrayToString(response.data)
+          throw new CodeError('Error in fetch protocol response: ' + errmsg, ERR_INVALID_PARAMETERS)
+        }
+        default: {
+          this.log('received status for %s unknown', key)
+          throw new CodeError('Unknown response status', ERR_INVALID_MESSAGE)
+        }
+      }
+    } catch (err: any) {
+      stream?.abort(err)
+      throw err
+    } finally {
+      signal.removeEventListener('abort', onAbort)
+      if (stream != null) {
+        await stream.close()
+      }
+    }
+  }
+
+  /**
+   * Invoked when a fetch request is received.  Reads the request message off the given stream and
+   * responds based on looking up the key in the request via the lookup callback that corresponds
+   * to the key's prefix.
+   */
+  async handleMessage (data: IncomingStreamData): Promise<void> {
+    const { stream } = data
+    const signal = AbortSignal.timeout(this.init.timeout ?? DEFAULT_TIMEOUT)
+
+    try {
+      const pb = pbStream(stream)
+      const request = await pb.read(FetchRequest, {
+        signal
+      })
+
+      let response: FetchResponse
+      const lookup = this._getLookupFunction(request.identifier)
+      if (lookup != null) {
+        this.log('look up data with identifier %s', request.identifier)
+        const data = await lookup(request.identifier)
+        if (data != null) {
+          this.log('sending status for %s ok', request.identifier)
+          response = { status: FetchResponse.StatusCode.OK, data }
+        } else {
+          this.log('sending status for %s not found', request.identifier)
+          response = { status: FetchResponse.StatusCode.NOT_FOUND, data: new Uint8Array(0) }
+        }
+      } else {
+        this.log('sending status for %s error', request.identifier)
+        const errmsg = uint8arrayFromString(`No lookup function registered for key: ${request.identifier}`)
+        response = { status: FetchResponse.StatusCode.ERROR, data: errmsg }
+      }
+
+      await pb.write(response, FetchResponse, {
+        signal
+      })
+
+      await pb.unwrap().close({
+        signal
+      })
+    } catch (err: any) {
+      this.log('error answering fetch request', err)
+      stream.abort(err)
+    }
+  }
+
+  /**
+   * Given a key, finds the appropriate function for looking up its corresponding value, based on
+   * the key's prefix.
+   */
+  _getLookupFunction (key: string): LookupFunction | undefined {
+    for (const prefix of this.lookupFunctions.keys()) {
+      if (key.startsWith(prefix)) {
+        return this.lookupFunctions.get(prefix)
+      }
+    }
+  }
+
+  /**
+   * Registers a new lookup callback that can map keys to values, for a given set of keys that
+   * share the same prefix
+   *
+   * @example
+   *
+   * ```js
+   * // ...
+   * libp2p.fetchService.registerLookupFunction('/prefix', (key) => { ... })
+   * ```
+   */
+  registerLookupFunction (prefix: string, lookup: LookupFunction): void {
+    if (this.lookupFunctions.has(prefix)) {
+      throw new CodeError(`Fetch protocol handler for key prefix '${prefix}' already registered`, 'ERR_KEY_ALREADY_EXISTS')
+    }
+
+    this.lookupFunctions.set(prefix, lookup)
+  }
+
+  /**
+   * Registers a new lookup callback that can map keys to values, for a given set of keys that
+   * share the same prefix.
+   *
+   * @example
+   *
+   * ```js
+   * // ...
+   * libp2p.fetchService.unregisterLookupFunction('/prefix')
+   * ```
+   */
+  unregisterLookupFunction (prefix: string, lookup?: LookupFunction): void {
+    if (lookup != null) {
+      const existingLookup = this.lookupFunctions.get(prefix)
+
+      if (existingLookup !== lookup) {
+        return
+      }
+    }
+
+    this.lookupFunctions.delete(prefix)
+  }
+}

package/src/index.ts

@@ -0,0 +1,98 @@
+/**
+ * @packageDocumentation
+ *
+ * An implementation of the Fetch protocol as described here: https://github.com/libp2p/specs/tree/master/fetch
+ *
+ * The fetch protocol is a simple protocol for requesting a value corresponding to a key from a peer.
+ *
+ * @example
+ *
+ * ```typescript
+ * import { createLibp2p } from 'libp2p'
+ * import { fetch } from '@libp2p/fetch'
+ *
+ * const libp2p = await createLibp2p({
+ *   services: {
+ *     fetch: fetch()
+ *   }
+ * })
+ *
+ * // Given a key (as a string) returns a value (as a Uint8Array), or null if the key isn't found.
+ * // All keys must be prefixed my the same prefix, which will be used to find the appropriate key
+ * // lookup function.
+ * async function my_subsystem_key_lookup(key) {
+ *   // app specific callback to lookup key-value pairs.
+ * }
+ *
+ * // Enable this peer to respond to fetch requests for keys that begin with '/my_subsystem_key_prefix/'
+ * libp2p.fetch.registerLookupFunction('/my_subsystem_key_prefix/', my_subsystem_key_lookup)
+ *
+ * const key = '/my_subsystem_key_prefix/{...}'
+ * const peerDst = PeerId.parse('Qmfoo...') // or Multiaddr instance
+ * const value = await libp2p.fetch(peerDst, key)
+ * ```
+ */
+
+import { Fetch as FetchClass } from './fetch.js'
+import type { AbortOptions, ComponentLogger } from '@libp2p/interface'
+import type { PeerId } from '@libp2p/interface/peer-id'
+import type { ConnectionManager } from '@libp2p/interface-internal/connection-manager'
+import type { Registrar } from '@libp2p/interface-internal/registrar'
+
+export interface FetchInit {
+  protocolPrefix?: string
+  maxInboundStreams?: number
+  maxOutboundStreams?: number
+
+  /**
+   * How long we should wait for a remote peer to send any data
+   */
+  timeout?: number
+}
+
+export interface LookupFunction {
+  (key: string): Promise<Uint8Array | undefined>
+}
+
+export interface FetchComponents {
+  registrar: Registrar
+  connectionManager: ConnectionManager
+  logger: ComponentLogger
+}
+
+export interface Fetch {
+  /**
+   * Sends a request to fetch the value associated with the given key from the given peer
+   */
+  fetch(peer: PeerId, key: string, options?: AbortOptions): Promise<Uint8Array | undefined>
+
+  /**
+   * Registers a new lookup callback that can map keys to values, for a given set of keys that
+   * share the same prefix
+   *
+   * @example
+   *
+   * ```js
+   * // ...
+   * libp2p.fetchService.registerLookupFunction('/prefix', (key) => { ... })
+   * ```
+   */
+  registerLookupFunction(prefix: string, lookup: LookupFunction): void
+
+  /**
+   * Registers a new lookup callback that can map keys to values, for a given set of keys that
+   * share the same prefix.
+   *
+   * @example
+   *
+   * ```js
+   * // ...
+   * libp2p.fetchService.unregisterLookupFunction('/prefix')
+   * ```
+   */
+  unregisterLookupFunction(prefix: string, lookup?: LookupFunction): void
+}
+
+export function fetch (init: FetchInit = {}): (components: FetchComponents) => Fetch {
+  return (components) => new FetchClass(components, init)
+}

package/src/pb/proto.proto

@@ -0,0 +1,15 @@
+syntax = "proto3";
+
+message FetchRequest {
+	string identifier = 1;
+}
+
+message FetchResponse {
+	StatusCode status = 1;
+	enum StatusCode {
+		OK = 0;
+		NOT_FOUND = 1;
+		ERROR = 2;
+	}
+	bytes data = 2;
+}