wtf is black-box?

Black Box solves a specific trust problem with AI agents that act on a blockchain: you can see the transactions an agent makes, but not the reasoning behind them. This project records every decision an autonomous agent makes and permanently anchors proof of that decision on a blockchain called BOT Chain, so anyone can later replay the agent's full history using only public blockchain data, with no separate database needed. The system has three main parts. A smart contract, a small program that lives on the blockchain, lets an agent register its identity and stamp a unique fingerprint for each decision it makes. A recorder tool, written in TypeScript, packages each decision record and posts it to the blockchain in a special low-cost transaction format designed for storing larger pieces of data. A replay dashboard, a web page, then reads that history back, checks that each record's fingerprint and signature genuinely match what was stored on-chain, and shows a pass or fail result. If someone tampers with a record after the fact, the check fails and turns red. The project includes a live demo you can try in a browser without a crypto wallet, replaying over 65 recorded decisions from a sample agent that watches a trading price and decides whether to hold or send an alert. Running it yourself requires cloning the repository, installing dependencies with npm, and starting the dashboard, which reads directly from the public test version of BOT Chain. To run your own recording agent rather than just replay the demo, you need a small amount of free test cryptocurrency from a faucet and a private key for signing. The project is built with Solidity for its blockchain contract and TypeScript for its tools and dashboard, and it ships with a working set of automated tests for each part. It is released under the MIT license, and the whole approach depends on BOT Chain's fast, cheap transactions to make recording every single decision practical.