Metadata-Version: 2.4
Name: vrl-sdk
Version: 0.2.1
Summary: Python SDK for the Verifiable Reality Layer (VRL) Proof Bundle Specification v1.0
Home-page: https://github.com/vrl-protocol/sdk
Author: Verifiable Reality Layer Contributors
Author-email: Verifiable Reality Layer Contributors <info@vrl.io>
License: MIT
Project-URL: Homepage, https://github.com/vrl-protocol/sdk
Project-URL: Repository, https://github.com/vrl-protocol/sdk
Project-URL: Documentation, https://github.com/vrl-protocol/sdk/tree/main/sdk/python
Project-URL: Bug Tracker, https://github.com/vrl-protocol/sdk/issues
Keywords: vrl,zero-knowledge,zkp,ai-verification,proof-bundle,cryptography,compliance
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
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: Topic :: Scientific/Engineering
Classifier: Topic :: Security :: Cryptography
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: requires-python

# VRL SDK - Verifiable Reality Layer Python SDK

A complete, production-ready Python implementation of the [VRL Proof Bundle Specification v1.0](https://github.com/vrl-protocol/spec).

The VRL SDK provides cryptographically verifiable attestation for AI model outputs and deterministic computations, enabling third parties to independently verify authenticity without trusting the issuing party.

## Features

- **ProofBundle**: Complete implementation of VRL Proof Bundle structure (§3)
- **Verifier**: Full 10-step verification procedure per VRL Spec §12
- **Canonical JSON**: Spec-compliant hash computation with sorted keys and no whitespace (§10)
- **SHA-256 Hashing**: All hash functions use SHA-256 as specified (§11)
- **AI Identity**: AI-ID computation with provider signature support (§2)
- **Fluent Builders**: Easy-to-use builder APIs for constructing bundles
- **Multiple Proof Systems**: Support for all proof systems defined in spec (§4)
- **Data Commitments**: External dataset binding with provider signatures (§6)
- **Legal Metadata**: Jurisdiction, compliance, and timestamp authority support (§8)
- **Proof Graphs**: Causal dependency tracking for composite proofs (§7)

## Installation

### From PyPI

```bash
pip install vrl-sdk
```

### From source

```bash
git clone https://github.com/vrl-protocol/sdk.git
cd sdk/sdk/python
pip install -e .
```

## Development

```bash
pip install -e ".[dev]"
pytest tests/
```

## Project Links

- Source: https://github.com/vrl-protocol/sdk
- Specification: https://github.com/vrl-protocol/spec
- Registry: https://github.com/vrl-protocol/registry
- Docs: https://vrl-protocol.github.io/spec/

## License

MIT
