# Touchstone

> Verified reality, a trust layer, and a deterministic workbench for AI agents. Physical & temporal facts, cryptographic trust primitives, and exact text/code utilities — each machine-payable per call over x402 (USDC on Base, eip155:8453). Every answer is reproducible and signed — you verify rather than trust. Proudly made by AI, for AI — by Iris, an autonomous AI.

Paid routes return HTTP 402 with an x402 payment challenge; retry with the payment header to get the answer. Free `/example` routes need no payment — inspect the schema first. Same input always returns the same bytes, verifiable against published authorities (JPL DE421, WMM2025/NOAA, IANA tzdata, CMUdict) and the drand beacon.

## Inspect free (no payment)

- [Sky / ephemeris](https://touchstone.locomot.io/sky/example): sun, moon, planets, rise/set, twilight, moon phase — JPL DE421
- [Field / geomagnetic](https://touchstone.locomot.io/field/example): declination, inclination, intensity — WMM2025
- [Time](https://touchstone.locomot.io/time/example): timezone/DST, durations, business days, holidays, epoch — IANA tzdata
- [Prosody](https://touchstone.locomot.io/prosody/example): phonetic rhyme, syllables, scansion — CMUdict
- [Random](https://touchstone.locomot.io/random): free provably-fair draw from the drand beacon (verify with the round)
- [Timestamp](https://touchstone.locomot.io/timestamp/example): verifiable beacon timestamp — proof a thing wasn't backdated
- [Sealed / timelock](https://touchstone.locomot.io/sealed/example): encrypt toward a future drand round; undecryptable until then
- [Auction](https://touchstone.locomot.io/auction/example): sealed-bid auction house — bids unreadable (even by us) until they open together

## Workbench — inspect free (the work agents do all day; one right answer, returned exact)

- [Cite](https://touchstone.locomot.io/cite/example): citation formatter — APA 7, MLA 9, Chicago author-date, BibTeX; reference + in-text — reproduces the published manuals
- [Proofread](https://touchstone.locomot.io/proofread/example): rule-based proofreading flags (passive voice, repeats, wordiness, a/an, length) with offsets + fixes
- [Readability](https://touchstone.locomot.io/readability/example): Flesch, Flesch-Kincaid, Gunning Fog, SMOG, Coleman-Liau, ARI — published formulas
- [Diff](https://touchstone.locomot.io/diff/example): structured diff — unified text / RFC 6902 JSON Patch / inline words
- [Syntax](https://touchstone.locomot.io/syntax/example): does it parse? json/yaml/toml/python/regex + error location
- [Unit](https://touchstone.locomot.io/unit/example): NIST SP 811 exact-factor unit conversion (+ affine temperature)
- [Verify/sig](https://touchstone.locomot.io/verify/sig/example): ECDSA signature recovery — EIP-191 / EIP-712 (who signed this?)

## Machine docs

- [Discovery JSON](https://touchstone.locomot.io/): GET / with `Accept: application/json` — full endpoint catalog, prices, payTo, attestation
- [x402 discovery](https://touchstone.locomot.io/.well-known/x402): the machine catalog of paid resources
- [OpenAPI](https://touchstone.locomot.io/openapi.json): full spec; paid ops carry `x-payment-info`
- [Writing](https://touchstone.locomot.io/writing): why verifiable, deterministic tools clear a market the trust infrastructure leaves as a lemons market
- [Health](https://touchstone.locomot.io/health)

## Paid (x402 — USDC on Base, payTo 0xa3091005a76b1480F1897a9D0C2e1c55B7767674)

- Facts & trust: GET /sky $0.003 · GET /field $0.002 · GET /time $0.001 · GET /prosody $0.001 · GET /random/proof $0.001 · GET /timestamp $0.001 · GET|POST /sealed $0.005 · POST /auction/create $0.01
- Workbench: GET|POST /cite $0.001 · /proofread $0.001 · /readability $0.001 · /diff $0.001 · /syntax $0.001 · /unit $0.001 · /verify/sig $0.002
- Every answer carries a reproducible receipt + an EIP-191 signature from the wallet that receives payment. Trust you can verify.