| name | sage-network |
| description | Sage network and peer settings. Manage peers, switch networks, configure sync settings, set change address. |
Sage Network & Peers
Network configuration and peer management.
Endpoints
Peer Management
| Endpoint | Payload | Description |
|---|
get_peers | {} | List connected peers |
add_peer | {"ip": "node.example.com:8444"} | Add peer |
remove_peer | {"ip": "...", "ban": false} | Remove/ban peer |
set_discover_peers | {"discover_peers": true} | Toggle auto-discovery |
set_target_peers | {"target_peers": 8} | Set target count |
Network Settings
| Endpoint | Payload | Description |
|---|
get_network | {} | Get current network |
get_networks | {} | List available networks |
set_network | {"name": "mainnet"} | Switch network |
set_network_override | {"fingerprint": ..., "name": "testnet11"} | Per-wallet override |
Sync Settings
| Endpoint | Payload | Description |
|---|
set_delta_sync | {"delta_sync": true} | Toggle delta sync |
set_delta_sync_override | {"fingerprint": ..., "delta_sync": true} | Per-wallet override |
Address Settings
| Endpoint | Payload | Description |
|---|
set_change_address | {"fingerprint": ..., "change_address": "xch1..."} | Set change address |
Peer Record Structure
{
"ip": "192.168.1.100:8444",
"port": 8444,
"peak_height": 1234567,
"synced": true
}
Network Response Structure
{
"network": {
"name": "mainnet",
"prefix": "xch",
"default_port": 8444,
"genesis_challenge": "0x..."
},
"kind": "mainnet"
}
Network kinds: "mainnet", "testnet", "unknown"
Examples
sage_rpc get_peers '{}'
sage_rpc add_peer '{"ip": "node.chia.net:8444"}'
sage_rpc remove_peer '{"ip": "192.168.1.50:8444", "ban": true}'
sage_rpc get_network '{}'
sage_rpc set_network '{"name": "testnet11"}'
sage_rpc set_delta_sync '{"delta_sync": true}'
sage_rpc set_change_address '{
"fingerprint": 1234567890,
"change_address": "xch1mychange..."
}'
Network Override
Per-wallet network override for multi-network setups:
sage_rpc set_network_override '{
"fingerprint": 1234567890,
"name": "testnet11"
}'
sage_rpc set_network_override '{
"fingerprint": 1234567890,
"name": null
}'
Notes
- Delta sync is faster but may miss some edge cases
- Target peers controls how many connections to maintain
- Network override allows testing without switching global network