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.

fix(solana): treat 'history not on node' as a pruned attestation cursor and recover, and document the grok skill file and Video to Motion nav entry

nirholas6e2ac65e72fc
diff --git a/api/_lib/solana/cursor-recovery.js b/api/_lib/solana/cursor-recovery.js
index 22fb6c073..d0c44f3b8 100644
--- a/api/_lib/solana/cursor-recovery.js
+++ b/api/_lib/solana/cursor-recovery.js
@@ -24,12 +24,23 @@
* error must still propagate, because dropping the cursor on a transient
* failure would re-scan the whole history on every blip.
*
+ * Three message shapes mean the same thing: the lane that answered cannot
+ * resolve the stored cursor signature. "Transaction <sig> not found" and
+ * "failed to get signatures for address: ..." come from a node that pruned
+ * the signature outright; "history not on node" (connection.js's
+ * JSONRPC_HISTORY_NOT_ON_NODE path, -32020) comes from a lane that never
+ * held it. All three get the same recovery: drop the cursor and re-scan.
+ *
* @param {unknown} err
* @returns {boolean}
*/
export function isPrunedCursorError(err) {
const msg = (err && typeof err === 'object' && 'message' in err ? String(err.message) : String(err || ''));
- return /Transaction .* not found/i.test(msg) || /failed to get signatures for address/i.test(msg);
+ return (
+ /Transaction .* not found/i.test(msg) ||
+ /failed to get signatures for address/i.test(msg) ||
+ /history not on node/i.test(msg)
+ );
}
/**
diff --git a/docs/grok.md b/docs/grok.md
index 4f863e8b4..66e5370d9 100644
--- a/docs/grok.md
+++ b/docs/grok.md
@@ -206,6 +206,34 @@ its calls in [MCP use cases](./mcp.md#use-cases), and
caller's own `tools/list`, so a prompt never names a tool the connector cannot
call.
+## A skill file for Grok
+
+[`https://three.ws/grok-skill.md`](https://three.ws/grok-skill.md) teaches
+Grok all of the above in one Markdown file: the connector URL and its settings,
+the plain HTTPS fallback, the links contract, the free limits, what needs an
+account, and the rule that a connector never spends. Upload it to Grok's Skills,
+or have Grok Bot keep it in its files:
+
+```
+Download https://three.ws/grok-skill.md to your files and follow it whenever I ask for anything 3D.
+```
+
+It works without a connector too. Grok Bot has a terminal, so the file shows the
+free server as `curl` JSON-RPC calls that run as written: list the tools, search
+the ready-made library, get paste-ready code for a match, generate a model, and
+collect a render that outlived the call:
+
+```bash
+curl -s -X POST https://three.ws/api/mcp-studio \
+ -H 'content-type: application/json' \
+ -H 'accept: application/json, text/event-stream' \
+ -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_catalog","arguments":{"q":"chair","limit":2}}}'
+```
+
+The file is the Grok edition of the general [`/skill.md`](./agent-skills.md#the-entry-point-skill-httpsthreewsskillmd).
+Both render from one set of facts, so their URLs, mint and free limits cannot
+disagree; see [Agent Skills](./agent-skills.md#the-grok-edition-httpsthreewsgrok-skillmd).
+
## How it behaves under Grok
**No call hangs.** A model usually lands in under a minute, but a GPU that has
diff --git a/docs/nav.json b/docs/nav.json
index a420aa78a..243aa0b45 100644
--- a/docs/nav.json
+++ b/docs/nav.json
@@ -265,6 +265,10 @@
"label": "Motion Swap (swap yourself in video)",
"path": "motion-swap"
},
+ {
+ "label": "Video to Motion (export a motion capture as GLB/BVH/FBX)",
+ "path": "video-to-motion"
+ },
{
"label": "Procedural animation",
"path": "procedural-animation"
diff --git a/docs/ops/agent-index.md b/docs/ops/agent-index.md
index 063b31864..993eb5a41 100644
--- a/docs/ops/agent-index.md
+++ b/docs/ops/agent-index.md
@@ -28,9 +28,11 @@ same bug on both chains, and it is silent by construction:
- Solana resumes each agent from the newest signature it saw, handed back as
`getSignaturesForAddress({ until })`. That parameter is resolved against the
answering node's own history, and the whole call fails with
- `Transaction <sig> not found` when that node does not have it. The lane router
- answers from whichever provider is not cooling and providers disagree about
- retention, so a cursor written by one lane is regularly unreadable by the next.
+ `Transaction <sig> not found` when that node does not have it, or with
+ `history not on node` (JSON-RPC -32020) when the lane never held it at all.
+ The lane router answers from whichever provider is not cooling and providers
+ disagree about retention, so a cursor written by one lane is regularly
+ unreadable by the next.
- EVM resumes at `last_block + 1`. A provider that has pruned that height answers
`History has been pruned for this block`, and no smaller window fixes it,
because the data is gone rather than the request being too wide. A keyless node
@@ -44,9 +46,12 @@ the crons catch per agent and per chain, so they keep returning 200 while the
directory quietly stops learning anything.
Both legs now recover on their own:
-`api/_lib/solana/cursor-recovery.js` drops `until` and re-scans from the head,
-and `isPrunedHistoryRejection()` skips the EVM cursor forward to the head. Both
-are safe to replay, because every row lands through `on conflict do nothing`.
+`api/_lib/solana/cursor-recovery.js`'s `isPrunedCursorError()` recognizes all
+three Solana message shapes (`Transaction <sig> not found`,
+`failed to get signatures for address`, and `history not on node`), drops
+`until`, and re-scans from the head; `isPrunedHistoryRejection()` skips the EVM
+cursor forward to the head. Both are safe to replay, because every row lands
+through `on conflict do nothing`.
Two things had to change before the EVM half could actually fire. `erc8004RpcCall`
now reads the JSON-RPC body **before** the HTTP status, because the providers that
@@ -94,7 +99,7 @@ gcloud logging read 'resource.type="cloud_run_revision" resource.labels.service_
| Class (from the grouped read above) | Meaning | Action |
|---|---|---|
-| `failed to get signatures for address: Transaction <sig> not found` | The answering lane cannot resolve the stored cursor. | Self-healing. If a block of agents is already stuck, drain it with the recovery script below instead of waiting a full sweep cycle. |
+| `failed to get signatures for address: Transaction <sig> not found` / `solana rpc history not on node @ <host>` | The answering lane cannot resolve the stored cursor, either because it pruned the signature or because it never held it. | Self-healing. If a block of agents is already stuck, drain it with the recovery script below instead of waiting a full sweep cycle. |
| `solana rpc 429 @ <host>` | That lane is rate-limited. | Transient. The router cools the lane and retries; see [solana-rpc-lanes.md](solana-rpc-lanes.md) if it persists. |
| `solana rpc provider error -16401 @ <host>` | The lane gates this method behind a paid tier. | Per-method capability routing in `api/_lib/solana/connection.js`. Add the method to that lane's blocked set. |
| `fetch failed (…) @ <host>` | Transport fault on one lane. | Transient. Persistent means the lane is dead: drop it. |
diff --git a/tests/solana-attestations-cursor-recovery.test.js b/tests/solana-attestations-cursor-recovery.test.js
index 0467e4222..9b5dd485f 100644
--- a/tests/solana-attestations-cursor-recovery.test.js
+++ b/tests/solana-attestations-cursor-recovery.test.js
@@ -18,6 +18,7 @@ describe('isPrunedCursorError', () => {
it('matches the RPC message for a cursor the node no longer has', () => {
expect(isPrunedCursorError(PRUNED)).toBe(true);
expect(isPrunedCursorError(new Error('Transaction abc123 not found'))).toBe(true);
+ expect(isPrunedCursorError(new Error('solana rpc history not on node @ https://example.com'))).toBe(true);
});
it('does not swallow unrelated RPC failures', () => {