trace_filter

El método trace_filter te permite buscar trazas específicas dentro de un rango de bloques, filtrando por varios criterios como direcciones de origen/destino, rango de bloques y tipos de traza. Esto proporciona una manera poderosa de analizar la actividad de la blockchain para contratos o cuentas específicas.

Casos de Uso

• Encontrar todas las transacciones internas para una dirección específica
• Rastrear transferencias de tokens que no son visibles en los registros de transacciones
• Análisis forense de interacciones de contratos y vulnerabilidades
• Monitorear llamadas a contratos específicos a través de un rango de bloques
• Auditar interacciones contrato-a-contrato para revisión de seguridad
• Analizar patrones de ejecución de contratos inteligentes
• Detectar actividades MEV y adelantamiento de transacciones
• Rastrear rutas de arbitraje a través de protocolos DeFi
• Construir exploradores de bloques integrales
• Validar flujos financieros complejos en aplicaciones DeFi

Detalles del Método

Este método recupera trazas de transacciones basadas en los criterios de filtro especificados.

Parámetros de Filtro

Ejemplo de Respuesta

{
	"jsonrpc": "2.0",
	"id": 1,
	"result": [
		{
			"action": {
				"callType": "call",
				"from": "0x8bbb73bcb5d553b5a556358d27625323fd781d37",
				"to": "0x6090a6e47849629b7245dfa1ca21d94cd15878ef",
				"gas": "0x12a94",
				"input": "0x0000000000000000000000000000000000000000000000000000000000000000",
				"value": "0x0"
			},
			"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
			"blockNumber": 3928366,
			"result": {
				"gasUsed": "0xd979",
				"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
			},
			"subtraces": 1,
			"traceAddress": [],
			"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
			"transactionPosition": 2,
			"type": "call"
		}
	]
}

Estrategias de Filtrado

Se pueden usar diferentes combinaciones de filtros para responder preguntas específicas:

Para encontrar todas las llamadas a un contrato específico:

{
  "toAddress": ["0x1234567890123456789012345678901234567890"]
}

Para encontrar todas las transacciones internas desde un contrato:

{
  "fromAddress": ["0x1234567890123456789012345678901234567890"]
}

Para encontrar interacciones entre dos direcciones específicas:

{
  "fromAddress": ["0x1234567890123456789012345678901234567890"],
  "toAddress": ["0xabcdef0123456789abcdef0123456789abcdef01"]
}

Para analizar actividad dentro de un rango de bloques específico:

{
  "fromBlock": "0x429d3b",
  "toBlock": "0x429d3d"
}

Paginación

Para conjuntos de resultados grandes, usa los parámetros after y count para paginar a través de los resultados:

1. Primera solicitud: { "after": 0, "count": 100, ... }
2. Siguiente solicitud: { "after": 100, "count": 100, ... }
3. Continúa incrementando after por el valor de count

Consideraciones de Rendimiento

• Filtrar a través de rangos de bloques grandes puede consumir muchos recursos
• Siempre especifica el rango de bloques más estrecho necesario
• Usa filtrado por dirección para reducir el tamaño del conjunto de resultados
• Considera dividir consultas grandes en rangos de bloques más pequeños
• Para uso intensivo, considera ejecutar tu propio nodo de archivo con indexación de trazas

Tipos de Traza

El método devuelve diferentes tipos de trazas:

• call: Una llamada de mensaje a una dirección
• create: Una creación de contrato
• suicide: Una operación de autodestrucción de contrato (también conocida como SELFDESTRUCT)

Notas Importantes

• Este método requiere que las APIs de traza estén habilitadas en el nodo Ethereum
• No todos los clientes Ethereum soportan el filtrado de trazas (principalmente Geth con --gcmode=archive y OpenEthereum/Nethermind)
• Los proveedores públicos de RPC a menudo limitan o deshabilitan los métodos de traza debido a su intensidad de recursos
• Los filtros se aplican solo a las trazas almacenadas, no a los eventos de registro (usa eth_getLogs para registros de eventos)
• El tamaño de la respuesta puede ser muy grande para rangos de bloques amplios o direcciones populares
• Las restricciones de rango de bloques pueden ser impuestas por el proveedor de RPC (a menudo limitadas a unos pocos miles de bloques)
• Llamar a este método en un nodo no archivo devolverá resultados incompletos
• El filtrado de trazas consume significativamente más recursos que las consultas de transacciones regulares
• A diferencia de los eventos, las trazas no están indexadas por temas sino solo por direcciones y números de bloque
• Las transacciones que fallaron debido a falta de gas o reversiones aún producen trazas hasta el punto de fallo

Ver también

• trace_transaction - Recuperar trazas para una sola transacción
• trace_block - Recuperar trazas para todas las transacciones en un bloque
• trace_call - Ejecutar y trazar una llamada sin crear una transacción
• eth_getLogs - Alternativa para filtrar registros de eventos
• debug_traceTransaction - Obtener detalles de ejecución de nivel inferior para transacciones