@libp2p/kad-dht 0.28.6

package/dist/src/dual-kad-dht.d.ts

@@ -0,0 +1,65 @@
+import type { KadDHT } from './kad-dht.js';
+import type { DHT, QueryOptions } from '@libp2p/interfaces/dht';
+import { AbortOptions, EventEmitter } from '@libp2p/interfaces';
+import type { CID } from 'multiformats';
+import type { PeerId } from '@libp2p/interfaces/peer-id';
+import type { PeerDiscoveryEvents } from '@libp2p/interfaces/peer-discovery';
+import type { PeerStore } from '@libp2p/interfaces/peer-store';
+/**
+ * A DHT implementation modelled after Kademlia with S/Kademlia modifications.
+ * Original implementation in go: https://github.com/libp2p/go-libp2p-kad-dht.
+ */
+export declare class DualKadDHT extends EventEmitter<PeerDiscoveryEvents> implements DHT {
+    wan: KadDHT;
+    lan: KadDHT;
+    peerId: PeerId;
+    peerStore: PeerStore;
+    constructor(wan: KadDHT, lan: KadDHT, peerId: PeerId, peerStore: PeerStore);
+    /**
+     * Is this DHT running.
+     */
+    isStarted(): boolean;
+    /**
+     * If 'server' this node will respond to DHT queries, if 'client' this node will not
+     */
+    getMode(): Promise<"client" | "server">;
+    /**
+     * If 'server' this node will respond to DHT queries, if 'client' this node will not
+     */
+    setMode(mode: 'client' | 'server'): Promise<void>;
+    /**
+     * Start listening to incoming connections.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop accepting incoming connections and sending outgoing
+     * messages.
+     */
+    stop(): Promise<void>;
+    /**
+     * Store the given key/value pair in the DHT
+     */
+    put(key: Uint8Array, value: Uint8Array, options?: QueryOptions): AsyncGenerator<import("@libp2p/interfaces/dht").SendingQueryEvent | import("@libp2p/interfaces/dht").PeerResponseEvent | import("@libp2p/interfaces/dht").QueryErrorEvent | import("@libp2p/interfaces/dht").ProviderEvent | import("@libp2p/interfaces/dht").ValueEvent | import("@libp2p/interfaces/dht").AddingPeerEvent | import("@libp2p/interfaces/dht").DialingPeerEvent, void, unknown>;
+    /**
+     * Get the value that corresponds to the passed key
+     */
+    get(key: Uint8Array, options?: QueryOptions): AsyncGenerator<import("@libp2p/interfaces/dht").QueryEvent, void, unknown>;
+    /**
+     * Announce to the network that we can provide given key's value
+     */
+    provide(key: CID, options?: AbortOptions): AsyncGenerator<import("@libp2p/interfaces/dht").SendingQueryEvent | import("@libp2p/interfaces/dht").PeerResponseEvent | import("@libp2p/interfaces/dht").QueryErrorEvent | import("@libp2p/interfaces/dht").ProviderEvent | import("@libp2p/interfaces/dht").ValueEvent | import("@libp2p/interfaces/dht").AddingPeerEvent | import("@libp2p/interfaces/dht").DialingPeerEvent, void, unknown>;
+    /**
+     * Search the dht for up to `K` providers of the given CID
+     */
+    findProviders(key: CID, options?: QueryOptions): AsyncGenerator<import("@libp2p/interfaces/dht").QueryEvent, void, undefined>;
+    /**
+     * Search for a peer with the given ID
+     */
+    findPeer(id: PeerId, options?: QueryOptions): AsyncGenerator<import("@libp2p/interfaces/dht").QueryEvent, void, unknown>;
+    /**
+     * Kademlia 'node lookup' operation
+     */
+    getClosestPeers(key: Uint8Array, options?: QueryOptions): AsyncGenerator<import("@libp2p/interfaces/dht").QueryEvent, void, undefined>;
+    refreshRoutingTable(): Promise<void>;
+}
+//# sourceMappingURL=dual-kad-dht.d.ts.map

