> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reducto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Check protocol

This page is a reference for security reviews and network teams. You do not need it to set up the package. [License checks](https://docs.reducto.ai/office/licensing/checks.md) has the rules that matter for your application.

## Timing

* A check or usage report that gets no answer within 5 seconds counts as no answer.
* After a failed check, the package tries again after about 30 seconds, then about every 5 minutes, until a check succeeds.
* A process makes one check to start, and one more within 30 seconds of each new Session, to confirm its usage report. A save, a reopen that joins its Session, and the process exit send no check of their own unless usage counts are still unsent.
* In a browser page, the editor, the viewer and the layout engine check on their own. The editor starts a new layout engine for each document it opens, and that engine makes its own checks. A reopen that joins its Session is not billed again.

## Queued usage reports

A new Session's report must reach Reducto within 30 seconds of the first check that Reducto answers. The package sends it at once and, if the send fails, retries sooner than its usual backoff. Until a check confirms it, each call throws `undelivered`, and the package retries every 30 seconds.

In a browser, `engine.wasm` also throws `undelivered` once 200 new Sessions wait for confirmation. It runs again when a check confirms them.

## License check

`POST /-/license`:

```json theme={null}
{
  "id": "<license id>",
  "package": "@reductoai/docx",
  "version": "1.4.0",
  "instance": "<random id, new for each process, page load or document the editor opens>",
  "nonce": "<random value>",
  "counters": { "document.open": 3, "editor.open": 1 }
}
```

`counters` are usage counts since the last check: `document.open`, `document.parse`, `editor.open`, `viewer.open`, `editor.command.<name>` and `telemetry.dropped`.

## Usage reports

`POST /-/events`, in batches of up to 100 events, a few seconds after activity:

```json theme={null}
{
  "id": "<license id>",
  "package": "@reductoai/docx",
  "version": "1.4.0",
  "instance": "<random id>",
  "seq": 12,
  "chain": "<hash of the earlier batches>",
  "certificate": { "signed": "…", "sig": "…", "kid": "…" },
  "events": [
    {
      "event": "office_session_started",
      "license_id": "<license id>",
      "session_id": "s_<random>",
      "file_type": "docx",
      "surface": "browser",
      "package": "@reductoai/docx",
      "version": "1.4.0",
      "occurred_at": "2026-11-10T21:30:00.000Z",
      "nonce": "<random value>"
    },
    {
      "event": "document_operation",
      "license_id": "<license id>",
      "session_id": "s_<random>",
      "operation": "insertText",
      "success": true,
      "error_kind": null,
      "duration_ms": 4,
      "file_type": "docx",
      "surface": "browser",
      "occurred_at": "2026-11-10T21:30:02.000Z"
    }
  ]
}
```

`seq`, `chain`, `nonce` and `certificate` let Reducto find lost and repeated reports. They are random or signed values and contain no data about you.

## Signatures

Reducto signs each license answer with Ed25519.
