libp2p 2.3.1 → 2.4.0-5c4a79e5a

package/dist/src/address-manager/dns-mappings.d.ts

@@ -0,0 +1,20 @@
+import type { AddressManagerComponents, AddressManagerInit } from './index.js';
+import type { NodeAddress } from '@libp2p/interface-internal';
+import type { Multiaddr } from '@multiformats/multiaddr';
+export declare const defaultValues: {
+    maxObservedAddresses: number;
+};
+export declare class DNSMappings {
+    private readonly log;
+    private readonly mappings;
+    constructor(components: AddressManagerComponents, init?: AddressManagerInit);
+    has(ma: Multiaddr): boolean;
+    add(domain: string, addresses: string[]): void;
+    remove(ma: Multiaddr): boolean;
+    getAll(addresses: NodeAddress[]): NodeAddress[];
+    private maybeAddSNITuple;
+    confirm(ma: Multiaddr, ttl: number): boolean;
+    unconfirm(ma: Multiaddr, ttl: number): boolean;
+    private findHost;
+}
+//# sourceMappingURL=dns-mappings.d.ts.map

package/dist/src/address-manager/dns-mappings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dns-mappings.d.ts","sourceRoot":"","sources":["../../../src/address-manager/dns-mappings.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAE9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,yBAAyB,CAAA;AAIrE,eAAO,MAAM,aAAa;;CAEzB,CAAA;AAgBD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;gBAErC,UAAU,EAAE,wBAAwB,EAAE,IAAI,GAAE,kBAAuB;IAKhF,GAAG,CAAE,EAAE,EAAE,SAAS,GAAG,OAAO;IAY5B,GAAG,CAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAgB/C,MAAM,CAAE,EAAE,EAAE,SAAS,GAAG,OAAO;IAe/B,MAAM,CAAE,SAAS,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE;IA+ChD,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAE,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAiB7C,SAAS,CAAE,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAgB/C,OAAO,CAAC,QAAQ;CAWjB"}

package/dist/src/address-manager/dns-mappings.js

