Keysat
3f1fbe0f3b
Keysat has no refund functionality — refunds are handled out-of-band in the payment processor (the v0.3 revoke-on-refund webhook hook is currently a no-op). Drop refund mentions so the docs do not describe a flow the daemon does not implement.
55 lines
1.9 KiB
Markdown
55 lines
1.9 KiB
Markdown
# Keysat Docs
|
|
|
|
Operator-facing documentation for [Keysat](https://keysat.xyz) — the
|
|
Bitcoin-native self-hosted software licensing service for StartOS.
|
|
|
|
This repo is a static HTML site. No build step. The deployed version lives at
|
|
**[keysat.xyz/docs](https://keysat.xyz/docs)**.
|
|
|
|
## Pages
|
|
|
|
- **[index.html](./index.html)** — Introduction. What Keysat is, why it
|
|
exists, and the sovereignty thesis behind it.
|
|
- **[install.html](./install.html)** — Operator setup walkthrough. Installing
|
|
the .s9pk on StartOS, connecting BTCPay, creating your first product and
|
|
policy, and sharing your buy URL.
|
|
- **[integrate.html](./integrate.html)** — Wiring Keysat licensing into your
|
|
own software. Code examples for the TypeScript, Python, and Rust SDKs;
|
|
entitlement-gating patterns; offline verification.
|
|
- **[operate.html](./operate.html)** — Day-to-day operations. Managing
|
|
licenses, suspending / revoking, search, audit log, discount codes.
|
|
- **[wire-format.html](./wire-format.html)** — Specification of the signed
|
|
license key format (LIC1 envelope, base32 alphabet, Ed25519 signature
|
|
scheme). Useful for porting the SDK to a new language.
|
|
|
|
## Local development
|
|
|
|
The site is self-contained — open any `.html` file in a browser, or serve
|
|
the directory with any static file server:
|
|
|
|
```sh
|
|
# Python
|
|
python3 -m http.server 8000
|
|
# or
|
|
npx serve .
|
|
```
|
|
|
|
Then visit `http://localhost:8000`.
|
|
|
|
## Styling
|
|
|
|
All pages share `docs.css`. Brand assets live in `assets/`. The visual
|
|
language matches the rest of the Keysat surface (cream paper-textured
|
|
background, navy ink, gold accents, classical type — Manrope for display,
|
|
Inter for body, JetBrains Mono for code).
|
|
|
|
## Contributing
|
|
|
|
Issues and pull requests welcome. Substantive changes — new sections,
|
|
restructuring, factual corrections to the wire-format spec — are best
|
|
discussed in an issue first.
|
|
|
|
## License
|
|
|
|
MIT. See [LICENSE](./LICENSE).
|