<!-- DOCS_INDEX:two-call-reference -->
# Documentation

Canonical HTML: https://spoolis.com/docs. This page is also available in machine-readable Markdown.

Spoolis compiles transaction intent, applies agreed checks and economic rules, and issues a signed Outcome Receipt that records what was earned. Use it when another system or third party needs a portable economic result whose authenticity it can verify.

## Canonical receipt flow

A buyer pays for 100 enrichment records at $1.00 per accepted record. Spoolis verifies the delivery, accepts 98 records, rejects 2 with reasons, and signs an Outcome Receipt for $98.00 earned. The order is compile, verify, receipt, verifyReceipt, optional GET /api/receipts/{id}/status, then act on earned. Offline signature verification remains sufficient.

## Outcome Receipt

The public, portable artifact uses schema spoolis/outcome-receipt@1. Verify it with @spoolis/receipt-verifier and pinned receipt entries from https://spoolis.com/.well-known/spoolis-keys.json. The signed attestation is the lower-level in-band verdict underneath the receipt. Receipt validity is independent of payment authorization and settlement.

## Payment integration boundary

Spoolis determines earned value and signs the Outcome Receipt. A wallet, marketplace, payment system, or configured integration may verify and consume it, then act under its own authorization and settlement policy.

## Authentication

Create an spk_live_ API key after signing in at `/dashboard/api-keys`. The full key is shown once. Send it as `Authorization: Bearer spk_live_<key>`. Anyone can open and review a shared Spool. Accepting in production requires sign-in.

## Demo and production

The zero-login sandbox models acceptance and returns a demo-only signed attestation. Unitized sandbox verification also returns a demo Outcome Receipt with proportional earned value. Demo artifacts do not authorize production settlement or move real funds. The production API requires authentication, and Outcome Receipt issuance requires configured signing. Settlement is optional and runs on the configured settlement adapter.

## Links

[Quickstart](/docs/quickstart)

[Coding-agent quickstart](/docs/coding-agent-quickstart)

[API reference](/docs/api)

[MCP server](/docs/mcp)

[How verification works](/docs/verification)

[Outcome Receipt specification](/docs/outcome-receipt)

[Verify a receipt](/docs/verify-receipt)

[Payment paths](/docs/payment-paths)

[llms.txt](/llms.txt)

[llms-full.txt](/llms-full.txt)

[skill.md](/skill.md)
