DeWill

Decentralized and Censorship-Resistant Will Management

Platform Workflow

Step 1 & 2: Will Creation & Registration

  1. Select a will file (PDF or JSON)
  2. Upload to IPFS, generating a unique CID
  3. Create 3 guardians and 1 executor using ethers.Wallet
  4. Hash guardian addresses with keccak256
  5. Bundle information into will-keys.json for download
  6. Register will on blockchain with direct transaction
  7. Mint DeWillNFT as certificate of registration

Step 3 & 4: Guardian Confirmations & Execution

  1. Guardians log in with their private keys
  2. ZK-Proof generated based on guardian's private key
  3. Proof sent to blockchain via confirmGuardian function
  4. Once 2/3 guardians confirm, will state is unlocked
  5. Executor uses private key to access will instructions
  6. Executor can reveal CID and execute will instructions

Technologies Used

  • Ethereum Sepolia Testnet
  • Solidity Smart Contracts
  • HTML + Tailwind (Flowbite) + Ethers.js v6
  • Pinata API for IPFS Upload
  • zk-SNARKS with Groth16 Proof
  • Direct transaction signing (no MetaMask)
each held by a different guardian. Only when both parts are combined can the will be decrypted.

ZK-SNARKs

Zero-Knowledge Proofs allow guardians to verify their identity without revealing their private keys. This ensures maximum security and privacy throughout the verification process.

IPFS Storage

Your encrypted will is stored on IPFS via Pinata, ensuring it remains accessible and immutable. Only the content hash is stored on the blockchain, maintaining privacy.

Death Confirmation

The will is only unlocked when at least two guardians have confirmed the death of the will creator. Each guardian provides a part of the decryption key needed to unlock the will.