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.2.1

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.2.1
File Size Uploaded
sovereign_zk-0.2.1.tar.gz 5.3 kB Details

Built distribution (wheel)

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

Total release size: 11.4 kB

Release files / sovereign_zk-0.2.1.tar.gz

Download URL sovereign_zk-0.2.1.tar.gz
Size 5.3 kB
Tags Source
SHA-256 checksum
How to use checksums
de0258e402a93238668fe5f3f8a80ca7ec410e1c1b1013b77a147badfcb8e0c4
BLAKE2b-256 checksum
How to use checksums
fdcced77ca40ea50f451b802ea7fd735cd94a0be8c0e43795b64a240e433dfcc
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.2.1-py3-none-any.whl

Download URL sovereign_zk-0.2.1-py3-none-any.whl
Size 6.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
73e6c8864f21832b29f2c1d56d2c89e97ca266279fca55b971416e54199a33c6
BLAKE2b-256 checksum
How to use checksums
48f4cf4d16d75996346699644ed0040211e09551cdaebd1c2059f6ceff5ff42e
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

0.3.0

2 release files

This release

0.2.1 This release

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