package/dist/src/dual-kad-dht.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dual-kad-dht.d.ts","sourceRoot":"","sources":["../../src/dual-kad-dht.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAe,MAAM,oBAAoB,CAAA;AAC5E,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAA;AAC5E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AAI9D;;;GAGG;AACH,qBAAa,UAAW,SAAQ,YAAY,CAAC,mBAAmB,CAAE,YAAW,GAAG;IACvE,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,SAAS,CAAA;gBAEd,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS;IAqB3E;;OAEG;IACH,SAAS;IAIT;;OAEG;IACG,OAAO;IAIb;;OAEG;IACG,OAAO,CAAE,IAAI,EAAE,QAAQ,GAAG,QAAQ;IAIxC;;OAEG;IACG,KAAK;IAOX;;;OAGG;IACG,IAAI;IAOV;;OAEG;IACK,GAAG,CAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,YAAiB;IA8B3E;;OAEG;IACK,GAAG,CAAE,GAAG,EAAE,UAAU,EAAE,OAAO,GAAE,YAAiB;IAyCxD;;OAEG;IACK,OAAO,CAAE,GAAG,EAAE,GAAG,EAAE,OAAO,GAAE,YAAiB;IAuCrD;;OAEG;IACK,aAAa,CAAE,GAAG,EAAE,GAAG,EAAE,OAAO,GAAE,YAAiB;IAS3D;;OAEG;IACK,QAAQ,CAAE,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB;IAmBxD;;OAEG;IACK,eAAe,CAAE,GAAG,EAAE,UAAU,EAAE,OAAO,GAAE,YAAiB;IAO9D,mBAAmB;CAM1B"}

package/dist/src/dual-kad-dht.js

