From 3f6108edfc320f2d245df2de214aa01da4a30e18 Mon Sep 17 00:00:00 2001 From: Grant Date: Mon, 11 May 2026 08:46:10 -0500 Subject: [PATCH] Add agent-friendly section + simplify support page - New #agents section between Integrate and Sovereign with three cards: OpenAPI 3.1 discovery, scoped API keys with bounded roles, stable error codes + HMAC-signed webhooks. Links to KEYSAT_AGENT_GUIDE.md. - Top-nav gains 'Agents' anchor. - support.html: dropped the placeholder on-chain section (no address finalized yet) and the speculative 'what funds go toward' paragraph. Now three clean sections: Patron license, Lightning, OpenSats. --- index.html | 35 +++++++++++++++++++++++++++++++++++ support.html | 17 ++++------------- 2 files changed, 39 insertions(+), 13 deletions(-) diff --git a/index.html b/index.html index 73afefd..b121b0c 100644 --- a/index.html +++ b/index.html @@ -297,6 +297,10 @@ pre.code .p { color:rgba(245,241,232,0.55); } .sov .panel .footnote { font-size:13px; color:var(--ink-500); margin:18px 0 0; line-height:1.55; } .sov .panel.dark .footnote { color:rgba(245,241,232,0.6); } +/* ---------- Agent-friendly section ---------- */ +.agent-grid { display:grid; grid-template-columns:repeat(3, 1fr); gap:24px; } +@media (max-width: 880px) { .agent-grid { grid-template-columns:1fr; } } + /* ---------- Install ---------- */ .install-grid { display:grid; grid-template-columns:1fr 1fr; gap:24px; } .install-card { background:var(--cream-50); border:1px solid var(--border-1); border-radius:14px; padding:28px; } @@ -517,6 +521,7 @@ footer.site .bottom a { color:rgba(245,241,232,0.6); } Creators How it works Integrate + Agents Install Docs @@ -797,6 +802,36 @@ ok = verifier.verify(license_key_from_user) +
+
+
+ Agent-friendly +

Built so you can hand operations to an AI agent.

+

Keysat issues, monetizes, and manages licenses through a clean self-service admin UI. It also exposes every operator action through a documented HTTP API with bounded-scope credentials — so if you'd rather have an agent do the day-to-day work, you can give it the keys safely.

+
+
+
+
OpenAPI 3.1
+

Discovery built in

+

GET /v1/openapi.json returns a curated, stable spec. Drop the URL into a Custom GPT, OpenAI Assistant, LangChain, or Claude Code — the agent learns the endpoints automatically.

+
+
+
Scoped API keys
+

Least-privilege by design

+

Generate a key, pick a role (read-only, license-issuer, support, or full-admin), hand it to the agent. Revoke in 30 seconds without rotating your master credential. Operator-only actions stay behind the master key.

+
+
+
Stable error codes + webhooks
+

React, don't poll

+

HMAC-signed event deliveries on every license / invoice / subscription state change. Every error response carries a stable machine-readable code (tier_cap, not_found, license_revoked) so agents branch deterministically.

+
+
+
+ Agent integration guide → +
+
+
+
diff --git a/support.html b/support.html index 9d5acfe..58cf6cd 100644 --- a/support.html +++ b/support.html @@ -154,21 +154,12 @@ footer{
-

3. On-chain Bitcoin

+

3. OpenSats

-
For larger contributions
-

BTC address

-

Best for $50+ contributions where the Lightning channel-balance limit might be a concern.

-
- Coming soon: on-chain address will be published once finalized. For now, please use Lightning above or the Patron license tier. -
+
Fund Bitcoin FOSS broadly
+

OpenSats

+

If you’d rather fund Bitcoin software development broadly rather than this project specifically, OpenSats is a 501(c)(3) that grants to dozens of FOSS Bitcoin projects — including BTCPay, which Keysat depends on.

- -

What the funds go toward

-

Roughly in this order: paying contractors to ship the v0.2 web UI auth hardening, recurring billing primitives, additional language SDKs (Go, Swift, Java, .NET), and the long tail of papercut fixes that operators report. A small slice covers infrastructure — the marketing site, the docs site, the marketplace registry. We publish quarterly transparency reports of what came in and where it went, signed by the keysat.xyz issuer key.

- -

OpenSats

-

If you’d rather fund Bitcoin software development broadly rather than this project specifically, OpenSats is a 501(c)(3) public charity that grants to dozens of FOSS Bitcoin projects (BTCPay, Fedimint, Cashu, NoStr clients, …). They take Lightning. Keysat itself relies on BTCPay, which OpenSats supports.