zeekayandHanzo Dev 9894fccfdb docs(kms): document the API this service actually serves
All three KMS pages described Infisical: /api/v3/secrets, /api/v3/transit,
/api/v3/pki, /api/v1/secrets with secretValue bodies, plus workspaces you had to
create first. luxfi/kms serves none of it. These pages are where several broken
clients came from — a reader followed them, got 200 text/html back from the
embedded console SPA that answered every unmatched path, and concluded the call
had worked. luxfi/kms 1.12.8 removed that catch-all, so those paths now 404 in
JSON, and the docs are the last place still teaching them.

Replaced with the real surface, verified against cmd/kms/main.go and live:

  POST   /v1/kms/auth/login                              {clientId, clientSecret}
  GET    /v1/kms/orgs/{org}/secrets?path=&env=           -> {"names": []}
  GET    /v1/kms/orgs/{org}/secrets/{path}/{name}?env=   -> {"secret":{"value"}}
  POST   /v1/kms/orgs/{org}/secrets                      {path,name,env,value}
  DELETE /v1/kms/orgs/{org}/secrets/{path}/{name}?env=

Also documented because each one has cost someone time: env is a field and not a
hostname; the URL splits at its LAST slash so segments must be escaped
individually; create and update are one upsert; responses are never HTML.

secrets.mdx additionally promised versioning, automatic rotation with providers,
point-in-time recovery, and folder/tag objects. pkg/store/secrets.go has exactly
Put/Get/List/Delete and the Secret struct has no version field, so the page now
says plainly that those four do not exist rather than leaving readers to
discover it. The KMSSecret CRD example went too — there is no such CRD in the
tree.

Co-authored-by: Hanzo Dev <[email protected]>
2026-07-26 08:13:08 -07:00
2026-02-14 05:26:19 -08:00

Lux Network Documentation

Official documentation for Lux Network - Post-quantum secure blockchain infrastructure.

Built with @hanzo/docs - the documentation framework by Hanzo AI.

Getting Started

# Install dependencies
pnpm install

# Start development server
pnpm dev

# Build for production
pnpm build

Documentation Structure

content/
└── docs/
    ├── index.mdx          # Welcome page
    ├── learn/             # Learning resources
    │   ├── introduction/  # Introduction to Lux
    │   ├── architecture/  # Architecture deep-dive
    │   └── consensus/     # Consensus mechanisms
    ├── build/             # Developer guides
    │   ├── quickstart/    # Quick start guide
    │   ├── sdk/           # SDK documentation
    │   └── contracts/     # Smart contract development
    ├── nodes/             # Node operation
    │   ├── run/           # Running a node
    │   ├── validators/    # Validator setup
    │   └── staking/       # Staking guide
    └── reference/         # API reference
        ├── api/           # REST/RPC API
        └── cli/           # CLI reference

Contributing

  1. Fork the repository
  2. Create your feature branch
  3. Add or modify documentation in content/docs/
  4. Submit a pull request

License

MIT © Lux Network


Part of the Hanzo Docs ecosystem.

S
Description
Documentation site for Lux Network's architecture, SDKs, and node operations.
Readme BSD-3-Clause
5.4 MiB
Languages
MDX 99.2%
TypeScript 0.8%