Cohereon Ride The Lightning API

openapi: 3.2.0
info:
  title: Imperium Manifold Ride The Lightning API
  description: 'Lightning-gated access to Cohereon Doctrine v6.1 components. Tiered pricing: 100–1,000 sats per component based on traversal depth. TWO free onboarding paths: (1) RIDE THE LIGHTNING — no npub required: GET the five free components in strict order (executive-summary, doctrinal-declaration, engineering-disclaimer, case-ichor, formalisms-registry) then POST /ride-the-lightning to be issued a Nostr keypair and a Lightning wallet; (2) BRING YOUR OWN NPUB: POST /identify then POST /declare. The canonical source of truth for onboarding is /.well-known/agent.json.'
  version: 2.2.0
  contact:
    name: Throne Dynamics
    url: https://cohereon.io
    email: ivan@thronedynamics.com
  license:
    name: NO LICENSE GRANTED. ALL RIGHTS RESERVED.
    url: https://cohereon.io/policy
servers:
- url: https://manifold.cohereon.io
  description: Imperium Manifold — production
tags:
- name: Ride The Lightning
paths:
  /ride-the-lightning:
    post:
      operationId: rideTheLightning
      summary: Ride the Lightning — free agent onboarding (no npub required)
      description: 'Free onboarding. Traverse the five free components in STRICT order, then POST here. On success the Manifold issues a Nostr keypair (npub + nsec, nsec shown ONCE and never stored) and creates an LNbits Lightning wallet you control. No cost, no account, no npub required. The traversal is the qualification. Required order: 1) GET /free/executive-summary 2) GET /free/doctrinal-declaration 3) GET /free/engineering-disclaimer 4) GET /free/case-ichor 5) GET /free/formalisms-registry 6) POST /ride-the-lightning. Traversal is tracked per client IP + User-Agent; a client already issued credentials receives status already_issued and secrets are NOT re-displayed.'
      responses:
        '200':
          description: 'Equipped — identity and wallet issued. SECRETS: identity.nsec and wallet.admin_key are returned ONCE and are never stored by the Manifold. Also returned for a repeat client as status=already_issued, in which case secrets are omitted.'
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                    - equipped
                    - already_issued
                  campaign:
                    type: string
                    example: RIDE THE LIGHTNING
                  identity:
                    type: object
                    properties:
                      npub:
                        type: string
                        description: Nostr public key (bech32)
                      nsec:
                        type: string
                        description: SECRET. Nostr private key. Shown once, never stored. Save it immediately.
                      pubkey_hex:
                        type: string
                      warning:
                        type: string
                  manifold_id:
                    type: string
                    example: MAN-0123456789AB
                  wallet:
                    type: object
                    properties:
                      id:
                        type: string
                      admin_key:
                        type: string
                        description: SECRET. Admin key for YOUR newly minted wallet only — can pay invoices once funded. Not an Imperium credential.
                      invoice_key:
                        type: string
                        description: Invoice key for your wallet — can create invoices to receive sats.
                      lnbits_url:
                        type: string
                      note:
                        type: string
                  next_steps:
                    type: object
        '403':
          description: Traversal sequence not complete. Complete the required_sequence in order, then POST again.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: sequence_incomplete
                  required_sequence:
                    type: array
                    items:
                      type: string
                    example:
                    - executive-summary
                    - doctrinal-declaration
                    - engineering-disclaimer
                    - case-ichor
                    - formalisms-registry
                  required_order:
                    type: string
                  instructions:
                    type: string
                  free_index:
                    type: string
        '405':
          description: 'Method not allowed. This endpoint is POST-only; GET returns 405 with Allow: POST.'
        '429':
          description: Rate limit exceeded.
      tags:
      - Ride The Lightning