Skip to content

PointSav Documentation

The engineering library for the PointSav platform — operating systems and services for regulated businesses that own their data, their AI, and their record-keeping outright. Where the monorepo holds the code, this wiki holds the reasoning: architecture, services, security, and the governance commitments that bind future development.

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

  1. Obtenga entradas desde un cursor, comenzando en 0 para el historial completo:

    curl -s -H "X-Foundry-Module-ID: <su-id-de-modulo>" \
      "http://<host-de-service-fs>/v1/entries?since=0"
    

    La cabecera es obligatoria — un X-Foundry-Module-ID ausente devuelve un 400, y uno no coincidente devuelve un 403. Cada entrada en la respuesta lleva un cursor, un payload_id y la propia payload.

  2. Avance usando el propio campo next_cursor de la respuesta:

    curl -s -H "X-Foundry-Module-ID: <su-id-de-modulo>" \
      "http://<host-de-service-fs>/v1/entries?since=<next_cursor>"
    

    Repita hasta que la lista de entradas devuelta esté vacía — ese es el final del libro mayor al momento de su solicitud.

  3. Obtenga el punto de control actual para anclar lo que acaba de leer:

    curl -s -H "X-Foundry-Module-ID: <su-id-de-modulo>" \
      "http://<host-de-service-fs>/v1/checkpoint"
    

    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"), un timestamp y una signature.

    Nota: signature solo está presente si la instancia de service-fs se inició con una clave de firma configurada. Un despliegue sin firmar devuelve signature: 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

Véase también

Cite this record: /wiki/read-the-command-ledger — revision 9b9339a2, last updated 6 August 2026.

Important Information

Estructura corporativa. PointSav Digital Systems ("PointSav") es actualmente un nombre comercial de Woodfine Capital Projects Inc. ("Woodfine"), con previsión de convertirse en una subsidiaria de propiedad absoluta de Woodfine tras su incorporación. PointSav no ofrece, vende ni solicita por sí mismo valor alguno. Toda oferta de valores asociada a las soluciones inmobiliarias de tenencia directa de Woodfine se realiza exclusivamente por parte de Woodfine, y únicamente por medio del Memorando de Colocación Privada aplicable.

Sin asesoramiento de inversión. El contenido de este wiki se ofrece con fines de ingeniería, operativos, de investigación y de desarrollo. Nada de lo que figura en este wiki constituye asesoramiento de inversión ni una solicitud para invertir en ninguna sociedad o solución de tenencia directa de Woodfine.

Propiedad intelectual. El nombre, el nombre comercial, el logotipo y las marcas de PointSav, junto con todos los productos, servicios y ofertas actuales y futuros de las marcas PointSav y Totebox — así como el software, el código fuente, la documentación, el sistema de diseño y todos los materiales relacionados — son propiedad de Woodfine y sus filiales, salvo los componentes identificados como de código abierto. No se otorga ningún derecho salvo el expresamente establecido en una licencia o acuerdo por escrito. El aviso de marcas completo aparece en el pie de página de cada página de este sitio.

Componentes de código abierto. Algunas partes de la plataforma se ofrecen bajo licencias de código abierto permisivas identificadas en el repositorio correspondiente. El uso de esos componentes se rige por los términos de sus respectivas licencias.

Sin garantía; uso informativo. El contenido de este wiki se ofrece únicamente con fines informativos generales y no constituye una declaración, garantía ni compromiso respecto de la funcionalidad, disponibilidad, precio o hoja de ruta de ningún producto. Algunos artículos describen características, capacidades e hitos planificados o previstos — el lenguaje como "planificado", "previsto", "objetivo", "puede" y "esperado" marca este contenido prospectivo, que está sujeto a cambios y no constituye un compromiso respecto del rendimiento futuro.

Confidencialidad. Cuando un artículo describiría un detalle operativo o de implementación no destinado a divulgación pública, ese artículo no se publica en este wiki. El contenido aquí es documentación de ingeniería de uso general, no configuración específica de clientes.

Jurisdicción. Woodfine Capital Projects Inc. está constituida en Columbia Británica, Canadá. Las referencias a la Sovereign Data Foundation en este wiki describen una iniciativa planificada o prevista únicamente, no una titular de capital actual ni un órgano de gobierno activo.

Cambios a este aviso. PointSav podrá actualizar este aviso periódicamente; rige la versión publicada en esta página.

No es un sistema de presentación de documentos. Este wiki no es un sistema de presentación de valores, un repositorio de divulgación electrónica ni un sustituto de SEDAR+ ni de ningún otro sistema de presentación regulatorio. Las presentaciones formales de valores se realizan a través del sistema de presentación regulatorio correspondiente, no a través de este wiki.

Descargo completo. Este aviso complementa, y no sustituye, el artículo completo de Avisos Legales. En caso de cualquier conflicto, prevalece el artículo de Avisos Legales.

Read the full disclaimer →