@helia/utils 2.5.2-1361bfa5 → 2.5.2-16d805e1

package/src/index.ts

@@ -1,368 +1,5 @@
-/**
- * @packageDocumentation
- *
- * This module contains utility code that is shared between various Helia
- * modules such as `helia`, `@helia/http`, etc.
- */
-
-import { keychain } from '@ipshipyard/keychain'
-import { start, stop, TypedEventEmitter } from '@libp2p/interface'
-import { dns } from '@multiformats/dns'
-import { defaultLogger } from 'birnam'
-import { MemoryBlockstore } from 'blockstore-core'
-import { MemoryDatastore } from 'datastore-core'
-import drain from 'it-drain'
-import { CustomProgressEvent } from 'progress-events'
-import { PinsImpl } from './pins.ts'
-import { Routing as RoutingClass } from './routing.ts'
-import { BlockStorage } from './storage.ts'
-import { assertDatastoreVersionIsCurrent } from './utils/datastore-version.ts'
-import { getCodec } from './utils/get-codec.ts'
-import { getCrypto } from './utils/get-crypto.ts'
-import { getHasher } from './utils/get-hasher.ts'
-import { NetworkedStorage } from './utils/networked-storage.ts'
-import type { BlockStorageInit } from './storage.ts'
-import type { CodecLoader, GCOptions, HasherLoader, Helia as HeliaInterface, HeliaEvents, Routing, CryptoLoader, Crypto, NodeInfo, Router, HeliaMixin } from '@helia/interface'
-import type { BlockBroker } from '@helia/interface'
-import type { Pins } from '@helia/interface'
-import type { Keychain, KeychainInit } from '@ipshipyard/keychain'
-import type { ComponentLogger, Logger, Metrics } from '@libp2p/interface'
-import type { DNS } from '@multiformats/dns'
-import type { Blockstore } from 'interface-blockstore'
-import type { Datastore } from 'interface-datastore'
-import type { BlockCodec } from 'multiformats'
-import type { CID } from 'multiformats/cid'
-import type { MultihashHasher } from 'multiformats/hashes/interface'
-
-export { AbstractSession } from './abstract-session.ts'
-export type { AbstractCreateSessionOptions, BlockstoreSessionEvents, AbstractSessionComponents } from './abstract-session.ts'
-
-export { isCID } from './utils/is-cid.ts'
-
-export type { BlockStorage, BlockStorageInit }
-
-export { breadthFirstWalker, depthFirstWalker, naturalOrderWalker } from './graph-walker.ts'
-export type { GraphWalkerComponents, GraphWalkerInit, GraphNode, GraphWalker } from './graph-walker.ts'
-
-/**
- * Options used to create a Helia node.
- */
-export interface HeliaInit {
-  /**
-   * By default Helia stores the node's PeerId in an encrypted form in a
-   * libp2p keystore. These options control how that keystore is configured.
-   */
-  keychain?: KeychainInit
-
-  /**
-   * The blockstore is where blocks are stored
-   */
-  blockstore?: Blockstore
-
-  /**
-   * The datastore is where data is stored
-   */
-  datastore?: Datastore
-
-  /**
-   * By default sha256, sha512 and identity hashes are supported for
-   * bitswap operations. To bitswap blocks with CIDs using other hashes
-   * pass appropriate MultihashHashers here.
-   */
-  hashers?: MultihashHasher[]
-
-  /**
-   * An optional function that can load a MultihashHasher on demand. May return
-   * a promise.
-   */
-  loadHasher?(code: number): MultihashHasher | Promise<MultihashHasher>
-
-  /**
-   * In order to pin CIDs that correspond to a DAG, it's necessary to know
-   * how to traverse that DAG.  DAGWalkers take a block and yield any CIDs
-   * encoded within that block.
-   */
-  codecs?: Array<BlockCodec<any, any>>
-
-  /**
-   * An optional function that can load a BlockCodec on demand. May return a
-   * promise.
-   */
-  loadCodec?(code: number): BlockCodec<any, any> | Promise<BlockCodec<any, any>>
-
-  /**
-   * A list of pre-supported public/private key implementations
-   */
-  cryptos?: Array<Crypto>
-
-  /**
-   * Dynamically load a cryptography implementation
-   */
-  loadCrypto?: CryptoLoader
-
-  /**
-   * Garbage collection requires preventing blockstore writes during searches
-   * for unpinned blocks as DAGs are typically pinned after they've been
-   * imported - without locking this could lead to the deletion of blocks while
-   * they are being added to the blockstore.
-   *
-   * By default this lock is held on the current process and other processes
-   * will contact this process for access.
-   *
-   * If Helia is being run in multiple processes, one process must hold the GC
-   * lock so use this option to control which process that is.
-   *
-   * @default true
-   */
-  holdGcLock?: boolean
-
-  /**
-   * An optional logging component to pass to libp2p. If not specified the
-   * default implementation from libp2p will be used.
-   */
-  logger?: ComponentLogger
-
-  /**
-   * A list of strategies used to fetch blocks when they are not present in
-   * the local blockstore
-   */
-  blockBrokers?: Array<BlockBroker | ((components: any) => BlockBroker)>
-
-  /**
-   * Routers perform operations such as looking up content providers,
-   * information about network peers or getting/putting records.
-   */
-  routers?: Array<Router | ((components: any) => Router)>
-
-  /**
-   * During provider lookups, peers can be returned from routing implementations
-   * with no multiaddrs.
-   *
-   * This can happen when they've been retrieved from network peers that only
-   * store multiaddrs for a limited amount of time.
-   *
-   * When this happens the peer's info has to be looked up with a further query.
-   *
-   * To not have this query block the yielding of other providers returned with
-   * multiaddrs, a separate queue is used to perform this lookup.
-   *
-   * This config value controls the concurrency of that queue.
-   *
-   * @default 5
-   */
-  providerLookupConcurrency?: number
-
-  /**
-   * Components used by subclasses
-   */
-  components?: Record<string, any>
-
-  /**
-   * An optional DNS implementation used to perform queries for DNS records.
-   */
-  dns?: DNS
-
-  /**
-   * A metrics object that can be used to collected arbitrary stats about node
-   * usage.
-   */
-  metrics?: Metrics
-
-  /**
-   * Limit the maximum supported size of identity hash digests to this value
-   *
-   * @default 128
-   */
-  maxIdentityHashDigestLength?: number
-}
-
-interface Components {
-  blockstore: Blockstore
-  datastore: Datastore
-  logger: ComponentLogger
-  blockBrokers: BlockBroker[]
-  routing: Routing
-  dns: DNS
-  keychain: Keychain
-  metrics?: Metrics
-  getCodec: CodecLoader
-  getHasher: HasherLoader
-  getCrypto: CryptoLoader
-}
-
-export class Helia implements HeliaInterface {
-  public info: NodeInfo
-  public blockstore: BlockStorage
-  public datastore: Datastore
-  public events: TypedEventEmitter<HeliaEvents<this>>
-  public pins: Pins
-  public logger: ComponentLogger
-  public routing: RoutingClass
-  public getCodec: CodecLoader
-  public getHasher: HasherLoader
-  public getCrypto: CryptoLoader
-  public dns: DNS
-  public keychain: Keychain
-  public metrics?: Metrics
-  public status: 'stopped' | 'stopping' | 'starting' | 'started'
-  private readonly log: Logger
-  private readonly blockBrokers: BlockBroker[]
-  private readonly mixins: HeliaMixin[]
-
-  constructor (init: HeliaInit & { name: string, version: string }) {
-    this.info = {
-      name: init.name,
-      version: init.version
-    }
-    this.logger = init.logger ?? defaultLogger()
-    this.log = this.logger.forComponent('helia')
-    this.getHasher = getHasher(init.hashers, init.loadHasher)
-    this.getCodec = getCodec(init.codecs, init.loadCodec)
-    this.getCrypto = getCrypto(init.cryptos, init.loadCrypto)
-    this.dns = init.dns ?? dns()
-    this.metrics = init.metrics
-    this.events = new TypedEventEmitter<HeliaEvents<typeof this>>()
-    this.status = 'stopped'
-    this.mixins = []
-
-    // @ts-expect-error routing and keychain are not set
-    const components: Components = {
-      blockstore: init.blockstore ?? new MemoryBlockstore(),
-      datastore: init.datastore ?? new MemoryDatastore(),
-      logger: this.logger,
-      blockBrokers: [],
-      getHasher: this.getHasher,
-      getCodec: this.getCodec,
-      getCrypto: this.getCrypto,
-      dns: this.dns,
-      metrics: this.metrics,
-      ...(init.components ?? {})
-    }
-
-    this.keychain = components.keychain = keychain()(components)
-
-    this.routing = components.routing = new RoutingClass(components, {
-      routers: (init.routers ?? []).flatMap((router: Router | ((components: any) => Router)) => {
-        if (typeof router === 'function') {
-          router = router(components)
-        }
-
-        // if the router itself is a router
-        const routers = [
-          router
-        ]
-
-        return routers
-      }),
-      providerLookupConcurrency: init.providerLookupConcurrency
-    })
-
-    this.blockBrokers = components.blockBrokers = (init.blockBrokers ?? []).map((broker) => {
-      if (typeof broker === 'function') {
-        broker = broker(components)
-      }
-
-      return broker
-    })
-
-    const networkedStorage = new NetworkedStorage(components, init)
-    this.pins = new PinsImpl(components.datastore, networkedStorage, this.getCodec)
-    this.blockstore = new BlockStorage(networkedStorage, this.pins, this.routing, {
-      holdGcLock: init.holdGcLock ?? true
-    })
-    this.datastore = components.datastore
-  }
-
-  hasRouter (name: string): boolean {
-    return this.routing.hasRouter(name)
-  }
-
-  addRouter (router: Router): void {
-    this.routing.addRouter(router)
-  }
-
-  hasBlockBroker (name: string): boolean {
-    return this.blockBrokers.findIndex(b => b.name === name) !== -1
-  }
-
-  addBlockBroker (blockBroker: BlockBroker): void {
-    this.blockBrokers.push(blockBroker)
-  }
-
-  addMixin (mixin: HeliaMixin): void {
-    this.mixins.push(mixin)
-  }
-
-  async start (): Promise<this> {
-    this.status = 'starting'
-
-    await assertDatastoreVersionIsCurrent(this.datastore)
-    await start(
-      this.blockstore,
-      this.datastore,
-      this.routing,
-      ...this.blockBrokers
-    )
-
-    for (const mixin of this.mixins) {
-      await mixin.start?.(this)
-    }
-
-    this.status = 'started'
-    this.events.dispatchEvent(new CustomEvent('start', { detail: this }))
-
-    return this
-  }
-
-  async stop (): Promise<this> {
-    this.status = 'stopping'
-
-    for (const mixin of this.mixins) {
-      await mixin.stop?.(this)
-    }
-
-    await stop(
-      this.blockstore,
-      this.datastore,
-      this.routing,
-      ...this.blockBrokers
-    )
-
-    this.status = 'stopped'
-    this.events.dispatchEvent(new CustomEvent('stop', { detail: this }))
-
-    return this
-  }
-
-  async gc (options: GCOptions = {}): Promise<void> {
-    const releaseLock = await this.blockstore.lock.writeLock()
-
-    try {
-      const helia = this
-      const blockstore = this.blockstore.unwrap()
-
-      this.log('gc start')
-
-      await drain(blockstore.deleteMany((async function * (): AsyncGenerator<CID> {
-        for await (const { cid } of blockstore.getAll()) {
-          try {
-            if (await helia.pins.isPinned(cid, options)) {
-              continue
-            }
-
-            yield cid
-
-            options.onProgress?.(new CustomProgressEvent<CID>('helia:gc:deleted', cid))
-          } catch (err: any) {
-            helia.log.error('error during gc - %e', err)
-            options.onProgress?.(new CustomProgressEvent<Error>('helia:gc:error', err))
-          }
-        }
-      }())))
-    } finally {
-      releaseLock()
-    }
-
-    this.log('gc finished')
-  }
-}
+export * from './abstract-session.ts'
+export * from './errors.ts'
+export * from './graph-walker.ts'
+export * from './is-cid.ts'
+export * from './is-promise.ts'

