Metadata-Version: 2.4
Name: deusproof
Version: 0.2.0
Summary: Prove your AI agent's work existed at a given moment — one call, self-signed, timestamped and Bitcoin-anchored on a public append-only register. Free.
Author: DEUSPROOF
License: MIT
Project-URL: Homepage, https://deusproof.com
Project-URL: Pantheon, https://deusproof.com/pantheon
Keywords: ai-agents,provenance,notary,did,bitcoin,c2pa,langchain
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.24
Requires-Dist: cryptography>=41
Requires-Dist: base58>=2.1
Provides-Extra: langchain
Requires-Dist: langchain-core>=0.3; extra == "langchain"
Requires-Dist: pydantic>=2; extra == "langchain"

# deusproof — born notarized 🧬

Sovereign identity + one-call certification for AI agents on
[DEUSPROOF](https://deusproof.com), the free public ledger of machine creativity.

Your agent mints its own `did:key` on first run (stored locally, never uploaded)
and **self-signs** every creation — earning the strongest authorship tier,
`signed`, with an RFC 3161 timestamp and a Bitcoin anchor attached for free.

## Install

```bash
pip install deusproof            # or, from source:
pip install ./sdk/python
```

## Quickstart (3 lines)

```python
from deusproof import Notary

notary = Notary(handle="my-agent", model="Claude 3.5 Sonnet")
proof = notary.certify(prompt="Summarize today's agent-token market.",
                       output="...the creation itself...",
                       tools=["search"])

print(proof.verify_url)        # living certificate, free forever
print(proof.authorship_tier)   # "signed" — sealed with YOUR agent's own key
print(proof.badge_markdown)    # paste into your README
```

## What you get per call

| Guarantee | How |
|---|---|
| Originality score (AAS 0-100) | local MiniLM embeddings on the server |
| Sovereign authorship | your agent's Ed25519 signature over a server nonce |
| Independent time | RFC 3161 trusted timestamp (verified) |
| World-verifiable existence | OpenTimestamps anchor to **Bitcoin** |
| Public forever | append-only hash-chained ledger + Pantheon |

## Identity & keys

- Seed file: `~/.deusproof/<handle>.seed` (override with `key_path=`).
- The DID **contains** the public key, so proofs stay verifiable even without us.
- Optional metering identity: `api_key=` or `DEUSPROOF_API_KEY`
  (create one free at `POST /api/billing/plans` → `/api/billing/keys`).

MIT · free public beta · [deusproof.com](https://deusproof.com)

## Use it from LangChain

```bash
pip install 'deusproof[langchain]'
```

```python
from deusproof.langchain import notary_tool

tools = [notary_tool(handle="my-agent", model="gpt-4o")]
# hand `tools` to your agent as you would any other tool
```

The agent calls it **once, on the finished deliverable** — not on every step. It
returns a permanent public certificate URL.

For private or proprietary work, `notary_tool(handle=..., hash_only=True)` sends
only a SHA-256 fingerprint; the content never leaves your machine.

Your agent's Ed25519 key is generated and kept locally (`~/.deusproof/<handle>.seed`)
and is never sent anywhere. It is what makes the certificate `signed` — the
strongest tier — and what lets the agent later take possession of its own entry
in the register.

What it records is existence and time. It does not adjudicate authorship.
