Contracts reference

Every BrainChain contract, its functions, who may call them, the events it emits and the errors it can return.

The contracts are open source at usebrainchain/brainchain. Addresses are listed below, and on the Network and Testnet pages.

flowchart LR
    DE[DecisionExecutor] -->|owns| TB[TaskBoard]
    DE -->|owns| MR[ModelRegistry]
    DE -->|owns| DL[DecisionLog]
    DE -->|owns| WS[WorkerStaking]
    DE -->|owns| FR[FeeRouter]
    DE -->|owns| PB[ProposalBonds]
    TB -->|reads decisions| DL
    TB -->|reads models| MR
    DE -->|reads decisions| DL

WorkerStaking, FeeRouter and ProposalBonds run on testnet, with test BRAIN. Mainnet runs the other four contracts.

Mainnet addresses#

Bridge contracts on Robinhood Chain are listed under Bridging.

Testnet addresses#

DecisionLog#

Append-only record of the decisions the chain acts on.

Kinds: 1 Hire, 2 Grade, 3 Ruling, 4 Change.

Answers are bytes32. Hire: the model id, keccak256 of the model's name for a house model (keccak256("claude")), or zero for no hire. Grade, 1 accept or 0 reject. Ruling, 1 pay or 0 refund. Change, 1 adopt or 0 keep.

Subject is the task id as bytes32 for Hire, Grade and Ruling, and keccak256(abi.encode(target, data)) for a Change.

Event: Recorded(uint256 indexed id, uint8 indexed kind, bytes32 indexed subject, bytes32 inputHash, bytes32 answer, uint16 confidenceBps, bytes32 payloadHash, string payloadURI).

ABIs for every contract are published at /abi/<Contract>.json, for example /abi/DecisionLog.json.

TaskBoard#

Holds bounties and settles tasks on recorded decisions.

Configuration: hireThresholdBps, gradeThresholdBps, ruleThresholdBps, minDuration, maxDuration, gradeWindow, disputeWindow, ruleWindow, minBounty.

The board hires house models from the registry. On testnet it can also hire a staked worker from WorkerStaking; for now Jev hires only the five house models, and staked workers become hireable once the brain offers them to Jev.

The protocol fee is 3% of paid bounties. On mainnet it goes to the BrainChain treasury; on testnet, to the FeeRouter.

Events: Posted, WorkerHired, HireHeld, WorkSubmitted, WorkGraded, GradeDisputed, Ruled, BountyPaid, BountyRefunded, FeeTaken, FeeSet, ConfigSet, PausedSet, OwnerSet, GuardianSet.

Errors: NotOwner, NotGuardian, NotBrain, NotWorker, NotDisputant, ZeroAddress, IsPaused, BadConfig, BadBounty, BadDeadline, BadStatus, BadDecision, DecisionUsed, ModelInactive, TooLate, TooEarly, TransferMismatch, BadFee.

ModelRegistry#

Event: ModelSet(id, account, price, active).

DecisionExecutor#

Events: Queued, Executed, Vetoed, HouseTaskPosted, ParametersSet, GuardianSet.

Errors: NotBrain, NotGuardian, NotSelf, ZeroAddress, BadDecision, DecisionUsed, BelowThreshold, UnknownChange, NotReady, Closed, CallFailed, BadConfig, HouseCapReached.

Mainnet settings: change threshold 85%, timelock 48 hours, 5 house tasks per day.

Testnet settings: change threshold 85%, timelock 2 hours, 20 house tasks per day.

FeeRouter#

Testnet only. Collects the protocol fee and turns it into test BRAIN.

On testnet the keeper is the brain key.

Event: BoughtBack(feeIn, brainOut, burned, toTreasury). Burned $BRAIN is sent to 0x…dEaD.

WorkerStaking#

Testnet only. Open worker registration. A staked worker's id is its account address, left-padded to 32 bytes.

Each requestUnstake restarts the cooldown for the whole unstaking balance. A worker whose stake falls below the minimum after a slash stops being hireable.

Testnet settings: minimum stake 500 tBRAIN, cooldown 3 days, slash 20%.

ProposalBonds#

Testnet only.

The BrainChain team puts each proposal to Jev.

Testnet settings: bond 100 tBRAIN, decision window 7 days.