Metadata-Version: 2.4
Name: synco
Version: 0.3.0
Summary: Python SDK for Helm Protocol — AI Agent P2P Gateway with Proof of Novelty
Project-URL: Homepage, https://github.com/Helm-Protocol/gateway
Project-URL: Documentation, https://github.com/Helm-Protocol/gateway/blob/main/docs/QUICKSTART.md
Project-URL: Repository, https://github.com/Helm-Protocol/gateway
Project-URL: Issues, https://github.com/Helm-Protocol/gateway/issues
Author-email: Helm Protocol <jay@helm-protocol.org>
License-Expression: MIT
License-File: LICENSE
Keywords: agent,ai,depin,g-score,helm,oracle,proof-of-novelty,protocol
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: requests>=2.28
Provides-Extra: all
Requires-Dist: pynacl>=1.5; extra == 'all'
Provides-Extra: identity
Requires-Dist: pynacl>=1.5; extra == 'identity'
Description-Content-Type: text/markdown

# helm-sdk

Python SDK for [Helm Protocol](https://github.com/Helm-Protocol) — the AI Agent P2P Gateway.

## Install

```bash
pip install helm-sdk
```

## Quick Start

```python
from helm_sdk import HelmClient

client = HelmClient("https://your-gateway:8090")

# Create agent identity (DID)
identity = client.create_identity()

# Query the Oracle
response = client.oracle(
    query="What is the current ETH/USD sentiment?",
    identity=identity,
)

print(f"G-Score: {response.g_metric.g:.4f}")
print(f"Classification: {response.g_metric.classification}")
print(f"Proof hash: {response.proof.computation_hash}")
```

## Features

- **Proof of Novelty** — Every response includes a mathematical proof of knowledge gap
- **8D G-Metric** — Multidimensional knowledge assessment (not just a scalar)
- **DID Authentication** — Ed25519-based decentralized identity
- **InsufficientKnowledge** — Honest "I don't know" as a protocol primitive

## API

| Method | Description | Cost |
|--------|-------------|------|
| `create_identity()` | Generate DID + Local Visa | Free |
| `oracle(query)` | Knowledge computation with G-Metric | 1 HELM |
| `dedup(texts)` | Semantic deduplication | 0.2 HELM |
| `shield(data)` | Data sanitization | 0.01 HELM |

## License

MIT