@@ -0,0 +1,139 @@
+import { isPrivateIp } from '@libp2p/utils/private-ip';
+import { multiaddr, protocols } from '@multiformats/multiaddr';
+const MAX_DATE = 8_640_000_000_000_000;
+export const defaultValues = {
+    maxObservedAddresses: 10
+};
+const CODEC_TLS = 0x01c0;
+const CODEC_SNI = 0x01c1;
+const CODEC_DNS = 0x35;
+const CODEC_DNS4 = 0x36;
+const CODEC_DNS6 = 0x37;
+const CODEC_DNSADDR = 0x38;
+export class DNSMappings {
+    log;
+    mappings;
+    constructor(components, init = {}) {
+        this.log = components.logger.forComponent('libp2p:address-manager:dns-mappings');
+        this.mappings = new Map();
+    }
+    has(ma) {
+        const host = this.findHost(ma);
+        for (const mapping of this.mappings.values()) {
+            if (mapping.domain === host) {
+                return true;
+            }
+        }
+        return false;
+    }
+    add(domain, addresses) {
+        addresses.forEach(ip => {
+            this.log('add DNS mapping %s to %s', ip, domain);
+            // we are only confident if this is an local domain mapping, otherwise
+            // we will require external validation
+            const verified = isPrivateIp(ip) === true;
+            this.mappings.set(ip, {
+                domain,
+                verified,
+                expires: verified ? MAX_DATE - Date.now() : 0,
+                lastVerified: verified ? MAX_DATE - Date.now() : undefined
+            });
+        });
+    }
+    remove(ma) {
+        const host = this.findHost(ma);
+        let wasConfident = false;
+        for (const [ip, mapping] of this.mappings.entries()) {
+            if (mapping.domain === host) {
+                this.log('removing %s to %s DNS mapping %e', ip, mapping.domain, new Error('where'));
+                this.mappings.delete(ip);
+                wasConfident = wasConfident || mapping.verified;
+            }
+        }
+        return wasConfident;
+    }
+    getAll(addresses) {
+        const dnsMappedAddresses = [];
+        for (let i = 0; i < addresses.length; i++) {
+            const address = addresses[i];
+            const tuples = address.multiaddr.stringTuples();
+            const host = tuples[0][1];
+            if (host == null) {
+                continue;
+            }
+            for (const [ip, mapping] of this.mappings.entries()) {
+                if (host !== ip) {
+                    continue;
+                }
+                // insert SNI tuple after TLS tuple, if one is present
+                const mappedIp = this.maybeAddSNITuple(tuples, mapping.domain);
+                if (mappedIp) {
+                    // remove the address and replace it with the version that includes
+                    // the SNI tuple
+                    addresses.splice(i, 1);
+                    i--;
+                    dnsMappedAddresses.push({
+                        multiaddr: multiaddr(`/${tuples.map(tuple => {
+                            return [
+                                protocols(tuple[0]).name,
+                                tuple[1]
+                            ].join('/');
+                        }).join('/')}`),
+                        verified: mapping.verified,
+                        type: 'dns-mapping',
+                        expires: mapping.expires,
+                        lastVerified: mapping.lastVerified
+                    });
+                }
+            }
+        }
+        return dnsMappedAddresses;
+    }
+    maybeAddSNITuple(tuples, domain) {
+        for (let j = 0; j < tuples.length; j++) {
+            if (tuples[j][0] === CODEC_TLS && tuples[j + 1]?.[0] !== CODEC_SNI) {
+                tuples.splice(j + 1, 0, [CODEC_SNI, domain]);
+                return true;
+            }
+        }
+        return false;
+    }
+    confirm(ma, ttl) {
+        const host = this.findHost(ma);
+        let startingConfidence = false;
+        for (const [ip, mapping] of this.mappings.entries()) {
+            if (mapping.domain === host) {
+                this.log('marking %s to %s DNS mapping as verified', ip, mapping.domain);
+                startingConfidence = mapping.verified;
+                mapping.verified = true;
+                mapping.expires = Date.now() + ttl;
+                mapping.lastVerified = Date.now();
+            }
+        }
+        return startingConfidence;
+    }
+    unconfirm(ma, ttl) {
+        const host = this.findHost(ma);
+        let wasConfident = false;
+        for (const [ip, mapping] of this.mappings.entries()) {
+            if (mapping.domain === host) {
+                this.log('removing verification of %s to %s DNS mapping', ip, mapping.domain);
+                wasConfident = wasConfident || mapping.verified;
+                mapping.verified = false;
+                mapping.expires = Date.now() + ttl;
+            }
+        }
+        return wasConfident;
+    }
+    findHost(ma) {
+        for (const tuple of ma.stringTuples()) {
+            if (tuple[0] === CODEC_SNI) {
+                return tuple[1];
+            }
+            if (tuple[0] === CODEC_DNS || tuple[0] === CODEC_DNS4 || tuple[0] === CODEC_DNS6 || tuple[0] === CODEC_DNSADDR) {
+                return tuple[1];
+            }
+        }
+    }
+}
+//# sourceMappingURL=dns-mappings.js.map

package/dist/src/address-manager/dns-mappings.js.map

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

package/dist/src/{address-manager.d.ts → address-manager/index.d.ts}

@@ -1,6 +1,11 @@
 import type { ComponentLogger, Libp2pEvents, TypedEventTarget, PeerId, PeerStore } from '@libp2p/interface';
-import type { AddressManager as AddressManagerInterface, TransportManager } from '@libp2p/interface-internal';
+import type { AddressManager as AddressManagerInterface, TransportManager, NodeAddress, ConfirmAddressOptions } from '@libp2p/interface-internal';
 import type { Multiaddr } from '@multiformats/multiaddr';
