qorechain-rdk (Python)
Python Rollup Development Kit for the QoreChain network.
Status: Available. This package mirrors the TypeScript RDK
(@qorechain/rdk) with idiomatic, type-hinted, snake_case Python — typed rollup
configuration with the compatibility matrix enforced, preset profiles, the
rollup and settlement-batch lifecycles, native data availability, transaction
signing and broadcast, and the read clients.
Surface (mirrors the TypeScript RDK modules):
- Typed rollup configuration and builder, with the settlement / sequencer / proof / DA / gas / VM compatibility matrix validated client-side.
- The five preset profiles:
defi,gaming,nft,enterprise,custom. - Exact denom conversion and creation-cost economics (integer math, no float).
- Binary-Merkle withdrawal-proof assembly for the bridge.
- Portable rollup manifests (save / share / reload).
- Account derivation from a BIP-39 mnemonic (BIP-44
m/44'/118'/0'/0/0, secp256k1, bech32qor) and a SIGN_MODE_DIRECT signer. - Hand-encoded protobuf codecs for the eight
rdkmessages, a full transaction builder, and broadcast via the REST/cosmos/tx/v1beta1/txsendpoint. - Read clients: REST (LCD), the
qor_JSON-RPC namespace, typed views, and theRdkClientfacade — plus preflight ("doctor"), rollup health, event decoding, and a faucet helper. Live broadcast requires a reachable node endpoint; the HTTP transport is injectable for testing.
Mainnet PQC signing requirement. QoreChain mainnet requires the hybrid post-quantum signature extension (ML-DSA-87 + secp256k1) on native-lane transactions. The Python transaction path currently signs classical-only (SIGN_MODE_DIRECT, secp256k1), so native-lane broadcasts to mainnet will be rejected — use it on permissive networks (testnet, local devnets) or pair it with the
qorechain-pqcbindings in a custom backend. The TypeScript RDK supports hybrid signing via@qorechain/sdk. Read paths, local transaction signing, and settlement-receipt verification (which reads live chain state) are unaffected.
What's new in 0.4.0
- QCAI Rollup Copilot —
get_rollup_adviceaggregates a live fee estimate, network recommendations, fraud investigations, RL-agent status, and plain-language suggestions for a rollup (best-effort; unreachable advisory services degrade to warnings). - Quantum-safe settlement receipts —
build_settlement_receipt/verify_settlement_receipt: a portable record that a settlement batch was anchored to the Main Chain under an ML-DSA-87 (Dilithium-5, FIPS-204) signature. A receipt is a claim, not evidence — every field in it comes from whoever handed it to you — soverify_settlement_receiptrequires aclientand re-reads the rollup's layer, the batch's state root, the anchor and the creator's registered key from live chain state; only then does it returnvalid=Truewithmode="chain". There is no offline verification: without a client you getmode="signature-only", which proves someone signed those bytes and is nevervalid. The ML-DSA-87 verification uses theqorechain-pqclibrary.
pip install qorechain-rdk
Install as
qorechain-rdk; import asqorrdk.
from qorrdk import presets, create_rdk_client, signer_from_env
# Build and validate a rollup configuration.
config = presets.defi("my-rollup").set(stake_amount_uqor="10000000000").build()
# Connect, sign, and broadcast (needs a reachable node endpoint).
client = create_rdk_client(network="testnet")
signer = signer_from_env() # QORE_OPERATOR_PRIVATE_KEY_HEX or QORE_MNEMONIC
if signer is not None:
tx = client.connect_tx(signer)
tx.create_rollup(rollup_id="my-rollup", profile="defi", vm_type="evm",
stake_amount="10000000000")
Metadata
Release files for qorechain-rdk 0.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| qorechain_rdk-0.6.0.tar.gz | 73.1 kB | Without provenance | Details for qorechain_rdk-0.6.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| qorechain_rdk-0.6.0-py3-none-any.whl | Python 3 | none | any | Details for qorechain_rdk-0.6.0-py3-none-any.whl |
Total release size: 146.4 kB
Release files / qorechain_rdk-0.6.0.tar.gz
| Download URL | qorechain_rdk-0.6.0.tar.gz |
|---|---|
| Size | 73.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
29b22298c4d53dbb88100afe684915a8d0c758e498c17b653174ba6c3f93be03
|
|
BLAKE2b-256 checksum How to use checksums |
83843ac6b376b602df337e61275daf1acf2e8a87d6439af7adb0c54040c88a4c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.7
|
Release files / qorechain_rdk-0.6.0-py3-none-any.whl
| Download URL | qorechain_rdk-0.6.0-py3-none-any.whl |
|---|---|
| Size | 73.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
da0aafaf4bc93e2404c882c5590f36e10824b3b0a5ec38ec6a3a99f0a9aed496
|
|
BLAKE2b-256 checksum How to use checksums |
ea9407b020390fa784d4cf5de85f9b3b22c295fdb5b95a5858700185881545f3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.7
|
Security for qorechain-rdk 0.6.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.