Glossary
Words are in alphabetical order. Other pages on this site link here the first time they use a term.
Address
Section titled “Address”A string of letters and numbers that someone pays to, like an account number. Each address comes from one of your keys. This project uses native SegWit addresses (BIP84), which start with tb1q on test networks and bc1q on mainnet.
Air gap
Section titled “Air gap”A gap with no connection across it: no cable, no Wi-Fi, no Bluetooth. An air-gapped signer never connects to the computer. Here, the only way data crosses is as QR codes that each side shows on its screen and the other side scans.
Animated QR
Section titled “Animated QR”A QR code that changes frame by frame, because the data is too big for one code. The scanner collects the frames and puts the data back together. This project uses the UR format for it.
The Bitcoin standard for hierarchical deterministic (HD) wallets: how one seed produces a whole tree of keys. Each key has a path, such as m/84'/1'/0'/0/0, that says how to reach it from the root. (BIP32 spec)
The Bitcoin standard that turns a seed into a list of 12 or 24 words from a fixed list of 2048 English words. The last word includes a checksum, so most typing mistakes are caught. An optional passphrase can be added. (BIP39 spec)
The Bitcoin standard for single-key native SegWit wallets. It fixes the key paths (m/84'/0'/0' on mainnet; test networks use 1' in the second place) and the address type. This project uses BIP84 on signet. (BIP84 spec)
Block explorer
Section titled “Block explorer”A website that shows every transaction and block on a Bitcoin network. You can look up a txid or an address there. Signet has its own explorers.
Broadcast
Section titled “Broadcast”Sending a signed transaction to the Bitcoin network, so it can be included in a block. In this project, Sparrow Wallet broadcasts. The signer never connects to the network.
Change
Section titled “Change”A transaction spends whole coins (UTXOs). If a coin is worth more than you’re sending, the rest comes back to an address of your own. That returning part is the change. A signer must check that change really goes back to you; this one checks it itself.
What a transaction pays the network to be included in a block. It is the total of the inputs minus the total of the outputs. Nobody states it directly, so a signer has to work it out.
Fee rate
Section titled “Fee rate”The fee divided by the transaction’s size, in satoshis per virtual byte (sat/vB). It decides how quickly a transaction confirms. The device warns you before approving a very high fee or fee rate.
Fingerprint
Section titled “Fingerprint”A short ID for a wallet: 8 characters worked out from its master key. It isn’t secret. After loading a seed, the device shows its fingerprint so you can check you typed the seed (and passphrase) correctly.
Flash encryption
Section titled “Flash encryption”A chip feature that encrypts everything stored in the board’s flash memory, so reading the flash chip directly shows nothing useful. It isn’t enabled on this prototype. Phase 9 only documents how it would be done.
Hardware wallet
Section titled “Hardware wallet”A small device that keeps the secret behind your bitcoin away from your everyday computer, and uses it only to sign transactions after you approve them on its own screen. It is also called a signing device.
One of the coins (UTXOs) a transaction spends. A transaction with two inputs spends two coins.
Mainnet
Section titled “Mainnet”The real Bitcoin network, where coins have real value. This project doesn’t support mainnet and must never be used with real funds. Compare signet, testnet and regtest.
Output
Section titled “Output”Where a transaction sends money: an address and an amount. A typical payment has one output to the person you pay and one change output back to you.
Passphrase
Section titled “Passphrase”An optional extra word or phrase added to a BIP39 seed. A different passphrase gives a completely different wallet, with no error message, so the fingerprint is how you check you typed it right.
Partially Signed Bitcoin Transaction (BIP174): a standard file format for a transaction that still needs signing. The computer builds it and the signer signs it. Besides the transaction, it can carry the extra data the signer needs to check it, such as the coins being spent and the key paths.
Extra RAM on a separate chip next to the processor. The ESP32-CAM has 4 MB of it; the classic ESP32 DevKit usually has none.
QR code
Section titled “QR code”A square barcode that a camera can read. In this project, QR codes are the only way data moves between the computer and the device.
Regtest
Section titled “Regtest”A private Bitcoin test network you run on your own computer, where you create blocks on demand. Coins have no value.
Reproducible build
Section titled “Reproducible build”A way of building software where anyone who compiles the same source code gets exactly the same file. It lets people check that a downloaded firmware really matches the published code. This project doesn’t have one yet.
Secure boot
Section titled “Secure boot”A chip feature that only starts firmware signed with the owner’s key, so nobody can quietly swap in different firmware. It isn’t enabled on this prototype. On the ESP32 it permanently burns settings into the chip, so Phase 9 only researches and documents it.
Secure element
Section titled “Secure element”A separate, tamper-resistant chip made to store secrets and resist physical attacks. Many commercial hardware wallets have one. This prototype doesn’t. Phase 10 looks at options for the final hardware.
The master secret of a wallet. Every key and address comes from it. It is usually written down as 12 or 24 words (BIP39). Anyone who has your seed can spend your coins. This device never stores it: you enter it each session.
SeedQR
Section titled “SeedQR”A QR code that holds a seed, a format from the SeedSigner project. You can draw it on paper and scan it instead of typing the words. It is the seed, so never photograph a real one. (SeedQR spec)
Sighash
Section titled “Sighash”A setting on each signature that says which parts of the transaction it covers. The device only signs with SIGHASH_ALL, which covers the whole transaction, and refuses anything else.
Signet
Section titled “Signet”A Bitcoin test network where coins have no value and only approved signers can create blocks (BIP325). You get free signet coins from a faucet website. This project runs on signet only.
Testnet
Section titled “Testnet”An older public Bitcoin test network. Its coins have no value either. This project uses signet instead.
TrustZone
Section titled “TrustZone”An Arm processor feature that splits the chip into a secure side and a normal side, so secrets can be kept away from the rest of the firmware.
A transaction’s ID: a 64-character code worked out from the transaction itself. It is public, and you can look it up on a block explorer.
Uniform Resources, a format from Blockchain Commons for sending data as an animated QR. It splits the data into small frames using “fountain codes”, so the scanner can start at any frame, miss some, and still put the data back together. Sparrow shows unsigned transactions as UR:CRYPTO-PSBT frames. (UR spec)
Unspent transaction output: a coin you own. Each one came from an earlier transaction and can be spent once. Your balance is the total of your UTXOs.
Watch-only wallet
Section titled “Watch-only wallet”A wallet that knows your public keys but not your seed. It can show your balance, make addresses and build transactions, but it can’t sign them. In this project, Sparrow Wallet is the watch-only wallet and the device is the signer.
xpub, tpub and zpub
Section titled “xpub, tpub and zpub”An extended public key: one public key that can produce every address in an account, without being able to spend. xpub is the general name. tpub is the version for test networks, which this device exports, and zpub is a BIP84-specific variant on mainnet. Sharing it reveals all your addresses and balances, but not the ability to spend.