caelum0x 05ece31dff feat(api): accept routed Solana fills on payment confirm
When the confirmed tx is the route provider's destination fill stored on the
session (session.route), the Solana Pay reference, payer and memo bindings
are dropped and the fill is bound by payTo, mint, amount and block time
(>= session creation - 120s), matching the checkout and worker verifiers.
Adds SettlementRequirements.routedFill to carry the flag to verifiers.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 20:59:58 +03:00
..

@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