“Enchain archived” no es un método JSON-RPC estándar ni un identificador de red suficientemente específico. En la práctica, la frase puede referirse a una cadena archivada, al estado histórico de una blockchain o a un archivo de código fuente y archivos ABI de contratos inteligentes antiguos. Esta guía separa esos significados y proporciona comprobaciones RPC reproducibles para bloques, código de contratos y llamadas históricas. También explica cómo registrar referencias de bloques, identificar consultas históricas no compatibles y evitar tratar los artefactos archivados como implementaciones actuales.
Significado y alcance de los datos archivados de Enchain
La frase “enchain archived” debe interpretarse antes de elegir un endpoint o escribir un indexador. No identifica un método RPC universal, un modo de nodo estándar ni un nombre de red confirmado. La definición operativa más segura es la de datos históricos asociados a una cadena o contrato que ya no forma parte del flujo de trabajo actual de la aplicación.
Hay tres casos que suelen confundirse. Un conjunto de datos de una cadena archivada contiene bloques, transacciones, recibos, registros de eventos y estado históricos. Un repositorio de contratos archivado contiene ABI, bytecode y archivos fuente antiguos. Una aplicación o red archivada puede haberse retirado, deshabilitado o dejado de mantener; eso no garantiza que sus datos históricos sigan siendo consultables.
Este artículo se centra en los dos primeros casos. Para elegir un endpoint, consulta la documentación de la red correspondiente y utiliza una comparación de proveedores solo después de confirmar que admite los métodos históricos necesarios. Un endpoint que sirve bloques recientes no es automáticamente un endpoint de archivo.
- Datos históricos de bloques: encabezados, transacciones, recibos y registros de eventos.
- Estado histórico: almacenamiento, saldos, nonces y código de contrato en un bloque pasado.
- Artefactos de contratos archivados: ABI, código fuente, metadatos de implementación y bytecode compilado.
- Infraestructura retirada: un servicio o red que quizá ya no proporcione datos.
Modelo de datos de archivo y referencias de bloques
Una consulta de blockchain solo tiene sentido cuando se conocen su red, referencia de bloque y tipo de datos. Un número de bloque como 12,345,678 se interpreta dentro de una cadena; no se puede trasladar entre redes. Prefiere un hash de bloque cuando necesites una referencia inmutable y registra el identificador de la cadena junto con él.
En redes compatibles con EVM, los métodos JSON-RPC suelen aceptar un parámetro de bloque como latest, earliest, pending, un número de bloque hexadecimal o un hash de bloque cuando el método lo permite. Por lo general, las llamadas al estado histórico requieren que el nodo conserve el trie de estado solicitado o una representación indexada equivalente. El acceso completo a transacciones y recibos históricos es una capacidad distinta del acceso al estado histórico.
El modelo mental práctico es una prueba de tres capas: primero confirma que el bloque existe; después, que el objeto solicitado existe en ese bloque; y, por último, que el nodo puede reconstruir el estado necesario en ese bloque. Una respuesta correcta en latest no demuestra ninguna de las capacidades históricas.
- Utiliza cantidades hexadecimales en los parámetros JSON-RPC, como
0x1. - Guarda en tus evidencias el ID de cadena, el número de bloque, el hash de bloque, la marca de tiempo y el método de consulta.
- Distingue entre “no encontrado”, “no conservado” y un error de método del proveedor.
- Trata un ABI archivado como una ayuda para la decodificación, no como una prueba de que el contrato siga existiendo.
Requisitos previos y recopilación de evidencias
Antes de consultar datos archivados, define la red y la pregunta histórica exacta. Algunos ejemplos son: “¿Qué código estaba implementado en esta dirección en el bloque B?”, “¿Cuál era el saldo del token en el bloque B?” o “¿Qué registros se emitieron entre los bloques A y B?”. Cada pregunta corresponde a métodos RPC y requisitos de retención diferentes.
Necesitas una URL RPC con la red requerida habilitada, la dirección objetivo y una referencia de bloque. Para una investigación reproducible, registra la configuración del endpoint, el ID de cadena, el cuerpo de la solicitud, el cuerpo de la respuesta, la hora UTC de la solicitud y cualquier identificador de solicitud del proveedor. No incluyas claves privadas en scripts de diagnóstico; las lecturas históricas no requieren firma.
Si estás creando una integración de producción, consulta la guía de endpoints RPC y compara el acceso compartido con un nodo dedicado. La decisión debe basarse en el volumen de consultas, la sensibilidad a la latencia, las necesidades de retención y los requisitos de aislamiento, no solo en la etiqueta “archivo”.
- RPC_URL: el endpoint de la red objetivo confirmada.
- CHAIN_ID: el identificador de cadena esperado, en formato hexadecimal o decimal.
- CONTRACT_ADDRESS: una dirección con checksum o validada de otro modo.
- BLOCK_TAG: un número de bloque hexadecimal o un hash de bloque.
- EXPECTED_METHODS: los métodos históricos que realmente necesita tu aplicación.
Verificación básica de bloques y código
Empieza con una consulta de bloque y otra de código. Esto establece si el endpoint reconoce la ubicación histórica solicitada y si había bytecode en la dirección en ese momento. El resultado del código puede ser 0x para una cuenta de propiedad externa, una dirección que aún no se había implementado o un contrato cuyo código se eliminó; interprétalo junto con las transacciones de implementación y la semántica de la cadena.
El siguiente procedimiento de shell utiliza marcadores de posición y no presupone ningún endpoint público. Sustituye RPC_URL, BLOCK_TAG y CONTRACT_ADDRESS por los valores de tu investigación.
- La respuesta del bloque debe incluir un hash de bloque si la referencia es válida.
- La respuesta del código debe registrarse exactamente, incluida su longitud y su hash.
- Repite la solicitud contra un segundo endpoint configurado de forma independiente cuando el resultado sea importante desde el punto de vista operativo.
export RPC_URL="https://YOUR_RPC_ENDPOINT"
export BLOCK_TAG="0xBLOCK_NUMBER"
export CONTRACT_ADDRESS="0xCONTRACT_ADDRESS"
curl -sS "$RPC_URL" \
-H 'content-type: application/json' \
--data "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"eth_getBlockByNumber\",\"params\":[\"$BLOCK_TAG\",false]}" | jq .
curl -sS "$RPC_URL" \
-H 'content-type: application/json' \
--data "{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"eth_getCode\",\"params\":[\"$CONTRACT_ADDRESS\",\"$BLOCK_TAG\"]}" | jq .Llamadas al estado histórico y artefactos de contratos archivados
Si la llamada tiene éxito, decodifica los bytes devueltos según la versión del ABI asociada a esa implementación. Si falla, la causa puede ser un estado histórico no compatible, un selector incorrecto, la ausencia del contrato en el bloque elegido, una llamada revertida o un límite del proveedor. No sustituyas silenciosamente el resultado más reciente.
const RPC_URL = process.env.RPC_URL;
const CONTRACT_ADDRESS = process.env.CONTRACT_ADDRESS;
const BLOCK_TAG = process.env.BLOCK_TAG; // example: 0xBLOCK_NUMBER
const SELECTOR = process.env.SELECTOR; // example: 0xFUNCTION_SELECTOR
if (!RPC_URL || !CONTRACT_ADDRESS || !BLOCK_TAG || !SELECTOR) {
throw new Error('Set RPC_URL, CONTRACT_ADDRESS, BLOCK_TAG, and SELECTOR');
}
const response = await fetch(RPC_URL, {
method: 'POST',
headers: { 'content-type': 'application/json' },
body: JSON.stringify({
jsonrpc: '2.0',
id: 1,
method: 'eth_call',
params: [{ to: CONTRACT_ADDRESS, data: SELECTOR }, BLOCK_TAG]
})
});
const body = await response.json();
if (body.error) throw new Error(JSON.stringify(body.error));
console.log(JSON.stringify({ blockTag: BLOCK_TAG, result: body.result }, null, 2));Resultados de verificación y registro de mediciones
| Prueba | Etiqueta del endpoint | Referencia de bloque | Estado del resultado | Latencia (ms) | Hash de respuesta | Notas |
|---|---|---|---|---|---|---|
| Consulta de bloque | ||||||
| Código del contrato | ||||||
eth_call histórico | ||||||
| Consulta de bloque repetida |
- Coincidencia de payloads: compara los hashes de bloque y los bytes de resultado, no solo los códigos de estado HTTP.
- Disponibilidad: registra tiempos de espera, límites de frecuencia, respuestas con formato incorrecto y errores JSON-RPC.
- Frescura: verifica que el endpoint pueda ver el bloque necesario antes de medir la latencia.
- Reproducibilidad: conserva los scripts, los detalles del entorno y los cuerpos de solicitud saneados.
Solución de problemas de consultas históricas
Una solicitud histórica puede fallar incluso cuando las solicitudes recientes funcionan. Diagnostica el fallo acotando la consulta: obtiene el bloque, la transacción o el recibo si corresponde, el código en ese mismo bloque y solo después realiza una llamada al estado. Esta secuencia permite distinguir los datos ausentes de una lógica de aplicación incorrecta.
Entre los errores habituales y sus posibles explicaciones se incluyen:
Un proveedor puede devolver un error JSON-RPC para indicar que un rango de estado histórico no está disponible. Algunos servicios solo exponen una ventana de retención, mientras que otros requieren un plan o una configuración de nodo con capacidad de archivo. Un resultado null para una transacción o un bloque puede indicar una referencia no válida, una red incorrecta o datos indexados no disponibles. Un eth_call revertido puede ser un revertido real del contrato y no un fallo del archivo.
Para los registros, divide un rango de bloques grande en ventanas más pequeñas y verifica si el fallo depende del tamaño de un rango concreto. Para el estado, prueba con un bloque histórico reciente y después retrocede en intervalos controlados. Para la verificación de contratos, compara el bytecode en tiempo de ejecución en el bloque de implementación con el artefacto compilado y ten en cuenta los metadatos del compilador, la arquitectura de proxy y las actualizaciones de implementación.
- Red incorrecta: comprueba
eth_chainIdantes de cada investigación entre redes. - Formato de bloque incorrecto: utiliza una cantidad hexadecimal con el prefijo
0x. - No hay código en el bloque: comprueba el momento de implementación y el historial de implementación del proxy.
- Profundidad de archivo no compatible: prueba la misma solicitud en un endpoint documentado para la retención requerida.
- Límite de frecuencia: reduce la concurrencia, añade backoff y conserva los detalles de las solicitudes fallidas.
- Confusión con el proxy: inspecciona el almacenamiento de implementación del proxy en el bloque histórico.
Compensaciones y límites operativos del acceso a archivos
El acceso con capacidad de archivo es valioso cuando una aplicación necesita el estado de bloques históricos arbitrarios, pero no es automáticamente la mejor opción para todas las cargas de trabajo. La indexación reciente, la recuperación de eventos y las lecturas del estado actual pueden gestionarse de forma más eficiente mediante servicios indexados especializados o un nodo estándar. Por el contrario, una ventana de retención corta no es adecuada para análisis forenses que se remonten a las primeras implementaciones.
Las principales compensaciones son la profundidad de retención, los métodos compatibles, los límites de solicitudes, la consistencia de la latencia, el enrutamiento geográfico, el coste y el aislamiento operativo. Un servicio puede describirse como archivístico aunque solo admita determinados métodos históricos o un rango limitado de datos indexados. Lee la documentación actual del endpoint y valida los métodos exactos que necesita tu aplicación.
Para planificar costes, compara el volumen de solicitudes previsto y el tipo de consultas históricas con la información de precios de RPC. Si necesitas una capacidad predecible o aislamiento del tráfico privado, evalúa las opciones de nodos dedicados. Las recomendaciones concretas de redes y endpoints deben incluirse en la guía correspondiente del RPC Assistant, no basarse en la suposición de que todos los resultados “archivados” son intercambiables.
- El estado histórico es diferente de los registros históricos y de la indexación de transacciones.
- La documentación del proveedor puede no cubrir todos los métodos, rangos de bloques o patrones de proxy.
- La redundancia aumenta la confianza, pero no corrige un bloque o ABI incorrectos.
- Los datos archivados deben tratarse como una fuente de evidencias con procedencia.
Próximos pasos para una investigación de Enchain archivado
Empieza indicando la red, la dirección, la referencia de bloque y la pregunta histórica exacta. Después ejecuta las comprobaciones de bloque y código, realiza la consulta de estado válida más acotada y guarda las evidencias de la respuesta. Si el término se refiere, en cambio, a un repositorio de contratos archivado, utiliza los artefactos para identificar la versión de implementación, pero confirma el bytecode en la cadena y la transacción de implementación antes de basarte en ellos.
Para un proyecto de ingestión de mayor escala, diseña el sistema en torno a rangos de bloques con checkpoints, llamadas JSON-RPC reintentables, decodificación determinista y un esquema de base de datos que almacene el ID de cadena, el hash de bloque, el hash de transacción, la dirección del contrato, el método, la respuesta y la procedencia. Consulta la guía general de RPC multicadena cuando el mismo flujo de trabajo deba ejecutarse en varias redes.
La decisión final no consiste en determinar si un endpoint es simplemente “archivado”. Consiste en saber si puede responder de forma reproducible a las consultas históricas que necesita tu aplicación, dentro de los límites requeridos de retención, fiabilidad y coste. Mantén explícitas en el código las lecturas actuales y las históricas para que un fallback no devuelva accidentalmente un estado más reciente que el que se está investigando.
- Valida la identidad de la red con
eth_chainId. - Fija las solicitudes históricas a un número de bloque o hash.
- Registra las respuestas sin procesar antes de decodificarlas.
- Prueba bloques antiguos, intermedios y recientes representativos.
- Escala la selección del endpoint solo después de definir el comportamiento de archivo requerido.