Whitepaper architecture for a sovereign technology stack
Logos needs a litepaper that functions simultaneously as a political thesis, a credibility signal, and an architectural overview — then a set of component-specific whitepapers to follow. The most effective model, drawn from structural analysis of every major protocol paper in crypto’s history and the adjacent genres that inform them, is a three-tier documentation strategy: a ~20-page litepaper establishing the unified narrative and thesis, an umbrella whitepaper deepening the integrated architecture, and per-component technical papers for Blockchain, Storage, and Messaging. This report provides the structural logic, precedent analysis, and section-by-section template to execute that strategy.
The analysis draws on the full lineage of crypto whitepapers (Bitcoin through Celestia), adjacent genres (cypherpunk manifestos, IETF RFCs, academic papers, investor documents), and the specific constraints of Logos — a project with an unusually strong philosophical commitment, three distinct protocol layers, and an audience spanning investors, cypherpunks, and protocol engineers.
Part 1: What whitepapers are actually for
The genre evolved from policy instrument to coordination mechanism
The term “white paper” originated in British parliamentary practice around 1920, when Gertrude Bell’s “Review of the Civil Administration of Mesopotamia” was presented to Parliament. The Churchill White Paper of 1922 on Palestine popularized the form — a government document presenting firm policy positions, distinguished from “green papers” (consultative, inviting debate) and “blue books” (longer reference documents). The core function was legitimization through structured argument: the government states its position, presents evidence, and signals legislative intent.
The genre migrated to B2B technology marketing in the 1990s, driven by permission marketing and the rise of content-as-lead-generation. Gordon Graham, who codified the practice in White Papers for Dummies (2013), defines the B2B whitepaper as “a persuasive essay that uses facts and logic to promote a certain product, service, or solution.” The key move: persuasion disguised as education. By the 2000s, whitepapers were the dominant B2B content format — 79% sharing rate among B2B buyers.
Satoshi Nakamoto’s 9-page paper on October 31, 2008 created a new genre. The crypto whitepaper is not merely a technical specification or a marketing document. It performs at least six simultaneous functions:
- Technical specification — describes the protocol’s architecture, cryptographic primitives, and economic model in implementable detail
- Political manifesto — embeds an ideological position (Bitcoin’s implicit critique of trust-based finance; Ethereum’s vision of a world computer; Logos’s thesis on infrastructure sovereignty)
- Coordination mechanism — serves as the social contract for a decentralized network, establishing shared rules that enable self-interested actors to collaborate without central authority
- Credibility signal — demonstrates technical competence to investors and developers (academic research confirms that whitepaper readability and length correlate with ICO fundraising amounts)
- Historical artifact — anchors the project’s canonical identity; disputes about Bitcoin’s direction are still argued with reference to Nakamoto’s original text, treated as quasi-constitutional
- Fundraising instrument — during the ICO era (2017-18: $11.4 billion raised across 1,500+ ICOs), the whitepaper became a de facto unregulated prospectus; the EU’s MiCA regulation now formalizes this function
The critical insight for Logos: a whitepaper is not a document type but a bundle of functions. Different audiences read the same document for different reasons. Investors scan for problem-market-solution-moat-team-tokenomics. Protocol engineers look for formal specifications and security models. Ideologically-aligned communities look for philosophical coherence and a credible vision of the world they want to build. The document must serve all three without collapsing into any single register.
The taxonomy of crypto documents
The crypto ecosystem has developed a clear hierarchy of document types, each optimized for a different function:
| Document | Length | Function | Audience | Formality |
|---|---|---|---|---|
| Litepaper | 7–20 pages | Accessible overview, thesis, architecture sketch | Investors, community, general public | Low–medium |
| Whitepaper | 20–50+ pages | Comprehensive technical + vision document | Developers, investors, evaluators | Medium–high |
| Yellow paper | 30–60+ pages | Formal mathematical specification | Protocol implementers, auditors | Very high |
| Beige paper | Variable | Readable rewrite of yellow paper | Developers who need spec but not notation | Medium |
| Position paper | 8–15 pages | Philosophical/political thesis | Community, ideological allies, press | Low–medium |
| Economics paper | 10–30 pages | Tokenomics, game theory, incentive design | Investors, economists, token designers | Medium–high |
The yellow paper was coined by Gavin Wood for Ethereum’s formal specification (2014) — dense mathematical notation (σ for state, Υ for state transition function), aimed at enabling multiple independent client implementations. The beige paper (community project on GitHub) rewrites the yellow paper in more accessible syntax. Litepapers emerged during the 2017-18 ICO boom as projects needed accessible documents for non-technical audiences — they function as “trailers” for the full whitepaper, typically published first to build interest.
The Tezos project pioneered a particularly relevant split: a position paper (August 2014) articulating the philosophical case for self-amending governance, followed one month later by a white paper providing the technical specification. The position paper opens with a Proudhon quote and argues in political-economic language; the white paper uses mathematical notation and formal definitions. This two-document approach — why this should exist before how it works — is the closest structural precedent to what Logos needs.
Part 2: Structural DNA of the crypto whitepaper lineage
Bitcoin set the template through radical compression
Satoshi’s paper is 9 pages, ~3,400 words, 12 sections, 8 references. Its structure follows a strict bottom-up construction: Transactions → Timestamp Server → Proof-of-Work → Network → Incentive → Reclaiming Disk Space → Simplified Payment Verification → Combining and Splitting Value → Privacy → Calculations → Conclusion. Each section builds on the previous one like assembling a machine component by component.
The tone is academic-concise — written like a computer science conference paper with deliberate understatement. The paper is ~90% technical specification and ~10% philosophical framing. The vision is entirely embedded in the problem statement (“purely peer-to-peer electronic cash would allow online payments to be sent directly from one party to another without going through a financial institution”) rather than stated as a separate manifesto. What’s notably absent: no tokenomics section (the 21M cap isn’t mentioned), no team section, no roadmap, no governance discussion, no applications section, no marketing language. The paper lets the technical design speak for itself.
Key structural lesson: when the concept is genuinely novel, brevity is a feature. Every unnecessary word dilutes the signal. Bitcoin proved that a 9-page document can anchor a trillion-dollar network.
Ethereum split vision from specification — and created a model
Buterin’s whitepaper (2013-14) is ~36-40 pages, ~12,000-15,000 words, structured around a strategic rhetorical move: it spends its entire first major section (~40% of total length) explaining Bitcoin as a state transition system. By redefining Bitcoin from “digital cash” to “a very specialized version of a cryptographically secure state transition machine,” Buterin makes Ethereum’s generalization feel inevitable rather than competitive.
The structure: Introduction to Bitcoin and Existing Concepts → Ethereum (accounts, transactions, state transition function, code execution, mining) → Applications (token systems, financial derivatives, DAOs, file storage, identity) → Miscellanea and Concerns → Conclusion. The Applications section is the key structural innovation — it paints a picture of what could be built, functioning as both technical demonstration and vision document. The “Miscellanea and Concerns” section proactively addresses objections (Turing-completeness risks, fee design), a sophisticated rhetorical move that builds trust by anticipating criticism.
The Yellow Paper (Gavin Wood) then provides the formal specification — every major protocol behavior defined as a mathematical equation (e.g., σ_{t+1} ≡ Υ(σ_t, T)), with ~40% of content in appendices (fee schedules, VM opcodes, Patricia tree specs). It’s a living document updated through each hard fork (currently at Shanghai version).
Key structural lesson: the whitepaper/yellow paper split serves different audiences without compromise. The whitepaper describes what Ethereum does and why; the yellow paper specifies exactly how at the implementation level. This two-layer documentation strategy became the industry standard.
Filecoin solved the multi-component problem in a single document
The Filecoin whitepaper (Protocol Labs, 2017) is the most directly relevant structural precedent for Logos because it faces the same challenge: documenting a system with multiple novel, interacting components (storage mining, retrieval mining, consensus, proofs-of-storage, verifiable markets).
At ~36 pages with 13 figures, the paper uses several strategies worth studying:
- Abstract-then-instantiate: Section 2 defines a generic “Decentralized Storage Network” (DSN) as a formal abstraction with properties (data integrity, retrievability, fault tolerance). Section 4 then instantiates Filecoin as a concrete DSN. The reader understands the abstract framework before seeing the implementation.
- Component isolation with cross-references: Each component (proofs in §3, DSN construction in §4, markets in §5, consensus in §6) gets a self-contained section with extensive forward/backward references.
- Explicit paper organization (§1.3): A roadmap paragraph tells the reader how sections relate — critical for complex systems.
- Elementary Components enumeration (§1.1): Lists four novel components upfront, giving the reader a mental map before diving into details.
- Honest about incompleteness: Section 8 (Future Work) lists open questions and ongoing work. The header says “Filecoin is a work in progress.”
However, Protocol Labs also published separate technical reports for individual components (e.g., dedicated Proof-of-Replication papers). The umbrella whitepaper integrates the narrative; the component papers go deep. This is the model Logos should follow.
Polkadot introduced the vision-first architecture paper
Gavin Wood’s Polkadot paper (2016, ~21 pages) explicitly frames itself as a “vision document” rather than a specification — “This is notably experimental; where parameters are specified, they are likely to change.” Three structural innovations are worth adopting:
- Role-based explanation: Section 4 organizes by participant roles (Validators, Nominators, Collators, Fishermen) rather than technical components, making a multi-chain architecture human-understandable
- Two-pass architecture: Section 3 (Summary) provides a complete high-level overview including “The Philosophy of Polkadot” with explicit design principles (Minimal, Simple, General, Robust); Section 5 (Protocol in Detail) re-covers the same territory at deeper technical resolution
- Explicit problem enumeration: Five blockchain failures (Scalability, Isolatability, Developability, Governance, Applicability) are enumerated, and the paper states which ones it addresses
Key structural lesson: for ambitious architectural proposals, explain the design philosophy before the design. State your principles, then show how every technical choice derives from them.
Multi-component systems converge on umbrella + component papers
Across the full landscape of multi-component protocols, a clear pattern emerges:
| Project | Components | Documentation Strategy | # Primary Docs |
|---|---|---|---|
| Cosmos | Tendermint + SDK + IBC | Umbrella whitepaper + separate Tendermint paper + IBC spec | 3+ |
| Filecoin | Storage + Retrieval + Consensus + Proofs | Umbrella whitepaper + component technical reports | 4+ |
| Tezos | Shell + Protocol + Economy | Position paper + white paper | 2 |
| Arweave | Storage + Endowment + Permaweb | Lightpaper + yellow paper + AR.IO ecosystem paper | 3 |
| Urbit | VM + Language + OS + Network | Single unified paper + extensive reference docs | 1 + docs |
| Celestia | DA + Consensus + NMTs | Multiple academic papers (LazyLedger + DA sampling + NMT) | 3+ |
| Mina | SNARK proofs + Consensus + Payments | Technical paper + economics paper | 2 |
The umbrella-plus-component model (Cosmos/Filecoin) is the most scalable for genuinely multi-component systems. It allows independent development, review, and updating of each component while maintaining a coherent overall narrative. The umbrella paper explains how the pieces fit together; the component papers explain how each piece works.
The Tezos position-paper-plus-white-paper model is the most effective for communicating a strong thesis. It cleanly separates ideology from specification, allowing each document to be optimized for its audience.
The Arweave three-tier model (lightpaper → yellow paper → ecosystem paper) best serves diverse audiences through progressive disclosure.
For Logos, the optimal approach combines all three: a litepaper that functions like a Tezos position paper (thesis-first, with enough technical architecture to establish credibility), followed by an umbrella whitepaper integrating the full stack, plus per-component technical papers for Blockchain, Storage, and Messaging.
Structural evolution: papers get longer, more explicit, and more philosophical over time
The progression from Bitcoin (2008) → Ethereum (2013) → Polkadot/Filecoin (2016-17) → current projects reveals clear trends: increasing length (9 → 36+ pages), more explicit meta-structure (paper organization sections, tables of contents), more comparative positioning (increasingly detailed “related work” sections), more visual documentation (Filecoin’s 13 figures vs. Bitcoin’s 3 diagrams), growing governance awareness (absent in Bitcoin → central in Polkadot), and increasing separation of vision from spec (Ethereum pioneered the whitepaper/yellow paper split). Logos arrives late enough in this lineage to benefit from all these structural innovations.
Part 3: What adjacent genres teach about document architecture
Manifestos work through brevity, moral clarity, and declarative voice
The Cypherpunk’s Manifesto (Eric Hughes, 1993) is ~1,200 words, 12 paragraphs, zero sections. It opens with a moral axiom (“Privacy is necessary for an open society in the electronic age”), builds a logical chain (privacy → anonymity → cryptography → code → Cypherpunks write code), and ends with an invitation (“Let us proceed together apace. Onward.”). It doesn’t argue — it declares.
The Crypto Anarchist Manifesto (Timothy May, 1988/1992) is even shorter at ~500 words. It opens with a deliberate Marx allusion (“A specter is haunting the modern world, the specter of crypto anarchy”), adopts a prophetic rather than argumentative tone (“these developments WILL alter completely the nature of government regulation”), and demonstrates intellectual honesty by acknowledging dark implications (“an anonymous computerized market will even make possible abhorrent markets for assassinations and extortion”).
Seven shared principles make these manifestos effective:
- Extreme brevity (500–1,200 words) — they respect the reader’s time
- Moral clarity first, technical detail second — they establish why before how
- Declarative tone — they don’t argue, they state
- First-person plural — creating collective identity (“We the Cypherpunks”)
- Action-oriented conclusions — what do we do now?
- Historical consciousness — placing the moment in grand historical arcs
- No hedging — directness creates conviction
Logos’s litepaper should open with a section carrying this energy — compressed, morally clear, historically conscious. The Farewell to Westphalia thesis gives Logos unusually rich philosophical material to draw from. But the manifesto energy should be contained to the opening section; the rest of the document must deliver technical substance.
Progressive disclosure is the most effective structural innovation for mixed audiences
Balaji Srinivasan’s The Network State (2022, ~400 pages) introduces a structure Logos should borrow: progressive disclosure. Chapter 1 (“Quickstart”) contains the network state defined in one sentence, then one image, then one thousand words, then one essay. Readers can engage at any depth level. The philosophical/historical foundation (Chapters 2-4) comes before the practical proposal (Chapter 5). This is the pattern of building conviction through context before presenting the solution.
The risk — critics called it a “blueprint drawn in crayon” — comes from insufficient technical rigor. Logos has the advantage of actual working protocols behind its claims.
RFCs provide the normative precision crypto papers lack
IETF RFCs contribute one key innovation: formal normative language. RFC 2119 defines keywords (MUST, SHOULD, MAY) that unambiguously distinguish absolute requirements from recommendations from optional features. RFCs split references into “Normative” (required for implementation) and “Informative” (background context). They mandate Security Considerations sections.
For Logos’s eventual technical specifications, adopting RFC-style normative language in the per-component papers would be valuable — it eliminates ambiguity for implementers. The litepaper should not use this register, but it should signal that the full specs will.
Investor documents demand a specific information architecture
What investors actually look for in a crypto/protocol document, based on VC memo structures and pitch deck conventions:
- Problem statement — what broken/inefficient thing does this fix?
- Market context — how large is the opportunity? (TAM/SAM/SOM)
- Technical solution — not just “faster blockchain” but specific innovation
- Competitive differentiation / moat — why this vs. alternatives?
- Tokenomics — supply, distribution, utility, vesting mechanics
- Team credibility — track records, relevant experience, verified identities
- Traction — users, TVL, transactions, developer adoption
- Roadmap — realistic milestones with timelines
- Risk factors — honest acknowledgment (borrowing from S-1 filing conventions, where the Risk Factors section builds credibility through transparency)
The S-1 filing’s “Description of Business” + “Risk Factors” + “MD&A” trilogy is instructive: here’s what we do, here’s what could go wrong, here’s how we’re performing. This risk-forward approach builds trust. Logos’s litepaper should embed these elements without becoming a pitch deck in disguise — the investor audience should find what they need within a document that primarily serves as an intellectual and architectural statement.
Part 4: Litepaper precedents and best practices
Most major projects never published formal litepapers
A surprising finding: many of the most successful protocols did not publish separate litepapers. Solana published only a technical whitepaper (32 pages, academic format). Avalanche published an academic consensus paper. NEAR published a whitepaper. Celestia grew from academic research papers. Monad (raised 1.5B) have published no formal whitepaper or litepaper at all, relying on documentation, blog posts, and investor presentations.
The projects that did publish effective litepapers include:
Polkadot Lightpaper (2020, 17 pages): The best example in the space. Heavily designed, one concept per page, strong visual identity. Sections: Introduction, Overview, Heterogeneous Sharding, Scalability, Upgradeability, Transparent Governance, Cross-Chain Composability, Architecture, Consensus Roles, Governance Roles, DOT Token, Kusama Network, Substrate, About Web3 Foundation. Excludes mathematical proofs, formal security analysis, detailed consensus algorithms, performance benchmarks. References the full whitepaper for depth. Marketing-forward but technically substantive — opens with “Less Trust, More Truth” and a Gavin Wood quote.
Arweave Lightpaper v2 (2023, ~15-20 pages): Structured around three core components (Cryptographic Proofs of Storage, Storage Endowment, Incentivized Evolution) with explicit design principles (Minimalism, Optimization through incentives). More technically precise and restrained than the original yellow paper.
XMTP Litepaper (GitHub): A living technical document explicitly marked as “work in progress,” referencing future updates. Good example of a litepaper as evolving document rather than fixed artifact.
What litepapers should include and exclude
Based on the successful examples and multiple expert analyses:
Include:
- Project thesis and vision (1-2 pages)
- Problem statement with specificity (1 page)
- High-level technical architecture with diagrams (3-5 pages)
- Key innovations and differentiators (2-3 pages)
- Tokenomics overview — utility, high-level supply dynamics (1-2 pages)
- Team and ecosystem overview (1 page)
- Roadmap with major milestones (1 page)
- References to deeper technical documents
Exclude (save for whitepaper/specs):
- Formal mathematical proofs and verification
- Complete security analysis and attack surface modeling
- Full consensus algorithm specifications
- Exhaustive benchmarking data
- Detailed game-theoretic analysis
- Complete tokenomics modeling (vesting schedules, emission curves, simulation results)
- Code-level protocol descriptions
Recommended length: 15-25 pages for a project of Logos’s complexity. The standard guidance of 7-8 pages applies to simple single-purpose protocols; a project with three distinct components and a philosophical thesis needs more space. The Polkadot lightpaper at 17 pages with heavy visual design is the closest precedent.
Five common litepaper pitfalls to avoid
- Too marketing-heavy, insufficient technical substance: Reads like a sales brochure; alienates the technical readers whose buy-in matters most for a protocol project
- No clear differentiation: Fails to articulate what’s genuinely novel; sounds like every other L1/L2 pitch
- Over-promising without evidence: Claims about TPS, adoption, or market capture without working code or benchmarks to back them
- Copying sections verbatim from the whitepaper: Creates a “watered-down” feel rather than a purpose-built narrative — the litepaper should be independently authored for its specific audience
- Missing the dual-register problem: Either too technical for investors or too fluffy for engineers; the litepaper must serve both without collapsing into either
Part 5: Structural recommendation for Logos
The core structural challenge Logos faces
Logos has an unusual documentation challenge that none of the precedent projects faced in exactly this configuration:
- A deep political/philosophical thesis (sovereignty, resistance to infrastructure capture, post-Westphalian governance) — comparable in ambition to Urbit’s ideological commitments, but with a more explicitly political and collectivist orientation
- Three distinct technical components (Blockchain with Cryptarchia/PPoS, Storage as a Decentralized Durability Engine, Messaging with RLN spam protection) — comparable to Cosmos’s or Filecoin’s multi-layer architecture
- Existing published technical work — Waku has an IEEE paper, Codex has a whitepaper and tokenomics litepaper, Logos Blockchain has the Cryptarchia specification and V1 specs
- A published book-length philosophical work — Farewell to Westphalia (384 pages, September 2025) by Jarrad Hope and Peter Ludlow
- An active testnet (v0.1) with all three modules integrated, mainnet targeted for early 2027
- A dual audience — investors evaluating the project for capital allocation AND a cypherpunk/sovereign-tech community evaluating it for ideological alignment and technical credibility
No single precedent project maps perfectly onto this configuration. Bitcoin had a single component and no explicit ideology. Ethereum had a platform vision but no political thesis. Filecoin had multiple components but no philosophical commitments. Tezos had the position-paper split but a narrower scope. Urbit had the full-stack ideology but no multi-document strategy. Logos needs a hybrid approach.
Recommended three-tier documentation strategy
Tier 1 — Litepaper (publish now, ~20-25 pages) A thesis-driven architectural overview. Functions as: investor-facing narrative, community-facing manifesto, architectural north star, and credibility signal. This is the document you’re building now.
Tier 2 — Umbrella Whitepaper (publish 6-12 months later, ~40-60 pages) A comprehensive technical document explaining how the three components integrate into a unified sovereign technology stack. Deeper on architecture, security model, game theory, and economic design. References the per-component papers for formal specifications.
Tier 3 — Per-component technical papers (publish on their own timelines)
- Logos Blockchain: formal specification of Cryptarchia, Blend network, Zone architecture (extends existing V1 specs)
- Logos Storage: expanded DDE specification (extends existing Codex whitepaper)
- Logos Messaging: protocol specification (extends existing IEEE paper and Waku documentation)
This maps onto the Cosmos/Filecoin umbrella-plus-component model with the Tezos position-paper energy in the litepaper. The litepaper carries the philosophical weight that Tezos’s position paper carried; the umbrella whitepaper carries the integrative architecture that Filecoin’s whitepaper carried; the per-component papers provide the formal precision that Ethereum’s yellow paper provides.
Option analysis: single unified document vs. umbrella + component papers
Option A — Single unified document covering thesis + all three components:
- Pros: One canonical reference; shows integration; simpler to navigate
- Cons: Will be 70-100+ pages if done properly (Logos Blockchain alone warrants a substantial paper given Cryptarchia’s novelty); becomes unwieldy; hard to update individual components; different components are at different maturity levels; forces all components to publish on the same timeline
- Verdict: Not recommended for Logos. The Urbit precedent shows this works only when the stack integration itself is the primary innovation. For Logos, each component has independently interesting technical contributions (Cryptarchia, the DDE framework, RLN spam protection) that deserve dedicated treatment.
Option B — Umbrella document + per-component whitepapers:
- Pros: Each component can be developed, reviewed, and updated independently; allows different levels of formality; scales with project complexity; existing component documentation (Waku IEEE paper, Codex whitepaper) can be incorporated; mirrors the modular architecture of the technology itself
- Cons: Readers must navigate multiple documents; risk of inconsistency; no single canonical reference
- Verdict: Strongly recommended. This is the approach Cosmos, Filecoin, Arweave, and Celestia have validated. The litepaper serves as the unified entry point; the umbrella whitepaper provides the integrative narrative; the component papers go deep.
Recommended litepaper structure: section by section
The following template is designed for ~20-25 pages including diagrams. Each section has a specific function and audience it primarily serves, though all sections should be accessible to all audiences.
Section 0: Epigraph + Frontmatter (half page)
- A carefully chosen epigraph that signals the intellectual lineage (as Tezos uses Proudhon, as the Crypto Anarchist Manifesto opens with Marx). Given the Farewell to Westphalia thesis, something from the cypherpunk tradition or a passage that captures the sovereignty thesis.
- Title, date, version, authors/contributors
Section 1: The Thesis (2-3 pages) Primary audience: everyone — this is the manifesto section
- Function: Establish the political/philosophical thesis in compressed, declarative prose. This section should carry the energy of the Cypherpunk’s Manifesto — morally clear, historically conscious, action-oriented.
- Content: The argument that current digital infrastructure is vulnerable to capture; that existing blockchains have failed to deliver on the cypherpunk promise because they expose infrastructure operators to coercion (cite Tornado Cash validator censorship as concrete example); that sovereignty requires a complete technology stack — not just a chain, but messaging, storage, and computation — all designed with operator-level privacy. Frame the historical moment: 380 years after Westphalia, governance technology needs an upgrade.
- Rationale: This is what makes Logos different from every other L1 pitch. Lead with it. Investors who are aligned with this thesis will lean forward; investors who aren’t were never the right investors. The cypherpunk/sovereign-tech community will recognize it immediately.
- Tone: Declarative, compressed, historically grounded. Not marketing. Not hedged. State the position.
Section 2: The Problem (2-3 pages) Primary audience: investors, technical evaluators
- Function: Diagnose the specific failures of existing infrastructure with precision. Not “blockchains are slow” but the structural vulnerabilities that make current systems susceptible to capture.
- Content: Three concrete failure modes: (1) consensus leader exposure — public validator sets and deterministic leader schedules make censorship and coercion trivial, as demonstrated by OFAC compliance among Ethereum validators post-Tornado Cash; (2) communication surveillance — no major chain provides censorship-resistant messaging at the protocol level; (3) storage centralization — decentralized applications still depend on centralized storage (AWS, Pinata) for critical data, creating single points of failure and censorship. Each failure mode should include a specific real-world example.
- Rationale: Investors need a clear problem statement. Technical evaluators need to see that you understand the actual threat model, not a strawman. The specificity of real-world examples (Tornado Cash, MEV-Boost relay censorship, IPFS gateway takedowns) establishes credibility.
- Structural note: This section mirrors the “problem enumeration” approach from Polkadot’s whitepaper (five blockchain failures) — an explicit, numbered diagnosis that the solution section directly addresses.
Section 3: The Logos Stack — Architecture Overview (4-5 pages) Primary audience: technical evaluators, developers
- Function: Present the three-component architecture at the level of “what it does and why it’s designed this way” — not implementation details, but architectural rationale.
- Content:
- System diagram (full-page) showing how Blockchain, Messaging, and Storage interact — the modular runtime, how nodes dynamically load modules, how the three layers compose
- Logos Blockchain (~1.5 pages): Cryptarchia (Private Proof of Stake) — anonymous block proposers via ZK proofs + Blend mix network; security model closer to Bitcoin’s honest-majority threshold than BFT protocols; Bedrock + Zones architecture enabling permissionless execution spaces. State what’s novel: first formally-analyzed privacy-preserving PoS where proposers are anonymous (not pseudonymous) even after block propagation.
- Logos Storage (~1 page): Decentralized Durability Engine — not just storage but tunable durability guarantees via erasure coding + ZK storage proofs; lazy repair mechanisms; open marketplace. State the differentiator from Filecoin: focus on durability rather than raw storage; lower hardware overhead.
- Logos Messaging (~1 page): Privacy-preserving P2P communication with Rate-Limit Nullifiers (RLN) for spam protection — first of its kind. Store protocol for offline message retrieval. Adaptive nodes for heterogeneous participation. Continuation of Gavin Wood’s original Whisper vision (acknowledged by Vitalik Buterin).
- Integration narrative (~0.5 page): How the three layers compose into a complete sovereign infrastructure — a node running all three modules provides censorship-resistant computation, communication, and data persistence with no external dependencies.
- Rationale: This is the technical core. Borrow Filecoin’s “Elementary Components” approach — enumerate what’s novel upfront, then describe each. Use the Polkadot two-pass technique: this section gives the conceptual overview, the umbrella whitepaper will provide the technical deep-dive.
- Key principle: State the architectural rationale for each design choice, not just the design. “Cryptarchia uses ZK proofs for leader election” is less powerful than “Cryptarchia uses ZK proofs for leader election because public leader schedules enable targeted coercion of block producers — a vulnerability exploited in [specific example].”
Section 4: Design Principles (1 page) Primary audience: developers, ideologically-aligned community
- Function: Articulate the principles that constrain all technical decisions. Directly inspired by Polkadot’s “Philosophy of Polkadot” section (§3.1: Minimal, Simple, General, Robust).
- Content: Logos’s design principles — privacy by default, political neutrality, resilience under adversarial conditions, modularity, minimal trust assumptions. Each principle in 2-3 sentences with a concrete example of how it constrains design.
- Rationale: This section serves as a “constitutional” reference for future design disputes. It also signals to the cypherpunk community that these commitments are structural, not marketing.
Section 5: The Ecosystem (2 pages) Primary audience: investors, evaluators assessing team and traction
- Function: Establish the breadth and depth of the IFT/Logos ecosystem as evidence of execution capability and network effects.
- Content: IFT as the organizational substrate — 220+ contributors, fully distributed. Status (blockchain super app, original application driving the stack’s development), Nimbus (Ethereum consensus client, demonstrating protocol engineering competence), Keycard (hardware security, demonstrating product shipping capability), Vac (research organization, demonstrating academic rigor — IEEE publications, formal specifications). Logos Circles as community infrastructure (28 local chapters). Testnet v0.1 status. GitHub stats (314 repositories, 3,234 total contributions, 167 active contributors).
- Rationale: Investors evaluate team and traction before technical details. This section answers “who’s building this and how far along are they?” — without the cringe of a “Team” page with headshots and LinkedIn links. The ecosystem narrative demonstrates execution credibility through shipped products (Status, Nimbus, Keycard) rather than credentials alone.
Section 6: Positioning in the Lineage (1-2 pages) Primary audience: crypto-native evaluators, investors comparing against alternatives
- Function: Explicitly position Logos relative to Bitcoin, Ethereum, Filecoin, and Urbit. This is the “Related Work” section from academic papers, reframed as competitive positioning.
- Content:
- Bitcoin: Logos shares the honest-majority security model and cypherpunk ethos but extends the vision beyond money into complete sovereign infrastructure
- Ethereum: Logos addresses the fundamental privacy gap (public validators, exposed proposers) that makes Ethereum vulnerable to the coercion Bitcoin was designed to resist
- Filecoin/Arweave: Logos Storage’s DDE framework prioritizes durability over raw capacity, with lower hardware requirements
- Urbit: Both pursue digital sovereignty, but Logos is modular (vs. monolithic), open-source protocol-based (vs. proprietary OS), and builds on proven cryptographic research (Ouroboros family, libp2p) rather than invented-from-scratch primitives
- Rationale: Crypto-native evaluators will position Logos in this lineage whether or not you do it for them. Better to control the framing. This section also demonstrates intellectual honesty — acknowledging what predecessors got right before explaining what they got wrong.
Section 7: Roadmap and Current Status (1-2 pages) Primary audience: investors, developers considering contribution
- Function: Establish timeline credibility through demonstrated progress and realistic forward milestones.
- Content: What exists today (testnet v0.1, integrated modules, working Blend network, PPoS implementation). Near-term milestones (public testnet phases, incentivized testnet for Storage). Medium-term (mainnet target early 2027). What’s explicitly not committed to yet (specific token launch dates, speculative features).
- Rationale: Roadmap sections are where most litepapers over-promise. Borrowing from the S-1 filing tradition, underpromise on timeline and be explicit about what’s uncertain. This builds more trust than aggressive targets.
Section 8: Economic Design Overview (1-2 pages) Primary audience: investors, tokenomics evaluators
- Function: High-level economic architecture without detailed modeling (save that for dedicated economics papers).
- Content: How the three components create economic flywheel effects. Storage marketplace dynamics. Messaging incentivization. Blockchain staking and security budget. How the economic design reinforces the sovereignty thesis (e.g., privacy-preserving staking prevents targeting of large stakers).
- Rationale: Investors need to see economic thinking even in a litepaper. But detailed vesting schedules and emission curves belong in a separate tokenomics document (as Mina and Codex have done). Signal that the team has economic sophistication without committing to premature specifics.
Section 9: What Comes Next — The Documentation Roadmap (0.5 page) Primary audience: all
- Function: Explicitly frame this litepaper as the first in a series of documents, referencing the forthcoming umbrella whitepaper and per-component technical papers.
- Content: List the planned documents: Logos Umbrella Whitepaper (comprehensive architecture), Logos Blockchain Technical Specification, Logos Storage Technical Specification, Logos Messaging Protocol Specification. Reference existing published work (Waku IEEE paper, Codex whitepaper, Cryptarchia specification). Link to the research forum and GitHub.
- Rationale: This borrows from Filecoin’s “Future Work” section and the XMTP litepaper’s “work in progress” framing. It sets expectations, demonstrates a structured documentation plan, and signals that the team treats documentation as a first-class engineering artifact — not an afterthought.
How to handle the dual audience problem
The fundamental tension: investors want problem-market-solution-moat-team-economics in a document that demonstrates market awareness and execution capability. The cypherpunk/sovereign-tech community wants philosophical coherence, technical rigor, and evidence that the project’s commitments are structural rather than marketing. These are not opposed — they’re different readings of the same document.
The recommended approach: a single document with layered legibility, not separate documents for separate audiences. The section structure above is designed so that:
- Investors read Sections 1-2 (thesis and problem), skim Section 3 (architecture — diagrams carry the weight), read Sections 5, 6, 7, 8 (ecosystem, positioning, roadmap, economics). Total effective read: ~12 pages.
- Technical evaluators read Sections 2-4 (problem, architecture, design principles), follow links to existing technical papers, evaluate Section 6 (positioning). Total effective read: ~10 pages plus referenced papers.
- Ideologically-aligned community reads Sections 1 and 4 (thesis, design principles), evaluates Section 6 (positioning against Bitcoin/Ethereum/Urbit lineage), follows references to Farewell to Westphalia. Total effective read: ~6 pages plus the book.
The key technique is bold-driven skimmability — bold the 2-3 most important facts or claims in each section so that a reader scanning the document at any pace can extract the critical information. Headers function as a standalone narrative when read in sequence.
Recommended approach for the eventual umbrella whitepaper
The umbrella whitepaper (Tier 2) should be structured more like Filecoin’s paper — formal, with explicit definitions, component isolation, and cross-references — while retaining the architectural rationale approach from the litepaper. Suggested structure:
- Abstract (~300 words)
- Introduction + Paper Organization
- Threat Model and Security Requirements (formalize what the litepaper’s “Problem” section describes narratively)
- System Architecture (the three-layer model with formal interface definitions)
- Logos Blockchain (Cryptarchia, Blend, Bedrock, Zones — moderate technical depth, referencing the component spec)
- Logos Storage (DDE framework, proofs, marketplace — moderate depth, referencing Codex papers)
- Logos Messaging (Protocol family, RLN, Store — moderate depth, referencing Waku IEEE paper)
- Integration and Composition (how the three layers interact, shared infrastructure like libp2p)
- Economic Design (formal game-theoretic treatment)
- Security Analysis (attack vectors and mitigations)
- Governance
- Current Status and Future Work
- Conclusion
Target length: 40-60 pages including figures and diagrams. Tone: formal-technical with architectural rationale, similar to the Filecoin paper’s register. This document should be implementable by an independent team reading only it plus the component specs.
The existing documentation gives Logos a structural advantage
Logos has already published substantial technical documentation for each component: an IEEE paper for Waku/Messaging, a whitepaper and tokenomics litepaper for Codex/Storage, the Cryptarchia specification and V1 specs for Blockchain, and Farewell to Westphalia for the philosophical thesis. The litepaper’s job is not to replace any of these — it’s to integrate them into a unified narrative that makes the whole greater than the sum of its parts. Every section of the litepaper should reference existing work where it exists, demonstrating that the project has depth behind its claims.
This is a significant advantage over most projects at the litepaper stage. Most litepapers are written before the technical work exists; Logos’s litepaper can point to working code, published research, and a live testnet. Lean into this. The litepaper should radiate the confidence of a project with receipts.
Conclusion
The most important structural insight from this analysis is that a litepaper for a project like Logos is not a miniature whitepaper — it’s a different document serving a different function. The whitepaper answers “how does this work?” The litepaper answers “why does this exist, what does it do, and why should you care?” — with enough technical substance to prove the team can deliver.
The Logos litepaper should open with manifesto energy (compressed, declarative, historically grounded), transition to precise problem diagnosis (specific failure modes, real-world examples), present the three-component architecture as a unified response to those failures, establish ecosystem credibility through demonstrated execution, position itself explicitly in the Bitcoin-Ethereum-Filecoin-Urbit lineage, and close with a realistic roadmap and documentation plan.
Three non-obvious recommendations emerge from the research:
First, the Tezos precedent of publishing a position paper before a technical paper — separated by one month — is the closest structural analog to Logos’s situation. The litepaper is the position paper. It should carry the philosophical weight and architectural vision. The umbrella whitepaper follows with technical depth.
Second, Filecoin’s “Elementary Components” enumeration in §1.1 — listing the novel contributions upfront before diving into any of them — is the single most transferable structural technique for a multi-component system. Logos should adopt this explicitly: list the three layers and their key innovations on page 1 of the architecture section, then expand each.
Third, the progressive disclosure model from The Network State — define the system at increasing levels of detail (one sentence → one paragraph → one page → full section) — solves the dual-audience problem more elegantly than separate documents. The litepaper’s Section 3 should open with a one-paragraph summary of the entire stack, then expand to one page per component, each of which references deeper technical documentation. Readers self-select their depth.