Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

ratify-protocol-native

You almost certainly do not need this package.

Install ratify-protocol instead. That is the Python SDK: it verifies proofs, issues delegations, signs challenges, and stores identities, in pure Python, on every platform.

This package is a small optional add-on to that SDK. It exists to provide one function, and nothing else.


What this package does

It provides deterministic key generation: turning two 32-byte seeds into the same Ratify identity every time, and the same identity that the Go, Rust, TypeScript, and C SDKs derive from those seeds.

That is the whole scope. It contains no verification logic, no signing logic, and no protocol implementation. Installing it does not change how anything else in the Python SDK behaves.

Do you need it?

No, if you are verifying proofs, issuing delegations, signing challenges, or saving an identity to reuse later. All of that works in ratify-protocol with nothing extra. To persist an identity, store its key bytes and load them back.

Yes, if you need the same seeds to produce the same identity in Python as in another language. For example: a Go service generates an identity from seeds it holds, and a Python process must reconstruct that identity from the same seeds.

If you are not sure, you do not need it.

Install

pip install 'ratify-protocol[native]'

Install it through the extra rather than by name. The extra pins the two packages to matching versions, which is what keeps them compatible.

Once installed, nothing changes in how you write code. The function that previously raised now works:

from ratify_protocol import hybrid_keypair_from_seeds, derive_id

ed_seed = bytes(range(32))
ml_seed = bytes((0xA0 + i) & 0xFF for i in range(32))
public, private = hybrid_keypair_from_seeds(ed_seed, ml_seed)

# The same identity every SDK derives from these seeds.
assert derive_id(public) == "3823136b5a5fc4c755b22704474172c0"

Without this package, that call raises NotImplementedError with instructions. It never returns a wrong answer.

Why it has to be a separate package

ratify-protocol is pure Python and ships a single wheel that installs on any platform and any supported CPython. Keeping it that way matters for a library whose main job is verifying proofs inside other people's applications.

Deterministic ML-DSA-65 key generation cannot be done in pure Python here. pqcrypto, the library the SDK uses for post-quantum signing, calls PQClean's crypto_sign_keypair, which reads the operating system's random number generator and ignores any seed the caller supplies. The pure-Python ML-DSA implementations that exist carry explicit warnings against use in cryptographic applications, so they are not an option either.

So this one operation runs through the Ratify Rust core, compiled into a small extension. Because compiled code is platform-specific, it lives here instead of in the SDK. If your platform has no wheel for this package, ratify-protocol still installs and works; you simply do not get this one function.

What is inside

A single Rust function exposed to Python through PyO3, calling the same hybrid_keypair_from_seeds that the Ratify Rust SDK exposes. Signing and verification are untouched and continue to use pqcrypto.

Wheels are built with the abi3 stable ABI, so one wheel per platform covers CPython 3.10 and every later version.

Handling seeds

Both seeds are key material. Anyone holding them can reconstruct the identity and act as it. Store them with the same protection you would give a private key, and generate them from a cryptographically secure source.

Apache-2.0.

Metadata

Release files for ratify-protocol-native 1.0.0a21

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

Source distribution (sdist)

Source distribution for ratify-protocol-native 1.0.0a21
File Size Uploaded Provenance Actions
ratify_protocol_native-1.0.0a21.tar.gz 91.8 kB With provenance Details for ratify_protocol_native-1.0.0a21.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for ratify-protocol-native 1.0.0a21
File Actions
ratify_protocol_native-1.0.0a21-cp310-abi3-win_amd64.whl CPython 3.10 abi3 Windows x86-64 Details for ratify_protocol_native-1.0.0a21-cp310-abi3-win_amd64.whl
ratify_protocol_native-1.0.0a21-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl CPython 3.10 abi3 Linux glibc 2.17+ x86-64 Details for ratify_protocol_native-1.0.0a21-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
ratify_protocol_native-1.0.0a21-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl CPython 3.10 abi3 Linux glibc 2.17+ ARM64 Details for ratify_protocol_native-1.0.0a21-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
ratify_protocol_native-1.0.0a21-cp310-abi3-macosx_11_0_arm64.whl CPython 3.10 abi3 macOS 11.0+ ARM64 Details for ratify_protocol_native-1.0.0a21-cp310-abi3-macosx_11_0_arm64.whl
ratify_protocol_native-1.0.0a21-cp310-abi3-macosx_10_12_x86_64.whl CPython 3.10 abi3 macOS 10.12+ x86-64 Details for ratify_protocol_native-1.0.0a21-cp310-abi3-macosx_10_12_x86_64.whl

