@libp2p/autonat
TypeScript icon, indicating that this package has built-in type declarations

1.0.22 • Public • Published

@libp2p/autonat

libp2p.io Discuss codecov CI

Implementation of Autonat Protocol

About

The AutoNAT service uses the AutoNAT protocol. The service confirms addresses are dialable by remote peers, and updates the list it advertises.

The service dials randomly selected peers with a request to verify it's external addresses. The request includes a list of public multiaddrs (addressManager.getObservedAddrs()). The remote peers dial that list and respond with the results.

The AutoNAT service uses those responses to either:

  • addressManager.confirmObservedAddr(addr)
  • addressManager.removeObservedAddr(addr)

The result list of candidates and confirmed addresses can be found at addressManager.getObservedAddrs()

Example

import { createLibp2p } from 'libp2p'
import { autoNAT } from '@libp2p/autonat'

const node = await createLibp2p({
  // ...other options
  services: {
    autoNAT: autoNAT()
  }
})

Install

$ npm i @libp2p/autonat

Browser <script> tag

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

<script src="https://unpkg.com/@libp2p/autonat/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.

Readme

Keywords

none

Package Sidebar

Install

npm i @libp2p/autonat

Weekly Downloads

4,060

Version

1.0.22

License

Apache-2.0 OR MIT

Unpacked Size

172 kB

Total Files

26

Last publish

Collaborators

  • jacobheun
  • npm-service-account-libp2p
  • alanshaw
  • vascosantos
  • achingbrain
  • daviddias