GatewayMode enum

The central node orchestrating all IPFS operations.

IPFSNode is the main class for interacting with the IPFS network. It manages storage, networking, and protocol handlers, providing a high-level API for content operations.

Creating a Node:

// Offline mode (local storage only)
final node = await IPFSNode.create(IPFSConfig(offline: true));
await node.start();

// P2P mode (full network participation)
final node = await IPFSNode.create(IPFSConfig(offline: false));
await node.start();
// print('Peer ID: ${node.peerID}');

Adding Content:

final cid = await node.addFile(fileBytes);
// print('Added content: $cid');

Retrieving Content:

final data = await node.get(cid);

Lifecycle: Always call start before using the node and stop when done:

await node.start();
try {
  // Use the node...
} finally {
  await node.stop();
}

See also:

• IPFS for a simpler high-level wrapper
• IPFSConfig for configuration options
• IPFSNodeBuilder for advanced node construction
• IPFSNodeBuilder for advanced node construction Modes for retrieving content via the IPFSNode.

Strategies:

• internal: Use the native Dart P2P node (libp2p).
• public: Use public HTTP gateways (e.g. ipfs.io).
• local: Use a local IPFS daemon (e.g. go-ipfs at localhost:8080).
• custom: Use a user-defined HTTP gateway URL.