TugatheCat

The Instruction Sheet, Not the Key: Why Losing a Descriptor Loses Your Coins

Tuga watering Plants

Somebody once gave me a cat flap as a gift. Good one, electronic, microchip-reading — and it arrived as a box of parts with no instructions. I had the hinge, the frame, the sensor, the screws. Every physical component was present and correct.

It sat in the garage for four months, because having all the pieces is not the same as knowing how they go together.

There is a version of this in self-custody that quietly costs people everything, and almost nobody hears about it until it's too late. A reader on Nostr put it better than I could: losing a descriptor is the quietest way to go broke.

1. What a Descriptor Is

Your seed phrase is the secret. The descriptor is the instruction sheet that says what to build out of it.

It's a compact line of text that specifies: which keys are involved, what script type they use, how they combine, and which derivation paths to follow. Something like wpkh([a1b2c3d4/84h/0h/0h]xpub.../0/*) — ugly, unmemorable, and the thing that turns your words into your specific addresses.

Here's the part that surprises people: the seed alone does not fully determine your wallet. The same twelve words, interpreted under different rules, produce entirely different sets of addresses. Different script type, different addresses. Different derivation path, different addresses. Different combination of keys, different addresses again.

The seed is the key material. The descriptor is what you're supposed to do with it.

2. Why Single-Sig Users Usually Get Away With It

If you have an ordinary single-signature wallet, you've probably never heard of this, and the reason is that wallet software guesses for you — successfully, almost always.

Modern wallets try the standard paths and standard script types in turn, scan each for a balance, and stop when they find your coins. The conventions are strong enough that the guess works nearly every time. That's why "restore from twelve words" feels like magic rather than like archaeology.

So for most readers, this article is a curiosity. Keep reading anyway, because the moment you step outside the defaults, the guessing stops working.

3. Where It Actually Bites

  • Multisig. This is the big one. A 2-of-3 wallet needs to know which three keys and what policy combines them. No amount of searching recovers that — the space of possibilities is effectively infinite. You can hold all three seed phrases and still be unable to reconstruct the wallet. All the pieces, no instruction sheet, coins visible on-chain and permanently unspendable.
  • Timelocks and custom policies. Same problem, worse. Anything expressed in miniscript lives in the descriptor by definition.
  • Non-standard derivation paths. Some older wallets and some hardware devices used paths that aren't in the common search set. The coins are there. Your new wallet looks in the usual places and reports zero.
  • Passphrases. Technically a different mechanism, same failure shape: correct words, wrong (or missing) extra input, wallet opens empty and looks like it always was.

That's the cruelty of it. There's no error message, no force-close, no alarming event. Just a balance of zero that looks exactly like a wallet nobody ever funded.

4. How to Back It Up

The good news: the descriptor contains no private keys. It's public information. You cannot be robbed with it — though anyone holding it can see every address in that wallet forever, so treat it like a bank statement rather than a bank card.

Which means backing it up is easy, and there's no excuse:

  • Export it from your wallet software. Sparrow, Specter, BlueWallet, Nunchuk and most multisig-capable wallets will export the descriptor or a wallet-config file. Do it the day you create the wallet.
  • Store it with every seed copy, and in more places besides. It isn't secret, so redundancy costs you nothing. Printed in the file with your will. On the metal plate's envelope. In a password manager. With the person who holds the third key.
  • Store it in human-readable text, not only as a QR or a proprietary backup file from an app that may not exist in fifteen years.
  • Name the software. "This is a 2-of-3 multisig created in Sparrow" is worth almost as much as the descriptor itself to whoever has to rebuild it.

5. The Test That Proves It

Everything in this series comes back to the same drill, and here it applies with a twist:

Rebuild the wallet from the backup alone — seeds and descriptor — on a clean machine, in different software if you can. Not restored from the app that still has it cached. From the paper and the metal, as though you were your own executor.

If it comes back and the balance is right, your backup is real. If it doesn't, you have just learned something enormous on a day when it costs you nothing.

Do it once at creation and once a year, alongside the seed restore drill. Same afternoon, same calendar reminder.

The Point

Every screw was in the box. The hinge was fine, the sensor worked, nothing was missing or broken. It still wasn't a cat flap for four months, because the knowledge of how the parts fit together is itself a part — and it's the one nobody thinks to protect, because it doesn't look like anything valuable.

Your seeds are the components. The descriptor is the sheet that says how they assemble. Back up both, or one day somebody holds everything you left them and still can't open the door.

The words are the key. The descriptor is the lock they fit. Keep both. 🐾⚡

How do you rate this article?

0


TugaTheCat
TugaTheCat

My name is Tuga and I'm a cat that loves cripto market.


TugatheCat
TugatheCat

Welcome to Tuga the Cat! I am a professional Technical Writer sharing practical advice and daily experiences from raising three adult cats. This blog provides clear, easy-to-follow guides on feline care, behavior, and daily maintenance. Whether you need tips on managing large breeds, optimizing their environment, or choosing the best tech accessories for your pets, you will find well-researched and actionable advice right here. https://www.youtube.com/@TugatheCat

Publish0x Publish0x

Reward the author with $0.01 in crypto, and earn yourself as you read!

20% to author / 80% to me.
Rewards are FREE. Publish0x pays them, not you.

Page not displaying correctly?