Integration Surfaces
Living maturity for every Stratum surface. Do not assume a capability is public beyond what this matrix marks Live.
The unit of record is multi-party shared ledger state that no single party controls — who owns what, when it settled, which rules apply. The HTTP contract documented here is the stable interoperability surface; ledger applications evolve behind it. Partners call public token and ingest gateways with dashboard-minted keys. See Disclosure Boundary.
Matrix
| Surface | Purpose | Maturity | Access / note |
|---|---|---|---|
| Developer Docs (this site) | Contract — routes, envelopes, vocabulary | Live (Docs v0 · Early Access) | Public |
| Token gateway | Partner wallet ops | Live | Dashboard-minted X-Api-Key — Tokens (Configuration) |
| Webhook ingest gateway | Write arbitrary JSON to a network | Live | Marketplace Addon — Webhook ingest |
| Node HTTP token shapes | Same wallet shapes behind the token gateway, kept for reference | Live | API reference → Configuration → "Tokens — node reference (advanced)" |
| Generic / NFT configuration | Ledger-application configuration guides | Roadmap / Not yet public | Generic, Non-fungible Token |
OpenAPI (/openapi.yaml) | Typed client generation | Live | Public artifact — generate clients; no first-party SDK required |
| Dashboard / BFF | Operator provisioning and network UI | Live | Signed-in operators |
| Ingestion / operator API keys | Mint keys and operator auth docs | Live (gated) | Dashboard → Developer API docs |
| Day-2 Network Ops | Shared space create/join/status and ledger-application lifecycle | Live (gated) | Overview: Networks → Network Ops. Samples: signed-in Network admin docs |
| Product Concierge MCP | Public product Q&A for agents (Claude, Cursor, CLI) | Live | No API key — Concierge. Disclosure-boundary content only |
| Authenticated data MCP | Agent tools over customer ledger data | Not yet public | Will use the same data model as the REST API once released |
| First-party SDKs | Vendor-maintained language packs | Not planned | Generate typed clients from the published OpenAPI — no proprietary SDK to wait on or lock into |
| CLI | Partner/ops + product chat (@blockskunk/cli) | Roadmap / Early Access | npx @blockskunk/cli chat --product stratum |
Guidance
- Start here for vocabulary: Networks, Authentication, Tokens, Errors.
- Call the ingest (Marketplace Addon) or token gateway URL from your dashboard API key.
- Live try-it is disabled on this portal — keys must not enter the docs origin.
- Generate typed clients from the published OpenAPI (
npm run generate:openapi-client+openapi-fetch); seedocs/themes/protocol-ts/examples/typed-gateway-client.ts. Do not wait for a first-party SDK. - Day-2 Network Ops stay signed-in only — not on the public OpenAPI.
- Use Product Concierge MCP for product learning; do not assume authenticated data MCP until this matrix marks it Live.
- Respect the Disclosure Boundary when forwarding pages externally.