package/dist/src/pins.d.ts

@@ -1,21 +0,0 @@
-import { CID } from 'multiformats/cid';
-import type { CodecLoader } from '@helia/interface';
-import type { AddOptions, IsPinnedOptions, LsOptions, Pin, Pins, RmOptions } from '@helia/interface';
-import type { AbortOptions } from '@libp2p/interface';
-import type { Blockstore } from 'interface-blockstore';
-import type { Datastore } from 'interface-datastore';
-import type { Version } from 'multiformats/cid';
-export declare class PinsImpl implements Pins {
-    #private;
-    private readonly datastore;
-    private readonly blockstore;
-    private readonly getCodec;
-    constructor(datastore: Datastore, blockstore: Blockstore, getCodec: CodecLoader);
-    add(cid: CID<unknown, number, number, Version>, options?: AddOptions): AsyncGenerator<CID, void, undefined>;
-    rm(cid: CID<unknown, number, number, Version>, options?: RmOptions): AsyncGenerator<CID, void, undefined>;
-    ls(options?: LsOptions): AsyncGenerator<Pin, void, undefined>;
-    isPinned(cid: CID, options?: IsPinnedOptions): Promise<boolean>;
-    get(cid: CID, options?: AbortOptions): Promise<Pin>;
-    setMetadata(cid: CID, metadata: Record<string, string | number | boolean> | undefined, options?: AbortOptions): Promise<void>;
-}
-//# sourceMappingURL=pins.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"pins.d.ts","sourceRoot":"","sources":["../../src/pins.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAKtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACpG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AA0C/C,qBAAa,QAAS,YAAW,IAAI;;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;gBAEzB,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW;IAMxE,GAAG,CAAE,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAE,UAAe,GAAG,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC;IA8EhH,EAAE,CAAE,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAE,SAAc,GAAG,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC;IA2B9G,EAAE,CAAE,OAAO,GAAE,SAAc,GAAG,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC;IAcpE,QAAQ,CAAE,GAAG,EAAE,GAAG,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAMpE,GAAG,CAAE,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC;IAOpD,WAAW,CAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CASrI"}

