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(x402): explain why loop payments re-read the blockhash before signing

nirholas275de8599d3f
diff --git a/docs/x402-ring-economy.md b/docs/x402-ring-economy.md
index 37f4e6391..20973d7bc 100644
--- a/docs/x402-ring-economy.md
+++ b/docs/x402-ring-economy.md
@@ -240,6 +240,13 @@ inline path still built with nonce 0, and its $0.001 health, volume and
canonicalize entries collided 51 times in 20 minutes. `tests/x402-payment-nonce-guard.test.js`
now fails any `buildPaymentTx` call under `api/` that does not name a nonce.
+The same tick-wide blockhash also expires: a loop tick runs its entries in
+sequence for up to about four minutes, and a hash is valid for about 60 seconds.
+The loop and its pipelines therefore sign with `currentBlockhash(conn, blockhash)`
+from `pay.js`, the freshness cache `payX402()` uses, which re-reads the hash once
+it is 20 seconds old. Before 2026-09-30 the later entries of a long tick died at
+broadcast with `BlockhashNotFound` (16 in 90 minutes).
+
### Fee floor, enforced — ceiling + continuous audit
The floor is not just a default; it is guarded on both the write and the read