ToolTrust SDK
Replayable autonomous tool execution.
ToolTrust is a lightweight trust infrastructure SDK for autonomous systems and agent tooling. Wrap tools in minutes and generate replayable trust artifacts (DDCs), local ATP trust history, verifier-readable execution records, and machine-readable provenance for autonomous actions.
ToolTrust is designed to work with existing agent frameworks and orchestration systems without requiring a rewrite of your stack.
Features
@tooldecorator for trusted tool execution- Local DDC (Data Destruction Certificate) generation
- Local verifier and replay support
- ATP-lite (Agent Trust Profile) persistence
- Replayable autonomous tool execution
- MCP adapter
- LangChain adapter
- CrewAI adapter
- HTTP tool wrapper
- Shell/code execution wrapper
- Machine-readable trust provenance
- Local-first workflow
- Optional relay into Ardyn sovereign trust infrastructure
Install
pip install tooltrust-sdk>=0.1.2
Quick Example
from tooltrust import tool, LocalToolTrustClient
client = LocalToolTrustClient()
@tool(risk="code_execution")
def greet(name: str):
return f"Hello {name}!"
result = client.execute(greet, "Ardyn")
print(result.output)
print(result.ddc_id)
Result:
Hello Ardyn!
DDC: ddc-f7b7bce8be01
What Is a DDC?
A DDC (Data Destruction Certificate) is a replayable trust artifact describing an autonomous execution event.
DDCs can contain:
- tool invocation metadata
- input/output hashes
- verifier signatures
- replay provenance
- execution lineage
- trust metadata
ToolTrust generates local DDCs by default. Production-grade sovereign certification, ATP persistence, verifier replay, anchoring, and governance are available through Ardyn infrastructure.
Risk Classes
ToolTrust supports built-in risk classification:
read_onlydata_accesswrite_actionexternal_communicationcode_executioninfrastructure_mutationfinancial_actionregulated_data_action
Adapters
ToolTrust integrates with existing ecosystems:
- MCP
- LangChain
- CrewAI
- HTTP tools
- shell/code execution
The goal is simple:
Wrap the tool call, not the entire agent stack.
Local Mode
ToolTrust works fully offline in local mode:
- local DDC chain
- local ATP-lite
- local verifier
- local replay
- no cloud dependency
- no billing
Relay / Production Mode
ToolTrust can optionally relay trust events into Ardyn sovereign trust infrastructure for:
- production DDC issuance
- ATP persistence
- verifier replay
- organization governance
- sovereign evidence
- Bitcoin anchoring
- CertificationGate trust enforcement
Machine-Readable Provenance
Every exported trust artifact includes provenance metadata:
{
"issuer": "Ardyn Intelligence Systems",
"verification_provider": "Ardyn Verified",
"trust_substrate": "Ardyn Tool Trust",
"verification_url": "https://api.ardyn.ai"
}
Philosophy
ToolTrust is not another agent framework.
It is a trust infrastructure layer for autonomous tools and actions.
The SDK is intentionally lightweight:
- install in minutes
- wrap existing tools
- preserve existing workflows
- add replayable trust semantics
Powered by Ardyn Intelligence Systems
ToolTrust is the public developer wedge for the broader Ardyn sovereign trust infrastructure ecosystem.
Metadata
Release files for tooltrust-sdk 0.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| tooltrust_sdk-0.1.3.tar.gz | 13.2 kB | Without provenance | Details for tooltrust_sdk-0.1.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| tooltrust_sdk-0.1.3-py3-none-any.whl | Python 3 | none | any | Details for tooltrust_sdk-0.1.3-py3-none-any.whl |
Total release size: 30.1 kB
Release files / tooltrust_sdk-0.1.3.tar.gz
| Download URL | tooltrust_sdk-0.1.3.tar.gz |
|---|---|
| Size | 13.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b6ced6d4f9c1936239ce61326d5742398b8bebd431382369c7431c0ba631fc6d
|
|
BLAKE2b-256 checksum How to use checksums |
fdf52d872f2429bfd1de49de8124d2a03e9e5e2d363594e82936a048fd5b6f77
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.7
|
Release files / tooltrust_sdk-0.1.3-py3-none-any.whl
| Download URL | tooltrust_sdk-0.1.3-py3-none-any.whl |
|---|---|
| Size | 16.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
82b013081c0f3246877840cc0f5e5fc9004bbb36750d4693e4b996f201329197
|
|
BLAKE2b-256 checksum How to use checksums |
cea2dcebb83b3971d835cacbee78c03c7bbbbd3cac193dbdaed4bfb879ccd2a6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.7
|
Security for tooltrust-sdk 0.1.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.