Leer el libro mayor de comandos
Requisitos previos
- Acceso de red a su instancia de
service-fs - Su identificador de módulo para la cabecera obligatoria
X-Foundry-Module-ID
Propósito
Lea el historial del libro mayor y obtenga un punto de control verificable a través de la API HTTP real de service-fs — un par de minutos. No existe ninguna pantalla de navegación del libro mayor en os-console; F12 solo muestra un indicador en línea de altura/raíz mientras un envío está en curso, no un historial que pueda recorrer.
Procedimiento
-
Obtenga entradas desde un cursor, comenzando en 0 para el historial completo:
La cabecera es obligatoria — un
X-Foundry-Module-IDausente devuelve un 400, y uno no coincidente devuelve un 403. Cada entrada en la respuesta lleva uncursor, unpayload_idy la propiapayload. -
Avance usando el propio campo
next_cursorde la respuesta:Repita hasta que la lista de entradas devuelta esté vacía — ese es el final del libro mayor al momento de su solicitud.
-
Obtenga el punto de control actual para anclar lo que acaba de leer:
La respuesta lleva
tree_size(la altura del libro mayor — el recuento total de entradas),root_hash(un hash SHA-256 de la punta, codificado en hexadecimal),algorithm("sha256"), untimestampy unasignature.Nota:
signaturesolo está presente si la instancia deservice-fsse inició con una clave de firma configurada. Un despliegue sin firmar devuelvesignature: null— ese es un estado de configuración real y válido, no una respuesta rota.
Resultado esperado
El conjunto completo de entradas del libro mayor desde su cursor inicial en adelante, más un punto de control que le da la altura actual del libro mayor y el hash raíz contra el cual verificarlas.
Verificación
Confirme que el número de entradas que recorrió es coherente con el tree_size del punto de control en el momento en que lo obtuvo. Obtener entradas y el punto de control no son atómicos entre sí, así que una pequeña brecha por actividad entre las dos llamadas es esperada, no un error. Para un procedimiento completo paso a paso de verificación contra manipulación usando el hash y la firma del punto de control, véase Verificar una entrada del libro mayor WORM — esta guía cubre la lectura del libro mayor, no la demostración de que no ha sido alterado.
Reversión
La lectura no es destructiva — no hay nada que deshacer. Volver a ejecutar cualquiera de las llamadas anteriores siempre es seguro.
Próximos pasos
- Verificar una entrada del libro mayor WORM — verifique el hash y la firma de un punto de control contra las entradas que cubre
- Ejecutar su primera consulta SLM — una ruta HTTP real separada, para inferencia en lugar de lecturas del libro mayor
Véase también
- service-fs — el núcleo del libro mayor WORM — la capa de almacenamiento WORM a la que pertenecen estos endpoints
- Substrato WORM — arquitectura del ledger inmutable de cuatro capas y dos sobres de arranque — qué cubre la garantía WORM y qué no
- Aplicación de entrada de consola — la Máquina de Entrada F12 que escribe las entradas que está leyendo aquí
Cite this record: /wiki/read-the-command-ledger — revision 9b9339a2, last updated 6 August 2026.