@@ -0,0 +1,191 @@
+import { logger } from '@libp2p/logger';
+import errCode from 'err-code';
+import merge from 'it-merge';
+import { queryErrorEvent } from './query/events.js';
+import { EventEmitter, CustomEvent } from '@libp2p/interfaces';
+const log = logger('libp2p:kad-dht');
+/**
+ * A DHT implementation modelled after Kademlia with S/Kademlia modifications.
+ * Original implementation in go: https://github.com/libp2p/go-libp2p-kad-dht.
+ */
+export class DualKadDHT extends EventEmitter {
+    constructor(wan, lan, peerId, peerStore) {
+        super();
+        this.wan = wan;
+        this.lan = lan;
+        this.peerId = peerId;
+        this.peerStore = peerStore;
+        // handle peers being discovered during processing of DHT messages
+        this.wan.addEventListener('peer', (evt) => {
+            this.dispatchEvent(new CustomEvent('peer', {
+                detail: evt.detail
+            }));
+        });
+        this.lan.addEventListener('peer', (evt) => {
+            this.dispatchEvent(new CustomEvent('peer', {
+                detail: evt.detail
+            }));
+        });
+    }
+    /**
+     * Is this DHT running.
+     */
+    isStarted() {
+        return this.wan.isStarted() && this.lan.isStarted();
+    }
+    /**
+     * If 'server' this node will respond to DHT queries, if 'client' this node will not
+     */
+    async getMode() {
+        return await this.wan.getMode();
+    }
+    /**
+     * If 'server' this node will respond to DHT queries, if 'client' this node will not
+     */
+    async setMode(mode) {
+        await this.wan.setMode(mode);
+    }
+    /**
+     * Start listening to incoming connections.
+     */
+    async start() {
+        await Promise.all([
+            this.lan.start(),
+            this.wan.start()
+        ]);
+    }
+    /**
+     * Stop accepting incoming connections and sending outgoing
+     * messages.
+     */
+    async stop() {
+        await Promise.all([
+            this.lan.stop(),
+            this.wan.stop()
+        ]);
+    }
+    /**
+     * Store the given key/value pair in the DHT
+     */
+    async *put(key, value, options = {}) {
+        let counterAll = 0;
+        let counterSuccess = 0;
+        for await (const event of merge(this.lan.put(key, value, options), this.wan.put(key, value, options))) {
+            yield event;
+            if (event.name === 'SENDING_QUERY' && event.messageName === 'PUT_VALUE') {
+                counterAll++;
+            }
+            if (event.name === 'PEER_RESPONSE' && event.messageName === 'PUT_VALUE') {
+                counterSuccess++;
+            }
+        }
+        // Ensure we have a default `minPeers`
+        const minPeers = options.minPeers == null ? counterAll ?? 1 : options.minPeers;
+        // verify if we were able to put to enough peers
+        if (counterSuccess < minPeers) {
+            const error = errCode(new Error(`Failed to put value to enough peers: ${counterSuccess}/${minPeers}`), 'ERR_NOT_ENOUGH_PUT_PEERS');
+            log.error(error);
+            throw error;
+        }
+    }
+    /**
+     * Get the value that corresponds to the passed key
+     */
+    async *get(key, options = {}) {
+        let queriedPeers = false;
+        let foundValue = false;
+        for await (const event of merge(this.lan.get(key, options), this.wan.get(key, options))) {
+            yield event;
+            if (event.name === 'DIALING_PEER') {
+                queriedPeers = true;
+            }
+            if (event.name === 'VALUE') {
+                queriedPeers = true;
+                if (event.value != null) {
+                    foundValue = true;
+                }
+            }
+            if (event.name === 'SENDING_QUERY') {
+                queriedPeers = true;
+            }
+        }
+        if (!queriedPeers) {
+            throw errCode(new Error('No peers found in routing table!'), 'ERR_NO_PEERS_IN_ROUTING_TABLE');
+        }
+        if (!foundValue) {
+            yield queryErrorEvent({
+                from: this.peerId,
+                error: errCode(new Error('Not found'), 'ERR_NOT_FOUND')
+            });
+        }
+    }
+    // ----------- Content Routing
+    /**
+     * Announce to the network that we can provide given key's value
+     */
+    async *provide(key, options = {}) {
+        let sent = 0;
+        let success = 0;
+        const errors = [];
+        const dhts = [this.lan];
+        // only run provide on the wan if we are in server mode
+        if ((await this.wan.getMode()) === 'server') {
+            dhts.push(this.wan);
+        }
+        for await (const event of merge(...dhts.map(dht => dht.provide(key, options)))) {
+            yield event;
+            if (event.name === 'SENDING_QUERY') {
+                sent++;
+            }
+            if (event.name === 'QUERY_ERROR') {
+                errors.push(event.error);
+            }
+            if (event.name === 'PEER_RESPONSE' && event.messageName === 'ADD_PROVIDER') {
+                log('sent provider record for %s to %p', key, event.from);
+                success++;
+            }
+        }
+        if (success === 0) {
+            if (errors.length > 0) {
+                // if all sends failed, throw an error to inform the caller
+                throw errCode(new Error(`Failed to provide to ${errors.length} of ${sent} peers`), 'ERR_PROVIDES_FAILED', { errors });
+            }
+            throw errCode(new Error('Failed to provide - no peers found'), 'ERR_PROVIDES_FAILED');
+        }
+    }
+    /**
+     * Search the dht for up to `K` providers of the given CID
+     */
+    async *findProviders(key, options = {}) {
+        yield* merge(this.lan.findProviders(key, options), this.wan.findProviders(key, options));
+    }
+    // ----------- Peer Routing -----------
+    /**
+     * Search for a peer with the given ID
+     */
+    async *findPeer(id, options = {}) {
+        let queriedPeers = false;
+        for await (const event of merge(this.lan.findPeer(id, options), this.wan.findPeer(id, options))) {
+            yield event;
+            if (event.name === 'SENDING_QUERY' || event.name === 'FINAL_PEER') {
+                queriedPeers = true;
+            }
+        }
+        if (!queriedPeers) {
+            throw errCode(new Error('Peer lookup failed'), 'ERR_LOOKUP_FAILED');
+        }
+    }
+    /**
+     * Kademlia 'node lookup' operation
+     */
+    async *getClosestPeers(key, options = {}) {
+        yield* merge(this.lan.getClosestPeers(key, options), this.wan.getClosestPeers(key, options));
+    }
+    async refreshRoutingTable() {
+        await Promise.all([
+            this.lan.refreshRoutingTable(),
+            this.wan.refreshRoutingTable()
+        ]);
+    }
+}
+//# sourceMappingURL=dual-kad-dht.js.map

