Step-by-Step Multisig Setup Guide in Nunchuk Wallet (Desktop) (2-of-3 Example with Trezor, OneKey, and Jade)

Summary: Setting up a Multisig wallet on the Nunchuk Desktop application is divided into 2 main steps: 1. Add Keys to import the public key (xPub) from each hardware wallet into the application. 2. Create Wallet to set the signature threshold, such as 2-of-3 on the Native SegWit standard, and then link the registered keys together.

After you have learned what beginners should know before using a Multisig Wallet and understand the importance of using Multi-Vendor Multisig to prevent Supply Chain Attacks, the most common question we receive is: "Once I have purchased all the devices, where do I click to link them together on my computer?"

The concern for those opening the Nunchuk Desktop application for the first time often stems from looking for the Create Wallet button and trying to connect the devices immediately, but not knowing where to add the keys first, or seeing unfamiliar device names after connecting different brands and not daring to click further. Today, we have summarized the step-by-step setup process that you can follow click by click.

Understanding How Nunchuk Works Before You Start: Separating "Keys" from the "Wallet"

Before you start creating a wallet in the Nunchuk application, we want you to understand the basic structure of how the app works first. Simply imagine it like going to open a "joint account with your partner or someone in your company" at the bank. The process is clearly divided into 2 parts that you must complete in order, as follows:

⚠️ The Most Important Warning Before Starting Multisig Setup

WARNING: Before linking each device to Nunchuk, you must always set up the initial configuration for each hardware wallet and back up the Seed Phrase (12 or 24 words) for every device separately first.

And most importantly, after creating the Multisig wallet, never forget to save the wallet configuration file (Wallet Configuration / BSMS File) as a backup alongside your Seed Phrase. In a Multisig system, having only the Seed Phrase may not be enough to recover the wallet in case of an emergency (learn more about BSMS file recovery from Nunchuk). You should also always test transferring a small amount of coins and practice recovery before transferring your main assets into the wallet!

Steps for Setting Up Multisig on Nunchuk Desktop (3 of 3 ; Trezor, Onekey, Jade)

Part 1: Add Keys to the Application (Add Keys)

   ├── Option 1: Trezor → Select Add a wired key (via USB cable)

   ├── Option 2: OneKey → Select Add a wired key (via USB cable / displays as Trezor)

   └── Option 3: Blockstream Jade → Select via USB cable or Add an air-gapped key (scan QR in Multisig m/48'/0'/0'/2' mode)

         ↓

Part 2: Create a Multisig Wallet (Create Wallet)

   └── Click + in the Wallets menu → Select Custom wallet → Name it and select Native SegWit

         ↓

Part 3: Set Conditions and Link Keys (Configure Wallet)

   └── Select all keys (e.g., 3 keys) → Set Required keys (e.g., 2 keys) → Click Assign signer (Complete)

Part 1: How to Add Keys from a Hardware Wallet to Nunchuk

In this first part, you can choose to add keys from the Hardware Wallet brand you own. In this example, we will demonstrate all 3 popular brands for setting up a Multi-Vendor Multisig, namely Trezor, OneKey, and Blockstream Jade.

1.1 How to Add a Trezor Key (via USB Cable)

1. Click the Add Key button in the main menu: Open the Nunchuk Desktop application, then click the + sign in the Keys menu bar on the left side of the screen.

2. Read the instructions and click Continue: The system will display 2 Before You Start notification windows. Once you have read and understood them, click the Continue button.

3. Name the key and connect the device via cable: The system will prompt us to enter details and retrieve information from the device in the following order:

4. Verify the successfully added key information: After clicking add key, the screen will display the Trezor key details in the Keys menu bar, completing the process for the first device.

1.2 How to add a OneKey key (via USB cable)

1. Click the button to add the second key: Click the + sign in the Keys menu bar on the left again

2. Read the instructions and click Continue: When both (Before you start) notification windows appear, click the Continue button

3. Name the key and connect the OneKey device: Enter the details and retrieve the key information following these steps:

💡 Important note for OneKey users: When using OneKey on the Nunchuk Desktop program, the app will detect and display the device type as Trezor. Please do not worry that there is a problem with the device, as OneKey's open-source firmware architecture is developed based on Trezor's structure and has Trezor Compatibility Mode enabled by default, allowing leading Bitcoin management programs such as Nunchuk or Sparrow to communicate with the device via the same standard protocol smoothly and 100% securely as before.

