Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lucid.foundation/llms.txt

Use this file to discover all available pages before exploring further.

​
Receipts

Every AI inference in Lucid generates a cryptographic receipt — an immutable proof that the computation happened.

​
What’s in a Receipt?

FieldDescription
idUnique receipt identifier
run_idThe inference run that generated this receipt
input_hashSHA-256 hash of the input
output_hashSHA-256 hash of the output
model_passportPassport ID of the model used
signatureEd25519 signature from session signer
mmr_positionPosition in the Merkle Mountain Range
epoch_idThe epoch this receipt belongs to

​
Create & Verify

// Receipts are created automatically during inference
// You can also create them manually:
const receipt = await lucid.receipts.create({
  runId: "run_abc123",
  inputHash: "sha256:...",
  outputHash: "sha256:...",
  modelPassport: "passport_xyz"
});

// Verify a receipt
const verification = await lucid.receipts.verify(receipt.id);
console.log("Valid:", verification.valid);
console.log("Signature verified:", verification.signatureValid);
console.log("MMR proof verified:", verification.proofValid);

​
Merkle Proof

Get the inclusion proof for a receipt: 
const proof = await lucid.receipts.proof(receiptId);
console.log("Root:", proof.root);
console.log("Path:", proof.path);
console.log("Position:", proof.position);

​
Verify by Hash

const result = await lucid.verify.byHash("sha256:abc123...");