The facilitator policy now refuses any authorization whose value differs from the requirements amount before settling (also on direct /settle). Agent purchases treat a lost race on the payments tx-hash unique index as 409 conflict, so one settlement never delivers twice. The MPP buy route fails fast if mppx does not expose the tempo/charge intent. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@settlekit/api
The SettleKit REST API — Hono on Node via @hono/node-server.
Real route modules per resource are mounted under /v1. Every handler calls the
real @settlekit/* domain services wired to the in-memory repositories those
packages ship, so the API runs end-to-end with no external infrastructure. When
DATABASE_URL is set, a drizzle Database handle is created via
@settlekit/database.
Layout
src/
server.ts createServer + serve (Node entrypoint)
app.ts Hono app: mounts routers, error handler
context.ts builds service singletons (real services + in-memory repos)
index.ts public exports
middleware/
auth.ts Bearer api-key auth (@settlekit/api-keys)
error.ts maps SettleKitError -> { error } with httpStatus
http/
respond.ts { data } / { error } envelope helpers
validate.ts zod body validation -> 400 SettleKitError
internal.ts Result unwrap helper
clients/ in-process GitHub / Discord / delivery clients
stores/ generic in-memory record store
routes/*.ts one router per resource
test/
app.test.ts app.request() end-to-end tests
Endpoints
Core commerce: products, prices, customers, checkout-sessions,
payments, subscriptions, entitlements, api-keys, license-keys,
files, webhooks.
Plan §26: GitHub (/v1/integrations/github/*, /v1/github/access/*), Discord
(/v1/integrations/discord/*, /v1/discord/access/*), SaaS (/v1/saas/*),
Bundles (/v1/bundles*), Delivery (/v1/delivery-runs*,
/v1/delivery-actions/test), Agent services (/v1/agent-services*), Escrow
(/v1/escrow/tasks*).
Auth
Every /v1/* route requires Authorization: Bearer <api-key>. Set
API_BOOTSTRAP_KEY to allow a static bootstrap key before any keys exist.
Responses
{ data: ... } on success; { error: { code, message, details? } } on failure
with the HTTP status taken from the SettleKitError.
Run
pnpm --filter @settlekit/api dev # tsx watch
pnpm --filter @settlekit/api build
pnpm --filter @settlekit/api start
pnpm --filter @settlekit/api test