Get started

Stateless audit attestation pack

Source

Verify a vitna.audit-pack.v1 document across all six cryptographic and governance layers, or assemble an inline audit pack from a vitna.stackfile.v1 payload in memory with no API key and zero retention.

text
POST /api/v1/audit-pack
bash
curl -X POST https://vitna.ai/api/v1/audit-pack \
  -H "content-type: application/json" \
  -d '{
    "mode": "verify",
    "pack": { ... },
    "trustedRecordPublicKey": "MCowBQYDK2VwAyEA...",
    "requirePackSignature": false,
    "failOnRollback": true,
    "maxMonthlyCostUsd": 5000
  }'

Modes

POST /api/v1/audit-pack operates in memory (Cache-Control: no-store) with two modes:

  1. Verify mode (verify, default when pack or a direct vitna.audit-pack.v1 body is posted): runs `verifyAuditPack` across canonical SHA-256 digest integrity, verbatim claims.citationBoundary preservation, outer Ed25519 packSignature verification, stackfileDigest + signed policy.json + vitna.lock.json lock invariants, RFC 6962 Witness observation Merkle proofs and signed daily roots, provider compliance term and evaluation digests, and optional CI governance gates (requirePackSignature, requireAttestedPrices, failOnRollback, maxMonthlyCostUsd).
  2. Assemble mode (assemble, when stackfile is posted): validates an inline vitna.stackfile.v1 alongside optional policyText, policyLock, ledgerRows, evidence, terms, monthlyRuns, and discoverPeers, evaluates rollout watchdog and compound pipeline BOMs against Witness rates, and returns an unsigned vitna.audit-pack.v1 stamped with its canonical SHA-256 digest.

Payloads and pinned keys are never persisted. Also exposed to MCP clients as vitna_verify_audit_pack on `POST /api/v1/mcp`.

Verification response shape

json
{
  "mode": "verify",
  "ok": true,
  "verdict": "verified",
  "orgId": "convexity",
  "generatedAt": "2026-11-06T00:00:00.000Z",
  "digest": "4f3b9a8e01c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8",
  "checks": {
    "envelope": {
      "schemaValid": true,
      "digestMatch": true,
      "citationBoundaryIntact": true
    },
    "packSignature": {
      "present": true,
      "verified": true,
      "signerPublicKey": "MCowBQYDK2VwAyEA...",
      "pinnedKeyMatched": true
    },
    "stackfileAndPolicy": {
      "stackfilePresent": true,
      "stackfileDigestMatch": true,
      "policyPresent": true,
      "policyVerified": true,
      "lockPresent": true,
      "lockVerified": true
    },
    "witnessPriceAttestations": {
      "totalProofs": 4,
      "attestedProofs": 4,
      "unattestedProofs": 0,
      "verifiedProofIds": ["101", "102", "103", "104"],
      "pinnedRecordKeyUsed": true
    },
    "evidenceAndTerms": {
      "providerTermCount": 4,
      "customerEvidenceCount": 2
    },
    "governanceGates": {
      "watchdogVerdict": "healthy",
      "totalEstimatedMonthlySpendUsd": 1220
    }
  },
  "failures": [],
  "warnings": [],
  "privacy": "Evaluated in memory with zero retention; audit attestation packs, inline Stackfiles, policy envelopes, ledger rows, and pinned public keys are never stored.",
  "meta": {
    "generatedAt": "2026-11-06T00:00:00.000Z",
    "mode": "verify",
    "verdict": "verified"
  }
}