Struct rust_ipfs::UninitializedIpfs

pub struct UninitializedIpfs<C: NetworkBehaviour<ToSwarm = Void> + Send> { /* private fields */ }

Configured Ipfs which can only be started.

Implementations

impl<C: NetworkBehaviour<ToSwarm = Void> + Send> UninitializedIpfs<C>

pub fn new() -> Self

New uninitualized instance

pub fn empty() -> Self

New uninitualized instance without any listener addresses

pub fn with_opt(options: IpfsOptions) -> Self

Configures a new UninitializedIpfs with from the given options and optionally a span. If the span is not given, it is defaulted to tracing::trace_span!("ipfs").

The span is attached to all operations called on the later created Ipfs along with all operations done in the background task as well as tasks spawned by the underlying libp2p::Swarm.

pub fn add_listening_addr(self, addr: Multiaddr) -> Self

Adds a listening address

pub fn add_listening_addrs(self, addrs: Vec<Multiaddr>) -> Self

Adds a listening addresses

pub fn set_listening_addrs(self, addrs: Vec<Multiaddr>) -> Self

Set a list of listening addresses

pub fn add_bootstrap(self, addr: Multiaddr) -> Self

Adds a bootstrap node

pub fn set_path<P: AsRef<Path>>(self, path: P) -> Self

Sets a path

pub fn set_identify_configuration(self, config: IdentifyConfiguration) -> Self

Set identify configuration

pub fn set_transport_configuration(self, config: TransportConfig) -> Self

Set transport configuration

pub fn set_idle_connection_timeout(self, duration: u64) -> Self

Set timeout for idle connections

pub fn set_swarm_configuration(self, config: SwarmConfig) -> Self

Set swarm configuration

pub fn set_kad_configuration( self, config: KadConfig, store: KadStoreConfig ) -> Self

Set kad configuration

pub fn set_ping_configuration(self, config: PingConfig) -> Self

Set ping configuration

pub fn default_record_key_validator(self) -> Self

Set default record validator for IPFS Note: This will override any keys set for ipns prefix

pub fn set_record_prefix_validator( self, key: &str, callback: Arc<dyn Fn(&str) -> Result<Key> + Sync + Send> ) -> Self

pub fn set_addrbook_configuration(self, config: AddressBookConfig) -> Self

Set address book configuration

pub fn set_pubsub_configuration(self, config: PubsubConfig) -> Self

Set pubsub configuration

pub fn set_provider(self, opt: RepoProvider) -> Self

Set RepoProvider option to provide blocks automatically

pub fn set_keypair(self, keypair: Keypair) -> Self

Set keypair

pub fn set_repo(self, repo: Repo) -> Self

Set block and data repo

pub fn enable_keepalive(self) -> Self

👎Deprecated: use UninitializedIpfs::set_idle_connection(u64::MAX / 2)

Enable keep alive

pub fn disable_kad(self) -> Self

Disables kademlia

pub fn disable_bitswap(self) -> Self

Disable bitswap

pub fn set_bitswap_configuration(self, config: BitswapConfig) -> Self

Set Bitswap configuration

pub fn set_keystore(self, keystore: Keystore) -> Self

Set a keystore

pub fn enable_mdns(self) -> Self

Enable mdns

pub fn enable_relay(self, with_dcutr: bool) -> Self

Enable relay client

pub fn enable_relay_server(self, config: Option<RelayConfig>) -> Self

Enable relay server

pub fn enable_upnp(self) -> Self

Enable port mapping (AKA UPnP)

pub fn listen_as_external_addr(self) -> Self

Automatically add any listened address as an external address

pub fn enable_rendezvous_server(self) -> Self

pub fn enable_rendezvous_client(self) -> Self

pub fn set_custom_behaviour(self, behaviour: C) -> Self

Set a custom behaviour

pub fn set_custom_transport( self, transport: Box<dyn Fn(&Keypair, Option<Transport>) -> Result<Boxed<(PeerId, StreamMuxerBox)>> + Sync + Send + 'static> ) -> Self

Set a transport

pub fn fd_limit(self, limit: FDLimit) -> Self

Set file desc limit

pub fn disable_delay(self) -> Self

Used to delay the loop Note: This may be removed in future

pub fn swarm_events<F>(self, func: F) -> Selfwhere F: Fn(&mut TSwarm<C>, &<TSwarm<C> as Stream>::Item) + Sync + Send + 'static,

Handle libp2p swarm events

pub async fn start(self) -> Result<Ipfs, Error>

Initialize the ipfs node. The returned Ipfs value is cloneable, send and sync.

Trait Implementations

impl<C: NetworkBehaviour<ToSwarm = Void> + Send> Default for UninitializedIpfs<C>

fn default() -> Self

Returns the “default value” for a type.