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.

3.6 KB
Raw Blame
{
	"$comment": "Declared degradation contracts. Each one names an upstream, the fault to inject, and what the endpoint must still do. scripts/prove-brownout.mjs executes them against a live server and writes the verdicts to public/brownout.json, which /brownout renders. A contract whose fault never reached the code is reported as not_exercised, never as a pass: a green proof for a fallback nothing ran is worse than no proof at all.",
	"updated": "2026-08-27",
	"summary": "Every fallback below has been executed against a running server with the upstream it protects against genuinely broken.",
	"contracts": [
		{
			"id": "heatmap-survives-pump-throttle",
			"title": "The intel heatmap keeps its tiles when pump.fun throttles",
			"surface": "/intel",
			"endpoint": "/api/intel/heatmap",
			"query": {
				"limit": 6
			},
			"bust": {
				"param": "limit",
				"warm": 6,
				"attempt": 40
			},
			"warm": true,
			"break": {
				"intel-heatmap": "http:429"
			},
			"expect": {
				"status": 200,
				"tier": [
					"cache",
					"stale",
					"fallback"
				],
				"degraded": true,
				"exercised": [
					"intel-heatmap"
				],
				"jsonHas": [
					"tokens"
				]
			},
			"why": "pump.fun answers a burst with 429 far more often than it goes down, and the board is the whole page. The retry honours Retry-After and the last-good tier carries the tiles through what is left, so a throttle costs freshness rather than the page."
		},
		{
			"id": "coin-page-survives-coingecko",
			"title": "A coin page still renders when CoinGecko is rate limiting",
			"surface": "/coin/:id",
			"endpoint": "/api/coin/detail",
			"query": {
				"id": "avalanche-2"
			},
			"warm": false,
			"break": {
				"coingecko": "http:429"
			},
			"expect": {
				"status": 200,
				"degraded": true,
				"exercised": [
					"coingecko"
				],
				"jsonHas": [
					"coin"
				]
			},
			"why": "CoinGecko's keyless tier is shared per egress IP and throttles on its own schedule, which is why /coin/:id 502'd for hours on 2026-07-28. CoinPaprika supplies the profile and DefiLlama the price series, so a throttle costs the page its primary source and nothing else."
		},
		{
			"id": "holders-survive-a-dead-rpc-lane",
			"title": "Holder concentration survives a Solana RPC lane refusing",
			"surface": "/token/:mint",
			"endpoint": "/api/crypto/holders",
			"query": {
				"address": "FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump"
			},
			"warm": false,
			"break": {
				"solana-rpc": "http:429"
			},
			"expect": {
				"status": [
					200,
					503
				],
				"exercised": [
					"solana-rpc"
				]
			},
			"why": "Every lane in the rotation throttles at some point, and free lanes refuse specific call shapes outright. The rotation walks them, demotes a lane per method rather than benching it wholesale, and answers an idempotent read from its last-good body when the whole chain is down."
		},
		{
			"id": "token-page-survives-dexscreener",
			"title": "A token page still resolves when DexScreener is throttling",
			"surface": "/ca2x402",
			"endpoint": "/api/ca2x402/resolve",
			"query": {
				"mint": "FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump"
			},
			"warm": true,
			"break": {
				"dexscreener:tokens": "http:429"
			},
			"expect": {
				"status": [
					200,
					404,
					503
				],
				"exercised": [
					"dexscreener:tokens"
				]
			},
			"why": "One keyless read used to decide whether a token exists at all, so a throttle made a live token read as not found. It now retries behind a breaker with a last-known-good payload, and a definitive miss is reserved for cases where a source actually spoke."
		}
	]
}