Skip to content

FairWins Engineering Blog — Post Drafts

This directory holds the draft content for the 34-topic blockchain-architecture blog program scoped in ../blog-topics-inventory.md.

Each post lives in its own numbered directory with two files:

  • blog.md — the full post (~1,200–1,900 words): a concrete opening scenario, the architecture walked stage by stage, real code excerpts drawn from the repo, a design-decisions / trade-offs section, and a Sources section citing the specs, docs, and contracts of record plus external standards.
  • social.md — the promotion kit: an X (Twitter) post, a LinkedIn post, and a 16:9 banner image prompt for Gemini / Nano Banana.

Every technical claim was researched against the repository's source of truth (specs under specs/, developer guides under docs/developer-guide/, runbooks under docs/runbooks/, and the Solidity / service code itself). Where the repo contradicted the inventory's original blurb, the repo won — see topic 21 for a notable correction.

Index

# Post Series
01 Role-based access control & the operations control plane Identity & Access
02 Soulbound memberships + transferable vouchers Identity & Access
03 Sanctions & compliance gating as a contract primitive Identity & Access
04 Passkey smart accounts (ERC-4337 + WebAuthn) Accounts & Keys
05 Account recovery & unified connect Accounts & Keys
06 Sponsored gas with a self-hosted verifying paymaster (ERC-7677) Accounts & Keys
07 Safe multisig custody integration Custody & Multisig
08 On-chain multisig policy engine (transaction guards) Custody & Multisig
09 Intent-based gasless payments (EIP-712 + EIP-3009) Gasless Rails
10 Relayer gateway architecture (policy + engine split) Gasless Rails
11 UUPS upgrades & storage-layout safety Contract Architecture
12 The two-facet proxy: beating the 24 KB limit Contract Architecture
13 Deterministic / singleton deployment across chains Contract Architecture
14 The wager lifecycle contract Prediction Markets
15 Oracle adapter abstraction (Polymarket / Chainlink / UMA) Prediction Markets
16 Draw resolution & open-challenge wagers Prediction Markets
17 Wager pools: ERC-1167 clones & address-keyed payouts Prediction Markets
18 Envelope encryption for private prediction markets (pointer to published post) Privacy Architecture
19 Multi-recipient encryption Privacy Architecture
20 Client-side encrypted data sync Privacy Architecture
21 The nullifier system (design history) Privacy Architecture
22 The FeeRouter: one source of truth for platform fees Finance Surfaces
23 Earn: wrapping ERC-4626 lending vaults with fee disclosure Finance Surfaces
24 Predict: Polymarket trading via builder codes Finance Surfaces
25 Bitcoin: adding a non-EVM chain to an EVM app Finance Surfaces
26 ClearPath: a multi-network external DAO registry Multi-chain Infra
27 Indexing without a subgraph (graceful degradation) Multi-chain Infra
28 The unified activity ledger Multi-chain Infra
29 AI-driven smart-contract security review in CI Security & DevOps
30 Coverage & audit gates that fail loudly Security & DevOps
31 Symbolic execution & fuzzing a wager protocol Security & DevOps
32 Spec-driven development with Spec Kit Security & DevOps
33 CallsignRegistry: an in-house ENS-style naming system Standalone
34 TokenFactory: templated token minting Standalone
35 Cross-chain intents & pooled liquidity: the refund address and the no-custody fee rule Standalone
36 Perps position management: why the fee contract was deleted, and how the platform is funded Standalone

Suggested publishing order

Lead with the highest-demand, most-differentiated pieces (see the inventory's rationale): 04 (passkeys) → 12 (two-facet proxy) → 15 (oracle adapters) → 06 (paymaster) → 29 (AI security review) → 25 (Bitcoin), then fill in each series around those anchors.