Page cover

Data Storage Architecture

Acceso’s storage layer is built for read-heavy workloads. It also supports selective persistence and strict domain isolation.

Acceso does not store the full blockchain. It persists derived, indexed, and operational data needed for performance and reliability.

Storage goals (what the layer optimizes for)

  • Low-latency reads for API requests.

  • Strong consistency for identity, metering, and config.

  • Isolation between tenants and data domains.

  • Separate paths for transactional and analytical workloads.

  • Predictable lifecycle management and retention enforcement.

What we persist (and what we don’t)

Persisted:

  • Operational state: API keys, account metadata, configs, usage counters.

  • Derived indices: normalized views that speed up reads.

  • Aggregates and signals: metrics rollups and analytics outputs.

Not persisted:

  • A complete replica of chain state.

  • Raw upstream data that is not required for product behavior.

Storage planes

The system separates “serve requests” data from “analyze trends” data. This prevents analytical queries from starving transactional workloads.

Operational data backs authentication, authorization, and metering. It is optimized for small reads and writes with strict correctness.

Typical contents:

  • API keys and key status.

  • Account and plan metadata.

  • Quotas, counters, and enforcement state.

  • Configuration and feature flags.

Guarantees and expectations:

  • Strong consistency for write-followed-by-read workflows.

  • Low-latency reads and writes.

  • Strict access controls and auditable mutations.

Isolation and access boundaries

Isolation is enforced by design, not convention.

  • Identifiers are scoped to accounts and API keys.

  • Data domains are separated to prevent cross-contamination.

  • Access paths are constrained by backend authorization rules.

Operational notes (deep dive)
  • Prefer narrow, indexed reads on the request path.

  • Keep transactional schemas stable.

  • Treat analytical datasets as append-heavy and query-isolated.

  • Design retention as a first-class constraint, not an afterthought.

Last updated