gitwtfhub

wtf is keyheir?

only1angelnath/keyheir — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · generalComplexity · 3/5LicenseSetup · moderate

TL;DR

A crypto inheritance tool on Monad where you deposit funds into your own vault and set a beneficiary, if you stop checking in, anyone can trigger the release to them.

Mindmap

mindmap
  root((KeyHeir))
    What it does
      Dead man switch vault
      Check in resets timer
      Permissionless claim
    Tech stack
      Solidity
      Foundry
      React
      Python
    Use cases
      Pass crypto to family
      Avoid trusting a custodian
      Set beneficiary with timer
    Audience
      Crypto holders
      Developers
    Setup
      Connect wallet
      Create vault
      Deposit and check in

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Set up a beneficiary who can automatically receive your crypto if you stop checking in.

REASON 2

Avoid sharing your seed phrase in advance while still planning for crypto inheritance.

REASON 3

Send Telegram reminders and beneficiary notifications around a check-in deadline.

What's in the stack?

SolidityFoundryReactPythonMonad

How it stacks up

only1angelnath/keyheir0xradioac7iv/tempfs52191314/web-agent-proxy-sdk
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity3/53/54/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Currently deployed only on Monad Testnet, running the bot requires a Telegram bot token and environment configuration.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

KeyHeir is a crypto inheritance tool built for the Monad blockchain. It solves a real problem with self custody crypto wallets: unlike a bank account, there is no built in way for a family member to claim your funds if you die or become unable to access your wallet, unless you already shared your seed phrase with them in advance, which creates its own risk of theft or loss. With KeyHeir, a user deploys their own personal smart contract vault, deposits crypto into it, and sets a beneficiary address along with a check in interval, such as checking in once a month. Checking in resets a countdown timer. If the user ever goes silent past that deadline, the vault becomes claimable by anyone, meaning literally any wallet can trigger the release, and the funds are sent to the beneficiary address. The project also includes a small companion program that sends check in reminders as the deadline approaches and notifies the beneficiary once a release happens, but this program never holds funds or keys itself, it only watches the blockchain and sends messages. The project emphasizes that a user's private key never touches KeyHeir at any point, since the whole point is to avoid trusting any company or person with access to funds. Each user gets their own separate vault contract rather than having funds pooled together with other users. Anyone can trigger the release once the deadline passes, which is intentional: it means no company or admin needs to approve or enforce the release for it to work. There is no way for anyone, including the people who built KeyHeir, to freeze, redirect, or take funds out of a vault once it is deployed, since the contract has no admin controls or upgrade path. The project includes a website for connecting a wallet and managing a vault, smart contracts written in Solidity, and a Python bot that sends Telegram notifications. It was built for a hackathon and is currently deployed only on Monad's test network, not the real network. The code is released under the MIT license, meaning it can be reused and modified freely.

Yoink these prompts

Prompt 1
Explain how KeyHeir's check-in and claim mechanism works so I can decide if it fits my situation.
Prompt 2
Help me set up a local KeyHeir vault using Foundry and connect it to the frontend.
Prompt 3
Walk me through configuring the Python notification bot with my Telegram bot token.
Prompt 4
Explain why KeyHeir's claim function is permissionless and why that matters for trust.

Frequently asked questions

wtf is keyheir?

A crypto inheritance tool on Monad where you deposit funds into your own vault and set a beneficiary, if you stop checking in, anyone can trigger the release to them.

What language is keyheir written in?

Mainly TypeScript. The stack also includes Solidity, Foundry, React.

What license does keyheir use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is keyheir to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is keyheir for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.