@libp2p/interface 0.0.1-05abd49f

package/dist/src/index.js

@@ -0,0 +1,17 @@
+/**
+ * @packageDocumentation
+ *
+ * Exports a `Libp2p` type for modules to use as a type argument.
+ *
+ * @example
+ *
+ * ```typescript
+ * import type { Libp2p } from '@libp2p/interface'
+ *
+ * function doSomethingWithLibp2p (node: Libp2p) {
+ *   // ...
+ * }
+ * ```
+ */
+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;;;;;;;;;;;;;;GAcG"}

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

@@ -0,0 +1,154 @@
+/**
+ * @packageDocumentation
+ *
+ * The libp2p keychain provides an API to store keys in a datastore in
+ * an encrypted format.
+ *
+ * @example
+ *
+ * ```typescript
+ * import { createLibp2p } from 'libp2p'
+ * import { FsDatastore } from 'datastore-fs'
+ *
+ * const node = await createLibp2p({
+ *   datastore: new FsDatastore('/path/to/dir')
+ * })
+ *
+ * const info = await node.keychain.createKey('my-new-key', 'Ed25519')
+ *
+ * console.info(info) // { id: '...', name: 'my-new-key' }
+ * ```
+ */
+import type { KeyType } from '../keys/index.js';
+import type { PeerId } from '../peer-id/index.js';
+import type { Multibase } from 'multiformats/bases/interface';
+export interface KeyInfo {
+    /**
+     * The universally unique key id
+     */
+    id: string;
+    /**
+     * The local key name
+     */
+    name: string;
+}
+export interface KeyChain {
+    /**
+     * Export an existing key as a PEM encrypted PKCS #8 string.
+     *
+     * @example
+     *
+     * ```js
+     * await libp2p.keychain.createKey('keyTest', 'RSA', 4096)
+     * const pemKey = await libp2p.keychain.exportKey('keyTest', 'password123')
+     * ```
+     */
+    exportKey: (name: string, password: string) => Promise<Multibase<'m'>>;
+    /**
+     * Import a new key from a PEM encoded PKCS #8 string.
+     *
+     * @example
+     *
+     * ```js
+     * await libp2p.keychain.createKey('keyTest', 'RSA', 4096)
+     * const pemKey = await libp2p.keychain.exportKey('keyTest', 'password123')
+     * const keyInfo = await libp2p.keychain.importKey('keyTestImport', pemKey, 'password123')
+     * ```
+     */
+    importKey: (name: string, pem: string, password: string) => Promise<KeyInfo>;
+    /**
+     * Import a new key from a PeerId with a private key component
+     *
+     * @example
+     *
+     * ```js
+     * const keyInfo = await libp2p.keychain.importPeer('keyTestImport', peerIdFromString('12D3Foo...'))
+     * ```
+     */
+    importPeer: (name: string, peerId: PeerId) => Promise<KeyInfo>;
+    /**
+     * Export an existing key as a PeerId
+     *
+     * @example
+     *
+     * ```js
+     * const peerId = await libp2p.keychain.exportPeerId('key-name')
+     * ```
+     */
+    exportPeerId: (name: string) => Promise<PeerId>;
+    /**
+     * Create a key in the keychain.
+     *
+     * @example
+     *
+     * ```js
+     * const keyInfo = await libp2p.keychain.createKey('keyTest', 'RSA', 4096)
+     * ```
+     */
+    createKey: (name: string, type: KeyType, size?: number) => Promise<KeyInfo>;
+    /**
+     * List all the keys.
+     *
+     * @example
+     *
+     * ```js
+     * const keyInfos = await libp2p.keychain.listKeys()
+     * ```
+     */
+    listKeys: () => Promise<KeyInfo[]>;
+    /**
+     * Removes a key from the keychain.
+     *
+     * @example
+     *
+     * ```js
+     * await libp2p.keychain.createKey('keyTest', 'RSA', 4096)
+     * const keyInfo = await libp2p.keychain.removeKey('keyTest')
+     * ```
+     */
+    removeKey: (name: string) => Promise<KeyInfo>;
+    /**
+     * Rename a key in the keychain.
+     *
+     * @example
+     *
+     * ```js
+     * await libp2p.keychain.createKey('keyTest', 'RSA', 4096)
+     * const keyInfo = await libp2p.keychain.renameKey('keyTest', 'keyNewNtest')
+     * ```
+     */
+    renameKey: (oldName: string, newName: string) => Promise<KeyInfo>;
+    /**
+     * Find a key by it's id.
+     *
+     * @example
+     *
+     * ```js
+     * const keyInfo = await libp2p.keychain.createKey('keyTest', 'RSA', 4096)
+     * const keyInfo2 = await libp2p.keychain.findKeyById(keyInfo.id)
+     * ```
+     */
+    findKeyById: (id: string) => Promise<KeyInfo>;
+    /**
+     * Find a key by it's name.
+     *
+     * @example
+     *
+     * ```js
+     * const keyInfo = await libp2p.keychain.createKey('keyTest', 'RSA', 4096)
+     * const keyInfo2 = await libp2p.keychain.findKeyByName('keyTest')
+     * ```
+     */
+    findKeyByName: (name: string) => Promise<KeyInfo>;
+    /**
+     * Rotate keychain password and re-encrypt all associated keys
+     *
+     * @example
+     *
+     * ```js
+     * await libp2p.keychain.rotateKeychainPass('oldPassword', 'newPassword')
+     * ```
+     */
+    rotateKeychainPass: (oldPass: string, newPass: string) => Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/keychain/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAE7D,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;IAEV;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,QAAQ;IACvB;;;;;;;;;OASG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAA;IAEtE;;;;;;;;;;OAUG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAE5E;;;;;;;;OAQG;IACH,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAE9D;;;;;;;;OAQG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAE/C;;;;;;;;OAQG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAE3E;;;;;;;;OAQG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IAElC;;;;;;;;;OASG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAE7C;;;;;;;;;OASG;IACH,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAEjE;;;;;;;;;OASG;IACH,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAE7C;;;;;;;;;OASG;IACH,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAEjD;;;;;;;;OAQG;IACH,kBAAkB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACxE"}

package/dist/src/keychain/index.js

@@ -0,0 +1,23 @@
+/**
+ * @packageDocumentation
+ *
+ * The libp2p keychain provides an API to store keys in a datastore in
+ * an encrypted format.
+ *
+ * @example
+ *
+ * ```typescript
+ * import { createLibp2p } from 'libp2p'
+ * import { FsDatastore } from 'datastore-fs'
+ *
+ * const node = await createLibp2p({
+ *   datastore: new FsDatastore('/path/to/dir')
+ * })
+ *
+ * const info = await node.keychain.createKey('my-new-key', 'Ed25519')
+ *
+ * console.info(info) // { id: '...', name: 'my-new-key' }
+ * ```
+ */
+export {};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/keychain/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}

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

