libp2p 0.35.6 → 0.35.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -23,8 +23,8 @@
23
23
  <a href="https://david-dm.org/libp2p/js-libp2p"><img src="https://david-dm.org/libp2p/js-libp2p.svg?style=flat-square" /></a>
24
24
  <a href="https://github.com/feross/standard"><img src="https://img.shields.io/badge/code%20style-standard-brightgreen.svg?style=flat-square"></a>
25
25
  <a href="https://github.com/RichardLitt/standard-readme"><img src="https://img.shields.io/badge/standard--readme-OK-green.svg?style=flat-square" /></a>
26
- <a href=""><img src="https://img.shields.io/badge/npm-%3E%3D6.0.0-orange.svg?style=flat-square" /></a>
27
- <a href=""><img src="https://img.shields.io/badge/Node.js-%3E%3D12.0.0-orange.svg?style=flat-square" /></a>
26
+ <a href=""><img src="https://img.shields.io/badge/npm-%3E%3D7.0.0-orange.svg?style=flat-square" /></a>
27
+ <a href=""><img src="https://img.shields.io/badge/Node.js-%3E%3D15.0.0-orange.svg?style=flat-square" /></a>
28
28
  <br>
29
29
  </p>
30
30
 
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/connection-manager/index.js"],"names":[],"mappings":";AAsCA;;;GAGG;AAEH;;;;;;;;;;;;;GAaG;AAEH;;;;GAIG;AACH;IACE;;;;;;OAMG;IACH,oBAHW,MAAM,YACN,wBAAwB,EAqClC;IAhCC,uBAAqB;IACrB,gBAA0C;IAE1C,cAAqF;IAOrF;;;;OAIG;IACH,aAFU,IAAI,MAAM,EAAE,MAAM,CAAC,CAED;IAE5B;;;;OAIG;IACH,aAFU,IAAI,MAAM,EAAE,UAAU,EAAE,CAAC,CAEP;IAE5B,kBAAqB;IACrB,YAAkB;IAsFpB;;;;;OAKG;IACH,sBAcC;IAvGC,gCAGE;IAGJ;;OAEG;IACH,mBAGC;IAED;;;OAGG;IACH,cAYC;IAqKD;;;;;OAKG;IACH,0BAEC;IA3KD;;;;OAIG;IACH,sBASC;IAED;;;;OAIG;IACH,wBAaC;IAED;;;;;;;OAOG;IACH,qBAJW,MAAM,SACN,MAAM,GACJ,IAAI,CAOhB;IAwBD;;;;;OAKG;IACH,sBAHW,UAAU,GACR,IAAI,CAwBhB;IAED;;;;;OAKG;IACH,yBAHW,UAAU,GACR,IAAI,CAmBhB;IAED;;;;;OAKG;IACH,YAHW,MAAM,GACJ,UAAU,GAAC,IAAI,CAQ3B;IAED;;;;;OAKG;IACH,eAHW,MAAM,GACJ,UAAU,EAAE,CAexB;IAYD;;;;;;OAMG;IACH,uBAOC;IAED;;;;;OAKG;IACH,4BAiBC;CACF;;;;;;;;cApTY,OAAO,KAAK,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/connection-manager/index.js"],"names":[],"mappings":";AAsCA;;;GAGG;AAEH;;;;;;;;;;;;;GAaG;AAEH;;;;GAIG;AACH;IACE;;;;;;OAMG;IACH,oBAHW,MAAM,YACN,wBAAwB,EAqClC;IAhCC,uBAAqB;IACrB,gBAA0C;IAE1C,cAAqF;IAOrF;;;;OAIG;IACH,aAFU,IAAI,MAAM,EAAE,MAAM,CAAC,CAE8D;IAE3F;;;;OAIG;IACH,aAFU,IAAI,MAAM,EAAE,UAAU,EAAE,CAAC,CAE6D;IAEhG,kBAAqB;IACrB,YAAkB;IAoFpB;;;;;OAKG;IACH,sBAcC;IArGC,gCAGE;IAGJ;;OAEG;IACH,mBAGC;IAED;;;OAGG;IACH,cAYC;IA8JD;;;;;OAKG;IACH,0BAEC;IApKD;;;;OAIG;IACH,sBASC;IAED;;;;OAIG;IACH,wBAWC;IAED;;;;;;;OAOG;IACH,qBAJW,MAAM,SACN,MAAM,GACJ,IAAI,CAOhB;IAwBD;;;;;OAKG;IACH,sBAHW,UAAU,GACR,IAAI,CAsBhB;IAED;;;;;OAKG;IACH,yBAHW,UAAU,GACR,IAAI,CAgBhB;IAED;;;;;OAKG;IACH,YAHW,MAAM,GACJ,UAAU,GAAC,IAAI,CAQ3B;IAED;;;;;OAKG;IACH,eAHW,MAAM,GACJ,UAAU,EAAE,CAexB;IAYD;;;;;;OAMG;IACH,uBAOC;IAED;;;;;OAKG;IACH,4BAiBC;CACF;;;;;;;;cA7SY,OAAO,KAAK,CAAC"}
@@ -27,8 +27,8 @@ export = Dialer;
27
27
  * @property {Multiaddr[]} addrs
