eth_unsubscribe

El método eth_unsubscribe cancela una suscripción WebSocket existente para dejar de recibir notificaciones de eventos. Este método ayuda a gestionar recursos y tráfico de red eliminando suscripciones que ya no son necesarias.

Casos de Uso

• Detener notificaciones de eventos cuando un usuario navega fuera de una página
• Gestionar recursos tanto en el cliente como en el servidor para prevenir fugas de memoria
• Limpiar suscripciones inactivas después de que el procesamiento de datos se complete
• Manejar cambios de estado de la aplicación que requieren diferentes parámetros de suscripción
• Mantenerse dentro de los límites del proveedor en suscripciones concurrentes
• Implementar rotación de suscripciones para monitoreo de eventos de alto volumen
• Asegurar un apagado correcto de componentes de monitoreo de eventos en dApps
• Cambiar entre diferentes tipos de eventos blockchain
• Liberar recursos del servidor para otros usuarios en entornos multi-inquilino
• Gestionar sesiones para seguimiento de eventos específicos del usuario

Detalles del Método

Este método cancela una suscripción usando su ID de suscripción.

Ejemplo de Solicitud

{
	"jsonrpc": "2.0",
	"id": 1,
	"method": "eth_unsubscribe",
	"params": ["0x9cef478923ff08bf67fde6c64013158d"]
}

Ejemplo de Respuesta

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

Valores de Respuesta

• true: La suscripción fue cancelada exitosamente
• false: No existía ninguna suscripción con el ID dado

Escenarios de Error

Ejemplo de Respuesta de Error

{
	"jsonrpc": "2.0",
	"id": 1,
	"error": {
		"code": -32602,
		"message": "invalid subscription id"
	}
}

Notas Importantes

• Este método debe llamarse sobre la misma conexión WebSocket que creó la suscripción
• Cerrar la conexión WebSocket automáticamente cancela todas las suscripciones asociadas
• El ID de suscripción proviene del resultado de una llamada previa a eth_subscribe
• Debes cancelar las suscripciones que ya no necesites para liberar recursos del servidor
• El mismo ID de suscripción no puede reutilizarse después de cancelar la suscripción
• Algunos proveedores pueden limitar el número de suscripciones concurrentes por conexión
• Los IDs de suscripción son únicos por conexión y no globalmente únicos
• Si te reconectas a un servidor diferente en un entorno de carga balanceada, los antiguos IDs de suscripción no serán válidos
• Algunos proveedores RPC pueden automáticamente cancelar suscripciones inactivas después de cierto período
• Múltiples intentos de cancelación para el mismo ID son seguros pero devolverán false después del primer intento exitoso

Ver también

• eth_subscribe - Crear suscripciones a eventos WebSocket
• Guía de Conexión WebSocket - Trabajar con conexiones persistentes
• eth_getLogs - Alternativa para consultas de eventos históricos
• eth_newFilter - Alternativa basada en HTTP para filtrado de eventos
• eth_getFilterChanges - Alternativa basada en sondeo a WebSockets
• eth_uninstallFilter - Equivalente HTTP para limpiar filtros