system_localListenAddresses - Bittensor RPC Method
Get the multiaddr listen addresses that a Bittensor node is bound to.
Returns the list of multiaddr listen addresses that the Bittensor node is currently bound to. These are the addresses on which the node accepts incoming peer-to-peer connections. The response includes the protocol, IP address, port, and the node's peer ID.
Parameters
None.
Response
| Field | Type | Description |
|---|---|---|
result | array | Array of multiaddr strings (e.g. ["/ip4/0.0.0.0/tcp/30333/p2p/12D3KooW..."]). |
Code Examples
Use Cases
- Node configuration verification -- Confirm which interfaces and ports the node is listening on after startup.
- Peer sharing -- Retrieve the node's full multiaddr (including peer ID) to share with other nodes for peering.
- Network diagnostics -- Verify that the node is bound to the expected addresses for firewall and networking troubleshooting.
Notes
- On public shared RPC endpoints, the returned addresses may be masked or reflect the infrastructure's internal addresses.
- The multiaddr format includes protocol, address, port, and peer ID components.
- This method is safe (read-only) and available on most node configurations.
Related Methods
system_peers-- List currently connected peerssystem_nodeRoles-- Get the node's configured rolessystem_addReservedPeer-- Add a reserved peer using a multiaddrsystem_unstable_networkState-- Detailed network diagnostics