Docs

HiDHT es un checker de IPFS CID para diagnósticos rápidos de recuperación. Ayuda a desarrolladores, operadores de almacenamiento, equipos NFT, publicadores de datos y soporte a responder una pregunta práctica: ¿este CID puede encontrarse y recuperarse desde la red pública IPFS?

La herramienta se centra en señales útiles durante la resolución real de problemas: validación de formato CID, descubrimiento de proveedores mediante enrutamiento delegado, alcance de gateways públicos, tiempos de respuesta, comportamiento de caché y mensajes de error claros.

Cada comprobación empieza con validación de CID. HiDHT verifica si la entrada parece un IPFS CID válido antes de hacer pruebas de red. Esto detecta errores comunes como identificadores truncados, URLs pegadas, caracteres no soportados o espacios alrededor del CID.

La validación de CID no demuestra que el contenido esté online. Solo confirma que el identificador puede usarse estructuralmente para los siguientes pasos.

HiDHT comprueba el descubrimiento de proveedores mediante enrutamiento delegado y endpoints relacionados de IPFS. Los registros de proveedores indican que uno o más peers han anunciado que pueden servir el CID o sus datos de bloque.

Una búsqueda de proveedores exitosa es una señal fuerte de descubribilidad, pero no equivale a una descarga completa. Los proveedores pueden estar temporalmente inaccesibles, detrás de redes lentas o anunciando datos que un gateway no logra recuperar dentro de su timeout.

Después del descubrimiento de proveedores, HiDHT prueba gateways públicos configurados con métodos de solicitud seguros. Los resultados muestran si rutas HTTP comunes de acceso IPFS pueden resolver el CID en ese momento.

El comportamiento de gateways puede variar. Algunos bloquean ciertos tipos de contenido, aplican límites, dependen de caché o expiran mientras recuperan bloques no cacheados desde la red.

Un resultado saludable suele tener un CID válido, al menos una señal de proveedor y una o más respuestas correctas de gateway. Los tiempos ayudan a distinguir recuperación rápida desde caché de recuperación más lenta desde red.

Si hay proveedores pero fallan los gateways, el CID puede estar anunciado pero ser difícil de recuperar desde gateways públicos. Si los gateways funcionan y la búsqueda de proveedores está vacía, el gateway puede tener el contenido en caché o haberlo encontrado por rutas no visibles en la búsqueda actual.

Sin resultados de proveedores suele significar que el contenido no está anunciado actualmente, el anuncio expiró o la ruta de búsqueda no encontró un proveedor activo. Vuelve a fijar el contenido, espera a que los registros se propaguen y prueba otra vez.

Los timeouts de gateway suelen significar que el gateway no pudo recuperar bloques suficientemente rápido. Prueba otro gateway, confirma que el contenido está fijado en un nodo alcanzable y comprueba si el CID apunta a un árbol UnixFS grande que requiere más tiempo.

HiDHT no rastrea todo el DHT global, no inspecciona estado de nodos privados, no renderiza archivos remotos, no clasifica contenido y no actúa como gateway IPFS permanente. Es una superficie de diagnóstico para señales de disponibilidad, no un servicio de almacenamiento u hosting.

El checker evita descargar y mostrar contenidos de archivo. Esto mantiene el producto enfocado en metadatos de recuperación y reduce exposición innecesaria a contenido remoto arbitrario.

Usa HiDHT antes de compartir un CID públicamente, después de subir contenido a IPFS, cuando falla una URL de gateway, cuando metadatos NFT o de dataset parecen no disponibles o cuando soporte necesita un reporte neutral.

HiDHT también ayuda a descubrir demanda de monitoreo. Comprobaciones manuales repetidas pueden mostrar si los usuarios necesitan comprobaciones programadas, alertas, API o reportes históricos de disponibilidad para CIDs importantes.