getMaxRetransmitSlot

Explore getMaxRetransmitSlot: Use Cases, Examples, Parameters, Response Format, and Pro Tips.

The getMaxRetransmitSlot RPC method returns the highest slot number observed by a Solana node during the retransmit stage—a critical phase in Solana’s Turbine protocol, which handles block data propagation and repair. This slot reflects how far the node has progressed in receiving shreds (block fragments) from peers and can offer insights into the node's synchronization with the cluster.

---

✅ Common Use Cases

• Node Synchronization Monitoring: Use this value to determine how up-to-date a node is with block data being propagated across the cluster.

• Advanced Network Analysis: Combine this metric with others to evaluate block propagation health, especially in research or monitoring dashboards.

• Diagnosing Node Connectivity: A persistently low retransmit slot can suggest connectivity issues or peer communication failures for a given node.

---

🛠️ Request Parameters

This method takes no parameters.

---

📦 Response Structure

The response’s result field returns:

• u64: The highest slot number seen by the node in the retransmit stage.

---

💡 Example

Get the Maximum Retransmit Slot

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getMaxRetransmitSlot"
}

Code Examples

Nodejs

const fetch = require('node-fetch');

async function getMaxRetransmitSlot(rpcUrl) {
  try {
    const response = await fetch(rpcUrl, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        jsonrpc: '2.0',
        id: 1,
        method: 'getMaxRetransmitSlot'
      }),
    });

    const data = await response.json();
    
    // Print the exact full response
    console.log('Full RPC Response:');
    console.log(JSON.stringify(data, null, 2));
    
    return data;
  } catch (error) {
    console.error('Error getting health:', error.message);
    return null;
  }
}

// Example usage
const RPC_URL = 'https://rpc.coinvera.io/?x-api-key=your-coinvera-x-api-key';

getMaxRetransmitSlot(RPC_URL);

Python

import requests
import json

def get_max_retransmit_slot(rpc_url):
    try:
        response = requests.post(
            rpc_url,
            headers={
                'Content-Type': 'application/json',
            },
            json={
                'jsonrpc': '2.0',
                'id': 1,
                'method': 'getMaxRetransmitSlot'
            }
        )
        
        data = response.json()
        
        # Print the exact full response
        print('Full RPC Response:')
        print(json.dumps(data, indent=2))
        
        return data
        
    except Exception as error:
        print(f'Error getting health: {error}')
        return None

# Example usage
RPC_URL = 'https://rpc.coinvera.io/?x-api-key=your-coinvera-x-api-key'
get_max_retransmit_slot(RPC_URL)

Example Response

{
  "jsonrpc": "2.0",
  "result": 355367621,
  "id": 1
}

---

🧠 Developer Tips

• Node-Dependent View: This slot reflects what your queried node sees. Different nodes may report different values due to propagation delays or local issues.

• Not the Network’s Highest Slot: For the most confirmed or finalized slot cluster-wide, use getSlot with appropriate commitment or getBlockHeight. getMaxRetransmitSlot only represents what this node has received via retransmit.

• Continuously Updating: This value should generally increase in real time. If it stagnates, investigate potential node connectivity or performance problems.

---

This guide equips you with the knowledge to leverage getMaxRetransmitSlot for assessing Solana node data propagation health and synchronization performance.