1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73
// Copyright 2020 Netwarps Ltd. // // Permission is hereby granted, free of charge, to any person obtaining a // copy of this software and associated documentation files (the "Software"), // to deal in the Software without restriction, including without limitation // the rights to use, copy, modify, merge, publish, distribute, sublicense, // and/or sell copies of the Software, and to permit persons to whom the // Software is furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER // DEALINGS IN THE SOFTWARE. //! Transports, upgrades, multiplexing and node handling of *libp2p*. //! //! The main concepts of libp2p-core are: //! //! - A [`PeerId`] is a unique global identifier for a node on the network. //! Each node must have a different `PeerId`. Normally, a `PeerId` is the //! hash of the public key used to negotiate encryption on the //! communication channel, thereby guaranteeing that they cannot be spoofed. //! - The [`Transport`] trait defines how to reach a remote node or listen for //! incoming remote connections. See the `transport` module. //! - The [`StreamMuxer`] trait is implemented on structs that hold a connection //! to a remote and can subdivide this connection into multiple substreams. //! See the `muxing` module. //! - The [`UpgradeInfo`] and [`Upgrader`] traits define how to upgrade each //! individual substream to use a protocol. //! See the `upgrade` module. pub mod keys_proto { include!(concat!(env!("OUT_DIR"), "/keys_proto.rs")); } // re-export multiaddr pub use libp2prs_multiaddr as multiaddr; // re-export multihash pub use multihash; pub mod identity; mod peer_id; pub mod multistream; pub use identity::PublicKey; pub use peer_id::PeerId; pub mod transport; pub use libp2prs_multiaddr::Multiaddr; pub use transport::Transport; pub mod muxing; pub mod secure_io; pub mod upgrade; pub use upgrade::ProtocolId; pub mod routing; pub mod either; pub mod peerstore; // pub mod pnet; pub mod translation; pub mod util; pub use util::{ReadEx, WriteEx};