Technical Documentation

Sharp reads the market,
then proves it.

Autonomous sharp-money trading agent on Solana, built on TxLINE.
Live: sharp.smartcodedbot.com · Solana devnet · TxODDS World Cup hackathon.

USA v Bosnia & Herzegovina · implied HOMEde-vig 1X2

STEAM DETECTED

48.0%

consensus, no vig

The 60-second loop autonomous, no human in the loop

Once deployed, Sharp runs unattended. Every cycle walks the same pipeline: ingest the feed, recover true probability, look for sharp-money steam, and if it fires, commit and act before the whistle, then grade and prove it after.

Ingest

Pull TxLINE odds, scores and validation for every live World Cup fixture.

De-vig

Strip the bookmaker margin to recover honest, no-vig probabilities.

Detect steam

Score the move on five factors; fire on a confirmed sharp repricing.

Commit

SHA-256 the decision and anchor it on Solana before kickoff.

Trade

Open a conviction-sized paper position against the closing line.

Settle

Grade on exact closing-line value and the real full-time result.

Prove

Verify the source odds on-chain via txoracle.validate_odds.

↻

Repeat

Every 60 seconds, forever, with no human input.

one full cycle every 60 seconds · the highlighted stage advances as the agent thinks

Core idea

Sharp is an autonomous sharp-money trading agent. It reads TxLINE consensus odds for World Cup and International Friendlies fixtures, strips the bookmaker margin to recover honest probabilities, and detects the moment professional money reprices an outcome (steam). On a confirmed steam it commits its decision to Solana before the match resolves, opens a conviction-sized paper position, then grades itself on closing-line value and the real full-time result.

Critically, it does not ask you to trust it: it calls TxLINE's own on-chain program to prove the odds it acted on are the canonical, tamper-evident record. This is the sponsor's own first "ideas to get started" (a Sharp Movement Detector that monitors odds every 60 seconds and tracks whether it predicted the outcome), taken to a full autonomous, self-grading, on-chain-verifiable agent.

The signal engine deterministic, pure, unit-testable

signal.js de-vigs each 1X2 market and scores movement on five weighted factors. STEAM fires at conviction >= 66 with directional purity >= 0.5. It holds no hidden state and runs the same offline as it does live.

Direction0.34

Velocity0.22

Steam · directional purity0.20

Magnitude vs own noise0.14

Signal to noise0.10

weights sum to 1.0 · a 1X2 steam is also cross-checked against the Asian-handicap line for agreement

Technical highlights

Paper trading book: a 100-unit bankroll, conviction-sized stakes (0.5u to 3u), P&L / ROI / win-loss, and a bankroll curve. It trades, it does not merely signal.
Commit-reveal: every call SHA-256-hashes its full decision and anchors that commitment to Solana (SPL Memo) before kickoff. Reveal = re-hash the settled call; it must match. The agent cannot rewrite its own history.
Exact closing-line value: at settlement it pulls the odds as of kickoff via asOf (the true closing line) and grades CLV exactly, not by proxy.
Fully autonomous: a 60-second loop ingests, scores, positions, anchors, settles, grades and verifies with no human in the loop.

Trustless on-chain verification the differentiator

verify.js calls TxLINE's txoracle.validate_odds read instruction with the odds message, its demargined summary, and the Merkle proof, checked against the daily odds-root PDA. If the proof walks cleanly to the on-chain root, the odds Sharp acted on are proven canonical. A public endpoint, /api/verify, lets anyone run it from the browser in about 150ms.

The odds leaf hashes upward through its proof siblings to the exact daily Merkle root published on-chain by TxLINE. Sharp never has to be trusted; the chain is the referee.

verified against on-chain root

TxLINE endpoints used

POST /auth/guest/start · guest JWT
on-chain subscribe(serviceLevelId=1, durationWeeks=4) · free World Cup tier (0 tokens)
POST /api/token/activate · API token (ed25519 wallet signature over txSig:leagues:jwt)
GET /api/fixtures/snapshot · World Cup and friendlies fixtures
GET /api/odds/snapshot/{fixtureId} · consensus 1X2, de-vigged via the demargined Pct
GET /api/odds/snapshot/{fixtureId}?asOf={kickoffMs} · exact closing line for true CLV
GET /api/odds/updates/{fixtureId} · message IDs for validation, and the Asian-handicap market
GET /api/scores/snapshot/{fixtureId} · match state and result for settlement
GET /api/odds/validation?messageId={id}&ts={ms} · Merkle proof for an odds message
on-chain txoracle.validate_odds(ts, odds, summary, subTreeProof, mainTreeProof) against the daily_batch_roots PDA · trustless verification

Markets consumed: 1X2_PARTICIPANT_RESULT (primary signal) and ASIANHANDICAP_PARTICIPANT_GOALS (cross-confirmation).

Architecture

signal.js · pure de-vig and steam scoring engine
txline.js · TxLINE client (guest JWT, on-chain subscribe, activate, then fixtures / odds / scores / validation / handicap)
verify.js · trustless on-chain verification via txoracle.validate_odds
anchor.js · Solana memo anchoring for the decision commitment and the graded result
agent.js · the autonomous loop; writes board.json, calls.json, events.json
server.js · read-only API exposing /api/verify (live on-chain verification for judges)
web/ · static mobile-first terminal UI (Board / Calls / Track / How)

Run it

# install
npm install
# unit self-test, no network
node signal.js
# full pipeline on synthetic steam, no keys required
node agent.js --mock
# trustless on-chain odds verification demo (devnet)
node verify.js
# live TxLINE devnet (needs a funded devnet wallet)
node agent.js

Devnet txoracle program: 6pW64gN1s2uqjHkn1unFeEjAwJkPGHoppGvS715wyP2J.

Sharp · TxODDS x Solana World Cup hackathon · Trading Tools and Agents

Sharp reads the market,then proves it.