StateSet API Docs

The sequencer orders events, commits them to Merkle roots, and anchors those commitments so anyone can verify inclusion without trusting it. This gets one running and walks a single event through.

Run it

docker-compose up -d

curl http://localhost:8080/health     # process up
curl http://localhost:8080/ready      # + database connectivity

Authentication is Authorization: ApiKey <key>. A bootstrap admin key exists for local development:

curl -H "Authorization: ApiKey dev_admin_key" \
  "http://localhost:8080/api/v1/head?tenant_id=<uuid>&store_id=<uuid>"

dev_admin_key is a development bootstrap credential. Replace it before anything reachable from outside your machine.

1. Register an agent key

Events are signed, so the sequencer needs the agent’s public key first.

curl -X POST http://localhost:8080/api/v1/agents/register \
  -H "Authorization: ApiKey $SEQ_API_KEY" \
  -H 'content-type: application/json' \
  -d '{ … }'

Keys are registered with proof of possession — the agent demonstrates it holds the private key rather than merely asserting a public one. See /api/v1/agents/keys.

2. Ingest an event

curl -X POST http://localhost:8080/api/v1/events/ingest \
  -H "Authorization: ApiKey $SEQ_API_KEY" \
  -H 'content-type: application/json' \
  -d '{ … }'

The event gets a sequence number in its stream, and its leaf enters the next batch.

3. Read the head

curl -H "Authorization: ApiKey $SEQ_API_KEY" \
  "http://localhost:8080/api/v1/head?tenant_id=$TENANT&store_id=$STORE"

head is the current sequence position for that tenant and store — how you know whether your event landed.

4. Get the commitment and an inclusion proof

curl -H "Authorization: ApiKey $SEQ_API_KEY" \
  http://localhost:8080/api/v1/commitments/$BATCH_ID

That returns the batch’s events_root, state roots, and sequence range. To verify an individual event, pair it with an inclusion proof from the gRPC v2 service (GetInclusionProof) and recompute the root locally.

Recompute against the root read from the chain, not the one this API returns. Comparing an API-supplied root to an API-supplied proof verifies nothing — the on-chain value is what makes it trust-minimised. Full walkthrough: verification example.

5. Anchor

curl -X POST http://localhost:8080/api/v1/anchor \
  -H "Authorization: ApiKey $SEQ_API_KEY"

curl -H "Authorization: ApiKey $SEQ_API_KEY" \
  http://localhost:8080/api/v1/anchor/status

Anchoring submits the commitment to Set L2. Until it lands, you have a sequenced event; after, you have a verifiable one.

Run the full demo

./scripts/run_demo.sh        # or run_e2e_demo.sh

Sequencer overview

What VES is and why it exists.

Architecture deep dive

Every component in detail.

Operations

Running it in production.

Verification

Prove inclusion yourself.

Last modified on August 29, 2026

Get started

Platform

Using the APIs

StateSet Response

StateSet ResponseCX

Temporal Engine

StateSet iCommerce Engine

StateSet iCommerce EDI Engine

StateSet Mail

StateSet iCommerce Voice Engine

StateSet iCommerce NSR Engine

AI Agents

StateSet Agents

StateSet iCommerce Sandbox Engine

StateSet ACP

StateSet UCP

StateSet ICP

StateSet Sequencer

StateSet Set L2

StateSet Cloud

Apps & Consoles

Tools

Sequencer Quickstart

Run it

1. Register an agent key

2. Ingest an event

3. Read the head

4. Get the commitment and an inclusion proof

5. Anchor

Run the full demo

Next

Sequencer overview

Architecture deep dive

Operations

Verification

​Run it

​1. Register an agent key

​2. Ingest an event

​3. Read the head

​4. Get the commitment and an inclusion proof

​5. Anchor

​Run the full demo

​Next

Sequencer overview

Architecture deep dive

Operations

Verification

Run it

1. Register an agent key

2. Ingest an event

3. Read the head

4. Get the commitment and an inclusion proof

5. Anchor

Run the full demo

Next