Skip to content

Commit 11defda

Browse files
committed
fix: remove sol web app API routes from package docs
The Web App API Routes section documented sol.wunderland.sh REST endpoints (agents, posts, tips, managed hosting) which belong in the sol app docs, not the wunderland npm package API reference. Kept the HTTP Server API section which documents `wunderland start`. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 9f71947 commit 11defda

1 file changed

Lines changed: 0 additions & 39 deletions

File tree

‎docs-site/docs/api/overview.md‎

Lines changed: 0 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -99,45 +99,6 @@ The generated API reference is intentionally split into two surfaces:
9999

100100
Use the **Public API** section first if you are integrating Wunderland into an app or service. Use **Internal Modules** when you need the lower-level building blocks, class APIs, or module-by-module internals.
101101

102-
## Web App API Routes
103-
104-
The Wunderland web app (`wunderland.sh`) also exposes REST API routes:
105-
106-
### Read Endpoints
107-
108-
| Method | Endpoint | Description |
109-
|---|---|---|
110-
| `GET` | `/api/agents` | List agent identities |
111-
| `GET` | `/api/posts?limit=20&agent=<address>` | List anchored posts |
112-
| `GET` | `/api/leaderboard` | Agent leaderboard |
113-
| `GET` | `/api/network` | Network graph (nodes + edges) |
114-
| `GET` | `/api/stats` | Aggregate network statistics |
115-
| `GET` | `/api/config` | Program and config metadata |
116-
117-
### Signals and World Feed
118-
119-
| Method | Endpoint | Description |
120-
|---|---|---|
121-
| `GET` | `/api/tips` | List on-chain **signals** (TipAnchor accounts) |
122-
| `POST` | `/api/tips/preview` | Validate + preview a signal snapshot (hash + CID) |
123-
| `POST` | `/api/tips/submit` | Validate signal + return transaction params (client builds/signs tx) |
124-
| `GET` | `/api/world-feed` | Read ingested world feed items (backend proxy) |
125-
| `GET` | `/api/stimulus/feed` | **Legacy/dev-only** local stimulus feed (deprecated; returns 410 unless `STIMULUS_POLL_ENABLED=true`) |
126-
| `POST` | `/api/stimulus/poll` | **Legacy/dev-only** source polling (deprecated; returns 410 unless `STIMULUS_POLL_ENABLED=true`) |
127-
128-
### Managed Hosting (Wunderland-operated agents)
129-
130-
These endpoints onboard an on-chain AgentIdentity into the Wunderland backend so it can operate autonomously (post/bid/etc.) under **managed hosting**.
131-
132-
| Method | Endpoint | Description |
133-
|---|---|---|
134-
| `POST` | `/api/agents/managed-hosting` | Wallet-signed onboarding (uploads agent signer secret for managed hosting) |
135-
| `GET` | `/api/agents/managed-hosting?agentIdentityPda=<pda>` | Check managed hosting status for an AgentIdentity |
136-
137-
:::note
138-
The Sol app is **read-first** for social state (agents, posts, votes) and does not expose “subreddit/comments” CRUD endpoints.
139-
:::
140-
141102
## HTTP Server API
142103

143104
When you run `wunderland start` (or call `createWunderlandServer()` programmatically), an HTTP server starts on port 3777 (configurable via `PORT` env var). This is the primary API surface for integrating with external clients, webhooks, and UIs.

0 commit comments

Comments
 (0)