proposed mdbook structure #19

• mdbook materials should target 3 main audiences
  • users (for introductory, problem definition and overview stuff, not necessarily for all details)
  • bitcoin developers
  • privacy researchers
• README should be for the repo, addressing potential contributors as well

with that the rough structure i propose for the mdbook:

• introduction (README) - README do-over #74
• problem definition - Define the on-chain privacy problems being addressed #7
• protocol suite
  • overview - Add an overview #51
  • threat models
    • privacy - counterparties, 3rd parties, with or without aux info, ...
    • censorship resistance
      • liveness
      • market mechanism
      • DoS / flood protection
  • coalition formation
  • transaction construction (honest/semi-honest base + bft extensions)
  • optimistic track: blocks and phase states - DAG spec #67
  • contacts and interactive payments
  • recovery track: block dag - DAG spec #67
  • validity proof details - validity proof spec #68
  • transport layer - transport strawman ladder outline #27
    • abstract peer channels (authentication patterns, anonymity)
    • abstract broadcast channel
      • per session
      • open gossip (bft / coalition formation only)
        • ownership proofs
        • rate limiting
    • set reconciliation (naive, rbsr, rbsr+riblt)
    • PSBT scrubbing - Add scrubber bip #12
    • concrete transports
  • peer messages (reference: concrete fields, not quite a wire specification)
• privacy optimization strategy (a recommendation, unlike the protocol suite which is normative)
  • optimization framework (abstract: generate decisions and evaluate them, pure vs. mixed strategies) - Abstract cost function #15
  • pure strategy evaluation
    • cost function structure (a family of cost functions): piecewise linear payoff curves and time dependence, linear combination of terms, bracketing
    • privacy liability terms (formulae or pseudocode front loaded)
      • graph randomization, anti sybil - add graph randomization / sybil resistance cost function term discussion #22
        • sybil resistance index
      • others' inputs subset sum density
        • critical section vs. ahead of time
        • when is approximation valid/useful
      • own inputs or outputs subset sum ambiguity
      • max flow based counterfactual path estimation
      • consolidation penalty
      • utxo pool diversity
      • ad hoc
        • sibling output penalty
        • fingerprint avoidance
  • tactics (generating the decision tree that gets evaluated)
    • bottom up decision tree generation
    • coin selection strategies
    • change decomposition
      • radix denominations - Radix coinjoin denominations notebook #14
  • mixed strategy
    • randomization (k best sufficiently dissimilar pure strategies)
    • time dependence
    • internalization
    • decision loop (greedy search, depth 1 look ahead)
• full BIP drafts (separately from their discussion in the protocols)