4. Verify the successfully added key information: Once the system finishes saving the information, the OneKey key list we named will appear in the Keys list.

1.3 How to add a Blockstream Jade key (via Air-Gapped QR Code)

For Blockstream Jade, you can choose to add a key to Nunchuk in 2 ways: via USB cable (Wired) and via QR Code scanning camera (Air-Gapped).

If you want to connect via USB cable, you can follow the same steps as Trezor and OneKey above. But for those who want to enhance security to 100% wireless mode (without connecting the power cable to the computer at all), I have summarized the xPub retrieval method via QR Code screen for you to follow easily as follows:

1. Click the button to add the third key: Click the + sign in the Keys menu bar on the left

2. Read the instructions and click Continue: When both (Before you start) notification windows appear, click the Continue button

3. Name the key and select wireless mode on Nunchuk: In the key settings window, enter the following initial details:

4. Set up the Blockstream Jade device to display the Multisig mode QR Code: Pick up the Blockstream Jade device and follow the sequence on the device screen as follows:

5. Scan the QR Code into the Nunchuk program: Once the Jade screen displays the QR Code of the m/48'/0'/0'/2' path, return to click the Scan QR button on the Nunchuk Desktop program, then hold the Jade screen up to the computer's webcam. Once scanned successfully and the key details appear, click the Continue button

6. Verify the successfully added key information: The Nunchuk screen will display the Blockstream Jade key information added to the system, completing the process.

📌 Additional tips from Admin (based on actual testing): Although the Blockstream Jade can be successfully scanned when adding a key wirelessly (Air-Gapped), when Admin tested signing a real coin transfer transaction (Sign Transaction) on Nunchuk Desktop, it appears that it cannot successfully sign in Air-Gapped mode. (This may be due to limitations of the current software version, or it may be specific to Admin's machine environment, and there may be an update in the future to make it work more smoothly.)

Therefore, for the best reliability and convenience when actually using it, Admin recommends that friends add the key and use the Blockstream Jade on Nunchuk Desktop by connecting it via cable (Add a wired key), similar to Trezor and OneKey. It will be more stable and convenient.

Friends can use the above method to add the keys to the desired number for their own Multisig structure.

Part 2: How to Create a Multisig Wallet and Link Keys (Create & Configure Wallet)

Once we have registered all 3 keys in the Keys menu, the next step is to create a vault and link those keys together.

1. Click the button to start creating a new wallet: Click the + sign in the upper left corner, next to the Wallets heading

2. Select the custom wallet creation method: When the Create wallet window appears, click the Custom wallet heading

3. Name the wallet and select the Address format: The system will let us enter the desired wallet name in the name field, and for the Address type heading, select Native SegWit (which helps save the most on transfer fees and is the main standard in the industry). Then click Continue

4. Select the keys and set the minimum number of signatures (M-of-N): In the Configure wallet window, we set the wallet's security conditions as follows

5. Complete the Multisig wallet creation: The system will create a new Multisig wallet and display it in the Wallets menu, ready to use immediately. (And don't forget to go to the wallet settings to save the Wallet Config / BSMS structure file as a backup!)

Summary

Moving up to use the Multi-Vendor Multisig system on a program like Nunchuk Desktop may seem to involve a few more steps on the first day when we have to register keys one device at a time, but in exchange for eliminating the single point of failure from our lives, no longer having to worry about device failure, device loss, or physical threats again, this is the most worthwhile investment of time and effort for those who truly want to hold Bitcoin long-term.

And don't forget that an equally important foundation to setting up a Multisig system is choosing genuine devices from the start. Ordering a Hardware Wallet through an Authorized Reseller in Thailand like Bitcast will help friends be confident that every device is shipped directly from the manufacturer, has a Thai center warranty, and has a team of experts ready to provide support and advice throughout use.

If friends follow this guide and get stuck at any step, or want to consult on designing a Multisig device set suitable for their own portfolio size, you can comment and chat below, or message the Bitcast team anytime.

Basic Troubleshooting for Common Issues

1. Click the Refresh devices button, but the program does not find the Trezor or OneKey device

2. The Blockstream Jade QR Code cannot be scanned, or scanning it shows an invalid path alert

Frequently Asked Questions (FAQ)