2.0.10 • Published 9 months ago

@libp2p/dcutr v2.0.10

Weekly downloads
-
License
Apache-2.0 OR MIT
Repository
github
Last release
9 months ago

@libp2p/dcutr

libp2p.io Discuss codecov CI

Implementation of the DCUtR Protocol

About

Direct Connection Upgrade through Relay (DCUtR) is a protocol that allows two nodes to connect to each other who would otherwise be prevented doing so due to being behind NATed connections or firewalls.

The protocol involves making a relayed connection between the two peers and using the relay to synchronise connection timings so that they dial each other at precisely the same moment.

Example

import { createLibp2p } from 'libp2p'
import { circuitRelayTransport } from '@libp2p/circuit-relay-v2'
import { tcp } from '@libp2p/tcp'
import { identify } from '@libp2p/identify'
import { dcutr } from '@libp2p/dcutr'
import { multiaddr } from '@multiformats/multiaddr'

const node = await createLibp2p({
  transports: [
    circuitRelayTransport(),
    tcp()
  ],
  services: {
    identify: identify(),
    dcutr: dcutr()
  }
})

// QmTarget is a peer that is behind a NAT, supports TCP and has a relay
// reservation
const ma = multiaddr('/ip4/.../p2p/QmRelay/p2p-circuit/p2p/QmTarget')
await node.dial(ma)

// after a while the connection should automatically get upgraded to a
// direct connection (e.g. non-limited)
while (true) {
  const connections = node.getConnections()

  if (connections.find(conn => conn.limits == null)) {
    console.info('have direct connection')
    break
  } else {
    console.info('have relayed connection')

    // wait a few seconds to see if it's succeeded yet
    await new Promise<void>((resolve) => {
      setTimeout(() => resolve(), 5000)
    })
  }
}

Install

$ npm i @libp2p/dcutr

Browser <script> tag

Loading this module through a script tag will make it's exports available as Libp2pDcutr in the global namespace.

<script src="https://unpkg.com/@libp2p/dcutr/dist/index.min.js"></script>

API Docs

License

Licensed under either of

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

@libp2p/interface@libp2p/interface-internal@libp2p/utils@multiformats/multiaddr@multiformats/multiaddr-matcherdelayit-protobuf-streamprotons-runtimeuint8arraylist
@everything-registry/sub-chunk-546@blockless/browser-node@rosen-bridge/rosenet-nodeipfs-nodeipdw@carmel/core@constl/ipawebpeerjs@libp2p/amino-dht-bootstrapperhelia@turbo-ing/edge-v0@ts-drp/network@topology-foundation/network@sfroment/network@soketi/p2p
2.0.10-c2ff2e454

9 months ago

2.0.10-0a3406a05

9 months ago

2.0.10-a5cd8cfbe

9 months ago

2.0.10

9 months ago

2.0.9-a657bbd2e

9 months ago

2.0.9-d34642db1

9 months ago

2.0.9-7383821e1

9 months ago

2.0.10-ad5cfd66a

9 months ago

2.0.9-717731e49

9 months ago

2.0.8-3bc9769b8

9 months ago

2.0.8-3244ed086

9 months ago

2.0.9

9 months ago

2.0.8-aa8de9fd3

9 months ago

2.0.8-4521cf1f7

9 months ago

2.0.8-75301ac7d

9 months ago

2.0.8-e6b4158c6

9 months ago

2.0.5-a390db4a4

10 months ago

2.0.6-58784abf7

10 months ago

2.0.6-27b2fa6b6

10 months ago

2.0.6-b4f02a637

10 months ago

2.0.6-d9c7e0f7e

10 months ago

2.0.6-35b48025c

10 months ago

2.0.7-0d326d102

10 months ago

2.0.6-32c176fd5

10 months ago

2.0.7-e99e8f448

10 months ago

2.0.8-5d199f9b6

10 months ago

2.0.7-d7a818e8e

10 months ago

2.0.7

10 months ago

2.0.6

10 months ago

2.0.8

10 months ago

2.0.6-24fa1d5af

10 months ago

2.0.7-934a891f9

10 months ago

2.0.5-82bd42bcf

10 months ago

2.0.6-661d6586a

10 months ago

2.0.5-dad979f9b

10 months ago

2.0.6-80e798cdc

10 months ago

2.0.7-d4da56961

10 months ago

2.0.4-c5988cce8

10 months ago

2.0.4-fa83ee1c7

10 months ago

2.0.5

10 months ago

2.0.4-980038477

