How Token Trail works.

Real coordinates

Every active drop resolves to one street coordinate. The live map and claim API use the same server-side position.

Claim gate

The default geofence is 45 metres. High GPS error is rejected. A movement sanity check makes obvious teleporting harder.

On-chain transfer

Live mode requires a funded vault and CLAIM_SIGNER_KEY. The API signs a short-lived EIP‑712 voucher; the smart contract verifies it before transferring the ERC‑20.

Street respawn

A successful transaction is verified through the Robinhood Chain receipt. Then the drop index changes to a different route in that same city. With Upstash Redis configured, the new street persists across Vercel instances.

Add a point

Public submissions are stored as pending. Set POINT_ADMIN_KEY in Vercel and use the same code on the Add a Point page to activate a submitted location immediately.