Skip to main content

entpoind-verify

Offline verification of Entpoind Tools receipts and VerifiableArtifact bundles. Python 3.9 or later, standard library only: it carries its own pure-Python Ed25519 verifier, so nothing outside these files is trusted.

pip install entpoind-verify

Not on PyPI yet (checked 2026-10-29: pypi.org/pypi/entpoind-verify answers 404), and the customer docs (content/tools-docs/sdks.mdx) say the Python verifier does not exist. Remove this note when the package is published; until then the command above fails, and the Python snippet in the docs is the way to verify.

from entpoind_verify import verify_receipt_online

result = verify_receipt_online(receipt_json)
if result.ok:
    print("signed at", result.signed_at, "by key", result.signature_key_id)
else:
    print("not verified:", result.reason)

receipt_json can be the receipt dict, its JSON text, or the {"receipt": …} wrapper the API returns.

What it verifies

  • Tools receipts: the signed envelope every Tools call returns, of every receipt type (agent.call, content.attest, monitor.http, heartbeat.attest, …). Scheduled-watch digest receipts verify the same way.
  • VerifiableArtifact envelopes and bundles: the signature, and, when a bundle carries an anchor, that the artifact is included under the anchored Merkle root.

The signature is Ed25519 over the RFC 8785 (JCS) canonical form of the envelope minus signature. Public keys come from the published JWK Set at https://entpoind.com/.well-known/tools-keys.json. For air-gapped checks, save that file and pass its keys to verify_receipt.

API

Function Purpose
verify_receipt(input, keys) Verify a receipt against keys you supply. No network.
verify_receipt_online(input, url?) Fetch the published keys, then verify.
fetch_tools_keys(url?) Fetch the published JWK Set and keep its Ed25519 keys.
verify_artifact(input, keys) Verify a standalone artifact envelope.
verify_bundle(input, keys) Signature, plus Merkle inclusion when anchored.
verify_merkle_inclusion(leaf, proof, root) Fold an inclusion proof locally.
merkle_leaf_hash(leaf) The domain-separated Merkle leaf hash.
canonical_jcs(value) The RFC 8785 canonical string.
verify_signature(key, message, signature) The raw Ed25519 check, as a boolean.
ed25519_supported() Always True; present for parity with @entpoind/verify.

Every verify_* function returns a Verification with ok, reason, signed_at, signature_key_id, kind (artifacts and bundles) and anchored (bundles). They never raise on hostile input. fetch_tools_keys and verify_receipt_online raise when the keys cannot be fetched, so "could not check" is never reported as a verdict.

Only keys with kty: "OKP" and crv: "Ed25519" are ever used, whatever the key list you pass holds.

Failure reasons

reason Meaning
malformed_envelope Not a complete receipt or artifact.
unknown_key signatureKeyId matches no Ed25519 key in the set. Refresh the keys; if it is still missing, the document was not signed by Entpoind.
bad_signature The signature does not match the canonical bytes: the document was altered, or is not Entpoind's.
unsupported_runtime Shared with @entpoind/verify, where it means the runtime has no Ed25519. This package always can verify, so it never reports it.
not_in_anchored_root Bundles only: the signature is valid but the Merkle proof does not reach the anchored root.

A bundle without an anchor verifies with anchored=False; that is a valid result, not a failure. Merkle siblings and the root must be 64 hex digits. A bundle's leafHash is the plain SHA-256 of the leaf string, an index id; verification does not use it.

Checking the math yourself

  • entpoind_verify/ed25519.py is the RFC 8032 verification equation.
  • entpoind_verify/canonical_json.py is JCS, including ECMAScript number layout.
  • The npm package @entpoind/verify gives the same verdict, with the same reasons, for the same input.

Documentation

Receipt format, verification procedure and key rotation: https://entpoind.com/docs/verification.

License

MIT © 2026 Avonao, Inc.

Metadata

Release files for entpoind-verify 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for entpoind-verify 0.1.0
File Size Uploaded Provenance Actions
entpoind_verify-0.1.0.tar.gz 19.7 kB Without provenance Details for entpoind_verify-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for entpoind-verify 0.1.0
File Interpreter ABI Platform Actions
entpoind_verify-0.1.0-py3-none-any.whl Python 3 none any Details for entpoind_verify-0.1.0-py3-none-any.whl

Total release size: 33.6 kB

Release files / entpoind_verify-0.1.0.tar.gz

Download URL entpoind_verify-0.1.0.tar.gz
Size 19.7 kB
Tags Source
SHA-256 checksum
How to use checksums
f911e3512708c21b46ffe9a9712d08aa00ec3410016708eaeb1a6dd619384ccc
BLAKE2b-256 checksum
How to use checksums
5df340ae02811dca02106a59d77ebe2b689eb846520adea58950584511f0d3a2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Release files / entpoind_verify-0.1.0-py3-none-any.whl

Download URL entpoind_verify-0.1.0-py3-none-any.whl
Size 13.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3bc82d8cbc0c31657b3282d8d480b54a9bb841e78b7b05437dcdbe96cbca329c
BLAKE2b-256 checksum
How to use checksums
64bf1a769bb0e64e4b683d9065da4dbc1c833356f85242ef1599605954f129c4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Security for entpoind-verify 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page