28
28
  *
29
29
  * @typedef PendingDial
30
- * @property {DialRequest} dialRequest
31
- * @property {TimeoutController} controller
30
+ * @property {import('./dial-request')} dialRequest
31
+ * @property {import('timeout-abort-controller').TimeoutController} controller
32
32
  * @property {Promise<Connection>} promise
33
33
  * @property {function():void} destroy
34
34
  */
@@ -46,9 +46,13 @@ declare class Dialer {
46
46
  timeout: number;
47
47
  maxDialsPerPeer: number;
48
48
  tokens: number[];
49
- _pendingDials: Map<any, any>;
50
- _pendingDialTargets: Map<any, any>;
51
- _metrics: import("../metrics") | undefined;
49
+ /** @type {Map<string, PendingDial>} */
50
+ _pendingDials: Map<string, PendingDial>;
51
+ /** @type {Map<string, { resolve: (value: any) => void, reject: (err: Error) => void}>} */
52
+ _pendingDialTargets: Map<string, {
53
+ resolve: (value: any) => void;
54
+ reject: (err: Error) => void;
55
+ }>;
52
56
  /**
53
57
  * Clears any pending dials
54
58
  */
@@ -122,6 +126,12 @@ declare class Dialer {
122
126
  declare namespace Dialer {
123
127
  export { Connection, PeerId, PeerStore, Address, TransportManager, DialerProperties, Resolver, DialerOptions, DialTarget, PendingDial };
124
128
  }
129
+ type PendingDial = {
130
+ dialRequest: import('./dial-request');
131
+ controller: import('timeout-abort-controller').TimeoutController;
132
+ promise: Promise<Connection>;
133
+ destroy: () => void;
134
+ };
125
135
  type PeerId = import('peer-id');
126
136
  import { Multiaddr } from "multiaddr";
127
137
  type Connection = import("libp2p-interfaces/src/connection/connection");
@@ -164,10 +174,4 @@ type PeerStore = import('../peer-store');
164
174
  type Address = import('../peer-store/address-book').Address;
165
175
  type TransportManager = import('../transport-manager');
166
176
  type Resolver = (addr: Multiaddr) => Promise<string[]>;
167
- type PendingDial = {
168
- dialRequest: DialRequest;
169
- controller: TimeoutController;
170
- promise: Promise<Connection>;
171
- destroy: () => void;
172
- };
173
177
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dialer/index.js"],"names":[],"mappings":";AA6BA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;IACE;;;OAGG;IACH,gJAFW,gBAAgB,GAAG,aAAa,EA4B1C;IAfC,iDAAwC;IACxC,mCAA0B;IAC1B,2BArCsB,OAAO,EAAE,KAAK,OAAO,EAAE,CAqCX;IAClC,yBAAwC;IACxC,uBAAoC;IACpC,gBAA0B;IAC1B,wBAAsC;IACtC,iBAAuE;IACvE,6BAA8B;IAC9B,mCAAoC;IACpC,2CAAuB;IAOzB;;OAEG;IACH,gBAiBC;IAED;;;;;;;;;OASG;IACH,oBALW,MAAM,GAAC,SAAS,GAAC,MAAM;;oBAGrB,QAAQ,UAAU,CAAC,CAwB/B;IAED;;;;;;;OAOG;IACH,mCAHW,MAAM,GAAC,SAAS,GAAC,MAAM,GACrB,QAAQ,UAAU,CAAC,CAqB/B;IAED;;;;;;;;;OASG;IACH,0BAmCC;IAED;;;;;;;;OAQG;IACH,2BAyCC;IAED;;OAEG;IACH,eAFW,MAAM,YAOhB;IAED;;OAEG;IACH,oBAFW,MAAM,QAOhB;IAED;;;;;OAKG;IACH,aAHW,SAAS,GACP,QAAQ,SAAS,EAAE,CAAC,CAwBhC;IAED;;;;;OAKG;IACH,mBAHW,SAAS,GACP,QAAQ,SAAS,EAAE,CAAC,CAWhC;CACF;;;;cA5TY,OAAO,SAAS,CAAC;;;;QAuBhB,MAAM;WACN,SAAS,EAAE;;;eAhBX,SAAS;sBACT,gBAAgB;;;;;;iCAKJ,OAAO,EAAE,KAAK,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;iBAbpC,OAAO,eAAe,CAAC;eACvB,OAAO,4BAA4B,EAAE,OAAO;wBAC5C,OAAO,sBAAsB,CAAC;uBAQxB,SAAS,KAAK,QAAQ,MAAM,EAAE,CAAC;;iBAgBpC,WAAW;gBACX,iBAAiB;aACjB,QAAQ,UAAU,CAAC;mBACR,IAAI"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dialer/index.js"],"names":[],"mappings":";AA6BA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;IACE;;;OAGG;IACH,gJAFW,gBAAgB,GAAG,aAAa,EA+B1C;IAlBC,iDAAwC;IACxC,mCAA0B;IAC1B,2BArCsB,OAAO,EAAE,KAAK,OAAO,EAAE,CAqCX;IAClC,yBAAwC;IACxC,uBAAoC;IACpC,gBAA0B;IAC1B,wBAAsC;IACtC,iBAAuE;IAEvE,uCAAuC;IACvC,eADW,IAAI,MAAM,EAAE,WAAW,CAAC,CAC+C;IAElF,0FAA0F;IAC1F;yBAD0C,GAAG,KAAK,IAAI;sBAAgB,KAAK,KAAK,IAAI;OACW;IAOjG;;OAEG;IACH,gBAcC;IAED;;;;;;;;;OASG;IACH,oBALW,MAAM,GAAC,SAAS,GAAC,MAAM;;oBAGrB,QAAQ,UAAU,CAAC,CAwB/B;IAED;;;;;;;OAOG;IACH,mCAHW,MAAM,GAAC,SAAS,GAAC,MAAM,GACrB,QAAQ,UAAU,CAAC,CAmB/B;IAED;;;;;;;;;OASG;IACH,0BAmCC;IAED;;;;;;;;OAQG;IACH,2BAsCC;IAED;;OAEG;IACH,eAFW,MAAM,YAOhB;IAED;;OAEG;IACH,oBAFW,MAAM,QAOhB;IAED;;;;;OAKG;IACH,aAHW,SAAS,GACP,QAAQ,SAAS,EAAE,CAAC,CAwBhC;IAED;;;;;OAKG;IACH,mBAHW,SAAS,GACP,QAAQ,SAAS,EAAE,CAAC,CAWhC;CACF;;;;;iBA5Ra,OAAO,gBAAgB,CAAC;gBACxB,OAAO,0BAA0B,EAAE,iBAAiB;aACpD,QAAQ,UAAU,CAAC;mBACR,IAAI;;cA9BhB,OAAO,SAAS,CAAC;;;;QAuBhB,MAAM;WACN,SAAS,EAAE;;;eAhBX,SAAS;sBACT,gBAAgB;;;;;;iCAKJ,OAAO,EAAE,KAAK,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;iBAbpC,OAAO,eAAe,CAAC;eACvB,OAAO,4BAA4B,EAAE,OAAO;wBAC5C,OAAO,sBAAsB,CAAC;uBAQxB,SAAS,KAAK,QAAQ,MAAM,EAAE,CAAC"}
@@ -12,6 +12,8 @@ export = Libp2p;
12
12
  * @typedef {import('libp2p-interfaces/src/pubsub').PubsubOptions} PubsubOptions
