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

Videos

Description

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!


Progress During Hackathon

NA

Tech Stack

Next
React
Web3

Fundraising Status

NA

Team Leader
AAyush Kumar
Sector
DeFiAI