net_listening | Hyperliquid EVM

Returns true if the client is actively listening for network connections. This method checks if the node is accepting incoming connections from peers on the network.

POST /evm

net_listening

cURL

curl --request POST \
  --url https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/evm \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "method": "net_listening",
  "params": [],
  "id": 1
}
'

200

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

This method is available on Chainstack. Not all Hyperliquid methods are available on Chainstack, as the open-source node implementation does not support them yet — see Hyperliquid methods for the full availability breakdown.

The net_listening JSON-RPC method returns true if the client is actively listening for network connections. This method is useful for checking the network connectivity status of the Hyperliquid EVM node and verifying that it can accept incoming peer connections.

Get your own node endpoint today

Start for free and get your app to production levels immediately. No credit card required.

You can sign up with your GitHub, X, Google, or Microsoft account.

Parameters

This method takes no parameters. The params field should be an empty array.

Response

The method returns a boolean value indicating whether the client is listening for network connections.

Response structure

Network status:

• result — Boolean value indicating if the client is actively listening for network connections

Listening status interpretation

True response:

• Node is actively listening for incoming network connections
• Node is available for peer-to-peer communication
• Network interface is properly configured and accessible

False response:

• Node is not accepting incoming connections
• May indicate network configuration issues
• Node might be in a restricted or maintenance mode

Usage example

Basic implementation

// Check if node is listening for network connections
const checkNodeListening = async () => {
  const response = await fetch('https://hyperliquid-mainnet.core.chainstack.com/YOUR_ENDPOINT/evm', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      jsonrpc: '2.0',
      method: 'net_listening',
      params: [],
      id: 1
    })
  });
  
  const data = await response.json();
  return data.result;
};

// Monitor network connectivity status
const monitorNetworkStatus = async () => {
  try {
    const isListening = await checkNodeListening();
    
    if (isListening) {
      console.log('✅ Node is listening for network connections');
    } else {
      console.log('❌ Node is not accepting network connections');
    }
    
    return isListening;
  } catch (error) {
    console.error('Error checking network status:', error);
    return false;
  }
};

// Health check implementation
const performHealthCheck = async () => {
  const networkStatus = await monitorNetworkStatus();
  
  return {
    network: {
      listening: networkStatus,
      status: networkStatus ? 'healthy' : 'degraded'
    },
    timestamp: new Date().toISOString()
  };
};

// Usage
performHealthCheck().then(health => {
  console.log('Node health check:', health);
});

Example request

Shell

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"net_listening","params":[],"id":1}' \
  https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/evm

Use cases

The net_listening method is essential for applications that need to:

• Network monitoring: Monitor node connectivity and network interface status
• Health checks: Implement comprehensive node health monitoring systems
• Load balancing: Make routing decisions based on node availability
• Troubleshooting: Diagnose network connectivity issues and configuration problems
• Infrastructure management: Automate node deployment and configuration validation
• Service discovery: Verify node readiness before adding to service pools
• Monitoring dashboards: Display real-time network status in operational dashboards
• Alerting systems: Create alerts for network connectivity issues
• Failover logic: Implement automatic failover based on network status
• Development tools: Build development tools with network status awareness
• Testing frameworks: Verify network configuration in testing environments
• Performance monitoring: Track network availability as part of performance metrics
• Security monitoring: Monitor for unexpected network state changes
• Deployment validation: Verify successful node deployment and configuration
• Maintenance coordination: Coordinate maintenance activities based on network status

This method provides essential network connectivity information for maintaining robust and reliable blockchain infrastructure on the Hyperliquid EVM platform.

Body

application/json

jsonrpc · enum<string> · default: 2.0 · required

JSON-RPC version

Available options: 2.0

method · enum<string> · default: net_listening · required

The RPC method name

Available options: net_listening

id · integer · default: 1 · required

Request identifier

params · array

Parameters for the method (empty array for net_listening)

Response

200 - application/json

Successful response with the listening status

jsonrpc · string

JSON-RPC version

id · integer

Request identifier

result · boolean

True if the client is listening for network connections