Skip to main content
All CollectionsHardware Wallets & Integration
How to add a Coldcard to your vault
How to add a Coldcard to your vault

Steps to pairing a Coldcard with Theya for a singlesig or multisig vault.

J
Written by Jake Morr
Updated over 6 months ago

After creating your Theya account, you can continue to set up your vault(s). Here is the process for adding a Coldcard hardware device(s) to your multisig or singlesig vault.

For new devices (if you have have not generated a private key and seedphrase backup), follow the Coldcard Quickstart Guide to set up your Coldcard(s) before pairing with a Theya vault.

Note: With all single-sig or multisig wallet setups, it's at the user(s) discretion how to secure and store their physical hardware device(s) and recovery seed phrases.


Demo Video

Watch @JoeConsorti set up a 2-of-3 multisig vault with a Coldcard MK4 and a Trezor Safe 3. Subscribe to Theya for market updates and more tutorials.


Pairing A Coldcard: First Steps

  • Select 'Create New Vault' and select vault type

    • Single Key (singlesig vault)

    • Three Keys (2-of-3 multisig vault)

With a multisig vault, you will generate you Recovery Key with Theya prior to paring your device. Otherwise, the general process of pairing a Coldcard is the same regardless of vault type.

  • Select ‘New Hardware Device.’ Then select ‘Coldcard’ from the manufacturer options and choose the specific device you are pairing.

    • Coldcard MK4

    • Coldcard Q (Coming Soon)

  • Select "Send Pairing Instructions" and instructions will be sent to the email associated with your Theya account.

  • Open this email on a desktop computer and ensure you have your hardware device (with pin) ready for pairing.

    • For air-gapped pairing, you will need your microSD card, card reader, and power-only USB cable.

    • Air-gapped connectivity is advised, but if connecting via USB, you will need the USB cable(s) compatible with Coldcard device(s). The process will be the same, except your USB connected Coldcard will emulate a disk drive.

  • Click the ‘Add Hardware Wallet’ link provided in the email, and a new browser tab will open a Theya web application.


Pairing A Coldcard: Web Application

Follow the guided steps on the web application to pair your Coldcard. This will guide you through the step-by-step process of exporting public keys and configuring your device.

Prepare Your Coldcard & Export XPUB

  • Activate your Coldcard by entering your pin.

  • Insert your microSD card into the device and navigate to Advanced/Tools > Export Wallet > Generic JSON

  • Follow instructions on the device instructions and use "0" when prompted for Account Number

You've successfully exported your XPUB from your Coldcard to the microSD card.

Transfer XPUB To Computer & Upload To Theya

  • Remove the microSD card from your Coldcard and insert into your computer's card reader.

  • On your computer, navigate to the microSD card and location the .json file.

  • Import to the Theya web application (drag and drop or click to upload).

  • Confirm details and add your Coldcard to your vault

You've successfully imported your XPUB to your Theya Vault.

Download Configuration File & Import To Coldcard

  • Ensure your microSD card in inserted in your computer.

  • Download the .txt file and save to the microSD card.

  • Insert the microSD card back into your Coldcard

  • Navigate to Settings>Multisg Wallets>Import from File

  • Select the .txt file and follow Coldcard prompts to import.

    • The Theya web application will display the file name you are looking for.

  • Check the box to confirm you have successfully imported the configuration file and select Complete Policy Registration.

You've successfully imported your wallet configuration file to your Coldcard.

Explore Your Vault (Or Continue To Second Key)

Your Coldcard is now successfully paired with Theya. If creating a singlesig vault, or if this is the second key in a multisig vault, you can now explore your new created vault and receive funds! If this is the first key in a multisig vault, continue adding your second key.

Verify Vault Functionality

To check the functionality of your vault, use the health check feature found under Key Management on your vault homepage.


Schedule a free consultation to discuss your specific needs!


🔍 Learn More About Bitcoin

📚📖 Theya’s blog is a resource for learning and sharing Bitcoin fundamentals.

📉📈 Subscribe to Theya’s newsletter for weekly Bitcoin market reports.

Did this answer your question?