docimprint

Glossary

Definitions for verifiable document memory, evidence bundles, x402, and agent integration terms.

What is an evidence bundle?

An evidence bundle is the tamper-evident output of POST /v1/extract: a bundle_id, manifest.json with SHA-256 artifact hashes, EIP-191 signature, and stored artifacts (screenshot, PDF, Markdown, OCR). Verify free via GET /v1/extract/{id}/verify.

What is verifiable document memory?

Verifiable document memory is a persistent layer where AI agents store cryptographically signed document captures — not embeddings alone. Each capture includes manifest hashes, optional Merkle citation proofs, and chain-of-custody metadata.

What is x402 in DocImprint?

x402 is HTTP 402 Payment Required with USDC micropayments on Base. Agents pay $0.010–$0.075 per API call without accounts — wallet address becomes bundle owner identity.

Verifiable document memory
Persistent, cryptographically auditable document storage for AI agents — evidence bundles with signed manifests, not just embeddings.
Evidence bundle
Tamper-evident package of document artifacts (Markdown, screenshot, PDF, OCR) with a signed manifest.json and bundle_id (ev_…).
manifest_sha256
SHA-256 hash of the canonical manifest.json; anchor for integrity verification and notarization.
x402
HTTP 402 Payment Required protocol for micropayments; DocImprint accepts signed USDC transfers on Base via payment-signature header.
X-Wallet-Address
HTTP header identifying the x402 payer on owner-scoped routes; required when not using API key auth.
MCP
Model Context Protocol — DocImprint exposes document tools at /mcp for Claude, Cursor, and agent frameworks.
Agent card
A2A discovery document at /.well-known/agent.json listing capabilities, pricing, and auth protocols.
Matter corpus
Wallet-scoped document collection — indexed evidence bundles with semantic search and cross-document ask.
Claim-check
Extract mode that verifies each claim against source text: supported, contradicted, or not_found.
Lean response
Extract with store=false — analysis without persisting a bundle (no bundle_id).
Notarization
On-chain anchor of manifest hash on Base L2 via POST /v1/extract/:id/notarize.
Merkle citation proof
POST verify-citation returns proof[] showing quoted text exists in the bundle chunk tree.
Chain of custody
Provenance logs, agent handoffs, and version history for audit trails.
BYOS extraction
Bring Your Own Schema — extract-structured mode returns typed JSON matching your schema with citations.
Agent envelope
Compact API response shape: success, mode, metadata, artifacts, provenance, result.
WALLET_REQUIRED
401 error when owner-scoped route lacks wallet or API key identity.
QUOTA_EXCEEDED
402/403 when API key monthly credits are exhausted.
Deep verify
GET /v1/extract/:id/verify re-hashes all artifacts; free, no payment.
Async job
POST /v1/extract with store=true defaults to 202 + job_id; ?sync=true opts into synchronous 200. Poll GET /v1/jobs/:id.
Monitor
Scheduled URL checks with diff mode and webhook notifications on change.
Spatial OCR
Tables and forms extracted as Markdown preserving layout.
Idempotency-Key
Header for replay-safe bundle creation with same owner and key.
DEV_PAYER
Mock x402 wallet address used in staging smoke tests (non-production).
SKILL.md
Agent onboarding document at GET /SKILL.md with endpoint decision tree.
OpenAPI
Machine-readable API spec at /openapi.json for SDK and tool generation.
Base L2
Coinbase Layer-2 network used for USDC settlement and notarization in production.
EIP-191 signature
Ethereum signed message format used to sign manifest_sha256 with published keys.
Retention
Bundle expiry policy (e.g. 90d); legal hold overrides GC.
Compare mode
Extract mode diffing current capture against previous_bundle_id.
Citation
Pointer to source passage — quote, chunk_id, paragraphs, confidence level.
API key
Bearer dr_live_… token for subscription billing without x402 wallet flows.
Focused endpoint
Shortcut routes like /v1/summarize and /v1/qa for lean single-purpose calls; API keys are billed per credit table.
Webhook
HTTPS callback URL receiving POST manifest on async job completion.
Document intelligence
Category term for AI-native extraction, analysis, and verification of documents.
High-stakes documents
Contracts, filings, papers, invoices — workflows requiring provable capture.
Offline verification
Verify bundle integrity using downloaded ZIP (manifest.json + signature.json) and GET /v1/keys without API trust.
Parent bundle
parent_bundle_id links a new capture to a prior version in the chain.
Handoff
POST /v1/extract/:id/handoff records agent-to-agent transfer with optional note.
Collection ask
RAG-style Q&A across indexed bundles in a matter corpus with cited sources.

Related