Metadata-Version: 2.4
Name: jiaozi-gdid
Version: 0.2.1
Summary: JIAOZI Protocol Python SDK - register / attest / resolve / verify AI-agent verifiable credentials
Author: Jiaozi Protocol contributors
License: MIT
Project-URL: Homepage, https://www.jiaozi.io/integrate
Project-URL: Documentation, https://www.jiaozi.io/docs
Project-URL: Source, https://github.com/jiaozi-protocol/jiaozi-app
Keywords: ai-agent,identity,verifiable-credentials,did,jiaozi-protocol
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.27.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Dynamic: license-file

# jiaozi-gdid

Python SDK for [JIAOZI](https://www.jiaozi.io) — register, attest, resolve and
verify AI-agent credentials. The underlying protocol is open: specs and
reference implementations live in the
[jiaozi-protocol](https://github.com/jiaozi-protocol) GitHub org.

```bash
pip install jiaozi-gdid
```

Requires Python 3.11+.

## Usage

```python
from jiaozi_gdid import Gdid

gdid = Gdid(
    base_url="https://www.jiaozi.io",   # or https://www.jiaozi.tech (China)
    api_key="your-api-key",             # only needed for write operations
)

gdid.register(name="MyAgent", owner_pubkey="zOwner...")
gdid.attest(summary)                     # local health-check report (jiaozi.attest.v1)
gdid.resolve("JIAOZI-2026-000001")
gdid.verify("did:web:...")               # authenticity + revocation check
```

Core surface: `register` / `attest` / `resolve` / `verify`, plus credit-trail
helpers (`submit_credit` / `anchor_credit` / `get_credit_proof`).

`resolve` and `verify` are public and need no API key; registration,
attestation and credit submission require one (get yours at
[jiaozi.io/integrate](https://www.jiaozi.io/integrate)).

## Related

- [`@jiaozi-protocol/sdk`](https://www.npmjs.com/package/@jiaozi-protocol/sdk) —
  TypeScript SDK, including the `requireTrust` credential-gated permission
  helpers.
- [`jiaozi-validator`](https://pypi.org/project/jiaozi-validator/) — local
  health-check CLI that produces the `jiaozi.attest.v1` summary consumed by
  `attest`.
- [`jiaozi.status.v1` open spec](https://github.com/jiaozi-protocol/status-v1) —
  verify a credential's revocation freshness offline, no account needed.

## License

MIT
