Reference
The shaded jar is mcp-tx-proxy/target/tx-engine.jar. The entrypoint is org.atp.proxy.TxEngineMain.
| Command | What it does |
|---|---|
demo --port 8080 | Serves the operations console and POST /mcp. Same process as serve. |
stdio | Reads one JSON-RPC object per line and writes one response per line. |
keys | Prints a new Ed25519 public key, then the private key, both base64. |
sign --kid --private --payload | Signs a manifest payload file. |
replay --tx --wal-dir --sandbox --up-to-step | Walks a recorded transaction. --sandbox is required. |
chaos --out file.csv | Writes the recovery comparison. Parent directories are created. |
| Variable | Effect |
|---|---|
ATP_JDBC_URL | Journal in JDBC. H2 and PostgreSQL are on the classpath of the shaded jar. |
ATP_JDBC_USER | JDBC user. Empty when unset. |
ATP_JDBC_PASSWORD | JDBC password. Empty when unset. |
ATP_WAL_DIR | File journal, used only when no JDBC URL is set. Writes wal.bin and wal.anchor. |
GET / — the operations console.POST /mcp — JSON-RPC. One SSE event when Accept contains text/event-stream.GET /api/ledger — the hash chain wrapped as a tx/ledger result.POST /api/demo/rollback — the three-step failure, transaction ui-rollback.POST /api/demo/approve-setup — parks send_wire. Send {"txId":"ui-wire-1"} or omit it to reuse ui-wire.POST /api/demo/decision — body {"txId","decision"} with APPROVE, REJECT, or RETRY.mvn -B verify cd sdks/python python -m coverage run --source=agent_tx -m pytest python -m coverage report --fail-under=100
Java 21 is required. mvn verify fails unless JaCoCo reports a line-coverage ratio of 1.00 for the engine, the proxy (the process entrypoint is excluded), and the Java SDK.