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)

A user connects MetaMask and creates a GuardianVault
The user defines:
- Beneficiaries (family members)
- Token type (ERC-20 like USDC)
- Maximum amount
- Time window
- Trigger condition (emergency / inactivity / verified event)
The user grants an Advanced Permission (ERC-7715) to an Executor Agent
(Optional) The Executor Agent re-delegates partial permission to a Verifier Agent (A2A flow)
Agents continuously monitor trigger sources
When the trigger occurs:
- Permissions are validated
- Verifier approval is requested (if enabled)
Funds are released automatically and securely
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!

Guardian Vault

视频

描述