requisition_receipt_verifier

verify_receipt.exs, the Elixir twin of the receipt verifier verify_receipt.py, as a Hex package. The receipt verifiers are released in the receipt-verification folder of HolyTrinity-Benchmark; the Requisition Offline Verifier and Requisition-Benchmark run verify_receipt.py. It checks a Requisition authority receipt offline: the Ed25519 signature under a key registry the relying party supplies, the key's status and signing window, and, when asked, the receipt's inclusion under a witnessed log checkpoint of Requisition's evaluation environment (CHECKPOINTS.md). The exit codes and every verdict are defined in VERDICTS.md.

It needs Elixir and OTP (it uses OTP's :json module) and nothing else: no other package, no network. It was tested with Elixir 1.18.4 and 1.19.2 on OTP 28.1.1, and Elixir 1.20.4 on OTP 29.1; other versions were not tested.

Use

# mix.exs
{:requisition_receipt_verifier, "== 0.1.0", runtime: false}
mix requisition_receipt_verifier.verify --receipt RECEIPT.json --registry REGISTRY.json

Or build the stand-alone command in this package's folder:

mix escript.build
./verify_receipt --receipt RECEIPT.json --registry REGISTRY.json

Both take the flags of verify_receipt.exs and give its output and exit code; both end the VM with that code.

Where the code comes from

lib/verify_receipt.ex, lib/log_checkpoint.ex and lib/requisition_receipt_verifier/cli.ex are derived mechanically from the scripts verify_receipt.exs and verify_receipt_checkpoint.exs; the first line after the licence header of each names its source and the source's SHA-256. The derivation removes the scripts' #! lines, moves the last-resort exception handler into RequisitionReceiptVerifier.CLI.main/1, replaces with a comment the one line that loaded verify_receipt_checkpoint.exs from a file (the package compiles it), and puts the scripts' modules under one namespace (SOURCES.md gives the details and the sources' SHA-256):

script module package module
Ed25519Strict RequisitionReceiptVerifier.Ed25519Strict
LogCheckpoint RequisitionReceiptVerifier.LogCheckpoint
VerifyReceipt RequisitionReceiptVerifier.VerifyReceipt

Licence

Apache License 2.0 (LICENSE, NOTICE). LICENSE here is the same text as the Requisition Offline Verifier's LICENSE, byte for byte: the package must carry its own copy, because a Hex package holds the files inside its own folder and no others.