Total release size: 1.6 MB

Release files / ratify_protocol_native-1.0.0a21.tar.gz

Download URL ratify_protocol_native-1.0.0a21.tar.gz
Size 91.8 kB
Tags Source
SHA-256 checksum
How to use checksums
ddead2f39e5957567781d1f093a46732ef1099039f258aea28603d9f1f328a95
BLAKE2b-256 checksum
How to use checksums
f34b0c8fd9d502aa7e1ba6c06798fa2a2ed4b0376fa7d819ed80c697335f4980
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

Release files / ratify_protocol_native-1.0.0a21-cp310-abi3-win_amd64.whl

Download URL ratify_protocol_native-1.0.0a21-cp310-abi3-win_amd64.whl
Size 189.9 kB
Tags CPython 3.10 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
ef6b38b208a3948db56588151fad5f5eb50fa7fbe8ad0bb88dd8fddf2c48cfab
BLAKE2b-256 checksum
How to use checksums
7d1d55c4f62b998883bc31c58e70293c9e857c19179c581481affe4660f2423a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

Release files / ratify_protocol_native-1.0.0a21-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL ratify_protocol_native-1.0.0a21-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 338.0 kB
Tags CPython 3.10 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
c67add59dcd86bef797b0eab8b6d3030e016877179718c1d003d8467b9a14c15
BLAKE2b-256 checksum
How to use checksums
f3aa5c18f5e1707d229e3bb2829f481af34e89a33df126d9e98900a474424c85
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

Release files / ratify_protocol_native-1.0.0a21-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL ratify_protocol_native-1.0.0a21-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 338.9 kB
Tags CPython 3.10 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum
How to use checksums
45d67ec6362dca70f1d66ef5dd148f247304a8a2f00087713a2f19e5c19ac979
BLAKE2b-256 checksum
How to use checksums
f9be8b4c7480714d05f5361ce9a9fd7f87c6afbbf7fc6851a8abc6070554eb15
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

Release files / ratify_protocol_native-1.0.0a21-cp310-abi3-macosx_11_0_arm64.whl

Download URL ratify_protocol_native-1.0.0a21-cp310-abi3-macosx_11_0_arm64.whl
Size 303.8 kB
Tags CPython 3.10 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
54765ba13af2206eb02aaf53d24bba8d97e7e5d89d83080e3d71e8649332eea3
BLAKE2b-256 checksum
How to use checksums
15267ef8aa755575f61eeb259aee3cce2233e0f36552ceda90d5a3a625f35ecb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

Release files / ratify_protocol_native-1.0.0a21-cp310-abi3-macosx_10_12_x86_64.whl

Download URL ratify_protocol_native-1.0.0a21-cp310-abi3-macosx_10_12_x86_64.whl
Size 294.4 kB
Tags CPython 3.10 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
69fb77ac85fb4f48e2ec083b888cd063f18b59e2bffc9e97c84be301bef7cd6d
BLAKE2b-256 checksum
How to use checksums
976016ff53b6f1073f333091b06c26877bcf9593c56eeca5fb99376ee99c8469
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

Security for ratify-protocol-native 1.0.0a21

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.

Full provenance

All 6 files in this release have been uploaded with provenance metadata.

Select from 6 files

Attestation for ratify_protocol_native-1.0.0a21.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

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