10 months ago

2.0.4-0c5957836

10 months ago

2.0.3-c258b35af

10 months ago

2.0.2-7f7ec82ae

10 months ago

2.0.2-b3272cfce

10 months ago

2.0.3

10 months ago

2.0.4

10 months ago

2.0.1-21fe841f2

10 months ago

2.0.2

10 months ago

2.0.1-c628c44c5

10 months ago

2.0.1-6ccbb06f0

11 months ago

2.0.1-4fd7eb2e1

10 months ago

2.0.1-34455b5f2

11 months ago

2.0.1

11 months ago

2.0.0-18dd3cb26

11 months ago

2.0.0-1210884ed

11 months ago

1.1.5-a142bb642

11 months ago

1.1.5-2bbaf4361

11 months ago

1.1.5-5214dec4a

11 months ago

1.1.5-e1ca9cced

11 months ago

2.0.0-d101aac4b

11 months ago

2.0.0

11 months ago

1.1.5-c010d575c

11 months ago

1.1.5-81ebe4e47

11 months ago

1.1.5-71e5f7a5b

11 months ago

2.0.0-7cd984569

11 months ago

1.1.5-b6681bd25

11 months ago

1.1.5-dd7b329c4

11 months ago

1.1.5-df330695a

11 months ago

1.1.5-737b3ea5b

11 months ago

1.1.5-2265e59ba

11 months ago

1.1.5-1675adee2

11 months ago

1.1.5-e211b46cc

11 months ago

1.1.5-50b897139

11 months ago

1.1.5-7655e5200

11 months ago

1.0.21-12106b5b0

1 year ago

1.1.0-b0b6cae12

1 year ago

1.0.22-8e4fdcde9

1 year ago

1.1.1-e9b6a242a

1 year ago

1.1.4-1dfb74e79

12 months ago

1.1.2-a130993ed

1 year ago

1.0.21-90d10b565

1 year ago

1.0.21-7aec7bd45

1 year ago

1.1.1-e1f0b307c

1 year ago

1.1.0-3b9cbf7d8

1 year ago

1.0.21-769461d3b

1 year ago

1.0.21-757fb2674

1 year ago

1.0.21-169c9d85e

1 year ago

1.1.5-359265a3a

12 months ago

1.0.21-6011d3697

1 year ago

1.1.2-34cf1f7cd

1 year ago

1.1.3-f30e2ee8d

12 months ago

1.1.0-abb9f90c7

1 year ago

1.1.2-928801a80

1 year ago

1.1.1-151bc46fb

1 year ago

1.1.0-af85a7cad

1 year ago

1.1.5-3c8dd5bbf

12 months ago

1.1.4-c5dba70a9

12 months ago

1.0.22-d1f1c2be7

1 year ago

1.1.2-73f2b6b6d

1 year ago

1.1.2-a8ec2bcb7

1 year ago

1.0.21-4bd8e4f79

1 year ago

1.0.21-167bf2b3c

1 year ago

1.0.22-94cac115a

1 year ago

1.1.3-944935f8d

1 year ago

1.0.22-9e0236627

1 year ago

1.1.1-ce6da9896

1 year ago

1.1.1

1 year ago

1.1.0

1 year ago

1.1.5

12 months ago

1.1.4

12 months ago

1.1.3

1 year ago

1.1.2

1 year ago

1.0.21-e69a2f1b6

1 year ago

1.1.4-0edbfe7af

12 months ago

1.0.21-352699ab5

1 year ago

1.1.0-0b55625d1

1 year ago

1.0.21-f4e572cd6

1 year ago

1.0.21-62e32252a

1 year ago

1.1.0-15eb66428

1 year ago

1.1.2-8b3114292

1 year ago

1.1.2-40902d99b

1 year ago

1.0.22

1 year ago

1.0.21-bc6556f96

1 year ago

1.1.2-a82ff8221

1 year ago

1.0.22-863b3de03

1 year ago

1.0.21-440c9b360

1 year ago

1.1.4-7939dbd5c

12 months ago

1.1.0-21cf7bc56

1 year ago

1.1.1-3319ff41e

1 year ago

1.0.22-44791342

1 year ago

1.1.2-4a994c5ef

1 year ago

1.1.0-6573cb8b0

1 year ago

1.0.21-f6fe2cc3c

1 year ago

1.0.21-7464dc00c

1 year ago

1.1.1-d1aec4d9f

1 year ago

1.0.21

1 year ago

1.0.20-1eb5b2713

1 year ago