package/dist/src/pins.js

@@ -1,141 +0,0 @@
-import { InvalidParametersError } from '@libp2p/interface';
-import * as cborg from 'cborg';
-import { Key } from 'interface-datastore';
-import { base36 } from 'multiformats/bases/base36';
-import { CID } from 'multiformats/cid';
-import { CustomProgressEvent } from 'progress-events';
-import { equals as uint8ArrayEquals } from 'uint8arrays/equals';
-import { AlreadyPinnedError } from "./errors.js";
-import { depthFirstWalker } from "./graph-walker.js";
-const DATASTORE_PIN_PREFIX = '/pin/';
-const DATASTORE_BLOCK_PREFIX = '/pinned-block/';
-const DATASTORE_ENCODING = base36;
-function toDSKey(cid) {
-    if (cid.version === 0) {
-        cid = cid.toV1();
-    }
-    return new Key(`${DATASTORE_PIN_PREFIX}${cid.toString(DATASTORE_ENCODING)}`);
-}
-export class PinsImpl {
-    datastore;
-    blockstore;
-    getCodec;
-    constructor(datastore, blockstore, getCodec) {
-        this.datastore = datastore;
-        this.blockstore = blockstore;
-        this.getCodec = getCodec;
-    }
-    async *add(cid, options = {}) {
-        const pinKey = toDSKey(cid);
-        if (await this.datastore.has(pinKey)) {
-            throw new AlreadyPinnedError('Already pinned');
-        }
-        const depth = Math.round(options.depth ?? Infinity);
-        if (depth < 0) {
-            throw new InvalidParametersError('Depth must be greater than or equal to 0');
-        }
-        const walker = (options.walker ?? depthFirstWalker())({
-            blockstore: this.blockstore,
-            getCodec: this.getCodec
-        });
-        for await (const node of walker.walk(cid, { ...options, depth })) {
-            const childCid = node.block.cid;
-            await this.#updatePinnedBlock(childCid, (pinnedBlock) => {
-                // do not update pinned block if this block is already pinned by this CID
-                if (pinnedBlock.pinnedBy.find(c => uint8ArrayEquals(c, cid.bytes)) != null) {
-                    return false;
-                }
-                pinnedBlock.pinCount++;
-                pinnedBlock.pinnedBy.push(cid.bytes);
-                return true;
-            }, options);
-            yield childCid;
-        }
-        const pin = {
-            depth,
-            metadata: options.metadata ?? {}
-        };
-        await this.datastore.put(pinKey, cborg.encode(pin), options);
-    }
-    /**
-     * Update the pin count for the CID
-     */
-    async #updatePinnedBlock(cid, withPinnedBlock, options) {
-        const blockKey = new Key(`${DATASTORE_BLOCK_PREFIX}${DATASTORE_ENCODING.encode(cid.multihash.bytes)}`);
-        let pinnedBlock = {
-            pinCount: 0,
-            pinnedBy: []
-        };
-        try {
-            pinnedBlock = cborg.decode(await this.datastore.get(blockKey, options));
-        }
-        catch (err) {
-            if (err.name !== 'NotFoundError') {
-                throw err;
-            }
-        }
-        const shouldContinue = withPinnedBlock(pinnedBlock);
-        if (!shouldContinue) {
-            return;
-        }
-        if (pinnedBlock.pinCount === 0) {
-            if (await this.datastore.has(blockKey)) {
-                await this.datastore.delete(blockKey);
-                return;
-            }
-        }
-        await this.datastore.put(blockKey, cborg.encode(pinnedBlock), options);
-        options.onProgress?.(new CustomProgressEvent('helia:pin:add', cid));
-    }
-    async *rm(cid, options = {}) {
-        const pinKey = toDSKey(cid);
-        const buf = await this.datastore.get(pinKey, options);
-        const pin = cborg.decode(buf);
-        await this.datastore.delete(pinKey, options);
-        const walker = (options.walker ?? depthFirstWalker())({
-            blockstore: this.blockstore,
-            getCodec: this.getCodec
-        });
-        for await (const node of walker.walk(cid, { ...options, depth: pin.depth })) {
-            const childCid = node.block.cid;
-            await this.#updatePinnedBlock(childCid, (pinnedBlock) => {
-                pinnedBlock.pinCount--;
-                pinnedBlock.pinnedBy = pinnedBlock.pinnedBy.filter(c => uint8ArrayEquals(c, cid.bytes));
-                return true;
-            }, {
-                ...options,
-                depth: pin.depth
-            });
-            yield childCid;
-        }
-    }
-    async *ls(options = {}) {
-        for await (const { key, value } of this.datastore.query({
-            prefix: DATASTORE_PIN_PREFIX + (options.cid != null ? `${options.cid.toString(base36)}` : '')
-        }, options)) {
-            const cid = CID.parse(key.toString().substring(5), base36);
-            const pin = cborg.decode(value);
-            yield {
-                cid,
-                ...pin
-            };
-        }
-    }
-    async isPinned(cid, options = {}) {
-        const blockKey = new Key(`${DATASTORE_BLOCK_PREFIX}${DATASTORE_ENCODING.encode(cid.multihash.bytes)}`);
-        return this.datastore.has(blockKey, options);
-    }
-    async get(cid, options) {
-        const pinKey = toDSKey(cid);
-        const buf = await this.datastore.get(pinKey, options);
-        return cborg.decode(buf);
-    }
-    async setMetadata(cid, metadata, options) {
-        const pinKey = toDSKey(cid);
-        const buf = await this.datastore.get(pinKey, options);
-        const pin = cborg.decode(buf);
-        pin.metadata = metadata ?? {};
-        await this.datastore.put(pinKey, cborg.encode(pin), options);
-    }
-}
-//# sourceMappingURL=pins.js.map