package/dist/src/dual-kad-dht.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,4 @@
+import { KadDHTOptions } from './kad-dht.js';
+import type { DHT } from '@libp2p/interfaces/dht';
+export declare function createKadDHT(opts: KadDHTOptions): DHT;
+//# 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,OAAO,EAAU,aAAa,EAAE,MAAM,cAAc,CAAA;AAEpD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAA;AAEjD,wBAAgB,YAAY,CAAE,IAAI,EAAE,aAAa,GAAG,GAAG,CAgBtD"}

package/dist/src/index.js

@@ -0,0 +1,15 @@
+import { KadDHT } from './kad-dht.js';
+import { DualKadDHT } from './dual-kad-dht.js';
+export function createKadDHT(opts) {
+    return new DualKadDHT(new KadDHT({
+        ...opts,
+        protocol: '/ipfs/kad/1.0.0',
+        lan: false
+    }), new KadDHT({
+        ...opts,
+        protocol: '/ipfs/lan/kad/1.0.0',
+        clientMode: false,
+        lan: true
+    }), opts.peerId, opts.peerStore);
+}
+//# 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,OAAO,EAAE,MAAM,EAAiB,MAAM,cAAc,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAG9C,MAAM,UAAU,YAAY,CAAE,IAAmB;IAC/C,OAAO,IAAI,UAAU,CACnB,IAAI,MAAM,CAAC;QACT,GAAG,IAAI;QACP,QAAQ,EAAE,iBAAiB;QAC3B,GAAG,EAAE,KAAK;KACX,CAAC,EACF,IAAI,MAAM,CAAC;QACT,GAAG,IAAI;QACP,QAAQ,EAAE,qBAAqB;QAC/B,UAAU,EAAE,KAAK;QACjB,GAAG,EAAE,IAAI;KACV,CAAC,EACF,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,SAAS,CACf,CAAA;AACH,CAAC"}

package/dist/src/kad-dht.d.ts

