Technical Paper

Component inventory

1.2 Component inventory

This inventory lists protocol component responsibilities and the contracts they expose.

ComponentResponsibilityPublic contract
Client applicationReceipt capture, wallet signature, user previewUser signing happens device-side; uploads start from explicit user action
API surfaceIdentity, upload orchestration, pipeline start, status queriesStable REST/SDK surface; stage statuses and error categories
Receipt processing pipelineConvert image/PDF input into a structured receipt recordTyped intermediate outputs, validation state, canonical product and merchant references
Trust layerProduce reward eligibility from receipt and user signalsPublic bands, decision categories, and calibration managed in internal operations
Ledger and reward accountingHold bINT/ePoints events as an immutable accounting streamAppend-only event model, auditable settlement records
Data-product layerProduce anonymized aggregates from receipt observationsPersonal-data separation, k-thresholds, versioned aggregate outputs
On-chain programsToken state, staking, treasury routing, and cryptographic commitmentsAuditable program interfaces and published program addresses
Operational control planeMonitoring, quotas, provider routing, incident responsePublic status summary; runbooks, thresholds, and routing details remain private

This separation matters for security: the public document makes the architecture auditable while infrastructure combinations, thresholds, and response steps are managed in internal operations.