gitwtfhub

wtf is iron-hands?

makabeez/iron-hands — explained in plain English

Analysis updated 2026-05-18

0HTMLAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A self-lock smart contract vault on the Monad blockchain that lets you deposit funds and lock them against early withdrawal to stop yourself from revenge trading.

Mindmap

mindmap
  root((repo))
    What it does
      Locks deposited funds
      One way lock extension
      No admin or rescue
      Live countdown UI
    Tech stack
      Solidity
      Foundry
      ethers.js
      Monad
    Use cases
      Self imposed trading cooldown
      Personal circuit breaker
    Audience
      Crypto traders
      Solidity developers

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

Lock your own crypto funds for a set period to prevent impulsive trading.

REASON 2

Deploy a personal vault contract with no admin or rescue backdoor.

REASON 3

Study a minimal Solidity contract pattern for one way time locks.

REASON 4

Run and test a small Foundry project with zero external dependencies.

What's in the stack?

SolidityFoundryethers.jsMonad

How it stacks up

makabeez/iron-hands100/rutgers-pbl-dining-2015a15n/a15n_old
Stars0
LanguageHTMLHTMLHTML
Last pushed2015-12-012016-06-18
MaintenanceDormantDormant
Setup difficultymoderateeasyeasy
Complexity3/51/51/5
Audiencedevelopergeneralgeneral

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Foundry installed and testnet MON from a faucet to deploy.

MIT licensed, so the code can be used freely for any purpose, including commercial use, as long as the copyright notice is kept.

Wtf does this do

Iron Hands is a small smart contract project built to solve a very personal problem for the creator: revenge trading. The idea is that after a losing trade, the urge to immediately try to win the money back, often late at night when judgment is at its weakest, has cost the author more money than any bad trading decision ever did. Soft solutions like closing the app or moving funds to a separate wallet do not work because they can always be undone in the moment. Iron Hands is built so that undoing it is not possible. The project is a vault deployed on Monad, a blockchain network, where you deposit funds yourself and then lock them for a chosen period of time, such as one hour, one day, one week, or one month. Once locked, trying to withdraw before that time is up simply fails, the transaction reverts. You are allowed to extend a lock further into the future at any point, but you can never make it shorter. There is no owner, no admin account, no pause switch, and no way for anyone, including the creator, to unlock funds early or rescue them. The rule is enforced entirely by the contract's code. The system is small by design, built with Solidity and tested using Foundry, with all nine of its tests passing and zero external code dependencies. The front end is a single HTML file that uses the ethers.js library to talk to the blockchain, with no separate backend server and no build process required. The interface shows a simple green or red indicator along with a live countdown for how long the vault stays locked. To try it locally, a developer would install Foundry's testing tools and run the test suite, or deploy the contract to the Monad testnet using a single command line instruction, after which they would host the included web page and point it at the deployed contract's address. This project was built solo for a hackathon focused on building tools that solve a personal problem, and it is released under the MIT license.

Yoink these prompts

Prompt 1
Explain how the one way lock extension logic works in the IronHands contract.
Prompt 2
Walk me through deploying this contract to the Monad testnet with Foundry.
Prompt 3
Show me how the front end index.html connects to the contract with ethers.js.
Prompt 4
Help me write additional Foundry tests for this vault contract.

Frequently asked questions

wtf is iron-hands?

A self-lock smart contract vault on the Monad blockchain that lets you deposit funds and lock them against early withdrawal to stop yourself from revenge trading.

What language is iron-hands written in?

Mainly HTML. The stack also includes Solidity, Foundry, ethers.js.

What license does iron-hands use?

MIT licensed, so the code can be used freely for any purpose, including commercial use, as long as the copyright notice is kept.

How hard is iron-hands to set up?

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

Who is iron-hands for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

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