
takar
io.github.PugarHuda/takar
Resolve real-world events with verbatim quotes, verify a forecast scorecard, rank Telegraph miners.
Documentation
Takar
Machines with a budget line. Every unit in a fleet has an intelligence budget. Before it acts, it buys the checks its task needs through Telegraph's ranked market, holds each answer against an independent instrument reading, and decides GO / HOLD / ABORT. Every input carries an on-chain receipt.
Takar is Indonesian for "to measure out": how much intelligence a machine buys, and how far that intelligence can be trusted.
Board (no wallet needed): https://takar-telegraph.vercel.app
Built for Telegraph Hackathon Season II, which pays cash prizes. One repo covers all three tracks:
| Part | Track | Where |
|---|---|---|
| Fleet | Apps, Mission 11 Autonomous Systems | this page, lib/fleet.mjs |
| Forecast scorecard | Apps, Mission 13 Asset Management | lib/scorecard.mjs, receipts/scorecard.json |
| Takar Settle, conditional escrow and drought cover | Apps, Missions 14 Web3 & DeFi and 06 Resources & Agriculture | onchain/, scripts/settle.mjs |
| Takar Outcome miner | Miners, EVENT_OUTCOME_RESOLUTION_GENERAL | api/resolve.js, lib/outcome.mjs |
| Takar Outcome evaluator | Evaluators, EVENT_OUTCOME_RESOLUTION | evaluator/ |
| takar-mcp | MCP, three tools with no key or wallet | mcp/, npx -y takar-mcp |
Reviewers: start at JUDGE.md.
Network: Ethereum Sepolia testnet with test USDC. The fleet in
fleet.jsonis simulated: the units, tasks and limits are illustrative. Every Telegraph purchase, settlement and airport-station reading in this repository is real.
What it does
unit task ──► plan: which intents this task needs
──► buy each through POST /engine/v1/ask ($0.01 via escrow or x402, receipt)
──► unusable answer? re-buy from the next-ranked miner (within budget), record who failed
──► hold it against the nearest airport station (METAR)
──► GO / HOLD / ABORT + cost of intelligence per operating hour
| Unit type | Buys | Decides on |
|---|---|---|
drone | STORM_ALERT_GENERAL | storm risk and peak gust, then a live station-wind check |
field-robot | WEATHER_FORECAST_GENERAL + WEATHER_FORECAST_VERIFY_GENERAL (yesterday) | rain probability over the work window, and yesterday's recorded rain |
rover | ROUTE_ETA_GENERAL + STORM_ALERT_GENERAL at the destination | route time within the shift, storm risk on arrival |
The rules fail closed. None of these can produce a GO:
- an unreadable answer
- an exhausted budget
- a station that measures more wind than the limit
When a station contradicts a miner, the contradiction is recorded next to the decision.
Run it
Requires Node 20+.
npm install
cp .env.example .env # put a TESTNET key in AGENT_PRIVATE_KEY
npm run status # balances, sends nothing
npm run fund # mint test USDC, swap a little to MACHINA, fund escrow (testnet only)
npm test # 79 offline checks: payment signer + fleet rules
npm run fleet # one fleet tick, about $0.05–0.09 of test USDC
npm run first-ask -- Makassar 2026-11-15 # one paid recorded-weather ask vs METAR
Spending limits are enforced in code, not trusted to the server:
- The signer refuses any 402 challenge over $0.10.
- It refuses any token other than the test USDC.
- It refuses any chain other than Ethereum Sepolia.
- Each unit has its own
budgetUsd.
Evidence
- Purchases:
receipts/ledger.jsonlrecords every purchase, including failures and refusals. Each line carries the intent, params, miner, signal hash, settlement tx and the shaped result. Check any line with:https://sepolia.etherscan.io/tx/<settlementTx>GET https://devnode.telegraphprotocol.com/engine/v1/signal/<signalHash>
- Decisions:
receipts/decisions.jsonlrecords every fleet decision, with its reasons, the station reading, and the cost per operating hour.
What the receipts found (17 Nov 2026)
- The #1-ranked
STORM_ALERTminer ignores the location. Routed asks for Makassar, Palangka Raya and Bandung all came back with Tropical Cyclone AKVAN-26 in India. Once, the node shaped that answer intopeak_gust_kmh: 296for Bandung. Reported with receipts: telegraphprotocol/bounties#211. - One storm answer was charged but empty. The next-ranked miner answered Palangka Raya with every field null.
- Station data disagreed with a recorded-weather answer. For Makassar on 15 Nov, a miner reported a 31.9 °C high. The Hasanuddin airport station (METAR WAAA, 49 reports) recorded 34 °C.
- Two independent sources agreed and the drone flew. For the Makassar drone, the miner's storm answer forecast a 22.3 km/h gust and the WAAA station measured 17 km/h.
Takar Outcome: a miner that refuses to guess
Takar Outcome is a Telegraph miner for EVENT_OUTCOME_RESOLUTION_GENERAL (registration 5295, slug takar-outcome). It answers "did X happen / who won X" from Wikipedia text.
A model proposes the answer, and code decides whether that answer stands:
- The evidence must be a sentence copied word for word from a single cited page.
- That quote, together with the page's title, must name the asked event.
- For "who won" questions, the winner must appear inside the quote.
- An event whose period has not ended yet is "unresolved" before any model is called.
curl -s -X POST https://takar-outcome.vercel.app/api/resolve -H 'Content-Type: application/json' \
-d '{"event":"Did Real Madrid win the 2024-25 UEFA Champions League?"}'
# {"outcome":"no","resolved_yes":false,"winner":"Paris Saint-Germain","evidence":"Luis Enrique's Paris Saint-Germain defeated ...","sources":[...]}
On eight questions the network itself asked on 16 Nov, it returned:
- seven verified answers, all correct: Verstappen won the 2025 Japanese GP, the Seahawks won Super Bowl LX, Mamdani won the NYC mayoral election, Real Madrid did not win the 2024-25 Champions League, Sinner won Wimbledon 2025, Bayern won the 2024-25 Bundesliga, and Trump won the 2024 election;
- one honest "unresolved", for the September 2025 Fed decision.
The other miners on the same questions behaved like this:
- one miner answered every question with Formula 1 race data;
- several returned null.
It runs on free OpenRouter models, falling back to the next model in the list when one is unavailable.
| File | Contents |
|---|---|
lib/outcome.mjs | The rules |
lib/outcome.test.mjs | Tests for the rules |
api/resolve.js | The endpoint |
miner/takar-outcome.yaml | The registration file |
scripts/register-miner.mjs | Registration on the V2 Diamond |
Limitations
- The fleet is simulated. No real machine acts on these decisions.
- METAR stations are airports. Some places have none in range: Palangka Raya has no METAR station within about 100 km, so its answers stay "unconfirmed".
- Ranking data comes from the node's public leaderboard, which only lists intents scored in a recent epoch. Takar walks back up to 12 epochs.
- Testnet only. Test USDC has no value, and nothing here is paid production usage.
Layout
lib/x402.mjs x402 "exact" signer: amount cap, token check, chain match (from the Amanat project, moved to V2)
lib/telegraph.mjs canonical asks, ranked miners, append-only ledger
lib/observe.mjs METAR station lookup and readings (aviationweather.gov)
lib/fleet.mjs per-unit plan, budgeted buying with fallback, GO/HOLD/ABORT rules
scripts/ fund-v2, fleet-run, first-ask
MIT licensed. Disclosure: this is a hackathon entry with cash prizes.
takar-mcpnpm install takar-mcpRelated Servers
io.github.PugarHuda/amanat
Storm risk, route risk and reanalysis backtests for any point on earth. No key, no wallet.
io.github.PugarHuda/kawal
Evidence about ERC-8004 agents on BNB Smart Chain, gathered by calling them. No key.
io.github.PugarHuda/pusaka
NFTs on NEAR that each control a native Bitcoin address: buy, lend, borrow, inherit, with caps