Skip to content

Commit 29a298a

Browse files
committed
docs: align narrative with proof of participation focus
- Lead with proof of participation, not cost claims - Add ERC-8004 January 2026 context (feedbackAuth removal) - Standardize costs to ~$0.002 across all docs - Remove Graph comparisons (not applicable to Solana)
1 parent 7909fd7 commit 29a298a

6 files changed

Lines changed: 70 additions & 54 deletions

File tree

README.md

Lines changed: 23 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -56,18 +56,20 @@ SATI enables agents to establish trust across organizational boundaries without
5656

5757
## Why SATI?
5858

59-
**Designed for scale.** SATI uses Solana Attestation Service for reputation, which means:
59+
**Proof of participation.** SATI implements a blind feedback model where agents sign BEFORE knowing feedback sentiment — they cannot selectively participate in only positive reviews. This security guarantee was removed from ERC-8004 in January 2026.
6060

61+
- **Cryptographic proof of interaction** — Both parties must sign; agent commits before knowing outcome
62+
- **Native indexing** — Photon provides query capabilities for compressed accounts via standard RPC
6163
- **Complete histories, not just averages** — Store every feedback on-chain, aggregate algorithmically
62-
- **Compression-ready** — When SAS ships [ZK-compressed attestations](https://github.com/solana-foundation/solana-attestation-service/pull/101), reputation costs drop ~100x
6364
- **Sub-second finality**~400ms today, ~150ms with Alpenglow
6465
- **Native wallet support** — Agents visible in Phantom, Solflare, Backpack
6566

66-
| Capability | Today | With Compression |
67-
|------------|-------|------------------|
68-
| Feedback cost | ~0.002 SOL | ~0.00002 SOL |
69-
| Practical scale | 10K feedbacks | 1M+ feedbacks |
70-
| On-chain history | Full | Full |
67+
| Capability | SATI |
68+
|------------|------|
69+
| Proof of participation | Agent signs before outcome known |
70+
| Native indexing | Photon RPC for compressed accounts |
71+
| Feedback cost | ~$0.002 per attestation |
72+
| On-chain history | Full (not just aggregates) |
7173

7274
**100% ERC-8004 compatible** — same registration file format, same functional interfaces, cross-chain agent identity via DIDs.
7375

@@ -146,37 +148,31 @@ See the [SDK documentation](./packages/sdk/README.md) for complete usage example
146148

147149
**Reputation** (per attestation):
148150

149-
| Operation | Today | With Compression |
150-
|-----------|-------|------------------|
151-
| Authorize feedback | ~0.002 SOL | ~0.00002 SOL |
152-
| Give feedback | ~0.002 SOL | ~0.00002 SOL |
153-
| Validation request | ~0.002 SOL | ~0.00002 SOL |
151+
| Operation | Cost |
152+
|-----------|------|
153+
| Feedback (single) | ~$0.002 (~0.00002 SOL) |
154+
| Feedback (batched 5/tx) | ~$0.001 (amortized) |
155+
| Validation | ~$0.002 |
154156

155157
See [benchmarks](./docs/benchmarks/) for detailed CU measurements.
156158

157159
---
158160

159-
## Scalability Roadmap
161+
## Architecture Benefits
160162

161-
SATI's architecture is designed to scale with Solana's infrastructure:
163+
**Why this design matters:**
162164

163-
**Today:** PDA-based attestations via SAS
164-
- Full ERC-8004 compatibility
165-
- Complete on-chain feedback histories
166-
- ~0.002 SOL per attestation
167-
168-
**When SAS ships compressed attestations ([PR #101](https://github.com/solana-foundation/solana-attestation-service/pull/101)):**
169-
- ~100x cost reduction for reputation operations
170-
- Million-agent scale becomes practical
171-
- No SATI code changes required — SAS handles compression transparently
172-
173-
**Why this matters:**
174165
Systems constrained by gas costs store only aggregates (averages, counts). SATI stores complete histories, enabling:
175166
- Spam detection via pattern analysis
176167
- Reviewer reputation (weight feedback by reviewer quality)
177168
- Time-decay scoring (recent feedback matters more)
178169
- Payment-verified feedback (x402 proofs)
179170

171+
**Native indexing via Photon:**
172+
- Compressed accounts queryable via standard RPC
173+
- Same trust model as reading blockchain state
174+
- No external indexing infrastructure required
175+
180176
---
181177

182178
## ERC-8004 Compatibility
@@ -188,8 +184,8 @@ SATI achieves **100% functional compatibility** with ERC-8004:
188184
| `registrationFile` | Token-2022 `uri` field (IPFS/HTTP) |
189185
| `transfer()` | Native Token-2022 transfer |
190186
| `setApprovalForAll()` | Token-2022 delegate |
191-
| `Feedback.request()` | SAS `FeedbackAuth` attestation |
192-
| `Feedback.submit()` | SAS `Feedback` attestation |
187+
| `giveFeedback()` | Blind feedback model (DualSignature) |
188+
| `feedbackAuth` (removed Jan 2026) | N/A — SATI uses stronger dual-signature |
193189
| Collection membership | TokenGroup extension |
194190

195191
---

docs/concepts/validation.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,10 @@ description: Understanding ERC-8004 Validations and how they enable quality gate
77

88
SATI's ValidationV1 schema implements the validation pattern defined in [ERC-8004 (Trustless Agents)](https://ethereum-magicians.org/t/erc-8004-trustless-agents/25098). This page explains what validations are for and how they work.
99

10+
::: info ERC-8004 January 2026 Update
11+
The January 2026 ERC-8004 spec update removed `feedbackAuth` for feedback (anyone can now submit feedback without agent involvement). However, validation still uses the request/response pattern with validator signatures — both parties must participate.
12+
:::
13+
1014
## Core Purpose
1115

1216
From the ERC-8004 specification:

docs/getting-started.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -117,8 +117,8 @@ Compressed attestations are indexed via [Photon](https://photon.helius.dev/) (fr
117117
| Operation | Cost | Notes |
118118
|-----------|------|-------|
119119
| Agent registration | ~0.003 SOL | Mint + metadata + group + AgentIndex |
120-
| Feedback (single) | ~$0.002 | ~0.00001 SOL via Light Protocol |
121-
| Feedback (batched 5/tx) | ~$0.0006 | Amortized proof cost |
120+
| Feedback (single) | ~$0.002 | ~0.00002 SOL via Light Protocol |
121+
| Feedback (batched 5/tx) | ~$0.001 | Amortized proof cost |
122122
| Validation | ~$0.002 | Same as feedback |
123123
| ReputationScore | ~0.002 SOL | Regular SAS attestation |
124124
| Delegation grant | ~0.002 SOL | Regular SAS attestation (reclaimable) |

docs/guide/concepts.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -159,13 +159,13 @@ This enables multiple reputation providers to compete with different algorithms.
159159
### Compressed (Light Protocol)
160160

161161
- **Cost**: ~$0.002 per attestation
162-
- **Indexing**: Free via Photon
162+
- **Indexing**: Native via Photon RPC
163163
- **Use case**: High-volume feedback, validation
164-
- **Tradeoff**: Not directly RPC queryable
164+
- **Tradeoff**: Not directly queryable by other on-chain programs
165165

166166
### Regular (SAS)
167167

168-
- **Cost**: ~0.002 SOL (~$0.40 at $200/SOL)
168+
- **Cost**: ~0.002 SOL rent (reclaimable)
169169
- **Indexing**: Standard RPC getProgramAccounts
170170
- **Use case**: ReputationScore, Delegation
171-
- **Benefit**: Direct on-chain queryability
171+
- **Benefit**: Direct on-chain queryability by other programs

docs/index.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ layout: home
44
hero:
55
name: SATI
66
text: Solana Agent Trust Infrastructure
7-
tagline: Production-ready agent reputation. ~$0.002 per attestation.
7+
tagline: Agent trust infrastructure with cryptographic proof of participation.
88
actions:
99
- theme: brand
1010
text: Get Started
@@ -14,18 +14,18 @@ hero:
1414
link: https://github.com/cascade-protocol/sati
1515

1616
features:
17-
- icon: "\U0001F4B0"
18-
title: 200x Cost Reduction
19-
details: ZK Compression via Light Protocol stores attestations at ~$0.002 each. Batched feedback drops to ~$0.0006.
2017
- icon: "\U0001F510"
21-
title: Blind Feedback Model
22-
details: Agent signs with response (blind to outcome), client feedback is free. Cannot selectively participate.
18+
title: Proof of Participation
19+
details: Agent signs BEFORE knowing feedback sentiment — cannot selectively participate. ERC-8004 removed this guarantee in Jan 2026.
2320
- icon: "\U0001F517"
2421
title: x402 Native
2522
details: Canonical feedback extension for x402 payments. Payment tx becomes task reference (CAIP-220).
2623
- icon: "\u2705"
2724
title: ERC-8004 Compatible
2825
details: Full compatibility with the Ethereum agent registry standard. Cross-chain identity linking supported.
26+
- icon: "\U0001F4B0"
27+
title: Cost-Efficient Storage
28+
details: ZK Compression via Light Protocol. ~$0.002 per attestation with native Photon indexing.
2929
- icon: "\U0001F3D7"
3030
title: Production Ready
3131
details: "Deployed to mainnet: satiRkxEiwZ51cv8PRu8UMzuaqeaNU9jABo6oAFMsLe"
@@ -41,7 +41,7 @@ features:
4141
| **Token-2022** | Agent identity as NFT with metadata |
4242
| **SAS** | Schema definitions + regular attestation storage |
4343
| **Light Protocol** | ZK Compressed attestation storage |
44-
| **Photon** | Free indexing for compressed accounts |
44+
| **Photon** | Native indexing for compressed accounts |
4545

4646
## Quick Example
4747

docs/specification.md

Lines changed: 30 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -16,9 +16,9 @@ outline: [2, 3]
1616

1717
SATI is open trust infrastructure for AI agents on Solana solving the economics of on-chain feedback:
1818

19-
- **Agent-subsidized feedback** — Agent signs with response (blind to outcome), client feedback is free
19+
- **Proof of participation** — Agent signs with response (blind to outcome); cannot selectively participate in only positive reviews
2020
- **x402 native** — Canonical feedback extension; payment tx becomes task reference (CAIP-220)
21-
- **200x cost reduction** — ZK Compression stores attestations at ~$0.002 each
21+
- **Cost-efficient storage** — ZK Compression via Light Protocol with native Photon indexing
2222
- **Schema agnostic** — Program verifies signatures on 131-byte universal base layout; new schemas without upgrades
2323
- **No reputation monopoly** — Multiple providers compete with different scoring algorithms
2424
- **Hot/cold wallet separation** — Delegates can sign attestations without full ownership permissions
@@ -71,13 +71,13 @@ SATI is the canonical feedback extension for x402. Payment tx hash becomes `task
7171
| Operation | Cost | Notes |
7272
|-----------|------|-------|
7373
| Agent registration | ~0.003 SOL | Mint + metadata + group + AgentIndex |
74-
| Feedback (single) | ~$0.002 | ~0.00001 SOL via Light |
75-
| Feedback (batched 5/tx) | ~$0.0006 | Amortized proof cost |
74+
| Feedback (single) | ~$0.002 | ~0.00002 SOL via Light Protocol |
75+
| Feedback (batched 5/tx) | ~$0.001 | Amortized proof cost |
7676
| Validation | ~$0.002 | Same as feedback |
7777
| ReputationScore | ~0.002 SOL | Regular SAS attestation |
7878
| Delegation grant | ~0.002 SOL | Regular SAS attestation (reclaimable) |
7979
| Delegation revoke | ~0.000005 SOL | Tx fee only; ~0.002 SOL rent returned |
80-
| Photon indexing | Free | Compressed attestations only |
80+
| Photon indexing | Free | Native indexing for compressed attestations |
8181

8282
---
8383

@@ -1153,7 +1153,7 @@ SATI implements the [ERC-8004: Trustless Agents](https://eips.ethereum.org/EIPS/
11531153
| `tokenURI` / registration file || TokenMetadata.uri |
11541154
| On-chain metadata || TokenMetadata.additionalMetadata |
11551155
| **Reputation** | | |
1156-
| `feedbackAuth` || Replaced by dual-signature model (more secure) |
1156+
| `feedbackAuth` || Removed in Jan 2026 ERC-8004 spec; SATI uses dual-signature model (more secure) |
11571157
| `giveFeedback()` || Compressed attestation via Light Protocol |
11581158
| `revokeFeedback()` || close_compressed_attestation() |
11591159
| `appendResponse()` || FeedbackResponse schema (deferred) |
@@ -1167,18 +1167,34 @@ SATI implements the [ERC-8004: Trustless Agents](https://eips.ethereum.org/EIPS/
11671167
| DID support || additionalMetadata["did"] |
11681168
| CAIP-2/CAIP-10 || Chain-agnostic identifiers |
11691169

1170-
### Authorization Model Comparison
1170+
### ERC-8004 January 2026 Spec Update
1171+
1172+
The January 2026 ERC-8004 specification update **removed `feedbackAuth` entirely**:
11711173

1172-
ERC-8004 uses `feedbackAuth` (agent pre-authorizes client). SATI uses **dual-signature blind feedback**:
1174+
> "The new spec removes `feedbackAuth` entirely... leans harder on filtering by reviewer/clientAddress and off-chain aggregation for Sybil/spam mitigation"
11731175
1174-
| Aspect | ERC-8004 feedbackAuth | SATI Dual-Signature |
1175-
|--------|----------------------|---------------------|
1176-
| Authorization | Agent signs permission upfront | Agent signs with response (blind) |
1177-
| Selective blocking | Agent can refuse to authorize bad clients | Agent cannot refuse — signs before knowing outcome |
1178-
| Sybil resistance | None (authorized client can submit anything) | Both parties must sign same task_ref |
1176+
This means ERC-8004 now uses an **open feedback model** where anyone can submit feedback about any agent without the agent's involvement.
1177+
1178+
### Authorization Model Comparison
1179+
1180+
| Aspect | ERC-8004 (Jan 2026) | SATI Dual-Signature |
1181+
|--------|---------------------|---------------------|
1182+
| Agent authorization | None required | Agent signs with response (blind) |
1183+
| Proof of interaction | None | Cryptographic (task_ref = payment tx) |
1184+
| Sybil resistance | Off-chain filtering | Both parties must sign same task_ref |
1185+
| Selective participation | N/A (open model) | Blocked — agent signs before knowing outcome |
11791186
| Gas cost | Client pays | Agent pays (bundled into service) |
11801187

1181-
> **Note**: ERC-8004 PR #11 removes `feedbackAuth` entirely, moving to open feedback. SATI's dual-signature model provides stronger guarantees than either approach.
1188+
**Security implications:**
1189+
1190+
| Attack Vector | ERC-8004 (new) | SATI |
1191+
|---------------|----------------|------|
1192+
| Sybil boosting (fake positive reviews) | Possible | Blocked — requires agent signature |
1193+
| Competitor attacks (fake negatives) | Possible | Blocked — requires agent signature |
1194+
| Selective participation | N/A | Blocked — agent signs before knowing outcome |
1195+
| Proof of interaction | None | Cryptographic (task_ref = payment tx) |
1196+
1197+
SATI's blind feedback model provides stronger guarantees than ERC-8004's open model. The tradeoff is complexity: SATI requires agent participation in the signature flow.
11821198

11831199
### CAIP and DID Support
11841200

0 commit comments

Comments
 (0)