Supporting infrastructure

Infrastructure Documentation

SwiftAPI Authority is the cryptographic infrastructure developed by SwiftAPI Labs to issue, verify, revoke, and audit execution attestations. It supports the laboratory's research and enterprise integration work.

System overview

Attestation before execution.

AI agent or model route
        |
        v
SwiftAPI Authority
  issues a signed attestation
        |
        v
Mandatory enforcement point
  proxy, gateway, admission controller, or runtime hook
        |
        v
Execution allowed or denied

SwiftAPI Authority does not execute actions and does not run agents. It issues verifiable permission artifacts that external enforcement points check before allowing execution.

No attestation, no execution.

Python SDK

The enforcement loop.

Install

pip install swiftapi-python

Guard an action

from swiftapi import SwiftAPI, Enforcement

api = SwiftAPI(key="swiftapi_live_...")
guard = Enforcement(api)

guard.run(
    func=destructive_action,
    action="database_drop",
    intent="Schema cleanup script",
)
  • Local Ed25519 signature verification.
  • Real-time revocation checks and replay defense.
  • Fail-closed behavior when verification cannot be completed.
View swiftapi-python on PyPI

Provider wrappers

Attested inference without surrendering provider credentials.

OpenAI-compatible wrapper

from swiftapi import OpenAI

client = OpenAI(
    swiftapi_key="swiftapi_live_...",
    openai_key="sk-...",
)

response = client.chat.completions.create(
    model="gpt-5.2",
    messages=[{"role": "user", "content": "Hello"}],
)

Anthropic-compatible wrapper

from swiftapi import Anthropic

client = Anthropic(
    swiftapi_key="swiftapi_live_...",
    anthropic_key="sk-ant-...",
)

The SDK obtains an attestation from SwiftAPI Authority, then calls the selected provider with the customer's provider key. Provider keys are not sent to SwiftAPI Authority.

Authority model

Keys, scopes, and governance.

Key typePurpose
RecoveryEmergency root authority. Offline storage recommended.
OwnerManages authority, policies, grants, and regular keys.
RegularScoped authority for systems, automation, and delegated access.
ScopeCapability
verifyIssue and revoke execution attestations.
grantsCreate and revoke delegated authority.
policyPropose, approve, and activate policy bundles.
adminManage authority keys and access-denial records.
Raw authority keys are delivered once. The issuance system stores only SHA-256 key hashes. Revocation is immediate and irreversible.

Attestations

Signed, scoped, expiring execution records.

Signing algorithmEd25519
Token formCanonical payload with a detached signature in the attestation record
Default TTL48 hours, subject to authority configuration
Replay defenseUnique JTI per attestation
RevocationPull-based through /attestation/revocations

API surfaces

Website routes and authority routes are separate.

getswiftapi.com website APIs

These routes support the public research site, enterprise intake, and hidden legacy operations.

EndpointMethodDescription
/api/void-testGET, POSTDescribe or run the live five-model VOID benchmark
/api/challengeGET, POSTRedacted sandbox feed or exploratory model execution
/api/executeGET, POSTLegacy execution-demonstration interface
/api/waitlistPOSTEnterprise evaluation intake using the existing storage flow
/api/statusGETHidden legacy authority-request status lookup
/api/requestPOSTAdministrative issuance only; requires an issuance token
/api/retrievePOSTHidden one-time key retrieval

swiftapi.ai public authority APIs

EndpointMethodDescription
/GETAuthority metadata and public key
/healthGETAuthority health check
/attestation/infoGETAttestation format, public key, and TTL information
/attestation/verifyPOSTVerify an attestation, rate limited
/attestation/revocationsGETRevoked attestation identifiers
/policiesGETActive policy bundles

swiftapi.ai protected authority APIs

EndpointMethodScopeDescription
/verifyPOSTverifyIssue an execution attestation
/attestPOSTverifyIssue an attestation with action data
/chat/vibePOSTverifyAttestation-gated Chat Completions proxy
/attestation/revokePOSTverifyRevoke an attestation by JTI
/grantsPOSTgrantsCreate a delegated grant
/grants/{id}DELETEgrantsRevoke a grant
/policy/bundlesPOSTpolicyUpload a policy bundle
/policy/proposalsPOSTpolicyCreate a policy proposal
/policy/activatePOSTpolicyActivate a policy bundle
/authority/keysPOSTadminCreate an authority key
/authority/denialsGETadminView the denial log
/governance/eventsGETadminQuery the policy decision audit trail

Protected authority endpoints require the X-SwiftAPI-Authority header.

OpenClaw

Canonical action families for runtime enforcement.

The optional OpenClaw extension maps raw tool names to stable action families before requesting an attestation. Strict mode blocks unknown mappings and fails closed when the authority cannot be reached.

{
  "plugins": {
    "entries": {
      "swiftapi": {
        "enabled": true,
        "config": {
          "key": "swiftapi_live_...",
          "failClosed": true,
          "strictActionTypeMapping": true
        }
      }
    }
  }
}

Canonical families include runtime execution, filesystem reads and writes, control-plane operations, scheduled-job mutation, message delivery and moderation, network egress, and media generation.

Operational links

Inspect the live authority and its public record.