Inheritance Planner

This project is a decentralized application (dApp) that allows users to create secure, on-chain inheritance plans for their crypto assets. After connecting a wallet (either a regular MetaMask wallet or a smart wallet via email/social login using Privy), users can view their current token balances and select from a list of whitelisted tokens (like ETH, USDC, LINK) to distribute to selected heirs.

The user defines how much of each token each heir will receive and sets a due date - the moment from which the plan becomes executable. This means: if the user hasn’t extended the due date (in case they’re still alive), the smart contract considers the user possibly deceased, and the inheritance plan can be executed.

Heirs can log into the dApp with their own wallet to view all the inheritance plans they are part of. For each plan, they can see the due date and the exact amounts of each token they are eligible to inherit. Once the due date is reached, the plan is automatically executed via Chainlink Automation to distribute the tokens to the heirs. However, manual execution by any heir is also possible via the dApp interface.

The dApp offers flexibility for users to extend the due date (e.g., if they’re still alive) or adjust heirs and token distribution at any time before the plan becomes executable.

For the smart contracts, I use Hardhat. There are 4 (at this stage, rather basic) smart contracts:

• WillFactory handles the creation of individual LastWill contracts using the OpenZeppelin clone pattern and maintains the whitelist of allowed ERC20 tokens.

• Each LastWill contract allows the owner to set a due date, add or remove heirs, and execute the inheritance plan when eligible.

• WillEscrow acts as the secure holding contract for tokens that are to be distributed.

• WillRegistry integrates with Chainlink Automation to monitor wills. It uses checkUpkeep and performUpkeep to automatically execute wills once the due date is reached.

For the frontend, I use a Next.js + TypeScript + ShadCN + Tailwind boilerplate. Wallet management is handled via Privy, and Wagmi is used for smart contract interaction.

The dApp has two main pages:

1. A creator page to view token balances, set up a plan, and assign heirs.
2. A heir page that lets heirs view their inheritance plans, with token breakdowns and due dates.