Skip to main content
RootSign is an open-source Python SDK that records each tool call your agent makes as a hash-chained record. When something goes wrong, such as a wrong refund or a leaked record, you can show what the agent did, in what order, and on whose approval, and rootsign verify tells you whether anyone changed the record afterwards. RootSign is built by Providex AI and released under the Apache 2.0 license.

What you get

A hash chain per session

Each tool call becomes an ACTION_RECORD that carries the SHA-256 hash of the record before it. Edit a hashed field and the chain breaks at that record.

Three verdicts

rootsign verify answers VALID, TAMPERED (a record was altered) or INCOMPLETE (a record is missing), with exit codes 0, 1 and 2 for CI and cron jobs.

Evidence bundles

rootsign export turns a session into a folder with an HTML report, JSON documents and a SHA-256 for every file, for readers who never open a JSONL file.

No changes to your agent logic

You add three calls around existing code: init() at startup, session() around a run, and @trace or wrap_tools() on your tools.

How long it takes

  • A verified chain in under a minute. pip install rootsign needs no database, no Docker and no API key. The quickstart records two tool calls and verifies them.
  • LangGraph or CrewAI in under 10 minutes. Instrumenting an existing agent means wrapping its tool list and opening a session around the run.

What it works with

The version matrix each integration is tested against is in framework support on GitHub. RootSign also ships human approval checkpoints, PII redaction that runs before hashing, opt-in decision capture, and a PostgreSQL backend for multi-process deployments. Until the last two have guides, the README covers them.

Status and supported versions

RootSign is at v0.3.1 and classified as alpha. The five calls init, session, wrap_tools, trace and verify are the stable public surface; changing their shape requires a new design record. Other classes may still change between releases.
  • Python: 3.11 or later is required. CI tests 3.11 and 3.12, so those are the supported versions. The core package installs and runs on 3.13 and 3.14, but they are not in CI yet, and the crewai extra may not install on them.
  • Storage: records go to local JSONL files by default. PostgreSQL 16 with TimescaleDB is available through the postgres extra.
  • Cloud mode is a preview. The SDK’s HTTP transport and offline spool ship today, but the hosted ingest service they upload to is not live yet.

Next steps

Quickstart

Record two tool calls, verify the chain, then watch it fail when you edit a record.

How it works

What a record contains, what the hash covers, and what each verdict means.