crypto_core_demo/README.md

Sentinel Protocol Demo

This project demonstrates the core concepts of the Sentinel Protocol, a key management and secure data storage solution. It showcases advanced cryptographic techniques for key sharding, data encryption, and restoration under various scenarios (e.g., standard access, inheritance).

Key Features

Based on the main_demo.py workflow:

1. Key Sharding (Initialization)

   • Generation of mnemonic phrases (BIP-39).
   • Splitting secrets using Shamir's Secret Sharing (SSS) into multiple shares (Device, Cloud, Physical).

2. Vault Layer (User Encryption)

   • Derives AES keys from the master secret.
   • Encrypts user privacy data securely.

3. Gateway Layer (System Wrapping)

   • Adds a layer of system-level encryption using RSA.
   • Simulates "double wrapping" for enhanced security and access control.

4. Trigger/Unlock Mechanism

   • Demonstrates how system-level triggers (e.g., death confirmation, subscription lapse) can decrypt the outer layer.

5. Restoration Scenarios

   • Life Access: Recovering data using Device + Cloud shares.
   • Inheritance: Recovering data using Cloud + Physical shares (simulating beneficiary access).
   • Verification: Recovering data using Device + Physical shares.

Documentation

For detailed documentation, please refer to the language-specific guides:

• 中文文档 (Chinese Documentation): cn/README.md
• English Documentation: en/README.md

protocol_whitepaper

• Protocol Whitepaper: doc/protocol_whitepaper.md

Quick Start

Run the main demo script to see the full data flow in action:

python3 main_demo.py