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(erc8004,contracts): document the two reputation registry dialects and the new Uniswap v4 hooks, with changelog entries

ni3ac40a3a468ff0
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4a7ded28d..5663cdac5 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,7 +6,9 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr
## 2026-09-20
+- **Agent reputation on Base and other EVM chains now shows real on-chain reviews**: Reputation panels, the passport widget and the trust scores behind agent-to-agent gating were asking the shared ERC-8004 reputation registry a question it does not answer, so agents with dozens of on-chain reviews showed none. They now read the registry the way it actually works: an agent with 41 reviews from 22 reviewers on Base shows 4.1 out of 5 and its recent reviews, and the panel loads in a few seconds on free public RPCs. Staked vouches are only offered on chains whose registry supports them. `[fix, improvement]`
- **Paid $THREE purchases say what is wrong instead of failing silently**: Every $THREE-priced purchase is sealed into one signed quote before you pay. If the platform side of that rail is not fully configured, the quote now comes back with a clear, retryable message and a named reason rather than an opaque internal error, and the platform status page reports the condition itself. Nobody has to be mid-checkout for the problem to be visible. (`/status`) `[fix, infra]`
+- **Two Uniswap v4 hooks: wearable 3D items as coins, and fees that reward agent reputation**: New open-source contracts. SkinHook turns a wearable 3D item into a fixed-supply coin with its own pool: wearing it locks one token, so every wearer shrinks the tradable supply, and the creator's royalty is taken inside the swap where it cannot be skipped, with a share for the site that referred the sale. AgentTierHook gives ERC-8004 agents a lower trading fee as their on-chain reputation grows, with liquidity providers keeping every fee. Both are tested against the real Uniswap v4 contracts and are not deployed yet. `[feature, sdk]`
## 2026-09-18
diff --git a/STRUCTURE.md b/STRUCTURE.md
index 93dfd691b..c4fc9e667 100644
--- a/STRUCTURE.md
+++ b/STRUCTURE.md
@@ -266,6 +266,7 @@ bottom.
| Market detail pages (exchange, category) + DeFi yields | [pages/exchange.html](pages/exchange.html) + [src/exchange-page.js](src/exchange-page.js) `→ /exchange/:id` over [api/coin/exchange.js](api/coin/exchange.js), [pages/category.html](pages/category.html) + [src/category-page.js](src/category-page.js) `→ /category/:id` over [api/coin/category.js](api/coin/category.js) + [api/coin/markets.js](api/coin/markets.js) (`?category=`), [pages/yields.html](pages/yields.html) + [src/yields.js](src/yields.js) `→ /yields` over [api/defi/yields.js](api/defi/yields.js) | In-repo | Rich detail pages that turn list rows into full profiles. Exchange: trust badge, normalized-volume stat, BTC-volume history chart, and a per-pair markets table (spot + derivatives fallback), reached from `/exchanges` and the new Derivatives Exchanges table. Category: rank, sector stats, the full sortable coins table for that sector, and related categories, reached from `/categories`. Yields: an explorer over ~15k live DeFiLlama pools with chain/project/stablecoin/min-TVL filters, APY/TVL sort, URL-synced state, and a per-pool APY+TVL history chart on row expand. Docs: [docs/coin-pages.md](docs/coin-pages.md) |
| Crypto news + archive + markets hub | [pages/markets.html](pages/markets.html) + [src/markets-page.js](src/markets-page.js) `→ /markets`, [pages/markets-news.html](pages/markets-news.html) + [src/markets-news.js](src/markets-news.js) `→ /markets/news`, [pages/news-article.html](pages/news-article.html) + [src/news-article.js](src/news-article.js) `→ /markets/news/article`, [pages/news-archive.html](pages/news-archive.html) + [src/news-archive.js](src/news-archive.js) `→ /markets/archive`, [pages/news-digest.html](pages/news-digest.html) + [src/news-digest.js](src/news-digest.js) `→ /markets/digest`; backend [api/news/](api/news) (feed, article, knowledge, archive, digest, rss, image) over [api/_lib/article-extract.js](api/_lib/article-extract.js) (page→reader→feed→preview ladder) and [api/_lib/news-rights.js](api/_lib/news-rights.js) (publisher rights layer, enforced at every read path), [api/_lib/news-coins.js](api/_lib/news-coins.js) (ticker→live market snapshot), [api/_lib/news-knowledge-store.js](api/_lib/news-knowledge-store.js) (durable `news_knowledge` corpus) + hourly archiver [api/cron/news-archive-append.js](api/cron/news-archive-append.js) over [api/_lib/news.js](api/_lib/news.js) + [api/_lib/news-sources.js](api/_lib/news-sources.js), corpus on `gs://three-ws-news-archive`, purge tooling [scripts/news-takedown-purge.mjs](scripts/news-takedown-purge.mjs) | In-repo | The Markets news wing + front door: /markets/news is “Your briefing”: live news aggregated natively from 197 publisher feeds (Featured/Trending/Saved tabs, breaking ticker, AI briefing card, top-stories hero + rail, search, sentiment, ticker chips, og:image preview resolution for imageless feeds), a rich article reader that shows a bounded lead excerpt plus our own summary/key points/entities/market context and sends the reader to the publisher for the rest (the excerpt cap and any rightsholder takedowns are enforced server-side across the reader, RSS mirror, archive search, and agent knowledge corpus, never just hidden client-side), and renders **live coin cards** (price/24h/7d/sparkline→/coin/:id) for detected tickers, and related coverage. Every read story is recorded to a durable **news knowledge base** (`GET /api/news/knowledge`) that grounds the 3D agents, itself subject to the same excerpt limit. Plus the largest open crypto-news archive (662,047 enriched articles, Sept 2017 → today, EN+中文, GCS-hosted) and the /markets hub aggregating global stats, the top-100 table, breaking news, and every market surface as a hero card. Docs: [docs/coin-pages.md](docs/coin-pages.md), [docs/api-reference.md](docs/api-reference.md), [docs/news-rights.md](docs/news-rights.md) (publisher takedown path) |
| Robinhood Chain markets + buy flow | Hub + detail pages [pages/markets-robinhood.html](pages/markets-robinhood.html) + [src/markets-robinhood.js](src/markets-robinhood.js) `→ /markets/robinhood`, [pages/robinhood-stock.html](pages/robinhood-stock.html) + [src/robinhood-stock.js](src/robinhood-stock.js) `→ /markets/robinhood/stock/:symbol`, [pages/robinhood-coin.html](pages/robinhood-coin.html) + [src/robinhood-coin.js](src/robinhood-coin.js) `→ /markets/robinhood/coin/:address`, buy flow [src/robinhood-purchase.js](src/robinhood-purchase.js), wallet desk [pages/hood-desk.html](pages/hood-desk.html) + [src/hood-desk.js](src/hood-desk.js) + [src/hood-desk.css](src/hood-desk.css) `→ /markets/robinhood/desk`; backend [api/_lib/robinhood.js](api/_lib/robinhood.js) + `api/v1/robinhood/{chain,stocks,stocks-detail,coins,coins-detail,launches,desk,wallet}.js` (free, the last two composed for the desk over [api/_lib/robinhood-desk.js](api/_lib/robinhood-desk.js)) + [api/x402/robinhood-portfolio.js](api/x402/robinhood-portfolio.js) (x402 paid) | In-repo | The 24/7 tokenized-equity board for Robinhood Chain (4663): live Chainlink NAV vs. Uniswap DEX premium for every Stock Token (one multicall, never 95 RPC calls), a memecoin screener across NOXA/The Odyssey launchpads (CoinGecko categories + on-chain launch logs via Blockscout), and chain TVL/gas/block stats. Detail pages add NAV history, holders, transfers, and contract links. Coin pages carry a real buy panel: injected-wallet connect, chain-switch to 4663, live Uniswap v3 `QuoterV2` quote + `SwapRouter02` swap with slippage, LI.FI bridge deep-link; Stock Tokens are display-only (tokenized securities, not offered to US persons) with an eligibility-gated outbound DEX link instead. Paid `portfolio` endpoint returns ERC-8056 `uiMultiplier`-correct holdings. The Hood Desk (`/markets/robinhood/desk`) is the wallet-first view of the same chain: paste or connect any address and it loads that wallet's book (native + priced ERC-20 positions), its native balance curve rebuilt from Blockscout's daily and per-transaction feeds (the public RPC is not an archive node), an activity tape that folds token transfers onto the transaction that emitted them, the NAV premium ridge layered by liquidity floor, counterparty flow, and memecoin movers. Read-only and signature-free; the trade ticket reuses the coin pages' swap panel and the Stock Token eligibility gate. Tests: [tests/robinhood-desk.test.js](tests/robinhood-desk.test.js) (the derivations) and [tests/e2e/hood-desk.spec.js](tests/e2e/hood-desk.spec.js) (the panels, the empty states, the ladder collapse and the trade ticket). Docs: [docs/robinhood-chain-markets.md](docs/robinhood-chain-markets.md) |
+| Uniswap v4 hooks (EVM) | [contracts/v4-hooks/](contracts/v4-hooks): `SkinHook` + `SkinToken` (wearable 3D items as coins), `AgentTierHook` (ERC-8004 reputation fee tiers), CREATE2 address mining and deploy scripts; hook census [scripts/uniswap-v4-hook-census.mjs](scripts/uniswap-v4-hook-census.mjs) | In-repo · contracts code-complete and tested against real v4-core and a live Base fork, not deployed (owner-gated) | Additional EVM surface, Solana stays the home chain. `SkinHook`: every wearable is a fixed-supply ERC-20 with its own ETH pool; equipping locks one whole token in the hook so each wearer shrinks the float, a 2% ETH-side fee is split creator / referrer (named in `hookData`, the embed that sold it) / treasury as ERC-6909 claims, and the whole supply is seeded as one permanent single-sided position. `AgentTierHook`: dynamic LP fee by ERC-8004 standing, read from the canonical registries with a pool-configured reviewer set, cached by a permissionless `refreshTier`, every registry failure resolving to the base fee. v4-core vendored at v4.0.0 under `contracts/v4-hooks/lib`. Docs: [contracts/v4-hooks/README.md](contracts/v4-hooks/README.md), [docs/uniswap-v4-hooks.md](docs/uniswap-v4-hooks.md) |
| Robinhood Portfolios (generated index portfolios) | Generator [pages/hood-portfolios.html](pages/hood-portfolios.html) + [src/hood-portfolios.js](src/hood-portfolios.js) + [src/hood-portfolios.css](src/hood-portfolios.css) `→ /markets/robinhood/portfolios`, universe board [pages/hood-portfolios-universe.html](pages/hood-portfolios-universe.html) + [src/hood-portfolios-universe.js](src/hood-portfolios-universe.js) `→ /markets/robinhood/portfolios/universe`; backend [api/_lib/hood-portfolios.js](api/_lib/hood-portfolios.js) + `api/v1/hood-portfolios/{universe,generate,health}.js` (free, keyless); universe snapshot [data/hood-portfolios-universe.json](data/hood-portfolios-universe.json) built by [scripts/build-hood-portfolios-universe.mjs](scripts/build-hood-portfolios-universe.mjs) (`npm run hood:universe`); contracts [contracts/hood-portfolios/](contracts/hood-portfolios) | In-repo · contracts code-complete and fork-proven against live chain 4663, mainnet deploy owner-gated | Describe a portfolio in a sentence and get a real basket of Robinhood Chain assets. The screen ranks the whole holdable universe (727 assets: 167 tokenized equities, majors, and the chain-native long tail) through the platform free-first LLM chain, and every token it returns is validated back against that universe before it is shown. The result is committed as an immutable content-addressed manifest (`PortfolioRegistry`), held in kind by an ERC-20 share vault (`Portfolio`) whose backing is derived from balances rather than tracked, and rebalanced to published targets by a descending-price auction any address can fill: there is no function that lets a manager trade the fund. Needs no price oracle on any code path, which is what makes it work on a chain where only 34 of 95 registry equities have a Chainlink feed. Halt-aware: a paused tokenized equity stops issuance, redemption and rebalancing, and the UI says so. Ticker impersonation is resolved by contract address at build time (12 contracts on this chain call themselves USDG), so an impostor can never be selected. Backtests run the basket twice, on its schedule and never rebalanced, and report the difference: history comes from Chainlink round data (chunked into multicalls of 40, because this RPC silently drops calls out of a larger one) and a daily snapshot whose coverage compounds, with uncovered legs named rather than dropped. A generated portfolio shares as a deflate-compressed manifest in the URL, its hash re-derived server-side rather than trusted from the link. 38 offline contract tests incl. fuzz + 4 stateful invariants, 5 against a fork of live chain 4663, and 56 vitest across the screen, backtest engine, history reduction and SDK. Docs: [docs/robinhood-portfolios.md](docs/robinhood-portfolios.md), [contracts/hood-portfolios/README.md](contracts/hood-portfolios/README.md) |
| Premium Data API pass | [api/premium/](api/premium) + [api/_lib/premium.js](api/_lib/premium.js), dashboards [src/dashboard-next/pages/data-api.js](src/dashboard-next/pages/data-api.js) `→ /dashboard/data-api` + [src/dashboard-next/pages/billing.js](src/dashboard-next/pages/billing.js) `→ /dashboard/billing` | In-repo | Monthly pass in three tiers (Developer $19.99, Pro $99, Enterprise $499 per 30d, tiered rate limits) paid on Solana in $THREE (20% off), SOL, or USDC — replaces per-call x402 on the news archive with an `x402_live_` API key (existing access-control lane) + SIWX browser grants. Quote→sign→verify flow with on-chain balance-delta verification; tables `premium_passes`/`premium_quotes`. Docs: [docs/premium.md](docs/premium.md) |
| Liquidations pulse (/coins) | Collector [services/liquidation-collector/](services/liquidation-collector) (standalone always-on Node service, ported from SperaxOS), proxy [api/coin/liquidations.js](api/coin/liquidations.js) `→ GET /api/coin/liquidations`, UI strip in [src/coins-index.js](src/coins-index.js) `→ /coins` | Live — collector on Cloud Run (`liquidation-collector`, min-instances 1, unthrottled CPU) since 2026-07-10 | Real-time long/short liquidation pain across Binance, Bybit, and OKX public futures WebSocket streams: dominant-side badge (LONG PAIN / SHORT SQUEEZE / BALANCED), 1h long-vs-short bars, and the 3 largest recent liquidations, polled every 30s (pauses on hidden tab). The collector holds long-lived WebSockets so it can't run as a Vercel function — deploy it separately and point `LIQUIDATION_COLLECTOR_URL` at it. No fallback data: the proxy 503s `collector_offline` (never fabricated numbers) when unset or unreachable, and the strip degrades to a quiet single-line offline state. Docs: [docs/api-reference.md#liquidations](docs/api-reference.md#liquidations) |
diff --git a/contracts/README.md b/contracts/README.md
index 0726c7293..9542f1fa7 100644
--- a/contracts/README.md
+++ b/contracts/README.md
@@ -28,6 +28,8 @@ contracts are additional surfaces.
| `AgentPayments` | [`src/AgentPayments.sol`](./src/AgentPayments.sol) | Payments in, split into authority and buyback shares, buyback swaps and burns | Not deployed. See [`AGENT_PAYMENTS.md`](./AGENT_PAYMENTS.md) |
| `GreenfieldVault` | [`src/GreenfieldVault.sol`](./src/GreenfieldVault.sol) | Pay-to-unlock marketplace over a real BNB Greenfield cross-chain permission grant | Not deployed to a public chain; proven on an anvil fork |
| `WorldMoves` | [`src/WorldMoves.sol`](./src/WorldMoves.sol) | Event-only move stream for the Agora world. No value, no admin | Not deployed to a public chain |
+| `SkinHook` | [`v4-hooks/src/SkinHook.sol`](./v4-hooks/src/SkinHook.sol) | Uniswap v4 hook: wearable 3D items as fixed-supply coins, wear-to-lock, in-swap creator royalty, referrer share | Not deployed. See [`v4-hooks/README.md`](./v4-hooks/README.md) |
+| `AgentTierHook` | [`v4-hooks/src/AgentTierHook.sol`](./v4-hooks/src/AgentTierHook.sol) | Uniswap v4 hook: an ERC-8004 agent's reputation sets the LP fee it pays | Not deployed. Fork-tested against live Base |
| `skill_license` | [`skill-license/`](./skill-license) | Solana: a 1-of-1 NFT access key per purchased skill, revocable on refund | Not deployed. Program id reserved |
| `agent_invocation` | [`agent-invocation/`](./agent-invocation) | Solana: verifiable agent-to-agent invocation events | Not deployed. Program id reserved |
| `knock_escrow` | [`knock-escrow/`](./knock-escrow) | Solana: a priced message held in escrow that pays out only against a reply, and refunds in full otherwise | Not deployed. Program id reserved |
diff --git a/data/changelog.json b/data/changelog.json
index e1d6a25eb..f9d11ce99 100644
--- a/data/changelog.json
+++ b/data/changelog.json
@@ -1,6 +1,24 @@
{
"$comment": "Curated changelog entries for three.ws, the editorial layer of the public changelog. New PAGE launches are tracked automatically via the `added` field in data/pages.json; this file is for everything else holders care about: improvements, fixes, SDK releases, trading/payments capabilities, security work. scripts/build-page-index.mjs merges both sources into CHANGELOG.md, public/changelog.json, and public/changelog.xml. Newest first. Allowed tags: feature, improvement, fix, sdk, infra, docs, security. `link` is optional and must be a live three.ws path.",
"entries": [
+ {
+ "date": "2026-09-20",
+ "title": "Two Uniswap v4 hooks: wearable 3D items as coins, and fees that reward agent reputation",
+ "summary": "New open-source contracts. SkinHook turns a wearable 3D item into a fixed-supply coin with its own pool: wearing it locks one token, so every wearer shrinks the tradable supply, and the creator's royalty is taken inside the swap where it cannot be skipped, with a share for the site that referred the sale. AgentTierHook gives ERC-8004 agents a lower trading fee as their on-chain reputation grows, with liquidity providers keeping every fee. Both are tested against the real Uniswap v4 contracts and are not deployed yet.",
+ "tags": [
+ "feature",
+ "sdk"
+ ]
+ },
+ {
+ "date": "2026-09-20",
+ "title": "Agent reputation on Base and other EVM chains now shows real on-chain reviews",
+ "summary": "Reputation panels, the passport widget and the trust scores behind agent-to-agent gating were asking the shared ERC-8004 reputation registry a question it does not answer, so agents with dozens of on-chain reviews showed none. They now read the registry the way it actually works: an agent with 41 reviews from 22 reviewers on Base shows 4.1 out of 5 and its recent reviews, and the panel loads in a few seconds on free public RPCs. Staked vouches are only offered on chains whose registry supports them.",
+ "tags": [
+ "fix",
+ "improvement"
+ ]
+ },
{
"date": "2026-09-20",
"title": "Paid $THREE purchases say what is wrong instead of failing silently",
diff --git a/docs/agent-reputation.md b/docs/agent-reputation.md
index f33b3ea40..cd5a0ced3 100644
--- a/docs/agent-reputation.md
+++ b/docs/agent-reputation.md
@@ -118,7 +118,7 @@ The same on-chain data is exposed through every layer a reader might come from:
| `agent_reputation` MCP tool | AI agents | Paid ($0.01 USDC) read of identity + score + stake + recent events; resolves a wallet to its agent automatically |
| `GET /api/x402/agent-reputation` | AI agents | Paid ($0.01) cross-chain 0–100 trust score for **any** counterparty — Solana/EVM wallet, pump.fun mint, ERC-8004 agent id, or three.ws agent_id (auto-detected). See [Trust primitives](trust-primitives.md) |
| [Agent Passport](/agent-passport.html) | trust decisions | An A–D trust grade weighted toward credentialed and verified feedback |
-| ERC-8004 helpers (`src/erc8004/reputation.js`; ABIs re-exported by `@three-ws/sdk`) | developers | `getReputation`, `getRecentReviews`, `getTotalStake`, `submitFeedback`, `stakeReputation` |
+| ERC-8004 helpers (`src/erc8004/reputation.js`; ABIs re-exported by `@three-ws/sdk`) | developers | `getReputation`, `getRecentReviews`, `getTotalStake`, `submitFeedback`, `stakeReputation`, `supportsStaking`; raw dialect-aware reads in `src/erc8004/reputation-read.js` (`readAgentReputation`) |
The Agent Passport is the most sophisticated: it doesn't treat all stars equally. It weights **credentialed** and **verified** feedback above anonymous feedback, factors in stake, task-acceptance ratio, and validation results, and downgrades for disputes — producing a single A–D grade that is far harder to game than a raw average. That weighting *is* the answer to the Sybil problem below.
diff --git a/docs/erc8004.md b/docs/erc8004.md
index 789a03b51..c14918766 100644
--- a/docs/erc8004.md
+++ b/docs/erc8004.md
@@ -119,7 +119,31 @@ The typical registration flow calls `register(agentURI)` to mint the token and s
### ReputationRegistry.sol
-Signed on-chain feedback, one review per wallet address per agent.
+Signed on-chain feedback about an agent. **Two dialects exist, and the one that
+matters is not the one in this repo.**
+
+The canonical registries at the `0x8004...` addresses run the ERC-8004 reference
+implementation (`ReputationRegistryUpgradeable`). Reputation there is a per-reviewer
+ledger with no global average:
+
+```
+giveFeedback(uint256 agentId, int128 value, uint8 valueDecimals,
+ string tag1, string tag2, string endpoint, string feedbackURI, bytes32 feedbackHash)
+getClients(uint256 agentId) → address[]
+getSummary(uint256 agentId, address[] clientAddresses, string tag1, string tag2)
+ → (uint64 count, int128 summaryValue, uint8 summaryValueDecimals)
+readFeedback(uint256 agentId, address client, uint64 index) → (value, decimals, tag1, tag2, isRevoked)
+```
+
+`getSummary` reverts with `"clientAddresses required"` on an empty list: you must say
+whose feedback you count, which is the standard's sybil defence. Pass
+`getClients(agentId)` to count everyone. Values are 0 to 100 by convention,
+`giveFeedback` rejects the agent's own owner and operators, and there is no staking.
+The registries are upgradeable proxies, so treat this interface as something to
+detect, not assume.
+
+`contracts/src/ReputationRegistry.sol` in this repo is an older, simpler dialect that
+only exists where someone deployed it themselves:
```
submitFeedback(uint256 agentId, int8 score, string uri)
@@ -129,9 +153,14 @@ getFeedback(uint256 agentId, uint256 index) → Feedback
getFeedbackRange(uint256 agentId, uint256 offset, uint256 limit) → Feedback[]
```
-Scores are signed integers in the range −100 to +100. `getReputation` returns `(avgX100, count)` where `avgX100` is the average multiplied by 100 to preserve one decimal of precision without floating-point math — divide by 100 on the client. The `uri` field on each feedback is optional; it can point to an IPFS document with a longer review.
+There, scores are signed integers from −100 to +100 and `getReputation` returns the
+average multiplied by 100 (divide by 100 on the client). The `uri` field is optional.
+
+Never call either dialect directly. `src/erc8004/reputation-read.js` detects which one
+lives at an address by behaviour and reads it correctly; `src/erc8004/reputation.js`
+builds the write path, recent reviews and staking support on top of it.
-Three invariants are enforced by the contract: agents can't review themselves (`SelfReviewForbidden`), each address can only submit one review per agent (`AlreadyReviewed`), and scores outside −100..+100 are rejected (`ScoreOutOfRange`).
+On the legacy dialect three invariants are enforced by the contract: agents can't review themselves (`SelfReviewForbidden`), each address can only submit one review per agent (`AlreadyReviewed`), and scores outside −100..+100 are rejected (`ScoreOutOfRange`).
### ValidationRegistry
@@ -453,19 +482,28 @@ After registering, your agent starts accumulating on-chain reputation. Any walle
### How scoring works
-Scores are integers from −100 to +100. The contract stores each individual review (submitter address, score, optional IPFS pointer to a longer write-up) and maintains a running aggregate (sum + count). The `getReputation` call returns `(avgX100, count)`:
+Every three.ws surface shows reputation as 1 to 5 stars. On the canonical registries
+a star is 20 points on the 0 to 100 scale, so a 5-star review is written as 100 and an
+on-chain average of 82 reads as 4.1. The helpers do the conversion in both directions
+and work against either registry dialect:
```js
import { getReputation, getRecentReviews } from './src/erc8004/reputation.js';
-const { count, average } = await getReputation({
- agentId: 42,
+const { count, average, rawAverage, reviewers, dialect } = await getReputation({
+ agentId: 1,
chainId: 8453,
runner: provider, // ethers Provider or Signer
});
-// average is the mean score as a plain number (e.g. 87.5); 0 when count is 0
+// average: 4.1 (stars, 0 when count is 0) rawAverage: 82 (the registry's own unit)
+// count: 41 feedback entries from 22 reviewers dialect: 'reference'
```
+Server code that needs the raw figure (a reputation gate, a trust score) reads it with
+`readAgentReputation({ address, runner, agentId, reviewers?, tag1?, tag2? })` from
+`src/erc8004/reputation-read.js`. Pass `reviewers` to count only feedback from
+addresses you trust.
+
To paginate through individual reviews:
```js
diff --git a/docs/uniswap-v4-hooks.md b/docs/uniswap-v4-hooks.md
index 7fca3b839..e1426a2ea 100644
--- a/docs/uniswap-v4-hooks.md
+++ b/docs/uniswap-v4-hooks.md
@@ -1,5 +1,11 @@
# Uniswap v4 hooks: what three.ws could build and list
+> **Status, 2026-09-20.** Two of the hooks below are built and tested:
+> `SkinHook` (concept M-1 with M-2's referrer share built in) and `AgentTierHook`
+> (the ERC-8004 reputation hook). Source, tests and deploy scripts:
+> [`contracts/v4-hooks/`](../contracts/v4-hooks). Neither is deployed. The reputation
+> client drift described below is fixed in `src/erc8004/reputation-read.js`.
+
Survey date: 2026-09-20. Registry counts come from
[`Uniswap/hooklist`](https://github.com/Uniswap/hooklist) at `main` on that date.
On-chain claims were checked by direct RPC call or against explorer-verified
diff --git a/public/changelog-recent.json b/public/changelog-recent.json
index 0a6512877..177168475 100644
--- a/public/changelog-recent.json
+++ b/public/changelog-recent.json
@@ -1,14 +1,25 @@
{
- "generated_at": "2026-09-20T03:37:31.294Z",
+ "generated_at": "2026-09-20T04:28:31.249Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json",
"site": {
"name": "three.ws",
"url": "https://three.ws"
},
- "total": 3712,
+ "total": 3714,
"complete": false,
"full_feed": "/changelog.json",
"entries": [
+ {
+ "date": "2026-09-20",
+ "type": "update",
+ "title": "Agent reputation on Base and other EVM chains now shows real on-chain reviews",
+ "summary": "Reputation panels, the passport widget and the trust scores behind agent-to-agent gating were asking the shared ERC-8004 reputation registry a question it does not answer, so agents with dozens of on-chain reviews showed none. They now read the registry the way it actually works: an agent with 41 reviews from 22 reviewers on Base shows 4.1 out of 5 and its recent reviews, and the panel loads in a few seconds on free public RPCs. Staked vouches are only offered on chains whose registry supports them.",
+ "link": null,
+ "tags": [
+ "fix",
+ "improvement"
+ ]
+ },
{
"date": "2026-09-20",
"type": "update",
@@ -20,6 +31,17 @@
"infra"
]
},
+ {
+ "date": "2026-09-20",
+ "type": "update",
+ "title": "Two Uniswap v4 hooks: wearable 3D items as coins, and fees that reward agent reputation",
+ "summary": "New open-source contracts. SkinHook turns a wearable 3D item into a fixed-supply coin with its own pool: wearing it locks one token, so every wearer shrinks the tradable supply, and the creator's royalty is taken inside the swap where it cannot be skipped, with a share for the site that referred the sale. AgentTierHook gives ERC-8004 agents a lower trading fee as their on-chain reputation grows, with liquidity providers keeping every fee. Both are tested against the real Uniswap v4 contracts and are not deployed yet.",
+ "link": null,
+ "tags": [
+ "feature",
+ "sdk"
+ ]
+ },
{
"date": "2026-09-18",
"type": "update",
@@ -1598,28 +1620,6 @@
"fix",
"improvement"
]
- },
- {
- "date": "2026-09-08",
- "type": "update",
- "title": "Every tutorial now shows you the page it is teaching",
- "summary": "Twenty screenshots of the real product had been captured for the tutorials and then never put on the page: the tutorials described the Forge, Avatar Studio, Voice Lab, Scene Studio, Widget Studio and the rest entirely in words, while the pictures sat unused. All twenty are now embedded where they belong, each with a caption and a link straight to the live page, so you can see what you are about to open before you open it. The sign-language reference gained its two figures as well, and the missing Scene Studio capture was taken.",
- "link": "/tutorials/text-to-3d",
- "tags": [
- "docs",
- "improvement"
- ]
- },
- {
- "date": "2026-09-08",
- "type": "update",
- "title": "Exit Lab is usable with a thumb, and it no longer goes quiet when the trade corpus is missing",
- "summary": "A full audit of the Exit Lab console found 49 controls below the 44px touch floor on a phone: the 18px help dots, the 16px-tall policy sliders and the agent link on every row of the trade table were all but untappable. All of them are now full-size targets on touch devices, and the desktop layout keeps its density. Two dead ends went with them. The Run the search button used to sit there live and answer a click with nothing when no trades had loaded; it is now disabled and says which of the two reasons applies. And when the corpus fails to load, the attribution, trade-by-trade and search sections say so instead of leaving three headings over blank space, with the trade table stuck announcing itself as still loading forever.",
- "link": "/exit-lab",
- "tags": [
- "fix",
- "improvement"
- ]
}
]
}
diff --git a/public/changelog.json b/public/changelog.json
index 8156bc375..138ca922d 100644
--- a/public/changelog.json
+++ b/public/changelog.json
@@ -1,11 +1,22 @@
{
- "generated_at": "2026-09-20T03:37:31.252Z",
+ "generated_at": "2026-09-20T04:28:31.225Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json",
"site": {
"name": "three.ws",
"url": "https://three.ws"
},
"entries": [
+ {
+ "date": "2026-09-20",
+ "type": "update",
+ "title": "Agent reputation on Base and other EVM chains now shows real on-chain reviews",
+ "summary": "Reputation panels, the passport widget and the trust scores behind agent-to-agent gating were asking the shared ERC-8004 reputation registry a question it does not answer, so agents with dozens of on-chain reviews showed none. They now read the registry the way it actually works: an agent with 41 reviews from 22 reviewers on Base shows 4.1 out of 5 and its recent reviews, and the panel loads in a few seconds on free public RPCs. Staked vouches are only offered on chains whose registry supports them.",
+ "link": null,
+ "tags": [
+ "fix",
+ "improvement"
+ ]
+ },
{
"date": "2026-09-20",
"type": "update",
@@ -17,6 +28,17 @@
"infra"
]
},
+ {
+ "date": "2026-09-20",
+ "type": "update",
+ "title": "Two Uniswap v4 hooks: wearable 3D items as coins, and fees that reward agent reputation",
+ "summary": "New open-source contracts. SkinHook turns a wearable 3D item into a fixed-supply coin with its own pool: wearing it locks one token, so every wearer shrinks the tradable supply, and the creator's royalty is taken inside the swap where it cannot be skipped, with a share for the site that referred the sale. AgentTierHook gives ERC-8004 agents a lower trading fee as their on-chain reputation grows, with liquidity providers keeping every fee. Both are tested against the real Uniswap v4 contracts and are not deployed yet.",
+ "link": null,
+ "tags": [
+ "feature",
+ "sdk"
+ ]
+ },
{
"date": "2026-09-18",
"type": "update",
diff --git a/public/changelog.xml b/public/changelog.xml
index bc6dc09eb..3bc92fb28 100644
--- a/public/changelog.xml
+++ b/public/changelog.xml
@@ -6,6 +6,14 @@
<atom:link href="https://three.ws/changelog.xml" rel="self" type="application/rss+xml"/>
<description>What's new on three.ws: features, improvements, and releases, newest first.</description>
<language>en</language>
+ <item>
+ <title>Agent reputation on Base and other EVM chains now shows real on-chain reviews</title>
+ <link>https://three.ws/changelog</link>
+ <guid isPermaLink="false">2026-09-20:Agent reputation on Base and other EVM chains now shows real on-chain reviews</guid>
+ <pubDate>Sun, 20 Sep 2026 12:00:00 GMT</pubDate>
+ <category>fix</category>
+ <description>Reputation panels, the passport widget and the trust scores behind agent-to-agent gating were asking the shared ERC-8004 reputation registry a question it does not answer, so agents with dozens of on-chain reviews showed none. They now read the registry the way it actually works: an agent with 41 reviews from 22 reviewers on Base shows 4.1 out of 5 and its recent reviews, and the panel loads in a few seconds on free public RPCs. Staked vouches are only offered on chains whose registry supports them.</description>
+ </item>
<item>
<title>Paid $THREE purchases say what is wrong instead of failing silently</title>
<link>https://three.ws/status</link>
@@ -14,6 +22,14 @@
<category>fix</category>
<description>Every $THREE-priced purchase is sealed into one signed quote before you pay. If the platform side of that rail is not fully configured, the quote now comes back with a clear, retryable message and a named reason rather than an opaque internal error, and the platform status page reports the condition itself. Nobody has to be mid-checkout for the problem to be visible.</description>
</item>
+ <item>
+ <title>Two Uniswap v4 hooks: wearable 3D items as coins, and fees that reward agent reputation</title>
+ <link>https://three.ws/changelog</link>
+ <guid isPermaLink="false">2026-09-20:Two Uniswap v4 hooks: wearable 3D items as coins, and fees that reward agent reputation</guid>
+ <pubDate>Sun, 20 Sep 2026 12:00:00 GMT</pubDate>
+ <category>feature</category>
+ <description>New open-source contracts. SkinHook turns a wearable 3D item into a fixed-supply coin with its own pool: wearing it locks one token, so every wearer shrinks the tradable supply, and the creator's royalty is taken inside the swap where it cannot be skipped, with a share for the site that referred the sale. AgentTierHook gives ERC-8004 agents a lower trading fee as their on-chain reputation grows, with liquidity providers keeping every fee. Both are tested against the real Uniswap v4 contracts and are not deployed yet.</description>
+ </item>
<item>
<title>469 generated animations in the library, and for sale as rigged GLBs</title>
<link>https://three.ws/animations</link>
diff --git a/public/features.json b/public/features.json
index 9832d290d..fe49d3782 100644
--- a/public/features.json
+++ b/public/features.json
@@ -1,5 +1,5 @@
{
- "generated_at": "2026-09-20T03:37:31.232Z",
+ "generated_at": "2026-09-20T04:28:31.211Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json",
"site": {
"name": "three.ws",
diff --git a/scripts/audit-docs.mjs b/scripts/audit-docs.mjs
index 3187d2a07..b90b81813 100644
--- a/scripts/audit-docs.mjs
+++ b/scripts/audit-docs.mjs
@@ -288,6 +288,7 @@ const UNPUBLISHED_DOCS = new Map([
['announcement-coverage', 'internal: X announcement coverage matrix for marketing planning'],
['announcement-coverage-telegram', 'internal: paste-ready holders-channel post drafted from the coverage matrix'],
['avatar-cli', 'internal: in-flight, register when the CLI ships'],
+ ['uniswap-v4-hooks', 'internal: registry survey, prior-art review and concept ranking; the reader-facing doc is contracts/v4-hooks/README.md'],
['fee-bridge', 'held by the owner until launch is approved (2026-09-17); register in data/pages.json when /fee-bridge ships'],
['avatar-fidelity-program', 'internal: program goals and competitive targets'],
['aws-marketplace-listing-kit', 'internal: paste-ready listing copy and portal steps'],