1.0.20-a3e8beabd

1 year ago

1.0.20-7de56f244

1 year ago

1.0.20-1a41c28bb

1 year ago

1.0.20-1cd5aae11

1 year ago

1.0.20-1cc6a9405

1 year ago

1.0.20-5b7380259

1 year ago

1.0.20-48444f750

1 year ago

1.0.20-8214dcfb0

1 year ago

1.0.20

1 year ago

1.0.20-3c73707ff

1 year ago

1.0.19-9d4b0596f

1 year ago

1.0.19-43046b9ae

1 year ago

1.0.19-83c14d08f

1 year ago

1.0.19-7ae6063df

1 year ago

1.0.19-d9366f9aa

1 year ago

1.0.19-4ad63bb79

1 year ago

1.0.19-bfa7660d5

1 year ago

1.0.19-1488a7371

1 year ago

1.0.19-510d9ce65

1 year ago

1.0.19-767b23e71

1 year ago

1.0.19-a11e135c2

1 year ago

1.0.18-de3f7aeaf

1 year ago

1.0.19-9d13a2f6a

1 year ago

1.0.19

1 year ago

1.0.18-c82432312

1 year ago

1.0.18-3bc94b403

1 year ago

1.0.18-3d7a9da17

1 year ago

1.0.18-998fcaf94

1 year ago

1.0.18-e1923b0a7

1 year ago

1.0.18-90cfd25e2

1 year ago

1.0.17-c2181f0cf

1 year ago

1.0.18

1 year ago

1.0.17-2281f802b

1 year ago

1.0.17-fd1f8343d

1 year ago

1.0.17-eaf8ac7cf

1 year ago

1.0.17-acef72613

1 year ago

1.0.17

1 year ago

1.0.17-ea4f26285

1 year ago

1.0.16-08dabd390

1 year ago

1.0.16-31c78f4ed

1 year ago

1.0.15-2c56203f9

1 year ago

1.0.16

1 year ago

1.0.15-b17824a1d

1 year ago

1.0.15-936dbba10

1 year ago

1.0.15-732c436d4

1 year ago

1.0.15-2b2958fe6

1 year ago

1.0.14-3e515f007

1 year ago

1.0.15

1 year ago

1.0.14-d446c6c31

1 year ago

1.0.14-a2b41f793

1 year ago

1.0.14-4fc0a7d30

1 year ago

1.0.14-ab5f05763

1 year ago

1.0.14-afe15f669

1 year ago

1.0.14-3ffecc5bf

1 year ago

1.0.14-1f589c822

1 year ago

1.0.14-80278b36b

1 year ago

1.0.13-82901e785

1 year ago

1.0.13-330a5ed72

1 year ago

1.0.13-1fc929c1c

1 year ago

1.0.13-59a97b61b

1 year ago

1.0.13-bf720c045

1 year ago

1.0.14

1 year ago

1.0.13-cad9cf007

1 year ago

1.0.13-e1798aa26

1 year ago

1.0.13-fad3074b8

1 year ago

1.0.13-f39ce5f13

1 year ago

1.0.13-83ef3717e

1 year ago

1.0.13-ab466004b

1 year ago

1.0.13-a9cc0ee49

1 year ago

1.0.13-2122a713d

1 year ago

1.0.13-28e51652a

1 year ago

1.0.13-f71bc49bd

1 year ago

1.0.13

1 year ago

1.0.12-f0d2b52d0

1 year ago

1.0.12-bedfd0aa2

1 year ago

1.0.12-8072a2e59

1 year ago

1.0.12-b1b77adb4

1 year ago

1.0.12-e1c01370b

1 year ago

1.0.12-fb7c51c3c

1 year ago

1.0.10-03ff9fd82

1 year ago

1.0.10-dab5cf724

1 year ago

1.0.10-0321812e7

1 year ago

1.0.10-9891ecd73

1 year ago

1.0.11-0c7bbbb07

1 year ago

1.0.10-2370d1c39

1 year ago

1.0.10-1cb2408ac

1 year ago

1.0.11

1 year ago

1.0.12

1 year ago

1.0.10-e1db332a4

1 year ago

1.0.10-6f323de7d

2 years ago

1.0.10-c9ed1c7d6

2 years ago

1.0.9-f4dda4a3c

2 years ago

1.0.9-dbc92ab74

2 years ago

1.0.9-2e464c099

2 years ago

1.0.9-72f0e09f7

2 years ago

1.0.9-74fb5671d

2 years ago

1.0.10