@@ -0,0 +1,131 @@
+import { RoutingTable } from './routing-table/index.js';
+import { Network } from './network.js';
+import { PeerRouting } from './peer-routing/index.js';
+import { Providers } from './providers.js';
+import type { DHT, QueryOptions, Validators, Selectors } from '@libp2p/interfaces/dht';
+import type { PeerData } from '@libp2p/interfaces/peer-data';
+import { EventEmitter } from '@libp2p/interfaces';
+import type { Addressable, Dialer } from '@libp2p/interfaces';
+import type { PeerId } from '@libp2p/interfaces/peer-id';
+import type { PeerStore } from '@libp2p/interfaces/peer-store';
+import type { ComponentMetricsTracker } from '@libp2p/interfaces/metrics';
+import type { Datastore } from 'interface-datastore';
+import type { Registrar } from '@libp2p/interfaces/registrar';
+import type { CID } from 'multiformats/cid';
+import type { PeerDiscoveryEvents } from '@libp2p/interfaces/peer-discovery';
+export interface KadDHTOptions {
+    /**
+     * libp2p registrar handle protocol
+     */
+    protocol: string;
+    /**
+     * k-bucket size (default 20)
+     */
+    kBucketSize?: number;
+    /**
+     * If true, the DHT will not respond to queries. This should be true if your node will not be dialable. (default: false)
+     */
+    clientMode?: boolean;
+    /**
+     * validators object with namespace as keys and function(key, record, callback)
+     */
+    validators: Validators;
+    /**
+     * selectors object with namespace as keys and function(key, records)
+     */
+    selectors: Selectors;
+    /**
+     * how often to search the network for peers close to ourselves
+     */
+    querySelfInterval: number;
+    lan: boolean;
+    bootstrapPeers: PeerData[];
+    dialer: Dialer;
+    addressable: Addressable;
+    peerStore: PeerStore;
+    peerId: PeerId;
+    datastore: Datastore;
+    registrar: Registrar;
+    metrics?: ComponentMetricsTracker;
+}
+/**
+ * A DHT implementation modelled after Kademlia with S/Kademlia modifications.
+ * Original implementation in go: https://github.com/libp2p/go-libp2p-kad-dht.
+ */
+export declare class KadDHT extends EventEmitter<PeerDiscoveryEvents> implements DHT {
+    private readonly log;
+    private running;
+    protocol: string;
+    private readonly kBucketSize;
+    private clientMode;
+    private readonly bootstrapPeers;
+    routingTable: RoutingTable;
+    providers: Providers;
+    private readonly lan;
+    private readonly validators;
+    private readonly selectors;
+    network: Network;
+    private readonly queryManager;
+    peerRouting: PeerRouting;
+    private readonly contentFetching;
+    private readonly contentRouting;
+    private readonly routingTableRefresh;
+    private readonly rpc;
+    private readonly topologyListener;
+    private readonly querySelf;
+    addressable: Addressable;
+    registrar: Registrar;
+    private registrarHandleId?;
+    /**
+     * Create a new KadDHT
+     */
+    constructor(options: KadDHTOptions);
+    onPeerConnect(peerData: PeerData): Promise<void>;
+    /**
+     * Is this DHT running.
+     */
+    isStarted(): boolean;
+    /**
+     * If 'server' this node will respond to DHT queries, if 'client' this node will not
+     */
+    getMode(): Promise<"client" | "server">;
+    /**
+     * If 'server' this node will respond to DHT queries, if 'client' this node will not
+     */
+    setMode(mode: 'client' | 'server'): Promise<void>;
+    /**
+     * Start listening to incoming connections.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop accepting incoming connections and sending outgoing
+     * messages.
+     */
+    stop(): Promise<void>;
+    /**
+     * Store the given key/value pair in the DHT
+     */
+    put(key: Uint8Array, value: Uint8Array, options?: QueryOptions): AsyncGenerator<import("@libp2p/interfaces/dht").SendingQueryEvent | import("@libp2p/interfaces/dht").PeerResponseEvent | import("@libp2p/interfaces/dht").QueryErrorEvent | import("@libp2p/interfaces/dht").ProviderEvent | import("@libp2p/interfaces/dht").ValueEvent | import("@libp2p/interfaces/dht").AddingPeerEvent | import("@libp2p/interfaces/dht").DialingPeerEvent, void, undefined>;
+    /**
+     * Get the value that corresponds to the passed key
+     */
+    get(key: Uint8Array, options?: QueryOptions): AsyncGenerator<import("@libp2p/interfaces/dht").QueryEvent, void, unknown>;
+    /**
+     * Announce to the network that we can provide given key's value
+     */
+    provide(key: CID, options?: QueryOptions): AsyncGenerator<import("@libp2p/interfaces/dht").SendingQueryEvent | import("@libp2p/interfaces/dht").PeerResponseEvent | import("@libp2p/interfaces/dht").QueryErrorEvent | import("@libp2p/interfaces/dht").ProviderEvent | import("@libp2p/interfaces/dht").ValueEvent | import("@libp2p/interfaces/dht").AddingPeerEvent | import("@libp2p/interfaces/dht").DialingPeerEvent, void, undefined>;
+    /**
+     * Search the dht for providers of the given CID
+     */
+    findProviders(key: CID, options?: QueryOptions): AsyncGenerator<import("@libp2p/interfaces/dht").QueryEvent, void, unknown>;
+    /**
+     * Search for a peer with the given ID
+     */
+    findPeer(id: PeerId, options?: QueryOptions): AsyncGenerator<import("@libp2p/interfaces/dht").QueryEvent, void, unknown>;
+    /**
+     * Kademlia 'node lookup' operation
+     */
+    getClosestPeers(key: Uint8Array, options?: QueryOptions): AsyncGenerator<import("@libp2p/interfaces/dht").QueryEvent, void, unknown>;
+    refreshRoutingTable(): Promise<void>;
+}
+//# sourceMappingURL=kad-dht.d.ts.map

package/dist/src/kad-dht.d.ts.map

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