"$schema": "http://json-schema.org/draft-04/schema"
"$id": "https://nix.dev/manual/nix/latest/protocols/json/schema/build-trace-entry-v2.json"
title: Build Trace Entry
description: |
  A record of a successful build outcome for a specific derivation output.

  This schema describes the JSON representation of a [build trace entry](@docroot@/store/build-trace.md) entry.

  > **Warning**
  >
  > This JSON format is currently
  > [**experimental**](@docroot@/development/experimental-features.md#xp-feature-ca-derivations)
  > and subject to change.

  Verision history:

  - Version 1: Original format

  - Version 2: Remove `dependentRealisations`

type: object
required:
  - id
  - outPath
  - signatures
properties:
  id:
    type: string
    title: Derivation Output ID
    pattern: "^sha256:[0-9a-f]{64}![a-zA-Z_][a-zA-Z0-9_-]*$"
    description: |
      Unique identifier for the derivation output that was built.

      Format: `{hash-quotient-drv}!{output-name}`

      - **hash-quotient-drv**: SHA-256 [hash of the quotient derivation](@docroot@/store/derivation/outputs/input-address.md#hash-quotient-drv).
        Begins with `sha256:`.

      - **output-name**: Name of the specific output (e.g., "out", "dev", "doc")

      Example: `"sha256:ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad!foo"`

  outPath:
    "$ref": "store-path-v1.yaml"
    title: Output Store Path
    description: |
      The path to the store object that resulted from building this derivation for the given output name.

  signatures:
    type: array
    title: Build Signatures
    description: |
      A set of cryptographic signatures attesting to the authenticity of this build trace entry.
    items:
      type: string
      title: Signature
      description: A single cryptographic signature

additionalProperties:
  dependentRealisations:
    description: deprecated field
    type: object