REST API

One HTTP call away from a sealed witness.

OpenAPI-described, language-agnostic, every framework. Three endpoints cover the full propose → sign → finalize cycle. SDKs auto-generated from the same spec.

API reference Get credentials

Endpoints

The three core endpoints.

POST/v5/contracts/{addr}/witnesses/proposeOpen a witness intent. Returns intentId + signing payload.

POST/v5/contracts/{addr}/witnesses/{id}/signSubmit a signature from a delegated key.

POST/v5/contracts/{addr}/witnesses/{id}/finalizeSeal on-chain when signatures are complete.

Production realities

Built for the edge cases.

Idempotency keys

Every write accepts an Idempotency-Key header. Retries are safe by construction.

Webhooks

Subscribe to state changes: pending, signed, sealed, failed. Signed payloads, replay protection.

Predictable errors

RFC 9457 problem details. Stable error labels. Status-code-driven UX in the SDK.

From OpenAPI

Generate your own client.

The same OpenAPI 3.1 spec drives our TypeScript SDK and will drive Python, Go and Java. Generate your own client from it, or wait for the native release.

openapi-generator-cli generate \
  -i https://api.witniumchain.com/openapi.yaml \
  -g typescript-fetch \
  -o ./src/lib/witnium-client