13
13
  * @typedef {import('interface-datastore').Datastore} Datastore
14
14
  * @typedef {import('./pnet')} Protector
15
+ * @typedef {Object} PersistentPeerStoreOptions
16
+ * @property {number} [threshold]
15
17
  */
16
18
  /**
17
19
  * @typedef {Object} HandlerProps
@@ -73,7 +75,7 @@ export = Libp2p;
73
75
  * @property {KeychainOptions & import('./keychain/index').KeychainOptions} [keychain]
74
76
  * @property {MetricsOptions & import('./metrics').MetricsOptions} [metrics]
75
77
  * @property {import('./peer-routing').PeerRoutingOptions} [peerRouting]
76
- * @property {PeerStoreOptions & import('./peer-store/persistent').PersistentPeerStoreOptions} [peerStore]
78
+ * @property {PeerStoreOptions & PersistentPeerStoreOptions} [peerStore]
77
79
  * @property {import('./transport-manager').TransportManagerOptions} [transportManager]
78
80
  * @property {Libp2pConfig} [config]
79
81
  *
@@ -186,6 +188,7 @@ declare class Libp2p extends EventEmitter {
186
188
  /** @type {PeerId} */
187
189
  peerId: PeerId;
188
190
  datastore: import("interface-datastore").Datastore | undefined;
191
+ metrics: Metrics | undefined;
189
192
  peerStore: PeerStore;
