hackquest logo

Guardian Vault

Guardian Vault is a family-oriented, permission-based inheritance and emergency wallet system.It allows users to create Shared Vaults Inheritance planning Emergency access Family fund management

Video

Công nghệ sử dụng

Next
React
Web3

Sự miêu tả

GUARDIANVAULT


🎯 TAGLINE

"Secure family assets. Delegate with limits. Inherit with confidence."

Inheritance planning without private keys — powered by MetaMask Advanced Permissions


📋 PROJECT INFORMATION

Field

Details

Category

🔐 DeFi & Finance | 👨‍👩‍👧‍👦 Family & Estate Planning

Hackathon

MetaMask Advanced Permissions Dev Cook-Off 2024

Live Demo

🌐 https://v0-guardian-vault-family-wallet.vercel.app/

GitHub

💻 https://github.com/ZINKUNO/guardian-vault-family-wallet

Built In

7 days


🚨 THE PROBLEM

Current Inheritance Solutions Are Fundamentally Broken

Solution

Problems

Risk Level

Share Private Keys

• No spending limits
• Keys can be stolen/lost
• Full wallet access forever
• One compromise = total loss

🔴 CRITICAL

Multisig Wallets

• Complex technical setup
• Expensive gas per operation
• Requires 2-3 signatures always
• Fails if signers unavailable

🟡 HIGH

Traditional Will

• 3-7% lawyer fees
• 6-18 month probate wait
• Crypto assets frozen
• Public court process

🟠 MEDIUM

ERC-20 Approvals

• Unlimited token access
• Can't set time conditions
• Can't auto-revoke
• Dangerous for large amounts

🔴 CRITICAL

The Core Challenge

"I want my family to inherit my crypto if something happens to me, but I don't want to give them my private keys, pay thousands in legal fees, or set up complex multisigs."

This is impossible with existing Web3 infrastructure — until now.


💡 OUR SOLUTION

GuardianVault: Permission-Based Inheritance System

GuardianVault uses MetaMask Advanced Permissions (ERC-7715) to create:

Key Innovation Matrix

Traditional

GuardianVault

❌ Full private key access

✅ Limited permissions only

❌ Forever or nothing

✅ Time-bound + revocable

❌ Manual every transaction

✅ Auto-execute after trigger

❌ One person = one risk

✅ Multi-agent verification

❌ No spending caps

✅ Exact amount limits

❌ Can't audit actions

✅ Full on-chain trail

HOW IT WORKS

Complete User Journey

🧠 How GuardianVault Works (Simple Explanation)

  1. A user connects MetaMask and creates a GuardianVault

  2. The user defines:

    • Beneficiaries (family members)

    • Token type (ERC-20 like USDC)

    • Maximum amount

    • Time window

    • Trigger condition (emergency / inactivity / verified event)

  3. The user grants an Advanced Permission (ERC-7715) to an Executor Agent

  4. (Optional) The Executor Agent re-delegates partial permission to a Verifier Agent (A2A flow)

  5. Agents continuously monitor trigger sources

  6. When the trigger occurs:

    • Permissions are validated

    • Verifier approval is requested (if enabled)

  7. Funds are released automatically and securely

  8. Every step is auditable, revocable, and transparent

✅ No private keys shared
✅ No custodial control
✅ Fully permission-based execution


🔐 MetaMask Advanced Permissions (ERC-7715)

GuardianVault deeply integrates MetaMask Advanced Permissions using the Smart Accounts Kit.

How we use Advanced Permissions:

  • Grant agents limited ERC-20 spending authority

  • Enforce:

    • Max spend amount

    • Time-bound validity

    • Contract-specific execution

  • Support agent-to-agent (A2A) delegation

  • Permissions are:

    • Revocable anytime

    • Visible in MetaMask

    • Non-custodial by design

This ensures agents can help — but never misuse funds.

Permission Scope Configuration

Permission Feature

Configuration

Purpose

Token Type

Native ETH or ERC-20 USDC

What assets agent can transfer

Max Amount

5 ETH or $1000 USDC

Hard cap per permission

Period Duration

30 days (recurring)

Auto-reset allowance

Start Time

Trigger timestamp

Can't execute before

Expiry

1 year from grant

Auto-expires if unused

Allowed Targets

[beneficiary1, beneficiary2]

Only these addresses

Value Per TX

1 ETH max per call

Prevent single large drain


🤖 Agent-to-Agent (A2A) Security Flow

GuardianVault introduces a two-agent approval model:

  • Executor Agent
    Executes fund transfers when conditions are met

  • Verifier Agent (Optional)
    Receives a sub-delegated permission to approve or reject execution

This creates multi-party verification without multi-sig complexity, making inheritance safer and more human-friendly.


📊 Envio Indexing Integration

GuardianVault uses Envio to provide a real-time transparency layer.

What Envio indexes:

  • Vault creation events

  • Permission grants & revocations

  • Agent delegation trees

  • Fund release events

Why this matters:

  • Families can see exactly what permissions exist

  • Judges can verify Advanced Permissions in action

  • Creates a live dashboard for auditability and trust

Envio turns GuardianVault from a black box into a fully observable system.


🎯 Why GuardianVault is Unique

  • 🚫 Not another DCA or trading bot

  • 👨‍👩‍👧‍👦 First family-focused crypto inheritance system

  • 🛡️ Uses permissions instead of private keys

  • 🔁 Introduces A2A permission re-delegation

  • 🌍 Solves a real-world human problem, not just DeFi mechanics

📈 IMPACT & METRICS

Problem Scale

Statistic

Source

Impact

$140 billion

US Probate Costs (Annual)

Lost to legal fees

6-18 months

Average Inheritance Wait

Families can't access funds

$3+ billion

Lost Crypto (2023)

Unrecoverable due to lost keys

62%

Americans without estate plan

Unprepared families

$280 billion

Crypto Market Cap

Growing inheritance need

🙏 ACKNOWLEDGMENTS

Built during the MetaMask Advanced Permissions Dev Cook-Off using:

Technology

Usage

🦊 MetaMask Smart Accounts Kit

Core permission system

📊 Envio

Event indexing & GraphQL API

🌐 Pimlico

Account abstraction bundler

Viem & Wagmi

Ethereum client libraries

🎨 Vercel

Hosting & deployment

Special thanks to the MetaMask and Envio teams for their excellent documentation and support!


Tiến độ hackathon

NA

Trạng thái huy động vốn

NA
Trưởng nhóm
AAyush Kumar
Liên kết dự án
Ngành
DeFiAI