Intramedial está en beta restringida. Al registrarte o iniciar sesión, debes indicar la contraseña de beta tester que recibiste o solicitar una en preview@intramedial.com. Gracias.
Cargando…
ledger-bundles.snapshotMódulo 49
Módulo de la plataforma
Signed evidence bundles
Sella la cadena de auditoría de tu workspace en un paquete firmado que un auditor puede comprobar sin red, frente a una clave publicada para que cualquiera la lea.
ledger-bundles.snapshot firma un rango del log de auditoría con una clave por jurisdicción y devuelve el paquete. La clave pública correspondiente está en un endpoint JWK conocido, y el mismo código la verifica en la ruta pública y sin red, así que una comprobación nunca depende de preguntar a Intramedial.
Los agentes actúan cuando el plano dice sí, y el registro dice por qué.
Pasa por Intramedial acciones de agentes, hashes de contenido, pruebas de API, DNS, webhooks, llamadas LLM y commits. Obtén un recibo firmado que cualquiera verifica, sin fiarse de nadie.
EstadoEl anclaje en Bitcoin se comprueba contra la cabecera del bloque
La ruta pública /ots/verify vuelve a ejecutar el árbol de operaciones de la prueba desde el digest anclado y compara la raíz Merkle derivada con la cabecera del bloque nombrado. Se rechaza un árbol de operaciones manipulado que nombre un bloque real. Prueba que el digest existía en ese bloque, no qué representa el digest. La raíz Merkle del bloque sale de una API pública de Bitcoin; no se comprueban la prueba de trabajo de la cabecera ni una profundidad mínima de confirmaciones, y notVerified lo dice.
Registro
El registro
Qué se registra
bundleId
El id propio del paquete.
jurisdiction
La región cuya clave de firma selló este paquete.
rangeStart
El inicio del rango sellado, o sin fijar cuando la instantánea partió del génesis.
La raíz sobre los hashes de los registros sellados.
recordCount
Cuántas filas del log de auditoría cubre el paquete.
signingKeyId
Qué clave publicada firmó el paquete, contrastada con el conjunto JWK conocido.
ed25519Signature
La firma sobre la forma canónica del paquete.
otsProof
null hasta que el cron diario de anclaje confirma un bloque de Bitcoin para la superraíz de este paquete.
Mecanismo
Paso a paso
Cómo funciona
Se solicita una instantánea
POST /api/v1/ledger-bundles/snapshot con scope, rangeStart y rangeEnd opcionales; omitir el rango captura todo el historial de auditoría hasta hoy, no uno incremental.
La cadena se sella y se firma
Las filas del log de auditoría en el rango se agrupan con hash en una raíz Merkle y se firman con la clave Ed25519 de la jurisdicción de la petición; sin clave aprovisionada para esa región, la petición responde 503 en lugar de firmar con la clave equivocada.
La clave pública ya está publicada
GET /.well-known/ledger-bundles-keys.json sirve el conjunto JWK sin autenticación, así que la firma de un paquete se puede comprobar sin contactar de nuevo con Intramedial.
Una superraíz se ancla después en Bitcoin
Un cron diario agrupa las raíces de los paquetes pendientes en una superraíz, la envía una vez a OpenTimestamps y más tarde registra el bloque de Bitcoin cuando la prueba se confirma.
Pruébalo
Demo en vivo
Ejecútalo desde esta página
POST/api/v1/ledger-bundles/snapshot
{}
Las llamadas de este módulo cambian estado real o llegan a servicios externos, por lo que la demostración compartida no las ejecuta. Inicia sesión para ejecutarlo en tu propio workspace. Docs de ledger-bundles.snapshot
Respuestas
Las llamadas de este módulo cambian estado real o llegan a servicios externos, por lo que la demostración compartida no las ejecuta. Inicia sesión para ejecutarlo en tu propio workspace.
Código
Ejemplo en vivo
Una petición real
Una petición con la forma que acepta la API y una respuesta de ejemplo con la forma que devuelve el módulo.
Un auditor descarga un paquete y la clave publicada, y verifica por sí mismo la firma y el recuento de registros, sin volver a llamar a Intramedial.
Sellar el historial de auditoría de un trimestre
Un workspace toma una instantánea de su log de auditoría al cierre del trimestre, nombrando el rango explícitamente en lugar de dejar que una instantánea por defecto vuelva a capturar todo desde el génesis.
Firma ahora, prueba de Bitcoin después
La firma se puede comprobar en cuanto se emite el paquete; el anclaje de Bitcoin que confirma su marca de tiempo llega más tarde, cuando se resuelve la prueba del cron diario.
Saber qué cubre la comprobación en línea
Un revisor de seguridad lee el campo verified: "merkle_path_to_block_header" de la respuesta de /ots/verify y sabe que el árbol de operaciones se volvió a ejecutar desde el digest y coincidió con la raíz Merkle de la cabecera del bloque. Una marca de tiempo de calendario sin más necesita que se envíe con ella digestSha256.
Cuándo usar otra cosa
Tomar instantáneas del ledger de coordinación que lee ledger.blame. Los paquetes sellan la tabla audit_log aparte de la región, un rastro totalmente distinto.
Una instantánea incremental desde la última vez. Omitir un rango captura todo el historial hasta hoy, cada vez.
Uso en el plan gratuito. Crear cada instantánea necesita un plan de pago; el plan gratuito apunta en cambio a la cadena Tops.
Evidencia
Garantías
Qué hace y qué no hace
Un módulo es una afirmación fuerte sobre algo acotado. Confía en él exactamente para lo que es.
Hace
La firma de un paquete se verifica con el conjunto JWK publicado usando solo el paquete y esa clave, sin más llamadas a Intramedial.
El mismo código de verificación corre en la ruta pública /verify y en el paquete verificador sin red, así que ambos no pueden divergir en silencio.
Una petición de instantánea sin clave aprovisionada para su jurisdicción se rechaza con 503, nunca se firma con una clave de otra región.
No hace
Que la marca de tiempo de un paquete pending esté ya anclada en Bitcoin; otsProof sigue en null y la respuesta nunca fabrica una confirmación.
Que el digest anclado pertenezca a algún artefacto concreto de Intramedial; /ots/verify prueba que el digest existía en el bloque atestado, nada sobre qué representa.
Que el propio bloque de Bitcoin sea genuino: /ots/verify toma la raíz Merkle del bloque de una API pública (Blockstream) sin comprobar la prueba de trabajo ni la profundidad de confirmación.
Que un agente que llama a la acción MCP pueda fijar rangeStart, rangeEnd o . Su esquema solo expone ; esos campos llegan al worker REST únicamente desde el cliente propio del panel.
Detalles
Notas de construcción
Antes de construir
Dos sistemas Merkle, no uno
El árbol binario con separación de dominio de este módulo sobre las filas del log de auditoría es una implementación aparte del agrupamiento del ledger de coordinación en ledger.blame; nunca deben describirse como el mismo mecanismo.
El plan limita la creación, no la verificación
Los workspaces gratuitos no pueden crear una instantánea; Starter y superiores pueden comprar una por instantánea, Pro añade una suscripción de anclaje automático diario y Enterprise la incluye. Verificar un paquete que cualquiera tiene es gratis en todos los planes.
Ningún id de acción coordination.*
Las acciones MCP de este módulo viven en su propio archivo de contrato fuera de contracts/src/actions/coordination.ts, así que ninguna aparece aquí como acción coordination.*.
Límites y medición
Sin rangeStart, una instantánea captura todo el historial de auditoría desde el génesis, lo que puede ser grande en un workspace antiguo.
Una instantánea necesita una clave de firma aprovisionada para la jurisdicción de la petición; sin ella responde 503 en lugar de tomar prestada la clave de otra región.
Crear una instantánea necesita un plan de pago; el plan gratuito no puede llamar a esta ruta.
Acceso
API y MCP
REST y MCP
Autentícate con una clave de API del workspace como token Bearer. La URL base es https://api.intramedial.com.
Endpoints REST
POST/api/v1/ledger-bundles/snapshotSella y firma un rango de la cadena de auditoría.
GET/api/v1/ledger-bundles/anchorsLista las pruebas de anclaje en Bitcoin registradas para los paquetes de este workspace.
GET/api/v1/ledger-bundles/verify-chainComprueba la integridad de los enlaces hash de la propia cadena de auditoría, gratis y sin medición.
Acciones MCP
Este módulo no tiene acción MCP. Llámalo por REST desde cualquier agente o programa.
Planifica dónde deben vivir los registros de coordinación de este workspace, ve exactamente qué se movería y llévalo a otra región cuando tú lo decidas.
Módulo de la plataforma
