JEP Python SDK v0.6

Python SDK for the JEP v0.6 API seed.

This SDK targets the current JEP API shape:

POST /events/create
POST /events/verify
GET  /health

It is aligned with:

• draft-wang-jep-judgment-event-protocol-06
• draft-wang-jep-profiles-00
• draft-wang-jep-conformance-00
• hjs-spec/jep-api

Status

Experimental implementation seed.

This SDK does not define new JEP-Core semantics and does not determine legal liability, factual truth, regulatory compliance, or complete-log availability.

Installation

pip install jep-sdk-py

For local development:

pip install -e ".[dev]"

Quick Start

from jep import JEPClient, CreateEventRequest, Verb

client = JEPClient(base_url="http://127.0.0.1:8000")

created = client.create_event(CreateEventRequest(
    verb=Verb.JUDGMENT.value,
    who="did:example:agent-789",
    what={"claim": "approve"},
))

print(created.event_hash)

verified = client.verify_event({
    "event": created.event.to_dict(),
    "mode": "archival",
})

print(verified.valid)

Core Types

• JEPEvent
• CreateEventRequest
• EventResponse
• VerifyEventRequest
• ValidationResult
• HealthResponse

Supported verbs:

Verb.JUDGMENT
Verb.DELEGATION
Verb.TERMINATION
Verb.VERIFICATION

API

Create event

resp = client.create_event(CreateEventRequest(
    verb=Verb.JUDGMENT.value,
    who="did:example:agent",
    what="sha256:...",
))

Verify event

result = client.verify_event({
    "event": resp.event.to_dict(),
    "mode": "archival",
})

Convenience helpers

client.judgment("did:example:agent", what)
client.delegation("did:example:agent", what)
client.termination("did:example:agent", what, ref="sha256:parent")
client.verification("did:example:agent", what, ref="sha256:parent")

Health

health = client.health()

Testing

pytest -q

Tests use a local in-process HTTP server and do not require a live JEP API.

Related Repositories

• JEP v0.6: https://github.com/hjs-spec/jep-v06
• JEP API v0.6: https://github.com/hjs-spec/jep-api
• HJS v0.5: https://github.com/hjs-spec/hjs-05
• JAC v0.5: https://github.com/hjs-spec/jac-agent-02

Public Drafts

• JEP-Core: https://datatracker.ietf.org/doc/draft-wang-jep-judgment-event-protocol/
• JEP-Profiles: https://datatracker.ietf.org/doc/draft-wang-jep-profiles/
• JEP-Conformance: https://datatracker.ietf.org/doc/draft-wang-jep-conformance/

License

MIT