Skip to main content

Sovereign-ZK

A mathematically rigorous, privacy-preserving framework for cross-border GPU compute using Zero-Knowledge Verifiable Computation (ZK-VC) and Confidential Computing (CC). Developed by Chidiebere V. Christopher.

Sovereign-ZK allows institutions (e.g., Nigerian banks or hospitals) to securely offload heavy deep learning workloads to remote Confidential GPUs (e.g., NVIDIA H100s in Kenya) without exposing plain-text data to the host.

v0.2.0+ Architecture Revamp: The framework has completely shifted from centralized HTTP servers to a trustless Decentralized Web3 Settlement Layer. Payments are escrowed in USDC (stablecoins) on-chain, and funds are only released when the remote node submits a mathematically valid EZKL Zero-Knowledge Proof.

Installation / Upgrade

To upgrade to the Web3/USDC enabled version:

pip install --upgrade sovereign-zk

Quick Start (Web3 Decentralized Architecture)

1. Setup the Smart Contract Escrow

Sovereign-ZK relies on the SovereignEscrow.sol smart contract to handle trustless USDC payouts. First, run a local blockchain node and deploy the contracts (using Hardhat):

npx hardhat node
npx hardhat run scripts/deploy.js --network localhost

2. Start the Remote GPU Node (Kenya)

The node no longer runs a web server. Instead, it continuously polls the blockchain for new AI compute jobs.

python -m sovereign_zk.node

(The node will listen for JobCreated events, verify the data commitment, generate a ZK proof, and submit it on-chain).

3. Submit Data from the Local Client (Nigeria)

On your local machine, use the client SDK to encrypt your data, generate a cryptographic commitment, and escrow exactly $0.25 USDC on the blockchain.

python -m sovereign_zk.client

Under the hood, the client script does this:

from web3 import Web3

# 1. Encrypt the data
encrypted_payload = encrypt_data(data, symmetric_key)

# 2. Generate a cryptographic commitment (so the node can't cheat)
input_commitment = w3.keccak(encrypted_payload)

# 3. Approve exactly 0.25 USDC (250,000 units) to the Escrow
usdc.functions.approve(escrow_address, 250000).transact({'from': client_account})

# 4. Create the Job On-Chain!
escrow.functions.createJob(input_commitment, 250000).transact({'from': client_account})

Economics

Sovereign-ZK uses USDC for corporate budgeting stability. It allows African researchers to access high-end compute for micro-transactions (~$0.25) while guaranteeing the GPU provider an automated, trustless payout via the Zero-Knowledge verifier smart contract.

Author

Chidiebere V. Christopher

Metadata

Release files for sovereign-zk 0.3.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 sovereign-zk 0.3.0
File Size Uploaded
sovereign_zk-0.3.0.tar.gz 5.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for sovereign-zk 0.3.0
File Interpreter ABI Platform
sovereign_zk-0.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 10.6 kB

Release files / sovereign_zk-0.3.0.tar.gz

Download URL sovereign_zk-0.3.0.tar.gz
Size 5.1 kB
Tags Source
SHA-256 checksum
How to use checksums
c52672069543673a162263c67213cefad5565283f3a2a62b2d6ccd13cf26cb55
BLAKE2b-256 checksum
How to use checksums
72c9e1b635c04c05d9bb49ca3f2d0b8f60052b77cb209a5eb3f3e2f4789f7a87
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / sovereign_zk-0.3.0-py3-none-any.whl

Download URL sovereign_zk-0.3.0-py3-none-any.whl
Size 5.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8d135650e7742c42512c4949a1261c86c77192d40880ed1bdd86eb24640d9950
BLAKE2b-256 checksum
How to use checksums
b8556322dd9c3bbc845cde7c4a1b7eedffaba94692fb19501f50feb931513c25
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release history Release notifications | RSS feed

0.3.1

2 release files

This release

0.3.0 This release

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.0

2 release files

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