Introduction

WeaveOS is an AI workflow pricing and settlement platform. It gives your team real-time cost intelligence on every AI task before it runs, and immutable on-chain proof of every execution and payment after it completes.

What is WeaveOS?

Most AI products are priced before their costs are understood. Developers ship features, users push edge cases, and margin quietly disappears. WeaveOS solves this by making every AI workflow's economics visible and enforceable — before, during, and after execution.

The platform has three layers:

• Quotes — a pricing contract issued before execution. Define the price, the cost ceiling, and the success criteria the outcome must satisfy.
• Workflows — the execution unit. A workflow runs against a quote, tracks costs across all layers in real time, and validates the outcome against your defined criteria.
• Settlement — on-chain settlement via the Sui blockchain with outcome attestation stored on Walrus. Every completed workflow produces an immutable record of what ran, what it cost, and how payment was split.

How it works

The standard execution flow has four steps:

1. Create a workflow — call workflows.create() with a product ID, customer ID, and input payload. WeaveOS generates a quote and returns the upfront price.
2. Execute — your agent or pipeline runs. WeaveOS tracks model inference costs, tool call fees, compute overhead, and human-in-the-loop costs in real time as execution proceeds.
3. Validate — when execution completes, the outcome is evaluated against the success criteria defined in the quote. Criteria can be exact value matches, JSON schema assertions, numeric thresholds, or boolean compositions of the above.
4. Settle — costs are reconciled, payment splits are calculated, and the result is written to the Sui blockchain with a Walrus attestation blob. A dispute window opens; after it closes, the settlement is final.

Key concepts

Workflows

A workflow is the atomic unit of work in WeaveOS. It has a lifecycle: Quoted → Executing → Settled (or Disputed /Refunded). Workflow IDs follow the pattern wf_*. See Workflows.

Quotes

A quote is a pricing contract tied to a product and a set of success criteria. It specifies the pricing model (fixed, capped, success-fee, or hybrid), the quoted amount, and the conditions that define a successful outcome. Quote IDs follow the pattern qt_*. See Quotes & Pricing.

Success criteria

Success criteria are deterministic validators applied to the workflow's output. They determine whether the outcome counts as a success — which affects whether success-fee or hybrid pricing applies. See Success Criteria.

Settlement & attestation

Every settled workflow produces an on-chain record on the Sui blockchain. The execution trace and proof are stored as Walrus blobs. The settlement record includes the reconciled cost breakdown, payment splits, platform fee, and a cryptographic signature from the WeaveOS signer. See Settlement.

Environments

WeaveOS has two environments. Use test keys during development — no real charges are made and settlement calls are simulated.

API versioning

The current stable API version is v1. The version is expressed in the base path (/v1/). Breaking changes will be introduced under a new version path with advance notice and a deprecation window of at least 90 days.

Non-breaking additions — new optional fields, new event types, new endpoints — may be made at any time without a version bump.