system_removeReservedPeer - Bittensor RPC Method
Remove a reserved peer from a Bittensor node. Administrative method.
Removes a peer from the reserved peer list on the running Bittensor node. After removal, the node will no longer actively maintain a connection to that peer, and the peer becomes subject to normal eviction rules. This is an administrative method that requires --rpc-methods unsafe.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
peerId | string | Yes | The peer ID to remove from the reserved list (e.g. "12D3KooW..."). |
Response
| Field | Type | Description |
|---|---|---|
result | null | Confirms the peer has been removed from the reserved list. |
Code Examples
Use Cases
- Peer rotation -- Remove decommissioned or misbehaving peers from the reserved list.
- Network reconfiguration -- Update the reserved peer set when changing your node infrastructure.
- Troubleshooting -- Remove a peer that is causing connectivity issues.
Notes
- This is an unsafe/administrative method. Disabled on public RPC endpoints including Dwellir's shared Bittensor nodes.
- Removing a reserved peer does not immediately disconnect it; it just removes the reservation, making the connection subject to normal peer management.
- The peer ID is the libp2p peer identifier, not a multiaddr.
Related Methods
system_addReservedPeer-- Add a reserved peersystem_reservedPeers-- List current reserved peerssystem_peers-- List all connected peers