@@ -0,0 +1,35 @@
+export interface PublicKey {
+    readonly bytes: Uint8Array;
+    verify: (data: Uint8Array, sig: Uint8Array) => Promise<boolean>;
+    marshal: () => Uint8Array;
+    equals: (key: PublicKey) => boolean;
+    hash: () => Promise<Uint8Array>;
+}
+/**
+ * Generic private key interface
+ */
+export interface PrivateKey {
+    readonly public: PublicKey;
+    readonly bytes: Uint8Array;
+    sign: (data: Uint8Array) => Promise<Uint8Array>;
+    marshal: () => Uint8Array;
+    equals: (key: PrivateKey) => boolean;
+    hash: () => Promise<Uint8Array>;
+    /**
+     * Gets the ID of the key.
+     *
+     * The key id is the base58 encoding of the SHA-256 multihash of its public key.
+     * The public key is a protobuf encoding containing a type and the DER encoding
+     * of the PKCS SubjectPublicKeyInfo.
+     */
+    id: () => Promise<string>;
+    /**
+     * Exports the password protected key in the format specified.
+     */
+    export: (password: string, format?: 'pkcs-8' | string) => Promise<string>;
+}
+export declare const Ed25519 = "Ed25519";
+export declare const RSA = "RSA";
+export declare const secp256k1 = "secp256k1";
+export type KeyType = typeof Ed25519 | typeof RSA | typeof secp256k1;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/keys/index.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,MAAM,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC/D,OAAO,EAAE,MAAM,UAAU,CAAA;IACzB,MAAM,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,OAAO,CAAA;IACnC,IAAI,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,IAAI,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAC/C,OAAO,EAAE,MAAM,UAAU,CAAA;IACzB,MAAM,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAA;IACpC,IAAI,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAA;IAC/B;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IACzB;;OAEG;IACH,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAC1E;AAED,eAAO,MAAM,OAAO,YAAY,CAAA;AAChC,eAAO,MAAM,GAAG,QAAQ,CAAA;AACxB,eAAO,MAAM,SAAS,cAAc,CAAA;AAEpC,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,GAAG,OAAO,GAAG,GAAG,OAAO,SAAS,CAAA"}

