PPIL client — Python
ppil-client — a pip-installable package (requests) mirroring the verified @aithne/ppil-client AVP contract.
SDK overview
Install
# pip package (illustrative)
pip install ppil-client
# Python 3.9+, requests>=2.25
from ppil_client import PPILClient
pip install ppil-client
# Python 3.9+, requests>=2.25
from ppil_client import PPILClient
Example only — the registry publication path is being confirmed with the AVS engineering track. The tested client ships from the AVS workspace until then.
Surface
client.issue(attestation_ref=..., correlation_id=...)
client.verify(ppt_token=..., otp_alias=..., required_categories=...)
client.rotate_otp(ppt_id=...)
client.revoke(ppt_id=...)
client.verify(ppt_token=..., otp_alias=..., required_categories=...)
client.rotate_otp(ppt_id=...)
client.revoke(ppt_id=...)
What it does
- Full issue / verify / rotate-otp / get / revoke / verification-modal surface.
- The
verify_hiddenconvenience normalizes responses to{ok, ageClaim, details.status}— server verification stays server-side. - Middleware-style age gating with session short-circuit.
mask_sensitive()masking and heuristic token sanity checks — no token is ever logged.- Verified by a 24-case pytest contract suite (mock server, no real data).