Descargar: glossary.md (12 KB)
Glosario del Grabador
Definiciones cortas y canónicas para los términos del contrato de Grabador.
actor_id
Categoría: schema_field
actor_id vincula el evento a su identidad de productor declarativa, lo que permite flujos de trabajo de consulta y auditoría conscientes de la procedencia.
Términos Relacionados: environment_id, event_type
attachment_hashes
Categoría: verificación
Los registros attachment_hashes esperan los resúmenes de los archivos adjuntos utilizados para verificar la integridad de los bytes del archivo adjunto en la verificación del paquete.
Términos Relacionados: attachment_refs, manifest
attachment_refs
Categoría: schema_field
attachment_refs contiene el tipo de contenido, hash y metadatos de tamaño para cada archivo adjunto incluido con un sobre.
Términos Relacionados: attachment_hashes, content_hash
Paquete
Categoría: núcleo
Un paquete es el formato de exportación determinista utilizado para la verificación offline, que incluye segmentos, sobres, bytes de adjunto y un manifiesto de verificación.
Términos Relacionados: attachment_hashes, bundle_selector, verification_manifest
Ejemplos:
examples/bundle.json#: Paquete autónomo utilizado para la validación de contratos.
Selector de Paquetes
Categoría: núcleo
El selector captura qué subconjunto de evidencia se exporta a un paquete. La muestra canónica utiliza BySegment para reproducciones estables.
Términos Relacionados: bundle, segment
chain_hash
Categoría: integrity_field
chain_hash vincula cada sobre al estado anterior de la cadena, proporcionando evidencia de manipulación para el orden de adición y la continuidad.
Términos Relacionados: content_hash, segment
claimed_time
Categoría: schema_field
claimed_time es el tiempo del evento proporcionado por el operador, capturado como componentes estructurados en UTC en la codificación de sobre canónica.
Términos Relacionados: event_type, sequence
content_hash
Categoría: integrity_field
content_hash se calcula a partir de los bytes del cuerpo del sobre canónico y se utiliza para el seguimiento de la integridad de la carga útil y los archivos adjuntos.
Términos Relacionados: chain_hash, envelope
contract_version
Categoría: proyección
contract_version marca la superficie de compatibilidad para los artefactos generados y se incluye en los archivos de contrato de índice y tooltip.
Términos Relacionados: index_manifest, tooltips_catalog
emit_envelope
Categoría: método_de_contrato
Método emit_envelope de RecorderAdapter. Forma de la solicitud: UnsealedEnvelope. Forma de la respuesta: EnvelopeReceipt. Este método es parte del contrato generado canónicamente y es consumido por herramientas posteriores y proyecciones de documentación.
Términos relacionados: recorder_adapter
emitwithattachments
Categoría: método_de_contrato
Método emit_with_attachments de RecorderAdapter. Forma de la solicitud: UnsealedEnvelope + Vec<AttachmentData>. Forma de la respuesta: EnvelopeReceipt. Este método es parte del contrato generado canónicamente y es consumido por herramientas posteriores y proyecciones de documentación.
Términos relacionados: recorder_adapter
Sobre
Categoría: núcleo
Un sobre es la unidad de evidencia canónica de solo anexar que contiene campos de identidad, carga útil, referencias de adjuntos y hashes de integridad.
Términos Relacionados: chain_hash, content_hash, segment, signature
Ejemplos:
examples/envelope.json#: Ejemplo canónico de sobre emitido por recorder-contract.
id (sobre)
Categoría: schema_field
Los ID de sobre proporcionan referencias inmutables para la membresía en la cadena, enlaces parentales y manifiestos de verificación.
Términos Relacionados: segment_id, trace_id
environment_id
Categoría: schema_field
environment_id identifica el entorno de ejecución donde ocurrió el evento y admite filtrado basado en el entorno.
Términos relacionados: actor_id, trace_id
event_type
Categoría: schema_field
event_type captura la taxonomía de eventos determinísticos utilizada para el filtrado y la evaluación de políticas en etapas posteriores.
Términos Relacionados: payload, trace_id
ProveedorDeEvidencia
Categoría: tipo_de_contrato
EvidenceProvider define superficies de consulta y recuperación de paquetes deterministas consumidas por planos de control como Decision Gate.
Términos Relacionados: fetch_bundle, list_bundles, query_envelopes, verify_bundle
fetch_bundle
Categoría: método_de_contrato
Método fetch_bundle de EvidenceProvider. Forma de la solicitud: BundleId. Forma de la respuesta: Bundle. Este método es parte del contrato generado canónico y es consumido por herramientas y proyecciones de documentación posteriores.
Términos relacionados: evidence_provider
flush
Categoría: método_de_contrato
Método flush de RecorderAdapter. Forma de la solicitud: (). Forma de la respuesta: (). Este método es parte del contrato generado canónicamente y es consumido por herramientas de downstream y proyecciones de documentación.
Términos relacionados: recorder_adapter
glossary.md
Categoría: proyección
glossary.md se genera a partir del catálogo de tooltips canónico para mantener las explicaciones de términos en formato largo alineadas con los metadatos de tooltips legibles por máquina.
Términos relacionados: tooltips_catalog
hashalgorithmid
Categoría: integrity_field
hash_algorithm_id marca el algoritmo utilizado para el hashing de segmentos y manifiestos, de modo que la verificación pueda utilizar semánticas de hash deterministas.
Términos Relacionados: chain_hash, content_hash
salud
Categoría: método_de_contrato
Método health de RecorderAdapter. Forma de la solicitud: (). Forma de la respuesta: AdapterHealth. Este método es parte del contrato generado canónicamente y es consumido por herramientas y proyecciones de documentación posteriores.
Términos relacionados: recorder_adapter
index.json
Categoría: proyección
index.json inventarios generados de artefactos y hashes por archivo. Las proyecciones posteriores deben verificar los bytes del artefacto contra este manifiesto antes de publicar.
Términos Relacionados: contract_version, glossary_markdown, tooltips_catalog
key_id
Categoría: seguridad
key_id vincula una firma de sobre con material de clave pública de trust-root durante las verificaciones de la fase de verificación.
Términos Relacionados: firma, confianza_raíz
list_bundles
Categoría: método_de_contrato
Método EvidenceProvider list_bundles. Forma de la solicitud: BundleFilter. Forma de la respuesta: Vec<BundleMetadata>. Este método es parte del contrato generado canónicamente y es consumido por herramientas y proyecciones de documentación posteriores.
Términos relacionados: evidence_provider
manifiesto
Categoría: verificación
El manifiesto lista los resúmenes de segmentos, los hashes de los adjuntos y los metadatos de omisión utilizados para verificar los paquetes exportados sin conexión.
Términos Relacionados: attachment_hashes, verification_manifest
omitted_parents
Categoría: verificación
omitted_parents captura omisiones explícitas de padres en exportaciones parciales para que los verificadores puedan distinguir entre los huecos esperados y los defectos de integridad.
Términos Relacionados: manifest, proof_anchor
parent_id
Categoría: schema_field
parent_id captura las relaciones padre-hijo entre sobres cuando los flujos de trabajo de nivel superior necesitan una jerarquía explícita.
Términos Relacionados: envelope_id, trace_id
carga útil
Categoría: schema_field
el payload lleva el objeto JSON específico del evento y está cubierto por políticas de hash de contenido y firma.
Términos Relacionados: content_hash, event_type
Ejemplos:
examples/envelope.json#/payload: Forma mínima del payload utilizada por el fixture del contrato generado.
cadenadepredecesores_cabeza
Categoría: integrity_field
predecessor_chain_head registra el estado de la cadena de segmentos anterior necesario para validar el enlace entre segmentos durante la verificación.
Términos Relacionados: chain_hash, predecessor_id
predecessor_id
Categoría: integrity_field
predecessor_id vincula un segmento al segmento anterior en cadenas de continuidad entre segmentos cuando está presente.
Términos Relacionados: predecessor_chain_head, segment
Proof Anchor
Categoría: verificación
Un ancla de prueba captura el estado de la cadena antes del primer sobre incluido en un segmento parcial para preservar las verificaciones de integridad de subsecuencia determinista.
Términos Relacionados: bundle, segment, verification_manifest
query_envelopes
Categoría: método_de_contrato
Método EvidenceProvider query_envelopes. Forma de la solicitud: EnvelopeFilter. Forma de la respuesta: Vec<Envelope>. Este método es parte del contrato generado canónicamente y es consumido por herramientas posteriores y proyecciones de documentación.
Términos relacionados: evidence_provider
RecorderAdapter
Categoría: tipo_de_contrato
RecorderAdapter es el límite de ingestión utilizado por las integraciones para emitir eventos no sellados y cargas útiles de adjuntos en el flujo de grabación canónico.
Términos Relacionados: emit_envelope, emit_with_attachments, health
recorder_id
Categoría: runtime
recorder_id marca qué tiempo de ejecución del grabador emitió el génesis del segmento y admite análisis de procedencia de múltiples grabadores.
Términos Relacionados: segment_genesis, segment_id
schema_version
Categoría: schema_field
schema_version lleva metadatos de versionado del modelo para registros de sobre y segmento para hacer cumplir verificaciones de compatibilidad determinísticas.
Términos Relacionados: contract_version, index_manifest
Segment
Categoría: núcleo
Un segmento agrupa sobres en una partición ordenada de solo anexado anclada por SegmentGenesis y opcionalmente cerrada por un sobre de sello.
Términos Relacionados: bundle, proof_anchor, segment_genesis
Ejemplos:
examples/segment.json#: Metadatos de génesis de segmento utilizados por el ejemplo de paquete.
SegmentGenesis
Categoría: verificación
SegmentGenesis registra la identidad del segmento, el enlace del predecesor, el algoritmo hash, el ID del registrador y la versión del esquema utilizada en la creación del segmento.
Términos Relacionados: predecessor_chain_head, predecessor_id, recorder_id, segment
segment_id
Categoría: schema_field
segment_id une sobres, registros de génesis de segmento, selectores y filas de segmento de manifiesto bajo una única identidad de partición de solo anexado.
Términos Relacionados: envelope_id, segment
secuencia
Categoría: integrity_field
la secuencia codifica el orden de adición para los sobres dentro de un segmento y participa en las verificaciones de continuidad.
Términos Relacionados: chain_hash, segment
session_id
Categoría: schema_field
session_id captura la continuidad a nivel de sesión cuando se necesita agrupar evidencia por límites de sesión interactiva o en tiempo de ejecución.
Términos relacionados: actor_id, trace_id
firma
Categoría: seguridad
las tiendas de firma almacenan el ID de la clave, el algoritmo y los bytes de la firma para las verificaciones de autenticidad bajo la política de raíz de confianza del verificador.
Términos Relacionados: key_id, signature_algorithm, trust_root
algoritmo (firma)
Categoría: seguridad
El marcador del algoritmo de firma identifica cómo se deben verificar los bytes de la firma en relación con el material clave de la raíz de confianza.
Términos Relacionados: key_id, signature
tooltips.annotations.json
Categoría: proyección
tooltips.annotations.json mapea punteros de esquema y claves de término a entradas de catálogo para que los bloques de código de la interfaz de usuario y los ejemplos de JSON puedan resolver las descripciones emergentes de manera consistente.
Términos relacionados: tooltips_catalog
tooltips.catalog.json
Categoría: proyección
tooltips.catalog.json es el catálogo de términos de clase mundial legible por máquina, con categorías, referencias, términos relacionados y ejemplos de vinculaciones.
Términos Relacionados: glossary_markdown, tooltips_annotations
trace_id
Categoría: schema_field
trace_id proporciona correlación determinista entre sobres para flujos de trabajo de selección de consultas y paquetes.
Términos Relacionados: actor_id, event_type
Confianza Raíz
Categoría: seguridad
La raíz de confianza mapea los identificadores de clave a claves públicas y define la semántica de la política de firma que se aplica durante las verificaciones de firma del verificador.
Términos Relacionados: key_id, signature, signature_algorithm
Manifestación de Verificación
Categoría: verificación
El manifiesto de verificación registra los encabezados de cadena de segmentos declarados, los hashes de adjuntos y los metadatos de omisión utilizados por las fases del verificador fuera de línea.
Términos Relacionados: attachment_hashes, bundle, omitted_parents
Ejemplos:
examples/bundle.json#/manifest: Objeto de manifiesto en el ejemplo de paquete generado.
verify_bundle
Categoría: método_de_contrato
Método verify_bundle de EvidenceProvider. Forma de la solicitud: Bundle. Forma de la respuesta: VerificationVerdict. Este método es parte del contrato generado canónicamente y es consumido por herramientas y proyecciones de documentación posteriores.
Términos relacionados: evidence_provider