package/dist/src/keys/index.js

@@ -0,0 +1,4 @@
+export const Ed25519 = 'Ed25519';
+export const RSA = 'RSA';
+export const secp256k1 = 'secp256k1';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/keys/index.ts"],"names":[],"mappings":"AAiCA,MAAM,CAAC,MAAM,OAAO,GAAG,SAAS,CAAA;AAChC,MAAM,CAAC,MAAM,GAAG,GAAG,KAAK,CAAA;AACxB,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAA"}

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

@@ -0,0 +1,165 @@
+import type { MultiaddrConnection, Stream, Connection } from '../connection/index.js';
+/**
+ * Create tracked metrics with these options. Loosely based on the
+ * interfaces exposed by the prom-client module
+ */
+export interface MetricOptions {
+    /**
+     * Optional label for the metric
+     */
+    label?: string;
+    /**
+     * Optional help for the metric
+     */
+    help?: string;
+}
+/**
+ * A function that returns a tracked metric which may be expensive
+ * to calculate so it is only invoked when metrics are being scraped
+ */
+export type CalculateMetric<T = number> = (() => T) | (() => Promise<T>);
+/**
+ * Create tracked metrics that are expensive to calculate by passing
+ * a function that is only invoked when metrics are being scraped
+ */
+export interface CalculatedMetricOptions<T = number> extends MetricOptions {
+    /**
+     * An optional function invoked to calculate the component metric instead of
+     * using `.update`, `.increment`, and `.decrement`
+     */
+    calculate: CalculateMetric<T>;
+}
+/**
+ * Call this function to stop the timer returned from the `.timer` method
+ * on the metric
+ */
+export interface StopTimer {
+    (): void;
+}
+/**
+ * A tracked metric loosely based on the interfaces exposed by the
+ * prom-client module
+ */
+export interface Metric {
+    /**
+     * Update the stored metric to the passed value
+     */
+    update: (value: number) => void;
+    /**
+     * Increment the metric by the passed value or 1
+     */
+    increment: (value?: number) => void;
+    /**
+     * Decrement the metric by the passed value or 1
+     */
+    decrement: (value?: number) => void;
+    /**
+     * Reset this metric to its default value
+     */
+    reset: () => void;
+    /**
+     * Start a timed metric, call the returned function to
+     * stop the timer
+     */
+    timer: () => StopTimer;
+}
+/**
+ * A group of related metrics loosely based on the interfaces exposed by the
+ * prom-client module
+ */
+export interface MetricGroup {
+    /**
+     * Update the stored metric group to the passed value
+     */
+    update: (values: Record<string, number>) => void;
+    /**
+     * Increment the metric group keys by the passed number or
+     * any non-numeric value to increment by 1
+     */
+    increment: (values: Record<string, number | unknown>) => void;
+    /**
+     * Decrement the metric group keys by the passed number or
+     * any non-numeric value to decrement by 1
+     */
+    decrement: (values: Record<string, number | unknown>) => void;
+    /**
+     * Reset the passed key in this metric group to its default value
+     * or all keys if no key is passed
+     */
+    reset: () => void;
+    /**
+     * Start a timed metric for the named key in the group, call
+     * the returned function to stop the timer
+     */
+    timer: (key: string) => StopTimer;
+}
+/**
+ * A tracked counter loosely based on the Counter interface exposed
+ * by the prom-client module - counters are metrics that only go up
+ */
+export interface Counter {
+    /**
+     * Increment the metric by the passed value or 1
+     */
+    increment: (value?: number) => void;
+    /**
+     * Reset this metric to its default value
+     */
+    reset: () => void;
+}
+/**
+ * A group of tracked counters loosely based on the Counter interface
+ * exposed by the prom-client module - counters are metrics that only
+ * go up
+ */
+export interface CounterGroup {
+    /**
+     * Increment the metric group keys by the passed number or
+     * any non-numeric value to increment by 1
+     */
+    increment: (values: Record<string, number | unknown>) => void;
+    /**
+     * Reset the passed key in this metric group to its default value
+     * or all keys if no key is passed
+     */
+    reset: () => void;
+}
+/**
+ * The libp2p metrics tracking object. This interface is only concerned
+ * with the collection of metrics, please see the individual implementations
+ * for how to extract metrics for viewing.
+ */
+export interface Metrics {
+    /**
+     * Track a newly opened multiaddr connection
+     */
+    trackMultiaddrConnection: (maConn: MultiaddrConnection) => void;
+    /**
+     * Track a newly opened protocol stream
+     */
+    trackProtocolStream: (stream: Stream, connection: Connection) => void;
+    /**
+     * Register an arbitrary metric. Call this to set help/labels for metrics
+     * and update/increment/decrement/etc them by calling methods on the returned
+     * metric object
+     */
+    registerMetric: ((name: string, options?: MetricOptions) => Metric) & ((name: string, options: CalculatedMetricOptions) => void);
+    /**
+     * Register a a group of related metrics. Call this to set help/labels for
+     * groups of related metrics that will be updated with by calling `.update`,
+     * `.increment` and/or `.decrement` methods on the returned metric group object
+     */
+    registerMetricGroup: ((name: string, options?: MetricOptions) => MetricGroup) & ((name: string, options: CalculatedMetricOptions<Record<string, number>>) => void);
+    /**
+     * Register an arbitrary counter. Call this to set help/labels for counters
+     * and increment them by calling methods on the returned counter object
+     */
+    registerCounter: ((name: string, options?: MetricOptions) => Counter) & ((name: string, options: CalculatedMetricOptions) => void);
+    /**
+     * Register a a group of related counters. Call this to set help/labels for
+     * groups of related counters that will be updated with by calling the `.increment`
+     * method on the returned counter group object
+     */
+    registerCounterGroup: ((name: string, options?: MetricOptions) => CounterGroup) & ((name: string, options: CalculatedMetricOptions<Record<string, number>>) => void);
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/src/metrics/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/metrics/index.ts"],"names":[],"mappings":""}

package/dist/src/metrics/tracked-map.d.ts

@@ -0,0 +1,17 @@
+import type { Metrics } from './index.js';
+export interface TrackedMapInit {
+    name: string;
+    metrics: Metrics;
+}
+export interface CreateTrackedMapInit {
+    /**
+     * The metric name to use
+     */
+    name: string;
+    /**
+     * A metrics implementation
+     */
+    metrics?: Metrics;
+}
+export declare function trackedMap<K, V>(config: CreateTrackedMapInit): Map<K, V>;
+//# sourceMappingURL=tracked-map.d.ts.map

package/dist/src/metrics/tracked-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracked-map.d.ts","sourceRoot":"","sources":["../../../src/metrics/tracked-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,OAAO,EAAE,MAAM,YAAY,CAAA;AAEjD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;CACjB;AAoCD,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,wBAAgB,UAAU,CAAE,CAAC,EAAE,CAAC,EAAG,MAAM,EAAE,oBAAoB,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAW1E"}

package/dist/src/metrics/tracked-map.js

@@ -0,0 +1,38 @@
+class TrackedMap extends Map {
+    metric;
+    constructor(init) {
+        super();
+        const { name, metrics } = init;
+        this.metric = metrics.registerMetric(name);
+        this.updateComponentMetric();
+    }
+    set(key, value) {
+        super.set(key, value);
+        this.updateComponentMetric();
+        return this;
+    }
+    delete(key) {
+        const deleted = super.delete(key);
+        this.updateComponentMetric();
+        return deleted;
+    }
+    clear() {
+        super.clear();
+        this.updateComponentMetric();
+    }
+    updateComponentMetric() {
+        this.metric.update(this.size);
+    }
+}
+export function trackedMap(config) {
+    const { name, metrics } = config;
+    let map;
+    if (metrics != null) {
+        map = new TrackedMap({ name, metrics });
+    }
+    else {
+        map = new Map();
+    }
+    return map;
+}
+//# sourceMappingURL=tracked-map.js.map

package/dist/src/metrics/tracked-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracked-map.js","sourceRoot":"","sources":["../../../src/metrics/tracked-map.ts"],"names":[],"mappings":"AAOA,MAAM,UAAiB,SAAQ,GAAS;IACrB,MAAM,CAAQ;IAE/B,YAAa,IAAoB;QAC/B,KAAK,EAAE,CAAA;QAEP,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;QAE9B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;QAC1C,IAAI,CAAC,qBAAqB,EAAE,CAAA;IAC9B,CAAC;IAED,GAAG,CAAE,GAAM,EAAE,KAAQ;QACnB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACrB,IAAI,CAAC,qBAAqB,EAAE,CAAA;QAC5B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,CAAE,GAAM;QACZ,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACjC,IAAI,CAAC,qBAAqB,EAAE,CAAA;QAC5B,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,KAAK;QACH,KAAK,CAAC,KAAK,EAAE,CAAA;QACb,IAAI,CAAC,qBAAqB,EAAE,CAAA;IAC9B,CAAC;IAEO,qBAAqB;QAC3B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC/B,CAAC;CACF;AAcD,MAAM,UAAU,UAAU,CAAS,MAA4B;IAC7D,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAA;IAChC,IAAI,GAAc,CAAA;IAElB,IAAI,OAAO,IAAI,IAAI,EAAE;QACnB,GAAG,GAAG,IAAI,UAAU,CAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;KAC9C;SAAM;QACL,GAAG,GAAG,IAAI,GAAG,EAAQ,CAAA;KACtB;IAED,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/src/peer-discovery/index.d.ts

@@ -0,0 +1,28 @@
+import type { EventEmitter } from '../events.js';
+import type { PeerInfo } from '../peer-info/index.js';
+/**
+ * Any object that implements this Symbol as a property should return a
+ * PeerDiscovery instance as the property value, similar to how
+ * `Symbol.Iterable` can be used to return an `Iterable` from an `Iterator`.
+ *
+ * @example
+ *
+ * ```js
+ * import { peerDiscovery, PeerDiscovery } from '@libp2p/peer-discovery'
+ *
+ * class MyPeerDiscoverer implements PeerDiscovery {
+ *   get [peerDiscovery] () {
+ *     return this
+ *   }
+ *
+ *   // ...other methods
+ * }
+ * ```
+ */
+export declare const peerDiscovery: unique symbol;
+export interface PeerDiscoveryEvents {
+    'peer': CustomEvent<PeerInfo>;
+}
+export interface PeerDiscovery extends EventEmitter<PeerDiscoveryEvents> {
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/src/peer-discovery/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/peer-discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAErD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,aAAa,eAAuC,CAAA;AAEjE,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAA;CAC9B;AAED,MAAM,WAAW,aAAc,SAAQ,YAAY,CAAC,mBAAmB,CAAC;CAAG"}

package/dist/src/peer-discovery/index.js

@@ -0,0 +1,21 @@
+/**
+ * Any object that implements this Symbol as a property should return a
+ * PeerDiscovery instance as the property value, similar to how
+ * `Symbol.Iterable` can be used to return an `Iterable` from an `Iterator`.
+ *
+ * @example
+ *
+ * ```js
+ * import { peerDiscovery, PeerDiscovery } from '@libp2p/peer-discovery'
+ *
+ * class MyPeerDiscoverer implements PeerDiscovery {
+ *   get [peerDiscovery] () {
+ *     return this
+ *   }
+ *
+ *   // ...other methods
+ * }
+ * ```
+ */
+export const peerDiscovery = Symbol.for('@libp2p/peer-discovery');
+//# sourceMappingURL=index.js.map

package/dist/src/peer-discovery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/peer-discovery/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAA"}

package/dist/src/peer-id/index.d.ts

@@ -0,0 +1,30 @@
+import type { CID } from 'multiformats/cid';
+import type { MultihashDigest } from 'multiformats/hashes/interface';
+export type PeerIdType = 'RSA' | 'Ed25519' | 'secp256k1';
+interface BasePeerId {
+    readonly type: PeerIdType;
+    readonly multihash: MultihashDigest;
+    readonly privateKey?: Uint8Array;
+    readonly publicKey?: Uint8Array;
+    toString: () => string;
+    toCID: () => CID;
+    toBytes: () => Uint8Array;
+    equals: (other: PeerId | Uint8Array | string) => boolean;
+}
+export interface RSAPeerId extends BasePeerId {
+    readonly type: 'RSA';
+    readonly publicKey?: Uint8Array;
+}
+export interface Ed25519PeerId extends BasePeerId {
+    readonly type: 'Ed25519';
+    readonly publicKey: Uint8Array;
+}
+export interface Secp256k1PeerId extends BasePeerId {
+    readonly type: 'secp256k1';
+    readonly publicKey: Uint8Array;
+}
+export type PeerId = RSAPeerId | Ed25519PeerId | Secp256k1PeerId;
+export declare const symbol: unique symbol;
+export declare function isPeerId(other: any): other is PeerId;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/src/peer-id/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/peer-id/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAEpE,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,SAAS,GAAG,WAAW,CAAA;AAExD,UAAU,UAAU;IAClB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAA;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,CAAA;IAE/B,QAAQ,EAAE,MAAM,MAAM,CAAA;IACtB,KAAK,EAAE,MAAM,GAAG,CAAA;IAChB,OAAO,EAAE,MAAM,UAAU,CAAA;IACzB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,KAAK,OAAO,CAAA;CACzD;AAED,MAAM,WAAW,SAAU,SAAQ,UAAU;IAC3C,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;IACpB,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,CAAA;CAChC;AAED,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAA;CAC/B;AAED,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAA;CAC/B;AAED,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,eAAe,CAAA;AAEhE,eAAO,MAAM,MAAM,eAAgC,CAAA;AAEnD,wBAAgB,QAAQ,CAAE,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,MAAM,CAErD"}

package/dist/src/peer-id/index.js

@@ -0,0 +1,5 @@
+export const symbol = Symbol.for('@libp2p/peer-id');
+export function isPeerId(other) {
+    return other != null && Boolean(other[symbol]);
+}
+//# sourceMappingURL=index.js.map

package/dist/src/peer-id/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/peer-id/index.ts"],"names":[],"mappings":"AAkCA,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;AAEnD,MAAM,UAAU,QAAQ,CAAE,KAAU;IAClC,OAAO,KAAK,IAAI,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;AAChD,CAAC"}

package/dist/src/peer-info/index.d.ts

@@ -0,0 +1,8 @@
+import type { PeerId } from '../peer-id/index.js';
+import type { Multiaddr } from '@multiformats/multiaddr';
+export interface PeerInfo {
+    id: PeerId;
+    multiaddrs: Multiaddr[];
+    protocols: string[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/src/peer-info/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/peer-info/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAExD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,SAAS,EAAE,CAAA;IACvB,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB"}

package/dist/src/peer-info/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/src/peer-info/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/peer-info/index.ts"],"names":[],"mappings":""}