---
type: Attested Computation
title: attest
identifier: receipt/attest
description: 'Attest a fragletc run receipt (fraglet-receipt/2) the way OKF''s Attested Computation attester does -- deterministic, no re-execution -- and report RESULT: ATTESTED or RESULT: REJECTED with every reason. Checks that the computation that ran is the sanctioned script (procedure_hash equals sha256 of the computation file, or the expected hash), that the receipt is internally consistent (memo_key recomputes from its own procedure_hash, params, and inputs under fragletc''s documented formula, so an edited params field fails), that any claimed params match, that the run succeeded, and that an artifact claimed to be an output of the run hashes to what the receipt recorded.'
pack: receipt
tags:
- engineering
- computation
runtime: fragletc
image: ofthemachine/python3@sha256:a015b4f9f0e7c1648f8fcd4164f6a296dd3c9189404f88f333a9764d08d13522
network: none
stdin: none
execution_class: hermetic
procedure_hash: sha256:56852e30c550552fe93d3bd3c0f8e4a894eee079b7d19ecb18e9e015d3b43a73
parameters:
- name: receipt
  type: file
  required: true
  description: The fragletc --receipt JSON to attest
- name: computation
  type: file
  required: false
  description: The sanctioned script the run must have executed (its sha256 must equal the receipt's procedure_hash)
- name: procedure_hash
  type: string
  required: false
  description: Expected procedure_hash (sha256:<hex>), for when the script file is not at hand
- name: params
  type: string
  required: false
  description: Claimed parameters as key=value pairs separated by |, e.g. location=Edmonton|day=0; each must match the receipt exactly
- name: artifact
  type: file
  required: false
  description: A file claimed to be one of the run's outputs (a figure, a document); its sha256 must appear in the receipt's outputs
- name: artifact_name
  type: string
  required: false
  description: Which declared output the artifact claims to be (a relpath under /output); omitted, any output may match
computation: https://tools.ofthemachine.com/receipt/attest.py
executor:
  resource: https://github.com/ofthemachine/fraglet
  receipt:
  - schema
  - fragletc
  - procedure
  - procedure_hash
  - image
  - image_digest
  - network
  - stdin_mode
  - params
  - inputs
  - argv
  - env
  - memo_key
  - started
  - finished
  - exit_code
  - stdout
  - outputs
  format: fraglet-receipt/2 (fragletc --receipt <path>, or FRAGLETC_RECEIPT_DIR)
attester:
  resource: https://tools.ofthemachine.com/receipt/attest.py
  method: 'deterministic, no re-execution: procedure_hash equals sha256 of computation; memo_key recomputes from the receipt''s own fields; claimed params and any artifact hash match the receipt'
generated:
  by: process:tools/catalog/compile.py
  at: '2026-11-13T18:27:40Z'
---

# attest

Attest a fragletc run receipt (fraglet-receipt/2) the way OKF's Attested Computation attester does -- deterministic, no re-execution -- and report RESULT: ATTESTED or RESULT: REJECTED with every reason. Checks that the computation that ran is the sanctioned script (procedure_hash equals sha256 of the computation file, or the expected hash), that the receipt is internally consistent (memo_key recomputes from its own procedure_hash, params, and inputs under fragletc's documented formula, so an edited params field fails), that any claimed params match, that the run succeeded, and that an artifact claimed to be an output of the run hashes to what the receipt recorded.

Use when a result (a number, a phrase, an image) claims to have come from a tool run and you need to confirm the run was the sanctioned script with those parameters, or when checking the receipts bundled with a published document, image, or poem.

# Schema

## Parameters
- `receipt` (file, required) — The fragletc --receipt JSON to attest
- `computation` (file, optional) — The sanctioned script the run must have executed (its sha256 must equal the receipt's procedure_hash)
- `procedure_hash` (string, optional) — Expected procedure_hash (sha256:<hex>), for when the script file is not at hand
- `params` (string, optional) — Claimed parameters as key=value pairs separated by |, e.g. location=Edmonton|day=0; each must match the receipt exactly
- `artifact` (file, optional) — A file claimed to be one of the run's outputs (a figure, a document); its sha256 must appear in the receipt's outputs
- `artifact_name` (string, optional) — Which declared output the artifact claims to be (a relpath under /output); omitted, any output may match

## Outputs
- stdout (the anonymous result)

# Execution

The computation is [`receipt/attest.py`](https://tools.ofthemachine.com/receipt/attest.py) (frontmatter `computation`; in `tools.tar.gz` the same file sits at `receipt/attest.py` beside this bundle), run by `fragletc` in `ofthemachine/python3@sha256:a015b4f9f0e7c1648f8fcd4164f6a296dd3c9189404f88f333a9764d08d13522` with network `none`. Its identity is `procedure_hash` = sha256 of that file, shebang included — the same value every receipt records. Parameters are passed as `-p name=value`; `--receipt run.json` (or `FRAGLETC_RECEIPT_DIR`) writes the receipt, a `fraglet-receipt/2` JSON document with the fields listed under `executor.receipt`.

# Attestation

A run's receipt is attested with [`receipt/attest.py`](https://tools.ofthemachine.com/receipt/attest.py): the computation that ran is this script (`procedure_hash`), the receipt is internally consistent (`memo_key` recomputes from its own fields), the claimed parameters are the ones that ran, and an artifact claimed as an output hashes to what the receipt recorded. No re-execution: attestation is provenance fidelity, not reproduction.

Hermetic: no network, so `memo_key` also fully determines the outputs — a re-run with the same inputs must reproduce them, which makes results from this tool safely memoizable.

Skill: [SKILL.md](https://tools.ofthemachine.com/receipt/SKILL.md)
