Metadata-Version: 2.4
Name: cdo-oracle-sdk
Version: 0.2.0
Summary: Python SDK for RunOnProof Agent ID identity, signatures, verification and decision APIs
Author-email: RunOnProof <institucional@aureumone.io>
License-Expression: MIT
Project-URL: Homepage, https://runonproof.com
Project-URL: Documentation, https://docs.runonproof.com/docs
Project-URL: Repository, https://github.com/runonproof/cdo
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Provides-Extra: crypto
Requires-Dist: cryptography>=45; extra == "crypto"

# RunOnProof Python SDK

`cdo-oracle-sdk` is the supported Python client for the RunOnProof Agent ID and decision APIs.
`AgentIdentityClient` creates an ID through local proof of possession, signs locally,
verifies publicly, resolves profile/status, exports a public bundle, rotates and revokes
keys, revokes an identity, and delegates a scope-limited subagent. Private keys are
generated and retained by the caller; install the `crypto` extra for Ed25519 operations.

```sh
pip install 'cdo-oracle-sdk[crypto]'
```

```python
from cdo_oracle import AgentIdentityClient

agent_id = AgentIdentityClient("https://api.runonproof.com")
created = agent_id.create_identity(idempotency_key="my-agent-enrollment-0001")
```

It exposes synchronous and asynchronous clients for the Brazil and United Kingdom
decision products, including company checks, supplier approval, invoice and payee
verification, payment authorization, vendor changes, and Company Passport operations.

The client is fail-closed: it preserves evidence, correlation and idempotency fields,
uses bounded network operations, and does not sign transactions or settle payments.
See the [RunOnProof documentation](https://docs.runonproof.com/docs) for API setup and
credential handling.
