Enterprise OData Services for the Cardano Blockchain

Funded by Cardano Catalyst Fund 14 — all four milestones completed and approved (April 2026).

ODATANO is an SAP CAP–based service that exposes the Cardano blockchain via a standardized OData V4 interface, enabling enterprise-grade read and write access with native transaction building.

Quick Start

As CAP Plugin (recommended)

Add ODATANO to any existing SAP CAP project:

npm install @odatano/core @cap-js/sqlite

{
  "cds": {
    "requires": {
      "db": { "kind": "sqlite" },
      "odatano-core": {
        "network": "preview",
        "backends": ["blockfrost"],
        "blockfrostApiKey": "preview_your_api_key_here",
        "blockfrostCustomBackend": "",
        "txBuilders": ["buildooor"]
      }
    }
  }
}

cds deploy --to sqlite 
cds serve

Self-hosted Blockfrost-compatible node? (Dolos MiniBF, Demeter Self-Hosted) Set blockfrostCustomBackend to the node's base URL (e.g. http://localhost:3010/api/v0). When set, blockfrostApiKey becomes optional. See the Backend Configuration Guide.

Standalone

Run ODATANO as a self-contained service (no host CAP project needed):

git clone https://github.com/ODATANO/ODATANO && cd ODATANO
npm ci
cp .env.example .env   # set BLOCKFROST_API_KEY, NETWORK, BACKENDS
cds deploy --to sqlite
cds serve

Or with Docker:

docker-compose up -d

Service available at http://localhost:4004. See Quick Start Guide for full details.

Dev Mode: Mocked Authentication

Heads-up. cds serve uses CAP's mocked auth: @requires: 'authenticated-user' accepts any Basic-Auth header against a mock user (alice, bob, …) — passwords are not checked. Anonymous requests get 401, but anyone reaching the port can authenticate.

Production needs the [production] profile (NODE_ENV=production), which switches to auth: xsuaa. Don't expose a dev-mode instance. See the Security Guide.

Documentation

| Guide | Description | |-------|-------------| | Quick Start | Get running in 5 minutes | | User Guide | API usage, entities, and examples | | Developer Guide | Architecture and development | | Transaction Workflow | Build → Sign → Submit flow | | Security Guide | Authentication, signing security, HSM | | Docker Deployment | Container deployment |

License

Apache License 2.0 - see LICENSE

Support

• Issues: GitHub Issues
• Project Lead: Max Weber ([email protected])