What WORKS today (proven, live)
Comprehension- Any OpenAPI or docs surface → question-shaped tools; auth invisible to the agent, injected at call time. 14+ real specs validated; 0 expose an auth header.
- A draft spec recovered from a human docs page, with claims marked
VERIFIED/REFUTEDagainst reality rather than trusted. - PDA seed recovery from Anchor IDLs and from program source (proven on a no-IDL/Steel program), including recipes the IDL structurally drops or hides in accounts that travel only as remaining accounts.
- Auto-comprehend-on-pick: point at a project → a generated program config, differential-proven equal to hand-authored ground truth on 4 programs, plus an explicit measured overlay of what could not be derived from any public surface.
- Provenance on every edge, one canonical vocabulary. Surface graph:
EXTRACTED>DECLARED>INFERRED>CLAIMED→VERIFIED/REFUTED. Program graph:EXTRACTED/RECOVERED/FLAGGED. - Real recovered facts a coding agent cannot get from the surface: Meteora’s
base_factor4th seed (the deprecated 3-seed scheme silently derives the wrong pool), Pump.fun’sbonding_curve_v2(required, invisible in the IDL), a fee-recipient field resolved empirically by a refuting Receipt, the liquidity-bitmap bin-array walk (the naive heuristic fabricates dead accounts). - Cross-API correlation on declared value-domain joins, proven across three real APIs.
- Hosted and local MCP; scale-adaptive tool listing (full defs withheld above scale, recovered per tool on demand).
- Measured context cuts of −77% / −89% on two real specs, with first-call-correctness held. Bytes measured; tokens estimated.
find_start: intent → the right (program, instruction) start point, ranked, with a dependency-ordered derive plan, provenance on every account, declared preludes, and an honest no-start below the retrieval floor. See find_start.- The Scorecard (
gecko report) and the Playground.
-
The simulate→Receipt engine, live-proven twice on a surfpool mainnet fork (a
mainnet-backed snapshot, not mainnet), simulation only, $0, nothing signed or
broadcast:
CU numbers are measured per run and vary slightly with on-chain state; the stable claim is the side-by-side verdict. See The Receipt.
-
On mainnet: the engine repo’s ledger (
docs/mainnet-ledger.jsonl) holds 50 landed transactions as of 2026-09-01. Every row that records both a prediction and a charge matches to the compute unit. See A real transaction. -
The binding.
prepare_purchase,prepare_instructionandplan_swapon the hosted surface return the unsigned bytes, a receipt, and abindingover those exact bytes (binding_strength: exact, which covers the blockhash).verify_signed_transactionchecks signed bytes against it.submit_transactionre-verifies at exact strength, refuses without a binding, and rebroadcasts the same bytes until they confirm or the blockhash expires.
- A categorical corpus (
observed/reported/synthetic/simulatedtiers) plus an N-confirmed drift detector. Values-free by construction, and audited. - The
simulatedtier is wired end to end: the landing orchestrators and thesimulatetool take an explicitrecord_toopt-in (default: record nothing), andgecko driftreads the series back: categorical rows only, never a pubkey, amount, or log.
- Seven fail-closed layers: spec sanitizer · per-tool quarantine · image Skill Guard (rendered-pixel payloads, encoded-content rescan) · SSRF netguard · out-of-band auth-host anchoring · the signing gate that checks signed bytes against the receipt’s binding · an AST-enforced boundary that proves the landing layer contains no sign or send path.
NOT built yet (honest)
Nothing below is claimed anywhere else on this site.- The drift scheduler: re-simulation on a cadence. Today the series accrues only when runs happen.
- The TEE credential backend.
- Catalog breadth: 4,500 projects listed, seven program configs shipped (Pump.fun, Meteora, Jupiter, ORE, MetaDAO, Orca Whirlpool, let_me_buy). Non-Anchor generalization is proven once; wider coverage is open.
- Pump.fun sell round-trip, ORE claim, MetaDAO fund executable intents.
- The semantic/vector retrieval tier: deliberately OFF behind an evidence gate. It flips only on measured lexical recall failure, not fashion. One measured negative result on embeddings is on record.
- Cross-customer episodic pooling: tenancy is local-only until a consent/egress layer exists.
- Live x402 billing: stub by design.
What Gecko is not
Gecko is not the agent and not an orchestrator. It never signs and never holds a key. It does not build the transaction; an external builder does. It never proxies the data plane. The one thing it sends to a chain is signed bytes that verify at exact strength against a binding it issued (submit_transaction); without that binding it
refuses. It is not a payment rail and not a marketplace. It composes on MCP, x402,
and payment catalogs.
It does not verify that the data an API returns is true. It verifies that the call is
the right call and, on-chain, that the transaction would land.