190
193
  addresses: {
191
194
  listen: never[];
@@ -239,7 +242,6 @@ declare class Libp2p extends EventEmitter {
239
242
  _discovery: Map<any, any>;
240
243
  connectionManager: ConnectionManager;
241
244
  _autodialler: AutoDialler;
242
- metrics: Metrics | undefined;
243
245
  keychain: Keychain | undefined;
244
246
  upgrader: Upgrader;
245
247
  transportManager: TransportManager;
@@ -391,7 +393,7 @@ declare class Libp2p extends EventEmitter {
391
393
  private _setupPeerDiscovery;
392
394
  }
393
395
  declare namespace Libp2p {
394
- export { Connection, MuxedStream, TransportFactory, MuxerFactory, ContentRoutingModule, PeerDiscoveryFactory, PeerRoutingModule, Crypto, Pubsub, PubsubOptions, Datastore, Protector, HandlerProps, DhtOptions, KeychainOptions, PeerStoreOptions, PubsubLocalOptions, MetricsOptions, RelayOptions, Libp2pConfig, Libp2pModules, Libp2pOptions, constructorOptions, CreateOptions };
396
+ export { Connection, MuxedStream, TransportFactory, MuxerFactory, ContentRoutingModule, PeerDiscoveryFactory, PeerRoutingModule, Crypto, Pubsub, PubsubOptions, Datastore, Protector, PersistentPeerStoreOptions, HandlerProps, DhtOptions, KeychainOptions, PeerStoreOptions, PubsubLocalOptions, MetricsOptions, RelayOptions, Libp2pConfig, Libp2pModules, Libp2pOptions, constructorOptions, CreateOptions };
395
397
  }
396
398
  import { EventEmitter } from "events";
397
399
  type Libp2pOptions = {
@@ -410,7 +412,7 @@ type Libp2pOptions = {
410
412
  keychain?: (KeychainOptions & Keychain.KeychainOptions) | undefined;
411
413
  metrics?: (MetricsOptions & Metrics.MetricsOptions) | undefined;
412
414
  peerRouting?: PeerRouting.PeerRoutingOptions | undefined;
413
- peerStore?: (PeerStoreOptions & PersistentPeerStore.PersistentPeerStoreOptions) | undefined;
415
+ peerStore?: (PeerStoreOptions & PersistentPeerStoreOptions) | undefined;
414
416
  transportManager?: TransportManager.TransportManagerOptions | undefined;
415
417
  config?: Libp2pConfig | undefined;
416
418
  };
@@ -418,6 +420,7 @@ type constructorOptions = {
418
420
  peerId: PeerId;
419
421
  };
420
422
  import PeerId = require("peer-id");
423
+ import Metrics = require("./metrics");
421
424
  import PeerStore = require("./peer-store");
422
425
  import AddressManager = require("./address-manager");
423
426
  type Libp2pModules = {
@@ -450,7 +453,6 @@ type Libp2pConfig = {
450
453
  };
451
454
  import ConnectionManager = require("./connection-manager");
452
455
  import AutoDialler = require("./connection-manager/auto-dialler");
453
- import Metrics = require("./metrics");
454
456
  import Keychain = require("./keychain");
455
457
  import Upgrader = require("./upgrader");
456
458
  import TransportManager = require("./transport-manager");
@@ -482,6 +484,9 @@ type Pubsub = import('libp2p-interfaces/src/pubsub');
482
484
  type PubsubOptions = import('libp2p-interfaces/src/pubsub').PubsubOptions;
483
485
  type Datastore = import('interface-datastore').Datastore;
484
486
  type Protector = import('./pnet');
487
+ type PersistentPeerStoreOptions = {
488
+ threshold?: number | undefined;
489
+ };
485
490
  type DhtOptions = {
486
491
  enabled?: boolean | undefined;
487
492
  kBucketSize?: number | undefined;
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.js"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.js"],"names":[],"mappings":"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"}
@@ -1,6 +1,7 @@
1
1
  export = Stats;
2
2
  /**
3
3
  * @typedef {import('@vascosantos/moving-average').IMovingAverage} IMovingAverage
4
+ * @typedef {import('bignumber.js').BigNumber} Big
4
5
  */
5
6
  declare class Stats extends EventEmitter {
6
7
  /**
@@ -130,8 +131,9 @@ declare class Stats extends EventEmitter {
130
131
  private _applyOp;
131
132
  }
132
133
  declare namespace Stats {
133
- export { IMovingAverage };
134
+ export { IMovingAverage, Big };
134
135
  }
135
136
  import { EventEmitter } from "events";
136
137
  type IMovingAverage = import('@vascosantos/moving-average').IMovingAverage;
138
+ type Big = import('bignumber.js').BigNumber;
137
139
  //# sourceMappingURL=stats.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../src/metrics/stats.js"],"names":[],"mappings":";AAQA;;GAEG;AAEH;IACE;;;;;;OAMG;IACH,6BAHW,MAAM,EAAE,WACR,GAAG,EAkCb;IA7BC,cAAuB;IACvB,cAAgB;IAEhB,mDAAmD;IACnD;sBAD2B,GAAG;kBAAY,GAAG;MAI5C;IAED,2BAAoC;IACpC,2BAAgC;IAEhC,6EAA6E;IAC7E;sBAD2B,cAAc,EAAE;kBAAY,cAAc,EAAE;MAC9C;IAwH3B;;;;;;;;;;OAUG;IACH,gBAaC;IA9HD;;;;;;OAMG;IACH,SAFa,IAAI,CAMhB;IAED;;;;;OAKG;IACH,QAFa,IAAI,CAOhB;IAFG,cAAoB;IAIxB;;OAEG;IACH;sBAzD6B,GAAG;kBAAY,GAAG;MA2D9C;IAED;;OAEG;IACH;sBAvD6B,cAAc,EAAE;kBAAY,cAAc,EAAE;MAyDxE;IAED;;;;OAIG;IACH,cAkBC;IAED;;;;;;;OAOG;IACH,cAJW,MAAM,OACN,MAAM,GACJ,IAAI,CAKhB;IAED;;;;;OAKG;IACH,6BAEC;IAED;;;;;;OAMG;IACH,qBAKC;IA4BD;;;;;;;;OAQG;IACH,yBAQC;IAED;;;;;;;;;OASG;IACH,4BAsBC;IAED;;;;;;;;OAQG;IACH,iBAqBC;CACF;;;;;sBAjQY,OAAO,6BAA6B,EAAE,cAAc"}
1
+ {"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../src/metrics/stats.js"],"names":[],"mappings":";AAQA;;;GAGG;AAEH;IACE;;;;;;OAMG;IACH,6BAHW,MAAM,EAAE,WACR,GAAG,EAkCb;IA7BC,cAAuB;IACvB,cAAgB;IAEhB,mDAAmD;IACnD;sBAD2B,GAAG;kBAAY,GAAG;MAI5C;IAED,2BAAoC;IACpC,2BAAgC;IAEhC,6EAA6E;IAC7E;sBAD2B,cAAc,EAAE;kBAAY,cAAc,EAAE;MAC9C;IAwH3B;;;;;;;;;;OAUG;IACH,gBAaC;IA9HD;;;;;;OAMG;IACH,SAFa,IAAI,CAMhB;IAED;;;;;OAKG;IACH,QAFa,IAAI,CAOhB;IAFG,cAAoB;IAIxB;;OAEG;IACH;sBAzD6B,GAAG;kBAAY,GAAG;MA2D9C;IAED;;OAEG;IACH;sBAvD6B,cAAc,EAAE;kBAAY,cAAc,EAAE;MAyDxE;IAED;;;;OAIG;IACH,cAkBC;IAED;;;;;;;OAOG;IACH,cAJW,MAAM,OACN,MAAM,GACJ,IAAI,CAKhB;IAED;;;;;OAKG;IACH,6BAEC;IAED;;;;;;OAMG;IACH,qBAKC;IA4BD;;;;;;;;OAQG;IACH,yBAQC;IAED;;;;;;;;;OASG;IACH,4BAsBC;IAED;;;;;;;;OAQG;IACH,iBAqBC;CACF;;;;;sBAlQY,OAAO,6BAA6B,EAAE,cAAc;WACpD,OAAO,cAAc,EAAE,SAAS"}
@@ -0,0 +1,3 @@
1
+ declare function _exports<K, V>(component: string, name: string, metrics?: import(".") | undefined): Map<K, V>;
2
+ export = _exports;
3
+ //# sourceMappingURL=tracked-map.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tracked-map.d.ts","sourceRoot":"","sources":["../../../src/metrics/tracked-map.js"],"names":[],"mappings":"AAkDiB,2CALN,MAAM,QACN,MAAM,gDAehB"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "libp2p",
3
- "version": "0.35.6",
3
+ "version": "0.35.7",
4
4
  "description": "JavaScript implementation of libp2p, a modular peer to peer network stack",
5
5
  "leadMaintainer": "Jacob Heun <jacobheun@gmail.com>",
6
6
  "main": "src/index.js",
@@ -181,9 +181,9 @@
181
181
  "Friedel Ziegelmayer <dignifiedquire@gmail.com>",
182
182
  "Maciej Krüger <mkg20001@gmail.com>",
183
183
  "Hugo Dias <mail@hugodias.me>",
184
- "dirkmc <dirkmdev@gmail.com>",
185
- "Chris Dostert <chrisdostert@users.noreply.github.com>",
186
184
  "Volker Mische <volker.mische@gmail.com>",
185
+ "Chris Dostert <chrisdostert@users.noreply.github.com>",
186
+ "dirkmc <dirkmdev@gmail.com>",
187
187
  "Robert Kiel <robert.kiel@hoprnet.org>",
188
188
  "Richard Littauer <richard.littauer@gmail.com>",
189
189
  "zeim839 <50573884+zeim839@users.noreply.github.com>",
@@ -193,22 +193,23 @@
193
193
  "Andrew Nesbitt <andrewnez@gmail.com>",
194
194
  "Franck Royer <franck@royer.one>",
195
195
  "Thomas Eizinger <thomas@eizinger.io>",
196
+ "Vít Habada <vithabada93@gmail.com>",
196
197
  "Giovanni T. Parra <fiatjaf@gmail.com>",
197
198
  "acolytec3 <17355484+acolytec3@users.noreply.github.com>",
198
199
  "Alan Smithee <ggnore.alan.smithee@gmail.com>",
199
200
  "Elven <mon.samuel@qq.com>",
200
201
  "Samlior <samlior@foxmail.com>",
201
202
  "Didrik Nordström <didrik.nordstrom@gmail.com>",
202
- "Soeren <nikorpoulsen@gmail.com>",
203
- "Sönke Hahn <soenkehahn@gmail.com>",
203
+ "Aditya Bose <13054902+adbose@users.noreply.github.com>",
204
204
  "TJKoury <TJKoury@gmail.com>",
205
205
  "TheStarBoys <41286328+TheStarBoys@users.noreply.github.com>",
206
206
  "Tiago Alves <alvesjtiago@gmail.com>",
207
+ "Tim Daubenschütz <tim@daubenschuetz.de>",
207
208
  "XiaoZhang <zxinmyth@gmail.com>",
208
209
  "Yusef Napora <yusef@napora.org>",
209
210
  "Zane Starr <zcstarr@gmail.com>",
210
211
  "ebinks <elizabethjbinks@gmail.com>",
211
- "Aditya Bose <13054902+adbose@users.noreply.github.com>",
212
+ "greenSnot <greenSnot@users.noreply.github.com>",
212
213
  "isan_rivkin <isanrivkin@gmail.com>",
213
214
  "mayerwin <mayerwin@users.noreply.github.com>",
214
215
  "mcclure <andi.m.mcclure@gmail.com>",
@@ -217,7 +218,8 @@
217
218
  "robertkiel <robert.kiel@validitylabs.org>",
218
219
  "shresthagrawal <34920931+shresthagrawal@users.noreply.github.com>",
219
220
  "swedneck <40505480+swedneck@users.noreply.github.com>",
220
- "greenSnot <greenSnot@users.noreply.github.com>",
221
+ "tuyennhv <vutuyen2636@gmail.com>",
222
+ "Sönke Hahn <soenkehahn@gmail.com>",
221
223
  "Aleksei <vozhdb@gmail.com>",
222
224
  "Bernd Strehl <bernd.strehl@gmail.com>",
223
225
  "Chris Bratlien <chrisbratlien@gmail.com>",
@@ -248,6 +250,7 @@
248
250
  "Nuno Nogueira <nunofmn@gmail.com>",
249
251
  "Philipp Muens <raute1337@gmx.de>",
250
252
  "RasmusErik Voel Jensen <github@solsort.com>",
251
- "Smite Chow <xiaopengyou@live.com>"
253
+ "Smite Chow <xiaopengyou@live.com>",
254
+ "Soeren <nikorpoulsen@gmail.com>"
252
255
  ]
253
256
  }
@@ -12,7 +12,7 @@ const LatencyMonitor = require('./latency-monitor')
12
12
  const retimer = require('retimer')
13
13
 
14
14
  const { EventEmitter } = require('events')
15
-
15
+ const trackedMap = require('../metrics/tracked-map')
16
16
  const PeerId = require('peer-id')
17
17
 
18
18
  const {
@@ -34,7 +34,7 @@ const defaultOptions = {
34
34
 
35
35
  const METRICS_COMPONENT = 'connection-manager'
36
36
  const METRICS_PEER_CONNECTIONS = 'peer-connections'
37
- const METRICS_ALL_CONNECTIONS = 'all-connections'
37
+ const METRICS_PEER_VALUES = 'peer-values'
38
38
 
39
39
  /**
40
40
  * @typedef {import('../')} Libp2p
@@ -87,14 +87,14 @@ class ConnectionManager extends EventEmitter {
87
87
  *
88
88
  * @type {Map<string, number>}
89
89
  */
90
- this._peerValues = new Map()
90
+ this._peerValues = trackedMap(METRICS_COMPONENT, METRICS_PEER_VALUES, this._libp2p.metrics)
91
91
 
92
92
  /**
93
93
  * Map of connections per peer
94
94
  *
95
95
  * @type {Map<string, Connection[]>}
96
96
  */
97
- this.connections = new Map()
97
+ this.connections = trackedMap(METRICS_COMPONENT, METRICS_PEER_CONNECTIONS, this._libp2p.metrics)
98
98
 
99
99
  this._started = false
100
100
  this._timer = null
@@ -164,8 +164,6 @@ class ConnectionManager extends EventEmitter {
164
164
 
165
165
  await Promise.all(tasks)
166
166
  this.connections.clear()
167
- this._libp2p.metrics && this._libp2p.metrics.updateComponentMetric(METRICS_COMPONENT, METRICS_PEER_CONNECTIONS, 0)
168
- this._libp2p.metrics && this._libp2p.metrics.updateComponentMetric(METRICS_COMPONENT, METRICS_ALL_CONNECTIONS, 0)
169
167
  }
170
168
 
171
169
  /**
@@ -222,8 +220,6 @@ class ConnectionManager extends EventEmitter {
222
220
  storedConn.push(connection)
223
221
  } else {
224
222
  this.connections.set(peerIdStr, [connection])
225
- this._libp2p.metrics && this._libp2p.metrics.updateComponentMetric(METRICS_COMPONENT, METRICS_PEER_CONNECTIONS, this.connections.size)
226
- this._libp2p.metrics && this._libp2p.metrics.updateComponentMetric(METRICS_COMPONENT, METRICS_ALL_CONNECTIONS, this.size)
227
223
  }
228
224
 
229
225
  this._libp2p.peerStore.keyBook.set(peerId, peerId.pubKey)
@@ -255,9 +251,6 @@ class ConnectionManager extends EventEmitter {
255
251
 
256
252
  this._libp2p.metrics && this._libp2p.metrics.onPeerDisconnected(connection.remotePeer)
257
253
  }
258
-
259
- this._libp2p.metrics && this._libp2p.metrics.updateComponentMetric(METRICS_COMPONENT, METRICS_PEER_CONNECTIONS, this.connections.size)
260
- this._libp2p.metrics && this._libp2p.metrics.updateComponentMetric(METRICS_COMPONENT, METRICS_ALL_CONNECTIONS, this.size)
261
254
  }
262
255
 
263
256
  /**
@@ -14,7 +14,7 @@ const { setMaxListeners } = require('events')
14
14
  const DialRequest = require('./dial-request')
15
15
  const { publicAddressesFirst } = require('libp2p-utils/src/address-sort')
16
16
  const getPeer = require('../get-peer')
17
-
17
+ const trackedMap = require('../metrics/tracked-map')
18
18
  const { codes } = require('../errors')
19
19
  const {
20
20
  DIAL_TIMEOUT,
@@ -56,8 +56,8 @@ const METRICS_PENDING_DIAL_TARGETS = 'pending-dial-targets'
56
56
  * @property {Multiaddr[]} addrs
57
57
  *
58
58
  * @typedef PendingDial
59
- * @property {DialRequest} dialRequest
60
- * @property {TimeoutController} controller
59
+ * @property {import('./dial-request')} dialRequest
60
+ * @property {import('timeout-abort-controller').TimeoutController} controller
61
61
  * @property {Promise<Connection>} promise
62
62
  * @property {function():void} destroy
63
63
  */
@@ -86,9 +86,12 @@ class Dialer {
86
86
  this.timeout = dialTimeout
87
87
  this.maxDialsPerPeer = maxDialsPerPeer
88
88
  this.tokens = [...new Array(maxParallelDials)].map((_, index) => index)
89
- this._pendingDials = new Map()
90
- this._pendingDialTargets = new Map()
91
- this._metrics = metrics
89
+
90
+ /** @type {Map<string, PendingDial>} */
91
+ this._pendingDials = trackedMap(METRICS_COMPONENT, METRICS_PENDING_DIALS, metrics)
92
+
93
+ /** @type {Map<string, { resolve: (value: any) => void, reject: (err: Error) => void}>} */
94
+ this._pendingDialTargets = trackedMap(METRICS_COMPONENT, METRICS_PENDING_DIAL_TARGETS, metrics)
92
95
 
93
96
  for (const [key, value] of Object.entries(resolvers)) {
94
97
  Multiaddr.resolvers.set(key, value)
@@ -112,9 +115,6 @@ class Dialer {
112
115
  pendingTarget.reject(new AbortError('Dialer was destroyed'))
113
116
  }
114
117
  this._pendingDialTargets.clear()
115
-
116
- this._metrics && this._metrics.updateComponentMetric(METRICS_COMPONENT, METRICS_PENDING_DIALS, 0)
117
- this._metrics && this._metrics.updateComponentMetric(METRICS_COMPONENT, METRICS_PENDING_DIAL_TARGETS, 0)
118
118
  }
119
119
 
120
120
  /**
@@ -164,7 +164,6 @@ class Dialer {
164
164
  const id = `${(parseInt(String(Math.random() * 1e9), 10)).toString() + Date.now()}`
165
165
  const cancellablePromise = new Promise((resolve, reject) => {
166
166
  this._pendingDialTargets.set(id, { resolve, reject })
167
- this._metrics && this._metrics.updateComponentMetric(METRICS_COMPONENT, METRICS_PENDING_DIAL_TARGETS, this._pendingDialTargets.size)
168
167
  })
169
168
 
170
169
  try {
@@ -176,7 +175,6 @@ class Dialer {
176
175
  return dialTarget
177
176
  } finally {
178
177
  this._pendingDialTargets.delete(id)
179
- this._metrics && this._metrics.updateComponentMetric(METRICS_COMPONENT, METRICS_PENDING_DIAL_TARGETS, this._pendingDialTargets.size)
180
178
  }
181
179
  }
182
180
 
@@ -269,13 +267,10 @@ class Dialer {
269
267
  destroy: () => {
270
268
  timeoutController.clear()
271
269
  this._pendingDials.delete(dialTarget.id)
272
- this._metrics && this._metrics.updateComponentMetric(METRICS_COMPONENT, METRICS_PENDING_DIALS, this._pendingDials.size)
273
270
  }
274
271
  }
275
272
  this._pendingDials.set(dialTarget.id, pendingDial)
276
273
 
277
- this._metrics && this._metrics.updateComponentMetric(METRICS_COMPONENT, METRICS_PENDING_DIALS, this._pendingDials.size)
278
-
279
274
  return pendingDial
280
275
  }
281
276
 
package/src/index.js CHANGED
@@ -48,6 +48,8 @@ const { updateSelfPeerRecord } = require('./record/utils')
48
48
  * @typedef {import('libp2p-interfaces/src/pubsub').PubsubOptions} PubsubOptions
49
49
  * @typedef {import('interface-datastore').Datastore} Datastore
50
50
  * @typedef {import('./pnet')} Protector
51
+ * @typedef {Object} PersistentPeerStoreOptions
52
+ * @property {number} [threshold]
51
53
  */
52
54
 
53
55
  /**
@@ -110,7 +112,7 @@ const { updateSelfPeerRecord } = require('./record/utils')
110
112
  * @property {KeychainOptions & import('./keychain/index').KeychainOptions} [keychain]
111
113
  * @property {MetricsOptions & import('./metrics').MetricsOptions} [metrics]
112
114
  * @property {import('./peer-routing').PeerRoutingOptions} [peerRouting]
113
- * @property {PeerStoreOptions & import('./peer-store/persistent').PersistentPeerStoreOptions} [peerStore]
115
+ * @property {PeerStoreOptions & PersistentPeerStoreOptions} [peerStore]
114
116
  * @property {import('./transport-manager').TransportManagerOptions} [transportManager]
115
117
  * @property {Libp2pConfig} [config]
116
118
  *
@@ -161,6 +163,15 @@ class Libp2p extends EventEmitter {
161
163
  this.peerId = this._options.peerId
162
164
  this.datastore = this._options.datastore
163
165
 
166
+ // Create Metrics
167
+ if (this._options.metrics.enabled) {
168
+ const metrics = new Metrics({
169
+ ...this._options.metrics
170
+ })
171
+
172
+ this.metrics = metrics
173
+ }
174
+
164
175
  this.peerStore = (this.datastore && this._options.peerStore.persistence)
165
176
  ? new PersistentPeerStore({
166
177
  peerId: this.peerId,
@@ -195,15 +206,6 @@ class Libp2p extends EventEmitter {
195
206
  autoDialInterval: this._options.connectionManager.autoDialInterval
196
207
  })
197
208
 
198
- // Create Metrics
199
- if (this._options.metrics.enabled) {
200
- const metrics = new Metrics({
201
- ...this._options.metrics
202
- })
203
-
204
- this.metrics = metrics
205
- }
206
-
207
209
  // Create keychain
208
210
  if (this._options.keychain && this._options.keychain.datastore) {
209
211
  log('creating keychain')
@@ -8,6 +8,7 @@ const retimer = require('retimer')
8
8
 
9
9
  /**
10
10
  * @typedef {import('@vascosantos/moving-average').IMovingAverage} IMovingAverage
11
+ * @typedef {import('bignumber.js').BigNumber} Big
11
12
  */
12
13
 
13
14
  class Stats extends EventEmitter {
@@ -0,0 +1,62 @@
1
+ 'use strict'
2
+
3
+ /**
4
+ * @template K
5
+ * @template V
6
+ */
7
+ class TrackedMap extends Map {
8
+ /**
9
+ * @param {string} component
10
+ * @param {string} name
11
+ * @param {import('.')} metrics
12
+ */
13
+ constructor (component, name, metrics) {
14
+ super()
15
+
16
+ this._component = component
17
+ this._name = name
18
+ this._metrics = metrics
19
+
20
+ this._metrics.updateComponentMetric(this._component, this._name, this.size)
21
+ }
22
+
23
+ /**
24
+ * @param {K} key
25
+ * @param {V} value
26
+ */
27
+ set (key, value) {
28
+ super.set(key, value)
29
+ this._metrics.updateComponentMetric(this._component, this._name, this.size)
30
+ return this
31
+ }
32
+
33
+ /**
34
+ * @param {K} key
35
+ */
36
+ delete (key) {
37
+ const deleted = super.delete(key)
38
+ this._metrics.updateComponentMetric(this._component, this._name, this.size)
39
+ return deleted
40
+ }
41
+ }
42
+
43
+ /**
44
+ * @template K
45
+ * @template V
46
+ * @param {string} component
47
+ * @param {string} name
48
+ * @param {import('.')} [metrics]
49
+ * @returns {Map<K, V>}
50
+ */
51
+ module.exports = (component, name, metrics) => {
52
+ /** @type {Map<K, V>} */
53
+ let map
54
+
55
+ if (metrics) {
56
+ map = new TrackedMap(component, name, metrics)
57
+ } else {
58
+ map = new Map()
59
+ }
60
+
61
+ return map
62
+ }