package/dist/src/pins.js.map

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

package/dist/src/routing.d.ts

@@ -1,51 +0,0 @@
-import type { Routing as RoutingInterface, Provider, RoutingOptions, RoutingFindProvidersProgressEvents, RoutingProvideProgressEvents, RoutingPutProgressEvents, RoutingGetProgressEvents, RoutingFindPeerProgressEvents, RoutingGetClosestPeersProgressEvents, RoutingCancelReprovideProgressEvents, Router, Peer } from '@helia/interface';
-import type { ComponentLogger, Metrics, Startable } from '@libp2p/interface';
-import type { CID } from 'multiformats/cid';
-export interface RoutingInit {
-    routers: Router[];
-    providerLookupConcurrency?: number;
-}
-export interface RoutingComponents {
-    logger: ComponentLogger;
-    metrics?: Metrics;
-}
-export declare class Routing implements RoutingInterface, Startable {
-    name: string;
-    private readonly log;
-    private readonly routers;
-    private readonly providerLookupConcurrency;
-    constructor(components: RoutingComponents, init: RoutingInit);
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    hasRouter(name: string): boolean;
-    addRouter(router: Router): void;
-    /**
-     * Iterates over all content routers in parallel to find providers of the
-     * given key
-     */
-    findProviders(key: CID, options?: RoutingOptions<RoutingFindProvidersProgressEvents>): AsyncIterable<Provider>;
-    /**
-     * Iterates over all content routers in parallel to notify it is
-     * a provider of the given key
-     */
-    provide(key: CID, options?: RoutingOptions<RoutingProvideProgressEvents>): Promise<void>;
-    cancelReprovide(key: CID, options?: RoutingOptions<RoutingCancelReprovideProgressEvents>): Promise<void>;
-    /**
-     * Store the given key/value pair in the available content routings
-     */
-    put(key: Uint8Array, value: Uint8Array, options?: RoutingOptions<RoutingPutProgressEvents>): Promise<void>;
-    /**
-     * Get the value to the given key. The first value offered by any configured
-     * router will be returned.
-     */
-    get(key: Uint8Array, options?: RoutingOptions<RoutingGetProgressEvents>): Promise<Uint8Array>;
-    /**
-     * Iterates over all peer routers in parallel to find the given peer
-     */
-    findPeer(id: CID, options?: RoutingOptions<RoutingFindPeerProgressEvents>): Promise<Peer>;
-    /**
-     * Attempt to find the closest peers on the network to the given key
-     */
-    getClosestPeers(key: Uint8Array, options?: RoutingOptions<RoutingGetClosestPeersProgressEvents>): AsyncIterable<Peer>;
-}
-//# sourceMappingURL=routing.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/routing.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,IAAI,gBAAgB,EAAE,QAAQ,EAAE,cAAc,EAAE,kCAAkC,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,6BAA6B,EAAE,oCAAoC,EAAE,oCAAoC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAC5U,OAAO,KAAK,EAAE,eAAe,EAAU,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAEpF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAI3C,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,yBAAyB,CAAC,EAAE,MAAM,CAAA;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,eAAe,CAAA;IACvB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAMD,qBAAa,OAAQ,YAAW,gBAAgB,EAAE,SAAS;IAClD,IAAI,EAAE,MAAM,CAAA;IAEnB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAQ;gBAErC,UAAU,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW;IA6BvD,KAAK,IAAK,OAAO,CAAC,IAAI,CAAC;IAIvB,IAAI,IAAK,OAAO,CAAC,IAAI,CAAC;IAI5B,SAAS,CAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,SAAS,CAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAIhC;;;OAGG;IACK,aAAa,CAAE,GAAG,EAAE,GAAG,EAAE,OAAO,GAAE,cAAc,CAAC,kCAAkC,CAAM,GAAG,aAAa,CAAC,QAAQ,CAAC;IAmH3H;;;OAGG;IACG,OAAO,CAAE,GAAG,EAAE,GAAG,EAAE,OAAO,GAAE,cAAc,CAAC,4BAA4B,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB7F,eAAe,CAAE,GAAG,EAAE,GAAG,EAAE,OAAO,GAAE,cAAc,CAAC,oCAAoC,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBnH;;OAEG;IACG,GAAG,CAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,cAAc,CAAC,wBAAwB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBjH;;;OAGG;IACG,GAAG,CAAE,GAAG,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,cAAc,CAAC,wBAAwB,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAqCpG;;OAEG;IACG,QAAQ,CAAE,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,CAAC,6BAA6B,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAsChG;;OAEG;IACK,eAAe,CAAE,GAAG,EAAE,UAAU,EAAE,OAAO,GAAE,cAAc,CAAC,oCAAoC,CAAM,GAAG,aAAa,CAAC,IAAI,CAAC;CA8BnI"}