🆔 PR 5: Sovereign Identity & ZK-KYC (209/217/221/241)

docs/PiRC-209-Sovereign-Decentralized-Identity-Standard.md

@@ -0,0 +1,38 @@
+# PiRC-209: Sovereign Decentralized Identity and Verifiable Credentials Standard
+
+## 1. Executive Summary
+
+**PiRC-209** defines the official standard for **Sovereign Decentralized Identity (DID)** and **Verifiable Credentials (VC)** within the Pi Network ecosystem.
+
+Built directly on top of **PiRC-207 Sovereign Sync** and **PiRC-208 AI Integration Standard**.
+
+## 6. Implementation Roadmap & Reference Code
+
+**Reference Implementations** (dual-language support for maximum compatibility):
+
+### Solidity (EVM-compatible)
+- [`contracts/PiRC209DIDRegistry.sol`](../contracts/PiRC209DIDRegistry.sol)
+- [`contracts/PiRC209VCVerifier.sol`](../contracts/PiRC209VCVerifier.sol)
+
+### Rust / Soroban (Stellar-native)
+**Full project structure:**
+- [`contracts/soroban/Cargo.toml`](../contracts/soroban/Cargo.toml)
+- [`contracts/soroban/src/lib.rs`](../contracts/soroban/src/lib.rs)
+- [`contracts/soroban/src/did_registry.rs`](../contracts/soroban/src/did_registry.rs)
+- [`contracts/soroban/src/vc_verifier.rs`](../contracts/soroban/src/vc_verifier.rs)
+
+**Build instructions** are available in [`contracts/soroban/README.md`](../contracts/soroban/README.md).
+
+**Automatic CI/CD**:  
+See [`.github/workflows/soroban-build.yml`](../.github/workflows/soroban-build.yml) — builds and tests both contracts on every push.
+
+## 7. Conclusion
+
+PiRC-209 completes the sovereign identity layer of the Pi Network, turning the Registry Layer into a production-grade **Sovereign Identity & Compliance Engine**. It enables real-world utility, regulatory compliance, and massive ecosystem growth while strictly respecting Economic Parity, Reflexive Parity, and the principles of PiRC-101 and PiRC-207.
+
+**Status**: Draft → Ready for Community Review & Pi Core Team Approval  
+**Proposed By**: Ze0ro99/PiRC Contributors (April 2026)
+
+---
+
+**License**: PiOS License (same as repository)

docs/PiRC-217-Sovereign-KYC-and-Regulatory-Compliance-Layer.md

@@ -0,0 +1,28 @@
+# PiRC-217: Sovereign KYC & Regulatory Compliance Layer
+
+## 1. Executive Summary
+
+This standard defines a fully sovereign, decentralized KYC and regulatory compliance layer using PiRC-209 DID and Verifiable Credentials, ensuring compliance without compromising user privacy or sovereignty.
+
+**Dependencies**: PiRC-209, PiRC-207  
+**Status**: Complete reference implementation
+
+## 2. Architecture
+
+- DID-based identity verification (PiRC-209)
+- Selective disclosure via zero-knowledge proofs
+- Automated compliance checks
+- Integration with Justice Engine for regulatory enforcement
+
+## 3. Reference Smart Contracts
+
+**Solidity**: `contracts/PiRC217KYC.sol`  
+**Soroban**: `contracts/soroban/src/kyc.rs`
+
+## 4. Implementation Roadmap
+
+- Phase 1 (Q2 2026): Core KYC verification
+- Phase 2 (Q3 2026): zk-proof selective disclosure
+- Phase 3 (Q4 2026): Full regulatory reporting integration
+
+**Status**: Ready for Testnet deployment and community review.

docs/PiRC-221-Privacy-Preserving-ZK-Identity.md

@@ -0,0 +1,15 @@
+# PiRC-221: Privacy-Preserving ZK-Identity
+
+## 1. Overview
+Enables users to prove identity attributes (e.g., age, nationality) without revealing raw data, using Zero-Knowledge Proofs (ZKP) linked to PiRC-209.
+
+## 2. Technical Specification
+- **Proof Verification**: Off-chain generation, on-chain validation.
+- **Privacy**: No PII (Personally Identifiable Information) is stored on the ledger.
+---
+
+## 3. Reference Smart Contracts
+**Solidity**: `contracts/PiRC221ZKIdentity.sol`  
+**Soroban**: `contracts/soroban/src/zk_identity.rs`
+
+**Status**: Ready.

docs/PiRC-241-Zero-Knowledge-Corporate-Identity.md

@@ -0,0 +1,21 @@
+# PiRC-241: Zero-Knowledge Corporate Identity
+
+## 1. Executive Summary
+This standard extends PiRC-209 to provide Zero-Knowledge (ZK) corporate identity. It allows institutions to cryptographically prove accreditation, jurisdiction, and solvency without revealing sensitive corporate data.
+
+**Dependencies**: PiRC-209
+**Status**: Complete reference implementation
+
+## 2. Architecture
+- ZK-SNARK proof verification for corporate attributes
+- Integration with PiRC-209 DID Registry
+- On-chain verifier contracts for institutional gating
+
+## 3. Reference Smart Contracts
+**Solidity**: `contracts/PiRC241ZKCorporateID.sol`
+**Soroban**: `contracts/soroban/src/zk_corporate_id.rs`
+
+## 4. Implementation Roadmap
+- Phase 1: ZK proof generation and verification
+- Phase 2: Corporate DID integration
+- Phase 3: Mainnet institutional gating