Metadata-Version: 2.4
Name: svtp-sdk
Version: 1.0.0
Summary: Official SVTP v1.0 Python SDK - Transparent Proxy Wrapper for AI Agents.
Home-page: https://github.com/Sovereign-AG/sovereign-core
Author: Sovereign AG
Author-email: office.sovereign.ag@gmail.com
License: SVTP Source-Available License v1.0
Classifier: Programming Language :: Python :: 3.11
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Security :: Cryptography
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.25.0
Requires-Dist: cryptography>=41.0.0
Requires-Dist: pydantic[dotenv]>=2.0.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 🛡️ SVTP SDK: Transparent Proxy Wrapper (v1.0.0)
# Standard: NIST 2026 High-Authority Agentic Trust

The `svtp-sdk` provides a **1-Line Integration** for any class-based AI agent (CrewAI, LangGraph, AutoGen, etc.). It acts as a high-performance transparent proxy, enforcing global governance, auditability, and behavioral attestation without modifying your agent's core logic.

---

## 🏗️ Installation (Quickstart)

Install the SDK directly into your agentic workspace:

```bash
# Install the SVTP SDK
pip install ./sdk/python
```

---

## ⚡ 1-Line Protocol Activation

To activate the entire SVTP protocol, simply wrap your existing agent object with the `SVTP.wrap` method.

```python
from svtp_sdk import SVTP
from my_agent_library import OriginalAgent

# 1. Initialize your original agent as usual
base_agent = OriginalAgent(...)

# 2. Wrap it in the SVTP Proxy (The SVTP-00 Standard)
agent = SVTP.wrap(base_agent, SVTP_KEY="GRANT_GENESIS")

# 3. Use the agent normally - All methods are now proxied, signed, and logged
agent.run("Analyze the market for BTC-USD")
```

---

## 💎 Features & Pillars

### 1. The Wrapper Core (Transparent Proxy)
The SDK uses a dynamic proxy (`__getattr__`) to intercept every method call. 
- **Kill-Switch**: Every action is pre-verified against the Remote SVTP Registry.
- **Audit Ledger**: Action metadata is logged to an immutable NDJSON ledger.
- **Shadow Billing**: Every intercepted action increments a standard $0.01 fee.

### 2. NIST-2026 Identity Mint
On initialization, the SDK performs an **Async Handshake**.
- Uses `GRANT_GENESIS` for frictionless entry.
- Mints a **Verifiable DID** (`did:svtp:xxxx`) upon success.
- Marks agents as 'Standard-Compliant'.

### 3. The Heartbeat Engine (Behavioral Attestation)
A background pulse engine emits a cryptographic hash of the agent's state every 10 seconds.
- Ensures the agent has not deviated from its intended logic.
- Each pulse is logged as a $0.01 transaction in the Shadow Ledger.

---

## 🔍 Fail-Safe Governance

If the SVTP Registry is unreachable, the SDK triggers a configurable **Fail-Safe** mechanism:
- `BLOCK` (Default): Denies high-risk actions until connectivity is restored.
- `LOG`: Records actions locally in the ledger for deferred synchronization.

```python
import os
os.environ["SVTP_FAIL_SAFE"] = "LOG" # Change to 'BLOCK' for maximum security
```

---

## 🏛️ Deployment (NIST SP 800-57 Compliant)

This SDK follows the latest NIST recommendations for cryptographic key management. **SVTP PROTOCOL: THE UNIVERSAL STANDARD FOR AGENTIC ACCOUNTABILITY.**




