Skip to content
HALOWERK

File Formats and Conversion

receipt complete verification blocks

File verification returns the number of entire aligned checksum blocks ready for hashing. Use it when an agent needs which parts can undergo independent integrity verification.

POST https://format.halowerk.com/v1/receipt-complete-verification-blocks

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
sizeintegerYes
rangesarrayYes
block_bytesintegerYes
Show full input schema
{
  "type": "object",
  "properties": {
    "size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1099511627776
    },
    "ranges": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {
          "type": "integer",
          "minimum": 0,
          "maximum": 1099511627775
        },
        "maxItems": 2,
        "minItems": 2
      },
      "maxItems": 300,
      "minItems": 0
    },
    "block_bytes": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1099511627776
    }
  },
  "required": [
    "size",
    "ranges",
    "block_bytes"
  ],
  "additionalProperties": false
}

Open original schema

Published input example

{
  "size": 2501504,
  "ranges": [
    [
      0,
      127
    ],
    [
      256,
      383
    ],
    [
      64,
      191
    ]
  ],
  "block_bytes": 128
}

Result & documentation

Show published result schema
{
  "type": "object",
  "required": [
    "measured_at",
    "source",
    "data",
    "limitations"
  ],
  "properties": {
    "measured_at": {
      "type": "string"
    },
    "source": {
      "type": "object",
      "required": [
        "reference",
        "retrieved_at"
      ],
      "properties": {
        "reference": {
          "type": "string"
        },
        "retrieved_at": {
          "type": "string"
        }
      }
    },
    "data": {
      "type": "object",
      "properties": {
        "complete_blocks": {
          "type": "integer"
        },
        "total_blocks": {
          "type": "integer"
        },
        "ready_block_intervals": {
          "type": "array",
          "items": {
            "type": "array",
            "items": {
              "type": "integer"
            }
          }
        }
      },
      "required": [
        "complete_blocks",
        "total_blocks",
        "ready_block_intervals"
      ]
    },
    "limitations": {
      "type": "string"
    }
  }
}

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-20 UTC.

More endpoints in this hub

All endpoints in this hub โ†’