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
# List peers
sage_rpc get_peers '{}'
# Add peer
sage_rpc add_peer '{"ip": "node.chia.net:8444"}'
# Remove and ban peer
sage_rpc remove_peer '{"ip": "192.168.1.50:8444", "ban": true}'
# Get current network
sage_rpc get_network '{}'
# Switch to testnet
sage_rpc set_network '{"name": "testnet11"}'
# Enable delta sync
sage_rpc set_delta_sync '{"delta_sync": true}'
# Set custom change address
sage_rpc set_change_address '{
"fingerprint": 1234567890,
"change_address": "xch1mychange..."
}'
Network Override
Per-wallet network override for multi-network setups:
# Use testnet for specific wallet
sage_rpc set_network_override '{
"fingerprint": 1234567890,
"name": "testnet11"
}'
# Reset to default
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
modbender