Learn by doing

Two end-to-end walkthroughs that take you from a fresh testnet account to a successful multi-sig ceremony. Read the README, run the scripts, see real transactions land on HashScan.

You're on the testnet dApp — the right place to follow these walkthroughs. Get a free testnet account at portal.hedera.com.

HBAR walkthrough

30-minute end-to-end: generate three keys, create a 2-of-3 threshold-key account, run a real multi-sig ceremony, and verify on the mirror node. Treasury teams that only move HBAR or fungible tokens can stop here.

  • · Threshold-key account creation
  • · CLI participant + dApp coordinator flow
  • · Mirror-node confirmation
Open on GitHub →

Smart-contract walkthrough

Deploy a Counter contract as a single-sig EOA, interact normally, then convert the account to 2-of-3 multi-sig and prove single-sig is dead. Teaches every common contract path.

  • · ContractCreateFlow deployment
  • · EOA → multi-sig via AccountUpdate
  • · Negative test proving authorization changed
  • · Multi-sig increment() + withdraw()
  • · Alternate: deploy directly as multi-sig (HIP-423)
Open on GitHub →

Prerequisites

  1. Get a testnet account at portal.hedera.com (free; auto-funded with ~10,000 ℏ).
  2. Clone the repo from github.com/lazysuperheroes/hedera-multisig and run npm install.
  3. Copy .env.example to .env and set OPERATOR_ID + OPERATOR_KEY.
  4. Run node 00-precheck.js in either walkthrough directory — verifies env, balance, and dependencies.

Deeper reading