2 years ago

1.0.9-3e47d88fd

2 years ago

1.0.9-f27138ca1

2 years ago

1.0.9-8c6654c3a

2 years ago

1.0.9-9376e61a1

2 years ago

1.0.9-08f6f607d

2 years ago

1.0.9-74477f6ea

2 years ago

1.0.9

2 years ago

1.0.8-092861e23

2 years ago

1.0.8

2 years ago

1.0.7-856ccd708

2 years ago

1.0.7-ddaa59a60

2 years ago

1.0.8-8bbd43628

2 years ago

1.0.7-4691f4173

2 years ago

1.0.7-ee7ffe9b9

2 years ago

1.0.7-821a38e24

2 years ago

1.0.7-900236724

2 years ago

1.0.7

2 years ago

1.0.6-528d73781

2 years ago

1.0.6-444d83751

2 years ago

1.0.6-d011f6130

2 years ago

1.0.6-581574d6d

2 years ago

1.0.6-ba7089984

2 years ago

1.0.6-388d02b33

2 years ago

1.0.6

2 years ago

1.0.5-5d1f68e92

2 years ago

1.0.5-28587d24f

2 years ago

1.0.5-4e0135c7d

2 years ago

1.0.5-6fd681d09

2 years ago

1.0.5-178fe2671

2 years ago

1.0.5-cd8cafcd5

2 years ago

1.0.5-c00378909

2 years ago

1.0.5-83dfc7dc8

2 years ago

1.0.5-f71f2e14e

2 years ago

1.0.5-984f13e42

2 years ago

1.0.5-07f3afe2d

2 years ago

1.0.5-ad6f70bf3

2 years ago

1.0.5-9eff7eff0

2 years ago

1.0.5-a7c6a93c6

2 years ago

1.0.5-230afea4b

2 years ago

1.0.5-f81be145a

2 years ago

1.0.5-01e9a5fe4

2 years ago

1.0.5

2 years ago

1.0.5-742915567

2 years ago

1.0.4-341581166

2 years ago

1.0.4-6d11e8268

2 years ago

1.0.3-d10506189

2 years ago

1.0.4

2 years ago

1.0.3-64a915ae9

2 years ago

1.0.3-3bf6387ff

2 years ago

1.0.3-93890c8f9

2 years ago

1.0.3-16588d27c

2 years ago

1.0.3-887c6ffe1

2 years ago

1.0.3-bcfa15993

2 years ago

1.0.3-10ea19700

2 years ago

1.0.3-09dd02987

2 years ago

1.0.3-5a9362e21

2 years ago

1.0.3

2 years ago

1.0.2-738dd40f1

2 years ago

1.0.2

2 years ago

1.0.1-7861ed882

2 years ago

1.0.1-9197f10ba

2 years ago

1.0.1-e7167fe52

2 years ago

1.0.1-f537b3731

2 years ago

1.0.1-8c169db1b

2 years ago

1.0.1-561797a89

2 years ago

1.0.1-cf963694f

2 years ago

1.0.1-bca8d6e68

2 years ago

1.0.1

2 years ago

1.0.1-53224004f

2 years ago

1.0.0-273d8177c

2 years ago

1.0.1-6c1f0ee81

2 years ago

1.0.0-a32e70bac

2 years ago

1.0.0-06e6d235f

2 years ago

1.0.0-bcf18265e

2 years ago

1.0.0-8e4fbe13a

2 years ago

1.0.0-7682861f9

2 years ago

1.0.0-551622a96

2 years ago

1.0.0

2 years ago

0.0.0-8f921ee97

2 years ago

0.0.0-74e84bc29

2 years ago

0.0.0-8bb6d5333

2 years ago

0.0.0-7877a50e0

2 years ago

0.0.0-68db79f6b

2 years ago

0.0.0-e2267d437

2 years ago

0.0.0-4a474d54d

2 years ago

0.0.0-0b4a2ee79

2 years ago

0.0.0-6b6ba9ab7

2 years ago

0.0.0-d729d66a5

2 years ago

0.0.0-bb6ceb192

2 years ago

0.0.0-d8f5bc211

2 years ago

0.0.0-13a870cbe

2 years ago

0.0.0-3dee5df4d

2 years ago

0.0.0-adea7bbbf

2 years ago

0.0.0-6625a27fc

2 years ago

0.0.0-9c67c5b3d

2 years ago

0.0.0-05b52d69c

2 years ago

0.0.0-97ab31c0c

2 years ago

0.0.0

2 years ago