Swarm Operations
resource: swarm — 5 operations for peer connectivity and addresses
peers
Lists the node's currently connected peers.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
verbose | bool | No | Kubo default (false) | Include extra per-peer detail (multiplexer, etc.). Unset lets Kubo decide. |
streams | bool | No | Kubo default (false) | Include each peer's open libp2p protocol streams. |
latency | bool | No | Kubo default (false) | Include measured round-trip latency per peer. |
direction | bool | No | Kubo default (false) | Include connection direction (inbound/outbound) per peer. |
identify | bool | No | Kubo default (false) | Run the libp2p identify protocol per peer and include its result. |
List-shaped response: array of peer entries plus count.
connect
| Field | Type | Required | Description |
|---|---|---|---|
peerAddress | text | ✓ Yes | The peer's full multiaddr, e.g. /ip4/1.2.3.4/tcp/4001/p2p/QmPeerId... — must include /p2p/<PeerID>. |
Missing → CFG_MISSING_PEER_ADDRESS.
disconnect
| Field | Type | Required | Description |
|---|---|---|---|
peerAddress | text | ✓ Yes | The peer multiaddr, or bare /p2p/<PeerID>, to disconnect from. |
Missing → CFG_MISSING_PEER_ADDRESS.
addrs
Lists known addresses per connected peer. Takes no feature-specific fields beyond the standard Kubo connection config.
addrsLocal
Lists this node's own local listening addresses.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
id | bool | No | Kubo default (true) | Append this node's own Peer ID (/p2p/<PeerID>) to each address. |
addrs vs. addrsLocal:
addrs reports what addresses your daemon has
observed for other peers; addrsLocal reports what addresses your own daemon is
listening on. Use addrsLocal when you need to hand your own node's address to
someone else for a connect call.