gitwtfhub

wtf is candor?

angrypacifist/candor — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · developerComplexity · 5/5Setup · hard

TL;DR

A simulated sports trading agent that publishes every bet to the Solana blockchain before the outcome is known, so its track record can be verified rather than trusted.

Mindmap

mindmap
  root((repo))
    What it does
      Paper trading
      On chain commits
      Settlement proofs
    Tech stack
      TypeScript
      Solana
      Node.js
    Use cases
      Verifiable track records
      Blockchain proofs
    Audience
      Developers
      Blockchain builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Study a real example of committing time-stamped decisions to a public blockchain for verifiability

REASON 2

Learn how to structure and prove trading claims using on-chain data

REASON 3

Explore a paper-trading agent that never touches real money but still produces a checkable track record

What's in the stack?

TypeScriptSolanaNode.js

How it stacks up

angrypacifist/candor0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardhardeasy
Complexity5/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1day+

Requires a Solana wallet, mainnet access, and integration with TxODDS live odds and settlement data.

Wtf does this do

Candor is an experimental sports trading agent built for a hackathon focused on trading tools and agents. It watches live sports odds and scores data, prices each betting line using its own model, and takes simulated trading positions based on a fixed strategy. The project uses no real money at all: the starting balance is fixed at 1,000 paper units and stays that way by design. What makes Candor different is how it proves its own track record. Every time it takes a position, it hashes the details of that decision, including the odds and the model's reasoning, and writes that hash to the Solana blockchain before the outcome of the match is known. This means the timing of each bet can be checked publicly and cannot be faked or backdated after the fact. When a match ends, Candor compares its position against official results that are also anchored on the blockchain, and publishes on chain proof that each position won, lost, or could not be verified. The project argues that self reported trading records are easy to fake, since screenshots can be edited and losing trades can simply be deleted. By committing every decision to a public blockchain before the result exists, and then proving the outcome the same way, Candor tries to make its history something anyone can verify rather than something they have to trust. Every number shown on its public dashboard is meant to be checkable against the on chain record. The strategy the agent trades with was tuned ahead of time on past matches and then frozen, with that freeze itself recorded on the blockchain so it cannot be quietly changed later. The project also keeps a sealed log of trades it considered but chose not to take. Full documentation covering the trust system, the trading strategy, and the underlying architecture is included in the repository's docs folder.

Yoink these prompts

Prompt 1
Explain how Candor hashes and commits a trading position to Solana before the match outcome exists.
Prompt 2
Walk me through Candor's validate_stat_v3 proof process for settling a position after a match ends.
Prompt 3
Help me understand the honesty protocol Candor uses so I could apply the same idea to my own project.

Frequently asked questions

wtf is candor?

A simulated sports trading agent that publishes every bet to the Solana blockchain before the outcome is known, so its track record can be verified rather than trusted.

What language is candor written in?

Mainly TypeScript. The stack also includes TypeScript, Solana, Node.js.

How hard is candor to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is candor for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.