BA-00 How Bitcoin works Follow one payment from Alice's wallet to Bob, through independent node checks, a miner's candidate block, and confirmations.
Open guided tool BA-00 Transactions, outputs, locks, keys, and addresses Build one payment from spendable outputs and follow how an address becomes a locking script, a key authorizes an input, and change becomes a new output.
Open guided tool BA-00 Blocks, mining, difficulty, and validation See how a candidate block is assembled, how proof of work is found, how difficulty is encoded, and why full nodes still decide whether the block is valid.
Open guided tool BA-00 Full nodes, the blockchain, and reorgs Connect peer messages, mempool, block index, chainstate, most-work selection, confirmations, and temporary reorganizations into one full-node view.
Open guided tool BA-00P Choose a wallet by trade-offs Compare custody, source transparency, platform, backup model, hardware isolation, coin control, and support without treating one wallet as best for everyone.
Open guided tool BA-00P Receive a first payment Create and verify a fresh receiving instruction, distinguish an address from a private key, and monitor the payment from unconfirmed relay to chosen confirmation depth.
Open guided tool BA-00P Send with fee and change Review destination, amount, selected outputs, fee rate, absolute fee, and change before signing a simulated Bitcoin payment.
Open guided tool BA-00P Handle a slow payment Diagnose low fees, distinguish replace-by-fee from child-pays-for-parent, and decide when waiting is safer than changing the transaction.
Open guided tool BA-00P Back up and recover Protect seed words, passphrase, wallet policy, and derivation information, then test recovery without exposing live secrets.
Open guided tool BA-00P Defend against scams and signing mistakes Recognize seed phishing, clipboard replacement, address substitution, fake support, malicious approvals, and irreversible-payment pressure.
Open guided tool BA-00P Use Bitcoin with deliberate privacy Understand address reuse, change identification, coin selection, network observers, and the privacy trade-offs of sharing wallet or exchange data.
Open guided tool BA-00P Buy and withdraw bitcoin safely Compare exchange and peer-to-peer purchase risks, verify the withdrawal network and address, test with a small amount, and confirm self-custody before increasing exposure.
Open guided tool BA-01 What money does Money helps people compare value, exchange goods, settle debts, and carry purchasing power across time. Different forms of money make different trade-offs.
Open guided tool BA-01 Ledgers and double spending A ledger records who can spend each scarce digital unit. A shared order prevents two conflicting payments from both becoming final.
Open guided tool BA-01 Bits, bytes, hex, and endianness Computers store Bitcoin data as bits grouped into bytes. Hexadecimal is a compact way to display those bytes, while byte order determines how a number is read.
Open guided tool BA-01 Data structures and state machines Bitcoin tracks spendable transaction outputs instead of account balances. Every valid transaction consumes existing outputs and creates new ones.
Open guided tool BA-01 Networks and adversaries Bitcoin nodes exchange information over an imperfect network. They must remain safe when messages arrive late, connections split, or peers lie.
Open guided tool BA-01 Open-source verification Anyone can inspect the rules, run the software, and reproduce a result. Security comes from independent checks rather than trust in one operator.
Open guided tool BA-01 CompactSize and Bitcoin byte fields Parse variable-length counts, fixed-width integers, hashes, scripts, and length-prefixed vectors without confusing display order with serialized order.
Open guided tool BA-02 Modular arithmetic Modular arithmetic wraps numbers around a fixed boundary, like hours on a clock. Bitcoin's signature mathematics uses this kind of arithmetic.
Open guided tool BA-02 Hash functions and SHA-256 A hash turns any message into a fixed-size fingerprint. Bitcoin commonly uses the Secure Hash Algorithm 256, called SHA-256, to detect changes and make commitments.
Open guided tool BA-02 Hash160 and Merkle trees Bitcoin combines two hash functions for some identifiers and arranges transaction hashes in a tree so one item can be proven part of a larger set.
Open guided tool BA-02 Elliptic-curve keys A private key is a secret number. Bitcoin multiplies it by a fixed curve point to create a public key, a one-way operation used to authorize spending.
Open guided tool BA-02 ECDSA signatures The Elliptic Curve Digital Signature Algorithm, called ECDSA, lets a private key authorize a message without revealing the key. Safe signing also depends on a unique secret nonce.
Open guided tool BA-02 Schnorr and BIP340 Schnorr signatures use simpler algebra than Bitcoin's earlier signature system. Bitcoin Improvement Proposal 340 defines the exact Schnorr format used by Taproot.
Open guided tool BA-02 Tagged hashes A tagged hash adds a purpose label before hashing. This stops the same bytes from being mistaken for a message used by a different protocol rule.
Open guided tool BA-02 Threshold cryptography Threshold signing divides authority among several participants. A required number can create one valid group signature without combining their secret shares.
Open guided tool BA-02 The Bitcoin cryptography map Connect SHA-256, HASH256, HASH160, HMAC-SHA512, PBKDF2, secp256k1, ECDSA, Schnorr, tagged hashes, and Merkle commitments to the exact job each performs.
Open guided tool BA-03 Digital cash before Bitcoin Earlier digital cash projects solved pieces of the puzzle, including private payments and costly computation. None combined ownership, public ordering, and open validation in Bitcoin's way.
Open guided tool BA-03 The genesis and early network Bitcoin began with a public paper, public software, and a first block. The launch sequence matters because nobody received private control of the ledger rules.
Open guided tool BA-03 Scarcity and issuance New bitcoin enters circulation through block rewards that fall over time. Mining difficulty adjusts to production speed, and transaction fees increasingly pay miners.
Open guided tool BA-03 Austrian and competing monetary views Different schools disagree about money, debt, falling prices, and the role of institutions. The lesson separates testable claims from economic values.
Open guided tool BA-03 Incentive compatibility Bitcoin participants do not all want the same thing. The system works when following valid rules usually pays better than attacking or accepting invalid history.
Open guided tool BA-03 Adoption and network effects A payment network becomes more useful when more people and businesses can use it, but reliability, cost, custody, law, and coordination can slow adoption.
Open guided tool BA-03 Fork history A fork occurs when participants follow different histories or rule sets. Past disputes show how software rules, mining work, businesses, and individual validation interact.
Open guided tool BA-03 Critiques and falsifiable claims A useful critique states a mechanism, measurable variables, a time horizon, and evidence that could prove it wrong. This lesson applies that discipline to Bitcoin debates.
Open guided tool BA-04 Private and public keys A private key is the secret that authorizes a spend. A public key lets others verify that authorization, while an address describes where a payment can be locked.
Open guided tool BA-04 Base58, Bech32, and Bech32m Bitcoin addresses are human-readable encodings with a network marker and error-detecting checksum. Three formats exist because Bitcoin added new spending types over time.
Open guided tool BA-04 BIP39 mnemonics and passphrases Bitcoin Improvement Proposal 39 defines word-based wallet backups. Its optional passphrase creates a different wallet, so losing either the words or passphrase prevents recovery.
Open guided tool BA-04 HD derivation A hierarchical deterministic wallet creates many related keys from one root. Bitcoin Improvement Proposal 32 defines normal and hardened child-key paths with different exposure risks.
Open guided tool BA-04 Descriptors and miniscript policy A wallet descriptor is a precise recipe for finding keys and constructing spending conditions. Miniscript is a structured way to express some of those conditions safely.
Open guided tool BA-04 Watch-only and air-gapped workflows A watch-only wallet can observe funds and build transactions without private keys. An offline signer can then review and authorize the exact transaction.
Open guided tool BA-04 PSBT A Partially Signed Bitcoin Transaction, called a PSBT, carries one unsigned transaction plus the metadata signers need to review, sign, combine, and finalize it.
Open guided tool BA-04 Multisig and threshold custody A multisignature script asks Bitcoin to verify several visible signatures. Threshold signing instead lets several participants cooperate to produce one group signature.
Open guided tool BA-04 Backups and recovery Recovery requires more than seed words. A complete plan preserves every passphrase, key path, spending policy, and quorum rule needed to recreate and test the wallet.
Open guided tool BA-04 Private keys, public keys, and key hashes Inspect valid scalar bounds, compressed curve points, public-key hashes, authorization, and the difference between a key, address, script, and spendable output.
Open guided tool BA-04 WIF, Base58Check, Bech32, Bech32m, and checksums Encode and decode private-key and destination text formats byte by byte, including network markers, witness versions, conversion alphabets, and checksum limits.
Open guided tool BA-04 HD wallet trees and extended-key anatomy Decode xpub and xprv fields, derive BIP44, BIP49, BIP84, and BIP86 branches, and identify what recovery metadata and public-key exposure imply.
Open guided tool BA-05 The UTXO model A UTXO is a specific unspent transaction output; transactions consume whole outputs and create new ones.
Open guided tool BA-05 Inputs, outputs, and change Inputs reference prior outpoints and provide witnesses; outputs assign values to new locking conditions.
Open guided tool BA-05 Serialization and txids Version, vectors, scripts, sequence, witness, and locktime serialize deterministically; txid and wtxid commit to different data.
Open guided tool BA-05 Fees, weight, and vbytes Fees equal inputs minus outputs, while feerates use virtual size derived from transaction weight.
Open guided tool BA-05 Coin selection Wallets trade off fees, privacy, change, consolidation, and future spending cost when selecting UTXOs.
Open guided tool BA-05 Mempool policy versus consensus Nodes can reject relay or mining of a consensus-valid transaction under local policy without making it invalid forever.
Open guided tool BA-05 Confirmations and finality Confirmations measure accumulated proof of work after inclusion; required depth depends on value, threat model, and protocol configuration.
Open guided tool BA-05 RBF Replace-by-fee uses sequence and mempool rules to replace an unconfirmed transaction with a higher-fee conflict.
Open guided tool BA-05 CPFP and package economics A child can pay enough fee for miners to include a low-fee parent when the package feerate is attractive.
Open guided tool BA-05 Timelocks nLockTime, sequence, CLTV, and CSV constrain when transactions or spending paths become valid.
Open guided tool BA-05 Raw transaction inputs and outputs Decode outpoints, ScriptSig, sequence, amounts, ScriptPubKeys, CompactSize lengths, and locktime directly from serialized transaction bytes.
Open guided tool BA-05 Witnesses, wtxids, and block commitments Trace witness serialization, txid versus wtxid, the coinbase witness reserved value, and the witness commitment that binds SegWit data into a block.
Open guided tool BA-05 The complete mempool lifecycle Follow admission, relay, conflicts, RBF replacement, block connection, reorg reconsideration, expiry, size eviction, and local policy differences.
Open guided tool BA-06 Stack-machine execution Script is a deliberately constrained stack language whose success depends on final truth and consensus limits.
Open guided tool BA-06 Pushes, arithmetic, and control flow Data pushes, numeric encodings, conditionals, and verification opcodes compose spending policies.
Open guided tool BA-06 Signature checks and sighashes CHECKSIG validates a signature over a transaction digest selected by a sighash mode.
Open guided tool BA-06 P2PKH and P2SH Legacy templates separate address-friendly commitments from revealed spending scripts.
Open guided tool BA-06 Witness programs SegWit moves authorization data into witness structures and versions the program semantics.
Open guided tool BA-06 Multisig and policy composition Multiple keys, timelocks, and hashlocks can form recovery, escrow, and channel policies.
Open guided tool BA-06 Script limits and malleability Disabled opcodes, resource limits, encoding rules, and malleability protections constrain safe composition.
Open guided tool BA-06 Script debugging Experts trace every stack transition, identify the failing predicate, and distinguish malformed witnesses from false conditions.
Open guided tool BA-06 P2PK, P2PKH, P2MS, P2SH, and OP_RETURN Compare the exact assembly, serialized bytes, spend data, standard uses, and failure boundary for Bitcoin's classic Script templates.
Open guided tool BA-06 Native and nested SegWit scripts Construct P2WPKH, P2WSH, P2SH-P2WPKH, and P2SH-P2WSH outputs and follow each redeem, witness, hash, and signature check.
Open guided tool BA-07 SegWit architecture SegWit separates witness data, fixes third-party malleability, changes weight accounting, and enables safer second-layer commitments.
Open guided tool BA-07 Taproot outputs P2TR commits to an internal key optionally tweaked by a script-tree root, presenting one compact output key on chain.
Open guided tool BA-07 Key-path spending The internal key holder can authorize a spend with a tweaked Schnorr signature without revealing alternative scripts.
Open guided tool BA-07 Tapscript Script-path spends reveal one leaf, its witness, and a control block while keeping unused branches private.
Open guided tool BA-07 Taptrees and control blocks Merkle paths prove that a revealed leaf was committed into the Taproot output key.
Open guided tool BA-07 Unspendable internal keys Protocols can use a provably unspendable internal key to require script-path enforcement rather than retaining a hidden bypass.
Open guided tool BA-07 MuSig and key aggregation Interactive multisignature schemes aggregate public keys and signatures while defending against rogue-key attacks.
Open guided tool BA-07 FROST Flexible Round-Optimized Schnorr Threshold signing coordinates nonce commitments and signature shares from a threshold subset.
Open guided tool BA-07 Covenant proposals CTV, APO, CAT-related designs, and other proposals trade expressiveness, analyzability, and deployment risk.
Open guided tool BA-08 Block structure A block header commits to version, prior block, transaction Merkle root, time, target, and nonce.
Open guided tool BA-08 Proof of work Mining searches header variations for a hash below the target, making history costly to extend and rewrite.
Open guided tool BA-08 Difficulty adjustment Bitcoin retargets periodically to keep average block production near ten minutes despite changing hash rate.
Open guided tool BA-08 Block validation Full nodes independently check proof of work, transactions, scripts, issuance, weight, and contextual consensus rules.
Open guided tool BA-08 Chain selection and reorgs Nodes follow the valid chain with the most accumulated work and may disconnect blocks during reorganization.
Open guided tool BA-08 Coinbase and subsidy The coinbase creates permitted subsidy and collects fees, with maturity rules before its outputs can be spent.
Open guided tool BA-08 Mining pools and templates Pools coordinate work and payouts; Stratum and template negotiation affect miner autonomy and centralization.
Open guided tool BA-08 Attacks and security budget Double-spends, selfish mining, censorship, pool concentration, and fee-market uncertainty require economic analysis.
Open guided tool BA-08 Raw block anatomy and blk.dat Decode disk framing, the 80-byte header, CompactSize transaction count, coinbase, ordinary transactions, witness commitment, and neighbouring block links.
Open guided tool BA-08 Mining lifecycle and candidate blocks Follow mempool selection, ancestor packages, template construction, coinbase and witness commitments, target search, broadcast, and independent full-node validation.
Open guided tool BA-08 Block time, MedianTimePast, and future limits Validate a candidate timestamp against the median of the previous eleven blocks and the receiving node's two-hour future-time limit.
Open guided tool BA-08 Version bits and soft-fork activation Decode the block-version marker and deployment bits, then follow period thresholds through DEFINED, STARTED, LOCKED_IN, ACTIVE, or FAILED.
Open guided tool BA-08 Block height and BIP34 coinbase commitments Encode the block height as the first minimally encoded Script number in the coinbase ScriptSig and keep it distinct from header fields.
Open guided tool BA-08 Soft forks, hard forks, and compatibility Run one block through old and new rule sets to see subset restrictions, rule expansions, activation risk, and persistent chain splits.
Open guided tool BA-09 Peer discovery and handshakes Nodes discover peers, negotiate services, and exchange inventory without a central network registry.
Open guided tool BA-09 Transaction and block relay Compact blocks, headers-first synchronization, feefilters, and relay policies reduce bandwidth and latency.
Open guided tool BA-09 Initial block download A new node downloads and validates historical headers and blocks before reaching the current tip.
Open guided tool BA-09 UTXO set and chainstate Bitcoin Core separates block storage, indexes, mempool state, and the active UTXO database.
Open guided tool BA-09 Pruning and assumeutxo Resource-saving modes change storage or bootstrap work without replacing final validation guarantees.
Open guided tool BA-09 RPC and ZMQ RPC controls a node while event interfaces support applications that need chain and mempool updates.
Open guided tool BA-09 Consensus changes and BIPs Soft forks tighten validity rules and require deployment coordination across users, miners, software, and markets.
Open guided tool BA-09 Code review and release process Bitcoin Core changes undergo adversarial review, testing, backport discipline, and reproducible release work.
Open guided tool BA-09 Full node architecture Connect peers, message parsing, validation, mempool, block index, chainstate, wallet, RPC, ZMQ, indexes, pruning, and reorg handling in one system map.
Open guided tool BA-09 Bitcoin P2P message bytes Parse network magic, command, payload length, checksum, and payload from a byte stream before applying command-specific limits and validation.
Open guided tool BA-10 Common-input and change heuristics Chain surveillance infers ownership from transaction structure; heuristics are probabilistic, not consensus facts.
Open guided tool BA-10 CoinJoin Collaborative transactions break simple ownership heuristics but introduce coordination, amount, and operational considerations.
Open guided tool BA-10 PayJoin and silent payments Receiver-assisted construction and reusable scanning addresses reduce common transaction graph signals.
Open guided tool BA-10 Network privacy IP observation, timing, wallet queries, and address reuse can reveal links even when on-chain structure is careful.
Open guided tool BA-10 Hardware-wallet threat models Secure elements, firmware, host compromise, supply chains, and verification UX define actual signing security.
Open guided tool BA-10 Multisig operations Geographic separation and policy redundancy help only when backups, quorum availability, and change verification are practiced.
Open guided tool BA-10 Protocol attack surfaces Parsing, consensus divergence, nonce reuse, oracle manipulation, key compromise, and economic exploits require layered controls.
Open guided tool BA-10 Incident response Preparation includes detection, communication, key rotation or migration, evidence preservation, and safe recovery procedures.
Open guided tool BA-11 Payment channels Pre-signed state updates let parties transact off chain while retaining an enforceable on-chain settlement path.
Open guided tool BA-11 Lightning commitments Revocable commitments, HTLCs, timelocks, and justice or replacement mechanisms manage unilateral closes.
Open guided tool BA-11 Routing and liquidity Multi-hop payments use onion routing and conditional transfers but depend on directional channel liquidity.
Open guided tool BA-11 Watchtowers and backups Offline protection and channel-state recovery address different failure modes and have distinct trust assumptions.
Open guided tool BA-11 DLCs Discreet Log Contracts use oracle attestations and adaptor signatures so outcomes settle without revealing the full contract logic on chain.
Open guided tool BA-11 Federations and sidechains Pegged systems trade different custody, consensus, and exit assumptions for additional functionality.
Open guided tool BA-11 Ark and shared UTXOs Emerging protocols explore coordinated UTXO ownership and efficient exits with new availability assumptions.
Open guided tool BA-11 Layer comparison Experts compare custody, unilateral exit, data availability, capital efficiency, privacy, and failure recovery rather than relying on labels.
Open guided tool BA-12 OP_RETURN and data commitments OP_RETURN outputs carry provably unspendable data but do not themselves enforce later spending conditions.
Open guided tool BA-12 Ordinals and inscriptions Ordinal theory assigns ordering conventions to satoshis while inscriptions use witness envelopes interpreted by off-chain indexers.
Open guided tool BA-12 Runes Runestones encode fungible token operations whose meaning is reconstructed by compatible indexers; cenotaph behavior supports upgrade semantics through burns.
Open guided tool BA-12 Indexer consensus Meta-protocol users depend on deterministic off-chain interpretation and must understand divergence and reorg handling.
Open guided tool BA-12 BitVM BitVM-style systems use commitments, challenge games, and Bitcoin-enforced disputes to verify computations without adding general execution to consensus.
Open guided tool BA-12 Client-side validation Some protocols keep rich state off chain while using Bitcoin commitments and proofs to constrain valid transitions.
Open guided tool BA-12 Policy and resource debates Data protocols affect fees, relay policy, UTXO growth, miner incentives, and social arguments about block-space use.
Open guided tool BA-13 Spot, forwards, and futures Market instruments differ in settlement, leverage, margin, counterparty exposure, and relationship to spot bitcoin.
Open guided tool BA-13 The basis trade A cash-and-carry trade holds spot and shorts a premium future, earning convergence while bearing funding, custody, margin, and execution risks.
Open guided tool BA-13 ETFs and custodial products Exchange-traded products improve access but introduce custody, authorized participant, tracking, jurisdiction, and redemption structures.
Open guided tool BA-13 Liquidity and market microstructure Order books, spreads, slippage, fragmentation, leverage, and liquidation cascades shape realized execution.
Open guided tool BA-13 Mining economics Revenue depends on subsidy, fees, hash price, energy, hardware efficiency, uptime, financing, and difficulty.
Open guided tool BA-13 Treasury strategy Holding bitcoin changes liquidity, refinancing, accounting, governance, and drawdown risk rather than simply adding upside.
Open guided tool BA-13 Stablecoins and bitcoin-backed credit Credit systems add liquidation, oracle, governance, and maturity risks around otherwise bearer collateral.
Open guided tool BA-13 Scenario modelling Forecasts must expose assumptions, ranges, sensitivities, and version history instead of presenting a single projected number as truth.
Open guided tool BA-14 Raw transaction construction Engineers serialize fields, compute sighashes, sign inputs, and inspect witnesses without relying solely on wallet abstractions.
Open guided tool BA-14 Regtest workflows A private deterministic chain enables instant mining, reorgs, policy experiments, and repeatable failure tests.
Open guided tool BA-14 Functional and unit testing Good tests isolate consensus logic, RPC behavior, wallet state, serialization, and end-to-end node interactions.
Open guided tool BA-14 Fuzzing and property tests Generated inputs uncover parser and state-machine edge cases while invariants catch broad classes of failure.
Open guided tool BA-14 Rust and TypeScript Bitcoin libraries Library abstractions accelerate work but must be checked against serialization, network, sighash, and script semantics.
Open guided tool BA-14 Reading Bitcoin Core Trace behavior from RPC or P2P entry points through validation and state updates while respecting lock and ownership boundaries.
Open guided tool BA-14 BIP design and review Protocol proposals need precise motivation, compatibility, activation, test vectors, security analysis, and reference behavior.
Open guided tool BA-14 Responsible deployment Signet, testnet, regtest, feature gates, monitoring, rollback constraints, and disclosure processes reduce real-funds risk.
Open guided tool DA-01 What Ducat is designed to do Ducat lets people borrow against bitcoin without first moving that collateral to another blockchain. UNIT is Ducat’s dollar-pegged stablecoin: one output of a wider system of vaults, risk checks, signatures, price data, and Bitcoin transactions.
Open guided tool DA-01 The end-to-end system lifecycle A user action moves through client construction, Bitcoin transactions, Guardian authorization, confirmation, validator reconstruction, and, when required, an oracle-triggered liquidation path.
Open guided tool DA-01 Actors and responsibilities Vault owners, Guardians, validators, oracles, relays, liquidators, LPs, and operators have distinct powers, information, and failure modes.
Open guided tool DA-01 Vault state A vault is represented by Bitcoin outputs plus protocol metadata, with each valid action consuming an earlier state and creating its successor.
Open guided tool DA-01 Accounts, reserves, and UNIT debt Issuance and reserve accounts are UTXO-based protocol objects whose availability and transitions are tracked by validators and coordinated by Guardians.
Open guided tool DA-01 The Bitcoin enforcement boundary Bitcoin enforces committed transaction and Script conditions, while richer Ducat state and economic rules are reconstructed and checked by protocol participants.
Open guided tool DA-01 External trust and availability Guardians, oracles, validators, relays, clients, and operators remain explicit honesty or liveness dependencies even where Bitcoin constrains the final spend.
Open guided tool DA-01 Protocol profiles and configuration Network parameters, Guardian keys, oracle keys, ratios, fees, and feature settings are versioned inputs to clients and validators.
Open guided tool DA-01 Current versus target architecture Repository code, deployed environments, security roadmaps, and public descriptions can differ; every claim must carry a date and status.
Open guided tool DA-02 What UNIT represents UNIT is Ducat's issued asset; its token movements and its relationship to bitcoin collateral must be distinguished from the BTC locked in vault outputs.
Open guided tool DA-02 Rune identity and issuance Rune identifiers and issuance rules establish which on-chain token is UNIT and how compatible indexers recognize its supply events.
Open guided tool DA-02 Runestones and edicts Rune-compatible transaction data describes token allocations between outputs while Bitcoin consensus continues to validate only the underlying transaction.
Open guided tool DA-02 UNIT transfer semantics A UNIT transfer assigns token balances to transaction outputs under Rune indexing rules without by itself changing a Ducat vault's collateral or debt.
Open guided tool DA-02 Cenotaphs and invalid messages Malformed or deliberately unrecognized Rune messages can burn affected token balances, making parser compatibility and transaction construction safety essential.
Open guided tool DA-02 Indexer reconstruction and reorgs Validators and Rune-compatible indexers deterministically replay confirmed transactions and must reverse and reapply derived token state during Bitcoin reorganizations.
Open guided tool DA-02 UNIT state versus vault state Rune token allocations, vault UTXOs, collateral values, and debt records are related protocol views but are not one interchangeable state object.
Open guided tool DA-02 Issue and burn reconciliation Borrow and repay flows connect UNIT issuance or burning to vault debt transitions so validators can reconcile the token change with the collateralized action.
Open guided tool DA-02 Compatibility and failure boundaries Wallet construction, indexer rules, network configuration, confirmation handling, and version compatibility determine whether every participant reconstructs the same UNIT state.
Open guided tool DA-03 Open a vault The client fetches protocol and oracle data, reserves issuance capacity, builds and signs PSBTs, and submits the request for Guardian validation and co-signing.
Open guided tool DA-03 Deposit and withdraw Collateral changes consume the current vault UTXO and create a successor while validation enforces allowed value and ratio transitions.
Open guided tool DA-03 Borrow and repay Issuance or burn activity is paired with a vault state update so UNIT changes reconcile with the vault differential.
Open guided tool DA-03 Two-transaction actions Open, borrow, and repay use an issue-or-burn transaction plus a vault transaction connected so package structure and fees matter.
Open guided tool DA-03 Single-transaction actions Deposit, withdraw, repo, and trim update vault state without the separate issuance or burn pattern.
Open guided tool DA-03 PSBT manifests and signing inputs The client prepares transaction context while signing code derives the precise sighash and Taproot context that each signer must authorize.
Open guided tool DA-03 Vault metadata versus enforcement OP_RETURN records help reconstruct state, but spend authorization comes from committed Script paths and signatures rather than metadata alone.
Open guided tool DA-03 Fees, signature checks, and control blocks Ducat estimates transaction weight from inputs, outputs, witnesses, signatures, price commitments, and taptree depth.
Open guided tool DA-03 Confirmations and lifecycle state Validator and client behavior must read environment-specific confirmation and state rules instead of teaching a timeless hard-coded number.
Open guided tool DA-03 CPFP for Ducat transaction pairs Package feerate explains how a fee-paying vault child can make a zero-fee issue or burn parent mineable.
Open guided tool DA-04 Guardian responsibilities Guardians receive signed requests, validate protocol rules and transaction structure, reserve issuance accounts, and contribute authorization when policy permits.
Open guided tool DA-04 FROST signing rounds Guardians exchange nonce commitments and signature shares so a threshold subset produces one BIP340-compatible group signature.
Open guided tool DA-04 Distributed key generation Participant-local DKG creates shares without any coordinator learning the group secret or plaintext participant shares.
Open guided tool DA-04 Thresholds and quorum A t-of-n topology trades availability against compromise resistance; current tests and planned deployments must not be confused with one permanent quorum.
Open guided tool DA-04 Coordinator trust boundary Signature aggregation is public; safety depends on each honest Guardian independently rejecting invalid signing requests.
Open guided tool DA-04 TEE custody Attested enclaves bind code measurements and short-lived sealing keys so shares are finalized, stored, and used inside confidential workloads.
Open guided tool DA-04 Signing policy binding Request IDs, action types, transaction hashes, signing inputs, group keys, and policy digests prevent replay and cross-round substitution.
Open guided tool DA-04 Guardian passphrases Wallet passphrases protect encrypted local wallet files; production Guardian key packages have separate enclave and operator custody controls.
Open guided tool DA-04 Failure, rotation, and migration The v1 custody design treats lost Guardians and rotations as a new DKG plus funds migration rather than reconstructing shares centrally.
Open guided tool DA-04 Production-readiness boundaries Implemented policy gates, test proofs, live cloud rehearsals, external audits, and real-funds enablement are separate milestones.
Open guided tool DA-05 How the Ducat oracle works Follow one bitcoin price from a signed Chainlink report, through Ducat's precommitted liquidation threshold, to the exact Taproot witness that Bitcoin verifies.
Open guided tool DA-05 Blind price ladder The oracle publishes pre-committed threshold events across collateral-rate buckets so it need not know which users selected which thresholds.
Open guided tool DA-05 BIP340 commitment hash Wallet and oracle compute a tagged commitment over oracle key, network, base price, timestamp, and threshold price.
Open guided tool DA-05 Nostr transport Replaceable signed events distribute current snapshots, threshold contracts, and breach material; relays transport data but are not the trust anchor.
Open guided tool DA-05 Atomic snapshot promotion The current snapshot is published only after its complete ladder succeeds, allowing clients to stay on the prior coherent snapshot after partial failure.
Open guided tool DA-05 Preimages and Hash160 A breached threshold reveals secret material whose Hash160 matches the value committed into the vault's liquidation Script leaf.
Open guided tool DA-05 Liquidation Taproot leaf The revealed preimage satisfies the hashlock and a Guardian Schnorr signature satisfies CHECKSIG, making the oracle outcome consumable by Bitcoin Script.
Open guided tool DA-05 Why the Ducat oracle is Bitcoin-native Chainlink supplies authenticated data, but Bitcoin-native enforcement comes from the committed hashlock and signature path inside the Bitcoin UTXO.
Open guided tool DA-05 Oracle freshness and failure modes Stale prices, relay availability, signer rotation, incomplete ladders, configuration drift, and undeployed security fixes must fail closed or be surfaced.
Open guided tool DA-05 Liquidation cycle Detection, preimage release, candidate selection, Guardian validation, repo or trim construction, broadcast, confirmation, and resulting reserve flows form the liquidation lifecycle.
Open guided tool DA-06 Collateral ratios Debt, BTC collateral value, liquidation threshold, and minimum vault ratios determine available actions and risk distance.
Open guided tool DA-06 Liquidation tax Protocol calculations combine liquidation threshold and configured tax parameters; observed percentages must be derived from the active profile.
Open guided tool DA-06 Liquidator subsidy The subsidy can rise as a vault falls below a configured ratio, subject to thresholds, increments, and reserve-rate floors.
Open guided tool DA-06 Repo and trim economics Full and partial liquidation change collateral, debt, liquidator consideration, and reserve flows through different transaction shapes.
Open guided tool DA-06 The 8-9% claim Any quoted liquidation profit must be decomposed into active tax, subsidy, collateral ratio, execution costs, slippage, and price movement rather than memorized.
Open guided tool DA-06 LP revenue share LP returns require a versioned formula for eligible revenue, allocation weights, utilization, capital, duration, and losses; absent commercial inputs remain unknown.
Open guided tool DA-06 Protocol revenue Fees, spreads, issuance activity, liquidations, and reserve deployment form scenarios rather than guaranteed protocol revenue.
Open guided tool DA-06 Forecast construction Base, downside, and upside cases expose volume, price, utilization, fee, adoption, churn, and expense assumptions with sensitivities.
Open guided tool DA-06 Basis-trade strategy If Ducat reserves or LPs use a basis trade, the model must include collateral custody, futures margin, funding, roll, liquidation, venue, and convergence risk.
Open guided tool DA-06 Risk-adjusted communication Founder-grade explanations separate accounting revenue, economic profit, token or LP distributions, liquidity, and tail risk.
Open guided tool DA-07 Validator reconstruction Validators scan Bitcoin blocks, maintain UTXOs and protocol objects, validate UNIT transfers against vault differentials, and serve query APIs.
Open guided tool DA-07 Guardian-validator separation Validators reconstruct and check state while Guardians control signing; centralizing or confusing these roles changes the threat model.
Open guided tool DA-07 Client workflow The SDK coordinates validator reads, oracle data, funding selection, PSBT construction, wallet signatures, Guardian requests, and broadcasts.
Open guided tool DA-07 Observability and watchtowers Health checks cover chain tip, oracle freshness, ladder coverage, commitments, Guardian readiness, vault state, and transaction outcomes.
Open guided tool DA-07 Deployment environments Regtest, Mutinynet, testnet targets, staging names, and mainnet readiness must be identified by actual configuration and deployed artifact, not labels.
Open guided tool DA-07 Upgrade and compatibility Protocol versions, taptree layout, oracle event formats, key packages, indexer rules, and client compatibility require coordinated migration.
Open guided tool DA-07 Governance powers Experts enumerate who can change configurations, rotate keys, deploy oracle workflows, update clients, pause operations, or migrate funds.
Open guided tool DA-07 Threat-model review Oracle compromise, Guardian collusion, liveness loss, validator divergence, signing-policy bugs, fee spikes, reorgs, and economic attacks each need explicit mitigations.
Open guided tool DA-07 Audit and evidence Tests, conformance vectors, attestation receipts, reproducible builds, live rehearsals, and external review support different security claims.
Open guided tool DA-07 Public claims discipline Marketing language must be traceable to current evidence and must not promote planned decentralization or undeployed fixes as live behavior.
Open guided tool