DSM Architecture Overview
The Data Sharing Model (DSM) is the core distributed trust infrastructure that powers Raytio's data sharing capabilities. It provides the foundation for secure, multi-party data exchange where individuals control their own data and selectively share it with organisations through cryptographically-protected channels.
How the schema is organised
The DSM spans approximately 30 tables, grouped into logical layers:
| Layer | What it covers |
|---|---|
| Foundation | JSON schema definitions, hash-to-value mappings, short links, device fingerprints, and temporary verification data |
| Node | Profile data nodes and temporary staging nodes |
| Access application | Application definitions, encryption key pairs, authorised user lists, state transitions, short links, and outgoing invitations |
| Instance | Sharing instances, node-to-node relationships, instance-node bindings, field-level encryption keys, on-sharing chains, and approval transactions |
| Supporting | Public profiles, transaction ledgers, audit events, and schema badges |
Entity relationships at a glance
How the DSM connects to the rest of the platform
The DSM does not operate in isolation:
- Authentication — every ownership and audit column references the authentication system. Row-level security policies use the authenticated user's identity and tenant to filter all queries.
- Foundation services — tenants, background jobs, permissions, and lookups provide infrastructure that the DSM builds on.
- API layer — every DSM table has corresponding views that form the API surface. These views enforce additional access controls and present data in the shape consumers expect.
- Async workers — background job records created by DSM triggers are processed by external workers that handle operations like notification delivery, webhook processing, and state change propagation.
For more detail on specific areas of the DSM, see the other pages in this section.