xproof 0.1.0__tar.gz

xproof-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 xProof
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

xproof-0.1.0/PKG-INFO

@@ -0,0 +1,228 @@
+Metadata-Version: 2.4
+Name: xproof
+Version: 0.1.0
+Summary: Python SDK for xProof — blockchain-anchored proof-of-existence for AI agents on MultiversX
+Author-email: xProof <contact@xproof.app>
+License-Expression: MIT
+Project-URL: Homepage, https://xproof.app
+Project-URL: Repository, https://github.com/jasonxkensei/xproof
+Project-URL: Documentation, https://xproof.app/docs
+Project-URL: Issues, https://github.com/jasonxkensei/xproof/issues
+Project-URL: Changelog, https://github.com/jasonxkensei/xproof/releases
+Keywords: blockchain,multiversx,proof-of-existence,certification,sha256,ai-agents,accountability,audit-trail,web3
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Security :: Cryptography
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: responses>=0.20.0; extra == "dev"
+Dynamic: license-file
+
+# xProof Python SDK
+
+Python SDK for [xProof](https://xproof.app) — blockchain-anchored proof-of-existence for AI agents on MultiversX.
+
+Certify agent actions, verify proofs, and build accountability into any AI workflow.
+
+## Installation
+
+```bash
+pip install xproof
+```
+
+## Quick Start
+
+### Zero-friction onboarding (no wallet, no payment)
+
+```python
+from xproof import XProofClient
+
+# Register and get 10 free certifications instantly
+client = XProofClient.register("my-research-agent")
+print(client.registration.trial.remaining)  # 10
+
+# Certify an agent action
+cert = client.certify_hash(
+    file_hash="e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+    file_name="analysis-output.json",
+    author="my-research-agent",
+)
+print(cert.id)               # proof UUID
+print(cert.transaction_url)  # MultiversX explorer link
+```
+
+### With an existing API key
+
+```python
+from xproof import XProofClient
+
+client = XProofClient(api_key="pm_your_api_key")
+
+# Certify a local file (auto-hashes with SHA-256)
+cert = client.certify("path/to/report.pdf", author="Alice")
+print(cert.id)
+print(cert.transaction_url)
+
+# Certify with a pre-computed hash
+cert = client.certify_hash(
+    file_hash="e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+    file_name="report.pdf",
+    author="Alice",
+)
+
+# Verify a proof by ID (no auth required)
+proof = client.verify("certification-uuid")
+print(proof.file_name, proof.blockchain_status)
+
+# Verify by file hash (no auth required)
+proof = client.verify_hash("e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855")
+
+# Get current pricing (no auth required)
+pricing = client.get_pricing()
+print(pricing.price_usd)
+```
+
+## 4W Framework (WHO / WHAT / WHEN / WHY)
+
+xProof certifications support the 4W accountability framework via optional
+keyword arguments:
+
+```python
+from xproof import XProofClient, hash_bytes
+
+client = XProofClient(api_key="pm_your_key")
+
+action_data = b'{"action": "generate_report", "model": "gpt-4"}'
+action_hash = hash_bytes(action_data)
+
+cert = client.certify_hash(
+    file_hash=action_hash,
+    file_name="agent-action.json",
+    author="research-agent",
+    who="erd1abc...or-agent-id",
+    what=action_hash,
+    when="2026-03-20T12:00:00Z",
+    why=hash_bytes(b"Summarize Q1 earnings report"),
+    metadata={"model": "gpt-4", "session_id": "sess-123"},
+)
+```
+
+## Batch Certification
+
+Certify up to 50 files in a single API call:
+
+```python
+results = client.batch_certify([
+    {"file_hash": "abc123...", "file_name": "file1.pdf", "author": "my-agent"},
+    {"file_hash": "def456...", "file_name": "file2.pdf"},
+])
+
+print(results.summary.total)      # 2
+print(results.summary.certified)  # 2
+print(results.summary.failed)     # 0
+
+for cert in results.results:
+    print(cert.file_name, cert.id)
+```
+
+Or certify local files (auto-hashed):
+
+```python
+results = client.batch_certify([
+    {"path": "file1.pdf", "author": "Alice"},
+    {"path": "file2.pdf", "author": "Bob"},
+])
+```
+
+## File Hashing Utilities
+
+```python
+from xproof import hash_file, hash_bytes
+
+# Hash a file
+sha256_hex = hash_file("path/to/file.pdf")
+print(sha256_hex)  # 64-character hex string
+
+# Hash raw bytes
+sha256_hex = hash_bytes(b"hello world")
+```
+
+## Error Handling
+
+```python
+from xproof import XProofClient, AuthenticationError, NotFoundError, ConflictError
+
+client = XProofClient(api_key="pm_your_api_key")
+
+try:
+    cert = client.certify("file.pdf", author="Alice")
+except AuthenticationError:
+    print("Invalid API key")
+except ConflictError as e:
+    print(f"Already certified: {e.certification_id}")
+except NotFoundError:
+    print("Resource not found")
+```
+
+## API Reference
+
+| Method | Description |
+|---|---|
+| `XProofClient.register(agent_name)` | Register a new agent, get 10 free certs |
+| `client.certify(path, author)` | Certify a file (auto-hashes locally) |
+| `client.certify_hash(file_hash, file_name, author)` | Certify with a pre-computed hash |
+| `client.batch_certify(files)` | Batch certify up to 50 files |
+| `client.verify(proof_id)` | Retrieve a proof by ID |
+| `client.verify_hash(file_hash)` | Look up a proof by SHA-256 hash |
+| `client.get_pricing()` | Get current pricing info |
+| `hash_file(path)` | Compute SHA-256 hex digest of a file |
+| `hash_bytes(data)` | Compute SHA-256 hex digest of bytes |
+
+## Models
+
+- **`Certification`** — `id`, `file_name`, `file_hash`, `transaction_hash`, `transaction_url`, `created_at`, `author_name`, `blockchain_status`
+- **`BatchResult`** — `results` (list of `Certification`), `summary` (`total`, `certified`, `failed`)
+- **`RegistrationResult`** — `api_key`, `agent_name`, `trial` (`quota`, `used`, `remaining`), `endpoints`
+- **`PricingInfo`** — `protocol`, `version`, `price_usd`, `tiers`, `payment_methods`
+
+## Exceptions
+
+| Exception | HTTP Status | Description |
+|---|---|---|
+| `XProofError` | any | Base exception |
+| `AuthenticationError` | 401/403 | Invalid or missing API key |
+| `ValidationError` | 400 | Invalid request data |
+| `NotFoundError` | 404 | Resource not found |
+| `ConflictError` | 409 | File already certified |
+| `RateLimitError` | 429 | Rate limit exceeded |
+| `ServerError` | 5xx | Server error |
+
+## Requirements
+
+- Python 3.8+
+- `requests >= 2.25.0`
+
+## Links
+
+- [xProof Web App](https://xproof.app)
+- [API Documentation](https://xproof.app/docs)
+- [GitHub](https://github.com/jasonxkensei/xproof)
+- [Agent Proof Standard](https://github.com/jasonxkensei/xproof/blob/main/AGENT_PROOF_STANDARD.md)
+
+## License
+
+MIT

xproof-0.1.0/README.md

@@ -0,0 +1,194 @@
+# xProof Python SDK
+
+Python SDK for [xProof](https://xproof.app) — blockchain-anchored proof-of-existence for AI agents on MultiversX.
+
+Certify agent actions, verify proofs, and build accountability into any AI workflow.
+
+## Installation
+
+```bash
+pip install xproof
+```
+
+## Quick Start
+
+### Zero-friction onboarding (no wallet, no payment)
+
+```python
+from xproof import XProofClient
+
+# Register and get 10 free certifications instantly
+client = XProofClient.register("my-research-agent")
+print(client.registration.trial.remaining)  # 10
+
+# Certify an agent action
+cert = client.certify_hash(
+    file_hash="e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+    file_name="analysis-output.json",
+    author="my-research-agent",
+)
+print(cert.id)               # proof UUID
+print(cert.transaction_url)  # MultiversX explorer link
+```
+
+### With an existing API key
+
+```python
+from xproof import XProofClient
+
+client = XProofClient(api_key="pm_your_api_key")
+
+# Certify a local file (auto-hashes with SHA-256)
+cert = client.certify("path/to/report.pdf", author="Alice")
+print(cert.id)
+print(cert.transaction_url)
+
+# Certify with a pre-computed hash
+cert = client.certify_hash(
+    file_hash="e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+    file_name="report.pdf",
+    author="Alice",
+)
+
+# Verify a proof by ID (no auth required)
+proof = client.verify("certification-uuid")
+print(proof.file_name, proof.blockchain_status)
+
+# Verify by file hash (no auth required)
+proof = client.verify_hash("e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855")
+
+# Get current pricing (no auth required)
+pricing = client.get_pricing()
+print(pricing.price_usd)
+```
+
+## 4W Framework (WHO / WHAT / WHEN / WHY)
+
+xProof certifications support the 4W accountability framework via optional
+keyword arguments:
+
+```python
+from xproof import XProofClient, hash_bytes
+
+client = XProofClient(api_key="pm_your_key")
+
+action_data = b'{"action": "generate_report", "model": "gpt-4"}'
+action_hash = hash_bytes(action_data)
+
+cert = client.certify_hash(
+    file_hash=action_hash,
+    file_name="agent-action.json",
+    author="research-agent",
+    who="erd1abc...or-agent-id",
+    what=action_hash,
+    when="2026-03-20T12:00:00Z",
+    why=hash_bytes(b"Summarize Q1 earnings report"),
+    metadata={"model": "gpt-4", "session_id": "sess-123"},
+)
+```
+
+## Batch Certification
+
+Certify up to 50 files in a single API call:
+
+```python
+results = client.batch_certify([
+    {"file_hash": "abc123...", "file_name": "file1.pdf", "author": "my-agent"},
+    {"file_hash": "def456...", "file_name": "file2.pdf"},
+])
+
+print(results.summary.total)      # 2
+print(results.summary.certified)  # 2
+print(results.summary.failed)     # 0
+
+for cert in results.results:
+    print(cert.file_name, cert.id)
+```
+
+Or certify local files (auto-hashed):
+
+```python
+results = client.batch_certify([
+    {"path": "file1.pdf", "author": "Alice"},
+    {"path": "file2.pdf", "author": "Bob"},
+])
+```
+
+## File Hashing Utilities
+
+```python
+from xproof import hash_file, hash_bytes
+
+# Hash a file
+sha256_hex = hash_file("path/to/file.pdf")
+print(sha256_hex)  # 64-character hex string
+
+# Hash raw bytes
+sha256_hex = hash_bytes(b"hello world")
+```
+
+## Error Handling
+
+```python
+from xproof import XProofClient, AuthenticationError, NotFoundError, ConflictError
+
+client = XProofClient(api_key="pm_your_api_key")
+
+try:
+    cert = client.certify("file.pdf", author="Alice")
+except AuthenticationError:
+    print("Invalid API key")
+except ConflictError as e:
+    print(f"Already certified: {e.certification_id}")
+except NotFoundError:
+    print("Resource not found")
+```
+
+## API Reference
+
+| Method | Description |
+|---|---|
+| `XProofClient.register(agent_name)` | Register a new agent, get 10 free certs |
+| `client.certify(path, author)` | Certify a file (auto-hashes locally) |
+| `client.certify_hash(file_hash, file_name, author)` | Certify with a pre-computed hash |
+| `client.batch_certify(files)` | Batch certify up to 50 files |
+| `client.verify(proof_id)` | Retrieve a proof by ID |
+| `client.verify_hash(file_hash)` | Look up a proof by SHA-256 hash |
+| `client.get_pricing()` | Get current pricing info |
+| `hash_file(path)` | Compute SHA-256 hex digest of a file |
+| `hash_bytes(data)` | Compute SHA-256 hex digest of bytes |
+
+## Models
+
+- **`Certification`** — `id`, `file_name`, `file_hash`, `transaction_hash`, `transaction_url`, `created_at`, `author_name`, `blockchain_status`
+- **`BatchResult`** — `results` (list of `Certification`), `summary` (`total`, `certified`, `failed`)
+- **`RegistrationResult`** — `api_key`, `agent_name`, `trial` (`quota`, `used`, `remaining`), `endpoints`
+- **`PricingInfo`** — `protocol`, `version`, `price_usd`, `tiers`, `payment_methods`
+
+## Exceptions
+
+| Exception | HTTP Status | Description |
+|---|---|---|
+| `XProofError` | any | Base exception |
+| `AuthenticationError` | 401/403 | Invalid or missing API key |
+| `ValidationError` | 400 | Invalid request data |
+| `NotFoundError` | 404 | Resource not found |
+| `ConflictError` | 409 | File already certified |
+| `RateLimitError` | 429 | Rate limit exceeded |
+| `ServerError` | 5xx | Server error |
+
+## Requirements
+
+- Python 3.8+
+- `requests >= 2.25.0`
+
+## Links
+
+- [xProof Web App](https://xproof.app)
+- [API Documentation](https://xproof.app/docs)
+- [GitHub](https://github.com/jasonxkensei/xproof)
+- [Agent Proof Standard](https://github.com/jasonxkensei/xproof/blob/main/AGENT_PROOF_STANDARD.md)
+
+## License
+
+MIT

xproof-0.1.0/pyproject.toml

@@ -0,0 +1,60 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "xproof"
+version = "0.1.0"
+description = "Python SDK for xProof — blockchain-anchored proof-of-existence for AI agents on MultiversX"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+authors = [
+    {name = "xProof", email = "contact@xproof.app"},
+]
+keywords = [
+    "blockchain", "multiversx", "proof-of-existence", "certification",
+    "sha256", "ai-agents", "accountability", "audit-trail", "web3",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Security :: Cryptography",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = [
+    "requests>=2.25.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "responses>=0.20.0",
+]
+
+[project.urls]
+Homepage = "https://xproof.app"
+Repository = "https://github.com/jasonxkensei/xproof"
+Documentation = "https://xproof.app/docs"
+Issues = "https://github.com/jasonxkensei/xproof/issues"
+Changelog = "https://github.com/jasonxkensei/xproof/releases"
+
+[tool.setuptools.packages.find]
+include = ["xproof*"]
+
+[tool.setuptools.package-data]
+xproof = ["py.typed"]
+
+[tool.pytest.ini_options]
+markers = [
+    "integration: marks tests that hit the live xProof API (deselect with '-m \"not integration\"')",
+]

xproof-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+