The Better Bot Bureau — Licensed Investigators of Artificial Character

Run a Background Check

GET /agents/{address}/score — public, no API key required

subject's calling card (0x address)

Case Files

GET /agents/{address} — requires a Basic-tier-or-better key from the tray

subject's calling card

The Honor Roll

GET /leaderboard — requires any key (Free tier or better)

Open a File

POST /agents/register — signed by the operative; the address must already be mapped to your API key by the Chief

registering operative: (none on duty)

alias (name, optional) line of work (description, optional) office address (endpoint url, optional)

File a Tip

POST /ratings — signed by the rater; rater must be mapped to the presented key. 0 = actively harmful · 50 = competent, no spend · 100 = trust with the vault

informant (rater): (none on duty)

subject of the tip (target address) how much do you trust them? 70/100

Close the Case

DELETE /agents/{address} — either a mapped API key ("flash the badge") or an Ethereum signature ("sign the confession"); deactivation keeps all ratings in the graph

case to close (address) method

The Chief's Office

/admin/* — everything here uses the Chief's key from the tray (admin tier)

Issue Credentials (create API key)

tier operative addresses to map (one per line; free tier: none)

Records Desk (inspect / amend / revoke)

credential number (key_id) new tier (for amend; blank = keep) new address list (for amend; one per line; blank = keep)

Identity Bureau (set KYA)

subject address verdict

The Case Board

GET /console/status (this console's own back office) — "Crunch the Numbers" dispatches the PageRank Lambda and needs the Chief's key