+export declare const defaultValues: {
+    maxObservedAddresses: number;
+    addressVerificationTTL: number;
+    addressVerificationRetry: number;
+};
 export interface AddressManagerInit {
     /**
      * Pass an function in this field to override the list of addresses
@@ -8,17 +13,44 @@ export interface AddressManagerInit {
      */
     announceFilter?: AddressFilter;
     /**
-     * list of multiaddrs string representation to listen
+     * A list of string multiaddrs to listen on
      */
     listen?: string[];
     /**
-     * list of multiaddrs string representation to announce
+     * A list of string multiaddrs to use instead of those reported by transports
      */
     announce?: string[];
     /**
-     * list of multiaddrs string representation to never announce
+     * A list of string multiaddrs string to never announce
      */
     noAnnounce?: string[];
+    /**
+     * A list of string multiaddrs to add to the list of announced addresses
+     */
+    appendAnnounce?: string[];
+    /**
+     * Limits the number of observed addresses we will store
+     */
+    maxObservedAddresses?: number;
+    /**
+     * How long before each public address should be reverified in ms.
+     *
+     * Requires `@libp2p/autonat` or some other verification method to be
+     * configured.
+     *
+     * @default 600_000
+     */
+    addressVerificationTTL?: number;
+    /**
+     * After a transport or mapped address has failed to verify, how long to wait
+     * before retrying it in ms
+     *
+     * Requires `@libp2p/autonat` or some other verification method to be
+     * configured.
+     *
+     * @default 300_000
+     */
+    addressVerificationRetry?: number;
 }
 export interface AddressManagerComponents {
     peerId: PeerId;
@@ -39,10 +71,15 @@ export declare class AddressManager implements AddressManagerInterface {
     private readonly components;
     private readonly listen;
     private readonly announce;
-    private readonly observed;
+    private readonly appendAnnounce;
     private readonly announceFilter;
-    private readonly ipDomainMappings;
-    private readonly where;
+    private readonly observed;
+    private readonly dnsMappings;
+    private readonly ipMappings;
+    private readonly transportAddresses;
+    private readonly observedAddressFilter;
+    private readonly addressVerificationTTL;
+    private readonly addressVerificationRetry;
     /**
      * Responsible for managing the peer addresses.
      * Peers can specify their listen and announce addresses.
@@ -60,6 +97,10 @@ export declare class AddressManager implements AddressManagerInterface {
      * Get peer announcing multiaddrs
      */
     getAnnounceAddrs(): Multiaddr[];
+    /**
+     * Get peer announcing multiaddrs
+     */
+    getAppendAnnounceAddrs(): Multiaddr[];
     /**
      * Get observed multiaddrs
      */
@@ -68,10 +109,13 @@ export declare class AddressManager implements AddressManagerInterface {
      * Add peer observed addresses
      */
     addObservedAddr(addr: Multiaddr): void;
-    confirmObservedAddr(addr: Multiaddr): void;
-    removeObservedAddr(addr: Multiaddr): void;
+    confirmObservedAddr(addr: Multiaddr, options?: ConfirmAddressOptions): void;
+    removeObservedAddr(addr: Multiaddr, options?: ConfirmAddressOptions): void;
     getAddresses(): Multiaddr[];
+    getAddressesWithMetadata(): NodeAddress[];
     addDNSMapping(domain: string, addresses: string[]): void;
     removeDNSMapping(domain: string): void;
+    addPublicAddressMapping(internalIp: string, internalPort: number, externalIp: string, externalPort?: number, protocol?: 'tcp' | 'udp'): void;
+    removePublicAddressMapping(internalIp: string, internalPort: number, externalIp: string, externalPort?: number, protocol?: 'tcp' | 'udp'): void;
 }
-//# sourceMappingURL=address-manager.d.ts.map
+//# sourceMappingURL=index.d.ts.map

package/dist/src/address-manager/index.d.ts.map

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

package/dist/src/address-manager/index.js

@@ -0,0 +1,264 @@
+/* eslint-disable complexity */
+import { isIPv4 } from '@chainsafe/is-ip';
+import { peerIdFromString } from '@libp2p/peer-id';
+import { debounce } from '@libp2p/utils/debounce';
+import { createScalableCuckooFilter } from '@libp2p/utils/filters';
+import { multiaddr } from '@multiformats/multiaddr';
+import { DNSMappings } from './dns-mappings.js';
+import { IPMappings } from './ip-mappings.js';
+import { ObservedAddresses } from './observed-addresses.js';
+import { TransportAddresses } from './transport-addresses.js';
+const ONE_MINUTE = 60_000;
+export const defaultValues = {
+    maxObservedAddresses: 10,
+    addressVerificationTTL: ONE_MINUTE * 10,
+    addressVerificationRetry: ONE_MINUTE * 5
+};
+const defaultAddressFilter = (addrs) => addrs;
+/**
+ * If the passed multiaddr contains the passed peer id, remove it
+ */
+function stripPeerId(ma, peerId) {
+    const observedPeerIdStr = ma.getPeerId();
+    // strip our peer id if it has been passed
+    if (observedPeerIdStr != null) {
+        const observedPeerId = peerIdFromString(observedPeerIdStr);
+        // use same encoding for comparison
+        if (observedPeerId.equals(peerId)) {
+            ma = ma.decapsulate(multiaddr(`/p2p/${peerId.toString()}`));
+        }
+    }
+    return ma;
+}
+export class AddressManager {
+    log;
+    components;
+    // this is an array to allow for duplicates, e.g. multiples of `/ip4/0.0.0.0/tcp/0`
+    listen;
+    announce;
+    appendAnnounce;
+    announceFilter;
+    observed;
+    dnsMappings;
+    ipMappings;
+    transportAddresses;
+    observedAddressFilter;
+    addressVerificationTTL;
+    addressVerificationRetry;
+    /**
+     * Responsible for managing the peer addresses.
+     * Peers can specify their listen and announce addresses.
+     * The listen addresses will be used by the libp2p transports to listen for new connections,
+     * while the announce addresses will be used for the peer addresses' to other peers in the network.
+     */
+    constructor(components, init = {}) {
+        const { listen = [], announce = [], appendAnnounce = [] } = init;
+        this.components = components;
+        this.log = components.logger.forComponent('libp2p:address-manager');
+        this.listen = listen.map(ma => ma.toString());
+        this.announce = new Set(announce.map(ma => ma.toString()));
+        this.appendAnnounce = new Set(appendAnnounce.map(ma => ma.toString()));
+        this.observed = new ObservedAddresses(components, init);
+        this.dnsMappings = new DNSMappings(components, init);
+        this.ipMappings = new IPMappings(components, init);
+        this.transportAddresses = new TransportAddresses(components, init);
+        this.announceFilter = init.announceFilter ?? defaultAddressFilter;
+        this.observedAddressFilter = createScalableCuckooFilter(1024);
+        this.addressVerificationTTL = init.addressVerificationTTL ?? defaultValues.addressVerificationTTL;
+        this.addressVerificationRetry = init.addressVerificationRetry ?? defaultValues.addressVerificationRetry;
+        // this method gets called repeatedly on startup when transports start listening so
+        // debounce it so we don't cause multiple self:peer:update events to be emitted
+        this._updatePeerStoreAddresses = debounce(this._updatePeerStoreAddresses.bind(this), 1000);
+        // update our stored addresses when new transports listen
+        components.events.addEventListener('transport:listening', () => {
+            this._updatePeerStoreAddresses();
+        });
+        // update our stored addresses when existing transports stop listening
+        components.events.addEventListener('transport:close', () => {
+            this._updatePeerStoreAddresses();
+        });
+    }
+    [Symbol.toStringTag] = '@libp2p/address-manager';
+    _updatePeerStoreAddresses() {
+        // if announce addresses have been configured, ensure they make it into our peer
+        // record for things like identify
+        const addrs = this.getAddresses()
+            .map(ma => {
+            // strip our peer id if it is present
+            if (ma.getPeerId() === this.components.peerId.toString()) {
+                return ma.decapsulate(`/p2p/${this.components.peerId.toString()}`);
+            }
+            return ma;
+        });
+        this.components.peerStore.patch(this.components.peerId, {
+            multiaddrs: addrs
+        })
+            .catch(err => {
+            this.log.error('error updating addresses', err);
+        });
+    }
+    /**
+     * Get peer listen multiaddrs
+     */
+    getListenAddrs() {
+        return Array.from(this.listen).map((a) => multiaddr(a));
+    }
+    /**
+     * Get peer announcing multiaddrs
+     */
+    getAnnounceAddrs() {
+        return Array.from(this.announce).map((a) => multiaddr(a));
+    }
+    /**
+     * Get peer announcing multiaddrs
+     */
+    getAppendAnnounceAddrs() {
+        return Array.from(this.appendAnnounce).map((a) => multiaddr(a));
+    }
+    /**
+     * Get observed multiaddrs
+     */
+    getObservedAddrs() {
+        return this.observed.getAll().map(addr => addr.multiaddr);
+    }
+    /**
+     * Add peer observed addresses
+     */
+    addObservedAddr(addr) {
+        const tuples = addr.stringTuples();
+        const socketAddress = `${tuples[0][1]}:${tuples[1][1]}`;
+        // ignore if this address if it's been observed before
+        if (this.observedAddressFilter.has(socketAddress)) {
+            return;
+        }
+        this.observedAddressFilter.add(socketAddress);
+        addr = stripPeerId(addr, this.components.peerId);
+        // ignore observed address if it is an IP mapping
+        if (this.ipMappings.has(addr)) {
+            return;
+        }
+        // ignore observed address if it is a DNS mapping
+        if (this.dnsMappings.has(addr)) {
+            return;
+        }
+        this.observed.add(addr);
+    }
+    confirmObservedAddr(addr, options) {
+        addr = stripPeerId(addr, this.components.peerId);
+        let startingConfidence = true;
+        if (options?.type === 'observed' || this.observed.has(addr)) {
+            startingConfidence = this.observed.confirm(addr, options?.ttl ?? this.addressVerificationTTL);
+        }
+        if (options?.type === 'transport' || this.transportAddresses.has(addr)) {
+            startingConfidence = this.transportAddresses.confirm(addr, options?.ttl ?? this.addressVerificationTTL);
+        }
+        if (options?.type === 'dns-mapping' || this.dnsMappings.has(addr)) {
+            startingConfidence = this.dnsMappings.confirm(addr, options?.ttl ?? this.addressVerificationTTL);
+        }
+        if (options?.type === 'ip-mapping' || this.ipMappings.has(addr)) {
+            startingConfidence = this.ipMappings.confirm(addr, options?.ttl ?? this.addressVerificationTTL);
+        }
+        // only trigger the 'self:peer:update' event if our confidence in an address has changed
+        if (!startingConfidence) {
+            this._updatePeerStoreAddresses();
+        }
+    }
+    removeObservedAddr(addr, options) {
+        addr = stripPeerId(addr, this.components.peerId);
+        let startingConfidence = false;
+        if (this.observed.has(addr)) {
+            startingConfidence = this.observed.remove(addr);
+        }
+        if (this.transportAddresses.has(addr)) {
+            startingConfidence = this.transportAddresses.unconfirm(addr, options?.ttl ?? this.addressVerificationRetry);
+        }
+        if (this.dnsMappings.has(addr)) {
+            startingConfidence = this.dnsMappings.unconfirm(addr, options?.ttl ?? this.addressVerificationRetry);
+        }
+        if (this.ipMappings.has(addr)) {
+            startingConfidence = this.ipMappings.unconfirm(addr, options?.ttl ?? this.addressVerificationRetry);
+        }
+        // only trigger the 'self:peer:update' event if our confidence in an address has changed
+        if (startingConfidence) {
+            this._updatePeerStoreAddresses();
+        }
+    }
+    getAddresses() {
+        const addresses = new Set();
+        const multiaddrs = this.getAddressesWithMetadata()
+            .filter(addr => {
+            if (!addr.verified) {
+                return false;
+            }
+            const maStr = addr.multiaddr.toString();
+            if (addresses.has(maStr)) {
+                return false;
+            }
+            addresses.add(maStr);
+            return true;
+        })
+            .map(address => address.multiaddr);
+        // filter addressees before returning
+        return this.announceFilter(multiaddrs.map(str => {
+            const ma = multiaddr(str);
+            // do not append our peer id to a path multiaddr as it will become invalid
+            if (ma.protos().pop()?.path === true) {
+                return ma;
+            }
+            if (ma.getPeerId() === this.components.peerId.toString()) {
+                return ma;
+            }
+            return ma.encapsulate(`/p2p/${this.components.peerId.toString()}`);
+        }));
+    }
+    getAddressesWithMetadata() {
+        const announceMultiaddrs = this.getAnnounceAddrs();
+        if (announceMultiaddrs.length > 0) {
+            return announceMultiaddrs.map(multiaddr => ({
+                multiaddr,
+                verified: true,
+                type: 'announce',
+                expires: Date.now() + this.addressVerificationTTL,
+                lastVerified: Date.now()
+            }));
+        }
+        let addresses = [];
+        // add transport addresses
+        addresses = addresses.concat(this.components.transportManager.getAddrs()
+            .map(multiaddr => this.transportAddresses.get(multiaddr, this.addressVerificationTTL)));
+        // add append announce addresses
+        addresses = addresses.concat(this.getAppendAnnounceAddrs().map(multiaddr => ({
+            multiaddr,
+            verified: true,
+            type: 'announce',
+            expires: Date.now() + this.addressVerificationTTL,
+            lastVerified: Date.now()
+        })));
+        // add observed addresses
+        addresses = addresses.concat(this.observed.getAll());
+        // add ip mapped addresses
+        addresses = addresses.concat(this.ipMappings.getAll(addresses));
+        // add ip->domain mappings, must be done after IP mappings
+        addresses = addresses.concat(this.dnsMappings.getAll(addresses));
+        return addresses;
+    }
+    addDNSMapping(domain, addresses) {
+        this.dnsMappings.add(domain, addresses);
+    }
+    removeDNSMapping(domain) {
+        if (this.dnsMappings.remove(multiaddr(`/dns/${domain}`))) {
+            this._updatePeerStoreAddresses();
+        }
+    }
+    addPublicAddressMapping(internalIp, internalPort, externalIp, externalPort = internalPort, protocol = 'tcp') {
+        this.ipMappings.add(internalIp, internalPort, externalIp, externalPort, protocol);
+        // remove duplicate observed addresses
+        this.observed.removePrefixed(`/ip${isIPv4(externalIp) ? 4 : 6}/${externalIp}/${protocol}/${externalPort}`);
+    }
+    removePublicAddressMapping(internalIp, internalPort, externalIp, externalPort = internalPort, protocol = 'tcp') {
+        if (this.ipMappings.remove(multiaddr(`/ip${isIPv4(externalIp) ? 4 : 6}/${externalIp}/${protocol}/${externalPort}`))) {
+            this._updatePeerStoreAddresses();
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/src/address-manager/index.js.map

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

package/dist/src/address-manager/ip-mappings.d.ts

@@ -0,0 +1,18 @@
+import type { AddressManagerComponents, AddressManagerInit } from './index.js';
+import type { NodeAddress } from '@libp2p/interface-internal';
+import type { Multiaddr } from '@multiformats/multiaddr';
+export declare const defaultValues: {
+    maxObservedAddresses: number;
+};
+export declare class IPMappings {
+    private readonly log;
+    private readonly mappings;
+    constructor(components: AddressManagerComponents, init?: AddressManagerInit);
+    has(ma: Multiaddr): boolean;
+    add(internalIp: string, internalPort: number, externalIp: string, externalPort?: number, protocol?: 'tcp' | 'udp'): void;
+    remove(ma: Multiaddr): boolean;
+    getAll(addresses: NodeAddress[]): NodeAddress[];
+    confirm(ma: Multiaddr, ttl: number): boolean;
+    unconfirm(ma: Multiaddr, ttl: number): boolean;
+}
+//# sourceMappingURL=ip-mappings.d.ts.map

package/dist/src/address-manager/ip-mappings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip-mappings.d.ts","sourceRoot":"","sources":["../../../src/address-manager/ip-mappings.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAE9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAExD,eAAO,MAAM,aAAa;;CAEzB,CAAA;AAmBD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;gBAEjD,UAAU,EAAE,wBAAwB,EAAE,IAAI,GAAE,kBAAuB;IAKhF,GAAG,CAAE,EAAE,EAAE,SAAS,GAAG,OAAO;IAc5B,GAAG,CAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,GAAE,MAAqB,EAAE,QAAQ,GAAE,KAAK,GAAG,KAAa,GAAG,IAAI;IAkB9I,MAAM,CAAE,EAAE,EAAE,SAAS,GAAG,OAAO;IA4B/B,MAAM,CAAE,SAAS,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE;IAiDhD,OAAO,CAAE,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAqB7C,SAAS,CAAE,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;CAuBhD"}