Project Status: Inactive

This repository is no longer actively maintained and is being preserved for educational or historical reference.

A secure, decentralized Multi-Signature Wallet built on the Stacks blockchain using Clarity smart contracts and a Next.js frontend. This wallet requires multiple predefined signers to approve transactions before they are executed, ensuring greater security and trust for collaborative fund management.

This project implements a fully functional multi-signature wallet dApp, allowing multiple parties to propose, confirm, and execute transactions only when a minimum threshold of confirmations is reached. It is useful for DAOs, joint treasury management, and any shared fund system requiring trust minimization.

• 🌐 Stacks Blockchain
• 📜 Clarity Smart Contracts
• ⚛️ Next.js / React
• 🎨 Tailwind CSS
• 🔗 Hiro Wallet integration
• 🧪 Clarinet for contract testing
• ⛓️ Stacks.js

• 🔐 Multi-sig Authorization – Transactions require approval from multiple owners.
• 🧍 Fixed Owner Set Initialization – A single-use initialize function defines all owners. (Critical!)
• 📤 Proposal Submission – Owners can propose transactions with recipient and amount.
• ✅ Confirmations – Each owner can confirm the proposal.
• 🚀 Execute Transaction – Transactions execute after enough confirmations.
• ⏳ Proposal Expiry – Each proposal includes an expiration block height.
• 📜 On-chain Records – All proposals, confirmations, and executions are stored on-chain.

🔗 GitHub Repository

• Node.js >= 18
• Clarinet (npm install -g @hirosystems/clarinet)
• Hiro Wallet (browser extension)

git clone https://github.com/Metrohan/MultiSigWallet.git
cd MultiSigWallet
npm install

Start frontend:

npm run dev

Start smart contract dev env:

clarinet console

1. Connect your wallet.
2. Enter recipient and amount.
3. Submit the proposal.
4. Other owners can confirm via the UI.
5. Once threshold is met, the proposal becomes executable.

{
  to: principal,
  amount: uint,
  confirmations: (list 10 principal),
  confirmation-count: uint,
  executed: bool,
  expires-at: uint
}

clarinet check
clarinet deployment apply --testnet

Follow instructions to broadcast via Hiro Testnet Explorer.

Replace .toml config with mainnet keys and run:

clarinet deploy mainnet

clarinet deployment apply --testnet

• Write tests in tests/ directory using Clarinet’s test suite.

• initialize can only be called once. If your address is not one of the initial owners, you will not be able to interact with the wallet.
• There is no current add-owner or remove-owner functionality in this implementation.

• Implement optional add-owner / remove-owner logic (post-initialization governance).
• Show real-time proposal list via stacks.js on frontend.
• Add filtering (pending / executed / expired).
• Improve error handling in frontend UI.
• Add email/notification integration for confirmations.
• Finalize README with complete deployment instructions.

We welcome contributions!

1. Fork the repo
2. Create a branch (git checkout -b feature/your-feature)
3. Commit changes (git commit -am 'Add new feature')
4. Push and create a PR

This project is licensed under the MIT License.

For questions, open an issue or contact the maintainer at:
📧 metehangnn@outlook.com
🐦 @metehangnn

• Stacks Foundation
• Hiro Systems
• Clarity Lang
• Clarinet

I was unable to complete my project due to limited internet access. I will add a ToDo list to the README to better explain my purpose.

🛠️ Built with ❤️ on Stacks by [Metehan Günen]