diff --git a/docs/PiRC-209-Sovereign-Decentralized-Identity-Standard.md b/docs/PiRC-209-Sovereign-Decentralized-Identity-Standard.md new file mode 100644 index 000000000..8ec70c9c2 --- /dev/null +++ b/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) diff --git a/docs/PiRC-217-Sovereign-KYC-and-Regulatory-Compliance-Layer.md b/docs/PiRC-217-Sovereign-KYC-and-Regulatory-Compliance-Layer.md new file mode 100644 index 000000000..0d6704566 --- /dev/null +++ b/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. diff --git a/docs/PiRC-221-Privacy-Preserving-ZK-Identity.md b/docs/PiRC-221-Privacy-Preserving-ZK-Identity.md new file mode 100644 index 000000000..dcb24155a --- /dev/null +++ b/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. diff --git a/docs/PiRC-241-Zero-Knowledge-Corporate-Identity.md b/docs/PiRC-241-Zero-Knowledge-Corporate-Identity.md new file mode 100644 index 000000000..1045694eb --- /dev/null +++ b/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