Skip to content

tonycamero/derec

Repository files navigation

🛡️ DeRec Integration for Decentralized Recovery

A modular React-based integration of the DeRec Protocol designed to enable secure, decentralized recovery of digital assets, secrets, and blockchain credentials. This system leverages Hedera’s native services while maintaining extensibility to other platforms like Ethereum and Solana.


🚀 Overview

This app is a complete front-end and service integration of the DeRec decentralized recovery protocol. It allows users to securely distribute, monitor, and recover private keys or digital secrets with the help of trusted "helpers" using Shamir’s Secret Sharing and decentralized coordination.

Key Features

  • ✅ React component for embedding into wallet UIs or recovery portals
  • 🔐 Secret sharing and recovery flow using DeRec helpers
  • 🧩 Hedera-native integration using HCS for transparency and verification
  • 📊 Dashboard for managing helper statuses with daily health indicators
  • 🔁 Auto-rebalancing of secret shares when helpers change
  • 🧪 Visual privacy indicators throughout the user journey
  • 🌐 Cross-platform extensibility (Ethereum, Solana-ready)

📆 Project Structure

/src
  ├── components/     # UI components for DeRec setup, dashboard, and recovery
  ├── services/       # DeRec client logic, Hedera integration, secret sharing logic
  ├── utils/          # Crypto utilities, helper status checks, event polling
  ├── config/         # App/environment configuration
  └── App.tsx         # Entry point

🧩 Core Features

🛠️ Helper Management Dashboard

  • View all designated helpers and their status (active/inactive/unresponsive)
  • Daily verification pings with visual feedback (green/yellow/red)
  • Manual override and helper replacement interface

🔐 Secret Sharing Workflow

  • Setup with clear onboarding: choose number of helpers, assign roles
  • Visual privacy indicators to avoid helper collusion risk
  • Reconstruct secret with threshold logic (e.g., 3 of 5 helpers)

🔁 Auto-Rebalancing System

  • Detects inactive or dropped helpers
  • Automatically redistributes shares to maintain quorum
  • Notifies user of critical changes or required actions

🧬 Decentralized Recovery

  • No centralized entity ever stores the secret
  • User regains access with cooperation from quorum of helpers
  • DeRec ensures transparency using Hedera Consensus Service (HCS)

⚙️ Getting Started

git clone https://github.com/tonycamero/derec.git
cd derec
npm install
npm start

Configure Your .env File

VITE_HEDERA_NETWORK=testnet
VITE_OPERATOR_ID=0.0.xxxxx
VITE_OPERATOR_KEY=302e02...

📡 Protocol Integrations

✅ Hedera Native

  • HCS used for logging recovery events, share confirmations, and dispute resolution
  • Compatible with HashPack, Blade, and other Hedera wallets

🔗 Ethereum / Solana (Planned)

  • Pluggable architecture supports future integration via Web3.js and Solana.js

🧪 Tech Stack

  • React + Vite
  • TypeScript
  • Zustand (state management)
  • Tailwind CSS
  • Hedera SDK (HCS + Mirror Node)
  • Shamir’s Secret Sharing (custom module)

🧠 Future Improvements

  • zkSNARK-based privacy layer for helper verification
  • Institutional analytics dashboard
  • Multi-chain orchestration agent
  • Voice-based AI-assisted recovery flows

🤝 Contributing

Pull requests, feature suggestions, and helper module implementations are welcome.
Open an issue or start a discussion.


📄 License

MIT License © 2025 Tony Camero

About

DeRec onboarding prototype

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages