Data Model

The backend data model is designed to support wallet authentication, payment indexing, proof generation, issuer management, verification, and auditability.

​

Core Entities

​

Payment Classification

Payments can be classified as:

• income,
• reimbursement,
• personal transfer,
• unknown,
• excluded.

Proof evaluators should use eligible income payments unless a proof type explicitly allows another source.

​

Proof Status

Proof records can be:

• active,
• expired,
• revoked,
• invalid.

​

Audit Events

Audit logs should capture:

• authentication verification,
• payment classification changes,
• proof creation,
• proof revocation,
• issuer approval,
• issuer suspension,
• API key creation,
• webhook changes,
• admin configuration changes.

Audit logs should not include raw signatures, exact income values, full credentials, API keys, or webhook secrets.