StateSet API Docs

iCommerce runs commerce state and transitions inside your application. The default backend is SQLite: a local file or isolated in-memory store. Optional PostgreSQL uses an external server. Embedded operation does not need a hosted StateSet account, API key, or model.

Reviewed October 20, 2026 against stateset-icommerce source b8597997, release line 1.39.0. Node and CLI examples use published 1.39.0 packages. Working-tree invoice/payment retry changes were still under development during review; they are not established as part of the published binary merely because the checkout version remains 1.39.0.

Choose the interface

Interface	Purpose	Write boundary
Native Rust/Node/Python	Application-owned commerce accessors	Calling a mutation writes; no CLI `--apply` gate
Governed native commands	Typed policy-checked execution	Operator identity/policy, explicit mode, durable receipts
CLI and MCP	Agent-facing discovery and workflows	Preview/apply controls; strict endpoints restrict write commands
Rust `stateset-http`	Self-hosted commerce REST/SSE	HTTP auth/authz, deployment configuration, retry receipts
Messaging gateway	Channel sessions, agent routing and operational endpoints	Separate gateway configuration and permissions

These are different contracts. HTTP DTO names, native camelCase methods, snake_case kernel envelopes, and MCP tool names are not interchangeable.

Create local commerce state

Start with the complete quickstart for installation, exact-money assertions, and a second-process read. Commerce.open() opens and migrates off the JavaScript event loop; new Commerce() performs setup synchronously. Close the engine after outstanding work finishes.

import { Commerce } from '@stateset/embedded';
const commerce = await Commerce.open('./store.db');
try {
  const orders = await commerce.orders.list();
  console.log(orders.length);
} finally {
  await commerce.close();
}

A file path determines the local store. :memory: is temporary; another process cannot reopen its contents. PostgreSQL, domain availability, and connection setup vary by binding; check the installed interface and isSupported() where provided.

Exact money and real effects

Use Node createExact methods and decimal-string outputs such as totalAmountExact and amountExact. Compatibility numeric fields remain; do not accumulate them for settlement. See binding precision. An order, local payment/refund, shipped status, physical stock posting, provider settlement, and external carrier handoff are separate outcomes. In 1.39, inventory.fulfillOrderStock() provides an explicit retry-safe full-shipment stock posting. See stock fulfillment.

Govern autonomous writes

Direct accessors are application primitives; they do not automatically attach a principal, policy decision, or governed receipt. Use governed execution for autonomous authority, expected versions, exact budgets and same-key replay. Domain outbox facts have transaction-bound coverage for implemented mutations; the general audit_log helper is opt-in/best-effort. Do not infer universal audit coverage. Use native simulations to test conditional scenarios in private stores. Use verified snapshots for recovery. Neither a local test nor source feature availability establishes production soak, independent security review, or external provider acceptance.

Last modified on October 20, 2026

Get started

Build your first integration

Operate and improve

Resources and support

Platform

Using the APIs

StateSet Response

StateSet ResponseCX

Temporal Engine

StateSet iCommerce Engine

StateSet Warehouse (WMS)

StateSet Freight (TMS)

StateSet EDI

StateSet Mail

StateSet iCommerce Voice Engine

StateSet iCommerce NSR Engine

AI Agents

StateSet Agents

StateSet Sandbox

StateSet ACP

StateSet UCP

StateSet ICP

StateSet Sequencer

StateSet Set L2

StateSet Cloud

Apps & Consoles

Tools

The Embedded iCommerce Engine

Choose the interface

Create local commerce state

Exact money and real effects

Govern autonomous writes

​Choose the interface

​Create local commerce state

​Exact money and real effects

​Govern autonomous writes

Choose the interface

Create local commerce state

Exact money and real effects

Govern autonomous writes