PressProtocol Python SDK (pressprotocol-py)

Official Python SDK for PressProtocol — Autonomous, censorship-resistant publishing infrastructure, zero-custody cryptographic signing, and multi-transport content syndication across IPFS and Tor v3.

Features

• 🔐 Zero-Custody Client Signing: Deterministic canonical payload serialization and Ed25519 verification.
• ⚡ Deterministic In-Memory CIDv1: Instant RFC 4648 base32 multihash calculation without an IPFS node.
• 🌐 Multi-Transport Resolution: Automated discovery across IPFS public gateways and Tor .onion endpoints.
• 🛡️ Zero External Dependency Core: Relies strictly on Python standard library with optional acceleration.

Installation

pip install pressprotocol-py

Or install with uv:

uv add pressprotocol-py

Quickstart

from pressprotocol import PressProtocol

# 1. Initialize client
client = PressProtocol(
    endpoint="https://pressprotocol.com"
)

# 2. Publish article directly to decentralized swarms
post = client.publish_raw(
    title="Data Science Transparency Audit",
    content="# Methodology & Findings\n\nVerifiable cryptographic dataset preserved across swarms.",
    tags=["science", "reproducibility", "whistleblower"]
)

print(f"✅ Published CID: {post['cid']}")
print(f"📦 IPFS Gateway: {post.get('urls', {}).get('ipfs')}")
print(f"🧅 Tor Mirror: {post.get('urls', {}).get('tor')}")

In-Memory Deterministic CIDv1

Compute standard base32 CIDv1 multihashes in-memory without contacting any daemon or gateway:

from pressprotocol.crypto import calculate_deterministic_cidv1

cid = calculate_deterministic_cidv1("Hello, Sovereign Cyberspace!")
print("Deterministic CIDv1:", cid) # bafk...

Resolving Content

# Resolve multi-transport mirror availability
article = client.resolve("bafkreibm7...")

print(f"Title: {article.get('title')}")
print(f"Tor Gateway: {article.get('torGatewayUrl')}")

License

MIT © 0xShikhar & PressProtocol Architects