Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

docs(marketing): widen the 100-stars banner to the full open-source footprint, x402 volume, and validator attestations

nirholas748e825b95b8
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9b76e0af7..7fc8ba904 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -11,7 +11,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr
- **Text-to-3D no longer hangs when the concept painter stalls**: Every text-to-3D generation starts by painting a concept image, and that step tried its image providers one after another with no overall time limit. When the first provider stalled, a request could sit for two and a half minutes before answering, and anything with a shorter patience (ChatGPT, agent clients) simply saw nothing. The painter now works to one shared budget: a slow provider hands off with real time left for the next one, and if the whole chain runs out you get a quick, honest retry-in-a-moment answer instead of a hang. Image-to-3D was never affected. (`/forge`) `[fix]`
- **The first-contribution guide now hands you real open work, and the docs sidebar can find it**: The 15-minute contributor guide walked through adding MikuMikuDance rig support as its example, but that support had already shipped, so anyone following it literally would have re-done merged work and been told a bone was unmapped when it was not. It now shows the MMD change as the finished reference, exactly as it landed with its tests, and points you at two rig conventions that are genuinely still open, each with the bones that fail today. The community, triage, and first-contribution pages also appear in the docs sidebar under Guides instead of being reachable only from the README, and the triage page now explains every label the repo actually uses. (`/docs/first-contribution`) `[docs, fix]`
- **The full $THREE thesis is now a single document**: A long-form research thesis on $THREE now lives in the docs: what three.ws is, every way the token is used (hold-to-access tiers, plan and pass discounts, marketplace and labor escrow, game cosmetics, gated embeds, deploy-fee waivers), how platform revenue is routed into buybacks, where the token trades and is verified, the ecosystem footprint, the roadmap, and every risk the platform documents about itself, each claim sourced to the code. (`/three-token`) `[docs]`
-- **three.ws crossed 100 stars on GitHub**: The open-source repo behind three.ws passed 100 GitHub stars, with 101 npm packages under @three-ws, 72 MCP servers in the official registry, 11 contributors, and 9,508 commits since April 14. Thank you for building with us. `[docs]`
+- **three.ws crossed 100 stars on GitHub**: The open-source repo behind three.ws passed 100 GitHub stars: 9,508 commits from 21 contributors, 101 npm packages under @three-ws, 72 MCP servers in the official registry, 4,519 x402 endpoints with 110,416 on-chain settlements, and 3,000 validator attestations on Solana. Thank you for building with us. `[docs]`
- **Weekly Report #1: everything shipped since day one, week by week**: The first three.ws weekly report walks every week from the first commit on April 14 to today: what launched, what was announced, which partnerships landed, and where $THREE fits, with the totals (commits, changelog entries, pages, packages, MCP servers, listings) up front. It is written for the timeline, so no tables, and ships with a screenshot kit of the live surfaces. (`/docs/weekly-report-1`) `[docs]`
## 2026-08-24
diff --git a/data/changelog.json b/data/changelog.json
index 5beb1c2f3..dc0391fe5 100644
--- a/data/changelog.json
+++ b/data/changelog.json
@@ -4,7 +4,7 @@
{
"date": "2026-08-25",
"title": "three.ws crossed 100 stars on GitHub",
- "summary": "The open-source repo behind three.ws passed 100 GitHub stars, with 101 npm packages under @three-ws, 72 MCP servers in the official registry, 11 contributors, and 9,508 commits since April 14. Thank you for building with us.",
+ "summary": "The open-source repo behind three.ws passed 100 GitHub stars: 9,508 commits from 21 contributors, 101 npm packages under @three-ws, 72 MCP servers in the official registry, 4,519 x402 endpoints with 110,416 on-chain settlements, and 3,000 validator attestations on Solana. Thank you for building with us.",
"tags": [
"docs"
]
diff --git a/docs/media/github-100-stars-square.png b/docs/media/github-100-stars-square.png
index 7338c3127..649e7d837 100644
Binary files a/docs/media/github-100-stars-square.png and b/docs/media/github-100-stars-square.png differ
diff --git a/docs/media/github-100-stars-x.png b/docs/media/github-100-stars-x.png
index fe2fcb3d4..614d284dc 100644
Binary files a/docs/media/github-100-stars-x.png and b/docs/media/github-100-stars-x.png differ
diff --git a/docs/x-posts/github-100-stars.md b/docs/x-posts/github-100-stars.md
index 04196c348..7d4181c80 100644
--- a/docs/x-posts/github-100-stars.md
+++ b/docs/x-posts/github-100-stars.md
@@ -1,20 +1,27 @@
# X posts: 100 stars on GitHub
-Post copy for the 100-star milestone on X. Posting is owner-gated; these are ready-to-paste drafts. Attach [media/github-100-stars-x.png](../media/github-100-stars-x.png) (2400x1350, black background, three.ws lockup) to the main post. [media/github-100-stars-square.png](../media/github-100-stars-square.png) (1620x1620) is the square cut for Telegram, Instagram, and LinkedIn.
+Post copy for the 100-star milestone on X. Posting is owner-gated; these are ready-to-paste drafts. Attach [media/github-100-stars-x.png](../media/github-100-stars-x.png) (2400x1350, black background, three.ws lockup, twelve stat tiles) to the main post. [media/github-100-stars-square.png](../media/github-100-stars-square.png) (1620x1620) is the square cut for Telegram, Instagram, and LinkedIn.
-Regenerate both images with `node scripts/render-github-stars-banner.mjs` after updating the numbers in the script.
+Regenerate both images with `node scripts/render-github-stars-banner.mjs` after updating the `STATS` array in the script.
## Where every number comes from (as of August 25, 2026)
| Number | Source |
|---|---|
-| 104 stars, 26 forks | `gh api repos/nirholas/three.ws` |
-| 11 contributors | GitHub contributors API for `nirholas/three.ws` |
+| 104 stars, 26 forks, 7 open issues (22 total), 60 pull requests | GitHub API for `nirholas/three.ws` |
+| 21 contributors | distinct author identities in `git shortlog -sne --all` on `main` |
| 9,508 commits | `git rev-list --count HEAD` on `main` |
-| 101 npm packages | `registry.npmjs.org` search, maintainer `three-ws` (42 of them are MCP servers) |
+| 101 npm packages (42 are MCP servers) | `registry.npmjs.org` search, maintainer `three-ws` |
| 6,225 npm downloads, last 30 days (3,261 last 7 days) | `api.npmjs.org/downloads/point/last-month` summed across the scope |
| 72 MCP servers | `registry.modelcontextprotocol.io/v0/servers`, namespace `io.github.nirholas` |
-| 70 packages, 33 workers, 60 agent skills, 4 Rust crates, Solidity contracts | `packages/`, `workers/`, `.agents/skills` + `data/skills`, `crates/` + `contracts/` in the repo |
+| 60 agent skills | `.agents/skills` + `data/skills` |
+| 4,519 x402 endpoints | resources in the live discovery catalog at `https://three.ws/.well-known/x402.json`, all priced on Solana mainnet |
+| 110,416 x402 settlements | distinct on-chain settlement signatures across `x402_self_facilitator_log` (settle, ok) and `x402_audit_log` (`payment_settled`); the platform audit log alone records 79,477 settled payments since July 25 for $1,188.56 gross USDC |
+| 803,483 x402 verifications | `x402_self_facilitator_log` rows with `action = 'verify'` and `ok` |
+| 3,000 validator attestations | `solana_attestations` (SPL Memo envelope `threews.validation.v1`, see `specs/VALIDATORS.md`) |
+| 126,522 custody proofs across 244 epochs | `custody_attestation_leaves` / `custody_attestation_epochs` |
+| 725 public pages | `data/pages.json` |
+| 70 packages, 33 workers, 31 specs, 1,749 test files, 4 Rust crates, 7 Solidity contracts | the repo tree, all Apache-2.0 |
## Main post (@trythreews)
@@ -23,14 +30,14 @@ Attach: media/github-100-stars-x.png
```
three.ws just crossed 100 stars on GitHub.
-Thank you to everyone who starred, forked, opened an issue, or shipped a PR. Open source is not a side project for us. It is how the whole platform is built.
-
-What that repo has grown into:
+Thank you to everyone who starred, forked, opened an issue, or shipped a PR. Everything three.ws ships is open source, and here is what that repo has grown into:
+9,508 commits, 21 contributors, 60 pull requests
101 npm packages under @three-ws
72 MCP servers in the official registry
-11 contributors, 26 forks, 9,508 commits
-6,225 npm downloads in the last 30 days
+4,519 x402 endpoints, 110,416 on-chain settlements
+3,000 validator attestations on Solana
+725 public pages, all Apache-2.0
github.com/nirholas/three.ws
```
@@ -44,12 +51,25 @@ npm: 101 packages under @three-ws, 42 of them MCP servers. Avatars, x402 payment
MCP registry: 72 servers under one namespace at registry.modelcontextprotocol.io. Any MCP client can install them.
-On-chain: Solana programs (agent invocation, skill licensing) and Solidity payment contracts, all in the repo.
+Agent skills: 60 ready-to-install SKILL.md skills for Claude Code and any agent that reads them.
+
+On-chain: Solana programs (agent invocation, skill licensing), ERC-8004 identity, reputation and validation registries, and the x402 payment contracts, all in the repo.
+```
+
+## Reply 2 (the machine economy, in numbers)
+
+```
+The x402 side of the repo is not a demo:
+
+4,519 priced endpoints discoverable at three.ws/.well-known/x402.json
+110,416 settlements on Solana in USDC through our own self-hosted facilitator
+803,483 payment verifications
+3,000 validator attestations and 126,522 custody proofs written on-chain
-Agent skills: 60 ready-to-install skills for Claude Code and any agent that reads SKILL.md.
+Every line of that stack is public. Fork it and run your own.
```
-## Reply 2 (the ask)
+## Reply 3 (the ask)
```
If you build AI agents, 3D, or on-chain payments, there is real open work waiting for you: the contributor guide hands out scoped issues, every package has a README, and every PR gets reviewed.
@@ -67,7 +87,7 @@ Attach: media/github-100-stars-square.png
```
100 stars on GitHub.
-The three.ws repo now carries 101 npm packages, 72 MCP servers in the official registry, 11 contributors, 26 forks, and 9,508 commits since April 14. Thank you for building with us.
+The three.ws repo now carries 9,508 commits from 21 contributors, 101 npm packages, 72 MCP servers in the official registry, 4,519 x402 endpoints with 110,416 on-chain settlements, and 3,000 validator attestations on Solana. All of it open source. Thank you for building with us.
Star the repo: github.com/nirholas/three.ws
```
diff --git a/public/changelog.json b/public/changelog.json
index 459279db8..3c8841ca5 100644
--- a/public/changelog.json
+++ b/public/changelog.json
@@ -1,5 +1,5 @@
{
- "generated_at": "2026-08-25T15:48:35.198Z",
+ "generated_at": "2026-08-25T15:53:22.224Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json",
"site": {
"name": "three.ws",
@@ -61,7 +61,7 @@
"date": "2026-08-25",
"type": "update",
"title": "three.ws crossed 100 stars on GitHub",
- "summary": "The open-source repo behind three.ws passed 100 GitHub stars, with 101 npm packages under @three-ws, 72 MCP servers in the official registry, 11 contributors, and 9,508 commits since April 14. Thank you for building with us.",
+ "summary": "The open-source repo behind three.ws passed 100 GitHub stars: 9,508 commits from 21 contributors, 101 npm packages under @three-ws, 72 MCP servers in the official registry, 4,519 x402 endpoints with 110,416 on-chain settlements, and 3,000 validator attestations on Solana. Thank you for building with us.",
"link": null,
"tags": [
"docs"
diff --git a/public/changelog.xml b/public/changelog.xml
index bebe9da65..3ab9e2416 100644
--- a/public/changelog.xml
+++ b/public/changelog.xml
@@ -52,7 +52,7 @@
<guid isPermaLink="false">2026-08-25:three.ws crossed 100 stars on GitHub</guid>
<pubDate>Tue, 25 Aug 2026 12:00:00 GMT</pubDate>
<category>docs</category>
- <description>The open-source repo behind three.ws passed 100 GitHub stars, with 101 npm packages under @three-ws, 72 MCP servers in the official registry, 11 contributors, and 9,508 commits since April 14. Thank you for building with us.</description>
+ <description>The open-source repo behind three.ws passed 100 GitHub stars: 9,508 commits from 21 contributors, 101 npm packages under @three-ws, 72 MCP servers in the official registry, 4,519 x402 endpoints with 110,416 on-chain settlements, and 3,000 validator attestations on Solana. Thank you for building with us.</description>
</item>
<item>
<title>Weekly Report #1: everything shipped since day one, week by week</title>
diff --git a/public/features.json b/public/features.json
index 236bf429b..bcb2ff516 100644
--- a/public/features.json
+++ b/public/features.json
@@ -1,5 +1,5 @@
{
- "generated_at": "2026-08-25T15:48:35.186Z",
+ "generated_at": "2026-08-25T15:53:22.215Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json",
"site": {
"name": "three.ws",
diff --git a/scripts/render-github-stars-banner.mjs b/scripts/render-github-stars-banner.mjs
index 658c1173b..284938037 100644
--- a/scripts/render-github-stars-banner.mjs
+++ b/scripts/render-github-stars-banner.mjs
@@ -16,40 +16,46 @@ const lockup = readFileSync(resolve(root, 'public/brand/three-ws-lockup-on-dark.
const mark = readFileSync(resolve(root, 'public/brand/three-ws-mark.png')).toString('base64');
const STATS = [
+ { value: '9,508', label: 'commits', sub: 'since April 14, 2026' },
+ { value: '21', label: 'contributors', sub: 'github.com/nirholas/three.ws' },
+ { value: '60', label: 'pull requests', sub: '26 forks' },
{ value: '101', label: 'npm packages', sub: '@three-ws scope' },
{ value: '72', label: 'MCP servers', sub: 'official MCP registry' },
- { value: '11', label: 'contributors', sub: 'github.com/nirholas/three.ws' },
- { value: '9,508', label: 'commits', sub: 'since April 14, 2026' },
- { value: '26', label: 'forks', sub: 'and counting' },
- { value: '6,225', label: 'npm downloads', sub: 'last 30 days' },
+ { value: '60', label: 'agent skills', sub: 'SKILL.md, any agent' },
+ { value: '4,519', label: 'x402 endpoints', sub: '/.well-known/x402.json' },
+ { value: '110,416', label: 'x402 settlements', sub: 'on-chain, Solana, USDC' },
+ { value: '803,483', label: 'x402 verifications', sub: 'self-hosted facilitator' },
+ { value: '3,000', label: 'validator attestations', sub: 'Solana, threews.validation.v1' },
+ { value: '126,522', label: 'custody proofs', sub: '244 attestation epochs' },
+ { value: '725', label: 'public pages', sub: 'Apache-2.0, all of it' },
];
function page({ width, height, square }) {
- const cols = square ? 2 : 3;
+ const cols = square ? 3 : 4;
return `<!doctype html><html><head><meta charset="utf-8">
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&family=JetBrains+Mono:wght@500&display=swap" rel="stylesheet">
<style>
* { margin:0; padding:0; box-sizing:border-box; }
html, body { width:${width}px; height:${height}px; background:#000; color:#fff; font-family:Inter, system-ui, sans-serif; overflow:hidden; }
- .wrap { position:relative; width:100%; height:100%; padding:${square ? 72 : 64}px ${square ? 72 : 80}px; display:flex; flex-direction:column; justify-content:space-between; }
+ .wrap { position:relative; width:100%; height:100%; padding:${square ? 56 : 48}px ${square ? 56 : 64}px; display:flex; flex-direction:column; justify-content:space-between; }
.glow { position:absolute; inset:0; background:
radial-gradient(ellipse 55% 45% at 78% 18%, rgba(140,120,255,.22), transparent 60%),
radial-gradient(ellipse 45% 40% at 12% 88%, rgba(255,150,120,.14), transparent 60%);
pointer-events:none; }
.grid { position:absolute; inset:0; background-image:linear-gradient(rgba(255,255,255,.035) 1px, transparent 1px), linear-gradient(90deg, rgba(255,255,255,.035) 1px, transparent 1px); background-size:48px 48px; mask-image:radial-gradient(ellipse 70% 70% at 50% 50%, #000 30%, transparent 100%); pointer-events:none; }
.top { position:relative; display:flex; align-items:center; justify-content:space-between; }
- .lockup { height:${square ? 96 : 104}px; }
+ .lockup { height:${square ? 80 : 88}px; }
.pill { display:inline-flex; align-items:center; gap:10px; padding:10px 18px; border:1px solid rgba(255,255,255,.18); border-radius:999px; font-size:${square ? 20 : 22}px; font-weight:500; color:rgba(255,255,255,.85); background:rgba(255,255,255,.04); letter-spacing:.01em; }
.pill svg { width:22px; height:22px; fill:#fff; }
.hero { position:relative; display:flex; align-items:center; gap:${square ? 28 : 40}px; margin-top:${square ? 8 : 0}px; }
- .star { width:${square ? 132 : 150}px; height:${square ? 132 : 150}px; flex:none; filter:drop-shadow(0 0 40px rgba(255,220,120,.45)); }
- .hero h1 { font-size:${square ? 108 : 132}px; font-weight:800; line-height:.92; letter-spacing:-.045em; background:linear-gradient(120deg,#fff 0%,#dcd6ff 45%,#ffd9c7 100%); -webkit-background-clip:text; background-clip:text; color:transparent; }
- .hero p { margin-top:14px; font-size:${square ? 28 : 32}px; font-weight:500; color:rgba(255,255,255,.7); letter-spacing:-.01em; }
- .stats { position:relative; display:grid; grid-template-columns:repeat(${cols},1fr); gap:${square ? 14 : 18}px; }
- .stat { padding:${square ? 20 : 22}px ${square ? 22 : 26}px; border:1px solid rgba(255,255,255,.12); border-radius:18px; background:linear-gradient(180deg, rgba(255,255,255,.06), rgba(255,255,255,.02)); }
- .stat b { display:block; font-size:${square ? 44 : 48}px; font-weight:700; letter-spacing:-.03em; line-height:1; font-variant-numeric:tabular-nums; }
- .stat span { display:block; margin-top:8px; font-size:${square ? 19 : 20}px; font-weight:600; color:rgba(255,255,255,.9); }
- .stat small { display:block; margin-top:3px; font-size:${square ? 15 : 16}px; color:rgba(255,255,255,.5); font-family:'JetBrains Mono', monospace; }
+ .star { width:${square ? 110 : 124}px; height:${square ? 110 : 124}px; flex:none; filter:drop-shadow(0 0 40px rgba(255,220,120,.45)); }
+ .hero h1 { font-size:${square ? 92 : 112}px; font-weight:800; line-height:.92; letter-spacing:-.045em; background:linear-gradient(120deg,#fff 0%,#dcd6ff 45%,#ffd9c7 100%); -webkit-background-clip:text; background-clip:text; color:transparent; }
+ .hero p { margin-top:10px; font-size:${square ? 24 : 28}px; font-weight:500; color:rgba(255,255,255,.7); letter-spacing:-.01em; }
+ .stats { position:relative; display:grid; grid-template-columns:repeat(${cols},1fr); gap:${square ? 10 : 12}px; }
+ .stat { padding:${square ? 14 : 16}px ${square ? 16 : 20}px; border:1px solid rgba(255,255,255,.12); border-radius:18px; background:linear-gradient(180deg, rgba(255,255,255,.06), rgba(255,255,255,.02)); }
+ .stat b { display:block; font-size:${square ? 34 : 38}px; font-weight:700; letter-spacing:-.03em; line-height:1; font-variant-numeric:tabular-nums; }
+ .stat span { display:block; margin-top:6px; font-size:${square ? 15 : 17}px; font-weight:600; color:rgba(255,255,255,.9); }
+ .stat small { display:block; margin-top:2px; font-size:${square ? 12 : 13}px; color:rgba(255,255,255,.5); font-family:'JetBrains Mono', monospace; }
.foot { position:relative; display:flex; justify-content:space-between; align-items:center; font-size:${square ? 18 : 20}px; color:rgba(255,255,255,.55); font-family:'JetBrains Mono', monospace; }
.foot b { color:rgba(255,255,255,.85); font-weight:500; }
</style></head><body><div class="wrap">
@@ -60,7 +66,7 @@ function page({ width, height, square }) {
</div>
<div class="hero">
<svg class="star" viewBox="0 0 24 24"><defs><linearGradient id="g" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#fff6d6"/><stop offset=".55" stop-color="#ffd166"/><stop offset="1" stop-color="#ff9f7a"/></linearGradient></defs><path fill="url(#g)" d="M12 1.8l3.1 6.5 7.1.9-5.2 4.9 1.3 7.1L12 17.8l-6.3 3.4L7 14.1 1.8 9.2l7.1-.9z"/></svg>
- <div><h1>100 stars</h1><p>on GitHub. Thank you. Open source is how three.ws is built.</p></div>
+ <div><h1>100 stars</h1><p>on GitHub. Thank you. Everything three.ws ships is open source.</p></div>
</div>
<div class="stats">${STATS.map(s => `<div class="stat"><b>${s.value}</b><span>${s.label}</span><small>${s.sub}</small></div>`).join('')}</div>
<div class="foot"><span>Star the repo: <b>github.com/nirholas/three.ws</b></span><span><b>three.ws</b> · $THREE</span></div>